# Configuration Management

`js_globals` is the runtime configuration/state singleton used by the web client. Most user-facing fields are edited from the UI (Global Settings panel) and persisted via `js_localStorage`.

Files:

- `src/js/js_globals.js` (runtime defaults + constants)
- `src/js/js_localStorage.js` (persistence into browser localStorage/sessionStorage)
- `src/components/jsc_globalSettings.jsx` (UI that edits some values)

## Important: this is NOT `public/config.json`

`public/config.json` overrides `src/js/js_siteConfig.js` only.

It does **not** override `js_globals`.

If you want to change `js_globals` defaults permanently, you typically do one of:

- Use the UI that stores values in browser localStorage (`js_localStorage`).
- Change defaults in `js_globals.js` (code-level default).

## How values are loaded

`js_localStorage` (singleton) initializes some `js_globals` values on startup if storage is supported:

- `js_globals.v_useMetricSystem`
- `js_globals.CONST_DEFAULT_ALTITUDE`
- `js_globals.CONST_DEFAULT_RADIUS`

Other preferences are read by UI code when needed (for example `jsc_globalSettings.jsx` reads volume, tabs display, unit sorting, etc.).

## User-tunable defaults (persisted in localStorage)

These are practical "options you can change" without rebuilding the app.

| Setting | Effect | Where it is persisted |
|---------|--------|-----------------------|
| `v_useMetricSystem` | Metric vs imperial UI behavior (affects distance labels and unit conversion when toggling). | `LS_METRIC_SYS` via `js_localStorage.fn_setMetricSystem()` |
| `CONST_DEFAULT_ALTITUDE` | Default altitude used by planning/mission UI when creating new actions/items. Enforced by `CONST_DEFAULT_ALTITUDE_min`. | `LS_DEFAULT_ALT` via `js_localStorage.fn_setDefaultAltitude()` |
| `CONST_DEFAULT_RADIUS` | Default radius used by circle-related operations and mission defaults. Enforced by `CONST_DEFAULT_RADIUS_min`. | `_vDefaultRadius` via `js_localStorage.fn_setDefaultRadius()` |
| `CONST_DEFAULT_SWARM_HORIZONTAL_DISTANCE` | Default swarm formation horizontal distance. Enforced by `CONST_DEFAULT_SWARM_HORIZONTAL_DISTANCE_MIN`. | `_vDefaultSHD` via `js_localStorage.fn_setDefaultSwarmHorizontalDistance()` |
| `CONST_DEFAULT_SWARM_VERTICAL_DISTANCE` | Default swarm formation vertical distance. Enforced by `CONST_DEFAULT_SWARM_VERTICAL_DISTANCE_MIN`. | `_vDefaultSVD` via `js_localStorage.fn_setDefaultSwarmVerticalDistance()` |
| `CONST_DEFAULT_VOLUME` | Default volume for speech/voice features. | `LS_DEFAULT_VOLUME` via `js_localStorage.fn_setVolume()` |
| `LS_ENABLE_SPEECH` (via `js_localStorage.fn_getSpeechEnabled`) | Enables/disables speech. When disabled, volume slider is disabled in UI. | `LS_ENABLE_SPEECH` |
| `v_enable_tabs_display` | UI preference: enable/disable tabbed settings display. | `LS_TAB_DISPLAY_ENABLED` |
| `v_enable_unit_sort` | UI preference: auto-sort unit list. | `LS_UNIT_SORTED_ENABLED` |
| `v_enable_gcs_display` | UI preference: show GCS units in UI lists. | `_vGCSDisplay` |
| `LS_SHOW_ME_GCS` (via `js_localStorage.fn_setGCSShowMe`) | UI/network behavior preference related to showing this GCS. | `LS_SHOW_ME_GCS` |
| `LS_SELECTED_THEME` | Selected UI theme name. | `LS_SELECTED_THEME` |

## Other runtime tuning knobs (code-level defaults)

These are defined in `js_globals.js` and typically adjusted in code.

| Setting | Effect |
|---------|--------|
| `v_connectRetries` | Retry count used by connection logic where implemented. |
| `CONST_DEFAULT_ALTITUDE_min` / `CONST_DEFAULT_RADIUS_min` | Minimum allowed values enforced by settings UI and validation. |
| `CONST_DEFAULT_ALTITUDE_STEP` | Step size for some altitude controls (where used). |
| `CONST_DEFAULT_SPEED_MIN` / `CONST_DEFAULT_SPEED_STEP` | Limits/step used in some mission/planning speed controls (where used). |
| `CONST_DEFAULT_FLIGHTPATH_STEPS_COUNT` | Number of points for flight-path visualization (smoothness vs performance). |
| `v_EnableADSB` | Enables ADS-B related UI/processing (where integrated/used). |
| `v_en_Drone` / `v_en_GCS` | Enables filtering of drone vs GCS categories in UI (where used). |
| `v_gamePadMode` | Default gamepad "mode" concept (stick mapping preset). Final behavior depends on stored gamepad configs. |
| `GP_EPSILON_CHANGE` | Gamepad RC send threshold: minimum axis delta to trigger a send (noise filtering). |
| `GP_HEARTBEAT_MS` | Gamepad RC heartbeat: max delay before re-sending unchanged axes. |
| `GP_SUDDEN_CHANGE` / `GP_MIN_GAP_FAST_MS` | Immediate-send logic for large stick changes with rate limiting. |
| `v_mission_file_extension` | Default mission file extension used by mission import/export UI. |

## LocalStorage keys

Keys are defined in `js_globals.js` (e.g. `LS_DEFAULT_ALT`, `LS_METRIC_SYS`, `LS_DEFAULT_VOLUME`, etc.) and used by `js_localStorage.js`.

If you need to reset preferences, clear the relevant keys from the browser's localStorage.