@brett_lamy/docstream 1.3.0 → 1.5.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/demo/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,2BAA2B,EAAE,uBAAuB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AACvI,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,UAAU,EAAE,cAAc,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AACvH,OAAO,EACL,wBAAwB,EACxB,gBAAgB,EAChB,wBAAwB,EACxB,oCAAoC,EACpC,YAAY,EACZ,uBAAuB,EACvB,4BAA4B,EAC5B,qBAAqB,EACrB,YAAY,EACZ,uBAAuB,EACvB,sBAAsB,EACtB,2BAA2B,EAC3B,uBAAuB,GACxB,MAAM,aAAa,CAAA;AACpB,YAAY,EACV,+BAA+B,EAC/B,kBAAkB,EAClB,kBAAkB,EAClB,sBAAsB,EACtB,yBAAyB,EACzB,iBAAiB,GAClB,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAC9D,YAAY,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AACrE,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,iBAAiB,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,OAAO,CAAA;AACtG,YAAY,EAAE,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,OAAO,CAAA;AACzF,YAAY,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AACxE,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,cAAc,EACd,QAAQ,EACR,eAAe,EACf,aAAa,GACd,MAAM,QAAQ,CAAA;AACf,YAAY,EAAE,uBAAuB,EAAE,MAAM,QAAQ,CAAA;AACrD,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,cAAc,EAAE,sBAAsB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAC3H,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AACtD,YAAY,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AACvF,YAAY,EACV,aAAa,EACb,kBAAkB,EAClB,QAAQ,EACR,QAAQ,EACR,YAAY,EACZ,kBAAkB,EAClB,WAAW,EACX,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,SAAS,CAAA"}

package/dist/demo/index.js

@@ -0,0 +1,9 @@
+export { DocstreamDemoContext, DocstreamDemoRuntimeContext, DocstreamDemoVFSContext, useDemoResolver, useDemoRuntime } from "./context.js";
+export { DemoBlock, DemoFullscreen, DemoViewer, peekDemoSource, prefetchDemoSources, preloadDemos } from "./DemoViewer.js";
+export { DOCSTREAM_CLIPBOARD_TYPE, collectDemoNodes, createDocstreamClipboard, createDocstreamClipboardFromMarkdown, demoNodeMeta, docstreamClipboardItems, docstreamPayloadFromMarkdown, hasDocstreamClipboard, mapDemoNodes, parseDocstreamClipboard, readDocstreamClipboard, readDocstreamClipboardItems, writeDocstreamClipboard, } from "./clipboard.js";
+export { CopyDemoButton, useDocstreamCopy } from "./copy-demo.js";
+export { createDemoVFS, useDemoVFS, useDemoVFSContext, useDemoVFSEntry, useDemoVFSFiles } from "./vfs.js";
+export { createGlobDemoResolver, demoComponentFrom, demoFromSearch, demoHref, languageForPath, sortDemoFiles, } from "./glob.js";
+export { defaultDemoMarkdown, inlineDemoMarkdown, inlineDemoNode, resolveDemosToMarkdown, toInlineFiles } from "./markdown.js";
+export { cssToSurface, surfaceToCss } from "./surface.js";
+//# sourceMappingURL=index.js.map

package/dist/demo/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/demo/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,2BAA2B,EAAE,uBAAuB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AACvI,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,UAAU,EAAE,cAAc,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AACvH,OAAO,EACL,wBAAwB,EACxB,gBAAgB,EAChB,wBAAwB,EACxB,oCAAoC,EACpC,YAAY,EACZ,uBAAuB,EACvB,4BAA4B,EAC5B,qBAAqB,EACrB,YAAY,EACZ,uBAAuB,EACvB,sBAAsB,EACtB,2BAA2B,EAC3B,uBAAuB,GACxB,MAAM,aAAa,CAAA;AASpB,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAE9D,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,iBAAiB,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,OAAO,CAAA;AAGtG,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,cAAc,EACd,QAAQ,EACR,eAAe,EACf,aAAa,GACd,MAAM,QAAQ,CAAA;AAEf,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,cAAc,EAAE,sBAAsB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAC3H,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA"}

package/dist/demo/markdown.d.ts

