@markbrutx/promptbook-viewer 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 markbrutx
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,38 @@
+# @markbrutx/promptbook-viewer
+
+Storybook-for-prompts: a local web app that renders a prompts folder via
+[`@markbrutx/promptbook-core`](https://www.npmjs.com/package/@markbrutx/promptbook-core).
+Part of [promptbook](https://github.com/markbrutx/promptbook).
+
+```
+npm i -D @markbrutx/promptbook-viewer
+```
+
+Usually you don't import this directly — run `promptbook view` from
+[`@markbrutx/promptbook-cli`](https://www.npmjs.com/package/@markbrutx/promptbook-cli),
+which lazily loads it.
+
+## What it shows
+
+- a sidebar tree: Fragments / Compositions → variants
+- the assembled prompt with each fragment colored by source + a legend
+- context pickers (mode, locale, target-model, …) → live re-resolve
+- token count, inline lint warnings, and the explain trace
+- a used-in graph for any fragment ("shared by 10 of 20")
+- a diff between two variants
+- select text → comment → send to the agent inbox queue
+
+## Programmatic use
+
+```ts
+import { startViewer } from "@markbrutx/promptbook-viewer";
+
+const { url, close } = await startViewer({ promptsDir: "./prompts", open: true });
+```
+
+The server is a thin wrapper over `core`; the React UI is built into static
+assets at publish time.
+
+## License
+
+[MIT](./LICENSE)

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export type { AnnotateInput, AnnotationStore } from "./server/annotations.js";
+export { createAnnotationStore } from "./server/annotations.js";
+export type { Viewer, ViewerOptions } from "./server/server.js";
+export { startViewer } from "./server/server.js";
+export type { AnnotateRequest, Annotation, AnnotationsResponse, BookResponse, CompositionSummary, FragmentSummary, LintResponse, ResolveResponse, RuleSummary, Segment, UsedInReference, UsedInResponse, VariantSummary, } from "./shared/types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC9E,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,YAAY,EACV,eAAe,EACf,UAAU,EACV,mBAAmB,EACnB,YAAY,EACZ,kBAAkB,EAClB,eAAe,EACf,YAAY,EACZ,eAAe,EACf,WAAW,EACX,OAAO,EACP,eAAe,EACf,cAAc,EACd,cAAc,GACf,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { createAnnotationStore } from "./server/annotations.js";
+export { startViewer } from "./server/server.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/server/annotations.d.ts

@@ -0,0 +1,30 @@
+import type { Annotation, Context } from "@markbrutx/promptbook-core";
+/** The flat body the viewer posts; the store expands it into an {@link Annotation}. */
+export interface AnnotateInput {
+    /** Composition the variant was assembled from (omit for a fragment target). */
+    prompt?: string;
+    /** Context the variant was resolved under (kept with `prompt`). */
+    context?: Context;
+    fragmentId: string;
+    anchorText: string;
+    comment: string;
+    offset?: number;
+    /** Source file of the fragment, when annotating a fragment directly. */
+    sourceFile?: string;
+}
+/** The append-safe queue under `<promptsDir>/.annotations/inbox.jsonl`. */
+export interface AnnotationStore {
+    /** Append a new open annotation and return it. */
+    append(input: AnnotateInput): Promise<Annotation>;
+    /** Open annotations in queue order (oldest first). */
+    list(): Promise<Annotation[]>;
+    /** Remove one annotation by id; resolves to whether it existed. */
+    remove(id: string): Promise<boolean>;
+}
+/**
+ * File-backed annotation queue. Appends are line-atomic (one JSONL line);
+ * removals rewrite the file. A missing queue simply reads as empty. This is the
+ * viewer's only write surface — `@markbrutx/promptbook-core` stays read-only.
+ */
+export declare function createAnnotationStore(promptsDir: string): AnnotationStore;
+//# sourceMappingURL=annotations.d.ts.map

package/dist/server/annotations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"annotations.d.ts","sourceRoot":"","sources":["../../src/server/annotations.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAsC,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAS1G,uFAAuF;AACvF,MAAM,WAAW,aAAa;IAC5B,+EAA+E;IAC/E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mEAAmE;IACnE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wEAAwE;IACxE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,2EAA2E;AAC3E,MAAM,WAAW,eAAe;IAC9B,kDAAkD;IAClD,MAAM,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAClD,sDAAsD;IACtD,IAAI,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IAC9B,mEAAmE;IACnE,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACtC;AAuBD;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,eAAe,CAiCzE"}

package/dist/server/annotations.js

@@ -0,0 +1,62 @@
+import { randomUUID } from "node:crypto";
+import { appendFile, mkdir, readFile, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { ANNOTATION_QUEUE_DIR, ANNOTATION_QUEUE_FILE, parseInbox, serializeAnnotationLine, serializeInbox, } from "@markbrutx/promptbook-core";
+/** Expand the posted body into a full annotation (id + timestamp added here). */
+function buildAnnotation(input) {
+    const target = input.prompt !== undefined
+        ? { prompt: input.prompt, context: input.context ?? {} }
+        : { fragmentId: input.fragmentId, ...(input.sourceFile ? { sourceFile: input.sourceFile } : {}) };
+    const anchor = {
+        fragmentId: input.fragmentId,
+        anchorText: input.anchorText,
+        ...(input.offset !== undefined ? { offset: input.offset } : {}),
+    };
+    return {
+        id: randomUUID(),
+        createdAt: new Date().toISOString(),
+        target,
+        anchor,
+        comment: input.comment,
+        status: "open",
+    };
+}
+/**
+ * File-backed annotation queue. Appends are line-atomic (one JSONL line);
+ * removals rewrite the file. A missing queue simply reads as empty. This is the
+ * viewer's only write surface — `@markbrutx/promptbook-core` stays read-only.
+ */
+export function createAnnotationStore(promptsDir) {
+    const dir = join(promptsDir, ANNOTATION_QUEUE_DIR);
+    const file = join(dir, ANNOTATION_QUEUE_FILE);
+    const readAll = async () => {
+        try {
+            return parseInbox(await readFile(file, "utf8"));
+        }
+        catch {
+            return [];
+        }
+    };
+    return {
+        async append(input) {
+            const annotation = buildAnnotation(input);
+            await mkdir(dir, { recursive: true });
+            await appendFile(file, serializeAnnotationLine(annotation));
+            return annotation;
+        },
+        async list() {
+            return (await readAll()).filter((annotation) => annotation.status === "open");
+        },
+        async remove(id) {
+            const all = await readAll();
+            const next = all.filter((annotation) => annotation.id !== id);
+            if (next.length === all.length) {
+                return false;
+            }
+            // The dir/file already exist (an annotation was present), so no mkdir.
+            await writeFile(file, serializeInbox(next));
+            return true;
+        },
+    };
+}
+//# sourceMappingURL=annotations.js.map

package/dist/server/annotations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"annotations.js","sourceRoot":"","sources":["../../src/server/annotations.ts"],"names":[],"mappings":"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"}

package/dist/server/api.d.ts

@@ -0,0 +1,16 @@
+import type { IncomingMessage, ServerResponse } from "node:http";
+import type { BookSource } from "./book-source.js";
+export interface RequestHandlerOptions {
+    source: BookSource;
+    promptsDir: string;
+    /** Directory of the built web bundle (dist/web). */
+    webRoot: string;
+}
+/** A request handler plus the hook the folder watcher uses to push reloads. */
+export interface RequestHandler {
+    handle(req: IncomingMessage, res: ServerResponse): void;
+    /** Invalidate the cached book and notify connected clients to refetch. */
+    notifyReload(): void;
+}
+export declare function createRequestHandler(options: RequestHandlerOptions): RequestHandler;
+//# sourceMappingURL=api.d.ts.map

package/dist/server/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/server/api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAIjE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AASnD,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,UAAU,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,+EAA+E;AAC/E,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,cAAc,GAAG,IAAI,CAAC;IACxD,0EAA0E;IAC1E,YAAY,IAAI,IAAI,CAAC;CACtB;AAyDD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,qBAAqB,GAAG,cAAc,CAiFnF"}

package/dist/server/api.js

@@ -0,0 +1,134 @@
+import { createAnnotationStore } from "./annotations.js";
+import { buildBookResponse, buildLintResponse, buildResolveResponse, buildUsedInResponse, } from "./responses.js";
+import { serveStatic } from "./static.js";
+function sendJson(res, status, payload) {
+    const body = JSON.stringify(payload);
+    res.writeHead(status, { "content-type": "application/json; charset=utf-8" });
+    res.end(body);
+}
+async function readJsonBody(req) {
+    const chunks = [];
+    for await (const chunk of req) {
+        chunks.push(chunk);
+    }
+    const raw = Buffer.concat(chunks).toString("utf8").trim();
+    if (raw === "") {
+        return {};
+    }
+    return JSON.parse(raw);
+}
+function asResolveRequest(body) {
+    const data = (body ?? {});
+    if (typeof data.prompt !== "string" || data.prompt === "") {
+        throw new Error('request body must include a "prompt" name');
+    }
+    return { prompt: data.prompt, context: data.context ?? {} };
+}
+function asAnnotateRequest(body) {
+    const data = (body ?? {});
+    if (typeof data.fragmentId !== "string" || data.fragmentId === "") {
+        throw new Error('request body must include a "fragmentId"');
+    }
+    if (typeof data.anchorText !== "string" || data.anchorText === "") {
+        throw new Error('request body must include "anchorText"');
+    }
+    if (typeof data.comment !== "string" || data.comment.trim() === "") {
+        throw new Error('request body must include a non-empty "comment"');
+    }
+    const input = {
+        fragmentId: data.fragmentId,
+        anchorText: data.anchorText,
+        comment: data.comment,
+    };
+    if (typeof data.prompt === "string" && data.prompt !== "") {
+        input.prompt = data.prompt;
+        input.context = data.context ?? {};
+    }
+    if (typeof data.offset === "number") {
+        input.offset = data.offset;
+    }
+    if (typeof data.sourceFile === "string") {
+        input.sourceFile = data.sourceFile;
+    }
+    return input;
+}
+export function createRequestHandler(options) {
+    const { source, promptsDir, webRoot } = options;
+    const sseClients = new Set();
+    const annotations = createAnnotationStore(promptsDir);
+    const handle = async (req, res) => {
+        const url = new URL(req.url ?? "/", "http://localhost");
+        const path = url.pathname;
+        const method = req.method ?? "GET";
+        try {
+            if (path === "/api/book" && method === "GET") {
+                sendJson(res, 200, buildBookResponse(await source.get(), promptsDir));
+                return;
+            }
+            if (path === "/api/resolve" && method === "POST") {
+                const { prompt, context } = asResolveRequest(await readJsonBody(req));
+                sendJson(res, 200, buildResolveResponse(await source.get(), prompt, context));
+                return;
+            }
+            if (path === "/api/lint" && method === "POST") {
+                const { prompt, context } = asResolveRequest(await readJsonBody(req));
+                sendJson(res, 200, buildLintResponse(await source.get(), prompt, context));
+                return;
+            }
+            if (path.startsWith("/api/used-in/") && method === "GET") {
+                const id = decodeURIComponent(path.slice("/api/used-in/".length));
+                sendJson(res, 200, buildUsedInResponse(await source.get(), id));
+                return;
+            }
+            if (path === "/api/annotate" && method === "POST") {
+                const annotation = await annotations.append(asAnnotateRequest(await readJsonBody(req)));
+                sendJson(res, 200, annotation);
+                return;
+            }
+            if (path === "/api/annotations" && method === "GET") {
+                sendJson(res, 200, { annotations: await annotations.list() });
+                return;
+            }
+            if (path.startsWith("/api/annotations/") && method === "DELETE") {
+                const id = decodeURIComponent(path.slice("/api/annotations/".length));
+                const removed = await annotations.remove(id);
+                sendJson(res, removed ? 200 : 404, { id, removed });
+                return;
+            }
+            if (path === "/api/events" && method === "GET") {
+                addSseClient(res);
+                return;
+            }
+            if (path.startsWith("/api/")) {
+                sendJson(res, 404, { error: `unknown route ${method} ${path}` });
+                return;
+            }
+            await serveStatic(res, webRoot, path);
+        }
+        catch (error) {
+            sendJson(res, 400, { error: error.message });
+        }
+    };
+    function addSseClient(res) {
+        res.writeHead(200, {
+            "content-type": "text/event-stream",
+            "cache-control": "no-cache",
+            connection: "keep-alive",
+        });
+        res.write(": connected\n\n");
+        sseClients.add(res);
+        res.on("close", () => sseClients.delete(res));
+    }
+    return {
+        handle(req, res) {
+            void handle(req, res);
+        },
+        notifyReload() {
+            source.invalidate();
+            for (const client of sseClients) {
+                client.write("event: reload\ndata: {}\n\n");
+            }
+        },
+    };
+}
+//# sourceMappingURL=api.js.map

package/dist/server/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../src/server/api.ts"],"names":[],"mappings":"AAGA,OAAO,EAAsB,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAE7E,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAgB1C,SAAS,QAAQ,CAAC,GAAmB,EAAE,MAAc,EAAE,OAAgB;IACrE,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACrC,GAAG,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,cAAc,EAAE,iCAAiC,EAAE,CAAC,CAAC;IAC7E,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,GAAoB;IAC9C,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,EAAE,CAAC;QAC9B,MAAM,CAAC,IAAI,CAAC,KAAe,CAAC,CAAC;IAC/B,CAAC;IACD,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;IAC1D,IAAI,GAAG,KAAK,EAAE,EAAE,CAAC;QACf,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAa;IACrC,MAAM,IAAI,GAAG,CAAC,IAAI,IAAI,EAAE,CAA4B,CAAC;IACrD,IAAI,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;QAC1D,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC/D,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC;AAC9D,CAAC;AAED,SAAS,iBAAiB,CAAC,IAAa;IACtC,MAAM,IAAI,GAAG,CAAC,IAAI,IAAI,EAAE,CAA6B,CAAC;IACtD,IAAI,OAAO,IAAI,CAAC,UAAU,KAAK,QAAQ,IAAI,IAAI,CAAC,UAAU,KAAK,EAAE,EAAE,CAAC;QAClE,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAC9D,CAAC;IACD,IAAI,OAAO,IAAI,CAAC,UAAU,KAAK,QAAQ,IAAI,IAAI,CAAC,UAAU,KAAK,EAAE,EAAE,CAAC;QAClE,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;IAC5D,CAAC;IACD,IAAI,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACnE,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;IACrE,CAAC;IACD,MAAM,KAAK,GAAkB;QAC3B,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,OAAO,EAAE,IAAI,CAAC,OAAO;KACtB,CAAC;IACF,IAAI,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;QAC1D,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC3B,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC;IACrC,CAAC;IACD,IAAI,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QACpC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IAC7B,CAAC;IACD,IAAI,OAAO,IAAI,CAAC,UAAU,KAAK,QAAQ,EAAE,CAAC;QACxC,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;IACrC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,OAA8B;IACjE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;IAChD,MAAM,UAAU,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC7C,MAAM,WAAW,GAAG,qBAAqB,CAAC,UAAU,CAAC,CAAC;IAEtD,MAAM,MAAM,GAAG,KAAK,EAAE,GAAoB,EAAE,GAAmB,EAAiB,EAAE;QAChF,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,GAAG,EAAE,kBAAkB,CAAC,CAAC;QACxD,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ,CAAC;QAC1B,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,IAAI,KAAK,CAAC;QAEnC,IAAI,CAAC;YACH,IAAI,IAAI,KAAK,WAAW,IAAI,MAAM,KAAK,KAAK,EAAE,CAAC;gBAC7C,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,iBAAiB,CAAC,MAAM,MAAM,CAAC,GAAG,EAAE,EAAE,UAAU,CAAC,CAAC,CAAC;gBACtE,OAAO;YACT,CAAC;YACD,IAAI,IAAI,KAAK,cAAc,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;gBACjD,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,gBAAgB,CAAC,MAAM,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC;gBACtE,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,oBAAoB,CAAC,MAAM,MAAM,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;gBAC9E,OAAO;YACT,CAAC;YACD,IAAI,IAAI,KAAK,WAAW,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;gBAC9C,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,gBAAgB,CAAC,MAAM,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC;gBACtE,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,iBAAiB,CAAC,MAAM,MAAM,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;gBAC3E,OAAO;YACT,CAAC;YACD,IAAI,IAAI,CAAC,UAAU,CAAC,eAAe,CAAC,IAAI,MAAM,KAAK,KAAK,EAAE,CAAC;gBACzD,MAAM,EAAE,GAAG,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC;gBAClE,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,mBAAmB,CAAC,MAAM,MAAM,CAAC,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;gBAChE,OAAO;YACT,CAAC;YACD,IAAI,IAAI,KAAK,eAAe,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;gBAClD,MAAM,UAAU,GAAG,MAAM,WAAW,CAAC,MAAM,CAAC,iBAAiB,CAAC,MAAM,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;gBACxF,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC;gBAC/B,OAAO;YACT,CAAC;YACD,IAAI,IAAI,KAAK,kBAAkB,IAAI,MAAM,KAAK,KAAK,EAAE,CAAC;gBACpD,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;gBAC9D,OAAO;YACT,CAAC;YACD,IAAI,IAAI,CAAC,UAAU,CAAC,mBAAmB,CAAC,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;gBAChE,MAAM,EAAE,GAAG,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC,CAAC;gBACtE,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;gBAC7C,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;gBACpD,OAAO;YACT,CAAC;YACD,IAAI,IAAI,KAAK,aAAa,IAAI,MAAM,KAAK,KAAK,EAAE,CAAC;gBAC/C,YAAY,CAAC,GAAG,CAAC,CAAC;gBAClB,OAAO;YACT,CAAC;YACD,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC7B,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,iBAAiB,MAAM,IAAI,IAAI,EAAE,EAAE,CAAC,CAAC;gBACjE,OAAO;YACT,CAAC;YACD,MAAM,WAAW,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;QACxC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,KAAK,EAAG,KAAe,CAAC,OAAO,EAAE,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC,CAAC;IAEF,SAAS,YAAY,CAAC,GAAmB;QACvC,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE;YACjB,cAAc,EAAE,mBAAmB;YACnC,eAAe,EAAE,UAAU;YAC3B,UAAU,EAAE,YAAY;SACzB,CAAC,CAAC;QACH,GAAG,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;QAC7B,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACpB,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IAChD,CAAC;IAED,OAAO;QACL,MAAM,CAAC,GAAG,EAAE,GAAG;YACb,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QACxB,CAAC;QACD,YAAY;YACV,MAAM,CAAC,UAAU,EAAE,CAAC;YACpB,KAAK,MAAM,MAAM,IAAI,UAAU,EAAE,CAAC;gBAChC,MAAM,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC;YAC9C,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/server/book-source.d.ts

@@ -0,0 +1,20 @@
+import type { Fixture, FsAdapter, PromptBook } from "@markbrutx/promptbook-core";
+/** A loaded prompts folder plus the fixtures that supply named variants. */
+export interface LoadedFolder {
+    book: PromptBook;
+    fixtures: Fixture[];
+}
+/**
+ * Caches the loaded folder and reloads lazily after {@link invalidate}. The
+ * server wires a folder watcher to `invalidate` for hot-reload; tests can call
+ * it directly. Reads are serialized so a burst of requests during a reload
+ * shares one load.
+ */
+export interface BookSource {
+    /** Current folder contents, reloading first if it was invalidated. */
+    get(): Promise<LoadedFolder>;
+    /** Mark the cache stale; the next {@link get} reloads from disk. */
+    invalidate(): void;
+}
+export declare function createBookSource(promptsDir: string, fs?: FsAdapter): BookSource;
+//# sourceMappingURL=book-source.d.ts.map

package/dist/server/book-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"book-source.d.ts","sourceRoot":"","sources":["../../src/server/book-source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAGjF,4EAA4E;AAC5E,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,OAAO,EAAE,CAAC;CACrB;AAED;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB,sEAAsE;IACtE,GAAG,IAAI,OAAO,CAAC,YAAY,CAAC,CAAC;IAC7B,oEAAoE;IACpE,UAAU,IAAI,IAAI,CAAC;CACpB;AAWD,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,SAAS,GAAG,UAAU,CAsB/E"}

package/dist/server/book-source.js

@@ -0,0 +1,32 @@
+import { loadFixtures, loadPrompts } from "@markbrutx/promptbook-core";
+/** Fixtures are optional: a folder without a `fixtures/` dir simply has none. */
+async function safeLoadFixtures(promptsDir, fs) {
+    try {
+        return await loadFixtures(promptsDir, fs);
+    }
+    catch {
+        return [];
+    }
+}
+export function createBookSource(promptsDir, fs) {
+    let cached;
+    const load = async () => {
+        const [book, fixtures] = await Promise.all([
+            loadPrompts(promptsDir, fs),
+            safeLoadFixtures(promptsDir, fs),
+        ]);
+        return { book, fixtures };
+    };
+    return {
+        get() {
+            if (cached === undefined) {
+                cached = load();
+            }
+            return cached;
+        },
+        invalidate() {
+            cached = undefined;
+        },
+    };
+}
+//# sourceMappingURL=book-source.js.map

package/dist/server/book-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"book-source.js","sourceRoot":"","sources":["../../src/server/book-source.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAqBvE,iFAAiF;AACjF,KAAK,UAAU,gBAAgB,CAAC,UAAkB,EAAE,EAAc;IAChE,IAAI,CAAC;QACH,OAAO,MAAM,YAAY,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,UAAkB,EAAE,EAAc;IACjE,IAAI,MAAyC,CAAC;IAE9C,MAAM,IAAI,GAAG,KAAK,IAA2B,EAAE;QAC7C,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YACzC,WAAW,CAAC,UAAU,EAAE,EAAE,CAAC;YAC3B,gBAAgB,CAAC,UAAU,EAAE,EAAE,CAAC;SACjC,CAAC,CAAC;QACH,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IAC5B,CAAC,CAAC;IAEF,OAAO;QACL,GAAG;YACD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBACzB,MAAM,GAAG,IAAI,EAAE,CAAC;YAClB,CAAC;YACD,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,UAAU;YACR,MAAM,GAAG,SAAS,CAAC;QACrB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/server/responses.d.ts

@@ -0,0 +1,12 @@
+import type { Context } from "@markbrutx/promptbook-core";
+import type { BookResponse, LintResponse, ResolveResponse, UsedInResponse } from "../shared/types.js";
+import type { LoadedFolder } from "./book-source.js";
+/** Build the `GET /api/book` payload: compositions + fragments + warnings. */
+export declare function buildBookResponse(folder: LoadedFolder, promptsDir: string): BookResponse;
+/** Resolve a variant and attach the colored segments. Throws on unknown prompt. */
+export declare function buildResolveResponse(folder: LoadedFolder, prompt: string, context: Context): ResolveResponse;
+/** Lint a resolved variant and estimate its token count. Throws on unknown prompt. */
+export declare function buildLintResponse(folder: LoadedFolder, prompt: string, context: Context): LintResponse;
+/** List the compositions/rules that reference a fragment id. */
+export declare function buildUsedInResponse(folder: LoadedFolder, fragmentId: string): UsedInResponse;
+//# sourceMappingURL=responses.d.ts.map

package/dist/server/responses.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"responses.d.ts","sourceRoot":"","sources":["../../src/server/responses.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAA2B,OAAO,EAAQ,MAAM,4BAA4B,CAAC;AAEzF,OAAO,KAAK,EACV,YAAY,EAGZ,YAAY,EACZ,eAAe,EAEf,cAAc,EAEf,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAkErD,8EAA8E;AAC9E,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,GAAG,YAAY,CAmBxF;AAED,mFAAmF;AACnF,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,OAAO,GACf,eAAe,CAGjB;AAED,sFAAsF;AACtF,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,YAAY,CAStG;AAED,gEAAgE;AAChE,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,GAAG,cAAc,CAE5F"}

package/dist/server/responses.js

@@ -0,0 +1,106 @@
+import { relative, sep } from "node:path";
+import { estimateTokensByChars, lint, resolveBook } from "@markbrutx/promptbook-core";
+import { deriveSegments } from "./segments.js";
+import { usedIn } from "./used-in.js";
+/** Path relative to the prompts folder, normalized to forward slashes. */
+function relativeSource(promptsDir, sourceFile) {
+    const rel = relative(promptsDir, sourceFile);
+    return (rel === "" ? sourceFile : rel).split(sep).join("/");
+}
+/** Drop undefined action fields so the wire shape stays minimal. */
+function summarizeRule(rule) {
+    const summary = { index: rule.index, when: rule.when, action: rule.action };
+    if (rule.add !== undefined)
+        summary.add = rule.add;
+    if (rule.after !== undefined)
+        summary.after = rule.after;
+    if (rule.replace !== undefined)
+        summary.replace = rule.replace;
+    if (rule.forbid !== undefined)
+        summary.forbid = rule.forbid;
+    if (rule.order !== undefined)
+        summary.order = rule.order;
+    return summary;
+}
+/** Group fixtures by the composition they target, for variant lookup. */
+function variantsByPrompt(folder) {
+    const byPrompt = new Map();
+    for (const fixture of folder.fixtures) {
+        const list = byPrompt.get(fixture.prompt) ?? [];
+        list.push({ name: fixture.name, context: fixture.context ?? {} });
+        byPrompt.set(fixture.prompt, list);
+    }
+    for (const list of byPrompt.values()) {
+        list.sort((a, b) => a.name.localeCompare(b.name));
+    }
+    return byPrompt;
+}
+/** Project a code-prompt to the wire shape, relativizing its manifest path. */
+function summarizeCodePrompt(promptsDir, codePrompt) {
+    const summary = {
+        name: codePrompt.name,
+        samples: codePrompt.samples.map((s) => ({
+            label: s.label,
+            ...(s.context !== undefined ? { context: s.context } : {}),
+            output: s.output,
+        })),
+        sourceFile: relativeSource(promptsDir, codePrompt.sourceFile),
+    };
+    if (codePrompt.description !== undefined)
+        summary.description = codePrompt.description;
+    return summary;
+}
+function summarizeComposition(variants, promptsDir, c) {
+    const summary = {
+        name: c.name,
+        base: c.base,
+        rules: c.rules.map(summarizeRule),
+        sourceFile: relativeSource(promptsDir, c.sourceFile),
+        variants,
+    };
+    if (c.order !== undefined)
+        summary.order = c.order;
+    return summary;
+}
+/** Build the `GET /api/book` payload: compositions + fragments + warnings. */
+export function buildBookResponse(folder, promptsDir) {
+    const { book } = folder;
+    const variants = variantsByPrompt(folder);
+    const compositions = [...book.compositions.values()]
+        .sort((a, b) => a.name.localeCompare(b.name))
+        .map((c) => summarizeComposition(variants.get(c.name) ?? [], promptsDir, c));
+    const codePrompts = [...book.codePrompts.values()]
+        .sort((a, b) => a.name.localeCompare(b.name))
+        .map((c) => summarizeCodePrompt(promptsDir, c));
+    const fragments = [...book.fragments.values()]
+        .sort((a, b) => a.id.localeCompare(b.id))
+        .map((f) => ({
+        id: f.id,
+        ...(f.kind !== undefined ? { kind: f.kind } : {}),
+        tags: f.tags ?? [],
+        body: f.body,
+        sourceFile: relativeSource(promptsDir, f.sourceFile),
+    }));
+    return { compositions, codePrompts, fragments, warnings: book.warnings };
+}
+/** Resolve a variant and attach the colored segments. Throws on unknown prompt. */
+export function buildResolveResponse(folder, prompt, context) {
+    const { text, trace } = resolveBook(folder.book, prompt, context);
+    return { text, trace, segments: deriveSegments(folder.book, trace.finalOrder, context) };
+}
+/** Lint a resolved variant and estimate its token count. Throws on unknown prompt. */
+export function buildLintResponse(folder, prompt, context) {
+    const result = resolveBook(folder.book, prompt, context);
+    const report = lint({ book: folder.book, result });
+    return {
+        findings: report.findings,
+        errorCount: report.errorCount,
+        warningCount: report.warningCount,
+        tokens: estimateTokensByChars(result.text),
+    };
+}
+/** List the compositions/rules that reference a fragment id. */
+export function buildUsedInResponse(folder, fragmentId) {
+    return { fragmentId, references: usedIn(folder.book, fragmentId) };
+}
+//# sourceMappingURL=responses.js.map

package/dist/server/responses.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"responses.js","sourceRoot":"","sources":["../../src/server/responses.ts"],"names":[],"mappings":"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"}

package/dist/server/segments.d.ts

@@ -0,0 +1,12 @@
+import type { Context, PromptBook } from "@markbrutx/promptbook-core";
+import type { Segment } from "../shared/types.js";
+/**
+ * Re-derive the per-fragment slices of an assembled prompt for coloring.
+ *
+ * `resolveBook` joins the interpolated bodies of `trace.finalOrder` with
+ * `"\n\n"`. Running the same interpolation over the same ids reproduces those
+ * parts exactly, so `segments.map(s => s.text).join("\n\n")` is byte-identical
+ * to the resolved `text`. This is asserted in the tests.
+ */
+export declare function deriveSegments(book: PromptBook, finalOrder: string[], context: Context): Segment[];
+//# sourceMappingURL=segments.d.ts.map

package/dist/server/segments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"segments.d.ts","sourceRoot":"","sources":["../../src/server/segments.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAEtE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAElD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,EAAE,CAalG"}

package/dist/server/segments.js

@@ -0,0 +1,24 @@
+import { interpolate } from "@markbrutx/promptbook-core";
+/**
+ * Re-derive the per-fragment slices of an assembled prompt for coloring.
+ *
+ * `resolveBook` joins the interpolated bodies of `trace.finalOrder` with
+ * `"\n\n"`. Running the same interpolation over the same ids reproduces those
+ * parts exactly, so `segments.map(s => s.text).join("\n\n")` is byte-identical
+ * to the resolved `text`. This is asserted in the tests.
+ */
+export function deriveSegments(book, finalOrder, context) {
+    const segments = [];
+    for (const fragmentId of finalOrder) {
+        const fragment = book.fragments.get(fragmentId);
+        if (fragment === undefined) {
+            continue;
+        }
+        segments.push({
+            fragmentId,
+            text: interpolate(fragment.body, context, () => { }),
+        });
+    }
+    return segments;
+}
+//# sourceMappingURL=segments.js.map

package/dist/server/segments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"segments.js","sourceRoot":"","sources":["../../src/server/segments.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAGzD;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAAC,IAAgB,EAAE,UAAoB,EAAE,OAAgB;IACrF,MAAM,QAAQ,GAAc,EAAE,CAAC;IAC/B,KAAK,MAAM,UAAU,IAAI,UAAU,EAAE,CAAC;QACpC,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAChD,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,SAAS;QACX,CAAC;QACD,QAAQ,CAAC,IAAI,CAAC;YACZ,UAAU;YACV,IAAI,EAAE,WAAW,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC,CAAC;SACpD,CAAC,CAAC;IACL,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/server/server.d.ts

@@ -0,0 +1,24 @@
+import type { FsAdapter } from "@markbrutx/promptbook-core";
+export interface ViewerOptions {
+    /** Folder containing `fragments/`, `rules/` and optional `fixtures/`. */
+    promptsDir: string;
+    /** Port to listen on; 0 (default) picks a free port. */
+    port?: number;
+    /** Open the URL in the default browser once listening. Default false. */
+    open?: boolean;
+    /** Filesystem adapter forwarded to the core loader (defaults to Node fs). */
+    fs?: FsAdapter;
+}
+/** A running viewer: its URL, the bound port, and a shutdown hook. */
+export interface Viewer {
+    url: string;
+    port: number;
+    close(): Promise<void>;
+}
+/**
+ * Start the viewer server: serves the built web bundle and the `/api/*` routes
+ * over a prompts folder, hot-reloading on folder edits. Render-only; no model
+ * calls. Resolves once the server is listening.
+ */
+export declare function startViewer(options: ViewerOptions): Promise<Viewer>;
+//# sourceMappingURL=server.d.ts.map

package/dist/server/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/server/server.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAI5D,MAAM,WAAW,aAAa;IAC5B,yEAAyE;IACzE,UAAU,EAAE,MAAM,CAAC;IACnB,wDAAwD;IACxD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yEAAyE;IACzE,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,6EAA6E;IAC7E,EAAE,CAAC,EAAE,SAAS,CAAC;CAChB;AAED,sEAAsE;AACtE,MAAM,WAAW,MAAM;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAoCD;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CA8BzE"}