@concordance-wiki/site 0.1.0

package/dist/islands/shards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shards.d.ts","sourceRoot":"","sources":["../../src/islands/shards.ts"],"names":[],"mappings":"AAEA,gHAAgH;AAChH,MAAM,MAAM,cAAc,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,KAAK,IAAI,CAAC;AAEpF,sEAAsE;AACtE,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;CAC1C;AAED,uFAAuF;AACvF,MAAM,WAAW,SAAS;IACxB,mBAAmB,CAAC,EAAE,aAAa,CAAC;CACrC;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,mBAAmB,CAAC,EAAE,aAAa,CAAC;KACrC;CACF;AAED,qHAAqH;AACrH,MAAM,MAAM,WAAW,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAE7D;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,SAAS,GAAG,WAAW,CA4B/F"}

package/dist/islands/shards.js

@@ -0,0 +1,39 @@
+import { shardHref } from "../search/shared.js";
+/**
+ * The loader of the index files of one page: each file is a classic script calling
+ * `window.__concordanceSearch.shard(name, data)`, so the loader exposes that global, injects
+ * the script, and resolves when the callback comes; a script that fails to load resolves to
+ * nothing. Loaded files are kept, so that a prefix typed again costs no request. Two loaders
+ * on one page, the search and the page served for a missing address, share the global: each
+ * receiver passes the callback on to the one it found, so that every loader hears its files.
+ */
+export function shardLoader(index, inject, host) {
+    const loaded = new Map();
+    const pending = new Map();
+    const earlier = host.__concordanceSearch;
+    host.__concordanceSearch = {
+        shard: (name, data) => {
+            earlier?.shard(name, data);
+            pending.get(name)?.(data);
+            pending.delete(name);
+        },
+    };
+    return (name) => {
+        const known = loaded.get(name);
+        if (known !== undefined) {
+            return known;
+        }
+        const promise = new Promise((resolve) => {
+            pending.set(name, resolve);
+            inject(shardHref(index, name), (ok) => {
+                if (!ok) {
+                    pending.delete(name);
+                    resolve(undefined);
+                }
+            });
+        });
+        loaded.set(name, promise);
+        return promise;
+    };
+}
+//# sourceMappingURL=shards.js.map

package/dist/islands/shards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shards.js","sourceRoot":"","sources":["../../src/islands/shards.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAwBhD;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW,CAAC,KAAa,EAAE,MAAsB,EAAE,IAAe;IAChF,MAAM,MAAM,GAAG,IAAI,GAAG,EAA4B,CAAC;IACnD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAmC,CAAC;IAC3D,MAAM,OAAO,GAAG,IAAI,CAAC,mBAAmB,CAAC;IACzC,IAAI,CAAC,mBAAmB,GAAG;QACzB,KAAK,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE;YACpB,OAAO,EAAE,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YAC3B,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;YAC1B,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACvB,CAAC;KACF,CAAC;IACF,OAAO,CAAC,IAAI,EAAE,EAAE;QACd,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC/B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,OAAO,KAAK,CAAC;QACf,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,OAAO,CAAU,CAAC,OAAO,EAAE,EAAE;YAC/C,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YAC3B,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE;gBACpC,IAAI,CAAC,EAAE,EAAE,CAAC;oBACR,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;oBACrB,OAAO,CAAC,SAAS,CAAC,CAAC;gBACrB,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC1B,OAAO,OAAO,CAAC;IACjB,CAAC,CAAC;AACJ,CAAC"}

package/dist/islands/tabs.client.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tabs.client.d.ts.map

package/dist/islands/tabs.client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tabs.client.d.ts","sourceRoot":"","sources":["../../src/islands/tabs.client.ts"],"names":[],"mappings":""}

package/dist/islands/tabs.client.js

@@ -0,0 +1,6 @@
+import { ISLAND_ELEMENT } from "./element.js";
+import { wireTabs } from "./tabs.js";
+for (const element of document.querySelectorAll(`${ISLAND_ELEMENT}[data-island="tabs"]`)) {
+    wireTabs(element, document, window);
+}
+//# sourceMappingURL=tabs.client.js.map

