@tellegen/svelte 0.1.2 → 0.3.0

package/dist/diagram-labels.d.ts

@@ -0,0 +1,9 @@
+type PositionedLabel = {
+    id: number;
+    lon: number;
+    lat: number;
+    name?: string | null;
+};
+/** Place labels in screen pixels so zooming reveals equipment names as space opens. */
+export declare function diagramLabels(buses: PositionedLabel[], scale: number, x: number, y: number, width: number, height: number, selected: number | null): Set<number>;
+export {};

package/dist/diagram-labels.js

@@ -0,0 +1,40 @@
+/** Place labels in screen pixels so zooming reveals equipment names as space opens. */
+export function diagramLabels(buses, scale, x, y, width, height, selected) {
+    const visible = new Set();
+    const cells = new Map();
+    const order = selected === null
+        ? buses
+        : [
+            ...buses.filter((bus) => bus.id === selected),
+            ...buses.filter((bus) => bus.id !== selected)
+        ];
+    for (const bus of order) {
+        const label = bus.name || String(bus.id);
+        const left = bus.lon * scale + x + 8;
+        const bottom = bus.lat * scale + y - 7;
+        const box = { left, bottom, right: left + label.length * 7 + 6, top: bottom - 16 };
+        if (box.right < 0 || box.left > width || box.bottom < 0 || box.top > height)
+            continue;
+        const keys = [];
+        let overlaps = false;
+        for (let col = Math.floor(Math.max(0, box.left) / 64); col <= Math.floor(Math.min(width, box.right) / 64); col++) {
+            for (let row = Math.floor(Math.max(0, box.top) / 64); row <= Math.floor(Math.min(height, box.bottom) / 64); row++) {
+                const key = `${col},${row}`;
+                keys.push(key);
+                if (cells
+                    .get(key)
+                    ?.some((other) => box.left < other.right &&
+                    box.right > other.left &&
+                    box.top < other.bottom &&
+                    box.bottom > other.top))
+                    overlaps = true;
+            }
+        }
+        if (overlaps)
+            continue;
+        visible.add(bus.id);
+        for (const key of keys)
+            cells.set(key, [...(cells.get(key) ?? []), box]);
+    }
+    return visible;
+}

package/dist/display.d.ts

@@ -10,14 +10,10 @@ export type DisplayOption = {
     copy: string;
     gradient: string;
 };
-/** The display variables available for a case's current solution and formulation:
- * LMP always, the DC phase angle under DC OPF, the relaxed |V| under SOCWR. Metadata
- * only; call `displaySeriesFor` for one mode's per-bus values. Empty when unsolved. */
+/** Variables present in the current result. Power flow has no LMP values. */
 export declare function displayMetaFor(c: SolvableCase | null): DisplayOption[];
