@brett_lamy/docstream 1.2.4 → 1.4.0

package/dist/video/VideoEmbed.d.ts

@@ -0,0 +1,17 @@
+import type { CSSProperties } from "react";
+export interface VideoEmbedProps {
+    /** A direct media asset or a public player URL. */
+    src: string;
+    title?: string;
+    className?: string;
+    /** CSS aspect-ratio for iframe embeds. Defaults to 16 / 9. */
+    aspectRatio?: CSSProperties["aspectRatio"];
+    controls?: boolean;
+    autoplay?: boolean;
+    loop?: boolean;
+    muted?: boolean;
+    poster?: string;
+    allowFullScreen?: boolean;
+}
+export declare function VideoEmbed({ src, title, className, aspectRatio, controls, autoplay, loop, muted, poster, allowFullScreen, }: VideoEmbedProps): import("react").JSX.Element;
+//# sourceMappingURL=VideoEmbed.d.ts.map

package/dist/video/VideoEmbed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VideoEmbed.d.ts","sourceRoot":"","sources":["../../src/video/VideoEmbed.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAA;AAE1C,MAAM,WAAW,eAAe;IAC9B,mDAAmD;IACnD,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,8DAA8D;IAC9D,WAAW,CAAC,EAAE,aAAa,CAAC,aAAa,CAAC,CAAA;IAC1C,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,eAAe,CAAC,EAAE,OAAO,CAAA;CAC1B;AAMD,wBAAgB,UAAU,CAAC,EACzB,GAAG,EACH,KAAe,EACf,SAAS,EACT,WAAsB,EACtB,QAAe,EACf,QAAgB,EAChB,IAAY,EACZ,KAAa,EACb,MAAM,EACN,eAAsB,GACvB,EAAE,eAAe,+BA6BjB"}

package/dist/video/VideoEmbed.js

@@ -0,0 +1,12 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+function isDirectVideo(src) {
+    return /\.(?:mp4|webm|ogg)(?:[?#]|$)/i.test(src);
+}
+export function VideoEmbed({ src, title = "Video", className, aspectRatio = "16 / 9", controls = true, autoplay = false, loop = false, muted = false, poster, allowFullScreen = true, }) {
+    const mediaClass = `video-embed__media ${className ?? ""}`.trim();
+    if (isDirectVideo(src)) {
+        return (_jsx("video", { className: mediaClass, src: src, title: title, controls: controls, autoPlay: autoplay, loop: loop, muted: muted, poster: poster, playsInline: true }));
+    }
+    return (_jsx("iframe", { className: mediaClass, src: src, title: title, loading: "lazy", allow: "autoplay; fullscreen", allowFullScreen: allowFullScreen, style: { aspectRatio }, referrerPolicy: "strict-origin-when-cross-origin" }));
+}
+//# sourceMappingURL=VideoEmbed.js.map

package/dist/video/VideoEmbed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"VideoEmbed.js","sourceRoot":"","sources":["../../src/video/VideoEmbed.tsx"],"names":[],"mappings":";AAiBA,SAAS,aAAa,CAAC,GAAW;IAChC,OAAO,+BAA+B,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AAClD,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,EACzB,GAAG,EACH,KAAK,GAAG,OAAO,EACf,SAAS,EACT,WAAW,GAAG,QAAQ,EACtB,QAAQ,GAAG,IAAI,EACf,QAAQ,GAAG,KAAK,EAChB,IAAI,GAAG,KAAK,EACZ,KAAK,GAAG,KAAK,EACb,MAAM,EACN,eAAe,GAAG,IAAI,GACN;IAChB,MAAM,UAAU,GAAG,sBAAsB,SAAS,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,CAAA;IACjE,IAAI,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,CACL,gBACE,SAAS,EAAE,UAAU,EACrB,GAAG,EAAE,GAAG,EACR,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,QAAQ,EAClB,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,MAAM,EACd,WAAW,SACX,CACH,CAAA;IACH,CAAC;IACD,OAAO,CACL,iBACE,SAAS,EAAE,UAAU,EACrB,GAAG,EAAE,GAAG,EACR,KAAK,EAAE,KAAK,EACZ,OAAO,EAAC,MAAM,EACd,KAAK,EAAC,sBAAsB,EAC5B,eAAe,EAAE,eAAe,EAChC,KAAK,EAAE,EAAE,WAAW,EAAE,EACtB,cAAc,EAAC,iCAAiC,GAChD,CACH,CAAA;AACH,CAAC"}

package/dist/video/index.d.ts

@@ -0,0 +1,3 @@
+export { VideoEmbed } from "./VideoEmbed.js";
+export type { VideoEmbedProps } from "./VideoEmbed.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/video/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AACzC,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA"}