package/dist/islands/tabs.client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tabs.client.js","sourceRoot":"","sources":["../../src/islands/tabs.client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAErC,KAAK,MAAM,OAAO,IAAI,QAAQ,CAAC,gBAAgB,CAAC,GAAG,cAAc,sBAAsB,CAAC,EAAE,CAAC;IACzF,QAAQ,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;AACtC,CAAC"}

package/dist/islands/tabs.d.ts

@@ -0,0 +1,24 @@
+/** The class the island sets on the block once it drives the panels, so that the stylesheet stops showing them by target. */
+export declare const TABS_SCRIPTED = "tabs-scripted";
+/** The event the island dispatches on a panel it shows, so that what the panel holds can wake up. */
+export declare const TAB_SHOWN_EVENT = "concordance:tabshow";
+/** What the island needs from the window: the fragment, its silent replacement, and the changes of the fragment. */
+export interface TabsWindow {
+    location: {
+        hash: string;
+    };
+    history: {
+        replaceState(data: unknown, unused: string, url: string): void;
+    };
+    addEventListener(type: "hashchange", listener: () => void): void;
+}
+/**
+ * Drives one row of tabs: the panel shown is the one the fragment of the address names, or the
+ * one holding the element it names, else the first; following a tab shows its panel, marks it
+ * selected and writes its id in the address without scrolling; the arrow keys move the
+ * selection along the row, Home and End to its ends; a fragment naming an anchor inside a
+ * panel, followed from the page, shows that panel and scrolls to the anchor. A panel shown
+ * receives the `concordance:tabshow` event. Nothing is wired for a row without a panel.
+ */
+export declare function wireTabs(element: Element, doc: Document, win: TabsWindow): boolean;
+//# sourceMappingURL=tabs.d.ts.map

package/dist/islands/tabs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tabs.d.ts","sourceRoot":"","sources":["../../src/islands/tabs.ts"],"names":[],"mappings":"AAAA,6HAA6H;AAC7H,eAAO,MAAM,aAAa,kBAAkB,CAAC;AAE7C,qGAAqG;AACrG,eAAO,MAAM,eAAe,wBAAwB,CAAC;AAUrD,oHAAoH;AACpH,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3B,OAAO,EAAE;QAAE,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IAC5E,gBAAgB,CAAC,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;CAClE;AAED;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,UAAU,GAAG,OAAO,CAsDlF"}

package/dist/islands/tabs.js

