@concordance-wiki/site 0.1.0

package/dist/islands/trail.js

@@ -0,0 +1,223 @@
+/** The key of the pinned trail in `localStorage`, and of the tab's own trail in `sessionStorage`. */
+export const TRAIL_STORAGE_KEY = "concordance-trail";
+/** The fragment parameter carrying the trail: `#trail=<id>,<id>`, each identifier URL-encoded. */
+export const TRAIL_HASH_PARAMETER = "trail";
+/** How many entries the trail lists in full; beyond, the oldest are condensed into one expandable entry. */
+export 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 const TRAIL_KEPT_MAX = 50;
+/** The identifiers of the trail in a fragment, or none when the fragment carries no trail. */
+export function parseTrailHash(hash) {
+    const prefix = `${TRAIL_HASH_PARAMETER}=`;
+    const value = hash.replace(/^#/, "");
+    if (!value.startsWith(prefix)) {
+        return null;
+    }
+    const ids = [];
+    for (const part of value.slice(prefix.length).split(",")) {
+        try {
+            const id = decodeURIComponent(part);
+            if (id !== "") {
+                ids.push(id);
+            }
+        }
+        catch {
+            // A malformed escape: the entry is unreadable, the rest of the trail still is.
+        }
+    }
+    return ids;
+}
+export function trailHash(ids) {
+    return `#${TRAIL_HASH_PARAMETER}=${ids.map((id) => encodeURIComponent(id)).join(",")}`;
+}
+/** The fields of a parsed JSON value, all unknown; none for anything but an object. */
+function fields(value) {
+    if (typeof value !== "object" || value === null) {
+        return null;
+    }
+    const record = { ...value };
+    return record;
+}
+function isPage(value) {
+    const record = fields(value);
+    return record !== null && typeof record.id === "string" && typeof record.title === "string";
+}
+/** The trail a storage holds, or none when nothing valid is stored or storage cannot be read. */
+export function readTrail(storage) {
+    try {
+        const raw = storage.getItem(TRAIL_STORAGE_KEY);
+        const entries = raw === null ? undefined : fields(JSON.parse(raw))?.entries;
+        return Array.isArray(entries) && entries.every(isPage) ? { entries } : null;
+    }
+    catch {
+        return null;
+    }
+}
+/** Stores a trail; a failing storage is ignored, the trail still lives in the page and its URL. */
+export function writeTrail(storage, entries) {
+    try {
+        if (entries === null) {
+            storage.removeItem(TRAIL_STORAGE_KEY);
+        }
+        else {
+            storage.setItem(TRAIL_STORAGE_KEY, JSON.stringify({ entries }));
+        }
+    }
+    catch {
+        // Storage disabled: the trail holds for this page only.
+    }
+}
+/** The trail with the current page at its end, once, the oldest entries dropped beyond the limit. */
+export function appendPage(entries, current) {
+    const last = entries.at(-1);
+    const kept = last?.id === current.id ? entries.slice(0, -1) : entries;
+    return [...kept, current].slice(-TRAIL_KEPT_MAX);
+}
+/** Within the limit, everything is shown; beyond, the entries over the limit and one more are condensed. */
+export function condense(entries, max = TRAIL_SHOWN_MAX) {
+    if (entries.length <= max) {
+        return { earlier: [], shown: [...entries] };
+    }
+    const cut = entries.length - (max - 1);
+    return { earlier: entries.slice(0, cut), shown: entries.slice(cut) };
+}
+function sameIds(entries, ids) {
+    return entries.length === ids.length && entries.every((entry, index) => entry.id === ids[index]);
+}
+/**
+ * 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 function resolveTrail(hash, session, pinned, current) {
+    const titles = new Map();
+    for (const entry of [...(pinned?.entries ?? []), ...(session?.entries ?? [])]) {
+        titles.set(entry.id, entry.title);
+    }
+    const ids = parseTrailHash(hash) ??
+        session?.entries.map((entry) => entry.id) ??
+        pinned?.entries.map((entry) => entry.id) ??
+        [];
+    const entries = ids.map((id) => ({ id, title: titles.get(id) ?? id }));
+    return {
+        entries: current === undefined ? entries : appendPage(entries, current),
+        pinned: pinned !== null && sameIds(pinned.entries, ids),
+    };
+}
+/**
+ * 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 function carryTrail(anchor, hash, location) {
+    let target;
+    let page;
+    try {
+        target = new URL(anchor.href);
+        page = new URL(location.href);
+    }
+    catch {
+        return false;
+    }
+    if (target.protocol !== page.protocol ||
+        target.host !== page.host ||
+        target.hash !== "" ||
+        anchor.hasAttribute("download")) {
+        return false;
+    }
+    anchor.setAttribute("href", `${(anchor.getAttribute("href") ?? "").replace(/#$/, "")}${hash}`);
+    return true;
+}
+function element(doc, tag, attributes, children) {
+    const node = doc.createElement(tag);
+    for (const [name, value] of Object.entries(attributes)) {
+        node.setAttribute(name, value);
+    }
+    node.append(...children);
+    return node;
+}
+function list(doc, props, entries, current) {
+    return element(doc, "ol", { class: "trail-list" }, entries.map((entry) => element(doc, "li", {}, [
+        element(doc, "a", {
+            href: `${props.base}${entry.id}/index.html`,
+            ...(entry === current ? { "aria-current": "page" } : {}),
+        }, [entry.title]),
+    ])));
+}
+function trailList(doc, props, entries) {
+    const { earlier, shown } = condense(entries);
+    // The current page is the last entry when the page is an entity's; the other pages record none.
+    const current = props.current === undefined ? undefined : entries.at(-1);
+    const nodes = list(doc, props, shown, current);
+    if (earlier.length > 0) {
+        const summary = element(doc, "summary", {}, [
+            `… ${String(earlier.length)} ${props.labels.earlier}`,
+        ]);
+        const details = element(doc, "details", { class: "trail-earlier" }, [
+            summary,
+            list(doc, props, earlier, current),
+        ]);
+        nodes.prepend(element(doc, "li", {}, [details]));
+    }
+    return nodes;
+}
+/**
+ * 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 function wireTrail(target, env) {
+    // Written by island() at build: the attribute carries the props of the trail.
+    const props = JSON.parse(target.getAttribute("data-props") ?? "null");
+    if (props === null) {
+        return false;
+    }
+    const doc = env.document;
+    const resolved = resolveTrail(env.location.hash, readTrail(env.session), readTrail(env.local), props.current);
+    const { entries } = resolved;
+    let pinned = resolved.pinned;
+    const nav = element(doc, "nav", { class: "trail", "aria-label": props.labels.title }, []);
+    if (entries.length === 0) {
+        nav.append(element(doc, "p", { class: "trail-empty" }, [props.labels.empty]));
+        target.replaceChildren(nav);
+        return true;
+    }
+    const ids = entries.map((entry) => entry.id);
+    const hash = trailHash(ids);
+    writeTrail(env.session, entries);
+    if (pinned) {
+        writeTrail(env.local, entries);
+    }
+    const current = env.location.hash;
+    if (current !== hash && (current === "" || parseTrailHash(current) !== null)) {
+        try {
+            env.history.replaceState(null, "", hash);
+        }
+        catch {
+            // A history that refuses fragments: the links still carry the trail.
+        }
+    }
+    const button = element(doc, "button", { type: "button", class: "trail-pin" }, []);
+    const showPin = () => {
+        button.setAttribute("aria-pressed", pinned ? "true" : "false");
+        button.textContent = pinned ? props.labels.unpin : props.labels.pin;
+    };
+    button.addEventListener("click", () => {
+        pinned = !pinned;
+        writeTrail(env.local, pinned ? entries : null);
+        showPin();
+    });
+    showPin();
+    nav.append(trailList(doc, props, entries), button);
+    target.replaceChildren(nav);
+    doc.addEventListener("click", (event) => {
+        // The target is an element, which has `closest`, or the document, which has not; `a[href]` only yields anchors.
+        const origin = event.target;
+        const anchor = origin.closest?.("a[href]");
+        if (anchor !== undefined && anchor !== null) {
+            carryTrail(anchor, hash, env.location);
+        }
+    });
+    return true;
+}
+//# sourceMappingURL=trail.js.map

package/dist/islands/trail.js.map

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

package/dist/islands/viewer-pdf.client.d.ts

@@ -0,0 +1,7 @@
+import type { ViewerHandle, ViewerOptions } from "./document-viewer.js";
+/**
+ * The entry of the viewer bundle, imported on demand by the document island: points pdf.js at
+ * its worker bundle, then opens the PDF in the host.
+ */
+export declare function openViewer(host: HTMLElement, options: ViewerOptions): Promise<ViewerHandle>;
+//# sourceMappingURL=viewer-pdf.client.d.ts.map

package/dist/islands/viewer-pdf.client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewer-pdf.client.d.ts","sourceRoot":"","sources":["../../src/islands/viewer-pdf.client.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAMxE;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAG3F"}

package/dist/islands/viewer-pdf.client.js

@@ -0,0 +1,13 @@
+import { getDocument, GlobalWorkerOptions, } from "pdfjs-dist/legacy/build/pdf.mjs";
+import { createViewer } from "./viewer-pdf.js";
+/** pdf.js as the viewer sees it; the viewport type is the library's, so that its pages accept it back. */
+const library = { getDocument };
+/**
+ * The entry of the viewer bundle, imported on demand by the document island: points pdf.js at
+ * its worker bundle, then opens the PDF in the host.
+ */
+export function openViewer(host, options) {
+    GlobalWorkerOptions.workerSrc = new URL(options.workerHref, host.ownerDocument.baseURI).href;
+    return createViewer(library, host, options);
+}
+//# sourceMappingURL=viewer-pdf.client.js.map

package/dist/islands/viewer-pdf.client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewer-pdf.client.js","sourceRoot":"","sources":["../../src/islands/viewer-pdf.client.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,mBAAmB,GAEpB,MAAM,iCAAiC,CAAC;AAGzC,OAAO,EAAE,YAAY,EAAmB,MAAM,iBAAiB,CAAC;AAEhE,0GAA0G;AAC1G,MAAM,OAAO,GAA6B,EAAE,WAAW,EAAE,CAAC;AAE1D;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,IAAiB,EAAE,OAAsB;IAClE,mBAAmB,CAAC,SAAS,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,UAAU,EAAE,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC;IAC7F,OAAO,YAAY,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;AAC9C,CAAC"}

package/dist/islands/viewer-pdf.d.ts

@@ -0,0 +1,50 @@
+import type { ViewerHandle, ViewerOptions, ViewerPosition } from "./document-viewer.js";
+/**
+ * The part of pdf.js the viewer uses, so that the logic is tested against a double; the viewport
+ * type is the library's own, handed back to it untouched.
+ */
+export interface PdfViewport {
+    width: number;
+    height: number;
+}
+export interface PdfPage<V extends PdfViewport> {
+    getViewport(params: {
+        scale: number;
+    }): V;
+    render(params: {
+        canvas: HTMLCanvasElement;
+        viewport: V;
+    }): {
+        promise: Promise<void>;
+    };
+}
+export interface PdfDocument<V extends PdfViewport> {
+    numPages: number;
+    getPage(number: number): Promise<PdfPage<V>>;
+}
+/** The loading of a document: its promise, and the release of everything once the viewer closes. */
+export interface PdfLoadingTask<V extends PdfViewport> {
+    promise: Promise<PdfDocument<V>>;
+    destroy(): Promise<void>;
+}
+export interface PdfLibrary<V extends PdfViewport> {
+    getDocument(params: {
+        url: string;
+    }): PdfLoadingTask<V>;
+}
+export declare const ZOOM_STEPS: readonly number[];
+export declare const DEFAULT_ZOOM = 1;
+/** The positions whose text contains the query, case folded; none for a blank query. */
+export declare function matchingPositions(positions: readonly ViewerPosition[], query: string): number[];
+/** The step next to the current zoom in the given direction, the ends holding. */
+export declare function nextZoom(current: number, direction: 1 | -1): number;
+/** The zoom as the toolbar shows it, a percentage with a space before its sign. */
+export declare function zoomLabel(zoom: number): string;
+/**
+ * Opens the PDF in the host with pdf.js: one page drawn on a canvas at a time, reached through
+ * `goTo` as the strip of the page asks, zoom in and out over fixed steps, and a find box over
+ * the extracted text of the positions that jumps to the first matching page and counts the
+ * others. The rail of the page follows through `onPage`.
+ */
+export declare function createViewer<V extends PdfViewport>(pdf: PdfLibrary<V>, host: HTMLElement, options: ViewerOptions): Promise<ViewerHandle>;
+//# sourceMappingURL=viewer-pdf.d.ts.map

package/dist/islands/viewer-pdf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewer-pdf.d.ts","sourceRoot":"","sources":["../../src/islands/viewer-pdf.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAExF;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,OAAO,CAAC,CAAC,SAAS,WAAW;IAC5C,WAAW,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,CAAC,CAAC;IAC1C,MAAM,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,iBAAiB,CAAC;QAAC,QAAQ,EAAE,CAAC,CAAA;KAAE,GAAG;QAAE,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE,CAAC;CACxF;AAED,MAAM,WAAW,WAAW,CAAC,CAAC,SAAS,WAAW;IAChD,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;CAC9C;AAED,oGAAoG;AACpG,MAAM,WAAW,cAAc,CAAC,CAAC,SAAS,WAAW;IACnD,OAAO,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;IACjC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED,MAAM,WAAW,UAAU,CAAC,CAAC,SAAS,WAAW;IAC/C,WAAW,CAAC,MAAM,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;CACzD;AAED,eAAO,MAAM,UAAU,EAAE,SAAS,MAAM,EAAoC,CAAC;AAC7E,eAAO,MAAM,YAAY,IAAI,CAAC;AAE9B,wFAAwF;AACxF,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,SAAS,cAAc,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAM/F;AAED,kFAAkF;AAClF,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,MAAM,CAInE;AAoCD,mFAAmF;AACnF,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9C;AAwCD;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,CAAC,SAAS,WAAW,EACtD,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,EAClB,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,YAAY,CAAC,CA6EvB"}

package/dist/islands/viewer-pdf.js

@@ -0,0 +1,157 @@
+export const ZOOM_STEPS = [0.5, 0.75, 1, 1.25, 1.5, 2, 3];
+export const DEFAULT_ZOOM = 1;
+/** The positions whose text contains the query, case folded; none for a blank query. */
+export function matchingPositions(positions, query) {
+    const needle = query.trim().toLocaleLowerCase();
+    if (needle === "")
+        return [];
+    return positions
+        .filter((position) => position.text.toLocaleLowerCase().includes(needle))
+        .map((position) => position.number);
+}
+/** The step next to the current zoom in the given direction, the ends holding. */
+export function nextZoom(current, direction) {
+    const index = ZOOM_STEPS.indexOf(current);
+    const next = ZOOM_STEPS[index + direction];
+    return next ?? current;
+}
+/** A button drawn as a glyph, named for assistive technology. */
+function button(doc, glyph, label, className) {
+    const element = doc.createElement("button");
+    element.type = "button";
+    element.className = className;
+    element.textContent = glyph;
+    element.setAttribute("aria-label", label);
+    return element;
+}
+function span(doc, className, text = "") {
+    const element = doc.createElement("span");
+    element.className = className;
+    element.textContent = text;
+    return element;
+}
+function separator(doc) {
+    const element = span(doc, "viewer-separator", "|");
+    element.setAttribute("aria-hidden", "true");
+    return element;
+}
+/** The zoom as the toolbar shows it, a percentage with a space before its sign. */
+export function zoomLabel(zoom) {
+    return `${String(Math.round(zoom * 100))} %`;
+}
+/**
+ * The toolbar and the stage of the viewer, appended to the host: the counter of the position
+ * shown, the zoom between its two buttons, the find field over the extracted text with its
+ * status, then the canvas on its stage. The pages are reached through the strip of the page,
+ * which drives the viewer.
+ */
+function buildControls(host, options) {
+    const doc = host.ownerDocument;
+    const { labels } = options;
+    const toolbar = doc.createElement("div");
+    toolbar.className = "viewer-toolbar";
+    toolbar.setAttribute("role", "toolbar");
+    const counter = span(doc, "viewer-counter");
+    counter.setAttribute("aria-live", "polite");
+    const zoomOut = button(doc, "\u2212", labels.zoomOut, "viewer-zoom-out");
+    const zoom = span(doc, "viewer-zoom");
+    const zoomIn = button(doc, "+", labels.zoomIn, "viewer-zoom-in");
+    const findLabel = doc.createElement("label");
+    findLabel.className = "viewer-find";
+    const glyph = span(doc, "viewer-find-glyph", "\u2315");
+    glyph.setAttribute("aria-hidden", "true");
+    findLabel.append(glyph, span(doc, "visually-hidden", labels.findInDocument));
+    const find = doc.createElement("input");
+    find.type = "search";
+    find.placeholder = labels.inTheDocument;
+    findLabel.append(find);
+    const status = span(doc, "viewer-status");
+    status.setAttribute("role", "status");
+    toolbar.append(counter, separator(doc), zoomOut, zoom, zoomIn, separator(doc), findLabel, status);
+    const stage = doc.createElement("div");
+    stage.className = "viewer-stage";
+    const canvas = doc.createElement("canvas");
+    canvas.className = "viewer-page";
+    stage.append(canvas);
+    host.replaceChildren(toolbar, stage);
+    return { counter, zoomOut, zoom, zoomIn, find, status, canvas };
+}
+/**
+ * Opens the PDF in the host with pdf.js: one page drawn on a canvas at a time, reached through
+ * `goTo` as the strip of the page asks, zoom in and out over fixed steps, and a find box over
+ * the extracted text of the positions that jumps to the first matching page and counts the
+ * others. The rail of the page follows through `onPage`.
+ */
+export async function createViewer(pdf, host, options) {
+    const task = pdf.getDocument({ url: options.pdfHref });
+    const document = await task.promise;
+    const controls = buildControls(host, options);
+    let current = 1;
+    let zoom = DEFAULT_ZOOM;
+    let matches = [];
+    let rendering = Promise.resolve();
+    let wanted = "";
+    const draw = async () => {
+        const page = await document.getPage(current);
+        const viewport = page.getViewport({ scale: zoom });
+        controls.canvas.width = Math.ceil(viewport.width);
+        controls.canvas.height = Math.ceil(viewport.height);
+        controls.canvas.setAttribute("aria-label", `${options.labels.unit} ${String(current)} / ${String(document.numPages)}`);
+        await page.render({ canvas: controls.canvas, viewport }).promise;
+    };
+    const refresh = () => {
+        controls.counter.replaceChildren(span(host.ownerDocument, "visually-hidden", `${options.labels.unit} `), `${String(current)} / ${String(document.numPages)}`);
+        controls.zoom.textContent = zoomLabel(zoom);
+        controls.zoomOut.disabled = nextZoom(zoom, -1) === zoom;
+        controls.zoomIn.disabled = nextZoom(zoom, 1) === zoom;
+        // Renders queue up so that a fast reader never sees two pages race for the canvas, and a
+        // queued render that a later request made stale is skipped.
+        const asked = `${String(current)}@${String(zoom)}`;
+        wanted = asked;
+        const attempt = () => (wanted === asked ? draw() : Promise.resolve());
+        rendering = rendering.then(attempt, attempt);
+        options.onPage?.(current);
+    };
+    const goTo = (number) => {
+        if (!Number.isInteger(number) || number < 1 || number > document.numPages)
+            return;
+        current = number;
+        refresh();
+    };
+    const showMatches = () => {
+        if (controls.find.value.trim() === "") {
+            controls.status.textContent = "";
+            return;
+        }
+        const positions = matches.map((match) => `${options.labels.unit} ${String(match)}`).join(", ");
+        controls.status.textContent =
+            matches.length === 0
+                ? options.labels.noMatch
+                : `${String(matches.length)} ${options.labels.matchesOn} ${positions}`;
+    };
+    controls.zoomOut.addEventListener("click", () => {
+        zoom = nextZoom(zoom, -1);
+        refresh();
+    });
+    controls.zoomIn.addEventListener("click", () => {
+        zoom = nextZoom(zoom, 1);
+        refresh();
+    });
+    controls.find.addEventListener("input", () => {
+        matches = matchingPositions(options.positions, controls.find.value);
+        showMatches();
+        const [first] = matches;
+        if (first !== undefined && first !== current)
+            goTo(first);
+    });
+    refresh();
+    await rendering;
+    return {
+        goTo,
+        close: () => {
+            host.replaceChildren();
+            void task.destroy();
+        },
+    };
+}
+//# sourceMappingURL=viewer-pdf.js.map

package/dist/islands/viewer-pdf.js.map

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

package/dist/markdown/figures.d.ts

@@ -0,0 +1,16 @@
+/** Class of the figure an image of the sources stands in, when it holds a paragraph of its own. */
+export declare const FIGURE_CLASS = "figure";
+/** Class of the caption of a figure: the alternative text of the image, as the author wrote it. */
+export declare const FIGURE_CAPTION_CLASS = "figure-caption";
+/** Class of the path of the file of a figure in its repository, the last line of its caption. */
+export declare const FIGURE_PATH_CLASS = "figure-path";
+/** Class of the note a theme sets before the path, saying what the image is. */
+export declare const FIGURE_NOTE_CLASS = "figure-note";
+/**
+ * Sets the note of a theme under every figure of a rendered section, before the path of the
+ * file: the renderer leaves the caption and the path, which say nothing of the language of the
+ * site, and the theme words what the image is. The opening of the path is the renderer's own
+ * markup; a note never writes it, since its raw HTML is dropped and its code spans carry no class.
+ */
+export declare function withImageNotes(html: string, note: string): string;
+//# sourceMappingURL=figures.d.ts.map

package/dist/markdown/figures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"figures.d.ts","sourceRoot":"","sources":["../../src/markdown/figures.ts"],"names":[],"mappings":"AAAA,mGAAmG;AACnG,eAAO,MAAM,YAAY,WAAW,CAAC;AACrC,mGAAmG;AACnG,eAAO,MAAM,oBAAoB,mBAAmB,CAAC;AACrD,iGAAiG;AACjG,eAAO,MAAM,iBAAiB,gBAAgB,CAAC;AAC/C,gFAAgF;AAChF,eAAO,MAAM,iBAAiB,gBAAgB,CAAC;AAY/C;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAKjE"}

