@tellegen/svelte 0.2.0 → 0.3.0

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,41 @@ 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([]);
+    result = $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 +156,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 +192,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,18 +236,18 @@ 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);
@@ -184,6 +256,8 @@ export class AppState {
     }
     set error(message) {
         this.#error = message;
+        if (message)
+            this.errorRevision++;
         this.errorRetry = null;
     }
     /** Case files parsed in the browser via the powerio wasm module. */
@@ -191,7 +265,7 @@ export class AppState {
     /** 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 +347,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 +369,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/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,

package/package.json

@@ -1,7 +1,20 @@
 {
   "name": "@tellegen/svelte",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Svelte components for tellegen power system maps, local case files, and browser solves.",
+  "keywords": [
+    "svelte",
+    "sveltekit",
+    "power-flow",
+    "optimal-power-flow",
+    "power-systems",
+    "map",
+    "maplibre",
+    "deck.gl",
+    "webassembly",
+    "visualization",
+    "grid"
+  ],
   "license": "MIT",
   "type": "module",
   "repository": {
@@ -49,11 +62,11 @@
     "pack:dry-run": "npm pack --dry-run --cache ../../node_modules/.cache/npm-pack"
   },
   "dependencies": {
-    "@deck.gl/core": "^9.3.10",
-    "@deck.gl/layers": "^9.3.10",
-    "@deck.gl/mapbox": "^9.3.10",
-    "@tellegen/engine": "^0.2.0",
-    "maplibre-gl": "^5.0.0"
+    "@deck.gl/core": "^9.4.0",
+    "@deck.gl/layers": "^9.4.0",
+    "@deck.gl/maplibre": "^9.4.0",
+    "@tellegen/engine": "^0.3.0",
+    "maplibre-gl": "^6.10.0"
   },
   "peerDependencies": {
     "svelte": ">=5.30 <6"
@@ -61,10 +74,10 @@
   "devDependencies": {
     "@sveltejs/package": "^2.3.0",
     "@sveltejs/vite-plugin-svelte": "^7.3.0",
-    "svelte": "^5.56.9",
+    "svelte": "^5.57.0",
     "svelte-check": "^4.7.6",
     "typescript": "^6.0.3",
-    "vite": "^8.2.1",
-    "vitest": "^4.1.11"
+    "vite": "^8.2.2",
+    "vitest": "^5.0.0"
   }
 }

package/dist/study-package.d.ts

@@ -1,8 +0,0 @@
-/** Client-side helper for saved study packages (`.pio.json`). The engine owns
- * parsing, restoring, and exporting; classification of a dropped file lives in
- * `drop-classify.ts` (the single owner). This module covers the one remaining
- * frontend decision around a package: which commit an export targets. */
-/** The commit index for a saved package's current committed state: its last study
- * commit, or 0 when it carries none (export then writes the base network). Tolerant of
- * malformed input, returning 0 rather than throwing. */
-export declare function studyCommitIndex(packageJson: string): number;

package/dist/study-package.js

@@ -1,17 +0,0 @@
-/** Client-side helper for saved study packages (`.pio.json`). The engine owns
- * parsing, restoring, and exporting; classification of a dropped file lives in
- * `drop-classify.ts` (the single owner). This module covers the one remaining
- * frontend decision around a package: which commit an export targets. */
-/** The commit index for a saved package's current committed state: its last study
- * commit, or 0 when it carries none (export then writes the base network). Tolerant of
- * malformed input, returning 0 rather than throwing. */
-export function studyCommitIndex(packageJson) {
-    try {
-        const commits = JSON.parse(packageJson).study?.commits
-            ?.length;
-        return Math.max(0, (commits ?? 0) - 1);
-    }
-    catch {
-        return 0;
-    }
-}