wiki-formant 0.7.0 → 0.9.0

package/dist/feed.d.ts

@@ -0,0 +1,50 @@
+export declare const escXml: (s: string) => string;
+/**
+ * `content:encoded` carries raw HTML, so it travels inside CDATA. A literal
+ * `]]>` in the body would close the section early and corrupt every item after
+ * it — not just the one that contained it.
+ */
+export declare const cdata: (html: string) => string;
+/**
+ * Aggregators hard-truncate a description around 150 characters. Trimming on a
+ * word boundary first means the cut lands between words rather than inside one.
+ */
+export declare function clampWords(s: string, max?: number): string;
+/**
+ * Relative hrefs and srcs are meaningless once an item is syndicated, so every
+ * internal link is absolutised on the way out. Protocol-relative and anchor-only
+ * targets are left alone.
+ */
+export declare function absolutise(html: string, baseUrl: string): string;
+export interface FeedItem {
+    title: string;
+    url: string;
+    description: string;
+    date: Date;
+    /** Becomes an `<enclosure>`. */
+    image?: string;
+    /** Becomes `content:encoded`. Full-text RSS is what lets a feed be mirrored. */
+    html?: string;
+    categories?: string[];
+}
+export declare function renderItem(item: FeedItem): string;
+export interface FeedChannel {
+    title: string;
+    link: string;
+    description: string;
+    /** The feed's own URL, for `atom:link rel="self"`. */
+    self: string;
+    language?: string;
+    /** Channel-level licence, so the grant travels with the feed. */
+    copyright?: string;
+}
+/**
+ * `lastBuildDate` comes from the newest item, not from the clock.
+ *
+ * A feed whose build date moves on every request tells every poller it changed
+ * when it did not, which is exactly the recrawl the conditional-GET helpers
+ * exist to prevent. An empty feed has no build date rather than a fictional one.
+ */
+export declare function renderFeed(channel: FeedChannel, items: readonly FeedItem[]): string;
+export declare const FEED_HEADERS: Record<string, string>;
+//# sourceMappingURL=feed.d.ts.map

package/dist/feed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feed.d.ts","sourceRoot":"","sources":["../src/feed.ts"],"names":[],"mappings":"AA0BA,eAAO,MAAM,MAAM,GAAI,GAAG,MAAM,KAAG,MAAyD,CAAC;AAE7F;;;;GAIG;AACH,eAAO,MAAM,KAAK,GAAI,MAAM,MAAM,KAAG,MAAyD,CAAC;AAE/F;;;GAGG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,SAAM,GAAG,MAAM,CAKvD;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAKhE;AAED,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,IAAI,CAAC;IACX,gCAAgC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gFAAgF;IAChF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAajD;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iEAAiE;IACjE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,SAAS,QAAQ,EAAE,GAAG,MAAM,CAoBnF;AAED,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAG/C,CAAC"}

package/dist/feed.js

