@concordance-wiki/site 0.1.0

package/dist/islands/mode-switch.client.js

@@ -0,0 +1,14 @@
+import { ISLAND_ELEMENT } from "./element.js";
+import { displayedScheme, wireModeSwitch } from "./mode-switch.js";
+const root = document.documentElement;
+/** The scheme in force, read from the tokens layer; the system preference heard through its media query. */
+const view = {
+    displayed: () => displayedScheme((property) => getComputedStyle(root).getPropertyValue(property)),
+    onPreferenceChange: (listener) => {
+        matchMedia("(prefers-color-scheme: dark)").addEventListener("change", listener);
+    },
+};
+for (const element of document.querySelectorAll(`${ISLAND_ELEMENT}[data-island="mode-switch"]`)) {
+    wireModeSwitch(element, localStorage, root, view);
+}
+//# sourceMappingURL=mode-switch.client.js.map

package/dist/islands/mode-switch.client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mode-switch.client.js","sourceRoot":"","sources":["../../src/islands/mode-switch.client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,cAAc,EAAmB,MAAM,kBAAkB,CAAC;AAEpF,MAAM,IAAI,GAAG,QAAQ,CAAC,eAAe,CAAC;AAEtC,4GAA4G;AAC5G,MAAM,IAAI,GAAe;IACvB,SAAS,EAAE,GAAG,EAAE,CAAC,eAAe,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IACjG,kBAAkB,EAAE,CAAC,QAAQ,EAAE,EAAE;QAC/B,UAAU,CAAC,8BAA8B,CAAC,CAAC,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAClF,CAAC;CACF,CAAC;AAEF,KAAK,MAAM,OAAO,IAAI,QAAQ,CAAC,gBAAgB,CAAC,GAAG,cAAc,6BAA6B,CAAC,EAAE,CAAC;IAChG,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AACpD,CAAC"}

package/dist/islands/mode-switch.d.ts

@@ -0,0 +1,54 @@
+import type { ColourScheme } from "../css/tokens.js";
+import { type ModeChoice } from "../mode.js";
+/** The part of `localStorage` the switch uses; every call may throw when storage is disabled. */
+export interface ModeStorage {
+    getItem(key: string): string | null;
+    setItem(key: string, value: string): void;
+    removeItem(key: string): void;
+}
+/** The root element, whose `data-mode` the tokens layer reads. */
+export interface ModeRoot {
+    dataset: {
+        mode?: string;
+    };
+}
+/**
+ * What the page displays: the scheme the tokens layer put in force, whatever decided it, the
+ * theme's default, the system preference or a remembered choice; and a way to hear the system
+ * preference change while no choice is stored.
+ */
+export interface SchemeView {
+    displayed(): ColourScheme;
+    onPreferenceChange(listener: () => void): void;
+}
+export interface ModeSwitchText {
+    textContent: string | null;
+}
+export interface ModeSwitchButton {
+    hidden: boolean;
+    setAttribute(name: string, value: string): void;
+    addEventListener(type: "click", listener: () => void): void;
+    querySelector(selector: string): ModeSwitchText | null;
+}
+/** The island element written at build, holding the button; its label is written in the markup. */
+export interface ModeSwitchElement {
+    querySelector(selector: string): ModeSwitchButton | null;
+}
+/** Applies a choice to the root and remembers it; a failing storage still changes the page. */
+export declare function applyChoice(choice: ModeChoice, storage: ModeStorage, root: ModeRoot): void;
+/**
+ * The choice that displays the other scheme: nothing stored when the theme's default and the
+ * system preference already give it, so that the page follows the system again; the scheme
+ * itself otherwise, remembered until the reader switches back.
+ */
+export declare function toggleChoice(view: SchemeView, root: ModeRoot): ModeChoice;
+/** The scheme the tokens layer names on the root, read from its computed style; light when it names none. */
+export declare function displayedScheme(read: (property: string) => string): ColourScheme;
+/**
+ * Reveals the button of one island and makes it toggle the scheme: the glyph draws the scheme it
+ * switches to, a moon over a light page, a sun over a dark one, and the button is pressed while
+ * the dark scheme is displayed. The label written at build, "Dark mode", is the same in both
+ * states: the pressed state tells which one holds.
+ */
+export declare function wireModeSwitch(element: ModeSwitchElement, storage: ModeStorage, root: ModeRoot, view: SchemeView): boolean;
+//# sourceMappingURL=mode-switch.d.ts.map

