@ksp-gonogo/ui-kit 1.0.0-rc.21 → 1.0.0-rc.25

package/dist/index.d.ts

@@ -1,10 +1,10 @@
-import { AugmentDefinition, NamespacedAugmentSettings, SlotProps, Tone, Value, Reading, UncertaintyBand, BadgeEntry, BandKind, RailTags, RailDirection, RailContinuity, RailDelivery, CommandErrorCode, LimitBreach, ContributionSlotId, Contributed, ContributionEntry, ComponentSlotSegment, ComponentSlotRegistry, CelestialFacts, CelestialBody, HeldGrade, SeriesReckonedSpan, LockedValue, StreamStatusValue, ReckoningBasis, ComponentDefinition, TinyEssential, ComponentProps, PointUnit, WidgetScope } from '@ksp-gonogo/sitrep-sdk';
-export { AlertTone, AugmentDefinition, AugmentSettingField, BadgeEntry, ComponentSlotRegistry, ComponentSlotSegment, Contributed, ContributionEntry, ContributionRegistry, ContributionSlotId, KspCalendar, NamespacedAugmentSettings, Quantityish, RailContinuity, RailDelivery, RailDirection, RailTags, STANDARD_GRAVITY, STOCK_KERBIN_CALENDAR, SlotId, SlotProps, SlotRegistry, TINY_SIZE, Tone, UplinkClientIdentity, WidgetScope, WidgetScopeRegistry, asQuantityish, kspCalendar, kspYearDays, magnitudeOf, magnitudeOr, setKspCalendar } from '@ksp-gonogo/sitrep-sdk';
+import { AugmentDefinition, NamespacedAugmentSettings, SlotProps, Tone, Value, Reading, UncertaintyBand, HeldGrade, BadgeEntry, RailTags, RailDirection, SampleKind, RailDelivery, CommandErrorCode, LimitBreach, ContributionSlotId, Contributed, ContributionEntry, ComponentSlotSegment, ComponentSlotRegistry, SystemPoses, CelestialBody, SeriesReckonedSpan, LockedValue, StreamStatusValue, ReckoningBasis, ComponentDefinition, TinyEssential, ComponentProps, PointUnit, WidgetScope } from '@ksp-gonogo/sitrep-sdk';
+export { AlertTone, AugmentDefinition, AugmentSettingField, BadgeEntry, ComponentSlotRegistry, ComponentSlotSegment, Contributed, ContributionEntry, ContributionRegistry, ContributionSlotId, KspCalendar, NamespacedAugmentSettings, Quantityish, RailDelivery, RailDirection, RailTags, STANDARD_GRAVITY, STOCK_KERBIN_CALENDAR, SlotId, SlotProps, SlotRegistry, TINY_SIZE, Tone, UplinkClientIdentity, WidgetScope, WidgetScopeRegistry, asQuantityish, kspCalendar, kspYearDays, magnitudeOf, magnitudeOr, setKspCalendar } from '@ksp-gonogo/sitrep-sdk';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as react from 'react';
 import { ReactNode, CSSProperties, ComponentType, ReactElement, HTMLAttributes, ButtonHTMLAttributes, ComponentPropsWithoutRef, RefAttributes, SVGProps, ElementType, InputHTMLAttributes, FocusEvent, RefObject } from 'react';
-import { F as FormatQuantityOptions, a as FormatsFor, P as PresentableAs, U as UnitGroupKey, b as FormatsForKind, K as KindOfGroup, c as PresentableAsKind } from './units-Cl-8ZdJc.js';
-export { d as KnownQuantityKind, L as LadderName, Q as QuantityKind, e as QuantityScale, R as Rung, q as quantityScale, s as setQuantityLocale, f as speakQuantity, w as writeQuantity } from './units-Cl-8ZdJc.js';
+import { F as FormatQuantityOptions, a as FormatsFor, P as PresentableAs, U as UnitGroupKey, b as FormatsForKind, K as KindOfGroup, c as PresentableAsKind } from './units-DZYIWBWP.js';
+export { C as ConversionTargetsOfKind, d as KindOfSymbol, e as KnownQuantityKind, L as LadderName, f as LadderOfSymbol, Q as QuantityKind, g as QuantityScale, R as Rung, S as SymbolsOfKind, q as quantityScale, s as setQuantityLocale, h as speakQuantity, w as writeQuantity } from './units-DZYIWBWP.js';
 import * as styled_components_dist_types from 'styled-components/dist/types.js';
 import * as styled_components from 'styled-components';
 export { COL_WIDTH, GRID_MARGIN, ROW_HEIGHT, gridToPixels } from './gridUnits.js';
@@ -201,14 +201,14 @@ declare module "styled-components" {
 interface ActionMenuItem {
     /** Stable id handed back to `onSelect`. */
     key: string;
-    /** The item's visible text, and its accessible name unless `ariaLabel` is set. */
+    /** The item's visible text, and its accessible name unless `aria-label` is set. */
     label: string;
     /** Optional grouping header; ungrouped items collapse into one flat list. */
     group?: string;
     /** Present but not currently firable: rendered dimmed and inert, still reachable. */
     disabled?: boolean;
     /** Overrides the accessible name when `label` alone is ambiguous out of context. */
-    ariaLabel?: string;
+    "aria-label"?: string;
 }
 /**
  * Props for {@link ActionMenu}.
@@ -223,7 +223,7 @@ interface ActionMenuProps {
     /** Escape, Tab, or an outside pointer press. The caller restores trigger focus. */
     onDismiss: () => void;
     /** Accessible name for the menu itself: `role="menu"` needs one. */
-    ariaLabel: string;
+    "aria-label": string;
     /** Positioning (the caller owns anchoring); merged over the menu's own frame styles. */
     style?: CSSProperties;
     /** Rendered above the items: a title row, a pending indicator, a delay readout. */
@@ -262,7 +262,7 @@ interface ActionMenuProps {
  *         { key: "deploy", label: "Deploy chute" },
  *         { key: "cut", label: "Cut chute", disabled: !deployed },
  *       ]}
