Vectura Studio

Physics-inspired vector generation for plotter-ready line art. No build step, no framework — open index.html and go. Vectura combines a rich algorithm library (flowfields, boids, attractors, Petalis, and more) with a full layer system, mirror & morph modifiers, SVG export with plotter optimization, and a Noise Rack for layered generative noise — all in vanilla JavaScript.

---

Gallery

Flowfield	Boids	Attractor

---

Quick Start

Option A — open directly:

Double-click index.html

Option B — serve locally:

python -m http.server
# then visit http://localhost:8000

For tests:

npm install
npm run hooks:install   # one-time: installs pre-commit + pre-push (test:feedback) hooks
npm run test:feedback   # bounded local check; CI (`ci-ok`) is the full gate

Node 20.19 or newer is required for the development and test toolchain; use Node 24 (.nvmrc), the CI major and the only one where golden values are checked.

CI is the full gate: the required ci-ok check covers the whole Vitest roster, the browser smoke, perf and the routed Scene3D audits on every PR. Coverage, the full touch roster and pixel snapshots run on main and nightly. Details: testing guide.

The pre-push hook runs test:feedback (bounded local feedback) before every push. A minimal browser journey runs locally; CI retains the full browser roster. Bypass with SKIP_PREPUSH=1 git push.

---

Features

Layers & Modifiers

Vectura uses a pro-editor-style layer system with full undo history for every structural edit — reorder, group, reparent, mask toggles, and modifier changes are all first-class history steps. Layers support per-layer stroke/line-cap settings, visibility, and drag-to-reorder. Mirror Modifiers let you wrap layers in a reflective container with a full mirror-axis stack, and Morph Modifiers blend 2+ child layers into graduated in-between rings (a pro-editor-style Blend, but plotter-native).

• Layered generation with visibility toggles, ordering, and per-layer stroke/line-cap settings
• Parent masks from the Layers panel: a visible parent silhouette clips all indented descendants, with optional Hide Mask Layer for invisible mask artwork and a live dimmed-descendant preview while the mask parent is being transformed
• Insert > Mirror Modifier adds a group-like container with drag-to-assign or drag-out child layers, + Add child-layer creation from a selected modifier, fully editable selected child layers, and mirrored closed-mask silhouettes for masked subtrees
• Insert > Morph Modifier adds a blend container: drop 2+ layers in and it generates N graduated in-between rings morphing one shape into the next (sequential A→B→C chaining or a cyclic loop), with controls for steps, easing, vertex resampling, start-vertex correspondence, multi-path handling, source emission, closure, and output smoothing; children auto-lock and Expand bakes each ring into its own shape layer
• Mirror guides are dashed editor overlays with a centered reflection triangle; reflected geometry exports while guide lines stay editor-only
• The modifier row owns a Mirror Stack with per-axis show/hide, lock, delete, reorder, angle, and XY shift controls plus stack-level add/show-hide/lock/clear actions; deleting the modifier dissolves the wrapper and preserves children
• Layer grouping/ungrouping via Cmd/Ctrl+G and Cmd/Ctrl+Shift+G
• Pathfinder panel for multi-selection: four Shape Modes (Unite, Minus Front, Intersect, Exclude) build non-destructive compound shapes (Expand to bake), and six Pathfinders (Divide, Trim, Merge, Crop, Outline, Minus Back) produce destructive baked output grouped under a pathfinder container. Silhouette mode chord-closes open paths; Shape-Only mode restricts to closed shapes. Outline preserves source strokeWidth for plotter-ready line art.
• Undo/Redo treats document-mutating layer-structure edits as first-class history steps, including reorder, grouping, reparenting, parent-mask toggles, and modifier/container edits
• Multi-selection: shift-click ranges, Cmd/Ctrl-click to toggle, or drag a marquee on the canvas; then move/rotate the group together
• Cmd/Ctrl+A selects all drawable layers from anywhere outside text inputs
• Double-click a layer name to rename it inline
• Expand any layer into per-line sublayers for fine-grained selection and pen assignment (Cmd/Ctrl+E)
• Fast duplication: Cmd/Ctrl+D duplicates selection; Alt-drag (Option-drag) also duplicates
• Configurable undo with Cmd/Ctrl+Z and adjustable history depth

---

Canvas & Tools

A pro-editor-style shared toolbar now drives the main canvas plus the embedded designer surfaces, including selection, direct selection, hand, pen (bezier), shape, scissor, and fill tools. Shape tools create true straight-edge primitives with corner rounding, the pen tool supports full bezier editing with subtool shortcuts, and Pattern texture fills now support nested-region targeting with drag-pour behavior.

• Shared toolbar with shortcuts: V selection, A direct selection, Space hand, P pen, M rectangle, L oval, U line, Y polygon, C scissor, F fill, Shift+F erase fill; press again to cycle subtools where available
• Direct path editing for individual line endpoints and bezier handles
• Shape tools (Rectangle M, Oval L, Line U, Polygon Y) live under a single long-press group on the toolbar — single-tap activates the most-recently-used variant, long-press opens the variant submenu. All four create editable expanded layers; fresh shapes stay straight-edged on mouse release
• Custom canvas cursors: filled arrow for Selection (V), outline arrow for Direct Selection (A), pen-tip for Pen (P), and a paint-bucket overlay with an auto-positioning magnifier loupe for Fill (F) that stays inside the canvas viewport
• Shape tools support center-draw / square-circle constraints (Alt), polygon side-count changes while dragging (Arrow Up/Down), and corner rounding (Selection rounds all corners; Direct rounds one corner, or all selected corners together when several are selected)
• Pen long-press subtool menu with modes: + add anchor, - delete anchor, Shift+C convert anchor; while dragging a new bezier point, Alt/Option freezes the mirrored handle and lets the active handle move freely
• Scissor tool: drag a line/rect/circle to split intersecting paths
• Fill tool supports nested closed regions in the Texture Designer: click the smallest containing region, Shift-click to fill the whole containing stack, drag to keep pouring across new regions, and hold Alt/Option to temporarily erase fills while dragging
• The Texture Designer seam preview now includes a Show Gaps tolerance slider that reveals near-miss tile joins in yellow and offers auto-close fixes for closable seam endpoints
• Direct canvas manipulation: drag to move the selected layer, drag corner handles to resize, rotate via the upper-right handle (Shift snaps)
• Eight-handle selection box: the four corners plus four edge-midpoint handles for single-axis resize (Shift constrains proportions)
• Flip Horizontal / Flip Vertical mirror the selection (single or multi) about its bounds center — world-exact, self-inverse, one undo step; also available as icon buttons in the Transform section and the right-click menu

---

Contextual Task Bar

Select an object and a Contextual Task Bar floats just below it with the actions that matter right now — edit path, pen, stroke weight, shape properties, group/align, isolate, or text. Stroke weight and Simplify open inline sub-modes; live rectangles and polygons get a corner-radius / side-count popover. Double-clicking into a group shows an isolation breadcrumb across the top of the canvas. Toggle the bar under Document Setup → Guides & Display. No AI tooling anywhere.

• Floating contextual bar (.ctxbar) anchors below the selection, flips above near the viewport bottom, clamps to the viewport, yields to the tool rail, and hides during canvas drag / drawing / text-caret edits
• Per-selection actions: idle (Add Layer dropdown, Draw with pen icon, Document Setup); single path (Edit Path, pen chip, stroke, shape properties, lock); multi (Group, Align flyout, pen, stroke); group (Ungroup, Isolate group, pen, stroke); direct (Simplify, Smooth, six anchor verbs); text (family/style/size bound to the Text panel, Outline, pen)
• Add Layer dropdown: idle-state pill left of Draw, matching the sidebar's Add Layer menu — Algorithm Layer (drill-down to the same grouped/iconed algorithm list as the module dropdown), Mirror/Morph Modifier Group, Empty Layer, Empty Group. Opens toward whichever side (up/down) has more room, caret included, and keeps re-flipping live as the bar is dragged or auto-repositions
• Stroke-weight sub-mode: slider + steppers + document-unit field morph into the bar, with "Open Stroke Options" for the full popover; one undo step per gesture
• Simplify sub-mode: an anchor-reduction slider that runs complex → simple (left → right), starting at the untouched original; each step removes endpoints by fitting the fewest beziers that hold the shape (corners preserved), and the slider's travel is bounded by the deepest achievable reduction — a triangle or rectangle has nothing to simplify so the slider is disabled. Live PathEditOps preview with an Auto-Smooth pass and a "{pts} pts" badge; Done commits, Esc / click-away cancels
• Shape-properties popover: corner type & radius for live rectangles, side count (3–20) for polygons — round-trips with the on-canvas corner widget as one undo step
• Overflow … menu: Show panel · Hide bar · Reset position · Pin position · Quick help. A drag handle pins the bar; role="toolbar" with roving tabindex never steals focus on appearance
• Isolation breadcrumb: double-click into a group for a top-of-canvas ancestry strip (Document › … › group) — click an ancestor to step out one level, the back arrow to exit one level, or the root to leave isolation; a fixed-blue top-edge line marks the isolated state
• Toggle the whole bar under Document Setup → Guides & Display (default on); enabled state + pinned position persist via .vectura and cookie preferences
• Reduced-motion friendly (≤120ms fade/slide, animation disabled under prefers-reduced-motion)

---

Algorithms

19+ algorithm families power each layer, all seeded for repeatable results. The Noise Rack is a universal multi-algorithm noise stacking system shared across algorithms — add layers, pick noise types, blend modes, and octave shaping without touching algorithm-specific code. Every algorithm also ships a universal preset gallery: a thumbnail dropdown of curated starting points grouped by Classic / Geometric / Organic / Complex / Evolving, plus a User section. Edit any preset and a colored save pip appears beside it — click it (or press Cmd/Ctrl+S) to name and save the look as your own preset, with one-click Undo; if you started from one of your own presets you can update it in place. Your presets save in the browser by default; in Document Setup → Preset Storage you can connect a folder on disk (Chrome/Edge) so they persist across sessions, or export/import a portable vectura-presets.json bundle to move them between machines. You can still import presets from .vectura files too. With Developer Mode on (Document Setup), the Save dialog becomes a small authoring tool: overwrite any preset — curated built-ins included — and save into a category (an existing group or a brand-new one you name), written straight into the repo's user-presets/ folder so it's commit-ready.

• 19+ algorithm families: flowfield, boids, attractors, hyphae, lissajous, harmonograph, pendula, wavetable, rings, topo, grid, rainfall, phylla, petalis, spiral, shapepack, terrain, horizon, pattern, svgdistort, plus a 3D family — spirograph, spiralizer, polyhedron, topoform, raster-plane, and the multi-object 3D Scene Studio
• 3D suite: the mesh-rendering algorithms (Topoform, Polyhedron) import binary or ASCII .stl meshes and render them as wireframes, depth-plane contours, or face/edge/vertex art with hidden-line removal; Topoform ships 10 primitives (sphere, torus, cube, cone, ellipsoid, cylinder, capsule, pyramid, superellipsoid, torus knot) with detail up to 100. All four 3D algorithms support orthographic or perspective projection, full Rotate X/Y/Z view control via sliders or the on-canvas three-ring rotation gizmo (amber X, violet Y, cyan Z — drawn ring-only, with no backing disc over the artwork), and contour/line smoothing produces true bezier curves on screen and in export. The live preview fidelity while dragging a 3D shape is tunable in Document Setup → Guides & Display → 3D move preview (Draft / Balanced / High)
• 3D Scene Studio: a multi-object scene builder — assemble box · sphere · cylinder · cone · torus · torus-knot · capsule · superellipsoid · pyramid · plane · solids on a shared camera, select and move/rotate/scale objects (or push-pull box faces) with on-canvas gizmos, and light them with a multi-light rig (directional · ambient · point · spot, each draggable via a 3-axis gizmo). Surfaces render light-made tone through per-object/per-face fill mappers (hatch, crosshatch, contour, spiral, stipple, wireframe — each with its own control inventory), controllable cast shadows (angle / density / pen / line type / Softness, a Layers control — Off / 2 / 3 / 4 — that builds contact, umbra and penumbra zones in stages, and an inverse mode that thins a patterned ground for dark-paper plots), selectable highlight treatments, x-ray see-through back-face fills, a per-object border drawn as one contiguous silhouette outline, and a shared stroke treatment (line type, hand-drawn wobble, overstroke). Line output splits by role: the Object tab's Border lines (Curves / Smoothing / Simplify) govern the silhouette, creases and face outlines, while the Style tab's Fill lines (Curves / Smoothing / Simplify / Fidelity) govern the internal fill. Per-class Edge Styles give silhouette / crease / boundary / interior / hidden edges each their own pen, weight, and dash, with hidden edges drawn or dropped scene-wide. The Style tab's group (Gamma, Contrast, Depth fade) shapes the tone every Fill Style reads, and the Fill Style rows add law-specific dials (wave length and crest phase, nib angle and contrast, taper, Turing maturity and scale, light-relative hatch, tier pens, maze chaining). Slices gains — how far each depth-slice ring is carried past (or pulled back from) the silhouette, in pen widths; default 0 = unchanged. Per-object Style / Shadow / Highlight / X-ray flyouts live on the contextual task bar. The ground has size controls with a proportion lock and a one-click that pushes its edges off the artboard. Each scene is a — one object per layer, with boolean (CSG) groups, lights, and the ground as their own rows — so you build it object-by-object, click the canvas or the tree to select and edit a single object, and older saved scenes upgrade to the tree automatically