package/dist/islands/mode-switch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mode-switch.d.ts","sourceRoot":"","sources":["../../src/islands/mode-switch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAA8C,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAEzF,iGAAiG;AACjG,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACpC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,kEAAkE;AAClE,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC5B;AAED;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,SAAS,IAAI,YAAY,CAAC;IAC1B,kBAAkB,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;CAChD;AAED,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,OAAO,CAAC;IAChB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAChD,gBAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IAC5D,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAAC;CACxD;AAED,mGAAmG;AACnG,MAAM,WAAW,iBAAiB;IAChC,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAAC;CAC1D;AAED,+FAA+F;AAC/F,wBAAgB,WAAW,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,GAAG,IAAI,CAe1F;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,GAAG,UAAU,CAIzE;AAED,6GAA6G;AAC7G,wBAAgB,eAAe,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,GAAG,YAAY,CAEhF;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,iBAAiB,EAC1B,OAAO,EAAE,WAAW,EACpB,IAAI,EAAE,QAAQ,EACd,IAAI,EAAE,UAAU,GACf,OAAO,CAqBT"}

package/dist/islands/mode-switch.js

@@ -0,0 +1,64 @@
+import { MODE_STORAGE_KEY, otherScheme, switchGlyph } from "../mode.js";
+/** Applies a choice to the root and remembers it; a failing storage still changes the page. */
+export function applyChoice(choice, storage, root) {
+    if (choice === "system") {
+        delete root.dataset.mode;
+    }
+    else {
+        root.dataset.mode = choice;
+    }
+    try {
+        if (choice === "system") {
+            storage.removeItem(MODE_STORAGE_KEY);
+        }
+        else {
+            storage.setItem(MODE_STORAGE_KEY, choice);
+        }
+    }
+    catch {
+        // Storage disabled: the choice holds for this page only.
+    }
+}
+/**
+ * The choice that displays the other scheme: nothing stored when the theme's default and the
+ * system preference already give it, so that the page follows the system again; the scheme
+ * itself otherwise, remembered until the reader switches back.
+ */
+export function toggleChoice(view, root) {
+    const target = otherScheme(view.displayed());
+    delete root.dataset.mode;
+    return view.displayed() === target ? "system" : target;
+}
+/** The scheme the tokens layer names on the root, read from its computed style; light when it names none. */
+export function displayedScheme(read) {
+    return read("--scheme").trim() === "dark" ? "dark" : "light";
+}
+/**
+ * Reveals the button of one island and makes it toggle the scheme: the glyph draws the scheme it
+ * switches to, a moon over a light page, a sun over a dark one, and the button is pressed while
+ * the dark scheme is displayed. The label written at build, "Dark mode", is the same in both
+ * states: the pressed state tells which one holds.
+ */
+export function wireModeSwitch(element, storage, root, view) {
+    const button = element.querySelector("button");
+    if (button === null) {
+        return false;
+    }
+    const glyph = button.querySelector(".mode-switch-glyph");
+    const show = () => {
+        const displayed = view.displayed();
+        button.setAttribute("aria-pressed", displayed === "dark" ? "true" : "false");
+        if (glyph !== null) {
+            glyph.textContent = switchGlyph(displayed);
+        }
+    };
+    button.addEventListener("click", () => {
+        applyChoice(toggleChoice(view, root), storage, root);
+        show();
+    });
+    view.onPreferenceChange(show);
+    show();
+    button.hidden = false;
+    return true;
+}
+//# sourceMappingURL=mode-switch.js.map