@@ -0,0 +1,60 @@
+import type { DemoInlineFile, DemoNode } from "../gitbook/ast.js";
+import { fenceFor } from "../gitbook/serialize.js";
+import type { DemoFile, DemoMeta, DemoResolver } from "./types.js";
+export { fenceFor };
+/**
+ * - `"inline"` (default): every `{% demo src=… %}` keeps its tag and gains its files as
+ *   inline fences (`{% demo … %}` + titled fences + `{% enddemo %}`), so the Markdown is
+ *   still a docstream page: it renders back identically where the resolver exists and
+ *   self-contained everywhere else.
+ * - `"plain"`: for LLM prompts and plain Markdown tools — each demo becomes a bold
+ *   "Example — Title" line, its description, a variants note and one titled fence per
+ *   file (the pre-1.2 output); `{% command %}` boxes become npm ```` ```sh ```` fences and
+ *   titled tab sets become a heading plus one bold-labelled part per tab
+ *   (`flattenForPlainMarkdown`). Not renderable as docstream any more.
+ */
+export type DemoMarkdownFormat = "inline" | "plain";
+export interface ResolveDemosOptions {
+    /** Output shape. Defaults to `"inline"` (renderable docstream Markdown). */
+    format?: DemoMarkdownFormat;
+    /** `"plain"` only: title shown on each file fence. Defaults to `<src>/<path>`. */
+    filePath?: (src: string, file: DemoFile) => string;
+    /**
+     * Markdown rendered for one demo, replacing the whole `{% demo %}` block whatever the
+     * `format`. Called only for demos with files (resolved, or inline).
+     */
+    render?: (demo: ResolvedDemo) => string;
+}
+export interface ResolvedDemo {
+    node: DemoNode;
+    meta: DemoMeta | undefined;
+    files: DemoFile[];
+    title: string;
+}
+/** The pre-1.2 "plain" rendering of one demo: prose plus titled fences. */
+export declare function defaultDemoMarkdown(demo: ResolvedDemo, filePath?: ResolveDemosOptions["filePath"]): string;
+/** Resolver / viewer files as inline demo files: trailing newlines dropped, language filled in. */
+export declare function toInlineFiles(files: DemoFile[]): DemoInlineFile[];
+/**
+ * A demo as a self-contained block-form `{% demo %}`: the node's attributes, with the
+ * folder's `meta.json` defaults folded in (so the block renders the same without the
+ * resolver) — title, description, height, layout, variants, entry and the look fields
+ * `status`, `bleed`, `className`, `surface` (as CSS declarations) and `variantsWidth` —
+ * and `files` as inline fences. Tag attributes win over `meta.json` where both exist.
+ */
+export declare function inlineDemoNode(node: DemoNode, files: DemoFile[], meta?: DemoMeta): DemoNode;
+/** `inlineDemoNode` serialized: `{% demo … %}` + titled fences + `{% enddemo %}`. */
+export declare function inlineDemoMarkdown(node: DemoNode, files: DemoFile[], meta?: DemoMeta): string;
+/**
+ * Make every `{% demo %}` in a page carry its real source files (Copy page, `.md`
+ * exports, llms.txt). By default the result is still docstream Markdown — see
+ * `DemoMarkdownFormat`. Everything outside demo blocks is returned byte-for-byte, and
+ * tags inside code fences are left alone.
+ *
+ * `"inline"`: blocks that already carry inline files, and demos the resolver cannot
+ * resolve (or no resolver), are left exactly as written — they are valid docstream.
+ * `"plain"`: unresolvable demos become a short note rather than tag syntax other tools
+ * would not understand.
+ */
+export declare function resolveDemosToMarkdown(markdown: string, resolver: DemoResolver | undefined, options?: ResolveDemosOptions): Promise<string>;
+//# sourceMappingURL=markdown.d.ts.map

