arrayview 0.17.0__tar.gz → 0.19.0__tar.gz

arrayview-0.19.0/.agents/skills/frontend-designer/SKILL.md

@@ -0,0 +1,127 @@
+---
+name: frontend-designer
+description: Use when making any styling or layout change to _viewer.html. Ensures new UI is visually consistent with the established design language — dark theme, monospace typography, yellow accents, and minimal chrome.
+---
+
+# ArrayView Frontend Design Skill
+
+## Design Philosophy
+
+Minimal chrome. Let arrays fill the screen. UI elements are dim until needed; the array is always the primary focus.
+
+- Controls fade in on hover or keypress, not permanently visible
+- Text is small and monospaced
+- No decorative elements — every pixel either shows data or provides affordance
+- All four themes must look correct; never hardcode colors
+
+---
+
+## Design Tokens (CSS Custom Properties)
+
+All colors come from CSS variables defined on `:root`. Never use raw hex values in new code.
+
+| Variable | Dark default | Purpose |
+|----------|-------------|---------|
+| `--bg` | `#0c0c0c` | Page/canvas background |
+| `--surface` | `#141414` | Panel/overlay backgrounds |
+| `--surface-2` | `#1c1c1c` | Input fields, nested surfaces |
+| `--border` | `#2c2c2c` | Borders, dividers |
+| `--text` | `#d8d8d8` | Primary text |
+| `--muted` | `#5a5a5a` | Secondary/dim text, inactive labels |
+| `--highlight` | `#fff` | Maximum contrast text |
+| `--active-dim` | `#f5c842` | **Primary accent** — active state, keyboard keys, clim handles |
+| `--spatial-dim` | `#b48ead` | Spatial (x/y) dimension labels |
+| `--help-key` | `#f5c842` | Keyboard shortcut key labels in help overlay |
+| `--overlay-bg` | `rgba(0,0,0,0.72)` | Modal backdrop |
+| `--blur` | `blur(14px)` | Backdrop blur for overlays |
+| `--radius` | `10px` | Standard border radius |
+| `--radius-lg` | `14px` | Large panel border radius |
+
+Four themes exist: `dark` (default), `.light`, `.solarized`, `.nord`. Each redefines all tokens. Test with `T` key.
+
+---
+
+## Typography
+
+Single font stack throughout:
+```css
+font-family: 'SF Mono', ui-monospace, 'Cascadia Code', 'JetBrains Mono', monospace;
+```
+
+Sizes used in practice:
+- `10px` — tooltips, micro labels
+- `11px` — colorbar value labels, secondary info
+- `12px` — dim labels, position info
+- `13px` — array name, status bar, picker items
+- `15px` — dim scrubber labels
+- `16px` — mode/view headers
+
+Never use a sans-serif font. Never use `font-weight: bold` except via the `.highlight` or `.active-dim` classes.
+
+---
+
+## Layout Principles
+
+- `#wrapper`: flexbox column, centers content vertically and horizontally
+- Canvas fills available space; UI chrome is positioned absolutely around it
+- Bottom bar (`#info`): fixed height, monospace, dim text
+- Overlays (`#help-overlay`, `#uni-picker`, `#inline-prompt`): centered modal with `--overlay-bg` backdrop
+- Colorbar (`#slim-cb-wrap`): thin strip below canvas, expands only in Lebesgue mode
+
+**Canvas sizing:** canvas width/height are set by JavaScript (`scaleCanvas` and friends), not CSS. Do not set canvas dimensions in CSS.
+
+---
+
+## Component Patterns
+
+### Status/info text
+```css
+color: var(--muted); font-size: 12px;  /* passive info */
+color: var(--text);  font-size: 12px;  /* active info */
+color: var(--active-dim); font-weight: bold;  /* highlighted state */
+```
+
+### Panel/overlay
+```css
+background: var(--surface);
+border: 1px solid var(--border);
+border-radius: var(--radius-lg);
+padding: 16px 20px;
+```
+
+### Modal backdrop
+```css
+background: var(--overlay-bg);
+backdrop-filter: var(--blur);
+-webkit-backdrop-filter: var(--blur);
+```
+
+### Keyboard key labels (in help overlay)
+```html
+<span class="highlight">X</span>
+```
+CSS: `color: var(--help-key); font-weight: bold;`
+
+---
+
+## Do / Don't
+
+| Do | Don't |
+|----|-------|
+| Use `var(--active-dim)` for active/selected state | Hardcode `#f5c842` |
+| Keep new controls hidden by default, shown on interaction | Add persistent toolbar buttons |
+| Use `opacity` or `color: var(--muted)` for inactive state | Use `visibility: hidden` (breaks layout) |
+| Use `transition: opacity 0.15s` for hover reveals | Animate position/size (janky on canvas) |
+| Test all four themes with `T` key | Assume dark theme only |
+| Match existing font sizes | Introduce new size values |
+
+---
+
+## Checklist Before Shipping a UI Change
+
+- [ ] Tested in all four themes (dark, light, solarized, nord) with `T` key
+- [ ] No hardcoded color values — all via `var(--...)`
+- [ ] Font is monospace, size matches existing scale
+- [ ] New panel/overlay uses `--surface` + `--border` + `--radius-lg`
+- [ ] `viewer-ui-checklist` skill followed (smoke test updated)
+- [ ] `modes-consistency` skill followed if canvas/colorbar is involved

