@mokly/mokly 0.8.0

package/dist/client/browse_fetch.js

@@ -0,0 +1,39 @@
+/** Fetch a coherent destination without allowing an older snapshot to undo evidence updates. */
+import { readPageStamp } from "./browse_update_state.js";
+import { adoptStaticDelivery } from "./static_delivery.js";
+export async function fetchBrowseDestination(doc, win, url, slot) {
+    try {
+        while (slot.isCurrent()) {
+            const response = await win.fetch(url, {
+                headers: { accept: "text/html" },
+                signal: slot.signal,
+                cache: "no-store",
+            });
+            if (!response.ok && response.status !== 404)
+                break;
+            const html = await response.text();
+            if (!slot.isCurrent())
+                return;
+            const parsed = new win.DOMParser().parseFromString(html, "text/html");
+            const currentStamp = readPageStamp(doc);
+            const nextStamp = readPageStamp(parsed);
+            if (currentStamp) {
+                if (!nextStamp || nextStamp.content !== currentStamp.content)
+                    break;
+                if (nextStamp.version < currentStamp.version)
+                    continue;
+            }
+            const view = parsed.querySelector("[data-mokly-view]");
+            if (!view || !adoptStaticDelivery(doc, parsed))
+                break;
+            return { parsed, view, url: response.url || url };
+        }
+    }
+    catch {
+        // A current failed navigation falls back to its durable URL.
+    }
+    if (slot.isCurrent())
+        win.location.assign(url);
+    return undefined;
+}
+//# sourceMappingURL=browse_fetch.js.map

package/dist/client/browse_fetch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browse_fetch.js","sourceRoot":"","sources":["../../src/client/browse_fetch.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAChG,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAE3D,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,GAAa,EACb,GAA+B,EAC/B,GAAW,EACX,IAA8C;IAE9C,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC;YACxB,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE;gBACpC,OAAO,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE;gBAChC,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,KAAK,EAAE,UAAU;aAClB,CAAC,CAAC;YACH,IAAI,CAAC,QAAQ,CAAC,EAAE,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG;gBAAE,MAAM;YACnD,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACnC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE;gBAAE,OAAO;YAC9B,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,SAAS,EAAE,CAAC,eAAe,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;YACtE,MAAM,YAAY,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;YACxC,MAAM,SAAS,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;YACxC,IAAI,YAAY,EAAE,CAAC;gBACjB,IAAI,CAAC,SAAS,IAAI,SAAS,CAAC,OAAO,KAAK,YAAY,CAAC,OAAO;oBAAE,MAAM;gBACpE,IAAI,SAAS,CAAC,OAAO,GAAG,YAAY,CAAC,OAAO;oBAAE,SAAS;YACzD,CAAC;YACD,MAAM,IAAI,GAAG,MAAM,CAAC,aAAa,CAAC,mBAAmB,CAAC,CAAC;YACvD,IAAI,CAAC,IAAI,IAAI,CAAC,mBAAmB,CAAC,GAAG,EAAE,MAAM,CAAC;gBAAE,MAAM;YACtD,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,QAAQ,CAAC,GAAG,IAAI,GAAG,EAAE,CAAC;QACpD,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,6DAA6D;IAC/D,CAAC;IACD,IAAI,IAAI,CAAC,SAAS,EAAE;QAAE,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC/C,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/client/browse_frames.d.ts

@@ -0,0 +1,18 @@
+/** Browser-frame enhancements: the expand-to-overlay toggle and the
+ * address-pill copy affordance. Both are delegated so they survive
+ * progressive route swaps. */
+/** The currently expanded browser frame, if any. */
+export declare function expandedFrame(doc: Document): HTMLElement | undefined;
+/** Collapse one expanded frame and restore its toggle state. */
+export declare function collapseFrame(doc: Document, frame?: HTMLElement): void;
+/**
+ * Handle one document click for frame expansion. Returns true when the click
+ * belonged to the expand toggle and navigation handling should stop.
+ */
+export declare function handleFrameClick(doc: Document, target: Element): boolean;
+/**
+ * Handle one document click for the address copy affordance. Returns true
+ * when the click copied an address and should not navigate.
+ */
+export declare function handleAddressClick(doc: Document, target: Element, copy: (text: string) => Promise<void> | void): boolean;
+//# sourceMappingURL=browse_frames.d.ts.map

package/dist/client/browse_frames.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browse_frames.d.ts","sourceRoot":"","sources":["../../src/client/browse_frames.ts"],"names":[],"mappings":"AAAA;;8BAE8B;AAE9B,oDAAoD;AACpD,wBAAgB,aAAa,CAAC,GAAG,EAAE,QAAQ,GAAG,WAAW,GAAG,SAAS,CAIpE;AAED,gEAAgE;AAChE,wBAAgB,aAAa,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,CAAC,EAAE,WAAW,GAAG,IAAI,CAStE;AAYD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAgBxE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,QAAQ,EACb,MAAM,EAAE,OAAO,EACf,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,GAC3C,OAAO,CAeT"}

package/dist/client/browse_frames.js

