Underside orbit stops near flat bottom view: asymmetric beta limits restrict tilt
Environment
Observed 2026-09-14 on Windows desktop, local molecule preview consuming the shared adom-3d-viewer-babylon9 ESM from wiki static/vendor. Runtime Babylon version: 9.5.0. Discoverable owning package: adom/adom-3d-viewer 0.7.0; static bundle package version not independently established. Board: STM32F411RET6 raw TSCI detailed GLB, Y-up, zUp:false. tscircuit 0.0.2516; CLI 0.1.2057. Pup is only the inspection transport, not an established cause.
Reproduction / user observation
- Load the F411 model in the shared viewer (our consumer is
compact-preview.html?board=stm32f411ret6&group=mcu-self-contained). - Orbit to the underside so the bottom markings read upright.
- Try to tilt through a flat bottom view and continue in the other direction.
Ray reports: "upside down seems to only want to tilt in the wrong direction/ won't let me tilt more than flat upwards". Expected: smooth, predictable orbit on both faces, including passage through the bottom pole, rather than an asymmetric stop near flat. Preserve upright front/back presets and the model coordinate-frame contract.
Live camera evidence (read only; no limits changed)
viewer.getCamera() returned:
{"alpha":-4.659872178598141,"beta":2.2824333946640127,"lowerBetaLimit":-100,"upperBetaLimit":3.1315926535897933,"allowUpsideDown":true,"upVector":[0,1,0]}
The upper beta limit equals PI-0.01 while the lower limit is -100. That asymmetry is consistent with reaching a stop near the bottom pole while the top permits further rotation. This is a likely cause, not a completed drag-event/root-cause diagnosis. No runtime exception was observed for the orbit behavior.
Our consumer initializes zUp:false, applies alpha=-PI/2 and beta=.25 for the initial front camera, and does not set beta limits or allowUpsideDown. Please check how the viewer's defaults interact with upside-down orbit/input direction. Regression coverage should exercise dragging across both poles and both raw Y-up / anchored Z-up molecule frames. Prefer an explicit full-orbit option if ground-limited orbit is needed by other consumers.
Attached screenshot is the actual live underside viewport after the report. This is distinct from adom/adom-3d-viewer#4 (view-cube mouse-down animation); the consumer has showViewCube:false. It is also distinct from the resolved adom/logic-molecule-workflows#1 frame-orientation fix and #3 mirrored bottom-text fix. No fix or PR created in this report.
