@plasius/gpu-shared 0.1.1 → 0.1.3

package/CHANGELOG.md

@@ -4,6 +4,39 @@ All notable changes to this project will be documented in this file.
 
 ## [Unreleased]
 
+- **Added**
+  - (placeholder)
+
+- **Changed**
+  - (placeholder)
+
+- **Fixed**
+  - (placeholder)
+
+- **Security**
+  - (placeholder)
+
+## [0.1.3] - 2026-03-26
+
+- **Added**
+  - Public-contract tests that lock the package export surface for the shared
+    runtime and bundled brigantine asset.
+  - Public `destroy()` teardown hook on `mountGpuShowcase()` so browser consumers can clean up the shared runtime safely on route/page unmount.
+
+- **Changed**
+  - Documented the import-map pattern for browser demos so consumers stay on the
+    published `@plasius/gpu-shared` package surface instead of deep internal
+    paths.
+  - README usage now documents the shared teardown contract for public consumers.
+
+- **Fixed**
+  - (placeholder)
+
+- **Security**
+  - (placeholder)
+
+## [0.1.2] - 2026-03-23
+
 - **Added**
   - (placeholder)
 
@@ -50,3 +83,5 @@ All notable changes to this project will be documented in this file.
 
 [0.1.0]: https://github.com/Plasius-LTD/gpu-shared/releases/tag/v0.1.0
 [0.1.1]: https://github.com/Plasius-LTD/gpu-shared/releases/tag/v0.1.1
+[0.1.2]: https://github.com/Plasius-LTD/gpu-shared/releases/tag/v0.1.2
+[0.1.3]: https://github.com/Plasius-LTD/gpu-shared/releases/tag/v0.1.3

package/README.md

@@ -34,12 +34,29 @@ npm install @plasius/gpu-shared
 ```js
 import { mountGpuShowcase } from "@plasius/gpu-shared";
 
-await mountGpuShowcase({
+const showcase = await mountGpuShowcase({
   root: document.getElementById("app"),
   packageName: "@plasius/gpu-demo-viewer",
   title: "Flag by the Sea",
   subtitle: "Shared 3D validation scene for the gpu-* family.",
 });
+
+// Teardown is safe to call repeatedly from a route/page cleanup.
+showcase.destroy();
+```
+
+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:
+
+```html
+<script type="importmap">
+  {
+    "imports": {
+      "@plasius/gpu-shared": "../node_modules/@plasius/gpu-shared/dist/index.js"
+    }
+  }
+</script>
 ```
 
 ## Asset Helpers
@@ -80,6 +97,7 @@ surface for these family demos.
 ## API
 
 - `mountGpuShowcase(options)`
+  - Returns `{ state, shipModel, canvas, destroy() }`
 - `loadGltfModel(url)`
 - `resolveShowcaseAssetUrl(baseUrl?)`
 - `showcaseFocusModes`