Merge pull request #6 from Aurtechmx/feat/v0.4.7

Feat/v0.4.7

Author: Aurtechmx

CHANGELOG.md

@@ -2,6 +2,85 @@
 
 The format is based on Keep a Changelog and the project follows Semantic Versioning.
 
+## [0.4.7] - 2026-06-15
+
+A correctness and honesty pass across the load, export, and analysis paths,
+alongside a few accessibility and workflow additions.
+
+### Added
+
+- **Colourblind-safe classification palette.** A checkbox in the Classes panel
+  recolours the classes with an Okabe-Ito categorical palette (ground orange,
+  vegetation as lightness steps of bluish-green, buildings vermillion, water
+  blue) that stays distinguishable under the common colour-vision deficiencies.
+  The class label and count stay on every row, so colour is never the only cue.
+- **Annotation grouping.** The Annotations panel and the PDF report now open
+  with a one-line summary of the notes — totals, the per-category breakdown, and
+  how many areas they fall across — so a dense set reads at a glance.
+- **Workflow recorder.** Record a sequence of camera moves and tool actions and
+  replay it (on the same scan), with a settings popup for the file format,
+  save destination, start/stop shortcut, replay speed, a pre-record countdown,
+  which action families are captured, and loop replay. Records actions only —
+  never scan data.
+- **Signal-tier cue on the Dataset Intelligence card.** A quiet coloured dot
+  marks each row's qualitative tier; terrain complexity stays neutral (it is
+  descriptive, not a quality) and a missing signal is muted. The colourblind
+  toggle also re-themes these status dots and the confidence chip.
+- **Recommended-view chip.** After a scan loads, a small dismissible chip
+  suggests the best camera preset (top-down for a wide classified surface,
+  oblique for a colour scan, isometric otherwise); one click applies it.
+- **Profile stations on the cloud and in the report.** A cross-section profile
+  drops small station markers along the section line in 3D, and the PDF report
+  now draws the profile as a sharp vector chart, not just the station text.
+- **More accessible report PDFs.** The document title is announced instead of
+  the filename, and the document language is tagged for correct pronunciation.
+
+### Fixed
+
+- **Empty files are rejected with a clear message.** A file that decodes to
+  zero points is no longer opened into a blank, unframable scene; it is
+  rejected at the parse stage with a message explaining there are no points to
+  display. A point cloud with no points now reports a finite bounding box
+  rather than an infinite one, so nothing downstream can target a degenerate
+  camera.
+- **Reprojection never ships non-finite coordinates.** A transform whose output
+  falls outside the target projection's valid area (proj4 returns Infinity or
+  NaN without raising an error) is now treated as a failed transform: the
+  coordinates are left in their source system and the converter reports how many
+  points were affected, instead of writing a file with NaN coordinates.
+- **Contour map sheet reports an unmeasured interpolation honestly.** When there
+  are no contours to measure, the legend reads "Interpolated fraction — not
+  measured" instead of a fabricated "0% interpolated".
+- **Measured areas read the same in the PDF report as on screen.** The report's
+  area formatting is single-sourced from the live measurement overlay, so a
+  polygon documents itself in the same units (m² / ft² / acre) the user saw
+  while measuring.
+- **Point density reads "—" when it is unknown.** With neither a measured
+  density nor the point count and bounds to derive one, the dataset card no
+  longer shows a confident "Sparse"; it shows "—", matching how terrain
+  complexity and ground visibility already report a missing signal.
+- **Disposal.** The colour-recompute throttle's trailing timer is cleared when a
+  viewer is torn down, and a streaming (COPC) cloud now closes its underlying
+  file/range reader when detached, so neither lingers after teardown.
+- **Load errors are described precisely.** A typed load failure now keeps its
+  category as it crosses from the decode worker to the main thread, so the
+  message shown is the exact one for the failure rather than a best-effort guess.
+- **Foot-based coordinate overrides.** When a coordinate system is assigned by
+  hand, its linear unit is resolved from the CRS registry rather than assumed to
+  be metres, so a foot-based system scales measurements correctly.
+
+### Changed
+
+- **Large text scans load on tighter memory.** The XYZ/CSV loader releases its
+  intermediate buffers as it builds the final arrays, lowering peak memory by a
+  full copy of the cloud on the largest files.
+
+- **One byte-size formatter** is shared across the stage, batch converter, debug
+  overlay, and streaming panels, so a file size reads identically everywhere.
+- **The unit test suite is split into four buckets** (`test:unit`,
+  `test:terrain`, `test:ui`, `test:slow`) that together cover the whole suite,
+  so it can run in parallel.
+
 ## [0.4.6] - 2026-06-14
 
 Phase 1 of the design audit (visual-only; verdict-as-hero, two-tier surfaces,
@@ -13,8 +92,8 @@ otherwise. The interior floor plan remains an experimental PREVIEW, now backed b
 an explicit wall-graph reconstruction and flood-fill room segmentation with
 claim-accurate labels throughout. Plus nine label-vs-value drift fixes (incl.
 foot-CRS / geographic-unit correctness and the edge-risk wording) and mobile
-touch-target / safe-area improvements. Three more high-visibility, low-risk wins
-round it out: the plumbed-but-headless floor-plan export knobs get a small
+touch-target / safe-area improvements. Three more visible improvements:
+the plumbed-but-headless floor-plan export knobs get a small
 UI (still an experimental PREVIEW), the last flagged capture-quality
 label-vs-value drift ("Coverage … % of footprint" → "Bounding area filled") is
 closed, and the streaming loader's indeterminate text becomes an honest
@@ -964,7 +1043,7 @@ onboarding tour.
 
 ### Added
 
-- (2026-06-12 amendment) Floor Plan Preview sheet quick wins — presentation
+- (2026-06-12 amendment) Floor Plan Preview sheet refinements — presentation
   and threading over data the pipeline already computes (the wall-graph /
   room-segmentation engine itself stays scheduled for 0.4.6; the export
   remains a labelled, experimental preview):

CITATION.cff

@@ -12,8 +12,8 @@ authors:
   - name: "Aurtech"
 license: MIT
 repository-code: "https://github.com/aurtechmx/openlidarviewer"
-version: 0.4.6
-date-released: "2026-06-13"
+version: 0.4.7
+date-released: "2026-06-15"
 keywords:
   - lidar
   - point-cloud

CONTRIBUTING.md

@@ -39,6 +39,13 @@ npm test
 npm run build
 ```
 
+`npm test` runs the whole unit suite. It is large, so it is also split into
+four coverage-complete buckets you can run individually (and CI runs in
+parallel): `npm run test:unit`, `test:terrain`, `test:ui`, and `test:slow`.
+The buckets always union to the full suite — a newly added test defaults into
+`unit`; `npm run test:buckets:verify` asserts that partition holds. Playwright
+specs run via `npm run test:e2e`.
+
 Add or update tests with your change. The algorithmic core is test-first
 (Vitest), and the renderer is covered by Playwright. Keep the module
 boundaries intact: one file per format or concern, and analysis modules must

README.md

@@ -115,15 +115,16 @@ OpenLiDARViewer does not claim survey-grade measurement or support for every LiD
 - A "Project ready" summary card on load, with a suggested navigation mode
 
 ### Annotation, sessions & reporting
-- Annotations — drop categorised, titled markers with notes, browse and search them in a panel, capture the camera viewpoint with each, and undo/redo changes
+- Annotations — drop categorised, titled markers with notes, browse and search them in a panel, capture the camera viewpoint with each, and undo/redo changes; the panel and the PDF report open with a grouping summary (totals, per-category counts, and how many areas the notes fall across)
 - Inspection sessions — export measurements, annotations, and named views to one JSON file and reload them later
-- Workflow recorder — temporarily disabled in 0.4.5 while its shortcut and replay-file experience get a design pass (see the CHANGELOG); `.olvworkflow` recording/replay will return in a later release
+- Workflow recorder — record and replay `.olvworkflow` files of camera moves and tool actions, with a settings popup for file format, save destination, start/stop shortcut, replay speed, a pre-record countdown, captured action families, and loop replay; records actions only, never scan data, so a recipient needs the same scan open to replay
 - Multi-page PDF technical reports — six built-in templates with branding and unit-system awareness
 - Visual Export Studio — orthographic RGB, height map, intensity, classification, depth, normal, and contour map exports
 - Screenshot export that burns in placed measurements and annotations as inspection evidence
 
 ### Interface & accessibility
 - Theme system — Dark, Light, High-contrast — with a persisted preference
+- A colourblind-safe (Okabe-Ito) classification palette, toggled from the Classes panel, so ground, vegetation, buildings, and water stay distinguishable under the common colour-vision deficiencies; the class label and count stay on every row
 - Command palette (`Cmd-K` / `Ctrl-K`) for keyboard-first access to every tool, mode, theme, and export
 - Searchable shortcut sheet (`?`) listing every keybinding
 - An onboarding tour that walks new users through the empty state, tool dock, and Inspector
@@ -160,10 +161,10 @@ score, surface models (DSM, canopy height, slope, multi-directional
 hillshade), a single top-level Terrain Assessment verdict, evidence-graded
 contour export (GeoJSON / SVG / DXF), a printable map sheet, and a
 georeferenced DEM package (ASCII Grid + GeoTIFF). A DTM quality gate
-governs whether a professional contour export is offered, and the panel is
+governs whether terrain-product export is enabled, and the panel is
 explicit that its products are for analysis — not survey certification. The
 per-cell confidence is calibrated against measured hold-out error, not
-asserted: treat terrain products and DEM exports as deliverable-ready only
+asserted: treat terrain products and DEM exports as export-ready only
 when the Terrain Assessment reads Good, and as preview otherwise.
 
 See [`docs/terrain-intelligence.md`](docs/terrain-intelligence.md)
@@ -404,27 +405,35 @@ COPC streaming — local and remote — ships in v0.3.0 and is hardened across v
 
 ## What's in this release
 
-The current release is **v0.4.5**. The full, dated history is in
+The current release is **v0.4.7**. The full, dated history is in
 [CHANGELOG.md](CHANGELOG.md); the highlights below are a reverse-chronological
 summary.
 
+### v0.4.7 — Accessibility, workflow & honesty fixes
+- A **colourblind-safe (Okabe-Ito) classification palette** toggle, an **annotation grouping** summary (totals, per-category counts, areas) in the panel and the PDF report, and a quiet **signal-tier cue** on the Dataset Intelligence card
+- The **workflow recorder** returns — record and replay `.olvworkflow` camera/tool sequences with a settings popup (file format, save destination, start/stop shortcut, replay speed, pre-record countdown, capture scope, loop)
+- Correctness and honesty fixes: empty files are rejected with a clear message instead of a blank scene; reprojection never ships non-finite coordinates; NAD83↔WGS84-family identity shifts are flagged; measured areas read the same in the report as on screen; unknown signals show "—" rather than a fabricated value
+
+### v0.4.6 — Navigation, design audit & honesty hardening
+- Six axis-aligned **standard views** (Top / Bottom / Front / Back / Left / Right) plus an **Orthographic toggle** (a near-parallel long-lens projection) for distortion-free measuring; **icon + label toolbars** across the dock, measurement bar, Layers and Export; a header **full-screen toggle**; and a mobile bottom-sheet reflow
+- Phase 1 of the **design audit** (visual-only: verdict-as-hero, two-tier surfaces, quieter typography, all themes re-verified WCAG AA) and an equivalence-gated **WebGPU compute seam** where the CPU stays the reference and the GPU must prove per-session equivalence before it is trusted
+- Contour **map-sheet (PDF) fixes** (title/legend overlap, scale-bar unit match, ungeoreferenced sheets drop the graticule and north arrow) and label-vs-value drift fixes
+
 ### v0.4.0 – v0.4.5 — Terrain Intelligence + the honesty pipeline
 - Confidence-aware **DTM and contour pipeline** behind the **Analyse panel** — ground classification, a gridded DTM with per-cell confidence and hold-out RMSE validation, a 0–100 terrain quality score, surface models (DSM, canopy height, slope, multi-directional hillshade), and a single top-level Terrain Assessment verdict (0.4.0–0.4.4)
-- Evidence-graded **contour export** (GeoJSON / SVG / DXF), a printable map sheet, and a georeferenced **DEM package** (ASCII Grid + GeoTIFF), all gated behind a DTM quality check so a professional export is only offered when the surface earns it
+- Evidence-graded **contour export** (GeoJSON / SVG / DXF), a printable map sheet, and a georeferenced **DEM package** (ASCII Grid + GeoTIFF), all gated behind a DTM quality check so a terrain-product export is only offered when the surface passes the quality gate
 - One **readiness engine** behind every export verdict, a colourblind-safe **Confidence** colour overlay (twin of Coverage), and **profile intelligence** — summary, station table, CSV, sampler controls (0.4.5)
 - **True measurement units** on foot-CRS scans, **workflow presets** in the Visuals Studio, and an accessible **onboarding tour** (0.4.5)
 - Interior **floor plan** reconstruction — **experimental preview**: a wall-graph + room-segmentation sketch from interior scans, with claim-accurate "preview" labelling throughout; not a survey product
-- **Note:** the **workflow recorder** (`.olvworkflow` record/replay) is temporarily disabled in 0.4.5 while its shortcut and replay-file experience get a design pass — it returns in a later release
 
-### v0.3.9 — Premium interaction surface + terrain foundation
+### v0.3.9 — Refined interaction surface + terrain foundation
 - Smart camera presets — Top, Iso, Oblique, Planar
 - Theme system — Dark, Light, High-contrast — with a persisted preference
 - Command palette (`Cmd-K` / `Ctrl-K`) for keyboard-first access to every tool, mode, theme, and export
 - Workflow recorder — save and replay `.olvworkflow` files of camera moves and tool actions
 - Onboarding tour + searchable shortcut sheet (`?`)
 - Terrain Intelligence (`src/terrain/`) — honesty-contracted terrain type contracts and the informational Dataset Intelligence card
 - Dataset Intelligence card — Point Density, Terrain Complexity, Ground Visibility, Streaming Coverage, Terrain Confidence; honest `—` when no signal is available
-- Inspector mini-dashboards — sparklines and gauges for live scan telemetry
 - Mobile touch model — twist + pinch + pan decomposition with dead zones; opt-in 3-finger zoom for advanced users
 - Mobile Scan Intelligence bottom-sheet — peek + tap-to-toggle; tool-dock overflow "More" disclosure
 - A coordinate bridge with `CrsService`, UTM + lat/lon inspector readouts, and a streaming-aware Visuals Studio with white balance + auto-balance gated to streaming COPC
@@ -436,7 +445,7 @@ summary.
 - FLAI integration — additional curated COPC URLs verified through a CORS + LAS-header probe
 - Polygon completion workflow — click first vertex to close, with visual feedback
 
-### v0.3.7 — Premium graphics + new LiDAR capabilities
+### v0.3.7 — Rendering quality + new LiDAR capabilities
 - EDL + SSAO combined ambient occlusion
 - Hillshade overlay colour mode
 - Local-density adaptive point sizing

RELEASE_NOTES_v0.4.6.md

@@ -0,0 +1,62 @@
+# OpenLiDARViewer v0.4.6
+
+A redesigned, icon-driven interface, standard CAD-style views, and a
+GPU terrain-compute path — all still browser-native, local-first, nothing
+uploaded.
+
+## Highlights
+
+- **Six standard views + parallel projection** — snap the camera straight at a
+  face with Top / Bottom / Front / Back / Left / Right, and toggle an
+  orthographic (parallel) projection that removes perspective so walls and
+  floors read flat for measuring. Lives beside the Orbit / Walk / Fly controls.
+- **Icon-driven tool surfaces** — the bottom dock, the measurement toolbar, the
+  Layers list, and the Export panel get a consistent line-icon set, each keeping
+  its visible text label. Inspect and Probe are drawn as distinct tools. A
+  full-screen toggle sits in the header. On phones, every panel folds into one
+  bottom sheet with View / Analyse / Layers tabs, and the measurement tools
+  reflow into a left-edge rail.
+- **GPU terrain compute (equivalence-gated)** — terrain derivative and scatter
+  passes can run on WebGPU, but the CPU stays the reference: the GPU path must
+  pass a per-session equivalence probe before it is trusted, and falls back to
+  the CPU silently otherwise. Correctness first, speed where it is proven.
+- **Interior floor plan — experimental PREVIEW** — the wall trace is rebuilt from
+  an explicit wall graph with flood-fill room segmentation and classified
+  doorways, and a "Floor plan confidence" summary reports rooms, walls, openings,
+  and the share of wall evidence that was interpolated. It is an approximate
+  sketch for inspection, not a measured floor plan.
+- **Design pass** — the Analyse verdict (Good / Preview / Limited / Blocked) is
+  the unmistakable hero of the panel, the stacked side panels read in two tiers
+  of emphasis, typography is quieter, and the mobile layout reflows for
+  thumb-friendly targets. Dark, Light, and High-contrast themes are checked for
+  WCAG AA contrast.
+- **Map sheet & honest labels** — the printable contour map sheet no longer
+  overlaps its title with the legend on long filenames, the contour-interval unit
+  matches the scale bar (m / ft), and an ungeoreferenced sheet drops the E/N
+  graticule and north arrow rather than implying a compass frame it does not
+  have. Several label-vs-value drift fixes land alongside it.
+
+## Polish
+
+- The streaming loader shows a determinate resident-node progress bar instead of
+  indeterminate text.
+- "Solo" in the Layers list is disabled when only one class is present.
+- The `?debug` overlay labels the load total as wall-clock time, reports the
+  CPU / GPU terrain compute path, and no longer prints a misleading "0 draw
+  calls" on backends that do not report it.
+- Floor-plan export options (wall snapping, adaptive band) get a small UI; the
+  preview stays an experimental PREVIEW.
+- Input-escaping hardening across the new icon controls — labels never carry
+  markup; only trusted static icons are injected.
+
+Measurement and the floor-plan preview are for visual inspection and research,
+not survey-grade use. Treat any output as survey-grade only after validating it
+against survey-grade data and procedures.
+
+See [CHANGELOG.md](./CHANGELOG.md) for the full list.
+
+## Deploy
+
+Static files — host anywhere (GitHub Pages, Netlify, any CDN). The deploy zip
+extracts with web-safe permissions (644 files / 755 directories) and carries
+`index.html` plus `assets/` at the archive root.