figrecipe 0.7.4__py3-none-any.whl → 0.9.0__py3-none-any.whl

figrecipe/_editor/_templates/_styles/_preview.py

@@ -18,22 +18,102 @@ STYLES_PREVIEW = """
     flex-direction: column;
     border-right: 1px solid var(--border-color);
     min-width: 400px;
+    max-width: none;
+    width: auto;
+    order: 0;  /* Default order when expanded */
+    transition: flex 0.2s ease-out, min-width 0.2s ease-out, width 0.2s ease-out, order 0s;
+    position: relative;
+}
+
+/* Collapsed preview panel - collapses to RIGHT side */
+.preview-panel.collapsed {
+    flex: 0 0 42px !important;
+    min-width: 42px !important;
+    max-width: 42px !important;
+    width: 42px !important;
+    order: 10;  /* Move to end (after data panel expands) */
+}
+
+/* When canvas collapses, data panel expands to fill space */
+.editor-container:has(.preview-panel.collapsed) .datatable-panel {
+    flex: 1 !important;
+    max-width: none !important;
+    width: auto !important;
+}
+
+.preview-panel.collapsed .preview-wrapper,
+.preview-panel.collapsed .preview-controls,
+.preview-panel.collapsed .scitex-branding,
+.preview-panel.collapsed #server-start-time {
+    display: none;
+}
+
+.preview-panel.collapsed .preview-header {
+    flex-direction: column;
+    justify-content: flex-start;
+    padding: 12px 8px;
+    height: 100%;
+}
+
+/* Flip button to point right (expand direction) when collapsed */
+.preview-panel.collapsed .btn-collapse {
+    transform: rotate(180deg);
 }
 
 .preview-header {
     display: flex;
     justify-content: space-between;
     align-items: center;
-    padding: 12px 16px;
-    background: var(--bg-secondary);
+    padding: 0 12px;
+    height: var(--panel-header-height);
+    min-height: var(--panel-header-height);
+    background: var(--panel-header-bg);
     border-bottom: 1px solid var(--border-color);
 }
 
+/* Preview header collapse button */
+.preview-header .btn-collapse {
+    width: 28px;
+    height: 28px;
+    padding: 0;
+    border: none;
+    background: transparent;
+    color: var(--text-secondary);
+    cursor: pointer;
+    font-size: 14px;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    border-radius: 4px;
+    transition: all 0.2s;
+    flex-shrink: 0;
+    margin-right: 8px;
+}
+
+.preview-header .btn-collapse:hover {
+    background: var(--bg-tertiary);
+    color: var(--text-primary);
+}
+
 .preview-header h2 {
     font-size: 16px;
     font-weight: 600;
 }
 
+/* Panel label for CANVAS */
+.preview-header .panel-label {
+    font-size: 11px;
+    font-weight: 600;
+    text-transform: uppercase;
+    letter-spacing: 0.5px;
+    color: var(--text-secondary);
+    margin-right: auto;
+}
+
+.preview-panel.collapsed .panel-label {
+    display: none;
+}
+
 /* SciTeX branding */
 .scitex-branding {
     display: flex;
@@ -146,18 +226,42 @@ STYLES_PREVIEW = """
     justify-content: center;
 }
 
-.zoom-controls #zoom-level {
-    min-width: 45px;
-    text-align: center;
+/* Text buttons in zoom controls need smaller font */
+.zoom-controls #btn-zoom-fit {
+    width: auto;
+    padding: 0 8px;
     font-size: 12px;
