arrayview 0.25.1__tar.gz → 0.26.0__tar.gz

{arrayview-0.25.1 → arrayview-0.26.0}/.mex/context/frontend.md

@@ -18,7 +18,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-05-16
+last_updated: 2026-06-05
 ---
 
 # Frontend (_viewer.html)

{arrayview-0.25.1 → arrayview-0.26.0}/.mex/context/project-state.md

@@ -7,7 +7,7 @@ triggers:
   - "recent work"
   - "active feature"
   - "shipped recently"
-last_updated: 2026-05-13
+last_updated: 2026-06-05
 ---
 
 # Project State
@@ -40,6 +40,18 @@ last_updated: 2026-05-13
 
 ## Recently Completed
 
+- ROI keybind changed from `r` to `Shift+R` (`R`); rotate/flip is now `r`, transpose is `t`
+- Crossfade animation added to rotate/transpose transitions
+- `--version` flag and version string in help overlay
+- In-viewer array picker for multi-array `.mat` and `.npz` files
+- ROI stats tooltips for qMRI canvases (per-parameter-map sub-rows in the island)
+- Invocation lifecycle contract defined and hardened: local VS Code CLI launches use transient daemon shutdown, remote/tunnel launches remain persistent only where transport requires it, URL webview backend checks run in the extension host against `/ping`, URL panel disposal releases all sessions encoded in the viewer URL, quick viewer connect/disconnect races detected by monotonic connection counter, ambiguous multi-window tunnel routing fails closed, stale viewer SID retry state cleared on WebSocket disconnect, bundled opener extension rebuilt as v0.14.12
+- Hover info wrong values fixed
+- Native launcher startup restored
+- qMRI pane sizing stabilized
+- VS Code extension Windows support (select/pipes, venv path, ppid)
+- Tool launcher motion refined
+
 - VS Code tab lifecycle hardening: local VS Code CLI launches now use transient daemon shutdown instead of `persist=True`, remote/tunnel launches remain persistent only where transport requires it, URL webview backend checks run in the extension host against `/ping`, URL panel disposal releases all sessions encoded in the viewer URL via tested lifecycle helpers, quick viewer connect/disconnect races are detected by a monotonic connection counter, ambiguous multi-window tunnel routing now fails closed instead of opening in a guessed window, stale viewer SID retry state is cleared on WebSocket disconnect, and the bundled opener extension was rebuilt as v0.14.12.
 - Shift+C colormap picker redesign: the old centered shortlist is now a narrow translucent right-edge drawer with a close button, a yellow `Colormaps` title plus a `Favorites` subtitle, and a plain 12-swatch two-column quick set that stays visible above the search field. Search matches render in a separate results area below the input, Enter first exits the search field before a second Enter commits, arrow-key movement follows the visible two-column grid, and repeated `c` presses cycle through the currently visible swatches while the picker is open.
 - Detached compare-on-X: single-array non-spatial dimensions now support the same compare-center family as two-array compare. The frontend reuses compare mode with per-pane detached indices, the dimbar shows a purple `X`, the compare titles show index-over-total labels, `[` / `]` control pane A, `{` / `}` control pane B, and repeated `X` exits detached compare after cycling the center modes. Focused coverage now includes a browser regression for detached entry/scrubbing/exit plus API coverage for split `/diff` indices on the same session.
@@ -55,7 +67,7 @@ last_updated: 2026-05-13
 ## 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
+- ROI + qMRI integration refinements: floodfill not yet supported on qMRI panes; per-pane stats are re-fetched on each ROI draw but not updated on slice scroll
 
 ## Not Yet Built
 

