feat(cockpit): ride a tracked satellite in an orbital view

With a satellite tracked and no aircraft tracked, Cockpit can ride the
satellite. Entry needs only the Satellites layer; debris can be tracked but
not entered, and voice stays aircraft-only. Double-clicking the tracked
satellite or the entry buttons (reading ORBIT) enter it.

The camera sits on the satellite's per-frame SGP4 position and looks
straight down, turned to the ground track (north-up for a satellite with
none). The optical zoom steps 1x to 8x with a focus pull, the arrows tilt
the view up to 45 degrees off nadir, and Home or 0 returns to nadir. Off
nadir the tilt reads its total angle first and the swath readout becomes an
approximation marked with ≈. While in orbit the map leases flat Esri
imagery, the cloud pass stays off and the view opens in the optical style.

The orbital HUD names the satellite with its owner's flag (from the
flag-icons package, loaded per country) or an organisation badge, its
operator, class, NORAD and COSPAR ids and TLE epoch with the element lines
on request, altitude, orbital speed and the sub-satellite point. CURRENTLY
OVER names the country and its first-level division, or the sea, and from
8x the most prominent populated place nearby, looked up offline from the
bundled Natural Earth packs (populated places are a new pack). The
satellites layer hides the ridden satellite's own marks, dims the other
orbit rings and ignores scene clicks and Escape while held. Exit restores
the camera's field of view and the satellite's follow camera.

C no longer enters or leaves Cockpit, bridge or orbit: it is left to the
app-wide CCTV shortcut, and Escape or the exit button leave first person.

scripts/build-admin-packs.mjs

@@ -7,13 +7,16 @@
  *     Natural Earth 10m admin-1 states and provinces (public domain).
  *   src/data/local_data/us_census_counties/counties.json
  *     US Census Bureau cartographic boundary counties (public domain).
+ *   src/data/local_data/natural_earth/populated_places.json
+ *     Natural Earth 10m populated places as points, for the orbital view's
+ *     "near <city>" (`src/data/placeBelow.js`; public domain).
  *
  * Both sources are pinned by URL and SHA-256, so a rerun reproduces the packs
  * byte for byte. Downloads are cached outside the repository (default: the
  * system temp directory) and are never committed.
  *
  * Usage:
- *   node scripts/build-admin-packs.mjs [--cache <dir>] [--only countries|admin1|counties]
+ *   node scripts/build-admin-packs.mjs [--cache <dir>] [--only countries|admin1|counties|places]
  *
  * The provenance READMEs beside each pack record these parameters.
  */
@@ -101,6 +104,9 @@ export const PARAMS = Object.freeze({
     elsewhereMinPopulation: 50_000,
     cityStateMaxKm2: 1_000,
   },
+  // Every populated place, kept as a point: name, position and the two
+  // prominence ranks the orbital view picks "near <city>" by.
+  places: { decimals: 3 },
 });
 
 const args = process.argv.slice(2);
@@ -688,6 +694,47 @@ async function buildAdmin1() {
   };
 }
 
+async function buildPlaces() {
+  const params = PARAMS.places;
+  const source = await fetchPinned('places');
+  const factor = 10 ** params.decimals;
+  const round = (value) => Math.round(value * factor) / factor;
+  const places = JSON.parse(source.bytes.toString('utf8'))
+    .features.map((f) => f.properties)
+    .filter(
+      (p) =>
+        p.name &&
+        Number.isFinite(p.latitude) &&
+        Number.isFinite(p.longitude) &&
+        Number.isFinite(p.scalerank),
+    )
+    .map((p) => [
+      p.name,
+      round(p.latitude),
+      round(p.longitude),
+      p.scalerank,
+      Number.isFinite(p.rank_max) ? p.rank_max : 0,
+    ])
+    .sort((a, b) => a[3] - b[3] || b[4] - a[4] || a[0].localeCompare(b[0]));
+  return {
+    meta: {
+      title: 'Natural Earth populated places',
+      source: 'ne_10m_populated_places_simple',
+      url: SOURCES.places.url,
+      sha256: source.digest,
+      commit: NE_COMMIT,
+      license:
+        'Public domain (https://www.naturalearthdata.com/about/terms-of-use/)',
+      schema:
+        'places[]: [name, latitude, longitude, scalerank (0 most prominent .. 10), rank_max (population class, 0..14; higher is larger)]',
+      decimals: params.decimals,
+      curation: params,
+      script: 'scripts/build-admin-packs.mjs',
+    },
+    places,
+  };
+}
+
 async function buildCounties() {
   const params = PARAMS.counties;
   const source = await fetchPinned('counties');
@@ -768,4 +815,13 @@ if (isMain) {
       'src/data/local_data/us_census_counties/counties.json',
       await buildCounties(),
     );
+  if (!only || only === 'places') {
+    const relative = 'src/data/local_data/natural_earth/populated_places.json';
+    const pack = await buildPlaces();
+    const text = JSON.stringify(pack) + '\n';
+    await writeFile(path.join(ROOT, relative), text);
+    console.log(
+      `${relative}: ${pack.places.length} places, ${Buffer.byteLength(text)} bytes`,
+    );
+  }
 }

scripts/check-package-boundaries.mjs

