* claim: #4384 Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> * Placement handles: shared module, with Rest as the first tool The Rest handles spike becomes a shared module, place_gizmo, so other features placed on a face can use the same marker and knob. The mechanics (crosshair with its three states, the grab offset, the footprint while dragging, the turn knob) live in place_gizmo.rs. The handles own the pointer through canvas::owns_pointer, as the move triad does, so navigation and Select Other's press-and-hold leave them alone. Each tool is one file under place_gizmo/ that gives a Spec: which dialogs it serves, which commands' Position input also takes sketch points, where the place is, how the pointer re-places it, its footprint and its turn, if any. The module lists the tools one per line, so tools added on separate branches each add one `mod` line and one list line. Rest is the first. The handles are always on; the preference the Rest spike had is gone. The POINTS accept flag on a Position input is granted from the tools' Specs instead of a Rest-only arm in the plastic dialog's start. Handles are published as `rest:position` and `rest:rotate` as before. Seen straight down, the dialog's height arrow collapses onto the place and its value box sits just right of it, where it took the press meant for a knob pointing that way. The knob now slides out along its ray until it is clear of the box. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Placement handles: Boss The marker moves a boss across the model, also from Edit Feature, and its Position input takes sketch points while the handles are on, so a screw boss can be dragged onto the centre of a circle drawn for it. A boss is round, so it gets no knob; the footprint while dragging is its outer circle. Published as `boss:position`. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Placement handles: Snap Fit The marker moves a snap fit across the model and its Position input takes sketch points while the handles are on, so the arm can be put where a sketch says (#3423). The knob points the catch: it turns between the four directions the Catch Direction combo offers for the face, so the knob and the combo always agree; the command keeps only those four, so there is no free turn. The footprint while dragging is the arm's foot, its thickness behind the place and its width across. Published as `snap_fit:position` and `snap_fit:rotate`. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Placement handles: the look in one file Everything that draws the handles (the crosshair and its three eased states, the knob's ball, the cased lines, the angle label, the colours) moves from place_gizmo.rs into place_gizmo/look.rs, so a restyle touches one file and the mechanics (hit radius, drags, knob geometry) stay where they are. No change in behaviour. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> * Placement handles: behind a Design preference, off by default The handles sit behind Preferences > Design > Placement > Placement handles (`placement_handles`, also through `ui.prefs`), off by default as the hole placement work in #2912 is: a Rest, Boss or Snap Fit is then placed by its click alone, its Position input takes faces only, and no handle is drawn or published. The tests switch the preference on; one checks the default. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> * Placement handles: the tests hide the origin through set_origin_shown, as main does since #1849 Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> * Placement handles: the move marker as designed in the prototype, drawn with theme tokens The marker is a dot with four arms to the screen cardinals: short and dotted at rest, longer with open arrowheads when pointed at, solid while dragging, each state growing out of the previous one (360 ms). Sizes are the prototype's. Its core is the icon highlight and its casing the marker halo, the tokens main's hole handle uses, so the literal allowance goes. The tip shows while pointing, not during a drag. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> * Placement handles: the dialog's drag arrow stands above the move marker With the handles on, the Height arrow started at the marker's centre and ran through its upper arm, head on arm tip. The arrow now keeps the marker's full reach and a gap free at the base, its shortest length grows by as much, and the base dot is left to the marker. Other dialogs are unchanged (clearance zero). Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> * Placement handles: a turn ring on the face replaces the knob The ring lies on the face about the move marker's centre, drawn in perspective, a fixed 65 px on screen like the move triad's arrows (it is a control of something on the screen, not a measure of the model). At rest it is a short dotted arc with an open chevron grip just outside; pointed at, the dotted circle opens from the grip both ways round and the grip slides in and fills; while turning, a solid arc around the grip. Dragging the grip turns the feature as the knob did, through the same handle name, so the harness tests stand. The floating value box yields: with a handle's centre under it, it moves to the other side of the arrow's tip or above it, since seen straight down the box sat exactly where the grip is. A handle the arrow's stem crosses keeps the pointer. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> * Placement handles: a compass while turning, and the turn pulled onto the face's compass points Four ticks just outside the ring at the face's in-face world directions (the ones the Snap Fit combo names, +X, −Y, …) appear while turning and stay put, so you can see how far you have gone. A Rest's turn is pulled onto one of them within 8°, otherwise it steps by 5° as before; Alt or Ctrl frees it. The readout beside the grip names the point it sits on ("90° · +X") and keeps clear of the ring. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> * Placement handles: the footprint in the preview's blue, the idle handle steps back The footprint drawn while the marker drags is a filled shape in the preview's own blue with a thin darker edge, not a white outline, so white stays reserved for what can be grabbed. While one handle is dragged the other fades to a quarter and comes back when the drag ends. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> * Placement handles: the ring in the preference text, the docs and the tests' wording Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> * Placement handles: the look as tuned in the app Marker: drawn to the redrawn design (dot r 3.9 pt, two dashes per arm, a filled head 8.7 × 7.1 pt whose base is where the outer dash began); pointed at, the outer dash becomes the head (its far end narrows to a point, its near end widens); dragging runs the inner dash on into the head as a shaft. Every casing is 0.4 pt outside the edge, for lines, heads and the dot alike. Ring: the grip and the compass lie in the ring's plane like the circle, so the grip is never skewed against it; the grip is a thick chevron with a hole that flattens into the base as the grip slides onto the ring, and fills; the dotted circle stays while turning, with the solid arc laid over it; opening eases in and takes 0.3 s, leaving is a 0.15 s fade over the resting ring, not the sweep backwards; a drag keeps the angular gap of the press, so the grip does not jump onto the pointer; the compass ticks and the readout's point name are in their axis colours, and the grip takes the axis colour (eased) while aligned with one, with that point's tick left out; free turning keeps a hair of pull (0.5°) so an axis can still be hit; the readout wraps to a half turn. Value box: with a ring it keeps out of the circle the ring, grip, compass and readout sweep, one place per view, nothing moves when a turn starts; also when the value does not evaluate and there is no arrow. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> * Placement handles: the readout shows a half turn as 180°, not −180° Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> * Placement handles: the motions in one place The animations the handles grew (a factor eased in and out each way on its own time and easing, a handle stepping back while the other works, a colour that comes and goes from the last one it was on, the gap a press keeps for its drag, an offset that slides instead of jumping) move out of place_gizmo into motion.rs, so the next manipulator reuses them. The look's timings become Transitions in look.rs. No change in behaviour: the contact sheet before and after is identical, the harness tests stand. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> * Placement handles: the axis colours as main names them since #4430 The compass and the aligned grip take the one set of X, Y and Z colours (axis_x, axis_y, axis_z); the Move gizmo's own array is gone. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> --------- Co-authored-by: Claude Fable 5.1 <noreply@anthropic.com>
Application resources
assets/ is the design resource home for SolidCraft.
ATTRIBUTION.md is the file inventory and provenance record.
Keep one editable master per resource and place shipped derivatives in exports/.
assets/
icons/
app/
shared/source/ # original Rust mark and executable ICO encoder
macos/source/SolidCraft.icon/ # approved Composer project and linked SVGs
macos/exports/ # paired Assets.car and icon.icns
windows/exports/ # executable DIB ICO and installer PNG ICO
linux/exports/hicolor/ # Linux/FreeBSD package images, 16–512 px
ui/design/svg/ # authoritative original UI icon masters
ui/design/tools/ # authoring bases, checks and included review app
ui/source/ # Rust viewport glyphs, markers and navigation
branding/web/source/og.png # shared social preview card
styles/ui/palettes.rs # light/dark defaults
styles/web/loading.css # web loading/canvas styles
appearances/library.rs # built-in visual presets
materials/library.rs # physical defaults and colours
shaders/viewport.wgsl # original viewport shader
fonts/{liberation-sans,biz-udp-gothic}/ # unmodified fonts and OFL licences
locales/{en,de,ja,ko}.json # shared offline catalogs
platforms/{macos,linux,windows}/ # bundle, freedesktop and WiX templates
platforms/macos/dmg/ # disk image window: layout, dmgbuild settings, background art
archive/icons/macos-v1/
source/icon.vectorcraft # earlier editable work, retained
# redundant historical exports are retired
Editing and regeneration
UI artwork identifies the drawing masters and their consumers. Read the mandatory UI style guide before editing an icon. Edit SVG geometry and its command/UI assignments together; inspect both themes and small sizes. Temporary media and generated reports belong in ignored target/. Palettes and model presets are also editable Rust data.
The current macOS master is icons/app/macos/source/SolidCraft.icon/, including
its linked SVG layers and appearance settings. The earlier VectorCraft document
is preserved in the archive. No other native design projects were available for
the current UI set or preview card. Keep any future .vectorcraft, .ai or other
native work and linked inputs under that resource's source/work/, with an
attribution row; retain the editable document alongside its exports.
Regenerate all exports of the shared Windows/Linux/FreeBSD mark together:
cargo xtask app-icons
For macOS, use Xcode with Icon Composer support:
mkdir -p target/resources/macos-icon
xcrun actool assets/icons/app/macos/source/SolidCraft.icon \
--compile target/resources/macos-icon --platform macosx \
--minimum-deployment-target 11.0 --app-icon SolidCraft \
--output-partial-info-plist target/resources/macos-icon/icon-info.plist \
--output-format human-readable-text
cp target/resources/macos-icon/Assets.car assets/icons/app/macos/exports/Assets.car
cp target/resources/macos-icon/SolidCraft.icns assets/icons/app/macos/exports/icon.icns
Review and commit source changes and required exports together. Temporary renders,
tool caches and package staging belong under ignored target/ or dist/.
Normal builds use the committed exports and require no design applications.
The CLI still supports arbitrary PNG/ICO exports with solidcraft-cli icon.
Platform bindings
| Platform | Resources and output paths |
|---|---|
| macOS | Composer master and paired exports; bundle installs Assets.car and SolidCraft.icns |
| Windows executable | solidcraft-executable.ico: original DIB/mask representations at 16/24/32/48/64/128/256 px |
| Windows installer | solidcraft.ico: PNG representations at 16/20/24/32/40/48/64/128/256 px; SOLIDCRAFT_ICONS override retained |
| Linux, Nix, deb/rpm, tar, Flatpak, Snap | Copy canonical hicolor images; icon name stays ai.storyteller.solidcraft |
| AppImage | Uses the Linux 256 px image and .DirIcon alias |
| FreeBSD | Shares Linux hicolor images and freedesktop metadata |
| Web | HTML/Trunk and manifest.webmanifest stay in apps/solidcraft-web/; copies Japanese font/licence to fonts/, uses the collected CSS, and copies the Linux 32/256/512 px images to icons/ for the favicon and installed app |
| Docs and link previews | xtask book copies the shared card to the existing /solidcraft/og.png public path |
Code and provenance
Resources remain compiled by their owning layer through existing APIs:
ui-egui::icons::paint_icon and Tokens at L5, model presets in L2 doc, and sketch
fonts at L1. State, projection, interaction, commands and GPU bindings stay in
their current modules. Embedded data uses CARGO_MANIFEST_DIR; application code
needs no runtime resource registry or repository lookup.
cargo xtask assets requires an exact attribution row for every collected file
except Markdown documentation, and continues checking file assets elsewhere in
the repository. This includes native work, Rust masters, catalogs, shaders and
platform templates. Packaging selects explicit current files and fails when
required inputs are absent. Archived artwork has no production consumers.
Dependency-owned egui fonts and vendored renderer shaders stay with their
libraries; their licences remain in THIRD-PARTY-LICENSES.txt and ATTRIBUTION.md.
System fonts, optional packs, user fonts/canvases/decals/materials and native OS
controls retain external ownership. Root licence/notice texts stay canonical.