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.

Staged Geometry inspector showing STATE modified badge, SI Size X edit, active Revert and Apply buttons, and Draft ready to apply footer

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 through runAuthoringMutationWithHistory with optimistic scene_revision concurrency 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 patch visualization/state immediately 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.tsx maps every SelectionKind (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: InspectorShell queries inspectorActionState from the active InspectorEditSession to drive Apply / Reset and disable reasons.

Python/API crosswalk

  • Staged inspector commits issue OpenAPI v2 authoring transactions equivalent to Problem / Study mutations in packages/fullmag-py.

  • Fields absent from an inspector panel remain documented as TODO: frontend support in 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

apps/control-room/src/modules/inspector/inspectorRouteCatalog.tsx

resolveInspectorRoute

Panel registry shell

apps/control-room/src/modules/inspector/inspectorRegistry.tsx

InspectorRegistry

Staged / liveViewport / immediate session contract

apps/control-room/src/modules/inspector/InspectorEditSession.tsx

useRegisterInspectorEditSession, inspectorActionState

Unit-aware scalar draft inputs

apps/control-room/src/modules/inspector/primitives/QuantityField.tsx

QuantityField

Optimistic revision reconciliation

apps/control-room/src/modules/inspector/panels/objectEditAckReconciliation.ts

reconcileObjectEditAck