nodes: add modular cabinet workflows

apps/editor/lib/bootstrap.ts

@@ -1,10 +1,10 @@
 import {
   type AnyNodeDefinition,
   discoverPlugins,
+  extendPluginDiscovery,
   loadPlugin,
   nodeRegistry,
   registerNode,
-  setPluginDiscovery,
 } from '@pascal-app/core'
 import { builtinPlugin } from '@pascal-app/nodes'
 import { treesPlugin } from '@pascal-app/plugin-trees'
@@ -80,9 +80,8 @@ export async function loadExternalPlugins(): Promise<void> {
 }
 
 // Register the first-party example plugin (trees node + presets rail panel)
-// through the same discovery hook a third-party pack would use. Must be set
-// before `loadExternalPlugins()` reads it below.
-setPluginDiscovery(async () => [treesPlugin])
+// alongside any host-provided discovery source instead of replacing it.
+extendPluginDiscovery(async () => [treesPlugin])
 
 loadBuiltinsSync()
 void loadExternalPlugins()

apps/editor/package.json

@@ -4,7 +4,7 @@
   "type": "module",
   "private": true,
   "scripts": {
-    "dev": "dotenv -e ../../.env.local -- next dev --port 3002",
+    "dev": "dotenv -e ../../.env.local -- next dev --port ${PORT:-3002}",
     "build": "dotenv -e ../../.env.local -- next build",
     "start": "next start",
     "lint": "biome lint",

apps/ifc-converter/next-env.d.ts

@@ -1,6 +1,6 @@
 /// <reference types="next" />
 /// <reference types="next/image-types/global" />
-import "./.next/dev/types/routes.d.ts";
+import "./.next/types/routes.d.ts";
 
 // NOTE: This file should not be edited
 // see https://nextjs.org/docs/app/api-reference/config/typescript for more information.

packages/core/src/events/bus.ts

@@ -4,6 +4,8 @@ import type { Object3D } from 'three'
 import type {
   BoxVentNode,
   BuildingNode,
+  CabinetModuleNode,
+  CabinetNode,
   CeilingNode,
   ChimneyNode,
   ColumnNode,
@@ -89,6 +91,8 @@ export type FenceEvent = NodeEvent<FenceNode>
 export type ItemEvent = NodeEvent<ItemNode>
 export type SiteEvent = NodeEvent<SiteNode>
 export type BuildingEvent = NodeEvent<BuildingNode>
+export type CabinetEvent = NodeEvent<CabinetNode>
+export type CabinetModuleEvent = NodeEvent<CabinetModuleNode>
 export type LevelEvent = NodeEvent<LevelNode>
 export type ZoneEvent = NodeEvent<ZoneNode>
 export type ShelfEvent = NodeEvent<ShelfNode>
@@ -246,9 +250,20 @@ type RoomPresetEvents = {
   'room-preset:create': RoomPresetCreateEvent
 }
 
+type SelectionEvents = {
+  /**
+   * "Reveal this node" intent — the editor's node action menu emits it with the
+   * selected node; whoever owns the node's catalog/panel (host browser, a
+   * plugin's presets panel) listens and reveals it.
+   */
+  'selection:find-node': AnyNode
+}
+
 type EditorEvents = GridEvents &
   NodeEvents<'wall', WallEvent> &
   NodeEvents<'fence', FenceEvent> &
+  NodeEvents<'cabinet', CabinetEvent> &
+  NodeEvents<'cabinet-module', CabinetModuleEvent> &
   NodeEvents<'item', ItemEvent> &
   NodeEvents<'site', SiteEvent> &
   NodeEvents<'building', BuildingEvent> &
@@ -296,6 +311,7 @@ type EditorEvents = GridEvents &
   ThumbnailEvents &
   SnapshotEvents &
   AIChatEvents &
-  RoomPresetEvents
+  RoomPresetEvents &
+  SelectionEvents
 
 export const emitter = mitt<EditorEvents>()

packages/core/src/index.ts

@@ -1,6 +1,8 @@
 export type {
   BoxVentEvent,
   BuildingEvent,
+  CabinetEvent,
+  CabinetModuleEvent,
   CameraControlEvent,
   CameraControlFitSceneEvent,
   CeilingEvent,
@@ -73,6 +75,7 @@ export {
   segmentsIntersect,
 } from './lib/polygon-relations'
 export { getRenderableSlabPolygon } from './lib/slab-polygon'
+export { resolveSelectionProxyId, selectionProxyIdFromMetadata } from './lib/selection-proxy'
 export {
   deriveSlotId,
   isSlotMaterialName,
@@ -103,6 +106,7 @@ export {
   type WallSegment,
   type WallSegmentClosest,
 } from './lib/wall-distance'
+export { isMovable, movePlanToward, moveToward, resolveMovable } from './services/movement'
 export {
   getCatalogMaterialById,
   getLibraryMaterialIdFromRef,

packages/core/src/lib/selection-proxy.ts

@@ -0,0 +1,16 @@
+import type { AnyNode, AnyNodeId } from '../schema/types'
+
+export function selectionProxyIdFromMetadata(metadata: unknown): AnyNodeId | null {
+  if (!metadata || typeof metadata !== 'object' || Array.isArray(metadata)) return null
+  const value = (metadata as Record<string, unknown>).nodeSelectionProxyId
+  return typeof value === 'string' ? (value as AnyNodeId) : null
+}
+
+export function resolveSelectionProxyId(
+  node: AnyNode,
+  nodes: Readonly<Record<string, AnyNode | undefined>>,
+): AnyNodeId {
+  const proxyId = selectionProxyIdFromMetadata((node as { metadata?: unknown }).metadata)
+  if (!proxyId || !nodes[proxyId]) return node.id as AnyNodeId
+  return proxyId
+}

packages/core/src/registry/handles.ts

@@ -100,9 +100,11 @@ export type Cursor = 'ew-resize' | 'ns-resize' | 'move' | 'grab' | 'grabbing'
 export type HandleDecoration<N> = {
   kind: 'ring'
   /** Node-local radius of the ring (XZ plane). */
-  radius: (node: N) => number
+  radius: (node: N, sceneApi: SceneApi) => number
   /** Node-local Y of the ring. Defaults to 0. */
   y?: (node: N) => number
+  /** Node-local center of the ring. Defaults to the node origin. */
+  center?: (node: N, sceneApi: SceneApi) => readonly [number, number, number]
 }
 
 /**
@@ -127,6 +129,16 @@ export type LinearResizeHandle<N> = {
   anchor: HandleAnchor
   currentValue: (node: N) => number
   apply: (node: N, newValue: number, sceneApi: SceneApi) => Partial<N>
+  /** Optional live-scene visibility gate for context-dependent arrows. */
+  visible?: (node: N, sceneApi: SceneApi) => boolean
+  /**
+   * Optional committed-write hook. The generic handle renderer previews the
+   * selected node with the `apply` patch during drag; on release it normally
+   * writes that patch back to the same node. Composite nodes can override the
+   * final write here to fan the resize out to siblings / parents while keeping
+   * the handle UI generic.
+   */
+  commit?: (node: N, patch: Partial<N>, sceneApi: SceneApi) => void
   /**
    * Optional per-tick hook fired while this handle is being dragged, with the
    * live (in-progress, override-merged) node. A pure side-channel for transient

packages/core/src/registry/index.ts

@@ -18,6 +18,7 @@ export type {
 export {
   bakePolicyOf,
   discoverPlugins,
+  extendPluginDiscovery,
   getHostRefFields,
   getSelectableKinds,
   hasRegistry3DMoveTool,
@@ -88,12 +89,18 @@ export type {
   KeyboardAction,
   KeyboardActions,
   LazyComponent,
+  LiveTransformLike,
   McpOverrides,
   Modifiers,
   MovableConfig,
+  MovableParentFrame,
   NodeCategory,
   NodeDefinition,
   NodePort,
+  NodeQuickAction,
+  NodeQuickActionIcon,
+  NodeQuickActionProvider,
+  NodeQuickActionResult,
   NodeRegistry,
   PaintCapability,
   PaintEffectiveMaterialArgs,
@@ -113,6 +120,7 @@ export type {
   RoofAccessoryConfig,
   RotatableConfig,
   ScalableConfig,
+  SceneActionCapability,
   SceneApi,
   SelectableConfig,
   SlotDeclaration,

packages/core/src/registry/registry.ts

@@ -87,14 +87,15 @@ export function registerNode(def: AnyNodeDefinition): void {
 }
 
 /**
- * Registry of left-rail panels contributed by plugins. Same add-only,
- * duplicate-id-throws semantics as the node registry, with one difference: it
- * is *observable*. Plugin discovery runs asynchronously after the first React
- * render (see `loadExternalPlugins`), so the sidebar subscribes via
- * {@link PanelRegistryImpl.subscribe} / {@link PanelRegistryImpl.getSnapshot}
- * (the `useSyncExternalStore` contract) and re-renders when a panel lands.
- * `getSnapshot` returns a stable array reference between registrations so the
- * subscribing component doesn't re-render in a loop.
+ * Registry of UI panels contributed by plugins; the host decides where they
+ * surface. Same add-only, duplicate-id-throws semantics as the node registry,
+ * with one difference: it is *observable*. Plugin discovery runs
+ * asynchronously after the first React render (see `loadExternalPlugins`), so
+ * the host UI subscribes via {@link PanelRegistryImpl.subscribe} /
+ * {@link PanelRegistryImpl.getSnapshot} (the `useSyncExternalStore` contract)
+ * and re-renders when a panel lands. `getSnapshot` returns a stable array
+ * reference between registrations so the subscribing component doesn't
+ * re-render in a loop.
  */
 class PanelRegistryImpl {
   private readonly panels = new Map<string, PluginPanel>()
@@ -346,7 +347,9 @@ export async function loadPlugin(plugin: Plugin): Promise<void> {
  */
 export type PluginDiscovery = () => Promise<Plugin[]>
 
-let pluginDiscovery: PluginDiscovery = async () => []
+const defaultPluginDiscovery: PluginDiscovery = async () => []
+
+let pluginDiscovery: PluginDiscovery = defaultPluginDiscovery
 
 /**
  * Replace the plugin discovery implementation. Call once at app startup
@@ -359,9 +362,27 @@ let pluginDiscovery: PluginDiscovery = async () => []
  * gate + duplicate-kind protection applies.
  */
 export function setPluginDiscovery(fn: PluginDiscovery): void {
+  if (isDevMode() && pluginDiscovery !== defaultPluginDiscovery) {
+    console.warn(
+      '[registry] setPluginDiscovery replaced an existing discovery chain — plugins registered earlier (e.g. via extendPluginDiscovery) are dropped. Use extendPluginDiscovery to compose instead.',
+    )
+  }
   pluginDiscovery = fn
 }
 
+/**
+ * Extend the current plugin discovery instead of replacing it. Useful for app-
+ * bundled example or first-party plugins that should load alongside any host-
+ * provided discovery source, not clobber it.
+ */
+export function extendPluginDiscovery(fn: PluginDiscovery): void {
+  const previous = pluginDiscovery
+  pluginDiscovery = async () => {
+    const [base, extra] = await Promise.all([previous(), fn()])
+    return [...base, ...extra]
+  }
+}
+
 /**
  * Run the active plugin discovery and return the discovered plugins.
  * Bootstrap code is expected to call this after `loadPlugin(builtinPlugin)`