feat: preserve modeling intent across sketches, assemblies, and fabrication

Persist typed sketch dimensions and bounded ordered configuration rules in format 8. Use exact occurrence paths and source identity for editing, movement, appearance, and mass. Preserve sheet material regions through cutting, folding, and exact DXF export; retain nested cavities and material islands.

Validation: cargo xtask ci passed, including 368 engine tests, 178 UI tests, 68 UI scenarios, 136 kernel tests, and the 10-crate wasm check. Actual preview workflows and legacy format-7 origin-corner reopening were inspected.

docs/book/src/guide/sheet-metal.md

@@ -28,3 +28,13 @@ consume an undo step.
 
 DXF cutout geometry preserves lines, circles and circular arcs; other curves are sampled
 adaptively. The `OUTLINE`, `BEND_UP` and `BEND_DOWN` layers separate cuts from bend centres.
+
+Base-flange profiles keep their interior holes. Through cuts that cross a sheet edge become
+notches in the flat outline; overlapping and repeated cuts remove their combined area once.
+The flat preview, DXF and unfolded solid use the same material boundaries. Lines and circular
+arcs remain exact; other profile curves use a 0.001 mm chord tolerance.
+
+Cuts can leave separate material pieces, including the centre of a ring cut. These pieces
+remain one logical sheet group through Unfold / Refold and export as separate flat outlines.
+Large profiles that exceed the geometry processing budget report an error instead of
+exporting a partial outline.

docs/configurations.md

@@ -36,8 +36,66 @@ face appearances keep their existing priority. Physical material changes affect
 
 Style columns target body names. Assignments remain stored when a row suppresses the feature
 that produces that body, and become visible when it returns. Component and face appearance
-columns and conditional configuration rules are not yet supported.
+columns are not yet supported.
 
-Designs saved with these columns use file format 7. Older designs upgrade on opening without
+Activation evaluates all row parameter expressions together, so column order does not create
+temporary dependency cycles. Preview and activation reject new or changed geometry errors
+without changing the design. An identical existing error remains visible. A saved row cannot
+recreate a deleted parameter: remove its configuration references before deleting it. Deleting
+a feature removes its input and suppression columns and any rules referring to that feature.
+
+## Ordered rules and preview
+
+Open **Add or edit rule** below the table. Give the rule a name, choose when it applies, then
+choose a driven parameter, driven suppression, numeric range, or allowed values. Numeric
+fields accept ordinary design expressions and explicit units. **Edit**, the arrow buttons,
+the enable checkbox, and **Delete** update existing rules. Choose **All**, **Any**, or **Not**
+to build compound conditions with nested controls, **Add condition**, and **Remove condition**.
+
+**Preview Row** rebuilds a scratch design and shows effective expressions and matched or
+skipped rules. Driven and restricted values identify the rule responsible. It leaves the
+current geometry, active row, and undo history unchanged. **Apply** or **Activate** publishes
+the validated variant as one undoable action.
+
+Rules execute in list order. Each condition sees earlier drives; restrictions from matched
+rules all apply to the final values. A range includes its endpoints. Allowed values compare
+numeric values with matching dimensions, so `1 cm` equals `10 mm`. An angle never equals a
+length. Bare expressions use the target parameter's unit, or the document's unit for feature
+length inputs. Equality uses a relative/absolute tolerance of `1e-9` in internal units.
+The rule editor's **Length units** selector sets the meaning of bare feature-length
+expressions; explicit units override it. Rules capture this unit context when authored. Changing document units
+preserves mixed expressions such as `width + 1` without treating `width * 2` as a length
+multiplier. Bare saved feature length cells and rule thresholds gain the previous explicit
+unit; explicit units and nonliteral source expressions retain their text. A matching active
+row rederives its driven values when units change. User parameters retain their own units.
+
+Rules recompute on configured edits, **Apply**, and **Preview Row**. Ordinary parameter
+edits can leave the configuration unmatched and do not continuously enforce restrictions.
+Cross-unit drives store effective numeric lengths; their saved source expressions reevaluate
+on the next Apply or Preview rather than following later ordinary parameter edits live.
+Saved source cells are preserved: disabling a drive restores the row's original choice.
+
+```json
+{"command":"config.rule","params":{"rule":{"id":"depth-rule","name":"Large parts use deeper stock","condition":{"type":"parameter","parameter":"width","operator":"ge","expression":"80 mm"},"effect":{"type":"drive_parameter","parameter":"depth","expression":"width / 2"}}}}
+{"command":"config.rule","params":{"rule":{"id":"width-range","name":"Stock width","condition":{"type":"always"},"effect":{"type":"parameter_range","parameter":"width","minimum":"10 mm","maximum":"100 mm"}}}}
+{"command":"config.preview","params":{"row":"Aluminum blue"}}
+{"command":"config.rule","params":{"id":"width-range","index":0}}
+```
+
+Configure the `depth` column before adding this example drive. Conditions may reference any
+existing design parameter; effect targets must be configured columns. `config.rules` lists
+rules. `config.rule` replaces a rule with the same ID, deletes with `id` and `delete: true`,
+or moves it to a zero-based `index`. Editing a rule validates every saved row before committing;
+editing a row validates that row. Invalid geometry, dependency cycles, incompatible units,
+or restrictions leave the previous document intact and explain the failure. Delete rules
+before removing the last row. Parameter renames update rule targets and expressions; rule
+references prevent parameter deletion until removed.
+
+Tables support at most 128 rules; conditions allow eight levels and 64 nodes, and allowed
+value lists support up to 128 expressions. These bounds are checked before saved rules are
+decoded. Driven appearance/material rules and repeated fixed-point evaluation are outside
+the current rule scope.
+
+Designs saved with rules use file format 8. Older designs upgrade on opening without
 changing their existing configuration values. Older SolveCraft versions must be updated to
 open newly saved designs.

