@pascal-app/editor 0.9.2 → 1.0.0-beta.1

package/src/components/walkthrough-hud.tsx

@@ -0,0 +1,111 @@
+'use client'
+
+import type { ReactNode } from 'react'
+import { cn } from '../lib/utils'
+import type { WalkthroughInteract } from '../store/use-first-person-hud'
+
+export type { WalkthroughInteract } from '../store/use-first-person-hud'
+
+export type WalkthroughHudProps = {
+  floorLabel?: string | null
+  zoneLabel?: string | null
+  interact?: WalkthroughInteract
+  /** Pointer lock temporarily released (OS screenshot) — the pill flips to
+   *  "Click to resume" and lets clicks fall through to the canvas. */
+  suspended?: boolean
+  onExit?: () => void
+  children?: ReactNode
+}
+
+export function WalkthroughHud({
+  floorLabel,
+  zoneLabel,
+  interact = null,
+  suspended = false,
+  onExit,
+  children,
+}: WalkthroughHudProps) {
+  const kbdClass = 'rounded border border-border/60 bg-white/10 px-1.5 py-0.5 font-mono text-[10px]'
+  const pillClass =
+    'flex items-center gap-1.5 rounded-full border border-border/40 bg-background/70 px-3 py-1 text-muted-foreground text-xs backdrop-blur-xl'
+  const exitContent = (
+    <>
+      <kbd className={kbdClass}>Esc</kbd>
+      to exit
+    </>
+  )
+
+  return (
+    <div className="dark pointer-events-none absolute inset-0 z-30 text-foreground">
+      <div className="absolute top-6 left-1/2 flex -translate-x-1/2 flex-col items-center gap-1.5">
+        {floorLabel && (
+          <div className="font-medium text-[10px] text-muted-foreground uppercase tracking-wider">
+            {floorLabel}
+          </div>
+        )}
+        {zoneLabel && (
+          <div className="corner-smooth rounded-full border border-border/40 bg-background/80 px-3 py-1 font-medium text-sm shadow-elevation-3 backdrop-blur-xl">
+            {zoneLabel}
+          </div>
+        )}
+        {children}
+      </div>
+
+      <div className="absolute top-1/2 left-1/2 -translate-x-1/2 -translate-y-1/2">
+        <div
+          className={cn(
+            'rounded-full transition-all duration-150',
+            interact
+              ? 'h-4 w-4 border-2 border-emerald-400 bg-emerald-400/10'
+              : 'h-1.5 w-1.5 bg-white/80 shadow-[0_0_2px_rgba(0,0,0,0.6)]',
+          )}
+        />
+      </div>
+
+      <div className="absolute bottom-6 left-1/2 flex -translate-x-1/2 items-center gap-2">
+        {suspended ? (
+          <div className={pillClass}>
+            <span className="font-medium text-foreground">Click</span>
+            <span>or</span>
+            <kbd className={kbdClass}>P</kbd>
+            <span>to resume</span>
+            <span className="text-muted-foreground/60">·</span>
+            {exitContent}
+          </div>
+        ) : (
+          <>
+            <div className={pillClass}>
+              <kbd className={kbdClass}>P</kbd>
+              free cursor
+            </div>
+            {onExit ? (
+              <button
+                className={cn(pillClass, 'pointer-events-auto')}
+                onClick={onExit}
+                type="button"
+              >
+                {exitContent}
+              </button>
+            ) : (
+              <div className={pillClass}>{exitContent}</div>
+            )}
+          </>
+        )}
+      </div>
+
+      {interact && (
+        <div className="absolute top-1/2 left-1/2 mt-7 -translate-x-1/2 whitespace-nowrap">
+          <div className="corner-smooth flex items-center gap-1.5 rounded-full border border-border/40 bg-background/80 px-3 py-1 text-xs shadow-elevation-3 backdrop-blur-xl">
+            <kbd className="rounded border border-border/60 bg-white/10 px-1.5 py-0.5 font-mono text-[10px]">
+              E
+            </kbd>
+            <span className="text-muted-foreground">or click to</span>
+            <span className="font-medium">
+              {interact.verb} {interact.label}
+            </span>
+          </div>
+        </div>
+      )}
+    </div>
+  )
+}

package/src/hooks/use-grid-events.ts

@@ -9,6 +9,8 @@ import { useViewer } from '@pascal-app/viewer'
 import { useThree } from '@react-three/fiber'
 import { useEffect, useRef } from 'react'
 import { Plane, Raycaster, Vector2, Vector3 } from 'three'
