pcb-scene3d-viewer 1.1.21 → 1.1.31

package/src/PcbScene3dPadFactory.mjs

@@ -314,12 +314,12 @@ export class PcbScene3dPadFactory {
 
     /**
      * Returns true when one pad has visible copper on the requested face.
-     * @param {{ sizeTopX?: number, sizeTopY?: number, sizeMidX?: number, sizeMidY?: number, sizeBottomX?: number, sizeBottomY?: number, holeDiameter?: number, hasTopSolderMaskOpening?: boolean, hasBottomSolderMaskOpening?: boolean }} pad
+     * @param {{ sizeTopX?: number, sizeTopY?: number, sizeMidX?: number, sizeMidY?: number, sizeBottomX?: number, sizeBottomY?: number, holeDiameter?: number, hasTopSolderMaskOpening?: boolean, hasBottomSolderMaskOpening?: boolean, hasTopPasteMaskOpening?: boolean, hasBottomPasteMaskOpening?: boolean }} pad
      * @param {'top' | 'bottom'} side
      * @returns {boolean}
      */
     static #hasVisibleSurface(pad, side) {
-        const maskOpening = PcbScene3dPadFactory.#resolveSolderMaskOpening(
+        const maskOpening = PcbScene3dPadFactory.#resolveSurfaceOpening(
             pad,
             side
         )
@@ -350,6 +350,39 @@ export class PcbScene3dPadFactory {
         )
     }
 
