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

package/dist/svelte/state.svelte.d.ts

@@ -0,0 +1,366 @@
+import type { DocsTopicDescriptor } from '@vibesdotdev/docs/schemas';
+import type { DocsClient } from '@vibesdotdev/docs';
+import { CapabilityError, type VibesRuntime } from '@vibesdotdev/kernel';
+export interface DocsStateInitOptions {
+    /** Pre-built docs client (tests / cross-runtime). When omitted, the store
+     * resolves `getVibesDocsClient(runtime)` lazily from `runtimeStore`. */
+    client?: DocsClient;
+    /** The captured `getRuntimeSvelteContext()` store; required when `client` is omitted. */
+    runtimeStore?: {
+        load(): Promise<VibesRuntime>;
+    };
+    /** Initial docs list from `+layout.server.ts`, if available. */
+    initialDocs?: readonly DocsTopicDescriptor[];
+    /** Initial active doc id from `+layout.server.ts`, if available. */
+    initialActiveDocId?: string | null;
+}
+export declare class DocsState {
+    docs: {
+        kind: "docs/topic";
+        id: string;
+        title: string;
+        body: {
+            type: "markdown";
+            sourceType: "package" | "raw";
+            source: string;
+        } | {
+            type: "component";
+            path: string;
+            exportKey: string;
+            props?: Record<string, unknown> | undefined;
+        } | {
+            type: "route";
+            path: string;
+        } | {
+            type: "openapi";
+            source: string;
+        } | {
+            type: "graphql";
+            source: string;
+        } | {
+            type: "descriptor-ref";
+            kind: string;
+            id: string;
+        };
+        tags: string[];
+        surfaces: ("cli" | "web" | "in-app" | "mcp")[];
+        enabled: boolean;
+        summary?: string | undefined;
+        parent?: string | undefined;
+        track?: "start-here" | "framework-kit" | "platform-cloud" | "local-tooling" | "api-reference" | "internals" | undefined;
+        order?: number | undefined;
+        subject?: {
+            kind: string;
+            id: string;
+        } | undefined;
+        man?: {
+            name?: string | undefined;
+            section?: number | undefined;
+            synopsis?: string | undefined;
+            options?: {
+                flag: string;
+                description: string;
+            }[] | undefined;
+            examples?: {
+                description: string;
+                command: string;
+            }[] | undefined;
+            seeAlso?: string[] | undefined;
+        } | undefined;
+        hardware?: ("consumer" | "cloud")[] | undefined;
+        citationOrigin?: {
+            link: {
+                kind: string;
+                id: string;
+                source: string;
+                role: string;
+            };
+            scope: string;
+            revision: {
+                scheme: string;
+                value: string;
+            };
+            anchor?: {
+                kind: "code";
+                path: string;
+                startLine: number;
+                endLine: number;
+            } | {
+                kind: "region";
+                start: number;
+                end: number;
+            } | {
+                kind: "fragment";
+                id: string;
+            } | {
+                kind: "heading";
+                slug: string;
+            } | undefined;
+            freshness?: {
+                modifiedAt?: string | undefined;
+                stale?: boolean | undefined;
+            } | undefined;
+        } | undefined;
+        citationFreshness?: {
+            document: {
+                link: {
+                    kind: string;
+                    id: string;
+                    source: string;
+                    role: string;
+                };
+                scope: string;
+                revision: {
+                    scheme: string;
+                    value: string;
+                };
+                anchor?: {
+                    kind: "code";
+                    path: string;
+                    startLine: number;
+                    endLine: number;
+                } | {
+                    kind: "region";
+                    start: number;
+                    end: number;
+                } | {
+                    kind: "fragment";
+                    id: string;
+                } | {
+                    kind: "heading";
+                    slug: string;
+                } | undefined;
+                freshness?: {
+                    modifiedAt?: string | undefined;
+                    stale?: boolean | undefined;
+                } | undefined;
+            };
+            references: {
+                link: {
+                    kind: string;
+                    id: string;
+                    source: string;
+                    role: string;
+                };
+                scope: string;
+                revision: {
+                    scheme: string;
+                    value: string;
+                };
+                anchor?: {
+                    kind: "code";
+                    path: string;
+                    startLine: number;
+                    endLine: number;
+                } | {
+                    kind: "region";
+                    start: number;
+                    end: number;
+                } | {
+                    kind: "fragment";
+                    id: string;
+                } | {
+                    kind: "heading";
+                    slug: string;
+                } | undefined;
+                freshness?: {
+                    modifiedAt?: string | undefined;
+                    stale?: boolean | undefined;
+                } | undefined;
+            }[];
+        } | undefined;
+    }[];
+    activeDocId: string | null;
+    searchQuery: string;
+    results: {
+        kind: "docs/topic";
+        id: string;
+        title: string;
+        body: {
+            type: "markdown";
+            sourceType: "package" | "raw";
+            source: string;
+        } | {
+            type: "component";
+            path: string;
+            exportKey: string;
+            props?: Record<string, unknown> | undefined;
+        } | {
+            type: "route";
+            path: string;
+        } | {
+            type: "openapi";
+            source: string;
+        } | {
+            type: "graphql";
+            source: string;
+        } | {
+            type: "descriptor-ref";
+            kind: string;
+            id: string;
+        };
+        tags: string[];
+        surfaces: ("cli" | "web" | "in-app" | "mcp")[];
+        enabled: boolean;
+        summary?: string | undefined;
+        parent?: string | undefined;
+        track?: "start-here" | "framework-kit" | "platform-cloud" | "local-tooling" | "api-reference" | "internals" | undefined;
+        order?: number | undefined;
+        subject?: {
+            kind: string;
+            id: string;
+        } | undefined;
+        man?: {
+            name?: string | undefined;
+            section?: number | undefined;
+            synopsis?: string | undefined;
+            options?: {
+                flag: string;
+                description: string;
+            }[] | undefined;
+            examples?: {
+                description: string;
+                command: string;
+            }[] | undefined;
+            seeAlso?: string[] | undefined;
+        } | undefined;
+        hardware?: ("consumer" | "cloud")[] | undefined;
+        citationOrigin?: {
+            link: {
+                kind: string;
+                id: string;
+                source: string;
+                role: string;
+            };
+            scope: string;
+            revision: {
+                scheme: string;
+                value: string;
+            };
+            anchor?: {
+                kind: "code";
+                path: string;
+                startLine: number;
+                endLine: number;
+            } | {
+                kind: "region";
+                start: number;
+                end: number;
+            } | {
+                kind: "fragment";
+                id: string;
+            } | {
+                kind: "heading";
+                slug: string;
+            } | undefined;
+            freshness?: {
+                modifiedAt?: string | undefined;
+                stale?: boolean | undefined;
+            } | undefined;
+        } | undefined;
+        citationFreshness?: {
+            document: {
+                link: {
+                    kind: string;
+                    id: string;
+                    source: string;
+                    role: string;
+                };
+                scope: string;
+                revision: {
+                    scheme: string;
+                    value: string;
+                };
+                anchor?: {
+                    kind: "code";
+                    path: string;
+                    startLine: number;
+                    endLine: number;
+                } | {
+                    kind: "region";
+                    start: number;
+                    end: number;
+                } | {
+                    kind: "fragment";
+                    id: string;
+                } | {
+                    kind: "heading";
+                    slug: string;
+                } | undefined;
+                freshness?: {
+                    modifiedAt?: string | undefined;
+                    stale?: boolean | undefined;
+                } | undefined;
+            };
+            references: {
+                link: {
+                    kind: string;
+                    id: string;
+                    source: string;
+                    role: string;
+                };
+                scope: string;
+                revision: {
+                    scheme: string;
+                    value: string;
+                };
+                anchor?: {
+                    kind: "code";
+                    path: string;
+                    startLine: number;
+                    endLine: number;
+                } | {
+                    kind: "region";
+                    start: number;
+                    end: number;
+                } | {
+                    kind: "fragment";
+                    id: string;
+                } | {
+                    kind: "heading";
+                    slug: string;
+                } | undefined;
+                freshness?: {
+                    modifiedAt?: string | undefined;
+                    stale?: boolean | undefined;
+                } | undefined;
+            }[];
+        } | undefined;
+    }[];
+    initialized: boolean;
+    loading: boolean;
+    failure: CapabilityError | null;
+    get error(): string | null;
+    private client;
+    private generation;
+    /** The doc descriptor matching `activeDocId`, or null. */
+    get activeDoc(): DocsTopicDescriptor | null;
+    /** Total enabled docs. */
+    get count(): number;
+    /** Resolve a body string for the active doc, when it's markdown/raw. */
+    get activeBody(): string | null;
+    /** Resolve the handed runtime's semantic client and refresh this projection. */
+    init(options?: DocsStateInitOptions): Promise<void>;
+    /**
+     * Seed reactive state from a server-side payload. Safe to call before or
+     * after `init()`. Repeated seeds replace existing values, matching
+     * `invalidateAll()` semantics.
+     */
+    seedInitial(options: DocsStateInitOptions): void;
+    /**
+     * Update the search query and refresh the filtered results synchronously
+     * against the loaded docs list. Falls back to a local substring scan when
+     * the runtime client is absent (e.g. seeded-only contexts).
+     */
+    setSearchQuery(query: string): void;
+    /** Select a doc as active. Pass null to clear. */
+    setActiveDoc(id: string | null): void;
+    /** Resolve the body of any docs descriptor via the runtime client. */
+    resolveBody(doc: DocsTopicDescriptor): string | null;
+    dispose(): void;
+}
+/** Establish in a parent layout to share one projection among its descendants. */
+export declare function getDocsState(): DocsState;
+/** Retained name as a context accessor; call during component initialization. */
+export declare const docsState: typeof getDocsState;
+//# sourceMappingURL=state.svelte.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"state.svelte.d.ts","sourceRoot":"","sources":["../../src/svelte/state.svelte.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAuB,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAE9F,MAAM,WAAW,oBAAoB;IACpC;4EACwE;IACxE,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,yFAAyF;IACzF,YAAY,CAAC,EAAE;QAAE,IAAI,IAAI,OAAO,CAAC,YAAY,CAAC,CAAA;KAAE,CAAC;IACjD,gEAAgE;IAChE,WAAW,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAC7C,oEAAoE;IACpE,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC;AAED,qBAAa,SAAS;IACrB,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAAqC;IACzC,WAAW,gBAA+B;IAC1C,WAAW,SAAsB;IACjC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAAqC;IAE5C,WAAW,UAAiB;IAC5B,OAAO,UAAiB;IACxB,OAAO,yBAAwC;IAE/C,IAAI,KAAK,IAAI,MAAM,GAAG,IAAI,CAEzB;IAED,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,UAAU,CAAK;IAEvB,0DAA0D;IAC1D,IAAI,SAAS,IAAI,mBAAmB,GAAG,IAAI,CAG1C;IAED,0BAA0B;IAC1B,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,wEAAwE;IACxE,IAAI,UAAU,IAAI,MAAM,GAAG,IAAI,CAI9B;IAED,gFAAgF;IAC1E,IAAI,CAAC,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAAC,IAAI,CAAC;IAsC7D;;;;OAIG;IACH,WAAW,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI;IAUhD;;;;OAIG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAmBnC,kDAAkD;IAClD,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAIrC,sEAAsE;IACtE,WAAW,CAAC,GAAG,EAAE,mBAAmB,GAAG,MAAM,GAAG,IAAI;IAIpD,OAAO,IAAI,IAAI;CAWf;AAID,kFAAkF;AAClF,wBAAgB,YAAY,IAAI,SAAS,CAOxC;AAED,iFAAiF;AACjF,eAAO,MAAM,SAAS,qBAAe,CAAC"}