-    font-weight: 500;
+}
+
+/* Zoom dropdown select */
+.zoom-controls select {
+    height: 28px;
+    padding: 0 8px;
+    font-size: 12px;
+    border: 1px solid var(--border-color);
+    border-radius: 4px;
+    background: var(--bg-primary);
+    color: var(--text-primary);
+    cursor: pointer;
+}
+
+.zoom-controls select:hover {
+    border-color: var(--accent-color);
+}
+
+/* Toolbar separator */
+.toolbar-separator {
+    width: 1px;
+    height: 24px;
+    background: var(--border-color);
+    margin: 0 4px;
 }
 
 .preview-wrapper {
     flex: 1;
     display: flex;
-    align-items: center;
-    justify-content: center;
+    align-items: flex-start;
+    justify-content: flex-start;
     padding: 20px;
     background: var(--bg-tertiary);
     position: relative;
@@ -218,6 +322,107 @@ STYLES_PREVIEW = """
 .preview-wrapper.panning * {
     cursor: grabbing !important;
 }
+
+/* Welcome Overlay - covers the entire preview area */
+.welcome-overlay {
+    position: absolute;
+    top: 0;
+    left: 0;
+    right: 0;
+    bottom: 0;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    z-index: 100;
+    pointer-events: none;
+    background: var(--bg-tertiary);
+}
+
+.welcome-content {
+    background: var(--bg-secondary);
+    border: 1px solid var(--border-color);
+    border-radius: 12px;
+    padding: 32px 40px;
+    text-align: center;
+    box-shadow: 0 8px 32px rgba(0, 0, 0, 0.2);
+    max-width: 360px;
+}
+
+.welcome-content h2 {
+    margin: 0 0 24px 0;
+    font-size: 20px;
+    font-weight: 600;
+    color: var(--text-primary);
+}
+
+.welcome-steps {
+    display: flex;
+    flex-direction: column;
+    gap: 16px;
+    text-align: left;
+}
+
+.welcome-step {
+    display: flex;
+    align-items: center;
+    gap: 12px;
+}
+
+.step-number {
+    width: 28px;
+    height: 28px;
+    background: var(--accent-color);
+    color: white;
+    border-radius: 50%;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    font-size: 14px;
+    font-weight: 600;
+    flex-shrink: 0;
+}
+
+.step-text {
+    color: var(--text-secondary);
+    font-size: 14px;
+    line-height: 1.4;
+}
+
+.step-text strong {
+    color: var(--text-primary);
+}
+
+.welcome-hint {
+    margin: 20px 0 0 0;
+    padding-top: 16px;
+    border-top: 1px solid var(--border-color);
+    color: var(--text-tertiary);
+    font-size: 13px;
+}
+
+/* Caption Pane (below canvas) */
+.caption-pane {
+    padding: 10px 20px;
+    background: var(--bg-secondary);
+    border-top: 1px solid var(--border-color);
+    font-size: 13px;
+    line-height: 1.5;
+    color: var(--text-primary);
+    min-height: 32px;
+}
+
+.caption-pane b {
+    font-weight: 600;
+}
+
+.caption-pane .panel-caption {
+    color: var(--text-secondary);
+}
+
+/* Hide caption pane when canvas collapsed */
+.preview-panel.collapsed .caption-pane {
+    display: none;
+}
 """
 
 __all__ = ["STYLES_PREVIEW"]

figrecipe/_editor/_templates/_styles/_spinner.py

@@ -0,0 +1,117 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""Spinner/loading indicator styles for the figure editor."""
+
+STYLES_SPINNER = """
+/* ==================== SPINNER/LOADING OVERLAY ==================== */
+
+/* Spinner overlay container */
+.spinner-overlay {
+    position: fixed;
+    top: 0;
+    left: 0;
+    right: 0;
+    bottom: 0;
+    background: rgba(0, 0, 0, 0.4);
+    display: none;
+    justify-content: center;
+    align-items: center;
+    z-index: 10000;
+    backdrop-filter: blur(2px);
+}
+
+/* Show spinner when body has loading class */
+body.loading .spinner-overlay {
+    display: flex;
+}
+
+/* Spinner container */
+.spinner-container {
+    display: flex;
+    flex-direction: column;
+    align-items: center;
+    gap: 12px;
+}
+
+/* The spinner itself */
+.spinner {
+    width: 48px;
+    height: 48px;
+    border: 4px solid rgba(255, 255, 255, 0.2);
+    border-top-color: var(--accent-color, #2563eb);
+    border-radius: 50%;
+    animation: spinner-rotate 0.8s linear infinite;
+}
+
+/* Spinner animation */
+@keyframes spinner-rotate {
+    from {
+        transform: rotate(0deg);
+    }
+    to {
+        transform: rotate(360deg);
+    }
+}
+
+/* Loading text */
+.spinner-text {
+    color: white;
+    font-size: 14px;
+    font-weight: 500;
+    text-shadow: 0 1px 2px rgba(0, 0, 0, 0.5);
+}
+
+/* Dark mode adjustments */
+[data-theme="dark"] .spinner-overlay {
+    background: rgba(0, 0, 0, 0.6);
+}
+
+[data-theme="dark"] .spinner {
+    border-color: rgba(255, 255, 255, 0.1);
+    border-top-color: var(--accent-color, #3b82f6);
+}
+
+/* Mini spinner for inline use */
+.spinner-mini {
+    width: 16px;
+    height: 16px;
+    border-width: 2px;
+    display: inline-block;
+    vertical-align: middle;
+    margin-right: 6px;
+}
+
+/* Button loading state */
+button.btn-loading {
+    position: relative;
+    color: transparent !important;
+}
+
+button.btn-loading::after {
+    content: '';
+    position: absolute;
+    top: 50%;
+    left: 50%;
+    width: 16px;
+    height: 16px;
+    margin: -8px 0 0 -8px;
+    border: 2px solid rgba(255, 255, 255, 0.3);
+    border-top-color: white;
+    border-radius: 50%;
+    animation: spinner-rotate 0.8s linear infinite;
+}
+
+/* Loading state - keep existing behavior but remove pointer events */
+body.loading {
+    pointer-events: none;
+}
+
+/* Keep controls interactive even when loading */
+body.loading .spinner-overlay {
+    pointer-events: auto;
+}
+"""
+
+__all__ = ["STYLES_SPINNER"]
+
+# EOF

figrecipe/_integrations/__init__.py

@@ -0,0 +1,17 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""Integrations with external packages."""
+
+from ._scitex_stats import (
+    SCITEX_STATS_AVAILABLE,
+    annotate_from_stats,
+    from_scitex_stats,
+    load_stats_bundle,
+)
+
+__all__ = [
+    "SCITEX_STATS_AVAILABLE",
+    "annotate_from_stats",
+    "from_scitex_stats",
+    "load_stats_bundle",
+]

figrecipe/_integrations/_scitex_stats.py

@@ -0,0 +1,298 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""Integration with scitex.stats for statistical results."""
+
+from pathlib import Path
+from typing import Any, Dict, List, Optional, Union
+
+# Check if scitex.stats is available
+try:
+    from scitex import stats as scitex_stats
+
+    SCITEX_STATS_AVAILABLE = True
+except ImportError:
+    scitex_stats = None
+    SCITEX_STATS_AVAILABLE = False
+
+
+def from_scitex_stats(
+    stats_result: Union[Dict[str, Any], List[Dict[str, Any]]],
+) -> Dict[str, Any]:
+    """Convert scitex.stats result(s) to figrecipe stats format.
+
+    Parameters
+    ----------
+    stats_result : dict or list of dict
+        Statistical result(s) from scitex.stats. Supports:
+        - Single comparison dict
+        - List of comparison dicts
+        - scitex.stats flat format: {name, method, p_value, effect_size, ci95}
+        - scitex.stats nested format: {method: {name}, results: {p_value}}
+
+    Returns
+    -------
+    dict
+        Figrecipe-compatible stats dict with 'comparisons' list.
+
+    Examples
+    --------
+    >>> from scitex import stats
+    >>> result = stats.ttest_ind(x, y)
+    >>> fr_stats = from_scitex_stats(result)
+    >>> fig.set_stats(fr_stats)
+
+    >>> # Or for multiple comparisons
+    >>> results = [stats.ttest_ind(a, b), stats.ttest_ind(a, c)]
+    >>> fr_stats = from_scitex_stats(results)
+    """
+    # Normalize to list
+    if isinstance(stats_result, dict):
+        results = [stats_result]
+    else:
+        results = list(stats_result)
+
+    comparisons = []
+    for result in results:
+        comp = _convert_single_result(result)
+        if comp:
+            comparisons.append(comp)
+
+    return {"comparisons": comparisons}
+
+
+def _convert_single_result(result: Dict[str, Any]) -> Dict[str, Any]:
+    """Convert a single scitex.stats result to figrecipe format."""
+    # Handle flat format (legacy or from load_statsz)
+    if "p_value" in result and "results" not in result:
+        return _convert_flat_format(result)
+
+    # Handle nested format (from test functions)
+    if "results" in result:
+        return _convert_nested_format(result)
+
+    # Handle already-converted format
+    if "comparisons" in result:
+        # Already in figrecipe format, return first comparison
+        comps = result.get("comparisons", [])
+        return comps[0] if comps else {}
+
+    return {}
+
+
+def _convert_flat_format(result: Dict[str, Any]) -> Dict[str, Any]:
+    """Convert flat scitex.stats format."""
+    p_value = result.get("p_value")
+    stars = result.get("formatted") or result.get("stars")
+    if not stars and p_value is not None:
+        stars = _p_to_stars(p_value)
+
+    comp = {
+        "name": result.get("name", "comparison"),
+        "p_value": p_value,
+        "stars": stars,
+        "method": result.get("method", ""),
+    }
+
+    # Handle effect size
+    es = result.get("effect_size")
+    if es is not None:
+        ci = result.get("ci95", [])
+        if isinstance(es, (int, float)):
+            comp["effect_size"] = {
+                "name": "d",
+                "value": float(es),
+            }
+            if len(ci) >= 2:
+                comp["effect_size"]["ci_lower"] = ci[0]
+                comp["effect_size"]["ci_upper"] = ci[1]
+        elif isinstance(es, dict):
+            comp["effect_size"] = es
+
+    return comp
+
+
+def _convert_nested_format(result: Dict[str, Any]) -> Dict[str, Any]:
+    """Convert nested scitex.stats format."""
+    method_data = result.get("method", {})
+    results_data = result.get("results", {})
+
+    method_name = (
+        method_data.get("name", "")
+        if isinstance(method_data, dict)
+        else str(method_data)
+    )
+    p_value = results_data.get("p_value")
+    stars = _p_to_stars(p_value) if p_value is not None else ""
+
+    comp = {
+        "name": result.get("name", "comparison"),
+        "p_value": p_value,
+        "stars": stars,
+        "method": method_name,
+    }
+
+    # Handle effect size from results
+    es_data = results_data.get("effect_size")
+    if es_data:
+        if isinstance(es_data, dict):
+            comp["effect_size"] = es_data
+        else:
+            comp["effect_size"] = {"name": "d", "value": float(es_data)}
+
+    return comp
+
+
+def _p_to_stars(p_value: float, ns_symbol: bool = True) -> str:
+    """Convert p-value to significance stars."""
+    if p_value < 0.001:
+        return "***"
+    elif p_value < 0.01:
+        return "**"
+    elif p_value < 0.05:
+        return "*"
+    return "ns" if ns_symbol else ""
+
+
+def load_stats_bundle(path: Union[str, Path]) -> Dict[str, Any]:
+    """Load stats from a scitex.stats bundle file.
+
+    Parameters
+    ----------
+    path : str or Path
+        Path to .statsz or .zip bundle file.
+
+    Returns
+    -------
+    dict
+        Figrecipe-compatible stats dict.
+
+    Raises
+    ------
+    ImportError
+        If scitex.stats is not installed.
+    """
+    if not SCITEX_STATS_AVAILABLE:
+        raise ImportError(
+            "scitex.stats is required for bundle loading. "
+            "Install with: pip install scitex[stats]"
+        )
+
+    data = scitex_stats.load_statsz(path)
+    comparisons = data.get("comparisons", [])
+
+    # Convert each comparison
+    return from_scitex_stats(comparisons)
+
+
+def annotate_from_stats(
+    ax,
+    stats: Dict[str, Any],
+    positions: Optional[Dict[str, float]] = None,
+    style: str = "stars",
+    **kwargs,
+) -> List[Any]:
+    """Add stat annotations to axes from stats dict.
+
+    Parameters
+    ----------
+    ax : RecordingAxes
+        The axes to annotate.
+    stats : dict
+        Stats dict with 'comparisons' list. Each comparison should have:
+        - name: "Group A vs Group B" (parsed for group names)
+        - p_value: float
+        - Optional: groups: ["Group A", "Group B"]
+    positions : dict, optional
+        Mapping of group names to x positions. If None, uses 0, 1, 2, ...
+    style : str
+        Annotation style: "stars", "p_value", "both".
+    **kwargs
+        Additional arguments passed to add_stat_annotation().
+
+    Returns
+    -------
+    list
+        List of artist objects created.
+
+    Examples
+    --------
+    >>> stats = from_scitex_stats(result)
+    >>> annotate_from_stats(ax, stats, positions={"Control": 0, "Treatment": 1})
+    """
+    comparisons = stats.get("comparisons", [])
+    if not comparisons:
+        return []
+
+    artists = []
+    y_offset = 0
+
+    for comp in comparisons:
+        # Get positions for this comparison
+        x1, x2 = _get_comparison_positions(comp, positions)
+        if x1 is None or x2 is None:
+            continue
+
+        # Calculate y position (stack annotations)
+        y = kwargs.pop("y", None)
+        if y is None:
+            # Auto-calculate based on data
+            ylim = ax.get_ylim() if hasattr(ax, "get_ylim") else (0, 1)
+            y = ylim[1] + (ylim[1] - ylim[0]) * 0.05 * (1 + y_offset)
+            y_offset += 1
+
+        # Add annotation
+        result = ax.add_stat_annotation(
+            x1,
+            x2,
+            p_value=comp.get("p_value"),
+            text=comp.get("stars") if style == "stars" else None,
+            y=y,
+            style=style,
+            id=comp.get("name", "").replace(" ", "_"),
+            **kwargs,
+        )
+        artists.extend(result if isinstance(result, list) else [result])
+
+    return artists
+
+
+def _get_comparison_positions(
+    comp: Dict[str, Any],
+    positions: Optional[Dict[str, float]],
+) -> tuple:
+    """Extract x positions for a comparison."""
+    # Try explicit groups
+    groups = comp.get("groups", [])
+    if len(groups) >= 2 and positions:
+        x1 = positions.get(groups[0])
+        x2 = positions.get(groups[1])
+        if x1 is not None and x2 is not None:
+            return x1, x2
+
+    # Try parsing from name (e.g., "Control vs Treatment")
+    name = comp.get("name", "")
+    if " vs " in name:
+        parts = name.split(" vs ")
+        if len(parts) >= 2 and positions:
+            x1 = positions.get(parts[0].strip())
+            x2 = positions.get(parts[1].strip())
+            if x1 is not None and x2 is not None:
+                return x1, x2
+
+    # Try x1, x2 directly in comparison
+    if "x1" in comp and "x2" in comp:
+        return comp["x1"], comp["x2"]
+
+    # Default to sequential positions
+    if positions is None:
+        return 0, 1
+
+    return None, None
+
+
+__all__ = [
+    "SCITEX_STATS_AVAILABLE",
+    "from_scitex_stats",
+    "load_stats_bundle",
+    "annotate_from_stats",
+]

figrecipe/_params/_DECORATION_METHODS.py

@@ -28,6 +28,8 @@ DECORATION_METHODS = {
     "set_xticklabels",
     "set_yticklabels",
     "tick_params",
+    # Statistical annotations
+    "stat_annotation",  # Comparison brackets with stars/p-values
 }
 
 # EOF