@tellegen/svelte 0.1.2 → 0.2.0

package/README.md

@@ -28,6 +28,10 @@ Use local files only by disabling bundled case loading:
 <TellegenViewer loadDefaultCases={false} showFooter={false} />
 ```
 
+The viewer accepts at most 32 files in one ingestion batch. Each file must be
+at most 128 MiB, and the aggregate batch must also be at most 128 MiB. Files
+remain in the browser on this path.
+
 `TellegenViewer` accepts:
 
 - `apiBase`, default `/api`
@@ -50,6 +54,17 @@ Use `TellegenProvider` and `TellegenShell` when state should survive route chang
 </TellegenProvider>
 ```
 
+## Engine Reexports
+
+The package reexports the browser engine helpers, including `ingestCase`,
+`classifyJson`, and `ingestJsonDrop`, for custom drop surfaces. In 0.2 these
+APIs use byte input: pass `Uint8Array` to `ingestCase`, await
+`classifyJson(bytes)` and read its `{ kind, format }` result, and use
+`ingestJsonDrop(bytes)` to classify and parse in one call. `isStudyPackageText`
+was removed; test for `kind === "balanced-package"` instead. `JsonDropKind` now
+includes `transmission`, `distribution`, `ambiguous`, and `unknown`; BMOPF and
+PMD are distribution `format` values rather than separate kinds.
+
 ## Release
 
 Build and inspect the package from the repository root:

package/dist/Sparkline.svelte.d.ts

@@ -5,4 +5,3 @@ type $$ComponentProps = {
 declare const Sparkline: import("svelte").Component<$$ComponentProps, {}, "">;
 type Sparkline = ReturnType<typeof Sparkline>;
 export default Sparkline;
-//# sourceMappingURL=Sparkline.svelte.d.ts.map

package/dist/TellegenMap.svelte

@@ -32,6 +32,7 @@
 		type TransformerMark
 	} from './multiconductor.js';
 	import { transformerIcon } from './transformer-icon.js';
+	import { foldMapBounds } from './map-bounds.js';
 	import { getAppState, getController } from './context.svelte.js';
 	import { displayFmt, fmt, rgbaCss } from './format.js';
 	import type { RGBA } from './colors.js';
@@ -505,43 +506,8 @@
 			: { top: 96, left: 380, right: 60, bottom: 64 };
 	}
 
-	/** Fold lon/lat pairs into LngLat bounds; null when no point is finite. */
-	function foldBounds(
-		points: Iterable<[number, number]>
-	): [[number, number], [number, number]] | null {
-		let minLon = Infinity;
-		let minLat = Infinity;
-		let maxLon = -Infinity;
-		let maxLat = -Infinity;
-		for (const [lon, lat] of points) {
-			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;
-		return [
-			[minLon, minLat],
-			[maxLon, maxLat]
-		];
-	}
-
 	function branchBounds(path: [number, number][]): LngLatBoundsLike | null {
-		const bounds = foldBounds(path);
-		if (!bounds) return null;
-		let [[minLon, minLat], [maxLon, maxLat]] = bounds;
-		if (minLon === maxLon) {
-			minLon -= 0.005;
-			maxLon += 0.005;
-		}
-		if (minLat === maxLat) {
-			minLat -= 0.005;
-			maxLat += 0.005;
-		}
-		return [
-			[minLon, minLat],
-			[maxLon, maxLat]
-		];
+		return foldMapBounds(path);
 	}
 
 	function prefersReducedMotion(): boolean {
@@ -1180,7 +1146,7 @@
 			if (target !== 'all' && c.id !== target) continue;
 			if (c.view) fold(c.view.buses);
 		}
-		return foldBounds(points);
+		return foldMapBounds(points);
 	}
 
 	// Fly to whatever the header, the initial load, or a branch selection asked

package/dist/TellegenMap.svelte.d.ts