arrayview-0.19.0/.agents/skills/todo-workflow/SKILL.md

@@ -0,0 +1,37 @@
+---
+name: todo-workflow
+description: Use when working through TODO items, implementing batches of features or fixes, or when the user gives multiple tasks at once. Enforces commit-per-item, collateral updates, and cross-mode verification.
+---
+
+# TODO Workflow
+
+## Overview
+
+When working through multiple tasks (TODO items, feature requests, bug fixes given together), follow these rules for every item. The TODO list lives in `dev/TODO.md`.
+
+## Per-Item Rules
+
+Each finished item gets:
+1. **Its own commit** — one item, one commit, no batching
+2. **Updated tests** — add/update test coverage for new functionality
+3. **Updated README** — if user-facing behavior changed
+4. **UI audit** — run ui-consistency-audit skill to verify across all modes
+5. **Invocation check** — use invocation-consistency skill if touching server/startup/display-opening
+6. **VS Code check** — use vscode-simplebrowser skill if touching extension install, signal-file IPC, or auto-open logic. This breaks often.
+7. **Lessons learned** — update `dev/lessons_learned.md` with anything important for future sessions
+
+## Execution Rules
+
+- **Plan first** — write a plan before starting implementation
+- **Subagents** — spawn them for independent items to parallelize work
+- **Branching** — work on `main` unless parallelizing; if branches needed, rebase (no merge commits)
+- **Compact context** — clear/compact between items to stay sharp
+- **Skills** — use and update relevant skills, especially ui-consistency-audit
+
+## Design Philosophy
+
+The app is feature-rich but minimal — no clutter. Users should discover features and think: *"wait... it already does that?!"* Every feature should feel like a hidden gift, not visual noise.
+
+## When User Says They're Going to Sleep
+
+Don't ask for confirmation. Make your own decisions on remaining items. They expect to be impressed when they wake up.

{arrayview-0.17.0/.claude → arrayview-0.19.0/.agents}/skills/ui-consistency-audit/SKILL.md

@@ -256,7 +256,7 @@ Rules are enforced through multiple layers. When adding new rules, add enforceme
 | **CSS** | `!important` structural constraints | `_viewer.html` CSS (line ~156) | Always — structurally impossible to violate |
 | **Runtime JS** | `_validateUIState()` | `_viewer.html` JS (after `_positionFullscreenChrome`) | After every layout change, gated behind `?debug_ui=1` |
 | **Playwright** | `run_invariant_assertions()` + `run_immersive_exit_assertions()` | `tests/ui_audit.py` | During `ui_audit.py` runs (all tiers) |
-| **Skill** | This document (Section 5b) | `.claude/skills/ui-consistency-audit/SKILL.md` | When AI agent invokes the skill |
+| **Skill** | This document (Section 5b) | `.Codex/skills/ui-consistency-audit/SKILL.md` | When AI agent invokes the skill |
 
 **Cross-reference:**
 

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

@@ -37,7 +37,7 @@ Python package for interactively viewing multi-dimensional arrays (numpy, NIfTI,
 
 ## Commands
 - Test: `uv run pytest tests/`
-- Visual smoke: `uv run pytest tests/visual_smoke.py`
+- Visual smoke: `uv run python tests/visual_smoke.py`
 - CLI: `uvx arrayview <file>`
 - Build: `uv build`
 

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

@@ -52,7 +52,7 @@ pywebview, or system browser).
 - **`_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`.
