editor: add lean-to roof extensions and automatic drainage

apps/editor/components/build-tab.tsx

@@ -92,6 +92,7 @@ function collectBuildTypes(floorplanMode: FloorplanMode): BuildType[] {
     const extension = getFloorplanNodeExtension(definition)
     if (
       baseKinds.has(kind) ||
+      definition.presentation?.paletteGroup === 'roof-features' ||
       !extension?.tool ||
       !isFloorplanToolAvailableInMode(extension.availableModes, floorplanMode) ||
       !presentation ||
@@ -173,13 +174,12 @@ type RoofFeature = { kind: string; label: string; iconSrc: string }
 const ROOF_FEATURE_FALLBACK_ICON = '/icons/roof.webp'
 
 /**
- * Roof accessories surfaced under the Roof tile (a "Features" group). Unlike
- * the community editor these aren't DB presets — each is a registry kind with
- * `capabilities.roofAccessory`, enumerated from the registry at render time
- * (it is populated by the app bootstrap — a module-scope const would race it)
- * and activated like any structure tool (the kind's tool attaches it to the
- * roof segment under the cursor). Label + icon come from the registry's
- * `presentation`; non-url icons fall back to the roof icon.
+ * Roof accessories and extensions surfaced under the Roof tile. Unlike the
+ * community editor these aren't DB presets — each is a registry kind, either
+ * carrying `capabilities.roofAccessory` or explicitly classified as a roof
+ * extension. They are enumerated at render time because the registry is
+ * populated during app bootstrap. Label + icon come from `presentation`;
+ * non-url icons fall back to the roof icon.
  */
 function activateRoofFeatureTool(kind: string): void {
   const ed = useEditor.getState()
@@ -243,9 +243,15 @@ export function BuildTab() {
   // Read at render time (not module scope): the registry is populated by the
   // app bootstrap, so enumerating earlier would race it and see no kinds.
   const roofFeatures = useMemo<RoofFeature[]>(() => {
+    if (!registryReady) return []
     const features: RoofFeature[] = []
     for (const [kind, def] of nodeRegistry.entries()) {
-      if (def.capabilities.roofAccessory === undefined) continue
+      if (
+        def.capabilities.roofAccessory === undefined &&
+        def.presentation?.paletteGroup !== 'roof-features'
+      ) {
+        continue
+      }
       // Door / window declare `roofAccessory` for the wall-face cut but
       // already have their own Build tiles — listing them here too
       // would duplicate the entry under Roof → Features.
@@ -258,7 +264,7 @@ export function BuildTab() {
       })
     }
     return features
-  }, [])
+  }, [registryReady])
 
   // Tile highlight derives from the single source of truth (the active tool /
   // mode), never a separate local selection — so keyboard shortcuts and panel
@@ -362,7 +368,9 @@ export function BuildTab() {
         (activeTool === 'roof' || isRoofFeatureActive) &&
         roofFeatures.length > 0 ? (
         <div className="flex min-h-0 flex-1 flex-col gap-2 overflow-y-auto">
-          <div className="px-0.5 pt-1 font-medium text-muted-foreground text-xs">Features</div>
+          <div className="px-0.5 pt-1 font-medium text-muted-foreground text-xs">
+            Features & extensions
+          </div>
           <TooltipProvider delayDuration={0} disableHoverableContent>
             <div
               className="grid gap-1.5"

packages/core/src/events/bus.ts

@@ -25,6 +25,7 @@ import type {
   GutterNode,
   HvacEquipmentNode,
   ItemNode,
+  LeanToExtensionNode,
   LevelNode,
   LinesetNode,
   LiquidLineNode,
@@ -98,6 +99,7 @@ export type BuildingEvent = NodeEvent<BuildingNode>
 export type CabinetEvent = NodeEvent<CabinetNode>
 export type CabinetModuleEvent = NodeEvent<CabinetModuleNode>
 export type LevelEvent = NodeEvent<LevelNode>
+export type LeanToExtensionEvent = NodeEvent<LeanToExtensionNode>
 export type ZoneEvent = NodeEvent<ZoneNode>
 export type ShelfEvent = NodeEvent<ShelfNode>
 export type SlabEvent = NodeEvent<SlabNode>
@@ -305,6 +307,7 @@ type EditorEvents = GridEvents &
   NodeEvents<'building', BuildingEvent> &
   NodeEvents<'elevator', ElevatorEvent> &
   NodeEvents<'level', LevelEvent> &
+  NodeEvents<'lean-to-extension', LeanToExtensionEvent> &
   NodeEvents<'zone', ZoneEvent> &
   NodeEvents<'slab', SlabEvent> &
   NodeEvents<'shelf', ShelfEvent> &

packages/core/src/index.ts

@@ -20,6 +20,7 @@ export type {
   GuideEvent,
   GutterEvent,
   ItemEvent,
+  LeanToExtensionEvent,
   LevelEvent,
   MeasurementEvent,
   NodeEvent,

packages/core/src/registry/scene-api.ts

@@ -1,5 +1,9 @@
 import type { AnyNode, AnyNodeId } from '../schema/types'
-import { pauseSceneHistory, resumeSceneHistory } from '../store/history-control'
+import {
+  activeSceneCommitNodeIds,
+  pauseSceneHistory,
+  resumeSceneHistory,
+} from '../store/history-control'
 import {
   type CloneNodesIntoOptions,
   collectSubtree,
@@ -20,10 +24,21 @@ export type SceneStoreLike = {
     dirtyNodes: Set<AnyNodeId>
     createNode: (node: AnyNode, parentId?: AnyNodeId) => void
     createNodes?: (ops: { node: AnyNode; parentId?: AnyNodeId }[]) => void
+    applyNodeChanges?: (changes: {
+      create?: { node: AnyNode; parentId?: AnyNodeId }[]
+      update?: { id: AnyNodeId; data: Partial<AnyNode> }[]
+      delete?: AnyNodeId[]
+    }) => void
     updateNode: (id: AnyNodeId, data: Partial<AnyNode>) => void
     deleteNode: (id: AnyNodeId) => void
     markDirty: (id: AnyNodeId) => void
   }
+  subscribe?: (
+    listener: (
+      state: { nodes: Record<AnyNodeId, AnyNode> },
+      previous: { nodes: Record<AnyNodeId, AnyNode> },
+    ) => void,
+  ) => () => void
   temporal: {
     getState: () => { pause: () => void; resume: () => void }
   }
@@ -71,6 +86,46 @@ export function createSceneApi(store: SceneStoreLike): SceneApi {
       return node.id
     },
 
+    createMany(ops) {
+      for (const op of ops) captureIfNeeded(op.node.id)
+      const batch = store.getState().createNodes
+      if (batch) batch(ops)
+      else for (const op of ops) this.upsert(op.node, op.parentId)
+    },
+
+    applyChanges(changes) {
+      for (const op of changes.create ?? []) captureIfNeeded(op.node.id)
+      for (const op of changes.update ?? []) captureIfNeeded(op.id)
+      for (const id of changes.delete ?? []) captureIfNeeded(id)
+      const batch = store.getState().applyNodeChanges
+      if (batch) {
+        batch(changes)
+        return
+      }
+      for (const op of changes.create ?? []) this.upsert(op.node, op.parentId)
+      for (const op of changes.update ?? []) this.update(op.id, op.data)
+      for (const id of changes.delete ?? []) this.delete(id)
+    },
+
+    subscribeNodes(listener) {
+      return (
+        store.subscribe?.((state, previous) => {
+          if (state.nodes === previous.nodes) return
+          const scopedIds = activeSceneCommitNodeIds()
+          const changedIds = new Set<AnyNodeId>(scopedIds)
+          if (!scopedIds) {
+            for (const id of Object.keys(state.nodes) as AnyNodeId[]) {
+              if (state.nodes[id] !== previous.nodes[id]) changedIds.add(id)
+            }
+            for (const id of Object.keys(previous.nodes) as AnyNodeId[]) {
+              if (!(id in state.nodes)) changedIds.add(id)
+            }
+          }
+          listener(state.nodes, previous.nodes, changedIds)
+        }) ?? (() => {})
+      )
+    },
+
     delete(id) {
       captureIfNeeded(id)
       store.getState().deleteNode(id)

packages/core/src/registry/types.ts

@@ -793,6 +793,8 @@ export type FloorplanAffordance<N> = {
     initialPlanPoint: FloorplanAffordancePoint
     /** Active editor grid step in meters. */
     gridSnapStep: number
+    /** Injected mutation/read seam for kind-owned affordances. */
+    sceneApi?: SceneApi
   }): FloorplanAffordanceSession
 }
 
@@ -875,6 +877,7 @@ export type FloorplanMoveTargetSession = {
 export type FloorplanMoveTarget<N> = (args: {
   node: N
   nodes: Record<AnyNodeId, AnyNode>
+  sceneApi?: SceneApi
 }) => FloorplanMoveTargetSession
 
 // ─── Plugin manifest ─────────────────────────────────────────────────
@@ -1436,6 +1439,8 @@ export type Presentation = {
   icon: IconRef
   /** Tool palette section. Defaults to `category` when omitted. */
   paletteSection?: 'site' | 'structure' | 'furnish'
+  /** Optional presentation-only subgroup used by palette surfaces. */
+  paletteGroup?: string
   /** Sort key within a palette section; lower numbers come first. */
   paletteOrder?: number
   /** Set true for kinds that exist but should NOT appear in the palette
@@ -2216,7 +2221,7 @@ export type ParametricDescriptor<N> = {
    * Direct store/MCP writes bypass it — keep real invariants in
    * `invariants`.
    */
-  derive?: (next: N, patch: Partial<N>) => Partial<N>
+  derive?: (next: N, patch: Partial<N>, previous?: N) => Partial<N>
   /**
    * Cross-node companion to `derive`: after an inspector edit lands on
    * this node, return patches for OTHER nodes that must follow to keep
@@ -2293,6 +2298,7 @@ export type ParamGroup<N> = {
 export type ParamField<N> =
   | {
       key: keyof N
+      label?: string
       kind: 'number'
       unit?: string
       min?: number
@@ -2301,27 +2307,29 @@ export type ParamField<N> =
       visibleIf?: (n: N) => boolean
       customEditor?: ComponentType
     }
-  | { key: keyof N; kind: 'boolean'; visibleIf?: (n: N) => boolean }
+  | { key: keyof N; label?: string; kind: 'boolean'; visibleIf?: (n: N) => boolean }
   | {
       key: keyof N
+      label?: string
       kind: 'enum'
       options: readonly string[]
       /** Defaults to 'select' (dropdown). 'segmented' renders the inline
        *  tabbed switcher — better for short option lists (2-4 items). */
       display?: 'select' | 'segmented'
       visibleIf?: (n: N) => boolean
     }
-  | { key: keyof N; kind: 'vec3'; visibleIf?: (n: N) => boolean }
-  | { key: keyof N; kind: 'color'; visibleIf?: (n: N) => boolean }
-  | { key: keyof N; kind: 'material'; visibleIf?: (n: N) => boolean }
-  | { key: keyof N; kind: 'ref'; refKind: string; visibleIf?: (n: N) => boolean }
+  | { key: keyof N; label?: string; kind: 'vec3'; visibleIf?: (n: N) => boolean }
+  | { key: keyof N; label?: string; kind: 'color'; visibleIf?: (n: N) => boolean }
+  | { key: keyof N; label?: string; kind: 'material'; visibleIf?: (n: N) => boolean }
+  | { key: keyof N; label?: string; kind: 'ref'; refKind: string; visibleIf?: (n: N) => boolean }
   /** Escape hatch for fields that don't map to a single node key —
    *  derived values (`length` from `start`/`end`), sliders with
    *  dynamic min/max (curve sagitta bounded by chord length),
    *  composed editors, etc. The kind owns the rendering and the
    *  update logic. `key` here is just a stable React key/label. */
   | {
       key: string
+      label?: string
       kind: 'custom'
       component: ComponentType<{ node: N; onUpdate: (patch: Partial<N>) => void }>
       visibleIf?: (n: N) => boolean
@@ -2373,6 +2381,19 @@ export type SceneApi = {
   nodes: () => Readonly<Record<AnyNodeId, AnyNode>>
   update: (id: AnyNodeId, patch: Partial<AnyNode>) => void
   upsert: (node: AnyNode, parentId?: AnyNodeId) => AnyNodeId
+  createMany?: (ops: { node: AnyNode; parentId?: AnyNodeId }[]) => void
+  applyChanges?: (changes: {
+    create?: { node: AnyNode; parentId?: AnyNodeId }[]
+    update?: { id: AnyNodeId; data: Partial<AnyNode> }[]
+    delete?: AnyNodeId[]
+  }) => void
+  subscribeNodes?: (
+    listener: (
+      nodes: Readonly<Record<AnyNodeId, AnyNode>>,
+      previous: Readonly<Record<AnyNodeId, AnyNode>>,
+      changedIds: ReadonlySet<AnyNodeId>,
+    ) => void,
+  ) => () => void
   delete: (id: AnyNodeId) => void
   restore: (id: AnyNodeId) => void
   restoreAll: () => void

packages/core/src/schema/index.ts

@@ -33,6 +33,12 @@ export {
   resolveMaterial,
   TextureWrapMode,
 } from './material'
+export {
+  type AutoDownspoutPlacement,
+  type AutomaticDownspoutInput,
+  planAutomaticDownspouts,
+  resolveAutomaticDownspoutLength,
+} from './nodes/automatic-downspout'
 export {
   BlockEdge,
   BlockFace,
@@ -101,7 +107,12 @@ export {
   type DormerSurfaceMaterialSpec,
   getEffectiveDormerSurfaceMaterial,
 } from './nodes/dormer'
-export { DownspoutNode } from './nodes/downspout'
+export {
+  DownspoutNode,
+  defaultDownspoutMetadata,
+  isDefaultDownspoutNode,
+  usesAutomaticDownspoutLength,
+} from './nodes/downspout'
 export { DuctFittingNode } from './nodes/duct-fitting'
 export { DuctSegmentNode } from './nodes/duct-segment'
 export { DuctTerminalNode } from './nodes/duct-terminal'
@@ -114,7 +125,22 @@ export {
 export { EyebrowVentNode } from './nodes/eyebrow-vent'
 export { FenceBaseStyle, FenceNode, FenceStyle } from './nodes/fence'
 export { GuideNode, GuideScaleReference } from './nodes/guide'
-export { GutterNode, GutterOutlet } from './nodes/gutter'
+export {
+  computeGutterEaveY,
+  createDefaultGuttersForSegment,
+  GUTTER_EAVE_TUCK_INWARD,
+  GUTTER_EAVE_TUCK_UP,
+  type GutterEaveSide,
+  type GutterEdgeExclusion,
+  GutterNode,
+  GutterOutlet,
+  type GutterRun,
+  getDefaultGutterSide,
+  getGutterRunsForSegment,
+  hasAutoGutterMetadata,
+  isAutoGutterEnabled,
+  isDefaultGutterNode,
+} from './nodes/gutter'
 export { HvacEquipmentNode } from './nodes/hvac-equipment'
 export type {
   AnimationEffect,
@@ -134,6 +160,13 @@ export {
   isLowProfileItemSurface,
   LOW_PROFILE_ITEM_SURFACE_MAX_HEIGHT,
 } from './nodes/item'
+export {
+  LeanToConnectionMode,
+  LeanToEndCondition,
+  LeanToExtensionNode,
+  LeanToResizeLock,
+  LeanToRoofEdge,
+} from './nodes/lean-to-extension'
 export { LevelNode } from './nodes/level'
 export { LinesetNode } from './nodes/lineset'
 export { LiquidLineNode } from './nodes/liquid-line'
@@ -182,6 +215,7 @@ export {
   getRoofSegmentVisibleTopBounds,
   getSegmentSlopeFrame,
   hasSegmentMaterialOverride,
+  isBandedShedSegment,
   MIN_ROOF_SEGMENT_TRIM_SPAN,
   normalizeRoofSegmentTrim,
   ROOF_SHAPE_DEFAULTS,