@tellegen/svelte 0.4.7 → 0.5.0

package/dist/state.svelte.d.ts

@@ -1,5 +1,5 @@
 import type { CaseSummary, DemandDeltas, Network, NetworkBranch, NetworkBus, SensitivityColumn, Solution, SolveIteration } from './api.js';
-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 StudyView, type BranchRatingDeltas, type BrowserMcPfSession, type CaseFileSummary, type DistGraph, type Formulation, type IngestedDistCase, type McPfCallTiming, type McPfOptions, type McPfResult, type McPfResultTables, type McPfSummary, type McLoadBranchState, type McLoadPowerEdit, type McModuleInput, type McStudySnapshot, type SensTarget, type Topology } from '@tellegen/engine';
 import type { MultiView } from './multiconductor.js';
 import { DiagnosticLog } from './log.svelte.js';
 import { type GraphInputs } from './diagram/graph-inputs.js';
@@ -181,9 +181,10 @@ 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 diagnostics. */
-export type MultiCaseSummary = Omit<IngestedDistCase, 'graph'>;
+/** The multiconductor ingest payload without the graph or the retained
+ * input: the summary counts, connected load/generation, coordinate
+ * provenance, and diagnostics. */
+export type MultiCaseSummary = Omit<IngestedDistCase, 'graph' | 'input'>;
 /** Geographic coordinates use the map; other positions use the diagram canvas. */
 export type MultiCoordsKind = 'geographic' | 'planar' | 'synthetic';
 /** Where one interactive load edit spent its time, in milliseconds: engine
@@ -197,7 +198,10 @@ export declare class MulticonductorCase {
     readonly id: string;
     readonly label: string;
     readonly fileName: string;
-    moduleJson: string | null;
+    /** The electrical input calculations start from: the module the engine
+     * keeps from the import, or PowerIO IR text (a saved or re-placed module).
+     * A kept module is freed when it is replaced or the case is removed. */
+    mcInput: McModuleInput | null;
     geoLayer: string | null;
     geoWarnings: string[];
     /** Summary of the displayed operating point: from the live session after
@@ -208,6 +212,15 @@ export declare class MulticonductorCase {
     mcFullResult: McPfResult | null;
     /** Latency breakdown of the latest load-edit solve. */
     mcTiming: McEditTiming | null;
+    /** Explicit selection for the next solve. The graph and module retain every bus. */
+    mcEnergizedOnly: boolean;
+    /** Successful explicit solve to reveal in Studies; load edits do not advance it. */
+    mcCompletedSolveSeq: number;
+    /** Detected on import, revalidated when preparing a solve; never removed from the graph. */
+    mcExcludedIslands: import('@tellegen/engine').McExcludedIsland[];
+    mcPreparedScope: import('@tellegen/engine').McNetworkScope | null;
+    /** Selected settings for the next explicit solve; results carry their own effective settings. */
+    mcOptions: McPfOptions;
     mcSnapshot: McStudySnapshot | null;
     mcSession: BrowserMcPfSession | null;
     mcLoadBranches: McLoadBranchState[];
@@ -248,9 +261,10 @@ export declare class MulticonductorCase {
     /** Bumped to ask the views to bring the current selection into view again (an issue clicked
      * that is already selected). */
     revealSeq: number;
-    /** The full operating point read for whole-network views (overview, schematic); null until read,
-     * and cleared when a large case's operating point changes. */
-    overviewResult: McPfResult | null;
+    /** The full operating point read for whole-network views (overview, schematic): a stored
+     * result, or a live session's as columns. Null until read, and cleared when a large case's
+     * operating point changes. */
+    overviewResult: McPfResult | McPfResultTables | null;
     overviewLoading: boolean;
     /** The graph's buses and branches as the overview and the diagram read them: rebuilt when the
      * graph is replaced, never after a solve. Both views read this one copy. */
@@ -270,11 +284,17 @@ export declare class MulticonductorCase {
         label: string;
         fileName: string;
         summary: MultiCaseSummary;
+        /** The module the engine kept from the import, in place of the
+         * summary's `module_json`. */
+        input?: McModuleInput | null;
         graph: DistGraph;
         coordsKind: MultiCoordsKind;
         view?: MultiView | null;
     });
     get mcPfReason(): string | null;
+    /** Import detects scope; only a solve action opts into the selection. */
+    get mcRequiresEnergizedSolve(): boolean;
+    get mcSolveLabel(): string;
     get mcPfSupported(): boolean;
     /** Whether the case is placed and ready to render. */
     get placed(): boolean;