@@ -0,0 +1,79 @@
+/** Browser-frame enhancements: the expand-to-overlay toggle and the
+ * address-pill copy affordance. Both are delegated so they survive
+ * progressive route swaps. */
+/** The currently expanded browser frame, if any. */
+export function expandedFrame(doc) {
+    return (doc.querySelector(".browser-frame.is-expanded") ?? undefined);
+}
+/** Collapse one expanded frame and restore its toggle state. */
+export function collapseFrame(doc, frame) {
+    doc.body.classList.remove("frame-expanded");
+    if (!frame)
+        return;
+    frame.classList.remove("is-expanded");
+    const button = frame.querySelector(".browser-expand");
+    if (!button)
+        return;
+    button.setAttribute("aria-expanded", "false");
+    button.setAttribute("aria-label", "Expand to a wider viewport");
+    button.setAttribute("title", "Expand to a wider viewport");
+}
+function expandFrame(doc, frame) {
+    frame.classList.add("is-expanded");
+    doc.body.classList.add("frame-expanded");
+    const button = frame.querySelector(".browser-expand");
+    if (!button)
+        return;
+    button.setAttribute("aria-expanded", "true");
+    button.setAttribute("aria-label", "Collapse viewport");
+    button.setAttribute("title", "Collapse viewport");
+}
+/**
+ * Handle one document click for frame expansion. Returns true when the click
+ * belonged to the expand toggle and navigation handling should stop.
+ */
+export function handleFrameClick(doc, target) {
+    const button = target.closest(".browser-expand");
+    if (button) {
+        const frame = button.closest(".browser-frame");
+        if (!frame)
+            return true;
+        const current = expandedFrame(doc);
+        if (current && current !== frame)
+            collapseFrame(doc, current);
+        if (frame.classList.contains("is-expanded"))
+            collapseFrame(doc, frame);
+        else
+            expandFrame(doc, frame);
+        return true;
+    }
+    const current = expandedFrame(doc);
+    if (current && !target.closest(".browser-frame.is-expanded")) {
+        collapseFrame(doc, current);
+    }
+    return false;
+}
+/**
+ * Handle one document click for the address copy affordance. Returns true
+ * when the click copied an address and should not navigate.
+ */
+export function handleAddressClick(doc, target, copy) {
+    const address = target.closest(".browser-bar .address");
+    if (!address)
+        return false;
+    const url = address.querySelector(".address-url") ?? address;
+    const text = url.textContent?.trim() ?? "";
+    if (text !== "")
+        void copy(text);
+    const bar = address.parentElement;
+    if (!bar)
+        return true;
+    bar.querySelector(".address-copied")?.remove();
+    const hint = doc.createElement("span");
+    hint.className = "address-copied";
+    hint.textContent = "URL copied";
+    bar.appendChild(hint);
+    setTimeout(() => hint.remove(), 1400);
+    return true;
+}
+//# sourceMappingURL=browse_frames.js.map

package/dist/client/browse_frames.js.map

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

package/dist/client/browse_links.d.ts

@@ -0,0 +1,3 @@
+/** Keep native modified/external links outside progressive shell navigation. */
+export declare function browseLinkTarget(event: MouseEvent, element: Element, location: Location): string | undefined;
+//# sourceMappingURL=browse_links.d.ts.map

package/dist/client/browse_links.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browse_links.d.ts","sourceRoot":"","sources":["../../src/client/browse_links.ts"],"names":[],"mappings":"AAEA,gFAAgF;AAChF,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,QAAQ,GACjB,MAAM,GAAG,SAAS,CAoBpB"}

package/dist/client/browse_links.js

@@ -0,0 +1,23 @@
+import { isEligibleBrowseLink, isSameBrowseDocument } from "./navigation.js";
+/** Keep native modified/external links outside progressive shell navigation. */
+export function browseLinkTarget(event, element, location) {
+    const anchor = element.closest("a");
+    if (!anchor || event.defaultPrevented)
+        return undefined;
+    const url = new URL(anchor.href, location.href);
+    return isEligibleBrowseLink({
+        download: anchor.hasAttribute("download"),
+        modified: event.metaKey ||
+            event.ctrlKey ||
+            event.shiftKey ||
+            event.altKey ||
+            event.button !== 0,
+        pathname: url.pathname,
+        sameOrigin: url.origin === location.origin,
+        samePageHash: isSameBrowseDocument(new URL(location.href), url) && url.hash !== "",
+        target: anchor.getAttribute("target") ?? "",
+    })
+        ? url.href
+        : undefined;
+}
+//# sourceMappingURL=browse_links.js.map

package/dist/client/browse_links.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browse_links.js","sourceRoot":"","sources":["../../src/client/browse_links.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAE7E,gFAAgF;AAChF,MAAM,UAAU,gBAAgB,CAC9B,KAAiB,EACjB,OAAgB,EAChB,QAAkB;IAElB,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACpC,IAAI,CAAC,MAAM,IAAI,KAAK,CAAC,gBAAgB;QAAE,OAAO,SAAS,CAAC;IACxD,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;IAChD,OAAO,oBAAoB,CAAC;QAC1B,QAAQ,EAAE,MAAM,CAAC,YAAY,CAAC,UAAU,CAAC;QACzC,QAAQ,EACN,KAAK,CAAC,OAAO;YACb,KAAK,CAAC,OAAO;YACb,KAAK,CAAC,QAAQ;YACd,KAAK,CAAC,MAAM;YACZ,KAAK,CAAC,MAAM,KAAK,CAAC;QACpB,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,UAAU,EAAE,GAAG,CAAC,MAAM,KAAK,QAAQ,CAAC,MAAM;QAC1C,YAAY,EACV,oBAAoB,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,IAAI,GAAG,CAAC,IAAI,KAAK,EAAE;QACtE,MAAM,EAAE,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,IAAI,EAAE;KAC5C,CAAC;QACA,CAAC,CAAC,GAAG,CAAC,IAAI;QACV,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC"}

package/dist/client/browse_navigation.d.ts

