scitex 2.15.4__py3-none-any.whl → 2.15.5__py3-none-any.whl

scitex/_mcp_tools/canvas.py

@@ -1,12 +1,20 @@
 #!/usr/bin/env python3
-# Timestamp: 2026-01-15
-# File: /home/ywatanabe/proj/scitex-code/src/scitex/_mcp_tools/canvas.py
-"""Canvas module tools for FastMCP unified server."""
+# Timestamp: 2026-01-29
+# File: src/scitex/_mcp_tools/canvas.py
+"""Canvas module tools for FastMCP unified server.
+
+.. deprecated:: 2.16.0
+    Canvas tools are deprecated. Use figrecipe MCP tools instead:
+    - plt_compose for multi-panel composition
+    - plt_plot for creating figures
+    - plt_reproduce for reproducing from recipes
+
+    figrecipe is mounted automatically if installed.
+"""
 
 from __future__ import annotations
 
 import json
-from typing import Optional
 
 
 def _json(data: dict) -> str:
@@ -14,8 +22,14 @@ def _json(data: dict) -> str:
 
 
 def register_canvas_tools(mcp) -> None:
-    """Register canvas tools with FastMCP server."""
+    """Register canvas tools with FastMCP server.
 
+    Note: These tools are deprecated. figrecipe is mounted for composition.
+    """
+    # Mount figrecipe MCP server if available (preferred)
+    _mount_figrecipe(mcp)
+
+    # Legacy canvas tools (deprecated, for backward compatibility)
     @mcp.tool()
     async def canvas_create_canvas(
         parent_dir: str,
@@ -23,7 +37,7 @@ def register_canvas_tools(mcp) -> None:
         width_mm: float = 180,
         height_mm: float = 120,
     ) -> str:
-        """[canvas] Create a new paper figure canvas workspace."""
+        """[canvas][DEPRECATED] Create a canvas workspace. Use plt_compose instead."""
         from scitex.canvas._mcp.handlers import create_canvas_handler
 
         result = await create_canvas_handler(
@@ -32,6 +46,7 @@ def register_canvas_tools(mcp) -> None:
             width_mm=width_mm,
             height_mm=height_mm,
         )
+        result["_deprecated"] = "Use plt_compose from figrecipe instead"
         return _json(result)
 
     @mcp.tool()
@@ -44,9 +59,9 @@ def register_canvas_tools(mcp) -> None:
         y_mm: float = 0,
         width_mm: float = 50,
         height_mm: float = 50,
-        label: Optional[str] = None,
+        label: str | None = None,
     ) -> str:
-        """[canvas] Add a panel to an existing canvas from an image or plot."""
+        """[canvas][DEPRECATED] Add a panel to canvas. Use plt_compose instead."""
         from scitex.canvas._mcp.handlers import add_panel_handler
 
         result = await add_panel_handler(
@@ -60,23 +75,25 @@ def register_canvas_tools(mcp) -> None:
             height_mm=height_mm,
             label=label,
         )
+        result["_deprecated"] = "Use plt_compose from figrecipe instead"
         return _json(result)
 
     @mcp.tool()
     async def canvas_list_panels(parent_dir: str, canvas_name: str) -> str:
-        """[canvas] List all panels in a canvas with their properties."""
+        """[canvas][DEPRECATED] List panels in a canvas."""
         from scitex.canvas._mcp.handlers import list_panels_handler
 
         result = await list_panels_handler(
             parent_dir=parent_dir, canvas_name=canvas_name
         )
+        result["_deprecated"] = "Use figrecipe instead"
         return _json(result)
 
     @mcp.tool()
     async def canvas_remove_panel(
         parent_dir: str, canvas_name: str, panel_name: str
     ) -> str:
-        """[canvas] Remove a panel from a canvas."""
+        """[canvas][DEPRECATED] Remove a panel from canvas."""
         from scitex.canvas._mcp.handlers import remove_panel_handler
 
         result = await remove_panel_handler(
@@ -84,17 +101,18 @@ def register_canvas_tools(mcp) -> None:
             canvas_name=canvas_name,
             panel_name=panel_name,
         )