-/** Per-bus values for one display mode: LMP in $/MWh, the DC phase angle in rad, or
- * the SOCWR voltage magnitude (sqrt of the squared-voltage variable w, clamped at 0).
- * Empty when the case is unsolved. Single source for both the panel legend stats and
- * the map node coloring, so the |V| transform stays in one place. */
+/** Bus LMPs, voltage angles in radians, or voltage magnitudes in per unit.
+ * SOCWR supplies squared voltages, which are converted to magnitudes here. */
 export declare function displaySeriesFor(c: SolvableCase | null, mode: DisplayMode): {
     bus: number;
     value: number;
@@ -28,4 +24,3 @@ export declare function caseDeltas(c: SolvableCase): DemandDeltas;
 /** The committed branch rating deltas for a case (MW from base, keyed by branch).
  * The rating counterpart of `caseDeltas`. */
 export declare function caseRatings(c: SolvableCase): BranchRatingDeltas;
-//# sourceMappingURL=display.d.ts.map

package/dist/display.js

@@ -1,45 +1,44 @@
-import { lmpGradient } from './colors.js';
+import { priceGradient } from './colors.js';
 import { priceCopy } from './format.js';
 import { CaseState } from './state.svelte.js';
-/** The display variables available for a case's current solution and formulation:
- * LMP always, the DC phase angle under DC OPF, the relaxed |V| under SOCWR. Metadata
- * only; call `displaySeriesFor` for one mode's per-bus values. Empty when unsolved. */
+/** Variables present in the current result. Power flow has no LMP values. */
 export function displayMetaFor(c) {
     if (!c?.solution)
         return [];
-    const options = [
-        {
-            mode: 'lmp',
+    const options = [];
+    if (c.formulation !== 'acpf' && c.solution.prices.length > 0) {
+        options.push({
+            mode: 'price',
             label: 'LMP',
-            unit: '$/MWh',
+            unit: 'objective units/MW',
             copy: priceCopy(c.formulation),
-            gradient: lmpGradient
-        }
-    ];
-    if (c.formulation === 'dcopf' && c.solution.va.length > 0) {
-        options.push({
-            mode: 'angle',
-            label: 'angle',
-            unit: 'rad',
-            copy: 'DC bus voltage phase angle from the current OPF solution.',
-            gradient: lmpGradient
+            gradient: priceGradient
         });
     }
-    if (c.formulation === 'socwr' && c.solution.w.length > 0) {
+    if (c.solution.vm?.length || c.solution.w.length > 0) {
         options.push({
             mode: 'voltage',
             label: '|V|',
             unit: 'pu',
-            copy: 'SOCWR voltage magnitude from the current relaxed solution.',
-            gradient: lmpGradient
+            copy: c.formulation === 'socwr'
+                ? 'SOCWR voltage magnitude from the current relaxed solution.'
+                : 'Bus voltage magnitude from the current power-flow result.',
+            gradient: priceGradient
+        });
+    }
+    if (c.solution.va.length > 0) {
+        options.push({
+            mode: 'angle',
+            label: 'angle',
+            unit: 'rad',
+            copy: 'Bus voltage angle from the current result.',
+            gradient: priceGradient
         });
     }
     return options;
 }
-/** Per-bus values for one display mode: LMP in $/MWh, the DC phase angle in rad, or
- * the SOCWR voltage magnitude (sqrt of the squared-voltage variable w, clamped at 0).
- * Empty when the case is unsolved. Single source for both the panel legend stats and
- * the map node coloring, so the |V| transform stays in one place. */
+/** Bus LMPs, voltage angles in radians, or voltage magnitudes in per unit.
+ * SOCWR supplies squared voltages, which are converted to magnitudes here. */
 export function displaySeriesFor(c, mode) {
     const sol = c?.solution;
     if (!sol)
@@ -47,9 +46,14 @@ export function displaySeriesFor(c, mode) {
     if (mode === 'angle')
         return sol.va;
     if (mode === 'voltage') {
-        return sol.w.map((s) => ({ bus: s.bus, value: Math.sqrt(Math.max(0, s.value)) }));
+        if (sol.vm?.length)
+            return sol.vm;
+        return sol.w.map((s) => ({
+            bus: s.bus,
+            value: Math.sqrt(Math.max(0, s.value))
+        }));
     }
-    return sol.lmp.map((s) => ({ bus: s.bus, value: s.usd_per_mwh }));
+    return sol.prices.map((s) => ({ bus: s.bus, value: s.value }));
 }
 /** The committed demand deltas for a case (MW from base, keyed by bus). A backend
  * case always carries a deltas map; a local case defaults to an empty one. */

package/dist/drop-classify.d.ts

@@ -1,48 +1,11 @@
-/** The single owner of drop-file classification: given a file name or its JSON
- * content, decide which ingest path handles it. Extension routing (`.dss`, and
- * the balanced `.m`/`.raw`/`.aux` via `formatOf` in the engine) is name-based;
- * everything under `.json` is content-sniffed here so there is one place that
- * decides package-vs-case and balanced-vs-multiconductor.
- *
- * The rules mirror the readers they feed:
- *   - a `.pio.json` package is recognized by its `schema` envelope field, then
- *     split by the authoritative `model_kind` (balanced restores a study;
- *     multiconductor is viewed);
- *   - a non-package document is distribution JSON, PMD when it carries the
- *     `data_model` marker and BMOPF otherwise (the same split
- *     `powerio_dist` uses for `.json`), except a GeoJSON FeatureCollection,
- *     which stays unrouted so the geo sidecar path keeps accepting it.
- *
- * Every function is total: malformed, truncated, or non-JSON input classifies
- * as `not-json` rather than throwing. */
-/** The schema URL prefix every `.pio.json` package envelope carries. */
-export declare const PIO_PACKAGE_SCHEMA_PREFIX = "https://powerio.dev/schema/pio-package";
-/** How a dropped JSON file should be ingested. */
-export type JsonDropKind = 
-/** A saved balanced study package: restore the case, edits, and formulation. */
-'balanced-package'
-/** A package carrying a multiconductor payload: view it (no solve). */
- | 'multiconductor-package'
-/** A BMOPF JSON distribution case. */
- | 'bmopf'
-/** A PowerModelsDistribution ENGINEERING JSON case. */
- | 'pmd'
-/** Not JSON, or JSON we do not route (left to the generic error path). */
- | 'not-json';
+/** File name helpers for drop routing. JSON content classification lives in
+ * powerio's Rust/Wasm `classify_json_bytes` path, not in this TypeScript layer. */
 /** The distribution format for a file recognized by extension, or null. Only
- * `.dss` is name-routed; PMD and BMOPF share the `.json` extension and are
- * content-sniffed by {@link classifyJson}. */
+ * `.dss` is name routed; PMD and BMOPF share the `.json` extension and are
+ * classified by the engine. */
 export declare function distExtensionFormat(name: string): 'dss' | null;
 /** True for geographic sidecar files by extension (`.csv`, `.json`,
  * `.geojson`). Routable `.json` content (packages, distribution documents) is
- * consumed by {@link classifyJson} before this applies; what remains parses
+ * consumed by the engine classifier before this applies; what remains parses
  * through the engine's tolerant geo reader. */
 export declare function isGeoFileName(name: string): boolean;
-/** Whether `text` is a `.pio.json` package envelope, by its `schema` field. */
-export declare function isPackageEnvelope(obj: Record<string, unknown> | null): boolean;
-/** Classify a dropped JSON document into its ingest path. */
-export declare function classifyJson(text: string): JsonDropKind;
-/** Whether `text` is a saved study package (a balanced `.pio.json`). Kept for
- * the study-restore path; multiconductor packages are viewed, not restored. */
-export declare function isStudyPackageText(text: string): boolean;
-//# sourceMappingURL=drop-classify.d.ts.map

package/dist/drop-classify.js

@@ -1,31 +1,14 @@
-/** The single owner of drop-file classification: given a file name or its JSON
- * content, decide which ingest path handles it. Extension routing (`.dss`, and
- * the balanced `.m`/`.raw`/`.aux` via `formatOf` in the engine) is name-based;
- * everything under `.json` is content-sniffed here so there is one place that
- * decides package-vs-case and balanced-vs-multiconductor.
- *
- * The rules mirror the readers they feed:
- *   - a `.pio.json` package is recognized by its `schema` envelope field, then
- *     split by the authoritative `model_kind` (balanced restores a study;
- *     multiconductor is viewed);
- *   - a non-package document is distribution JSON, PMD when it carries the
- *     `data_model` marker and BMOPF otherwise (the same split
- *     `powerio_dist` uses for `.json`), except a GeoJSON FeatureCollection,
- *     which stays unrouted so the geo sidecar path keeps accepting it.
- *
- * Every function is total: malformed, truncated, or non-JSON input classifies
- * as `not-json` rather than throwing. */
-/** The schema URL prefix every `.pio.json` package envelope carries. */
-export const PIO_PACKAGE_SCHEMA_PREFIX = 'https://powerio.dev/schema/pio-package';
+/** File name helpers for drop routing. JSON content classification lives in
+ * powerio's Rust/Wasm `classify_json_bytes` path, not in this TypeScript layer. */
 /** The distribution format for a file recognized by extension, or null. Only
- * `.dss` is name-routed; PMD and BMOPF share the `.json` extension and are
- * content-sniffed by {@link classifyJson}. */
+ * `.dss` is name routed; PMD and BMOPF share the `.json` extension and are
+ * classified by the engine. */
 export function distExtensionFormat(name) {
     return name.split('.').pop()?.toLowerCase() === 'dss' ? 'dss' : null;
 }
 /** True for geographic sidecar files by extension (`.csv`, `.json`,
  * `.geojson`). Routable `.json` content (packages, distribution documents) is
- * consumed by {@link classifyJson} before this applies; what remains parses
+ * consumed by the engine classifier before this applies; what remains parses
  * through the engine's tolerant geo reader. */
 export function isGeoFileName(name) {
     const dot = name.lastIndexOf('.');
@@ -34,59 +17,3 @@ export function isGeoFileName(name) {
     const ext = name.slice(dot + 1).toLowerCase();
     return ext === 'csv' || ext === 'json' || ext === 'geojson';
 }
-/** Parse `text` as JSON, returning the top-level object or null. */
-function topLevelObject(text) {
-    let value;
-    try {
-        value = JSON.parse(text);
-    }
-    catch {
-        return null;
-    }
-    return typeof value === 'object' && value !== null && !Array.isArray(value)
-        ? value
-        : null;
-}
-/** Whether `text` is a `.pio.json` package envelope, by its `schema` field. */
-export function isPackageEnvelope(obj) {
-    return typeof obj?.schema === 'string' && obj.schema.startsWith(PIO_PACKAGE_SCHEMA_PREFIX);
-}
-/** The package's model family. `model_kind` is authoritative and stored
- * explicitly; fall back to the payload's own `model.kind` tag for a package
- * written before the field existed. */
-function packageModelKind(obj) {
-    const explicit = obj.model_kind;
-    if (explicit === 'balanced' || explicit === 'multiconductor')
-        return explicit;
-    const payloadKind = obj.model?.kind;
-    if (payloadKind === 'balanced' || payloadKind === 'multiconductor')
-        return payloadKind;
-    return null;
-}
-/** Classify a dropped JSON document into its ingest path. */
-export function classifyJson(text) {
-    const obj = topLevelObject(text);
-    if (!obj)
-        return 'not-json';
-    if (isPackageEnvelope(obj)) {
-        const kind = packageModelKind(obj);
-        // A package with no readable kind is treated as balanced: that is the
-        // historical payload and the study-restore path fails closed on a
-        // non-balanced document anyway.
-        return kind === 'multiconductor' ? 'multiconductor-package' : 'balanced-package';
-    }
-    // A GeoJSON FeatureCollection saved as `.json` is coordinate data for the
-    // geo sidecar path, which accepted it before this classifier existed; leave
-    // it unrouted so it falls through.
-    if (Array.isArray(obj.features))
-        return 'not-json';
-    // Non-package JSON is a distribution document: PMD declares `data_model`,
-    // everything else is routed to BMOPF (which gives the precise parse error
-    // when it is neither).
-    return 'data_model' in obj ? 'pmd' : 'bmopf';
-}
-/** Whether `text` is a saved study package (a balanced `.pio.json`). Kept for
- * the study-restore path; multiconductor packages are viewed, not restored. */
-export function isStudyPackageText(text) {
-    return classifyJson(text) === 'balanced-package';
-}

package/dist/drop-limits.d.ts

@@ -0,0 +1,27 @@
+/** Browser drop limits. Each accepted file is copied into JavaScript and worker/wasm
+ * memory, so the whole batch is checked before any file contents are read. */
+export declare const MAX_DROP_FILES = 32;
+export declare const MAX_DROP_FILE_BYTES: number;
+export declare const MAX_DROP_TOTAL_BYTES: number;
+type DropFileDescriptor = {
+    readonly name: string;
+    readonly size: number;
+};
+/** One-at-a-time admission for browser ingestion. A second drop is refused
+ * while the first still owns its release callback, so independently valid
+ * batches cannot queue enough worker copies to bypass the aggregate limit. */
+export declare class DropBatchGate {
+    #private;
+    enter(): (() => void) | null;
+}
+/** Return bytes retained by an earlier routing pass, or read the file once when
+ * no retained buffer exists. Keeping this decision here makes the no-reread
+ * guarantee independently testable. */
+export declare function readDropFileBytes(file: {
+    arrayBuffer(): Promise<ArrayBuffer>;
+}, retained?: Uint8Array): Promise<Uint8Array>;
+/** Validate and materialize an array-like browser file batch without calling
+ * `Array.from` first. The count and every declared byte size must be safe integers,
+ * and aggregate addition is guarded before it is performed. */
+export declare function validateDropBatch<T extends DropFileDescriptor>(input: ArrayLike<T>): T[];
+export {};

package/dist/drop-limits.js

@@ -0,0 +1,83 @@
+/** Browser drop limits. Each accepted file is copied into JavaScript and worker/wasm
+ * memory, so the whole batch is checked before any file contents are read. */
+export const MAX_DROP_FILES = 32;
+export const MAX_DROP_FILE_BYTES = 128 * 1024 * 1024;
+export const MAX_DROP_TOTAL_BYTES = 128 * 1024 * 1024;
+/** One-at-a-time admission for browser ingestion. A second drop is refused
+ * while the first still owns its release callback, so independently valid
+ * batches cannot queue enough worker copies to bypass the aggregate limit. */
+export class DropBatchGate {
+    #active = false;
+    enter() {
+        if (this.#active)
+            return null;
+        this.#active = true;
+        let released = false;
+        return () => {
+            if (released)
+                return;
+            released = true;
+            this.#active = false;
+        };
+    }
+}
+/** Return bytes retained by an earlier routing pass, or read the file once when
+ * no retained buffer exists. Keeping this decision here makes the no-reread
+ * guarantee independently testable. */
+export async function readDropFileBytes(file, retained) {
+    return retained ?? new Uint8Array(await file.arrayBuffer());
+}
+/** Validate and materialize an array-like browser file batch without calling
+ * `Array.from` first. The count and every declared byte size must be safe integers,
+ * and aggregate addition is guarded before it is performed. */
+export function validateDropBatch(input) {
+    let length;
+    try {
+        length = input.length;
+    }
+    catch {
+        throw new Error('the dropped file count is invalid');
+    }
+    if (typeof length !== 'number' || !Number.isSafeInteger(length) || length < 0) {
+        throw new Error('the dropped file count is invalid');
+    }
+    if (length > MAX_DROP_FILES) {
+        throw new Error(`drop at most ${MAX_DROP_FILES} files at a time`);
+    }
+    const files = [];
+    let totalBytes = 0;
+    for (let index = 0; index < length; index++) {
+        let file;
+        try {
+            file = input[index];
+        }
+        catch {
+            throw new Error(`dropped file ${index + 1} is invalid`);
+        }
+        if (!file || typeof file !== 'object') {
+            throw new Error(`dropped file ${index + 1} is invalid`);
+        }
+        let size;
+        let name;
+        try {
+            size = file.size;
+            name = file.name;
+        }
+        catch {
+            throw new Error(`dropped file ${index + 1} is invalid`);
+        }
+        const label = typeof name === 'string' && name.length > 0 ? name : `dropped file ${index + 1}`;
+        if (typeof size !== 'number' || !Number.isSafeInteger(size) || size < 0) {
+            throw new Error(`${label} has an invalid file size`);
+        }
+        if (size > MAX_DROP_FILE_BYTES) {
+            throw new Error(`${label} exceeds the ${MAX_DROP_FILE_BYTES}-byte per-file limit`);
+        }
+        if (size > MAX_DROP_TOTAL_BYTES - totalBytes) {
+            throw new Error(`the dropped files exceed the ${MAX_DROP_TOTAL_BYTES}-byte total limit`);
+        }
+        totalBytes += size;
+        files.push(file);
+    }
+    return files;
+}

package/dist/format.d.ts

@@ -27,4 +27,3 @@ export declare const fmt: Intl.NumberFormat;
 export declare const signed: (v: number) => string;
 export declare const signedExp: (v: number) => string;
 export declare const displayFmt: (mode: DisplayMode, value: number) => string;
-//# sourceMappingURL=format.d.ts.map

package/dist/format.js

@@ -10,9 +10,10 @@ export function formulationHint(id) {
     return FORMULATIONS.find((f) => f.id === id)?.hint ?? id;
 }
 export function priceCopy(id) {
+    const definition = 'Locational marginal price (LMP): the change in the OPF objective for an additional MW at a bus, in objective units/MW.';
     return id === 'socwr'
-        ? 'Select a bus to see how relaxed prices change.'
-        : 'Select a bus to see how prices change.';
+        ? `${definition} Prices come from the SOCWR relaxation. Select a bus to see their sensitivity.`
+        : `${definition} Select a bus to see its demand sensitivity.`;
 }
 export function splitName(name) {
     const m = name.match(/^(.*?)\s*\((.*)\)$/);
@@ -22,7 +23,7 @@ export function solveMetaLabel(c) {
     if ((c.iterations ?? []).length > 1)
         return `${c.iterations?.length} iterations`;
     if (c.solveBackend === 'clarabel-wasm-server-sensitivity')
-        return 'server dLMP/dd';
+        return 'server price sensitivity';
     return c.solveBackend === 'rust-server' ? 'server solve' : 'browser solve';
 }
 export function rgbaCss([r, g, b, a]) {
@@ -46,4 +47,4 @@ export function extent(values) {
 export const fmt = new Intl.NumberFormat('en-US', { maximumFractionDigits: 1 });
 export const signed = (v) => `${v < 0 ? '−' : '+'}${fmt.format(Math.abs(v))}`;
 export const signedExp = (v) => `${v < 0 ? '−' : '+'}${Math.abs(v).toExponential(2)}`;
-export const displayFmt = (mode, value) => mode === 'lmp' ? fmt.format(value) : value.toFixed(3);
+export const displayFmt = (mode, value) => mode === 'price' ? fmt.format(value) : value.toFixed(3);

package/dist/index.d.ts

@@ -1,3 +1,8 @@
+export { getNoticeCenter, errorNoticeTitle } from './notices.svelte.js';
+export { default as ModelDetails } from './components/ModelDetails.svelte';
+export { default as PanelFrame } from './components/PanelFrame.svelte';
+export { getPanelLayout } from './panels.svelte.js';
+export type { PanelSide, PanelPosition, PanelBounds } from './panels.svelte.js';
 export { default as TellegenProvider } from './TellegenProvider.svelte';
 export { default as TellegenShell } from './TellegenShell.svelte';
 export { default as TellegenViewer } from './TellegenViewer.svelte';
@@ -6,16 +11,15 @@ export { DEFAULT_TELLEGEN_UI_CONFIG, getAppState, getController, getUiConfig, re
 export { ApiError, createApiClient } from './api.js';
 export { Controller, createController } from './controller.svelte.js';
 export { AppState, CaseState, LocalCase, MulticonductorCase, createAppState } from './state.svelte.js';
-export { attachmentColor, attachmentGlyph, edgeColor, edgeWidth, phaseColor, placeMultiView, buildGeographicView } from './multiconductor.js';
-export { classifyJson, distExtensionFormat, isStudyPackageText } from './drop-classify.js';
+export { attachmentColor, attachmentGlyph, edgeColor, edgeWidth, phaseColor, neutralTerminal, placeMultiView, buildGeographicView } from './multiconductor.js';
+export { distExtensionFormat } from './drop-classify.js';
 export { caseDeltas, caseRatings, displayMetaFor, displaySeriesFor } from './display.js';
-export { DEFAULT_FORMULATION, FORMULATIONS, BrowserStudy, Study, capabilities, createStudy, errorText, formatOf, ingestCase, isDisplayFile, isPermanentEngineFailure, parseDisplay, solveJson } from '@tellegen/engine';
+export { DEFAULT_FORMULATION, FORMULATIONS, BrowserStudy, Study, capabilities, createStudy, errorText, formatOf, classifyJson, ingestJsonDrop, ingestCase, isDisplayFile, isPermanentEngineFailure, parseDisplay, solveModule } from '@tellegen/engine';
 export type { BranchRatingDeltas, CaseSummary, DemandDeltas, Network, NetworkBranch, NetworkBus, SensitivityColumn, Solution, SolveIteration, SolveStreamHandlers, TellegenApiClient, TellegenApiClientOptions } from './api.js';
 export type { TellegenUiConfig, TellegenUiOptions } from './context.svelte.js';
 export type { ControllerOptions } from './controller.svelte.js';
 export type { DisplayOption } from './display.js';
-export type { DemandRangeMode, DisplayMode, FallbackTarget, LocalCaseInit, LocalSubstations, MultiCaseSummary, MultiCoordsKind, SolvableCase, SolveBackend } from './state.svelte.js';
-export type { JsonDropKind } from './drop-classify.js';
+export type { CameraSnapshot, DiagramCameraSnapshot, DemandRangeMode, DisplayMode, FallbackTarget, LocalCaseInit, LocalSubstations, MultiCaseSummary, MultiCoordsKind, SolvableCase, StudyDisplaySnapshot, SolveBackend } from './state.svelte.js';
 export type { MultiView, PlacedMultiBus, PlacedMultiEdge } from './multiconductor.js';
-export type { CaseFileSummary, DistAttachmentKind, DistEdgeKind, DistGraph, DistGraphAttachment, DistGraphBus, DistGraphEdge, DisplayPreview, Formulation, IngestedCase, IngestedDistCase, SensTarget, Topology, TopologyBranch, TopologyBus } from '@tellegen/engine';
-//# sourceMappingURL=index.d.ts.map
+export type { CaseFileSummary, DistAttachmentKind, DistEdgeKind, DistGraph, DistGraphAttachment, DistGraphBus, DistGraphEdge, DisplayPreview, Formulation, IngestedCase, IngestedDistCase, IngestedJsonDrop, JsonDropClassification, JsonDropKind, CapacityPlanBusWeightJson, CapacityPlanIterationJson, CapacityPlanOutcomeJson, CapacityPlanRatingChangeJson, CapacityPlanResultSummaryJson, CapacityPlanSpecJson, ImplicitObjectiveJson, SensTarget, Topology, TopologyBranch, TopologyBus } from '@tellegen/engine';
+export { default as McResults } from './components/McResults.svelte';

package/dist/index.js

@@ -1,3 +1,7 @@
+export { getNoticeCenter, errorNoticeTitle } from './notices.svelte.js';
+export { default as ModelDetails } from './components/ModelDetails.svelte';
+export { default as PanelFrame } from './components/PanelFrame.svelte';
+export { getPanelLayout } from './panels.svelte.js';
 export { default as TellegenProvider } from './TellegenProvider.svelte';
 export { default as TellegenShell } from './TellegenShell.svelte';
 export { default as TellegenViewer } from './TellegenViewer.svelte';
@@ -6,7 +10,8 @@ export { DEFAULT_TELLEGEN_UI_CONFIG, getAppState, getController, getUiConfig, re
 export { ApiError, createApiClient } from './api.js';
 export { Controller, createController } from './controller.svelte.js';
 export { AppState, CaseState, LocalCase, MulticonductorCase, createAppState } from './state.svelte.js';
-export { attachmentColor, attachmentGlyph, edgeColor, edgeWidth, phaseColor, placeMultiView, buildGeographicView } from './multiconductor.js';
-export { classifyJson, distExtensionFormat, isStudyPackageText } from './drop-classify.js';
+export { attachmentColor, attachmentGlyph, edgeColor, edgeWidth, phaseColor, neutralTerminal, placeMultiView, buildGeographicView } from './multiconductor.js';
+export { distExtensionFormat } from './drop-classify.js';
 export { caseDeltas, caseRatings, displayMetaFor, displaySeriesFor } from './display.js';
-export { DEFAULT_FORMULATION, FORMULATIONS, BrowserStudy, Study, capabilities, createStudy, errorText, formatOf, ingestCase, isDisplayFile, isPermanentEngineFailure, parseDisplay, solveJson } from '@tellegen/engine';
+export { DEFAULT_FORMULATION, FORMULATIONS, BrowserStudy, Study, capabilities, createStudy, errorText, formatOf, classifyJson, ingestJsonDrop, ingestCase, isDisplayFile, isPermanentEngineFailure, parseDisplay, solveModule } from '@tellegen/engine';
+export { default as McResults } from './components/McResults.svelte';

package/dist/map-bounds.d.ts

@@ -0,0 +1,5 @@
+export type MapBounds = [[number, number], [number, number]];
+/** Fold finite Web Mercator coordinates into map bounds. Invalid points are
+ * ignored so one malformed row cannot hide an otherwise usable network, and a
+ * single surviving point still yields a box `fitBounds` can frame. */
+export declare function foldMapBounds(points: Iterable<readonly [number, number]>): MapBounds | null;

package/dist/map-bounds.js

@@ -0,0 +1,41 @@
+/** Half-width given to an axis whose extent collapsed to a single value. A
+ * zero-span box makes `fitBounds` divide by zero, clamp to the map's maximum
+ * zoom, and slam the camera onto one point instead of framing it. */
+const DEGENERATE_PAD_DEGREES = 0.005;
+/** Fold finite Web Mercator coordinates into map bounds. Invalid points are
+ * ignored so one malformed row cannot hide an otherwise usable network, and a
+ * single surviving point still yields a box `fitBounds` can frame. */
+export function foldMapBounds(points) {
+    let minLon = Infinity;
+    let minLat = Infinity;
+    let maxLon = -Infinity;
+    let maxLat = -Infinity;
+    for (const [lon, lat] of points) {
+        if (!Number.isFinite(lon) ||
+            !Number.isFinite(lat) ||
+            lon < -180 ||
+            lon > 180 ||
+            lat < -85.05 ||
+            lat > 85.05) {
+            continue;
+        }
+        minLon = Math.min(minLon, lon);
+        minLat = Math.min(minLat, lat);
+        maxLon = Math.max(maxLon, lon);
+        maxLat = Math.max(maxLat, lat);
+    }
+    if (!Number.isFinite(minLon) || !Number.isFinite(minLat))
+        return null;
+    if (minLon === maxLon) {
+        minLon -= DEGENERATE_PAD_DEGREES;
+        maxLon += DEGENERATE_PAD_DEGREES;
+    }
+    if (minLat === maxLat) {
+        minLat -= DEGENERATE_PAD_DEGREES;
+        maxLat += DEGENERATE_PAD_DEGREES;
+    }
+    return [
+        [minLon, minLat],
+        [maxLon, maxLat]
+    ];
+}

package/dist/map.d.ts

@@ -1,9 +1,8 @@
 import type { ComponentProps } from 'svelte';
 import TellegenMap from './TellegenMap.svelte';
 export { default as TellegenMap } from './TellegenMap.svelte';
-export { branchColor, branchWidth, busNeutral, busRadius, lmpColor, lmpDomain, lmpGradient, scalarDomain, sensColor, sensFlatColor, sensGradient, sensNeutral, sensitivityDomain } from './colors.js';
+export { branchColor, branchWidth, busNeutral, busRadius, priceColor, priceDomain, priceGradient, scalarDomain, sensColor, sensFlatColor, sensGradient, sensNeutral, sensitivityDomain } from './colors.js';
 export { caseDeltas, displayMetaFor, displaySeriesFor } from './display.js';
 export type { RGBA, SensitivityDomain } from './colors.js';
 export type { DisplayOption } from './display.js';
 export type TellegenMapProps = ComponentProps<typeof TellegenMap>;
-//# sourceMappingURL=map.d.ts.map

package/dist/map.js

@@ -1,4 +1,4 @@
 import TellegenMap from './TellegenMap.svelte';
 export { default as TellegenMap } from './TellegenMap.svelte';
-export { branchColor, branchWidth, busNeutral, busRadius, lmpColor, lmpDomain, lmpGradient, scalarDomain, sensColor, sensFlatColor, sensGradient, sensNeutral, sensitivityDomain } from './colors.js';
+export { branchColor, branchWidth, busNeutral, busRadius, priceColor, priceDomain, priceGradient, scalarDomain, sensColor, sensFlatColor, sensGradient, sensNeutral, sensitivityDomain } from './colors.js';
 export { caseDeltas, displayMetaFor, displaySeriesFor } from './display.js';

package/dist/multiconductor.d.ts

@@ -12,6 +12,7 @@ export interface PlacedMultiBus {
     lat: number;
     terminals: string[];
     grounded: string[];
+    neutral_terminal?: string | null;
     load_kw: number;
     gen_kw: number;
     has_source: boolean;
@@ -28,7 +29,7 @@ export interface PlacedMultiEdge {
     conductors: [string, string][];
     closed: boolean;
     n_phases: number;
-    path: [[number, number], [number, number]];
+    path: [number, number][];
 }
 /** The placed graph the map renders. */
 export interface MultiView {
@@ -37,7 +38,11 @@ export interface MultiView {
 }
 /** Place a geographic graph: each bus's `xy` is `[longitude, latitude]` and
  * drops straight onto the map. */
-export declare function buildGeographicView(graph: DistGraph): MultiView;
+export declare function buildGeographicView(graph: DistGraph, layer?: string): MultiView;
+/** Retain native drawing positions; unpositioned buses receive a separate generated layout. */
+export declare function buildDiagramView(graph: DistGraph, layer?: string): MultiView;
+/** Numeric indices address drawing objects only; source identities remain on each object. */
+export declare function multiDiagramNetwork(id: string, name: string, view: MultiView): import('./api.js').Network;
 /** Place a non-geographic graph at a map `center`: fit the provided planar
  * coordinates when the case carries them, otherwise fall back to the shared
  * synthetic force layout. */
@@ -48,6 +53,10 @@ export declare function placeMultiView(graph: DistGraph, center: PlacementCenter
 export declare function phaseColor(terminal: string): RGBA;
 /** True when a terminal is a phase conductor (not a neutral/ground return). */
 export declare function isPhaseTerminal(terminal: string): boolean;
+/** Return the explicit neutral conductor in a terminal map. Other non-phase
+ * labels are left alone: an arbitrary terminal name is not evidence that the
+ * network has a usable neutral reference. */
+export declare function neutralTerminal(terminals: string[], declared?: string | null): string | null;
 /** Base color for an edge by kind and state. Lines are the warm gray of the
  * single-phase branches; transformers are steel; a switch is amber when closed
  * and a faded red when open. */
@@ -73,4 +82,3 @@ export declare function transformerMarks(edges: PlacedMultiEdge[]): TransformerM
 export declare function attachmentColor(kind: DistAttachmentKind): RGBA;
 /** A short glyph for an attachment kind, for the panel legend and badges. */
 export declare function attachmentGlyph(kind: DistAttachmentKind): string;
-//# sourceMappingURL=multiconductor.d.ts.map