0.3.0

The design surface: a tool for tuning a running app on the device, shipped as a second package product and driven through the Showcase and two real apps. Install or upgrade with brew install mangobyte-dev/tap/swiftui-registry or brew upgrade swiftui-registry

Added

• The SwiftUIRegistryDesignSurface product. Add it, import SwiftUIRegistryDesignSurface, and apply designSurface() inside the app's registryTheme(_:). In a debug build it puts a draggable Tune button and a floating, movable, resizable panel in the tool's own window over the whole app, which stays live underneath on every tab, sheet, and cover; a release build returns the content unchanged. The tuned tokens persist as registry-tokens.json in the app's Documents directory and export as a preset code any registry tool applies, or as the Swift to paste
• Tap-to-select. Select arms the next tap; the panel scopes to the tokens that reach the item you tapped, outlines every tagged item on the screen with its name, and lists them under On this screen. ItemSelection.chain names every item under the pick, innermost first, so a host can offer the row around a button as well as the button. A pick on nothing clears the selection
• Host tokens: conform an app's own token value to TokenDocument (a shipped value, a file name, and pages of .number, .choice, and .color knobs with an apply()), pass it to designSurface(tokens:), and the panel gains an App tokens section that writes changes back to the app
• Per-item knobs: register numeric knobs with designSurface(knobs:) (ItemKnob) and read them inside an item with registryKnob(_:_:default:); they persist beside the tokens in design-knobs.json, and only a value that moved is written
• The host-hooks overload designSurface(enabled:tunesRegistryTheme:knobs:itemTitle:page:panelEnvironment:panel:) for an app that paints registry items from its own tokens. It compiles in every build configuration: enabled is the app's own switch, tunesRegistryTheme: false drops the panel's theme sections, panel adds the app's sections, page pushes the app's page for a picked item, panelEnvironment wraps the panel's stack, and itemTitle names rows and outlines
• Foundations gained registryItem(_:) and registryScreen(_:), the tags the surface selects and names screens by, plus the surface reporter and the per-item knobs in the environment, all inert without a surface
• A fourth generator, swiftui-registry generate item-tokens, writes the item-to-token map the design surface scopes its panel by, and CI checks it for drift with the other generated outputs
• CHANGELOG.md (this file), a repository-layout table in CONTRIBUTING.md, and docs/RELEASE-CHECKLIST.md, the list a release closes line by line

Changed

• The tuning panel moved out of the Showcase into the SwiftUIRegistryDesignSurface product; the Showcase consumes it. The panel is a floating card in the tool's own window, not the earlier sheet or inspector column: a drag bar moves it, a corner grip resizes it, a chevron collapses it, it may hang off the leading, trailing, and bottom edges while its grab strip stays inside the safe area, it never goes above the top, a drag against the trailing edge of an iPad snaps it into a full-height column, and its frame is remembered per size class and re-clamped on rotation
• The tool's own chrome (the Tune button, the card, the selection ring, the outlines, the guides) is drawn from fixed system values, never the tuned theme, so tuning the app never restyles the tool; the tool's motion is off under Reduce Motion
• Every installable item declares the 0.3.0 foundations floor, because every one applies registryItem(_:); the installer prints from 0.3.0 up to the next minor version
• swift-sharing is pinned to the 2.9.x line (from 2.9.1, below 2.10.0) with no traits declared, so a consumer already resolving xctest-dynamic-overlay is not forced onto a newer major
• The repository holds only what an adopter needs; planning, research, and run logs left it

Fixed

• The tool no longer advertises an older Homebrew tag as an update: the notice appears only for a tag newer than the running tool
• A tap on a List row under the card pushes again; the key window now follows the text field that takes focus (a field in the app takes the keyboard, a field in the panel takes it back) instead of switching during hit testing, which cancelled the touch
• The collapse control has its own accessibility frame; the drag runs over the whole bar as a simultaneous gesture
• The card is clamped into the window's safe area, so its strip never sits under the status bar and never stops short of it
• A knob with a non-positive step or a shipped value outside its range is made usable and logged; a token file that fails to decode (edited by hand, or written by a newer version) leaves the shipped values in place, is logged once, and is not rewritten until a knob moves; a choice knob keeps a value its options no longer list; an empty item or screen name tags nothing; a host title that is an empty string falls back to the item's name; ties between equal frames resolve by name; an item scrolled off the screen is not listed as on it
• Foundations compiles on macOS again (Color(uiColor:) had crept into the selection ring); an unused anchor preference left the public API before it shipped

Known limitations

• Two visual references, auth-light and nutrition-light, are stale after the tuning-strip change (measured at 2.70 percent and 1.54 percent against the 1.5 percent tolerance). They are recaptured but await the owner's copy into ReferenceImages/, so those two Showcase UI tests fail until then (docs/visual-testing.md)
• The iPad simulator intermittently never reports idle after keyboard input, so the UI suite passes -disable-animations on the iPad destination and one test records a measured skip rather than a failure (docs/visual-testing.md)
• The tool's window installs over the first connected scene; a second window of the same app on iPad is not covered
• Items installed from 0.1.0 or 0.2.0 carry no registryItem(_:) tag, so Select and the outlines find nothing in them until swiftui-registry install <item> --update brings the tagged sources
• The Showcase is portrait-only on iPhone; rotation of the card is exercised on the iPad destination and in the host apps

Full Changelog: 0.2.0...0.3.0