@tellegen/svelte 0.4.1 → 0.4.2

package/dist/controller.svelte.d.ts

@@ -83,6 +83,7 @@ export declare class Controller {
     localSeq: number;
     loading: Promise<void> | null;
     private readonly dropBatchGate;
+    disposed: boolean;
     nearbyRangeAnchor: DemandRangeAnchor | null;
     hiddenDefaults: Set<string>;
     casesLoaded: boolean;
@@ -129,6 +130,12 @@ export declare class Controller {
     maybeStartLocalSolve(id: string): void;
     getStudy(c: SolvableCase, studyInputJson: string): Promise<BrowserStudy | null>;
     browserSensitivity(c: SolvableCase, studyInputJson: string, target: SensTarget): Promise<SensitivityColumn | null>;
+    /** Release every engine handle this controller holds: each case's browser
+     * Study, including one still being built, and each multiconductor
+     * session, with their pending edits and in-flight requests.
+     * `TellegenProvider` calls it when it unmounts; the controller builds no
+     * Study and keeps no new session afterwards. */
+    dispose(): void;
     disposeStudy(c: SolvableCase): void;
     acceptSensitivity(c: SolvableCase, col: SensitivityColumn | null, target: SensTarget | null, sensitivitySeq?: number): void;
     finishSolve(c: SolvableCase, seq: number, target: SensTarget | null): void;

package/dist/controller.svelte.js

@@ -19,10 +19,9 @@ function localHasBus(c, busId) {
 }
 /** 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. Server compute exists in the codebase but ships disabled;
- * interest routes to email until it is offered. */
-const WASM_REQUIRED_NOTICE = 'this browser cannot run the WebAssembly engine that solves locally, and server side compute is disabled in this demo. it may be offered later; to express interest, email Samuel Talkington at talks@umich.edu';
-const COMPUTE_OFF_NOTICE = 'solving in this browser did not complete, and server side compute is disabled in this demo. retry to run the browser engine again, or email Samuel Talkington at talks@umich.edu to express interest in server compute';
+ * declines compute. */
+const WASM_REQUIRED_NOTICE = 'This browser cannot run the WebAssembly engine, and server compute is disabled';
+const COMPUTE_OFF_NOTICE = 'The browser solve did not complete, and server compute is disabled. Retry to run it again';
 /** Upper bound on waiting for a camera fly-to before the sensitivity solve
  * starts anyway: a missing map or a cue that never appears must not stall the
  * selection. */
@@ -107,6 +106,8 @@ export class Controller {
     // File reads and worker messages retain whole buffers. Admit one validated
     // batch at a time so repeated drops cannot multiply the aggregate byte cap.
     dropBatchGate = new DropBatchGate();
+    // Set by dispose(). Not $state; nothing renders it.
+    disposed = false;
     nearbyRangeAnchor = $state(null);
     // Default cases the user has closed; drives the restore affordance. Seeded in load().
     hiddenDefaults = $state(new Set());
@@ -268,6 +269,9 @@ export class Controller {
     // under that formulation. Returns null when the sens module can't load; the caller then
     // falls back to the server, surfacing solveFallbackReason.
     async getStudy(c, studyInputJson) {
+        // A disposed controller builds nothing that would outlive it.
+        if (this.disposed)
+            return null;
         const latched = this.studyUnavailable.get(c);
         if (latched) {
             c.solveFallbackReason ??= latched;
@@ -347,6 +351,28 @@ export class Controller {
         const study = await this.getStudy(c, studyInputJson);
         return study ? study.sensitivity(c.id, this.caseDeltas(c), this.caseRatings(c), target) : null;
     }
+    /** Release every engine handle this controller holds: each case's browser
+     * Study, including one still being built, and each multiconductor
+     * session, with their pending edits and in-flight requests.
+     * `TellegenProvider` calls it when it unmounts; the controller builds no
+     * Study and keeps no new session afterwards. */
+    dispose() {
+        if (this.disposed)
+            return;
+        this.disposed = true;
+        this.abort?.abort();
+        this.abort = null;
+        for (const c of [...this.app.cases, ...this.app.localCases])
+            this.disposeStudy(c);
+        for (const c of this.app.multiCases) {
+            c.solveAbort?.abort();
+            if (c.mcEditTimer !== null)
+                clearTimeout(c.mcEditTimer);
+            c.mcEditTimer = null;
+            c.mcSession?.free();
+            c.mcSession = null;
+        }
+    }
     // Release a case's Study (if any) when the case is removed.
     disposeStudy(c) {
         const cached = this.caseStudies.get(c);
@@ -2144,7 +2170,7 @@ export class Controller {
     }
     /** Compute terminal quantities only for the retained input and current case revision. */
     solveMultiCase = async (c, options = {}, signal) => {
-        if (signal?.aborted)
+        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');
@@ -2187,7 +2213,8 @@ export class Controller {
                     snapshot?.result ?? (await this.mcTransport.solveMcModule(input, options, abort.signal));
                 result = summarizeMcPfResult(fullResult);
             }
-            if (abort.signal.aborted)
+            // 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) ||

package/dist/display.js

@@ -1,5 +1,4 @@
 import { demandGradient, priceGradient } from './colors.js';
-import { priceCopy } from './format.js';
 import { CaseState } from './state.svelte.js';
 /** Variables present in the current result. Power flow has no LMP values. */
 export function displayMetaFor(c) {
@@ -11,7 +10,9 @@ export function displayMetaFor(c) {
             mode: 'price',
             label: 'LMP',
             unit: 'objective units/MW',
-            copy: priceCopy(c.formulation),
+            copy: c.formulation === 'socwr'
+                ? 'Locational marginal price, SOCWR relaxation'
+                : 'Locational marginal price',
             gradient: priceGradient
         });
     }
@@ -20,18 +21,16 @@ export function displayMetaFor(c) {
             mode: 'voltage',
             label: '|V|',
             unit: 'pu',
-            copy: c.formulation === 'socwr'
-                ? 'SOCWR voltage magnitude from the current relaxed solution.'
-                : 'Bus voltage magnitude from the current power-flow result.',
+            copy: c.formulation === 'socwr' ? 'Voltage magnitude, SOCWR relaxation' : 'Voltage magnitude',
             gradient: priceGradient
         });
     }
     if (c.solution.va.length > 0) {
         options.push({
             mode: 'angle',
-            label: 'angle',
+            label: 'Angle',
             unit: 'rad',
-            copy: 'Bus voltage angle from the current result.',
+            copy: 'Voltage angle',
             gradient: priceGradient
         });
     }
@@ -39,9 +38,9 @@ export function displayMetaFor(c) {
     if (c.network?.buses.length) {
         options.push({
             mode: 'demand',
-            label: 'demand',
+            label: 'Demand',
             unit: 'MW',
-            copy: 'Bus demand, including committed changes, on a square-root scale.',
+            copy: 'Demand, square-root scale',
             gradient: demandGradient
         });
     }

package/dist/format.d.ts

@@ -1,19 +1,11 @@
-import type { SolveIteration } from './api.js';
 import type { RGBA } from './colors.js';
-import type { DisplayMode, SolveBackend } from './state.svelte.js';
+import type { DisplayMode } from './state.svelte.js';
 import { type Formulation } from '@tellegen/engine';
 export { errorText } from '@tellegen/engine';
 /** The short menu label for a formulation tag (e.g. `acopf` -> `AC OPF`). */
 export declare function formulationLabel(id: Formulation): string;
 export declare function formulationHint(id: Formulation): string;
-export declare function priceCopy(id: Formulation): string;
 export declare function splitName(name: string): [string, string];
-/** Structural shape `solveMetaLabel` needs, satisfied by `CaseState` and `LocalCase`. */
-type SolveMeta = {
-    iterations?: SolveIteration[];
-    solveBackend: SolveBackend | null;
-};
-export declare function solveMetaLabel(c: SolveMeta): string;
 export declare const INFEASIBLE_DISPATCH = "No feasible dispatch: demand cannot be served within line and generator limits";
 /** The message for a local case whose browser solve failed, and the
  * technical detail to disclose behind it. An infeasible DC OPF means the

package/dist/format.js

@@ -9,23 +9,10 @@ export function formulationLabel(id) {
 export function formulationHint(id) {
     return FORMULATIONS.find((f) => f.id === id)?.hint ?? id;
 }
-export function priceCopy(id) {
-    const definition = 'Locational marginal price (LMP): the change in the OPF objective for an additional MW at a bus, in objective units/MW.';
-    return id === 'socwr'
-        ? `${definition} Prices come from the SOCWR relaxation. Select a bus to see their sensitivity.`
-        : `${definition} Select a bus to see its demand sensitivity.`;
-}
 export function splitName(name) {
     const m = name.match(/^(.*?)\s*\((.*)\)$/);
     return m ? [m[1], m[2]] : [name, ''];
 }
-export function solveMetaLabel(c) {
-    if ((c.iterations ?? []).length > 1)
-        return `${c.iterations?.length} iterations`;
-    if (c.solveBackend === 'clarabel-wasm-server-sensitivity')
-        return 'server price sensitivity';
-    return c.solveBackend === 'rust-server' ? 'server solve' : 'browser solve';
-}
 export const INFEASIBLE_DISPATCH = 'No feasible dispatch: demand cannot be served within line and generator limits';
 /** The message for a local case whose browser solve failed, and the
  * technical detail to disclose behind it. An infeasible DC OPF means the

package/dist/styles.css

@@ -298,6 +298,7 @@ a {
    before the component split. Scoping this would raise its specificity past that rule. */
 .mode > button {
 	margin-left: auto;
+	font-family: inherit;
 	font-size: 12.5px;
 	padding: 2px 7px;
 	background: none;
@@ -313,6 +314,7 @@ a {
 }
 
 .display-mode {
+	flex-wrap: wrap;
 	gap: 8px;
 }
 
@@ -387,6 +389,7 @@ a {
 
 .reset {
 	margin-top: 10px;
+	font-family: inherit;
 	font-size: 12.5px;
 	padding: 3px 10px;
 	background: none;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tellegen/svelte",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "description": "Svelte components for tellegen power system maps, local case files, and browser solves.",
   "keywords": [
     "svelte",
@@ -67,18 +67,22 @@
     "pack:dry-run": "npm pack --dry-run --cache ../../node_modules/.cache/npm-pack"
   },
   "dependencies": {
+    "@tellegen/engine": "^0.4.1"
+  },
+  "peerDependencies": {
     "@deck.gl/core": "^9.4.0",
     "@deck.gl/layers": "^9.4.0",
     "@deck.gl/maplibre": "^9.4.0",
-    "@tellegen/engine": "^0.4.0",
-    "maplibre-gl": "^6.15.0"
-  },
-  "peerDependencies": {
+    "maplibre-gl": "^6.15.0",
     "svelte": ">=5.30 <6"
   },
   "devDependencies": {
-    "@sveltejs/package": "^2.3.0",
+    "@deck.gl/core": "^9.4.0",
+    "@deck.gl/layers": "^9.4.0",
+    "@deck.gl/maplibre": "^9.4.0",
+    "@sveltejs/package": "^3.0.1",
     "@sveltejs/vite-plugin-svelte": "^7.3.1",
+    "maplibre-gl": "^6.15.0",
     "svelte": "^5.57.2",
     "svelte-check": "^4.7.7",
     "typescript": "^6.0.3",