package/dist/demo/markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../src/demo/markdown.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAI9D,OAAO,EAAE,QAAQ,EAAsC,MAAM,sBAAsB,CAAA;AACnF,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAI/D,OAAO,EAAE,QAAQ,EAAE,CAAA;AAEnB;;;;;;;;;;GAUG;AACH,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG,OAAO,CAAA;AAEnD,MAAM,WAAW,mBAAmB;IAClC,4EAA4E;IAC5E,MAAM,CAAC,EAAE,kBAAkB,CAAA;IAC3B,kFAAkF;IAClF,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,KAAK,MAAM,CAAA;IAClD;;;OAGG;IACH,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,MAAM,CAAA;CACxC;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,QAAQ,CAAA;IACd,IAAI,EAAE,QAAQ,GAAG,SAAS,CAAA;IAC1B,KAAK,EAAE,QAAQ,EAAE,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;CACd;AAQD,2EAA2E;AAC3E,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,YAAY,EAAE,QAAQ,CAAC,EAAE,mBAAmB,CAAC,UAAU,CAAC,GAAG,MAAM,CAkB1G;AAED,mGAAmG;AACnG,wBAAgB,aAAa,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,cAAc,EAAE,CAKjE;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,IAAI,CAAC,EAAE,QAAQ,GAAG,QAAQ,CA8B3F;AAED,qFAAqF;AACrF,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,IAAI,CAAC,EAAE,QAAQ,GAAG,MAAM,CAE7F;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,sBAAsB,CAC1C,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,YAAY,GAAG,SAAS,EAClC,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,MAAM,CAAC,CAgCjB"}

package/dist/demo/markdown.js

