arrayview 0.25.1__tar.gz → 0.26.1__tar.gz

{arrayview-0.25.1 → arrayview-0.26.1}/.agents/skills/invocation-consistency/SKILL.md

@@ -20,6 +20,15 @@ Every behavior that depends on *how* arrayview is started (server lifecycle, bro
 | **VS Code terminal** | `arrayview()` or `view()` | VS Code Simple Browser | in-process or subprocess |
 | **Plain SSH (no VS Code)** | `arrayview()` or `view()` | prints port-forward hint | in-process or subprocess |
 
+## Transport Split
+
+ArrayView has two backend transports. Invocation-sensitive fixes must account for both:
+
+- **Network mode**: FastAPI routes and WebSocket server. File registration goes through `/load` in `_routes_loading.py`; spawned CLI sessions load in `_launcher._serve_daemon()`.
+- **VS Code direct mode**: stdio subprocess. VS Code tunnel launches write a signal file; the extension runs `python -m arrayview --mode stdio <file>`, and file registration goes through `_stdio_server._handle_register()`.
+
+Do not assume a `/load` or daemon fix covers VS Code tunnel. Shared behavior such as file-format key selection belongs in `_io.py` helpers and must be used by both transports.
+
 ## Key Detection Functions (all in `_platform.py`)
 
 ```python
@@ -86,17 +95,24 @@ for pid_str in client_pids:
    - Jupyter: repeated calls don't fail on port-already-in-use
    - Julia: `_view_julia()` passes new params via CLI flag or file
 
-2. **Browser/display opening?**
+2. **File/session registration consistent?**
+   - FastAPI `/load` path handles the feature
+   - CLI spawned daemon path handles the feature
+   - VS Code direct stdio `_handle_register()` path handles the feature
+   - Direct `--mode stdio <file>` CLI path handles the feature
+   - Multi-array/default-key behavior is centralized in `_io.py`
+
+3. **Browser/display opening?**
    - Local native window (macOS): `pywebview` opens correctly
    - VS Code terminal: Simple Browser opens via extension signal file
    - VS Code tunnel: reaches client-side Simple Browser, not remote host
    - Verify `_ensure_vscode_extension()` installs/updates if VSIX changed
 
-3. **Environment detection?**
+4. **Environment detection?**
    - Check detection order: Julia → Jupyter → VS Code remote → VS Code terminal → local
    - `_find_vscode_ipc_hook()` walks up to 12 parent processes; new subprocess wrappers may need the same
 
-4. **VS Code extension changed?**
+5. **VS Code extension changed?**
    - Rebuild VSIX: `cd vscode-extension && vsce package -o ../src/arrayview/arrayview-opener.vsix`
    - Bump `_VSCODE_EXT_VERSION` in `_vscode.py` and `vscode-extension/package.json` together
 
@@ -111,6 +127,8 @@ uv run python -c "from arrayview import view; import numpy as np; view(np.zeros(
 ## Red Flags — STOP
 
 - "I changed server startup but only tested CLI" → test all paths
+- "I fixed `/load` but not `_stdio_server.py`" → VS Code tunnel can still be broken
+- "I fixed `_serve_daemon()` but `--diagnose` says `is_vscode_remote: true`" → tunnel uses stdio direct mode, not the daemon
 - "Works locally but not in tunnel" → check `_is_vscode_remote()` path and port exposure
 - "I used `127.0.0.1` in the URL" → use `localhost`
 - "I fixed tmux with `#{client_pid}`" → only works with one client; use `list-clients`

{arrayview-0.25.1 → arrayview-0.26.1}/.mex/context/architecture.md

@@ -20,7 +20,7 @@ edges:
     condition: when the task involves _viewer.html, modes, reconcilers, or the View Component System
   - target: context/render-pipeline.md
     condition: when the task involves slice extraction, colormaps, caching, or the render thread
-last_updated: 2026-06-05
+last_updated: 2026-06-11
 ---
 
 # Architecture
@@ -90,6 +90,17 @@ Tool launch, tool activation, and drawer visibility are separate states.
 
 Detection logic: `_platform.py`. Display opening: `_launcher.py` + `_vscode.py`.
 
+## File Registration Paths
+
+File parsing belongs in `_io.py`, but session registration happens through different transports:
+
+- **Network `/load`**: existing FastAPI server path in `_routes_loading.py`.
+- **Spawned CLI daemon**: `_launcher._serve_daemon()` loads before publishing the pending session.
+- **VS Code tunnel direct webview**: `_stdio_server._handle_register()` handles `python -m arrayview --mode stdio <file>` spawned by the extension.
+- **Direct stdio CLI mode**: `_launcher.arrayview()` preloads positional files before starting `run_stdio_server()`.
+
+For multi-array formats or formats with non-displayable members, keep key filtering/default selection in `_io.py` helpers and call those helpers from every registration path. A fix in `/load` alone does not cover VS Code tunnel.
+
 ## External Dependencies
 
 - **FastAPI + uvicorn** — async HTTP/WebSocket server, lazy-imported in `_launcher.py`. Never call uvicorn directly — use the `_uvicorn()` accessor.

{arrayview-0.25.1 → arrayview-0.26.1}/.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.1}/.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.1}/.mex/patterns/add-file-format.md

