import { on } from "bongo/client";
/**
* Remember the choice, so the inline script in `
` can apply it before
* paint.
*/
function theme() {
let root = document.documentElement;
let next = root.dataset.theme === "dark" ? "light" : "dark";
root.dataset.theme = next;
localStorage.setItem("theme", next);
}
/** Copy, then say so on the button that was pressed. */
async function copy(button: HTMLElement, text: string) {
try {
await navigator.clipboard.writeText(text);
} catch {
return;
}
let before = button.textContent;
button.textContent = "copied";
setTimeout(() => (button.textContent = before), 1400);
}
document.addEventListener("click", (event) => {
let target = event.target as HTMLElement;
let toggle = target.closest("[data-theme-toggle]");
if (toggle) return theme();
let copier = target.closest("[data-copy]");
if (copier) return void copy(copier, copier.dataset.copy!);
let block = target.closest("[data-copy-code]");
if (block) {
let code = block.closest("figure")?.querySelector("code");
if (code) return void copy(block, code.textContent ?? "");
}
let menu = target.closest("[data-menu]");
if (menu) {
let open = menu.getAttribute("aria-expanded") === "true";
menu.setAttribute("aria-expanded", String(!open));
document.getElementById("side")?.classList.toggle("open", !open);
return;
}
if (target.closest("[data-search]")) return void search();
});
// ───────────────────────────── on this page ─────────────────────────────
/** Mark the heading the reader is in, so the contents list follows the page. */
let watching: IntersectionObserver | undefined;
function spy() {
watching?.disconnect();
let links = [...document.querySelectorAll(".toc a")];
if (!links.length) return;
let byId = new Map(
links.map((link) => [decodeURIComponent(link.hash.slice(1)), link]),
);
let seen = new Set();
watching = new IntersectionObserver(
(entries) => {
for (let entry of entries) {
if (entry.isIntersecting) seen.add(entry.target.id);
else seen.delete(entry.target.id);
}
let current = [...byId.keys()].find((id) => seen.has(id));
for (let [id, link] of byId)
link.toggleAttribute("aria-current", id === current);
},
{ rootMargin: "-80px 0px -70% 0px" },
);
for (let id of byId.keys()) {
let heading = document.getElementById(id);
if (heading) watching.observe(heading);
}
}
// ──────────────────────── sidebar and header ────────────────────────
/**
* The sidebar and the header are `transition:persist`, so the client keeps the
* elements the server rendered for the first page and their `aria-current`
* never moves. Set it from the URL after every navigation instead.
*/
function here(path: string) {
for (let link of document.querySelectorAll(".side a")) {
let href = link.getAttribute("href") ?? "";
let state =
path === href
? "page"
: href !== "/" && path.startsWith(href)
? "true"
: null;
if (state) link.setAttribute("aria-current", state);
else link.removeAttribute("aria-current");
}
let docs = document.querySelector(
'.top nav a[href="/docs/"]',
);
docs?.toggleAttribute("aria-current", path.startsWith("/docs/"));
}
/** A link in the open phone menu should not leave it open on the next page. */
function closeMenu() {
document.getElementById("side")?.classList.remove("open");
document.querySelector("[data-menu]")?.setAttribute("aria-expanded", "false");
}
// ───────────────────────────── search ─────────────────────────────
type Entry = {
title: string;
path: string;
group: string;
summary: string;
headings: [string, string][];
text: string;
};
type Hit = { entry: Entry; heading?: [string, string] };
let index: Entry[] | undefined;
/**
* How many times `query` appears in `text`, capped so one long page cannot win
* on length alone.
*/
function count(text: string, query: string): number {
let total = 0;
let at = text.indexOf(query);
while (at !== -1 && total < 20) {
total++;
at = text.indexOf(query, at + query.length);
}
return total;
}
/**
* A title match beats a heading, which beats the summary, which beats the body.
* Within the body, the page that says it most often wins — which is why
* "ignore" finds "Ignoring code" even though its title does not contain it.
*/
function rank(entries: Entry[], query: string): Hit[] {
let hits: (Hit & { score: number })[] = [];
for (let entry of entries) {
let titled = entry.title.toLowerCase().includes(query);
// A sub-heading link only helps when the title itself did not match.
let heading = titled
? undefined
: entry.headings.find(([, text]) => text.toLowerCase().includes(query));
let score =
(titled ? 60 : 0) +
(heading ? 25 : 0) +
(entry.summary.toLowerCase().includes(query) ? 15 : 0) +
count(entry.text.toLowerCase(), query);
if (score > 0) hits.push({ entry, heading, score });
}
return hits.sort((a, b) => b.score - a.score);
}
const ESCAPE: Record = {
"&": "&",
"<": "<",
">": ">",
'"': """,
};
let escape = (text: string) => text.replace(/[&<>"]/g, (char) => ESCAPE[char]);
async function search() {
let dialog = document.getElementById("search") as HTMLDialogElement | null;
if (!dialog) return;
index ??= await fetch("/search.json").then(
(response) => response.json() as Promise,
);
let input = dialog.querySelector("[data-search-input]")!;
let results = dialog.querySelector("[data-search-results]")!;
function draw() {
let query = input.value.trim().toLowerCase();
let hits = query
? rank(index!, query).slice(0, 12)
: index!.slice(0, 8).map((entry) => ({ entry }));
results.innerHTML = hits.length
? hits
.map(({ entry, heading }) => {
let href = heading ? `${entry.path}#${heading[0]}` : entry.path;
let title = heading
? `${escape(entry.title)} › ${escape(heading[1])}`
: escape(entry.title);
return `${escape(entry.group)}${title}${escape(entry.summary)}`;
})
.join("")
: 'Nothing matches that.
';
}
input.oninput = draw;
draw();
dialog.showModal();
input.focus();
input.select();
}
document.addEventListener("keydown", (event) => {
if ((event.metaKey || event.ctrlKey) && event.key === "k") {
event.preventDefault();
void search();
}
});
/**
* A custom element, so the browser mounts it whenever it enters the document.
* The client runtime replaces ``, and a script inside replaced markup
* never runs, but an upgrade does.
*/
class TidyPlayground extends HTMLElement {
connectedCallback() {
void import("./play").then((module) => module.mount(this));
}
}
customElements.define("tidy-playground", TidyPlayground);
spy();
here(location.pathname);
on("bongo:navigated", ({ to }) => {
here(to.pathname);
closeMenu();
spy();
});