@plasius/gpu-demo-viewer 0.1.11 → 0.2.1

package/CHANGELOG.md

@@ -18,6 +18,34 @@ The format is based on Keep a Changelog and this project adheres to SemVer.
 - **Security**
   - (placeholder)
 
+## [0.2.1] - 2026-10-21
+
+- **Added**
+  - Nine original tool and material studies in acquisition batch five, with source hashes, licences and released-renderer qualification evidence.
+
+- **Changed**
+  - (placeholder)
+
+- **Fixed**
+  - (placeholder)
+
+- **Security**
+  - (placeholder)
+
+## [0.2.0] - 2026-10-21
+
+- **Added**
+  - Furnished-interior and workshop composite studies in the local model workshop, with shared inspection controls and individual source credits.
+
+- **Changed**
+  - (placeholder)
+
+- **Fixed**
+  - (placeholder)
+
+- **Security**
+  - Update the workshop's Vite development dependency to the patched 8.3.5 release.
+
 ## [0.1.11] - 2026-10-21
 
 - Add the nine qualified furniture/workshop source models and their integrity inventories, using released shared1.1.12 and renderer0.2.54; reconcile the prior 31-model production records.
@@ -278,3 +306,5 @@ The format is based on Keep a Changelog and this project adheres to SemVer.
 [0.1.9]: https://github.com/Plasius-LTD/gpu-demo-viewer/releases/tag/v0.1.9
 [0.1.10]: https://github.com/Plasius-LTD/gpu-demo-viewer/releases/tag/v0.1.10
 [0.1.11]: https://github.com/Plasius-LTD/gpu-demo-viewer/releases/tag/v0.1.11