package/dist/video/index.js

@@ -0,0 +1,2 @@
+export { VideoEmbed } from "./VideoEmbed.js";
+//# sourceMappingURL=index.js.map

package/dist/video/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/video/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA"}

package/dist/vite/index.d.ts

@@ -0,0 +1,21 @@
+import type { Plugin } from "vite";
+export interface DocstreamSourceMount {
+    /** Stable name used by Markdown source references. */
+    name: string;
+    /** Real source directory. Relative paths are resolved from the Vite root. */
+    root: string;
+    /** Allow PUT requests to edit files in this mount. Defaults to true. */
+    writable?: boolean;
+}
+export interface DocstreamSourcesOptions {
+    mounts: readonly DocstreamSourceMount[];
+    /** HTTP endpoint prefix. Defaults to `/@docstream`. */
+    apiBase?: string;
+}
+/**
+ * Mount real source directories behind safe Vite dev-server endpoints.
+ * Markdown references import live modules from these files, and editor writes
+ * go back to disk so Vite's normal watcher/HMR pipeline remains authoritative.
+ */
+export declare function docstreamSources(options: DocstreamSourcesOptions): Plugin;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/vite/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAiB,MAAM,MAAM,CAAA;AAEjD,MAAM,WAAW,oBAAoB;IACnC,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAA;IACZ,6EAA6E;IAC7E,IAAI,EAAE,MAAM,CAAA;IACZ,wEAAwE;IACxE,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,SAAS,oBAAoB,EAAE,CAAA;IACvC,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AA6GD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,MAAM,CAgCzE"}

package/dist/vite/index.js