+- **`_io.py`** — All file-format loading behind `load_data(filepath)`. Lazy nibabel import for NIfTI. Handles `.npy`, `.npz`, `.nii` and `.nii.gz`, `.zarr`, `.zarr.zip`, `.pt` and `.pth`, `.h5` and `.hdf5`, `.tif` and `.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, 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.
@@ -77,7 +77,7 @@ Detection logic: `_platform.py`. Display opening: `_launcher.py` + `_vscode.py`.
 - **nibabel** — NIfTI file loading. Lazy-imported in `_io.py` via `_nib()`. Only loaded for `.nii` / `.nii.gz`.
 - **numpy** — Core array type throughout. The only non-lazy import in the render path.
 - **matplotlib** — Colormap LUT generation only. Lazy, initialized once by `_init_luts()` in `_render.py`.
-- **qmricolors** — Registers the `lipari` and `navia` colormaps. Git dependency (`oscarvanderheide/qmricolors`).
+- **qmricolors** — Registers the `lipari` and `navia` colormaps. Git dependency (`https://github.com/oscarvanderheide/qmricolors.git`).
 - **zarr** — Lazy chunk access for `.zarr` / `.zarr.zip`. Chunk presets via `zarr_chunk_preset()` in `_session.py`.
 - **pywebview** — Native OS window. Lazy, only started when `_can_native_window()` is true.
 

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

@@ -7,7 +7,7 @@ triggers:
   - "recent work"
   - "active feature"
   - "shipped recently"
-last_updated: 2026-04-17
+last_updated: 2026-04-24
 ---
 
 # Project State
@@ -21,7 +21,7 @@ last_updated: 2026-04-17
 - NIfTI spatial metadata, RAS resampling
 - VS Code extension v0.14.5 — stable window ID via `EnvironmentVariableCollection`; `arrayview.openInFloatingWindow` setting moves new tabs to a floating window; `view(arr, floating=True)` and `arrayview file.npy --floating` open in a floating window per-call regardless of global setting; `!vscode.env.remoteName` guard removed (remote VS Code supports floating windows); floating mode now uses a single persistent shell hub panel (`_shell.html`) so all arrays share one floating window as tabs instead of opening separate windows; fixed: second CLI call now injects tab via `new_tab` postMessage relay (extension -> hub wrapper -> shell iframe) instead of relying on WebSocket notify which wasn't sent in VS Code mode
 - 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)
+- Colormap picker: `c` opens an expanded colorbar-island grid without changing the colormap; subsequent `c` taps cycle, hover/hjkl/arrows live-preview, Enter/click commits, Esc cancels, and auto-dismiss pauses while hovered
 - 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
@@ -42,4 +42,4 @@ last_updated: 2026-04-17
 ## Not Yet Built
 
 - Independent split view for mismatched-shape arrays (designed, shelved)
-- Admin/config UI (file-based `~/.arrayview/config.toml` only)
+- Admin/config UI (design intent: file-based user config only, no in-app admin panel)

{arrayview-0.17.0 → arrayview-0.19.0}/.mex/context/setup.md

@@ -13,7 +13,7 @@ edges:
     condition: when specific technology versions or library details are needed
   - target: context/architecture.md
     condition: when understanding how components connect during setup
-last_updated: 2026-04-15
+last_updated: 2026-04-22
 ---
 
 # Setup
@@ -28,7 +28,7 @@ last_updated: 2026-04-15
 
 1. Clone the repo
 2. `uv sync --all-groups` — installs all dependencies including dev and test groups
-3. `uv run arrayview dev/sample.npy` — smoke test: should open the viewer with a sample array
+3. `uv run arrayview debug/cig_meeting_examples/BraTS2021_00009_t1.nii.gz` — smoke test: should open the viewer with a sample array
 4. `uv run pytest tests/test_mode_consistency.py` — verify core render consistency passes
 
 For browser-based tests (playwright):
@@ -49,7 +49,7 @@ No `.env` file is needed. All env vars are optional overrides; the server runs w
 - `uvx arrayview <file>` — launch from anywhere without activating the venv
 - `uv run pytest tests/<target>` — run a specific test file
 - `uv run pytest tests/test_mode_consistency.py` — mode consistency suite (run after render changes)
