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

figrecipe/_editor/_templates/_scripts/__init__.py

@@ -0,0 +1,178 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""JavaScript modules for the figure editor.
+
+This package contains modular JavaScript organized by functionality:
+- _accordion.py: Panel collapse/expand with state persistence
+- _api.py: API calls (save, load, update, download)
+- _colors.py: Color presets and conversion utilities
+- _core.py: State variables and initialization
+- _debug_snapshot.py: Screenshot + console log capture (Ctrl+Alt+I)
+- _element_editor.py: Dynamic form fields and call properties
+- _files.py: File switching functionality
+- _hitmap.py: Hitmap loading and hit region drawing
+- _inspector.py: Element inspector debugging
+- _labels.py: Label inputs and axis/legend controls
+- _modals.py: Theme and shortcuts modals
+- _panel_snap.py: Panel snapping (grid, edge, center alignment)
+- _panel_drag.py: Panel drag-to-move (click+drag on empty panel area)
+- _panel_resize.py: Panel divider drag-to-resize
+- _legend_drag.py: Legend drag-to-move (click+drag on legend)
+- _panel_position.py: Panel position editing (left, bottom, width, height)
+- _multi_select.py: Multi-selection with Ctrl+Click
+- _overlays.py: Measurement overlays (ruler, grid, columns)
+- _region_select.py: Region/marquee selection by dragging rectangle
+- _selection.py: Selection drawing and property sync
+- _tabs.py: Tab navigation (Figure/Axis/Element)
+- _view_mode.py: View mode management (all/selected)
+- _zoom.py: Zoom/pan functionality
+- _undo_redo.py: Undo/redo history (Ctrl+Z, Ctrl+Shift+Z)
+"""
+
+from ._accordion import SCRIPTS_ACCORDION
+from ._annotation_drag import SCRIPTS_ANNOTATION_DRAG
+from ._api import SCRIPTS_API
+from ._canvas_context_menu import JS_CANVAS_CONTEXT_MENU
+from ._captions import SCRIPTS_CAPTIONS
+from ._colors import SCRIPTS_COLORS
+from ._core import SCRIPTS_CORE
+from ._datatable import SCRIPTS_DATATABLE
+from ._debug_snapshot import SCRIPTS_DEBUG_SNAPSHOT
+from ._element_editor import SCRIPTS_ELEMENT_EDITOR
+from ._files import SCRIPTS_FILES
+from ._files_context_menu import JS_FILES_CONTEXT_MENU
+from ._hitmap import SCRIPTS_HITMAP
+from ._image_drop import SCRIPTS_IMAGE_DROP
+from ._inspector import SCRIPTS_INSPECTOR
+from ._labels import SCRIPTS_LABELS
+from ._legend_drag import SCRIPTS_LEGEND_DRAG
+from ._modals import SCRIPTS_MODALS
+from ._multi_select import SCRIPTS_MULTI_SELECT
+from ._overlays import SCRIPTS_OVERLAYS
+from ._panel_drag import SCRIPTS_PANEL_DRAG
+from ._panel_drag_snapshot import SCRIPTS_PANEL_DRAG_SNAPSHOT
+from ._panel_position import SCRIPTS_PANEL_POSITION
+from ._panel_resize import SCRIPTS_PANEL_RESIZE
+from ._panel_snap import SCRIPTS_PANEL_SNAP
+from ._region_select import SCRIPTS_REGION_SELECT
+from ._selection import SCRIPTS_SELECTION
+from ._sync import SCRIPTS_SYNC
+from ._tabs import SCRIPTS_TABS
+from ._undo_redo import SCRIPTS_UNDO_REDO
+from ._view_mode import SCRIPTS_VIEW_MODE
+from ._zoom import SCRIPTS_ZOOM
+
+# Combined SCRIPTS constant for backward compatibility
+# Order matters: debug snapshot first (for console interception), then core/state, then features
+SCRIPTS = (
+    SCRIPTS_DEBUG_SNAPSHOT
+    + SCRIPTS_CORE
+    + SCRIPTS_TABS
+    + SCRIPTS_VIEW_MODE
+    + SCRIPTS_COLORS
+    + SCRIPTS_HITMAP
+    + SCRIPTS_SELECTION
+    + SCRIPTS_MULTI_SELECT
+    + SCRIPTS_REGION_SELECT
+    + SCRIPTS_ELEMENT_EDITOR
+    + SCRIPTS_LABELS
+    + SCRIPTS_CAPTIONS
+    + SCRIPTS_API
+    + SCRIPTS_MODALS
+    + SCRIPTS_ZOOM
+    + SCRIPTS_OVERLAYS
+    + SCRIPTS_INSPECTOR
+    + SCRIPTS_FILES
+    + SCRIPTS_PANEL_POSITION
+    + SCRIPTS_PANEL_SNAP
+    + SCRIPTS_PANEL_DRAG_SNAPSHOT
+    + SCRIPTS_PANEL_DRAG
+    + SCRIPTS_PANEL_RESIZE
+    + SCRIPTS_ACCORDION
+    + SCRIPTS_LEGEND_DRAG
+    + SCRIPTS_ANNOTATION_DRAG
+    + SCRIPTS_IMAGE_DROP
+    + SCRIPTS_UNDO_REDO
+    + SCRIPTS_DATATABLE
+    + SCRIPTS_SYNC
+    + JS_CANVAS_CONTEXT_MENU
+    + JS_FILES_CONTEXT_MENU
+)
+
+
+def get_all_scripts():
+    """Return all scripts as a dictionary for testing.
+
+    Returns
+    -------
+    dict
+        Mapping of script name to script content.
+    """
+    return {
+        "accordion": SCRIPTS_ACCORDION,
+        "annotation_drag": SCRIPTS_ANNOTATION_DRAG,
+        "api": SCRIPTS_API,
+        "captions": SCRIPTS_CAPTIONS,
+        "colors": SCRIPTS_COLORS,
+        "core": SCRIPTS_CORE,
+        "datatable": SCRIPTS_DATATABLE,
+        "debug_snapshot": SCRIPTS_DEBUG_SNAPSHOT,
+        "element_editor": SCRIPTS_ELEMENT_EDITOR,
+        "files": SCRIPTS_FILES,
+        "hitmap": SCRIPTS_HITMAP,
+        "image_drop": SCRIPTS_IMAGE_DROP,
+        "inspector": SCRIPTS_INSPECTOR,
+        "labels": SCRIPTS_LABELS,
+        "legend_drag": SCRIPTS_LEGEND_DRAG,
+        "modals": SCRIPTS_MODALS,
+        "overlays": SCRIPTS_OVERLAYS,
+        "multi_select": SCRIPTS_MULTI_SELECT,
+        "panel_drag": SCRIPTS_PANEL_DRAG,
+        "panel_drag_snapshot": SCRIPTS_PANEL_DRAG_SNAPSHOT,
+        "panel_position": SCRIPTS_PANEL_POSITION,
+        "panel_resize": SCRIPTS_PANEL_RESIZE,
+        "panel_snap": SCRIPTS_PANEL_SNAP,
+        "region_select": SCRIPTS_REGION_SELECT,
+        "selection": SCRIPTS_SELECTION,
+        "sync": SCRIPTS_SYNC,
+        "tabs": SCRIPTS_TABS,
+        "undo_redo": SCRIPTS_UNDO_REDO,
+        "view_mode": SCRIPTS_VIEW_MODE,
+        "zoom": SCRIPTS_ZOOM,
+    }
+
+
+__all__ = [
+    "SCRIPTS",
+    "SCRIPTS_ACCORDION",
+    "SCRIPTS_ANNOTATION_DRAG",
+    "SCRIPTS_API",
+    "SCRIPTS_CAPTIONS",
+    "SCRIPTS_COLORS",
+    "SCRIPTS_CORE",
+    "SCRIPTS_DATATABLE",
+    "SCRIPTS_DEBUG_SNAPSHOT",
+    "SCRIPTS_ELEMENT_EDITOR",
+    "SCRIPTS_FILES",
+    "SCRIPTS_HITMAP",
+    "SCRIPTS_IMAGE_DROP",
+    "SCRIPTS_INSPECTOR",
+    "SCRIPTS_LABELS",
+    "SCRIPTS_LEGEND_DRAG",
+    "SCRIPTS_MODALS",
+    "SCRIPTS_MULTI_SELECT",
+    "SCRIPTS_OVERLAYS",
+    "SCRIPTS_PANEL_DRAG",
+    "SCRIPTS_PANEL_DRAG_SNAPSHOT",
+    "SCRIPTS_PANEL_POSITION",
+    "SCRIPTS_PANEL_RESIZE",
+    "SCRIPTS_PANEL_SNAP",
+    "SCRIPTS_REGION_SELECT",
+    "SCRIPTS_SELECTION",
+    "SCRIPTS_SYNC",
+    "SCRIPTS_TABS",
+    "SCRIPTS_UNDO_REDO",
+    "SCRIPTS_VIEW_MODE",
+    "SCRIPTS_ZOOM",
+    "get_all_scripts",
+]

figrecipe/_editor/_templates/_scripts/_accordion.py

@@ -0,0 +1,328 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""Panel accordion JavaScript for the figure editor.
+
+This module handles collapsing/expanding of panels:
+- File browser panel (left)
+- Data panel (second from left)
+- Properties panel (right)
+- State persistence in localStorage
+"""
+
+SCRIPTS_ACCORDION = """
+// ==================== PANEL ACCORDION ====================
+// Enables collapsing/expanding panels with state persistence
+
+let propertiesPanelCollapsed = false;
+let dataPanelCollapsed = false;
+let previewPanelCollapsed = false;
+// Note: fileBrowserCollapsed is declared in _files.py
+
+// Smart expansion: when a panel collapses, expand collapsed neighbors to fill space
+function checkSmartExpansion(collapsedPanelId) {
+    // Panel order: Files | Data | Canvas | Properties
+    // When one collapses, adjacent collapsed panels should expand
+
+    const filePanel = document.getElementById('file-browser-panel');
+    const dataPanel = document.getElementById('datatable-panel');
+    const previewPanel = document.getElementById('preview-panel');
+    const propsPanel = document.getElementById('controls-panel');
+
+    const isFileCollapsed = filePanel?.classList.contains('collapsed');
+    const isDataCollapsed = dataPanel?.classList.contains('collapsed');
+    const isPreviewCollapsed = previewPanel?.classList.contains('collapsed');
+    const isPropsCollapsed = propsPanel?.classList.contains('collapsed');
+
+    console.log('[SmartExpansion] Checking after', collapsedPanelId, 'collapsed');
+    console.log('[SmartExpansion] States - Files:', isFileCollapsed, 'Data:', isDataCollapsed,
+                'Preview:', isPreviewCollapsed, 'Props:', isPropsCollapsed);
+
+    // When Canvas collapses -> expand Data if collapsed
+    if (collapsedPanelId === 'preview-panel' && isDataCollapsed) {
+        console.log('[SmartExpansion] Canvas collapsed, expanding Data panel');
+        expandDataPanel();
+    }
+
+    // When Data collapses -> expand Canvas if collapsed (prioritize canvas for viewing)
+    if (collapsedPanelId === 'datatable-panel' && isPreviewCollapsed) {
+        console.log('[SmartExpansion] Data collapsed, expanding Canvas panel');
+        expandPreviewPanel();
+    }
+
+    // When Properties collapses -> expand Canvas if collapsed
+    if (collapsedPanelId === 'controls-panel' && isPreviewCollapsed) {
+        console.log('[SmartExpansion] Properties collapsed, expanding Canvas panel');
+        expandPreviewPanel();
+    }
+
+    // When Files collapses -> expand Data if collapsed
+    if (collapsedPanelId === 'file-browser-panel' && isDataCollapsed) {
+        console.log('[SmartExpansion] Files collapsed, expanding Data panel');
+        expandDataPanel();
+    }
+}
+
+// Helper functions to expand without toggling
+function expandDataPanel() {
+    const panel = document.getElementById('datatable-panel');
+    const collapseBtn = document.getElementById('btn-collapse-datatable');
+    if (!panel || !panel.classList.contains('collapsed')) return;
+
+    dataPanelCollapsed = false;
+    panel.classList.remove('collapsed');
+    if (collapseBtn) collapseBtn.title = 'Collapse panel';
+    localStorage.setItem('figrecipe_data_collapsed', 'false');
+    console.log('[PanelAccordion] Data panel auto-expanded');
+}
+
+function expandPreviewPanel() {
+    const panel = document.getElementById('preview-panel');
+    const collapseBtn = document.getElementById('btn-collapse-preview');
+    if (!panel || !panel.classList.contains('collapsed')) return;
+
+    previewPanelCollapsed = false;
+    panel.classList.remove('collapsed');
+    if (collapseBtn) collapseBtn.title = 'Collapse canvas';
+    localStorage.setItem('figrecipe_preview_collapsed', 'false');
+    console.log('[PanelAccordion] Preview panel auto-expanded');
+}
+
+function expandPropertiesPanel() {
+    const panel = document.getElementById('controls-panel');
+    const collapseBtn = document.getElementById('btn-collapse-properties');
+    if (!panel || !panel.classList.contains('collapsed')) return;
+
+    propertiesPanelCollapsed = false;
+    panel.classList.remove('collapsed');
+    if (collapseBtn) collapseBtn.title = 'Collapse panel';
+    localStorage.setItem('figrecipe_properties_collapsed', 'false');
+    console.log('[PanelAccordion] Properties panel auto-expanded');
+}
+
+function expandFileBrowserPanel() {
+    const panel = document.getElementById('file-browser-panel');
+    const collapseBtn = document.getElementById('btn-collapse-browser');
+    if (!panel || !panel.classList.contains('collapsed')) return;
+
+    // fileBrowserCollapsed is defined in _files.py
+    if (typeof fileBrowserCollapsed !== 'undefined') fileBrowserCollapsed = false;
+    panel.classList.remove('collapsed');
+    if (collapseBtn) {
+        collapseBtn.innerHTML = '❮';
+        collapseBtn.title = 'Collapse panel';
+    }
+    localStorage.setItem('figrecipe_filebrowser_collapsed', 'false');
+    console.log('[PanelAccordion] File browser auto-expanded');
+}
+
+function initPanelAccordion() {
+    // Properties panel collapse button
+    const propertiesCollapseBtn = document.getElementById('btn-collapse-properties');
+    const propertiesPanel = document.getElementById('controls-panel');
+
+    if (propertiesCollapseBtn && propertiesPanel) {
+        propertiesCollapseBtn.addEventListener('click', togglePropertiesPanel);
+
+        // Restore collapsed state from localStorage
+        const wasCollapsed = localStorage.getItem('figrecipe_properties_collapsed');
+        if (wasCollapsed === 'true') {
+            propertiesPanelCollapsed = true;
+            propertiesPanel.classList.add('collapsed');
+            propertiesCollapseBtn.title = 'Expand panel';
+        }
+    }
+
+    // Data panel collapse button
+    const dataCollapseBtn = document.getElementById('btn-collapse-datatable');
+    const dataPanel = document.getElementById('datatable-panel');
+
+    if (dataCollapseBtn && dataPanel) {
+        dataCollapseBtn.addEventListener('click', toggleDataPanel);
+
+        // Restore collapsed state from localStorage
+        const wasDataCollapsed = localStorage.getItem('figrecipe_data_collapsed');
+        if (wasDataCollapsed === 'true') {
+            dataPanelCollapsed = true;
+            dataPanel.classList.add('collapsed');
+            dataCollapseBtn.title = 'Expand panel';
+        }
+    }
+
+    // File browser accordion - add localStorage persistence
+    const fileBrowserPanel = document.getElementById('file-browser-panel');
+    if (fileBrowserPanel) {
+        const wasFileBrowserCollapsed = localStorage.getItem('figrecipe_filebrowser_collapsed');
+        if (wasFileBrowserCollapsed === 'true') {
+            fileBrowserPanel.classList.add('collapsed');
+            const collapseBtn = document.getElementById('btn-collapse-browser');
+            if (collapseBtn) {
+                collapseBtn.innerHTML = '❯';
+                collapseBtn.title = 'Expand panel';
+            }
+        }
+    }
+
+    // Preview/canvas panel collapse button
+    const previewCollapseBtn = document.getElementById('btn-collapse-preview');
+    const previewPanel = document.getElementById('preview-panel');
+
+    if (previewCollapseBtn && previewPanel) {
+        previewCollapseBtn.addEventListener('click', togglePreviewPanel);
+
+        // Restore collapsed state from localStorage
+        const wasPreviewCollapsed = localStorage.getItem('figrecipe_preview_collapsed');
+        if (wasPreviewCollapsed === 'true') {
+            previewPanelCollapsed = true;
+            previewPanel.classList.add('collapsed');
+            previewCollapseBtn.title = 'Expand canvas';
+        }
+    }
+
+    // Add keyboard shortcuts for toggling panels
+    document.addEventListener('keydown', (e) => {
+        // Alt+1: Toggle file browser
+        if (e.altKey && e.key === '1') {
+            e.preventDefault();
+            if (typeof toggleFileBrowser === 'function') {
+                toggleFileBrowser();
+                saveFileBrowserState();
+            }
+        }
+        // Alt+2: Toggle data panel
+        if (e.altKey && e.key === '2') {
+            e.preventDefault();
+            toggleDataPanel();
+        }
+        // Alt+3: Toggle canvas/preview panel
+        if (e.altKey && e.key === '3') {
+            e.preventDefault();
+            togglePreviewPanel();
+        }
+        // Alt+4: Toggle properties panel
+        if (e.altKey && e.key === '4') {
+            e.preventDefault();
+            togglePropertiesPanel();
+        }
+    });
+
+    console.log('[PanelAccordion] Initialized');
+}
+
+function toggleDataPanel() {
+    const panel = document.getElementById('datatable-panel');
+    const collapseBtn = document.getElementById('btn-collapse-datatable');
+    if (!panel) return;
+
+    dataPanelCollapsed = !dataPanelCollapsed;
+    panel.classList.toggle('collapsed', dataPanelCollapsed);
+
+    if (collapseBtn) {
+        collapseBtn.title = dataPanelCollapsed ? 'Expand panel' : 'Collapse panel';
+    }
+
+    // Persist state
+    localStorage.setItem('figrecipe_data_collapsed', dataPanelCollapsed);
+
+    console.log('[PanelAccordion] Data panel', dataPanelCollapsed ? 'collapsed' : 'expanded');
+
+    // Smart expansion: if collapsing, check if neighbors should expand
+    if (dataPanelCollapsed) {
+        checkSmartExpansion('datatable-panel');
+    }
+}
+
+function togglePropertiesPanel() {
+    const panel = document.getElementById('controls-panel');
+    const collapseBtn = document.getElementById('btn-collapse-properties');
+    if (!panel) return;
+
+    propertiesPanelCollapsed = !propertiesPanelCollapsed;
+    panel.classList.toggle('collapsed', propertiesPanelCollapsed);
+
+    if (collapseBtn) {
+        collapseBtn.title = propertiesPanelCollapsed ? 'Expand panel' : 'Collapse panel';
+    }
+
+    // Persist state
+    localStorage.setItem('figrecipe_properties_collapsed', propertiesPanelCollapsed);
+
+    console.log('[PanelAccordion] Properties panel', propertiesPanelCollapsed ? 'collapsed' : 'expanded');
+
+    // Smart expansion: if collapsing, check if neighbors should expand
+    if (propertiesPanelCollapsed) {
+        checkSmartExpansion('controls-panel');
+    }
+}
+
+function togglePreviewPanel() {
+    const panel = document.getElementById('preview-panel');
+    const collapseBtn = document.getElementById('btn-collapse-preview');
+    if (!panel) return;
+
+    previewPanelCollapsed = !previewPanelCollapsed;
+    panel.classList.toggle('collapsed', previewPanelCollapsed);
+
+    if (collapseBtn) {
+        collapseBtn.title = previewPanelCollapsed ? 'Expand canvas' : 'Collapse canvas';
+    }
+
+    // Persist state
+    localStorage.setItem('figrecipe_preview_collapsed', previewPanelCollapsed);
+
+    console.log('[PanelAccordion] Preview panel', previewPanelCollapsed ? 'collapsed' : 'expanded');
+
+    // Smart expansion: if collapsing, check if neighbors should expand
+    if (previewPanelCollapsed) {
+        checkSmartExpansion('preview-panel');
+    }
+}
+
+function saveFileBrowserState() {
+    const panel = document.getElementById('file-browser-panel');
+    if (panel) {
+        const isCollapsed = panel.classList.contains('collapsed');
+        localStorage.setItem('figrecipe_filebrowser_collapsed', isCollapsed);
+    }
+}
+
+// Hook into existing toggleFileBrowser to save state
+const originalToggleFileBrowser = typeof window.toggleFileBrowser === 'function'
+    ? window.toggleFileBrowser
+    : null;
+
+window.toggleFileBrowser = function() {
+    if (originalToggleFileBrowser) {
+        originalToggleFileBrowser();
+    } else {
+        // Fallback implementation
+        const panel = document.getElementById('file-browser-panel');
+        const collapseBtn = document.getElementById('btn-collapse-browser');
+        if (!panel) return;
+
+        panel.classList.toggle('collapsed');
+        if (collapseBtn) {
+            const isCollapsed = panel.classList.contains('collapsed');
+            collapseBtn.innerHTML = isCollapsed ? '❯' : '❮';
+            collapseBtn.title = isCollapsed ? 'Expand panel' : 'Collapse panel';
+        }
+    }
+    saveFileBrowserState();
+
+    // Smart expansion: if collapsing, check if neighbors should expand
+    const panel = document.getElementById('file-browser-panel');
+    if (panel && panel.classList.contains('collapsed')) {
+        checkSmartExpansion('file-browser-panel');
+    }
+};
+
+// Initialize on DOM ready
+if (document.readyState === 'loading') {
+    document.addEventListener('DOMContentLoaded', initPanelAccordion);
+} else {
+    initPanelAccordion();
+}
+"""
+
+__all__ = ["SCRIPTS_ACCORDION"]
+
+# EOF