@commentray/render 0.2.0 → 0.3.1

package/dist/code-browser-pair-nav.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"code-browser-pair-nav.d.ts","sourceRoot":"","sources":["../src/code-browser-pair-nav.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,qBAAqB,GAAG;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B,CAAC;AAEF,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CASrE;AAQD,yFAAyF;AACzF,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGnE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb,MAAM,CAiBR;AAED;;;;GAIG;AACH,wBAAgB,qCAAqC,CACnD,eAAe,EAAE,MAAM,EACvB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb,MAAM,CAQR;AAED,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,qBAAqB,EAChE,KAAK,EAAE,SAAS,CAAC,EAAE,EACnB,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,MAAM,GACjB,CAAC,GAAG,SAAS,CAYf;AAED,wBAAgB,oBAAoB,CAClC,CAAC,EAAE,qBAAqB,EACxB,aAAa,EAAE,MAAM,EACrB,iBAAiB,EAAE,MAAM,GACxB,OAAO,CAKT"}
+{"version":3,"file":"code-browser-pair-nav.d.ts","sourceRoot":"","sources":["../src/code-browser-pair-nav.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,qBAAqB,GAAG;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B,CAAC;AAEF,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CASrE;AAqBD,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGnE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb,MAAM,CAiBR;AAED;;;;GAIG;AACH,wBAAgB,qCAAqC,CACnD,eAAe,EAAE,MAAM,EACvB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb,MAAM,CAQR;AAED,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,qBAAqB,EAChE,KAAK,EAAE,SAAS,CAAC,EAAE,EACnB,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,MAAM,GACjB,CAAC,GAAG,SAAS,CAYf;AAED;;;;GAIG;AACH,wBAAgB,gCAAgC,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAOzE;AAED,wFAAwF;AACxF,wBAAgB,kCAAkC,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAUzE;AAED,wBAAgB,oBAAoB,CAClC,CAAC,EAAE,qBAAqB,EACxB,aAAa,EAAE,MAAM,EACrB,iBAAiB,EAAE,MAAM,GACxB,OAAO,CAKT"}

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":"AAAA;;;GAGG;AASH,MAAM,UAAU,aAAa,CAAC,CAAS;IACrC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;AAC7D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,4BAA4B,CAAC,QAAgB;IAC3D,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACzC,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC;QACb,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAC1D,OAAO,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC;IACtC,CAAC;IACD,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAChD,IAAI,MAAM,KAAK,EAAE,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,GAAG,CAAC;IAChD,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC;AAC3C,CAAC;AAED,mFAAmF;AACnF,MAAM,kBAAkB,GAAG,qCAAqC,CAAC;AAEjE,8GAA8G;AAC9G,MAAM,qBAAqB,GAAG,uCAAuC,CAAC;AAEtE,yFAAyF;AACzF,MAAM,UAAU,6BAA6B,CAAC,IAAY;IACxD,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IACtB,OAAO,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,qBAAqB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACrE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CACrC,cAAsB,EACtB,QAAgB,EAChB,MAAc;IAEd,MAAM,CAAC,GAAG,cAAc,CAAC,IAAI,EAAE,CAAC;IAChC,IAAI,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,GAAG,MAAM,GAAG,CAAC,EAAE,CAAC;IAC9C,MAAM,IAAI,GAAG,4BAA4B,CAAC,QAAQ,CAAC,CAAC;IACpD,MAAM,KAAK,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACzC,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACf,MAAM,IAAI,GAAG,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,WAAW,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,WAAW,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QACjF,OAAO,GAAG,MAAM,GAAG,IAAI,EAAE,CAAC;IAC5B,CAAC;IACD,MAAM,IAAI,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC3C,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACd,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACtB,MAAM,IAAI,GACR,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,WAAW,KAAK,aAAa,CAAC,CAAC,CAAC,GAAG,IAAI,WAAW,KAAK,aAAa,CAAC;QACtF,OAAO,GAAG,MAAM,GAAG,IAAI,EAAE,CAAC;IAC5B,CAAC;IACD,OAAO,IAAI,GAAG,CAAC,CAAC,EAAE,GAAG,MAAM,GAAG,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC;AACjD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,qCAAqC,CACnD,eAAuB,EACvB,QAAgB,EAChB,MAAc;IAEd,MAAM,CAAC,GAAG,eAAe,CAAC,IAAI,EAAE,CAAC;IACjC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAC9B,MAAM,IAAI,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACxC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC;QAAE,OAAO,YAAY,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5C,MAAM,OAAO,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC9C,IAAI,OAAO,EAAE,CAAC,CAAC,CAAC;QAAE,OAAO,YAAY,OAAO,CAAC,CAAC,CAAC,aAAa,CAAC;IAC7D,OAAO,uBAAuB,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,KAAmB,EACnB,cAAsB,EACtB,UAAkB;IAElB,MAAM,EAAE,GAAG,aAAa,CAAC,cAAc,CAAC,CAAC;IACzC,MAAM,EAAE,GAAG,aAAa,CAAC,UAAU,CAAC,CAAC;IACrC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClB,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC,CAAC;QACtE,IAAI,GAAG;YAAE,OAAO,GAAG,CAAC;IACtB,CAAC;IACD,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClB,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC,CAAC;QAClE,IAAI,GAAG;YAAE,OAAO,GAAG,CAAC;IACtB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,CAAwB,EACxB,aAAqB,EACrB,iBAAyB;IAEzB,OAAO,CACL,aAAa,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,aAAa,CAAC,aAAa,CAAC;QAC5D,aAAa,CAAC,CAAC,CAAC,cAAc,CAAC,KAAK,aAAa,CAAC,iBAAiB,CAAC,CACrE,CAAC;AACJ,CAAC"}
+{"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-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"}

package/dist/code-browser-smooth-reveal-dedup.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Historical ceiling for smooth-scroll duration (hash / search helpers may still use `smooth`).
+ * Dual-pane block sync uses **instant** partner writes (`applyRevealChildInPane`); partner echo
+ * suppression stays above this constant so any remaining smooth paths do not masquerade as driver
+ * input mid-gesture.
+ */
+/**
+ * Ceiling used when sizing partner echo suppression in `code-browser-client` so a smooth
+ * programmatic scroll (if any) is not mistaken for user input mid-animation.
+ */
+export declare const SMOOTH_REVEAL_INFLIGHT_DEDUP_MS = 800;
+/** Sub-pixel tolerance — clamp / `getBoundingClientRect` math drifts by less than this between frames. */
+export declare const SMOOTH_REVEAL_TARGET_EPSILON_PX = 0.5;
+export type SmoothRevealInFlight = {
+    /** Clamped scrollTop the most recent `scrollTo` was aimed at. */
+    target: number;
+    /** `performance.now()` at the moment of issue. */
+    issuedAt: number;
+};
+/**
+ * True when `target` essentially equals the last-issued target and the in-flight glide is still
+ * within the typical animation duration. The caller should skip its `scrollTo` in that case.
+ */
+export declare function smoothRevealAlreadyInFlight(last: SmoothRevealInFlight | null, target: number, now: number): boolean;
+//# sourceMappingURL=code-browser-smooth-reveal-dedup.d.ts.map

package/dist/code-browser-smooth-reveal-dedup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-browser-smooth-reveal-dedup.d.ts","sourceRoot":"","sources":["../src/code-browser-smooth-reveal-dedup.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;GAGG;AACH,eAAO,MAAM,+BAA+B,MAAM,CAAC;AAEnD,0GAA0G;AAC1G,eAAO,MAAM,+BAA+B,MAAM,CAAC;AAEnD,MAAM,MAAM,oBAAoB,GAAG;IACjC,iEAAiE;IACjE,MAAM,EAAE,MAAM,CAAC;IACf,kDAAkD;IAClD,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,oBAAoB,GAAG,IAAI,EACjC,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,GACV,OAAO,CAIT"}

package/dist/code-browser-smooth-reveal-dedup.js

@@ -0,0 +1,25 @@
+/**
+ * Historical ceiling for smooth-scroll duration (hash / search helpers may still use `smooth`).
+ * Dual-pane block sync uses **instant** partner writes (`applyRevealChildInPane`); partner echo
+ * suppression stays above this constant so any remaining smooth paths do not masquerade as driver
+ * input mid-gesture.
+ */
+/**
+ * Ceiling used when sizing partner echo suppression in `code-browser-client` so a smooth
+ * programmatic scroll (if any) is not mistaken for user input mid-animation.
+ */
+export const SMOOTH_REVEAL_INFLIGHT_DEDUP_MS = 800;
+/** Sub-pixel tolerance — clamp / `getBoundingClientRect` math drifts by less than this between frames. */
+export const SMOOTH_REVEAL_TARGET_EPSILON_PX = 0.5;
+/**
+ * True when `target` essentially equals the last-issued target and the in-flight glide is still
+ * within the typical animation duration. The caller should skip its `scrollTo` in that case.
+ */
+export function smoothRevealAlreadyInFlight(last, target, now) {
+    if (last === null)
+        return false;
+    if (Math.abs(last.target - target) > SMOOTH_REVEAL_TARGET_EPSILON_PX)
+        return false;
+    return now - last.issuedAt < SMOOTH_REVEAL_INFLIGHT_DEDUP_MS;
+}
+//# sourceMappingURL=code-browser-smooth-reveal-dedup.js.map

package/dist/code-browser-smooth-reveal-dedup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-browser-smooth-reveal-dedup.js","sourceRoot":"","sources":["../src/code-browser-smooth-reveal-dedup.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAG,GAAG,CAAC;AAEnD,0GAA0G;AAC1G,MAAM,CAAC,MAAM,+BAA+B,GAAG,GAAG,CAAC;AASnD;;;GAGG;AACH,MAAM,UAAU,2BAA2B,CACzC,IAAiC,EACjC,MAAc,EACd,GAAW;IAEX,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAChC,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,GAAG,+BAA+B;QAAE,OAAO,KAAK,CAAC;IACnF,OAAO,GAAG,GAAG,IAAI,CAAC,QAAQ,GAAG,+BAA+B,CAAC;AAC/D,CAAC"}

package/dist/code-browser.d.ts

@@ -1,5 +1,7 @@
 import { type CommentrayIndex } from "@commentray/core";
+import { type StretchBufferSyncStrategy } from "./block-stretch-layout.js";
 import { type CommentrayOutputUrlOptions } from "./markdown-pipeline.js";
+import { type DualPaneScrollSyncStrategyId } from "./code-browser-scroll-sync-strategy.js";
 /** One angle tab for {@link CodeBrowserPageOptions.multiAngleBrowsing}. */
 export type CodeBrowserMultiAngleSpec = {
     id: string;
@@ -9,9 +11,8 @@ export type CodeBrowserMultiAngleSpec = {
     commentrayOnGithubUrl?: string;
     /**
      * When the static site emits per-pair browse pages, same-tab navigation for the Doc toolbar
-     * (preferred over {@link commentrayOnGithubUrl} on the hub). Typical values are hub-relative
-     * `./browse/<human-path>/index.html` or `./browse/<source>@<angle>.html`; opaque `./browse/<hash>.html`
-     * remains valid for the canonical HTML file on disk.
+     * (preferred over {@link commentrayOnGithubUrl} on the hub). Paths mirror the companion layout
+     * under `./browse/…/index.html` (see `staticBrowseIndexRelPathFromPair` in `@commentray/core`).
      */
     staticBrowseUrl?: string;
     /**
@@ -48,8 +49,9 @@ export type CodeBrowserPageOptions = {
      */
     githubRepoUrl?: string;
     /**
-     * Same-site URL for the static documentation hub (e.g. `./` on `index.html`, `../index.html`
-     * under `browse/`). When set, the first toolbar control is a **home** link here instead of
+     * Same-site URL for the static documentation hub (e.g. `./` on `index.html`, or a
+     * depth-correct relative path to the hub from nested `browse/…` pages — see static export).
+     * When set, the first toolbar control is a **home** link here instead of
      * {@link githubRepoUrl}. Uses the same path safety rules as {@link commentrayStaticBrowseUrl}.
      */
     siteHubUrl?: string;
@@ -104,6 +106,18 @@ export type CodeBrowserPageOptions = {
      * **block-aware** scroll sync and separator lines in the commentray pane.
      */
     codeBrowserLayout?: "auto" | "dual";
+    /**
+     * Stretch layout only. Omitted uses `DEFAULT_STRETCH_BUFFER_SYNC` from `@commentray/core`
+     * (`flow-synchronizer`: sync ids + measure wrappers + client `BufferingFlowSynchronizer`).
+     * `table`: legacy row height only, no shell flag / client padding pass.
+     */
+    stretchBufferSync?: StretchBufferSyncStrategy;
+    /**
+     * Dual-pane scroll correlation (`#shell data-scroll-sync-strategy`). Strategies are mutually
+     * exclusive in the client; omit or set to the default for normal builds. `filler-blocks` is
+     * reserved until height-matched buffer layout exists (currently behaves like the default).
+     */
+    dualPaneScrollSyncStrategy?: DualPaneScrollSyncStrategyId;
     /**
      * `full` (default): in-page search indexes every source line and every commentray line.
      * `commentray-and-paths`: search only **toolbar path labels** plus commentray Markdown (no code-body line corpus).
@@ -121,8 +135,8 @@ export type CodeBrowserPageOptions = {
      */
     commentrayOnGithubUrl?: string;
     /**
-     * When set (e.g. `./browse/…/index.html` or `./browse/<hash>.html` from the static Pages build),
-     * the Doc toolbar icon opens this URL on the **same origin** instead of GitHub.
+     * When set (e.g. `./browse/…/index.html`, `/browse/…/index.html`, or `./browse/<hash>.html` from
+     * the static Pages build), the Doc toolbar icon opens this URL on the **same origin** instead of GitHub.
      */
     commentrayStaticBrowseUrl?: string;
     /**
@@ -138,7 +152,8 @@ export type CodeBrowserPageOptions = {
     documentedPairsEmbeddedB64?: string;
     /**
      * When **two or more** angles are listed for the same static browse session, the shell renders
-     * an Angle selector, embeds each rendered Markdown body, and disables stretch layout.
+     * an Angle selector. If every angle can build a block-stretch table (`layout` `auto`), the shell
+     * uses **stretch** (one scroll + row-aligned table); otherwise **dual** panes with client swap.
      */
     multiAngleBrowsing?: CodeBrowserMultiAngleBrowsing;
     /**
@@ -154,4 +169,6 @@ export type CodeBrowserPageOptions = {
  * token-in-line quick search (all non-whitespace tokens must appear on the same line).
  */
 export declare function renderCodeBrowserHtml(opts: CodeBrowserPageOptions): Promise<string>;
+export type { DualPaneScrollSyncStrategyId } from "./code-browser-scroll-sync-strategy.js";
+export type { StretchBufferSyncStrategy } from "./block-stretch-layout.js";
 //# sourceMappingURL=code-browser.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"code-browser.d.ts","sourceRoot":"","sources":["../src/code-browser.ts"],"names":[],"mappings":"AAGA,OAAO,EAGL,KAAK,eAAe,EAIrB,MAAM,kBAAkB,CAAC;AAU1B,OAAO,EAAE,KAAK,0BAA0B,EAAwB,MAAM,wBAAwB,CAAC;AAQ/F,2EAA2E;AAC3E,MAAM,MAAM,yBAAyB,GAAG;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B;;;;;OAKG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE;QACjB,KAAK,EAAE,eAAe,CAAC;QACvB,cAAc,EAAE,MAAM,CAAC;QACvB,iBAAiB,EAAE,MAAM,CAAC;KAC3B,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,6BAA6B,GAAG;IAC1C,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,yBAAyB,EAAE,CAAC;CACrC,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0FAA0F;IAC1F,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,oEAAoE;IACpE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,oBAAoB,CAAC,EAAE,0BAA0B,CAAC;IAClD;;;OAGG;IACH,gBAAgB,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACrD;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,OAAO,CAAC,EAAE,IAAI,CAAC;IACf;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE;QACjB,KAAK,EAAE,eAAe,CAAC;QACvB,cAAc,EAAE,MAAM,CAAC;QACvB,iBAAiB,EAAE,MAAM,CAAC;KAC3B,CAAC;IACF;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACpC;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,GAAG,sBAAsB,CAAC;IACpD,oHAAoH;IACpH,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;OAEG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B;;;OAGG;IACH,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC;;;OAGG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B;;;;OAIG;IACH,0BAA0B,CAAC,EAAE,MAAM,CAAC;IACpC;;;OAGG;IACH,kBAAkB,CAAC,EAAE,6BAA6B,CAAC;IACnD;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B,CAAC;AAs7EF;;;;GAIG;AACH,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,sBAAsB,GAAG,OAAO,CAAC,MAAM,CAAC,CA6EzF"}
+{"version":3,"file":"code-browser.d.ts","sourceRoot":"","sources":["../src/code-browser.ts"],"names":[],"mappings":"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"}