package/dist/svelte/state.svelte.js

@@ -0,0 +1,155 @@
+/**
+ * Context-owned reactive projection of runtime/client:docs.
+ * Call getDocsState during component initialization; a parent can establish
+ * the context for sibling loader, search and viewer components.
+ */
+import { getContext, setContext, onDestroy } from 'svelte';
+import { CapabilityError, CaughtFailureSchema } from '@vibesdotdev/kernel';
+export class DocsState {
+    docs = $state([]);
+    activeDocId = $state(null);
+    searchQuery = $state('');
+    results = $state([]);
+    initialized = $state(false);
+    loading = $state(false);
+    failure = $state(null);
+    get error() {
+        return this.failure?.message ?? null;
+    }
+    client = null;
+    generation = 0;
+    /** The doc descriptor matching `activeDocId`, or null. */
+    get activeDoc() {
+        if (!this.activeDocId)
+            return null;
+        return this.docs.find((d) => d.id === this.activeDocId) ?? null;
+    }
+    /** Total enabled docs. */
+    get count() {
+        return this.docs.length;
+    }
+    /** Resolve a body string for the active doc, when it's markdown/raw. */
+    get activeBody() {
+        const doc = this.activeDoc;
+        if (!doc || !this.client)
+            return null;
+        return this.client.resolveBody(doc);
+    }
+    /** Resolve the handed runtime's semantic client and refresh this projection. */
+    async init(options = {}) {
+        const generation = ++this.generation;
+        this.loading = true;
+        this.failure = null;
+        try {
+            const { getVibesDocsClient } = await import('@vibesdotdev/docs');
+            if (!options.client && !options.runtimeStore) {
+                throw new CapabilityError('Docs state needs a client or runtimeStore.', 'INVALID_INPUT', {
+                    reason: 'runtime-required', retryable: false
+                });
+            }
+            let client = options.client;
+            if (!client && options.runtimeStore)
+                client = await getVibesDocsClient(await options.runtimeStore.load());
+            if (!client)
+                return;
+            if (generation !== this.generation)
+                return;
+            if (this.client !== client) {
+                this.searchQuery = '';
+                this.activeDocId = null;
+            }
+            this.client = client;
+            this.docs = client.list();
+            this.setSearchQuery(this.searchQuery);
+            this.seedInitial(options);
+            this.initialized = true;
+        }
+        catch (err) {
+            if (generation !== this.generation)
+                return;
+            this.client = null;
+            this.docs = [];
+            this.results = [];
+            this.activeDocId = null;
+            this.searchQuery = '';
+            this.failure = CapabilityError.from(CaughtFailureSchema.parse(err));
+            this.initialized = true;
+        }
+        finally {
+            if (generation === this.generation)
+                this.loading = false;
+        }
+    }
+    /**
+     * Seed reactive state from a server-side payload. Safe to call before or
+     * after `init()`. Repeated seeds replace existing values, matching
+     * `invalidateAll()` semantics.
+     */
+    seedInitial(options) {
+        if (options.initialDocs) {
+            this.docs = [...options.initialDocs];
+            this.results = this.results.length === 0 ? [...options.initialDocs] : this.results;
+        }
+        if (options.initialActiveDocId !== undefined) {
+            this.activeDocId = options.initialActiveDocId;
+        }
+    }
+    /**
+     * Update the search query and refresh the filtered results synchronously
+     * against the loaded docs list. Falls back to a local substring scan when
+     * the runtime client is absent (e.g. seeded-only contexts).
+     */
+    setSearchQuery(query) {
+        this.searchQuery = query;
+        const q = query.trim().toLowerCase();
+        if (!q) {
+            this.results = this.docs;
+            return;
+        }
+        if (this.client) {
+            this.results = this.client.search(query);
+            return;
+        }
+        this.results = this.docs.filter((d) => {
+            if (d.id.toLowerCase().includes(q))
+                return true;
+            if (d.title.toLowerCase().includes(q))
+                return true;
+            if ((d.summary ?? '').toLowerCase().includes(q))
+                return true;
+            return d.tags.some((tag) => tag.toLowerCase().includes(q));
+        });
+    }
+    /** Select a doc as active. Pass null to clear. */
+    setActiveDoc(id) {
+        this.activeDocId = id;
+    }
+    /** Resolve the body of any docs descriptor via the runtime client. */
+    resolveBody(doc) {
+        return this.client?.resolveBody(doc) ?? null;
+    }
+    dispose() {
+        this.generation++;
+        this.loading = false;
+        this.client = null;
+        this.initialized = false;
+        this.docs = [];
+        this.results = [];
+        this.activeDocId = null;
+        this.searchQuery = '';
+        this.failure = null;
+    }
+}
+const DOCS_STATE_KEY = Symbol('docs-state');
+/** Establish in a parent layout to share one projection among its descendants. */
+export function getDocsState() {
+    const inherited = getContext(DOCS_STATE_KEY);
+    if (inherited)
+        return inherited;
+    const state = new DocsState();
+    setContext(DOCS_STATE_KEY, state);
+    onDestroy(() => state.dispose());
+    return state;
+}
+/** Retained name as a context accessor; call during component initialization. */
+export const docsState = getDocsState;

