@commentray/render 0.2.0 → 0.3.1

package/dist/block-stretch-buffer-sync.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Applies `BufferingFlowSynchronizer` per stretch row (one shared sync id per `<tr>`). The shorter
+ * cell gets `padding-bottom` so the row matches the taller side—same contract as `BBBB` in core
+ * approval fixtures, recomputed when layout changes (Mermaid, wrap, viewport).
+ */
+export declare function applyBlockStretchRowBuffers(table: HTMLTableElement): void;
+export declare function dispatchCommentrayMermaidDone(): void;
+export type BlockStretchBufferSyncHandle = {
+    disconnect: () => void;
+};
+/**
+ * Schedules `applyBlockStretchRowBuffers` on viewport changes, table geometry changes, and after
+ * Mermaid finishes (see `dispatchCommentrayMermaidDone` / inline mermaid module).
+ */
+export declare function wireBlockStretchBufferSync(table: HTMLTableElement): BlockStretchBufferSyncHandle;
+//# sourceMappingURL=block-stretch-buffer-sync.d.ts.map

package/dist/block-stretch-buffer-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"block-stretch-buffer-sync.d.ts","sourceRoot":"","sources":["../src/block-stretch-buffer-sync.ts"],"names":[],"mappings":"AAkMA;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI,CASzE;AAED,wBAAgB,6BAA6B,IAAI,IAAI,CAEpD;AAED,MAAM,MAAM,4BAA4B,GAAG;IACzC,UAAU,EAAE,MAAM,IAAI,CAAC;CACxB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,gBAAgB,GAAG,4BAA4B,CAuEhG"}

package/dist/block-stretch-buffer-sync.js