@@ -0,0 +1,181 @@
+import { TAG_ATTRS } from "../gitbook/attrs.js";
+import { flattenForPlainMarkdown } from "../gitbook/flatten.js";
+import { demoBody, fenceTracker, parseBlocks, parseMarkdown } from "../gitbook/parse.js";
+import { fenceFor, serializeBlocks, serializeMarkdown } from "../gitbook/serialize.js";
+import { languageForPath } from "./glob.js";
+import { surfaceToCss } from "./surface.js";
+export { fenceFor };
+const TAG_RE = new RegExp(String.raw `^(\s*)\{%\s*demo(\s${TAG_ATTRS})?\s*\/?%\}\s*$`);
+function titleFor(src, node, meta) {
+    return node.title ?? meta?.title ?? (src.split("/").pop() || src || "Demo");
+}
+/** The pre-1.2 "plain" rendering of one demo: prose plus titled fences. */
+export function defaultDemoMarkdown(demo, filePath) {
+    const { node, meta, files, title } = demo;
+    const description = node.description ?? meta?.description;
+    const variants = node.variants ?? meta?.variants;
+    const parts = [`**Example — ${title}**`];
+    if (description)
+        parts.push(description);
+    if (variants?.length) {
+        parts.push(`Variants (the \`variant\` prop): ${variants.map((v) => `\`${v.id}\`${v.label !== v.id ? ` (${v.label})` : ""}`).join(", ")}.`);
+    }
+    if (!files.length)
+        parts.push(`> Demo \`${node.src}\` has no source files.`);
+    for (const file of files) {
+        const fence = fenceFor(file.content);
+        const language = file.language ?? languageForPath(file.path) ?? "";
+        const title = filePath ? filePath(node.src, file) : node.src ? `${node.src}/${file.path}` : file.path;
+        const body = file.content.replace(/\n+$/, "");
+        parts.push(`${fence}${language} title="${title}"\n${body}\n${fence}`);
+    }
+    return parts.join("\n\n");
+}
+/** Resolver / viewer files as inline demo files: trailing newlines dropped, language filled in. */
+export function toInlineFiles(files) {
+    return files.map((file) => {
+        const language = file.language ?? languageForPath(file.path);
+        return { path: file.path, content: file.content.replace(/\n+$/, ""), ...(language ? { language } : {}) };
+    });
+}
+/**
+ * A demo as a self-contained block-form `{% demo %}`: the node's attributes, with the
+ * folder's `meta.json` defaults folded in (so the block renders the same without the
+ * resolver) — title, description, height, layout, variants, entry and the look fields
+ * `status`, `bleed`, `className`, `surface` (as CSS declarations) and `variantsWidth` —
+ * and `files` as inline fences. Tag attributes win over `meta.json` where both exist.
+ */
+export function inlineDemoNode(node, files, meta) {
+    const inline = toInlineFiles(files);
+    const height = node.height ?? (meta?.height === undefined || meta.height === "" ? undefined : String(meta.height));
+    const title = node.title ?? meta?.title;
+    const description = node.description ?? meta?.description;
+    const layout = node.layout ?? meta?.layout;
+    const variants = node.variants?.length ? node.variants : meta?.variants?.length ? meta.variants : undefined;
+    const entry = node.entry ?? (meta?.entry && inline[0]?.path !== meta.entry ? meta.entry : undefined);
+    const status = node.status ?? meta?.status;
+    const bleed = node.bleed ?? meta?.bleed;
+    const className = node.className ?? meta?.className;
+    const surface = node.surface ?? (meta?.surface ? surfaceToCss(meta.surface) : undefined);
+    const variantsWidth = node.variantsWidth ?? (meta?.variantsWidth === undefined || meta.variantsWidth === "" ? undefined : String(meta.variantsWidth));
+    return {
+        type: "demo",
+        src: node.src,
+        ...(title ? { title } : {}),
+        ...(description ? { description } : {}),
+        ...(height ? { height } : {}),
+        ...(layout ? { layout } : {}),
+        ...(variants ? { variants } : {}),
+        ...(node.viewport ? { viewport: node.viewport } : {}),
+        ...(entry ? { entry } : {}),
+        ...(status ? { status } : {}),
+        ...(bleed === undefined ? {} : { bleed }),
+        ...(className ? { className } : {}),
+        ...(surface ? { surface } : {}),
+        ...(variantsWidth ? { variantsWidth } : {}),
+        ...(inline.length ? { files: inline } : {}),
+    };
+}
+/** `inlineDemoNode` serialized: `{% demo … %}` + titled fences + `{% enddemo %}`. */
+export function inlineDemoMarkdown(node, files, meta) {
+    return serializeBlocks([inlineDemoNode(node, files, meta)]);
+}
+/**
+ * Make every `{% demo %}` in a page carry its real source files (Copy page, `.md`
+ * exports, llms.txt). By default the result is still docstream Markdown — see
+ * `DemoMarkdownFormat`. Everything outside demo blocks is returned byte-for-byte, and
+ * tags inside code fences are left alone.
+ *
+ * `"inline"`: blocks that already carry inline files, and demos the resolver cannot
+ * resolve (or no resolver), are left exactly as written — they are valid docstream.
+ * `"plain"`: unresolvable demos become a short note rather than tag syntax other tools
+ * would not understand.
+ */
+export async function resolveDemosToMarkdown(markdown, resolver, options = {}) {
+    // Plain output also flattens docstream-only presentation blocks (command boxes, titled tabs).
+    if (options.format === "plain" && /\{%\s*(?:command\b|tabs\s(?:[^%\n]|%(?!\}))*\btitle=)/.test(markdown)) {
+        markdown = serializeMarkdown(flattenForPlainMarkdown(parseMarkdown(markdown)));
+    }
+    const lines = markdown.split("\n");
+    const jobs = [];
+    const fences = fenceTracker();
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        if (fences.step(line))
+            continue;
+        const tag = line.match(TAG_RE);
+        if (!tag)
+            continue;
+        const indent = tag[1];
+        const body = demoBody(lines, i + 1, /\/\s*%\}\s*$/.test(line));
+        const end = body ? body.next : i + 1;
+        const block = lines.slice(i, end).map((l) => (l.startsWith(indent) ? l.slice(indent.length) : l));
+        const node = parseBlocks(block)[0];
+        if (node?.type !== "demo")
+            continue;
+        jobs.push({ index: i, end, indent, promise: renderDemo(node, block[0], resolver, options) });
+        i = end - 1;
+    }
+    if (!jobs.length)
+        return markdown;
+    const rendered = await Promise.all(jobs.map((job) => job.promise));
+    for (let j = jobs.length - 1; j >= 0; j--) {
+        const out = rendered[j];
+        if (out === null)
+            continue;
+        const { index, end, indent } = jobs[j];
+        const text = indent ? out.split("\n").map((l) => (l ? indent + l : l)).join("\n") : out;
+        lines.splice(index, end - index, text);
+    }
+    return lines.join("\n");
+}
+/**
+ * `inlineDemoMarkdown`, but keeping the author's tag line byte-for-byte when folding in
+ * `meta.json` added no attributes (only the files are new).
+ */
+function inlineDemoKeepingTag(tagLine, node, files, meta) {
+    const next = inlineDemoNode(node, files, meta);
+    const out = serializeBlocks([next]);
+    const bare = (n) => {
+        const { files: _files, open: _open, raw: _raw, ...rest } = n;
+        return rest;
+    };
+    if (serializeBlocks([bare(next)]) !== serializeBlocks([bare(node)]))
+        return out;
+    const tag = tagLine.trim().replace(/\s*\/\s*%\}$/, " %}");
+    return tag + out.slice(out.indexOf("\n"));
+}
+/** The replacement for one demo block, or null to keep it byte-for-byte. */
+async function renderDemo(node, tagLine, resolver, options) {
+    const plain = options.format === "plain";
+    const inlineFiles = node.files?.length ? node.files : undefined;
+    let meta;
+    let files;
+    let failure;
+    if (resolver && node.src && !(inlineFiles && !plain && !options.render)) {
+        try {
+            ;
+            [meta, files] = await Promise.all([resolver.meta(node.src), resolver.files(node.src)]);
+        }
+        catch (error) {
+            failure = error instanceof Error ? error.message : String(error);
+        }
+    }
+    // Resolver files are the authority; inline files stand in when it cannot help.
+    const chosen = files?.length ? files : inlineFiles;
+    if (!chosen) {
+        if (!plain)
+            return null;
+        if (failure !== undefined)
+            return `> Live demo \`${node.src}\` could not be resolved: ${failure}`;
+        if (!resolver || !node.src)
+            return `> Live demo \`${node.src || "?"}\` (interactive on the docs site).`;
+    }
+    const demo = { node, meta, files: chosen ?? [], title: titleFor(node.src, node, meta) };
+    if (options.render)
+        return options.render(demo);
+    if (plain)
+        return defaultDemoMarkdown(demo, options.filePath);
+    return chosen === inlineFiles ? null : inlineDemoKeepingTag(tagLine, node, chosen, meta);
+}
+//# sourceMappingURL=markdown.js.map