package/dist/svelte/styles.css

@@ -0,0 +1,8 @@
+/*
+ * Tailwind v4 source declaration for consumers — mirrors @vibesdotdev/kit's
+ * styles.css pattern. Apps that @import this file get this package's
+ * components scanned by their Tailwind build, so utility classes used only
+ * inside these components are emitted in the app's CSS bundle (Tailwind
+ * never scans node_modules). Paths resolve relative to this file.
+ */
+@source "./";

package/dist/svelte/tool-widgets/DocsToolCard.svelte

@@ -0,0 +1,41 @@
+<script lang="ts">
+	/**
+	 * First-party widget for `docs`: search query and topic hits.
+	 */
+	import { Badge } from '@vibesdotdev/kit/components/ui/badge';
+	import {
+		ToolCard,
+		ToolCardBody,
+		type ToolWidgetProps
+	} from '@vibesdotdev/kit/components/tool-widgets';
+	import { docsToolCardModel } from './models.js';
+
+	let { tool, compact = false }: ToolWidgetProps = $props();
+
+	const model = $derived(docsToolCardModel(tool));
+	const title = $derived(
+		model.query ? `${model.hits.length} docs hit${model.hits.length === 1 ? '' : 's'}` : 'Docs'
+	);
+</script>
+
+<ToolCard {tool} {compact} {title} icon="lucide:book-open">
+	<ToolCardBody {compact}>
+		{#if model.query}
+			<Badge variant="secondary" class="max-w-full truncate text-caption">{model.query}</Badge>
+		{/if}
+		{#if model.hits.length}
+			<ul class="space-y-1.5">
+				{#each model.hits as hit (hit.id)}
+					<li class="min-w-0">
+						<p class="truncate font-medium text-foreground">{hit.title}</p>
+						{#if hit.summary}
+							<p class="line-clamp-2 text-footnote text-muted-foreground">{hit.summary}</p>
+						{/if}
+					</li>
+				{/each}
+			</ul>
+		{:else if !tool.error}
+			<p class="text-muted-foreground italic">No matching topics.</p>
+		{/if}
+	</ToolCardBody>
+</ToolCard>

package/dist/svelte/tool-widgets/DocsToolCard.svelte.d.ts

@@ -0,0 +1,5 @@
+import { type ToolWidgetProps } from '@vibesdotdev/kit/components/tool-widgets';
+declare const DocsToolCard: import("svelte").Component<ToolWidgetProps, {}, "">;
+type DocsToolCard = ReturnType<typeof DocsToolCard>;
+export default DocsToolCard;
+//# sourceMappingURL=DocsToolCard.svelte.d.ts.map

package/dist/svelte/tool-widgets/DocsToolCard.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DocsToolCard.svelte.d.ts","sourceRoot":"","sources":["../../../src/svelte/tool-widgets/DocsToolCard.svelte.ts"],"names":[],"mappings":"AAOA,OAAO,EAGL,KAAK,eAAe,EACpB,MAAM,0CAA0C,CAAC;AAyCnD,QAAA,MAAM,YAAY,qDAAwC,CAAC;AAC3D,KAAK,YAAY,GAAG,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC;AACpD,eAAe,YAAY,CAAC"}

package/dist/svelte/tool-widgets/DocumentReadToolCard.svelte

@@ -0,0 +1,28 @@
+<script lang="ts">
+	/**
+	 * First-party widget for `document.read`: source path and a text excerpt.
+	 */
+	import {
+		ToolCard,
+		ToolCardBody,
+		type ToolWidgetProps
+	} from '@vibesdotdev/kit/components/tool-widgets';
+	import { documentReadToolCardModel } from './models.js';
+
+	let { tool, compact = false }: ToolWidgetProps = $props();
+
+	const model = $derived(documentReadToolCardModel(tool));
+</script>
+
+<ToolCard {tool} {compact} title={model.path || 'Read document'} icon="lucide:file-text">
+	<ToolCardBody {compact}>
+		{#if model.path}
+			<p class="truncate font-mono text-footnote text-muted-foreground">{model.path}</p>
+		{/if}
+		{#if model.excerpt}
+			<p class="whitespace-pre-wrap text-foreground">{model.excerpt}</p>
+		{:else if !tool.error}
+			<p class="text-muted-foreground italic">No excerpt returned.</p>
+		{/if}
+	</ToolCardBody>
+</ToolCard>

package/dist/svelte/tool-widgets/DocumentReadToolCard.svelte.d.ts

@@ -0,0 +1,8 @@
+/**
+     * First-party widget for `document.read`: source path and a text excerpt.
+     */
+import { type ToolWidgetProps } from '@vibesdotdev/kit/components/tool-widgets';
+declare const DocumentReadToolCard: import("svelte").Component<ToolWidgetProps, {}, "">;
+type DocumentReadToolCard = ReturnType<typeof DocumentReadToolCard>;
+export default DocumentReadToolCard;
+//# sourceMappingURL=DocumentReadToolCard.svelte.d.ts.map

package/dist/svelte/tool-widgets/DocumentReadToolCard.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DocumentReadToolCard.svelte.d.ts","sourceRoot":"","sources":["../../../src/svelte/tool-widgets/DocumentReadToolCard.svelte.ts"],"names":[],"mappings":"AAGA;;OAEI;AACJ,OAAO,EAGL,KAAK,eAAe,EACpB,MAAM,0CAA0C,CAAC;AA4BnD,QAAA,MAAM,oBAAoB,qDAAwC,CAAC;AACnE,KAAK,oBAAoB,GAAG,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC;AACpE,eAAe,oBAAoB,CAAC"}

package/dist/svelte/tool-widgets/PresentationsToolCard.svelte

@@ -0,0 +1,25 @@
+<script lang="ts">
+	/**
+	 * First-party widget for `presentations`: the requested presentation title.
+	 */
+	import {
+		ToolCard,
+		ToolCardBody,
+		type ToolWidgetProps
+	} from '@vibesdotdev/kit/components/tool-widgets';
+	import { presentationsToolCardModel } from './models.js';
+
+	let { tool, compact = false }: ToolWidgetProps = $props();
+
+	const model = $derived(presentationsToolCardModel(tool));
+</script>
+
+<ToolCard {tool} {compact} title={model.title || 'Presentation'} icon="lucide:presentation">
+	<ToolCardBody {compact}>
+		{#if model.title}
+			<p class="text-foreground">{model.title}</p>
+		{:else if !tool.error}
+			<p class="text-muted-foreground italic">No presentation title.</p>
+		{/if}
+	</ToolCardBody>
+</ToolCard>

package/dist/svelte/tool-widgets/PresentationsToolCard.svelte.d.ts

@@ -0,0 +1,8 @@
+/**
+     * First-party widget for `presentations`: the requested presentation title.
+     */
+import { type ToolWidgetProps } from '@vibesdotdev/kit/components/tool-widgets';
+declare const PresentationsToolCard: import("svelte").Component<ToolWidgetProps, {}, "">;
+type PresentationsToolCard = ReturnType<typeof PresentationsToolCard>;
+export default PresentationsToolCard;
+//# sourceMappingURL=PresentationsToolCard.svelte.d.ts.map

package/dist/svelte/tool-widgets/PresentationsToolCard.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PresentationsToolCard.svelte.d.ts","sourceRoot":"","sources":["../../../src/svelte/tool-widgets/PresentationsToolCard.svelte.ts"],"names":[],"mappings":"AAGA;;OAEI;AACJ,OAAO,EAGL,KAAK,eAAe,EACpB,MAAM,0CAA0C,CAAC;AAyBnD,QAAA,MAAM,qBAAqB,qDAAwC,CAAC;AACpE,KAAK,qBAAqB,GAAG,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACtE,eAAe,qBAAqB,CAAC"}