package/dist/islands/mode-switch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mode-switch.js","sourceRoot":"","sources":["../../src/islands/mode-switch.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,WAAW,EAAmB,MAAM,YAAY,CAAC;AAwCzF,+FAA+F;AAC/F,MAAM,UAAU,WAAW,CAAC,MAAkB,EAAE,OAAoB,EAAE,IAAc;IAClF,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;IAC3B,CAAC;SAAM,CAAC;QACN,IAAI,CAAC,OAAO,CAAC,IAAI,GAAG,MAAM,CAAC;IAC7B,CAAC;IACD,IAAI,CAAC;QACH,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;YACxB,OAAO,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC;QACvC,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,OAAO,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,yDAAyD;IAC3D,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,IAAgB,EAAE,IAAc;IAC3D,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;IAC7C,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;IACzB,OAAO,IAAI,CAAC,SAAS,EAAE,KAAK,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC;AACzD,CAAC;AAED,6GAA6G;AAC7G,MAAM,UAAU,eAAe,CAAC,IAAkC;IAChE,OAAO,IAAI,CAAC,UAAU,CAAC,CAAC,IAAI,EAAE,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;AAC/D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAC5B,OAA0B,EAC1B,OAAoB,EACpB,IAAc,EACd,IAAgB;IAEhB,MAAM,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;IAC/C,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QACpB,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,aAAa,CAAC,oBAAoB,CAAC,CAAC;IACzD,MAAM,IAAI,GAAG,GAAS,EAAE;QACtB,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QACnC,MAAM,CAAC,YAAY,CAAC,cAAc,EAAE,SAAS,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QAC7E,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACnB,KAAK,CAAC,WAAW,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC,CAAC;IACF,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE;QACpC,WAAW,CAAC,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;QACrD,IAAI,EAAE,CAAC;IACT,CAAC,CAAC,CAAC;IACH,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;IAC9B,IAAI,EAAE,CAAC;IACP,MAAM,CAAC,MAAM,GAAG,KAAK,CAAC;IACtB,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/islands/mount.d.ts

@@ -0,0 +1,11 @@
+import { type ComponentType, type JSX } from "preact";
+/** What a hydration entry needs from an island element: the serialised props. */
+export interface IslandElement {
+    getAttribute(name: string): string | null;
+}
+export interface IslandHost<E extends IslandElement> {
+    querySelectorAll(selector: string): Iterable<E>;
+}
+/** Mounts a component on every island of that name in the host; returns how many were mounted. */
+export declare function mountIslands<P extends object, E extends IslandElement>(name: string, Component: ComponentType<P>, host: IslandHost<E>, mount: (vnode: JSX.Element, element: E) => void): number;
+//# sourceMappingURL=mount.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mount.d.ts","sourceRoot":"","sources":["../../src/islands/mount.ts"],"names":[],"mappings":"AAAA,OAAO,EAAK,KAAK,aAAa,EAAE,KAAK,GAAG,EAAE,MAAM,QAAQ,CAAC;AAIzD,iFAAiF;AACjF,MAAM,WAAW,aAAa;IAC5B,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;CAC3C;AAED,MAAM,WAAW,UAAU,CAAC,CAAC,SAAS,aAAa;IACjD,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;CACjD;AAED,kGAAkG;AAClG,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,aAAa,EACpE,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,aAAa,CAAC,CAAC,CAAC,EAC3B,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,EACnB,KAAK,EAAE,CAAC,KAAK,EAAE,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC,KAAK,IAAI,GAC9C,MAAM,CASR"}

package/dist/islands/mount.js

@@ -0,0 +1,14 @@
+import { h } from "preact";
+import { ISLAND_ELEMENT } from "./element.js";
+/** Mounts a component on every island of that name in the host; returns how many were mounted. */
+export function mountIslands(name, Component, host, mount) {
+    let mounted = 0;
+    for (const element of host.querySelectorAll(`${ISLAND_ELEMENT}[data-island="${name}"]`)) {
+        // Written by island() at build: the attribute carries the props of this very component.
+        const props = JSON.parse(element.getAttribute("data-props") ?? "{}");
+        mount(h(Component, props), element);
+        mounted += 1;
+    }
+    return mounted;
+}
+//# sourceMappingURL=mount.js.map

package/dist/islands/mount.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mount.js","sourceRoot":"","sources":["../../src/islands/mount.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAgC,MAAM,QAAQ,CAAC;AAEzD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAW9C,kGAAkG;AAClG,MAAM,UAAU,YAAY,CAC1B,IAAY,EACZ,SAA2B,EAC3B,IAAmB,EACnB,KAA+C;IAE/C,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,gBAAgB,CAAC,GAAG,cAAc,iBAAiB,IAAI,IAAI,CAAC,EAAE,CAAC;QACxF,wFAAwF;QACxF,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,YAAY,CAAC,IAAI,IAAI,CAAM,CAAC;QAC1E,KAAK,CAAC,CAAC,CAAC,SAAS,EAAE,KAAK,CAAC,EAAE,OAAO,CAAC,CAAC;QACpC,OAAO,IAAI,CAAC,CAAC;IACf,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/islands/not-found.client.d.ts

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