@@ -15,20 +15,26 @@ edges:
     condition: for the lazy import pattern and Verify Checklist
   - target: context/render-pipeline.md
     condition: when the new format returns an unusual dtype that may affect the render pipeline
-last_updated: 2026-05-16
+last_updated: 2026-06-11
 ---
 
 # Add File Format
 
 ## Context
 
-All file loading goes through `_io.load_data(filepath)` in `src/arrayview/_io.py`. The function dispatches on file extension. New formats must:
+All file parsing goes through `_io.load_data(filepath)` or `_io.load_data_with_meta(filepath)` in `src/arrayview/_io.py`. The function dispatches on file extension. New formats must:
 1. Register the extension in `_SUPPORTED_EXTS`
 2. Add a lazy import (if the library is not already imported at module level)
 3. Add a dispatch branch in `load_data()`
 4. Return a numpy array (or array-like with `.shape` and `.dtype`)
 
-The server (`_server.py`) and CLI (`_launcher.py`) never import format libraries directly — all loading goes through `_io.load_data()`.
+Transport/session creation is separate from parsing:
+
+- FastAPI `/load`: `src/arrayview/_routes_loading.py`
+- CLI spawned daemon and direct stdio CLI mode: `src/arrayview/_launcher.py`
+- VS Code tunnel direct webview: `src/arrayview/_stdio_server.py`
+
+The server and CLI must not import format libraries directly. They may call generic `_io` helpers such as `list_array_keys()` or `default_array_key()` when they need to choose a key before creating a session.
 
 ## Steps
 
