better-rtplot 0.4.10__tar.gz → 0.4.14__tar.gz

better_rtplot-0.4.14/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 jmontp
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

{better_rtplot-0.4.10 → better_rtplot-0.4.14}/PKG-INFO

@@ -1,12 +1,12 @@
 Metadata-Version: 2.1
 Name: better-rtplot
-Version: 0.4.10
+Version: 0.4.14
 Summary: 
-License: GPL V3.0
+License: MIT
 Author: jmontp
 Author-email: jmontp@umich.edu
 Requires-Python: >=3.9,<3.13
-Classifier: License :: Other/Proprietary License
+Classifier: License :: OSI Approved :: MIT License
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
@@ -127,8 +127,10 @@ A rising line now draws itself in the browser tab.
 - **Config lives with the data.** The sender declares plot layout.
 - **Interactive controls.** Buttons, sliders, dials, displays — polled
   from your loop, no threads, no callbacks.
+- **LaTeX labels.** Use `$...$` or `\(...\)` in plot and control text;
+  the server bundles KaTeX and works offline.
 - **Static HTML snapshots.** `save_snapshot("out.html")` writes a
-  self-contained ~65 KB file with the current trace embedded.
+  self-contained file with the current trace and math rendering embedded.
 
 ---
 

{better_rtplot-0.4.10 → better_rtplot-0.4.14}/README.md

@@ -103,8 +103,10 @@ A rising line now draws itself in the browser tab.
 - **Config lives with the data.** The sender declares plot layout.
 - **Interactive controls.** Buttons, sliders, dials, displays — polled
   from your loop, no threads, no callbacks.
+- **LaTeX labels.** Use `$...$` or `\(...\)` in plot and control text;
+  the server bundles KaTeX and works offline.
 - **Static HTML snapshots.** `save_snapshot("out.html")` writes a
-  self-contained ~65 KB file with the current trace embedded.
+  self-contained file with the current trace and math rendering embedded.
 
 ---
 

{better_rtplot-0.4.10 → better_rtplot-0.4.14}/pyproject.toml

@@ -1,9 +1,9 @@
 [tool.poetry]
 name = "better-rtplot"
-version = "0.4.10"
+version = "0.4.14"
 description = ""
 authors = ["jmontp <jmontp@umich.edu>"]
-license = "GPL V3.0"
+license = "MIT"
 readme = "README.md"
 packages = [{include = "rtplot"}]
 include = ["rtplot/static/*", "rtplot/static/katex/*", "rtplot/static/katex/fonts/*"]

{better_rtplot-0.4.10 → better_rtplot-0.4.14}/rtplot/client.py

@@ -22,7 +22,7 @@ socket = context.socket(zmq.PUB)
 control_socket = context.socket(zmq.PULL)
 control_socket.setsockopt(zmq.RCVHWM, 1000)
 #Non-blocking local state for controls, drained on each poll_controls() call
-_control_slider_values = {}
+_control_values = {}
 _control_button_events = []
 
 # Cached payload of the most recent initialize_plots() call. The server
@@ -90,6 +90,7 @@ else:
 SENDING_PLOT_UPDATE = "0"
 SENDING_DATA = "1"
 SENDING_DISPLAY = "4"
+SENDING_TEXT_INPUT = "5"
 
 #Lightweight result type returned by poll_controls()
 ControlState = namedtuple("ControlState", ["values", "buttons"])
@@ -138,6 +139,7 @@ class Plot:
     names: List[str]
     colors: Optional[List[str]] = None
     line_style: Optional[List[str]] = None
+    show: Optional[List[bool]] = None
     line_width: Optional[float] = None
     title: Optional[str] = None
     xlabel: Optional[str] = None
@@ -151,6 +153,7 @@ class Plot:
             "names": list(self.names),
             "colors": list(self.colors) if self.colors is not None else None,
             "line_style": list(self.line_style) if self.line_style is not None else None,
+            "show": list(self.show) if self.show is not None else None,
             "line_width": self.line_width,
             "title": self.title,
             "xlabel": self.xlabel,
