@brett_lamy/docstream 1.3.0 → 1.4.0

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/docs/CollapsibleCode.d.ts

@@ -0,0 +1,14 @@
+export interface CollapsibleCodeProps {
+    code: string;
+    language: string | null;
+    /** Lines visible while collapsed. Defaults to 3. */
+    collapsedLines?: number;
+    /** Lines visible when expanded before the panel scrolls. Defaults to 30. */
+    expandedLines?: number;
+    /** Show a copy button in the panel corner. Defaults to true. */
+    copy?: boolean;
+    copyLabel?: string;
+}
+/** The line-numbered code panel under a demo: a few lines, then "View Code" to expand. */
+export declare function CollapsibleCode({ code, language, collapsedLines, expandedLines, copy, copyLabel }: CollapsibleCodeProps): import("react").JSX.Element;
+//# sourceMappingURL=CollapsibleCode.d.ts.map

package/dist/docs/CollapsibleCode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CollapsibleCode.d.ts","sourceRoot":"","sources":["../../src/docs/CollapsibleCode.tsx"],"names":[],"mappings":"AAIA,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,oDAAoD;IACpD,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,4EAA4E;IAC5E,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,gEAAgE;IAChE,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAMD,0FAA0F;AAC1F,wBAAgB,eAAe,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,cAAc,EAAE,aAAa,EAAE,IAAW,EAAE,SAAS,EAAE,EAAE,oBAAoB,+BAgC9H"}

package/dist/docs/CollapsibleCode.js

@@ -0,0 +1,19 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useId, useState } from "react";
+import { HighlightedCode } from "./HighlightedCode.js";
+import { CopyButton } from "./copy.js";
+function positiveLineCount(value, fallback) {
+    return value !== undefined && Number.isFinite(value) && value > 0 ? Math.floor(value) : fallback;
+}
+/** The line-numbered code panel under a demo: a few lines, then "View Code" to expand. */
+export function CollapsibleCode({ code, language, collapsedLines, expandedLines, copy = true, copyLabel }) {
+    const [expanded, setExpanded] = useState(false);
+    const panelId = useId();
+    const collapsed = positiveLineCount(collapsedLines, 3);
+    const expandedCount = Math.max(collapsed, positiveLineCount(expandedLines, 30));
+    const total = code.split("\n").length;
+    const needsToggle = total > collapsed;
+    const isOpen = expanded || !needsToggle;
+    return (_jsxs("div", { className: "docs-react-demo-code", "data-expanded": isOpen || undefined, children: [_jsx("pre", { id: panelId, className: isOpen ? "docs-react-demo-code-body docs-react-demo-code-body-expanded" : "docs-react-demo-code-body", "data-toggle": needsToggle || undefined, style: { "--docs-react-demo-code-lines": isOpen ? expandedCount : collapsed }, children: _jsx(HighlightedCode, { code: code, language: language, lineNumbers: true }) }), copy ? _jsx(CopyButton, { text: code, label: copyLabel, className: "docs-react-demo-code-copy" }) : null, needsToggle ? (_jsx("button", { type: "button", className: "docs-react-demo-code-toggle", "aria-controls": panelId, "aria-expanded": expanded, onClick: () => setExpanded((value) => !value), children: expanded ? "Hide Code" : "View Code" })) : null] }));
+}
+//# sourceMappingURL=CollapsibleCode.js.map

package/dist/docs/CollapsibleCode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CollapsibleCode.js","sourceRoot":"","sources":["../../src/docs/CollapsibleCode.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAsB,MAAM,OAAO,CAAA;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAA;AAcnC,SAAS,iBAAiB,CAAC,KAAyB,EAAE,QAAgB;IACpE,OAAO,KAAK,KAAK,SAAS,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAA;AAClG,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,eAAe,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,cAAc,EAAE,aAAa,EAAE,IAAI,GAAG,IAAI,EAAE,SAAS,EAAwB;IAC7H,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAA;IAC/C,MAAM,OAAO,GAAG,KAAK,EAAE,CAAA;IACvB,MAAM,SAAS,GAAG,iBAAiB,CAAC,cAAc,EAAE,CAAC,CAAC,CAAA;IACtD,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,iBAAiB,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC,CAAA;IAC/E,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAA;IACrC,MAAM,WAAW,GAAG,KAAK,GAAG,SAAS,CAAA;IACrC,MAAM,MAAM,GAAG,QAAQ,IAAI,CAAC,WAAW,CAAA;IACvC,OAAO,CACL,eAAK,SAAS,EAAC,sBAAsB,mBAAgB,MAAM,IAAI,SAAS,aACtE,cACE,EAAE,EAAE,OAAO,EACX,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,8DAA8D,CAAC,CAAC,CAAC,2BAA2B,iBACnG,WAAW,IAAI,SAAS,EACrC,KAAK,EAAE,EAAE,8BAA8B,EAAE,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,EAAmB,YAE9F,KAAC,eAAe,IAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,SAAG,GAC3D,EACL,IAAI,CAAC,CAAC,CAAC,KAAC,UAAU,IAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAC,2BAA2B,GAAG,CAAC,CAAC,CAAC,IAAI,EAChG,WAAW,CAAC,CAAC,CAAC,CACb,iBACE,IAAI,EAAC,QAAQ,EACb,SAAS,EAAC,6BAA6B,mBACxB,OAAO,mBACP,QAAQ,EACvB,OAAO,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,YAE5C,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,WAAW,GAC9B,CACV,CAAC,CAAC,CAAC,IAAI,IACJ,CACP,CAAA;AACH,CAAC"}

