chore: release v0.3.0

Author: mnm-matin

CHANGELOG.md

@@ -0,0 +1,16 @@
+# Changelog
+
+## 0.3.0 - 2026-03-22
+
+### Features
+- Add PCA projection support for Euclidean, Poincare, and spherical visualization layouts.
+- Add 3D layout support for visualizations, including spherical views and 3D lasso selection.
+- Add Hugging Face ingestion controls for subset configs, streaming, and configurable shuffle buffers.
+
+### Improvements
+- Preserve stable source indices and requested sample tracking during Hugging Face ingestion.
+- Expand the demo workflow with ready-made Euclidean, Poincare, spherical, and PCA layouts.
+
+### Breaking Changes
+- Replace CLI `--geometry` with repeatable `--layout` flags such as `--layout euclidean`, `--layout poincare`, and `--layout spherical`.
+- Replace `Dataset.compute_visualization(geometry=...)` with `Dataset.compute_visualization(layout=...)`; bare `spherical` layouts now resolve to 3D.

README.md

@@ -17,7 +17,7 @@
 ## Features
 
 - **Dual-Panel UI**: Image grid + scatter plot with bidirectional selection
-- **Euclidean/Poincaré Toggle**: Switch between standard 2D UMAP and Poincaré disk visualization
+- **Multi-Layout Visualizations**: Explore Euclidean, Poincare, and spherical layouts in 2D or 3D with UMAP or PCA projections
 - **HuggingFace Integration**: Load datasets directly from HuggingFace Hub
 - **Fast Embeddings**: Uses EmbedAnything for CLIP-based image embeddings
 
@@ -48,14 +48,15 @@ hyperview \
   --label-key label \
   --samples 500 \
   --model openai/clip-vit-base-patch32 \
-  --geometry both
+  --layout euclidean \
+  --layout poincare
 ```
 
 This will:
 1. Use dataset `cifar10_demo`
 2. Load up to 500 samples from CIFAR-10
 3. Compute CLIP embeddings
-4. Generate Euclidean and Poincaré visualizations
+4. Generate Euclidean and Poincare visualizations
 5. Start the server at **http://127.0.0.1:6262**
 
 You can also launch with explicit dataset/model/projection args:
@@ -70,7 +71,7 @@ hyperview \
   --samples 1000 \
   --model openai/clip-vit-base-patch32 \
   --method umap \
-  --geometry euclidean
+  --layout euclidean
 ```
 
 ### Python API