package/dist/markdown/figures.js

@@ -0,0 +1,26 @@
+/** Class of the figure an image of the sources stands in, when it holds a paragraph of its own. */
+export const FIGURE_CLASS = "figure";
+/** Class of the caption of a figure: the alternative text of the image, as the author wrote it. */
+export const FIGURE_CAPTION_CLASS = "figure-caption";
+/** Class of the path of the file of a figure in its repository, the last line of its caption. */
+export const FIGURE_PATH_CLASS = "figure-path";
+/** Class of the note a theme sets before the path, saying what the image is. */
+export const FIGURE_NOTE_CLASS = "figure-note";
+const FIGURE_PATH_OPENING = `<code class="${FIGURE_PATH_CLASS}">`;
+function escapeText(text) {
+    return text
+        .replaceAll("&", "&amp;")
+        .replaceAll("<", "&lt;")
+        .replaceAll(">", "&gt;")
+        .replaceAll('"', "&quot;");
+}
+/**
+ * Sets the note of a theme under every figure of a rendered section, before the path of the
+ * file: the renderer leaves the caption and the path, which say nothing of the language of the
+ * site, and the theme words what the image is. The opening of the path is the renderer's own
+ * markup; a note never writes it, since its raw HTML is dropped and its code spans carry no class.
+ */
+export function withImageNotes(html, note) {
+    return html.replaceAll(FIGURE_PATH_OPENING, `<span class="${FIGURE_NOTE_CLASS}">${escapeText(note)}</span>${FIGURE_PATH_OPENING}`);
+}
+//# sourceMappingURL=figures.js.map