package/dist/demo/markdown.js.map

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

package/dist/demo/surface.d.ts

@@ -0,0 +1,11 @@
+import type { CSSProperties } from "react";
+/** A `meta.json` surface object as the declaration string the demo tag carries. */
+export declare function surfaceToCss(surface: Record<string, string | number>): string;
+/**
+ * The tag's declaration string as a React style object. Custom properties keep their
+ * name; `kebab-case` becomes camelCase; plain numbers on ordinary properties become
+ * numbers (so `padding: 12` means 12px, as it does in `meta.json`).
+ */
+export declare function cssToSurface(css: string): Record<string, string | number>;
+export declare function surfaceStyle(surface: Record<string, string | number> | undefined): CSSProperties | undefined;
+//# sourceMappingURL=surface.d.ts.map

package/dist/demo/surface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface.d.ts","sourceRoot":"","sources":["../../src/demo/surface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAA;AAU1C,mFAAmF;AACnF,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GAAG,MAAM,CAK7E;AAyBD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAgBzE;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GAAG,SAAS,GAAG,aAAa,GAAG,SAAS,CAE5G"}

package/dist/demo/surface.js

@@ -0,0 +1,69 @@
+/*
+ * A demo canvas's `surface` (inline style) has two spellings:
+ * - `meta.json`: an object, `{ "background": "var(--brand-50)", "--demo-gap": "12px", "padding": 12 }`;
+ * - the `{% demo surface="…" %}` attribute: CSS declarations,
+ *   `background: var(--brand-50); --demo-gap: 12px; padding: 12`.
+ * Keys are kept as written (camelCase, kebab-case or custom properties).
+ */
+/** A `meta.json` surface object as the declaration string the demo tag carries. */
+export function surfaceToCss(surface) {
+    return Object.entries(surface)
+        .filter(([key, value]) => key.trim() && value !== undefined && value !== null && String(value).trim() !== "")
+        .map(([key, value]) => `${key.trim()}: ${String(value).trim()}`)
+        .join("; ");
+}
+/** Split on `;` outside parentheses and quotes (`url("a;b")` stays whole). */
+function declarations(css) {
+    const out = [];
+    let depth = 0;
+    let quote = "";
+    let current = "";
+    for (const ch of css) {
+        if (quote) {
+            if (ch === quote)
+                quote = "";
+        }
+        else if (ch === '"' || ch === "'")
+            quote = ch;
+        else if (ch === "(")
+            depth++;
+        else if (ch === ")")
+            depth = Math.max(0, depth - 1);
+        else if (ch === ";" && depth === 0) {
+            out.push(current);
+            current = "";
+            continue;
+        }
+        current += ch;
+    }
+    out.push(current);
+    return out;
+}
+/**
+ * The tag's declaration string as a React style object. Custom properties keep their
+ * name; `kebab-case` becomes camelCase; plain numbers on ordinary properties become
+ * numbers (so `padding: 12` means 12px, as it does in `meta.json`).
+ */
+export function cssToSurface(css) {
+    const style = {};
+    for (const declaration of declarations(css)) {
+        const colon = declaration.indexOf(":");
+        if (colon < 0)
+            continue;
+        const key = declaration.slice(0, colon).trim();
+        const value = declaration.slice(colon + 1).trim();
+        if (!key || !value)
+            continue;
+        if (key.startsWith("--")) {
+            style[key] = value;
+            continue;
+        }
+        const name = key.replace(/-([a-z])/g, (_, c) => c.toUpperCase());
+        style[name] = /^-?\d+(?:\.\d+)?$/.test(value) ? Number(value) : value;
+    }
+    return style;
+}
+export function surfaceStyle(surface) {
+    return surface && Object.keys(surface).length ? surface : undefined;
+}
+//# sourceMappingURL=surface.js.map