@@ -247,10 +250,27 @@ class Text:
         })
 
 
+@dataclass
+class TextInput:
+    id: str
+    label: str
+    value: str = ""
+    placeholder: Optional[str] = None
+    max_length: Optional[int] = None
+    height: Optional[float] = None
+
+    def to_dict(self):
+        return _drop_none({
+            "type": "text_input", "id": self.id, "label": self.label,
+            "value": self.value, "placeholder": self.placeholder,
+            "max_length": self.max_length, "height": self.height,
+        })
+
+
 @dataclass
 class ControlsRow:
     """A row of control widgets, rendered in place of a plot."""
-    controls: List[Union[Button, Slider, Dial, Display, Text, dict]] = field(default_factory=list)
+    controls: List[Union[Button, Slider, Dial, Display, Text, TextInput, dict]] = field(default_factory=list)
 
     def to_dict(self):
         return {"controls": [
@@ -536,7 +556,9 @@ def _send_initialize_with_handshake(cfg, timeout):
             elif evtype == "button":
                 _control_button_events.append(event.get("id"))
             elif evtype == "slider":
-                _control_slider_values[event.get("id")] = float(event.get("value", 0.0))
+                _control_values[event.get("id")] = float(event.get("value", 0.0))
+            elif evtype == "text":
+                _control_values[event.get("id")] = str(event.get("value", ""))
             # Unknown / resend_config: ignore during handshake.
         # Resend if the window elapsed without an ack; PUB/SUB will
         # drop the first send during slow-join but retries land.
@@ -571,12 +593,24 @@ def set_display(display_id: str, value):
     socket.send_json({"id": str(display_id), "value": payload_value})
 
 
+def set_text_input(input_id: str, value):
+    """Push a text_input control value to the browser and server state.
+
+    This is the editable-control companion to set_display(). It updates
+    declared 'text_input' controls without rebuilding the full plot config,
+    and the server keeps the value as the current control state returned by
+    poll_controls().
+    """
+    socket.send_string(SENDING_TEXT_INPUT, zmq.SNDMORE)
+    socket.send_json({"id": str(input_id), "value": str(value)})
+
+
 def poll_controls():
     """Drain the return channel non-blocking and return current control state.
 
     Returns a ControlState(values, buttons) where:
-      - values: dict of {slider_id: float} with the latest value of every
-        slider the server has told us about since process start.
+      - values: dict of latest control values keyed by id. Sliders/dials
+        remain floats; text_input controls remain strings.
       - buttons: list of button ids that fired since the previous poll
         (cleared after this call).
 
@@ -587,7 +621,7 @@ def poll_controls():
     Reconnect button on a tab), it asks us to re-publish the cached
     initialize_plots() payload so the plot rewires without the user
     restarting their script. The request is consumed silently — the
-    returned ControlState only ever contains slider/button events.
+    returned ControlState only ever contains control/button events.
     """
     global _control_button_events
     while True:
@@ -601,7 +635,9 @@ def poll_controls():
         if evtype == "button":
             _control_button_events.append(event.get("id"))
         elif evtype == "slider":
-            _control_slider_values[event.get("id")] = float(event.get("value", 0.0))
+            _control_values[event.get("id")] = float(event.get("value", 0.0))
+        elif evtype == "text":
+            _control_values[event.get("id")] = str(event.get("value", ""))
         elif evtype == "resend_config":
             if plot_desc_dict is not None:
                 socket.send_string(SENDING_PLOT_UPDATE)
@@ -615,7 +651,7 @@ def poll_controls():
 
     buttons = _control_button_events
     _control_button_events = []
-    return ControlState(values=dict(_control_slider_values), buttons=buttons)
+    return ControlState(values=dict(_control_values), buttons=buttons)
 
 
 def save_snapshot(path, server_url=None, animate=False, timeout=5.0):
@@ -623,7 +659,8 @@ def save_snapshot(path, server_url=None, animate=False, timeout=5.0):
 
     The server exposes a ``/snapshot.html`` endpoint that renders the
     current plot state as a self-contained HTML file with uPlot's JS +
-    CSS inlined plus the most recent window of trace data. The result
+    CSS inlined plus the most recent window of trace data. Vendored KaTeX
+    assets are also inlined, so LaTeX plot labels render offline. The result
     opens in any browser offline and looks pixel-identical to what the
     live tab was showing. Ideal for committing reproducible example
     previews to a repo or emailing a static "here's what I was seeing"
@@ -664,4 +701,4 @@ def save_snapshot(path, server_url=None, animate=False, timeout=5.0):
     abs_path = _os.path.abspath(path)
     with open(abs_path, "wb") as fh:
         fh.write(body)
-    return abs_path
+    return abs_path

{better_rtplot-0.4.10 → better_rtplot-0.4.14}/rtplot/server_browser.py

@@ -20,7 +20,9 @@ subscribed tab's PUSH socket.
 
 import argparse
 import asyncio
+import base64
 import dataclasses
+import hashlib
 import json
 import os
 import socket
@@ -215,6 +217,7 @@ RECEIVED_PLOT_UPDATE = 0
 RECEIVED_DATA = 1
 SAVE_PLOT = 3
 RECEIVED_DISPLAY = 4
+RECEIVED_TEXT_INPUT = 5
 
 BIND_ME_ID = "bind_me"
 BIND_ME_NAME = "Shared - Bind to me"
@@ -375,6 +378,8 @@ class Tab:
     layout: list = field(default_factory=list)
     control_rows: list = field(default_factory=list)
     slider_values: dict = field(default_factory=dict)
+    text_values: dict = field(default_factory=dict)
+    text_dirty: set = field(default_factory=set)
     display_values: dict = field(default_factory=dict)
     display_dirty: set = field(default_factory=set)
     fps: float = 0.0
@@ -499,6 +504,7 @@ def parse_config(tab: Tab, json_config):
     trace_info = []
     control_rows = []
     slider_values = {}
+    text_values = {}
     layout = []
     num_datapoints_in_plot = DEFAULT_NUM_DATAPOINTS_IN_PLOT
 
@@ -514,6 +520,8 @@ def parse_config(tab: Tab, json_config):
             for element in row:
                 if element.get("type") in ("slider", "dial") and "value" in element:
                     slider_values[element["id"]] = float(element["value"])
+                elif element.get("type") == "text_input":
+                    text_values[element["id"]] = str(element.get("value", ""))
             layout.append({"kind": "controls", "index": len(control_rows)})
             control_rows.append(row)
             continue
@@ -546,6 +554,18 @@ def parse_config(tab: Tab, json_config):
     }
     tab.display_dirty = {d for d in tab.display_dirty if d in active_display_ids}
     tab.slider_values = slider_values
+    active_text_ids = {
+        el["id"]
+        for row in control_rows
+        for el in row
+        if el.get("type") == "text_input"
+    }
+    tab.text_values = {
+        text_id: tab.text_values.get(text_id, default_value)
+        for text_id, default_value in text_values.items()
+        if text_id in active_text_ids
+    }
+    tab.text_dirty = {text_id for text_id in tab.text_dirty if text_id in active_text_ids}
     tab.layout = layout
 
     num_traces = sum(traces_per_plot)
@@ -585,11 +605,20 @@ def build_config_message(tab: Tab, config_dict) -> dict:
         "controls": tab.control_rows,
         "layout": tab.layout,
         "slider_values": dict(tab.slider_values),
+        "text_values": dict(tab.text_values),
         "display_values": dict(tab.display_values),
         "row_layout": bool(NEW_SUBPLOT_IN_ROW),
     }
 
 
