@tellegen/svelte 0.1.0

package/dist/TellegenMap.svelte.d.ts

@@ -0,0 +1,14 @@
+import 'maplibre-gl/dist/maplibre-gl.css';
+type $$ComponentProps = {
+    onbusclick: (caseId: string, busId: number) => void;
+    onlocalbusclick: (caseId: string, busId: number) => void;
+    onbranchclick?: (caseId: string, branchId: number) => void;
+    onlocalbranchclick?: (caseId: string, branchId: number) => void;
+    onmultibusclick: (caseId: string, busId: string) => void;
+    onplacecase: (lon: number, lat: number) => void;
+    onmapclick: () => void;
+};
+declare const TellegenMap: import("svelte").Component<$$ComponentProps, {}, "">;
+type TellegenMap = ReturnType<typeof TellegenMap>;
+export default TellegenMap;
+//# sourceMappingURL=TellegenMap.svelte.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TellegenMap.svelte.d.ts","sourceRoot":"","sources":["../src/lib/TellegenMap.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,kCAAkC,CAAC;AAgEzC,KAAK,gBAAgB,GAAI;IACxB,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACpD,eAAe,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACzD,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3D,kBAAkB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAChE,eAAe,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACzD,WAAW,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAChD,UAAU,EAAE,MAAM,IAAI,CAAC;CACvB,CAAC;AAkmCH,QAAA,MAAM,WAAW,sDAAwC,CAAC;AAC1D,KAAK,WAAW,GAAG,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC;AAClD,eAAe,WAAW,CAAC"}

package/dist/TellegenProvider.svelte

@@ -0,0 +1,38 @@
+<script lang="ts">
+	import { untrack, type Snippet } from 'svelte';
+	import {
+		resolveTellegenUiConfig,
+		setAppState,
+		setController,
+		setUiConfig,
+		type TellegenUiOptions
+	} from './context.svelte.js';
+	import { createController } from './controller.svelte.js';
+	import { createAppState } from './state.svelte.js';
+
+	interface Props extends TellegenUiOptions {
+		children?: Snippet;
+	}
+
+	let { apiBase, loadDefaultCases, docsHref, orgHref, orgLabel, showFooter, children }: Props =
+		$props();
+
+	const config = untrack(() =>
+		resolveTellegenUiConfig({
+			apiBase,
+			loadDefaultCases,
+			docsHref,
+			orgHref,
+			orgLabel,
+			showFooter
+		})
+	);
+	const app = createAppState();
+	const ctrl = createController(app, { apiBase: config.apiBase });
+
+	setUiConfig(config);
+	setAppState(app);
+	setController(ctrl);
+</script>
+
+{@render children?.()}

package/dist/TellegenProvider.svelte.d.ts

@@ -0,0 +1,9 @@
+import { type Snippet } from 'svelte';
+import { type TellegenUiOptions } from './context.svelte.js';
+interface Props extends TellegenUiOptions {
+    children?: Snippet;
+}
+declare const TellegenProvider: import("svelte").Component<Props, {}, "">;
+type TellegenProvider = ReturnType<typeof TellegenProvider>;
+export default TellegenProvider;
+//# sourceMappingURL=TellegenProvider.svelte.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TellegenProvider.svelte.d.ts","sourceRoot":"","sources":["../src/lib/TellegenProvider.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,EAAW,KAAK,OAAO,EAAE,MAAM,QAAQ,CAAC;AAC/C,OAAO,EAKL,KAAK,iBAAiB,EACtB,MAAM,qBAAqB,CAAC;AAK7B,UAAU,KAAM,SAAQ,iBAAiB;IACxC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACnB;AAiCF,QAAA,MAAM,gBAAgB,2CAAwC,CAAC;AAC/D,KAAK,gBAAgB,GAAG,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC5D,eAAe,gBAAgB,CAAC"}

package/dist/TellegenShell.svelte

