npm - wiki-formant - Versions diffs - 0.4.1 → 0.7.0 - Mend

wiki-formant 0.4.1 → 0.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (26) hide show

package/dist/react.js ADDED Viewed

@@ -0,0 +1,470 @@
+'use client';
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+// react.tsx — the collapsible wiki sidebar, and the table of contents inside it.
+//
+// This is the one part of the package that needs React, so it is the one part
+// behind its own subpath: `wiki-formant/react`. React is an OPTIONAL PEER
+// dependency, so a consumer that only wants the taxonomy or the MCP transport
+// still installs a package with no runtime dependencies at all.
+//
+// What is shared here is behaviour, not appearance. Every class name is passed
+// in, because the three wikis style their rails differently and always will;
+// what they should not differ on is what the rail DOES. Icons are passed in for
+// the same reason — and because a component library that hardcodes an icon set
+// makes its consumers install that icon set.
+//
+// Two bugs are fixed here rather than propagated. Both were in the version this
+// was lifted from:
+//
+//   1. `useEffect(() => setOpen(!isMobile), [isMobile])` ran on every matchMedia
+//      change, so resizing a window across the breakpoint silently discarded a
+//      collapse the reader had chosen. The breakpoint now supplies the DEFAULT
+//      only, and never overrides a choice already made.
+//   2. The store started closed and an effect opened it on mount, so every
+//      desktop load flashed a closed rail before opening it. SSR cannot read
+//      localStorage, so no amount of React fixes this on its own: the answer is
+//      `sidebarBootScript`, a blocking inline script that stamps the remembered
+//      state on <html> before first paint. The hook keeps that attribute in
+//      sync afterwards, so CSS has one source of truth either side of hydration.
+import { resolveSidebarOpen, SIDEBAR_ATTRIBUTE } from './sidebar.js';
+import { createContext, createElement, useCallback, useContext, useEffect, useMemo, useRef, useState, } from 'react';
+const readStored = (key) => {
+    try {
+        const raw = window.localStorage.getItem(key);
+        return raw === null ? null : raw === '1';
+    }
+    catch {
+        // Private browsing, or site data blocked. A rail that cannot remember is
+        // fine; a rail that throws on load is not.
+        return null;
+    }
+};
+/**
+ * Collapse state for a wiki rail: remembered across loads, defaulted from the
+ * viewport only when the reader has never chosen.
+ *
+ * The reader's choice outranks the breakpoint. Someone who collapses the rail
+ * on a laptop and then narrows the window has still collapsed the rail.
+ */
+export function useCollapsibleSidebar(options = {}) {
+    const { storageKey = 'wiki:sidebar', breakpoint = 1024 } = options;
+    // Start open on the server and on the first client paint. SSR has no viewport
+    // and no storage, so any other guess is a guaranteed mismatch on some loads.
+    const [open, setOpenState] = useState(true);
+    const [isMobile, setIsMobile] = useState(false);
+    const [ready, setReady] = useState(false);
+    // Set as soon as the reader touches the control, so a later viewport change
+    // cannot overwrite what they asked for.
+    const chosen = useRef(false);
+    useEffect(() => {
+        const mql = window.matchMedia(`(max-width: ${breakpoint - 1}px)`);
+        const stored = readStored(storageKey);
+        const apply = (matches) => {
+            setIsMobile(matches);
+            // The breakpoint supplies a default, never an override. This is bug 1.
+            setOpenState(current => resolveSidebarOpen({ chosen: chosen.current, current, stored, isMobile: matches }));
+        };
+        apply(mql.matches);
+        setReady(true);
+        const handler = (e) => apply(e.matches);
+        mql.addEventListener('change', handler);
+        return () => mql.removeEventListener('change', handler);
+    }, [storageKey, breakpoint]);
+    const setOpen = useCallback((next) => {
+        chosen.current = true;
+        setOpenState(next);
+        try {
+            window.localStorage.setItem(storageKey, next ? '1' : '0');
+        }
+        catch {
+            /* storage unavailable — the choice still holds for this page */
+        }
+    }, [storageKey]);
+    const toggle = useCallback(() => setOpen(!open), [open, setOpen]);
+    // One source of truth either side of hydration: the boot script writes this
+    // attribute before first paint, and from here on the hook owns it.
+    useEffect(() => {
+        document.documentElement.setAttribute(SIDEBAR_ATTRIBUTE, open ? 'open' : 'closed');
+    }, [open]);
+    return { open, setOpen, toggle, isMobile, ready };
+}
+// ---- sharing that state across the layout -----------------------------------
+// The rail and the button that toggles it are rarely siblings — the button
+// usually lives in the header — so the state has to span them. A context is the
+// smallest thing that does, and it means a consumer needs no store of its own.
+const SidebarContext = createContext(null);
+/** Wrap the layout that contains both the rail and its toggle. */
+export function SidebarProvider({ children, ...options }) {
+    const state = useCollapsibleSidebar(options);
+    return createElement(SidebarContext.Provider, { value: state }, children);
+}
+/**
+ * The rail's collapse state. Throws outside a provider rather than silently
+ * handing back a second, unconnected copy — two sources of truth for one rail
+ * is the failure this context exists to prevent.
+ */
+export function useSidebar() {
+    const ctx = useContext(SidebarContext);
+    if (!ctx)
+        throw new Error('useSidebar must be used within a <SidebarProvider>');
+    return ctx;
+}
+const sameHeadings = (a, b) => a.length === b.length && a.every((h, i) => h.id === b[i].id && h.text === b[i].text);
+/**
+ * An "on this page" rail with scroll-spy, read from the rendered article.
+ *
+ * Both wikis this came from had written the same thing: a debounced
+ * MutationObserver to survive content arriving late, an IntersectionObserver to
+ * track the section under the viewport top, and the same reference-stability
+ * trick so an unrelated DOM mutation (a price ticker, an RSS feed) does not tear
+ * the observer down.
+ */
+export function TableOfContents({ containerSelector, headings: providedHeadings, resetKey, classNames = {}, icon, label = 'On this page', slug, offsetVar, offsetFallback = 64, indentRem = 0.75, empty = null, }) {
+    const [scanned, setScanned] = useState([]);
+    const [expanded, setExpanded] = useState(true);
+    const [activeId, setActiveId] = useState('');
+    const headings = providedHeadings ?? scanned;
+    useEffect(() => {
+        // Nothing to scan for when the caller already knows the headings.
+        if (providedHeadings || !containerSelector)
+            return;
+        let timer;
+        const update = () => {
+            clearTimeout(timer);
+            // Debounced: block content can arrive in bursts, and re-reading the whole
+            // article per mutation is what makes a rail janky.
+            timer = setTimeout(() => {
+                const root = document.querySelector(containerSelector);
+                if (!root)
+                    return;
+                const used = new Set();
+                const next = [];
+                for (const el of Array.from(root.querySelectorAll('h1, h2, h3'))) {
+                    const text = el.textContent?.trim() ?? '';
+                    if (!text)
+                        continue;
+                    let id = el.id;
+                    if (!id) {
+                        if (!slug)
+                            continue; // ids are the server's business here
+                        const base = slug(text) || 'section';
+                        id = base;
+                        let n = 2;
+                        while (used.has(id) || document.getElementById(id))
+                            id = `${base}-${n++}`;
+                        el.id = id;
+                    }
+                    used.add(id);
+                    next.push({ id, text, level: Number(el.tagName[1]) });
+                }
+                // Keep the same array reference when nothing changed, so the scroll-spy
+                // effect below is not torn down by an unrelated mutation.
+                setScanned(prev => (sameHeadings(prev, next) ? prev : next));
+            }, 200);
+        };
+        update();
+        const root = document.querySelector(containerSelector);
+        const observer = new MutationObserver(update);
+        if (root)
+            observer.observe(root, { childList: true, subtree: true });
+        return () => {
+            clearTimeout(timer);
+            observer.disconnect();
+        };
+    }, [containerSelector, resetKey, slug, providedHeadings]);
+    useEffect(() => {
+        if (!headings.length)
+            return;
+        const order = new Map(headings.map((h, i) => [h.id, i]));
+        const visible = new Set();
+        const styles = getComputedStyle(document.documentElement);
+        const rem = parseFloat(styles.fontSize) || 16;
+        const raw = offsetVar ? styles.getPropertyValue(offsetVar).trim() : '';
+        // A custom property may be in rem or px; both appear across these wikis.
+        const parsed = parseFloat(raw);
+        const offset = !raw || Number.isNaN(parsed)
+            ? offsetFallback
+            : raw.endsWith('rem') ? parsed * rem : parsed;
+        const topOffset = Math.round(offset + rem * 0.5);
+        const observer = new IntersectionObserver(entries => {
+            for (const e of entries) {
+                if (e.isIntersecting)
+                    visible.add(e.target.id);
+                else
+                    visible.delete(e.target.id);
+            }
+            if (!visible.size)
+                return;
+            // The earliest visible heading in document order is the section the
+            // reader is in, not whichever entry fired last.
+            let bestId = '';
+            let bestIdx = Infinity;
+            for (const id of visible) {
+                const idx = order.get(id) ?? Infinity;
+                if (idx < bestIdx) {
+                    bestIdx = idx;
+                    bestId = id;
+                }
+            }
+            if (bestId)
+                setActiveId(bestId);
+        }, { rootMargin: `-${topOffset}px 0px -75% 0px`, threshold: 0 });
+        for (const h of headings) {
+            const el = document.getElementById(h.id);
+            if (el)
+                observer.observe(el);
+        }
+        return () => observer.disconnect();
+    }, [headings, offsetVar, offsetFallback]);
+    // Derived, not seeded from an effect: until the observer reports a section,
+    // the first heading is the one the reader is in.
+    const currentId = useMemo(() => activeId || headings[0]?.id, [activeId, headings]);
+    if (!headings.length)
+        return _jsx(_Fragment, { children: empty });
+    return (_jsxs("div", { className: classNames.root, children: [_jsxs("button", { type: "button", onClick: () => setExpanded(v => !v), className: classNames.button, "aria-expanded": expanded, children: [icon?.(expanded), _jsx("span", { className: classNames.label, children: label })] }), expanded && (_jsx("nav", { className: classNames.list, "aria-label": label, children: headings.map(h => (_jsx("button", { type: "button", onClick: () => {
+                        setActiveId(h.id);
+                        document.getElementById(h.id)?.scrollIntoView({ behavior: 'smooth' });
+                    }, className: currentId === h.id
+                        ? [classNames.item, classNames.itemActive].filter(Boolean).join(' ')
+                        : classNames.item, "aria-current": currentId === h.id ? 'location' : undefined, style: { paddingLeft: `${(h.level - 1) * indentRem}rem` }, children: h.text }, h.id))) }))] }));
+}
+// ---- outside clicks ---------------------------------------------------------
+/**
+ * Calls `onClose` on any mousedown outside the returned ref's element.
+ *
+ * The `offsetParent` check is the whole reason this is shared. All three wikis
+ * had written this hook; only one had that line, and without it a container
+ * that is `display: none` at the current breakpoint still claims outside-clicks
+ * — so a tap anywhere on a phone dismisses a popover the reader is looking at,
+ * because the hidden desktop copy of it answered first.
+ *
+ * `onClose` is an effect dependency: wrap it in `useCallback` or hoist it, or
+ * the listener is torn down and rebuilt on every render.
+ */
+export function useClickOutside(onClose) {
+    const ref = useRef(null);
+    useEffect(() => {
+        const handler = (e) => {
+            const el = ref.current;
+            if (el && el.offsetParent !== null && !el.contains(e.target))
+                onClose();
+        };
+        document.addEventListener('mousedown', handler);
+        return () => document.removeEventListener('mousedown', handler);
+    }, [onClose]);
+    return ref;
+}
+/**
+ * The debounced-search state machine behind every typeahead on these sites.
+ *
+ * Five surfaces across the three wikis had three implementations, and no two
+ * agreed on what a search field does. This is their union, because each had a
+ * piece the others were missing:
+ *
+ *   - a **request-id guard**, so a slow response cannot paint over a newer one.
+ *     Two of the five surfaces had no guard at all: type fast enough and the
+ *     results you are reading are for a query you have already replaced.
+ *   - **keyboard navigation**. Two surfaces had none — the header dropdown of a
+ *     wiki whose search is its primary navigation was mouse-only.
+ *   - **abort and a per-query cache**, which only the third had. The cache is
+ *     per mount, not module-level, so a stale result cannot outlive the page.
+ *
+ * The debounce is inlined rather than pulled from a package: this one is nine
+ * lines, and the point of the package is to have no runtime dependencies.
+ */
+export function useTypeahead({ fetch, onPick, onEscape, delay = 200, minLength = 1, cache = true, }) {
+    const [query, setQuery] = useState('');
+    const [debounced, setDebounced] = useState('');
+    const [items, setItems] = useState([]);
+    const [highlight, setHighlight] = useState(0);
+    const [isSearching, setIsSearching] = useState(false);
+    const requestId = useRef(0);
+    const cached = useRef(new Map());
+    useEffect(() => {
+        const timer = setTimeout(() => setDebounced(query), delay);
+        return () => clearTimeout(timer);
+    }, [query, delay]);
+    useEffect(() => {
+        const q = debounced.trim();
+        if (q.length < minLength) {
+            // Bump the id so an in-flight request for a longer query cannot land
+            // after the field has been cleared.
+            requestId.current++;
+            setItems([]);
+            setIsSearching(false);
+            return;
+        }
+        const hit = cache ? cached.current.get(q) : undefined;
+        if (hit) {
+            requestId.current++;
+            setItems(hit);
+            setHighlight(0);
+            setIsSearching(false);
+            return;
+        }
+        const id = ++requestId.current;
+        const controller = new AbortController();
+        setIsSearching(true);
+        fetch(q, controller.signal).then(rows => {
+            if (id !== requestId.current)
+                return;
+            if (cache)
+                cached.current.set(q, rows);
+            setItems(rows);
+            setHighlight(0);
+            setIsSearching(false);
+        }, () => {
+            // An abort is the expected path for every superseded query, so it must
+            // not surface as an error. A real failure reads as "no results".
+            if (id !== requestId.current)
+                return;
+            setItems([]);
+            setIsSearching(false);
+        });
+        return () => controller.abort();
+    }, [debounced, fetch, minLength, cache]);
+    const clearItems = useCallback(() => setItems([]), []);
+    const reset = useCallback(() => {
+        requestId.current++;
+        setQuery('');
+        setDebounced('');
+        setItems([]);
+        setHighlight(0);
+        setIsSearching(false);
+    }, []);
+    const onKeyDown = (e) => {
+        if (e.key === 'Escape') {
+            setItems([]);
+            onEscape?.();
+            return;
+        }
+        if (!items.length)
+            return;
+        if (e.key === 'ArrowDown') {
+            e.preventDefault();
+            setHighlight(h => (h + 1) % items.length);
+        }
+        else if (e.key === 'ArrowUp') {
+            e.preventDefault();
+            setHighlight(h => (h - 1 + items.length) % items.length);
+        }
+        else if (e.key === 'Enter') {
+            e.preventDefault();
+            const target = items[highlight];
+            if (target)
+                onPick(target);
+        }
+    };
+    return {
+        query,
+        setQuery,
+        debouncedQuery: debounced,
+        items,
+        highlight,
+        setHighlight,
+        isSearching,
+        onKeyDown,
+        clearItems,
+        reset,
+    };
+}
+/**
+ * Wikipedia-style hover cards over a rendered article.
+ *
+ * One delegated listener on `document` rather than a component per link, which
+ * is what makes this viable over an article holding hundreds of anchors. Two
+ * wikis had written the same ~90 lines: the same 350ms intent delay, the same
+ * 200ms grace so the cursor can cross the gap into the card, the same
+ * viewport-clamp arithmetic, the same per-href cache. They differed in exactly
+ * three things, and those three are the options above.
+ */
+export function useLinkPreview({ eligible, fetch, cardClassName = 'link-preview-card', cardWidth = 320, cardHeight = 240, showDelay = 350, hideDelay = 200, margin = 8, }) {
+    const [card, setCard] = useState(null);
+    const cache = useRef(new Map());
+    const showTimer = useRef(undefined);
+    const hideTimer = useRef(undefined);
+    const activeHref = useRef(null);
+    // The handlers below are rebuilt whenever these change, so they are read from
+    // a ref instead — a caller passing an inline `eligible` arrow would otherwise
+    // tear down and rebind the document listeners on every render.
+    const opts = useRef({ eligible, fetch });
+    opts.current = { eligible, fetch };
+    const hide = useCallback(() => {
+        hideTimer.current = setTimeout(() => {
+            activeHref.current = null;
+            setCard(null);
+        }, hideDelay);
+    }, [hideDelay]);
+    useEffect(() => {
+        const clearTimers = () => {
+            clearTimeout(showTimer.current);
+            clearTimeout(hideTimer.current);
+        };
+        const onOver = (e) => {
+            const anchor = e.target?.closest('a');
+            if (!anchor || !opts.current.eligible(anchor))
+                return;
+            const href = (anchor.getAttribute('href') ?? '').replace(/[#?].*$/, '');
+            if (!href)
+                return;
+            // Re-entering the link the card is already for: cancel the pending hide
+            // rather than refetching and re-placing an identical card.
+            if (activeHref.current === href) {
+                clearTimeout(hideTimer.current);
+                return;
+            }
+            clearTimers();
+            activeHref.current = href;
+            showTimer.current = setTimeout(async () => {
+                let data = cache.current.get(href);
+                if (data === undefined) {
+                    try {
+                        data = await opts.current.fetch(href);
+                    }
+                    catch {
+                        data = null;
+                    }
+                    cache.current.set(href, data);
+                }
+                // The cursor may have moved on during the fetch.
+                if (activeHref.current !== href || data === null)
+                    return;
+                const rect = anchor.getBoundingClientRect();
+                const above = rect.bottom + cardHeight > window.innerHeight && rect.top > cardHeight;
+                setCard({
+                    data,
+                    left: Math.max(margin, Math.min(rect.left, window.innerWidth - cardWidth - margin)),
+                    top: above ? rect.top - margin : rect.bottom + margin,
+                    above,
+                });
+            }, showDelay);
+        };
+        const onOut = (e) => {
+            // Moving into the card itself is not leaving.
+            if (e.relatedTarget?.closest(`.${cardClassName}`))
+                return;
+            clearTimers();
+            hide();
+        };
+        document.addEventListener('mouseover', onOver);
+        document.addEventListener('mouseout', onOut);
+        return () => {
+            clearTimers();
+            document.removeEventListener('mouseover', onOver);
+            document.removeEventListener('mouseout', onOut);
+        };
+    }, [cardClassName, cardWidth, cardHeight, showDelay, margin, hide]);
+    return {
+        preview: card?.data ?? null,
+        cardProps: {
+            style: {
+                left: card?.left,
+                top: card?.top,
+                transform: card?.above ? 'translateY(-100%)' : undefined,
+            },
+            onMouseEnter: () => clearTimeout(hideTimer.current),
+            onMouseLeave: hide,
+        },
+    };
+}
+//# sourceMappingURL=react.js.map

package/dist/react.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"react.js","sourceRoot":"","sources":["../src/react.tsx"],"names":[],"mappings":"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"}

package/dist/sidebar.d.ts ADDED Viewed

@@ -0,0 +1,38 @@
+/**
+ * Whether the rail should be open, given what is known.
+ *
+ * The whole of both bug fixes lives in these three lines, so it is a named
+ * function with tests rather than a condition buried in an effect:
+ *
+ *   - a choice the reader has made outranks everything, forever;
+ *   - a remembered choice outranks the viewport;
+ *   - the viewport is consulted only when nothing else has an opinion.
+ */
+export declare function resolveSidebarOpen({ chosen, current, stored, isMobile, }: {
+    /** Has the reader touched the control this session? */
+    chosen: boolean;
+    /** What the rail is showing now. */
+    current: boolean;
+    /** What storage remembers, or null if it has never been written. */
+    stored: boolean | null;
+    /** Is the viewport below the breakpoint? */
+    isMobile: boolean;
+}): boolean;
+/** The attribute the boot script and the hook both write to `<html>`. */
+export declare const SIDEBAR_ATTRIBUTE = "data-sidebar";
+/**
+ * A blocking inline script for the document head, so the rail's first paint
+ * already matches what the reader last chose.
+ *
+ * Server rendering cannot see `localStorage`, so a remembered-closed rail would
+ * otherwise paint open and then animate shut on every single load. This is the
+ * same trick a theme switcher uses for exactly the same reason. Stamp it with
+ * `dangerouslySetInnerHTML` in `<head>`, and style against
+ * `html[data-sidebar='closed']` rather than against the React class alone.
+ *
+ * It is wrapped in try/catch because a browser with site data blocked throws on
+ * the read, and a rail that cannot remember is much better than a page that
+ * dies before it paints.
+ */
+export declare function sidebarBootScript(storageKey?: string, breakpoint?: number): string;
+//# sourceMappingURL=sidebar.d.ts.map

package/dist/sidebar.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"sidebar.d.ts","sourceRoot":"","sources":["../src/sidebar.ts"],"names":[],"mappings":"AAOA;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,MAAM,EACN,OAAO,EACP,MAAM,EACN,QAAQ,GACT,EAAE;IACD,uDAAuD;IACvD,MAAM,EAAE,OAAO,CAAC;IAChB,oCAAoC;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,oEAAoE;IACpE,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;IACvB,4CAA4C;IAC5C,QAAQ,EAAE,OAAO,CAAC;CACnB,GAAG,OAAO,CAGV;AAED,yEAAyE;AACzE,eAAO,MAAM,iBAAiB,iBAAiB,CAAC;AAEhD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,SAAiB,EAAE,UAAU,SAAO,GAAG,MAAM,CAMxF"}