package/dist/demo/surface.js.map

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

package/dist/demo/types.d.ts

@@ -0,0 +1,91 @@
+import type { ComponentType, ReactNode } from "react";
+import type { DemoLayout, DemoVariantOption } from "../gitbook/ast.js";
+export type DemoVariant = DemoVariantOption;
+/** Defaults for a demo folder, usually its `meta.json`. `{% demo %}` attributes override them. */
+export interface DemoMeta {
+    title?: string;
+    description?: string;
+    /**
+     * Preview height: pixels, or any CSS length (`"60vh"`, `"auto"`). Single-file previews
+     * treat it as a **minimum** (the card grows with its content); the multi-file viewer's
+     * resizable stage and inline-demo iframes use it as the height.
+     */
+    height?: number | string;
+    variants?: DemoVariant[];
+    /** Entry file, relative to the demo folder. Defaults to `index.tsx`. */
+    entry?: string;
+    layout?: DemoLayout;
+    /** Drop the padded preview surface for demos that bring their own full-bleed frame. */
+    bleed?: boolean;
+    /** Extra class on the preview canvas (the surface the component renders on). */
+    className?: string;
+    /**
+     * Inline style for the preview canvas: CSS custom properties or plain properties,
+     * e.g. `{ "background": "var(--brand-50)", "--demo-gap": "12px" }`.
+     */
+    surface?: Record<string, string | number>;
+    /** A short status shown in the demo header, e.g. `"Live"` or `"Needs network"`. */
+    status?: string;
+    /** Width of the variant switch (px number or CSS length); its options share it equally. */
+    variantsWidth?: number | string;
+}
+export interface DemoFile {
+    /** Path relative to the demo folder (`index.tsx`, `parts/Card.tsx`). */
+    path: string;
+    content: string;
+    /** Highlighting language; defaults to the file extension. */
+    language?: string;
+}
+/** Props the loaded demo component receives. */
+export interface DemoComponentProps {
+    variant?: string;
+}
+export type DemoComponent = ComponentType<DemoComponentProps>;
+/**
+ * How a host turns `{% demo src="<page>/<example>" %}` into something renderable.
+ * `createGlobDemoResolver` builds one from Vite `import.meta.glob` maps.
+ */
+export interface DemoResolver {
+    /** Every known demo id (optional; used by tooling and llms.txt generators). */
+    list?(): string[];
+    meta(src: string): Promise<DemoMeta | undefined>;
+    /** The demo's source files, entry first. These are exactly what the Code view shows. */
+    files(src: string): Promise<DemoFile[]>;
+    /** The component to render in-page. */
+    load(src: string): Promise<DemoComponent>;
+    /**
+     * Optional deep link that renders the demo alone (e.g. `?demo=<src>`); the host
+     * routes it to `<DemoFullscreen>`. When present, the viewer shows an
+     * "Open in new tab" link next to its in-page fullscreen button.
+     */
+    href?(src: string, options?: {
+        variant?: string;
+    }): string | undefined;
+}
+/** What an inline-demo runtime gets: the block's own files, ready to run. */
+export interface InlineDemoRuntimeProps {
+    /** The block's `src` (may be empty); useful as a cache key or label. */
+    src: string;
+    title: string;
+    /** The inline files, entry first, paths relative to the demo folder. */
+    files: DemoFile[];
+    /** Path of the entry file (its default export is the component). */
+    entry: string;
+    /** The selected variant, passed to the component as its `variant` prop. */
+    variant?: string;
+    /** Extra npm dependencies (`{ "@brett_lamy/ui": "^1.2.0" }`) the files may import. */
+    dependencies?: Record<string, string>;
+}
+/**
+ * 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 that entry's `PlaygroundStreamdown`
+ * wires in by default. The package root never loads a runtime on its own.
+ */
+export type InlineDemoRuntime = (props: InlineDemoRuntimeProps) => ReactNode;
+export interface DemoRuntimeOptions {
+    runtime?: InlineDemoRuntime;
+    /** Extra npm dependencies handed to the runtime for every inline demo. */
+    dependencies?: Record<string, string>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/demo/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/demo/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAEnE,MAAM,MAAM,WAAW,GAAG,iBAAiB,CAAA;AAE3C,kGAAkG;AAClG,MAAM,WAAW,QAAQ;IACvB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACxB,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAA;IACxB,wEAAwE;IACxE,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,UAAU,CAAA;IACnB,uFAAuF;IACvF,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,gFAAgF;IAChF,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAA;IACzC,mFAAmF;IACnF,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,2FAA2F;IAC3F,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;CAChC;AAED,MAAM,WAAW,QAAQ;IACvB,wEAAwE;IACxE,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,gDAAgD;AAChD,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,MAAM,aAAa,GAAG,aAAa,CAAC,kBAAkB,CAAC,CAAA;AAE7D;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,+EAA+E;IAC/E,IAAI,CAAC,IAAI,MAAM,EAAE,CAAA;IACjB,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC,CAAA;IAChD,wFAAwF;IACxF,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAA;IACvC,uCAAuC;IACvC,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAA;IACzC;;;;OAIG;IACH,IAAI,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,GAAG,SAAS,CAAA;CACvE;AAED,6EAA6E;AAC7E,MAAM,WAAW,sBAAsB;IACrC,wEAAwE;IACxE,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,wEAAwE;IACxE,KAAK,EAAE,QAAQ,EAAE,CAAA;IACjB,oEAAoE;IACpE,KAAK,EAAE,MAAM,CAAA;IACb,2EAA2E;IAC3E,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,sFAAsF;IACtF,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACtC;AAED;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,KAAK,EAAE,sBAAsB,KAAK,SAAS,CAAA;AAE5E,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,EAAE,iBAAiB,CAAA;IAC3B,0EAA0E;IAC1E,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACtC"}

package/dist/demo/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/demo/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/demo/types.ts"],"names":[],"mappings":""}

package/dist/demo/vfs.d.ts

@@ -0,0 +1,51 @@
+import type { DemoFile, DemoMeta, DemoResolver, InlineDemoRuntime } from "./types.js";
+export interface DemoVFSEntry {
+    /** Entry first (or `meta.entry`), paths relative to the demo folder. */
+    files: DemoFile[];
+    /** `meta.json`-style defaults, usually the `{% demo %}` tag's attributes. */
+    meta?: DemoMeta;
+}
+export interface DemoVFSChange {
+    src: string;
+    /** The new entry; `undefined` when `src` was removed. */
+    entry: DemoVFSEntry | undefined;
+}
+export interface DemoVFSResolverOptions {
+    /** The host resolver, consulted first. */
+    resolver?: DemoResolver;
+    /** Runs VFS files for `load(src)`. Without one, `load` rejects for VFS-only demos. */
+    runtime?: InlineDemoRuntime;
+    /** Extra npm dependencies handed to the runtime. */
+    dependencies?: Record<string, string>;
+}
+export interface DemoVFS {
+    get(src: string): DemoVFSEntry | undefined;
+    has(src: string): boolean;
+    /** Every `src` held, in insertion order. */
+    list(): string[];
+    /** Adds or replaces `src`. A no-op (and no change event) when nothing differs. */
+    set(src: string, files: DemoFile[], meta?: DemoMeta): void;
+    delete(src: string): boolean;
+    clear(): void;
+    /** Everything held, as `{ [src]: entry }`. The object is stable until the next change. */
+    snapshot(): Readonly<Record<string, DemoVFSEntry>>;
+    /** Files only, as `{ [src]: files }` (what a host usually persists). Stable until the next change. */
+    files(): Readonly<Record<string, DemoFile[]>>;
+    subscribe(listener: (change: DemoVFSChange) => void): () => void;
+    /** This VFS as a `DemoResolver` layered over a host resolver. */
+    resolver(options?: DemoVFSResolverOptions): DemoResolver;
+}
+/** A new, empty (or pre-filled) demo VFS. */
+export declare function createDemoVFS(initial?: Record<string, DemoFile[] | DemoVFSEntry>): DemoVFS;
+/**
+ * A demo VFS owned by the calling component (created once). Pass it as `demoVFS` to several
+ * editors / renderers to share pasted demo files between them.
+ */
+export declare function useDemoVFS(initial?: Record<string, DemoFile[] | DemoVFSEntry>): DemoVFS;
+/** The VFS in context (a renderer's or editor's `demoVFS`), unless `override` is given. */
+export declare function useDemoVFSContext(override?: DemoVFS): DemoVFS | undefined;
+/** `{ [src]: files }` of a VFS, re-rendering on change. */
+export declare function useDemoVFSFiles(vfs: DemoVFS | undefined): Readonly<Record<string, DemoFile[]>>;
+/** One VFS entry, re-rendering when it changes. */
+export declare function useDemoVFSEntry(vfs: DemoVFS | undefined, src: string): DemoVFSEntry | undefined;
+//# sourceMappingURL=vfs.d.ts.map

package/dist/demo/vfs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vfs.d.ts","sourceRoot":"","sources":["../../src/demo/vfs.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAsB,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAEtG,MAAM,WAAW,YAAY;IAC3B,wEAAwE;IACxE,KAAK,EAAE,QAAQ,EAAE,CAAA;IACjB,6EAA6E;IAC7E,IAAI,CAAC,EAAE,QAAQ,CAAA;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAA;IACX,yDAAyD;IACzD,KAAK,EAAE,YAAY,GAAG,SAAS,CAAA;CAChC;AAED,MAAM,WAAW,sBAAsB;IACrC,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,YAAY,CAAA;IACvB,sFAAsF;IACtF,OAAO,CAAC,EAAE,iBAAiB,CAAA;IAC3B,oDAAoD;IACpD,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACtC;AAED,MAAM,WAAW,OAAO;IACtB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAAA;IAC1C,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;IACzB,4CAA4C;IAC5C,IAAI,IAAI,MAAM,EAAE,CAAA;IAChB,kFAAkF;IAClF,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,IAAI,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAA;IAC1D,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;IAC5B,KAAK,IAAI,IAAI,CAAA;IACb,0FAA0F;IAC1F,QAAQ,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAA;IAClD,sGAAsG;IACtG,KAAK,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAA;IAC7C,SAAS,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,IAAI,GAAG,MAAM,IAAI,CAAA;IAChE,iEAAiE;IACjE,QAAQ,CAAC,OAAO,CAAC,EAAE,sBAAsB,GAAG,YAAY,CAAA;CACzD;AAiBD,6CAA6C;AAC7C,wBAAgB,aAAa,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,GAAG,YAAY,CAAC,GAAG,OAAO,CAyD1F;AAuCD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,GAAG,YAAY,CAAC,GAAG,OAAO,CAIvF;AAED,2FAA2F;AAC3F,wBAAgB,iBAAiB,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS,CAGzE;AAKD,2DAA2D;AAC3D,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC,CAE9F;AAED,mDAAmD;AACnD,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAG/F"}