Refactor SettingsManager

.gitignore

@@ -131,4 +131,6 @@ cypress.config.ts
 
 # Generated Locale Files
 src/locales/keys.ts
-src/locales/*.json
+src/locales/*.json
+
+**/*.notes.md

public/settings/settingsOverride.js

@@ -23,66 +23,85 @@ const settingsOverride = {
    * This is an example of available settings that can be overridden.
    * Uncomment any options you wish to change.
    *
-   * Classification can be "Unclassified", "Secret", "Top Secret", "Top Secret//SCI"
-   * classificationStr: '',
-   * This controls which of the built-in plugins are loaded
-   * plugins: {
-   *   debug: false,
-   *   satInfoboxCore: true,
-   *   aboutManager: false,
-   *   collisions: true,
-   *   trackingImpactPredict: true,
-   *   dops: false,
-   *   findSat: true,
-   *   launchCalendar: true,
-   *   newLaunch: true,
-   *   nextLaunch: true,
-   *   nightToggle: true,
-   *   photoManager: true,
-   *   screenRecorder: true,
-   *   satChanges: false,
-   *   stereoMap: true,
-   *   timeMachine: true,
-   *   initialOrbit: false,
-   *   missile: true,
-   *   breakup: true,
-   *   editSat: true,
-   *   constellations: true,
-   *   countries: true,
-   *   colorsMenu: true,
-   *   shortTermFences: true,
-   *   orbitReferences: true,
-   *   analysis: true,
-   *   plotAnalysis: false,
-   *   sensorFov: true,
-   *   sensorSurv: true,
-   *   satelliteFov: true,
-   *   satelliteView: true,
-   *   planetarium: true,
-   *   astronomy: false,
-   *   screenshot: true,
-   *   watchlist: true,
-   *   sensor: true,
-   *   settingsMenu: true,
-   *   datetime: true,
-   *   social: true,
-   *   topMenu: true,
-   *   classificationBar: false,
-   *   soundManager: true,
-   *   gamepad: true,
-   *   debrisScreening: true,
-   *   videoDirector: false,
-   *   reports: true,
-   *   polarPlot: true,
-   *   timeline: true,
-   *   timelineAlt: true,
-   *   transponderChannelData: true,
-   *   calculator: true,
-   * },
+   * =============================================================================
+   * FLAT SYNTAX (Backward Compatible):
+   * =============================================================================
+   * You can override settings directly using their property names:
    *
+   * classificationStr: '',
    * searchLimit: 150,
    * isDisableCss: false,
    * isShowSplashScreen: true,
+   * isDrawSun: true,
+   * fieldOfView: 0.8,
+   *
+   * =============================================================================
+   * NESTED SYNTAX (Recommended for better organization):
+   * =============================================================================
+   * You can organize overrides by category for better readability:
+   *
+   * graphics: {
+   *   isDrawSun: true,
+   *   isDrawMilkyWay: false,
+   *   isDrawAtmosphere: 1,
+   *   godraysSamples: 36,
+   * },
+   *
+   * ui: {
+   *   isShowSplashScreen: false,
+   *   isShowLoadingHints: false,
+   *   desktopMaxLabels: 1000,
+   * },
+   *
+   * camera: {
+   *   fieldOfView: 0.8,
+   *   zoomSpeed: 0.01,
+   * },
+   *
+   * orbital: {
+   *   isDrawOrbits: true,
+   *   orbitSegments: 128,
+   * },
+   *
+   * data: {
+   *   dataSources: {
+   *     tle: 'https://your-custom-tle-source.com/api/sats',
+   *   },
+   * },
+   *
+   * performance: {
+   *   lowPerf: false,
+   *   maxLabels: 5000,
+   * },
+   *
+   * color: {
+   *   defaultColorScheme: 'ObjectTypeColorScheme',
+   * },
+   *
+   * core: {
+   *   classificationStr: '',
+   *   searchLimit: 150,
+   *   plugins: {
+   *     DebugMenuPlugin: { enabled: false },
+   *     AboutMenuPlugin: { enabled: false },
+   *     Collisions: { enabled: true },
+   *     DopsPlugin: { enabled: false },
+   *   },
+   * },
+   *
+   * =============================================================================
+   * AVAILABLE CATEGORIES:
+   * =============================================================================
+   * - graphics: Rendering, textures, visual effects
+   * - ui: User interface, menus, display settings
+   * - camera: Camera movement, FOV, zoom settings
+   * - orbital: Orbit calculations, rendering, propagation
+   * - data: Data sources, catalogs, servers
+   * - performance: Performance limits, throttling
+   * - color: Color schemes and object colors
+   * - core: Core settings, plugins, filters, global flags
+   *
+   * You can mix flat and nested syntax - flat overrides take precedence.
    */
 };
 

src/settings/camera-settings.ts

