Quiltwright v0.10.1
Release Notes -- v0.10.1
Released: 2026-08-31
This release moves house and tightens up what was already there. The
repository itself is now under the Flux-Frontiers org rather than a personal
account, and the documentation finally gets a home of its own: the guides
under docs/ build into a real site, an architecture page describes the
package as it stands rather than as a plan for getting there, and every CLI
command has a full flag reference for the first time. Alongside that, the
bell jar still life gets glass that actually refracts, a hologram-printer
sweep is now something you run rather than something you script by hand, and
a lens bug in the vitrine exhibits that had been quietly overstating headroom
is fixed.
What changed
Documentation now builds into a GitHub Pages site. docs/*.md renders
through MkDocs Material into
flux-frontiers.github.io/quiltwright,
alongside an API reference generated by mkdocstrings straight from the
package's own docstrings -- ten modules (quilt, lfd, povray, cycles,
povgen, hld, weave, bridge, tvb_data, runtime), so the reference
can't drift from what the code actually does. A GitHub Actions workflow
builds and deploys it on every push to main. Every doc link that used to
point at scripts/, pov-scenes/, or the top-level README as a path
relative to docs/ -- fine to read in the repository, but with no target
inside a site that only serves docs/ -- now points at an absolute GitHub
URL instead.
docs/architecture.md replaces docs/architecture-plan.md. The module
split the plan proposed had fully landed some time ago, which left a PR
proposal sitting in the documentation table long after it stopped being one.
The new page describes the package as it is: the module map, the acyclic
dependency graph between quilt, bridge, runtime and the three
backends, and the off-axis invariant (window_shear) that all three convert
into their own units.
docs/cli.md documents every quiltwright command, flag by flag.
docs/shell.md keeps the narrative of what each command is for and why, and
now links out to the new reference for the option tables instead of
duplicating them.
The repository moved to Flux-Frontiers. Every reference to the old
suchanek/quiltwright path -- README badges, the pyproject.toml project
URLs, CITATION.cff, source-file docstring headers -- now points at
Flux-Frontiers/quiltwright, matching where the rest of the fleet already
lives. The Zenodo DOI and the PyPI trusted-publisher configuration were
updated to match on the hosting side.
bj_holo_2026.pov gives "DNA Under Glass" a bell jar that refracts
instead of just tinting. The 1996 jar carried no interior, so its index
of refraction was 1.0 and it bent nothing; once it gained a real wall
thickness, that no-refraction surface applied twice at every edge-on
silhouette and drew a double outline instead of one glass rim. The new cut
turns on ior 1.52 with a Fresnel reflection, and the doubled outline
resolves into a single bright band, with the horizon bending correctly where
it crosses the wall. Dispersion was tried and dropped -- 4.5x the render for
a difference lenticular crosstalk erases anyway.
A LitiHolo printer sweep is now a first-class render, not a hand-rolled
script. --sweep on scripts/render_still_life_hologram.py swaps in the
23-view, 45-degree, single-row device spec LITIHOLO_SWEEP and otherwise
runs the same budget/render/save/report path a quilt does, so a sweep now
carries the same provenance a quilt always has.
A vitrine lens bug is fixed. scripts/render_vitrine.py was converting
its vertical field of view to POV-Ray's horizontal angle before handing it
to PovCamera, whose fov is vertical -- so every vitrine quilt rendered at
a 71.4-degree lens instead of the 44 degrees the scene is actually composed
at, and the depth budget printed alongside it understated adjacent-view
disparity by nearly half. The script now passes the vertical FOV straight
through.
Housekeeping. The three committed landscape quilts (bell-jar, museum,
porin) are release assets now rather than repository content, saving every
clone 97 MB of history it was paying regardless of whether it wanted the
renders. tests.yml no longer runs its full matrix twice per push to a
branch with an open PR.
Upgrading
Nothing to migrate. This release changes no public API -- pip install -U quiltwright is enough. If your bookmarks or scripts reference
github.com/suchanek/quiltwright, GitHub redirects them, but updating to
Flux-Frontiers/quiltwright avoids relying on that indefinitely.
Full changelog: CHANGELOG.md