package/dist/sidebar.js ADDED Viewed

@@ -0,0 +1,43 @@
+// sidebar.ts — the framework-free half of the collapsible wiki rail.
+//
+// Separate from `react.tsx` because that file carries `'use client'`, which
+// makes every one of its exports a client reference — and `sidebarBootScript`
+// has to be callable from a server component to reach the document head.
+// Splitting it also lets the collapse rule be tested without a DOM.
+/**
+ * Whether the rail should be open, given what is known.
+ *
+ * The whole of both bug fixes lives in these three lines, so it is a named
+ * function with tests rather than a condition buried in an effect:
+ *
+ *   - a choice the reader has made outranks everything, forever;
+ *   - a remembered choice outranks the viewport;
+ *   - the viewport is consulted only when nothing else has an opinion.
+ */
+export function resolveSidebarOpen({ chosen, current, stored, isMobile, }) {
+    if (chosen)
+        return current;
+    return stored ?? !isMobile;
+}
+/** The attribute the boot script and the hook both write to `<html>`. */
+export const SIDEBAR_ATTRIBUTE = 'data-sidebar';
+/**
+ * A blocking inline script for the document head, so the rail's first paint
+ * already matches what the reader last chose.
+ *
+ * Server rendering cannot see `localStorage`, so a remembered-closed rail would
+ * otherwise paint open and then animate shut on every single load. This is the
+ * same trick a theme switcher uses for exactly the same reason. Stamp it with
+ * `dangerouslySetInnerHTML` in `<head>`, and style against
+ * `html[data-sidebar='closed']` rather than against the React class alone.
+ *
+ * It is wrapped in try/catch because a browser with site data blocked throws on
+ * the read, and a rail that cannot remember is much better than a page that
+ * dies before it paints.
+ */
+export function sidebarBootScript(storageKey = 'wiki:sidebar', breakpoint = 1024) {
+    return (`(function(){try{var v=localStorage.getItem(${JSON.stringify(storageKey)});` +
+        `var o=v===null?!window.matchMedia("(max-width: ${breakpoint - 1}px)").matches:v==="1";` +
+        `document.documentElement.setAttribute(${JSON.stringify(SIDEBAR_ATTRIBUTE)},o?"open":"closed");}catch(e){}})()`);
+}
+//# sourceMappingURL=sidebar.js.map