@@ -109,7 +109,14 @@ export async function checkPackageBoundaries(root) {
             // template blocks belong to the component file itself.
             if (info.id.startsWith('\0')) return;
             const id = info.id.split('?')[0];
-            if (!allowed.has(id)) {
+            // A declared dependency also owns the asset files it ships (a
+            // flag-icons SVG imported as a URL) that a glob resolves in place.
+            const dependencyAsset = group.external.some((external) =>
+              id.startsWith(
+                `${normalizePath(path.join(root, 'node_modules', external))}/`,
+              ),
+            );
+            if (!allowed.has(id) && !dependencyAsset) {
               throw new Error(
                 `Package boundary ${name} imports an unowned module: ${path.relative(root, id)}`,
               );

scripts/package-boundaries.json

@@ -40,6 +40,8 @@
       "src/ui/views/panels/CockpitContext.vue",
       "src/ui/views/panels/CockpitRoute.vue",
       "src/ui/views/panels/CockpitRadar.vue",
+      "src/ui/views/panels/CockpitOrbital.vue",
+      "src/ui/ownerFlag.js",
       "src/ui/cockpitPresentation.js",
       "src/data/headingDegrees.js",
       "src/data/distanceFormat.js",
@@ -158,7 +160,7 @@
       "src/ui/i18n.js",
       "src/ui/surfaceKeyboard.js"
     ],
-    "external": ["vue", "pinia", "vue-i18n"]
+    "external": ["vue", "pinia", "vue-i18n", "flag-icons"]
   },
   "viewer": {
     "exports": ["./application/viewer"],
@@ -891,6 +893,11 @@
       "src/ui/cockpitInstrumentState.js",
       "src/ui/cockpitRollingValue.js",
       "src/ui/cockpitCamera.js",
+      "src/ui/cockpitOrbitalView.js",
+      "src/data/placeBelow.js",
+      "src/data/adminBoundaries.js",
+      "src/data/bundledJson.js",
+      "src/data/retryableLoad.js",
       "src/ui/cockpitContext.js",
       "src/ui/cockpitController.js",
       "src/ui/cockpitDisplayPortal.js",
@@ -908,6 +915,7 @@
       "src/cockpitSubjects.js",
       "src/cockpitRadar.js",
       "src/cockpitLook.js",
+      "src/cockpitOrbital.js",
       "src/geoDistance.js",
       "src/data/motionModel.js",
       "src/ui/panelRailGeometry.js",
@@ -981,6 +989,7 @@
       "src/cockpitSubjects.js",
       "src/cockpitRadar.js",
       "src/cockpitLook.js",
+      "src/cockpitOrbital.js",
       "src/geoDistance.js",
       "src/data/motionModel.js",
       "src/contactsDetectionPolicy.js",
@@ -1033,6 +1042,11 @@
       "src/ui/cockpitInstrumentState.js",
       "src/ui/cockpitRollingValue.js",
       "src/ui/cockpitCamera.js",
+      "src/ui/cockpitOrbitalView.js",
+      "src/data/placeBelow.js",
+      "src/data/adminBoundaries.js",
+      "src/data/bundledJson.js",
+      "src/data/retryableLoad.js",
       "src/ui/cockpitContext.js",
       "src/ui/cockpitController.js",
       "src/ui/cockpitDisplayPortal.js",
@@ -1637,6 +1651,7 @@
       "src/data/satellitePass.js",
       "src/sources/tle.js",
       "src/layers/satellites/catalog.js",
+      "src/layers/satellites/cockpitSubject.js",
       "src/layers/satellites/controls.js",
       "src/layers/satellites/index.js",
       "src/layers/satellites/ingestion.js",
@@ -2411,6 +2426,7 @@
       "src/cockpitSubjects.js",
       "src/cockpitRadar.js",
       "src/cockpitLook.js",
+      "src/cockpitOrbital.js",
       "src/contactsDetectionPolicy.js",
       "src/contextModePolicy.js",
       "src/creditKeyboard.js",
@@ -2705,6 +2721,7 @@
       "src/layers/radio/tuningNoise.js",
       "src/layers/radio/volume.js",
       "src/layers/satellites/catalog.js",
+      "src/layers/satellites/cockpitSubject.js",
       "src/layers/satellites/controls.js",
       "src/layers/satellites/index.js",
       "src/layers/satellites/ingestion.js",
@@ -2854,6 +2871,8 @@
       "src/ui/cockpitInstrumentState.js",
       "src/ui/cockpitRollingValue.js",
       "src/ui/cockpitCamera.js",
+      "src/ui/cockpitOrbitalView.js",
+      "src/data/placeBelow.js",
       "src/ui/cockpitContext.js",
       "src/ui/cockpitController.js",
       "src/ui/cockpitDisplayPortal.js",
@@ -3675,6 +3694,7 @@
       "src/layers/radio/tuningNoise.js",
       "src/layers/radio/volume.js",
       "src/layers/satellites/catalog.js",
+      "src/layers/satellites/cockpitSubject.js",
       "src/layers/satellites/controls.js",
       "src/layers/satellites/index.js",
       "src/layers/satellites/ingestion.js",
@@ -4185,6 +4205,7 @@
       "src/cockpitSubjects.js",
       "src/cockpitRadar.js",
       "src/cockpitLook.js",
+      "src/cockpitOrbital.js",
       "src/geoDistance.js",
       "src/data/motionModel.js",
       "src/contactsDetectionPolicy.js",