@pascal-app/editor 1.0.3 → 1.0.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (624) hide show
  1. package/README.md +106 -0
  2. package/package.json +42 -38
  3. package/src/components/editor/__bench__/room-label-placement.bench.ts +108 -0
  4. package/src/components/editor/action-menu-button.tsx +83 -0
  5. package/src/components/editor/bake-thumbnail.tsx +307 -5
  6. package/src/components/editor/capture-level-picker.tsx +72 -0
  7. package/src/components/editor/construction-reveal-audio.test.tsx +150 -0
  8. package/src/components/editor/construction-reveal-audio.tsx +40 -0
  9. package/src/components/editor/custom-camera-controls.tsx +275 -57
  10. package/src/components/editor/delete-confirmation-dialog.tsx +297 -7
  11. package/src/components/editor/duplicate-node.ts +244 -0
  12. package/src/components/editor/editor-layout-mobile.tsx +37 -26
  13. package/src/components/editor/editor-layout-v2.tsx +132 -59
  14. package/src/components/editor/export-manager.tsx +47 -26
  15. package/src/components/editor/first-person/build-collider-world.test.ts +320 -0
  16. package/src/components/editor/first-person/build-collider-world.ts +28 -7
  17. package/src/components/editor/first-person/ground-holes.test.ts +128 -0
  18. package/src/components/editor/first-person/ground-holes.ts +130 -0
  19. package/src/components/editor/first-person/mechanism-targets.test.ts +162 -0
  20. package/src/components/editor/first-person/mechanism-targets.ts +88 -0
  21. package/src/components/editor/first-person-controls.tsx +220 -9
  22. package/src/components/editor/floating-action-menu.tsx +63 -207
  23. package/src/components/editor/floor-aware-camera-controls.test.ts +466 -0
  24. package/src/components/editor/floor-aware-camera-controls.ts +324 -0
  25. package/src/components/editor/floor-openings-overlay.tsx +243 -0
  26. package/src/components/editor/floor-region-controls.tsx +846 -0
  27. package/src/components/editor/floor-region-webgpu-materials.test.ts +12 -0
  28. package/src/components/editor/floor-surface.test.ts +165 -0
  29. package/src/components/editor/floor-surface.ts +182 -0
  30. package/src/components/editor/floorplan-background-selection.test.ts +11 -2
  31. package/src/components/editor/floorplan-background-selection.ts +1 -3
  32. package/src/components/editor/floorplan-mode-coordinator.tsx +2 -2
  33. package/src/components/editor/floorplan-panel.tsx +414 -363
  34. package/src/components/editor/follow-pascal.test.tsx +912 -0
  35. package/src/components/editor/follow-pascal.tsx +354 -0
  36. package/src/components/editor/footprint-height-handle.tsx +204 -0
  37. package/src/components/editor/group-actions.ts +56 -2
  38. package/src/components/editor/group-move-3d.ts +2 -0
  39. package/src/components/editor/group-rotate-handle.tsx +2 -0
  40. package/src/components/editor/group-transform-shared.test.ts +460 -0
  41. package/src/components/editor/handles/handle-hit-priority.test.tsx +63 -0
  42. package/src/components/editor/handles/handle-hit-priority.tsx +37 -0
  43. package/src/components/editor/handles/swallow-next-click.test.ts +28 -0
  44. package/src/components/editor/handles/use-handle-drag.ts +269 -197
  45. package/src/components/editor/index.tsx +409 -197
  46. package/src/components/editor/join-walls-pill.tsx +44 -0
  47. package/src/components/editor/node-action-menu.tsx +68 -70
  48. package/src/components/editor/node-arrow-handles.tsx +25 -6
  49. package/src/components/editor/open-wall-ends-3d-layer.tsx +273 -0
  50. package/src/components/editor/open-wall-ends-hint.tsx +89 -0
  51. package/src/components/editor/quick-measurement-hud.tsx +3 -2
  52. package/src/components/editor/registry-action-contributions.test.tsx +63 -0
  53. package/src/components/editor/registry-action-contributions.tsx +80 -1
  54. package/src/components/editor/riser-diagram-panel.tsx +14 -7
  55. package/src/components/editor/room-controls.tsx +847 -0
  56. package/src/components/editor/room-floor-highlight.tsx +128 -0
  57. package/src/components/editor/room-handles-2d.tsx +354 -0
  58. package/src/components/editor/room-handles.tsx +675 -0
  59. package/src/components/editor/room-highlight.tsx +233 -0
  60. package/src/components/editor/room-labels.test.ts +850 -0
  61. package/src/components/editor/room-labels.tsx +1890 -0
  62. package/src/components/editor/room-transform-ghost.tsx +256 -0
  63. package/src/components/editor/room-webgpu-materials.test.ts +27 -0
  64. package/src/components/editor/selection-manager.tsx +474 -419
  65. package/src/components/editor/slab-hole-highlights.tsx +5 -2
  66. package/src/components/editor/snapshot-capture-overlay.tsx +7 -2
  67. package/src/components/editor/snapshot-capture.test.ts +119 -60
  68. package/src/components/editor/snapshot-capture.ts +36 -5
  69. package/src/components/editor/thumbnail-generator.test.ts +654 -0
  70. package/src/components/editor/thumbnail-generator.tsx +1103 -223
  71. package/src/components/editor/use-floorplan-background-placement.ts +34 -12
  72. package/src/components/editor/vector-edge-extractor.tsx +121 -0
  73. package/src/components/editor/views/host-view.tsx +61 -0
  74. package/src/components/editor/views/plugins-view.tsx +663 -0
  75. package/src/components/editor/views/scene-region.tsx +59 -0
  76. package/src/components/editor/views/use-editor-views.ts +57 -0
  77. package/src/components/editor/views/view-bar.test.tsx +54 -0
  78. package/src/components/editor/views/view-bar.tsx +343 -0
  79. package/src/components/editor/wall-justification.test.ts +140 -0
  80. package/src/components/editor/wall-move-side-handles.tsx +43 -142
  81. package/src/components/editor/wall-push-arrow.tsx +92 -0
  82. package/src/components/editor/wall-region-handles.tsx +509 -0
  83. package/src/components/editor/wall-snap-beacon-layer.tsx +8 -4
  84. package/src/components/editor-2d/floorplan-cursor-indicator-overlay.tsx +8 -4
  85. package/src/components/editor-2d/floorplan-group-move.tsx +3 -0
  86. package/src/components/editor-2d/floorplan-open-wall-ends-layer.test.tsx +86 -0
  87. package/src/components/editor-2d/floorplan-open-wall-ends-layer.tsx +290 -0
  88. package/src/components/editor-2d/floorplan-registered-tool-layer.tsx +2 -2
  89. package/src/components/editor-2d/floorplan-registry-action-menu.tsx +11 -1
  90. package/src/components/editor-2d/floorplan-registry-move-overlay.tsx +116 -106
  91. package/src/components/editor-2d/renderers/floorplan-dimension-edit-overlay.test.ts +156 -0
  92. package/src/components/editor-2d/renderers/floorplan-dimension-edit-overlay.tsx +278 -0
  93. package/src/components/editor-2d/renderers/floorplan-dimension-renderer.tsx +77 -0
  94. package/src/components/editor-2d/renderers/{floorplan-draft-wall-measurement.tsx → floorplan-draft-measurement.tsx} +8 -8
  95. package/src/components/editor-2d/renderers/floorplan-geometry-renderer.tsx +4 -1
  96. package/src/components/editor-2d/renderers/floorplan-registry-layer.test.ts +38 -8
  97. package/src/components/editor-2d/renderers/floorplan-registry-layer.tsx +319 -233
  98. package/src/components/editor-2d/renderers/floorplan-reveal.test.tsx +254 -0
  99. package/src/components/editor-2d/renderers/floorplan-reveal.ts +141 -0
  100. package/src/components/editor-2d/svg-paths.ts +12 -15
  101. package/src/components/point-ask/bubble.tsx +538 -0
  102. package/src/components/point-ask/hover-chip.tsx +91 -0
  103. package/src/components/point-ask/mode-pill.tsx +92 -0
  104. package/src/components/point-ask/optional-motion.ts +22 -0
  105. package/src/components/point-ask/outline-corners.tsx +93 -0
  106. package/src/components/point-ask/pins.tsx +711 -0
  107. package/src/components/point-ask/point-ask-layer.tsx +83 -0
  108. package/src/components/point-ask/point-ask-styles.ts +105 -0
  109. package/src/components/point-ask/region-marquee-styles.ts +15 -0
  110. package/src/components/point-ask/region-marquee.tsx +64 -0
  111. package/src/components/procedural-items/inspector.tsx +40 -15
  112. package/src/components/systems/ceiling/ceiling-bracket-batch.test.ts +12 -2
  113. package/src/components/systems/ceiling/ceiling-selection-affordance-system.test.ts +97 -14
  114. package/src/components/systems/ceiling/ceiling-selection-affordance-system.tsx +18 -18
  115. package/src/components/systems/roof/roof-edit-system.tsx +1 -0
  116. package/src/components/systems/zone/zone-system.test.ts +47 -0
  117. package/src/components/systems/zone/zone-system.tsx +29 -68
  118. package/src/components/tools/distribution/connection-compatibility.test.ts +34 -0
  119. package/src/components/tools/distribution/connection-compatibility.ts +43 -0
  120. package/src/components/tools/distribution/distribution-public.ts +9 -0
  121. package/src/components/tools/distribution/distribution-run-contract.test.ts +26 -0
  122. package/src/components/tools/distribution/distribution-run-contract.ts +94 -0
  123. package/src/components/tools/distribution/distribution-run-tool.test.ts +241 -0
  124. package/src/components/tools/distribution/distribution-run-tool.test.tsx +125 -0
  125. package/src/components/tools/distribution/distribution-run-tool.tsx +1323 -0
  126. package/src/components/tools/distribution/draw-alignment.ts +35 -0
  127. package/src/components/tools/distribution/ports.test.ts +56 -0
  128. package/src/components/tools/distribution/ports.ts +378 -0
  129. package/src/components/tools/distribution/run-cursor.test.ts +135 -0
  130. package/src/components/tools/distribution/run-cursor.ts +36 -0
  131. package/src/components/tools/distribution/run-direction-feedback.test.ts +60 -0
  132. package/src/components/tools/distribution/run-direction-feedback.tsx +251 -0
  133. package/src/components/tools/distribution/run-port-snap.test.ts +79 -0
  134. package/src/components/tools/distribution/run-port-snap.ts +25 -0
  135. package/src/components/tools/distribution/run-screen-direction.test.ts +23 -0
  136. package/src/components/tools/distribution/run-screen-direction.ts +30 -0
  137. package/src/components/tools/elevator/elevator-tool.tsx +3 -6
  138. package/src/components/tools/elevator/move-elevator-tool.tsx +2 -3
  139. package/src/components/tools/item/item-surface-strategy-resolver.test.ts +67 -68
  140. package/src/components/tools/item/placement-history.test.tsx +512 -0
  141. package/src/components/tools/item/placement-strategies.test.ts +46 -1
  142. package/src/components/tools/item/placement-strategies.ts +11 -10
  143. package/src/components/tools/item/shelf-surface-strategy-resolver.test.ts +56 -56
  144. package/src/components/tools/item/use-draft-node.test.tsx +432 -1
  145. package/src/components/tools/item/use-draft-node.ts +166 -95
  146. package/src/components/tools/item/use-placement-coordinator.tsx +148 -95
  147. package/src/components/tools/paint-region/use-paint-tint.ts +37 -0
  148. package/src/components/tools/paint-region/wall-paint-region-tool.tsx +466 -0
  149. package/src/components/tools/registry/item-surface-move.test.ts +62 -63
  150. package/src/components/tools/registry/item-surface-move.ts +2 -0
  151. package/src/components/tools/registry/item-surface-resolver.test.ts +26 -26
  152. package/src/components/tools/registry/move-registry-node-tool.test.ts +268 -1
  153. package/src/components/tools/registry/move-registry-node-tool.tsx +66 -30
  154. package/src/components/tools/select/box-select-tool.tsx +2 -12
  155. package/src/components/tools/select/plane-box-select-tool.test.tsx +79 -0
  156. package/src/components/tools/select/plane-box-select-tool.tsx +35 -22
  157. package/src/components/tools/select/select-candidates.test.ts +37 -4
  158. package/src/components/tools/select/select-candidates.ts +15 -11
  159. package/src/components/tools/shared/cursor-sphere.tsx +36 -12
  160. package/src/components/tools/site/site-boundary-editor.tsx +1 -2
  161. package/src/components/tools/tool-manager.tsx +59 -24
  162. package/src/components/tools/wall/wall-drafting.test.ts +175 -47
  163. package/src/components/tools/zone/zone-tool.tsx +4 -12
  164. package/src/components/ui/action-menu/action-button.tsx +9 -1
  165. package/src/components/ui/action-menu/camera-actions.tsx +9 -4
  166. package/src/components/ui/action-menu/control-modes.tsx +15 -42
  167. package/src/components/ui/action-menu/follow-pascal-pill.tsx +32 -0
  168. package/src/components/ui/action-menu/follow-pascal-toggle.tsx +36 -0
  169. package/src/components/ui/action-menu/index.tsx +56 -33
  170. package/src/components/ui/action-menu/measurement-control.tsx +14 -19
  171. package/src/components/ui/action-menu/placement.ts +20 -0
  172. package/src/components/ui/action-menu/point-ask-button.tsx +52 -0
  173. package/src/components/ui/action-menu/view-toggles.tsx +47 -42
  174. package/src/components/ui/build-panel/build-panel.tsx +242 -0
  175. package/src/components/ui/command-palette/editor-commands.tsx +7 -42
  176. package/src/components/ui/command-palette/index.tsx +50 -39
  177. package/src/components/ui/command-palette/ranked-groups.test.ts +31 -0
  178. package/src/components/ui/controls/action-button.tsx +5 -2
  179. package/src/components/ui/controls/finish-swatch.tsx +110 -0
  180. package/src/components/ui/controls/material-paint-panel.tsx +97 -26
  181. package/src/components/ui/controls/material-picker.tsx +4 -1
  182. package/src/components/ui/controls/metric-control.tsx +1 -1
  183. package/src/components/ui/controls/scene-material-list.tsx +4 -32
  184. package/src/components/ui/controls/segmented-control.tsx +21 -8
  185. package/src/components/ui/controls/select-control.tsx +65 -0
  186. package/src/components/ui/controls/slider-control.tsx +1 -1
  187. package/src/components/ui/controls/toggle-control.tsx +3 -3
  188. package/src/components/ui/controls/tool-options-panel.tsx +1 -1
  189. package/src/components/ui/floating-level-selector.tsx +159 -59
  190. package/src/components/ui/helpers/building-helper.tsx +4 -1
  191. package/src/components/ui/helpers/contextual-helper-panel.tsx +181 -72
  192. package/src/components/ui/helpers/helper-manager.test.tsx +121 -0
  193. package/src/components/ui/helpers/helper-manager.tsx +331 -14
  194. package/src/components/ui/helpers/item-helper.tsx +17 -1
  195. package/src/components/ui/helpers/registered-tool-helper.tsx +8 -1
  196. package/src/components/ui/icon-ref.tsx +45 -1
  197. package/src/components/ui/level-duplicate-dialog.tsx +1 -1
  198. package/src/components/ui/node-icon-image.tsx +16 -0
  199. package/src/components/ui/panels/collections/collections-popover.tsx +28 -22
  200. package/src/components/ui/panels/floor-foundation-panel.tsx +551 -0
  201. package/src/components/ui/panels/floor-opening-panel.tsx +143 -0
  202. package/src/components/ui/panels/mobile-panel-sheet.tsx +4 -4
  203. package/src/components/ui/panels/mobile-selection-bar.tsx +8 -5
  204. package/src/components/ui/panels/multi-field-value.test.ts +26 -3
  205. package/src/components/ui/panels/multi-field-value.ts +6 -3
  206. package/src/components/ui/panels/multi-parametric-inspector.tsx +52 -2
  207. package/src/components/ui/panels/multi-selection-panel.tsx +161 -5
  208. package/src/components/ui/panels/node-display.ts +8 -3
  209. package/src/components/ui/panels/panel-manager.tsx +103 -68
  210. package/src/components/ui/panels/panel-wrapper.tsx +130 -62
  211. package/src/components/ui/panels/parametric-field-control.tsx +3 -3
  212. package/src/components/ui/panels/parametric-inspector.tsx +7 -7
  213. package/src/components/ui/panels/reference-panel.tsx +2 -3
  214. package/src/components/ui/panels/room-construction-rows.tsx +774 -0
  215. package/src/components/ui/panels/room-name-options.test.ts +55 -0
  216. package/src/components/ui/panels/room-name-options.ts +47 -0
  217. package/src/components/ui/panels/room-openings-field.tsx +110 -0
  218. package/src/components/ui/panels/room-panel.tsx +790 -0
  219. package/src/components/ui/panels/shape-choice.tsx +58 -0
  220. package/src/components/ui/panels/wall-region-list.tsx +109 -0
  221. package/src/components/ui/primitives/badge.tsx +8 -0
  222. package/src/components/ui/primitives/color-dot.tsx +36 -24
  223. package/src/components/ui/primitives/sidebar.tsx +3 -1
  224. package/src/components/ui/right-stack.test.ts +29 -0
  225. package/src/components/ui/right-stack.tsx +164 -0
  226. package/src/components/ui/sidebar/app-sidebar.tsx +1 -1
  227. package/src/components/ui/sidebar/icon-rail.tsx +8 -3
  228. package/src/components/ui/sidebar/panels/items-panel/function-tree-panel.tsx +1 -1
  229. package/src/components/ui/sidebar/panels/items-panel/index.tsx +6 -6
  230. package/src/components/ui/sidebar/panels/settings-panel/animation-speed-setting.tsx +40 -0
  231. package/src/components/ui/sidebar/panels/settings-panel/audio-settings-dialog.tsx +7 -8
  232. package/src/components/ui/sidebar/panels/settings-panel/construction-animation-setting.test.tsx +170 -0
  233. package/src/components/ui/sidebar/panels/settings-panel/construction-animation-setting.tsx +92 -0
  234. package/src/components/ui/sidebar/panels/settings-panel/index.tsx +138 -27
  235. package/src/components/ui/sidebar/panels/settings-panel/interface-theme.test.tsx +20 -0
  236. package/src/components/ui/sidebar/panels/settings-panel/keyboard-shortcuts-dialog.tsx +5 -5
  237. package/src/components/ui/sidebar/panels/settings-panel/print-export-button.tsx +4 -10
  238. package/src/components/ui/sidebar/panels/site-panel/building-tree-node.tsx +3 -11
  239. package/src/components/ui/sidebar/panels/site-panel/ceiling-tree-node.tsx +4 -4
  240. package/src/components/ui/sidebar/panels/site-panel/chimney-tree-node.tsx +1 -5
  241. package/src/components/ui/sidebar/panels/site-panel/collection-tree-node.tsx +197 -0
  242. package/src/components/ui/sidebar/panels/site-panel/column-tree-node.tsx +1 -5
  243. package/src/components/ui/sidebar/panels/site-panel/door-tree-node.tsx +1 -5
  244. package/src/components/ui/sidebar/panels/site-panel/dormer-tree-node.tsx +1 -5
  245. package/src/components/ui/sidebar/panels/site-panel/elevator-tree-node.tsx +1 -5
  246. package/src/components/ui/sidebar/panels/site-panel/fence-tree-node.tsx +24 -11
  247. package/src/components/ui/sidebar/panels/site-panel/gutter-tree-node.tsx +1 -5
  248. package/src/components/ui/sidebar/panels/site-panel/index.tsx +181 -223
  249. package/src/components/ui/sidebar/panels/site-panel/inline-rename-input.tsx +30 -8
  250. package/src/components/ui/sidebar/panels/site-panel/item-tree-node.tsx +1 -3
  251. package/src/components/ui/sidebar/panels/site-panel/level-tree-node.tsx +4 -1
  252. package/src/components/ui/sidebar/panels/site-panel/registry-tree-node.tsx +1 -3
  253. package/src/components/ui/sidebar/panels/site-panel/roof-tree-node.tsx +1 -4
  254. package/src/components/ui/sidebar/panels/site-panel/shelf-tree-node.tsx +1 -3
  255. package/src/components/ui/sidebar/panels/site-panel/slab-tree-node.tsx +21 -13
  256. package/src/components/ui/sidebar/panels/site-panel/solar-panel-tree-node.tsx +1 -5
  257. package/src/components/ui/sidebar/panels/site-panel/spawn-tree-node.tsx +1 -5
  258. package/src/components/ui/sidebar/panels/site-panel/stair-tree-node.tsx +1 -5
  259. package/src/components/ui/sidebar/panels/site-panel/tree-node.tsx +13 -37
  260. package/src/components/ui/sidebar/panels/site-panel/unit-tree-node.tsx +2 -3
  261. package/src/components/ui/sidebar/panels/site-panel/wall-tree-node.tsx +1 -5
  262. package/src/components/ui/sidebar/panels/site-panel/window-tree-node.tsx +1 -5
  263. package/src/components/ui/sidebar/panels/site-panel/zone-tree-node.tsx +9 -4
  264. package/src/components/ui/sidebar/panels/zone-panel/index.tsx +2 -4
  265. package/src/components/ui/sidebar/tab-bar.tsx +14 -4
  266. package/src/components/ui/sidebar/use-plugin-panels.tsx +15 -5
  267. package/src/components/viewer/floorplan-compass-button.tsx +9 -1
  268. package/src/components/viewer/floorplan-preview.tsx +5 -6
  269. package/src/components/viewer/viewer-controls-bar.tsx +18 -6
  270. package/src/components/viewer/viewer-hover-label.tsx +34 -0
  271. package/src/components/viewer/viewer-rooms.tsx +191 -0
  272. package/src/components/viewer/viewer-scene-header.tsx +181 -145
  273. package/src/components/viewer/viewer-selection-manager.tsx +124 -0
  274. package/src/components/viewer/viewer-stage.tsx +2 -2
  275. package/src/components/viewer-zone-system.tsx +3 -8
  276. package/src/hooks/use-auto-save.integration.test.tsx +215 -43
  277. package/src/hooks/use-auto-save.ts +60 -9
  278. package/src/hooks/use-ceiling-events.test.ts +123 -118
  279. package/src/hooks/use-grid-events.test.ts +105 -105
  280. package/src/hooks/use-keyboard.test.ts +243 -19
  281. package/src/hooks/use-keyboard.ts +118 -83
  282. package/src/hooks/use-open-wall-ends.test.ts +99 -0
  283. package/src/hooks/use-open-wall-ends.ts +238 -0
  284. package/src/hooks/use-placement-notice.test.ts +71 -0
  285. package/src/hooks/use-placement-notice.ts +73 -0
  286. package/src/hooks/use-selected-room.ts +143 -0
  287. package/src/index.tsx +312 -58
  288. package/src/lib/__fixtures__/owner-victor-seattle-parking.json +1 -0
  289. package/src/lib/__fixtures__/owner-villa-aurelia-basement.json +1 -0
  290. package/src/lib/add-storey.test.ts +177 -0
  291. package/src/lib/add-storey.ts +59 -0
  292. package/src/lib/below-grade.test.tsx +171 -0
  293. package/src/lib/below-grade.ts +133 -0
  294. package/src/lib/camera-facing.test.ts +24 -0
  295. package/src/lib/camera-facing.ts +24 -0
  296. package/src/lib/ceiling-edit-session.test.ts +321 -0
  297. package/src/lib/ceiling-edit-session.ts +206 -0
  298. package/src/lib/ceiling-region-session.test.ts +179 -0
  299. package/src/lib/continuation.test.ts +19 -1
  300. package/src/lib/continuation.ts +25 -4
  301. package/src/lib/direct-manipulation.ts +2 -0
  302. package/src/lib/door-interaction.ts +14 -0
  303. package/src/lib/download-project-file.ts +17 -0
  304. package/src/lib/editor-level-display.test.ts +96 -0
  305. package/src/lib/editor-level-display.ts +55 -0
  306. package/src/lib/editor-views.ts +178 -0
  307. package/src/lib/export-geometry-wait.test.ts +90 -0
  308. package/src/lib/export-texture-utils.ts +2 -4
  309. package/src/lib/floor-edit-session.ts +153 -0
  310. package/src/lib/floor-footprints.test.ts +563 -0
  311. package/src/lib/floor-footprints.ts +395 -0
  312. package/src/lib/floor-foundation-support.test.ts +284 -0
  313. package/src/lib/floor-opening-draft.ts +218 -0
  314. package/src/lib/floor-openings.test.ts +216 -0
  315. package/src/lib/floor-region-geometry.ts +191 -0
  316. package/src/lib/floor-region-session.test.ts +485 -0
  317. package/src/lib/floor-region-session.ts +589 -0
  318. package/src/lib/floor-region-snap.ts +101 -0
  319. package/src/lib/floor-step-hover.test.ts +32 -0
  320. package/src/lib/floorplan/annotation-visibility.ts +17 -0
  321. package/src/lib/floorplan/dimension-drive.test.ts +360 -0
  322. package/src/lib/floorplan/dimension-drive.ts +479 -0
  323. package/src/lib/floorplan/floorplan-export.test.ts +12 -8
  324. package/src/lib/floorplan/floorplan-export.tsx +32 -8
  325. package/src/lib/floorplan/floorplan-extension.ts +32 -0
  326. package/src/lib/floorplan/floorplan-mode.test.ts +4 -0
  327. package/src/lib/floorplan/floorplan-mode.ts +2 -0
  328. package/src/lib/floorplan/floorplan-pdfkit-document.ts +363 -27
  329. package/src/lib/floorplan/floorplan-pdfkit-renderer.test.ts +177 -8
  330. package/src/lib/floorplan/floorplan-pdfkit-renderer.ts +60 -25
  331. package/src/lib/floorplan/floorplan-plugin-install.test.tsx +138 -0
  332. package/src/lib/floorplan/floorplan-readonly.ts +6 -0
  333. package/src/lib/floorplan/geometry.ts +13 -6
  334. package/src/lib/floorplan/index.ts +0 -9
  335. package/src/lib/floorplan/items.ts +5 -2
  336. package/src/lib/floorplan/marks.test.ts +213 -0
  337. package/src/lib/floorplan/marks.ts +238 -0
  338. package/src/lib/floorplan/open-wall-ends.test.ts +268 -0
  339. package/src/lib/floorplan/open-wall-ends.ts +162 -0
  340. package/src/lib/floorplan/pdf-fonts/GeistMono-Bold.ttf +0 -0
  341. package/src/lib/floorplan/pdf-fonts/GeistMono-Regular.ttf +0 -0
  342. package/src/lib/floorplan/pdf-fonts/LICENSE-GeistMono.txt +92 -0
  343. package/src/lib/floorplan/pdf-fonts/LICENSE-LiberationSans.txt +102 -0
  344. package/src/lib/floorplan/pdf-fonts/LiberationSans-Bold.ttf +0 -0
  345. package/src/lib/floorplan/pdf-fonts/LiberationSans-Regular.ttf +0 -0
  346. package/src/lib/floorplan/pdfkit-standard-fonts.d.ts +5 -0
  347. package/src/lib/floorplan/schedules.test.ts +189 -0
  348. package/src/lib/floorplan/schedules.ts +339 -0
  349. package/src/lib/floorplan/sheet-export.test.ts +124 -0
  350. package/src/lib/floorplan/sheet-export.ts +318 -0
  351. package/src/lib/floorplan/site-plan/build-site-plan-drawing.ts +768 -0
  352. package/src/lib/floorplan/site-plan/contours.test.ts +43 -0
  353. package/src/lib/floorplan/site-plan/contributors.ts +97 -0
  354. package/src/lib/floorplan/site-plan/coverage.ts +230 -0
  355. package/src/lib/floorplan/site-plan/drawing-type-switch.test.ts +15 -0
  356. package/src/lib/floorplan/site-plan/drawing-type-switch.tsx +86 -0
  357. package/src/lib/floorplan/site-plan/front-edge.test.ts +103 -0
  358. package/src/lib/floorplan/site-plan/front-edge.ts +157 -0
  359. package/src/lib/floorplan/site-plan/geometry.test.ts +269 -0
  360. package/src/lib/floorplan/site-plan/geometry.ts +142 -0
  361. package/src/lib/floorplan/site-plan/index.ts +55 -0
  362. package/src/lib/floorplan/site-plan/site-annotations.test.ts +483 -0
  363. package/src/lib/floorplan/site-plan/site-annotations.ts +1084 -0
  364. package/src/lib/floorplan/site-plan/site-parts.ts +287 -0
  365. package/src/lib/floorplan/site-plan/site-plan-layer.tsx +138 -0
  366. package/src/lib/floorplan/site-plan/street-name.test.ts +69 -0
  367. package/src/lib/floorplan/site-plan/street-name.ts +302 -0
  368. package/src/lib/floorplan/site-plan/yards.test.ts +70 -0
  369. package/src/lib/floorplan/types.ts +1 -27
  370. package/src/lib/follow-pascal-exterior.test-fixture.ts +17 -0
  371. package/src/lib/follow-pascal-exterior.test.ts +171 -0
  372. package/src/lib/follow-pascal-exterior.ts +39 -0
  373. package/src/lib/follow-pascal-presentation.test.ts +203 -0
  374. package/src/lib/follow-pascal-presentation.ts +129 -0
  375. package/src/lib/follow-pascal-sight.ts +84 -0
  376. package/src/lib/follow-pascal-targets.test.ts +406 -0
  377. package/src/lib/follow-pascal-targets.ts +198 -0
  378. package/src/lib/follow-pascal.test.ts +350 -0
  379. package/src/lib/follow-pascal.ts +284 -0
  380. package/src/lib/fresh-planar-placement.test.ts +148 -0
  381. package/src/lib/fresh-planar-placement.ts +114 -37
  382. package/src/lib/geometry-script/author.ts +157 -0
  383. package/src/lib/geometry-script/client.ts +159 -0
  384. package/src/lib/geometry-script/finish-scripts.ts +127 -0
  385. package/src/lib/geometry-script/protocol.ts +13 -0
  386. package/src/lib/gesture-lifecycle.test.ts +595 -0
  387. package/src/lib/gesture-lifecycle.ts +290 -0
  388. package/src/lib/glb-export-zone-holes.test.ts +41 -0
  389. package/src/lib/glb-export.test.ts +636 -126
  390. package/src/lib/glb-export.ts +241 -120
  391. package/src/lib/history.test.ts +18 -7
  392. package/src/lib/history.ts +7 -0
  393. package/src/lib/hud-title.ts +109 -0
  394. package/src/lib/hydration-gated-storage.ts +49 -0
  395. package/src/lib/ifc-export.test.ts +174 -0
  396. package/src/lib/ifc-export.ts +201 -0
  397. package/src/lib/ifc-parts.ts +15 -0
  398. package/src/lib/inspector-expanded.test.ts +44 -0
  399. package/src/lib/inspector-expanded.ts +36 -0
  400. package/src/lib/interaction/scope.ts +22 -0
  401. package/src/lib/keyboard-pan.test.ts +129 -7
  402. package/src/lib/keyboard-pan.ts +161 -12
  403. package/src/lib/level-selection.test.ts +57 -0
  404. package/src/lib/level-selection.ts +16 -1
  405. package/src/lib/live-gesture-round-trip.test.ts +360 -0
  406. package/src/lib/lot/__fixtures__/map-dossier-miami-shores.json +1 -0
  407. package/src/lib/lot/__fixtures__/map-dossier-stpete.json +1 -0
  408. package/src/lib/lot/clean-ring.test.ts +187 -0
  409. package/src/lib/lot/clean-ring.ts +217 -0
  410. package/src/lib/lot/dossier.test.ts +202 -0
  411. package/src/lib/lot/dossier.ts +498 -0
  412. package/src/lib/lot/drop-in.test.ts +326 -0
  413. package/src/lib/lot/drop-in.ts +392 -0
  414. package/src/lib/lot/index.ts +43 -0
  415. package/src/lib/lot/lot-patch.test.ts +340 -0
  416. package/src/lib/lot/lot-patch.ts +394 -0
  417. package/src/lib/lot/parcel-provider.ts +43 -0
  418. package/src/lib/lot/terrain.test.ts +161 -0
  419. package/src/lib/lot/terrain.ts +266 -0
  420. package/src/lib/material-catalog-model.ts +3 -1
  421. package/src/lib/material-paint-panel-model.ts +9 -5
  422. package/src/lib/material-paint.ts +4 -0
  423. package/src/lib/measurement-kind.test.ts +6 -8
  424. package/src/lib/measurements.test.ts +23 -0
  425. package/src/lib/mezzanine-actions.test.ts +342 -0
  426. package/src/lib/mezzanine-draft.test.ts +501 -0
  427. package/src/lib/mezzanine-draft.ts +278 -0
  428. package/src/lib/mezzanine-messages.ts +26 -0
  429. package/src/lib/mezzanine-selection.test.ts +207 -0
  430. package/src/lib/mezzanine-stairs.ts +46 -0
  431. package/src/lib/model-export.ts +3 -1
  432. package/src/lib/node-action-movement.ts +17 -6
  433. package/src/lib/node-display-label.ts +37 -0
  434. package/src/lib/orbit-floor-clearance.test.ts +201 -0
  435. package/src/lib/orbit-floor-clearance.ts +154 -0
  436. package/src/lib/paint-commit-route.test.ts +37 -0
  437. package/src/lib/paint-commit-route.ts +17 -0
  438. package/src/lib/paint-eyedropper.test.tsx +165 -0
  439. package/src/lib/paint-eyedropper.ts +99 -0
  440. package/src/lib/paint-pass-through.test.ts +122 -0
  441. package/src/lib/paint-pass-through.ts +78 -0
  442. package/src/lib/paint-region-hover.ts +25 -0
  443. package/src/lib/paint-region-mode.ts +154 -0
  444. package/src/lib/paint-regions.test.ts +166 -0
  445. package/src/lib/paint-regions.ts +192 -0
  446. package/src/lib/paint-scope.test.ts +317 -35
  447. package/src/lib/paint-scope.ts +267 -25
  448. package/src/lib/panel-rows.ts +21 -0
  449. package/src/lib/parametric-node-update.ts +16 -7
  450. package/src/lib/plate-paint-affected.test.ts +300 -0
  451. package/src/lib/plate-paint-affected.ts +177 -0
  452. package/src/lib/plugin-chat.ts +65 -0
  453. package/src/lib/plugin-panels.test.ts +25 -0
  454. package/src/lib/plugin-panels.ts +94 -0
  455. package/src/lib/point-ask/__fixtures__/consumer-browser.tsx +76 -0
  456. package/src/lib/point-ask/__fixtures__/house.ts +81 -0
  457. package/src/lib/point-ask/ask-created.test.ts +195 -0
  458. package/src/lib/point-ask/ask-flow.test.ts +380 -0
  459. package/src/lib/point-ask/build-context.test.ts +173 -0
  460. package/src/lib/point-ask/build-context.ts +94 -0
  461. package/src/lib/point-ask/capture-crop.ts +129 -0
  462. package/src/lib/point-ask/choreography.ts +69 -0
  463. package/src/lib/point-ask/compare.test.ts +145 -0
  464. package/src/lib/point-ask/compare.ts +73 -0
  465. package/src/lib/point-ask/describe-target.test.ts +165 -0
  466. package/src/lib/point-ask/describe-target.ts +234 -0
  467. package/src/lib/point-ask/dictation.ts +79 -0
  468. package/src/lib/point-ask/edge-marker.test.ts +61 -0
  469. package/src/lib/point-ask/edge-marker.ts +27 -0
  470. package/src/lib/point-ask/frame-loop.ts +25 -0
  471. package/src/lib/point-ask/history-marks.test.ts +94 -0
  472. package/src/lib/point-ask/history-marks.ts +39 -0
  473. package/src/lib/point-ask/host-api.ts +32 -0
  474. package/src/lib/point-ask/outline-box.test.ts +30 -0
  475. package/src/lib/point-ask/outline-box.ts +11 -0
  476. package/src/lib/point-ask/overlay-metrics.ts +6 -0
  477. package/src/lib/point-ask/pick.test.ts +220 -0
  478. package/src/lib/point-ask/pick.ts +121 -0
  479. package/src/lib/point-ask/pin-machine.test.ts +494 -0
  480. package/src/lib/point-ask/pin-machine.ts +217 -0
  481. package/src/lib/point-ask/placement.test.ts +203 -0
  482. package/src/lib/point-ask/placement.ts +141 -0
  483. package/src/lib/point-ask/pointer-tracker.ts +34 -0
  484. package/src/lib/point-ask/projector.ts +83 -0
  485. package/src/lib/point-ask/region.test.ts +157 -0
  486. package/src/lib/point-ask/region.ts +136 -0
  487. package/src/lib/point-ask/retry.test.ts +217 -0
  488. package/src/lib/point-ask/retry.ts +37 -0
  489. package/src/lib/point-ask/scene-commit.test.ts +312 -0
  490. package/src/lib/point-ask/scene-commit.ts +32 -0
  491. package/src/lib/point-ask/session.ts +1391 -0
  492. package/src/lib/point-ask/spring-keyframes.test.ts +45 -0
  493. package/src/lib/point-ask/spring-keyframes.ts +38 -0
  494. package/src/lib/point-ask/spring.test.ts +63 -0
  495. package/src/lib/point-ask/spring.ts +107 -0
  496. package/src/lib/point-ask/suggestions.test.ts +80 -0
  497. package/src/lib/point-ask/suggestions.ts +125 -0
  498. package/src/lib/point-ask/target-scope.test.ts +622 -0
  499. package/src/lib/point-ask/target-scope.ts +338 -0
  500. package/src/lib/point-ask/types.ts +48 -0
  501. package/src/lib/portable-export.test.ts +34 -1
  502. package/src/lib/portable-export.ts +119 -53
  503. package/src/lib/print-feature-thickness.ts +10 -1
  504. package/src/lib/print-roof-solids.test.ts +39 -1
  505. package/src/lib/print-roof-solids.ts +43 -10
  506. package/src/lib/print-shell-compiler-manifold-core.ts +1 -1
  507. package/src/lib/print-shell-compiler.ts +1 -0
  508. package/src/lib/registered-draft-snap.ts +12 -0
  509. package/src/lib/roof-duplication.ts +10 -2
  510. package/src/lib/room-assembly-overlay.test.ts +275 -0
  511. package/src/lib/room-assembly-overlay.ts +265 -0
  512. package/src/lib/room-built-on.test.ts +379 -0
  513. package/src/lib/room-built-on.ts +138 -0
  514. package/src/lib/room-construction-commands.ts +712 -0
  515. package/src/lib/room-construction.test.ts +746 -0
  516. package/src/lib/room-construction.ts +385 -0
  517. package/src/lib/room-controls-phase6.test.ts +630 -0
  518. package/src/lib/room-divide-session.ts +523 -0
  519. package/src/lib/room-handle-drag.ts +1068 -0
  520. package/src/lib/room-name-catalog.test.ts +90 -0
  521. package/src/lib/room-name-catalog.ts +168 -0
  522. package/src/lib/room-push-dimensions.test.ts +311 -0
  523. package/src/lib/room-push-dimensions.ts +251 -0
  524. package/src/lib/room-selection-commands.ts +62 -0
  525. package/src/lib/room-selection.test.ts +1017 -0
  526. package/src/lib/room-selection.ts +417 -0
  527. package/src/lib/room-structure-commands.ts +94 -0
  528. package/src/lib/room-structure.test.ts +921 -0
  529. package/src/lib/room-transform-session.ts +570 -0
  530. package/src/lib/room-zone-routing.test.ts +294 -0
  531. package/src/lib/room-zone-routing.ts +197 -0
  532. package/src/lib/scene-clipboard.test.ts +610 -1
  533. package/src/lib/scene-clipboard.ts +269 -58
  534. package/src/lib/scene-material-refs.test.ts +79 -0
  535. package/src/lib/scene-material-refs.ts +79 -0
  536. package/src/lib/scene.test.ts +24 -36
  537. package/src/lib/scene.ts +33 -57
  538. package/src/lib/selection-routing.test.ts +129 -45
  539. package/src/lib/selection-routing.ts +54 -75
  540. package/src/lib/session-writes.test.ts +120 -0
  541. package/src/lib/session-writes.ts +205 -0
  542. package/src/lib/sfx-bus.ts +13 -0
  543. package/src/lib/sfx-player.test.ts +70 -9
  544. package/src/lib/sfx-player.ts +6 -0
  545. package/src/lib/sidebar-panel.ts +62 -0
  546. package/src/lib/site-boundary.test.ts +4 -6
  547. package/src/lib/site-boundary.ts +1 -1
  548. package/src/lib/snapping-mode.test.ts +4 -0
  549. package/src/lib/snapping-mode.ts +8 -1
  550. package/src/lib/stair-levels.test.ts +25 -0
  551. package/src/lib/stair-levels.ts +22 -3
  552. package/src/lib/terrace-draft.test.ts +145 -0
  553. package/src/lib/terrace-draft.ts +214 -0
  554. package/src/lib/tool-cursor-icon.test.ts +16 -0
  555. package/src/lib/tool-cursor-icon.ts +11 -0
  556. package/src/lib/typing-target.ts +9 -0
  557. package/src/lib/units.ts +77 -39
  558. package/src/lib/vector-edges.test.ts +58 -0
  559. package/src/lib/vector-edges.ts +400 -0
  560. package/src/lib/viewer-selection.test.ts +577 -0
  561. package/src/lib/viewer-selection.ts +580 -0
  562. package/src/lib/wall-draw-variant.test.ts +71 -0
  563. package/src/lib/wall-draw-variant.ts +91 -0
  564. package/src/lib/wall-paint-region-session.ts +246 -0
  565. package/src/lib/wall-paint-region.test.ts +373 -0
  566. package/src/lib/wall-placement-pointer.test.ts +42 -0
  567. package/src/lib/wall-placement-pointer.ts +57 -0
  568. package/src/lib/wall-polygon-draft.test.ts +262 -0
  569. package/src/lib/wall-polygon-draft.ts +286 -0
  570. package/src/lib/wall-push.test.ts +453 -0
  571. package/src/lib/wall-region-face.ts +352 -0
  572. package/src/lib/wall-region-handles.test.ts +304 -0
  573. package/src/lib/wall-region-handles.ts +368 -0
  574. package/src/lib/wall-region-list.test.ts +119 -0
  575. package/src/lib/wall-region-list.ts +136 -0
  576. package/src/lib/wall-region-snap.ts +110 -0
  577. package/src/lib/window-changes.ts +35 -0
  578. package/src/lib/window-interaction.ts +14 -0
  579. package/src/lib/zone-content.ts +4 -1
  580. package/src/lib/zone-name.test.ts +17 -0
  581. package/src/lib/zone-name.ts +17 -0
  582. package/src/store/opens-in-select-mode.test.ts +223 -0
  583. package/src/store/paint-mode.test.ts +188 -0
  584. package/src/store/terrain-sculpt-mode.test.ts +19 -21
  585. package/src/store/tool-mode.test.ts +137 -6
  586. package/src/store/use-audio.test.ts +146 -0
  587. package/src/store/use-audio.tsx +127 -3
  588. package/src/store/use-construction-reveal.test.ts +173 -0
  589. package/src/store/use-construction-reveal.ts +145 -0
  590. package/src/store/use-corner-snap-hint.test.ts +24 -0
  591. package/src/store/use-corner-snap-hint.ts +47 -0
  592. package/src/store/use-delete-confirmation.ts +28 -1
  593. package/src/store/use-drawing-view.test.ts +24 -3
  594. package/src/store/use-drawing-view.ts +29 -1
  595. package/src/store/use-editor.tsx +432 -321
  596. package/src/store/use-floorplan-draft-preview.ts +13 -0
  597. package/src/store/use-floorplan-marquee.ts +12 -2
  598. package/src/store/use-follow-pascal.test.ts +62 -0
  599. package/src/store/use-follow-pascal.ts +53 -0
  600. package/src/store/use-point-ask.ts +247 -0
  601. package/src/store/use-quick-measurement-hud.ts +3 -3
  602. package/src/store/use-stair-build-preview.ts +33 -5
  603. package/src/store/use-wall-move-ghosts.ts +4 -2
  604. package/src/store/use-wall-region-handles-selection.test.ts +222 -0
  605. package/src/store/use-wall-region-handles-selection.ts +139 -0
  606. package/src/store/view-layout.test.ts +201 -0
  607. package/src/store/view-layout.ts +199 -0
  608. package/src/test-utils/immediate-animation-frames.ts +16 -0
  609. package/src/test-utils/live-gesture-round-trip.ts +224 -0
  610. package/src/test-utils/render-current-markup.tsx +16 -0
  611. package/src/test-utils/selection-harness.ts +82 -0
  612. package/src/components/editor-2d/renderers/floorplan-stair-layer.tsx +0 -499
  613. package/src/components/systems/zone/zone-label-editor-system.tsx +0 -333
  614. package/src/components/tools/fence/fence-drafting.test.ts +0 -100
  615. package/src/components/tools/fence/fence-drafting.ts +0 -266
  616. package/src/components/tools/stair/stair-click-guard.test.ts +0 -58
  617. package/src/components/tools/stair/stair-click-guard.ts +0 -72
  618. package/src/components/tools/stair/stair-defaults.ts +0 -18
  619. package/src/components/tools/stair/stair-tool.tsx +0 -634
  620. package/src/components/ui/sidebar/panels/plugins-panel.tsx +0 -218
  621. package/src/components/viewer/viewer-units-panel.tsx +0 -116
  622. package/src/lib/floorplan/stairs.ts +0 -489
  623. package/src/lib/level-duplication.test.ts +0 -144
  624. package/src/lib/level-duplication.ts +0 -195