package/dist/sidebar.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"sidebar.js","sourceRoot":"","sources":["../src/sidebar.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,EAAE;AACF,4EAA4E;AAC5E,8EAA8E;AAC9E,yEAAyE;AACzE,oEAAoE;AAEpE;;;;;;;;;GASG;AACH,MAAM,UAAU,kBAAkB,CAAC,EACjC,MAAM,EACN,OAAO,EACP,MAAM,EACN,QAAQ,GAUT;IACC,IAAI,MAAM;QAAE,OAAO,OAAO,CAAC;IAC3B,OAAO,MAAM,IAAI,CAAC,QAAQ,CAAC;AAC7B,CAAC;AAED,yEAAyE;AACzE,MAAM,CAAC,MAAM,iBAAiB,GAAG,cAAc,CAAC;AAEhD;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,iBAAiB,CAAC,UAAU,GAAG,cAAc,EAAE,UAAU,GAAG,IAAI;IAC9E,OAAO,CACL,8CAA8C,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI;QAC5E,kDAAkD,UAAU,GAAG,CAAC,wBAAwB;QACxF,yCAAyC,IAAI,CAAC,SAAS,CAAC,iBAAiB,CAAC,qCAAqC,CAChH,CAAC;AACJ,CAAC"}

package/dist/taxonomy.d.ts CHANGED Viewed