package/dist/state.svelte.js

@@ -1,3 +1,4 @@
+import { DEFAULT_MC_PF_OPTIONS, summarizeMcExcludedIslands } from '@tellegen/engine';
 import { DEFAULT_FORMULATION } from '@tellegen/engine';
 import { DiagnosticLog, errorEntry } from './log.svelte.js';
 import { graphInputs } from './diagram/graph-inputs.js';
@@ -127,7 +128,10 @@ export class MulticonductorCase {
     id;
     label;
     fileName;
-    moduleJson = $state.raw(null);
+    /** The electrical input calculations start from: the module the engine
+     * keeps from the import, or PowerIO IR text (a saved or re-placed module).
+     * A kept module is freed when it is replaced or the case is removed. */
+    mcInput = $state.raw(null);
     geoLayer = $state.raw(null);
     geoWarnings = $state.raw([]);
     /** Summary of the displayed operating point: from the live session after
@@ -138,6 +142,15 @@ export class MulticonductorCase {
     mcFullResult = $state.raw(null);
     /** Latency breakdown of the latest load-edit solve. */
     mcTiming = $state.raw(null);
+    /** Explicit selection for the next solve. The graph and module retain every bus. */
+    mcEnergizedOnly = $state(false);
+    /** Successful explicit solve to reveal in Studies; load edits do not advance it. */
+    mcCompletedSolveSeq = $state(0);
+    /** Detected on import, revalidated when preparing a solve; never removed from the graph. */
+    mcExcludedIslands = $state.raw([]);
+    mcPreparedScope = $state.raw(null);
+    /** Selected settings for the next explicit solve; results carry their own effective settings. */
+    mcOptions = $state({ ...DEFAULT_MC_PF_OPTIONS });
     mcSnapshot = $state.raw(null);
     mcSession = $state.raw(null);
     mcLoadBranches = $state.raw([]);
@@ -172,8 +185,9 @@ export class MulticonductorCase {
     /** Bumped to ask the views to bring the current selection into view again (an issue clicked
      * that is already selected). */
     revealSeq = $state(0);
-    /** The full operating point read for whole-network views (overview, schematic); null until read,
-     * and cleared when a large case's operating point changes. */
+    /** The full operating point read for whole-network views (overview, schematic): a stored
+     * result, or a live session's as columns. Null until read, and cleared when a large case's
+     * operating point changes. */
     overviewResult = $state.raw(null);
     overviewLoading = $state(false);
     /** The graph's buses and branches as the overview and the diagram read them: rebuilt when the
@@ -196,14 +210,17 @@ export class MulticonductorCase {
         this.label = init.label;
         this.fileName = init.fileName;
         this.summary = init.summary;
-        this.moduleJson = init.summary.module_json ?? null;
+        this.mcInput = init.input ?? init.summary.module_json ?? null;
+        this.mcEnergizedOnly = init.summary.mc_energized_only ?? false;
+        this.mcExcludedIslands = init.summary.mc_excluded_islands ?? [];
+        this.mcPreparedScope = summarizeMcExcludedIslands(this.mcExcludedIslands);
         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)
+        if (!this.mcInput)
             return 'This case has no retained electrical input';
         if (this.summary?.mc_pf_enabled !== true)
             return 'AC power flow is unavailable in this build';
@@ -211,6 +228,13 @@ export class MulticonductorCase {
             this.summary.mc_pf_unavailable_reason ??
             (this.summary.mc_pf_supported !== true ? 'AC power flow is unavailable for this case' : null));
     }
+    /** Import detects scope; only a solve action opts into the selection. */
+    get mcRequiresEnergizedSolve() {
+        return this.mcExcludedIslands.length > 0;
+    }
+    get mcSolveLabel() {
+        return this.mcRequiresEnergizedSolve ? 'Solve energized network' : 'Run power flow';
+    }
     get mcPfSupported() {
         return this.mcPfReason === null;
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tellegen/svelte",
-  "version": "0.4.7",
+  "version": "0.5.0",
   "description": "Svelte components for tellegen power system maps, local case files, and browser solves.",
   "keywords": [
     "svelte",
@@ -67,7 +67,7 @@
     "pack:dry-run": "npm pack --dry-run --cache ../../node_modules/.cache/npm-pack"
   },
   "dependencies": {
-    "@tellegen/engine": "^0.4.6"
+    "@tellegen/engine": "^0.5.0"
   },
   "peerDependencies": {
     "@deck.gl/core": "^9.4.0",