Semantic Inspectors¶
Last changes: Documentation changelog
Every selection in the Explorer, 3D Viewport, 2D Field Map, or Results Navigator routes through
InspectorRegistry and inspectorRouteCatalog.tsx (apps/control-room/src/modules/inspector/) to
a dedicated semantic panel. Rather than building one generic key-value property grid, each domain
owner exposes typed controls, unit-aware SI inputs, lane-filtered validation, and explicit save
transactions.
Edit Modes and Draft Isolation¶
Panels register with InspectorEditSession (InspectorEditSession.tsx) under one of three modes:
staged: Edits remain local inside panel/draft stores until explicitly committed with Apply (Ctrl+Shift+Enter) or discarded with Revert (session.reset). Applying runs throughrunAuthoringMutationWithHistorywith optimisticscene_revisionconcurrency guards (reconcileObjectEditAck, rebase-on-unchanged-object) so out-of-date drafts never silently overwrite background changes from live Python scripts.liveViewport: Display and camera settings patchvisualization/stateimmediately while preserving Revert recovery.immediate: Read-only inspection and discrete button actions (such as stage commands or mesh builds) run immediately without staged Apply/Revert state.
Semantic Inspector Families¶
Screenshots illustrate the interface; they are not runtime or physics qualification evidence.
Control Room crosswalk¶
Route dispatcher:
inspectorRouteCatalog.tsxmaps everySelectionKind(object,material,region,physics,coupling,frozen-spins,antenna,current-transport,spin-transport,spin-interface,study,study-stage,planar-monitor,frequency-domain-*,mode-visualization,runtime-*,job,diagnostic) to its React owner panel.Global action bar:
InspectorShellqueriesinspectorActionStatefrom the activeInspectorEditSessionto drive Apply / Reset and disable reasons.
Python/API crosswalk¶
Staged inspector commits issue OpenAPI v2 authoring transactions equivalent to
Problem/Studymutations inpackages/fullmag-py.Fields absent from an inspector panel remain documented as
TODO: frontend supportin Control Room capability register and remain authoritative in Python.
Physics and bibliography scope¶
Semantic inspectors surface authored parameters, unit conversions, and runtime validation without altering physical model equations or solver numerics.
Source-code index¶
Responsibility |
Repository path |
Stable symbol |
|---|---|---|
Selection-to-panel route catalog |
|
|
Panel registry shell |
|
|
Staged / liveViewport / immediate session contract |
|
|
Unit-aware scalar draft inputs |
|
|
Optimistic revision reconciliation |
|
|