package/dist/docs/DocsRenderer.d.ts

@@ -0,0 +1,49 @@
+import { type ReactNode } from "react";
+import type { DocumentNode, SourceRefNode } from "../gitbook/ast.js";
+import type { DemoResolver, InlineDemoRuntime } from "../demo/types.js";
+import { type DocPageActionsOptions } from "./PageActions.js";
+export interface LivePreviewProps {
+    files: Record<string, string>;
+    entry: string;
+    title: string;
+    collapsedCodeLines?: number;
+    expandedCodeLines?: number;
+}
+export type LivePreviewRenderer = (props: LivePreviewProps) => ReactNode;
+export type SourceReferenceRenderer = (reference: SourceRefNode) => ReactNode;
+interface Renderers {
+    liveRenderer?: LivePreviewRenderer;
+    sourceRenderer?: SourceReferenceRenderer;
+}
+export interface DocRenderOptions {
+    /** Resolves `{% demo %}` blocks. Provided through context, so nested renderers inherit it. */
+    demoResolver?: DemoResolver;
+    /**
+     * Runs the Preview of `{% demo %}` blocks that carry their files inline and have no
+     * 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;
+    /** Extra npm dependencies inline demos may import (`{ "@brett_lamy/ui": "^1.2.0" }`). */
+    demoDependencies?: Record<string, string>;
+    /**
+     * Render "Copy page ▾" (Copy / View as Markdown, Open in ChatGPT / Claude) above the content.
+     * `true` uses the defaults; an object passes options to `DocPageActions`.
+     */
+    pageActions?: boolean | DocPageActionsOptions;
+}
+export declare function PageActionsBar({ markdown, options }: {
+    markdown: string | (() => string);
+    options: boolean | DocPageActionsOptions | undefined;
+}): import("react").JSX.Element | null;
+export declare function MarkdownContent({ markdown, liveRenderer, sourceRenderer, demoResolver, demoRuntime, demoDependencies, pageActions, className, }: {
+    markdown: string;
+    className?: string;
+} & Renderers & DocRenderOptions): string | number | boolean | Iterable<ReactNode> | import("react").JSX.Element | null | undefined;
+export declare function DocsRenderer({ doc, liveRenderer, sourceRenderer, demoResolver, demoRuntime, demoDependencies, pageActions, markdown, }: {
+    doc: DocumentNode; /** Source for page actions; defaults to `serializeMarkdown(doc)`. */
+    markdown?: string;
+} & Renderers & DocRenderOptions): string | number | boolean | Iterable<ReactNode> | import("react").JSX.Element | null | undefined;
+export {};
+//# sourceMappingURL=DocsRenderer.d.ts.map

package/dist/docs/DocsRenderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DocsRenderer.d.ts","sourceRoot":"","sources":["../../src/docs/DocsRenderer.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAmD,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAYvF,OAAO,KAAK,EAAqC,YAAY,EAA0B,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAQ5H,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAGpE,OAAO,EAAkB,KAAK,qBAAqB,EAAE,MAAM,eAAe,CAAA;AAuC1E,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC7B,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED,MAAM,MAAM,mBAAmB,GAAG,CAAC,KAAK,EAAE,gBAAgB,KAAK,SAAS,CAAA;AAExE,MAAM,MAAM,uBAAuB,GAAG,CAAC,SAAS,EAAE,aAAa,KAAK,SAAS,CAAA;AAiE7E,UAAU,SAAS;IACjB,YAAY,CAAC,EAAE,mBAAmB,CAAA;IAClC,cAAc,CAAC,EAAE,uBAAuB,CAAA;CACzC;AA0bD,MAAM,WAAW,gBAAgB;IAC/B,8FAA8F;IAC9F,YAAY,CAAC,EAAE,YAAY,CAAA;IAC3B;;;;;OAKG;IACH,WAAW,CAAC,EAAE,iBAAiB,CAAA;IAC/B,yFAAyF;IACzF,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACzC;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,GAAG,qBAAqB,CAAA;CAC9C;AAyBD,wBAAgB,cAAc,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE;IAAE,QAAQ,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,CAAC;IAAC,OAAO,EAAE,OAAO,GAAG,qBAAqB,GAAG,SAAS,CAAA;CAAE,sCAOhJ;AAID,wBAAgB,eAAe,CAAC,EAC9B,QAAQ,EACR,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,WAAW,EACX,gBAAgB,EAChB,WAAW,EACX,SAAS,GACV,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,GAAG,gBAAgB,oGAUzE;AAED,wBAAgB,YAAY,CAAC,EAC3B,GAAG,EACH,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,WAAW,EACX,gBAAgB,EAChB,WAAW,EACX,QAAQ,GACT,EAAE;IAAE,GAAG,EAAE,YAAY,CAAC,CAAC,qEAAqE;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,GAAG,gBAAgB,oGAS/I"}