-- `uv run pytest tests/visual_smoke.py` — browser smoke tests (requires playwright)
+- `uv run python tests/visual_smoke.py` — browser smoke tests (requires playwright)
 - `uv run pytest -m "not browser"` — all non-browser tests
 - `uv build` — build wheel + sdist in `dist/`
 

{arrayview-0.17.0 → arrayview-0.19.0}/.mex/context/stack.md

@@ -14,7 +14,7 @@ edges:
     condition: when understanding how to use a technology in this codebase
   - target: context/architecture.md
     condition: when understanding how a library fits into the overall system
-last_updated: 2026-04-15
+last_updated: 2026-04-22
 ---
 
 # Stack
@@ -34,7 +34,7 @@ last_updated: 2026-04-15
 - **zarr 2.17+** — lazy chunk access for `.zarr` / `.zarr.zip` files; chunk preset utility in `_session.py`.
 - **pillow 12+** — PNG encoding for slice frames sent over WebSocket.
 - **pywebview 6.1+** — native OS window for CLI / script invocations; lazy, only started when `_can_native_window()` is true.
-- **qmricolors** — registers `lipari` and `navia` colormaps into matplotlib; Git dependency (`oscarvanderheide/qmricolors`). Imported inside `_init_luts()`.
+- **qmricolors** — registers `lipari` and `navia` colormaps into matplotlib; Git dependency (`https://github.com/oscarvanderheide/qmricolors.git`). Imported inside `_init_luts()`.
 - **scipy** — `.mat` file loading via `scipy.io.loadmat`; lazy in `_io.py`.
 - **h5py** — `.h5` / `.hdf5` file loading; lazy in `_io.py`.
 - **tifffile** — `.tif` / `.tiff` file loading; lazy in `_io.py`.

{arrayview-0.17.0 → arrayview-0.19.0}/.vscode/settings.json

@@ -196,6 +196,24 @@
       "label": "ArrayView",
       "onAutoForward": "silent",
       "privacy": "public"
+    },
+    "8777": {
+      "protocol": "http",
+      "label": "ArrayView",
+      "onAutoForward": "silent",
+      "privacy": "public"
+    },
+    "8778": {
+      "protocol": "http",
+      "label": "ArrayView",
+      "onAutoForward": "silent",
+      "privacy": "public"
+    },
+    "8779": {
+      "protocol": "http",
+      "label": "ArrayView",
+      "onAutoForward": "silent",
+      "privacy": "public"
     }
   },
   "search.exclude": {

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: arrayview
-Version: 0.17.0
+Version: 0.19.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.17.0 → arrayview-0.19.0}/docs/display.md

@@ -2,7 +2,7 @@
 
 ## Colormaps
 
-`c` cycles through defaults: gray, lipari, navia, viridis, plasma, and more.
+`c` opens the colormap grid. Press `c` again to cycle; `Enter` accepts, `Esc` cancels.
 `C` enters any matplotlib colormap by name.
 
 ## Dynamic range

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

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

{arrayview-0.17.0 → arrayview-0.19.0}/scripts/release.sh

@@ -8,6 +8,7 @@ set -euo pipefail
 BUMP="minor"
 DRY_RUN=true
 NO_AI=false
+AI_TOOL="claude"
 
 usage() {
     cat <<EOF
@@ -15,6 +16,7 @@ Usage: $(basename "$0") [OPTIONS]
 
 Options:
   --bump {major,minor,patch}   Version bump type (default: minor)
+  --ai {claude,codex}          AI tool for release notes (default: claude)
   --execute                    Actually run (default is dry-run)
   --no-ai                      Skip AI release notes, use GitHub's --generate-notes
   -h, --help                   Show this help
@@ -24,6 +26,7 @@ EOF
 while [[ $# -gt 0 ]]; do
     case "$1" in
         --bump)   BUMP="$2"; shift 2 ;;
+        --ai)     AI_TOOL="$2"; shift 2 ;;
         --execute) DRY_RUN=false; shift ;;
         --no-ai)  NO_AI=true; shift ;;
         -h|--help) usage; exit 0 ;;
@@ -36,6 +39,11 @@ if [[ ! "$BUMP" =~ ^(major|minor|patch)$ ]]; then
     exit 1
 fi
 