+        result["_deprecated"] = "Use figrecipe instead"
         return _json(result)
 
     @mcp.tool()
     async def canvas_export_canvas(
         parent_dir: str,
         canvas_name: str,
-        output_path: Optional[str] = None,
-        format: Optional[str] = None,
+        output_path: str | None = None,
+        format: str | None = None,
         dpi: int = 300,
     ) -> str:
-        """[canvas] Export/render canvas to PNG, PDF, or SVG format."""
+        """[canvas][DEPRECATED] Export canvas to image. Use plt_compose instead."""
         from scitex.canvas._mcp.handlers import export_canvas_handler
 
         result = await export_canvas_handler(
@@ -104,25 +122,41 @@ def register_canvas_tools(mcp) -> None:
             format=format,
             dpi=dpi,
         )
+        result["_deprecated"] = "Use plt_compose from figrecipe instead"
         return _json(result)
 
     @mcp.tool()
     async def canvas_list_canvases(parent_dir: str) -> str:
-        """[canvas] List all canvases in a directory."""
+        """[canvas][DEPRECATED] List canvases in a directory."""
         from scitex.canvas._mcp.handlers import list_canvases_handler
 
         result = await list_canvases_handler(parent_dir=parent_dir)
+        result["_deprecated"] = "Use figrecipe instead"
         return _json(result)
 
     @mcp.tool()
     async def canvas_canvas_exists(parent_dir: str, canvas_name: str) -> str:
-        """[canvas] Check if a canvas exists."""
+        """[canvas][DEPRECATED] Check if a canvas exists."""
         from scitex.canvas._mcp.handlers import canvas_exists_handler
 
         result = await canvas_exists_handler(
             parent_dir=parent_dir, canvas_name=canvas_name
         )
+        result["_deprecated"] = "Use figrecipe instead"
         return _json(result)
 
 
+def _mount_figrecipe(mcp) -> None:
+    """Mount figrecipe MCP server for composition tools.
+
+    Provides: plt_plot, plt_compose, plt_reproduce, plt_info, etc.
+    """
+    try:
+        from figrecipe._mcp.server import mcp as figrecipe_mcp
+
+        mcp.mount(figrecipe_mcp, prefix="plt")
+    except ImportError:
+        pass  # figrecipe not installed
+
+
 # EOF

scitex/canvas/__init__.py

@@ -1,338 +1,220 @@
 #!/usr/bin/env python3
-# Timestamp: 2025-12-08
-# File: ./src/scitex/vis/__init__.py
+# Timestamp: 2026-01-29
+# File: src/scitex/canvas/__init__.py
 """
-SciTeX Visualization Module (scitex.canvas)
+SciTeX Canvas Module (DEPRECATED)
 
-Canvas-based composition of publication-quality figures.
+.. deprecated:: 2.16.0
+    This module is deprecated. Use figrecipe instead:
 
-Terminology:
-- Canvas: A paper figure workspace (e.g., "Figure 1" in publication)
-- Panel: A single component on canvas (stx.plt output or image)
-- Figure: Reserved for matplotlib's fig object (see scitex.plt)
+    - Interactive editor: ``figrecipe.edit()`` (browser GUI at port 5050)
+    - Multi-panel composition: ``figrecipe.compose()``
+    - Save/reproduce: ``figrecipe.save()`` / ``figrecipe.reproduce()``
 
-Quick Start:
------------
->>> import scitex as stx
->>>
->>> # Create canvas and add panels
->>> stx.vis.create_canvas("/output", "fig1")
->>> stx.vis.add_panel("/output", "fig1", "panel_a", source="plot.png",
-...                   xy_mm=(10, 10), size_mm=(80, 60), label="A")
->>>
->>> # Save with stx.io (auto-exports PNG/PDF/SVG)
->>> canvas = stx.io.load("/output/fig1.canvas")
->>> stx.io.save(canvas, "/output/fig1_copy.canvas")
+    Install: ``pip install figrecipe``
 
-Directory Structure:
--------------------
-{parent_dir}/{canvas_name}.canvas/
-    ├── canvas.json     # Layout, panels, composition
-    ├── panels/         # Panel directories
-    └── exports/        # canvas.png, canvas.pdf, canvas.svg
-"""
-
-# Submodules for advanced use
-from . import backend, editor, io, model, utils
+    Migration examples::
 