@@ -0,0 +1,23 @@
+/** Durable disclosure preferences for Browse navigation groups. */
+/** Storage subset used by navigation disclosure preferences. */
+export interface NavPreferenceStorage {
+    getItem(key: string): string | null;
+    setItem(key: string, value: string): void;
+}
+/** Whether a value identifies a current or legacy navigation disclosure. */
+export declare function isNavDisclosureKey(value: string): boolean;
+/** Match a current disclosure key, including an old unsectioned collection key. */
+export declare function isNavDisclosureClosed(closed: ReadonlySet<string>, key: string): boolean;
+/** Remember closed groups by stable collection id. */
+export declare class NavDisclosurePreference {
+    #private;
+    constructor(storage?: NavPreferenceStorage | undefined);
+    /** Apply an explicit stored preference without replacing server defaults. */
+    apply(doc: Document): void;
+    /** Capture and persist the current closed-group set. */
+    remember(doc: Document): void;
+    private read;
+}
+/** Create a preference without failing when browser storage is unavailable. */
+export declare function createBrowserNavPreference(win: Window & typeof globalThis): NavDisclosurePreference;
+//# sourceMappingURL=browse_navigation.d.ts.map

package/dist/client/browse_navigation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browse_navigation.d.ts","sourceRoot":"","sources":["../../src/client/browse_navigation.ts"],"names":[],"mappings":"AAAA,mEAAmE;AAEnE,gEAAgE;AAChE,MAAM,WAAW,oBAAoB;IACnC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACpC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3C;AAID,4EAA4E;AAC5E,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAMzD;AAED,mFAAmF;AACnF,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,EAC3B,GAAG,EAAE,MAAM,GACV,OAAO,CAQT;AAED,sDAAsD;AACtD,qBAAa,uBAAuB;;gBAItB,OAAO,GAAE,oBAAoB,GAAG,SAAqB;IAKjE,6EAA6E;IAC7E,KAAK,CAAC,GAAG,EAAE,QAAQ,GAAG,IAAI;IAS1B,wDAAwD;IACxD,QAAQ,CAAC,GAAG,EAAE,QAAQ,GAAG,IAAI;IAa7B,OAAO,CAAC,IAAI;CAgBb;AAED,+EAA+E;AAC/E,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,MAAM,GAAG,OAAO,UAAU,GAC9B,uBAAuB,CAMzB"}

package/dist/client/browse_navigation.js

