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

package/dist/svelte/documents/presentations/components/PresentationMonitor.svelte

@@ -0,0 +1,261 @@
+<script lang="ts">
+	import { onMount } from 'svelte';
+	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 { Textarea } from '@vibesdotdev/kit/components/ui/textarea';
+	import { Icon } from '@vibesdotdev/kit/components';
+	import type {
+		PresentationRequest,
+		PresentationReviewAudience
+	} from '@vibesdotdev/docs/documents/presentations/schemas';
+
+	let {
+		surfaceState,
+		requests,
+		activeRequest = null,
+		busy = false,
+		error = null,
+		onRefresh,
+		onRespond,
+		onSubmitComment,
+		onFinish
+	}: {
+		surfaceState: 'connecting' | 'available' | 'stale' | 'offline';
+		requests: PresentationRequest[];
+		activeRequest?: PresentationRequest | null;
+		busy?: boolean;
+		error?: string | null;
+		onRefresh?: () => void;
+		onRespond?: (request: PresentationRequest, decision: 'accept' | 'decline') => void;
+		onSubmitComment?: (
+			request: PresentationRequest,
+			text: string,
+			audience: PresentationReviewAudience
+		) => void;
+		onFinish?: (request: PresentationRequest) => void;
+	} = $props();
+
+	let comment = $state('');
+	let audience = $state<PresentationReviewAudience>('request-participants');
+	let clock = $state(Date.now());
+
+	function getStateTone(state: typeof surfaceState): 'default' | 'secondary' | 'outline' | 'destructive' {
+		switch (state) {
+			case 'connecting':
+				return 'secondary';
+			case 'available':
+				return 'default';
+			case 'stale':
+				return 'outline';
+			case 'offline':
+				return 'destructive';
+		}
+	}
+
+	function targetHref(request: PresentationRequest): string | null {
+		if (request.target.view === 'session') {
+			return `/cockpit/${encodeURIComponent(request.sessionId)}`;
+		}
+		if (request.target.view === 'artifact' || request.target.view === 'image-review') {
+			return `/artifacts/${encodeURIComponent(request.target.link.id)}`;
+		}
+		return null;
+	}
+
+	function submitComment(event: SubmitEvent) {
+		event.preventDefault();
+		const text = comment.trim();
+		if (!text || !activeRequest || busy) return;
+		onSubmitComment?.(activeRequest, text, audience);
+		comment = '';
+	}
+
+	function requesterLabel(request: PresentationRequest): string {
+		return request.requester.displayName ?? request.requester.id;
+	}
+
+	function remainingConsent(expiresAt: string): string {
+		const seconds = Math.max(0, Math.ceil((Date.parse(expiresAt) - clock) / 1000));
+		const minutes = Math.floor(seconds / 60);
+		const remainder = seconds % 60;
+		return minutes > 0 ? `${minutes}m ${remainder.toString().padStart(2, '0')}s` : `${seconds}s`;
+	}
+
+	onMount(() => {
+		const timer = setInterval(() => {
+			clock = Date.now();
+		}, 1000);
+		return () => clearInterval(timer);
+	});
+</script>
+
+<section class="mx-auto flex max-w-5xl flex-col gap-5 p-4" aria-label="Presentation monitor">
+	<header class="flex flex-wrap items-center justify-between gap-3 border-b border-border pb-4">
+		<div>
+			<div class="flex items-center gap-2">
+				<h1 class="text-2xl font-semibold text-foreground">Monitor</h1>
+				<Badge variant={getStateTone(surfaceState)}>
+					{surfaceState}
+				</Badge>
+			</div>
+			<p class="mt-1 text-sm text-muted-foreground">
+				This tab is an available presentation surface. Agents may ask; you decide.
+			</p>
+		</div>
+		<Button variant="outline" size="sm" disabled={busy} onclick={() => onRefresh?.()}>
+			<Icon icon="lucide:refresh-cw" class="mr-2 h-4 w-4" />
+			Refresh
+		</Button>
+	</header>
+
+	{#if error}
+		<div class="rounded-md border border-destructive/40 bg-destructive/5 p-3 text-sm text-destructive">
+			{error}
+		</div>
+	{/if}
+
+	{#if activeRequest}
+		<Card.Root class="border-primary/40">
+			<Card.Header>
+				<div class="flex flex-wrap items-center justify-between gap-2">
+					<div>
+						<Card.Title>{activeRequest.target.title ?? 'Live presentation'}</Card.Title>
+						<Card.Description>
+							{requesterLabel(activeRequest)} · session {activeRequest.sessionId.slice(0, 8)}
+						</Card.Description>
+					</div>
+					<Badge>{activeRequest.status}</Badge>
+				</div>
+			</Card.Header>
+			<Card.Content class="space-y-4">
+				<p class="whitespace-pre-wrap text-sm text-foreground">{activeRequest.message}</p>
+				<p
+					class="rounded-md border border-amber-500/30 bg-amber-500/5 p-3 text-xs text-muted-foreground"
+				>
+					Consent expires in {remainingConsent(activeRequest.expiresAt)}. When it ends, this
+					presentation closes; continuing requires a fresh request you approve.
+				</p>
+				{@const href = targetHref(activeRequest)}
+				{#if href}
+					<div class="space-y-2">
+						<div class="flex items-center justify-between gap-2">
+							<p class="text-xs text-muted-foreground">
+								Live target rendered by its owning HQ route
+							</p>
+							<Button href={href} variant="outline" size="sm">
+								<Icon icon="lucide:external-link" class="mr-2 h-4 w-4" />
+								Open separately
+							</Button>
+						</div>
+						<iframe
+							title={activeRequest.target.title ?? activeRequest.target.view}
+							src={href}
+							class="h-[34rem] w-full rounded-md border border-border bg-background"
+						></iframe>
+					</div>
+				{:else}
+					<p class="rounded-md bg-muted p-3 text-sm text-muted-foreground">
+						The {activeRequest.target.view} renderer is not mounted in this host yet. Your
+						feedback still binds to revision
+						<code>{activeRequest.target.revision ?? 'session-live'}</code>.
+					</p>
+				{/if}
+
+				<form class="space-y-2" onsubmit={submitComment}>
+					<label for="presentation-comment" class="text-sm font-medium text-foreground">
+						Comment or steer
+					</label>
+					<Textarea
+						id="presentation-comment"
+						bind:value={comment}
+						disabled={busy}
+						rows={4}
+						placeholder="What should the agent change, inspect, or explain?"
+					/>
+					<div class="flex flex-wrap items-center justify-between gap-2">
+						<label class="flex items-center gap-2 text-xs text-muted-foreground">
+							<input
+								type="checkbox"
+								checked={audience === 'owner-only'}
+								onchange={(event) =>
+									(audience = event.currentTarget.checked
+										? 'owner-only'
+										: 'request-participants')}
+							/>
+							Owner-only feedback
+						</label>
+						<div class="flex gap-2">
+							<Button type="submit" disabled={busy || !comment.trim()}>
+								Send feedback
+							</Button>
+							<Button
+								type="button"
+								variant="outline"
+								disabled={busy}
+								onclick={() => onFinish?.(activeRequest)}
+							>
+								Complete
+							</Button>
+						</div>
+					</div>
+				</form>
+			</Card.Content>
+		</Card.Root>
+	{/if}
+
+	<div class="space-y-3">
+		<div>
+			<h2 class="text-lg font-semibold text-foreground">Incoming requests</h2>
+			<p class="text-sm text-muted-foreground">
+				Accepting gives temporary attention custody to the target—not control of this device.
+			</p>
+		</div>
+		{#if requests.length === 0}
+			<div class="rounded-md border border-dashed border-border p-8 text-center">
+				<Icon icon="lucide:presentation" class="mx-auto mb-3 h-8 w-8 text-muted-foreground" />
+				<p class="font-medium text-foreground">No one is asking for the screen.</p>
+				<p class="text-sm text-muted-foreground">A pleasantly boring state.</p>
+			</div>
+		{:else}
+			{#each requests as request (request.id)}
+				<Card.Root>
+					<Card.Header>
+						<div class="flex flex-wrap items-start justify-between gap-3">
+							<div>
+								<Card.Title class="text-base">
+									{request.target.title ?? request.target.view}
+								</Card.Title>
+								<Card.Description>
+									{requesterLabel(request)} · {request.urgency} · expires
+									{new Date(request.expiresAt).toLocaleTimeString()}
+								</Card.Description>
+							</div>
+							<Badge variant={request.urgency === 'high' ? 'destructive' : 'secondary'}>
+								{request.urgency}
+							</Badge>
+						</div>
+					</Card.Header>
+					<Card.Content>
+						<p class="mb-4 whitespace-pre-wrap text-sm text-foreground">{request.message}</p>
+						<div class="flex gap-2">
+							<Button
+								disabled={busy || activeRequest !== null}
+								onclick={() => onRespond?.(request, 'accept')}
+							>
+								Show me
+							</Button>
+							<Button
+								variant="outline"
+								disabled={busy}
+								onclick={() => onRespond?.(request, 'decline')}
+							>
+								Not now
+							</Button>
+						</div>
+					</Card.Content>
+				</Card.Root>
+			{/each}
+		{/if}
+	</div>
+</section>

package/dist/svelte/documents/presentations/components/PresentationMonitor.svelte.d.ts

@@ -0,0 +1,16 @@
+import type { PresentationRequest, PresentationReviewAudience } from '@vibesdotdev/docs/documents/presentations/schemas';
+type $$ComponentProps = {
+    surfaceState: 'connecting' | 'available' | 'stale' | 'offline';
+    requests: PresentationRequest[];
+    activeRequest?: PresentationRequest | null;
+    busy?: boolean;
+    error?: string | null;
+    onRefresh?: () => void;
+    onRespond?: (request: PresentationRequest, decision: 'accept' | 'decline') => void;
+    onSubmitComment?: (request: PresentationRequest, text: string, audience: PresentationReviewAudience) => void;
+    onFinish?: (request: PresentationRequest) => void;
+};
+declare const PresentationMonitor: import("svelte").Component<$$ComponentProps, {}, "">;
+type PresentationMonitor = ReturnType<typeof PresentationMonitor>;
+export default PresentationMonitor;
+//# sourceMappingURL=PresentationMonitor.svelte.d.ts.map

package/dist/svelte/documents/presentations/components/PresentationMonitor.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PresentationMonitor.svelte.d.ts","sourceRoot":"","sources":["../../../../../src/svelte/documents/presentations/components/PresentationMonitor.svelte.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EACV,mBAAmB,EACnB,0BAA0B,EAC1B,MAAM,mDAAmD,CAAC;AAE3D,KAAK,gBAAgB,GAAI;IACxB,YAAY,EAAE,YAAY,GAAG,WAAW,GAAG,OAAO,GAAG,SAAS,CAAC;IAC/D,QAAQ,EAAE,mBAAmB,EAAE,CAAC;IAChC,aAAa,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAC3C,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,mBAAmB,EAAE,QAAQ,EAAE,QAAQ,GAAG,SAAS,KAAK,IAAI,CAAC;IACnF,eAAe,CAAC,EAAE,CACjB,OAAO,EAAE,mBAAmB,EAC5B,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,0BAA0B,KAChC,IAAI,CAAC;IACV,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,mBAAmB,KAAK,IAAI,CAAC;CAClD,CAAC;AA4NH,QAAA,MAAM,mBAAmB,sDAAwC,CAAC;AAClE,KAAK,mBAAmB,GAAG,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAClE,eAAe,mBAAmB,CAAC"}

package/dist/svelte/documents/presentations/index.d.ts

@@ -0,0 +1,3 @@
+export { default as PresentationMonitor } from './components/PresentationMonitor.svelte';
+export * from './monitor-state.ts';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/svelte/documents/presentations/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,yCAAyC,CAAC;AACzF,cAAc,oBAAoB,CAAC"}

package/dist/svelte/documents/presentations/index.js

@@ -0,0 +1,2 @@
+export { default as PresentationMonitor } from './components/PresentationMonitor.svelte';
+export * from "./monitor-state.js";

package/dist/svelte/documents/presentations/monitor-state.d.ts

@@ -0,0 +1,17 @@
+import type { PresentationRequest, PresentationSurfaceCapability } from '@vibesdotdev/docs/documents/presentations/schemas';
+export interface PresentationMonitorState {
+    incoming: PresentationRequest[];
+    active: PresentationRequest | null;
+    shouldAdvertiseAvailable: boolean;
+}
+export declare function presentationMonitorIncomingRequestsPath(): string;
+export declare function presentationMonitorActiveRequestPath(surfaceId: string): string;
+/**
+ * Convert authoritative request history into the live state of one surface.
+ *
+ * The owner API durably reconciles expiry. This projection also fails closed
+ * if an older provider returns an elapsed active row, so a surface never keeps
+ * rendering or advertising itself busy from stale history.
+ */
+export declare function selectPresentationMonitorState(requests: PresentationRequest[], surfaceId: string | undefined, capabilities: readonly PresentationSurfaceCapability[], previousActiveRequestId: string | null, at?: Date): PresentationMonitorState;
+//# sourceMappingURL=monitor-state.d.ts.map

package/dist/svelte/documents/presentations/monitor-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"monitor-state.d.ts","sourceRoot":"","sources":["../../../../src/svelte/documents/presentations/monitor-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,mBAAmB,EACnB,6BAA6B,EAC7B,MAAM,mDAAmD,CAAC;AAE3D,MAAM,WAAW,wBAAwB;IACxC,QAAQ,EAAE,mBAAmB,EAAE,CAAC;IAChC,MAAM,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACnC,wBAAwB,EAAE,OAAO,CAAC;CAClC;AAYD,wBAAgB,uCAAuC,IAAI,MAAM,CAEhE;AAED,wBAAgB,oCAAoC,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE9E;AAED;;;;;;GAMG;AACH,wBAAgB,8BAA8B,CAC7C,QAAQ,EAAE,mBAAmB,EAAE,EAC/B,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,YAAY,EAAE,SAAS,6BAA6B,EAAE,EACtD,uBAAuB,EAAE,MAAM,GAAG,IAAI,EACtC,EAAE,GAAE,IAAiB,GACnB,wBAAwB,CAyB1B"}

package/dist/svelte/documents/presentations/monitor-state.js

@@ -0,0 +1,38 @@
+function presentationMonitorRequestsPath(statuses, surfaceId) {
+    const query = new URLSearchParams();
+    for (const status of statuses)
+        query.append('status', status);
+    if (surfaceId)
+        query.set('surfaceId', surfaceId);
+    return `/api/presentations/requests?${query.toString()}`;
+}
+export function presentationMonitorIncomingRequestsPath() {
+    return presentationMonitorRequestsPath(['pending']);
+}
+export function presentationMonitorActiveRequestPath(surfaceId) {
+    return presentationMonitorRequestsPath(['accepted', 'presenting'], surfaceId);
+}
+/**
+ * Convert authoritative request history into the live state of one surface.
+ *
+ * The owner API durably reconciles expiry. This projection also fails closed
+ * if an older provider returns an elapsed active row, so a surface never keeps
+ * rendering or advertising itself busy from stale history.
+ */
+export function selectPresentationMonitorState(requests, surfaceId, capabilities, previousActiveRequestId, at = new Date()) {
+    const now = at.getTime();
+    const isLive = (request) => Date.parse(request.expiresAt) > now;
+    const hasCapabilities = (request) => request.requestedCapabilities.every((capability) => capabilities.includes(capability));
+    const incoming = requests.filter((request) => request.status === 'pending' &&
+        isLive(request) &&
+        (!request.preferredSurfaceId || request.preferredSurfaceId === surfaceId) &&
+        hasCapabilities(request));
+    const active = requests.find((request) => request.selectedSurfaceId === surfaceId &&
+        (request.status === 'accepted' || request.status === 'presenting') &&
+        isLive(request)) ?? null;
+    return {
+        incoming,
+        active,
+        shouldAdvertiseAvailable: previousActiveRequestId !== null && active === null
+    };
+}

package/dist/svelte/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @vibesdotdev/docs/svelte — SvelteKit-bound docs surfaces.
+ *
+ * See `docs/architecture/DOCS-RUNTIME.md` for the overall design.
+ */
+export { default as MarkdownView } from './ui/markdown/MarkdownView.svelte';
+export { default as HelpIcon } from './ui/help/HelpIcon.svelte';
+export { default as HelpDialog } from './ui/help/HelpDialog.svelte';
+export { default as DirectiveDispatch } from './ui/directives/DirectiveDispatch.svelte';
+export { default as DocsLoader } from './ui/DocsLoader.svelte';
+export { default as DocsSearch } from './ui/DocsSearch.svelte';
+export { default as DocViewer } from './ui/DocViewer.svelte';
+export { docsState, getDocsState, DocsState } from './state.svelte.ts';
+export type { DocsStateInitOptions } from './state.svelte.ts';
+export { setDocsTopics, getDocsTopics } from './context.ts';
+export { pageRenderableTopics, topicEntries, idToSlug, slugToId, indexedTopicFor, buildSidebar, sectionRoots, sectionRootFor } from './build/topic-index.ts';
+export type { IndexedTopic, SidebarEntry, SidebarGroup, SectionRoot } from './build/topic-index.ts';
+export { highlightParsedTopic, rewriteTopicLinks } from './build/highlight.ts';
+export type { HighlightedCodeToken } from './build/highlight.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;;;;GAIG;AAGH,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAC5E,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,0CAA0C,CAAC;AACxF,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAE7D,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACvE,YAAY,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAE9D,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE5D,OAAO,EACN,oBAAoB,EACpB,YAAY,EACZ,QAAQ,EACR,QAAQ,EACR,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACX,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC/E,YAAY,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/svelte/index.js

@@ -0,0 +1,16 @@
+/**
+ * @vibesdotdev/docs/svelte — SvelteKit-bound docs surfaces.
+ *
+ * See `docs/architecture/DOCS-RUNTIME.md` for the overall design.
+ */
+export { default as MarkdownView } from './ui/markdown/MarkdownView.svelte';
+export { default as HelpIcon } from './ui/help/HelpIcon.svelte';
+export { default as HelpDialog } from './ui/help/HelpDialog.svelte';
+export { default as DirectiveDispatch } from './ui/directives/DirectiveDispatch.svelte';
+export { default as DocsLoader } from './ui/DocsLoader.svelte';
+export { default as DocsSearch } from './ui/DocsSearch.svelte';
+export { default as DocViewer } from './ui/DocViewer.svelte';
+export { docsState, getDocsState, DocsState } from "./state.svelte.js";
+export { setDocsTopics, getDocsTopics } from "./context.js";
+export { pageRenderableTopics, topicEntries, idToSlug, slugToId, indexedTopicFor, buildSidebar, sectionRoots, sectionRootFor } from "./build/topic-index.js";
+export { highlightParsedTopic, rewriteTopicLinks } from "./build/highlight.js";

package/dist/svelte/loaders.d.ts

@@ -0,0 +1,57 @@
+/**
+ * SvelteKit `load` helpers for `@vibesdotdev/docs/svelte`.
+ *
+ * Exported under the `./loaders` subpath so SvelteKit keeps server-only
+ * code out of the browser bundle (see SURFACE-PACKAGE-CONVENTIONS §2.5 / §2.7).
+ *
+ * Two modes:
+ *  - Runtime-backed (default): pulls topics directly from the registered
+ *    `DocsClient` via `getVibesDocsClient(runtime)`. Used when the consuming app
+ *    has the docs plugin installed in its runtime.
+ *  - DI-fetcher: callers supply a `fetchers.listDocs` function. Useful when
+ *    docs descriptors live behind a cross-origin HTTP API or in an app's
+ *    own `src/server/` tree (mirrors the pattern in `account-svelte/src/
+ *    loaders.ts`).
+ */
+import type { DocsTopicDescriptor } from '@vibesdotdev/docs/schemas';
+import { type VibesRuntime } from '@vibesdotdev/kernel';
+export interface DocsLayoutData {
+    docs: DocsTopicDescriptor[];
+    activeDocId: string | null;
+}
+export interface DocsLayoutFetchers {
+    /** List enabled docs topics. */
+    listDocs: () => Promise<readonly DocsTopicDescriptor[]>;
+}
+export interface LoadDocsLayoutDataInput {
+    activeDocId?: string | null;
+    /** The request's runtime (`event.locals.runtime`); required unless `fetchers` is given. */
+    runtime?: VibesRuntime;
+    /** Provide to override the runtime-client lookup. */
+    fetchers?: DocsLayoutFetchers;
+    /** When true, propagates fetch errors instead of degrading. Default false. */
+    throwOnError?: boolean;
+}
+/**
+ * Compose the docs layout payload for a SvelteKit `+layout.server.ts`.
+ *
+ * Returns a serializable object the consuming app spreads into its own
+ * `LayoutServerLoad` return. `docsState.seedInitial()` consumes the same
+ * fields on the client.
+ *
+ * Usage (runtime-backed):
+ *
+ *   import { loadDocsLayoutData } from '@vibesdotdev/docs/svelte/loaders';
+ *
+ *   export const load: LayoutServerLoad = async ({ locals }) => {
+ *     return await loadDocsLayoutData({ runtime: locals.runtime, activeDocId: null });
+ *   };
+ *
+ * Usage (DI):
+ *
+ *   const data = await loadDocsLayoutData({
+ *     fetchers: { listDocs: () => myDocsApi.list() }
+ *   });
+ */
+export declare function loadDocsLayoutData(input?: LoadDocsLayoutDataInput): Promise<DocsLayoutData>;
+//# sourceMappingURL=loaders.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"loaders.d.ts","sourceRoot":"","sources":["../../src/svelte/loaders.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAErE,OAAO,EAAmB,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEzE,MAAM,WAAW,cAAc;IAC9B,IAAI,EAAE,mBAAmB,EAAE,CAAC;IAC5B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,kBAAkB;IAClC,gCAAgC;IAChC,QAAQ,EAAE,MAAM,OAAO,CAAC,SAAS,mBAAmB,EAAE,CAAC,CAAC;CACxD;AAED,MAAM,WAAW,uBAAuB;IACvC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,2FAA2F;IAC3F,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,qDAAqD;IACrD,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAC9B,8EAA8E;IAC9E,YAAY,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,kBAAkB,CACvC,KAAK,GAAE,uBAA4B,GACjC,OAAO,CAAC,cAAc,CAAC,CAsCzB"}

package/dist/svelte/loaders.js

@@ -0,0 +1,74 @@
+/**
+ * SvelteKit `load` helpers for `@vibesdotdev/docs/svelte`.
+ *
+ * Exported under the `./loaders` subpath so SvelteKit keeps server-only
+ * code out of the browser bundle (see SURFACE-PACKAGE-CONVENTIONS §2.5 / §2.7).
+ *
+ * Two modes:
+ *  - Runtime-backed (default): pulls topics directly from the registered
+ *    `DocsClient` via `getVibesDocsClient(runtime)`. Used when the consuming app
+ *    has the docs plugin installed in its runtime.
+ *  - DI-fetcher: callers supply a `fetchers.listDocs` function. Useful when
+ *    docs descriptors live behind a cross-origin HTTP API or in an app's
+ *    own `src/server/` tree (mirrors the pattern in `account-svelte/src/
+ *    loaders.ts`).
+ */
+import { getLogger } from '@vibesdotdev/logging';
+import { CapabilityError } from '@vibesdotdev/kernel';
+/**
+ * Compose the docs layout payload for a SvelteKit `+layout.server.ts`.
+ *
+ * Returns a serializable object the consuming app spreads into its own
+ * `LayoutServerLoad` return. `docsState.seedInitial()` consumes the same
+ * fields on the client.
+ *
+ * Usage (runtime-backed):
+ *
+ *   import { loadDocsLayoutData } from '@vibesdotdev/docs/svelte/loaders';
+ *
+ *   export const load: LayoutServerLoad = async ({ locals }) => {
+ *     return await loadDocsLayoutData({ runtime: locals.runtime, activeDocId: null });
+ *   };
+ *
+ * Usage (DI):
+ *
+ *   const data = await loadDocsLayoutData({
+ *     fetchers: { listDocs: () => myDocsApi.list() }
+ *   });
+ */
+export async function loadDocsLayoutData(input = {}) {
+    const { activeDocId = null, fetchers, runtime, throwOnError = false } = input;
+    if (!fetchers && !runtime) {
+        throw new CapabilityError('loadDocsLayoutData needs `runtime` (event.locals.runtime) or `fetchers`.', 'INVALID_INPUT', { reason: 'runtime-required', retryable: false });
+    }
+    try {
+        let docs;
+        if (fetchers) {
+            docs = await fetchers.listDocs();
+        }
+        else if (runtime) {
+            const { getVibesDocsClient } = await import('@vibesdotdev/docs');
+            const client = await getVibesDocsClient(runtime);
+            docs = client.list();
+        }
+        else {
+            docs = [];
+        }
+        return {
+            docs: [...docs],
+            activeDocId
+        };
+    }
+    catch (err) {
+        if (!throwOnError && err instanceof Error && CapabilityError.isAbsenceOf(err, 'runtime/client', 'docs')) {
+            getLogger('docs.svelte.loaders', runtime).warn('docs client not registered; returning an empty list', {
+                error: err.message
+            });
+            return {
+                docs: [],
+                activeDocId
+            };
+        }
+        throw err;
+    }
+}