@@ -55,6 +55,39 @@ export interface MetadataRow extends MetadataKeyDefinition {
     value: string;
     href?: string;
 }
+/**
+ * One pressable control on a browsing axis, with its destination already built.
+ *
+ * The three wikis each rendered the same taxonomy output their own way and had
+ * already begun to disagree about what the row CONTAINS rather than how it
+ * looks: one shipped no A–Z index at all, one had no way back to the unfiltered
+ * set, and two marked an active chip with `aria-pressed` on an `<a>` — which is
+ * not a toggle button and does not take that attribute. The decisions are here;
+ * the markup stays theirs.
+ */
+export interface Control {
+    /** The value this control selects. Empty on the reset control. */
+    value: string;
+    /** What to render. Same as `value` except on the reset control. */
+    label: string;
+    /** Pages reachable through this control, counted under the sibling state. */
+    count: number;
+    /** Built through the one `href` builder, so no control drops a sibling axis. */
+    href: string;
+    active: boolean;
+    /**
+     * True on the single control that clears its axis. It leads the row rather
+     * than being appended, so a consumer that maps the array cannot ship a
+     * narrowed view with nothing to press to widen it.
+     */
+    reset?: boolean;
+}
+/** One facet's controls, ready to render as a labelled row. */
+export interface FacetControlGroup {
+    key: string;
+    label: string;
+    options: Control[];
+}
 /** State a category URL can carry. `href` receives this and owns the format. */
 export interface CategoryState {
     sort?: string;
@@ -99,6 +132,25 @@ export interface Taxonomy {
     filterPages: <T extends FacetablePage>(pages: T[], filters: FacetFilters, letter?: string) => T[];
     buildFacets: <T extends FacetablePage>(tagPath: string, pages: T[], filters: FacetFilters, letter?: string) => Facet[];
     alphaIndex: <T extends FacetablePage>(pages: T[], filters: FacetFilters) => FacetValue[];
+    /**
+     * `buildFacets` with every chip's destination and active state resolved.
+     * Prefer this to `buildFacets` in a view: the href arithmetic is the part
+     * that was being rebuilt, and getting it wrong drops the reader's letter or
+     * sort on the next press.
+     */
+    facetControls: <T extends FacetablePage>(tagPath: string, pages: T[], state?: CategoryState) => FacetControlGroup[];
+    /**
+     * The A–Z row, reset control first, or `[]` for a set that still fits on a
+     * screen. Folds in the `needsAlphaIndex` threshold so a consumer cannot show
+     * an index it did not need or, as one did, omit one it did.
+     */
+    alphaControls: <T extends FacetablePage>(tagPath: string, pages: T[], state?: CategoryState) => Control[];
+    /**
+     * A `?letter=` narrowed to a bucket that exists. A letter with no pages under
+     * the active filters would otherwise empty the grid with no control marked to
+     * explain it.
+     */
+    resolveLetter: <T extends FacetablePage>(pages: T[], filters: FacetFilters, letter?: string) => string | undefined;
     /** A page's populated metadata keys as facts-panel rows, facet values linked. */
     metadataRows: (tagPath: string, page: {
         metadata?: unknown;