galaga-anywidget 2.0.0a2__tar.gz

galaga_anywidget-2.0.0a2/.gitignore

@@ -0,0 +1,21 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv
+.coverage
+.DS_Store
+__marimo__/
+# Vim
+*.swp
+*.swo
+*~
+test.py
+.kiro/
+.session.jsonl
+.spacebot/

galaga_anywidget-2.0.0a2/PKG-INFO

@@ -0,0 +1,95 @@
+Metadata-Version: 2.5
+Name: galaga-anywidget
+Version: 2.0.0a2
+Summary: Interactive AnyWidget visualizations for Galaga geometric algebra
+Project-URL: Homepage, https://github.com/edouardp/galaga
+Project-URL: Repository, https://github.com/edouardp/galaga
+Project-URL: Issues, https://github.com/edouardp/galaga/issues
+Author: Edouard Poor
+License-Expression: MIT
+Keywords: anywidget,cga,geometric-algebra,marimo,visualization
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Education
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Scientific/Engineering :: Mathematics
+Classifier: Topic :: Scientific/Engineering :: Visualization
+Requires-Python: >=3.11
+Requires-Dist: anywidget>=0.9
+Requires-Dist: galaga>=2.0.0a2
+Requires-Dist: marimo<0.25,>=0.23.14
+Requires-Dist: numpy>=1.24
+Requires-Dist: traitlets>=5.14
+Description-Content-Type: text/markdown
+
+# galaga-anywidget
+
+Interactive AnyWidget visualizations for Galaga geometric algebra.
+
+The first renderer draws direct points, dipoles, lines, and circles in a
+two-dimensional conformal model. It owns semantic Euclidean point coordinates,
+so browser drags participate in Marimo's normal reactive execution while the
+notebook keeps all geometric constructions in Python.
+
+During the Galaga 2 prerelease train:
+
+```bash
+python -m pip install --pre "galaga-anywidget>=2.0.0a1,<3"
+```
+
+## Persistent reactive construction
+
+Construct and render the visualization in a cell that has no dependency on
+changing geometry:
+
+```python
+import galaga_anywidget.viz as viz
+
+circle_viz = viz.CGA2D(
+    cga,
+    colors=["#0072B2", "#D55E00", "#009E73", "#7C3AED"],
+)
+circle_viz
+```
+
+Read named coordinates in another cell and construct ordinary multivectors:
+
+```python
+px, py = circle_viz.coordinates("P", default=(-1.75, -0.75))
+qx, qy = circle_viz.coordinates("Q", default=(0.25, 1.5))
+rx, ry = circle_viz.coordinates("R", default=(1.75, -0.5))
+
+P = cga.up(px, py).named("P")
+Q = cga.up(qx, qy).named("Q")
+R = cga.up(rx, ry).named("R")
+```
+
+Keep the derived algebra in its own ordinary cell:
+
+```python
+C = (P ^ Q ^ R).named("C")
+```
+
+Then synchronize the current values into the persistent widget:
+
+```python
+circle_viz.display([P, Q, R], immutable=[C])
+```
+
+The three points are draggable and the dotted circle is read-only. Dragging a
+point updates the named coordinate pair, which causes Marimo to reconstruct
+the conformal point and every dependent value. The widget never duplicates the
+circle construction in JavaScript.
+
+For compact static or one-cell views, use
+`viz.display([point, dipole, line, circle], model=cga)`. The lower-level
+`CGA2DPlot` API supports explicit keys, replacements, dependent geometry, and
+solid, dashed, or dotted line styles.
+
+The design and interaction lessons are recorded in
+[GALAGA_ANYWIDGET.md](https://github.com/edouardp/galaga/blob/main/GALAGA_ANYWIDGET.md).

galaga_anywidget-2.0.0a2/README.md

@@ -0,0 +1,66 @@
+# galaga-anywidget
+
+Interactive AnyWidget visualizations for Galaga geometric algebra.
+
+The first renderer draws direct points, dipoles, lines, and circles in a
+two-dimensional conformal model. It owns semantic Euclidean point coordinates,
+so browser drags participate in Marimo's normal reactive execution while the
+notebook keeps all geometric constructions in Python.
+
+During the Galaga 2 prerelease train:
+
+```bash
+python -m pip install --pre "galaga-anywidget>=2.0.0a1,<3"
+```
+
+## Persistent reactive construction
+
+Construct and render the visualization in a cell that has no dependency on
+changing geometry:
+
+```python
+import galaga_anywidget.viz as viz
+
+circle_viz = viz.CGA2D(
+    cga,
+    colors=["#0072B2", "#D55E00", "#009E73", "#7C3AED"],
+)
+circle_viz
+```
+
+Read named coordinates in another cell and construct ordinary multivectors:
+
+```python
+px, py = circle_viz.coordinates("P", default=(-1.75, -0.75))
+qx, qy = circle_viz.coordinates("Q", default=(0.25, 1.5))
+rx, ry = circle_viz.coordinates("R", default=(1.75, -0.5))
+
+P = cga.up(px, py).named("P")
+Q = cga.up(qx, qy).named("Q")
+R = cga.up(rx, ry).named("R")
+```
+
+Keep the derived algebra in its own ordinary cell:
+
+```python
+C = (P ^ Q ^ R).named("C")
+```
+
+Then synchronize the current values into the persistent widget:
+
+```python
+circle_viz.display([P, Q, R], immutable=[C])
+```
+
+The three points are draggable and the dotted circle is read-only. Dragging a
+point updates the named coordinate pair, which causes Marimo to reconstruct
+the conformal point and every dependent value. The widget never duplicates the
+circle construction in JavaScript.
+
+For compact static or one-cell views, use
+`viz.display([point, dipole, line, circle], model=cga)`. The lower-level
+`CGA2DPlot` API supports explicit keys, replacements, dependent geometry, and
+solid, dashed, or dotted line styles.
+
+The design and interaction lessons are recorded in
+[GALAGA_ANYWIDGET.md](https://github.com/edouardp/galaga/blob/main/GALAGA_ANYWIDGET.md).

galaga_anywidget-2.0.0a2/galaga_anywidget/__init__.py

@@ -0,0 +1,16 @@
+"""Interactive AnyWidget visualizations for Galaga geometric algebra."""
+
+from . import viz
+from .cga2d import DEFAULT_COLOR_CYCLE, CGA2DChange, CGA2DKind, CGA2DLineStyle, CGA2DPlot, cga2d
+from .viz import CGA2D
+
+__all__ = [
+    "CGA2DKind",
+    "CGA2DLineStyle",
+    "CGA2DChange",
+    "CGA2DPlot",
+    "CGA2D",
+    "DEFAULT_COLOR_CYCLE",
+    "cga2d",
+    "viz",
+]