-# Canvas class
-from .canvas import Canvas
+        # Old (scitex.canvas)
+        from scitex.canvas import edit
+        edit(fig)
 
-# Editor
-from .editor import edit
+        # New (figrecipe)
+        import figrecipe as fr
+        fr.edit(fig)
 
-# Data integrity
-# Export (usually handled by stx.io.save, but available for explicit use)
-# =============================================================================
-# Primary API (minimal, reusable, flexible)
-# =============================================================================
-# Canvas operations
-# Panel operations
-from .io import add_panel_from_image, add_panel_from_scitex
-from .io import canvas_directory_exists as canvas_exists
-from .io import delete_canvas_directory as delete_canvas
-from .io import ensure_canvas_directory as create_canvas
-from .io import export_canvas_to_file as export_canvas
-from .io import get_canvas_directory_path as get_canvas_path
-from .io import list_canvas_directories as list_canvases
-from .io import list_panels, remove_panel, update_panel
-from .io import verify_all_data_hashes as verify_data
+        # Old (scitex.canvas multi-panel)
+        stx.canvas.create_canvas(...)
+        stx.canvas.add_panel(...)
 
+        # New (figrecipe.compose)
+        fig, axes = fr.compose(
+            sources={
+                "panel_a.png": {"xy_mm": (10, 10), "size_mm": (80, 60)},
+                "panel_b.png": {"xy_mm": (100, 10), "size_mm": (80, 60)},
+            },
+            canvas_size_mm=(190, 80),
+            panel_labels=True,
+        )
+"""
 
-# =============================================================================
-# Convenience wrapper for add_panel
-# =============================================================================
-def add_panel(
-    parent_dir,
-    canvas_name,
-    panel_name,
-    source,
-    xy_mm=(0, 0),
-    size_mm=(50, 50),
-    label="",
-    bundle=False,
-    **kwargs,
-):
-    """
-    Add a panel to canvas (auto-detects scitex vs image type).
+from __future__ import annotations
 
-    Parameters
-    ----------
-    parent_dir : str or Path
-        Parent directory containing canvas
-    canvas_name : str
-        Canvas name
-    panel_name : str
-        Name for the panel
-    source : str or Path
-        Source file (PNG, JPG, SVG)
-    xy_mm : tuple
-        (x_mm, y_mm) position on canvas in millimeters
-    size_mm : tuple
-        (width_mm, height_mm) panel size in millimeters
-    label : str
-        Panel label (A, B, C...)
-    bundle : bool
-        If True, copy files. If False (default), use symlinks.
-    **kwargs
-        Additional panel properties (rotation_deg, opacity, flip_h, etc.)
-    """
-    from pathlib import Path
+import warnings
 
-    source = Path(source)
-    panel_properties = {
-        "position": {"x_mm": xy_mm[0], "y_mm": xy_mm[1]},
-        "size": {"width_mm": size_mm[0], "height_mm": size_mm[1]},
-        **kwargs,
-    }
-    if label:
-        panel_properties["label"] = {"text": label, "position": "top-left"}
-
-    # Check if scitex output (has .json/.csv siblings)
-    json_sibling = source.parent / f"{source.stem}.json"
-    if json_sibling.exists():
-        return add_panel_from_scitex(
-            project_dir=parent_dir,
-            canvas_name=canvas_name,
-            panel_name=panel_name,
-            source_png=source,
-            panel_properties=panel_properties,
-            bundle=bundle,
-        )
-    else:
-        return add_panel_from_image(
-            project_dir=parent_dir,
-            canvas_name=canvas_name,
-            panel_name=panel_name,
-            source_image=source,
-            panel_properties=panel_properties,
-            bundle=bundle,
-        )
+# Issue deprecation warning on import
+warnings.warn(
+    "scitex.canvas is deprecated. Use figrecipe instead:\n"
+    "  - fr.edit() for interactive GUI editor (port 5050)\n"
+    "  - fr.compose() for multi-panel composition\n"
+    "  - pip install figrecipe",
+    DeprecationWarning,
+    stacklevel=2,
+)
 
 
 # =============================================================================
-# .figure Bundle Support
+# Delegate to figrecipe (preferred)
 # =============================================================================
+def edit(*args, **kwargs):
+    """Launch interactive GUI editor.
 
