arrayview 0.15.0__tar.gz → 0.17.0__tar.gz

{arrayview-0.15.0 → arrayview-0.17.0}/.gitignore

@@ -34,4 +34,5 @@ van_gogh/
 cig_presentation/
 docs/superpowers
 .playwright-mcp/
-dev/TODO.md
+dev/TODO.md
+.nninteractive_weights/

{arrayview-0.15.0 → arrayview-0.17.0}/.mex/ROUTER.md

@@ -20,7 +20,7 @@ edges:
     condition: when working on rendering, colormaps, LUTs, caching, or the render thread
   - target: patterns/INDEX.md
     condition: when starting a task — check the pattern index for a matching pattern file
-last_updated: 2026-04-15
+last_updated: 2026-04-17
 ---
 
 # arrayview — Router

{arrayview-0.15.0 → arrayview-0.17.0}/.mex/context/architecture.md

@@ -43,18 +43,18 @@ Browser (_viewer.html — single self-contained HTML+JS+CSS file)
 
 A `view()` call creates a `Session`, starts the FastAPI server if not running,
 registers the session via HTTP POST `/load`, then opens a display for the detected
-environment (Jupyter inline, VS Code SimpleBrowser or direct webview, native
+environment (Jupyter inline, VS Code webview panel or direct webview, native
 pywebview, or system browser).
 
 ## Key Components
 
-- **`_launcher.py`** — CLI parser, `view()` API, `ViewHandle`, server lifecycle, SSH relay, file watching. Heavy imports (`_session`, `_render`, `_io`, uvicorn) are all lazy to keep the CLI fast path near-zero cost.
+- **`_launcher.py`** — CLI parser, `view()` API, `ViewHandle`, server lifecycle, reverse-tunnel relay (`--relay`), file watching. Heavy imports (`_session`, `_render`, `_io`, uvicorn) are all lazy to keep the CLI fast path near-zero cost.
 - **`_server.py`** — FastAPI app with all REST and WebSocket routes (`/meta/{sid}`, `/load`, `/slice`, `/ws/{sid}`, `/seg/*`, `/reload`, etc.). Dispatches render work to the render thread via `_render()` from `_session.py`.
 - **`_session.py`** — Single source of global mutable state: `SESSIONS`, `SERVER_LOOP`, `VIEWER_SOCKETS`, `VIEWER_SIDS`, `SHELL_SOCKETS`. Owns the render thread (`_RENDER_QUEUE`, `_RENDER_THREAD`), prefetch pool, and the `Session` class with its three LRU caches.
 - **`_render.py`** — Stateless rendering functions: `extract_slice()`, `apply_complex_mode()`, `render_rgba()`, `render_rgb_rgba()`, `render_mosaic()`, `extract_projection()`. Owns colormap LUTs (`LUTS` dict, lazy-initialized by `_init_luts()`).
 - **`_io.py`** — All file-format loading behind `load_data(filepath)`. Lazy nibabel import for NIfTI. Handles `.npy`, `.npz`, `.nii/.nii.gz`, `.zarr`, `.zarr.zip`, `.pt/.pth`, `.h5/.hdf5`, `.tif/.tiff`, `.mat`. Extensions registered in `_SUPPORTED_EXTS`.
 - **`_platform.py`** — Environment detection: checks jupyter → vscode → julia → ssh → terminal in priority order. Results cached. Never short-circuit this order.
-- **`_vscode.py`** — VS Code extension install/management, signal-file IPC, shared-memory IPC, SimpleBrowser and direct webview opening.
+- **`_vscode.py`** — VS Code extension install/management, signal-file IPC, shared-memory IPC, webview panel and direct webview opening.
 - **`_stdio_server.py`** — Alternative to FastAPI for VS Code tunnel (direct webview): JSON on stdin, length-prefixed binary on stdout.
 - **`_viewer.html`** — The entire frontend (~15 600 lines). CSS + JS in one file, no build step. Canvas-based rendering, WebSocket binary protocol, all viewing modes, reconcilers, command registry. See `context/frontend.md`.
 
@@ -63,11 +63,11 @@ pywebview, or system browser).
 | Environment | Default display | Server mode |
 |---|---|---|
 | Jupyter | Inline iframe | network |
-| VS Code local | Simple Browser | network |
+| VS Code local | Webview panel | network |
 | VS Code tunnel | Direct webview (stdio) | stdio |
 | Julia | System browser | network |
 | CLI / Python script | Native pywebview | network |
