@brett_lamy/docstream 1.3.0 → 1.5.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.3.0",
+  "version": "1.5.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,58 +27,84 @@
   ],
   "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": {
     "framer-motion": "^13.1.1",
@@ -83,6 +112,7 @@
     "katex": "^0.18.5",
     "lucide-react": "^1.17.0",
     "mermaid": "^11.15.0",
+    "react-aria": "^3.52.1",
     "rrweb": "2.0.0-alpha.20",
     "yaml": "^2.9.0"
   },
@@ -113,8 +143,11 @@
     "@brett_lamy/viz-engine": "^0.2.1",
     "@types/node": "^24.0.0",
     "@types/react": "^18.3.3",
+    "@types/react-dom": "^18.3.7",
+    "happy-dom": "^20.14.5",
     "typescript": "^5.5.4",
     "vite": "^7.0.0",
     "vitest": "^3.2.4"
-  }
+  },
+  "module": "./dist/index.js"
 }

package/src/demo/DemoViewer.tsx

@@ -24,7 +24,7 @@ import {
   type KeyboardEvent as ReactKeyboardEvent,
   type PointerEvent as ReactPointerEvent,
   type ReactNode,
-  type MutableRefObject,
+  type Ref,
 } from "react"
 import { motion, useReducedMotion } from "framer-motion"
 import { ExternalLink, FileCode2, Folder, Maximize2, Monitor, Smartphone, Tablet, X } from "lucide-react"
@@ -36,8 +36,10 @@ import { HighlightedCode } from "../docs/HighlightedCode"
 import { CopyButton } from "../docs/copy"
 import { PillTabs, Segmented, rovingKeyDown } from "../docs/controls"
 import { useDemoResolver, useDemoRuntime } from "./context"
+import { createDocstreamClipboard, type DemoSourceSnapshot, type DocstreamClipboard } from "./clipboard"
+import { CopyDemoButton } from "./copy-demo"
 import { languageForPath } from "./glob"
-import { inlineDemoMarkdown } from "./markdown"
+import { useDemoVFSContext, useDemoVFSEntry, type DemoVFS } from "./vfs"
 import { cssToSurface, surfaceStyle, surfaceToCss } from "./surface"
 import type { DemoComponent, DemoFile, DemoMeta, DemoResolver, DemoVariant, InlineDemoRuntime } from "./types"
 