{arrayview-0.25.1 → arrayview-0.26.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: arrayview
-Version: 0.25.1
+Version: 0.26.0
 Summary: Fast multi-dimensional array viewer
 Project-URL: Home, https://github.com/oscarvanderheide/arrayview
 Project-URL: Source, https://github.com/oscarvanderheide/arrayview

{arrayview-0.25.1 → arrayview-0.26.0}/docs/comparing.md

@@ -9,6 +9,10 @@ uvx arrayview base.npy a.npy b.npy c.npy    # up to 6
 
 Or use the file picker (`Cmd/Ctrl+O`) or drag-and-drop.
 
+## Switching between arrays
+
+`n` cycles the compare target array (when multiple arrays are loaded).
+
 ## Center pane
 
 `X` cycles through comparison modes:

{arrayview-0.25.1 → arrayview-0.26.0}/docs/display.md

@@ -8,7 +8,7 @@
 ## Dynamic range
 
 `d` cycles quantile presets: 0–100%, 1–99%, 5–95%, 10–90%. Expands the colorbar into a histogram.
-`D` toggles range lock. Locked (default): the range from `d` stays fixed during navigation. Unlocked: vmin/vmax auto-recompute per slice.
+`D` opens a histogram dim picker (3-state toggle for which dimensions participate).
 
 ## Window / level
 
@@ -28,4 +28,8 @@ Drag the colorbar to shift the window. Scroll on the colorbar to narrow or widen
 
 ## Layout
 
-`b` toggles a border around the canvas. `a` stretches panes to a square aspect ratio.
+`b` toggles a border around the canvas. `B` toggles rounded panes. `a` stretches panes to a square aspect ratio.
+
+## Caveat
+
+ArrayView works across six invocation environments (CLI, Python script, Jupyter, Julia, VS Code, SSH). Not every feature has been verified in every mode. If something behaves differently than documented, check the [remote](remote.md) page for environment-specific notes or open an issue.

{arrayview-0.25.1 → arrayview-0.26.0}/docs/loading.md

@@ -11,10 +11,12 @@
 | `.pt` / `.pth` | torch | Converted to numpy |
 | `.h5` / `.hdf5` | h5py | Must contain one dataset |
 | `.tif` / `.tiff` | tifffile | Full load |
-| `.mat` | scipy | Must contain one ndarray |
+| `.mat` | scipy / h5py | Multi-array: in-viewer picker for array selection |
 
 Optional libraries are imported only when needed.
 
+Multi-array formats (`.npz`, `.mat`) show an in-viewer picker when they contain more than one array.
+
 ## CLI
 
 ```bash
@@ -22,6 +24,7 @@ uvx arrayview volume.nii.gz
 uvx arrayview volume.npy --window browser
 uvx arrayview image.npy --rgb
 uvx arrayview --watch data.npy              # reload on file change
+uvx arrayview --version                     # print version
 ```
 
 ## Python
@@ -49,7 +52,7 @@ Key parameters:
 |-----------|------|-------------|
 | `data` | array-like | The array to display |
 | `name` | str | Label shown in the viewer tab |
-| `port` | int | Server port (default 8123) |
+| `port` | int | Server port (default 8123 for Python API, 8000 for CLI) |
 | `window` | str \| None | How to open the viewer (see below) |
 | `rgb` | bool | Treat last/first axis as RGB/RGBA channels |
 | `overlay` | array or list | Arrays composited as overlays |

arrayview-0.26.0/docs/measurement.md

@@ -0,0 +1,40 @@
+# Measurement
+
+## ROI
+
+`Shift+R` opens ROI options. Draw on the canvas to measure a region — live stats (mean, std, min, max) appear in the floating panel.
+
+Shapes: rectangle, ellipse, freehand, flood fill. Switch via the shape icons in the panel.
+
+For flood fill, `[` / `]` adjusts tolerance.
+
+Click an existing ROI to select it. `Delete` / `Backspace` removes it.
+
+`N` exports the ROI mask as `.npy`.
+
+## Ruler
+
+`u` — enter ruler mode. Click two points to measure pixel distance. Press `u` again to exit.
+
+## Pixel info
+
+Hover over the image to see coordinates and value reflected on the colorbar.
+
+Click the colorbar to copy that value to the clipboard.
+
+`i` — toggle a persistent hover tooltip that follows the cursor.
+
+`I` — show a data info overlay: shape, dtype, size, file path.
+
+## Export
+
+| Key | Action |
+|-----|--------|
+| `s` | Open save options (screenshot PNG, GIF, .npy export) |
+| `e` | Copy a reusable URL to clipboard |
+
+Screenshots download as PNG. GIF saves an animation along the current slice dimension. `.npy` export saves the current slice.
+
+## Caveat
+
+ArrayView works across six invocation environments (CLI, Python script, Jupyter, Julia, VS Code, SSH). Not every feature has been verified in every mode. If something behaves differently than documented, check the [remote](remote.md) page for environment-specific notes or open an issue.

arrayview-0.26.0/docs/viewing.md

@@ -0,0 +1,47 @@
+# Viewing
+
+## Normal
+
+The default view. Shows a single 2D slice. Scroll to move through slices. `h`/`l` changes the scroll dimension; `j`/`k` steps one slice at a time.
+
+`r` rotates 90 degrees or flips the axis. `t` transposes x and y.
+
+## Multi-view
+
+`v` — splits the canvas into three orthogonal planes (axial, coronal, sagittal). Drag the crosshair to navigate. Shift+drag for oblique rotation. `V` opens custom dimension selection; `o` resets the orientation.
+
+## Mosaic
+
+`z` — lays out a grid of slices along the next dimension. Scrolling then steps through the dimension after that.
+
+## Projections
+
+`p` — cycles through statistical projections along the scroll axis: MAX, MIN, MEAN, STD, SOS. 
+
+## FFT
+
+`f` — displays a centered FFT of the array. Prompts for which axes to transform.
+
+## RGB
+
+Rendered as direct color via `--rgb` on the CLI or `rgb=True` in Python. The first or last dimension must be size 3 (RGB) or 4 (RGBA). No direct keybind — set at launch.
+
+## Immersive
+
+`Shift+F` — fullscreen with all chrome hidden. Move the mouse to briefly reveal controls.
+
+## Zen mode
+
+`Z` — hides UI chrome (dimbar, info, island) for a clean view. Press `Z` again to restore.
+
+## Complex data
+
+`m` — cycles through magnitude, phase, real, and imaginary parts for complex-valued arrays.
+
+## Navigation
+
+Scroll through slices. `/` opens the tool launcher for ortho, compare, qMRI, ROI, segmentation, FFT, projections, and overlays. The direct keys still work. `0` resets the zoom. `?` shows the full key guide.
+
+## Caveat
+
+ArrayView works across six invocation environments (CLI, Python script, Jupyter, Julia, VS Code, SSH). Not every feature has been verified in every mode. If something behaves differently than documented, check the [remote](remote.md) page for environment-specific notes or open an issue.

{arrayview-0.25.1 → arrayview-0.26.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "arrayview"
-version = "0.25.1"
+version = "0.26.0"
 description = "Fast multi-dimensional array viewer"
 readme = { file = "README.md", content-type = "text/markdown" }
 requires-python = ">=3.12"

{arrayview-0.25.1 → arrayview-0.26.0}/src/arrayview/_launcher.py

@@ -2996,6 +2996,8 @@ def arrayview():
         return
 
     parser = argparse.ArgumentParser(description="Lightning Fast ND Array Viewer")
+    from arrayview import __version__ as _av_version
+    parser.add_argument("--version", action="version", version=f"arrayview {_av_version}")
     parser.add_argument(
         "files",
         nargs="*",

{arrayview-0.25.1 → arrayview-0.26.0}/src/arrayview/_server.py

@@ -20,6 +20,7 @@ from arrayview._session import (
     SESSIONS,
     COLORMAPS,
 )
+from arrayview import __version__ as _av_version
 import arrayview._session as _session_mod  # for mutable VIEWER_SOCKETS
 
 from arrayview._render import (
@@ -195,6 +196,7 @@ def get_ui(sid: str = None):
         .replace("__DEFAULT_THEME_IDX__", str(_default_theme_idx))
         .replace("__DEFAULT_ROUNDED_PANES__", _default_rounded_panes)
         .replace("__BODY_CLASS__", "av-loading" if sid else "")
+        .replace("__ARRAYVIEW_VERSION__", _av_version)
     )
     headers = {"Cache-Control": "no-store"}
     return HTMLResponse(content=html, headers=headers)

{arrayview-0.25.1 → arrayview-0.26.0}/src/arrayview/_stdio_server.py

@@ -23,6 +23,7 @@ import uuid
 
 import numpy as np
 
+from arrayview import __version__ as _av_version
 from arrayview._analysis import (
     _build_metadata,
     _lebesgue_slice,
@@ -686,6 +687,7 @@ def _handle_get_viewer_html(msg: dict) -> None:
         .replace("__DEFAULT_THEME_IDX__", str(_default_theme_idx))
         .replace("__DEFAULT_ROUNDED_PANES__", _default_rounded_panes)
         .replace("__BODY_CLASS__", "av-loading" if sid else "")
+        .replace("__ARRAYVIEW_VERSION__", _av_version)
     )
 
     _write_json({"html": html})