+    /**
+     * Resolves an explicit side-specific surface opening flag.
+     * @param {{ hasTopSolderMaskOpening?: boolean, hasBottomSolderMaskOpening?: boolean, hasTopPasteMaskOpening?: boolean, hasBottomPasteMaskOpening?: boolean }} pad
+     * @param {'top' | 'bottom'} side
+     * @returns {boolean | null}
+     */
+    static #resolveSurfaceOpening(pad, side) {
+        const solderMaskOpening =
+            PcbScene3dPadFactory.#resolveSolderMaskOpening(pad, side)
+        if (solderMaskOpening !== null) {
+            return solderMaskOpening
+        }
+
+        const pasteFieldName =
+            side === 'bottom'
+                ? 'hasBottomPasteMaskOpening'
+                : 'hasTopPasteMaskOpening'
+        const alternatePasteFieldName =
+            side === 'bottom'
+                ? 'hasTopPasteMaskOpening'
+                : 'hasBottomPasteMaskOpening'
+
+        if (typeof pad?.[pasteFieldName] === 'boolean') {
+            if (pad[pasteFieldName]) {
+                return true
+            }
+
+            return pad?.[alternatePasteFieldName] === true ? false : null
+        }
+
+        return null
+    }
+
     /**
      * Resolves an explicit side-specific solder-mask opening when available.
      * @param {{ hasTopSolderMaskOpening?: boolean, hasBottomSolderMaskOpening?: boolean }} pad

package/src/PcbScene3dRenderGroupVisibility.mjs

@@ -37,9 +37,16 @@ export class PcbScene3dRenderGroupVisibility {
             state?.groups?.get('copper'),
             boardAssemblyActive
         )
+        const showFallbackBodies =
+            !boardAssemblyActive &&
+            (Boolean(state?.toggles?.['fallback-bodies']) ||
+                PcbScene3dFallbackVisibility.hasVisibleExternalCompanion(
+                    state?.fallbackBodyRoots,
+                    state?.toggles
+                ))
         PcbScene3dRenderGroupVisibility.#setVisible(
             state?.groups?.get('fallback-bodies'),
-            Boolean(state?.toggles?.['fallback-bodies']) && !boardAssemblyActive
+            showFallbackBodies
         )
 
         PcbScene3dFallbackVisibility.applyVisibility(

package/src/PcbScene3dRuntime.mjs

@@ -1,27 +1,31 @@
 import { PcbScene3dBoardSolderMaskFactory } from './PcbScene3dBoardSolderMaskFactory.mjs'
-import { PcbScene3dBodyColor } from './PcbScene3dBodyColor.mjs'
 import { PcbScene3dCameraRig } from './PcbScene3dCameraRig.mjs'
 import { PcbScene3dCircuitJsonAdapter } from './PcbScene3dCircuitJsonAdapter.mjs'
 import { PcbScene3dComponentVisibility } from './PcbScene3dComponentVisibility.mjs'
 import { PcbScene3dComponentAdjustment } from './PcbScene3dComponentAdjustment.mjs'
 import { PcbScene3dComponentAdjustmentRegistry } from './PcbScene3dComponentAdjustmentRegistry.mjs'
+import { PcbScene3dCompanionBasePlacementAdjuster } from './PcbScene3dCompanionBasePlacementAdjuster.mjs'
 import { PcbScene3dCopperDetailGroupBuilder } from './PcbScene3dCopperDetailGroupBuilder.mjs'
 import { PcbScene3dCopperFactory } from './PcbScene3dCopperFactory.mjs'
 import { PcbScene3dDetailCoordinateNormalizer } from './PcbScene3dDetailCoordinateNormalizer.mjs'
 import { PcbScene3dDrillVoidFactory } from './PcbScene3dDrillVoidFactory.mjs'
+import { PcbScene3dExternalCompanionFallback } from './PcbScene3dExternalCompanionFallback.mjs'
 import { PcbScene3dExternalModels } from './PcbScene3dExternalModels.mjs'
+import { PcbScene3dFallbackBodyFactory } from './PcbScene3dFallbackBodyFactory.mjs'
 import { PcbScene3dFallbackVisibility } from './PcbScene3dFallbackVisibility.mjs'
 import { PcbScene3dInteractionHints } from './PcbScene3dInteractionHints.mjs'
-import { PcbScene3dMountRig } from './PcbScene3dMountRig.mjs'
 import { PcbScene3dModelSearchPlacement } from './PcbScene3dModelSearchPlacement.mjs'
 import { PcbScene3dPresetState } from './PcbScene3dPresetState.mjs'
 import { PcbScene3dRenderGroupVisibility } from './PcbScene3dRenderGroupVisibility.mjs'
 import { PcbScene3dRenderScheduler } from './PcbScene3dRenderScheduler.mjs'
 import { PcbScene3dRuntimeBoardMeshes } from './PcbScene3dRuntimeBoardMeshes.mjs'
+import { PcbScene3dRuntimeHelpers } from './PcbScene3dRuntimeHelpers.mjs'
 import { PcbScene3dSilkscreenChunkedFactory } from './PcbScene3dSilkscreenChunkedFactory.mjs'
 import { PcbScene3dTrueTypeTextFactory } from './PcbScene3dTrueTypeTextFactory.mjs'
 import { PcbScene3dSelectionResolver } from './PcbScene3dSelectionResolver.mjs'
+import { PcbScene3dSelectionMarkerOverlay } from './PcbScene3dSelectionMarkerOverlay.mjs'
 import { PcbScene3dSelectionStyler } from './PcbScene3dSelectionStyler.mjs'
+import { PcbScene3dStaticBodyFactory } from './PcbScene3dStaticBodyFactory.mjs'
 import { PcbScene3dViewportResize } from './PcbScene3dViewportResize.mjs'
 import { PcbScene3dViewScale } from './PcbScene3dViewScale.mjs'
 const SILKSCREEN_COPPER_CLEARANCE_MIL = 0.12
@@ -37,6 +41,7 @@ const Z_MIL = {
 export class PcbScene3dRuntime {
     #viewportNode
     #sceneDescription
+    #placementSceneDescription
     #hooks
     #toggles
     #groups
@@ -59,6 +64,7 @@ export class PcbScene3dRuntime {
     #fallbackBodyRoots
     #loadedExternalModelDesignators
     #modelSearchExternalModelRoots
+    #selectionMarkerOverlay
     #hasLoadedBoardAssemblyModel
     #selectedDesignator
     #initialRadius
@@ -78,6 +84,8 @@ export class PcbScene3dRuntime {
             PcbScene3dRuntime.#normalizeSceneDescription(sceneDescription)
         this.#viewportNode = viewportNode
         this.#sceneDescription = renderModel
+        this.#placementSceneDescription =
+            PcbScene3dCompanionBasePlacementAdjuster.adjust(renderModel)
         this.#hooks = hooks
         this.#toggles = {
             'external-models': true,
@@ -106,6 +114,7 @@ export class PcbScene3dRuntime {
         this.#fallbackBodyRoots = new Map()
         this.#loadedExternalModelDesignators = new Set()
         this.#modelSearchExternalModelRoots = new Set()
+        this.#selectionMarkerOverlay = null
         this.#hasLoadedBoardAssemblyModel = false
         this.#selectedDesignator = ''
         this.#initialRadius =
@@ -175,6 +184,7 @@ export class PcbScene3dRuntime {
             return
         }
         this.#applyToggleVisibility()
+        this.#updateSelectionMarker()
         this.#render()
     }
     /** @param {string} designator @returns {boolean} */