@@ -0,0 +1,137 @@
+import { promises as fs } from "node:fs";
+import path from "node:path";
+const VIRTUAL_ID = "virtual:docstream-sources";
+const RESOLVED_VIRTUAL_ID = "\0virtual:docstream-sources";
+function send(response, status, body, type = "application/json; charset=utf-8") {
+    response.statusCode = status;
+    response.setHeader("content-type", type);
+    response.setHeader("cache-control", "no-store");
+    response.end(body);
+}
+function requestUrl(request) {
+    return new URL(request.url ?? "/", "http://docstream.local");
+}
+async function requestBody(request) {
+    const chunks = [];
+    for await (const chunk of request)
+        chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+    return Buffer.concat(chunks).toString("utf8");
+}
+function normalizeRelativePath(value) {
+    const source = value.replaceAll("\\", "/").replace(/^\.\//, "");
+    if (!source || source.startsWith("/") || source.split("/").some((part) => part === ".." || part === "")) {
+        throw new Error(`Invalid mounted source path: ${value}`);
+    }
+    return source;
+}
+function sourcePath(mount, requestedPath) {
+    const relativePath = normalizeRelativePath(requestedPath);
+    const absolutePath = path.resolve(mount.root, relativePath);
+    const prefix = mount.root.endsWith(path.sep) ? mount.root : `${mount.root}${path.sep}`;
+    if (!absolutePath.startsWith(prefix))
+        throw new Error(`Source path escapes mount ${mount.name}: ${requestedPath}`);
+    return { relativePath, absolutePath };
+}
+function provenance(url, mount, relativePath, absolutePath, mtimeMs) {
+    return {
+        mount: mount.name,
+        path: relativePath,
+        exportName: url.searchParams.get("export") || "default",
+        kind: url.searchParams.get("kind") === "story" ? "story" : "component",
+        absolutePath,
+        mtimeMs,
+    };
+}
+function findMount(url, mounts) {
+    const name = url.searchParams.get("mount") ?? "";
+    const mount = mounts.find((candidate) => candidate.name === name);
+    if (!mount)
+        throw new Error(`Unknown Docstream source mount: ${name}`);
+    return mount;
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+function installMiddleware(server, apiBase, viteBase, mounts) {
+    server.middlewares.use(async (request, response, next) => {
+        const url = requestUrl(request);
+        if (url.pathname !== `${apiBase}/source` && url.pathname !== `${apiBase}/module`)
+            return next();
+        try {
+            const mount = findMount(url, mounts);
+            const requestedPath = url.searchParams.get("path") ?? "";
+            const { relativePath, absolutePath } = sourcePath(mount, requestedPath);
+            if (url.pathname === `${apiBase}/module`) {
+                if (request.method !== "GET")
+                    return send(response, 405, "Method not allowed", "text/plain; charset=utf-8");
+                await fs.access(absolutePath);
+                const sourceUrl = `${viteBase.replace(/\/$/, "")}/@fs/${absolutePath.replaceAll(path.sep, "/")}?docstream=${Date.now()}`;
+                const module = `import * as source from ${JSON.stringify(sourceUrl)};\nexport default source;\n`;
+                return send(response, 200, module, "text/javascript; charset=utf-8");
+            }
+            if (request.method === "GET") {
+                const [content, stat] = await Promise.all([fs.readFile(absolutePath, "utf8"), fs.stat(absolutePath)]);
+                return send(response, 200, JSON.stringify({ content, provenance: provenance(url, mount, relativePath, absolutePath, stat.mtimeMs) }));
+            }
+            if (request.method === "PUT") {
+                if (!mount.writable)
+                    return send(response, 403, `Source mount ${mount.name} is read-only`, "text/plain; charset=utf-8");
+                await fs.access(absolutePath);
+                const parsed = JSON.parse(await requestBody(request));
+                if (typeof parsed.content !== "string")
+                    return send(response, 400, "Expected a JSON string field named content", "text/plain; charset=utf-8");
+                await fs.writeFile(absolutePath, parsed.content, "utf8");
+                const stat = await fs.stat(absolutePath);
+                server.watcher.add(absolutePath);
+                server.ws.send({ type: "full-reload", path: "*" });
+                return send(response, 200, JSON.stringify({ content: parsed.content, provenance: provenance(url, mount, relativePath, absolutePath, stat.mtimeMs) }));
+            }
+            return send(response, 405, "Method not allowed", "text/plain; charset=utf-8");
+        }
+        catch (error) {
+            const status = error && typeof error === "object" && "code" in error && error.code === "ENOENT" ? 404 : 400;
+            return send(response, status, errorMessage(error), "text/plain; charset=utf-8");
+        }
+    });
+}
+/**
+ * Mount real source directories behind safe Vite dev-server endpoints.
+ * Markdown references import live modules from these files, and editor writes
+ * go back to disk so Vite's normal watcher/HMR pipeline remains authoritative.
+ */
+export function docstreamSources(options) {
+    const apiBase = `/${(options.apiBase ?? "/@docstream").replace(/^\/+|\/+$/g, "")}`;
+    let mounts = [];
+    let viteBase = "/";
+    return {
+        name: "docstream-sources",
+        enforce: "pre",
+        configResolved(config) {
+            viteBase = config.base || "/";
+            const names = new Set();
+            mounts = options.mounts.map((mount) => {
+                if (!mount.name || names.has(mount.name))
+                    throw new Error(`Docstream source mount names must be unique: ${mount.name}`);
+                names.add(mount.name);
+                return {
+                    name: mount.name,
+                    root: path.resolve(config.root, mount.root),
+                    writable: mount.writable !== false,
+                };
+            });
+        },
+        configureServer(server) {
+            installMiddleware(server, apiBase, viteBase, mounts);
+        },
+        resolveId(id) {
+            if (id === VIRTUAL_ID)
+                return RESOLVED_VIRTUAL_ID;
+        },
+        load(id) {
+            if (id !== RESOLVED_VIRTUAL_ID)
+                return;
+            return `export const apiBase = ${JSON.stringify(apiBase)};\nexport const mounts = ${JSON.stringify(options.mounts.map(({ name, writable = true }) => ({ name, writable })))};\n`;
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/vite/index.js.map

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

package/dist/viz/VizEmbed.d.ts

@@ -0,0 +1,18 @@
+import type { PlayerAudio, VideoScene } from "@brett_lamy/viz-engine";
+export interface VizEmbedProps {
+    scene: VideoScene;
+    audio?: PlayerAudio;
+    title?: string;
+    className?: string;
+    autoplay?: boolean;
+    loop?: boolean;
+    showCaptions?: boolean;
+}
+/**
+ * Mount a deterministic VizEngine scene inside a Docstream document. This is
+ * intentionally a component API rather than a markdown escape hatch: callers
+ * choose the scene and its evidence, while Docstream supplies document chrome
+ * and accessible figure semantics.
+ */
+export declare function VizEmbed({ scene, audio, title, className, autoplay, loop, showCaptions, }: VizEmbedProps): import("react").JSX.Element;
+//# sourceMappingURL=VizEmbed.d.ts.map

package/dist/viz/VizEmbed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VizEmbed.d.ts","sourceRoot":"","sources":["../../src/viz/VizEmbed.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AAGrE,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,UAAU,CAAA;IACjB,KAAK,CAAC,EAAE,WAAW,CAAA;IACnB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,YAAY,CAAC,EAAE,OAAO,CAAA;CACvB;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,EACvB,KAAK,EACL,KAAK,EACL,KAAK,EACL,SAAS,EACT,QAAe,EACf,IAAW,EACX,YAAoB,GACrB,EAAE,aAAa,+BAcf"}

package/dist/viz/VizEmbed.js

@@ -0,0 +1,12 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { VizPlayer } from "@brett_lamy/viz-engine";
+/**
+ * Mount a deterministic VizEngine scene inside a Docstream document. This is
+ * intentionally a component API rather than a markdown escape hatch: callers
+ * choose the scene and its evidence, while Docstream supplies document chrome
+ * and accessible figure semantics.
+ */
+export function VizEmbed({ scene, audio, title, className, autoplay = true, loop = true, showCaptions = false, }) {
+    return (_jsxs("figure", { className: `docstream-viz ${className ?? ""}`.trim(), children: [_jsx(VizPlayer, { scene: scene, ...(audio === undefined ? {} : { audio }), autoplay: autoplay, loop: loop, showCaptions: showCaptions, className: "docstream-viz__player" }), title && _jsx("figcaption", { children: title })] }));
+}
+//# sourceMappingURL=VizEmbed.js.map

package/dist/viz/VizEmbed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"VizEmbed.js","sourceRoot":"","sources":["../../src/viz/VizEmbed.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAA;AAYlD;;;;;GAKG;AACH,MAAM,UAAU,QAAQ,CAAC,EACvB,KAAK,EACL,KAAK,EACL,KAAK,EACL,SAAS,EACT,QAAQ,GAAG,IAAI,EACf,IAAI,GAAG,IAAI,EACX,YAAY,GAAG,KAAK,GACN;IACd,OAAO,CACL,kBAAQ,SAAS,EAAE,iBAAiB,SAAS,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,aAC1D,KAAC,SAAS,IACR,KAAK,EAAE,KAAK,KACR,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAC1C,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE,IAAI,EACV,YAAY,EAAE,YAAY,EAC1B,SAAS,EAAC,uBAAuB,GACjC,EACD,KAAK,IAAI,+BAAa,KAAK,GAAc,IACnC,CACV,CAAA;AACH,CAAC"}

package/dist/viz/index.d.ts

@@ -0,0 +1,4 @@
+
+export { VizEmbed } from "./VizEmbed.js";
+export type { VizEmbedProps } from "./VizEmbed.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/viz/index.ts"],"names":[],"mappings":"AAAA,OAAO,mCAAmC,CAAA;AAE1C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AACrC,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA"}

package/dist/viz/index.js

@@ -0,0 +1,3 @@
+import "@brett_lamy/viz-engine/styles.css";
+export { VizEmbed } from "./VizEmbed.js";
+//# sourceMappingURL=index.js.map

package/dist/viz/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/viz/index.ts"],"names":[],"mappings":"AAAA,OAAO,mCAAmC,CAAA;AAE1C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA"}

package/package.json

@@ -1,18 +1,21 @@
 {
   "name": "@brett_lamy/docstream",
-  "version": "1.2.4",
+  "version": "1.4.0",
   "description": "GitBook-aware readonly markdown and AI stream renderer.",
   "publishConfig": {
     "access": "public"
   },
   "type": "module",
   "scripts": {
+    "build": "node scripts/build.mjs",
     "typecheck": "tsc -p tsconfig.json --noEmit",
-    "test": "vitest run"
+    "test": "npm run build && vitest run",
+    "prepack": "npm run build"
   },
-  "main": "./src/index.ts",
-  "types": "./src/index.ts",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
   "files": [
+    "dist",
     "src",
     "!src/**/*.test.ts",
     "!src/**/*.test.tsx",
@@ -24,77 +27,108 @@
   ],
   "exports": {
     ".": {
-      "types": "./src/index.ts",
-      "import": "./src/index.ts"
+      "source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
     },
     "./gitbook": {
-      "types": "./src/gitbook/index.ts",
-      "import": "./src/gitbook/index.ts"
+      "source": "./src/gitbook/index.ts",
+      "types": "./dist/gitbook/index.d.ts",
+      "import": "./dist/gitbook/index.js",
+      "default": "./dist/gitbook/index.js"
     },
     "./streamdown": {
-      "types": "./src/streamdown.tsx",
-      "import": "./src/streamdown.tsx"
+      "source": "./src/streamdown.tsx",
+      "types": "./dist/streamdown.d.ts",
+      "import": "./dist/streamdown.js",
+      "default": "./dist/streamdown.js"
     },
     "./reference": {
-      "types": "./src/docs/reference.tsx",
-      "import": "./src/docs/reference.tsx"
+      "source": "./src/docs/reference.tsx",
+      "types": "./dist/docs/reference.d.ts",
+      "import": "./dist/docs/reference.js",
+      "default": "./dist/docs/reference.js"
     },
     "./assets": {
-      "types": "./src/assets.ts",
-      "import": "./src/assets.ts"
+      "source": "./src/assets.ts",
+      "types": "./dist/assets.d.ts",
+      "import": "./dist/assets.js",
+      "default": "./dist/assets.js"
     },
     "./openapi": {
-      "types": "./src/openapi/OpenApiOperation.tsx",
-      "import": "./src/openapi/OpenApiOperation.tsx"
+      "source": "./src/openapi/OpenApiOperation.tsx",
+      "types": "./dist/openapi/OpenApiOperation.d.ts",
+      "import": "./dist/openapi/OpenApiOperation.js",
+      "default": "./dist/openapi/OpenApiOperation.js"
     },
     "./replay": {
-      "types": "./src/replay/index.ts",
-      "import": "./src/replay/index.ts"
+      "source": "./src/replay/index.ts",
+      "types": "./dist/replay/index.d.ts",
+      "import": "./dist/replay/index.js",
+      "default": "./dist/replay/index.js"
     },
     "./video": {
-      "types": "./src/video/index.ts",
-      "import": "./src/video/index.ts"
+      "source": "./src/video/index.ts",
+      "types": "./dist/video/index.d.ts",
+      "import": "./dist/video/index.js",
+      "default": "./dist/video/index.js"
     },
     "./viz": {
-      "types": "./src/viz/index.ts",
-      "import": "./src/viz/index.ts"
+      "source": "./src/viz/index.ts",
+      "types": "./dist/viz/index.d.ts",
+      "import": "./dist/viz/index.js",
+      "default": "./dist/viz/index.js"
     },
     "./playground": {
-      "types": "./src/playground/index.ts",
-      "import": "./src/playground/index.ts"
+      "source": "./src/playground/index.ts",
+      "types": "./dist/playground/index.d.ts",
+      "import": "./dist/playground/index.js",
+      "default": "./dist/playground/index.js"
     },
     "./source": {
-      "types": "./src/source/index.ts",
-      "import": "./src/source/index.ts"
+      "source": "./src/source/index.ts",
+      "types": "./dist/source/index.d.ts",
+      "import": "./dist/source/index.js",
+      "default": "./dist/source/index.js"
     },
     "./demo": {
-      "types": "./src/demo/index.ts",
-      "import": "./src/demo/index.ts"
+      "source": "./src/demo/index.ts",
+      "types": "./dist/demo/index.d.ts",
+      "import": "./dist/demo/index.js",
+      "default": "./dist/demo/index.js"
     },
     "./vite": {
-      "types": "./src/vite/index.ts",
-      "import": "./src/vite/index.ts"
+      "source": "./src/vite/index.ts",
+      "types": "./dist/vite/index.d.ts",
+      "import": "./dist/vite/index.js",
+      "default": "./dist/vite/index.js"
     },
-    "./styles.css": "./src/styles.css"
+    "./styles.css": "./dist/styles.css"
   },
   "dependencies": {
-    "@brett_lamy/viz-engine": ">=0.2.0",
     "framer-motion": "^13.1.1",
     "gpu-lexer": "^0.0.2",
     "katex": "^0.18.5",
     "lucide-react": "^1.17.0",
     "mermaid": "^11.15.0",
     "rrweb": "2.0.0-alpha.20",
-    "streamdown": "^2.5.0",
     "yaml": "^2.9.0"
   },
   "peerDependencies": {
     "@agent-wasm/core": ">=0.4.0",
     "@brett_lamy/viz-engine": ">=0.2.0",
     "react": ">=18",
+    "react-dom": ">=18",
     "vite": ">=5"
   },
   "peerDependenciesMeta": {
+    "@agent-wasm/core": {
+      "optional": true
+    },
+    "@brett_lamy/viz-engine": {
+      "optional": true
+    },
     "vite": {
       "optional": true
     }
@@ -105,10 +139,12 @@
   },
   "devDependencies": {
     "@agent-wasm/core": "^0.4.0",
+    "@brett_lamy/viz-engine": "^0.2.1",
     "@types/node": "^24.0.0",
     "@types/react": "^18.3.3",
     "typescript": "^5.5.4",
     "vite": "^7.0.0",
     "vitest": "^3.2.4"
-  }
+  },
+  "module": "./dist/index.js"
 }

package/src/demo/types.ts

@@ -85,8 +85,8 @@ export interface InlineDemoRuntimeProps {
 /**
  * Renders the Preview of a `{% demo %}` block that carries its files inline and has
  * no resolver behind it. `@brett_lamy/docstream/playground` provides an almost-node
- * implementation (`createAlmostNodeDemoRuntime`), which `PlaygroundStreamdown` (the
- * package root's `GitbookStreamdown`) wires in by default.
+ * implementation (`createAlmostNodeDemoRuntime`), which that entry's `PlaygroundStreamdown`
+ * wires in by default. The package root never loads a runtime on its own.
  */
 export type InlineDemoRuntime = (props: InlineDemoRuntimeProps) => ReactNode
 

package/src/docs/DocsRenderer.tsx

@@ -1,6 +1,5 @@
-import { useContext, useId, useMemo, useState, type ReactNode } from "react"
+import { useContext, useEffect, useId, useMemo, useState, type ReactNode } from "react"
 import { motion, useReducedMotion } from "framer-motion"
-import "katex/dist/katex.min.css"
 import {
   AlertTriangle,
   CheckCircle2,
@@ -24,16 +23,41 @@ import { CopyButton } from "./copy"
 import { PillTabs, rovingKeyDown } from "./controls"
 import { DocPageActions, type DocPageActionsOptions } from "./PageActions"
 import { useSyncedTab } from "./tabs-sync"
-import { ReplayPreview, isReplayQaUrl } from "../replay"
+import { ReplayPreview } from "../replay/ReplayPreview"
+import { isReplayQaUrl } from "../replay/url"
 import { VideoEmbed } from "../video"
 import { OpenApiOperation } from "../openapi/OpenApiOperation"
 import { Mermaid } from "./Mermaid"
 import { HighlightedCode } from "./HighlightedCode"
 import { CitationSources, InlineReference } from "./reference"
-import { renderMathToHtml } from "./math"
 
+type MathRenderer = (formula: string) => string
+let mathRenderer: MathRenderer | null = null
+let mathLoad: Promise<MathRenderer> | null = null
+function loadMathRenderer(): Promise<MathRenderer> {
+  mathLoad ??= import("./math").then((m) => (mathRenderer = m.renderMathToHtml))
+  return mathLoad
+}
+
+// KaTeX loads on first use; until then the TeX source shows in place.
 function MathBlock({ formula }: { formula: string }) {
-  return <div className="docs-math" dangerouslySetInnerHTML={{ __html: renderMathToHtml(formula) }} />
+  const [render, setRender] = useState<MathRenderer | null>(() => mathRenderer)
+  useEffect(() => {
+    if (render) return
+    let live = true
+    loadMathRenderer().then((fn) => live && setRender(() => fn), () => {})
+    return () => {
+      live = false
+    }
+  }, [render])
+  if (!render) {
+    return (
+      <div className="docs-math" data-pending="">
+        <code>{formula}</code>
+      </div>
+    )
+  }
+  return <div className="docs-math" dangerouslySetInnerHTML={{ __html: render(formula) }} />
 }
 
 export interface LivePreviewProps {
@@ -561,8 +585,8 @@ export interface DocRenderOptions {
   demoResolver?: DemoResolver
   /**
    * Runs the Preview of `{% demo %}` blocks that carry their files inline and have no
-   * resolver behind them. `PlaygroundStreamdown` (the package root's `GitbookStreamdown`)
-   * supplies an almost-node runtime by default; see `createAlmostNodeDemoRuntime`.
+   * resolver behind them. Nothing is supplied by default: pass `createAlmostNodeDemoRuntime()`
+   * from `@brett_lamy/docstream/playground` (or use its `PlaygroundStreamdown`) to run them.
    * Without one, such demos show their code with a short note.
    */
   demoRuntime?: InlineDemoRuntime

package/src/docs/Mermaid.tsx

@@ -1,4 +1,4 @@
-import { useEffect, useId, useRef, useState, type CSSProperties } from "react"
+import { useEffect, useId, useState, type CSSProperties } from "react"
 import { HighlightedCode } from "./HighlightedCode"
 
 let seq = 0
@@ -17,7 +17,6 @@ export function Mermaid({ code, collapsedCodeLines = 3, expandedCodeLines = 30 }
   const [svg, setSvg] = useState<string | null>(null)
   const [error, setError] = useState<string | null>(null)
   const [codeExpanded, setCodeExpanded] = useState(false)
-  const idRef = useRef(`mermaid-${++seq}`)
   const codePanelId = useId()
   const collapsedLines = positiveLineCount(collapsedCodeLines, 3)
   const expandedLines = Math.max(collapsedLines, positiveLineCount(expandedCodeLines, 30))
@@ -27,7 +26,10 @@ export function Mermaid({ code, collapsedCodeLines = 3, expandedCodeLines = 30 }
     import("mermaid")
       .then(async ({ default: mermaid }) => {
         mermaid.initialize({ startOnLoad: false, securityLevel: "strict" })
-        const { svg } = await mermaid.render(idRef.current, code)
+        // A fresh id per render: mermaid.render removes any element with the id it is given,
+        // so reusing one (StrictMode's double effect, a code change) deleted the diagram an
+        // earlier render had already mounted.
+        const { svg } = await mermaid.render(`mermaid-${++seq}`, code)
         if (!cancelled) setSvg(svg)
       })
       .catch((e) => {

package/src/docs/math.ts

@@ -1,4 +1,7 @@
+/* KaTeX lives behind this module, which DocsRenderer loads with a dynamic import the
+   first time a page has a math block — pages without math never download KaTeX. */
 import katex from "katex"
+import "katex/dist/katex.min.css"
 
 export function renderMathToHtml(formula: string): string {
   return katex.renderToString(formula, {