@@ -0,0 +1,79 @@
+/** The class the island sets on the block once it drives the panels, so that the stylesheet stops showing them by target. */
+export const TABS_SCRIPTED = "tabs-scripted";
+/** The event the island dispatches on a panel it shows, so that what the panel holds can wake up. */
+export const TAB_SHOWN_EVENT = "concordance:tabshow";
+/** The keys of the tablist pattern: the arrows move the selection, Home and End jump to the ends. */
+const KEYS = {
+    ArrowRight: (index, count) => (index + 1) % count,
+    ArrowLeft: (index, count) => (index + count - 1) % count,
+    Home: () => 0,
+    End: (_index, count) => count - 1,
+};
+/**
+ * Drives one row of tabs: the panel shown is the one the fragment of the address names, or the
+ * one holding the element it names, else the first; following a tab shows its panel, marks it
+ * selected and writes its id in the address without scrolling; the arrow keys move the
+ * selection along the row, Home and End to its ends; a fragment naming an anchor inside a
+ * panel, followed from the page, shows that panel and scrolls to the anchor. A panel shown
+ * receives the `concordance:tabshow` event. Nothing is wired for a row without a panel.
+ */
+export function wireTabs(element, doc, win) {
+    const block = element.closest(".tabs");
+    const tabs = [...element.querySelectorAll('[role="tab"]')];
+    const shown = tabs.flatMap((tab) => {
+        const panel = doc.getElementById(tab.getAttribute("aria-controls") ?? "");
+        return panel === null ? [] : [panel];
+    });
+    if (block === null || shown.length === 0 || shown.length !== tabs.length)
+        return false;
+    const indexOf = (hash) => {
+        const id = hash.slice(1);
+        if (id === "")
+            return undefined;
+        const target = doc.getElementById(id);
+        const index = shown.findIndex((panel) => panel === target || panel.contains(target));
+        return index === -1 ? undefined : index;
+    };
+    const select = (index) => {
+        tabs.forEach((tab, at) => {
+            tab.setAttribute("aria-selected", at === index ? "true" : "false");
+            tab.setAttribute("tabindex", at === index ? "0" : "-1");
+        });
+        shown.forEach((panel, at) => {
+            panel.hidden = at !== index;
+        });
+        shown[index]?.dispatchEvent(new Event(TAB_SHOWN_EVENT));
+    };
+    const follow = (index) => {
+        select(index);
+        for (const panel of shown.slice(index, index + 1)) {
+            win.history.replaceState(null, "", `#${panel.id}`);
+        }
+    };
+    tabs.forEach((tab, index) => {
+        tab.addEventListener("click", (event) => {
+            event.preventDefault();
+            follow(index);
+        });
+        tab.addEventListener("keydown", (event) => {
+            const move = KEYS[event.key];
+            if (move === undefined)
+                return;
+            event.preventDefault();
+            const next = move(index, tabs.length);
+            follow(next);
+            tabs[next]?.focus();
+        });
+    });
+    win.addEventListener("hashchange", () => {
+        const index = indexOf(win.location.hash);
+        if (index === undefined)
+            return;
+        select(index);
+        doc.getElementById(win.location.hash.slice(1))?.scrollIntoView();
+    });
+    block.classList.add(TABS_SCRIPTED);
+    select(indexOf(win.location.hash) ?? 0);
+    return true;
+}
+//# sourceMappingURL=tabs.js.map

package/dist/islands/tabs.js.map

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

package/dist/islands/toc.client.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=toc.client.d.ts.map

package/dist/islands/toc.client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toc.client.d.ts","sourceRoot":"","sources":["../../src/islands/toc.client.ts"],"names":[],"mappings":""}

package/dist/islands/toc.client.js

@@ -0,0 +1,11 @@
+import { ISLAND_ELEMENT } from "./element.js";
+import { wireToc } from "./toc.js";
+const observe = typeof IntersectionObserver === "undefined"
+    ? undefined
+    : (callback, options) => new IntersectionObserver((entries) => {
+        callback(entries);
+    }, options);
+for (const element of document.querySelectorAll(`${ISLAND_ELEMENT}[data-island="toc"]`)) {
+    wireToc(element, document, observe);
+}
+//# sourceMappingURL=toc.client.js.map

package/dist/islands/toc.client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toc.client.js","sourceRoot":"","sources":["../../src/islands/toc.client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,OAAO,EAA4B,MAAM,UAAU,CAAC;AAE7D,MAAM,OAAO,GACX,OAAO,oBAAoB,KAAK,WAAW;IACzC,CAAC,CAAC,SAAS;IACX,CAAC,CAAC,CAAC,QAA6B,EAAE,OAA+B,EAAE,EAAE,CACjE,IAAI,oBAAoB,CAAC,CAAC,OAAO,EAAE,EAAE;QACnC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACpB,CAAC,EAAE,OAAO,CAAC,CAAC;AAEpB,KAAK,MAAM,OAAO,IAAI,QAAQ,CAAC,gBAAgB,CAAC,GAAG,cAAc,qBAAqB,CAAC,EAAE,CAAC;IACxF,OAAO,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;AACtC,CAAC"}

package/dist/islands/toc.d.ts