package/dist/islands/not-found.client.d.ts.map

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

package/dist/islands/not-found.client.js

@@ -0,0 +1,18 @@
+import { ISLAND_ELEMENT } from "./element.js";
+import { NOT_FOUND_ISLAND, wireNotFound } from "./not-found.js";
+// A classic script, not a module: browsers load it from a file:// page, which they refuse to modules.
+function inject(src, done) {
+    const script = document.createElement("script");
+    script.src = src;
+    script.addEventListener("load", () => {
+        done(true);
+    });
+    script.addEventListener("error", () => {
+        done(false);
+    });
+    document.head.appendChild(script);
+}
+for (const element of document.querySelectorAll(`${ISLAND_ELEMENT}[data-island="${NOT_FOUND_ISLAND}"]`)) {
+    void wireNotFound(element, document, window, inject, window);
+}
+//# sourceMappingURL=not-found.client.js.map

package/dist/islands/not-found.client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"not-found.client.js","sourceRoot":"","sources":["../../src/islands/not-found.client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEhE,sGAAsG;AACtG,SAAS,MAAM,CAAC,GAAW,EAAE,IAA+B;IAC1D,MAAM,MAAM,GAAG,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;IAChD,MAAM,CAAC,GAAG,GAAG,GAAG,CAAC;IACjB,MAAM,CAAC,gBAAgB,CAAC,MAAM,EAAE,GAAG,EAAE;QACnC,IAAI,CAAC,IAAI,CAAC,CAAC;IACb,CAAC,CAAC,CAAC;IACH,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE;QACpC,IAAI,CAAC,KAAK,CAAC,CAAC;IACd,CAAC,CAAC,CAAC;IACH,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;AACpC,CAAC;AAED,KAAK,MAAM,OAAO,IAAI,QAAQ,CAAC,gBAAgB,CAC7C,GAAG,cAAc,iBAAiB,gBAAgB,IAAI,CACvD,EAAE,CAAC;IACF,KAAK,YAAY,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAC/D,CAAC"}

package/dist/islands/not-found.d.ts

@@ -0,0 +1,56 @@
+import { type SearchEntry } from "../search/shared.js";
+import type { NearbyPage } from "../slots.js";
+import type { NotFoundIslandProps } from "../theme/default/not-found.js";
+import { type ScriptInjector, type ShardHost } from "./shards.js";
+/** The island of the page served for a missing address: it reads the address and names the nearby pages and the query. */
+export declare const NOT_FOUND_ISLAND = "not-found";
+/** How many nearby addresses the page lists at most. */
+export declare const NEARBY_LIMIT = 3;
+/** The address of a page under the site, without its file name nor its trailing slash: `glossary/publication-threshold`. */
+export declare function pageAddress(path: string): string;
+/** The address asked for, under the site: the path of the location without the folder of the page itself. */
+export declare function missingAddress(pathname: string, baseUri: string): string;
+/** The edit distance between two addresses: insertions, deletions and substitutions of one character. */
+export declare function editDistance(a: string, b: string): number;
+/** The last segment of an address, the name of the page: `publication-threshold` for `glossary/publication-threshold`. */
+export declare function lastSegment(address: string): string;
+/** How far the name of a page may stand from the last segment of the missing address to be proposed: half its length, three characters at least. */
+export declare function nearbyThreshold(name: string): number;
+/**
+ * The pages whose address is closest to the missing one, by edit distance on the path: the
+ * name of the page, its last segment, against the last segment of the missing address first,
+ * so that a renamed file stands a character away and a moved file none, then the whole path,
+ * so that the nearest folder comes first among namesakes, then the order of the table; at most
+ * `NEARBY_LIMIT` of them and none whose name lies beyond the threshold. Each comes with its
+ * address under the site and its href from the root of the site.
+ */
+export declare function nearbyOf(missing: string, entries: readonly SearchEntry[], root: string): NearbyPage[];
+/** The query the missing address suggests: its last segment, the hyphens and underscores as spaces. */
+export declare function queryOf(missing: string): string;
+/** What the island needs from the window: the address asked for and the base the page resolves against. */
+export interface NotFoundWindow {
+    location: {
+        pathname: string;
+    };
+    document: {
+        baseURI: string;
+    };
+}
+/**
+ * The props of the page once the island read the address: the query from its last segment, and
+ * the nearby pages from the table of the pages written at publication; the served props alone
+ * when the table could not be loaded.
+ */
+export declare function notFoundPropsOf(props: NotFoundIslandProps, win: NotFoundWindow, inject: ScriptInjector, host: ShardHost): Promise<NotFoundIslandProps>;
+/** What the island needs from the document: elements made for the list of the nearby pages. */
+export interface NotFoundDocument {
+    createElement(tag: string): Element;
+}
+/**
+ * Wires the island of one page: reads its props and the address, then fills the served markup
+ * in place: the search exit worded on the last segment of the address and led to the search
+ * on it, the nearby pages listed and their block shown. Nothing changes for an address that
+ * gives no query and no nearby page, nor for an island without the served markup.
+ */
+export declare function wireNotFound(element: Element, doc: NotFoundDocument, win: NotFoundWindow, inject: ScriptInjector, host: ShardHost): Promise<boolean>;
+//# sourceMappingURL=not-found.d.ts.map