@@ -0,0 +1,126 @@
+<script lang="ts">
+	import { onMount } from 'svelte';
+	import AppFooter from './components/AppFooter.svelte';
+	import AppHeader from './components/AppHeader.svelte';
+	import BusPicker from './components/BusPicker.svelte';
+	import ControlPanel from './components/ControlPanel.svelte';
+	import DropZone from './components/DropZone.svelte';
+	import PlacementCue from './components/PlacementCue.svelte';
+	import RestoreDefaultsButton from './components/RestoreDefaultsButton.svelte';
+	import SolveCard from './components/SolveCard.svelte';
+	import { getAppState, getController, getUiConfig } from './context.svelte.js';
+	import TellegenMap from './TellegenMap.svelte';
+
+	const FILE_DROP_QUERY = '(hover: hover) and (pointer: fine) and (min-width: 761px)';
+
+	const app = getAppState();
+	const ctrl = getController();
+	const config = getUiConfig();
+
+	let dragDepth = 0;
+
+	$effect(() => {
+		let hasDisplayMode = false;
+		for (const option of ctrl.displayOptions) {
+			if (option.mode === app.displayMode) {
+				hasDisplayMode = true;
+				break;
+			}
+		}
+		if (ctrl.displayOptions.length > 0 && !hasDisplayMode) {
+			app.displayMode = 'lmp';
+		}
+	});
+
+	onMount(() => {
+		if (config.loadDefaultCases) {
+			if (!ctrl.casesLoaded) void ctrl.load();
+		} else {
+			ctrl.casesLoaded = true;
+			app.requestFrame('all');
+		}
+
+		const query = window.matchMedia(FILE_DROP_QUERY);
+		const syncFileDropUi = () => {
+			ctrl.showFileDropUi = query.matches;
+			if (!ctrl.showFileDropUi) {
+				dragDepth = 0;
+				app.dragOver = false;
+			}
+		};
+		syncFileDropUi();
+		query.addEventListener('change', syncFileDropUi);
+		return () => query.removeEventListener('change', syncFileDropUi);
+	});
+
+	function dragHasFiles(e: DragEvent): boolean {
+		return ctrl.showFileDropUi && (e.dataTransfer?.types.includes('Files') ?? false);
+	}
+
+	function onDragEnter(e: DragEvent) {
+		if (!dragHasFiles(e)) return;
+		e.preventDefault();
+		dragDepth++;
+		app.dragOver = true;
+	}
+
+	function onDragLeave(e: DragEvent) {
+		if (!dragHasFiles(e)) return;
+		dragDepth = Math.max(0, dragDepth - 1);
+		if (dragDepth === 0) app.dragOver = false;
+	}
+
+	function onDragOver(e: DragEvent) {
+		if (!dragHasFiles(e)) return;
+		e.preventDefault();
+	}
+
+	function onDrop(e: DragEvent) {
+		if (!dragHasFiles(e)) return;
+		e.preventDefault();
+		dragDepth = 0;
+		app.dragOver = false;
+		if (e.dataTransfer) ctrl.ingestFiles(e.dataTransfer.files);
+	}
+</script>
+
+<svelte:window
+	onkeydown={(e) => {
+		if (e.key === 'Escape') ctrl.clearSelection();
+	}}
+	ondragenter={onDragEnter}
+	ondragleave={onDragLeave}
+	ondragover={onDragOver}
+	ondrop={onDrop}
+/>
+
+<main>
+	<TellegenMap
+		onbusclick={ctrl.selectBus}
+		onlocalbusclick={ctrl.selectLocalBus}
+		onbranchclick={ctrl.selectBranch}
+		onlocalbranchclick={ctrl.selectLocalBranch}
+		onmultibusclick={ctrl.selectMultiBus}
+		onplacecase={ctrl.placeCase}
+		onmapclick={ctrl.clearSelection}
+	/>
+
+	<AppHeader />
+	<ControlPanel />
+	<SolveCard />
+	<BusPicker />
+	<DropZone />
+	<PlacementCue />
+	<RestoreDefaultsButton />
+	{#if config.showFooter}
+		<AppFooter />
+	{/if}
+</main>
+
+<style>
+	main {
+		position: fixed;
+		inset: 0;
+		overflow: hidden;
+	}
+</style>

package/dist/TellegenShell.svelte.d.ts

@@ -0,0 +1,4 @@
+declare const TellegenShell: import("svelte").Component<Record<string, never>, {}, "">;
+type TellegenShell = ReturnType<typeof TellegenShell>;
+export default TellegenShell;
+//# sourceMappingURL=TellegenShell.svelte.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TellegenShell.svelte.d.ts","sourceRoot":"","sources":["../src/lib/TellegenShell.svelte.ts"],"names":[],"mappings":"AA4HA,QAAA,MAAM,aAAa,2DAAwC,CAAC;AAC5D,KAAK,aAAa,GAAG,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC;AACtD,eAAe,aAAa,CAAC"}

package/dist/TellegenViewer.svelte

@@ -0,0 +1,19 @@
+<script lang="ts">
+	import TellegenProvider from './TellegenProvider.svelte';
+	import TellegenShell from './TellegenShell.svelte';
+	import type { TellegenUiOptions } from './context.svelte.js';
+
+	let { apiBase, loadDefaultCases, docsHref, orgHref, orgLabel, showFooter }: TellegenUiOptions =
+		$props();
+</script>
+
+<TellegenProvider
+	{apiBase}
+	{loadDefaultCases}
+	{docsHref}
+	{orgHref}
+	{orgLabel}
+	{showFooter}
+>
+	<TellegenShell />
+</TellegenProvider>

package/dist/TellegenViewer.svelte.d.ts

@@ -0,0 +1,4 @@
+declare const TellegenViewer: import("svelte").Component<Partial<import("./context.svelte.js").TellegenUiConfig>, {}, "">;
+type TellegenViewer = ReturnType<typeof TellegenViewer>;
+export default TellegenViewer;
+//# sourceMappingURL=TellegenViewer.svelte.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TellegenViewer.svelte.d.ts","sourceRoot":"","sources":["../src/lib/TellegenViewer.svelte.ts"],"names":[],"mappings":"AAsBA,QAAA,MAAM,cAAc,6FAAwC,CAAC;AAC7D,KAAK,cAAc,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AACxD,eAAe,cAAc,CAAC"}

package/dist/api.d.ts

@@ -0,0 +1,44 @@
+import type { CaseSummary, DemandDeltas, Network, SensitivityColumn, Solution, SolveIteration } from '@tellegen/engine';
+export type { BranchRatingDeltas, CaseSummary, DemandDeltas, Network, NetworkBranch, NetworkBus, SensitivityColumn, Solution, SolveIteration } from '@tellegen/engine';
+type FetchLike = (input: string, init?: RequestInit) => Promise<Response>;
+export interface TellegenApiClientOptions {
+    apiBase?: string;
+    fetch?: FetchLike;
+    EventSource?: typeof EventSource;
+}
+export interface TellegenApiClient {
+    getCases(): Promise<CaseSummary[]>;
+    getNetwork(caseId: string): Promise<Network>;
+    getCaseNetworkJson(caseId: string, signal?: AbortSignal): Promise<string>;
+    getSolution(caseId: string): Promise<Solution>;
+    getSensitivity(caseId: string, bus: number, deltas?: DemandDeltas, signal?: AbortSignal): Promise<SensitivityColumn>;
+    getBranchSensitivity(caseId: string, branch: number, deltas?: DemandDeltas, signal?: AbortSignal): Promise<SensitivityColumn>;
+    /** Whether the server's compute endpoints (solve stream, sensitivities) are
+     * enabled on this deploy, so the frontend can pick honest fallback copy and
+     * skip doomed requests. */
+    getComputeStatus(signal?: AbortSignal): Promise<{
+        enabled: boolean;
+    }>;
+    openSolveStream(caseId: string, deltas: DemandDeltas, sensBus: number | null, handlers: SolveStreamHandlers): () => void;
+}
+/** A failed API request. `status` is the HTTP status, or 0 for a network
+ * failure (the request never completed). `serverMessage` is the backend's
+ * own `{"error": ...}` copy when the response carried one; edge-proxy
+ * rejections (e.g. Caddy 429s) have none. */
+export declare class ApiError extends Error {
+    status: number;
+    serverMessage: string | null;
+    constructor(message: string, status: number, serverMessage: string | null);
+}
+export interface SolveStreamHandlers {
+    onsolution?: (sol: Solution & {
+        case: string;
+        solve_ms: number;
+        iterations: SolveIteration[];
+    }) => void;
+    onsensitivity?: (col: SensitivityColumn) => void;
+    onfail?: (message: string) => void;
+    ondone?: () => void;
+}
+export declare function createApiClient(options?: TellegenApiClientOptions): TellegenApiClient;
+//# sourceMappingURL=api.d.ts.map

package/dist/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/lib/api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,WAAW,EACX,YAAY,EACZ,OAAO,EACP,iBAAiB,EACjB,QAAQ,EACR,cAAc,EACd,MAAM,kBAAkB,CAAC;AAE1B,YAAY,EACX,kBAAkB,EAClB,WAAW,EACX,YAAY,EACZ,OAAO,EACP,aAAa,EACb,UAAU,EACV,iBAAiB,EACjB,QAAQ,EACR,cAAc,EACd,MAAM,kBAAkB,CAAC;AAE1B,KAAK,SAAS,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAE1E,MAAM,WAAW,wBAAwB;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,WAAW,CAAC;CACjC;AAED,MAAM,WAAW,iBAAiB;IACjC,QAAQ,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IACnC,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7C,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1E,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC/C,cAAc,CACb,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,YAAY,EACrB,MAAM,CAAC,EAAE,WAAW,GAClB,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC9B,oBAAoB,CACnB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,YAAY,EACrB,MAAM,CAAC,EAAE,WAAW,GAClB,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC9B;;+BAE2B;IAC3B,gBAAgB,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACtE,eAAe,CACd,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,MAAM,GAAG,IAAI,EACtB,QAAQ,EAAE,mBAAmB,GAC3B,MAAM,IAAI,CAAC;CACd;AAwBD;;;6CAG6C;AAC7C,qBAAa,QAAS,SAAQ,KAAK;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;gBAEjB,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,IAAI;CAMzE;AA6CD,MAAM,WAAW,mBAAmB;IACnC,UAAU,CAAC,EAAE,CACZ,GAAG,EAAE,QAAQ,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,cAAc,EAAE,CAAA;KAAE,KAC5E,IAAI,CAAC;IACV,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,iBAAiB,KAAK,IAAI,CAAC;IACjD,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;CACpB;AAED,wBAAgB,eAAe,CAAC,OAAO,GAAE,wBAA6B,GAAG,iBAAiB,CAyEzF"}

package/dist/api.js

@@ -0,0 +1,137 @@
+function encodeDeltas(deltas) {
+    return Object.entries(deltas)
+        .filter(([, mw]) => mw !== 0)
+        .map(([bus, mw]) => `${bus}:${mw.toFixed(2)}`)
+        .join(',');
+}
+function apiPath(apiBase, path) {
+    const base = apiBase.replace(/\/+$/, '');
+    return `${base}${path}`;
+}
+function defaultFetch() {
+    if (typeof fetch === 'undefined')
+        throw new Error('fetch is not available');
+    return fetch.bind(globalThis);
+}
+function defaultEventSource() {
+    if (typeof EventSource === 'undefined')
+        throw new Error('EventSource is not available');
+    return EventSource;
+}
+/** A failed API request. `status` is the HTTP status, or 0 for a network
+ * failure (the request never completed). `serverMessage` is the backend's
+ * own `{"error": ...}` copy when the response carried one; edge-proxy
+ * rejections (e.g. Caddy 429s) have none. */
+export class ApiError extends Error {
+    status;
+    serverMessage;
+    constructor(message, status, serverMessage) {
+        super(message);
+        this.name = 'ApiError';
+        this.status = status;
+        this.serverMessage = serverMessage;
+    }
+}
+function userMessage(status, serverMessage) {
+    if (status === 0)
+        return 'server unreachable, check your connection';
+    if (status === 429)
+        return 'rate limited; wait a few seconds and try again';
+    if (status >= 500)
+        return 'server error, try again';
+    return serverMessage ?? `request failed (HTTP ${status})`;
+}
+async function checkedFetch(fetchImpl, url, signal) {
+    let res;
+    try {
+        res = await fetchImpl(url, { signal });
+    }
+    catch (e) {
+        // Aborts must pass through unchanged: the controller filters them by
+        // DOMException to distinguish cancellation from failure.
+        if (e instanceof DOMException)
+            throw e;
+        throw new ApiError(userMessage(0, null), 0, null);
+    }
+    if (!res.ok) {
+        let serverMessage = null;
+        try {
+            const body = (await res.json());
+            if (typeof body.error === 'string')
+                serverMessage = body.error;
+        }
+        catch {
+            // non-JSON body (edge-proxy rejections); keep serverMessage null
+        }
+        throw new ApiError(userMessage(res.status, serverMessage), res.status, serverMessage);
+    }
+    return res;
+}
+async function getJson(fetchImpl, url, signal) {
+    const res = await checkedFetch(fetchImpl, url, signal);
+    return res.json();
+}
+export function createApiClient(options = {}) {
+    const apiBase = options.apiBase ?? '/api';
+    const fetchImpl = options.fetch ?? defaultFetch();
+    return {
+        getCases: () => getJson(fetchImpl, apiPath(apiBase, '/cases')),
+        getNetwork: (caseId) => getJson(fetchImpl, apiPath(apiBase, `/cases/${caseId}/network`)),
+        async getCaseNetworkJson(caseId, signal) {
+            const url = apiPath(apiBase, `/cases/${caseId}/case`);
+            const res = await checkedFetch(fetchImpl, url, signal);
+            return res.text();
+        },
+        getSolution: (caseId) => getJson(fetchImpl, apiPath(apiBase, `/cases/${caseId}/solution`)),
+        getSensitivity(caseId, bus, deltas = {}, signal) {
+            const d = encodeDeltas(deltas);
+            const query = d ? `?d=${encodeURIComponent(d)}` : '';
+            return getJson(fetchImpl, apiPath(apiBase, `/cases/${caseId}/sensitivity/lmp/d/${bus}${query}`), signal);
+        },
+        getBranchSensitivity(caseId, branch, deltas = {}, signal) {
+            const d = encodeDeltas(deltas);
+            const query = d ? `?d=${encodeURIComponent(d)}` : '';
+            return getJson(fetchImpl, apiPath(apiBase, `/cases/${caseId}/sensitivity/lmp/fmax/${branch}${query}`), signal);
+        },
+        getComputeStatus(signal) {
+            return getJson(fetchImpl, apiPath(apiBase, `/compute`), signal);
+        },
+        openSolveStream(caseId, deltas, sensBus, handlers) {
+            const EventSourceImpl = options.EventSource ?? defaultEventSource();
+            const params = new URLSearchParams();
+            const d = encodeDeltas(deltas);
+            if (d)
+                params.set('d', d);
+            if (sensBus !== null)
+                params.set('sens', String(sensBus));
+            const qs = params.toString();
+            const es = new EventSourceImpl(apiPath(apiBase, `/cases/${caseId}/solve${qs ? `?${qs}` : ''}`));
+            let finished = false;
+            const finish = () => {
+                finished = true;
+                es.close();
+            };
+            es.addEventListener('solution', (e) => handlers.onsolution?.(JSON.parse(e.data)));
+            es.addEventListener('sensitivity', (e) => handlers.onsensitivity?.(JSON.parse(e.data)));
+            es.addEventListener('fail', (e) => {
+                finish();
+                handlers.onfail?.(JSON.parse(e.data).error ?? 'solve failed');
+            });
+            es.addEventListener('done', () => {
+                finish();
+                handlers.ondone?.();
+            });
+            es.onerror = () => {
+                // EventSource auto-reconnects; a closed-by-server stream after "done"
+                // never reaches here because finish() already ran.
+                if (!finished) {
+                    finish();
+                    // EventSource exposes no status code, so this covers both a lost
+                    // connection and a rate-limited stream open.
+                    handlers.onfail?.('solve stream interrupted; server busy or rate limited, try again in a few seconds');
+                }
+            };
+            return finish;
+        }
+    };
+}

package/dist/colors.d.ts

@@ -0,0 +1,51 @@
+import type { DisplayMode } from './state.svelte.js';
+export type RGBA = [number, number, number, number];
+export interface SensitivityDomain {
+    min: number;
+    max: number;
+    mean: number;
+    absMax: number;
+    scale: number;
+    flat: boolean;
+}
+export declare const lmpColor: (t: number) => RGBA;
+export declare const lmpGradient: string;
+/** Trimmed LMP color domain: 5th to 95th percentile, with a $1/MWh
+ * minimum span. LMP distributions are heavy tailed (one binding line pins a
+ * handful of buses far from the pack) so min-max scaling compresses the pack
+ * into a single hue, and a congestion-free case is one price plus solver
+ * noise that an exact scale would stretch into fake structure. Values beyond
+ * the domain clamp to the ramp ends. */
+export declare function lmpDomain(values: number[]): {
+    lo: number;
+    hi: number;
+};
+/** Center a scalar display variable (bus voltage angle, |V|) on a symmetric domain
+ * with a per-mode minimum span; LMP keeps its own robust quantile domain. Shared by
+ * the control panel readout and the map color scale. */
+export declare function scalarDomain(mode: DisplayMode, values: number[]): {
+    lo: number;
+    hi: number;
+};
+/** t in [-1, 1] */
+export declare const sensColor: (t: number) => RGBA;
+export declare const sensGradient: string;
+export declare const sensNeutral: RGBA;
+export declare const busNeutral: RGBA;
+export declare function sensFlatColor(domain: Pick<SensitivityDomain, 'mean'>): RGBA;
+/** The fixed normalization for a slider drag: predicted ΔLMP divides by
+ * scale × maxAbsStep, so color intensity is linear in the step and saturates at
+ * full deflection for the column's robust-max buses. A per-frame domain over
+ * column × step would cancel the step exactly (sensitivityDomain is degree-1
+ * homogeneous), freezing the intensity. Null for flat columns, whose scale is
+ * meaningless. */
+export declare function previewScaleFor(domain: Pick<SensitivityDomain, 'scale' | 'flat'>, maxAbsStep: number): number | null;
+/** Zero anchored sensitivity domain with a flat column guard. */
+export declare function sensitivityDomain(values: number[]): SensitivityDomain;
+/** Branch color by loading fraction: warm gray, amber past 0.6, red past 0.9. */
+export declare function branchColor(loading: number, inService: boolean): RGBA;
+export declare function branchWidth(loading: number): number;
+/** Bus radius in px; area tracks max(load, gen) so big plants and big loads
+ * both read at a glance. Shared by the map layers and the size legend. */
+export declare function busRadius(maxMw: number): number;
+//# sourceMappingURL=colors.d.ts.map

package/dist/colors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"colors.d.ts","sourceRoot":"","sources":["../src/lib/colors.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,MAAM,MAAM,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAEpD,MAAM,WAAW,iBAAiB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;CACd;AAqCD,eAAO,MAAM,QAAQ,GAAI,GAAG,MAAM,KAAG,IAA0B,CAAC;AAChE,eAAO,MAAM,WAAW,QAAyB,CAAC;AAElD;;;;;wCAKwC;AACxC,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAStE;AAED;;wDAEwD;AACxD,wBAAgB,YAAY,CAAC,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAQ5F;AAcD,mBAAmB;AACnB,eAAO,MAAM,SAAS,GAAI,GAAG,MAAM,KAAG,IAAqC,CAAC;AAC5E,eAAO,MAAM,YAAY,QAA0B,CAAC;AACpD,eAAO,MAAM,WAAW,EAAE,IAAoB,CAAC;AAC/C,eAAO,MAAM,UAAU,EAAE,IAA2B,CAAC;AAIrD,wBAAgB,aAAa,CAAC,MAAM,EAAE,IAAI,CAAC,iBAAiB,EAAE,MAAM,CAAC,GAAG,IAAI,CAG3E;AAED;;;;;kBAKkB;AAClB,wBAAgB,eAAe,CAC9B,MAAM,EAAE,IAAI,CAAC,iBAAiB,EAAE,OAAO,GAAG,MAAM,CAAC,EACjD,UAAU,EAAE,MAAM,GAChB,MAAM,GAAG,IAAI,CAGf;AAED,iEAAiE;AACjE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,iBAAiB,CAuBrE;AAED,iFAAiF;AACjF,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,IAAI,CAMrE;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;0EAC0E;AAC1E,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/C"}

package/dist/colors.js

@@ -0,0 +1,140 @@
+import { extent } from './format.js';
+function lerp(a, b, t) {
+    return a + (b - a) * t;
+}
+function lerpColor(a, b, t) {
+    return [
+        Math.round(lerp(a[0], b[0], t)),
+        Math.round(lerp(a[1], b[1], t)),
+        Math.round(lerp(a[2], b[2], t)),
+        Math.round(lerp(a[3], b[3], t))
+    ];
+}
+function ramp(stops, t) {
+    const x = Math.min(1, Math.max(0, t)) * (stops.length - 1);
+    const i = Math.min(stops.length - 2, Math.floor(x));
+    return lerpColor(stops[i], stops[i + 1], x - i);
+}
+function cssGradient(stops) {
+    const parts = stops.map((s) => `rgb(${s[0]} ${s[1]} ${s[2]})`);
+    return `linear-gradient(90deg, ${parts.join(', ')})`;
+}
+/** Sequential LMP ramp, cheap to expensive: pale straw darkening through
+ * amber and rust to near-black maroon. Lightness falls monotonically, so the
+ * ordering survives every kind of color vision deficiency. */
+const LMP_STOPS = [
+    [246, 227, 180, 235],
+    [236, 178, 66, 235],
+    [212, 116, 34, 240],
+    [160, 56, 21, 245],
+    [84, 18, 7, 250]
+];
+export const lmpColor = (t) => ramp(LMP_STOPS, t);
+export const lmpGradient = cssGradient(LMP_STOPS);
+/** Trimmed LMP color domain: 5th to 95th percentile, with a $1/MWh
+ * minimum span. LMP distributions are heavy tailed (one binding line pins a
+ * handful of buses far from the pack) so min-max scaling compresses the pack
+ * into a single hue, and a congestion-free case is one price plus solver
+ * noise that an exact scale would stretch into fake structure. Values beyond
+ * the domain clamp to the ramp ends. */
+export function lmpDomain(values) {
+    if (values.length === 0)
+        return { lo: 0, hi: 1 };
+    const sorted = [...values].sort((a, b) => a - b);
+    const q = (p) => sorted[Math.min(sorted.length - 1, Math.floor(p * sorted.length))];
+    const lo = q(0.05);
+    const hi = q(0.95);
+    const mid = (lo + hi) / 2;
+    const span = Math.max(hi - lo, 1);
+    return { lo: mid - span / 2, hi: mid + span / 2 };
+}
+/** Center a scalar display variable (bus voltage angle, |V|) on a symmetric domain
+ * with a per-mode minimum span; LMP keeps its own robust quantile domain. Shared by
+ * the control panel readout and the map color scale. */
+export function scalarDomain(mode, values) {
+    if (mode === 'lmp')
+        return lmpDomain(values);
+    if (values.length === 0)
+        return { lo: 0, hi: 1 };
+    const { min: rawLo, max: rawHi } = extent(values);
+    const minSpan = mode === 'voltage' ? 0.02 : 0.04;
+    const span = Math.max(rawHi - rawLo, minSpan);
+    const mid = (rawLo + rawHi) / 2;
+    return { lo: mid - span / 2, hi: mid + span / 2 };
+}
+/** Diverging sensitivity ramp: green (price falls per MW of demand) through
+ * a paper-toned neutral to purple (price rises). The green/purple pair stays
+ * legible under CVD and shares no hue with the warm LMP ramp, so the two
+ * modes cannot be confused. */
+const SENS_STOPS = [
+    [27, 120, 55, 240],
+    [127, 191, 123, 230],
+    [223, 219, 208, 160],
+    [194, 165, 207, 230],
+    [118, 42, 131, 240]
+];
+/** t in [-1, 1] */
+export const sensColor = (t) => ramp(SENS_STOPS, (t + 1) / 2);
+export const sensGradient = cssGradient(SENS_STOPS);
+export const sensNeutral = SENS_STOPS[2];
+export const busNeutral = [180, 175, 165, 200];
+const FLAT_SENSITIVITY_TINT = 0.55;
+export function sensFlatColor(domain) {
+    if (domain.mean === 0)
+        return sensNeutral;
+    return sensColor(domain.mean > 0 ? FLAT_SENSITIVITY_TINT : -FLAT_SENSITIVITY_TINT);
+}
+/** The fixed normalization for a slider drag: predicted ΔLMP divides by
+ * scale × maxAbsStep, so color intensity is linear in the step and saturates at
+ * full deflection for the column's robust-max buses. A per-frame domain over
+ * column × step would cancel the step exactly (sensitivityDomain is degree-1
+ * homogeneous), freezing the intensity. Null for flat columns, whose scale is
+ * meaningless. */
+export function previewScaleFor(domain, maxAbsStep) {
+    if (domain.flat)
+        return null;
+    return domain.scale * Math.max(maxAbsStep, 1e-9);
+}
+/** Zero anchored sensitivity domain with a flat column guard. */
+export function sensitivityDomain(values) {
+    if (values.length === 0) {
+        return { min: 0, max: 0, mean: 0, absMax: 0, scale: 1, flat: true };
+    }
+    const sorted = [...values].sort((a, b) => a - b);
+    const q = (p) => sorted[Math.min(sorted.length - 1, Math.floor(p * sorted.length))];
+    const min = sorted[0];
+    const max = sorted[sorted.length - 1];
+    const mean = values.reduce((acc, v) => acc + v, 0) / values.length;
+    // The largest absolute value sits at one sorted extreme; computing it from the
+    // endpoints avoids spreading one argument per bus into Math.max (a RangeError on
+    // very large cases).
+    const absMax = Math.max(Math.abs(min), Math.abs(max));
+    const robust = Math.max(Math.abs(q(0.01)), Math.abs(q(0.99)));
+    const flat = max - min <= Math.max(1e-7, 0.01 * absMax);
+    return {
+        min,
+        max,
+        mean,
+        absMax,
+        scale: Math.max(robust, 1e-12),
+        flat
+    };
+}
+/** Branch color by loading fraction: warm gray, amber past 0.6, red past 0.9. */
+export function branchColor(loading, inService) {
+    if (!inService)
+        return [197, 191, 178, 110];
+    if (loading < 0.6)
+        return [138, 131, 117, 200];
+    if (loading < 0.9)
+        return lerpColor([138, 131, 117, 210], [212, 116, 34, 240], (loading - 0.6) / 0.3);
+    return [179, 38, 30, 250];
+}
+export function branchWidth(loading) {
+    return 1.6 + 3.4 * Math.min(1, loading);
+}
+/** Bus radius in px; area tracks max(load, gen) so big plants and big loads
+ * both read at a glance. Shared by the map layers and the size legend. */
+export function busRadius(maxMw) {
+    return 3.2 + 0.45 * Math.sqrt(Math.max(maxMw, 1));
+}