+if [[ ! "$AI_TOOL" =~ ^(claude|codex)$ ]]; then
+    echo "Error: --ai must be claude or codex (got '$AI_TOOL')"
+    exit 1
+fi
+
 # --- Guard: clean working tree on main ---
 branch=$(git rev-parse --abbrev-ref HEAD)
 if [[ "$branch" != "main" ]]; then
@@ -67,6 +75,7 @@ run() {
 
 # --- Generate release notes ---
 CLAUDE_BIN="${CLAUDE_BIN:-$(command -v claude 2>/dev/null || echo claude)}"
+CODEX_BIN="${CODEX_BIN:-$(command -v codex 2>/dev/null || echo codex)}"
 PREV_TAG=$(git describe --tags --abbrev=0 HEAD 2>/dev/null || echo "")
 NOTES=""
 
@@ -76,9 +85,8 @@ else
     COMMITS=$(git log --oneline -20)
 fi
 
-if [[ "$NO_AI" == false ]] && command -v "$CLAUDE_BIN" &>/dev/null; then
-    echo "Generating release notes with Claude..."
-    NOTES=$("$CLAUDE_BIN" -p "You are writing release notes for arrayview $TAG (a Python array/image viewer).
+if [[ "$NO_AI" == false ]]; then
+    PROMPT="You are writing release notes for arrayview $TAG (a Python array/image viewer).
 
 Here are the commits since the last release ($PREV_TAG):
 
@@ -95,7 +103,26 @@ Rules:
 - Write for end-users, not developers (no commit hashes, no file names)
 - Use past tense (\"added\", \"fixed\", \"improved\")
 - Skip pure refactors/docs unless they affect user experience
-- Bold the feature name, keep the description to one sentence" 2>/dev/null) || true
+- Bold the feature name, keep the description to one sentence"
+
+    case "$AI_TOOL" in
+        claude)
+            if command -v "$CLAUDE_BIN" &>/dev/null; then
+                echo "Generating release notes with Claude..."
+                NOTES=$("$CLAUDE_BIN" -p "$PROMPT" 2>/dev/null) || true
+            fi
+            ;;
+        codex)
+            if command -v "$CODEX_BIN" &>/dev/null; then
+                echo "Generating release notes with Codex..."
+                tmpfile=$(mktemp)
+                trap 'rm -f "$tmpfile"' EXIT
+                if printf '%s\n' "$PROMPT" | "$CODEX_BIN" exec --output-last-message "$tmpfile" - >/dev/null 2>/dev/null; then
+                    NOTES=$(<"$tmpfile")
+                fi
+            fi
+            ;;
+    esac
 fi
 
 if [[ -z "$NOTES" ]]; then

{arrayview-0.17.0 → arrayview-0.19.0}/src/arrayview/_config.py

@@ -56,6 +56,24 @@ def get_viewer_theme() -> str | None:
     return None
 
 
+def get_viewer_rounded_panes() -> bool | None:
+    """Return user-configured default for rounded panes, or None if not configured."""
+    cfg = load_config()
+    viewer_cfg = cfg.get("viewer", {})
+    if not isinstance(viewer_cfg, dict):
+        return None
+    val = viewer_cfg.get("rounded_panes")
+    if isinstance(val, bool):
+        return val
+    if isinstance(val, str):
+        s = val.strip().lower()
+        if s in ("true", "1", "yes", "on"):
+            return True
+        if s in ("false", "0", "no", "off"):
+            return False
+    return None
+
+
 def get_nninteractive_url() -> str | None:
     """Return configured nnInteractive server URL, or None.
 

{arrayview-0.17.0 → arrayview-0.19.0}/src/arrayview/_launcher.py

@@ -2504,6 +2504,37 @@ def arrayview():
                         print(f"[ArrayView] Killed process {pid} on port {args.port}")
                     except ProcessLookupError:
                         pass
+                deadline = time.time() + 1.0
+                while time.time() < deadline:
+                    alive = []
+                    for pid in pids:
+                        try:
+                            os.kill(pid, 0)
+                            alive.append(pid)
+                        except ProcessLookupError:
+                            pass
+                    if not alive:
+                        break
+                    time.sleep(0.05)
+                else:
+                    for pid in alive:
+                        try:
+                            os.kill(pid, _signal.SIGKILL)
+                            print(f"[ArrayView] Force-killed process {pid} on port {args.port}")
+                        except ProcessLookupError:
+                            pass
+                    deadline = time.time() + 2.0
+                    while time.time() < deadline:
+                        alive = []
+                        for pid in pids:
+                            try:
+                                os.kill(pid, 0)
+                                alive.append(pid)
+                            except ProcessLookupError:
+                                pass
+                        if not alive:
+                            break
+                        time.sleep(0.05)
         return
 
     # -- --serve: start a persistent empty server and exit --

{arrayview-0.17.0 → arrayview-0.19.0}/src/arrayview/_server.py

@@ -74,7 +74,7 @@ from arrayview._render import (
 )
 
 from arrayview._io import load_data, _SUPPORTED_EXTS, _peek_file_shape
-from arrayview._config import get_viewer_colormaps, get_viewer_theme
+from arrayview._config import get_viewer_colormaps, get_viewer_rounded_panes, get_viewer_theme
 
 
 # ── Vector Field Helpers ──────────────────────────────────────────
@@ -1025,6 +1025,7 @@ def _build_metadata(session) -> dict:
         "has_vectorfield": session.vfield is not None,
         "vfield_n_times": _vfield_n_times(session),
         "is_rgb": session.rgb_axis is not None,
+        "has_source_file": bool(getattr(session, "filepath", None)),
     }
     target_shape = (
         session.spatial_shape if session.rgb_axis is not None else session.shape
@@ -2130,21 +2131,24 @@ def get_volume_histogram(
     sid: str,
     dim_x: int,
     dim_y: int,
-    scroll_dim: int,
+    scroll_dim: int = -1,
+    scroll_dims: str = "",
     fixed_indices: str = "",
     complex_mode: int = 0,
     bins: int = 64,
     session: "Session" = Depends(get_session_or_404),
 ):
-    """Return a histogram sampled across the scroll dimension.
+    """Return a histogram sampled across one or more aggregation dims.
 
-    Subsamples up to 16 evenly-spaced slices along *scroll_dim*, merges
-    their pixel data, and returns a single histogram.  The result is
-    cached on the session so repeated requests are instant.
+    *scroll_dims* is a comma-separated list of dim indices to aggregate
+    over (in addition to *dim_x* / *dim_y*).  When unset, falls back to
+    the legacy single *scroll_dim* param.  The sampler enumerates index
+    combinations across all aggregation dims but caps total samples at
+    ~16 via stride-subsampling.
 
     *fixed_indices* is a comma-separated list of ``dim:idx`` pairs that
-    pin non-display, non-scroll dimensions (e.g. ``"3:0"`` to select the
-    first parameter map in qMRI mode).
+    pin non-display, non-aggregation dimensions (e.g. ``"3:0"`` to
+    select the first parameter map in qMRI mode).
     """
 
     # Parse fixed indices
@@ -2155,27 +2159,59 @@ def get_volume_histogram(
                 d, v = pair.split(":", 1)
                 fixed[int(d)] = int(v)
 
+    # Resolve aggregation dims: prefer scroll_dims, fall back to scroll_dim.
+    agg_dims: list[int] = []
+    if scroll_dims:
+        for tok in scroll_dims.split(","):
+            tok = tok.strip()
+            if not tok:
+                continue
+            try:
+                d = int(tok)
+            except ValueError:
+                continue
+            if 0 <= d < len(session.shape) and d != dim_x and d != dim_y and d not in agg_dims:
+                agg_dims.append(d)
+    if not agg_dims and scroll_dim >= 0 and scroll_dim != dim_x and scroll_dim != dim_y:
+        agg_dims = [scroll_dim]
+
     # Check cache
-    cache_key = (dim_x, dim_y, scroll_dim, tuple(sorted(fixed.items())), complex_mode)
+    cache_key = (dim_x, dim_y, tuple(agg_dims), tuple(sorted(fixed.items())), complex_mode)
     if not hasattr(session, "_volume_hist_cache"):
         session._volume_hist_cache = {}
     cached = session._volume_hist_cache.get(cache_key)
     if cached is not None and cached.get("_data_version") == session.data_version:
         return cached["result"]
 
-    # Sample slices along scroll_dim
-    n = session.shape[scroll_dim]
+    # Build sample index lists per aggregation dim, stride-subsampled so
+    # their Cartesian product stays around ~16 samples total.
     max_samples = 16
-    if n <= max_samples:
-        sample_indices = list(range(n))
+    if not agg_dims:
+        # No aggregation dims — use the current middle slice only.
+        sample_combos = [tuple()]
     else:
-        step = n / max_samples
-        sample_indices = [int(i * step) for i in range(max_samples)]
+        per_dim_counts = [session.shape[d] for d in agg_dims]
+        # Target roughly equal sample count per dim so the product ≈ max_samples.
+        # Ceil to avoid zero; clamp to dim size.
+        k = len(agg_dims)
+        per_dim_target = max(1, int(round(max_samples ** (1.0 / k))))
+        sample_per_dim: list[list[int]] = []
+        for n in per_dim_counts:
+            m = min(n, per_dim_target)
+            if n <= m:
+                sample_per_dim.append(list(range(n)))
+            else:
+                step = n / m
+                sample_per_dim.append([int(i * step) for i in range(m)])
+        # Cartesian product with a hard cap.
+        import itertools as _it
+        sample_combos = list(_it.islice(_it.product(*sample_per_dim), max_samples))
 
     pixels = []
-    for si in sample_indices:
+    for combo in sample_combos:
         idx_list = [s // 2 for s in session.shape]
-        idx_list[scroll_dim] = si
+        for d, si in zip(agg_dims, combo):
+            idx_list[d] = si
         for d, v in fixed.items():
             idx_list[d] = v
         raw = extract_slice(session, dim_x, dim_y, idx_list)
@@ -2333,34 +2369,19 @@ def get_lebesgue_slice(
     )
 
 
-@app.get("/export_slice/{sid}")
-def export_slice(
+@app.get("/export_array/{sid}")
+def export_array(
     sid: str,
-    dim_x: int,
-    dim_y: int,
-    indices: str,
-    complex_mode: int = 0,
     save_to_downloads: int = 0,
     session: "Session" = Depends(get_session_or_404),
 ):
-    """Return the current 2-D slice as a downloadable .npy file.
-
-    The slice is the raw floating-point data (before colormap/LUT), with the
-    complex mode applied (mag/phase/real/imag). Used by the N-key shortcut.
-
-    When save_to_downloads=1 (PyWebView), saves the file directly to ~/Downloads
-    instead of returning it as a download response.
-    """
-    idx_tuple = tuple(int(v) for v in indices.split(","))
-    raw = extract_slice(session, dim_x, dim_y, list(idx_tuple))
-    data = apply_complex_mode(raw, complex_mode)
+    """Return the full N-D array as a downloadable .npy file (raw data, no transforms)."""
+    data = np.asarray(session.data)
     buf = io.BytesIO()
     np.save(buf, data)
     buf.seek(0)
-    # Build a suggested filename: sessionname_dim_x_dim_y_idx.npy
-    name_stem = (session.name or "slice").replace(" ", "_").replace("/", "_")
-    idx_str = "_".join(str(v) for v in idx_tuple)
-    filename = f"{name_stem}_x{dim_x}_y{dim_y}_{idx_str}.npy"
+    name_stem = (session.name or "array").replace(" ", "_").replace("/", "_")
+    filename = f"{name_stem}.npy"
     if save_to_downloads:
         import pathlib
         downloads = pathlib.Path.home() / "Downloads"
@@ -4236,6 +4257,8 @@ def get_ui(sid: str = None):
     _theme_names = ["dark", "light", "solarized", "nord"]
     _cfg_theme = get_viewer_theme()
     _default_theme_idx = _theme_names.index(_cfg_theme) if _cfg_theme in _theme_names else 0
+    _cfg_rounded = get_viewer_rounded_panes()
+    _default_rounded_panes = "true" if _cfg_rounded else "false"
     html = (
         _VIEWER_HTML_TEMPLATE.replace("__COLORMAPS__", str(_active_colormaps))
         .replace("__COLORMAP_GRADIENT_STOPS__", json.dumps(COLORMAP_GRADIENT_STOPS))
@@ -4243,6 +4266,7 @@ def get_ui(sid: str = None):
         .replace("__REAL_MODES__", str(REAL_MODES))
         .replace("__ARRAYVIEW_QUERY__", query_val)
         .replace("__DEFAULT_THEME_IDX__", str(_default_theme_idx))
+        .replace("__DEFAULT_ROUNDED_PANES__", _default_rounded_panes)
         .replace("__BODY_CLASS__", "av-loading" if sid else "")
     )
     headers = {"Cache-Control": "no-store"}