@tellegen/svelte 0.2.0 → 0.4.0

package/dist/state.svelte.d.ts

@@ -1,14 +1,28 @@
 import type { CaseSummary, DemandDeltas, Network, NetworkBranch, NetworkBus, SensitivityColumn, Solution, SolveIteration } from './api.js';
-import { type BranchRatingDeltas, type CaseFileSummary, type DistGraph, type IngestedDistCase, type SensTarget, type Topology } from '@tellegen/engine';
+import { type StudyView, type BranchRatingDeltas, type BrowserMcPfSession, type CaseFileSummary, type DistGraph, type Formulation, type IngestedDistCase, type McPfCallTiming, type McPfResult, type McPfSummary, type McLoadBranchState, type McLoadPowerEdit, type McStudySnapshot, type SensTarget, type Topology } from '@tellegen/engine';
 import type { MultiView } from './multiconductor.js';
 export type SolveBackend = 'clarabel-wasm' | 'clarabel-wasm-server-sensitivity' | 'rust-server';
 /** A map framing request: a case id, 'all', or one branch to center. */
 export type FrameTarget = string | 'all' | {
     caseId: string;
     branchId: number;
+} | {
+    caseId: string;
+    busId: number;
 };
+export interface CameraSnapshot {
+    center: [number, number];
+    zoom: number;
+    bearing: number;
+    pitch: number;
+}
+export interface DiagramCameraSnapshot {
+    caseId: string;
+    center: [number, number];
+    scale: number;
+}
 export type DemandRangeMode = 'local' | 'full';
-export type DisplayMode = 'lmp' | 'angle' | 'voltage';
+export type DisplayMode = 'price' | 'angle' | 'voltage';
 /** The case a removal promoted to active, so the caller can hydrate it: a backend
  * case needs its network/solution loaded, a local needs a browser solve, and
  * `none` means nothing remains (or the removal left the active case untouched). */
@@ -34,6 +48,7 @@ export interface LocalSubstations {
 }
 type CoordsKind = 'file' | 'synthetic_pending' | 'synthetic' | 'manual' | 'geofile';
 type LocalView = {
+    coordinate_space?: 'geographic' | 'diagram';
     buses: NetworkBus[];
     branches: NetworkBranch[];
 };
