@plasius/gpu-demo-viewer 0.1.10 → 0.2.0

package/CHANGELOG.md

@@ -6,6 +6,36 @@ The format is based on Keep a Changelog and this project adheres to SemVer.
 
 ## [Unreleased]
 
+- **Added**
+  - (placeholder)
+
+- **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.
+
 - **Added**
   - (placeholder)
 
@@ -261,3 +291,5 @@ The format is based on Keep a Changelog and this project adheres to SemVer.
 [0.1.8]: https://github.com/Plasius-LTD/gpu-demo-viewer/releases/tag/v0.1.8
 [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

package/README.md

@@ -54,6 +54,16 @@ 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, so the catalogue still contains forty models. 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
@@ -153,6 +163,7 @@ and `PLASIUS_RENDERER_SOURCE` (absolute `src/index.js` or built `dist/index.js`)
 These overrides are local development tools. Production consumes published,
 qualified package versions and approved source assets.
 
+- [Furniture and workshop batch qualification](https://github.com/Plasius-LTD/gpu-demo-viewer/blob/main/docs/batch-four-qualification.json): nine additional sources, including authored WebP materials, checked with released packages.
 - [Initial model findings](https://github.com/Plasius-LTD/gpu-demo-viewer/blob/main/docs/model-library-review.md).
 - [UHD inspection contract](https://github.com/Plasius-LTD/gpu-demo-viewer/blob/main/docs/model-inspection-uhd.md).
 - [Catalogue rollout requirements](https://github.com/Plasius-LTD/gpu-demo-viewer/blob/main/docs/catalogue-production-rollout.md) and [live delivery tracking](https://github.com/Plasius-LTD/plasius-ltd-site/issues/2308).

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-four-qualification.json

@@ -0,0 +1,241 @@
+{
+  "registryConsumptionVerified": true,
+  "mode": "fixed-progressive",
+  "productionVerified": false,
+  "consoleErrors": 0,
+  "limitations": [
+    "Static authored geometry only; the vice skin is present but animation playback is not qualified.",
+    "Source textures and materials are retained, including the sofa WebP maps.",
+    "Original camera branding is retained in this technical inspection, not a sponsor or endorsement claim.",
+    "Physical touch hardware and screen-reader speech were not tested.",
+    "Completed images are source inspection evidence, not full physical-fidelity approval."
+  ],
+  "models": [
+    {
+      "key": "SheenWoodLeatherSofa",
+      "triangles": 46492,
+      "primitives": 6,
+      "materials": 6,
+      "completedFixedSamples": 64,
+      "denoisingOffOn": true,
+      "cameraResetAndRefinement": true,
+      "completedUhd": {
+        "width": 3840,
+        "height": 2160,
+        "samples": 1
+      },
+      "evidence": [
+        {
+          "file": "SheenWoodLeatherSofa-camera-denoise-off.png",
+          "sha256": "e0fc6e782da4dbc665b4c7b5756f48235a2c36a33ba2292718a6d2f0b12b7d20"
+        },
+        {
+          "file": "SheenWoodLeatherSofa-uhd.png",
+          "sha256": "2331328a89877651e80db4477519927a0d73256f49e8c812f5f5253b1a93563a"
+        }
+      ]
+    },
+    {
+      "key": "SpecularSilkPouf",
+      "triangles": 81280,
+      "primitives": 1,
+      "materials": 1,
+      "completedFixedSamples": 64,
+      "denoisingOffOn": true,
+      "cameraResetAndRefinement": true,
+      "completedUhd": {
+        "width": 3840,
+        "height": 2160,
+        "samples": 1
+      },
+      "evidence": [
+        {
+          "file": "SpecularSilkPouf-camera-denoise-off.png",
+          "sha256": "408377ed01bd330a8bc38f5fff20a8ee73e341d3f705532bf005dd44da9758ca"
+        },
+        {
+          "file": "SpecularSilkPouf-uhd.png",
+          "sha256": "8494aff57ff86f7f67aace72f610074b065260e869abb0fe17438d6f5674d8b5"
+        }
+      ]
+    },
+    {
+      "key": "spinning_wheel_01",
+      "triangles": 52023,
+      "primitives": 1,
+      "materials": 1,
+      "completedFixedSamples": 64,
+      "denoisingOffOn": true,
+      "cameraResetAndRefinement": true,
+      "completedUhd": {
+        "width": 3840,
+        "height": 2160,
+        "samples": 1
+      },
+      "evidence": [
+        {
+          "file": "spinning_wheel_01-camera-denoise-off.png",
+          "sha256": "988d0c57af6b80eab0ceb3cc7a3fbfe9d01690033ccee288ff0590c3479738b1"
+        },
+        {
+          "file": "spinning_wheel_01-uhd.png",
+          "sha256": "66e0e5954edc057f864650fcae3df1f87c283007e1d9d6abce1369607109203a"
+        }
+      ]
+    },
+    {
+      "key": "vintage_cabinet_01",
+      "triangles": 61096,
+      "primitives": 12,
+      "materials": 3,
+      "completedFixedSamples": 64,
+      "denoisingOffOn": true,
+      "cameraResetAndRefinement": true,
+      "completedUhd": {
+        "width": 3840,
+        "height": 2160,
+        "samples": 1
+      },
+      "evidence": [
+        {
+          "file": "vintage_cabinet_01-camera-denoise-off.png",
+          "sha256": "dd02748e8b3b186d4b8b1e8e1b6e69fef21d6f34681788f12cf97ba924c9392e"
+        },
+        {
+          "file": "vintage_cabinet_01-uhd.png",
+          "sha256": "c1dd6883cfe28c39022fd15125480f0ae6e5c3f1cb8e16151b32e2b753b19ff0"
+        }
+      ]
+    },
+    {
+      "key": "wicker_basket_01",
+      "triangles": 22276,
+      "primitives": 1,
+      "materials": 1,
+      "completedFixedSamples": 64,
+      "denoisingOffOn": true,
+      "cameraResetAndRefinement": true,
+      "completedUhd": {
+        "width": 3840,
+        "height": 2160,
+        "samples": 1
+      },
+      "evidence": [
+        {
+          "file": "wicker_basket_01-camera-denoise-off.png",
+          "sha256": "64765edbb558e8bfe0b885a43a6ad583f3f09610188ea95d2de92916256da38b"
+        },
+        {
+          "file": "wicker_basket_01-uhd.png",
+          "sha256": "b501910a48a952dda9094e35bf9ce3933b9d1db1793ff34b54b2d44412f596bc"
+        }
+      ]
+    },
+    {
+      "key": "wine_barrel_01",
+      "triangles": 10820,
+      "primitives": 4,
+      "materials": 1,
+      "completedFixedSamples": 64,
+      "denoisingOffOn": true,
+      "cameraResetAndRefinement": true,
+      "completedUhd": {
+        "width": 3840,
+        "height": 2160,
+        "samples": 1
+      },
+      "evidence": [
+        {
+          "file": "wine_barrel_01-camera-denoise-off.png",
+          "sha256": "ee17ce713e68bc6eb84f51451628ee5744042be398bb8f4e3a2261d0889da590"
+        },
+        {
+          "file": "wine_barrel_01-uhd.png",
+          "sha256": "71b63030b37a6ae8775f44994f17ade3af95c3320c5e2b6db877d0f348abb686"
+        }
+      ]
+    },
+    {
+      "key": "bench_vice_01",
+      "triangles": 2864,
+      "primitives": 4,
+      "materials": 1,
+      "completedFixedSamples": 64,
+      "denoisingOffOn": true,
+      "cameraResetAndRefinement": true,
+      "completedUhd": {
+        "width": 3840,
+        "height": 2160,
+        "samples": 1
+      },
+      "evidence": [
+        {
+          "file": "bench_vice_01-camera-denoise-off.png",
+          "sha256": "9d0c386f9f11de5a1fc04eea5eaad4396f50c26fe28e8756b7d23812eb1dad28"
+        },
+        {
+          "file": "bench_vice_01-uhd.png",
+          "sha256": "d72590b975e2de4d587e9cb0a1a92c6fefd3ecfa79435a0364bf0af8df28c79b"
+        }
+      ]
+    },
+    {
+      "key": "brass_blowtorch",
+      "triangles": 11750,
+      "primitives": 1,
+      "materials": 1,
+      "completedFixedSamples": 64,
+      "denoisingOffOn": true,
+      "cameraResetAndRefinement": true,
+      "completedUhd": {
+        "width": 3840,
+        "height": 2160,
+        "samples": 1
+      },
+      "evidence": [
+        {
+          "file": "brass_blowtorch-camera-denoise-off.png",
+          "sha256": "0e60c0b69d4ab16343e49151704a1e7dbeabedaf20933a9f35a402a81703f615"
+        },
+        {
+          "file": "brass_blowtorch-uhd.png",
+          "sha256": "16d14ae5787880e92917698f5cb4e7d7005d4120c181dcdbd933a141e31e7bc6"
+        }
+      ]
+    },
+    {
+      "key": "Camera_01",
+      "triangles": 26987,
+      "primitives": 5,
+      "materials": 4,
+      "completedFixedSamples": 64,
+      "denoisingOffOn": true,
+      "cameraResetAndRefinement": true,
+      "completedUhd": {
+        "width": 3840,
+        "height": 2160,
+        "samples": 1
+      },
+      "evidence": [
+        {
+          "file": "Camera_01-camera-denoise-off.png",
+          "sha256": "d526ce8a27947ed61b1defb6c314bccbdf1404199294f1937d3f4baacca2d0b2"
+        },
+        {
+          "file": "Camera_01-uhd.png",
+          "sha256": "c70be2048687be430424d70a8db0e46081223f9f26f54ba73cf7128a529ccca2"
+        }
+      ]
+    }
+  ],
+  "historicalSourceQualification": {
+    "date": "2026-10-18",
+    "renderer": "0.2.51",
+    "sharedSourceCommit": "665efda20a312084bf58e5db707bbaec7e209364",
+    "initialSourceOverrides": true
+  },
+  "date": "2026-10-21",
+  "renderer": "0.2.54",
+  "shared": "1.1.12",
+  "sourceOverrides": false
+}

package/docs/catalogue-production-rollout.md

@@ -6,10 +6,11 @@ for delivery evidence and current status. Parent Epic: site#2271;
 Feature: site#1170. First-batch Story: site#2303; production Task: site#2305.
 
 The research catalogue contains 75 distinct source assets/sets. Gem is explicitly
-excluded by the user, leaving 74 production candidates: eleven retained from
-the original twelve and 63 further models. Thirty-one have been acquired and ten
-are currently selectable in production.
-The 52 deployed files are geometry/texture resources, not 52 models.
+excluded by the user, leaving 74 production candidates. The 31-model release was
+production-verified on 20 October 2026; its 199 resources are files, not models.
+This next candidate adds nine qualified furniture/workshop sources with 64
+resources (30,610,988 bytes). Source acquisition for later batches remains in
+progress separately; those records are not included in this release candidate.
 
 ## Delivery sequence
 
@@ -132,3 +133,32 @@ off/on and native UHD1 using released packages, with no observed console errors.
 See [batch three evidence](batch-three-qualification.json). Four boot meshes are
 part of the source set; Sheen Chair retains its default authored material.
 Production verification remains pending.
+
+## Next release: furniture and workshop sources
+
+Resume viewer Task #62 and site Story #2308 with the nine original batch-four
+models. Recheck all nine with registry-installed shared and renderer packages,
+without source overrides. Retain the prior source qualification as historical
+evidence, add exact released-version checks and admit only models whose source,
+materials, camera/refinement, denoising and native UHD checks pass. Keep later
+acquired batches separate until their qualification is complete. Publish the
+viewer catalogue and then the site through their approved workflows; verify the
+40-model public selector and resource hashes before calling the batch live.
+
+The next scene review will combine qualified assets into a furnished interior
+and a workshop. Reuse the existing scene/loading/model packages and preserve
+original model files, material maps, licences and source identities. Define and
+track composition requirements before implementing reusable scene support. Test
+scale, placement, shadows, colour interaction and combined resource budgets.
+These composite scenes follow this model release and precede any voxel conversion.
+
+## Batch 4 registry qualification
+
+All nine original furniture/workshop models completed fixed64, camera reset and
+refinement, denoising off/on and native 3840×2160 at one sample with released
+renderer0.2.54 and shared1.1.12, without source overrides. No console warnings or
+errors were observed. Source geometry, materials and textures remain unchanged;
+sofa WebP maps are present. The [qualification record](batch-four-qualification.json)
+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.

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.