@tellegen/svelte 0.3.0 → 0.4.1

package/dist/components/PowerFlowDetails.svelte

@@ -73,7 +73,7 @@
 	h3 span {
 		display: block;
 		margin-top: 3px;
-		font-size: 11px;
+		font-size: 13px;
 		font-weight: 400;
 		color: var(--text-secondary);
 	}

package/dist/components/RatingSlider.svelte

@@ -1,6 +1,7 @@
 <script lang="ts">
 	import { getController } from '../context.svelte.js';
 	import { fmt, signed } from '../format.js';
+	import { sliderKeyValue } from '../slider.js';
 
 	const ctrl = getController();
 
@@ -64,7 +65,15 @@
 				bind:value={ctrl.ratingSliderCurrent, ctrl.setRatingPreview}
 				aria-label="rating delta at selected line"
 				onpointerdown={() => ctrl.setRatingPreview(ctrl.ratingSliderValue)}
-				onkeydown={() => ctrl.setRatingPreview(ctrl.ratingSliderValue)}
+				onkeydown={(e) => {
+					const next = sliderKeyValue(e.key, ctrl.ratingSliderValue, bounds.min, bounds.max);
+					if (next === null) {
+						ctrl.setRatingPreview(ctrl.ratingSliderValue);
+						return;
+					}
+					e.preventDefault();
+					ctrl.setRatingPreview(next);
+				}}
 				onpointerup={(e) => ctrl.finishRatingInput(Number(e.currentTarget.value))}
 				onkeyup={(e) => ctrl.finishRatingInput(Number(e.currentTarget.value))}
 				onchange={(e) => ctrl.finishRatingInput(Number(e.currentTarget.value))}
@@ -105,7 +114,7 @@
 	.slider-head {
 		display: flex;
 		justify-content: space-between;
-		font-size: 11.5px;
+		font-size: 13.5px;
 		color: var(--text-secondary);
 		margin-bottom: 4px;
 	}
@@ -120,7 +129,7 @@
 		justify-content: space-between;
 		gap: 8px;
 		margin: 6px 0 7px;