@@ -12,4 +12,3 @@ type $$ComponentProps = {
 declare const TellegenMap: import("svelte").Component<$$ComponentProps, {}, "">;
 type TellegenMap = ReturnType<typeof TellegenMap>;
 export default TellegenMap;
-//# sourceMappingURL=TellegenMap.svelte.d.ts.map

package/dist/TellegenProvider.svelte.d.ts

@@ -6,4 +6,3 @@ interface Props extends TellegenUiOptions {
 declare const TellegenProvider: import("svelte").Component<Props, {}, "">;
 type TellegenProvider = ReturnType<typeof TellegenProvider>;
 export default TellegenProvider;
-//# sourceMappingURL=TellegenProvider.svelte.d.ts.map

package/dist/TellegenShell.svelte.d.ts

@@ -1,4 +1,3 @@
 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/TellegenViewer.svelte.d.ts

@@ -1,4 +1,3 @@
 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/api.d.ts

@@ -41,4 +41,3 @@ export interface SolveStreamHandlers {
     ondone?: () => void;
 }
 export declare function createApiClient(options?: TellegenApiClientOptions): TellegenApiClient;
-//# sourceMappingURL=api.d.ts.map

package/dist/colors.d.ts

@@ -48,4 +48,3 @@ 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/components/AppFooter.svelte.d.ts

@@ -4,4 +4,3 @@ type $$ComponentProps = {
 declare const AppFooter: import("svelte").Component<$$ComponentProps, {}, "">;
 type AppFooter = ReturnType<typeof AppFooter>;
 export default AppFooter;
-//# sourceMappingURL=AppFooter.svelte.d.ts.map

package/dist/components/AppHeader.svelte

@@ -97,13 +97,15 @@
 	</span>
 	<input
 		type="file"
-		accept=".m,.raw,.aux,.dss,.pwd,.csv,.json,.geojson"
+		accept=".m,.raw,.aux,.epc,.pwb,.dss,.pwd,.csv,.json,.geojson"
 		multiple
 		hidden
 		bind:this={fileInput}
 		onchange={(e) => {
 			const input = e.currentTarget;
-			if (input.files) ctrl.ingestFiles(Array.from(input.files));
+			// Pass the FileList through unchanged: the controller checks its declared
+			// count before materializing any entries.
+			if (input.files) ctrl.ingestFiles(input.files);
 			input.value = '';
 		}}
 	/>

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

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

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

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

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

@@ -4,4 +4,3 @@ type $$ComponentProps = {
 declare const BusPicker: import("svelte").Component<$$ComponentProps, {}, "">;
 type BusPicker = ReturnType<typeof BusPicker>;
 export default BusPicker;
-//# sourceMappingURL=BusPicker.svelte.d.ts.map

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

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

package/dist/components/DemandSlider.svelte

@@ -4,6 +4,7 @@
 
 	const app = getAppState();
 	const ctrl = getController();
+	const disabled = $derived(ctrl.sliderDisabled);
 
 	// Fill from the committed demand to the live thumb. The local number line stays
 	// stable after release; only the committed tick moves.
@@ -23,6 +24,7 @@
 	const fillHi = $derived(valFrac < neutralFrac ? neutralPos : valPos);
 	const sliderTip =
 		'The black tick marks the last committed demand. Drag the knob to preview a new demand; release to solve and move the tick to that point.';
+	const disabledTip = 'this analysis bus is display-only; demand is not adjustable';
 	const scoreTip =
 		'Gradient is the estimate of total cost change versus base before the solve finishes. It uses the selected bus LMP times the demand step, plus local curvature when the preview engine is unavailable. Exact is the resolved OPF objective change.';
 </script>
@@ -39,32 +41,41 @@
 				<button
 					type="button"
 					class:active={app.demandRangeMode === 'local'}
-					aria-pressed={app.demandRangeMode === 'local'}
-					aria-label="nearby demand range"
+						aria-pressed={app.demandRangeMode === 'local'}
+						aria-label="nearby demand range"
+						disabled={disabled}
 					title="range near the selected demand setting"
 					onclick={() => ctrl.setDemandRangeMode('local')}>nearby</button
 				>
 				<button
 					type="button"
 					class:active={app.demandRangeMode === 'full'}
-					aria-pressed={app.demandRangeMode === 'full'}
-					aria-label="full demand range"
+						aria-pressed={app.demandRangeMode === 'full'}
+						aria-label="full demand range"
+						disabled={disabled}
 					title="range from zero load to the local physical limit"
 					onclick={() => ctrl.setDemandRangeMode('full')}>full range</button
 				>
 			</div>
-			<span class="mono dim">{fmt.format(ctrl.sliderMin)} to {fmt.format(ctrl.sliderMax)} MW</span>
+				<span class="mono dim">
+					{#if disabled}
+						not adjustable
+					{:else}
+						{fmt.format(ctrl.sliderMin)} to {fmt.format(ctrl.sliderMax)} MW
+					{/if}
+				</span>
 		</div>
 		<div
 			class="slider-track"
 			style="--fill-lo:{fillLo}; --fill-hi:{fillHi}; --neutral-pos:{neutralPos}"
-			title={sliderTip}
+				title={disabled ? disabledTip : sliderTip}
 		>
 			<input
 				type="range"
 				min={ctrl.sliderMin}
-				max={ctrl.sliderMax}
-				step="any"
+					max={ctrl.sliderMax}
+					step="any"
+					disabled={disabled}
 				bind:value={ctrl.sliderCurrent, ctrl.setSliderPreview}
 				aria-label="demand delta at selected bus"
 				onpointerdown={() => ctrl.setSliderPreview(ctrl.sliderValue)}
@@ -173,6 +184,15 @@
 		margin: 0;
 	}
 
+	input[type='range']:disabled {
+		opacity: 0.45;
+	}
+
+	.range-mode button:disabled {
+		cursor: default;
+		opacity: 0.45;
+	}
+
 	input[type='range']::-webkit-slider-thumb {
 		-webkit-appearance: none;
 		appearance: none;

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

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

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

@@ -16,4 +16,3 @@ declare const DisplayControls: $$__sveltets_2_IsomorphicComponent<Record<string,
 }, {}, {}, string>;
 type DisplayControls = InstanceType<typeof DisplayControls>;
 export default DisplayControls;
-//# sourceMappingURL=DisplayControls.svelte.d.ts.map

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

@@ -16,4 +16,3 @@ declare const DropZone: $$__sveltets_2_IsomorphicComponent<Record<string, never>
 }, {}, {}, string>;
 type DropZone = InstanceType<typeof DropZone>;
 export default DropZone;
-//# sourceMappingURL=DropZone.svelte.d.ts.map

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

@@ -16,4 +16,3 @@ declare const FormulationSelector: $$__sveltets_2_IsomorphicComponent<Record<str
 }, {}, {}, string>;
 type FormulationSelector = InstanceType<typeof FormulationSelector>;
 export default FormulationSelector;
-//# sourceMappingURL=FormulationSelector.svelte.d.ts.map

package/dist/components/LocalCaseDetails.svelte

@@ -6,13 +6,16 @@
 	const app = getAppState();
 	const ctrl = getController();
 
-	// Powerio writer tokens the committed state exports to; label carries the extension.
+	// Export tokens the committed state writes to; labels carry their extensions.
+	// `model-json` is powerio's own model document, not a case format.
 	const EXPORT_FORMATS = [
 		{ token: 'matpower', label: 'MATPOWER (.m)' },
 		{ token: 'psse', label: 'PSS/E (.raw)' },
+		{ token: 'powerworld', label: 'PowerWorld (.aux)' },
+		{ token: 'pslf', label: 'PSLF (.epc)' },
 		{ token: 'powermodels-json', label: 'PowerModels (.json)' },
 		{ token: 'pandapower-json', label: 'pandapower (.json)' },
-		{ token: 'powerio-json', label: 'PowerIO (.json)' }
+		{ token: 'model-json', label: 'PowerIO model (.json)' }
 	];
 
 	let busy = $state(false);

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

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

package/dist/components/MulticonductorDetails.svelte

@@ -54,10 +54,10 @@
 				<dt>sources / loads / gens</dt>
 				<dd>{s.n_source} / {s.n_load} / {s.n_generator}</dd>
 			</div>
-			{#if s.n_ibr > 0 || s.n_shunt > 0}
+			{#if s.n_ibr > 0 || s.n_shunt > 0 || (s.n_capacitor ?? 0) > 0}
 				<div>
-					<dt>IBRs / shunts</dt>
-					<dd>{s.n_ibr} / {s.n_shunt}</dd>
+					<dt>IBRs / shunts / caps</dt>
+					<dd>{s.n_ibr} / {s.n_shunt} / {s.n_capacitor ?? 0}</dd>
 				</div>
 			{/if}
 		</dl>

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

@@ -16,4 +16,3 @@ declare const MulticonductorDetails: $$__sveltets_2_IsomorphicComponent<Record<s
 }, {}, {}, string>;
 type MulticonductorDetails = InstanceType<typeof MulticonductorDetails>;
 export default MulticonductorDetails;
-//# sourceMappingURL=MulticonductorDetails.svelte.d.ts.map

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

@@ -16,4 +16,3 @@ declare const NetworkStats: $$__sveltets_2_IsomorphicComponent<Record<string, ne
 }, {}, {}, string>;
 type NetworkStats = InstanceType<typeof NetworkStats>;
 export default NetworkStats;
-//# sourceMappingURL=NetworkStats.svelte.d.ts.map

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

@@ -16,4 +16,3 @@ declare const PlacementCue: $$__sveltets_2_IsomorphicComponent<Record<string, ne
 }, {}, {}, string>;
 type PlacementCue = InstanceType<typeof PlacementCue>;
 export default PlacementCue;
-//# sourceMappingURL=PlacementCue.svelte.d.ts.map

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

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

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

@@ -16,4 +16,3 @@ declare const RestoreDefaultsButton: $$__sveltets_2_IsomorphicComponent<Record<s
 }, {}, {}, string>;
 type RestoreDefaultsButton = InstanceType<typeof RestoreDefaultsButton>;
 export default RestoreDefaultsButton;