@@ -0,0 +1,37 @@
+/** A link of the table of contents, as the island marks it. */
+export interface TocLink {
+    getAttribute(name: string): string | null;
+    setAttribute(name: string, value: string): void;
+    removeAttribute(name: string): void;
+}
+/** The island element written at build, holding the list of links. */
+export interface TocElement {
+    querySelectorAll(selector: string): Iterable<TocLink>;
+}
+/** What the island needs from the document: the section a link points at. */
+export interface TocDocument {
+    getElementById(id: string): Element | null;
+}
+/** One observed section: whether its heading crossed into the band under the top of the viewport. */
+export interface TocEntryChange {
+    target: Element;
+    isIntersecting: boolean;
+}
+/** The part of `IntersectionObserver` the island uses, injected so that a document without it is left as served. */
+export interface TocObserver {
+    observe(target: Element): void;
+}
+export type TocObserverCallback = (changes: TocEntryChange[]) => void;
+export type TocObserverFactory = (callback: TocObserverCallback, options: {
+    rootMargin: string;
+}) => TocObserver;
+/** The band under the top of the viewport a heading enters to make its section the current one: the top third. */
+export declare const TOC_ROOT_MARGIN = "0px 0px -66% 0px";
+/**
+ * Marks the entry of the section being read: the last section whose heading entered the top
+ * third of the viewport, the first entry until any does. Every link keeps its `href`; only
+ * `aria-current` moves. Without an observer, or without any section to observe, the served
+ * mark stays on the first entry.
+ */
+export declare function wireToc(element: TocElement, doc: TocDocument, observe: TocObserverFactory | undefined): boolean;
+//# sourceMappingURL=toc.d.ts.map

package/dist/islands/toc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toc.d.ts","sourceRoot":"","sources":["../../src/islands/toc.ts"],"names":[],"mappings":"AAEA,+DAA+D;AAC/D,MAAM,WAAW,OAAO;IACtB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC1C,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAChD,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrC;AAED,sEAAsE;AACtE,MAAM,WAAW,UAAU;IACzB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;CACvD;AAED,6EAA6E;AAC7E,MAAM,WAAW,WAAW;IAC1B,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;CAC5C;AAED,qGAAqG;AACrG,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,OAAO,CAAC;IAChB,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,oHAAoH;AACpH,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;CAChC;AAED,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,EAAE,cAAc,EAAE,KAAK,IAAI,CAAC;AAEtE,MAAM,MAAM,kBAAkB,GAAG,CAC/B,QAAQ,EAAE,mBAAmB,EAC7B,OAAO,EAAE;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,KAC5B,WAAW,CAAC;AAEjB,kHAAkH;AAClH,eAAO,MAAM,eAAe,qBAAqB,CAAC;AAElD;;;;;GAKG;AACH,wBAAgB,OAAO,CACrB,OAAO,EAAE,UAAU,EACnB,GAAG,EAAE,WAAW,EAChB,OAAO,EAAE,kBAAkB,GAAG,SAAS,GACtC,OAAO,CA0CT"}

package/dist/islands/toc.js

@@ -0,0 +1,50 @@
+import { TOC_CURRENT } from "../theme/default/toc.js";
+/** The band under the top of the viewport a heading enters to make its section the current one: the top third. */
+export const TOC_ROOT_MARGIN = "0px 0px -66% 0px";
+/**
+ * Marks the entry of the section being read: the last section whose heading entered the top
+ * third of the viewport, the first entry until any does. Every link keeps its `href`; only
+ * `aria-current` moves. Without an observer, or without any section to observe, the served
+ * mark stays on the first entry.
+ */
+export function wireToc(element, doc, observe) {
+    const links = [...element.querySelectorAll('a[href^="#"]')];
+    const sections = links.map((link) => doc.getElementById((link.getAttribute("href") ?? "").slice(1)));
+    const observed = sections.filter((section) => section !== null);
+    if (observe === undefined || observed.length === 0) {
+        return false;
+    }
+    const visible = new Set();
+    const mark = () => {
+        let current = 0;
+        sections.forEach((section, index) => {
+            if (section !== null && visible.has(section)) {
+                current = index;
+            }
+        });
+        links.forEach((link, index) => {
+            if (index === current) {
+                link.setAttribute("aria-current", TOC_CURRENT);
+            }
+            else {
+                link.removeAttribute("aria-current");
+            }
+        });
+    };
+    const observer = observe((changes) => {
+        for (const change of changes) {
+            if (change.isIntersecting) {
+                visible.add(change.target);
+            }
+            else {
+                visible.delete(change.target);
+            }
+        }
+        mark();
+    }, { rootMargin: TOC_ROOT_MARGIN });
+    for (const section of observed) {
+        observer.observe(section);
+    }
+    return true;
+}
+//# sourceMappingURL=toc.js.map