+import { getPlacementSurface } from '../lib/active-placement-surface'
+import { resolveTerrainGroundHit } from '../lib/ground-surface'
 
 /**
  * Custom grid events hook that uses manual raycasting instead of mesh events.
@@ -38,6 +40,28 @@ export function useGridEvents(gridY: number) {
       // Update raycaster
       raycaster.current.setFromCamera(pointer.current, camera)
 
+      // Sculpted ground wins over the plane, but only while the plane IS the
+      // ground (see `isSiteGroundPlane`): a plane riding a storey base or a slab
+      // top is a real flat surface and must stay planar. The march is what removes
+      // the perspective skew — a ray intersected at the datum instead of at the
+      // hillside reports an XZ that slides along the ray, so every tool consuming
+      // `position`/`localPosition` was placing short of the cursor on a slope.
+      //
+      // The plane's own height is the query height, not the `gridY` argument: this
+      // effect is keyed on `[camera, gl]` (re-attaching listeners mid-drag would
+      // drop the gesture), so the argument in this closure is the value from mount.
+      // `constant = -gridY` by construction in the effect above.
+      const { origin, direction } = raycaster.current.ray
+      const fixedConstructionPlane = getPlacementSurface()?.projection === 'fixed-plane'
+      const hit = fixedConstructionPlane
+        ? null
+        : resolveTerrainGroundHit(
+            [origin.x, origin.y, origin.z],
+            [direction.x, direction.y, direction.z],
+            -groundPlane.current.constant,
+          )
+      if (hit) return intersectionPoint.current.set(hit.x, hit.y, hit.z).clone()
+
       // Intersect with ground plane
       if (raycaster.current.ray.intersectPlane(groundPlane.current, intersectionPoint.current)) {
         return intersectionPoint.current.clone()

package/src/hooks/use-keyboard.ts

@@ -10,6 +10,11 @@ import {
 import { useViewer } from '@pascal-app/viewer'
 import { useEffect } from 'react'
 import { Vector3 } from 'three'
+import {
+  cutSelectionToEditorClipboard,
+  deleteSelection,
+  pasteSelectionAndPickUp,
+} from '../components/editor/group-actions'
 import {
   classifyParticipant,
   collectParticipants,
@@ -24,12 +29,11 @@ import { toggleDoorOpenState } from '../lib/door-interaction'
 import { guideEmitter } from '../lib/guide-events'
 import { runRedo, runUndo } from '../lib/history'
 import { isActive } from '../lib/interaction/scope'
-import {
-  copySelectedNodesToEditorClipboard,
-  pasteEditorClipboardToLevel,
-} from '../lib/scene-clipboard'
-import { emitDeleteSFX, sfxEmitter } from '../lib/sfx-bus'
+import { copySelectedNodesToEditorClipboard } from '../lib/scene-clipboard'
+import { sfxEmitter } from '../lib/sfx-bus'
+import { activeSiteNode, clampBrushRadius } from '../lib/terrain-sculpt'
 import { toggleWindowOpenState } from '../lib/window-interaction'
+import useDeleteConfirmation from '../store/use-delete-confirmation'
 import useEditor, { getActiveContinuationContext, getActiveSnapContext } from '../store/use-editor'
 import useInteractionScope, { getMovingNode } from '../store/use-interaction-scope'
 
@@ -210,6 +214,10 @@ export const useKeyboard = ({
         return
       }
 
+      if (useDeleteConfirmation.getState().request) {
+        return
+      }
+
       if (e.key === 'Shift' && !e.repeat && useEditor.getState().mode === 'material-paint') {
         // In paint mode Shift cycles the application scope (this surface →
         // whole item / all matching / room) — the paint-mode analogue of the
@@ -220,6 +228,34 @@ export const useKeyboard = ({
         return
       }
 
+      // Brush size, on the keys every sculpting tool in the industry uses. Gated
+      // on sculpt mode so `[`/`]` stay free everywhere else. Key-repeat is
+      // allowed (unlike the cycles above) because holding to resize is the
+      // expected feel, and the step is multiplicative so one press is a
+      // proportional change at both the floor and 20 m rather than 40× coarser at
+      // the bottom of the range. The range comes from `brushRadiusRange` so this
+      // and the panel's slider cannot disagree about it — and so the low end
+      // tracks the field's sample spacing, below which a dab paints nothing.
+      if (
+        (e.key === '[' || e.key === ']') &&
+        !e.metaKey &&
+        !e.ctrlKey &&
+        useEditor.getState().mode === 'terrain-sculpt'
+      ) {
+        e.preventDefault()
+        const { terrainBrush, setTerrainBrush } = useEditor.getState()
+        const factor = e.key === ']' ? 1.25 : 1 / 1.25
+        const radius = clampBrushRadius(
+          activeSiteNode(),
+          Math.round(terrainBrush.radius * factor * 10) / 10,
+        )
+        if (radius !== terrainBrush.radius) {
+          setTerrainBrush({ radius })
+          sfxEmitter.emit('sfx:grid-snap')
+        }
+        return
+      }
+
       if (e.key === 'Shift' && !e.repeat && isSnappingCycleContext()) {
         // Cycle the global snapping mode (grid → lines → angles → off).
         // `'off'` is the snap bypass now, so Shift no longer holds-to-bypass.
@@ -357,17 +393,24 @@ export const useKeyboard = ({
         useEditor.getState().setPhase('structure')
         useEditor.getState().setStructureLayer('elements')
         useEditor.getState().setMode('material-paint')
+      } else if (e.key === 'g' && !e.metaKey && !e.ctrlKey) {
+        if (isVersionPreviewMode) return
+        e.preventDefault()
+        // G for ground. No `setPhase` — `setMode` moves to the site phase itself,
+        // and doing it here would set the phase twice with a mode reset between.
+        useEditor.getState().setMode('terrain-sculpt')
       } else if (e.key === 'c' && (e.metaKey || e.ctrlKey) && !e.shiftKey) {
         if (isVersionPreviewMode) return
         e.preventDefault()
         copySelectedNodesToEditorClipboard()
+      } else if (e.key === 'x' && (e.metaKey || e.ctrlKey) && !e.shiftKey) {
+        if (isVersionPreviewMode) return
+        e.preventDefault()
+        cutSelectionToEditorClipboard()
       } else if (e.key === 'v' && (e.metaKey || e.ctrlKey) && !e.shiftKey) {
         if (isVersionPreviewMode) return
         e.preventDefault()
-        const result = pasteEditorClipboardToLevel()
-        if (result?.pastedIds.length) {
-          sfxEmitter.emit('sfx:item-place')
-        }
+        void pasteSelectionAndPickUp()
       } else if (e.key.toLowerCase() === 'z' && e.shiftKey && (e.metaKey || e.ctrlKey)) {
         if (isVersionPreviewMode) return
         e.preventDefault()
@@ -621,27 +664,7 @@ export const useKeyboard = ({
           }
         }
 
-        const selectedNodeIds = useViewer.getState().selection.selectedIds as AnyNodeId[]
-
-        if (selectedNodeIds.length > 0) {
-          // Guard against accidental bulk deletion (e.g. box-select all + Delete)
-          const BULK_DELETE_THRESHOLD = 10
-          if (selectedNodeIds.length >= BULK_DELETE_THRESHOLD) {
-            const confirmed = window.confirm(
-              `Delete ${selectedNodeIds.length} selected elements? This cannot be undone if the undo history is exhausted.`,
-            )
-            if (!confirmed) return
-          }
-
-          // Play appropriate SFX based on what's being deleted
-          if (selectedNodeIds.length === 1) {
-            const node = useScene.getState().nodes[selectedNodeIds[0]!]
-            emitDeleteSFX(node?.type)
-          } else {
-            sfxEmitter.emit('sfx:structure-delete')
-          }
-
-          useScene.getState().deleteNodes(selectedNodeIds)
+        if (deleteSelection()) {
           return
         }
 

package/src/index.tsx

@@ -2,7 +2,21 @@
 // own shells on top of `@pascal-app/editor` (community-app, embedders)
 // don't have to learn three separate package imports. The canonical
 // definitions still live in `@pascal-app/core` / `@pascal-app/viewer`.
-export { useScene } from '@pascal-app/core'
+export {
+  type ApplySceneSnapshotOptions,
+  acquireSceneReadOnlyLease,
+  applyScenePatch,
+  applySceneSnapshot,
+  type SceneCommit,
+  type SceneCommitListener,
+  type SceneCommitOrigin,
+  type SceneMaterialPatch,
+  type SceneNodePatch,
+  type ScenePatch,
+  type SceneSnapshot,
+  subscribeSceneCommits,
+  useScene,
+} from '@pascal-app/core'
 export { useViewer } from '@pascal-app/viewer'
 export type { EditorProps } from './components/editor'
 export { default as Editor } from './components/editor'
@@ -12,6 +26,8 @@ export { default as Editor } from './components/editor'
 // surface uses the shorter, shell-friendly names from the unified
 // preset-system spec.
 export { BakeExporter } from './components/editor/bake-exporter'
+export { BakeThumbnail } from './components/editor/bake-thumbnail'
+export { FirstPersonControls } from './components/editor/first-person-controls'
 export { FloatingActionMenu as FloatingMenu } from './components/editor/floating-action-menu'
 // Embed surface — the editor's real in-canvas affordances, so a host can mount
 // authentic selection handles, interactive build tools, and the mover on top
@@ -66,6 +82,13 @@ export {
   type SnapshotCameraData,
   ThumbnailGenerator,
 } from './components/editor/thumbnail-generator'
+export { useFloorplanRender } from './components/editor-2d/floorplan-render-context'
+export { FloorplanDimensionRenderer } from './components/editor-2d/renderers/floorplan-dimension-renderer'
+export { FloorplanGeometryRenderer } from './components/editor-2d/renderers/floorplan-geometry-renderer'
+export {
+  FloorplanNodePreview,
+  type FloorplanNodePreviewProps,
+} from './components/editor-2d/renderers/floorplan-placement-preview-layer'
 // SVG path builders for arc / annular-sector / arrow-head shapes —
 // inlined into `kind: 'path'` / `kind: 'polygon'` primitives by curved
 // stair rendering in `nodes/src/stair/floorplan.ts`.
@@ -113,7 +136,21 @@ export { CursorSphere } from './components/tools/shared/cursor-sphere'
 export { DragBoundingBox } from './components/tools/shared/drag-bounding-box'
 export { getFloorStackPreviewPosition } from './components/tools/shared/floor-stack-preview'
 export { useFreshPlacementVisibility } from './components/tools/shared/fresh-placement-visibility'
+export {
+  type HorizontalConstructionPlane,
+  publishHorizontalConstructionPlane,
+  resampleTerrainConstructionPlane,
+  resolveEventConstructionPlane,
+  resolveLevelConstructionPlane,
+} from './components/tools/shared/horizontal-construction-plane'
 export { PlacementBox } from './components/tools/shared/placement-box'
+// Pointer-decided support surface (deck top vs floor underneath) — the
+// draw tools (wall / fence) ride their grid plane and commit cap on it.
+export {
+  type PointerSupportSurface,
+  resolvePointerSupportElevation,
+  resolvePointerSupportSurface,
+} from './components/tools/shared/pointer-support-cap'
 // Phase 5 Stage D — PolygonEditor for slab/ceiling boundary + hole editors.
 export {
   PolygonEditor,
@@ -148,7 +185,7 @@ export {
   DEFAULT_STAIR_TYPE,
   DEFAULT_STAIR_WIDTH,
 } from './components/tools/stair/stair-defaults'
-export { ToolManager } from './components/tools/tool-manager'
+export { preloadRegistryToolModules, ToolManager } from './components/tools/tool-manager'
 export {
   chainEndJoinsExistingWall,
   createWallOnCurrentLevel,
@@ -182,12 +219,20 @@ export {
 } from './components/ui/action-menu/view-toggles'
 export { useCommandPalette } from './components/ui/command-palette'
 export { ActionButton, ActionGroup } from './components/ui/controls/action-button'
-export { MaterialPaintPanel } from './components/ui/controls/material-paint-panel'
-export { MaterialPicker } from './components/ui/controls/material-picker'
+export {
+  MaterialPaintPanel,
+  type MaterialPaintPanelProps,
+} from './components/ui/controls/material-paint-panel'
+export {
+  MaterialPicker,
+  type MaterialPickerProps,
+  type MaterialSourceFilter,
+} from './components/ui/controls/material-picker'
 export { MetricControl } from './components/ui/controls/metric-control'
 export { PanelSection } from './components/ui/controls/panel-section'
 export { SegmentedControl } from './components/ui/controls/segmented-control'
 export { SliderControl } from './components/ui/controls/slider-control'
+export { TerrainSculptPanel } from './components/ui/controls/terrain-sculpt-panel'
 export { ToggleControl } from './components/ui/controls/toggle-control'
 export { FloatingLevelSelector } from './components/ui/floating-level-selector'
 export { CATALOG_ITEMS } from './components/ui/item-catalog/catalog-items'
@@ -229,6 +274,19 @@ export {
   SnapTargetBadge,
   SnapTargetIcon,
 } from './components/ui/snap-target-badge'
+export {
+  ViewerControlsBar,
+  type ViewerControlsBarProps,
+} from './components/viewer/viewer-controls-bar'
+export {
+  ViewerSceneHeader,
+  type ViewerSceneHeaderProps,
+} from './components/viewer/viewer-scene-header'
+export {
+  WalkthroughHud,
+  type WalkthroughHudProps,
+  type WalkthroughInteract,
+} from './components/walkthrough-hud'
 export type { SaveStatus } from './hooks/use-auto-save'
 // useDragAction is the React-side glue for the registry's DragAction
 // primitive. Public so registry-driven kinds (Phase 5+ Stage D ports)
@@ -236,6 +294,7 @@ export type { SaveStatus } from './hooks/use-auto-save'
 export { type UseDragActionArgs, useDragAction } from './hooks/use-drag-action'
 // Phase 5 Stage D — extras for kind-owned placement tools (FenceTool etc.).
 export { markToolCancelConsumed } from './hooks/use-keyboard'
+export { useReducedMotion } from './hooks/use-reduced-motion'
 export { type Selection, useSelection } from './hooks/use-selection'
 export {
   clearPlacementSurface,
@@ -259,6 +318,17 @@ export {
   continuationContextOf,
   nextContinuation,
 } from './lib/continuation'
+export {
+  clearStructuralElevationGuide,
+  collectElevationSnapTargets,
+  ELEVATION_ALIGNMENT_THRESHOLD_M,
+  type ElevationGuideSource,
+  type ElevationSnapMatch,
+  type ElevationSnapTarget,
+  publishStructuralElevationGuide,
+  resolveElevationSnapMatch,
+  resolveStructuralElevationSnap,
+} from './lib/elevation-guides'
 export {
   resolveCurrentBuildingId,
   resolveElevatorNodeSupportY,
@@ -285,14 +355,50 @@ export {
   type FloorplanStairSegmentEntry,
   getFloorplanWallThickness,
 } from './lib/floorplan'
+export type {
+  FloorplanAnnotationCategory,
+  FloorplanAnnotationVisibility,
+} from './lib/floorplan/annotation-visibility'
+export {
+  createFloorplanContextExtensions,
+  FLOORPLAN_CONTEXT_EXTENSION_KEY,
+  FLOORPLAN_GEOMETRY_METADATA_KEY,
+  FLOORPLAN_NODE_EXTENSION_KEY,
+  type FloorplanAnnotationRole,
+  type FloorplanMetricNotation,
+  type FloorplanNodeExtension,
+  type FloorplanRenderPurpose,
+  type FloorplanSchedule,
+  type FloorplanToolContext,
+  type FloorplanToolMode,
+  floorplanGeometryMetadata,
+  getFloorplanNodeExtension,
+  readFloorplanContext,
+  readFloorplanGeometryMetadata,
+  readFloorplanMetricNotationOverride,
+  withFloorplanGeometryMetadata,
+} from './lib/floorplan/floorplan-extension'
+export {
+  DEFAULT_FLOORPLAN_MODE,
+  FLOORPLAN_MODES,
+  type FloorplanMode,
+  isFloorplanToolAvailableInMode,
+} from './lib/floorplan/floorplan-mode'
 export { commitFreshPlacementSubtree } from './lib/fresh-planar-placement'
 export { exportSceneToGlb } from './lib/glb-export'
+export {
+  type HistoryCommandDelegate,
+  installHistoryCommandDelegate,
+  runRedo,
+  runUndo,
+} from './lib/history'
 export {
   boundaryReshapeScope,
   curveReshapeScope,
   endpointReshapeScope,
   holeEditScope,
   movingNodeOf,
+  scopeNodeId,
 } from './lib/interaction/scope'
 export {
   buildResetSurfaceMaterialUpdates,
@@ -366,6 +472,7 @@ export type { SceneGraph } from './lib/scene'
 export { applySceneGraphToEditor } from './lib/scene'
 export { movementSfxStepKey } from './lib/sfx/movement-tick'
 export { triggerSFX } from './lib/sfx-bus'
+export { playSFX, type SFXName, type SFXPlaybackOptions } from './lib/sfx-player'
 export {
   clearSlabSnapFeedback,
   resolveSlabEdgeBandSnap,
@@ -392,6 +499,13 @@ export {
   type SurfacePlanSnapInput,
   type SurfacePlanSnapResult,
 } from './lib/surface-plan-snap'
+export {
+  fieldExtentForSite,
+  flattenSite,
+  resetSiteTerrain,
+  resolveFlattenTarget,
+  sculptFieldForSite,
+} from './lib/terrain-sculpt'
 // `cn` (twMerge + clsx) — used by kind-owned panels in `@pascal-app/
 // nodes` so they don't need their own copy / their own tailwind-merge
 // dependency.
@@ -407,6 +521,10 @@ export {
 export { default as useAlignmentGuides } from './store/use-alignment-guides'
 export { default as useAudio } from './store/use-audio'
 export { type CommandAction, useCommandRegistry } from './store/use-command-registry'
+export {
+  DRAWING_TYPE_OPTIONS,
+  default as useDrawingView,
+} from './store/use-drawing-view'
 export type {
   CaptureMode,
   FloorplanSelectionTool,
@@ -429,6 +547,10 @@ export {
 } from './store/use-editor'
 export { default as useFacingPose, type FacingPose } from './store/use-facing-pose'
 export { default as useFenceCurveDraft } from './store/use-fence-curve-draft'
+export { type FirstPersonHudState, useFirstPersonHud } from './store/use-first-person-hud'
+export { default as useFloorplanAnnotationVisibility } from './store/use-floorplan-annotation-visibility'
+export { useFloorplanDraftPreview } from './store/use-floorplan-draft-preview'
+export { default as useFloorplanMode } from './store/use-floorplan-mode'
 export {
   default as useInteractionScope,
   getEditingHole,
@@ -466,6 +588,13 @@ export {
   type PaletteViewProps,
   usePaletteViewRegistry,
 } from './store/use-palette-view-registry'
+export {
+  type PathDraftKind,
+  type PathDraftParameter,
+  type PathDraftParameters,
+  type PathDraftPoint,
+  usePathDraftPreview,
+} from './store/use-path-draft-preview'
 export { default as usePlacementPreview } from './store/use-placement-preview'
 export {
   activateQuickMeasurementHudSource,
@@ -477,6 +606,10 @@ export {
   useQuickMeasurementHud,
 } from './store/use-quick-measurement-hud'
 export { default as useSegmentDraftChain } from './store/use-segment-draft-chain'
+export {
+  type StairPreviewPoint,
+  useStairBuildPreview,
+} from './store/use-stair-build-preview'
 export { useUploadStore } from './store/use-upload'
 export { useWallMoveGhosts, type WallMoveGhostBridge } from './store/use-wall-move-ghosts'
 export {

package/src/lib/active-placement-surface.test.ts

@@ -0,0 +1,24 @@
+import { afterEach, describe, expect, test } from 'bun:test'
+import { Vector3 } from 'three'
+import {
+  clearPlacementSurface,
+  getPlacementSurface,
+  publishPlacementSurface,
+} from './active-placement-surface'
+
+describe('active placement surface', () => {
+  afterEach(() => clearPlacementSurface())
+
+  test('marks a frozen construction plane so terrain raycasting can bypass it', () => {
+    publishPlacementSurface(new Vector3(1, 0, 2), new Vector3(0, 1, 0), 'fixed-plane')
+
+    expect(getPlacementSurface()?.projection).toBe('fixed-plane')
+  })
+
+  test('ordinary surface publishes reset the projection mode', () => {
+    publishPlacementSurface(new Vector3(), new Vector3(0, 1, 0), 'fixed-plane')
+    publishPlacementSurface(new Vector3(), new Vector3(0, 1, 0))
+
+    expect(getPlacementSurface()?.projection).toBe('surface')
+  })
+})

package/src/lib/active-placement-surface.ts

@@ -12,17 +12,24 @@ import { Vector3 } from 'three'
 export type PlacementSurface = {
   point: Vector3
   normal: Vector3
+  projection: 'surface' | 'fixed-plane'
 }
 
 const surface: PlacementSurface = {
   point: new Vector3(),
   normal: new Vector3(0, 1, 0),
+  projection: 'surface',
 }
 let active = false
 
-export function publishPlacementSurface(point: Vector3, normal: Vector3): void {
+export function publishPlacementSurface(
+  point: Vector3,
+  normal: Vector3,
+  projection: PlacementSurface['projection'] = 'surface',
+): void {
   surface.point.copy(point)
   surface.normal.copy(normal)
+  surface.projection = projection
   active = true
 }