editor: complete floorplan construction documentation (#531)

* Add roof surface placement support for items

Items (e.g. solar panels) can now be placed on sloped roof surfaces.
The placement system computes euler rotation from the roof surface
normal so items sit flush on the slope instead of going inside.

- Add roofStrategy to placement-strategies with enter/move/click/leave
- Wire roof:enter/move/click/leave events in the placement coordinator
- Add calculateRoofRotation in placement-math using surface normals
- Support full 3D cursor rotation for sloped surfaces
- Items on roofs are parented to the level with world-space rotation

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* fixed conflict

* feat(floorplan): add construction dimension strings

* feat(floorplan): coordinate opening dimensions

* feat(floorplan): add opening documentation

* feat(floorplan): add construction dimensions and notes

* feat(floorplan): add interior dimensions and curved note leaders

* feat(floorplan): improve construction dimensions and document plan

* feat(floorplan): harden construction document output

* feat(floorplan): add annotation collision diagnostics

* feat(floorplan): size export annotations in paper space

* feat(floorplan): automatically separate overlapping labels

* fix(floorplan): resolve dense label overlaps

* fix(floorplan): remove stale collision warning overlays

* fix(floorplan): treat mark pills as collision obstacles

* feat(floorplan): place short dimension values outside

* fix(floorplan): preserve dimension string order

* fix(floorplan): avoid architectural geometry in label layout

* feat(floorplan): add dimension side fallback leaders

* docs(floorplan): update chapter 17 implementation status

* fix(floorplan): dimension subdivided interior walls

* feat: add associative floor plan dimensions

* feat: add continuous construction dimension strings

* feat: add structural floor plan grids

* feat: coordinate columns with structural grids

Snap column placement and movement to structural axes and intersections, derive associative grid references, and preserve floor-plan rotation by allowing secondary-button pointer moves through the grid drafting layer.

* feat: add architectural room documentation

Add room-role metadata, editable documentation fields, centered room labels, and persisted live/PDF visibility while preserving generic zone behavior.

* feat: generate architectural room schedules

Add registry-driven room schedule rows with unit-aware areas and heights, natural room ordering, enclosure resolution, and document-quality warnings.

* feat: add reliable room clear dimensions

Derive unit-aware clear dimensions from proven modeled inside wall faces for straight rectangular rooms, including rotated and split-wall enclosures, while suppressing unproven datums.

* feat: add architectural stair documentation

Add level-aware UP/DN graphics, derived flight and rail notes, plan break and overhead conventions, linked destination-level projection, and persisted live/PDF visibility.

* feat: add typed specialty construction notes

Add schema-validated specialty payloads, standardized plan notation, contract-scope metadata, configurable overhead outlines, and editor authoring controls.

* feat: add curved and circular dimensions

Add associative radius, diameter, center, chord, arc-length, angular, and coordinate modes with unit-aware notation, repeated-feature labels, 2D authoring, and document controls.

* feat: coordinate floor plan drawing types

Add persistent floor, foundation, reflected-ceiling, roof, and site plan views with per-dimension show, omit, reference, and foundation-controller behavior across live and PDF output.

* feat: add associative curved wall dimensions

Bind radius, center, chord, arc-length, and angular construction dimensions directly to curved wall geometry so annotations update when the host curve changes.

* fix: render automatic curved wall dimensions

The wall floor-plan builder explicitly skipped curved walls, leaving the associative authoring workflow as the only dimension path. Render a concentric arc-length dimension automatically and keep it governed by automatic-dimension visibility.

* fix: use radius callout for curved walls

Replace the automatic arc-length annotation with the source-standard radius method: computed center mark, radial leader, curve arrow, and R value. Keep adjacent linear strings responsible for locating the curve tangencies and depth.

* Implement construction dimension string editing

* Add construction dimension standards controls

* Apply drawing standards to automatic dimensions

* Add floorplan overhead and reference visibility controls

* Add view-specific dimension segment suppression

* Add persistent drawing sheet model

* Plot floorplan exports at fixed scale

* Apply paper-space annotation profiles

* Compose floorplan PDF sheets

* Support sheet paper sizes and preflight

* Persist pinned annotation layout overrides

* Expand annotation collision obstacles

* Add floorplan annotation preflight surface

* Add reusable drawing sheet general notes

* Add drawing sheet keyed note instances

* Add drawing sheet document markers

* Expand construction note leader terminators

* Add wall assembly layer model

* Resolve wall assembly datum references

* Add wall assembly floorplan graphics

* Add opening documentation dimension policies

* Add finish-face room clear dimensions

* Extend room clear dimensions to rectilinear rooms

* Add construction module advisories

* Add clearance advisory profiles

* Add dimension completeness audit

* Expand dimension completeness audit

* Include preflight issues in completeness audit

* feat: complete floorplan construction documentation

* refactor: remove construction note node

* feat: refine floorplan documentation and unit display

* fix(editor): improve floorplan PDF dimensions

* fix(floorplan): refresh annotation collision layout

* fix(floorplan): keep annotations clear and restore registry boundaries

* feat(floorplan): refine construction dimension references

* fix(floorplan): align documentation tools with architecture

---------

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
Sudhir Yadav
2026-07-22 14:02:17 -04:00
committed by GitHub
co-authored by Claude Opus 4.6
parent 2adb50a340
commit 77442861d9
181 changed files with 25002 additions and 800 deletions
+5 -1
View File
@@ -129,7 +129,11 @@ export {
} from './lib/texture-reference'
export { packNormalToRGB, unpackRGBToNormal } from './lib/tsl-compat'
export { useItemLightPool } from './store/use-item-light-pool'
export { applyCountryUnitDefault, default as useViewer } from './store/use-viewer'
export {
applyCountryUnitDefault,
default as useViewer,
type MetricNotation,
} from './store/use-viewer'
export { CeilingSystem } from './systems/ceiling/ceiling-system'
export {
createColumnBoxGeometry,
@@ -10,6 +10,7 @@ const resetMeasurementPreferences = () => {
projectPreferences: {},
showMeasurements: true,
unit: 'metric',
metricNotation: 'meters',
})
}
@@ -49,6 +50,17 @@ describe('measurement display preferences', () => {
expect(useViewer.getState().projectPreferences).toEqual(preferences)
expect(useViewer.getState().showMeasurements).toBe(false)
})
test('selects millimeters as a metric display notation', () => {
useViewer.getState().setUnit('imperial')
useViewer.getState().setMetricNotation('millimeters')
expect(useViewer.getState()).toMatchObject({
unit: 'metric',
metricNotation: 'millimeters',
unitExplicit: true,
})
})
})
describe('external selection highlights', () => {
+10
View File
@@ -10,6 +10,7 @@ import type { ColorPreset, RenderShading } from '../lib/materials'
import { SCENE_THEME_IDS } from '../lib/scene-themes'
export type RenderContext = 'editor' | 'viewer'
export type MetricNotation = 'meters' | 'millimeters'
type SelectionPath = {
buildingId: BuildingNode['id'] | null
@@ -83,6 +84,8 @@ type ViewerState = {
unit: 'metric' | 'imperial'
setUnit: (unit: 'metric' | 'imperial') => void
metricNotation: MetricNotation
setMetricNotation: (notation: MetricNotation) => void
/** True once the user explicitly picked a unit. Until then `unit` is a
* locale-derived default and is not persisted, so the default can keep
* tracking the browser locale across sessions. */
@@ -186,6 +189,7 @@ type PersistedViewerState = Partial<
| 'edges'
| 'shadows'
| 'unit'
| 'metricNotation'
| 'unitExplicit'
| 'levelMode'
| 'wallMode'
@@ -198,6 +202,7 @@ const RENDER_SHADINGS = ['solid', 'rendered'] as const
const COLOR_PRESETS = ['clay', 'white', 'mono', 'blueprint'] as const
const EDGE_MODES = ['off', 'soft', 'strong'] as const
const UNITS = ['metric', 'imperial'] as const
const METRIC_NOTATIONS = ['meters', 'millimeters'] as const
const LEVEL_MODES = ['stacked', 'exploded', 'solo', 'manual'] as const
const WALL_MODES = ['up', 'cutaway', 'down', 'translucent'] as const
@@ -309,6 +314,7 @@ function normalizePersistedViewerState(value: unknown): PersistedViewerState {
edges: pickString<EdgeMode>(state.edges, EDGE_MODES, 'soft'),
shadows: typeof state.shadows === 'boolean' ? state.shadows : true,
unit: pickString<ViewerState['unit']>(state.unit, UNITS, detectDefaultUnit()),
metricNotation: pickString<MetricNotation>(state.metricNotation, METRIC_NOTATIONS, 'meters'),
unitExplicit:
typeof state.unit === 'string' && UNITS.includes(state.unit as ViewerState['unit']),
levelMode: pickString<ViewerState['levelMode']>(state.levelMode, LEVEL_MODES, 'stacked'),
@@ -391,8 +397,11 @@ const useViewer = create<ViewerState>()(
setShadows: (shadows) => set({ shadows }),
unit: detectDefaultUnit(),
metricNotation: 'meters',
unitExplicit: false,
setUnit: (unit) => set({ unit, unitExplicit: true }),
setMetricNotation: (metricNotation) =>
set({ unit: 'metric', metricNotation, unitExplicit: true }),
levelMode: 'stacked',
setLevelMode: (mode) => set({ levelMode: mode }),
@@ -545,6 +554,7 @@ const useViewer = create<ViewerState>()(
edges: state.edges,
shadows: state.shadows,
...(state.unitExplicit ? { unit: state.unit } : {}),
metricNotation: state.metricNotation,
levelMode: state.levelMode,
wallMode: state.wallMode,
projectPreferences: state.projectPreferences,