package/dist/islands/not-found.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"not-found.d.ts","sourceRoot":"","sources":["../../src/islands/not-found.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,WAAW,EAEjB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,EAAe,KAAK,cAAc,EAAE,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAE/E,0HAA0H;AAC1H,eAAO,MAAM,gBAAgB,cAAc,CAAC;AAE5C,wDAAwD;AACxD,eAAO,MAAM,YAAY,IAAI,CAAC;AAE9B,4HAA4H;AAC5H,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,6GAA6G;AAC7G,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAIxE;AAED,yGAAyG;AACzG,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAoBzD;AAED,0HAA0H;AAC1H,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,oJAAoJ;AACpJ,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CACtB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,SAAS,WAAW,EAAE,EAC/B,IAAI,EAAE,MAAM,GACX,UAAU,EAAE,CAsBd;AAED,uGAAuG;AACvG,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,2GAA2G;AAC3G,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/B,QAAQ,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAC/B;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,KAAK,EAAE,mBAAmB,EAC1B,GAAG,EAAE,cAAc,EACnB,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,SAAS,GACd,OAAO,CAAC,mBAAmB,CAAC,CAY9B;AAED,+FAA+F;AAC/F,MAAM,WAAW,gBAAgB;IAC/B,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACrC;AAED;;;;;GAKG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,gBAAgB,EACrB,GAAG,EAAE,cAAc,EACnB,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,SAAS,GACd,OAAO,CAAC,OAAO,CAAC,CA4BlB"}

package/dist/islands/not-found.js