docs/occurrence-workflows.md

@@ -0,0 +1,39 @@
+# Working with individual instances
+
+Each occurrence placement has a full path of occurrence IDs, from the design root to that placement. A child definition reused under several parent instances has a different full path in each parent. Names are labels; paths identify placements across rename and position capture.
+
+Select a placement through `select.set`:
+
+```json
+{"items":[{"type":"occurrence","path":[2,4]}]}
+```
+
+Properties accepts the leaf occurrence ID and the full path. Move can use world coordinates, including a world rotation pivot:
+
+```json
+{"occurrence":4,"path":[2,4],"space":"world","translate":[10,0,0],"capture":false}
+```
+
+World movement includes pending parent and child positions. The default space remains parent-local for existing scripts. Capture Position commits pending transforms; Revert Position drops them. Copying an occurrence copies that selected occurrence's effective transform, including its pending position.
+
+An occurrence definition inside a component is shared by every instance of that parent component. Moving, grounding, copying, or deleting that nested definition changes all its parent instances. Selecting its exact path determines the world frame used for movement and Properties; it does not create an independent child definition.
+
+Activate a placement to author shared geometry through its frame:
+
+```json
+{"component":3,"occurrence":4,"path":[2,4]}
+```
+
+New geometry belongs to the component and appears in every instance. The selected frame determines how world inputs become local component geometry. Planar sketches display at the active placement during authoring. Component-only activation keeps the first-placement behavior. Existing 3D wires retain their prior coordinate behavior; their mixed legacy coordinate storage needs a separate migration before occurrence authoring can apply consistently.
+
+Visibility is an independent view setting for exact placements. Hide a path and all descendants with `browser.visibility`:
+
+```json
+{"visible":false,"paths":[[2,4]]}
+```
+
+`visible:true` removes that path's own hide setting. A hidden ancestor still hides its descendants. Add `isolate:true` to a visible path list to hide other branches. Show the bodies folder to clear occurrence hides. Selection, activation paths and visibility are session state; the saved document retains occurrence IDs and transforms. Undo follows the existing behavior of clearing selection.
+
+Paths are checked for missing links, repeated IDs, component mismatches and a maximum depth of 64. Descendant expansion rejects more than 100,000 placements or bodies instead of returning incomplete results. Computed body names normally retain their readable occurrence labels; collisions use full occurrence IDs so visibility and body commands still address the correct source.
+
+Placed bodies retain their definition identity separately from display names. Body materials and appearances remain shared, with body overrides taking precedence over component overrides and material colors. Face overrides follow the placed geometry, including pending positions, and painted exports retain these colors.

