@brett_lamy/docstream 1.3.0 → 1.4.0

package/dist/gitbook/ast.d.ts

@@ -0,0 +1,506 @@
+export type HintStyle = "info" | "success" | "warning" | "danger";
+/**
+ * Formatting every inline carries — text runs, chips and inline images alike, so emphasis and links can span
+ * them (`**ask @brett**`, `*see ![i](s)*`, `[![badge](b.svg)](url)`) — plus how the source spelled it.
+ */
+export interface InlineMarks {
+    bold?: boolean;
+    italic?: boolean;
+    strike?: boolean;
+    link?: string;
+    /**
+     * The link sits inside the emphasis (`**[x](url)**`) rather than around it
+     * (`[**x**](url)`, the default). Kept so the source round-trips byte-for-byte.
+     */
+    linkInner?: true;
+    /**
+     * How the source spelled this inline's formatting, outermost → innermost, when that differs from the default
+     * output (`_italic_`, `**bold**`, `~~strike~~`, link around its emphasis, bare autolinks). Each entry is an
+     * emphasis marker, or a link form (see {@link LinkForm}). E.g. `**_x_**` → `["**", "_"]`, `***x***` →
+     * `["*", "**"]`, `*x*` → `["*"]`, `*a *b* c*` → `["*", "*"]` for `b`.
+     *
+     * A hint only — the boolean marks and `link` stay authoritative: entries for marks the run no longer has are
+     * ignored, marks it has without an entry get the default spelling and position. Absent on runs that
+     * serialize the default way and on programmatically created nodes.
+     */
+    delims?: InlineDelimiter[];
+    /** The link's title as written between the quotes: `[x](url "title")`. */
+    linkTitle?: string;
+    /**
+     * The reference label of a reference-style link, as written: `ref` for `[text][ref]`, and the link text
+     * for the collapsed `[text][]` and shortcut `[text]` forms.
+     */
+    linkRef?: string;
+    /** The opening tag of an inline HTML link as written (`<a href="…" target="_blank">`). */
+    linkTag?: string;
+    /** The closing tag of an inline HTML link, when not `</a>` (`</A>`). */
+    linkTagEnd?: string;
+    /**
+     * Link identity: set on the runs of a link that directly follows another link to the same target
+     * (`[a](u)[b](u)`), so the two stay distinct instead of merging into one. Runs of one link share it.
+     */
+    linkId?: number;
+}
+export interface TextNode extends InlineMarks {
+    type: "text";
+    text: string;
+    code?: boolean;
+    /**
+     * The source wrote every character of this run backslash-escaped (`snake\_case` → `snake`, `_` escaped,
+     * `case`). Only ASCII punctuation can be escaped. Kept so author escapes survive even where they aren't
+     * needed; the text itself is the literal characters.
+     */
+    escaped?: true;
+    /**
+     * Code span in a GFM table cell: offsets (in `text`) of the `|` characters the source wrote bare instead
+     * of as `\|`. Serialization escapes every other pipe.
+     */
+    barePipes?: number[];
+    /** A code span's backtick count as written, when longer than serialization needs (```` ```x``` ````). */
+    ticks?: number;
+}
+/** An emphasis marker as written in the source. */
+export type EmphasisDelimiter = "**" | "__" | "*" | "_" | "~~";
+/**
+ * How a link is written: `"link"` `[x](url)`, `"<>"` `<url>`, `"url"` a bare autolink, `"ref"` `[x][label]`,
+ * `"collapsed"` `[x][]`, `"shortcut"` `[x]` (the last three resolved through a `[label]: url` definition),
+ * `"html"` `<a href="url">x</a>`.
+ */
+export type LinkForm = "link" | "<>" | "url" | "ref" | "collapsed" | "shortcut" | "html";
+/** An entry of {@link InlineMarks.delims}: an emphasis marker or a link form. */
+export type InlineDelimiter = EmphasisDelimiter | LinkForm;
+/**
+ * Inline image: `![alt](src "title")` (`syntax: "markdown"`), or HTML `<img …>` / `<a href><img …></a>`
+ * (GitHub README badge style, the default).
+ *
+ * `link` without a link form in `delims` is the HTML `<a href>` around the `<img>`; with one
+ * (`[![a](s)](url)`) it is an ordinary link mark that may span neighbouring text.
+ */
+export interface InlineImageNode extends InlineMarks {
+    type: "image";
+    src: string;
+    alt?: string;
+    width?: string;
+    height?: string;
+    /** `![alt](src "title")`'s title, as written between the quotes. */
+    title?: string;
+    /** Written as Markdown `![alt](src)`. Absent: HTML `<img>`. */
+    syntax?: "markdown";
+    /**
+     * A Markdown image whose source comes from a definition: `![alt][label]` (`"ref"`), `![alt][]`
+     * (`"collapsed"`) or `![alt]` (`"shortcut"`), with `srcRef` the label as written.
+     */
+    srcForm?: "ref" | "collapsed" | "shortcut";
+    srcRef?: string;
+    /**
+     * The HTML as written (`<img …>`, or `<a href><img …></a>` for a linked image). Serialization reuses it
+     * while it still says the same src / alt / width / height / link; otherwise it writes fresh HTML.
+     */
+    html?: string;
+}
+export type ReferenceKind = "mention" | "tag" | "codebase" | "citation";
+/**
+ * Inline reference chip: `@mention`, `#tag`, or footnote-style citation `[^id]`.
+ * `id` carries no sigil. Citations resolve `url`/`label` from their
+ * `[^id]: url "Label"` definition at parse time when one exists.
+ *
+ * The inherited `link` is a link *around* the chip (`[@brett](url)`); `url` is the citation's target.
+ */
+export interface ReferenceNode extends InlineMarks {
+    type: "reference";
+    kind: ReferenceKind;
+    id: string;
+    url?: string;
+    label?: string;
+}
+/** A footnote citation definition (`[^id]: url "Label"`), collected doc-level. */
+export interface CitationDef {
+    id: string;
+    url: string;
+    label?: string;
+}
+export type Inline = TextNode | InlineImageNode | ReferenceNode;
+/**
+ * Layout the source used around a block, recorded only where it differs from the serializer's default so
+ * pages round-trip byte-for-byte.
+ */
+export interface BlockSpacing {
+    /**
+     * Blank lines before this block (or tab / step / column / update / list item): by default 1 between
+     * siblings and 0 before the first child of a container (1 after an expandable's `<summary>`).
+     */
+    gap?: number;
+    /** Those blank lines as written, when some hold whitespace. */
+    blanks?: string[];
+}
+/** A `{% tag %}` container's opening and closing lines as written, reused while they still say the same. */
+export interface TagLines {
+    /** The opening tag line, when not the one serialization writes (quote style, spacing, extra attributes). */
+    opening?: string;
+    /** The closing tag line, when not the canonical `{% endtag %}` ("" when the input ended first). */
+    closing?: string;
+}
+/** A block's source lines as written, where they aren't what serialization writes; reused while they still parse to the same block. */
+export interface RawSource {
+    raw?: string;
+}
+/** Spacing inside a container, before its closing line. */
+export interface ContainerSpacing extends BlockSpacing {
+    /** Blank lines between the last child and the closing tag (default 0; 1 in an expandable). */
+    gapEnd?: number;
+}
+export interface ParagraphNode extends BlockSpacing {
+    type: "paragraph";
+    children: Inline[];
+    /** Whitespace before the paragraph's first line, as written (continuation lines keep theirs in the text). */
+    indent?: string;
+}
+export interface HeadingNode extends BlockSpacing {
+    type: "heading";
+    level: 1 | 2 | 3 | 4 | 5 | 6;
+    children: Inline[];
+    /** A setext heading's underline as written (`===`, `---`); absent for `#` headings. */
+    setext?: string;
+}
+export interface CodeBlockNode extends BlockSpacing {
+    type: "code";
+    language: string | null;
+    title: string | null;
+    /**
+     * Show line numbers. Defaults (when the fence doesn't say) to on for titled fences and
+     * off for untitled ones; `lineNumbers="true"` / `"false"` overrides.
+     */
+    lineNumbers: boolean;
+    /**
+     * The source wrote `lineNumbers` (or `showLineNumbers`) explicitly: the serializer keeps
+     * the attribute even when it matches the default, so pages round-trip byte-for-byte.
+     */
+    lineNumbersExplicit?: boolean;
+    code: string;
+    /** Run a React/JSX/TSX entry file in the optional almost-node preview. */
+    live?: boolean;
+    /** Project-relative entry file used by a live preview. */
+    entry?: string | null;
+    /** Source lines visible before an expandable code preview is opened. */
+    collapsedCodeLines?: number;
+    /** Maximum source lines visible before expanded code scrolls. */
+    expandedCodeLines?: number;
+    /** The opening fence as written when not ```` ``` ```` (`~~~`, ````` ```` `````). */
+    fence?: string;
+    /** The info string as written after the fence, when it isn't the one serialization writes. */
+    info?: string;
+    /** The closing fence line as written, when it isn't the opening fence ("" when the input ended first). */
+    closingFence?: string;
+    /** An indented (four-space) code block rather than a fence. */
+    indented?: true;
+    /** The block as written when it isn't a plain fence (a `{% code %}` wrapper), reused while it still says the same. */
+    raw?: string;
+}
+export interface HintNode extends ContainerSpacing, TagLines {
+    type: "hint";
+    style: HintStyle;
+    children: Block[];
+}
+export interface TabNode extends ContainerSpacing, TagLines {
+    type: "tab";
+    title: string;
+    children: Block[];
+}
+export interface TabsNode extends ContainerSpacing, TagLines {
+    type: "tabs";
+    tabs: TabNode[];
+    /**
+     * Sync group (`{% tabs sync="pm" %}`). Every tab set with the same key follows
+     * the reader's last choice (matched by tab title), remembered across pages.
+     */
+    sync?: string;
+    /**
+     * Section title (`{% tabs title="Installation" %}`). The tab set renders as a
+     * section: this title as a heading (with an anchor id), the tab switch as pill
+     * tabs right-aligned in that header, and the active tab's blocks below.
+     */
+    title?: string;
+    /** Heading level of `title` (`level="3"`). Defaults to 2. */
+    level?: 2 | 3 | 4;
+}
+export type PackageManager = "npm" | "pnpm" | "yarn" | "bun";
+/**
+ * A package-manager command box: `{% command %}npm install x{% endcommand %}`.
+ * The author writes one canonical npm / npx command; renderers derive the pnpm,
+ * yarn and bun forms (see `packageManagerCommands`), unless overridden per
+ * manager (`pnpm="…"`). The reader's manager is synced page-wide (and across
+ * pages) under `sync` — `"pm"` by default, the same key install `{% tabs %}` use.
+ */
+export interface CommandNode extends BlockSpacing, RawSource {
+    type: "command";
+    /** The npm / npx command (may span lines). */
+    command: string;
+    /** Explicit commands for other managers, used verbatim instead of the derived ones. */
+    overrides?: Partial<Record<Exclude<PackageManager, "npm">, string>>;
+    /** Sync key. Omitted means `"pm"`. */
+    sync?: string;
+}
+export interface ExpandableNode extends ContainerSpacing {
+    /** The closing line, when not `</details>`. */
+    closing?: string;
+    type: "expandable";
+    summary: string;
+    children: Block[];
+    /**
+     * The lines from `<details>` through `</summary>` as written, when not `<details>`, a blank line,
+     * `<summary>…</summary>`. Reused while they still say the same summary.
+     */
+    opening?: string;
+}
+export interface StepNode extends ContainerSpacing, TagLines {
+    type: "step";
+    title: string;
+    children: Block[];
+    /**
+     * The title heading as written (and any blank lines before it), when not `### title` — `## Title`,
+     * `### **Bold** title`. Reused while it still gives the same title.
+     */
+    heading?: string;
+}
+export interface StepperNode extends ContainerSpacing, TagLines {
+    type: "stepper";
+    steps: StepNode[];
+}
+export interface EmbedNode extends BlockSpacing {
+    type: "embed";
+    url: string;
+    title?: string;
+    autoplay?: boolean;
+    loop?: boolean;
+    muted?: boolean;
+    controls?: boolean;
+    poster?: string;
+    /** The tag as written (with its `{% endembed %}`), reused while it still says the same. */
+    raw?: string;
+}
+export interface ContentRefNode extends BlockSpacing {
+    type: "content-ref";
+    url: string;
+    children: Inline[];
+    /** The block as written when it isn't the canonical `{% content-ref %}` (a `{% file %}` tag), reused while it still says the same. */
+    raw?: string;
+}
+export type SourceReferenceKind = "component" | "story";
+/**
+ * A reference to an export in a real source file. The source file remains the
+ * authority; Markdown only stores the composition and presentation metadata.
+ */
+export interface SourceRefNode extends BlockSpacing {
+    type: "source-ref";
+    /** Name of the directory mounted by the Docstream Vite plugin. */
+    mount: string;
+    /** POSIX-style path relative to the mounted source directory. */
+    path: string;
+    /** Named export to render. Defaults to `default`. */
+    exportName: string;
+    kind: SourceReferenceKind;
+    title?: string;
+    /** The tag as written (`{% component … %}`, an end tag), reused while it still says the same. */
+    raw?: string;
+}
+export type DemoLayout = "auto" | "single" | "multi";
+export type DemoViewport = "desktop" | "tablet" | "phone";
+export interface DemoVariantOption {
+    id: string;
+    label: string;
+}
+/** One source file carried inline by a `{% demo %}` block (a titled fence). */
+export interface DemoInlineFile {
+    /** Path relative to the demo folder, from the fence's `title` (`index.tsx`, `parts/Card.tsx`). */
+    path: string;
+    content: string;
+    /** The fence's info-string language, when it has one. */
+    language?: string;
+}
+/**
+ * A live demo: `{% demo src="<page>/<example>" %}`. With a host `DemoResolver`
+ * that knows `src`, the example folder is the authority for the component, its
+ * source files and its defaults; attributes here override the folder's
+ * `meta.json` field by field (tag attribute first, then `meta.json`, then the built-in
+ * default) — including the look attributes `status`, `bleed`, `className`, `surface` and
+ * `variantsWidth`, which Copy page writes so the block renders the same without the resolver.
+ * The block form carries the files inline so the Markdown renders anywhere, resolver
+ * or not:
+ *
+ *     {% demo src="composer/scroll-fab" title="Scroll → FAB" %}
+ *     ```tsx title="index.tsx"
+ *     …
+ *     ```
+ *     {% enddemo %}
+ */
+export interface DemoNode extends BlockSpacing, RawSource {
+    type: "demo";
+    /** `<page>/<example>` folder id understood by the host's resolver. */
+    src: string;
+    title?: string;
+    description?: string;
+    /** Preview height, kept verbatim (`"420"`, `"60vh"`, `"auto"`). */
+    height?: string;
+    layout?: DemoLayout;
+    /** `variants="full:Full,compact:Compact"`. */
+    variants?: DemoVariantOption[];
+    /** Initial preview viewport for the multi-file viewer. */
+    viewport?: DemoViewport;
+    /** Entry file among the inline files (`entry="App.tsx"`). Defaults to the first file. */
+    entry?: string;
+    /** Short status shown in the demo header (`status="Live"`). */
+    status?: string;
+    /** Drop the padded preview surface (`bleed="true"`) for demos with their own full-bleed frame. */
+    bleed?: boolean;
+    /** Extra class on the preview canvas (`className="brand-surface"`). */
+    className?: string;
+    /**
+     * Inline style for the preview canvas as CSS declarations, kept verbatim:
+     * `surface="background: var(--brand-50); --demo-gap: 12px"`.
+     */
+    surface?: string;
+    /** Width of the variant switch, kept verbatim (`"240"`, `"16rem"`). */
+    variantsWidth?: string;
+    /** Files carried inline by the block form, in document order. */
+    files?: DemoInlineFile[];
+    /**
+     * Set while streaming when the block's `{% enddemo %}` has not arrived yet: the
+     * files may still be growing, so renderers show code but hold off running it.
+     * Never serialized.
+     */
+    open?: true;
+}
+export interface ColumnNode extends ContainerSpacing, TagLines {
+    type: "column";
+    children: Block[];
+}
+export interface ColumnsNode extends ContainerSpacing, TagLines {
+    type: "columns";
+    columns: ColumnNode[];
+}
+export interface FigureNode extends BlockSpacing {
+    type: "figure";
+    src: string;
+    alt: string;
+    caption: string;
+    /** `![alt](src "title")`'s title. */
+    title?: string;
+    /**
+     * The line(s) as written (`![alt](src)`, `<img …>`, `<figure>…</figure>`). Serialization reuses them while
+     * they still parse to the same src / alt / caption / title; otherwise it writes a `<figure>`.
+     */
+    raw?: string;
+}
+export interface ListItemNode extends ContainerSpacing {
+    type: "listItem";
+    children: Block[];
+    checked?: boolean;
+    /** The item's marker as written (`*`, `3.`), when it isn't the one its list's pattern gives it. */
+    marker?: string;
+    /** Spaces between the marker and the content (default 1). */
+    pad?: number;
+    /** Indent of the item's continuation lines, relative to its marker (default 2). */
+    indent?: number;
+    /** A checked task written `[X]`. */
+    checkMark?: "X";
+}
+export interface ListNode extends BlockSpacing {
+    type: "list";
+    ordered: boolean;
+    task: boolean;
+    items: ListItemNode[];
+    /** Bullet marker of an unordered list (default `-`). */
+    bullet?: "*" | "+";
+    /** Number of an ordered list's first item (default 1). */
+    start?: number;
+    /** Ordered-list delimiter (default `.`). */
+    delimiter?: ")";
+    /** Whitespace before the list's markers, as written. */
+    indent?: string;
+}
+export interface BlockquoteNode extends ContainerSpacing {
+    type: "blockquote";
+    children: Block[];
+    /** Each line's `>` prefix as written (indent, spacing), when not `> ` (`>` on empty lines). */
+    markers?: string[];
+}
+export interface DividerNode extends BlockSpacing {
+    type: "divider";
+    /** The rule as written when not `---` (`***`, `___`, `-----`). */
+    marker?: string;
+}
+export interface TableNode extends BlockSpacing {
+    type: "table";
+    header: Inline[][];
+    rows: Inline[][][];
+    /** GitBook table view, e.g. "cards" for <table data-view="cards"> */
+    view?: string;
+    /** Written as an HTML `<table>` (without a view). */
+    html?: true;
+    /** Column alignment from the delimiter row (`:---`, `:---:`, `---:`); null = default. */
+    align?: Array<"left" | "center" | "right" | null>;
+    /** The delimiter row as written (`|:--|--:|`), reused while it still says the same `align`. */
+    delimiterRow?: string;
+    /** An HTML table as written, reused while it still parses to the same cells. */
+    raw?: string;
+    /** GFM rows as written (header first), each reused while it still parses to the same cells. */
+    rawRows?: string[];
+}
+export interface UpdateNode extends ContainerSpacing, TagLines {
+    type: "update";
+    date: string;
+    children: Block[];
+}
+export interface UpdatesNode extends ContainerSpacing, TagLines {
+    type: "updates";
+    format: string | null;
+    updates: UpdateNode[];
+}
+export interface OpenApiOperationNode extends BlockSpacing, RawSource {
+    type: "openapi-operation";
+    spec: string;
+    path: string;
+    method: string;
+    specUrl: string;
+    label: string;
+}
+/**
+ * A reference-style link definition, `[label]: url "title"`, where the source put it. Links written
+ * `[text][label]`, `[text][]` or `[label]` resolve through it.
+ */
+export interface DefinitionNode extends BlockSpacing {
+    type: "definition";
+    /** The label as written (matched case-insensitively). */
+    label: string;
+    url: string;
+    title?: string;
+    /** The line as written, reused while it still says the same label / url / title. */
+    raw?: string;
+}
+/**
+ * A line docstream keeps verbatim but doesn't model — an unknown `{% tag %}` (GitBook tags from other
+ * integrations). Renders nothing; serialized as written.
+ */
+export interface RawNode extends BlockSpacing {
+    type: "raw";
+    markdown: string;
+}
+export interface MathNode extends BlockSpacing, RawSource {
+    type: "math";
+    formula: string;
+}
+export type Block = ParagraphNode | HeadingNode | CodeBlockNode | HintNode | TabsNode | CommandNode | ExpandableNode | StepperNode | EmbedNode | ContentRefNode | SourceRefNode | DemoNode | ColumnsNode | FigureNode | ListNode | BlockquoteNode | DividerNode | TableNode | MathNode | UpdatesNode | OpenApiOperationNode | DefinitionNode | RawNode;
+export interface DocumentNode {
+    type: "doc";
+    children: Block[];
+    /** Footnote citation definitions, in definition order. */
+    citations?: CitationDef[];
+    /** Blank lines before the trailing footnote definitions (default 1). */
+    citationsGap?: number;
+    /** Line ending of the source when it used `\r\n` throughout. */
+    lineEnding?: "\r\n";
+    /** What the source ended with after its last line, when more than a single newline (`"\n\n"`). */
+    end?: string;
+}
+export declare const text: (t: string, marks?: Partial<Omit<TextNode, "type" | "text">>) => TextNode;
+//# sourceMappingURL=ast.d.ts.map

