From 7c098d080151f1263865de60b00111ff0d054252 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Wed, 20 Aug 2025 11:43:47 -0500
Subject: [PATCH 001/167] Create async iter wrapper to simplify loops

---
 src/py/kaleido/_utils.py | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/src/py/kaleido/_utils.py b/src/py/kaleido/_utils.py
index 052f79b9..1c7c24cb 100644
--- a/src/py/kaleido/_utils.py
+++ b/src/py/kaleido/_utils.py
@@ -10,6 +10,25 @@
 _logger = logistro.getLogger(__name__)
 
 
+def ensure_async_iter(obj):
+    if hasattr(obj, "__aiter__"):
+        return obj
+
+    it = iter(obj)
+
+    class _AIter:
+        def __aiter__(self):
+            return self
+
+        async def __anext__(self):
+            try:
+                return next(it)
+            except StopIteration:
+                raise StopAsyncIteration  # noqa: B904
+
+    return _AIter()
+
+
 async def to_thread(func, *args, **kwargs):
     _loop = asyncio.get_running_loop()
     fn = partial(func, *args, **kwargs)

From 3c94ef045a7f869dc8aa10f68ae3ad25d0aa5e2a Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Wed, 20 Aug 2025 11:49:39 -0500
Subject: [PATCH 002/167] Simplify loop w/ new wrapper.

---
 src/py/kaleido/kaleido.py | 78 ++++++++++++++++++---------------------
 1 file changed, 36 insertions(+), 42 deletions(-)

diff --git a/src/py/kaleido/kaleido.py b/src/py/kaleido/kaleido.py
index a79cbec5..74fa8c42 100644
--- a/src/py/kaleido/kaleido.py
+++ b/src/py/kaleido/kaleido.py
@@ -16,7 +16,7 @@
 from ._fig_tools import _is_figurish, build_fig_spec
 from ._kaleido_tab import _KaleidoTab
 from ._page_generator import PageGenerator
-from ._utils import ErrorEntry, warn_incompatible_plotly
+from ._utils import ErrorEntry, ensure_async_iter, warn_incompatible_plotly
 
 _logger = logistro.getLogger(__name__)
 
@@ -347,7 +347,7 @@ async def calc_fig(
         await self._return_kaleido_tab(tab)
         return data[0]
 
-    async def write_fig(  # noqa: PLR0913, C901 (too many args, complexity)
+    async def write_fig(  # noqa: PLR0913 (too many args)
         self,
         fig,
         path=None,
@@ -440,7 +440,7 @@ async def _loop(f):
         finally:
             self._main_tasks.remove(main_task)
 
-    async def write_fig_from_object(  # noqa: C901 too complex
+    async def write_fig_from_object(
         self,
         generator,
         *,
@@ -487,48 +487,42 @@ async def write_fig_from_object(  # noqa: C901 too complex
         self._main_tasks.add(main_task)
         tasks = set()
 
-        async def _loop(args):
-            spec, full_path = build_fig_spec(
-                args.pop("fig"),
-                args.pop("path", None),
-                args.pop("opts", None),
-            )
-            args["spec"] = spec
-            args["full_path"] = full_path
-            tab = await self._get_kaleido_tab()
-            if profiler is not None and tab.tab.target_id not in profiler:
-                profiler[tab.tab.target_id] = []
-            t = asyncio.create_task(
-                self._render_task(
-                    tab,
-                    args=args,
-                    error_log=error_log,
-                    profiler=profiler,
-                ),
-            )
-            t.add_done_callback(
-                partial(
-                    self._check_render_task,
-                    full_path.name,
-                    tab,
-                    main_task,
-                    error_log,
-                ),
-            )
-            tasks.add(t)
-
         try:
-            if hasattr(generator, "__aiter__"):  # is async iterable
-                _logger.debug("Is async for")
-                async for args in generator:
-                    await _loop(args)
-            else:
-                _logger.debug("Is sync for")
-                for args in generator:
-                    await _loop(args)
-            _logger.debug("awaiting tasks")
+            async for args in ensure_async_iter(generator):
+                args["spec"], args["full_path"] = build_fig_spec(
+                    args.pop("fig"),
+                    args.pop("path", None),
+                    args.pop("opts", None),
+                )
+
+                tab = await self._get_kaleido_tab()
+
+                if profiler is not None and tab.tab.target_id not in profiler:
+                    profiler[tab.tab.target_id] = []
+
+                t = asyncio.create_task(
+                    self._render_task(
+                        tab,
+                        args=args,
+                        error_log=error_log,
+                        profiler=profiler,
+                    ),
+                )
+                t.add_done_callback(
+                    partial(
+                        self._check_render_task,
+                        args["full_path"].name,
+                        tab,
+                        main_task,
+                        error_log,
+                    ),
+                )
+                tasks.add(t)
+
             await asyncio.gather(*tasks, return_exceptions=True)
+            # This here would include errors during the tasks?
         except:
+            # This would only catch errors in the machinery, not the task
             _logger.exception("Cleaning tasks after error.")
             for task in tasks:
                 if not task.done():

From 056206aef0dcdc23f581a797431b4703b9d7fdf2 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Wed, 20 Aug 2025 21:36:15 -0500
Subject: [PATCH 003/167] Refactor kaleido.py:

Refactors often touch a lot of parts, and this is a pretty big refactor.
We reduce code deplication, improve errors and logic, and simply task
management.
---
 src/py/kaleido/_page_generator.py |  16 +-
 src/py/kaleido/_utils.py          |  54 ++-
 src/py/kaleido/kaleido.py         | 543 ++++++++----------------------
 3 files changed, 171 insertions(+), 442 deletions(-)

diff --git a/src/py/kaleido/_page_generator.py b/src/py/kaleido/_page_generator.py
index cda04aff..beb6bd50 100644
--- a/src/py/kaleido/_page_generator.py
+++ b/src/py/kaleido/_page_generator.py
@@ -108,14 +108,8 @@ def __init__(self, *, plotly=None, mathjax=None, others=None, force_cdn=False):
                 _ensure_path(o)
             self._scripts.extend(others)
 
-    def generate_index(self, path=None):
-        """
-        Generate the page.
-
-        Args:
-            path: If specified, page is written to path. Otherwise it is returned.
-
-        """
+    def generate_index(self):
+        """Generate the page."""
         page = self.header
         script_tag = '\n        <script src="%s"></script>'
         script_tag_charset = '\n        <script src="%s" charset="%s"></script>'
@@ -126,8 +120,4 @@ def generate_index(self, path=None):
                 page += script_tag_charset % script
         page += self.footer
         _logger.debug2(page)
-        if not path:
-            return page
-        with (path).open("w") as f:
-            f.write(page)
-        return path.as_uri()
+        return page
diff --git a/src/py/kaleido/_utils.py b/src/py/kaleido/_utils.py
index 1c7c24cb..ba886a36 100644
--- a/src/py/kaleido/_utils.py
+++ b/src/py/kaleido/_utils.py
@@ -1,5 +1,4 @@
 import asyncio
-import traceback
 import warnings
 from functools import partial
 from importlib.metadata import PackageNotFoundError, version
@@ -10,7 +9,32 @@
 _logger = logistro.getLogger(__name__)
 
 
+def event_printer(name):
+    """Return function that prints whatever argument received."""
+
+    async def print_all(response):
+        _logger.debug2(f"{name!s}:{response!s}")
+
+    return print_all
+
+
+def _clean_error(t: asyncio.Task) -> None:
+    """Check a task to avoid "task never awaited" errors."""
+    if t.cancelled():
+        _logger.error(f"{t} cancelled.")
+    elif (exc := t.exception()) is not None:
+        _logger.error(f"{t} raised error.", exc_info=exc)
+
+
+def create_task_log_error(coroutine) -> asyncio.Task:
+    """Create a task and assign a callback to log its errors."""
+    t = asyncio.create_task(coroutine)
+    t.add_done_callback(_clean_error)
+    return t
+
+
 def ensure_async_iter(obj):
+    """Convert any iterable to an async iterator."""
     if hasattr(obj, "__aiter__"):
         return obj
 
@@ -30,6 +54,7 @@ async def __anext__(self):
 
 
 async def to_thread(func, *args, **kwargs):
+    """Polyfill `asyncio.to_thread()`."""
     _loop = asyncio.get_running_loop()
     fn = partial(func, *args, **kwargs)
     await _loop.run_in_executor(None, fn)
@@ -68,30 +93,3 @@ def warn_incompatible_plotly():
         # Since this compatibility check is just a convenience,
         # we don't want to block the whole library if there's an issue
         _logger.info("Error while checking Plotly version.", exc_info=e)
-
-
-class ErrorEntry:
-    """A simple object to record errors and context."""
-
-    def __init__(self, name, error, javascript_log):
-        """
-        Construct an error entry.
-
-        Args:
-            name: the name of the image with the error
-            error: the error object (from class BaseException)
-            javascript_log: an array of entries from the javascript console
-
-        """
-        self.name = name
-        self.error = error
-        self.javascript_log = javascript_log
-
-    def __str__(self):
-        """Display the error object in a concise way."""
-        ret = f"{self.name}:\n"
-        e = self.error
-        ret += " ".join(traceback.format_exception(type(e), e, e.__traceback__))
-        ret += " javascript Log:\n"
-        ret += "\n ".join(self.javascript_log)
-        return ret
diff --git a/src/py/kaleido/kaleido.py b/src/py/kaleido/kaleido.py
index 74fa8c42..446c8d8f 100644
--- a/src/py/kaleido/kaleido.py
+++ b/src/py/kaleido/kaleido.py
@@ -3,124 +3,57 @@
 from __future__ import annotations
 
 import asyncio
-import warnings
 from collections.abc import Iterable
-from functools import partial
 from pathlib import Path
+from urllib.parse import urlparse
 
 import choreographer as choreo
 import logistro
 from choreographer.errors import ChromeNotFoundError
 from choreographer.utils import TmpDirectory
 
+from . import _utils
 from ._fig_tools import _is_figurish, build_fig_spec
 from ._kaleido_tab import _KaleidoTab
 from ._page_generator import PageGenerator
-from ._utils import ErrorEntry, ensure_async_iter, warn_incompatible_plotly
 
 _logger = logistro.getLogger(__name__)
 
 # Show a warning if the installed Plotly version
 # is incompatible with this version of Kaleido
-warn_incompatible_plotly()
-
-
-def _make_printer(name):
-    """Create event printer for generic events. Helper function."""
-
-    async def print_all(response):
-        _logger.debug2(f"{name}:{response}")
-
-    return print_all
+_utils.warn_incompatible_plotly()
 
 
 class Kaleido(choreo.Browser):
-    """
-    Kaleido manages a set of image processors.
-
-    It can be used as a context (`async with Kaleido(...)`), but can
-    also be used like:
-
-    ```
-    k = Kaleido(...)
-    k = await Kaleido.open()
-    ... # do stuff
-    k.close()
-    ```
-    """
-
     _tabs_ready: asyncio.Queue[_KaleidoTab]
-    _background_render_tasks: set[asyncio.Task]
-    # not really render tasks
-    _main_tasks: set[asyncio.Task]
+    _tab_requeue_tasks: set[asyncio.Task]
+    _main_render_coroutines: set[asyncio.Task]
+    # technically Tasks, user sees coroutines
 
-    async def close(self):
-        """Close the browser."""
-        if self._tmp_dir:
-            self._tmp_dir.clean()
-        _logger.info("Cancelling tasks.")
-        for task in self._main_tasks:
-            if not task.done():
-                task.cancel()
-        for task in self._background_render_tasks:
-            if not task.done():
-                task.cancel()
-        _logger.info("Exiting Kaleido/Choreo")
-        return await super().close()
+    _total_tabs: int
+    _html_tmp_dir: None | TmpDirectory
 
-    async def __aexit__(self, exc_type, exc_value, exc_tb):
-        """Close the browser."""
-        _logger.info("Waiting for all cleanups to finish.")
-        await asyncio.gather(*self._background_render_tasks, return_exceptions=True)
-        _logger.info("Exiting Kaleido")
-        return await super().__aexit__(exc_type, exc_value, exc_tb)
-
-    def __init__(self, *args, **kwargs):  # noqa: D417 no args/kwargs in description
-        """
-        Initialize Kaleido, a `choreo.Browser` wrapper adding kaleido functionality.
-
-        It takes all `choreo.Browser` args, plus some extra. The extra
-        are listed, see choreographer for more documentation.
-
-        Note: Chrome will throttle background tabs and windows, so non-headless
-        multi-process configurations don't work well.
+    ### KALEIDO LIFECYCLE FUNCTIONS ###
 
-        For argument `page`, if it is a string, it must be passed as a fully-qualified
-        URI, like `file://` or `https://`.
-        If it is a `Path`, `Path`'s `as_uri()` will be called.
-        If it is a string or path, its expected to be an HTML file, one will not
-        be generated.
-
-        Args:
-            n: the number of separate processes (windows, not seen) to use.
-            timeout: limit on any single render (default 90 seconds).
-            width: width of window (headless only)
-            height: height of window (headless only)
-            page: This can be a `kaleido.PageGenerator`, a `pathlib.Path`, or a string.
-
-        """
-        self._background_render_tasks = set()
-        self._main_tasks = set()
+    def __init__(self, *args, **kwargs):
+        self._tab_requeue_tasks = set()
+        self._main_render_coroutines = set()
         self._tabs_ready = asyncio.Queue(maxsize=0)
         self._total_tabs = 0
-        self._tmp_dir = None
+        self._html_tmp_dir = None
 
+        # Kaleido Config
         page = kwargs.pop("page_generator", None)
         self._timeout = kwargs.pop("timeout", 90)
         self._n = kwargs.pop("n", 1)
-        self._height = kwargs.pop("height", None)
-        self._width = kwargs.pop("width", None)
-        self._stepper = kwargs.pop("stepper", False)
+        if self._n <= 0:
+            raise ValueError("Argument `n` must be greater than 0")
         self._plotlyjs = kwargs.pop("plotlyjs", None)
         self._mathjax = kwargs.pop("mathjax", None)
-        if not kwargs.get("headless", True) and (self._height or self._width):
-            warnings.warn(
-                "Height and Width can only be used if headless=True, "
-                "ignoring both sizes.",
-                stacklevel=1,
-            )
-            self._height = None
-            self._width = None
+
+        # Diagnostic
+        self._stepper = kwargs.pop("stepper", False)
+
         _logger.debug(f"Timeout: {self._timeout}")
 
         try:
@@ -133,41 +66,45 @@ def __init__(self, *args, **kwargs):  # noqa: D417 no args/kwargs in description
                 "or `kaleido.get_chrome_sync()`.",
             ) from ChromeNotFoundError
 
+        # not a lot of error detection here
         if page and isinstance(page, str) and Path(page).is_file():
+            self._index = Path(page).as_uri()
+        elif page and isinstance(page, str) and page.startswith("file://"):
             self._index = page
         elif page and hasattr(page, "is_file") and page.is_file():
             self._index = page.as_uri()
+        elif page and not hasattr(page, "generate_index"):
+            raise ValueError(
+                "`page_generator argument` must be None, an existing file or "
+                "an object with a generate_index function such as a "
+                "kaleido.PageGenerator().",
+            )
         else:
-            self._tmp_dir = TmpDirectory(sneak=self.is_isolated())
-            index = self._tmp_dir.path / "index.html"
+            self._html_tmp_dir = TmpDirectory(sneak=self.is_isolated())
+            index = self._html_tmp_dir.path / "index.html"
             self._index = index.as_uri()
             if not page:
                 page = PageGenerator(plotly=self._plotlyjs, mathjax=self._mathjax)
-            page.generate_index(index)
+            with index.open("w") as f:
+                f.write(page.generate_index())
+
+        if not Path(urlparse(self._index).path).is_file():
+            raise FileNotFoundError(f"{page} not found.")
 
-    async def _conform_tabs(self, tabs=None) -> None:
-        if not tabs:
-            tabs = list(self.tabs.values())
+    async def _conform_tabs(self, tabs) -> None:
         _logger.info(f"Conforming {len(tabs)} to {self._index}")
 
         for i, tab in enumerate(tabs):
-            n = f"tab-{i!s}"
             _logger.debug2(f"Subscribing * to tab: {tab}.")
-            tab.subscribe("*", _make_printer(n + " event"))
-
-        _logger.debug("Navigating all tabs")
+            tab.subscribe("*", _utils.make_printer(f"tab-{i!s} event"))
 
         kaleido_tabs = [_KaleidoTab(tab, _stepper=self._stepper) for tab in tabs]
 
-        # A little hard to read because we don't have TaskGroup in this version
-        tasks = [asyncio.create_task(tab.navigate(self._index)) for tab in kaleido_tabs]
-        _logger.info("Waiting on all navigates")
-        await asyncio.gather(*tasks)
-        _logger.info("All navigates done, putting them all in queue.")
+        await asyncio.gather(*(tab.navigate(self._index) for tab in kaleido_tabs))
+
         for tab in kaleido_tabs:
+            self._total_tabs += 1
             await self._tabs_ready.put(tab)
-        self._total_tabs = len(kaleido_tabs)
-        _logger.debug("Tabs fully navigated/enabled/ready")
 
     async def populate_targets(self) -> None:
         """
@@ -177,46 +114,52 @@ async def populate_targets(self) -> None:
         once ever per object.
         """
         await super().populate_targets()
-        await self._conform_tabs()
+        await self._conform_tabs(self.tabs.values())
         needed_tabs = self._n - len(self.tabs)
-        if needed_tabs < 0:
-            raise RuntimeError("Did you set 0 or less tabs?")
         if not needed_tabs:
             return
-        tasks = [
-            asyncio.create_task(self._create_kaleido_tab()) for _ in range(needed_tabs)
-        ]
 
-        await asyncio.gather(*tasks)
-        for tab in self.tabs.values():
-            _logger.info(f"Tab ready: {tab.target_id}")
+        await asyncio.gather(
+            *(self._create_kaleido_tab() for _ in range(needed_tabs)),
+        )
 
-    async def _create_kaleido_tab(
-        self,
-    ) -> None:
-        """
-        Create a tab with the kaleido script.
+    async def close(self):
+        """Close the browser."""
+        if self._html_tmp_dir:
+            self._html_tmp_dir.clean()
+
+        # cancellation only happens if crash/early
+        _logger.info("Cancelling tasks.")
+        for task in self._main_render_coroutines:
+            if not task.done():
+                task.cancel()
+        for task in self._tab_requeue_tasks:
+            if not task.done():
+                task.cancel()
 
-        Returns:
-            The kaleido-tab created.
+        _logger.info("Exiting Kaleido/Choreo.")
+        return await super().close()
 
-        """
+    async def __aexit__(self, exc_type, exc_value, exc_tb):
+        """Close the browser."""
+        _logger.info("Waiting for all cleanups to finish.")
+
+        # render "tasks" are coroutines, so use is awaiting them
+        await asyncio.gather(*self._tab_requeue_tasks, return_exceptions=True)
+
+        _logger.info("Exiting Kaleido.")
+        return await super().__aexit__(exc_type, exc_value, exc_tb)
+
+    ### TAB MANAGEMENT FUNCTIONS ####
+
+    async def _create_kaleido_tab(self) -> None:
         tab = await super().create_tab(
             url="",
-            width=self._width,
-            height=self._height,
             window=True,
         )
         await self._conform_tabs([tab])
 
     async def _get_kaleido_tab(self) -> _KaleidoTab:
-        """
-        Retrieve an available tab from queue.
-
-        Returns:
-            A kaleido-tab from the queue.
-
-        """
         _logger.info(f"Getting tab from queue (has {self._tabs_ready.qsize()})")
         if not self._total_tabs:
             raise RuntimeError(
@@ -226,14 +169,7 @@ async def _get_kaleido_tab(self) -> _KaleidoTab:
         _logger.info(f"Got {tab.tab.target_id[:4]}")
         return tab
 
-    async def _return_kaleido_tab(self, tab):
-        """
-        Refresh tab and put it back into the available queue.
-
-        Args:
-            tab: the kaleido tab to return.
-
-        """
+    async def _return_kaleido_tab(self, tab) -> None:
         _logger.info(f"Reloading tab {tab.tab.target_id[:4]} before return.")
         await tab.reload()
         _logger.info(
@@ -243,290 +179,95 @@ async def _return_kaleido_tab(self, tab):
         await self._tabs_ready.put(tab)
         _logger.debug(f"{tab.tab.target_id[:4]} put back.")
 
-    def _clean_tab_return_task(self, main_task, task):
-        _logger.info("Cleaning out background tasks.")
-        self._background_render_tasks.remove(task)
-        e = task.exception()
-        if e:
-            _logger.error("Clean tab return task found exception", exc_info=e)
-            if not main_task.done():
-                main_task.cancel()
-            raise e
-
-    def _check_render_task(self, name, tab, main_task, error_log, task):
-        if task.cancelled():
-            _logger.info(f"Something cancelled {name}.")
-            error_log.append(
-                ErrorEntry(name, asyncio.CancelledError, tab.javascript_log),
-            )
-        elif e := task.exception():
-            _logger.error(f"Render Task Error In {name}- ", exc_info=e)
-            if isinstance(e, (asyncio.TimeoutError, TimeoutError)) and error_log:
-                error_log.append(
-                    ErrorEntry(name, e, tab.javascript_log),
-                )
-            else:
-                _logger.error("Cancelling all.")
-                if not main_task.done():
-                    main_task.cancel()
-                raise e
-        _logger.info(f"Returning {name} tab after render.")
-        t = asyncio.create_task(self._return_kaleido_tab(tab))
-        self._background_render_tasks.add(t)
-        t.add_done_callback(partial(self._clean_tab_return_task, main_task))
-
-    async def _render_task(self, tab, args, error_log=None, profiler=None):
+    async def _create_render_task(self, tab, *args, **kwargs) -> asyncio.Task:
         _logger.info(f"Posting a task for {args['full_path'].name}")
-        if self._timeout:
-            try:
-                await asyncio.wait_for(
-                    tab._write_fig(  # noqa: SLF001 I don't want it documented, too complex for user
-                        **args,
-                        error_log=error_log,
-                        profiler=profiler,
-                    ),
-                    self._timeout,  # timeout can be None, no need for branches
-                )
-            except BaseException as e:
-                if error_log:
-                    error_log.append(
-                        ErrorEntry(
-                            args["full_path"].name,
-                            e,
-                            tab.javascript_log
-                            if hasattr(
-                                tab,
-                                "javascript_log",
-                            )
-                            else [],
-                        ),
-                    )
-                else:
-                    raise
-
-        else:
-            await tab._write_fig(  # noqa: SLF001 I don't want it documented, too complex for user
-                **args,
-                error_log=error_log,
-                profiler=profiler,
-            )
-        _logger.info(f"Posted task ending for {args['full_path'].name}")
-
-    async def calc_fig(
-        self,
-        fig,
-        path=None,
-        opts=None,
-        *,
-        topojson=None,
-    ):
-        """
-        Calculate the bytes for a figure.
-
-        This function does not support parallelism or multi-image processing like
-        `write_fig` does, although its arguments are a subset of those of `write_fig`.
-        This function is currently just meant to bridge the old and new API.
-        """
-        if not _is_figurish(fig) and isinstance(fig, Iterable):
-            raise TypeError("Calc fig can not process multiple images at a time.")
-        spec, full_path = build_fig_spec(fig, path, opts)
-        tab = await self._get_kaleido_tab()
-        args = {
-            "spec": spec,
-            "full_path": full_path,
-            "topojson": topojson,
-        }
-        data = None
-        timeout = self._timeout if self._timeout else None
-        data = await asyncio.wait_for(
-            tab._calc_fig(  # noqa: SLF001 I don't want it documented, too complex for user
-                **args,
+        t = asyncio.create_task(
+            asyncio.wait_for(
+                tab._write_fig(  # noqa: SLF001
+                    *args,
+                    **kwargs,
+                ),
+                self._timeout,
             ),
-            timeout,
         )
-        await self._return_kaleido_tab(tab)
-        return data[0]
 
-    async def write_fig(  # noqa: PLR0913 (too many args)
-        self,
-        fig,
-        path=None,
-        opts=None,
-        *,
-        topojson=None,
-        error_log=None,
-        profiler=None,
-    ):
-        """
-        Call the plotly renderer via javascript on first available tab.
-
-        Args:
-            fig: the plotly figure or an iterable of plotly figures
-            path: the path to write the images to. if its a directory, we will try to
-                generate a name. If the path contains an extension,
-                "path/to/my_image.png", that extension will be the format used if not
-                overridden in `opts`. If you pass a complete path (filename), for
-                multiple figures, you will overwrite every previous figure.
-            opts: dictionary describing format, width, height, and scale of image
-            topojson: a link ??? TODO
-            error_log: a supplied list, will be populated with `ErrorEntry`s
-                       which can be converted to strings. Note, this is for
-                       collections errors that have to do with plotly. They will
-                       not be thrown. Lower level errors (kaleido, choreographer)
-                       will still be thrown. If not passed, all errors raise.
-            profiler: a supplied dictionary to collect stats about the operation
-                      about tabs, runtimes, etc.
-
-        """
-        if error_log is not None:
-            _logger.info("Using error log.")
-        if profiler is not None:
-            _logger.info("Using profiler.")
-
-        if _is_figurish(fig) or not isinstance(fig, Iterable):
-            fig = [fig]
-        else:
-            _logger.debug(f"Is iterable {type(fig)}")
-
-        main_task = asyncio.current_task()
-        self._main_tasks.add(main_task)
-        tasks = set()
-
-        async def _loop(f):
-            spec, full_path = build_fig_spec(f, path, opts)
-            tab = await self._get_kaleido_tab()
-            if profiler is not None and tab.tab.target_id not in profiler:
-                profiler[tab.tab.target_id] = []
-            t = asyncio.create_task(
-                self._render_task(
-                    tab,
-                    args={
-                        "spec": spec,
-                        "full_path": full_path,
-                        "topojson": topojson,
-                    },
-                    error_log=error_log,
-                    profiler=profiler,
-                ),
-            )
-            t.add_done_callback(
-                partial(
-                    self._check_render_task,
-                    full_path.name,
-                    tab,
-                    main_task,
-                    error_log,
+        # we just log any error but honestly it would be pretty fatal
+        t.add_done_callback(
+            lambda: self._tab_requeue_tasks.add(
+                _utils.create_task_log_error(
+                    self._return_kaleido_tab(tab),
                 ),
-            )
-            tasks.add(t)
+            ),
+        )
+        _logger.info(f"Posted task ending for {args['full_path'].name}")
+        return t
 
-        try:
-            if hasattr(fig, "__aiter__"):  # is async iterable
-                _logger.debug("Is async for")
-                async for f in fig:
-                    await _loop(f)
-            else:
-                _logger.debug("Is sync for")
-                for f in fig:
-                    await _loop(f)
-            _logger.debug("awaiting tasks")
-            await asyncio.gather(*tasks, return_exceptions=True)
-        except:
-            _logger.exception("Cleaning tasks after error.")
-            for task in tasks:
-                if not task.done():
-                    task.cancel()
-            raise
-        finally:
-            self._main_tasks.remove(main_task)
+    ### API ###
 
+    # also write_fig_from_dict
     async def write_fig_from_object(
         self,
-        generator,
+        generator,  # what should we accept here
         *,
-        error_log=None,
-        profiler=None,
-    ):
-        """
-        Equal to `write_fig` but allows the user to generate all arguments.
-
-        Generator must yield dictionaries with keys:
-        - fig: the plotly figure
-        - path: (optional, string or pathlib.Path) the path
-        - opts: (optional) dictionary with:
-            - format (string)
-            - scale (number)
-            - height (number)
-            - and width (number)
-        - topojson: (optional) topojsons are used to customize choropleths
-
-        Generators are good because, if rendering many images, one doesn't need to
-        prerender them all. They can be rendered and yielded asynchronously.
-
-        While `write_fig` can also take generators, but only for the figure.
-        In this case, the generator will specify all render-related arguments.
-
-        Args:
-            generator: an iterable or generator which supplies a dictionary
-                       of arguments to pass to tab.write_fig.
-            error_log: A supplied list, will be populated with `ErrorEntry`s
-                       which can be converted to strings. Note, this is for
-                       collections errors that have to do with plotly. They will
-                       not be thrown. Lower level errors (kaleido, choreographer)
-                       will still be thrown.
-            profiler: A supplied dictionary, will be populated with information
-                      about tabs, runtimes, etc.
-
-        """
-        if error_log is not None:
-            _logger.info("Using error log.")
-        if profiler is not None:
-            _logger.info("Using profiler.")
-
+        cancel_on_error=False,
+    ) -> None:
+        """Temp."""
         main_task = asyncio.current_task()
-        self._main_tasks.add(main_task)
+        self._main_render_coroutines.add(main_task)
         tasks = set()
 
         try:
-            async for args in ensure_async_iter(generator):
-                args["spec"], args["full_path"] = build_fig_spec(
-                    args.pop("fig"),
-                    args.pop("path", None),
-                    args.pop("opts", None),
+            async for args in _utils.ensure_async_iter(generator):
+                spec, full_path = build_fig_spec(
+                    args.get("fig"),
+                    args.get("path", None),
+                    args.get("opts", None),
                 )
+                topojson = args.get("topojson")
 
                 tab = await self._get_kaleido_tab()
 
-                if profiler is not None and tab.tab.target_id not in profiler:
-                    profiler[tab.tab.target_id] = []
-
-                t = asyncio.create_task(
-                    self._render_task(
-                        tab,
-                        args=args,
-                        error_log=error_log,
-                        profiler=profiler,
-                    ),
-                )
-                t.add_done_callback(
-                    partial(
-                        self._check_render_task,
-                        args["full_path"].name,
-                        tab,
-                        main_task,
-                        error_log,
-                    ),
+                t = self._create_render_task(
+                    tab,
+                    spec,
+                    full_path,
+                    topojson=topojson,
                 )
+
                 tasks.add(t)
 
-            await asyncio.gather(*tasks, return_exceptions=True)
-            # This here would include errors during the tasks?
-        except:
-            # This would only catch errors in the machinery, not the task
-            _logger.exception("Cleaning tasks after error.")
+            await asyncio.gather(*tasks, return_exceptions=not cancel_on_error)
+
+        finally:
             for task in tasks:
                 if not task.done():
                     task.cancel()
-            raise
-        finally:
-            self._main_tasks.remove(main_task)
+            self._main_render_coroutines.remove(main_task)
+            # return errors?
+
+    async def write_fig(
+        self,
+        fig,
+        path=None,
+        opts=None,
+        *,
+        topojson=None,
+    ) -> None:
+        """Temp."""
+        if _is_figurish(fig) or not isinstance(fig, Iterable):
+            fig = [fig]
+        else:
+            _logger.debug(f"Is iterable {type(fig)}")
+
+        async def _temp_generator():
+            async for f in _utils.ensure_async_iter(fig):
+                yield {
+                    "fig": f,
+                    "path": path,
+                    "opts": opts,
+                    "topojson": topojson,
+                }
+
+        return await self.write_fig_from_object(
+            generator=_temp_generator(),
+        )

From 8725a80b9a42866c328bdac70a403506f1bdb333 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Thu, 21 Aug 2025 12:30:57 -0500
Subject: [PATCH 004/167] Change order of functions.

---
 src/py/kaleido/_kaleido_tab.py | 32 +++++++++++++++-----------------
 1 file changed, 15 insertions(+), 17 deletions(-)

diff --git a/src/py/kaleido/_kaleido_tab.py b/src/py/kaleido/_kaleido_tab.py
index 6288fa06..7af72181 100644
--- a/src/py/kaleido/_kaleido_tab.py
+++ b/src/py/kaleido/_kaleido_tab.py
@@ -47,13 +47,7 @@ def __str__(self):
         return f"Error {self._code}: {self._message}"
 
 
-def _check_error(result):
-    e = _check_error_ret(result)
-    if e:
-        raise e
-
-
-def _check_error_ret(result):  # Utility
+def _check_error_ret(result):
     """Check browser response for errors. Helper function."""
     if "error" in result:
         return DevtoolsProtocolError(result)
@@ -62,6 +56,12 @@ def _check_error_ret(result):  # Utility
     return None
 
 
+def _check_error(result):
+    e = _check_error_ret(result)
+    if e:
+        raise e
+
+
 def _make_console_logger(name, log):
     """Create printer specifically for console events. Helper function."""
 
@@ -85,6 +85,14 @@ class _KaleidoTab:
     javascript_log: list[Any]
     """A list of console outputs from the tab."""
 
+    def _regenerate_javascript_console(self):
+        self.javascript_log = []
+        self.tab.unsubscribe("Runtime.consoleAPICalled")
+        self.tab.subscribe(
+            "Runtime.consoleAPICalled",
+            _make_console_logger("tab js console", self.javascript_log),
+        )
+
     def __init__(self, tab, *, _stepper=False):
         """
         Create a new _KaleidoTab.
@@ -97,16 +105,6 @@ def __init__(self, tab, *, _stepper=False):
         self.javascript_log = []
         self._stepper = _stepper
 
-    def _regenerate_javascript_console(self):
-        tab = self.tab
-        self.javascript_log = []
-        _logger.debug2("Subscribing to all console prints for tab {tab}.")
-        tab.unsubscribe("Runtime.consoleAPICalled")
-        tab.subscribe(
-            "Runtime.consoleAPICalled",
-            _make_console_logger("tab js console", self.javascript_log),
-        )
-
     async def navigate(self, url: str | Path = ""):
         """
         Navigate to the kaleidofier script. This is effectively the real initialization.

From 41133f2cde83fef0f066dc82b45ba04261b72363 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Thu, 21 Aug 2025 13:57:04 -0500
Subject: [PATCH 005/167] Make tabs_ready public

---
 src/py/kaleido/kaleido.py | 15 ++++++++-------
 1 file changed, 8 insertions(+), 7 deletions(-)

diff --git a/src/py/kaleido/kaleido.py b/src/py/kaleido/kaleido.py
index a79cbec5..dbfb5d4e 100644
--- a/src/py/kaleido/kaleido.py
+++ b/src/py/kaleido/kaleido.py
@@ -49,7 +49,8 @@ class Kaleido(choreo.Browser):
     ```
     """
 
-    _tabs_ready: asyncio.Queue[_KaleidoTab]
+    tabs_ready: asyncio.Queue[_KaleidoTab]
+    """A queue of ready tabs."""
     _background_render_tasks: set[asyncio.Task]
     # not really render tasks
     _main_tasks: set[asyncio.Task]
@@ -101,7 +102,7 @@ def __init__(self, *args, **kwargs):  # noqa: D417 no args/kwargs in description
         """
         self._background_render_tasks = set()
         self._main_tasks = set()
-        self._tabs_ready = asyncio.Queue(maxsize=0)
+        self.tabs_ready = asyncio.Queue(maxsize=0)
         self._total_tabs = 0
         self._tmp_dir = None
 
@@ -165,7 +166,7 @@ async def _conform_tabs(self, tabs=None) -> None:
         await asyncio.gather(*tasks)
         _logger.info("All navigates done, putting them all in queue.")
         for tab in kaleido_tabs:
-            await self._tabs_ready.put(tab)
+            await self.tabs_ready.put(tab)
         self._total_tabs = len(kaleido_tabs)
         _logger.debug("Tabs fully navigated/enabled/ready")
 
@@ -217,12 +218,12 @@ async def _get_kaleido_tab(self) -> _KaleidoTab:
             A kaleido-tab from the queue.
 
         """
-        _logger.info(f"Getting tab from queue (has {self._tabs_ready.qsize()})")
+        _logger.info(f"Getting tab from queue (has {self.tabs_ready.qsize()})")
         if not self._total_tabs:
             raise RuntimeError(
                 "Before generating a figure, you must await `k.open()`.",
             )
-        tab = await self._tabs_ready.get()
+        tab = await self.tabs_ready.get()
         _logger.info(f"Got {tab.tab.target_id[:4]}")
         return tab
 
@@ -238,9 +239,9 @@ async def _return_kaleido_tab(self, tab):
         await tab.reload()
         _logger.info(
             f"Putting tab {tab.tab.target_id[:4]} back (queue size: "
-            f"{self._tabs_ready.qsize()}).",
+            f"{self.tabs_ready.qsize()}).",
         )
-        await self._tabs_ready.put(tab)
+        await self.tabs_ready.put(tab)
         _logger.debug(f"{tab.tab.target_id[:4]} put back.")
 
     def _clean_tab_return_task(self, main_task, task):

From d4a5bd4f6c1d302f3677262fb59ed5860cf84d03 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Fri, 22 Aug 2025 11:24:44 -0500
Subject: [PATCH 006/167] Add some types to kaleido.py

---
 src/py/kaleido/kaleido.py | 50 ++++++++++++++++++++++++++++-----------
 1 file changed, 36 insertions(+), 14 deletions(-)

diff --git a/src/py/kaleido/kaleido.py b/src/py/kaleido/kaleido.py
index a79cbec5..72c6c901 100644
--- a/src/py/kaleido/kaleido.py
+++ b/src/py/kaleido/kaleido.py
@@ -4,9 +4,10 @@
 
 import asyncio
 import warnings
-from collections.abc import Iterable
+from collections.abc import AsyncIterable, Iterable
 from functools import partial
 from pathlib import Path
+from typing import TYPE_CHECKING
 
 import choreographer as choreo
 import logistro
@@ -18,6 +19,10 @@
 from ._page_generator import PageGenerator
 from ._utils import ErrorEntry, warn_incompatible_plotly
 
+if TYPE_CHECKING:
+    from types import TracebackType
+    from typing import Any, Callable, Coroutine
+
 _logger = logistro.getLogger(__name__)
 
 # Show a warning if the installed Plotly version
@@ -25,10 +30,10 @@
 warn_incompatible_plotly()
 
 
-def _make_printer(name):
+def _make_printer(name: str) -> Callable[[str], Coroutine[Any, Any, None]]:
     """Create event printer for generic events. Helper function."""
 
-    async def print_all(response):
+    async def print_all(response: str) -> None:
         _logger.debug2(f"{name}:{response}")
 
     return print_all
@@ -54,7 +59,7 @@ class Kaleido(choreo.Browser):
     # not really render tasks
     _main_tasks: set[asyncio.Task]
 
-    async def close(self):
+    async def close(self) -> None:
         """Close the browser."""
         if self._tmp_dir:
             self._tmp_dir.clean()
@@ -68,14 +73,31 @@ async def close(self):
         _logger.info("Exiting Kaleido/Choreo")
         return await super().close()
 
-    async def __aexit__(self, exc_type, exc_value, exc_tb):
+    async def __aexit__(
+        self,
+        exc_type: type[BaseException] | None,
+        exc_value: BaseException | None,
+        exc_tb: TracebackType | None,
+    ) -> bool | None:
         """Close the browser."""
         _logger.info("Waiting for all cleanups to finish.")
         await asyncio.gather(*self._background_render_tasks, return_exceptions=True)
         _logger.info("Exiting Kaleido")
         return await super().__aexit__(exc_type, exc_value, exc_tb)
 
-    def __init__(self, *args, **kwargs):  # noqa: D417 no args/kwargs in description
+    def __init__(  # noqa: D417, PLR0913 no args/kwargs in description
+        self,
+        *args: Any,
+        page_generator: None | PageGenerator | str | Path = None,
+        n: int = 1,
+        timeout: int | None = 90,
+        width: int | None = None,
+        height: int | None = None,
+        stepper: bool = False,
+        plotlyjs: str | None = None,
+        mathjax: str | None = None,
+        **kwargs: Any,
+    ) -> None:
         """
         Initialize Kaleido, a `choreo.Browser` wrapper adding kaleido functionality.
 
@@ -105,14 +127,14 @@ def __init__(self, *args, **kwargs):  # noqa: D417 no args/kwargs in description
         self._total_tabs = 0
         self._tmp_dir = None
 
-        page = kwargs.pop("page_generator", None)
-        self._timeout = kwargs.pop("timeout", 90)
-        self._n = kwargs.pop("n", 1)
-        self._height = kwargs.pop("height", None)
-        self._width = kwargs.pop("width", None)
-        self._stepper = kwargs.pop("stepper", False)
-        self._plotlyjs = kwargs.pop("plotlyjs", None)
-        self._mathjax = kwargs.pop("mathjax", None)
+        page = page_generator
+        self._timeout = timeout
+        self._n = n
+        self._height = height
+        self._width = width
+        self._stepper = stepper
+        self._plotlyjs = plotlyjs
+        self._mathjax = mathjax
         if not kwargs.get("headless", True) and (self._height or self._width):
             warnings.warn(
                 "Height and Width can only be used if headless=True, "

From 583b8c836f1b36bf72f39b868f0d3b4f4b38e9e7 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Fri, 22 Aug 2025 15:40:11 -0500
Subject: [PATCH 007/167] Upgrade choreographer for typing.

---
 src/py/pyproject.toml |   2 +-
 src/py/uv.lock        | 290 +++++++++++++++++++++---------------------
 2 files changed, 146 insertions(+), 146 deletions(-)

diff --git a/src/py/pyproject.toml b/src/py/pyproject.toml
index ce0efb3b..392ddb25 100644
--- a/src/py/pyproject.toml
+++ b/src/py/pyproject.toml
@@ -26,7 +26,7 @@ maintainers = [
   {name = "Andrew Pikul", email = "ajpikul@gmail.com"},
 ]
 dependencies = [
-  "choreographer>=1.0.7",
+  "choreographer>=1.0.10",
   "logistro>=1.0.8",
   "orjson>=3.10.15",
   "packaging",
diff --git a/src/py/uv.lock b/src/py/uv.lock
index cb129f3d..7206f1a3 100644
--- a/src/py/uv.lock
+++ b/src/py/uv.lock
@@ -1,5 +1,5 @@
 version = 1
-revision = 2
+revision = 3
 requires-python = ">=3.8"
 resolution-markers = [
     "python_full_version >= '3.12'",
@@ -29,15 +29,15 @@ wheels = [
 
 [[package]]
 name = "choreographer"
-version = "1.0.9"
+version = "1.0.10"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "logistro" },
     { name = "simplejson" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/3e/2f/1de552325ce03732cca29534ca3e91136721f500666ea4fa2eb348eb237b/choreographer-1.0.9.tar.gz", hash = "sha256:36423b4b049cf2ec2a68fa4024bdd22d0c417d5421913ef62b6c0e89595b6895", size = 40462, upload-time = "2025-06-10T19:14:30.327Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/71/0e/88c2a0307e27f40bd0ce18e66ba2c8f7327b95b23adc51ea57a08cb96797/choreographer-1.0.10.tar.gz", hash = "sha256:7adf84a0d6a6054386d5cce013fdcadb2426479e49c9b0cb06af7d3712ed263c", size = 40455, upload-time = "2025-08-22T20:37:25.461Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/e7/da/38f4a19fadd86416551871fa1cc385df61b0f54656e1def4892c148cfd8f/choreographer-1.0.9-py3-none-any.whl", hash = "sha256:b3277e30953843a83d3d730e49958a6be82013885d2a4f54b3950a3715191d7f", size = 51262, upload-time = "2025-06-10T19:14:29.313Z" },
+    { url = "https://files.pythonhosted.org/packages/d3/c2/82389f6e20098a414ddcf88d3b8032809b7a66e70f9bc5264f81beb24b4a/choreographer-1.0.10-py3-none-any.whl", hash = "sha256:b23ec2409f38ec89a544558eadeb19688746bab9a0f47e7115477d6e80a14a41", size = 51300, upload-time = "2025-08-22T20:37:24.372Z" },
 ]
 
 [[package]]
@@ -87,7 +87,7 @@ dependencies = [
     { name = "choreographer" },
     { name = "logistro" },
     { name = "orjson", version = "3.10.15", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.9'" },
-    { name = "orjson", version = "3.11.1", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.9'" },
+    { name = "orjson", version = "3.11.2", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.9'" },
     { name = "packaging" },
 ]
 
@@ -97,10 +97,10 @@ dev = [
     { name = "mypy", version = "1.14.1", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.9'" },
     { name = "mypy", version = "1.17.1", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.9'" },
     { name = "pandas", version = "2.0.3", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.9'" },
-    { name = "pandas", version = "2.3.1", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.9'" },
+    { name = "pandas", version = "2.3.2", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.9'" },
     { name = "plotly", extra = ["express"] },
     { name = "poethepoet", version = "0.30.0", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.9'" },
-    { name = "poethepoet", version = "0.36.0", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.9'" },
+    { name = "poethepoet", version = "0.37.0", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.9'" },
     { name = "pytest", version = "8.3.5", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.9'" },
     { name = "pytest", version = "8.4.1", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.9'" },
     { name = "pytest-asyncio", version = "0.24.0", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.9'" },
@@ -114,7 +114,7 @@ dev = [
 
 [package.metadata]
 requires-dist = [
-    { name = "choreographer", specifier = ">=1.0.7" },
+    { name = "choreographer", specifier = ">=1.0.10" },
     { name = "logistro", specifier = ">=1.0.8" },
     { name = "orjson", specifier = ">=3.10.15" },
     { name = "packaging" },
@@ -276,7 +276,7 @@ wheels = [
 
 [[package]]
 name = "narwhals"
-version = "2.0.1"
+version = "2.1.2"
 source = { registry = "https://pypi.org/simple" }
 resolution-markers = [
     "python_full_version >= '3.12'",
@@ -284,9 +284,9 @@ resolution-markers = [
     "python_full_version == '3.10.*'",
     "python_full_version == '3.9.*'",
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/e2/8f/51d14e402c4f9d281a2e153a6a805cad5460088027a999faf264b54e7641/narwhals-2.0.1.tar.gz", hash = "sha256:235e61ca807bc21110ca36a4d53888ecc22c42dcdf50a7c886e10dde3fd7f38c", size = 525541, upload-time = "2025-07-29T08:39:04.81Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/37/f0/b0550d9b84759f4d045fd43da2f811e8b23dc2001e38c3254456da7f3adb/narwhals-2.1.2.tar.gz", hash = "sha256:afb9597e76d5b38c2c4b7c37d27a2418b8cc8049a66b8a5aca9581c92ae8f8bf", size = 533772, upload-time = "2025-08-15T08:24:50.916Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/7f/26/43caf834e47c63883a5eddc02893b7fdbe6a0a4508ff6dc401907f3cc085/narwhals-2.0.1-py3-none-any.whl", hash = "sha256:837457e36a2ba1710c881fb69e1f79ce44fb81728c92ac378f70892a53af8ddb", size = 385436, upload-time = "2025-07-29T08:39:03.163Z" },
+    { url = "https://files.pythonhosted.org/packages/a8/01/824fff6789ce92a53242d24b6f5f3a982df2f610c51020f934bf878d2a99/narwhals-2.1.2-py3-none-any.whl", hash = "sha256:136b2f533a4eb3245c54254f137c5d14cef5c4668cff67dc6e911a602acd3547", size = 392064, upload-time = "2025-08-15T08:24:48.788Z" },
 ]
 
 [[package]]
@@ -623,7 +623,7 @@ wheels = [
 
 [[package]]
 name = "orjson"
-version = "3.11.1"
+version = "3.11.2"
 source = { registry = "https://pypi.org/simple" }
 resolution-markers = [
     "python_full_version >= '3.12'",
@@ -631,90 +631,90 @@ resolution-markers = [
     "python_full_version == '3.10.*'",
     "python_full_version == '3.9.*'",
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/19/3b/fd9ff8ff64ae3900f11554d5cfc835fb73e501e043c420ad32ec574fe27f/orjson-3.11.1.tar.gz", hash = "sha256:48d82770a5fd88778063604c566f9c7c71820270c9cc9338d25147cbf34afd96", size = 5393373, upload-time = "2025-07-25T14:33:52.898Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/df/1d/5e0ae38788bdf0721326695e65fdf41405ed535f633eb0df0f06f57552fa/orjson-3.11.2.tar.gz", hash = "sha256:91bdcf5e69a8fd8e8bdb3de32b31ff01d2bd60c1e8d5fe7d5afabdcf19920309", size = 5470739, upload-time = "2025-08-12T15:12:28.626Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/94/8b/7dd88f416e2e5834fd9809d871f471aae7d12dfd83d4786166fa5a926601/orjson-3.11.1-cp310-cp310-macosx_10_15_x86_64.macosx_11_0_arm64.macosx_10_15_universal2.whl", hash = "sha256:92d771c492b64119456afb50f2dff3e03a2db8b5af0eba32c5932d306f970532", size = 241312, upload-time = "2025-07-25T14:31:52.841Z" },
-    { url = "https://files.pythonhosted.org/packages/f3/5d/5bfc371bd010ffbec90e64338aa59abcb13ed94191112199048653ee2f34/orjson-3.11.1-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:0085ef83a4141c2ed23bfec5fecbfdb1e95dd42fc8e8c76057bdeeec1608ea65", size = 132791, upload-time = "2025-07-25T14:31:55.547Z" },
-    { url = "https://files.pythonhosted.org/packages/48/e2/c07854a6bad71e4249345efadb686c0aff250073bdab8ba9be7626af6516/orjson-3.11.1-cp310-cp310-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:5caf7f13f2e1b4e137060aed892d4541d07dabc3f29e6d891e2383c7ed483440", size = 128690, upload-time = "2025-07-25T14:31:56.708Z" },
-    { url = "https://files.pythonhosted.org/packages/48/e4/2e075348e7772aa1404d51d8df25ff4d6ee3daf682732cb21308e3b59c32/orjson-3.11.1-cp310-cp310-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:f716bcc166524eddfcf9f13f8209ac19a7f27b05cf591e883419079d98c8c99d", size = 130646, upload-time = "2025-07-25T14:31:58.165Z" },
-    { url = "https://files.pythonhosted.org/packages/97/09/50daacd3ac7ae564186924c8d1121940f2c78c64d6804dbe81dd735ab087/orjson-3.11.1-cp310-cp310-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:507d6012fab05465d8bf21f5d7f4635ba4b6d60132874e349beff12fb51af7fe", size = 132620, upload-time = "2025-07-25T14:31:59.226Z" },
-    { url = "https://files.pythonhosted.org/packages/da/21/5f22093fa90e6d6fcf8111942b530a4ad19ee1cc0b06ddad4a63b16ab852/orjson-3.11.1-cp310-cp310-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:b1545083b0931f754c80fd2422a73d83bea7a6d1b6de104a5f2c8dd3d64c291e", size = 135121, upload-time = "2025-07-25T14:32:00.653Z" },
-    { url = "https://files.pythonhosted.org/packages/48/90/77ad4bfa6bd400a3d241695e3e39975e32fe027aea5cb0b171bd2080c427/orjson-3.11.1-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:9e217ce3bad76351e1eb29ebe5ca630326f45cd2141f62620107a229909501a3", size = 131131, upload-time = "2025-07-25T14:32:01.821Z" },
-    { url = "https://files.pythonhosted.org/packages/5a/64/d383675229f7ffd971b6ec6cdd3016b00877bb6b2d5fc1fd099c2ec2ad57/orjson-3.11.1-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:06ef26e009304bda4df42e4afe518994cde6f89b4b04c0ff24021064f83f4fbb", size = 131025, upload-time = "2025-07-25T14:32:02.879Z" },
-    { url = "https://files.pythonhosted.org/packages/d4/82/e4017d8d98597f6056afaf75021ff390154d1e2722c66ba45a4d50f82606/orjson-3.11.1-cp310-cp310-musllinux_1_2_armv7l.whl", hash = "sha256:ba49683b87bea3ae1489a88e766e767d4f423a669a61270b6d6a7ead1c33bd65", size = 404464, upload-time = "2025-07-25T14:32:04.384Z" },
-    { url = "https://files.pythonhosted.org/packages/77/7e/45c7f813c30d386c0168a32ce703494262458af6b222a3eeac1c0bb88822/orjson-3.11.1-cp310-cp310-musllinux_1_2_i686.whl", hash = "sha256:5072488fcc5cbcda2ece966d248e43ea1d222e19dd4c56d3f82747777f24d864", size = 146416, upload-time = "2025-07-25T14:32:05.57Z" },
-    { url = "https://files.pythonhosted.org/packages/41/71/6ccb4d7875ec3349409960769a28349f477856f05de9fd961454c2b99230/orjson-3.11.1-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:f58ae2bcd119226fe4aa934b5880fe57b8e97b69e51d5d91c88a89477a307016", size = 135497, upload-time = "2025-07-25T14:32:06.704Z" },
-    { url = "https://files.pythonhosted.org/packages/2c/ce/df8dac7da075962fdbfca55d53e3601aa910c9f23606033bf0f084835720/orjson-3.11.1-cp310-cp310-win32.whl", hash = "sha256:6723be919c07906781b9c63cc52dc7d2fb101336c99dd7e85d3531d73fb493f7", size = 136807, upload-time = "2025-07-25T14:32:08.303Z" },
-    { url = "https://files.pythonhosted.org/packages/7b/a0/f6c2be24709d1742d878b4530fa0c3f4a5e190d51397b680abbf44d11dbf/orjson-3.11.1-cp310-cp310-win_amd64.whl", hash = "sha256:5fd44d69ddfdfb4e8d0d83f09d27a4db34930fba153fbf79f8d4ae8b47914e04", size = 131561, upload-time = "2025-07-25T14:32:09.444Z" },
-    { url = "https://files.pythonhosted.org/packages/a5/92/7ab270b5b3df8d5b0d3e572ddf2f03c9f6a79726338badf1ec8594e1469d/orjson-3.11.1-cp311-cp311-macosx_10_15_x86_64.macosx_11_0_arm64.macosx_10_15_universal2.whl", hash = "sha256:15e2a57ce3b57c1a36acffcc02e823afefceee0a532180c2568c62213c98e3ef", size = 240918, upload-time = "2025-07-25T14:32:11.021Z" },
-    { url = "https://files.pythonhosted.org/packages/80/41/df44684cfbd2e2e03bf9b09fdb14b7abcfff267998790b6acfb69ad435f0/orjson-3.11.1-cp311-cp311-macosx_15_0_arm64.whl", hash = "sha256:17040a83ecaa130474af05bbb59a13cfeb2157d76385556041f945da936b1afd", size = 129386, upload-time = "2025-07-25T14:32:12.361Z" },
-    { url = "https://files.pythonhosted.org/packages/c1/08/958f56edd18ba1827ad0c74b2b41a7ae0864718adee8ccb5d1a5528f8761/orjson-3.11.1-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:1a68f23f09e5626cc0867a96cf618f68b91acb4753d33a80bf16111fd7f9928c", size = 132508, upload-time = "2025-07-25T14:32:13.917Z" },
-    { url = "https://files.pythonhosted.org/packages/cc/b6/5e56e189dacbf51e53ba8150c20e61ee746f6d57b697f5c52315ffc88a83/orjson-3.11.1-cp311-cp311-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:47e07528bb6ccbd6e32a55e330979048b59bfc5518b47c89bc7ab9e3de15174a", size = 128501, upload-time = "2025-07-25T14:32:15.13Z" },
-    { url = "https://files.pythonhosted.org/packages/fe/de/f6c301a514f5934405fd4b8f3d3efc758c911d06c3de3f4be1e30d675fa4/orjson-3.11.1-cp311-cp311-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:f3807cce72bf40a9d251d689cbec28d2efd27e0f6673709f948f971afd52cb09", size = 130465, upload-time = "2025-07-25T14:32:17.355Z" },
-    { url = "https://files.pythonhosted.org/packages/47/08/f7dbaab87d6f05eebff2d7b8e6a8ed5f13b2fe3e3ae49472b527d03dbd7a/orjson-3.11.1-cp311-cp311-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:5b2dc7e88da4ca201c940f5e6127998d9e89aa64264292334dad62854bc7fc27", size = 132416, upload-time = "2025-07-25T14:32:18.933Z" },
-    { url = "https://files.pythonhosted.org/packages/43/3f/dd5a185273b7ba6aa238cfc67bf9edaa1885ae51ce942bc1a71d0f99f574/orjson-3.11.1-cp311-cp311-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:3091dad33ac9e67c0a550cfff8ad5be156e2614d6f5d2a9247df0627751a1495", size = 134924, upload-time = "2025-07-25T14:32:20.134Z" },
-    { url = "https://files.pythonhosted.org/packages/db/ef/729d23510eaa81f0ce9d938d99d72dcf5e4ed3609d9d0bcf9c8a282cc41a/orjson-3.11.1-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:0ed0fce2307843b79a0c83de49f65b86197f1e2310de07af9db2a1a77a61ce4c", size = 130938, upload-time = "2025-07-25T14:32:21.769Z" },
-    { url = "https://files.pythonhosted.org/packages/82/96/120feb6807f9e1f4c68fc842a0f227db8575eafb1a41b2537567b91c19d8/orjson-3.11.1-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:5a31e84782a18c30abd56774c0cfa7b9884589f4d37d9acabfa0504dad59bb9d", size = 130811, upload-time = "2025-07-25T14:32:22.931Z" },
-    { url = "https://files.pythonhosted.org/packages/89/66/4695e946a453fa22ff945da4b1ed0691b3f4ec86b828d398288db4a0ff79/orjson-3.11.1-cp311-cp311-musllinux_1_2_armv7l.whl", hash = "sha256:26b6c821abf1ae515fbb8e140a2406c9f9004f3e52acb780b3dee9bfffddbd84", size = 404272, upload-time = "2025-07-25T14:32:25.238Z" },
-    { url = "https://files.pythonhosted.org/packages/cd/7b/1c953e2c9e55af126c6cb678a30796deb46d7713abdeb706b8765929464c/orjson-3.11.1-cp311-cp311-musllinux_1_2_i686.whl", hash = "sha256:f857b3d134b36a8436f1e24dcb525b6b945108b30746c1b0b556200b5cb76d39", size = 146196, upload-time = "2025-07-25T14:32:26.909Z" },
-    { url = "https://files.pythonhosted.org/packages/bf/c2/bef5d3bc83f2e178592ff317e2cf7bd38ebc16b641f076ea49f27aadd1d3/orjson-3.11.1-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:df146f2a14116ce80f7da669785fcb411406d8e80136558b0ecda4c924b9ac55", size = 135336, upload-time = "2025-07-25T14:32:28.22Z" },
-    { url = "https://files.pythonhosted.org/packages/92/95/bc6006881ebdb4608ed900a763c3e3c6be0d24c3aadd62beb774f9464ec6/orjson-3.11.1-cp311-cp311-win32.whl", hash = "sha256:d777c57c1f86855fe5492b973f1012be776e0398571f7cc3970e9a58ecf4dc17", size = 136665, upload-time = "2025-07-25T14:32:29.976Z" },
-    { url = "https://files.pythonhosted.org/packages/59/c3/1f2b9cc0c60ea2473d386fed2df2b25ece50aeb73c798d4669aadff3061e/orjson-3.11.1-cp311-cp311-win_amd64.whl", hash = "sha256:e9a5fd589951f02ec2fcb8d69339258bbf74b41b104c556e6d4420ea5e059313", size = 131388, upload-time = "2025-07-25T14:32:31.595Z" },
-    { url = "https://files.pythonhosted.org/packages/b0/e5/40c97e5a6b85944022fe54b463470045b8651b7bb2f1e16a95c42812bf97/orjson-3.11.1-cp311-cp311-win_arm64.whl", hash = "sha256:4cddbe41ee04fddad35d75b9cf3e3736ad0b80588280766156b94783167777af", size = 126786, upload-time = "2025-07-25T14:32:32.787Z" },
-    { url = "https://files.pythonhosted.org/packages/98/77/e55513826b712807caadb2b733eee192c1df105c6bbf0d965c253b72f124/orjson-3.11.1-cp312-cp312-macosx_10_15_x86_64.macosx_11_0_arm64.macosx_10_15_universal2.whl", hash = "sha256:2b7c8be96db3a977367250c6367793a3c5851a6ca4263f92f0b48d00702f9910", size = 240955, upload-time = "2025-07-25T14:32:34.056Z" },
-    { url = "https://files.pythonhosted.org/packages/c9/88/a78132dddcc9c3b80a9fa050b3516bb2c996a9d78ca6fb47c8da2a80a696/orjson-3.11.1-cp312-cp312-macosx_15_0_arm64.whl", hash = "sha256:72e18088f567bd4a45db5e3196677d9ed1605e356e500c8e32dd6e303167a13d", size = 129294, upload-time = "2025-07-25T14:32:35.323Z" },
-    { url = "https://files.pythonhosted.org/packages/09/02/6591e0dcb2af6bceea96cb1b5f4b48c1445492a3ef2891ac4aa306bb6f73/orjson-3.11.1-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:d346e2ae1ce17888f7040b65a5a4a0c9734cb20ffbd228728661e020b4c8b3a5", size = 132310, upload-time = "2025-07-25T14:32:36.53Z" },
-    { url = "https://files.pythonhosted.org/packages/e9/36/c1cfbc617bcfa4835db275d5e0fe9bbdbe561a4b53d3b2de16540ec29c50/orjson-3.11.1-cp312-cp312-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:4bda5426ebb02ceb806a7d7ec9ba9ee5e0c93fca62375151a7b1c00bc634d06b", size = 128529, upload-time = "2025-07-25T14:32:37.817Z" },
-    { url = "https://files.pythonhosted.org/packages/7c/bd/91a156c5df3aaf1d68b2ab5be06f1969955a8d3e328d7794f4338ac1d017/orjson-3.11.1-cp312-cp312-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:10506cebe908542c4f024861102673db534fd2e03eb9b95b30d94438fa220abf", size = 130925, upload-time = "2025-07-25T14:32:39.03Z" },
-    { url = "https://files.pythonhosted.org/packages/a3/4c/a65cc24e9a5f87c9833a50161ab97b5edbec98bec99dfbba13827549debc/orjson-3.11.1-cp312-cp312-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:45202ee3f5494644e064c41abd1320497fb92fd31fc73af708708af664ac3b56", size = 132432, upload-time = "2025-07-25T14:32:40.619Z" },
-    { url = "https://files.pythonhosted.org/packages/2e/4d/3fc3e5d7115f4f7d01b481e29e5a79bcbcc45711a2723242787455424f40/orjson-3.11.1-cp312-cp312-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:e5adaf01b92e0402a9ac5c3ebe04effe2bbb115f0914a0a53d34ea239a746289", size = 135069, upload-time = "2025-07-25T14:32:41.84Z" },
-    { url = "https://files.pythonhosted.org/packages/dc/c6/7585aa8522af896060dc0cd7c336ba6c574ae854416811ee6642c505cc95/orjson-3.11.1-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:6162a1a757a1f1f4a94bc6ffac834a3602e04ad5db022dd8395a54ed9dd51c81", size = 131045, upload-time = "2025-07-25T14:32:43.085Z" },
-    { url = "https://files.pythonhosted.org/packages/6a/4e/b8a0a943793d2708ebc39e743c943251e08ee0f3279c880aefd8e9cb0c70/orjson-3.11.1-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:78404206977c9f946613d3f916727c189d43193e708d760ea5d4b2087d6b0968", size = 130597, upload-time = "2025-07-25T14:32:44.336Z" },
-    { url = "https://files.pythonhosted.org/packages/72/2b/7d30e2aed2f585d5d385fb45c71d9b16ba09be58c04e8767ae6edc6c9282/orjson-3.11.1-cp312-cp312-musllinux_1_2_armv7l.whl", hash = "sha256:db48f8e81072e26df6cdb0e9fff808c28597c6ac20a13d595756cf9ba1fed48a", size = 404207, upload-time = "2025-07-25T14:32:45.612Z" },
-    { url = "https://files.pythonhosted.org/packages/1b/7e/772369ec66fcbce79477f0891918309594cd00e39b67a68d4c445d2ab754/orjson-3.11.1-cp312-cp312-musllinux_1_2_i686.whl", hash = "sha256:0c1e394e67ced6bb16fea7054d99fbdd99a539cf4d446d40378d4c06e0a8548d", size = 146628, upload-time = "2025-07-25T14:32:46.981Z" },
-    { url = "https://files.pythonhosted.org/packages/b4/c8/62bdb59229d7e393ae309cef41e32cc1f0b567b21dfd0742da70efb8b40c/orjson-3.11.1-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:e7a840752c93d4eecd1378e9bb465c3703e127b58f675cd5c620f361b6cf57a4", size = 135449, upload-time = "2025-07-25T14:32:48.727Z" },
-    { url = "https://files.pythonhosted.org/packages/02/47/1c99aa60e19f781424eabeaacd9e999eafe5b59c81ead4273b773f0f3af1/orjson-3.11.1-cp312-cp312-win32.whl", hash = "sha256:4537b0e09f45d2b74cb69c7f39ca1e62c24c0488d6bf01cd24673c74cd9596bf", size = 136653, upload-time = "2025-07-25T14:32:50.622Z" },
-    { url = "https://files.pythonhosted.org/packages/31/9a/132999929a2892ab07e916669accecc83e5bff17e11a1186b4c6f23231f0/orjson-3.11.1-cp312-cp312-win_amd64.whl", hash = "sha256:dbee6b050062540ae404530cacec1bf25e56e8d87d8d9b610b935afeb6725cae", size = 131426, upload-time = "2025-07-25T14:32:51.883Z" },
-    { url = "https://files.pythonhosted.org/packages/9c/77/d984ee5a1ca341090902e080b187721ba5d1573a8d9759e0c540975acfb2/orjson-3.11.1-cp312-cp312-win_arm64.whl", hash = "sha256:f55e557d4248322d87c4673e085c7634039ff04b47bfc823b87149ae12bef60d", size = 126635, upload-time = "2025-07-25T14:32:53.2Z" },
-    { url = "https://files.pythonhosted.org/packages/c9/e9/880ef869e6f66279ce3a381a32afa0f34e29a94250146911eee029e56efc/orjson-3.11.1-cp313-cp313-macosx_10_15_x86_64.macosx_11_0_arm64.macosx_10_15_universal2.whl", hash = "sha256:53cfefe4af059e65aabe9683f76b9c88bf34b4341a77d329227c2424e0e59b0e", size = 240835, upload-time = "2025-07-25T14:32:54.507Z" },
-    { url = "https://files.pythonhosted.org/packages/f0/1f/52039ef3d03eeea21763b46bc99ebe11d9de8510c72b7b5569433084a17e/orjson-3.11.1-cp313-cp313-macosx_15_0_arm64.whl", hash = "sha256:93d5abed5a6f9e1b6f9b5bf6ed4423c11932b5447c2f7281d3b64e0f26c6d064", size = 129226, upload-time = "2025-07-25T14:32:55.908Z" },
-    { url = "https://files.pythonhosted.org/packages/ee/da/59fdffc9465a760be2cd3764ef9cd5535eec8f095419f972fddb123b6d0e/orjson-3.11.1-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:5dbf06642f3db2966df504944cdd0eb68ca2717f0353bb20b20acd78109374a6", size = 132261, upload-time = "2025-07-25T14:32:57.538Z" },
-    { url = "https://files.pythonhosted.org/packages/bb/5c/8610911c7e969db7cf928c8baac4b2f1e68d314bc3057acf5ca64f758435/orjson-3.11.1-cp313-cp313-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:dddf4e78747fa7f2188273f84562017a3c4f0824485b78372513c1681ea7a894", size = 128614, upload-time = "2025-07-25T14:32:58.808Z" },
-    { url = "https://files.pythonhosted.org/packages/f7/a1/a1db9d4310d014c90f3b7e9b72c6fb162cba82c5f46d0b345669eaebdd3a/orjson-3.11.1-cp313-cp313-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:fa3fe8653c9f57f0e16f008e43626485b6723b84b2f741f54d1258095b655912", size = 130968, upload-time = "2025-07-25T14:33:00.038Z" },
-    { url = "https://files.pythonhosted.org/packages/56/ff/11acd1fd7c38ea7a1b5d6bf582ae3da05931bee64620995eb08fd63c77fe/orjson-3.11.1-cp313-cp313-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:6334d2382aff975a61f6f4d1c3daf39368b887c7de08f7c16c58f485dcf7adb2", size = 132439, upload-time = "2025-07-25T14:33:01.354Z" },
-    { url = "https://files.pythonhosted.org/packages/70/f9/bb564dd9450bf8725e034a8ad7f4ae9d4710a34caf63b85ce1c0c6d40af0/orjson-3.11.1-cp313-cp313-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:a3d0855b643f259ee0cb76fe3df4c04483354409a520a902b067c674842eb6b8", size = 135299, upload-time = "2025-07-25T14:33:03.079Z" },
-    { url = "https://files.pythonhosted.org/packages/94/bb/c8eafe6051405e241dda3691db4d9132d3c3462d1d10a17f50837dd130b4/orjson-3.11.1-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:0eacdfeefd0a79987926476eb16e0245546bedeb8febbbbcf4b653e79257a8e4", size = 131004, upload-time = "2025-07-25T14:33:04.416Z" },
-    { url = "https://files.pythonhosted.org/packages/a2/40/bed8d7dcf1bd2df8813bf010a25f645863a2f75e8e0ebdb2b55784cf1a62/orjson-3.11.1-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:0ed07faf9e4873518c60480325dcbc16d17c59a165532cccfb409b4cdbaeff24", size = 130583, upload-time = "2025-07-25T14:33:05.768Z" },
-    { url = "https://files.pythonhosted.org/packages/57/e7/cfa2eb803ad52d74fbb5424a429b5be164e51d23f1d853e5e037173a5c48/orjson-3.11.1-cp313-cp313-musllinux_1_2_armv7l.whl", hash = "sha256:d6d308dd578ae3658f62bb9eba54801533225823cd3248c902be1ebc79b5e014", size = 404218, upload-time = "2025-07-25T14:33:07.117Z" },
-    { url = "https://files.pythonhosted.org/packages/d5/21/bc703af5bc6e9c7e18dcf4404dcc4ec305ab9bb6c82d3aee5952c0c56abf/orjson-3.11.1-cp313-cp313-musllinux_1_2_i686.whl", hash = "sha256:c4aa13ca959ba6b15c0a98d3d204b850f9dc36c08c9ce422ffb024eb30d6e058", size = 146605, upload-time = "2025-07-25T14:33:08.55Z" },
-    { url = "https://files.pythonhosted.org/packages/8f/fe/d26a0150534c4965a06f556aa68bf3c3b82999d5d7b0facd3af7b390c4af/orjson-3.11.1-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:be3d0653322abc9b68e5bcdaee6cfd58fcbe9973740ab222b87f4d687232ab1f", size = 135434, upload-time = "2025-07-25T14:33:09.967Z" },
-    { url = "https://files.pythonhosted.org/packages/89/b6/1cb28365f08cbcffc464f8512320c6eb6db6a653f03d66de47ea3c19385f/orjson-3.11.1-cp313-cp313-win32.whl", hash = "sha256:4dd34e7e2518de8d7834268846f8cab7204364f427c56fb2251e098da86f5092", size = 136596, upload-time = "2025-07-25T14:33:11.333Z" },
-    { url = "https://files.pythonhosted.org/packages/f9/35/7870d0d3ed843652676d84d8a6038791113eacc85237b673b925802826b8/orjson-3.11.1-cp313-cp313-win_amd64.whl", hash = "sha256:d6895d32032b6362540e6d0694b19130bb4f2ad04694002dce7d8af588ca5f77", size = 131319, upload-time = "2025-07-25T14:33:12.614Z" },
-    { url = "https://files.pythonhosted.org/packages/b7/3e/5bcd50fd865eb664d4edfdaaaff51e333593ceb5695a22c0d0a0d2b187ba/orjson-3.11.1-cp313-cp313-win_arm64.whl", hash = "sha256:bb7c36d5d3570fcbb01d24fa447a21a7fe5a41141fd88e78f7994053cc4e28f4", size = 126613, upload-time = "2025-07-25T14:33:13.927Z" },
-    { url = "https://files.pythonhosted.org/packages/61/d8/0a5cd31ed100b4e569e143cb0cddefc21f0bcb8ce284f44bca0bb0e10f3d/orjson-3.11.1-cp314-cp314-macosx_10_15_x86_64.macosx_11_0_arm64.macosx_10_15_universal2.whl", hash = "sha256:7b71ef394327b3d0b39f6ea7ade2ecda2731a56c6a7cbf0d6a7301203b92a89b", size = 240819, upload-time = "2025-07-25T14:33:15.223Z" },
-    { url = "https://files.pythonhosted.org/packages/b9/95/7eb2c76c92192ceca16bc81845ff100bbb93f568b4b94d914b6a4da47d61/orjson-3.11.1-cp314-cp314-macosx_15_0_arm64.whl", hash = "sha256:77c0fe28ed659b62273995244ae2aa430e432c71f86e4573ab16caa2f2e3ca5e", size = 129218, upload-time = "2025-07-25T14:33:16.637Z" },
-    { url = "https://files.pythonhosted.org/packages/da/84/e6b67f301b18adbbc346882f456bea44daebbd032ba725dbd7b741e3a7f1/orjson-3.11.1-cp314-cp314-manylinux_2_34_aarch64.whl", hash = "sha256:1495692f1f1ba2467df429343388a0ed259382835922e124c0cfdd56b3d1f727", size = 132238, upload-time = "2025-07-25T14:33:17.934Z" },
-    { url = "https://files.pythonhosted.org/packages/84/78/a45a86e29d9b2f391f9d00b22da51bc4b46b86b788fd42df2c5fcf3e8005/orjson-3.11.1-cp314-cp314-manylinux_2_34_x86_64.whl", hash = "sha256:08c6a762fca63ca4dc04f66c48ea5d2428db55839fec996890e1bfaf057b658c", size = 130998, upload-time = "2025-07-25T14:33:19.282Z" },
-    { url = "https://files.pythonhosted.org/packages/ea/8f/6eb3ee6760d93b2ce996a8529164ee1f5bafbdf64b74c7314b68db622b32/orjson-3.11.1-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:9e26794fe3976810b2c01fda29bd9ac7c91a3c1284b29cc9a383989f7b614037", size = 130559, upload-time = "2025-07-25T14:33:20.589Z" },
-    { url = "https://files.pythonhosted.org/packages/1b/78/9572ae94bdba6813917c9387e7834224c011ea6b4530ade07d718fd31598/orjson-3.11.1-cp314-cp314-musllinux_1_2_armv7l.whl", hash = "sha256:4b4b4f8f0b1d3ef8dc73e55363a0ffe012a42f4e2f1a140bf559698dca39b3fa", size = 404231, upload-time = "2025-07-25T14:33:22.019Z" },
-    { url = "https://files.pythonhosted.org/packages/1f/a3/68381ad0757e084927c5ee6cfdeab1c6c89405949ee493db557e60871c4c/orjson-3.11.1-cp314-cp314-musllinux_1_2_i686.whl", hash = "sha256:848be553ea35aa89bfefbed2e27c8a41244c862956ab8ba00dc0b27e84fd58de", size = 146658, upload-time = "2025-07-25T14:33:23.675Z" },
-    { url = "https://files.pythonhosted.org/packages/00/db/fac56acf77aab778296c3f541a3eec643266f28ecd71d6c0cba251e47655/orjson-3.11.1-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:c964c29711a4b1df52f8d9966f015402a6cf87753a406c1c4405c407dd66fd45", size = 135443, upload-time = "2025-07-25T14:33:25.04Z" },
-    { url = "https://files.pythonhosted.org/packages/76/b1/326fa4b87426197ead61c1eec2eeb3babc9eb33b480ac1f93894e40c8c08/orjson-3.11.1-cp314-cp314-win32.whl", hash = "sha256:33aada2e6b6bc9c540d396528b91e666cedb383740fee6e6a917f561b390ecb1", size = 136643, upload-time = "2025-07-25T14:33:26.449Z" },
-    { url = "https://files.pythonhosted.org/packages/0f/8e/2987ae2109f3bfd39680f8a187d1bc09ad7f8fb019dcdc719b08c7242ade/orjson-3.11.1-cp314-cp314-win_amd64.whl", hash = "sha256:68e10fd804e44e36188b9952543e3fa22f5aa8394da1b5283ca2b423735c06e8", size = 131324, upload-time = "2025-07-25T14:33:27.896Z" },
-    { url = "https://files.pythonhosted.org/packages/21/5f/253e08e6974752b124fbf3a4de3ad53baa766b0cb4a333d47706d307e396/orjson-3.11.1-cp314-cp314-win_arm64.whl", hash = "sha256:f3cf6c07f8b32127d836be8e1c55d4f34843f7df346536da768e9f73f22078a1", size = 126605, upload-time = "2025-07-25T14:33:29.244Z" },
-    { url = "https://files.pythonhosted.org/packages/f5/64/ce5c07420fe7367bd3da769161f07ae54b35c552468c6eb7947c023a25c6/orjson-3.11.1-cp39-cp39-macosx_10_15_x86_64.macosx_11_0_arm64.macosx_10_15_universal2.whl", hash = "sha256:3d593a9e0bccf2c7401ae53625b519a7ad7aa555b1c82c0042b322762dc8af4e", size = 241861, upload-time = "2025-07-25T14:33:30.585Z" },
-    { url = "https://files.pythonhosted.org/packages/94/17/7894ff2867e83d0d5cdda6e41210963a88764b292ec7a91fa93bcb5afd9e/orjson-3.11.1-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:0baad413c498fc1eef568504f11ea46bc71f94b845c075e437da1e2b85b4fb86", size = 132485, upload-time = "2025-07-25T14:33:32.123Z" },
-    { url = "https://files.pythonhosted.org/packages/8e/38/e8f907733e281e65ba912be552fe5ad5b53f0fdddaa0b43c3a9bc0bce5df/orjson-3.11.1-cp39-cp39-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:22cf17ae1dae3f9b5f37bfcdba002ed22c98bbdb70306e42dc18d8cc9b50399a", size = 128513, upload-time = "2025-07-25T14:33:33.571Z" },
-    { url = "https://files.pythonhosted.org/packages/d5/49/d6d0f23036a16c9909ca4cb09d53b2bf9341e7b1ae7d03ded302a3673448/orjson-3.11.1-cp39-cp39-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:e855c1e97208133ce88b3ef6663c9a82ddf1d09390cd0856a1638deee0390c3c", size = 130462, upload-time = "2025-07-25T14:33:35.061Z" },
-    { url = "https://files.pythonhosted.org/packages/04/70/df75afdfe6d3c027c03d656f0a5074159ace27a24dbf22d4af7fabf811df/orjson-3.11.1-cp39-cp39-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:b5861c5f7acff10599132854c70ab10abf72aebf7c627ae13575e5f20b1ab8fe", size = 132438, upload-time = "2025-07-25T14:33:36.893Z" },
-    { url = "https://files.pythonhosted.org/packages/56/ef/938ae6995965cc7884d8460177bed20248769d1edf99d1904dfd46eebd7d/orjson-3.11.1-cp39-cp39-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:b1e6415c5b5ff3a616a6dafad7b6ec303a9fc625e9313c8e1268fb1370a63dcb", size = 134928, upload-time = "2025-07-25T14:33:38.755Z" },
-    { url = "https://files.pythonhosted.org/packages/b5/2c/97be96e9ed22123724611c8511f306a69e6cd0273d4c6424edda5716d108/orjson-3.11.1-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:912579642f5d7a4a84d93c5eed8daf0aa34e1f2d3f4dc6571a8e418703f5701e", size = 130903, upload-time = "2025-07-25T14:33:40.585Z" },
-    { url = "https://files.pythonhosted.org/packages/86/ed/7cf17c1621a5a4c6716dfa8099dc9a4153cc8bd402195ae9028d7e5286e3/orjson-3.11.1-cp39-cp39-musllinux_1_2_aarch64.whl", hash = "sha256:2092e1d3b33f64e129ff8271642afddc43763c81f2c30823b4a4a4a5f2ea5b55", size = 130793, upload-time = "2025-07-25T14:33:42.397Z" },
-    { url = "https://files.pythonhosted.org/packages/5e/72/add1805918b6af187c193895d38bddc7717eea30d1ea8b25833a9668b469/orjson-3.11.1-cp39-cp39-musllinux_1_2_armv7l.whl", hash = "sha256:b8ac64caba1add2c04e9cd4782d4d0c4d6c554b7a3369bdec1eed7854c98db7b", size = 404283, upload-time = "2025-07-25T14:33:44.035Z" },
-    { url = "https://files.pythonhosted.org/packages/bb/f1/b27c05bab8b49ff2fb30e6c42e8602ae51d6c9dd19564031da37f7ea61ba/orjson-3.11.1-cp39-cp39-musllinux_1_2_i686.whl", hash = "sha256:23196b826ebc85c43f8e27bee0ab33c5fb13a29ea47fb4fcd6ebb1e660eb0252", size = 146169, upload-time = "2025-07-25T14:33:46.036Z" },
-    { url = "https://files.pythonhosted.org/packages/91/5b/5a2cdc081bc2093708726887980d8f0c7c0edc31ab0d3c5ccc1db70ede0e/orjson-3.11.1-cp39-cp39-musllinux_1_2_x86_64.whl", hash = "sha256:f2d3364cfad43003f1e3d564a069c8866237cca30f9c914b26ed2740b596ed00", size = 135304, upload-time = "2025-07-25T14:33:47.519Z" },
-    { url = "https://files.pythonhosted.org/packages/01/7f/fe09ebaecbaec6a741b29f79ccbbe38736dff51e8413f334067ad914df26/orjson-3.11.1-cp39-cp39-win32.whl", hash = "sha256:20b0dca94ea4ebe4628330de50975b35817a3f52954c1efb6d5d0498a3bbe581", size = 136652, upload-time = "2025-07-25T14:33:49.38Z" },
-    { url = "https://files.pythonhosted.org/packages/97/2f/71fe70d7d06087d8abef423843d880e3d4cf21cfc38c299feebb0a98f7c1/orjson-3.11.1-cp39-cp39-win_amd64.whl", hash = "sha256:200c3ad7ed8b5d31d49143265dfebd33420c4b61934ead16833b5cd2c3d241be", size = 131373, upload-time = "2025-07-25T14:33:51.359Z" },
+    { url = "https://files.pythonhosted.org/packages/a1/7b/7aebe925c6b1c46c8606a960fe1d6b681fccd4aaf3f37cd647c3309d6582/orjson-3.11.2-cp310-cp310-macosx_10_15_x86_64.macosx_11_0_arm64.macosx_10_15_universal2.whl", hash = "sha256:d6b8a78c33496230a60dc9487118c284c15ebdf6724386057239641e1eb69761", size = 226896, upload-time = "2025-08-12T15:10:22.02Z" },
+    { url = "https://files.pythonhosted.org/packages/7d/39/c952c9b0d51063e808117dd1e53668a2e4325cc63cfe7df453d853ee8680/orjson-3.11.2-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:cc04036eeae11ad4180d1f7b5faddb5dab1dee49ecd147cd431523869514873b", size = 111845, upload-time = "2025-08-12T15:10:24.963Z" },
+    { url = "https://files.pythonhosted.org/packages/f5/dc/90b7f29be38745eeacc30903b693f29fcc1097db0c2a19a71ffb3e9f2a5f/orjson-3.11.2-cp310-cp310-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:9c04325839c5754c253ff301cee8aaed7442d974860a44447bb3be785c411c27", size = 116395, upload-time = "2025-08-12T15:10:26.314Z" },
+    { url = "https://files.pythonhosted.org/packages/10/c2/fe84ba63164c22932b8d59b8810e2e58590105293a259e6dd1bfaf3422c9/orjson-3.11.2-cp310-cp310-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:32769e04cd7fdc4a59854376211145a1bbbc0aea5e9d6c9755d3d3c301d7c0df", size = 118768, upload-time = "2025-08-12T15:10:27.605Z" },
+    { url = "https://files.pythonhosted.org/packages/a9/ce/d9748ec69b1a4c29b8e2bab8233e8c41c583c69f515b373f1fb00247d8c9/orjson-3.11.2-cp310-cp310-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:0ff285d14917ea1408a821786e3677c5261fa6095277410409c694b8e7720ae0", size = 120887, upload-time = "2025-08-12T15:10:29.153Z" },
+    { url = "https://files.pythonhosted.org/packages/c1/66/b90fac8e4a76e83f981912d7f9524d402b31f6c1b8bff3e498aa321c326c/orjson-3.11.2-cp310-cp310-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:2662f908114864b63ff75ffe6ffacf996418dd6cc25e02a72ad4bda81b1ec45a", size = 123650, upload-time = "2025-08-12T15:10:30.602Z" },
+    { url = "https://files.pythonhosted.org/packages/33/81/56143898d1689c7f915ac67703efb97e8f2f8d5805ce8c2c3fd0f2bb6e3d/orjson-3.11.2-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:ab463cf5d08ad6623a4dac1badd20e88a5eb4b840050c4812c782e3149fe2334", size = 121287, upload-time = "2025-08-12T15:10:31.868Z" },
+    { url = "https://files.pythonhosted.org/packages/80/de/f9c6d00c127be766a3739d0d85b52a7c941e437d8dd4d573e03e98d0f89c/orjson-3.11.2-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:64414241bde943cbf3c00d45fcb5223dca6d9210148ba984aae6b5d63294502b", size = 119637, upload-time = "2025-08-12T15:10:33.078Z" },
+    { url = "https://files.pythonhosted.org/packages/67/4c/ab70c7627022d395c1b4eb5badf6196b7144e82b46a3a17ed2354f9e592d/orjson-3.11.2-cp310-cp310-musllinux_1_2_armv7l.whl", hash = "sha256:7773e71c0ae8c9660192ff144a3d69df89725325e3d0b6a6bb2c50e5ebaf9b84", size = 392478, upload-time = "2025-08-12T15:10:34.669Z" },
+    { url = "https://files.pythonhosted.org/packages/77/91/d890b873b69311db4fae2624c5603c437df9c857fb061e97706dac550a77/orjson-3.11.2-cp310-cp310-musllinux_1_2_i686.whl", hash = "sha256:652ca14e283b13ece35bf3a86503c25592f294dbcfc5bb91b20a9c9a62a3d4be", size = 134343, upload-time = "2025-08-12T15:10:35.978Z" },
+    { url = "https://files.pythonhosted.org/packages/47/16/1aa248541b4830274a079c4aeb2aa5d1ff17c3f013b1d0d8d16d0848f3de/orjson-3.11.2-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:26e99e98df8990ecfe3772bbdd7361f602149715c2cbc82e61af89bfad9528a4", size = 123887, upload-time = "2025-08-12T15:10:37.601Z" },
+    { url = "https://files.pythonhosted.org/packages/95/e4/7419833c55ac8b5f385d00c02685a260da1f391e900fc5c3e0b797e0d506/orjson-3.11.2-cp310-cp310-win32.whl", hash = "sha256:5814313b3e75a2be7fe6c7958201c16c4560e21a813dbad25920752cecd6ad66", size = 124560, upload-time = "2025-08-12T15:10:38.966Z" },
+    { url = "https://files.pythonhosted.org/packages/74/f8/27ca7ef3e194c462af32ce1883187f5ec483650c559166f0de59c4c2c5f0/orjson-3.11.2-cp310-cp310-win_amd64.whl", hash = "sha256:dc471ce2225ab4c42ca672f70600d46a8b8e28e8d4e536088c1ccdb1d22b35ce", size = 119700, upload-time = "2025-08-12T15:10:40.911Z" },
+    { url = "https://files.pythonhosted.org/packages/78/7d/e295df1ac9920cbb19fb4c1afa800e86f175cb657143aa422337270a4782/orjson-3.11.2-cp311-cp311-macosx_10_15_x86_64.macosx_11_0_arm64.macosx_10_15_universal2.whl", hash = "sha256:888b64ef7eaeeff63f773881929434a5834a6a140a63ad45183d59287f07fc6a", size = 226502, upload-time = "2025-08-12T15:10:42.284Z" },
+    { url = "https://files.pythonhosted.org/packages/65/21/ffb0f10ea04caf418fb4e7ad1fda4b9ab3179df9d7a33b69420f191aadd5/orjson-3.11.2-cp311-cp311-macosx_15_0_arm64.whl", hash = "sha256:83387cc8b26c9fa0ae34d1ea8861a7ae6cff8fb3e346ab53e987d085315a728e", size = 115999, upload-time = "2025-08-12T15:10:43.738Z" },
+    { url = "https://files.pythonhosted.org/packages/90/d5/8da1e252ac3353d92e6f754ee0c85027c8a2cda90b6899da2be0df3ef83d/orjson-3.11.2-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:d7e35f003692c216d7ee901b6b916b5734d6fc4180fcaa44c52081f974c08e17", size = 111563, upload-time = "2025-08-12T15:10:45.301Z" },
+    { url = "https://files.pythonhosted.org/packages/4f/81/baabc32e52c570b0e4e1044b1bd2ccbec965e0de3ba2c13082255efa2006/orjson-3.11.2-cp311-cp311-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:4a0a4c29ae90b11d0c00bcc31533854d89f77bde2649ec602f512a7e16e00640", size = 116222, upload-time = "2025-08-12T15:10:46.92Z" },
+    { url = "https://files.pythonhosted.org/packages/8d/b7/da2ad55ad80b49b560dce894c961477d0e76811ee6e614b301de9f2f8728/orjson-3.11.2-cp311-cp311-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:585d712b1880f68370108bc5534a257b561672d1592fae54938738fe7f6f1e33", size = 118594, upload-time = "2025-08-12T15:10:48.488Z" },
+    { url = "https://files.pythonhosted.org/packages/61/be/014f7eab51449f3c894aa9bbda2707b5340c85650cb7d0db4ec9ae280501/orjson-3.11.2-cp311-cp311-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:d08e342a7143f8a7c11f1c4033efe81acbd3c98c68ba1b26b96080396019701f", size = 120700, upload-time = "2025-08-12T15:10:49.811Z" },
+    { url = "https://files.pythonhosted.org/packages/cf/ae/c217903a30c51341868e2d8c318c59a8413baa35af54d7845071c8ccd6fe/orjson-3.11.2-cp311-cp311-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:29c0f84fc50398773a702732c87cd622737bf11c0721e6db3041ac7802a686fb", size = 123433, upload-time = "2025-08-12T15:10:51.06Z" },
+    { url = "https://files.pythonhosted.org/packages/57/c2/b3c346f78b1ff2da310dd300cb0f5d32167f872b4d3bb1ad122c889d97b0/orjson-3.11.2-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:140f84e3c8d4c142575898c91e3981000afebf0333df753a90b3435d349a5fe5", size = 121061, upload-time = "2025-08-12T15:10:52.381Z" },
+    { url = "https://files.pythonhosted.org/packages/00/c8/c97798f6010327ffc75ad21dd6bca11ea2067d1910777e798c2849f1c68f/orjson-3.11.2-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:96304a2b7235e0f3f2d9363ddccdbfb027d27338722fe469fe656832a017602e", size = 119410, upload-time = "2025-08-12T15:10:53.692Z" },
+    { url = "https://files.pythonhosted.org/packages/37/fd/df720f7c0e35694617b7f95598b11a2cb0374661d8389703bea17217da53/orjson-3.11.2-cp311-cp311-musllinux_1_2_armv7l.whl", hash = "sha256:3d7612bb227d5d9582f1f50a60bd55c64618fc22c4a32825d233a4f2771a428a", size = 392294, upload-time = "2025-08-12T15:10:55.079Z" },
+    { url = "https://files.pythonhosted.org/packages/ba/52/0120d18f60ab0fe47531d520372b528a45c9a25dcab500f450374421881c/orjson-3.11.2-cp311-cp311-musllinux_1_2_i686.whl", hash = "sha256:a134587d18fe493befc2defffef2a8d27cfcada5696cb7234de54a21903ae89a", size = 134134, upload-time = "2025-08-12T15:10:56.568Z" },
+    { url = "https://files.pythonhosted.org/packages/ec/10/1f967671966598366de42f07e92b0fc694ffc66eafa4b74131aeca84915f/orjson-3.11.2-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:0b84455e60c4bc12c1e4cbaa5cfc1acdc7775a9da9cec040e17232f4b05458bd", size = 123745, upload-time = "2025-08-12T15:10:57.907Z" },
+    { url = "https://files.pythonhosted.org/packages/43/eb/76081238671461cfd0f47e0c24f408ffa66184237d56ef18c33e86abb612/orjson-3.11.2-cp311-cp311-win32.whl", hash = "sha256:f0660efeac223f0731a70884e6914a5f04d613b5ae500744c43f7bf7b78f00f9", size = 124393, upload-time = "2025-08-12T15:10:59.267Z" },
+    { url = "https://files.pythonhosted.org/packages/26/76/cc598c1811ba9ba935171267b02e377fc9177489efce525d478a2999d9cc/orjson-3.11.2-cp311-cp311-win_amd64.whl", hash = "sha256:955811c8405251d9e09cbe8606ad8fdef49a451bcf5520095a5ed38c669223d8", size = 119561, upload-time = "2025-08-12T15:11:00.559Z" },
+    { url = "https://files.pythonhosted.org/packages/d8/17/c48011750f0489006f7617b0a3cebc8230f36d11a34e7e9aca2085f07792/orjson-3.11.2-cp311-cp311-win_arm64.whl", hash = "sha256:2e4d423a6f838552e3a6d9ec734b729f61f88b1124fd697eab82805ea1a2a97d", size = 114186, upload-time = "2025-08-12T15:11:01.931Z" },
+    { url = "https://files.pythonhosted.org/packages/40/02/46054ebe7996a8adee9640dcad7d39d76c2000dc0377efa38e55dc5cbf78/orjson-3.11.2-cp312-cp312-macosx_10_15_x86_64.macosx_11_0_arm64.macosx_10_15_universal2.whl", hash = "sha256:901d80d349d8452162b3aa1afb82cec5bee79a10550660bc21311cc61a4c5486", size = 226528, upload-time = "2025-08-12T15:11:03.317Z" },
+    { url = "https://files.pythonhosted.org/packages/e2/c6/6b6f0b4d8aea1137436546b990f71be2cd8bd870aa2f5aa14dba0fcc95dc/orjson-3.11.2-cp312-cp312-macosx_15_0_arm64.whl", hash = "sha256:cf3bd3967a360e87ee14ed82cb258b7f18c710dacf3822fb0042a14313a673a1", size = 115931, upload-time = "2025-08-12T15:11:04.759Z" },
+    { url = "https://files.pythonhosted.org/packages/ae/05/4205cc97c30e82a293dd0d149b1a89b138ebe76afeca66fc129fa2aa4e6a/orjson-3.11.2-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:26693dde66910078229a943e80eeb99fdce6cd2c26277dc80ead9f3ab97d2131", size = 111382, upload-time = "2025-08-12T15:11:06.468Z" },
+    { url = "https://files.pythonhosted.org/packages/50/c7/b8a951a93caa821f9272a7c917115d825ae2e4e8768f5ddf37968ec9de01/orjson-3.11.2-cp312-cp312-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:4ad4c8acb50a28211c33fc7ef85ddf5cb18d4636a5205fd3fa2dce0411a0e30c", size = 116271, upload-time = "2025-08-12T15:11:07.845Z" },
+    { url = "https://files.pythonhosted.org/packages/17/03/1006c7f8782d5327439e26d9b0ec66500ea7b679d4bbb6b891d2834ab3ee/orjson-3.11.2-cp312-cp312-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:994181e7f1725bb5f2d481d7d228738e0743b16bf319ca85c29369c65913df14", size = 119086, upload-time = "2025-08-12T15:11:09.329Z" },
+    { url = "https://files.pythonhosted.org/packages/44/61/57d22bc31f36a93878a6f772aea76b2184102c6993dea897656a66d18c74/orjson-3.11.2-cp312-cp312-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:dbb79a0476393c07656b69c8e763c3cc925fa8e1d9e9b7d1f626901bb5025448", size = 120724, upload-time = "2025-08-12T15:11:10.674Z" },
+    { url = "https://files.pythonhosted.org/packages/78/a9/4550e96b4c490c83aea697d5347b8f7eb188152cd7b5a38001055ca5b379/orjson-3.11.2-cp312-cp312-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:191ed27a1dddb305083d8716af413d7219f40ec1d4c9b0e977453b4db0d6fb6c", size = 123577, upload-time = "2025-08-12T15:11:12.015Z" },
+    { url = "https://files.pythonhosted.org/packages/3a/86/09b8cb3ebd513d708ef0c92d36ac3eebda814c65c72137b0a82d6d688fc4/orjson-3.11.2-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:0afb89f16f07220183fd00f5f297328ed0a68d8722ad1b0c8dcd95b12bc82804", size = 121195, upload-time = "2025-08-12T15:11:13.399Z" },
+    { url = "https://files.pythonhosted.org/packages/37/68/7b40b39ac2c1c644d4644e706d0de6c9999764341cd85f2a9393cb387661/orjson-3.11.2-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:6ab6e6b4e93b1573a026b6ec16fca9541354dd58e514b62c558b58554ae04307", size = 119234, upload-time = "2025-08-12T15:11:15.134Z" },
+    { url = "https://files.pythonhosted.org/packages/40/7c/bb6e7267cd80c19023d44d8cbc4ea4ed5429fcd4a7eb9950f50305697a28/orjson-3.11.2-cp312-cp312-musllinux_1_2_armv7l.whl", hash = "sha256:9cb23527efb61fb75527df55d20ee47989c4ee34e01a9c98ee9ede232abf6219", size = 392250, upload-time = "2025-08-12T15:11:16.604Z" },
+    { url = "https://files.pythonhosted.org/packages/64/f2/6730ace05583dbca7c1b406d59f4266e48cd0d360566e71482420fb849fc/orjson-3.11.2-cp312-cp312-musllinux_1_2_i686.whl", hash = "sha256:a4dd1268e4035af21b8a09e4adf2e61f87ee7bf63b86d7bb0a237ac03fad5b45", size = 134572, upload-time = "2025-08-12T15:11:18.205Z" },
+    { url = "https://files.pythonhosted.org/packages/96/0f/7d3e03a30d5aac0432882b539a65b8c02cb6dd4221ddb893babf09c424cc/orjson-3.11.2-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:ff8b155b145eaf5a9d94d2c476fbe18d6021de93cf36c2ae2c8c5b775763f14e", size = 123869, upload-time = "2025-08-12T15:11:19.554Z" },
+    { url = "https://files.pythonhosted.org/packages/45/80/1513265eba6d4a960f078f4b1d2bff94a571ab2d28c6f9835e03dfc65cc6/orjson-3.11.2-cp312-cp312-win32.whl", hash = "sha256:ae3bb10279d57872f9aba68c9931aa71ed3b295fa880f25e68da79e79453f46e", size = 124430, upload-time = "2025-08-12T15:11:20.914Z" },
+    { url = "https://files.pythonhosted.org/packages/fb/61/eadf057b68a332351eeb3d89a4cc538d14f31cd8b5ec1b31a280426ccca2/orjson-3.11.2-cp312-cp312-win_amd64.whl", hash = "sha256:d026e1967239ec11a2559b4146a61d13914504b396f74510a1c4d6b19dfd8732", size = 119598, upload-time = "2025-08-12T15:11:22.372Z" },
+    { url = "https://files.pythonhosted.org/packages/6b/3f/7f4b783402143d965ab7e9a2fc116fdb887fe53bdce7d3523271cd106098/orjson-3.11.2-cp312-cp312-win_arm64.whl", hash = "sha256:59f8d5ad08602711af9589375be98477d70e1d102645430b5a7985fdbf613b36", size = 114052, upload-time = "2025-08-12T15:11:23.762Z" },
+    { url = "https://files.pythonhosted.org/packages/c2/f3/0dd6b4750eb556ae4e2c6a9cb3e219ec642e9c6d95f8ebe5dc9020c67204/orjson-3.11.2-cp313-cp313-macosx_10_15_x86_64.macosx_11_0_arm64.macosx_10_15_universal2.whl", hash = "sha256:a079fdba7062ab396380eeedb589afb81dc6683f07f528a03b6f7aae420a0219", size = 226419, upload-time = "2025-08-12T15:11:25.517Z" },
+    { url = "https://files.pythonhosted.org/packages/44/d5/e67f36277f78f2af8a4690e0c54da6b34169812f807fd1b4bfc4dbcf9558/orjson-3.11.2-cp313-cp313-macosx_15_0_arm64.whl", hash = "sha256:6a5f62ebbc530bb8bb4b1ead103647b395ba523559149b91a6c545f7cd4110ad", size = 115803, upload-time = "2025-08-12T15:11:27.357Z" },
+    { url = "https://files.pythonhosted.org/packages/24/37/ff8bc86e0dacc48f07c2b6e20852f230bf4435611bab65e3feae2b61f0ae/orjson-3.11.2-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:d7df6c7b8b0931feb3420b72838c3e2ba98c228f7aa60d461bc050cf4ca5f7b2", size = 111337, upload-time = "2025-08-12T15:11:28.805Z" },
+    { url = "https://files.pythonhosted.org/packages/b9/25/37d4d3e8079ea9784ea1625029988e7f4594ce50d4738b0c1e2bf4a9e201/orjson-3.11.2-cp313-cp313-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:6f59dfea7da1fced6e782bb3699718088b1036cb361f36c6e4dd843c5111aefe", size = 116222, upload-time = "2025-08-12T15:11:30.18Z" },
+    { url = "https://files.pythonhosted.org/packages/b7/32/a63fd9c07fce3b4193dcc1afced5dd4b0f3a24e27556604e9482b32189c9/orjson-3.11.2-cp313-cp313-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:edf49146520fef308c31aa4c45b9925fd9c7584645caca7c0c4217d7900214ae", size = 119020, upload-time = "2025-08-12T15:11:31.59Z" },
+    { url = "https://files.pythonhosted.org/packages/b4/b6/400792b8adc3079a6b5d649264a3224d6342436d9fac9a0ed4abc9dc4596/orjson-3.11.2-cp313-cp313-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:50995bbeb5d41a32ad15e023305807f561ac5dcd9bd41a12c8d8d1d2c83e44e6", size = 120721, upload-time = "2025-08-12T15:11:33.035Z" },
+    { url = "https://files.pythonhosted.org/packages/40/f3/31ab8f8c699eb9e65af8907889a0b7fef74c1d2b23832719a35da7bb0c58/orjson-3.11.2-cp313-cp313-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:2cc42960515076eb639b705f105712b658c525863d89a1704d984b929b0577d1", size = 123574, upload-time = "2025-08-12T15:11:34.433Z" },
+    { url = "https://files.pythonhosted.org/packages/bd/a6/ce4287c412dff81878f38d06d2c80845709c60012ca8daf861cb064b4574/orjson-3.11.2-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:c56777cab2a7b2a8ea687fedafb84b3d7fdafae382165c31a2adf88634c432fa", size = 121225, upload-time = "2025-08-12T15:11:36.133Z" },
+    { url = "https://files.pythonhosted.org/packages/69/b0/7a881b2aef4fed0287d2a4fbb029d01ed84fa52b4a68da82bdee5e50598e/orjson-3.11.2-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:07349e88025b9b5c783077bf7a9f401ffbfb07fd20e86ec6fc5b7432c28c2c5e", size = 119201, upload-time = "2025-08-12T15:11:37.642Z" },
+    { url = "https://files.pythonhosted.org/packages/cf/98/a325726b37f7512ed6338e5e65035c3c6505f4e628b09a5daf0419f054ea/orjson-3.11.2-cp313-cp313-musllinux_1_2_armv7l.whl", hash = "sha256:45841fbb79c96441a8c58aa29ffef570c5df9af91f0f7a9572e5505e12412f15", size = 392193, upload-time = "2025-08-12T15:11:39.153Z" },
+    { url = "https://files.pythonhosted.org/packages/cb/4f/a7194f98b0ce1d28190e0c4caa6d091a3fc8d0107ad2209f75c8ba398984/orjson-3.11.2-cp313-cp313-musllinux_1_2_i686.whl", hash = "sha256:13d8d8db6cd8d89d4d4e0f4161acbbb373a4d2a4929e862d1d2119de4aa324ac", size = 134548, upload-time = "2025-08-12T15:11:40.768Z" },
+    { url = "https://files.pythonhosted.org/packages/e8/5e/b84caa2986c3f472dc56343ddb0167797a708a8d5c3be043e1e2677b55df/orjson-3.11.2-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:51da1ee2178ed09c00d09c1b953e45846bbc16b6420965eb7a913ba209f606d8", size = 123798, upload-time = "2025-08-12T15:11:42.164Z" },
+    { url = "https://files.pythonhosted.org/packages/9c/5b/e398449080ce6b4c8fcadad57e51fa16f65768e1b142ba90b23ac5d10801/orjson-3.11.2-cp313-cp313-win32.whl", hash = "sha256:51dc033df2e4a4c91c0ba4f43247de99b3cbf42ee7a42ee2b2b2f76c8b2f2cb5", size = 124402, upload-time = "2025-08-12T15:11:44.036Z" },
+    { url = "https://files.pythonhosted.org/packages/b3/66/429e4608e124debfc4790bfc37131f6958e59510ba3b542d5fc163be8e5f/orjson-3.11.2-cp313-cp313-win_amd64.whl", hash = "sha256:29d91d74942b7436f29b5d1ed9bcfc3f6ef2d4f7c4997616509004679936650d", size = 119498, upload-time = "2025-08-12T15:11:45.864Z" },
+    { url = "https://files.pythonhosted.org/packages/7b/04/f8b5f317cce7ad3580a9ad12d7e2df0714dfa8a83328ecddd367af802f5b/orjson-3.11.2-cp313-cp313-win_arm64.whl", hash = "sha256:4ca4fb5ac21cd1e48028d4f708b1bb13e39c42d45614befd2ead004a8bba8535", size = 114051, upload-time = "2025-08-12T15:11:47.555Z" },
+    { url = "https://files.pythonhosted.org/packages/74/83/2c363022b26c3c25b3708051a19d12f3374739bb81323f05b284392080c0/orjson-3.11.2-cp314-cp314-macosx_10_15_x86_64.macosx_11_0_arm64.macosx_10_15_universal2.whl", hash = "sha256:3dcba7101ea6a8d4ef060746c0f2e7aa8e2453a1012083e1ecce9726d7554cb7", size = 226406, upload-time = "2025-08-12T15:11:49.445Z" },
+    { url = "https://files.pythonhosted.org/packages/b0/a7/aa3c973de0b33fc93b4bd71691665ffdfeae589ea9d0625584ab10a7d0f5/orjson-3.11.2-cp314-cp314-macosx_15_0_arm64.whl", hash = "sha256:15d17bdb76a142e1f55d91913e012e6e6769659daa6bfef3ef93f11083137e81", size = 115788, upload-time = "2025-08-12T15:11:50.992Z" },
+    { url = "https://files.pythonhosted.org/packages/ef/f2/e45f233dfd09fdbb052ec46352363dca3906618e1a2b264959c18f809d0b/orjson-3.11.2-cp314-cp314-manylinux_2_34_aarch64.whl", hash = "sha256:53c9e81768c69d4b66b8876ec3c8e431c6e13477186d0db1089d82622bccd19f", size = 111318, upload-time = "2025-08-12T15:11:52.495Z" },
+    { url = "https://files.pythonhosted.org/packages/3e/23/cf5a73c4da6987204cbbf93167f353ff0c5013f7c5e5ef845d4663a366da/orjson-3.11.2-cp314-cp314-manylinux_2_34_x86_64.whl", hash = "sha256:d4f13af59a7b84c1ca6b8a7ab70d608f61f7c44f9740cd42409e6ae7b6c8d8b7", size = 121231, upload-time = "2025-08-12T15:11:53.941Z" },
+    { url = "https://files.pythonhosted.org/packages/40/1d/47468a398ae68a60cc21e599144e786e035bb12829cb587299ecebc088f1/orjson-3.11.2-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:bde64aa469b5ee46cc960ed241fae3721d6a8801dacb2ca3466547a2535951e4", size = 119204, upload-time = "2025-08-12T15:11:55.409Z" },
+    { url = "https://files.pythonhosted.org/packages/4d/d9/f99433d89b288b5bc8836bffb32a643f805e673cf840ef8bab6e73ced0d1/orjson-3.11.2-cp314-cp314-musllinux_1_2_armv7l.whl", hash = "sha256:b5ca86300aeb383c8fa759566aca065878d3d98c3389d769b43f0a2e84d52c5f", size = 392237, upload-time = "2025-08-12T15:11:57.18Z" },
+    { url = "https://files.pythonhosted.org/packages/d4/dc/1b9d80d40cebef603325623405136a29fb7d08c877a728c0943dd066c29a/orjson-3.11.2-cp314-cp314-musllinux_1_2_i686.whl", hash = "sha256:24e32a558ebed73a6a71c8f1cbc163a7dd5132da5270ff3d8eeb727f4b6d1bc7", size = 134578, upload-time = "2025-08-12T15:11:58.844Z" },
+    { url = "https://files.pythonhosted.org/packages/45/b3/72e7a4c5b6485ef4e83ef6aba7f1dd041002bad3eb5d1d106ca5b0fc02c6/orjson-3.11.2-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:e36319a5d15b97e4344110517450396845cc6789aed712b1fbf83c1bd95792f6", size = 123799, upload-time = "2025-08-12T15:12:00.352Z" },
+    { url = "https://files.pythonhosted.org/packages/c8/3e/a3d76b392e7acf9b34dc277171aad85efd6accc75089bb35b4c614990ea9/orjson-3.11.2-cp314-cp314-win32.whl", hash = "sha256:40193ada63fab25e35703454d65b6afc71dbc65f20041cb46c6d91709141ef7f", size = 124461, upload-time = "2025-08-12T15:12:01.854Z" },
+    { url = "https://files.pythonhosted.org/packages/fb/e3/75c6a596ff8df9e4a5894813ff56695f0a218e6ea99420b4a645c4f7795d/orjson-3.11.2-cp314-cp314-win_amd64.whl", hash = "sha256:7c8ac5f6b682d3494217085cf04dadae66efee45349ad4ee2a1da3c97e2305a8", size = 119494, upload-time = "2025-08-12T15:12:03.337Z" },
+    { url = "https://files.pythonhosted.org/packages/5b/3d/9e74742fc261c5ca473c96bb3344d03995869e1dc6402772c60afb97736a/orjson-3.11.2-cp314-cp314-win_arm64.whl", hash = "sha256:21cf261e8e79284242e4cb1e5924df16ae28255184aafeff19be1405f6d33f67", size = 114046, upload-time = "2025-08-12T15:12:04.87Z" },
+    { url = "https://files.pythonhosted.org/packages/4f/08/8ebc6dcac0938376b7e61dff432c33958505ae4c185dda3fa1e6f46ac40b/orjson-3.11.2-cp39-cp39-macosx_10_15_x86_64.macosx_11_0_arm64.macosx_10_15_universal2.whl", hash = "sha256:957f10c7b5bce3d3f2ad577f3b307c784f5dabafcce3b836229c269c11841c86", size = 226498, upload-time = "2025-08-12T15:12:06.51Z" },
+    { url = "https://files.pythonhosted.org/packages/ff/74/a97c8e2bc75a27dfeeb1b289645053f1889125447f3b7484a2e34ac55d2a/orjson-3.11.2-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:8a669e31ab8eb466c9142ac7a4be2bb2758ad236a31ef40dcd4cf8774ab40f33", size = 111529, upload-time = "2025-08-12T15:12:08.21Z" },
+    { url = "https://files.pythonhosted.org/packages/78/c3/55121b5722a1a4e4610a411866cfeada5314dc498cd42435b590353009d2/orjson-3.11.2-cp39-cp39-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:adedf7d887416c51ad49de3c53b111887e0b63db36c6eb9f846a8430952303d8", size = 116213, upload-time = "2025-08-12T15:12:09.776Z" },
+    { url = "https://files.pythonhosted.org/packages/54/d3/1c810fa36a749157f1ec68f825b09d5b6958ed5eaf66c7b89bc0f1656517/orjson-3.11.2-cp39-cp39-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:8ad8873979659ad98fc56377b9c5b93eb8059bf01e6412f7abf7dbb3d637a991", size = 118594, upload-time = "2025-08-12T15:12:11.363Z" },
+    { url = "https://files.pythonhosted.org/packages/09/9c/052a6619857aba27899246c1ac9e1566fe976dbb48c2d2d177eb269e6d92/orjson-3.11.2-cp39-cp39-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:9482ef83b2bf796157566dd2d2742a8a1e377045fe6065fa67acb1cb1d21d9a3", size = 120706, upload-time = "2025-08-12T15:12:13.265Z" },
+    { url = "https://files.pythonhosted.org/packages/4b/91/ed0632b8bafa5534d40483ca14f4b7b7e8f27a016f52ff771420b3591574/orjson-3.11.2-cp39-cp39-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:73cee7867c1fcbd1cc5b6688b3e13db067f968889242955780123a68b3d03316", size = 123412, upload-time = "2025-08-12T15:12:14.807Z" },
+    { url = "https://files.pythonhosted.org/packages/90/3d/058184ae52a2035098939329f8864c5e28c3bbd660f80d4f687f4fd3e629/orjson-3.11.2-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:465166773265f3cc25db10199f5d11c81898a309e26a2481acf33ddbec433fda", size = 121011, upload-time = "2025-08-12T15:12:16.352Z" },
+    { url = "https://files.pythonhosted.org/packages/57/ab/70e7a2c26a29878ad81ac551f3d11e184efafeed92c2ea15301ac71e2b44/orjson-3.11.2-cp39-cp39-musllinux_1_2_aarch64.whl", hash = "sha256:bc000190a7b1d2d8e36cba990b3209a1e15c0efb6c7750e87f8bead01afc0d46", size = 119387, upload-time = "2025-08-12T15:12:17.88Z" },
+    { url = "https://files.pythonhosted.org/packages/6f/f1/532be344579590c2faa3d9926ec446e8e030d6d04359a8d6f9b3f4d18283/orjson-3.11.2-cp39-cp39-musllinux_1_2_armv7l.whl", hash = "sha256:df3fdd8efa842ccbb81135d6f58a73512f11dba02ed08d9466261c2e9417af4e", size = 392280, upload-time = "2025-08-12T15:12:20.3Z" },
+    { url = "https://files.pythonhosted.org/packages/eb/90/dfb90d82ee7447ba0c5315b1012f36336d34a4b468f5896092926eb2921b/orjson-3.11.2-cp39-cp39-musllinux_1_2_i686.whl", hash = "sha256:3dacfc621be3079ec69e0d4cb32e3764067726e0ef5a5576428f68b6dc85b4f6", size = 134127, upload-time = "2025-08-12T15:12:22.053Z" },
+    { url = "https://files.pythonhosted.org/packages/17/cb/d113d03dfaee4933b0f6e0f3d358886db1468302bb74f1f3c59d9229ce12/orjson-3.11.2-cp39-cp39-musllinux_1_2_x86_64.whl", hash = "sha256:9fdff73a029cde5f4a1cf5ec9dbc6acab98c9ddd69f5580c2b3f02ce43ba9f9f", size = 123722, upload-time = "2025-08-12T15:12:23.642Z" },
+    { url = "https://files.pythonhosted.org/packages/55/78/a89748f500d7cf909fe0b30093ab87d256c279106048e985269a5530c0a1/orjson-3.11.2-cp39-cp39-win32.whl", hash = "sha256:b1efbdc479c6451138c3733e415b4d0e16526644e54e2f3689f699c4cda303bf", size = 124391, upload-time = "2025-08-12T15:12:25.143Z" },
+    { url = "https://files.pythonhosted.org/packages/e8/50/e436f1356650cf96ff62c386dbfeb9ef8dd9cd30c4296103244e7fae2d15/orjson-3.11.2-cp39-cp39-win_amd64.whl", hash = "sha256:c9ec0cc0d4308cad1e38a1ee23b64567e2ff364c2a3fe3d6cbc69cf911c45712", size = 119547, upload-time = "2025-08-12T15:12:26.77Z" },
 ]
 
 [[package]]
@@ -769,7 +769,7 @@ wheels = [
 
 [[package]]
 name = "pandas"
-version = "2.3.1"
+version = "2.3.2"
 source = { registry = "https://pypi.org/simple" }
 resolution-markers = [
     "python_full_version >= '3.12'",
@@ -785,49 +785,49 @@ dependencies = [
     { name = "pytz", marker = "python_full_version >= '3.9'" },
     { name = "tzdata", marker = "python_full_version >= '3.9'" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/d1/6f/75aa71f8a14267117adeeed5d21b204770189c0a0025acbdc03c337b28fc/pandas-2.3.1.tar.gz", hash = "sha256:0a95b9ac964fe83ce317827f80304d37388ea77616b1425f0ae41c9d2d0d7bb2", size = 4487493, upload-time = "2025-07-07T19:20:04.079Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/79/8e/0e90233ac205ad182bd6b422532695d2b9414944a280488105d598c70023/pandas-2.3.2.tar.gz", hash = "sha256:ab7b58f8f82706890924ccdfb5f48002b83d2b5a3845976a9fb705d36c34dcdb", size = 4488684, upload-time = "2025-08-21T10:28:29.257Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/c4/ca/aa97b47287221fa37a49634532e520300088e290b20d690b21ce3e448143/pandas-2.3.1-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:22c2e866f7209ebc3a8f08d75766566aae02bcc91d196935a1d9e59c7b990ac9", size = 11542731, upload-time = "2025-07-07T19:18:12.619Z" },
-    { url = "https://files.pythonhosted.org/packages/80/bf/7938dddc5f01e18e573dcfb0f1b8c9357d9b5fa6ffdee6e605b92efbdff2/pandas-2.3.1-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:3583d348546201aff730c8c47e49bc159833f971c2899d6097bce68b9112a4f1", size = 10790031, upload-time = "2025-07-07T19:18:16.611Z" },
-    { url = "https://files.pythonhosted.org/packages/ee/2f/9af748366763b2a494fed477f88051dbf06f56053d5c00eba652697e3f94/pandas-2.3.1-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:0f951fbb702dacd390561e0ea45cdd8ecfa7fb56935eb3dd78e306c19104b9b0", size = 11724083, upload-time = "2025-07-07T19:18:20.512Z" },
-    { url = "https://files.pythonhosted.org/packages/2c/95/79ab37aa4c25d1e7df953dde407bb9c3e4ae47d154bc0dd1692f3a6dcf8c/pandas-2.3.1-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:cd05b72ec02ebfb993569b4931b2e16fbb4d6ad6ce80224a3ee838387d83a191", size = 12342360, upload-time = "2025-07-07T19:18:23.194Z" },
-    { url = "https://files.pythonhosted.org/packages/75/a7/d65e5d8665c12c3c6ff5edd9709d5836ec9b6f80071b7f4a718c6106e86e/pandas-2.3.1-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:1b916a627919a247d865aed068eb65eb91a344b13f5b57ab9f610b7716c92de1", size = 13202098, upload-time = "2025-07-07T19:18:25.558Z" },
-    { url = "https://files.pythonhosted.org/packages/65/f3/4c1dbd754dbaa79dbf8b537800cb2fa1a6e534764fef50ab1f7533226c5c/pandas-2.3.1-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:fe67dc676818c186d5a3d5425250e40f179c2a89145df477dd82945eaea89e97", size = 13837228, upload-time = "2025-07-07T19:18:28.344Z" },
-    { url = "https://files.pythonhosted.org/packages/3f/d6/d7f5777162aa9b48ec3910bca5a58c9b5927cfd9cfde3aa64322f5ba4b9f/pandas-2.3.1-cp310-cp310-win_amd64.whl", hash = "sha256:2eb789ae0274672acbd3c575b0598d213345660120a257b47b5dafdc618aec83", size = 11336561, upload-time = "2025-07-07T19:18:31.211Z" },
-    { url = "https://files.pythonhosted.org/packages/76/1c/ccf70029e927e473a4476c00e0d5b32e623bff27f0402d0a92b7fc29bb9f/pandas-2.3.1-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:2b0540963d83431f5ce8870ea02a7430adca100cec8a050f0811f8e31035541b", size = 11566608, upload-time = "2025-07-07T19:18:33.86Z" },
-    { url = "https://files.pythonhosted.org/packages/ec/d3/3c37cb724d76a841f14b8f5fe57e5e3645207cc67370e4f84717e8bb7657/pandas-2.3.1-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:fe7317f578c6a153912bd2292f02e40c1d8f253e93c599e82620c7f69755c74f", size = 10823181, upload-time = "2025-07-07T19:18:36.151Z" },
-    { url = "https://files.pythonhosted.org/packages/8a/4c/367c98854a1251940edf54a4df0826dcacfb987f9068abf3e3064081a382/pandas-2.3.1-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:e6723a27ad7b244c0c79d8e7007092d7c8f0f11305770e2f4cd778b3ad5f9f85", size = 11793570, upload-time = "2025-07-07T19:18:38.385Z" },
-    { url = "https://files.pythonhosted.org/packages/07/5f/63760ff107bcf5146eee41b38b3985f9055e710a72fdd637b791dea3495c/pandas-2.3.1-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:3462c3735fe19f2638f2c3a40bd94ec2dc5ba13abbb032dd2fa1f540a075509d", size = 12378887, upload-time = "2025-07-07T19:18:41.284Z" },
-    { url = "https://files.pythonhosted.org/packages/15/53/f31a9b4dfe73fe4711c3a609bd8e60238022f48eacedc257cd13ae9327a7/pandas-2.3.1-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:98bcc8b5bf7afed22cc753a28bc4d9e26e078e777066bc53fac7904ddef9a678", size = 13230957, upload-time = "2025-07-07T19:18:44.187Z" },
-    { url = "https://files.pythonhosted.org/packages/e0/94/6fce6bf85b5056d065e0a7933cba2616dcb48596f7ba3c6341ec4bcc529d/pandas-2.3.1-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:4d544806b485ddf29e52d75b1f559142514e60ef58a832f74fb38e48d757b299", size = 13883883, upload-time = "2025-07-07T19:18:46.498Z" },
-    { url = "https://files.pythonhosted.org/packages/c8/7b/bdcb1ed8fccb63d04bdb7635161d0ec26596d92c9d7a6cce964e7876b6c1/pandas-2.3.1-cp311-cp311-win_amd64.whl", hash = "sha256:b3cd4273d3cb3707b6fffd217204c52ed92859533e31dc03b7c5008aa933aaab", size = 11340212, upload-time = "2025-07-07T19:18:49.293Z" },
-    { url = "https://files.pythonhosted.org/packages/46/de/b8445e0f5d217a99fe0eeb2f4988070908979bec3587c0633e5428ab596c/pandas-2.3.1-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:689968e841136f9e542020698ee1c4fbe9caa2ed2213ae2388dc7b81721510d3", size = 11588172, upload-time = "2025-07-07T19:18:52.054Z" },
-    { url = "https://files.pythonhosted.org/packages/1e/e0/801cdb3564e65a5ac041ab99ea6f1d802a6c325bb6e58c79c06a3f1cd010/pandas-2.3.1-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:025e92411c16cbe5bb2a4abc99732a6b132f439b8aab23a59fa593eb00704232", size = 10717365, upload-time = "2025-07-07T19:18:54.785Z" },
-    { url = "https://files.pythonhosted.org/packages/51/a5/c76a8311833c24ae61a376dbf360eb1b1c9247a5d9c1e8b356563b31b80c/pandas-2.3.1-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:9b7ff55f31c4fcb3e316e8f7fa194566b286d6ac430afec0d461163312c5841e", size = 11280411, upload-time = "2025-07-07T19:18:57.045Z" },
-    { url = "https://files.pythonhosted.org/packages/da/01/e383018feba0a1ead6cf5fe8728e5d767fee02f06a3d800e82c489e5daaf/pandas-2.3.1-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:7dcb79bf373a47d2a40cf7232928eb7540155abbc460925c2c96d2d30b006eb4", size = 11988013, upload-time = "2025-07-07T19:18:59.771Z" },
-    { url = "https://files.pythonhosted.org/packages/5b/14/cec7760d7c9507f11c97d64f29022e12a6cc4fc03ac694535e89f88ad2ec/pandas-2.3.1-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:56a342b231e8862c96bdb6ab97170e203ce511f4d0429589c8ede1ee8ece48b8", size = 12767210, upload-time = "2025-07-07T19:19:02.944Z" },
-    { url = "https://files.pythonhosted.org/packages/50/b9/6e2d2c6728ed29fb3d4d4d302504fb66f1a543e37eb2e43f352a86365cdf/pandas-2.3.1-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:ca7ed14832bce68baef331f4d7f294411bed8efd032f8109d690df45e00c4679", size = 13440571, upload-time = "2025-07-07T19:19:06.82Z" },
-    { url = "https://files.pythonhosted.org/packages/80/a5/3a92893e7399a691bad7664d977cb5e7c81cf666c81f89ea76ba2bff483d/pandas-2.3.1-cp312-cp312-win_amd64.whl", hash = "sha256:ac942bfd0aca577bef61f2bc8da8147c4ef6879965ef883d8e8d5d2dc3e744b8", size = 10987601, upload-time = "2025-07-07T19:19:09.589Z" },
-    { url = "https://files.pythonhosted.org/packages/32/ed/ff0a67a2c5505e1854e6715586ac6693dd860fbf52ef9f81edee200266e7/pandas-2.3.1-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:9026bd4a80108fac2239294a15ef9003c4ee191a0f64b90f170b40cfb7cf2d22", size = 11531393, upload-time = "2025-07-07T19:19:12.245Z" },
-    { url = "https://files.pythonhosted.org/packages/c7/db/d8f24a7cc9fb0972adab0cc80b6817e8bef888cfd0024eeb5a21c0bb5c4a/pandas-2.3.1-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:6de8547d4fdb12421e2d047a2c446c623ff4c11f47fddb6b9169eb98ffba485a", size = 10668750, upload-time = "2025-07-07T19:19:14.612Z" },
-    { url = "https://files.pythonhosted.org/packages/0f/b0/80f6ec783313f1e2356b28b4fd8d2148c378370045da918c73145e6aab50/pandas-2.3.1-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:782647ddc63c83133b2506912cc6b108140a38a37292102aaa19c81c83db2928", size = 11342004, upload-time = "2025-07-07T19:19:16.857Z" },
-    { url = "https://files.pythonhosted.org/packages/e9/e2/20a317688435470872885e7fc8f95109ae9683dec7c50be29b56911515a5/pandas-2.3.1-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:2ba6aff74075311fc88504b1db890187a3cd0f887a5b10f5525f8e2ef55bfdb9", size = 12050869, upload-time = "2025-07-07T19:19:19.265Z" },
-    { url = "https://files.pythonhosted.org/packages/55/79/20d746b0a96c67203a5bee5fb4e00ac49c3e8009a39e1f78de264ecc5729/pandas-2.3.1-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:e5635178b387bd2ba4ac040f82bc2ef6e6b500483975c4ebacd34bec945fda12", size = 12750218, upload-time = "2025-07-07T19:19:21.547Z" },
-    { url = "https://files.pythonhosted.org/packages/7c/0f/145c8b41e48dbf03dd18fdd7f24f8ba95b8254a97a3379048378f33e7838/pandas-2.3.1-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:6f3bf5ec947526106399a9e1d26d40ee2b259c66422efdf4de63c848492d91bb", size = 13416763, upload-time = "2025-07-07T19:19:23.939Z" },
-    { url = "https://files.pythonhosted.org/packages/b2/c0/54415af59db5cdd86a3d3bf79863e8cc3fa9ed265f0745254061ac09d5f2/pandas-2.3.1-cp313-cp313-win_amd64.whl", hash = "sha256:1c78cf43c8fde236342a1cb2c34bcff89564a7bfed7e474ed2fffa6aed03a956", size = 10987482, upload-time = "2025-07-07T19:19:42.699Z" },
-    { url = "https://files.pythonhosted.org/packages/48/64/2fd2e400073a1230e13b8cd604c9bc95d9e3b962e5d44088ead2e8f0cfec/pandas-2.3.1-cp313-cp313t-macosx_10_13_x86_64.whl", hash = "sha256:8dfc17328e8da77be3cf9f47509e5637ba8f137148ed0e9b5241e1baf526e20a", size = 12029159, upload-time = "2025-07-07T19:19:26.362Z" },
-    { url = "https://files.pythonhosted.org/packages/d8/0a/d84fd79b0293b7ef88c760d7dca69828d867c89b6d9bc52d6a27e4d87316/pandas-2.3.1-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:ec6c851509364c59a5344458ab935e6451b31b818be467eb24b0fe89bd05b6b9", size = 11393287, upload-time = "2025-07-07T19:19:29.157Z" },
-    { url = "https://files.pythonhosted.org/packages/50/ae/ff885d2b6e88f3c7520bb74ba319268b42f05d7e583b5dded9837da2723f/pandas-2.3.1-cp313-cp313t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:911580460fc4884d9b05254b38a6bfadddfcc6aaef856fb5859e7ca202e45275", size = 11309381, upload-time = "2025-07-07T19:19:31.436Z" },
-    { url = "https://files.pythonhosted.org/packages/85/86/1fa345fc17caf5d7780d2699985c03dbe186c68fee00b526813939062bb0/pandas-2.3.1-cp313-cp313t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:2f4d6feeba91744872a600e6edbbd5b033005b431d5ae8379abee5bcfa479fab", size = 11883998, upload-time = "2025-07-07T19:19:34.267Z" },
-    { url = "https://files.pythonhosted.org/packages/81/aa/e58541a49b5e6310d89474333e994ee57fea97c8aaa8fc7f00b873059bbf/pandas-2.3.1-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:fe37e757f462d31a9cd7580236a82f353f5713a80e059a29753cf938c6775d96", size = 12704705, upload-time = "2025-07-07T19:19:36.856Z" },
-    { url = "https://files.pythonhosted.org/packages/d5/f9/07086f5b0f2a19872554abeea7658200824f5835c58a106fa8f2ae96a46c/pandas-2.3.1-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:5db9637dbc24b631ff3707269ae4559bce4b7fd75c1c4d7e13f40edc42df4444", size = 13189044, upload-time = "2025-07-07T19:19:39.999Z" },
-    { url = "https://files.pythonhosted.org/packages/6e/21/ecf2df680982616459409b09962a8c2065330c7151dc6538069f3b634acf/pandas-2.3.1-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:4645f770f98d656f11c69e81aeb21c6fca076a44bed3dcbb9396a4311bc7f6d8", size = 11567275, upload-time = "2025-07-07T19:19:45.152Z" },
-    { url = "https://files.pythonhosted.org/packages/1e/1a/dcb50e44b75419e96b276c9fb023b0f147b3c411be1cd517492aa2a184d4/pandas-2.3.1-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:342e59589cc454aaff7484d75b816a433350b3d7964d7847327edda4d532a2e3", size = 10811488, upload-time = "2025-07-07T19:19:47.797Z" },
-    { url = "https://files.pythonhosted.org/packages/2d/55/66cd2b679f6a27398380eac7574bc24746128f74626a3c02b978ea00e5ce/pandas-2.3.1-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:1d12f618d80379fde6af007f65f0c25bd3e40251dbd1636480dfffce2cf1e6da", size = 11763000, upload-time = "2025-07-07T19:19:50.83Z" },
-    { url = "https://files.pythonhosted.org/packages/ae/1c/5b9b263c80fd5e231b77df6f78cd7426d1d4ad3a4e858e85b7b3d93d0e9c/pandas-2.3.1-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:dd71c47a911da120d72ef173aeac0bf5241423f9bfea57320110a978457e069e", size = 12361395, upload-time = "2025-07-07T19:19:53.714Z" },
-    { url = "https://files.pythonhosted.org/packages/f7/74/7e817b31413fbb96366ea327d43d1926a9c48c58074e27e094e2839a0e36/pandas-2.3.1-cp39-cp39-musllinux_1_2_aarch64.whl", hash = "sha256:09e3b1587f0f3b0913e21e8b32c3119174551deb4a4eba4a89bc7377947977e7", size = 13225086, upload-time = "2025-07-07T19:19:56.378Z" },
-    { url = "https://files.pythonhosted.org/packages/1f/0f/bc0a44b47eba2f22ae4235719a573d552ef7ad76ed3ea39ae62d554e040b/pandas-2.3.1-cp39-cp39-musllinux_1_2_x86_64.whl", hash = "sha256:2323294c73ed50f612f67e2bf3ae45aea04dce5690778e08a09391897f35ff88", size = 13871698, upload-time = "2025-07-07T19:19:58.854Z" },
-    { url = "https://files.pythonhosted.org/packages/fa/cb/6c32f8fadefa4314b740fbe8f74f6a02423bd1549e7c930826df35ac3c1b/pandas-2.3.1-cp39-cp39-win_amd64.whl", hash = "sha256:b4b0de34dc8499c2db34000ef8baad684cfa4cbd836ecee05f323ebfba348c7d", size = 11357186, upload-time = "2025-07-07T19:20:01.475Z" },
+    { url = "https://files.pythonhosted.org/packages/2e/16/a8eeb70aad84ccbf14076793f90e0031eded63c1899aeae9fdfbf37881f4/pandas-2.3.2-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:52bc29a946304c360561974c6542d1dd628ddafa69134a7131fdfd6a5d7a1a35", size = 11539648, upload-time = "2025-08-21T10:26:36.236Z" },
+    { url = "https://files.pythonhosted.org/packages/47/f1/c5bdaea13bf3708554d93e948b7ea74121ce6e0d59537ca4c4f77731072b/pandas-2.3.2-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:220cc5c35ffaa764dd5bb17cf42df283b5cb7fdf49e10a7b053a06c9cb48ee2b", size = 10786923, upload-time = "2025-08-21T10:26:40.518Z" },
+    { url = "https://files.pythonhosted.org/packages/bb/10/811fa01476d29ffed692e735825516ad0e56d925961819e6126b4ba32147/pandas-2.3.2-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:42c05e15111221384019897df20c6fe893b2f697d03c811ee67ec9e0bb5a3424", size = 11726241, upload-time = "2025-08-21T10:26:43.175Z" },
+    { url = "https://files.pythonhosted.org/packages/c4/6a/40b043b06e08df1ea1b6d20f0e0c2f2c4ec8c4f07d1c92948273d943a50b/pandas-2.3.2-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:cc03acc273c5515ab69f898df99d9d4f12c4d70dbfc24c3acc6203751d0804cf", size = 12349533, upload-time = "2025-08-21T10:26:46.611Z" },
+    { url = "https://files.pythonhosted.org/packages/e2/ea/2e081a2302e41a9bca7056659fdd2b85ef94923723e41665b42d65afd347/pandas-2.3.2-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:d25c20a03e8870f6339bcf67281b946bd20b86f1a544ebbebb87e66a8d642cba", size = 13202407, upload-time = "2025-08-21T10:26:49.068Z" },
+    { url = "https://files.pythonhosted.org/packages/f4/12/7ff9f6a79e2ee8869dcf70741ef998b97ea20050fe25f83dc759764c1e32/pandas-2.3.2-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:21bb612d148bb5860b7eb2c10faacf1a810799245afd342cf297d7551513fbb6", size = 13837212, upload-time = "2025-08-21T10:26:51.832Z" },
+    { url = "https://files.pythonhosted.org/packages/d8/df/5ab92fcd76455a632b3db34a746e1074d432c0cdbbd28d7cd1daba46a75d/pandas-2.3.2-cp310-cp310-win_amd64.whl", hash = "sha256:b62d586eb25cb8cb70a5746a378fc3194cb7f11ea77170d59f889f5dfe3cec7a", size = 11338099, upload-time = "2025-08-21T10:26:54.382Z" },
+    { url = "https://files.pythonhosted.org/packages/7a/59/f3e010879f118c2d400902d2d871c2226cef29b08c09fb8dc41111730400/pandas-2.3.2-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:1333e9c299adcbb68ee89a9bb568fc3f20f9cbb419f1dd5225071e6cddb2a743", size = 11563308, upload-time = "2025-08-21T10:26:56.656Z" },
+    { url = "https://files.pythonhosted.org/packages/38/18/48f10f1cc5c397af59571d638d211f494dba481f449c19adbd282aa8f4ca/pandas-2.3.2-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:76972bcbd7de8e91ad5f0ca884a9f2c477a2125354af624e022c49e5bd0dfff4", size = 10820319, upload-time = "2025-08-21T10:26:59.162Z" },
+    { url = "https://files.pythonhosted.org/packages/95/3b/1e9b69632898b048e223834cd9702052bcf06b15e1ae716eda3196fb972e/pandas-2.3.2-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:b98bdd7c456a05eef7cd21fd6b29e3ca243591fe531c62be94a2cc987efb5ac2", size = 11790097, upload-time = "2025-08-21T10:27:02.204Z" },
+    { url = "https://files.pythonhosted.org/packages/8b/ef/0e2ffb30b1f7fbc9a588bd01e3c14a0d96854d09a887e15e30cc19961227/pandas-2.3.2-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:1d81573b3f7db40d020983f78721e9bfc425f411e616ef019a10ebf597aedb2e", size = 12397958, upload-time = "2025-08-21T10:27:05.409Z" },
+    { url = "https://files.pythonhosted.org/packages/23/82/e6b85f0d92e9afb0e7f705a51d1399b79c7380c19687bfbf3d2837743249/pandas-2.3.2-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:e190b738675a73b581736cc8ec71ae113d6c3768d0bd18bffa5b9a0927b0b6ea", size = 13225600, upload-time = "2025-08-21T10:27:07.791Z" },
+    { url = "https://files.pythonhosted.org/packages/e8/f1/f682015893d9ed51611948bd83683670842286a8edd4f68c2c1c3b231eef/pandas-2.3.2-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:c253828cb08f47488d60f43c5fc95114c771bbfff085da54bfc79cb4f9e3a372", size = 13879433, upload-time = "2025-08-21T10:27:10.347Z" },
+    { url = "https://files.pythonhosted.org/packages/a7/e7/ae86261695b6c8a36d6a4c8d5f9b9ede8248510d689a2f379a18354b37d7/pandas-2.3.2-cp311-cp311-win_amd64.whl", hash = "sha256:9467697b8083f9667b212633ad6aa4ab32436dcbaf4cd57325debb0ddef2012f", size = 11336557, upload-time = "2025-08-21T10:27:12.983Z" },
+    { url = "https://files.pythonhosted.org/packages/ec/db/614c20fb7a85a14828edd23f1c02db58a30abf3ce76f38806155d160313c/pandas-2.3.2-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:3fbb977f802156e7a3f829e9d1d5398f6192375a3e2d1a9ee0803e35fe70a2b9", size = 11587652, upload-time = "2025-08-21T10:27:15.888Z" },
+    { url = "https://files.pythonhosted.org/packages/99/b0/756e52f6582cade5e746f19bad0517ff27ba9c73404607c0306585c201b3/pandas-2.3.2-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:1b9b52693123dd234b7c985c68b709b0b009f4521000d0525f2b95c22f15944b", size = 10717686, upload-time = "2025-08-21T10:27:18.486Z" },
+    { url = "https://files.pythonhosted.org/packages/37/4c/dd5ccc1e357abfeee8353123282de17997f90ff67855f86154e5a13b81e5/pandas-2.3.2-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:0bd281310d4f412733f319a5bc552f86d62cddc5f51d2e392c8787335c994175", size = 11278722, upload-time = "2025-08-21T10:27:21.149Z" },
+    { url = "https://files.pythonhosted.org/packages/d3/a4/f7edcfa47e0a88cda0be8b068a5bae710bf264f867edfdf7b71584ace362/pandas-2.3.2-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:96d31a6b4354e3b9b8a2c848af75d31da390657e3ac6f30c05c82068b9ed79b9", size = 11987803, upload-time = "2025-08-21T10:27:23.767Z" },
+    { url = "https://files.pythonhosted.org/packages/f6/61/1bce4129f93ab66f1c68b7ed1c12bac6a70b1b56c5dab359c6bbcd480b52/pandas-2.3.2-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:df4df0b9d02bb873a106971bb85d448378ef14b86ba96f035f50bbd3688456b4", size = 12766345, upload-time = "2025-08-21T10:27:26.6Z" },
+    { url = "https://files.pythonhosted.org/packages/8e/46/80d53de70fee835531da3a1dae827a1e76e77a43ad22a8cd0f8142b61587/pandas-2.3.2-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:213a5adf93d020b74327cb2c1b842884dbdd37f895f42dcc2f09d451d949f811", size = 13439314, upload-time = "2025-08-21T10:27:29.213Z" },
+    { url = "https://files.pythonhosted.org/packages/28/30/8114832daff7489f179971dbc1d854109b7f4365a546e3ea75b6516cea95/pandas-2.3.2-cp312-cp312-win_amd64.whl", hash = "sha256:8c13b81a9347eb8c7548f53fd9a4f08d4dfe996836543f805c987bafa03317ae", size = 10983326, upload-time = "2025-08-21T10:27:31.901Z" },
+    { url = "https://files.pythonhosted.org/packages/27/64/a2f7bf678af502e16b472527735d168b22b7824e45a4d7e96a4fbb634b59/pandas-2.3.2-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:0c6ecbac99a354a051ef21c5307601093cb9e0f4b1855984a084bfec9302699e", size = 11531061, upload-time = "2025-08-21T10:27:34.647Z" },
+    { url = "https://files.pythonhosted.org/packages/54/4c/c3d21b2b7769ef2f4c2b9299fcadd601efa6729f1357a8dbce8dd949ed70/pandas-2.3.2-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:c6f048aa0fd080d6a06cc7e7537c09b53be6642d330ac6f54a600c3ace857ee9", size = 10668666, upload-time = "2025-08-21T10:27:37.203Z" },
+    { url = "https://files.pythonhosted.org/packages/50/e2/f775ba76ecfb3424d7f5862620841cf0edb592e9abd2d2a5387d305fe7a8/pandas-2.3.2-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:0064187b80a5be6f2f9c9d6bdde29372468751dfa89f4211a3c5871854cfbf7a", size = 11332835, upload-time = "2025-08-21T10:27:40.188Z" },
+    { url = "https://files.pythonhosted.org/packages/8f/52/0634adaace9be2d8cac9ef78f05c47f3a675882e068438b9d7ec7ef0c13f/pandas-2.3.2-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:4ac8c320bded4718b298281339c1a50fb00a6ba78cb2a63521c39bec95b0209b", size = 12057211, upload-time = "2025-08-21T10:27:43.117Z" },
+    { url = "https://files.pythonhosted.org/packages/0b/9d/2df913f14b2deb9c748975fdb2491da1a78773debb25abbc7cbc67c6b549/pandas-2.3.2-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:114c2fe4f4328cf98ce5716d1532f3ab79c5919f95a9cfee81d9140064a2e4d6", size = 12749277, upload-time = "2025-08-21T10:27:45.474Z" },
+    { url = "https://files.pythonhosted.org/packages/87/af/da1a2417026bd14d98c236dba88e39837182459d29dcfcea510b2ac9e8a1/pandas-2.3.2-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:48fa91c4dfb3b2b9bfdb5c24cd3567575f4e13f9636810462ffed8925352be5a", size = 13415256, upload-time = "2025-08-21T10:27:49.885Z" },
+    { url = "https://files.pythonhosted.org/packages/22/3c/f2af1ce8840ef648584a6156489636b5692c162771918aa95707c165ad2b/pandas-2.3.2-cp313-cp313-win_amd64.whl", hash = "sha256:12d039facec710f7ba305786837d0225a3444af7bbd9c15c32ca2d40d157ed8b", size = 10982579, upload-time = "2025-08-21T10:28:08.435Z" },
+    { url = "https://files.pythonhosted.org/packages/f3/98/8df69c4097a6719e357dc249bf437b8efbde808038268e584421696cbddf/pandas-2.3.2-cp313-cp313t-macosx_10_13_x86_64.whl", hash = "sha256:c624b615ce97864eb588779ed4046186f967374185c047070545253a52ab2d57", size = 12028163, upload-time = "2025-08-21T10:27:52.232Z" },
+    { url = "https://files.pythonhosted.org/packages/0e/23/f95cbcbea319f349e10ff90db488b905c6883f03cbabd34f6b03cbc3c044/pandas-2.3.2-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:0cee69d583b9b128823d9514171cabb6861e09409af805b54459bd0c821a35c2", size = 11391860, upload-time = "2025-08-21T10:27:54.673Z" },
+    { url = "https://files.pythonhosted.org/packages/ad/1b/6a984e98c4abee22058aa75bfb8eb90dce58cf8d7296f8bc56c14bc330b0/pandas-2.3.2-cp313-cp313t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:2319656ed81124982900b4c37f0e0c58c015af9a7bbc62342ba5ad07ace82ba9", size = 11309830, upload-time = "2025-08-21T10:27:56.957Z" },
+    { url = "https://files.pythonhosted.org/packages/15/d5/f0486090eb18dd8710bf60afeaf638ba6817047c0c8ae5c6a25598665609/pandas-2.3.2-cp313-cp313t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:b37205ad6f00d52f16b6d09f406434ba928c1a1966e2771006a9033c736d30d2", size = 11883216, upload-time = "2025-08-21T10:27:59.302Z" },
+    { url = "https://files.pythonhosted.org/packages/10/86/692050c119696da19e20245bbd650d8dfca6ceb577da027c3a73c62a047e/pandas-2.3.2-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:837248b4fc3a9b83b9c6214699a13f069dc13510a6a6d7f9ba33145d2841a012", size = 12699743, upload-time = "2025-08-21T10:28:02.447Z" },
+    { url = "https://files.pythonhosted.org/packages/cd/d7/612123674d7b17cf345aad0a10289b2a384bff404e0463a83c4a3a59d205/pandas-2.3.2-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:d2c3554bd31b731cd6490d94a28f3abb8dd770634a9e06eb6d2911b9827db370", size = 13186141, upload-time = "2025-08-21T10:28:05.377Z" },
+    { url = "https://files.pythonhosted.org/packages/e0/c3/b37e090d0aceda9b4dd85c8dbd1bea65b1de9e7a4f690d6bd3a40bd16390/pandas-2.3.2-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:88080a0ff8a55eac9c84e3ff3c7665b3b5476c6fbc484775ca1910ce1c3e0b87", size = 11551511, upload-time = "2025-08-21T10:28:11.111Z" },
+    { url = "https://files.pythonhosted.org/packages/b9/47/381fb1e7adcfcf4230fa6dc3a741acbac6c6fe072f19f4e7a46bddf3e5f6/pandas-2.3.2-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:d4a558c7620340a0931828d8065688b3cc5b4c8eb674bcaf33d18ff4a6870b4a", size = 10797930, upload-time = "2025-08-21T10:28:13.436Z" },
+    { url = "https://files.pythonhosted.org/packages/36/ca/d42467829080b92fc46d451288af8068f129fbcfb6578d573f45120de5cf/pandas-2.3.2-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:45178cf09d1858a1509dc73ec261bf5b25a625a389b65be2e47b559905f0ab6a", size = 11738470, upload-time = "2025-08-21T10:28:16.065Z" },
+    { url = "https://files.pythonhosted.org/packages/60/76/7d0f0a0deed7867c51163982d7b79c0a089096cd7ad50e1b87c2c82220e9/pandas-2.3.2-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:77cefe00e1b210f9c76c697fedd8fdb8d3dd86563e9c8adc9fa72b90f5e9e4c2", size = 12366640, upload-time = "2025-08-21T10:28:18.557Z" },
+    { url = "https://files.pythonhosted.org/packages/21/31/56784743e421cf51e34358fe7e5954345e5942168897bf8eb5707b71eedb/pandas-2.3.2-cp39-cp39-musllinux_1_2_aarch64.whl", hash = "sha256:13bd629c653856f00c53dc495191baa59bcafbbf54860a46ecc50d3a88421a96", size = 13211567, upload-time = "2025-08-21T10:28:20.998Z" },
+    { url = "https://files.pythonhosted.org/packages/7a/4e/50a399dc7d9dd4aa09a03b163751d428026cf0f16c419b4010f6aca26ebd/pandas-2.3.2-cp39-cp39-musllinux_1_2_x86_64.whl", hash = "sha256:36d627906fd44b5fd63c943264e11e96e923f8de77d6016dc2f667b9ad193438", size = 13854073, upload-time = "2025-08-21T10:28:24.056Z" },
+    { url = "https://files.pythonhosted.org/packages/29/72/8978a84861a5124e56ce1048376569545412501fcb9a83f035393d6d85bc/pandas-2.3.2-cp39-cp39-win_amd64.whl", hash = "sha256:a9d7ec92d71a420185dec44909c32e9a362248c4ae2238234b76d5be37f208cc", size = 11346452, upload-time = "2025-08-21T10:28:26.691Z" },
 ]
 
 [[package]]
@@ -850,16 +850,16 @@ wheels = [
 
 [[package]]
 name = "plotly"
-version = "6.2.0"
+version = "6.3.0"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "narwhals", version = "1.42.1", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.9'" },
-    { name = "narwhals", version = "2.0.1", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.9'" },
+    { name = "narwhals", version = "2.1.2", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.9'" },
     { name = "packaging" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/6e/5c/0efc297df362b88b74957a230af61cd6929f531f72f48063e8408702ffba/plotly-6.2.0.tar.gz", hash = "sha256:9dfa23c328000f16c928beb68927444c1ab9eae837d1fe648dbcda5360c7953d", size = 6801941, upload-time = "2025-06-26T16:20:45.765Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/a0/64/850de5076f4436410e1ce4f6a69f4313ef6215dfea155f3f6559335cad29/plotly-6.3.0.tar.gz", hash = "sha256:8840a184d18ccae0f9189c2b9a2943923fd5cae7717b723f36eef78f444e5a73", size = 6923926, upload-time = "2025-08-12T20:22:14.127Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/ed/20/f2b7ac96a91cc5f70d81320adad24cc41bf52013508d649b1481db225780/plotly-6.2.0-py3-none-any.whl", hash = "sha256:32c444d4c940887219cb80738317040363deefdfee4f354498cc0b6dab8978bd", size = 9635469, upload-time = "2025-06-26T16:20:40.76Z" },
+    { url = "https://files.pythonhosted.org/packages/95/a9/12e2dc726ba1ba775a2c6922d5d5b4488ad60bdab0888c337c194c8e6de8/plotly-6.3.0-py3-none-any.whl", hash = "sha256:7ad806edce9d3cdd882eaebaf97c0c9e252043ed1ed3d382c3e3520ec07806d4", size = 9791257, upload-time = "2025-08-12T20:22:09.205Z" },
 ]
 
 [package.optional-dependencies]
@@ -916,7 +916,7 @@ wheels = [
 
 [[package]]
 name = "poethepoet"
-version = "0.36.0"
+version = "0.37.0"
 source = { registry = "https://pypi.org/simple" }
 resolution-markers = [
     "python_full_version >= '3.12'",
@@ -929,9 +929,9 @@ dependencies = [
     { name = "pyyaml", marker = "python_full_version >= '3.9'" },
     { name = "tomli", marker = "python_full_version >= '3.9' and python_full_version < '3.11'" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/cf/ac/311c8a492dc887f0b7a54d0ec3324cb2f9538b7b78ea06e5f7ae1f167e52/poethepoet-0.36.0.tar.gz", hash = "sha256:2217b49cb4e4c64af0b42ff8c4814b17f02e107d38bc461542517348ede25663", size = 66854, upload-time = "2025-06-29T19:54:50.444Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/a5/f2/273fe54a78dc5c6c8dd63db71f5a6ceb95e4648516b5aeaeff4bde804e44/poethepoet-0.37.0.tar.gz", hash = "sha256:73edf458707c674a079baa46802e21455bda3a7f82a408e58c31b9f4fe8e933d", size = 68570, upload-time = "2025-08-11T18:00:29.103Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/03/29/dedb3a6b7e17ea723143b834a2da428a7d743c80d5cd4d22ed28b5e8c441/poethepoet-0.36.0-py3-none-any.whl", hash = "sha256:693e3c1eae9f6731d3613c3c0c40f747d3c5c68a375beda42e590a63c5623308", size = 88031, upload-time = "2025-06-29T19:54:48.884Z" },
+    { url = "https://files.pythonhosted.org/packages/92/1b/5337af1a6a478d25a3e3c56b9b4b42b0a160314e02f4a0498d5322c8dac4/poethepoet-0.37.0-py3-none-any.whl", hash = "sha256:861790276315abcc8df1b4bd60e28c3d48a06db273edd3092f3c94e1a46e5e22", size = 90062, upload-time = "2025-08-11T18:00:27.595Z" },
 ]
 
 [[package]]

From d36dbab39fef2a83edf4a57f47ec3e2f993cdc11 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Fri, 22 Aug 2025 15:41:15 -0500
Subject: [PATCH 008/167] Add types to __init__

---
 src/py/kaleido/__init__.py | 48 ++++++++++++++++++++++++--------------
 1 file changed, 30 insertions(+), 18 deletions(-)

diff --git a/src/py/kaleido/__init__.py b/src/py/kaleido/__init__.py
index d9961019..12047e04 100644
--- a/src/py/kaleido/__init__.py
+++ b/src/py/kaleido/__init__.py
@@ -6,12 +6,24 @@
 
 from __future__ import annotations
 
+from typing import TYPE_CHECKING
+
 from choreographer.cli import get_chrome, get_chrome_sync
 
 from . import _sync_server
 from ._page_generator import PageGenerator
 from .kaleido import Kaleido
 
+if TYPE_CHECKING:
+    from collections.abc import AsyncIterable, Iterable, TypeVar
+    from pathlib import Path
+    from typing import Any
+
+    from ._fig_tools import Figurish, LayoutOpts
+
+    T = TypeVar("T")
+    AnyIterable = AsyncIterable[T] | Iterable[T]
+
 __all__ = [
     "Kaleido",
     "PageGenerator",
@@ -30,7 +42,7 @@
 _global_server = _sync_server.GlobalKaleidoServer()
 
 
-def start_sync_server(*args, silence_warnings=False, **kwargs):
+def start_sync_server(*args: Any, silence_warnings: bool = False, **kwargs: Any):
     """
     Start a kaleido server which will process all sync generation requests.
 
@@ -50,7 +62,7 @@ def start_sync_server(*args, silence_warnings=False, **kwargs):
     _global_server.open(*args, silence_warnings=silence_warnings, **kwargs)
 
 
-def stop_sync_server(*, silence_warnings=False):
+def stop_sync_server(*, silence_warnings: bool = False):
     """
     Stop the kaleido server. It can be restarted. Warns if not started.
 
@@ -63,12 +75,12 @@ def stop_sync_server(*, silence_warnings=False):
 
 
 async def calc_fig(
-    fig,
-    path=None,
-    opts=None,
+    fig: Figurish,
+    path: str | None | Path = None,
+    opts: LayoutOpts | None = None,
     *,
-    topojson=None,
-    kopts=None,
+    topojson: str | None = None,
+    kopts: dict[str, Any] | None = None,
 ):
     """
     Return binary for plotly figure.
@@ -85,7 +97,7 @@ async def calc_fig(
 
     """
     kopts = kopts or {}
-    kopts["n"] = 1
+    kopts["n"] = 1  # should we force this?
     async with Kaleido(**kopts) as k:
         return await k.calc_fig(
             fig,
@@ -96,14 +108,14 @@ async def calc_fig(
 
 
 async def write_fig(  # noqa: PLR0913 (too many args, complexity)
-    fig,
-    path=None,
-    opts=None,
+    fig: Figurish,
+    path: str | None | Path = None,
+    opts: LayoutOpts | None = None,
     *,
-    topojson=None,
+    topojson: str | None = None,
+    kopts: dict[str, Any] | None = None,
     error_log=None,
     profiler=None,
-    kopts=None,
 ):
     """
     Write a plotly figure(s) to a file.
@@ -129,11 +141,11 @@ async def write_fig(  # noqa: PLR0913 (too many args, complexity)
 
 
 async def write_fig_from_object(
-    generator,
+    generator: AnyIterable,  # this could be more specific with []
     *,
+    kopts: dict[str, Any] | None = None,
     error_log=None,
     profiler=None,
-    kopts=None,
 ):
     """
     Write a plotly figure(s) to a file.
@@ -155,7 +167,7 @@ async def write_fig_from_object(
         )
 
 
-def calc_fig_sync(*args, **kwargs):
+def calc_fig_sync(*args: Any, **kwargs: Any):
     """Call `calc_fig` but blocking."""
     if _global_server.is_running():
         return _global_server.call_function("calc_fig", *args, **kwargs)
@@ -163,7 +175,7 @@ def calc_fig_sync(*args, **kwargs):
         return _sync_server.oneshot_async_run(calc_fig, args=args, kwargs=kwargs)
 
 
-def write_fig_sync(*args, **kwargs):
+def write_fig_sync(*args: Any, **kwargs: Any):
     """Call `write_fig` but blocking."""
     if _global_server.is_running():
         _global_server.call_function("write_fig", *args, **kwargs)
@@ -171,7 +183,7 @@ def write_fig_sync(*args, **kwargs):
         _sync_server.oneshot_async_run(write_fig, args=args, kwargs=kwargs)
 
 
-def write_fig_from_object_sync(*args, **kwargs):
+def write_fig_from_object_sync(*args: Any, **kwargs: Any):
     """Call `write_fig_from_object` but blocking."""
     if _global_server.is_running():
         _global_server.call_function("write_fig_from_object", *args, **kwargs)

From 9838ac4c889a08cb25109177c0af8d6c56cb39dc Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Fri, 22 Aug 2025 15:49:51 -0500
Subject: [PATCH 009/167] Fix some bad typing in __init__.py

---
 src/py/kaleido/__init__.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/src/py/kaleido/__init__.py b/src/py/kaleido/__init__.py
index 12047e04..2591ae1f 100644
--- a/src/py/kaleido/__init__.py
+++ b/src/py/kaleido/__init__.py
@@ -15,14 +15,14 @@
 from .kaleido import Kaleido
 
 if TYPE_CHECKING:
-    from collections.abc import AsyncIterable, Iterable, TypeVar
+    from collections.abc import AsyncIterable, Iterable
     from pathlib import Path
-    from typing import Any
+    from typing import Any, TypeVar, Union
 
     from ._fig_tools import Figurish, LayoutOpts
 
     T = TypeVar("T")
-    AnyIterable = AsyncIterable[T] | Iterable[T]
+    AnyIterable = Union[AsyncIterable[T], Iterable[T]]
 
 __all__ = [
     "Kaleido",

From 7d4d2973035eddbfaa9f9e0df92f63f40458328b Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Fri, 22 Aug 2025 16:34:36 -0500
Subject: [PATCH 010/167] Improve page logic.

---
 src/py/kaleido/kaleido.py | 19 ++++++++++++++-----
 1 file changed, 14 insertions(+), 5 deletions(-)

diff --git a/src/py/kaleido/kaleido.py b/src/py/kaleido/kaleido.py
index 72c6c901..85218761 100644
--- a/src/py/kaleido/kaleido.py
+++ b/src/py/kaleido/kaleido.py
@@ -4,10 +4,11 @@
 
 import asyncio
 import warnings
-from collections.abc import AsyncIterable, Iterable
+from collections.abc import Iterable
 from functools import partial
 from pathlib import Path
 from typing import TYPE_CHECKING
+from urllib.parse import unquote, urlparse
 
 import choreographer as choreo
 import logistro
@@ -155,10 +156,18 @@ def __init__(  # noqa: D417, PLR0913 no args/kwargs in description
                 "or `kaleido.get_chrome_sync()`.",
             ) from ChromeNotFoundError
 
-        if page and isinstance(page, str) and Path(page).is_file():
-            self._index = page
-        elif page and hasattr(page, "is_file") and page.is_file():
-            self._index = page.as_uri()
+        if isinstance(page, str):
+            if page.startswith(r"file://") and Path(unquote(urlparse(page).path)):
+                self._index = page
+            elif Path(page).is_file():
+                self._index = Path(page).as_uri()
+            else:
+                raise FileNotFoundError(f"{page} does not exist.")
+        elif isinstance(page, Path):
+            if page.is_file():
+                self._index = page.as_uri()
+            else:
+                raise FileNotFoundError(f"{page!s} does not exist.")
         else:
             self._tmp_dir = TmpDirectory(sneak=self.is_isolated())
             index = self._tmp_dir.path / "index.html"

From cbd925b8c8fcb3616f891126aa9fc665fcf7f611 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Fri, 22 Aug 2025 17:35:34 -0500
Subject: [PATCH 011/167] Add claude run on init and public api

---
 src/py/tests/test_init.py       | 163 +++++++++++++++++++++++++++++++
 src/py/tests/test_public_api.py | 168 ++++++++++++++++++++++++++++++++
 2 files changed, 331 insertions(+)
 create mode 100644 src/py/tests/test_init.py
 create mode 100644 src/py/tests/test_public_api.py

diff --git a/src/py/tests/test_init.py b/src/py/tests/test_init.py
new file mode 100644
index 00000000..0c2641a0
--- /dev/null
+++ b/src/py/tests/test_init.py
@@ -0,0 +1,163 @@
+"""Tests for wrapper functions in __init__.py that test argument passing."""
+
+from unittest.mock import MagicMock, patch
+
+import pytest
+
+import kaleido
+
+
+@pytest.fixture
+def mock_kaleido_context():
+    """Fixture that provides a mocked Kaleido context manager."""
+    mock_kaleido = MagicMock()
+    mock_kaleido.__aenter__ = MagicMock(return_value=mock_kaleido)
+    mock_kaleido.__aexit__ = MagicMock(return_value=False)
+    return mock_kaleido
+
+
+@patch("kaleido._sync_server.GlobalKaleidoServer.open")
+def test_start_sync_server_passes_args(mock_open):
+    """Test that start_sync_server passes args to GlobalKaleidoServer.open."""
+    args = ("arg1", "arg2")
+    kwargs = {"key1": "value1", "key2": "value2"}
+
+    kaleido.start_sync_server(*args, **kwargs)
+
+    mock_open.assert_called_once_with(*args, silence_warnings=False, **kwargs)
+
+
+@patch("kaleido._sync_server.GlobalKaleidoServer.open")
+def test_start_sync_server_silence_warnings(mock_open):
+    """Test that start_sync_server passes silence_warnings parameter correctly."""
+    args = ("arg1",)
+    kwargs = {"key1": "value1"}
+
+    kaleido.start_sync_server(*args, silence_warnings=True, **kwargs)
+
+    mock_open.assert_called_once_with(*args, silence_warnings=True, **kwargs)
+
+
+@patch("kaleido._sync_server.GlobalKaleidoServer.close")
+def test_stop_sync_server_passes_args(mock_close):
+    """Test that stop_sync_server passes silence_warnings to GlobalKaleidoServer."""
+    kaleido.stop_sync_server()
+
+    mock_close.assert_called_once_with(silence_warnings=False)
+
+
+@patch("kaleido._sync_server.GlobalKaleidoServer.close")
+def test_stop_sync_server_silence_warnings(mock_close):
+    """Test that stop_sync_server passes silence_warnings=True correctly."""
+    kaleido.stop_sync_server(silence_warnings=True)
+
+    mock_close.assert_called_once_with(silence_warnings=True)
+
+
+@patch("kaleido.Kaleido")
+@pytest.mark.asyncio
+async def test_calc_fig_passes_args_and_forces_n_to_1(
+    mock_kaleido_class,
+    mock_kaleido_context,
+):
+    """Test that calc_fig passes args correctly and forces n=1 in kopts."""
+    mock_kaleido_context.calc_fig.return_value = b"test_bytes"
+    mock_kaleido_class.return_value = mock_kaleido_context
+
+    fig = {"data": []}
+    path = "test.png"
+    opts = {"width": 800}
+    topojson = "test_topojson"
+    kopts = {"some_option": "value"}
+
+    result = await kaleido.calc_fig(fig, path, opts, topojson=topojson, kopts=kopts)
+
+    # Check that Kaleido was instantiated with kopts including n=1
+    expected_kopts = {"some_option": "value", "n": 1}
+    mock_kaleido_class.assert_called_once_with(**expected_kopts)
+
+    # Check that calc_fig was called with correct arguments
+    mock_kaleido_context.calc_fig.assert_called_once_with(
+        fig,
+        path=path,
+        opts=opts,
+        topojson=topojson,
+    )
+
+    assert result == b"test_bytes"
+
+
+@patch("kaleido.Kaleido")
+@pytest.mark.asyncio
+async def test_calc_fig_empty_kopts(mock_kaleido_class, mock_kaleido_context):
+    """Test that calc_fig works with empty kopts."""
+    mock_kaleido_context.calc_fig.return_value = b"test_bytes"
+    mock_kaleido_class.return_value = mock_kaleido_context
+
+    fig = {"data": []}
+
+    await kaleido.calc_fig(fig)
+
+    # Check that Kaleido was instantiated with only n=1
+    mock_kaleido_class.assert_called_once_with(n=1)
+
+
+@patch("kaleido.Kaleido")
+@pytest.mark.asyncio
+async def test_write_fig_passes_args(mock_kaleido_class, mock_kaleido_context):
+    """Test that write_fig passes all arguments correctly."""
+    mock_kaleido_class.return_value = mock_kaleido_context
+
+    fig = {"data": []}
+    path = "test.png"
+    opts = {"width": 800}
+    topojson = "test_topojson"
+    kopts = {"some_option": "value"}
+
+    await kaleido.write_fig(fig, path, opts, topojson=topojson, kopts=kopts)
+
+    # Check that Kaleido was instantiated with kopts
+    mock_kaleido_class.assert_called_once_with(**kopts)
+
+    # Check that write_fig was called with correct arguments
+    mock_kaleido_context.write_fig.assert_called_once_with(
+        fig,
+        path=path,
+        opts=opts,
+        topojson=topojson,
+    )
+
+
+@patch("kaleido.Kaleido")
+@pytest.mark.asyncio
+async def test_write_fig_empty_kopts(mock_kaleido_class, mock_kaleido_context):
+    """Test that write_fig works with empty kopts."""
+    mock_kaleido_class.return_value = mock_kaleido_context
+
+    fig = {"data": []}
+
+    await kaleido.write_fig(fig)
+
+    # Check that Kaleido was instantiated with empty dict
+    mock_kaleido_class.assert_called_once_with()
+
+
+@patch("kaleido.Kaleido")
+@pytest.mark.asyncio
+async def test_write_fig_from_object_passes_args(
+    mock_kaleido_class,
+    mock_kaleido_context,
+):
+    """Test that write_fig_from_object passes all arguments correctly."""
+    mock_kaleido_class.return_value = mock_kaleido_context
+
+    generator = [{"data": []}]
+    kopts = {"some_option": "value"}
+
+    await kaleido.write_fig_from_object(generator, kopts=kopts)
+
+    # Check that Kaleido was instantiated with kopts
+    mock_kaleido_class.assert_called_once_with(**kopts)
+
+    # Check that write_fig_from_object was called with correct arguments
+    mock_kaleido_context.write_fig_from_object.assert_called_once_with(generator)
diff --git a/src/py/tests/test_public_api.py b/src/py/tests/test_public_api.py
new file mode 100644
index 00000000..ebd9594b
--- /dev/null
+++ b/src/py/tests/test_public_api.py
@@ -0,0 +1,168 @@
+"""Integrative tests for all public API functions in __init__.py using basic figures."""
+
+import warnings
+from unittest.mock import patch
+
+import pytest
+
+import kaleido
+
+# allows to create a browser pool for tests
+pytestmark = pytest.mark.asyncio(loop_scope="function")
+
+
+@pytest.fixture
+def simple_figure():
+    """Create a simple plotly figure for testing."""
+    # ruff: noqa: PLC0415
+    import plotly.express as px
+
+    with warnings.catch_warnings():
+        warnings.filterwarnings("ignore", category=DeprecationWarning)
+        fig = px.line(x=[1, 2, 3, 4], y=[1, 2, 3, 4])
+
+    return fig
+
+
+async def test_calc_fig_basic(simple_figure):
+    """Test calc_fig with a basic figure."""
+    result = await kaleido.calc_fig(simple_figure)
+    assert isinstance(result, bytes)
+    assert len(result) > 0
+
+
+def test_calc_fig_sync_basic_server_running(simple_figure):
+    """Test calc_fig_sync when sync server is running."""
+    with patch("kaleido._global_server.is_running", return_value=True), patch(
+        "kaleido._global_server.call_function",
+        return_value=b"test_bytes",
+    ) as mock_call:
+        result = kaleido.calc_fig_sync(simple_figure)
+
+        mock_call.assert_called_once_with("calc_fig", simple_figure)
+        assert result == b"test_bytes"
+
+
+def test_calc_fig_sync_basic_server_not_running(simple_figure):
+    """Test calc_fig_sync when sync server is not running."""
+    with patch("kaleido._global_server.is_running", return_value=False), patch(
+        "kaleido._sync_server.oneshot_async_run",
+        return_value=b"test_bytes",
+    ) as mock_oneshot:
+        result = kaleido.calc_fig_sync(simple_figure)
+
+        mock_oneshot.assert_called_once_with(
+            kaleido.calc_fig,
+            args=(simple_figure,),
+            kwargs={},
+        )
+        assert result == b"test_bytes"
+
+
+async def test_write_fig_basic(simple_figure, tmp_path):
+    """Test write_fig with a basic figure."""
+    output_file = tmp_path / "test_output.png"
+
+    await kaleido.write_fig(simple_figure, path=str(output_file))
+
+    # Check that file was created (actual implementation would create the file)
+    # For this test we're just ensuring the function runs without error
+
+
+def test_write_fig_sync_basic_server_running(simple_figure):
+    """Test write_fig_sync when sync server is running."""
+    with patch("kaleido._global_server.is_running", return_value=True), patch(
+        "kaleido._global_server.call_function",
+    ) as mock_call:
+        kaleido.write_fig_sync(simple_figure, path="test.png")
+
+        mock_call.assert_called_once_with("write_fig", simple_figure, path="test.png")
+
+
+def test_write_fig_sync_basic_server_not_running(simple_figure):
+    """Test write_fig_sync when sync server is not running."""
+    with patch("kaleido._global_server.is_running", return_value=False), patch(
+        "kaleido._sync_server.oneshot_async_run",
+    ) as mock_oneshot:
+        kaleido.write_fig_sync(simple_figure, path="test.png")
+
+        mock_oneshot.assert_called_once_with(
+            kaleido.write_fig,
+            args=(simple_figure,),
+            kwargs={"path": "test.png"},
+        )
+
+
+async def test_write_fig_from_object_basic(simple_figure):
+    """Test write_fig_from_object with a basic figure generator."""
+    generator = [simple_figure]
+
+    # This should run without error
+    await kaleido.write_fig_from_object(generator)
+
+
+def test_write_fig_from_object_sync_basic_server_running(simple_figure):
+    """Test write_fig_from_object_sync when sync server is running."""
+    generator = [simple_figure]
+
+    with patch("kaleido._global_server.is_running", return_value=True), patch(
+        "kaleido._global_server.call_function",
+    ) as mock_call:
+        kaleido.write_fig_from_object_sync(generator)
+
+        mock_call.assert_called_once_with("write_fig_from_object", generator)
+
+
+def test_write_fig_from_object_sync_basic_server_not_running(simple_figure):
+    """Test write_fig_from_object_sync when sync server is not running."""
+    generator = [simple_figure]
+
+    with patch("kaleido._global_server.is_running", return_value=False), patch(
+        "kaleido._sync_server.oneshot_async_run",
+    ) as mock_oneshot:
+        kaleido.write_fig_from_object_sync(generator)
+
+        mock_oneshot.assert_called_once_with(
+            kaleido.write_fig_from_object,
+            args=(generator,),
+            kwargs={},
+        )
+
+
+def test_start_stop_sync_server_integration():
+    """Test start_sync_server and stop_sync_server together."""
+    # Test that we can start and stop the server without errors
+    kaleido.start_sync_server(silence_warnings=True)
+    kaleido.stop_sync_server(silence_warnings=True)
+
+
+def test_sync_server_with_calc_fig_sync_integration(simple_figure):
+    """Integration test: start server, use calc_fig_sync, then stop server."""
+    # Start server
+    kaleido.start_sync_server(silence_warnings=True)
+
+    try:
+        # Use calc_fig_sync - this should use the running server
+        result = kaleido.calc_fig_sync(simple_figure)
+        assert isinstance(result, bytes)
+        assert len(result) > 0
+
+    finally:
+        # Always stop the server
+        kaleido.stop_sync_server(silence_warnings=True)
+
+
+def test_sync_server_with_write_fig_sync_integration(simple_figure, tmp_path):
+    """Integration test: start server, use write_fig_sync, then stop server."""
+    output_file = tmp_path / "test_integration.png"
+
+    # Start server
+    kaleido.start_sync_server(silence_warnings=True)
+
+    try:
+        # Use write_fig_sync - this should use the running server
+        kaleido.write_fig_sync(simple_figure, path=str(output_file))
+
+    finally:
+        # Always stop the server
+        kaleido.stop_sync_server(silence_warnings=True)

From d99bb8801c153b5b8b5c5cbbc721bc381cee2244 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Fri, 22 Aug 2025 19:21:10 -0500
Subject: [PATCH 012/167] Move pytest async detection to auto

---
 src/py/pyproject.toml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/src/py/pyproject.toml b/src/py/pyproject.toml
index 392ddb25..1cca5695 100644
--- a/src/py/pyproject.toml
+++ b/src/py/pyproject.toml
@@ -85,6 +85,7 @@ ignore = [
             ]
 
 [tool.pytest.ini_options]
+asyncio_mode = "auto"
 asyncio_default_fixture_loop_scope = "function"
 log_cli = false
 

From 6d3cf13bf766267997bbfe5c340de386260149e8 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Fri, 22 Aug 2025 20:08:48 -0500
Subject: [PATCH 013/167] Iterate with Claude on test_public_api

---
 src/py/tests/test_public_api.py | 232 +++++++++++++++++---------------
 1 file changed, 124 insertions(+), 108 deletions(-)

diff --git a/src/py/tests/test_public_api.py b/src/py/tests/test_public_api.py
index ebd9594b..4e1d8132 100644
--- a/src/py/tests/test_public_api.py
+++ b/src/py/tests/test_public_api.py
@@ -1,15 +1,13 @@
 """Integrative tests for all public API functions in __init__.py using basic figures."""
 
 import warnings
+from pathlib import Path
 from unittest.mock import patch
 
 import pytest
 
 import kaleido
 
-# allows to create a browser pool for tests
-pytestmark = pytest.mark.asyncio(loop_scope="function")
-
 
 @pytest.fixture
 def simple_figure():
@@ -18,7 +16,6 @@ def simple_figure():
     import plotly.express as px
 
     with warnings.catch_warnings():
-        warnings.filterwarnings("ignore", category=DeprecationWarning)
         fig = px.line(x=[1, 2, 3, 4], y=[1, 2, 3, 4])
 
     return fig
@@ -28,141 +25,160 @@ async def test_calc_fig_basic(simple_figure):
     """Test calc_fig with a basic figure."""
     result = await kaleido.calc_fig(simple_figure)
     assert isinstance(result, bytes)
-    assert len(result) > 0
-
+    assert result.startswith(b"\x89PNG\r\n\x1a\n"), "Not a PNG file"
 
-def test_calc_fig_sync_basic_server_running(simple_figure):
-    """Test calc_fig_sync when sync server is running."""
-    with patch("kaleido._global_server.is_running", return_value=True), patch(
-        "kaleido._global_server.call_function",
-        return_value=b"test_bytes",
-    ) as mock_call:
-        result = kaleido.calc_fig_sync(simple_figure)
 
-        mock_call.assert_called_once_with("calc_fig", simple_figure)
-        assert result == b"test_bytes"
+async def test_calc_fig_sync_both_scenarios(simple_figure):
+    """Test calc_fig_sync in both server running and not running scenarios."""
+    # First get the expected result from calc_fig for comparison
+    expected_result = await kaleido.calc_fig(simple_figure)
+    assert isinstance(expected_result, bytes)
+    assert expected_result.startswith(b"\x89PNG\r\n\x1a\n"), "Not a PNG file"
 
+    # Test scenario 1: server running
+    kaleido.start_sync_server(silence_warnings=True)
+    try:
+        with patch(
+            "kaleido._global_server.call_function",
+            wraps=kaleido._global_server.call_function,  # noqa: SLF001 internal
+        ) as mock_call:
+            result_server_running = kaleido.calc_fig_sync(simple_figure)
+
+            mock_call.assert_called_once()
+            assert isinstance(result_server_running, bytes)
+            assert result_server_running.startswith(
+                b"\x89PNG\r\n\x1a\n",
+            ), "Not a PNG file"
+            assert result_server_running == expected_result
+    finally:
+        kaleido.stop_sync_server(silence_warnings=True)
 
-def test_calc_fig_sync_basic_server_not_running(simple_figure):
-    """Test calc_fig_sync when sync server is not running."""
-    with patch("kaleido._global_server.is_running", return_value=False), patch(
+    # Test scenario 2: server not running
+    with patch(
         "kaleido._sync_server.oneshot_async_run",
-        return_value=b"test_bytes",
+        wraps=kaleido._sync_server.oneshot_async_run,  # noqa: SLF001 internal
     ) as mock_oneshot:
-        result = kaleido.calc_fig_sync(simple_figure)
+        result_server_not_running = kaleido.calc_fig_sync(simple_figure)
 
-        mock_oneshot.assert_called_once_with(
-            kaleido.calc_fig,
-            args=(simple_figure,),
-            kwargs={},
-        )
-        assert result == b"test_bytes"
+        mock_oneshot.assert_called_once()
+        assert isinstance(result_server_not_running, bytes)
+        assert result_server_not_running.startswith(
+            b"\x89PNG\r\n\x1a\n",
+        ), "Not a PNG file"
+        assert result_server_not_running == expected_result
 
 
 async def test_write_fig_basic(simple_figure, tmp_path):
-    """Test write_fig with a basic figure."""
+    """Test write_fig with a basic figure and compare with calc_fig output."""
     output_file = tmp_path / "test_output.png"
 
+    # Get expected bytes from calc_fig
+    expected_bytes = await kaleido.calc_fig(simple_figure)
+
+    # Write figure to file
     await kaleido.write_fig(simple_figure, path=str(output_file))
 
-    # Check that file was created (actual implementation would create the file)
-    # For this test we're just ensuring the function runs without error
+    # Read the written file and compare
+    with Path(output_file).open("rb") as f:  # noqa: ASYNC230 use aiofile
+        written_bytes = f.read()
 
+    assert written_bytes == expected_bytes
+    assert written_bytes.startswith(b"\x89PNG\r\n\x1a\n"), "Not a PNG file"
 
-def test_write_fig_sync_basic_server_running(simple_figure):
-    """Test write_fig_sync when sync server is running."""
-    with patch("kaleido._global_server.is_running", return_value=True), patch(
-        "kaleido._global_server.call_function",
-    ) as mock_call:
-        kaleido.write_fig_sync(simple_figure, path="test.png")
 
-        mock_call.assert_called_once_with("write_fig", simple_figure, path="test.png")
+async def test_write_fig_sync_both_scenarios(simple_figure, tmp_path):
+    """Test write_fig_sync and write_fig_from_object_sync in both server scenarios."""
+    # Get expected bytes from calc_fig for comparison
+    expected_bytes = await kaleido.calc_fig(simple_figure)
+    assert expected_bytes.startswith(b"\x89PNG\r\n\x1a\n"), "Not a PNG file"
+
+    # Test scenario 1: server running
+    output_file_1 = tmp_path / "test_server_running.png"
+    output_file_from_object_1 = tmp_path / "test_from_object_server_running.png"
+    kaleido.start_sync_server(silence_warnings=True)
+    try:
+        with patch(
+            "kaleido._global_server.call_function",
+            wraps=kaleido._global_server.call_function,  # noqa: SLF001 internal
+        ) as mock_call:
+            # Test write_fig_sync
+            kaleido.write_fig_sync(simple_figure, path=str(output_file_1))
+
+            # Test write_fig_from_object_sync
+            kaleido.write_fig_from_object_sync(
+                [
+                    {
+                        "fig": simple_figure,
+                        "path": output_file_from_object_1,
+                    },
+                ],
+            )
+
+            # Should have been called twice (once for each function)
+            assert mock_call.call_count == 2  # noqa: PLR2004
+
+            # Read and verify the written files
+            with Path(output_file_1).open("rb") as f:  # noqa: ASYNC230
+                written_bytes_1 = f.read()
+            assert written_bytes_1 == expected_bytes
+
+            # Read and verify the written files
+            with Path(output_file_from_object_1).open("rb") as f:  # noqa: ASYNC230
+                from_object_written_bytes_1 = f.read()
+            assert from_object_written_bytes_1 == expected_bytes
 
+    finally:
+        kaleido.stop_sync_server(silence_warnings=True)
 
-def test_write_fig_sync_basic_server_not_running(simple_figure):
-    """Test write_fig_sync when sync server is not running."""
-    with patch("kaleido._global_server.is_running", return_value=False), patch(
+    # Test scenario 2: server not running
+    output_file_2 = tmp_path / "test_server_not_running.png"
+    output_file_from_object_2 = tmp_path / "test_from_object_server_not_running.png"
+    with patch(
         "kaleido._sync_server.oneshot_async_run",
+        wraps=kaleido._sync_server.oneshot_async_run,  # noqa: SLF001 internal
     ) as mock_oneshot:
-        kaleido.write_fig_sync(simple_figure, path="test.png")
-
-        mock_oneshot.assert_called_once_with(
-            kaleido.write_fig,
-            args=(simple_figure,),
-            kwargs={"path": "test.png"},
+        # Test write_fig_sync
+        kaleido.write_fig_sync(simple_figure, path=str(output_file_2))
+
+        # Test write_fig_from_object_sync
+        kaleido.write_fig_from_object_sync(
+            [
+                {
+                    "fig": simple_figure,
+                    "path": output_file_from_object_1,
+                },
+            ],
         )
 
+        # Should have been called twice (once for each function)
+        assert mock_oneshot.call_count == 2  # noqa: PLR2004
 
-async def test_write_fig_from_object_basic(simple_figure):
-    """Test write_fig_from_object with a basic figure generator."""
-    generator = [simple_figure]
-
-    # This should run without error
-    await kaleido.write_fig_from_object(generator)
+        # Read and verify the written files
+        with Path(output_file_2).open("rb") as f:  # noqa: ASYNC230
+            written_bytes_2 = f.read()
+        assert written_bytes_2 == expected_bytes
 
-
-def test_write_fig_from_object_sync_basic_server_running(simple_figure):
-    """Test write_fig_from_object_sync when sync server is running."""
-    generator = [simple_figure]
-
-    with patch("kaleido._global_server.is_running", return_value=True), patch(
-        "kaleido._global_server.call_function",
-    ) as mock_call:
-        kaleido.write_fig_from_object_sync(generator)
-
-        mock_call.assert_called_once_with("write_fig_from_object", generator)
-
-
-def test_write_fig_from_object_sync_basic_server_not_running(simple_figure):
-    """Test write_fig_from_object_sync when sync server is not running."""
-    generator = [simple_figure]
-
-    with patch("kaleido._global_server.is_running", return_value=False), patch(
-        "kaleido._sync_server.oneshot_async_run",
-    ) as mock_oneshot:
-        kaleido.write_fig_from_object_sync(generator)
-
-        mock_oneshot.assert_called_once_with(
-            kaleido.write_fig_from_object,
-            args=(generator,),
-            kwargs={},
-        )
+        # Read and verify the written files
+        with Path(output_file_from_object_2).open("rb") as f:  # noqa: ASYNC230
+            from_object_written_bytes_2 = f.read()
+        assert from_object_written_bytes_2 == expected_bytes
 
 
 def test_start_stop_sync_server_integration():
-    """Test start_sync_server and stop_sync_server together."""
-    # Test that we can start and stop the server without errors
-    kaleido.start_sync_server(silence_warnings=True)
-    kaleido.stop_sync_server(silence_warnings=True)
+    """Test start_sync_server and stop_sync_server with warning behavior."""
+    # Test starting and stopping with warnings silenced
+    kaleido.start_sync_server(silence_warnings=False)
 
+    # Test starting already started server - should warn
+    with pytest.warns(UserWarning, match="already"):
+        kaleido.start_sync_server(silence_warnings=False)
 
-def test_sync_server_with_calc_fig_sync_integration(simple_figure):
-    """Integration test: start server, use calc_fig_sync, then stop server."""
-    # Start server
     kaleido.start_sync_server(silence_warnings=True)
 
-    try:
-        # Use calc_fig_sync - this should use the running server
-        result = kaleido.calc_fig_sync(simple_figure)
-        assert isinstance(result, bytes)
-        assert len(result) > 0
+    kaleido.stop_sync_server(silence_warnings=False)
 
-    finally:
-        # Always stop the server
-        kaleido.stop_sync_server(silence_warnings=True)
+    # Test stopping already stopped server - should warn
+    with pytest.warns(UserWarning, match="not running"):
+        kaleido.stop_sync_server(silence_warnings=False)
 
-
-def test_sync_server_with_write_fig_sync_integration(simple_figure, tmp_path):
-    """Integration test: start server, use write_fig_sync, then stop server."""
-    output_file = tmp_path / "test_integration.png"
-
-    # Start server
-    kaleido.start_sync_server(silence_warnings=True)
-
-    try:
-        # Use write_fig_sync - this should use the running server
-        kaleido.write_fig_sync(simple_figure, path=str(output_file))
-
-    finally:
-        # Always stop the server
-        kaleido.stop_sync_server(silence_warnings=True)
+    kaleido.stop_sync_server(silence_warnings=True)

From e4ba49cb6a391753c43af86d2e69491f1ad0ae39 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Fri, 22 Aug 2025 20:21:08 -0500
Subject: [PATCH 014/167] Make corrections to public api tests.

---
 src/py/tests/test_public_api.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/src/py/tests/test_public_api.py b/src/py/tests/test_public_api.py
index 4e1d8132..2cfc8e42 100644
--- a/src/py/tests/test_public_api.py
+++ b/src/py/tests/test_public_api.py
@@ -145,7 +145,7 @@ async def test_write_fig_sync_both_scenarios(simple_figure, tmp_path):
             [
                 {
                     "fig": simple_figure,
-                    "path": output_file_from_object_1,
+                    "path": output_file_from_object_2,
                 },
             ],
         )
@@ -170,7 +170,7 @@ def test_start_stop_sync_server_integration():
     kaleido.start_sync_server(silence_warnings=False)
 
     # Test starting already started server - should warn
-    with pytest.warns(UserWarning, match="already"):
+    with pytest.warns(RuntimeWarning, match="already"):
         kaleido.start_sync_server(silence_warnings=False)
 
     kaleido.start_sync_server(silence_warnings=True)
@@ -178,7 +178,7 @@ def test_start_stop_sync_server_integration():
     kaleido.stop_sync_server(silence_warnings=False)
 
     # Test stopping already stopped server - should warn
-    with pytest.warns(UserWarning, match="not running"):
+    with pytest.warns(RuntimeWarning, match="closed"):
         kaleido.stop_sync_server(silence_warnings=False)
 
     kaleido.stop_sync_server(silence_warnings=True)

From 1898bd9f699c9e8e15269ed87f9e08ffd965ec57 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Fri, 22 Aug 2025 21:48:55 -0500
Subject: [PATCH 015/167] Fix up test_init

---
 src/py/tests/test_init.py | 149 ++++++++++++--------------------------
 1 file changed, 47 insertions(+), 102 deletions(-)

diff --git a/src/py/tests/test_init.py b/src/py/tests/test_init.py
index 0c2641a0..c6a1543e 100644
--- a/src/py/tests/test_init.py
+++ b/src/py/tests/test_init.py
@@ -1,70 +1,55 @@
 """Tests for wrapper functions in __init__.py that test argument passing."""
 
-from unittest.mock import MagicMock, patch
-
-import pytest
+from unittest.mock import AsyncMock, patch
 
 import kaleido
 
 
-@pytest.fixture
-def mock_kaleido_context():
-    """Fixture that provides a mocked Kaleido context manager."""
-    mock_kaleido = MagicMock()
-    mock_kaleido.__aenter__ = MagicMock(return_value=mock_kaleido)
-    mock_kaleido.__aexit__ = MagicMock(return_value=False)
-    return mock_kaleido
-
-
 @patch("kaleido._sync_server.GlobalKaleidoServer.open")
 def test_start_sync_server_passes_args(mock_open):
-    """Test that start_sync_server passes args to GlobalKaleidoServer.open."""
+    """Test that start_sync_server passes args and silence_warnings correctly."""
+    # Test with silence_warnings=False (default)
     args = ("arg1", "arg2")
     kwargs = {"key1": "value1", "key2": "value2"}
 
     kaleido.start_sync_server(*args, **kwargs)
+    mock_open.assert_called_with(*args, silence_warnings=False, **kwargs)
 
-    mock_open.assert_called_once_with(*args, silence_warnings=False, **kwargs)
-
-
-@patch("kaleido._sync_server.GlobalKaleidoServer.open")
-def test_start_sync_server_silence_warnings(mock_open):
-    """Test that start_sync_server passes silence_warnings parameter correctly."""
+    # Reset mock and test with silence_warnings=True
+    mock_open.reset_mock()
     args = ("arg1",)
     kwargs = {"key1": "value1"}
 
     kaleido.start_sync_server(*args, silence_warnings=True, **kwargs)
-
-    mock_open.assert_called_once_with(*args, silence_warnings=True, **kwargs)
+    mock_open.assert_called_with(*args, silence_warnings=True, **kwargs)
 
 
 @patch("kaleido._sync_server.GlobalKaleidoServer.close")
 def test_stop_sync_server_passes_args(mock_close):
-    """Test that stop_sync_server passes silence_warnings to GlobalKaleidoServer."""
+    """Test that stop_sync_server passes silence_warnings correctly."""
+    # Test with silence_warnings=False (default)
     kaleido.stop_sync_server()
+    mock_close.assert_called_with(silence_warnings=False)
 
-    mock_close.assert_called_once_with(silence_warnings=False)
-
-
-@patch("kaleido._sync_server.GlobalKaleidoServer.close")
-def test_stop_sync_server_silence_warnings(mock_close):
-    """Test that stop_sync_server passes silence_warnings=True correctly."""
+    # Reset mock and test with silence_warnings=True
+    mock_close.reset_mock()
     kaleido.stop_sync_server(silence_warnings=True)
-
-    mock_close.assert_called_once_with(silence_warnings=True)
+    mock_close.assert_called_with(silence_warnings=True)
 
 
 @patch("kaleido.Kaleido")
-@pytest.mark.asyncio
-async def test_calc_fig_passes_args_and_forces_n_to_1(
-    mock_kaleido_class,
-    mock_kaleido_context,
-):
-    """Test that calc_fig passes args correctly and forces n=1 in kopts."""
-    mock_kaleido_context.calc_fig.return_value = b"test_bytes"
-    mock_kaleido_class.return_value = mock_kaleido_context
+async def test_async_wrapper_functions(mock_kaleido_class):
+    """Test all async wrapper functions pass arguments correctly."""
+    # Create a mock that doesn't need the context fixture
+    mock_kaleido = AsyncMock()
+    mock_kaleido.__aenter__.return_value = mock_kaleido
+    mock_kaleido.__aexit__.return_value = None
+    mock_kaleido.calc_fig.return_value = b"test_bytes"
+    mock_kaleido_class.return_value = mock_kaleido
 
     fig = {"data": []}
+
+    # Test calc_fig with full arguments and kopts forcing n=1
     path = "test.png"
     opts = {"width": 800}
     topojson = "test_topojson"
@@ -72,92 +57,52 @@ async def test_calc_fig_passes_args_and_forces_n_to_1(
 
     result = await kaleido.calc_fig(fig, path, opts, topojson=topojson, kopts=kopts)
 
-    # Check that Kaleido was instantiated with kopts including n=1
     expected_kopts = {"some_option": "value", "n": 1}
-    mock_kaleido_class.assert_called_once_with(**expected_kopts)
-
-    # Check that calc_fig was called with correct arguments
-    mock_kaleido_context.calc_fig.assert_called_once_with(
+    mock_kaleido_class.assert_called_with(**expected_kopts)
+    mock_kaleido.calc_fig.assert_called_with(
         fig,
         path=path,
         opts=opts,
         topojson=topojson,
     )
-
     assert result == b"test_bytes"
 
+    # Reset mocks
+    mock_kaleido_class.reset_mock()
+    mock_kaleido.calc_fig.reset_mock()
 
-@patch("kaleido.Kaleido")
-@pytest.mark.asyncio
-async def test_calc_fig_empty_kopts(mock_kaleido_class, mock_kaleido_context):
-    """Test that calc_fig works with empty kopts."""
-    mock_kaleido_context.calc_fig.return_value = b"test_bytes"
-    mock_kaleido_class.return_value = mock_kaleido_context
-
-    fig = {"data": []}
-
+    # Test calc_fig with empty kopts
     await kaleido.calc_fig(fig)
+    mock_kaleido_class.assert_called_with(n=1)
 
-    # Check that Kaleido was instantiated with only n=1
-    mock_kaleido_class.assert_called_once_with(n=1)
-
-
-@patch("kaleido.Kaleido")
-@pytest.mark.asyncio
-async def test_write_fig_passes_args(mock_kaleido_class, mock_kaleido_context):
-    """Test that write_fig passes all arguments correctly."""
-    mock_kaleido_class.return_value = mock_kaleido_context
-
-    fig = {"data": []}
-    path = "test.png"
-    opts = {"width": 800}
-    topojson = "test_topojson"
-    kopts = {"some_option": "value"}
+    # Reset mocks
+    mock_kaleido_class.reset_mock()
+    mock_kaleido.write_fig.reset_mock()
 
+    # Test write_fig with full arguments
     await kaleido.write_fig(fig, path, opts, topojson=topojson, kopts=kopts)
-
-    # Check that Kaleido was instantiated with kopts
-    mock_kaleido_class.assert_called_once_with(**kopts)
-
-    # Check that write_fig was called with correct arguments
-    mock_kaleido_context.write_fig.assert_called_once_with(
+    mock_kaleido_class.assert_called_with(**kopts)  # write_fig doesn't force n=1
+    mock_kaleido.write_fig.assert_called_with(
         fig,
         path=path,
         opts=opts,
         topojson=topojson,
     )
 
+    # Reset mocks
+    mock_kaleido_class.reset_mock()
+    mock_kaleido.write_fig.reset_mock()
 
-@patch("kaleido.Kaleido")
-@pytest.mark.asyncio
-async def test_write_fig_empty_kopts(mock_kaleido_class, mock_kaleido_context):
-    """Test that write_fig works with empty kopts."""
-    mock_kaleido_class.return_value = mock_kaleido_context
-
-    fig = {"data": []}
-
+    # Test write_fig with empty kopts
     await kaleido.write_fig(fig)
+    mock_kaleido_class.assert_called_with()
 
-    # Check that Kaleido was instantiated with empty dict
-    mock_kaleido_class.assert_called_once_with()
-
-
-@patch("kaleido.Kaleido")
-@pytest.mark.asyncio
-async def test_write_fig_from_object_passes_args(
-    mock_kaleido_class,
-    mock_kaleido_context,
-):
-    """Test that write_fig_from_object passes all arguments correctly."""
-    mock_kaleido_class.return_value = mock_kaleido_context
+    # Reset mocks
+    mock_kaleido_class.reset_mock()
+    mock_kaleido.write_fig_from_object.reset_mock()
 
+    # Test write_fig_from_object
     generator = [{"data": []}]
-    kopts = {"some_option": "value"}
-
     await kaleido.write_fig_from_object(generator, kopts=kopts)
-
-    # Check that Kaleido was instantiated with kopts
-    mock_kaleido_class.assert_called_once_with(**kopts)
-
-    # Check that write_fig_from_object was called with correct arguments
-    mock_kaleido_context.write_fig_from_object.assert_called_once_with(generator)
+    mock_kaleido_class.assert_called_with(**kopts)
+    mock_kaleido.write_fig_from_object.assert_called_with(generator)

From 4147850b645a23dd66a4c039aaa171ed87bbe20b Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Fri, 22 Aug 2025 21:52:31 -0500
Subject: [PATCH 016/167] Add comments.

---
 src/py/tests/test_init.py | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/src/py/tests/test_init.py b/src/py/tests/test_init.py
index c6a1543e..1e99c10d 100644
--- a/src/py/tests/test_init.py
+++ b/src/py/tests/test_init.py
@@ -4,6 +4,9 @@
 
 import kaleido
 
+# Pretty complicated for basically testing a bunch of wrappers, but it works.
+# Integration tests seem more important.
+
 
 @patch("kaleido._sync_server.GlobalKaleidoServer.open")
 def test_start_sync_server_passes_args(mock_open):

From 7a808b429555493e1610b9b27c6ae1a2c8619cc6 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Fri, 22 Aug 2025 21:59:11 -0500
Subject: [PATCH 017/167] Reorganize a bit.

---
 src/py/tests/test_init.py | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/src/py/tests/test_init.py b/src/py/tests/test_init.py
index 1e99c10d..131df7a5 100644
--- a/src/py/tests/test_init.py
+++ b/src/py/tests/test_init.py
@@ -44,11 +44,10 @@ def test_stop_sync_server_passes_args(mock_close):
 async def test_async_wrapper_functions(mock_kaleido_class):
     """Test all async wrapper functions pass arguments correctly."""
     # Create a mock that doesn't need the context fixture
-    mock_kaleido = AsyncMock()
+    mock_kaleido_class.return_value = mock_kaleido = AsyncMock()
     mock_kaleido.__aenter__.return_value = mock_kaleido
     mock_kaleido.__aexit__.return_value = None
     mock_kaleido.calc_fig.return_value = b"test_bytes"
-    mock_kaleido_class.return_value = mock_kaleido
 
     fig = {"data": []}
 

From abcc184d6e3f6c1bd1f5f74a92c88a251a80bdeb Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Fri, 22 Aug 2025 22:01:28 -0500
Subject: [PATCH 018/167] Make error_log/profiler 100% optional in __init__

---
 src/py/kaleido/__init__.py | 14 +++++---------
 1 file changed, 5 insertions(+), 9 deletions(-)

diff --git a/src/py/kaleido/__init__.py b/src/py/kaleido/__init__.py
index 2591ae1f..71c18427 100644
--- a/src/py/kaleido/__init__.py
+++ b/src/py/kaleido/__init__.py
@@ -107,15 +107,14 @@ async def calc_fig(
         )
 
 
-async def write_fig(  # noqa: PLR0913 (too many args, complexity)
+async def write_fig(
     fig: Figurish,
     path: str | None | Path = None,
     opts: LayoutOpts | None = None,
     *,
     topojson: str | None = None,
     kopts: dict[str, Any] | None = None,
-    error_log=None,
-    profiler=None,
+    **kwargs,
 ):
     """
     Write a plotly figure(s) to a file.
@@ -135,8 +134,7 @@ async def write_fig(  # noqa: PLR0913 (too many args, complexity)
             path=path,
             opts=opts,
             topojson=topojson,
-            error_log=error_log,
-            profiler=profiler,
+            **kwargs,
         )
 
 
@@ -144,8 +142,7 @@ async def write_fig_from_object(
     generator: AnyIterable,  # this could be more specific with []
     *,
     kopts: dict[str, Any] | None = None,
-    error_log=None,
-    profiler=None,
+    **kwargs,
 ):
     """
     Write a plotly figure(s) to a file.
@@ -162,8 +159,7 @@ async def write_fig_from_object(
     async with Kaleido(**(kopts or {})) as k:
         await k.write_fig_from_object(
             generator,
-            error_log=error_log,
-            profiler=profiler,
+            **kwargs,
         )
 
 

From 24d0dab3c205a9cb8882766e38f63bef157d6182 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Mon, 25 Aug 2025 12:49:19 -0500
Subject: [PATCH 019/167] Iterate with claude on public_api test.

---
 src/py/tests/test_public_api.py | 210 ++++++++++++++++----------------
 1 file changed, 108 insertions(+), 102 deletions(-)

diff --git a/src/py/tests/test_public_api.py b/src/py/tests/test_public_api.py
index 2cfc8e42..1e50f923 100644
--- a/src/py/tests/test_public_api.py
+++ b/src/py/tests/test_public_api.py
@@ -1,6 +1,5 @@
 """Integrative tests for all public API functions in __init__.py using basic figures."""
 
-import warnings
 from pathlib import Path
 from unittest.mock import patch
 
@@ -15,153 +14,160 @@ def simple_figure():
     # ruff: noqa: PLC0415
     import plotly.express as px
 
-    with warnings.catch_warnings():
-        fig = px.line(x=[1, 2, 3, 4], y=[1, 2, 3, 4])
+    fig = px.line(x=[1, 2, 3, 4], y=[1, 2, 3, 4])
 
     return fig
 
 
-async def test_calc_fig_basic(simple_figure):
-    """Test calc_fig with a basic figure."""
-    result = await kaleido.calc_fig(simple_figure)
-    assert isinstance(result, bytes)
-    assert result.startswith(b"\x89PNG\r\n\x1a\n"), "Not a PNG file"
+async def test_async_api_functions(simple_figure, tmp_path):
+    """Test calc_fig, write_fig, and write_fig_from_object with cross-validation."""
+    # Test calc_fig and get reference bytes
+    calc_result = await kaleido.calc_fig(simple_figure)
+    assert isinstance(calc_result, bytes)
+    assert calc_result.startswith(b"\x89PNG\r\n\x1a\n"), "Not a PNG file"
 
+    # Test write_fig and compare with calc_fig output
+    write_fig_output = tmp_path / "test_write_fig.png"
+    await kaleido.write_fig(simple_figure, path=str(write_fig_output))
 
-async def test_calc_fig_sync_both_scenarios(simple_figure):
-    """Test calc_fig_sync in both server running and not running scenarios."""
-    # First get the expected result from calc_fig for comparison
-    expected_result = await kaleido.calc_fig(simple_figure)
-    assert isinstance(expected_result, bytes)
-    assert expected_result.startswith(b"\x89PNG\r\n\x1a\n"), "Not a PNG file"
+    with Path(write_fig_output).open("rb") as f:  # noqa: ASYNC230
+        write_fig_bytes = f.read()
 
-    # Test scenario 1: server running
-    kaleido.start_sync_server(silence_warnings=True)
-    try:
-        with patch(
-            "kaleido._global_server.call_function",
-            wraps=kaleido._global_server.call_function,  # noqa: SLF001 internal
-        ) as mock_call:
-            result_server_running = kaleido.calc_fig_sync(simple_figure)
-
-            mock_call.assert_called_once()
-            assert isinstance(result_server_running, bytes)
-            assert result_server_running.startswith(
-                b"\x89PNG\r\n\x1a\n",
-            ), "Not a PNG file"
-            assert result_server_running == expected_result
-    finally:
-        kaleido.stop_sync_server(silence_warnings=True)
+    assert write_fig_bytes == calc_result
+    assert write_fig_bytes.startswith(b"\x89PNG\r\n\x1a\n"), "Not a PNG file"
 
-    # Test scenario 2: server not running
-    with patch(
-        "kaleido._sync_server.oneshot_async_run",
-        wraps=kaleido._sync_server.oneshot_async_run,  # noqa: SLF001 internal
-    ) as mock_oneshot:
-        result_server_not_running = kaleido.calc_fig_sync(simple_figure)
+    # Test write_fig_from_object and compare with calc_fig output
+    write_fig_from_object_output = tmp_path / "test_write_fig_from_object.png"
+    await kaleido.write_fig_from_object(
+        [
+            {
+                "fig": simple_figure,
+                "path": write_fig_from_object_output,
+            },
+        ],
+    )
 
-        mock_oneshot.assert_called_once()
-        assert isinstance(result_server_not_running, bytes)
-        assert result_server_not_running.startswith(
-            b"\x89PNG\r\n\x1a\n",
-        ), "Not a PNG file"
-        assert result_server_not_running == expected_result
+    with Path(write_fig_from_object_output).open("rb") as f:  # noqa: ASYNC230
+        write_fig_from_object_bytes = f.read()
 
+    assert write_fig_from_object_bytes == calc_result
+    assert write_fig_from_object_bytes.startswith(
+        b"\x89PNG\r\n\x1a\n",
+    ), "Not a PNG file"
 
-async def test_write_fig_basic(simple_figure, tmp_path):
-    """Test write_fig with a basic figure and compare with calc_fig output."""
-    output_file = tmp_path / "test_output.png"
+    # Cross-validate all results are identical
+    assert write_fig_bytes == write_fig_from_object_bytes == calc_result
 
-    # Get expected bytes from calc_fig
-    expected_bytes = await kaleido.calc_fig(simple_figure)
 
-    # Write figure to file
-    await kaleido.write_fig(simple_figure, path=str(output_file))
-
-    # Read the written file and compare
-    with Path(output_file).open("rb") as f:  # noqa: ASYNC230 use aiofile
-        written_bytes = f.read()
-
-    assert written_bytes == expected_bytes
-    assert written_bytes.startswith(b"\x89PNG\r\n\x1a\n"), "Not a PNG file"
-
-
-async def test_write_fig_sync_both_scenarios(simple_figure, tmp_path):
-    """Test write_fig_sync and write_fig_from_object_sync in both server scenarios."""
+async def test_sync_api_functions(simple_figure, tmp_path):
+    """Test sync wrappers with cross-validation."""
     # Get expected bytes from calc_fig for comparison
     expected_bytes = await kaleido.calc_fig(simple_figure)
+    assert isinstance(expected_bytes, bytes)
     assert expected_bytes.startswith(b"\x89PNG\r\n\x1a\n"), "Not a PNG file"
 
     # Test scenario 1: server running
-    output_file_1 = tmp_path / "test_server_running.png"
-    output_file_from_object_1 = tmp_path / "test_from_object_server_running.png"
-    kaleido.start_sync_server(silence_warnings=True)
-    try:
-        with patch(
-            "kaleido._global_server.call_function",
-            wraps=kaleido._global_server.call_function,  # noqa: SLF001 internal
-        ) as mock_call:
+    write_fig_output_1 = tmp_path / "test_write_fig_server_running.png"
+    write_fig_from_object_output_1 = tmp_path / "test_from_object_server_running.png"
+
+    with patch(
+        "kaleido._sync_server.oneshot_async_run",
+        wraps=kaleido._sync_server.oneshot_async_run,  # noqa: SLF001 internal
+    ) as mock_oneshot, patch(
+        "kaleido._global_server.call_function",
+        wraps=kaleido._global_server.call_function,  # noqa: SLF001 internal
+    ) as mock_call:
+        kaleido.start_sync_server(silence_warnings=True)
+        try:
+            # Test calc_fig_sync
+            calc_result_1 = kaleido.calc_fig_sync(simple_figure)
+            assert isinstance(calc_result_1, bytes)
+            assert calc_result_1.startswith(b"\x89PNG\r\n\x1a\n"), "Not a PNG file"
+            assert calc_result_1 == expected_bytes
+
             # Test write_fig_sync
-            kaleido.write_fig_sync(simple_figure, path=str(output_file_1))
+            kaleido.write_fig_sync(simple_figure, path=str(write_fig_output_1))
+
+            with Path(write_fig_output_1).open("rb") as f:  # noqa: ASYNC230
+                write_fig_bytes_1 = f.read()
+            assert write_fig_bytes_1 == expected_bytes
+            assert write_fig_bytes_1.startswith(b"\x89PNG\r\n\x1a\n"), "Not a PNG file"
 
             # Test write_fig_from_object_sync
             kaleido.write_fig_from_object_sync(
                 [
                     {
                         "fig": simple_figure,
-                        "path": output_file_from_object_1,
+                        "path": write_fig_from_object_output_1,
                     },
                 ],
             )
 
-            # Should have been called twice (once for each function)
-            assert mock_call.call_count == 2  # noqa: PLR2004
+            with Path(write_fig_from_object_output_1).open("rb") as f:  # noqa: ASYNC230
+                from_object_bytes_1 = f.read()
+            assert from_object_bytes_1 == expected_bytes
+            assert from_object_bytes_1.startswith(
+                b"\x89PNG\r\n\x1a\n",
+            ), "Not a PNG file"
 
-            # Read and verify the written files
-            with Path(output_file_1).open("rb") as f:  # noqa: ASYNC230
-                written_bytes_1 = f.read()
-            assert written_bytes_1 == expected_bytes
+            # Should have been called three times (once for each function)
+            assert mock_call.call_count == 3  # noqa: PLR2004
+            assert mock_oneshot.call_count == 0
 
-            # Read and verify the written files
-            with Path(output_file_from_object_1).open("rb") as f:  # noqa: ASYNC230
-                from_object_written_bytes_1 = f.read()
-            assert from_object_written_bytes_1 == expected_bytes
+            # Cross-validate all server running results are identical
+            assert (
+                calc_result_1
+                == write_fig_bytes_1
+                == from_object_bytes_1
+                == expected_bytes
+            )
 
-    finally:
-        kaleido.stop_sync_server(silence_warnings=True)
+        finally:
+            kaleido.stop_sync_server(silence_warnings=True)
+
+        # Test scenario 2: server not running
+        write_fig_output_2 = tmp_path / "test_write_fig_server_not_running.png"
+        write_fig_from_object_output_2 = (
+            tmp_path / "test_from_object_server_not_running.png"
+        )
+
+        # Test calc_fig_sync
+        calc_result_2 = kaleido.calc_fig_sync(simple_figure)
+        assert isinstance(calc_result_2, bytes)
+        assert calc_result_2.startswith(b"\x89PNG\r\n\x1a\n"), "Not a PNG file"
+        assert calc_result_2 == expected_bytes
 
-    # Test scenario 2: server not running
-    output_file_2 = tmp_path / "test_server_not_running.png"
-    output_file_from_object_2 = tmp_path / "test_from_object_server_not_running.png"
-    with patch(
-        "kaleido._sync_server.oneshot_async_run",
-        wraps=kaleido._sync_server.oneshot_async_run,  # noqa: SLF001 internal
-    ) as mock_oneshot:
         # Test write_fig_sync
-        kaleido.write_fig_sync(simple_figure, path=str(output_file_2))
+        kaleido.write_fig_sync(simple_figure, path=str(write_fig_output_2))
+
+        with Path(write_fig_output_2).open("rb") as f:  # noqa: ASYNC230
+            write_fig_bytes_2 = f.read()
+        assert write_fig_bytes_2 == expected_bytes
+        assert write_fig_bytes_2.startswith(b"\x89PNG\r\n\x1a\n"), "Not a PNG file"
 
         # Test write_fig_from_object_sync
         kaleido.write_fig_from_object_sync(
             [
                 {
                     "fig": simple_figure,
-                    "path": output_file_from_object_2,
+                    "path": write_fig_from_object_output_2,
                 },
             ],
         )
 
-        # Should have been called twice (once for each function)
-        assert mock_oneshot.call_count == 2  # noqa: PLR2004
+        with Path(write_fig_from_object_output_2).open("rb") as f:  # noqa: ASYNC230
+            from_object_bytes_2 = f.read()
+        assert from_object_bytes_2 == expected_bytes
+        assert from_object_bytes_2.startswith(b"\x89PNG\r\n\x1a\n"), "Not a PNG file"
 
-        # Read and verify the written files
-        with Path(output_file_2).open("rb") as f:  # noqa: ASYNC230
-            written_bytes_2 = f.read()
-        assert written_bytes_2 == expected_bytes
+        # Should have been called three times (once for each function)
+        assert mock_call.call_count == 3  # noqa: PLR2004
+        assert mock_oneshot.call_count == 3  # noqa: PLR2004
 
-        # Read and verify the written files
-        with Path(output_file_from_object_2).open("rb") as f:  # noqa: ASYNC230
-            from_object_written_bytes_2 = f.read()
-        assert from_object_written_bytes_2 == expected_bytes
+        # Cross-validate all server not running results are identical
+        assert (
+            calc_result_2 == write_fig_bytes_2 == from_object_bytes_2 == expected_bytes
+        )
 
 
 def test_start_stop_sync_server_integration():

From f5cc483a0ba0df67aec546d6868d29f2927516a6 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Mon, 25 Aug 2025 13:53:32 -0500
Subject: [PATCH 020/167] Parameterize public api tests for fig/to_dict()

---
 src/py/tests/test_public_api.py | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/src/py/tests/test_public_api.py b/src/py/tests/test_public_api.py
index 1e50f923..16fc4767 100644
--- a/src/py/tests/test_public_api.py
+++ b/src/py/tests/test_public_api.py
@@ -8,14 +8,16 @@
 import kaleido
 
 
-@pytest.fixture
-def simple_figure():
-    """Create a simple plotly figure for testing."""
+@pytest.fixture(params=["figure", "dict"])
+def simple_figure(request):
+    """Create a simple plotly figure for testing, either as figure or dict."""
     # ruff: noqa: PLC0415
     import plotly.express as px
 
     fig = px.line(x=[1, 2, 3, 4], y=[1, 2, 3, 4])
 
+    if request.param == "dict":
+        return fig.to_dict()
     return fig
 
 

From 9489b717bf5e1d344e7444657f7d8066430b047a Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Mon, 25 Aug 2025 14:38:42 -0500
Subject: [PATCH 021/167] Change to using args fixtures.

---
 src/py/tests/test_init.py | 80 +++++++++++++++++++++++++++++++++++----
 1 file changed, 72 insertions(+), 8 deletions(-)

diff --git a/src/py/tests/test_init.py b/src/py/tests/test_init.py
index 131df7a5..79fb5ba3 100644
--- a/src/py/tests/test_init.py
+++ b/src/py/tests/test_init.py
@@ -2,27 +2,37 @@
 
 from unittest.mock import AsyncMock, patch
 
+import pytest
+
 import kaleido
 
 # Pretty complicated for basically testing a bunch of wrappers, but it works.
 # Integration tests seem more important.
+# I much prefer the public_api file, this set of tests can be considered
+# for deletion.
+
+
+@pytest.fixture
+def args():
+    """Basic args for sync wrapper tests."""
+    return ({"data": []}, "test.png")
+
+
+@pytest.fixture
+def kwargs():
+    """Basic kwargs for sync wrapper tests."""
+    return {"width": 800}
 
 
 @patch("kaleido._sync_server.GlobalKaleidoServer.open")
-def test_start_sync_server_passes_args(mock_open):
+def test_start_sync_server_passes_args(mock_open, args, kwargs):
     """Test that start_sync_server passes args and silence_warnings correctly."""
     # Test with silence_warnings=False (default)
-    args = ("arg1", "arg2")
-    kwargs = {"key1": "value1", "key2": "value2"}
-
     kaleido.start_sync_server(*args, **kwargs)
     mock_open.assert_called_with(*args, silence_warnings=False, **kwargs)
 
     # Reset mock and test with silence_warnings=True
     mock_open.reset_mock()
-    args = ("arg1",)
-    kwargs = {"key1": "value1"}
-
     kaleido.start_sync_server(*args, silence_warnings=True, **kwargs)
     mock_open.assert_called_with(*args, silence_warnings=True, **kwargs)
 
@@ -42,7 +52,11 @@ def test_stop_sync_server_passes_args(mock_close):
 
 @patch("kaleido.Kaleido")
 async def test_async_wrapper_functions(mock_kaleido_class):
-    """Test all async wrapper functions pass arguments correctly."""
+    """Test all async wrapper functions pass arguments correctly.
+
+    Note: This test uses fixed args rather than fixtures due to specific
+    requirements with topojson and kopts that don't match the simple fixture pattern.
+    """
     # Create a mock that doesn't need the context fixture
     mock_kaleido_class.return_value = mock_kaleido = AsyncMock()
     mock_kaleido.__aenter__.return_value = mock_kaleido
@@ -108,3 +122,53 @@ async def test_async_wrapper_functions(mock_kaleido_class):
     await kaleido.write_fig_from_object(generator, kopts=kopts)
     mock_kaleido_class.assert_called_with(**kopts)
     mock_kaleido.write_fig_from_object.assert_called_with(generator)
+
+
+@patch("kaleido._sync_server.GlobalKaleidoServer.is_running")
+@patch("kaleido._sync_server.GlobalKaleidoServer.call_function")
+def test_sync_wrapper_server(mock_call_function, mock_is_running, args, kwargs):
+    """Test all sync wrapper functions when global server is running."""
+    mock_is_running.return_value = True
+
+    # Test calc_fig_sync
+    kaleido.calc_fig_sync(*args, **kwargs)
+    mock_call_function.assert_called_with("calc_fig", *args, **kwargs)
+
+    mock_call_function.reset_mock()
+
+    # Test write_fig_sync
+    kaleido.write_fig_sync(*args, **kwargs)
+    mock_call_function.assert_called_with("write_fig", *args, **kwargs)
+
+    mock_call_function.reset_mock()
+
+    # Test write_fig_from_object_sync
+    kaleido.write_fig_from_object_sync(*args, **kwargs)
+    mock_call_function.assert_called_with("write_fig_from_object", *args, **kwargs)
+
+
+@patch("kaleido._sync_server.GlobalKaleidoServer.is_running")
+@patch("kaleido._sync_server.oneshot_async_run")
+def test_sync_wrapper_oneshot(mock_oneshot_run, mock_is_running, args, kwargs):
+    """Test all sync wrapper functions when no server is running."""
+    mock_is_running.return_value = False
+
+    # Test calc_fig_sync
+    kaleido.calc_fig_sync(*args, **kwargs)
+    mock_oneshot_run.assert_called_with(kaleido.calc_fig, args=args, kwargs=kwargs)
+
+    mock_oneshot_run.reset_mock()
+
+    # Test write_fig_sync
+    kaleido.write_fig_sync(*args, **kwargs)
+    mock_oneshot_run.assert_called_with(kaleido.write_fig, args=args, kwargs=kwargs)
+
+    mock_oneshot_run.reset_mock()
+
+    # Test write_fig_from_object_sync
+    kaleido.write_fig_from_object_sync(*args, **kwargs)
+    mock_oneshot_run.assert_called_with(
+        kaleido.write_fig_from_object,
+        args=args,
+        kwargs=kwargs,
+    )

From 824230c3552e7ccd50c87e88a700e95c9aabd59a Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Mon, 25 Aug 2025 15:20:07 -0500
Subject: [PATCH 022/167] Remove regex for html parsing.

---
 src/py/tests/test_page_generator.py | 220 ++++++++++++----------------
 1 file changed, 96 insertions(+), 124 deletions(-)

diff --git a/src/py/tests/test_page_generator.py b/src/py/tests/test_page_generator.py
index ad72bf52..7f353db5 100644
--- a/src/py/tests/test_page_generator.py
+++ b/src/py/tests/test_page_generator.py
@@ -1,5 +1,5 @@
-import re
 import sys
+from html.parser import HTMLParser
 from importlib.util import find_spec
 
 import logistro
@@ -13,130 +13,79 @@
 
 _logger = logistro.getLogger(__name__)
 
-_re_default_mathjax = re.escape(DEFAULT_MATHJAX)
-_re_default_plotly = re.escape(DEFAULT_PLOTLY)
 
-no_imports_result_raw = (
-    r'''
-<!DOCTYPE html>
+# Expected boilerplate HTML (without script tags with src)
+EXPECTED_BOILERPLATE = """<!DOCTYPE html>
 <html>
     <head>
         <style id="head-style"></style>
         <title>Kaleido-fier</title>
         <script>
-          window\.PlotlyConfig = {MathJaxConfig: 'local'}
+          window.PlotlyConfig = {MathJaxConfig: 'local'}
         </script>
         <script type="text/x-mathjax-config">
-          MathJax\.Hub\.Config\({ "SVG": { blacker: 0 }}\)
+          MathJax.Hub.Config({ "SVG": { blacker: 0 }})
         </script>
 
-        <script src="'''
-    + _re_default_mathjax
-    + r'''"></script>
-        <script src="'''
-    + _re_default_plotly
-    + r"""" charset="utf\-8"></script>
-        <script src="\S[^\n]*/kaleido_scopes\.js"></script>
-    </head>
-    <body style="{margin: 0; padding: 0;}"><img id="kaleido\-image" /></body>
-</html>
-"""
-)
-no_imports_result_re = re.compile(no_imports_result_raw)
-
-all_defaults_re = re.compile(
-    r'''
-<!DOCTYPE html>
-<html>
-    <head>
-        <style id="head-style"></style>
-        <title>Kaleido-fier</title>
-        <script>
-          window\.PlotlyConfig = {MathJaxConfig: 'local'}
-        </script>
-        <script type="text/x-mathjax-config">
-          MathJax\.Hub\.Config\({ "SVG": { blacker: 0 }}\)
-        </script>
-
-        <script src="'''
-    + _re_default_mathjax
-    + r""""></script>
-        <script src="\S[^\n]*/package_data/plotly\.min\.js" charset="utf-8"></script>
-        <script src="\S[^\n]*/kaleido_scopes\.js"></script>
     </head>
     <body style="{margin: 0; padding: 0;}"><img id="kaleido-image" /></body>
-</html>
-""",
-)
+</html>"""
 
-with_plot_result_re = re.compile(
-    r'''
-<!DOCTYPE html>
-<html>
-    <head>
-        <style id="head-style"></style>
-        <title>Kaleido-fier</title>
-        <script>
-          window\.PlotlyConfig = {MathJaxConfig: 'local'}
-        </script>
-        <script type="text/x-mathjax-config">
-          MathJax\.Hub\.Config\({ "SVG": { blacker: 0 }}\)
-        </script>
 
-        <script src="'''
-    + _re_default_mathjax
-    + r""""></script>
-        <script src="https://with_plot" charset="utf-8"></script>
-        <script src="\S[^\n]*/kaleido_scopes\.js"></script>
-    </head>
-    <body style="{margin: 0; padding: 0;}"><img id="kaleido-image" /></body>
-</html>
-""",
-)
+# Claude, please review this for obvious errors.
+class HTMLAnalyzer(HTMLParser):
+    """Extract script tags with src attributes and return HTML without them."""
 
-without_math_result_re = re.compile(r"""
-<!DOCTYPE html>
-<html>
-    <head>
-        <style id="head-style"></style>
-        <title>Kaleido-fier</title>
-        <script>
-          window\.PlotlyConfig = {MathJaxConfig: 'local'}
-        </script>
-        <script type="text/x-mathjax-config">
-          MathJax\.Hub\.Config\({ "SVG": { blacker: 0 }}\)
-        </script>
+    def __init__(self):
+        super().__init__()
+        self.scripts = []
+        self.boilerplate = []
+        self._in_script = False
 
-        <script src="https://with_plot" charset="utf-8"></script>
-        <script src="\S[^\n]*/kaleido_scopes\.js"></script>
-    </head>
-    <body style="{margin: 0; padding: 0;}"><img id="kaleido-image" /></body>
-</html>
-""")
+    def handle_starttag(self, tag, attrs):
+        if tag == "script" and "src" in (attr_dict := dict(attrs)):
+            self._in_script = True
+            self.scripts.append(attr_dict["src"])
+            return
+        self.boilerplate.append(self.get_starttag_text())
 
-with_others_result_raw = r"""
-<!DOCTYPE html>
-<html>
-    <head>
-        <style id="head-style"></style>
-        <title>Kaleido-fier</title>
-        <script>
-          window\.PlotlyConfig = {MathJaxConfig: 'local'}
-        </script>
-        <script type="text/x-mathjax-config">
-          MathJax\.Hub\.Config\({ "SVG": { blacker: 0 }}\)
-        </script>
+    def handle_endtag(self, tag):
+        if self._in_script and tag == "script":
+            self._in_script = False
+            return
+        self.boilerplate.append(self.get_endtag_text())
 
-        <script src="https://with_mathjax"></script>
-        <script src="https://with_plot" charset="utf-8"></script>
-        <script src="https://1"></script>
-        <script src="https://2"></script>
-        <script src="\S[^\n]*/kaleido_scopes\.js"></script>
-    </head>
-    <body style="{margin: 0; padding: 0;}"><img id="kaleido-image" /></body>
-</html>
-"""
-with_others_result_re = re.compile(with_others_result_raw)
+    def handle_data(self, data):
+        if not self._in_script:
+            self.boilerplate.append(data)
+
+
+# Create boilerplate reference by parsing expected HTML
+_reference_analyzer = HTMLAnalyzer()
+_reference_analyzer.feed(EXPECTED_BOILERPLATE)
+_REFERENCE_BOILERPLATE = "\n".join(_reference_analyzer.boilerplate)
+
+
+def get_scripts_from_html(generated_html):
+    """
+    Parse generated HTML, assert boilerplate matches reference, and return script URLs.
+
+    Returns:
+        list: script src URLs found in generated HTML
+    """
+    analyzer = HTMLAnalyzer()
+    analyzer.feed(generated_html)
+
+    generated_boilerplate = "\n".join(analyzer.boilerplate)
+
+    # Assert boilerplate matches with diff on failure
+    assert generated_boilerplate == _REFERENCE_BOILERPLATE, (
+        f"Boilerplate mismatch:\n"
+        f"Expected:\n{_REFERENCE_BOILERPLATE}\n\n"
+        f"Got:\n{generated_boilerplate}"
+    )
+
+    return analyzer.scripts
 
 
 @pytest.mark.order(1)
@@ -155,37 +104,60 @@ async def test_page_generator():
             "or if you really need to, run it separately and then skip it "
             "in the main group.",
         )
+
+    # Test no imports (plotly not available)
     no_imports = PageGenerator().generate_index()
-    assert no_imports_result_re.findall(no_imports), (
-        f"{len(no_imports_result_raw)}: {no_imports_result_raw}"
-        "\n"
-        f"{len(no_imports)}: {no_imports}"
-    )
+    scripts = get_scripts_from_html(no_imports)
+
+    # Should have mathjax, plotly default, and kaleido_scopes
+    assert len(scripts) == 3  # noqa: PLR2004
+    assert scripts[0] == DEFAULT_MATHJAX
+    assert scripts[1] == DEFAULT_PLOTLY
+    assert scripts[2].endswith("kaleido_scopes.js")
+
     sys.path = old_path
 
-    # this imports plotly so above test must have already been done
+    # Test all defaults (plotly available)
     all_defaults = PageGenerator().generate_index()
-    assert all_defaults_re.findall(all_defaults)
+    scripts = get_scripts_from_html(all_defaults)
+
+    # Should have mathjax, plotly package data, and kaleido_scopes
+    assert len(scripts) == 3  # noqa: PLR2004
+    assert scripts[0] == DEFAULT_MATHJAX
+    assert scripts[1].endswith("package_data/plotly.min.js")
+    assert scripts[2].endswith("kaleido_scopes.js")
 
+    # Test with custom plotly
     with_plot = PageGenerator(plotly="https://with_plot").generate_index()
-    assert with_plot_result_re.findall(with_plot)
+    scripts = get_scripts_from_html(with_plot)
 
+    assert len(scripts) == 3  # noqa: PLR2004
+    assert scripts[0] == DEFAULT_MATHJAX
+    assert scripts[1] == "https://with_plot"
+    assert scripts[2].endswith("kaleido_scopes.js")
+
+    # Test without mathjax
     without_math = PageGenerator(
         plotly="https://with_plot",
         mathjax=False,
     ).generate_index()
-    assert without_math_result_re.findall(without_math)
+    scripts = get_scripts_from_html(without_math)
+
+    assert len(scripts) == 2  # noqa: PLR2004
+    assert scripts[0] == "https://with_plot"
+    assert scripts[1].endswith("kaleido_scopes.js")
 
+    # Test with custom mathjax and others
     with_others = PageGenerator(
         plotly="https://with_plot",
         mathjax="https://with_mathjax",
         others=["https://1", "https://2"],
     ).generate_index()
-    assert with_others_result_re.findall(with_others), (
-        f"{len(with_others_result_raw)}: {with_others_result_raw}"
-        "\n"
-        f"{len(with_others)}: {with_others}"
-    )
-
-
-# test others
+    scripts = get_scripts_from_html(with_others)
+
+    assert len(scripts) == 5  # noqa: PLR2004
+    assert scripts[0] == "https://with_mathjax"
+    assert scripts[1] == "https://with_plot"
+    assert scripts[2] == "https://1"
+    assert scripts[3] == "https://2"
+    assert scripts[4].endswith("kaleido_scopes.js")

From d152afa7211975bbaa5f29d37397b946c0f06904 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Mon, 25 Aug 2025 16:49:54 -0500
Subject: [PATCH 023/167] Fix non-existent function

---
 src/py/tests/test_page_generator.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/py/tests/test_page_generator.py b/src/py/tests/test_page_generator.py
index 7f353db5..1f14a6b3 100644
--- a/src/py/tests/test_page_generator.py
+++ b/src/py/tests/test_page_generator.py
@@ -53,7 +53,7 @@ def handle_endtag(self, tag):
         if self._in_script and tag == "script":
             self._in_script = False
             return
-        self.boilerplate.append(self.get_endtag_text())
+        self.boilerplate.append(f"</{tag}>")
 
     def handle_data(self, data):
         if not self._in_script:

From ec6290861bd237557e76a7a87557878d0aaab527 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Mon, 25 Aug 2025 17:00:55 -0500
Subject: [PATCH 024/167] Fix whitespace errors.

---
 src/py/tests/test_page_generator.py | 14 ++++++++++++--
 1 file changed, 12 insertions(+), 2 deletions(-)

diff --git a/src/py/tests/test_page_generator.py b/src/py/tests/test_page_generator.py
index 1f14a6b3..bc9f79d0 100644
--- a/src/py/tests/test_page_generator.py
+++ b/src/py/tests/test_page_generator.py
@@ -1,3 +1,4 @@
+import re
 import sys
 from html.parser import HTMLParser
 from importlib.util import find_spec
@@ -60,10 +61,19 @@ def handle_data(self, data):
             self.boilerplate.append(data)
 
 
+def normalize_whitespace(html):
+    """Normalize whitespace by collapsing multiple newlines and extra spaces."""
+    # Collapse multiple newlines to single newlines
+    html = re.sub(r"\n\s*\n", "\n", html)
+    # Remove extra whitespace between tags
+    html = re.sub(r">\s*<", "><", html)
+    return html.strip()
+
+
 # Create boilerplate reference by parsing expected HTML
 _reference_analyzer = HTMLAnalyzer()
 _reference_analyzer.feed(EXPECTED_BOILERPLATE)
-_REFERENCE_BOILERPLATE = "\n".join(_reference_analyzer.boilerplate)
+_REFERENCE_BOILERPLATE = normalize_whitespace("".join(_reference_analyzer.boilerplate))
 
 
 def get_scripts_from_html(generated_html):
@@ -76,7 +86,7 @@ def get_scripts_from_html(generated_html):
     analyzer = HTMLAnalyzer()
     analyzer.feed(generated_html)
 
-    generated_boilerplate = "\n".join(analyzer.boilerplate)
+    generated_boilerplate = normalize_whitespace("".join(analyzer.boilerplate))
 
     # Assert boilerplate matches with diff on failure
     assert generated_boilerplate == _REFERENCE_BOILERPLATE, (

From 930f3385ae549913f09dc7e6ee898378fc1ccd50 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Mon, 25 Aug 2025 17:09:56 -0500
Subject: [PATCH 025/167] Add types for page_generaetor.

---
 src/py/kaleido/_page_generator.py | 11 +++++++++--
 1 file changed, 9 insertions(+), 2 deletions(-)

diff --git a/src/py/kaleido/_page_generator.py b/src/py/kaleido/_page_generator.py
index fe5ad505..65f1f98d 100644
--- a/src/py/kaleido/_page_generator.py
+++ b/src/py/kaleido/_page_generator.py
@@ -16,7 +16,7 @@
 KJS_PATH = Path(__file__).resolve().parent / "vendor" / "kaleido_scopes.js"
 
 
-def _ensure_path(path: Path | str):
+def _ensure_path(path: Path | str) -> None:
     _logger.debug(f"Ensuring path {path!s}")
     if urlparse(str(path)).scheme.startswith("http"):  # is url
         return
@@ -54,7 +54,14 @@ class PageGenerator:
 """
     """The footer is the HTML that always goes on the bottom. Rarely needs changing."""
 
-    def __init__(self, *, plotly=None, mathjax=None, others=None, force_cdn=False):
+    def __init__(
+        self,
+        *,
+        plotly: None | Path | str | tuple[Path | str, str] = None,
+        mathjax: None | Path | str | bool | tuple[Path | str, str] = None,
+        others: None | list[Path | str | tuple[Path | str, str]] = None,
+        force_cdn: bool = False,
+    ):
         """
         Create a PageGenerator.
 

From f9175fb21f4d51a1afd893de225d28826ca1954f Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Mon, 25 Aug 2025 18:18:29 -0500
Subject: [PATCH 026/167] Add hypothesis tests generated by Claude.

---
 src/py/tests/test_page_generator.py | 330 +++++++++++++++++++++++++---
 1 file changed, 303 insertions(+), 27 deletions(-)

diff --git a/src/py/tests/test_page_generator.py b/src/py/tests/test_page_generator.py
index bc9f79d0..b3e3a588 100644
--- a/src/py/tests/test_page_generator.py
+++ b/src/py/tests/test_page_generator.py
@@ -1,10 +1,14 @@
 import re
 import sys
+import tempfile
 from html.parser import HTMLParser
 from importlib.util import find_spec
+from pathlib import Path
 
 import logistro
 import pytest
+from hypothesis import given
+from hypothesis import strategies as st
 
 from kaleido import PageGenerator
 from kaleido._page_generator import DEFAULT_MATHJAX, DEFAULT_PLOTLY
@@ -33,7 +37,6 @@
 </html>"""
 
 
-# Claude, please review this for obvious errors.
 class HTMLAnalyzer(HTMLParser):
     """Extract script tags with src attributes and return HTML without them."""
 
@@ -98,12 +101,77 @@ def get_scripts_from_html(generated_html):
     return analyzer.scripts
 
 
+# Fixtures for user supplied input scenarios
+@pytest.fixture
+def temp_js_file():
+    """Create a temporary JavaScript file that exists."""
+    with tempfile.NamedTemporaryFile(mode="w", suffix=".js", delete=False) as f:
+        f.write("console.log('test');")
+        temp_path = Path(f.name)
+    yield temp_path
+    temp_path.unlink()
+
+
+@pytest.fixture
+def existing_file_path():
+    """Return path to current test file (guaranteed to exist)."""
+    return Path(__file__)
+
+
+@pytest.fixture
+def nonexistent_file_path():
+    """Return path to file that doesn't exist."""
+    return Path("/nonexistent/path/file.js")
+
+
+@pytest.fixture
+def user_input_scenarios():
+    """Fixture for user supplied input scenarios using hypothesis strategies."""
+
+    # Generate sample data using hypothesis strategies
+    http_urls = st.text(
+        min_size=1,
+        max_size=20,
+        alphabet=st.characters(whitelist_categories=("Lu", "Ll", "And")),
+    ).map(lambda x: f"https://example.com/{x}.js")
+
+    return {
+        "custom_plotly_url": http_urls.example(),
+        "custom_mathjax_url": http_urls.example(),
+        "other_scripts": [
+            http_urls.example(),
+            http_urls.example(),
+        ],
+        "plotly_with_encoding": (http_urls.example(), "utf-8"),
+        "mathjax_with_encoding": (http_urls.example(), "utf-16"),
+    }
+
+
+@pytest.fixture
+def hypothesis_urls():
+    """Generate hypothesis-based URL strategies."""
+    return st.text(min_size=1, max_size=20).map(lambda x: f"https://example.com/{x}.js")
+
+
+@pytest.fixture
+def hypothesis_encodings():
+    """Generate hypothesis-based encoding strategies."""
+    return st.sampled_from(["utf-8", "utf-16", "ascii", "latin1"])
+
+
+@pytest.fixture
+def hypothesis_tuples(hypothesis_urls, hypothesis_encodings):
+    """Generate hypothesis-based (url, encoding) tuples."""
+    return st.tuples(hypothesis_urls, hypothesis_encodings)
+
+
+# Test default combinations
 @pytest.mark.order(1)
-async def test_page_generator():
+async def test_defaults_no_plotly_available():
+    """Test defaults when plotly package is not available."""
     if not find_spec("plotly"):
-        raise ImportError(
-            "Tests must be run with plotly installed to function",
-        )
+        raise ImportError("Tests must be run with plotly installed to function")
+
     old_path = sys.path
     sys.path = sys.path[:1]
     if find_spec("plotly"):
@@ -127,7 +195,9 @@ async def test_page_generator():
 
     sys.path = old_path
 
-    # Test all defaults (plotly available)
+
+async def test_defaults_with_plotly_available():
+    """Test defaults when plotly package is available."""
     all_defaults = PageGenerator().generate_index()
     scripts = get_scripts_from_html(all_defaults)
 
@@ -137,37 +207,243 @@ async def test_page_generator():
     assert scripts[1].endswith("package_data/plotly.min.js")
     assert scripts[2].endswith("kaleido_scopes.js")
 
-    # Test with custom plotly
-    with_plot = PageGenerator(plotly="https://with_plot").generate_index()
-    scripts = get_scripts_from_html(with_plot)
+
+async def test_force_cdn():
+    """Test force_cdn=True forces use of CDN plotly even when plotly is available."""
+    # Verify plotly is available first
+    if not find_spec("plotly"):
+        pytest.skip("Plotly not available - cannot test force_cdn override")
+
+    forced_cdn = PageGenerator(force_cdn=True).generate_index()
+    scripts = get_scripts_from_html(forced_cdn)
 
     assert len(scripts) == 3  # noqa: PLR2004
     assert scripts[0] == DEFAULT_MATHJAX
-    assert scripts[1] == "https://with_plot"
+    assert scripts[1] == DEFAULT_PLOTLY
     assert scripts[2].endswith("kaleido_scopes.js")
 
-    # Test without mathjax
-    without_math = PageGenerator(
-        plotly="https://with_plot",
-        mathjax=False,
-    ).generate_index()
-    scripts = get_scripts_from_html(without_math)
+
+# Test boolean mathjax functionality
+async def test_mathjax_false():
+    """Test that mathjax=False disables mathjax."""
+    without_mathjax = PageGenerator(mathjax=False).generate_index()
+    scripts = get_scripts_from_html(without_mathjax)
 
     assert len(scripts) == 2  # noqa: PLR2004
-    assert scripts[0] == "https://with_plot"
+    assert scripts[0].endswith("package_data/plotly.min.js")
     assert scripts[1].endswith("kaleido_scopes.js")
 
-    # Test with custom mathjax and others
-    with_others = PageGenerator(
-        plotly="https://with_plot",
-        mathjax="https://with_mathjax",
-        others=["https://1", "https://2"],
-    ).generate_index()
+
+# Test user overrides
+async def test_custom_plotly_url(user_input_scenarios):
+    """Test custom plotly URL override."""
+    custom_plotly = user_input_scenarios["custom_plotly_url"]
+    with_custom = PageGenerator(plotly=custom_plotly).generate_index()
+    scripts = get_scripts_from_html(with_custom)
+
+    assert len(scripts) == 3  # noqa: PLR2004
+    assert scripts[0] == DEFAULT_MATHJAX
+    assert scripts[1] == custom_plotly
+    assert scripts[2].endswith("kaleido_scopes.js")
+
+
+async def test_custom_mathjax_url(user_input_scenarios):
+    """Test custom mathjax URL override."""
+    custom_mathjax = user_input_scenarios["custom_mathjax_url"]
+    with_custom = PageGenerator(mathjax=custom_mathjax).generate_index()
+    scripts = get_scripts_from_html(with_custom)
+
+    assert len(scripts) == 3  # noqa: PLR2004
+    assert scripts[0] == custom_mathjax
+    assert scripts[1].endswith("package_data/plotly.min.js")
+    assert scripts[2].endswith("kaleido_scopes.js")
+
+
+async def test_other_scripts(user_input_scenarios):
+    """Test adding other scripts."""
+    other_scripts = user_input_scenarios["other_scripts"]
+    with_others = PageGenerator(others=other_scripts).generate_index()
     scripts = get_scripts_from_html(with_others)
 
     assert len(scripts) == 5  # noqa: PLR2004
-    assert scripts[0] == "https://with_mathjax"
-    assert scripts[1] == "https://with_plot"
-    assert scripts[2] == "https://1"
-    assert scripts[3] == "https://2"
+    assert scripts[0] == DEFAULT_MATHJAX
+    assert scripts[1].endswith("package_data/plotly.min.js")
+    assert scripts[2] == other_scripts[0]
+    assert scripts[3] == other_scripts[1]
+    assert scripts[4].endswith("kaleido_scopes.js")
+
+
+async def test_combined_overrides(user_input_scenarios):
+    """Test combination of multiple overrides."""
+    custom_plotly = user_input_scenarios["custom_plotly_url"]
+    custom_mathjax = user_input_scenarios["custom_mathjax_url"]
+    other_scripts = user_input_scenarios["other_scripts"]
+
+    combined = PageGenerator(
+        plotly=custom_plotly,
+        mathjax=custom_mathjax,
+        others=other_scripts,
+    ).generate_index()
+    scripts = get_scripts_from_html(combined)
+
+    assert len(scripts) == 5  # noqa: PLR2004
+    assert scripts[0] == custom_mathjax
+    assert scripts[1] == custom_plotly
+    assert scripts[2] == other_scripts[0]
+    assert scripts[3] == other_scripts[1]
     assert scripts[4].endswith("kaleido_scopes.js")
+
+
+# Test file path validation
+async def test_existing_file_path(temp_js_file):
+    """Test that existing file paths work with and without file:/// protocol."""
+    # Test with regular path
+    generator = PageGenerator(plotly=str(temp_js_file))
+    html = generator.generate_index()
+    scripts = get_scripts_from_html(html)
+    assert len(scripts) == 3  # noqa: PLR2004
+    assert scripts[0] == DEFAULT_MATHJAX
+    assert scripts[1] == str(temp_js_file)
+    assert scripts[2].endswith("kaleido_scopes.js")
+
+    # Test with file:/// protocol
+    generator_uri = PageGenerator(plotly=temp_js_file.as_uri())
+    html_uri = generator_uri.generate_index()
+    scripts_uri = get_scripts_from_html(html_uri)
+    assert len(scripts_uri) == 3  # noqa: PLR2004
+    assert scripts_uri[0] == DEFAULT_MATHJAX
+    assert scripts_uri[1] == temp_js_file.as_uri()
+    assert scripts_uri[2].endswith("kaleido_scopes.js")
+
+
+async def test_nonexistent_file_path_raises_error(nonexistent_file_path):
+    """Test that nonexistent file paths raise FileNotFoundError."""
+    # Test with regular path
+    with pytest.raises(FileNotFoundError):
+        PageGenerator(plotly=str(nonexistent_file_path))
+
+    # Test with file:/// protocol
+    with pytest.raises(FileNotFoundError):
+        PageGenerator(plotly=nonexistent_file_path.as_uri())
+
+
+async def test_mathjax_nonexistent_file_raises_error(nonexistent_file_path):
+    """Test that nonexistent mathjax file raises FileNotFoundError."""
+    # Test with regular path
+    with pytest.raises(FileNotFoundError):
+        PageGenerator(mathjax=str(nonexistent_file_path))
+
+    # Test with file:/// protocol
+    with pytest.raises(FileNotFoundError):
+        PageGenerator(mathjax=nonexistent_file_path.as_uri())
+
+
+async def test_others_nonexistent_file_raises_error(nonexistent_file_path):
+    """Test that nonexistent file in others list raises FileNotFoundError."""
+    # Test with regular path
+    with pytest.raises(FileNotFoundError):
+        PageGenerator(others=[str(nonexistent_file_path)])
+
+    # Test with file:/// protocol
+    with pytest.raises(FileNotFoundError):
+        PageGenerator(others=[nonexistent_file_path.as_uri()])
+
+
+# Test HTTP URLs (should not raise FileNotFoundError)
+async def test_http_urls_skip_file_validation():
+    """Test that HTTP URLs skip file existence validation."""
+    # These should not raise FileNotFoundError even if URLs don't exist
+    generator = PageGenerator(
+        plotly="https://nonexistent.example.com/plotly.js",
+        mathjax="https://nonexistent.example.com/mathjax.js",
+        others=["https://nonexistent.example.com/other.js"],
+    )
+    html = generator.generate_index()
+    scripts = get_scripts_from_html(html)
+
+    assert len(scripts) == 4  # noqa: PLR2004
+    assert scripts[0] == "https://nonexistent.example.com/mathjax.js"
+    assert scripts[1] == "https://nonexistent.example.com/plotly.js"
+    assert scripts[2] == "https://nonexistent.example.com/other.js"
+    assert scripts[3].endswith("kaleido_scopes.js")
+
+
+# Test tuple (path, encoding) functionality
+async def test_plotly_with_encoding_tuple(user_input_scenarios):
+    """Test plotly parameter with (url, encoding) tuple."""
+    plotly_tuple = user_input_scenarios["plotly_with_encoding"]
+    generator = PageGenerator(plotly=plotly_tuple)
+    html = generator.generate_index()
+    scripts = get_scripts_from_html(html)
+
+    assert len(scripts) == 3  # noqa: PLR2004
+    assert scripts[0] == DEFAULT_MATHJAX
+    assert scripts[1] == plotly_tuple[0]  # Should be the URL from tuple
+    assert scripts[2].endswith("kaleido_scopes.js")
+
+
+async def test_mathjax_with_encoding_tuple(user_input_scenarios):
+    """Test mathjax parameter with (url, encoding) tuple."""
+    mathjax_tuple = user_input_scenarios["mathjax_with_encoding"]
+    generator = PageGenerator(mathjax=mathjax_tuple)
+    html = generator.generate_index()
+    scripts = get_scripts_from_html(html)
+
+    assert len(scripts) == 3  # noqa: PLR2004
+    assert scripts[0] == mathjax_tuple[0]  # Should be the URL from tuple
+    assert scripts[1].endswith("package_data/plotly.min.js")
+    assert scripts[2].endswith("kaleido_scopes.js")
+
+
+async def test_others_tuple_error(user_input_scenarios):
+    """Test that others parameter with tuples currently fails (documents bug)."""
+    # Create a tuple for others list
+    url_encoding_tuple = user_input_scenarios["plotly_with_encoding"]
+
+    # This should fail until the others parameter properly handles tuples
+    with pytest.raises((TypeError, AttributeError, ValueError)):
+        PageGenerator(others=[url_encoding_tuple])
+
+
+@given(st.text(min_size=1, max_size=10).map(lambda x: f"https://example.com/{x}.js"))
+async def test_plotly_urls_hypothesis(url):
+    """Test plotly with hypothesis-generated URLs."""
+    generator = PageGenerator(plotly=url)
+    html = generator.generate_index()
+    scripts = get_scripts_from_html(html)
+
+    assert len(scripts) == 3  # noqa: PLR2004
+    assert scripts[0] == DEFAULT_MATHJAX
+    assert scripts[1] == url
+    assert scripts[2].endswith("kaleido_scopes.js")
+
+
+@given(
+    st.tuples(
+        st.text(min_size=1, max_size=10).map(lambda x: f"https://example.com/{x}.js"),
+        st.sampled_from(["utf-8", "utf-16", "ascii"]),
+    ),
+)
+async def test_encoding_tuples_hypothesis(url_encoding_tuple):
+    """Test encoding tuples with hypothesis-generated data."""
+    url, encoding = url_encoding_tuple
+
+    # Test with plotly
+    generator = PageGenerator(plotly=(url, encoding))
+    html = generator.generate_index()
+    scripts = get_scripts_from_html(html)
+
+    assert len(scripts) == 3  # noqa: PLR2004
+    assert scripts[0] == DEFAULT_MATHJAX
+    assert scripts[1] == url
+    assert scripts[2].endswith("kaleido_scopes.js")
+
+    # Test with mathjax
+    generator2 = PageGenerator(mathjax=(url, encoding))
+    html2 = generator2.generate_index()
+    scripts2 = get_scripts_from_html(html2)
+
+    assert len(scripts2) == 3  # noqa: PLR2004
+    assert scripts2[0] == url
+    assert scripts2[1].endswith("package_data/plotly.min.js")
+    assert scripts2[2].endswith("kaleido_scopes.js")

From 2b20a3eba41043896f46225749bde5c5cb074057 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Mon, 25 Aug 2025 19:28:23 -0500
Subject: [PATCH 027/167] Fix file path ensuring error.

---
 src/py/kaleido/_page_generator.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/py/kaleido/_page_generator.py b/src/py/kaleido/_page_generator.py
index 65f1f98d..846a6f0f 100644
--- a/src/py/kaleido/_page_generator.py
+++ b/src/py/kaleido/_page_generator.py
@@ -20,7 +20,7 @@ def _ensure_path(path: Path | str) -> None:
     _logger.debug(f"Ensuring path {path!s}")
     if urlparse(str(path)).scheme.startswith("http"):  # is url
         return
-    if not Path(path).exists():
+    if not Path(urlparse(str(path)).path).exists():
         raise FileNotFoundError(f"{path!s} does not exist.")
 
 

From a71a2025e5a6bf324cf4d9c486d4fd121a123bd2 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Mon, 25 Aug 2025 19:28:33 -0500
Subject: [PATCH 028/167] Add hypothesis.

---
 src/py/pyproject.toml |  1 +
 src/py/uv.lock        | 58 +++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 59 insertions(+)

diff --git a/src/py/pyproject.toml b/src/py/pyproject.toml
index 1cca5695..080be93f 100644
--- a/src/py/pyproject.toml
+++ b/src/py/pyproject.toml
@@ -52,6 +52,7 @@ dev = [
   "pytest-order>=1.3.0",
   "pandas>=2.0.3",
   "typing-extensions>=4.12.2",
+  "hypothesis>=6.113.0",
 ]
 
 [tool.ruff.lint]
diff --git a/src/py/uv.lock b/src/py/uv.lock
index 7206f1a3..9bc4dbda 100644
--- a/src/py/uv.lock
+++ b/src/py/uv.lock
@@ -18,6 +18,15 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/fe/ba/e2081de779ca30d473f21f5b30e0e737c438205440784c7dfc81efc2b029/async_timeout-5.0.1-py3-none-any.whl", hash = "sha256:39e3809566ff85354557ec2398b55e096c8364bacac9405a7a1fa429e77fe76c", size = 6233, upload-time = "2024-11-06T16:41:37.9Z" },
 ]
 
+[[package]]
+name = "attrs"
+version = "25.3.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/5a/b0/1367933a8532ee6ff8d63537de4f1177af4bff9f3e829baf7331f595bb24/attrs-25.3.0.tar.gz", hash = "sha256:75d7cefc7fb576747b2c81b4442d4d4a1ce0900973527c011d1030fd3bf4af1b", size = 812032, upload-time = "2025-03-13T11:10:22.779Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/77/06/bb80f5f86020c4551da315d78b3ab75e8228f89f0162f2c3a819e407941a/attrs-25.3.0-py3-none-any.whl", hash = "sha256:427318ce031701fea540783410126f03899a97ffc6f61596ad581ac2e40e3bc3", size = 63815, upload-time = "2025-03-13T11:10:21.14Z" },
+]
+
 [[package]]
 name = "backports-asyncio-runner"
 version = "1.2.0"
@@ -71,6 +80,43 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/43/09/2aea36ff60d16dd8879bdb2f5b3ee0ba8d08cbbdcdfe870e695ce3784385/execnet-2.1.1-py3-none-any.whl", hash = "sha256:26dee51f1b80cebd6d0ca8e74dd8745419761d3bef34163928cbebbdc4749fdc", size = 40612, upload-time = "2024-04-08T09:04:17.414Z" },
 ]
 
+[[package]]
+name = "hypothesis"
+version = "6.113.0"
+source = { registry = "https://pypi.org/simple" }
+resolution-markers = [
+    "python_full_version < '3.9'",
+]
+dependencies = [
+    { name = "attrs", marker = "python_full_version < '3.9'" },
+    { name = "exceptiongroup", marker = "python_full_version < '3.9'" },
+    { name = "sortedcontainers", marker = "python_full_version < '3.9'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/28/32/6513cd7256f38c19a6c8a1d5ce9792bcd35c7f11651989994731f0e97672/hypothesis-6.113.0.tar.gz", hash = "sha256:5556ac66fdf72a4ccd5d237810f7cf6bdcd00534a4485015ef881af26e20f7c7", size = 408897, upload-time = "2024-10-09T03:51:05.707Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/14/fa/4acb477b86a94571958bd337eae5baf334d21b8c98a04b594d0dad381ba8/hypothesis-6.113.0-py3-none-any.whl", hash = "sha256:d539180eb2bb71ed28a23dfe94e67c851f9b09f3ccc4125afad43f17e32e2bad", size = 469790, upload-time = "2024-10-09T03:51:02.629Z" },
+]
+
+[[package]]
+name = "hypothesis"
+version = "6.138.3"
+source = { registry = "https://pypi.org/simple" }
+resolution-markers = [
+    "python_full_version >= '3.12'",
+    "python_full_version == '3.11.*'",
+    "python_full_version == '3.10.*'",
+    "python_full_version == '3.9.*'",
+]
+dependencies = [
+    { name = "attrs", marker = "python_full_version >= '3.9'" },
+    { name = "exceptiongroup", marker = "python_full_version >= '3.9' and python_full_version < '3.11'" },
+    { name = "sortedcontainers", marker = "python_full_version >= '3.9'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/19/28/9aa38d1cf2b00d385926fd44318d2b49948c060969ab29e82e8bb654b16c/hypothesis-6.138.3.tar.gz", hash = "sha256:9bffd1382b99e67c46512dac45ec013bae4b39d3d0ef98f0d87535f06d8efc9e", size = 463165, upload-time = "2025-08-24T07:29:16.34Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/20/60/7db4d683d27b24a6dfd8f82ef28332d20b0d99a976ae696569622383c900/hypothesis-6.138.3-py3-none-any.whl", hash = "sha256:19291d3ba478527155c34704b038a21ba86b2f31d36673446f981a67f705b3f4", size = 530081, upload-time = "2025-08-24T07:29:12.862Z" },
+]
+
 [[package]]
 name = "iniconfig"
 version = "2.1.0"
@@ -94,6 +140,8 @@ dependencies = [
 [package.dev-dependencies]
 dev = [
     { name = "async-timeout" },
+    { name = "hypothesis", version = "6.113.0", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.9'" },
+    { name = "hypothesis", version = "6.138.3", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.9'" },
     { name = "mypy", version = "1.14.1", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.9'" },
     { name = "mypy", version = "1.17.1", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.9'" },
     { name = "pandas", version = "2.0.3", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.9'" },
@@ -123,6 +171,7 @@ requires-dist = [
 [package.metadata.requires-dev]
 dev = [
     { name = "async-timeout" },
+    { name = "hypothesis", specifier = ">=6.113.0" },
     { name = "mypy", specifier = ">=1.14.1" },
     { name = "pandas", specifier = ">=2.0.3" },
     { name = "plotly", extras = ["express"], specifier = ">=6.1.1" },
@@ -1247,6 +1296,15 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/b7/ce/149a00dd41f10bc29e5921b496af8b574d8413afcd5e30dfa0ed46c2cc5e/six-1.17.0-py2.py3-none-any.whl", hash = "sha256:4721f391ed90541fddacab5acf947aa0d3dc7d27b2e1e8eda2be8970586c3274", size = 11050, upload-time = "2024-12-04T17:35:26.475Z" },
 ]
 
+[[package]]
+name = "sortedcontainers"
+version = "2.4.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/e8/c4/ba2f8066cceb6f23394729afe52f3bf7adec04bf9ed2c820b39e19299111/sortedcontainers-2.4.0.tar.gz", hash = "sha256:25caa5a06cc30b6b83d11423433f65d1f9d76c4c6a0c90e3379eaa43b9bfdb88", size = 30594, upload-time = "2021-05-16T22:03:42.897Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/32/46/9cb0e58b2deb7f82b84065f37f3bffeb12413f947f9388e4cac22c4621ce/sortedcontainers-2.4.0-py2.py3-none-any.whl", hash = "sha256:a163dcaede0f1c021485e957a39245190e74249897e2ae4b2aa38595db237ee0", size = 29575, upload-time = "2021-05-16T22:03:41.177Z" },
+]
+
 [[package]]
 name = "tomli"
 version = "2.2.1"

From 63332ca631774866347ad795f40e995908348f94 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Mon, 25 Aug 2025 19:59:58 -0500
Subject: [PATCH 029/167] Allow _ensure_path to deal with str/encoding combos

---
 src/py/kaleido/_page_generator.py | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/src/py/kaleido/_page_generator.py b/src/py/kaleido/_page_generator.py
index 846a6f0f..b82e5a8c 100644
--- a/src/py/kaleido/_page_generator.py
+++ b/src/py/kaleido/_page_generator.py
@@ -16,7 +16,9 @@
 KJS_PATH = Path(__file__).resolve().parent / "vendor" / "kaleido_scopes.js"
 
 
-def _ensure_path(path: Path | str) -> None:
+def _ensure_path(path: Path | str | tuple[str | Path, str]) -> None:
+    if isinstance(path, tuple):
+        path = path[0]
     _logger.debug(f"Ensuring path {path!s}")
     if urlparse(str(path)).scheme.startswith("http"):  # is url
         return
@@ -130,8 +132,8 @@ def generate_index(self, path=None):
         script_tag = '\n        <script src="%s"></script>'
         script_tag_charset = '\n        <script src="%s" charset="%s"></script>'
         for script in self._scripts:
-            if isinstance(script, str):
-                page += script_tag % script
+            if isinstance(script, (str, Path)):
+                page += script_tag % str(script)
             else:
                 page += script_tag_charset % script
         page += self.footer

From d495e34004b54a51e37104c4f97748ae726841f6 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Mon, 25 Aug 2025 20:01:42 -0500
Subject: [PATCH 030/167] Tweak manually hypothesis tests in PageGenerator

---
 src/py/tests/test_page_generator.py | 259 ++++++++++++----------------
 1 file changed, 111 insertions(+), 148 deletions(-)

diff --git a/src/py/tests/test_page_generator.py b/src/py/tests/test_page_generator.py
index b3e3a588..308aaead 100644
--- a/src/py/tests/test_page_generator.py
+++ b/src/py/tests/test_page_generator.py
@@ -43,6 +43,7 @@ class HTMLAnalyzer(HTMLParser):
     def __init__(self):
         super().__init__()
         self.scripts = []
+        self.encodings = []
         self.boilerplate = []
         self._in_script = False
 
@@ -50,6 +51,7 @@ def handle_starttag(self, tag, attrs):
         if tag == "script" and "src" in (attr_dict := dict(attrs)):
             self._in_script = True
             self.scripts.append(attr_dict["src"])
+            self.encodings.append(attr_dict.get("charset"))
             return
         self.boilerplate.append(self.get_starttag_text())
 
@@ -98,7 +100,7 @@ def get_scripts_from_html(generated_html):
         f"Got:\n{generated_boilerplate}"
     )
 
-    return analyzer.scripts
+    return analyzer.scripts, analyzer.encodings
 
 
 # Fixtures for user supplied input scenarios
@@ -124,45 +126,34 @@ def nonexistent_file_path():
     return Path("/nonexistent/path/file.js")
 
 
-@pytest.fixture
-def user_input_scenarios():
-    """Fixture for user supplied input scenarios using hypothesis strategies."""
-
-    # Generate sample data using hypothesis strategies
-    http_urls = st.text(
+_h_url = st.tuples(
+    st.sampled_from(["s", ""]),
+    st.text(
         min_size=1,
         max_size=20,
-        alphabet=st.characters(whitelist_categories=("Lu", "Ll", "And")),
-    ).map(lambda x: f"https://example.com/{x}.js")
+        alphabet=st.characters(whitelist_categories=("Lu", "Ll")),
+    ),
+).map(lambda x: f"http{x[0]}://example.com/{x[1]}.js")
 
-    return {
-        "custom_plotly_url": http_urls.example(),
-        "custom_mathjax_url": http_urls.example(),
-        "other_scripts": [
-            http_urls.example(),
-            http_urls.example(),
-        ],
-        "plotly_with_encoding": (http_urls.example(), "utf-8"),
-        "mathjax_with_encoding": (http_urls.example(), "utf-16"),
-    }
+_h_file_str = st.just(__file__)
+_h_file_path = st.just(Path(__file__))
+_h_file_uri = st.just(Path(__file__).as_uri())
 
+_h_uri = st.one_of(_h_url, _h_file_str, _h_file_path, _h_file_uri)
 
-@pytest.fixture
-def hypothesis_urls():
-    """Generate hypothesis-based URL strategies."""
-    return st.text(min_size=1, max_size=20).map(lambda x: f"https://example.com/{x}.js")
+_h_encoding = st.sampled_from(["utf-8", "utf-16", "ascii", "latin1"])
 
+strategy_valid_path = st.one_of(_h_uri, st.tuples(_h_uri, _h_encoding))
 
-@pytest.fixture
-def hypothesis_encodings():
-    """Generate hypothesis-based encoding strategies."""
-    return st.sampled_from(["utf-8", "utf-16", "ascii", "latin1"])
-
+# Variable length list strategy for 'others' parameter
+strategy_others_list = st.lists(strategy_valid_path, min_size=0, max_size=3)
 
-@pytest.fixture
-def hypothesis_tuples(hypothesis_urls, hypothesis_encodings):
-    """Generate hypothesis-based (url, encoding) tuples."""
-    return st.tuples(hypothesis_urls, hypothesis_encodings)
+# Mathjax strategy (includes None, False, True, and path options)
+strategy_mathjax = st.one_of(
+    st.none(),
+    st.just(False),  #  noqa: FBT003
+    strategy_valid_path,
+)
 
 
 # Test default combinations
@@ -185,7 +176,7 @@ async def test_defaults_no_plotly_available():
 
     # Test no imports (plotly not available)
     no_imports = PageGenerator().generate_index()
-    scripts = get_scripts_from_html(no_imports)
+    scripts, encodings = get_scripts_from_html(no_imports)
 
     # Should have mathjax, plotly default, and kaleido_scopes
     assert len(scripts) == 3  # noqa: PLR2004
@@ -199,7 +190,7 @@ async def test_defaults_no_plotly_available():
 async def test_defaults_with_plotly_available():
     """Test defaults when plotly package is available."""
     all_defaults = PageGenerator().generate_index()
-    scripts = get_scripts_from_html(all_defaults)
+    scripts, encodings = get_scripts_from_html(all_defaults)
 
     # Should have mathjax, plotly package data, and kaleido_scopes
     assert len(scripts) == 3  # noqa: PLR2004
@@ -215,7 +206,7 @@ async def test_force_cdn():
         pytest.skip("Plotly not available - cannot test force_cdn override")
 
     forced_cdn = PageGenerator(force_cdn=True).generate_index()
-    scripts = get_scripts_from_html(forced_cdn)
+    scripts, encodings = get_scripts_from_html(forced_cdn)
 
     assert len(scripts) == 3  # noqa: PLR2004
     assert scripts[0] == DEFAULT_MATHJAX
@@ -227,7 +218,7 @@ async def test_force_cdn():
 async def test_mathjax_false():
     """Test that mathjax=False disables mathjax."""
     without_mathjax = PageGenerator(mathjax=False).generate_index()
-    scripts = get_scripts_from_html(without_mathjax)
+    scripts, encodings = get_scripts_from_html(without_mathjax)
 
     assert len(scripts) == 2  # noqa: PLR2004
     assert scripts[0].endswith("package_data/plotly.min.js")
@@ -235,63 +226,116 @@ async def test_mathjax_false():
 
 
 # Test user overrides
-async def test_custom_plotly_url(user_input_scenarios):
+@given(strategy_valid_path)  # claude, change all further functions to this style
+async def test_custom_plotly_url(custom_plotly):
     """Test custom plotly URL override."""
-    custom_plotly = user_input_scenarios["custom_plotly_url"]
     with_custom = PageGenerator(plotly=custom_plotly).generate_index()
-    scripts = get_scripts_from_html(with_custom)
+    scripts, encodings = get_scripts_from_html(with_custom)
 
     assert len(scripts) == 3  # noqa: PLR2004
     assert scripts[0] == DEFAULT_MATHJAX
-    assert scripts[1] == custom_plotly
+    if isinstance(custom_plotly, tuple):
+        assert scripts[1] == str(custom_plotly[0])
+        assert encodings[1] == custom_plotly[1]
+    else:
+        assert scripts[1] == str(custom_plotly)
     assert scripts[2].endswith("kaleido_scopes.js")
 
 
-async def test_custom_mathjax_url(user_input_scenarios):
+@given(strategy_valid_path)
+async def test_custom_mathjax_url(custom_mathjax):
     """Test custom mathjax URL override."""
-    custom_mathjax = user_input_scenarios["custom_mathjax_url"]
     with_custom = PageGenerator(mathjax=custom_mathjax).generate_index()
-    scripts = get_scripts_from_html(with_custom)
+    scripts, encodings = get_scripts_from_html(with_custom)
 
     assert len(scripts) == 3  # noqa: PLR2004
-    assert scripts[0] == custom_mathjax
+    if isinstance(custom_mathjax, tuple):
+        assert scripts[0] == str(custom_mathjax[0])
+        assert encodings[0] == custom_mathjax[1]
+    else:
+        assert scripts[0] == str(custom_mathjax)
     assert scripts[1].endswith("package_data/plotly.min.js")
     assert scripts[2].endswith("kaleido_scopes.js")
 
 
-async def test_other_scripts(user_input_scenarios):
+@given(strategy_others_list)
+async def test_other_scripts(other_scripts):
     """Test adding other scripts."""
-    other_scripts = user_input_scenarios["other_scripts"]
     with_others = PageGenerator(others=other_scripts).generate_index()
-    scripts = get_scripts_from_html(with_others)
+    scripts, encodings = get_scripts_from_html(with_others)
 
-    assert len(scripts) == 5  # noqa: PLR2004
+    # mathjax + plotly + others + kaleido_scopes
+    expected_count = 2 + len(other_scripts) + 1
+    assert len(scripts) == expected_count
     assert scripts[0] == DEFAULT_MATHJAX
     assert scripts[1].endswith("package_data/plotly.min.js")
-    assert scripts[2] == other_scripts[0]
-    assert scripts[3] == other_scripts[1]
-    assert scripts[4].endswith("kaleido_scopes.js")
 
+    # Check all other scripts in order
+    for i, script in enumerate(other_scripts):
+        if isinstance(script, tuple):
+            assert scripts[2 + i] == str(script[0])
+            assert encodings[2 + i] == script[1]
+        else:
+            assert scripts[2 + i] == str(script)
+
+    assert scripts[-1].endswith("kaleido_scopes.js")
 
-async def test_combined_overrides(user_input_scenarios):
-    """Test combination of multiple overrides."""
-    custom_plotly = user_input_scenarios["custom_plotly_url"]
-    custom_mathjax = user_input_scenarios["custom_mathjax_url"]
-    other_scripts = user_input_scenarios["other_scripts"]
 
+@given(
+    custom_plotly=strategy_valid_path,
+    custom_mathjax=strategy_mathjax,
+    other_scripts=strategy_others_list,
+)
+async def test_combined_overrides(custom_plotly, custom_mathjax, other_scripts):
+    """Test combination of multiple overrides."""
     combined = PageGenerator(
         plotly=custom_plotly,
         mathjax=custom_mathjax,
         others=other_scripts,
     ).generate_index()
-    scripts = get_scripts_from_html(combined)
-
-    assert len(scripts) == 5  # noqa: PLR2004
-    assert scripts[0] == custom_mathjax
-    assert scripts[1] == custom_plotly
-    assert scripts[2] == other_scripts[0]
-    assert scripts[3] == other_scripts[1]
-    assert scripts[4].endswith("kaleido_scopes.js")
+    scripts, encodings = get_scripts_from_html(combined)
+
+    # Calculate expected count
+    expected_count = 0
+    script_index = 0
+
+    # Mathjax adds one (unless False)
+    if custom_mathjax is not False:
+        expected_count += 1
+        if custom_mathjax is None:
+            expected_mathjax = DEFAULT_MATHJAX
+        elif isinstance(custom_mathjax, tuple):
+            expected_mathjax = str(custom_mathjax[0])
+            assert encodings[script_index] == custom_mathjax[1]
+        else:
+            expected_mathjax = str(custom_mathjax)
+        assert scripts[script_index] == expected_mathjax
+        script_index += 1
+
+    # Plotly always adds one
+    expected_count += 1
+    if isinstance(custom_plotly, tuple):
+        assert scripts[script_index] == str(custom_plotly[0])
+        assert encodings[script_index] == custom_plotly[1]
+    else:
+        assert scripts[script_index] == str(custom_plotly)
+    script_index += 1
+
+    # Others adds however many are in the list
+    expected_count += len(other_scripts)
+    for script in other_scripts:
+        if isinstance(script, tuple):
+            assert scripts[script_index] == str(script[0])
+            assert encodings[script_index] == script[1]
+        else:
+            assert scripts[script_index] == str(script)
+        script_index += 1
+
+    # Kaleido scopes always adds one
+    expected_count += 1
+    assert scripts[script_index].endswith("kaleido_scopes.js")
+
+    assert len(scripts) == expected_count
 
 
 # Test file path validation
@@ -300,7 +344,7 @@ async def test_existing_file_path(temp_js_file):
     # Test with regular path
     generator = PageGenerator(plotly=str(temp_js_file))
     html = generator.generate_index()
-    scripts = get_scripts_from_html(html)
+    scripts, encodings = get_scripts_from_html(html)
     assert len(scripts) == 3  # noqa: PLR2004
     assert scripts[0] == DEFAULT_MATHJAX
     assert scripts[1] == str(temp_js_file)
@@ -309,7 +353,7 @@ async def test_existing_file_path(temp_js_file):
     # Test with file:/// protocol
     generator_uri = PageGenerator(plotly=temp_js_file.as_uri())
     html_uri = generator_uri.generate_index()
-    scripts_uri = get_scripts_from_html(html_uri)
+    scripts_uri, encodings_uri = get_scripts_from_html(html_uri)
     assert len(scripts_uri) == 3  # noqa: PLR2004
     assert scripts_uri[0] == DEFAULT_MATHJAX
     assert scripts_uri[1] == temp_js_file.as_uri()
@@ -359,91 +403,10 @@ async def test_http_urls_skip_file_validation():
         others=["https://nonexistent.example.com/other.js"],
     )
     html = generator.generate_index()
-    scripts = get_scripts_from_html(html)
+    scripts, encodings = get_scripts_from_html(html)
 
     assert len(scripts) == 4  # noqa: PLR2004
     assert scripts[0] == "https://nonexistent.example.com/mathjax.js"
     assert scripts[1] == "https://nonexistent.example.com/plotly.js"
     assert scripts[2] == "https://nonexistent.example.com/other.js"
     assert scripts[3].endswith("kaleido_scopes.js")
-
-
-# Test tuple (path, encoding) functionality
-async def test_plotly_with_encoding_tuple(user_input_scenarios):
-    """Test plotly parameter with (url, encoding) tuple."""
-    plotly_tuple = user_input_scenarios["plotly_with_encoding"]
-    generator = PageGenerator(plotly=plotly_tuple)
-    html = generator.generate_index()
-    scripts = get_scripts_from_html(html)
-
-    assert len(scripts) == 3  # noqa: PLR2004
-    assert scripts[0] == DEFAULT_MATHJAX
-    assert scripts[1] == plotly_tuple[0]  # Should be the URL from tuple
-    assert scripts[2].endswith("kaleido_scopes.js")
-
-
-async def test_mathjax_with_encoding_tuple(user_input_scenarios):
-    """Test mathjax parameter with (url, encoding) tuple."""
-    mathjax_tuple = user_input_scenarios["mathjax_with_encoding"]
-    generator = PageGenerator(mathjax=mathjax_tuple)
-    html = generator.generate_index()
-    scripts = get_scripts_from_html(html)
-
-    assert len(scripts) == 3  # noqa: PLR2004
-    assert scripts[0] == mathjax_tuple[0]  # Should be the URL from tuple
-    assert scripts[1].endswith("package_data/plotly.min.js")
-    assert scripts[2].endswith("kaleido_scopes.js")
-
-
-async def test_others_tuple_error(user_input_scenarios):
-    """Test that others parameter with tuples currently fails (documents bug)."""
-    # Create a tuple for others list
-    url_encoding_tuple = user_input_scenarios["plotly_with_encoding"]
-
-    # This should fail until the others parameter properly handles tuples
-    with pytest.raises((TypeError, AttributeError, ValueError)):
-        PageGenerator(others=[url_encoding_tuple])
-
-
-@given(st.text(min_size=1, max_size=10).map(lambda x: f"https://example.com/{x}.js"))
-async def test_plotly_urls_hypothesis(url):
-    """Test plotly with hypothesis-generated URLs."""
-    generator = PageGenerator(plotly=url)
-    html = generator.generate_index()
-    scripts = get_scripts_from_html(html)
-
-    assert len(scripts) == 3  # noqa: PLR2004
-    assert scripts[0] == DEFAULT_MATHJAX
-    assert scripts[1] == url
-    assert scripts[2].endswith("kaleido_scopes.js")
-
-
-@given(
-    st.tuples(
-        st.text(min_size=1, max_size=10).map(lambda x: f"https://example.com/{x}.js"),
-        st.sampled_from(["utf-8", "utf-16", "ascii"]),
-    ),
-)
-async def test_encoding_tuples_hypothesis(url_encoding_tuple):
-    """Test encoding tuples with hypothesis-generated data."""
-    url, encoding = url_encoding_tuple
-
-    # Test with plotly
-    generator = PageGenerator(plotly=(url, encoding))
-    html = generator.generate_index()
-    scripts = get_scripts_from_html(html)
-
-    assert len(scripts) == 3  # noqa: PLR2004
-    assert scripts[0] == DEFAULT_MATHJAX
-    assert scripts[1] == url
-    assert scripts[2].endswith("kaleido_scopes.js")
-
-    # Test with mathjax
-    generator2 = PageGenerator(mathjax=(url, encoding))
-    html2 = generator2.generate_index()
-    scripts2 = get_scripts_from_html(html2)
-
-    assert len(scripts2) == 3  # noqa: PLR2004
-    assert scripts2[0] == url
-    assert scripts2[1].endswith("package_data/plotly.min.js")
-    assert scripts2[2].endswith("kaleido_scopes.js")

From e92fca892285fe2b6552db48394f1482c6798da8 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Mon, 25 Aug 2025 20:09:42 -0500
Subject: [PATCH 031/167] Rename test file

---
 src/py/tests/{test_calc_fig.py => test_calc_fig_one_off.py} | 0
 1 file changed, 0 insertions(+), 0 deletions(-)
 rename src/py/tests/{test_calc_fig.py => test_calc_fig_one_off.py} (100%)

diff --git a/src/py/tests/test_calc_fig.py b/src/py/tests/test_calc_fig_one_off.py
similarity index 100%
rename from src/py/tests/test_calc_fig.py
rename to src/py/tests/test_calc_fig_one_off.py

From 6711e6101257024f9e4f5c85411f2503fa237399 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Tue, 26 Aug 2025 10:03:21 -0500
Subject: [PATCH 032/167] Fix bad mathjax conditional

---
 src/py/kaleido/_page_generator.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/py/kaleido/_page_generator.py b/src/py/kaleido/_page_generator.py
index b82e5a8c..69f287a5 100644
--- a/src/py/kaleido/_page_generator.py
+++ b/src/py/kaleido/_page_generator.py
@@ -80,7 +80,7 @@ def __init__(
         """
         self._scripts = []
         if mathjax is not False:
-            if not mathjax:
+            if not mathjax or mathjax is True:
                 mathjax = DEFAULT_MATHJAX
             else:
                 _ensure_path(mathjax)

From 76ad5950c0f532179266a0f2d270ca23818733f7 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Tue, 26 Aug 2025 11:50:18 -0500
Subject: [PATCH 033/167] Add more types to Kaleido

---
 src/py/kaleido/kaleido.py | 69 +++++++++++++++++++++++++--------------
 1 file changed, 44 insertions(+), 25 deletions(-)

diff --git a/src/py/kaleido/kaleido.py b/src/py/kaleido/kaleido.py
index 526603b2..2b3c19bb 100644
--- a/src/py/kaleido/kaleido.py
+++ b/src/py/kaleido/kaleido.py
@@ -4,7 +4,7 @@
 
 import asyncio
 import warnings
-from collections.abc import Iterable
+from collections.abc import AsyncIterable, Iterable
 from functools import partial
 from pathlib import Path
 from typing import TYPE_CHECKING
@@ -24,6 +24,8 @@
     from types import TracebackType
     from typing import Any, Callable, Coroutine
 
+    from ._fig_tools import Figurish
+
 _logger = logistro.getLogger(__name__)
 
 # Show a warning if the installed Plotly version
@@ -31,10 +33,10 @@
 warn_incompatible_plotly()
 
 
-def _make_printer(name: str) -> Callable[[str], Coroutine[Any, Any, None]]:
+def _make_printer(name: str) -> Callable[[Any], Coroutine[Any, Any, None]]:
     """Create event printer for generic events. Helper function."""
 
-    async def print_all(response: str) -> None:
+    async def print_all(response: Any) -> None:
         _logger.debug2(f"{name}:{response}")
 
     return print_all
@@ -93,8 +95,8 @@ def __init__(  # noqa: D417, PLR0913 no args/kwargs in description
         page_generator: None | PageGenerator | str | Path = None,
         n: int = 1,
         timeout: int | None = 90,
-        width: int | None = None,
-        height: int | None = None,
+        width: int | None = None,  # deprecate
+        height: int | None = None,  # deprecate
         stepper: bool = False,
         plotlyjs: str | None = None,
         mathjax: str | None = None,
@@ -132,8 +134,8 @@ def __init__(  # noqa: D417, PLR0913 no args/kwargs in description
         page = page_generator
         self._timeout = timeout
         self._n = n
-        self._height = height
-        self._width = width
+        self._height = height  # deprecate
+        self._width = width  # deprecate
         self._stepper = stepper
         self._plotlyjs = plotlyjs
         self._mathjax = mathjax
@@ -177,7 +179,7 @@ def __init__(  # noqa: D417, PLR0913 no args/kwargs in description
                 page = PageGenerator(plotly=self._plotlyjs, mathjax=self._mathjax)
             page.generate_index(index)
 
-    async def _conform_tabs(self, tabs=None) -> None:
+    async def _conform_tabs(self, tabs: list[choreo.Tab] | None = None) -> None:
         if not tabs:
             tabs = list(self.tabs.values())
         _logger.info(f"Conforming {len(tabs)} to {self._index}")
@@ -258,7 +260,7 @@ async def _get_kaleido_tab(self) -> _KaleidoTab:
         _logger.info(f"Got {tab.tab.target_id[:4]}")
         return tab
 
-    async def _return_kaleido_tab(self, tab):
+    async def _return_kaleido_tab(self, tab: _KaleidoTab) -> None:
         """
         Refresh tab and put it back into the available queue.
 
@@ -275,7 +277,11 @@ async def _return_kaleido_tab(self, tab):
         await self.tabs_ready.put(tab)
         _logger.debug(f"{tab.tab.target_id[:4]} put back.")
 
-    def _clean_tab_return_task(self, main_task, task):
+    def _clean_tab_return_task(
+        self,
+        main_task: asyncio.Task,
+        task: asyncio.Task,
+    ) -> None:
         _logger.info("Cleaning out background tasks.")
         self._background_render_tasks.remove(task)
         e = task.exception()
@@ -285,7 +291,14 @@ def _clean_tab_return_task(self, main_task, task):
                 main_task.cancel()
             raise e
 
-    def _check_render_task(self, name, tab, main_task, error_log, task):
+    def _check_render_task(
+        self,
+        name: str,
+        tab: _KaleidoTab,
+        main_task: asyncio.Task,
+        error_log: None | list[ErrorEntry],
+        task: asyncio.Task,
+    ) -> None:
         if task.cancelled():
             _logger.info(f"Something cancelled {name}.")
             error_log.append(
@@ -307,7 +320,13 @@ def _check_render_task(self, name, tab, main_task, error_log, task):
         self._background_render_tasks.add(t)
         t.add_done_callback(partial(self._clean_tab_return_task, main_task))
 
-    async def _render_task(self, tab, args, error_log=None, profiler=None):
+    async def _render_task(
+        self,
+        tab: _KaleidoTab,
+        args: Any,
+        error_log: None | list[ErrorEntry] = None,
+        profiler: None | list = None,
+    ):
         _logger.info(f"Posting a task for {args['full_path'].name}")
         if self._timeout:
             try:
@@ -346,11 +365,11 @@ async def _render_task(self, tab, args, error_log=None, profiler=None):
 
     async def calc_fig(
         self,
-        fig,
-        path=None,
-        opts=None,
+        fig: Figurish,
+        path: str | Path | None = None,
+        opts: None | dict = None,
         *,
-        topojson=None,
+        topojson: str | None = None,
     ):
         """
         Calculate the bytes for a figure.
@@ -381,13 +400,13 @@ async def calc_fig(
 
     async def write_fig(  # noqa: PLR0913, C901 (too many args, complexity)
         self,
-        fig,
-        path=None,
-        opts=None,
+        fig: Figurish,
+        path: str | Path | None = None,
+        opts: dict | None = None,
         *,
-        topojson=None,
-        error_log=None,
-        profiler=None,
+        topojson: str | None = None,
+        error_log: None | list[ErrorEntry] = None,
+        profiler: None | list = None,
     ):
         """
         Call the plotly renderer via javascript on first available tab.
@@ -474,10 +493,10 @@ async def _loop(f):
 
     async def write_fig_from_object(  # noqa: C901 too complex
         self,
-        generator,
+        generator: Iterable | AsyncIterable,
         *,
-        error_log=None,
-        profiler=None,
+        error_log: None | list[ErrorEntry] = None,
+        profiler: None | list = None,
     ):
         """
         Equal to `write_fig` but allows the user to generate all arguments.

From cfdacc1386fb99fcb3dc22555980aeec2f75c44b Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Tue, 26 Aug 2025 11:56:23 -0500
Subject: [PATCH 034/167] Add check for None value.

---
 src/py/kaleido/kaleido.py | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/src/py/kaleido/kaleido.py b/src/py/kaleido/kaleido.py
index 2b3c19bb..5b3f81bd 100644
--- a/src/py/kaleido/kaleido.py
+++ b/src/py/kaleido/kaleido.py
@@ -301,9 +301,10 @@ def _check_render_task(
     ) -> None:
         if task.cancelled():
             _logger.info(f"Something cancelled {name}.")
-            error_log.append(
-                ErrorEntry(name, asyncio.CancelledError, tab.javascript_log),
-            )
+            if error_log:
+                error_log.append(
+                    ErrorEntry(name, asyncio.CancelledError, tab.javascript_log),
+                )
         elif e := task.exception():
             _logger.error(f"Render Task Error In {name}- ", exc_info=e)
             if isinstance(e, (asyncio.TimeoutError, TimeoutError)) and error_log:

From 9fd331c6948d78cd13265dfb54c03fea3dbb31e7 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Tue, 26 Aug 2025 12:00:45 -0500
Subject: [PATCH 035/167] Fix kaleido typing errors.

---
 src/py/kaleido/kaleido.py | 31 +++++++++++++++++--------------
 1 file changed, 17 insertions(+), 14 deletions(-)

diff --git a/src/py/kaleido/kaleido.py b/src/py/kaleido/kaleido.py
index 5b3f81bd..50099442 100644
--- a/src/py/kaleido/kaleido.py
+++ b/src/py/kaleido/kaleido.py
@@ -24,7 +24,7 @@
     from types import TracebackType
     from typing import Any, Callable, Coroutine
 
-    from ._fig_tools import Figurish
+    from . import _fig_tools
 
 _logger = logistro.getLogger(__name__)
 
@@ -198,8 +198,9 @@ async def _conform_tabs(self, tabs: list[choreo.Tab] | None = None) -> None:
         _logger.info("Waiting on all navigates")
         await asyncio.gather(*tasks)
         _logger.info("All navigates done, putting them all in queue.")
-        for tab in kaleido_tabs:
-            await self.tabs_ready.put(tab)
+
+        for ktab in kaleido_tabs:
+            await self.tabs_ready.put(ktab)
         self._total_tabs = len(kaleido_tabs)
         _logger.debug("Tabs fully navigated/enabled/ready")
 
@@ -366,9 +367,9 @@ async def _render_task(
 
     async def calc_fig(
         self,
-        fig: Figurish,
+        fig: _fig_tools.Figurish,
         path: str | Path | None = None,
-        opts: None | dict = None,
+        opts: None | _fig_tools.LayoutOpts = None,
         *,
         topojson: str | None = None,
     ):
@@ -399,11 +400,11 @@ async def calc_fig(
         await self._return_kaleido_tab(tab)
         return data[0]
 
-    async def write_fig(  # noqa: PLR0913, C901 (too many args, complexity)
+    async def write_fig(  # noqa: PLR0913, PLR0912, C901 (too many args, complexity)
         self,
-        fig: Figurish,
+        fig: _fig_tools.Figurish,
         path: str | Path | None = None,
-        opts: dict | None = None,
+        opts: _fig_tools.LayoutOpts | None = None,
         *,
         topojson: str | None = None,
         error_log: None | list[ErrorEntry] = None,
@@ -440,8 +441,8 @@ async def write_fig(  # noqa: PLR0913, C901 (too many args, complexity)
         else:
             _logger.debug(f"Is iterable {type(fig)}")
 
-        main_task = asyncio.current_task()
-        self._main_tasks.add(main_task)
+        if main_task := asyncio.current_task():
+            self._main_tasks.add(main_task)
         tasks = set()
 
         async def _loop(f):
@@ -490,7 +491,8 @@ async def _loop(f):
                     task.cancel()
             raise
         finally:
-            self._main_tasks.remove(main_task)
+            if main_task:
+                self._main_tasks.remove(main_task)
 
     async def write_fig_from_object(  # noqa: C901 too complex
         self,
@@ -535,8 +537,8 @@ async def write_fig_from_object(  # noqa: C901 too complex
         if profiler is not None:
             _logger.info("Using profiler.")
 
-        main_task = asyncio.current_task()
-        self._main_tasks.add(main_task)
+        if main_task := asyncio.current_task():
+            self._main_tasks.add(main_task)
         tasks = set()
 
         async def _loop(args):
@@ -587,4 +589,5 @@ async def _loop(args):
                     task.cancel()
             raise
         finally:
-            self._main_tasks.remove(main_task)
+            if main_task:
+                self._main_tasks.remove(main_task)

From e3d5a87e082dc44b517111dcf436d48de86b1ea2 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Tue, 26 Aug 2025 13:19:39 -0500
Subject: [PATCH 036/167] Iterate on kaleido.py tests claude

---
 src/py/.pre-commit-config.yaml |   2 +-
 src/py/tests/test_kaleido.py   | 218 +++++++++++++++++++++++++++++++++
 2 files changed, 219 insertions(+), 1 deletion(-)
 create mode 100644 src/py/tests/test_kaleido.py

diff --git a/src/py/.pre-commit-config.yaml b/src/py/.pre-commit-config.yaml
index c0686a7b..5f875d93 100644
--- a/src/py/.pre-commit-config.yaml
+++ b/src/py/.pre-commit-config.yaml
@@ -30,7 +30,7 @@ repos:
       - id: add-trailing-comma
   - repo: https://github.com/astral-sh/ruff-pre-commit
     #  Ruff version.
-    rev: v0.8.2
+    rev: v0.12.10
     hooks:
       #  Run the linter.
       - id: ruff
diff --git a/src/py/tests/test_kaleido.py b/src/py/tests/test_kaleido.py
new file mode 100644
index 00000000..d54c046b
--- /dev/null
+++ b/src/py/tests/test_kaleido.py
@@ -0,0 +1,218 @@
+from unittest.mock import patch
+
+import pytest
+from hypothesis import given
+from hypothesis import strategies as st
+
+from kaleido import Kaleido
+
+
+@pytest.fixture
+async def simple_figure_with_bytes(tmp_path):
+    """Create a simple figure with calculated bytes and PNG assertion."""
+    import plotly.express as px  # noqa: PLC0415
+
+    fig = px.line(x=[1, 2, 3], y=[1, 2, 3])
+    path = tmp_path / "test_figure.png"
+
+    async with Kaleido() as k:
+        bytes_data = await k.calc_fig(
+            fig,
+            opts={"format": "png", "width": 400, "height": 300},
+        )
+
+    # Assert it's a PNG by checking the PNG signature
+    assert bytes_data[:8] == b"\x89PNG\r\n\x1a\n", "Generated data is not a valid PNG"
+
+    return {
+        "fig": fig,
+        "bytes": bytes_data,
+        "path": path,
+        "opts": {"format": "png", "width": 400, "height": 300},
+    }
+
+
+async def test_write_fig_from_object_sync_generator(simple_figure_with_bytes, tmp_path):
+    """Test write_fig_from_object with sync generator."""
+
+    file_paths = []
+
+    def fig_generator():
+        for i in range(2):
+            path = tmp_path / f"test_sync_{i}.png"
+            file_paths.append(path)
+            yield {
+                "fig": simple_figure_with_bytes["fig"],
+                "path": path,
+                "opts": simple_figure_with_bytes["opts"],
+            }
+
+    async with Kaleido() as k:
+        await k.write_fig_from_object(fig_generator())
+
+    # Assert that each created file matches the fixture bytes
+    for path in file_paths:
+        assert path.exists(), f"File {path} was not created"
+        created_bytes = path.read_bytes()
+        assert created_bytes == simple_figure_with_bytes["bytes"], (
+            f"File {path} bytes don't match fixture bytes"
+        )
+
+
+async def test_write_fig_from_object_async_generator(
+    simple_figure_with_bytes,
+    tmp_path,
+):
+    """Test write_fig_from_object with async generator."""
+
+    file_paths = []
+
+    async def fig_async_generator():
+        for i in range(2):
+            path = tmp_path / f"test_async_{i}.png"
+            file_paths.append(path)
+            yield {
+                "fig": simple_figure_with_bytes["fig"],
+                "path": path,
+                "opts": simple_figure_with_bytes["opts"],
+            }
+
+    async with Kaleido() as k:
+        await k.write_fig_from_object(fig_async_generator())
+
+    # Assert that each created file matches the fixture bytes
+    for path in file_paths:
+        assert path.exists(), f"File {path} was not created"
+        created_bytes = path.read_bytes()
+        assert created_bytes == simple_figure_with_bytes["bytes"], (
+            f"File {path} bytes don't match fixture bytes"
+        )
+
+
+async def test_write_fig_from_object_iterator(simple_figure_with_bytes, tmp_path):
+    """Test write_fig_from_object with iterator."""
+
+    fig_list = []
+    file_paths = []
+    for i in range(2):
+        path = tmp_path / f"test_iter_{i}.png"
+        file_paths.append(path)
+        fig_list.append(
+            {
+                "fig": simple_figure_with_bytes["fig"],
+                "path": path,
+                "opts": simple_figure_with_bytes["opts"],
+            },
+        )
+
+    async with Kaleido() as k:
+        await k.write_fig_from_object(fig_list)
+
+    # Assert that each created file matches the fixture bytes
+    for path in file_paths:
+        assert path.exists(), f"File {path} was not created"
+        created_bytes = path.read_bytes()
+        assert created_bytes == simple_figure_with_bytes["bytes"], (
+            f"File {path} bytes don't match fixture bytes"
+        )
+
+
+async def test_write_fig_from_object_bare_dictionary(
+    simple_figure_with_bytes,
+    tmp_path,
+):
+    """Test write_fig_from_object with bare dictionary list."""
+
+    path1 = tmp_path / "test_dict_1.png"
+    path2 = tmp_path / "test_dict_2.png"
+
+    fig_data = [
+        {
+            "fig": simple_figure_with_bytes["fig"],
+            "path": path1,
+            "opts": simple_figure_with_bytes["opts"],
+        },
+        {
+            "fig": simple_figure_with_bytes["fig"].to_dict(),
+            "path": path2,
+            "opts": simple_figure_with_bytes["opts"],
+        },
+    ]
+
+    async with Kaleido() as k:
+        await k.write_fig_from_object(fig_data)
+
+    # Assert that each created file matches the fixture bytes
+    for path in [path1, path2]:
+        assert path.exists(), f"File {path} was not created"
+        created_bytes = path.read_bytes()
+        assert created_bytes == simple_figure_with_bytes["bytes"], (
+            f"File {path} bytes don't match fixture bytes"
+        )
+
+
+@given(
+    path=st.text(
+        min_size=1,
+        max_size=50,
+        alphabet=st.characters(whitelist_categories=["L", "N"]),
+    ),
+    width=st.integers(min_value=100, max_value=2000),
+    height=st.integers(min_value=100, max_value=2000),
+    format_type=st.sampled_from(["png", "svg", "pdf", "html"]),
+    topojson=st.one_of(st.none(), st.text(min_size=1, max_size=20)),
+)
+async def test_write_fig_argument_passthrough(  #  noqa: PLR0913
+    simple_figure_with_bytes,
+    tmp_path,
+    path,
+    width,
+    height,
+    format_type,
+    topojson,
+):
+    """Test that write_fig properly passes arguments to write_fig_from_object."""
+
+    test_path = tmp_path / f"{path}.{format_type}"
+    opts = {"format": format_type, "width": width, "height": height}
+
+    # Mock write_fig_from_object to capture arguments
+    with patch.object(Kaleido, "write_fig_from_object") as mock_write_fig_from_object:
+        async with Kaleido() as k:
+            await k.write_fig(
+                simple_figure_with_bytes["fig"],
+                path=test_path,
+                opts=opts,
+                topojson=topojson,
+            )
+
+        # Verify write_fig_from_object was called
+        mock_write_fig_from_object.assert_called_once()
+
+        # Extract the generator that was passed as first argument
+        args, kwargs = mock_write_fig_from_object.call_args
+        assert len(args) == 1, "Expected exactly one argument (the generator)"
+
+        generator = args[0]
+
+        # Convert generator to list to inspect its contents
+        generated_args_list = list(generator)
+        assert len(generated_args_list) == 1, (
+            "Expected generator to yield exactly one item"
+        )
+
+        generated_args = generated_args_list[0]
+
+        # Validate that the generated arguments match what we passed to write_fig
+        assert "fig" in generated_args, "Generated args should contain 'fig'"
+        assert "path" in generated_args, "Generated args should contain 'path'"
+        assert "opts" in generated_args, "Generated args should contain 'opts'"
+        assert "topojson" in generated_args, "Generated args should contain 'topojson'"
+
+        # Check that the values match
+        assert generated_args["fig"] == simple_figure_with_bytes["fig"], (
+            "Figure should match"
+        )  # this should fail
+        assert str(generated_args["path"]) == str(test_path), "Path should match"
+        assert generated_args["opts"] == opts, "Options should match"
+        assert generated_args["topojson"] == topojson, "Topojson should match"

From c8afc8895f25d58de0638f31aa48fe4f50b59ad4 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Tue, 26 Aug 2025 14:03:40 -0500
Subject: [PATCH 037/167] Mark test skipped for after refactor.

---
 src/py/tests/test_kaleido.py | 23 ++++++++++++++++++++---
 1 file changed, 20 insertions(+), 3 deletions(-)

diff --git a/src/py/tests/test_kaleido.py b/src/py/tests/test_kaleido.py
index d54c046b..ec1eb938 100644
--- a/src/py/tests/test_kaleido.py
+++ b/src/py/tests/test_kaleido.py
@@ -1,7 +1,7 @@
 from unittest.mock import patch
 
 import pytest
-from hypothesis import given
+from hypothesis import HealthCheck, Phase, given, settings
 from hypothesis import strategies as st
 
 from kaleido import Kaleido
@@ -151,6 +151,19 @@ async def test_write_fig_from_object_bare_dictionary(
         )
 
 
+# In the refactor, all figure generation methods are really just wrappers
+# for the most flexible, tested above, generate_fig_from_object.
+# So we test that one, and then test to make sure its receiving arguments
+# properly for the other tests.
+
+
+# Uncomment these settings after refactor.
+# @settings(suppress_health_check=[HealthCheck.function_scoped_fixture])
+@settings(
+    phases=[Phase.generate],
+    max_examples=1,
+    suppress_health_check=[HealthCheck.function_scoped_fixture],
+)
 @given(
     path=st.text(
         min_size=1,
@@ -172,7 +185,7 @@ async def test_write_fig_argument_passthrough(  #  noqa: PLR0913
     topojson,
 ):
     """Test that write_fig properly passes arguments to write_fig_from_object."""
-
+    pytest.skip("Remove this failure line and the comment above after the refactor!")
     test_path = tmp_path / f"{path}.{format_type}"
     opts = {"format": format_type, "width": width, "height": height}
 
@@ -212,7 +225,11 @@ async def test_write_fig_argument_passthrough(  #  noqa: PLR0913
         # Check that the values match
         assert generated_args["fig"] == simple_figure_with_bytes["fig"], (
             "Figure should match"
-        )  # this should fail
+        )
         assert str(generated_args["path"]) == str(test_path), "Path should match"
         assert generated_args["opts"] == opts, "Options should match"
         assert generated_args["topojson"] == topojson, "Topojson should match"
+
+
+def test_forcefail():
+    pytest.fail("After refactor, remove this test and unskip test above.")

From 30eeccac37b2abb9b07c0232360892168702bcc3 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Tue, 26 Aug 2025 14:31:41 -0500
Subject: [PATCH 038/167] Add further kaleido tests.

---
 src/py/tests/test_kaleido.py | 155 +++++++++++++++++++++++++++++++++++
 1 file changed, 155 insertions(+)

diff --git a/src/py/tests/test_kaleido.py b/src/py/tests/test_kaleido.py
index ec1eb938..58020acb 100644
--- a/src/py/tests/test_kaleido.py
+++ b/src/py/tests/test_kaleido.py
@@ -1,3 +1,5 @@
+import asyncio
+import re
 from unittest.mock import patch
 
 import pytest
@@ -233,3 +235,156 @@ async def test_write_fig_argument_passthrough(  #  noqa: PLR0913
 
 def test_forcefail():
     pytest.fail("After refactor, remove this test and unskip test above.")
+
+
+async def test_kaleido_instantiate_no_hang():
+    """Test that instantiating Kaleido doesn't hang."""
+    _ = Kaleido()
+
+
+async def test_kaleido_instantiate_and_close():
+    """Test that instantiating and closing Kaleido works."""
+    # Maybe there should be a warning or error when closing without opening?
+    k = Kaleido()
+    await k.close()
+
+
+async def test_all_methods_context_and_non_context(simple_figure_with_bytes, tmp_path):
+    """Test write, write_from_object, and calc with context and non-context."""
+    fig = simple_figure_with_bytes["fig"]
+    opts = simple_figure_with_bytes["opts"]
+    expected_bytes = simple_figure_with_bytes["bytes"]
+
+    # Test with context manager
+    async with Kaleido() as k:
+        # Test calc_fig
+        calc_bytes = await k.calc_fig(fig, opts=opts)
+        assert calc_bytes == expected_bytes, "calc_fig bytes don't match fixture"
+
+        # Test write_fig
+        write_path = tmp_path / "context_write.png"
+        await k.write_fig(fig, path=write_path, opts=opts)
+        assert write_path.exists(), "write_fig didn't create file"
+        write_bytes = write_path.read_bytes()
+        assert write_bytes == expected_bytes, "write_fig bytes don't match fixture"
+
+        # Test write_fig_from_object
+        obj_path = tmp_path / "context_obj.png"
+        await k.write_fig_from_object([{"fig": fig, "path": obj_path, "opts": opts}])
+        assert obj_path.exists(), "write_fig_from_object didn't create file"
+        obj_bytes = obj_path.read_bytes()
+        assert obj_bytes == expected_bytes, (
+            "write_fig_from_object bytes don't match fixture"
+        )
+
+    # Test without context manager
+    k = Kaleido()
+    await k.open()
+    try:
+        # Test calc_fig
+        calc_bytes = await k.calc_fig(fig, opts=opts)
+        assert calc_bytes == expected_bytes, (
+            "Non-context calc_fig bytes don't match fixture"
+        )
+
+        # Test write_fig
+        write_path2 = tmp_path / "non_context_write.png"
+        await k.write_fig(fig, path=write_path2, opts=opts)
+        assert write_path2.exists(), "Non-context write_fig didn't create file"
+        write_bytes2 = write_path2.read_bytes()
+        assert write_bytes2 == expected_bytes, (
+            "Non-context write_fig bytes don't match fixture"
+        )
+
+        # Test write_fig_from_object
+        obj_path2 = tmp_path / "non_context_obj.png"
+        await k.write_fig_from_object([{"fig": fig, "path": obj_path2, "opts": opts}])
+        assert obj_path2.exists(), (
+            "Non-context write_fig_from_object didn't create file"
+        )
+        obj_bytes2 = obj_path2.read_bytes()
+        assert obj_bytes2 == expected_bytes, (
+            "Non-context write_fig_from_object bytes don't match fixture"
+        )
+    finally:
+        await k.close()
+
+
+@pytest.mark.parametrize("n_tabs", [1, 5, 20])
+async def test_tab_count_verification(n_tabs):
+    """Test that Kaleido creates the correct number of tabs."""
+    async with Kaleido(n=n_tabs) as k:
+        # Check the queue size matches expected tabs
+        assert k.tabs_ready.qsize() == n_tabs, (
+            f"Queue size {k.tabs_ready.qsize()} != {n_tabs}"
+        )
+
+        # Use devtools protocol to verify tab count
+        # Send getTargets command directly to Kaleido (which is a Browser/Target)
+        result = await k.send_command("Target.getTargets")
+        # Count targets that are pages (not service workers, etc.)
+        page_targets = [t for t in result["targetInfos"] if t.get("type") == "page"]
+        assert len(page_targets) >= n_tabs, (
+            f"Found {len(page_targets)} page targets, expected at least {n_tabs}"
+        )
+
+
+async def test_unreasonable_timeout(simple_figure_with_bytes):
+    """Test that an unreasonably small timeout actually times out."""
+
+    fig = simple_figure_with_bytes["fig"]
+    opts = simple_figure_with_bytes["opts"]
+
+    # Use an infinitely small timeout
+    async with Kaleido(timeout=0.000001) as k:
+        with pytest.raises((asyncio.TimeoutError, TimeoutError)):
+            await k.calc_fig(fig, opts=opts)
+
+
+@pytest.mark.parametrize(
+    ("plotlyjs", "mathjax"),
+    [
+        ("https://cdn.plot.ly/plotly-latest.min.js", None),
+        (
+            None,
+            "https://cdnjs.cloudflare.com/ajax/libs/mathjax/3.2.0/es5/tex-chtml.min.js",
+        ),
+        (
+            "https://cdn.plot.ly/plotly-latest.min.js",
+            "https://cdnjs.cloudflare.com/ajax/libs/mathjax/3.2.0/es5/tex-chtml.min.js",
+        ),
+    ],
+)  # THESE STRINGS DON'T ACTUALLY MATTER!
+async def test_plotlyjs_mathjax_injection(plotlyjs, mathjax):
+    """Test that plotlyjs and mathjax URLs are properly injected."""
+
+    async with Kaleido(plotlyjs=plotlyjs, mathjax=mathjax) as k:
+        # Get a tab from the public queue to check the page source
+        tab = await k.tabs_ready.get()
+        try:
+            # Get the page source using devtools protocol
+            result = await tab.tab.send_command(
+                "Runtime.evaluate",
+                {
+                    "expression": "document.documentElement.outerHTML",
+                },
+            )
+            source = result["result"]["value"]
+
+            if plotlyjs:
+                # Check if plotlyjs URL is in the source
+                plotly_pattern = re.escape(plotlyjs)
+                assert re.search(plotly_pattern, source), (
+                    f"Plotlyjs URL {plotlyjs} not found in page source"
+                )
+
+            if mathjax:
+                # Check if mathjax URL is in the source
+                mathjax_pattern = re.escape(mathjax)
+                assert re.search(mathjax_pattern, source), (
+                    f"Mathjax URL {mathjax} not found in page source"
+                )
+
+        finally:
+            # Put the tab back in the queue
+            await k.tabs_ready.put(tab)

From 8ca2ae7fde6db4edb8d1d646b8e9bffcf7bca1b3 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Wed, 27 Aug 2025 11:41:04 -0500
Subject: [PATCH 039/167] Split context/noncontext tests into two

---
 src/py/tests/test_kaleido.py | 18 +++++++++++++-----
 1 file changed, 13 insertions(+), 5 deletions(-)

diff --git a/src/py/tests/test_kaleido.py b/src/py/tests/test_kaleido.py
index 58020acb..2759cf63 100644
--- a/src/py/tests/test_kaleido.py
+++ b/src/py/tests/test_kaleido.py
@@ -249,8 +249,8 @@ async def test_kaleido_instantiate_and_close():
     await k.close()
 
 
-async def test_all_methods_context_and_non_context(simple_figure_with_bytes, tmp_path):
-    """Test write, write_from_object, and calc with context and non-context."""
+async def test_all_methods_context(simple_figure_with_bytes, tmp_path):
+    """Test write, write_from_object, and calc with context."""
     fig = simple_figure_with_bytes["fig"]
     opts = simple_figure_with_bytes["opts"]
     expected_bytes = simple_figure_with_bytes["bytes"]
@@ -277,9 +277,15 @@ async def test_all_methods_context_and_non_context(simple_figure_with_bytes, tmp
             "write_fig_from_object bytes don't match fixture"
         )
 
+
+async def test_all_methods_non_context(simple_figure_with_bytes, tmp_path):
+    """Test write, write_from_object, and calc with non-context."""
+    fig = simple_figure_with_bytes["fig"]
+    opts = simple_figure_with_bytes["opts"]
+    expected_bytes = simple_figure_with_bytes["bytes"]
+
     # Test without context manager
-    k = Kaleido()
-    await k.open()
+    k = await Kaleido()
     try:
         # Test calc_fig
         calc_bytes = await k.calc_fig(fig, opts=opts)
@@ -288,15 +294,16 @@ async def test_all_methods_context_and_non_context(simple_figure_with_bytes, tmp
         )
 
         # Test write_fig
+
         write_path2 = tmp_path / "non_context_write.png"
         await k.write_fig(fig, path=write_path2, opts=opts)
+
         assert write_path2.exists(), "Non-context write_fig didn't create file"
         write_bytes2 = write_path2.read_bytes()
         assert write_bytes2 == expected_bytes, (
             "Non-context write_fig bytes don't match fixture"
         )
 
-        # Test write_fig_from_object
         obj_path2 = tmp_path / "non_context_obj.png"
         await k.write_fig_from_object([{"fig": fig, "path": obj_path2, "opts": opts}])
         assert obj_path2.exists(), (
@@ -306,6 +313,7 @@ async def test_all_methods_context_and_non_context(simple_figure_with_bytes, tmp
         assert obj_bytes2 == expected_bytes, (
             "Non-context write_fig_from_object bytes don't match fixture"
         )
+
     finally:
         await k.close()
 

From 84629f3bd31af461d9e2884cd9fe5b5467008eb5 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Wed, 27 Aug 2025 11:53:05 -0500
Subject: [PATCH 040/167] Close browser before cancelling kaleido tasks.

---
 src/py/kaleido/kaleido.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/py/kaleido/kaleido.py b/src/py/kaleido/kaleido.py
index 50099442..0c1e50fc 100644
--- a/src/py/kaleido/kaleido.py
+++ b/src/py/kaleido/kaleido.py
@@ -65,6 +65,7 @@ class Kaleido(choreo.Browser):
 
     async def close(self) -> None:
         """Close the browser."""
+        await super().close()
         if self._tmp_dir:
             self._tmp_dir.clean()
         _logger.info("Cancelling tasks.")
@@ -75,7 +76,6 @@ async def close(self) -> None:
             if not task.done():
                 task.cancel()
         _logger.info("Exiting Kaleido/Choreo")
-        return await super().close()
 
     async def __aexit__(
         self,

From 74c87651aff86221890b0ac0d8078239b4a03b53 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Wed, 27 Aug 2025 14:04:54 -0500
Subject: [PATCH 041/167] Reorganize so __init__ creates no tmp dir

---
 src/py/kaleido/kaleido.py | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/src/py/kaleido/kaleido.py b/src/py/kaleido/kaleido.py
index 0c1e50fc..d0888ddb 100644
--- a/src/py/kaleido/kaleido.py
+++ b/src/py/kaleido/kaleido.py
@@ -159,6 +159,14 @@ def __init__(  # noqa: D417, PLR0913 no args/kwargs in description
                 "or `kaleido.get_chrome_sync()`.",
             ) from ChromeNotFoundError
 
+        # do this during open because it requires close
+        self._saved_page_arg = page
+
+    async def open(self):
+        """Build temporary file if we need one."""
+        page = self._saved_page_arg
+        del self._saved_page_arg
+
         if isinstance(page, str):
             if page.startswith(r"file://") and Path(unquote(urlparse(page).path)):
                 self._index = page
@@ -178,6 +186,7 @@ def __init__(  # noqa: D417, PLR0913 no args/kwargs in description
             if not page:
                 page = PageGenerator(plotly=self._plotlyjs, mathjax=self._mathjax)
             page.generate_index(index)
+        await super().open()
 
     async def _conform_tabs(self, tabs: list[choreo.Tab] | None = None) -> None:
         if not tabs:

From d2dd530cd03c8415464e68a512462e1ed7859702 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Wed, 27 Aug 2025 14:05:20 -0500
Subject: [PATCH 042/167] Fix test_kaleido tests.

---
 src/py/tests/test_kaleido.py | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/src/py/tests/test_kaleido.py b/src/py/tests/test_kaleido.py
index 2759cf63..8c98ec6f 100644
--- a/src/py/tests/test_kaleido.py
+++ b/src/py/tests/test_kaleido.py
@@ -10,12 +10,11 @@
 
 
 @pytest.fixture
-async def simple_figure_with_bytes(tmp_path):
+async def simple_figure_with_bytes():
     """Create a simple figure with calculated bytes and PNG assertion."""
     import plotly.express as px  # noqa: PLC0415
 
     fig = px.line(x=[1, 2, 3], y=[1, 2, 3])
-    path = tmp_path / "test_figure.png"
 
     async with Kaleido() as k:
         bytes_data = await k.calc_fig(
@@ -29,7 +28,6 @@ async def simple_figure_with_bytes(tmp_path):
     return {
         "fig": fig,
         "bytes": bytes_data,
-        "path": path,
         "opts": {"format": "png", "width": 400, "height": 300},
     }
 
@@ -331,7 +329,9 @@ async def test_tab_count_verification(n_tabs):
         # Send getTargets command directly to Kaleido (which is a Browser/Target)
         result = await k.send_command("Target.getTargets")
         # Count targets that are pages (not service workers, etc.)
-        page_targets = [t for t in result["targetInfos"] if t.get("type") == "page"]
+        page_targets = [
+            t for t in result["result"]["targetInfos"] if t.get("type") == "page"
+        ]
         assert len(page_targets) >= n_tabs, (
             f"Found {len(page_targets)} page targets, expected at least {n_tabs}"
         )
@@ -377,7 +377,7 @@ async def test_plotlyjs_mathjax_injection(plotlyjs, mathjax):
                     "expression": "document.documentElement.outerHTML",
                 },
             )
-            source = result["result"]["value"]
+            source = result["result"]["result"]["value"]
 
             if plotlyjs:
                 # Check if plotlyjs URL is in the source

From cc97c4187b7e4e93c7fc3a5d0c746ba46f9b2ab6 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Wed, 27 Aug 2025 14:11:15 -0500
Subject: [PATCH 043/167] Remove forcefail

---
 src/py/tests/test_kaleido.py | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/src/py/tests/test_kaleido.py b/src/py/tests/test_kaleido.py
index 8c98ec6f..24a4fe1c 100644
--- a/src/py/tests/test_kaleido.py
+++ b/src/py/tests/test_kaleido.py
@@ -231,10 +231,6 @@ async def test_write_fig_argument_passthrough(  #  noqa: PLR0913
         assert generated_args["topojson"] == topojson, "Topojson should match"
 
 
-def test_forcefail():
-    pytest.fail("After refactor, remove this test and unskip test above.")
-
-
 async def test_kaleido_instantiate_no_hang():
     """Test that instantiating Kaleido doesn't hang."""
     _ = Kaleido()

From fd1bb62d8fe0565f15ffb9f09f31d15351ca08c9 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Wed, 27 Aug 2025 19:50:45 -0500
Subject: [PATCH 044/167] Type fig_tools.

---
 src/py/kaleido/_fig_tools.py | 55 +++++++++++++++++++++---------------
 1 file changed, 33 insertions(+), 22 deletions(-)

diff --git a/src/py/kaleido/_fig_tools.py b/src/py/kaleido/_fig_tools.py
index fdcc63e5..f0966bb9 100644
--- a/src/py/kaleido/_fig_tools.py
+++ b/src/py/kaleido/_fig_tools.py
@@ -3,13 +3,18 @@
 import glob
 import re
 from pathlib import Path
-from typing import TYPE_CHECKING, Any, Literal, TypedDict
+from typing import TYPE_CHECKING, Literal, TypedDict
 
 import logistro
 
 if TYPE_CHECKING:
+    from typing import Any
+
     from typing_extensions import TypeGuard
 
+    Figurish = Any  # Be nice to make it more specific, dictionary or something
+    FormatString = Literal["png", "jpg", "jpeg", "webp", "svg", "json", "pdf"]
+
 _logger = logistro.getLogger(__name__)
 
 # constants
@@ -17,20 +22,26 @@
 DEFAULT_SCALE = 1
 DEFAULT_WIDTH = 700
 DEFAULT_HEIGHT = 500
-SUPPORTED_FORMATS = ("png", "jpg", "jpeg", "webp", "svg", "json", "pdf")
-FormatString = Literal["png", "jpg", "jpeg", "webp", "svg", "json", "pdf"]
+SUPPORTED_FORMATS: tuple[FormatString, ...] = (
+    "png",
+    "jpg",
+    "jpeg",
+    "webp",
+    "svg",
+    "json",
+    "pdf",
+)
 
 
 def _assert_format(ext: str) -> TypeGuard[FormatString]:
     if ext not in SUPPORTED_FORMATS:
-        raise ValueError(f"File format {ext} is not supported.")
+        raise ValueError(
+            f"Invalid format '{ext}'.\n    Supported formats: {SUPPORTED_FORMATS!s}",
+        )
     return True
 
 
-Figurish = Any  # Be nice to make it more specific, dictionary or something
-
-
-def _is_figurish(o) -> TypeGuard[Figurish]:
+def _is_figurish(o: Any) -> TypeGuard[Figurish]:
     valid = hasattr(o, "to_dict") or (isinstance(o, dict) and "data" in o)
     if not valid:
         _logger.debug(
@@ -41,7 +52,11 @@ def _is_figurish(o) -> TypeGuard[Figurish]:
     return valid
 
 
-def _get_figure_dimensions(layout, width, height):
+def _get_figure_dimensions(
+    layout: dict,
+    width: float | None,
+    height: float | None,
+) -> tuple[float, float]:
     # Compute image width / height with fallbacks
     width = (
         width
@@ -58,18 +73,13 @@ def _get_figure_dimensions(layout, width, height):
     return width, height
 
 
-def _get_format(extension):
-    original_format = extension
-    extension = extension.lower()
-    if extension == "jpg":
+def _get_format(extension: str) -> FormatString:
+    formatted_extension = extension.lower()
+    if formatted_extension == "jpg":
         return "jpeg"
-
-    if extension not in SUPPORTED_FORMATS:
-        raise ValueError(
-            f"Invalid format '{original_format}'.\n"
-            f"    Supported formats: {SUPPORTED_FORMATS!s}",
-        )
-    return extension
+    if not _assert_format(formatted_extension):
+        raise ValueError  # this line will never be reached its for typer
+    return formatted_extension
 
 
 # Input of to_spec
@@ -89,7 +99,7 @@ class Spec(TypedDict):
     data: Figurish
 
 
-def to_spec(figure, layout_opts: LayoutOpts) -> Spec:
+def to_spec(figure: Figurish, layout_opts: LayoutOpts) -> Spec:
     # Get figure layout
     layout = figure.get("layout", {})
 
@@ -123,7 +133,8 @@ def to_spec(figure, layout_opts: LayoutOpts) -> Spec:
     }
 
 
-def _next_filename(path, prefix, ext) -> str:
+def _next_filename(path: Path | str, prefix: str, ext: str) -> str:
+    path = path if isinstance(path, Path) else Path(path)
     default = 1 if (path / f"{prefix}.{ext}").exists() else 0
     re_number = re.compile(
         r"^" + re.escape(prefix) + r"\-(\d+)\." + re.escape(ext) + r"$",

From 0adba8fb4c5c8a7548c0c84b2ae1c432a98bae37 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Thu, 28 Aug 2025 11:00:30 -0500
Subject: [PATCH 045/167] Shore up current file detecting for testing.

---
 src/py/tests/test_page_generator.py | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/src/py/tests/test_page_generator.py b/src/py/tests/test_page_generator.py
index 308aaead..91575123 100644
--- a/src/py/tests/test_page_generator.py
+++ b/src/py/tests/test_page_generator.py
@@ -135,9 +135,11 @@ def nonexistent_file_path():
     ),
 ).map(lambda x: f"http{x[0]}://example.com/{x[1]}.js")
 
-_h_file_str = st.just(__file__)
-_h_file_path = st.just(Path(__file__))
-_h_file_uri = st.just(Path(__file__).as_uri())
+_valid_file_string = str(Path(__file__).resolve())
+
+_h_file_str = st.just(_valid_file_string)
+_h_file_path = st.just(Path(_valid_file_string))
+_h_file_uri = st.just(Path(_valid_file_string).as_uri())
 
 _h_uri = st.one_of(_h_url, _h_file_str, _h_file_path, _h_file_uri)
 

From a11572399b8125f12537a685980c715ddc0c5484 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Thu, 28 Aug 2025 11:17:00 -0500
Subject: [PATCH 046/167] Use tmp_path not __file__ for valid file.

---
 src/py/tests/test_page_generator.py | 61 +++++++++++++++++------------
 1 file changed, 36 insertions(+), 25 deletions(-)

diff --git a/src/py/tests/test_page_generator.py b/src/py/tests/test_page_generator.py
index 91575123..191777e0 100644
--- a/src/py/tests/test_page_generator.py
+++ b/src/py/tests/test_page_generator.py
@@ -135,27 +135,35 @@ def nonexistent_file_path():
     ),
 ).map(lambda x: f"http{x[0]}://example.com/{x[1]}.js")
 
-_valid_file_string = str(Path(__file__).resolve())
 
-_h_file_str = st.just(_valid_file_string)
-_h_file_path = st.just(Path(_valid_file_string))
-_h_file_uri = st.just(Path(_valid_file_string).as_uri())
+def st_valid_path(dir_path: Path):
+    file_path = dir_path / "foo.foo"
+    file_path.touch()
+    _valid_file_string = str(file_path.resolve())
 
-_h_uri = st.one_of(_h_url, _h_file_str, _h_file_path, _h_file_uri)
+    _h_file_str = st.just(_valid_file_string)
+    _h_file_path = st.just(Path(_valid_file_string))
+    _h_file_uri = st.just(Path(_valid_file_string).as_uri())
 
-_h_encoding = st.sampled_from(["utf-8", "utf-16", "ascii", "latin1"])
+    _h_uri = st.one_of(_h_url, _h_file_str, _h_file_path, _h_file_uri)
+
+    _h_encoding = st.sampled_from(["utf-8", "utf-16", "ascii", "latin1"])
+
+    return st.one_of(_h_uri, st.tuples(_h_uri, _h_encoding))
 
-strategy_valid_path = st.one_of(_h_uri, st.tuples(_h_uri, _h_encoding))
 
 # Variable length list strategy for 'others' parameter
-strategy_others_list = st.lists(strategy_valid_path, min_size=0, max_size=3)
+def st_others_list(dir_path: Path):
+    return st.lists(st_valid_path(dir_path), min_size=0, max_size=3)
+
 
 # Mathjax strategy (includes None, False, True, and path options)
-strategy_mathjax = st.one_of(
-    st.none(),
-    st.just(False),  #  noqa: FBT003
-    strategy_valid_path,
-)
+def st_mathjax(dir_path: Path):
+    return st.one_of(
+        st.none(),
+        st.just(False),  #  noqa: FBT003
+        st_valid_path(dir_path),
+    )
 
 
 # Test default combinations
@@ -228,9 +236,10 @@ async def test_mathjax_false():
 
 
 # Test user overrides
-@given(strategy_valid_path)  # claude, change all further functions to this style
-async def test_custom_plotly_url(custom_plotly):
+@given(st.data())  # claude, change all further functions to this style
+async def test_custom_plotly_url(tmp_path, data):
     """Test custom plotly URL override."""
+    custom_plotly = data.draw(st_valid_path(tmp_path))
     with_custom = PageGenerator(plotly=custom_plotly).generate_index()
     scripts, encodings = get_scripts_from_html(with_custom)
 
@@ -244,9 +253,10 @@ async def test_custom_plotly_url(custom_plotly):
     assert scripts[2].endswith("kaleido_scopes.js")
 
 
-@given(strategy_valid_path)
-async def test_custom_mathjax_url(custom_mathjax):
+@given(st.data())
+async def test_custom_mathjax_url(tmp_path, data):
     """Test custom mathjax URL override."""
+    custom_mathjax = data.draw(st_valid_path(tmp_path))
     with_custom = PageGenerator(mathjax=custom_mathjax).generate_index()
     scripts, encodings = get_scripts_from_html(with_custom)
 
@@ -260,9 +270,10 @@ async def test_custom_mathjax_url(custom_mathjax):
     assert scripts[2].endswith("kaleido_scopes.js")
 
 
-@given(strategy_others_list)
-async def test_other_scripts(other_scripts):
+@given(st.data())
+async def test_other_scripts(tmp_path, data):
     """Test adding other scripts."""
+    other_scripts = data.draw(st_others_list(tmp_path))
     with_others = PageGenerator(others=other_scripts).generate_index()
     scripts, encodings = get_scripts_from_html(with_others)
 
@@ -283,13 +294,13 @@ async def test_other_scripts(other_scripts):
     assert scripts[-1].endswith("kaleido_scopes.js")
 
 
-@given(
-    custom_plotly=strategy_valid_path,
-    custom_mathjax=strategy_mathjax,
-    other_scripts=strategy_others_list,
-)
-async def test_combined_overrides(custom_plotly, custom_mathjax, other_scripts):
+@given(st.data())
+async def test_combined_overrides(tmp_path, data):
     """Test combination of multiple overrides."""
+    custom_plotly = data.draw(st_valid_path(tmp_path))
+    custom_mathjax = data.draw(st_mathjax(tmp_path))
+    other_scripts = data.draw(st_others_list(tmp_path))
+
     combined = PageGenerator(
         plotly=custom_plotly,
         mathjax=custom_mathjax,

From 6f281f8090ea798434728345e3568dfe1b4553d8 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Thu, 28 Aug 2025 11:24:46 -0500
Subject: [PATCH 047/167] Supress unhelpful hypo health checks.

---
 src/py/tests/test_page_generator.py | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/src/py/tests/test_page_generator.py b/src/py/tests/test_page_generator.py
index 191777e0..5069f71c 100644
--- a/src/py/tests/test_page_generator.py
+++ b/src/py/tests/test_page_generator.py
@@ -7,7 +7,7 @@
 
 import logistro
 import pytest
-from hypothesis import given
+from hypothesis import HealthCheck, given, settings
 from hypothesis import strategies as st
 
 from kaleido import PageGenerator
@@ -236,7 +236,8 @@ async def test_mathjax_false():
 
 
 # Test user overrides
-@given(st.data())  # claude, change all further functions to this style
+@settings(suppress_health_check=[HealthCheck.function_scoped_fixture])
+@given(st.data())
 async def test_custom_plotly_url(tmp_path, data):
     """Test custom plotly URL override."""
     custom_plotly = data.draw(st_valid_path(tmp_path))
@@ -253,6 +254,7 @@ async def test_custom_plotly_url(tmp_path, data):
     assert scripts[2].endswith("kaleido_scopes.js")
 
 
+@settings(suppress_health_check=[HealthCheck.function_scoped_fixture])
 @given(st.data())
 async def test_custom_mathjax_url(tmp_path, data):
     """Test custom mathjax URL override."""
@@ -270,6 +272,7 @@ async def test_custom_mathjax_url(tmp_path, data):
     assert scripts[2].endswith("kaleido_scopes.js")
 
 
+@settings(suppress_health_check=[HealthCheck.function_scoped_fixture])
 @given(st.data())
 async def test_other_scripts(tmp_path, data):
     """Test adding other scripts."""
@@ -294,6 +297,7 @@ async def test_other_scripts(tmp_path, data):
     assert scripts[-1].endswith("kaleido_scopes.js")
 
 
+@settings(suppress_health_check=[HealthCheck.function_scoped_fixture])
 @given(st.data())
 async def test_combined_overrides(tmp_path, data):
     """Test combination of multiple overrides."""

From be01fdbf98f537d5b3b970ff37a2b0cd97da6bc9 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Thu, 28 Aug 2025 11:29:49 -0500
Subject: [PATCH 048/167] Add faster assert to prove file existence

---
 src/py/tests/test_page_generator.py | 20 ++++++++++----------
 1 file changed, 10 insertions(+), 10 deletions(-)

diff --git a/src/py/tests/test_page_generator.py b/src/py/tests/test_page_generator.py
index 5069f71c..0f2976c8 100644
--- a/src/py/tests/test_page_generator.py
+++ b/src/py/tests/test_page_generator.py
@@ -126,25 +126,25 @@ def nonexistent_file_path():
     return Path("/nonexistent/path/file.js")
 
 
-_h_url = st.tuples(
-    st.sampled_from(["s", ""]),
-    st.text(
-        min_size=1,
-        max_size=20,
-        alphabet=st.characters(whitelist_categories=("Lu", "Ll")),
-    ),
-).map(lambda x: f"http{x[0]}://example.com/{x[1]}.js")
-
-
 def st_valid_path(dir_path: Path):
     file_path = dir_path / "foo.foo"
     file_path.touch()
+    assert file_path.resolve().exists()
     _valid_file_string = str(file_path.resolve())
 
     _h_file_str = st.just(_valid_file_string)
     _h_file_path = st.just(Path(_valid_file_string))
     _h_file_uri = st.just(Path(_valid_file_string).as_uri())
 
+    _h_url = st.tuples(
+        st.sampled_from(["s", ""]),
+        st.text(
+            min_size=1,
+            max_size=20,
+            alphabet=st.characters(whitelist_categories=("Lu", "Ll")),
+        ),
+    ).map(lambda x: f"http{x[0]}://example.com/{x[1]}.js")
+
     _h_uri = st.one_of(_h_url, _h_file_str, _h_file_path, _h_file_uri)
 
     _h_encoding = st.sampled_from(["utf-8", "utf-16", "ascii", "latin1"])

From 0bca6f7887036d11023599145162d915ec410c80 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Thu, 28 Aug 2025 11:33:48 -0500
Subject: [PATCH 049/167] Add additional url parsing tool.

---
 src/py/kaleido/_page_generator.py | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/src/py/kaleido/_page_generator.py b/src/py/kaleido/_page_generator.py
index 69f287a5..0f8b1378 100644
--- a/src/py/kaleido/_page_generator.py
+++ b/src/py/kaleido/_page_generator.py
@@ -2,6 +2,7 @@
 
 from pathlib import Path
 from urllib.parse import urlparse
+from urllib.request import url2pathname
 
 import logistro
 
@@ -22,7 +23,13 @@ def _ensure_path(path: Path | str | tuple[str | Path, str]) -> None:
     _logger.debug(f"Ensuring path {path!s}")
     if urlparse(str(path)).scheme.startswith("http"):  # is url
         return
-    if not Path(urlparse(str(path)).path).exists():
+    if not Path(
+        url2pathname(
+            urlparse(
+                str(path),
+            ).path,
+        ),
+    ).exists():
         raise FileNotFoundError(f"{path!s} does not exist.")
 
 

From a76fbadc7eadd973f0d5ffe909d0cdea8e8ff91d Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Thu, 28 Aug 2025 11:38:28 -0500
Subject: [PATCH 050/167] Make special fixture for non existent file URI:

Had been generating this automatically which is unreasonable because
it doesn't actually exist and the tools to change format automatically
need it to
---
 src/py/tests/test_page_generator.py | 27 +++++++++++++++++++++------
 1 file changed, 21 insertions(+), 6 deletions(-)

diff --git a/src/py/tests/test_page_generator.py b/src/py/tests/test_page_generator.py
index 0f2976c8..28842183 100644
--- a/src/py/tests/test_page_generator.py
+++ b/src/py/tests/test_page_generator.py
@@ -120,6 +120,12 @@ def existing_file_path():
     return Path(__file__)
 
 
+@pytest.fixture
+def nonexistent_file_uri():
+    """Return path to file that doesn't exist."""
+    return Path("file:///nonexistent/path/file.js")
+
+
 @pytest.fixture
 def nonexistent_file_path():
     """Return path to file that doesn't exist."""
@@ -377,7 +383,10 @@ async def test_existing_file_path(temp_js_file):
     assert scripts_uri[2].endswith("kaleido_scopes.js")
 
 
-async def test_nonexistent_file_path_raises_error(nonexistent_file_path):
+async def test_nonexistent_file_path_raises_error(
+    nonexistent_file_path,
+    nonexistent_file_uri,
+):
     """Test that nonexistent file paths raise FileNotFoundError."""
     # Test with regular path
     with pytest.raises(FileNotFoundError):
@@ -385,10 +394,13 @@ async def test_nonexistent_file_path_raises_error(nonexistent_file_path):
 
     # Test with file:/// protocol
     with pytest.raises(FileNotFoundError):
-        PageGenerator(plotly=nonexistent_file_path.as_uri())
+        PageGenerator(plotly=nonexistent_file_uri())
 
 
-async def test_mathjax_nonexistent_file_raises_error(nonexistent_file_path):
+async def test_mathjax_nonexistent_file_raises_error(
+    nonexistent_file_path,
+    nonexistent_file_uri,
+):
     """Test that nonexistent mathjax file raises FileNotFoundError."""
     # Test with regular path
     with pytest.raises(FileNotFoundError):
@@ -396,10 +408,13 @@ async def test_mathjax_nonexistent_file_raises_error(nonexistent_file_path):
 
     # Test with file:/// protocol
     with pytest.raises(FileNotFoundError):
-        PageGenerator(mathjax=nonexistent_file_path.as_uri())
+        PageGenerator(mathjax=nonexistent_file_uri())
 
 
-async def test_others_nonexistent_file_raises_error(nonexistent_file_path):
+async def test_others_nonexistent_file_raises_error(
+    nonexistent_file_path,
+    nonexistent_file_uri,
+):
     """Test that nonexistent file in others list raises FileNotFoundError."""
     # Test with regular path
     with pytest.raises(FileNotFoundError):
@@ -407,7 +422,7 @@ async def test_others_nonexistent_file_raises_error(nonexistent_file_path):
 
     # Test with file:/// protocol
     with pytest.raises(FileNotFoundError):
-        PageGenerator(others=[nonexistent_file_path.as_uri()])
+        PageGenerator(others=[nonexistent_file_uri])
 
 
 # Test HTTP URLs (should not raise FileNotFoundError)

From 719a7fdbd8d4e2cb23dda65aa7fa5759801c5bd2 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Thu, 28 Aug 2025 11:50:42 -0500
Subject: [PATCH 051/167] Fix bad path definition

---
 src/py/tests/test_page_generator.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/py/tests/test_page_generator.py b/src/py/tests/test_page_generator.py
index 28842183..b5621733 100644
--- a/src/py/tests/test_page_generator.py
+++ b/src/py/tests/test_page_generator.py
@@ -123,7 +123,7 @@ def existing_file_path():
 @pytest.fixture
 def nonexistent_file_uri():
     """Return path to file that doesn't exist."""
-    return Path("file:///nonexistent/path/file.js")
+    return "file:///nonexistent/path/file.js"
 
 
 @pytest.fixture

From 02a1f80041fc170b18f3336d1f140c375f7fddfa Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Thu, 28 Aug 2025 11:54:18 -0500
Subject: [PATCH 052/167] Change function to str, so don't call

---
 src/py/tests/test_page_generator.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/py/tests/test_page_generator.py b/src/py/tests/test_page_generator.py
index b5621733..cfdc241b 100644
--- a/src/py/tests/test_page_generator.py
+++ b/src/py/tests/test_page_generator.py
@@ -394,7 +394,7 @@ async def test_nonexistent_file_path_raises_error(
 
     # Test with file:/// protocol
     with pytest.raises(FileNotFoundError):
-        PageGenerator(plotly=nonexistent_file_uri())
+        PageGenerator(plotly=nonexistent_file_uri)
 
 
 async def test_mathjax_nonexistent_file_raises_error(
@@ -408,7 +408,7 @@ async def test_mathjax_nonexistent_file_raises_error(
 
     # Test with file:/// protocol
     with pytest.raises(FileNotFoundError):
-        PageGenerator(mathjax=nonexistent_file_uri())
+        PageGenerator(mathjax=nonexistent_file_uri)
 
 
 async def test_others_nonexistent_file_raises_error(

From cfb4effc9133f2d64e5281ff7214801e10250353 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Thu, 28 Aug 2025 12:06:00 -0500
Subject: [PATCH 053/167] Be more explicit in path parsing.

---
 src/py/kaleido/_page_generator.py | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/src/py/kaleido/_page_generator.py b/src/py/kaleido/_page_generator.py
index 0f8b1378..cf7ff6e4 100644
--- a/src/py/kaleido/_page_generator.py
+++ b/src/py/kaleido/_page_generator.py
@@ -21,15 +21,15 @@ def _ensure_path(path: Path | str | tuple[str | Path, str]) -> None:
     if isinstance(path, tuple):
         path = path[0]
     _logger.debug(f"Ensuring path {path!s}")
-    if urlparse(str(path)).scheme.startswith("http"):  # is url
+    parsed = urlparse(str(path))
+    if parsed.scheme.startswith("http"):  # is url
         return
-    if not Path(
-        url2pathname(
-            urlparse(
-                str(path),
-            ).path,
-        ),
-    ).exists():
+    elif (
+        parsed.scheme.startswith("file")
+        and not Path(url2pathname(parsed.path)).exists()
+    ):
+        raise FileNotFoundError(f"{path!s} does not exist.")
+    if not Path(path):
         raise FileNotFoundError(f"{path!s} does not exist.")
 
 

From f9e7f6497fbe322448d21e13f0cd03e07f84553f Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Thu, 28 Aug 2025 12:10:46 -0500
Subject: [PATCH 054/167] Add missing function.

---
 src/py/kaleido/_page_generator.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/py/kaleido/_page_generator.py b/src/py/kaleido/_page_generator.py
index cf7ff6e4..704f5597 100644
--- a/src/py/kaleido/_page_generator.py
+++ b/src/py/kaleido/_page_generator.py
@@ -29,7 +29,7 @@ def _ensure_path(path: Path | str | tuple[str | Path, str]) -> None:
         and not Path(url2pathname(parsed.path)).exists()
     ):
         raise FileNotFoundError(f"{path!s} does not exist.")
-    if not Path(path):
+    if not Path(path).exists():
         raise FileNotFoundError(f"{path!s} does not exist.")
 
 

From 69294ed8508d407853b286565ec79d44b3762dc8 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Thu, 28 Aug 2025 12:16:17 -0500
Subject: [PATCH 055/167] Add logging.

---
 src/py/kaleido/_page_generator.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/src/py/kaleido/_page_generator.py b/src/py/kaleido/_page_generator.py
index 704f5597..9c991e71 100644
--- a/src/py/kaleido/_page_generator.py
+++ b/src/py/kaleido/_page_generator.py
@@ -26,8 +26,9 @@ def _ensure_path(path: Path | str | tuple[str | Path, str]) -> None:
         return
     elif (
         parsed.scheme.startswith("file")
-        and not Path(url2pathname(parsed.path)).exists()
+        and not (_p := Path(url2pathname(parsed.path))).exists()
     ):
+        _logger.error(f"File parsed to: {_p}")
         raise FileNotFoundError(f"{path!s} does not exist.")
     if not Path(path).exists():
         raise FileNotFoundError(f"{path!s} does not exist.")

From 5407965e6752c5abe5fdbe91c1fa6d7deddcb8cf Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Thu, 28 Aug 2025 12:23:13 -0500
Subject: [PATCH 056/167] Add yet more logging.

---
 src/py/kaleido/_page_generator.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/src/py/kaleido/_page_generator.py b/src/py/kaleido/_page_generator.py
index 9c991e71..676dd7a4 100644
--- a/src/py/kaleido/_page_generator.py
+++ b/src/py/kaleido/_page_generator.py
@@ -22,6 +22,7 @@ def _ensure_path(path: Path | str | tuple[str | Path, str]) -> None:
         path = path[0]
     _logger.debug(f"Ensuring path {path!s}")
     parsed = urlparse(str(path))
+    _logger.debug(f"Parsed file path: {parsed}")
     if parsed.scheme.startswith("http"):  # is url
         return
     elif (

From 33ead6dba5efa9684c343e752cb2024d188d4bb3 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Thu, 28 Aug 2025 12:31:29 -0500
Subject: [PATCH 057/167] Fix bad logic.

---
 src/py/kaleido/_page_generator.py | 13 ++++++-------
 1 file changed, 6 insertions(+), 7 deletions(-)

diff --git a/src/py/kaleido/_page_generator.py b/src/py/kaleido/_page_generator.py
index 676dd7a4..156853c1 100644
--- a/src/py/kaleido/_page_generator.py
+++ b/src/py/kaleido/_page_generator.py
@@ -25,14 +25,13 @@ def _ensure_path(path: Path | str | tuple[str | Path, str]) -> None:
     _logger.debug(f"Parsed file path: {parsed}")
     if parsed.scheme.startswith("http"):  # is url
         return
-    elif (
-        parsed.scheme.startswith("file")
-        and not (_p := Path(url2pathname(parsed.path))).exists()
-    ):
+    elif parsed.scheme.startswith("file"):
+        if (_p := Path(url2pathname(parsed.path))).exists():
+            return
         _logger.error(f"File parsed to: {_p}")
-        raise FileNotFoundError(f"{path!s} does not exist.")
-    if not Path(path).exists():
-        raise FileNotFoundError(f"{path!s} does not exist.")
+    elif Path(path).exists():
+        return
+    raise FileNotFoundError(f"{path!s} does not exist.")
 
 
 class PageGenerator:

From 449282bfca6e8ee8f43d5f464660087007ec52be Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Thu, 28 Aug 2025 12:47:47 -0500
Subject: [PATCH 058/167] Tone down unreasonable 20 processor test.

---
 src/py/tests/test_kaleido.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/py/tests/test_kaleido.py b/src/py/tests/test_kaleido.py
index 24a4fe1c..6c83dbab 100644
--- a/src/py/tests/test_kaleido.py
+++ b/src/py/tests/test_kaleido.py
@@ -312,7 +312,7 @@ async def test_all_methods_non_context(simple_figure_with_bytes, tmp_path):
         await k.close()
 
 
-@pytest.mark.parametrize("n_tabs", [1, 5, 20])
+@pytest.mark.parametrize("n_tabs", [1, 3, 7])
 async def test_tab_count_verification(n_tabs):
     """Test that Kaleido creates the correct number of tabs."""
     async with Kaleido(n=n_tabs) as k:

From 62fcefea0f26a7cee94538c57b01c6cdaa43b2ad Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Thu, 28 Aug 2025 12:55:42 -0500
Subject: [PATCH 059/167] Remove hypo deadlines for slow CI runners.

---
 src/py/tests/conftest.py | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/src/py/tests/conftest.py b/src/py/tests/conftest.py
index 501f3377..8b298cef 100644
--- a/src/py/tests/conftest.py
+++ b/src/py/tests/conftest.py
@@ -1,10 +1,19 @@
 import logging
+import os
+import platform
 
 import logistro
 import pytest
+from hypothesis import HealthCheck, settings
 
 _logger = logistro.getLogger(__name__)
 
+settings.register_profile(
+    "ci",
+    deadline=None,  # no per-example deadline
+    suppress_health_check=(HealthCheck.too_slow,),  # avoid flaky "too slow" on CI
+)
+
 
 # pytest shuts down its capture before logging/threads finish
 @pytest.fixture(scope="session", autouse=True)
@@ -19,3 +28,8 @@ def cleanup_logging_handlers(request):
                 handler.flush()
                 if isinstance(handler, logging.StreamHandler):
                     logging.root.removeHandler(handler)
+
+
+is_ci = os.getenv("GITHUB_ACTIONS") == "true" or os.getenv("CI") == "true"
+if is_ci and platform.system in {"Windows", "Darwin"}:
+    settings.load_profile("ci")

From 501fb806fb7f8818a7b2facddff9c5f151cf3d42 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Thu, 28 Aug 2025 16:55:52 -0500
Subject: [PATCH 060/167] Organize a bit conftest.py

---
 src/py/tests/conftest.py | 14 +++++++++-----
 1 file changed, 9 insertions(+), 5 deletions(-)

diff --git a/src/py/tests/conftest.py b/src/py/tests/conftest.py
index 8b298cef..8d4f32fd 100644
--- a/src/py/tests/conftest.py
+++ b/src/py/tests/conftest.py
@@ -8,12 +8,21 @@
 
 _logger = logistro.getLogger(__name__)
 
+# we turn off deadlines for macs and windows in CI
+# i'm under the impression that they are resource limited
+# and delays are often caused by sharing resources with other
+# virtualization neighbors.
+
 settings.register_profile(
     "ci",
     deadline=None,  # no per-example deadline
     suppress_health_check=(HealthCheck.too_slow,),  # avoid flaky "too slow" on CI
 )
 
+is_ci = os.getenv("GITHUB_ACTIONS") == "true" or os.getenv("CI") == "true"
+if is_ci and platform.system in {"Windows", "Darwin"}:
+    settings.load_profile("ci")
+
 
 # pytest shuts down its capture before logging/threads finish
 @pytest.fixture(scope="session", autouse=True)
@@ -28,8 +37,3 @@ def cleanup_logging_handlers(request):
                 handler.flush()
                 if isinstance(handler, logging.StreamHandler):
                     logging.root.removeHandler(handler)
-
-
-is_ci = os.getenv("GITHUB_ACTIONS") == "true" or os.getenv("CI") == "true"
-if is_ci and platform.system in {"Windows", "Darwin"}:
-    settings.load_profile("ci")

From 01952f445dcbe2500e5c5a7a0883b756504497fc Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Thu, 28 Aug 2025 20:11:52 -0500
Subject: [PATCH 061/167] Organize fig_tools a bit.

---
 src/py/kaleido/_fig_tools.py | 76 ++++++++++++++++++++++--------------
 1 file changed, 46 insertions(+), 30 deletions(-)

diff --git a/src/py/kaleido/_fig_tools.py b/src/py/kaleido/_fig_tools.py
index f0966bb9..ab7d111d 100644
--- a/src/py/kaleido/_fig_tools.py
+++ b/src/py/kaleido/_fig_tools.py
@@ -1,3 +1,9 @@
+"""
+Adapted from old code, it 1. validates, 2. write defaults, 3. packages object.
+
+Its a bit complicated and mixed in order.
+"""
+
 from __future__ import annotations
 
 import glob
@@ -82,7 +88,7 @@ def _get_format(extension: str) -> FormatString:
     return formatted_extension
 
 
-# Input of to_spec
+# Input of to_spec (user gives us this)
 class LayoutOpts(TypedDict, total=False):
     format: FormatString | None
     scale: int | float
@@ -90,7 +96,8 @@ class LayoutOpts(TypedDict, total=False):
     width: int | float
 
 
-# Output of to_spec
+# Output of to_spec (we give kaleido_scopes.js this)
+# refactor note: this could easily be right before send
 class Spec(TypedDict):
     format: FormatString
     width: int | float
@@ -99,6 +106,7 @@ class Spec(TypedDict):
     data: Figurish
 
 
+# validate configuration options for kaleido.js and package like its wants
 def to_spec(figure: Figurish, layout_opts: LayoutOpts) -> Spec:
     # Get figure layout
     layout = figure.get("layout", {})
@@ -133,6 +141,7 @@ def to_spec(figure: Figurish, layout_opts: LayoutOpts) -> Spec:
     }
 
 
+# if we need to suffix the filename automatically:
 def _next_filename(path: Path | str, prefix: str, ext: str) -> str:
     path = path if isinstance(path, Path) else Path(path)
     default = 1 if (path / f"{prefix}.{ext}").exists() else 0
@@ -150,36 +159,12 @@ def _next_filename(path: Path | str, prefix: str, ext: str) -> str:
     return f"{prefix}.{ext}" if n == 1 else f"{prefix}-{n}.{ext}"
 
 
-def build_fig_spec(  #  noqa: C901, PLR0912
-    fig: Figurish,
-    path: Path | str | None,
-    opts: LayoutOpts | None,
-) -> tuple[Spec, Path]:
-    if not opts:
-        opts = {}
-
-    if not _is_figurish(fig):
-        raise TypeError("Figure supplied doesn't seem to be a valid plotly figure.")
-
-    if hasattr(fig, "to_dict"):
-        fig = fig.to_dict()
-
-    if isinstance(path, str):
-        path = Path(path)
-    elif path and not isinstance(path, Path):
-        raise TypeError("Path should be a string or `pathlib.Path` object (or None)")
-
-    if path and path.suffix and not opts.get("format"):
-        ext = path.suffix.lstrip(".")
-        if _assert_format(ext):  # not strict necessary if but helps typeguard
-            opts["format"] = ext
-
-    spec = to_spec(fig, opts)
-
-    ext = spec["format"]
-
+# validate and build full route if needed:
+def _build_full_path(path, fig, ext):
     full_path: Path | None = None
+
     directory: Path
+
     if not path:
         directory = Path()  # use current Path
     elif path and (not path.suffix or path.is_dir()):
@@ -192,6 +177,7 @@ def build_fig_spec(  #  noqa: C901, PLR0912
             raise RuntimeError(
                 f"Cannot reach path {path.parent}. Are all directories created?",
             )
+
     if not full_path:
         _logger.debug("Looking for title")
         prefix = fig.get("layout", {}).get("title", {}).get("text", "fig")
@@ -202,4 +188,34 @@ def build_fig_spec(  #  noqa: C901, PLR0912
         name = _next_filename(directory, prefix, ext)
         full_path = directory / name
 
+
+# call all validators/automatic config fill-in/packaging in expected format
+def build_fig_spec(
+    fig: Figurish,
+    path: Path | str | None,
+    opts: LayoutOpts | None,
+) -> tuple[Spec, Path]:
+    if not opts:
+        opts = {}
+
+    if not _is_figurish(fig):
+        raise TypeError("Figure supplied doesn't seem to be a valid plotly figure.")
+
+    if hasattr(fig, "to_dict"):
+        fig = fig.to_dict()
+
+    if isinstance(path, str):
+        path = Path(path)
+    elif path and not isinstance(path, Path):
+        raise TypeError("Path should be a string or `pathlib.Path` object (or None)")
+
+    if not opts.get("format") and path and path.suffix:
+        ext = path.suffix.lstrip(".")
+        if _assert_format(ext):  # not strict necessary if but helps typeguard
+            opts["format"] = ext
+
+    full_path = _build_full_path(path, fig, ext)
+
+    spec = to_spec(fig, opts)
+
     return spec, full_path

From d69d1b2bc354e7b05410aa4fb14f0bb445a4aa3e Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Thu, 28 Aug 2025 20:24:44 -0500
Subject: [PATCH 062/167] Fix order

---
 src/py/kaleido/_fig_tools.py | 12 +++++++++---
 1 file changed, 9 insertions(+), 3 deletions(-)

diff --git a/src/py/kaleido/_fig_tools.py b/src/py/kaleido/_fig_tools.py
index ab7d111d..30701808 100644
--- a/src/py/kaleido/_fig_tools.py
+++ b/src/py/kaleido/_fig_tools.py
@@ -125,6 +125,7 @@ def to_spec(figure: Figurish, layout_opts: LayoutOpts) -> Spec:
 
     # Extract info
     extension = _get_format(layout_opts.get("format") or DEFAULT_EXT)
+
     width, height = _get_figure_dimensions(
         layout,
         layout_opts.get("width"),
@@ -160,7 +161,11 @@ def _next_filename(path: Path | str, prefix: str, ext: str) -> str:
 
 
 # validate and build full route if needed:
-def _build_full_path(path, fig, ext):
+def _build_full_path(
+    path: Path | None,
+    fig: Figurish,
+    ext: FormatString,
+) -> Path:
     full_path: Path | None = None
 
     directory: Path
@@ -187,6 +192,7 @@ def _build_full_path(path, fig, ext):
         _logger.debug(f"Found: {prefix}")
         name = _next_filename(directory, prefix, ext)
         full_path = directory / name
+    return full_path
 
 
 # call all validators/automatic config fill-in/packaging in expected format
@@ -214,8 +220,8 @@ def build_fig_spec(
         if _assert_format(ext):  # not strict necessary if but helps typeguard
             opts["format"] = ext
 
-    full_path = _build_full_path(path, fig, ext)
-
     spec = to_spec(fig, opts)
 
+    full_path = _build_full_path(path, fig, spec["format"])
+
     return spec, full_path

From f65f0ecc15ef1158954db5a3169961535c32a386 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Thu, 28 Aug 2025 20:44:54 -0500
Subject: [PATCH 063/167] Readd figtools tests.

---
 src/py/tests/test_fig_tools.py | 133 +++++++++++++++++++++++++++++++++
 1 file changed, 133 insertions(+)
 create mode 100644 src/py/tests/test_fig_tools.py

diff --git a/src/py/tests/test_fig_tools.py b/src/py/tests/test_fig_tools.py
new file mode 100644
index 00000000..14c53c6a
--- /dev/null
+++ b/src/py/tests/test_fig_tools.py
@@ -0,0 +1,133 @@
+import pytest
+
+from kaleido import _fig_tools
+
+sources = ["argument", "layout", "template", "default"]
+values = [None, 150, 800, 1500]
+
+
+@pytest.mark.parametrize("width_source", sources)
+@pytest.mark.parametrize("height_source", sources)
+@pytest.mark.parametrize("width_value", values)
+@pytest.mark.parametrize("height_value", [x * 1.5 if x else x for x in values])
+def test_get_figure_dimensions(width_source, height_source, width_value, height_value):
+    """Test _get_figure_dimensions with all combinations of width/height sources."""
+
+    layout = {}
+    width_arg = None
+    expected_width = width_value
+
+    if width_source == "argument":
+        width_arg = width_value
+    elif width_source == "layout":
+        layout["width"] = width_value
+    elif width_source == "template":
+        layout.setdefault("template", {}).setdefault("layout", {})["width"] = (
+            width_value
+        )
+    else:  # default
+        expected_width = None
+
+    # Set to default if None
+    if expected_width is None:
+        expected_width = _fig_tools.DEFAULT_WIDTH
+
+    # Do for height what I did for width
+    height_arg = None
+    expected_height = height_value
+
+    if height_source == "argument":
+        height_arg = height_value
+    elif height_source == "layout":
+        layout["height"] = height_value
+    elif height_source == "template":
+        layout.setdefault("template", {}).setdefault("layout", {})["height"] = (
+            height_value
+        )
+    else:  # default
+        expected_height = None
+
+    # Set to default if None
+    if expected_height is None:
+        expected_height = _fig_tools.DEFAULT_HEIGHT
+
+    # Call the function
+    r_width, r_height = _fig_tools._get_figure_dimensions(  # noqa: SLF001
+        layout,
+        width_arg,
+        height_arg,
+    )
+
+    # Assert results
+    assert r_width == expected_width, (
+        f"Width mismatch: got {r_width}, expected {expected_width}, "
+        f"source: {width_source}, value: {width_value}"
+    )
+    assert r_height == expected_height, (
+        f"Height mismatch: got {r_height}, expected {expected_height}, "
+        f"source: {height_source}, value: {height_value}"
+    )
+
+
+def test_next_filename_no_existing_files(tmp_path):
+    """Test _next_filename when no files exist."""
+    result = _fig_tools._next_filename(tmp_path, "test", "png")  # noqa: SLF001
+    assert result == "test.png"
+
+
+def test_next_filename_base_file_exists(tmp_path):
+    """Test _next_filename when base file exists."""
+    # Create the base file
+    (tmp_path / "test.png").touch()
+
+    result = _fig_tools._next_filename(tmp_path, "test", "png")  # noqa: SLF001
+    assert result == "test-2.png"
+
+
+def test_next_filename_numbered_files_exist(tmp_path):
+    """Test _next_filename when numbered files exist."""
+    # Create various numbered files
+    (tmp_path / "test.png").touch()
+    (tmp_path / "test-2.png").touch()
+    (tmp_path / "test-3.png").touch()
+    (tmp_path / "test-5.png").touch()  # Gap in numbering
+
+    result = _fig_tools._next_filename(tmp_path, "test", "png")  # noqa: SLF001
+    assert result == "test-6.png"  # Should be max + 1
+
+
+def test_next_filename_similar_names_ignored(tmp_path):
+    """Test _next_filename ignores files with similar but different names."""
+    # Create files that shouldn't match the pattern
+    (tmp_path / "test.png").touch()
+    (tmp_path / "test-2.png").touch()
+    (tmp_path / "testing-3.png").touch()  # Different prefix
+    (tmp_path / "test-2.jpg").touch()  # Different extension
+    (tmp_path / "test-abc.png").touch()  # Non-numeric suffix
+
+    result = _fig_tools._next_filename(tmp_path, "test", "png")  # noqa: SLF001
+    assert result == "test-3.png"  # Should only count test.png and test-2.png
+
+
+def test_next_filename_special_characters(tmp_path):
+    """Test _next_filename with special characters in prefix and extension."""
+    prefix = "test-file_name"
+    ext = "svg"  # set up to be parameterized but not
+
+    # Create some files
+    (tmp_path / f"{prefix}.{ext}").touch()
+    (tmp_path / f"{prefix}-2.{ext}").touch()
+
+    result = _fig_tools._next_filename(tmp_path, prefix, ext)  # noqa: SLF001
+    assert result == f"{prefix}-3.{ext}"
+
+
+def test_next_filename_only_numbered_files(tmp_path):
+    """Test _next_filename when only numbered files exist (no base file)."""
+    # Create only numbered files, no base file
+    (tmp_path / "test-2.png").touch()
+    (tmp_path / "test-3.png").touch()
+    (tmp_path / "test-10.png").touch()
+
+    result = _fig_tools._next_filename(tmp_path, "test", "png")  # noqa: SLF001
+    assert result == "test-11.png"  # Should be max + 1

From 336f479b087dd5130bcf61dba877df08cbbf29e9 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Fri, 29 Aug 2025 12:25:03 -0500
Subject: [PATCH 064/167] Iterate on claude tests.

---
 src/py/tests/test_fig_tools.py | 90 ++++++++++++++++++++++++++++++++++
 1 file changed, 90 insertions(+)

diff --git a/src/py/tests/test_fig_tools.py b/src/py/tests/test_fig_tools.py
index 14c53c6a..730898c4 100644
--- a/src/py/tests/test_fig_tools.py
+++ b/src/py/tests/test_fig_tools.py
@@ -1,3 +1,5 @@
+from pathlib import Path
+
 import pytest
 
 from kaleido import _fig_tools
@@ -131,3 +133,91 @@ def test_next_filename_only_numbered_files(tmp_path):
 
     result = _fig_tools._next_filename(tmp_path, "test", "png")  # noqa: SLF001
     assert result == "test-11.png"  # Should be max + 1
+
+
+# Fixtures for _build_full_path tests - testing various title scenarios
+@pytest.fixture(
+    params=[
+        (
+            {
+                "layout": {
+                    "title": {"text": "My-Test!@#$%^&*()Chart_with[lots]of{symbols}"},
+                },
+            },
+            "My_TestChart_withlotsof_symbols",
+        ),  # Complex title
+        (
+            {"layout": {"title": {"text": "Simple Title"}}},
+            "Simple_Title",
+        ),  # Simple title
+        ({"layout": {}}, "fig"),  # No title
+    ],
+)
+def fig_fixture(request):
+    """Parameterized fixture for fig with various title scenarios."""
+    return request.param
+
+
+def test_build_full_path_no_path_input(fig_fixture):
+    """Test _build_full_path with no path input uses current path."""
+    fig_dict, expected_prefix = fig_fixture
+    result = _fig_tools._build_full_path(None, fig_dict, "ext")  # noqa: SLF001
+
+    # Should use current directory
+    assert result.parent == Path().cwd()
+    assert result.parent.is_dir()
+
+    assert result.name == f"{expected_prefix}.ext"
+
+
+def test_build_full_path_no_suffix_directory(tmp_path, fig_fixture):
+    """Test _build_full_path with path having no suffix."""
+    fig_dict, expected_prefix = fig_fixture
+
+    # Test directory no suffix
+    test_dir = tmp_path
+    result = _fig_tools._build_full_path(test_dir, fig_dict, "ext")  # noqa: SLF001
+
+    # Should use provided directory
+    assert result.parent == test_dir
+    assert result.name == f"{expected_prefix}.ext"
+
+    # Test error
+    nonexistent_dir = Path("/nonexistent/directory")
+    with pytest.raises(ValueError, match="Directory .* not found. Please create it."):
+        _fig_tools._build_full_path(nonexistent_dir, fig_dict, "ext")  # noqa: SLF001
+
+
+def test_build_full_path_directory_with_suffix(tmp_path, fig_fixture):
+    """Test _build_full_path with path that is directory even with suffix."""
+    fig_dict, expected_prefix = fig_fixture
+
+    # Create a directory with a suffix-like name
+    dir_with_suffix = tmp_path / "mydir.png"
+    dir_with_suffix.mkdir()
+
+    result = _fig_tools._build_full_path(dir_with_suffix, fig_dict, "ext")  # noqa: SLF001
+
+    # Should treat as directory
+    assert result.parent == dir_with_suffix
+    assert result.name == f"{expected_prefix}.ext"
+
+
+def test_build_full_path_file_with_suffix(tmp_path, fig_fixture):
+    """Test _build_full_path with file path having suffix."""
+    fig_dict, expected_prefix = fig_fixture
+
+    # Exists
+    file_path = tmp_path / "output.png"
+    result = _fig_tools._build_full_path(file_path, fig_dict, "ext")  # noqa: SLF001
+
+    # Should return the exact path provided
+    assert result == file_path
+
+    # Doesn't exist
+    file_path = Path("/nonexistent/directory/output.png")
+    with pytest.raises(
+        RuntimeError,
+        match="Cannot reach path .* Are all directories created?",
+    ):
+        _fig_tools._build_full_path(file_path, fig_dict, "ext")  # noqa: SLF001

From c1a2f9945ebfe40037ddd225fffcc8b99c8f274e Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Fri, 29 Aug 2025 12:27:44 -0500
Subject: [PATCH 065/167] All tests pass

---
 src/py/tests/test_fig_tools.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/py/tests/test_fig_tools.py b/src/py/tests/test_fig_tools.py
index 730898c4..135a7c89 100644
--- a/src/py/tests/test_fig_tools.py
+++ b/src/py/tests/test_fig_tools.py
@@ -144,7 +144,7 @@ def test_next_filename_only_numbered_files(tmp_path):
                     "title": {"text": "My-Test!@#$%^&*()Chart_with[lots]of{symbols}"},
                 },
             },
-            "My_TestChart_withlotsof_symbols",
+            "My_TestChart_withlotsofsymbols",
         ),  # Complex title
         (
             {"layout": {"title": {"text": "Simple Title"}}},
@@ -164,7 +164,7 @@ def test_build_full_path_no_path_input(fig_fixture):
     result = _fig_tools._build_full_path(None, fig_dict, "ext")  # noqa: SLF001
 
     # Should use current directory
-    assert result.parent == Path().cwd()
+    assert result.parent.resolve() == Path().cwd().resolve()
     assert result.parent.is_dir()
 
     assert result.name == f"{expected_prefix}.ext"

From b8f7185195491ba05c4754e6ff372daee74c95a1 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Fri, 29 Aug 2025 13:26:43 -0500
Subject: [PATCH 066/167] Clear up mathjax logic.

---
 src/py/kaleido/_page_generator.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/src/py/kaleido/_page_generator.py b/src/py/kaleido/_page_generator.py
index 156853c1..87613bac 100644
--- a/src/py/kaleido/_page_generator.py
+++ b/src/py/kaleido/_page_generator.py
@@ -64,7 +64,7 @@ class PageGenerator:
 """
     """The footer is the HTML that always goes on the bottom. Rarely needs changing."""
 
-    def __init__(
+    def __init__(  # noqa: C901
         self,
         *,
         plotly: None | Path | str | tuple[Path | str, str] = None,
@@ -88,9 +88,9 @@ def __init__(
         """
         self._scripts = []
         if mathjax is not False:
-            if not mathjax or mathjax is True:
+            if mathjax is None or mathjax is True:
                 mathjax = DEFAULT_MATHJAX
-            else:
+            elif mathjax:
                 _ensure_path(mathjax)
             self._scripts.append(mathjax)
         if force_cdn:

From 970f8b825e3fb11fb81fc568b63acd34fe71b5f7 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Fri, 29 Aug 2025 13:35:30 -0500
Subject: [PATCH 067/167] Test Path() as well as str() in filenotfound tests.

---
 src/py/tests/test_page_generator.py | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/src/py/tests/test_page_generator.py b/src/py/tests/test_page_generator.py
index cfdc241b..e213d6a9 100644
--- a/src/py/tests/test_page_generator.py
+++ b/src/py/tests/test_page_generator.py
@@ -392,6 +392,9 @@ async def test_nonexistent_file_path_raises_error(
     with pytest.raises(FileNotFoundError):
         PageGenerator(plotly=str(nonexistent_file_path))
 
+    with pytest.raises(FileNotFoundError):
+        PageGenerator(plotly=Path(nonexistent_file_path))
+
     # Test with file:/// protocol
     with pytest.raises(FileNotFoundError):
         PageGenerator(plotly=nonexistent_file_uri)
@@ -406,6 +409,9 @@ async def test_mathjax_nonexistent_file_raises_error(
     with pytest.raises(FileNotFoundError):
         PageGenerator(mathjax=str(nonexistent_file_path))
 
+    with pytest.raises(FileNotFoundError):
+        PageGenerator(mathjax=nonexistent_file_path)
+
     # Test with file:/// protocol
     with pytest.raises(FileNotFoundError):
         PageGenerator(mathjax=nonexistent_file_uri)
@@ -420,6 +426,9 @@ async def test_others_nonexistent_file_raises_error(
     with pytest.raises(FileNotFoundError):
         PageGenerator(others=[str(nonexistent_file_path)])
 
+    with pytest.raises(FileNotFoundError):
+        PageGenerator(others=[nonexistent_file_path])
+
     # Test with file:/// protocol
     with pytest.raises(FileNotFoundError):
         PageGenerator(others=[nonexistent_file_uri])

From 7c7073771a798a1a68b5b8dc846b3f1edf5f2663 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Fri, 29 Aug 2025 14:02:18 -0500
Subject: [PATCH 068/167] Fix to properly validate Path() types

---
 src/py/kaleido/_page_generator.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/py/kaleido/_page_generator.py b/src/py/kaleido/_page_generator.py
index 87613bac..34b4064e 100644
--- a/src/py/kaleido/_page_generator.py
+++ b/src/py/kaleido/_page_generator.py
@@ -118,7 +118,7 @@ def __init__(  # noqa: C901
             except ImportError:
                 _logger.info("Plotly not installed. Using CDN.")
                 plotly = (DEFAULT_PLOTLY, "utf-8")
-        elif isinstance(plotly, str):
+        elif isinstance(plotly, (str, Path)):
             _ensure_path(plotly)
             plotly = (plotly, "utf-8")
         _logger.debug(f"Plotly script: {plotly}")

From 9e9b9b38e604b74fcd33173df297869518a1ce08 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Fri, 29 Aug 2025 15:01:13 -0500
Subject: [PATCH 069/167] Add tests for test_sync_server.

---
 src/py/tests/test_sync_server.py | 93 ++++++++++++++++++++++++++++++++
 1 file changed, 93 insertions(+)
 create mode 100644 src/py/tests/test_sync_server.py

diff --git a/src/py/tests/test_sync_server.py b/src/py/tests/test_sync_server.py
new file mode 100644
index 00000000..115c0281
--- /dev/null
+++ b/src/py/tests/test_sync_server.py
@@ -0,0 +1,93 @@
+import pytest
+
+from kaleido._sync_server import GlobalKaleidoServer
+
+
+class TestGlobalKaleidoServer:
+    """Test the GlobalKaleidoServer singleton class."""
+
+    def test_singleton_behavior(self):
+        """Test that creating the object twice returns the same instance."""
+        # Should be the same object
+        assert GlobalKaleidoServer() is GlobalKaleidoServer()
+
+    def test_is_running_open_close_cycle(self):
+        """Test is_running, open, and close in a loop three times."""
+        server = GlobalKaleidoServer()
+
+        # Initial state should be not running
+        assert not server.is_running()
+
+        for i in range(2):
+            # Check not running
+            assert not server.is_running(), (
+                f"Iteration {i}: Should not be running initially"
+            )
+
+            server.open()
+
+            # Check is running
+            assert server.is_running(), f"Iteration {i}: Should be running after open"
+
+            # Call open again - should warn
+            with pytest.warns(RuntimeWarning, match="Server already open"):
+                server.open()
+
+            server.open(silence_warnings=True)
+            server.close()
+
+            # Call close again - should warn
+            with pytest.warns(RuntimeWarning, match="Server already closed"):
+                server.close()
+
+            server.close(silence_warnings=True)
+
+            # Check not running
+            assert not server.is_running(), (
+                f"Iteration {i}: Should not be running after close"
+            )
+
+    def test_call_function_when_not_running_raises_error(self):
+        """Test that calling function when server is not running raises RuntimeError."""
+        server = GlobalKaleidoServer()
+
+        # Ensure server is closed
+        if server.is_running():
+            server.close(silence_warnings=True)
+
+        # Should raise RuntimeError
+        with pytest.raises(RuntimeError, match="Can't call function on stopped server"):
+            server.call_function("some_function")
+
+    def test_getattr_call_function_integration(self):
+        """Test __getattr__ integration with call_function."""
+        server = GlobalKaleidoServer()
+        method_name = "random_method"
+        test_args = ("arg1", "arg2")
+        test_kwargs = {"kwarg1": "value1"}
+
+        def method_checker(_self, name):
+            assert name == method_name
+
+            def dummy_method(*args, **kwargs):
+                assert args == test_args
+                assert kwargs == test_kwargs
+
+            return dummy_method
+
+        # Temporarily add __getattr__ to the class
+        GlobalKaleidoServer.__getattr__ = method_checker
+
+        try:
+            # Call a random method with some args and kwargs
+            server.random_method(*test_args, **test_kwargs)
+
+        finally:
+            # Clean up - remove __getattr__ from the class
+            delattr(GlobalKaleidoServer, "__getattr__")
+
+    def teardown_method(self):
+        """Clean up after each test."""
+        server = GlobalKaleidoServer()
+        if server.is_running():
+            server.close(silence_warnings=True)

From 88533f1b9f604e1c55315e8dd20bcae648d1709c Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Fri, 29 Aug 2025 15:05:42 -0500
Subject: [PATCH 070/167] Fix CHANGELOG.txt

---
 src/py/CHANGELOG.txt | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/src/py/CHANGELOG.txt b/src/py/CHANGELOG.txt
index f9b79007..5527f5d0 100644
--- a/src/py/CHANGELOG.txt
+++ b/src/py/CHANGELOG.txt
@@ -1,4 +1,13 @@
+- Add testing
+- Fix a variety of type bugs
+- Change order of browser closer to fix hang
+- Explicitly handle certain argument options better
+- Move temp file creation to .open() out of __init__()
+- Reduce mathjax version to plotly.py
+- Fix hang and add automatic close with stop_sync_server
+- Add option to silence warnings in start/stop_sync_server
 - Fix bug where attribute was inconsistently named
+
 v1.1.0rc0
 - Improve verbosity of errors when starting kaleido improperly
 - Add new api functions start/stop_sync_server

From 7dceec2649f5235c31f175bb2fedd934e5f42598 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Mon, 1 Sep 2025 17:23:36 -0500
Subject: [PATCH 071/167] Do basic type fixing.

---
 src/py/kaleido/kaleido.py | 49 +++++++++++++++++++++------------------
 1 file changed, 27 insertions(+), 22 deletions(-)

diff --git a/src/py/kaleido/kaleido.py b/src/py/kaleido/kaleido.py
index fffae8b3..69d1028b 100644
--- a/src/py/kaleido/kaleido.py
+++ b/src/py/kaleido/kaleido.py
@@ -3,9 +3,9 @@
 from __future__ import annotations
 
 import asyncio
-from collections.abc import AsyncIterable, Iterable, TypedDict
+from collections.abc import AsyncIterable, Iterable
 from pathlib import Path
-from typing import TYPE_CHECKING
+from typing import TYPE_CHECKING, TypedDict
 from urllib.parse import unquote, urlparse
 
 import choreographer as choreo
@@ -26,13 +26,18 @@
 
 if TYPE_CHECKING:
     from types import TracebackType
-    from typing import Any, Union
+    from typing import Any, List, Tuple, TypeVar, Union, ValuesView
 
-    from typing_extension import NotRequired, Required
+    from typing_extensions import NotRequired, Required, TypeAlias
 
     from . import _fig_tools
 
-    AnyIterable = Union[Iterable, AsyncIterable]  # not runtime
+    T = TypeVar("T")
+    AnyIterable: TypeAlias = Union[Iterable[T], AsyncIterable[T]]  # not runtime
+
+    # union of sized iterables since 3.8 doesn't have & operator
+    # Iterable & Sized
+    Listish: TypeAlias = Union[Tuple[T], List[T], ValuesView[T]]
 
 
 class Kaleido(choreo.Browser):
@@ -112,13 +117,13 @@ async def open(self):
             page.generate_index(index)
         await super().open()
 
-    async def _conform_tabs(self, tabs: list[choreo.Tab] | None = None) -> None:
-        _logger.info(f"Conforming {len(tabs)} to {self._index}")
+    async def _conform_tabs(self, tabs: Listish[choreo.Tab] | None = None) -> None:
         if not tabs:
-            tabs = list(self.tabs.values())
+            tabs = self.tabs.values()
+        _logger.info(f"Conforming {len(tabs)} to {self._index}")
         for i, tab in enumerate(tabs):
             _logger.debug2(f"Subscribing * to tab: {tab}.")
-            tab.subscribe("*", _utils.make_printer(f"tab-{i!s} event"))
+            tab.subscribe("*", _utils.event_printer(f"tab-{i!s}: Event Dump:"))
 
         kaleido_tabs = [_KaleidoTab(tab, _stepper=self._stepper) for tab in tabs]
 
@@ -136,7 +141,7 @@ async def populate_targets(self) -> None:
         once ever per object.
         """
         await super().populate_targets()
-        await self._conform_tabs(self.tabs.values())
+        await self._conform_tabs()
         needed_tabs = self._n - len(self.tabs)
         if not needed_tabs:
             return
@@ -209,35 +214,36 @@ async def _return_kaleido_tab(self, tab: _KaleidoTab) -> None:
 
     #### WE'RE HERE
 
-    async def _create_render_task(
+    def _create_render_task(
         self,
         tab: _KaleidoTab,
-        *args: Any,
+        spec: _fig_tools.Spec,
+        full_path: Path,
         **kwargs: Any,
     ) -> asyncio.Task:
-        _logger.info(f"Posting a task for {args['full_path'].name}")
-        t = asyncio.create_task(
+        _logger.info(f"Posting a task for {full_path.name}")
+        t: asyncio.Task = asyncio.create_task(
             asyncio.wait_for(
                 tab._write_fig(  # noqa: SLF001
-                    *args,
+                    spec,
+                    full_path,
                     **kwargs,
                 ),
                 self._timeout,
             ),
         )
-
         # create_task_log_error is a create_task helper, set and forget
         # to create a task and add a post-run action which checks for
         # errors and logs them. this pattern is the best i've found
         # but somehow its still pretty distressing
         t.add_done_callback(
-            lambda: self._tab_requeue_tasks.add(
+            lambda _f: self._tab_requeue_tasks.add(
                 _utils.create_task_log_error(
                     self._return_kaleido_tab(tab),
                 ),
             ),
         )
-        _logger.info(f"Posted task ending for {args['full_path'].name}")
+        _logger.info(f"Posted task ending for {full_path.name}")
         return t
 
     ### API ###
@@ -245,7 +251,7 @@ async def _create_render_task(
     class FigureGenerator(TypedDict):
         fig: Required[_fig_tools.Figurish]
         path: NotRequired[None | str | Path]
-        opts: NotRequired[_fig_tools.LayoutOpts, None]
+        opts: NotRequired[_fig_tools.LayoutOpts | None]
 
     # also write_fig_from_dict
     async def write_fig_from_object(
@@ -257,7 +263,7 @@ async def write_fig_from_object(
         """Temp."""
         if main_task := asyncio.current_task():
             self._main_render_coroutines.add(main_task)
-        tasks = set()
+        tasks: set[asyncio.Task] = set()
 
         try:
             async for args in _utils.ensure_async_iter(generator):
@@ -270,13 +276,12 @@ async def write_fig_from_object(
 
                 tab = await self._get_kaleido_tab()
 
-                t = self._create_render_task(
+                t: asyncio.Task = self._create_render_task(
                     tab,
                     spec,
                     full_path,
                     topojson=topojson,
                 )
-
                 tasks.add(t)
 
             await asyncio.gather(*tasks, return_exceptions=not cancel_on_error)

From 71460e9689722678ed92b0d543b6b6384a503fcd Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Mon, 1 Sep 2025 17:36:49 -0500
Subject: [PATCH 072/167] Add more types.

---
 src/py/kaleido/kaleido.py | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/src/py/kaleido/kaleido.py b/src/py/kaleido/kaleido.py
index 69d1028b..1be6331e 100644
--- a/src/py/kaleido/kaleido.py
+++ b/src/py/kaleido/kaleido.py
@@ -252,6 +252,7 @@ class FigureGenerator(TypedDict):
         fig: Required[_fig_tools.Figurish]
         path: NotRequired[None | str | Path]
         opts: NotRequired[_fig_tools.LayoutOpts | None]
+        topojson: NotRequired[None | str]
 
     # also write_fig_from_dict
     async def write_fig_from_object(
@@ -296,11 +297,11 @@ async def write_fig_from_object(
 
     async def write_fig(
         self,
-        fig,
-        path=None,
-        opts=None,
+        fig: _fig_tools.Figurish,
+        path: None | Path | str = None,
+        opts: None | _fig_tools.LayoutOpts = None,
         *,
-        topojson=None,
+        topojson: str | None = None,
     ) -> None:
         """Temp."""
         if _is_figurish(fig) or not isinstance(fig, (Iterable, AsyncIterable)):

From 17a0546cdcef3530ef6b73537e643aa873877500 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Mon, 1 Sep 2025 17:53:21 -0500
Subject: [PATCH 073/167] Connect types between __init__ and kaledio.py

---
 src/py/kaleido/__init__.py |  4 +++-
 src/py/kaleido/kaleido.py  | 14 +++++++-------
 2 files changed, 10 insertions(+), 8 deletions(-)

diff --git a/src/py/kaleido/__init__.py b/src/py/kaleido/__init__.py
index 71c18427..0936f0db 100644
--- a/src/py/kaleido/__init__.py
+++ b/src/py/kaleido/__init__.py
@@ -24,6 +24,8 @@
     T = TypeVar("T")
     AnyIterable = Union[AsyncIterable[T], Iterable[T]]
 
+    from .kaleido import FigureGenerator
+
 __all__ = [
     "Kaleido",
     "PageGenerator",
@@ -139,7 +141,7 @@ async def write_fig(
 
 
 async def write_fig_from_object(
-    generator: AnyIterable,  # this could be more specific with []
+    generator: AnyIterable[FigureGenerator],
     *,
     kopts: dict[str, Any] | None = None,
     **kwargs,
diff --git a/src/py/kaleido/kaleido.py b/src/py/kaleido/kaleido.py
index 1be6331e..43893f5e 100644
--- a/src/py/kaleido/kaleido.py
+++ b/src/py/kaleido/kaleido.py
@@ -39,6 +39,12 @@
     # Iterable & Sized
     Listish: TypeAlias = Union[Tuple[T], List[T], ValuesView[T]]
 
+    class FigureGenerator(TypedDict):
+        fig: Required[_fig_tools.Figurish]
+        path: NotRequired[None | str | Path]
+        opts: NotRequired[_fig_tools.LayoutOpts | None]
+        topojson: NotRequired[None | str]
+
 
 class Kaleido(choreo.Browser):
     tabs_ready: asyncio.Queue[_KaleidoTab]
@@ -248,16 +254,10 @@ def _create_render_task(
 
     ### API ###
 
-    class FigureGenerator(TypedDict):
-        fig: Required[_fig_tools.Figurish]
-        path: NotRequired[None | str | Path]
-        opts: NotRequired[_fig_tools.LayoutOpts | None]
-        topojson: NotRequired[None | str]
-
     # also write_fig_from_dict
     async def write_fig_from_object(
         self,
-        generator: FigureGenerator,  # what should we accept here
+        generator: AnyIterable[FigureGenerator],
         *,
         cancel_on_error=False,
     ) -> None:

From 51262b0994ffbec3ecccb1177de084d4bf3bcb96 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Mon, 1 Sep 2025 19:19:22 -0500
Subject: [PATCH 074/167] Make readability changes to test_fig_tools.py

---
 src/py/tests/test_fig_tools.py | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/src/py/tests/test_fig_tools.py b/src/py/tests/test_fig_tools.py
index 135a7c89..aa89326a 100644
--- a/src/py/tests/test_fig_tools.py
+++ b/src/py/tests/test_fig_tools.py
@@ -6,12 +6,13 @@
 
 sources = ["argument", "layout", "template", "default"]
 values = [None, 150, 800, 1500]
+values2 = [None, 300, 1000, 1300]
 
 
 @pytest.mark.parametrize("width_source", sources)
 @pytest.mark.parametrize("height_source", sources)
 @pytest.mark.parametrize("width_value", values)
-@pytest.mark.parametrize("height_value", [x * 1.5 if x else x for x in values])
+@pytest.mark.parametrize("height_value", values2)
 def test_get_figure_dimensions(width_source, height_source, width_value, height_value):
     """Test _get_figure_dimensions with all combinations of width/height sources."""
 
@@ -113,8 +114,8 @@ def test_next_filename_similar_names_ignored(tmp_path):
 
 def test_next_filename_special_characters(tmp_path):
     """Test _next_filename with special characters in prefix and extension."""
-    prefix = "test-file_name"
-    ext = "svg"  # set up to be parameterized but not
+    prefix = "test-?f$ile_name"
+    ext = "s$v&*g"  # set up to be parameterized but not
 
     # Create some files
     (tmp_path / f"{prefix}.{ext}").touch()
@@ -171,7 +172,7 @@ def test_build_full_path_no_path_input(fig_fixture):
 
 
 def test_build_full_path_no_suffix_directory(tmp_path, fig_fixture):
-    """Test _build_full_path with path having no suffix."""
+    """Test _build_full_path with path to directory having no suffix."""
     fig_dict, expected_prefix = fig_fixture
 
     # Test directory no suffix

From 3f9709821a070ee1ce862745c0881bf5876c6bcf Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Mon, 1 Sep 2025 19:22:45 -0500
Subject: [PATCH 075/167] Add extraneous lines to force checks on string
 patches.

---
 src/py/tests/test_init.py | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/src/py/tests/test_init.py b/src/py/tests/test_init.py
index 79fb5ba3..5ff5498f 100644
--- a/src/py/tests/test_init.py
+++ b/src/py/tests/test_init.py
@@ -24,6 +24,10 @@ def kwargs():
     return {"width": 800}
 
 
+# line serves to force static check of string in @patch
+_ = kaleido._sync_server.GlobalKaleidoServer.open  # noqa: SLF001
+
+
 @patch("kaleido._sync_server.GlobalKaleidoServer.open")
 def test_start_sync_server_passes_args(mock_open, args, kwargs):
     """Test that start_sync_server passes args and silence_warnings correctly."""
@@ -37,6 +41,10 @@ def test_start_sync_server_passes_args(mock_open, args, kwargs):
     mock_open.assert_called_with(*args, silence_warnings=True, **kwargs)
 
 
+# line serves to force static check of string in @patch
+_ = kaleido._sync_server.GlobalKaleidoServer.close  # noqa: SLF001
+
+
 @patch("kaleido._sync_server.GlobalKaleidoServer.close")
 def test_stop_sync_server_passes_args(mock_close):
     """Test that stop_sync_server passes silence_warnings correctly."""
@@ -50,6 +58,10 @@ def test_stop_sync_server_passes_args(mock_close):
     mock_close.assert_called_with(silence_warnings=True)
 
 
+# line serves to force static check of string in @patch
+_ = kaleido.Kaleido
+
+
 @patch("kaleido.Kaleido")
 async def test_async_wrapper_functions(mock_kaleido_class):
     """Test all async wrapper functions pass arguments correctly.
@@ -124,6 +136,11 @@ async def test_async_wrapper_functions(mock_kaleido_class):
     mock_kaleido.write_fig_from_object.assert_called_with(generator)
 
 
+# line serves to force static check of string in @patch
+_ = kaleido._sync_server.GlobalKaleidoServer.is_running  # noqa: SLF001
+_ = kaleido._sync_server.GlobalKaleidoServer.call_function  # noqa: SLF001
+
+
 @patch("kaleido._sync_server.GlobalKaleidoServer.is_running")
 @patch("kaleido._sync_server.GlobalKaleidoServer.call_function")
 def test_sync_wrapper_server(mock_call_function, mock_is_running, args, kwargs):
@@ -147,6 +164,11 @@ def test_sync_wrapper_server(mock_call_function, mock_is_running, args, kwargs):
     mock_call_function.assert_called_with("write_fig_from_object", *args, **kwargs)
 
 
+# line serves to force static check of string in @patch
+_ = kaleido._sync_server.GlobalKaleidoServer.is_running  # noqa: SLF001
+_ = kaleido._sync_server.oneshot_async_run  # noqa: SLF001
+
+
 @patch("kaleido._sync_server.GlobalKaleidoServer.is_running")
 @patch("kaleido._sync_server.oneshot_async_run")
 def test_sync_wrapper_oneshot(mock_oneshot_run, mock_is_running, args, kwargs):

From 42b8121adf6f37eaa3a845c64ea5da8f6b6c67bc Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Mon, 1 Sep 2025 19:29:18 -0500
Subject: [PATCH 076/167] Add single comment.

---
 src/py/tests/test_kaleido.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/src/py/tests/test_kaleido.py b/src/py/tests/test_kaleido.py
index 6c83dbab..ca41131c 100644
--- a/src/py/tests/test_kaleido.py
+++ b/src/py/tests/test_kaleido.py
@@ -186,6 +186,7 @@ async def test_write_fig_argument_passthrough(  #  noqa: PLR0913
 ):
     """Test that write_fig properly passes arguments to write_fig_from_object."""
     pytest.skip("Remove this failure line and the comment above after the refactor!")
+    # Also add one for calc, its just a pass through tester.
     test_path = tmp_path / f"{path}.{format_type}"
     opts = {"format": format_type, "width": width, "height": height}
 

From caa302e1d7073d229f49b3bb5f75f9296365ace3 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Mon, 1 Sep 2025 20:07:54 -0500
Subject: [PATCH 077/167] Factor file searching out of page generator.

---
 src/py/kaleido/_page_generator.py | 25 ++++++++++---------------
 src/py/kaleido/_utils.py          | 15 +++++++++++++++
 2 files changed, 25 insertions(+), 15 deletions(-)

diff --git a/src/py/kaleido/_page_generator.py b/src/py/kaleido/_page_generator.py
index 981ae2e7..c81a3448 100644
--- a/src/py/kaleido/_page_generator.py
+++ b/src/py/kaleido/_page_generator.py
@@ -1,11 +1,11 @@
 from __future__ import annotations
 
 from pathlib import Path
-from urllib.parse import urlparse
-from urllib.request import url2pathname
 
 import logistro
 
+from . import _utils
+
 _logger = logistro.getLogger(__name__)
 
 DEFAULT_PLOTLY = "https://cdn.plot.ly/plotly-2.35.2.js"
@@ -17,19 +17,14 @@
 KJS_PATH = Path(__file__).resolve().parent / "vendor" / "kaleido_scopes.js"
 
 
-def _ensure_path(path: Path | str | tuple[str | Path, str]) -> None:
+def _ensure_file(path: Path | str | tuple[str | Path, str]) -> None:
     if isinstance(path, tuple):
         path = path[0]
-    _logger.debug(f"Ensuring path {path!s}")
-    parsed = urlparse(str(path))
-    _logger.debug(f"Parsed file path: {parsed}")
-    if parsed.scheme.startswith("http"):  # is url
+    if isinstance(path, Path) and path.is_file():  # noqa: SIM114 clarity
+        return
+    elif _utils.is_url(path):  # noqa: SIM114 clarity
         return
-    elif parsed.scheme.startswith("file"):
-        if (_p := Path(url2pathname(parsed.path))).exists():
-            return
-        _logger.error(f"File parsed to: {_p}")
-    elif Path(path).exists():
+    elif _utils.get_path(path).is_file():
         return
     raise FileNotFoundError(f"{path!s} does not exist.")
 
@@ -91,7 +86,7 @@ def __init__(  # noqa: C901
             if mathjax is None or mathjax is True:
                 mathjax = DEFAULT_MATHJAX
             elif mathjax:
-                _ensure_path(mathjax)
+                _ensure_file(mathjax)
             self._scripts.append(mathjax)
         if force_cdn:
             plotly = (DEFAULT_PLOTLY, "utf-8")
@@ -119,13 +114,13 @@ def __init__(  # noqa: C901
                 _logger.info("Plotly not installed. Using CDN.")
                 plotly = (DEFAULT_PLOTLY, "utf-8")
         elif isinstance(plotly, (str, Path)):
-            _ensure_path(plotly)
+            _ensure_file(plotly)
             plotly = (plotly, "utf-8")
         _logger.debug(f"Plotly script: {plotly}")
         self._scripts.append(plotly)
         if others:
             for o in others:
-                _ensure_path(o)
+                _ensure_file(o)
             self._scripts.extend(others)
 
     def generate_index(self):
diff --git a/src/py/kaleido/_utils.py b/src/py/kaleido/_utils.py
index 15db4930..23d5825e 100644
--- a/src/py/kaleido/_utils.py
+++ b/src/py/kaleido/_utils.py
@@ -4,7 +4,10 @@
 import warnings
 from functools import partial
 from importlib.metadata import PackageNotFoundError, version
+from pathlib import Path
 from typing import TYPE_CHECKING
+from urllib.parse import urlparse
+from urllib.request import url2pathname
 
 import logistro
 from packaging.version import Version
@@ -99,3 +102,15 @@ def warn_incompatible_plotly():
         # Since this compatibility check is just a convenience,
         # we don't want to block the whole library if there's an issue
         _logger.info("Error while checking Plotly version.", exc_info=e)
+
+
+def get_path(p: str) -> Path | None:
+    parsed = urlparse(str(p))
+
+    return Path(
+        url2pathname(parsed.path) if parsed.scheme.startswith("file") else p,
+    )
+
+
+def is_url(p: str) -> bool:
+    return urlparse(str(p)).scheme.startswith("http")

From 839ceddbd2496b84d21b6e60cac9fe5c62946866 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Mon, 1 Sep 2025 20:08:15 -0500
Subject: [PATCH 078/167] Add test to make sure page generator is passed a file

---
 src/py/tests/test_page_generator.py | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/src/py/tests/test_page_generator.py b/src/py/tests/test_page_generator.py
index e213d6a9..2324d366 100644
--- a/src/py/tests/test_page_generator.py
+++ b/src/py/tests/test_page_generator.py
@@ -361,6 +361,10 @@ async def test_combined_overrides(tmp_path, data):
     assert len(scripts) == expected_count
 
 
+# note: the logic below was extracted to utilities,
+# so in a way its tested twice since tests were developed for that file
+
+
 # Test file path validation
 async def test_existing_file_path(temp_js_file):
     """Test that existing file paths work with and without file:/// protocol."""
@@ -383,9 +387,14 @@ async def test_existing_file_path(temp_js_file):
     assert scripts_uri[2].endswith("kaleido_scopes.js")
 
 
+# Claude, please for all bottom, please make a fixture like "existing_dir"
+# and make sure we still raise an error
+
+
 async def test_nonexistent_file_path_raises_error(
     nonexistent_file_path,
     nonexistent_file_uri,
+    tmp_path,
 ):
     """Test that nonexistent file paths raise FileNotFoundError."""
     # Test with regular path
@@ -399,10 +408,15 @@ async def test_nonexistent_file_path_raises_error(
     with pytest.raises(FileNotFoundError):
         PageGenerator(plotly=nonexistent_file_uri)
 
+    # Test that existing directory raises error
+    with pytest.raises(FileNotFoundError):
+        PageGenerator(plotly=str(tmp_path))
+
 
 async def test_mathjax_nonexistent_file_raises_error(
     nonexistent_file_path,
     nonexistent_file_uri,
+    tmp_path,
 ):
     """Test that nonexistent mathjax file raises FileNotFoundError."""
     # Test with regular path
@@ -416,10 +430,15 @@ async def test_mathjax_nonexistent_file_raises_error(
     with pytest.raises(FileNotFoundError):
         PageGenerator(mathjax=nonexistent_file_uri)
 
+    # Test that existing directory raises error
+    with pytest.raises(FileNotFoundError):
+        PageGenerator(mathjax=str(tmp_path))
+
 
 async def test_others_nonexistent_file_raises_error(
     nonexistent_file_path,
     nonexistent_file_uri,
+    tmp_path,
 ):
     """Test that nonexistent file in others list raises FileNotFoundError."""
     # Test with regular path
@@ -433,6 +452,10 @@ async def test_others_nonexistent_file_raises_error(
     with pytest.raises(FileNotFoundError):
         PageGenerator(others=[nonexistent_file_uri])
 
+    # Test that existing directory raises error
+    with pytest.raises(FileNotFoundError):
+        PageGenerator(others=[str(tmp_path)])
+
 
 # Test HTTP URLs (should not raise FileNotFoundError)
 async def test_http_urls_skip_file_validation():

From 8c66445a18652ebec3fe05749c75f61b8450cae1 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Mon, 1 Sep 2025 20:14:08 -0500
Subject: [PATCH 079/167] Change is_url to is_httpish

---
 src/py/kaleido/_page_generator.py | 2 +-
 src/py/kaleido/_utils.py          | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/py/kaleido/_page_generator.py b/src/py/kaleido/_page_generator.py
index c81a3448..4baba313 100644
--- a/src/py/kaleido/_page_generator.py
+++ b/src/py/kaleido/_page_generator.py
@@ -22,7 +22,7 @@ def _ensure_file(path: Path | str | tuple[str | Path, str]) -> None:
         path = path[0]
     if isinstance(path, Path) and path.is_file():  # noqa: SIM114 clarity
         return
-    elif _utils.is_url(path):  # noqa: SIM114 clarity
+    elif _utils.is_httpish(path):  # noqa: SIM114 clarity
         return
     elif _utils.get_path(path).is_file():
         return
diff --git a/src/py/kaleido/_utils.py b/src/py/kaleido/_utils.py
index 23d5825e..10a69c52 100644
--- a/src/py/kaleido/_utils.py
+++ b/src/py/kaleido/_utils.py
@@ -112,5 +112,5 @@ def get_path(p: str) -> Path | None:
     )
 
 
-def is_url(p: str) -> bool:
+def is_httpish(p: str) -> bool:
     return urlparse(str(p)).scheme.startswith("http")

From 302c30699125621cade85740bd7bfb72e42d95aa Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Mon, 1 Sep 2025 20:14:24 -0500
Subject: [PATCH 080/167] Add tests for is_httpish/get_path

---
 src/py/tests/test_utils.py | 51 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 51 insertions(+)
 create mode 100644 src/py/tests/test_utils.py

diff --git a/src/py/tests/test_utils.py b/src/py/tests/test_utils.py
new file mode 100644
index 00000000..7c92d892
--- /dev/null
+++ b/src/py/tests/test_utils.py
@@ -0,0 +1,51 @@
+from pathlib import Path
+
+import pytest
+
+from kaleido._utils import get_path, is_httpish
+
+pytestmark = pytest.mark.asyncio(loop_scope="function")
+
+# ruff: noqa: S108
+
+
+# Test get_path utility function
+async def test_get_path_with_file_uri():
+    """Test get_path function with file:// URIs."""
+    file_uri = "file:///tmp/test.js"
+    result = get_path(file_uri)
+    assert result == Path("/tmp/test.js")
+
+
+async def test_get_path_with_regular_path():
+    """Test get_path function with regular file paths."""
+    regular_path = "/tmp/test.js"
+    result = get_path(regular_path)
+    assert result == Path("/tmp/test.js")
+
+
+async def test_get_path_with_http_url():
+    """Test get_path function with HTTP URLs."""
+    http_url = "https://example.com/test.js"
+    result = get_path(http_url)
+    assert result == Path("https://example.com/test.js")
+
+
+# Test is_httpish utility function
+async def test_is_httpish_with_http():
+    """Test is_httpish function with HTTP URLs."""
+    assert is_httpish("http://example.com/test.js") is True
+    assert is_httpish("https://example.com/test.js") is True
+
+
+async def test_is_httpish_with_file_paths():
+    """Test is_httpish function with file paths."""
+    assert is_httpish("/tmp/test.js") is False
+    assert is_httpish("test.js") is False
+    assert is_httpish("file:///tmp/test.js") is False
+
+
+async def test_is_httpish_with_other_schemes():
+    """Test is_httpish function with other URL schemes."""
+    assert is_httpish("ftp://example.com/test.js") is False
+    assert is_httpish("mailto:test@example.com") is False

From f6da4da20b775b62c2394f31aa9f572ba90f75c8 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Mon, 1 Sep 2025 20:32:21 -0500
Subject: [PATCH 081/167] Use _utils to simplify kaleido.

---
 src/py/kaleido/_utils.py  |  4 +++-
 src/py/kaleido/kaleido.py | 24 +++++++++++-------------
 2 files changed, 14 insertions(+), 14 deletions(-)

diff --git a/src/py/kaleido/_utils.py b/src/py/kaleido/_utils.py
index 10a69c52..820b61d3 100644
--- a/src/py/kaleido/_utils.py
+++ b/src/py/kaleido/_utils.py
@@ -104,7 +104,9 @@ def warn_incompatible_plotly():
         _logger.info("Error while checking Plotly version.", exc_info=e)
 
 
-def get_path(p: str) -> Path | None:
+def get_path(p: str | Path) -> Path:
+    if isinstance(p, Path):
+        return p
     parsed = urlparse(str(p))
 
     return Path(
diff --git a/src/py/kaleido/kaleido.py b/src/py/kaleido/kaleido.py
index 43893f5e..0f0791a6 100644
--- a/src/py/kaleido/kaleido.py
+++ b/src/py/kaleido/kaleido.py
@@ -6,7 +6,6 @@
 from collections.abc import AsyncIterable, Iterable
 from pathlib import Path
 from typing import TYPE_CHECKING, TypedDict
-from urllib.parse import unquote, urlparse
 
 import choreographer as choreo
 import logistro
@@ -102,25 +101,24 @@ async def open(self):
         page = self._saved_page_arg
         del self._saved_page_arg
 
-        if isinstance(page, str):
-            if page.startswith(r"file://") and Path(unquote(urlparse(page).path)):
-                self._index = page
-            elif Path(page).is_file():
-                self._index = Path(page).as_uri()
-            else:
-                raise FileNotFoundError(f"{page} does not exist.")
-        elif isinstance(page, Path):
-            if page.is_file():
-                self._index = page.as_uri()
+        if isinstance(page, (Path, str)):
+            if (_p := _utils.get_path(page)).is_file():
+                self._index = _p.as_uri()
             else:
                 raise FileNotFoundError(f"{page!s} does not exist.")
-        else:
+        elif not page or hasattr(page, "generate_index"):
             self._tmp_dir = TmpDirectory(sneak=self.is_isolated())
             index = self._tmp_dir.path / "index.html"
             self._index = index.as_uri()
             if not page:
                 page = PageGenerator(plotly=self._plotlyjs, mathjax=self._mathjax)
-            page.generate_index(index)
+            with index.open("w") as f:  # is blocking but ok
+                f.write(page.generate_index())
+        else:
+            raise TypeError(
+                "A page generator must be one of: None, a"
+                " PageGenerator, or a file path to an index.html",
+            )
         await super().open()
 
     async def _conform_tabs(self, tabs: Listish[choreo.Tab] | None = None) -> None:

From 6c4f8a696602d2e618ff54fbf6cf90f805d6ede7 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Mon, 1 Sep 2025 20:37:34 -0500
Subject: [PATCH 082/167] Expand utils tests.

---
 src/py/tests/test_utils.py | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/src/py/tests/test_utils.py b/src/py/tests/test_utils.py
index 7c92d892..888447bc 100644
--- a/src/py/tests/test_utils.py
+++ b/src/py/tests/test_utils.py
@@ -13,22 +13,28 @@
 async def test_get_path_with_file_uri():
     """Test get_path function with file:// URIs."""
     file_uri = "file:///tmp/test.js"
+    path_wrapped = Path(file_uri)
     result = get_path(file_uri)
     assert result == Path("/tmp/test.js")
+    assert get_path(path_wrapped) is path_wrapped
 
 
 async def test_get_path_with_regular_path():
     """Test get_path function with regular file paths."""
     regular_path = "/tmp/test.js"
+    path_wrapped = Path(regular_path)
     result = get_path(regular_path)
     assert result == Path("/tmp/test.js")
+    assert get_path(path_wrapped) is path_wrapped
 
 
 async def test_get_path_with_http_url():
     """Test get_path function with HTTP URLs."""
     http_url = "https://example.com/test.js"
+    path_wrapped = Path(http_url)
     result = get_path(http_url)
     assert result == Path("https://example.com/test.js")
+    assert get_path(path_wrapped) is path_wrapped
 
 
 # Test is_httpish utility function

From 9c8cc6bdf783ae5e707ec12fbb072a4b0ff72058 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Mon, 1 Sep 2025 20:40:08 -0500
Subject: [PATCH 083/167] Fix logic in file checker.

---
 src/py/kaleido/_page_generator.py | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/src/py/kaleido/_page_generator.py b/src/py/kaleido/_page_generator.py
index 4baba313..2fa2bf8e 100644
--- a/src/py/kaleido/_page_generator.py
+++ b/src/py/kaleido/_page_generator.py
@@ -20,8 +20,11 @@
 def _ensure_file(path: Path | str | tuple[str | Path, str]) -> None:
     if isinstance(path, tuple):
         path = path[0]
-    if isinstance(path, Path) and path.is_file():  # noqa: SIM114 clarity
-        return
+    if isinstance(path, Path):
+        if path.is_file():
+            return
+        else:
+            pass  # FileNotFound
     elif _utils.is_httpish(path):  # noqa: SIM114 clarity
         return
     elif _utils.get_path(path).is_file():

From 409645a731f12900b8aa0db0abf6f6924c8005e9 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Tue, 2 Sep 2025 11:53:24 -0500
Subject: [PATCH 084/167] Improve a bit the documentation.

---
 src/py/kaleido/__init__.py | 25 ++++++++++++-------------
 1 file changed, 12 insertions(+), 13 deletions(-)

diff --git a/src/py/kaleido/__init__.py b/src/py/kaleido/__init__.py
index 0936f0db..dce75c47 100644
--- a/src/py/kaleido/__init__.py
+++ b/src/py/kaleido/__init__.py
@@ -52,7 +52,7 @@ def start_sync_server(*args: Any, silence_warnings: bool = False, **kwargs: Any)
     function will warn you if the server is already running.
 
     This wrapper function takes the exact same arguments as kaleido.Kaleido(),
-    except one extra, `silence_warnings`.
+    except one extra: `silence_warnings`.
 
     Args:
         *args: all arguments `Kaleido()` would take.
@@ -66,11 +66,13 @@ def start_sync_server(*args: Any, silence_warnings: bool = False, **kwargs: Any)
 
 def stop_sync_server(*, silence_warnings: bool = False):
     """
-    Stop the kaleido server. It can be restarted. Warns if not started.
+    Stop the kaleido server. It can be restarted.
+
+    This function will warn you if the server is already stopped.
 
     Args:
         silence_warnings: (bool, default False): If True, don't emit warning if
-        stopping a server that's not running.
+        stopping an already stopped server.
 
     """
     _global_server.close(silence_warnings=silence_warnings)
@@ -88,14 +90,13 @@ async def calc_fig(
     Return binary for plotly figure.
 
     A convenience wrapper for `Kaleido.calc_fig()` which starts a `Kaleido` and
-    executes the `calc_fig()`.
+    executes `calc_fig()`.
     It takes an additional argument, `kopts`, a dictionary of arguments to pass
     to the kaleido process. See the `kaleido.Kaleido` docs. However,
     `calc_fig()` will never use more than one processor, so any `n` value will
     be overridden.
 
-
-    See documentation for `Kaleido.calc_fig()`.
+    See also the documentation for `Kaleido.calc_fig()`.
 
     """
     kopts = kopts or {}
@@ -124,10 +125,9 @@ async def write_fig(
     A convenience wrapper for `Kaleido.write_fig()` which starts a `Kaleido` and
     executes the `write_fig()`.
     It takes an additional argument, `kopts`, a dictionary of arguments to pass
-    to the kaleido process. See the `kaleido.Kaleido` docs.
+    to the `Kaleido` constructor. See the `kaleido.Kaleido` docs.
 
-
-    See documentation for `Kaleido.write_fig()` for the other arguments.
+    See also the documentation for `Kaleido.write_fig()`.
 
     """
     async with Kaleido(**(kopts or {})) as k:
@@ -147,15 +147,14 @@ async def write_fig_from_object(
     **kwargs,
 ):
     """
-    Write a plotly figure(s) to a file.
+    Write a plotly figure(s) to a file specified by a dictionary generator.
 
     A convenience wrapper for `Kaleido.write_fig_from_object()` which starts a
     `Kaleido` and executes the `write_fig_from_object()`
     It takes an additional argument, `kopts`, a dictionary of arguments to pass
-    to the kaleido process. See the `kaleido.Kaleido` docs.
+    to the `Kaleido` constructor. See the `kaleido.Kaleido` docs.
 
-    See documentation for `Kaleido.write_fig_from_object()` for the other
-    arguments.
+    See also the documentation for `Kaleido.write_fig_from_object()`.
 
     """
     async with Kaleido(**(kopts or {})) as k:

From f6498c179e930297bdbdd0422abe4fed744edc92 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Tue, 2 Sep 2025 12:37:05 -0500
Subject: [PATCH 085/167] Improve docs and add notes:

Also turn off mandatory issue linking for TODO
---
 src/py/kaleido/__init__.py |   4 +-
 src/py/kaleido/kaleido.py  | 115 ++++++++++++++++++++++++++++++-------
 src/py/pyproject.toml      |   1 +
 3 files changed, 97 insertions(+), 23 deletions(-)

diff --git a/src/py/kaleido/__init__.py b/src/py/kaleido/__init__.py
index dce75c47..ebdbe698 100644
--- a/src/py/kaleido/__init__.py
+++ b/src/py/kaleido/__init__.py
@@ -117,7 +117,7 @@ async def write_fig(
     *,
     topojson: str | None = None,
     kopts: dict[str, Any] | None = None,
-    **kwargs,
+    **kwargs,  # TODO(AJP): what might we pass here?
 ):
     """
     Write a plotly figure(s) to a file.
@@ -144,7 +144,7 @@ async def write_fig_from_object(
     generator: AnyIterable[FigureGenerator],
     *,
     kopts: dict[str, Any] | None = None,
-    **kwargs,
+    **kwargs,  # TODO(AJP): what might we pass here?
 ):
     """
     Write a plotly figure(s) to a file specified by a dictionary generator.
diff --git a/src/py/kaleido/kaleido.py b/src/py/kaleido/kaleido.py
index 0f0791a6..39bc3284 100644
--- a/src/py/kaleido/kaleido.py
+++ b/src/py/kaleido/kaleido.py
@@ -39,6 +39,8 @@
     Listish: TypeAlias = Union[Tuple[T], List[T], ValuesView[T]]
 
     class FigureGenerator(TypedDict):
+        """The type a generator returns for `write_fig_from_object`."""
+
         fig: Required[_fig_tools.Figurish]
         path: NotRequired[None | str | Path]
         opts: NotRequired[_fig_tools.LayoutOpts | None]
@@ -46,7 +48,31 @@ class FigureGenerator(TypedDict):
 
 
 class Kaleido(choreo.Browser):
+    """
+    The Kaleido object provides a browser to render and write plotly figures.
+
+    It provides methods to render said figures, and manages any number of tabs
+    in a work queue. Start it one of a few equal ways:
+
+    async with Kaleido() as k:
+        ...
+
+    # or
+
+    k = await Kaleido()
+    ...
+    await k.close()
+
+    # or
+
+    k = Kaleido()
+    await k.open()
+    ...
+    await.k.close()
+    """
+
     tabs_ready: asyncio.Queue[_KaleidoTab]
+    """A queue of tabs ready to process a kaleido figure."""
     _tab_requeue_tasks: set[asyncio.Task]
     _main_render_coroutines: set[asyncio.Task]
     # technically Tasks, user sees coroutines
@@ -58,15 +84,59 @@ class Kaleido(choreo.Browser):
 
     def __init__(  # noqa: PLR0913
         self,
-        *args: Any,  # does choreographer take args?
+        *args: Any,  # TODO(AJP): does choreographer take args?
         n: int = 1,
         timeout: int | None = 90,
         page_generator: None | PageGenerator | str | Path = None,
-        plotlyjs: str | Path | None = None,
-        mathjax: str | Path | None = None,
+        plotlyjs: str | Path | None = None,  # TODO(AJP): with page generator
+        mathjax: str | Path | None = None,  # TODO(AJP): with page generator?
         stepper: bool = False,
         **kwargs: Any,
     ) -> None:
+        """
+        Create a new Kaleido process for rendering plotly figures.
+
+        Args:
+            *args (Any):
+                Passed through to underlying choreographer.Browser()
+            n (int, optional):
+                Number of processors to use (parallelization). Defaults to 1.
+
+            timeout (int | None, optional):
+                Number of seconds to wait to render any one image. None for no
+                timeout. Defaults to 90.
+
+            page_generator (None | PageGenerator | str | Path, optional):
+                A PageGenerator object can be used for deep customization of the
+                plotly template page. This is for development use. You can also
+                pass a string or path directly to an index.html, or any object
+                with a `generate_index()->str function that prints an HTML
+                ppage. Defaults to None.
+
+            plotlyjs (str | Path | None, optional):
+                A path or URL to a plotly.js file. Defaults to None- which means
+                to use the plotly.js included with your version of plotly.py or
+                if not installed, the latest version available via CDN.
+
+            mathjax (str | Path | None, optional):
+                A path or URL to a mathjax.js file. If false, mathjax is
+                disabled. Defaults to None- which means to use version 2.35 via
+                CDN.
+
+            stepper (bool, optional):
+                A diagnostic tool that will ask the user to press enter between
+                rendering each image. Only useful if also used with
+                `headless=False`. See below. Defaults to False.
+
+            **kwargs (Any):
+                Additional keyword arguments passed through to the underlying
+                Choreographer.browser constructor. Notable options include,
+                `headless=False` (show window), `enable_sandbox=True` (turn on
+                sandboxing), and `enable_gpu=True` which will allow use of the
+                GPU. The defaults for these options are True, False, False
+                respectively.
+
+        """
         self._tab_requeue_tasks = set()
         self._main_render_coroutines = set()
         self.tabs_ready = asyncio.Queue(maxsize=0)
@@ -90,14 +160,15 @@ def __init__(  # noqa: PLR0913
             raise ChromeNotFoundError(
                 "Kaleido v1 and later requires Chrome to be installed. "
                 "To install Chrome, use the CLI command `kaleido_get_chrome`, "
-                "or from Python, use either `kaleido.get_chrome()` "
+                "or from Python, use either `await kaleido.get_chrome()` "
                 "or `kaleido.get_chrome_sync()`.",
-            ) from ChromeNotFoundError
-        # do this during open because it requires close
+            ) from None  # overwriting the error entirely.
+
+        # save this for open() because it requires close()
         self._saved_page_arg = page
 
     async def open(self):
-        """Build temporary file if we need one."""
+        """Build page and temporary file if we need one, then opens browser."""
         page = self._saved_page_arg
         del self._saved_page_arg
 
@@ -116,11 +187,18 @@ async def open(self):
                 f.write(page.generate_index())
         else:
             raise TypeError(
-                "A page generator must be one of: None, a"
-                " PageGenerator, or a file path to an index.html",
+                "page_generator must be one of: None, a"
+                " PageGenerator, or a file path to an index.html.",
             )
         await super().open()
 
+    async def _create_kaleido_tab(self) -> None:
+        tab = await super().create_tab(
+            url="",
+            window=True,
+        )
+        await self._conform_tabs([tab])
+
     async def _conform_tabs(self, tabs: Listish[choreo.Tab] | None = None) -> None:
         if not tabs:
             tabs = self.tabs.values()
@@ -130,6 +208,8 @@ async def _conform_tabs(self, tabs: Listish[choreo.Tab] | None = None) -> None:
             tab.subscribe("*", _utils.event_printer(f"tab-{i!s}: Event Dump:"))
 
         kaleido_tabs = [_KaleidoTab(tab, _stepper=self._stepper) for tab in tabs]
+        # TODO(AJP): why doesn't stepper use the global?
+        # KaleidoTab has access to Kaleido?
 
         await asyncio.gather(*(tab.navigate(self._index) for tab in kaleido_tabs))
 
@@ -142,7 +222,7 @@ async def populate_targets(self) -> None:
         Override the browser populate_targets to ensure the correct page.
 
         Is called automatically during initialization, and should only be called
-        once ever per object.
+        once.
         """
         await super().populate_targets()
         await self._conform_tabs()
@@ -189,13 +269,6 @@ async def __aexit__(
 
     ### TAB MANAGEMENT FUNCTIONS ####
 
-    async def _create_kaleido_tab(self) -> None:
-        tab = await super().create_tab(
-            url="",
-            window=True,
-        )
-        await self._conform_tabs([tab])
-
     async def _get_kaleido_tab(self) -> _KaleidoTab:
         _logger.info(f"Getting tab from queue (has {self.tabs_ready.qsize()})")
         if not self._total_tabs:
@@ -236,10 +309,10 @@ def _create_render_task(
                 self._timeout,
             ),
         )
-        # create_task_log_error is a create_task helper, set and forget
-        # to create a task and add a post-run action which checks for
-        # errors and logs them. this pattern is the best i've found
-        # but somehow its still pretty distressing
+
+        # a weak solution to chaining tasks
+        # maybe consider an async closure instead
+        # avoids try/except....
         t.add_done_callback(
             lambda _f: self._tab_requeue_tasks.add(
                 _utils.create_task_log_error(
diff --git a/src/py/pyproject.toml b/src/py/pyproject.toml
index 080be93f..be2965a0 100644
--- a/src/py/pyproject.toml
+++ b/src/py/pyproject.toml
@@ -74,6 +74,7 @@ ignore = [
           "SIM105", # Too opionated (try-except-pass)
           "PT003", # scope="function" implied but I like readability
           "G004", # fstrings in my logs
+          "TD003", # issue link in todos
           ]
 
 [tool.ruff.lint.per-file-ignores]

From e490af7cc5f1aed15a061684e0b927d19f1d2027 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Tue, 2 Sep 2025 12:43:25 -0500
Subject: [PATCH 086/167] Type and improve comments.

---
 src/py/kaleido/_sync_server.py | 36 +++++++++++++++++++++++++++++++---
 1 file changed, 33 insertions(+), 3 deletions(-)

diff --git a/src/py/kaleido/_sync_server.py b/src/py/kaleido/_sync_server.py
index 714fcce2..740bd902 100644
--- a/src/py/kaleido/_sync_server.py
+++ b/src/py/kaleido/_sync_server.py
@@ -11,7 +11,7 @@
 from .kaleido import Kaleido
 
 if TYPE_CHECKING:
-    from typing import Any
+    from typing import Any, Callable
 
 
 class Task(NamedTuple):
@@ -95,7 +95,20 @@ def close(self, *, silence_warnings=False):
         del self._return_queue
         self._initialized = False
 
-    def call_function(self, cmd: str, *args, **kwargs):
+    def call_function(self, cmd: str, *args: Any, **kwargs: Any):
+        """
+        Call any function on the singleton Kaleido object.
+
+        Preferred functions would be: `calc_fig`, `write_fig`, and
+        `write_fig_from_object`. Methods that doesn't exist will raise a
+        BaseException.
+
+        Args:
+            cmd (str): the name of the method to call
+            args (Any): the method's arguments
+            kwargs (Any): the method's keyword arguments
+
+        """
         if not self.is_running():
             raise RuntimeError("Can't call function on stopped server.")
         if kwargs.pop("kopts", None):
@@ -113,7 +126,24 @@ def call_function(self, cmd: str, *args, **kwargs):
             return res
 
 
-def oneshot_async_run(func, args: tuple[Any, ...], kwargs: dict):
+def oneshot_async_run(
+    func: Callable,
+    args: tuple[Any, ...],
+    kwargs: dict[str, Any],
+) -> Any:
+    """
+    Run a thread to execute a single function.
+
+    Used by _sync functions in
+    `__init__` to ensure their async loop is separate from the users main
+    one.
+
+    Args:
+        func: the function to run
+        args: a tuple of arguments to pass
+        kwargs: a dictionary of keyword arguments to pass
+
+    """
     q: Queue[Any] = Queue(maxsize=1)
 
     def run(func, q, *args, **kwargs):

From bd4975935178a73ef5497d2f68176273331dcf7c Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Tue, 2 Sep 2025 13:15:26 -0500
Subject: [PATCH 087/167] Add clarifying comments to _fig_tools.py

---
 src/py/kaleido/_fig_tools.py | 62 ++++++++++++++++++++++--------------
 1 file changed, 38 insertions(+), 24 deletions(-)

diff --git a/src/py/kaleido/_fig_tools.py b/src/py/kaleido/_fig_tools.py
index 30701808..b7aa2f8d 100644
--- a/src/py/kaleido/_fig_tools.py
+++ b/src/py/kaleido/_fig_tools.py
@@ -1,9 +1,18 @@
 """
-Adapted from old code, it 1. validates, 2. write defaults, 3. packages object.
+Tools to help prepare data for plotly.js from kaleido.
 
-Its a bit complicated and mixed in order.
+It 1. validates, 2. write defaults, 3. packages object.
 """
 
+# Adapted from old code, it's mixed in order, it should go in the order above.
+# build_fig_spec should probably be factored out.
+# 1. Validate
+# 2. Write Defaults/Automatics
+# 3. Packages Object
+# The structure should be more readable.
+
+# The main entry point is the last function, build_fig_spec
+
 from __future__ import annotations
 
 import glob
@@ -21,6 +30,25 @@
     Figurish = Any  # Be nice to make it more specific, dictionary or something
     FormatString = Literal["png", "jpg", "jpeg", "webp", "svg", "json", "pdf"]
 
+
+# Input of to_spec (user gives us this)
+class LayoutOpts(TypedDict, total=False):
+    format: FormatString | None
+    scale: int | float
+    height: int | float
+    width: int | float
+
+
+# Output of to_spec (we give kaleido_scopes.js this)
+# refactor note: this could easily be right before send
+class Spec(TypedDict):
+    format: FormatString
+    width: int | float
+    height: int | float
+    scale: int | float
+    data: Figurish
+
+
 _logger = logistro.getLogger(__name__)
 
 # constants
@@ -39,6 +67,7 @@
 )
 
 
+# validation function
 def _assert_format(ext: str) -> TypeGuard[FormatString]:
     if ext not in SUPPORTED_FORMATS:
         raise ValueError(
@@ -47,6 +76,7 @@ def _assert_format(ext: str) -> TypeGuard[FormatString]:
     return True
 
 
+# validation function
 def _is_figurish(o: Any) -> TypeGuard[Figurish]:
     valid = hasattr(o, "to_dict") or (isinstance(o, dict) and "data" in o)
     if not valid:
@@ -58,6 +88,7 @@ def _is_figurish(o: Any) -> TypeGuard[Figurish]:
     return valid
 
 
+# defaults function
 def _get_figure_dimensions(
     layout: dict,
     width: float | None,
@@ -79,6 +110,7 @@ def _get_figure_dimensions(
     return width, height
 
 
+# coercion function
 def _get_format(extension: str) -> FormatString:
     formatted_extension = extension.lower()
     if formatted_extension == "jpg":
@@ -88,25 +120,7 @@ def _get_format(extension: str) -> FormatString:
     return formatted_extension
 
 
-# Input of to_spec (user gives us this)
-class LayoutOpts(TypedDict, total=False):
-    format: FormatString | None
-    scale: int | float
-    height: int | float
-    width: int | float
-
-
-# Output of to_spec (we give kaleido_scopes.js this)
-# refactor note: this could easily be right before send
-class Spec(TypedDict):
-    format: FormatString
-    width: int | float
-    height: int | float
-    scale: int | float
-    data: Figurish
-
-
-# validate configuration options for kaleido.js and package like its wants
+# does additional validation + defaults + packaging
 def to_spec(figure: Figurish, layout_opts: LayoutOpts) -> Spec:
     # Get figure layout
     layout = figure.get("layout", {})
@@ -142,7 +156,7 @@ def to_spec(figure: Figurish, layout_opts: LayoutOpts) -> Spec:
     }
 
 
-# if we need to suffix the filename automatically:
+# provides defaults
 def _next_filename(path: Path | str, prefix: str, ext: str) -> str:
     path = path if isinstance(path, Path) else Path(path)
     default = 1 if (path / f"{prefix}.{ext}").exists() else 0
@@ -160,7 +174,7 @@ def _next_filename(path: Path | str, prefix: str, ext: str) -> str:
     return f"{prefix}.{ext}" if n == 1 else f"{prefix}-{n}.{ext}"
 
 
-# validate and build full route if needed:
+# provides defaults (and validation)
 def _build_full_path(
     path: Path | None,
     fig: Figurish,
@@ -195,7 +209,7 @@ def _build_full_path(
     return full_path
 
 
-# call all validators/automatic config fill-in/packaging in expected format
+# does validation, defaults, and packaging. is main entry point
 def build_fig_spec(
     fig: Figurish,
     path: Path | str | None,

From 0457d455c9c5e4177dd6c02dd9f6693677272b82 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Tue, 2 Sep 2025 13:30:05 -0500
Subject: [PATCH 088/167] More clearly define the URL tuple type.

---
 src/py/kaleido/_page_generator.py | 13 +++++++++----
 1 file changed, 9 insertions(+), 4 deletions(-)

diff --git a/src/py/kaleido/_page_generator.py b/src/py/kaleido/_page_generator.py
index 2fa2bf8e..5ef13b5d 100644
--- a/src/py/kaleido/_page_generator.py
+++ b/src/py/kaleido/_page_generator.py
@@ -1,11 +1,16 @@
 from __future__ import annotations
 
 from pathlib import Path
+from typing import TYPE_CHECKING
 
 import logistro
 
 from . import _utils
 
+if TYPE_CHECKING:
+    UrlAndCharset = tuple[str | Path, str]  # type: TypeAlias
+    """A tuple to explicitly set charset= in the <script> tag."""
+
 _logger = logistro.getLogger(__name__)
 
 DEFAULT_PLOTLY = "https://cdn.plot.ly/plotly-2.35.2.js"
@@ -17,7 +22,7 @@
 KJS_PATH = Path(__file__).resolve().parent / "vendor" / "kaleido_scopes.js"
 
 
-def _ensure_file(path: Path | str | tuple[str | Path, str]) -> None:
+def _ensure_file(path: Path | str | UrlAndCharset) -> None:
     if isinstance(path, tuple):
         path = path[0]
     if isinstance(path, Path):
@@ -65,9 +70,9 @@ class PageGenerator:
     def __init__(  # noqa: C901
         self,
         *,
-        plotly: None | Path | str | tuple[Path | str, str] = None,
-        mathjax: None | Path | str | bool | tuple[Path | str, str] = None,
-        others: None | list[Path | str | tuple[Path | str, str]] = None,
+        plotly: None | Path | str | UrlAndCharset = None,
+        mathjax: None | Path | str | bool | UrlAndCharset = None,
+        others: None | list[Path | str | UrlAndCharset] = None,
         force_cdn: bool = False,
     ):
         """

From f59af18038bed79c3d89e0aec29a06d946d3ff88 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Tue, 2 Sep 2025 13:41:08 -0500
Subject: [PATCH 089/167] Clarify compatability version error.

---
 src/py/kaleido/_utils.py | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/src/py/kaleido/_utils.py b/src/py/kaleido/_utils.py
index 820b61d3..be5a1260 100644
--- a/src/py/kaleido/_utils.py
+++ b/src/py/kaleido/_utils.py
@@ -88,7 +88,10 @@ def warn_incompatible_plotly():
                 "This means that static image generation (e.g. `fig.write_image()`) "
                 "will not work.\n\n"
                 f"Please upgrade Plotly to version {min_compatible_plotly_version} "
-                "or greater, or downgrade Kaleido to version 0.2.1."
+                "or greater, or downgrade Kaleido to version 0.2.1.\n\n"
+                "You can however, use the Kaleido API directly which will work "
+                "with your plotly version. `kaleido.write_fig(...)`, for example. "
+                "Please see the kaleido documentation."
                 "\n",
                 UserWarning,
                 stacklevel=3,

From cf0e395f7320ee3ead0b4802e9a9355814e2ef42 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Tue, 2 Sep 2025 13:43:28 -0500
Subject: [PATCH 090/167] Remove noqa for TOOD

---
 src/py/kaleido/_kaleido_tab.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/py/kaleido/_kaleido_tab.py b/src/py/kaleido/_kaleido_tab.py
index 7af72181..8487792b 100644
--- a/src/py/kaleido/_kaleido_tab.py
+++ b/src/py/kaleido/_kaleido_tab.py
@@ -21,7 +21,7 @@
 _TEXT_FORMATS = ("svg", "json")  # eps
 
 
-class JavascriptError(RuntimeError):  # TODO(A): process better # noqa: TD003, FIX002
+class JavascriptError(RuntimeError):  # TODO(AJP): process better
     """Used to report errors from javascript."""
 
 
@@ -66,7 +66,7 @@ def _make_console_logger(name, log):
     """Create printer specifically for console events. Helper function."""
 
     async def console_printer(event):
-        _logger.debug2(f"{name}:{event}")  # TODO(A): parse # noqa: TD003, FIX002
+        _logger.debug2(f"{name}:{event}")  # TODO(AJP): parse? stretch goal.
         log.append(str(event))
 
     return console_printer

From 316fe3bfe9af25dc9ac5e9b477bc8496366e387a Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Tue, 2 Sep 2025 13:47:34 -0500
Subject: [PATCH 091/167] Rename functions for clarity.

---
 src/py/kaleido/_kaleido_tab.py | 28 ++++++++++++++++------------
 1 file changed, 16 insertions(+), 12 deletions(-)

diff --git a/src/py/kaleido/_kaleido_tab.py b/src/py/kaleido/_kaleido_tab.py
index 8487792b..6254c81f 100644
--- a/src/py/kaleido/_kaleido_tab.py
+++ b/src/py/kaleido/_kaleido_tab.py
@@ -27,7 +27,11 @@ class JavascriptError(RuntimeError):  # TODO(AJP): process better
 
 ### Error definitions ###
 class KaleidoError(Exception):
-    """An error to interpret errors from Kaleido's JS side."""
+    """
+    An error to interpret errors from Kaleido's JS side.
+
+    This is not for all js errors, just kaleido_scopes.js errors.
+    """
 
     def __init__(self, code, message):
         """
@@ -47,7 +51,7 @@ def __str__(self):
         return f"Error {self._code}: {self._message}"
 
 
-def _check_error_ret(result):
+def _get_error(result):
     """Check browser response for errors. Helper function."""
     if "error" in result:
         return DevtoolsProtocolError(result)
@@ -56,8 +60,8 @@ def _check_error_ret(result):
     return None
 
 
-def _check_error(result):
-    e = _check_error_ret(result)
+def _raise_error(result):
+    e = _get_error(result)
     if e:
         raise e
 
@@ -76,7 +80,7 @@ class _KaleidoTab:
     """
     A Kaleido tab is a wrapped choreographer tab providing the functions we need.
 
-    The choreographer tab can be access through the `self.tab` attribute.
+    The choreographer tab can be accessed through the `self.tab` attribute.
     """
 
     tab: choreo.Tab
@@ -124,12 +128,12 @@ async def navigate(self, url: str | Path = ""):
             page_ready = tab.subscribe_once("Page.loadEventFired")
 
         _logger.debug2(f"Calling Page.navigate on {tab}")
-        _check_error(await tab.send_command("Page.navigate", params={"url": url}))
+        _raise_error(await tab.send_command("Page.navigate", params={"url": url}))
         # Must enable after navigating.
         _logger.debug2(f"Calling Page.enable on {tab}")
-        _check_error(await tab.send_command("Page.enable"))
+        _raise_error(await tab.send_command("Page.enable"))
         _logger.debug2(f"Calling Runtime.enable on {tab}")
-        _check_error(await tab.send_command("Runtime.enable"))
+        _raise_error(await tab.send_command("Runtime.enable"))
 
         await javascript_ready
         self._current_js_id = (
@@ -159,7 +163,7 @@ async def reload(self):
             _logger.debug2("Clearing an old Page.loadEventFired")
             is_loaded = tab.subscribe_once("Page.loadEventFired")
         _logger.debug2(f"Calling Page.reload on {tab}")
-        _check_error(await tab.send_command("Page.reload"))
+        _raise_error(await tab.send_command("Page.reload"))
         await javascript_ready
         self._current_js_id = (
             javascript_ready.result()
@@ -196,7 +200,7 @@ async def console_print(self, message: str) -> None:
         _logger.debug("Calling js function")
         result = await self.tab.send_command("Runtime.callFunctionOn", params=params)
         _logger.debug(f"Sent javascript got result: {result}")
-        _check_error(result)
+        _raise_error(result)
 
     def _finish_profile(self, profile, state, error=None):
         _logger.debug("Finishing profile")
@@ -308,7 +312,7 @@ async def _calc_fig(  # noqa: C901, PLR0912, complexity, branches
         if profile:
             profile["state"] = "SENT"
         _logger.info(f"Sent big command for {full_path.name}.")
-        e = _check_error_ret(result)
+        e = _get_error(result)
         if e:
             if profiler is not None:
                 self._finish_profile(profile, "ERROR", e)
@@ -366,7 +370,7 @@ async def _img_from_response(self, response):
                 "Page.printToPDF",
                 params=pdf_params,
             )
-            e = _check_error_ret(pdf_response)
+            e = _get_error(pdf_response)
             if e:
                 return e
             img = pdf_response.get("result").get("data")

From 84afca4c3d49ea7d5076e08f6d969a4ea03e1a89 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Tue, 2 Sep 2025 17:16:20 -0500
Subject: [PATCH 092/167] Refactor calc_fig in _kaleido_tab.

---
 src/py/kaleido/_kaleido_tab.py                | 382 ------------------
 src/py/kaleido/_kaleido_tab/__init__.py       | 149 +++++++
 .../kaleido/_kaleido_tab/_devtools_utils.py   | 128 ++++++
 src/py/kaleido/_kaleido_tab/_errors.py        |  46 +++
 src/py/kaleido/_kaleido_tab/_js_logger.py     |  45 +++
 5 files changed, 368 insertions(+), 382 deletions(-)
 delete mode 100644 src/py/kaleido/_kaleido_tab.py
 create mode 100644 src/py/kaleido/_kaleido_tab/__init__.py
 create mode 100644 src/py/kaleido/_kaleido_tab/_devtools_utils.py
 create mode 100644 src/py/kaleido/_kaleido_tab/_errors.py
 create mode 100644 src/py/kaleido/_kaleido_tab/_js_logger.py

diff --git a/src/py/kaleido/_kaleido_tab.py b/src/py/kaleido/_kaleido_tab.py
deleted file mode 100644
index 6254c81f..00000000
--- a/src/py/kaleido/_kaleido_tab.py
+++ /dev/null
@@ -1,382 +0,0 @@
-from __future__ import annotations
-
-import base64
-import json
-import time
-from typing import TYPE_CHECKING
-
-import logistro
-from choreographer.errors import DevtoolsProtocolError
-
-from ._utils import ErrorEntry, to_thread
-
-if TYPE_CHECKING:
-    from pathlib import Path
-    from typing import Any
-
-    import choreographer as choreo
-
-_logger = logistro.getLogger(__name__)
-
-_TEXT_FORMATS = ("svg", "json")  # eps
-
-
-class JavascriptError(RuntimeError):  # TODO(AJP): process better
-    """Used to report errors from javascript."""
-
-
-### Error definitions ###
-class KaleidoError(Exception):
-    """
-    An error to interpret errors from Kaleido's JS side.
-
-    This is not for all js errors, just kaleido_scopes.js errors.
-    """
-
-    def __init__(self, code, message):
-        """
-        Construct an error object.
-
-        Args:
-            code: the number code of the error.
-            message: the message of the error.
-
-        """
-        super().__init__(message)
-        self._code = code
-        self._message = message
-
-    def __str__(self):
-        """Display the KaleidoError nicely."""
-        return f"Error {self._code}: {self._message}"
-
-
-def _get_error(result):
-    """Check browser response for errors. Helper function."""
-    if "error" in result:
-        return DevtoolsProtocolError(result)
-    if result.get("result", {}).get("result", {}).get("subtype", None) == "error":
-        return JavascriptError(str(result.get("result")))
-    return None
-
-
-def _raise_error(result):
-    e = _get_error(result)
-    if e:
-        raise e
-
-
-def _make_console_logger(name, log):
-    """Create printer specifically for console events. Helper function."""
-
-    async def console_printer(event):
-        _logger.debug2(f"{name}:{event}")  # TODO(AJP): parse? stretch goal.
-        log.append(str(event))
-
-    return console_printer
-
-
-class _KaleidoTab:
-    """
-    A Kaleido tab is a wrapped choreographer tab providing the functions we need.
-
-    The choreographer tab can be accessed through the `self.tab` attribute.
-    """
-
-    tab: choreo.Tab
-    """The underlying choreographer tab."""
-
-    javascript_log: list[Any]
-    """A list of console outputs from the tab."""
-
-    def _regenerate_javascript_console(self):
-        self.javascript_log = []
-        self.tab.unsubscribe("Runtime.consoleAPICalled")
-        self.tab.subscribe(
-            "Runtime.consoleAPICalled",
-            _make_console_logger("tab js console", self.javascript_log),
-        )
-
-    def __init__(self, tab, *, _stepper=False):
-        """
-        Create a new _KaleidoTab.
-
-        Args:
-            tab: the choreographer tab to wrap.
-
-        """
-        self.tab = tab
-        self.javascript_log = []
-        self._stepper = _stepper
-
-    async def navigate(self, url: str | Path = ""):
-        """
-        Navigate to the kaleidofier script. This is effectively the real initialization.
-
-        Args:
-            url: Override the location of the kaleidofier script if necessary.
-
-        """
-        tab = self.tab
-        javascript_ready = tab.subscribe_once("Runtime.executionContextCreated")
-        while javascript_ready.done():
-            _logger.debug2("Clearing an old Runtime.executionContextCreated")
-            javascript_ready = tab.subscribe_once("Runtime.executionContextCreated")
-        page_ready = tab.subscribe_once("Page.loadEventFired")
-        while page_ready.done():
-            _logger.debug2("Clearing a old Page.loadEventFired")
-            page_ready = tab.subscribe_once("Page.loadEventFired")
-
-        _logger.debug2(f"Calling Page.navigate on {tab}")
-        _raise_error(await tab.send_command("Page.navigate", params={"url": url}))
-        # Must enable after navigating.
-        _logger.debug2(f"Calling Page.enable on {tab}")
-        _raise_error(await tab.send_command("Page.enable"))
-        _logger.debug2(f"Calling Runtime.enable on {tab}")
-        _raise_error(await tab.send_command("Runtime.enable"))
-
-        await javascript_ready
-        self._current_js_id = (
-            javascript_ready.result()
-            .get("params", {})
-            .get("context", {})
-            .get("id", None)
-        )
-        if not self._current_js_id:
-            raise RuntimeError(
-                "Refresh sequence didn't work for reload_tab_with_javascript."
-                "Result {javascript_ready.result()}.",
-            )
-        await page_ready
-        self._regenerate_javascript_console()
-
-    async def reload(self):
-        """Reload the tab, and set the javascript runtime id."""
-        tab = self.tab
-        _logger.debug(f"Reloading tab {tab} with javascript.")
-        javascript_ready = tab.subscribe_once("Runtime.executionContextCreated")
-        while javascript_ready.done():
-            _logger.debug2("Clearing an old Runtime.executionContextCreated")
-            javascript_ready = tab.subscribe_once("Runtime.executionContextCreated")
-        is_loaded = tab.subscribe_once("Page.loadEventFired")
-        while is_loaded.done():
-            _logger.debug2("Clearing an old Page.loadEventFired")
-            is_loaded = tab.subscribe_once("Page.loadEventFired")
-        _logger.debug2(f"Calling Page.reload on {tab}")
-        _raise_error(await tab.send_command("Page.reload"))
-        await javascript_ready
-        self._current_js_id = (
-            javascript_ready.result()
-            .get("params", {})
-            .get("context", {})
-            .get("id", None)
-        )
-        if not self._current_js_id:
-            raise RuntimeError(
-                "Refresh sequence didn't work for reload_tab_with_javascript."
-                "Result {javascript_ready.result()}.",
-            )
-        await is_loaded
-        self._regenerate_javascript_console()
-
-    async def console_print(self, message: str) -> None:
-        """
-        Print something to the javascript console.
-
-        Args:
-            message: The thing to print.
-
-        """
-        jsfn = r"function()" r"{" f"console.log('{message}')" r"}"
-        params = {
-            "functionDeclaration": jsfn,
-            "returnByValue": False,
-            "userGesture": True,
-            "awaitPromise": True,
-            "executionContextId": self._current_js_id,
-        }
-
-        # send request to run script in chromium
-        _logger.debug("Calling js function")
-        result = await self.tab.send_command("Runtime.callFunctionOn", params=params)
-        _logger.debug(f"Sent javascript got result: {result}")
-        _raise_error(result)
-
-    def _finish_profile(self, profile, state, error=None):
-        _logger.debug("Finishing profile")
-        profile["duration"] = float(f"{time.perf_counter() - profile['start']:.6f}")
-        del profile["start"]
-        profile["state"] = state
-        if self.javascript_log:
-            profile["js_console"] = self.javascript_log
-        if error:
-            profile["error"] = error
-
-    async def _write_fig(
-        self,
-        spec,
-        full_path,
-        *,
-        topojson=None,
-        error_log=None,
-        profiler=None,
-    ):
-        """Calculate and write figure to file. Wraps _calc_fig, and writes a file."""
-        img, profile = await self._calc_fig(
-            spec,
-            full_path,
-            topojson=topojson,
-            error_log=error_log,
-            profiler=profiler,
-        )
-
-        def write_image(binary):
-            with full_path.open("wb") as file:
-                file.write(binary)
-
-        _logger.info(f"Starting write of {full_path.name}")
-        await to_thread(write_image, img)
-        _logger.info(f"Wrote {full_path.name}")
-
-        if profile is not None:
-            profile["megabytes"] = full_path.stat().st_size / 1000000
-            profile["state"] = "WROTE"
-
-    async def _calc_fig(  # noqa: C901, PLR0912, complexity, branches
-        self,
-        spec,
-        full_path,
-        *,
-        topojson=None,
-        error_log=None,
-        profiler=None,
-    ):
-        """
-        Call the plotly renderer via javascript.
-
-        Args:
-            spec: the processed plotly figure
-            full_path: the path to write the image too. if its a directory, we will try
-                to generate a name. If the path contains an extension,
-                "path/to/my_image.png", that extension will be the format used if not
-                overridden in `opts`.
-            opts: dictionary describing format, width, height, and scale of image
-            topojson: topojsons are used to customize choropleths
-            error_log: A supplied list, will be populated with `ErrorEntry`s
-                       which can be converted to strings. Note, this is for
-                       collections errors that have to do with plotly. They will
-                       not be thrown. Lower level errors (kaleido, choreographer)
-                       will still be thrown. If not passed, all errors raise.
-            profiler: a supplied dictionary to collect stats about the operation
-
-        """
-        tab = self.tab
-        execution_context_id = self._current_js_id
-        if profiler is not None:
-            profile = {
-                "name": full_path.name,
-                "start": time.perf_counter(),
-                "state": "INIT",
-            }
-        else:
-            profile = None
-
-        _logger.debug(f"In tab {tab.target_id[:4]} calc_fig for {full_path.name}.")
-
-        _logger.info(f"Processing {full_path.name}")
-        # js script
-        kaleido_jsfn = (
-            r"function(spec, ...args)"
-            r"{"
-            r"return kaleido_scopes.plotly(spec, ...args).then(JSON.stringify);"
-            r"}"
-        )
-
-        # params
-        arguments = [{"value": spec}]
-        arguments.append({"value": topojson if topojson else None})
-        arguments.append({"value": self._stepper})
-        params = {
-            "functionDeclaration": kaleido_jsfn,
-            "arguments": arguments,
-            "returnByValue": False,
-            "userGesture": True,
-            "awaitPromise": True,
-            "executionContextId": execution_context_id,
-        }
-
-        _logger.info(f"Sending big command for {full_path.name}.")
-        if profile:
-            profile["state"] = "SENDING"
-        result = await tab.send_command("Runtime.callFunctionOn", params=params)
-        if profile:
-            profile["state"] = "SENT"
-        _logger.info(f"Sent big command for {full_path.name}.")
-        e = _get_error(result)
-        if e:
-            if profiler is not None:
-                self._finish_profile(profile, "ERROR", e)
-                profiler[tab.target_id].append(profile)
-            if error_log is not None:
-                error_log.append(ErrorEntry(full_path.name, e, self.javascript_log))
-                _logger.error(f"Failed {full_path.name}", exc_info=e)
-            else:
-                _logger.error(f"Raising error on {full_path.name}")
-                raise e
-        _logger.debug2(f"Result of function call: {result}")
-        if self._stepper:
-            print(f"Image {full_path.name} was sent to browser")  # noqa: T201
-            input("Press Enter to continue...")
-        if e:
-            return None, None
-
-        img = await self._img_from_response(result)
-        if isinstance(img, BaseException):
-            if profiler is not None:
-                self._finish_profile(profile, "ERROR", img)
-                profiler[tab.target_id].append(profile)
-            if error_log is not None:
-                error_log.append(
-                    ErrorEntry(full_path.name, img, self.javascript_log),
-                )
-                _logger.info(f"Failed {full_path.name}")
-                return None, None
-            else:
-                raise img
-        if profile:
-            self._finish_profile(profile, "CALCULATED", None)
-            profiler[tab.target_id].append(profile)
-        return img, profile
-
-    async def _img_from_response(self, response):
-        js_response = json.loads(response.get("result").get("result").get("value"))
-
-        if js_response["code"] != 0:
-            return KaleidoError(js_response["code"], js_response["message"])
-
-        response_format = js_response.get("format")
-        img = js_response.get("result")
-        if response_format == "pdf":
-            pdf_params = {
-                "printBackground": True,
-                "marginTop": 0.1,
-                "marginBottom": 0.1,
-                "marginLeft": 0.1,
-                "marginRight": 0.1,
-                "preferCSSPageSize": True,
-                "pageRanges": "1",
-            }
-            pdf_response = await self.tab.send_command(
-                "Page.printToPDF",
-                params=pdf_params,
-            )
-            e = _get_error(pdf_response)
-            if e:
-                return e
-            img = pdf_response.get("result").get("data")
-        # Base64 decode binary types
-        if response_format not in _TEXT_FORMATS:
-            img = base64.b64decode(img)
-        else:
-            img = str.encode(img)
-        return img
diff --git a/src/py/kaleido/_kaleido_tab/__init__.py b/src/py/kaleido/_kaleido_tab/__init__.py
new file mode 100644
index 00000000..d20ab313
--- /dev/null
+++ b/src/py/kaleido/_kaleido_tab/__init__.py
@@ -0,0 +1,149 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+import logistro
+
+from . import _devtools_utils as _dtools
+from . import _js_logger
+from ._errors import _raise_error
+from ._utils import to_thread
+
+if TYPE_CHECKING:
+    import asyncio
+    from pathlib import Path
+
+    import choreographer as choreo
+
+    from kaleido import _fig_tools
+
+_logger = logistro.getLogger(__name__)
+
+
+def _subscribe_new(tab: choreo.Tab, event: str) -> asyncio.Future:
+    """Create subscription to tab clearing old ones first: helper function."""
+    new_future = tab.subscribe_once(event)
+    while new_future.done():
+        _logger.debug2(f"Clearing an old {event}")
+        new_future = tab.subscribe_once(event)
+    return new_future
+
+
+class _KaleidoTab:
+    """
+    A Kaleido tab is a wrapped choreographer tab providing the functions we need.
+
+    The choreographer tab can be accessed through the `self.tab` attribute.
+    """
+
+    tab: choreo.Tab
+    """The underlying choreographer tab."""
+    js_logger: _js_logger.JavascriptLogger
+    """A log for recording javascript."""
+
+    def __init__(self, tab, *, _stepper=False):
+        """
+        Create a new _KaleidoTab.
+
+        Args:
+            tab: the choreographer tab to wrap.
+
+        """
+        self.tab = tab
+        self.js_logger = _js_logger.JavascriptLogger()
+        self._stepper = _stepper
+
+    async def navigate(self, url: str | Path = ""):
+        """
+        Navigate to the kaleidofier script. This is effectively the real initialization.
+
+        Args:
+            url: Override the location of the kaleidofier script if necessary.
+
+        """
+        # Subscribe to event which will contain javascript engine ID (need it
+        # for calling javascript functions)
+        javascript_ready = _subscribe_new(self.tab, "Runtime.executionContextCreated")
+
+        # Subscribe to event indicating page ready.
+        page_ready = _subscribe_new(self.tab, "Page.loadEventFired")
+
+        # Navigating page. This will trigger the above events.
+        _logger.debug2(f"Calling Page.navigate on {self.tab}")
+        _raise_error(await self.tab.send_command("Page.navigate", params={"url": url}))
+
+        # Enabling page events (for page_ready- like all events, if already
+        # ready, the latest will fire immediately)
+        _logger.debug2(f"Calling Page.enable on {self.tab}")
+        _raise_error(await self.tab.send_command("Page.enable"))
+
+        # Enabling javascript events (for javascript_ready)
+        _logger.debug2(f"Calling Runtime.enable on {self.tab}")
+        _raise_error(await self.tab.send_command("Runtime.enable"))
+
+        self._current_js_id = _dtools.get_js_id(await javascript_ready)
+
+        await page_ready  # don't care result, ready is ready
+
+        # might miss console stuff, would need to
+        # catch an intermediate event and run it via callback
+        # catches all render errors though
+        self.js_logger.reset()
+
+    # reload is truly so close to navigate
+    async def reload(self):
+        """Reload the tab, and set the javascript runtime id."""
+        _logger.debug(f"Reloading tab {self.tab} with javascript.")
+
+        javascript_ready = _subscribe_new(self.tab, "Runtime.executionContextCreated")
+
+        page_ready = _subscribe_new(self.tab, "Page.loadEventFired")
+
+        _logger.debug2(f"Calling Page.reload on {self.tab}")
+        _raise_error(await self.tab.send_command("Page.reload"))
+
+        self._current_js_id = _dtools.get_js_id(await javascript_ready)
+
+        await page_ready
+
+        self.js_logger.reset()
+
+    async def _calc_fig(
+        self,
+        spec: _fig_tools.Spec,
+        full_path: Path,
+        *,
+        topojson: str | None = None,
+        **_kwargs,
+    ):
+        _kwargs.pop("error_log", None)  # not used at the moment
+        _kwargs.pop("profiler", None)  # not used at the moment
+
+        _logger.debug(f"In tab {self.tab.target_id[:4]} calc_fig for {full_path.name}.")
+        _logger.info(f"Processing {full_path.name}")
+
+        # js script
+        kaleido_js_fn = (
+            r"function(spec, ...args)"
+            r"{"
+            r"return kaleido_scopes.plotly(spec, ...args).then(JSON.stringify);"
+            r"}"
+        )
+
+        _logger.info(f"Sending big command for {full_path.name}.")
+        result = await _dtools.exec_js_fn(
+            self.tab,
+            self._current_js_id,
+            kaleido_js_fn,
+            spec,
+            topojson,
+            self._stepper,
+        )
+        _raise_error(result)
+
+        _logger.debug2(f"Result of function call: {result}")
+
+        img_bytes, error = await _dtools.get_bytes(result)
+        if error:
+            raise error
+        return img_bytes
diff --git a/src/py/kaleido/_kaleido_tab/_devtools_utils.py b/src/py/kaleido/_kaleido_tab/_devtools_utils.py
new file mode 100644
index 00000000..909e5268
--- /dev/null
+++ b/src/py/kaleido/_kaleido_tab/_devtools_utils.py
@@ -0,0 +1,128 @@
+"""Contains both DevTools protocol and kaleido_scopes.js helper fns."""
+
+from __future__ import annotations
+
+import base64
+import json
+from typing import TYPE_CHECKING
+
+import logistro
+
+from ._errors import JavascriptError, KaleidoError, _get_error, _raise_error
+
+if TYPE_CHECKING:
+    from typing import Any
+
+    import choreographer
+
+_logger = logistro.getLogger(__name__)
+
+
+def get_js_id(result) -> int:
+    """Grab javascript engine ID from a chrome executionContextStarted event."""
+    if _id := result.get("params", {}).get("context", {}).get("id", None):
+        return _id
+    raise RuntimeError(
+        "Refresh sequence didn't work for reload_tab_with_javascript."
+        "Result {javascript_ready.result()}.",
+    )
+
+
+async def console_print(tab: choreographer.Tab, js_id: int, message: str) -> None:
+    """
+    Print something to the javascript console.
+
+    Note: tab and js_id need to specified separately
+
+    Args:
+        tab: the choreographer tab to print on
+        js_id: the javascript engine id to print on
+        message: The thing to print.
+
+    """
+    fn = r"function()" r"{" f"console.log('{message}')" r"}"
+    params = {
+        "functionDeclaration": fn,
+        "returnByValue": False,
+        "userGesture": True,
+        "awaitPromise": True,
+        "executionContextId": js_id,
+    }
+
+    # send request to run script in chromium
+    _logger.debug("Calling js function")
+    result = await tab.send_command("Runtime.callFunctionOn", params=params)
+    _logger.debug(f"Sent javascript got result: {result}")
+    _raise_error(result)
+
+
+async def exec_js_fn(
+    tab: choreographer.Tab,
+    js_id: int,
+    fn: str,
+    *args: Any,
+):
+    args_structured = [{"value": arg} for arg in args]
+    params = {
+        "functionDeclaration": fn,
+        "arguments": args_structured,
+        "returnByValue": False,
+        "userGesture": True,
+        "awaitPromise": True,
+        "executionContextId": js_id,
+    }
+    return await tab.send_command("Runtime.callFunctionOn", params=params)
+
+
+_TEXT_FORMATS = ("svg", "json")  # eps
+
+
+async def get_bytes(self, response) -> tuple[None, bytes, None | Exception]:
+    # TODO(AJP) provoke a js error and return js error
+
+    # check_js could be another function, the next two sections should be
+    # factored out
+    js_response = json.loads(
+        response.get(
+            "result",
+            {},
+        )
+        .get(
+            "result",
+            {},
+        )
+        .get(
+            "value",
+        ),
+    )
+
+    if js_response["code"] != 0:
+        return None, KaleidoError(js_response["code"], js_response["message"])
+
+    # this shouldn't be in here
+    if (response_format := js_response.get("format")) == "pdf":
+        pdf_params = {
+            "printBackground": True,
+            "marginTop": 0.1,
+            "marginBottom": 0.1,
+            "marginLeft": 0.1,
+            "marginRight": 0.1,
+            "preferCSSPageSize": True,
+            "pageRanges": "1",
+        }
+        pdf_response = await self.tab.send_command(
+            "Page.printToPDF",
+            params=pdf_params,
+        )
+        e = _get_error(pdf_response)
+        if e:
+            return e
+        img_raw = pdf_response.get("result").get("data")
+    else:
+        img_raw = js_response.get("result")
+
+    # Base64 decode binary types
+    if response_format not in _TEXT_FORMATS:
+        return base64.b64decode(img_raw), None
+    else:
+        return str.encode(img_raw), None
diff --git a/src/py/kaleido/_kaleido_tab/_errors.py b/src/py/kaleido/_kaleido_tab/_errors.py
new file mode 100644
index 00000000..4516d7ad
--- /dev/null
+++ b/src/py/kaleido/_kaleido_tab/_errors.py
@@ -0,0 +1,46 @@
+from choreographer.errors import DevtoolsProtocolError
+
+
+class JavascriptError(RuntimeError):  # TODO(AJP): process better
+    """Used to report errors from javascript."""
+
+
+### Error definitions ###
+class KaleidoError(Exception):
+    """
+    An error to interpret errors from Kaleido's JS side.
+
+    This is not for all js errors, just kaleido_scopes.js errors.
+    """
+
+    def __init__(self, code, message):
+        """
+        Construct an error object.
+
+        Args:
+            code: the number code of the error.
+            message: the message of the error.
+
+        """
+        super().__init__(message)
+        self._code = code
+        self._message = message
+
+    def __str__(self):
+        """Display the KaleidoError nicely."""
+        return f"Error {self._code}: {self._message}"
+
+
+def _get_error(result):
+    """Check browser response for errors. Helper function."""
+    if "error" in result:
+        return DevtoolsProtocolError(result)
+    if result.get("result", {}).get("result", {}).get("subtype", None) == "error":
+        return JavascriptError(str(result.get("result")))
+    return None
+
+
+def _raise_error(result):
+    e = _get_error(result)
+    if e:
+        raise e
diff --git a/src/py/kaleido/_kaleido_tab/_js_logger.py b/src/py/kaleido/_kaleido_tab/_js_logger.py
new file mode 100644
index 00000000..6b0e11f8
--- /dev/null
+++ b/src/py/kaleido/_kaleido_tab/_js_logger.py
@@ -0,0 +1,45 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+import logistro
+
+_logger = logistro.getLogger(__name__)
+
+if TYPE_CHECKING:
+    from typing import Any
+
+    import choreographer
+
+
+def _make_console_logger(name, log):  # TODO(AJP) how do we use this
+    """Create printer specifically for console events. Helper function."""
+
+    async def console_printer(event):
+        _logger.debug2(f"{name}:{event}")  # TODO(AJP): parse? stretch goal.
+        log.append(str(event))
+
+    return console_printer
+
+
+class JavascriptLogger:
+    log: list[Any]
+    """A list of console outputs from the tab."""
+
+    def __init__(self) -> None:
+        self.log = []
+
+    def activate(self, tab: choreographer.Tab):
+        tab.unsubscribe("Runtime.consoleAPICalled")
+        tab.subscribe(
+            "Runtime.consoleAPICalled",
+            _make_console_logger("tab js console", self.javascript_log),
+        )
+
+    def reset(self, tab: choreographer.Tab):
+        tab.unsubscribe("Runtime.consoleAPICalled")
+        self.log = []
+        tab.subscribe(
+            "Runtime.consoleAPICalled",
+            _make_console_logger("tab js console", self.javascript_log),
+        )

From cd6b47140e28ec82e76f516e93311f4e22432684 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Tue, 2 Sep 2025 18:29:05 -0500
Subject: [PATCH 093/167] Fix typing errors.

---
 src/py/kaleido/_kaleido_tab/__init__.py       | 32 +++++++-
 .../kaleido/_kaleido_tab/_devtools_utils.py   | 75 ++++++++++---------
 src/py/kaleido/_kaleido_tab/_js_logger.py     | 19 ++---
 src/py/kaleido/_page_generator.py             |  6 +-
 4 files changed, 81 insertions(+), 51 deletions(-)

diff --git a/src/py/kaleido/_kaleido_tab/__init__.py b/src/py/kaleido/_kaleido_tab/__init__.py
index d20ab313..babe394f 100644
--- a/src/py/kaleido/_kaleido_tab/__init__.py
+++ b/src/py/kaleido/_kaleido_tab/__init__.py
@@ -1,13 +1,15 @@
 from __future__ import annotations
 
+import base64
 from typing import TYPE_CHECKING
 
 import logistro
 
+from kaleido._utils import to_thread
+
 from . import _devtools_utils as _dtools
 from . import _js_logger
 from ._errors import _raise_error
-from ._utils import to_thread
 
 if TYPE_CHECKING:
     import asyncio
@@ -17,6 +19,9 @@
 
     from kaleido import _fig_tools
 
+
+_TEXT_FORMATS = ("svg", "json")  # eps
+
 _logger = logistro.getLogger(__name__)
 
 
@@ -50,7 +55,7 @@ def __init__(self, tab, *, _stepper=False):
 
         """
         self.tab = tab
-        self.js_logger = _js_logger.JavascriptLogger()
+        self.js_logger = _js_logger.JavascriptLogger(self.tab)
         self._stepper = _stepper
 
     async def navigate(self, url: str | Path = ""):
@@ -141,9 +146,28 @@ async def _calc_fig(
         )
         _raise_error(result)
 
+        # TODO(AJP): better define these error mechanics, is this a devtools
+        # function or what
+        # upon implementation of error, might not be necessary
+        # to do these go-lang/c style returns
+        # but we have to collect and associate
+        # with the gather + profile
+        # None-non return values are a problem
+        # In general, need to better understand stuff here
+
         _logger.debug2(f"Result of function call: {result}")
+        js_response, error = _dtools.check_kaleido_js_response(result)
+        if error:
+            raise error
 
-        img_bytes, error = await _dtools.get_bytes(result)
+        if (response_format := js_response.get("format")) == "pdf":
+            img_raw, error = await _dtools.print_pdf(self.tab)
+        else:
+            img_raw = js_response.get("result")  # type: ignore[assignment]
         if error:
             raise error
-        return img_bytes
+
+        if response_format not in _TEXT_FORMATS:
+            return base64.b64decode(img_raw), None
+        else:
+            return str.encode(img_raw), None
diff --git a/src/py/kaleido/_kaleido_tab/_devtools_utils.py b/src/py/kaleido/_kaleido_tab/_devtools_utils.py
index 909e5268..c44a9ca5 100644
--- a/src/py/kaleido/_kaleido_tab/_devtools_utils.py
+++ b/src/py/kaleido/_kaleido_tab/_devtools_utils.py
@@ -2,7 +2,6 @@
 
 from __future__ import annotations
 
-import base64
 import json
 from typing import TYPE_CHECKING
 
@@ -74,14 +73,13 @@ async def exec_js_fn(
     return await tab.send_command("Runtime.callFunctionOn", params=params)
 
 
-_TEXT_FORMATS = ("svg", "json")  # eps
-
-
-async def get_bytes(self, response) -> tuple[None, bytes, None | Exception]:
+def check_kaleido_js_response(
+    response,
+) -> tuple[
+    dict,
+    Exception | None,
+]:
     # TODO(AJP) provoke a js error and return js error
-
-    # check_js could be another function, the next two sections should be
-    # factored out
     js_response = json.loads(
         response.get(
             "result",
@@ -95,34 +93,37 @@ async def get_bytes(self, response) -> tuple[None, bytes, None | Exception]:
             "value",
         ),
     )
+    if not js_response:  # not loved, neither {}
+        return {}, RuntimeError(
+            f"JS Response not understood: {response}",
+        )
 
     if js_response["code"] != 0:
-        return None, KaleidoError(js_response["code"], js_response["message"])
-
-    # this shouldn't be in here
-    if (response_format := js_response.get("format")) == "pdf":
-        pdf_params = {
-            "printBackground": True,
-            "marginTop": 0.1,
-            "marginBottom": 0.1,
-            "marginLeft": 0.1,
-            "marginRight": 0.1,
-            "preferCSSPageSize": True,
-            "pageRanges": "1",
-        }
-        pdf_response = await self.tab.send_command(
-            "Page.printToPDF",
-            params=pdf_params,
-        )
-        e = _get_error(pdf_response)
-        if e:
-            return e
-        img_raw = pdf_response.get("result").get("data")
-    else:
-        img_raw = js_response.get("result")
-
-    # Base64 decode binary types
-    if response_format not in _TEXT_FORMATS:
-        return base64.b64decode(img_raw), None
-    else:
-        return str.encode(img_raw), None
+        return {}, KaleidoError(js_response["code"], js_response["message"])
+
+    return js_response
+
+
+async def print_pdf(
+    tab: choreographer.Tab,
+) -> tuple[
+    str,
+    Exception | None,
+]:
+    pdf_params = {
+        "printBackground": True,
+        "marginTop": 0.1,
+        "marginBottom": 0.1,
+        "marginLeft": 0.1,
+        "marginRight": 0.1,
+        "preferCSSPageSize": True,
+        "pageRanges": "1",
+    }
+    pdf_response = await tab.send_command(
+        "Page.printToPDF",
+        params=pdf_params,
+    )
+    e = _get_error(pdf_response)
+    if e:
+        return "", e
+    return pdf_response.get("result", {}).get("data"), None
diff --git a/src/py/kaleido/_kaleido_tab/_js_logger.py b/src/py/kaleido/_kaleido_tab/_js_logger.py
index 6b0e11f8..2f7fb7fe 100644
--- a/src/py/kaleido/_kaleido_tab/_js_logger.py
+++ b/src/py/kaleido/_kaleido_tab/_js_logger.py
@@ -26,20 +26,21 @@ class JavascriptLogger:
     log: list[Any]
     """A list of console outputs from the tab."""
 
-    def __init__(self) -> None:
+    def __init__(self, tab: choreographer.Tab) -> None:
         self.log = []
+        self.tab = tab
 
-    def activate(self, tab: choreographer.Tab):
-        tab.unsubscribe("Runtime.consoleAPICalled")
-        tab.subscribe(
+    def activate(self):
+        self.tab.unsubscribe("Runtime.consoleAPICalled")
+        self.tab.subscribe(
             "Runtime.consoleAPICalled",
-            _make_console_logger("tab js console", self.javascript_log),
+            _make_console_logger("tab js console", self.log),
         )
 
-    def reset(self, tab: choreographer.Tab):
-        tab.unsubscribe("Runtime.consoleAPICalled")
+    def reset(self):
+        self.tab.unsubscribe("Runtime.consoleAPICalled")
         self.log = []
-        tab.subscribe(
+        self.tab.subscribe(
             "Runtime.consoleAPICalled",
-            _make_console_logger("tab js console", self.javascript_log),
+            _make_console_logger("tab js console", self.log),
         )
diff --git a/src/py/kaleido/_page_generator.py b/src/py/kaleido/_page_generator.py
index 5ef13b5d..2d0fc641 100644
--- a/src/py/kaleido/_page_generator.py
+++ b/src/py/kaleido/_page_generator.py
@@ -8,7 +8,11 @@
 from . import _utils
 
 if TYPE_CHECKING:
-    UrlAndCharset = tuple[str | Path, str]  # type: TypeAlias
+    from typing import Tuple, Union
+
+    from typing_extensions import TypeAlias
+
+    UrlAndCharset: TypeAlias = Tuple[Union[str, Path], str]
     """A tuple to explicitly set charset= in the <script> tag."""
 
 _logger = logistro.getLogger(__name__)

From beeb165a13747b29f993fd80bb4b4c3c58edbc9f Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Wed, 3 Sep 2025 15:04:47 -0500
Subject: [PATCH 094/167] Organize _kaleido_tab exports.

---
 src/py/kaleido/_kaleido_tab/__init__.py | 181 ++----------------------
 src/py/kaleido/_kaleido_tab/_tab.py     | 173 ++++++++++++++++++++++
 2 files changed, 181 insertions(+), 173 deletions(-)
 create mode 100644 src/py/kaleido/_kaleido_tab/_tab.py

diff --git a/src/py/kaleido/_kaleido_tab/__init__.py b/src/py/kaleido/_kaleido_tab/__init__.py
index babe394f..1828d1be 100644
--- a/src/py/kaleido/_kaleido_tab/__init__.py
+++ b/src/py/kaleido/_kaleido_tab/__init__.py
@@ -1,173 +1,8 @@
-from __future__ import annotations
-
-import base64
-from typing import TYPE_CHECKING
-
-import logistro
-
-from kaleido._utils import to_thread
-
-from . import _devtools_utils as _dtools
-from . import _js_logger
-from ._errors import _raise_error
-
-if TYPE_CHECKING:
-    import asyncio
-    from pathlib import Path
-
-    import choreographer as choreo
-
-    from kaleido import _fig_tools
-
-
-_TEXT_FORMATS = ("svg", "json")  # eps
-
-_logger = logistro.getLogger(__name__)
-
-
-def _subscribe_new(tab: choreo.Tab, event: str) -> asyncio.Future:
-    """Create subscription to tab clearing old ones first: helper function."""
-    new_future = tab.subscribe_once(event)
-    while new_future.done():
-        _logger.debug2(f"Clearing an old {event}")
-        new_future = tab.subscribe_once(event)
-    return new_future
-
-
-class _KaleidoTab:
-    """
-    A Kaleido tab is a wrapped choreographer tab providing the functions we need.
-
-    The choreographer tab can be accessed through the `self.tab` attribute.
-    """
-
-    tab: choreo.Tab
-    """The underlying choreographer tab."""
-    js_logger: _js_logger.JavascriptLogger
-    """A log for recording javascript."""
-
-    def __init__(self, tab, *, _stepper=False):
-        """
-        Create a new _KaleidoTab.
-
-        Args:
-            tab: the choreographer tab to wrap.
-
-        """
-        self.tab = tab
-        self.js_logger = _js_logger.JavascriptLogger(self.tab)
-        self._stepper = _stepper
-
-    async def navigate(self, url: str | Path = ""):
-        """
-        Navigate to the kaleidofier script. This is effectively the real initialization.
-
-        Args:
-            url: Override the location of the kaleidofier script if necessary.
-
-        """
-        # Subscribe to event which will contain javascript engine ID (need it
-        # for calling javascript functions)
-        javascript_ready = _subscribe_new(self.tab, "Runtime.executionContextCreated")
-
-        # Subscribe to event indicating page ready.
-        page_ready = _subscribe_new(self.tab, "Page.loadEventFired")
-
-        # Navigating page. This will trigger the above events.
-        _logger.debug2(f"Calling Page.navigate on {self.tab}")
-        _raise_error(await self.tab.send_command("Page.navigate", params={"url": url}))
-
-        # Enabling page events (for page_ready- like all events, if already
-        # ready, the latest will fire immediately)
-        _logger.debug2(f"Calling Page.enable on {self.tab}")
-        _raise_error(await self.tab.send_command("Page.enable"))
-
-        # Enabling javascript events (for javascript_ready)
-        _logger.debug2(f"Calling Runtime.enable on {self.tab}")
-        _raise_error(await self.tab.send_command("Runtime.enable"))
-
-        self._current_js_id = _dtools.get_js_id(await javascript_ready)
-
-        await page_ready  # don't care result, ready is ready
-
-        # might miss console stuff, would need to
-        # catch an intermediate event and run it via callback
-        # catches all render errors though
-        self.js_logger.reset()
-
-    # reload is truly so close to navigate
-    async def reload(self):
-        """Reload the tab, and set the javascript runtime id."""
-        _logger.debug(f"Reloading tab {self.tab} with javascript.")
-
-        javascript_ready = _subscribe_new(self.tab, "Runtime.executionContextCreated")
-
-        page_ready = _subscribe_new(self.tab, "Page.loadEventFired")
-
-        _logger.debug2(f"Calling Page.reload on {self.tab}")
-        _raise_error(await self.tab.send_command("Page.reload"))
-
-        self._current_js_id = _dtools.get_js_id(await javascript_ready)
-
-        await page_ready
-
-        self.js_logger.reset()
-
-    async def _calc_fig(
-        self,
-        spec: _fig_tools.Spec,
-        full_path: Path,
-        *,
-        topojson: str | None = None,
-        **_kwargs,
-    ):
-        _kwargs.pop("error_log", None)  # not used at the moment
-        _kwargs.pop("profiler", None)  # not used at the moment
-
-        _logger.debug(f"In tab {self.tab.target_id[:4]} calc_fig for {full_path.name}.")
-        _logger.info(f"Processing {full_path.name}")
-
-        # js script
-        kaleido_js_fn = (
-            r"function(spec, ...args)"
-            r"{"
-            r"return kaleido_scopes.plotly(spec, ...args).then(JSON.stringify);"
-            r"}"
-        )
-
-        _logger.info(f"Sending big command for {full_path.name}.")
-        result = await _dtools.exec_js_fn(
-            self.tab,
-            self._current_js_id,
-            kaleido_js_fn,
-            spec,
-            topojson,
-            self._stepper,
-        )
-        _raise_error(result)
-
-        # TODO(AJP): better define these error mechanics, is this a devtools
-        # function or what
-        # upon implementation of error, might not be necessary
-        # to do these go-lang/c style returns
-        # but we have to collect and associate
-        # with the gather + profile
-        # None-non return values are a problem
-        # In general, need to better understand stuff here
-
-        _logger.debug2(f"Result of function call: {result}")
-        js_response, error = _dtools.check_kaleido_js_response(result)
-        if error:
-            raise error
-
-        if (response_format := js_response.get("format")) == "pdf":
-            img_raw, error = await _dtools.print_pdf(self.tab)
-        else:
-            img_raw = js_response.get("result")  # type: ignore[assignment]
-        if error:
-            raise error
-
-        if response_format not in _TEXT_FORMATS:
-            return base64.b64decode(img_raw), None
-        else:
-            return str.encode(img_raw), None
+from ._errors import JavascriptError, KaleidoError
+from ._tab import _KaleidoTab
+
+__all__ = [
+    "JavascriptError",
+    "KaleidoError",
+    "_KaleidoTab",
+]
diff --git a/src/py/kaleido/_kaleido_tab/_tab.py b/src/py/kaleido/_kaleido_tab/_tab.py
new file mode 100644
index 00000000..babe394f
--- /dev/null
+++ b/src/py/kaleido/_kaleido_tab/_tab.py
@@ -0,0 +1,173 @@
+from __future__ import annotations
+
+import base64
+from typing import TYPE_CHECKING
+
+import logistro
+
+from kaleido._utils import to_thread
+
+from . import _devtools_utils as _dtools
+from . import _js_logger
+from ._errors import _raise_error
+
+if TYPE_CHECKING:
+    import asyncio
+    from pathlib import Path
+
+    import choreographer as choreo
+
+    from kaleido import _fig_tools
+
+
+_TEXT_FORMATS = ("svg", "json")  # eps
+
+_logger = logistro.getLogger(__name__)
+
+
+def _subscribe_new(tab: choreo.Tab, event: str) -> asyncio.Future:
+    """Create subscription to tab clearing old ones first: helper function."""
+    new_future = tab.subscribe_once(event)
+    while new_future.done():
+        _logger.debug2(f"Clearing an old {event}")
+        new_future = tab.subscribe_once(event)
+    return new_future
+
+
+class _KaleidoTab:
+    """
+    A Kaleido tab is a wrapped choreographer tab providing the functions we need.
+
+    The choreographer tab can be accessed through the `self.tab` attribute.
+    """
+
+    tab: choreo.Tab
+    """The underlying choreographer tab."""
+    js_logger: _js_logger.JavascriptLogger
+    """A log for recording javascript."""
+
+    def __init__(self, tab, *, _stepper=False):
+        """
+        Create a new _KaleidoTab.
+
+        Args:
+            tab: the choreographer tab to wrap.
+
+        """
+        self.tab = tab
+        self.js_logger = _js_logger.JavascriptLogger(self.tab)
+        self._stepper = _stepper
+
+    async def navigate(self, url: str | Path = ""):
+        """
+        Navigate to the kaleidofier script. This is effectively the real initialization.
+
+        Args:
+            url: Override the location of the kaleidofier script if necessary.
+
+        """
+        # Subscribe to event which will contain javascript engine ID (need it
+        # for calling javascript functions)
+        javascript_ready = _subscribe_new(self.tab, "Runtime.executionContextCreated")
+
+        # Subscribe to event indicating page ready.
+        page_ready = _subscribe_new(self.tab, "Page.loadEventFired")
+
+        # Navigating page. This will trigger the above events.
+        _logger.debug2(f"Calling Page.navigate on {self.tab}")
+        _raise_error(await self.tab.send_command("Page.navigate", params={"url": url}))
+
+        # Enabling page events (for page_ready- like all events, if already
+        # ready, the latest will fire immediately)
+        _logger.debug2(f"Calling Page.enable on {self.tab}")
+        _raise_error(await self.tab.send_command("Page.enable"))
+
+        # Enabling javascript events (for javascript_ready)
+        _logger.debug2(f"Calling Runtime.enable on {self.tab}")
+        _raise_error(await self.tab.send_command("Runtime.enable"))
+
+        self._current_js_id = _dtools.get_js_id(await javascript_ready)
+
+        await page_ready  # don't care result, ready is ready
+
+        # might miss console stuff, would need to
+        # catch an intermediate event and run it via callback
+        # catches all render errors though
+        self.js_logger.reset()
+
+    # reload is truly so close to navigate
+    async def reload(self):
+        """Reload the tab, and set the javascript runtime id."""
+        _logger.debug(f"Reloading tab {self.tab} with javascript.")
+
+        javascript_ready = _subscribe_new(self.tab, "Runtime.executionContextCreated")
+
+        page_ready = _subscribe_new(self.tab, "Page.loadEventFired")
+
+        _logger.debug2(f"Calling Page.reload on {self.tab}")
+        _raise_error(await self.tab.send_command("Page.reload"))
+
+        self._current_js_id = _dtools.get_js_id(await javascript_ready)
+
+        await page_ready
+
+        self.js_logger.reset()
+
+    async def _calc_fig(
+        self,
+        spec: _fig_tools.Spec,
+        full_path: Path,
+        *,
+        topojson: str | None = None,
+        **_kwargs,
+    ):
+        _kwargs.pop("error_log", None)  # not used at the moment
+        _kwargs.pop("profiler", None)  # not used at the moment
+
+        _logger.debug(f"In tab {self.tab.target_id[:4]} calc_fig for {full_path.name}.")
+        _logger.info(f"Processing {full_path.name}")
+
+        # js script
+        kaleido_js_fn = (
+            r"function(spec, ...args)"
+            r"{"
+            r"return kaleido_scopes.plotly(spec, ...args).then(JSON.stringify);"
+            r"}"
+        )
+
+        _logger.info(f"Sending big command for {full_path.name}.")
+        result = await _dtools.exec_js_fn(
+            self.tab,
+            self._current_js_id,
+            kaleido_js_fn,
+            spec,
+            topojson,
+            self._stepper,
+        )
+        _raise_error(result)
+
+        # TODO(AJP): better define these error mechanics, is this a devtools
+        # function or what
+        # upon implementation of error, might not be necessary
+        # to do these go-lang/c style returns
+        # but we have to collect and associate
+        # with the gather + profile
+        # None-non return values are a problem
+        # In general, need to better understand stuff here
+
+        _logger.debug2(f"Result of function call: {result}")
+        js_response, error = _dtools.check_kaleido_js_response(result)
+        if error:
+            raise error
+
+        if (response_format := js_response.get("format")) == "pdf":
+            img_raw, error = await _dtools.print_pdf(self.tab)
+        else:
+            img_raw = js_response.get("result")  # type: ignore[assignment]
+        if error:
+            raise error
+
+        if response_format not in _TEXT_FORMATS:
+            return base64.b64decode(img_raw), None
+        else:
+            return str.encode(img_raw), None

From fed0f9fe167f52d01d701329c9a015c3157ebb15 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Mon, 8 Sep 2025 20:46:15 -0500
Subject: [PATCH 095/167] Simplify type coercian in iterable

---
 src/py/kaleido/kaleido.py | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/src/py/kaleido/kaleido.py b/src/py/kaleido/kaleido.py
index 39bc3284..27a76771 100644
--- a/src/py/kaleido/kaleido.py
+++ b/src/py/kaleido/kaleido.py
@@ -375,10 +375,8 @@ async def write_fig(
         topojson: str | None = None,
     ) -> None:
         """Temp."""
-        if _is_figurish(fig) or not isinstance(fig, (Iterable, AsyncIterable)):
+        if not isinstance(fig, (Iterable, AsyncIterable)):
             fig = [fig]
-        else:
-            _logger.debug(f"Is iterable {type(fig)}")
 
         async def _temp_generator():
             async for f in _utils.ensure_async_iter(fig):

From a48fa81f43e3bbebe26cc4b7aec96e700fc7736e Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Mon, 8 Sep 2025 21:02:42 -0500
Subject: [PATCH 096/167] Add comments.

---
 src/py/kaleido/kaleido.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/py/kaleido/kaleido.py b/src/py/kaleido/kaleido.py
index 27a76771..ce52865c 100644
--- a/src/py/kaleido/kaleido.py
+++ b/src/py/kaleido/kaleido.py
@@ -138,9 +138,10 @@ def __init__(  # noqa: PLR0913
 
         """
         self._tab_requeue_tasks = set()
+        # State variables
         self._main_render_coroutines = set()
         self.tabs_ready = asyncio.Queue(maxsize=0)
-        self._total_tabs = 0
+        self._total_tabs = 0 # tabs properly registered
         self._html_tmp_dir = None
 
         # Kaleido Config
@@ -209,7 +210,6 @@ async def _conform_tabs(self, tabs: Listish[choreo.Tab] | None = None) -> None:
 
         kaleido_tabs = [_KaleidoTab(tab, _stepper=self._stepper) for tab in tabs]
         # TODO(AJP): why doesn't stepper use the global?
-        # KaleidoTab has access to Kaleido?
 
         await asyncio.gather(*(tab.navigate(self._index) for tab in kaleido_tabs))
 

From e949a9e1077b385dbbb97eda9b3d48bcef1e8533 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Mon, 8 Sep 2025 21:03:39 -0500
Subject: [PATCH 097/167] Change type name.

---
 src/py/kaleido/__init__.py | 4 ++--
 src/py/kaleido/kaleido.py  | 4 ++--
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/src/py/kaleido/__init__.py b/src/py/kaleido/__init__.py
index ebdbe698..9b17bb8d 100644
--- a/src/py/kaleido/__init__.py
+++ b/src/py/kaleido/__init__.py
@@ -24,7 +24,7 @@
     T = TypeVar("T")
     AnyIterable = Union[AsyncIterable[T], Iterable[T]]
 
-    from .kaleido import FigureGenerator
+    from .kaleido import FigureDict
 
 __all__ = [
     "Kaleido",
@@ -141,7 +141,7 @@ async def write_fig(
 
 
 async def write_fig_from_object(
-    generator: AnyIterable[FigureGenerator],
+    generator: AnyIterable[FigureDict],
     *,
     kopts: dict[str, Any] | None = None,
     **kwargs,  # TODO(AJP): what might we pass here?
diff --git a/src/py/kaleido/kaleido.py b/src/py/kaleido/kaleido.py
index ce52865c..d63da35a 100644
--- a/src/py/kaleido/kaleido.py
+++ b/src/py/kaleido/kaleido.py
@@ -38,7 +38,7 @@
     # Iterable & Sized
     Listish: TypeAlias = Union[Tuple[T], List[T], ValuesView[T]]
 
-    class FigureGenerator(TypedDict):
+    class FigureDict(TypedDict):
         """The type a generator returns for `write_fig_from_object`."""
 
         fig: Required[_fig_tools.Figurish]
@@ -328,7 +328,7 @@ def _create_render_task(
     # also write_fig_from_dict
     async def write_fig_from_object(
         self,
-        generator: AnyIterable[FigureGenerator],
+        generator: AnyIterable[FigureDict], # TODO: must take a FigureDict alone
         *,
         cancel_on_error=False,
     ) -> None:

From 4b47fb864ceb576c527a90da8c9c67de31c4278e Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Mon, 8 Sep 2025 21:06:04 -0500
Subject: [PATCH 098/167] Refactor and split figtools

---
 src/py/kaleido/_fig_tools.py  | 204 ++++++++++------------------------
 src/py/kaleido/_path_tools.py |  61 ++++++++++
 2 files changed, 118 insertions(+), 147 deletions(-)
 create mode 100644 src/py/kaleido/_path_tools.py

diff --git a/src/py/kaleido/_fig_tools.py b/src/py/kaleido/_fig_tools.py
index b7aa2f8d..4de9fd45 100644
--- a/src/py/kaleido/_fig_tools.py
+++ b/src/py/kaleido/_fig_tools.py
@@ -15,14 +15,14 @@
 
 from __future__ import annotations
 
-import glob
-import re
-from pathlib import Path
 from typing import TYPE_CHECKING, Literal, TypedDict
 
 import logistro
 
+from . import _utils
+
 if TYPE_CHECKING:
+    from pathlib import Path
     from typing import Any
 
     from typing_extensions import TypeGuard
@@ -66,16 +66,6 @@ class Spec(TypedDict):
     "pdf",
 )
 
-
-# validation function
-def _assert_format(ext: str) -> TypeGuard[FormatString]:
-    if ext not in SUPPORTED_FORMATS:
-        raise ValueError(
-            f"Invalid format '{ext}'.\n    Supported formats: {SUPPORTED_FORMATS!s}",
-        )
-    return True
-
-
 # validation function
 def _is_figurish(o: Any) -> TypeGuard[Figurish]:
     valid = hasattr(o, "to_dict") or (isinstance(o, dict) and "data" in o)
@@ -88,154 +78,74 @@ def _is_figurish(o: Any) -> TypeGuard[Figurish]:
     return valid
 
 
-# defaults function
-def _get_figure_dimensions(
-    layout: dict,
-    width: float | None,
-    height: float | None,
-) -> tuple[float, float]:
-    # Compute image width / height with fallbacks
-    width = (
-        width
-        or layout.get("width")
-        or layout.get("template", {}).get("layout", {}).get("width")
-        or DEFAULT_WIDTH
-    )
-    height = (
-        height
-        or layout.get("height")
-        or layout.get("template", {}).get("layout", {}).get("height")
-        or DEFAULT_HEIGHT
-    )
-    return width, height
-
+def _coerce_format(extension: str) -> FormatString:
+    # wrap this condition as a typeguard for typechecker's sake
+    def is_fmt(s: str) -> TypeGuard[FormatString]:
+        return s in SUPPORTED_FORMATS
 
-# coercion function
-def _get_format(extension: str) -> FormatString:
     formatted_extension = extension.lower()
     if formatted_extension == "jpg":
         return "jpeg"
-    if not _assert_format(formatted_extension):
-        raise ValueError  # this line will never be reached its for typer
-    return formatted_extension
-
-
-# does additional validation + defaults + packaging
-def to_spec(figure: Figurish, layout_opts: LayoutOpts) -> Spec:
-    # Get figure layout
-    layout = figure.get("layout", {})
-
-    for k, v in layout_opts.items():
-        if k == "format":
-            if v is not None and not isinstance(v, (str)):
-                raise TypeError(
-                    f"{k} must be one of {SUPPORTED_FORMATS!s} or None, not {v}.",
-                )
-        elif k in ("scale", "height", "width"):
-            if v is not None and not isinstance(v, (float, int)):
-                raise TypeError(f"{k} must be numeric or None, not {v}.")
-        else:
-            raise AttributeError(f"Unknown key in layout options, {k}")
-
-    # Extract info
-    extension = _get_format(layout_opts.get("format") or DEFAULT_EXT)
-
-    width, height = _get_figure_dimensions(
-        layout,
-        layout_opts.get("width"),
-        layout_opts.get("height"),
-    )
-    scale = layout_opts.get("scale", DEFAULT_SCALE)
-
-    return {
-        "format": extension,
-        "width": width,
-        "height": height,
-        "scale": scale,
-        "data": figure,
-    }
+    elif not is_fmt(formatted_extension):
+        raise ValueError(
+            f"Invalid format '{formatted_extension}'.\n"
+            f"Supported formats: {SUPPORTED_FORMATS!s}",
+        )
+    else:
+        return formatted_extension
 
 
-# provides defaults
-def _next_filename(path: Path | str, prefix: str, ext: str) -> str:
-    path = path if isinstance(path, Path) else Path(path)
-    default = 1 if (path / f"{prefix}.{ext}").exists() else 0
-    re_number = re.compile(
-        r"^" + re.escape(prefix) + r"\-(\d+)\." + re.escape(ext) + r"$",
-    )
-    escaped_prefix = glob.escape(prefix)
-    escaped_ext = glob.escape(ext)
-    numbers = [
-        int(match.group(1))
-        for name in path.glob(f"{escaped_prefix}-*.{escaped_ext}")
-        if (match := re_number.match(Path(name).name))
-    ]
-    n = max(numbers, default=default) + 1
-    return f"{prefix}.{ext}" if n == 1 else f"{prefix}-{n}.{ext}"
-
-
-# provides defaults (and validation)
-def _build_full_path(
-    path: Path | None,
-    fig: Figurish,
-    ext: FormatString,
-) -> Path:
-    full_path: Path | None = None
-
-    directory: Path
-
-    if not path:
-        directory = Path()  # use current Path
-    elif path and (not path.suffix or path.is_dir()):
-        if not path.is_dir():
-            raise ValueError(f"Directory {path} not found. Please create it.")
-        directory = path
-    else:
-        full_path = path
-        if not full_path.parent.is_dir():
-            raise RuntimeError(
-                f"Cannot reach path {path.parent}. Are all directories created?",
-            )
-
-    if not full_path:
-        _logger.debug("Looking for title")
-        prefix = fig.get("layout", {}).get("title", {}).get("text", "fig")
-        prefix = re.sub(r"[ \-]", "_", prefix)
-        prefix = re.sub(r"[^a-zA-Z0-9_]", "", prefix)
-        prefix = prefix or "fig"
-        _logger.debug(f"Found: {prefix}")
-        name = _next_filename(directory, prefix, ext)
-        full_path = directory / name
-    return full_path
-
-
-# does validation, defaults, and packaging. is main entry point
-def build_fig_spec(
+def coerce_for_js(
     fig: Figurish,
     path: Path | str | None,
     opts: LayoutOpts | None,
-) -> tuple[Spec, Path]:
-    if not opts:
-        opts = {}
+) -> Spec:
 
-    if not _is_figurish(fig):
+    if not _is_figurish(fig): # VALIDATE FIG
         raise TypeError("Figure supplied doesn't seem to be a valid plotly figure.")
-
-    if hasattr(fig, "to_dict"):
+    if hasattr(fig, "to_dict"): # COERCE FIG
         fig = fig.to_dict()
 
-    if isinstance(path, str):
-        path = Path(path)
-    elif path and not isinstance(path, Path):
-        raise TypeError("Path should be a string or `pathlib.Path` object (or None)")
+    path = _utils.get_path(path) if path else None
+
+    opts = opts or {}
 
-    if not opts.get("format") and path and path.suffix:
-        ext = path.suffix.lstrip(".")
-        if _assert_format(ext):  # not strict necessary if but helps typeguard
-            opts["format"] = ext
+    if _rest := opts - LayoutOpts.__annotations__.keys():
+        raise AttributeError(f"Unknown key(s) in layout options: {_rest}")
 
-    spec = to_spec(fig, opts)
+    # Extract info
+    file_format = _coerce_format(
+        opts.get("format") or (
+                path.suffix.lstrip(".")
+                if path and path.suffix
+                else DEFAULT_EXT )
+    )
 
-    full_path = _build_full_path(path, fig, spec["format"])
+    layout = fig.get("layout", {})
+
+    width = (
+        opts.get("width")
+        or layout.get("width")
+        or layout.get("template", {}).get("layout", {}).get("width")
+        or DEFAULT_WIDTH
+    )
+
+    height = (
+        opts.get("height")
+        or layout.get("height")
+        or layout.get("template", {}).get("layout", {}).get("height")
+        or DEFAULT_HEIGHT
+    )
+
+    scale = opts.get("scale", DEFAULT_SCALE)
+
+    # PACKAGING
+    spec: Spec = {
+        "format": file_format,
+        "width": width,
+        "height": height,
+        "scale": scale,
+        "data": fig,
+    }
 
-    return spec, full_path
+    return spec
diff --git a/src/py/kaleido/_path_tools.py b/src/py/kaleido/_path_tools.py
new file mode 100644
index 00000000..3345a48d
--- /dev/null
+++ b/src/py/kaleido/_path_tools.py
@@ -0,0 +1,61 @@
+from __future__ import annotations
+
+import glob
+import re
+from pathlib import Path
+from typing import TYPE_CHECKING
+
+import logistro
+
+if TYPE_CHECKING:
+    from . import _fig_tools
+
+_logger = logistro.getLogger(__name__)
+
+
+def _next_filename(path: Path | str, prefix: str, ext: str) -> str:
+    path = path if isinstance(path, Path) else Path(path)
+    default = 1 if (path / f"{prefix}.{ext}").exists() else 0
+    re_number = re.compile(
+        r"^" + re.escape(prefix) + r"\-(\d+)\." + re.escape(ext) + r"$",
+    )
+    escaped_prefix = glob.escape(prefix)
+    escaped_ext = glob.escape(ext)
+    numbers = [
+        int(match.group(1))
+        for name in path.glob(f"{escaped_prefix}-*.{escaped_ext}")
+        if (match := re_number.match(Path(name).name))
+    ]
+    n = max(numbers, default=default) + 1
+    return f"{prefix}.{ext}" if n == 1 else f"{prefix}-{n}.{ext}"
+
+
+def determine_path(
+    path: Path | None,
+    fig: _fig_tools.Figurish,
+    ext: _fig_tools.FormatString,
+) -> Path:
+
+    path = path or Path()
+
+    if not path.suffix or path.is_dir(): # they gave us a directory
+        if not path.is_dir():
+            raise ValueError(f"Directory {path} not found. Please create it.")
+        directory = path
+    else: # we have full path, supposedly
+        full_path = path
+        if not full_path.parent.is_dir():
+            raise RuntimeError(
+                f"Cannot reach path {path.parent}. Are all directories created?",
+            )
+
+    if not full_path:
+        _logger.debug("Looking for title")
+        prefix = fig.get("layout", {}).get("title", {}).get("text", "fig")
+        prefix = re.sub(r"[ \-]", "_", prefix)
+        prefix = re.sub(r"[^a-zA-Z0-9_]", "", prefix)
+        prefix = prefix or "fig"
+        _logger.debug(f"Found: {prefix}")
+        name = _next_filename(directory, prefix, ext)
+        full_path = directory / name
+    return full_path

From 4600c0a0fa5ca332778e86849dbeca72f7239779 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Mon, 8 Sep 2025 21:06:17 -0500
Subject: [PATCH 099/167] Add type check to verification

---
 src/py/kaleido/_utils.py | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/src/py/kaleido/_utils.py b/src/py/kaleido/_utils.py
index be5a1260..6d9923a0 100644
--- a/src/py/kaleido/_utils.py
+++ b/src/py/kaleido/_utils.py
@@ -110,6 +110,9 @@ def warn_incompatible_plotly():
 def get_path(p: str | Path) -> Path:
     if isinstance(p, Path):
         return p
+    elif not isinstance(p, str):
+        raise TypeError("Path should be a string or `pathlib.Path` object.")
+
     parsed = urlparse(str(p))
 
     return Path(

From 7926f0495a3aa172b856e4b075867a012b70682a Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Mon, 8 Sep 2025 21:06:35 -0500
Subject: [PATCH 100/167] Remove write/path from _KaleidoTab:

This will never write the file, it doesn't need the path.
---
 src/py/kaleido/_kaleido_tab/_tab.py | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/src/py/kaleido/_kaleido_tab/_tab.py b/src/py/kaleido/_kaleido_tab/_tab.py
index babe394f..18db1f84 100644
--- a/src/py/kaleido/_kaleido_tab/_tab.py
+++ b/src/py/kaleido/_kaleido_tab/_tab.py
@@ -116,7 +116,6 @@ async def reload(self):
     async def _calc_fig(
         self,
         spec: _fig_tools.Spec,
-        full_path: Path,
         *,
         topojson: str | None = None,
         **_kwargs,
@@ -124,9 +123,6 @@ async def _calc_fig(
         _kwargs.pop("error_log", None)  # not used at the moment
         _kwargs.pop("profiler", None)  # not used at the moment
 
-        _logger.debug(f"In tab {self.tab.target_id[:4]} calc_fig for {full_path.name}.")
-        _logger.info(f"Processing {full_path.name}")
-
         # js script
         kaleido_js_fn = (
             r"function(spec, ...args)"
@@ -135,7 +131,6 @@ async def _calc_fig(
             r"}"
         )
 
-        _logger.info(f"Sending big command for {full_path.name}.")
         result = await _dtools.exec_js_fn(
             self.tab,
             self._current_js_id,

From 60f6aeda908deaa98060bc1879eab1eefa712aa3 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Mon, 8 Sep 2025 22:30:34 -0500
Subject: [PATCH 101/167] Turn all renders into _from_object wrappers.

---
 src/py/kaleido/_fig_tools.py        |  21 ++----
 src/py/kaleido/_kaleido_tab/_tab.py |   7 +-
 src/py/kaleido/kaleido.py           | 103 ++++++++++++++++------------
 3 files changed, 66 insertions(+), 65 deletions(-)

diff --git a/src/py/kaleido/_fig_tools.py b/src/py/kaleido/_fig_tools.py
index 4de9fd45..5215d373 100644
--- a/src/py/kaleido/_fig_tools.py
+++ b/src/py/kaleido/_fig_tools.py
@@ -4,15 +4,6 @@
 It 1. validates, 2. write defaults, 3. packages object.
 """
 
-# Adapted from old code, it's mixed in order, it should go in the order above.
-# build_fig_spec should probably be factored out.
-# 1. Validate
-# 2. Write Defaults/Automatics
-# 3. Packages Object
-# The structure should be more readable.
-
-# The main entry point is the last function, build_fig_spec
-
 from __future__ import annotations
 
 from typing import TYPE_CHECKING, Literal, TypedDict
@@ -66,6 +57,7 @@ class Spec(TypedDict):
     "pdf",
 )
 
+
 # validation function
 def _is_figurish(o: Any) -> TypeGuard[Figurish]:
     valid = hasattr(o, "to_dict") or (isinstance(o, dict) and "data" in o)
@@ -100,10 +92,9 @@ def coerce_for_js(
     path: Path | str | None,
     opts: LayoutOpts | None,
 ) -> Spec:
-
-    if not _is_figurish(fig): # VALIDATE FIG
+    if not _is_figurish(fig):  # VALIDATE FIG
         raise TypeError("Figure supplied doesn't seem to be a valid plotly figure.")
-    if hasattr(fig, "to_dict"): # COERCE FIG
+    if hasattr(fig, "to_dict"):  # COERCE FIG
         fig = fig.to_dict()
 
     path = _utils.get_path(path) if path else None
@@ -115,10 +106,8 @@ def coerce_for_js(
 
     # Extract info
     file_format = _coerce_format(
-        opts.get("format") or (
-                path.suffix.lstrip(".")
-                if path and path.suffix
-                else DEFAULT_EXT )
+        opts.get("format")
+        or (path.suffix.lstrip(".") if path and path.suffix else DEFAULT_EXT),
     )
 
     layout = fig.get("layout", {})
diff --git a/src/py/kaleido/_kaleido_tab/_tab.py b/src/py/kaleido/_kaleido_tab/_tab.py
index 18db1f84..5e9ceabe 100644
--- a/src/py/kaleido/_kaleido_tab/_tab.py
+++ b/src/py/kaleido/_kaleido_tab/_tab.py
@@ -5,8 +5,6 @@
 
 import logistro
 
-from kaleido._utils import to_thread
-
 from . import _devtools_utils as _dtools
 from . import _js_logger
 from ._errors import _raise_error
@@ -90,9 +88,8 @@ async def navigate(self, url: str | Path = ""):
 
         await page_ready  # don't care result, ready is ready
 
-        # might miss console stuff, would need to
-        # catch an intermediate event and run it via callback
-        # catches all render errors though
+        # this runs *after* page load because running it first thing
+        # requires a couple extra lines
         self.js_logger.reset()
 
     # reload is truly so close to navigate
diff --git a/src/py/kaleido/kaleido.py b/src/py/kaleido/kaleido.py
index d63da35a..8f80aae7 100644
--- a/src/py/kaleido/kaleido.py
+++ b/src/py/kaleido/kaleido.py
@@ -12,8 +12,7 @@
 from choreographer.errors import ChromeNotFoundError
 from choreographer.utils import TmpDirectory
 
-from . import _utils
-from ._fig_tools import _is_figurish, build_fig_spec
+from . import _fig_tools, _path_tools, _utils
 from ._kaleido_tab import _KaleidoTab
 from ._page_generator import PageGenerator
 
@@ -29,8 +28,6 @@
 
     from typing_extensions import NotRequired, Required, TypeAlias
 
-    from . import _fig_tools
-
     T = TypeVar("T")
     AnyIterable: TypeAlias = Union[Iterable[T], AsyncIterable[T]]  # not runtime
 
@@ -73,7 +70,6 @@ class Kaleido(choreo.Browser):
 
     tabs_ready: asyncio.Queue[_KaleidoTab]
     """A queue of tabs ready to process a kaleido figure."""
-    _tab_requeue_tasks: set[asyncio.Task]
     _main_render_coroutines: set[asyncio.Task]
     # technically Tasks, user sees coroutines
 
@@ -137,11 +133,10 @@ def __init__(  # noqa: PLR0913
                 respectively.
 
         """
-        self._tab_requeue_tasks = set()
         # State variables
         self._main_render_coroutines = set()
         self.tabs_ready = asyncio.Queue(maxsize=0)
-        self._total_tabs = 0 # tabs properly registered
+        self._total_tabs = 0  # tabs properly registered
         self._html_tmp_dir = None
 
         # Kaleido Config
@@ -246,9 +241,6 @@ async def close(self) -> None:
         for task in self._main_render_coroutines:
             if not task.done():
                 task.cancel()
-        for task in self._tab_requeue_tasks:
-            if not task.done():
-                task.cancel()
 
         _logger.info("Exiting Kaleido/Choreo.")
 
@@ -262,7 +254,8 @@ async def __aexit__(
         _logger.info("Waiting for all cleanups to finish.")
 
         # render "tasks" are coroutines, so use is awaiting them
-        await asyncio.gather(*self._tab_requeue_tasks, return_exceptions=True)
+
+        await asyncio.gather(*self._main_render_coroutines, return_exceptions=True)
 
         _logger.info("Exiting Kaleido.")
         return await super().__aexit__(exc_type, exc_value, exc_tb)
@@ -291,46 +284,39 @@ async def _return_kaleido_tab(self, tab: _KaleidoTab) -> None:
 
     #### WE'RE HERE
 
-    def _create_render_task(
+    async def _render_task(
         self,
-        tab: _KaleidoTab,
         spec: _fig_tools.Spec,
-        full_path: Path,
+        write_path: Path | None,
         **kwargs: Any,
-    ) -> asyncio.Task:
-        _logger.info(f"Posting a task for {full_path.name}")
-        t: asyncio.Task = asyncio.create_task(
-            asyncio.wait_for(
-                tab._write_fig(  # noqa: SLF001
+    ) -> None | bytes:
+        tab = await self._get_kaleido_tab()
+
+        try:
+            img_bytes = await asyncio.wait_for(
+                tab._calc_fig(  # noqa: SLF001
                     spec,
-                    full_path,
                     **kwargs,
                 ),
                 self._timeout,
-            ),
-        )
+            )
+            if write_path:
+                await _utils.to_thread(write_path.write_bytes, img_bytes)
+                return None
+            else:
+                return bytes
 
-        # a weak solution to chaining tasks
-        # maybe consider an async closure instead
-        # avoids try/except....
-        t.add_done_callback(
-            lambda _f: self._tab_requeue_tasks.add(
-                _utils.create_task_log_error(
-                    self._return_kaleido_tab(tab),
-                ),
-            ),
-        )
-        _logger.info(f"Posted task ending for {full_path.name}")
-        return t
+        finally:
+            await self._return_kaleido_tab(tab)
 
     ### API ###
 
-    # also write_fig_from_dict
     async def write_fig_from_object(
         self,
-        generator: AnyIterable[FigureDict], # TODO: must take a FigureDict alone
+        generator: AnyIterable[FigureDict],  # TODO: must take a FigureDict alone
         *,
         cancel_on_error=False,
+        _write: bool = True,  # backwards compatibility!
     ) -> None:
         """Temp."""
         if main_task := asyncio.current_task():
@@ -339,20 +325,24 @@ async def write_fig_from_object(
 
         try:
             async for args in _utils.ensure_async_iter(generator):
-                spec, full_path = build_fig_spec(
+                spec = _fig_tools.coerce_for_js(
                     args.get("fig"),
                     args.get("path", None),
                     args.get("opts", None),
                 )
-                topojson = args.get("topojson")
 
-                tab = await self._get_kaleido_tab()
+                full_path = _path_tools.determine_path(
+                    args.get("path", None),
+                    args["fig"],
+                    spec["format"],
+                )
 
-                t: asyncio.Task = self._create_render_task(
-                    tab,
-                    spec,
-                    full_path,
-                    topojson=topojson,
+                t: asyncio.Task = asyncio.create_task(
+                    self._render_task(
+                        spec=spec,
+                        write_path=full_path if _write else None,  # bwrds - compat!
+                        topojson=args.get("topojson"),
+                    ),
                 )
                 tasks.add(t)
 
@@ -373,6 +363,7 @@ async def write_fig(
         opts: None | _fig_tools.LayoutOpts = None,
         *,
         topojson: str | None = None,
+        cancel_on_error=False,
     ) -> None:
         """Temp."""
         if not isinstance(fig, (Iterable, AsyncIterable)):
@@ -389,4 +380,28 @@ async def _temp_generator():
 
         return await self.write_fig_from_object(
             generator=_temp_generator(),
+            cancel_on_error=cancel_on_error,
+        )
+
+    async def calc_fig(
+        self,
+        fig: _fig_tools.Figurish,
+        opts: None | _fig_tools.LayoutOpts = None,
+        *,
+        topojson: str | None = None,
+        cancel_on_error=False,
+    ) -> bytes:
+        """Temp."""
+
+        async def _temp_generator():
+            yield {
+                "fig": fig,
+                "opts": opts,
+                "topojson": topojson,
+            }
+
+        return await self.write_fig_from_object(
+            generator=_temp_generator(),
+            cancel_on_error=cancel_on_error,
+            _write=False,
         )

From f260f876f04f7428674a2b0f4788141317c15e80 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Mon, 8 Sep 2025 22:53:33 -0500
Subject: [PATCH 102/167] Fix conditional logic in helper library

---
 src/py/kaleido/_path_tools.py | 17 +++++++----------
 1 file changed, 7 insertions(+), 10 deletions(-)

diff --git a/src/py/kaleido/_path_tools.py b/src/py/kaleido/_path_tools.py
index 3345a48d..f50156eb 100644
--- a/src/py/kaleido/_path_tools.py
+++ b/src/py/kaleido/_path_tools.py
@@ -35,21 +35,12 @@ def determine_path(
     fig: _fig_tools.Figurish,
     ext: _fig_tools.FormatString,
 ) -> Path:
-
     path = path or Path()
 
-    if not path.suffix or path.is_dir(): # they gave us a directory
+    if not path.suffix or path.is_dir():  # they gave us a directory
         if not path.is_dir():
             raise ValueError(f"Directory {path} not found. Please create it.")
         directory = path
-    else: # we have full path, supposedly
-        full_path = path
-        if not full_path.parent.is_dir():
-            raise RuntimeError(
-                f"Cannot reach path {path.parent}. Are all directories created?",
-            )
-
-    if not full_path:
         _logger.debug("Looking for title")
         prefix = fig.get("layout", {}).get("title", {}).get("text", "fig")
         prefix = re.sub(r"[ \-]", "_", prefix)
@@ -58,4 +49,10 @@ def determine_path(
         _logger.debug(f"Found: {prefix}")
         name = _next_filename(directory, prefix, ext)
         full_path = directory / name
+    else:  # we have full path, supposedly
+        full_path = path
+        if not full_path.parent.is_dir():
+            raise RuntimeError(
+                f"Cannot reach path {path.parent}. Are all directories created?",
+            )
     return full_path

From 87a140250321132883529787a747c56246beb787 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Mon, 8 Sep 2025 23:04:35 -0500
Subject: [PATCH 103/167] Fix return.

---
 src/py/kaleido/_kaleido_tab/_devtools_utils.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/py/kaleido/_kaleido_tab/_devtools_utils.py b/src/py/kaleido/_kaleido_tab/_devtools_utils.py
index c44a9ca5..a43b9bfd 100644
--- a/src/py/kaleido/_kaleido_tab/_devtools_utils.py
+++ b/src/py/kaleido/_kaleido_tab/_devtools_utils.py
@@ -101,7 +101,7 @@ def check_kaleido_js_response(
     if js_response["code"] != 0:
         return {}, KaleidoError(js_response["code"], js_response["message"])
 
-    return js_response
+    return js_response, None
 
 
 async def print_pdf(

From 78f894feb325c28b49955dbc0f366fc39b6e3f92 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Mon, 8 Sep 2025 23:07:15 -0500
Subject: [PATCH 104/167] Fix errors based on typing.

---
 src/py/kaleido/_path_tools.py |  2 +-
 src/py/kaleido/kaleido.py     | 35 ++++++++++++++++++++++-------------
 2 files changed, 23 insertions(+), 14 deletions(-)

diff --git a/src/py/kaleido/_path_tools.py b/src/py/kaleido/_path_tools.py
index f50156eb..71e96fcb 100644
--- a/src/py/kaleido/_path_tools.py
+++ b/src/py/kaleido/_path_tools.py
@@ -32,7 +32,7 @@ def _next_filename(path: Path | str, prefix: str, ext: str) -> str:
 
 def determine_path(
     path: Path | None,
-    fig: _fig_tools.Figurish,
+    fig: dict,
     ext: _fig_tools.FormatString,
 ) -> Path:
     path = path or Path()
diff --git a/src/py/kaleido/kaleido.py b/src/py/kaleido/kaleido.py
index 8f80aae7..fb8eba45 100644
--- a/src/py/kaleido/kaleido.py
+++ b/src/py/kaleido/kaleido.py
@@ -5,7 +5,7 @@
 import asyncio
 from collections.abc import AsyncIterable, Iterable
 from pathlib import Path
-from typing import TYPE_CHECKING, TypedDict
+from typing import TYPE_CHECKING, TypedDict, cast
 
 import choreographer as choreo
 import logistro
@@ -304,7 +304,7 @@ async def _render_task(
                 await _utils.to_thread(write_path.write_bytes, img_bytes)
                 return None
             else:
-                return bytes
+                return img_bytes
 
         finally:
             await self._return_kaleido_tab(tab)
@@ -317,7 +317,7 @@ async def write_fig_from_object(
         *,
         cancel_on_error=False,
         _write: bool = True,  # backwards compatibility!
-    ) -> None:
+    ) -> tuple[bytes | None | Exception]:
         """Temp."""
         if main_task := asyncio.current_task():
             self._main_render_coroutines.add(main_task)
@@ -333,8 +333,8 @@ async def write_fig_from_object(
 
                 full_path = _path_tools.determine_path(
                     args.get("path", None),
-                    args["fig"],
-                    spec["format"],
+                    spec["data"],
+                    spec["format"],  # should just take spec
                 )
 
                 t: asyncio.Task = asyncio.create_task(
@@ -346,7 +346,7 @@ async def write_fig_from_object(
                 )
                 tasks.add(t)
 
-            await asyncio.gather(*tasks, return_exceptions=not cancel_on_error)
+            return await asyncio.gather(*tasks, return_exceptions=not cancel_on_error)
 
         finally:
             for task in tasks:
@@ -364,7 +364,7 @@ async def write_fig(
         *,
         topojson: str | None = None,
         cancel_on_error=False,
-    ) -> None:
+    ) -> tuple[None | Exception]:  # TODO this should be filtered
         """Temp."""
         if not isinstance(fig, (Iterable, AsyncIterable)):
             fig = [fig]
@@ -378,10 +378,13 @@ async def _temp_generator():
                     "topojson": topojson,
                 }
 
-        return await self.write_fig_from_object(
+        res = await self.write_fig_from_object(
             generator=_temp_generator(),
             cancel_on_error=cancel_on_error,
         )
+        return cast("tuple[Exception]", tuple(r for r in res if r is not None))
+        # we're using cast, but @overload would be better
+        # because with _write = True, return is a tuple[Exception | None]
 
     async def calc_fig(
         self,
@@ -389,7 +392,6 @@ async def calc_fig(
         opts: None | _fig_tools.LayoutOpts = None,
         *,
         topojson: str | None = None,
-        cancel_on_error=False,
     ) -> bytes:
         """Temp."""
 
@@ -400,8 +402,15 @@ async def _temp_generator():
                 "topojson": topojson,
             }
 
-        return await self.write_fig_from_object(
-            generator=_temp_generator(),
-            cancel_on_error=cancel_on_error,
-            _write=False,
+        return cast(
+            "bytes",
+            (
+                await self.write_fig_from_object(
+                    generator=_temp_generator(),
+                    cancel_on_error=True,
+                    _write=False,
+                )
+            )[0],
         )
+        # Complex type mechanics. Exceptions will raise. None not possible.
+        # Bytes only option

From a6203c1e5b9ac6594a50eac97960514a3128406c Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Mon, 8 Sep 2025 23:17:32 -0500
Subject: [PATCH 105/167] Remove erroneous tuple return

---
 src/py/kaleido/_kaleido_tab/_tab.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/src/py/kaleido/_kaleido_tab/_tab.py b/src/py/kaleido/_kaleido_tab/_tab.py
index 5e9ceabe..e12d4173 100644
--- a/src/py/kaleido/_kaleido_tab/_tab.py
+++ b/src/py/kaleido/_kaleido_tab/_tab.py
@@ -116,7 +116,7 @@ async def _calc_fig(
         *,
         topojson: str | None = None,
         **_kwargs,
-    ):
+    ) -> bytes:
         _kwargs.pop("error_log", None)  # not used at the moment
         _kwargs.pop("profiler", None)  # not used at the moment
 
@@ -160,6 +160,6 @@ async def _calc_fig(
             raise error
 
         if response_format not in _TEXT_FORMATS:
-            return base64.b64decode(img_raw), None
+            return base64.b64decode(img_raw)
         else:
-            return str.encode(img_raw), None
+            return str.encode(img_raw)

From 277c5dc7fd52a957a52ccd05d81f9f87a8e78a0d Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Mon, 8 Sep 2025 23:35:29 -0500
Subject: [PATCH 106/167] Fix tmp dir cleanup syntax

---
 src/py/kaleido/kaleido.py | 11 +++++++----
 1 file changed, 7 insertions(+), 4 deletions(-)

diff --git a/src/py/kaleido/kaleido.py b/src/py/kaleido/kaleido.py
index fb8eba45..17ad39f9 100644
--- a/src/py/kaleido/kaleido.py
+++ b/src/py/kaleido/kaleido.py
@@ -174,8 +174,8 @@ async def open(self):
             else:
                 raise FileNotFoundError(f"{page!s} does not exist.")
         elif not page or hasattr(page, "generate_index"):
-            self._tmp_dir = TmpDirectory(sneak=self.is_isolated())
-            index = self._tmp_dir.path / "index.html"
+            self._html_tmp_dir = TmpDirectory(sneak=self.is_isolated())
+            index = self._html_tmp_dir.path / "index.html"
             self._index = index.as_uri()
             if not page:
                 page = PageGenerator(plotly=self._plotlyjs, mathjax=self._mathjax)
@@ -231,10 +231,13 @@ async def populate_targets(self) -> None:
 
     async def close(self) -> None:
         """Close the browser."""
-        await super().close()
-
         if self._html_tmp_dir:
+            _logger.debug(f"Cleaning up {self._html_tmp_dir}")
             self._html_tmp_dir.clean()
+        else:
+            _logger.debug("No kaleido._html_tmp_dir to clean up.")
+
+        await super().close()
 
         # cancellation only happens if crash/early
         _logger.info("Cancelling tasks.")

From ef0f5b75e9fde2993273e81cfe21127d19703454 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Mon, 8 Sep 2025 23:36:21 -0500
Subject: [PATCH 107/167] Fix casting.

---
 src/py/kaleido/kaleido.py | 14 +++++---------
 1 file changed, 5 insertions(+), 9 deletions(-)

diff --git a/src/py/kaleido/kaleido.py b/src/py/kaleido/kaleido.py
index 17ad39f9..211038cc 100644
--- a/src/py/kaleido/kaleido.py
+++ b/src/py/kaleido/kaleido.py
@@ -405,15 +405,11 @@ async def _temp_generator():
                 "topojson": topojson,
             }
 
-        return cast(
-            "bytes",
-            (
-                await self.write_fig_from_object(
-                    generator=_temp_generator(),
-                    cancel_on_error=True,
-                    _write=False,
-                )
-            )[0],
+        res = await self.write_fig_from_object(
+            generator=_temp_generator(),
+            cancel_on_error=True,
+            _write=False,
         )
+        return cast("bytes", res[0])
         # Complex type mechanics. Exceptions will raise. None not possible.
         # Bytes only option

From b48eed4d93e59a2ac77f8e25ef18d15f67f12900 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Tue, 9 Sep 2025 00:02:25 -0500
Subject: [PATCH 108/167] Fix up is_figurish typechecks.

---
 src/py/kaleido/_fig_tools.py |  4 ++--
 src/py/kaleido/kaleido.py    | 17 ++++++++++-------
 2 files changed, 12 insertions(+), 9 deletions(-)

diff --git a/src/py/kaleido/_fig_tools.py b/src/py/kaleido/_fig_tools.py
index 5215d373..3f4a959f 100644
--- a/src/py/kaleido/_fig_tools.py
+++ b/src/py/kaleido/_fig_tools.py
@@ -59,7 +59,7 @@ class Spec(TypedDict):
 
 
 # validation function
-def _is_figurish(o: Any) -> TypeGuard[Figurish]:
+def is_figurish(o: Any) -> TypeGuard[Figurish]:
     valid = hasattr(o, "to_dict") or (isinstance(o, dict) and "data" in o)
     if not valid:
         _logger.debug(
@@ -92,7 +92,7 @@ def coerce_for_js(
     path: Path | str | None,
     opts: LayoutOpts | None,
 ) -> Spec:
-    if not _is_figurish(fig):  # VALIDATE FIG
+    if not is_figurish(fig):  # VALIDATE FIG
         raise TypeError("Figure supplied doesn't seem to be a valid plotly figure.")
     if hasattr(fig, "to_dict"):  # COERCE FIG
         fig = fig.to_dict()
diff --git a/src/py/kaleido/kaleido.py b/src/py/kaleido/kaleido.py
index 211038cc..1254b057 100644
--- a/src/py/kaleido/kaleido.py
+++ b/src/py/kaleido/kaleido.py
@@ -327,15 +327,15 @@ async def write_fig_from_object(
         tasks: set[asyncio.Task] = set()
 
         try:
-            async for args in _utils.ensure_async_iter(generator):
+            async for fig_arg in _utils.ensure_async_iter(generator):
                 spec = _fig_tools.coerce_for_js(
-                    args.get("fig"),
-                    args.get("path", None),
-                    args.get("opts", None),
+                    fig_arg.get("fig"),
+                    fig_arg.get("path", None),
+                    fig_arg.get("opts", None),
                 )
 
                 full_path = _path_tools.determine_path(
-                    args.get("path", None),
+                    fig_arg.get("path", None),
                     spec["data"],
                     spec["format"],  # should just take spec
                 )
@@ -344,7 +344,7 @@ async def write_fig_from_object(
                     self._render_task(
                         spec=spec,
                         write_path=full_path if _write else None,  # bwrds - compat!
-                        topojson=args.get("topojson"),
+                        topojson=fig_arg.get("topojson"),
                     ),
                 )
                 tasks.add(t)
@@ -369,7 +369,10 @@ async def write_fig(
         cancel_on_error=False,
     ) -> tuple[None | Exception]:  # TODO this should be filtered
         """Temp."""
-        if not isinstance(fig, (Iterable, AsyncIterable)):
+        if _fig_tools.is_figurish(fig) or not isinstance(
+            fig,
+            (Iterable, AsyncIterable),
+        ):
             fig = [fig]
 
         async def _temp_generator():

From 46e55e9ba03d380ae14eb5fd0f6088781f4cb5da Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Tue, 9 Sep 2025 13:38:10 -0500
Subject: [PATCH 109/167] Fix typing in kaleido.

---
 src/py/kaleido/kaleido.py | 80 ++++++++++++++++++++++++++++++---------
 1 file changed, 63 insertions(+), 17 deletions(-)

diff --git a/src/py/kaleido/kaleido.py b/src/py/kaleido/kaleido.py
index 1254b057..6dc66072 100644
--- a/src/py/kaleido/kaleido.py
+++ b/src/py/kaleido/kaleido.py
@@ -5,7 +5,7 @@
 import asyncio
 from collections.abc import AsyncIterable, Iterable
 from pathlib import Path
-from typing import TYPE_CHECKING, TypedDict, cast
+from typing import TYPE_CHECKING, TypedDict, cast, overload
 
 import choreographer as choreo
 import logistro
@@ -24,7 +24,16 @@
 
 if TYPE_CHECKING:
     from types import TracebackType
-    from typing import Any, List, Tuple, TypeVar, Union, ValuesView
+    from typing import (
+        Any,
+        AsyncGenerator,
+        List,
+        Literal,
+        Tuple,
+        TypeVar,
+        Union,
+        ValuesView,
+    )
 
     from typing_extensions import NotRequired, Required, TypeAlias
 
@@ -313,6 +322,41 @@ async def _render_task(
             await self._return_kaleido_tab(tab)
 
     ### API ###
+    @overload
+    async def write_fig_from_object(
+        self,
+        generator: AnyIterable[FigureDict],
+        *,
+        cancel_on_error: bool = False,
+        _write: Literal[False],
+    ) -> bytes: ...
+
+    @overload
+    async def write_fig_from_object(
+        self,
+        generator: AnyIterable[FigureDict],
+        *,
+        cancel_on_error: Literal[True],
+        _write: Literal[True] = True,
+    ) -> None: ...
+
+    @overload
+    async def write_fig_from_object(
+        self,
+        generator: AnyIterable[FigureDict],
+        *,
+        cancel_on_error: Literal[False] = False,
+        _write: Literal[True] = True,
+    ) -> tuple[Exception]: ...
+
+    @overload
+    async def write_fig_from_object(
+        self,
+        generator: AnyIterable[FigureDict],
+        *,
+        cancel_on_error: bool,
+        _write: Literal[True] = True,
+    ) -> tuple[Exception] | None: ...
 
     async def write_fig_from_object(
         self,
@@ -320,8 +364,10 @@ async def write_fig_from_object(
         *,
         cancel_on_error=False,
         _write: bool = True,  # backwards compatibility!
-    ) -> tuple[bytes | None | Exception]:
+    ) -> None | bytes | tuple[Exception]:
         """Temp."""
+        if not _write:
+            cancel_on_error = True
         if main_task := asyncio.current_task():
             self._main_render_coroutines.add(main_task)
         tasks: set[asyncio.Task] = set()
@@ -349,7 +395,13 @@ async def write_fig_from_object(
                 )
                 tasks.add(t)
 
-            return await asyncio.gather(*tasks, return_exceptions=not cancel_on_error)
+            res = await asyncio.gather(*tasks, return_exceptions=not cancel_on_error)
+            if not _write:
+                return cast("bytes", res[0])
+            elif cancel_on_error:
+                return None
+            else:
+                return cast("tuple[Exception]", tuple(r for r in res if r))
 
         finally:
             for task in tasks:
@@ -357,7 +409,6 @@ async def write_fig_from_object(
                     task.cancel()
             if main_task:
                 self._main_render_coroutines.remove(main_task)
-            # return errors?
 
     async def write_fig(
         self,
@@ -366,8 +417,8 @@ async def write_fig(
         opts: None | _fig_tools.LayoutOpts = None,
         *,
         topojson: str | None = None,
-        cancel_on_error=False,
-    ) -> tuple[None | Exception]:  # TODO this should be filtered
+        cancel_on_error: bool = False,
+    ) -> tuple[Exception] | None:
         """Temp."""
         if _fig_tools.is_figurish(fig) or not isinstance(
             fig,
@@ -375,7 +426,7 @@ async def write_fig(
         ):
             fig = [fig]
 
-        async def _temp_generator():
+        async def _temp_generator() -> AsyncGenerator[FigureDict, None]:
             async for f in _utils.ensure_async_iter(fig):
                 yield {
                     "fig": f,
@@ -384,13 +435,11 @@ async def _temp_generator():
                     "topojson": topojson,
                 }
 
-        res = await self.write_fig_from_object(
-            generator=_temp_generator(),
+        generator = cast("AsyncIterable[FigureDict]", _temp_generator())
+        return await self.write_fig_from_object(
+            generator=generator,
             cancel_on_error=cancel_on_error,
         )
-        return cast("tuple[Exception]", tuple(r for r in res if r is not None))
-        # we're using cast, but @overload would be better
-        # because with _write = True, return is a tuple[Exception | None]
 
     async def calc_fig(
         self,
@@ -408,11 +457,8 @@ async def _temp_generator():
                 "topojson": topojson,
             }
 
-        res = await self.write_fig_from_object(
+        return await self.write_fig_from_object(
             generator=_temp_generator(),
             cancel_on_error=True,
             _write=False,
         )
-        return cast("bytes", res[0])
-        # Complex type mechanics. Exceptions will raise. None not possible.
-        # Bytes only option

From 94ac0cd6b03e4a819fb67d0bd937cd2188a2b670 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Tue, 9 Sep 2025 13:47:19 -0500
Subject: [PATCH 110/167] Further remove path from calc_fig

---
 src/py/kaleido/__init__.py | 2 --
 src/py/tests/test_init.py  | 3 +--
 2 files changed, 1 insertion(+), 4 deletions(-)

diff --git a/src/py/kaleido/__init__.py b/src/py/kaleido/__init__.py
index 9b17bb8d..10a47c2e 100644
--- a/src/py/kaleido/__init__.py
+++ b/src/py/kaleido/__init__.py
@@ -80,7 +80,6 @@ def stop_sync_server(*, silence_warnings: bool = False):
 
 async def calc_fig(
     fig: Figurish,
-    path: str | None | Path = None,
     opts: LayoutOpts | None = None,
     *,
     topojson: str | None = None,
@@ -104,7 +103,6 @@ async def calc_fig(
     async with Kaleido(**kopts) as k:
         return await k.calc_fig(
             fig,
-            path=path,
             opts=opts,
             topojson=topojson,
         )
diff --git a/src/py/tests/test_init.py b/src/py/tests/test_init.py
index 5ff5498f..ee6b4619 100644
--- a/src/py/tests/test_init.py
+++ b/src/py/tests/test_init.py
@@ -83,13 +83,12 @@ async def test_async_wrapper_functions(mock_kaleido_class):
     topojson = "test_topojson"
     kopts = {"some_option": "value"}
 
-    result = await kaleido.calc_fig(fig, path, opts, topojson=topojson, kopts=kopts)
+    result = await kaleido.calc_fig(fig, opts, topojson=topojson, kopts=kopts)
 
     expected_kopts = {"some_option": "value", "n": 1}
     mock_kaleido_class.assert_called_with(**expected_kopts)
     mock_kaleido.calc_fig.assert_called_with(
         fig,
-        path=path,
         opts=opts,
         topojson=topojson,
     )

From e47110f9741ad4f112a4a89c8ff628a1ff8dfef5 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Tue, 9 Sep 2025 13:57:22 -0500
Subject: [PATCH 111/167] Fix path coercian in utilities.

---
 src/py/kaleido/_path_tools.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/py/kaleido/_path_tools.py b/src/py/kaleido/_path_tools.py
index 71e96fcb..c738fcdf 100644
--- a/src/py/kaleido/_path_tools.py
+++ b/src/py/kaleido/_path_tools.py
@@ -31,11 +31,11 @@ def _next_filename(path: Path | str, prefix: str, ext: str) -> str:
 
 
 def determine_path(
-    path: Path | None,
+    path: Path | str | None,
     fig: dict,
     ext: _fig_tools.FormatString,
 ) -> Path:
-    path = path or Path()
+    path = Path(path) if path else Path()
 
     if not path.suffix or path.is_dir():  # they gave us a directory
         if not path.is_dir():

From 7176caf90bb25a8e03614d6d8175df800b65dd3f Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Tue, 9 Sep 2025 14:18:14 -0500
Subject: [PATCH 112/167] Factor tests to reflect package factor

---
 src/py/tests/test_fig_tools.py  | 187 +++-----------------------------
 src/py/tests/test_path_tools.py | 157 +++++++++++++++++++++++++++
 2 files changed, 175 insertions(+), 169 deletions(-)
 create mode 100644 src/py/tests/test_path_tools.py

diff --git a/src/py/tests/test_fig_tools.py b/src/py/tests/test_fig_tools.py
index aa89326a..ee32e9ab 100644
--- a/src/py/tests/test_fig_tools.py
+++ b/src/py/tests/test_fig_tools.py
@@ -1,5 +1,3 @@
-from pathlib import Path
-
 import pytest
 
 from kaleido import _fig_tools
@@ -13,15 +11,20 @@
 @pytest.mark.parametrize("height_source", sources)
 @pytest.mark.parametrize("width_value", values)
 @pytest.mark.parametrize("height_value", values2)
-def test_get_figure_dimensions(width_source, height_source, width_value, height_value):
-    """Test _get_figure_dimensions with all combinations of width/height sources."""
+def test_coerce_for_js_dimensions(
+    width_source,
+    height_source,
+    width_value,
+    height_value,
+):
+    """Test coerce_for_js with all combinations of width/height sources."""
 
     layout = {}
-    width_arg = None
+    opts = {}
     expected_width = width_value
 
     if width_source == "argument":
-        width_arg = width_value
+        opts["width"] = width_value
     elif width_source == "layout":
         layout["width"] = width_value
     elif width_source == "template":
@@ -36,11 +39,10 @@ def test_get_figure_dimensions(width_source, height_source, width_value, height_
         expected_width = _fig_tools.DEFAULT_WIDTH
 
     # Do for height what I did for width
-    height_arg = None
     expected_height = height_value
 
     if height_source == "argument":
-        height_arg = height_value
+        opts["height"] = height_value
     elif height_source == "layout":
         layout["height"] = height_value
     elif height_source == "template":
@@ -54,171 +56,18 @@ def test_get_figure_dimensions(width_source, height_source, width_value, height_
     if expected_height is None:
         expected_height = _fig_tools.DEFAULT_HEIGHT
 
+    # Create a figure dict with the layout
+    fig = {"data": [], "layout": layout}
+
     # Call the function
-    r_width, r_height = _fig_tools._get_figure_dimensions(  # noqa: SLF001
-        layout,
-        width_arg,
-        height_arg,
-    )
+    spec = _fig_tools.coerce_for_js(fig, None, opts)
 
     # Assert results
-    assert r_width == expected_width, (
-        f"Width mismatch: got {r_width}, expected {expected_width}, "
+    assert spec["width"] == expected_width, (
+        f"Width mismatch: got {spec['width']}, expected {expected_width}, "
         f"source: {width_source}, value: {width_value}"
     )
-    assert r_height == expected_height, (
-        f"Height mismatch: got {r_height}, expected {expected_height}, "
+    assert spec["height"] == expected_height, (
+        f"Height mismatch: got {spec['height']}, expected {expected_height}, "
         f"source: {height_source}, value: {height_value}"
     )
-
-
-def test_next_filename_no_existing_files(tmp_path):
-    """Test _next_filename when no files exist."""
-    result = _fig_tools._next_filename(tmp_path, "test", "png")  # noqa: SLF001
-    assert result == "test.png"
-
-
-def test_next_filename_base_file_exists(tmp_path):
-    """Test _next_filename when base file exists."""
-    # Create the base file
-    (tmp_path / "test.png").touch()
-
-    result = _fig_tools._next_filename(tmp_path, "test", "png")  # noqa: SLF001
-    assert result == "test-2.png"
-
-
-def test_next_filename_numbered_files_exist(tmp_path):
-    """Test _next_filename when numbered files exist."""
-    # Create various numbered files
-    (tmp_path / "test.png").touch()
-    (tmp_path / "test-2.png").touch()
-    (tmp_path / "test-3.png").touch()
-    (tmp_path / "test-5.png").touch()  # Gap in numbering
-
-    result = _fig_tools._next_filename(tmp_path, "test", "png")  # noqa: SLF001
-    assert result == "test-6.png"  # Should be max + 1
-
-
-def test_next_filename_similar_names_ignored(tmp_path):
-    """Test _next_filename ignores files with similar but different names."""
-    # Create files that shouldn't match the pattern
-    (tmp_path / "test.png").touch()
-    (tmp_path / "test-2.png").touch()
-    (tmp_path / "testing-3.png").touch()  # Different prefix
-    (tmp_path / "test-2.jpg").touch()  # Different extension
-    (tmp_path / "test-abc.png").touch()  # Non-numeric suffix
-
-    result = _fig_tools._next_filename(tmp_path, "test", "png")  # noqa: SLF001
-    assert result == "test-3.png"  # Should only count test.png and test-2.png
-
-
-def test_next_filename_special_characters(tmp_path):
-    """Test _next_filename with special characters in prefix and extension."""
-    prefix = "test-?f$ile_name"
-    ext = "s$v&*g"  # set up to be parameterized but not
-
-    # Create some files
-    (tmp_path / f"{prefix}.{ext}").touch()
-    (tmp_path / f"{prefix}-2.{ext}").touch()
-
-    result = _fig_tools._next_filename(tmp_path, prefix, ext)  # noqa: SLF001
-    assert result == f"{prefix}-3.{ext}"
-
-
-def test_next_filename_only_numbered_files(tmp_path):
-    """Test _next_filename when only numbered files exist (no base file)."""
-    # Create only numbered files, no base file
-    (tmp_path / "test-2.png").touch()
-    (tmp_path / "test-3.png").touch()
-    (tmp_path / "test-10.png").touch()
-
-    result = _fig_tools._next_filename(tmp_path, "test", "png")  # noqa: SLF001
-    assert result == "test-11.png"  # Should be max + 1
-
-
-# Fixtures for _build_full_path tests - testing various title scenarios
-@pytest.fixture(
-    params=[
-        (
-            {
-                "layout": {
-                    "title": {"text": "My-Test!@#$%^&*()Chart_with[lots]of{symbols}"},
-                },
-            },
-            "My_TestChart_withlotsofsymbols",
-        ),  # Complex title
-        (
-            {"layout": {"title": {"text": "Simple Title"}}},
-            "Simple_Title",
-        ),  # Simple title
-        ({"layout": {}}, "fig"),  # No title
-    ],
-)
-def fig_fixture(request):
-    """Parameterized fixture for fig with various title scenarios."""
-    return request.param
-
-
-def test_build_full_path_no_path_input(fig_fixture):
-    """Test _build_full_path with no path input uses current path."""
-    fig_dict, expected_prefix = fig_fixture
-    result = _fig_tools._build_full_path(None, fig_dict, "ext")  # noqa: SLF001
-
-    # Should use current directory
-    assert result.parent.resolve() == Path().cwd().resolve()
-    assert result.parent.is_dir()
-
-    assert result.name == f"{expected_prefix}.ext"
-
-
-def test_build_full_path_no_suffix_directory(tmp_path, fig_fixture):
-    """Test _build_full_path with path to directory having no suffix."""
-    fig_dict, expected_prefix = fig_fixture
-
-    # Test directory no suffix
-    test_dir = tmp_path
-    result = _fig_tools._build_full_path(test_dir, fig_dict, "ext")  # noqa: SLF001
-
-    # Should use provided directory
-    assert result.parent == test_dir
-    assert result.name == f"{expected_prefix}.ext"
-
-    # Test error
-    nonexistent_dir = Path("/nonexistent/directory")
-    with pytest.raises(ValueError, match="Directory .* not found. Please create it."):
-        _fig_tools._build_full_path(nonexistent_dir, fig_dict, "ext")  # noqa: SLF001
-
-
-def test_build_full_path_directory_with_suffix(tmp_path, fig_fixture):
-    """Test _build_full_path with path that is directory even with suffix."""
-    fig_dict, expected_prefix = fig_fixture
-
-    # Create a directory with a suffix-like name
-    dir_with_suffix = tmp_path / "mydir.png"
-    dir_with_suffix.mkdir()
-
-    result = _fig_tools._build_full_path(dir_with_suffix, fig_dict, "ext")  # noqa: SLF001
-
-    # Should treat as directory
-    assert result.parent == dir_with_suffix
-    assert result.name == f"{expected_prefix}.ext"
-
-
-def test_build_full_path_file_with_suffix(tmp_path, fig_fixture):
-    """Test _build_full_path with file path having suffix."""
-    fig_dict, expected_prefix = fig_fixture
-
-    # Exists
-    file_path = tmp_path / "output.png"
-    result = _fig_tools._build_full_path(file_path, fig_dict, "ext")  # noqa: SLF001
-
-    # Should return the exact path provided
-    assert result == file_path
-
-    # Doesn't exist
-    file_path = Path("/nonexistent/directory/output.png")
-    with pytest.raises(
-        RuntimeError,
-        match="Cannot reach path .* Are all directories created?",
-    ):
-        _fig_tools._build_full_path(file_path, fig_dict, "ext")  # noqa: SLF001
diff --git a/src/py/tests/test_path_tools.py b/src/py/tests/test_path_tools.py
new file mode 100644
index 00000000..15d115ce
--- /dev/null
+++ b/src/py/tests/test_path_tools.py
@@ -0,0 +1,157 @@
+from pathlib import Path
+
+import pytest
+
+from kaleido import _path_tools
+
+
+def test_next_filename_no_existing_files(tmp_path):
+    """Test _next_filename when no files exist."""
+    result = _path_tools._next_filename(tmp_path, "test", "png")  # noqa: SLF001
+    assert result == "test.png"
+
+
+def test_next_filename_base_file_exists(tmp_path):
+    """Test _next_filename when base file exists."""
+    # Create the base file
+    (tmp_path / "test.png").touch()
+
+    result = _path_tools._next_filename(tmp_path, "test", "png")  # noqa: SLF001
+    assert result == "test-2.png"
+
+
+def test_next_filename_numbered_files_exist(tmp_path):
+    """Test _next_filename when numbered files exist."""
+    # Create various numbered files
+    (tmp_path / "test.png").touch()
+    (tmp_path / "test-2.png").touch()
+    (tmp_path / "test-3.png").touch()
+    (tmp_path / "test-5.png").touch()  # Gap in numbering
+
+    result = _path_tools._next_filename(tmp_path, "test", "png")  # noqa: SLF001
+    assert result == "test-6.png"  # Should be max + 1
+
+
+def test_next_filename_similar_names_ignored(tmp_path):
+    """Test _next_filename ignores files with similar but different names."""
+    # Create files that shouldn't match the pattern
+    (tmp_path / "test.png").touch()
+    (tmp_path / "test-2.png").touch()
+    (tmp_path / "testing-3.png").touch()  # Different prefix
+    (tmp_path / "test-2.jpg").touch()  # Different extension
+    (tmp_path / "test-abc.png").touch()  # Non-numeric suffix
+
+    result = _path_tools._next_filename(tmp_path, "test", "png")  # noqa: SLF001
+    assert result == "test-3.png"  # Should only count test.png and test-2.png
+
+
+def test_next_filename_special_characters(tmp_path):
+    """Test _next_filename with special characters in prefix and extension."""
+    prefix = "test-?f$ile_name"
+    ext = "s$v&*g"  # set up to be parameterized but not
+
+    # Create some files
+    (tmp_path / f"{prefix}.{ext}").touch()
+    (tmp_path / f"{prefix}-2.{ext}").touch()
+
+    result = _path_tools._next_filename(tmp_path, prefix, ext)  # noqa: SLF001
+    assert result == f"{prefix}-3.{ext}"
+
+
+def test_next_filename_only_numbered_files(tmp_path):
+    """Test _next_filename when only numbered files exist (no base file)."""
+    # Create only numbered files, no base file
+    (tmp_path / "test-2.png").touch()
+    (tmp_path / "test-3.png").touch()
+    (tmp_path / "test-10.png").touch()
+
+    result = _path_tools._next_filename(tmp_path, "test", "png")  # noqa: SLF001
+    assert result == "test-11.png"  # Should be max + 1
+
+
+# Fixtures for determine_path tests - testing various title scenarios
+@pytest.fixture(
+    params=[
+        (
+            {
+                "layout": {
+                    "title": {"text": "My-Test!@#$%^&*()Chart_with[lots]of{symbols}"},
+                },
+            },
+            "My_TestChart_withlotsofsymbols",
+        ),  # Complex title
+        (
+            {"layout": {"title": {"text": "Simple Title"}}},
+            "Simple_Title",
+        ),  # Simple title
+        ({"layout": {}}, "fig"),  # No title
+    ],
+)
+def fig_fixture(request):
+    """Parameterized fixture for fig with various title scenarios."""
+    return request.param
+
+
+def test_determine_path_no_path_input(fig_fixture):
+    """Test determine_path with no path input uses current path."""
+    fig_dict, expected_prefix = fig_fixture
+    result = _path_tools.determine_path(None, fig_dict, "ext")
+
+    # Should use current directory
+    assert result.parent.resolve() == Path().cwd().resolve()
+    assert result.parent.is_dir()
+
+    assert result.name == f"{expected_prefix}.ext"
+
+
+def test_determine_path_no_suffix_directory(tmp_path, fig_fixture):
+    """Test determine_path with path to directory having no suffix."""
+    fig_dict, expected_prefix = fig_fixture
+
+    # Test directory no suffix
+    test_dir = tmp_path
+    result = _path_tools.determine_path(test_dir, fig_dict, "ext")
+
+    # Should use provided directory
+    assert result.parent == test_dir
+    assert result.name == f"{expected_prefix}.ext"
+
+    # Test error
+    nonexistent_dir = Path("/nonexistent/directory")
+    with pytest.raises(ValueError, match="Directory .* not found. Please create it."):
+        _path_tools.determine_path(nonexistent_dir, fig_dict, "ext")
+
+
+def test_determine_path_directory_with_suffix(tmp_path, fig_fixture):
+    """Test determine_path with path that is directory even with suffix."""
+    fig_dict, expected_prefix = fig_fixture
+
+    # Create a directory with a suffix-like name
+    dir_with_suffix = tmp_path / "mydir.png"
+    dir_with_suffix.mkdir()
+
+    result = _path_tools.determine_path(dir_with_suffix, fig_dict, "ext")
+
+    # Should treat as directory
+    assert result.parent == dir_with_suffix
+    assert result.name == f"{expected_prefix}.ext"
+
+
+def test_determine_path_file_with_suffix(tmp_path, fig_fixture):
+    """Test determine_path with file path having suffix."""
+    fig_dict, expected_prefix = fig_fixture
+
+    # Exists
+    file_path = tmp_path / "output.png"
+    result = _path_tools.determine_path(file_path, fig_dict, "ext")
+
+    # Should return the exact path provided
+    assert result == file_path
+
+    # Doesn't exist
+    file_path = Path("/nonexistent/directory/output.png")
+    with pytest.raises(
+        RuntimeError,
+        match="Cannot reach path .* Are all directories created?",
+    ):
+        _path_tools.determine_path(file_path, fig_dict, "ext")

From 656bce0fc6064b711c5207c4b2f62c1b73456d14 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Tue, 9 Sep 2025 14:57:02 -0500
Subject: [PATCH 113/167] Allow from_object to take single FigureDict

---
 src/py/kaleido/kaleido.py | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/src/py/kaleido/kaleido.py b/src/py/kaleido/kaleido.py
index 6dc66072..298e8bc5 100644
--- a/src/py/kaleido/kaleido.py
+++ b/src/py/kaleido/kaleido.py
@@ -360,7 +360,7 @@ async def write_fig_from_object(
 
     async def write_fig_from_object(
         self,
-        generator: AnyIterable[FigureDict],  # TODO: must take a FigureDict alone
+        generator: FigureDict | AnyIterable[FigureDict],
         *,
         cancel_on_error=False,
         _write: bool = True,  # backwards compatibility!
@@ -368,8 +368,13 @@ async def write_fig_from_object(
         """Temp."""
         if not _write:
             cancel_on_error = True
+
+        if isinstance(generator, dict) and "fig" in generator:
+            generator = [generator]
+
         if main_task := asyncio.current_task():
             self._main_render_coroutines.add(main_task)
+
         tasks: set[asyncio.Task] = set()
 
         try:

From 0ec1905a8452fa4a659a36db743cc467fdbb6112 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Wed, 10 Sep 2025 11:45:20 -0500
Subject: [PATCH 114/167] Change skip to fail

---
 src/py/tests/test_page_generator.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/py/tests/test_page_generator.py b/src/py/tests/test_page_generator.py
index 2324d366..762cf00e 100644
--- a/src/py/tests/test_page_generator.py
+++ b/src/py/tests/test_page_generator.py
@@ -219,7 +219,7 @@ async def test_force_cdn():
     """Test force_cdn=True forces use of CDN plotly even when plotly is available."""
     # Verify plotly is available first
     if not find_spec("plotly"):
-        pytest.skip("Plotly not available - cannot test force_cdn override")
+        pytest.fail("Plotly not available - cannot test force_cdn override")
 
     forced_cdn = PageGenerator(force_cdn=True).generate_index()
     scripts, encodings = get_scripts_from_html(forced_cdn)

From a9da2ff61c926aebd9545cc013356c17700cc95e Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Wed, 17 Sep 2025 12:03:53 -0500
Subject: [PATCH 115/167] Fix missing () in fn call

---
 src/py/tests/conftest.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/py/tests/conftest.py b/src/py/tests/conftest.py
index 8d4f32fd..f7e9f799 100644
--- a/src/py/tests/conftest.py
+++ b/src/py/tests/conftest.py
@@ -20,7 +20,7 @@
 )
 
 is_ci = os.getenv("GITHUB_ACTIONS") == "true" or os.getenv("CI") == "true"
-if is_ci and platform.system in {"Windows", "Darwin"}:
+if is_ci and platform.system() in {"Windows", "Darwin"}:
     settings.load_profile("ci")
 
 

From d07190d2155feeeeb72839ba93780a98baf36aa9 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Thu, 18 Sep 2025 22:03:44 -0500
Subject: [PATCH 116/167] Make unreasonable timeout test more reasonable.

---
 src/py/tests/test_kaleido.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/py/tests/test_kaleido.py b/src/py/tests/test_kaleido.py
index 6b178dce..32015141 100644
--- a/src/py/tests/test_kaleido.py
+++ b/src/py/tests/test_kaleido.py
@@ -340,7 +340,7 @@ async def test_unreasonable_timeout(simple_figure_with_bytes):
     opts = simple_figure_with_bytes["opts"]
 
     # Use an infinitely small timeout
-    async with Kaleido(timeout=0.000001) as k:
+    async with Kaleido(timeout=0.0001) as k:
         with pytest.raises((asyncio.TimeoutError, TimeoutError)):
             await k.calc_fig(fig, opts=opts)
 

From c4b573fc066d1235e8665826c5bb673cf2869323 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Fri, 19 Sep 2025 13:08:57 -0500
Subject: [PATCH 117/167] Type from_object to accept regular dicts.

---
 src/py/kaleido/__init__.py | 2 +-
 src/py/kaleido/kaleido.py  | 8 ++++----
 2 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/src/py/kaleido/__init__.py b/src/py/kaleido/__init__.py
index 10a47c2e..e008cd43 100644
--- a/src/py/kaleido/__init__.py
+++ b/src/py/kaleido/__init__.py
@@ -139,7 +139,7 @@ async def write_fig(
 
 
 async def write_fig_from_object(
-    generator: AnyIterable[FigureDict],
+    generator: FigureDict | AnyIterable[FigureDict],
     *,
     kopts: dict[str, Any] | None = None,
     **kwargs,  # TODO(AJP): what might we pass here?
diff --git a/src/py/kaleido/kaleido.py b/src/py/kaleido/kaleido.py
index c124972e..c45824fa 100644
--- a/src/py/kaleido/kaleido.py
+++ b/src/py/kaleido/kaleido.py
@@ -339,7 +339,7 @@ async def _render_task(
     @overload
     async def write_fig_from_object(
         self,
-        generator: AnyIterable[FigureDict],
+        generator: FigureDict | AnyIterable[FigureDict],
         *,
         cancel_on_error: bool = False,
         _write: Literal[False],
@@ -348,7 +348,7 @@ async def write_fig_from_object(
     @overload
     async def write_fig_from_object(
         self,
-        generator: AnyIterable[FigureDict],
+        generator: FigureDict | AnyIterable[FigureDict],
         *,
         cancel_on_error: Literal[True],
         _write: Literal[True] = True,
@@ -357,7 +357,7 @@ async def write_fig_from_object(
     @overload
     async def write_fig_from_object(
         self,
-        generator: AnyIterable[FigureDict],
+        generator: FigureDict | AnyIterable[FigureDict],
         *,
         cancel_on_error: Literal[False] = False,
         _write: Literal[True] = True,
@@ -366,7 +366,7 @@ async def write_fig_from_object(
     @overload
     async def write_fig_from_object(
         self,
-        generator: AnyIterable[FigureDict],
+        generator: FigureDict | AnyIterable[FigureDict],
         *,
         cancel_on_error: bool,
         _write: Literal[True] = True,

From 6a4856993aaf49dbd251b6061ff6c4f9bf8394c6 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Fri, 19 Sep 2025 13:12:18 -0500
Subject: [PATCH 118/167] Fix tests to properly test bare dictionary.

---
 src/py/tests/test_kaleido.py | 33 ++++++++++++---------------------
 1 file changed, 12 insertions(+), 21 deletions(-)

diff --git a/src/py/tests/test_kaleido.py b/src/py/tests/test_kaleido.py
index 32015141..525274e9 100644
--- a/src/py/tests/test_kaleido.py
+++ b/src/py/tests/test_kaleido.py
@@ -121,34 +121,25 @@ async def test_write_fig_from_object_bare_dictionary(
     simple_figure_with_bytes,
     tmp_path,
 ):
-    """Test write_fig_from_object with bare dictionary list."""
+    """Test write_fig_from_object with bare dictionary."""
 
     path1 = tmp_path / "test_dict_1.png"
-    path2 = tmp_path / "test_dict_2.png"
-
-    fig_data = [
-        {
-            "fig": simple_figure_with_bytes["fig"],
-            "path": path1,
-            "opts": simple_figure_with_bytes["opts"],
-        },
-        {
-            "fig": simple_figure_with_bytes["fig"].to_dict(),
-            "path": path2,
-            "opts": simple_figure_with_bytes["opts"],
-        },
-    ]
+
+    fig_data = {
+        "fig": simple_figure_with_bytes["fig"],
+        "path": path1,
+        "opts": simple_figure_with_bytes["opts"],
+    }
 
     async with Kaleido() as k:
         await k.write_fig_from_object(fig_data)
 
     # Assert that each created file matches the fixture bytes
-    for path in [path1, path2]:
-        assert path.exists(), f"File {path} was not created"
-        created_bytes = path.read_bytes()
-        assert created_bytes == simple_figure_with_bytes["bytes"], (
-            f"File {path} bytes don't match fixture bytes"
-        )
+    assert path1.exists(), f"File {path1} was not created"
+    created_bytes = path1.read_bytes()
+    assert created_bytes == simple_figure_with_bytes["bytes"], (
+        f"File {path1} bytes don't match fixture bytes"
+    )
 
 
 # In the refactor, all figure generation methods are really just wrappers

From 3f6689d22e898d5e29578bd99130dab9b1fdc223 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Fri, 19 Sep 2025 13:15:07 -0500
Subject: [PATCH 119/167] Make variable name more clear for generators.

---
 src/py/kaleido/__init__.py |  6 +++---
 src/py/kaleido/kaleido.py  | 22 +++++++++++-----------
 2 files changed, 14 insertions(+), 14 deletions(-)

diff --git a/src/py/kaleido/__init__.py b/src/py/kaleido/__init__.py
index e008cd43..e68c3183 100644
--- a/src/py/kaleido/__init__.py
+++ b/src/py/kaleido/__init__.py
@@ -139,13 +139,13 @@ async def write_fig(
 
 
 async def write_fig_from_object(
-    generator: FigureDict | AnyIterable[FigureDict],
+    fig_dicts: FigureDict | AnyIterable[FigureDict],
     *,
     kopts: dict[str, Any] | None = None,
     **kwargs,  # TODO(AJP): what might we pass here?
 ):
     """
-    Write a plotly figure(s) to a file specified by a dictionary generator.
+    Write a plotly figure(s) to a file specified by a dictionary or iterable of.
 
     A convenience wrapper for `Kaleido.write_fig_from_object()` which starts a
     `Kaleido` and executes the `write_fig_from_object()`
@@ -157,7 +157,7 @@ async def write_fig_from_object(
     """
     async with Kaleido(**(kopts or {})) as k:
         await k.write_fig_from_object(
-            generator,
+            fig_dicts,
             **kwargs,
         )
 
diff --git a/src/py/kaleido/kaleido.py b/src/py/kaleido/kaleido.py
index c45824fa..2e4edc77 100644
--- a/src/py/kaleido/kaleido.py
+++ b/src/py/kaleido/kaleido.py
@@ -39,7 +39,7 @@
     Listish: TypeAlias = Union[Tuple[T], List[T], ValuesView[T]]
 
     class FigureDict(TypedDict):
-        """The type a generator returns for `write_fig_from_object`."""
+        """The type a fig_dicts returns for `write_fig_from_object`."""
 
         fig: Required[_fig_tools.Figurish]
         path: NotRequired[None | str | Path]
@@ -339,7 +339,7 @@ async def _render_task(
     @overload
     async def write_fig_from_object(
         self,
-        generator: FigureDict | AnyIterable[FigureDict],
+        fig_dicts: FigureDict | AnyIterable[FigureDict],
         *,
         cancel_on_error: bool = False,
         _write: Literal[False],
@@ -348,7 +348,7 @@ async def write_fig_from_object(
     @overload
     async def write_fig_from_object(
         self,
-        generator: FigureDict | AnyIterable[FigureDict],
+        fig_dicts: FigureDict | AnyIterable[FigureDict],
         *,
         cancel_on_error: Literal[True],
         _write: Literal[True] = True,
@@ -357,7 +357,7 @@ async def write_fig_from_object(
     @overload
     async def write_fig_from_object(
         self,
-        generator: FigureDict | AnyIterable[FigureDict],
+        fig_dicts: FigureDict | AnyIterable[FigureDict],
         *,
         cancel_on_error: Literal[False] = False,
         _write: Literal[True] = True,
@@ -366,7 +366,7 @@ async def write_fig_from_object(
     @overload
     async def write_fig_from_object(
         self,
-        generator: FigureDict | AnyIterable[FigureDict],
+        fig_dicts: FigureDict | AnyIterable[FigureDict],
         *,
         cancel_on_error: bool,
         _write: Literal[True] = True,
@@ -374,7 +374,7 @@ async def write_fig_from_object(
 
     async def write_fig_from_object(
         self,
-        generator: FigureDict | AnyIterable[FigureDict],
+        fig_dicts: FigureDict | AnyIterable[FigureDict],
         *,
         cancel_on_error=False,
         _write: bool = True,  # backwards compatibility!
@@ -383,8 +383,8 @@ async def write_fig_from_object(
         if not _write:
             cancel_on_error = True
 
-        if _is_figuredict(generator):
-            generator = [generator]
+        if _is_figuredict(fig_dicts):
+            fig_dicts = [fig_dicts]
 
         if main_task := asyncio.current_task():
             self._main_render_coroutines.add(main_task)
@@ -392,7 +392,7 @@ async def write_fig_from_object(
         tasks: set[asyncio.Task] = set()
 
         try:
-            async for fig_arg in _utils.ensure_async_iter(generator):
+            async for fig_arg in _utils.ensure_async_iter(fig_dicts):
                 spec = _fig_tools.coerce_for_js(
                     fig_arg.get("fig"),
                     fig_arg.get("path", None),
@@ -456,7 +456,7 @@ async def _temp_generator() -> AsyncGenerator[FigureDict, None]:
 
         generator = cast("AsyncIterable[FigureDict]", _temp_generator())
         return await self.write_fig_from_object(
-            generator=generator,
+            fig_dicts=generator,
             cancel_on_error=cancel_on_error,
         )
 
@@ -477,7 +477,7 @@ async def _temp_generator():
             }
 
         return await self.write_fig_from_object(
-            generator=_temp_generator(),
+            fig_dicts=_temp_generator(),
             cancel_on_error=True,
             _write=False,
         )

From 02b51ef980c0fdb55c3c0c46e19e8301c9ade842 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Fri, 19 Sep 2025 15:35:15 -0500
Subject: [PATCH 120/167] Reorganize task to encapsulate all errors.

---
 src/py/kaleido/kaleido.py | 40 ++++++++++++++++++++-------------------
 1 file changed, 21 insertions(+), 19 deletions(-)

diff --git a/src/py/kaleido/kaleido.py b/src/py/kaleido/kaleido.py
index 2e4edc77..b3e01a2e 100644
--- a/src/py/kaleido/kaleido.py
+++ b/src/py/kaleido/kaleido.py
@@ -312,10 +312,24 @@ async def _return_kaleido_tab(self, tab: _KaleidoTab) -> None:
 
     async def _render_task(
         self,
-        spec: _fig_tools.Spec,
-        write_path: Path | None,
+        fig_arg: FigureDict,
+        *,
+        _write: bool,
         **kwargs: Any,
     ) -> None | bytes:
+        spec = _fig_tools.coerce_for_js(
+            fig_arg.get("fig"),
+            fig_arg.get("path", None),
+            fig_arg.get("opts", None),
+        )
+
+        if _write:
+            full_path = _path_tools.determine_path(
+                fig_arg.get("path", None),
+                spec["data"],
+                spec["format"],  # should just take spec
+            )
+
         tab = await self._get_kaleido_tab()
 
         try:
@@ -326,8 +340,8 @@ async def _render_task(
                 ),
                 self._timeout,
             )
-            if write_path:
-                await _utils.to_thread(write_path.write_bytes, img_bytes)
+            if _write:
+                await _utils.to_thread(full_path.write_bytes, img_bytes)
                 return None
             else:
                 return img_bytes
@@ -339,7 +353,7 @@ async def _render_task(
     @overload
     async def write_fig_from_object(
         self,
-        fig_dicts: FigureDict | AnyIterable[FigureDict],
+        fig_dicts: FigureDict,
         *,
         cancel_on_error: bool = False,
         _write: Literal[False],
@@ -393,23 +407,11 @@ async def write_fig_from_object(
 
         try:
             async for fig_arg in _utils.ensure_async_iter(fig_dicts):
-                spec = _fig_tools.coerce_for_js(
-                    fig_arg.get("fig"),
-                    fig_arg.get("path", None),
-                    fig_arg.get("opts", None),
-                )
-
-                full_path = _path_tools.determine_path(
-                    fig_arg.get("path", None),
-                    spec["data"],
-                    spec["format"],  # should just take spec
-                )
-
                 t: asyncio.Task = asyncio.create_task(
                     self._render_task(
-                        spec=spec,
-                        write_path=full_path if _write else None,  # bwrds - compat!
+                        fig_arg=fig_arg,
                         topojson=fig_arg.get("topojson"),
+                        _write=_write,  # backwards compatibility
                     ),
                 )
                 tasks.add(t)

From fb34945e7bae94643bb703992360f96603ff5107 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Fri, 19 Sep 2025 15:35:22 -0500
Subject: [PATCH 121/167] Test return values.

---
 src/py/tests/test_kaleido.py | 38 ++++++++++++++++++++++++++++++++++++
 1 file changed, 38 insertions(+)

diff --git a/src/py/tests/test_kaleido.py b/src/py/tests/test_kaleido.py
index 525274e9..7482c59b 100644
--- a/src/py/tests/test_kaleido.py
+++ b/src/py/tests/test_kaleido.py
@@ -117,6 +117,44 @@ async def test_write_fig_from_object_iterator(simple_figure_with_bytes, tmp_path
         )
 
 
+async def test_write_fig_from_object_return_modes(simple_figure_with_bytes, tmp_path):
+    """Test write_fig_from_object with different return schemes."""
+
+    fig_list = []
+    file_paths = []
+    for i in range(2):
+        path = tmp_path / "does_not_exist" / f"test_iter_{i}.png"
+        file_paths.append(path)
+        fig_list.append(
+            {
+                "fig": simple_figure_with_bytes["fig"],
+                "path": path,
+                "opts": simple_figure_with_bytes["opts"],
+            },
+        )
+
+    # test collecting errors
+    async with Kaleido() as k:
+        res = await k.write_fig_from_object(fig_list, cancel_on_error=False)
+    for r in res:
+        assert isinstance(r, RuntimeError)
+    assert len(res) == len(fig_list)
+
+    # test not collecting errors
+    with pytest.raises(RuntimeError):
+        async with Kaleido() as k:
+            res = await k.write_fig_from_object(fig_list, cancel_on_error=True)
+
+    # test returning
+    async with Kaleido() as k:
+        res = await k.write_fig_from_object(fig_list[0], _write=False)
+    assert res == simple_figure_with_bytes["bytes"]
+
+    # Assert that each created file matches the fixture bytes
+    for path in file_paths:
+        assert not path.exists()
+
+
 async def test_write_fig_from_object_bare_dictionary(
     simple_figure_with_bytes,
     tmp_path,

From 58d24616ad6b370842c4117e8cf29f0ed395e83b Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Fri, 19 Sep 2025 16:07:27 -0500
Subject: [PATCH 122/167] Influence async task order to remove race condition.

---
 src/py/kaleido/kaleido.py | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/src/py/kaleido/kaleido.py b/src/py/kaleido/kaleido.py
index b3e01a2e..3fa7c517 100644
--- a/src/py/kaleido/kaleido.py
+++ b/src/py/kaleido/kaleido.py
@@ -310,6 +310,8 @@ async def _return_kaleido_tab(self, tab: _KaleidoTab) -> None:
 
     #### WE'RE HERE
 
+    # this task must calculate full_path before it
+    # awaits, ie yielding control.
     async def _render_task(
         self,
         fig_arg: FigureDict,
@@ -329,6 +331,7 @@ async def _render_task(
                 spec["data"],
                 spec["format"],  # should just take spec
             )
+            full_path.touch()
 
         tab = await self._get_kaleido_tab()
 
@@ -345,7 +348,9 @@ async def _render_task(
                 return None
             else:
                 return img_bytes
-
+        except:
+            full_path.unlink()
+            raise
         finally:
             await self._return_kaleido_tab(tab)
 
@@ -415,6 +420,7 @@ async def write_fig_from_object(
                     ),
                 )
                 tasks.add(t)
+                await asyncio.sleep(0)  # this forces the added task to run
 
             res = await asyncio.gather(*tasks, return_exceptions=not cancel_on_error)
             if not _write:

From 20cfc5800d0207f485a7ffe2e46746ee3d7ec105 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Fri, 19 Sep 2025 16:09:03 -0500
Subject: [PATCH 123/167] Fix reference-before-assign

---
 src/py/kaleido/kaleido.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/src/py/kaleido/kaleido.py b/src/py/kaleido/kaleido.py
index 3fa7c517..86a26edf 100644
--- a/src/py/kaleido/kaleido.py
+++ b/src/py/kaleido/kaleido.py
@@ -349,7 +349,8 @@ async def _render_task(
             else:
                 return img_bytes
         except:
-            full_path.unlink()
+            if _write:
+                full_path.unlink()
             raise
         finally:
             await self._return_kaleido_tab(tab)

From 60dba998942cba20bdd8d42f6f612ad40cc03907 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Fri, 19 Sep 2025 16:15:45 -0500
Subject: [PATCH 124/167] Add comments.

---
 src/py/kaleido/kaleido.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/py/kaleido/kaleido.py b/src/py/kaleido/kaleido.py
index 86a26edf..6249dd64 100644
--- a/src/py/kaleido/kaleido.py
+++ b/src/py/kaleido/kaleido.py
@@ -331,7 +331,7 @@ async def _render_task(
                 spec["data"],
                 spec["format"],  # should just take spec
             )
-            full_path.touch()
+            full_path.touch()  # claim our name
 
         tab = await self._get_kaleido_tab()
 
@@ -350,7 +350,7 @@ async def _render_task(
                 return img_bytes
         except:
             if _write:
-                full_path.unlink()
+                full_path.unlink()  # failure, no write
             raise
         finally:
             await self._return_kaleido_tab(tab)

From 1bb6b8750c1c3a47468aa87522780f430c00a7a8 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Fri, 19 Sep 2025 16:49:16 -0500
Subject: [PATCH 125/167] Move simple fig to session scope.

---
 src/py/tests/test_kaleido.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/py/tests/test_kaleido.py b/src/py/tests/test_kaleido.py
index 7482c59b..815c1627 100644
--- a/src/py/tests/test_kaleido.py
+++ b/src/py/tests/test_kaleido.py
@@ -9,7 +9,7 @@
 from kaleido import Kaleido
 
 
-@pytest.fixture
+@pytest.fixture(scope="session")
 async def simple_figure_with_bytes():
     """Create a simple figure with calculated bytes and PNG assertion."""
     import plotly.express as px  # noqa: PLC0415

From 2fae310c745e926fe4c77f9abb4586200fabe6d4 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Fri, 19 Sep 2025 19:45:27 -0500
Subject: [PATCH 126/167] Fix up test write_fig->from_object passthrough

---
 src/py/kaleido/_fig_tools.py |  1 +
 src/py/tests/test_kaleido.py | 64 +++++++++++++++++++-----------------
 2 files changed, 35 insertions(+), 30 deletions(-)

diff --git a/src/py/kaleido/_fig_tools.py b/src/py/kaleido/_fig_tools.py
index 3f4a959f..2a828463 100644
--- a/src/py/kaleido/_fig_tools.py
+++ b/src/py/kaleido/_fig_tools.py
@@ -60,6 +60,7 @@ class Spec(TypedDict):
 
 # validation function
 def is_figurish(o: Any) -> TypeGuard[Figurish]:
+    # so if data isn't in the dict things get weird.
     valid = hasattr(o, "to_dict") or (isinstance(o, dict) and "data" in o)
     if not valid:
         _logger.debug(
diff --git a/src/py/tests/test_kaleido.py b/src/py/tests/test_kaleido.py
index 815c1627..f4ae3d27 100644
--- a/src/py/tests/test_kaleido.py
+++ b/src/py/tests/test_kaleido.py
@@ -1,9 +1,9 @@
 import asyncio
 import re
-from unittest.mock import patch
+from unittest.mock import AsyncMock, patch
 
 import pytest
-from hypothesis import HealthCheck, Phase, given, settings
+from hypothesis import HealthCheck, given, settings
 from hypothesis import strategies as st
 
 from kaleido import Kaleido
@@ -180,18 +180,14 @@ async def test_write_fig_from_object_bare_dictionary(
     )
 
 
-# In the refactor, all figure generation methods are really just wrappers
-# for the most flexible, tested above, generate_fig_from_object.
-# So we test that one, and then test to make sure its receiving arguments
-# properly for the other tests.
+@pytest.fixture(scope="function")
+def test_kaleido():
+    return Kaleido()
 
 
-# Uncomment these settings after refactor.
-# @settings(suppress_health_check=[HealthCheck.function_scoped_fixture])
 @settings(
-    phases=[Phase.generate],
-    max_examples=1,
     suppress_health_check=[HealthCheck.function_scoped_fixture],
+    max_examples=50,
 )
 @given(
     path=st.text(
@@ -204,8 +200,17 @@ async def test_write_fig_from_object_bare_dictionary(
     format_type=st.sampled_from(["png", "svg", "pdf", "html"]),
     topojson=st.one_of(st.none(), st.text(min_size=1, max_size=20)),
 )
+@pytest.mark.parametrize(
+    "cancel_on_error",
+    [
+        True,
+        False,
+    ],
+    ids=("cancel_on_error", "collect_errors"),
+)
 async def test_write_fig_argument_passthrough(  #  noqa: PLR0913
-    simple_figure_with_bytes,
+    test_kaleido,
+    cancel_on_error,
     tmp_path,
     path,
     width,
@@ -213,32 +218,33 @@ async def test_write_fig_argument_passthrough(  #  noqa: PLR0913
     format_type,
     topojson,
 ):
-    """Test that write_fig properly passes arguments to write_fig_from_object."""
-    pytest.skip("Remove this failure line and the comment above after the refactor!")
     test_path = tmp_path / f"{path}.{format_type}"
     opts = {"format": format_type, "width": width, "height": height}
-
+    fig = {"data": "test"}
     # Mock write_fig_from_object to capture arguments
-    with patch.object(Kaleido, "write_fig_from_object") as mock_write_fig_from_object:
-        async with Kaleido() as k:
-            await k.write_fig(
-                simple_figure_with_bytes["fig"],
-                path=test_path,
-                opts=opts,
-                topojson=topojson,
-            )
-
+    with patch.object(
+        Kaleido,
+        "write_fig_from_object",
+        new=AsyncMock(return_value=[]),
+    ) as mock_write_fig_from_object:
+        await test_kaleido.write_fig(
+            fig,
+            path=test_path,
+            opts=opts,
+            topojson=topojson,
+            cancel_on_error=cancel_on_error,
+        )
         # Verify write_fig_from_object was called
         mock_write_fig_from_object.assert_called_once()
 
         # Extract the generator that was passed as first argument
-        args, _kwargs = mock_write_fig_from_object.call_args  # not sure.
-        assert len(args) == 1, "Expected exactly one argument (the generator)"
+        _, kwargs = mock_write_fig_from_object.call_args  # not sure.
 
-        generator = args[0]
+        generator = kwargs["fig_dicts"]
+        assert kwargs["cancel_on_error"] == cancel_on_error
 
         # Convert generator to list to inspect its contents
-        generated_args_list = list(generator)
+        generated_args_list = [v async for v in generator]
         assert len(generated_args_list) == 1, (
             "Expected generator to yield exactly one item"
         )
@@ -252,9 +258,7 @@ async def test_write_fig_argument_passthrough(  #  noqa: PLR0913
         assert "topojson" in generated_args, "Generated args should contain 'topojson'"
 
         # Check that the values match
-        assert generated_args["fig"] == simple_figure_with_bytes["fig"], (
-            "Figure should match"
-        )
+        assert generated_args["fig"] == fig, "Figure should match"
         assert str(generated_args["path"]) == str(test_path), "Path should match"
         assert generated_args["opts"] == opts, "Options should match"
         assert generated_args["topojson"] == topojson, "Topojson should match"

From d31ee8a9be78eaf0d3ad44757b769a37333f645c Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Fri, 19 Sep 2025 20:02:43 -0500
Subject: [PATCH 127/167] Fix mismatched scope async tests.

---
 src/py/tests/test_kaleido.py | 16 ++++++++++------
 1 file changed, 10 insertions(+), 6 deletions(-)

diff --git a/src/py/tests/test_kaleido.py b/src/py/tests/test_kaleido.py
index f4ae3d27..d1e63efc 100644
--- a/src/py/tests/test_kaleido.py
+++ b/src/py/tests/test_kaleido.py
@@ -10,17 +10,21 @@
 
 
 @pytest.fixture(scope="session")
-async def simple_figure_with_bytes():
+def simple_figure_with_bytes():
     """Create a simple figure with calculated bytes and PNG assertion."""
     import plotly.express as px  # noqa: PLC0415
 
     fig = px.line(x=[1, 2, 3], y=[1, 2, 3])
 
-    async with Kaleido() as k:
-        bytes_data = await k.calc_fig(
-            fig,
-            opts={"format": "png", "width": 400, "height": 300},
-        )
+    async def build_obj():
+        async with Kaleido() as k:
+            bytes_data = await k.calc_fig(
+                fig,
+                opts={"format": "png", "width": 400, "height": 300},
+            )
+        return bytes_data
+
+    bytes_data = asyncio.run(build_obj())
 
     # Assert it's a PNG by checking the PNG signature
     assert bytes_data[:8] == b"\x89PNG\r\n\x1a\n", "Generated data is not a valid PNG"

From 0820b0bf9cb31aa20ed081e1488e6cfd40c6c8ca Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Sun, 21 Sep 2025 15:04:53 -0500
Subject: [PATCH 128/167] Add tests for calc_fig passthrough.

---
 src/py/tests/test_kaleido.py | 61 +++++++++++++++++++++++++++++++++++-
 1 file changed, 60 insertions(+), 1 deletion(-)

diff --git a/src/py/tests/test_kaleido.py b/src/py/tests/test_kaleido.py
index d1e63efc..d31e47bd 100644
--- a/src/py/tests/test_kaleido.py
+++ b/src/py/tests/test_kaleido.py
@@ -185,7 +185,7 @@ async def test_write_fig_from_object_bare_dictionary(
 
 
 @pytest.fixture(scope="function")
-def test_kaleido():
+def test_kaleido():  # speed up hypothesis test using a function fixture
     return Kaleido()
 
 
@@ -268,6 +268,65 @@ async def test_write_fig_argument_passthrough(  #  noqa: PLR0913
         assert generated_args["topojson"] == topojson, "Topojson should match"
 
 
+@settings(
+    suppress_health_check=[HealthCheck.function_scoped_fixture],
+    max_examples=50,
+)
+@given(
+    width=st.integers(min_value=100, max_value=2000),
+    height=st.integers(min_value=100, max_value=2000),
+    format_type=st.sampled_from(["png", "svg", "pdf", "html"]),
+    topojson=st.one_of(st.none(), st.text(min_size=1, max_size=20)),
+)
+async def test_calc_fig_argument_passthrough(
+    test_kaleido,
+    width,
+    height,
+    format_type,
+    topojson,
+):
+    opts = {"format": format_type, "width": width, "height": height}
+    fig = {"data": "test"}
+    # Mock write_fig_from_object to capture arguments
+    with patch.object(
+        Kaleido,
+        "write_fig_from_object",
+        new=AsyncMock(return_value=[]),
+    ) as mock_write_fig_from_object:
+        await test_kaleido.calc_fig(
+            fig,
+            opts=opts,
+            topojson=topojson,
+        )
+        # Verify write_fig_from_object was called
+        mock_write_fig_from_object.assert_called_once()
+
+        # Extract the generator that was passed as first argument
+        _, kwargs = mock_write_fig_from_object.call_args  # not sure.
+
+        generator = kwargs["fig_dicts"]
+        assert kwargs["cancel_on_error"] is True
+        assert kwargs["_write"] is False
+
+        # Convert generator to list to inspect its contents
+        generated_args_list = [v async for v in generator]
+        assert len(generated_args_list) == 1, (
+            "Expected generator to yield exactly one item"
+        )
+
+        generated_args = generated_args_list[0]
+
+        # Validate that the generated arguments match what we passed to write_fig
+        assert "fig" in generated_args, "Generated args should contain 'fig'"
+        assert "opts" in generated_args, "Generated args should contain 'opts'"
+        assert "topojson" in generated_args, "Generated args should contain 'topojson'"
+
+        # Check that the values match
+        assert generated_args["fig"] == fig, "Figure should match"
+        assert generated_args["opts"] == opts, "Options should match"
+        assert generated_args["topojson"] == topojson, "Topojson should match"
+
+
 async def test_kaleido_instantiate_no_hang():
     """Test that instantiating Kaleido doesn't hang."""
     _ = Kaleido()

From 588442eaa70c5e6041f943036f94f9a60b0b25c1 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Sun, 21 Sep 2025 15:50:54 -0500
Subject: [PATCH 129/167] Add comment to __init__.

---
 src/py/tests/test_init.py | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/src/py/tests/test_init.py b/src/py/tests/test_init.py
index 7a8a7213..c413154a 100644
--- a/src/py/tests/test_init.py
+++ b/src/py/tests/test_init.py
@@ -6,10 +6,8 @@
 
 import kaleido
 
-# Pretty complicated for basically testing a bunch of wrappers,
-# but it works. Integration tests seem more important.
-# I much prefer the public_api file, this set of tests can be considered
-# for deletion.
+# Just tests wrapping, but in a way tests internals.
+# These are better done as part of integration tests.
 
 
 @pytest.fixture

From 06e8dbaa07359fbf5886606adafb48f36c6f5189 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Sun, 21 Sep 2025 16:40:08 -0500
Subject: [PATCH 130/167] Add README to tests.

---
 src/py/tests/README.md | 11 +++++++++++
 1 file changed, 11 insertions(+)
 create mode 100644 src/py/tests/README.md

diff --git a/src/py/tests/README.md b/src/py/tests/README.md
new file mode 100644
index 00000000..3b0b8099
--- /dev/null
+++ b/src/py/tests/README.md
@@ -0,0 +1,11 @@
+- test_public_api.py does render tests of renderers in __init__.py
+  - it does not parametrize
+- test_init.py tests that wrappers are proper and pass args/kwargs
+  - it does parameterize
+- test_kaleido tests the substantial parts of kaleido and its returns
+  - it has incomplete parameterizing
+
+
+
+Parameterizing actual renders would be a huge burden, but integration tests
+with mocks test it more completely

From 6379dcef89a4d0d9ad9ff238ba74dca7b417a01a Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Sun, 21 Sep 2025 16:43:44 -0500
Subject: [PATCH 131/167] Pass new returns through wrapper api

---
 src/py/kaleido/__init__.py | 16 ++++++++++------
 1 file changed, 10 insertions(+), 6 deletions(-)

diff --git a/src/py/kaleido/__init__.py b/src/py/kaleido/__init__.py
index e68c3183..0e24c861 100644
--- a/src/py/kaleido/__init__.py
+++ b/src/py/kaleido/__init__.py
@@ -129,7 +129,7 @@ async def write_fig(
 
     """
     async with Kaleido(**(kopts or {})) as k:
-        await k.write_fig(
+        return await k.write_fig(
             fig,
             path=path,
             opts=opts,
@@ -156,7 +156,7 @@ async def write_fig_from_object(
 
     """
     async with Kaleido(**(kopts or {})) as k:
-        await k.write_fig_from_object(
+        return await k.write_fig_from_object(
             fig_dicts,
             **kwargs,
         )
@@ -173,14 +173,18 @@ def calc_fig_sync(*args: Any, **kwargs: Any):
 def write_fig_sync(*args: Any, **kwargs: Any):
     """Call `write_fig` but blocking."""
     if _global_server.is_running():
-        _global_server.call_function("write_fig", *args, **kwargs)
+        return _global_server.call_function("write_fig", *args, **kwargs)
     else:
-        _sync_server.oneshot_async_run(write_fig, args=args, kwargs=kwargs)
+        return _sync_server.oneshot_async_run(write_fig, args=args, kwargs=kwargs)
 
 
 def write_fig_from_object_sync(*args: Any, **kwargs: Any):
     """Call `write_fig_from_object` but blocking."""
     if _global_server.is_running():
-        _global_server.call_function("write_fig_from_object", *args, **kwargs)
+        return _global_server.call_function("write_fig_from_object", *args, **kwargs)
     else:
-        _sync_server.oneshot_async_run(write_fig_from_object, args=args, kwargs=kwargs)
+        return _sync_server.oneshot_async_run(
+            write_fig_from_object,
+            args=args,
+            kwargs=kwargs,
+        )

From 02ac1ce444b28c0121d3bb436f8e10e5edcadf73 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Sun, 21 Sep 2025 16:59:48 -0500
Subject: [PATCH 132/167] Check returns in public api tests.

---
 src/py/tests/test_public_api.py | 29 ++++++++++++++++++++++-------
 1 file changed, 22 insertions(+), 7 deletions(-)

diff --git a/src/py/tests/test_public_api.py b/src/py/tests/test_public_api.py
index 16fc4767..4ab93b39 100644
--- a/src/py/tests/test_public_api.py
+++ b/src/py/tests/test_public_api.py
@@ -30,7 +30,12 @@ async def test_async_api_functions(simple_figure, tmp_path):
 
     # Test write_fig and compare with calc_fig output
     write_fig_output = tmp_path / "test_write_fig.png"
-    await kaleido.write_fig(simple_figure, path=str(write_fig_output))
+    res = await kaleido.write_fig(
+        simple_figure,
+        path=str(write_fig_output),
+        cancel_on_error=True,
+    )
+    assert res is None
 
     with Path(write_fig_output).open("rb") as f:  # noqa: ASYNC230
         write_fig_bytes = f.read()
@@ -40,7 +45,7 @@ async def test_async_api_functions(simple_figure, tmp_path):
 
     # Test write_fig_from_object and compare with calc_fig output
     write_fig_from_object_output = tmp_path / "test_write_fig_from_object.png"
-    await kaleido.write_fig_from_object(
+    res = await kaleido.write_fig_from_object(
         [
             {
                 "fig": simple_figure,
@@ -48,6 +53,7 @@ async def test_async_api_functions(simple_figure, tmp_path):
             },
         ],
     )
+    assert res == ()
 
     with Path(write_fig_from_object_output).open("rb") as f:  # noqa: ASYNC230
         write_fig_from_object_bytes = f.read()
@@ -61,7 +67,7 @@ async def test_async_api_functions(simple_figure, tmp_path):
     assert write_fig_bytes == write_fig_from_object_bytes == calc_result
 
 
-async def test_sync_api_functions(simple_figure, tmp_path):
+async def test_sync_api_functions(simple_figure, tmp_path):  # noqa: PLR0915
     """Test sync wrappers with cross-validation."""
     # Get expected bytes from calc_fig for comparison
     expected_bytes = await kaleido.calc_fig(simple_figure)
@@ -88,7 +94,12 @@ async def test_sync_api_functions(simple_figure, tmp_path):
             assert calc_result_1 == expected_bytes
 
             # Test write_fig_sync
-            kaleido.write_fig_sync(simple_figure, path=str(write_fig_output_1))
+            res = kaleido.write_fig_sync(
+                simple_figure,
+                path=str(write_fig_output_1),
+                cancel_on_error=True,
+            )
+            assert res is None
 
             with Path(write_fig_output_1).open("rb") as f:  # noqa: ASYNC230
                 write_fig_bytes_1 = f.read()
@@ -96,7 +107,7 @@ async def test_sync_api_functions(simple_figure, tmp_path):
             assert write_fig_bytes_1.startswith(b"\x89PNG\r\n\x1a\n"), "Not a PNG file"
 
             # Test write_fig_from_object_sync
-            kaleido.write_fig_from_object_sync(
+            res = kaleido.write_fig_from_object_sync(
                 [
                     {
                         "fig": simple_figure,
@@ -104,6 +115,7 @@ async def test_sync_api_functions(simple_figure, tmp_path):
                     },
                 ],
             )
+            assert res == ()
 
             with Path(write_fig_from_object_output_1).open("rb") as f:  # noqa: ASYNC230
                 from_object_bytes_1 = f.read()
@@ -140,7 +152,8 @@ async def test_sync_api_functions(simple_figure, tmp_path):
         assert calc_result_2 == expected_bytes
 
         # Test write_fig_sync
-        kaleido.write_fig_sync(simple_figure, path=str(write_fig_output_2))
+        res = kaleido.write_fig_sync(simple_figure, path=str(write_fig_output_2))
+        assert res == ()
 
         with Path(write_fig_output_2).open("rb") as f:  # noqa: ASYNC230
             write_fig_bytes_2 = f.read()
@@ -148,14 +161,16 @@ async def test_sync_api_functions(simple_figure, tmp_path):
         assert write_fig_bytes_2.startswith(b"\x89PNG\r\n\x1a\n"), "Not a PNG file"
 
         # Test write_fig_from_object_sync
-        kaleido.write_fig_from_object_sync(
+        res = kaleido.write_fig_from_object_sync(
             [
                 {
                     "fig": simple_figure,
                     "path": write_fig_from_object_output_2,
                 },
             ],
+            cancel_on_error=True,
         )
+        assert res is None
 
         with Path(write_fig_from_object_output_2).open("rb") as f:  # noqa: ASYNC230
             from_object_bytes_2 = f.read()

From 75775feb20d43b959ee0a7cce575f7cdf387d60e Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Sun, 21 Sep 2025 16:59:54 -0500
Subject: [PATCH 133/167] Tweak timeouts in tests.

---
 src/py/pyproject.toml        | 2 +-
 src/py/tests/test_kaleido.py | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/py/pyproject.toml b/src/py/pyproject.toml
index 01297b1e..5d3e39d4 100644
--- a/src/py/pyproject.toml
+++ b/src/py/pyproject.toml
@@ -104,7 +104,7 @@ log_cli = false
 # name = cmd
 
 [tool.poe.tasks.test]
-cmd = "pytest --timeout=90 --log-level=1 -W error -n auto -v -rfE --capture=fd"
+cmd = "pytest --timeout=20 --log-level=1 -W error -n auto -v -rfE --capture=fd"
 help = "Run all tests quickly"
 
 [tool.poe.tasks.debug-test]
diff --git a/src/py/tests/test_kaleido.py b/src/py/tests/test_kaleido.py
index d31e47bd..f5d1f143 100644
--- a/src/py/tests/test_kaleido.py
+++ b/src/py/tests/test_kaleido.py
@@ -436,7 +436,7 @@ async def test_unreasonable_timeout(simple_figure_with_bytes):
     opts = simple_figure_with_bytes["opts"]
 
     # Use an infinitely small timeout
-    async with Kaleido(timeout=0.0001) as k:
+    async with Kaleido(timeout=0.005) as k:
         with pytest.raises((asyncio.TimeoutError, TimeoutError)):
             await k.calc_fig(fig, opts=opts)
 

From 31c210fd45a72b919bb61c0131a470c32bf894ce Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Mon, 22 Sep 2025 21:14:03 -0500
Subject: [PATCH 134/167] Simplify error handlinging in tab

---
 src/py/kaleido/__init__.py                    |  4 +--
 .../kaleido/_kaleido_tab/_devtools_utils.py   | 34 ++++++++-----------
 src/py/kaleido/_kaleido_tab/_tab.py           | 19 ++---------
 3 files changed, 20 insertions(+), 37 deletions(-)

diff --git a/src/py/kaleido/__init__.py b/src/py/kaleido/__init__.py
index 0e24c861..752abd72 100644
--- a/src/py/kaleido/__init__.py
+++ b/src/py/kaleido/__init__.py
@@ -115,7 +115,7 @@ async def write_fig(
     *,
     topojson: str | None = None,
     kopts: dict[str, Any] | None = None,
-    **kwargs,  # TODO(AJP): what might we pass here?
+    **kwargs,
 ):
     """
     Write a plotly figure(s) to a file.
@@ -142,7 +142,7 @@ async def write_fig_from_object(
     fig_dicts: FigureDict | AnyIterable[FigureDict],
     *,
     kopts: dict[str, Any] | None = None,
-    **kwargs,  # TODO(AJP): what might we pass here?
+    **kwargs,
 ):
     """
     Write a plotly figure(s) to a file specified by a dictionary or iterable of.
diff --git a/src/py/kaleido/_kaleido_tab/_devtools_utils.py b/src/py/kaleido/_kaleido_tab/_devtools_utils.py
index a43b9bfd..813c98f3 100644
--- a/src/py/kaleido/_kaleido_tab/_devtools_utils.py
+++ b/src/py/kaleido/_kaleido_tab/_devtools_utils.py
@@ -7,7 +7,7 @@
 
 import logistro
 
-from ._errors import JavascriptError, KaleidoError, _get_error, _raise_error
+from ._errors import KaleidoError, _raise_error
 
 if TYPE_CHECKING:
     from typing import Any
@@ -75,11 +75,8 @@ async def exec_js_fn(
 
 def check_kaleido_js_response(
     response,
-) -> tuple[
-    dict,
-    Exception | None,
-]:
-    # TODO(AJP) provoke a js error and return js error
+) -> dict:
+    _raise_error(response)
     js_response = json.loads(
         response.get(
             "result",
@@ -93,23 +90,24 @@ def check_kaleido_js_response(
             "value",
         ),
     )
-    if not js_response:  # not loved, neither {}
-        return {}, RuntimeError(
-            f"JS Response not understood: {response}",
+    if not js_response:
+        raise RuntimeError(
+            f"Javascript response not understood: {response}",
         )
+    # NOTE: Why above "JavascriptError"
+    # This is an error in extracting a response when we expected javascript.
+    # If its an actual javascript error, the response will be coherent, and
+    # _raise_error above will find it.
 
     if js_response["code"] != 0:
-        return {}, KaleidoError(js_response["code"], js_response["message"])
+        raise KaleidoError(js_response["code"], js_response["message"])
 
-    return js_response, None
+    return js_response
 
 
 async def print_pdf(
     tab: choreographer.Tab,
-) -> tuple[
-    str,
-    Exception | None,
-]:
+) -> str:
     pdf_params = {
         "printBackground": True,
         "marginTop": 0.1,
@@ -123,7 +121,5 @@ async def print_pdf(
         "Page.printToPDF",
         params=pdf_params,
     )
-    e = _get_error(pdf_response)
-    if e:
-        return "", e
-    return pdf_response.get("result", {}).get("data"), None
+    _raise_error(pdf_response)
+    return pdf_response.get("result", {}).get("data")  # Check for None?
diff --git a/src/py/kaleido/_kaleido_tab/_tab.py b/src/py/kaleido/_kaleido_tab/_tab.py
index e12d4173..8ec3304e 100644
--- a/src/py/kaleido/_kaleido_tab/_tab.py
+++ b/src/py/kaleido/_kaleido_tab/_tab.py
@@ -138,26 +138,13 @@ async def _calc_fig(
         )
         _raise_error(result)
 
-        # TODO(AJP): better define these error mechanics, is this a devtools
-        # function or what
-        # upon implementation of error, might not be necessary
-        # to do these go-lang/c style returns
-        # but we have to collect and associate
-        # with the gather + profile
-        # None-non return values are a problem
-        # In general, need to better understand stuff here
-
         _logger.debug2(f"Result of function call: {result}")
-        js_response, error = _dtools.check_kaleido_js_response(result)
-        if error:
-            raise error
+        js_response = _dtools.check_kaleido_js_response(result)
 
         if (response_format := js_response.get("format")) == "pdf":
-            img_raw, error = await _dtools.print_pdf(self.tab)
+            img_raw = await _dtools.print_pdf(self.tab)
         else:
-            img_raw = js_response.get("result")  # type: ignore[assignment]
-        if error:
-            raise error
+            img_raw = js_response["result"]
 
         if response_format not in _TEXT_FORMATS:
             return base64.b64decode(img_raw)

From fb100a63b7f1200709b6a025852a0c749d138d40 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Tue, 23 Sep 2025 12:14:10 -0500
Subject: [PATCH 135/167] Make stepper a write_fig argument, not kaleido()

---
 src/py/kaleido/_kaleido_tab/_tab.py | 10 +++-----
 src/py/kaleido/kaleido.py           | 39 ++++++++++++++---------------
 2 files changed, 22 insertions(+), 27 deletions(-)

diff --git a/src/py/kaleido/_kaleido_tab/_tab.py b/src/py/kaleido/_kaleido_tab/_tab.py
index 8ec3304e..a12acd21 100644
--- a/src/py/kaleido/_kaleido_tab/_tab.py
+++ b/src/py/kaleido/_kaleido_tab/_tab.py
@@ -44,7 +44,7 @@ class _KaleidoTab:
     js_logger: _js_logger.JavascriptLogger
     """A log for recording javascript."""
 
-    def __init__(self, tab, *, _stepper=False):
+    def __init__(self, tab):
         """
         Create a new _KaleidoTab.
 
@@ -54,7 +54,6 @@ def __init__(self, tab, *, _stepper=False):
         """
         self.tab = tab
         self.js_logger = _js_logger.JavascriptLogger(self.tab)
-        self._stepper = _stepper
 
     async def navigate(self, url: str | Path = ""):
         """
@@ -115,11 +114,8 @@ async def _calc_fig(
         spec: _fig_tools.Spec,
         *,
         topojson: str | None = None,
-        **_kwargs,
+        stepper=False,
     ) -> bytes:
-        _kwargs.pop("error_log", None)  # not used at the moment
-        _kwargs.pop("profiler", None)  # not used at the moment
-
         # js script
         kaleido_js_fn = (
             r"function(spec, ...args)"
@@ -134,7 +130,7 @@ async def _calc_fig(
             kaleido_js_fn,
             spec,
             topojson,
-            self._stepper,
+            stepper,
         )
         _raise_error(result)
 
diff --git a/src/py/kaleido/kaleido.py b/src/py/kaleido/kaleido.py
index 6249dd64..2265d90c 100644
--- a/src/py/kaleido/kaleido.py
+++ b/src/py/kaleido/kaleido.py
@@ -101,15 +101,14 @@ class Kaleido(choreo.Browser):
 
     ### KALEIDO LIFECYCLE FUNCTIONS ###
 
-    def __init__(  # noqa: PLR0913
+    def __init__(
         self,
-        *args: Any,  # TODO(AJP): does choreographer take args?
+        # *args: Any, force named vars for all choreographer passthrough
         n: int = 1,
         timeout: int | None = 90,
         page_generator: None | PageGenerator | str | Path = None,
         plotlyjs: str | Path | None = None,  # TODO(AJP): with page generator
         mathjax: str | Path | None = None,  # TODO(AJP): with page generator?
-        stepper: bool = False,
         **kwargs: Any,
     ) -> None:
         """
@@ -142,17 +141,12 @@ def __init__(  # noqa: PLR0913
                 disabled. Defaults to None- which means to use version 2.35 via
                 CDN.
 
-            stepper (bool, optional):
-                A diagnostic tool that will ask the user to press enter between
-                rendering each image. Only useful if also used with
-                `headless=False`. See below. Defaults to False.
-
             **kwargs (Any):
                 Additional keyword arguments passed through to the underlying
-                Choreographer.browser constructor. Notable options include,
+                Choreographer.browser constructor. Notable options include
                 `headless=False` (show window), `enable_sandbox=True` (turn on
                 sandboxing), and `enable_gpu=True` which will allow use of the
-                GPU. The defaults for these options are True, False, False
+                GPU. The defaults for these options are True, False, and False
                 respectively.
 
         """
@@ -166,7 +160,6 @@ def __init__(  # noqa: PLR0913
         page = page_generator
         self._timeout = timeout
         self._n = n
-        self._stepper = stepper
         self._plotlyjs = plotlyjs
         self._mathjax = mathjax
 
@@ -174,14 +167,14 @@ def __init__(  # noqa: PLR0913
         _logger.debug(f"Timeout: {self._timeout}")
 
         try:
-            super().__init__(*args, **kwargs)
+            super().__init__(**kwargs)
         except ChromeNotFoundError:
             raise ChromeNotFoundError(
                 "Kaleido v1 and later requires Chrome to be installed. "
                 "To install Chrome, use the CLI command `kaleido_get_chrome`, "
                 "or from Python, use either `await kaleido.get_chrome()` "
                 "or `kaleido.get_chrome_sync()`.",
-            ) from None  # overwriting the error entirely.
+            ) from None  # overwriting the error entirely. (diagnostics)
 
         # save this for open() because it requires close()
         self._saved_page_arg = page
@@ -226,8 +219,7 @@ async def _conform_tabs(self, tabs: Listish[choreo.Tab] | None = None) -> None:
             _logger.debug2(f"Subscribing * to tab: {tab}.")
             tab.subscribe("*", _utils.event_printer(f"tab-{i!s}: Event Dump:"))
 
-        kaleido_tabs = [_KaleidoTab(tab, _stepper=self._stepper) for tab in tabs]
-        # TODO(AJP): why doesn't stepper use the global?
+        kaleido_tabs = [_KaleidoTab(tab) for tab in tabs]
 
         await asyncio.gather(*(tab.navigate(self._index) for tab in kaleido_tabs))
 
@@ -308,10 +300,7 @@ async def _return_kaleido_tab(self, tab: _KaleidoTab) -> None:
         await self.tabs_ready.put(tab)
         _logger.debug(f"{tab.tab.target_id[:4]} put back.")
 
-    #### WE'RE HERE
-
-    # this task must calculate full_path before it
-    # awaits, ie yielding control.
+    # _retuner_task MUST calculate full_path before it awaits
     async def _render_task(
         self,
         fig_arg: FigureDict,
@@ -363,6 +352,7 @@ async def write_fig_from_object(
         *,
         cancel_on_error: bool = False,
         _write: Literal[False],
+        stepper: bool = False,
     ) -> bytes: ...
 
     @overload
@@ -372,6 +362,7 @@ async def write_fig_from_object(
         *,
         cancel_on_error: Literal[True],
         _write: Literal[True] = True,
+        stepper: bool = False,
     ) -> None: ...
 
     @overload
@@ -381,6 +372,7 @@ async def write_fig_from_object(
         *,
         cancel_on_error: Literal[False] = False,
         _write: Literal[True] = True,
+        stepper: bool = False,
     ) -> tuple[Exception]: ...
 
     @overload
@@ -390,6 +382,7 @@ async def write_fig_from_object(
         *,
         cancel_on_error: bool,
         _write: Literal[True] = True,
+        stepper: bool = False,
     ) -> tuple[Exception] | None: ...
 
     async def write_fig_from_object(
@@ -398,6 +391,7 @@ async def write_fig_from_object(
         *,
         cancel_on_error=False,
         _write: bool = True,  # backwards compatibility!
+        stepper: bool = False,
     ) -> None | bytes | tuple[Exception]:
         """Temp."""
         if not _write:
@@ -418,6 +412,7 @@ async def write_fig_from_object(
                         fig_arg=fig_arg,
                         topojson=fig_arg.get("topojson"),
                         _write=_write,  # backwards compatibility
+                        stepper=stepper,
                     ),
                 )
                 tasks.add(t)
@@ -438,7 +433,7 @@ async def write_fig_from_object(
             if main_task:
                 self._main_render_coroutines.remove(main_task)
 
-    async def write_fig(
+    async def write_fig(  # noqa: PLR0913
         self,
         fig: _fig_tools.Figurish,
         path: None | Path | str = None,
@@ -446,6 +441,7 @@ async def write_fig(
         *,
         topojson: str | None = None,
         cancel_on_error: bool = False,
+        stepper: bool = False,
     ) -> tuple[Exception] | None:
         """Temp."""
         if _fig_tools.is_figurish(fig) or not isinstance(
@@ -467,6 +463,7 @@ async def _temp_generator() -> AsyncGenerator[FigureDict, None]:
         return await self.write_fig_from_object(
             fig_dicts=generator,
             cancel_on_error=cancel_on_error,
+            stepper=stepper,
         )
 
     async def calc_fig(
@@ -475,6 +472,7 @@ async def calc_fig(
         opts: None | _fig_tools.LayoutOpts = None,
         *,
         topojson: str | None = None,
+        stepper: bool = False,
     ) -> bytes:
         """Temp."""
 
@@ -489,4 +487,5 @@ async def _temp_generator():
             fig_dicts=_temp_generator(),
             cancel_on_error=True,
             _write=False,
+            stepper=stepper,
         )

From 33fb0465a93a4520ecf47c93c2425dd6f388f80d Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Tue, 23 Sep 2025 20:29:12 -0500
Subject: [PATCH 136/167] Readd profiler.

---
 src/py/kaleido/_kaleido_tab/_tab.py | 18 +++++---
 src/py/kaleido/_profiler.py         | 68 +++++++++++++++++++++++++++++
 src/py/kaleido/kaleido.py           | 33 ++++++++++++--
 3 files changed, 110 insertions(+), 9 deletions(-)
 create mode 100644 src/py/kaleido/_profiler.py

diff --git a/src/py/kaleido/_kaleido_tab/_tab.py b/src/py/kaleido/_kaleido_tab/_tab.py
index a12acd21..3c761f06 100644
--- a/src/py/kaleido/_kaleido_tab/_tab.py
+++ b/src/py/kaleido/_kaleido_tab/_tab.py
@@ -113,8 +113,9 @@ async def _calc_fig(
         self,
         spec: _fig_tools.Spec,
         *,
-        topojson: str | None = None,
-        stepper=False,
+        topojson: str | None,
+        render_prof,
+        stepper,
     ) -> bytes:
         # js script
         kaleido_js_fn = (
@@ -123,7 +124,7 @@ async def _calc_fig(
             r"return kaleido_scopes.plotly(spec, ...args).then(JSON.stringify);"
             r"}"
         )
-
+        render_prof.profile_log.tick("sending javascript")
         result = await _dtools.exec_js_fn(
             self.tab,
             self._current_js_id,
@@ -133,16 +134,23 @@ async def _calc_fig(
             stepper,
         )
         _raise_error(result)
+        render_prof.profile_log.tick("javascript sent")
 
         _logger.debug2(f"Result of function call: {result}")
         js_response = _dtools.check_kaleido_js_response(result)
 
         if (response_format := js_response.get("format")) == "pdf":
+            render_prof.profile_log.tick("printing pdf")
             img_raw = await _dtools.print_pdf(self.tab)
+            render_prof.profile_log.tick("pdf printed")
         else:
             img_raw = js_response["result"]
 
         if response_format not in _TEXT_FORMATS:
-            return base64.b64decode(img_raw)
+            res = base64.b64decode(img_raw)
         else:
-            return str.encode(img_raw)
+            res = str.encode(img_raw)
+
+        render_prof.data_out_size = len(res)
+        render_prof.js_log = self.js_logger.log
+        return res
diff --git a/src/py/kaleido/_profiler.py b/src/py/kaleido/_profiler.py
new file mode 100644
index 00000000..7d9fcebf
--- /dev/null
+++ b/src/py/kaleido/_profiler.py
@@ -0,0 +1,68 @@
+from __future__ import annotations
+
+import time
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from pathlib import Path
+    from typing import Any
+
+    from . import _fig_tools
+
+    Event = str
+
+
+class WriteCall:
+    name: str
+    renders: list[RenderTaskProfile]
+
+    __slots__ = tuple(__annotations__)
+
+    def __init__(self, name: str):
+        self.name = name
+        self.renders = []
+
+
+class RenderTaskProfile:
+    info: dict[str, Any]  # literal?
+    error: None | BaseException
+    js_log: list[str]
+    profile_log: ProfileLog
+    data_in_size: int | None
+    data_out_size: int | None
+
+    __slots__ = tuple(__annotations__)
+
+    def __init__(
+        self,
+        spec: _fig_tools.Spec,
+        full_path: Path | None,
+        tab_id: str,
+    ) -> None:
+        self.info = {}
+        self.error = None
+        self.js_log = []
+        self.profile_log = ProfileLog()
+        self.data_in_size = None  # need to get this from choreographer
+        self.data_out_size = None
+
+        self.info.update(
+            {k: v for k, v in spec.items() if k != "data"},
+        )
+        self.info["path"] = full_path
+        self.info["tab"] = tab_id
+
+
+class ProfileLog:
+    _logs: dict[Event, float]
+
+    __slots__ = tuple(__annotations__)
+
+    def __init__(self) -> None:
+        self._logs = {}
+
+    def tick(self, name: str) -> None:
+        self._logs[name] = time.perf_counter()
+
+    def get_logs(self) -> dict[Event, float]:
+        return self._logs
diff --git a/src/py/kaleido/kaleido.py b/src/py/kaleido/kaleido.py
index 2265d90c..c3764f4e 100644
--- a/src/py/kaleido/kaleido.py
+++ b/src/py/kaleido/kaleido.py
@@ -3,6 +3,7 @@
 from __future__ import annotations
 
 import asyncio
+from collections import deque
 from collections.abc import AsyncIterable, Iterable
 from pathlib import Path
 from typing import TYPE_CHECKING, TypedDict, cast, overload
@@ -12,7 +13,7 @@
 from choreographer.errors import ChromeNotFoundError
 from choreographer.utils import TmpDirectory
 
-from . import _fig_tools, _path_tools, _utils
+from . import _fig_tools, _path_tools, _profiler, _utils
 from ._kaleido_tab import _KaleidoTab
 from ._page_generator import PageGenerator
 
@@ -155,6 +156,7 @@ def __init__(
         self.tabs_ready = asyncio.Queue(maxsize=0)
         self._total_tabs = 0  # tabs properly registered
         self._html_tmp_dir = None
+        self._task_profiler: deque[_profiler.WriteCall] = deque(maxlen=5)
 
         # Kaleido Config
         page = page_generator
@@ -305,8 +307,10 @@ async def _render_task(
         self,
         fig_arg: FigureDict,
         *,
+        topojson: str | None,
         _write: bool,
-        **kwargs: Any,
+        profiler: _profiler.WriteCall,
+        stepper: bool,
     ) -> None | bytes:
         spec = _fig_tools.coerce_for_js(
             fig_arg.get("fig"),
@@ -324,25 +328,40 @@ async def _render_task(
 
         tab = await self._get_kaleido_tab()
 
+        render_prof = _profiler.RenderTaskProfile(
+            spec,
+            full_path if _write else None,
+            tab.tab.target_id,
+        )
+        profiler.renders.append(render_prof)
+
         try:
             img_bytes = await asyncio.wait_for(
                 tab._calc_fig(  # noqa: SLF001
                     spec,
-                    **kwargs,
+                    topojson=topojson,
+                    render_prof=render_prof,
+                    stepper=stepper,
                 ),
                 self._timeout,
             )
             if _write:
+                render_prof.profile_log.tick("starting file write")
                 await _utils.to_thread(full_path.write_bytes, img_bytes)
+                render_prof.profile_log.tick("file write done")
                 return None
             else:
                 return img_bytes
-        except:
+        except BaseException as e:
+            render_prof.profile_log.tick("errored out")
             if _write:
                 full_path.unlink()  # failure, no write
+            render_prof.error = e
             raise
         finally:
+            render_prof.profile_log.tick("returning tab")
             await self._return_kaleido_tab(tab)
+            render_prof.profile_log.tick("tab returned")
 
     ### API ###
     @overload
@@ -400,8 +419,13 @@ async def write_fig_from_object(
         if _is_figuredict(fig_dicts):
             fig_dicts = [fig_dicts]
 
+        name = "No Name"
         if main_task := asyncio.current_task():
             self._main_render_coroutines.add(main_task)
+            name = main_task.get_name()
+
+        profiler = _profiler.WriteCall(name)
+        self._task_profiler.append(profiler)
 
         tasks: set[asyncio.Task] = set()
 
@@ -412,6 +436,7 @@ async def write_fig_from_object(
                         fig_arg=fig_arg,
                         topojson=fig_arg.get("topojson"),
                         _write=_write,  # backwards compatibility
+                        profiler=profiler,
                         stepper=stepper,
                     ),
                 )

From 250b15e759a8a1d36d3cf0cd447bfe9837d1afdd Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Wed, 24 Sep 2025 11:07:54 -0500
Subject: [PATCH 137/167] Update gitignore.

---
 .gitignore | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.gitignore b/.gitignore
index 068efd7f..31e47007 100644
--- a/.gitignore
+++ b/.gitignore
@@ -25,3 +25,4 @@ src/py/integration_tests/report*
 node_modules/
 
 src/py/site/*
+.hypothesis/

From dfc9930030ec6d2e269dcd5d16dc9285192b45ca Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Wed, 24 Sep 2025 11:09:10 -0500
Subject: [PATCH 138/167] Organize utilities- 50%

---
 .../kaleido/{_utils.py => _utils/__init__.py} | 20 -------------------
 .../{_fig_tools.py => _utils/fig_tools.py}    |  0
 .../{_path_tools.py => _utils/path_tools.py}  | 19 ++++++++++++++++++
 3 files changed, 19 insertions(+), 20 deletions(-)
 rename src/py/kaleido/{_utils.py => _utils/__init__.py} (87%)
 rename src/py/kaleido/{_fig_tools.py => _utils/fig_tools.py} (100%)
 rename src/py/kaleido/{_path_tools.py => _utils/path_tools.py} (79%)

diff --git a/src/py/kaleido/_utils.py b/src/py/kaleido/_utils/__init__.py
similarity index 87%
rename from src/py/kaleido/_utils.py
rename to src/py/kaleido/_utils/__init__.py
index 6d9923a0..c03c45c6 100644
--- a/src/py/kaleido/_utils.py
+++ b/src/py/kaleido/_utils/__init__.py
@@ -4,10 +4,7 @@
 import warnings
 from functools import partial
 from importlib.metadata import PackageNotFoundError, version
-from pathlib import Path
 from typing import TYPE_CHECKING
-from urllib.parse import urlparse
-from urllib.request import url2pathname
 
 import logistro
 from packaging.version import Version
@@ -105,20 +102,3 @@ def warn_incompatible_plotly():
         # Since this compatibility check is just a convenience,
         # we don't want to block the whole library if there's an issue
         _logger.info("Error while checking Plotly version.", exc_info=e)
-
-
-def get_path(p: str | Path) -> Path:
-    if isinstance(p, Path):
-        return p
-    elif not isinstance(p, str):
-        raise TypeError("Path should be a string or `pathlib.Path` object.")
-
-    parsed = urlparse(str(p))
-
-    return Path(
-        url2pathname(parsed.path) if parsed.scheme.startswith("file") else p,
-    )
-
-
-def is_httpish(p: str) -> bool:
-    return urlparse(str(p)).scheme.startswith("http")
diff --git a/src/py/kaleido/_fig_tools.py b/src/py/kaleido/_utils/fig_tools.py
similarity index 100%
rename from src/py/kaleido/_fig_tools.py
rename to src/py/kaleido/_utils/fig_tools.py
diff --git a/src/py/kaleido/_path_tools.py b/src/py/kaleido/_utils/path_tools.py
similarity index 79%
rename from src/py/kaleido/_path_tools.py
rename to src/py/kaleido/_utils/path_tools.py
index c738fcdf..6861492c 100644
--- a/src/py/kaleido/_path_tools.py
+++ b/src/py/kaleido/_utils/path_tools.py
@@ -4,6 +4,8 @@
 import re
 from pathlib import Path
 from typing import TYPE_CHECKING
+from urllib.parse import urlparse
+from urllib.request import url2pathname
 
 import logistro
 
@@ -56,3 +58,20 @@ def determine_path(
                 f"Cannot reach path {path.parent}. Are all directories created?",
             )
     return full_path
+
+
+def get_path(p: str | Path) -> Path:
+    if isinstance(p, Path):
+        return p
+    elif not isinstance(p, str):
+        raise TypeError("Path should be a string or `pathlib.Path` object.")
+
+    parsed = urlparse(str(p))
+
+    return Path(
+        url2pathname(parsed.path) if parsed.scheme.startswith("file") else p,
+    )
+
+
+def is_httpish(p: str) -> bool:
+    return urlparse(str(p)).scheme.startswith("http")

From 8e1d783aa9478adc7fc3d940515d3e847e7aee45 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Wed, 24 Sep 2025 11:18:30 -0500
Subject: [PATCH 139/167] Finish refactor.

---
 src/py/kaleido/__init__.py          |  2 +-
 src/py/kaleido/_kaleido_tab/_tab.py |  4 ++--
 src/py/kaleido/_mocker.py           |  3 +--
 src/py/kaleido/_page_generator.py   |  6 +++---
 src/py/kaleido/_profiler.py         |  4 ++--
 src/py/kaleido/_utils/path_tools.py |  4 ++--
 src/py/kaleido/kaleido.py           | 21 +++++++++++----------
 7 files changed, 22 insertions(+), 22 deletions(-)

diff --git a/src/py/kaleido/__init__.py b/src/py/kaleido/__init__.py
index 752abd72..900e40b9 100644
--- a/src/py/kaleido/__init__.py
+++ b/src/py/kaleido/__init__.py
@@ -19,7 +19,7 @@
     from pathlib import Path
     from typing import Any, TypeVar, Union
 
-    from ._fig_tools import Figurish, LayoutOpts
+    from ._utils.fig_tools import Figurish, LayoutOpts
 
     T = TypeVar("T")
     AnyIterable = Union[AsyncIterable[T], Iterable[T]]
diff --git a/src/py/kaleido/_kaleido_tab/_tab.py b/src/py/kaleido/_kaleido_tab/_tab.py
index 3c761f06..2c1da8df 100644
--- a/src/py/kaleido/_kaleido_tab/_tab.py
+++ b/src/py/kaleido/_kaleido_tab/_tab.py
@@ -15,7 +15,7 @@
 
     import choreographer as choreo
 
-    from kaleido import _fig_tools
+    from kaleido._utils import fig_tools
 
 
 _TEXT_FORMATS = ("svg", "json")  # eps
@@ -111,7 +111,7 @@ async def reload(self):
 
     async def _calc_fig(
         self,
-        spec: _fig_tools.Spec,
+        spec: fig_tools.Spec,
         *,
         topojson: str | None,
         render_prof,
diff --git a/src/py/kaleido/_mocker.py b/src/py/kaleido/_mocker.py
index 6c9fe419..1597b013 100644
--- a/src/py/kaleido/_mocker.py
+++ b/src/py/kaleido/_mocker.py
@@ -88,8 +88,7 @@ def _load_figures_from_paths(paths: list[Path]):
                                     params.append(
                                         {
                                             "name": (
-                                                f"{path.stem!s}-{w!s}"
-                                                f"x{h!s}X{s!s}.{f!s}"
+                                                f"{path.stem!s}-{w!s}x{h!s}X{s!s}.{f!s}"
                                             ),
                                             "opts": {
                                                 "scale": s,
diff --git a/src/py/kaleido/_page_generator.py b/src/py/kaleido/_page_generator.py
index 2d0fc641..f99ad5a4 100644
--- a/src/py/kaleido/_page_generator.py
+++ b/src/py/kaleido/_page_generator.py
@@ -5,7 +5,7 @@
 
 import logistro
 
-from . import _utils
+from ._utils import path_tools
 
 if TYPE_CHECKING:
     from typing import Tuple, Union
@@ -34,9 +34,9 @@ def _ensure_file(path: Path | str | UrlAndCharset) -> None:
             return
         else:
             pass  # FileNotFound
-    elif _utils.is_httpish(path):  # noqa: SIM114 clarity
+    elif path_tools.is_httpish(path):  # noqa: SIM114 clarity
         return
-    elif _utils.get_path(path).is_file():
+    elif path_tools.get_path(path).is_file():
         return
     raise FileNotFoundError(f"{path!s} does not exist.")
 
diff --git a/src/py/kaleido/_profiler.py b/src/py/kaleido/_profiler.py
index 7d9fcebf..6ae29231 100644
--- a/src/py/kaleido/_profiler.py
+++ b/src/py/kaleido/_profiler.py
@@ -7,7 +7,7 @@
     from pathlib import Path
     from typing import Any
 
-    from . import _fig_tools
+    from ._utils import fig_tools
 
     Event = str
 
@@ -35,7 +35,7 @@ class RenderTaskProfile:
 
     def __init__(
         self,
-        spec: _fig_tools.Spec,
+        spec: fig_tools.Spec,
         full_path: Path | None,
         tab_id: str,
     ) -> None:
diff --git a/src/py/kaleido/_utils/path_tools.py b/src/py/kaleido/_utils/path_tools.py
index 6861492c..fae5cf19 100644
--- a/src/py/kaleido/_utils/path_tools.py
+++ b/src/py/kaleido/_utils/path_tools.py
@@ -10,7 +10,7 @@
 import logistro
 
 if TYPE_CHECKING:
-    from . import _fig_tools
+    from . import fig_tools
 
 _logger = logistro.getLogger(__name__)
 
@@ -35,7 +35,7 @@ def _next_filename(path: Path | str, prefix: str, ext: str) -> str:
 def determine_path(
     path: Path | str | None,
     fig: dict,
-    ext: _fig_tools.FormatString,
+    ext: fig_tools.FormatString,
 ) -> Path:
     path = Path(path) if path else Path()
 
diff --git a/src/py/kaleido/kaleido.py b/src/py/kaleido/kaleido.py
index c3764f4e..4b14d717 100644
--- a/src/py/kaleido/kaleido.py
+++ b/src/py/kaleido/kaleido.py
@@ -13,9 +13,10 @@
 from choreographer.errors import ChromeNotFoundError
 from choreographer.utils import TmpDirectory
 
-from . import _fig_tools, _path_tools, _profiler, _utils
+from . import _profiler, _utils
 from ._kaleido_tab import _KaleidoTab
 from ._page_generator import PageGenerator
+from ._utils import fig_tools, path_tools
 
 if TYPE_CHECKING:
     from types import TracebackType
@@ -42,9 +43,9 @@
     class FigureDict(TypedDict):
         """The type a fig_dicts returns for `write_fig_from_object`."""
 
-        fig: Required[_fig_tools.Figurish]
+        fig: Required[fig_tools.Figurish]
         path: NotRequired[None | str | Path]
-        opts: NotRequired[_fig_tools.LayoutOpts | None]
+        opts: NotRequired[fig_tools.LayoutOpts | None]
         topojson: NotRequired[None | str]
 
 
@@ -312,14 +313,14 @@ async def _render_task(
         profiler: _profiler.WriteCall,
         stepper: bool,
     ) -> None | bytes:
-        spec = _fig_tools.coerce_for_js(
+        spec = fig_tools.coerce_for_js(
             fig_arg.get("fig"),
             fig_arg.get("path", None),
             fig_arg.get("opts", None),
         )
 
         if _write:
-            full_path = _path_tools.determine_path(
+            full_path = path_tools.determine_path(
                 fig_arg.get("path", None),
                 spec["data"],
                 spec["format"],  # should just take spec
@@ -460,16 +461,16 @@ async def write_fig_from_object(
 
     async def write_fig(  # noqa: PLR0913
         self,
-        fig: _fig_tools.Figurish,
+        fig: fig_tools.Figurish,
         path: None | Path | str = None,
-        opts: None | _fig_tools.LayoutOpts = None,
+        opts: None | fig_tools.LayoutOpts = None,
         *,
         topojson: str | None = None,
         cancel_on_error: bool = False,
         stepper: bool = False,
     ) -> tuple[Exception] | None:
         """Temp."""
-        if _fig_tools.is_figurish(fig) or not isinstance(
+        if fig_tools.is_figurish(fig) or not isinstance(
             fig,
             (Iterable, AsyncIterable),
         ):
@@ -493,8 +494,8 @@ async def _temp_generator() -> AsyncGenerator[FigureDict, None]:
 
     async def calc_fig(
         self,
-        fig: _fig_tools.Figurish,
-        opts: None | _fig_tools.LayoutOpts = None,
+        fig: fig_tools.Figurish,
+        opts: None | fig_tools.LayoutOpts = None,
         *,
         topojson: str | None = None,
         stepper: bool = False,

From 015d72190b09585477a2e0417d04f2761c1b9a36 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Wed, 24 Sep 2025 15:30:55 -0500
Subject: [PATCH 140/167] Factor mocker into several files.

---
 src/py/kaleido/_mocker.py          | 300 -----------------------------
 src/py/kaleido/_utils/fig_tools.py |   4 +-
 src/py/kaleido/mocker/__init__.py  |  62 ++++++
 src/py/kaleido/mocker/_args.py     | 169 ++++++++++++++++
 src/py/kaleido/mocker/_defaults.py |  31 +++
 src/py/kaleido/mocker/_utils.py    |  66 +++++++
 src/py/pyproject.toml              |   2 +-
 7 files changed, 331 insertions(+), 303 deletions(-)
 delete mode 100644 src/py/kaleido/_mocker.py
 create mode 100644 src/py/kaleido/mocker/__init__.py
 create mode 100644 src/py/kaleido/mocker/_args.py
 create mode 100644 src/py/kaleido/mocker/_defaults.py
 create mode 100644 src/py/kaleido/mocker/_utils.py

diff --git a/src/py/kaleido/_mocker.py b/src/py/kaleido/_mocker.py
deleted file mode 100644
index 1597b013..00000000
--- a/src/py/kaleido/_mocker.py
+++ /dev/null
@@ -1,300 +0,0 @@
-from __future__ import annotations
-
-import argparse
-import asyncio
-import multiprocessing
-import sys
-import time
-import warnings
-from pathlib import Path
-from pprint import pp
-from random import sample
-from typing import TypedDict
-
-import logistro
-import orjson
-
-import kaleido
-
-_logger = logistro.getLogger(__name__)
-
-cpus = multiprocessing.cpu_count()
-
-# Extract jsons of mocks
-test_dir = Path(__file__).resolve().parent.parent / "integration_tests"
-in_dir = test_dir / "mocks"
-out_dir = test_dir / "renders"
-
-
-def _get_jsons_in_paths(path: str | Path) -> list[Path]:
-    # Work with Paths and directories
-    path = Path(path) if isinstance(path, str) else path
-
-    if path.is_dir():
-        _logger.info(f"Input is path {path}")
-        return list(path.glob("*.json"))
-    elif path.is_file():
-        _logger.info(f"Input is file {path}")
-        return [path]
-    else:
-        raise TypeError("--input must be file or directory")
-
-
-class Param(TypedDict):
-    name: str
-    opts: dict[str, int | float]
-
-
-def _load_figures_from_paths(paths: list[Path]):
-    # Set json
-    params: list[Param]
-    for path in paths:
-        if path.is_file():
-            with path.open(encoding="utf-8") as file:
-                figure = orjson.loads(file.read())
-                _logger.info(f"Yielding {path.stem}")
-                if args.parameterize_opts is False:
-                    params = [
-                        {
-                            "name": f"{path.stem}.{args.format or 'png'}",
-                            "opts": {
-                                "scale": args.scale,
-                                "width": args.width,
-                                "height": args.height,
-                            },
-                        },
-                    ]
-                else:
-                    widths = [args.width] if args.width else [200, 700, 1000]
-                    heights = [args.height] if args.height else [200, 500, 1000]
-                    scales = [args.scale] if args.scale else [0.5, 1, 2]
-                    formats = (
-                        [args.format]
-                        if args.format
-                        else [
-                            "png",
-                            "pdf",
-                            "jpg",
-                            "webp",
-                            "svg",
-                            "json",
-                        ]
-                    )
-                    params = []
-                    for w in widths:
-                        for h in heights:
-                            for s in scales:
-                                for f in formats:
-                                    params.append(
-                                        {
-                                            "name": (
-                                                f"{path.stem!s}-{w!s}x{h!s}X{s!s}.{f!s}"
-                                            ),
-                                            "opts": {
-                                                "scale": s,
-                                                "width": w,
-                                                "height": h,
-                                            },
-                                        },
-                                    )
-                for p in params:
-                    yield {
-                        "fig": figure,
-                        "path": str(Path(args.output) / p["name"]),
-                        "opts": p["opts"],
-                    }
-        else:
-            raise RuntimeError(f"Path {path} is not a file.")
-
-
-# Set the arguments
-description = """kaleido_mocker will load up json files of plotly figs and export them.
-
-If you set multiple process, -n, non-headless mode won't function well because
-chrome will actually throttle tabs or windows/visibile- unless that tab/window
-is headless.
-
-The export of the program is a json object containing information about the execution.
-"""
-
-if "--headless" in sys.argv and "--no-headless" in sys.argv:
-    raise ValueError(
-        "Choose either '--headless' or '--no-headless'.",
-    )
-
-parser = argparse.ArgumentParser(
-    add_help=True,
-    parents=[logistro.parser],
-    conflict_handler="resolve",
-    description=description,
-)
-parser.add_argument(
-    "--logistro-level",
-    default="INFO",
-    dest="log",
-    help="Set the logging level (default INFO)",
-)
-parser.add_argument(
-    "--n",
-    type=int,
-    default=cpus,
-    help="Number of tabs, defaults to # of cpus",
-)
-parser.add_argument(
-    "--input",
-    type=str,
-    default=in_dir,
-    help="Directory of mock file/s or single file (default tests/mocks)",
-)
-parser.add_argument(
-    "--output",
-    type=str,
-    default=out_dir,
-    help="DIRECTORY of mock file/s (default tests/renders)",
-)
-parser.add_argument(
-    "--format",
-    type=str,
-    default=None,
-    help="png (default), pdf, jpg, webp, svg, json",
-)
-parser.add_argument(
-    "--width",
-    type=str,
-    default=None,
-    help="width in pixels (default 700)",
-)
-parser.add_argument(
-    "--height",
-    type=str,
-    default=None,
-    help="height in pixels (default 500)",
-)
-parser.add_argument(
-    "--scale",
-    type=str,
-    default=None,
-    help="Scale ratio, acts as multiplier for height/width (default 1)",
-)
-parser.add_argument(
-    "--parameterize_opts",
-    action="store_true",
-    default=False,
-    help="Run mocks w/ different configurations.",
-)
-parser.add_argument(
-    "--timeout",
-    type=int,
-    default=90,
-    help="Set timeout in seconds for any 1 mock (default 60 seconds)",
-)
-parser.add_argument(
-    "--headless",
-    action="store_true",
-    default=True,
-    help="Set headless as True (default)",
-)
-parser.add_argument(
-    "--no-headless",
-    action="store_false",
-    dest="headless",
-    help="Set headless as False",
-)
-parser.add_argument(
-    "--stepper",
-    action="store_true",
-    default=False,
-    dest="stepper",
-    help="Stepper sets n to 1, headless to False, no timeout "
-    "and asks for confirmation before printing.",
-)
-parser.add_argument(
-    "--random",
-    type=int,
-    default=0,
-    help="Will select N random jsons- or if 0 (default), all.",
-)
-parser.add_argument(
-    "--fail-fast",
-    action="store_true",
-    default=False,
-    help="Throw first error encountered and stop execution.",
-)
-
-args = parser.parse_args()
-logistro.getLogger().setLevel(args.log)
-
-if not Path(args.output).is_dir():
-    raise ValueError(f"Specified output must be existing directory. Is {args.output!s}")
-
-
-# Function to process the images
-async def _main(error_log=None, profiler=None):
-    paths = _get_jsons_in_paths(args.input)
-    if args.random:
-        if args.random > len(paths):
-            raise ValueError(
-                f"Input discover {len(paths)} paths, but a sampling of"
-                f"{args.random} was asked for.",
-            )
-        paths = sample(paths, args.random)
-    if args.stepper:
-        _logger.info("Setting stepper.")
-        args.n = 1
-        args.headless = False
-        args.timeout = 0
-        if args.format == "svg":
-            warnings.warn(
-                "Stepper won't render svgs. It's feasible, "
-                "but the adaption is just slightly more involved.",
-                stacklevel=1,
-            )
-            await asyncio.sleep(3)
-        # sets a global in kaleido, gross huh
-
-    async with kaleido.Kaleido(
-        page_generator=kaleido.PageGenerator(force_cdn=True),
-        n=args.n,
-        headless=args.headless,
-        timeout=args.timeout,
-        stepper=args.stepper,
-    ) as k:
-        await k.write_fig_from_object(
-            _load_figures_from_paths(paths),
-            error_log=error_log,
-            profiler=profiler,
-        )
-
-
-def build_mocks():
-    start = time.perf_counter()
-    try:
-        error_log = [] if not args.fail_fast else None
-        profiler = {}
-        asyncio.run(_main(error_log, profiler))
-    finally:
-        # ruff: noqa: PLC0415
-        from operator import itemgetter
-
-        for tab, tab_profile in profiler.items():
-            profiler[tab] = sorted(
-                tab_profile,
-                key=itemgetter("duration"),
-                reverse=True,
-            )
-
-        elapsed = time.perf_counter() - start
-        with_error_log = error_log is not None
-        results = {
-            "error_log": [str(log) for log in error_log] if with_error_log else None,
-            "profiles": profiler,
-            "total_time": f"Time taken: {elapsed:.6f} seconds",
-            "total_errors": len(error_log) if with_error_log else "untracked",
-        }
-        pp(results)
-        if error_log:
-            sys.exit(1)
-
-
-if __name__ == "__main__":
-    build_mocks()
diff --git a/src/py/kaleido/_utils/fig_tools.py b/src/py/kaleido/_utils/fig_tools.py
index 2a828463..71541097 100644
--- a/src/py/kaleido/_utils/fig_tools.py
+++ b/src/py/kaleido/_utils/fig_tools.py
@@ -10,7 +10,7 @@
 
 import logistro
 
-from . import _utils
+from . import path_tools
 
 if TYPE_CHECKING:
     from pathlib import Path
@@ -98,7 +98,7 @@ def coerce_for_js(
     if hasattr(fig, "to_dict"):  # COERCE FIG
         fig = fig.to_dict()
 
-    path = _utils.get_path(path) if path else None
+    path = path_tools.get_path(path) if path else None
 
     opts = opts or {}
 
diff --git a/src/py/kaleido/mocker/__init__.py b/src/py/kaleido/mocker/__init__.py
new file mode 100644
index 00000000..64424301
--- /dev/null
+++ b/src/py/kaleido/mocker/__init__.py
@@ -0,0 +1,62 @@
+"""Mocker is an integration-test utility."""
+
+from __future__ import annotations
+
+import asyncio
+import time
+from random import sample
+from typing import TYPE_CHECKING
+
+import logistro
+
+import kaleido
+
+from . import _utils
+from ._args import args
+
+if TYPE_CHECKING:
+    from pathlib import Path
+
+_logger = logistro.getLogger(__name__)
+
+
+def random_config(paths: list[Path]) -> list[Path]:
+    """Select a portion of possible paths."""
+    if args.random > len(paths):
+        raise ValueError(
+            f"Input discover {len(paths)} paths, but a sampling of"
+            f"{args.random} was asked for.",
+        )
+    paths = sample(paths, args.random)
+
+
+# Function to process the images
+async def _main():
+    paths = _utils.get_jsons_in_paths(args.input)
+    if args.random:
+        paths = random_config(paths)
+
+    async with kaleido.Kaleido(
+        page_generator=kaleido.PageGenerator(force_cdn=True),
+        n=args.n,
+        headless=args.headless,
+        timeout=args.timeout,
+    ) as k:
+        await k.write_fig_from_object(
+            _utils.load_figures_from_paths(paths),
+            stepper=args.stepper,
+            cancel_on_error=args.fail_fast,
+        )
+
+
+def main():
+    """[project.scripts] expects to call a function, not a module."""
+    start = time.perf_counter()
+    try:
+        asyncio.run(_main())
+    finally:
+        elapsed = time.perf_counter() - start
+
+
+if __name__ == "__main__":
+    main()
diff --git a/src/py/kaleido/mocker/_args.py b/src/py/kaleido/mocker/_args.py
new file mode 100644
index 00000000..82920e00
--- /dev/null
+++ b/src/py/kaleido/mocker/_args.py
@@ -0,0 +1,169 @@
+from __future__ import annotations
+
+import argparse
+import sys
+from pathlib import Path
+
+import logistro
+
+from . import _defaults
+
+_logger = logistro.getLogger(__name__)
+
+description = """kaleido_mocker will load up json files of plotly figs and export them.
+
+If you set multiple process, -n, non-headless mode won't function well because
+chrome will actually throttle tabs or windows/visibile- unless that tab/window
+is headless.
+
+The export of the program is a json object containing information about the execution.
+"""
+
+if "--headless" in sys.argv and "--no-headless" in sys.argv:
+    raise ValueError(
+        "Choose either '--headless' or '--no-headless'.",
+    )
+
+parser = argparse.ArgumentParser(
+    add_help=True,
+    parents=[logistro.parser],
+    conflict_handler="resolve",
+    description=description,
+)
+
+# Overrides logstro default
+parser.add_argument(
+    "--logistro-level",
+    default="INFO",
+    dest="log",
+    help="Set the logging level (default INFO)",
+)
+
+basic_config = parser.add_argument_group("Basic Config Options")
+
+basic_config.add_argument(
+    "--n",
+    type=int,
+    default=_defaults.cpus,
+    help="Number of tabs, defaults to # of cpus",
+)
+basic_config.add_argument(
+    "--input",
+    type=str,
+    default=_defaults.in_dir,
+    help="Directory of mock file/s or single file (default tests/mocks)",
+)
+basic_config.add_argument(
+    "--output",
+    type=str,
+    default=_defaults.out_dir,
+    help="DIRECTORY of mock file/s (default tests/renders)",
+)
+
+basic_config.add_argument(
+    "--timeout",
+    type=int,
+    default=90,
+    help="Set timeout in seconds for any 1 mock (default 60 seconds)",
+)
+
+basic_config.add_argument(
+    "--fail-fast",
+    action="store_true",
+    default=False,
+    help="Throw first error encountered and stop execution.",
+)
+
+basic_config.add_argument(
+    "--random",
+    type=int,
+    default=0,
+    help="Will select N random jsons- or if 0 (default), all.",
+)
+
+# Image Setting Arguments
+
+image_parameters = parser.add_argument_group("Image Parameterize")
+
+image_parameters.add_argument(
+    "--parameterize",
+    action="store_true",
+    default=False,
+    help="Run mocks w/ different configurations.",
+)
+
+image_parameters.add_argument(
+    "--format",
+    type=str,
+    default=argparse.SUPPRESS,
+    help="png (default), pdf, jpg, webp, svg, json",
+)
+image_parameters.add_argument(
+    "--width",
+    type=str,
+    default=argparse.SUPPRESS,
+    help="width in pixels (default 700)",
+)
+image_parameters.add_argument(
+    "--height",
+    type=str,
+    default=argparse.SUPPRESS,
+    help="height in pixels (default 500)",
+)
+image_parameters.add_argument(
+    "--scale",
+    type=str,
+    default=argparse.SUPPRESS,
+    help="Scale ratio, acts as multiplier for height/width (default 1)",
+)
+
+# Diagnostic Arguments
+
+diagnostic_options = parser.add_argument_group("Diagnostic Options")
+
+diagnostic_options.add_argument(
+    "--headless",
+    action="store_true",
+    default=True,
+    help="Set headless as True (default)",
+)
+diagnostic_options.add_argument(
+    "--no-headless",
+    action="store_false",
+    dest="headless",
+    help="Set headless as False",
+)
+
+diagnostic_options.add_argument(
+    "--stepper",
+    action="store_true",
+    default=False,
+    dest="stepper",
+    help="Stepper sets n to 1, headless to False, no timeout "
+    "and asks for confirmation before printing.",
+)
+
+
+args = parser.parse_args()
+
+logistro.getLogger().setLevel(args.log)
+
+if not Path(args.output).is_dir():
+    raise ValueError(f"Specified output must be existing directory. Is {args.output!s}")
+
+args_d = vars(args)
+if args_d["stepper"]:
+    args_d["n"] = 1
+    args_d["headless"] = True
+    args_d["timeout"] = 0
+
+_p = args_d["parameterize"]
+
+args_d.setdefault("width", _defaults.width if _p else _defaults.width[0])
+args_d.setdefault("height", _defaults.height if _p else _defaults.height[0])
+args_d.setdefault("scale", _defaults.scale if _p else _defaults.scale[0])
+args_d.setdefault("format", _defaults.extension if _p else _defaults.extension[0])
+
+for key in ("width", "height", "scale", "format"):
+    if not isinstance(args_d[key], (list, tuple)):
+        args_d[key] = args_d[key]
diff --git a/src/py/kaleido/mocker/_defaults.py b/src/py/kaleido/mocker/_defaults.py
new file mode 100644
index 00000000..6c8fc5ee
--- /dev/null
+++ b/src/py/kaleido/mocker/_defaults.py
@@ -0,0 +1,31 @@
+from __future__ import annotations
+
+import multiprocessing
+from pathlib import Path
+
+import logistro
+
+_logger = logistro.getLogger(__name__)
+
+
+width = [700, 200, 1000]  # first value in main default if not parameterized
+height = [500, 200, 1000]
+scale = [1, 0.5, 2]
+extension = [
+    "png",
+    "pdf",
+    "jpg",
+    "webp",
+    "svg",
+    "json",
+]
+
+# use itertools.product
+
+# Number of CPUS
+cpus = multiprocessing.cpu_count()
+
+# Default Directories
+test_dir = Path(__file__).resolve().parent.parent / "integration_tests"
+in_dir = test_dir / "mocks"
+out_dir = test_dir / "renders"
diff --git a/src/py/kaleido/mocker/_utils.py b/src/py/kaleido/mocker/_utils.py
new file mode 100644
index 00000000..2ad25952
--- /dev/null
+++ b/src/py/kaleido/mocker/_utils.py
@@ -0,0 +1,66 @@
+from __future__ import annotations
+
+import itertools
+from pathlib import Path
+from typing import TYPE_CHECKING, TypedDict
+
+import logistro
+import orjson
+
+from ._args import args
+
+if TYPE_CHECKING:
+    ...
+
+_logger = logistro.getLogger(__name__)
+
+
+def get_jsons_in_paths(path: str | Path) -> list[Path]:
+    # Work with Paths and directories
+    path = Path(path) if isinstance(path, str) else path
+
+    if path.is_dir():
+        _logger.info(f"Input is path {path}")
+        return list(path.glob("*.json"))
+    elif path.is_file():
+        _logger.info(f"Input is file {path}")
+        return [path]
+    else:
+        raise TypeError("--input must be file or directory")
+
+
+class Param(TypedDict):
+    name: str
+    opts: dict[str, int | float]
+
+
+# maybe don't have this do params and figures
+def load_figures_from_paths(paths: list[Path]):
+    # Set json
+    for path in paths:
+        if not path.is_file():
+            raise RuntimeError(f"Path {path} is not a file.")
+
+        with path.open(encoding="utf-8") as file:
+            figure = orjson.loads(file.read())
+            for f, w, h, s in itertools.product(  # all combos
+                args.format,
+                args.width,
+                args.height,
+                args.scale,
+            ):
+                name = (
+                    f"{path.stem}.{args.format}"
+                    if not args.parameterize
+                    else f"{path.stem!s}-{w!s}x{h!s}@{s!s}.{f!s}"
+                )
+                opts = {
+                    "scale": s,
+                    "width": w,
+                    "height": h,
+                }
+                yield {
+                    "fig": figure,
+                    "path": str(Path(args.output) / name),
+                    "opts": opts,
+                }
diff --git a/src/py/pyproject.toml b/src/py/pyproject.toml
index 5d3e39d4..ce15159a 100644
--- a/src/py/pyproject.toml
+++ b/src/py/pyproject.toml
@@ -38,7 +38,7 @@ Homepage = "https://github.com/plotly/kaleido"
 Repository = "https://github.com/plotly/kaleido"
 
 [project.scripts]
-kaleido_mocker = "kaleido._mocker:build_mocks"
+kaleido_mocker = "kaleido.mocker:main"
 kaleido_get_chrome = "choreographer.cli._cli_utils:get_chrome_cli"
 
 [dependency-groups]

From 1f406e65fb6b3dd9dab8a0c36c7db5993c2c2383 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Wed, 24 Sep 2025 16:22:52 -0500
Subject: [PATCH 141/167] Fix syntax bugs in testing.

---
 src/py/kaleido/mocker/__init__.py  | 23 +++++++++++++++--------
 src/py/kaleido/mocker/_args.py     | 25 ++++++++++++++++---------
 src/py/kaleido/mocker/_defaults.py |  2 +-
 src/py/kaleido/mocker/_utils.py    |  5 +++--
 4 files changed, 35 insertions(+), 20 deletions(-)

diff --git a/src/py/kaleido/mocker/__init__.py b/src/py/kaleido/mocker/__init__.py
index 64424301..5be9c47a 100644
--- a/src/py/kaleido/mocker/__init__.py
+++ b/src/py/kaleido/mocker/__init__.py
@@ -3,7 +3,7 @@
 from __future__ import annotations
 
 import asyncio
-import time
+import sys
 from random import sample
 from typing import TYPE_CHECKING
 
@@ -19,6 +19,8 @@
 
 _logger = logistro.getLogger(__name__)
 
+# ruff: noqa: T201 we print stuff.
+
 
 def random_config(paths: list[Path]) -> list[Path]:
     """Select a portion of possible paths."""
@@ -27,7 +29,7 @@ def random_config(paths: list[Path]) -> list[Path]:
             f"Input discover {len(paths)} paths, but a sampling of"
             f"{args.random} was asked for.",
         )
-    paths = sample(paths, args.random)
+    return sample(paths, args.random)
 
 
 # Function to process the images
@@ -42,7 +44,7 @@ async def _main():
         headless=args.headless,
         timeout=args.timeout,
     ) as k:
-        await k.write_fig_from_object(
+        return await k.write_fig_from_object(
             _utils.load_figures_from_paths(paths),
             stepper=args.stepper,
             cancel_on_error=args.fail_fast,
@@ -51,11 +53,16 @@ async def _main():
 
 def main():
     """[project.scripts] expects to call a function, not a module."""
-    start = time.perf_counter()
-    try:
-        asyncio.run(_main())
-    finally:
-        elapsed = time.perf_counter() - start
+    res = asyncio.run(_main())
+    # do profile here
+    if res:
+        # better to get this from the profile
+        print(f"Number of errors: {len(res)}")
+        for i, e in enumerate(res):
+            print(str(e), file=sys.stderr)
+            if i > 10:  # noqa: PLR2004
+                print("More than 10 errors, use --profile.", file=sys.stderr)
+                break
 
 
 if __name__ == "__main__":
diff --git a/src/py/kaleido/mocker/_args.py b/src/py/kaleido/mocker/_args.py
index 82920e00..ac44e0f9 100644
--- a/src/py/kaleido/mocker/_args.py
+++ b/src/py/kaleido/mocker/_args.py
@@ -10,14 +10,19 @@
 
 _logger = logistro.getLogger(__name__)
 
-description = """kaleido_mocker will load up json files of plotly figs and export them.
-
-If you set multiple process, -n, non-headless mode won't function well because
-chrome will actually throttle tabs or windows/visibile- unless that tab/window
-is headless.
-
-The export of the program is a json object containing information about the execution.
-"""
+description = "\n".join(  # noqa: FLY002
+    [
+        "kaleido_mocker loads & renders Plotly figures (from json or pickle).",
+        "",
+        "Furthermore, it outputs (to stdout) a JSON with performance information.",
+        "",
+        "",
+        (
+            "Note: non-headless mode often interferes with multi-process mode as "
+            "non-visible windows are often throttled"
+        ),
+    ],
+)
 
 if "--headless" in sys.argv and "--no-headless" in sys.argv:
     raise ValueError(
@@ -166,4 +171,6 @@
 
 for key in ("width", "height", "scale", "format"):
     if not isinstance(args_d[key], (list, tuple)):
-        args_d[key] = args_d[key]
+        args_d[key] = (args_d[key],)
+
+_logger.info(f"Mocker args calculated: {args_d}")
diff --git a/src/py/kaleido/mocker/_defaults.py b/src/py/kaleido/mocker/_defaults.py
index 6c8fc5ee..1df94a75 100644
--- a/src/py/kaleido/mocker/_defaults.py
+++ b/src/py/kaleido/mocker/_defaults.py
@@ -26,6 +26,6 @@
 cpus = multiprocessing.cpu_count()
 
 # Default Directories
-test_dir = Path(__file__).resolve().parent.parent / "integration_tests"
+test_dir = Path(__file__).resolve().parent.parent.parent / "integration_tests"
 in_dir = test_dir / "mocks"
 out_dir = test_dir / "renders"
diff --git a/src/py/kaleido/mocker/_utils.py b/src/py/kaleido/mocker/_utils.py
index 2ad25952..125dbed0 100644
--- a/src/py/kaleido/mocker/_utils.py
+++ b/src/py/kaleido/mocker/_utils.py
@@ -40,7 +40,7 @@ def load_figures_from_paths(paths: list[Path]):
     for path in paths:
         if not path.is_file():
             raise RuntimeError(f"Path {path} is not a file.")
-
+        _logger.info(f"Found file: {path!s}")
         with path.open(encoding="utf-8") as file:
             figure = orjson.loads(file.read())
             for f, w, h, s in itertools.product(  # all combos
@@ -50,7 +50,7 @@ def load_figures_from_paths(paths: list[Path]):
                 args.scale,
             ):
                 name = (
-                    f"{path.stem}.{args.format}"
+                    f"{path.stem}.{f!s}"
                     if not args.parameterize
                     else f"{path.stem!s}-{w!s}x{h!s}@{s!s}.{f!s}"
                 )
@@ -59,6 +59,7 @@ def load_figures_from_paths(paths: list[Path]):
                     "width": w,
                     "height": h,
                 }
+                _logger.info(f"Yielding spec: {name!s}")
                 yield {
                     "fig": figure,
                     "path": str(Path(args.output) / name),

From 6ce5d04ae1159c9c2e1d02689339ca9452109524 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Wed, 24 Sep 2025 16:34:12 -0500
Subject: [PATCH 142/167] Expose profiler var.

---
 src/py/kaleido/kaleido.py | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/src/py/kaleido/kaleido.py b/src/py/kaleido/kaleido.py
index 4b14d717..62443f10 100644
--- a/src/py/kaleido/kaleido.py
+++ b/src/py/kaleido/kaleido.py
@@ -97,6 +97,7 @@ class Kaleido(choreo.Browser):
     """A queue of tabs ready to process a kaleido figure."""
     _main_render_coroutines: set[asyncio.Task]
     # technically Tasks, user sees coroutines
+    profiler: deque[_profiler.WriteCall]
 
     _total_tabs: int
     _html_tmp_dir: None | TmpDirectory
@@ -157,7 +158,7 @@ def __init__(
         self.tabs_ready = asyncio.Queue(maxsize=0)
         self._total_tabs = 0  # tabs properly registered
         self._html_tmp_dir = None
-        self._task_profiler: deque[_profiler.WriteCall] = deque(maxlen=5)
+        self.profiler: deque[_profiler.WriteCall] = deque(maxlen=5)
 
         # Kaleido Config
         page = page_generator
@@ -426,7 +427,7 @@ async def write_fig_from_object(
             name = main_task.get_name()
 
         profiler = _profiler.WriteCall(name)
-        self._task_profiler.append(profiler)
+        self.profiler.append(profiler)
 
         tasks: set[asyncio.Task] = set()
 

From 5d390284c0e5f6561a893a86e54859b4fc0f55e9 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Wed, 24 Sep 2025 16:56:56 -0500
Subject: [PATCH 143/167] Add profile tick for acquring tab.

---
 src/py/kaleido/kaleido.py         |  1 +
 src/py/kaleido/mocker/__init__.py | 10 +++++-----
 2 files changed, 6 insertions(+), 5 deletions(-)

diff --git a/src/py/kaleido/kaleido.py b/src/py/kaleido/kaleido.py
index 62443f10..30a568df 100644
--- a/src/py/kaleido/kaleido.py
+++ b/src/py/kaleido/kaleido.py
@@ -335,6 +335,7 @@ async def _render_task(
             full_path if _write else None,
             tab.tab.target_id,
         )
+        render_prof.profile_log.tick("acquired tab")
         profiler.renders.append(render_prof)
 
         try:
diff --git a/src/py/kaleido/mocker/__init__.py b/src/py/kaleido/mocker/__init__.py
index 5be9c47a..17e40078 100644
--- a/src/py/kaleido/mocker/__init__.py
+++ b/src/py/kaleido/mocker/__init__.py
@@ -48,17 +48,17 @@ async def _main():
             _utils.load_figures_from_paths(paths),
             stepper=args.stepper,
             cancel_on_error=args.fail_fast,
-        )
+        ), k.profiler
 
 
 def main():
     """[project.scripts] expects to call a function, not a module."""
-    res = asyncio.run(_main())
+    errors, profiler = asyncio.run(_main())
     # do profile here
-    if res:
+    if errors:
         # better to get this from the profile
-        print(f"Number of errors: {len(res)}")
-        for i, e in enumerate(res):
+        print(f"Number of errors: {len(errors)}")
+        for i, e in enumerate(errors):
             print(str(e), file=sys.stderr)
             if i > 10:  # noqa: PLR2004
                 print("More than 10 errors, use --profile.", file=sys.stderr)

From f6d7d523586215ab32eec036a8c138922ac72389 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Wed, 24 Sep 2025 16:58:19 -0500
Subject: [PATCH 144/167] Fix mathjax type hints.

---
 src/py/kaleido/kaleido.py | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/src/py/kaleido/kaleido.py b/src/py/kaleido/kaleido.py
index 30a568df..4117ce26 100644
--- a/src/py/kaleido/kaleido.py
+++ b/src/py/kaleido/kaleido.py
@@ -110,8 +110,8 @@ def __init__(
         n: int = 1,
         timeout: int | None = 90,
         page_generator: None | PageGenerator | str | Path = None,
-        plotlyjs: str | Path | None = None,  # TODO(AJP): with page generator
-        mathjax: str | Path | None = None,  # TODO(AJP): with page generator?
+        plotlyjs: str | Path | None = None,
+        mathjax: str | Path | Literal[False] | None = None,
         **kwargs: Any,
     ) -> None:
         """
@@ -139,8 +139,8 @@ def __init__(
                 to use the plotly.js included with your version of plotly.py or
                 if not installed, the latest version available via CDN.
 
-            mathjax (str | Path | None, optional):
-                A path or URL to a mathjax.js file. If false, mathjax is
+            mathjax (str | Path | Literal[False] | None, optional):
+                A path or URL to a mathjax.js file. If Dalse, mathjax is
                 disabled. Defaults to None- which means to use version 2.35 via
                 CDN.
 

From 5df963e67ce8c03207f0c96026d3f1486bb24d35 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Wed, 24 Sep 2025 17:00:36 -0500
Subject: [PATCH 145/167] Add explicit check for bad setup options.

---
 src/py/kaleido/kaleido.py | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/src/py/kaleido/kaleido.py b/src/py/kaleido/kaleido.py
index 4117ce26..43c75f2a 100644
--- a/src/py/kaleido/kaleido.py
+++ b/src/py/kaleido/kaleido.py
@@ -161,6 +161,11 @@ def __init__(
         self.profiler: deque[_profiler.WriteCall] = deque(maxlen=5)
 
         # Kaleido Config
+        if page_generator and (plotlyjs is not None or mathjax is not None):
+            raise ValueError(
+                "page_generator cannot be set with mathjax or plotlyjs",
+            )
+
         page = page_generator
         self._timeout = timeout
         self._n = n

From d806fe55e28f095904d0fa3fdf8cc52eb064b51d Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Wed, 24 Sep 2025 17:03:16 -0500
Subject: [PATCH 146/167] Remove unnecessary TODOs

---
 src/py/kaleido/_kaleido_tab/_errors.py    | 2 +-
 src/py/kaleido/_kaleido_tab/_js_logger.py | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/src/py/kaleido/_kaleido_tab/_errors.py b/src/py/kaleido/_kaleido_tab/_errors.py
index 4516d7ad..f9a088b1 100644
--- a/src/py/kaleido/_kaleido_tab/_errors.py
+++ b/src/py/kaleido/_kaleido_tab/_errors.py
@@ -1,7 +1,7 @@
 from choreographer.errors import DevtoolsProtocolError
 
 
-class JavascriptError(RuntimeError):  # TODO(AJP): process better
+class JavascriptError(RuntimeError):
     """Used to report errors from javascript."""
 
 
diff --git a/src/py/kaleido/_kaleido_tab/_js_logger.py b/src/py/kaleido/_kaleido_tab/_js_logger.py
index 2f7fb7fe..bad0516e 100644
--- a/src/py/kaleido/_kaleido_tab/_js_logger.py
+++ b/src/py/kaleido/_kaleido_tab/_js_logger.py
@@ -12,11 +12,11 @@
     import choreographer
 
 
-def _make_console_logger(name, log):  # TODO(AJP) how do we use this
+def _make_console_logger(name, log):
     """Create printer specifically for console events. Helper function."""
 
     async def console_printer(event):
-        _logger.debug2(f"{name}:{event}")  # TODO(AJP): parse? stretch goal.
+        _logger.debug2(f"{name}:{event}")
         log.append(str(event))
 
     return console_printer

From 04ae94c4a035986d002720bcd8a6a86c49371d24 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Wed, 24 Sep 2025 17:06:07 -0500
Subject: [PATCH 147/167] Lint.

---
 src/py/kaleido/mocker/__init__.py   | 2 +-
 src/py/tests/test_page_generator.py | 2 +-
 src/py/tests/test_path_tools.py     | 6 +++---
 3 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/src/py/kaleido/mocker/__init__.py b/src/py/kaleido/mocker/__init__.py
index 17e40078..63aaae39 100644
--- a/src/py/kaleido/mocker/__init__.py
+++ b/src/py/kaleido/mocker/__init__.py
@@ -53,7 +53,7 @@ async def _main():
 
 def main():
     """[project.scripts] expects to call a function, not a module."""
-    errors, profiler = asyncio.run(_main())
+    errors, _profiler = asyncio.run(_main())
     # do profile here
     if errors:
         # better to get this from the profile
diff --git a/src/py/tests/test_page_generator.py b/src/py/tests/test_page_generator.py
index 3105e3d6..f5b7907e 100644
--- a/src/py/tests/test_page_generator.py
+++ b/src/py/tests/test_page_generator.py
@@ -219,7 +219,7 @@ async def test_force_cdn():
         pytest.fail("Plotly not available - cannot test force_cdn override")
 
     forced_cdn = PageGenerator(force_cdn=True).generate_index()
-    scripts, encodings = get_scripts_from_html(forced_cdn)
+    scripts, _encodings = get_scripts_from_html(forced_cdn)
 
     assert len(scripts) == 3  # noqa: PLR2004
     assert scripts[0] == DEFAULT_MATHJAX
diff --git a/src/py/tests/test_path_tools.py b/src/py/tests/test_path_tools.py
index 15d115ce..ae29e6d7 100644
--- a/src/py/tests/test_path_tools.py
+++ b/src/py/tests/test_path_tools.py
@@ -118,7 +118,7 @@ def test_determine_path_no_suffix_directory(tmp_path, fig_fixture):
 
     # Test error
     nonexistent_dir = Path("/nonexistent/directory")
-    with pytest.raises(ValueError, match="Directory .* not found. Please create it."):
+    with pytest.raises(ValueError, match=r"Directory .* not found. Please create it."):
         _path_tools.determine_path(nonexistent_dir, fig_dict, "ext")
 
 
@@ -139,7 +139,7 @@ def test_determine_path_directory_with_suffix(tmp_path, fig_fixture):
 
 def test_determine_path_file_with_suffix(tmp_path, fig_fixture):
     """Test determine_path with file path having suffix."""
-    fig_dict, expected_prefix = fig_fixture
+    fig_dict, _expected_prefix = fig_fixture
 
     # Exists
     file_path = tmp_path / "output.png"
@@ -152,6 +152,6 @@ def test_determine_path_file_with_suffix(tmp_path, fig_fixture):
     file_path = Path("/nonexistent/directory/output.png")
     with pytest.raises(
         RuntimeError,
-        match="Cannot reach path .* Are all directories created?",
+        match=r"Cannot reach path .* Are all directories created?",
     ):
         _path_tools.determine_path(file_path, fig_dict, "ext")

From 58edd0d90d16ea88c33a4e52e60a3b3a7583d439 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Wed, 24 Sep 2025 17:21:05 -0500
Subject: [PATCH 148/167] Type tests.

---
 src/py/tests/test_calc_fig_one_off.py |  2 +-
 src/py/tests/test_fig_tools.py        |  8 ++++----
 src/py/tests/test_init.py             |  7 +++++++
 src/py/tests/test_kaleido.py          |  2 +-
 src/py/tests/test_path_tools.py       | 26 +++++++++++++-------------
 src/py/tests/test_public_api.py       |  2 +-
 src/py/tests/test_utils.py            |  2 +-
 7 files changed, 28 insertions(+), 21 deletions(-)

diff --git a/src/py/tests/test_calc_fig_one_off.py b/src/py/tests/test_calc_fig_one_off.py
index 70ae170f..233260e1 100644
--- a/src/py/tests/test_calc_fig_one_off.py
+++ b/src/py/tests/test_calc_fig_one_off.py
@@ -13,7 +13,7 @@
 
 async def test_calc_fig():
     # ruff: noqa: PLC0415
-    import plotly.express as px
+    import plotly.express as px  # type: ignore[import-untyped]
 
     with warnings.catch_warnings():
         warnings.filterwarnings("ignore", category=DeprecationWarning)
diff --git a/src/py/tests/test_fig_tools.py b/src/py/tests/test_fig_tools.py
index ee32e9ab..c170ff61 100644
--- a/src/py/tests/test_fig_tools.py
+++ b/src/py/tests/test_fig_tools.py
@@ -1,6 +1,6 @@
 import pytest
 
-from kaleido import _fig_tools
+from kaleido._utils import fig_tools
 
 sources = ["argument", "layout", "template", "default"]
 values = [None, 150, 800, 1500]
@@ -36,7 +36,7 @@ def test_coerce_for_js_dimensions(
 
     # Set to default if None
     if expected_width is None:
-        expected_width = _fig_tools.DEFAULT_WIDTH
+        expected_width = fig_tools.DEFAULT_WIDTH
 
     # Do for height what I did for width
     expected_height = height_value
@@ -54,13 +54,13 @@ def test_coerce_for_js_dimensions(
 
     # Set to default if None
     if expected_height is None:
-        expected_height = _fig_tools.DEFAULT_HEIGHT
+        expected_height = fig_tools.DEFAULT_HEIGHT
 
     # Create a figure dict with the layout
     fig = {"data": [], "layout": layout}
 
     # Call the function
-    spec = _fig_tools.coerce_for_js(fig, None, opts)
+    spec = fig_tools.coerce_for_js(fig, None, opts)
 
     # Assert results
     assert spec["width"] == expected_width, (
diff --git a/src/py/tests/test_init.py b/src/py/tests/test_init.py
index c413154a..24d36df7 100644
--- a/src/py/tests/test_init.py
+++ b/src/py/tests/test_init.py
@@ -1,11 +1,18 @@
 """Tests for wrapper functions in __init__.py that test argument passing."""
 
+from typing import TYPE_CHECKING
 from unittest.mock import AsyncMock, patch
 
 import pytest
 
 import kaleido
 
+if TYPE_CHECKING:
+    from typing import Any
+
+    _: Any
+
+
 # Just tests wrapping, but in a way tests internals.
 # These are better done as part of integration tests.
 
diff --git a/src/py/tests/test_kaleido.py b/src/py/tests/test_kaleido.py
index f5d1f143..c365450f 100644
--- a/src/py/tests/test_kaleido.py
+++ b/src/py/tests/test_kaleido.py
@@ -12,7 +12,7 @@
 @pytest.fixture(scope="session")
 def simple_figure_with_bytes():
     """Create a simple figure with calculated bytes and PNG assertion."""
-    import plotly.express as px  # noqa: PLC0415
+    import plotly.express as px  # type: ignore[import-untyped] # noqa: PLC0415
 
     fig = px.line(x=[1, 2, 3], y=[1, 2, 3])
 
diff --git a/src/py/tests/test_path_tools.py b/src/py/tests/test_path_tools.py
index ae29e6d7..2791e36c 100644
--- a/src/py/tests/test_path_tools.py
+++ b/src/py/tests/test_path_tools.py
@@ -2,12 +2,12 @@
 
 import pytest
 
-from kaleido import _path_tools
+from kaleido._utils import path_tools
 
 
 def test_next_filename_no_existing_files(tmp_path):
     """Test _next_filename when no files exist."""
-    result = _path_tools._next_filename(tmp_path, "test", "png")  # noqa: SLF001
+    result = path_tools._next_filename(tmp_path, "test", "png")  # noqa: SLF001
     assert result == "test.png"
 
 
@@ -16,7 +16,7 @@ def test_next_filename_base_file_exists(tmp_path):
     # Create the base file
     (tmp_path / "test.png").touch()
 
-    result = _path_tools._next_filename(tmp_path, "test", "png")  # noqa: SLF001
+    result = path_tools._next_filename(tmp_path, "test", "png")  # noqa: SLF001
     assert result == "test-2.png"
 
 
@@ -28,7 +28,7 @@ def test_next_filename_numbered_files_exist(tmp_path):
     (tmp_path / "test-3.png").touch()
     (tmp_path / "test-5.png").touch()  # Gap in numbering
 
-    result = _path_tools._next_filename(tmp_path, "test", "png")  # noqa: SLF001
+    result = path_tools._next_filename(tmp_path, "test", "png")  # noqa: SLF001
     assert result == "test-6.png"  # Should be max + 1
 
 
@@ -41,7 +41,7 @@ def test_next_filename_similar_names_ignored(tmp_path):
     (tmp_path / "test-2.jpg").touch()  # Different extension
     (tmp_path / "test-abc.png").touch()  # Non-numeric suffix
 
-    result = _path_tools._next_filename(tmp_path, "test", "png")  # noqa: SLF001
+    result = path_tools._next_filename(tmp_path, "test", "png")  # noqa: SLF001
     assert result == "test-3.png"  # Should only count test.png and test-2.png
 
 
@@ -54,7 +54,7 @@ def test_next_filename_special_characters(tmp_path):
     (tmp_path / f"{prefix}.{ext}").touch()
     (tmp_path / f"{prefix}-2.{ext}").touch()
 
-    result = _path_tools._next_filename(tmp_path, prefix, ext)  # noqa: SLF001
+    result = path_tools._next_filename(tmp_path, prefix, ext)  # noqa: SLF001
     assert result == f"{prefix}-3.{ext}"
 
 
@@ -65,7 +65,7 @@ def test_next_filename_only_numbered_files(tmp_path):
     (tmp_path / "test-3.png").touch()
     (tmp_path / "test-10.png").touch()
 
-    result = _path_tools._next_filename(tmp_path, "test", "png")  # noqa: SLF001
+    result = path_tools._next_filename(tmp_path, "test", "png")  # noqa: SLF001
     assert result == "test-11.png"  # Should be max + 1
 
 
@@ -95,7 +95,7 @@ def fig_fixture(request):
 def test_determine_path_no_path_input(fig_fixture):
     """Test determine_path with no path input uses current path."""
     fig_dict, expected_prefix = fig_fixture
-    result = _path_tools.determine_path(None, fig_dict, "ext")
+    result = path_tools.determine_path(None, fig_dict, "ext")
 
     # Should use current directory
     assert result.parent.resolve() == Path().cwd().resolve()
@@ -110,7 +110,7 @@ def test_determine_path_no_suffix_directory(tmp_path, fig_fixture):
 
     # Test directory no suffix
     test_dir = tmp_path
-    result = _path_tools.determine_path(test_dir, fig_dict, "ext")
+    result = path_tools.determine_path(test_dir, fig_dict, "ext")
 
     # Should use provided directory
     assert result.parent == test_dir
@@ -119,7 +119,7 @@ def test_determine_path_no_suffix_directory(tmp_path, fig_fixture):
     # Test error
     nonexistent_dir = Path("/nonexistent/directory")
     with pytest.raises(ValueError, match=r"Directory .* not found. Please create it."):
-        _path_tools.determine_path(nonexistent_dir, fig_dict, "ext")
+        path_tools.determine_path(nonexistent_dir, fig_dict, "ext")
 
 
 def test_determine_path_directory_with_suffix(tmp_path, fig_fixture):
@@ -130,7 +130,7 @@ def test_determine_path_directory_with_suffix(tmp_path, fig_fixture):
     dir_with_suffix = tmp_path / "mydir.png"
     dir_with_suffix.mkdir()
 
-    result = _path_tools.determine_path(dir_with_suffix, fig_dict, "ext")
+    result = path_tools.determine_path(dir_with_suffix, fig_dict, "ext")
 
     # Should treat as directory
     assert result.parent == dir_with_suffix
@@ -143,7 +143,7 @@ def test_determine_path_file_with_suffix(tmp_path, fig_fixture):
 
     # Exists
     file_path = tmp_path / "output.png"
-    result = _path_tools.determine_path(file_path, fig_dict, "ext")
+    result = path_tools.determine_path(file_path, fig_dict, "ext")
 
     # Should return the exact path provided
     assert result == file_path
@@ -154,4 +154,4 @@ def test_determine_path_file_with_suffix(tmp_path, fig_fixture):
         RuntimeError,
         match=r"Cannot reach path .* Are all directories created?",
     ):
-        _path_tools.determine_path(file_path, fig_dict, "ext")
+        path_tools.determine_path(file_path, fig_dict, "ext")
diff --git a/src/py/tests/test_public_api.py b/src/py/tests/test_public_api.py
index 4ab93b39..6e0745d2 100644
--- a/src/py/tests/test_public_api.py
+++ b/src/py/tests/test_public_api.py
@@ -12,7 +12,7 @@
 def simple_figure(request):
     """Create a simple plotly figure for testing, either as figure or dict."""
     # ruff: noqa: PLC0415
-    import plotly.express as px
+    import plotly.express as px  # type: ignore[import-untyped]
 
     fig = px.line(x=[1, 2, 3, 4], y=[1, 2, 3, 4])
 
diff --git a/src/py/tests/test_utils.py b/src/py/tests/test_utils.py
index 888447bc..0c2e5b07 100644
--- a/src/py/tests/test_utils.py
+++ b/src/py/tests/test_utils.py
@@ -2,7 +2,7 @@
 
 import pytest
 
-from kaleido._utils import get_path, is_httpish
+from kaleido._utils.path_tools import get_path, is_httpish
 
 pytestmark = pytest.mark.asyncio(loop_scope="function")
 

From 678522ff0ba9290a601d39cfaae6dcb0f8cecc29 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Wed, 24 Sep 2025 17:34:28 -0500
Subject: [PATCH 149/167] Add debugging to GHA.

---
 .github/workflows/test.yml | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml
index 1aba10fe..35e27aaa 100644
--- a/.github/workflows/test.yml
+++ b/.github/workflows/test.yml
@@ -11,6 +11,9 @@ jobs:
       matrix:
         os: [ubuntu-latest, windows-latest, macos-latest]
     runs-on: ${{ matrix.os }}
+    env:
+      PYTHONTRACEMALLOC: "1"
+      PYTHONWARNINGS: "error::ResourceWarning"
     defaults:
       run:
         working-directory: ./src/py/

From 2ab6476ab68f972eb9491701b041540c5a957434 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Wed, 24 Sep 2025 17:53:54 -0500
Subject: [PATCH 150/167] Stop testing invalid windows characters.

---
 src/py/tests/test_path_tools.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/src/py/tests/test_path_tools.py b/src/py/tests/test_path_tools.py
index 2791e36c..e3c9ad1c 100644
--- a/src/py/tests/test_path_tools.py
+++ b/src/py/tests/test_path_tools.py
@@ -47,8 +47,8 @@ def test_next_filename_similar_names_ignored(tmp_path):
 
 def test_next_filename_special_characters(tmp_path):
     """Test _next_filename with special characters in prefix and extension."""
-    prefix = "test-?f$ile_name"
-    ext = "s$v&*g"  # set up to be parameterized but not
+    prefix = "test-f$ile_name"
+    ext = "s$v&g"  # set up to be parameterized but not
 
     # Create some files
     (tmp_path / f"{prefix}.{ext}").touch()
@@ -75,7 +75,7 @@ def test_next_filename_only_numbered_files(tmp_path):
         (
             {
                 "layout": {
-                    "title": {"text": "My-Test!@#$%^&*()Chart_with[lots]of{symbols}"},
+                    "title": {"text": "My-Test!@#$%^&()Chart_with[lots]of{symbols}"},
                 },
             },
             "My_TestChart_withlotsofsymbols",

From c1670059b1aca536b9f0857b85f38e817069a01c Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Wed, 24 Sep 2025 17:54:59 -0500
Subject: [PATCH 151/167] See if function scoped fig generator solves win
 problem.

---
 src/py/tests/test_kaleido.py | 18 +++++++-----------
 1 file changed, 7 insertions(+), 11 deletions(-)

diff --git a/src/py/tests/test_kaleido.py b/src/py/tests/test_kaleido.py
index c365450f..0d81805b 100644
--- a/src/py/tests/test_kaleido.py
+++ b/src/py/tests/test_kaleido.py
@@ -9,22 +9,18 @@
 from kaleido import Kaleido
 
 
-@pytest.fixture(scope="session")
-def simple_figure_with_bytes():
+@pytest.fixture(scope="function")
+async def simple_figure_with_bytes():
     """Create a simple figure with calculated bytes and PNG assertion."""
     import plotly.express as px  # type: ignore[import-untyped] # noqa: PLC0415
 
     fig = px.line(x=[1, 2, 3], y=[1, 2, 3])
 
-    async def build_obj():
-        async with Kaleido() as k:
-            bytes_data = await k.calc_fig(
-                fig,
-                opts={"format": "png", "width": 400, "height": 300},
-            )
-        return bytes_data
-
-    bytes_data = asyncio.run(build_obj())
+    async with Kaleido() as k:
+        bytes_data = await k.calc_fig(
+            fig,
+            opts={"format": "png", "width": 400, "height": 300},
+        )
 
     # Assert it's a PNG by checking the PNG signature
     assert bytes_data[:8] == b"\x89PNG\r\n\x1a\n", "Generated data is not a valid PNG"

From 14ae763058cb8e73efaff88ea8d3d51358353504 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Wed, 24 Sep 2025 17:59:57 -0500
Subject: [PATCH 152/167] Increase timeout for mac :-(

---
 src/py/pyproject.toml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/py/pyproject.toml b/src/py/pyproject.toml
index ce15159a..633d6a64 100644
--- a/src/py/pyproject.toml
+++ b/src/py/pyproject.toml
@@ -104,7 +104,7 @@ log_cli = false
 # name = cmd
 
 [tool.poe.tasks.test]
-cmd = "pytest --timeout=20 --log-level=1 -W error -n auto -v -rfE --capture=fd"
+cmd = "pytest --timeout=50 --log-level=1 -W error -n auto -v -rfE --capture=fd"
 help = "Run all tests quickly"
 
 [tool.poe.tasks.debug-test]

From 2565ca1bf4a344e749c716c4a00af6d8f7a4feed Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Wed, 24 Sep 2025 18:13:58 -0500
Subject: [PATCH 153/167] Add comment.

---
 src/py/tests/test_kaleido.py | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/src/py/tests/test_kaleido.py b/src/py/tests/test_kaleido.py
index 0d81805b..84424d2d 100644
--- a/src/py/tests/test_kaleido.py
+++ b/src/py/tests/test_kaleido.py
@@ -9,6 +9,9 @@
 from kaleido import Kaleido
 
 
+# can't do session scope because pytest complains that its used by
+# function-scoped loops. tried to create a separate loop in here with
+# session, lots of spooky errors, even asyncio.run() doesn't clean up right.
 @pytest.fixture(scope="function")
 async def simple_figure_with_bytes():
     """Create a simple figure with calculated bytes and PNG assertion."""

From 94df9ac00c703e56c279d21ddc8484525c4d92ea Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Thu, 25 Sep 2025 15:11:32 -0500
Subject: [PATCH 154/167] Remove pickling until pickle PR.

---
 src/py/integration_tests/dates/__init__.py    |   1 -
 .../dates/figs/scatter_map_w_layers.pkl.zst   | Bin 192682 -> 0 bytes
 .../dates/scatter_map_w_layers.py             |  58 ------------------
 3 files changed, 59 deletions(-)
 delete mode 100644 src/py/integration_tests/dates/__init__.py
 delete mode 100644 src/py/integration_tests/dates/figs/scatter_map_w_layers.pkl.zst
 delete mode 100644 src/py/integration_tests/dates/scatter_map_w_layers.py

diff --git a/src/py/integration_tests/dates/__init__.py b/src/py/integration_tests/dates/__init__.py
deleted file mode 100644
index dc084c37..00000000
--- a/src/py/integration_tests/dates/__init__.py
+++ /dev/null
@@ -1 +0,0 @@
-"""These are really just scripts, run them as such. Include pickle dev group."""
diff --git a/src/py/integration_tests/dates/figs/scatter_map_w_layers.pkl.zst b/src/py/integration_tests/dates/figs/scatter_map_w_layers.pkl.zst
deleted file mode 100644
index 8be4813ade4db1d5ee4f05a3d25cda26de2717e9..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 192682
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
ay7^9^rI=20e<HTE>-F$&;@nRkb=WJtC^8WM

diff --git a/src/py/integration_tests/dates/scatter_map_w_layers.py b/src/py/integration_tests/dates/scatter_map_w_layers.py
deleted file mode 100644
index 73074eef..00000000
--- a/src/py/integration_tests/dates/scatter_map_w_layers.py
+++ /dev/null
@@ -1,58 +0,0 @@
-"""Create pickled fig for use in integration tests."""
-
-import pickle
-from pathlib import Path
-
-import datashader as ds
-import datashader.transfer_functions as tf
-import pandas as pd
-import plotly.express as px
-import zstandard as zstd
-from colorcet import fire
-
-cctx = zstd.ZstdCompressor(level=20)
-
-df = pd.read_csv(
-    "https://raw.githubusercontent.com/plotly/datasets/master/uber-rides-data1.csv",
-)
-dff = (
-    df.query("Lat < 40.82")
-    .query("Lat > 40.70")
-    .query("Lon > -74.02")
-    .query("Lon < -73.91")
-)
-
-
-cvs = ds.Canvas(plot_width=1000, plot_height=1000)
-agg = cvs.points(dff, x="Lon", y="Lat")
-# agg is an xarray object, see http://xarray.pydata.org/en/stable/ for more details
-coords_lat, coords_lon = agg.coords["Lat"].to_numpy(), agg.coords["Lon"].to_numpy()
-# Corners of the image
-coordinates = [
-    [coords_lon[0], coords_lat[0]],
-    [coords_lon[-1], coords_lat[0]],
-    [coords_lon[-1], coords_lat[-1]],
-    [coords_lon[0], coords_lat[-1]],
-]
-
-
-img = tf.shade(agg, cmap=fire)[::-1].to_pil()
-
-
-# Trick to create rapidly a figure with map axes
-fig = px.scatter_map(dff[:1], lat="Lat", lon="Lon", zoom=12)
-# Add the datashader image as a tile map layer image
-fig.update_layout(
-    map_style="carto-darkmatter",
-    map_layers=[{"sourcetype": "image", "source": img, "coordinates": coordinates}],
-)
-
-raw = pickle.dumps(fig, protocol=5)  # >=3.8
-compressed = cctx.compress(raw)
-with Path(f"./figs/{Path(__file__).stem}.pkl.zst").open("wb") as f:
-    f.write(compressed)
-
-print(  # noqa: T201
-    f"{Path(__file__).stem}.pkl: "
-    f"{len(raw) / 1024:.1f} -> {len(compressed) / 1024:.1f} KB",
-)

From 0a61a4683fea6226632432db6c9853676a840987 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Thu, 25 Sep 2025 15:13:00 -0500
Subject: [PATCH 155/167] Fix up again changelog.

---
 src/py/CHANGELOG.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/py/CHANGELOG.txt b/src/py/CHANGELOG.txt
index 8ae00e69..a9a25322 100644
--- a/src/py/CHANGELOG.txt
+++ b/src/py/CHANGELOG.txt
@@ -2,8 +2,8 @@ v1.3.0
 - Significant refactor, better organization
 - `write_fig` and `_from_object` now take an additional argument:
   `fail_on_error: bool`. If False, default True, returns a list of errors.
-- Documentation improved
 - Unused `path` argument for `calc_fig` was removed.
+- Fixed race condition where two render tasks would choose the same filename
 
 
 v1.2.0

From 45b96d98eca7849d326cbbc2f588d33af7f3dadf Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Thu, 25 Sep 2025 15:18:22 -0500
Subject: [PATCH 156/167] Make more coherent README.md note.

---
 src/py/tests/README.md | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/src/py/tests/README.md b/src/py/tests/README.md
index 3b0b8099..a332a06a 100644
--- a/src/py/tests/README.md
+++ b/src/py/tests/README.md
@@ -1,3 +1,6 @@
+
+To clarify three similar test files:
+
 - test_public_api.py does render tests of renderers in __init__.py
   - it does not parametrize
 - test_init.py tests that wrappers are proper and pass args/kwargs
@@ -7,5 +10,5 @@
 
 
 
-Parameterizing actual renders would be a huge burden, but integration tests
-with mocks test it more completely
+Parameterizing actual renders would be a huge burden, so integration tests
+with mocks are currently the most complete tests.

From 695c18129c89425031e030f4a46c9d19941e9ef6 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Thu, 25 Sep 2025 19:11:43 -0500
Subject: [PATCH 157/167] Revert "Remove pickling until pickle PR.":

This commit is also in the fix-encoders test. The reason it wasn't used
it because the mocker framework was being re-done in this commit. So its
just sitting here in both unused. And at this point, modifying
fix-encoder might provoke git to forget about conflicts already
resolved.

This reverts commit 94df9ac00c703e56c279d21ddc8484525c4d92ea.
---
 src/py/integration_tests/dates/__init__.py    |   1 +
 .../dates/figs/scatter_map_w_layers.pkl.zst   | Bin 0 -> 192682 bytes
 .../dates/scatter_map_w_layers.py             |  58 ++++++++++++++++++
 3 files changed, 59 insertions(+)
 create mode 100644 src/py/integration_tests/dates/__init__.py
 create mode 100644 src/py/integration_tests/dates/figs/scatter_map_w_layers.pkl.zst
 create mode 100644 src/py/integration_tests/dates/scatter_map_w_layers.py

diff --git a/src/py/integration_tests/dates/__init__.py b/src/py/integration_tests/dates/__init__.py
new file mode 100644
index 00000000..dc084c37
--- /dev/null
+++ b/src/py/integration_tests/dates/__init__.py
@@ -0,0 +1 @@
+"""These are really just scripts, run them as such. Include pickle dev group."""
diff --git a/src/py/integration_tests/dates/figs/scatter_map_w_layers.pkl.zst b/src/py/integration_tests/dates/figs/scatter_map_w_layers.pkl.zst
new file mode 100644
index 0000000000000000000000000000000000000000..8be4813ade4db1d5ee4f05a3d25cda26de2717e9
GIT binary patch
literal 192682
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
ay7^9^rI=20e<HTE>-F$&;@nRkb=WJtC^8WM

literal 0
HcmV?d00001

diff --git a/src/py/integration_tests/dates/scatter_map_w_layers.py b/src/py/integration_tests/dates/scatter_map_w_layers.py
new file mode 100644
index 00000000..73074eef
--- /dev/null
+++ b/src/py/integration_tests/dates/scatter_map_w_layers.py
@@ -0,0 +1,58 @@
+"""Create pickled fig for use in integration tests."""
+
+import pickle
+from pathlib import Path
+
+import datashader as ds
+import datashader.transfer_functions as tf
+import pandas as pd
+import plotly.express as px
+import zstandard as zstd
+from colorcet import fire
+
+cctx = zstd.ZstdCompressor(level=20)
+
+df = pd.read_csv(
+    "https://raw.githubusercontent.com/plotly/datasets/master/uber-rides-data1.csv",
+)
+dff = (
+    df.query("Lat < 40.82")
+    .query("Lat > 40.70")
+    .query("Lon > -74.02")
+    .query("Lon < -73.91")
+)
+
+
+cvs = ds.Canvas(plot_width=1000, plot_height=1000)
+agg = cvs.points(dff, x="Lon", y="Lat")
+# agg is an xarray object, see http://xarray.pydata.org/en/stable/ for more details
+coords_lat, coords_lon = agg.coords["Lat"].to_numpy(), agg.coords["Lon"].to_numpy()
+# Corners of the image
+coordinates = [
+    [coords_lon[0], coords_lat[0]],
+    [coords_lon[-1], coords_lat[0]],
+    [coords_lon[-1], coords_lat[-1]],
+    [coords_lon[0], coords_lat[-1]],
+]
+
+
+img = tf.shade(agg, cmap=fire)[::-1].to_pil()
+
+
+# Trick to create rapidly a figure with map axes
+fig = px.scatter_map(dff[:1], lat="Lat", lon="Lon", zoom=12)
+# Add the datashader image as a tile map layer image
+fig.update_layout(
+    map_style="carto-darkmatter",
+    map_layers=[{"sourcetype": "image", "source": img, "coordinates": coordinates}],
+)
+
+raw = pickle.dumps(fig, protocol=5)  # >=3.8
+compressed = cctx.compress(raw)
+with Path(f"./figs/{Path(__file__).stem}.pkl.zst").open("wb") as f:
+    f.write(compressed)
+
+print(  # noqa: T201
+    f"{Path(__file__).stem}.pkl: "
+    f"{len(raw) / 1024:.1f} -> {len(compressed) / 1024:.1f} KB",
+)

From 6d3fb6a59153bc394a5ab3e4a15de2c2d0a92143 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Mon, 6 Oct 2025 13:45:43 -0500
Subject: [PATCH 158/167] Update precommit.

---
 src/py/.pre-commit-config.yaml | 21 ++++++++++++---------
 1 file changed, 12 insertions(+), 9 deletions(-)

diff --git a/src/py/.pre-commit-config.yaml b/src/py/.pre-commit-config.yaml
index 5f875d93..ae6b484e 100644
--- a/src/py/.pre-commit-config.yaml
+++ b/src/py/.pre-commit-config.yaml
@@ -79,15 +79,6 @@ repos:
     rev: v1.28.2
     hooks:
       - id: typos
-  - repo: https://github.com/markdownlint/markdownlint
-    rev: v0.13.0
-    hooks:
-      - id: markdownlint
-        name: Markdownlint
-        description: Run markdownlint on your Markdown files
-        entry: mdl --rules ~MD026 --style .markdown.rb
-        language: ruby
-        files: \.(md|mdown|markdown)$
   - repo: https://github.com/Yelp/detect-secrets
     rev: v1.5.0
     hooks:
@@ -96,3 +87,15 @@ repos:
         language: python
         entry: detect-secrets-hook
         args: ['']
+  - repo: https://github.com/rvben/rumdl-pre-commit
+    rev: v0.0.151  # Use the latest release tag
+    hooks:
+      - id: rumdl
+        # To only check (default):
+        # args: []
+        # To automatically fix issues:
+        # args: [--fix]
+  - repo: https://github.com/RobertCraigie/pyright-python
+    rev: v1.1.405   # pin a tag; latest as of 2025-10-01
+    hooks:
+      - id: pyright

From db766287b145a71861c371000a219c32c6e2fdf1 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Mon, 6 Oct 2025 13:50:36 -0500
Subject: [PATCH 159/167] Autoupdate pre-commit

---
 src/py/.pre-commit-config.yaml | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/src/py/.pre-commit-config.yaml b/src/py/.pre-commit-config.yaml
index ae6b484e..08e6633a 100644
--- a/src/py/.pre-commit-config.yaml
+++ b/src/py/.pre-commit-config.yaml
@@ -14,7 +14,7 @@ default_install_hook_types: [pre-commit, commit-msg]
 default_stages: [pre-commit]
 repos:
   - repo: https://github.com/pre-commit/pre-commit-hooks
-    rev: v3.2.0
+    rev: v6.0.0
     hooks:
       - id: trailing-whitespace
       - id: end-of-file-fixer
@@ -25,12 +25,12 @@ repos:
       - id: check-toml
       - id: debug-statements
   - repo: https://github.com/asottile/add-trailing-comma
-    rev: v3.1.0
+    rev: v3.2.0
     hooks:
       - id: add-trailing-comma
   - repo: https://github.com/astral-sh/ruff-pre-commit
     #  Ruff version.
-    rev: v0.12.10
+    rev: v0.13.3
     hooks:
       #  Run the linter.
       - id: ruff
@@ -40,7 +40,7 @@ repos:
         types_or: [python, pyi]
         #  options: ignore one line things [E701]
   - repo: https://github.com/adrienverge/yamllint
-    rev: v1.35.1
+    rev: v1.37.1
     hooks:
       - id: yamllint
         name: yamllint
@@ -55,7 +55,7 @@ repos:
           }\
         }"]
   - repo: https://github.com/rhysd/actionlint
-    rev: v1.7.4
+    rev: v1.7.7
     hooks:
       - id: actionlint
         name: Lint GitHub Actions workflow files
@@ -76,7 +76,7 @@ repos:
         args: [--staged, -c, "general.ignore=B6,T3", --msg-filename]
         stages: [commit-msg]
   - repo: https://github.com/crate-ci/typos
-    rev: v1.28.2
+    rev: v1
     hooks:
       - id: typos
   - repo: https://github.com/Yelp/detect-secrets
@@ -88,7 +88,7 @@ repos:
         entry: detect-secrets-hook
         args: ['']
   - repo: https://github.com/rvben/rumdl-pre-commit
-    rev: v0.0.151  # Use the latest release tag
+    rev: v0.0.153  # Use the latest release tag
     hooks:
       - id: rumdl
         # To only check (default):
@@ -96,6 +96,6 @@ repos:
         # To automatically fix issues:
         # args: [--fix]
   - repo: https://github.com/RobertCraigie/pyright-python
-    rev: v1.1.405   # pin a tag; latest as of 2025-10-01
+    rev: v1.1.406   # pin a tag; latest as of 2025-10-01
     hooks:
       - id: pyright

From 7deeee74af335133df28e9ce3233aa5b133a263d Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Mon, 6 Oct 2025 13:56:04 -0500
Subject: [PATCH 160/167] Direct pyright towards .venv in toml

---
 src/py/pyproject.toml | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/src/py/pyproject.toml b/src/py/pyproject.toml
index 633d6a64..273c5fd5 100644
--- a/src/py/pyproject.toml
+++ b/src/py/pyproject.toml
@@ -115,3 +115,7 @@ help = "Run test by test, slowly, quitting after first error"
 [tool.poe.tasks.filter-test]
 cmd = "pytest --log-level=1 -W error -vvvx -rA --capture=no --show-capture=no"
 help = "Run any/all tests one by one with basic settings: can include filename and -k filters"
+
+[tool.pyright]
+venvPath = "."
+venv = ".venv"

From 5193ab016fae915a19f99d8e5744e20083edcdef Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Mon, 6 Oct 2025 14:01:18 -0500
Subject: [PATCH 161/167] Revert "Autoupdate pre-commit"

This reverts commit db766287b145a71861c371000a219c32c6e2fdf1.
---
 src/py/.pre-commit-config.yaml | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/src/py/.pre-commit-config.yaml b/src/py/.pre-commit-config.yaml
index 08e6633a..ae6b484e 100644
--- a/src/py/.pre-commit-config.yaml
+++ b/src/py/.pre-commit-config.yaml
@@ -14,7 +14,7 @@ default_install_hook_types: [pre-commit, commit-msg]
 default_stages: [pre-commit]
 repos:
   - repo: https://github.com/pre-commit/pre-commit-hooks
-    rev: v6.0.0
+    rev: v3.2.0
     hooks:
       - id: trailing-whitespace
       - id: end-of-file-fixer
@@ -25,12 +25,12 @@ repos:
       - id: check-toml
       - id: debug-statements
   - repo: https://github.com/asottile/add-trailing-comma
-    rev: v3.2.0
+    rev: v3.1.0
     hooks:
       - id: add-trailing-comma
   - repo: https://github.com/astral-sh/ruff-pre-commit
     #  Ruff version.
-    rev: v0.13.3
+    rev: v0.12.10
     hooks:
       #  Run the linter.
       - id: ruff
@@ -40,7 +40,7 @@ repos:
         types_or: [python, pyi]
         #  options: ignore one line things [E701]
   - repo: https://github.com/adrienverge/yamllint
-    rev: v1.37.1
+    rev: v1.35.1
     hooks:
       - id: yamllint
         name: yamllint
@@ -55,7 +55,7 @@ repos:
           }\
         }"]
   - repo: https://github.com/rhysd/actionlint
-    rev: v1.7.7
+    rev: v1.7.4
     hooks:
       - id: actionlint
         name: Lint GitHub Actions workflow files
@@ -76,7 +76,7 @@ repos:
         args: [--staged, -c, "general.ignore=B6,T3", --msg-filename]
         stages: [commit-msg]
   - repo: https://github.com/crate-ci/typos
-    rev: v1
+    rev: v1.28.2
     hooks:
       - id: typos
   - repo: https://github.com/Yelp/detect-secrets
@@ -88,7 +88,7 @@ repos:
         entry: detect-secrets-hook
         args: ['']
   - repo: https://github.com/rvben/rumdl-pre-commit
-    rev: v0.0.153  # Use the latest release tag
+    rev: v0.0.151  # Use the latest release tag
     hooks:
       - id: rumdl
         # To only check (default):
@@ -96,6 +96,6 @@ repos:
         # To automatically fix issues:
         # args: [--fix]
   - repo: https://github.com/RobertCraigie/pyright-python
-    rev: v1.1.406   # pin a tag; latest as of 2025-10-01
+    rev: v1.1.405   # pin a tag; latest as of 2025-10-01
     hooks:
       - id: pyright

From 3e472afb406d2caa74eedbe7ff4c47019776bb08 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Mon, 6 Oct 2025 14:01:55 -0500
Subject: [PATCH 162/167] Review non-function pyright directive.

---
 src/py/pyproject.toml | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/src/py/pyproject.toml b/src/py/pyproject.toml
index 273c5fd5..633d6a64 100644
--- a/src/py/pyproject.toml
+++ b/src/py/pyproject.toml
@@ -115,7 +115,3 @@ help = "Run test by test, slowly, quitting after first error"
 [tool.poe.tasks.filter-test]
 cmd = "pytest --log-level=1 -W error -vvvx -rA --capture=no --show-capture=no"
 help = "Run any/all tests one by one with basic settings: can include filename and -k filters"
-
-[tool.pyright]
-venvPath = "."
-venv = ".venv"

From 95667dc6b494e9853049d9bc1f17e64660ac2be7 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Mon, 6 Oct 2025 14:22:56 -0500
Subject: [PATCH 163/167] Fix precommit.

---
 src/py/.pre-commit-config.yaml | 17 +++++++++--------
 src/py/pyproject.toml          |  6 ++++++
 2 files changed, 15 insertions(+), 8 deletions(-)

diff --git a/src/py/.pre-commit-config.yaml b/src/py/.pre-commit-config.yaml
index ae6b484e..5a407694 100644
--- a/src/py/.pre-commit-config.yaml
+++ b/src/py/.pre-commit-config.yaml
@@ -14,7 +14,7 @@ default_install_hook_types: [pre-commit, commit-msg]
 default_stages: [pre-commit]
 repos:
   - repo: https://github.com/pre-commit/pre-commit-hooks
-    rev: v3.2.0
+    rev: v6.0.0
     hooks:
       - id: trailing-whitespace
       - id: end-of-file-fixer
@@ -25,12 +25,12 @@ repos:
       - id: check-toml
       - id: debug-statements
   - repo: https://github.com/asottile/add-trailing-comma
-    rev: v3.1.0
+    rev: v3.2.0
     hooks:
       - id: add-trailing-comma
   - repo: https://github.com/astral-sh/ruff-pre-commit
     #  Ruff version.
-    rev: v0.12.10
+    rev: v0.13.3
     hooks:
       #  Run the linter.
       - id: ruff
@@ -40,7 +40,7 @@ repos:
         types_or: [python, pyi]
         #  options: ignore one line things [E701]
   - repo: https://github.com/adrienverge/yamllint
-    rev: v1.35.1
+    rev: v1.37.1
     hooks:
       - id: yamllint
         name: yamllint
@@ -55,7 +55,7 @@ repos:
           }\
         }"]
   - repo: https://github.com/rhysd/actionlint
-    rev: v1.7.4
+    rev: v1.7.7
     hooks:
       - id: actionlint
         name: Lint GitHub Actions workflow files
@@ -76,7 +76,7 @@ repos:
         args: [--staged, -c, "general.ignore=B6,T3", --msg-filename]
         stages: [commit-msg]
   - repo: https://github.com/crate-ci/typos
-    rev: v1.28.2
+    rev: v1
     hooks:
       - id: typos
   - repo: https://github.com/Yelp/detect-secrets
@@ -88,7 +88,7 @@ repos:
         entry: detect-secrets-hook
         args: ['']
   - repo: https://github.com/rvben/rumdl-pre-commit
-    rev: v0.0.151  # Use the latest release tag
+    rev: v0.0.153  # Use the latest release tag
     hooks:
       - id: rumdl
         # To only check (default):
@@ -96,6 +96,7 @@ repos:
         # To automatically fix issues:
         # args: [--fix]
   - repo: https://github.com/RobertCraigie/pyright-python
-    rev: v1.1.405   # pin a tag; latest as of 2025-10-01
+    rev: v1.1.406   # pin a tag; latest as of 2025-10-01
     hooks:
       - id: pyright
+        args: ["--verbose", "--project=src/py"]
diff --git a/src/py/pyproject.toml b/src/py/pyproject.toml
index 633d6a64..d44301ac 100644
--- a/src/py/pyproject.toml
+++ b/src/py/pyproject.toml
@@ -54,6 +54,7 @@ dev = [
   "pandas>=2.0.3",
   "typing-extensions>=4.12.2",
   "hypothesis>=6.113.0",
+  "pyright>=1.1.406",
 ]
 
 pickles = [
@@ -115,3 +116,8 @@ help = "Run test by test, slowly, quitting after first error"
 [tool.poe.tasks.filter-test]
 cmd = "pytest --log-level=1 -W error -vvvx -rA --capture=no --show-capture=no"
 help = "Run any/all tests one by one with basic settings: can include filename and -k filters"
+
+[tool.pyright]
+venvPath = "."
+venv = ".venv"
+exclude= ["src/py/integration_tests/dates/*"]

From 4fa305b7ef16b6e9f8a2acc2c0d45f6032d426b0 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Mon, 6 Oct 2025 14:30:13 -0500
Subject: [PATCH 164/167] Add windows hang tests.

---
 src/py/.pre-commit-config.yaml |  2 +-
 src/py/pyproject.toml          |  1 +
 src/py/tests/test_init.py      | 32 +++++++++++++++++----
 src/py/uv.lock                 | 52 +++++++++++++++++++++++++++++++++-
 4 files changed, 79 insertions(+), 8 deletions(-)

diff --git a/src/py/.pre-commit-config.yaml b/src/py/.pre-commit-config.yaml
index 5a407694..41499ae6 100644
--- a/src/py/.pre-commit-config.yaml
+++ b/src/py/.pre-commit-config.yaml
@@ -99,4 +99,4 @@ repos:
     rev: v1.1.406   # pin a tag; latest as of 2025-10-01
     hooks:
       - id: pyright
-        args: ["--verbose", "--project=src/py"]
+        args: ["--project=src/py"]
diff --git a/src/py/pyproject.toml b/src/py/pyproject.toml
index d44301ac..94953e7a 100644
--- a/src/py/pyproject.toml
+++ b/src/py/pyproject.toml
@@ -54,6 +54,7 @@ dev = [
   "pandas>=2.0.3",
   "typing-extensions>=4.12.2",
   "hypothesis>=6.113.0",
+  "pytest-forked>=1.6.0",
   "pyright>=1.1.406",
 ]
 
diff --git a/src/py/tests/test_init.py b/src/py/tests/test_init.py
index 24d36df7..713ecf33 100644
--- a/src/py/tests/test_init.py
+++ b/src/py/tests/test_init.py
@@ -8,9 +8,7 @@
 import kaleido
 
 if TYPE_CHECKING:
-    from typing import Any
-
-    _: Any
+    from kaleido._utils.fig_tools import Figurish
 
 
 # Just tests wrapping, but in a way tests internals.
@@ -33,6 +31,17 @@ def kwargs():
 _ = kaleido._sync_server.GlobalKaleidoServer.open  # noqa: SLF001
 
 
+@pytest.mark.forked
+def test_closing_no_close():
+    kaleido.start_sync_server()
+
+
+@pytest.mark.forked
+def test_open_close():
+    kaleido.start_sync_server()
+    kaleido.stop_sync_server()
+
+
 @patch("kaleido._sync_server.GlobalKaleidoServer.open")
 def test_start_sync_server_passes_args(mock_open, args, kwargs):
     """Test that start_sync_server passes args and silence_warnings correctly."""
@@ -88,7 +97,12 @@ async def test_async_wrapper_functions(mock_kaleido_class):
     topojson = "test_topojson"
     kopts = {"some_option": "value"}
 
-    result = await kaleido.calc_fig(fig, opts, topojson=topojson, kopts=kopts)
+    result = await kaleido.calc_fig(
+        fig,
+        opts,  # type: ignore[reportArgumentType]
+        topojson=topojson,
+        kopts=kopts,
+    )
 
     expected_kopts = {"some_option": "value", "n": 1}
     mock_kaleido_class.assert_called_with(**expected_kopts)
@@ -112,7 +126,13 @@ async def test_async_wrapper_functions(mock_kaleido_class):
     mock_kaleido.write_fig.reset_mock()
 
     # Test write_fig with full arguments
-    await kaleido.write_fig(fig, path, opts, topojson=topojson, kopts=kopts)
+    await kaleido.write_fig(
+        fig,
+        path,
+        opts,  # type: ignore[reportArgumentType]
+        topojson=topojson,
+        kopts=kopts,
+    )
     mock_kaleido_class.assert_called_with(**kopts)  # write_fig doesn't force n=1
     mock_kaleido.write_fig.assert_called_with(
         fig,
@@ -134,7 +154,7 @@ async def test_async_wrapper_functions(mock_kaleido_class):
     mock_kaleido.write_fig_from_object.reset_mock()
 
     # Test write_fig_from_object
-    generator = [{"data": []}]
+    generator: list[Figurish] = [{"data": []}]
     await kaleido.write_fig_from_object(generator, kopts=kopts)
     mock_kaleido_class.assert_called_with(**kopts)
     mock_kaleido.write_fig_from_object.assert_called_with(generator)
diff --git a/src/py/uv.lock b/src/py/uv.lock
index 42dd8add..38e303b2 100644
--- a/src/py/uv.lock
+++ b/src/py/uv.lock
@@ -380,7 +380,7 @@ version = "1.3.0"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "typing-extensions", version = "4.13.2", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.9'" },
-    { name = "typing-extensions", version = "4.15.0", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.9' and python_full_version < '3.13'" },
+    { name = "typing-extensions", version = "4.15.0", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.9' and python_full_version < '3.11'" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/0b/9f/a65090624ecf468cdca03533906e7c69ed7588582240cfe7cc9e770b50eb/exceptiongroup-1.3.0.tar.gz", hash = "sha256:b241f5885f560bc56a59ee63ca4c6a8bfa46ae4ad651af316d4e81817bb9fd88", size = 29749, upload-time = "2025-05-10T17:42:51.123Z" }
 wheels = [
@@ -496,10 +496,12 @@ dev = [
     { name = "plotly", extra = ["express"] },
     { name = "poethepoet", version = "0.30.0", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.9'" },
     { name = "poethepoet", version = "0.37.0", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.9'" },
+    { name = "pyright" },
     { name = "pytest", version = "8.3.5", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.9'" },
     { name = "pytest", version = "8.4.2", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.9'" },
     { name = "pytest-asyncio", version = "0.24.0", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.9'" },
     { name = "pytest-asyncio", version = "1.2.0", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.9'" },
+    { name = "pytest-forked" },
     { name = "pytest-order" },
     { name = "pytest-xdist", version = "3.6.1", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.9'" },
     { name = "pytest-xdist", version = "3.8.0", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.9'" },
@@ -535,8 +537,10 @@ dev = [
     { name = "pandas", specifier = ">=2.0.3" },
     { name = "plotly", extras = ["express"], specifier = ">=6.1.1" },
     { name = "poethepoet", specifier = ">=0.30.0" },
+    { name = "pyright", specifier = ">=1.1.406" },
     { name = "pytest" },
     { name = "pytest-asyncio" },
+    { name = "pytest-forked", specifier = ">=1.6.0" },
     { name = "pytest-order", specifier = ">=1.3.0" },
     { name = "pytest-xdist" },
     { name = "typing-extensions", specifier = ">=4.12.2" },
@@ -820,6 +824,15 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/f8/5a/22741c5c0e5f6e8050242bfc2052ba68bc94b1735ed5bca35404d136d6ec/narwhals-2.5.0-py3-none-any.whl", hash = "sha256:7e213f9ca7db3f8bf6f7eff35eaee6a1cf80902997e1b78d49b7755775d8f423", size = 407296, upload-time = "2025-09-12T10:04:22.524Z" },
 ]
 
+[[package]]
+name = "nodeenv"
+version = "1.9.1"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/43/16/fc88b08840de0e0a72a2f9d8c6bae36be573e475a6326ae854bcc549fc45/nodeenv-1.9.1.tar.gz", hash = "sha256:6ec12890a2dab7946721edbfbcd91f3319c6ccc9aec47be7c7e6b7011ee6645f", size = 47437, upload-time = "2024-06-04T18:44:11.171Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/d2/1d/1b658dbd2b9fa9c4c9f32accbfc0205d532c8c6194dc0f2a4c0428e7128a/nodeenv-1.9.1-py2.py3-none-any.whl", hash = "sha256:ba11c9782d29c27c70ffbdda2d7415098754709be8a7056d79a737cd901155c9", size = 22314, upload-time = "2024-06-04T18:44:08.352Z" },
+]
+
 [[package]]
 name = "numba"
 version = "0.58.1"
@@ -1823,6 +1836,15 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/92/1b/5337af1a6a478d25a3e3c56b9b4b42b0a160314e02f4a0498d5322c8dac4/poethepoet-0.37.0-py3-none-any.whl", hash = "sha256:861790276315abcc8df1b4bd60e28c3d48a06db273edd3092f3c94e1a46e5e22", size = 90062, upload-time = "2025-08-11T18:00:27.595Z" },
 ]
 
+[[package]]
+name = "py"
+version = "1.11.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/98/ff/fec109ceb715d2a6b4c4a85a61af3b40c723a961e8828319fbcb15b868dc/py-1.11.0.tar.gz", hash = "sha256:51c75c4126074b472f746a24399ad32f6053d1b34b68d2fa41e558e6f4a98719", size = 207796, upload-time = "2021-11-04T17:17:01.377Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/f6/f0/10642828a8dfb741e5f3fbaac830550a518a775c7fff6f04a007259b0548/py-1.11.0-py2.py3-none-any.whl", hash = "sha256:607c53218732647dff4acdfcd50cb62615cedf612e72d1724fb1a0cc6405b378", size = 98708, upload-time = "2021-11-04T17:17:00.152Z" },
+]
+
 [[package]]
 name = "pycparser"
 version = "2.23"
@@ -1854,6 +1876,20 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/c7/21/705964c7812476f378728bdf590ca4b771ec72385c533964653c68e86bdc/pygments-2.19.2-py3-none-any.whl", hash = "sha256:86540386c03d588bb81d44bc3928634ff26449851e99741617ecb9037ee5ec0b", size = 1225217, upload-time = "2025-06-21T13:39:07.939Z" },
 ]
 
+[[package]]
+name = "pyright"
+version = "1.1.406"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "nodeenv" },
+    { name = "typing-extensions", version = "4.13.2", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.9'" },
+    { name = "typing-extensions", version = "4.15.0", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.9'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/f7/16/6b4fbdd1fef59a0292cbb99f790b44983e390321eccbc5921b4d161da5d1/pyright-1.1.406.tar.gz", hash = "sha256:c4872bc58c9643dac09e8a2e74d472c62036910b3bd37a32813989ef7576ea2c", size = 4113151, upload-time = "2025-10-02T01:04:45.488Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/f6/a2/e309afbb459f50507103793aaef85ca4348b66814c86bc73908bdeb66d12/pyright-1.1.406-py3-none-any.whl", hash = "sha256:1d81fb43c2407bf566e97e57abb01c811973fdb21b2df8df59f870f688bdca71", size = 5980982, upload-time = "2025-10-02T01:04:43.137Z" },
+]
+
 [[package]]
 name = "pytest"
 version = "8.3.5"
@@ -1933,6 +1969,20 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/04/93/2fa34714b7a4ae72f2f8dad66ba17dd9a2c793220719e736dda28b7aec27/pytest_asyncio-1.2.0-py3-none-any.whl", hash = "sha256:8e17ae5e46d8e7efe51ab6494dd2010f4ca8dae51652aa3c8d55acf50bfb2e99", size = 15095, upload-time = "2025-09-12T07:33:52.639Z" },
 ]
 
+[[package]]
+name = "pytest-forked"
+version = "1.6.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "py" },
+    { name = "pytest", version = "8.3.5", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.9'" },
+    { name = "pytest", version = "8.4.2", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.9'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/8c/c9/93ad2ba2413057ee694884b88cf7467a46c50c438977720aeac26e73fdb7/pytest-forked-1.6.0.tar.gz", hash = "sha256:4dafd46a9a600f65d822b8f605133ecf5b3e1941ebb3588e943b4e3eb71a5a3f", size = 9977, upload-time = "2023-02-12T23:22:27.544Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/f4/af/9c0bda43e486a3c9bf1e0f876d0f241bc3f229d7d65d09331a0868db9629/pytest_forked-1.6.0-py3-none-any.whl", hash = "sha256:810958f66a91afb1a1e2ae83089d8dc1cd2437ac96b12963042fbb9fb4d16af0", size = 4897, upload-time = "2023-02-12T23:22:26.022Z" },
+]
+
 [[package]]
 name = "pytest-order"
 version = "1.3.0"

From be08b7abe47e5ca13005d791dbc4a52ccab136ff Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Mon, 6 Oct 2025 14:31:02 -0500
Subject: [PATCH 165/167] Remove 3.8 testing, ad 3.11

---
 .github/workflows/publish_testpypi.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/publish_testpypi.yml b/.github/workflows/publish_testpypi.yml
index be56130a..73de2001 100644
--- a/.github/workflows/publish_testpypi.yml
+++ b/.github/workflows/publish_testpypi.yml
@@ -12,7 +12,7 @@ jobs:
       max-parallel: 2
       matrix:
         os: [ubuntu-latest, windows-latest, macos-latest]
-        python_v: ['3.8', '3.9', '3.10', '']
+        python_v: ['3.9', '3.10', '3.11', '']
         # chrome_v: ['-1']
     defaults:
       run:

From d73f6cef0a4a2789ac1b186547ab7a264b2a8078 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Mon, 6 Oct 2025 16:03:39 -0500
Subject: [PATCH 166/167] Change testing strategy for hangers.

---
 src/py/pyproject.toml                       |  1 -
 src/py/tests/test_init.py                   | 16 ++++++-------
 src/py/tests/win_hang_scripts/open.py       |  5 +++++
 src/py/tests/win_hang_scripts/open_close.py |  6 +++++
 src/py/uv.lock                              | 25 ---------------------
 5 files changed, 18 insertions(+), 35 deletions(-)
 create mode 100644 src/py/tests/win_hang_scripts/open.py
 create mode 100644 src/py/tests/win_hang_scripts/open_close.py

diff --git a/src/py/pyproject.toml b/src/py/pyproject.toml
index 94953e7a..d44301ac 100644
--- a/src/py/pyproject.toml
+++ b/src/py/pyproject.toml
@@ -54,7 +54,6 @@ dev = [
   "pandas>=2.0.3",
   "typing-extensions>=4.12.2",
   "hypothesis>=6.113.0",
-  "pytest-forked>=1.6.0",
   "pyright>=1.1.406",
 ]
 
diff --git a/src/py/tests/test_init.py b/src/py/tests/test_init.py
index 713ecf33..3574be76 100644
--- a/src/py/tests/test_init.py
+++ b/src/py/tests/test_init.py
@@ -1,5 +1,8 @@
 """Tests for wrapper functions in __init__.py that test argument passing."""
 
+import subprocess
+import sys
+from pathlib import Path
 from typing import TYPE_CHECKING
 from unittest.mock import AsyncMock, patch
 
@@ -31,15 +34,10 @@ def kwargs():
 _ = kaleido._sync_server.GlobalKaleidoServer.open  # noqa: SLF001
 
 
-@pytest.mark.forked
-def test_closing_no_close():
-    kaleido.start_sync_server()
-
-
-@pytest.mark.forked
-def test_open_close():
-    kaleido.start_sync_server()
-    kaleido.stop_sync_server()
+def test_hangers():
+    folder = Path(__file__).parent / "win_hang_scripts"
+    subprocess.run([sys.executable, str(folder / "open_close.py")], check=True)  # noqa: S603
+    subprocess.run([sys.executable, str(folder / "open.py")], check=True)  # noqa: S603
 
 
 @patch("kaleido._sync_server.GlobalKaleidoServer.open")
diff --git a/src/py/tests/win_hang_scripts/open.py b/src/py/tests/win_hang_scripts/open.py
new file mode 100644
index 00000000..3b2a5d72
--- /dev/null
+++ b/src/py/tests/win_hang_scripts/open.py
@@ -0,0 +1,5 @@
+import kaleido
+
+
+def test_closing_no_close():
+    kaleido.start_sync_server()
diff --git a/src/py/tests/win_hang_scripts/open_close.py b/src/py/tests/win_hang_scripts/open_close.py
new file mode 100644
index 00000000..ea9eb918
--- /dev/null
+++ b/src/py/tests/win_hang_scripts/open_close.py
@@ -0,0 +1,6 @@
+import kaleido
+
+
+def test_open_close():
+    kaleido.start_sync_server()
+    kaleido.stop_sync_server()
diff --git a/src/py/uv.lock b/src/py/uv.lock
index 38e303b2..e528bd2e 100644
--- a/src/py/uv.lock
+++ b/src/py/uv.lock
@@ -501,7 +501,6 @@ dev = [
     { name = "pytest", version = "8.4.2", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.9'" },
     { name = "pytest-asyncio", version = "0.24.0", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.9'" },
     { name = "pytest-asyncio", version = "1.2.0", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.9'" },
-    { name = "pytest-forked" },
     { name = "pytest-order" },
     { name = "pytest-xdist", version = "3.6.1", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.9'" },
     { name = "pytest-xdist", version = "3.8.0", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.9'" },
@@ -540,7 +539,6 @@ dev = [
     { name = "pyright", specifier = ">=1.1.406" },
     { name = "pytest" },
     { name = "pytest-asyncio" },
-    { name = "pytest-forked", specifier = ">=1.6.0" },
     { name = "pytest-order", specifier = ">=1.3.0" },
     { name = "pytest-xdist" },
     { name = "typing-extensions", specifier = ">=4.12.2" },
@@ -1836,15 +1834,6 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/92/1b/5337af1a6a478d25a3e3c56b9b4b42b0a160314e02f4a0498d5322c8dac4/poethepoet-0.37.0-py3-none-any.whl", hash = "sha256:861790276315abcc8df1b4bd60e28c3d48a06db273edd3092f3c94e1a46e5e22", size = 90062, upload-time = "2025-08-11T18:00:27.595Z" },
 ]
 
-[[package]]
-name = "py"
-version = "1.11.0"
-source = { registry = "https://pypi.org/simple" }
-sdist = { url = "https://files.pythonhosted.org/packages/98/ff/fec109ceb715d2a6b4c4a85a61af3b40c723a961e8828319fbcb15b868dc/py-1.11.0.tar.gz", hash = "sha256:51c75c4126074b472f746a24399ad32f6053d1b34b68d2fa41e558e6f4a98719", size = 207796, upload-time = "2021-11-04T17:17:01.377Z" }
-wheels = [
-    { url = "https://files.pythonhosted.org/packages/f6/f0/10642828a8dfb741e5f3fbaac830550a518a775c7fff6f04a007259b0548/py-1.11.0-py2.py3-none-any.whl", hash = "sha256:607c53218732647dff4acdfcd50cb62615cedf612e72d1724fb1a0cc6405b378", size = 98708, upload-time = "2021-11-04T17:17:00.152Z" },
-]
-
 [[package]]
 name = "pycparser"
 version = "2.23"
@@ -1969,20 +1958,6 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/04/93/2fa34714b7a4ae72f2f8dad66ba17dd9a2c793220719e736dda28b7aec27/pytest_asyncio-1.2.0-py3-none-any.whl", hash = "sha256:8e17ae5e46d8e7efe51ab6494dd2010f4ca8dae51652aa3c8d55acf50bfb2e99", size = 15095, upload-time = "2025-09-12T07:33:52.639Z" },
 ]
 
-[[package]]
-name = "pytest-forked"
-version = "1.6.0"
-source = { registry = "https://pypi.org/simple" }
-dependencies = [
-    { name = "py" },
-    { name = "pytest", version = "8.3.5", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.9'" },
-    { name = "pytest", version = "8.4.2", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.9'" },
-]
-sdist = { url = "https://files.pythonhosted.org/packages/8c/c9/93ad2ba2413057ee694884b88cf7467a46c50c438977720aeac26e73fdb7/pytest-forked-1.6.0.tar.gz", hash = "sha256:4dafd46a9a600f65d822b8f605133ecf5b3e1941ebb3588e943b4e3eb71a5a3f", size = 9977, upload-time = "2023-02-12T23:22:27.544Z" }
-wheels = [
-    { url = "https://files.pythonhosted.org/packages/f4/af/9c0bda43e486a3c9bf1e0f876d0f241bc3f229d7d65d09331a0868db9629/pytest_forked-1.6.0-py3-none-any.whl", hash = "sha256:810958f66a91afb1a1e2ae83089d8dc1cd2437ac96b12963042fbb9fb4d16af0", size = 4897, upload-time = "2023-02-12T23:22:26.022Z" },
-]
-
 [[package]]
 name = "pytest-order"
 version = "1.3.0"

From 7e7e983abb1ba7c1a773cb0e3685d881ad927348 Mon Sep 17 00:00:00 2001
From: Andrew Pikul <ajpikul@gmail.com>
Date: Mon, 6 Oct 2025 16:11:47 -0500
Subject: [PATCH 167/167] Update pre-commit.

---
 src/py/.pre-commit-config.yaml | 34 +++++++++++++++++++---------------
 src/py/pyproject.toml          |  6 ++++++
 2 files changed, 25 insertions(+), 15 deletions(-)

diff --git a/src/py/.pre-commit-config.yaml b/src/py/.pre-commit-config.yaml
index 5f875d93..41499ae6 100644
--- a/src/py/.pre-commit-config.yaml
+++ b/src/py/.pre-commit-config.yaml
@@ -14,7 +14,7 @@ default_install_hook_types: [pre-commit, commit-msg]
 default_stages: [pre-commit]
 repos:
   - repo: https://github.com/pre-commit/pre-commit-hooks
-    rev: v3.2.0
+    rev: v6.0.0
     hooks:
       - id: trailing-whitespace
       - id: end-of-file-fixer
@@ -25,12 +25,12 @@ repos:
       - id: check-toml
       - id: debug-statements
   - repo: https://github.com/asottile/add-trailing-comma
-    rev: v3.1.0
+    rev: v3.2.0
     hooks:
       - id: add-trailing-comma
   - repo: https://github.com/astral-sh/ruff-pre-commit
     #  Ruff version.
-    rev: v0.12.10
+    rev: v0.13.3
     hooks:
       #  Run the linter.
       - id: ruff
@@ -40,7 +40,7 @@ repos:
         types_or: [python, pyi]
         #  options: ignore one line things [E701]
   - repo: https://github.com/adrienverge/yamllint
-    rev: v1.35.1
+    rev: v1.37.1
     hooks:
       - id: yamllint
         name: yamllint
@@ -55,7 +55,7 @@ repos:
           }\
         }"]
   - repo: https://github.com/rhysd/actionlint
-    rev: v1.7.4
+    rev: v1.7.7
     hooks:
       - id: actionlint
         name: Lint GitHub Actions workflow files
@@ -76,18 +76,9 @@ repos:
         args: [--staged, -c, "general.ignore=B6,T3", --msg-filename]
         stages: [commit-msg]
   - repo: https://github.com/crate-ci/typos
-    rev: v1.28.2
+    rev: v1
     hooks:
       - id: typos
-  - repo: https://github.com/markdownlint/markdownlint
-    rev: v0.13.0
-    hooks:
-      - id: markdownlint
-        name: Markdownlint
-        description: Run markdownlint on your Markdown files
-        entry: mdl --rules ~MD026 --style .markdown.rb
-        language: ruby
-        files: \.(md|mdown|markdown)$
   - repo: https://github.com/Yelp/detect-secrets
     rev: v1.5.0
     hooks:
@@ -96,3 +87,16 @@ repos:
         language: python
         entry: detect-secrets-hook
         args: ['']
+  - repo: https://github.com/rvben/rumdl-pre-commit
+    rev: v0.0.153  # Use the latest release tag
+    hooks:
+      - id: rumdl
+        # To only check (default):
+        # args: []
+        # To automatically fix issues:
+        # args: [--fix]
+  - repo: https://github.com/RobertCraigie/pyright-python
+    rev: v1.1.406   # pin a tag; latest as of 2025-10-01
+    hooks:
+      - id: pyright
+        args: ["--project=src/py"]
diff --git a/src/py/pyproject.toml b/src/py/pyproject.toml
index 633d6a64..d44301ac 100644
--- a/src/py/pyproject.toml
+++ b/src/py/pyproject.toml
@@ -54,6 +54,7 @@ dev = [
   "pandas>=2.0.3",
   "typing-extensions>=4.12.2",
   "hypothesis>=6.113.0",
+  "pyright>=1.1.406",
 ]
 
 pickles = [
@@ -115,3 +116,8 @@ help = "Run test by test, slowly, quitting after first error"
 [tool.poe.tasks.filter-test]
 cmd = "pytest --log-level=1 -W error -vvvx -rA --capture=no --show-capture=no"
 help = "Run any/all tests one by one with basic settings: can include filename and -k filters"
+
+[tool.pyright]
+venvPath = "."
+venv = ".venv"
+exclude= ["src/py/integration_tests/dates/*"]