@@ -0,0 +1,622 @@
1
+ import { afterEach, beforeEach, describe, expect, test } from 'bun:test'
2
+ import {
3
+ type AnyNode,
4
+ BlockNode,
5
+ BuildingNode,
6
+ ColumnNode,
7
+ createBoxBlockTopology,
8
+ DoorNode,
9
+ getBlockFaceFrame,
10
+ getFloorPlacedFootprints,
11
+ getScaledDimensions,
12
+ getWallCurveFrameAt,
13
+ getWallCurveLength,
14
+ ImportedMeshNode,
15
+ ItemNode,
16
+ LevelNode,
17
+ nodeRegistry,
18
+ registerNode,
19
+ SeparatorNode,
20
+ SiteNode,
21
+ SlabNode,
22
+ WallNode,
23
+ ZoneNode,
24
+ } from '@pascal-app/core'
25
+ import { nodeLevelFrame } from '@pascal-app/core/procedural-items'
26
+ import { z } from 'zod'
27
+ import { pointTargetScope } from './target-scope'
28
+
29
+ const rectangle = (x = 0, z = 0, width = 4, depth = 4): [number, number][] => [
30
+ [x, z],
31
+ [x + width, z],
32
+ [x + width, z + depth],
33
+ [x, z + depth],
34
+ ]
35
+
36
+ function scene() {
37
+ const nodes: Record<string, AnyNode> = {}
38
+ const add = <T extends AnyNode>(node: T): T => {
39
+ nodes[node.id] = node
40
+ const parent = node.parentId ? nodes[node.parentId] : undefined
41
+ const children: string[] | undefined =
42
+ parent && 'children' in parent ? parent.children : undefined
43
+ if (children && !children.includes(node.id)) children.push(node.id)
44
+ return node
45
+ }
46
+ const site = add(SiteNode.parse({}))
47
+ const building = add(BuildingNode.parse({ parentId: site.id }))
48
+ const level = add(LevelNode.parse({ parentId: building.id }))
49
+ const upstairs = add(LevelNode.parse({ parentId: building.id, level: 1 }))
50
+ const room = add(
51
+ ZoneNode.parse({
52
+ parentId: level.id,
53
+ name: 'Kitchen',
54
+ polygon: rectangle(),
55
+ spaceRole: 'room',
56
+ }),
57
+ )
58
+ const item = (position: [number, number, number], parentId: string = level.id) =>
59
+ add(
60
+ ItemNode.parse({
61
+ parentId,
62
+ position,
63
+ asset: {
64
+ id: 'fixture',
65
+ name: 'Chair',
66
+ category: 'furniture',
67
+ thumbnail: '',
68
+ src: 'https://example.invalid/chair.glb',
69
+ dimensions: [1, 1, 1],
70
+ },
71
+ }),
72
+ )
73
+ const scope = (before = nodes, current = nodes, targets = [room.id]) =>
74
+ pointTargetScope(targets, before, current)
75
+ return { nodes, add, site, building, level, upstairs, room, item, scope }
76
+ }
77
+
78
+ function expectLevelPosition(
79
+ node: AnyNode,
80
+ nodes: Record<string, AnyNode>,
81
+ expected: [number, number, number],
82
+ ) {
83
+ const position = nodeLevelFrame(node.id, nodes).position
84
+ for (let axis = 0; axis < 3; axis++) expect(position[axis]).toBeCloseTo(expected[axis]!, 8)
85
+ }
86
+
87
+ describe('room membership uses hosting frames, not model frames', () => {
88
+ let restoreRegistry = () => {}
89
+ beforeEach(() => {
90
+ restoreRegistry = nodeRegistry._snapshot()
91
+ nodeRegistry._reset()
92
+ // Headless public registry definition: the real schema and scaled-footprint
93
+ // helper, without importing the host-only nodes plugin into the editor.
94
+ registerNode({
95
+ kind: 'item',
96
+ schemaVersion: 1,
97
+ schema: ItemNode,
98
+ category: 'furnish',
99
+ defaults: () => ({}),
100
+ capabilities: {
101
+ floorPlaced: {
102
+ applies: (node) => node.type === 'item' && !node.asset.attachTo,
103
+ footprint: (node) => {
104
+ if (node.type !== 'item') throw new Error('Expected an item footprint')
105
+ return { dimensions: getScaledDimensions(node), rotation: node.rotation }
106
+ },
107
+ },
108
+ },
109
+ })
110
+ })
111
+ afterEach(() => restoreRegistry())
112
+
113
+ // Analytic oracles: room 0..4, host x=6; child x=-4 is inside at 2,
114
+ // child x=-1.5 is outside at 4.5. Scale belongs to the mesh, not this sum.
115
+ for (const scale of [
116
+ [2, 3, 0.5],
117
+ [0.5, 2, 3],
118
+ ] satisfies [number, number, number][]) {
119
+ test(`item mesh scale ${scale.join('/')} neither drops inside children nor admits outside ones`, () => {
120
+ const s = scene()
121
+ const host = s.item([6, 0, 2])
122
+ host.scale = scale
123
+ const inside = s.item([-4, 1, 0], host.id)
124
+ const outside = s.item([-1.5, 1, 0], host.id)
125
+ const before = structuredClone(s.nodes)
126
+
127
+ expectLevelPosition(inside, s.nodes, [2, 1, 2])
128
+ expectLevelPosition(outside, s.nodes, [4.5, 1, 2])
129
+ const scope = s.scope()
130
+ expect(scope.has(inside.id)).toBe(true)
131
+ expect(scope.has(outside.id)).toBe(false)
132
+ expect(scope.has(host.id)).toBe(false)
133
+ expect(s.nodes).toEqual(before)
134
+ })
135
+ }
136
+
137
+ test('a rotated item host turns metre offsets without stretching them', () => {
138
+ const s = scene()
139
+ const host = s.item([6, 0, 2])
140
+ host.rotation = [0, Math.PI / 2, 0]
141
+ host.scale = [0.5, 3, 2]
142
+ const inside = s.item([0, 1, -4], host.id)
143
+ const outside = s.item([0, 1, -1.5], host.id)
144
+
145
+ expectLevelPosition(inside, s.nodes, [2, 1, 2])
146
+ expectLevelPosition(outside, s.nodes, [4.5, 1, 2])
147
+ const scope = s.scope()
148
+ expect(scope.has(inside.id)).toBe(true)
149
+ expect(scope.has(outside.id)).toBe(false)
150
+ expect(scope.has(host.id)).toBe(false)
151
+ })
152
+
153
+ test('nested rotated hosts preserve child coordinates while its own footprint still scales', () => {
154
+ const s = scene()
155
+ const outer = s.item([10, 0, 2])
156
+ outer.rotation = [0, Math.PI / 2, 0]
157
+ outer.scale = [5, 2, 0.5]
158
+ const inner = s.item([0, 1, -4], outer.id)
159
+ inner.rotation = [0, -Math.PI / 2, 0]
160
+ inner.scale = [2, 3, 4]
161
+ const inside = s.item([-4, 1, 0], inner.id)
162
+ inside.asset.dimensions = [2, 1, 3]
163
+ inside.scale = [3, 2, 4]
164
+ const outside = s.item([-1.5, 1, 0], inner.id)
165
+
166
+ expectLevelPosition(inner, s.nodes, [6, 1, 2])
167
+ expectLevelPosition(inside, s.nodes, [2, 2, 2])
168
+ expectLevelPosition(outside, s.nodes, [4.5, 2, 2])
169
+ const footprint = nodeRegistry.get('item')?.capabilities.floorPlaced
170
+ if (!footprint) throw new Error('Missing registered item footprint')
171
+ expect(getFloorPlacedFootprints(footprint, inside, { nodes: s.nodes })[0]?.dimensions).toEqual([
172
+ 6, 2, 12,
173
+ ])
174
+ const scope = s.scope()
175
+ expect(scope.has(inside.id)).toBe(true)
176
+ for (const node of [outer, inner, outside]) expect(scope.has(node.id)).toBe(false)
177
+ })
178
+
179
+ for (const change of ['moved', 'deleted', 'reparented'] as const) {
180
+ test(`a ${change} child of a scaled host retains before membership without acquiring outside descendants`, () => {
181
+ const s = scene()
182
+ const host = s.item([6, 0, 2])
183
+ host.scale = [2, 3, 4]
184
+ const member = s.item([-4, 1, 0], host.id)
185
+ const incoming = s.item([-1.5, 1, 0], host.id)
186
+ const before = structuredClone(s.nodes)
187
+ incoming.position = [-3, 1, 0]
188
+ if (change === 'moved') member.position = [4, 1, 0]
189
+ else {
190
+ host.children = host.children.filter((id) => id !== member.id)
191
+ if (change === 'deleted') delete s.nodes[member.id]
192
+ else {
193
+ member.parentId = s.upstairs.id
194
+ s.upstairs.children.push(member.id)
195
+ }
196
+ }
197
+ const outsideChild = s.item([0, 1, 0], change === 'deleted' ? host.id : member.id)
198
+
199
+ expect(s.scope(before, before).has(member.id)).toBe(true)
200
+ expect(s.scope().has(member.id)).toBe(false)
201
+ const scope = s.scope(before)
202
+ expect(scope.has(member.id)).toBe(true)
203
+ expect(scope.has(incoming.id)).toBe(true)
204
+ expect(scope.has(outsideChild.id)).toBe(false)
205
+ expect(scope.has(host.id)).toBe(false)
206
+ })
207
+ }
208
+
209
+ // A 4 x 2.4 x 4 box has its back face at z=2, right at x=2 and
210
+ // top at y=2.4. Face UVs are not level XZ. Fixed expected points below
211
+ // come from these planes and quarter-turns, never from Point's transform.
212
+ const placements: {
213
+ name: string
214
+ faceId: string
215
+ hostPosition: [number, number, number]
216
+ hostRotation: number
217
+ position: [number, number, number]
218
+ expected: [number, number, number]
219
+ wrongPlan: [number, number]
220
+ nested?: boolean
221
+ }[] = [
222
+ {
223
+ name: 'offset back face',
224
+ faceId: 'f-back',
225
+ hostPosition: [2, 0, 0],
226
+ hostRotation: 0,
227
+ position: [1, 0.3, 0.2],
228
+ expected: [3, 1.5, 2.2],
229
+ wrongPlan: [3, 0.2],
230
+ },
231
+ {
232
+ name: 'rotated right face',
233
+ faceId: 'f-right',
234
+ hostPosition: [5, 0, 3],
235
+ hostRotation: Math.PI / 2,
236
+ position: [1, -0.2, 0.4],
237
+ expected: [4, 1, 0.6],
238
+ wrongPlan: [5.4, 2],
239
+ },
240
+ {
241
+ name: 'top face',
242
+ faceId: 'f-top',
243
+ hostPosition: [2, 0, 3],
244
+ hostRotation: 0,
245
+ position: [0.75, 1, 0.2],
246
+ expected: [2.75, 2.6, 2],
247
+ wrongPlan: [2.75, 3.2],
248
+ },
249
+ {
250
+ name: 'nested rotated back face',
251
+ faceId: 'f-back',
252
+ hostPosition: [0, 1, -4],
253
+ hostRotation: Math.PI / 2,
254
+ position: [0.75, 0.2, 0.3],
255
+ expected: [5.25, 2.4, 3.7],
256
+ wrongPlan: [5.25, 5.7],
257
+ nested: true,
258
+ },
259
+ ]
260
+ for (const placement of placements) {
261
+ test(`${placement.name} includes the attachment's room, not its naive planar projection`, () => {
262
+ const s = scene()
263
+ const parent = placement.nested ? s.item([10, 0, 6]) : s.level
264
+ if (parent.type === 'item') {
265
+ parent.rotation = [0, Math.PI / 2, 0]
266
+ parent.scale = [2, 3, 4]
267
+ }
268
+ const block = s.add(
269
+ BlockNode.parse({
270
+ parentId: parent.id,
271
+ position: placement.hostPosition,
272
+ rotation: placement.hostRotation,
273
+ topology: createBoxBlockTopology(4, 2.4, 4),
274
+ }),
275
+ )
276
+ const face = getBlockFaceFrame(block.topology, placement.faceId)
277
+ expect(face).not.toBeNull()
278
+ const attached = s.item(placement.position, block.id)
279
+ attached.blockFaceId = placement.faceId
280
+ if (placement.faceId === 'f-top') attached.rotation = [Math.PI / 2, 0, 0]
281
+ else attached.asset.attachTo = 'wall'
282
+ const [x, , z] = placement.expected
283
+ s.room.polygon = rectangle(x - 0.25, z - 0.25, 0.5, 0.5)
284
+ const wrongRoom = s.add(
285
+ ZoneNode.parse({
286
+ parentId: s.level.id,
287
+ name: 'Wrong planar projection',
288
+ polygon: rectangle(
289
+ placement.wrongPlan[0] - 0.25,
290
+ placement.wrongPlan[1] - 0.25,
291
+ 0.5,
292
+ 0.5,
293
+ ),
294
+ }),
295
+ )
296
+
297
+ expectLevelPosition(attached, s.nodes, placement.expected)
298
+ const scope = s.scope()
299
+ expect(scope.has(attached.id)).toBe(true)
300
+ expect(scope.has(block.id)).toBe(false)
301
+ expect(scope.has(parent.id)).toBe(false)
302
+ const wrongScope = s.scope(s.nodes, s.nodes, [wrongRoom.id])
303
+ expect(wrongScope.has(block.id)).toBe(false)
304
+ expect(wrongScope.has(attached.id)).toBe(false)
305
+ })
306
+ }
307
+
308
+ test('descendants use the rotated block attachment frame even when the attachment itself is outside', () => {
309
+ const s = scene()
310
+ const block = s.add(
311
+ BlockNode.parse({
312
+ parentId: s.level.id,
313
+ position: [2, 0, 0],
314
+ topology: createBoxBlockTopology(4, 2.4, 4),
315
+ }),
316
+ )
317
+ const attached = s.item([1, 0.3, 0.2], block.id)
318
+ attached.blockFaceId = 'f-back'
319
+ attached.asset.attachTo = 'wall'
320
+ attached.rotation = [0, Math.PI / 2, 0]
321
+ attached.scale = [2, 3, 4]
322
+ const child = s.item([0, 1, -2], attached.id)
323
+ s.room.polygon = rectangle(0.75, 1.95, 0.5, 0.5)
324
+
325
+ expectLevelPosition(attached, s.nodes, [3, 1.5, 2.2])
326
+ expectLevelPosition(child, s.nodes, [1, 2.5, 2.2])
327
+ const scope = s.scope()
328
+ expect(scope.has(child.id)).toBe(true)
329
+ expect(scope.has(attached.id)).toBe(false)
330
+ expect(scope.has(block.id)).toBe(false)
331
+ })
332
+
333
+ test('a moved block attachment stays in the before/current union, not its new outside sibling', () => {
334
+ const s = scene()
335
+ const block = s.add(
336
+ BlockNode.parse({
337
+ parentId: s.level.id,
338
+ position: [2, 0, 0],
339
+ topology: createBoxBlockTopology(4, 2.4, 4),
340
+ }),
341
+ )
342
+ const attached = s.item([1, 0.3, 0.2], block.id)
343
+ attached.blockFaceId = 'f-back'
344
+ s.room.polygon = rectangle(2.75, 1.95, 0.5, 0.5)
345
+ const before = structuredClone(s.nodes)
346
+ block.position = [12, 0, 0]
347
+ const outside = s.item([1, 0.3, 0.2], block.id)
348
+ outside.blockFaceId = 'f-back'
349
+
350
+ expect(s.scope(before, before).has(attached.id)).toBe(true)
351
+ expect(s.scope().has(attached.id)).toBe(false)
352
+ const scope = s.scope(before)
353
+ expect(scope.has(attached.id)).toBe(true)
354
+ expect(scope.has(outside.id)).toBe(false)
355
+ expect(scope.has(block.id)).toBe(false)
356
+ })
357
+ })
358
+
359
+ describe('a pointed room includes spatial siblings without including its whole level', () => {
360
+ test('includes furnishing, columns, captured meshes and polygon centres, not ancestors or another room', () => {
361
+ const s = scene()
362
+ const fridge = s.item([2, 0, 2])
363
+ const column = s.add(ColumnNode.parse({ parentId: s.level.id, position: [1, 0, 1] }))
364
+ const mesh = s.add(ImportedMeshNode.parse({ parentId: s.level.id, position: [3, 0, 3] }))
365
+ const slab = s.add(SlabNode.parse({ parentId: s.level.id, polygon: rectangle(1, 1, 2, 2) }))
366
+ const outside = s.item([8, 0, 2])
367
+ const upper = s.item([2, 0, 2], s.upstairs.id)
368
+ const otherRoom = s.add(
369
+ ZoneNode.parse({ parentId: s.level.id, name: 'Overlay', polygon: rectangle() }),
370
+ )
371
+ const before = structuredClone(s.nodes)
372
+
373
+ const scope = s.scope()
374
+
375
+ for (const node of [s.room, fridge, column, mesh, slab]) expect(scope.has(node.id)).toBe(true)
376
+ for (const node of [outside, upper, otherRoom, s.level, s.upstairs, s.building, s.site])
377
+ expect(scope.has(node.id)).toBe(false)
378
+ expect(s.nodes).toEqual(before)
379
+ })
380
+
381
+ test('includes boundary rims, excludes hole interiors', () => {
382
+ const s = scene()
383
+ s.room.holes = [rectangle(1, 1, 2, 2)]
384
+ const hole = s.item([2, 0, 2])
385
+ const holeRim = s.item([1, 0, 2])
386
+ const outerRim = s.item([0, 0, 2])
387
+
388
+ const scope = s.scope()
389
+
390
+ expect(scope.has(hole.id)).toBe(false)
391
+ expect(scope.has(holeRim.id)).toBe(true)
392
+ expect(scope.has(outerRim.id)).toBe(true)
393
+ })
394
+
395
+ test('uses declared custom footprints rather than the node origin, with the snapshot context', () => {
396
+ const s = scene()
397
+ const restore = nodeRegistry._snapshot()
398
+ const schema = ItemNode.extend({ type: z.literal('test:point-footprint') })
399
+ let applies = true
400
+ let calls = 0
401
+ try {
402
+ registerNode({
403
+ kind: 'test:point-footprint',
404
+ schemaVersion: 1,
405
+ schema,
406
+ category: 'furnish',
407
+ defaults: () => ({}),
408
+ capabilities: {
409
+ floorPlaced: {
410
+ applies: () => applies,
411
+ footprint: (_node, context) => {
412
+ calls += 1
413
+ expect(context?.nodes).toBe(s.nodes)
414
+ return { dimensions: [1, 1, 1], rotation: [0, 0, 0], position: [2, 0, 2] }
415
+ },
416
+ },
417
+ },
418
+ })
419
+ // Registered extension kinds are not represented in core's static builtin union.
420
+ const custom = s.add(
421
+ schema.parse({
422
+ ...s.item([8, 0, 8]),
423
+ id: 'item_custom_scope',
424
+ type: 'test:point-footprint',
425
+ }) as unknown as AnyNode,
426
+ )
427
+ expect(s.scope().has(custom.id)).toBe(true)
428
+ const resolved = calls
429
+ applies = false
430
+ expect(s.scope().has(custom.id)).toBe(false)
431
+ expect(calls).toBe(resolved)
432
+ } finally {
433
+ restore()
434
+ }
435
+ })
436
+
437
+ test('keeps descendants of a scoped member even when their own centre is outside', () => {
438
+ const s = scene()
439
+ const table = s.item([2, 0, 2])
440
+ const child = s.item([20, 1, 20], table.id)
441
+ const nested = s.item([20, 1, 20], child.id)
442
+ expect(s.scope().has(nested.id)).toBe(true)
443
+ })
444
+
445
+ test('composes nested local position and rotation when the parent centre is outside', () => {
446
+ const s = scene()
447
+ const table = s.item([6, 0, 2])
448
+ table.rotation = [0, Math.PI / 2, 0]
449
+ const child = s.item([0, 1, -3], table.id)
450
+
451
+ const scope = s.scope()
452
+
453
+ expect(scope.has(table.id)).toBe(false)
454
+ expect(scope.has(child.id)).toBe(true)
455
+ })
456
+
457
+ test('compares level-local coordinates despite a translated and rotated building', () => {
458
+ const s = scene()
459
+ s.building.position = [100, 0, 100]
460
+ s.building.rotation = [0, Math.PI / 2, 0]
461
+ const item = s.item([2, 0, 2])
462
+ expect(s.scope().has(item.id)).toBe(true)
463
+ })
464
+ })
465
+
466
+ describe('room bounding walls and their hosts', () => {
467
+ test('ignores invalid stored boundary kinds and walls on another level', () => {
468
+ const s = scene()
469
+ const upperWall = s.add(WallNode.parse({ parentId: s.upstairs.id, start: [8, 0], end: [8, 4] }))
470
+ s.room.boundaryWallIds = [s.level.id as never, upperWall.id]
471
+ const upperChild = s.item([2, 1, 0], upperWall.id)
472
+ const outside = s.item([8, 0, 8])
473
+
474
+ const scope = s.scope()
475
+
476
+ for (const node of [s.level, upperWall, upperChild, outside])
477
+ expect(scope.has(node.id)).toBe(false)
478
+ })
479
+
480
+ test('includes stored inset boundaries, explicit wallId-only openings and descendants', () => {
481
+ const s = scene()
482
+ s.room.polygon = rectangle(0.2, 0.2, 3.6, 3.6)
483
+ const wall = s.add(WallNode.parse({ parentId: s.level.id, start: [0, 0], end: [4, 0] }))
484
+ s.room.boundaryWallIds = [wall.id]
485
+ const door = s.add(
486
+ DoorNode.parse({ parentId: s.level.id, wallId: wall.id, position: [2, 1, 0] }),
487
+ )
488
+ const picture = s.item([2, 1, 0], wall.id)
489
+ picture.wallId = wall.id
490
+ const nested = s.item([20, 1, 20], picture.id)
491
+
492
+ const scope = s.scope()
493
+
494
+ for (const node of [wall, door, picture, nested]) expect(scope.has(node.id)).toBe(true)
495
+ })
496
+
497
+ test('infers bounding walls for a hand-drawn inset room without stored associations', () => {
498
+ const s = scene()
499
+ s.room.polygon = rectangle(0.2, 0.2, 3.6, 3.6)
500
+ const polygon = rectangle()
501
+ const walls = polygon.map((start, index) =>
502
+ s.add(
503
+ WallNode.parse({
504
+ parentId: s.level.id,
505
+ start,
506
+ end: polygon[(index + 1) % polygon.length],
507
+ }),
508
+ ),
509
+ )
510
+ const remote = s.add(WallNode.parse({ parentId: s.level.id, start: [10, 0], end: [10, 4] }))
511
+
512
+ const scope = s.scope()
513
+
514
+ for (const wall of walls) expect(scope.has(wall.id)).toBe(true)
515
+ expect(scope.has(remote.id)).toBe(false)
516
+ })
517
+
518
+ test('a party wall belongs to both rooms and separators retain their children', () => {
519
+ const s = scene()
520
+ const neighbor = s.add(
521
+ ZoneNode.parse({ parentId: s.level.id, name: 'Living', polygon: rectangle(4, 0) }),
522
+ )
523
+ const party = s.add(WallNode.parse({ parentId: s.level.id, start: [4, 0], end: [4, 4] }))
524
+ const separator = s.add(
525
+ SeparatorNode.parse({ parentId: s.level.id, start: [0, 0], end: [4, 0] }),
526
+ )
527
+ s.room.boundarySeparatorIds = [separator.id]
528
+ const child = s.item([20, 0, 20], separator.id)
529
+
530
+ expect(s.scope().has(party.id)).toBe(true)
531
+ expect(s.scope(s.nodes, s.nodes, [neighbor.id]).has(party.id)).toBe(true)
532
+ expect(s.scope().has(child.id)).toBe(true)
533
+ })
534
+
535
+ test('does not mistake a remote wall-hosted local station for a room coordinate', () => {
536
+ const s = scene()
537
+ const remote = s.add(WallNode.parse({ parentId: s.level.id, start: [8, 0], end: [8, 4] }))
538
+ const picture = s.item([2, 1, 0], remote.id)
539
+ picture.wallId = remote.id
540
+ expect(s.scope().has(picture.id)).toBe(false)
541
+ })
542
+
543
+ test('uses the curved wall station for a hosted member, not its chord', () => {
544
+ const s = scene()
545
+ const wall = s.add(
546
+ WallNode.parse({ parentId: s.level.id, start: [6, -2], end: [6, 6], curveOffset: 4 }),
547
+ )
548
+ const middle = getWallCurveFrameAt(wall, 0.5).point
549
+ s.room.polygon = rectangle(middle.x - 0.5, middle.y - 0.5, 1, 1)
550
+ const picture = s.item([getWallCurveLength(wall) / 2, 1, 0], wall.id)
551
+ picture.wallId = wall.id
552
+ expect(s.scope().has(picture.id)).toBe(true)
553
+ })
554
+ })
555
+
556
+ describe('membership before or after the write', () => {
557
+ test('retains moved-out members and recognizes moved-in members', () => {
558
+ const s = scene()
559
+ const out = s.item([2, 0, 2])
560
+ const incoming = s.item([8, 0, 2])
561
+ const before = structuredClone(s.nodes)
562
+ out.position = [8, 0, 2]
563
+ incoming.position = [2, 0, 2]
564
+ const scope = s.scope(before)
565
+ expect(scope.has(out.id)).toBe(true)
566
+ expect(scope.has(incoming.id)).toBe(true)
567
+ })
568
+
569
+ test('retains a deleted member and a member reparented to another level', () => {
570
+ const s = scene()
571
+ const deleted = s.item([2, 0, 2])
572
+ const moved = s.item([2, 0, 2])
573
+ const before = structuredClone(s.nodes)
574
+ delete s.nodes[deleted.id]
575
+ moved.parentId = s.upstairs.id
576
+ s.level.children = s.level.children.filter((id) => id !== moved.id && id !== deleted.id)
577
+ s.upstairs.children.push(moved.id)
578
+ const scope = s.scope(before)
579
+ expect(scope.has(deleted.id)).toBe(true)
580
+ expect(scope.has(moved.id)).toBe(true)
581
+ })
582
+
583
+ test('uses each snapshot room footprint and retains a deleted zone', () => {
584
+ const s = scene()
585
+ const oldMember = s.item([2, 0, 2])
586
+ const newMember = s.item([10, 0, 2])
587
+ const before = structuredClone(s.nodes)
588
+ s.room.polygon = rectangle(8, 0)
589
+ expect(s.scope(before).has(oldMember.id)).toBe(true)
590
+ expect(s.scope(before).has(newMember.id)).toBe(true)
591
+ delete s.nodes[s.room.id]
592
+ expect(s.scope(before).has(oldMember.id)).toBe(true)
593
+ })
594
+
595
+ test('does not mix before-only membership with children created outside afterward', () => {
596
+ const s = scene()
597
+ const table = s.item([2, 0, 2])
598
+ const before = structuredClone(s.nodes)
599
+ table.position = [8, 0, 8]
600
+ const outsideChild = s.item([0, 1, 0], table.id)
601
+ const scope = s.scope(before)
602
+ expect(scope.has(table.id)).toBe(true)
603
+ expect(scope.has(outsideChild.id)).toBe(false)
604
+ })
605
+
606
+ test('retains ordinary target ancestry before reparenting and terminates on cycles', () => {
607
+ const s = scene()
608
+ const target = s.item([8, 0, 8])
609
+ const child = s.item([1, 1, 1], target.id)
610
+ const before = structuredClone(s.nodes)
611
+ target.children = []
612
+ child.parentId = s.level.id
613
+ expect(pointTargetScope([target.id], before, s.nodes).has(child.id)).toBe(true)
614
+ target.parentId = child.id
615
+ child.parentId = target.id
616
+ target.children = [child.id]
617
+ child.children = [target.id]
618
+ expect(new Set(pointTargetScope([target.id], s.nodes, s.nodes))).toEqual(
619
+ new Set([target.id, child.id]),
620
+ )
621
+ })
622
+ })