@ksp-gonogo/sitrep-sdk 1.0.0-rc.21 → 2.0.0-rc.23

package/src/__generated__/units.ts

@@ -107,11 +107,6 @@ export const GENERATED_TYPE_UNITS: Readonly<Record<string, UnitsByField>> = {
     radialOut: "m/s",
     ut: "ut",
   },
-  "AlternatorEntry": {
-    outputRate: "units/s",
-    partId: "id",
-    partName: "text",
-  },
   "ArchiveEntry": {
     biome: "text",
     body: "text",
@@ -137,12 +132,6 @@ export const GENERATED_TYPE_UNITS: Readonly<Record<string, UnitsByField>> = {
     pressures: "kPa",
     seaLevelPressure: "kPa",
   },
-  "BatteryEntry": {
-    current: "units",
-    max: "units",
-    partId: "id",
-    partName: "text",
-  },
   "BodyEntry": {
     description: "text",
     gravParameter: "m³/s²",
@@ -307,6 +296,10 @@ export const GENERATED_TYPE_UNITS: Readonly<Record<string, UnitsByField>> = {
   "CommandGateItem": {
     value: "id",
   },
+  "CommandGroupRequest": {
+    groupId: "id",
+    type: "id",
+  },
   "CommandRequest": {
     command: "id",
     label: "text",
@@ -414,7 +407,9 @@ export const GENERATED_TYPE_UNITS: Readonly<Record<string, UnitsByField>> = {
   },
   "CommsContactWindow": {
     closeUt: "ut",
+    fromDish: "id",
     openUt: "ut",
+    toDish: "id",
   },
   "CommsContacts": {
     horizonUt: "ut",
@@ -437,6 +432,7 @@ export const GENERATED_TYPE_UNITS: Readonly<Record<string, UnitsByField>> = {
     from: "id",
     fromIsHome: "flag",
     kind: "enum",
+    quantity: "enum",
     strength: "ratio",
     to: "id",
     toIsHome: "flag",
@@ -480,6 +476,13 @@ export const GENERATED_TYPE_UNITS: Readonly<Record<string, UnitsByField>> = {
     occludingRadiusMeters: "m",
     radiusMeters: "m",
   },
+  "CommsRetargetWindow": {
+    closeUt: "ut",
+    dish: "id",
+    node: "id",
+    openUt: "ut",
+    peer: "id",
+  },
   "CommsRoute": {
     arrivalUt: "ut",
     from: "id",
@@ -495,6 +498,7 @@ export const GENERATED_TYPE_UNITS: Readonly<Record<string, UnitsByField>> = {
   "CommsSignal": {
     modelled: "flag",
     otherPath: "flag",
+    quantity: "enum",
     strength: "ratio",
   },
   "ContractActionArgs": {
@@ -537,6 +541,9 @@ export const GENERATED_TYPE_UNITS: Readonly<Record<string, UnitsByField>> = {
     partName: "text",
     partTitle: "text",
   },
+  "CrashRecent": {
+    recent: "flag",
+  },
   "CrashReport": {
     altitude: "m",
     body: "text",
@@ -730,12 +737,6 @@ export const GENERATED_TYPE_UNITS: Readonly<Record<string, UnitsByField>> = {
     vesselId: "id",
     vesselName: "text",
   },
-  "FuelCellEntry": {
-    active: "flag",
-    partId: "id",
-    partName: "text",
-    status: "text",
-  },
   "GameDlc": {
     breakingGround: "flag",
     makingHistory: "flag",
@@ -1041,6 +1042,9 @@ export const GENERATED_TYPE_UNITS: Readonly<Record<string, UnitsByField>> = {
     resourcesValue: "funds",
     totalValue: "funds",
   },
+  "RecoveryRecent": {
+    recent: "flag",
+  },
   "RecoveryReport": {
     capturedAtUT: "ut",
     displayReputation: "flag",
@@ -1095,9 +1099,17 @@ export const GENERATED_TYPE_UNITS: Readonly<Record<string, UnitsByField>> = {
   "RotorReverseArgs": {
     partId: "id",
   },
-  "RotorSetValueArgs": {
+  "RotorSetBrakeArgs": {
     partId: "id",
-    value: "ratio",
+    percent: "%",
+  },
+  "RotorSetRpmLimitArgs": {
+    partId: "id",
+    rpm: "rpm",
+  },
+  "RotorSetTorqueLimitArgs": {
+    partId: "id",
+    percent: "%",
   },
   "SavedShipEntry": {
     facility: "text",
@@ -1199,13 +1211,17 @@ export const GENERATED_TYPE_UNITS: Readonly<Record<string, UnitsByField>> = {
     traverseVelocity: "n/a",
     type: "id",
   },
+  "ServoSetAngleArgs": {
+    degrees: "°",
+    partId: "id",
+  },
   "ServoSetEnabledArgs": {
     enabled: "flag",
     partId: "id",
   },
-  "ServoSetTargetArgs": {
+  "ServoSetExtensionArgs": {
+    metres: "m",
     partId: "id",
-    value: "ratio",
   },
   "SetActionGroupArgs": {
     group: "id",
@@ -1282,14 +1298,6 @@ export const GENERATED_TYPE_UNITS: Readonly<Record<string, UnitsByField>> = {
     path: "id",
     value: "text",
   },
-  "SolarPanelEntry": {
-    chargeRate: "units/s",
-    deployState: "text",
-    flowRate: "units/s",
-    partId: "id",
-    partName: "text",
-    sunAOA: "°",
-  },
   "SpaceCenterPartsAvailable": {
     count: "count",
   },
@@ -1437,6 +1445,7 @@ export const GENERATED_TYPE_UNITS: Readonly<Record<string, UnitsByField>> = {
   "VesselComms": {
     connected: "flag",
     controlState: "enum",
+    signalQuantity: "enum",
     signalStrength: "ratio",
   },
   "VesselControl": {
@@ -1490,7 +1499,12 @@ export const GENERATED_TYPE_UNITS: Readonly<Record<string, UnitsByField>> = {
     atmosphericTimeToImpact: "s",
     descentRegime: "text",
     dragToWeightRatio: "1",
+    groundTrackDistances: "m",
+    groundTrackElevations: "m",
     outcome: "text",
+    parachuteDeploySafety: "text",
+    parachuteDeployment: "text",
+    parachuteFullDeployAltitude: "m",
     parachuteState: "text",
     predictedBiome: "text",
     predictedLatitude: "°",
@@ -1502,13 +1516,13 @@ export const GENERATED_TYPE_UNITS: Readonly<Record<string, UnitsByField>> = {
     projectedTouchdownSpeed: "m/s",
     roughnessFootprintMeters: "m",
     sampleSource: "text",
+    siteHeights: "m",
+    siteHeightsExtentMeters: "m",
+    siteHeightsSize: "count",
     slopeAngleUnderVessel: "°",
     slopeSampleRadiusMeters: "m",
     terminalVelocity: "m/s",
     terrainElevationUnderVessel: "m",
-    terrainPatch: "m",
-    terrainPatchExtentMeters: "m",
-    terrainPatchSize: "count",
   },
   "VesselManeuver": {
     planner: "id",
@@ -1739,8 +1753,12 @@ export const GENERATED_TOPIC_UNITS: Readonly<Record<string, UnitsByField>> = {
   "comms.signal": {
     modelled: "flag",
     otherPath: "flag",
+    quantity: "enum",
     strength: "ratio",
   },
+  "crash.hasRecent": {
+    recent: "flag",
+  },
   "crash.lastCrash": {
     altitude: "m",
     body: "text",
@@ -1865,6 +1883,9 @@ export const GENERATED_TOPIC_UNITS: Readonly<Record<string, UnitsByField>> = {
   "parts.power": {
     totalProductionEc: "units/s",
   },
+  "recovery.hasRecent": {
+    recent: "flag",
+  },
   "recovery.lastSummary": {
     capturedAtUT: "ut",
     displayReputation: "flag",
@@ -2075,6 +2096,7 @@ export const GENERATED_TOPIC_UNITS: Readonly<Record<string, UnitsByField>> = {
   "vessel.comms": {
     connected: "flag",
     controlState: "enum",
+    signalQuantity: "enum",
     signalStrength: "ratio",
   },
   "vessel.control": {
@@ -2138,7 +2160,12 @@ export const GENERATED_TOPIC_UNITS: Readonly<Record<string, UnitsByField>> = {
     atmosphericTimeToImpact: "s",
     descentRegime: "text",
     dragToWeightRatio: "1",
+    groundTrackDistances: "m",
+    groundTrackElevations: "m",
     outcome: "text",
+    parachuteDeploySafety: "text",
+    parachuteDeployment: "text",
+    parachuteFullDeployAltitude: "m",
     parachuteState: "text",
     predictedBiome: "text",
     predictedLatitude: "°",
@@ -2150,13 +2177,13 @@ export const GENERATED_TOPIC_UNITS: Readonly<Record<string, UnitsByField>> = {
     projectedTouchdownSpeed: "m/s",
     roughnessFootprintMeters: "m",
     sampleSource: "text",
+    siteHeights: "m",
+    siteHeightsExtentMeters: "m",
+    siteHeightsSize: "count",
     slopeAngleUnderVessel: "°",
     slopeSampleRadiusMeters: "m",
     terminalVelocity: "m/s",
     terrainElevationUnderVessel: "m",
-    terrainPatch: "m",
-    terrainPatchExtentMeters: "m",
-    terrainPatchSize: "count",
   },
   "vessel.maneuver": {
     planner: "id",
@@ -2329,6 +2356,9 @@ export const GENERATED_TYPE_SHAPES: Readonly<Record<string, ShapesByField>> = {
     channels: "ChannelGate[]",
     gates: "CommandGate[]",
   },
+  "CommandGroupRequest": {
+    members: "CommandRequest[]",
+  },
   "CommandResponse": {
     meta: "Meta",
   },
@@ -2360,6 +2390,7 @@ export const GENERATED_TYPE_SHAPES: Readonly<Record<string, ShapesByField>> = {
     author: "CommcastAuthor",
   },
   "CommsContactPair": {
+    retargetWindows: "CommsRetargetWindow[]",
     windows: "CommsContactWindow[]",
   },
   "CommsContacts": {
@@ -2387,6 +2418,7 @@ export const GENERATED_TYPE_SHAPES: Readonly<Record<string, ShapesByField>> = {
     nodes: "CommsNetworkNode[]",
   },
   "CommsNodeView": {
+    handle: "CommsNodeHandle",
     position: "Vector3d",
   },
   "CommsOcclusion": {
@@ -2398,6 +2430,10 @@ export const GENERATED_TYPE_SHAPES: Readonly<Record<string, ShapesByField>> = {
   "CommsRoute": {
     holds: "CommsRouteHold[]",
   },
+  "CommsRouteHop": {
+    fromHandle: "CommsNodeHandle",
+    toHandle: "CommsNodeHandle",
+  },
   "CommsRoutes": {
     routes: "CommsRoute[]",
   },
@@ -2442,6 +2478,9 @@ export const GENERATED_TYPE_SHAPES: Readonly<Record<string, ShapesByField>> = {
     breach: "LimitBreach",
     missing: "MissingUnlock[]",
   },
+  "ICommandGateInputs": {
+    inputs: "GateInput[]",
+  },
   "IControlFrameSource": {
     frame: "ControlFrame",
   },
@@ -2478,12 +2517,6 @@ export const GENERATED_TYPE_SHAPES: Readonly<Record<string, ShapesByField>> = {
     actions: "PartActionEntry[]",
     meta: "PayloadMeta",
   },
-  "PartsPower": {
-    alternators: "AlternatorEntry[]",
-    batteries: "BatteryEntry[]",
-    fuelCells: "FuelCellEntry[]",
-    solarPanels: "SolarPanelEntry[]",
-  },
   "PendingUplinkQueue": {
     pending: "PendingUplink[]",
   },
@@ -2718,12 +2751,6 @@ export const GENERATED_TOPIC_SHAPES: Readonly<Record<string, ShapesByField>> = {
   "missions.active": {
     objectives: "MissionObjectiveEntry[]",
   },
-  "parts.power": {
-    alternators: "AlternatorEntry[]",
-    batteries: "BatteryEntry[]",
-    fuelCells: "FuelCellEntry[]",
-    solarPanels: "SolarPanelEntry[]",
-  },
   "recovery.lastSummary": {
     crewBreakdown: "RecoveryCrewEntry[]",
     partBreakdown: "RecoveryPartEntry[]",
@@ -2867,6 +2894,7 @@ export const GENERATED_TYPE_ENUMS: Readonly<Record<string, EnumsByField>> = {
   },
   "CommsHop": {
     kind: "CommsHopKind",
+    quantity: "SignalQuantity",
   },
   "CommsJourneyEvent": {
     kind: "JourneyEventKind",
@@ -2874,6 +2902,9 @@ export const GENERATED_TYPE_ENUMS: Readonly<Record<string, EnumsByField>> = {
   "CommsNetworkNode": {
     kind: "CommsHopKind",
   },
+  "CommsSignal": {
+    quantity: "SignalQuantity",
+  },
   "ControlFrame": {
     kind: "ControlFrameKind",
   },
@@ -2974,6 +3005,7 @@ export const GENERATED_TYPE_ENUMS: Readonly<Record<string, EnumsByField>> = {
   },
   "VesselComms": {
     controlState: "ControlState",
+    signalQuantity: "SignalQuantity",
   },
   "VesselControl": {
     sasMode: "SasMode",
@@ -3024,6 +3056,9 @@ export const GENERATED_TOPIC_ENUMS: Readonly<Record<string, EnumsByField>> = {
   "comms.delay": {
     source: "CommsDelaySource",
   },
+  "comms.signal": {
+    quantity: "SignalQuantity",
+  },
   "deployed.bases": {
     power: "DeployedPowerState",
   },
@@ -3048,6 +3083,7 @@ export const GENERATED_TOPIC_ENUMS: Readonly<Record<string, EnumsByField>> = {
   },
   "vessel.comms": {
     controlState: "ControlState",
+    signalQuantity: "SignalQuantity",
   },
   "vessel.control": {
     sasMode: "SasMode",
@@ -3326,6 +3362,12 @@ export const GENERATED_ENUM_MEMBERS: Readonly<Record<string, Readonly<Record<num
     3: "Defaults",
     4: "Unreadable",
   },
+  "SignalQuantity": {
+    0: "Unknown",
+    1: "RangeFraction",
+    2: "DataRateHeadroom",
+    3: "NoModel",
+  },
   "Situation": {
     0: "Landed",
     1: "Splashed",

package/src/api/alarm-request.ts

@@ -130,7 +130,12 @@ export interface UplinkAlarmRequest {
  *
  * @example
  * ```tsx
- * const MY_UPLINK = defineUplinkClient({ id: "myuplink", version: "1.0.0", name: "My Uplink" });
+ * const MY_UPLINK = defineUplinkClient({
+ *   id: "myuplink",
+ *   version: "1.0.0",
+ *   name: "My Uplink",
+ *   description: "Reminds the operator when a facility upgrade finishes.",
+ * });
  *
  * function RemindMe({ facility, finishesAtUt }: { facility: string; finishesAtUt: number }) {
  *   const requestAlarm = useAlarmRequest(MY_UPLINK);
@@ -149,5 +154,6 @@ export interface UplinkAlarmRequest {
 export function useAlarmRequest(
   owner: UplinkClientHandle,
 ): (request: UplinkAlarmRequest) => void {
+  // gonogo:reads none
   return getHost().useAlarmRequest(owner);
 }

package/src/api/contribution-slots.ts

@@ -40,7 +40,7 @@
 // pressure, ...) whose tone genuinely is a state rather than an identity.
 // ---------------------------------------------------------------------------
 
-import type { Reading } from "../reading";
+import type { HeldGrade, Reading } from "../reading";
 import type { ReadFrameChoice } from "../spine/reference-frame";
 import type { Value } from "../unit-system/value";
 import type { AlertTone, Tone } from "./tone";
@@ -94,20 +94,34 @@ export interface ShipMapPartMeterEntry {
  *
  * @category Widget slots
  */
-export interface ShipMapPartMetaEntry {
+export type ShipMapPartMetaEntry = {
   /** The part's `flightId`, as a decimal string. */
   partId: string;
   /** The row's label, such as `"Water Recycler"`. */
   label: string;
-  /** The status colour of a `"ratio"` row's meter. */
-  tone: Tone;
-  /** `"ratio"` draws `value` as a meter; `"text"` draws `text` beside the label. */
-  kind: "ratio" | "text";
-  /** A fraction from 0 to 1, read when `kind` is `"ratio"`. Absent draws an empty meter. */
-  value?: number;
-  /** Free text, read when `kind` is `"text"`. */
-  text?: string;
-}
+  /**
+   * The reading the row was drawn from, or just its grade. Only a held reading
+   * changes anything, so it can be passed unconditionally; while it is held the
+   * meter or text is drawn with the held mark.
+   */
+  held?: HeldGrade | Reading<unknown>;
+} & (
+  | {
+      /** `"ratio"` draws `value` as a meter; `"text"` draws `text` beside the label. */
+      kind: "ratio";
+      /** The status colour of the row's meter. */
+      tone: Tone;
+      /** A fraction from 0 to 1. Absent draws an empty meter. */
+      value?: number;
+    }
+  | {
+      kind: "text";
+      /** A text row never draws a tone, so it may be left out. */
+      tone?: Tone;
+      /** Free text, drawn beside the label. */
+      text?: string;
+    }
+);
 
 /**
  * The bitrate of one hop on the comms route, contributed to
@@ -127,6 +141,12 @@ export interface CommSignalHopRateEntry {
   toNodeId: string;
   /** The hop's forward data rate in bits per second. */
   bitsPerSec: number;
+  /**
+   * The reading the rate was read from, or just its grade. Only a held reading
+   * changes anything, so it can be passed unconditionally; while it is held
+   * the rate is drawn with the held mark.
+   */
+  held?: HeldGrade | Reading<unknown>;
 }
 
 /**
@@ -166,8 +186,13 @@ export type SystemEntityMeta = Readonly<
 >;
 
 /**
- * A place on a Keplerian orbit around a named body. `trueAnomaly` picks the
- * point on it; a shape that draws the whole orbit ignores it.
+ * A place on a Keplerian orbit around a named body. `epoch` and
+ * `meanAnomalyAtEpoch` say where on it the entity was at one instant; the
+ * widget carries it forward to the instant on screen, so a contribution never
+ * advances an orbit and a stale one cannot freeze a marker.
+ *
+ * A shape that draws only the whole orbit may leave both out, and then marks no
+ * place on the ring. A point needs both, and is not drawn without them.
  *
  * @category Widget slots
  */
@@ -185,8 +210,10 @@ export interface SystemEntityOrbitPosition {
   argPe: number;
   /** Inclination to the parent's reference plane, in degrees. Required: an equatorial orbit says `0`. */
   inclination: number;
-  /** True anomaly, in degrees. */
-  trueAnomaly: number;
+  /** The UT the mean anomaly is for, in seconds. */
+  epoch?: number;
+  /** Mean anomaly at `epoch`, in radians. */
+  meanAnomalyAtEpoch?: number;
 }
 
 /**
@@ -208,14 +235,34 @@ export interface SystemEntityFixedPosition {
 }
 
 /**
- * Where a System View entity is: on an orbit, or at a fixed offset from a body.
- * An entity whose position holds a non-finite number is not drawn.
+ * A place given by the body it is: the widget puts the entity where that body
+ * is at the instant on screen, in whatever frame the diagram draws in, and
+ * marks it held when the body's place is. The body need not orbit the body the
+ * diagram is centred on.
+ *
+ * @category Widget slots
+ */
+export interface SystemEntitySubjectPosition {
+  kind: "subject";
+  /** What is placed. */
+  subject: {
+    kind: "body";
+    /** The body's index in `system.bodies`. */
+    bodyIndex: number;
+  };
+}
+
+/**
+ * Where a System View entity is: on an orbit, at a fixed offset from a body, or
+ * where a named body is. An entity whose position holds a non-finite number is
+ * not drawn.
  *
  * @category Widget slots
  */
 export type SystemEntityPosition =
   | SystemEntityOrbitPosition
-  | SystemEntityFixedPosition;
+  | SystemEntityFixedPosition
+  | SystemEntitySubjectPosition;
 
 /**
  * What a System View entity looks like, by `kind`:
@@ -272,6 +319,12 @@ export interface SystemEntity {
   vesselId?: string;
   /** Stacking order that overrides the shape's default layer; higher is in front. Ties keep contribution order. */
   zHint?: number;
+  /**
+   * How well the entity's place is known, when the contribution knows it is not
+   * current: `"held"` draws it dimmed and dashed and says so in its name. Absent
+   * is as current as a position the widget computed itself.
+   */
+  currency?: "held";
 }
 
 /**
@@ -344,6 +397,14 @@ export interface CrewRowToneEntry {
   crewName: string;
   /** How alarming the situation is. The widget picks the colour. */
   tone: AlertTone;
+  /**
+   * The reading the tone was judged from, or just its grade. Only a held
+   * reading changes anything, so it can be passed unconditionally. While it is
+   * held the row is tinted by the grade's own severity in place of `tone`, as a
+   * held badge is, so a judgement made on data that stopped arriving is never
+   * shown as current.
+   */
+  held?: HeldGrade | Reading<unknown>;
 }
 
 /**
@@ -365,7 +426,13 @@ export interface StrategiesScreenEntry {
   label: string;
   /** Sort position, ascending; ties keep contribution order. A screen without one sorts after every screen that has one. */
   order?: number;
-  /** The department names whose strategies this screen lists, matched against each strategy's department in `career.status`. None lists nothing, leaving the screen to its augments. */
+  /**
+   * The department names whose strategies this screen lists, matched exactly
+   * against each strategy's department in `career.status`. Stock KSP's
+   * departments are `"Finances"`, `"Operations"`, `"Public Relations"` and
+   * `"Research & Development"`; a career mod can name others. None lists
+   * nothing, leaving the screen to its augments.
+   */
   departments?: readonly string[];
   /**
    * `false` for a screen that exists but cannot be used yet. Its tab is still
@@ -378,7 +445,8 @@ export interface StrategiesScreenEntry {
   /**
    * True when the screen's `strategies.screen-body` augment draws its own
    * controls for activating and deactivating its strategies, such as a
-   * Programs screen offering Accept and Complete. The widget then draws that
+   * Programs tab a career mod's Uplink contributes, offering Accept and
+   * Complete in place of Activate and Deactivate. The widget then draws that
    * screen's cards with no Activate or Deactivate button, and with no price or
    * commitment factor: the augment shows what its own controls cost.
    */
@@ -514,6 +582,13 @@ export interface SpaceCenterFacilityEntry {
   currentTierText?: string;
   /** The same, for the tier an upgrade would buy. */
   nextTierText?: string;
+  /**
+   * The reading the tier was read from, or just its grade. Only a held reading
+   * changes anything, so a contribution can pass its reading unconditionally.
+   * While it is held the widget draws the tier as held, dated by the reading's
+   * `asOfUt` where it has one.
+   */
+  held?: HeldGrade | Reading<unknown>;
 }
 
 // The plot SUBJECTS `packages/components` draws, declared so a contributor

package/src/api/coverage/CoverageMaskCache.ts

@@ -22,7 +22,7 @@ interface CacheOptions {
 }
 
 /**
- * The width, in pixels, of a new coverage mask.
+ * The width, in cells, of a new coverage mask: the cells across its 360 degrees of longitude.
  *
  * @category Maps and coverage
  */

package/src/api/coverage-source.ts

@@ -73,7 +73,9 @@ export function onCoverageSourcesChange(cb: () => void): () => void {
 }
 
 /**
- * Adds a coverage source, replacing any registered under the same id.
+ * Adds a coverage source: a layer of the body map that reveals the cells the
+ * source reports as covered, such as the ground a scanner has mapped.
+ * Registering a second source with an id already in use replaces the first.
  *
  * @category Maps and coverage
  * @categoryDescription Maps and coverage

package/src/api/framework-reads.ts

@@ -0,0 +1,29 @@
+/**
+ * Topic ids the framework subscribes to on a widget's behalf, keyed by the hook
+ * or component that does it. A widget that sends a command with `useCommand`,
+ * or is mounted by the dashboard, does not declare them: a widget's `channels`
+ * leave them out, and its reference page never lists them. Some are registered
+ * at runtime rather than listed in the contract, so the ids are plain strings.
+ *
+ * @category Reading telemetry
+ */
+export const FRAMEWORK_READS = {
+  /** What `useCommand` reads: the pending and gated commands, and the link and delay they wait on. */
+  useCommand: [
+    "system.uplink.pending",
+    "system.uplink.gates",
+    "comms.link",
+    "comms.delay",
+  ],
+  /** What the guard that replaces a locked widget reads: Uplink health, the scene and the career mode. */
+  RequiresGuard: [
+    "system.uplinkHealth",
+    "spaceCenter.scene",
+    "spaceCenter.state",
+    "career.mode",
+  ],
+  /** What the control stream reads to know which orbit the craft is on. */
+  useControlStream: ["vessel.orbit"],
+  /** What a lock scope reads to know which Topics an Uplink has gated. */
+  useLockScope: ["system.uplink.gates"],
+} as const satisfies Record<string, readonly string[]>;