editor: add lean-to roof extensions and automatic drainage

apps/editor/components/build-tab.tsx

@@ -13,7 +13,7 @@ import {
 } from '@pascal-app/editor'
 import { useLiquidLineToolOptions } from '@pascal-app/nodes'
 import Image from 'next/image'
-import { useCallback, useEffect, useMemo, useRef } from 'react'
+import { useCallback, useEffect, useMemo, useRef, useState } from 'react'
 import {
   Tooltip,
   TooltipContent,
@@ -90,6 +90,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 ||
@@ -171,13 +172,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()
@@ -209,7 +209,15 @@ export function BuildTab() {
   const floorplanMode = useFloorplanMode((s) => s.mode)
   const follow = useLiquidLineToolOptions((s) => s.follow)
   const toggleFollow = useLiquidLineToolOptions((s) => s.toggleFollow)
-  const buildTypes = useMemo(() => collectBuildTypes(floorplanMode), [floorplanMode])
+  const [registryReady, setRegistryReady] = useState(false)
+  const buildTypes = useMemo(
+    () => (registryReady ? collectBuildTypes(floorplanMode) : BASE_BUILD_TYPES),
+    [floorplanMode, registryReady],
+  )
+
+  useEffect(() => {
+    setRegistryReady(true)
+  }, [])
 
   // The fitting / follow tools are armed from a segment's panel, not a grid
   // tile — keep the segment tile lit so the panel (and the way back) stays
@@ -233,9 +241,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.
@@ -248,7 +262,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
@@ -352,7 +366,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

@@ -24,6 +24,7 @@ import type {
   GutterNode,
   HvacEquipmentNode,
   ItemNode,
+  LeanToExtensionNode,
   LevelNode,
   LinesetNode,
   LiquidLineNode,
@@ -97,6 +98,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>
@@ -298,6 +300,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

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

packages/core/src/registry/index.ts

@@ -149,6 +149,7 @@ export type {
   SurfaceRole,
   SurfacesConfig,
   SystemContribution,
+  ToolContributionProps,
   ToolHint,
   ToolHintChip,
   Vec2,

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

@@ -792,6 +792,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
 }
 
@@ -874,6 +876,7 @@ export type FloorplanMoveTargetSession = {
 export type FloorplanMoveTarget<N> = (args: {
   node: N
   nodes: Record<AnyNodeId, AnyNode>
+  sceneApi?: SceneApi
 }) => FloorplanMoveTargetSession
 
 // ─── Plugin manifest ─────────────────────────────────────────────────
@@ -1246,7 +1249,7 @@ export type NodeDefinition<S extends ZodObject<any>> = {
    */
   ports?: (node: z.infer<S>) => NodePort[]
   system?: SystemContribution
-  tool?: LazyComponent
+  tool?: ToolLazyComponent
   /**
    * Stage-D drag-affordance components — one per kind-owned editor mode
    * triggered by `useEditor` state. Component receives `{ node }` as its
@@ -1399,6 +1402,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
@@ -1424,6 +1429,12 @@ export type IconRef =
    * boundary per icon. */
   | { kind: 'component'; module: () => Promise<{ default: ComponentType }> }
 
+export type ToolContributionProps = {
+  sceneApi: SceneApi
+  activeLevelId: AnyNodeId | null
+  selectNode: (nodeId: AnyNodeId) => void
+}
+export type ToolLazyComponent = () => Promise<{ default: ComponentType<ToolContributionProps> }>
 export type LazyComponent = () => Promise<{ default: ComponentType }>
 
 export type RendererSource<N> =
@@ -2134,7 +2145,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
@@ -2291,6 +2302,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 { BoxVentNode } from './nodes/box-vent'
 export { BuildingNode } from './nodes/building'
 export { CabinetModuleNode, CabinetNode } from './nodes/cabinet'
@@ -86,7 +92,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'
@@ -99,7 +110,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,
@@ -119,6 +145,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'