package/dist/gitbook/ast.d.ts.map

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

package/dist/gitbook/ast.js

@@ -0,0 +1,8 @@
+// AST for GitBook-flavored markdown. This is the single source of truth that
+// the parser, serializer, TipTap converters, and docs renderer all share.
+export const text = (t, marks = {}) => ({
+    type: "text",
+    text: t,
+    ...marks,
+});
+//# sourceMappingURL=ast.js.map

package/dist/gitbook/ast.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ast.js","sourceRoot":"","sources":["../../src/gitbook/ast.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,0EAA0E;AAikB1E,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,CAAS,EAAE,QAAkD,EAAE,EAAY,EAAE,CAAC,CAAC;IAClG,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,CAAC;IACP,GAAG,KAAK;CACT,CAAC,CAAA"}

package/dist/gitbook/attrs.d.ts

@@ -0,0 +1,14 @@
+/** Escape one attribute value for a double-quoted `name="…"` pair. */
+export declare function escapeAttr(value: string): string;
+/** Undo `escapeAttr`. */
+export declare function unescapeAttr(raw: string): string;
+/** ` name="value"` with the value escaped (leading space included). */
+export declare function attr(name: string, value: string | number | boolean): string;
+/** Every `name="value"` pair in `raw` (escapes honoured, values unescaped). */
+export declare function parseAttrs(raw: string | undefined): Record<string, string>;
+/**
+ * The attribute part of a `{% name … %}` tag, as a regex source: anything up to the
+ * closing `%}` (a lone `%` is fine; `%}` inside a value is always escaped as `%\}`).
+ */
+export declare const TAG_ATTRS: string;
+//# sourceMappingURL=attrs.d.ts.map