@@ -236,6 +246,7 @@ export class PcbScene3dRuntime {
         this.#fallbackBodyRoots.clear()
         this.#loadedExternalModelDesignators.clear()
         this.#modelSearchExternalModelRoots.clear()
+        this.#selectionMarkerOverlay = null
         this.#hasLoadedBoardAssemblyModel = false
         this.#selectedDesignator = ''
         this.#groups.clear()
@@ -385,20 +396,69 @@ export class PcbScene3dRuntime {
         this.#groups.set('copper', copperGroup)
         this.#rootGroup.add(copperGroup)
         const fallbackBodiesGroup = new THREE.Group()
+        const staticBodiesGroup = new THREE.Group()
         const externalModelsGroup = new THREE.Group()
+        const selectionMarkerGroup = new THREE.Group()
         this.#sceneDescription.components.forEach((component) => {
-            const fallbackBody = this.#buildFallbackBody(component)
-            fallbackBodiesGroup.add(fallbackBody)
+            if (component?.renderFallbackBody === false) {
+                return
+            }
+
+            const isCompanionBase =
+                PcbScene3dExternalCompanionFallback.shouldKeepFallback(
+                    this.#sceneDescription,
+                    component
+                )
+            const fallbackBody = PcbScene3dFallbackBodyFactory.build(
+                THREE,
+                component,
+                { companionBase: isCompanionBase }
+            )
+            if (isCompanionBase) {
+                fallbackBody.rootGroup.userData.scene3dFallbackExternalCompanion = true
+            }
+            fallbackBodiesGroup.add(fallbackBody.rootGroup)
             PcbScene3dFallbackVisibility.registerFallbackRoot(
                 this.#fallbackBodyRoots,
                 component?.designator,
-                fallbackBody
+                fallbackBody.rootGroup
+            )
+            this.#registerSelectionRoot(
+                component?.designator,
+                fallbackBody.rootGroup
+            )
+            this.#componentAdjustmentRegistry.register(
+                component?.designator,
+                fallbackBody.adjustmentGroup
+            )
+        })
+        PcbScene3dStaticBodyFactory.buildMany(
+            THREE,
+            this.#placementSceneDescription.staticBodyPlacements
+        ).forEach((staticBody) => {
+            const selectionKey =
+                PcbScene3dStaticBodyFactory.resolveSelectionKey(
+                    staticBody.placement
+                )
+            staticBodiesGroup.add(staticBody.rootGroup)
+            this.#registerSelectionRoot(selectionKey, staticBody.rootGroup)
+            this.#componentAdjustmentRegistry.register(
+                selectionKey,
+                staticBody.adjustmentGroup
             )
         })
         this.#groups.set('fallback-bodies', fallbackBodiesGroup)
+        this.#groups.set('static-bodies', staticBodiesGroup)
         this.#groups.set('external-models', externalModelsGroup)
+        this.#groups.set('selection-marker', selectionMarkerGroup)
+        this.#selectionMarkerOverlay = new PcbScene3dSelectionMarkerOverlay(
+            selectionMarkerGroup
+        )
         this.#rootGroup.add(fallbackBodiesGroup)
+        this.#rootGroup.add(staticBodiesGroup)
         this.#rootGroup.add(externalModelsGroup)
+        this.#rootGroup.add(selectionMarkerGroup)
+        this.#updateSelectionMarker()
         const boardSpan = Math.max(board.widthMil, board.heightMil, 1)
         this.#scene.fog = new THREE.Fog(
             0xf4f0ea,