-| SSH terminal | VS Code ext via TCP relay (prints URL on failure) | network |
+| SSH terminal | Prints URL — user forwards port with `ssh -L` | network |
 
 Detection logic: `_platform.py`. Display opening: `_launcher.py` + `_vscode.py`.
 

{arrayview-0.15.0 → arrayview-0.17.0}/.mex/context/decisions.md

@@ -14,7 +14,7 @@ edges:
     condition: when a decision relates to technology choice
   - target: context/frontend.md
     condition: when a decision relates to the frontend architecture or viewer modes
-last_updated: 2026-04-15
+last_updated: 2026-04-16
 ---
 
 # Decisions
@@ -61,6 +61,14 @@ last_updated: 2026-04-15
 **Alternatives considered:** Port forwarding via VS Code tunnel (rejected — unreliable, depends on tunnel configuration); WebSocket over stdio tunnel (rejected — more complex than length-prefixed binary).
 **Consequences:** `_stdio_server.py` must mirror every route and feature of `_server.py`. New server features must be implemented in both. The `_vscode.py` signal-file and shared-memory IPC are part of this same display path.
 
+### ROI in qMRI uses per-pane overlay canvases, not a shared overlay
+**Date:** 2026-04-16
+**Status:** Active
+**Decision:** Each qMRI pane gets its own `.qv-roi-overlay` canvas element. ROI shapes are drawn on all overlays simultaneously during drag, and stats are fetched per parameter map.
+**Reasoning:** In qMRI mode, the single main canvas is hidden and replaced by N independent pane canvases, each with its own coordinate system and scale. A shared overlay (like the main `#roi-overlay`) cannot span multiple independently-positioned canvases. Per-pane overlays also allow the ROI mirroring UX where drawing on one pane instantly shows the same shape on all others.
+**Alternatives considered:** A single overlay canvas spanning the entire `#qmri-view-wrap` (rejected — would need to track pane positions and clip per-pane, fragile across resize/mosaic layout changes); reusing the main `#roi-overlay` (rejected — it's inside `#canvas-viewport` which is hidden in qMRI mode).
+**Consequences:** Overlay canvases must set `background: transparent` to override the global `canvas { background: var(--bg) }` rule. qMRI view objects carry `roiOverlay` and `roiCtx` properties. `_drawAllQvRois()` replaces `_drawAllRois()` in qMRI mode; `_redrawRoiOverlays()` dispatches to the correct function based on mode.
+
 ### UI visibility changes go through reconcilers, not ad hoc style/classList calls
 **Date:** 2025 (View Component System refactor)
 **Status:** Active

{arrayview-0.15.0 → arrayview-0.17.0}/.mex/context/frontend.md

@@ -23,7 +23,7 @@ edges:
     condition: when writing new frontend code and need section separator conventions
   - target: patterns/frontend-change.md
     condition: when making a concrete change to _viewer.html
-last_updated: 2026-04-15
+last_updated: 2026-04-17
 ---
 
 # Frontend (_viewer.html)
@@ -60,7 +60,7 @@ Section separators: `/* ── Section Name ── */` in CSS, `// ── Sectio
 | Info Bar and Pixel Display | Bottom info bar, hover pixel readout |
 | State Persistence and Restore | URL hash state, `sessionStorage` save/restore |
 | Rendering Pipeline | `updateView()`, play/animate, screenshot |
-| ROI and Selection Modes | Rectangle/ellipse ROI, statistics computation |
+| ROI and Selection Modes | Rectangle/circle/freehand ROI, statistics computation, qMRI cross-pane mirroring |
 | nnInteractive Segmentation | Click-to-segment UI, mask overlay, undo stack |
 | Keyboard Shortcuts | Command registry + command palette |
 | Mode Transitions | Compare/multiview/qMRI enter/exit, crosshair animation |
@@ -122,11 +122,17 @@ Introduces `View`, `Slicer`, `Layer`, `LayoutStrategy`, `modeManager` alongside
 
 **Shim layer (Section 7):** `Object.defineProperty(window, 'manualVmin', …)` intercepts all bare writes to `manualVmin`/`manualVmax` (27 sites) and routes them to `modeManager.currentViews[0].displayState.vmin/vmax`.
 
+### Plugin Shelf (`/` menu)
+`SPECIAL_MODE_TILES` array defines five plugins: qMRI, Segmentation, ROI, Overlay, Vector field. The shelf supports multi-select (spacebar toggles, Enter applies). Mutual exclusion is enforced via `tile.excludes` arrays — ROI ↔ Segmentation, and Overlay/Vector field are reciprocally exclusive with all other plugins. `_applyShelfSelection()` diffs current state against selection, exits removed plugins, then enters new ones wrapped in `crossfade()`. Overlay and Vector field auto-seed the shelf at init when arrays are present (`_overlaySids.length > 0`, `hasVectorfield`); their per-tile state lives in `_shelfSelection.has(id)` since there is no separate mode flag.
+
 ### Eggs
 Pill badges below the canvas showing active transforms: `FFT` `LOG` `MAGNITUDE` `PHASE` `REAL` `IMAG` `RGB` `ALPHA` `PROJECTION`. **ROI** and **SEGMENT** are NOT eggs — they are interaction modes with their own dynamic island UI.
 
 ### Dynamic Islands
-Floating UI panels: ROI statistics, segmentation controls, colorbar hover, dimension sliders. Use absolute/fixed positioning — must be tested across normal, immersive, multiview, and compare modes.
+Floating UI panels. `renderIsland()` collects all active plugins (`qmriActive`, `rectRoiMode`, `_segMode`/`_segActivating`, `_shelfSelection.has('overlay')`, `_shelfSelection.has('vectorfield')`) and renders sections for each with dividers between them. ROI/Segmentation share the same shape-toolbar + rows + magnifier-action layout; segmentation also renders a pulsing "connecting" loading row during `_segActivating`. Overlay section renders per-overlay rows (swatch + editable label + eye + `×`) with a shared opacity slider and a `+ add overlay` button that opens the filesystem picker. Vector field section renders a visibility row plus density and length sliders wired to `vfDensityLevel` / `vfLengthLevel` (both directions — keyboard `[ ] { }` also re-renders the island). An inline `~` collapse button at the island's top-right triggers `_collapseIslandToHint()`. `renderIsland()` early-returns while `_islandSliderDragging` is true so a mid-drag DOM rebuild doesn't kill the grab. Use absolute/fixed positioning — must be tested across normal, immersive, multiview, and compare modes.
+
+### ROI in qMRI Mode
+Each qMRI pane has a `.qv-roi-overlay` canvas (transparent, `position: absolute`, `pointer-events: none`). Drawing a ROI on any pane mirrors it to all panes in real-time via `_drawAllQvRois()`. On finalize, `_fetchQvRoiStats()` fetches per-parameter-map statistics in parallel. Results stored as `roi.qmriStats[]` and displayed as sub-rows in the island. Key functions: `_drawAllQvRois`, `_clearQvRoiOverlays`, `_redrawRoiOverlays`, `_finalizeQvRoi`, `_fetchQvRoiStats`. **Important:** the global `canvas { background: var(--bg) }` rule makes all canvas elements opaque — overlay canvases must set `background: transparent` to avoid covering the underlying content.
 
 ## CSS Architecture
 

{arrayview-0.15.0 → arrayview-0.17.0}/.mex/context/project-state.md

@@ -7,7 +7,7 @@ triggers:
   - "recent work"
   - "active feature"
   - "shipped recently"
-last_updated: 2026-04-15
+last_updated: 2026-04-17
 ---
 
 # Project State
@@ -15,7 +15,7 @@ last_updated: 2026-04-15
 ## Working
 
 - CLI (`uvx arrayview file.npy`) and Python API (`view(arr)`) — both stable
-- All six display environments: Jupyter inline, VS Code local, VS Code tunnel (stdio), Julia, native pywebview, SSH URL print
+- Display environments: Jupyter inline, VS Code local, VS Code tunnel (stdio), Julia, native pywebview, SSH URL print (user forwards port with `ssh -L`)
 - File formats: `.npy`, `.npz`, `.nii`/`.nii.gz`, `.zarr`, `.h5`/`.hdf5`, `.mat`, `.tif`/`.tiff`, `.pt`/`.pth`
 - Rendering pipeline: colormaps, complex modes, mosaic, RGB/RGBA, projections, overlays
 - NIfTI spatial metadata, RAS resampling
@@ -23,10 +23,21 @@ last_updated: 2026-04-15
 - Colorbar refactor: `ColorBar` JS class partially migrated (in progress)
 - Colorbar island flip: `c` and `d` keys trigger 3D `rotateX` card flip (front=colorbar, back=cmap thumbnails/histogram)
 - Cold-start loading spinner in VS Code and native shell
+- Plugin shelf (`/` menu) supports multi-select: spacebar toggles plugins, Enter applies selection. Mutual exclusion enforced (ROI ↔ Segmentation, and overlay/vectorfield ↔ everything else). Cursor indicator shows focused tile via yellow background + left accent bar
+- Dynamic island renders sections for all active plugins simultaneously (qMRI pills + ROI shapes/stats separated by divider), replacing the old single-plugin priority chain
+- ROI mode works alongside qMRI: drawing on any pane mirrors the ROI to all panes in real-time via per-pane overlay canvases; stats fetched per parameter map and shown as sub-rows in the island
+- qMRI map toggle (`_islandToggleQmriMap`) fade animation now covers dimbar and array-name in addition to panes and colorbars
+- Segmentation menu shares the ROI layout (yellow accent, magnifier action icon, common `#export-overlay` modal). Pre-activation shows a pulsing "nnInteractive · connecting" row that morphs into the normal shape toolbar once `/seg/activate` resolves
+- Overlays are a plugin tile (`OV`): per-overlay row with colour swatch, editable label, eye toggle, × delete; shared opacity slider; `+ add overlay` opens a filesystem picker rooted at the launched file's directory
+- Vector field is a plugin tile (`VF`): row with visibility toggle + density/length sliders bi-directionally wired to the `[ ] { }` keyboard commands
+- CLI `--overlay FILE` can be repeated to load multiple overlays at launch
+- Filesystem picker endpoint (`GET /fs/list`) clamped to `$HOME`. Accepts `base_sid` + `mode` (`overlay` | `vectorfield`) to filter entries by a cheap header-shape peek (`.npy`, `.nii`/`.nii.gz`, `.h5`, `.zarr`); overlay mode requires identical shape, vectorfield mode requires base shape plus one axis of size 3
+- Island collapse affordance: inline `~` at the island's top-right animates the panel into the bottom-left `~` hint circle; external `~` hint only visible while the island is actually collapsed. New `/` hint circle at bottom-right opens the plugin shelf
 
 ## In Progress
 
 - Smooth immersive transition — stale scrub geometry handoff is fixed, immersive overlay fade-in is held until after the class switch, shared slim colorbar returns through `drawSlimColorbar()` on reverse, and active scrub suppresses minimap/overflow/drag side effects. Single-pane scrub now targets the actual centered immersive viewport rect instead of a hardcoded corner box, the dimbar stays above the pane during scrub, the shared colorbar sits behind the growing pane, and the phantom extra `av-view-wrap` footprint in normal mode was removed by rebinding `NormalLayout` to the real `#viewer` canvas. Cross-mode parity and deeper reverse-pinch validation still need manual verification.
+- ROI + qMRI integration refinements: floodfill not yet supported on qMRI panes; ROI hover tooltip not yet wired for qMRI canvases; per-pane stats are re-fetched on each ROI draw but not updated on slice scroll
 
 ## Not Yet Built
 

{arrayview-0.15.0 → arrayview-0.17.0}/IMMERSIVE_ANIMATION.md

@@ -16,7 +16,7 @@ The canvas grows smoothly, tied 1-to-1 with how much you've pinched. No spring,
 
 ### When the canvas reaches its final immersive size (progress = 1)
 
-The immersive layout class is applied. At this point the dimbar and colorbar are completely invisible, so they are silently repositioned to their overlay locations — dimbar near the top of the canvas, colorbar near the bottom. They teleport while invisible, not animate. Then they fade from invisible to visible at those positions. They do not move during this fade-in.
+The immersive layout class is applied. A0t this point the dimbar and colorbar are completely invisible, so they are silently repositioned to their overlay locations — dimbar near the top of the canvas, colorbar near the bottom. They teleport while invisible, not animate. Then they fade from invisible to visible at those positions. They do not move during this fade-in.
 
 ### Pinching back out (progress 1 → 0)
 

{arrayview-0.15.0 → arrayview-0.17.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: arrayview
-Version: 0.15.0
+Version: 0.17.0
 Summary: Fast multi-dimensional array viewer
 Project-URL: Home, https://github.com/oscarvanderheide/arrayview
 Project-URL: Source, https://github.com/oscarvanderheide/arrayview
@@ -16,6 +16,7 @@ Classifier: Programming Language :: Python :: 3.12
 Requires-Python: >=3.12
 Requires-Dist: fastapi>=0.129.0
 Requires-Dist: h5py>=3.0
+Requires-Dist: jupyter-server-proxy>=4.0
 Requires-Dist: matplotlib>=3.9.0
 Requires-Dist: nibabel>=5.3.3
 Requires-Dist: numpy>=2.4.2

{arrayview-0.15.0 → arrayview-0.17.0}/docs/loading.md

@@ -61,7 +61,7 @@ Key parameters:
 | `None` | Auto: native outside Jupyter, inline inside |
 | `"native"` | Native desktop window |
 | `"browser"` | System browser |
-| `"vscode"` | VS Code Simple Browser |
+| `"vscode"` | VS Code tab |
 | `"inline"` | Inline IFrame (Jupyter / VS Code notebook) |
 
 ## File Picker

{arrayview-0.15.0 → arrayview-0.17.0}/docs/remote.md

@@ -12,7 +12,7 @@ Then open `http://localhost:8000` in your local browser.
 
 ## VS Code
 
-Auto-detects VS Code terminals and opens in Simple Browser. Works automatically.
+Auto-detects VS Code terminals and opens in a VS Code tab. Works automatically.
 
 ## VS Code tunnel
 
@@ -73,7 +73,7 @@ ssh -R 8000:localhost:8000 user@gpu-server
 arrayview array.npy
 ```
 
-The array is sent back to the remote machine and the viewer opens in Simple Browser locally.
+The array is sent back to the remote machine and the viewer opens in a VS Code tab locally.
 
 If port 8000 is already taken on the GPU server:
 
@@ -88,5 +88,5 @@ arrayview array.npy --relay 8765
 |-------|----------|
 | `native` | Desktop window (default outside Jupyter) |
 | `browser` | System browser |
-| `vscode` | VS Code Simple Browser |
+| `vscode` | VS Code tab |
 | `inline` | Inline IFrame (default in Jupyter) |

{arrayview-0.15.0 → arrayview-0.17.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "arrayview"
-version = "0.15.0"
+version = "0.17.0"
 description = "Fast multi-dimensional array viewer"
 readme = { file = "README.md", content-type = "text/markdown" }
 requires-python = ">=3.12"
@@ -22,6 +22,7 @@ urls = { "Home" = "https://github.com/oscarvanderheide/arrayview", "Source" = "h
 dependencies = [
     "fastapi>=0.129.0",
     "h5py>=3.0",
+    "jupyter-server-proxy>=4.0",
     "matplotlib>=3.9.0",
     "nibabel>=5.3.3",
     "numpy>=2.4.2",

{arrayview-0.15.0 → arrayview-0.17.0}/src/arrayview/ARCHITECTURE.md

@@ -26,11 +26,11 @@ Frontend (_viewer.html — single self-contained HTML file)
 | Environment        | Default display                    | Server mode |
 |--------------------|------------------------------------|-------------|
 | Jupyter            | Inline iframe                      | network     |
-| VS Code local      | Simple Browser (network)           | network     |
+| VS Code local      | Webview panel (network)            | network     |
 | VS Code tunnel     | Direct webview (stdio)             | stdio       |
 | Julia              | System browser                     | network     |
 | CLI / Python script | Native pywebview                   | network     |
-| SSH terminal (ni)  | VS Code ext via TCP relay (prints URL on relay failure) | network |
+| SSH terminal       | Prints URL — user forwards port with `ssh -L` | network |
 
 Detection logic lives in `_platform.py`. Display opening logic lives in `_launcher.py` (section: ViewHandle and view() API) and `_vscode.py`.
 
@@ -43,7 +43,7 @@ Detection logic lives in `_platform.py`. Display opening logic lives in `_launch
 | `_app.py` | 179 | Backward-compat shim — re-exports everything from the split modules |
 | `_config.py` | 121 | `~/.arrayview/config.toml` read/write, valid window modes/env keys |
 | `_io.py` | 253 | Data loading: numpy, NIfTI (lazy nibabel), zarr, DICOM, raw files |
-| `_launcher.py` | 2817 | **Main entry.** CLI parser, `view()` API, `ViewHandle`, server lifecycle, SSH relay, demo arrays, file watching |
+| `_launcher.py` | 2817 | **Main entry.** CLI parser, `view()` API, `ViewHandle`, server lifecycle, reverse-tunnel relay, demo arrays, file watching |
 | `_platform.py` | 396 | Environment detection: Jupyter, VS Code, SSH, tunnel, Julia, native-window capability |
 | `_render.py` | 834 | Rendering pipeline: colormap LUTs, slice extraction, RGBA/RGB/mosaic rendering, overlay compositing, preload |
 | `_segmentation.py` | 227 | nnInteractive segmentation client (pure HTTP, no nnInteractive dependency) |