---

Export & Optimization

The SVG export modal offers a large preview pane with zoom/pan inspection, plotter optimization controls, and multi-layer line sort. Output is plotter-ready: millimeter-accurate, grouped by pen, and physically trimmed to your frame. A separate Export Animated SVG action emits a self-contained looping "draw-on" SVG for sharing the figure drawing itself.

• File > Export SVG opens a pro-editor-style modal: large left-side preview pane, right-side export settings, Cancel / Export SVG at bottom-right
• File > Export Animated SVG… is a separate action that emits a self-contained, looping "draw-on" SVG whose strokes draw themselves on repeat (SMIL stroke-dashoffset), sequenced by cumulative stroke length over the active harmonograph/pendula layer's duration — so you can share the figure drawing itself. It is distinct from the canonical Export SVG, which stays clean and static (no animation contamination)
• Preview is zoom/pan inspectable; export-preview Line Sort overlay styling stays scoped to the modal and never leaks into the main canvas
• Remove Hidden Geometry is enabled by default — exported SVGs physically trim masked or frame-hidden geometry to match the visible frame; turning it off preserves hidden source geometry through SVG clip paths
• Plotter optimization toggle with adjustable tolerance (mm) to remove fully overlapping paths per pen before export
• Multi-layer Line Sort respects the selected optimization scope across preview, stats, overlay rendering, and optimized SVG export
• When preview mode is Overlay and Line Sort is active, the overlay gradient runs from Overlay Color to its complement by default, with a per-Line Sort secondary-color override and an on-canvas print-order legend
• Export Optimized is enabled by default; optimization scope defaults to All Layers
• Line Simplify is applied by default for new layers with Mode set to Curve; Line Sort is off by default for new layers
• One-click export with configurable precision and grouping by pen assignment
• Plotter-first output stored in millimeters with machine profiles (A3, A4, AxiDraw V3) plus a document-level Metric/Imperial display toggle
• Stroke Divisions (⋯ → Open Stroke Options): split a layer's strokes into alternating segments, each with its own run length, pen (or the layer pen), and gap — so a single path plots as a multi-pen or dashed run. A pen mode (Cycle / Weighted) and phase mode (Fixed / Per-path / Jitter) add grammar: Weighted scatters segments across pens by a set ratio, Jitter varies the dash phase per path. Everything is deterministic (a seed makes weighted/jitter patterns reproducible); a coincident undivided duplicate on the same pen is deduped so it never double-inks
• Plot-physics readout in the Document Overview: per pen, the pen lifts, pen-up travel distance, draw length, and an estimated plot time (from the machine's pen speeds), with an all-pens total and a short-segment/gap warning — measured on the real deduped plot order so it matches the exported file

---

UI & Workflow

Vectura's UI follows familiar desktop-editor conventions: a desktop menu bar with File/View/Insert/Help menus, a Pen / Paper tab with the pen palette (drag-to-assign) and a realistic paper selector, Document Setup (Cmd/Ctrl+K), and a multi-skin theme system (Classic Dark/Light, Lark, and the Meridian Blue family). Cookie-backed preference persistence keeps your settings between sessions.

• Desktop menu bar beside VECTURA.STUDIO with shortcuts for Open/Save/Import/Export/Document Setup/Reset View/Help plus an Insert menu for modifier containers
• Top menu dropdowns render as overlays above the canvas/panes so they're never clipped by the header
• Multi-skin theme system: Classic Dark, Classic Light, Lark, Meridian Blue · Dark, Meridian Blue · Light, and Meridian Blue · Lark. Switching skin restyles the full shell, flips the document background default, and swaps Pen 1 to a contrast-appropriate color. New skins can be authored without JavaScript edits — see docs/skin-authoring.md and run npm run skin:new -- <id> to scaffold one from the template.
• File > Document Setup (Cmd/Ctrl+K) covers machine size, Metric/Imperial switch, optional blueprint-style dimension labels, margin, on-canvas crop, margin guides, the default paper, selection-outline styling, plotter physics, optional 10mm grid overlay, and cookie preference saving with Clear Saved Preferences
• Pen palette with assignable colors/widths, reorderable list, drag-to-assign per layer or selection, and double-click-to-apply on selected layers
• Paper selector (Pen / Paper tab ▸ Paper): pick the sheet per document — None (plain colour), Hot-press, Cold-press and Rough watercolor, Bristol smooth and vellum, Cotton rag, Kraft, Newsprint, Black stock or Tracing — and any paper colour. Realistic papers render seeded surface tooth, fibres, speckles and formation mottling, and the ink reacts: it multiplies into light stock, skips the tooth valleys on toothy paper, bleeds and feathers on absorbent stock (newsprint most) and sits thinner on newsprint and tracing. Texture and Ink bleed sliders scale the effect and Scale (25–300 %) sizes the grain — 100 % is calibrated to real sheets (hot press barely visible, cold press a fine ~0.6 mm tooth, rough ~1–2.5 mm; picking a paper type resets Scale to 100 %, like Texture). The surface is lit around the paper colour (lit facets brighten, shadows darken, highlights roll off softly, so the sheet keeps its colour — white stock gives up ≤ 1.5 % so its tooth still shows), and tooth near pixel size fades smoothly with the true on-screen size, so at fit-to-screen a sheet shows about half the tooth contrast of a raking-light photo of the real paper, sharpening continuously as you zoom (a mat of fibres appears at deep zoom). Every feature is sized in real millimetres, so the grain is the same on A6 and A0 (a small sheet at fit-to-screen shows coarser grain). Paper is saved in the file and is a : the SVG export stays plotter-clean. makes the paper the start of every new document (also in Document Setup ▸ Paper & Selection ▸ Default paper, which replaces the old Background colour); applies it to the open document. stores the current paper (type, colour, texture, bleed) in this browser as a first-class custom paper — its own swatch after the built-ins, usable as the default paper, with an disclosure to fine-tune grain size/angle/stretch, tooth, fibres, speckle, mottle, absorbency, bleed reach, feathering, dry skip and ink opacity (one undo step per drag; stores the change). Each custom swatch has a ⋯ menu (Rename, Delete, Export); the section ⋯ exports all papers or imports a papers (merge; duplicates skipped, clashes renamed). A document on a custom paper embeds the paper, so it opens identically on a machine without it (). makes a paper from a photo or scan (upload, or search Openverse, ambientCG and Wikimedia Commons — Pexels/Unsplash with your own key): it is de-lit, made seamless, sized in real millimetres (scan dpi or width), tinted by the paper colour, and keeps its credit; see (incl. the maintainer bundle script )

---

Pens & Paper

The Pen / Paper tab previews the plot the way it will come off the plotter: a realistic paper (tooth, fibres, bleed) and real pen models whose ink bleeds, blobs, pools and skips like the pen it names. Everything is a preview; the SVG stays plotter-clean.

• Paper: 11 papers (None plus ten realistic stocks), any colour, Texture, Ink bleed and Scale sliders, a per-user default.
• Pens: plain colour + diameter pens by default; a model chip per pen picks one of 15 real pens and its size (laid width = plotted width). Ink settings tune Bleed, Edge roughness, Opacity, Blobs & pools, Skips and Width jitter per pen.
• Edge bleed is drawn for plain pens too on realistic paper; edges are mm-locked, deterministic and cached with level of detail.
• Special inks (Ink settings ▸ Special inks, Pen Picker ▸ New Pen): metallic gold / silver / copper / bronze / rose gold, neon green / pink / orange / yellow / blue, glow-in-the-dark green / aqua, glitter gold / silver / clear, opaque white — on any pen (dual metallics come with the Pentel Hybrid Dual Metallic model). Metallic and glitter inks catch the light: flakes are fixed to the stroke in mm and the glints move as you pan and zoom (no idle animation). Neon inks glow a little on dark paper. Effect strength and Flake density sliders tune them.
• Lights off (View ▸ Lights Off, Shift+Alt+L): the sheet goes dark and glow-in-the-dark inks emit; a canvas chip turns the lights back on. View only, never saved.
• Pen files and My pens (Pens ⋯): Export pens / Import pens… (.json, imported pens get new ids, one undo step) and My pens, a library of saved pens in this browser (save from Ink settings, listed first in the model picker, apply / add / rename / export / delete).
• Pen model sources, confidence and the pen × paper formulas: docs/pen-models.md.

Mobile & Accessibility

Vectura works by finger and Apple Pencil on iPad and iPhone. Panels open as drawers, the tool rail is one row, and every control has a 44 px touch target. A canvas HUD, a modifier bar and a Help Touch tab replace the mouse and keyboard.

• Layouts: a classifier picks desktop, touch-wide (iPad landscape), tablet (iPad portrait) or phone. Phones and iPad portrait start with both panels closed as drawers over a dimmed backdrop. iPad landscape docks both. The page never scrolls, rubber-bands or zooms.
• Safe areas: header, drawers and the bottom chrome respect the notch, Dynamic Island and home indicator, including Home Screen mode.
• Canvas gestures: pinch and two-finger pan work with every tool. A two-finger tap undoes and a three-finger tap redoes. A one-finger drag moves a selected object after 6 px. A system interruption cancels the edit with no history entry. Apple Pencil wins over a resting palm.
• Canvas HUD: Undo, Redo, Zoom Out, Zoom In and Fit buttons at the bottom right.
• Modifier bar: Multi-select, Constrain, Duplicate and Pan apply to the next gesture. A double-tap locks one. A badge names the active tasks.
• Finger-sized editing: a tap within 22 px of a stroke selects it with Select or Direct (a locked layer selects nothing). 22 px grab radius for resize corners, anchors, handles, corner widgets, the 3D gizmo and Petal Designer points. Pen closes on a tap near the start and finishes on a double-tap. Done, Remove Last Anchor and Cancel chips show during a pen draft.
• Menus and holds: hold a layer row or the canvas for 0.5 s to open its menu. Hold a control label for "Reset to default". Hold an icon button to see its name. Tap a value chip to type a number.
• Panels: two-line Layers rows, drag-a-grip reorder with auto-scroll, 44 px sliders that move only on a sideways drag, 0.5 degree mirror dials, and inputs at 16 px so iOS does not zoom.
• Keyboard and sheets: fields and sheets stay above the on-screen keyboard. Export, Help, Document Setup, the colour picker and Save Preset use one pinned-header sheet. Toasts sit bottom-centre on touch, and deleting shows an Undo toast.
• Type tool: a tap opens the on-screen keyboard. The Text panel has a multi-line Text field.
• iOS files: open .vectura from the Files app and save through the share sheet. Camera-roll photos are resampled to 2048 px.
• Help: a Touch tab and Touch toggle, opened by default in the touch layout. The status hints switch to touch words (Tap, Multi-select + Tap) after touch or Pencil input.
• Accessibility: pane controls report aria-expanded and aria-controls. Menus have aria-haspopup. Focus moves into a drawer on open and back on close.
• Quality gates: a touch target audit ratchet, finger-only journey specs, a static touch guard and a real-device checklist (). The device run is still pending, so the app does not yet carry the release label for touch.

---

Algorithm Library

Algorithm	Description
Flowfield	Noise Rack-driven vector fields with stacked layers feeding angle or curl flow, plus density, step, and length controls
Boids	Emergent flocking paths with separation, alignment, and cohesion forces
Attractors	Lorenz-like and chaotic strange attractor systems
Hyphae	Branching, growth-like structures
Lissajous	Harmonic parametric curves with per-endpoint truncation and self-intersection trim
Harmonograph	Multi-pendulum curves with damping, anti-loop drift, settle cutoff, and a reveal-only Virtual Plotter preview (the pen traces the static figure on a loop)
Pendula	A kinetic-harmonograph studio built in parallel with Harmonograph: a Motion Rack of assignable temporal LFOs baked into the figure, Lateral (damped spiral-in) and Pintograph (non-decaying loops) machine types, a preset gallery, and Export Animated SVG
Wavetable	Layered noise wave stacks with multiple line structures (horizontal, vertical, grid, isometric, lattice)
Rings	Concentric rings with Noise Rack layering, per-noise Orbit Field / Concentric / Top Down sampling, and a controllable center diameter
Topo	Contours extracted from a Noise Rack height field with stacked layers and closed-contour mapping modes
Grid	Rectilinear mesh deformed by a stacked Noise Rack field with Warp and Shift distortion modes
Text	Sets a string in a built-in single-line (monoline) stroke font — five selectable styles (Sans, Italic, Condensed, Wide, Backslant) — or any Google Font (defaults to vendored Inter; the picker previews each family in its own typeface, searches the full ~2000-family catalogue, and traces a chosen family's glyph outlines into pen paths), and fits it to the frame as pen-ready line art. Supports multi-line, alignment, letter spacing, line height, frame-fit or absolute sizing, offset and hand-drawn jitter — plus optional native bezier outlines (with a Smoothness control), (Outline Weight + Parallel/Sinusoidal/Snake thickening), of glyph interiors — the (Hatch, Wave, Dots, Contour, Spiral, Radial, Polygonal, Truchet, Maze, Stripes, Weave), with holes carved automatically — plus a draggable and, for the fill, a that shifts the radial origin — for fill-only or filled-and-outlined type, and

Algorithm defaults live in src/config/defaults.js, modifier defaults/descriptions in src/config/modifiers.js, and algorithm descriptions in src/config/descriptions.js.

---

How to Use

1. Pick an algorithm in the left panel and adjust its parameters.
2. Transform the layer — expand Transform & Seed inside the Algorithm panel to adjust seed, position, scale, and rotation.
3. Post-process — use the Post-Processing Lab for smoothing/curves/simplify and optimization passes.
4. Manage layers on the right: add, reorder (drag the grip), duplicate, hide, rename (double-click), and expand into sublayers.

Use Mask on a silhouette-capable parent row to clip all indented descendants with that parent's visible silhouette. Inside the mask editor, Hide Mask Layer keeps the parent as the clipping silhouette while removing its own artwork from view and export. Mask parents ghost-preview their masked descendants outside the silhouette while you transform them, then restore normal masking on release.

Use Insert > Mirror Modifier to add a modifier container, then drag layers onto it in the Layers panel. Drag a child back out to root to unparent it. When a modifier is selected, + Add creates a normal drawable child under that modifier using the last active algorithm.

Select a child nested under a Mirror Modifier to edit it normally — the left panel switches back to Algorithm mode so parameter edits apply to the selected child while the mirror effect stays inherited from the parent.

The modifier row owns a Mirror Stack with per-axis show/hide, lock, delete, reorder, angle, and XY shift controls plus stack-level actions. Deleting the modifier dissolves only the wrapper and preserves its children.

Wallpaper mirrors open in a gallery-first Styles mode: a grid of cards, each a canonical thumbnail icon of that symmetry. Cards cover all 17 groups (in plain language) plus curated named recipes (Op-Art Weave, Courtyard, Switchback, Brick Path, Kasbah Tile, Snowflake Lace, Trefoil, …) — click one to apply it. A Surprise me dice rolls a random valid group with tasteful tile parameters (Shift-click locks the lattice family). On the canvas, drag the center puck to move the symmetry center and the rotate ring to spin the whole lattice (Shift snaps).

Switch to Build mode for the composable picker: pick a Lattice (parallelogram / rectangle / rhombus / square / hexagon), a Rotation order (1 / 2 / 3 / 4 / 6), and a Mirror set (None / Straight / Glide / …). The 17 crystallographic groups (p4m, p3m1, …) are derived from that tuple — invalid combinations snap deterministically to the closest valid group, flashing the auto-changed chips with a plain-language note. ⌘← / ⌘→ cycles through every group sharing the current lattice. Enable Show crystallographic group names in Document Setup → History & Preferences to surface the IDs alongside the chips.

Use Insert > Morph Modifier to add a blend container, then drop 2 or more layers into it in the Layers panel. The modifier fills the space between consecutive children with N graduated in-between rings — child A's shape progressively becoming child B's, including its size, position, and rotation. When two children run the same algorithm, the morph interpolates their parameters and regenerates each step (Parameter Morph, on by default) — a rotated and resized Polyhedron copy steps through the actual intermediate rotations and sizes (2D and 3D), and a changed setting (petal count, spin, density…) steps through its in-between values. Different algorithms or hand-drawn shapes blend geometry line-for-line instead, pairing paths spatially across the two children. Child layer order sets the morph direction; with 3+ children the chain runs sequentially (A→B→C, each pair its own segment) and Cyclic mode closes the loop back to A. The originals stay visible unless you turn off Emit Sources.

The morph also transitions fill: if the children carry paint-bucket fills, each in-between ring is re-filled with interpolated fill parameters (density, angle, and so on lerp between the two children when they share a fill type; a different fill type or seed switches at the midpoint). Toggle Morph Fill off for outline-only output. Pens stay discrete — each ring takes its nearest source child's pen.

The Morph panel exposes: Steps (intermediate rings per pair), Easing (Linear / Ease In / Ease Out / Ease In-Out / Cubic In / Cubic Out), Sequence (Sequential / Cyclic), Resample Count (common vertex count) and mode (Arc Length / Uniform Index), Correspondence (how start vertices align: Centroid + Angle / Nearest / Arc Length), Parameter Morph (same-algorithm pairs regenerate at interpolated parameters), Multi-Path handling when children have different path counts (Auto / Pair Paths / Index Match / Merge Centroid / Merge Longest), Morph Fill (on/off), Closure, and Smoothing. A live readout shows the child count and total step budget, with a warning when the point budget gets large.

Children dropped into a Morph group auto-lock (like Mirror). Morph output is plotter-ready polylines and is included in SVG export; Expand bakes each ring into its own shape layer.

Switch to the Petalis algorithm to access the embedded inline Petal Designer panel. Use ⧉ to pop it out into a floating window or ↩ to dock it back in.

Petal shape is driven by visible inner/outer designer curves. Controls include: always-on inner/outer count + split controls, a PETAL VISUALIZER (Overlay / Side by Side), a PROFILE EDITOR with an Inner | Outer toggle that shows one side at a time (it auto-switches to whichever side you interact with) plus per-side profile import/export and a shared Export Pair button, and Shading Stack + Modifier Stack cards where each entry has its own Petal Shape target (Inner/Outer/Both). Picking a named profile thumbnail also resets that side's Advanced sliders to a clean baseline so the shape isn't distorted by a leftover tweak; every Advanced slider (Base Flare, Base Pinch, Edge Wave, Tip Sharpness, …) shapes the designer profile.

In overlay view, clicking the visible inactive silhouette selects that shape directly. Designer interactions support Shift to constrain, Alt/Option to convert/break/remove handles, Cmd/Ctrl for temporary direct mode, middle-drag pan, and wheel zoom-to-cursor.

File > Document Setup (Cmd/Ctrl+K) covers: machine size, the document-level Metric/Imperial switch, optional blueprint-style dimension labels outside the canvas, margin, on-canvas crop, margin guides, the Default paper (Paper & Selection: a paper type or No default (follow theme), its colour, and Apply to this document), selection-outline styling, plotter physics, optional 10mm grid overlay, and cookie preference saving with Clear Saved Preferences.

The sun/moon toggle in the upper-right header switches the full UI between dark and light themes. A theme change recolours the sheet only while the document is on a plain (None) sheet in the theme's own colour and no default paper is set; an untouched Pen 1 always stays legible on the paper.

Export from File > Export SVG, which opens a large preview modal. Zoom/pan the left-side preview to inspect detail. The right side controls:

• Optimization scope — single layer or all layers
• Line Sort — nearest-neighbor print-order optimization with overlay preview
• Line Simplify — curve simplification with adjustable tolerance
• Remove Hidden Geometry — physically trims masked/frame-hidden geometry (on by default)
• Export Stroke Override — off by default, so the export honors each pen's configured width; turn on to surface the global Stroke (mm) slider and apply a single uniform width across the whole document
• Export Optimized — bundles the active optimization passes into the exported SVG

Click Export SVG to download.

Action	Shortcut
Tools
Selection tool	V
Lasso	Q
Direct selection	A
Hand / pan	Space
Pen tool	P
Fill	F
Erase fill	Shift+F
Add anchor	+
Delete anchor	-
Convert anchor	Shift+C
Rectangle	M
Oval	L
Line	U
Polygon	Y
Scissor	C
Canvas
Pan	Shift + Drag
Zoom	Mouse Wheel
Touch pan	Two-finger drag
Touch zoom	Pinch
Layers
Select all drawable layers	Cmd/Ctrl+A
Shift-click range	Range select
Cmd/Ctrl-click	Toggle select
Drag marquee	Marquee select
Duplicate selection	Cmd/Ctrl+D
Duplicate by dragging	Alt-drag
Nudge	Arrow keys
Nudge large	Shift + Arrow keys
Expand layer	Cmd/Ctrl+E
Group layers	Cmd/Ctrl+G
Ungroup	Cmd/Ctrl+Shift+G

Gesture	Action
Tap	Select an object or layer
Drag a selected object	Move it (starts after 6 px)
Drag empty canvas	Marquee select
Two-finger drag	Pan the canvas
Pinch	Zoom the canvas
Two-finger tap	Undo
Three-finger tap	Redo
Double-tap	Finish a pen path
Press and hold the canvas (0.5 s)	Select the object and open the canvas menu (Select, Direct Selection, Hand). On empty canvas the menu offers Select All
Press and hold a layer row (0.5 s)	Open the layer menu (or tap ⋯)
Drag a grip	Reorder layers and panel list rows
Tap a value chip	Type an exact value
Press and hold a control label (0.5 s)	Reset to default
Press and hold an icon button (0.5 s)	Show its name
Press and hold a tool marked ▸	Open its variants (or tap the active tool again)
Modifier bar: tap a task	Apply Multi-select, Constrain, Duplicate or Pan to the next gesture
Modifier bar: double-tap a task	Lock it on
Canvas HUD buttons	Undo, Redo, Zoom Out, Zoom In, Fit

---

Development

Testing

Command	Purpose
npm run test:feedback	Bounded local feedback: critical contracts and one real browser journey
npm run test:audit:proofs	Scene3D proof audits (tests/audit); CI runs them when scripts/audit-paths.js matches
npm run test:runner	Process cleanup and cancellation regression checks
npm run test:unit	Deterministic unit coverage for RNG/noise, algorithms, and utility helpers
npm run test:integration	Engine workflow, layer lifecycle, optimization pipeline, state roundtrip, export, UI bootstrap
npm run test:e2e	The whole Playwright roster (desktop, tablet, phone and the 11 touch projects)
npm run test:e2e:smoke	The PR browser smoke: desktop projects plus a 2-project touch smoke
npm run test:e2e:touch	Touch specs on 7 Chromium and 4 WebKit device projects (PW_PORT picks the dev-server port)
npm run test:e2e:touch:audit	Touch target and layout audit against tests/e2e/touch/target-baseline.json (:full for every state)
npm run test:visual	SVG baseline regression checks against tests/baselines/svg
npm run test:visual:screenshots	Linux pixel snapshots in the pinned Playwright image (docker); runs nightly in CI
npm run test:perf	Stress/performance checks for generation and optimization
npm run test:ci	Optional full local pass: lifecycle + coverage + audits + browser roster + perf
npm run test:update	Regenerates SVG goldens and this architecture's golden values (Node 24; review before commit)
npm run test:vitest -- <args>	Vitest with any arguments, e.g. one file: npm run test:vitest -- run tests/unit/foo.test.js
npm run test:playwright -- <args>	playwright test with any arguments, e.g. one spec

All test commands run through a shared local test queue (scripts/test-queue.js): one heavy run at a time across every worktree and session on the machine; other runs wait and say who holds the lock. Do not call npx vitest / npx playwright test directly. CI bypasses the queue. Details: docs/testing.md → "Shared Local Test Queue".

Vitest scripts clean up owned workers on completion/cancellation and enforce a 30-minute local per-attempt deadline (three hours in CI), even if the launching wrapper dies. Use VECTURA_TEST_TIMEOUT_MS to override it; see cleanup behavior and platform limits.

CI graph, goldens, corpora and push-gated follow-ups: testing guide.

Vitest config: vitest.config.mjs · Playwright config: playwright.config.js

Manual CI-equivalent setup:

• npm ci
• npx playwright install --with-deps chromium
• npx playwright show-trace test-results/<failing-test>/trace.zip opens a saved Playwright trace locally after a failed smoke run

Change	Minimum test run
Core logic / algorithm behavior	test:unit + test:integration + test:visual
Export / serialization	test:unit + test:integration + test:e2e
UI interaction behavior	test:integration + test:e2e
Rendering output or baselines	test:visual (+ test:perf for heavy paths)
Docs-only	Link/path sanity review only
Full gate	CI ci-ok (local test:ci optional)

Knowledge Graph (graphify)

This repository uses graphify to build an AST-based code map for efficient codebase navigation. After each commit and branch switch, git hooks automatically rebuild the graph—no API cost, just local parsing.

Setup:

pip install graphify

The knowledge graph lives in graphify-out/. Consult GRAPH_REPORT.md to navigate by community clusters and god-nodes before raw file searches.

To update manually:

graphify update .

Operations

• package.json is the canonical version source. Run npm run version:sync after changing it so the UI badge and src/config/version.js stay aligned.
• plans.md is the active punchlist. Keep Inbox, In Progress, Done, and Decisions current in the same PR as the implementation.
• CHANGELOG.md is intentionally human-curated. Keep Unreleased current during development and cut versioned entries when shipping.
• Architecture documentation uses Mermaid diagrams-as-code. Update diagrams whenever the system structure materially changes.
• The universal multi-engine noise system is called Noise Rack; all future noise-capable algorithms should converge on that shared model.
• npm run profiles:bundle rebuilds src/config/petal-profiles/library.js from index.json + profile JSON files for file:// local runs; run this after editing profile JSON files.

Deployment (GitHub Pages)

1. Push this repo to GitHub.
2. In Settings > Pages, set Source to "Deploy from a branch".
3. Select your branch (e.g. main) and the root (/) folder.

All asset paths are relative (./...), so the site works under a GitHub Pages subpath.

New algorithm: create src/core/algorithms/<name>.js, register it in src/core/algorithms/index.js, wire defaults in src/config/defaults.js, add a description in src/config/descriptions.js, and add UI controls in src/ui/ui.js. Algorithm noise work must use the Noise Rack — do not introduce algorithm-specific noise stacks.

Machine sizes: live in src/config/machines.js and are used for bounds and export dimensions.

Pen palettes: live in src/config/palettes.js — edit or extend freely.

Presets: are file-based — every preset is a .vectura file under user-presets/<layer_type>/ (the directory name matches the layer type / preset_system, camelCase included). Run npm run user-presets:bundle to regenerate src/config/user-presets.js (the single generated library, loaded into window.Vectura.PRESETS); don't hand-edit it. Identity/category live in a meta:{presetId, group, system, savedAt} block; the 15 <type>-default "reset to factory" markers are synthesized by the bundler from ALGO_DEFAULTS. id is lowercase kebab-case prefixed by system (e.g. petalis-camellia-pink-perfection). With Developer Mode on, the in-app Save dialog can write these files directly into a connected user-presets/ folder.

Petalis profiles: add .json files to src/config/petal-profiles/, list them in index.json, then run npm run profiles:bundle to update library.js. Keep profiles anchor-based (inner/outer shape payloads).

Script order: keep src/config/ files before core, before UI/render, before src/main.js in index.html. All modules register on window.Vectura as IIFEs.

flowchart LR
  HTML[index.html] --> Main[src/main.js]
  Main --> App[src/app/app.js]

  App --> UI[src/ui/ui.js]
  App --> Engine[src/core/engine.js]
  App --> Renderer[src/render/renderer.js]

  UI --> Controls[Panels & Controls]
  UI --> Export[SVG Export]
  Renderer --> Canvas[(Canvas)]

  Engine --> Layer[src/core/layer.js]
  Engine --> Algorithms[src/core/algorithms/index.js]
  Engine --> RNG[src/core/rng.js]
  Engine --> Noise[src/core/noise.js]
  Engine --> Modifiers["src/core/modifiers.js"]
  Engine --> Display["Display Geometry / Masking"]
  Modifiers --> Display
  Display --> Renderer
  Display --> Export
  Display --> Masking["src/core/masking.js"]
  Masking --> Boolean["src/core/path-boolean.js"]

  Config[src/config/*.js] --> UI
  Config --> Engine
  Skin[src/ui/skin/*.css] --> HTML

flowchart TD
  Package["package.json (Canonical Version)"] --> Sync["npm run version:sync"]
  Sync --> Version["src/config/version.js"]
  Sync --> Badge["index.html app badge"]
  Work["Feature / Fix Work"] --> Plans["plans.md"]
  Work --> Changelog["CHANGELOG.md"]
  Work --> Readme["README.md"]
  Work --> Harness["docs/agentic-harness-strategy.md"]
  Harness --> PR[".github/pull_request_template.md"]

Path	Purpose
index.html	App shell, Tailwind CDN config, and script load order
src/ui/skin/	Multi-skin theme system: tokens.css + motion.css + components.css plus per-skin palette files (classic + Meridian families)
src/app/app.js	Application orchestration, theme switching, cookie persistence, undo/redo history
src/core/engine.js	Layer lifecycle, algorithm execution, display geometry pipeline, serialization
src/core/algorithms/	One file per algorithm; index.js assembles the registry
src/core/layer.js	Layer state model
src/core/rng.js	Seeded random number generator
src/core/noise.js	Core noise primitives
src/core/noise-rack.js	Universal multi-algorithm noise stacking system
src/core/modifiers.js	Mirror-axis geometry, clipping, and reflection routines
src/core/morph-modifier.js	Morph blend math: arc-length/uniform resampling, correspondence alignment, path interpolation, and the multi-child dispatch path
src/core/masking.js	Silhouette capability detection, mask unions, live display-geometry masking
src/core/path-boolean.js	Polygon normalization and path segmentation used by masking
src/core/geometry-utils.js	Shared path smoothing, simplification, and cloning helpers
src/core/optimization-utils.js	Path length, sort, offset helpers used by the optimization pipeline
src/render/renderer.js	Canvas rendering, pan/zoom, multi-layer selection and transform handles
src/ui/ui.js	Panel management, parameter controls, Petal Designer, SVG export, file I/O
src/ui/randomization-utils.js	Shared parameter randomization engine with algorithm-specific bias profiles

File	Purpose
AGENTS.md	Repository guardrails and mandatory contributor/agent instructions
CHANGELOG.md	Human-curated release history with an Unreleased section
plans.md	Active punchlist: Inbox, In Progress, Done, Decisions
docs/agentic-harness-strategy.md	Source-of-truth harness for task intake, evidence standards, testing matrix, and doc sync policy
docs/github-governance.md	GitHub-side setup targets for Projects, rulesets, release notes, and review policy
docs/noise-rack-architecture.md	Migration plan and target architecture for the universal Noise Rack system
docs/testing.md	Test command guidance and CI policy details
docs/pre-release-hardening-log.md	Deferred hardening items for final-release prep

CI lives in .github/workflows/test.yml:

• Pull requests: unit, integration, and e2e smoke + dependency review
• main + nightly: visual regression and perf stress lanes
• main + weekly: CodeQL analysis

---

Release Notes

Unreleased - Realistic paper scale and lighting (v1.4.34)

• Paper looks like paper at fit-to-screen. Grain sizes recalibrated against real hot / cold / rough watercolour sheets; default Texture tuned so cold press and rough show about half the tooth contrast of a raking-light photo of the real sheets; tooth fades smoothly as it nears pixel size and returns as you zoom (no jumps at zoom or Scale steps); fibres stay visible on kraft, rag and newsprint, and a fibre mat appears at deep zoom.
• No more grey sheets. The surface is lit around the paper colour: lit facets brighten and shadows darken, so the sheet's average colour is the colour you picked; white and saturated stock keep visible tooth (soft highlight roll-off).
• Scale slider (Pen / Paper ▸ Paper, 25–300 %): grain size per document, saved in the file and in custom papers; it also scales a photo paper's tile. Saved Texture values are kept.

Unreleased - Special inks, Lights off, pen files (v1.4.32–v1.4.33)

• Special inks. Metallic, neon, glow-in-the-dark, glitter and opaque white inks on any pen; metallic and glitter sparkle at every zoom and their glints move as you pan and zoom. Preview only: the SVG still plots the pen colour at the pen width.
• Lights off. View ▸ Lights Off (Shift+Alt+L) darkens the sheet so glow-in-the-dark inks emit.
• Pen files and My pens. Export / import pens as .json; save pens to My pens in this browser and reuse them.

Unreleased - Pen models and ink edge bleed (v1.4.31)

• Pen models. Pick a real plotter pen and size per pen (15 models); width becomes the pen's laid width, and the preview draws its ink: bleed edges, blobs, pools, skips, opacity and overlap darkening. Plain pens stay the default and unchanged on paper None.
• Ink settings. Bleed, Edge roughness, Opacity, Blobs & pools, Skips and Width jitter per pen, one undo step per drag, Reset to model defaults.
• Ink edge bleed on realistic paper, plain pens included; mm-locked, deterministic, cached with level of detail. SVG export unchanged.

Unreleased - Custom papers (v1.4.30)

• My papers. Save any paper as a custom paper in your browser, tune its realism under Advanced, rename/delete/export it, export all or import a papers file, and use it as the default paper. Documents embed their custom paper, so they open the same on any machine.
• Photo papers. Make a paper from a photo/scan or an open-licence texture found in the app (Openverse, ambientCG, Wikimedia Commons; Pexels/Unsplash with your key), sized in real millimetres with its attribution kept.

Unreleased - Paper selector (v1.4.28)

• Pen / Paper tab. The Pens tab is now Pen / Paper with a Paper section on top: 11 paper types (None plus ten realistic stocks), any colour, Texture and Ink bleed sliders, Set as default / Use default.
• Realistic paper preview. Seeded tooth, fibres, speckles and mottling sized in real millimetres; ink multiplies into the sheet, skips tooth valleys, and bleeds/feathers on absorbent stock. None is pixel-identical to before. SVG export is unchanged (no paper).
• Saved per project, one default. Paper is stored in the .vectura file (settings.paper); the default paper lives in Document Setup ▸ Paper & Selection, replacing the Background colour picker.

Unreleased - Touch support

• Touch and Apple Pencil across the whole app. Phones and iPad portrait open panels as drawers. The tool rail is one row. A canvas HUD gives Undo, Redo, Zoom and Fit. Pinch and two-finger pan work with every tool. A two-finger tap undoes and a three-finger tap redoes. The modifier bar replaces Shift, Option and Cmd (Multi-select, Constrain, Duplicate, Pan). Hold a layer row or the canvas for its menu, hold a label to reset, tap a value chip to type.
• Finger-sized controls. Every control has a 44 px hit area, sliders move only on a sideways drag, inputs are 16 px so iOS does not zoom, and fields stay above the keyboard. Handles, anchors, the pen, the Direct tool, the 3D gizmo and the Petal Designer use a 22 px grab radius.
• Help and hints. Help has a Touch tab and a Touch toggle. Status hints use touch words after touch input. See the Touch gestures table under How to Use.
• iOS files. Open .vectura from the Files app, save through the share sheet, and import large photos safely.
• Test and release gates. Touch target audit, finger-only journeys, static touch guard and a real-device checklist. Real-device results are pending, so the release label for touch is not yet claimed. Details: CHANGELOG.md and docs/touch-audit/.

1.4.20 - Touch nightly on Linux

• Holds and drags. A long-press on the canvas no longer opens its menu in the middle of a slow drag and reverts it (gizmo rings, handles, pen anchors, objects).
• Touch layout on every OS. Info buttons, the modifier bar, the right-pane tabs and toasts no longer depend on font metrics. On iOS, the slider value chip and the min/max editor commit when you tap outside them.
• Faster, steadier touch nightly. Timer-dependent touch tests run on a frozen page clock, target sweeps run in one browser call, and the nightly runs in 21 per-project legs (target 25 minutes each). Details: CHANGELOG.md and docs/testing.md.

1.4.18 - Test and CI overhaul

• One required check. ci-ok gates every PR. PRs run the whole Vitest roster in 8 uninstrumented shards, a 4-leg browser smoke, perf and the routed Scene3D audits. Coverage, the full touch roster and linux pixel snapshots run on main and nightly, and a red run opens an issue.
• New canaries. Every bundled preset, 13 legacy saved files, every algorithm in a real browser, SVG goldens for 11 more algorithms and 35 canonical 3D scenes. They found 6 product defects (PRH-029 to PRH-034), logged in plans.md.
• Leaner suite. Tests no longer read git history; golden values regenerate with npm run test:update. Duplicate Scene3D tests were cut with mutation proofs.
• Timing. PR wall time is projected at about 6 minutes (from about 17). This is not yet measured on hosted runners. Details: docs/testing.md.

1.4.15

• 3D Scene — Duty Cycle · Constant responds to Density above 50. Density 50 to 100 now tightens the rulings past the plot floor, evenly in ink coverage, down to one pen width (lines touching) near the top of the slider, so the deepest shadow floods to solid ink. Density 50 and below draw exactly as before.

1.4.6

• 3D Scene — pen routing, chaining and cleanups (U7). Tone bands (2 to 4) split any Fill Style by the tone under each mark and draw band 1 to N with the pens you pick in the Band pen rows; the three-pen styles get Tier N pen pickers in the same way. The SVG export puts each pen in its own group. Voronoi Web gains Chain edges (path count and pen travel drop sharply). Stipple shows Simplify where it changes the dots. Alt fill lines gain Alt angle and cross at the shared Cross angle. The wireframe Show hidden switch is folded into Edge Styles > Hidden > Occluded (old documents load unchanged). X-ray Front line stays visible on box, plane and solid, greyed with a reason. The Help Guide has a 3D Scene section (Algorithms tab). Every default is unchanged.
• 3D Scene — new artistic controls in the Style tab (U6). Tone shaping adds Gamma and Contrast (one curve every Fill Style reads) and Depth fade (far surfaces draw lighter: strength, start, full). Wave gains Wavelength and Crest phase. Width Ribbon gains Nib angle / Nib contrast and Taper length / Tip width / Softness. Turing Stripe gains Maturity and Stripe scale. Hatch Angle ref gains Light (the hatch turns with the sun, faceted shapes). The three-pen Fill Styles gain Tier pens (tier 1 to 3 draw with pens 1 to 3 of the palette; the SVG export groups them by pen). Maze gains Chain walls (touching walls join into polylines: far fewer pen lifts, same ink). Every default is unchanged; a control writes nothing until you move it.
• 3D Scene — the Object 3D Style tab reaches every style control. In a scene tree the scene Style editor only styles the ground; the Object 3D panel now offers all of its rows (cross, spiral, dot, wireframe, Stroke, Highlight, X-ray), plus Wobble scale, Overstroke, spiral Pitch, contour Step, quantised-field Levels and the shadow's Tone depth. Density reaches 500.
• 3D Scene — honest controls. Rows that cannot apply to the shape are removed; rows the Fill Style ignores are greyed with an (i) reason. The Fill Style picker greys only styles that draw exactly like Ladder (measured), so curved Spiral / Stipple offer their full range again.
• 3D Scene — Layers-panel "Assign pen" on an Object 3D row now routes its ink.

1.4.3

• 3D Scene — curved-primitive borders now sit on the true silhouette. A sphere, ellipsoid, cone, cylinder, or capsule's drawn outline used to fall up to 0.72 pen short of the real edge (a projected-mesh chord polygon), so rulings that correctly reached the surface's edge read as breaking out past the grey border. The border now sits on the analytic silhouette instead — worst overshoot falls to 0.02 pen — with fill ink unchanged. The torus keeps its previous outline (its silhouette isn't convex enough for this fix); every faceted or unsupported primitive is untouched.
• 3D Scene — Dash Ramp draws discrete dashes at low Density. Below a density threshold each mark is a single pass instead of a band of parallel passes, and its length is bounded, so a sparse sphere reads as discrete dashes riding the rulings. Mid and high Density are unchanged.
• 3D Scene — tick fills grade toward the dark edge of each band, narrowing (not yet closing) the bare strip at the bottom of a wave band, and no longer grow a single tick past its own band on a wide one.
• Known open. Whether to retune the crosshatch cap's onset — measured infeasible without a different mechanism this round — and whether the tick fills' residual gap is acceptable, are both open product decisions not settled by this release.

1.4.2

• 3D Scene — "Min rulings" (per fill style). Hatch and Crosshatch styles gain a minimum facet rulings control (1–8, default 3) setting the fewest rulings a flat facet may receive when Density asks for fewer. Default 3 is byte-identical to previous releases; no effect on smooth shapes, on Contour / Spiral / Stipple fills, or on the ground plane.
• 3D Scene — the Fill Style roster collapses further, to 30. Pen Stipple, Pen Pitch Match and Pen Facing now appear as modes of Pen Interleave. Every folded style now explains itself in plain language on both the Fill Style row and the Shadow row, on the docked panel and the context-bar flyout. A shadow using a folded style shows that style's own recipe rather than the surviving style's.
• 3D Scene — Dash Ramp fixed at both ends. A full dark tone returns at maximum Density (drawn as a short band of parallel passes); a readable row of dashes returns at Density 1, rising smoothly across the range.
• 3D Scene — tick fills and wave-ribbon fills are placed evenly. Tick fills no longer leave an un-ticked band where rows line up. Wave-ribbon fills (the twelve pen-width RIBBON laws) no longer leave a deep bare strip on the lower front of curved forms, and no longer collapse to a bare centreline when an internal geometry step silently failed.
• 3D Scene — crosshatch spends a full hatch budget per family, with a new cap so maximum Density does not fill solid.
• Context-bar flyout labels no longer cut off mid-word — a long fill-style label now ends in an ellipsis instead of a clipped fragment.
• Known open. Whether to retune the crosshatch cap's onset, and whether to restore wave-ribbon weight while keeping the new even placement, are both open product decisions not settled by this release.

1.4.1

• 3D Scene · crosshatch draws a real crossing grid again. The two crosshatch line families now split one shared coverage budget evenly instead of the second family receiving roughly a tenth of the first's. Measured gap ratio between the families falls from 5.4–31.2× to 0.81–1.06 across every primitive and density tested, with total ink essentially preserved.
• 3D Scene · curved rulings and slice rings lose their invented corners. Ring refinement now stops on a device-space measurement — millimetres on paper, where the eye sees it — instead of a world-space one, and the capsule gains its own true cross-section. Worst per-vertex turn on contour fill rulings falls from 18.5–38.4° to at or under 8° everywhere; the capsule's slice rings from 297% over their analytic truth to 2.6%. Slices also keeps its evenly-spaced rings: the crowding cull is now scoped to genuine multi-level pileups, lifting ink retention on a torus from 70.8% to 96.2% while leaving cone and cylinder untouched.
• 3D Scene · shadows that land on other objects follow the light. A point, spot, or area light's shadow-receive footprint is built from the light's real position rather than a fixed default direction; area lights keep their soft edge when partially occluded; an ambient light listed first no longer deletes the next light's cast shadow; and a torus casts a visible, correctly-holed shadow instead of none at all. Known limitation: a razor-thin torus still casts a blank shadow at a major:minor tube ratio of roughly 465:1 — unreachable through the UI (the sx slider caps at 200) but reachable via a hand-edited or imported .vectura.
• 3D Scene · the Fill Style roster collapses two rows further, to 33. weaveDepth now lives behind a Nesting control on Amplitude Spacing and onePenDown behind a Pen down control on Interlock Weave; both render exactly as before, and saved documents resolve to the surviving option at load. Counting convention, stated once so the notes stop disagreeing with themselves: PICKER_IDS — the collapsed list — is 33; the picker offers 34 (that list plus ladder); IDS, the engine's own vocabulary, stays 48 forever. The 1.4.0 entry below reports the same series at its own shipped figure of 35, and is left as shipped; post-1.4.1 the correct figures are 48 → 33 with 15 aliases across 7 collapse clusters. A picker showing a pre-collapse law now also displays the right sub-control value, and a saved torus using Origin Spiral opens as Ladder — that one pairing cannot be plotted cleanly.
• 3D Scene · Slices gains End overlap. How far each depth-slice ring is carried past (or pulled back from) the silhouette, in pen widths (−2…8). The default is 0 and is byte-identical to previous builds; the control is inert on box, plane and pyramid.

1.4.0

• 3D Scene Studio — the headline feature. 3D Scene grew from a single mesh into a full scene-tree editor: objects, the ground, and lights are independent tree children you can click-select, transform with a unified move/rotate/scale gizmo, and re-style individually. A scene can hold multiple solids (box, sphere, cylinder, cone, torus, capsule, polyhedron, buckyball, or a converted Topoform/Polyhedron layer) plus imported OBJ/STL meshes, which are welded, budgeted, and rested on the ground automatically. Boolean groups (union / intersect / subtract, curved and faceted) carve real CSG holes with per-fragment styling, and six light types — directional, ambient, point, spot, area, and emissive — drive shading, reflected light, a terminator dip, and controllable cast shadows with real anatomy (contact collar, umbra wedge, penumbra), including shadows landing on other objects in the receiver's own fill style.
• 3D Scene fill styles, unified and audited. Roughly 35 tone/fill laws — ladder, crosshatch, spiral, contourSlice, voronoi web, and the twelve pen-width RIBBON laws among them — were fixed to shade correctly on curved surfaces, including a torus-wide inverted-normal bug that had silently deleted 40-58% of several laws' output. The Fill Style picker also collapsed 13 near-duplicate options into 5 canonical entries (48 → 35 total); saved documents resolve to the canonical option automatically with no change to any drawing.
• Pen-width stroke fill. Variable-width tone laws now build a true pen-width outline, clipped exactly to the visible silhouette, instead of asking the renderer for an unplottable fatter line. A new strokeFillStyle control (spiral / concentric / serpentine / contourParallel) chooses how the interior fills.
• Draw Order and a plot-physics readout. The on-canvas colour preview, playback, and exported SVG now agree on pen order, and the Document Overview shows a per-pen ink/time breakdown of the plot.
• Stroke Divisions editor, with a pen-assignment mode (Cycle / Random / …) for multi-pen divided strokes.
• Industry-parity Live Corner styles — Round, Inverted Round, and Chamfer — with live freeform corner dragging.
• Also: paint-bucket venn faces for overlapping shapes, .vectura schema versioning, and a coverage-threshold ratchet in CI.

1.3.99

• 3D Scene — the ladder-family fill styles no longer skip alternate rulings on flat-toned surfaces. Ladder, Fine Ladder and Phase Fine Ladder used to select a subset of a fixed grid on a cone, cylinder, capsule barrel or any evenly lit region, drawing doubled-width white gaps with no shading behind them. Rulings now place continuously, and the spiral no longer drops whole turns. A related over-inking regression in crosshatch's second family, found while closing this, is also fixed.
• 3D Scene — several curved-surface and contourSlice fill defects fixed: the master grid's sparse (low-Density) end on curved primitives now actually opens up instead of drawing the same ruling count from Density 1 to 49; chart-walked tick and dash marks bend with the local surface instead of drawing a straight chord (torus ticks no longer read as straight spoke fans); originSpiral respects the plot floor on torus and cone; a ground plane (or any single-orientation faceted object) now tracks Density properly instead of a fixed ruling count; thin sliver faces on curved primitives get a genuine spiral curl instead of a near-straight stub; and contourSlice rings snap onto the true analytic surface, fixing torus ring fragmentation and open buckyball rings. Origin Spiral now greys out with a "no effect here" note on a torus in the Fill Style picker, instead of silently producing a defective plot — saved documents that already picked it are unaffected.
• 3D Scene — cast shadows can land on other 3D objects, in the receiver's own fill style, and overlapping shadows from multiple casters darken through a genuinely tighter ruling pitch instead of drawing invisible duplicate lines. Off by default (shadow.shadowReceiveOnObjects).
• 3D Scene — the Fill Style picker roster collapses 13 near-duplicate options into 5 canonical entries plus a sub-parameter, 48 options down to 35, with no change to any option's rendered output. A saved document that named one of the folded options resolves it to its canonical survivor plus the matching parameter on load — the drawing is unchanged either way.
• Known open: a residual streak defect on five self-crossing ribbon fill laws (interlockWeave/onePenDown/trochoidLoop/ampSpacing/weaveDepth) is measured but not yet fixed; contourSlice's ink-merging at a torus/sphere's saddle and pole points is improved, not eliminated; and the shadow-receive footprint projector above is tested but not yet reachable from any real scene.

1.3.85

• 3D Scene: a new scene arrives with ink on it. Inserting a 3D Scene seeded a box under the wireframe mapper, and that pair puts no ink on the object at all — wireframe never reaches the surface-fill emitter, so the object drew only its structural edges, nine straight lines on a cube. A freshly dropped scene composed 113 paths of which zero were the object's surface (100 were the ground's cast shadow, 4 the ground quad), and on canvas it read as an empty cube outline. The seed is now a sphere under hatch, resting on the ground, so lighting, tone and the mapper are visible the instant the object appears. Box and wireframe are unchanged and stay one click away — the Add Objects shelf and the object Style flyout. The scene-scope fallback deliberately stays wireframe: it is what the ground fixture resolves to, and hatching it floods the ground quad.

1.3.84

• Draw Order: the colours, the playback and the exported SVG finally agree. The on-canvas gradient sorted every optimized path globally by its line-sort order and ignored pen grouping, while both playback and export finish one pen before swapping to the next. Export is the authority — a plotter cannot swap pens mid-sweep — so the gradient had been promising a top-to-bottom pass the pen would never make. All three now read one plot sequence. Two related faults went with it: with stroke divisions on, the overlay and the reveal were looking at different path objects, so the gradient never revealed in lock-step; and the optimizer ran one layer at a time when no explicit config was passed, quietly demoting "Combined" and "Per Pen" grouping to per-layer.
• Draw Order: the overlay is pinned to where the ink actually lands. A previous attempt at the fix drew the coloured preview offset from the real artwork, with stray segments in empty corners of the canvas, and the test suite never noticed — every draw-order test checked the order of paths, none checked their position. There is now a regression test that records what the canvas draws with the overlay off and on, and fails if the overlay puts ink anywhere the artwork did not.
• Known gap: 3D scenes still have no draw order. A scene's composed geometry lives on the group, which is never an optimization target, so no scene path carries a line-sort order. Rather than colour composition order as if it were plot order, the Draw Order overlay leaves scenes alone. Giving scenes a real draw order (and a non-empty SVG export) is tracked separately.

1.3.83

• 3D Scene: the border is a real outline again. Style ▸ Border drew each mesh edge as its own two-point segment and offset it along its own screen normal, so the outline broke at every shared vertex — and raising Fidelity only made it worse. 104 of 112 border paths were two-point straight sticks, which no curve fitter can smooth, so Curves and Smoothing had nothing to work on and the border came out lumpy. The border is now chained on mesh topology and offset as one polyline, so it is contiguous at every Fidelity and a torus seen face-on keeps both of its loops.
• 3D Scene: the plain silhouette stops fragmenting. Same cause on the Border-off path — the 0.6 mm emission floor judged each segment instead of the outline. A sphere lost 92 endpoints at Fidelity 60 and a capsule outline shattered into 18 pieces; both are now unbroken at every Fidelity, while the sub-millimetre whiskers the floor exists to cull are still culled.
• 3D Scene: line output splits by role. The Object tab's Curves / Smoothing / Simplify now govern the border — silhouette, creases, face outlines — and a new Fill lines group on the Style tab governs internal fill lines, so a crisp outline over softly fitted hatching is finally expressible. A new Style ▸ Fidelity sets sampling density along each fill line; the Object tab's Fidelity still sets mesh tessellation.
• 3D Scene: shadows get anatomy. Shadow ▸ Layers (Off / 2 / 3 / 4) built nested inset rings that read as a flat blob. It now builds shading in stages — a contact accent at the base, a retreating umbra wedge, graded penumbra, a dissolving tail — redistributing ink rather than adding it. Cast shadows meet all fifteen of their design criteria; object shading is much improved but still under review. Reflected light and a terminator dip are new, a cube's faces now order correctly by incident light, the faceted highlight treatments are distinct marks again, and Density is live on curved objects (ball fill ink 3001 → 6618 mm across Density 10 → 100).
• 3D Scene: labels that tell the truth. Shadow "Falloff" is now Softness, the highlight "Keep" is now None (and hides the rows it never used), and the Geometry rows name the quantity they show — an 80 mm torus was 125 mm across. No saved document changes.
• Also fixed: a Buckyball is built at the Radius it states (it was 13.1% under), expanding a scene monolith no longer drops a scene-scoped fill, and every contextual-task-bar dropdown now opens away from the nearest viewport edge with its caret pointing the right way.

1.3.0

• Parameter-space morphing. The Morph modifier now interpolates two same-algorithm children's parameters per step and regenerates real geometry instead of blending baked polylines — rotated or resized copies morph through true in-between transforms, and 3D rotation params tween cleanly instead of tangling. A new Pair Paths multi-path strategy pairs paths across children by centroid + size correspondence and is now the default, replacing the old blob-averaging fallback.
• One curve system. Curves, Smoothing, and Simplify were eight, five, and six independently drifted implementations spread across the canvas, exporter, and editor. They now share one path-drawing module and one real Bézier fit computed in the engine, so the preview, export, and plotter can no longer disagree — and output shrinks (Rings −96%, Harmonograph −73%) instead of ballooning the way the old draw-time quadratics did.
• 3D rotation gizmo, rebuilt. Three axes (amber/violet/cyan, no more backing-disc blob) on every 3D algorithm, with real Rotate Z support added to Polyhedron and Raster-Plane.
• Raster-Plane hidden-line fixes. See-Through now shows occluded slices as dashed lines instead of deleting them; Mesh and Topography get true analytic hidden-line removal; Lines-as-Planes curtains clip exactly at their border with no leaked ink.
• Every parameter control now speaks one language. Sliders, dials, and toggles across the app share one component library, one changed-from-default marker, and one-click reset.
• Dozens of smaller fixes: welded script-font outlines, left-aligned text no longer drifting while typing, angle-dial corruption on non-[0,360] domains, keyboard shortcuts leaking through open modals, and CI hardening (a birpc RPC-timeout tolerance and real coverage instrumentation).

1.2.69

• Terrain: hidden lines stop poking through the ridge in front of them. Terrain used the same occlusion slack that caused the Raster-Plane whiskers — up to 12.8px of line drawn inside the terrain it should have been behind. Occlusion Bias now defaults to 0 (clip exactly at the silhouette); nothing is lost but the protruding ink.
• Two-point perspective converges again. Terrain's default preset was quietly pinning the vanishing points to the canvas edges, which flattened two-point mode into a rectangle with no perspective at all. The curated vanishing points are back, and a new guard stops any preset from pinning a value for a control it does not even show.

1.2.68

• Raster-Plane: See-Through makes the planes see-through instead of deleting them. With Lines as Planes on, ticking See-Through used to throw the slices away — the vertical planes vanished and you were left with the bare top profiles. It now does what it says: the same slices, occluded the same way, with everything hidden behind them drawn as dotted lines. You see exactly where each plane stands inside the solid. Works for both a solid slab and free-standing slices, so Plane Width — which See-Through used to ignore — now applies there too, alongside Occlusion Bias.

1.2.67

• Changed parameters are marked, and one click resets them. Any control sitting away from its default now carries a small dot — including values you never set yourself, because a preset carried them or enabling a mode seeded them. Click the dot to put that one control back.
• Presets stop shadowing the defaults. A factory preset now carries only the values it deliberately curates instead of a full 50+ key dump, so the app's defaults are the defaults — no invisible overrides. Your presets and layers look exactly as before.

1.2.66

• Raster-Plane: Lines as Planes now starts thin, with no occlusion slack. Plane Width defaults to 1 — free-standing curtains are the look the mode exists for. Ticking Lines as Planes no longer seeds an Occlusion Bias of 1.5, which was the largest single cause of lines poking through the curtains in front of them (over a pixel of protrusion). All five shipped Raster-Plane presets were zeroed to match; the Crater preset went from 925 breakthrough points to none.

1.2.65

• Raster-Plane: Lines-as-Planes stop exactly at the curtain border. With See-Through off, every row used to leak a little ink through the curtain in front of it — hooks and whiskers along each border, worst at thin Plane Widths. Occlusion Bias now defaults to 0, which means "clip exactly at the silhouette"; the old 0.5 default was the slack that let a farther row poke through. The slider stays for anyone who wants grazing lines kept whole. Clipped lines also now end precisely on the border rather than a fraction short of it, so the fix doesn't trade hooks for gaps. Bars, Mesh and Topography are unchanged.

1.2.64

• Raster-Plane: Mesh and Topography get true hidden-line removal. With See-Through off, the wires are now clipped against the surface itself instead of only back-face culled, so a valley behind a hill no longer draws through it. The clip is exact (analytic, not rastered): each wire is split precisely where it crosses the surface's silhouette, so lines end on the edge with no protruding stubs, no chewed crests, and no gaps at an overlap join. See-Through output is unchanged.

1.2.59

• Raster-Plane: hidden lines stay hidden. Lines-as-Planes occlusion order now derives from each slice's plan position instead of its sampled height, so back rows no longer break through front curtains on high-contrast sources (worst at narrow Plane Width). Fix applies to cardboard slices, the solid slab, and plain ridgelines.
• Raster-Plane: Map Blur works in every mode. The blur now smooths the height source at the sampler, so Relief Lines, Mesh, and Bars benefit — not just Topography. Blur 0 stays byte-identical to previous output.
• Raster-Plane: Map Type "Normal" is real. Tangent-space normal maps now reconstruct height by integrating the encoded slope field (cached per source), replacing the old placeholder transform. Flip Y is the green-channel convention switch.

1.2.40

• Type tool gets a live web font, per-pair kerning, and an Outline Text action. New Type-tool layers now default to a vendored Inter web font parsed at boot, so they're editable with real letterforms the instant you start typing. Kerning gains a per-pair manual override alongside the existing uniform tracking, and the context bar can convert a text layer straight to its outline.
• Eyedropper gets a sampling loupe. The color picker and pen-picker popover's eyedropper now shows a magnified preview circle that follows the pointer while you sample a color.
• Minimal-anchor path re-trace. A new geometry op re-traces a bezier contour into the fewest editable anchors that reproduce it within a sub-pixel tolerance, surfaced through the renderer's node overlay.
• Fixed: cutting a closed path with the scissors tool no longer silently re-closes it on the next selection refresh.

1.2.39

• Tools Parity — feedback pass (15 fixes). Shift/Cmd-click now multi-selects (and a Shift-marquee adds to the selection); isolating a group locks selection to that group until you press Escape. The contextual task bar gets a working drag handle (it follows your pointer now), Font / Font Style dropdowns with carets that open beneath the control, a Point Type ↔ Area Type toggle, and a "Show Properties panel" action that opens the Text panel and hides the ABOUT blurb. The edit-path buttons now light up based on what you select (one anchor → remove / cut / convert; two endpoints → connect), and Smooth opens a live rounding slider with Done + Auto. Every right-click and task-bar command is now also in the top menu — including a new Object menu and a Contextual Task Bar toggle under View. Each pen gets its own stroke-weight slider and number box; the standalone stroke-weight menu is gone. Plus: context-menu Flip now actually redraws, and smart-guide labels stop drifting on Retina displays.

1.2.38

• Tools Parity — Phase 3 (final). The finishing lanes land: the Transform section gains editable X / Y / W / H fields (with a link-ratio toggle and per-anchor X/Y in Direct-Selection) plus Flip Horizontal / Vertical buttons; the Text panel's font picker live-previews a family on hover and swaps the size scrub for a real size-preset dropdown; a rail "…" All Tools drawer lists every tool grouped by category with a grid/list toggle and rail cross-highlighting; and right-clicking the canvas opens a context menu of the usual verbs (Duplicate, Delete, Group, Isolate, Simplify, Smooth, Flip, Transform). A new Align centers (both axes) button snaps a selection concentric in one step, and multi-selections with differing stroke weights now show a "mixed" indicator. This completes the Tools-Parity effort across all 13 lanes; no AI tooling anywhere.

1.2.37

• Tools Parity — Phase 2: the Contextual Task Bar. Selecting an object now floats a small contextual toolbar below it with exactly the actions that make sense — edit path, pen, stroke weight and Simplify inline sub-modes, shape properties (corner radius / side count) for live rectangles and polygons, group / align / isolate, and text. Double-clicking into a group shows an isolation breadcrumb across the top of the canvas so you always know how deep you are and can step back out one level at a time. The bar's enabled state and pinned position persist with your document and preferences. Toggle it under Document Setup → Guides & Display; no AI tooling anywhere.

1.2.36

• direct-manipulation editing (Phase 1). A big foundation drop toward parity with pro vector tools: an 8-handle selection box (edge-midpoint resize), Flip Horizontal / Vertical, object-to-object smart guides with labeled magenta guides + live dX/dY chips, a full Stroke Options surface (caps / joins / miter / align / dashed lines), an anchored Pen Picker popover, Simplify / Smooth / anchor path verbs, Outline Text (a Text layer → per-glyph editable paths), and a contextual hint bar with live tool / zoom / rotation readouts. Most of these become one-click actions in the upcoming floating Task Bar; no AI tooling anywhere.

1.2.35

• Bold edges are now clean at any zoom. The tiny notches along bold letter silhouettes came from coarse join-disk sampling in the band build (a geometry bug older than the banded bold itself); adaptive arc resolution removes them — and as a bonus makes first-render of bold text ~6× faster.

1.2.34

• Bold text coverage, mathematically honest. The bold band is a pen-disk sweep, so a round pen can reach every point of it — sharp junction corners included. The fill now honors that: 22/26 letters measure exactly 0.00% uncovered, the rest are within a hair of measurement noise at a single junction pocket.

1.2.33

• Bold text now plots truly solid. Fixes from in-app review of the banded bold: interior passes no longer vanish on curved glyphs (the hollow-ring look), the letterform silhouette is bump-free, bowl spines are fully inked, and pass spacing now follows your actual pen's width (changing a pen's width regenerates text that uses it).

1.2.32

• Type fills gain the full Paint Bucket control set. The Text panel's Fill tab used to offer only five fill types (Hatch / Spiral / Dots / Stripe / Cross-Hatch) and a density slider. It now shows the same variant grid and per-variant parameters as the paint bucket tool — every fill type (Hatch, Wave, Dots, Contour, Spiral, Radial, Polygonal, Truchet, Maze, Stripes, Weave) with its complete set of knobs — because both surfaces render from one shared module and pour through the same fill engine. The Text-only main Angle dial, Fill Offset pad, and Inset control are kept alongside it.

1.2.31

• Google Fonts are listed by popularity. The web-font picker now leads with the most-used families (Roboto, Open Sans, Lato, Montserrat, …) and falls back to alphabetical for the rest; the Built-in single-stroke faces move below the Google Fonts section.

1.2.30

• Built-in bold plots as one snaking, gapless stroke. Heavier weights of the built-in Vectura font used to draw stacked parallel copies of every stroke, which crossed into doubled-ink lattices at junctions (the t crossbar, the e bar) and splayed open at terminals. Each glyph is now swept into a single welded band and filled with concentric passes stitched into a continuous snake — junctions weld clean, terminals get round caps, and the ink edge lands exactly on the letterform. A new Ink Overlap control (Text panel → Stroke, default 15 %) sets how much adjacent passes overlap as a fraction of the pen width: spacing is penWidth × (1 − overlap), so the fill is gapless at your actual pen size.

1.2.29

• Editing the Text panel specimen no longer swaps fonts. The live traced letterforms stay visible while you type in the specimen; the CSS stand-in stays hidden.

1.2.28

• Built-in font curves are now truly smooth. The Vectura stroke font's bowls, arcs and splines render as native béziers instead of faceted chords — designed curves read smooth at any size while stems and serifs stay faithfully sharp.

1.2.27

• Edit web-font text on the canvas. Point and Area type set in Google Fonts faces now supports full on-canvas editing (caret, selection, typing), exactly like the built-in face.

1.2.26

• Bolder built-in text stays legible. Heavier weights of the built-in Vectura font draw as extra pen passes; those passes now widen each letter's advance so stems don't merge, and their thickness is optically clamped by size so small text keeps open counters while large caps still get the full weight. One pure metric source (StrokeFont.weightMetrics) drives both.
• Fill Angle dial now matches the plot. The text Fill Angle dial drew hatch lines perpendicular to the needle — a "/" pick rendered "". The canvas fill and the panel specimen now both draw parallel to the dial. Also fixes a winding-epsilon glitch on glyphs that fall back to coarse contours.

1.2.25

• Convert text between Point and Area type in one click. A conversion dot at the right edge of a selected text layer toggles the mode — a hollow ring for point type, a filled dot for area type. Point→area frames the text at its current size (it stays put, now wrapping); area→point unwraps.

1.2.24

• Area Type frames resize and reflow. Dragging a corner handle on an area text layer resizes its frame and re-wraps the text live at constant point size (it no longer scales the glyphs). When text overflows the frame, a red "+" out-port appears at the bottom-right, just like professional area-type tools. Undo restores the prior frame.

1.2.23

• Area Type — draw a text box on the canvas. With the Type tool, a plain click still makes point type; now a click-drag creates an Area Type frame the size of the drag, and text typed into it word-wraps at the frame width at constant point size. Wrapped area text is fully editable (caret, selection, insert, delete) and round-trips through save/load.

1.2.22

• Text underline & strikethrough, refined. Strikethrough now sits at each typeface's optical midpoint (the centre of the x-height) instead of a fixed line that read too low. Selecting a decoration reveals its own controls — both underline and strikethrough get a position offset, a pen Weight, a Thicken Mode (Parallel / Sinusoidal / Snake / Hatch / Cross-Hatch), and a Line Style (Solid / Dashed / Dotted / Dash-Dot / Long Dash / Dense Dots). Underline also has Descender Breaks with a Break Padding slider that opens a gap centred on each letter tail (g, j, p, q, y…). All Caps ↔ Small Caps and Superscript ↔ Subscript are now mutually exclusive, the Small Caps / Superscript / Subscript button icons read clearly, and a new Text layer starts as Vectura.
• Plots now follow reading order by default. The default Line Sort plot order changed to As drawn, so art plots in the order it was authored — a word plots left-to-right instead of hopping between height bands. The old travel-minimizing sorts (Nearest / Greedy, with horizontal / vertical / radial banding) are still available in the export Line Sort card. Also fixes the Export SVG "Line Sort Print Order" gear opening an empty settings pane when a Text layer was the active (or only) layer.

1.2.21

• Redesigned Text panel. The Text layer gains a dedicated tabbed panel — Type / Layout / Stroke / Fill — with a live specimen preview that is the editable text field (type straight into the preview). New typographic controls: vertical/horizontal scale, manual kerning, baseline shift, per-character rotation, all-caps and small-caps/superscript/subscript, underline & strikethrough, indents and paragraph spacing, justification, font weight, and fill inset/offset placement — backed by a rich font picker over the full Google Fonts catalog. (OpenType features beyond standard ligatures, and hyphenation, are surfaced but not yet active — they need a richer font shaper / a wrap width.)

1.2.20

• Contour fills smooth into bezier curves. Contour rings are extracted from a grid distance field, so they carried sub-cell stairsteps on every plotted letter. A new Bezier Curves toggle + Smoothness slider in the Fill panel rebuilds each ring as a native cubic curve (decimated to grid scale first, so it can't bulge into a counter). Both the fill and outline Bezier Curves now default on for the smoothest letterforms.

1.2.19

• Prism renders cleanly in Faces → Front. The prism's side faces were wound inward, so selecting Faces → Front culled the near sides and drew the far ones — leaving gaps. The sides are now wound outward like every other solid; antiprism, caps, and other solids are unchanged.

1.2.17

• Polyhedron gains four swept-profile solids — Cone, Frustum, Cupola, and Star Prism. They extend the existing side-count sweep family (flat polygon, prism, antiprism, bipyramid): Cone is a faceted pyramid, Frustum a truncated pyramid with a new Taper control, Cupola lifts a 2n-gon base to an n-gon top, and Star Prism extrudes a star profile with a new Star Inset control. Also fixes concave-face shading — faceNormal now uses Newell's method, so the Star Prism caps (and any concave face) get a correct outward normal instead of an inverted one. Existing solids are byte-for-byte unchanged.

1.2.16

• Contour fill is clean on every typeface. Contour rings are now traced from a distance field (chamfer transform + marching squares) instead of polygon offsetting, which tangled into chaotic geometry on script/display faces and at high density. Rings now follow each letterform cleanly, fill evenly, and stay bounded at any density — on uniform, high-contrast, and connected-script faces alike.

1.2.15

• Contour fill now fills every letter. Counter-less letters (V, E, C, T, …) used to come out nearly blank under a Contour fill because the ring spacing was sized to the whole letter rather than the stroke; thin strokes now carry several concentric rings while thicker shapes are unchanged.
• Type fills are watertight on connected scripts too. Building on 1.2.14, cursive faces whose letters join (Pacifico, Dancing Script, Great Vibes, …) now fill their counters cleanly. Text fills use the nonzero winding rule that glyph outlines are designed for, so overlapping joined strokes merge into solid ink while the holes inside letters stay empty — with no change to any other typeface or fill. Verified across 11 typefaces (5 connected scripts) × 15 fills × 4 words × 3 densities with zero counter bleed.

1.2.14

• Type fills are watertight across every fill type. Filling text used to be inconsistent — dots filled the holes (counters) inside R/A/O, contour drew only the first letter, and scribble left whole letters empty. Every fill type (dots, contour, scribble, halftone, voronoi, weave, and the rest) now carves letter counters correctly, fills every letter, and behaves identically to hatch and wave. Hairline-walled letters on high-contrast and script faces (Playfair, Lobster) fill cleanly instead of vanishing. Verified across 8 typefaces × 15 fills × 4 words × 3 densities with zero counter bleed.

1.2.10

• Raster-Plane base noise now dials up real relief. The Image (Base) layer's Field Weight used to flatten the surface into a binary mask when you turned it up; it now scales the actual 3D relief height, so cranking it raises towering relief while keeping the smooth gradient — and its range widened so you can push it much further. Bars mode now defaults to See-Through OFF, rendering as a watertight solid relief instead of a hollow wireframe.

1.2.9

• Text typography overhaul. The Font experience is now first-class. The default Text layer ships on a vendored Inter face that renders offline (headless/offline falls back to the built-in sans stroke font, so baselines are unchanged). The picker previews each Google family in its own typeface and each built-in face as an inline stroke sample, with search on both tabs; switching fonts no longer flashes the built-in placeholder before the real outlines arrive. New outline options: an opt-in Bezier Curves toggle that exports native cubic curves (handles nudged to 0/90/180/270°) with a Smoothness control; stroke emphasis via Outline Weight + Thickening Mode (Parallel/Sinusoidal/Snake, shared with Harmonograph/Rainfall); pattern fills of glyph interiors using the full shared fill engine (every fill type, holes carved automatically) for fill-only or filled-and-outlined type; and a Plot Order control that defaults to drawing left-to-right.

1.2.8

• Text can now use any Google Font. The Font control is a two-tab picker — Built-in keeps the five single-stroke faces, and a new Google Fonts tab searches the full ~2000-family web catalogue and traces a chosen family's glyph outlines into pen-ready polylines (the fill and optimization systems then treat them like any other geometry). The selection is stored as google:<slug> so it survives save/load. Catalogue and font files load lazily and cache locally; while a family is still downloading the layer shows the built-in stroke font and swaps to the real letterforms when its outlines arrive. The default Text layer still ships on the built-in sans face, so existing presets are unchanged.

1.2.5

• Raster-Plane Bars render as a clean solid heightmap relief when See-Through is off. The bars used to draw as hollow wireframes you could see straight through. They now use analytic hidden-line removal — a cell draws a top edge only where a neighbour is shorter (touching equal cells merge, no internal walls) plus each camera-facing step's exposed riser, and every edge is clipped against the bars in front of it. The result is clean plotter-ready line art with no see-through, no internal walls, and no floating fragments at any angle. See-Through on still gives the transparent wireframe.

1.2.0

• A large feature release. A universal preset system lands across every algorithm — a thumbnail gallery, one-click Save with a dirty-state pip, two-way folder-sync to disk, and a portable bundle. A new Morph Modifier blends 2+ layers into graduated in-between shapes with group/child isolation. Pendula debuts — a kinetic-harmonograph studio with a Motion Rack of bakeable LFOs, machine types, a pop-out Virtual Plotter, and Export Animated SVG — and Harmonograph gains presets and a live plotter. Petalis is overhauled with real petal geometry, a thumbnail gallery, Bloom/Asymmetry/Cupping macros, venation, and ~10–12× faster generation. Four new 3D algorithms arrive — Spiralizer (coils lines/markers around a surface or a DNA-style helix), Topoform (primitive/STL mesh wireframes and depth contours, with Scene Lighting and a Specular Highlight), Polyhedron (Platonic/Archimedean solids and STL meshes), and Raster-Plane (a height source projected as relief, mesh, topography, or bars) — sharing STL import, perspective projection, and four rendering powers (depth cueing, silhouette emphasis, hidden-line removal, Lambert hatching). Terrain gains a Free 3D projection mode with floating-horizon hidden-line removal and a fully reworked river-hydrology pipeline (real drainage networks instead of "drips"), and its Octaves/Lacunarity/Gain controls now work. Wallpaper becomes gallery-first with one-click style cards, a "surprise me" dice, and on-canvas handles. Plus version-stamped cache-busting so JS/CSS changes always take effect, and a masking fix so masks no longer distort curve-based algorithms.

1.1.10

• Meridian cleanup chain — closed. _ui-legacy.js (drained across units 1.5–1.10) and styles.css (drained across units 2.1–2.7) are both deleted. Every var(--color-*) reference under src/ was rewritten to var(--ui-*), the classic-skin alias maps were inlined and the --color-* defaults dropped from components.css, and the data-theme root mirror attribute is gone. New CSS now lands exclusively in src/ui/skin/.
• Added bezier handle editing in the pen reticule subtool — direct-select an anchor to drag its handles, with snap-to-origin (5 px) and handle-collapse-to-anchor behavior.
• Added direct-select drag-to-merge anchors — dragging an anchor onto another anchor on the same path merges them; also fixes sourcePaths.meta.anchors being silently lost through Undo/Redo and .vectura save/load.
• Replaced the Topo algorithm icon with a new brand mark.
• Fixed scissor on closed pen paths — no more spurious extra split near the start anchor.
• Fixed recurring subagent termination during npm run test:e2e runs.

1.1.0

• Wallpaper groups — correctness pass. Nine of the 17 wallpaper groups (pmg, pgg, cmm, p4g, p3, p3m1, p31m, p6, p6m) were producing partial coverage, double-covered regions, or asymmetric overlaps from misplaced ops or wrong fundamental-domain shapes. All 17 now tile the cell exactly once, verified numerically.
• Added Domain scale slider (0.30–2.00×) on every wallpaper mirror — scales the clip polygon around its centroid for intentional gaps (<1) or overlap (>1); 1.00 keeps exact tiling. Composes with all 17 groups.
• Added Tile layout v1/v2 toggle on p3, p3m1, p4g, p6, and p6m — keeps the corrected v2 as default but recovers the pre-1.1 v1 aesthetic on demand (canonical "alternating triangles" for p3, open spacing for p3m1/p4g, dense overlap for p6/p6m).
• Refactored: extracted the 320-line mirror-modifier panel out of _ui-legacy.js into its own module at src/ui/panels/mirror-panel.js.

1.0.0

• First stable release. From here on, breaking changes follow semver.
• Added welcome-screen "take the tour" CTA — gradient ghost button kicks off onboarding from a cold start.
• Added toolbar dock-and-drag anchoring: grabbing a docked toolbar's drag handle places the handle directly under the cursor (no snap-to-corner, no jump from float-vs-docked size differences, no clamp at viewport edges).
• Fixed mirror children unlock when parent is deleted — children that auto-locked on entry are restored to an editable state on parent deletion.
• Fixed manual version bumps no longer get double-stomped by the auto-patch hook when package.json is already staged.
• Fixed left/right pane flicker and snap on page load and toolbar flicker on initial paint.
• Fixed GitHub Pages deploy — added .nojekyll so Jekyll stops stripping _ui-legacy.js.
• Changed onboarding tour rebuilt around an extensible step engine with When.* completion factories, multi-phase steps, and a draggable popover (movable: true); content rewritten across all 7 steps.
• Changed disclosure chevrons unified on the Lucide chevron-down glyph with directional rotation.
• Internal: drained ~100 delegator stubs from _ui-legacy.js across panels, persistence, shell satellites, pens, pane-left, export-svg, modals, shortcuts, and grouping methods (continuation of the Meridian Blue UI architecture refactor).

0.9.10

• Added Meridian Blue skin family (Dark / Light / Lark) — fourth, fifth, and sixth shipping skins, sourced from themes-mockup.html. Space Grotesk + JetBrains Mono typography, tighter pane geometry, slider/dial release halos, indeterminate progress bar, and family-scoped petal/pattern designer chrome.
• Added skin-authoring SDK: npm run skin:new -- <id> scaffolds a new skin from src/ui/skin/_template.css. Full guide at docs/skin-authoring.md. New skins ship with one CSS file + one manifest entry — no JavaScript edits.
• Added empty-state illustrations in the layer list and pattern fill panel (monochrome SVGs sourced from --ui-muted).
• Added indeterminate progress bar wired into save / SVG export / engine generations exceeding ~200 ms.
• Added reduced-motion compliance pass: every keyframe in motion.css has a matching prefers-reduced-motion: reduce fallback paired with a universal *, *::before, *::after guard.
• Refactored UI from a single 16k-line ui.js into ~60 satellite modules under src/ui/{shell,panels,components,overlays,modals,menus,skin} while keeping the legacy class as a thin orchestrator. Renderer's getThemeToken cache supports both --ui-* and legacy --color-* aliases for cross-skin compatibility.

0.9.0

• Added mirror modifier "Expand to Folder": each mirrored path becomes its own editable shape layer.
• Added mirror-axis path joining on expand: source/reflection pairs that share an axis endpoint are auto-joined into one continuous path, cutting pen lifts at every axis crossing.
• Added layer grouping and ungrouping via the layer panel action menu.
• Fixed Add Layer ▾ → Mirror Modifier Group to wrap the current selection by default (now matches Insert > Mirror Modifier).
• Redesigned scissor/cut subtool icons; updated pattern fill, terrain, trash, and mask-source icons.

0.8.27

• Added custom canvas cursors for Selection (V), Direct Selection (A), Pen (P), and Fill (F) tools.
• Added Fill loupe overlay: paint-bucket cursor + 96 px circular magnifier (~4×) that flips quadrants near edges.
• Added Line shape primitive (U): drag two endpoints, Shift-snap to 45° increments.
• Fixed XSS via imported SVG pattern tile: new shared Vectura.SvgSanitize.sanitize() strips <script>, <foreignObject>, all on* attributes, and javascript: hrefs.
• Toolbar consolidation: Rectangle, Oval, Line, and Polygon share a single long-press shape group button.

0.8.0

• Added Lark theme: dark UI with white canvas, purpose-built for a plotter-on-paper workflow.
• Added Algorithm Drawing Tool with a dedicated subtool submenu.

0.7.0

• Added Terrain algorithm: heightfield-driven scanlines with Top-down, One-point, Two-point, and Isometric perspectives; ridged-multifractal mountains, V/U-profile valleys, steepest-descent rivers, ocean clamping, and six style presets — all with full Noise Rack integration.
• Added global dark/light theme toggle and full-shell CSS-variable theming.
• Added Insert > Mirror Modifier container with a full mirror-axis stack, dashed canvas guide overlays, per-axis show/hide/lock/reorder controls, and mirrored closed-mask silhouette support.
• Added Rectangle, Oval, and Polygon shape tools with editable expanded layers and shape-aware corner-rounding handles.
• Added parent masks: visible mask parents clip their full descendant subtree on canvas and in SVG export, with optional Hide Mask Layer.
• Added redesigned Export SVG modal with large left-side preview, right-side settings panel, and preview zoom/pan controls.
• Added custom Pattern registry: local library + project-carried tiles, .vectura round-trip, Import SVG Tile, live 3×3 seam-validation preview, and Fill/Erase Fill toolbar tools.
• Added Document Setup unit switch (Metric/Imperial) with unit-aware paper, margin, stroke, and tolerance controls.
• Fixed Undo/Redo for all layer-structure edits: grouping, reparenting, masking, modifier/container changes, and structural selections all round-trip correctly.
• Improved accessibility across all UI: prefers-reduced-motion, aria-live toasts, modal focus management, visible focus rings, and a minimum 11 px text-size floor.

0.6.80

• Relaxed the post-occlusion reconnect rule so verticals can disappear behind a ridge and reappear where they become visible again.

0.6.79

0.6.78

• Fixed the Layers-panel Clip trigger so the clipping-mask popover opens reliably in the saved masking workflow.

0.6.77

0.6.76

0.6.75

0.6.74

0.6.73

• Added a masking-specific SVG visual baseline and gave the new masking checkboxes explicit id/name wiring.

0.6.72

• Added live non-destructive layer masking for silhouette-capable layers, including layer-row Mask controls, mirrored left-panel masking controls, optional hidden mask-parent artwork, and Convert To Geometry materialization into expanded lines.

0.6.71

0.6.70

0.6.69

0.6.68

0.6.67

0.6.66

0.6.65

0.6.64

0.6.63

0.6.62

0.6.61

0.6.60

• Added Petal Designer silhouette picking in overlay mode.
• Made the Inner Shape / Outer Shape profile editor cards explicitly clickable selection targets.

0.6.59

• Replaced the remaining Petalis one-off modifier noise sliders with nested Noise Rack stacks.
• Preserved backward compatibility for older Petalis documents by treating legacy modifier scale values as fallback zoom.

0.6.58

• Reworked Rings Concentric sampling into a true seam-corrected ring-path field.
• Added a Center Diameter control for Rings to widen the innermost ring.
• Improved Rings apply-mode help text for Top Down, Concentric, and Orbit Field.

0.6.57

• Fixed shared image-noise controls so Invert Color renders as a checkbox.
• Corrected Noise Width sampling so increasing it widens image-based noise fields.
• Centered polygon noise by default in Wavetable and other top-left-biased samplers.

0.6.56

• Moved Petalis angular drift onto a Noise Rack stack.
• Restored local Playwright smoke reliability by patching the runtime compatibility script.

0.6.55

• Migrated flowfield, grid, and phylla onto Noise Rack stacks with per-layer engine selection, blends, offsets, and octave shaping.

0.6.54

• Clarified Rings apply-mode semantics for Top Down, Concentric, and Orbit Field.
• Restored the orbit-style ring-local sampler as an explicit Rings apply mode.

0.6.53

• Updated Rings control language to describe Top Down and Concentric as distinct sampling models.

0.6.52

• Migrated Topo onto the Noise Rack stack while preserving all contour mapping modes.
• Moved Topo's fractal controls into per-noise-layer behavior.

0.6.51

• Migrated Rings onto the Noise Rack stack with multi-noise layering and per-noise Concentric / Top Down projection.

0.6.50

• Added canonical app-version plumbing through src/config/version.js and npm run version:sync.
• Added a maintained repository punchlist in plans.md and a human-curated CHANGELOG.md.
• Started the Noise Rack extraction with a shared core blend-combination module used by wavetable, spiral, and rainfall.