docs/parity.md

@@ -2,16 +2,16 @@
 
 Generated by `cargo xtask parity` from `xtask/data/fusion-catalog.tsv` (the toolbar commands of Fusion's Design workspace, ids and names only) and the live command registry (`solvecraft-cli commands`). A command counts as live when SolveCraft registers the same command id. This measures breadth, not depth; see ROADMAP.md and docs/oracle.md for depth.
 
-**In scope (SOLID, SKETCH, ASSEMBLY, SHEET METAL, PLASTIC enclosure subset): 331 / 541 commands live (61%).** SOLID + SKETCH: 186 / 291 (64%). Registered commands: 307.
+**In scope (SOLID, SKETCH, ASSEMBLY, SHEET METAL, PLASTIC enclosure subset): 335 / 541 commands live (62%).** SOLID + SKETCH: 188 / 291 (65%). Registered commands: 311.
 
-Deferred until further notice (not in the in-scope figure): MESH, FORM, SURFACE beyond what solids need, PCB, render, animation, simulation, manufacture, drawings, MANAGE, UTILITIES and the rest of PLASTIC. All Design tabs together: 623 / 1175 (53%).
+Deferred until further notice (not in the in-scope figure): MESH, FORM, SURFACE beyond what solids need, PCB, render, animation, simulation, manufacture, drawings, MANAGE, UTILITIES and the rest of PLASTIC. All Design tabs together: 630 / 1175 (54%).
 
 | Tab | Panel | Live | Total | % |
 |---|---|---:|---:|---:|
 | SOLID | CREATE | 23 | 35 | 66% |
 | SOLID | MODIFY | 19 | 32 | 59% |
 | SOLID | ASSEMBLE | 12 | 21 | 57% |
-| SOLID | CONFIGURE | 2 | 3 | 67% |
+| SOLID | CONFIGURE | 3 | 3 | 100% |
 | SOLID | CONSTRUCT | 19 | 20 | 95% |
 | SOLID | INSPECT | 12 | 25 | 48% |
 | SOLID | INSERT | 6 | 11 | 55% |
@@ -20,7 +20,7 @@ Deferred until further notice (not in the in-scope figure): MESH, FORM, SURFACE
 | SKETCH | CREATE | 41 | 41 | 100% |
 | SKETCH | MODIFY | 12 | 12 | 100% |
 | SKETCH | CONSTRAINTS | 15 | 15 | 100% |
-| SKETCH | CONFIGURE | 2 | 3 | 67% |
+| SKETCH | CONFIGURE | 3 | 3 | 100% |
 | SKETCH | INSPECT | 12 | 25 | 48% |
 | SKETCH | INSERT | 7 | 13 | 54% |
 | SKETCH | ASSEMBLE | 0 | 1 | 0% |
@@ -29,7 +29,7 @@ Deferred until further notice (not in the in-scope figure): MESH, FORM, SURFACE
 | SHEET METAL | CREATE | 15 | 19 | 79% |
 | SHEET METAL | MODIFY | 12 | 21 | 57% |
 | SHEET METAL | ASSEMBLE | 11 | 20 | 55% |
-| SHEET METAL | CONFIGURE | 2 | 3 | 67% |
+| SHEET METAL | CONFIGURE | 3 | 3 | 100% |
 | SHEET METAL | CONSTRUCT | 19 | 20 | 95% |
 | SHEET METAL | INSPECT | 12 | 25 | 48% |
 | SHEET METAL | INSERT | 6 | 11 | 55% |
@@ -42,7 +42,7 @@ Deferred until further notice (not in the in-scope figure): MESH, FORM, SURFACE
 | ASSEMBLY | MOTION | 3 | 3 | 100% |
 | ASSEMBLY | MODIFY | 8 | 11 | 73% |
 | ASSEMBLY | CONTACT | 2 | 2 | 100% |
-| ASSEMBLY | CONFIGURE | 2 | 3 | 67% |
+| ASSEMBLY | CONFIGURE | 3 | 3 | 100% |
 | ASSEMBLY | CONSTRUCT | 19 | 20 | 95% |
 | ASSEMBLY | INSPECT | 12 | 25 | 48% |
 | ASSEMBLY | SELECT | 0 | 15 | 0% |
@@ -56,7 +56,7 @@ Deferred until further notice (not in the in-scope figure): MESH, FORM, SURFACE
 | SURFACE | CREATE | 9 | 25 | 36% |
 | SURFACE | MODIFY | 17 | 26 | 65% |
 | SURFACE | ASSEMBLE | 11 | 20 | 55% |
-| SURFACE | CONFIGURE | 2 | 3 | 67% |
+| SURFACE | CONFIGURE | 3 | 3 | 100% |
 | SURFACE | CONSTRUCT | 19 | 20 | 95% |
 | SURFACE | INSPECT | 12 | 25 | 48% |
 | SURFACE | INSERT | 6 | 11 | 55% |
@@ -66,7 +66,7 @@ Deferred until further notice (not in the in-scope figure): MESH, FORM, SURFACE
 | MESH | PREPARE | 0 | 4 | 0% |
 | MESH | MODIFY | 6 | 30 | 20% |
 | MESH | ASSEMBLE | 12 | 21 | 57% |
-| MESH | CONFIGURE | 2 | 3 | 67% |
+| MESH | CONFIGURE | 3 | 3 | 100% |
 | MESH | CONSTRUCT | 19 | 20 | 95% |
 | MESH | INSPECT | 12 | 25 | 48% |
 | MESH | INSERT | 5 | 10 | 50% |
@@ -87,7 +87,7 @@ Deferred until further notice (not in the in-scope figure): MESH, FORM, SURFACE
 | PLASTIC | CREATE | 27 | 35 | 77% |
 | PLASTIC | MODIFY | 19 | 32 | 59% |
 | PLASTIC | ASSEMBLE | 11 | 20 | 55% |
-| PLASTIC | CONFIGURE | 2 | 3 | 67% |
+| PLASTIC | CONFIGURE | 3 | 3 | 100% |
 | PLASTIC | CONSTRUCT | 19 | 20 | 95% |
 | PLASTIC | INSPECT | 12 | 26 | 46% |
 | PLASTIC | INSERT | 6 | 11 | 55% |
@@ -166,6 +166,7 @@ Deferred until further notice (not in the in-scope figure): MESH, FORM, SURFACE
 - SOLID › ASSEMBLE › New Contact Set
 - SOLID › CONFIGURE › Configure
 - SOLID › CONFIGURE › Display Configuration Table
+- SOLID › CONFIGURE › Create Configuration Rules
 - SOLID › CONSTRUCT › Offset Plane
 - SOLID › CONSTRUCT › Plane at Angle
 - SOLID › CONSTRUCT › Tangent Plane
@@ -275,6 +276,7 @@ Deferred until further notice (not in the in-scope figure): MESH, FORM, SURFACE
 - SKETCH › CONSTRAINTS › Polygon
 - SKETCH › CONFIGURE › Configure
 - SKETCH › CONFIGURE › Display Configuration Table
+- SKETCH › CONFIGURE › Create Configuration Rules
 - SKETCH › INSPECT › Measure
 - SKETCH › INSPECT › Interference
 - SKETCH › INSPECT › Section Analysis
@@ -332,7 +334,6 @@ Deferred until further notice (not in the in-scope figure): MESH, FORM, SURFACE
 - SOLID › ASSEMBLE › Tangent Constraint
 - SOLID › ASSEMBLE › Joint Constraint
 - SOLID › ASSEMBLE › As-Built Constraint
-- SOLID › CONFIGURE › Create Configuration Rules
 - SOLID › CONSTRUCT › User Coordinate System (UCS)
 - SOLID › INSPECT › Validate
 - SOLID › INSPECT › Component Connection Analysis
@@ -368,7 +369,6 @@ Deferred until further notice (not in the in-scope figure): MESH, FORM, SURFACE
 - SOLID › SELECT › Select Edge Priority
 - SOLID › SELECT › Select Component Priority
 - SOLID › SELECT › Selection Filters
-- SKETCH › CONFIGURE › Create Configuration Rules
 - SKETCH › INSPECT › Validate
 - SKETCH › INSPECT › Component Connection Analysis
 - SKETCH › INSPECT › DOF Analysis