@@ -0,0 +1,83 @@
+/** Durable disclosure preferences for Browse navigation groups. */
+const NAV_DISCLOSURE_KEY = "mokly:nav-disclosure:v2";
+/** Whether a value identifies a current or legacy navigation disclosure. */
+export function isNavDisclosureKey(value) {
+    return (value.startsWith("collection:") ||
+        value === "section:pages" ||
+        value === "section:components");
+}
+/** Match a current disclosure key, including an old unsectioned collection key. */
+export function isNavDisclosureClosed(closed, key) {
+    if (closed.has(key))
+        return true;
+    for (const prefix of ["collection:pages:", "collection:components:"]) {
+        if (key.startsWith(prefix)) {
+            return closed.has(`collection:${key.slice(prefix.length)}`);
+        }
+    }
+    return false;
+}
+/** Remember closed groups by stable collection id. */
+export class NavDisclosurePreference {
+    #storage;
+    #closed;
+    constructor(storage = undefined) {
+        this.#storage = storage;
+        this.#closed = this.read();
+    }
+    /** Apply an explicit stored preference without replacing server defaults. */
+    apply(doc) {
+        if (!this.#closed)
+            return;
+        for (const group of navigationGroups(doc)) {
+            const key = group.getAttribute("data-nav-disclosure");
+            if (key && isNavDisclosureKey(key))
+                group.open = !isNavDisclosureClosed(this.#closed, key);
+        }
+    }
+    /** Capture and persist the current closed-group set. */
+    remember(doc) {
+        const closed = navigationGroups(doc).flatMap((group) => {
+            const key = group.getAttribute("data-nav-disclosure");
+            return !group.open && key && isNavDisclosureKey(key) ? [key] : [];
+        });
+        this.#closed = new Set(closed);
+        try {
+            this.#storage?.setItem(NAV_DISCLOSURE_KEY, JSON.stringify(closed));
+        }
+        catch {
+            // In-memory state still preserves the choice for this document.
+        }
+    }
+    read() {
+        try {
+            const value = this.#storage?.getItem(NAV_DISCLOSURE_KEY);
+            if (value === null || value === undefined)
+                return undefined;
+            const parsed = JSON.parse(value);
+            if (!Array.isArray(parsed) ||
+                !parsed.every((item) => typeof item === "string")) {
+                return undefined;
+            }
+            return new Set(parsed.filter(isNavDisclosureKey));
+        }
+        catch {
+            return undefined;
+        }
+    }
+}
+/** Create a preference without failing when browser storage is unavailable. */
+export function createBrowserNavPreference(win) {
+    try {
+        return new NavDisclosurePreference(win.localStorage);
+    }
+    catch {
+        return new NavDisclosurePreference();
+    }
+}
+function navigationGroups(doc) {
+    return [
+        ...doc.querySelectorAll("details[data-nav-disclosure]"),
+    ];
+}
+//# sourceMappingURL=browse_navigation.js.map

package/dist/client/browse_navigation.js.map

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

package/dist/client/browse_navigation_state.d.ts

@@ -0,0 +1,27 @@
+/** Catalogue-tree filtering and active-route visibility invariants. */
+/** Facts needed to decide which active-row constraints must change. */
+export interface NavigationConstraintFacts {
+    changed: boolean;
+    changedOnly: boolean;
+    id?: string;
+    query: string;
+    route: string;
+    tags: readonly string[];
+    text: string;
+}
+/** Minimal control changes needed to reveal one destination row. */
+export interface NavigationConstraintChanges {
+    clearQuery: boolean;
+    showAll: boolean;
+}
+/** How a visibility update should affect navigation-group disclosure. */
+export type NavigationDisclosurePolicy = "preserve" | "reveal-matches";
+/** Why the active route's navigation path is being revealed. */
+export type NavigationRevealCause = "navigation" | "recovery";
+/** Determine which user constraints actually hide a destination. */
+export declare function navigationConstraintChanges(facts: NavigationConstraintFacts): NavigationConstraintChanges;
+/** Apply the current navigation controls with an explicit disclosure policy. */
+export declare function applyNavVisibility(doc: Document, disclosure: NavigationDisclosurePolicy): void;
+/** Select one route and disclose, reveal, and scroll its catalogue row. */
+export declare function selectAndRevealRoute(doc: Document, pathname: string, baseHref: string, cause: NavigationRevealCause): HTMLAnchorElement | undefined;
+//# sourceMappingURL=browse_navigation_state.d.ts.map

package/dist/client/browse_navigation_state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browse_navigation_state.d.ts","sourceRoot":"","sources":["../../src/client/browse_navigation_state.ts"],"names":[],"mappings":"AAAA,uEAAuE;AAQvE,uEAAuE;AACvE,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;IACrB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,oEAAoE;AACpE,MAAM,WAAW,2BAA2B;IAC1C,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,yEAAyE;AACzE,MAAM,MAAM,0BAA0B,GAAG,UAAU,GAAG,gBAAgB,CAAC;AAEvE,gEAAgE;AAChE,MAAM,MAAM,qBAAqB,GAAG,YAAY,GAAG,UAAU,CAAC;AAE9D,oEAAoE;AACpE,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,yBAAyB,GAC/B,2BAA2B,CAM7B;AAED,gFAAgF;AAChF,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,QAAQ,EACb,UAAU,EAAE,0BAA0B,GACrC,IAAI,CAiCN;AAED,2EAA2E;AAC3E,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,QAAQ,EACb,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,qBAAqB,GAC3B,iBAAiB,GAAG,SAAS,CAuD/B"}

package/dist/client/browse_navigation_state.js

@@ -0,0 +1,132 @@
+/** Catalogue-tree filtering and active-route visibility invariants. */
+import { parseSearchQuery, queryConstrains, rowMatchesQuery, } from "./search_query.js";
+/** Determine which user constraints actually hide a destination. */
+export function navigationConstraintChanges(facts) {
+    const matchesQuery = rowMatchesQuery(parseSearchQuery(facts.query), facts);
+    return {
+        clearQuery: !matchesQuery,
+        showAll: facts.changedOnly && !facts.changed,
+    };
+}
+/** Apply the current navigation controls with an explicit disclosure policy. */
+export function applyNavVisibility(doc, disclosure) {
+    const query = parseSearchQuery(doc.querySelector("[data-mokly-search]")?.value ?? "");
+    const changedOnly = doc
+        .querySelector('[data-filter="changed"]')
+        ?.getAttribute("aria-pressed") === "true";
+    const status = doc.querySelector("[data-changes-status]")
+        ?.dataset["changesStatus"];
+    const waiting = changedOnly && status !== undefined && status !== "ready";
+    let visible = false;
+    for (const row of doc.querySelectorAll("[data-nav-row]")) {
+        const matchesFilter = changedOnly
+            ? row.getAttribute("data-changed") === "true"
+            : !row.hasAttribute("data-removed-page");
+        row.hidden =
+            waiting || !(matchesFilter && rowMatchesQuery(query, navRowFacts(row)));
+        visible ||= !row.hidden;
+    }
+    const notice = doc.querySelector("[data-nav-status]");
+    if (notice) {
+        notice.hidden = !changedOnly || (!waiting && visible);
+        const text = notice.querySelector("[data-nav-status-text]");
+        if (text && status === "ready")
+            text.textContent = queryConstrains(query)
+                ? "No matching changes."
+                : "No changes found.";
+    }
+    doc
+        .querySelector("[data-mokly-nav-scroll]")
+        ?.setAttribute("aria-busy", String(waiting && status === "pending"));
+    applyGroupVisibility(doc, queryConstrains(query) || changedOnly, disclosure);
+}
+/** Select one route and disclose, reveal, and scroll its catalogue row. */
+export function selectAndRevealRoute(doc, pathname, baseHref, cause) {
+    const rows = [...doc.querySelectorAll("a[data-nav-row]")];
+    let active;
+    for (const row of rows) {
+        const matches = active === undefined &&
+            new URL(row.getAttribute("href") ?? "", baseHref).pathname === pathname;
+        if (matches) {
+            active = row;
+            row.setAttribute("aria-current", "page");
+        }
+        else {
+            row.removeAttribute("aria-current");
+        }
+    }
+    if (!active)
+        return undefined;
+    const search = doc.querySelector("[data-mokly-search]");
+    const changedOnly = doc
+        .querySelector('[data-filter="changed"]')
+        ?.getAttribute("aria-pressed") === "true";
+    const changes = navigationConstraintChanges({
+        changed: active.getAttribute("data-changed") === "true",
+        changedOnly,
+        query: search?.value ?? "",
+        ...navRowFacts(active),
+    });
+    if (changes.clearQuery && search)
+        search.value = "";
+    if (changes.showAll) {
+        for (const option of doc.querySelectorAll("[data-filter]")) {
+            option.setAttribute("aria-pressed", option.getAttribute("data-filter") === "all" ? "true" : "false");
+        }
+    }
+    applyNavVisibility(doc, "preserve");
+    let ancestor = active.closest("details[data-nav-disclosure]");
+    while (ancestor) {
+        const wasOpen = ancestor.open;
+        ancestor.open = true;
+        if (ancestor.dataset["filterOpen"] !== undefined &&
+            (cause === "navigation" || !wasOpen)) {
+            ancestor.dataset["filterOpen"] = "1";
+        }
+        ancestor =
+            ancestor.parentElement?.closest("details[data-nav-disclosure]") ?? null;
+    }
+    active.scrollIntoView({ block: "nearest" });
+    return active;
+}
+function navRowFacts(row) {
+    const id = row.getAttribute("data-entry-id");
+    return {
+        ...(id === null ? {} : { id }),
+        route: row.getAttribute("data-route") ?? "",
+        tags: (row.getAttribute("data-tags") ?? "")
+            .split(/\s+/)
+            .filter((tag) => tag !== ""),
+        text: row.textContent ?? "",
+    };
+}
+function applyGroupVisibility(doc, filtering, disclosure) {
+    const groups = [
+        ...doc.querySelectorAll("details[data-nav-disclosure]"),
+    ];
+    if (filtering) {
+        for (const group of groups) {
+            if (group.dataset["filterOpen"] === undefined) {
+                group.dataset["filterOpen"] = group.open ? "1" : "0";
+            }
+            if (disclosure === "reveal-matches")
+                group.open = true;
+        }
+        for (const group of [...groups].reverse()) {
+            const visible = [
+                ...group.querySelectorAll("[data-nav-row]"),
+            ].some((row) => !row.hidden);
+            group.hidden = !visible;
+        }
+        return;
+    }
+    for (const group of groups) {
+        const saved = group.dataset["filterOpen"];
+        if (saved !== undefined) {
+            group.open = saved === "1";
+            delete group.dataset["filterOpen"];
+        }
+        group.hidden = false;
+    }
+}
+//# sourceMappingURL=browse_navigation_state.js.map

package/dist/client/browse_navigation_state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browse_navigation_state.js","sourceRoot":"","sources":["../../src/client/browse_navigation_state.ts"],"names":[],"mappings":"AAAA,uEAAuE;AAEvE,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAyB3B,oEAAoE;AACpE,MAAM,UAAU,2BAA2B,CACzC,KAAgC;IAEhC,MAAM,YAAY,GAAG,eAAe,CAAC,gBAAgB,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC;IAC3E,OAAO;QACL,UAAU,EAAE,CAAC,YAAY;QACzB,OAAO,EAAE,KAAK,CAAC,WAAW,IAAI,CAAC,KAAK,CAAC,OAAO;KAC7C,CAAC;AACJ,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,kBAAkB,CAChC,GAAa,EACb,UAAsC;IAEtC,MAAM,KAAK,GAAG,gBAAgB,CAC5B,GAAG,CAAC,aAAa,CAAmB,qBAAqB,CAAC,EAAE,KAAK,IAAI,EAAE,CACxE,CAAC;IACF,MAAM,WAAW,GACf,GAAG;SACA,aAAa,CAAC,yBAAyB,CAAC;QACzC,EAAE,YAAY,CAAC,cAAc,CAAC,KAAK,MAAM,CAAC;IAC9C,MAAM,MAAM,GAAG,GAAG,CAAC,aAAa,CAAc,uBAAuB,CAAC;QACpE,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;IAC7B,MAAM,OAAO,GAAG,WAAW,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,OAAO,CAAC;IAC1E,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,KAAK,MAAM,GAAG,IAAI,GAAG,CAAC,gBAAgB,CAAc,gBAAgB,CAAC,EAAE,CAAC;QACtE,MAAM,aAAa,GAAG,WAAW;YAC/B,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC,cAAc,CAAC,KAAK,MAAM;YAC7C,CAAC,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC,mBAAmB,CAAC,CAAC;QAC3C,GAAG,CAAC,MAAM;YACR,OAAO,IAAI,CAAC,CAAC,aAAa,IAAI,eAAe,CAAC,KAAK,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAC1E,OAAO,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC;IAC1B,CAAC;IACD,MAAM,MAAM,GAAG,GAAG,CAAC,aAAa,CAAc,mBAAmB,CAAC,CAAC;IACnE,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,CAAC,MAAM,GAAG,CAAC,WAAW,IAAI,CAAC,CAAC,OAAO,IAAI,OAAO,CAAC,CAAC;QACtD,MAAM,IAAI,GAAG,MAAM,CAAC,aAAa,CAAC,wBAAwB,CAAC,CAAC;QAC5D,IAAI,IAAI,IAAI,MAAM,KAAK,OAAO;YAC5B,IAAI,CAAC,WAAW,GAAG,eAAe,CAAC,KAAK,CAAC;gBACvC,CAAC,CAAC,sBAAsB;gBACxB,CAAC,CAAC,mBAAmB,CAAC;IAC5B,CAAC;IACD,GAAG;SACA,aAAa,CAAC,yBAAyB,CAAC;QACzC,EAAE,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,OAAO,IAAI,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC;IACvE,oBAAoB,CAAC,GAAG,EAAE,eAAe,CAAC,KAAK,CAAC,IAAI,WAAW,EAAE,UAAU,CAAC,CAAC;AAC/E,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,oBAAoB,CAClC,GAAa,EACb,QAAgB,EAChB,QAAgB,EAChB,KAA4B;IAE5B,MAAM,IAAI,GAAG,CAAC,GAAG,GAAG,CAAC,gBAAgB,CAAoB,iBAAiB,CAAC,CAAC,CAAC;IAC7E,IAAI,MAAqC,CAAC;IAC1C,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,OAAO,GACX,MAAM,KAAK,SAAS;YACpB,IAAI,GAAG,CAAC,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,QAAQ,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC;QAC1E,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,GAAG,GAAG,CAAC;YACb,GAAG,CAAC,YAAY,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;QAC3C,CAAC;aAAM,CAAC;YACN,GAAG,CAAC,eAAe,CAAC,cAAc,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;IACD,IAAI,CAAC,MAAM;QAAE,OAAO,SAAS,CAAC;IAC9B,MAAM,MAAM,GAAG,GAAG,CAAC,aAAa,CAAmB,qBAAqB,CAAC,CAAC;IAC1E,MAAM,WAAW,GACf,GAAG;SACA,aAAa,CAAC,yBAAyB,CAAC;QACzC,EAAE,YAAY,CAAC,cAAc,CAAC,KAAK,MAAM,CAAC;IAC9C,MAAM,OAAO,GAAG,2BAA2B,CAAC;QAC1C,OAAO,EAAE,MAAM,CAAC,YAAY,CAAC,cAAc,CAAC,KAAK,MAAM;QACvD,WAAW;QACX,KAAK,EAAE,MAAM,EAAE,KAAK,IAAI,EAAE;QAC1B,GAAG,WAAW,CAAC,MAAM,CAAC;KACvB,CAAC,CAAC;IACH,IAAI,OAAO,CAAC,UAAU,IAAI,MAAM;QAAE,MAAM,CAAC,KAAK,GAAG,EAAE,CAAC;IACpD,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACpB,KAAK,MAAM,MAAM,IAAI,GAAG,CAAC,gBAAgB,CAAc,eAAe,CAAC,EAAE,CAAC;YACxE,MAAM,CAAC,YAAY,CACjB,cAAc,EACd,MAAM,CAAC,YAAY,CAAC,aAAa,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAChE,CAAC;QACJ,CAAC;IACH,CAAC;IACD,kBAAkB,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;IACpC,IAAI,QAAQ,GAAG,MAAM,CAAC,OAAO,CAC3B,8BAA8B,CAC/B,CAAC;IACF,OAAO,QAAQ,EAAE,CAAC;QAChB,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC;QAC9B,QAAQ,CAAC,IAAI,GAAG,IAAI,CAAC;QACrB,IACE,QAAQ,CAAC,OAAO,CAAC,YAAY,CAAC,KAAK,SAAS;YAC5C,CAAC,KAAK,KAAK,YAAY,IAAI,CAAC,OAAO,CAAC,EACpC,CAAC;YACD,QAAQ,CAAC,OAAO,CAAC,YAAY,CAAC,GAAG,GAAG,CAAC;QACvC,CAAC;QACD,QAAQ;YACN,QAAQ,CAAC,aAAa,EAAE,OAAO,CAC7B,8BAA8B,CAC/B,IAAI,IAAI,CAAC;IACd,CAAC;IACD,MAAM,CAAC,cAAc,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IAC5C,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,WAAW,CAAC,GAAY;IAM/B,MAAM,EAAE,GAAG,GAAG,CAAC,YAAY,CAAC,eAAe,CAAC,CAAC;IAC7C,OAAO;QACL,GAAG,CAAC,EAAE,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC;QAC9B,KAAK,EAAE,GAAG,CAAC,YAAY,CAAC,YAAY,CAAC,IAAI,EAAE;QAC3C,IAAI,EAAE,CAAC,GAAG,CAAC,YAAY,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;aACxC,KAAK,CAAC,KAAK,CAAC;aACZ,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC;QAC9B,IAAI,EAAE,GAAG,CAAC,WAAW,IAAI,EAAE;KAC5B,CAAC;AACJ,CAAC;AAED,SAAS,oBAAoB,CAC3B,GAAa,EACb,SAAkB,EAClB,UAAsC;IAEtC,MAAM,MAAM,GAAG;QACb,GAAG,GAAG,CAAC,gBAAgB,CAAqB,8BAA8B,CAAC;KAC5E,CAAC;IACF,IAAI,SAAS,EAAE,CAAC;QACd,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,IAAI,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,KAAK,SAAS,EAAE,CAAC;gBAC9C,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;YACvD,CAAC;YACD,IAAI,UAAU,KAAK,gBAAgB;gBAAE,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC;QACzD,CAAC;QACD,KAAK,MAAM,KAAK,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC;YAC1C,MAAM,OAAO,GAAG;gBACd,GAAG,KAAK,CAAC,gBAAgB,CAAc,gBAAgB,CAAC;aACzD,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAC7B,KAAK,CAAC,MAAM,GAAG,CAAC,OAAO,CAAC;QAC1B,CAAC;QACD,OAAO;IACT,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QAC1C,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,KAAK,CAAC,IAAI,GAAG,KAAK,KAAK,GAAG,CAAC;YAC3B,OAAO,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QACrC,CAAC;QACD,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC;IACvB,CAAC;AACH,CAAC"}

package/dist/client/browse_recovery.d.ts

@@ -0,0 +1,4 @@
+/** Strict validation of one-shot Browse recovery from untrusted session storage. */
+import type { BrowseRecoveryState } from "./browse_state.js";
+export declare function parseBrowseRecoveryState(value: unknown): BrowseRecoveryState | undefined;
+//# sourceMappingURL=browse_recovery.d.ts.map

package/dist/client/browse_recovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browse_recovery.d.ts","sourceRoot":"","sources":["../../src/client/browse_recovery.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAE7D,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,OAAO,GACb,mBAAmB,GAAG,SAAS,CAmDjC"}

package/dist/client/browse_recovery.js

@@ -0,0 +1,61 @@
+export function parseBrowseRecoveryState(value) {
+    if (!record(value))
+        return undefined;
+    const changedOnly = value["changedOnly"];
+    const changesStatus = value["changesStatus"];
+    const colorScheme = value["colorScheme"];
+    const storedFilterBaselineClosedCollectionIds = value["filterBaselineClosedCollectionIds"];
+    const filterBaselineClosedCollectionIds = storedFilterBaselineClosedCollectionIds === undefined
+        ? null
+        : storedFilterBaselineClosedCollectionIds;
+    const query = value["query"];
+    const viewport = value["viewport"];
+    if (typeof changedOnly !== "boolean" ||
+        (changesStatus !== undefined &&
+            changesStatus !== "pending" &&
+            changesStatus !== "ready" &&
+            changesStatus !== "unavailable") ||
+        !stringArray(value["closedCollectionIds"]) ||
+        (colorScheme !== "dark" && colorScheme !== "light") ||
+        typeof value["detailsOpen"] !== "boolean" ||
+        typeof value["drawerOpen"] !== "boolean" ||
+        !nonNegativeNumber(value["navScroll"]) ||
+        typeof query !== "string" ||
+        !scrollRecord(value["regionScrolls"]) ||
+        (viewport !== "both" && viewport !== "desktop" && viewport !== "mobile"))
+        return undefined;
+    if (filterBaselineClosedCollectionIds !== null &&
+        (!stringArray(filterBaselineClosedCollectionIds) ||
+            (!changedOnly && query.trim() === "")))
+        return undefined;
+    return {
+        changedOnly,
+        ...(changesStatus ? { changesStatus } : {}),
+        closedCollectionIds: [...new Set(value["closedCollectionIds"])],
+        colorScheme,
+        detailsOpen: value["detailsOpen"],
+        drawerOpen: value["drawerOpen"],
+        filterBaselineClosedCollectionIds: filterBaselineClosedCollectionIds === null
+            ? null
+            : [...new Set(filterBaselineClosedCollectionIds)],
+        navScroll: value["navScroll"],
+        query,
+        regionScrolls: { ...value["regionScrolls"] },
+        viewport,
+    };
+}
+function nonNegativeNumber(value) {
+    return typeof value === "number" && Number.isFinite(value) && value >= 0;
+}
+function record(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function scrollRecord(value) {
+    return (record(value) &&
+        Object.values(value).every((entry) => nonNegativeNumber(entry)));
+}
+function stringArray(value) {
+    return (Array.isArray(value) &&
+        value.every((item) => typeof item === "string" && item.length > 0));
+}
+//# sourceMappingURL=browse_recovery.js.map

package/dist/client/browse_recovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browse_recovery.js","sourceRoot":"","sources":["../../src/client/browse_recovery.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,wBAAwB,CACtC,KAAc;IAEd,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IACrC,MAAM,WAAW,GAAG,KAAK,CAAC,aAAa,CAAC,CAAC;IACzC,MAAM,aAAa,GAAG,KAAK,CAAC,eAAe,CAAC,CAAC;IAC7C,MAAM,WAAW,GAAG,KAAK,CAAC,aAAa,CAAC,CAAC;IACzC,MAAM,uCAAuC,GAC3C,KAAK,CAAC,mCAAmC,CAAC,CAAC;IAC7C,MAAM,iCAAiC,GACrC,uCAAuC,KAAK,SAAS;QACnD,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,uCAAuC,CAAC;IAC9C,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC;IAC7B,MAAM,QAAQ,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC;IACnC,IACE,OAAO,WAAW,KAAK,SAAS;QAChC,CAAC,aAAa,KAAK,SAAS;YAC1B,aAAa,KAAK,SAAS;YAC3B,aAAa,KAAK,OAAO;YACzB,aAAa,KAAK,aAAa,CAAC;QAClC,CAAC,WAAW,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;QAC1C,CAAC,WAAW,KAAK,MAAM,IAAI,WAAW,KAAK,OAAO,CAAC;QACnD,OAAO,KAAK,CAAC,aAAa,CAAC,KAAK,SAAS;QACzC,OAAO,KAAK,CAAC,YAAY,CAAC,KAAK,SAAS;QACxC,CAAC,iBAAiB,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QACtC,OAAO,KAAK,KAAK,QAAQ;QACzB,CAAC,YAAY,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;QACrC,CAAC,QAAQ,KAAK,MAAM,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,QAAQ,CAAC;QAExE,OAAO,SAAS,CAAC;IACnB,IACE,iCAAiC,KAAK,IAAI;QAC1C,CAAC,CAAC,WAAW,CAAC,iCAAiC,CAAC;YAC9C,CAAC,CAAC,WAAW,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QAExC,OAAO,SAAS,CAAC;IACnB,OAAO;QACL,WAAW;QACX,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3C,mBAAmB,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC,CAAC;QAC/D,WAAW;QACX,WAAW,EAAE,KAAK,CAAC,aAAa,CAAC;QACjC,UAAU,EAAE,KAAK,CAAC,YAAY,CAAC;QAC/B,iCAAiC,EAC/B,iCAAiC,KAAK,IAAI;YACxC,CAAC,CAAC,IAAI;YACN,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,iCAAiC,CAAC,CAAC;QACrD,SAAS,EAAE,KAAK,CAAC,WAAW,CAAC;QAC7B,KAAK;QACL,aAAa,EAAE,EAAE,GAAG,KAAK,CAAC,eAAe,CAAC,EAAE;QAC5C,QAAQ;KACT,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAc;IACvC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AAC3E,CAAC;AAED,SAAS,MAAM,CAAC,KAAc;IAC5B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,YAAY,CACnB,KAAc;IAEd,OAAO,CACL,MAAM,CAAC,KAAK,CAAC;QACb,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAChE,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,KAAc;IACjC,OAAO,CACL,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACpB,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CACnE,CAAC;AACJ,CAAC"}

package/dist/client/browse_refresh.d.ts

@@ -0,0 +1,2 @@
+export declare function refreshBrowseEvidence(doc: Document, win: Window & typeof globalThis, version: number, signal: AbortSignal): Promise<number | undefined>;
+//# sourceMappingURL=browse_refresh.d.ts.map

package/dist/client/browse_refresh.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browse_refresh.d.ts","sourceRoot":"","sources":["../../src/client/browse_refresh.ts"],"names":[],"mappings":"AASA,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,QAAQ,EACb,GAAG,EAAE,MAAM,GAAG,OAAO,UAAU,EAC/B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAgD7B"}

package/dist/client/browse_refresh.js

@@ -0,0 +1,50 @@
+/** Latest snapshot delivery for same-content background updates, fenced against navigation. */
+import { applyNavigationEvidence } from "./browse_evidence.js";
+import { navigationPending, readPageStamp, waitForNavigation, } from "./browse_update_state.js";
+import { workspaceEvidence } from "./workspace_updates.js";
+export async function refreshBrowseEvidence(doc, win, version, signal) {
+    if (!readPageStamp(doc))
+        return;
+    while (!signal.aborted) {
+        await waitForNavigation(doc, signal);
+        const href = win.location.href;
+        const view = doc.querySelector("[data-mokly-view]")?.firstElementChild;
+        const response = await win.fetch(href, {
+            signal,
+            cache: "no-store",
+            headers: { accept: "text/html" },
+        });
+        const html = await response.text();
+        signal.throwIfAborted();
+        if (navigationPending(doc) ||
+            href !== win.location.href ||
+            view !== doc.querySelector("[data-mokly-view]")?.firstElementChild)
+            continue;
+        if (!response.ok || response.url !== href.split("#")[0])
+            return;
+        const next = new win.DOMParser().parseFromString(html, "text/html");
+        const current = readPageStamp(doc);
+        const stamp = readPageStamp(next);
+        if (!current ||
+            !stamp ||
+            stamp.content !== current.content ||
+            stamp.version < Math.max(version, current.version) ||
+            doc
+                .querySelector("[data-mokly-view]")
+                ?.getAttribute("data-mokly-baseline") !==
+                next
+                    .querySelector("[data-mokly-view]")
+                    ?.getAttribute("data-mokly-baseline"))
+            return;
+        const evidence = workspaceEvidence(doc, next);
+        if (!evidence)
+            return;
+        applyNavigationEvidence(doc, next);
+        evidence();
+        doc.documentElement.setAttribute("data-mokly-update-version", String(stamp.version));
+        doc.dispatchEvent(new win.Event("mokly:evidence-updated"));
+        return stamp.version;
+    }
+    return undefined;
+}
+//# sourceMappingURL=browse_refresh.js.map

package/dist/client/browse_refresh.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browse_refresh.js","sourceRoot":"","sources":["../../src/client/browse_refresh.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAC/F,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EACL,iBAAiB,EACjB,aAAa,EACb,iBAAiB,GAClB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,GAAa,EACb,GAA+B,EAC/B,OAAe,EACf,MAAmB;IAEnB,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC;QAAE,OAAO;IAChC,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACvB,MAAM,iBAAiB,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACrC,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC;QAC/B,MAAM,IAAI,GAAG,GAAG,CAAC,aAAa,CAAC,mBAAmB,CAAC,EAAE,iBAAiB,CAAC;QACvE,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE;YACrC,MAAM;YACN,KAAK,EAAE,UAAU;YACjB,OAAO,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE;SACjC,CAAC,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QACnC,MAAM,CAAC,cAAc,EAAE,CAAC;QACxB,IACE,iBAAiB,CAAC,GAAG,CAAC;YACtB,IAAI,KAAK,GAAG,CAAC,QAAQ,CAAC,IAAI;YAC1B,IAAI,KAAK,GAAG,CAAC,aAAa,CAAC,mBAAmB,CAAC,EAAE,iBAAiB;YAElE,SAAS;QACX,IAAI,CAAC,QAAQ,CAAC,EAAE,IAAI,QAAQ,CAAC,GAAG,KAAK,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YAAE,OAAO;QAChE,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,SAAS,EAAE,CAAC,eAAe,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;QACpE,MAAM,OAAO,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;QACnC,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;QAClC,IACE,CAAC,OAAO;YACR,CAAC,KAAK;YACN,KAAK,CAAC,OAAO,KAAK,OAAO,CAAC,OAAO;YACjC,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC;YAClD,GAAG;iBACA,aAAa,CAAC,mBAAmB,CAAC;gBACnC,EAAE,YAAY,CAAC,qBAAqB,CAAC;gBACrC,IAAI;qBACD,aAAa,CAAC,mBAAmB,CAAC;oBACnC,EAAE,YAAY,CAAC,qBAAqB,CAAC;YAEzC,OAAO;QACT,MAAM,QAAQ,GAAG,iBAAiB,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC9C,IAAI,CAAC,QAAQ;YAAE,OAAO;QACtB,uBAAuB,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACnC,QAAQ,EAAE,CAAC;QACX,GAAG,CAAC,eAAe,CAAC,YAAY,CAC9B,2BAA2B,EAC3B,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CACtB,CAAC;QACF,GAAG,CAAC,aAAa,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC,CAAC;QAC3D,OAAO,KAAK,CAAC,OAAO,CAAC;IACvB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}