@tellegen/svelte 0.4.7 → 0.5.1

package/dist/components/McPfSettings.svelte

@@ -0,0 +1,158 @@
+<script lang="ts">
+	import { DEFAULT_MC_PF_OPTIONS, validateMcPfOptions, type McPfOptions } from '@tellegen/engine';
+	let {
+		options = $bindable<McPfOptions>({ ...DEFAULT_MC_PF_OPTIONS }),
+		disabled = false,
+		onapply
+	}: {
+		options: McPfOptions;
+		disabled?: boolean;
+		onapply?: (options: McPfOptions) => Promise<unknown>;
+	} = $props();
+	let failure = $state('');
+	const validation = $derived(validateMcPfOptions(options));
+	// Keep one shared set of next-run settings for every solve action. Fill
+	// omitted options when opening an older snapshot with partial settings.
+	$effect(() => {
+		if (Object.keys(DEFAULT_MC_PF_OPTIONS).some((key) => !(key in options))) {
+			options = { ...DEFAULT_MC_PF_OPTIONS, ...options };
+		}
+	});
+	async function apply() {
+		failure = '';
+		if (validation) return;
+		try {
+			await onapply?.({ ...options });
+		} catch (error) {
+			failure = error instanceof Error ? error.message : String(error);
+		}
+	}
+</script>
+
+<details class="settings">
+	<summary>Power flow settings</summary>
+	<p>
+		These settings apply to both Run power flow and Solve energized network. Editing them does not
+		start a calculation. A failed run retains the previous result and the settings used for that
+		result.
+	</p>
+	<fieldset {disabled}>
+		<legend>Load-model envelope</legend>
+		<label class="toggle"
+			><input type="checkbox" bind:checked={options.voltage_envelope} />Use load-model envelope</label
+		>
+		<p>
+			Outside the normal band, the envelope changes the load equations to help convergence. Modified
+			results are labelled explicitly. These thresholds are not operating voltage limits.
+		</p>
+		<label>Vlow (pu)<input type="number" step="any" bind:value={options.v_low_pu} /></label>
+		<label>Vmin (pu)<input type="number" step="any" bind:value={options.v_min_pu} /></label>
+		<label>Vmax (pu)<input type="number" step="any" bind:value={options.v_max_pu} /></label>
+		<p>
+			With the envelope disabled, the original load equations are used at every voltage; convergence
+			is not guaranteed.
+		</p>
+	</fieldset>
+	<fieldset {disabled}>
+		<legend>Numerical solver</legend>
+		<label
+			>Maximum iterations<input
+				type="number"
+				min="1"
+				step="1"
+				bind:value={options.max_iterations}
+			/></label
+		>
+		<label
+			>Damping<input type="number" min="0" max="1" step="any" bind:value={options.damping} /></label
+		>
+		<details>
+			<summary>Advanced tolerances</summary>
+			<label
+				>Voltage-change tolerance (V)<input
+					type="number"
+					step="any"
+					bind:value={options.tolerance}
+				/></label
+			>
+			<label
+				>Zero-voltage tolerance (V)<input
+					type="number"
+					step="any"
+					bind:value={options.zero_voltage_tolerance}
+				/></label
+			>
+			<label
+				>Absolute KCL tolerance (A)<input
+					type="number"
+					step="any"
+					bind:value={options.absolute_kcl_tolerance}
+				/></label
+			>
+			<label
+				>Relative KCL tolerance<input
+					type="number"
+					step="any"
+					bind:value={options.relative_kcl_tolerance}
+				/></label
+			>
+		</details>
+	</fieldset>
+	{#if validation}<p role="alert">{validation}</p>{/if}
+	{#if failure}<p role="alert">{failure}</p>{/if}
+	<div class="actions">
+		{#if onapply}<button disabled={disabled || !!validation} onclick={() => void apply()}
+				>Apply settings and run</button
+			>{/if}
+		<button
+			{disabled}
+			onclick={() => {
+				options = { ...DEFAULT_MC_PF_OPTIONS };
+				failure = '';
+			}}>Restore defaults</button
+		>
+	</div>
+</details>
+
+<style>
+	.settings {
+		margin: 0.75rem 0;
+		font-size: 12px;
+	}
+	summary {
+		cursor: pointer;
+		font-weight: 600;
+	}
+	fieldset {
+		margin: 0.75rem 0;
+		border: 1px solid var(--line);
+		border-radius: 4px;
+	}
+	label {
+		display: flex;
+		align-items: center;
+		justify-content: space-between;
+		gap: 0.5rem;
+		margin: 0.5rem 0;
+	}
+	input[type='number'] {
+		width: 7rem;
+		min-width: 0;
+	}
+	.toggle {
+		justify-content: flex-start;
+	}
+	p {
+		line-height: 1.5;
+	}
+	.actions {
+		display: flex;
+		flex-wrap: wrap;
+		gap: 0.5rem;
+	}
+	[role='alert'] {
+		color: var(--text-primary);
+		border-left: 3px solid #b7791f;
+		padding-left: 0.5rem;
+	}
+</style>

package/dist/components/McPfSettings.svelte.d.ts

@@ -0,0 +1,9 @@
+import { type McPfOptions } from '@tellegen/engine';
+type $$ComponentProps = {
+    options: McPfOptions;
+    disabled?: boolean;
+    onapply?: (options: McPfOptions) => Promise<unknown>;
+};
+declare const McPfSettings: import("svelte").Component<$$ComponentProps, {}, "options">;
+type McPfSettings = ReturnType<typeof McPfSettings>;
+export default McPfSettings;

package/dist/components/McResults.svelte

@@ -1,4 +1,6 @@
 <script lang="ts">
+	import McNetworkScope from './McNetworkScope.svelte';
+	import McModelQualification from './McModelQualification.svelte';
 	import {
 		mcPfResultDetail,
 		summarizeMcPfResult,
@@ -13,6 +15,7 @@
 	import type { McEditTiming } from '../state.svelte.js';
 	let {
 		result,
+		excludedIslands = [],
 		detail,
 		timing = null,
 		elapsedMs,
@@ -22,6 +25,7 @@
 	}: {
 		/** A live session's summary, or a stored full result. */
 		result: McPfSummary | McPfResult;
+		excludedIslands?: import('@tellegen/engine').McExcludedIsland[];
 		/** Fetches one bus's terminals and a page of equipment ports. A full
 		 * `result` serves its own pages when this is omitted. */
 		detail?: (query: McPfDetailQuery) => Promise<McPfDetail | null>;
@@ -120,6 +124,11 @@
 </script>
 
 <section aria-label="AC power flow results" class="mc-results">
+	<McNetworkScope
+		scope={summary.network_scope}
+		islands={'excluded_islands' in result ? result.excluded_islands : excludedIslands}
+	/>
+	<McModelQualification model={summary.load_model} />
 	<div class="result-heading">
 		<strong>AC power flow</strong><span
 			>{summary.iterations} iterations{elapsedMs === null
@@ -133,7 +142,7 @@
 			<dd>{summary.converged ? 'Converged' : 'Not converged'}</dd>
 		</div>
 		<div>
-			<dt>Voltage band</dt>
+			<dt>Load-model voltage band</dt>
 			<dd>{summary.voltage_valid ? 'Valid' : `${summary.voltage_violation_count} violations`}</dd>
 		</div>
 		<div>
@@ -165,6 +174,12 @@
 				>{/each}</select
 		></label
 	>
+	{#if excludedIslands.some((island) => island.buses.includes(busId ?? ''))}
+		<p role="status">
+			This bus is excluded from the calculation because its island has no voltage source. No result
+			is available.
+		</p>
+	{/if}
 	<label class="search"
 		>Terminals<input
 			aria-label="Find terminal"

package/dist/components/McResults.svelte.d.ts

@@ -3,6 +3,7 @@ import type { McEditTiming } from '../state.svelte.js';
 type $$ComponentProps = {
     /** A live session's summary, or a stored full result. */
     result: McPfSummary | McPfResult;
+    excludedIslands?: import('@tellegen/engine').McExcludedIsland[];
     /** Fetches one bus's terminals and a page of equipment ports. A full
      * `result` serves its own pages when this is omitted. */
     detail?: (query: McPfDetailQuery) => Promise<McPfDetail | null>;

package/dist/components/McWorkbench.svelte

@@ -206,6 +206,7 @@
 			`Tellegen export ${new Date().toISOString()}`,
 			`Case: ${label}`,
 			`${snapshot.label}; ${snapshot.iterations ?? '?'} iterations`,
+			...(snapshot.provenance ?? []),
 			'P/Q are positive into the equipment at each end; voltages are terminal-pair magnitudes'
 		]);
 		const url = URL.createObjectURL(new Blob([csv], { type: 'text/csv;charset=utf-8' }));
@@ -227,6 +228,7 @@
 				onclick={() => onschematic(!schematic)}>{schematic ? 'Show map' : 'Show diagram'}</button
 			>{/if}
 	</div>
+	{#if snapshot}<p class="result-provenance">{snapshot.label}</p>{/if}
 	<OmniSearch
 		index={search}
 		hint={searchHint}

package/dist/components/MulticonductorDetails.svelte

@@ -1,4 +1,6 @@
 <script lang="ts">
+	import McNetworkScope from './McNetworkScope.svelte';
+	import McModelQualification from './McModelQualification.svelte';
 	import { getAppState, getController } from '../context.svelte.js';
 	import { fmt, rgbaCss } from '../format.js';
 	import {
@@ -10,7 +12,7 @@
 	} from '../multiconductor.js';
 	import { getPanelLayout } from '../panels.svelte.js';
 	import { getNoticeCenter } from '../notices.svelte.js';
-	import { type DistAttachmentKind } from '@tellegen/engine';
+	import { validateMcPfOptions, type DistAttachmentKind } from '@tellegen/engine';
 
 	const app = getAppState();
 	const ctrl = getController();
@@ -50,7 +52,10 @@
 	{#if s}
 		<p class="tag">Multiconductor</p>
 		<details class="case-details">
-			<summary>{s.n_bus} buses, {s.n_edge} {s.n_edge === 1 ? 'branch' : 'branches'}</summary>
+			<summary
+				>{s.n_bus} buses, {s.n_edge}
+				{s.n_edge === 1 ? 'branch' : 'branches'}</summary
+			>
 			<dl>
 				<div>
 					<dt>Buses</dt>
@@ -97,6 +102,15 @@
 				</dd>
 			</div>
 		</dl>
+		<McNetworkScope
+			scope={mc.mcPreparedScope}
+			islands={mc.mcExcludedIslands}
+			preview={!mc.result}
+		/>
+		{#if !mc.mcPfSupported}<p class="footnote">{mc.mcPfReason}</p>{/if}
+		{#if validateMcPfOptions(mc.mcOptions)}<p class="footnote">
+				{validateMcPfOptions(mc.mcOptions)} Update Power flow settings in Studies before solving.
+			</p>{/if}
 		<div class="calculation-actions">
 			{#if mc.solving}
 				<span role="status">Calculating&hellip;</span>{#if mc.solveAbort}<button
@@ -104,13 +118,13 @@
 					>{/if}
 			{:else}
 				<button
-					disabled={!mc.mcPfSupported}
+					disabled={!mc.mcPfSupported || !!validateMcPfOptions(mc.mcOptions)}
 					onclick={() => {
 						void ctrl
-							.solveMultiCase(mc)
+							.solveMultiCase(mc, mc.mcOptions, undefined, mc.mcRequiresEnergizedSolve)
 							.then(openResults)
 							.catch(() => {});
-					}}>Solve AC power flow</button
+					}}>{mc.mcSolveLabel}</button
 				>
 				{#if !mc.mcPfSupported}
 					<button
@@ -125,12 +139,17 @@
 				{/if}
 			{/if}
 		</div>
-		{#if mc.result}<p class="footnote">Converged, {mc.result.iterations} iterations</p>
+		{#if mc.result}<McModelQualification model={mc.result.load_model} compact />
+			<p class="footnote">Converged, {mc.result.iterations} iterations</p>
 			<button class="reset" onclick={openResults}>View results in Studies</button>{/if}
 	{/if}
 
 	{#if mc.selectedBus}
 		{@const b = mc.selectedBus}
+		{#if mc.mcExcludedIslands.some((island) => island.buses.includes(b.id))}<p role="status">
+				This bus belongs to an island with no voltage source and will be excluded from
+				energized-network calculations. No power-flow result is available for it.
+			</p>{/if}
 		<hr />
 		<h3>Bus <span class="mono">{b.id}</span></h3>
 		<div class="terminals">

package/dist/components.d.ts

@@ -25,3 +25,6 @@ export { default as TopMovers } from './components/TopMovers.svelte';
 export { default as Sparkline } from './Sparkline.svelte';
 export { default as McResults } from './components/McResults.svelte';
 export { default as McWorkbench } from './components/McWorkbench.svelte';
+export { default as McPfSettings } from './components/McPfSettings.svelte';
+export { default as McModelQualification } from './components/McModelQualification.svelte';
+export { default as McNetworkScope } from './components/McNetworkScope.svelte';

package/dist/components.js

@@ -25,3 +25,6 @@ export { default as TopMovers } from './components/TopMovers.svelte';
 export { default as Sparkline } from './Sparkline.svelte';
 export { default as McResults } from './components/McResults.svelte';
 export { default as McWorkbench } from './components/McWorkbench.svelte';
+export { default as McPfSettings } from './components/McPfSettings.svelte';
+export { default as McModelQualification } from './components/McModelQualification.svelte';
+export { default as McNetworkScope } from './components/McNetworkScope.svelte';

package/dist/controller.svelte.d.ts

@@ -1,7 +1,7 @@
 import { type TellegenApiClient } from './api.js';
 import type { BranchRatingDeltas, Network, NetworkBus, SensitivityColumn, Solution } from './api.js';
 import { CaseState, LocalCase, MulticonductorCase, type AppState, type DemandRangeMode, type SolvableCase } from './state.svelte.js';
-import { type EngineTransport, type McPfDetail, type McPfDetailQuery, type McPfOptions, type McPfResult, type McPfSummary, type McStudySnapshot, type BrowserStudy, type Formulation, type IngestedCase, type PowerIoDiagnostic, type SensTarget } from '@tellegen/engine';
+import { type EngineTransport, type McPfDetail, type McPfDetailQuery, type McPfOptions, type McPfResult, type McPfResultTables, type McPfSummary, type McStudySnapshot, type BrowserStudy, type Formulation, type IngestedCase, type PowerIoDiagnostic, type SensTarget } from '@tellegen/engine';
 /** A parsed geographic sidecar awaiting application: the canonical `.geo.json`
  * layer document from the engine's tolerant reader, its source file name, and
  * the reader's notes on records it could not use. */
@@ -38,7 +38,7 @@ export interface ControllerOptions {
      * `false`, `load()` only marks the shell loaded and frames the map. */
     loadDefaultCases?: boolean;
     acOpfWasmUrl?: string;
-    mcTransport?: Pick<EngineTransport, 'solveMcModule' | 'applyMcGeo'> & Partial<Pick<EngineTransport, 'solveMcStudy' | 'applyMcStudyGeo' | 'createMcPfSession'>>;
+    mcTransport?: Pick<EngineTransport, 'solveMcModule' | 'applyMcGeo'> & Partial<Pick<EngineTransport, 'solveMcStudy' | 'applyMcStudyGeo' | 'createMcPfSession' | 'prepareMcEnergizedNetwork'>>;
 }
 /** Input to `Controller.openBalancedModule` and `replaceLocalCase`: a
  * balanced (transmission) powerio module, either as its JSON text or as the
@@ -66,7 +66,7 @@ export declare class Controller {
      * server path then reports "compute off" instead of fetching. */
     api: TellegenApiClient | null;
     readonly loadDefaultCases: boolean;
-    mcTransport: Pick<EngineTransport, 'solveMcModule' | 'applyMcGeo'> & Partial<Pick<EngineTransport, 'solveMcStudy' | 'applyMcStudyGeo' | 'createMcPfSession'>>;
+    mcTransport: Pick<EngineTransport, 'solveMcModule' | 'applyMcGeo'> & Partial<Pick<EngineTransport, 'solveMcStudy' | 'applyMcStudyGeo' | 'createMcPfSession' | 'prepareMcEnergizedNetwork'>>;
     abort: AbortController | null;
     sensitivity429Until: number;
     serverComputeOff: boolean;
@@ -359,7 +359,7 @@ export declare class Controller {
     /** Retain parsed electrical inputs and draw each declared coordinate space directly. */
     private addMultiCase;
     /** Compute terminal quantities only for the retained input and current case revision. */
-    solveMultiCase: (c: MulticonductorCase, options?: McPfOptions, signal?: AbortSignal) => Promise<McPfSummary>;
+    solveMultiCase: (c: MulticonductorCase, options?: McPfOptions, signal?: AbortSignal, energizedOnly?: boolean) => Promise<McPfSummary>;
     /** Materialize the current retained operating point only when a portable
      * snapshot is actually needed (save/export/geography). */
     snapshotMultiCase: (c: MulticonductorCase) => Promise<McStudySnapshot>;
@@ -368,7 +368,7 @@ export declare class Controller {
      * when the operating point changed before the page arrived. */
     multiResultDetail: (c: MulticonductorCase, query: McPfDetailQuery) => Promise<McPfDetail | null>;
     /** Above this many buses, reading and indexing the whole operating point takes a noticeable
-     * fraction of a second (evidence/diagram), so the overview is computed on request instead of
+     * fraction of a second (docs/evidence/diagram), so the overview is computed on request instead of
      * after every solve. */
     static readonly AUTO_OVERVIEW_MAX_BUSES = 25000;
     private overviewSeq;
@@ -382,6 +382,10 @@ export declare class Controller {
      * for a case that computes the overview on request. Call from an effect that tracks the case's
      * `result` and `mcFullResult`; the returned function cancels a pending read. */
     followOverview: (c: MulticonductorCase | null) => (() => void) | undefined;
+    /** The complete operating point in the form whole-network views read: the stored result, or
+     * the live session's as columns, which hold no object per terminal or port. Null when there is
+     * no result or it changed before the read finished. */
+    multiOverviewResult: (c: MulticonductorCase) => Promise<McPfResult | McPfResultTables | null>;
     /** The complete operating point for whole-network views: the stored result, or one read from
      * the live session. Null when there is no result or it changed before the read finished. */
     multiFullResult: (c: MulticonductorCase) => Promise<McPfResult | null>;

package/dist/controller.svelte.js

@@ -7,7 +7,7 @@ import { powerIoEntry, solveEntry } from './log.svelte.js';
 import { distExtensionFormat, isGeoFileName } from './drop-classify.js';
 import { DropBatchGate, readDropFileBytes, validateDropBatch } from './drop-limits.js';
 import { buildGeographicView, buildDiagramView, placeMultiView } from './multiconductor.js';
-import { browserWasmTransport, applyDisplayGeo, applyGeo, applyLayout, createStudy, extractGeo, FORMULATIONS, formatPowerIoDiagnostic, formatOf, ingestCase, ingestDistCaseBytes, ingestJsonDrop, isDisplayFile, isPermanentEngineFailure, parseDisplay, parseGeo, probeAcOpfWorker, solveAcOpfModule, solveResponseToSolution, mcPfResultDetail, summarizeMcPfResult } from '@tellegen/engine';
+import { browserWasmTransport, applyDisplayGeo, applyGeo, applyLayout, createStudy, extractGeo, FORMULATIONS, formatPowerIoDiagnostic, formatOf, ingestCase, ingestDistCaseBytes, ingestJsonDrop, isDisplayFile, isPermanentEngineFailure, parseDisplay, parseGeo, probeAcOpfWorker, solveAcOpfModule, solveResponseToSolution, mcPfResultDetail, summarizeMcPfResult, validateMcPfOptions, DEFAULT_MC_PF_OPTIONS } from '@tellegen/engine';
 import { browserSolveFailure, errorText, extent, formulationLabel, rgbaCss } from './format.js';
 import { DEAD_ZONE_MW } from './slider.js';
 const HIDDEN_DEFAULT_CASES_KEY = 'tellegen.hiddenDefaultCases.v1';
@@ -18,6 +18,15 @@ function localHasBus(c, busId) {
     const buses = c.view?.buses ?? c.diagram?.view.buses ?? c.topology?.buses ?? [];
     return buses.some((b) => b.id === busId);
 }
+/** Free a case input the engine keeps; text needs no release. */
+function releaseMcInput(input) {
+    if (input && typeof input !== 'string')
+        input.free();
+}
+/** PowerIO IR text for a case input, built by the engine for a kept module. */
+function mcInputJson(input) {
+    return typeof input === 'string' ? Promise.resolve(input) : input.moduleJson();
+}
 /** Terminal copy when nothing can solve. Two facts decide the wording: whether
  * this browser's engine failure is known permanent, and that the server
  * declines compute. */
@@ -410,6 +419,8 @@ export class Controller {
             c.mcEditTimer = null;
             c.mcSession?.free();
             c.mcSession = null;
+            releaseMcInput(c.mcInput);
+            c.mcInput = null;
         }
     }
     // Release a case's Study (if any) when the case is removed.
@@ -2189,7 +2200,9 @@ export class Controller {
         }
         this.app.parsingFile = true;
         try {
-            const result = await ingestJsonDrop(bytes);
+            // A multiconductor module stays in the engine; only its handle
+            // comes back, never its IR text.
+            const result = await ingestJsonDrop(bytes, { retain: true });
             if (result.kind === 'unknown')
                 return { outcome: 'unrouted', bytes };
             if (result.kind === 'ambiguous') {
@@ -2229,7 +2242,7 @@ export class Controller {
         this.app.parsingFile = true;
         try {
             const bytes = new Uint8Array(await file.arrayBuffer());
-            this.addMultiCase(file.name, await ingestDistCaseBytes(bytes, format));
+            this.addMultiCase(file.name, await ingestDistCaseBytes(bytes, format, { retain: true }));
             this.app.error = null;
             return true;
         }
@@ -2243,7 +2256,7 @@ export class Controller {
     };
     /** Retain parsed electrical inputs and draw each declared coordinate space directly. */
     addMultiCase(fileName, payload) {
-        const { graph, ...summary } = payload;
+        const { graph, input, ...summary } = payload;
         const coordsKind = payload.coords_kind;
         const label = summary.name && summary.name !== 'case' ? summary.name : fileName.replace(/\.[^.]+$/, '');
         const view = coordsKind === 'geographic'
@@ -2255,6 +2268,7 @@ export class Controller {
             label,
             fileName,
             summary,
+            input,
             graph,
             coordsKind,
             view
@@ -2267,17 +2281,24 @@ export class Controller {
         return c;
     }
     /** Compute terminal quantities only for the retained input and current case revision. */
-    solveMultiCase = async (c, options = {}, signal) => {
+    solveMultiCase = async (c, options = c.mcOptions, signal, energizedOnly = c.mcEnergizedOnly) => {
         if (signal?.aborted || this.disposed)
             throw new DOMException('Calculation cancelled', 'AbortError');
         if (c.solving)
             throw new Error('A calculation is already running for this case');
+        options = { ...DEFAULT_MC_PF_OPTIONS, ...c.mcOptions, ...options };
+        const settingsError = validateMcPfOptions(options);
+        if (settingsError)
+            throw new Error(settingsError);
+        c.mcOptions = { ...options };
+        c.mcEnergizedOnly = energizedOnly;
         const unavailable = c.mcPfReason;
         if (unavailable) {
             this.app.error = unavailable;
             throw new Error(unavailable);
         }
-        let input = c.moduleJson;
+        const originalInput = c.mcInput;
+        let input = originalInput;
         const retainedAtStart = c.mcSession;
         const revision = c.revisionGeneration;
         const seq = ++c.solveSeq;
@@ -2289,9 +2310,27 @@ export class Controller {
         this.app.error = null;
         const started = performance.now();
         let nextSession = null;
+        // An input this call took from the live session; freed unless it
+        // becomes the case's input.
+        let editedInput = null;
         try {
+            // The edited operating point stays in the engine; it is never
+            // written out as IR text to be read back.
             if (retainedAtStart)
-                input = await retainedAtStart.inputModule();
+                input = editedInput = await retainedAtStart.input();
+            if (energizedOnly) {
+                if (!this.mcTransport.prepareMcEnergizedNetwork)
+                    throw new Error('Energized-network preparation is unavailable');
+                const prepared = await this.mcTransport.prepareMcEnergizedNetwork(input);
+                const selectedInput = 'input' in prepared ? prepared.input : prepared.module_json;
+                if (editedInput !== selectedInput)
+                    releaseMcInput(editedInput);
+                input = editedInput = selectedInput;
+                if (abort.signal.aborted || seq !== c.solveSeq || revision !== c.revisionGeneration)
+                    throw new DOMException('Calculation cancelled', 'AbortError');
+                c.mcExcludedIslands = prepared.excluded_islands;
+                c.mcPreparedScope = prepared.network_scope;
+            }
             let snapshot = null;
             let result;
             let fullResult = null;
@@ -2304,18 +2343,19 @@ export class Controller {
                 loadBranches = await nextSession.loadBranches();
             }
             else {
+                const text = typeof input === 'string' ? input : await input.moduleJson();
                 snapshot = this.mcTransport.solveMcStudy
-                    ? await this.mcTransport.solveMcStudy(input, crypto.randomUUID(), c.label, options, abort.signal)
+                    ? await this.mcTransport.solveMcStudy(text, crypto.randomUUID(), c.label, options, abort.signal)
                     : null;
                 fullResult =
-                    snapshot?.result ?? (await this.mcTransport.solveMcModule(input, options, abort.signal));
+                    snapshot?.result ?? (await this.mcTransport.solveMcModule(text, options, abort.signal));
                 result = summarizeMcPfResult(fullResult);
             }
             // dispose() aborts too; a session that arrives after it is freed below.
             if (abort.signal.aborted || this.disposed)
                 throw new DOMException('Calculation cancelled', 'AbortError');
             if (seq !== c.solveSeq ||
-                (retainedAtStart ? retainedAtStart !== c.mcSession : input !== c.moduleJson) ||
+                (retainedAtStart ? retainedAtStart !== c.mcSession : originalInput !== c.mcInput) ||
                 revision !== c.revisionGeneration ||
                 !this.app.multiCases.includes(c))
                 throw new Error('The case changed while calculating. Run AC power flow again');
@@ -2332,7 +2372,10 @@ export class Controller {
             nextSession = null;
             c.mcLoadBranches = loadBranches;
             c.mcLoadEdits = [];
-            c.moduleJson = input;
+            if (c.mcInput !== input)
+                releaseMcInput(c.mcInput);
+            c.mcInput = input;
+            editedInput = null;
             c.result = result;
             c.mcFullResult = fullResult;
             c.mcTiming = null;
@@ -2340,10 +2383,12 @@ export class Controller {
             c.mcSavedAt = null;
             c.solveMs = performance.now() - started;
             c.revisionGeneration++;
+            c.mcCompletedSolveSeq = seq;
             return result;
         }
         catch (error) {
             nextSession?.free();
+            releaseMcInput(editedInput);
             if (!abort.signal.aborted &&
                 !(error instanceof DOMException && error.name === 'AbortError')) {
                 this.app.error = errorText(error);
@@ -2398,7 +2443,7 @@ export class Controller {
         return full ? mcPfResultDetail(full, query, summary.solve_count) : null;
     };
     /** Above this many buses, reading and indexing the whole operating point takes a noticeable
-     * fraction of a second (evidence/diagram), so the overview is computed on request instead of
+     * fraction of a second (docs/evidence/diagram), so the overview is computed on request instead of
      * after every solve. */
     static AUTO_OVERVIEW_MAX_BUSES = 25_000;
     overviewSeq = 0;
@@ -2409,7 +2454,7 @@ export class Controller {
     readOverview = (c) => this.startOverviewRead(c, ++this.overviewSeq);
     startOverviewRead(c, seq) {
         c.overviewLoading = true;
-        this.multiFullResult(c).then((full) => {
+        this.multiOverviewResult(c).then((full) => {
             if (seq !== this.overviewSeq)
                 return;
             if (full)
@@ -2440,6 +2485,22 @@ export class Controller {
             c.overviewLoading = false;
         };
     };
+    /** The complete operating point in the form whole-network views read: the stored result, or
+     * the live session's as columns, which hold no object per terminal or port. Null when there is
+     * no result or it changed before the read finished. */
+    multiOverviewResult = async (c) => {
+        if (!c.result)
+            return null;
+        const stored = c.mcFullResult ?? c.mcSnapshot?.result ?? null;
+        const session = c.mcSession;
+        if (stored || !session)
+            return stored;
+        if (c.mcEditRunning)
+            return null;
+        const solve = c.result.solve_count;
+        const tables = await session.resultTables();
+        return session === c.mcSession && c.result?.solve_count === solve ? tables : null;
+    };
     /** The complete operating point for whole-network views: the stored result, or one read from
      * the live session. Null when there is no result or it changed before the read finished. */
     multiFullResult = async (c) => {
@@ -2500,14 +2561,15 @@ export class Controller {
             throw new Error('Select the matching case before attaching coordinates');
         if (c.solving)
             throw new Error('Wait for the calculation before attaching coordinates');
-        if (!c.moduleJson || !this.mcTransport.applyMcGeo)
+        if (!c.mcInput || !this.mcTransport.applyMcGeo)
             throw new Error('Coordinate attachment is unavailable for this case');
-        const baseInput = c.moduleJson;
+        const baseInput = c.mcInput;
         const retainedAtStart = c.mcSession;
         let snapshot = c.mcSnapshot;
         if (!snapshot && c.mcSession && c.result)
             snapshot = await this.snapshotMultiCase(c);
-        const input = snapshot?.input_module ?? c.moduleJson;
+        // Coordinates attach to IR text, so a kept module is written out here.
+        const input = snapshot?.input_module ?? (await mcInputJson(baseInput));
         const revision = c.revisionGeneration;
         let next = input;
         let payload;
@@ -2531,7 +2593,7 @@ export class Controller {
             throw new Error('No coordinates matched the selected case');
         if (this.app.studyView ||
             this.app.activeMulti !== c ||
-            c.moduleJson !== baseInput ||
+            c.mcInput !== baseInput ||
             c.mcSession !== retainedAtStart ||
             c.revisionGeneration !== revision ||
             c.solving)
@@ -2547,7 +2609,8 @@ export class Controller {
         c.mcFullResult = snapshot?.result ?? c.mcFullResult;
         c.mcLoadBranches = [];
         c.mcLoadEdits = [];
-        c.moduleJson = next;
+        releaseMcInput(c.mcInput);
+        c.mcInput = next;
         c.mcSnapshot = snapshot ? { ...snapshot, id: crypto.randomUUID() } : null;
         c.mcSavedAt = null;
         c.geoLayer = payload.geo_layer ?? null;
@@ -2727,6 +2790,8 @@ export class Controller {
             clearTimeout(c.mcEditTimer);
         c.mcSession?.free();
         c.mcSession = null;
+        releaseMcInput(c.mcInput);
+        c.mcInput = null;
         if (this.app.activeMultiId === c.id) {
             c.selectedBusId = null;
             c.selectedEdgeId = null;