@tellegen/svelte 0.1.0

package/dist/components/TopMovers.svelte

@@ -0,0 +1,68 @@
+<script lang="ts">
+	import { getController } from '../context.svelte.js';
+	import { signedExp } from '../format.js';
+
+	const ctrl = getController();
+	const unitTitle =
+		'LMP is measured in $/MWh and demand is perturbed in MW, so dLMP/dd has units ($/MWh)/MW.';
+</script>
+
+<div class="movers-block">
+	{#if !ctrl.previewing && ctrl.topMovers.length > 0}
+		<table class="mono">
+			<caption class="mono dim" title={unitTitle}>
+				largest &Delta;LMP per MW demand <span class="unit">($/MWh)/MW</span>
+			</caption>
+			<tbody>
+				{#each ctrl.topMovers as mover (mover.bus)}
+					<tr>
+						<td>bus {mover.bus}</td>
+						<td class:pos={mover.value > 0} class:neg={mover.value < 0}>
+							{signedExp(mover.value)}
+						</td>
+					</tr>
+				{/each}
+			</tbody>
+		</table>
+	{/if}
+</div>
+
+<style>
+	.movers-block {
+		min-height: 114px;
+	}
+
+	table {
+		width: 100%;
+		margin-top: 12px;
+		border-collapse: collapse;
+		font-size: 12px;
+	}
+
+	caption {
+		text-align: left;
+		font-size: 10.5px;
+		margin-bottom: 4px;
+	}
+
+	.unit {
+		white-space: nowrap;
+	}
+
+	td {
+		padding: 3px 0;
+		border-top: 1px solid var(--line);
+	}
+
+	td:last-child {
+		text-align: right;
+	}
+
+	.pos {
+		color: var(--pos);
+	}
+
+	.neg {
+		color: var(--neg);
+	}
+</style>

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

@@ -0,0 +1,19 @@
+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 TopMovers: $$__sveltets_2_IsomorphicComponent<Record<string, never>, {
+    [evt: string]: CustomEvent<any>;
+}, {}, {}, string>;
+type TopMovers = InstanceType<typeof TopMovers>;
+export default TopMovers;
+//# sourceMappingURL=TopMovers.svelte.d.ts.map

package/dist/components/TopMovers.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TopMovers.svelte.d.ts","sourceRoot":"","sources":["../../src/lib/components/TopMovers.svelte.ts"],"names":[],"mappings":"AAuCA,UAAU,kCAAkC,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,EAAE,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,EAAE,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,EAAE,OAAO,GAAG,EAAE,EAAE,QAAQ,GAAG,MAAM;IACpM,KAAK,OAAO,EAAE,OAAO,QAAQ,EAAE,2BAA2B,CAAC,KAAK,CAAC,GAAG,OAAO,QAAQ,EAAE,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,GAAG;QAAE,UAAU,CAAC,EAAE,QAAQ,CAAA;KAAE,GAAG,OAAO,CAAC;IACjK,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,KAAK,CAAA;KAAC,GAAG,OAAO,GAAG;QAAE,IAAI,CAAC,EAAE,GAAG,CAAC;QAAC,GAAG,CAAC,EAAE,GAAG,CAAA;KAAE,CAAC;IACtG,YAAY,CAAC,EAAE,QAAQ,CAAC;CAC3B;AAKD,QAAA,MAAM,SAAS;;kBAA+E,CAAC;AAC7E,KAAK,SAAS,GAAG,YAAY,CAAC,OAAO,SAAS,CAAC,CAAC;AAClD,eAAe,SAAS,CAAC"}

package/dist/components.d.ts

@@ -0,0 +1,19 @@
+export { default as AppFooter } from './components/AppFooter.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';
+export { default as DemandSlider } from './components/DemandSlider.svelte';
+export { default as DisplayControls } from './components/DisplayControls.svelte';
+export { default as DropZone } from './components/DropZone.svelte';
+export { default as FormulationSelector } from './components/FormulationSelector.svelte';
+export { default as LocalCaseDetails } from './components/LocalCaseDetails.svelte';
+export { default as MulticonductorDetails } from './components/MulticonductorDetails.svelte';
+export { default as NetworkStats } from './components/NetworkStats.svelte';
+export { default as PlacementCue } from './components/PlacementCue.svelte';
+export { default as RestoreDefaultsButton } from './components/RestoreDefaultsButton.svelte';
+export { default as SensitivityReadout } from './components/SensitivityReadout.svelte';
+export { default as SizeLegend } from './components/SizeLegend.svelte';
+export { default as SolveCard } from './components/SolveCard.svelte';
+export { default as TopMovers } from './components/TopMovers.svelte';
+export { default as Sparkline } from './Sparkline.svelte';
+//# sourceMappingURL=components.d.ts.map

package/dist/components.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"components.d.ts","sourceRoot":"","sources":["../src/lib/components.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAC3E,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAC3E,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,qCAAqC,CAAC;AACjF,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,yCAAyC,CAAC;AACzF,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AACnF,OAAO,EAAE,OAAO,IAAI,qBAAqB,EAAE,MAAM,2CAA2C,CAAC;AAC7F,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAC3E,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAC3E,OAAO,EAAE,OAAO,IAAI,qBAAqB,EAAE,MAAM,2CAA2C,CAAC;AAC7F,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AACvF,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/components.js

@@ -0,0 +1,18 @@
+export { default as AppFooter } from './components/AppFooter.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';
+export { default as DemandSlider } from './components/DemandSlider.svelte';
+export { default as DisplayControls } from './components/DisplayControls.svelte';
+export { default as DropZone } from './components/DropZone.svelte';
+export { default as FormulationSelector } from './components/FormulationSelector.svelte';
+export { default as LocalCaseDetails } from './components/LocalCaseDetails.svelte';
+export { default as MulticonductorDetails } from './components/MulticonductorDetails.svelte';
+export { default as NetworkStats } from './components/NetworkStats.svelte';
+export { default as PlacementCue } from './components/PlacementCue.svelte';
+export { default as RestoreDefaultsButton } from './components/RestoreDefaultsButton.svelte';
+export { default as SensitivityReadout } from './components/SensitivityReadout.svelte';
+export { default as SizeLegend } from './components/SizeLegend.svelte';
+export { default as SolveCard } from './components/SolveCard.svelte';
+export { default as TopMovers } from './components/TopMovers.svelte';
+export { default as Sparkline } from './Sparkline.svelte';

package/dist/context.svelte.d.ts

@@ -0,0 +1,20 @@
+import type { AppState } from './state.svelte.js';
+import type { Controller } from './controller.svelte.js';
+export interface TellegenUiConfig {
+    apiBase: string;
+    loadDefaultCases: boolean;
+    docsHref: string;
+    orgHref: string;
+    orgLabel: string;
+    showFooter: boolean;
+}
+export type TellegenUiOptions = Partial<TellegenUiConfig>;
+export declare const DEFAULT_TELLEGEN_UI_CONFIG: TellegenUiConfig;
+export declare function resolveTellegenUiConfig(options?: TellegenUiOptions): TellegenUiConfig;
+export declare const setAppState: (a: AppState) => AppState;
+export declare const setController: (c: Controller) => Controller;
+export declare const setUiConfig: (config: TellegenUiConfig) => TellegenUiConfig;
+export declare const getAppState: () => AppState;
+export declare const getController: () => Controller;
+export declare const getUiConfig: () => TellegenUiConfig;
+//# sourceMappingURL=context.svelte.d.ts.map

package/dist/context.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.svelte.d.ts","sourceRoot":"","sources":["../src/lib/context.svelte.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAMzD,MAAM,WAAW,gBAAgB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,MAAM,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;AAE1D,eAAO,MAAM,0BAA0B,EAAE,gBAOxC,CAAC;AAEF,wBAAgB,uBAAuB,CAAC,OAAO,GAAE,iBAAsB,GAAG,gBAAgB,CAUzF;AAED,eAAO,MAAM,WAAW,GAAI,GAAG,QAAQ,KAAG,QAA8B,CAAC;AACzE,eAAO,MAAM,aAAa,GAAI,GAAG,UAAU,KAAG,UAAiC,CAAC;AAChF,eAAO,MAAM,WAAW,GAAI,QAAQ,gBAAgB,KAAG,gBAC5B,CAAC;AAE5B,eAAO,MAAM,WAAW,QAAO,QAK9B,CAAC;AAEF,eAAO,MAAM,aAAa,QAAO,UAKhC,CAAC;AAEF,eAAO,MAAM,WAAW,QAAO,gBAI9B,CAAC"}

package/dist/context.svelte.js

@@ -0,0 +1,43 @@
+import { getContext, setContext } from 'svelte';
+const APP = Symbol('tellegen.app');
+const CTRL = Symbol('tellegen.controller');
+const CONFIG = Symbol('tellegen.config');
+export const DEFAULT_TELLEGEN_UI_CONFIG = {
+    apiBase: '/api',
+    loadDefaultCases: true,
+    docsHref: 'https://eigenergy.github.io/tellegen/',
+    orgHref: 'https://github.com/eigenergy',
+    orgLabel: 'eigenergy group @ michigan ece',
+    showFooter: true
+};
+export function resolveTellegenUiConfig(options = {}) {
+    return {
+        apiBase: options.apiBase ?? DEFAULT_TELLEGEN_UI_CONFIG.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
+    };
+}
+export const setAppState = (a) => setContext(APP, a);
+export const setController = (c) => setContext(CTRL, c);
+export const setUiConfig = (config) => setContext(CONFIG, config);
+export const getAppState = () => {
+    const app = getContext(APP);
+    if (!app)
+        throw new Error('getAppState() called outside a tellegen provider');
+    return app;
+};
+export const getController = () => {
+    const ctrl = getContext(CTRL);
+    if (!ctrl)
+        throw new Error('getController() called outside a tellegen provider');
+    return ctrl;
+};
+export const getUiConfig = () => {
+    const config = getContext(CONFIG);
+    if (!config)
+        throw new Error('getUiConfig() called outside a tellegen provider');
+    return config;
+};

package/dist/controller.svelte.d.ts

@@ -0,0 +1,334 @@
+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 BrowserStudy, type Formulation, 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. */
+type GeoLayerFile = {
+    name: string;
+    layer: string;
+    warnings: string[];
+};
+export type { SolvableCase };
+type DemandRangeAnchor = {
+    caseId: string;
+    bus: number;
+    delta: number;
+};
+export interface ControllerOptions {
+    api?: TellegenApiClient;
+    apiBase?: string;
+}
+export declare class Controller {
+    app: AppState;
+    api: TellegenApiClient;
+    abort: AbortController | null;
+    sensitivity429Until: number;
+    serverComputeOff: boolean;
+    caseStudies: WeakMap<SolvableCase, {
+        study: BrowserStudy;
+        networkJson: string;
+        formulation: Formulation;
+        baseSolution: Solution;
+    }>;
+    studyUnavailable: WeakMap<SolvableCase, string>;
+    studyBuilds: WeakMap<SolvableCase, {
+        networkJson: string;
+        formulation: Formulation;
+        token: object;
+        promise: Promise<BrowserStudy | null>;
+    }>;
+    localSeq: number;
+    loading: Promise<void> | null;
+    nearbyRangeAnchor: DemandRangeAnchor | null;
+    hiddenDefaults: Set<string>;
+    casesLoaded: boolean;
+    loadingBackendCase: string | null;
+    showFileDropUi: boolean;
+    previewObjective: {
+        caseId: string;
+        target: SensTarget;
+        objectiveDelta: number;
+    } | null;
+    ratingSlope: {
+        caseId: string;
+        branch: number;
+        slope: number | null;
+    } | null;
+    constructor(app: AppState, options?: ControllerOptions);
+    isBackendCase(c: SolvableCase): c is CaseState;
+    isActiveSolveCase(c: SolvableCase): boolean;
+    caseDeltas(c: SolvableCase): import("@tellegen/engine").DemandDeltas;
+    caseRatings(c: SolvableCase): BranchRatingDeltas;
+    /** True when the case carries any nonzero committed rating delta. Rating edits
+     * solve only through the browser Study; the server fallback would silently
+     * drop them, so callers gate on this before falling back. */
+    hasRatingEdits(c: SolvableCase): boolean;
+    /** True when two selection targets name the same bus or branch. */
+    sameTarget(a: SensTarget, b: SensTarget): boolean;
+    isPerturbed(c: SolvableCase | null): boolean;
+    setNearbyRangeAnchor(c: SolvableCase, bus: number, delta?: number): void;
+    beginBusSelection(c: SolvableCase, busId: number): {
+        ac: AbortController;
+        sensitivitySeq: number;
+    };
+    beginBranchSelection(c: SolvableCase, branchId: number): {
+        ac: AbortController;
+        sensitivitySeq: number;
+    };
+    /** The display name of a case: a backend case's `name`, a local case's `label`. */
+    caseName(c: SolvableCase): string;
+    readHiddenDefaultCases(): Set<string>;
+    writeHiddenDefaultCases(ids: Set<string>): void;
+    rememberHiddenDefaultCase(id: string): void;
+    localNetwork(c: LocalCase): Network | null;
+    maybeStartLocalSolve(id: string): void;
+    getStudy(c: SolvableCase, networkJson: string): Promise<BrowserStudy | null>;
+    browserSensitivity(c: SolvableCase, networkJson: string, target: SensTarget): Promise<SensitivityColumn | null>;
+    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;
+    ensureNetworkJson(c: SolvableCase): Promise<string | null>;
+    previewDeltas(c: SolvableCase, bus: number, value: number): {
+        [x: string]: number;
+        [x: number]: number;
+    };
+    demandBounds(mode: DemandRangeMode, bus: NetworkBus | null, center: number): {
+        min: number;
+        max: number;
+        span: number;
+    };
+    activeSolvable: SolvableCase | null;
+    activeFormulation: import("@tellegen/engine").BrowserFormulation;
+    networkStats: {
+        buses: number;
+        branches: number;
+        objective: number | null;
+        deltaObjective: number | null;
+        binding: number | null;
+    } | null;
+    displayOptions: import("./display.js").DisplayOption[];
+    activeDisplay: {
+        values: {
+            bus: number;
+            value: number;
+        }[];
+        mode: import("./state.svelte.js").DisplayMode;
+        label: string;
+        unit: string;
+        copy: string;
+        gradient: string;
+    } | null;
+    displayStats: {
+        lo: {
+            value: number;
+            clamped: boolean;
+        };
+        hi: {
+            value: number;
+            clamped: boolean;
+        };
+        uniform: number | null;
+    } | null;
+    selectedBusData: NetworkBus | null;
+    selectedBranchData: import("@tellegen/engine").NetworkBranch | null;
+    selectionTarget: SensTarget | null;
+    committedDelta: number;
+    sliderValue: number;
+    nearbyRangeCenter: number;
+    sliderBounds: {
+        min: number;
+        max: number;
+        span: number;
+    };
+    sliderMin: number;
+    sliderMax: number;
+    committedRating: number;
+    ratingSliderValue: number;
+    ratingBounds: {
+        min: number;
+        max: number;
+        disabled: boolean;
+    };
+    selectedSensitivity: SensitivityColumn | null;
+    sensSummary: import("./colors.js").SensitivityDomain | null;
+    flatSensBackground: string;
+    previewMaxAbsStep: number;
+    previewScale: number | null;
+    selectedLmp: number | null;
+    selfSens: number;
+    predictedDeltaObj: number | null;
+    gradientScore: {
+        pred: number;
+        exact: number;
+    } | null;
+    topMovers: {
+        bus: number;
+        value: number;
+    }[];
+    showMoverSlot: boolean;
+    previewing: boolean;
+    load: () => Promise<void>;
+    loadBackendCase: (c: CaseState, frame?: boolean) => Promise<void>;
+    /** Leave the multiconductor view: a backend or local case becoming active is
+     * mutually exclusive with a multi case, so drop the multi's active/pending ids.
+     * The multi's per-bus expansion stays on the case for when it is reactivated. */
+    private leaveMulti;
+    activateCase: (id: string) => Promise<void>;
+    private hydrateFallback;
+    removeBackendCase: (c: CaseState, event?: MouseEvent) => Promise<void>;
+    activateLocal: (c: LocalCase) => void;
+    removeLocalCase: (c: LocalCase, event?: MouseEvent) => Promise<void>;
+    addAndActivateLocal: (c: LocalCase) => 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
+     * `manual`, which round trips through restored packages), so saves,
+     * exports, and the `.geo.json` download carry it. Best effort: on an
+     * engine failure the view still renders, only the layout's persistence is
+     * lost. */
+    private stampLayout;
+    /** Download the case's coordinates as a `.geo.json` layer: canonical
+     * GeoJSON with provenance stamped (`synthetic`/`manual` for layouts), the
+     * document powerio and tellegen both read back. */
+    downloadGeoLayer: (c: LocalCase) => Promise<void>;
+    moveLocalCase: (c: LocalCase) => void;
+    /** Apply parsed geo layers onto a local case, in drop order (a later file
+     * wins on shared elements). The engine owns matching and the network becomes
+     * the single owner of the coordinates: matched points land in
+     * `Bus.location`, routes in `Branch.route`, and the refreshed
+     * `network_json` replaces the case payload — so a saved package or export
+     * carries exactly what is on screen. A live Study is synced the same way.
+     * Throws when a layer matches nothing. */
+    applyGeoLayers: (c: LocalCase, layers: GeoLayerFile[]) => Promise<void>;
+    /** Adopt an engine geo apply onto the case: the refreshed payload becomes
+     * the case's network and view, provenance flips to the geographic source,
+     * and the warnings panel gets the placement summary. */
+    private adoptGeoPayload;
+    /** Keep a live Study's base network in step with a geo change (locations
+     * are metadata the model never reads, so nothing re-solves), and re-key its
+     * cache entry so the next solve reuses it instead of rebuilding. */
+    private syncCachedStudy;
+    applyGeoLayersToExisting: (layers: GeoLayerFile[]) => Promise<void>;
+    /** Ask the map to frame the selected branch and wait for the camera to land,
+     * capped by FOCUS_SETTLE_CAP_MS and cut short by the selection's abort. */
+    private awaitFocus;
+    /** One selection flow for bus and branch targets on backend cases: optional
+     * camera focus first (so the fly-to is not janked by the solve), the browser
+     * Study column, then the one server reconciliation for DC OPF without rating
+     * edits. */
+    private selectTarget;
+    selectBus: (caseId: string, busId: number) => Promise<void>;
+    /** The compute-off terminal copy. Name the browser engine as the cause only
+     * when its failure is known permanent; otherwise the miss may have been
+     * transient (a wasm chunk or case JSON fetch), so say what is known and keep
+     * the retry meaningful. */
+    private computeOffNotice;
+    /** The one server ∂LMP/∂parameter request a selection may make: the
+     * reconciliation path when the browser Study produced no column for a DC OPF
+     * case. Never retries on its own: a second request inside the same rate limit
+     * window is a guaranteed rejection, and the retry button covers the user
+     * need. A 429 opens a cooldown for the rest of the window; the server's own
+     * compute-disabled 403 latches serverComputeOff for the session (matched on
+     * `serverMessage` so a proxy or WAF 403 cannot latch a false diagnosis). */
+    private fetchServerColumn;
+    /** Show an error with an optional one-click re-run of the failed operation. */
+    private fail;
+    /** The panel's retry button: re-run the failed operation when one is known,
+     * else reload the case list. An explicit retry always ends a 429 cooldown. */
+    retryError: () => void;
+    selectLocalBus: (localId: string, busId: number) => Promise<void>;
+    /** The terminal message when a case with committed rating edits cannot use the
+     * browser Study: the server fallback solves at base ratings, so there is no
+     * correct fallback to take. */
+    private ratingEditsFallbackError;
+    /** The terminal message when the browser produced no column and the server
+     * cannot reconcile (non-DC formulation, or a local case with no server). */
+    private failColumnUnavailable;
+    /** `focus` frames the selected line on the map first; the sensitivity solve
+     * waits for the camera to land so the fly-to stays smooth. */
+    selectBranch: (caseId: string, branchId: number, opts?: {
+        focus?: boolean;
+    }) => Promise<void>;
+    selectLocalBranch: (localId: string, branchId: number, opts?: {
+        focus?: boolean;
+    }) => Promise<void>;
+    clearSelection: () => void;
+    runSolve: (c: SolvableCase, target: SensTarget | null) => void;
+    serverSolve: (c: CaseState, target: SensTarget | null, seq?: number) => void;
+    commitDelta: (value: number) => void;
+    finishDemandInput: (value: number) => void;
+    resetCase: (c: SolvableCase) => void;
+    changeFormulation: (c: SolvableCase, next: Formulation) => void;
+    /** Parse dropped files in the browser via the powerio wasm module. Case
+     * files (.m, .raw, .aux) become local networks; geographic files can
+     * place those networks; a PowerWorld .pwd becomes a substation point
+     * preview. Files run serially; nothing uploads. */
+    ingestFiles: (files: FileList | File[]) => Promise<void>;
+    /** Fill a coordinate-less case's positions from a co-dropped PowerWorld
+     * `.pwd`: the display's substation points project to approximate
+     * longitude/latitude and join onto buses through the `SubNum` extras key.
+     * The first display that joins wins; one that matches nothing stays
+     * available as its own preview entry, and the case stays placeable. */
+    private fillFromDisplaySibling;
+    /** Route a dropped `.json` by its content: a saved study package restores
+     * (`restored`), a multiconductor package or a BMOPF/PMD distribution
+     * document views (`viewed`), `failed` means the content looked routable but
+     * the engine rejected it (a fail-closed message is set), and `not-package`
+     * falls through to the caller's geo/case handling. `drop-classify` is the
+     * single owner of the classification. */
+    private ingestJsonDrop;
+    /** Parse a dropped OpenDSS `.dss` file into a multiconductor viewing case.
+     * Returns true when a case landed; a parse failure sets the panel error. */
+    private ingestDistFile;
+    /** Build a `MulticonductorCase` from an ingest payload and make it active.
+     * Geographic cases place immediately; planar/synthetic cases enter placement
+     * (a map click or "place on map") so the user picks their center. */
+    private addMultiCase;
+    /** Make a multiconductor case active, framing it when it is placed. */
+    activateMulti: (c: MulticonductorCase) => void;
+    /** Select a bus in a multiconductor case: its terminal stack and incident
+     * conductors expand. Selecting is viewing detail only — no solve. */
+    selectMultiBus: (caseId: string, busId: string) => void;
+    /** Place a multiconductor case awaiting a center: fit its provided planar
+     * coordinates when it carries them, else lay it out synthetically. */
+    placeMultiCase: (lon: number, lat: number) => void;
+    /** Re-enter placement for a multiconductor case, to move its layout. */
+    moveMultiCase: (c: MulticonductorCase) => void;
+    removeMultiCase: (c: MulticonductorCase, event?: MouseEvent) => Promise<void>;
+    /** The unified map click-to-place: a pending multiconductor case takes the
+     * click first, otherwise a pending local case does. */
+    placeCase: (lon: number, lat: number) => void;
+    /** Build a local case from a restored study package: the same shape a dropped case
+     * takes, with the saved demand/rating deltas and formulation pre-applied. */
+    private restoreLocalFromPackage;
+    /** 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
+     * network or Study is available. */
+    private syncedStudy;
+    /** Save the active study as a `.pio.json` package and download it. */
+    saveStudyPackage: (c: SolvableCase) => Promise<void>;
+    /** Export the active study's committed state to `format` and download it. Returns the
+     * writer's fidelity warnings so the caller can surface them. */
+    exportStudyAs: (c: SolvableCase, format: string) => Promise<string[]>;
+    /** A filesystem-safe base name for a downloaded case file. */
+    private caseFileStem;
+    setDemandRangeMode: (mode: DemandRangeMode) => void;
+    runPreview: (c: SolvableCase, bus: number, value: number) => void;
+    private enginePreviewNext;
+    private enginePreviewBusy;
+    private pumpEnginePreview;
+    setSliderPreview: (value: number | undefined) => void;
+    previewRatings(c: SolvableCase, branch: number, value: number): BranchRatingDeltas;
+    runRatingPreview: (c: SolvableCase, branch: number, value: number) => void;
+    setRatingPreview: (value: number | undefined) => void;
+    private ratingSlopePending;
+    commitRating: (value: number) => Promise<void>;
+    finishRatingInput: (value: number) => void;
+    restoreDefaultCases: () => void;
+    sliderCurrent: () => number;
+    ratingSliderCurrent: () => number;
+}
+export declare function createController(app: AppState, options?: ControllerOptions): Controller;
+//# sourceMappingURL=controller.svelte.d.ts.map

package/dist/controller.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller.svelte.d.ts","sourceRoot":"","sources":["../src/lib/controller.svelte.ts"],"names":[],"mappings":"AAAA,OAAO,EAA6B,KAAK,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAC7E,OAAO,KAAK,EAAE,kBAAkB,EAAE,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAQrG,OAAO,EACN,SAAS,EACT,SAAS,EACT,kBAAkB,EAClB,KAAK,QAAQ,EACb,KAAK,eAAe,EAIpB,KAAK,YAAY,EACjB,MAAM,mBAAmB,CAAC;AAK3B,OAAO,EAiBN,KAAK,YAAY,EAEjB,KAAK,WAAW,EAGhB,KAAK,UAAU,EACf,MAAM,kBAAkB,CAAC;AAO1B;;qDAEqD;AACrD,KAAK,YAAY,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAqDxE,YAAY,EAAE,YAAY,EAAE,CAAC;AAC7B,KAAK,iBAAiB,GAAG;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,WAAW,iBAAiB;IACjC,GAAG,CAAC,EAAE,iBAAiB,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,UAAU;IACtB,GAAG,EAAE,QAAQ,CAAC;IACd,GAAG,EAAE,iBAAiB,CAAC;IACvB,KAAK,EAAE,eAAe,GAAG,IAAI,CAAQ;IAKrC,mBAAmB,SAAK;IAGxB,gBAAgB,UAAS;IAMzB,WAAW;eAED,YAAY;qBAAe,MAAM;qBAAe,WAAW;sBAAgB,QAAQ;OACzF;IAIJ,gBAAgB,gCAAuC;IAIvD,WAAW;qBAGI,MAAM;qBACN,WAAW;eACjB,MAAM;iBACJ,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;OAEnC;IAGJ,QAAQ,SAAK;IAGb,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAQ;IAErC,iBAAiB,2BAA0C;IAE3D,cAAc,cAAkC;IAChD,WAAW,UAAiB;IAC5B,kBAAkB,gBAA+B;IACjD,cAAc,UAAgB;IAM9B,gBAAgB;gBACP,MAAM;gBACN,UAAU;wBACF,MAAM;aACP;IAMhB,WAAW,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAQ;gBAExE,GAAG,EAAE,QAAQ,EAAE,OAAO,GAAE,iBAAsB;IAO1D,aAAa,CAAC,CAAC,EAAE,YAAY,GAAG,CAAC,IAAI,SAAS;IAI9C,iBAAiB,CAAC,CAAC,EAAE,YAAY,GAAG,OAAO;IAI3C,UAAU,CAAC,CAAC,EAAE,YAAY;IAI1B,WAAW,CAAC,CAAC,EAAE,YAAY,GAAG,kBAAkB;IAIhD;;iEAE6D;IAC7D,cAAc,CAAC,CAAC,EAAE,YAAY,GAAG,OAAO;IAIxC,mEAAmE;IACnE,UAAU,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,GAAG,OAAO;IAIjD,WAAW,CAAC,CAAC,EAAE,YAAY,GAAG,IAAI,GAAG,OAAO;IAI5C,oBAAoB,CAAC,CAAC,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,SAA+B;IAQvF,iBAAiB,CAChB,CAAC,EAAE,YAAY,EACf,KAAK,EAAE,MAAM,GACX;QAAE,EAAE,EAAE,eAAe,CAAC;QAAC,cAAc,EAAE,MAAM,CAAA;KAAE;IAsBlD,oBAAoB,CACnB,CAAC,EAAE,YAAY,EACf,QAAQ,EAAE,MAAM,GACd;QAAE,EAAE,EAAE,eAAe,CAAC;QAAC,cAAc,EAAE,MAAM,CAAA;KAAE;IAoBlD,mFAAmF;IACnF,QAAQ,CAAC,CAAC,EAAE,YAAY,GAAG,MAAM;IAIjC,sBAAsB,IAAI,GAAG,CAAC,MAAM,CAAC;IAUrC,uBAAuB,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC;IASxC,yBAAyB,CAAC,EAAE,EAAE,MAAM;IAOpC,YAAY,CAAC,CAAC,EAAE,SAAS,GAAG,OAAO,GAAG,IAAI;IAY1C,oBAAoB,CAAC,EAAE,EAAE,MAAM;IAWzB,QAAQ,CAAC,CAAC,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IA8D5E,kBAAkB,CACvB,CAAC,EAAE,YAAY,EACf,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,UAAU,GAChB,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAQpC,YAAY,CAAC,CAAC,EAAE,YAAY;IAU5B,iBAAiB,CAChB,CAAC,EAAE,YAAY,EACf,GAAG,EAAE,iBAAiB,GAAG,IAAI,EAC7B,MAAM,EAAE,UAAU,GAAG,IAAI,EACzB,cAAc,CAAC,EAAE,MAAM;IAexB,WAAW,CAAC,CAAC,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI;IAqB7D,iBAAiB,CAAC,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAgBhE,aAAa,CAAC,CAAC,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;;;;IAOzD,YAAY,CACX,IAAI,EAAE,eAAe,EACrB,GAAG,EAAE,UAAU,GAAG,IAAI,EACtB,MAAM,EAAE,MAAM,GACZ;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE;IAmB7C,cAAc,sBAGZ;IACF,iBAAiB,gDAAyD;IAE1E,YAAY;;;;;;aAWT;IAEH,cAAc,yCAAiD;IAC/D,aAAa;;;;;;;;;;aAUV;IACH,YAAY;;;;;;;;;;aAYT;IAEH,eAAe,oBAIZ;IAEH,kBAAkB,kDAIf;IAKH,eAAe,oBAMb;IAEF,cAAc,SAIZ;IACF,WAAW,SAAqE;IAChF,iBAAiB,SAQd;IAEH,YAAY;aAvGF,MAAM;aAAO,MAAM;cAAQ,MAAM;MAyGzC;IACF,SAAS,SAAmC;IAC5C,SAAS,SAAmC;IAE5C,eAAe,SAIb;IACF,iBAAiB,SAAuE;IAOxF,YAAY;;;;MAKT;IAEH,mBAAmB,2BAUhB;IAEH,WAAW,iDAIT;IACF,kBAAkB,SAA8E;IAOhG,iBAAiB,SAUf;IACF,YAAY,gBAEV;IAEF,WAAW,gBAIR;IAKH,QAAQ,SAGL;IASH,iBAAiB,gBAed;IAEH,aAAa;;;aAKV;IAEH,SAAS;;;QAMN;IACH,aAAa,UAA0E;IAEvF,UAAU,UASR;IAIF,IAAI,QAAO,OAAO,CAAC,IAAI,CAAC,CA8CtB;IAEF,eAAe,GAAU,GAAG,SAAS,EAAE,eAAa,mBAgClD;IAEF;;qFAEiF;IACjF,OAAO,CAAC,UAAU;IAKlB,YAAY,GAAU,IAAI,MAAM,mBAU9B;IAKF,OAAO,CAAC,eAAe,CAOrB;IAEF,iBAAiB,GAAU,GAAG,SAAS,EAAE,QAAQ,UAAU,mBAYzD;IAEF,aAAa,GAAI,GAAG,SAAS,UAY3B;IAEF,eAAe,GAAU,GAAG,SAAS,EAAE,QAAQ,UAAU,mBAUvD;IAEF,mBAAmB,GAAI,GAAG,SAAS,UAOjC;IAEF,cAAc,GAAU,KAAK,MAAM,EAAE,KAAK,MAAM,mBAc9C;IAEF;;;;;eAKW;IACX,OAAO,CAAC,WAAW,CAYjB;IAEF;;uDAEmD;IACnD,gBAAgB,GAAU,GAAG,SAAS,KAAG,OAAO,CAAC,IAAI,CAAC,CAYpD;IAEF,aAAa,GAAI,GAAG,SAAS,UAI3B;IAEF;;;;;;8CAM0C;IAC1C,cAAc,GAAU,GAAG,SAAS,EAAE,QAAQ,YAAY,EAAE,KAAG,OAAO,CAAC,IAAI,CAAC,CA6B1E;IAEF;;4DAEwD;IACxD,OAAO,CAAC,eAAe;IAmBvB;;wEAEoE;IACpE,OAAO,CAAC,eAAe,CAKrB;IAEF,wBAAwB,GAAU,QAAQ,YAAY,EAAE,mBAwBtD;IAEF;+EAC2E;IAC3E,OAAO,CAAC,UAAU;IAOlB;;;gBAGY;IACZ,OAAO,CAAC,YAAY,CAqElB;IAEF,SAAS,GAAI,QAAQ,MAAM,EAAE,OAAO,MAAM,mBAAsD;IAEhG;;;+BAG2B;IAC3B,OAAO,CAAC,gBAAgB;IAIxB;;;;;;gFAM4E;IAC5E,OAAO,CAAC,iBAAiB,CAkDvB;IAEF,+EAA+E;IAC/E,OAAO,CAAC,IAAI;IAKZ;kFAC8E;IAC9E,UAAU,aAKR;IAEF,cAAc,GAAU,SAAS,MAAM,EAAE,OAAO,MAAM,mBA0BpD;IAEF;;mCAE+B;IAC/B,OAAO,CAAC,wBAAwB;IAMhC;gFAC4E;IAC5E,OAAO,CAAC,qBAAqB;IAa7B;kEAC8D;IAC9D,YAAY,GAAI,QAAQ,MAAM,EAAE,UAAU,MAAM,EAAE,OAAM;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAO,mBACV;IAEtE,iBAAiB,GAChB,SAAS,MAAM,EACf,UAAU,MAAM,EAChB,OAAM;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAO,mBA6B7B;IAEF,cAAc,aA2BZ;IAQF,QAAQ,GAAI,GAAG,YAAY,EAAE,QAAQ,UAAU,GAAG,IAAI,UAgHpD;IAEF,WAAW,GAAI,GAAG,SAAS,EAAE,QAAQ,UAAU,GAAG,IAAI,EAAE,YAAgB,UA+CtE;IAEF,WAAW,GAAI,OAAO,MAAM,UAY1B;IAEF,iBAAiB,GAAI,OAAO,MAAM,UAShC;IAEF,SAAS,GAAI,GAAG,YAAY,UAc1B;IAQF,iBAAiB,GAAI,GAAG,YAAY,EAAE,MAAM,WAAW,UAsBrD;IAEF;;;uDAGmD;IACnD,WAAW,GAAU,OAAO,QAAQ,GAAG,IAAI,EAAE,mBAsJ3C;IAEF;;;;2EAIuE;IACvE,OAAO,CAAC,sBAAsB,CAkB5B;IAEF;;;;;6CAKyC;IACzC,OAAO,CAAC,cAAc,CAoCpB;IAEF;gFAC4E;IAC5E,OAAO,CAAC,cAAc,CAYpB;IAEF;;yEAEqE;IACrE,OAAO,CAAC,YAAY;IAmBpB,uEAAuE;IACvE,aAAa,GAAI,GAAG,kBAAkB,UAQpC;IAEF;yEACqE;IACrE,cAAc,GAAI,QAAQ,MAAM,EAAE,OAAO,MAAM,UAQ7C;IAEF;0EACsE;IACtE,cAAc,GAAI,KAAK,MAAM,EAAE,KAAK,MAAM,UASxC;IAEF,wEAAwE;IACxE,aAAa,GAAI,GAAG,kBAAkB,UAKpC;IAEF,eAAe,GAAU,GAAG,kBAAkB,EAAE,QAAQ,UAAU,mBAIhE;IAEF;2DACuD;IACvD,SAAS,GAAI,KAAK,MAAM,EAAE,KAAK,MAAM,UAGnC;IAEF;iFAC6E;IAC7E,OAAO,CAAC,uBAAuB,CAmB7B;IAEF;;wCAEoC;IACpC,OAAO,CAAC,WAAW,CAajB;IAEF,sEAAsE;IACtE,gBAAgB,GAAU,GAAG,YAAY,KAAG,OAAO,CAAC,IAAI,CAAC,CASvD;IAEF;oEACgE;IAChE,aAAa,GAAU,GAAG,YAAY,EAAE,QAAQ,MAAM,KAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAaxE;IAEF,8DAA8D;IAC9D,OAAO,CAAC,YAAY;IAKpB,kBAAkB,GAAI,MAAM,eAAe,UAazC;IAOF,UAAU,GAAI,GAAG,YAAY,EAAE,KAAK,MAAM,EAAE,OAAO,MAAM,UA6BvD;IAKF,OAAO,CAAC,iBAAiB,CAAgE;IACzF,OAAO,CAAC,iBAAiB,CAAS;YAEpB,iBAAiB;IAuC/B,gBAAgB,GAAI,OAAO,MAAM,GAAG,SAAS,UAM3C;IAKF,cAAc,CAAC,CAAC,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,kBAAkB;IAalF,gBAAgB,GAAI,GAAG,YAAY,EAAE,QAAQ,MAAM,EAAE,OAAO,MAAM,UA0DhE;IAEF,gBAAgB,GAAI,OAAO,MAAM,GAAG,SAAS,UAQ3C;IAKF,OAAO,CAAC,kBAAkB,CAA8B;IAExD,YAAY,GAAU,OAAO,MAAM,mBAmBjC;IAEF,iBAAiB,GAAI,OAAO,MAAM,UAShC;IAEF,mBAAmB,aAQjB;IAEF,aAAa,eAA0B;IACvC,mBAAmB,eAAgC;CACnD;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,QAAQ,EAAE,OAAO,GAAE,iBAAsB,GAAG,UAAU,CAE3F"}