@@ -0,0 +1,94 @@
+// feed.ts — an RSS 2.0 channel, assembled.
+//
+// Three repos, four feeds, and the same 47 of 64 significant lines in each —
+// including, verbatim in two of them, the four-line comment explaining why the
+// apostrophe uses a numeric reference rather than `'`. That comment
+// travelling by copy-paste is what made this worth lifting.
+//
+// The union, because each copy had something the others lacked: one had
+// `content:encoded`, `<enclosure>`, `<category>` and a word-boundary clamp; two
+// had a `lastBuildDate` derived from the newest item, where the third stamped
+// `new Date()` on every request — a validator that changes when nothing has,
+// which is the same waste the ETag helpers exist to avoid.
+//
+// What stays with the caller is the channel's identity and the block walk that
+// turns a page into HTML. Every project owns its own type set.
+// Numeric reference for the apostrophe: `&apos;` is an XML entity that older
+// readers parsing the feed as HTML do not carry in their entity table.
+const XML_ESCAPES = {
+    '&': '&amp;',
+    '<': '&lt;',
+    '>': '&gt;',
+    '"': '&quot;',
+    "'": '&#39;',
+};
+export const escXml = (s) => s.replace(/[&<>"']/g, c => XML_ESCAPES[c] ?? c);
+/**
+ * `content:encoded` carries raw HTML, so it travels inside CDATA. A literal
+ * `]]>` in the body would close the section early and corrupt every item after
+ * it — not just the one that contained it.
+ */
+export const cdata = (html) => `<![CDATA[${html.replace(/]]>/g, ']]&gt;')}]]>`;
+/**
+ * Aggregators hard-truncate a description around 150 characters. Trimming on a
+ * word boundary first means the cut lands between words rather than inside one.
+ */
+export function clampWords(s, max = 150) {
+    if (s.length <= max)
+        return s;
+    const cut = s.slice(0, max);
+    const lastSpace = cut.lastIndexOf(' ');
+    return (lastSpace > 0 ? cut.slice(0, lastSpace) : cut).replace(/[.,;:–-]$/, '');
+}
+/**
+ * Relative hrefs and srcs are meaningless once an item is syndicated, so every
+ * internal link is absolutised on the way out. Protocol-relative and anchor-only
+ * targets are left alone.
+ */
+export function absolutise(html, baseUrl) {
+    return html.replace(/\s(href|src)="\/(?!\/)([^"]*)"/gi, (_m, attr, path) => ` ${attr}="${baseUrl}/${path}"`);
+}
+export function renderItem(item) {
+    return [
+        '    <item>',
+        `      <title>${escXml(item.title)}</title>`,
+        `      <link>${escXml(item.url)}</link>`,
+        `      <guid isPermaLink="true">${escXml(item.url)}</guid>`,
+        `      <description>${escXml(item.description)}</description>`,
+        ...(item.categories ?? []).map(c => `      <category>${escXml(c)}</category>`),
+        `      <pubDate>${item.date.toUTCString()}</pubDate>`,
+        ...(item.image ? [`      <enclosure url="${escXml(item.image)}" type="image/png" />`] : []),
+        ...(item.html ? [`      <content:encoded>${cdata(item.html)}</content:encoded>`] : []),
+        '    </item>',
+    ].join('\n');
+}
+/**
+ * `lastBuildDate` comes from the newest item, not from the clock.
+ *
+ * A feed whose build date moves on every request tells every poller it changed
+ * when it did not, which is exactly the recrawl the conditional-GET helpers
+ * exist to prevent. An empty feed has no build date rather than a fictional one.
+ */
+export function renderFeed(channel, items) {
+    const newest = items.reduce((max, item) => (!max || item.date > max ? item.date : max), null);
+    return [
+        '<?xml version="1.0" encoding="UTF-8"?>',
+        '<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:content="http://purl.org/rss/1.0/modules/content/">',
+        '  <channel>',
+        `    <title>${escXml(channel.title)}</title>`,
+        `    <link>${escXml(channel.link)}</link>`,
+        `    <description>${escXml(channel.description)}</description>`,
+        `    <language>${escXml(channel.language ?? 'en')}</language>`,
+        ...(channel.copyright ? [`    <copyright>${escXml(channel.copyright)}</copyright>`] : []),
+        `    <atom:link href="${escXml(channel.self)}" rel="self" type="application/rss+xml" />`,
+        ...(newest ? [`    <lastBuildDate>${newest.toUTCString()}</lastBuildDate>`] : []),
+        ...items.map(renderItem),
+        '  </channel>',
+        '</rss>',
+    ].join('\n');
+}
+export const FEED_HEADERS = {
+    'Content-Type': 'application/rss+xml; charset=utf-8',
+    'Cache-Control': 'public, s-maxage=3600, stale-while-revalidate=86400',
+};
+//# sourceMappingURL=feed.js.map

package/dist/feed.js.map

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

package/dist/index.d.ts

@@ -13,4 +13,9 @@ export * from './blocks.js';
 export * from './text.js';
 export * from './maps.js';
 export * from './freshness.js';
+export * from './combobox.js';
+export * from './crawlers.js';
+export * from './revisions.js';
+export * from './feed.js';
+export * from './license.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC"}

package/dist/index.js

@@ -18,4 +18,9 @@ export * from './blocks.js';
 export * from './text.js';
 export * from './maps.js';
 export * from './freshness.js';
+export * from './combobox.js';
+export * from './crawlers.js';
+export * from './revisions.js';
+export * from './feed.js';
+export * from './license.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,EAAE;AACF,6EAA6E;AAC7E,6EAA6E;AAC7E,mBAAmB;AAEnB,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,EAAE;AACF,6EAA6E;AAC7E,6EAA6E;AAC7E,mBAAmB;AAEnB,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC"}

package/dist/license.d.ts

@@ -0,0 +1,39 @@
+export interface License {
+    /** SPDX identifier, e.g. `CC-BY-4.0`. */
+    spdx: string;
+    /** Human name, e.g. `Creative Commons Attribution 4.0 International`. */
+    name: string;
+    url: string;
+    /** The credit line a dataset should carry. */
+    attribution: string;
+}
+/** The grant every one of these wikis makes, parameterised by who is making it. */
+export declare function ccBy40(opts: {
+    siteName: string;
+    siteUrl: string;
+}): License;
+export interface LicenseBlockOptions {
+    license: License;
+    /**
+     * What the grant covers, as a sentence fragment completing "… is licensed
+     * under". Defaults to naming the whole site, which is the rarer case: every
+     * consumer of this so far grants over some of what it serves and not all.
+     */
+    scope?: string;
+    /** Sentences appended after the identifiers — carve-outs, caveats, terms. */
+    excludes?: readonly string[];
+    /** `Licence` where the site's prose says so. Defaults to `License`. */
+    heading?: string;
+}
+/**
+ * The block, as lines, ready to join into any text export.
+ *
+ * Returned as an array rather than a string because every caller splices it
+ * into a document it is already building line by line, and a caller that wants
+ * the string can join it.
+ */
+export declare function licenseLines({ license, scope, excludes, heading, }: LicenseBlockOptions): string[];
+export declare function licenseBlock(opts: LicenseBlockOptions): string;
+/** The one-line form, for a frontmatter field or a feed's `<copyright>`. */
+export declare function licenseNote(license: License): string;
+//# sourceMappingURL=license.d.ts.map

package/dist/license.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"license.d.ts","sourceRoot":"","sources":["../src/license.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,OAAO;IACtB,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,yEAAyE;IACzE,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,8CAA8C;IAC9C,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,mFAAmF;AACnF,wBAAgB,MAAM,CAAC,IAAI,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAO3E;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7B,uEAAuE;IACvE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,EAC3B,OAAO,EACP,KAAsB,EACtB,QAAa,EACb,OAAiC,GAClC,EAAE,mBAAmB,GAAG,MAAM,EAAE,CAchC;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,mBAAmB,GAAG,MAAM,CAE9D;AAED,4EAA4E;AAC5E,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAEpD"}

package/dist/license.js

@@ -0,0 +1,50 @@
+// license.ts — the licence declaration every agent surface has to carry.
+//
+// S10 requires a licence on every export — llms.txt, the agent card, the
+// OpenAPI info block, the JSON-LD, the feed's `<copyright>` — and each repo
+// satisfied that requirement by writing the same block again. The shape was
+// identical in all three, and the sentence beginning "You may ingest, embed,
+// and redistribute" was verbatim in all three.
+//
+// What is genuinely per-project is the scope: which half of a site the grant
+// covers, and what it deliberately excludes. That is the `scope` and `excludes`
+// below, and it is the only part a consumer should be writing by hand.
+/** The grant every one of these wikis makes, parameterised by who is making it. */
+export function ccBy40(opts) {
+    return {
+        spdx: 'CC-BY-4.0',
+        name: 'Creative Commons Attribution 4.0 International',
+        url: 'https://creativecommons.org/licenses/by/4.0/',
+        attribution: `Source: ${opts.siteName} (${opts.siteUrl}), CC BY 4.0`,
+    };
+}
+/**
+ * The block, as lines, ready to join into any text export.
+ *
+ * Returned as an array rather than a string because every caller splices it
+ * into a document it is already building line by line, and a caller that wants
+ * the string can join it.
+ */
+export function licenseLines({ license, scope = 'This content', excludes = [], heading = 'License & Attribution', }) {
+    return [
+        `## ${heading}`,
+        '',
+        `${scope} is licensed under the ${license.name} (${license.spdx}): ${license.url}`,
+        '',
+        'You may ingest, embed, and redistribute this content in RAG systems, fine-tuning',
+        'datasets, or other derivative works, including commercially. Attribution at the',
+        'dataset or system level is sufficient.',
+        '',
+        `- Recommended attribution: "${license.attribution}"`,
+        `- SPDX identifier: ${license.spdx}`,
+        ...(excludes.length ? ['', ...excludes] : []),
+    ];
+}
+export function licenseBlock(opts) {
+    return licenseLines(opts).join('\n');
+}
+/** The one-line form, for a frontmatter field or a feed's `<copyright>`. */
+export function licenseNote(license) {
+    return `${license.name} (${license.spdx}): ${license.url}`;
+}
+//# sourceMappingURL=license.js.map

package/dist/license.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"license.js","sourceRoot":"","sources":["../src/license.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,EAAE;AACF,yEAAyE;AACzE,4EAA4E;AAC5E,4EAA4E;AAC5E,6EAA6E;AAC7E,+CAA+C;AAC/C,EAAE;AACF,6EAA6E;AAC7E,gFAAgF;AAChF,uEAAuE;AAYvE,mFAAmF;AACnF,MAAM,UAAU,MAAM,CAAC,IAA2C;IAChE,OAAO;QACL,IAAI,EAAE,WAAW;QACjB,IAAI,EAAE,gDAAgD;QACtD,GAAG,EAAE,8CAA8C;QACnD,WAAW,EAAE,WAAW,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAC,OAAO,cAAc;KACrE,CAAC;AACJ,CAAC;AAgBD;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,EAC3B,OAAO,EACP,KAAK,GAAG,cAAc,EACtB,QAAQ,GAAG,EAAE,EACb,OAAO,GAAG,uBAAuB,GACb;IACpB,OAAO;QACL,MAAM,OAAO,EAAE;QACf,EAAE;QACF,GAAG,KAAK,0BAA0B,OAAO,CAAC,IAAI,KAAK,OAAO,CAAC,IAAI,MAAM,OAAO,CAAC,GAAG,EAAE;QAClF,EAAE;QACF,kFAAkF;QAClF,iFAAiF;QACjF,wCAAwC;QACxC,EAAE;QACF,+BAA+B,OAAO,CAAC,WAAW,GAAG;QACrD,sBAAsB,OAAO,CAAC,IAAI,EAAE;QACpC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;KAC9C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAyB;IACpD,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACvC,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,WAAW,CAAC,OAAgB;IAC1C,OAAO,GAAG,OAAO,CAAC,IAAI,KAAK,OAAO,CAAC,IAAI,MAAM,OAAO,CAAC,GAAG,EAAE,CAAC;AAC7D,CAAC"}

package/dist/pagination.d.ts

@@ -9,9 +9,18 @@ export interface PaginatedResponse<T> extends Pagination {
 }
 export declare const MAX_PAGE_SIZE = 100;
 export declare const DEFAULT_PAGE_SIZE = 20;
-/** `page` clamped to ≥1, `pageSize` clamped to 1–100. Never trust either. */
+/**
+ * `page` clamped to ≥1, `pageSize` clamped to 1–`max`. Never trust either.
+ *
+ * `max` defaults to 100 and exists because the cap is a per-route decision, not
+ * a package-wide one: a route whose rows are whole pages caps lower than one
+ * whose rows are titles. Without it the one consumer that caps at 50 could not
+ * express itself here, so it kept its own clamp — and then disagreed with
+ * itself, capping at 50 in the REST route and 100 in the MCP tool beside it.
+ */
 export declare function parsePagination(searchParams: URLSearchParams, defaults?: {
     pageSize?: number;
+    max?: number;
 }): Pagination;
 export declare function paginatedResponse<T>(items: T[], total: number, page: number, pageSize: number): PaginatedResponse<T>;
 /** The `skip`/`take` an ORM wants, from the same clamped pair. */

package/dist/pagination.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pagination.d.ts","sourceRoot":"","sources":["../src/pagination.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB,CAAC,CAAC,CAAE,SAAQ,UAAU;IACtD,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,aAAa,MAAM,CAAC;AACjC,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAEpC,6EAA6E;AAC7E,wBAAgB,eAAe,CAC7B,YAAY,EAAE,eAAe,EAC7B,QAAQ,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/B,UAAU,CAYZ;AAED,wBAAgB,iBAAiB,CAAC,CAAC,EACjC,KAAK,EAAE,CAAC,EAAE,EACV,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,GACf,iBAAiB,CAAC,CAAC,CAAC,CAEtB;AAED,kEAAkE;AAClE,wBAAgB,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,UAAU,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAEvF"}
+{"version":3,"file":"pagination.d.ts","sourceRoot":"","sources":["../src/pagination.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB,CAAC,CAAC,CAAE,SAAQ,UAAU;IACtD,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,aAAa,MAAM,CAAC;AACjC,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAEpC;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,YAAY,EAAE,eAAe,EAC7B,QAAQ,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7C,UAAU,CASZ;AAED,wBAAgB,iBAAiB,CAAC,CAAC,EACjC,KAAK,EAAE,CAAC,EAAE,EACV,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,GACf,iBAAiB,CAAC,CAAC,CAAC,CAEtB;AAED,kEAAkE;AAClE,wBAAgB,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,UAAU,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAEvF"}

package/dist/pagination.js

@@ -5,15 +5,23 @@
 // codes against, so reshaping it per repo is a breaking change nobody declared.
 export const MAX_PAGE_SIZE = 100;
 export const DEFAULT_PAGE_SIZE = 20;
-/** `page` clamped to ≥1, `pageSize` clamped to 1–100. Never trust either. */
+/**
+ * `page` clamped to ≥1, `pageSize` clamped to 1–`max`. Never trust either.
+ *
+ * `max` defaults to 100 and exists because the cap is a per-route decision, not
+ * a package-wide one: a route whose rows are whole pages caps lower than one
+ * whose rows are titles. Without it the one consumer that caps at 50 could not
+ * express itself here, so it kept its own clamp — and then disagreed with
+ * itself, capping at 50 in the REST route and 100 in the MCP tool beside it.
+ */
 export function parsePagination(searchParams, defaults) {
+    const max = defaults?.max ?? MAX_PAGE_SIZE;
+    const fallbackSize = Math.min(max, defaults?.pageSize ?? DEFAULT_PAGE_SIZE);
     const rawPage = parseInt(searchParams.get('page') || '1', 10);
-    const rawSize = parseInt(searchParams.get('pageSize') || String(defaults?.pageSize ?? DEFAULT_PAGE_SIZE), 10);
+    const rawSize = parseInt(searchParams.get('pageSize') || String(fallbackSize), 10);
     return {
         page: Number.isFinite(rawPage) ? Math.max(1, rawPage) : 1,
-        pageSize: Number.isFinite(rawSize)
-            ? Math.min(MAX_PAGE_SIZE, Math.max(1, rawSize))
-            : (defaults?.pageSize ?? DEFAULT_PAGE_SIZE),
+        pageSize: Number.isFinite(rawSize) ? Math.min(max, Math.max(1, rawSize)) : fallbackSize,
     };
 }
 export function paginatedResponse(items, total, page, pageSize) {

package/dist/pagination.js.map

@@ -1 +1 @@
-{"version":3,"file":"pagination.js","sourceRoot":"","sources":["../src/pagination.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAC3D,EAAE;AACF,6EAA6E;AAC7E,gFAAgF;AAChF,gFAAgF;AAahF,MAAM,CAAC,MAAM,aAAa,GAAG,GAAG,CAAC;AACjC,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,CAAC;AAEpC,6EAA6E;AAC7E,MAAM,UAAU,eAAe,CAC7B,YAA6B,EAC7B,QAAgC;IAEhC,MAAM,OAAO,GAAG,QAAQ,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,GAAG,EAAE,EAAE,CAAC,CAAC;IAC9D,MAAM,OAAO,GAAG,QAAQ,CACtB,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,MAAM,CAAC,QAAQ,EAAE,QAAQ,IAAI,iBAAiB,CAAC,EAC/E,EAAE,CACH,CAAC;IACF,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;QACzD,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC;YAChC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,aAAa,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;YAC/C,CAAC,CAAC,CAAC,QAAQ,EAAE,QAAQ,IAAI,iBAAiB,CAAC;KAC9C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,KAAU,EACV,KAAa,EACb,IAAY,EACZ,QAAgB;IAEhB,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,QAAQ,CAAC,EAAE,CAAC;AACnF,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAc;IACrD,OAAO,EAAE,IAAI,EAAE,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;AACzD,CAAC"}
+{"version":3,"file":"pagination.js","sourceRoot":"","sources":["../src/pagination.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAC3D,EAAE;AACF,6EAA6E;AAC7E,gFAAgF;AAChF,gFAAgF;AAahF,MAAM,CAAC,MAAM,aAAa,GAAG,GAAG,CAAC;AACjC,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,CAAC;AAEpC;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe,CAC7B,YAA6B,EAC7B,QAA8C;IAE9C,MAAM,GAAG,GAAG,QAAQ,EAAE,GAAG,IAAI,aAAa,CAAC;IAC3C,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,EAAE,QAAQ,IAAI,iBAAiB,CAAC,CAAC;IAC5E,MAAM,OAAO,GAAG,QAAQ,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,GAAG,EAAE,EAAE,CAAC,CAAC;IAC9D,MAAM,OAAO,GAAG,QAAQ,CAAC,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,MAAM,CAAC,YAAY,CAAC,EAAE,EAAE,CAAC,CAAC;IACnF,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;QACzD,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY;KACxF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,KAAU,EACV,KAAa,EACb,IAAY,EACZ,QAAgB;IAEhB,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,QAAQ,CAAC,EAAE,CAAC;AACnF,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAc;IACrD,OAAO,EAAE,IAAI,EAAE,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;AACzD,CAAC"}

package/dist/react.d.ts

@@ -1,4 +1,5 @@
-import { type CSSProperties, type KeyboardEvent, type ReactNode } from 'react';
+import { type ComboboxAria } from './combobox.js';
+import { Component, type CSSProperties, type KeyboardEvent, type ReactNode } from 'react';
 export interface SidebarOptions {
     /**
      * Where the reader's choice is remembered, in `localStorage`. Give each wiki
@@ -151,6 +152,15 @@ export interface TypeaheadState<T> {
     clearItems: () => void;
     /** Drop everything. For a pick, or a closing popover. */
     reset: () => void;
+    /**
+     * The listbox contract, ready to spread: `inputProps` on the field,
+     * `listProps` on the results container, `optionProps(i)` on each row.
+     *
+     * Pass a `listKey` when one hook feeds more than one rendered list — a header
+     * with a desktop and a mobile field renders both into the same document, and
+     * one id set across the two duplicates every option id.
+     */
+    combobox: (listKey?: string, open?: boolean) => ComboboxAria;
 }
 /**
  * The debounced-search state machine behind every typeahead on these sites.
@@ -213,4 +223,73 @@ export interface LinkPreviewState<T> {
  * three things, and those three are the options above.
  */
 export declare function useLinkPreview<T>({ eligible, fetch, cardClassName, cardWidth, cardHeight, showDelay, hideDelay, margin, }: LinkPreviewOptions<T>): LinkPreviewState<T>;
+export type SortDirection = 'asc' | 'desc';
+export interface TableSortState<T, K extends string> {
+    sorted: T[];
+    sortKey: K;
+    direction: SortDirection;
+    /** Spread onto a header cell. `active` is what drives `aria-sort`. */
+    headerProps: (key: K) => {
+        sortKey: K;
+        active: boolean;
+        direction: SortDirection;
+        onSort: (key: K) => void;
+        'aria-sort': 'ascending' | 'descending' | 'none';
+    };
+    toggle: (key: K) => void;
+}
+/**
+ * One active column, direction toggling on re-click, every table the same.
+ *
+ * One repo had this as a hook; the other inlined the identical state machine in
+ * two chart tables, differing only in the `useState` seed and the comparator
+ * payload. The comparator record replaces the `if`-chain those copies used, so
+ * adding a column is a map entry rather than another branch.
+ *
+ * `aria-sort` is emitted here because only one of the two header components had
+ * it, and a sortable column that never announces its direction is a button whose
+ * effect a screen reader cannot observe.
+ */
+export declare function useTableSort<T, K extends string>(rows: readonly T[], config: {
+    defaultKey: K;
+    comparators: Record<K, (a: T, b: T) => number>;
+    defaultDirection?: SortDirection;
+}): TableSortState<T, K>;
+/**
+ * "Copied", then not, after a beat. Six call sites across three repos wrote the
+ * same three statements, and four of the six had no rejection handler — so a
+ * denied clipboard permission left the button claiming success. The imperative
+ * twin in `wiki-formant/dom` has handled that since it was extracted.
+ *
+ * The key form is for a surface with several copyable things and one indicator:
+ * `copied === 'cite'` rather than a boolean per button.
+ */
+export declare function useCopy<K extends string = string>(revertAfter?: number): {
+    copied: K | null;
+    copy: (text: string, key?: K) => Promise<boolean>;
+};
+/**
+ * The one thing hooks cannot express, so it is worth owning once.
+ *
+ * `fallback` is a render prop taking a `retry` closure, which is the better of
+ * the two shapes this was lifted from: the other hardcoded its own "Try again"
+ * button and so could not be restyled or relabelled by a caller. Recovery is the
+ * caller's, and the boundary only decides when to offer it.
+ */
+export declare class ErrorBoundary extends Component<{
+    children: ReactNode;
+    fallback: (retry: () => void) => ReactNode;
+    onError?: (error: unknown) => void;
+}, {
+    failed: boolean;
+}> {
+    state: {
+        failed: boolean;
+    };
+    static getDerivedStateFromError(): {
+        failed: boolean;
+    };
+    componentDidCatch(error: unknown): void;
+    render(): ReactNode;
+}
 //# sourceMappingURL=react.d.ts.map

package/dist/react.d.ts.map

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

package/dist/react.js

@@ -27,7 +27,8 @@ import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-run
 //      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';
+import { comboboxAria } from './combobox.js';
+import { Component, createContext, createElement, useCallback, useContext, useEffect, useId, useMemo, useRef, useState, } from 'react';
 const readStored = (key) => {
     try {
         const raw = window.localStorage.getItem(key);
@@ -355,6 +356,10 @@ export function useTypeahead({ fetch, onPick, onEscape, delay = 200, minLength =
                 onPick(target);
         }
     };
+    // The ids have to be stable per mount and unique per surface; `useId` is what
+    // makes a second typeahead on the same page legal.
+    const baseId = useId();
+    const combobox = useCallback((listKey, open) => comboboxAria({ baseId, listKey, count: items.length, highlight, open }), [baseId, items.length, highlight]);
     return {
         query,
         setQuery,
@@ -366,6 +371,7 @@ export function useTypeahead({ fetch, onPick, onEscape, delay = 200, minLength =
         onKeyDown,
         clearItems,
         reset,
+        combobox,
     };
 }
 /**
@@ -467,4 +473,102 @@ export function useLinkPreview({ eligible, fetch, cardClassName = 'link-preview-
         },
     };
 }
+/**
+ * One active column, direction toggling on re-click, every table the same.
+ *
+ * One repo had this as a hook; the other inlined the identical state machine in
+ * two chart tables, differing only in the `useState` seed and the comparator
+ * payload. The comparator record replaces the `if`-chain those copies used, so
+ * adding a column is a map entry rather than another branch.
+ *
+ * `aria-sort` is emitted here because only one of the two header components had
+ * it, and a sortable column that never announces its direction is a button whose
+ * effect a screen reader cannot observe.
+ */
+export function useTableSort(rows, config) {
+    const { defaultKey, comparators, defaultDirection = 'desc' } = config;
+    const [sortKey, setSortKey] = useState(defaultKey);
+    const [direction, setDirection] = useState(defaultDirection);
+    const toggle = useCallback((key) => {
+        if (key === sortKey)
+            setDirection(d => (d === 'desc' ? 'asc' : 'desc'));
+        else {
+            setSortKey(key);
+            setDirection(defaultDirection);
+        }
+    }, [sortKey, defaultDirection]);
+    const sorted = useMemo(() => {
+        const comparator = comparators[sortKey];
+        if (!comparator)
+            return [...rows];
+        const multiplier = direction === 'asc' ? 1 : -1;
+        return [...rows].sort((a, b) => multiplier * comparator(a, b));
+    }, [rows, sortKey, direction, comparators]);
+    const headerProps = useCallback((key) => {
+        const active = key === sortKey;
+        return {
+            sortKey: key,
+            active,
+            direction,
+            onSort: toggle,
+            'aria-sort': (active ? (direction === 'asc' ? 'ascending' : 'descending') : 'none'),
+        };
+    }, [sortKey, direction, toggle]);
+    return { sorted, sortKey, direction, headerProps, toggle };
+}
+// ---- copy to clipboard ------------------------------------------------------
+/**
+ * "Copied", then not, after a beat. Six call sites across three repos wrote the
+ * same three statements, and four of the six had no rejection handler — so a
+ * denied clipboard permission left the button claiming success. The imperative
+ * twin in `wiki-formant/dom` has handled that since it was extracted.
+ *
+ * The key form is for a surface with several copyable things and one indicator:
+ * `copied === 'cite'` rather than a boolean per button.
+ */
+export function useCopy(revertAfter = 2000) {
+    const [copied, setCopied] = useState(null);
+    const timer = useRef(null);
+    // A component unmounted inside the revert window would otherwise set state on
+    // a dead tree.
+    useEffect(() => () => { if (timer.current)
+        clearTimeout(timer.current); }, []);
+    const copy = useCallback(async (text, key) => {
+        try {
+            await navigator.clipboard.writeText(text);
+        }
+        catch {
+            return false;
+        }
+        setCopied((key ?? 'copied'));
+        if (timer.current)
+            clearTimeout(timer.current);
+        timer.current = setTimeout(() => setCopied(null), revertAfter);
+        return true;
+    }, [revertAfter]);
+    return { copied, copy };
+}
+// ---- error boundary ---------------------------------------------------------
+/**
+ * The one thing hooks cannot express, so it is worth owning once.
+ *
+ * `fallback` is a render prop taking a `retry` closure, which is the better of
+ * the two shapes this was lifted from: the other hardcoded its own "Try again"
+ * button and so could not be restyled or relabelled by a caller. Recovery is the
+ * caller's, and the boundary only decides when to offer it.
+ */
+export class ErrorBoundary extends Component {
+    state = { failed: false };
+    static getDerivedStateFromError() {
+        return { failed: true };
+    }
+    componentDidCatch(error) {
+        this.props.onError?.(error);
+    }
+    render() {
+        if (this.state.failed)
+            return this.props.fallback(() => this.setState({ failed: false }));
+        return this.props.children;
+    }
+}
 //# sourceMappingURL=react.js.map