+def refresh_config_message(tab: Tab):
+    """Rebuild the browser config payload using the tab's latest control state."""
+    if tab.config_dict is None:
+        tab.config_message = None
+    else:
+        tab.config_message = build_config_message(tab, tab.config_dict)
+
+
 ###############################
 # Binary payload construction #
 ###############################
@@ -952,7 +981,7 @@ async def zmq_receiver(tab: Tab):
 
             tab.last_config_error = None  # clear: this one was good
             tab.config_dict = cfg
-            tab.config_message = build_config_message(tab, cfg)
+            refresh_config_message(tab)
             tab.initialized = True
             fps = None
             tab.fps = 0.0
@@ -976,6 +1005,10 @@ async def zmq_receiver(tab: Tab):
                 await send_control_event(
                     tab, {"type": "slider", "id": sid, "value": svalue}
                 )
+            for text_id, text_value in tab.text_values.items():
+                await send_control_event(
+                    tab, {"type": "text", "id": text_id, "value": text_value}
+                )
 
         elif category == RECEIVED_DATA:
             arr = await _recv_array_async(sock)
@@ -1028,6 +1061,20 @@ async def zmq_receiver(tab: Tab):
                 tab.display_values[display_id] = value
                 tab.display_dirty.add(display_id)
 
+        elif category == RECEIVED_TEXT_INPUT:
+            payload = await sock.recv_json()
+            text_id = payload.get("id")
+            if text_id is None:
+                continue
+            value = str(payload.get("value", ""))
+            if tab.text_values.get(text_id) != value:
+                tab.text_values[text_id] = value
+                tab.text_dirty.add(text_id)
+                refresh_config_message(tab)
+                await send_control_event(
+                    tab, {"type": "text", "id": text_id, "value": value}
+                )
+
 
 ###############################
 # Pusher tasks #