@@ -442,7 +502,7 @@ export class PcbScene3dRuntime {
      */
     async #loadDeferredDetail() {
         try {
-            await PcbScene3dRuntime.#yieldToNextFrame()
+            await PcbScene3dRuntimeHelpers.yieldToNextFrame(globalThis)
             if (this.#isDisposed) {
                 return
             }
@@ -450,7 +510,7 @@ export class PcbScene3dRuntime {
             await this.#loadDeferredSilkscreen()
             this.#render()
 
-            await PcbScene3dRuntime.#yieldToNextFrame()
+            await PcbScene3dRuntimeHelpers.yieldToNextFrame(globalThis)
             if (this.#isDisposed) {
                 return
             }
@@ -459,7 +519,7 @@ export class PcbScene3dRuntime {
             this.#applyToggleVisibility()
             this.#render()
             this.#settleReady()
-            await PcbScene3dRuntime.#yieldToNextFrame()
+            await PcbScene3dRuntimeHelpers.yieldToNextFrame(globalThis)
             if (this.#isDisposed) {
                 return
             }
@@ -503,7 +563,8 @@ export class PcbScene3dRuntime {
             (x, y) => this.#normalizeDetailPoint(x, y),
             {
                 shouldContinue: () => !this.#isDisposed,
-                yieldToMain: () => PcbScene3dRuntime.#yieldToNextFrame()
+                yieldToMain: () =>
+                    PcbScene3dRuntimeHelpers.yieldToNextFrame(globalThis)
             }
         )
         if (this.#isDisposed) return
@@ -536,63 +597,6 @@ export class PcbScene3dRuntime {
         }
     }
 
-    /**
-     * Builds one procedural fallback body mesh.
-     * @param {{ positionMil: { x: number, y: number, z: number }, rotationDeg: number, mountSide: string, body: { family: string, sizeMil: { width: number, depth: number, height: number } } }} component
-     * @returns {any}
-     */
-    #buildFallbackBody(component) {
-        const THREE = this.#three
-        const family = component.body.family
-        const size = component.body.sizeMil
-        const material = new THREE.MeshStandardMaterial({
-            color: PcbScene3dBodyColor.resolve(family),
-            roughness: 0.72,
-            metalness: family === 'chip' ? 0.12 : 0.08
-        })
-
-        let mesh
-        if (family === 'radial-capacitor' || family === 'test-point') {
-            mesh = new THREE.Mesh(
-                new THREE.CylinderGeometry(
-                    size.width / 2,
-                    size.width / 2,
-                    size.height,
-                    28
-                ),
-                material
-            )
-        } else {
-            mesh = new THREE.Mesh(
-                new THREE.BoxGeometry(size.width, size.depth, size.height),
-                material
-            )
-        }
-
-        const mountRig = PcbScene3dMountRig.create(THREE, component)
-        const rootGroup = mountRig.rootGroup
-        const adjustmentGroup = new THREE.Group()
-
-        rootGroup.userData.scene3dSelection = {
-            designator: String(component?.designator || 'component'),
-            sourceType: 'component'
-        }
-        adjustmentGroup.userData.scene3dAdjustmentTarget = true
-        adjustmentGroup.userData.scene3dAdjustmentDesignator = String(
-            component?.designator || 'component'
-        )
-        adjustmentGroup.userData.scene3dAdjustmentBaseline =
-            PcbScene3dComponentAdjustment.neutral()
-        this.#registerSelectionRoot(component?.designator, rootGroup)
-        this.#componentAdjustmentRegistry.register(
-            component?.designator,
-            adjustmentGroup
-        )
-        adjustmentGroup.add(mesh)
-        mountRig.faceGroup.add(adjustmentGroup)
-        return rootGroup
-    }
-
     /**
      * Attempts to load any resolved external 3D models.
      * @returns {Promise<void>}
@@ -605,7 +609,7 @@ export class PcbScene3dRuntime {
 
         const diagnostics = await PcbScene3dExternalModels.loadIntoScene({
             three: this.#three,
-            sceneDescription: this.#sceneDescription,
+            sceneDescription: this.#placementSceneDescription,
             externalModelsGroup,
             modelViewScale: PcbScene3dRuntime.resolveViewScale(
                 this.#presetState.get(),
@@ -726,7 +730,7 @@ export class PcbScene3dRuntime {
 
             if (
                 !this.#pointerDownPosition ||
-                PcbScene3dRuntime.#resolvePointerTravel(
+                PcbScene3dRuntimeHelpers.pointerTravel(
                     this.#pointerDownPosition,
                     {
                         x: Number(event?.clientX || 0),
@@ -770,6 +774,7 @@ export class PcbScene3dRuntime {
         })
         PcbScene3dComponentVisibility.apply({
             selectionRoots: this.#selectionRoots,
+            selectedDesignator: this.#selectedDesignator,
             hiddenDesignators: this.#hiddenComponentDesignators,
             fallbackBodyRoots: this.#fallbackBodyRoots,
             loadedExternalModelDesignators:
@@ -780,6 +785,24 @@ export class PcbScene3dRuntime {
         })
     }
 
+    /**
+     * Rebuilds the flat selected-component marker overlay.
+     * @returns {void}
+     */
+    #updateSelectionMarker() {
+        this.#selectionMarkerOverlay?.update(
+            this.#three,
+            this.#sceneDescription,
+            this.#selectedDesignator,
+            PcbScene3dComponentVisibility.isHidden(
+                this.#hiddenComponentDesignators,
+                this.#selectedDesignator
+            ),
+            (x, y) => this.#normalizeDetailPoint(x, y),
+            { color: PcbScene3dRuntime.#resolveSelectionHighlightColor() }
+        )
+    }
+
     /** @returns {void} */
     #render() {
         if (!this.#renderer || !this.#scene || !this.#camera) {
@@ -802,26 +825,6 @@ export class PcbScene3dRuntime {
         this.#resolveReadyPromise = null
     }
 
-    /**
-     * Yields one turn so the browser can present the initial rendered frame
-     * before deferred detail work continues.
-     * @returns {Promise<void>}
-     */
-    static async #yieldToNextFrame() {
-        if (
-            typeof window !== 'undefined' &&
-            typeof window.requestAnimationFrame === 'function'
-        ) {
-            await new Promise((resolve) => {
-                window.requestAnimationFrame(() => resolve())
-            })
-            return
-        }
-        await new Promise((resolve) => {
-            globalThis.setTimeout(resolve, 0)
-        })
-    }
-
     /**
      * Normalizes one board coordinate into the scene's centered board plane.
      * @param {number} x
@@ -891,6 +894,7 @@ export class PcbScene3dRuntime {
 
         const selectableRoots = [
             this.#groups.get('external-models'),
+            this.#groups.get('static-bodies'),
             this.#groups.get('fallback-bodies')
         ].filter((group) => group && group.visible !== false)
         const intersections = this.#raycaster.intersectObjects(
@@ -935,6 +939,8 @@ export class PcbScene3dRuntime {
             PcbScene3dRuntime.#resolveSelectionHighlightColor()
         )
         this.#selectedDesignator = normalizedDesignator
+        this.#applyToggleVisibility()
+        this.#updateSelectionMarker()
         this.#render()
     }
 
@@ -982,16 +988,4 @@ export class PcbScene3dRuntime {
     static #resolveSelectionHighlightColor() {
         return 0x14c5e6
     }
-
-    /**
-     * Resolves the drag travel between two pointer positions.
-     * @param {{ x: number, y: number }} start
-     * @param {{ x: number, y: number }} end
-     * @returns {number}
-     */
-    static #resolvePointerTravel(start, end) {
-        const dx = Number(end?.x || 0) - Number(start?.x || 0)
-        const dy = Number(end?.y || 0) - Number(start?.y || 0)
-        return Math.hypot(dx, dy)
-    }
 }

