figpack 0.4.2__tar.gz → 0.4.4__tar.gz

{figpack-0.4.2/figpack.egg-info → figpack-0.4.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: figpack
-Version: 0.4.2
+Version: 0.4.4
 Summary: A Python package for creating shareable, interactive visualizations in the browser
 Author-email: Jeremy Magland <jmagland@flatironinstitute.org>
 License: Apache-2.0
@@ -72,6 +72,8 @@ Requires-Dist: sphinx-copybutton>=0.5; extra == "docs"
 Requires-Dist: lindi; extra == "docs"
 Requires-Dist: nibabel; extra == "docs"
 Requires-Dist: Pillow; extra == "docs"
+Requires-Dist: scikit-learn; extra == "docs"
+Requires-Dist: scipy; extra == "docs"
 Dynamic: license-file
 
 # figpack

{figpack-0.4.2 → figpack-0.4.4}/figpack/__init__.py

@@ -2,7 +2,7 @@
 figpack - A Python package for creating shareable, interactive visualizations in the browser
 """
 
-__version__ = "0.4.2"
+__version__ = "0.4.4"
 
 from .cli import view_figure
 from .core import FigpackView, FigpackExtension, ExtensionView

{figpack-0.4.2 → figpack-0.4.4}/figpack/core/_bundle_utils.py

@@ -80,7 +80,9 @@ def prepare_figure_bundle(
         view.write_to_zarr_group(zarr_group)
 
         # Add title and description and script as attributes on the top-level zarr group
-        zarr_group.attrs["title"] = title
+        # The figure title is stored separately from the root view's own "title"
+        # attribute (e.g. the title of a Box), so that it does not replace it
+        zarr_group.attrs["figure_title"] = title
         if description:
             zarr_group.attrs["description"] = description
         if script:

{figpack-0.4.2 → figpack-0.4.4}/figpack/core/_figure_spec.py

@@ -28,7 +28,7 @@ SPEC_SIZE_WARNING_CHARS = 20000
 _SPEC_LINE_WIDTH = 120
 
 # Props of the root node that belong to the figure rather than its root view
-_FIGURE_PROPS = {"title"}
+_FIGURE_PROPS = {"figure_title"}
 
 
 @dataclass
@@ -40,6 +40,70 @@ class SpecProp:
     description: str
 
 
+# Style keys shared by all views. A view's `style` attr holds any of them, and
+# it cascades: each view's effective style is its parent view's with its own
+# keys merged over it (figpack-figure/src/inheritedStyle.ts). A view ignores
+# the keys it does not use and lists the ones it uses in SpecSchema.style_keys.
+STYLE_KEYS: Dict[str, SpecProp] = {
+    p.name: p
+    for p in [
+        SpecProp("label_font_size", "number", "Axis label font size in pixels."),
+        SpecProp("tick_font_size", "number", "Tick label font size in pixels."),
+        SpecProp("legend_font_size", "number", "Legend text font size in pixels."),
+        SpecProp(
+            "font_family",
+            "string",
+            'CSS font family of all text, e.g. "serif" or "Georgia, serif".',
+        ),
+        SpecProp(
+            "text_color",
+            "string (CSS color)",
+            "Main text color: axis labels, major tick labels, legend text, captions and markdown text.",
+        ),
+        SpecProp(
+            "background_color",
+            "string (CSS color)",
+            "Background color of plot areas (and legends), captions, markdown and the active tab.",
+        ),
+        SpecProp(
+            "gridline_color",
+            "string (CSS color)",
+            "Color of the major gridlines and ticks.",
+        ),
+        SpecProp(
+            "minor_gridline_color",
+            "string (CSS color)",
+            "Color of the minor gridlines and ticks and of the time axis line.",
+        ),
+        SpecProp(
+            "title_font_size",
+            "number",
+            "Font size in pixels of layout item titles and tabs (defaults 12 and 14); a layout's own title is 2 px larger. Title bars and tab bars grow to fit.",
+        ),
+        SpecProp(
+            "title_color",
+            "string (CSS color)",
+            "Text color of layout title bars and tabs.",
+        ),
+        SpecProp(
+            "title_background_color",
+            "string (CSS color)",
+            "Background color of layout title bars and tab bars.",
+        ),
+        SpecProp(
+            "colormap",
+            '"viridis" | "plasma" | "inferno" | "magma" | "gray"',
+            'Colormap of heatmaps; add "_r" to reverse it (e.g. "gray_r").',
+        ),
+        SpecProp(
+            "border_color",
+            "string (CSS color)",
+            "Color of layout borders, splitter bars and caption borders.",
+        ),
+    ]
+}
+
+
 @dataclass
 class SpecSchema:
     """
@@ -50,6 +114,7 @@ class SpecSchema:
         "views": child groups are views (e.g. layouts); each uses its own schema
         "groups": child groups are configurable parts of this view (e.g. the
             series of a TimeseriesGraph), with props given by child_props
+    style_keys: the keys of STYLE_KEYS that the view uses
     """
 
     view_type: str
@@ -58,6 +123,7 @@ class SpecSchema:
     children: Literal["none", "views", "groups"] = "none"
     children_description: str = ""
     child_props: List[SpecProp] = field(default_factory=list)
+    style_keys: List[str] = field(default_factory=list)
 
 
 def get_spec_schemas() -> Dict[str, SpecSchema]:
@@ -113,6 +179,9 @@ def _build_view_node(group, schemas: Dict[str, SpecSchema]) -> Dict[str, Any]:
         return {}
     node: Dict[str, Any] = {}
     props = _select_props(group.attrs, schema.props)
+    # Any view may set a style, since it cascades to the views inside it
+    if group.attrs.get("style"):
+        props["style"] = group.attrs["style"]
     if props:
         node["props"] = props
     children = {}
@@ -171,10 +240,27 @@ def build_figure_spec_docs(
         '- data: path of a group in data.zarr for this node (e.g. "/item_0"), or null for a node defined only by the spec (then view_type is required). If omitted, the node uses its counterpart in the original figure: the root group, or the parent\'s subgroup with the same name.',
         "- view_type: the view type of the node.",
         "Only the props documented here are listed in the spec. Other attributes in data.zarr describe the stored data and should not be changed.",
-        "Root node: props.title (string) is the figure title.",
+        "Root node: props.figure_title (string) is the figure title.",
     ]
     view_types = _collect_view_types(zarr_group)
     documented = [vt for vt in view_types if vt in schemas]
+    style_users = {
+        key: [vt for vt in documented if key in schemas[vt].style_keys]
+        for key in STYLE_KEYS
+    }
+    if any(style_users.values()):
+        lines += [
+            "",
+            "## Style",
+            "",
+            "Any view node may set props.style to an object of the style keys below. It applies to that view and to every view inside it: styles merge key by key from the root down, and inner values win. Set it on the root node to style the whole figure. Views ignore keys they do not use.",
+            "Style keys:",
+        ]
+        lines += [
+            f"- {p.name} ({p.type}): {p.description} Used by: {', '.join(style_users[key])}."
+            for key, p in STYLE_KEYS.items()
+            if style_users[key]
+        ]
     for vt in documented:
         schema = schemas[vt]
         lines += ["", f"## {vt}", "", schema.description]
@@ -183,6 +269,8 @@ def build_figure_spec_docs(
             lines += [f"- {p.name} ({p.type}): {p.description}" for p in schema.props]
         else:
             lines.append("No configurable props.")
+        if schema.style_keys:
+            lines.append(f"Style keys: {', '.join(schema.style_keys)}.")
         if schema.children_description:
             lines.append(f"Children: {schema.children_description}")
         if schema.child_props:

{figpack-0.4.2 → figpack-0.4.4}/figpack/core/figpack_view.py

@@ -2,11 +2,13 @@
 Base view class for figpack visualization components
 """
 
+import functools
 import os
 import random
 import string
-from typing import TYPE_CHECKING, Optional
+from typing import TYPE_CHECKING, Any, Dict, Optional
 
+from ._figure_spec import STYLE_KEYS
 from .zarr import Group
 
 if TYPE_CHECKING:
@@ -18,6 +20,44 @@ class FigpackView:
     Base class for all figpack visualization components
     """
 
+    # Set with set_style(); replaced, never mutated, so the class default is safe
+    _style: Dict[str, Any] = {}
+
+    def __init_subclass__(cls, **kwargs):
+        super().__init_subclass__(**kwargs)
+        # Every view writes its style attr after its own attrs, without each
+        # write_to_zarr_group having to do it
+        write = cls.__dict__.get("write_to_zarr_group")
+        if write is None:
+            return
+
+        @functools.wraps(write)
+        def write_with_style(self, group: Group) -> None:
+            write(self, group)
+            if self._style:
+                group.attrs["style"] = dict(self._style)
+
+        cls.write_to_zarr_group = write_with_style
+
+    def set_style(self, **style: Any) -> "FigpackView":
+        """
+        Set style keys (e.g. label_font_size=16) for this view and every view
+        inside it. Views inside it inherit the keys unless they set their own.
+        Call it on the root view to style the whole figure. Keys given here are
+        merged over those set before.
+
+        Returns:
+            The view itself, so that calls can be chained
+        """
+        unknown = [k for k in style if k not in STYLE_KEYS]
+        if unknown:
+            raise ValueError(
+                f"Unknown style keys: {', '.join(unknown)}. "
+                f"Known keys: {', '.join(STYLE_KEYS)}"
+            )
+        self._style = {**self._style, **style}
+        return self
+
     def show(
         self,
         *,

figpack-0.4.4/figpack/figpack-figure-dist/assets/index-BdXsZMUB.css

@@ -0,0 +1 @@
+.unitEntryBase{padding-right:13px;padding-top:10px}.unselectedUnitEntry{border:1px transparent solid;font-weight:400;color:#000;background-color:#fff}.selectedUnitEntry{border:1px solid blue;font-weight:700;color:#000;background-color:#b5d1ff}.unitIdsColumnLabelStyle{min-width:200px;font-weight:700;padding:7px 5px}.unitLabelsStyle{padding-right:3px;color:#333}.plotUnitLabel{text-align:left;margin-left:20px;margin-top:5px;font-weight:700}.plotWrapperButtonParent{display:inline-block}.plotWrapperStyleButton{padding-top:50px}.plotUnselectedStyle{border:3px solid rgb(202,224,231)}.plotSelectedStyle{border:3px solid #9999ff;background-color:#fff}.plotUnselectableStyle{border:3px solid transparent}.plotCurrentStyle{border:3px solid blue;background-color:#fff}.plotLabelStyle{font-weight:700;text-align:center;overflow:hidden;white-space:nowrap}.figpack-markdown table{border-collapse:collapse;margin:.8em 0}.figpack-markdown th,.figpack-markdown td{border:1px solid #d0d7de;padding:4px 12px}.figpack-markdown th{background-color:#7f7f7f14}.figpack-markdown blockquote{margin:.8em 0;padding:0 1em;border-left:4px solid #d0d7de;opacity:.85}.figpack-markdown math[display=block]{margin:.8em 0;font-size:1.15em}:root{font-family:system-ui,Avenir,Helvetica,Arial,sans-serif;line-height:1.5;font-weight:400;color:#213547;background-color:#fff;font-synthesis:none;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}a{font-weight:500;color:#646cff;text-decoration:inherit}a:hover{color:#747bff}body{margin:0;overflow:hidden}h1{font-size:3.2em;line-height:1.1}button{border-radius:8px;border:1px solid transparent;padding:.6em 1.2em;font-size:1em;font-weight:500;font-family:inherit;background-color:#f9f9f9;cursor:pointer;transition:border-color .25s}button:hover{border-color:#646cff}button:focus,button:focus-visible{outline:4px auto -webkit-focus-ring-color}.status-bar{position:fixed;left:0;right:0;height:30px;background-color:#f5f5f5;color:#333;display:flex;align-items:center;padding:0 12px;font-size:12px;border-top:1px solid #ddd;z-index:1000}.status-bar.warning{background-color:#fff3cd;color:#856404;border-top:1px solid #ffeaa7}.status-bar.error,.status-bar.expired{background-color:#f8d7da;color:#721c24;border-top:1px solid #f5c6cb}.manage-button{background-color:#e0e0e0;color:#333;border:1px solid #ccc;padding:4px 8px;border-radius:4px;cursor:pointer;font-size:11px;height:22px;margin-left:12px;transition:background-color .2s}.manage-button:hover{background-color:#d0d0d0}.about-button{background-color:#e0e0e0;color:#333;border:1px solid #ccc;padding:4px 8px;border-radius:4px;cursor:pointer;font-size:11px;height:22px;margin-left:12px;transition:background-color .2s}.about-button:hover{background-color:#d0d0d0}.share-button{background-color:#e0e0e0;color:#333;border:1px solid #ccc;padding:4px 8px;border-radius:4px;cursor:pointer;font-size:11px;height:22px;margin-left:12px;transition:background-color .2s;display:flex;align-items:center;gap:4px}.share-button:hover{background-color:#d0d0d0}.about-dialog-overlay{position:fixed;inset:0;background-color:#00000080;display:flex;justify-content:center;align-items:center;z-index:2000}.about-dialog{background-color:#fff;color:#333;border-radius:8px;max-width:600px;max-height:80vh;width:90%;box-shadow:0 4px 20px #00000026;overflow:hidden}.about-dialog-header{display:flex;justify-content:space-between;align-items:center;padding:16px 20px;border-bottom:1px solid #ddd}.about-dialog-header h2{margin:0;font-size:18px;font-weight:600}.about-dialog-close{background:none;border:none;color:#333;font-size:24px;cursor:pointer;padding:0;width:30px;height:30px;display:flex;align-items:center;justify-content:center;border-radius:4px;transition:background-color .2s}.about-dialog-close:hover{background-color:#f0f0f0}.about-dialog-content{padding:20px;overflow-y:auto;max-height:calc(80vh - 80px)}.about-dialog-description{line-height:1.6}.about-dialog-provenance{margin-top:0;margin-bottom:12px;font-size:.9em;color:#555;overflow-wrap:anywhere}.about-dialog-description h1,.about-dialog-description h2,.about-dialog-description h3{margin-top:0;margin-bottom:12px}.about-dialog-description p{margin-bottom:12px}.about-dialog-description code{background-color:#f5f5f5;color:#333;padding:2px 4px;border-radius:3px;font-family:Courier New,monospace;font-size:.9em}.about-dialog-description pre{background-color:#f5f5f5;color:#333;padding:12px;border-radius:4px;overflow-x:auto;margin-bottom:12px}.about-dialog-description ul,.about-dialog-description ol{margin-bottom:12px;padding-left:20px}.about-dialog-description blockquote{border-left:4px solid #ccc;padding-left:16px;margin:12px 0;font-style:italic}.manage-edits-view{display:flex;align-items:center;margin-left:12px}.edits-notification{color:#e65100;font-weight:500;margin-right:8px}.save-changes-button{background-color:#ff9800;color:#fff;border:1px solid #f57c00;padding:4px 8px;border-radius:4px;cursor:pointer;font-size:11px;height:22px;transition:background-color .2s}.save-changes-button:hover{background-color:#f57c00}.dialog-overlay{position:fixed;inset:0;background-color:#00000080;display:flex;justify-content:center;align-items:center;z-index:2000}.dialog-content{background-color:#fff;color:#333;border-radius:8px;max-width:500px;width:90%;box-shadow:0 4px 20px #00000026;overflow:hidden}.dialog-header{display:flex;justify-content:space-between;align-items:center;padding:16px 20px;border-bottom:1px solid #ddd}.dialog-header h3{margin:0;font-size:18px;font-weight:600}.dialog-close{background:none;border:none;color:#333;font-size:24px;cursor:pointer;padding:0;width:30px;height:30px;display:flex;align-items:center;justify-content:center;border-radius:4px;transition:background-color .2s}.dialog-close:hover{background-color:#f0f0f0}.dialog-body{padding:20px}.dialog-body p{margin:0 0 12px;line-height:1.5}.dialog-footer{padding:16px 20px;border-top:1px solid #ddd;display:flex;justify-content:flex-end}.dialog-button{background-color:#e0e0e0;color:#333;border:1px solid #ccc;padding:8px 16px;border-radius:4px;cursor:pointer;font-size:14px;transition:background-color .2s}.dialog-button:hover{background-color:#d0d0d0}.dialog-fullscreen{position:fixed;inset:0;background-color:#fff;color:#333;z-index:2000;display:flex;flex-direction:column}.dialog-content-fullscreen{display:flex;flex-direction:column;height:100%;overflow:hidden}.dialog-content-fullscreen .dialog-header{flex-shrink:0}.dialog-content-fullscreen .dialog-body{flex:1;overflow-y:auto;padding:20px}.dialog-content-fullscreen .dialog-footer{flex-shrink:0}