@pascal-app/editor 1.0.6 → 1.1.0

package/src/index.tsx

@@ -2,11 +2,25 @@
 // 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`.
+import { registerCompiledMessages as registerEditorMessages } from '@pascal-app/core'
+import { messages as editorEnglishMessages } from './i18n/locales/en/messages'
+
+// Published-package consumers need compiled English too: Lingui cannot
+// interpolate a raw fallback literal in production. Other bundled locales
+// remain explicitly host-registered through `@pascal-app/editor/locales`.
+registerEditorMessages('en', '', editorEnglishMessages)
+
 export {
   type ApplySceneSnapshotOptions,
   acquireSceneReadOnlyLease,
   applyScenePatch,
   applySceneSnapshot,
+  buildMeasurementAngleArcPoints,
+  type CompiledTranslationMessages,
+  closeDoorOpenState,
+  closeWindowOpenState,
+  createI18n,
+  cubicMetersToVolumeUnit,
   DEFAULT_CURVED_STAIR_INNER_RADIUS,
   DEFAULT_CURVED_STAIR_SWEEP_ANGLE,
   DEFAULT_SPIRAL_SHOW_CENTER_COLUMN,
@@ -22,6 +36,37 @@ export {
   DEFAULT_STAIR_THICKNESS,
   DEFAULT_STAIR_TYPE,
   DEFAULT_STAIR_WIDTH,
+  defaultI18n,
+  formatAngleRadians,
+  formatAreaLabel,
+  formatLength,
+  formatLinearMeasurement,
+  formatNumber,
+  formatVolumeLabel,
+  getAreaUnitLabel,
+  getDisplayedDoorValue,
+  getDisplayedWindowShutterValue,
+  getDisplayedWindowValue,
+  getLinearUnitLabel,
+  getLocale,
+  getVolumeUnitLabel,
+  isOperableWindowType,
+  type LinearUnit,
+  linearControlValueToMeters,
+  linearUnitToMeters,
+  metersToLinearUnit,
+  normalizeDecimalInput,
+  openDoorOpenState,
+  openWindowOpenState,
+  type PascalI18n,
+  PascalI18nProvider,
+  parseLinearMeasurementInput,
+  parseLocalizedNumber,
+  registerCompiledMessages,
+  registerMessages,
+  resolveElevatorNodeSupportY,
+  resolveElevatorSupportLevelId,
+  resolveElevatorSupportY,
   type SceneCommit,
   type SceneCommitListener,
   type SceneCommitOrigin,
@@ -29,10 +74,31 @@ export {
   type SceneNodePatch,
   type ScenePatch,
   type SceneSnapshot,
+  separatorFloorElevation,
+  setLocale,
+  setWindowShuttersOpenState,
+  squareMetersToAreaUnit,
+  subscribe,
   subscribeSceneCommits,
+  type TranslationMessage,
+  type TranslationMessages,
+  type TranslationParams,
+  translate,
+  useLocale,
+  usePascalI18n,
   useScene,
+  type WindowOpenAnimationOptions,
+  type WindowShutterField,
 } from '@pascal-app/core'
-export { useViewer } from '@pascal-app/viewer'
+export {
+  MEASUREMENT_ACTIVE_COLOR,
+  MEASUREMENT_DANGLING_COLOR,
+  MEASUREMENT_PERSISTENT_COLOR,
+  measurementPolygonLabelAnchor,
+  measurementPresentationColor,
+  triangulateMeasurementPolygon,
+  useViewer,
+} from '@pascal-app/viewer'
 export type { EditorProps } from './components/editor'
 export { default as Editor } from './components/editor'
 export { ActionMenuButton } from './components/editor/action-menu-button'
@@ -68,6 +134,7 @@ export { FloatingActionMenu as FloatingMenu } from './components/editor/floating
 // flags. Tools place onto `useViewer.selection.levelId`, so the host must set a
 // building + level selection first.
 export { EDITOR_GRID_INPUT_NAME, Grid } from './components/editor/grid'
+export { Html as LocalizedHtml } from './components/editor/localized-html'
 export {
   DimensionPill,
   type DimensionPillPart,
@@ -98,12 +165,15 @@ export {
 } from './components/editor/node-arrow-handles'
 export { QuickMeasurementCard } from './components/editor/quick-measurement-card'
 export { SelectionManager } from './components/editor/selection-manager'
+export { SeparatorEndGrip } from './components/editor/separator-end-grip'
 export {
   type SnapshotCameraData,
   ThumbnailGenerator,
 } from './components/editor/thumbnail-generator'
 export { PLUGINS_VIEW_ID } from './components/editor/views/use-editor-views'
 export { WallMoveSideHandles } from './components/editor/wall-move-side-handles'
+export { WallPushArrow } from './components/editor/wall-push-arrow'
+export { useWallsBelowSetting } from './components/editor-2d/floorplan-adjacent-walls-layer'
 export { useFloorplanRender } from './components/editor-2d/floorplan-render-context'
 export { FloorplanDimensionRenderer } from './components/editor-2d/renderers/floorplan-dimension-renderer'
 export {
@@ -124,6 +194,7 @@ export {
   buildSvgArrowHeadPoints,
   getArcPlanPoint,
 } from './components/editor-2d/svg-paths'
+export { useCeilingsSetting } from './components/systems/ceiling/ceiling-system'
 export type {
   SelectionAffordanceHistoryApi,
   SelectionAffordanceInteractionApi,
@@ -154,7 +225,11 @@ export {
   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 {
+  type RegistryToolContextValue,
+  RegistryToolProvider,
+  useRegistryToolContext,
+} from './components/tools/registry-tool-context'
 export { CursorSphere } from './components/tools/shared/cursor-sphere'
 export {
   DRAFT_LABEL_Y_OFFSET,
@@ -171,6 +246,7 @@ export {
   resolveLevelConstructionPlane,
 } from './components/tools/shared/horizontal-construction-plane'
 export { PlacementBox } from './components/tools/shared/placement-box'
+export { PlacementCoordinateInput } from './components/tools/shared/placement-coordinate-input'
 export { PlacementDimensionGuides } from './components/tools/shared/placement-dimension-guides'
 // Pointer-decided support surface (deck top vs floor underneath) — the
 // draw tools (wall / fence) ride their grid plane and commit cap on it.
@@ -186,7 +262,6 @@ export {
   type PolygonEditorProps,
 } from './components/tools/shared/polygon-editor'
 export {
-  formatAngleRadians,
   getAngleArcToSegmentReference,
   getAngleToSegmentReference,
   getSegmentAngleReferenceAtPoint,
@@ -195,6 +270,7 @@ export {
 export { preloadRegistryToolModules, ToolManager } from './components/tools/tool-manager'
 export {
   chainEndJoinsExistingWall,
+  createInvisibleWallOnCurrentLevel,
   createWallOnCurrentLevel,
   findWallSnapTarget,
   getSegmentGridStep,
@@ -212,6 +288,26 @@ export {
   type WallPlanPoint,
   type WallSnapRadii,
 } from './components/tools/wall/wall-drafting'
+export {
+  lockWallPullDirection,
+  snapWallPullPoint,
+  WALL_PULL_ANGLE_STEP,
+  WALL_PULL_LOCK_TOLERANCE,
+  WALL_PULL_SNAP_LABELS,
+  WALL_PULL_SNAP_RADII,
+  type WallPullDirectionLock,
+  type WallPullGuide,
+  type WallPullGuideKind,
+  type WallPullSnapInput,
+  type WallPullSnapKind,
+  type WallPullSnapRadii,
+  type WallPullSnapResult,
+} from './components/tools/wall/wall-pull-snap'
+export {
+  formatWallDraftHeading,
+  resolveTypedWallEnd,
+  wallDraftHeadingDegrees,
+} from './components/tools/wall/wall-typed-entry'
 // `ToolbarLeft` / `ToolbarRight` alias `ViewerToolbarLeft` / `ViewerToolbarRight`
 // (same components) under the names headless hosts compose their toolbars with.
 export {
@@ -234,6 +330,8 @@ export {
 } from './components/ui/build-panel/build-panel'
 export { useCommandPalette } from './components/ui/command-palette'
 export { ActionButton, ActionGroup } from './components/ui/controls/action-button'
+// A finish row in a node panel: the paint tool's picker and its write for one paint role.
+export { FinishSwatch } from './components/ui/controls/finish-swatch'
 export {
   MaterialPaintPanel,
   type MaterialPaintPanelProps,
@@ -275,13 +373,17 @@ export { applyMultiHeightMode } from './components/ui/panels/multi-height-mode'
 // a kind-owned panel and need PanelWrapper for the chrome.
 export { PanelWrapper } from './components/ui/panels/panel-wrapper'
 export { ParametricInspector as Inspector } from './components/ui/panels/parametric-inspector'
+// A floor's script (a room's, a slab's): its code to read and a way to take it off.
+export { ScriptedFinishRow } from './components/ui/panels/room-panel'
 export { ShapeChoice } from './components/ui/panels/shape-choice'
 export { WallPaintRegionList } from './components/ui/panels/wall-region-list'
 export { PALETTE_COLORS } from './components/ui/primitives/color-dot'
 export {
   DropdownMenu,
   DropdownMenuContent,
+  DropdownMenuGroup,
   DropdownMenuItem,
+  DropdownMenuLabel,
   DropdownMenuSeparator,
   DropdownMenuSub,
   DropdownMenuSubContent,
@@ -316,6 +418,8 @@ export {
   SnapTargetBadge,
   SnapTargetIcon,
 } from './components/ui/snap-target-badge'
+// A wall's project wall types: new, edit, duplicate (the wall panel's Assembly).
+export { WallTypeMenu } from './components/ui/wall-type/wall-type-menu'
 export {
   FloorplanCompassButton,
   type FloorplanCompassButtonProps,
@@ -325,7 +429,14 @@ export {
   type FloorplanPreviewProps,
   type FloorplanPreviewScene,
 } from './components/viewer/floorplan-preview'
+export {
+  DaylightMenu,
+  EdgesToggleItem,
+  QualityMenu,
+} from './components/viewer/render-settings-menu'
+export { openSkyPanel, SkyControl, useSkyPanel } from './components/viewer/sky-control'
 export { useViewerCameraNavigationSync } from './components/viewer/use-viewer-camera-navigation-sync'
+export { useViewerUiSounds } from './components/viewer/use-viewer-ui-sounds'
 export {
   ViewerControlsBar,
   type ViewerControlsBarProps,
@@ -351,6 +462,7 @@ export {
   type ViewerStageSwitcherProps,
 } from './components/viewer/viewer-stage-switcher'
 export {
+  DroneHud,
   WalkthroughHud,
   type WalkthroughHudProps,
   type WalkthroughInteract,
@@ -366,6 +478,18 @@ export { usePlacementNotice } from './hooks/use-placement-notice'
 export { useReducedMotion } from './hooks/use-reduced-motion'
 export { useSelectedRoom } from './hooks/use-selected-room'
 export { type Selection, useSelection } from './hooks/use-selection'
+export { localizedLevelName } from './i18n/level-name'
+export {
+  messageSlug,
+  nodeDescriptionDescriptor,
+  nodeLabel,
+  nodeLabelDescriptor,
+  toolHintChipLabel,
+  toolHintDescriptor,
+  toolHintKey,
+  toolHintLabel,
+} from './i18n/node-messages'
+export { sceneThemeName } from './i18n/scene-theme-name'
 export {
   clearPlacementSurface,
   getPlacementSurface,
@@ -396,7 +520,12 @@ export {
   resolveCeilingPlanPointSnap,
 } from './lib/ceiling-plan-snap'
 export { EDITOR_LAYER } from './lib/constants'
-export type { ContextualShortcutHint } from './lib/contextual-help'
+export {
+  AXIS_MOVE_DRAG_LABEL,
+  type ContextualShortcutHint,
+  PATH_POINT_DRAG_LABEL,
+  ROTATE_HANDLE_DRAG_LABEL,
+} from './lib/contextual-help'
 export {
   CONTEXTUAL_HELP_NODE_EXTENSION_KEY,
   type ContextualHelpNodeExtension,
@@ -411,11 +540,6 @@ export {
   nextContinuation,
 } from './lib/continuation'
 export { canDirectMoveNode } from './lib/direct-manipulation'
-export {
-  closeDoorOpenState,
-  getDisplayedDoorValue,
-  openDoorOpenState,
-} from './lib/door-interaction'
 export { downloadProjectFile } from './lib/download-project-file'
 export { createEditorApi } from './lib/editor-api'
 export {
@@ -437,12 +561,7 @@ export {
   resolveElevationSnapMatch,
   resolveStructuralElevationSnap,
 } from './lib/elevation-guides'
-export {
-  resolveCurrentBuildingId,
-  resolveElevatorNodeSupportY,
-  resolveElevatorSupportLevelId,
-  resolveElevatorSupportY,
-} from './lib/elevator-support'
+export { resolveCurrentBuildingId } from './lib/elevator-support'
 export type { ExportTextureUtils } from './lib/export-texture-utils'
 export { getFloatingMenuScale } from './lib/floating-menu-scale'
 export { startOpeningDraft } from './lib/floor-opening-draft'
@@ -491,6 +610,7 @@ export {
   type FloorplanSchedule,
   type FloorplanToolContext,
   type FloorplanToolMode,
+  type FloorplanWallDimensionFaces,
   floorplanGeometryMetadata,
   getFloorplanNodeExtension,
   readFloorplanContext,
@@ -584,6 +704,11 @@ export {
   editorFinishScriptHost,
   finishScriptCode,
 } from './lib/geometry-script/finish-scripts'
+export {
+  beginGesture,
+  type GestureCancelReason,
+  type GestureHandle,
+} from './lib/gesture-lifecycle'
 export { exportSceneToGlb, type GlbExportOptions } from './lib/glb-export'
 export {
   type EditorGridEvent,
@@ -620,6 +745,11 @@ export {
   scopeNodeId,
 } from './lib/interaction/scope'
 export { isEditableKeyboardTarget } from './lib/keyboard-pan'
+export {
+  formatLayerDepth,
+  formatLayerThickness,
+  parseLayerThickness,
+} from './lib/layer-thickness'
 export { selectPlacedNode } from './lib/level-selection'
 // Lot drop-in — address → parcel → streets → front edge → setbacks, on the
 // site node, through the parcel provider the host sets.
@@ -664,10 +794,6 @@ export {
   isCreatableMeasurementKind,
   normalizeCreatableMeasurementKind,
 } from './lib/measurement-kind'
-export {
-  measurementPolygonLabelAnchor,
-  triangulateMeasurementPolygon,
-} from './lib/measurement-label'
 export {
   type LingoUnitSpec,
   lingoUnitSpec,
@@ -677,25 +803,8 @@ export {
   parseMeasurement,
 } from './lib/measurement-parser'
 export {
-  buildMeasurementAngleArcPoints,
-  cubicMetersToVolumeUnit,
-  formatAreaLabel,
-  formatLinearMeasurement,
-  formatVolumeLabel,
-  getAreaUnitLabel,
-  getLinearUnitLabel,
-  getVolumeUnitLabel,
-  type LinearUnit,
-  linearControlValueToMeters,
-  linearUnitToMeters,
-  MEASUREMENT_ACTIVE_COLOR,
-  MEASUREMENT_DANGLING_COLOR,
   MEASUREMENT_FLOORPLAN_COLOR,
-  MEASUREMENT_PERSISTENT_COLOR,
   measurementFloorplanPresentationColor,
-  measurementPresentationColor,
-  metersToLinearUnit,
-  squareMetersToAreaUnit,
 } from './lib/measurements'
 export type {
   ModelExport,
@@ -713,6 +822,7 @@ export {
 } from './lib/paint-scope'
 export {
   getNodePanelModel,
+  type MultiPanelControl,
   type NodePanelModel,
   PANEL_MODEL_EXTENSION,
   type PanelAction,
@@ -773,7 +883,13 @@ export { clearRoofDuplicateMetadata, duplicateRoofSubtree } from './lib/roof-dup
 // kind-owned door / window tools in `@pascal-app/nodes` and the item
 // placement coordinator's roof-wall strategy.
 export { hasRoofFaceChildOverlap, type RoofWallHit, resolveRoofWallHit } from './lib/roof-wall-hit'
-export { WALL_PUSH_AFFORDANCE, type WallPushArrowPayload } from './lib/room-handle-drag'
+export {
+  selectedWallDimensions,
+  separatorPushHandles,
+  WALL_PUSH_AFFORDANCE,
+  type WallPushArrowPayload,
+} from './lib/room-handle-drag'
+export { displayRoomName } from './lib/room-name-messages'
 export type { RoomKey, RoomSelectionRecord } from './lib/room-selection'
 export { popRoomSelection, selectRoom } from './lib/room-selection-commands'
 export {
@@ -790,8 +906,13 @@ export {
   remapSceneMaterialRefs,
   sceneMaterialUsageCounts,
 } from './lib/scene-material-refs'
+export {
+  beginSeparatorEndDrag,
+  runSeparatorEndDrag,
+  type SeparatorEndDrag,
+} from './lib/separator-edit'
 export { movementSfxStepKey } from './lib/sfx/movement-tick'
-export { emitDeleteSFX, triggerSFX } from './lib/sfx-bus'
+export { emitDeleteSFX, initSFXBus, triggerSFX } from './lib/sfx-bus'
 export { playSFX, type SFXName, type SFXPlaybackOptions } from './lib/sfx-player'
 export { showSidebarPanel } from './lib/sidebar-panel'
 export {
@@ -848,6 +969,7 @@ export {
   sculptFieldForSite,
   terrainPointInsideSite,
 } from './lib/terrain-sculpt'
+export { withToolShortcut } from './lib/tool-shortcuts'
 export { isTypingTarget } from './lib/typing-target'
 export { enterUnitFocus } from './lib/units'
 export { exportSceneToUsdz, type UsdzExportOptions } from './lib/usdz-export'
@@ -868,10 +990,27 @@ export {
 } from './lib/viewer-selection'
 export {
   getWallDrawVariant,
+  getWallLineKind,
+  INVISIBLE_WALL_DRAFT_THICKNESS,
+  invisibleWallDraftSnapLines,
   selectWallDrawVariant,
+  selectWallKind,
+  useWallDraftThickness,
   useWallDrawVariant,
+  useWallKind,
+  WALL_KINDS,
   type WallDrawVariant,
+  type WallKind,
+  type WallLineKind,
 } from './lib/wall-draw-variant'
+export {
+  nearestWallParallelTarget,
+  nudgeWallPosition,
+  publishWallParallelGuide,
+  WALL_PARALLEL_SNAP_RADIUS,
+  type WallParallelTarget,
+  wallParallelTargets,
+} from './lib/wall-parallel-snap'
 export {
   createWallPointerTracker,
   wallPointerInParent,
@@ -884,13 +1023,33 @@ export {
   startWallPolygonDraft,
   wallPolygonDraftWalls,
 } from './lib/wall-polygon-draft'
-export { writeWindowChanges } from './lib/window-changes'
 export {
-  closeWindowOpenState,
-  getDisplayedWindowValue,
-  isOperableWindowType,
-  openWindowOpenState,
-} from './lib/window-interaction'
+  endWallPullRun,
+  releaseWallPullDrag,
+  startWallPull,
+  useWallPullRun,
+  WALL_PULL_AFFORDANCE,
+  WALL_PULL_GRIP_TITLE,
+  type WallPullGripPayload,
+  type WallPullRun,
+  wallDraftIsRun,
+  wallPullSeed,
+  wallPullTypePatch,
+} from './lib/wall-pull'
+export {
+  isWallRunFree,
+  publishWallRunFeedback,
+  snapWallRunDraftPoint,
+  wallRunDirection,
+} from './lib/wall-run-snap'
+export {
+  deleteProjectWallType,
+  saveProjectWallType,
+  useProjectWallTypes,
+  type WallTypePlacement,
+  wallTypePlacementOf,
+} from './lib/wall-type'
+export { writeWindowChanges } from './lib/window-changes'
 export {
   getActiveBuildingPose,
   projectAlignmentGuidesWorldToActiveBuildingLocal,
@@ -900,7 +1059,11 @@ export {
   snapWorldXZForActiveBuilding,
 } from './lib/world-grid-snap'
 export { subscribeCameraPose } from './store/camera-pose-store'
-export { default as useAlignmentGuides } from './store/use-alignment-guides'
+export {
+  type DraftGuideLine,
+  type DraftGuides,
+  default as useAlignmentGuides,
+} from './store/use-alignment-guides'
 export { default as useAudio } from './store/use-audio'
 export { type CameraHintAction, useCameraHintFocus } from './store/use-camera-hint-focus'
 export { type CommandAction, useCommandRegistry } from './store/use-command-registry'
@@ -1009,6 +1172,22 @@ export {
   default as usePlacementPreview,
   type PlacementPreviewDimension,
 } from './store/use-placement-preview'
+export {
+  isPlacementTypingKey,
+  isPlacementTypingStartKey,
+  PLACEMENT_TYPING_DISTANCE_OFFSET,
+  PLACEMENT_TYPING_LENGTH_ANGLE,
+  type PlacementTypingField,
+  type PlacementTypingKeyOptions,
+  type PlacementTypingKeyOutcome,
+  type PlacementTypingProjection,
+  type PlacementTypingSession,
+  type PlacementTypingState,
+  type PlacementTypingValues,
+  placementTypingLengthOptions,
+  routePlacementTypingKey,
+  usePlacementTyping,
+} from './store/use-placement-typing'
 export { usePointAsk } from './store/use-point-ask'
 export {
   activateQuickMeasurementHudSource,

package/src/lib/add-storey.test.ts

@@ -145,11 +145,11 @@ describe('setGroundFloor', () => {
 
   const standing = (id: string) => levelGradeStanding(useScene.getState().nodes, id)
 
-  test('seats the building so the level stands 8 in over grade, the ones under it below it, in one undo step', () => {
+  test('seats the building so the level stands on grade, the ones under it below it, in one undo step', () => {
     expect(standing('level_lower')).toBe('at-grade')
     expect(setGroundFloor('level_reception' as LevelNode['id'])).toBe(true)
     const nodes = useScene.getState().nodes
-    expect((nodes[BUILDING as AnyNodeId] as BuildingNode).position).toEqual([0, -3.197, 0])
+    expect((nodes[BUILDING as AnyNodeId] as BuildingNode).position).toEqual([0, -3.4, 0])
     expect((nodes[BUILDING as AnyNodeId] as BuildingNode).groundLevelId).toBe('level_reception')
     expect(standing('level_reception')).toBe('at-grade')
     expect(standing('level_lower')).toBe('below-grade')
@@ -172,6 +172,6 @@ describe('setGroundFloor', () => {
     const basement = addStoreyBelow(BUILDING)
     expect(basement.level).toBe(-3)
     expect(standing(basement.id)).toBe('below-grade')
-    expect(levelFloorWorldY(useScene.getState().nodes, 'level_reception')).toBeCloseTo(0.203, 9)
+    expect(levelFloorWorldY(useScene.getState().nodes, 'level_reception')).toBeCloseTo(0, 9)
   })
 })

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

@@ -1,5 +1,24 @@
 import { describe, expect, test } from 'bun:test'
-import { resolveRotateHandleHelpHints, resolveSelectModeHelpHints } from './contextual-help'
+import type { MessageDescriptor } from '@pascal-app/core'
+import {
+  type ContextualShortcutHint,
+  resolveRotateHandleHelpHints as rotateHints,
+  resolveSelectModeHelpHints as selectHints,
+} from './contextual-help'
+
+// Hints carry message descriptors; these tests read their English.
+const text = (value: MessageDescriptor | string) =>
+  typeof value === 'string' ? value : value.message
+const english = (hints: ContextualShortcutHint[]) =>
+  hints.map(({ label, subtitle, ...hint }) => ({
+    ...hint,
+    label: text(label),
+    ...(subtitle ? { subtitle: text(subtitle) } : {}),
+  }))
+const resolveRotateHandleHelpHints = (...args: Parameters<typeof rotateHints>) =>
+  english(rotateHints(...args))
+const resolveSelectModeHelpHints = (...args: Parameters<typeof selectHints>) =>
+  english(selectHints(...args))
 
 test('rotation advertises Alt as the temporary free-rotation override', () => {
   expect(resolveRotateHandleHelpHints(false)).toEqual([