-
-def save_figure(
-    panels,
-    path,
-    spec=None,
-    as_zip=None,
-):
-    """
-    Save panels as a .figure publication figure bundle.
-
-    Parameters
-    ----------
-    panels : dict
-        Dictionary mapping panel IDs to .plot bundle paths or data.
-        Example: {"A": "timecourse.plot", "B": "barplot.plot"}
-    path : str or Path
-        Output path (e.g., "Figure1.figure.zip" or "Figure1.figure").
-        - Path ending with ".zip" creates ZIP archive
-        - Path ending with ".figure" creates directory bundle
-    spec : dict, optional
-        Figure specification. Auto-generated if None.
-    as_zip : bool, optional
-        If True, save as ZIP archive. If False, save as directory.
-        Default: auto-detect from path.
-
-    Returns
-    -------
-    Path
-        Path to saved bundle.
-
-    Examples
-    --------
-    >>> import scitex.canvas as sfig
-    >>> panels = {
-    ...     "A": "timecourse.plot",
-    ...     "B": "barplot.plot"
-    ... }
-    >>> sfig.save_figure(panels, "Figure1.figure.zip")  # Creates ZIP
-    >>> sfig.save_figure(panels, "Figure1.figure")      # Creates directory
-    """
-    import shutil
-    from pathlib import Path
-
-    from scitex.io.bundle import BundleType, save
-
-    p = Path(path)
-    spath = str(path)
-
-    # Auto-detect as_zip from path suffix if not specified
-    if as_zip is None:
-        as_zip = spath.endswith(".zip")
-
-    # Auto-generate spec if not provided
-    if spec is None:
-        spec = _generate_figure_spec(panels)
-
-    # Build bundle data - pass source paths directly for file copying
-    bundle_data = {
-        "spec": spec,
-        "plots": {},
-    }
-
-    # Pass source paths directly (not loaded data) to preserve all files
-    for panel_id, plot_source in panels.items():
-        plot_path = Path(plot_source)
-        if plot_path.exists():
-            # Store source path for direct copying
-            bundle_data["plots"][panel_id] = str(plot_path)
-
-    return save(bundle_data, p, bundle_type=BundleType.FIGURE, as_zip=as_zip)
-
-
-def load_figure(path):
+    .. deprecated:: 2.16.0
+        Use ``figrecipe.edit()`` instead.
     """
-    Load a .figure bundle.
-
-    Parameters
-    ----------
-    path : str or Path
-        Path to .figure bundle (directory or ZIP).
-
-    Returns
-    -------
-    dict
-        Figure data with:
-        - 'spec': Figure specification
-        - 'panels': Dict mapping panel IDs to {'spec': ..., 'data': ...}
-
-    Examples
-    --------
-    >>> figure = scitex.canvas.load_figure("Figure1.figure")
-    >>> print(figure['spec']['figure']['title'])
-    >>> panel_a = figure['panels']['A']
-    >>> print(panel_a['spec'], panel_a['data'])
+    warnings.warn(
+        "scitex.canvas.edit() is deprecated. Use figrecipe.edit() instead.",
+        DeprecationWarning,
+        stacklevel=2,
+    )
+    try:
+        import figrecipe as fr
+
+        return fr.edit(*args, **kwargs)
+    except ImportError as e:
+        raise ImportError(
+            "figrecipe is required for the editor. Install with: pip install figrecipe"
+        ) from e
+
+
+def compose(*args, **kwargs):
+    """Compose multi-panel figures.
+
+    .. deprecated:: 2.16.0
+        Use ``figrecipe.compose()`` instead.
     """
-    from scitex.io.bundle import load
+    warnings.warn(
+        "scitex.canvas.compose() is deprecated. Use figrecipe.compose() instead.",
+        DeprecationWarning,
+        stacklevel=2,
+    )
+    try:
+        import figrecipe as fr
 
-    bundle = load(path)
+        return fr.compose(*args, **kwargs)
+    except ImportError as e:
+        raise ImportError(
+            "figrecipe is required for composition. Install with: pip install figrecipe"
+        ) from e
 
-    if bundle["type"] != "figure":
-        raise ValueError(f"Not a .figure bundle: {path}")
 
-    result = {
-        "spec": bundle.get("spec", {}),
-        "panels": {},
-    }
-
-    # Return spec and data for each panel (reconstruction is optional)
-    for panel_id, plot_bundle in bundle.get("plots", {}).items():
-        result["panels"][panel_id] = {
-            "spec": plot_bundle.get("spec", {}),
-            "data": plot_bundle.get("data"),
-        }
-
-    return result
-
-
-def _generate_figure_spec(panels):
-    """Generate figure.json spec from panels."""
-    from pathlib import Path
-
-    spec = {
-        "schema": {"name": "scitex.canvas.figure", "version": "1.0.0"},
-        "figure": {
-            "id": "figure",
-            "title": "",
-            "caption": "",
-            "styles": {
-                "size": {"width_mm": 180, "height_mm": 120},
-                "background": "#ffffff",
-            },
-        },
-        "panels": [],
+# =============================================================================
+# Legacy imports (deprecated, for backward compatibility)
+# =============================================================================
+def __getattr__(name):
+    """Lazy import legacy submodules with deprecation warnings."""
+    _legacy_submodules = {"backend", "editor", "io", "model", "utils"}
+    _legacy_functions = {
+        "Canvas",
+        "create_canvas",
+        "get_canvas_path",
+        "canvas_exists",
+        "list_canvases",
+        "delete_canvas",
+        "add_panel",
+        "update_panel",
+        "remove_panel",
+        "list_panels",
+        "export_canvas",
+        "verify_data",
+        "save_figure",
+        "load_figure",
+        "add_panel_from_image",
+        "add_panel_from_scitex",
     }
 
-    # Auto-layout panels
-    panel_ids = sorted(panels.keys())
-    n_panels = len(panel_ids)
-
-    if n_panels == 0:
-        return spec
-
-    # Simple grid layout
-    cols = min(n_panels, 2)
-    rows = (n_panels + cols - 1) // cols
-
-    panel_w = 80
-    panel_h = 50
-    margin = 5
-
-    for i, panel_id in enumerate(panel_ids):
-        row = i // cols
-        col = i % cols
+    if name in _legacy_submodules:
+        warnings.warn(
+            f"scitex.canvas.{name} is deprecated. Use figrecipe instead.",
+            DeprecationWarning,
+            stacklevel=2,
+        )
+        if name == "backend":
+            from . import backend as mod
+        elif name == "editor":
+            from . import editor as mod
+        elif name == "io":
+            from . import io as mod
+        elif name == "model":
+            from . import model as mod
+        elif name == "utils":
+            from . import utils as mod
+        return mod
+
+    if name in _legacy_functions:
+        warnings.warn(
+            f"scitex.canvas.{name} is deprecated. Use figrecipe.compose() instead.",
+            DeprecationWarning,
+            stacklevel=2,
+        )
+        # Import from legacy locations
+        if name == "Canvas":
+            from .canvas import Canvas
+
+            return Canvas
+        elif name in {
+            "create_canvas",
+            "get_canvas_path",
+            "canvas_exists",
+            "list_canvases",
+            "delete_canvas",
+            "add_panel_from_image",
+            "add_panel_from_scitex",
+            "list_panels",
+            "remove_panel",
+            "update_panel",
+            "export_canvas",
+            "verify_data",
+        }:
+            from . import io as _io
+
+            _name_map = {
+                "create_canvas": "ensure_canvas_directory",
+                "get_canvas_path": "get_canvas_directory_path",
+                "canvas_exists": "canvas_directory_exists",
+                "list_canvases": "list_canvas_directories",
+                "delete_canvas": "delete_canvas_directory",
+                "export_canvas": "export_canvas_to_file",
+                "verify_data": "verify_all_data_hashes",
+            }
+            actual_name = _name_map.get(name, name)
+            return getattr(_io, actual_name)
+        elif name == "add_panel":
+            from ._legacy import add_panel
 
-        x = margin + col * (panel_w + margin)
-        y = margin + row * (panel_h + margin)
+            return add_panel
+        elif name in {"save_figure", "load_figure"}:
+            from ._legacy import load_figure, save_figure
 
-        # Note: save_bundle uses panel_id for the directory name (e.g., A.plot)
-        spec["panels"].append(
-            {
-                "id": panel_id,
-                "label": panel_id,
-                "caption": "",
-                "plot": f"{panel_id}.plot",
-                "position": {"x_mm": x, "y_mm": y},
-                "size": {"width_mm": panel_w, "height_mm": panel_h},
-            }
-        )
+            if name == "save_figure":
+                return save_figure
+            return load_figure
 
-    return spec
+    raise AttributeError(f"module 'scitex.canvas' has no attribute '{name}'")
 
 
 __all__ = [
-    # Canvas class
+    # Recommended (delegates to figrecipe)
+    "edit",
+    "compose",
+    # Legacy (deprecated)
     "Canvas",
-    # Submodules (advanced)
     "io",
     "model",
     "backend",
     "utils",
     "editor",
-    # Canvas operations
     "create_canvas",
     "get_canvas_path",
     "canvas_exists",
     "list_canvases",
     "delete_canvas",
-    # Panel operations
     "add_panel",
     "update_panel",
     "remove_panel",
     "list_panels",
-    # Export
     "export_canvas",
-    # Data integrity
     "verify_data",
-    # Editor
-    "edit",
-    # .figure bundle
     "save_figure",
     "load_figure",
 ]

scitex/canvas/_legacy.py

@@ -0,0 +1,171 @@
+#!/usr/bin/env python3
+# Timestamp: 2026-01-29
+# File: src/scitex/canvas/_legacy.py
+"""Legacy functions for backward compatibility.
+
+All functions here are deprecated. Use figrecipe instead.
+"""
+
+from __future__ import annotations
+
+from pathlib import Path
+from typing import Any
+
+
+def add_panel(
+    parent_dir,
+    canvas_name,
+    panel_name,
+    source,
+    xy_mm=(0, 0),
+    size_mm=(50, 50),
+    label="",
+    bundle=False,
+    **kwargs,
+):
+    """Add a panel to canvas (DEPRECATED).
+
+    Use figrecipe.compose() instead.
+    """
+    from .io import add_panel_from_image, add_panel_from_scitex
+
+    source = Path(source)
+    panel_properties = {
+        "position": {"x_mm": xy_mm[0], "y_mm": xy_mm[1]},
+        "size": {"width_mm": size_mm[0], "height_mm": size_mm[1]},
+        **kwargs,
+    }
+    if label:
+        panel_properties["label"] = {"text": label, "position": "top-left"}
+
+    json_sibling = source.parent / f"{source.stem}.json"
+    if json_sibling.exists():
+        return add_panel_from_scitex(
+            project_dir=parent_dir,
+            canvas_name=canvas_name,
+            panel_name=panel_name,
+            source_png=source,
+            panel_properties=panel_properties,
+            bundle=bundle,
+        )
+    else:
+        return add_panel_from_image(
+            project_dir=parent_dir,
+            canvas_name=canvas_name,
+            panel_name=panel_name,
+            source_image=source,
+            panel_properties=panel_properties,
+            bundle=bundle,
+        )
+
+
+def save_figure(
+    panels,
+    path,
+    spec=None,
+    as_zip=None,
+):
+    """Save panels as a .figure bundle (DEPRECATED).
+
+    Use figrecipe.compose() and figrecipe.save() instead.
+    """
+    from scitex.io.bundle import BundleType, save
+
+    p = Path(path)
+    spath = str(path)
+
+    if as_zip is None:
+        as_zip = spath.endswith(".zip")
+
+    if spec is None:
+        spec = _generate_figure_spec(panels)
+
+    bundle_data = {
+        "spec": spec,
+        "plots": {},
+    }
+
+    for panel_id, plot_source in panels.items():
+        plot_path = Path(plot_source)
+        if plot_path.exists():
+            bundle_data["plots"][panel_id] = str(plot_path)
+
+    return save(bundle_data, p, bundle_type=BundleType.FIGURE, as_zip=as_zip)
+
+
+def load_figure(path):
+    """Load a .figure bundle (DEPRECATED).
+
+    Use figrecipe.load() instead.
+    """
+    from scitex.io.bundle import load
+
+    bundle = load(path)
+
+    if bundle["type"] != "figure":
+        raise ValueError(f"Not a .figure bundle: {path}")
+
+    result = {
+        "spec": bundle.get("spec", {}),
+        "panels": {},
+    }
+
+    for panel_id, plot_bundle in bundle.get("plots", {}).items():
+        result["panels"][panel_id] = {
+            "spec": plot_bundle.get("spec", {}),
+            "data": plot_bundle.get("data"),
+        }
+
+    return result
+
+
+def _generate_figure_spec(panels) -> dict[str, Any]:
+    """Generate figure.json spec from panels."""
+    spec: dict[str, Any] = {
+        "schema": {"name": "scitex.canvas.figure", "version": "1.0.0"},
+        "figure": {
+            "id": "figure",
+            "title": "",
+            "caption": "",
+            "styles": {
+                "size": {"width_mm": 180, "height_mm": 120},
+                "background": "#ffffff",
+            },
+        },
+        "panels": [],
+    }
+
+    panel_ids = sorted(panels.keys())
+    n_panels = len(panel_ids)
+
+    if n_panels == 0:
+        return spec
+
+    cols = min(n_panels, 2)
+
+    panel_w = 80
+    panel_h = 50
+    margin = 5
+
+    for i, panel_id in enumerate(panel_ids):
+        row = i // cols
+        col = i % cols
+
+        x = margin + col * (panel_w + margin)
+        y = margin + row * (panel_h + margin)
+
+        spec["panels"].append(
+            {
+                "id": panel_id,
+                "label": panel_id,
+                "caption": "",
+                "plot": f"{panel_id}.plot",
+                "position": {"x_mm": x, "y_mm": y},
+                "size": {"width_mm": panel_w, "height_mm": panel_h},
+            }
+        )
+
+    return spec
+
+
+# EOF

{scitex-2.15.4.dist-info → scitex-2.15.5.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: scitex
-Version: 2.15.4
+Version: 2.15.5
 Summary: A comprehensive Python library for scientific computing and data analysis
 Project-URL: Homepage, https://github.com/ywatanabe1989/scitex-python
 Project-URL: Documentation, https://scitex.readthedocs.io

{scitex-2.15.4.dist-info → scitex-2.15.5.dist-info}/RECORD

@@ -17,7 +17,7 @@ scitex/_mcp_resources/_scholar.py,sha256=RSYt7j6bcbKtR-tOtvCtdE6J3IS8C925_c34t0Z
 scitex/_mcp_resources/_session.py,sha256=lbe9W3cfPOyoq6bPOeN-jB8MwI4DnRWMpxHmpfn97SM,4590
 scitex/_mcp_tools/__init__.py,sha256=6krJPLr6ReVAkGoZR7vQHQrszr8AGW4dwWsY2EcmPkc,1229
 scitex/_mcp_tools/audio.py,sha256=LBX9YQZkNGAXfoIEFljnHRk39gTyJfdaVPCRrS6F8qE,6245
-scitex/_mcp_tools/canvas.py,sha256=FeRyJ0BKbqqsaWdsK34qABATeWzNe4Fc461VdUDEtKE,3868
+scitex/_mcp_tools/canvas.py,sha256=zgu5velDxyTltn87DRN1EuGdJ1UZlcDbiEXGi5rZF7Q,5155
 scitex/_mcp_tools/capture.py,sha256=k7pwuB1vdP-VCYjutajEZEsvVAKY-8_mEYrYGWXgOo8,5658
 scitex/_mcp_tools/diagram.py,sha256=pZNq0UTRlg7piq0YDD40qY5M2mqFYoRdFwmWeRCBieA,585
 scitex/_mcp_tools/introspect.py,sha256=GY9j9EUAs-CKegzfPHubPT3OGpOjcY5Rb09M3OHEIwA,6562
@@ -241,7 +241,8 @@ scitex/browser/stealth/HumanBehavior.py,sha256=fTocrAO3-8rAgxW1aNZLFgErvHw2MUXao
 scitex/browser/stealth/StealthManager.py,sha256=mrtBAo-jo9nM7sSbzKC-s7VEci7SDK6GbidGNqmAPvs,37444
 scitex/browser/stealth/__init__.py,sha256=KVbyLjm8KnM5YwyB84A3pwLdUGkANNgwpA7YL2fyAxo,188
 scitex/canvas/README.md,sha256=jRwasTPNrmQsCyv67ul7qUIgv5xKIab1u2hi8tvlbAg,9142
-scitex/canvas/__init__.py,sha256=k_1mqbodRgy6phbhLDqRenEEnOLvueWwj0xNNYrCyd0,9380
+scitex/canvas/__init__.py,sha256=_K3ocsEwAJMyGRw0ruCD07vjFMjrH1QQNqXujHJbOEw,6295
+scitex/canvas/_legacy.py,sha256=g3pHBTuw9egpjt_CtE8I1YrWnkoauNNHsvDI0zR0xhQ,4060
 scitex/canvas/canvas.py,sha256=1aUjIqCzwKhGXukCQsHc-h-kqLNA9VqzIMazimqm2mA,12968
 scitex/canvas/mcp_server.py,sha256=fBTmtXOhO60wG-e6j-Y-WE_aWykAMsajWkidZRQ6lcU,4754
 scitex/canvas/_mcp/__init__.py,sha256=FJRAr90vUCg4PJ8Sv-WzsKuM7aY93m6UR87fhk843MU,73
@@ -2619,8 +2620,8 @@ scitex/writer/utils/_parse_latex_logs.py,sha256=K05kCJClG86-RovXG9I5e3wHP0mEGiZl
 scitex/writer/utils/_parse_script_args.py,sha256=Fkx1ze_jlKYIpviLuT7z0hpqE4cdtXXA_7sK3sKpVs4,4593
 scitex/writer/utils/_verify_tree_structure.py,sha256=Uk9NUSleR9aMHpAgUGsPZMk4a75l35EkZhQYKIfolVY,5724
 scitex/writer/utils/_watch.py,sha256=nYzPQ-iPAOzbwzAPBtSrrVBLLPMl08e0qxw0mtv0Y8I,2577
-scitex-2.15.4.dist-info/METADATA,sha256=YhHg4lxfd6DXKl_tGIfOp6ZAXs6HkBzAo3K61emqz7U,25007
-scitex-2.15.4.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-scitex-2.15.4.dist-info/entry_points.txt,sha256=ZtDrHnPNMnsSmAnQoCHNmk0xKotNyR2X_YFDDteupW8,497
-scitex-2.15.4.dist-info/licenses/LICENSE,sha256=TfPDBt3ar0uv_f9cqCDMZ5rIzW3CY8anRRd4PkL6ejs,34522
-scitex-2.15.4.dist-info/RECORD,,
+scitex-2.15.5.dist-info/METADATA,sha256=wgkawnkDMSabszfw6tnGUOqFOa6kQYZco60gQB3du0w,25007
+scitex-2.15.5.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+scitex-2.15.5.dist-info/entry_points.txt,sha256=ZtDrHnPNMnsSmAnQoCHNmk0xKotNyR2X_YFDDteupW8,497
+scitex-2.15.5.dist-info/licenses/LICENSE,sha256=TfPDBt3ar0uv_f9cqCDMZ5rIzW3CY8anRRd4PkL6ejs,34522
+scitex-2.15.5.dist-info/RECORD,,