@@ -0,0 +1,138 @@
+import { SEARCH_DIRECTORY, SEARCH_META, } from "../search/shared.js";
+import { shardLoader } from "./shards.js";
+/** The island of the page served for a missing address: it reads the address and names the nearby pages and the query. */
+export const NOT_FOUND_ISLAND = "not-found";
+/** How many nearby addresses the page lists at most. */
+export const NEARBY_LIMIT = 3;
+/** The address of a page under the site, without its file name nor its trailing slash: `glossary/publication-threshold`. */
+export function pageAddress(path) {
+    return path.replace(/(?:^|\/)index\.html$/, "").replace(/^\/+|\/+$/g, "");
+}
+/** The address asked for, under the site: the path of the location without the folder of the page itself. */
+export function missingAddress(pathname, baseUri) {
+    const folder = baseUri.replace(/^[a-z]+:\/\/[^/]*/i, "").replace(/[^/]*$/, "");
+    const under = pathname.startsWith(folder) ? pathname.slice(folder.length) : pathname;
+    return pageAddress(decodeURIComponent(under));
+}
+/** The edit distance between two addresses: insertions, deletions and substitutions of one character. */
+export function editDistance(a, b) {
+    let previous = Array.from({ length: b.length + 1 }, (_, index) => index);
+    // Without a character of a, every character of b is an insertion.
+    let distance = b.length;
+    for (const [row, charA] of Array.from(a).entries()) {
+        // The first cell of a row is its index: the cost of deleting every character so far.
+        let diagonal = row;
+        let left = row + 1;
+        const current = [left];
+        for (const [column, charB] of Array.from(b).entries()) {
+            // Within bounds by construction: every row holds one cell per character of b, plus one.
+            const above = previous[column + 1];
+            left = Math.min(diagonal + (charA === charB ? 0 : 1), above + 1, left + 1);
+            current.push(left);
+            diagonal = above;
+        }
+        previous = current;
+        distance = left;
+    }
+    return distance;
+}
+/** The last segment of an address, the name of the page: `publication-threshold` for `glossary/publication-threshold`. */
+export function lastSegment(address) {
+    return address.slice(address.lastIndexOf("/") + 1);
+}
+/** How far the name of a page may stand from the last segment of the missing address to be proposed: half its length, three characters at least. */
+export function nearbyThreshold(name) {
+    return Math.max(3, Math.floor(name.length / 2));
+}
+/**
+ * The pages whose address is closest to the missing one, by edit distance on the path: the
+ * name of the page, its last segment, against the last segment of the missing address first,
+ * so that a renamed file stands a character away and a moved file none, then the whole path,
+ * so that the nearest folder comes first among namesakes, then the order of the table; at most
+ * `NEARBY_LIMIT` of them and none whose name lies beyond the threshold. Each comes with its
+ * address under the site and its href from the root of the site.
+ */
+export function nearbyOf(missing, entries, root) {
+    if (missing === "")
+        return [];
+    const name = lastSegment(missing);
+    const threshold = nearbyThreshold(name);
+    return entries
+        .map((entry, index) => {
+        const address = pageAddress(entry.url);
+        return {
+            entry,
+            index,
+            name: editDistance(name, lastSegment(address)),
+            path: editDistance(missing, address),
+        };
+    })
+        .filter((candidate) => candidate.name <= threshold)
+        .sort((a, b) => a.name - b.name || a.path - b.path || a.index - b.index)
+        .slice(0, NEARBY_LIMIT)
+        .map(({ entry }) => ({
+        title: entry.title,
+        path: `/${pageAddress(entry.url)}/`,
+        href: `${root}${entry.url}`,
+    }));
+}
+/** The query the missing address suggests: its last segment, the hyphens and underscores as spaces. */
+export function queryOf(missing) {
+    return lastSegment(missing).replace(/[-_]+/g, " ").trim();
+}
+/**
+ * The props of the page once the island read the address: the query from its last segment, and
+ * the nearby pages from the table of the pages written at publication; the served props alone
+ * when the table could not be loaded.
+ */
+export async function notFoundPropsOf(props, win, inject, host) {
+    const missing = missingAddress(win.location.pathname, win.document.baseURI);
+    const query = queryOf(missing);
+    const load = shardLoader(`${props.root}${SEARCH_DIRECTORY}/`, inject, host);
+    // Written by the build: the table carries the shape the index builder serialises.
+    const meta = (await load(SEARCH_META));
+    const nearby = meta === undefined ? [] : nearbyOf(missing, meta.entities, props.root);
+    return {
+        ...props,
+        ...(query === "" ? {} : { query }),
+        ...(nearby.length === 0 ? {} : { nearby }),
+    };
+}
+/**
+ * Wires the island of one page: reads its props and the address, then fills the served markup
+ * in place: the search exit worded on the last segment of the address and led to the search
+ * on it, the nearby pages listed and their block shown. Nothing changes for an address that
+ * gives no query and no nearby page, nor for an island without the served markup.
+ */
+export async function wireNotFound(element, doc, win, inject, host) {
+    // Written by the build: the island serialises the props of its own component.
+    const props = JSON.parse(element.getAttribute("data-props") ?? "{}");
+    const search = element.querySelector(".button-primary");
+    const nearby = element.querySelector(".not-found-nearby");
+    const list = nearby?.querySelector("ul");
+    if (search === null || nearby === null || list === null || list === undefined)
+        return false;
+    const filled = await notFoundPropsOf(props, win, inject, host);
+    if (filled.query !== undefined) {
+        search.setAttribute("href", `${filled.searchHref}?q=${encodeURIComponent(filled.query)}`);
+        search.textContent = filled.searchQueryLabel.replace("{query}", filled.query);
+    }
+    for (const page of filled.nearby ?? []) {
+        const item = doc.createElement("li");
+        const link = doc.createElement("a");
+        link.setAttribute("href", page.href);
+        const title = doc.createElement("span");
+        title.setAttribute("class", "not-found-nearby-title");
+        title.textContent = page.title;
+        const path = doc.createElement("code");
+        path.setAttribute("class", "not-found-nearby-path");
+        path.textContent = page.path;
+        link.append(title, path);
+        item.append(link);
+        list.append(item);
+    }
+    if (filled.nearby !== undefined)
+        nearby.removeAttribute("hidden");
+    return filled.query !== undefined || filled.nearby !== undefined;
+}
+//# sourceMappingURL=not-found.js.map