package/src/PcbScene3dRuntimeHelpers.mjs

@@ -0,0 +1,39 @@
+/**
+ * Small runtime utilities that do not need access to private runtime state.
+ */
+export class PcbScene3dRuntimeHelpers {
+    /**
+     * Yields one turn so the browser can present a rendered frame.
+     * @param {typeof globalThis} globalScope Runtime global object.
+     * @returns {Promise<void>}
+     */
+    static async yieldToNextFrame(globalScope) {
+        const frameScheduler =
+            globalScope?.window?.requestAnimationFrame ||
+            globalScope?.requestAnimationFrame
+        if (typeof frameScheduler === 'function') {
+            await new Promise((resolve) => {
+                frameScheduler.call(globalScope?.window || globalScope, () =>
+                    resolve()
+                )
+            })
+            return
+        }
+
+        await new Promise((resolve) => {
+            globalScope?.setTimeout(resolve, 0)
+        })
+    }
+
+    /**
+     * Resolves the drag travel between two pointer positions.
+     * @param {{ x: number, y: number }} start Pointer-down position.
+     * @param {{ x: number, y: number }} end Pointer-up position.
+     * @returns {number}
+     */
+    static pointerTravel(start, end) {
+        const dx = Number(end?.x || 0) - Number(start?.x || 0)
+        const dy = Number(end?.y || 0) - Number(start?.y || 0)
+        return Math.hypot(dx, dy)
+    }
+}

