staticdash 2026.2__tar.gz → 2026.4__tar.gz

{staticdash-2026.2 → staticdash-2026.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: staticdash
-Version: 2026.2
+Version: 2026.4
 Summary: A lightweight static HTML dashboard generator with Plotly and pandas support.
 Author-email: Brian Day <brian.day1@gmail.com>
 License: CC0-1.0
@@ -11,9 +11,11 @@ Description-Content-Type: text/markdown
 Requires-Dist: plotly
 Requires-Dist: pandas
 Requires-Dist: dominate
-Requires-Dist: reportlab
-Requires-Dist: kaleido
 Requires-Dist: matplotlib
+Provides-Extra: images
+Requires-Dist: kaleido; extra == "images"
+Provides-Extra: all
+Requires-Dist: kaleido; extra == "all"
 
 # staticdash
 

{staticdash-2026.2 → staticdash-2026.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "staticdash"
-version = "2026.2"
+version = "2026.4"
 description = "A lightweight static HTML dashboard generator with Plotly and pandas support."
 authors = [
     { name = "Brian Day", email = "brian.day1@gmail.com" }
@@ -13,14 +13,21 @@ license = { text = "CC0-1.0" }
 readme = "README.md"
 requires-python = ">=3.8"
 dependencies = [
-    "plotly",
-    "pandas",
-    "dominate",
-    "reportlab",
-    "kaleido",
-    "matplotlib"
+  "plotly",
+  "pandas",
+  "dominate",
+  "matplotlib",
 ]
 
+[project.optional-dependencies]
+# Optional plotting backends and export tools
+images = ["kaleido"]
+# PDF export (reportlab) was removed from defaults because it's not referenced from the package code.
+# If you need PDF export, add reportlab explicitly: `pip install "staticdash[pdf]"` once the feature is implemented.
+
+# Convenience bundle for full feature set
+all = ["kaleido"]
+
 [tool.setuptools]
 packages = ["staticdash"]
 

{staticdash-2026.2 → staticdash-2026.4}/staticdash/dashboard.py

@@ -10,8 +10,38 @@ from dominate.util import raw as raw_util
 import html
 import io
 import base64
+import matplotlib
 from matplotlib import rc_context
 
+def split_paragraphs_preserving_math(text):
+    """
+    Split text into paragraphs on double newlines, preserving math expressions.
+    Assumes math is in $...$ (inline) or $$...$$ (display) format.
+    """
+    math_blocks = []
+    
+    # Replace math with placeholders
+    def replace_math(match):
+        math_blocks.append(match.group(0))
+        return f"__MATH_BLOCK_{len(math_blocks)-1}__"
+    
+    # Handle display math first ($$...$$), then inline ($...$)
+    text = re.sub(r'\$\$([^$]+)\$\$', replace_math, text, flags=re.DOTALL)
+    text = re.sub(r'\$([^$]+)\$', replace_math, text, flags=re.DOTALL)
+    
+    # Split on double newlines
+    paragraphs = text.split('\n\n')
+    
+    # Restore math in each paragraph
+    restored_paragraphs = []
+    for para in paragraphs:
+        for i, block in enumerate(math_blocks):
+            para = para.replace(f"__MATH_BLOCK_{i}__", block)
+        restored_paragraphs.append(para.strip())
+    
+    # Filter out empty paragraphs
+    return [para for para in restored_paragraphs if para]
+
 class AbstractPage:
     def __init__(self):
         self.elements = []
@@ -24,8 +54,13 @@ class AbstractPage:
     def add_text(self, text, width=None):
         self.elements.append(("text", text, width))
 
-    def add_plot(self, plot, width=None):
-        self.elements.append(("plot", plot, width))
+    def add_plot(self, plot, width=None, height=None, width_px=None, align="center"):
+        # Keep backward-compatible: `width` is a fraction (0..1) of page width.
+        # `height` is pixels (existing behavior). New optional `width_px`
+        # (pixels) can be supplied to control plot width. `align` controls
+        # horizontal alignment: 'left', 'center' (default), or 'right'.
+        # We store a tuple (plot, height_px, width_px, align) for forward-compatibility.
+        self.elements.append(("plot", (plot, height, width_px, align), width))
 
     def add_table(self, df, table_id=None, sortable=True, width=None):
         self.elements.append(("table", df, width))
@@ -111,13 +146,33 @@ class Page(AbstractPage):
                 outer_style = "display: flex; justify-content: center; margin: 0 auto;"
             elem = None
             if kind == "text":
-                elem = p(content)
+                paragraphs = split_paragraphs_preserving_math(content)
+                if paragraphs:
+                    elem = div(*[p(para) for para in paragraphs])
+                else:
+                    elem = p(content)
             elif kind == "header":
                 text, level = content
                 header_tag = {1: h1, 2: h2, 3: h3, 4: h4}[level]
                 elem = header_tag(text)
             elif kind == "plot":
-                fig = content
+                # content may be stored as (figure, height), (figure, height, width_px)
+                # or (figure, height, width_px, align)
+                specified_height = None
+                specified_width_px = None
+                specified_align = "center"
+                if isinstance(content, (list, tuple)):
+                    if len(content) == 4:
+                        fig, specified_height, specified_width_px, specified_align = content
+                    elif len(content) == 3:
+                        fig, specified_height, specified_width_px = content
+                    elif len(content) == 2:
+                        fig, specified_height = content
+                    else:
+                        fig = content
+                else:
+                    fig = content
+
                 if hasattr(fig, "to_html"):
                     # Use local Plotly loaded in <head>
                     # Ensure the figure uses a robust font family so minus signs and other
@@ -131,28 +186,128 @@ class Page(AbstractPage):
                     except Exception:
                         # Be defensive: don't fail rendering if layout manipulation isn't available
                         pass
-                    # Render Plotly HTML and replace Unicode minus (U+2212) with ASCII hyphen-minus
-                    # to avoid rendering issues when a user's font lacks the U+2212 glyph.
+
                     try:
-                        plotly_html = fig.to_html(full_html=False, include_plotlyjs=False, config={'responsive': True})
-                        elem = div(raw_util(plotly_html))
+                        # Temporarily set layout height/width if specified (pixels)
+                        orig_height = None
+                        orig_width = None
+                        try:
+                            orig_height = getattr(fig.layout, 'height', None)
+                        except Exception:
+                            orig_height = None
+                        try:
+                            orig_width = getattr(fig.layout, 'width', None)
+                        except Exception:
+                            orig_width = None
+
+                        try:
+                            if specified_height is not None:
+                                fig.update_layout(height=specified_height)
+                            if specified_width_px is not None:
+                                fig.update_layout(width=specified_width_px)
+                        except Exception:
+                            pass
+
+                        # If a local vendored Plotly exists, rely on the head script.
+                        # Otherwise include Plotly from CDN so the inline newPlot call works.
+                        vendor_plotly = os.path.join(os.path.dirname(__file__), "assets", "vendor", "plotly", "plotly.min.js")
+                        include_plotly = False
+                        if not os.path.exists(vendor_plotly):
+                            include_plotly = "cdn"
+                        plotly_html = fig.to_html(full_html=False, include_plotlyjs=include_plotly, config={'responsive': True})
+
+                        # Wrap the Plotly HTML in a container with explicit pixel sizing
+                        container_style = "width:100%;"
+                        if specified_width_px is not None:
+                            container_style = f"width:{specified_width_px}px;"
+                        if specified_height is not None:
+                            container_style = container_style + f" height:{specified_height}px;"
+
+                        plot_wrapped = f'<div style="{container_style}">{plotly_html}</div>'
+                        # Apply alignment wrapper
+                        if specified_align not in ("left", "right", "center"):
+                            specified_align = "center"
+                        if specified_align == "center":
+                            align_style = "display:flex; justify-content:center; align-items:center;"
+                        elif specified_align == "left":
+                            align_style = "display:flex; justify-content:flex-start; align-items:center;"
+                        else:
+                            align_style = "display:flex; justify-content:flex-end; align-items:center;"
+
+                        outer = f'<div style="{align_style}">{plot_wrapped}</div>'
+                        elem = div(raw_util(outer))
+
+                        # restore original height/width if we changed them
+                        try:
+                            if specified_height is not None:
+                                fig.update_layout(height=orig_height)
+                            if specified_width_px is not None:
+                                fig.update_layout(width=orig_width)
+                        except Exception:
+                            pass
                     except Exception as e:
                         elem = div(f"Plotly figure could not be rendered: {e}")
                 else:
+                    # Robust Matplotlib -> PNG path. Ensure `buf` exists and is closed.
+                    buf = io.BytesIO()
                     try:
-                        buf = io.BytesIO()
-                        # Ensure we use ASCII hyphen-minus for negative ticks when saving
+                        # If pixel width/height specified, attempt to adjust figure size
+                        orig_size = None
+                        try:
+                            dpi = fig.get_dpi()
+                        except Exception:
+                            dpi = None
+                        try:
+                            if dpi is not None and (specified_height is not None or specified_width_px is not None):
+                                orig_size = fig.get_size_inches()
+                                new_w = orig_size[0]
+                                new_h = orig_size[1]
+                                if specified_width_px is not None:
+                                    new_w = specified_width_px / dpi
+                                if specified_height is not None:
+                                    new_h = specified_height / dpi
+                                fig.set_size_inches(new_w, new_h)
+                        except Exception:
+                            orig_size = None
+
                         with rc_context({"axes.unicode_minus": False}):
                             fig.savefig(buf, format="png", bbox_inches="tight")
+
+                        # restore original size if changed
+                        try:
+                            if orig_size is not None:
+                                fig.set_size_inches(orig_size)
+                        except Exception:
+                            pass
+
                         buf.seek(0)
                         img_base64 = base64.b64encode(buf.read()).decode("utf-8")
-                        buf.close()
+                        img_style = "max-width:100%;"
+                        if specified_height is not None:
+                            img_style = img_style + f" height:{specified_height}px;"
+                        if specified_width_px is not None:
+                            img_style = img_style + f" width:{specified_width_px}px;"
+
+                        if specified_align not in ("left", "right", "center"):
+                            specified_align = "center"
+                        if specified_align == "center":
+                            align_style = "display:flex; justify-content:center; align-items:center;"
+                        elif specified_align == "left":
+                            align_style = "display:flex; justify-content:flex-start; align-items:center;"
+                        else:
+                            align_style = "display:flex; justify-content:flex-end; align-items:center;"
+
                         elem = div(
-                            raw_util(f'<img src="data:image/png;base64,{img_base64}" style="max-width:100%;">'),
-                            style="display: flex; justify-content: center; align-items: center;"
+                            raw_util(f'<img src="data:image/png;base64,{img_base64}" style="{img_style}">'),
+                            style=align_style
                         )
                     except Exception as e:
                         elem = div(f"Matplotlib figure could not be rendered: {e}")
+                    finally:
+                        try:
+                            buf.close()
+                        except Exception:
+                            pass
             elif kind == "table":
                 df = content
                 try:
@@ -213,13 +368,29 @@ class MiniPage(AbstractPage):
                 outer_style = "display: flex; justify-content: center; margin: 0 auto;"
             elem = None
             if kind == "text":
-                elem = p(content)
+                paragraphs = split_paragraphs_preserving_math(content)
+                if paragraphs:
+                    elem = div(*[p(para) for para in paragraphs])
+                else:
+                    elem = p(content)
             elif kind == "header":
                 text, level = content
                 header_tag = {1: h1, 2: h2, 3: h3, 4: h4}[level]
                 elem = header_tag(text)
             elif kind == "plot":
-                fig = content
+                # content may be stored as (figure, height) or (figure, height, width_px)
+                specified_height = None
+                specified_width_px = None
+                if isinstance(content, (list, tuple)):
+                    if len(content) == 3:
+                        fig, specified_height, specified_width_px = content
+                    elif len(content) == 2:
+                        fig, specified_height = content
+                    else:
+                        fig = content
+                else:
+                    fig = content
+
                 if hasattr(fig, "to_html"):
                     # Use local Plotly loaded in <head>
                     # Ensure the figure uses a robust font family so minus signs and other
@@ -233,25 +404,115 @@ class MiniPage(AbstractPage):
                     except Exception:
                         pass
                     try:
-                        plotly_html = fig.to_html(full_html=False, include_plotlyjs=False, config={'responsive': True})
-                        elem = div(raw_util(plotly_html))
+                        orig_height = None
+                        orig_width = None
+                        try:
+                            orig_height = getattr(fig.layout, 'height', None)
+                        except Exception:
+                            orig_height = None
+                        try:
+                            orig_width = getattr(fig.layout, 'width', None)
+                        except Exception:
+                            orig_width = None
+
+                        try:
+                            if specified_height is not None:
+                                fig.update_layout(height=specified_height)
+                            if specified_width_px is not None:
+                                fig.update_layout(width=specified_width_px)
+                        except Exception:
+                            pass
+
+                        vendor_plotly = os.path.join(os.path.dirname(__file__), "assets", "vendor", "plotly", "plotly.min.js")
+                        include_plotly = False
+                        if not os.path.exists(vendor_plotly):
+                            include_plotly = "cdn"
+                        plotly_html = fig.to_html(full_html=False, include_plotlyjs=include_plotly, config={'responsive': True})
+                        container_style = "width:100%;"
+                        if specified_width_px is not None:
+                            container_style = f"width:{specified_width_px}px;"
+                        if specified_height is not None:
+                            container_style = container_style + f" height:{specified_height}px;"
+                        plot_wrapped = f'<div style="{container_style}">{plotly_html}</div>'
+                        if specified_align not in ("left", "right", "center"):
+                            specified_align = "center"
+                        if specified_align == "center":
+                            align_style = "display:flex; justify-content:center; align-items:center;"
+                        elif specified_align == "left":
+                            align_style = "display:flex; justify-content:flex-start; align-items:center;"
+                        else:
+                            align_style = "display:flex; justify-content:flex-end; align-items:center;"
+                        outer = f'<div style="{align_style}">{plot_wrapped}</div>'
+                        elem = div(raw_util(outer))
+
+                        try:
+                            if specified_height is not None:
+                                fig.update_layout(height=orig_height)
+                            if specified_width_px is not None:
+                                fig.update_layout(width=orig_width)
+                        except Exception:
+                            pass
                     except Exception as e:
                         elem = div(f"Plotly figure could not be rendered: {e}")
                 else:
+                    # Robust Matplotlib -> PNG path. Ensure `buf` exists and is closed.
+                    buf = io.BytesIO()
                     try:
-                        buf = io.BytesIO()
-                        # Ensure we use ASCII hyphen-minus for negative ticks when saving
+                        # If pixel width/height specified, attempt to adjust figure size
+                        orig_size = None
+                        try:
+                            dpi = fig.get_dpi()
+                        except Exception:
+                            dpi = None
+                        try:
+                            if dpi is not None and (specified_height is not None or specified_width_px is not None):
+                                orig_size = fig.get_size_inches()
+                                new_w = orig_size[0]
+                                new_h = orig_size[1]
+                                if specified_width_px is not None:
+                                    new_w = specified_width_px / dpi
+                                if specified_height is not None:
+                                    new_h = specified_height / dpi
+                                fig.set_size_inches(new_w, new_h)
+                        except Exception:
+                            orig_size = None
+
                         with rc_context({"axes.unicode_minus": False}):
                             fig.savefig(buf, format="png", bbox_inches="tight")
+
+                        # restore original size if changed
+                        try:
+                            if orig_size is not None:
+                                fig.set_size_inches(orig_size)
+                        except Exception:
+                            pass
+
                         buf.seek(0)
                         img_base64 = base64.b64encode(buf.read()).decode("utf-8")
-                        buf.close()
+                        img_style = "max-width:100%;"
+                        if specified_height is not None:
+                            img_style = img_style + f" height:{specified_height}px;"
+                        if specified_width_px is not None:
+                            img_style = img_style + f" width:{specified_width_px}px;"
+                        if specified_align not in ("left", "right", "center"):
+                            specified_align = "center"
+                        if specified_align == "center":
+                            align_style = "display:flex; justify-content:center; align-items:center;"
+                        elif specified_align == "left":
+                            align_style = "display:flex; justify-content:flex-start; align-items:center;"
+                        else:
+                            align_style = "display:flex; justify-content:flex-end; align-items:center;"
                         elem = div(
-                            raw_util(f'<img src="data:image/png;base64,{img_base64}" style="max-width:100%;">'),
-                            style="display: flex; justify-content: center; align-items: center;"
+                            raw_util(f'<img src="data:image/png;base64,{img_base64}" style="{img_style}">'),
+                            style=align_style
                         )
                     except Exception as e:
                         elem = div(f"Matplotlib figure could not be rendered: {e}")
+                    finally:
+                        try:
+                            buf.close()
+                        except Exception:
+                            pass
             elif kind == "table":
                 df = content
                 html_table = df.to_html(classes="table-hover table-striped", index=False, border=0, table_id=f"table-{index}", escape=False)

{staticdash-2026.2 → staticdash-2026.4}/staticdash.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: staticdash
-Version: 2026.2
+Version: 2026.4
 Summary: A lightweight static HTML dashboard generator with Plotly and pandas support.
 Author-email: Brian Day <brian.day1@gmail.com>
 License: CC0-1.0
@@ -11,9 +11,11 @@ Description-Content-Type: text/markdown
 Requires-Dist: plotly
 Requires-Dist: pandas
 Requires-Dist: dominate
-Requires-Dist: reportlab
-Requires-Dist: kaleido
 Requires-Dist: matplotlib
+Provides-Extra: images
+Requires-Dist: kaleido; extra == "images"
+Provides-Extra: all
+Requires-Dist: kaleido; extra == "all"
 
 # staticdash
 

{staticdash-2026.2 → staticdash-2026.4}/staticdash.egg-info/requires.txt

@@ -1,6 +1,10 @@
 plotly
 pandas
 dominate
-reportlab
-kaleido
 matplotlib
+
+[all]
+kaleido
+
+[images]
+kaleido