package/dist/islands/not-found.js.map

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

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

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

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

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

package/dist/islands/panels.client.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"panels.client.js","sourceRoot":"","sources":["../../src/islands/panels.client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,KAAK,MAAM,OAAO,IAAI,QAAQ,CAAC,gBAAgB,CAAC,GAAG,cAAc,wBAAwB,CAAC,EAAE,CAAC;IAC3F,UAAU,CAAC,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,QAAQ,CAAC,eAAe,CAAC,CAAC;AACxE,CAAC"}

package/dist/islands/panels.d.ts

@@ -0,0 +1,48 @@
+import type { FoldablePanel } from "../slots.js";
+import { type KeyEvent } from "./editable.js";
+/** The part of `localStorage` the panels use; every call may throw when storage is disabled. */
+export interface PanelStorage {
+    getItem(key: string): string | null;
+    setItem(key: string, value: string): void;
+    removeItem(key: string): void;
+}
+/** The root element, whose `data-panels` the stylesheet reads to fold the panels. */
+export interface PanelsRoot {
+    dataset: {
+        panels?: string;
+    };
+}
+export interface HandleText {
+    textContent: string | null;
+}
+/** The handle of one panel, served hidden on the edge of the panel it folds. */
+export interface HandleElement {
+    hidden: boolean;
+    getAttribute(name: string): string | null;
+    setAttribute(name: string, value: string): void;
+    addEventListener(type: "click", listener: () => void): void;
+    querySelector(selector: string): HandleText | null;
+}
+/** What the island needs from the document: the handles of the page, and the keys pressed anywhere in it. */
+export interface PanelsDocument {
+    querySelectorAll(selector: string): Iterable<HandleElement>;
+    addEventListener(type: "keydown", listener: (event: KeyEvent) => void): void;
+}
+/** The island element written at build, holding the serialised labels. */
+export interface PanelsElement {
+    getAttribute(name: string): string | null;
+}
+/** The panels stored as folded, or none when nothing valid is stored or storage cannot be read. */
+export declare function readFolded(storage: PanelStorage): FoldablePanel[];
+/** Applies the folded panels to `data-panels` on the root and remembers them; a failing storage still changes the page. */
+export declare function applyFolded(folded: readonly FoldablePanel[], storage: PanelStorage, root: PanelsRoot): void;
+/** The folded panels with one of them folded or unfolded, in the order of the panels. */
+export declare function toggleFolded(folded: readonly FoldablePanel[], panel: FoldablePanel): FoldablePanel[];
+/**
+ * Reveals the handles of the page and makes each one fold and unfold its panel: the handle
+ * announces the state of its panel and names it in the language of the site, the root carries
+ * the folded panels for the stylesheet, and the storage keeps them for the next page. The `[`
+ * and `]` keys, pressed outside a field, fold and unfold the tree and the right panel.
+ */
+export declare function wirePanels(element: PanelsElement, document: PanelsDocument, storage: PanelStorage, root: PanelsRoot): number;
+//# sourceMappingURL=panels.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"panels.d.ts","sourceRoot":"","sources":["../../src/islands/panels.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,aAAa,EAAe,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAc,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE1D,gGAAgG;AAChG,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACpC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,qFAAqF;AACrF,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC9B;AAED,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,gFAAgF;AAChF,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,OAAO,CAAC;IAChB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC1C,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAChD,gBAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IAC5D,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAAC;CACpD;AAED,6GAA6G;AAC7G,MAAM,WAAW,cAAc;IAC7B,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAAC,aAAa,CAAC,CAAC;IAC5D,gBAAgB,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,GAAG,IAAI,CAAC;CAC9E;AAED,0EAA0E;AAC1E,MAAM,WAAW,aAAa;IAC5B,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;CAC3C;AAED,mGAAmG;AACnG,wBAAgB,UAAU,CAAC,OAAO,EAAE,YAAY,GAAG,aAAa,EAAE,CAMjE;AAED,2HAA2H;AAC3H,wBAAgB,WAAW,CACzB,MAAM,EAAE,SAAS,aAAa,EAAE,EAChC,OAAO,EAAE,YAAY,EACrB,IAAI,EAAE,UAAU,GACf,IAAI,CAgBN;AAED,yFAAyF;AACzF,wBAAgB,YAAY,CAC1B,MAAM,EAAE,SAAS,aAAa,EAAE,EAChC,KAAK,EAAE,aAAa,GACnB,aAAa,EAAE,CAIjB;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CACxB,OAAO,EAAE,aAAa,EACtB,QAAQ,EAAE,cAAc,EACxB,OAAO,EAAE,YAAY,EACrB,IAAI,EAAE,UAAU,GACf,MAAM,CAmDR"}