@@ -0,0 +1,271 @@
+import { BufferingFlowSynchronizer, } from "@commentray/core/buffering-flow-synchronizer";
+/**
+ * Stretch layout uses **one** vertical scroll (`#shell.shell--stretch-rows`). Per logical row we
+ * materialize the core synchronizer’s `bufferBelow` / `bufferAbove` as **`padding-bottom`** /
+ * **`padding-top`** on the shorter `<td>`: the browser equivalent of approval grids’ `BBBB` fill so
+ * both columns share the same row height and scroll as a single surface (see
+ * `buffering-flow-synchronizer.approvals/`).
+ */
+const STRETCH_ROW_SELECTOR = "tbody tr.stretch-row[data-commentray-stretch-sync-id]";
+const MERMAID_DONE_EVENT = "commentray-mermaid-done";
+const synchronizer = new BufferingFlowSynchronizer();
+function roundCssPx(n) {
+    if (!Number.isFinite(n) || n <= 0)
+        return 0;
+    return Math.max(0, Math.round(n));
+}
+function asHTMLElement(el) {
+    return el;
+}
+/** `Node.ELEMENT_NODE` without relying on global `Node` (e.g. some Vitest environments). */
+const ELEMENT_NODE = 1;
+function readHeightFromDocInner(cell) {
+    const docInner = cell.querySelector(":scope .stretch-doc-inner");
+    if (docInner === null || docInner.nodeType !== ELEMENT_NODE)
+        return 0;
+    const hi = asHTMLElement(docInner);
+    const sh = hi.scrollHeight;
+    if (typeof sh === "number" && sh > 0)
+        return roundCssPx(sh);
+    const byRect = roundCssPx(hi.getBoundingClientRect().height);
+    if (byRect > 0)
+        return byRect;
+    return 0;
+}
+function readHeightFromCodeStack(cell) {
+    const stack = cell.querySelector(":scope .stretch-code-stack");
+    if (stack === null || stack.nodeType !== ELEMENT_NODE)
+        return 0;
+    const st = asHTMLElement(stack);
+    const sh = st.scrollHeight;
+    if (typeof sh === "number" && sh > 0)
+        return roundCssPx(sh);
+    const byRect = roundCssPx(st.getBoundingClientRect().height);
+    if (byRect > 0)
+        return byRect;
+    return 0;
+}
+function readHeightFromCodeLines(measure) {
+    const lines = measure.querySelectorAll(".code-line");
+    if (lines.length === 0)
+        return 0;
+    let top = Infinity;
+    let bottom = -Infinity;
+    for (const line of lines) {
+        const r = line.getBoundingClientRect();
+        top = Math.min(top, r.top);
+        bottom = Math.max(bottom, r.bottom);
+    }
+    if (bottom <= top || !Number.isFinite(top))
+        return 0;
+    const span = roundCssPx(bottom - top);
+    return span > 0 ? span : 0;
+}
+function readHeightFromGapMark(measure) {
+    const gapMark = measure.querySelector(".stretch-gap-mark");
+    if (gapMark === null || gapMark.nodeType !== ELEMENT_NODE)
+        return 0;
+    return roundCssPx(asHTMLElement(gapMark).getBoundingClientRect().height);
+}
+/**
+ * Table cells share the row’s used height, so `td.offsetHeight` is useless for slack. Prefer
+ * content roots (`.stretch-code-stack`, `.stretch-doc-inner`, gap `.code-line` spans) via
+ * geometry / `scrollHeight`, then fall back to the measure wrapper.
+ */
+function readCellIntrinsicHeightPx(cell) {
+    const hDoc = readHeightFromDocInner(cell);
+    if (hDoc > 0)
+        return hDoc;
+    const hStack = readHeightFromCodeStack(cell);
+    if (hStack > 0)
+        return hStack;
+    const measure = cell.querySelector(":scope > .stretch-cell-measure");
+    if (measure === null || measure.nodeType !== ELEMENT_NODE)
+        return roundCssPx(cell.offsetHeight);
+    const me = asHTMLElement(measure);
+    const linesSpan = readHeightFromCodeLines(me);
+    if (linesSpan > 0)
+        return linesSpan;
+    const gapH = readHeightFromGapMark(measure);
+    if (gapH > 0)
+        return gapH;
+    const wrapRect = roundCssPx(me.getBoundingClientRect().height);
+    if (wrapRect > 0)
+        return wrapRect;
+    return roundCssPx(me.offsetHeight);
+}
+function stretchRowsWithSyncId(table) {
+    return Array.from(table.querySelectorAll(STRETCH_ROW_SELECTOR)).filter((row) => (row.dataset.commentrayStretchSyncId?.trim() ?? "").length > 0);
+}
+function clearStretchRowPadding(codeTd, docTd) {
+    codeTd.style.paddingBottom = "";
+    docTd.style.paddingBottom = "";
+    codeTd.style.paddingTop = "";
+    docTd.style.paddingTop = "";
+}
+function applyStretchSyncPadding(codeTd, docTd, l, r) {
+    if (l.bufferAbove > 0)
+        codeTd.style.paddingTop = `${String(l.bufferAbove)}px`;
+    if (r.bufferAbove > 0)
+        docTd.style.paddingTop = `${String(r.bufferAbove)}px`;
+    if (l.bufferBelow > 0)
+        codeTd.style.paddingBottom = `${String(l.bufferBelow)}px`;
+    if (r.bufferBelow > 0)
+        docTd.style.paddingBottom = `${String(r.bufferBelow)}px`;
+}
+function stretchRowCells(row) {
+    const cells = row.querySelectorAll("td");
+    const codeTd = cells[0];
+    const docTd = cells[1];
+    if (codeTd === undefined || docTd === undefined)
+        return null;
+    return { codeTd, docTd };
+}
+function clearPaddingOnStretchRows(rows) {
+    for (const row of rows) {
+        const pair = stretchRowCells(row);
+        if (pair === null)
+            continue;
+        clearStretchRowPadding(pair.codeTd, pair.docTd);
+    }
+}
+function collectStretchRowHeights(rows) {
+    const left = [];
+    const right = [];
+    for (const row of rows) {
+        const pair = stretchRowCells(row);
+        if (pair === null)
+            continue;
+        const id = row.dataset.commentrayStretchSyncId?.trim() ?? "";
+        left.push({
+            id,
+            height: readCellIntrinsicHeightPx(pair.codeTd),
+            bufferAbove: 0,
+            bufferBelow: 0,
+        });
+        right.push({
+            id,
+            height: readCellIntrinsicHeightPx(pair.docTd),
+            bufferAbove: 0,
+            bufferBelow: 0,
+        });
+    }
+    if (left.length === 0)
+        return null;
+    return { left, right };
+}
+function applySynchronizedPaddingToStretchRows(rows, sync) {
+    const rowCount = rows.length;
+    for (let i = 0; i < rowCount; i++) {
+        const row = rows[i];
+        const pair = row === undefined ? null : stretchRowCells(row);
+        const l = sync.left[i];
+        const r = sync.right[i];
+        if (pair === null || l === undefined || r === undefined)
+            continue;
+        applyStretchSyncPadding(pair.codeTd, pair.docTd, l, r);
+    }
+}
+function clearTerminalBottomSlack(rows) {
+    const lastRow = rows.at(-1);
+    if (lastRow === undefined || !lastRow.classList.contains("stretch-row--gap"))
+        return;
+    const pair = lastRow === undefined ? null : stretchRowCells(lastRow);
+    if (pair === null)
+        return;
+    // In shared-table stretch mode, terminal tail slack only creates dead blank space at the end.
+    pair.codeTd.style.paddingBottom = "";
+    pair.docTd.style.paddingBottom = "";
+}
+/**
+ * Applies `BufferingFlowSynchronizer` per stretch row (one shared sync id per `<tr>`). The shorter
+ * cell gets `padding-bottom` so the row matches the taller side—same contract as `BBBB` in core
+ * approval fixtures, recomputed when layout changes (Mermaid, wrap, viewport).
+ */
+export function applyBlockStretchRowBuffers(table) {
+    const rows = stretchRowsWithSyncId(table);
+    if (rows.length === 0)
+        return;
+    clearPaddingOnStretchRows(rows);
+    const columns = collectStretchRowHeights(rows);
+    if (columns === null)
+        return;
+    const sync = synchronizer.synchronize(columns.left, columns.right);
+    applySynchronizedPaddingToStretchRows(rows, sync);
+    clearTerminalBottomSlack(rows);
+}
+export function dispatchCommentrayMermaidDone() {
+    globalThis.dispatchEvent(new CustomEvent(MERMAID_DONE_EVENT));
+}
+/**
+ * Schedules `applyBlockStretchRowBuffers` on viewport changes, table geometry changes, and after
+ * Mermaid finishes (see `dispatchCommentrayMermaidDone` / inline mermaid module).
+ */
+export function wireBlockStretchBufferSync(table) {
+    let raf = 0;
+    let moTimer;
+    const schedule = () => {
+        if (raf !== 0)
+            globalThis.cancelAnimationFrame(raf);
+        raf = globalThis.requestAnimationFrame(() => {
+            raf = 0;
+            applyBlockStretchRowBuffers(table);
+        });
+    };
+    const scheduleMutationDebounced = () => {
+        if (moTimer !== undefined)
+            globalThis.clearTimeout(moTimer);
+        moTimer = globalThis.setTimeout(() => {
+            moTimer = undefined;
+            schedule();
+        }, 32);
+    };
+    const ro = new ResizeObserver(() => {
+        schedule();
+    });
+    ro.observe(table);
+    const tbody = table.querySelector("tbody");
+    const mo = tbody !== null
+        ? new MutationObserver(() => {
+            scheduleMutationDebounced();
+        })
+        : null;
+    if (mo !== null && tbody !== null) {
+        mo.observe(tbody, { childList: true, subtree: true });
+    }
+    const onWin = () => {
+        schedule();
+    };
+    globalThis.addEventListener("resize", onWin, { passive: true });
+    globalThis.visualViewport?.addEventListener("resize", onWin, { passive: true });
+    const onMermaid = () => {
+        schedule();
+    };
+    globalThis.addEventListener(MERMAID_DONE_EVENT, onMermaid);
+    queueMicrotask(() => {
+        schedule();
+        globalThis.requestAnimationFrame(() => {
+            schedule();
+            globalThis.requestAnimationFrame(() => {
+                schedule();
+            });
+        });
+        globalThis.setTimeout(() => {
+            schedule();
+        }, 120);
+    });
+    return {
+        disconnect: () => {
+            if (raf !== 0)
+                globalThis.cancelAnimationFrame(raf);
+            if (moTimer !== undefined)
+                globalThis.clearTimeout(moTimer);
+            ro.disconnect();
+            mo?.disconnect();
+            globalThis.removeEventListener("resize", onWin);
+            globalThis.visualViewport?.removeEventListener("resize", onWin);
+            globalThis.removeEventListener(MERMAID_DONE_EVENT, onMermaid);
+        },
+    };
+}
+//# sourceMappingURL=block-stretch-buffer-sync.js.map

