Update abcjs version for Tune display and add additional abcjs-based tools

.gitignore

@@ -5,7 +5,12 @@ pyabc2/sources/_*
 poetry.lock
 venv*/
 docs/api/
+docs/examples/music*.svg
+pyabc2/sheet/test.*
 
+# node
+node_modules
+package-lock.json
 
 # Byte-compiled / optimized / DLL files
 __pycache__/

.readthedocs.yaml

@@ -1,9 +1,9 @@
 version: 2
 
 build:
-  os: ubuntu-24.04
+  os: ubuntu-lts-latest
   tools:
-    python: "3.11"
+    python: "3.14"
 
 python:
   install:
@@ -12,6 +12,8 @@ python:
       extra_requirements:
         - doc
         - sources
+        - widget
+        - sheet
 
 sphinx:
   configuration: docs/conf.py

docs/api.rst

@@ -150,3 +150,27 @@ Functions:
    eskin.load_url
    eskin.abctools_url_to_abc
    eskin.abc_to_abctools_url
+
+Widget
+======
+
+.. automodule:: pyabc2.widget
+
+.. autosummary::
+   :toctree: api/
+
+   ABCJSWidget
+   interactive
+
+
+Headless rendering
+==================
+
+.. automodule:: pyabc2.sheet
+
+.. autosummary::
+   :toctree: api/
+
+   svg
+   svg_to
+   build

docs/conf.py

@@ -34,6 +34,18 @@
 html_theme = "furo"
 html_static_path = ["_static"]
 html_css_files = ["custom.css"]
+html_js_files = [
+    # TODO: just the pages that need it (example notebooks) instead of every page, using `app.add_js_file`
+    (
+        "https://cdn.jsdelivr.net/npm/abcjs@6.4.4/dist/abcjs-basic-min.js",
+        {
+            "crossorigin": "anonymous",
+            # We need it to load before the widget instances
+            # which seem to be in the extensions group (default priority 500)
+            "priority": 499,
+        },
+    )
+]
 
 napoleon_google_docstring = False
 napoleon_numpy_docstring = True

docs/dev.md

@@ -42,3 +42,19 @@ pre-commit install
 ```
 
 You can now make a branch on your fork, work on the code, push your branch to GitHub, and make a PR to the parent repo.
+
+## Widget
+
+Enable hot reloading by setting environment variable `ANYWIDGET_HMR` to `1`
+before starting Jupyter Lab.
+
+````{tab} Bash
+```bash
+export ANYWIDGET_HMR=1
+```
+````
+````{tab} PowerShell
+```powershell
+$env:ANYWIDGET_HMR = "1"
+```
+````

docs/examples/types.ipynb

@@ -333,6 +333,8 @@
    "id": "32",
    "metadata": {},
    "source": [
+    "(tune_type)=\n",
+    "\n",
     "## Tune\n",
     "\n",
     "Pass an ABC string to create a {class}`~pyabc2.Tune`."