package/dist/markdown/figures.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"figures.js","sourceRoot":"","sources":["../../src/markdown/figures.ts"],"names":[],"mappings":"AAAA,mGAAmG;AACnG,MAAM,CAAC,MAAM,YAAY,GAAG,QAAQ,CAAC;AACrC,mGAAmG;AACnG,MAAM,CAAC,MAAM,oBAAoB,GAAG,gBAAgB,CAAC;AACrD,iGAAiG;AACjG,MAAM,CAAC,MAAM,iBAAiB,GAAG,aAAa,CAAC;AAC/C,gFAAgF;AAChF,MAAM,CAAC,MAAM,iBAAiB,GAAG,aAAa,CAAC;AAE/C,MAAM,mBAAmB,GAAG,gBAAgB,iBAAiB,IAAI,CAAC;AAElE,SAAS,UAAU,CAAC,IAAY;IAC9B,OAAO,IAAI;SACR,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC;SACxB,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC;SACvB,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC;SACvB,UAAU,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;AAC/B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,IAAY;IACvD,OAAO,IAAI,CAAC,UAAU,CACpB,mBAAmB,EACnB,gBAAgB,iBAAiB,KAAK,UAAU,CAAC,IAAI,CAAC,UAAU,mBAAmB,EAAE,CACtF,CAAC;AACJ,CAAC"}