@@ -74,18 +80,28 @@ The server (`_server.py`) and CLI (`_launcher.py`) never import format libraries
        return list(_mylib().peek_shape(fpath))
    ```
 
+7. **Keep key/default selection consistent across transports** for multi-array formats (`.npz`, `.mat`, HDF5-like containers):
+   - Put filtering and default-key logic in `_io.py`, not in a route or launcher branch.
+   - Use the same helper from FastAPI `/load`, CLI daemon/direct paths, and `_stdio_server.py`.
+   - If `/load` returns picker keys for multiple arrays, define what non-picker transports do (usually first displayable key).
+
 ## Gotchas
 
 - **Do not import the format library at the top of `_io.py`** without checking import cost first. Nibabel is the reference: it is lazy because it costs ~200 ms on first import.
 - **`.nii.gz` is two extensions** — the dispatch checks the full suffix, not just the last dot. New formats with compound extensions (`.foo.bar`) need special suffix handling in `load_data()`.
 - **Zarr is not loaded via `load_data()`** in all paths — zarr arrays can also be passed directly to `view()` as array objects. Ensure zarr-specific logic lives in `_session.py` / `_render.py`, not only in the file-load path.
-- **No format-specific code in `_server.py` or `_launcher.py`** — if you find yourself adding a format check in either of those modules, move it to `_io.py`.
+- **No format-specific parsing code in `_server.py`, `_launcher.py`, or `_stdio_server.py`** — if you find yourself adding a format import or dtype/shape filter in those modules, move it to `_io.py`.
+- **VS Code tunnel is stdio, not HTTP** — `arrayview file.ext` in a VS Code tunnel writes a signal file; the extension then runs `python -m arrayview --mode stdio file.ext`. A `/load` fix alone does not cover this path.
 
 ## Verify
 
 - [ ] Extension added to `_SUPPORTED_EXTS`
 - [ ] New library import is lazy (accessor function pattern) unless it imports in <10 ms
 - [ ] `load_data("myfile.myext")` returns a numpy array with correct shape and dtype
+- [ ] If the format can contain multiple arrays or non-displayable members, add tests for `list_array_keys()` / `default_array_key()` and direct `load_data(..., key=...)`
+- [ ] FastAPI `/load` works for the file, including picker/default-key behavior
+- [ ] `_stdio_server._handle_register()` works for the file, because VS Code tunnel direct webview uses stdio instead of `/load`
+- [ ] CLI daemon/direct paths use generic `_io` helpers for key selection instead of duplicating format rules
 - [ ] `view(load_data("myfile.myext"))` opens the viewer without errors
 - [ ] If full-load format, added to `FULL_LOAD_EXTS`
 - [ ] `uv run pytest` on `tests/test_mode_consistency.py` still passes (no dtype regressions)

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: arrayview
-Version: 0.25.1
+Version: 0.26.1
 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.1}/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.1}/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.1}/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.1/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.1/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.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "arrayview"
-version = "0.25.1"
+version = "0.26.1"
 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.1}/src/arrayview/__init__.py

@@ -1,4 +1,5 @@
-__version__ = "0.25.1"
+import importlib.metadata as _metadata
+__version__ = _metadata.version("arrayview")
 
 __all__ = [
     "TrainingMonitor",

{arrayview-0.25.1 → arrayview-0.26.1}/src/arrayview/_io.py

@@ -38,6 +38,15 @@ def _fix_mat_complex(arr):
     return arr
 
 
+def _is_viewable_mat_array(value):
+    """True for MATLAB arrays ArrayView can display directly."""
+    return (
+        isinstance(value, np.ndarray)
+        and value.ndim >= 1
+        and value.dtype.kind in ("b", "i", "u", "f", "c")
+    )
+
+
 def list_npz_keys(filepath):
     """Return [{key, shape, dtype}] for each ndarray in an .npz file.
 
@@ -67,7 +76,7 @@ def list_mat_keys(filepath):
         for k, v in mat.items():
             if k.startswith("_"):
                 continue
-            if isinstance(v, np.ndarray) and v.ndim >= 1 and v.dtype.kind in ("b", "i", "u", "f", "c"):
+            if _is_viewable_mat_array(v):
                 keys.append({"key": k, "shape": list(v.shape), "dtype": str(v.dtype)})
         return keys
     except NotImplementedError:
@@ -95,6 +104,12 @@ def list_array_keys(filepath):
     return []
 
 
+def default_array_key(filepath):
+    """Return the first selectable array key for multi-array formats, if any."""
+    keys = list_array_keys(filepath)
+    return keys[0]["key"] if keys else None
+
+
 def _select_npz_array(npz, filepath):
     """Load the first array from a multi-array .npz file.
 
@@ -233,7 +248,7 @@ def load_data(filepath, key=None):
             arrays = {
                 k: v
                 for k, v in mat.items()
-                if not k.startswith("_") and isinstance(v, np.ndarray)
+                if not k.startswith("_") and _is_viewable_mat_array(v)
             }
             if key is not None:
                 return _fix_mat_complex(arrays[key])

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

@@ -2717,7 +2717,7 @@ def _serve_daemon(
                     _array_keys = list_array_keys(filepath)
                 except Exception:
                     pass
-            _load_key = _array_keys[0]["key"] if _array_keys and len(_array_keys) > 1 else None
+            _load_key = _array_keys[0]["key"] if _array_keys else None
             data, spatial_meta = load_data_with_meta(filepath, key=_load_key)
             if cleanup:
                 try:
@@ -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="*",
@@ -3185,12 +3187,12 @@ def arrayview():
             )
             print(f"SESSION:{info}", file=sys.stderr)
         elif args.files:
-            from arrayview._io import load_data
+            from arrayview._io import default_array_key, load_data
             from arrayview._session import SESSIONS, Session
 
             # First file is the main array
             base_path = args.files[0]
-            data = load_data(base_path)
+            data = load_data(base_path, key=default_array_key(base_path))
             session = Session(
                 data=data,
                 filepath=base_path,
@@ -3203,7 +3205,10 @@ def arrayview():
             if getattr(args, "vectorfield", None):
                 from arrayview._vectorfield import _configure_vectorfield
 
-                vf_data = load_data(args.vectorfield)
+                vf_data = load_data(
+                    args.vectorfield,
+                    key=default_array_key(args.vectorfield),
+                )
                 _configure_vectorfield(
                     session, vf_data,
                     getattr(args, "vectorfield_components_dim", None),
@@ -3214,7 +3219,7 @@ def arrayview():
             # Load overlay(s) as separate sessions
             overlay_sids = []
             for ov_path in (getattr(args, "overlay", None) or []):
-                ov_data = load_data(ov_path)
+                ov_data = load_data(ov_path, key=default_array_key(ov_path))
                 ov_session = Session(
                     data=ov_data,
                     filepath=ov_path,
@@ -3230,7 +3235,7 @@ def arrayview():
             if getattr(args, "compare", None):
                 compare_paths.append(args.compare)
             for cp in compare_paths:
-                cmp_data = load_data(cp)
+                cmp_data = load_data(cp, key=default_array_key(cp))
                 cmp_session = Session(
                     data=cmp_data,
                     filepath=cp,
@@ -3570,18 +3575,21 @@ def arrayview():
 
     if args.vectorfield:
         try:
-            from arrayview._io import load_data
+            from arrayview._io import default_array_key, load_data
             from arrayview._render import _detect_rgb_axis
             from arrayview._vectorfield import _resolve_vfield_layout
 
-            base_data = load_data(base_file)
+            base_data = load_data(base_file, key=default_array_key(base_file))
             image_shape = tuple(int(s) for s in base_data.shape)
             if args.rgb:
                 rgb_axis = _detect_rgb_axis(image_shape)
                 image_shape = tuple(
                     s for i, s in enumerate(image_shape) if i != rgb_axis
                 )
-            vf_data = load_data(args.vectorfield)
+            vf_data = load_data(
+                args.vectorfield,
+                key=default_array_key(args.vectorfield),
+            )
             layout = _resolve_vfield_layout(
                 tuple(int(s) for s in vf_data.shape),
                 image_shape,

{arrayview-0.25.1 → arrayview-0.26.1}/src/arrayview/_platform.py

@@ -2,6 +2,7 @@
 
 from __future__ import annotations
 
+import importlib.util
 import os
 import subprocess
 import sys
@@ -414,12 +415,13 @@ def _can_native_window() -> bool:
     # Plain SSH (no VS Code): the display is on the client machine, not here.
     if os.environ.get("SSH_CLIENT") or os.environ.get("SSH_CONNECTION"):
         return False
+    if importlib.util.find_spec("webview") is None:
+        return False
     if sys.platform in ("darwin", "win32"):
         return True
     # Linux/BSD: need a display server AND pywebview's GUI bindings
     if not (os.environ.get("DISPLAY") or os.environ.get("WAYLAND_DISPLAY")):
         return False
-    import importlib.util
 
     return (
         importlib.util.find_spec("qtpy") is not None

{arrayview-0.25.1 → arrayview-0.26.1}/src/arrayview/_routes_loading.py

@@ -123,8 +123,14 @@ def register_loading_routes(app, *, notify_shells, setup_rgb) -> None:
                 _array_keys = await asyncio.to_thread(list_array_keys, filepath)
                 if len(_array_keys) > 1 and not _key:
                     return {"array_keys": _array_keys, "filepath": filepath}
+                if len(_array_keys) == 1 and not _key:
+                    _key = _array_keys[0]["key"]
 
-            data, spatial_meta = await asyncio.to_thread(load_data_with_meta, filepath, key=_key)
+            data, spatial_meta = await asyncio.to_thread(
+                load_data_with_meta,
+                filepath,
+                key=_key,
+            )
         except Exception as e:
             return {"error": str(e)}
         session = await asyncio.to_thread(Session, data, filepath=filepath, name=name)

{arrayview-0.25.1 → arrayview-0.26.1}/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.1}/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,
@@ -114,7 +115,12 @@ def _handle_register(msg: dict) -> None:
     name = msg.get("name") or __import__("os").path.basename(file_path)
     options = msg.get("options", {})
 
-    data, spatial_meta = load_data_with_meta(file_path)
+    from ._io import default_array_key
+
+    data, spatial_meta = load_data_with_meta(
+        file_path,
+        key=default_array_key(file_path),
+    )
     session = Session(data=data, filepath=file_path, name=name)
     session.spatial_meta = spatial_meta
     if spatial_meta is not None:
@@ -686,6 +692,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})