scitex 2.5.0__py3-none-any.whl → 2.7.0__py3-none-any.whl

scitex/vis/editor/flask_editor/templates/{styles.py → _styles.py}

@@ -3,7 +3,7 @@
 # File: ./src/scitex/vis/editor/flask_editor/templates/styles.py
 """CSS styles for the Flask editor UI."""
 
-CSS_STYLES = '''
+CSS_STYLES = """
 /* =============================================================================
  * SciTeX Color System - Based on scitex-cloud/static/shared/css
  * ============================================================================= */
@@ -188,6 +188,99 @@ body {
     pointer-events: none;
 }
 
+.hover-scatter {
+    fill: rgba(100, 180, 255, 0.7);
+    stroke: rgba(100, 180, 255, 0.9);
+    stroke-width: 1;
+    pointer-events: none;
+}
+
+.selected-scatter {
+    fill: rgba(255, 200, 80, 0.7);
+    stroke: rgba(255, 200, 80, 0.9);
+    stroke-width: 2;
+    pointer-events: none;
+}
+
+/* =============================================================================
+ * Selected Element Panel
+ * ============================================================================= */
+#section-selected {
+    border: 2px solid var(--accent-muted);
+    background: var(--bg-secondary);
+}
+
+#section-selected .section-header {
+    background: var(--accent-muted);
+    color: var(--text-primary);
+    font-weight: 600;
+}
+
+.selected-info {
+    display: flex;
+    align-items: center;
+    gap: 10px;
+    margin-bottom: 12px;
+    padding: 8px;
+    background: var(--bg-primary);
+    border-radius: 4px;
+}
+
+.element-type-badge {
+    padding: 4px 10px;
+    border-radius: 12px;
+    font-size: 11px;
+    font-weight: 600;
+    text-transform: uppercase;
+}
+
+.element-type-badge.trace { background: #3498db; color: white; }
+.element-type-badge.scatter { background: #e74c3c; color: white; }
+.element-type-badge.fill { background: #9b59b6; color: white; }
+.element-type-badge.bar { background: #f39c12; color: white; }
+.element-type-badge.label { background: #2ecc71; color: white; }
+.element-type-badge.panel { background: #34495e; color: white; }
+.element-type-badge.legend { background: #1abc9c; color: white; }
+
+.element-axis-info {
+    font-size: 12px;
+    color: var(--text-secondary);
+}
+
+.element-props {
+    border-top: 1px solid var(--border-color);
+    padding-top: 12px;
+    margin-top: 8px;
+}
+
+/* Range slider styling */
+input[type="range"] {
+    width: 100%;
+    height: 6px;
+    border-radius: 3px;
+    background: var(--bg-tertiary);
+    outline: none;
+    -webkit-appearance: none;
+}
+
+input[type="range"]::-webkit-slider-thumb {
+    -webkit-appearance: none;
+    width: 16px;
+    height: 16px;
+    border-radius: 50%;
+    background: var(--accent);
+    cursor: pointer;
+}
+
+input[type="range"]::-moz-range-thumb {
+    width: 16px;
+    height: 16px;
+    border-radius: 50%;
+    background: var(--accent);
+    cursor: pointer;
+    border: none;
+}
+
 /* =============================================================================
  * Controls Panel
  * ============================================================================= */
@@ -470,6 +563,103 @@ body {
     background: var(--color-cta-hover);
 }
 
+/* =============================================================================
+ * Unit Toggle
+ * ============================================================================= */
+.unit-toggle {
+    display: flex;
+    gap: 0;
+    border-radius: 4px;
+    overflow: hidden;
+    border: 1px solid var(--border-default);
+}
+
+.unit-btn {
+    padding: 4px 12px;
+    font-size: 0.8em;
+    font-weight: 500;
+    border: none;
+    background: var(--bg-muted);
+    color: var(--text-muted);
+    cursor: pointer;
+    transition: all 0.15s;
+}
+
+.unit-btn:first-child {
+    border-right: 1px solid var(--border-default);
+}
+
+.unit-btn:hover {
+    background: var(--bg-surface);
+    color: var(--text-secondary);
+}
+
+.unit-btn.active {
+    background: var(--color-cta);
+    color: white;
+}
+
+/* =============================================================================
+ * Background Type Toggle
+ * ============================================================================= */
+.bg-toggle {
+    display: flex;
+    gap: 6px;
+}
+
+.bg-btn {
+    display: flex;
+    flex-direction: column;
+    align-items: center;
+    gap: 4px;
+    padding: 6px 10px;
+    font-size: 0.75em;
+    border: 1px solid var(--border-default);
+    border-radius: 4px;
+    background: var(--bg-muted);
+    color: var(--text-muted);
+    cursor: pointer;
+    transition: all 0.15s;
+    flex: 1;
+}
+
+.bg-btn:hover {
+    background: var(--bg-surface);
+    color: var(--text-secondary);
+}
+
+.bg-btn.active {
+    border-color: var(--color-cta);
+    background: var(--bg-surface);
+    color: var(--text-primary);
+    box-shadow: 0 0 0 1px var(--color-cta);
+}
+
+.bg-preview {
+    width: 20px;
+    height: 14px;
+    border-radius: 2px;
+    border: 1px solid var(--border-default);
+}
+
+.bg-preview.white {
+    background: #ffffff;
+}
+
+.bg-preview.transparent {
+    background: linear-gradient(45deg, #ccc 25%, transparent 25%),
+                linear-gradient(-45deg, #ccc 25%, transparent 25%),
+                linear-gradient(45deg, transparent 75%, #ccc 75%),
+                linear-gradient(-45deg, transparent 75%, #ccc 75%);
+    background-size: 8px 8px;
+    background-position: 0 0, 0 4px, 4px -4px, -4px 0px;
+    background-color: #fff;
+}
+
+.bg-preview.black {
+    background: #000000;
+}
+
 /* =============================================================================
  * Status Bar
  * ============================================================================= */
@@ -543,7 +733,7 @@ body {
 .annotations-list::-webkit-scrollbar-thumb:hover {
     background: var(--text-muted);
 }
-'''
+"""
 
 
 # EOF

scitex/vis/io/__init__.py

@@ -18,7 +18,7 @@ The .canvas extension makes directories self-documenting, portable, and detectab
 Schema Version: 2.0.0
 """
 
