@pascal-app/editor 1.0.0 → 1.0.3

package/src/index.tsx

@@ -49,7 +49,7 @@ export { FloatingActionMenu as FloatingMenu } from './components/editor/floating
 // camera controls via the `useViewer.inputDragging` / `useEditor.movingNode`
 // flags. Tools place onto `useViewer.selection.levelId`, so the host must set a
 // building + level selection first.
-export { Grid } from './components/editor/grid'
+export { EDITOR_GRID_INPUT_NAME, Grid } from './components/editor/grid'
 export {
   DimensionPill,
   type DimensionPillPart,
@@ -79,12 +79,18 @@ export {
   useInvisibleHitAreaMaterial,
 } from './components/editor/node-arrow-handles'
 export { QuickMeasurementCard } from './components/editor/quick-measurement-card'
+export { SelectionManager } from './components/editor/selection-manager'
 export {
   type SnapshotCameraData,
   ThumbnailGenerator,
 } from './components/editor/thumbnail-generator'
+export { WallMoveSideHandles } from './components/editor/wall-move-side-handles'
 export { useFloorplanRender } from './components/editor-2d/floorplan-render-context'
 export { FloorplanDimensionRenderer } from './components/editor-2d/renderers/floorplan-dimension-renderer'
+export {
+  type DraftWallMeasurement,
+  FloorplanDraftWallMeasurement,
+} from './components/editor-2d/renderers/floorplan-draft-wall-measurement'
 export { FloorplanGeometryRenderer } from './components/editor-2d/renderers/floorplan-geometry-renderer'
 export {
   FloorplanNodePreview,
@@ -137,8 +143,13 @@ export {
   type PlacementCoordinatorConfig,
   usePlacementCoordinator,
 } from './components/tools/item/use-placement-coordinator'
+export { MoveRegistryNodeTool } from './components/tools/registry/move-registry-node-tool'
 export { useRegistryToolContext } from './components/tools/registry-tool-context'
 export { CursorSphere } from './components/tools/shared/cursor-sphere'
+export {
+  DRAFT_LABEL_Y_OFFSET,
+  DraftMeasurementLabel,
+} from './components/tools/shared/draft-measurement-label'
 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'
@@ -220,6 +231,7 @@ export {
   CameraActions as ToolbarRight,
   CameraActions as ViewerToolbarRight,
 } from './components/ui/action-menu/camera-actions'
+export { furnishTools } from './components/ui/action-menu/furnish-tools'
 export {
   ViewToggles as ToolbarLeft,
   ViewToggles as ViewerToolbarLeft,
@@ -246,6 +258,19 @@ export { FloatingLevelSelector } from './components/ui/floating-level-selector'
 export { CATALOG_ITEMS } from './components/ui/item-catalog/catalog-items'
 // Item collections UI — used by the kind-owned ItemPanel in nodes/.
 export { CollectionsPopover } from './components/ui/panels/collections/collections-popover'
+export {
+  resolveHomogeneousSelection,
+  resolveUniqueSelectionIds,
+} from './components/ui/panels/homogeneous-selection'
+export {
+  commitMultiNodeFields,
+  fieldVisibleForAll,
+  firstNumericFieldValue,
+  firstVec3FieldValue,
+  reduceFieldValue,
+  reduceHeightBoundMode,
+} from './components/ui/panels/multi-field-value'
+export { applyMultiHeightMode } from './components/ui/panels/multi-height-mode'
 // Phase 5 Stage E — kinds with bespoke editors (slab holes list,
 // ceiling height presets, etc.) use `parametrics.customPanel` to mount
 // a kind-owned panel and need PanelWrapper for the chrome.
@@ -268,6 +293,7 @@ export {
 } from './components/ui/primitives/shortcut-token'
 export { useSidebarStore } from './components/ui/primitives/sidebar'
 export { Slider } from './components/ui/primitives/slider'
+export { Tooltip, TooltipContent, TooltipTrigger } from './components/ui/primitives/tooltip'
 export { SceneLoader } from './components/ui/scene-loader'
 export type { ExtraPanel } from './components/ui/sidebar/icon-rail'
 export { ItemsPanel } from './components/ui/sidebar/panels/items-panel'
@@ -317,6 +343,7 @@ export {
   ViewerStageSwitcher,
   type ViewerStageSwitcherProps,
 } from './components/viewer/viewer-stage-switcher'
+export { ViewerUnitsPanel } from './components/viewer/viewer-units-panel'
 export {
   WalkthroughHud,
   type WalkthroughHudProps,
@@ -328,7 +355,7 @@ export type { SaveStatus } from './hooks/use-auto-save'
 // can express their affordances declaratively in their own folder.
 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 { cancelActiveTool, markToolCancelConsumed } from './hooks/use-keyboard'
 export { useReducedMotion } from './hooks/use-reduced-motion'
 export { type Selection, useSelection } from './hooks/use-selection'
 export {
@@ -337,6 +364,11 @@ export {
   type PlacementSurface,
   publishPlacementSurface,
 } from './lib/active-placement-surface'
+export {
+  activateCatalogItem,
+  filterCatalogItems,
+  isCatalogItemSelected,
+} from './lib/catalog-panel-model'
 export {
   CEILING_ALIGNMENT_THRESHOLD_M,
   type CeilingPlanSnapInput,
@@ -359,6 +391,7 @@ export {
   continuationContextOf,
   nextContinuation,
 } from './lib/continuation'
+export { canDirectMoveNode } from './lib/direct-manipulation'
 export { createEditorApi } from './lib/editor-api'
 export {
   clearStructuralElevationGuide,
@@ -378,6 +411,7 @@ export {
   resolveElevatorSupportLevelId,
   resolveElevatorSupportY,
 } from './lib/elevator-support'
+export type { ExportTextureUtils } from './lib/export-texture-utils'
 export { getFloatingMenuScale } from './lib/floating-menu-scale'
 // Floor-plan stair helpers — the cumulative-transform walk
 // (`computeFloorplanStairSegmentTransforms`) and the rich segment-entry
@@ -432,6 +466,7 @@ export {
   type FloorplanMode,
   isFloorplanToolAvailableInMode,
 } from './lib/floorplan/floorplan-mode'
+export { clientToPlan } from './lib/floorplan/plan-coords'
 export {
   commitFreshPlacementSubtree,
   createFreshPlacementSubtree,
@@ -471,6 +506,8 @@ export {
   movingNodeOf,
   scopeNodeId,
 } from './lib/interaction/scope'
+export { isEditableKeyboardTarget } from './lib/keyboard-pan'
+export { useMaterialCatalogModel } from './lib/material-catalog-model'
 export {
   type ActivePaintMaterial,
   buildResetSurfaceMaterialUpdates,
@@ -480,6 +517,7 @@ export {
   getActivePaintMaterialLabel,
   hasActivePaintMaterial,
 } from './lib/material-paint'
+export { useMaterialPaintPanelModel } from './lib/material-paint-panel-model'
 export {
   CREATABLE_MEASUREMENT_KINDS,
   type CreatableMeasurementKind,
@@ -526,6 +564,21 @@ export type {
   ModelExportFormat,
   ModelExportOptions,
 } from './lib/model-export'
+export {
+  cyclePaintScope,
+  type PaintHoverInfo,
+  type PaintScope,
+  paintScopeLabel,
+} from './lib/paint-scope'
+export {
+  getNodePanelModel,
+  type NodePanelModel,
+  PANEL_MODEL_EXTENSION,
+  type PanelAction,
+  type PanelRow,
+} from './lib/panel-rows'
+export { type PanelToolOption, usePanelToolHints } from './lib/panel-tool-options'
+export { commitParametricNodeFields } from './lib/parametric-node-update'
 export { consumePlacementDragRelease } from './lib/placement-drag-release'
 export {
   addFreshPlacementMetadata,
@@ -544,6 +597,8 @@ export {
   editorHostPanelRegistry,
   registerEditorHostPanel,
 } from './lib/plugin-panels'
+export { configureManifoldRuntime } from './lib/print-shell-compiler-manifold-worker'
+export type { ManifoldRuntimeOptions } from './lib/print-shell-compiler-protocol'
 export {
   createQuickMeasurementPointerScheduler,
   quickMeasurementContext,
@@ -557,7 +612,7 @@ export { hasRoofFaceChildOverlap, type RoofWallHit, resolveRoofWallHit } from '.
 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 { emitDeleteSFX, triggerSFX } from './lib/sfx-bus'
 export { playSFX, type SFXName, type SFXPlaybackOptions } from './lib/sfx-player'
 export {
   clearSlabSnapFeedback,
@@ -570,12 +625,14 @@ export {
   type SlabPlanSnapResult,
 } from './lib/slab-plan-snap'
 export {
+  cycleSnappingModeIn,
   getSnappingModeLabel,
   resolveSnapFlags,
   type SnapContext,
   type SnapFlags,
   type SnappingMode,
 } from './lib/snapping-mode'
+export { getSpatialPointerId, spatialPointerInput } from './lib/spatial-pointer-input'
 export { duplicateStairSubtree } from './lib/stair-duplication'
 export {
   getBuildingLevelsForLevel,
@@ -585,6 +642,7 @@ export {
   resolveStairPlacementLevelId,
   resolveStairToLevelId,
 } from './lib/stair-levels'
+export { surfaceAttachmentId, surfaceFramePose, updateSurfaceNode } from './lib/surface-attachment'
 export {
   clearSurfacePlanSnapFeedback,
   resolveSurfacePlanPointSnap,
@@ -592,14 +650,20 @@ export {
   type SurfacePlanSnapInput,
   type SurfacePlanSnapResult,
 } from './lib/surface-plan-snap'
+export { useTerrainPanelRows } from './lib/terrain-panel-model'
 export {
+  brushRadiusRange,
+  clipTerrainPatchToSite,
+  commitStroke,
   fieldExtentForSite,
   flattenSite,
   resetSiteTerrain,
   resolveFlattenTarget,
   sculptFieldForSite,
+  terrainPointInsideSite,
 } from './lib/terrain-sculpt'
 export { exportSceneToUsdz, type UsdzExportOptions } from './lib/usdz-export'
+export { useLinearDisplay } from './lib/use-linear-display'
 // `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.
@@ -647,6 +711,7 @@ export {
   isAngleSnapActive,
   isGridSnapActive,
   isMagneticSnapActive,
+  selectDefaultBuildingAndLevel,
 } 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'

package/src/lib/catalog-panel-model.ts

@@ -0,0 +1,39 @@
+import { useViewer } from '@pascal-app/viewer'
+import { CATALOG_ITEMS, type CatalogItem } from '../components/ui/item-catalog/catalog-items'
+import useEditor, { type CatalogCategory } from '../store/use-editor'
+
+export function filterCatalogItems({
+  category,
+  items = CATALOG_ITEMS,
+  search = '',
+  activePlacementTag,
+  activeFunctionalTag,
+  overrideItems,
+}: {
+  category?: CatalogCategory
+  items?: readonly CatalogItem[]
+  search?: string
+  activePlacementTag?: string | null
+  activeFunctionalTag?: string | null
+  overrideItems?: readonly CatalogItem[]
+}): readonly CatalogItem[] {
+  return (
+    overrideItems ??
+    items.filter((item) => {
+      if (!search && category && item.category !== category) return false
+      if (activePlacementTag && !item.tags?.includes(activePlacementTag)) return false
+      if (activeFunctionalTag && !item.tags?.includes(activeFunctionalTag)) return false
+      return !search || item.name.toLowerCase().includes(search.toLowerCase())
+    })
+  )
+}
+
+export function activateCatalogItem(item: CatalogItem) {
+  useViewer.getState().setSelection({ selectedIds: [], zoneId: null })
+  const editor = useEditor.getState()
+  editor.setSelectedItem(item)
+  editor.setTool(item.tool ?? 'item')
+  editor.setMode('build')
+}
+
+export { isCatalogItemSelected } from './catalog-selection'

package/src/lib/catalog-selection.test.ts

@@ -0,0 +1,27 @@
+import { test } from 'bun:test'
+import assert from 'node:assert/strict'
+import { isCatalogItemSelected } from './catalog-selection'
+
+test('no selection leaves every tile unhighlighted, including items without model URLs', () => {
+  for (const item of [{ id: 'chair' }, { id: 'cabinet' }]) {
+    assert.equal(isCatalogItemSelected(item, null), false)
+  }
+})
+
+test('only the chosen item is highlighted when model URLs are missing or shared', () => {
+  for (const src of [undefined, '/shared-model.glb']) {
+    const items = [
+      { id: 'first', src },
+      { id: 'second', src },
+    ]
+    assert.deepEqual(
+      items.map((item) => isCatalogItemSelected(item, items[1]!)),
+      [false, true],
+    )
+  }
+})
+
+test('selection follows identity across reloaded catalog objects', () => {
+  assert.equal(isCatalogItemSelected({ id: 'chair' }, { id: 'chair' }), true)
+  assert.equal(isCatalogItemSelected({ id: 'chair' }, { id: 'table' }), false)
+})

package/src/lib/catalog-selection.ts

@@ -0,0 +1,8 @@
+import type { CatalogItem } from '../components/ui/item-catalog/catalog-items'
+
+export function isCatalogItemSelected(
+  item: Pick<CatalogItem, 'id'>,
+  selected: Pick<CatalogItem, 'id'> | null,
+) {
+  return selected != null && item.id === selected.id
+}

package/src/lib/contextual-help.test.ts

@@ -1,5 +1,14 @@
 import { describe, expect, test } from 'bun:test'
-import { resolveSelectModeHelpHints } from './contextual-help'
+import { resolveRotateHandleHelpHints, resolveSelectModeHelpHints } from './contextual-help'
+
+test('rotation advertises Alt as the temporary free-rotation override', () => {
+  expect(resolveRotateHandleHelpHints(false)).toEqual([
+    { keys: ['Alt'], label: 'Hold to rotate freely', active: false },
+  ])
+  expect(resolveRotateHandleHelpHints(true)).toEqual([
+    { keys: ['Alt'], label: 'Rotating freely (no angle step)', active: true },
+  ])
+})
 
 describe('resolveSelectModeHelpHints', () => {
   test('stays hidden in idle select mode with no selection', () => {
@@ -117,4 +126,21 @@ describe('resolveSelectModeHelpHints', () => {
       },
     ])
   })
+
+  test('shows the single-side radius hint for rounded openings', () => {
+    expect(
+      resolveSelectModeHelpHints({
+        selectedCount: 1,
+        hasMovableSelection: true,
+        hasRotatableSelection: false,
+        hasOpeningRadiusSelection: true,
+        commandPressed: false,
+        shiftPressed: false,
+      }),
+    ).toContainEqual({
+      keys: ['Shift'],
+      label: 'Adjust one side’s corner radius',
+      active: false,
+    })
+  })
 })

package/src/lib/contextual-help.ts

@@ -11,8 +11,8 @@ export type ContextualShortcutHint = {
 }
 
 // `activeHandleDrag.label` value a rotate gizmo sets while dragging, so the
-// contextual HUD can surface the Shift = free-rotation toggle for the duration
-// (mirrors how wall drafting advertises Shift). Distinct from resize handles,
+// contextual HUD can surface the rotation snapping mode for the duration.
+// Distinct from resize handles,
 // which route their own measurement label here.
 export const ROTATE_HANDLE_DRAG_LABEL = 'rotate-handle'
 
@@ -29,15 +29,12 @@ export const RESIZE_HANDLE_DRAG_LABEL = 'resize-handle'
 export const GROUP_MOVE_DRAG_LABEL = 'group-move-handle'
 export const GROUP_ROTATE_DRAG_LABEL = 'group-rotate-handle'
 
-// Hints shown while a rotate gizmo is mid-drag: Shift bypasses the angle step
-// (free rotation), the same toggle wall drafting exposes. `active` lights the
-// pill while Shift is held.
-export function resolveRotateHandleHelpHints(shiftPressed: boolean): ContextualShortcutHint[] {
+export function resolveRotateHandleHelpHints(altPressed: boolean): ContextualShortcutHint[] {
   return [
     {
-      keys: [SHIFT_KEY],
-      label: shiftPressed ? 'Rotating freely (no angle step)' : 'Hold to rotate freely',
-      active: shiftPressed,
+      keys: [ALT_KEY],
+      label: altPressed ? 'Rotating freely (no angle step)' : 'Hold to rotate freely',
+      active: altPressed,
     },
   ]
 }
@@ -46,6 +43,7 @@ export type SelectModeHelpContext = {
   selectedCount: number
   hasMovableSelection: boolean
   hasRotatableSelection: boolean
+  hasOpeningRadiusSelection?: boolean
   commandPressed: boolean
   shiftPressed: boolean
   // When a single MEP node is selected its in-world handle rig (click a dot to
@@ -67,6 +65,7 @@ export function resolveSelectModeHelpHints({
   selectedCount,
   hasMovableSelection,
   hasRotatableSelection,
+  hasOpeningRadiusSelection = false,
   commandPressed,
   shiftPressed,
   mepSelection = null,
@@ -142,6 +141,14 @@ export function resolveSelectModeHelpHints({
     })
   }
 
+  if (hasOpeningRadiusSelection) {
+    hints.push({
+      keys: [SHIFT_KEY],
+      label: 'Adjust one side’s corner radius',
+      active: shiftPressed,
+    })
+  }
+
   hints.push({
     keys: [[COMMAND_KEY, SHIFT_KEY], LEFT_CLICK],
     label: 'Add or remove objects from the selection',

package/src/lib/export-texture-utils.test.ts

@@ -0,0 +1,167 @@
+import { afterEach, describe, expect, test } from 'bun:test'
+import * as THREE from 'three'
+import type { WebGPURenderer } from 'three/webgpu'
+import { createExportTextureUtils } from './export-texture-utils'
+
+const globals = globalThis as unknown as { document?: unknown }
+const previousDocument = globals.document
+
+type FakeRenderer = {
+  renderer: WebGPURenderer
+  calls: { render: number; dispose: number; destroy: number; sizes: [number, number][] }
+  domElement: object
+}
+
+function fakeRenderer(): FakeRenderer {
+  const calls = { render: 0, dispose: 0, destroy: 0, sizes: [] as [number, number][] }
+  const domElement = { kind: 'renderer-canvas' }
+  const renderer = {
+    domElement,
+    outputColorSpace: THREE.SRGBColorSpace,
+    backend: {
+      device: {
+        destroy: () => {
+          calls.destroy += 1
+        },
+      },
+    },
+    setSize: (width: number, height: number) => {
+      calls.sizes.push([width, height])
+    },
+    render: () => {
+      calls.render += 1
+    },
+    dispose: async () => {
+      calls.dispose += 1
+    },
+  }
+  return { renderer: renderer as unknown as WebGPURenderer, calls, domElement }
+}
+
+function installCanvasDocument(drawn: object[]) {
+  globals.document = {
+    createElement: (tagName: string) => {
+      if (tagName !== 'canvas') throw new Error(`Unexpected element request: ${tagName}`)
+      return {
+        width: 0,
+        height: 0,
+        getContext: () => ({
+          drawImage: (source: object) => {
+            drawn.push(source)
+          },
+        }),
+      }
+    },
+  }
+}
+
+function compressedTexture(name: string, width = 8, height = 4): THREE.CompressedTexture {
+  const texture = new THREE.CompressedTexture([], width, height)
+  texture.name = name
+  texture.colorSpace = THREE.NoColorSpace
+  texture.wrapS = THREE.RepeatWrapping
+  texture.wrapT = THREE.MirroredRepeatWrapping
+  texture.minFilter = THREE.NearestFilter
+  texture.magFilter = THREE.NearestFilter
+  return texture
+}
+
+afterEach(() => {
+  globals.document = previousDocument
+})
+
+describe('createExportTextureUtils', () => {
+  test('starts one renderer for every compressed texture in the export and releases it once', async () => {
+    const drawn: object[] = []
+    installCanvasDocument(drawn)
+    const fake = fakeRenderer()
+    let starts = 0
+    const utils = createExportTextureUtils(async () => {
+      starts += 1
+      return fake.renderer
+    })
+
+    const readable = await Promise.all([
+      utils.decompress(compressedTexture('NormalGL_a')),
+      utils.decompress(compressedTexture('Color_b', 16, 16)),
+      utils.decompress(compressedTexture('Rough_c', 2, 8)),
+    ])
+
+    expect(starts).toBe(1)
+    expect(fake.calls.render).toBe(3)
+    expect(fake.calls.sizes).toEqual([
+      [8, 4],
+      [16, 16],
+      [2, 8],
+    ])
+    expect(drawn).toEqual([fake.domElement, fake.domElement, fake.domElement])
+    expect(fake.renderer.outputColorSpace).toBe(THREE.SRGBColorSpace)
+
+    const first = readable[0] as THREE.CanvasTexture
+    expect(first.isCanvasTexture).toBe(true)
+    expect(first.name).toBe('NormalGL_a')
+    expect(first.colorSpace).toBe(THREE.NoColorSpace)
+    expect(first.wrapS).toBe(THREE.RepeatWrapping)
+    expect(first.wrapT).toBe(THREE.MirroredRepeatWrapping)
+    expect(first.minFilter).toBe(THREE.NearestFilter)
+    expect(first.magFilter).toBe(THREE.NearestFilter)
+
+    await utils.dispose()
+    await utils.dispose()
+    expect(fake.calls.dispose).toBe(1)
+    expect(fake.calls.destroy).toBe(1)
+  })
+
+  test('clamps the readback to maxTextureSize', async () => {
+    installCanvasDocument([])
+    const fake = fakeRenderer()
+    const utils = createExportTextureUtils(async () => fake.renderer)
+
+    const readable = await utils.decompress(compressedTexture('Color', 4096, 1024), 2048)
+
+    expect(fake.calls.sizes).toEqual([[2048, 1024]])
+    expect((readable.image as { width: number; height: number }).width).toBe(2048)
+    await utils.dispose()
+  })
+
+  test('rejects when no GPU renderer can start instead of leaving the export pending', async () => {
+    installCanvasDocument([])
+    const utils = createExportTextureUtils(async () => {
+      throw new Error('no adapter')
+    })
+
+    await expect(utils.decompress(compressedTexture('Color'))).rejects.toThrow('no adapter')
+    await expect(utils.decompress(compressedTexture('Color'))).rejects.toThrow('no adapter')
+    await expect(utils.dispose()).resolves.toBeUndefined()
+  })
+
+  test('disposing without decompressing never starts a renderer', async () => {
+    let starts = 0
+    const utils = createExportTextureUtils(async () => {
+      starts += 1
+      return fakeRenderer().renderer
+    })
+
+    await utils.dispose()
+    expect(starts).toBe(0)
+  })
+
+  test('a decompress after dispose rejects instead of starting an unowned renderer', async () => {
+    installCanvasDocument([])
+    const fake = fakeRenderer()
+    let starts = 0
+    const utils = createExportTextureUtils(async () => {
+      starts += 1
+      return fake.renderer
+    })
+
+    await utils.decompress(compressedTexture('Color'))
+    await utils.dispose()
+    await expect(utils.decompress(compressedTexture('Color'))).rejects.toThrow('abandoned')
+    await utils.dispose()
+
+    expect(starts).toBe(1)
+    expect(fake.calls.dispose).toBe(1)
+    expect(fake.calls.destroy).toBe(1)
+  })
+})