package/dist/gitbook/attrs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attrs.d.ts","sourceRoot":"","sources":["../../src/gitbook/attrs.ts"],"names":[],"mappings":"AASA,sEAAsE;AACtE,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,yBAAyB;AACzB,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,uEAAuE;AACvE,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAE3E;AAED,+EAA+E;AAC/E,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAO1E;AAED;;;GAGG;AACH,eAAO,MAAM,SAAS,QAAmC,CAAA"}

package/dist/gitbook/attrs.js

@@ -0,0 +1,36 @@
+/*
+ * Tag and fence attribute values (`{% demo title="…" %}`, ```` ```ts title="…" ````).
+ *
+ * Values are double-quoted. On serialize a backslash becomes `\\`, a double quote `\"`,
+ * and the tag terminator `%}` becomes `%\}` — so a value can never end its tag early or
+ * truncate at a quote. On parse `\\`, `\"` and `\}` are unescaped; any other backslash is
+ * kept literally (so `C:\temp` written by hand still reads as written).
+ */
+/** Escape one attribute value for a double-quoted `name="…"` pair. */
+export function escapeAttr(value) {
+    return value.replace(/\\/g, "\\\\").replace(/"/g, '\\"').replace(/%\}/g, "%\\}");
+}
+/** Undo `escapeAttr`. */
+export function unescapeAttr(raw) {
+    return raw.replace(/\\(["\\}])/g, "$1");
+}
+/** ` name="value"` with the value escaped (leading space included). */
+export function attr(name, value) {
+    return ` ${name}="${escapeAttr(String(value))}"`;
+}
+/** Every `name="value"` pair in `raw` (escapes honoured, values unescaped). */
+export function parseAttrs(raw) {
+    const attrs = {};
+    if (!raw)
+        return attrs;
+    for (const m of raw.matchAll(/([\w-]+)="((?:[^"\\]|\\.)*)"/g)) {
+        attrs[m[1]] = unescapeAttr(m[2]);
+    }
+    return attrs;
+}
+/**
+ * The attribute part of a `{% name … %}` tag, as a regex source: anything up to the
+ * closing `%}` (a lone `%` is fine; `%}` inside a value is always escaped as `%\}`).
+ */
+export const TAG_ATTRS = String.raw `(?:[^%\n]|%(?!\}))*?`;
+//# sourceMappingURL=attrs.js.map

package/dist/gitbook/attrs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attrs.js","sourceRoot":"","sources":["../../src/gitbook/attrs.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,sEAAsE;AACtE,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;AAClF,CAAC;AAED,yBAAyB;AACzB,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,OAAO,GAAG,CAAC,OAAO,CAAC,aAAa,EAAE,IAAI,CAAC,CAAA;AACzC,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,IAAI,CAAC,IAAY,EAAE,KAAgC;IACjE,OAAO,IAAI,IAAI,KAAK,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,CAAA;AAClD,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,UAAU,CAAC,GAAuB;IAChD,MAAM,KAAK,GAA2B,EAAE,CAAA;IACxC,IAAI,CAAC,GAAG;QAAE,OAAO,KAAK,CAAA;IACtB,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,+BAA+B,CAAC,EAAE,CAAC;QAC9D,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IAClC,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,CAAA,sBAAsB,CAAA"}

package/dist/gitbook/flatten.d.ts

@@ -0,0 +1,14 @@
+import type { Block, DocumentNode } from "./ast.js";
+/**
+ * docstream-only presentation blocks as plain Markdown, for LLM prompts and tools that don't
+ * know docstream (`resolveDemosToMarkdown(…, { format: "plain" })`):
+ *
+ * - `{% command %}` → a ```` ```sh ```` fence with the npm command;
+ * - titled `{% tabs title="Installation" %}` → a `## Installation` heading, then each tab as a
+ *   bold label followed by its blocks.
+ *
+ * Everything else is kept (GitBook tags included — they're GitBook, not docstream).
+ */
+export declare function flattenForPlainMarkdown(doc: DocumentNode): DocumentNode;
+export declare function flattenBlocks(blocks: Block[]): Block[];
+//# sourceMappingURL=flatten.d.ts.map

package/dist/gitbook/flatten.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flatten.d.ts","sourceRoot":"","sources":["../../src/gitbook/flatten.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAA;AAGhD;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,YAAY,GAAG,YAAY,CAEvE;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,EAAE,CA6BtD"}

package/dist/gitbook/flatten.js

@@ -0,0 +1,45 @@
+import { text } from "./ast.js";
+/**
+ * docstream-only presentation blocks as plain Markdown, for LLM prompts and tools that don't
+ * know docstream (`resolveDemosToMarkdown(…, { format: "plain" })`):
+ *
+ * - `{% command %}` → a ```` ```sh ```` fence with the npm command;
+ * - titled `{% tabs title="Installation" %}` → a `## Installation` heading, then each tab as a
+ *   bold label followed by its blocks.
+ *
+ * Everything else is kept (GitBook tags included — they're GitBook, not docstream).
+ */
+export function flattenForPlainMarkdown(doc) {
+    return { ...doc, children: flattenBlocks(doc.children) };
+}
+export function flattenBlocks(blocks) {
+    return blocks.flatMap((b) => {
+        switch (b.type) {
+            case "command":
+                return [{ type: "code", language: "sh", title: null, lineNumbers: false, code: b.command }];
+            case "tabs":
+                if (b.title) {
+                    return [
+                        { type: "heading", level: b.level ?? 2, children: [text(b.title)] },
+                        ...b.tabs.flatMap((t) => [{ type: "paragraph", children: [text(t.title, { bold: true })] }, ...flattenBlocks(t.children)]),
+                    ];
+                }
+                return [{ ...b, tabs: b.tabs.map((t) => ({ ...t, children: flattenBlocks(t.children) })) }];
+            case "hint":
+            case "expandable":
+            case "blockquote":
+                return [{ ...b, children: flattenBlocks(b.children) }];
+            case "stepper":
+                return [{ ...b, steps: b.steps.map((s) => ({ ...s, children: flattenBlocks(s.children) })) }];
+            case "columns":
+                return [{ ...b, columns: b.columns.map((c) => ({ ...c, children: flattenBlocks(c.children) })) }];
+            case "list":
+                return [{ ...b, items: b.items.map((item) => ({ ...item, children: flattenBlocks(item.children) })) }];
+            case "updates":
+                return [{ ...b, updates: b.updates.map((u) => ({ ...u, children: flattenBlocks(u.children) })) }];
+            default:
+                return [b];
+        }
+    });
+}
+//# sourceMappingURL=flatten.js.map