@tellegen/svelte 0.4.7 → 0.5.0

package/dist/components/DiagramCanvas.svelte

@@ -1,4 +1,5 @@
 <script lang="ts">
+	import { mcNetworkScopeLabel, mcLoadModelLabel } from '@tellegen/engine';
 	import { untrack } from 'svelte';
 	import { on } from 'svelte/events';
 	import type { Network, NetworkBus } from '../api.js';
@@ -395,7 +396,10 @@
 			>
 		</div>
 	</div>
-	<p class="coordinate-label">Diagram coordinates</p>
+	<p class="coordinate-label">
+		Diagram coordinates{#if multiconductor?.result}
+			· {mcLoadModelLabel(multiconductor.result.load_model)} · {mcNetworkScopeLabel(multiconductor.result.network_scope)}{/if}
+	</p>
 </div>
 
 <style>

package/dist/components/McModelQualification.svelte

@@ -0,0 +1,67 @@
+<script lang="ts">
+	import { mcLoadModelLabel, type McLoadModelAssessment } from '@tellegen/engine';
+	let { model, compact = false }: { model?: McLoadModelAssessment | null; compact?: boolean } =
+		$props();
+</script>
+
+<aside class:warning={model?.status !== 'original'} aria-label="Load-model qualification">
+	<strong>{mcLoadModelLabel(model)}</strong>
+	{#if model?.status === 'modified'}
+		<p>
+			The calculation converged using modified load equations on {model.modified_branch_count}
+			load {model.modified_branch_count === 1 ? 'branch' : 'branches'}. These values are not a
+			verified solution of the original load model. The qualification is retained when saving or
+			exporting.
+		</p>
+	{:else if model?.status !== 'original'}
+		<p>
+			These results have no verified solution of the original load equations. Rerun to assess the
+			load model.
+		</p>
+	{/if}
+	{#if model && !compact}
+		<details>
+			<summary>Model assessment and settings used</summary>
+			<p>
+				Original-model KCL residual: {model.original_kcl_residual === null
+					? 'undefined at this voltage'
+					: `${model.original_kcl_residual.toExponential(3)} A`}. Scaled residual: {model.original_scaled_kcl_residual ===
+				null
+					? 'unavailable'
+					: model.original_scaled_kcl_residual.toPrecision(4)} (at most 1 passes).
+			</p>
+			<p>
+				Load-model envelope {model.options.voltage_envelope ? 'enabled' : 'disabled'}; Vlow {model
+					.options.v_low_pu}, Vmin {model.options.v_min_pu}, Vmax {model.options.v_max_pu} pu. These thresholds
+				change load equations; they are not operating voltage limits.
+			</p>
+			<p>
+				Maximum iterations {model.options.max_iterations}; damping {model.options.damping};
+				voltage-change tolerance {model.options.tolerance} V; zero-voltage tolerance {model.options
+					.zero_voltage_tolerance} V; KCL tolerances {model.options.absolute_kcl_tolerance} A absolute
+				and {model.options.relative_kcl_tolerance} relative.
+			</p>
+		</details>
+	{/if}
+</aside>
+
+<style>
+	aside {
+		margin: 0.75rem 0;
+		padding: 0.65rem;
+		border: 1px solid var(--line);
+		border-radius: 4px;
+		font-size: 12px;
+	}
+	.warning {
+		border-left: 4px solid #b7791f;
+	}
+	p {
+		margin: 0.4rem 0;
+		line-height: 1.5;
+	}
+	summary {
+		cursor: pointer;
+		margin-top: 0.4rem;
+	}
+</style>

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

@@ -0,0 +1,8 @@
+import { type McLoadModelAssessment } from '@tellegen/engine';
+type $$ComponentProps = {
+    model?: McLoadModelAssessment | null;
+    compact?: boolean;
+};
+declare const McModelQualification: import("svelte").Component<$$ComponentProps, {}, "">;
+type McModelQualification = ReturnType<typeof McModelQualification>;
+export default McModelQualification;

package/dist/components/McNetworkScope.svelte

@@ -0,0 +1,90 @@
+<script lang="ts">
+	import {
+		mcNetworkScopeLabel,
+		type McNetworkScope as NetworkScope,
+		type McExcludedIsland
+	} from '@tellegen/engine';
+	let {
+		scope,
+		islands = [],
+		preview = false
+	}: {
+		scope?: NetworkScope | null;
+		islands?: McExcludedIsland[];
+		preview?: boolean;
+	} = $props();
+</script>
+
+{#if scope}
+	<aside aria-label="Network calculation scope">
+		<strong>{preview ? 'Unpowered islands detected' : mcNetworkScopeLabel(scope)}</strong>
+		{#if preview}<p>
+				{scope.excluded_island_count}
+				{scope.excluded_island_count === 1 ? 'island has' : 'islands have'} no voltage source.
+			</p>{/if}
+		<p>
+			{scope.excluded_bus_count}
+			{scope.excluded_bus_count === 1 ? 'bus' : 'buses'} and {scope.excluded_equipment_count}
+			equipment
+			{scope.excluded_equipment_count === 1 ? 'record' : 'records'}
+			{preview
+				? 'will be excluded when you solve the energized network'
+				: 'are excluded from the calculation'}
+			because their {scope.excluded_island_count === 1 ? 'island has' : 'islands have'} no voltage source.
+			The full network remains available for inspection. Excluded equipment has no calculated result;
+			its voltage and power are not reported as zero.
+		</p>
+		{#if scope.excluded_load_count}<p>
+				{scope.excluded_load_count}
+				{scope.excluded_load_count === 1 ? 'load has' : 'loads have'} no voltage source and {preview
+					? 'will be omitted'
+					: scope.excluded_load_count === 1
+						? 'is absent'
+						: 'are absent'} from solved totals.
+			</p>{/if}
+		{#if islands.length}
+			<details>
+				<summary
+					>{preview
+						? 'Islands and equipment to exclude'
+						: 'Excluded islands and equipment'}</summary
+				>
+				{#each islands as island, i}
+					<h4>Island {i + 1}: no voltage source</h4>
+					<p>Buses: {island.buses.join(', ')}</p>
+					<ul>
+						{#each island.equipment as item}<li>
+								{item.kind}: {item.name}
+							</li>{/each}
+					</ul>
+				{/each}
+			</details>
+		{/if}
+	</aside>
+{/if}
+
+<style>
+	aside {
+		margin: 0.75rem 0;
+		padding: 0.65rem;
+		border: 1px solid var(--line);
+		border-left: 4px solid #b7791f;
+		border-radius: 4px;
+		font-size: 12px;
+		overflow-wrap: anywhere;
+	}
+	p {
+		margin: 0.4rem 0;
+		line-height: 1.5;
+	}
+	summary {
+		cursor: pointer;
+	}
+	details {
+		max-height: 20rem;
+		overflow: auto;
+	}
+	h4 {
+		margin: 0.75rem 0 0.25rem;
+	}
+</style>

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

@@ -0,0 +1,9 @@
+import { type McNetworkScope as NetworkScope, type McExcludedIsland } from '@tellegen/engine';
+type $$ComponentProps = {
+    scope?: NetworkScope | null;
+    islands?: McExcludedIsland[];
+    preview?: boolean;
+};
+declare const McNetworkScope: import("svelte").Component<$$ComponentProps, {}, "">;
+type McNetworkScope = ReturnType<typeof McNetworkScope>;
+export default McNetworkScope;

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>;