package/src/PcbScene3dSelectionIndexBuilder.mjs

@@ -0,0 +1,87 @@
+/**
+ * Builds lookup indexes for 3D scene selections.
+ */
+export class PcbScene3dSelectionIndexBuilder {
+    /**
+     * Builds one selected-key inspector lookup from the scene description.
+     * @param {{ components?: any[], externalPlacements?: any[], staticBodyPlacements?: any[] }} sceneDescription Scene data.
+     * @returns {Map<string, { component: any | null, externalPlacement: any | null, staticBodyPlacement: any | null }>}
+     */
+    static build(sceneDescription) {
+        const index = new Map()
+        const components = Array.isArray(sceneDescription?.components)
+            ? sceneDescription.components
+            : []
+        const externalPlacements = Array.isArray(
+            sceneDescription?.externalPlacements
+        )
+            ? sceneDescription.externalPlacements
+            : []
+        const staticBodyPlacements = Array.isArray(
+            sceneDescription?.staticBodyPlacements
+        )
+            ? sceneDescription.staticBodyPlacements
+            : []
+
+        components.forEach((component) => {
+            const designator = String(component?.designator || '').trim()
+            if (!designator) {
+                return
+            }
+
+            index.set(designator, {
+                component,
+                externalPlacement:
+                    index.get(designator)?.externalPlacement || null,
+                staticBodyPlacement:
+                    index.get(designator)?.staticBodyPlacement || null
+            })
+        })
+
+        externalPlacements.forEach((externalPlacement) => {
+            const designator = String(
+                externalPlacement?.designator || ''
+            ).trim()
+            if (!designator) {
+                return
+            }
+
+            index.set(designator, {
+                component: index.get(designator)?.component || null,
+                externalPlacement,
+                staticBodyPlacement:
+                    index.get(designator)?.staticBodyPlacement || null
+            })
+        })
+
+        staticBodyPlacements.forEach((staticBodyPlacement) => {
+            const selectionKey =
+                PcbScene3dSelectionIndexBuilder.#resolveStaticBodySelectionKey(
+                    staticBodyPlacement
+                )
+            if (!selectionKey) {
+                return
+            }
+
+            index.set(selectionKey, {
+                component: index.get(selectionKey)?.component || null,
+                externalPlacement:
+                    index.get(selectionKey)?.externalPlacement || null,
+                staticBodyPlacement
+            })
+        })
+
+        return index
+    }
+
+    /**
+     * Resolves the selectable key for one static body placement.
+     * @param {{ designator?: string, selectionKey?: string }} placement Static body placement.
+     * @returns {string}
+     */
+    static #resolveStaticBodySelectionKey(placement) {
+        return String(
+            placement?.selectionKey || placement?.designator || ''
+        ).trim()
+    }
+}

package/src/PcbScene3dSelectionInspectorRenderer.mjs