package/dist/islands/panels.js

@@ -0,0 +1,95 @@
+import { foldedValue, isPanel, PANEL_KEYS, PANELS, PANELS_STORAGE_KEY, parseFolded, } from "../panels.js";
+import { isEditable } from "./editable.js";
+/** The panels stored as folded, or none when nothing valid is stored or storage cannot be read. */
+export function readFolded(storage) {
+    try {
+        return parseFolded(storage.getItem(PANELS_STORAGE_KEY));
+    }
+    catch {
+        return [];
+    }
+}
+/** Applies the folded panels to `data-panels` on the root and remembers them; a failing storage still changes the page. */
+export function applyFolded(folded, storage, root) {
+    const value = foldedValue(folded);
+    if (value === undefined) {
+        delete root.dataset.panels;
+    }
+    else {
+        root.dataset.panels = value;
+    }
+    try {
+        if (value === undefined) {
+            storage.removeItem(PANELS_STORAGE_KEY);
+        }
+        else {
+            storage.setItem(PANELS_STORAGE_KEY, value);
+        }
+    }
+    catch {
+        // Storage disabled: the panels hold for this page only.
+    }
+}
+/** The folded panels with one of them folded or unfolded, in the order of the panels. */
+export function toggleFolded(folded, panel) {
+    return PANELS.filter((name) => name === panel ? !folded.includes(panel) : folded.includes(name));
+}
+/**
+ * Reveals the handles of the page and makes each one fold and unfold its panel: the handle
+ * announces the state of its panel and names it in the language of the site, the root carries
+ * the folded panels for the stylesheet, and the storage keeps them for the next page. The `[`
+ * and `]` keys, pressed outside a field, fold and unfold the tree and the right panel.
+ */
+export function wirePanels(element, document, storage, root) {
+    // Written by island() at build: the attribute carries the props of the island.
+    const props = JSON.parse(element.getAttribute("data-props") ?? "{}");
+    const handles = new Map();
+    for (const handle of document.querySelectorAll(".panel-handle")) {
+        const panel = handle.getAttribute("data-panel");
+        if (isPanel(panel)) {
+            handles.set(panel, handle);
+        }
+    }
+    let folded = readFolded(storage);
+    const show = () => {
+        for (const [panel, handle] of handles) {
+            handle.setAttribute("aria-expanded", folded.includes(panel) ? "false" : "true");
+        }
+    };
+    const toggle = (panel) => {
+        folded = toggleFolded(folded, panel);
+        applyFolded(folded, storage, root);
+        show();
+    };
+    for (const [panel, handle] of handles) {
+        const name = handle.querySelector(".visually-hidden");
+        const label = props.labels?.[panel];
+        if (name !== null && label !== undefined) {
+            name.textContent = label;
+        }
+        if (props.labels?.fold !== undefined) {
+            handle.setAttribute("title", props.labels.fold);
+        }
+        handle.addEventListener("click", () => {
+            toggle(panel);
+        });
+    }
+    show();
+    if (handles.size > 0) {
+        document.addEventListener("keydown", (event) => {
+            if (event.altKey || event.ctrlKey || event.metaKey || isEditable(event.target)) {
+                return;
+            }
+            const panel = PANELS.find((name) => PANEL_KEYS[name] === event.key);
+            if (panel !== undefined && handles.has(panel)) {
+                event.preventDefault();
+                toggle(panel);
+            }
+        });
+    }
+    for (const handle of handles.values()) {
+        handle.hidden = false;
+    }
+    return handles.size;
+}
+//# sourceMappingURL=panels.js.map

package/dist/islands/panels.js.map

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

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

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

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

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

package/dist/islands/pins.client.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"pins.client.js","sourceRoot":"","sources":["../../src/islands/pins.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,CAC7C,GAAG,cAAc,sBAAsB,CACxC,EAAE,CAAC;IACF,QAAQ,CAAC,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;AACpD,CAAC"}