package/dist/islands/toc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toc.js","sourceRoot":"","sources":["../../src/islands/toc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAqCtD,kHAAkH;AAClH,MAAM,CAAC,MAAM,eAAe,GAAG,kBAAkB,CAAC;AAElD;;;;;GAKG;AACH,MAAM,UAAU,OAAO,CACrB,OAAmB,EACnB,GAAgB,EAChB,OAAuC;IAEvC,MAAM,KAAK,GAAG,CAAC,GAAG,OAAO,CAAC,gBAAgB,CAAC,cAAc,CAAC,CAAC,CAAC;IAC5D,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAClC,GAAG,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAC/D,CAAC;IACF,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAsB,EAAE,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC;IACpF,IAAI,OAAO,KAAK,SAAS,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAW,CAAC;IACnC,MAAM,IAAI,GAAG,GAAS,EAAE;QACtB,IAAI,OAAO,GAAG,CAAC,CAAC;QAChB,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE;YAClC,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC7C,OAAO,GAAG,KAAK,CAAC;YAClB,CAAC;QACH,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;YAC5B,IAAI,KAAK,KAAK,OAAO,EAAE,CAAC;gBACtB,IAAI,CAAC,YAAY,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;YACjD,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,eAAe,CAAC,cAAc,CAAC,CAAC;YACvC,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;IACF,MAAM,QAAQ,GAAG,OAAO,CACtB,CAAC,OAAO,EAAE,EAAE;QACV,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,IAAI,MAAM,CAAC,cAAc,EAAE,CAAC;gBAC1B,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAC7B,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAChC,CAAC;QACH,CAAC;QACD,IAAI,EAAE,CAAC;IACT,CAAC,EACD,EAAE,UAAU,EAAE,eAAe,EAAE,CAChC,CAAC;IACF,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5B,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/islands/trail.client.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=trail.client.d.ts.map

package/dist/islands/trail.client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trail.client.d.ts","sourceRoot":"","sources":["../../src/islands/trail.client.ts"],"names":[],"mappings":""}

package/dist/islands/trail.client.js

@@ -0,0 +1,12 @@
+import { ISLAND_ELEMENT } from "./element.js";
+import { wireTrail } from "./trail.js";
+for (const element of document.querySelectorAll(`${ISLAND_ELEMENT}[data-island="trail"]`)) {
+    wireTrail(element, {
+        document,
+        location,
+        history,
+        local: localStorage,
+        session: sessionStorage,
+    });
+}
+//# sourceMappingURL=trail.client.js.map

package/dist/islands/trail.client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trail.client.js","sourceRoot":"","sources":["../../src/islands/trail.client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvC,KAAK,MAAM,OAAO,IAAI,QAAQ,CAAC,gBAAgB,CAAC,GAAG,cAAc,uBAAuB,CAAC,EAAE,CAAC;IAC1F,SAAS,CAAC,OAAO,EAAE;QACjB,QAAQ;QACR,QAAQ;QACR,OAAO;QACP,KAAK,EAAE,YAAY;QACnB,OAAO,EAAE,cAAc;KACxB,CAAC,CAAC;AACL,CAAC"}

package/dist/islands/trail.d.ts