@@ -42,8 +57,11 @@ export interface LocalCaseInit {
     id: string;
     label: string;
     fileName: string;
+    formulation?: Formulation;
+    declaredFormulation?: Formulation;
     summary?: CaseFileSummary | null;
-    networkJson?: string;
+    /** Retained PowerIO module used to construct solver studies. */
+    studyInputJson?: string;
     topology?: Topology;
     coordsKind?: CoordsKind;
     view?: LocalView | null;
@@ -59,10 +77,11 @@ export declare class LocalCase {
     readonly id: string;
     readonly label: string;
     readonly fileName: string;
+    readonly declaredFormulation?: Formulation;
     /** Case stats; null for a .pwd display only entry. */
     summary: CaseFileSummary | null;
-    /** Raw powerio Network JSON for the browser solver branch. */
-    networkJson: string | undefined;
+    /** Generation 2 PowerIO IR used for display edits and solver studies. */
+    studyInputJson: string | undefined;
     /** Topology for synthetic placement when the file has no coordinates. */
     topology: Topology | undefined;
     coordsKind: CoordsKind | undefined;
@@ -72,6 +91,13 @@ export declare class LocalCase {
         lon: number;
         lat: number;
     } | undefined;
+    diagram: {
+        view: LocalView;
+        layer: string;
+        name: string;
+        warnings: string[];
+    } | null;
+    displayMode: 'geographic' | 'diagram';
     geoSource: string | undefined;
     geoWarnings: string[] | undefined;
     network: Network | null;
@@ -81,8 +107,7 @@ export declare class LocalCase {
     deltas: DemandDeltas;
     /** Committed branch rating deltas (MW from base, keyed by branch). */
     ratings: BranchRatingDeltas;
-    /** The OPF formulation the browser Study solves for this case: DC OPF (default),
-     * full AC OPF, or the SOCWR relaxation. Changing it rebuilds the Study. */
+    /** The selected calculation. Changing it rebuilds the numerical Study. */
     formulation: import("@tellegen/engine").BrowserFormulation;
     iterations: SolveIteration[];
     solving: boolean;
@@ -91,6 +116,8 @@ export declare class LocalCase {
     solveFallbackReason: string | null;
     /** Monotone token: only the latest solve may write this case. */
     solveSeq: number;
+    /** Monotone generation for external optimistic concurrency. */
+    revisionGeneration: number;
     /** Monotone token: only the latest sensitivity request may write this case. */
     sensitivitySeq: number;
     predictedObjective: number | null;
@@ -104,9 +131,10 @@ export declare class LocalCase {
 export declare class CaseState {
     readonly id: string;
     readonly name: string;
+    readonly unavailableReason: string | null;
     network: Network | null;
-    /** Raw powerio Network JSON for the browser solver; fetched lazily. */
-    networkJson: string | null;
+    /** Retained PowerIO module for the browser solver; fetched lazily. */
+    studyInputJson: string | null;
     /** Boot solution at base demand; never changes. */
     baseSolution: Solution | null;
     /** Exact solution at the current committed perturbation. */
@@ -126,6 +154,8 @@ export declare class CaseState {
     solveFallbackReason: string | null;
     /** Monotone token: only the latest solve may write this case. */
     solveSeq: number;
+    /** Monotone generation for external optimistic concurrency. */
+    revisionGeneration: number;
     /** Monotone token: only the latest sensitivity request may write this case. */
     sensitivitySeq: number;
     /** Closer for this case's in-flight server solve stream, if any. Owned per
@@ -140,27 +170,52 @@ export declare class CaseState {
 /** A case the solver can run: a server-backed case or a browser-parsed local case. */
 export type SolvableCase = CaseState | LocalCase;
 /** The multiconductor ingest payload without the graph: the summary counts,
- * connected load/generation, coordinate provenance, and warnings. */
+ * connected load/generation, coordinate provenance, and diagnostics. */
 export type MultiCaseSummary = Omit<IngestedDistCase, 'graph'>;
-/** How a multiconductor case is placed on the map. `geographic` positions drop
- * straight on; `planar`/`synthetic` need a map center, so they sit `pending`
- * until the user places them. */
+/** Geographic coordinates use the map; other positions use the diagram canvas. */
 export type MultiCoordsKind = 'geographic' | 'planar' | 'synthetic';
-/** A multiconductor distribution case parsed in the browser, viewed only: no
- * formulation, no sliders, no Study. It carries the bus/terminal graph, its
- * placed map view, and the selected bus whose terminal detail expands. Fields
- * are reactive like the solvable cases so the panel and map track them. */
+/** Where one interactive load edit spent its time, in milliseconds: engine
+ * (solve and summary), transfer, and parsing as recorded by the session, and
+ * the total from the start of the solve until the result state is updated. */
+export interface McEditTiming extends McPfCallTiming {
+    total_ms: number;
+}
+/** A conductor-resolved case with retained electrical inputs and terminal results. */
 export declare class MulticonductorCase {
     readonly id: string;
     readonly label: string;
     readonly fileName: string;
+    moduleJson: string | null;
+    geoLayer: string | null;
+    geoWarnings: string[];
+    /** Summary of the displayed operating point: from the live session after
+     * each solve or load edit, or derived from a stored full result. */
+    result: McPfSummary | null;
+    /** The complete result when no live session holds the operating point: a
+     * saved Study, a solve without sessions, or after coordinates are attached. */
+    mcFullResult: McPfResult | null;
+    /** Latency breakdown of the latest load-edit solve. */
+    mcTiming: McEditTiming | null;
+    mcSnapshot: McStudySnapshot | null;
+    mcSession: BrowserMcPfSession | null;
+    mcLoadBranches: McLoadBranchState[];
+    mcLoadEdits: McLoadPowerEdit[];
+    mcEditRevision: number;
+    mcEditRunning: boolean;
+    mcEditTimer: ReturnType<typeof setTimeout> | null;
+    mcSavedAt: string | null;
+    solving: boolean;
+    solveMs: number | null;
+    solveSeq: number;
+    revisionGeneration: number;
+    solveAbort: AbortController | null;
     /** Summary counts and coordinate provenance from the parse. */
     summary: MultiCaseSummary | null;
     /** The render-ready bus/terminal graph. */
     graph: DistGraph | null;
     /** Placement kind resolved at ingest from the case's coordinate space. */
     coordsKind: MultiCoordsKind;
-    /** The placed map view; null until placed (planar/synthetic await a center). */
+    /** The map or diagram positions. */
     view: MultiView | null;
     syntheticCenter: {
         lon: number;
@@ -181,6 +236,8 @@ export declare class MulticonductorCase {
         coordsKind: MultiCoordsKind;
         view?: MultiView | null;
     });
+    get mcPfReason(): string | null;
+    get mcPfSupported(): boolean;
     /** Whether the case is placed and ready to render. */
     get placed(): boolean;
     /** The selected bus's placed detail, or null. */
@@ -188,8 +245,30 @@ export declare class MulticonductorCase {
     /** The selected edge's placed detail, or null. */
     get selectedEdge(): import("./multiconductor.js").PlacedMultiEdge | null;
 }
+export interface StudyDisplaySnapshot {
+    id: string;
+    studyId: string;
+    caseId: string;
+    revision: number;
+    label: string;
+    formulation: Formulation;
+    network: Network;
+    solution: StudyView | null;
+    inputJson?: string;
+    baseDemandMw?: Record<string, number>;
+}
 export declare class AppState {
     #private;
+    camera: CameraSnapshot | null;
+    cameraRequest: CameraSnapshot | null;
+    cameraSeq: number;
+    diagramCamera: DiagramCameraSnapshot | null;
+    diagramCameraRequest: DiagramCameraSnapshot | null;
+    diagramCameraSeq: number;
+    requestDiagramCamera(caseId: string, snapshot: Omit<DiagramCameraSnapshot, 'caseId'>): void;
+    requestCamera(snapshot: CameraSnapshot): void;
+    /** Saved Study inspection is independent of the editable case and its solution. */
+    studyView: StudyDisplaySnapshot | null;
     cases: CaseState[];
     activeCaseId: string | null;
     /** Selected bus in the active case. */
@@ -200,24 +279,29 @@ export declare class AppState {
     previewDeltaMw: number | null;
     /** Live rating slider value (MW from base) before commit; null when idle. */
     previewRatingMw: number | null;
-    /** True while the demand control should keep the map in LMP preview mode. */
+    /** True while the demand control should keep the map in nodal value preview mode. */
     previewActive: boolean;
-    /** Engine first-order LMP preview for the live drag: predicted change in LMP
-     * ($/MWh) per bus at the previewed edit, scoped to the case and selection
+    /** Engine first order nodal value preview for the live drag, scoped to the case and selection
      * target (bus or branch) it was computed for. Set by the Study path; null when
      * no Study preview applies (the map then falls back to the JS
      * sensitivity-times-step preview). Reassigned wholesale, so $state.raw. */
-    previewLmp: {
+    previewPrices: {
         caseId: string;
         target: SensTarget;
         delta: Map<number, number>;
+        units: string;
     } | null;
     demandRangeMode: DemandRangeMode;
     displayMode: DisplayMode;
     sensitivityLoading: boolean;
+    errorRevision: number;
     /** Re-runs the operation behind the current `error`, when one applies. Every
      * write to `error` clears it, so a retry op can never outlive its message. */
     errorRetry: (() => void) | null;
+    /** Technical detail behind the current `error`, when the message itself is
+     * written for people; notices keep it in their disclosure. Every write to
+     * `error` clears it, as it clears `errorRetry`. */
+    errorDetail: string | null;
     get error(): string | null;
     set error(message: string | null);
     /** Case files parsed in the browser via the powerio wasm module. */
@@ -225,7 +309,7 @@ export declare class AppState {
     /** Local case the panel shows; clicking a bundled case or a bus clears it. */
     activeLocalId: string | null;
     placingLocalId: string | null;
-    /** Multiconductor distribution cases parsed in the browser (viewing only). */
+    /** Multiconductor cases with retained inputs and AC power flow results. */
     multiCases: MulticonductorCase[];
     /** Multiconductor case the panel shows; mutually exclusive with the solvable
      * active ids. */

package/dist/state.svelte.js

@@ -12,16 +12,19 @@ export class LocalCase {
     id;
     label;
     fileName;
+    declaredFormulation;
     /** Case stats; null for a .pwd display only entry. */
     summary = $state.raw(null);
-    /** Raw powerio Network JSON for the browser solver branch. */
-    networkJson = $state.raw(undefined);
+    /** Generation 2 PowerIO IR used for display edits and solver studies. */
+    studyInputJson = $state.raw(undefined);
     /** Topology for synthetic placement when the file has no coordinates. */
     topology = $state.raw(undefined);
     coordsKind = $state.raw(undefined);
     /** Map geometry when the file carried or received coordinates. */
     view = $state.raw(null);
     syntheticCenter = $state.raw(undefined);
+    diagram = $state.raw(null);
+    displayMode = $state('geographic');
     geoSource = $state.raw(undefined);
     geoWarnings = $state.raw(undefined);
     network = $state.raw(null);
@@ -31,8 +34,7 @@ export class LocalCase {
     deltas = $state.raw({});
     /** Committed branch rating deltas (MW from base, keyed by branch). */
     ratings = $state.raw({});
-    /** The OPF formulation the browser Study solves for this case: DC OPF (default),
-     * full AC OPF, or the SOCWR relaxation. Changing it rebuilds the Study. */
+    /** The selected calculation. Changing it rebuilds the numerical Study. */
     formulation = $state(DEFAULT_FORMULATION);
     iterations = $state.raw([]);
     solving = $state(false);
@@ -41,6 +43,8 @@ export class LocalCase {
     solveFallbackReason = $state(null);
     /** Monotone token: only the latest solve may write this case. */
     solveSeq = 0;
+    /** Monotone generation for external optimistic concurrency. */
+    revisionGeneration = $state(0);
     /** Monotone token: only the latest sensitivity request may write this case. */
     sensitivitySeq = 0;
     predictedObjective = $state(null);
@@ -50,8 +54,10 @@ export class LocalCase {
         this.id = init.id;
         this.label = init.label;
         this.fileName = init.fileName;
+        this.formulation = init.formulation ?? DEFAULT_FORMULATION;
+        this.declaredFormulation = init.declaredFormulation;
         this.summary = init.summary ?? null;
-        this.networkJson = init.networkJson;
+        this.studyInputJson = init.studyInputJson;
         this.topology = init.topology;
         this.coordsKind = init.coordsKind;
         this.view = init.view ?? null;
@@ -66,9 +72,10 @@ export class LocalCase {
 export class CaseState {
     id;
     name;
+    unavailableReason;
     network = $state.raw(null);
-    /** Raw powerio Network JSON for the browser solver; fetched lazily. */
-    networkJson = $state.raw(null);
+    /** Retained PowerIO module for the browser solver; fetched lazily. */
+    studyInputJson = $state.raw(null);
     /** Boot solution at base demand; never changes. */
     baseSolution = $state.raw(null);
     /** Exact solution at the current committed perturbation. */
@@ -88,6 +95,8 @@ export class CaseState {
     solveFallbackReason = $state(null);
     /** Monotone token: only the latest solve may write this case. */
     solveSeq = 0;
+    /** Monotone generation for external optimistic concurrency. */
+    revisionGeneration = $state(0);
     /** Monotone token: only the latest sensitivity request may write this case. */
     sensitivitySeq = 0;
     /** Closer for this case's in-flight server solve stream, if any. Owned per
@@ -99,26 +108,48 @@ export class CaseState {
     constructor(summary) {
         this.id = summary.id;
         this.name = summary.name;
+        this.unavailableReason = summary.unavailable_reason ?? null;
     }
     get perturbed() {
         return hasPerturbation(this.deltas) || hasPerturbation(this.ratings);
     }
 }
-/** A multiconductor distribution case parsed in the browser, viewed only: no
- * formulation, no sliders, no Study. It carries the bus/terminal graph, its
- * placed map view, and the selected bus whose terminal detail expands. Fields
- * are reactive like the solvable cases so the panel and map track them. */
+/** A conductor-resolved case with retained electrical inputs and terminal results. */
 export class MulticonductorCase {
     id;
     label;
     fileName;
+    moduleJson = $state.raw(null);
+    geoLayer = $state.raw(null);
+    geoWarnings = $state.raw([]);
+    /** Summary of the displayed operating point: from the live session after
+     * each solve or load edit, or derived from a stored full result. */
+    result = $state.raw(null);
+    /** The complete result when no live session holds the operating point: a
+     * saved Study, a solve without sessions, or after coordinates are attached. */
+    mcFullResult = $state.raw(null);
+    /** Latency breakdown of the latest load-edit solve. */
+    mcTiming = $state.raw(null);
+    mcSnapshot = $state.raw(null);
+    mcSession = $state.raw(null);
+    mcLoadBranches = $state.raw([]);
+    mcLoadEdits = $state.raw([]);
+    mcEditRevision = 0;
+    mcEditRunning = false;
+    mcEditTimer = null;
+    mcSavedAt = $state(null);
+    solving = $state(false);
+    solveMs = $state(null);
+    solveSeq = 0;
+    revisionGeneration = $state(0);
+    solveAbort = null;
     /** Summary counts and coordinate provenance from the parse. */
     summary = $state.raw(null);
     /** The render-ready bus/terminal graph. */
     graph = $state.raw(null);
     /** Placement kind resolved at ingest from the case's coordinate space. */
     coordsKind = $state.raw('synthetic');
-    /** The placed map view; null until placed (planar/synthetic await a center). */
+    /** The map or diagram positions. */
     view = $state.raw(null);
     syntheticCenter = $state.raw(undefined);
     /** The selected bus id, whose terminal stack and incident conductors expand;
@@ -132,10 +163,24 @@ export class MulticonductorCase {
         this.label = init.label;
         this.fileName = init.fileName;
         this.summary = init.summary;
+        this.moduleJson = init.summary.module_json ?? null;
+        this.geoLayer = init.summary.geo_layer ?? null;
         this.graph = init.graph;
         this.coordsKind = init.coordsKind;
         this.view = init.view ?? null;
     }
+    get mcPfReason() {
+        if (!this.moduleJson)
+            return 'This case has no retained electrical input';
+        if (this.summary?.mc_pf_enabled !== true)
+            return 'AC power flow is unavailable in this build';
+        return (this.summary.mc_pf_reason ??
+            this.summary.mc_pf_unavailable_reason ??
+            (this.summary.mc_pf_supported !== true ? 'AC power flow is unavailable for this case' : null));
+    }
+    get mcPfSupported() {
+        return this.mcPfReason === null;
+    }
     /** Whether the case is placed and ready to render. */
     get placed() {
         return this.view !== null;
@@ -154,6 +199,40 @@ export class MulticonductorCase {
     }
 }
 export class AppState {
+    camera = $state.raw(null);
+    cameraRequest = $state.raw(null);
+    cameraSeq = $state(0);
+    diagramCamera = $state.raw(null);
+    diagramCameraRequest = $state.raw(null);
+    diagramCameraSeq = $state(0);
+    requestDiagramCamera(caseId, snapshot) {
+        if (!Array.isArray(snapshot.center) ||
+            snapshot.center.length !== 2 ||
+            ![...snapshot.center, snapshot.scale].every(Number.isFinite) ||
+            snapshot.scale <= 0) {
+            throw new Error('Invalid saved drawing view');
+        }
+        this.settleFrame();
+        this.diagramCameraRequest = { caseId, center: [...snapshot.center], scale: snapshot.scale };
+        this.diagramCameraSeq++;
+    }
+    requestCamera(snapshot) {
+        if (!Array.isArray(snapshot.center) ||
+            snapshot.center.length !== 2 ||
+            ![...snapshot.center, snapshot.zoom, snapshot.bearing, snapshot.pitch].every(Number.isFinite) ||
+            Math.abs(snapshot.center[1]) > 90 ||
+            snapshot.zoom < 0 ||
+            snapshot.zoom > 24 ||
+            snapshot.pitch < 0 ||
+            snapshot.pitch > 85) {
+            throw new Error('Invalid saved camera position');
+        }
+        this.settleFrame();
+        this.cameraRequest = { ...snapshot, center: [...snapshot.center] };
+        this.cameraSeq++;
+    }
+    /** Saved Study inspection is independent of the editable case and its solution. */
+    studyView = $state.raw(null);
     cases = $state.raw([]);
     activeCaseId = $state(null);
     /** Selected bus in the active case. */
@@ -164,34 +243,41 @@ export class AppState {
     previewDeltaMw = $state(null);
     /** Live rating slider value (MW from base) before commit; null when idle. */
     previewRatingMw = $state(null);
-    /** True while the demand control should keep the map in LMP preview mode. */
+    /** True while the demand control should keep the map in nodal value preview mode. */
     previewActive = $state(false);
-    /** Engine first-order LMP preview for the live drag: predicted change in LMP
-     * ($/MWh) per bus at the previewed edit, scoped to the case and selection
+    /** Engine first order nodal value preview for the live drag, scoped to the case and selection
      * target (bus or branch) it was computed for. Set by the Study path; null when
      * no Study preview applies (the map then falls back to the JS
      * sensitivity-times-step preview). Reassigned wholesale, so $state.raw. */
-    previewLmp = $state.raw(null);
+    previewPrices = $state.raw(null);
     demandRangeMode = $state('local');
-    displayMode = $state('lmp');
+    displayMode = $state('price');
     sensitivityLoading = $state(false);
     #error = $state(null);
+    errorRevision = $state(0);
     /** Re-runs the operation behind the current `error`, when one applies. Every
      * write to `error` clears it, so a retry op can never outlive its message. */
     errorRetry = $state.raw(null);
+    /** Technical detail behind the current `error`, when the message itself is
+     * written for people; notices keep it in their disclosure. Every write to
+     * `error` clears it, as it clears `errorRetry`. */
+    errorDetail = $state(null);
     get error() {
         return this.#error;
     }
     set error(message) {
         this.#error = message;
+        if (message)
+            this.errorRevision++;
         this.errorRetry = null;
+        this.errorDetail = null;
     }
     /** Case files parsed in the browser via the powerio wasm module. */
     localCases = $state.raw([]);
     /** Local case the panel shows; clicking a bundled case or a bus clears it. */
     activeLocalId = $state(null);
     placingLocalId = $state(null);
-    /** Multiconductor distribution cases parsed in the browser (viewing only). */
+    /** Multiconductor cases with retained inputs and AC power flow results. */
     multiCases = $state.raw([]);
     /** Multiconductor case the panel shows; mutually exclusive with the solvable
      * active ids. */
@@ -273,7 +359,7 @@ export class AppState {
         this.previewDeltaMw = null;
         this.previewRatingMw = null;
         this.previewActive = false;
-        this.previewLmp = null;
+        this.previewPrices = null;
         this.demandRangeMode = 'local';
         this.sensitivityLoading = false;
         return this.activateFallback();
@@ -295,7 +381,7 @@ export class AppState {
     // else a remaining local case that can render (a view or substations) or is
     // awaiting placement, else the first remaining local. Frames whatever it picks.
     activateFallback() {
-        this.activeCaseId = this.cases[0]?.id ?? null;
+        this.activeCaseId = this.cases.find((c) => !c.unavailableReason)?.id ?? null;
         if (this.activeCaseId) {
             this.requestFrame(this.activeCaseId);
             return { kind: 'backend', id: this.activeCaseId };

package/dist/styles.css

@@ -32,6 +32,7 @@
 	--surface-panel: var(--panel);
 	--surface-chip: rgb(var(--paper-rgb) / 0.65);
 	--surface-control: rgb(var(--paper-rgb) / 0.55);
+	--surface-menu: #fff;
 	--border-default: var(--line);
 	--border-strong: var(--accent);
 	--text-primary: var(--ink);
@@ -47,6 +48,10 @@
 	--data-pos: var(--pos);
 	--data-neg: var(--neg);
 	--focus-ring: var(--accent);
+	/* unselected bus outline in the plain diagram view */
+	--diagram-bus-stroke: #756a5b;
+	/* ground symbol in the multiconductor bus detail */
+	--mc-ground-stroke: #3a3a3a;
 
 	/* type scale, anchored at the 15px body */
 	--fs-display-lg: 33px;
@@ -81,6 +86,11 @@
 	--radius-full: 50%;
 	--elev-1: 0 2px 10px rgb(var(--ink-rgb) / 0.1);
 	--elev-2: 0 4px 24px rgb(var(--ink-rgb) / 0.08);
+	/* floating controls that keep their own light shadows; the dark theme maps
+	   them onto the two steps above */
+	--elev-cue: 0 4px 18px rgb(var(--ink-rgb) / 0.1);
+	--elev-menu: 0 4px 18px rgb(var(--ink-rgb) / 0.14);
+	--elev-tooltip: 0 2px 10px rgb(var(--ink-rgb) / 0.12);
 	--shadow-thumb: 0 1px 4px rgb(var(--ink-rgb) / 0.3);
 	--inset-active: inset 0 -2px 0 var(--accent);
 
@@ -103,6 +113,49 @@
 	--z-grain: 9999;
 }
 
+/* Dark theme: `TellegenProvider theme="dark"` sets the attribute (a host may
+   also put it in its template). Contrast ratios are measured against the panel
+   composited over #4a4a4a, the darkest grey a dark basemap paints under it:
+   every text token clears 7:1. --border-strong marks a panel's edge over the
+   map, so it clears the 3:1 non-text minimum against that panel and against
+   bare #4a4a4a. The same markup passes WCAG AA on either ground. */
+:root[data-theme='dark'] {
+	--bg: #0b1420;
+	--paper: #0f1a27;
+	--panel: rgba(10, 20, 31, 0.92);
+	--line: #34465a; /* decorative separators only */
+	--border-strong: #859cb4; /* 6.30:1 against the panel, 3.13:1 against bare #4a4a4a */
+	--ink: #e8eef4; /* 15.3:1 */
+	--ink-dim: #b4c1cd; /* 9.7:1 */
+	--ink-faint: #95a6b6; /* 7.14:1, and 7.02:1 on the opaque --paper of a panel card */
+	--accent: #ffb24d;
+	--accent-bright: #ffc46e; /* 11.4:1 */
+	--accent-soft: rgba(255, 178, 77, 0.14);
+	--red: #ff9f8b; /* 9.0:1 */
+	--pos: #c9a7e0;
+	--neg: #8fd0a4;
+	--bg-rgb: 11 20 32;
+	--ink-rgb: 232 238 244;
+	--accent-rgb: 255 178 77;
+	--paper-rgb: 15 26 39;
+	--text-primary: var(--ink);
+	--text-secondary: var(--ink-dim);
+	--text-tertiary: var(--ink-faint);
+	--text-accent: var(--accent-bright);
+	--text-danger: var(--red);
+	--focus-ring: #8de7f7; /* 12.7:1 */
+	--surface-menu: var(--paper);
+	--diagram-bus-stroke: var(--ink-faint);
+	--mc-ground-stroke: var(--ink-dim);
+	--elev-1: 0 2px 10px rgb(0 0 0 / 0.45);
+	--elev-2: 0 4px 24px rgb(0 0 0 / 0.4);
+	--elev-cue: var(--elev-2);
+	--elev-menu: var(--elev-2);
+	--elev-tooltip: var(--elev-1);
+	/* the light form derives from --ink-rgb, which would glow here */
+	--shadow-thumb: 0 1px 4px rgb(0 0 0 / 0.5);
+}
+
 * {
 	box-sizing: border-box;
 }
@@ -225,7 +278,7 @@ a {
    ControlPanel.svelte; the .mode / .display-mode / @media source order is
    preserved so the cascade resolves exactly as before. */
 .region {
-	font-size: 10px;
+	font-size: 12px;
 	font-weight: 400;
 	color: var(--text-secondary);
 	text-transform: uppercase;
@@ -245,7 +298,7 @@ a {
    before the component split. Scoping this would raise its specificity past that rule. */
 .mode > button {
 	margin-left: auto;
-	font-size: 10.5px;
+	font-size: 12.5px;
 	padding: 2px 7px;
 	background: none;
 	border: 1px solid var(--line);
@@ -264,7 +317,7 @@ a {
 }
 
 .display-mode .segment button {
-	font-size: 11px;
+	font-size: 13px;
 	padding: 2px 9px;
 }
 
@@ -282,7 +335,7 @@ a {
 .legend-labels {
 	display: flex;
 	justify-content: space-between;
-	font-size: 10.5px;
+	font-size: 12.5px;
 	color: var(--text-tertiary);
 	margin-top: 4px;
 }
@@ -301,7 +354,7 @@ a {
 	border-radius: 999px;
 	color: var(--text-secondary);
 	background: var(--surface-control);
-	font-size: 10px;
+	font-size: 12px;
 	line-height: 1;
 	cursor: help;
 }
@@ -334,7 +387,7 @@ a {
 
 .reset {
 	margin-top: 10px;
-	font-size: 10.5px;
+	font-size: 12.5px;
 	padding: 3px 10px;
 	background: none;
 	border: 1px solid var(--line);

package/dist/synthetic-layout.js

@@ -28,6 +28,7 @@ export function placeSyntheticTopology(topology, center, opts) {
         buses: buses.map((bus) => {
             const [lon, lat] = coords.get(bus.id);
             return {
+                ...bus,
                 id: bus.id,
                 uid: bus.uid,
                 editable: bus.editable,