- *       ariaLabel="Parachute actions"
+ *       aria-label="Parachute actions"
  *       style={{ position: "static" }}
  *       onSelect={(key) => {
  *         fire(key);
@@ -276,7 +276,7 @@ interface ActionMenuProps {
  *
  * @category Floating
  */
-declare function ActionMenu({ items, onSelect, onDismiss, ariaLabel, style, header, footer, emptyLabel, otherLabel, }: Readonly<ActionMenuProps>): react_jsx_runtime.JSX.Element;
+declare function ActionMenu({ items, onSelect, onDismiss, "aria-label": ariaLabel, style, header, footer, emptyLabel, otherLabel, }: Readonly<ActionMenuProps>): react_jsx_runtime.JSX.Element;
 
 /**
  * One selectable capture device.
@@ -747,25 +747,34 @@ declare function useAugmentAvailable(augment: AnyAugment): boolean;
  * accepts. Each names what the space is for, and resolves to the `--gap-*`
  * CSS variable of the same name.
  *
- * - `related` and `section`: between related items, and between sections.
- *   Both are smaller inside a {@link Card} than on a panel
- * - `related-comfortable`, `related-compact`, `related-dense`,
- *   `related-packed`, `section-comfortable` and `section-compact`: the same
- *   two spacings at one fixed density, whatever the container
- * - `rows`: between stacked rows that carry their own padding
- * - `caption`: under the line a caption belongs to
- * - `readout-row` and `label-value`: between the rows and between the columns
- *   of a label/value grid
+ * - `related` and `section`: between related items, and between sections:
+ *   8px and 16px on a panel, 6px and 12px inside a {@link Card}
+ * - `related-comfortable` (8px), `related-compact` (6px), `related-dense`
+ *   (4px), `related-packed` (2px), `section-comfortable` (16px) and
+ *   `section-compact` (12px): the same two spacings at one fixed density,
+ *   whatever the container
+ * - `rows` (2px): between stacked rows that carry their own padding
+ * - `caption` (2px): under the line a caption belongs to
+ * - `readout-row` (2px) and `label-value` (8px): between the rows and between
+ *   the columns of a label/value grid
+ *
+ * The pixel values are the default sheet's; a host that mounts its own sheet
+ * may change them.
  *
  * @category Layout
  */
 type GapToken = "related" | "section" | "related-comfortable" | "related-compact" | "related-dense" | "related-packed" | "section-comfortable" | "section-compact" | "rows" | "caption" | "readout-row" | "label-value";
 /**
  * The padding names {@link Box}'s `pad` prop accepts, each resolving to the
- * `--inset-*` CSS variable of the same name: `chip`, `chip-roomy` and
- * `chip-readout` for small pills, `pill` for a stadium, `surface` and
- * `surface-standalone` for a block's own padding, `popover` for a floating
- * card.
+ * `--inset-*` CSS variable of the same name, given here as vertical then
+ * horizontal padding in the default sheet:
+ *
+ * - `chip` (1px 6px), `chip-roomy` (1px 8px) and `chip-readout` (2px 8px):
+ *   small pills
+ * - `pill` (6px 12px): a stadium
+ * - `surface` (6px 8px) and `surface-standalone` (10px 12px): a block's own
+ *   padding
+ * - `popover` (8px all round): a floating card
  *
  * @category Layout
  */
@@ -786,6 +795,7 @@ interface AutoEmptyStateProps extends HTMLAttributes<HTMLDivElement> {
     fallback: ReactNode;
     /** Gap between rendered children. Defaults to `related-dense`. */
     gap?: GapToken;
+    /** The content that may render nothing; when every child renders nothing, `fallback` shows instead. */
     children?: ReactNode;
 }
 /**
@@ -796,18 +806,94 @@ interface AutoEmptyStateProps extends HTMLAttributes<HTMLDivElement> {
  *
  * @example
  * ```tsx
- * // Each SensorRow renders null for a sensor that is switched off.
- * <AutoEmptyState fallback={<EmptyState>No sensors active</EmptyState>}>
- *   {sensors.map((s) => (
- *     <SensorRow key={s.id} sensor={s} />
- *   ))}
- * </AutoEmptyState>
+ * import { AutoEmptyState, EmptyState, Text } from "@ksp-gonogo/ui-kit";
+ *
+ * interface Sensor {
+ *   id: string;
+ *   name: string;
+ *   on: boolean;
+ * }
+ *
+ * // Renders nothing for a sensor that is switched off.
+ * function SensorRow({ sensor }: { sensor: Sensor }) {
+ *   return sensor.on ? <Text>{sensor.name}</Text> : null;
+ * }
+ *
+ * function Sensors({ sensors }: { sensors: readonly Sensor[] }) {
+ *   return (
+ *     <AutoEmptyState fallback={<EmptyState>No sensors active</EmptyState>}>
+ *       {sensors.map((s) => (
+ *         <SensorRow key={s.id} sensor={s} />
+ *       ))}
+ *     </AutoEmptyState>
+ *   );
+ * }
  * ```
  *
  * @category EmptyState
  */
 declare function AutoEmptyState({ fallback, gap, children, ...rest }: AutoEmptyStateProps): react_jsx_runtime.JSX.Element;
 
+/**
+ * One person in an {@link AvatarStack}.
+ *
+ * @category Badge
+ */
+interface AvatarStackItem {
+    /** Stable key. */
+    id: string;
+    /** The full name: the avatar's tooltip and accessible name. The initials are drawn from it. */
+    name: string;
+    /** Colours the avatar's edge and initials. Absent, neutral. */
+    tone?: Tone;
+    /** Makes this avatar a button that calls this when pressed. Absent, the avatar is not a control. */
+    onSelect?: () => void;
+}
+/**
+ * Props for {@link AvatarStack}.
+ *
+ * @category Badge
+ */
+interface AvatarStackProps {
+    /** Everyone to show, in order. The first ones are drawn and the rest fold into the overflow count. */
+    items: readonly AvatarStackItem[];
+    /**
+     * How many places the stack has, the overflow count included. The stack
+     * reserves this many places whatever `items` holds, so it never changes size.
+     * Absent, 3.
+     */
+    max?: number;
+    /** Names the group for assistive technology, when it is not already labelled by its surroundings. */
+    label?: string;
+}
+/**
+ * Up to two letters standing for a name: the first letters of its first two
+ * words, or the first two letters of a single word.
+ *
+ * @category Badge
+ */
+declare function initialsOf(name: string): string;
+/**
+ * A row of small round initials badges, overlapped, for showing who is
+ * involved in something without room for their names. Each avatar's tooltip
+ * and accessible name is the full name.
+ *
+ * Its footprint is fixed by `max` and never by the number of items: with more
+ * people than places, the last place becomes a "+k" count whose tooltip lists
+ * the names it hides, and with fewer the unused places stay empty.
+ *
+ * @example
+ * ```tsx
+ * <AvatarStack
+ *   label="Speaking"
+ *   items={[{ id: "a", name: "Ares 4" }, { id: "w", name: "Woomera Range" }]}
+ * />
+ * ```
+ *
+ * @category Badge
+ */
+declare function AvatarStack({ items, max, label, }: AvatarStackProps): react_jsx_runtime.JSX.Element;
+
 /**
  * A point in viewport (client) coordinates.
  *
@@ -909,7 +995,9 @@ interface BadgeProps extends HTMLAttributes<HTMLSpanElement> {
      * can summarise it. `id` must be stable for the badge's lifetime. `label`
      * defaults to the badge's text content when `children` is a plain string; pass
      * it explicitly otherwise. A `go` badge with `report` still registers, but
-     * any worse state in the panel wins the summary over it.
+     * any worse state in the panel wins the summary over it. Outside a panel
+     * there is no store to register into, so `report` does nothing and the badge
+     * draws as usual.
      */
     report?: {
         id: string;
@@ -920,7 +1008,8 @@ interface BadgeProps extends HTMLAttributes<HTMLSpanElement> {
 }
 /**
  * A compact uppercase pill that shows a label in one `Tone`. A stateful tone
- * (`info`, `go`, `caution`, `warn`, `nogo` or `offline`) draws an outlined
+ * (`info`, `go`, `caution`, `warn`, `nogo` or `offline`; `Tone` has the full
+ * set and `Button` takes a narrower one) draws an outlined
  * pill in that tone's colour, with a glow that grows with severity; no tone, or `neutral`, draws
  * a grey rounded chip for a kind tag or a count. The panel's summary badge and
  * {@link StreamStatusBadge} are both drawn with it.
@@ -1063,13 +1152,14 @@ interface Resolved<Unit extends string> {
      */
     mark: ReckoningKind | null;
     /**
-     * Whether the number is a fact the contract declares static, which is never
+     * Whether the number is a fact the contract declares static (one that never
+     * changes, such as a body's radius), which is never
      * old and so is never marked held, whatever the reading's state.
      */
     isStatic: boolean;
     /**
      * Whether the number is exact at any instant: computed from fixed inputs and
-     * the clock, as a figure between two bodies on fixed conics is. It moves, so
+     * the clock, as a figure between two bodies on fixed conics (orbits that never change) is. It moves, so
      * it is not static, and it is never a guess, so it takes no held or modelled
      * mark whatever the reading's state.
      */
@@ -1098,7 +1188,8 @@ interface CurrencyOptions {
      * than its observation: a countdown, or a figure a widget solves forward.
      * The modelled figure is then marked wherever it is not a reading of now,
      * which under signal delay includes a current reading carried forward to the
-     * craft's own present (SCET, spacecraft event time).
+     * craft's own present (SCET, spacecraft event time: when the event happens
+     * at the craft, rather than when its telemetry reaches the command centre).
      */
     readonly drawsReckoning?: boolean;
 }
@@ -1143,9 +1234,38 @@ interface ReckoningMarking {
  *
  * @category Unit
  */
-declare function derivedMarking(reading: Reading<unknown> | null | undefined, 
+declare function derivedMarking(
+/** The reading the figure was computed from. Null or undefined gives no mark. */
+reading: Reading<unknown> | null | undefined, 
 /** The figure is carried by a model that the reading itself does not name, such as a position the map models from the orbit. */
 carried?: boolean): ReckoningMarking | null;
+/**
+ * How a figure is marked from a `held` field: the reading the figure was drawn
+ * from, or just its grade, as a contributed entry or an augment slot's props
+ * carry it. `null` unless that reading is held or modelled, so the reading can
+ * be passed unconditionally. The same marking {@link derivedMarking} gives.
+ *
+ * @category Unit
+ */
+declare function heldMarking(held: HeldGrade | Reading<unknown> | undefined): ReckoningMarking | null;
+/**
+ * The held grade of a `held` field, for something drawn as a verdict (a tone,
+ * a badge) rather than a figure: `undefined` unless the reading it names is
+ * held. A held reading derived from several, which may carry no single grade,
+ * reads as plain `"held"`.
+ *
+ * @category Unit
+ */
+declare function heldGradeOf(held: HeldGrade | Reading<unknown> | undefined): HeldGrade | undefined;
+/**
+ * A figure as the reading its `held` field says it came from: the figure
+ * itself while that reading is current, and a held reading of it, dated by the
+ * reading's `asOfUt` where it has one, while it is held. Hand the result to
+ * any primitive that takes a {@link UnitValue}.
+ *
+ * @category Unit
+ */
+declare function heldFigureOf<Unit extends string>(figure: Value<Unit>, held: HeldGrade | Reading<unknown> | undefined): UnitValue<Unit>;
 
 /**
  * Props for {@link Unit}. The formatter options it extends (`decimals`, `scale` and the rest) apply to the number drawn.
@@ -1205,6 +1325,7 @@ interface UnitProps<UnitSymbol extends string = string> extends Omit<FormatQuant
     elsewhere?: string | null;
     /** A bare unit token, rendered as a symbol with no number. Used only when `value` is not passed; prefer passing a value. */
     children?: ReactNode;
+    /** A class for the outer element, so a styled-component can extend it. */
     className?: string;
 }
 /**
@@ -1219,13 +1340,13 @@ interface UnitProps<UnitSymbol extends string = string> extends Omit<FormatQuant
  *
  * With `reckoned`, a reading with a model draws the model's figure and marks it modelled (a blue triangle) wherever it is not a reading of now.
  *
- * The mark is out of flow, so a column never reflows when a channel goes quiet, and it is not a live region: a widget that wants the change announced wraps its readout in `role="status"`. Without `reckoned` it never draws a reckoned figure.
+ * The mark is out of flow, so a column never reflows when a channel goes quiet, and it is not a live region: a widget that wants the change announced wraps its readout in `role="status"`. Without `reckoned` it never draws a reckoned figure, so a modelled value never passes for an observed one; do not pull a figure out of a reading's reckoning and hand it to a plain `Unit`.
  *
  * A held reading whose model publishes an {@link UncertaintyBand} also shows the interval (`1 km ± 0.025 km`, `1 km (0.97 to 1.03 km)`, `1 km (~1.2 km)`). A current reading shows none, and a band in another unit draws nothing.
  *
- * The symbol is sized relative to the text around it (never below 10px) and takes its colour, so it needs no size or tone prop and keeps the value's tone at the value's contrast. Plane angles attach to the number and keep full size. Every symbol is replaced in the accessibility tree by its spoken word.
+ * The symbol is sized relative to the text around it (never below 10px) and takes its colour, so it needs no size or tone prop and keeps the value's tone at the value's contrast. A symbol that attaches to the number (`22°`, but `22 °C`) is set with no space and keeps full size: the plane-angle marks and the currency marks. Every symbol is replaced in the accessibility tree by its spoken word.
  *
- * `<Unit>` is the one way to put a quantity on screen. Hand it the value as it arrived (SI, never pre-scaled) and let it choose the unit; pin one with `format` or convert with `as` only where convention calls for it.
+ * `<Unit>` is the way to put a quantity on screen as a React node. Where only text is accepted (an SVG `<text>`, a tooltip, a canvas), write it with {@link writeQuantity} instead. Hand it the value as it arrived (SI, never pre-scaled) and let it choose the unit; pin one with `format` or convert with `as` only where convention calls for it.
  *
  * @example
  * ```tsx
@@ -1250,10 +1371,12 @@ interface UnitProps<UnitSymbol extends string = string> extends Omit<FormatQuant
  *
  * @category Unit
  * @categoryDescription Unit
- * Drawing a quantity: a value with its unit, formatted the same way everywhere,
- * marked when it is held or reckoned instead of current, with bands for a
- * figure known only within limits and the null token for no value. Every number
- * with a unit is drawn through a {@link Unit}.
+ * Drawing a quantity. A {@link Unit} puts a value with its unit on screen,
+ * formatted the same way everywhere, and every number with a unit is drawn
+ * through one. Around it sit the marks for a figure that is held or modelled
+ * instead of current, the bands for a figure known only within limits, the
+ * null token for no value, and the helpers that write a quantity as text where
+ * a node will not do.
  */
 declare function Unit<UnitSymbol extends string = string>({ value, children, className, hideUnitInGroup, reckoned, marked, elsewhere, ...opts }: UnitProps<UnitSymbol>): react_jsx_runtime.JSX.Element;
 
@@ -1281,6 +1404,7 @@ interface BandProps<UnitSymbol extends string = string> extends Pick<UnitProps<U
      * the way round instead of printing a meaningless width.
      */
     wrapsAt?: number;
+    /** A class for the outer element, so a styled-component can extend it. */
     className?: string;
 }
 /**
@@ -1390,9 +1514,14 @@ declare function BlockRoot({ ...props }: BlockProps): ReactNode;
  *
  * `titleRight` is not `right`: `titleRight` holds badges on the name's line and
  * wraps under the name when narrow, while `right` sits beside the whole body
- * and drops below it when narrow. The parts (`Block.Title`, `Block.TitleRow`,
- * `Block.Body`, `Block.Aside`, `Block.Footer`) are there for a record that
- * needs its own composition but the same type and spacing.
+ * and drops below it when narrow. The parts are there for a record that needs
+ * its own composition but the same type and spacing:
+ *
+ *   - `Block.Title`: the heading text, sized and weighted as the `title` prop is
+ *   - `Block.TitleRow`: the title's line, holding `left`, the title and `right` badges
+ *   - `Block.Body`: the figures under the title
+ *   - `Block.Aside`: content beside or below the body (the `left`, `right`, `top` and `bottom` props)
+ *   - `Block.Footer`: the line of actions at the foot
  *
  * @example
  * ```tsx
@@ -1431,8 +1560,8 @@ type BoxSurface = "app" | "panel" | "raised" | "sunken";
 /**
  * The corner radii {@link Box} accepts: `regular` for ordinary controls, rows
  * and cards, `floating` for something that sits above the app (a dialog, a
- * menu), and `pill` for a fully rounded stadium. The display-frame corner is
- * reserved for {@link FramedDisplay}.
+ * menu), and `pill` for a fully rounded stadium. {@link FramedDisplay} has a corner
+ * of its own that a `Box` cannot take.
  *
  * @category Layout
  */
@@ -1458,6 +1587,7 @@ interface BoxProps extends HTMLAttributes<HTMLDivElement> {
     bordered?: boolean;
     /** Corner radius. Omit for square corners. */
     radius?: BoxRadius;
+    /** The content inside the padding and border. */
     children?: ReactNode;
 }
 /**
@@ -1549,17 +1679,29 @@ interface ButtonProps extends ButtonHTMLAttributes<HTMLButtonElement> {
 declare const Button: react.ForwardRefExoticComponent<ButtonProps & react.RefAttributes<HTMLButtonElement>>;
 /**
  * A subtle, underlined link-style `button` for a tertiary action inside copy
- * (such as "Clear all" in a list row). For a paired Cancel and Confirm row,
- * use a ghost {@link Button} beside a primary one.
+ * (such as "Clear all" in a list row). It renders a native `button` and takes
+ * every prop that element does. For a paired Cancel and Confirm row, use a
+ * ghost {@link Button} beside a primary one. For words that are themselves the
+ * control and should keep the surrounding text's colour and type, use a
+ * {@link Button} with `variant="text"` instead.
  *
  * @category Button
  */
 declare const TextButton: styled_components_dist_types.IStyledComponentBase<"web", styled_components.FastOmit<react.DetailedHTMLProps<ButtonHTMLAttributes<HTMLButtonElement>, HTMLButtonElement>, never> & Partial<Pick<react.DetailedHTMLProps<ButtonHTMLAttributes<HTMLButtonElement>, HTMLButtonElement>, never>>> & string;
+/**
+ * Props for {@link IconButton}. Any other `button` attribute passes through.
+ *
+ * @category Button
+ */
+interface IconButtonProps extends ButtonHTMLAttributes<HTMLButtonElement> {
+    /** Makes the button a toggle: sets `aria-pressed` and, while true, draws the pressed look. */
+    pressed?: boolean;
+}
 /**
  * An icon-only `button` with no chrome, just the glyph. Give it an
  * `aria-label`, since the icon inside is decorative. As a toggle, with
- * `aria-pressed`, it takes the filled pressed look while pressed. Under a
- * coarse pointer it grows to a 44px touch target.
+ * `pressed`, it sets `aria-pressed` and takes the filled pressed look while
+ * pressed. The ref reaches the `button` element. Under a coarse pointer it grows to a 44px touch target.
  *
  * @example
  * ```tsx
@@ -1576,7 +1718,7 @@ declare const TextButton: styled_components_dist_types.IStyledComponentBase<"web
  *
  * @category Button
  */
-declare const IconButton: styled_components_dist_types.IStyledComponentBase<"web", styled_components.FastOmit<react.DetailedHTMLProps<ButtonHTMLAttributes<HTMLButtonElement>, HTMLButtonElement>, never> & Partial<Pick<react.DetailedHTMLProps<ButtonHTMLAttributes<HTMLButtonElement>, HTMLButtonElement>, never>>> & string;
+declare const IconButton: react.ForwardRefExoticComponent<IconButtonProps & react.RefAttributes<HTMLButtonElement>>;
 
 /**
  * Props for {@link ButtonGroup}. Any other `div` attribute passes through, and
@@ -1593,6 +1735,7 @@ interface ButtonGroupProps extends HTMLAttributes<HTMLDivElement> {
     equalWidth?: boolean;
     /** Gap between buttons, one of the {@link GapToken} names. Omitted, it is the container's `related` gap. */
     gap?: GapToken;
+    /** The buttons to lay out together. */
     children?: ReactNode;
 }
 /**
@@ -1641,20 +1784,6 @@ declare function badgeFace(entry: BadgeEntry & {
     title?: string;
 }): BadgeFace;
 
-/**
- * What a band claims, in plain language, for a surface that speaks it rather
- * than draws it. A hard bound and a one-sigma interval are both said as plain
- * containment, with no statistics vocabulary, so `claimed` is returned
- * unchanged for every `kind`.
- *
- * `claimed` is the containment statement in the calling surface's own grammar:
- * an interval for a meter (`"with bands at 30 percent and 44 percent"`), a
- * whole clause for a chart whose shaded region varies per sample.
- *
- * @category Unit
- */
-declare function bandClaim(_kind: BandKind, claimed: string): string;
-
 /**
  * Props for {@link Card}: everything {@link BlockProps} takes, plus the
  * surface's own marks.
@@ -1688,6 +1817,7 @@ interface CardProps extends BlockProps {
      * this card's padding changes, not the spacing of what it holds.
      */
     standalone?: boolean;
+    /** What the card holds. */
     children?: ReactNode;
 }
 declare function CardRoot({ tone, dimmed, identityColor, standalone, ...props }: CardProps): ReactNode;
@@ -1767,6 +1897,7 @@ interface ClusterProps extends HTMLAttributes<HTMLDivElement> {
      * never silently turns into a ragged block; chip strips and tag lists opt in.
      */
     wrap?: boolean;
+    /** The items, laid out in a row. */
     children?: ReactNode;
 }
 /**
@@ -1852,7 +1983,7 @@ interface ComboboxListboxProps<Option extends ComboboxOption> {
      * control is not a literal `<input role="combobox">`, since an unnamed
      * `role="listbox"` is an accessibility violation.
      */
-    ariaLabel?: string;
+    "aria-label"?: string;
     /**
      * Which side of the control the list opens on. Defaults to `"below"`.
      * `"above"` is for a control at the foot of a clipping container, such as a
@@ -1909,6 +2040,7 @@ interface ComboboxListboxProps<Option extends ComboboxOption> {
  *         aria-activedescendant={activeOption ? optionId(activeOption.key) : undefined}
  *         value={query}
  *         onFocus={() => setOpen(true)}
+ *         // Safe to close on blur: pressing an option does not take focus from the input.
  *         onBlur={() => setOpen(false)}
  *         onChange={(e) => {
  *           setQuery(e.target.value);
@@ -1940,7 +2072,7 @@ interface ComboboxListboxProps<Option extends ComboboxOption> {
  *
  * @category Form
  */
-declare function ComboboxListbox<Option extends ComboboxOption>({ id, groups, flatOptions, activeIndex, selectedKey, getOptionId, onHoverIndex, onSelectKey, renderItem, emptyLabel, ariaLabel, placement, }: Readonly<ComboboxListboxProps<Option>>): react_jsx_runtime.JSX.Element;
+declare function ComboboxListbox<Option extends ComboboxOption>({ id, groups, flatOptions, activeIndex, selectedKey, getOptionId, onHoverIndex, onSelectKey, renderItem, emptyLabel, "aria-label": ariaLabel, placement, }: Readonly<ComboboxListboxProps<Option>>): react_jsx_runtime.JSX.Element;
 
 /**
  * How the rail DRAWS an entry, given what the entry says it is.
@@ -1950,12 +2082,14 @@ declare function ComboboxListbox<Option extends ComboboxOption>({ id, groups, fl
  * the mod declares. This file is the other half: one accessor per axis, and a
  * TABLE saying which combination each renderer draws.
  *
- * | direction | continuity | delivery         | a real example                  | drawn by           |
+ * | direction | kind       | delivery         | a real example                  | drawn by           |
  * |-----------|------------|------------------|---------------------------------|--------------------|
- * | command   | discrete   | acked            | staging, an action group        | `in-flight-row`    |
+ * | command   | event      | acked            | staging, an action group        | `in-flight-row`    |
+ * | command   | discrete   | acked            | a mode held until changed       | `in-flight-row`    |
  * | command   | continuous | acked            | fly-by-wire, ack = the readback | `continuous-strip` |
  * | telemetry | continuous | fire-and-forget  | radio voice                     | `continuous-strip` |
- * | telemetry | discrete   | fire-and-forget  | a science result sent home      | `in-flight-row`    |
+ * | telemetry | event      | fire-and-forget  | a science result sent home      | `in-flight-row`    |
+ * | telemetry | discrete   | fire-and-forget  | a state reported as it changes  | `in-flight-row`    |
  *
  * The table names a RENDERER (a component). WHICH MARK it draws follows from
  * the data: both continuous rows share one strip, lines for a value against a
@@ -1969,10 +2103,11 @@ declare function ComboboxListbox<Option extends ComboboxOption>({ id, groups, fl
  */
 
 /** One combination, spelled as the table's key; a template-literal type, so the table cannot hold a typo. */
-type RailTagKey = `${RailDirection}/${RailContinuity}/${RailDelivery}`;
+type RailTagKey = `${RailDirection}/${SampleKind}/${RailDelivery}`;
 /**
- * A handle's three rail axes as one `direction/continuity/delivery` string, e.g. `command/discrete/acked`.
+ * A handle's three rail axes as one `direction/kind/delivery` string, e.g. `command/event/acked`.
  *
+ * @intent Published so a representation of the rail of a third party can key its entries by the same tag combination the kit does.
  * @category CommandDelay
  */
 declare function railTagKey(tags: RailTags): RailTagKey;
@@ -2043,7 +2178,7 @@ interface ControlRibbonDatum {
     /**
      * What this entry IS on the three axes, in full, and NOT optional. A
      * producer builds them with {@link railTagsForTelemetry}, passing its
-     * continuity.
+     * sample kind.
      */
     tags: RailTags;
 }
@@ -2067,7 +2202,7 @@ interface ControlDelayStreamProps {
      */
     ribbons?: ControlRibbonDatum[];
     /** Accessible label for the graph. Defaults to "Controls in flight". */
-    ariaLabel?: string;
+    "aria-label"?: string;
     /**
      * `"inline"` (default, 40px) is the in-widget rendering; `"rail"` (16px, no
      * labels) is the collapsed drag-bar strip; `"expanded"` is the full-bleed,
@@ -2084,6 +2219,7 @@ interface ControlDelayStreamProps {
  * The one-way delay, in seconds, under which {@link ControlDelayStream} draws no
  * command streams. Ribbons draw at any positive delay.
  *
+ * @intent Published so a representation of the rail of a third party can agree with ControlDelayStream on when streams are drawn.
  * @category CommandDelay
  */
 declare const STREAM_MIN_DELAY_SECONDS = 0.05;
@@ -2092,6 +2228,7 @@ declare const STREAM_MIN_DELAY_SECONDS = 0.05;
  * wide): the T divider, a third of the plot. It never moves with delivery;
  * delivery only decides whether anything is drawn past it.
  *
+ * @intent Published so a representation of the rail of a third party can place its divider where ControlDelayStream places the T.
  * @category CommandDelay
  */
 declare function ribbonBoundaryX(variant?: ControlDelayStreamVariant): number;
@@ -2111,7 +2248,7 @@ declare function ribbonBoundaryX(variant?: ControlDelayStreamVariant): number;
  *
  * @category CommandDelay
  */
-declare function ControlDelayStream({ streams, ribbons, ariaLabel, variant, delayReading, }: ControlDelayStreamProps): react_jsx_runtime.JSX.Element | null;
+declare function ControlDelayStream({ streams, ribbons, "aria-label": ariaLabel, variant, delayReading, }: ControlDelayStreamProps): react_jsx_runtime.JSX.Element | null;
 
 /**
  * One dispatch that got no reply, as much of it as the sentence needs. The entries in `useCommand`'s `losses` satisfy it.
@@ -2263,8 +2400,16 @@ declare function commandFoundSentence(found: CommandFoundLike): string;
  * @category CommandDelay
  */
 interface CommandRefusalLike {
+    /** Why the command was refused, as one of the root codes every Uplink shares, such as
+     * `CommandErrorCode.InsufficientFunds`, whose string value (the one on the
+     * wire) is `"insufficientFunds"`. */
     errorCode: CommandErrorCode;
-    /** The refinement's id, when the refusal was more specific than its root `errorCode`. */
+    /**
+     * The refinement's id, when the refusal was more specific than its root
+     * `errorCode`. A refinement is a narrower reason an Uplink declares under a
+     * root code, such as a particular kind of `wrongState`; a client that does
+     * not know it still reads the root.
+     */
     reason?: string;
     /** The command id that was dispatched, e.g. `career.facility.upgrade`. */
     command?: string;
@@ -2435,7 +2580,7 @@ interface InFlightListProps {
      */
     orientation?: "column" | "row";
     /** Accessible label for the list region. Defaults to "In-flight commands". */
-    ariaLabel?: string;
+    "aria-label"?: string;
     /**
      * `"inline"` (default) is the monospace row/badge list. `"rail"` is the
      * Panel rail's 16px strip: each command is a soft glow grazing the top edge,
@@ -2458,9 +2603,13 @@ interface InFlightListProps {
  *
  * @category CommandDelay
  */
-declare function InFlightList({ items, mode, density, orientation, ariaLabel, variant, onDismiss, }: InFlightListProps): react_jsx_runtime.JSX.Element | null;
+declare function InFlightList({ items, mode, density, orientation, "aria-label": ariaLabel, variant, onDismiss, }: InFlightListProps): react_jsx_runtime.JSX.Element | null;
 
-/** The structural subset of an in-flight command that this mapping reads. */
+/**
+ * The structural subset of an in-flight command that this mapping reads.
+ *
+ * @category CommandDelay
+ */
 interface InFlightCommandLike {
     /** Stable for the entry's lifetime, so the list keeps its row as it moves. */
     id: string;
@@ -2492,7 +2641,8 @@ interface InFlightCommandLike {
 declare function toInFlightListItems(items: readonly InFlightCommandLike[]): InFlightListItem[];
 
 /**
- * What {@link CommandDelay} and the Panel delay rail read from a command: its
+ * What {@link CommandDelay} and the Panel delay rail (the strip at the top of a
+ * panel showing commands still crossing to the craft) read from a command: its
  * in-flight rows, its delay, and what became of its dispatches. Declared
  * structurally; {@link useCommand}'s return value satisfies it.
  *
@@ -2505,7 +2655,11 @@ interface CommandDelayHandle {
      */
     inFlight: InFlightCommandLike[];
     /**
-     * What this entry IS on the rail's three axes, in full. The renderer follows
+     * What this entry IS on the delay rail's three axes, in full: `direction`
+     * (a `command` leaving or `telemetry` arriving), `kind` (`event` or
+     * `discrete`, one point, or `continuous`, a span) and `delivery` (`acked`, answered, or
+     * `fire-and-forget`). The delay rail is the strip a panel draws above its
+     * header to show what is crossing the signal delay. The renderer follows
      * from these, so no consumer branches on what kind of command this is. A
      * command handle gets them from {@link useCommand}; a producer that is not a
      * command (an open microphone) states them with {@link railTagsForTelemetry}.
@@ -2540,7 +2694,7 @@ interface CommandDelayHandle {
      * what it is. A voice ribbon names the transmission it is drawing; a control
      * axis is happy with the default.
      */
-    ariaLabel?: string;
+    "aria-label"?: string;
     /**
      * Dispatches from this command the GAME REFUSED, until dismissed. Rendered by
      * the Panel rail under both queues, never by `<CommandDelay>`: a refusal is
@@ -2597,7 +2751,7 @@ interface CommandDelayProps {
      * Accessible label for the rendered region. Left undefined, each branch
      * keeps its own default ("In-flight commands" / "Controls in flight").
      */
-    ariaLabel?: string;
+    "aria-label"?: string;
     /** Discrete-branch passthrough to `InFlightList`. Ignored for stream. */
     mode?: InFlightListMode;
     /** Discrete-branch passthrough to `InFlightList`. Ignored for stream. */
@@ -2636,7 +2790,7 @@ interface CommandDelayProps {
  * sentence for a command that failed. The panel's delay rail already shows the
  * same commands above the widget.
  */
-declare function CommandDelay({ handle, handles, ariaLabel, mode, density, orientation, variant, }: Readonly<CommandDelayProps>): react_jsx_runtime.JSX.Element | null;
+declare function CommandDelay({ handle, handles, "aria-label": ariaLabel, mode, density, orientation, variant, }: Readonly<CommandDelayProps>): react_jsx_runtime.JSX.Element | null;
 
 /**
  * How long, in milliseconds, an armed {@link CommandButton} waits for its confirming press before it returns to rest.
@@ -2653,8 +2807,9 @@ interface CommandGateLike extends CommandRefusalLike {
     /** The game EVALUATED this and said no. */
     blocked: boolean;
     /**
-     * The mod could not evaluate this command's gates at all, as in a sandbox
-     * save. The control is drawn as ordinary, not darkened, and carries
+     * The mod could not evaluate this command's gates (the checks it runs
+     * before a command is pressed) at all, as in a sandbox save, which has no
+     * career to check against. The control is drawn as ordinary, not darkened, and carries
      * `data-gate` to say so.
      */
     undetermined?: boolean;
@@ -2683,7 +2838,9 @@ interface CommandButtonHandle<Result = CommandReplyLike, Args = unknown> extends
     /**
      * Dispatch. The promise resolves when the command is confirmed and rejects
      * when it is refused, lost, or the machinery failed, so the control clears its
-     * own pending state with no per-command telemetry predicate.
+     * own pending state with no per-command telemetry predicate. A refusal
+     * rejects with an error carrying its `CommandErrorCode`: read it with
+     * `classifyCommandRejection` from `@ksp-gonogo/sitrep-sdk`.
      *
      * `Result` carries the reply's real type to
      * {@link CommandButtonProps.onConfirmed}; a handle from `useCommand("...")`
@@ -2823,6 +2980,9 @@ interface CommandButtonState {
  *
  * @example
  * ```tsx
+ * import { useCommand } from "@ksp-gonogo/sitrep-sdk";
+ * import { useCommandButton } from "@ksp-gonogo/ui-kit";
+ *
  * function RecoverButton() {
  *   const recover = useCommand("ksp.recover");
  *   const { isArmed, isPending, isRefused, refusalText, press } =
@@ -2839,6 +2999,7 @@ interface CommandButtonState {
  *       type="button"
  *       aria-busy={isPending || undefined}
  *       title={refusalText ?? undefined}
+ *       // `true` asks for a confirm step: the first press arms, the second sends.
  *       onClick={() => press(true)}
  *     >
  *       {word}
@@ -2955,7 +3116,8 @@ interface CommandButtonProps<Result = CommandReplyLike, Args = unknown> extends
     /**
      * Called with the control's press while a click on it would do something
      * (not while it is in flight) and with `null` when it would not, for a
-     * caller that lets an input press the control from elsewhere. The press
+     * caller that lets an input (a key, a gamepad button or a serial device
+     * bound to this control) press it from elsewhere. The press
      * takes whether the control has a confirm step.
      */
     onPressReady?: (press: ((armable: boolean) => void) | null) => void;
@@ -2969,7 +3131,8 @@ interface CommandButtonProps<Result = CommandReplyLike, Args = unknown> extends
      *
      * Receives what the dispatch resolved with, typed off the handle. A confirmed
      * command did not necessarily do something: a mod that de-duplicates on
-     * request id replies to a repeat with the receipt it stored the first time. The
+     * request id (the id each dispatch carries) replies to a repeat of the same
+     * dispatch with the receipt it stored the first time. The
      * value is the reply envelope; the command's own value is on `payload`.
      */
     onConfirmed?: (result: Result) => void;
@@ -3121,7 +3284,7 @@ interface CommandListCommonProps {
      */
     live?: boolean;
     /** Names the list for assistive tech. Each kind has its own default. */
-    ariaLabel?: string;
+    "aria-label"?: string;
 }
 /**
  * Props for {@link CommandList}: the entries it draws, keyed by what became of them. Each entry
@@ -3237,6 +3400,7 @@ interface DelayRailStore {
 /**
  * Create an empty delay-rail store, for a caller that owns its lifetime and provides it through {@link DelayRailContext}.
  *
+ * @intent Published so a third party can own the lifetime of a rail store behind a representation of its own, as Console does.
  * @category CommandDelay
  */
 declare function createDelayRailStore(): DelayRailStore;
@@ -3245,6 +3409,7 @@ declare function createDelayRailStore(): DelayRailStore;
  * a `Panel`, where `useRailEntry` and `useActiveHandles` degrade to no-ops.
  * Exported raw for a caller that owns the store's lifetime.
  *
+ * @intent Published so a third party can provide a rail store it owns to a representation of its own, as Console does.
  * @category CommandDelay
  */
 declare const DelayRailContext: react.Context<DelayRailStore | null>;
@@ -3272,6 +3437,7 @@ declare const useDelayRailStore: () => DelayRailStore | null;
  * is no store in the tree. A subscriber (`Panel.Delay`) re-renders only when
  * the active handle set changes.
  *
+ * @intent Published so a third party can read the active handles to draw a representation of the rail of its own, as Console does.
  * @category CommandDelay
  */
 declare function useActiveHandles(): readonly CommandHandle[];
@@ -3323,12 +3489,14 @@ declare function useRailEntry(entry: RailEntry | null): void;
 /**
  * The centre line of the ribbon mark's box, in box units.
  *
+ * @intent Published so a caller can read the trace waveformPath draws back against its centre line.
  * @category CommandDelay
  */
 declare const WAVE_MID_Y: number;
 /**
  * How far a full-scale sample reaches either side of the centre line, in box units. Short: the rail is a band, not a meter.
  *
+ * @intent Published so a caller can read the trace waveformPath draws back as an amplitude.
  * @category CommandDelay
  */
 declare const WAVE_HALF_H = 5.5;
@@ -3358,10 +3526,10 @@ interface ComposerBarProps extends ComponentPropsWithoutRef<"div"> {
      */
     blocked?: boolean;
     /**
-     * A short chip straddling the LEFT end of the row's top border, saying WHY
+     * A short label straddling the LEFT end of the row's top border, saying WHY
      * the outline turned red. The right end belongs to the console's delay
-     * reading. A few upper-case words, pinned so it never changes the row's
-     * height.
+     * reading. A few upper-case words, such as `READ ONLY`, pinned so it never
+     * changes the row's height.
      */
     flag?: string;
     /**
@@ -3404,6 +3572,7 @@ interface ComposerBarProps extends ComponentPropsWithoutRef<"div"> {
      * operator's choice.
      */
     sendTooltip?: string;
+    /** The input the operator types into, drawn between the prompt and the send button. */
     children?: ReactNode;
 }
 /**
@@ -3444,12 +3613,12 @@ interface ConsoleProps extends ComponentPropsWithoutRef<"div"> {
     tone?: ConsoleTone;
     /**
      * How long it takes to reach the other end, in seconds. `null` when there is
-     * no measurable path. Neither `null` nor zero gets a chip.
+     * no measurable path. Neither `null` nor zero gets a {@link SignalDelayBadge}.
      */
     oneWaySeconds?: number | null;
     /**
      * The same delay as the reading it arrived in (`useCommand`'s
-     * `delayReading`), so the chip's figure draws held while `comms.delay` is
+     * `delayReading`), so the badge's figure draws held while `comms.delay` is
      * quiet. Omitted, it draws as current.
      */
     delayReading?: Reading<Value<"s">> | null;
@@ -3459,8 +3628,9 @@ interface ConsoleProps extends ComponentPropsWithoutRef<"div"> {
      */
     canQueue?: boolean;
     /**
-     * Force the chip whatever the separation, for a terminal in CHARACTER mode,
-     * which has no composed line to queue.
+     * Force the {@link SignalDelayBadge} whatever the separation, for a terminal in
+     * character mode (every keystroke goes on its own), which has no composed
+     * line to queue.
      */
     alwaysBadge?: boolean;
     /**
@@ -3471,7 +3641,7 @@ interface ConsoleProps extends ComponentPropsWithoutRef<"div"> {
     /**
      * Set when each `inFlight` entry carries the delay it was sent under, so the
      * queue stays after the live delay reading is gone: words sent at four
-     * light-minutes are still crossing after the path drops. The chip and the
+     * light-minutes are still crossing after the path drops. The badge and the
      * queue are still never drawn together.
      */
     inFlightFrozenAtDispatch?: boolean;
@@ -3479,7 +3649,7 @@ interface ConsoleProps extends ComponentPropsWithoutRef<"div"> {
      * The line the operator types on, at the foot and inside the frame. Omitted,
      * the console grows no foot. Given but currently absent (a terminal in
      * character mode), the foot stays, so the surface does not change height
-     * with the mode. A standing chip grows a foot for itself either way.
+     * with the mode. A standing badge grows a foot for itself either way.
      */
     composer?: ReactNode;
     /** The scrollback: an emulator screen, a log, a list of rows. */
@@ -3487,11 +3657,13 @@ interface ConsoleProps extends ComponentPropsWithoutRef<"div"> {
 }
 /**
  * A console: a scrolling surface, what is still crossing on the link, the line
- * the operator is typing, and one reading of how far away the other end is.
+ * the operator is typing, and one reading of how far away the other end is
+ * (the craft or device the console talks to, whose distance `oneWaySeconds`
+ * gives).
  *
  * The delay reading is chosen here, not by the widget: a standing
- * {@link SignalDelayBadge} when the other end is close enough that a countdown
- * would be over before it could be read, an {@link InFlightList} queue of what
+ * {@link SignalDelayBadge} when the one-way delay is a second or less, so a
+ * countdown would be over before it could be read, an {@link InFlightList} queue of what
  * is crossing when it is not, never both. Both sit at the foot. A widget says
  * only how far away the other end is (`oneWaySeconds`), whether it can queue
  * (`canQueue`) and what is queued (`inFlight`).
@@ -3503,7 +3675,7 @@ interface ConsoleProps extends ComponentPropsWithoutRef<"div"> {
  * @categoryDescription Console
  * A two-way text console over a delayed link: the scrollback, the line being
  * typed, and what is still crossing, framed with one reading of how far away
- * the other end is.
+ * the other end (the craft the console talks to) is.
  */
 declare function Console({ tone, oneWaySeconds, delayReading, canQueue, alwaysBadge, inFlight, inFlightFrozenAtDispatch, composer, children, ...rest }: ConsoleProps): react_jsx_runtime.JSX.Element;
 
@@ -3519,6 +3691,7 @@ interface ContainerBreakProps extends HTMLAttributes<HTMLDivElement> {
     narrow?: CSSProperties;
     /** Styles applied once the container is at least `at` px wide, layered over `narrow`. */
     wide?: CSSProperties;
+    /** The content the styles lay out. */
     children?: ReactNode;
 }
 /**
@@ -3597,7 +3770,8 @@ declare function Countdown({ value, clock, precise, }: CountdownProps): react_js
 
 /**
  * Value equality for widget config objects, as {@link useModalSaveBar} uses
- * it to decide whether a draft differs from the saved config.
+ * it to decide whether a draft differs from the saved config. Call it yourself
+ * only to build a dirty check of your own.
  *
  * - `undefined` and a missing key are treated the same
  * - object key order is ignored
@@ -3683,6 +3857,7 @@ declare const FRAMEWORK_CONTRIBUTION_SEGMENTS: readonly ["badges"];
  * ({@link useContributions}, {@link useContributionsBySlotId}) read it. A
  * widget reads through those hooks rather than the store.
  *
+ * @intent Published so a test, or a host of its own, can mount the per-widget contribution store a widget reads through useContributions.
  * @category Extensions
  */
 declare const ContributionsPanelStore: PanelStore<Store<ContributionSlotEntry>>;
@@ -3838,6 +4013,11 @@ interface DataLineProps extends HTMLAttributes<HTMLDivElement> {
  */
 declare function DataLine({ label, lead, children, tone, aligned, ...rest }: DataLineProps): react_jsx_runtime.JSX.Element;
 
+/**
+ * The fields every {@link DataTable} column carries, whatever it draws.
+ *
+ * @category DataTable
+ */
 interface DataTableColumnBase {
     /** Stable identity for the column, and its React key. */
     key: string;
@@ -3875,9 +4055,14 @@ interface DataTableColumnBase {
  * @category DataTable
  */
 type DataTableColumn<Row> = DataTableColumnBase & ({
+    /** Draws the cell yourself. Give this or `value`, never both. */
     render: (row: Row) => ReactNode;
     value?: never;
 } | {
+    /**
+     * The cell's figure, drawn through {@link Unit}: a whole `Reading`, or
+     * a `value()` of a unit and a number. Give this or `render`, never both.
+     */
     value: (row: Row) => UnitValue | null | undefined;
     render?: never;
 });
@@ -3921,6 +4106,7 @@ interface DataTableProps<Row> {
      * where per-row controls and augment slots go, so the columns stay aligned.
      */
     rowDetail?: (row: Row) => ReactNode;
+    /** A class for the table's outer wrapper, so a styled-component can extend it. */
     className?: string;
 }
 /**
@@ -3934,6 +4120,18 @@ interface DataTableProps<Row> {
  *
  * @example
  * ```tsx
+ * // `"Mit"` is the unit KSP measures science data in, and `"science"` is
+ * // science points; any unit symbol `value()` accepts works the same way.
+ * import { type DataTableColumn, DataTable } from "@ksp-gonogo/ui-kit";
+ * import { value } from "@ksp-gonogo/sitrep-sdk";
+ *
+ * interface Subject {
+ *   subjectId: string;
+ *   title: string;
+ *   dataMits: number;
+ *   remaining: number;
+ * }
+ *
  * const columns: ReadonlyArray<DataTableColumn<Subject>> = [
  *   { key: "subject", header: "Subject", rowHeader: true, width: "1fr", minWidth: "22ch", render: (s) => s.title },
  *   { key: "data", header: "Data", align: "end", width: "9ch", value: (s) => value("Mit", s.dataMits) },
@@ -4045,8 +4243,8 @@ interface DialProps<Unit extends string = string> {
     needleColor?: string;
     /** Arc track colour. Defaults to `var(--color-border-subtle)`. */
     trackColor?: string;
-    /** Accessible name. Defaults to `"Dial"`; the value is spoken as `aria-valuetext`. */
-    ariaLabel?: string;
+    /** Accessible name naming what the dial measures; the value is spoken as `aria-valuetext`. */
+    "aria-label": string;
 }
 /**
  * A round instrument whose needle sweeps a configurable arc (by default a full
@@ -4059,7 +4257,8 @@ interface DialProps<Unit extends string = string> {
  * The whole axis is one kind: `value`, `min`, `max`, every zone bound and
  * every tick are `Value<Unit>` of the same unit, and the centre readout writes
  * that unit itself. Handed a whole `Reading`, a held figure is marked as held
- * and a model's interval puts two bounds on the arc.
+ * and the {@link UncertaintyBand} of a figure a model carried forward (see
+ * {@link TopicReckoning}) puts two bounds on the arc.
  *
  * The dial is a `role="meter"` with the value as `aria-valuetext`. With no
  * value it draws no needle and is announced as an image naming the missing
@@ -4084,7 +4283,7 @@ interface DialProps<Unit extends string = string> {
  *         { value: value("°", 180), label: "S" },
  *         { value: value("°", 270), label: "W" },
  *       ]}
- *       ariaLabel="Heading"
+ *       aria-label="Heading"
  *     />
  *   );
  * }
@@ -4095,7 +4294,7 @@ interface DialProps<Unit extends string = string> {
  * Instruments for a value against a scale: a dial and a tape, each with ticks
  * and coloured zones.
  */
-declare function Dial<Unit extends string = string>({ value, min, max, width, height, startAngle, sweep, wrap, zones, ticks, valueLabel, readout, format, needleColor, trackColor, ariaLabel, }: Readonly<DialProps<Unit>>): react_jsx_runtime.JSX.Element;
+declare function Dial<Unit extends string = string>({ value, min, max, width, height, startAngle, sweep, wrap, zones, ticks, valueLabel, readout, format, needleColor, trackColor, "aria-label": ariaLabel, }: Readonly<DialProps<Unit>>): react_jsx_runtime.JSX.Element;
 
 /**
  * Props for {@link Disclosure}.
@@ -4115,7 +4314,7 @@ interface DisclosureProps {
      * Accessible name for the trigger. Required when `label` is a non-text node
      * (an icon or glyph) so the button is not unlabelled to a screen reader.
      */
-    ariaLabel?: string;
+    "aria-label"?: string;
     /** A class for the outer element, so a styled-component can extend it. */
     className?: string;
     /**
@@ -4168,12 +4367,19 @@ interface DisclosureProps {
  *
  * @example
  * ```tsx
- * <Disclosure
- *   variant="inline"
- *   chevron={false}
- *   label={(open) => (open ? "Hide detail" : "Show detail")}
- * >
- *   <StageBreakdown stages={stages} />
+ * import { value } from "@ksp-gonogo/sitrep-sdk";
+ * import { Disclosure, Text, Unit } from "@ksp-gonogo/ui-kit";
+ *
+ * // The default: the detail pops out over what follows.
+ * <Disclosure label="Why held?">
+ *   <Text>
+ *     The last update arrived <Unit value={value("s", 40)} /> ago.
+ *   </Text>
+ * </Disclosure>
+ *
+ * // Inline: the detail opens in the flow of the page, with no chevron.
+ * <Disclosure label="Details" variant="inline" chevron={false}>
+ *   <Text>Fuel is drawn from the lowest stage first.</Text>
  * </Disclosure>
  * ```
  *
@@ -4182,7 +4388,7 @@ interface DisclosureProps {
  * Detail on demand: a button that shows and hides a panel, reachable from the
  * keyboard where a hover reveal would not be.
  */
-declare function Disclosure({ label, children, ariaLabel, className, variant, panelHeight, chevron, asButton, buttonSize, defaultOpen, }: DisclosureProps): react_jsx_runtime.JSX.Element;
+declare function Disclosure({ label, children, "aria-label": ariaLabel, className, variant, panelHeight, chevron, asButton, buttonSize, defaultOpen, }: DisclosureProps): react_jsx_runtime.JSX.Element;
 
 /**
  * Props for {@link DivergingBar}.
@@ -4203,6 +4409,7 @@ interface DivergingBarProps<Unit extends string = string> {
      * an empty track.
      */
     maxAbs: Value<Unit>;
+    /** A class for the outer element, so a styled-component can extend it. */
     className?: string;
 }
 /**
@@ -4213,8 +4420,10 @@ interface DivergingBarProps<Unit extends string = string> {
  * A held figure fades the bar and nothing more; the number beside it says how
  * current it is.
  *
- * Hides itself when the nearest `inline-size` container (such as `Panel`) is
- * narrower than 300px, where the number alone is the reading that matters.
+ * Hides itself when the nearest `inline-size` container is narrower than 300px,
+ * where the number alone is the reading that matters. A {@link Panel} is such a
+ * container, so a bar inside a widget needs none of its own; outside a panel,
+ * wrap it in an element with `container-type: inline-size`.
  *
  * @category Meter
  */
@@ -4270,6 +4479,7 @@ declare function createDomainAvailabilityStore(): DomainAvailabilityStore;
  * from {@link createDomainAvailabilityStore} through it to seed presence in a
  * test; otherwise use {@link DomainAvailabilityProvider}.
  *
+ * @intent Published so a test can seed which Domains are present for the widget under test.
  * @category Extensions
  */
 declare const DomainAvailabilityContext: react.Context<DomainAvailabilityStore | null>;
@@ -4305,7 +4515,10 @@ type EmptyStateLayout = "inline" | "fill";
 interface EmptyStateProps extends HTMLAttributes<HTMLDivElement> {
     /** The placeholder text. */
     children?: ReactNode;
-    /** Defaults to `inline`. */
+    /**
+     * `inline`, the default, sits where it is mounted with no inset of its own;
+     * `fill` centres the text in all the space its container gives it.
+     */
     layout?: EmptyStateLayout;
 }
 /**
@@ -4316,20 +4529,11 @@ interface EmptyStateProps extends HTMLAttributes<HTMLDivElement> {
  * with the content it stands in for. `fill` centres in the available space and
  * suits a panel's sole child.
  *
- * @example
- * ```tsx
- * function VesselsBody({ vessels }: { vessels: readonly string[] }) {
- *   if (vessels.length === 0) {
- *     return <EmptyState layout="fill">No vessels in flight</EmptyState>;
- *   }
- *   return <VesselList vessels={vessels} />;
- * }
- * ```
- *
  * @category EmptyState
  * @categoryDescription EmptyState
- * What a widget shows in place of content: nothing to show, a notice, a spinner
- * while it waits, and the note for a trajectory that is withheld.
+ * What a widget shows where there is no content to draw: a placeholder for an
+ * empty panel or list, a notice, a spinner while it waits, and the note for a
+ * trajectory that is withheld.
  */
 declare function EmptyState({ children, layout, ...rest }: EmptyStateProps): react_jsx_runtime.JSX.Element;
 
@@ -4352,7 +4556,8 @@ interface ExpandableTextProps {
     className?: string;
 }
 /**
- * Game-authored prose, cut to a readable length with the rest behind a
+ * Prose written by the game or a mod (a contract's description, a part's
+ * blurb), cut to a readable length with the rest behind a
  * "Show more" button.
  *
  * The cut is a prefix of the string ending on a whole word, followed by
@@ -4375,15 +4580,16 @@ type EphemerisFigure = <Unit extends string>(figure: Value<Unit>) => UnitValue<U
 /**
  * The figure-maker for quantities computed from `bodies`' orbits and the clock
  * alone: a phase angle between two planets, a transfer window between them, a
- * pair's separation. Pass the catalogue reading and the bodies the figure rests
- * on.
+ * pair's separation. Pass the poses `useSystemInstant` returns and the bodies
+ * the figure rests on.
  *
- * Where every one of those bodies is deterministic (a fixed conic, which is
- * every body of a stock install) the figure is stamped deterministic and takes
- * no mark, however long ago the catalogue last arrived: it is exact at the
- * instant it is drawn for. Where any is not (an n-body install, whose bodies
- * drift like craft) the figure is only as current as the catalogue, and a held
- * catalogue hands it over as held.
+ * The figure is as current as the least current pose it rests on. Where every
+ * one of those poses is `exact` (on a fixed conic, an orbit that never changes, as every body of a stock
+ * install is) the figure is stamped deterministic and takes no mark, however long
+ * ago the catalogue last arrived. Where any is `held`, because the instant is
+ * past its provider's horizon or the catalogue stopped arriving under a body
+ * that drifts, the figure comes back held as of the oldest of them. A `modelled`
+ * pose claims no exactness and takes no mark.
  *
  * A figure that also rests on the craft does not come through here: give it
  * the craft's mark with {@link derivedMarking}, since one inexact input makes
@@ -4391,7 +4597,7 @@ type EphemerisFigure = <Unit extends string>(figure: Value<Unit>) => UnitValue<U
  *
  * @category Unit
  */
-declare function ephemerisFigureOf(catalogue: Reading<CelestialFacts> | undefined, bodies: readonly (CelestialBody | null | undefined)[]): EphemerisFigure;
+declare function ephemerisFigureOf(poses: SystemPoses | undefined, bodies: readonly (CelestialBody | null | undefined)[]): EphemerisFigure;
 
 /**
  * Props for {@link Fill}.
@@ -4406,6 +4612,7 @@ interface FillProps extends HTMLAttributes<HTMLDivElement> {
      * fills the dashboard grid cell.
      */
     grow?: boolean;
+    /** The content that takes the space. */
     children?: ReactNode;
 }
 /**
@@ -4442,17 +4649,33 @@ interface FilterChipProps {
  *
  * @example
  * ```tsx
- * <Cluster justify="start" wrap role="group" aria-label="Filters">
- *   {BODIES.map((body) => (
- *     <FilterChip
- *       key={body}
- *       label={body}
- *       selected={shown.has(body)}
- *       count={countFor(body)}
- *       onToggle={() => toggle(body)}
- *     />
- *   ))}
- * </Cluster>
+ * import { useState } from "react";
+ * import { Cluster, FilterChip } from "@ksp-gonogo/ui-kit";
+ *
+ * const BODIES = ["Kerbin", "Mun", "Minmus"] as const;
+ *
+ * function BodyFilter({ countFor }: { countFor: (body: string) => number }) {
+ *   const [shown, setShown] = useState<ReadonlySet<string>>(new Set());
+ *   const toggle = (body: string) =>
+ *     setShown((prev) => {
+ *       const next = new Set(prev);
+ *       if (!next.delete(body)) next.add(body);
+ *       return next;
+ *     });
+ *   return (
+ *     <Cluster justify="start" wrap role="group" aria-label="Filters">
+ *       {BODIES.map((body) => (
+ *         <FilterChip
+ *           key={body}
+ *           label={body}
+ *           selected={shown.has(body)}
+ *           count={countFor(body)}
+ *           onToggle={() => toggle(body)}
+ *         />
+ *       ))}
+ *     </Cluster>
+ *   );
+ * }
  * ```
  *
  * @category FilterList
@@ -4510,20 +4733,42 @@ interface UseRowFilterOptions {
  *
  * @example
  * ```tsx
- * const filter = useRowFilter({ placeholder: "Filter subjects..." });
- * const shown = subjects.filter((s) => filter.matches(`${s.title} ${s.biome}`));
- *
- * return (
- *   <FilterRegion filter={filter} fill>
- *     {shown.length > 0 ? (
- *       <SubjectTable rows={shown} />
- *     ) : (
- *       <EmptyState>
- *         {filter.active ? "Nothing matches the filter" : "No subjects yet"}
- *       </EmptyState>
- *     )}
- *   </FilterRegion>
- * );
+ * import {
+ *   EmptyState,
+ *   FilterRegion,
+ *   Stack,
+ *   Text,
+ *   useRowFilter,
+ * } from "@ksp-gonogo/ui-kit";
+ *
+ * interface Subject {
+ *   id: string;
+ *   title: string;
+ *   biome: string;
+ * }
+ *
+ * function SubjectList({ subjects }: { subjects: readonly Subject[] }) {
+ *   const filter = useRowFilter({ placeholder: "Filter subjects..." });
+ *   const shown = subjects.filter((s) =>
+ *     filter.matches(`${s.title} ${s.biome}`),
+ *   );
+ *
+ *   return (
+ *     <FilterRegion filter={filter} fill>
+ *       {shown.length > 0 ? (
+ *         <Stack>
+ *           {shown.map((s) => (
+ *             <Text key={s.id}>{s.title}</Text>
+ *           ))}
+ *         </Stack>
+ *       ) : (
+ *         <EmptyState>
+ *           {filter.active ? "Nothing matches the filter" : "No subjects yet"}
+ *         </EmptyState>
+ *       )}
+ *     </FilterRegion>
+ *   );
+ * }
  * ```
  *
  * @category FilterList
@@ -4628,7 +4873,8 @@ interface FitLabelButtonProps extends Omit<ComponentPropsWithoutRef<"button">, "
  * A `button` that shows its label while the label fits and its icon when it
  * does not. The switch is measured against the button's own width, not a
  * breakpoint, and follows resizes. It is an unstyled native button
- * (`type="button"` by default), so style it or wrap it as the layout needs.
+ * (`type="button"` by default), so it has no border, fill or padding until you give it some: style it with
+ * `styled(FitLabelButton)` or wrap it as the layout needs.
  *
  * The accessible name is always `label`, carried in `aria-label` in both
  * states. Put anything explaining a disabled state in `title`, since it is the
@@ -4754,14 +5000,19 @@ declare function Floating({ anchor, style, children, ...rest }: FloatingProps):
  * jog wheel and read-only fields. A widget's config form is built from these.
  */
 declare const ConfigForm: styled_components_dist_types.IStyledComponentBase<"web", styled_components.FastOmit<styled_components.FastOmit<react.DetailedHTMLProps<react.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "$boxed"> & {
+    /** Puts the form on a bordered panel surface with its own padding and a tighter gap. */
     $boxed?: boolean;
 }, never> & Partial<Pick<styled_components.FastOmit<react.DetailedHTMLProps<react.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "$boxed"> & {
+    /** Puts the form on a bordered panel surface with its own padding and a tighter gap. */
     $boxed?: boolean;
 }, never>>> & string;
 /**
  * One labelled control in a {@link ConfigForm}, stacked: {@link FieldLabel} on
  * top, the control below, an optional {@link FieldHint} under it. Tie the label
- * to the control with `htmlFor` and `id`.
+ * to the control with `htmlFor` and `id`. For a single line of text with no hint,
+ * prefer {@link TextField}, which does all of this in one; build with `Field`
+ * and {@link Input} for a control it does not cover or a field that needs a
+ * {@link FieldHint}.
  *
  * @example
  * ```tsx
@@ -4824,6 +5075,7 @@ declare const Textarea: styled_components_dist_types.IStyledComponentBase<"web",
  * @category Layout
  */
 interface FramedDisplayProps extends ComponentPropsWithoutRef<"div"> {
+    /** The drawing the frame surrounds. */
     children?: ReactNode;
     /**
      * Adds an inner gutter between the frame and its contents, for content that
@@ -4944,7 +5196,7 @@ interface GraphNoticeProps extends HTMLAttributes<HTMLDivElement> {
  * @example Over a graph in a `Fill`
  * ```tsx
  * <Fill>
- *   <LineGraph series={series} ariaLabel="Altitude trend" />
+ *   <LineGraph series={series} aria-label="Altitude trend" />
  *   {series.length === 0 && (
  *     <GraphNotice placement="overlay">no reference data</GraphNotice>
  *   )}
@@ -4998,6 +5250,7 @@ interface GridProps extends HTMLAttributes<HTMLDivElement> {
      * wants its rows tighter than its columns.
      */
     rowGap?: GapToken;
+    /** The cells, filled in reading order. */
     children?: ReactNode;
 }
 /**
@@ -5015,7 +5268,11 @@ declare function Grid({ cols, minColWidth, fit, gap, rowGap, align, children, ..
  * @category Badge
  */
 interface HeldBadgeProps {
-    /** Why the reading behind this part of the widget stopped updating. */
+    /**
+     * Why the reading behind this part of the widget stopped updating: `held`,
+     * `disconnected`, `last-before-blackout`, `recorded`, `loading` or `no-game`.
+     * Its word is the one {@link formatStreamStatus} gives the status of that name.
+     */
     grade: HeldGrade;
     /** What is held, in the operator's terms, for the hover text: "Contract board", a part's title. */
     subject?: string;
@@ -5023,7 +5280,7 @@ interface HeldBadgeProps {
     size?: BadgeSize;
 }
 /**
- * The chip a widget draws beside one part of itself whose reading is held: a
+ * The badge a widget draws beside one part of itself whose reading is held: a
  * row, a card, a totals cell. It prints the grade's word and severity, so it
  * always agrees with the panel's own badge.
  *
@@ -5061,6 +5318,7 @@ interface HeldFigureProps extends HTMLAttributes<HTMLSpanElement> {
     kind?: MarkKind;
     /** The figure is of something other than what its label names, so its mark is drawn hollow: a ring for a current figure, the square or triangle emptied otherwise. */
     elsewhere?: boolean;
+    /** The figure the mark follows. */
     children: ReactNode;
 }
 /**
@@ -5081,7 +5339,7 @@ interface HoverCardProps {
     /** The always-visible trigger content: a glyph, a tag, a short label. */
     trigger: ReactNode;
     /** Accessible name for the trigger, required since the trigger is usually a glyph. */
-    ariaLabel: string;
+    "aria-label": string;
     /** What the card says. Read-only facts: a hover card holds no controls. */
     children: ReactNode;
 }
@@ -5094,14 +5352,14 @@ interface HoverCardProps {
  *
  * @example
  * ```tsx
- * <HoverCard trigger={<InfoIcon />} ariaLabel="Signal path">
+ * <HoverCard trigger={<InfoIcon />} aria-label="Signal path">
  *   <Text>Relayed through {relayName}</Text>
  * </HoverCard>
  * ```
  *
  * @category Floating
  */
-declare function HoverCard({ trigger, ariaLabel, children }: HoverCardProps): react_jsx_runtime.JSX.Element;
+declare function HoverCard({ trigger, "aria-label": ariaLabel, children, }: HoverCardProps): react_jsx_runtime.JSX.Element;
 
 type SVGAttributes = Partial<SVGProps<SVGSVGElement>>;
 type ElementAttributes = RefAttributes<SVGSVGElement> & SVGAttributes;
@@ -5418,6 +5676,7 @@ interface InlineProps extends HTMLAttributes<HTMLSpanElement> {
      * that cannot break overflows a narrow column.
      */
     wrap?: boolean;
+    /** The runs of text and inline items, laid out in a line. */
     children?: ReactNode;
 }
 /**
@@ -5456,6 +5715,11 @@ declare function InstrumentHeldMark({ size, kind, figureSize, }: {
  */
 declare function sayHeld(name: string, caption: string | null): string;
 
+/**
+ * The props every {@link JogWheel} takes, whichever its mode.
+ *
+ * @category Form
+ */
 interface JogWheelCommon {
     value: number;
     step: number;
@@ -5464,23 +5728,23 @@ interface JogWheelCommon {
     onChange: (next: number) => void;
     /** Caret label formatter, also used as `aria-valuetext`. Default `String(Math.round(v))`; for a quantity, write it with {@link writeQuantity}. */
     format?: (v: number) => string;
-    ariaLabel: string;
+    "aria-label": string;
     /**
-     * The name drawn above the wheel. Defaults to `ariaLabel`; `false` draws
+     * The name drawn above the wheel. Defaults to `aria-label`; `false` draws
      * none, for a wheel the caller already names beside it.
      */
     label?: string | false;
     disabled?: boolean;
     /**
      * Box width in CSS px. Defaults to 56 horizontal / 24 vertical. Clamped up
-     * to {@link JOG_WHEEL_MIN_TARGET_PX}. A `format` longer than a few
+     * to the smallest touch target. A `format` longer than a few
      * characters needs more than the default, as the caret label is clipped to
      * the box.
      */
     width?: number;
     /**
      * Box height in CSS px. Defaults to 24 horizontal / 56 vertical. Clamped up
-     * to {@link JOG_WHEEL_MIN_TARGET_PX}.
+     * to the smallest touch target.
      */
     height?: number;
 }
@@ -5523,7 +5787,7 @@ type JogWheelProps = (JogWheelCommon & {
  * @example
  * ```tsx
  * <JogWheel
- *   ariaLabel="Gain"
+ *   aria-label="Gain"
  *   value={gain}
  *   min={0}
  *   max={100}
@@ -5603,6 +5867,14 @@ interface LineGraphSeries {
      * grows to include the bounds.
      */
     reckoned?: readonly SeriesReckonedSpan[];
+    /**
+     * How to draw between two points, from the plotted value's sample kind:
+     * `"linear"` (the default) joins them with a line, `"step"` holds each value
+     * until the next point and then steps, for a value that stands until it
+     * changes, and `"none"` marks each point on its own and joins nothing, for a
+     * series of separate occurrences.
+     */
+    interpolation?: "linear" | "step" | "none";
 }
 /**
  * A horizontal reference level on a {@link LineGraph}, such as a safe limit.
@@ -5651,7 +5923,7 @@ interface LineGraphProps {
      * decorative beside a readout that already carries the reading, and the chart
      * renders `aria-hidden`.
      */
-    ariaLabel?: string;
+    "aria-label"?: string;
     /** Placed on the chart's root element, for a caller's own sizing or layout. */
     className?: string;
     /**
@@ -5683,7 +5955,7 @@ interface LineGraphProps {
  * <LineGraph
  *   variant="sparkline"
  *   height={96}
- *   ariaLabel="Radiation dose rate, last 10 minutes"
+ *   aria-label="Radiation dose rate, last 10 minutes"
  *   series={[
  *     {
  *       id: "ambient",
@@ -5702,7 +5974,7 @@ interface LineGraphProps {
  * A value over time: a line graph with series and thresholds, and the notice a
  * graph shows when it has nothing, or not enough, to draw.
  */
-declare function LineGraph({ series, thresholds, yDomain, height, ariaLabel, className, variant, thresholdStyle, }: LineGraphProps): react_jsx_runtime.JSX.Element;
+declare function LineGraph({ series, thresholds, yDomain, height, "aria-label": ariaLabel, className, variant, thresholdStyle, }: LineGraphProps): react_jsx_runtime.JSX.Element;
 
 /**
  * Props of {@link LiveRegion}.
@@ -5727,7 +5999,8 @@ interface LiveRegionProps {
     additionsOnly?: boolean;
     /**
      * Interrupt rather than announce: `aria-live="assertive"`, and `role="alert"`
-     * where the region is on screen. For ABORT-class states and nothing softer.
+     * where the region is on screen. Only for states that must interrupt
+     * whatever the operator is doing, such as a mission abort, and nothing softer.
      */
     assertive?: boolean;
     /** The element the region renders as. */
@@ -5742,7 +6015,8 @@ interface LiveRegionProps {
  * its message is often never announced. Mount this for as long as the thing it
  * reports on is on screen, and put the words in when there is something to say.
  *
- * Polite unless `assertive`, which interrupts and is kept for ABORT-class states.
+ * Polite unless `assertive`, which interrupts and is kept for states that must
+ * interrupt, such as a mission abort.
  *
  * @example Mounted with the control, empty until there is an outcome to say
  * ```tsx
@@ -5789,6 +6063,7 @@ interface LockSummary {
  * @category Panel
  */
 interface LockScopeProps {
+    /** The content the scope guards, drawn while nothing used inside it is locked. */
     children?: ReactNode;
     /**
      * What draws in place of `children` while something used inside the scope
@@ -5801,8 +6076,9 @@ interface LockScopeProps {
 /**
  * Marks a part of the tree that stands or falls together. When anything
  * inside it reads a Topic (with `useTelemetry` or `useStream`) or uses a
- * command (with `useCommand`) that this save has not unlocked, the whole scope
- * is replaced by its `fallback`. The innermost scope wins, so a scope inside a
+ * command (with `useCommand`) that this save has not unlocked (a technology
+ * not yet researched, or a building not yet upgraded, in a career save), the
+ * whole scope is replaced by its `fallback`. The innermost scope wins, so a scope inside a
  * section is replaced while the section stays.
  *
  * It draws no element of its own. A {@link Section}, each augment an
@@ -6156,10 +6432,11 @@ interface MeterProps<UnitSymbol extends string = string> extends MeterCommonProp
  *
  * ## Bands
  *
- * Where a reading carries an uncertainty band, the meter draws a tick at each
- * end of it on the track: two marks, never a shaded interval. The bar still
- * shows the observed value, and the ticks sit where the forward model puts the
- * value now. A band on the capacity is ticked near the track's end, as a
+ * Where a reading carries an {@link UncertaintyBand} (how far its forward
+ * model, see {@link TopicReckoning}, would defend the figure), the meter draws
+ * a tick at each end of it on the track: two marks, never a shaded interval.
+ * The bar still shows the observed value, and the ticks sit where the model
+ * puts the value now. A band on the capacity is ticked near the track's end, as a
  * fraction of the capacity drawn. A band in a different unit from the value or
  * capacity it belongs to draws nothing.
  *
@@ -6210,16 +6487,17 @@ declare function Meter<UnitSymbol extends string = string>({ label, value, capac
  */
 declare function MeterStack({ children, ...rest }: HTMLAttributes<HTMLDivElement>): react_jsx_runtime.JSX.Element;
 /**
- * Keeps a row meter on its `MeterStack`'s columns while it shares a slot with
- * other lines, such as a caption under the bar.
+ * Keeps a row meter on its `MeterStack`'s columns while it shares one cell of
+ * the stack with other lines, such as a caption under the bar. Wrap the meter
+ * and the extra lines in one group.
  *
  * @category Meter
  */
-declare const MeterRowGroup: styled_components_dist_types.IStyledComponentBase<"web", styled_components.FastOmit<styled_components.FastOmit<react.DetailedHTMLProps<HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref" | "key" | keyof HTMLAttributes<HTMLDivElement>> & Omit<react.DetailedHTMLProps<HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & {
+declare const MeterRowGroup: styled_components_dist_types.IStyledComponentBase<"web", styled_components.FastOmit<styled_components.FastOmit<react.DetailedHTMLProps<HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "key" | "ref" | keyof HTMLAttributes<HTMLDivElement>> & Omit<react.DetailedHTMLProps<HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & {
     ref?: ((instance: HTMLDivElement | null) => void | react.DO_NOT_USE_OR_YOU_WILL_BE_FIRED_CALLBACK_REF_RETURN_VALUES[keyof react.DO_NOT_USE_OR_YOU_WILL_BE_FIRED_CALLBACK_REF_RETURN_VALUES]) | react.RefObject<HTMLDivElement> | null | undefined;
-}, "id" | "title" | "about" | "resource" | "nonce" | "children" | "results" | "slot" | "style" | "defaultChecked" | "defaultValue" | "suppressContentEditableWarning" | "suppressHydrationWarning" | "accessKey" | "autoCapitalize" | "autoFocus" | "className" | "contentEditable" | "contextMenu" | "dir" | "draggable" | "enterKeyHint" | "hidden" | "lang" | "spellCheck" | "tabIndex" | "translate" | "radioGroup" | "role" | "content" | "datatype" | "inlist" | "prefix" | "property" | "rel" | "rev" | "typeof" | "vocab" | "autoCorrect" | "autoSave" | "color" | "itemProp" | "itemScope" | "itemType" | "itemID" | "itemRef" | "security" | "unselectable" | "inputMode" | "is" | "exportparts" | "part" | "aria-activedescendant" | "aria-atomic" | "aria-autocomplete" | "aria-braillelabel" | "aria-brailleroledescription" | "aria-busy" | "aria-checked" | "aria-colcount" | "aria-colindex" | "aria-colindextext" | "aria-colspan" | "aria-controls" | "aria-current" | "aria-describedby" | "aria-description" | "aria-details" | "aria-disabled" | "aria-dropeffect" | "aria-errormessage" | "aria-expanded" | "aria-flowto" | "aria-grabbed" | "aria-haspopup" | "aria-hidden" | "aria-invalid" | "aria-keyshortcuts" | "aria-label" | "aria-labelledby" | "aria-level" | "aria-live" | "aria-modal" | "aria-multiline" | "aria-multiselectable" | "aria-orientation" | "aria-owns" | "aria-placeholder" | "aria-posinset" | "aria-pressed" | "aria-readonly" | "aria-relevant" | "aria-required" | "aria-roledescription" | "aria-rowcount" | "aria-rowindex" | "aria-rowindextext" | "aria-rowspan" | "aria-selected" | "aria-setsize" | "aria-sort" | "aria-valuemax" | "aria-valuemin" | "aria-valuenow" | "aria-valuetext" | "dangerouslySetInnerHTML" | "onCopy" | "onCopyCapture" | "onCut" | "onCutCapture" | "onPaste" | "onPasteCapture" | "onCompositionEnd" | "onCompositionEndCapture" | "onCompositionStart" | "onCompositionStartCapture" | "onCompositionUpdate" | "onCompositionUpdateCapture" | "onFocus" | "onFocusCapture" | "onBlur" | "onBlurCapture" | "onChange" | "onChangeCapture" | "onBeforeInput" | "onBeforeInputCapture" | "onInput" | "onInputCapture" | "onReset" | "onResetCapture" | "onSubmit" | "onSubmitCapture" | "onInvalid" | "onInvalidCapture" | "onLoad" | "onLoadCapture" | "onError" | "onErrorCapture" | "onKeyDown" | "onKeyDownCapture" | "onKeyPress" | "onKeyPressCapture" | "onKeyUp" | "onKeyUpCapture" | "onAbort" | "onAbortCapture" | "onCanPlay" | "onCanPlayCapture" | "onCanPlayThrough" | "onCanPlayThroughCapture" | "onDurationChange" | "onDurationChangeCapture" | "onEmptied" | "onEmptiedCapture" | "onEncrypted" | "onEncryptedCapture" | "onEnded" | "onEndedCapture" | "onLoadedData" | "onLoadedDataCapture" | "onLoadedMetadata" | "onLoadedMetadataCapture" | "onLoadStart" | "onLoadStartCapture" | "onPause" | "onPauseCapture" | "onPlay" | "onPlayCapture" | "onPlaying" | "onPlayingCapture" | "onProgress" | "onProgressCapture" | "onRateChange" | "onRateChangeCapture" | "onSeeked" | "onSeekedCapture" | "onSeeking" | "onSeekingCapture" | "onStalled" | "onStalledCapture" | "onSuspend" | "onSuspendCapture" | "onTimeUpdate" | "onTimeUpdateCapture" | "onVolumeChange" | "onVolumeChangeCapture" | "onWaiting" | "onWaitingCapture" | "onAuxClick" | "onAuxClickCapture" | "onClick" | "onClickCapture" | "onContextMenu" | "onContextMenuCapture" | "onDoubleClick" | "onDoubleClickCapture" | "onDrag" | "onDragCapture" | "onDragEnd" | "onDragEndCapture" | "onDragEnter" | "onDragEnterCapture" | "onDragExit" | "onDragExitCapture" | "onDragLeave" | "onDragLeaveCapture" | "onDragOver" | "onDragOverCapture" | "onDragStart" | "onDragStartCapture" | "onDrop" | "onDropCapture" | "onMouseDown" | "onMouseDownCapture" | "onMouseEnter" | "onMouseLeave" | "onMouseMove" | "onMouseMoveCapture" | "onMouseOut" | "onMouseOutCapture" | "onMouseOver" | "onMouseOverCapture" | "onMouseUp" | "onMouseUpCapture" | "onSelect" | "onSelectCapture" | "onTouchCancel" | "onTouchCancelCapture" | "onTouchEnd" | "onTouchEndCapture" | "onTouchMove" | "onTouchMoveCapture" | "onTouchStart" | "onTouchStartCapture" | "onPointerDown" | "onPointerDownCapture" | "onPointerMove" | "onPointerMoveCapture" | "onPointerUp" | "onPointerUpCapture" | "onPointerCancel" | "onPointerCancelCapture" | "onPointerEnter" | "onPointerLeave" | "onPointerOver" | "onPointerOverCapture" | "onPointerOut" | "onPointerOutCapture" | "onGotPointerCapture" | "onGotPointerCaptureCapture" | "onLostPointerCapture" | "onLostPointerCaptureCapture" | "onScroll" | "onScrollCapture" | "onWheel" | "onWheelCapture" | "onAnimationStart" | "onAnimationStartCapture" | "onAnimationEnd" | "onAnimationEndCapture" | "onAnimationIteration" | "onAnimationIterationCapture" | "onTransitionEnd" | "onTransitionEndCapture"> & Partial<Pick<styled_components.FastOmit<react.DetailedHTMLProps<HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref" | "key" | keyof HTMLAttributes<HTMLDivElement>> & Omit<react.DetailedHTMLProps<HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & {
+}, "slot" | "style" | "title" | "dir" | "id" | "about" | "resource" | "nonce" | "prefix" | "results" | "children" | "defaultChecked" | "defaultValue" | "suppressContentEditableWarning" | "suppressHydrationWarning" | "accessKey" | "autoCapitalize" | "autoFocus" | "className" | "contentEditable" | "contextMenu" | "draggable" | "enterKeyHint" | "hidden" | "lang" | "spellCheck" | "tabIndex" | "translate" | "radioGroup" | "role" | "content" | "datatype" | "inlist" | "property" | "rel" | "rev" | "typeof" | "vocab" | "autoCorrect" | "autoSave" | "color" | "itemProp" | "itemScope" | "itemType" | "itemID" | "itemRef" | "security" | "unselectable" | "inputMode" | "is" | "exportparts" | "part" | "aria-activedescendant" | "aria-atomic" | "aria-autocomplete" | "aria-braillelabel" | "aria-brailleroledescription" | "aria-busy" | "aria-checked" | "aria-colcount" | "aria-colindex" | "aria-colindextext" | "aria-colspan" | "aria-controls" | "aria-current" | "aria-describedby" | "aria-description" | "aria-details" | "aria-disabled" | "aria-dropeffect" | "aria-errormessage" | "aria-expanded" | "aria-flowto" | "aria-grabbed" | "aria-haspopup" | "aria-hidden" | "aria-invalid" | "aria-keyshortcuts" | "aria-label" | "aria-labelledby" | "aria-level" | "aria-live" | "aria-modal" | "aria-multiline" | "aria-multiselectable" | "aria-orientation" | "aria-owns" | "aria-placeholder" | "aria-posinset" | "aria-pressed" | "aria-readonly" | "aria-relevant" | "aria-required" | "aria-roledescription" | "aria-rowcount" | "aria-rowindex" | "aria-rowindextext" | "aria-rowspan" | "aria-selected" | "aria-setsize" | "aria-sort" | "aria-valuemax" | "aria-valuemin" | "aria-valuenow" | "aria-valuetext" | "dangerouslySetInnerHTML" | "onCopy" | "onCopyCapture" | "onCut" | "onCutCapture" | "onPaste" | "onPasteCapture" | "onCompositionEnd" | "onCompositionEndCapture" | "onCompositionStart" | "onCompositionStartCapture" | "onCompositionUpdate" | "onCompositionUpdateCapture" | "onFocus" | "onFocusCapture" | "onBlur" | "onBlurCapture" | "onChange" | "onChangeCapture" | "onBeforeInput" | "onBeforeInputCapture" | "onInput" | "onInputCapture" | "onReset" | "onResetCapture" | "onSubmit" | "onSubmitCapture" | "onInvalid" | "onInvalidCapture" | "onLoad" | "onLoadCapture" | "onError" | "onErrorCapture" | "onKeyDown" | "onKeyDownCapture" | "onKeyPress" | "onKeyPressCapture" | "onKeyUp" | "onKeyUpCapture" | "onAbort" | "onAbortCapture" | "onCanPlay" | "onCanPlayCapture" | "onCanPlayThrough" | "onCanPlayThroughCapture" | "onDurationChange" | "onDurationChangeCapture" | "onEmptied" | "onEmptiedCapture" | "onEncrypted" | "onEncryptedCapture" | "onEnded" | "onEndedCapture" | "onLoadedData" | "onLoadedDataCapture" | "onLoadedMetadata" | "onLoadedMetadataCapture" | "onLoadStart" | "onLoadStartCapture" | "onPause" | "onPauseCapture" | "onPlay" | "onPlayCapture" | "onPlaying" | "onPlayingCapture" | "onProgress" | "onProgressCapture" | "onRateChange" | "onRateChangeCapture" | "onSeeked" | "onSeekedCapture" | "onSeeking" | "onSeekingCapture" | "onStalled" | "onStalledCapture" | "onSuspend" | "onSuspendCapture" | "onTimeUpdate" | "onTimeUpdateCapture" | "onVolumeChange" | "onVolumeChangeCapture" | "onWaiting" | "onWaitingCapture" | "onAuxClick" | "onAuxClickCapture" | "onClick" | "onClickCapture" | "onContextMenu" | "onContextMenuCapture" | "onDoubleClick" | "onDoubleClickCapture" | "onDrag" | "onDragCapture" | "onDragEnd" | "onDragEndCapture" | "onDragEnter" | "onDragEnterCapture" | "onDragExit" | "onDragExitCapture" | "onDragLeave" | "onDragLeaveCapture" | "onDragOver" | "onDragOverCapture" | "onDragStart" | "onDragStartCapture" | "onDrop" | "onDropCapture" | "onMouseDown" | "onMouseDownCapture" | "onMouseEnter" | "onMouseLeave" | "onMouseMove" | "onMouseMoveCapture" | "onMouseOut" | "onMouseOutCapture" | "onMouseOver" | "onMouseOverCapture" | "onMouseUp" | "onMouseUpCapture" | "onSelect" | "onSelectCapture" | "onTouchCancel" | "onTouchCancelCapture" | "onTouchEnd" | "onTouchEndCapture" | "onTouchMove" | "onTouchMoveCapture" | "onTouchStart" | "onTouchStartCapture" | "onPointerDown" | "onPointerDownCapture" | "onPointerMove" | "onPointerMoveCapture" | "onPointerUp" | "onPointerUpCapture" | "onPointerCancel" | "onPointerCancelCapture" | "onPointerEnter" | "onPointerLeave" | "onPointerOver" | "onPointerOverCapture" | "onPointerOut" | "onPointerOutCapture" | "onGotPointerCapture" | "onGotPointerCaptureCapture" | "onLostPointerCapture" | "onLostPointerCaptureCapture" | "onScroll" | "onScrollCapture" | "onWheel" | "onWheelCapture" | "onAnimationStart" | "onAnimationStartCapture" | "onAnimationEnd" | "onAnimationEndCapture" | "onAnimationIteration" | "onAnimationIterationCapture" | "onTransitionEnd" | "onTransitionEndCapture"> & Partial<Pick<styled_components.FastOmit<react.DetailedHTMLProps<HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "key" | "ref" | keyof HTMLAttributes<HTMLDivElement>> & Omit<react.DetailedHTMLProps<HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & {
     ref?: ((instance: HTMLDivElement | null) => void | react.DO_NOT_USE_OR_YOU_WILL_BE_FIRED_CALLBACK_REF_RETURN_VALUES[keyof react.DO_NOT_USE_OR_YOU_WILL_BE_FIRED_CALLBACK_REF_RETURN_VALUES]) | react.RefObject<HTMLDivElement> | null | undefined;
-}, "id" | "title" | "about" | "resource" | "nonce" | "children" | "results" | "slot" | "style" | "defaultChecked" | "defaultValue" | "suppressContentEditableWarning" | "suppressHydrationWarning" | "accessKey" | "autoCapitalize" | "autoFocus" | "className" | "contentEditable" | "contextMenu" | "dir" | "draggable" | "enterKeyHint" | "hidden" | "lang" | "spellCheck" | "tabIndex" | "translate" | "radioGroup" | "role" | "content" | "datatype" | "inlist" | "prefix" | "property" | "rel" | "rev" | "typeof" | "vocab" | "autoCorrect" | "autoSave" | "color" | "itemProp" | "itemScope" | "itemType" | "itemID" | "itemRef" | "security" | "unselectable" | "inputMode" | "is" | "exportparts" | "part" | "aria-activedescendant" | "aria-atomic" | "aria-autocomplete" | "aria-braillelabel" | "aria-brailleroledescription" | "aria-busy" | "aria-checked" | "aria-colcount" | "aria-colindex" | "aria-colindextext" | "aria-colspan" | "aria-controls" | "aria-current" | "aria-describedby" | "aria-description" | "aria-details" | "aria-disabled" | "aria-dropeffect" | "aria-errormessage" | "aria-expanded" | "aria-flowto" | "aria-grabbed" | "aria-haspopup" | "aria-hidden" | "aria-invalid" | "aria-keyshortcuts" | "aria-label" | "aria-labelledby" | "aria-level" | "aria-live" | "aria-modal" | "aria-multiline" | "aria-multiselectable" | "aria-orientation" | "aria-owns" | "aria-placeholder" | "aria-posinset" | "aria-pressed" | "aria-readonly" | "aria-relevant" | "aria-required" | "aria-roledescription" | "aria-rowcount" | "aria-rowindex" | "aria-rowindextext" | "aria-rowspan" | "aria-selected" | "aria-setsize" | "aria-sort" | "aria-valuemax" | "aria-valuemin" | "aria-valuenow" | "aria-valuetext" | "dangerouslySetInnerHTML" | "onCopy" | "onCopyCapture" | "onCut" | "onCutCapture" | "onPaste" | "onPasteCapture" | "onCompositionEnd" | "onCompositionEndCapture" | "onCompositionStart" | "onCompositionStartCapture" | "onCompositionUpdate" | "onCompositionUpdateCapture" | "onFocus" | "onFocusCapture" | "onBlur" | "onBlurCapture" | "onChange" | "onChangeCapture" | "onBeforeInput" | "onBeforeInputCapture" | "onInput" | "onInputCapture" | "onReset" | "onResetCapture" | "onSubmit" | "onSubmitCapture" | "onInvalid" | "onInvalidCapture" | "onLoad" | "onLoadCapture" | "onError" | "onErrorCapture" | "onKeyDown" | "onKeyDownCapture" | "onKeyPress" | "onKeyPressCapture" | "onKeyUp" | "onKeyUpCapture" | "onAbort" | "onAbortCapture" | "onCanPlay" | "onCanPlayCapture" | "onCanPlayThrough" | "onCanPlayThroughCapture" | "onDurationChange" | "onDurationChangeCapture" | "onEmptied" | "onEmptiedCapture" | "onEncrypted" | "onEncryptedCapture" | "onEnded" | "onEndedCapture" | "onLoadedData" | "onLoadedDataCapture" | "onLoadedMetadata" | "onLoadedMetadataCapture" | "onLoadStart" | "onLoadStartCapture" | "onPause" | "onPauseCapture" | "onPlay" | "onPlayCapture" | "onPlaying" | "onPlayingCapture" | "onProgress" | "onProgressCapture" | "onRateChange" | "onRateChangeCapture" | "onSeeked" | "onSeekedCapture" | "onSeeking" | "onSeekingCapture" | "onStalled" | "onStalledCapture" | "onSuspend" | "onSuspendCapture" | "onTimeUpdate" | "onTimeUpdateCapture" | "onVolumeChange" | "onVolumeChangeCapture" | "onWaiting" | "onWaitingCapture" | "onAuxClick" | "onAuxClickCapture" | "onClick" | "onClickCapture" | "onContextMenu" | "onContextMenuCapture" | "onDoubleClick" | "onDoubleClickCapture" | "onDrag" | "onDragCapture" | "onDragEnd" | "onDragEndCapture" | "onDragEnter" | "onDragEnterCapture" | "onDragExit" | "onDragExitCapture" | "onDragLeave" | "onDragLeaveCapture" | "onDragOver" | "onDragOverCapture" | "onDragStart" | "onDragStartCapture" | "onDrop" | "onDropCapture" | "onMouseDown" | "onMouseDownCapture" | "onMouseEnter" | "onMouseLeave" | "onMouseMove" | "onMouseMoveCapture" | "onMouseOut" | "onMouseOutCapture" | "onMouseOver" | "onMouseOverCapture" | "onMouseUp" | "onMouseUpCapture" | "onSelect" | "onSelectCapture" | "onTouchCancel" | "onTouchCancelCapture" | "onTouchEnd" | "onTouchEndCapture" | "onTouchMove" | "onTouchMoveCapture" | "onTouchStart" | "onTouchStartCapture" | "onPointerDown" | "onPointerDownCapture" | "onPointerMove" | "onPointerMoveCapture" | "onPointerUp" | "onPointerUpCapture" | "onPointerCancel" | "onPointerCancelCapture" | "onPointerEnter" | "onPointerLeave" | "onPointerOver" | "onPointerOverCapture" | "onPointerOut" | "onPointerOutCapture" | "onGotPointerCapture" | "onGotPointerCaptureCapture" | "onLostPointerCapture" | "onLostPointerCaptureCapture" | "onScroll" | "onScrollCapture" | "onWheel" | "onWheelCapture" | "onAnimationStart" | "onAnimationStartCapture" | "onAnimationEnd" | "onAnimationEndCapture" | "onAnimationIteration" | "onAnimationIterationCapture" | "onTransitionEnd" | "onTransitionEndCapture">>> & string;
+}, "slot" | "style" | "title" | "dir" | "id" | "about" | "resource" | "nonce" | "prefix" | "results" | "children" | "defaultChecked" | "defaultValue" | "suppressContentEditableWarning" | "suppressHydrationWarning" | "accessKey" | "autoCapitalize" | "autoFocus" | "className" | "contentEditable" | "contextMenu" | "draggable" | "enterKeyHint" | "hidden" | "lang" | "spellCheck" | "tabIndex" | "translate" | "radioGroup" | "role" | "content" | "datatype" | "inlist" | "property" | "rel" | "rev" | "typeof" | "vocab" | "autoCorrect" | "autoSave" | "color" | "itemProp" | "itemScope" | "itemType" | "itemID" | "itemRef" | "security" | "unselectable" | "inputMode" | "is" | "exportparts" | "part" | "aria-activedescendant" | "aria-atomic" | "aria-autocomplete" | "aria-braillelabel" | "aria-brailleroledescription" | "aria-busy" | "aria-checked" | "aria-colcount" | "aria-colindex" | "aria-colindextext" | "aria-colspan" | "aria-controls" | "aria-current" | "aria-describedby" | "aria-description" | "aria-details" | "aria-disabled" | "aria-dropeffect" | "aria-errormessage" | "aria-expanded" | "aria-flowto" | "aria-grabbed" | "aria-haspopup" | "aria-hidden" | "aria-invalid" | "aria-keyshortcuts" | "aria-label" | "aria-labelledby" | "aria-level" | "aria-live" | "aria-modal" | "aria-multiline" | "aria-multiselectable" | "aria-orientation" | "aria-owns" | "aria-placeholder" | "aria-posinset" | "aria-pressed" | "aria-readonly" | "aria-relevant" | "aria-required" | "aria-roledescription" | "aria-rowcount" | "aria-rowindex" | "aria-rowindextext" | "aria-rowspan" | "aria-selected" | "aria-setsize" | "aria-sort" | "aria-valuemax" | "aria-valuemin" | "aria-valuenow" | "aria-valuetext" | "dangerouslySetInnerHTML" | "onCopy" | "onCopyCapture" | "onCut" | "onCutCapture" | "onPaste" | "onPasteCapture" | "onCompositionEnd" | "onCompositionEndCapture" | "onCompositionStart" | "onCompositionStartCapture" | "onCompositionUpdate" | "onCompositionUpdateCapture" | "onFocus" | "onFocusCapture" | "onBlur" | "onBlurCapture" | "onChange" | "onChangeCapture" | "onBeforeInput" | "onBeforeInputCapture" | "onInput" | "onInputCapture" | "onReset" | "onResetCapture" | "onSubmit" | "onSubmitCapture" | "onInvalid" | "onInvalidCapture" | "onLoad" | "onLoadCapture" | "onError" | "onErrorCapture" | "onKeyDown" | "onKeyDownCapture" | "onKeyPress" | "onKeyPressCapture" | "onKeyUp" | "onKeyUpCapture" | "onAbort" | "onAbortCapture" | "onCanPlay" | "onCanPlayCapture" | "onCanPlayThrough" | "onCanPlayThroughCapture" | "onDurationChange" | "onDurationChangeCapture" | "onEmptied" | "onEmptiedCapture" | "onEncrypted" | "onEncryptedCapture" | "onEnded" | "onEndedCapture" | "onLoadedData" | "onLoadedDataCapture" | "onLoadedMetadata" | "onLoadedMetadataCapture" | "onLoadStart" | "onLoadStartCapture" | "onPause" | "onPauseCapture" | "onPlay" | "onPlayCapture" | "onPlaying" | "onPlayingCapture" | "onProgress" | "onProgressCapture" | "onRateChange" | "onRateChangeCapture" | "onSeeked" | "onSeekedCapture" | "onSeeking" | "onSeekingCapture" | "onStalled" | "onStalledCapture" | "onSuspend" | "onSuspendCapture" | "onTimeUpdate" | "onTimeUpdateCapture" | "onVolumeChange" | "onVolumeChangeCapture" | "onWaiting" | "onWaitingCapture" | "onAuxClick" | "onAuxClickCapture" | "onClick" | "onClickCapture" | "onContextMenu" | "onContextMenuCapture" | "onDoubleClick" | "onDoubleClickCapture" | "onDrag" | "onDragCapture" | "onDragEnd" | "onDragEndCapture" | "onDragEnter" | "onDragEnterCapture" | "onDragExit" | "onDragExitCapture" | "onDragLeave" | "onDragLeaveCapture" | "onDragOver" | "onDragOverCapture" | "onDragStart" | "onDragStartCapture" | "onDrop" | "onDropCapture" | "onMouseDown" | "onMouseDownCapture" | "onMouseEnter" | "onMouseLeave" | "onMouseMove" | "onMouseMoveCapture" | "onMouseOut" | "onMouseOutCapture" | "onMouseOver" | "onMouseOverCapture" | "onMouseUp" | "onMouseUpCapture" | "onSelect" | "onSelectCapture" | "onTouchCancel" | "onTouchCancelCapture" | "onTouchEnd" | "onTouchEndCapture" | "onTouchMove" | "onTouchMoveCapture" | "onTouchStart" | "onTouchStartCapture" | "onPointerDown" | "onPointerDownCapture" | "onPointerMove" | "onPointerMoveCapture" | "onPointerUp" | "onPointerUpCapture" | "onPointerCancel" | "onPointerCancelCapture" | "onPointerEnter" | "onPointerLeave" | "onPointerOver" | "onPointerOverCapture" | "onPointerOut" | "onPointerOutCapture" | "onGotPointerCapture" | "onGotPointerCaptureCapture" | "onLostPointerCapture" | "onLostPointerCaptureCapture" | "onScroll" | "onScrollCapture" | "onWheel" | "onWheelCapture" | "onAnimationStart" | "onAnimationStartCapture" | "onAnimationEnd" | "onAnimationEndCapture" | "onAnimationIteration" | "onAnimationIterationCapture" | "onTransitionEnd" | "onTransitionEndCapture">>> & string;
 
 /**
  * Which clock an instant is on. Under signal delay they differ for the same
@@ -6314,6 +6592,7 @@ interface MissionDateFieldProps {
     onChange: (ut: number) => void;
     /** Names the whole group for a screen reader: "Ignition", "Plan end". */
     label: string;
+    /** Greys the field and its buttons out and ignores input. */
     disabled?: boolean;
     /**
      * The coarse steps offered, in seconds, smallest first. Rendered as a minus
@@ -6360,8 +6639,9 @@ declare function utOfParts(parts: MissionDateParts): number;
  * what the game's own clock calls day 300. Edits round to the second, so the
  * field never shows one instant and holds another.
  *
- * An instant nobody stated is not the epoch: `null` comes up empty with the
- * absent token, and nothing is committed until a component is typed.
+ * An instant nobody stated is not the epoch (UT 0, the start of the game's
+ * calendar): `null` comes up empty with {@link NULL_DISPLAY}, the dash that
+ * stands for no value, and nothing is committed until a component is typed.
  *
  * {@link UnitInput} with a `ut` unit renders this for you and emits a `Value`;
  * use this directly when you hold the instant as a bare number of seconds.
@@ -6370,13 +6650,24 @@ declare function utOfParts(parts: MissionDateParts): number;
  */
 declare function MissionDateField({ value, onChange, label, disabled, steps, }: MissionDateFieldProps): react_jsx_runtime.JSX.Element;
 
+/**
+ * What {@link useModal}'s `open` takes beside the content.
+ *
+ * @category Modal
+ */
 interface ModalOpenOptions {
+    /** The dialog's visible heading, which also names it for assistive technology. Without one, give `aria-label`. */
     title?: string;
     /** Names a dialog that has no visible `title`. Ignored when `title` is given. */
-    ariaLabel?: string;
+    "aria-label"?: string;
     /** CSS length for the dialog max-width. Defaults to 560px. */
     width?: string;
 }
+/**
+ * What {@link useModal} returns: open and close dialogs.
+ *
+ * @category Modal
+ */
 interface ModalContextValue {
     /** Opens a dialog showing `content` on top of any already open, and returns its id. */
     open: (content: ReactNode, options?: ModalOpenOptions) => string;
@@ -6386,8 +6677,8 @@ interface ModalContextValue {
 /**
  * Holds the stack of open modal dialogs and renders them into `document.body`.
  * The dashboard mounts one at its root, so a widget on the dashboard calls
- * {@link useModal} without mounting its own. Anywhere else, such as a test or
- * a page of your own, wrap the tree in one: `useModal` needs it above it.
+ * {@link useModal} without mounting its own. Anywhere else, such as a test that
+ * renders a widget with a config form, wrap the tree in one: `useModal` needs it above it.
  *
  * Each dialog has a title bar with a close button, a scrolling body, and an
  * optional sticky footer set with {@link useModalSaveBar} or
@@ -6407,7 +6698,7 @@ declare function ModalProvider({ children }: Readonly<{
 /**
  * Opens and closes modal dialogs. `open(content, options)` pushes a dialog
  * showing `content` and returns its id; `options` takes a `title`, an
- * `ariaLabel` for a dialog with no visible title, and a CSS `width` for the
+ * `aria-label` for a dialog with no visible title, and a CSS `width` for the
  * dialog's max-width (560px by default). `close(id)` removes that dialog.
  * Throws when called outside a {@link ModalProvider}.
  *
@@ -6441,6 +6732,7 @@ interface ModalChromeValue {
  * a modal. Content uses {@link useModalChrome} or {@link useModalSaveBar}
  * rather than reading it.
  *
+ * @intent Published so content that calls useModalChrome can be rendered under a stand-in modal in a test.
  * @category Modal
  */
 declare const ModalChromeContext: react.Context<ModalChromeValue | null>;
@@ -6493,6 +6785,10 @@ interface ModalSaveBarOptions<Draft> {
  * from both its value when the modal opened and `saved`. The hook renders
  * nothing where it is called and does nothing outside a modal.
  *
+ * The form is a widget's `configComponent`: register it beside the widget with
+ * `registerComponent({ ..., configComponent: NavballConfigForm })`, and the
+ * dashboard opens it in a modal with the saved `config` and an `onSave`.
+ *
  * @example
  * ```tsx
  * import { useMemo, useState } from "react";
@@ -6533,6 +6829,7 @@ interface ModelledQuantityAlongsideProps<UnitSymbol extends string> {
     observed: Value<UnitSymbol> | null | undefined;
     /** The model's figure; nothing is drawn without one. */
     modelled: Value<UnitSymbol> | null | undefined;
+    /** Absent in this form: a `Value` pair is written by {@link Unit}, so no writer is given. */
     write?: undefined;
 }
 /**
@@ -6587,8 +6884,8 @@ interface NoticeProps extends BlockProps {
     tone?: Tone;
     /**
      * Interrupt rather than announce politely: the banner becomes
-     * `role="alert"` with `aria-live="assertive"`. Keep it for an abort and
-     * nothing softer.
+     * `role="alert"` with `aria-live="assertive"`. Keep it for a state that
+     * must interrupt, such as a mission abort, and nothing softer.
      */
     assertive?: boolean;
     /** What the banner says. */
@@ -6597,7 +6894,9 @@ interface NoticeProps extends BlockProps {
 /**
  * A banner stating something about the widget rather than a record inside it,
  * such as what is limiting the ship. It takes {@link Block}'s anatomy (title,
- * asides, footer) on a sunken surface bordered in its tone.
+ * asides, footer) on a sunken surface bordered in its tone. Most banners need
+ * only `title`, `tone` and their text; the other anatomy props are for a banner
+ * that also carries a figure beside it or a footer of actions.
  *
  * Unlike a toned {@link Card}, a notice is announced to screen readers. By
  * default it is `role="note"` and its text is read out politely when it
@@ -6716,12 +7015,14 @@ interface SectionProps extends Omit<HTMLAttributes<HTMLDivElement>, "title"> {
      * Take the panel body's leftover height rather than the section's natural
      * one, for a section that is a drawing (a map, a plot, a dial).
      *
-     * A filling section is lifted out of the section grid, so it always spans the
-     * panel's full width; ordinary sections around it still columnise. Two filling
-     * sections each keep their content height and share the leftover equally.
-     * Ignored under `fitToSize`, and inert outside a panel body.
+     * A filling section is lifted out of the section grid (the columns a wide
+     * panel lays its sections out in), so it always spans the panel's full
+     * width; ordinary sections around it still form columns. Two filling sections
+     * each keep their content height and share the leftover equally. Ignored
+     * when the panel's `fitToSize` prop is set, and inert outside a panel body.
      */
     fill?: boolean;
+    /** The section's content, under its title. */
     children?: ReactNode;
 }
 /**
@@ -6731,8 +7032,8 @@ interface SectionProps extends Omit<HTMLAttributes<HTMLDivElement>, "title"> {
  * leftover height.
  *
  * A section is also a {@link LockScope}: when anything inside it reads a Topic
- * or uses a command this save has not unlocked, the section keeps its title
- * and shows what is missing in place of its content.
+ * or uses a command this save has not unlocked (see {@link LockScope}), the
+ * section keeps its title and shows what is missing in place of its content.
  *
  * @category Layout
  */
@@ -6745,8 +7046,10 @@ declare function Section({ children, gap, title, titleAs, full, fill, ...rest }:
  * @category Layout
  */
 declare const SectionTitle: styled_components_dist_types.IStyledComponentBase<"web", styled_components.FastOmit<styled_components.FastOmit<react.DetailedHTMLProps<HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "$rule"> & {
+    /** Draws a hairline under the heading. */
     $rule?: boolean;
 }, never> & Partial<Pick<styled_components.FastOmit<react.DetailedHTMLProps<HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "$rule"> & {
+    /** Draws a hairline under the heading. */
     $rule?: boolean;
 }, never>>> & string;
 
@@ -6824,26 +7127,6 @@ declare const ScrollArea: react.ForwardRefExoticComponent<Omit<react.DetailedHTM
  * @category Panel
  */
 type PanelSidebarSide = "start" | "end";
-/**
- * Props for the grid that holds a panel's body and sidebar. {@link Panel}
- * draws this grid itself when `panelSidebar` is set, taking `sidebarSide` and
- * `sidebarSize` as `side` and `size`.
- *
- * @category Panel
- */
-interface PanelSplitProps extends ComponentPropsWithoutRef<"div"> {
-    /** Which edge the sidebar sits against. See {@link PanelSidebarSide}. Defaults to `end`. */
-    side?: PanelSidebarSide;
-    /**
-     * Size of the sidebar track: a width on the inline axis, a height on the
-     * block axis. Defaults to `14rem`, and to a fixed five grid rows under the
-     * body (capped at 45% of a very short tile), so the body takes the rest and
-     * content never grows the sidebar. Overflow scrolls inside it.
-     */
-    size?: string;
-    /** Gives the sidebar a top inset matching the delay rail's band, which the body track holds inside its scroller. */
-    railBand?: boolean;
-}
 /**
  * Secondary content beside or below the body: an almanac for the diagram, a
  * legend for the plot, a detail pane for the selected row.
@@ -6901,8 +7184,8 @@ interface PanelProps extends ComponentPropsWithoutRef<"div"> {
     sections?: Exclude<ReactNode, boolean> | readonly ReactNode[];
     /**
      * Narrowest a section column may be before the panel stops offering a
-     * second one. Defaults to `13rem`, which gives two columns in a panel about
-     * 470px wide.
+     * second one. Defaults to `13rem` (208px at the default font size), which gives two
+     * columns in a panel about 470px wide.
      *
      * Raise it for a widget whose sections carry long rows and read badly at the
      * default width; set it to `100%` for one that should never columnise at all.
@@ -6934,8 +7217,11 @@ interface PanelProps extends ComponentPropsWithoutRef<"div"> {
      * announced when it changes. `live` shows nothing, and `"none"` suppresses
      * the badge.
      *
-     * The dashboard sets the blackout grades (`recorded`,
-     * `last-before-blackout`) itself, from the widget's declared channels. Any
+     * The dashboard sets the blackout grades itself, from the widget's declared
+     * channels (the Topics it reads). A blackout is a stretch when the craft's
+     * signal cannot reach the command centre: the last value sent before it is
+     * `last-before-blackout`, and a value the craft sent once contact came back
+     * is `recorded`. The grades are listed on {@link StreamStatusValue}. Any
      * other grade shows only when set here, so set it for a panel that reads one
      * specific Topic. It is merged, worst first, with the dashboard's status and
      * any badge drawn with `report`.
@@ -7134,7 +7420,8 @@ declare function PanelRoot(props: PanelProps): ReactElement;
  * a widget can compose a variant by hand from them:
  *
  * - `Panel.Container`: the bordered frame
- * - `Panel.Context`: links the body's scroller to the glow
+ * - `Panel.Context`: the provider that links the body's scroller to the glow;
+ *   take no props but `children`
  * - `Panel.Delay`: the delay rail above the header
  * - `Panel.Header`: the title and its aside on one row, collapsing the aside
  *   to status dots when they no longer fit
@@ -7185,6 +7472,9 @@ declare function PanelRoot(props: PanelProps): ReactElement;
  * } from "@ksp-gonogo/sitrep-sdk";
  * import { Section, Text, Unit } from "@ksp-gonogo/ui-kit";
  *
+ * // In a real Uplink this block is in `src/topics.ts`, with the payload type
+ * // `uplink-tools codegen` writes from the contract; it is spelled out here so
+ * // the example stands alone.
  * declare module "@ksp-gonogo/sitrep-sdk" {
  *   interface TopicPayloadMap {
  *     "example.heartbeat": { ut: Value<"ut"> };
@@ -7195,15 +7485,17 @@ declare function PanelRoot(props: PanelProps): ReactElement;
  *   id: "example",
  *   version: "0.0.1",
  *   name: "Example",
+ *   description: "Shows an example section in a widget panel.",
  * });
  *
  * function CadenceSection() {
  *   const heartbeat = useTelemetry("example.heartbeat");
- *   if (heartbeat.state !== "observed") return null;
+ *   // A held heartbeat is still drawn: `Unit` marks the figure as held.
+ *   if (heartbeat.state !== "observed" && heartbeat.state !== "held") return null;
  *   return (
  *     <Section title="Example">
  *       <Text>
- *         Last beat at UT <Unit value={heartbeat.value.ut} />
+ *         Last beat at UT <Unit value={heartbeat.ut} />
  *       </Text>
  *     </Section>
  *   );
@@ -7221,10 +7513,20 @@ declare function PanelRoot(props: PanelProps): ReactElement;
  *   id: "cadence-badge",
  *   contributes: "space-center-status.badges",
  *   deps: ["example.heartbeat"],
- *   compute: (topics) =>
- *     topics["example.heartbeat"]
- *       ? [{ id: "cadence", label: "Publishing", tone: "info" as const }]
- *       : null,
+ *   // A held heartbeat still draws the badge, carrying its reading so the panel shows it as held.
+ *   compute: (topics) => {
+ *     const heartbeat = topics["example.heartbeat"];
+ *     return heartbeat.state === "observed" || heartbeat.state === "held"
+ *       ? [
+ *           {
+ *             id: "cadence",
+ *             label: "Publishing",
+ *             tone: "info" as const,
+ *             held: heartbeat,
+ *           },
+ *         ]
+ *       : null;
+ *   },
  * });
  * ```
  *
@@ -7255,13 +7557,136 @@ declare const Panel: typeof PanelRoot & {
     Sidebar: typeof PanelSidebar;
 };
 
+/**
+ * One line of a {@link PlotCrosshair} readout.
+ *
+ * @category LineGraph
+ */
+interface PlotCrosshairRow {
+    id: string;
+    label: string;
+    /** The colour of the thing the row reads, so the row ties back to its trace. */
+    color: string;
+    /** The reading, unit included. `null` is an absent sample and is drawn as the null token, never as a number. */
+    value: string | null;
+    /** How current the reading is ("measured", "modelled"), written after the value when there is room. */
+    currency?: string;
+    /** A model's figure: drawn with the kit's modelled mark. */
+    modelled?: boolean;
+    /** Dropped from the compact card of a small plot, where only the figures on the traces fit. */
+    detail?: boolean;
+    /** Where the row's marker stands on the plot, in pixels. Omitted for a row with no point on the plot, such as a limit. */
+    y?: number | null;
+}
+/**
+ * What a {@link PlotCrosshair} draws: where the line stands, the plot it
+ * spans, the instant it names and the rows it reads.
+ *
+ * @category LineGraph
+ */
+interface PlotCrosshairProps {
+    /** Where the line stands, in pixels. */
+    x: number;
+    /** The plot's box, in pixels. The line spans it and the readout stays inside it. */
+    plot: {
+        x0: number;
+        y0: number;
+        x1: number;
+        y1: number;
+    };
+    /** Names the instant, written once above the rows. */
+    heading: string;
+    rows: readonly PlotCrosshairRow[];
+    /**
+     * A column outside the plot where the readout stands, when the chart has
+     * given the card one (see `placePlotReadouts`). The card then sits at the
+     * column's top and names the instant even when compact, and nothing it draws
+     * covers the plot. Omitted, the card is drawn over the plot where it covers no dot.
+     */
+    column?: {
+        x0: number;
+        y0: number;
+        x1: number;
+        y1: number;
+    };
+    /** The traces as drawn, one pixel point per sample with a non-finite `cy` for a hole. Over the plot, the card prefers a corner none of them crosses. */
+    traces?: ReadonlyArray<{
+        cx: readonly number[];
+        cy: readonly number[];
+    }>;
+}
+/**
+ * Whether {@link PlotCrosshair} draws its readout card for these props: the
+ * card fits, and over the plot there is a corner that covers no dot. A chart
+ * that drew a legend in the same place hides it while the card is up, since
+ * each row names its series in its colour.
+ *
+ * @category LineGraph
+ */
+declare function plotCrosshairShowsCard(props: Pick<PlotCrosshairProps, "x" | "plot" | "heading" | "rows" | "column" | "traces">): boolean;
+/**
+ * A crosshair for an SVG plot: a vertical line at an instant, a dot on each
+ * trace where it is read, and a readout of every row's exact value.
+ *
+ * The readout is drawn over the plot at a fixed corner on whichever side of
+ * the line has room, so moving the line never resizes or reflows the chart. A
+ * plot too small for the full card gets a compact one: a swatch, as much of
+ * the label as fits, and the value, so an absent row still says whose it is.
+ * An absent reading is the null token. Place it as the last child of the
+ * plot's `<svg>`; it takes no pointer events, so the plot keeps them.
+ *
+ * @category LineGraph
+ */
+declare function PlotCrosshair({ x, plot, heading, rows: allRows, column, }: PlotCrosshairProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * What {@link placePlotReadouts} reads: the chart's measured size.
+ *
+ * @category LineGraph
+ */
+interface PlotReadoutSpace {
+    /** Width of the whole chart, in CSS pixels. */
+    width: number;
+    /** Height of the whole chart, in CSS pixels. */
+    height: number;
+    /** Width the column's widest line needs to be read whole: a legend chip, a caption, a card row, in CSS pixels. */
+    contentWidth: number;
+}
+/**
+ * Where a chart's reading furniture stands: the crosshair card, the legend and
+ * the limit or target captions.
+ *
+ * `beside` gives them a column to the right of the plot, so none covers a
+ * trace or a dot. `overlay` keeps them inside the plot, drawn only where they
+ * cover no data.
+ *
+ * @category LineGraph
+ */
+type PlotReadoutPlacement = {
+    placement: "overlay";
+} | {
+    placement: "beside";
+    columnWidth: number;
+};
+/**
+ * Where the kit puts a chart's card, legend and captions, decided from
+ * measured space. A chart with room gives them a column beside the plot, as
+ * wide as its widest line needs so nothing is cut; one that cannot spare that
+ * width, or is smaller, keeps them over the plot.
+ *
+ * @category LineGraph
+ */
+declare function placePlotReadouts({ width, height, contentWidth, }: PlotReadoutSpace): PlotReadoutPlacement;
+
 /**
  * One frame a {@link ReadFrameControl} can offer, and what an operator calls it.
  *
  * @category Form
  */
 interface ReadFrameOption {
+    /** The frame this option selects. */
     choice: ReadFrameChoice;
+    /** The option's text in the list, as the operator reads it. */
     label: string;
 }
 /**
@@ -7272,16 +7697,23 @@ interface ReadFrameOption {
 interface ReadFrameControlProps {
     /** Put on the `<select>`, so `label` (as `htmlFor`) names it. */
     id: string;
+    /** The control's visible label, such as "Frame". */
     label: string;
     /** The widget's current read frame. Shown as a blank, disabled placeholder when it matches nothing on `options`, e.g. before the widget's catalogue has arrived. */
     value: ReadFrameChoice;
+    /** The frames offered, in the order listed. */
     options: readonly ReadFrameOption[];
+    /** Called with the frame the operator picked. */
     onChange: (choice: ReadFrameChoice) => void;
+    /** A line of help under the control. Omit for none. */
     hint?: string;
 }
 /**
  * The control a frame-dependent widget picks its read frame with: a labelled,
- * keyboard-operable `<select>` over `options`, with an optional hint below.
+ * keyboard-operable `<select>` over `options`, with an optional hint below. A
+ * read frame is the frame of reference a widget draws positions in, such as
+ * centred on a body; it changes only the drawing. The Control Frame is the
+ * frame the game itself is set to, reported on the `system.frame` Topic.
  * The selected option is found by frame equality with `value`
  * (`readFrameChoicesEqual` from `@ksp-gonogo/sitrep-sdk/frames`), so options
  * need no ids of their own.
@@ -7301,7 +7733,8 @@ declare function ReadFrameControl({ id, label, value, options, onChange, hint, }
  * A quantity, or the whole `Reading` it arrived in, goes through {@link Unit},
  * so a held reading keeps its held mark. Not a bare number, which has lost the
  * unit that says how to write it: hand over `value("m", 1)`,
- * `value("count", 3)`, or `value("1", x)` for a dimensionless reading.
+ * `value("count", 3)`, or `value("1", x)` for a dimensionless reading (`"1"`
+ * is the unit of a plain ratio or factor).
  *
  * @category Form
  */
@@ -7316,7 +7749,9 @@ interface ReadOnlyFieldProps {
     label: ReactNode;
     /** Why it matters, or where it comes from. Announced with the label. */
     description?: ReactNode;
+    /** The value shown. See {@link ReadOnlyFieldValue} for what it can be. */
     value: ReadOnlyFieldValue;
+    /** A class for the outer element, so a styled-component can extend it. */
     className?: string;
 }
 /**
@@ -7337,11 +7772,27 @@ declare function ReadOnlyField({ label, description, value, className, }: ReadOn
  * @category Readout
  */
 type ReadoutSize = "hero" | "inline";
+/**
+ * Props for {@link Readout}. Any other `div` attribute passes through.
+ *
+ * @category Readout
+ */
+interface ReadoutProps extends ComponentPropsWithoutRef<"div"> {
+    /** Where it sits: `hero` fills the remaining panel space, `inline` sits beside other content. Defaults to `inline`. */
+    size?: ReadoutSize;
+    /**
+     * Colours the figure with a {@link Tone}: `go`, `caution`, `warn` or `nogo`
+     * for a state from best to worst, `offline` for data that is gone, `info` for
+     * a note and `neutral` for a figure with no verdict. Defaults to `neutral`.
+     * Set it from the state the figure reports, never for decoration.
+     */
+    tone?: Tone;
+}
 /**
  * The display-tier figure: bold, tracked, coloured by tone.
  *
- * `size="hero"` is the dominant value of a widget's tiny form (ΔV, time to
- * impact, warp rate): it fills the remaining panel space and centres. The
+ * `size="hero"` is the dominant value of a widget's tiny form (see
+ * {@link TinyEssentials}; ΔV, time to impact and warp rate are examples): it fills the remaining panel space and centres. The
  * default `size="inline"` is the same treatment smaller, sitting beside other
  * content.
  *
@@ -7352,15 +7803,11 @@ type ReadoutSize = "hero" | "inline";
  * Figures that stand on their own: the bold display readout, a labelled stat, a
  * data line, and the stats contributed to a widget.
  */
-declare function Readout({ size, tone, ...rest }: ComponentPropsWithoutRef<"div"> & {
-    /** Where it sits. Defaults to `inline`. */
-    size?: ReadoutSize;
-    /** Colour-codes the figure for state-driven widgets. Defaults to `neutral`. */
-    tone?: Tone;
-}): react_jsx_runtime.JSX.Element;
+declare function Readout({ size, tone, ...rest }: ReadoutProps): react_jsx_runtime.JSX.Element;
 /**
  * Muted uppercase secondary line for a {@link Readout}
- * (e.g. a mode tag).
+ * (e.g. a mode tag), placed inside it after the figure. It renders a `span` and
+ * takes every prop that element does.
  *
  * @category Readout
  */
@@ -7403,6 +7850,7 @@ interface RowProps extends HTMLAttributes<HTMLElement> {
      * one level of nesting.
      */
     nested?: boolean;
+    /** The row's content: its label and value, or whatever the row lays out. */
     children?: ReactNode;
 }
 /**
@@ -7540,7 +7988,9 @@ declare function resourceColor(name: string): string;
  * @category Form
  */
 interface SearchBoxProps extends Omit<InputHTMLAttributes<HTMLInputElement>, "type" | "value" | "onChange"> {
+    /** The text in the box. */
     value: string;
+    /** Called with the new text on each keystroke, and with `""` when cleared. */
     onChange: (next: string) => void;
     /** The clear control's accessible name. Defaults to "Clear search". */
     clearLabel?: string;
@@ -7595,18 +8045,34 @@ interface SelectableRowProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement
  *
  * @example
  * ```tsx
- * <Stack gap="rows">
- *   {servos.map((s) => (
- *     <SelectableRow
- *       key={s.id}
- *       selected={s.id === selectedId}
- *       onClick={() => select(s.id)}
- *     >
- *       <span>{s.name}</span>
- *       <Text level="muted" size="xs">{s.group}</Text>
- *     </SelectableRow>
- *   ))}
- * </Stack>
+ * import { SelectableRow, Stack, Text } from "@ksp-gonogo/ui-kit";
+ *
+ * interface Servo {
+ *   id: string;
+ *   name: string;
+ *   group: string;
+ * }
+ *
+ * function ServoList(props: {
+ *   servos: readonly Servo[];
+ *   selectedId: string | null;
+ *   select: (id: string) => void;
+ * }) {
+ *   return (
+ *     <Stack gap="rows">
+ *       {props.servos.map((s) => (
+ *         <SelectableRow
+ *           key={s.id}
+ *           selected={s.id === props.selectedId}
+ *           onClick={() => props.select(s.id)}
+ *         >
+ *           <span>{s.name}</span>
+ *           <Text level="muted" size="xs">{s.group}</Text>
+ *         </SelectableRow>
+ *       ))}
+ *     </Stack>
+ *   );
+ * }
  * ```
  *
  * @category FilterList
@@ -7643,7 +8109,7 @@ interface SpinnerProps extends Omit<HTMLAttributes<HTMLSpanElement>, "color" | "
     /** Active arc colour. Defaults to the accent foreground. */
     color?: string;
     /** Accessible name for screen readers. Defaults to "Loading". */
-    ariaLabel?: string;
+    "aria-label"?: string;
 }
 /**
  * A small inline pending indicator: a ring with a coloured arc, sized to sit
@@ -7653,7 +8119,7 @@ interface SpinnerProps extends Omit<HTMLAttributes<HTMLSpanElement>, "color" | "
  *
  * @category EmptyState
  */
-declare function Spinner({ size, thickness, color, ariaLabel, ...rest }: Readonly<SpinnerProps>): react_jsx_runtime.JSX.Element;
+declare function Spinner({ size, thickness, color, "aria-label": ariaLabel, ...rest }: Readonly<SpinnerProps>): react_jsx_runtime.JSX.Element;
 
 /**
  * Props for {@link Stack}. Any other `div` attribute passes through.
@@ -7676,12 +8142,15 @@ interface StackProps extends HTMLAttributes<HTMLDivElement> {
      * rather than growing the whole column.
      */
     fill?: boolean;
+    /** The items, laid out top to bottom. */
     children?: ReactNode;
 }
 /**
  * A vertical flex column, the most common container shape in a widget body.
  * Children sit one above the other with the container's related gap between
- * them unless `gap` names another.
+ * them unless `gap` names another. A row that spans the container is a
+ * {@link Cluster}; a compact run of badges or buttons that sits within a line is
+ * an {@link Inline}.
  *
  * The layout primitives compose: a {@link Stack} of sections, a
  * {@link Cluster} for a label beside its controls, a {@link Grid} for a
@@ -7743,11 +8212,11 @@ interface StatProps extends Omit<HTMLAttributes<HTMLDListElement>, "title"> {
     tone?: Tone;
 }
 /**
- * One cell of a core-stat strip (a {@link Grid} of `minColWidth="7rem" fit align="stretch"`): a label, a figure, and at most one line under
+ * One cell of a stat strip, the row of key figures a widget keeps at the top of its body: a label, a figure, and at most one line under
  * it. A `<dl>` per cell, so the label is associated with the figure
  * programmatically and a cell stays valid wherever it is dropped.
  *
- * A strip of stats is a `Grid` with `minColWidth="7rem" fit align="stretch"
+ * The strip is a {@link Grid} with `minColWidth="7rem" fit align="stretch"
  * gap="related-compact"`, so every stat gets the same room and the row reflows
  * to fewer columns as the tile narrows. The strip is not a live region: add
  * `role="status"` yourself only when its figures change rarely, since figures
@@ -7787,7 +8256,8 @@ interface StatContributionsProps {
  * A fragment, not a wrapper: the cells land in the host's own `Grid` of stats
  * as siblings of its built-in ones. Renders nothing when
  * nothing is contributed, so a host can place it unconditionally. An entry's
- * quantity is drawn through {@link Unit}, else its text, else the null token.
+ * quantity is drawn through {@link Unit}, else its text, else the null token;
+ * a held figure is drawn with the held mark either way.
  *
  * @example
  * ```tsx
@@ -7950,12 +8420,14 @@ interface SubjectHeadingProps {
  *
  * @example
  * ```tsx
+ * import { Badge, SubjectHeading, Text } from "@ksp-gonogo/ui-kit";
+ *
  * <SubjectHeading
  *   status={
  *     <Badge tone="go">Active</Badge>
  *   }
  * >
- *   <Text weight="semibold">{program.title}</Text>
+ *   <Text weight="semibold">Kerbin Science Program</Text>
  * </SubjectHeading>
  * ```
  *
@@ -7963,8 +8435,15 @@ interface SubjectHeadingProps {
  */
 declare function SubjectHeading({ children, status, gap, align, }: Readonly<SubjectHeadingProps>): react_jsx_runtime.JSX.Element;
 
+/**
+ * The props every {@link Switch} takes.
+ *
+ * @category Form
+ */
 interface SwitchBaseProps {
+    /** Whether the switch is on. The switch is controlled: it shows this value and changes only when the caller changes it. */
     checked: boolean;
+    /** Called with the new state when the operator flips the switch. */
     onChange: (value: boolean) => void;
     /** Renders dimmed and non-interactive; `onChange` never fires. For a toggle whose effective state is controlled elsewhere, such as a sub-setting inert while its parent setting is off. */
     disabled?: boolean;
@@ -7980,16 +8459,19 @@ interface SwitchBaseProps {
  * @category Form
  */
 type SwitchProps = SwitchBaseProps & ({
+    /** The visible name, drawn beside the track. Give this or `aria-label`, never both. */
     label: string;
     "aria-label"?: never;
 } | {
     label?: never;
+    /** The accessible name, for a switch whose row already shows its label text. Give this or `label`, never both. */
     "aria-label": string;
 });
 /**
- * An on/off toggle for a setting that takes effect at once: a native checkbox
- * drawn as a sliding track, keyboard-operable with Space and with the focus
- * ring drawn on the track.
+ * An on/off toggle for one setting, which takes effect as it is flipped; inside
+ * a form with a save bar the change waits for Save like any other field. It is
+ * a native checkbox drawn as a sliding track, keyboard-operable with Space and
+ * with the focus ring drawn on the track.
  *
  * @category Form
  */
@@ -8179,7 +8661,8 @@ interface PanelStatusStore {
 /**
  * Creates one {@link PanelStatusStore} and provides it for as long as it is
  * mounted, so the widget body and the tile's chrome share it. The dashboard
- * mounts one per tile.
+ * mounts one per tile, so a widget does not mount this itself; it is for a
+ * test or a harness that renders a {@link Panel} outside the dashboard.
  *
  * @category Panel
  */
@@ -8188,6 +8671,8 @@ declare const PanelStatusStoreProvider: (props: {
 }) => react.ReactNode;
 /**
  * The nearest {@link PanelStatusStore}, or `null` outside a dashboard tile.
+ * {@link Badge}'s `report` and {@link Panel} read it for you, so a widget
+ * rarely calls this directly.
  *
  * @category Panel
  */
@@ -8199,7 +8684,9 @@ declare const usePanelStatusStore: () => PanelStatusStore | null;
  *
  * - `"held"`: HELD
  * - `"disconnected"`: OFFLINE
- * - `"last-before-blackout"`: BLACKOUT
+ * - `"last-before-blackout"`: BLACKOUT, the last value sent before a known
+ *   loss of signal (a blackout is a stretch when the craft's signal cannot
+ *   reach the command centre)
  * - `"recorded"`: RECORDED
  * - `"loading"`: LOADING
  * - `"no-game"`: NO GAME
@@ -8267,7 +8754,12 @@ declare function useStatusSummary(): StatusSummary | null;
  * @category Tabs
  */
 interface TabDescriptor {
-    /** Stable identity for the tab. Falls back to the tab's position in the array. */
+    /**
+     * Stable identity for the tab, the value `activeId` and `onChange` carry.
+     * Falls back to `tab-` and the tab's position in the array (`tab-0`), which
+     * moves if the tabs are reordered, so give every tab an `id` when the
+     * selection is controlled.
+     */
     id?: string;
     /** The tab's name in the strip, and its panel's accessible name. */
     label: string;
@@ -8318,27 +8810,29 @@ interface TabsProps {
  */
 declare const TABS_PANEL_MIN_WIDTH = 240;
 /**
- * True when a container `containerWidth` pixels wide fits `panelCount` panels side by side at {@link TABS_PANEL_MIN_WIDTH} each, with the gaps between them. Always false for fewer than two panels.
+ * True when a container `containerWidth` pixels wide fits `panelCount` panels side by side at {@link TABS_PANEL_MIN_WIDTH} each, with an 8px gap between neighbours: two panels need 2 × 240 + 8 = 488px. Always false for fewer than two panels.
  *
  * @category Tabs
  */
 declare function shouldExpandTabs(containerWidth: number, panelCount: number): boolean;
 /**
- * A tab strip with one panel shown below it, following the APG tabs pattern:
+ * A tab strip with one panel shown below it, following the
+ * [WAI-ARIA Authoring Practices (APG) tabs pattern](https://www.w3.org/WAI/ARIA/apg/patterns/tabs/):
  * arrow keys move between tabs, Home and End jump to the ends, and disabled
  * tabs are skipped. The strip tightens its spacing, then scrolls, when the
  * labels do not fit. With `expandWhenRoomy`, a container wide enough for every
  * enabled tab drops the strip and shows each panel side by side under its own
- * heading.
+ * `h3` heading.
  *
  * @example
  * ```tsx
+ * // Side by side when the tile is wide enough for both, tabs otherwise.
  * <Tabs
  *   aria-label="Vessel systems"
+ *   expandWhenRoomy
  *   tabs={[
  *     { id: "power", label: "Power", content: <PowerView /> },
- *     { id: "comms", label: "Comms", content: <CommsView />, indicator: commsAlarm },
- *     { id: "target", label: "Target", content: <TargetView />, disabled: !hasTarget },
+ *     { id: "comms", label: "Comms", content: <CommsView /> },
  *   ]}
  * />
  * ```
@@ -8376,7 +8870,7 @@ interface TapeMarker<Unit extends string = string> {
     color?: string;
     /** Names the marker in the meter's spoken value. Never drawn, so a marker never competes with the scale for room. */
     label?: string;
-    /** The model's interval around `value`, drawn as the same two bounds a {@link Meter} draws. */
+    /** The low and high ends of an {@link UncertaintyBand} around `value`, drawn as the same two ticks a {@link Meter} draws. */
     bounds?: {
         lo: Value<Unit>;
         hi: Value<Unit>;
@@ -8435,7 +8929,7 @@ interface TapeProps<Unit extends string = string> {
      */
     format?: FormatsFor<Unit>;
     /** Accessible label naming what the scale measures (e.g. "Altitude above terrain"). */
-    ariaLabel: string;
+    "aria-label": string;
 }
 /**
  * A vertical linear scale with a moving pointer, the altimeter or airspeed
@@ -8453,7 +8947,7 @@ interface TapeProps<Unit extends string = string> {
  *
  * @category Gauge
  */
-declare function Tape<Unit extends string = string>({ labelSide, value, min, max, width, height, fillHeight, tickStep, zones, markers, groundLine, seaLevel, format, ariaLabel, }: Readonly<TapeProps<Unit>>): react_jsx_runtime.JSX.Element;
+declare function Tape<Unit extends string = string>({ labelSide, value, min, max, width, height, fillHeight, tickStep, zones, markers, groundLine, seaLevel, format, "aria-label": ariaLabel, }: Readonly<TapeProps<Unit>>): react_jsx_runtime.JSX.Element;
 
 /**
  * How far plain text recedes: `muted` for secondary text, `faint` the quietest
@@ -8508,8 +9002,9 @@ interface TextProps extends HTMLAttributes<HTMLSpanElement> {
 }
 /**
  * Inline style declarations that recede every neutral word inside a box to the
- * faint text level, which still meets WCAG AA contrast on a panel. Use it to
- * quiet a block of words; opacity would drop them below contrast, so keep
+ * faint text level, which still meets WCAG AA contrast on a panel. It sets `color` and the
+ * neutral, primary, muted and dim text variables to that faint colour, so
+ * nested kit text recedes with it. Use it to quiet a block of words; opacity would drop them below contrast, so keep
  * opacity for marks that carry no text. A word in a tone keeps its tone. The
  * same declarations as {@link faintText}, for a `style` prop.
  *
@@ -8517,8 +9012,8 @@ interface TextProps extends HTMLAttributes<HTMLSpanElement> {
  */
 declare const FAINT_TEXT_STYLE: Readonly<Record<string, string>>;
 /**
- * {@link FAINT_TEXT_STYLE} as a CSS declaration string, for a styled-components
- * rule.
+ * The same declarations as {@link FAINT_TEXT_STYLE}, written as
+ * `property: value;` lines for a styled-components rule.
  *
  * @category Typography
  */
@@ -8534,12 +9029,20 @@ declare function faintText(): string;
  *
  * @example
  * ```tsx
- * <Cluster>
- *   <Text level="muted" size="xs">Altitude</Text>
- *   <Text tone="go" weight="semibold">
- *     <Unit value={altitude} />
- *   </Text>
- * </Cluster>
+ * import { useTelemetry } from "@ksp-gonogo/sitrep-sdk";
+ * import { Cluster, Text, Unit } from "@ksp-gonogo/ui-kit";
+ *
+ * function AltitudeLine() {
+ *   const flight = useTelemetry("vessel.flight");
+ *   return (
+ *     <Cluster>
+ *       <Text level="muted" size="xs">Altitude</Text>
+ *       <Text weight="semibold">
+ *         <Unit value={flight.altitudeAsl} />
+ *       </Text>
+ *     </Cluster>
+ *   );
+ * }
  * ```
  *
  * @category Typography
@@ -8656,7 +9159,7 @@ declare function gridFloor(def: Pick<ComponentDefinition, "tiny" | "minSize">):
 } | undefined;
 
 /**
- * The fill an active {@link ToggleButton} takes: `go`, or `nogo` / `warn` when
+ * The fill a pressed {@link ToggleButton} takes: `go`, or `nogo` / `warn` when
  * being on is destructive or needs attention.
  *
  * @category Button
@@ -8675,16 +9178,16 @@ type ToggleButtonSize = "sm" | "md";
  */
 interface ToggleButtonProps extends ButtonHTMLAttributes<HTMLButtonElement> {
     /** Whether the toggle is on. Drives `aria-pressed` and the filled look. Defaults to `false`. */
-    active?: boolean;
-    /** The fill while active. Defaults to `go`. */
+    pressed?: boolean;
+    /** The fill while pressed. Defaults to `go`. */
     tone?: ToggleButtonTone;
     /** Defaults to `md`. */
     size?: ToggleButtonSize;
 }
 /**
- * A two-state toggle: a real `<button>` whose `aria-pressed` follows `active`,
+ * A two-state toggle: a real `<button>` whose `aria-pressed` follows `pressed`,
  * for controls that switch between on and off (mode pickers, filter toggles,
- * rate pickers). It draws as a {@link Button}, filled in `tone` while active
+ * rate pickers). It draws as a {@link Button}, filled in `tone` while pressed
  * and plain while not.
  *
  * ToggleButton or {@link Switch}? They are different ARIA patterns:
@@ -8700,18 +9203,29 @@ interface ToggleButtonProps extends ButtonHTMLAttributes<HTMLButtonElement> {
  *
  * @example
  * ```tsx
- * <Inline>
- *   {RATES.map((rate) => (
- *     <ToggleButton
- *       key={rate}
- *       size="sm"
- *       active={rate === current}
- *       onClick={() => setRate(rate)}
- *     >
- *       {rate}x
- *     </ToggleButton>
- *   ))}
- * </Inline>
+ * import { Inline, ToggleButton } from "@ksp-gonogo/ui-kit";
+ *
+ * const RATES = [1, 2, 3, 4] as const;
+ *
+ * function RatePicker(props: {
+ *   current: number;
+ *   setRate: (rate: number) => void;
+ * }) {
+ *   return (
+ *     <Inline>
+ *       {RATES.map((rate) => (
+ *         <ToggleButton
+ *           key={rate}
+ *           size="sm"
+ *           pressed={rate === props.current}
+ *           onClick={() => props.setRate(rate)}
+ *         >
+ *           {rate}x
+ *         </ToggleButton>
+ *       ))}
+ *     </Inline>
+ *   );
+ * }
  * ```
  *
  * @category Button
@@ -8827,9 +9341,13 @@ interface TooltipProps {
 declare function Tooltip({ text, children, focusable, announce, }: TooltipProps): react_jsx_runtime.JSX.Element;
 
 /**
- * An orbit path that may not be drawn, and the reason: no horizon was stated
- * for it, the instant on screen is past its horizon, its shape was not stated,
- * the frame asked for cannot be built, or it could not be sampled. It is the
+ * An orbit path that may not be drawn, and the reason. An orbit's elements are
+ * the numbers that define its curve, and its horizon is how far ahead in game
+ * time they can be trusted. The path is withheld when no horizon was stated for
+ * it, the instant on screen is past its horizon, its shape (a conic drawn from
+ * the elements, or an arc sampled by the provider) was not stated, the frame
+ * asked for cannot be built (a body not yet received, say), or it could not be
+ * sampled. It is the
  * `withheld` member of `OrbitTrajectory`, which `useOrbitTrajectory` from
  * `@ksp-gonogo/sitrep-sdk/frames` returns.
  *
@@ -8966,6 +9484,7 @@ interface UnitInputProps<Unit extends string = string> {
     range?: SlidableRange<Unit>;
     /** Supplying a notch size adds a rate wheel beside the field. See {@link RateControl}. */
     rate?: RateControl;
+    /** Greys the field, and any slider or wheel, out and ignores input. */
     disabled?: boolean;
 }
 /**
@@ -9075,6 +9594,7 @@ type UnitPinsByGroup = {
 };
 /** What every spelling of the props below shares. */
 interface UnitSharedFormatBaseProps {
+    /** The tree whose figures share the format. */
     children?: ReactNode;
     /**
      * Widen the digit count until the members stop printing the same figure as each other. What an interval wants (6 700 km and 6 710 km both print `6.7 Mm` otherwise) and a column does not. Applies to the whole scope.
@@ -9382,6 +9902,7 @@ interface WidgetMetaContextValue {
  * `null` outside one. The dashboard provides it for every widget; a test
  * rendering a widget bare provides it to get the widget's slots working.
  *
+ * @intent Published so a test or a host of its own can give a widget the identity and slots the dashboard provides.
  * @category Extensions
  */
 declare const WidgetMetaContext: react.Context<WidgetMetaContextValue | null>;
@@ -9482,34 +10003,53 @@ declare function useWidgetScope<Widget extends string>(componentId: Widget): Wid
 interface WidgetTopicDeclaration {
     channels?: readonly string[];
     optionalChannels?: readonly string[];
+    channelFamilies?: readonly string[];
+    optionalChannelFamilies?: readonly string[];
+    channelsFromConfig?: (config: never) => readonly string[];
     fields?: readonly string[];
     dataRequirements?: readonly string[];
 }
 /**
- * Every channel a widget declares it mounts on: its `channels`,
- * `optionalChannels` and `dataRequirements` joined, without duplicates. The
- * dashboard derives a widget's blackout badge from these. Empty for an
- * undefined definition.
+ * Every concrete channel a widget declares it mounts on: its `channels`,
+ * `optionalChannels` and `dataRequirements` joined, plus the Topics its
+ * `channelsFromConfig` names for `config`, without duplicates. The dashboard
+ * derives a widget's blackout badge from these. Empty for an undefined
+ * definition.
+ *
+ * Families (`channelFamilies`, `optionalChannelFamilies`) are left out on
+ * purpose: blackout is per craft and a family has no single craft, so see
+ * {@link widgetDrawnFamilies} for them.
  *
  * @category Extensions
  */
-declare function widgetDeclaredTopics(def: WidgetTopicDeclaration | undefined): readonly string[];
+declare function widgetDeclaredTopics(def: WidgetTopicDeclaration | undefined, config?: unknown): readonly string[];
 /**
  * Every field a widget declares it draws, as opposed to the channels it needs
  * live to render at all: its `fields` without duplicates, or, when it
- * declares none, its {@link widgetDeclaredTopics}. The dashboard matches alarms
- * to widgets against this list.
+ * declares none, its {@link widgetDeclaredTopics}. Topics from
+ * `channelsFromConfig` are always included. The dashboard matches alarms to
+ * widgets against this list.
  *
  * @category Extensions
  */
-declare function widgetDrawnFields(def: WidgetTopicDeclaration | undefined): readonly string[];
+declare function widgetDrawnFields(def: WidgetTopicDeclaration | undefined, config?: unknown): readonly string[];
+/**
+ * Every family of runtime-built Topic ids a widget declares, required and
+ * optional joined, without duplicates, such as `"fleet.<vessel>.contact"`. The
+ * dashboard matches alarms against these with `topicMatchesFamily`.
+ *
+ * @category Extensions
+ */
+declare function widgetDrawnFamilies(def: WidgetTopicDeclaration | undefined): readonly string[];
 
 /**
  * How much room a widget tile has, derived from its `w` and `h` grid units by
  * {@link getSizeBucket} so every widget uses the same boundaries.
  *
- * - `tiny`: a single-glance status or one key readout
- * - `small`: essential numbers, minimal chrome
+ * - `tiny`: a single-glance status or one key readout; under 5 columns wide or
+ *   4 rows tall
+ * - `small`: essential numbers, minimal chrome; under 8 columns wide or 7 rows
+ *   tall
  * - `normal`: the full widget UI
  *
  * A widget that declares a tiny mode is drawn by the kit in `tiny`; every other
@@ -9526,12 +10066,14 @@ type SizeBucket = "tiny" | "small" | "normal";
  * @category Layout
  */
 declare const TINY_BELOW: {
+    /** Width in grid columns: a tile under 5 columns wide is `tiny`. */
     readonly w: 5;
+    /** Height in grid rows: a tile under 4 rows tall is `tiny`. */
     readonly h: 4;
 };
 /**
  * The {@link SizeBucket} a `w` by `h` tile falls in: `tiny` below
- * {@link TINY_BELOW} on either axis, `small` below 8 wide or 7 tall, `normal`
+ * {@link TINY_BELOW} on either axis, `small` below 8 columns wide or 7 rows tall, `normal`
  * otherwise. Returns `normal` while either dimension is `undefined`.
  *
  * This is the bucket by size alone, for a widget arranging its own body.
@@ -9562,6 +10104,7 @@ type WidgetShape = "portrait" | "landscape" | "square";
  * @category Layout
  */
 interface WidgetShapeInfo {
+    /** Whether the tile is tall, wide or roughly square. */
     shape: WidgetShape;
     /**
      * Raw grid aspect ratio, `w / h`. > 1 is wider-than-tall, < 1 is
@@ -9581,4 +10124,71 @@ interface WidgetShapeInfo {
  */
 declare function getWidgetShape(w: number | undefined, h: number | undefined): WidgetShapeInfo;
 
-export { ARM_TIMEOUT_MS, ActionMenu, type ActionMenuItem, type ActionMenuProps, type AnchorPoint, type AnchoredPosition, AntiNormalIcon, AntiTargetIcon, type AnyAugment, ArrowDownIcon, ArrowLeftIcon, ArrowRightIcon, ArrowUpIcon, type AudioCaptureSupport, type AudioCaptureUnsupportedReason, type AudioInputControls, type AudioInputDevice, type AudioInputFailure, AudioInputPicker, type AudioInputPickerProps, type AudioInputState, type AudioInputStatus, type AugmentSegmentProps, type AugmentSegmentRegistry, type AugmentSettingsContextValue, AugmentSettingsPanel, type AugmentSettingsPanelProps, AugmentSettingsProvider, AugmentSlot, AutoEmptyState, type AutoEmptyStateProps, Badge, type BadgeFace, type BadgeProps, type BadgeSize, Band, type BandProps, BellIcon, BinormalIcon, Block, type BlockProps, type BlockTitleRowProps, Box, type BoxPad, type BoxProps, type BoxRadius, type BoxSurface, BroadcastIcon, Button, ButtonGroup, type ButtonGroupProps, type ButtonProps, type ButtonSize, type ButtonTone, type ButtonVariant, Card, type CardProps, CheckIcon, ChevronDownIcon, ChevronLeftIcon, ChevronRightIcon, ChevronUpIcon, CloseIcon, Cluster, type ClusterAlign, type ClusterJustify, type ClusterProps, ComboboxListbox, type ComboboxListboxProps, type ComboboxOption, CommandButton, type CommandButtonHandle, type CommandButtonPhase, type CommandButtonProps, type CommandButtonSize, type CommandButtonState, type CommandButtonTone, CommandDelay, type CommandDelayHandle, type CommandDelayProps, type CommandFailedEntry, type CommandFailedLike, type CommandFoundEntry, type CommandFoundLike, type CommandGateLike, CommandGroup, type CommandGroupProps, type CommandHandle, CommandList, type CommandListKind, type CommandListProps, type CommandLossEntry, type CommandLossLike, type CommandOutcomes, type CommandRefusalEntry, type CommandRefusalLike, type CommandReplyLike, type CommandUndeliveredEntry, type CommandUndeliveredLike, ComposerBar, type ComposerBarProps, ComputerIcon, ConfigForm, Console, type ConsoleProps, type ConsoleTone, ContainerBreak, type ContainerBreakProps, type ContributionSlotEntry, ContributionsPanelStore, ContributionsProvider, ControlDelayStream, type ControlDelayStreamProps, type ControlDelayStreamVariant, type ControlRibbonDatum, type ControlStreamDatum, type ControlStreamSample, Countdown, type CountdownProps, DataKeyPicker, type DataKeyPickerProps, DataLine, type DataLineProps, DataTable, type DataTableColumn, type DataTableProps, type DataTableSection, DatabaseIcon, DefaultThemeProvider, DelayRailContext, DelayRailProvider, DiagnosticsIcon, Dial, type DialProps, type DialTick, type DialZone, Disclosure, type DisclosureProps, DivergingBar, type DivergingBarProps, Divider, type DividerProps, DomainAvailabilityContext, DomainAvailabilityProvider, type DomainAvailabilityStore, type DrawnPrecision, type ElementSize, EmptyState, type EmptyStateLayout, type EmptyStateProps, type EphemerisFigure, ExpandableText, type ExpandableTextProps, FAINT_TEXT_STYLE, FRAMEWORK_AUGMENT_SEGMENTS, FRAMEWORK_CONTRIBUTION_SEGMENTS, Field, FieldHint, FieldLabel, FieldRow, Fill, type FillProps, type FillQuantity, FilterChip, type FilterChipProps, FilterList, type FilterListProps, FilterRegion, type FilterRegionProps, type FilterRow, FitLabelButton, type FitLabelButtonProps, Floating, type FloatingProps, FormActions, FormatsFor, FormatsForKind, FramedDisplay, type FramedDisplayProps, FrenetNormalIcon, FullHeightIcon, FullWidthIcon, FullscreenEnterIcon, FullscreenExitIcon, type GapToken, GraphNotice, type GraphNoticePlacement, type GraphNoticeProps, type GraphNoticeSpace, Grid, type GridAlign, type GridProps, HalfHeightIcon, HalfWidthIcon, HeartIcon, HeldBadge, type HeldBadgeProps, HeldFigure, type HeldFigureProps, HistoryIcon, HomeIcon, HoverCard, type HoverCardProps, INTERVAL_DASH, IconButton, type IconProps, InFlightFace, type InFlightFaceProps, InFlightList, type InFlightListDensity, type InFlightListItem, type InFlightListMode, type InFlightListProps, InfoIcon, Inline, type InlineProps, Input, type InsetToken, InstrumentHeldMark, JogWheel, type JogWheelProps, JoystickIcon, type KeyOption, KindOfGroup, LayersIcon, LevelBars, type LevelBarsProps, LineGraph, type LineGraphProps, type LineGraphSeries, type LineGraphThreshold, type LineGraphThresholdStyle, LiveRegion, type LiveRegionProps, LockIcon, LockMark, type LockMarkProps, LockScope, type LockScopeProps, type LockSummary, MARKER_ICONS, MARKER_IDS, ManeuverIcon, type MarkKind, type MarkerIconProps, type MarkerId, Meter, type MeterLayout, type MeterProps, MeterRowGroup, MeterStack, MicroscopeIcon, MissionDate, MissionDateField, type MissionDateFieldProps, type MissionDateParts, type MissionDateProps, ModalChromeContext, type ModalChromeValue, ModalProvider, type ModalSaveBarOptions, ModelledAlongside, type ModelledFigureAlongsideProps, type ModelledQuantityAlongsideProps, MutedIcon, NULL_DISPLAY, NormalIcon, Notice, type NoticeProps, NullValue, type PaintReckoningMarkOptions, type PaintVesselMarkOptions, Panel, type PanelAsideSize, type PanelBadge, PanelBadgesProvider, type PanelInactiveReason, type PanelProps, type PanelSidebarSide, type PanelSplitProps, type PanelStatusStore, PanelStatusStoreProvider, type PanelTitleProps, ParallelMinusIcon, ParallelPlusIcon, PauseIcon, PencilIcon, PlayIcon, PlusIcon, PresentableAs, PresentableAsKind, ProgradeIcon, PushUpIcon, RECKONING_MARK, RETIRED_SLOT_IDS, RadialInIcon, RadialOutIcon, type RailEntry, type RailFailed, type RailFound, type RailLoss, type RailRefusal, type RailUndelivered, type RateControl, ReadFrameControl, type ReadFrameControlProps, type ReadFrameOption, ReadOnlyField, type ReadOnlyFieldProps, type ReadOnlyFieldValue, Readout, ReadoutCaption, type ReadoutSize, RecallIcon, type ReckonedPosition, ReckonedUnit, type ReckoningKind, ReckoningMark, ReckoningMarkSvg, type ReckoningMarking, RelativeMinusIcon, RelativePlusIcon, type Resolved, RetrogradeIcon, Row, type RowFilter, RowName, type RowProps, STREAM_MIN_DELAY_SECONDS, SatelliteIcon, ScrollArea, SearchBox, type SearchBoxProps, Section, type SectionProps, SectionTitle, Select, SelectableRow, type SelectableRowProps, SendIcon, SettingsIcon, type Severity, type SharedFormat, SignalDelayBadge, type SignalDelayBadgeProps, type SizeBucket, type SlidableRange, Slider, type SliderProps, SpeakerIcon, Spinner, type SpinnerProps, Stack, type StackProps, StarIcon, Stat, StatContributions, type StatContributionsProps, type StatProps, type StaticElement, type StatusBreakdownEntry, type StatusContribution, StatusIndicator, type StatusIndicatorProps, type StatusSummary, Stepper, type StepperProps, StopIcon, StreamStatusBadge, type StreamStatusBadgeProps, SubjectHeading, type SubjectHeadingProps, Switch, type SwitchProps, TABS_PANEL_MIN_WIDTH, TINY_BELOW, TONE_LABEL, TONE_MARK, TONE_ON_STATUS, TONE_STATUS, TONE_TEXT, type TabDescriptor, Tabs, type TabsProps, TangentIcon, Tape, type TapeMarker, type TapeProps, type TapeZone, TargetIcon, Text, TextButton, TextField, type TextFieldProps, type TextLevel, type TextProps, type TextSize, type TextWeight, Textarea, type ThemeBorders, type ThemeColors, type ThemeTypography, type TimeContext, TinyEssentials, type TinyEssentialsProps, ToggleButton, type ToggleButtonProps, type ToggleButtonSize, type ToggleButtonTone, Tooltip, type TooltipAnchorProps, type TooltipProps, TrajectoryWithheldNote, Truncate, type UiKitTheme, Unit, UnitGroupKey, type UnitGroupPins, UnitInput, type UnitInputProps, type UnitPins, type UnitPinsByGroup, type UnitProps, UnitSharedFormat, type UnitSharedFormatMixedProps, type UnitSharedFormatProps, type UnitValue, type UseAudioInputOptions, type UseCommandButtonOptions, type UseRowFilterOptions, type UseTooltipResult, VESSEL_MARK, type VesselMarkState, VesselMarkSvg, type VesselMarkSvgProps, type VesselPositions, VisuallyHidden, WAVE_HALF_H, WAVE_MID_Y, WidgetBody, WidgetMetaContext, type WidgetMetaContextValue, WidgetMeters, type WidgetMetersProps, WidgetScopeProvider, WidgetSections, type WidgetShape, type WidgetShapeInfo, type WidgetTopicDeclaration, type WithheldTrajectory, anchoredPosition, audioCaptureSupport, badgeFace, bandClaim, clearAugments, commandFailedSentence, commandFoundSentence, commandGateSentence, commandLossSentence, commandOutcomes, commandRefusalSentence, commandUndeliveredSentence, configEqual, createDelayRailStore, createDomainAvailabilityStore, defaultDarkTheme, derivedMarking, describeAudioInput, ephemerisFigureOf, faintText, filterComboboxOptions, flattenComboboxGroups, formatStreamStatus, getAugmentSettings, getAugments, getAugmentsForSlot, getSizeBucket, getWidgetShape, gridFloor, groupComboboxOptions, heldWord, modelledBeyondReceived, moveComboboxActiveIndex, onAugmentsChange, paintReckonedPosition, paintReckoningMark, paintVesselMark, paintVesselPositions, placeGraphNotice, placedOnScale, railTagKey, reckoningBasisPhrase, registerAugment, resolveCurrency, resourceColor, ribbonBoundaryX, sayHeld, severityFromStreamStatus, shouldExpandTabs, showsTiny, sizeDeltaFor, standsApart, toInFlightListItems, toneEdge, trajectoryWithheldCopy, useActiveHandles, useAllAugmentSettings, useAudioInput, useAugmentAvailable, useAugmentSettings, useCommandButton, useContributions, useContributionsBySlotId, useDelayRailStore, useDomainAvailabilityStore, useElementSize, useModal, useModalChrome, useModalSaveBar, usePanelAsideSize, usePanelStatusStore, usePrefersReducedMotion, useRailEntry, useRowFilter, useSizeDeltaFor, useSlotBound, useSlotLabel, useStatusBreakdown, useStatusContribution, useStatusSummary, useTooltip, useWidgetBadges, useWidgetMeta, useWidgetScope, useWidgetSegmentBound, utOfParts, waveformPath, widgetDeclaredTopics, widgetDrawnFields, withSizeDelta, worstSeverity, writtenAs, writtenQuantity };
+/**
+ * Geometry for a flat map that repeats east and west: a ground track drawn as
+ * one continuous line however often it crosses the antimeridian, and every
+ * mark drawn in whichever copy of the world is in view.
+ */
+/**
+ * A point on the body, in degrees.
+ *
+ * @category Map
+ */
+interface GroundPoint {
+    /** Degrees north, from -90 at the south pole to 90 at the north. */
+    lat: number;
+    /** Degrees east. */
+    lon: number;
+}
+/**
+ * Break a ground track wherever it flies over a pole, where its longitude
+ * flips by half a turn and a line joining the pair would run along the map's
+ * top or bottom edge. Crossing the antimeridian is not a break: draw each run
+ * with {@link wrapPath}, which carries it on into the next copy of the world.
+ *
+ * Geometric, not a tuned constant: a pair straddles a pole when the shorter
+ * great-circle arc between them passes closer to it than the samples are to
+ * each other. "Passes" means the arc's closest point to the pole lies between
+ * them, which rules out a pair climbing on one leg; "closer than each other"
+ * ties the test to the sampling, so a near miss the sampling resolves still
+ * draws its jog.
+ *
+ * @category Map
+ */
+declare function splitAtPoleCrossings<Point extends GroundPoint>(points: readonly Point[]): Point[][];
+/**
+ * The copies of a projected path that cross a view of a map repeating every
+ * `period` pixels across. The path is first made continuous, each point moved
+ * by whole periods to lie within half a period of the one before, so a track
+ * that leaves one edge of the world carries on past it rather than jumping
+ * back across the map. Then it is shifted by every whole period that brings
+ * some of it between `viewMin` and `viewMax`.
+ *
+ * Points may come from any copy of the world, such as a projection that wraps
+ * longitude. The path must already be split where it crosses a pole (see
+ * {@link splitAtPoleCrossings}), since half a turn of longitude is no jump a
+ * continuous line can be told apart from.
+ *
+ * @category Map
+ * @categoryDescription Map
+ * Drawing on a flat map of a body that repeats east and west, such as a
+ * `map-view.overlay`. A ground track is split only where it flies over a pole,
+ * carried on across the antimeridian rather than drawn back across the map,
+ * and drawn again in every repeat of the world in view.
+ */
+declare function wrapPath<Point extends {
+    x: number;
+}>(points: readonly Point[], period: number, viewMin: number, viewMax: number): Point[][];
+/**
+ * Every whole multiple of `period` that, added to the span `min` to `max`,
+ * puts some of it between `viewMin` and `viewMax`, west to east. On a
+ * map repeating every `period` pixels, these are the shifts at which to draw
+ * a mark or a region so it appears in every copy of the world in view. A
+ * single point is a span with `min` equal to `max`; widen the view by the
+ * mark's own size so one straddling the edge is not dropped.
+ *
+ * @category Map
+ */
+declare function repeatsInView(min: number, max: number, viewMin: number, viewMax: number, period: number): number[];
+
+export { ARM_TIMEOUT_MS, ActionMenu, type ActionMenuItem, type ActionMenuProps, type AnchorPoint, type AnchoredPosition, AntiNormalIcon, AntiTargetIcon, type AnyAugment, ArrowDownIcon, ArrowLeftIcon, ArrowRightIcon, ArrowUpIcon, type AudioCaptureSupport, type AudioCaptureUnsupportedReason, type AudioInputControls, type AudioInputDevice, type AudioInputFailure, AudioInputPicker, type AudioInputPickerProps, type AudioInputState, type AudioInputStatus, type AugmentSegmentProps, type AugmentSegmentRegistry, type AugmentSettingsContextValue, AugmentSettingsPanel, type AugmentSettingsPanelProps, AugmentSettingsProvider, AugmentSlot, AutoEmptyState, type AutoEmptyStateProps, AvatarStack, type AvatarStackItem, type AvatarStackProps, Badge, type BadgeFace, type BadgeProps, type BadgeSize, Band, type BandProps, BellIcon, BinormalIcon, Block, type BlockProps, type BlockTitleRowProps, Box, type BoxPad, type BoxProps, type BoxRadius, type BoxSurface, BroadcastIcon, Button, ButtonGroup, type ButtonGroupProps, type ButtonProps, type ButtonSize, type ButtonTone, type ButtonVariant, Card, type CardProps, CheckIcon, ChevronDownIcon, ChevronLeftIcon, ChevronRightIcon, ChevronUpIcon, CloseIcon, Cluster, type ClusterAlign, type ClusterJustify, type ClusterProps, ComboboxListbox, type ComboboxListboxProps, type ComboboxOption, CommandButton, type CommandButtonHandle, type CommandButtonPhase, type CommandButtonProps, type CommandButtonSize, type CommandButtonState, type CommandButtonTone, CommandDelay, type CommandDelayHandle, type CommandDelayProps, type CommandFailedEntry, type CommandFailedLike, type CommandFoundEntry, type CommandFoundLike, type CommandGateLike, CommandGroup, type CommandGroupProps, type CommandHandle, CommandList, type CommandListKind, type CommandListProps, type CommandLossEntry, type CommandLossLike, type CommandOutcomes, type CommandRefusalEntry, type CommandRefusalLike, type CommandReplyLike, type CommandUndeliveredEntry, type CommandUndeliveredLike, ComposerBar, type ComposerBarProps, ComputerIcon, ConfigForm, Console, type ConsoleProps, type ConsoleTone, ContainerBreak, type ContainerBreakProps, type ContributionSlotEntry, ContributionsPanelStore, ContributionsProvider, ControlDelayStream, type ControlDelayStreamProps, type ControlDelayStreamVariant, type ControlRibbonDatum, type ControlStreamDatum, type ControlStreamSample, Countdown, type CountdownProps, type CurrencyOptions, DataKeyPicker, type DataKeyPickerProps, DataLine, type DataLineProps, DataTable, type DataTableColumn, type DataTableColumnBase, type DataTableProps, type DataTableSection, DatabaseIcon, DefaultThemeProvider, DelayRailContext, DelayRailProvider, DiagnosticsIcon, Dial, type DialProps, type DialTick, type DialZone, Disclosure, type DisclosureProps, DivergingBar, type DivergingBarProps, Divider, type DividerProps, DomainAvailabilityContext, DomainAvailabilityProvider, type DomainAvailabilityStore, type DrawnPrecision, type ElementSize, EmptyState, type EmptyStateLayout, type EmptyStateProps, type EphemerisFigure, ExpandableText, type ExpandableTextProps, FAINT_TEXT_STYLE, FRAMEWORK_AUGMENT_SEGMENTS, FRAMEWORK_CONTRIBUTION_SEGMENTS, Field, FieldHint, FieldLabel, FieldRow, Fill, type FillProps, type FillQuantity, FilterChip, type FilterChipProps, FilterList, type FilterListProps, FilterRegion, type FilterRegionProps, type FilterRow, FitLabelButton, type FitLabelButtonProps, Floating, type FloatingProps, FormActions, FormatQuantityOptions, FormatsFor, FormatsForKind, FramedDisplay, type FramedDisplayProps, FrenetNormalIcon, FullHeightIcon, FullWidthIcon, FullscreenEnterIcon, FullscreenExitIcon, type GapToken, GraphNotice, type GraphNoticePlacement, type GraphNoticeProps, type GraphNoticeSpace, Grid, type GridAlign, type GridProps, type GroundPoint, HalfHeightIcon, HalfWidthIcon, HeartIcon, HeldBadge, type HeldBadgeProps, HeldFigure, type HeldFigureProps, HistoryIcon, HomeIcon, HoverCard, type HoverCardProps, INTERVAL_DASH, IconButton, type IconButtonProps, type IconProps, type InFlightCommandLike, InFlightFace, type InFlightFaceProps, InFlightList, type InFlightListDensity, type InFlightListItem, type InFlightListMode, type InFlightListProps, InfoIcon, Inline, type InlineProps, Input, type InsetToken, InstrumentHeldMark, JogWheel, type JogWheelCommon, type JogWheelProps, JoystickIcon, type KeyOption, KindOfGroup, LayersIcon, LevelBars, type LevelBarsProps, LineGraph, type LineGraphProps, type LineGraphSeries, type LineGraphThreshold, type LineGraphThresholdStyle, LiveRegion, type LiveRegionProps, LockIcon, LockMark, type LockMarkProps, LockScope, type LockScopeProps, type LockSummary, MARKER_ICONS, MARKER_IDS, ManeuverIcon, type MarkKind, type MarkerIconProps, type MarkerId, Meter, type MeterLayout, type MeterProps, MeterRowGroup, MeterStack, MicroscopeIcon, MissionDate, MissionDateField, type MissionDateFieldProps, type MissionDateParts, type MissionDateProps, ModalChromeContext, type ModalChromeValue, type ModalContextValue, type ModalOpenOptions, ModalProvider, type ModalSaveBarOptions, ModelledAlongside, type ModelledFigureAlongsideProps, type ModelledQuantityAlongsideProps, MutedIcon, NULL_DISPLAY, NormalIcon, Notice, type NoticeProps, NullValue, type PaintReckoningMarkOptions, type PaintVesselMarkOptions, Panel, type PanelAsideSize, type PanelBadge, PanelBadgesProvider, type PanelInactiveReason, type PanelProps, type PanelSidebarSide, type PanelStatusStore, PanelStatusStoreProvider, type PanelTitleProps, ParallelMinusIcon, ParallelPlusIcon, PauseIcon, PencilIcon, PlayIcon, PlotCrosshair, type PlotCrosshairProps, type PlotCrosshairRow, type PlotReadoutPlacement, type PlotReadoutSpace, PlusIcon, PresentableAs, PresentableAsKind, ProgradeIcon, PushUpIcon, RECKONING_MARK, RETIRED_SLOT_IDS, RadialInIcon, RadialOutIcon, type RailEntry, type RailFailed, type RailFound, type RailLoss, type RailRefusal, type RailUndelivered, type RateControl, ReadFrameControl, type ReadFrameControlProps, type ReadFrameOption, ReadOnlyField, type ReadOnlyFieldProps, type ReadOnlyFieldValue, Readout, ReadoutCaption, type ReadoutProps, type ReadoutSize, RecallIcon, type ReckonedPosition, ReckonedUnit, type ReckoningKind, ReckoningMark, ReckoningMarkSvg, type ReckoningMarking, RelativeMinusIcon, RelativePlusIcon, type Resolved, RetrogradeIcon, Row, type RowFilter, RowName, type RowProps, STREAM_MIN_DELAY_SECONDS, SatelliteIcon, ScrollArea, SearchBox, type SearchBoxProps, Section, type SectionProps, SectionTitle, Select, SelectableRow, type SelectableRowProps, SendIcon, SettingsIcon, type Severity, type SharedFormat, SignalDelayBadge, type SignalDelayBadgeProps, type SizeBucket, type SlidableRange, Slider, type SliderProps, SpeakerIcon, Spinner, type SpinnerProps, Stack, type StackProps, StarIcon, Stat, StatContributions, type StatContributionsProps, type StatProps, type StaticElement, type StatusBreakdownEntry, type StatusContribution, StatusIndicator, type StatusIndicatorProps, type StatusSummary, Stepper, type StepperProps, StopIcon, StreamStatusBadge, type StreamStatusBadgeProps, SubjectHeading, type SubjectHeadingProps, Switch, type SwitchBaseProps, type SwitchProps, TABS_PANEL_MIN_WIDTH, TINY_BELOW, TONE_LABEL, TONE_MARK, TONE_ON_STATUS, TONE_STATUS, TONE_TEXT, type TabDescriptor, Tabs, type TabsProps, TangentIcon, Tape, type TapeMarker, type TapeProps, type TapeZone, TargetIcon, Text, TextButton, TextField, type TextFieldProps, type TextLevel, type TextProps, type TextSize, type TextWeight, Textarea, type ThemeBorders, type ThemeColors, type ThemeTypography, type TimeContext, TinyEssentials, type TinyEssentialsProps, ToggleButton, type ToggleButtonProps, type ToggleButtonSize, type ToggleButtonTone, Tooltip, type TooltipAnchorProps, type TooltipProps, TrajectoryWithheldNote, Truncate, type UiKitTheme, Unit, UnitGroupKey, type UnitGroupPins, UnitInput, type UnitInputProps, type UnitPins, type UnitPinsByGroup, type UnitProps, UnitSharedFormat, type UnitSharedFormatMixedProps, type UnitSharedFormatProps, type UnitValue, type UseAudioInputOptions, type UseCommandButtonOptions, type UseRowFilterOptions, type UseTooltipResult, VESSEL_MARK, type VesselMarkState, VesselMarkSvg, type VesselMarkSvgProps, type VesselPositions, VisuallyHidden, WAVE_HALF_H, WAVE_MID_Y, WidgetBody, WidgetMetaContext, type WidgetMetaContextValue, WidgetMeters, type WidgetMetersProps, WidgetScopeProvider, WidgetSections, type WidgetShape, type WidgetShapeInfo, type WidgetTopicDeclaration, type WithheldTrajectory, anchoredPosition, audioCaptureSupport, badgeFace, clearAugments, commandFailedSentence, commandFoundSentence, commandGateSentence, commandLossSentence, commandOutcomes, commandRefusalSentence, commandUndeliveredSentence, configEqual, createDelayRailStore, createDomainAvailabilityStore, defaultDarkTheme, derivedMarking, describeAudioInput, ephemerisFigureOf, faintText, filterComboboxOptions, flattenComboboxGroups, formatStreamStatus, getAugmentSettings, getAugments, getAugmentsForSlot, getSizeBucket, getWidgetShape, gridFloor, groupComboboxOptions, heldFigureOf, heldGradeOf, heldMarking, heldWord, initialsOf, modelledBeyondReceived, moveComboboxActiveIndex, onAugmentsChange, paintReckonedPosition, paintReckoningMark, paintVesselMark, paintVesselPositions, placeGraphNotice, placePlotReadouts, placedOnScale, plotCrosshairShowsCard, railTagKey, reckoningBasisPhrase, registerAugment, repeatsInView, resolveCurrency, resourceColor, ribbonBoundaryX, sayHeld, severityFromStreamStatus, shouldExpandTabs, showsTiny, sizeDeltaFor, splitAtPoleCrossings, standsApart, toInFlightListItems, toneEdge, trajectoryWithheldCopy, useActiveHandles, useAllAugmentSettings, useAudioInput, useAugmentAvailable, useAugmentSettings, useCommandButton, useContributions, useContributionsBySlotId, useDelayRailStore, useDomainAvailabilityStore, useElementSize, useModal, useModalChrome, useModalSaveBar, usePanelAsideSize, usePanelStatusStore, usePrefersReducedMotion, useRailEntry, useRowFilter, useSizeDeltaFor, useSlotBound, useSlotLabel, useStatusBreakdown, useStatusContribution, useStatusSummary, useTooltip, useWidgetBadges, useWidgetMeta, useWidgetScope, useWidgetSegmentBound, utOfParts, waveformPath, widgetDeclaredTopics, widgetDrawnFamilies, widgetDrawnFields, withSizeDelta, worstSeverity, wrapPath, writtenAs, writtenQuantity };