-		font-size: 10.5px;
+		font-size: 12.5px;
 	}
 
 	.slider-track {
@@ -236,13 +245,13 @@
 
 	.pred {
 		margin: 2px 0 0;
-		font-size: 11px;
+		font-size: 13px;
 		min-height: 16px;
 	}
 
 	.score {
 		margin: 8px 0 0;
-		font-size: 11px;
+		font-size: 13px;
 		color: var(--ink);
 		min-height: 16px;
 	}

package/dist/components/RestoreDefaultsButton.svelte

@@ -24,7 +24,7 @@
 		color: var(--text-secondary);
 		font-size: 11px;
 		cursor: pointer;
-		box-shadow: 0 2px 10px rgba(32, 36, 43, 0.1);
+		box-shadow: var(--elev-1);
 	}
 
 	.restore-defaults:hover {

package/dist/components/SavedNetworkDetails.svelte

@@ -140,7 +140,7 @@
 	.state-label span {
 		flex: none;
 		color: var(--text-secondary);
-		font-size: 11px;
+		font-size: 13px;
 	}
 	dl {
 		margin: 0;
@@ -163,7 +163,7 @@
 	}
 	small {
 		display: block;
-		font-size: 10px;
+		font-size: 12px;
 		color: var(--text-secondary);
 	}
 	.live {
@@ -208,7 +208,7 @@
 		display: block;
 		margin-top: 3px;
 		color: var(--text-secondary);
-		font-size: 11px;
+		font-size: 13px;
 		font-weight: 400;
 	}
 </style>

package/dist/components/SensitivityReadout.svelte

@@ -111,7 +111,7 @@
 <style>
 	.chip {
 		font-family: var(--font-mono);
-		font-size: 11px;
+		font-size: 13px;
 		padding: 2px 8px;
 		border: 1px solid var(--accent);
 		color: var(--text-accent);
@@ -129,7 +129,7 @@
 	}
 
 	.sensitivity-copy {
-		font-size: 11.5px;
+		font-size: 13.5px;
 		line-height: 1.35;
 		white-space: nowrap;
 	}

package/dist/components/ShellEnvironment.svelte

@@ -0,0 +1,51 @@
+<script lang="ts">
+	import { onMount } from 'svelte';
+	import { PANEL_COMPACT_QUERY } from '../panels.svelte.js';
+	import { getAppState, getController } from '../context.svelte.js';
+
+	// Renderless. Keeps the shared app state in step with the environment: the
+	// pointer that gates the file drop affordance, the compact-layout media
+	// query, and the viewport height panel and map framing both read. The
+	// default shell renders it; a custom shell on `PanelHost` must too.
+
+	// Gates the drag-and-drop affordance only. The upload button in the header
+	// is always rendered: a file picker works on every device, and the plain
+	// `hover`/`pointer` queries resolve false on a touchscreen laptop that also
+	// has a mouse, which hid the whole file flow there (#110). `any-*` match
+	// when at least one attached input can hover and point precisely.
+	const FILE_DROP_QUERY = '(any-hover: hover) and (any-pointer: fine)';
+
+	const app = getAppState();
+	const ctrl = getController();
+
+	onMount(() => {
+		const query = window.matchMedia(FILE_DROP_QUERY);
+		const syncFileDropUi = () => {
+			ctrl.showFileDropUi = query.matches;
+			if (!ctrl.showFileDropUi) app.dragOver = false;
+		};
+		syncFileDropUi();
+		query.addEventListener('change', syncFileDropUi);
+
+		const compact = window.matchMedia(PANEL_COMPACT_QUERY);
+		const syncCompact = () => {
+			app.compactLayout = compact.matches;
+			if (!compact.matches) app.sheetInset = 0;
+		};
+		syncCompact();
+		compact.addEventListener('change', syncCompact);
+
+		// Shared viewport measurements keep panel and map framing dimensions aligned.
+		const syncViewport = () => (app.viewportHeight = window.innerHeight);
+		syncViewport();
+		window.addEventListener('resize', syncViewport);
+		window.addEventListener('orientationchange', syncViewport);
+
+		return () => {
+			query.removeEventListener('change', syncFileDropUi);
+			compact.removeEventListener('change', syncCompact);
+			window.removeEventListener('resize', syncViewport);
+			window.removeEventListener('orientationchange', syncViewport);
+		};
+	});
+</script>

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

@@ -0,0 +1,18 @@
+interface $$__sveltets_2_IsomorphicComponent<Props extends Record<string, any> = any, Events extends Record<string, any> = any, Slots extends Record<string, any> = any, Exports = {}, Bindings = string> {
+    new (options: import('svelte').ComponentConstructorOptions<Props>): import('svelte').SvelteComponent<Props, Events, Slots> & {
+        $$bindings?: Bindings;
+    } & Exports;
+    (internal: unknown, props: {
+        $$events?: Events;
+        $$slots?: Slots;
+    }): Exports & {
+        $set?: any;
+        $on?: any;
+    };
+    z_$$bindings?: Bindings;
+}
+declare const ShellEnvironment: $$__sveltets_2_IsomorphicComponent<Record<string, never>, {
+    [evt: string]: CustomEvent<any>;
+}, {}, {}, string>;
+type ShellEnvironment = InstanceType<typeof ShellEnvironment>;
+export default ShellEnvironment;

package/dist/components/SizeLegend.svelte

@@ -19,7 +19,7 @@
 		display: flex;
 		align-items: center;
 		gap: 12px;
-		font-size: 10px;
+		font-size: 12px;
 		color: var(--text-secondary);
 	}
 