@@ -1050,6 +1097,23 @@ async def display_pusher():
             )
 
 
+async def text_input_pusher():
+    """Push dirty text_input values to viewers at ~30 Hz, per tab."""
+    target_dt = 1.0 / 30.0
+    while True:
+        await asyncio.sleep(target_dt)
+        if not ws_clients:
+            continue
+        for t in list(tabs.values()):
+            if not t.text_dirty:
+                continue
+            values = {k: t.text_values[k] for k in t.text_dirty}
+            t.text_dirty = set()
+            await broadcast_text_tab(
+                t.id, {"type": "text_update", "tab": t.id, "values": values}
+            )
+
+
 async def ws_pusher():
     """Push new samples to viewers as binary delta frames, per tab."""
     target_dt = 1.0 / max(1, args.rate)
@@ -1296,8 +1360,21 @@ def _read_static_asset(name: str) -> str:
         return fh.read()
 
 
-# Loaded once at import time so per-request cost is just the send.
+# Loaded once at import time so per-request cost is just the send. Version the
+# asset URLs by their contents: browsers can otherwise keep an old or damaged
+# KaTeX script after the executable is updated while fetching the new HTML.
 _INDEX_HTML = _read_static_asset("index.html")
+for _asset in (
+    "uPlot.min.css",
+    "uPlot.iife.min.js",
+    "katex/katex.min.css",
+    "katex/katex.min.js",
+    "katex/auto-render.min.js",
+):
+    _digest = hashlib.sha256(_read_static_asset(_asset).encode("utf-8")).hexdigest()[:12]
+    _INDEX_HTML = _INDEX_HTML.replace(
+        f'"/static/{_asset}"', f'"/static/{_asset}?v={_digest}"'
+    )
 
 
 async def handle_index(request):
@@ -1342,6 +1419,7 @@ async def handle_ws(request):
                         },
                     )
                     if t.config_message is not None:
+                        refresh_config_message(t)
                         await ws_send_text(ws, t.config_message)
                         if t.display_values:
                             await ws_send_text(
@@ -1402,9 +1480,21 @@ async def handle_ws(request):
                     t = tabs.get(tid)
                     if sid and t is not None:
                         t.slider_values[sid] = value
+                        refresh_config_message(t)
                         await send_control_event(
                             t, {"type": "slider", "id": sid, "value": value}
                         )
+                elif ptype == "control_text":
+                    text_id = payload.get("id")
+                    tid = ws_tab.get(ws, BIND_ME_ID)
+                    t = tabs.get(tid)
+                    if text_id and t is not None:
+                        value = str(payload.get("value", ""))
+                        t.text_values[text_id] = value
+                        refresh_config_message(t)
+                        await send_control_event(
+                            t, {"type": "text", "id": text_id, "value": value}
+                        )
             elif msg.type == WSMsgType.ERROR:
                 break
     finally:
@@ -1423,6 +1513,7 @@ _SNAPSHOT_TEMPLATE = """<!doctype html>
 <meta charset="utf-8" />
 <title>rtplot snapshot</title>
 <style>__UPLOT_CSS__</style>
+<style>__KATEX_CSS__</style>
 <style>
   html, body { margin: 0; padding: 0; background: #fafafa; color: #222;
                font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif; }
@@ -1442,6 +1533,8 @@ _SNAPSHOT_TEMPLATE = """<!doctype html>
   &middot; drag to zoom, double-click to reset
 </p>
 <script>__UPLOT_JS__</script>
+<script>__KATEX_JS__</script>
+<script>__KATEX_AUTO_RENDER_JS__</script>
 <script>
 (function () {
   const SNAP = __SNAPSHOT_JSON__;
@@ -1502,6 +1595,15 @@ _SNAPSHOT_TEMPLATE = """<!doctype html>
                  traceCount: traceCount, startIdx: traceOffset });
     traceOffset += traceCount;
   });
+  renderMathInElement(plotsDiv, {
+    delimiters: [
+      { left: '$$', right: '$$', display: true },
+      { left: '\\\\[', right: '\\\\]', display: true },
+      { left: '\\\\(', right: '\\\\)', display: false },
+      { left: '$', right: '$', display: false },
+    ],
+    throwOnError: false,
+  });
   if (SNAP.animate) {
     let phase = 0;
     setInterval(function () {
@@ -1538,9 +1640,31 @@ _SNAPSHOT_TEMPLATE = """<!doctype html>
 try:
     _UPLOT_JS = _read_static_asset("uPlot.iife.min.js")
     _UPLOT_CSS = _read_static_asset("uPlot.min.css")
+    _KATEX_JS = _read_static_asset(os.path.join("katex", "katex.min.js"))
+    _KATEX_AUTO_RENDER_JS = _read_static_asset(
+        os.path.join("katex", "auto-render.min.js")
+    )
+    _KATEX_CSS = _read_static_asset(os.path.join("katex", "katex.min.css"))
+    # Snapshot files have no sibling font directory. Inline the vendored
+    # WOFF2 faces so equations keep their layout when opened offline.
+    _KATEX_FONT_DIR = os.path.join(
+        os.path.dirname(os.path.abspath(__file__)), "static", "katex", "fonts"
+    )
+    for _font_name in os.listdir(_KATEX_FONT_DIR):
+        if not _font_name.endswith(".woff2"):
+            continue
+        with open(os.path.join(_KATEX_FONT_DIR, _font_name), "rb") as _font_file:
+            _font_data = base64.b64encode(_font_file.read()).decode("ascii")
+        _KATEX_CSS = _KATEX_CSS.replace(
+            f"url(fonts/{_font_name})",
+            f"url(data:font/woff2;base64,{_font_data})",
+        )
 except Exception as _exc:  # noqa: BLE001
     _UPLOT_JS = f"/* uPlot load failed: {_exc} */"
     _UPLOT_CSS = ""
+    _KATEX_JS = f"/* KaTeX load failed: {_exc} */"
+    _KATEX_AUTO_RENDER_JS = ""
+    _KATEX_CSS = ""
 
 
 def _build_snapshot_html(tab: Tab, animate: bool) -> str:
@@ -1590,7 +1714,13 @@ def _build_snapshot_html(tab: Tab, animate: bool) -> str:
     html = _SNAPSHOT_TEMPLATE
     html = html.replace("__UPLOT_CSS__", _UPLOT_CSS)
     html = html.replace("__UPLOT_JS__", _UPLOT_JS)
-    html = html.replace("__SNAPSHOT_JSON__", json.dumps(payload))
+    html = html.replace("__KATEX_CSS__", _KATEX_CSS)
+    html = html.replace("__KATEX_JS__", _KATEX_JS)
+    html = html.replace("__KATEX_AUTO_RENDER_JS__", _KATEX_AUTO_RENDER_JS)
+    # Keep client-supplied labels from closing the script element while
+    # preserving their exact value when JavaScript parses the payload.
+    snapshot_json = json.dumps(payload).replace("<", "\\u003c")
+    html = html.replace("__SNAPSHOT_JSON__", snapshot_json)
     return html
 
 
@@ -1641,11 +1771,12 @@ async def on_startup(app):
 
     app["ws_task"] = asyncio.create_task(ws_pusher())
     app["display_task"] = asyncio.create_task(display_pusher())
+    app["text_input_task"] = asyncio.create_task(text_input_pusher())
     app["resources_task"] = asyncio.create_task(resources_pusher())
 
 
 async def on_cleanup(app):
-    for key in ("ws_task", "display_task", "resources_task"):
+    for key in ("ws_task", "display_task", "text_input_task", "resources_task"):
         await _cancel_task(app.get(key))
     for t in list(tabs.values()):
         await _cancel_task(t.receiver_task)

{better_rtplot-0.4.10 → better_rtplot-0.4.14}/rtplot/static/index.html

@@ -95,6 +95,8 @@
   .ctrl-numinput { width: 72px; font-family: monospace; font-size: calc(13px * var(--ui-scale)); padding: 4px 6px; border: 1px solid #b8b8b8; border-radius: 3px; background: #fff; color: #222; text-align: right; -moz-appearance: textfield; }
   .ctrl-numinput::-webkit-outer-spin-button,
   .ctrl-numinput::-webkit-inner-spin-button { -webkit-appearance: none; margin: 0; }
+  .ctrl-textinput { min-width: 200px; width: min(320px, 100%); font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif; font-size: calc(13px * var(--ui-scale)); padding: 7px 10px; border: 1px solid #b8b8b8; border-radius: 3px; background: #fff; color: #222; text-align: left; }
+  .ctrl-textinput:focus { outline: none; border-color: #2a5db0; box-shadow: 0 0 0 2px rgba(42, 93, 176, 0.14); }
   .ctrl-nudgebtn { width: 26px; height: 26px; font-size: calc(15px * var(--ui-scale)); font-weight: 600; line-height: 1; padding: 0; border: 1px solid #b8b8b8; background: #f7f7f7; color: #333; cursor: pointer; border-radius: 3px; }
   .ctrl-nudgebtn:hover { background: #e9e9e9; }
   .ctrl-nudgebtn:active { background: #dcdcdc; }
@@ -263,6 +265,8 @@
       // a typo in someone's label can't blow up the whole page.
       const _latexDelims = [
         { left: '$$', right: '$$', display: true },
+        { left: '\\[', right: '\\]', display: true },
+        { left: '\\(', right: '\\)', display: false },
         { left: '$', right: '$', display: false },
       ];
       function renderLatexIn(el) {
@@ -299,6 +303,26 @@
       const resTabRates = document.getElementById('res-tab-rates');
       const resUnavail = document.getElementById('res-unavail');
 
+      // A failed KaTeX download can still leave auto-render defined, but its
+      // closure then holds an undefined KaTeX reference. Retry both scripts
+      // in order with fresh URLs and render labels already on the page.
+      if (typeof katex === 'undefined') {
+        const retry = Date.now();
+        const core = document.createElement('script');
+        core.src = `/static/katex/katex.min.js?retry=${retry}`;
+        core.onload = () => {
+          if (typeof katex === 'undefined') return;
+          const autoRender = document.createElement('script');
+          autoRender.src = `/static/katex/auto-render.min.js?retry=${retry}`;
+          autoRender.onload = () => {
+            renderLatexIn(plotsDiv);
+            tabbar.querySelectorAll('.tab-name').forEach(renderLatexIn);
+          };
+          document.head.appendChild(autoRender);
+        };
+        document.head.appendChild(core);
+      }
+
       // ---- Detect the monitor's refresh rate on page load ----
       let monitorHz = 0;
       (function measureMonitorHz() {
@@ -415,7 +439,7 @@
       let socket = null;
       let pendingFrame = false;
       let lastStatus = { fps: 0, statusByte: 0, nonPlot: 0, peers: 0, dirty: true };
-      const controlElements = { displays: {}, displayFormats: {}, displayKinds: {}, sliders: {} };
+      const controlElements = { displays: {}, displayFormats: {}, displayKinds: {}, sliders: {}, textInputs: {} };
 
       function sendCtrl(msg) {
         if (socket && socket.readyState === WebSocket.OPEN) {
@@ -684,6 +708,34 @@
           item.appendChild(val);
           controlElements.displays[el.id] = val;
           controlElements.displayKinds[el.id] = 'text';
+        } else if (el.type === 'text_input') {
+          item.classList.add('ctrl-text-input', 'flex');
+          if (el.label) {
+            const lbl = document.createElement('label');
+            lbl.textContent = el.label;
+            item.appendChild(lbl);
+          }
+          const input = document.createElement('input');
+          input.type = 'text';
+          input.className = 'ctrl-textinput';
+          input.value = (el.value !== undefined && el.value !== null) ? String(el.value) : '';
+          if (el.placeholder !== undefined && el.placeholder !== null) {
+            input.placeholder = String(el.placeholder);
+          }
+          if (el.max_length !== undefined && Number.isFinite(Number(el.max_length))) {
+            input.maxLength = Number(el.max_length);
+          }
+          const commit = () => sendCtrl({ type: 'control_text', id: el.id, value: input.value });
+          input.addEventListener('change', commit);
+          input.addEventListener('blur', commit);
+          input.addEventListener('keydown', (e) => {
+            if (e.key === 'Enter') {
+              e.preventDefault();
+              commit();
+            }
+          });
+          item.appendChild(input);
+          controlElements.textInputs[el.id] = input;
         }
         return item;
       }
@@ -722,6 +774,14 @@
         }
       }
 
+      function applyTextValues(values) {
+        if (!values) return;
+        for (const [id, val] of Object.entries(values)) {
+          const input = controlElements.textInputs[id];
+          if (input) input.value = (val !== undefined && val !== null) ? String(val) : '';
+        }
+      }
+
       function applyDisplayValues(values) {
         if (!values) return;
         for (const [id, val] of Object.entries(values)) {
@@ -752,6 +812,7 @@
         controlElements.displayFormats = {};
         controlElements.displayKinds = {};
         controlElements.sliders = {};
+        controlElements.textInputs = {};
       }
 
       function showEmptyState(text) {
@@ -771,6 +832,7 @@
         const colors = pcfg.colors || DEFAULT_COLORS;
         const widths = pcfg.line_width || [];
         const styles = pcfg.line_style || [];
+        const shows = pcfg.show || [];
 
         const series = [{}];
         for (let t = 0; t < traceCount; t++) {
@@ -782,6 +844,7 @@
             dash: dash || undefined,
             points: { show: false },
             spanGaps: true,
+            show: shows[t] !== false,
           });
         }
 
@@ -859,6 +922,7 @@
         });
         totalTraces = traceOffset;
         applySliderValues(cfg.slider_values);
+        applyTextValues(cfg.text_values);
         applyDisplayValues(cfg.display_values);
         // Render LaTeX in everything we just built: uPlot's title,
         // x/y axis labels, and legend (all rendered as HTML), plus the
@@ -1280,6 +1344,9 @@
             } else if (msg.type === 'display_update') {
               if (msg.tab && msg.tab !== activeTab) return;
               applyDisplayValues(msg.values);
+            } else if (msg.type === 'text_update') {
+              if (msg.tab && msg.tab !== activeTab) return;
+              applyTextValues(msg.values);
             } else if (msg.type === 'peer_count') {
               const n = Number(msg.count) || 0;
               if (lastStatus.peers !== n) {