scitex 2.10.3__py3-none-any.whl → 2.13.0__py3-none-any.whl

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

@@ -3,7 +3,7 @@
 # Timestamp: 2025-12-08
 # File: ./src/scitex/vis/io/canvas.py
 """
-Canvas JSON operations for scitex.fig.
+Canvas JSON operations for scitex.canvas.
 
 Handles saving, loading, and updating canvas.json files.
 """

scitex/{fig → canvas}/io/_data.py

@@ -3,7 +3,7 @@
 # Timestamp: 2025-12-08
 # File: ./src/scitex/vis/io/data.py
 """
-Data operations for scitex.fig.
+Data operations for scitex.canvas.
 
 Handles SHA256 hash computation and verification for data integrity.
 """

scitex/{fig → canvas}/io/_export.py

@@ -3,7 +3,7 @@
 # Timestamp: 2025-12-08
 # File: ./src/scitex/vis/io/export.py
 """
-Export operations for scitex.fig.
+Export operations for scitex.canvas.
 
 Handles composing and exporting canvas to various formats (PNG, PDF, SVG).
 """

scitex/{fig → canvas}/io/_load.py

@@ -115,7 +115,7 @@ def load_figure_model(
 
     Examples
     --------
-    >>> from scitex.fig.io import load_figure_model
+    >>> from scitex.canvas.io import load_figure_model
     >>> fig_model = load_figure_model("figure.json")
     >>> fig_model.width_mm
     180

scitex/{fig → canvas}/io/_panel.py

@@ -3,7 +3,7 @@
 # Timestamp: 2025-12-08
 # File: ./src/scitex/vis/io/panel.py
 """
-Panel operations for scitex.fig.
+Panel operations for scitex.canvas.
 
 Handles adding, removing, updating, and listing panels within a canvas.
 Panels can be either 'scitex' type (full stx.plt output) or 'image' type (static image).

scitex/{fig → canvas}/io/_save.py

@@ -119,7 +119,7 @@ def save_figure_model(
 
     Examples
     --------
-    >>> from scitex.fig.model import FigureModel
+    >>> from scitex.canvas.model import FigureModel
     >>> fig_model = FigureModel(width_mm=180, height_mm=120)
     >>> save_figure_model(fig_model, "figure.json")
     PosixPath('figure.json')

scitex/canvas/mcp_server.py

@@ -0,0 +1,151 @@
+#!/usr/bin/env python3
+# Timestamp: 2026-01-08
+# File: src/scitex/canvas/mcp_server.py
+# ----------------------------------------
+
+"""
+MCP Server for SciTeX canvas - Multi-panel figure composition.
+
+Provides tools for:
+- Creating canvas workspaces
+- Adding/removing panels
+- Exporting composed figures
+- Managing multi-panel layouts
+"""
+
+from __future__ import annotations
+
+import asyncio
+
+# Graceful MCP dependency handling
+try:
+    import mcp.types as types
+    from mcp.server import NotificationOptions, Server
+    from mcp.server.models import InitializationOptions
+    from mcp.server.stdio import stdio_server
+
+    MCP_AVAILABLE = True
+except ImportError:
+    MCP_AVAILABLE = False
+    types = None  # type: ignore
+    Server = None  # type: ignore
+    NotificationOptions = None  # type: ignore
+    InitializationOptions = None  # type: ignore
+    stdio_server = None  # type: ignore
+
+__all__ = ["CanvasServer", "main", "MCP_AVAILABLE"]
+
+
+class CanvasServer:
+    """MCP Server for Multi-panel Figure Composition."""
+
+    def __init__(self):
+        self.server = Server("scitex-canvas")
+        self.setup_handlers()
+
+    def setup_handlers(self):
+        """Set up MCP server handlers."""
+        from ._mcp_handlers import (
+            add_panel_handler,
+            canvas_exists_handler,
+            create_canvas_handler,
+            export_canvas_handler,
+            list_canvases_handler,
+            list_panels_handler,
+            remove_panel_handler,
+        )
+        from ._mcp_tool_schemas import get_tool_schemas
+
+        @self.server.list_tools()
+        async def handle_list_tools():
+            return get_tool_schemas()
+
+        @self.server.call_tool()
+        async def handle_call_tool(name: str, arguments: dict):
+            if name == "create_canvas":
+                return await self._wrap_result(create_canvas_handler(**arguments))
+
+            elif name == "add_panel":
+                return await self._wrap_result(add_panel_handler(**arguments))
+
+            elif name == "list_panels":
+                return await self._wrap_result(list_panels_handler(**arguments))
+
+            elif name == "remove_panel":
+                return await self._wrap_result(remove_panel_handler(**arguments))
+
+            elif name == "export_canvas":
+                return await self._wrap_result(export_canvas_handler(**arguments))
+
+            elif name == "list_canvases":
+                return await self._wrap_result(list_canvases_handler(**arguments))
+
+            elif name == "canvas_exists":
+                return await self._wrap_result(canvas_exists_handler(**arguments))
+
+            else:
+                raise ValueError(f"Unknown tool: {name}")
+
+    async def _wrap_result(self, coro):
+        """Wrap handler result as MCP TextContent."""
+        import json
+
+        try:
+            result = await coro
+            return [
+                types.TextContent(
+                    type="text",
+                    text=json.dumps(result, indent=2, default=str),
+                )
+            ]
+        except Exception as e:
+            return [
+                types.TextContent(
+                    type="text",
+                    text=json.dumps({"success": False, "error": str(e)}, indent=2),
+                )
+            ]
+
+
+async def _run_server():
+    """Run the MCP server (internal)."""
+    server = CanvasServer()
+    async with stdio_server() as (read_stream, write_stream):
+        await server.server.run(
+            read_stream,
+            write_stream,
+            InitializationOptions(
+                server_name="scitex-canvas",
+                server_version="0.1.0",
+                capabilities=server.server.get_capabilities(
+                    notification_options=NotificationOptions(),
+                    experimental_capabilities={},
+                ),
+            ),
+        )
+
+
+def main():
+    """Main entry point for the MCP server."""
+    if not MCP_AVAILABLE:
+        import sys
+
+        print("=" * 60)
+        print("MCP Server 'scitex-canvas' requires the 'mcp' package.")
+        print()
+        print("Install with:")
+        print("  pip install mcp")
+        print()
+        print("Or install scitex with MCP support:")
+        print("  pip install scitex[mcp]")
+        print("=" * 60)
+        sys.exit(1)
+
+    asyncio.run(_run_server())
+
+
+if __name__ == "__main__":
+    main()
+
+
+# EOF

scitex/{fig → canvas}/model/__init__.py

@@ -2,7 +2,7 @@
 # -*- coding: utf-8 -*-
 # File: ./src/scitex/vis/model/__init__.py
 """
-JSON models for scitex.fig figure specifications.
+JSON models for scitex.canvas figure specifications.
 
 This module provides dataclass-based models for representing
 publication-quality figures as JSON structures.

scitex/{fig → canvas}/model/_annotations.py

@@ -1,7 +1,7 @@
 #!/usr/bin/env python3
 # -*- coding: utf-8 -*-
 # File: ./src/scitex/vis/model/annotations.py
-"""Annotation JSON model for scitex.fig."""
+"""Annotation JSON model for scitex.canvas."""
 
 from typing import Optional, Dict, Any, Tuple
 from dataclasses import dataclass, field, asdict

scitex/{fig → canvas}/model/_axes.py

@@ -1,7 +1,7 @@
 #!/usr/bin/env python3
 # -*- coding: utf-8 -*-
 # File: ./src/scitex/vis/model/axes.py
-"""Axes JSON model for scitex.fig."""
+"""Axes JSON model for scitex.canvas."""
 
 from typing import Optional, List, Dict, Any
 from dataclasses import dataclass, field, asdict

scitex/{fig → canvas}/model/_figure.py

@@ -1,7 +1,7 @@
 #!/usr/bin/env python3
 # -*- coding: utf-8 -*-
 # File: ./src/scitex/vis/model/figure.py
-"""Figure JSON model for scitex.fig."""
+"""Figure JSON model for scitex.canvas."""
 
 from typing import Optional, List, Dict, Any
 from dataclasses import dataclass, field, asdict

scitex/{fig → canvas}/model/_guides.py

@@ -1,7 +1,7 @@
 #!/usr/bin/env python3
 # -*- coding: utf-8 -*-
 # File: ./src/scitex/vis/model/guides.py
-"""Guide elements (lines, spans) JSON model for scitex.fig."""
+"""Guide elements (lines, spans) JSON model for scitex.canvas."""
 
 from typing import Optional, List, Dict, Any
 from dataclasses import dataclass, field, asdict

scitex/{fig → canvas}/model/_plot.py

@@ -1,7 +1,7 @@
 #!/usr/bin/env python3
 # -*- coding: utf-8 -*-
 # File: ./src/scitex/vis/model/plot.py
-"""Plot JSON model for scitex.fig."""
+"""Plot JSON model for scitex.canvas."""
 
 from typing import Optional, List, Dict, Any
 from dataclasses import dataclass, field, asdict

scitex/{fig → canvas}/model/_styles.py

@@ -2,7 +2,7 @@
 # -*- coding: utf-8 -*-
 # File: ./src/scitex/vis/model/styles.py
 """
-Style dataclasses for scitex.fig objects.
+Style dataclasses for scitex.canvas objects.
 
 Separating style properties from data makes:
 - UI property panels easy to auto-generate

scitex/{fig → canvas}/utils/__init__.py

@@ -2,7 +2,7 @@
 # -*- coding: utf-8 -*-
 # File: ./src/scitex/vis/utils/__init__.py
 """
-Utilities for scitex.fig.
+Utilities for scitex.canvas.
 
 Includes validation functions and default templates for
 common publication formats.

scitex/capture/mcp_server.py

@@ -1,9 +1,9 @@
 #!/usr/bin/env python3
-# -*- coding: utf-8 -*-
 # Timestamp: "2025-10-17 03:24:58 (ywatanabe)"
 # File: /home/ywatanabe/proj/scitex-code/src/scitex/capture/mcp_server.py
 # ----------------------------------------
 from __future__ import annotations
+
 import os
 
 __FILE__ = "./src/scitex/capture/mcp_server.py"
@@ -20,17 +20,27 @@ import base64
 from datetime import datetime
 from pathlib import Path
 
-import mcp.types as types
-from mcp.server import NotificationOptions, Server
-from mcp.server.models import InitializationOptions
-from mcp.server.stdio import stdio_server
-
-from scitex import capture
-import shutil
-
+# Graceful MCP dependency handling
+try:
+    import mcp.types as types
+    from mcp.server import NotificationOptions, Server
+    from mcp.server.models import InitializationOptions
+    from mcp.server.stdio import stdio_server
+
+    MCP_AVAILABLE = True
+except ImportError:
+    MCP_AVAILABLE = False
+    types = None  # type: ignore
+    Server = None  # type: ignore
+    NotificationOptions = None  # type: ignore
+    InitializationOptions = None  # type: ignore
+    stdio_server = None  # type: ignore
 
 # Directory configuration
 import os
+import shutil
+
+from scitex import capture
 
 # Use SCITEX_DIR environment variable if set, otherwise default to ~/.scitex
 SCITEX_BASE_DIR = Path(os.getenv("SCITEX_DIR", Path.home() / ".scitex"))
@@ -924,8 +934,8 @@ class CaptureServer:
             return {"success": False, "error": str(e)}
 
 
-async def main():
-    """Main entry point for the MCP server."""
+async def _run_server():
+    """Run the MCP server (internal)."""
     server = CaptureServer()
     async with stdio_server() as (read_stream, write_stream):
         await server.server.run(
@@ -942,7 +952,26 @@ async def main():
         )
 
 
+def main():
+    """Main entry point for the MCP server."""
+    if not MCP_AVAILABLE:
+        import sys
+
+        print("=" * 60)
+        print("MCP Server 'scitex-capture' requires the 'mcp' package.")
+        print()
+        print("Install with:")
+        print("  pip install mcp")
+        print()
+        print("Or install scitex with MCP support:")
+        print("  pip install scitex[mcp]")
+        print("=" * 60)
+        sys.exit(1)
+
+    asyncio.run(_run_server())
+
+
 if __name__ == "__main__":
-    asyncio.run(main())
+    main()
 
 # EOF

scitex/cli/audio.py

@@ -0,0 +1,233 @@
+#!/usr/bin/env python3
+"""
+SciTeX CLI - Audio Commands (Text-to-Speech)
+
+Provides text-to-speech with multiple backend support.
+"""
+
+import sys
+
+import click
+
+
+@click.group(context_settings={"help_option_names": ["-h", "--help"]})
+def audio():
+    """
+    Text-to-speech utilities
+
+    \b
+    Backends (fallback order):
+      pyttsx3    - System TTS (offline, free)
+      gtts       - Google TTS (free, needs internet)
+      elevenlabs - ElevenLabs (paid, high quality)
+
+    \b
+    Examples:
+      scitex audio speak "Hello world"
+      scitex audio speak "Bonjour" --backend gtts --voice fr
+      scitex audio backends              # List available backends
+      scitex audio check                 # Check audio status (WSL)
+    """
+    pass
+
+
+@audio.command()
+@click.argument("text")
+@click.option(
+    "--backend",
+    "-b",
+    type=click.Choice(["pyttsx3", "gtts", "elevenlabs"]),
+    help="TTS backend (auto-selects with fallback if not specified)",
+)
+@click.option("--voice", "-v", help="Voice name, ID, or language code")
+@click.option("--output", "-o", type=click.Path(), help="Save audio to file")
+@click.option("--no-play", is_flag=True, help="Don't play audio (only save)")
+@click.option("--rate", "-r", type=int, help="Speech rate (pyttsx3 only, default: 150)")
+@click.option(
+    "--speed", "-s", type=float, help="Speed multiplier (gtts only, e.g., 1.5)"
+)
+@click.option("--no-fallback", is_flag=True, help="Disable backend fallback on error")
+def speak(text, backend, voice, output, no_play, rate, speed, no_fallback):
+    """
+    Convert text to speech
+
+    \b
+    Examples:
+      scitex audio speak "Hello world"
+      scitex audio speak "Bonjour" --backend gtts --voice fr
+      scitex audio speak "Test" --output speech.mp3 --no-play
+      scitex audio speak "Fast speech" --backend pyttsx3 --rate 200
+      scitex audio speak "Slow speech" --backend gtts --speed 0.8
+    """
+    try:
+        from scitex.audio import speak as tts_speak
+
+        kwargs = {
+            "text": text,
+            "play": not no_play,
+            "fallback": not no_fallback,
+        }
+
+        if backend:
+            kwargs["backend"] = backend
+        if voice:
+            kwargs["voice"] = voice
+        if output:
+            kwargs["output_path"] = output
+        if rate:
+            kwargs["rate"] = rate
+        if speed:
+            kwargs["speed"] = speed
+
+        result = tts_speak(**kwargs)
+
+        if output and result:
+            click.secho(f"Audio saved: {result}", fg="green")
+        elif not no_play:
+            click.secho("Speech completed", fg="green")
+
+    except Exception as e:
+        click.secho(f"Error: {e}", fg="red", err=True)
+        sys.exit(1)
+
+
+@audio.command(name="backends")
+@click.option("--json", "as_json", is_flag=True, help="Output as JSON")
+def list_backends(as_json):
+    """
+    List available TTS backends
+
+    \b
+    Example:
+      scitex audio backends
+      scitex audio backends --json
+    """
+    try:
+        from scitex.audio import FALLBACK_ORDER, available_backends
+
+        backends = available_backends()
+
+        if as_json:
+            import json
+
+            output = {
+                "available": backends,
+                "fallback_order": FALLBACK_ORDER,
+            }
+            click.echo(json.dumps(output, indent=2))
+        else:
+            click.secho("Available TTS Backends", fg="cyan", bold=True)
+            click.echo("=" * 40)
+
+            click.echo("\nFallback order:")
+            for i, b in enumerate(FALLBACK_ORDER, 1):
+                status = (
+                    click.style("available", fg="green")
+                    if b in backends
+                    else click.style("not installed", fg="red")
+                )
+                click.echo(f"  {i}. {b}: {status}")
+
+            if not backends:
+                click.echo()
+                click.secho("No backends available!", fg="red")
+                click.echo("Install one of:")
+                click.echo("  pip install pyttsx3  # + apt install espeak-ng")
+                click.echo("  pip install gTTS")
+                click.echo("  pip install elevenlabs")
+
+    except Exception as e:
+        click.secho(f"Error: {e}", fg="red", err=True)
+        sys.exit(1)
+
+
+@audio.command()
+@click.option("--json", "as_json", is_flag=True, help="Output as JSON")
+def check(as_json):
+    """
+    Check audio status (especially for WSL)
+
+    \b
+    Checks:
+      - WSL detection
+      - WSLg availability
+      - PulseAudio connection
+      - Windows fallback availability
+
+    \b
+    Example:
+      scitex audio check
+      scitex audio check --json
+    """
+    try:
+        from scitex.audio import check_wsl_audio
+
+        status = check_wsl_audio()
+
+        if as_json:
+            import json
+
+            click.echo(json.dumps(status, indent=2))
+        else:
+            click.secho("Audio Status Check", fg="cyan", bold=True)
+            click.echo("=" * 40)
+
+            def status_mark(val):
+                return (
+                    click.style("Yes", fg="green")
+                    if val
+                    else click.style("No", fg="red")
+                )
+
+            click.echo(f"\nWSL Environment: {status_mark(status['is_wsl'])}")
+
+            if status["is_wsl"]:
+                click.echo(f"WSLg Available: {status_mark(status['wslg_available'])}")
+                click.echo(
+                    f"PulseServer Socket: {status_mark(status['pulse_server_exists'])}"
+                )
+                click.echo(
+                    f"PulseAudio Connected: {status_mark(status['pulse_connected'])}"
+                )
+                click.echo(
+                    f"Windows Fallback: {status_mark(status['windows_fallback_available'])}"
+                )
+
+            click.echo()
+            rec = status["recommended"]
+            if rec == "linux":
+                click.secho("Recommended: Linux audio (PulseAudio)", fg="green")
+            elif rec == "windows":
+                click.secho(
+                    "Recommended: Windows fallback (powershell.exe)", fg="yellow"
+                )
+            else:
+                click.secho("No audio output available", fg="red")
+
+    except Exception as e:
+        click.secho(f"Error: {e}", fg="red", err=True)
+        sys.exit(1)
+
+
+@audio.command()
+def stop():
+    """
+    Stop any currently playing speech
+
+    \b
+    Example:
+      scitex audio stop
+    """
+    try:
+        from scitex.audio import stop_speech
+
+        stop_speech()
+        click.secho("Speech stopped", fg="green")
+
+    except Exception as e:
+        click.secho(f"Error: {e}", fg="red", err=True)
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    audio()