@@ -46,37 +46,49 @@ export class PcbScene3dSelectionInspectorRenderer {
 
     /**
      * Renders selected component details and optional editable transform controls.
-     * @param {{ designator: string, hidden?: boolean, selection?: { sourceType?: string } | null, selectionEntry: { component: any | null, externalPlacement: any | null }, adjustment: { scale: { x: number, y: number, z: number }, rotationDeg: { x: number, y: number, z: number }, offsetMil: { x: number, y: number, z: number } }, includeControls?: boolean, translate: (key: string) => string }} options Render options.
+     * @param {{ designator: string, hidden?: boolean, selection?: { sourceType?: string } | null, selectionEntry: { component: any | null, externalPlacement: any | null, staticBodyPlacement?: any | null }, adjustment: { scale: { x: number, y: number, z: number }, rotationDeg: { x: number, y: number, z: number }, offsetMil: { x: number, y: number, z: number } }, includeControls?: boolean, translate: (key: string) => string }} options Render options.
      * @returns {string}
      */
     static renderSelected(options) {
         const component = options.selectionEntry.component
         const externalPlacement = options.selectionEntry.externalPlacement
+        const staticBodyPlacement =
+            options.selectionEntry.staticBodyPlacement || null
+        const displayDesignator =
+            staticBodyPlacement?.designator || options.designator
         const hidden = options.hidden === true
         const fields = [
-            [options.translate('scene3d.designator'), options.designator],
+            [options.translate('scene3d.designator'), displayDesignator],
             [
                 options.translate('scene3d.picked'),
-                options.selection?.sourceType === 'external-model'
-                    ? options.translate('scene3d.externalModel')
-                    : options.translate('scene3d.fallbackBody')
+                PcbScene3dSelectionInspectorRenderer.#formatSourceType(
+                    options.selection,
+                    options.selectionEntry,
+                    options.translate
+                )
             ],
             [
                 options.translate('scene3d.mountSide'),
-                externalPlacement?.mountSide || component?.mountSide || ''
+                externalPlacement?.mountSide ||
+                    component?.mountSide ||
+                    staticBodyPlacement?.mountSide ||
+                    ''
             ],
             [
                 options.translate('scene3d.rotation'),
                 PcbScene3dSelectionInspectorRenderer.#formatValue(
-                    component?.rotationDeg ?? externalPlacement?.rotationDeg,
+                    component?.rotationDeg ??
+                        externalPlacement?.rotationDeg ??
+                        staticBodyPlacement?.rotationDeg,
                     'deg'
                 )
             ],
             [
                 options.translate('scene3d.boardPosition'),
-                component?.boardPositionMil
+                component?.boardPositionMil || staticBodyPlacement?.positionMil
                     ? PcbScene3dSelectionInspectorRenderer.#formatPoint(
-                          component.boardPositionMil,
+                          component?.boardPositionMil ||
+                              staticBodyPlacement?.positionMil,
                           true
                       )
                     : ''
@@ -98,9 +110,11 @@ export class PcbScene3dSelectionInspectorRenderer {
             ],
             [
                 options.translate('scene3d.bodyPosition'),
-                externalPlacement?.bodyPositionMil
+                externalPlacement?.bodyPositionMil ||
+                staticBodyPlacement?.bodyPositionMil
                     ? PcbScene3dSelectionInspectorRenderer.#formatPoint(
-                          externalPlacement.bodyPositionMil,
+                          externalPlacement?.bodyPositionMil ||
+                              staticBodyPlacement?.bodyPositionMil,
                           false
                       )
                     : ''
@@ -536,6 +550,31 @@ export class PcbScene3dSelectionInspectorRenderer {
             : ''
     }
 
+    /**
+     * Formats one selection source type label.
+     * @param {{ sourceType?: string } | null | undefined} selection Selection payload.
+     * @param {{ externalPlacement?: any | null, staticBodyPlacement?: any | null }} selectionEntry Selection metadata.
+     * @param {(key: string) => string} translate Translation lookup.
+     * @returns {string}
+     */
+    static #formatSourceType(selection, selectionEntry, translate) {
+        if (
+            selection?.sourceType === 'external-model' ||
+            selectionEntry?.externalPlacement
+        ) {
+            return translate('scene3d.externalModel')
+        }
+
+        if (
+            selection?.sourceType === 'static-body' ||
+            selectionEntry?.staticBodyPlacement
+        ) {
+            return translate('scene3d.staticBody')
+        }
+
+        return translate('scene3d.fallbackBody')
+    }
+
     /**
      * Formats one rotation triplet.
      * @param {{ x?: number, y?: number, z?: number } | null | undefined} rotationDeg Rotation.