-from .directory import (
+from ._directory import (
     SCHEMA_VERSION,
     CANVAS_EXTENSION,
     ensure_canvas_directory,
@@ -28,14 +28,14 @@ from .directory import (
     canvas_directory_exists,
 )
 
-from .canvas import (
+from ._canvas import (
     save_canvas_json,
     load_canvas_json,
     update_canvas_json,
     get_canvas_schema_version,
 )
 
-from .panel import (
+from ._panel import (
     add_panel_from_scitex,
     add_panel_from_image,
     remove_panel,
@@ -45,7 +45,7 @@ from .panel import (
     reorder_panels,
 )
 
-from .data import (
+from ._data import (
     HashMismatchError,
     compute_file_hash,
     verify_data_hash,
@@ -54,7 +54,7 @@ from .data import (
     list_data_files,
 )
 
-from .export import (
+from ._export import (
     export_canvas_to_file,
     export_canvas_to_multiple_formats,
     list_canvas_exports,

scitex/vis/io/{canvas.py → _canvas.py}

@@ -13,7 +13,7 @@ from typing import Dict, Any, Union, Optional
 from datetime import datetime
 import json
 
-from .directory import get_canvas_directory_path, SCHEMA_VERSION
+from ._directory import get_canvas_directory_path, SCHEMA_VERSION
 
 
 def _get_empty_canvas_template(canvas_name: str) -> Dict[str, Any]:
@@ -144,11 +144,13 @@ def load_canvas_json(
 
     # Verify data hashes if requested
     if verify_data_hashes and canvas_json.get("data_files"):
-        from .data import verify_all_data_hashes
+        from ._data import verify_all_data_hashes
+
         hash_results = verify_all_data_hashes(project_dir, canvas_name)
         invalid_files = [f for f, valid in hash_results.items() if not valid]
         if invalid_files:
-            from .data import HashMismatchError
+            from ._data import HashMismatchError
+
             raise HashMismatchError(
                 f"Data file hash mismatch for: {', '.join(invalid_files)}"
             )
@@ -217,7 +219,9 @@ def get_canvas_schema_version(
         Schema version string or None if not found
     """
     try:
-        canvas_json = load_canvas_json(project_dir, canvas_name, verify_data_hashes=False)
+        canvas_json = load_canvas_json(
+            project_dir, canvas_name, verify_data_hashes=False
+        )
         return canvas_json.get("schema_version")
     except FileNotFoundError:
         return None

scitex/vis/io/{data.py → _data.py}

@@ -15,6 +15,7 @@ import hashlib
 
 class HashMismatchError(Exception):
     """Raised when a data file hash doesn't match expected value."""
+
     pass
 
 
@@ -92,8 +93,8 @@ def verify_all_data_hashes(
     Dict[str, bool]
         Dictionary mapping file paths to validation results
     """
-    from .directory import get_canvas_directory_path
-    from .canvas import load_canvas_json
+    from ._directory import get_canvas_directory_path
+    from ._canvas import load_canvas_json
 
     canvas_dir = get_canvas_directory_path(project_dir, canvas_name)
 
@@ -103,6 +104,7 @@ def verify_all_data_hashes(
         return {}
 
     import json
+
     with open(json_path, "r") as f:
         canvas_json = json.load(f)
 
@@ -140,8 +142,8 @@ def update_data_hash(
     str
         New hash value
     """
-    from .directory import get_canvas_directory_path
-    from .canvas import load_canvas_json, save_canvas_json
+    from ._directory import get_canvas_directory_path
+    from ._canvas import load_canvas_json, save_canvas_json
 
     canvas_dir = get_canvas_directory_path(project_dir, canvas_name)
     filepath = canvas_dir / rel_path
@@ -161,10 +163,12 @@ def update_data_hash(
     if not found:
         if "data_files" not in canvas_json:
             canvas_json["data_files"] = []
-        canvas_json["data_files"].append({
-            "path": rel_path,
-            "hash": new_hash,
-        })
+        canvas_json["data_files"].append(
+            {
+                "path": rel_path,
+                "hash": new_hash,
+            }
+        )
 
     save_canvas_json(project_dir, canvas_name, canvas_json)
 
@@ -190,7 +194,7 @@ def list_data_files(
     Dict[str, str]
         Dictionary mapping file paths to hash values
     """
-    from .canvas import load_canvas_json
+    from ._canvas import load_canvas_json
 
     canvas_json = load_canvas_json(project_dir, canvas_name, verify_data_hashes=False)
 

scitex/vis/io/{directory.py → _directory.py}

@@ -36,7 +36,7 @@ def _normalize_canvas_name(canvas_name: str) -> str:
 def _strip_canvas_extension(canvas_name: str) -> str:
     """Remove .canvas extension from canvas_name."""
     if canvas_name.endswith(CANVAS_EXTENSION):
-        return canvas_name[:-len(CANVAS_EXTENSION)]
+        return canvas_name[: -len(CANVAS_EXTENSION)]
     return canvas_name
 
 
@@ -75,8 +75,9 @@ def ensure_canvas_directory(
     # Create empty canvas.json if not exists
     json_path = canvas_dir / "canvas.json"
     if not json_path.exists():
-        from .canvas import _get_empty_canvas_template
+        from ._canvas import _get_empty_canvas_template
         import json
+
         # Use the name without extension for canvas_name in JSON
         base_name = _strip_canvas_extension(canvas_name)
         template = _get_empty_canvas_template(base_name)
@@ -137,9 +138,11 @@ def list_canvas_directories(
     # Find .canvas directories that contain canvas.json
     canvas_names = []
     for item in sorted(parent_dir.iterdir()):
-        if (item.is_dir()
+        if (
+            item.is_dir()
             and item.name.endswith(CANVAS_EXTENSION)
-            and (item / "canvas.json").exists()):
+            and (item / "canvas.json").exists()
+        ):
             if include_extension:
                 canvas_names.append(item.name)
             else:

scitex/vis/io/{export.py → _export.py}

@@ -42,8 +42,8 @@ def export_canvas_to_file(
     Path
         Path to exported file in exports/ directory
     """
-    from .directory import get_canvas_directory_path
-    from .canvas import load_canvas_json
+    from ._directory import get_canvas_directory_path
+    from ._canvas import load_canvas_json
 
     canvas_dir = get_canvas_directory_path(project_dir, canvas_name)
     canvas_json = load_canvas_json(project_dir, canvas_name, verify_data_hashes=False)
@@ -130,7 +130,7 @@ def list_canvas_exports(
     List[Path]
         List of paths in exports/ directory
     """
-    from .directory import get_canvas_directory_path
+    from ._directory import get_canvas_directory_path
 
     canvas_dir = get_canvas_directory_path(project_dir, canvas_name)
     exports_dir = canvas_dir / "exports"
@@ -179,10 +179,7 @@ def _compose_and_export(
         fig.patch.set_facecolor(bg_color)
 
     # Sort panels by z_index
-    panels = sorted(
-        canvas_json.get("panels", []),
-        key=lambda p: p.get("z_index", 0)
-    )
+    panels = sorted(canvas_json.get("panels", []), key=lambda p: p.get("z_index", 0))
 
     # Place each panel
     for panel in panels:
@@ -361,11 +358,14 @@ def _add_panel_label(ax, label: Dict[str, Any]) -> None:
     x, y, ha, va = pos_map.get(position, pos_map["top-left"])
 
     ax.text(
-        x, y, text,
+        x,
+        y,
+        text,
         transform=ax.transAxes,
         fontsize=fontsize,
         fontweight=fontweight,
-        ha=ha, va=va,
+        ha=ha,
+        va=va,
     )
 
 
@@ -385,7 +385,8 @@ def _add_annotations(
             y = 1 - pos.get("y_mm", 0) / canvas_height_mm
 
             fig.text(
-                x, y,
+                x,
+                y,
                 ann.get("content", ""),
                 fontsize=ann.get("fontsize", 10),
                 color=ann.get("color", "#000000"),
@@ -406,7 +407,8 @@ def _add_title(
     y = 1 - pos.get("y_mm", 5) / canvas_height_mm
 
     fig.text(
-        x, y,
+        x,
+        y,
         title_config.get("text", ""),
         fontsize=title_config.get("fontsize", 14),
         ha="center",
@@ -448,7 +450,8 @@ def _add_caption(
     wrapped_text = textwrap.fill(text, width=wrap_width)
 
     fig.text(
-        x, y_norm,
+        x,
+        y_norm,
         wrapped_text,
         fontsize=fontsize,
         ha="left",

scitex/vis/io/{load.py → _load.py}

@@ -47,7 +47,7 @@ def load_figure_json(
 
     # Validate if requested
     if validate:
-        from ..backend.parser import validate_figure_json
+        from ..backend._parser import validate_figure_json
 
         validate_figure_json(fig_json)
 

scitex/vis/io/{panel.py → _panel.py}

@@ -13,9 +13,9 @@ from pathlib import Path
 from typing import Dict, Any, Union, List, Optional
 import shutil
 
-from .directory import get_canvas_directory_path
-from .canvas import load_canvas_json, save_canvas_json
-from .data import compute_file_hash
+from ._directory import get_canvas_directory_path
+from ._canvas import load_canvas_json, save_canvas_json
+from ._data import compute_file_hash
 
 
 def _symlink_or_copy(source: Path, dest: Path, bundle: bool = False) -> None:
@@ -142,7 +142,9 @@ def add_panel_from_scitex(
     canvas_json = load_canvas_json(project_dir, canvas_name, verify_data_hashes=False)
 
     # Remove existing panel with same name
-    canvas_json["panels"] = [p for p in canvas_json["panels"] if p.get("name") != panel_name]
+    canvas_json["panels"] = [
+        p for p in canvas_json["panels"] if p.get("name") != panel_name
+    ]
 
     # Add new panel
     canvas_json["panels"].append(panel_entry)
@@ -153,13 +155,14 @@ def add_panel_from_scitex(
         csv_hash = compute_file_hash(panel_dir / "panel.csv")
         # Remove existing reference
         canvas_json["data_files"] = [
-            d for d in canvas_json.get("data_files", [])
-            if d.get("path") != csv_path
+            d for d in canvas_json.get("data_files", []) if d.get("path") != csv_path
         ]
-        canvas_json["data_files"].append({
-            "path": csv_path,
-            "hash": csv_hash,
-        })
+        canvas_json["data_files"].append(
+            {
+                "path": csv_path,
+                "hash": csv_hash,
+            }
+        )
 
     save_canvas_json(project_dir, canvas_name, canvas_json)
 
@@ -222,7 +225,9 @@ def add_panel_from_image(
     canvas_json = load_canvas_json(project_dir, canvas_name, verify_data_hashes=False)
 
     # Remove existing panel with same name
-    canvas_json["panels"] = [p for p in canvas_json["panels"] if p.get("name") != panel_name]
+    canvas_json["panels"] = [
+        p for p in canvas_json["panels"] if p.get("name") != panel_name
+    ]
 
     # Add new panel
     canvas_json["panels"].append(panel_entry)
@@ -261,11 +266,14 @@ def remove_panel(
     canvas_json = load_canvas_json(project_dir, canvas_name, verify_data_hashes=False)
 
     original_count = len(canvas_json["panels"])
-    canvas_json["panels"] = [p for p in canvas_json["panels"] if p.get("name") != panel_name]
+    canvas_json["panels"] = [
+        p for p in canvas_json["panels"] if p.get("name") != panel_name
+    ]
 
     # Remove data file references for this panel
     canvas_json["data_files"] = [
-        d for d in canvas_json.get("data_files", [])
+        d
+        for d in canvas_json.get("data_files", [])
         if not d.get("path", "").startswith(f"panels/{panel_name}/")
     ]
 

scitex/vis/model/__init__.py

@@ -8,12 +8,12 @@ This module provides dataclass-based models for representing
 publication-quality figures as JSON structures.
 """
 
-from .figure import FigureModel
-from .axes import AxesModel
-from .plot import PlotModel
-from .guides import GuideModel
-from .annotations import AnnotationModel
-from .styles import (
+from ._figure import FigureModel
+from ._axes import AxesModel
+from ._plot import PlotModel
+from ._guides import GuideModel
+from ._annotations import AnnotationModel
+from ._styles import (
     PlotStyle,
     AxesStyle,
     GuideStyle,
@@ -24,7 +24,7 @@ from .styles import (
     copy_text_style,
     apply_style_to_plots,
 )
-from .plot_types import (
+from ._plot_types import (
     # Registry
     PLOT_TYPE_CONFIGS,
     get_plot_config_class,

scitex/vis/model/{annotations.py → _annotations.py}

@@ -6,7 +6,7 @@
 from typing import Optional, Dict, Any, Tuple
 from dataclasses import dataclass, field, asdict
 
-from .styles import TextStyle
+from ._styles import TextStyle
 
 
 @dataclass
@@ -94,9 +94,7 @@ class AnnotationModel:
         # Type-specific validation
         if self.annotation_type in ["text", "annotate"]:
             if not self.text:
-                raise ValueError(
-                    f"{self.annotation_type} requires 'text' parameter"
-                )
+                raise ValueError(f"{self.annotation_type} requires 'text' parameter")
 
         if self.annotation_type == "annotate":
             if self.xytext is None:

scitex/vis/model/{axes.py → _axes.py}

@@ -6,7 +6,7 @@
 from typing import Optional, List, Dict, Any
 from dataclasses import dataclass, field, asdict
 
-from .styles import AxesStyle
+from ._styles import AxesStyle
 
 
 @dataclass

scitex/vis/model/{guides.py → _guides.py}

@@ -6,7 +6,7 @@
 from typing import Optional, List, Dict, Any
 from dataclasses import dataclass, field, asdict
 
-from .styles import GuideStyle
+from ._styles import GuideStyle
 
 
 @dataclass

scitex/vis/model/{plot.py → _plot.py}

@@ -6,7 +6,7 @@
 from typing import Optional, List, Dict, Any
 from dataclasses import dataclass, field, asdict
 
-from .styles import PlotStyle
+from ._styles import PlotStyle
 
 
 @dataclass
@@ -104,9 +104,7 @@ class PlotModel:
         # Type-specific validation
         if self.plot_type in ["heatmap", "imshow"]:
             if "z" not in self.data and "img" not in self.data:
-                raise ValueError(
-                    f"{self.plot_type} requires 'z' or 'img' in data"
-                )
+                raise ValueError(f"{self.plot_type} requires 'z' or 'img' in data")
 
         elif self.plot_type in ["line", "scatter", "errorbar"]:
             if "x" not in self.data or "y" not in self.data:

scitex/vis/utils/__init__.py

@@ -8,7 +8,7 @@ Includes validation functions and default templates for
 common publication formats.
 """
 
-from .validate import (
+from ._validate import (
     validate_json_structure,
     validate_plot_data,
     check_schema_version,
@@ -16,7 +16,7 @@ from .validate import (
     validate_axes_layout,
 )
 
-from .defaults import (
+from ._defaults import (
     # Constants
     NATURE_SINGLE_COLUMN_MM,
     NATURE_DOUBLE_COLUMN_MM,

scitex/vis/utils/{defaults.py → _defaults.py}

@@ -313,8 +313,7 @@ def get_template(name: str, **kwargs) -> Dict[str, Any]:
     """
     if name not in TEMPLATES:
         raise ValueError(
-            f"Unknown template: {name}. "
-            f"Available: {list(TEMPLATES.keys())}"
+            f"Unknown template: {name}. Available: {list(TEMPLATES.keys())}"
         )
 
     return TEMPLATES[name](**kwargs)