@@ -0,0 +1,187 @@
+/**
+ * /////////////////////////////////////////////////////////////////////////////
+ *
+ * @Copyright (C) 2025 Kruczek Labs LLC
+ *
+ * KeepTrack is free software: you can redistribute it and/or modify it under the
+ * terms of the GNU Affero General Public License as published by the Free Software
+ * Foundation, either version 3 of the License, or (at your option) any later version.
+ *
+ * KeepTrack is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;
+ * without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+ * See the GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License along with
+ * KeepTrack. If not, see <http://www.gnu.org/licenses/>.
+ *
+ * /////////////////////////////////////////////////////////////////////////////
+ */
+
+import { Radians, Kilometers } from '@app/engine/ootk/src/main';
+import { RADIUS_OF_EARTH } from '../engine/utils/constants';
+
+/**
+ * Camera movement, zoom, and field of view settings
+ */
+export class CameraSettings {
+  // Field of View
+  /**
+   * The initial field of view settings for FPS, Planetarium, Astronomy, and Satellite View
+   */
+  fieldOfView = 0.6 as Radians;
+  /**
+   * @deprecated
+   * The maximum value for the field of view setting.
+   *
+   * TODO: Implement this for FPS, Planetarium, Astronomy, and Satellite View
+   */
+  fieldOfViewMax = 1.2 as Radians;
+  /**
+   * @deprecated
+   * The minimum value for the field of view setting.
+   *
+   * * TODO: Implement this for FPS, Planetarium, Astronomy, and Satellite View
+   */
+  fieldOfViewMin = 0.04;
+
+  // Camera Movement
+  /**
+   * The speed at which the camera decays.
+   *
+   * Reduce this give momentum to camera changes
+   */
+  cameraDecayFactor = 5;
+  /**
+   * The speed at which the camera moves.
+   *
+   * TODO: This needs to be made read-only and a sepearate internal camera variable should be used to handle
+   * the logic when shift is pressed
+   */
+  cameraMovementSpeed = 0.003;
+  /**
+   * The minimum speed at which the camera moves.
+   *
+   * TODO: This needs to be made read-only and a sepearate internal camera variable should be used to handle
+   * the logic when shift is pressed
+   */
+  cameraMovementSpeedMin = 0.005;
+
+  // Auto Camera Movement
+  /**
+   * Adjust to change camera speed of auto pan around earth
+   */
+  autoPanSpeed = 1;
+  /**
+   * Adjust to change camera speed of auto rotate around earth
+   */
+  autoRotateSpeed = 0.000075;
+  isAutoRotateL = true;
+  isAutoRotateR = false;
+  isAutoRotateU = false;
+  isAutoRotateD = false;
+  isAutoPanL = false;
+  isAutoPanR = false;
+  isAutoPanU = false;
+  isAutoPanD = false;
+
+  // Zoom Settings
+  /**
+   * The speed at which the zoom level changes when the user zooms in or out.
+   */
+  zoomSpeed = 0.005;
+  /**
+   * The maximum zoom distance from the Earth's surface in kilometers.
+   *
+   * Used for zooming in and out in default and offset camera modes.
+   */
+  maxZoomDistance = <Kilometers>1.2e6; // 1.2 million km
+  /**
+   * The minimum zoom distance from 0,0,0 in kilometers.
+   *
+   * Used for zooming in and out in default and offset camera modes.
+   */
+  minZoomDistance = <Kilometers>(RADIUS_OF_EARTH + 50);
+  /**
+   * Distance from satellite when we switch to close camera mode.
+   * This is used to slow down the dolly effect when zooming in on a satellite.
+   */
+  nearZoomLevel = 25 as Kilometers;
+  /**
+   * Minimum distance from satellite when we switch to close camera mode
+   * The camera will not be able to get closer than this distance
+   */
+  minDistanceFromSatellite = 0.75 as Kilometers;
+  /**
+   * Determines whether zooming stops auto rotation in the application.
+   */
+  isZoomStopsRotation = true;
+  /**
+   * Changing the zoom with the mouse wheel will stop the camera from following the satellite.
+   */
+  isZoomStopsSnappedOnSat = false;
+  isAutoZoomIn = false;
+  isAutoZoomOut = false;
+  autoZoomSpeed = 0.00002;
+  /**
+   * The initial zoom level for the camera.
+   * 0 = earth and 1 = max distance from earth
+   */
+  initZoomLevel: number;
+
+  // Camera Controls
+  /**
+   * Currently only disables panning.
+   *
+   * TODO: Disable all camera movement
+   */
+  disableCameraControls = false;
+  /**
+   * Global flag for determining if the user is dragging the globe
+   */
+  isDragging = false;
+
+  // Camera Focus
+  /** Center on a satellite when it is selected. */
+  isFocusOnSatelliteWhenSelected = true;
+
+  // Offset Camera Mode
+  /**
+   * The offset in the x direction for the offset camera mode.
+   */
+  offsetCameraModeX = 15000;
+  /**
+   * The offset in the z direction for the offset camera mode.
+   */
+  offsetCameraModeZ = -6000;
+
+  // FPS Mode Settings
+  /**
+   * Speed at which the camera moves in the Z direction when in FPS mode.
+   */
+  fpsForwardSpeed = 3;
+  /**
+   * Speed the camera pitches up and down when in FPS mode.
+   */
+  fpsPitchRate = 0.02;
+  /**
+   * Speed at which the camera rotates when in FPS mode.
+   */
+  fpsRotateRate = 0.02;
+  /**
+   * Speed at which the camera moves in the X direction when in FPS mode.
+   */
+  fpsSideSpeed = 3;
+  /**
+   * Speed at which the camera moves in the Y direction when in FPS mode.
+   */
+  fpsVertSpeed = 3;
+  /**
+   * Speed at which the camera twists (yaws) when in FPS mode.
+   */
+  fpsYawRate = 0.02;
+
+  /** Enables the camera widget */
+  drawCameraWidget = false;
+}
+
+export const defaultCameraSettings = new CameraSettings();