package/dist/block-stretch-buffer-sync.js.map

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

package/dist/block-stretch-layout.d.ts

@@ -1,5 +1,11 @@
 import { type CommentrayIndex } from "@commentray/core";
 import { type CommentrayOutputUrlOptions } from "./markdown-pipeline.js";
+/**
+ * Stretch column slack strategy (see `CodeBrowserPageOptions.stretchBufferSync`).
+ * - `flow-synchronizer` (default): row sync ids + measure wrappers + client `BufferingFlowSynchronizer` padding.
+ * - `table`: `<table>` row height only (legacy; no client buffer pass).
+ */
+export type StretchBufferSyncStrategy = "table" | "flow-synchronizer";
 export type BlockStretchTableOptions = {
     code: string;
     language: string;
@@ -8,6 +14,9 @@ export type BlockStretchTableOptions = {
     sourceRelative: string;
     commentrayPathRel: string;
     commentrayOutputUrls?: CommentrayOutputUrlOptions;
+    sourceMarkdownOutputUrls?: CommentrayOutputUrlOptions;
+    /** Omitted uses `DEFAULT_STRETCH_BUFFER_SYNC` from `@commentray/core` (`flow-synchronizer`). */
+    stretchBufferSync?: StretchBufferSyncStrategy;
 };
 export declare function splitCommentrayMarkdownSegments(markdown: string): {
     preamble: string;
@@ -17,11 +26,15 @@ export declare function splitCommentrayMarkdownSegments(markdown: string): {
     }[];
 };
 /**
- * When index blocks + markdown markers align, builds a two-column table in the spirit of
- * GitHub **blame**: **one row per block** (plus one row per unmapped source line). The code
- * and commentary cells share the **same row height** — whichever side is taller sets the
- * row; the shorter side is top-aligned with natural empty space below inside its cell.
- * A single outer scroll (`shell--stretch-rows`) keeps both columns in lockstep.
+ * When index blocks + markdown markers align, builds a two-column **`<table>`**: each logical
+ * pair (gap line, or one indexed block) is one `<tr>`. Row height is one number — the taller cell
+ * wins; the shorter cell shows top-aligned content with empty space below (browser table layout).
+ * “Buffer” rows (`stretch-row--gap`) absorb one-sided slack the same way: one code line + a doc
+ * em-dash still share one row height. A single outer scroll (`shell--stretch-rows`) keeps both
+ * columns in lockstep — no dual-pane scroll sync. The client may add per-cell bottom padding via
+ * `BufferingFlowSynchronizer` so row heights stay matched after async reflow (same idea as `BBBB`
+ * fills in `buffering-flow-synchronizer.approvals/`). Default is `flow-synchronizer`; pass
+ * `stretchBufferSync: "table"` for legacy table-only markup.
  */
 export declare function tryBuildBlockStretchTableHtml(opts: BlockStretchTableOptions): Promise<{
     preambleHtml: string;

package/dist/block-stretch-layout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"block-stretch-layout.d.ts","sourceRoot":"","sources":["../src/block-stretch-layout.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,eAAe,EAGrB,MAAM,kBAAkB,CAAC;AAI1B,OAAO,EAAE,KAAK,0BAA0B,EAAwB,MAAM,wBAAwB,CAAC;AAO/F,MAAM,MAAM,wBAAwB,GAAG;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,KAAK,EAAE,eAAe,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,oBAAoB,CAAC,EAAE,0BAA0B,CAAC;CACnD,CAAC;AAEF,wBAAgB,+BAA+B,CAAC,QAAQ,EAAE,MAAM,GAAG;IACjE,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC1C,CA6BA;AAgBD;;;;;;GAMG;AACH,wBAAsB,6BAA6B,CACjD,IAAI,EAAE,wBAAwB,GAC7B,OAAO,CAAC;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CA+ElE"}
+{"version":3,"file":"block-stretch-layout.d.ts","sourceRoot":"","sources":["../src/block-stretch-layout.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,eAAe,EAIrB,MAAM,kBAAkB,CAAC;AAK1B,OAAO,EAAE,KAAK,0BAA0B,EAAwB,MAAM,wBAAwB,CAAC;AAO/F;;;;GAIG;AACH,MAAM,MAAM,yBAAyB,GAAG,OAAO,GAAG,mBAAmB,CAAC;AAEtE,MAAM,MAAM,wBAAwB,GAAG;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,KAAK,EAAE,eAAe,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,oBAAoB,CAAC,EAAE,0BAA0B,CAAC;IAClD,wBAAwB,CAAC,EAAE,0BAA0B,CAAC;IACtD,gGAAgG;IAChG,iBAAiB,CAAC,EAAE,yBAAyB,CAAC;CAC/C,CAAC;AAyCF,wBAAgB,+BAA+B,CAAC,QAAQ,EAAE,MAAM,GAAG;IACjE,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC1C,CA6BA;AAsID;;;;;;;;;;GAUG;AACH,wBAAsB,6BAA6B,CACjD,IAAI,EAAE,wBAAwB,GAC7B,OAAO,CAAC;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CA4ClE"}

package/dist/block-stretch-layout.js

@@ -1,8 +1,26 @@
-import { MARKER_ID_BODY, buildBlockScrollLinks, } from "@commentray/core";
+import { DEFAULT_STRETCH_BUFFER_SYNC, MARKER_ID_BODY, buildBlockScrollLinks, } from "@commentray/core";
 import { escapeHtml } from "./html-utils.js";
 import { renderHighlightedCodeLineRows } from "./highlighted-code-lines.js";
+import { injectSourceMarkdownAnchors } from "./inject-md-line-anchors.js";
 import { renderMarkdownToHtml } from "./markdown-pipeline.js";
 const BLOCK_MARKER_LINE = new RegExp(`^<!--\\s*commentray:block\\s+id=(${MARKER_ID_BODY})\\s*-->$`, "i");
+function sourceMarkdownEnabled(language) {
+    const normalized = language.trim().toLowerCase();
+    return normalized === "md" || normalized === "markdown" || normalized === "mdx";
+}
+async function renderSourceMarkdownSlice(lines, startLine0, endLine0, outputUrls) {
+    const markdown = lines.slice(startLine0, endLine0 + 1).join("\n");
+    const anchored = injectSourceMarkdownAnchors(markdown, startLine0);
+    const rendered = await renderMarkdownToHtml(anchored.trim().length > 0 ? anchored : " ", {
+        commentrayOutputUrls: outputUrls,
+    });
+    return `<div class="source-pane source-pane--rendered-md stretch-source-markdown-body" data-source-markdown-body="true">${rendered}</div>`;
+}
+function wrapStretchSourceCell(codeHtml, renderedMarkdownHtml, mode) {
+    const rendered = renderedMarkdownHtml ?? "";
+    const inner = `<div class="source-pane source-pane--code">${codeHtml}</div>${rendered}`;
+    return mode === "flow-synchronizer" ? `<div class="stretch-cell-measure">${inner}</div>` : inner;
+}
 export function splitCommentrayMarkdownSegments(markdown) {
     const lines = markdown.split("\n");
     const preambleLines = [];
@@ -41,65 +59,123 @@ async function renderCodeLineStack(lines, startLine0, endLine0, language) {
     });
     return `<div class="stretch-code-stack">${inner}</div>`;
 }
-/**
- * When index blocks + markdown markers align, builds a two-column table in the spirit of
- * GitHub **blame**: **one row per block** (plus one row per unmapped source line). The code
- * and commentary cells share the **same row height** — whichever side is taller sets the
- * row; the shorter side is top-aligned with natural empty space below inside its cell.
- * A single outer scroll (`shell--stretch-rows`) keeps both columns in lockstep.
- */
-export async function tryBuildBlockStretchTableHtml(opts) {
-    const links = buildBlockScrollLinks(opts.index, opts.sourceRelative, opts.commentrayPathRel, opts.commentrayMarkdown, opts.code);
-    if (links.length === 0)
-        return null;
-    const { preamble, segments } = splitCommentrayMarkdownSegments(opts.commentrayMarkdown);
-    const mdOpts = { commentrayOutputUrls: opts.commentrayOutputUrls };
+async function renderCommentraySegmentBodies(segments, outputUrls) {
+    const mdOpts = { commentrayOutputUrls: outputUrls };
     const renderedById = new Map();
     for (const s of segments) {
         renderedById.set(s.id, await renderMarkdownToHtml(s.body.trim().length > 0 ? s.body : " ", mdOpts));
     }
-    const lines = opts.code.split("\n");
+    return renderedById;
+}
+function buildLineToBlockLookup(links) {
     const lineToBlock = new Map();
     for (const b of links) {
         const { lo, hiExclusive } = b.markerViewportHalfOpen1Based;
-        for (let L = lo; L < hiExclusive; L++) {
-            lineToBlock.set(L, b);
+        for (let line1 = lo; line1 < hiExclusive; line1++) {
+            lineToBlock.set(line1, b);
         }
     }
+    return lineToBlock;
+}
+async function maybeRenderSourceMarkdownSlice(ctx, startLine0, endLine0) {
+    if (!ctx.sourceMarkdownSlicesEnabled)
+        return undefined;
+    return renderSourceMarkdownSlice(ctx.lines, startLine0, endLine0, ctx.sourceMarkdownOutputUrls);
+}
+function nextGapSyncId(gapSyncSeq) {
+    if (gapSyncSeq === null)
+        return null;
+    const gapId = `__gap__${gapSyncSeq.n}`;
+    gapSyncSeq.n += 1;
+    return gapId;
+}
+async function buildStretchGapRowHtml(ctx, lineIndex0) {
+    const codeLineHtml = await renderHighlightedCodeLineRows(ctx.lines[lineIndex0] ?? "", ctx.language, {
+        lineIndexOffset: lineIndex0,
+        omitLineStackWrapper: true,
+    });
+    const renderedSourceMarkdownHtml = await maybeRenderSourceMarkdownSlice(ctx, lineIndex0, lineIndex0);
+    const sourceCellInner = wrapStretchSourceCell(codeLineHtml, renderedSourceMarkdownHtml, ctx.mode);
+    const gapId = ctx.mode === "flow-synchronizer" ? nextGapSyncId(ctx.gapSyncSeq) : null;
+    if (gapId !== null) {
+        return (`<tr class="stretch-row stretch-row--gap" data-commentray-stretch-sync-id="${escapeHtml(gapId)}">` +
+            `<td class="stretch-code">${sourceCellInner}</td>` +
+            `<td class="stretch-doc stretch-doc--gap"><div class="stretch-cell-measure"></div></td></tr>`);
+    }
+    return (`<tr class="stretch-row stretch-row--gap"><td class="stretch-code">${sourceCellInner}</td>` +
+        `<td class="stretch-doc stretch-doc--gap"></td></tr>`);
+}
+async function buildStretchBlockRowHtml(ctx, block) {
+    const start0 = block.sourceStart - 1;
+    const end0 = block.sourceEnd - 1;
+    const stackHtml = await renderCodeLineStack(ctx.lines, start0, end0, ctx.language);
+    const renderedSourceMarkdownHtml = await maybeRenderSourceMarkdownSlice(ctx, start0, end0);
+    const sourceCellInner = wrapStretchSourceCell(stackHtml, renderedSourceMarkdownHtml, ctx.mode);
+    const docInner = ctx.renderedById.get(block.id) ??
+        `<p class="stretch-doc-missing"><em>No commentary segment for block <code>${escapeHtml(block.id)}</code>.</em></p>`;
+    if (ctx.mode === "flow-synchronizer") {
+        return (`<tr class="stretch-row stretch-row--block" data-commentray-stretch-sync-id="${escapeHtml(block.id)}">` +
+            `<td class="stretch-code">${sourceCellInner}</td>` +
+            `<td class="stretch-doc"><div class="stretch-cell-measure"><div class="stretch-doc-inner">${docInner}</div></div></td></tr>`);
+    }
+    return (`<tr class="stretch-row stretch-row--block"><td class="stretch-code">${sourceCellInner}</td>` +
+        `<td class="stretch-doc"><div class="stretch-doc-inner">${docInner}</div></td></tr>`);
+}
+async function buildStretchRows(ctx, lineToBlock) {
     const rows = [];
-    let i = 0;
-    while (i < lines.length) {
-        const L = i + 1;
-        const b = lineToBlock.get(L);
-        if (!b) {
-            const codeLineHtml = await renderHighlightedCodeLineRows(lines[i] ?? "", opts.language, {
-                lineIndexOffset: i,
-                omitLineStackWrapper: true,
-            });
-            rows.push(`<tr class="stretch-row stretch-row--gap"><td class="stretch-code">${codeLineHtml}</td>` +
-                `<td class="stretch-doc stretch-doc--gap"><span class="stretch-gap-mark" aria-hidden="true">—</span></td></tr>`);
-            i += 1;
+    let lineIndex0 = 0;
+    while (lineIndex0 < ctx.lines.length) {
+        const block = lineToBlock.get(lineIndex0 + 1);
+        if (block === undefined || lineIndex0 < block.sourceStart - 1) {
+            rows.push(await buildStretchGapRowHtml(ctx, lineIndex0));
+            lineIndex0 += 1;
             continue;
         }
-        if (i !== b.sourceStart - 1) {
-            throw new Error(`block-stretch desync at 0-based index ${String(i)} (block ${b.id} should start at index ${String(b.sourceStart - 1)})`);
-        }
-        const start0 = b.sourceStart - 1;
-        const end0 = b.sourceEnd - 1;
-        const stackHtml = await renderCodeLineStack(lines, start0, end0, opts.language);
-        const docInner = renderedById.get(b.id) ??
-            `<p class="stretch-doc-missing"><em>No commentary segment for block <code>${escapeHtml(b.id)}</code>.</em></p>`;
-        rows.push(`<tr class="stretch-row stretch-row--block"><td class="stretch-code">${stackHtml}</td>` +
-            `<td class="stretch-doc"><div class="stretch-doc-inner">${docInner}</div></td></tr>`);
-        i = end0 + 1;
+        rows.push(await buildStretchBlockRowHtml(ctx, block));
+        lineIndex0 = block.sourceEnd;
     }
+    return rows;
+}
+/**
+ * When index blocks + markdown markers align, builds a two-column **`<table>`**: each logical
+ * pair (gap line, or one indexed block) is one `<tr>`. Row height is one number — the taller cell
+ * wins; the shorter cell shows top-aligned content with empty space below (browser table layout).
+ * “Buffer” rows (`stretch-row--gap`) absorb one-sided slack the same way: one code line + a doc
+ * em-dash still share one row height. A single outer scroll (`shell--stretch-rows`) keeps both
+ * columns in lockstep — no dual-pane scroll sync. The client may add per-cell bottom padding via
+ * `BufferingFlowSynchronizer` so row heights stay matched after async reflow (same idea as `BBBB`
+ * fills in `buffering-flow-synchronizer.approvals/`). Default is `flow-synchronizer`; pass
+ * `stretchBufferSync: "table"` for legacy table-only markup.
+ */
+export async function tryBuildBlockStretchTableHtml(opts) {
+    const mode = opts.stretchBufferSync ?? DEFAULT_STRETCH_BUFFER_SYNC;
+    const links = buildBlockScrollLinks(opts.index, opts.sourceRelative, opts.commentrayPathRel, opts.commentrayMarkdown, opts.code);
+    const { preamble, segments } = splitCommentrayMarkdownSegments(opts.commentrayMarkdown);
+    const lines = opts.code.split("\n");
+    const lnMinCh = Math.max(2, String(Math.max(1, lines.length)).length);
+    const mdOpts = { commentrayOutputUrls: opts.commentrayOutputUrls };
+    const renderedById = await renderCommentraySegmentBodies(segments, opts.commentrayOutputUrls);
+    const ctx = {
+        lines,
+        language: opts.language,
+        mode,
+        gapSyncSeq: mode === "flow-synchronizer" ? { n: 0 } : null,
+        sourceMarkdownSlicesEnabled: sourceMarkdownEnabled(opts.language),
+        sourceMarkdownOutputUrls: opts.sourceMarkdownOutputUrls,
+        renderedById,
+    };
+    const rows = await buildStretchRows(ctx, buildLineToBlockLookup(links));
     const preambleHtml = preamble.trim().length > 0
         ? `<section class="stretch-preamble" aria-label="Introduction">${await renderMarkdownToHtml(preamble, mdOpts)}</section>`
         : "";
-    const tableInnerHtml = `<table class="block-stretch pane--code" id="code-pane" role="presentation">` +
+    const tableInnerHtml = `<div class="stretch-grid" id="stretch-grid">` +
+        `${preambleHtml}` +
+        `<table class="block-stretch pane--code" id="code-pane" role="presentation" style="--code-ln-min-ch:${String(lnMinCh)}">` +
         `<colgroup><col class="stretch-col-code" /><col class="stretch-col-doc" /></colgroup>` +
         `<tbody>\n${rows.join("\n")}\n</tbody>` +
-        `</table>`;
-    return { preambleHtml, tableInnerHtml };
+        `</table>` +
+        `<div class="stretch-gutter" id="stretch-gutter" role="separator" aria-orientation="vertical" aria-label="Resize columns"></div>` +
+        `</div>`;
+    return { preambleHtml: "", tableInnerHtml };
 }
 //# sourceMappingURL=block-stretch-layout.js.map

package/dist/block-stretch-layout.js.map

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

package/dist/browse-page-slug.d.ts

@@ -1,8 +1,7 @@
 /**
- * Opaque filename stem for `_site/browse/<slug>.html` (nav search + browse pages).
- * **Stable across rebuilds** while `commentrayPath` and `sourcePath` are unchanged;
- * deterministic from those exact strings. **Rename or move** either file → new
- * strings → **a new slug** (no automatic redirect from old URLs).
+ * Legacy hash stem (28-char base64url) from `sourcePath` + `commentrayPath`.
+ * Static Pages browse HTML now uses human-readable paths under `_site/browse/`; this helper
+ * remains for tests and any tooling that still keys off the old filename shape.
  */
 export declare function browsePageSlugFromPair(pair: {
     sourcePath: string;

package/dist/browse-page-slug.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"browse-page-slug.d.ts","sourceRoot":"","sources":["../src/browse-page-slug.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE;IAC3C,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;CACxB,GAAG,MAAM,CAKT"}
+{"version":3,"file":"browse-page-slug.d.ts","sourceRoot":"","sources":["../src/browse-page-slug.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE;IAC3C,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;CACxB,GAAG,MAAM,CAKT"}

package/dist/browse-page-slug.js

@@ -1,9 +1,8 @@
 import { createHash } from "node:crypto";
 /**
- * Opaque filename stem for `_site/browse/<slug>.html` (nav search + browse pages).
- * **Stable across rebuilds** while `commentrayPath` and `sourcePath` are unchanged;
- * deterministic from those exact strings. **Rename or move** either file → new
- * strings → **a new slug** (no automatic redirect from old URLs).
+ * Legacy hash stem (28-char base64url) from `sourcePath` + `commentrayPath`.
+ * Static Pages browse HTML now uses human-readable paths under `_site/browse/`; this helper
+ * remains for tests and any tooling that still keys off the old filename shape.
  */
 export function browsePageSlugFromPair(pair) {
     return createHash("sha256")

package/dist/browse-page-slug.js.map

@@ -1 +1 @@
-{"version":3,"file":"browse-page-slug.js","sourceRoot":"","sources":["../src/browse-page-slug.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAGtC;IACC,OAAO,UAAU,CAAC,QAAQ,CAAC;SACxB,MAAM,CAAC,GAAG,IAAI,CAAC,cAAc,KAAK,IAAI,CAAC,UAAU,EAAE,EAAE,MAAM,CAAC;SAC5D,MAAM,CAAC,WAAW,CAAC;SACnB,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAClB,CAAC"}
+{"version":3,"file":"browse-page-slug.js","sourceRoot":"","sources":["../src/browse-page-slug.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAGtC;IACC,OAAO,UAAU,CAAC,QAAQ,CAAC;SACxB,MAAM,CAAC,GAAG,IAAI,CAAC,cAAc,KAAK,IAAI,CAAC,UAAU,EAAE,EAAE,MAAM,CAAC;SAC5D,MAAM,CAAC,WAAW,CAAC;SACnB,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAClB,CAAC"}