@@ -0,0 +1,95 @@
+import type { TrailPage } from "../slots.js";
+/** The key of the pinned trail in `localStorage`, and of the tab's own trail in `sessionStorage`. */
+export declare const TRAIL_STORAGE_KEY = "concordance-trail";
+/** The fragment parameter carrying the trail: `#trail=<id>,<id>`, each identifier URL-encoded. */
+export declare const TRAIL_HASH_PARAMETER = "trail";
+/** How many entries the trail lists in full; beyond, the oldest are condensed into one expandable entry. */
+export declare const TRAIL_SHOWN_MAX = 12;
+/** How many entries the trail keeps at all; beyond, the oldest are dropped so that the URL stays short. */
+export declare const TRAIL_KEPT_MAX = 50;
+/** The part of a storage the trail uses; every call may throw when storage is disabled. */
+export interface TrailStorage {
+    getItem(key: string): string | null;
+    setItem(key: string, value: string): void;
+    removeItem(key: string): void;
+}
+export interface TrailLocation {
+    href: string;
+    hash: string;
+}
+export interface TrailHistory {
+    replaceState(data: unknown, unused: string, url: string): void;
+}
+/** A link of the page, as the click delegate sees it. */
+export interface TrailAnchor {
+    /** The absolute URL the link resolves to. */
+    href: string;
+    getAttribute(name: string): string | null;
+    setAttribute(name: string, value: string): void;
+    hasAttribute(name: string): boolean;
+}
+/** What the trail needs from the document: creating its elements, and hearing every click of the page. */
+export interface TrailDocument {
+    createElement<K extends keyof HTMLElementTagNameMap>(tag: K): HTMLElementTagNameMap[K];
+    addEventListener(type: "click", listener: (event: {
+        target: EventTarget | null;
+    }) => void): void;
+}
+export interface TrailEnvironment {
+    document: TrailDocument;
+    location: TrailLocation;
+    history: TrailHistory;
+    /** The pinned trail lives here, between visits. */
+    local: TrailStorage;
+    /** The trail of this tab lives here, so that a link keeping its own fragment does not lose it. */
+    session: TrailStorage;
+}
+/** The island element written at build, holding the serialised props and, once wired, the trail. */
+export interface TrailElement {
+    getAttribute(name: string): string | null;
+    replaceChildren(...nodes: Node[]): void;
+}
+/** What a storage holds under the key: the pages with their titles, so that a restored trail reads. */
+export interface StoredTrail {
+    entries: TrailPage[];
+}
+/** The identifiers of the trail in a fragment, or none when the fragment carries no trail. */
+export declare function parseTrailHash(hash: string): string[] | null;
+export declare function trailHash(ids: readonly string[]): string;
+/** The trail a storage holds, or none when nothing valid is stored or storage cannot be read. */
+export declare function readTrail(storage: TrailStorage): StoredTrail | null;
+/** Stores a trail; a failing storage is ignored, the trail still lives in the page and its URL. */
+export declare function writeTrail(storage: TrailStorage, entries: readonly TrailPage[] | null): void;
+/** The trail with the current page at its end, once, the oldest entries dropped beyond the limit. */
+export declare function appendPage(entries: readonly TrailPage[], current: TrailPage): TrailPage[];
+export interface CondensedTrail {
+    /** The oldest entries, at least two when there are any, folded into one summary. */
+    earlier: TrailPage[];
+    shown: TrailPage[];
+}
+/** Within the limit, everything is shown; beyond, the entries over the limit and one more are condensed. */
+export declare function condense(entries: readonly TrailPage[], max?: number): CondensedTrail;
+export interface ResolvedTrail {
+    entries: TrailPage[];
+    /** Whether the trail read is the pinned one, so that its growth is stored as well. */
+    pinned: boolean;
+}
+/**
+ * The trail of the page: the fragment first, else the tab's own, else the pinned one; the current
+ * page appended. Titles come from the storages, a page seen for the first time is named by its
+ * identifier.
+ */
+export declare function resolveTrail(hash: string, session: StoredTrail | null, pinned: StoredTrail | null, current: TrailPage | undefined): ResolvedTrail;
+/**
+ * Makes an internal link carry the trail: same protocol and host, no fragment of its own (a link
+ * to a passage keeps it, the tab's storage carries the trail instead), no download.
+ */
+export declare function carryTrail(anchor: TrailAnchor, hash: string, location: TrailLocation): boolean;
+/**
+ * Fills one island with the trail: the pages visited as an ordered list of links, the current one
+ * marked, and the pin button; remembers the trail in the tab, in the URL fragment when the page has
+ * no fragment of its own, and in the pinned storage when the trail is the pinned one; makes every
+ * internal link of the page carry it.
+ */
+export declare function wireTrail(target: TrailElement, env: TrailEnvironment): boolean;
+//# sourceMappingURL=trail.d.ts.map

package/dist/islands/trail.d.ts.map

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