package/dist/markdown/marks.d.ts

@@ -0,0 +1,14 @@
+/**
+ * What a mark of the text tells on hover and to assistive technology, worded in the site
+ * language: the build sets it on every recognised word when it renders the fragments, before
+ * any page exists.
+ */
+export interface MarkLabels {
+    /** On a recognised word whose entity has a note: "note: <title>". */
+    note: (title: string) => string;
+    /** On a recognised expression that has a keyword page and no note: "N passages, no note". */
+    noNote: (passages: number) => string;
+}
+/** The wording of the marks in the language of the locale, from the shipped catalogue. */
+export declare function markLabels(locale: string): MarkLabels;
+//# sourceMappingURL=marks.d.ts.map

package/dist/markdown/marks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"marks.d.ts","sourceRoot":"","sources":["../../src/markdown/marks.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,qEAAqE;IACrE,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IAChC,6FAA6F;IAC7F,MAAM,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC;CACtC;AAED,0FAA0F;AAC1F,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAMrD"}

package/dist/markdown/marks.js

@@ -0,0 +1,10 @@
+import { formatMessage, loadCatalogue } from "@concordance-wiki/i18n";
+/** The wording of the marks in the language of the locale, from the shipped catalogue. */
+export function markLabels(locale) {
+    const catalogue = loadCatalogue(locale);
+    return {
+        note: (title) => formatMessage(catalogue, "entity.markNote", { title }),
+        noNote: (passages) => formatMessage(catalogue, "entity.markNoNote", { count: passages }),
+    };
+}
+//# sourceMappingURL=marks.js.map

package/dist/markdown/marks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"marks.js","sourceRoot":"","sources":["../../src/markdown/marks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AActE,0FAA0F;AAC1F,MAAM,UAAU,UAAU,CAAC,MAAc;IACvC,MAAM,SAAS,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IACxC,OAAO;QACL,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,aAAa,CAAC,SAAS,EAAE,iBAAiB,EAAE,EAAE,KAAK,EAAE,CAAC;QACvE,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,aAAa,CAAC,SAAS,EAAE,mBAAmB,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;KACzF,CAAC;AACJ,CAAC"}