-//# sourceMappingURL=RestoreDefaultsButton.svelte.d.ts.map

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

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

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

@@ -16,4 +16,3 @@ declare const SizeLegend: $$__sveltets_2_IsomorphicComponent<Record<string, neve
 }, {}, {}, string>;
 type SizeLegend = InstanceType<typeof SizeLegend>;
 export default SizeLegend;
-//# sourceMappingURL=SizeLegend.svelte.d.ts.map

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

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

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

@@ -16,4 +16,3 @@ declare const TopMovers: $$__sveltets_2_IsomorphicComponent<Record<string, never
 }, {}, {}, string>;
 type TopMovers = InstanceType<typeof TopMovers>;
 export default TopMovers;
-//# sourceMappingURL=TopMovers.svelte.d.ts.map

package/dist/components.d.ts

@@ -16,4 +16,3 @@ 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/context.svelte.d.ts

@@ -17,4 +17,3 @@ 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/controller.svelte.d.ts

@@ -10,6 +10,11 @@ type GeoLayerFile = {
     layer: string;
     warnings: string[];
 };
+/** A lowered analysis row is view-only only when a current producer says so;
+ * absence keeps payloads from older compatible engine/server versions editable. */
+export declare function isDisplayOnlyElement(element: {
+    editable?: boolean;
+} | null | undefined): boolean;
 export type { SolvableCase };
 type DemandRangeAnchor = {
     caseId: string;
@@ -41,6 +46,7 @@ export declare class Controller {
     }>;
     localSeq: number;
     loading: Promise<void> | null;
+    private readonly dropBatchGate;
     nearbyRangeAnchor: DemandRangeAnchor | null;
     hiddenDefaults: Set<string>;
     casesLoaded: boolean;
@@ -144,6 +150,7 @@ export declare class Controller {
     };
     sliderMin: number;
     sliderMax: number;
+    sliderDisabled: boolean;
     committedRating: number;
     ratingSliderValue: number;
     ratingBounds: {
@@ -262,23 +269,26 @@ export declare class Controller {
     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
+     * files (.m, .raw, .aux, .epc, .pwb) 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>;
+    private ingestFileBatch;
+    /** Apply co-dropped geographic data before a local case becomes active and
+     * starts solving. Without geographic data, let a coordinate-less case borrow
+     * the first matching PowerWorld display. A failed geographic join keeps the
+     * parsed case and returns the user-facing placement error. */
+    private prepareDroppedLocal;
     /** 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;
+    /** Route a dropped `.json` by its content. Recognized payloads return without
+     * mutating case state so co-dropped sidecars can be applied first; unrouted
+     * content returns the bytes already read for the geographic fallback. */
+    private routeJsonDrop;
     /** 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;
@@ -303,9 +313,12 @@ export declare class Controller {
     /** 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 a local case from a bare balanced ingest payload without activating
+     * it yet; co-dropped placement data is applied before the first solve. */
+    private localFromBalancedPayload;
+    /** Build a local case from a saved package, including its edit state and
+     * formulation, without activating it until sidecars have been applied. */
+    private localFromPackage;
     /** 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. */
@@ -334,4 +347,3 @@ export declare class Controller {
     ratingSliderCurrent: () => number;
 }
 export declare function createController(app: AppState, options?: ControllerOptions): Controller;
-//# sourceMappingURL=controller.svelte.d.ts.map