3dtiles-inspector 0.1.8 → 0.2.1

package/CHANGELOG.md

@@ -6,6 +6,32 @@ The format is based on Keep a Changelog and this project follows Semantic Versio
 
 ## [Unreleased]
 
+## [0.2.1] - 2026-05-03
+
+### Changed
+
+- Renamed the crop selection action to `Select Region` and show pending or newest crop regions first in the list.
+- Kept the Save/status controls fixed at the bottom of the sidebar, moved `Reset` into the Transform controls, and tightened sidebar behavior on narrow screens.
+
+## [0.2.0] - 2026-05-03
+
+### Added
+
+- Added `Crop Regions` for 3D Gaussian Splat tilesets, with screen-space rectangle selection, pending/confirmed region controls, preview overlays, and adjustable far-plane depth handles.
+- Added save-time Gaussian Splat cropping for supported local `.gltf` and `.glb` resources using `KHR_gaussian_splatting_compression_spz_2`, including multi-resource writes, multi-bufferView rewrites, empty tile pruning, and progress updates.
+- Added README documentation, a crop-region screenshot, and smoke-test fixtures for the 3DGS crop workflow.
+
+### Changed
+
+- Moved inspector session, HTTP server, save handling, viewer asset generation, and splat-crop logic into focused `src/server/` modules.
+- Refactored the browser viewer into focused DOM, IO, scene, navigation, screen-selection, and transform modules.
+- Updated the public `./session` export to `src/server/session.js` and routed the CLI through the package entrypoint.
+- Updated `3d-tiles-rendererjs-3dgs-plugin` from `0.1.4` to `0.1.5`.
+
+### Fixed
+
+- Fixed repeated saves on Windows failing with `EPERM` when replacing recently streamed `.glb`, `.gltf`, `.bin`, or `.json` files, including races with active tile requests.
+
 ## [0.1.8] - 2026-05-03
 
 ### Added

package/README.md

@@ -10,7 +10,7 @@
 
 </div>
 
-`3dtiles-inspector` is a Node.js package and CLI for opening a local 3D Tiles tileset in a browser inspector, adjusting the root transform, tuning the effective geometric error scale, and saving the result back to disk.
+`3dtiles-inspector` is a Node.js package and CLI for opening a local 3D Tiles tileset in a browser inspector, adjusting the root transform, tuning geometric-error scaling, cropping supported 3D Gaussian Splat tilesets, and saving the result back to disk.
 
 Requires Node.js 18 or newer.
 
@@ -83,7 +83,7 @@ const {
 
 ## Inspector Features
 
-<img src="https://raw.githubusercontent.com/WilliamLiu-1997/3DTiles-Inspector/main/screenshot.png" alt="screenshot" width="960" />
+<img src="https://raw.githubusercontent.com/WilliamLiu-1997/3DTiles-Inspector/main/screenshot.png" alt="screenshot" />
 
 - `Translate`, `Rotate`, and `Reset` for root transform edits
 - `Move Camera` to a WGS84 latitude / longitude / height
@@ -92,7 +92,24 @@ const {
 - `Terrain` to toggle Cesium World Terrain while keeping satellite imagery
 - `Geometric Error` scaling from `1/16x` to `16x`
 - `Layer Multiplier` scaling from `1/8x` to `8x` for each tile's geometric-error difference from the tileset's global leaf baseline
-- `Save` to persist the updated root transform and geometric-error scale back to disk
+- `Crop Regions` for drawing screen-space exclude regions on 3D Gaussian Splat tilesets
+- `Save` to persist root transform edits, geometric-error scaling, and confirmed crop regions back to disk
+
+### Crop Regions
+
+`Crop Regions` appears when the loaded tileset contains 3D Gaussian Splat content. It lets you draw one or more screen-space exclude rectangles, preview them in the viewer, then apply the crop when you click `Save`.
+
+The basic workflow is:
+
+1. Click `Select Region` and drag a rectangle over the splats to remove.
+2. Drag the far-plane handle to set how deep the crop region extends into the scene.
+3. Click `Confirm` to add the region to the save list, or `Cancel` to discard the pending rectangle.
+4. Select a confirmed region row if you need to adjust its 3D far plane with the transform handle.
+5. Click `Save` to persist the root transform and delete splats inside the confirmed crop regions.
+
+<img src="https://raw.githubusercontent.com/WilliamLiu-1997/3DTiles-Inspector/main/region.png" alt="Crop Regions" />
+
+Crop saving rewrites supported local `.gltf` / `.glb` Gaussian Splat resources that use `KHR_gaussian_splatting_compression_spz_2`. Fully deleted splat primitives are removed from their glTF, and empty tile content can be pruned from the tileset JSON. Remote content and unsupported Gaussian Splat encodings are rejected instead of being modified.
 
 If `build_summary.json` exists next to the root tileset, `Save` also updates:
 
@@ -102,15 +119,6 @@ If `build_summary.json` exists next to the root tileset, `Save` also updates:
 - `viewer_geometric_error_scale`
 - `viewer_geometric_error_layer_scale`
 
-## Package Surface
-
-- `src/index.js` exports the public Node API
-- `src/cli.js` implements the standalone CLI
-- `src/viewer/session.js` manages the local server, temporary assets, browser launch, and save handling
-- `src/viewer/app.js` contains the browser runtime source
-- `dist/inspector-assets/viewer/` contains the generated browser bundle and local decoder assets built by `npm run build:viewer`
-- `src/viewer/cameraController.js` contains the vendored camera controller used by the runtime
-
 ## Development
 
 ```bash