[Steven-Tibbs]

What does this PR do?

The editor side of the punch list (walls, rooms, porches and decks, railings, beams, posts, stairs, roofs, doors and windows), reworked in review. The Addendum at the end records every review decision and change; this section describes the branch as it is now.

Walls

• Pushing or dragging a wall leaves no doubled walls; a wall drawn over another built differently takes over that stretch (its openings move onto the new wall). Drawing into a wall splits it, as on main.
• Exterior corners miter; interior walls meet the inside face and leave the outer wall whole.
• Pull to continue from a selected wall's end; line-up snap and arrow-key nudge (2D); Tab steps through stacked objects (2D); open wall ends select their wall.
• Temporary dimensions on selected walls (one or several): room widths and outside size, editable in 2D and 3D. The wall's length reads its faces (ID / OD), chosen in Display → Dimensions → Measure walls.
• Moving several walls pushes each along its own normal, parallel to where it was, with joined walls following and the same live dimensions as a single wall.
• Wall types live in the wall panel: Preset plus a menu to create, edit and duplicate project wall types; stud spacing on the framing layer. New walls are plain, as on main.

Rooms, porches, decks and patios (on main's floor plates)

• Invisible walls (room dividers): they close rooms, never cut walls, stay joined when moved, push and drag at their ends.
• Room types Room, Porch, Deck and Patio. A room closed off outside the house steps down and takes its type's defaults; porches get automatic posts and a beam.
• Decks drawn as boards on their framing (ledger, joists, rims, beam, posts on piers); porch and patio slabs run down to the natural ground.
• All of it reads and writes main's floor plates. The plate of an outdoor room carries metadata.floor (porch-slab / deck) as a documented interop field for framing plugins; built-in code reads the room's roomType.

Railings, beams, posts and stairs

• Railing as a wall type (style, post spacing and size, openings); rooms close on railings; a door on a railing is a gap (via a host-surface capability, not a kind check).
• Beam and Post tools with their panels and plan symbols.
• Stairs with wood stringers, concrete or steel, with code checks; square floor openings; a moved stair heals its old cutout at once.

Roofs

• Roof plan with the eave outline and live updates; moved roofs and side arrows catch the wall lines; gable and heel walls match the walls below; roofs snap to porch, deck and invisible-wall edges.
• Roof layers (build-up) and ceiling layers; Display → Ceilings (solid tops).

Doors and windows

• Casing on the finished wall faces for new doors and windows (existing ones load without it), painted per side (casing-a / casing-b, inheriting the frame until painted).
• New doors and windows get 20 mm frames; an automatic frame depth equals the wall thickness.
• Swap swing / hinge side opens a closed door to show the result; single casement windows get Swap hinge side.

Editor

• Build panel: Rooms = Rectangle / Polygon / Walls, with a Standard · Invisible · Railing row under Walls; Walls draws one wall per two clicks; B arms the last Rooms shape.
• Display menu regrouped: Show (Grid, Other levels below / above) / Dimensions (Dimensions on-off, Measure walls Inside / Outside / Both, Units) / Plan (2D only) / Scene (3D only) / Editing.
• Adding a storey offers to copy the exterior walls below; a box selection leaves rooms' automatic floors and ceilings out.
• Clicking an already-selected object picks it up, as on main. Plugin inspector views (e.g. Bones' Engineering) are buttons in the node action menu.
• Tool shortcuts: Shift+D door, Shift+W window, Shift+S stairs, Shift+R roof. The shortcuts dialog documents Alt (hold) as the snapping bypass and a Shift tap as the snapping-mode cycle.
• Siding is its own Paint category; siding and shingle materials are KTX2 with thumbnails; a catalog map the asset CDN doesn't have yet loads from the app.

Agent tools

• add_wall: type (wall assembly preset or project wall type) and wallType: 'railing' with guard settings. New set_wall_type for existing walls. get_walls reports types.
• add_column: framing posts (role: 'post', size, base). get_zones: room type, step-down, porch framing and decking.

Translations

New copy goes through the i18n catalog; es, fr, ja and zh-CN drafts are marked for review.

How to test

1. Build panel. Rooms shows Rectangle / Polygon / Walls. Arm Walls: the Standard · Invisible · Railing row appears, and one wall is drawn per two clicks. Press V, then B: the last shape is armed.
2. Rooms. Draw a rectangle on a fresh scene: one room, plain walls. Draw invisible walls outside the house: a Porch with posts and a beam appears; railings give a Deck.
3. Wall dimensions. Select a wall, then several: their dimensions show in 2D and 3D. Change Display → Dimensions → Measure walls: they switch between Inside, Outside and Both.
4. Moving walls. Select two walls of a room and drag: each stays parallel, joined walls follow, dimensions show, and one undo step reverts it.
5. Stairs. Under an upper floor, move a stair: the old cutout closes immediately, with no reload.
6. Doors and windows. Place a door and a window: casing on both faces, 20 mm frames, depth equal to the wall. Open an old scene: its doors and windows have no casing. Swap swing side on a closed door: it opens.
7. Levels. Cut to a lower level: upper levels and roofs still cast shadows.
8. Siding. Paint a wall with lap siding: the boards show in 3D.
9. Agent tools. add_wall with type and with wallType: 'railing', then set_wall_type, add_column with role: 'post', and get_zones on a porch: each reports back what it wrote.

Screenshots / screen recording

Not added yet.

Checklist

• I've tested this locally with bun dev
• My code follows the existing code style (run bun check to verify)
• I've updated relevant documentation (if applicable)
• This PR targets the main branch

---

Addendum: product review (2026-10-30)

The original punch list was reviewed against the settled decisions (DECISIONS.md) and reworked on this branch. Below are the decisions the product owner took, then what changed. Checks run on the final head: bun run ci locally (Biome, i18n, skills, typecheck, all package tests, build) and GitHub CI.

Decisions

Floor plates, slabs and foundations: back to main. Main's floor plates and slabs are the single source of truth again. Removed:

• the designed foundation (slab with turned-down edge, raised floor, piles and grade beams, designed basements);
• the Foundation and Footing kinds and tools;
• the foundation row and view;
• ground grading and its seat rule;
• floor layers and the ~0.33 m framed upper floors;
• the "+ below" framed-floor lift and the delete-level re-seat;
• slab rooms.

Kept: porches, decks and patios (adapted onto main's plates), ceiling layers and Display → Ceilings, roof layers, square stair openings, the "Copy exterior walls?" prompt.

Walls and the Build panel

• New walls are plain, as on main. The type/finish pickers and the Exterior / Interior / Invisible / Railing tiles leave the Build panel; wall types (presets and project types) are edited from the wall panel.
• Walls draws one wall and stops. B recalls the last Rooms shape. Shift+E and I are removed.
• Automatic splitting of a wall you draw into is restored.

Wall dimensions

• One setting, Display → Measure walls (Inside / Outside / Both), replaces Finished faces / Centerline / Face of stud. The ID+OD button leaves the wall's action menu.
• The Display menu follows the design draft.

Interaction

• A click on an already-selected object enters move mode again, as on main.
• Several selected walls move like their own push arrows and show their dimensions.

Upper levels: keep their shadows (shadow-only casting) when you cut to a lower level.

Doors and windows

• Casing only on new openings, with its own paint slot per side.
• 20 mm frames for new doors and windows.
• An automatic frame depth is exactly the wall thickness.
• Swaps open the door.

Rooms: the "Garage" name rule is removed; a room's name is only a label.

Materials

• Siding uses KTX2 maps like the rest of the catalog, with flipY handled, plus thumbnails.
• Thumbnails of tinted entries show their colour.

Architecture review

• Kind checks move behind registry capabilities.
• Porch framing writes are guarded by the derived-writer test.
• Built-in code reads roomType; metadata.floor stays as an interop field.
• The shortcuts dialog describes E-004 correctly.

Agent tools: wall types, railings, posts and room types are exposed (E-010).

Changes made in review

• Walls:
  • restore auto host splitting;
  • one-wall Walls variant;
  • B recall;
  • Build-panel Walls sub-row;
  • wall types in the wall panel (WallTypeMenu);
  • plain new walls, with the drawn-wall-type code removed;
  • multi-wall push move;
  • multi-wall selection dimensions.
• Display:
  • menu regrouped;
  • wallDimensionReference removed in favour of wallDimensionFaces;
  • new Dimensions on-off;
  • Split / Merge tooltips.
• Selection: click-to-move restored; plugin inspector views moved to the action menu.
• Floor plates / foundations: reverted to main as above; porches, decks and patios rebuilt on main's plates; ceiling caps measured against main's slabs.
• Stairs:
  • stale automatic cutouts healed in reconciliation;
  • the live drag preview no longer survives the drop;
  • repro tests added.
• Levels: hidden upper levels cast shadows again (with main's tests).
• Rooms: Garage rule removed.
• Doors and windows:
  • casing new-only, plus per-side slots;
  • window and door frame depth = wall;
  • 20 mm frames on creation (schema defaults unchanged, so saved openings keep theirs);
  • swap actions open the leaf;
  • casement hinge swap.
• Materials:
  • siding and shingles to KTX2;
  • tinted thumbnail swatches;
  • CDN-miss fallback to the app's own asset.
• Architecture:
  • renderOpeningContent on the host-surface contract (railing doors);
  • porch posts counted by marker;
  • porch framing guard;
  • outdoor plates read roomType.
• Agent tools: add_wall.type, add_wall.wallType: 'railing', set_wall_type, add_column posts, get_zones outdoor rooms, get_walls types.
• Translations: catalogs re-extracted; es / fr / ja / zh-CN drafts for new and changed copy, marked for review.

Old scenes (E-003)

• Main's scenes load as on main; the corpus and frozen-floor gates are unchanged.
• Scenes saved on this branch before the review still open: removed fields are ignored, and removed kinds behave like an uninstalled plugin's.
• Existing doors and windows load without casing.

Not in this PR (follow-ups)

• pascalorg/private-editor#1412 needs to follow this branch: Bones' designed-foundation and footing framing, the community Build tab and Display menu, the removed exports, and the hosted agent-tool parity for set_wall_type and the new inputs.
• Agent tools: add_beam, and the pascal-3d skill docs (porches, railings and beams are still described as free objects).
• Railings: consolidate the four railing mechanisms (fence, slab railing, stair railing, railing wall).
• Main's generic foundation (Underground: the ground steps aside over a basement, the world turns to earth below it, a ground line in the levels, and a foundation under every house #1097): draw nothing under an on-ground slab, and decide per plate rather than per level (one raised plate currently removes the foundation under the whole level).
• DECISIONS.md: add a superseding entry for 2D plan selection (a wall click selects the wall, while 3D stays room-first).

🤖 Generated with Claude Code

[cursor]

This PR is too large for Bugbot to review. It changes 59,852 lines and 3,318,517 characters. Split the change into smaller pull requests to get a review.