@vibesdotdev/pm 0.0.0-stage → 1.0.0-rc.3

package/dist/svelte/components/PMOverview.svelte

@@ -0,0 +1,527 @@
+<script lang="ts">
+	import { onDestroy, onMount } from 'svelte';
+	import type { CaughtFailure } from '@vibesdotdev/kernel';
+	import { getRuntimeSvelteContext } from '@vibesdotdev/surface-sveltekit/svelte';
+	import { Icon } from '@vibesdotdev/kit/components';
+	import { Badge } from '@vibesdotdev/kit/components/ui/badge';
+	import { Button } from '@vibesdotdev/kit/components/ui/button';
+	import * as Card from '@vibesdotdev/kit/components/ui/card';
+	import {
+		assertPMMutationSucceeded,
+		deriveLocalRuntimeHealth,
+		formatProcessUptime,
+		getProcessLabel,
+		normalizePMLogs,
+		processIsActive,
+		processNeedsAttention,
+		startPMOverviewPolling,
+		type PMSurfaceClient,
+		type PMSurfaceProcess,
+		type PMStatusSnapshot
+	} from '../runtime.js';
+	import { attempt } from '../../utils/attempt.js';
+
+	let {
+		client,
+		title = 'Process manager',
+		description = 'Services running on the selected host.',
+		pollIntervalMs = 10_000,
+		autoRepair = true
+	}: {
+		client: PMSurfaceClient;
+		title?: string;
+		description?: string;
+		pollIntervalMs?: number;
+		autoRepair?: boolean;
+	} = $props();
+
+	type ProcessAction = 'start' | 'stop' | 'restart';
+	type ProcessFilter = 'all' | 'active' | 'attention';
+
+	let snapshot = $state<PMStatusSnapshot | null>(null);
+	let loading = $state(true);
+	let refreshing = $state(false);
+	let repairing = $state(false);
+	let error = $state<string | null>(null);
+	let busy = $state<Record<string, ProcessAction | undefined>>({});
+	let filter = $state<ProcessFilter>('all');
+	let confirmStopId = $state<string | null>(null);
+	let logProcess = $state<PMSurfaceProcess | null>(null);
+	let logs = $state('');
+	let logsLoading = $state(false);
+	let logsError = $state<string | null>(null);
+	// The poll is the enclosing runtime's lifecycle interval (SPEC:158, RC07):
+	// disposed on destroy, and with the runtime.
+	const runtimeStore = getRuntimeSvelteContext();
+	let polling: ReturnType<typeof startPMOverviewPolling> | null = null;
+	let initialRepairAttempted = false;
+
+	const health = $derived(deriveLocalRuntimeHealth(snapshot));
+	const processes = $derived(snapshot?.processes ?? []);
+	const activeCount = $derived(processes.filter(processIsActive).length);
+	const attentionCount = $derived(processes.filter(processNeedsAttention).length);
+	const visibleProcesses = $derived(
+		processes.filter((process) => {
+			if (filter === 'active') return processIsActive(process);
+			if (filter === 'attention') return processNeedsAttention(process);
+			return true;
+		})
+	);
+
+	onMount(() => {
+		void refresh({ allowRepair: autoRepair });
+		// Poll: the `PMSurfaceClient` is a request/response surface with no
+		// change event to await. The interval is the caller's declared
+		// `pollIntervalMs` (0 turns it off) on the enclosing runtime's
+		// lifecycle; refresh is serialized (`refreshing`). A page that provides
+		// no runtime gets no poll, and says so.
+		polling = startPMOverviewPolling(runtimeStore, pollIntervalMs, () => void refresh());
+		const armed = polling.started;
+		void attempt(() => armed).then((outcome) => {
+			if (!outcome.ok) {
+				error = errorMessage(outcome.failure, 'Live refresh is unavailable: this page provides no Vibes runtime.');
+			}
+		});
+	});
+
+	onDestroy(() => {
+		polling?.stop();
+		polling = null;
+	});
+
+	function errorMessage(failure: CaughtFailure, fallback: string): string {
+		return failure instanceof Error && failure.message.trim() ? failure.message : fallback;
+	}
+
+	async function refresh(options: { allowRepair?: boolean } = {}): Promise<void> {
+		if (refreshing || repairing) return;
+		refreshing = true;
+		error = null;
+		try {
+			const checked = await attempt(() => client.status());
+			if (!checked.ok) {
+				error = errorMessage(checked.failure, 'Could not check the selected host’s process manager.');
+				snapshot = {
+					running: false,
+					processes: [],
+					error
+				};
+				return;
+			}
+			const next = checked.value;
+			snapshot = next;
+			if (
+				options.allowRepair &&
+				!initialRepairAttempted &&
+				!next.running &&
+				next.shouldRetry !== false
+			) {
+				initialRepairAttempted = true;
+				await repair();
+			}
+		} finally {
+			refreshing = false;
+			loading = false;
+		}
+	}
+
+	async function repair(): Promise<void> {
+		if (repairing) return;
+		repairing = true;
+		error = null;
+		try {
+			const ensured = await attempt(() => client.ensureDaemon());
+			if (!ensured.ok) {
+				error = errorMessage(ensured.failure, 'The process manager could not be started.');
+				return;
+			}
+			snapshot = ensured.value;
+			if (!snapshot.running && snapshot.shouldRetry !== true) {
+				error = snapshot.error || 'The process manager could not be started.';
+			}
+		} finally {
+			repairing = false;
+			loading = false;
+		}
+	}
+
+	async function runProcessAction(process: PMSurfaceProcess, action: ProcessAction): Promise<void> {
+		if (busy[process.id]) return;
+		busy = { ...busy, [process.id]: action };
+		error = null;
+		confirmStopId = null;
+		try {
+			const done = await attempt(async () => {
+				const receipt = await client[action](process.id);
+				assertPMMutationSucceeded(receipt, `Could not ${action} ${getProcessLabel(process)}.`);
+			});
+			if (!done.ok) {
+				error = errorMessage(done.failure, `Could not ${action} ${getProcessLabel(process)}.`);
+				return;
+			}
+			await refresh();
+			if (logProcess?.id === process.id) {
+				await loadLogs(process);
+			}
+		} finally {
+			const nextBusy = { ...busy };
+			delete nextBusy[process.id];
+			busy = nextBusy;
+		}
+	}
+
+	async function loadLogs(process: PMSurfaceProcess): Promise<void> {
+		logProcess = process;
+		logsLoading = true;
+		logsError = null;
+		try {
+			const loaded = await attempt(async () => normalizePMLogs(await client.logs(process.id, 200)));
+			if (loaded.ok) {
+				logs = loaded.value;
+			} else {
+				logs = '';
+				logsError = errorMessage(loaded.failure, `Could not load logs for ${getProcessLabel(process)}.`);
+			}
+		} finally {
+			logsLoading = false;
+		}
+	}
+
+	function closeLogs(): void {
+		logProcess = null;
+		logs = '';
+		logsError = null;
+	}
+
+	function statusTone(
+		process: PMSurfaceProcess
+	): 'default' | 'secondary' | 'destructive' | 'outline' {
+		if (processNeedsAttention(process)) return 'destructive';
+		if (process.status === 'running') return 'default';
+		if (processIsActive(process)) return 'secondary';
+		return 'outline';
+	}
+
+	function statusLabel(process: PMSurfaceProcess): string {
+		if (process.healthStatus === 'unhealthy') return 'Unhealthy';
+		const status = process.status.toLowerCase();
+		return `${status.charAt(0).toUpperCase()}${status.slice(1)}`;
+	}
+</script>
+
+<div class="space-y-6">
+	<header class="flex flex-col gap-4 sm:flex-row sm:items-start sm:justify-between">
+		<div class="max-w-2xl space-y-1.5">
+			<div class="flex items-center gap-2.5">
+				<div
+					class="bg-primary/10 text-primary flex size-9 items-center justify-center rounded-xl"
+					aria-hidden="true"
+				>
+					<Icon icon="tabler:device-desktop-cog" class="size-5" />
+				</div>
+				<div>
+					<h1 class="text-2xl font-semibold tracking-tight">{title}</h1>
+					<p class="text-muted-foreground text-sm leading-6">{description}</p>
+				</div>
+			</div>
+		</div>
+		<div class="flex items-center gap-2">
+			<Badge variant={health.tone}>{health.label}</Badge>
+			<Button
+				variant="outline"
+				size="sm"
+				onclick={() => void refresh()}
+				disabled={refreshing || repairing}
+				aria-label="Refresh process manager"
+			>
+				<Icon
+					icon="tabler:refresh"
+					class={`mr-1.5 size-4 ${refreshing ? 'animate-spin' : ''}`}
+				/>
+				Refresh
+			</Button>
+		</div>
+	</header>
+
+	{#if error}
+		<div
+			role="alert"
+			class="border-destructive/35 bg-destructive/8 text-destructive flex items-start gap-3 rounded-2xl border p-4 text-sm"
+		>
+			<Icon icon="tabler:alert-circle" class="mt-0.5 size-5 shrink-0" />
+			<div class="min-w-0 flex-1">
+				<p class="font-medium">Process manager needs attention</p>
+				<p class="mt-1 leading-6">{error}</p>
+			</div>
+			<Button variant="outline" size="sm" onclick={() => void repair()} disabled={repairing}>
+				{repairing ? 'Starting…' : 'Try again'}
+			</Button>
+		</div>
+	{/if}
+
+	{#if loading && !snapshot}
+		<div class="grid gap-4 md:grid-cols-3" aria-label="Checking process manager">
+			{#each [1, 2, 3] as _}
+				<div class="bg-muted/45 h-28 animate-pulse rounded-2xl border"></div>
+			{/each}
+		</div>
+	{:else if snapshot && !snapshot.running}
+		<Card.Root class="overflow-hidden">
+			<Card.Content class="flex min-h-72 flex-col items-center justify-center p-8 text-center">
+				<div class="bg-muted text-muted-foreground flex size-14 items-center justify-center rounded-2xl">
+					<Icon icon="tabler:plug-connected-x" class="size-7" />
+				</div>
+				<h2 class="mt-5 text-lg font-semibold">Process manager is not running</h2>
+				<p class="text-muted-foreground mt-2 max-w-md text-sm leading-6">
+					Start the supervisor on the selected host to manage its registered services.
+				</p>
+				<Button class="mt-5" onclick={() => void repair()} disabled={repairing}>
+					<Icon
+						icon={repairing ? 'tabler:loader-2' : 'tabler:player-play'}
+						class={`mr-2 size-4 ${repairing ? 'animate-spin' : ''}`}
+					/>
+					{repairing ? 'Starting process manager…' : 'Start process manager'}
+				</Button>
+				{#if snapshot.error}
+					<p class="text-muted-foreground mt-4 max-w-xl text-xs leading-5">
+						{snapshot.error}
+					</p>
+				{/if}
+			</Card.Content>
+		</Card.Root>
+	{:else}
+		<section class="grid gap-4 md:grid-cols-3" aria-label="Process manager summary">
+			<Card.Root>
+				<Card.Content class="p-5">
+					<div class="text-muted-foreground flex items-center gap-2 text-xs font-medium uppercase tracking-wider">
+						<Icon icon="tabler:heart-rate-monitor" class="size-4" />
+						Runtime
+					</div>
+					<p class="mt-3 text-2xl font-semibold">{health.label}</p>
+					<p class="text-muted-foreground mt-1 text-sm">{health.description}</p>
+				</Card.Content>
+			</Card.Root>
+			<Card.Root>
+				<Card.Content class="p-5">
+					<div class="text-muted-foreground flex items-center gap-2 text-xs font-medium uppercase tracking-wider">
+						<Icon icon="tabler:activity" class="size-4" />
+						Active
+					</div>
+					<p class="mt-3 text-2xl font-semibold">{activeCount}</p>
+					<p class="text-muted-foreground mt-1 text-sm">Services working on this host</p>
+				</Card.Content>
+			</Card.Root>
+			<Card.Root>
+				<Card.Content class="p-5">
+					<div class="text-muted-foreground flex items-center gap-2 text-xs font-medium uppercase tracking-wider">
+						<Icon icon="tabler:shield-check" class="size-4" />
+						Attention
+					</div>
+					<p class="mt-3 text-2xl font-semibold">{attentionCount}</p>
+					<p class="text-muted-foreground mt-1 text-sm">
+						{attentionCount === 0 ? 'Everything looks good' : 'Services to review'}
+					</p>
+				</Card.Content>
+			</Card.Root>
+		</section>
+
+		<Card.Root>
+			<Card.Header class="gap-4 sm:flex-row sm:items-end sm:justify-between">
+				<div>
+					<Card.Title>Services on this host</Card.Title>
+					<Card.Description>
+						These services may be shared by several apps and workspaces. Closing this dialog does not stop them.
+					</Card.Description>
+				</div>
+				<div class="bg-muted/60 flex w-fit rounded-xl p-1" aria-label="Filter services">
+					{#each [
+						{ id: 'all', label: `All ${processes.length}` },
+						{ id: 'active', label: `Active ${activeCount}` },
+						{ id: 'attention', label: `Attention ${attentionCount}` }
+					] as option}
+						<Button
+							variant={filter === option.id ? 'secondary' : 'ghost'}
+							size="sm"
+							class="h-8"
+							onclick={() => (filter = option.id as ProcessFilter)}
+						>
+							{option.label}
+						</Button>
+					{/each}
+				</div>
+			</Card.Header>
+			<Card.Content class="space-y-2">
+				{#if visibleProcesses.length === 0}
+					<div class="border-border/70 rounded-2xl border border-dashed p-8 text-center">
+						<Icon icon="tabler:circle-check" class="text-muted-foreground mx-auto size-7" />
+						<p class="mt-3 text-sm font-medium">
+							{filter === 'attention'
+								? 'Nothing needs attention'
+								: filter === 'active'
+									? 'No services are active'
+									: 'No services are registered yet'}
+						</p>
+						<p class="text-muted-foreground mt-1 text-xs">
+							{filter === 'all'
+								? 'Services appear here when a Vibes feature registers them.'
+								: 'Choose All to see every registered service.'}
+						</p>
+					</div>
+				{:else}
+					{#each visibleProcesses as process (process.id)}
+						<div class="bg-background/60 rounded-2xl border p-4">
+							<div class="flex flex-col gap-4 lg:flex-row lg:items-center lg:justify-between">
+								<div class="flex min-w-0 items-start gap-3">
+									<div
+										class={`mt-0.5 flex size-9 shrink-0 items-center justify-center rounded-xl ${
+											processNeedsAttention(process)
+												? 'bg-destructive/10 text-destructive'
+												: processIsActive(process)
+													? 'bg-primary/10 text-primary'
+													: 'bg-muted text-muted-foreground'
+										}`}
+									>
+										<Icon
+											icon={processIsActive(process) ? 'tabler:activity' : 'tabler:server-2'}
+											class="size-5"
+										/>
+									</div>
+									<div class="min-w-0">
+										<div class="flex flex-wrap items-center gap-2">
+											<h3 class="truncate font-medium">{getProcessLabel(process)}</h3>
+											<Badge variant={statusTone(process)}>{statusLabel(process)}</Badge>
+										</div>
+										<p class="text-muted-foreground mt-1 text-sm leading-5">
+											{process.description || process.id}
+										</p>
+										<div class="text-muted-foreground mt-2 flex flex-wrap gap-x-4 gap-y-1 text-xs">
+											{#if process.pid}<span>Process {process.pid}</span>{/if}
+											{#if formatProcessUptime(process.startedAt)}
+												<span>Up {formatProcessUptime(process.startedAt)}</span>
+											{/if}
+											{#if (process.restartCount ?? 0) > 0}
+												<span>Restarted {process.restartCount}×</span>
+											{/if}
+											{#if process.healthStatus && process.healthStatus !== 'unknown'}
+												<span>Health {process.healthStatus}</span>
+											{/if}
+										</div>
+										{#if process.lastError}
+											<p class="text-destructive mt-2 line-clamp-2 text-xs leading-5">
+												{process.lastError}
+											</p>
+										{/if}
+									</div>
+								</div>
+
+								<div class="flex shrink-0 flex-wrap items-center gap-1.5 lg:justify-end">
+									<Button
+										variant="ghost"
+										size="sm"
+										onclick={() => void loadLogs(process)}
+										disabled={Boolean(busy[process.id])}
+									>
+										<Icon icon="tabler:terminal-2" class="mr-1.5 size-4" />
+										Logs
+									</Button>
+									{#if processIsActive(process)}
+										<Button
+											variant="outline"
+											size="sm"
+											onclick={() => void runProcessAction(process, 'restart')}
+											disabled={Boolean(busy[process.id])}
+										>
+											<Icon
+												icon={busy[process.id] === 'restart' ? 'tabler:loader-2' : 'tabler:refresh'}
+												class={`mr-1.5 size-4 ${busy[process.id] === 'restart' ? 'animate-spin' : ''}`}
+											/>
+											Restart
+										</Button>
+										{#if confirmStopId === process.id}
+											<span class="text-muted-foreground px-1 text-xs">Stop?</span>
+											<Button variant="ghost" size="sm" onclick={() => (confirmStopId = null)}>
+												Cancel
+											</Button>
+											<Button
+												variant="destructive"
+												size="sm"
+												onclick={() => void runProcessAction(process, 'stop')}
+												disabled={Boolean(busy[process.id])}
+											>
+												Stop
+											</Button>
+										{:else}
+											<Button
+												variant="ghost"
+												size="sm"
+												onclick={() => (confirmStopId = process.id)}
+												disabled={Boolean(busy[process.id])}
+											>
+												Stop
+											</Button>
+										{/if}
+									{:else}
+										<Button
+											size="sm"
+											onclick={() => void runProcessAction(process, 'start')}
+											disabled={Boolean(busy[process.id])}
+										>
+											<Icon
+												icon={busy[process.id] === 'start' ? 'tabler:loader-2' : 'tabler:player-play'}
+												class={`mr-1.5 size-4 ${busy[process.id] === 'start' ? 'animate-spin' : ''}`}
+											/>
+											Start
+										</Button>
+									{/if}
+								</div>
+							</div>
+						</div>
+					{/each}
+				{/if}
+			</Card.Content>
+		</Card.Root>
+	{/if}
+
+	{#if logProcess}
+		<Card.Root class="overflow-hidden">
+			<Card.Header class="flex-row items-center justify-between space-y-0">
+				<div class="min-w-0">
+					<Card.Title class="truncate text-base">{getProcessLabel(logProcess)} logs</Card.Title>
+					<Card.Description>Latest 200 lines from this host’s process manager.</Card.Description>
+				</div>
+				<div class="flex gap-1">
+					<Button
+						variant="ghost"
+						size="sm"
+						onclick={() => void loadLogs(logProcess!)}
+						disabled={logsLoading}
+					>
+						<Icon
+							icon="tabler:refresh"
+							class={`mr-1.5 size-4 ${logsLoading ? 'animate-spin' : ''}`}
+						/>
+						Refresh
+					</Button>
+					<Button variant="ghost" size="icon" onclick={closeLogs} aria-label="Close logs">
+						<Icon icon="tabler:x" class="size-4" />
+					</Button>
+				</div>
+			</Card.Header>
+			<Card.Content>
+				{#if logsError}
+					<div role="alert" class="text-destructive rounded-xl border p-4 text-sm">{logsError}</div>
+				{:else if logsLoading && !logs}
+					<div class="bg-muted/45 h-40 animate-pulse rounded-xl"></div>
+				{:else if logs}
+					<pre
+						class="bg-muted/55 max-h-96 overflow-auto rounded-xl border p-4 font-mono text-xs leading-5 whitespace-pre-wrap"
+					>{logs}</pre>
+				{:else}
+					<div class="text-muted-foreground rounded-xl border border-dashed p-8 text-center text-sm">
+						No recent logs.
+					</div>
+				{/if}
+			</Card.Content>
+		</Card.Root>
+	{/if}
+</div>

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

@@ -0,0 +1,12 @@
+import { type PMSurfaceClient } from '../runtime.ts';
+type $$ComponentProps = {
+    client: PMSurfaceClient;
+    title?: string;
+    description?: string;
+    pollIntervalMs?: number;
+    autoRepair?: boolean;
+};
+declare const PMOverview: import("svelte").Component<$$ComponentProps, {}, "">;
+type PMOverview = ReturnType<typeof PMOverview>;
+export default PMOverview;
+//# sourceMappingURL=PMOverview.svelte.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PMOverview.svelte.d.ts","sourceRoot":"","sources":["../../../src/svelte/components/PMOverview.svelte.ts"],"names":[],"mappings":"AAUA,OAAO,EASL,KAAK,eAAe,EAGpB,MAAM,eAAe,CAAC;AAMvB,KAAK,gBAAgB,GAAI;IACxB,MAAM,EAAE,eAAe,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,OAAO,CAAC;CACrB,CAAC;AA4bH,QAAA,MAAM,UAAU,sDAAwC,CAAC;AACzD,KAAK,UAAU,GAAG,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;AAChD,eAAe,UAAU,CAAC"}

package/dist/svelte/index.d.ts

@@ -0,0 +1,4 @@
+export { default as PMOverview } from './components/PMOverview.svelte';
+export { assertPMMutationSucceeded, deriveLocalRuntimeHealth, formatProcessUptime, getProcessLabel, normalizePMLogs, processIsActive, processNeedsAttention } from './runtime.ts';
+export type { LocalRuntimeHealth, PMLogsResult, PMMutationReceipt, PMProcessStatus, PMStatusSnapshot, PMSurfaceClient, PMSurfaceProcess } from './runtime.ts';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/svelte/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,EACN,yBAAyB,EACzB,wBAAwB,EACxB,mBAAmB,EACnB,eAAe,EACf,eAAe,EACf,eAAe,EACf,qBAAqB,EACrB,MAAM,cAAc,CAAC;AACtB,YAAY,EACX,kBAAkB,EAClB,YAAY,EACZ,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,MAAM,cAAc,CAAC"}

package/dist/svelte/index.js

@@ -0,0 +1,2 @@
+export { default as PMOverview } from './components/PMOverview.svelte';
+export { assertPMMutationSucceeded, deriveLocalRuntimeHealth, formatProcessUptime, getProcessLabel, normalizePMLogs, processIsActive, processNeedsAttention } from "./runtime.js";

package/dist/svelte/runtime.d.ts

@@ -0,0 +1,33 @@
+import { type RuntimeRef } from '@vibesdotdev/kernel';
+import type { PMLogsResult, PMMutationReceipt, PMStatusSnapshot, PMSurfaceProcess } from '@vibesdotdev/pm/surface';
+export type { PMLogsResult, PMMutationReceipt, PMProcessStatus, PMStatusSnapshot, PMSurfaceClient, PMSurfaceProcess } from '@vibesdotdev/pm/surface';
+export type LocalRuntimeHealth = {
+    label: 'Starting' | 'Needs attention' | 'Ready' | 'Offline';
+    description: string;
+    tone: 'default' | 'secondary' | 'destructive' | 'outline';
+};
+export declare function processNeedsAttention(process: PMSurfaceProcess): boolean;
+export declare function processIsActive(process: PMSurfaceProcess): boolean;
+export declare function getProcessLabel(process: Pick<PMSurfaceProcess, 'id' | 'name'>): string;
+export declare function formatProcessUptime(startedAt: PMSurfaceProcess['startedAt'], now?: number): string | null;
+export declare function deriveLocalRuntimeHealth(snapshot: PMStatusSnapshot | null): LocalRuntimeHealth;
+export declare function assertPMMutationSucceeded(receipt: void | PMMutationReceipt, fallbackMessage: string): void;
+export declare function normalizePMLogs(result: PMLogsResult): string;
+/** What the overview's poll needs from the enclosing runtime store: a way to resolve its runtime. */
+export interface PMPollRuntimeSource {
+    load(): Promise<Pick<RuntimeRef, 'lifecycle'>>;
+}
+/** A running overview poll: stop it on destroy; `started` settles once the poll is armed (or rejects). */
+export interface PMOverviewPolling {
+    stop: () => void;
+    started: Promise<void>;
+}
+/**
+ * Start the overview's poll on the enclosing runtime's lifecycle (SPEC:158,
+ * RC07): `refresh` every `intervalMs` through `runtime.lifecycle.interval`,
+ * so the runtime's disposal ends it too. Answers the disposer (call it on
+ * destroy; a call before the runtime resolved cancels the start), or rejects
+ * when the store resolves no runtime. `intervalMs <= 0` polls nothing.
+ */
+export declare function startPMOverviewPolling(source: PMPollRuntimeSource, intervalMs: number, refresh: () => void): PMOverviewPolling;
+//# sourceMappingURL=runtime.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/svelte/runtime.ts"],"names":[],"mappings":"AACA,OAAO,EAAmB,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACvE,OAAO,KAAK,EACX,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,MAAM,yBAAyB,CAAC;AAEjC,YAAY,EACX,YAAY,EACZ,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,MAAM,yBAAyB,CAAC;AAEjC,MAAM,MAAM,kBAAkB,GAAG;IAChC,KAAK,EAAE,UAAU,GAAG,iBAAiB,GAAG,OAAO,GAAG,SAAS,CAAC;IAC5D,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,SAAS,GAAG,WAAW,GAAG,aAAa,GAAG,SAAS,CAAC;CAC1D,CAAC;AAIF,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAMxE;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAElE;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,IAAI,CAAC,gBAAgB,EAAE,IAAI,GAAG,MAAM,CAAC,GAAG,MAAM,CAUtF;AAED,wBAAgB,mBAAmB,CAClC,SAAS,EAAE,gBAAgB,CAAC,WAAW,CAAC,EACxC,GAAG,SAAa,GACd,MAAM,GAAG,IAAI,CAgBf;AAED,wBAAgB,wBAAwB,CACvC,QAAQ,EAAE,gBAAgB,GAAG,IAAI,GAC/B,kBAAkB,CAyCpB;AAED,wBAAgB,yBAAyB,CACxC,OAAO,EAAE,IAAI,GAAG,iBAAiB,EACjC,eAAe,EAAE,MAAM,GACrB,IAAI,CAON;AAcD,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAgB5D;AAED,qGAAqG;AACrG,MAAM,WAAW,mBAAmB;IACnC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC,CAAC;CAC/C;AAED,0GAA0G;AAC1G,MAAM,WAAW,iBAAiB;IACjC,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACrC,MAAM,EAAE,mBAAmB,EAC3B,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,IAAI,GACjB,iBAAiB,CAiBnB"}