@@ -67,6 +69,11 @@ export interface DemoViewerProps {
   runtime?: InlineDemoRuntime
   /** Extra npm dependencies for the runtime, merged over `demoDependencies` from context. */
   dependencies?: Record<string, string>
+  /**
+   * Demo files held in memory by `src` (pasted demos). Used, like inline files, when the block
+   * has none of its own and no resolver knows `src`. Defaults to the VFS in context (`demoVFS`).
+   */
+  vfs?: DemoVFS
   /** Class on the viewer's outer element. (The preview canvas's class is `canvasClassName`.) */
   className?: string
   /*
@@ -120,6 +127,32 @@ export async function preloadDemos(resolver: DemoResolver, srcs: string[]): Prom
   )
 }
 
+/**
+ * Fetch demos' meta and files (not their components) into the viewer's cache, so
+ * `peekDemoSource` can answer synchronously — e.g. when a copy event needs a demo's files.
+ */
+export async function prefetchDemoSources(resolver: DemoResolver, srcs: string[]): Promise<void> {
+  const cache = cacheFor(resolver)
+  const settle = async (key: string, run: () => Promise<unknown>) => {
+    if (cache.get(key)?.status === "ready") return
+    try {
+      cache.set(key, { status: "ready", value: await run() })
+    } catch (cause) {
+      cache.set(key, { status: "error", error: cause instanceof Error ? cause : new Error(String(cause)) })
+    }
+  }
+  await Promise.all(srcs.flatMap((src) => [settle(`meta:${src}`, () => resolver.meta(src)), settle(`files:${src}`, () => resolver.files(src))]))
+}
+
+/** A demo's files (and meta) if the resolver has already delivered them (viewer, `preloadDemos`, `prefetchDemoSources`). */
+export function peekDemoSource(resolver: DemoResolver, src: string): DemoSourceSnapshot | undefined {
+  const cache = settled.get(resolver)
+  const files = cache?.get(`files:${src}`)
+  if (files?.status !== "ready" || !(files.value as DemoFile[]).length) return undefined
+  const meta = cache?.get(`meta:${src}`)
+  return { files: files.value as DemoFile[], ...(meta?.status === "ready" && meta.value ? { meta: meta.value as DemoMeta } : {}) }
+}
+
 /** Resolves `run()` once `active`, remembering settled values so remounts don't flash. */
 function useResolved<T>(resolver: DemoResolver | undefined, key: string, active: boolean, run: () => Promise<T>): Loaded<T> {
   const cached = resolver ? (cacheFor(resolver).get(key) as Loaded<T> | undefined) : undefined
@@ -165,10 +198,11 @@ const useComponent = (resolver: DemoResolver | undefined, src: string, active: b
 
 /** True once the element has come within `margin` of the viewport (stays true). */
 function useNearViewport<T extends Element>(margin = "400px 0px") {
-  const ref = useRef<T | null>(null)
+  // A callback ref, so an element that appears later (a VFS demo arriving) is observed too.
+  const [el, setEl] = useState<T | null>(null)
+  const ref = useMemo(() => (node: T | null) => setEl(node), [])
   const [near, setNear] = useState(false)
   useEffect(() => {
-    const el = ref.current
     if (!el || near) return
     if (typeof IntersectionObserver === "undefined") {
       setNear(true)
@@ -179,7 +213,7 @@ function useNearViewport<T extends Element>(margin = "400px 0px") {
     }, { rootMargin: margin })
     observer.observe(el)
     return () => observer.disconnect()
-  }, [near, margin])
+  }, [el, near, margin])
   return [ref, near] as const
 }
 
@@ -594,7 +628,12 @@ export function DemoViewer(props: DemoViewerProps) {
   const runtimeOptions = useDemoRuntime({ runtime: props.runtime, dependencies: props.dependencies })
   const { src } = props
   const [ref, near] = useNearViewport<HTMLElement>()
-  const inlineFiles = useMemo(() => orderInline(props.files, props.entry), [props.files, props.entry])
+  const vfs = useDemoVFSContext(props.vfs)
+  // Pasted demos: files held by the VFS stand in for inline files the block doesn't carry.
+  const vfsEntry = useDemoVFSEntry(vfs, props.files?.length ? "" : src)
+  const ownFiles = props.files?.length ? props.files : vfsEntry?.files
+  const ownEntry = props.files?.length ? props.entry : props.entry ?? vfsEntry?.meta?.entry
+  const inlineFiles = useMemo(() => orderInline(ownFiles, ownEntry), [ownFiles, ownEntry])
 
   // A resolver is consulted unless the block brings its own files and the resolver
   // says (via `list()`) that it does not know this src.
@@ -607,7 +646,7 @@ export function DemoViewer(props: DemoViewerProps) {
   const mode: "resolver" | "inline" | "none" =
     tryResolver && !(inlineFiles && resolverFailed) ? "resolver" : inlineFiles ? "inline" : "none"
 
-  const metaValue = mode === "resolver" && meta.status === "ready" ? meta.value : undefined
+  const metaValue = mode === "resolver" ? (meta.status === "ready" ? meta.value : undefined) : mode === "inline" && !props.files?.length ? vfsEntry?.meta : undefined
   const files: Loaded<DemoFile[]> = mode === "inline" ? { status: "ready", value: inlineFiles! } : resolvedFiles
   const title = props.title ?? metaValue?.title ?? (src.split("/").pop() || "Demo")
   const description = props.description ?? metaValue?.description
@@ -669,7 +708,12 @@ export function DemoViewer(props: DemoViewerProps) {
     ...(props.surface ? { surface: typeof props.surface === "string" ? props.surface : surfaceToCss(props.surface) } : {}),
     ...(props.variantsWidth !== undefined && props.variantsWidth !== "" ? { variantsWidth: String(props.variantsWidth) } : {}),
   }
-  const copyDemo = () => inlineDemoMarkdown(node, fileList ?? [], metaValue)
+  // "Copy demo": the exact block (src-only stays src-only; inline files stay inline) plus its files.
+  const copyDemo = (): DocstreamClipboard | null => {
+    if (!fileList?.length) return null
+    const exact: DemoNode = props.files?.length ? { ...node, ...(props.entry ? { entry: props.entry } : {}), files: props.files.map((f) => ({ ...f })) } : node
+    return createDocstreamClipboard({ type: "doc", children: [exact] }, { lookup: () => ({ files: fileList, ...(metaValue ? { meta: metaValue } : {}) }) })
+  }
 
   const dialog = (
     <FullscreenDialog
@@ -702,6 +746,7 @@ export function DemoViewer(props: DemoViewerProps) {
             <span className="docs-demo-spacer" />
             <StatusBadge status={status} />
             <VariantSwitch variants={variants} value={variant} onChange={setVariant} title={title} width={variantsWidth} />
+            {fileList?.length ? <CopyDemoButton clipboard={copyDemo} className="docs-demo-icon-btn" /> : null}
             {runnable ? <FullscreenButton onOpen={() => setFullscreen(true)} title={title} /> : null}
           </header>
           {runnable ? (
@@ -766,7 +811,7 @@ export function DemoViewer(props: DemoViewerProps) {
 }
 
 function MultiFileViewer({ rootRef, className, baseId, mode, src, title, description, variants, variant, onVariant, files, preview, near, height, viewport, bleed, look, status, variantsWidth, href, onFullscreen, copyDemo, dialog }: {
-  rootRef: MutableRefObject<HTMLElement | null>
+  rootRef: Ref<HTMLElement>
   className: string
   baseId: string
   mode: "resolver" | "inline"
@@ -787,7 +832,7 @@ function MultiFileViewer({ rootRef, className, baseId, mode, src, title, descrip
   variantsWidth: number | string | undefined
   href: string | undefined
   onFullscreen: () => void
-  copyDemo: (() => string) | undefined
+  copyDemo: (() => DocstreamClipboard | null) | undefined
   dialog: ReactNode
 }) {
   const runnable = preview.kind !== "unavailable"
@@ -835,7 +880,7 @@ function MultiFileViewer({ rootRef, className, baseId, mode, src, title, descrip
               ))}
             </div>
           ) : null}
-          {copyDemo ? <CopyButton text={copyDemo} label="Copy demo as Markdown" className="docs-demo-icon-btn" /> : null}
+          {copyDemo ? <CopyDemoButton clipboard={copyDemo} className="docs-demo-icon-btn" /> : null}
           {runnable ? <FullscreenButton onOpen={onFullscreen} title={title} /> : null}
           <NewTabLink href={href} title={title} />
         </div>