+[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

package/README.md

@@ -48,12 +48,25 @@ npm run models:download -- 1
 npm run models:dev -- --port 5292
 ```
 
+Batch `5` adds tool and material studies: a rusted can, circuit board, hand
+plane, tool chest, spade, hand drill, estoc, flight helmet and water bottle.
+
 Select one batch at a time. A catalogue record can still be held for acquisition,
 licensing or visual review; it is not a claim that the model is available locally
 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
+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.
+
 ## Camera and render quality
 
 Drag or use one finger to orbit; Shift/right-drag trucks, Alt-drag pans, and the

package/docs/adrs/adr-0006-composite-study-consumer.md

@@ -0,0 +1,21 @@
+# ADR 0006: Consume shared composite inspection
+
+Status: accepted. Date: 2026-10-21.
+Feature: site#1170; Story site#2313; viewer Task #73.
+
+The workshop needs to compare several originals under one camera and light.
+Define small authored arrangements using installed catalogue keys, dimensions,
+anchors and Y rotation. Expose them as composite studies alongside individual
+model selection. Keep the count of acquired models distinct from the number of
+views. Resolve complete integrity manifests through the existing fixture helper
+and show every source's attribution and licence.
+
+Consume `createSceneInspection` from the released shared package. Rendering,
+loading, budgets, cancellation, camera and refinement remain shared-runtime
+responsibilities. The viewer owns selection, composition data, credits and UI
+lifecycle. Keep source overrides explicit and local to development; repeat
+browser review with the registry package before release.
+
+The existing scene-fidelity feature flag and route capability continue to govern
+hosted product access. This local review does not add public-site navigation or
+change the existing localhost review gate.

package/docs/adrs/index.md

@@ -8,3 +8,4 @@
 - [ADR 0003: Reviewed model library](adr-0003-reviewed-model-library.md)
 
 - [ADR 0005: Build-time model acquisition subpath](adr-0005-build-time-model-acquisition-subpath.md)
+- [ADR 0006: Composite study consumer](adr-0006-composite-study-consumer.md)

package/docs/batch-five-qualification.json

@@ -0,0 +1,291 @@
+{
+  "date": "2026-10-21",
+  "renderer": "0.2.54",
+  "shared": "1.2.0",
+  "initialSourceOverrides": false,
+  "registryConsumptionVerified": true,
+  "mode": "fixed-progressive",
+  "productionVerified": false,
+  "consoleErrors": 0,
+  "consoleWarnings": 0,
+  "layout320": {
+    "viewportWidth": 320,
+    "scrollWidth": 320,
+    "completedSamples": 64,
+    "file": "WaterBottle-320.png",
+    "sha256": "3297b7e0166efc3422b1fbbd34ca6be0eaa725553a4d2fb0592dc17404639a7d"
+  },
+  "limitations": [
+    "Static authored geometry only; tool drawers, moving gears and material variants are not animated.",
+    "Original geometry, textures and material definitions are unchanged; completed inspection does not certify physical material accuracy.",
+    "Flight Helmet quality rebuilds take several seconds. A DOM automation resolution change timed out and left a blank render; fresh selection recovered and native menu 800-to-UHD and UHD-to-800 transitions completed.",
+    "Physical touch hardware and screen-reader speech were not tested."
+  ],
+  "models": [
+    {
+      "key": "can_rusted",
+      "triangles": 3520,
+      "primitives": 1,
+      "materials": 1,
+      "completedFixedSamples": 64,
+      "cameraResetAndRefinement": true,
+      "denoisingOffOn": true,
+      "completedUhd": {
+        "width": 3840,
+        "height": 2160,
+        "samples": 1
+      },
+      "evidence": [
+        {
+          "file": "can_rusted-baseline.png",
+          "sha256": "c445bc469110f11b9e4358a05b857e76b2e3a68c99196e29a37402138ea1e387"
+        },
+        {
+          "file": "can_rusted-camera-denoise-off.png",
+          "sha256": "1977dedc3b63b3eb1205dbed6a099dd4566d2596769d206fd7389a97d284593d"
+        },
+        {
+          "file": "can_rusted-uhd.png",
+          "sha256": "d1c79b183fcbb9155eb628b837921695dae3aa2b000ac97b4b7173be31600e5a"
+        }
+      ]
+    },
+    {
+      "key": "circuit_board",
+      "triangles": 14430,
+      "primitives": 2,
+      "materials": 2,
+      "completedFixedSamples": 64,
+      "cameraResetAndRefinement": true,
+      "denoisingOffOn": true,
+      "completedUhd": {
+        "width": 3840,
+        "height": 2160,
+        "samples": 1
+      },
+      "evidence": [
+        {
+          "file": "circuit_board-baseline.png",
+          "sha256": "5b804f27a024c3ff4c9908da356363e9d374cb88b28c203005d28fb0bc58f03e"
+        },
+        {
+          "file": "circuit_board-camera-denoise-off.png",
+          "sha256": "6cb898cc6297c1767f563c1920aa570e19cb1ad85f7b3dde065060b3b487095a"
+        },
+        {
+          "file": "circuit_board-uhd.png",
+          "sha256": "678c10724f4d68b92ca5ed4498f31eb67d8923810f0edd9fdb73d972f6f57949"
+        }
+      ]
+    },
+    {
+      "key": "hand_plane_no4",
+      "triangles": 8220,
+      "primitives": 1,
+      "materials": 1,
+      "completedFixedSamples": 64,
+      "cameraResetAndRefinement": true,
+      "denoisingOffOn": true,
+      "completedUhd": {
+        "width": 3840,
+        "height": 2160,
+        "samples": 1
+      },
+      "evidence": [
+        {
+          "file": "hand_plane_no4-baseline.png",
+          "sha256": "8153d3afb879d6ea3a03f7f81d071d8066f3cc0f657e3db46516017da0f9611e"
+        },
+        {
+          "file": "hand_plane_no4-camera-denoise-off.png",
+          "sha256": "62f3a72577e2d3229698526c63e0844ee375e80b0979e0d49237cc6d99372640"
+        },
+        {
+          "file": "hand_plane_no4-uhd.png",
+          "sha256": "590cb82dbdac9cd9c911c409aded04fdc0bf8c0a3390ab97c1686ff23218152f"
+        }
+      ]
+    },
+    {
+      "key": "metal_tool_chest",
+      "triangles": 13360,
+      "primitives": 7,
+      "materials": 1,
+      "completedFixedSamples": 64,
+      "cameraResetAndRefinement": true,
+      "denoisingOffOn": true,
+      "completedUhd": {
+        "width": 3840,
+        "height": 2160,
+        "samples": 1
+      },
+      "evidence": [
+        {
+          "file": "metal_tool_chest-baseline.png",
+          "sha256": "30359a54b2652926b5f5f1d7d9d60304cf93e3705ac51172ae4658dbd8029e0c"
+        },
+        {
+          "file": "metal_tool_chest-camera-denoise-off.png",
+          "sha256": "9a267f8c589da28b58e20d3c8fad7ec28ddf6683f46bfafa88ed251a94167766"
+        },
+        {
+          "file": "metal_tool_chest-uhd.png",
+          "sha256": "da486b8befd3c3b92d350c72648d235dc5caa689caa75e1eb695680a7663bc54"
+        }
+      ]
+    },
+    {
+      "key": "rusted_spade_01",
+      "triangles": 11436,
+      "primitives": 1,
+      "materials": 1,
+      "completedFixedSamples": 64,
+      "cameraResetAndRefinement": true,
+      "denoisingOffOn": true,
+      "completedUhd": {
+        "width": 3840,
+        "height": 2160,
+        "samples": 1
+      },
+      "evidence": [
+        {
+          "file": "rusted_spade_01-baseline.png",
+          "sha256": "a1d29779c66c28e9edda61701663d589341ba1e08f7fec9dbb5ebc9fa5946c66"
+        },
+        {
+          "file": "rusted_spade_01-camera-denoise-off.png",
+          "sha256": "8b597bfc6a295ad582770801d0353cbdee741f92149223590a29e17db482aecf"
+        },
+        {
+          "file": "rusted_spade_01-uhd.png",
+          "sha256": "2bc94892642819ca3449ef7114f9094e3eebe3e496ac2b139fb4c8be93d62eb7"
+        }
+      ]
+    },
+    {
+      "key": "vintage_hand_drill",
+      "triangles": 8338,
+      "primitives": 5,
+      "materials": 1,
+      "completedFixedSamples": 64,
+      "cameraResetAndRefinement": true,
+      "denoisingOffOn": true,
+      "completedUhd": {
+        "width": 3840,
+        "height": 2160,
+        "samples": 1
+      },
+      "evidence": [
+        {
+          "file": "vintage_hand_drill-baseline.png",
+          "sha256": "9ca8ee574b8e19b01f7fa3ed0251a733339ff1ef917960448e595a4a3450090b"
+        },
+        {
+          "file": "vintage_hand_drill-camera-denoise-off.png",
+          "sha256": "7d5d615387b2da2136cfbdec7cb95ea36687c37706e71731ccb384283f3e5e88"
+        },
+        {
+          "file": "vintage_hand_drill-uhd.png",
+          "sha256": "98cf549a3c1ef24eec867dd19cc1d9191a5c48d98fb3c189e7429671ae75d66f"
+        }
+      ]
+    },
+    {
+      "key": "antique_estoc",
+      "triangles": 8246,
+      "primitives": 1,
+      "materials": 1,
+      "completedFixedSamples": 64,
+      "cameraResetAndRefinement": true,
+      "denoisingOffOn": true,
+      "completedUhd": {
+        "width": 3840,
+        "height": 2160,
+        "samples": 1
+      },
+      "evidence": [
+        {
+          "file": "antique_estoc-baseline.png",
+          "sha256": "b85b2d0d9c152d7144fd1ec3c7d06696f8af8ce307d176b74e2db10801791844"
+        },
+        {
+          "file": "antique_estoc-camera-denoise-off.png",
+          "sha256": "6326b286e02db3b8ca2a28539464a8d82622e139d52f72e934627928e4c54f7c"
+        },
+        {
+          "file": "antique_estoc-uhd.png",
+          "sha256": "55def5ee7bcffb3e9781d603f68a3712b58a06d7fd2900194ce1aac07e1f7f49"
+        }
+      ]
+    },
+    {
+      "key": "FlightHelmet",
+      "triangles": 94722,
+      "primitives": 6,
+      "materials": 6,
+      "completedFixedSamples": 64,
+      "cameraResetAndRefinement": true,
+      "denoisingOffOn": true,
+      "completedUhd": {
+        "width": 3840,
+        "height": 2160,
+        "samples": 1
+      },
+      "evidence": [
+        {
+          "file": "FlightHelmet-baseline.png",
+          "sha256": "cfcea5508d6d160bb57231c5e88f0a5cbbd0bcf7af197079c611a0a6212c3ec9"
+        },
+        {
+          "file": "FlightHelmet-camera-denoise-off.png",
+          "sha256": "2a73f6c767b2579e992d41b23a93bbf8f1e55fa183d11927441568a3e7377091"
+        },
+        {
+          "file": "FlightHelmet-uhd.png",
+          "sha256": "9b61191c3521bf15b0d843c38a890ec311beee20bedebc10ff4d8a7fcf65a28d"
+        },
+        {
+          "file": "FlightHelmet-native-balanced-return.png",
+          "sha256": "0eeff675c9e449f1f159eb94f5f10f1c271016f4e715c0d8854d1c8666d6980f"
+        },
+        {
+          "file": "FlightHelmet-uhd-native-transition.png",
+          "sha256": "dfe4f527327b9ab2252aef23e7a93e5564261970ffddb0807524bae3310c927a"
+        }
+      ]
+    },
+    {
+      "key": "WaterBottle",
+      "triangles": 4510,
+      "primitives": 1,
+      "materials": 1,
+      "completedFixedSamples": 64,
+      "cameraResetAndRefinement": true,
+      "denoisingOffOn": true,
+      "completedUhd": {
+        "width": 3840,
+        "height": 2160,
+        "samples": 1
+      },
+      "evidence": [
+        {
+          "file": "WaterBottle-uhd.png",
+          "sha256": "2e77b1dba8e30ba478aa7247b252ec6d8615b19caca3d4c5b357b9155d10f013"
+        },
+        {
+          "file": "WaterBottle-baseline.png",
+          "sha256": "ab95cb557ee5b7a660d2fccf85f2cbe6c37832396e6d0e064d86df387a0c5a4e"
+        },
+        {
+          "file": "WaterBottle-camera-denoise-off.png",
+          "sha256": "5b2d0211703d687e10a790e7fff54c04cbbe8fd0b7ca1711867f4f10646d9321"
+        }
+      ]
+    }
+  ],
+  "interruptedAutomation": {
+    "file": "FlightHelmet-uhd-transition-stalled.png",
+    "sha256": "0f62daef3170b2c37885cbbe1351f251b820109ae1ac13ba6116bddf832a338d",
+    "outcome": "Recovered by model selection; native menu transition passed."
+  }
+}

package/docs/catalogue-production-rollout.md

@@ -162,3 +162,31 @@ sofa WebP maps are present. The [qualification record](batch-four-qualification.
 retains the prior source-check context and binds the fresh screenshots by hash.
 This is static inspection qualification, not animation playback or a claim of
 complete material fidelity. Site production verification remains pending.
+
+## Batch 5: tools and material studies
+
+Continue Task #62 under Story site#2308 / Feature site#1170, inheriting
+`gpu-demo.scene-fidelity.enabled` and the existing site capability. Qualify the
+nine batch-five originals against released renderer0.2.54/shared1.2.0 with no
+source overrides. The 58 resources total 75,722,699 bytes; preserve the existing
+source manifests and attribution. Flight Helmet retains its original full texture
+set and transmission material. Circuit Board retains its authored alpha modes.
+
+Require source hash/length and glTF dependency closure checks, fixed64 sampling,
+camera reset/refinement, denoising off/on and native UHD1 for each model. Record
+actual GPU results and any unsupported material behavior before changing status
+to qualified. Tests must pin the nine identities and keep unqualified batches
+out of the published catalogue. Publish through viewer main/production CD, then
+consume that release in the site and verify the 49-model candidate through the
+site CI/CD path, public hashes/credits and live GPU checks. Failed candidates
+remain held; the original-model target remains 74, with Gem excluded.
+
+All nine batch-five originals completed the checks above; see the
+[registry qualification record](batch-five-qualification.json). The flight
+helmet's full texture set makes quality rebuilds take several seconds. A DOM
+automation timeout left one transition incomplete; fresh selection recovered,
+and native menu round trips between balanced and UHD completed. This limitation
+and the interrupted capture are retained. The 320px layout completed fixed64
+without horizontal overflow. No GPU console warnings or errors were observed.
+Physical touch and screen-reader speech remain untested. Public verification
+still depends on the approved package and site releases.

package/docs/composite-model-studies.md

@@ -0,0 +1,65 @@
+# Furnished interior and workshop studies
+
+Feature: site#1170; Story site#2313; viewer Task #73; shared Task #161.
+Inherited remote rollout: `gpu-demo.scene-fidelity.enabled`.
+
+After qualifying and releasing the forty-model batch, add two local workshop
+studies using the shared `createSceneInspection` API. The furnished interior
+compares the sofa, silk pouf, cabinet and basket. The workshop compares the
+spinning wheel, barrel, crate, vice and blowtorch. All are existing credited,
+integrity-checked originals. Scale and placement are authored review choices.
+
+Keep individual models available and clearly distinguish composite studies from
+the model count. Show every source/author/licence and chosen dimension. Reuse the
+existing quality controls, camera help, progressive status, cancellation and
+visibility lifecycle. Load only the selected model or study. Public-site scene
+navigation is separate qualified consumer work.
+
+Before implementation, test scene selection, complete source requests, missing
+source rejection, credits, shared quality/lifecycle controls and cancellation.
+Review both arrangements in actual WebGPU with >=3 sources together, camera
+movement and native UHD. Release the shared package first, then consume that
+registry version and repeat the review before viewer release. Keep source aliases
+explicit and local to development. Record limits instead of claiming untested
+animation, adaptive optical quality, physical touch or screen-reader speech.
+
+## Initial browser review
+
+The four-model interior (211,146 triangles including ground) and five-model
+workshop (82,635 triangles) completed fixed 64 samples at 800 × 282 with
+renderer 0.2.54 and a local source override for the new shared API. Both also
+completed native 3840 × 2160 at one sample; camera changes and denoising-off
+refinement completed again. The interior additionally passed mouse orbit and
+a UHD-to-balanced round trip using native browser menus. All source credits
+and licence links were inspected. At a 320-pixel viewport the interior completed
+64 samples at 800 × 601, all four models remained in frame, and the page and
+expanded credits had no horizontal overflow. The temporary viewport override was
+reset. No renderer console warnings/errors appeared.
+
+Preparing a heavy scene after quality changes takes several seconds. Direct DOM
+automation hit its three-second input deadline and left two transitions incomplete;
+a clean page with native menu input completed the same transition. This does
+not establish real-time responsiveness. The retained evidence records this
+limitation alongside the completed frames. Physical touch, screen-reader speech
+and reference optical fidelity remain untested. The original versus voxel
+distinction is unchanged.
+
+## Registry-consumer qualification
+
+Both studies were reviewed again with the published `gpu-shared` 1.2.0 and
+`gpu-renderer` 0.2.54 packages, with no source aliases. Both completed 64 samples
+at 800 × 282, refined after keyboard camera movement and denoising changes, and
+completed native 3840 × 2160 at one sample. The interior also completed the return
+to balanced resolution. No renderer console warnings/errors appeared. A native
+checkbox action exceeded the automation input deadline but the requested quality
+change and subsequent 64-sample refinement completed.
+
+The repeat mobile check could not be completed: the high-level viewport override
+did not affect the review tab, and browser approval rejected tab-scoped emulation.
+No workaround was attempted. The earlier source-version 320-pixel evidence still
+applies to the same layout; this is not a claim of a second mobile test.
+
+The viewer suite passes all 56 tests with 100% line coverage, including all changed
+JavaScript sources in LCOV. Syntax, build, package-content and full dependency
+audit checks pass. These are functional render checks; one-sample UHD output is
+not an optical-quality or performance qualification.