@commentray/render 0.1.2 → 0.3.0

package/dist/code-browser-pair-nav.js

@@ -20,34 +20,44 @@ export function siteRootPathnameFromPathname(pathname) {
         return "/";
     return noFile.replace(/\/+$/, "") || "/";
 }
-/** Flat canonical page: `./browse/<hash>.html` (opaque slug, one path segment). */
-const STATIC_BROWSE_FLAT = /^(?:\.\/)?browse\/([^/?#]+\.html)$/i;
-/** Human-readable shim: `./browse/<encoded/source/segments>/index.html` (see `browse-pair-static-url.ts`). */
-const STATIC_BROWSE_INDEXED = /^(?:\.\/)?browse\/(.+)\/index\.html$/i;
+/** Indexed pair page: `./browse/…/index.html` or path-absolute `/browse/…/index.html`. */
+const STATIC_BROWSE_INDEXED = /^(?:\.\/|\/)?browse\/(.+)\/index\.html$/i;
+/**
+ * Flat HTML under `browse/`: a lone `*.html` file (e.g. legacy or opaque slug). Multi-angle pairs
+ * use indexed `./browse/…/…/index.html` only. Must not match indexed URLs ending in `/index.html`
+ * (check {@link STATIC_BROWSE_INDEXED} first).
+ */
+const STATIC_BROWSE_FLAT_HTML = /^(?:\.\/|\/)?browse\/(.+\.html)$/i;
 /** True when `href` is hub-root-relative static browse (not same-dir `./other.html`). */
+function isStaticBrowseIndexedHref(t) {
+    return STATIC_BROWSE_INDEXED.test(t);
+}
+function isStaticBrowseFlatHtmlHref(t) {
+    return STATIC_BROWSE_FLAT_HTML.test(t) && !t.toLowerCase().endsWith("/index.html");
+}
 export function isHubRelativeStaticBrowseHref(href) {
     const t = href.trim();
-    return STATIC_BROWSE_FLAT.test(t) || STATIC_BROWSE_INDEXED.test(t);
+    return isStaticBrowseIndexedHref(t) || isStaticBrowseFlatHtmlHref(t);
 }
 /**
- * Resolves `staticBrowseUrl` from nav JSON (typically `./browse/<slug>.html`) to an absolute href.
+ * Resolves `staticBrowseUrl` from nav JSON (`./browse/…/index.html` or legacy flat `./browse/…@….html`) to an absolute href.
  */
 export function resolveStaticBrowseHref(relativeBrowse, pathname, origin) {
     const r = relativeBrowse.trim();
     if (r.startsWith("/"))
         return `${origin}${r}`;
     const root = siteRootPathnameFromPathname(pathname);
-    const mFlat = STATIC_BROWSE_FLAT.exec(r);
-    if (mFlat?.[1]) {
-        const path = root === "/" ? `/browse/${mFlat[1]}` : `${root}/browse/${mFlat[1]}`;
-        return `${origin}${path}`;
-    }
     const mIdx = STATIC_BROWSE_INDEXED.exec(r);
     if (mIdx?.[1]) {
         const inner = mIdx[1];
         const path = root === "/" ? `/browse/${inner}/index.html` : `${root}/browse/${inner}/index.html`;
         return `${origin}${path}`;
     }
+    const mFlat = STATIC_BROWSE_FLAT_HTML.exec(r);
+    if (mFlat?.[1] && !r.toLowerCase().endsWith("/index.html")) {
+        const path = root === "/" ? `/browse/${mFlat[1]}` : `${root}/browse/${mFlat[1]}`;
+        return `${origin}${path}`;
+    }
     return new URL(r, `${origin}${pathname}`).href;
 }
 /**
@@ -59,12 +69,12 @@ export function staticBrowseHrefForShellDataAttribute(staticBrowseUrl, pathname,
     const r = staticBrowseUrl.trim();
     if (r.length === 0)
         return "";
-    const flat = STATIC_BROWSE_FLAT.exec(r);
-    if (flat?.[1])
-        return `./browse/${flat[1]}`;
     const indexed = STATIC_BROWSE_INDEXED.exec(r);
     if (indexed?.[1])
         return `./browse/${indexed[1]}/index.html`;
+    const flat = STATIC_BROWSE_FLAT_HTML.exec(r);
+    if (flat?.[1] && !r.toLowerCase().endsWith("/index.html"))
+        return `./browse/${flat[1]}`;
     return resolveStaticBrowseHref(r, pathname, origin);
 }
 export function findDocumentedPair(pairs, commentrayPath, sourcePath) {
@@ -82,6 +92,35 @@ export function findDocumentedPair(pairs, commentrayPath, sourcePath) {
     }
     return undefined;
 }
+/**
+ * Opaque browse pages are files `browse/<slug>.html`. A bare `/…/browse/<slug>` (one segment after
+ * `browse/`, no `.` in the slug) has no static file on disk — append `.html` so dev server and
+ * address-bar sync match emitted assets (same link shape users should share).
+ */
+export function appendHtmlToOpaqueBrowsePathname(pathname) {
+    const needle = "/browse/";
+    const idx = pathname.lastIndexOf(needle);
+    if (idx < 0)
+        return pathname;
+    const rest = pathname.slice(idx + needle.length);
+    if (rest.length === 0 || rest.includes("/") || rest.includes("."))
+        return pathname;
+    return `${pathname.slice(0, idx + needle.length)}${rest}.html`;
+}
+/** Apply {@link appendHtmlToOpaqueBrowsePathname} to the path part of a request URL. */
+export function appendHtmlToOpaqueBrowseRequestUrl(rawUrl) {
+    try {
+        const u = new URL(rawUrl, "http://localhost");
+        const nextPath = appendHtmlToOpaqueBrowsePathname(u.pathname);
+        if (nextPath === u.pathname)
+            return rawUrl;
+        u.pathname = nextPath;
+        return `${u.pathname}${u.search}${u.hash}`;
+    }
+    catch {
+        return rawUrl;
+    }
+}
 export function isSameDocumentedPair(a, curSourcePath, curCommentrayPath) {
     return (normPosixPath(a.sourcePath) === normPosixPath(curSourcePath) &&
         normPosixPath(a.commentrayPath) === normPosixPath(curCommentrayPath));

package/dist/code-browser-pair-nav.js.map

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

package/dist/code-browser-scroll-buffer-equalize.d.ts

@@ -0,0 +1,25 @@
+import type { BlockScrollLink } from "@commentray/core";
+/** Class on spacer divs injected to equalize paired doc/code segment heights. */
+export declare const COMMENTRAY_SYNC_BUFFER_CLASS = "commentray-sync-buffer";
+export type InstallPerBlockScrollBuffersOptions = {
+    codePane: HTMLElement;
+    docScrollEl: HTMLElement;
+    /** Observed for `innerHTML` swaps (multi-angle); may equal `docScrollEl`. */
+    docBody: HTMLElement | null;
+    getLinks: () => BlockScrollLink[];
+    getLineIdPrefix: () => string;
+};
+export type PerBlockScrollBufferHandle = {
+    disconnect: () => void;
+    /** Re-run segment + total height buffers (same as internal resize/content schedule). */
+    scheduleReequalize: () => void;
+};
+/**
+ * Injects invisible spacer blocks so paired doc/code **segment** heights match (prelude, each
+ * indexed block including inter-block source lines until the next block, then tail), then pads
+ * the shorter pane so **total** `scrollHeight` matches. Proportional sync is then ~1:1 so paired
+ * lines stay aligned while scrolling. Re-runs on pane resize, doc DOM changes, and
+ * {@link PerBlockScrollBufferHandle.scheduleReequalize} (wrap, splitter, etc.).
+ */
+export declare function installPerBlockScrollBuffers(opts: InstallPerBlockScrollBuffersOptions): PerBlockScrollBufferHandle;
+//# sourceMappingURL=code-browser-scroll-buffer-equalize.d.ts.map

package/dist/code-browser-scroll-buffer-equalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-browser-scroll-buffer-equalize.d.ts","sourceRoot":"","sources":["../src/code-browser-scroll-buffer-equalize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAKxD,iFAAiF;AACjF,eAAO,MAAM,4BAA4B,2BAA2B,CAAC;AAkSrE,MAAM,MAAM,mCAAmC,GAAG;IAChD,QAAQ,EAAE,WAAW,CAAC;IACtB,WAAW,EAAE,WAAW,CAAC;IACzB,6EAA6E;IAC7E,OAAO,EAAE,WAAW,GAAG,IAAI,CAAC;IAC5B,QAAQ,EAAE,MAAM,eAAe,EAAE,CAAC;IAClC,eAAe,EAAE,MAAM,MAAM,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG;IACvC,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,wFAAwF;IACxF,kBAAkB,EAAE,MAAM,IAAI,CAAC;CAChC,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,mCAAmC,GACxC,0BAA0B,CAE5B"}

package/dist/code-browser-scroll-buffer-equalize.js

@@ -0,0 +1,316 @@
+import { dedupeBlockScrollLinksById } from "./code-browser-block-rays.js";
+import { partnerDocScrollTopFromCodeScrollTop } from "./code-browser-scroll-sync.js";
+/** Class on spacer divs injected to equalize paired doc/code segment heights. */
+export const COMMENTRAY_SYNC_BUFFER_CLASS = "commentray-sync-buffer";
+const MIN_BUFFER_PX = 2;
+/** Debounce ResizeObserver / visualViewport so buffer churn does not fight slow wheel scrolling. */
+const RESIZE_REEQUALIZE_DEBOUNCE_MS = 140;
+function clamp01(n) {
+    return Math.max(0, Math.min(1, n));
+}
+/** Scroll position as a fraction of max scroll (stable across temporary buffer removal). */
+function captureScrollAlpha(pane) {
+    const max = pane.scrollHeight - pane.clientHeight;
+    if (max <= 0)
+        return 0;
+    return clamp01(pane.scrollTop / max);
+}
+function restoreScrollAlpha(pane, alpha) {
+    const max = Math.max(0, pane.scrollHeight - pane.clientHeight);
+    if (max <= 0) {
+        pane.scrollTop = 0;
+        return;
+    }
+    pane.scrollTop = Math.round(clamp01(alpha) * max);
+}
+function querySelectorByHtmlId(root, id) {
+    if (typeof CSS !== "undefined" && typeof CSS.escape === "function") {
+        try {
+            const hit = root.querySelector(`#${CSS.escape(id)}`);
+            if (hit instanceof HTMLElement)
+                return hit;
+        }
+        catch {
+            /* fall through */
+        }
+    }
+    const forAttr = id.replaceAll("\\", "\\\\").replaceAll('"', '\\"');
+    const hit = root.querySelector(`[id="${forAttr}"]`);
+    return hit instanceof HTMLElement ? hit : null;
+}
+function sortedBlockLinks(getLinks) {
+    const deduped = dedupeBlockScrollLinksById(getLinks());
+    return [...deduped].sort((a, b) => a.sourceStart - b.sourceStart);
+}
+function clearBuffersIn(roots) {
+    for (const root of roots) {
+        for (const el of Array.from(root.querySelectorAll(`.${COMMENTRAY_SYNC_BUFFER_CLASS}`))) {
+            el.remove();
+        }
+    }
+}
+function makeBufferDiv(heightPx) {
+    const d = document.createElement("div");
+    d.className = COMMENTRAY_SYNC_BUFFER_CLASS;
+    d.setAttribute("aria-hidden", "true");
+    d.style.height = `${heightPx}px`;
+    return d;
+}
+function yInScroller(scroller, el, edge) {
+    const sr = scroller.getBoundingClientRect();
+    const er = el.getBoundingClientRect();
+    if (edge === "top")
+        return er.top - sr.top + scroller.scrollTop;
+    return er.bottom - sr.top + scroller.scrollTop;
+}
+function docAnchorEl(scroller, blockId) {
+    return querySelectorByHtmlId(scroller, `commentray-block-${blockId}`);
+}
+function findCodeLineBySrc0(codePane, lineIdPrefix, src0) {
+    return querySelectorByHtmlId(codePane, `${lineIdPrefix}${String(src0)}`);
+}
+function lastSourceLine1Based(codePane) {
+    let max0 = -1;
+    for (const el of codePane.querySelectorAll(".code-line")) {
+        if (!(el instanceof HTMLElement))
+            continue;
+        const d = el.dataset.line;
+        if (d === undefined)
+            continue;
+        const v = Number.parseInt(d, 10);
+        if (Number.isFinite(v))
+            max0 = Math.max(max0, v);
+    }
+    return max0 + 1;
+}
+function docSegmentHeight(docScrollEl, anchor, nextAnchor) {
+    const endY = nextAnchor !== undefined
+        ? yInScroller(docScrollEl, nextAnchor, "top")
+        : docScrollEl.scrollHeight;
+    return endY - yInScroller(docScrollEl, anchor, "top");
+}
+function maybePreludeInsertWithPrefix(docScrollEl, codePane, lineIdPrefix, headAnchor, head) {
+    const block0First = findCodeLineBySrc0(codePane, lineIdPrefix, head.sourceStart - 1);
+    if (!block0First)
+        return null;
+    const docPreH = Math.max(0, yInScroller(docScrollEl, headAnchor, "top"));
+    const firstCodeLine = findCodeLineBySrc0(codePane, lineIdPrefix, 0);
+    if (!firstCodeLine)
+        return null;
+    const codePreH = Math.max(0, yInScroller(codePane, block0First, "top") - yInScroller(codePane, firstCodeLine, "top"));
+    const preDelta = Math.round(Math.abs(docPreH - codePreH));
+    if (preDelta < MIN_BUFFER_PX)
+        return null;
+    if (docPreH < codePreH)
+        return { k: "pre-doc", px: preDelta, beforeAnchor: headAnchor };
+    if (codePreH < docPreH)
+        return { k: "pre-code", px: preDelta, beforeLine: block0First };
+    return null;
+}
+function maybeBlockInsert(args) {
+    const { docScrollEl, codePane, lineIdPrefix, link, anchor, nextAnchor, nextLink, maxLine1 } = args;
+    const docSegH = docSegmentHeight(docScrollEl, anchor, nextAnchor);
+    const start1 = link.sourceStart;
+    const end1Inclusive = nextLink !== undefined ? nextLink.sourceStart - 1 : maxLine1;
+    if (end1Inclusive < start1)
+        return null;
+    const startLine = findCodeLineBySrc0(codePane, lineIdPrefix, start1 - 1);
+    const endLine = findCodeLineBySrc0(codePane, lineIdPrefix, end1Inclusive - 1);
+    if (!startLine || !endLine)
+        return null;
+    const codeSegH = yInScroller(codePane, endLine, "bottom") - yInScroller(codePane, startLine, "top");
+    const segDelta = Math.round(Math.abs(docSegH - codeSegH));
+    if (segDelta < MIN_BUFFER_PX)
+        return null;
+    if (docSegH < codeSegH) {
+        return { k: "blk-doc", px: segDelta, nextAnchor: nextAnchor ?? null };
+    }
+    return { k: "blk-code", px: segDelta, afterLine: endLine };
+}
+function buildBufferInsertList(args) {
+    const { codePane, docScrollEl, getLinks, getLineIdPrefix } = args;
+    clearBuffersIn([codePane, docScrollEl]);
+    const links = sortedBlockLinks(getLinks);
+    if (links.length === 0)
+        return null;
+    const prefix = getLineIdPrefix();
+    const anchors = links.map((l) => docAnchorEl(docScrollEl, l.id));
+    if (!anchors.every((a) => a !== null))
+        return null;
+    const firstCodeLine = findCodeLineBySrc0(codePane, prefix, 0);
+    if (!firstCodeLine)
+        return null;
+    const maxLine1 = lastSourceLine1Based(codePane);
+    if (maxLine1 < 1)
+        return null;
+    const head = links[0];
+    const headAnchor = anchors[0];
+    if (head === undefined || headAnchor === undefined)
+        return null;
+    const inserts = [];
+    const prelude = maybePreludeInsertWithPrefix(docScrollEl, codePane, prefix, headAnchor, head);
+    if (prelude !== null)
+        inserts.push(prelude);
+    for (let i = 0; i < links.length; i++) {
+        const link = links[i];
+        const anchor = anchors[i];
+        const nextAnchor = anchors[i + 1];
+        const nextLink = links[i + 1];
+        if (link === undefined || anchor === undefined)
+            continue;
+        const ins = maybeBlockInsert({
+            docScrollEl,
+            codePane,
+            lineIdPrefix: prefix,
+            link,
+            anchor,
+            nextAnchor,
+            nextLink,
+            maxLine1,
+        });
+        if (ins !== null)
+            inserts.push(ins);
+    }
+    return inserts;
+}
+function applyBufferInserts(docScrollEl, inserts) {
+    for (const ins of inserts) {
+        if (ins.k === "pre-doc") {
+            ins.beforeAnchor.insertAdjacentElement("beforebegin", makeBufferDiv(ins.px));
+            continue;
+        }
+        if (ins.k === "pre-code") {
+            ins.beforeLine.insertAdjacentElement("beforebegin", makeBufferDiv(ins.px));
+            continue;
+        }
+        if (ins.k === "blk-doc") {
+            if (ins.nextAnchor !== null) {
+                ins.nextAnchor.insertAdjacentElement("beforebegin", makeBufferDiv(ins.px));
+            }
+            else {
+                docScrollEl.appendChild(makeBufferDiv(ins.px));
+            }
+            continue;
+        }
+        ins.afterLine.insertAdjacentElement("afterend", makeBufferDiv(ins.px));
+    }
+}
+/** After segment buffers, pad the shorter pane so both scroll heights match (1:1 proportional sync). */
+function applyTotalScrollHeightBuffer(codePane, docScrollEl) {
+    void docScrollEl.offsetHeight;
+    void codePane.offsetHeight;
+    const docH = docScrollEl.scrollHeight;
+    const codeH = codePane.scrollHeight;
+    const raw = Math.abs(docH - codeH);
+    const delta = Math.round(raw);
+    if (delta < MIN_BUFFER_PX)
+        return;
+    if (docH < codeH) {
+        docScrollEl.appendChild(makeBufferDiv(delta));
+    }
+    else {
+        codePane.appendChild(makeBufferDiv(delta));
+    }
+}
+/**
+ * After spacer / tail buffers change `scrollHeight`, restoring **both** panes by scroll **fraction**
+ * can break pairing: segment buffers move content so the same fraction no longer means the same
+ * doc↔code alignment. Dual-pane scroll sync uses {@link mirroredScrollTop} on equal max ranges —
+ * re-apply that mapping from the code pane (reading position source of truth) once layout settles.
+ */
+function alignDocScrollToCodeAfterBufferLayout(codePane, docScrollEl) {
+    docScrollEl.scrollTop = partnerDocScrollTopFromCodeScrollTop(codePane.scrollTop, codePane.scrollHeight, codePane.clientHeight, docScrollEl.scrollHeight, docScrollEl.clientHeight);
+}
+function runEqualizeScrollBuffers(args) {
+    const codeAlpha = captureScrollAlpha(args.codePane);
+    const inserts = buildBufferInsertList(args);
+    if (inserts === null)
+        return;
+    applyBufferInserts(args.docScrollEl, inserts);
+    applyTotalScrollHeightBuffer(args.codePane, args.docScrollEl);
+    restoreScrollAlpha(args.codePane, codeAlpha);
+    alignDocScrollToCodeAfterBufferLayout(args.codePane, args.docScrollEl);
+}
+/**
+ * Injects invisible spacer blocks so paired doc/code **segment** heights match (prelude, each
+ * indexed block including inter-block source lines until the next block, then tail), then pads
+ * the shorter pane so **total** `scrollHeight` matches. Proportional sync is then ~1:1 so paired
+ * lines stay aligned while scrolling. Re-runs on pane resize, doc DOM changes, and
+ * {@link PerBlockScrollBufferHandle.scheduleReequalize} (wrap, splitter, etc.).
+ */
+export function installPerBlockScrollBuffers(opts) {
+    return attachScrollBufferEqualizer(opts);
+}
+function attachScrollBufferEqualizer(opts) {
+    const { codePane, docScrollEl, docBody, getLinks, getLineIdPrefix } = opts;
+    let raf = 0;
+    let resizeDebounce;
+    const schedule = () => {
+        if (raf !== 0)
+            return;
+        raf = globalThis.requestAnimationFrame(() => {
+            raf = 0;
+            runEqualize();
+        });
+    };
+    const scheduleResizeDebounced = () => {
+        if (resizeDebounce !== undefined) {
+            globalThis.clearTimeout(resizeDebounce);
+        }
+        resizeDebounce = globalThis.setTimeout(() => {
+            resizeDebounce = undefined;
+            schedule();
+        }, RESIZE_REEQUALIZE_DEBOUNCE_MS);
+    };
+    const ro = typeof ResizeObserver !== "undefined"
+        ? new ResizeObserver(() => {
+            scheduleResizeDebounced();
+        })
+        : null;
+    ro?.observe(codePane);
+    ro?.observe(docScrollEl);
+    const visualViewport = globalThis.visualViewport ?? null;
+    if (visualViewport !== null) {
+        visualViewport.addEventListener("resize", scheduleResizeDebounced, { passive: true });
+    }
+    const moTarget = docBody ?? docScrollEl;
+    const mo = typeof MutationObserver !== "undefined"
+        ? new MutationObserver(() => {
+            schedule();
+        })
+        : null;
+    mo?.observe(moTarget, { childList: true, subtree: true });
+    function runEqualize() {
+        mo?.disconnect();
+        ro?.disconnect();
+        try {
+            runEqualizeScrollBuffers({ codePane, docScrollEl, getLinks, getLineIdPrefix });
+        }
+        finally {
+            ro?.observe(codePane);
+            ro?.observe(docScrollEl);
+            mo?.observe(moTarget, { childList: true, subtree: true });
+        }
+    }
+    schedule();
+    return {
+        scheduleReequalize: schedule,
+        disconnect: () => {
+            if (raf !== 0) {
+                globalThis.cancelAnimationFrame(raf);
+                raf = 0;
+            }
+            if (resizeDebounce !== undefined) {
+                globalThis.clearTimeout(resizeDebounce);
+                resizeDebounce = undefined;
+            }
+            if (visualViewport !== null) {
+                visualViewport.removeEventListener("resize", scheduleResizeDebounced);
+            }
+            ro?.disconnect();
+            mo?.disconnect();
+            clearBuffersIn([codePane, docScrollEl]);
+        },
+    };
+}
+//# sourceMappingURL=code-browser-scroll-buffer-equalize.js.map

package/dist/code-browser-scroll-buffer-equalize.js.map

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

package/dist/code-browser-scroll-sync-monotonic.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Normative scroll-sync monotonicity (see `docs/spec/dual-pane-scroll-sync.md`).
+ * Pure predicates so Vitest can lock the contract without a browser scroll stack.
+ */
+/** Sub-pixel / wheel noise: ignore driver direction when |delta| is below this. */
+export declare const SCROLL_SYNC_MONOTONIC_EPS = 1.5;
+/**
+ * After applying partner scroll from a driver-driven sync, returns whether the partner moved
+ * **opposite** to the driver’s direction (forbidden UX: backward jump while scrolling one column).
+ */
+export declare function shouldRevertPartnerScrollForMonotonicity(args: {
+    driverDelta: number;
+    partnerBefore: number;
+    partnerAfter: number;
+    eps?: number;
+}): boolean;
+//# sourceMappingURL=code-browser-scroll-sync-monotonic.d.ts.map

package/dist/code-browser-scroll-sync-monotonic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-browser-scroll-sync-monotonic.d.ts","sourceRoot":"","sources":["../src/code-browser-scroll-sync-monotonic.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,mFAAmF;AACnF,eAAO,MAAM,yBAAyB,MAAM,CAAC;AAE7C;;;GAGG;AACH,wBAAgB,wCAAwC,CAAC,IAAI,EAAE;IAC7D,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,GAAG,OAAO,CAOV"}

package/dist/code-browser-scroll-sync-monotonic.js

@@ -0,0 +1,22 @@
+/**
+ * Normative scroll-sync monotonicity (see `docs/spec/dual-pane-scroll-sync.md`).
+ * Pure predicates so Vitest can lock the contract without a browser scroll stack.
+ */
+/** Sub-pixel / wheel noise: ignore driver direction when |delta| is below this. */
+export const SCROLL_SYNC_MONOTONIC_EPS = 1.5;
+/**
+ * After applying partner scroll from a driver-driven sync, returns whether the partner moved
+ * **opposite** to the driver’s direction (forbidden UX: backward jump while scrolling one column).
+ */
+export function shouldRevertPartnerScrollForMonotonicity(args) {
+    const eps = args.eps ?? SCROLL_SYNC_MONOTONIC_EPS;
+    const { driverDelta, partnerBefore, partnerAfter } = args;
+    if (Math.abs(driverDelta) < eps)
+        return false;
+    if (driverDelta > eps && partnerAfter < partnerBefore - eps)
+        return true;
+    if (driverDelta < -eps && partnerAfter > partnerBefore + eps)
+        return true;
+    return false;
+}
+//# sourceMappingURL=code-browser-scroll-sync-monotonic.js.map

package/dist/code-browser-scroll-sync-monotonic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-browser-scroll-sync-monotonic.js","sourceRoot":"","sources":["../src/code-browser-scroll-sync-monotonic.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,mFAAmF;AACnF,MAAM,CAAC,MAAM,yBAAyB,GAAG,GAAG,CAAC;AAE7C;;;GAGG;AACH,MAAM,UAAU,wCAAwC,CAAC,IAKxD;IACC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,yBAAyB,CAAC;IAClD,MAAM,EAAE,WAAW,EAAE,aAAa,EAAE,YAAY,EAAE,GAAG,IAAI,CAAC;IAC1D,IAAI,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,GAAG,GAAG;QAAE,OAAO,KAAK,CAAC;IAC9C,IAAI,WAAW,GAAG,GAAG,IAAI,YAAY,GAAG,aAAa,GAAG,GAAG;QAAE,OAAO,IAAI,CAAC;IACzE,IAAI,WAAW,GAAG,CAAC,GAAG,IAAI,YAAY,GAAG,aAAa,GAAG,GAAG;QAAE,OAAO,IAAI,CAAC;IAC1E,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/code-browser-scroll-sync-strategy.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Mutually exclusive dual-pane scroll correlation modes for the code browser client.
+ *
+ * Selected at runtime from `#shell` `data-scroll-sync-strategy` (optional; default when absent).
+ * Build-time / preview can set {@link CodeBrowserPageOptions.dualPaneScrollSyncStrategy} on the
+ * render package to emit the attribute for experiments.
+ */
+export declare const DUAL_PANE_SCROLL_SYNC_STRATEGIES: readonly ["block-aware-proportional", "block-snap-only", "filler-blocks"];
+export type DualPaneScrollSyncStrategyId = (typeof DUAL_PANE_SCROLL_SYNC_STRATEGIES)[number];
+export declare const DEFAULT_DUAL_PANE_SCROLL_SYNC_STRATEGY: DualPaneScrollSyncStrategyId;
+export declare function parseDualPaneScrollSyncStrategy(raw: string | null | undefined): DualPaneScrollSyncStrategyId;
+//# sourceMappingURL=code-browser-scroll-sync-strategy.d.ts.map

package/dist/code-browser-scroll-sync-strategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-browser-scroll-sync-strategy.d.ts","sourceRoot":"","sources":["../src/code-browser-scroll-sync-strategy.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,eAAO,MAAM,gCAAgC,2EAOnC,CAAC;AAEX,MAAM,MAAM,4BAA4B,GAAG,CAAC,OAAO,gCAAgC,CAAC,CAAC,MAAM,CAAC,CAAC;AAE7F,eAAO,MAAM,sCAAsC,EAAE,4BACzB,CAAC;AAE7B,wBAAgB,+BAA+B,CAC7C,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC7B,4BAA4B,CAQ9B"}

package/dist/code-browser-scroll-sync-strategy.js

@@ -0,0 +1,28 @@
+/**
+ * Mutually exclusive dual-pane scroll correlation modes for the code browser client.
+ *
+ * Selected at runtime from `#shell` `data-scroll-sync-strategy` (optional; default when absent).
+ * Build-time / preview can set {@link CodeBrowserPageOptions.dualPaneScrollSyncStrategy} on the
+ * render package to emit the attribute for experiments.
+ */
+export const DUAL_PANE_SCROLL_SYNC_STRATEGIES = [
+    /** Indexed block snaps + proportional mirror in gaps and when there is no index (current product default). */
+    "block-aware-proportional",
+    /** Block snaps only; partner is not proportionally mirrored in gaps or without an index (partner “holds” until the next snap). */
+    "block-snap-only",
+    /** Alias of {@link DEFAULT_DUAL_PANE_SCROLL_SYNC_STRATEGY} (reserved id for experiments). */
+    "filler-blocks",
+];
+export const DEFAULT_DUAL_PANE_SCROLL_SYNC_STRATEGY = "block-aware-proportional";
+export function parseDualPaneScrollSyncStrategy(raw) {
+    if (raw === null || raw === undefined)
+        return DEFAULT_DUAL_PANE_SCROLL_SYNC_STRATEGY;
+    const t = raw.trim();
+    if (t.length === 0)
+        return DEFAULT_DUAL_PANE_SCROLL_SYNC_STRATEGY;
+    if (DUAL_PANE_SCROLL_SYNC_STRATEGIES.includes(t)) {
+        return t;
+    }
+    return DEFAULT_DUAL_PANE_SCROLL_SYNC_STRATEGY;
+}
+//# sourceMappingURL=code-browser-scroll-sync-strategy.js.map

package/dist/code-browser-scroll-sync-strategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-browser-scroll-sync-strategy.js","sourceRoot":"","sources":["../src/code-browser-scroll-sync-strategy.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,CAAC,MAAM,gCAAgC,GAAG;IAC9C,8GAA8G;IAC9G,0BAA0B;IAC1B,kIAAkI;IAClI,iBAAiB;IACjB,6FAA6F;IAC7F,eAAe;CACP,CAAC;AAIX,MAAM,CAAC,MAAM,sCAAsC,GACjD,0BAA0B,CAAC;AAE7B,MAAM,UAAU,+BAA+B,CAC7C,GAA8B;IAE9B,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,sCAAsC,CAAC;IACrF,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IACrB,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,sCAAsC,CAAC;IAClE,IAAK,gCAAsD,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;QACxE,OAAO,CAAiC,CAAC;IAC3C,CAAC;IACD,OAAO,sCAAsC,CAAC;AAChD,CAAC"}

package/dist/code-browser-scroll-sync.d.ts

@@ -2,8 +2,8 @@
  * Static browser scroll helpers: proportional mirror plus block pickers from
  * `@commentray/core/block-scroll-pickers` (small browser bundle entry).
  */
-export type { BlockScrollLink } from "@commentray/core/block-scroll-pickers";
-export { pickCommentrayLineForSourceScroll, pickSourceLine0ForCommentrayScroll, } from "@commentray/core/block-scroll-pickers";
+export type { BlockScrollLink, BlockScrollStickyState, } from "@commentray/core/block-scroll-pickers";
+export { blockStrictlyContainingSourceViewportLine, commentrayProbeInStrictInterMarkerGap, DEFAULT_COMMENTRAY_VIEWPORT_HYSTERESIS_LINES, DEFAULT_SOURCE_VIEWPORT_HYSTERESIS_LINES, pickBlockScrollLinkForCommentrayScroll, pickBlockScrollLinkForCommentrayViewportWithHysteresis, pickBlockScrollLinkForSourceViewportTop, pickBlockScrollLinkForSourceViewportWithHysteresis, pickCommentrayLineForSourceScroll, pickSourceLine0ForCommentrayScroll, sourceTopLineStrictlyBeforeFirstIndexLine, } from "@commentray/core/block-scroll-pickers";
 /**
  * Maps one pane’s scroll position to the other for **proportional** scroll sync
  * (static code browser). Mirrors the ratio fallback used while editing when

package/dist/code-browser-scroll-sync.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"code-browser-scroll-sync.d.ts","sourceRoot":"","sources":["../src/code-browser-scroll-sync.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,YAAY,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AAC7E,OAAO,EACL,iCAAiC,EACjC,kCAAkC,GACnC,MAAM,uCAAuC,CAAC;AAE/C;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,eAAe,EAAE,MAAM,EACvB,kBAAkB,EAAE,MAAM,EAC1B,kBAAkB,EAAE,MAAM,EAC1B,kBAAkB,EAAE,MAAM,EAC1B,kBAAkB,EAAE,MAAM,GACzB,MAAM,CAMR"}
+{"version":3,"file":"code-browser-scroll-sync.d.ts","sourceRoot":"","sources":["../src/code-browser-scroll-sync.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,YAAY,EACV,eAAe,EACf,sBAAsB,GACvB,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EACL,yCAAyC,EACzC,qCAAqC,EACrC,4CAA4C,EAC5C,wCAAwC,EACxC,sCAAsC,EACtC,sDAAsD,EACtD,uCAAuC,EACvC,kDAAkD,EAClD,iCAAiC,EACjC,kCAAkC,EAClC,yCAAyC,GAC1C,MAAM,uCAAuC,CAAC;AAE/C;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,eAAe,EAAE,MAAM,EACvB,kBAAkB,EAAE,MAAM,EAC1B,kBAAkB,EAAE,MAAM,EAC1B,kBAAkB,EAAE,MAAM,EAC1B,kBAAkB,EAAE,MAAM,GACzB,MAAM,CAMR"}

package/dist/code-browser-scroll-sync.js

@@ -1,4 +1,4 @@
-export { pickCommentrayLineForSourceScroll, pickSourceLine0ForCommentrayScroll, } from "@commentray/core/block-scroll-pickers";
+export { blockStrictlyContainingSourceViewportLine, commentrayProbeInStrictInterMarkerGap, DEFAULT_COMMENTRAY_VIEWPORT_HYSTERESIS_LINES, DEFAULT_SOURCE_VIEWPORT_HYSTERESIS_LINES, pickBlockScrollLinkForCommentrayScroll, pickBlockScrollLinkForCommentrayViewportWithHysteresis, pickBlockScrollLinkForSourceViewportTop, pickBlockScrollLinkForSourceViewportWithHysteresis, pickCommentrayLineForSourceScroll, pickSourceLine0ForCommentrayScroll, sourceTopLineStrictlyBeforeFirstIndexLine, } from "@commentray/core/block-scroll-pickers";
 /**
  * Maps one pane’s scroll position to the other for **proportional** scroll sync
  * (static code browser). Mirrors the ratio fallback used while editing when

package/dist/code-browser-scroll-sync.js.map

@@ -1 +1 @@
-{"version":3,"file":"code-browser-scroll-sync.js","sourceRoot":"","sources":["../src/code-browser-scroll-sync.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,iCAAiC,EACjC,kCAAkC,GACnC,MAAM,uCAAuC,CAAC;AAE/C;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAC/B,eAAuB,EACvB,kBAA0B,EAC1B,kBAA0B,EAC1B,kBAA0B,EAC1B,kBAA0B;IAE1B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,kBAAkB,GAAG,kBAAkB,CAAC,CAAC;IACvE,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,kBAAkB,GAAG,kBAAkB,CAAC,CAAC;IACvE,IAAI,SAAS,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC;IAC7B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,eAAe,GAAG,SAAS,CAAC,CAAC,CAAC;IACpE,OAAO,KAAK,GAAG,SAAS,CAAC;AAC3B,CAAC"}
+{"version":3,"file":"code-browser-scroll-sync.js","sourceRoot":"","sources":["../src/code-browser-scroll-sync.ts"],"names":[],"mappings":"AAQA,OAAO,EACL,yCAAyC,EACzC,qCAAqC,EACrC,4CAA4C,EAC5C,wCAAwC,EACxC,sCAAsC,EACtC,sDAAsD,EACtD,uCAAuC,EACvC,kDAAkD,EAClD,iCAAiC,EACjC,kCAAkC,EAClC,yCAAyC,GAC1C,MAAM,uCAAuC,CAAC;AAE/C;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAC/B,eAAuB,EACvB,kBAA0B,EAC1B,kBAA0B,EAC1B,kBAA0B,EAC1B,kBAA0B;IAE1B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,kBAAkB,GAAG,kBAAkB,CAAC,CAAC;IACvE,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,kBAAkB,GAAG,kBAAkB,CAAC,CAAC;IACvE,IAAI,SAAS,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC;IAC7B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,eAAe,GAAG,SAAS,CAAC,CAAC,CAAC;IACpE,OAAO,KAAK,GAAG,SAAS,CAAC;AAC3B,CAAC"}