@@ -38,7 +38,7 @@
 
 	.caption {
 		margin-left: auto;
-		font-size: 9.5px;
+		font-size: 12px;
 	}
 
 	@media (max-width: 760px) {

package/dist/components/SolveCard.svelte

@@ -53,7 +53,7 @@
 
 <style>
 	.solve-label {
-		font-size: 11px;
+		font-size: 13px;
 		margin-bottom: 8px;
 	}
 	.solvecard {
@@ -65,7 +65,7 @@
 		align-items: center;
 		flex-wrap: wrap;
 		gap: 10px 14px;
-		font-size: 10px;
+		font-size: 12px;
 		margin-top: 6px;
 	}
 
@@ -75,7 +75,7 @@
 
 	.fallback-reason {
 		margin: 6px 0 0;
-		font-size: 10px;
+		font-size: 12px;
 		line-height: 1.35;
 		overflow-wrap: anywhere;
 	}

package/dist/components/TopMovers.svelte

@@ -46,7 +46,7 @@
 
 	caption {
 		text-align: left;
-		font-size: 10.5px;
+		font-size: 12.5px;
 		margin-bottom: 4px;
 	}
 

package/dist/components.d.ts

@@ -1,5 +1,8 @@
 export { default as ModelDetails } from './components/ModelDetails.svelte';
 export { default as AppFooter } from './components/AppFooter.svelte';
+export { default as NotificationCenter } from './components/NotificationCenter.svelte';
+export { default as PanelHost } from './components/PanelHost.svelte';
+export { default as ShellEnvironment } from './components/ShellEnvironment.svelte';
 export { default as AppHeader } from './components/AppHeader.svelte';
 export { default as BusPicker } from './components/BusPicker.svelte';
 export { default as ControlPanel } from './components/ControlPanel.svelte';

package/dist/components.js

@@ -1,5 +1,8 @@
 export { default as ModelDetails } from './components/ModelDetails.svelte';
 export { default as AppFooter } from './components/AppFooter.svelte';
+export { default as NotificationCenter } from './components/NotificationCenter.svelte';
+export { default as PanelHost } from './components/PanelHost.svelte';
+export { default as ShellEnvironment } from './components/ShellEnvironment.svelte';
 export { default as AppHeader } from './components/AppHeader.svelte';
 export { default as BusPicker } from './components/BusPicker.svelte';
 export { default as ControlPanel } from './components/ControlPanel.svelte';

package/dist/context.svelte.d.ts

@@ -1,12 +1,19 @@
 import type { AppState } from './state.svelte.js';
 import type { Controller } from './controller.svelte.js';
 export interface TellegenUiConfig {
-    apiBase: string;
+    /** Backend base path; `null` for a host with no backend at all. */
+    apiBase: string | null;
     loadDefaultCases: boolean;
     docsHref: string;
     orgHref: string;
     orgLabel: string;
     showFooter: boolean;
+    /** `'dark'` sets `data-theme="dark"` on the document root while the
+     * provider is mounted, which switches the `styles.css` tokens. */
+    theme: 'light' | 'dark';
+    /** CARTO basemap key for the default shell's map, trimmed; empty for
+     * none. See `TellegenMap`'s `cartoApiKey`. */
+    cartoApiKey: string;
 }
 export type TellegenUiOptions = Partial<TellegenUiConfig>;
 export declare const DEFAULT_TELLEGEN_UI_CONFIG: TellegenUiConfig;

package/dist/context.svelte.js

@@ -1,4 +1,5 @@
 import { getContext, setContext } from 'svelte';
+import { normalizeCartoApiKey } from './basemap.js';
 const APP = Symbol('tellegen.app');
 const CTRL = Symbol('tellegen.controller');
 const CONFIG = Symbol('tellegen.config');
@@ -8,16 +9,20 @@ export const DEFAULT_TELLEGEN_UI_CONFIG = {
     docsHref: 'https://eigenergy.github.io/tellegen/',
     orgHref: 'https://github.com/eigenergy',
     orgLabel: 'eigenergy group @ michigan ece',
-    showFooter: true
+    showFooter: true,
+    theme: 'light',
+    cartoApiKey: ''
 };
 export function resolveTellegenUiConfig(options = {}) {
     return {
-        apiBase: options.apiBase ?? DEFAULT_TELLEGEN_UI_CONFIG.apiBase,
+        apiBase: options.apiBase === undefined ? DEFAULT_TELLEGEN_UI_CONFIG.apiBase : options.apiBase,
         loadDefaultCases: options.loadDefaultCases ?? DEFAULT_TELLEGEN_UI_CONFIG.loadDefaultCases,
         docsHref: options.docsHref ?? DEFAULT_TELLEGEN_UI_CONFIG.docsHref,
         orgHref: options.orgHref ?? DEFAULT_TELLEGEN_UI_CONFIG.orgHref,
         orgLabel: options.orgLabel ?? DEFAULT_TELLEGEN_UI_CONFIG.orgLabel,
-        showFooter: options.showFooter ?? DEFAULT_TELLEGEN_UI_CONFIG.showFooter
+        showFooter: options.showFooter ?? DEFAULT_TELLEGEN_UI_CONFIG.showFooter,
+        theme: options.theme ?? DEFAULT_TELLEGEN_UI_CONFIG.theme,
+        cartoApiKey: normalizeCartoApiKey(options.cartoApiKey) ?? DEFAULT_TELLEGEN_UI_CONFIG.cartoApiKey
     };
 }
 export const setAppState = (a) => setContext(APP, a);

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 McPfOptions, type McPfResult, type McStudySnapshot, type BrowserStudy, type Formulation, type PowerIoDiagnostic, type SensTarget } from '@tellegen/engine';
+import { type EngineTransport, type McPfDetail, type McPfDetailQuery, type McPfOptions, 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. */
@@ -28,12 +28,40 @@ type DemandRangeAnchor = {
 };
 export interface ControllerOptions {
     api?: TellegenApiClient;
-    apiBase?: string;
+    /** Backend base path. `null` means there is no backend: no client is
+     * created and nothing is ever fetched. */
+    apiBase?: string | null;
+    /** Whether `load()` fetches the bundled cases. Default `true`. With
+     * `false`, `load()` only marks the shell loaded and frames the map. */
+    loadDefaultCases?: boolean;
     mcTransport?: Pick<EngineTransport, 'solveMcModule' | 'applyMcGeo'> & Partial<Pick<EngineTransport, 'solveMcStudy' | 'applyMcStudyGeo' | 'createMcPfSession'>>;
 }
+/** Input to `Controller.openBalancedModule` and `replaceLocalCase`: a
+ * balanced (transmission) powerio module, either as its JSON text or as the
+ * payload the engine's `ingestCase` already produced for it. */
+export interface OpenBalancedModuleInput {
+    /** Case label; also the stem of the `.pio.json` file name the shell shows. */
+    name: string;
+    /** Module JSON, ingested through the engine. Ignored when `payload` is set. */
+    moduleJson?: string;
+    /** An already ingested balanced payload; skips the engine round trip. */
+    payload?: IngestedCase;
+    /** A `.geo.json` layer document, for a module that carries no coordinates. */
+    geoLayer?: string;
+    /** Overrides the formulation the module declares. */
+    formulation?: Formulation;
+    /** Default `true`: add the case, make it active, and start its browser
+     * solve. With `false` the prepared case is returned and not added. */
+    activate?: boolean;
+    /** Default `true`: fly the map to the case when it is activated. */
+    frame?: boolean;
+}
 export declare class Controller {
     app: AppState;
-    api: TellegenApiClient;
+    /** `null` when the controller was created with `apiBase: null`; every
+     * 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'>>;
     abort: AbortController | null;
     sensitivity429Until: number;
@@ -196,7 +224,11 @@ export declare class Controller {
     removeBackendCase: (c: CaseState, event?: MouseEvent) => Promise<void>;
     activateLocal: (c: LocalCase) => void;
     removeLocalCase: (c: LocalCase, event?: MouseEvent) => Promise<void>;
-    addAndActivateLocal: (c: LocalCase) => void;
+    /** Add a prepared local case, make it active, frame it (unless `frame` is
+     * false) and start its browser solve. */
+    addAndActivateLocal: (c: LocalCase, options?: {
+        frame?: boolean;
+    }) => void;
     placeLocalCase: (lon: number, lat: number) => Promise<void>;
     /** Write the case's on-screen layout into its network payload
      * (`Bus.location` with `synthetic` provenance — the engine also accepts
@@ -291,6 +323,9 @@ export declare class Controller {
      * the first matching PowerWorld display. A failed geographic join keeps the
      * parsed case and returns the user-facing placement error. */
     private prepareDroppedLocal;
+    /** A case that still has no geometry gets a connectivity layout as its
+     * diagram, so it can render and solve without a placement step. */
+    private placeTopologyAsDiagram;
     /** Retain diagram geometry separately from the electrical case's geographic data. */
     private fillFromDisplaySibling;
     setCaseDisplayMode: (c: LocalCase, mode: "geographic" | "diagram") => void;
@@ -304,10 +339,21 @@ 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<McPfResult>;
+    solveMultiCase: (c: MulticonductorCase, options?: McPfOptions, signal?: AbortSignal) => Promise<McPfSummary>;
     /** Materialize the current retained operating point only when a portable
      * snapshot is actually needed (save/export/geography). */
     snapshotMultiCase: (c: MulticonductorCase) => Promise<McStudySnapshot>;
+    /** One bus's terminals and a page of equipment ports for the displayed
+     * operating point, from the live session or the stored full result. Null
+     * when the operating point changed before the page arrived. */
+    multiResultDetail: (c: MulticonductorCase, query: McPfDetailQuery) => Promise<McPfDetail | null>;
+    /** Every terminal's identity, voltage, and injected current, as numeric
+     * arrays of interleaved `[re, im]` values. */
+    multiTerminalTable: (c: MulticonductorCase) => Promise<{
+        ids: Array<[string, string]>;
+        voltages: Float64Array;
+        currents: Float64Array;
+    } | null>;
     /** Apply coordinates atomically to the explicitly selected conductor-resolved case. */
     applyMultiGeoLayers: (c: MulticonductorCase, layers: GeoLayerFile[]) => Promise<void>;
     /** Stage an absolute load-branch P/Q edit and coalesce rapid UI changes into
@@ -338,6 +384,20 @@ export declare class Controller {
     /** Build a local case from a balanced PowerIO ingest payload without activating
      * it yet; co-dropped placement data is applied before the first solve. */
     private localFromBalancedPayload;
+    /** Ingest module text through the engine and require a balanced network. */
+    private ingestBalancedModule;
+    /** Open a balanced powerio module from memory, the programmatic twin of
+     * dropping a `.pio.json` file: ingest (unless `payload` is given), apply an
+     * optional geographic layer, lay out a module without coordinates as a
+     * diagram, then add and activate it. Resolves to the new case; throws when
+     * the module is not a balanced network or the geographic layer matches
+     * nothing. */
+    openBalancedModule: (input: OpenBalancedModuleInput) => Promise<LocalCase>;
+    /** Swap a local case for a new module in place: same slot in the case list,
+     * same formulation unless `input.formulation` says otherwise, same display
+     * mode when the new case supports it, and the selected bus kept when the
+     * new case has it. The previous case's Study is freed. */
+    replaceLocalCase: (previous: LocalCase, input: OpenBalancedModuleInput) => Promise<LocalCase>;
     /** Build (or reuse) the case's Study and commit it at the current edit state, so a
      * save or export captures exactly what is on screen. Null (with an error set) when no
      * PowerIO module or Study is available. */