wiki-formant 0.47.1 → 0.49.0

package/dist/analytics.d.ts

@@ -4,15 +4,6 @@ import { type HeaderReader, type RateLimitOptions } from './rate-limit.js';
  * Prisma: `(query, ...values) => prisma.$queryRawUnsafe(query, ...values)`.
  */
 export type Sql = (query: string, ...values: unknown[]) => Promise<unknown>;
-/** iPadOS reports itself as a Mac, so its views count as a computer's. */
-export declare const deviceOf: (ua: string) => "phone" | "tablet" | "computer";
-/**
- * Where a visit came from: its `utm_source` when the link carried one, else the
- * referring host, and null for a referrer that is this site or none.
- */
-export declare function sourceOf(referrer: unknown, utm: unknown, host: string): string | null;
-/** A browser path as stored: decoded, one leading slash, no trailing one. Null when it will not decode. */
-export declare function normalisePath(path: string): string | null;
 export interface ViewInput {
     /** The beacon request's headers: the address, browser, host and country come from them. */
     headers: HeaderReader;
@@ -22,8 +13,6 @@ export interface ViewInput {
     utm?: unknown;
     site?: string;
 }
-/** Count one page view, unless a bot sent it. Never rejects. */
-export declare function recordView(sql: Sql, { headers, path, referrer, utm, site }: ViewInput): Promise<void>;
 export interface EventInput {
     name: string;
     props?: Record<string, string | number>;
@@ -170,20 +159,6 @@ export interface SearchQueryInput {
     /** Which search box, when a site has more than one. */
     surface?: string;
 }
-/**
- * Props for a "Search Query" event – the human-side twin of `mcpCallProps`.
- *
- * A wiki instruments its agent surface and then counts every question an agent
- * asks while recording none of the questions a person asks. The queries that
- * return nothing are the valuable ones: they name a gap in the corpus in the
- * reader's own words, which is otherwise only ever guessed at.
- *
- * Returns `null` for a query with no content, so an empty field cannot fire an
- * event. The text is untrusted, so it is collapsed, lowercased for aggregation
- * and truncated – the same 64-character bound search itself applies, which
- * keeps the prop and the query that produced it the same string.
- */
-export declare function searchQueryProps({ query, results, surface, }: SearchQueryInput): Record<string, string> | null;
 export interface TrackerOptions {
     sql: Sql;
     /** `after` in Next: the write runs once the response has gone. */

package/dist/analytics.js

@@ -14,52 +14,9 @@
 //
 // The package owns the SQL; the app owns the connection. `Sql` is one function
 // that runs a parameterised statement, which Prisma, `pg` and postgres.js can
-// all supply in a line. The app declares the four tables in its own schema,
-// so `prisma db push` keeps them:
-//
-//   model View {
-//     id        BigInt   @id @default(autoincrement())
-//     siteId    String   @default("")
-//     path      String
-//     source    String?
-//     country   String?
-//     device    String
-//     visitor   String
-//     createdAt DateTime @default(now()) @db.Timestamptz(3)
-//     @@index([siteId, createdAt])
-//   }
-//
-//   model Event {
-//     id        BigInt   @id @default(autoincrement())
-//     siteId    String   @default("")
-//     name      String
-//     path      String?
-//     props     Json     @default("{}")
-//     visitor   String?
-//     createdAt DateTime @default(now()) @db.Timestamptz(3)
-//     @@index([siteId, name, createdAt])
-//   }
-//
-//   model Salt {
-//     day   String @id
-//     value String
-//   }
-//
-//   model ViewDay {
-//     siteId     String   @default("")
-//     day        DateTime @db.Date
-//     visitors   Int
-//     pageviews  Int
-//     visits     Int
-//     bounces    Int
-//     seconds    Int
-//     pages      Json     @default("{}")
-//     entryPages Json     @default("{}")
-//     sources    Json     @default("{}")
-//     countries  Json     @default("{}")
-//     devices    Json     @default("{}")
-//     @@id([siteId, day])
-//   }
+// all supply in a line. The four tables it needs are Prisma models shipped in
+// `prisma/analytics.prisma`, which the `prisma-models` bin copies into the
+// app's schema folder, so `prisma db push` keeps them.
 //
 // `ViewDay` holds days a site counted somewhere else before it counted its
 // own, one row a day with each breakdown as `{ value: visitors }`. Nothing
@@ -80,12 +37,14 @@ const KEEP_DAYS = 400;
 const DAY_MS = 86_400_000;
 /** A script that runs a page's JavaScript and says what it is. */
 const BOT = /bot|crawl|spider|slurp|headless|lighthouse|prerender|preview/i;
-/** iPadOS reports itself as a Mac, so its views count as a computer's. */
+/** iPadOS reports itself as a Mac, so its views count as a computer's. @internal */
 export const deviceOf = (ua) => /iPad|Tablet|Android(?!.*Mobile)/i.test(ua) ? 'tablet' : /Mobi|iPhone|Android/i.test(ua) ? 'phone' : 'computer';
 const bareHost = (host) => host.toLowerCase().replace(/:\d+$/, '').replace(/^www\./, '');
 /**
  * Where a visit came from: its `utm_source` when the link carried one, else the
  * referring host, and null for a referrer that is this site or none.
+ *
+ * @internal
  */
 export function sourceOf(referrer, utm, host) {
     if (typeof utm === 'string' && utm.trim())
@@ -100,7 +59,7 @@ export function sourceOf(referrer, utm, host) {
         return null;
     }
 }
-/** A browser path as stored: decoded, one leading slash, no trailing one. Null when it will not decode. */
+/** A browser path as stored: decoded, one leading slash, no trailing one. Null when it will not decode. @internal */
 export function normalisePath(path) {
     try {
         const p = decodeURIComponent(path.split(/[?#]/)[0].slice(0, 500));
@@ -136,7 +95,7 @@ async function visitorOf(sql, site, headers) {
 }
 /** Analytics must not be able to fail a response, so a failed write is logged and dropped. */
 const quietly = (task) => task().then(() => undefined, (e) => console.error(`analytics: ${e.message}`));
-/** Count one page view, unless a bot sent it. Never rejects. */
+/** Count one page view, unless a bot sent it. Never rejects. @internal */
 export function recordView(sql, { headers, path, referrer, utm, site = '' }) {
     const ua = headers.get('user-agent') ?? '';
     const page = normalisePath(path);
@@ -340,6 +299,8 @@ export function mcpCallProps(request, body, server) {
  * event. The text is untrusted, so it is collapsed, lowercased for aggregation
  * and truncated – the same 64-character bound search itself applies, which
  * keeps the prop and the query that produced it the same string.
+ *
+ * @internal
  */
 export function searchQueryProps({ query, results, surface, }) {
     const q = (query ?? '').replace(/\s+/g, ' ').trim().toLowerCase().slice(0, 64);

package/dist/base.css

@@ -40,6 +40,27 @@
   .columns-layout > .column-view { align-self: stretch; }
 }
 
+/* ---- the block views and the infobox ---------------------------------------
+   The structure three or four sites had each restated around this markup;
+   padding, gaps, radii and colour stay theirs. A stats block is two columns,
+   three or four from 40rem; a code-tab strip is a row of buttons; a banner sets
+   its icon beside its text; a long address in an infobox wraps. */
+.stat-grid { display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); }
+@media (min-width: 40rem) {
+  .stat-grid-3 { grid-template-columns: repeat(3, minmax(0, 1fr)); }
+  .stat-grid-4 { grid-template-columns: repeat(4, minmax(0, 1fr)); }
+}
+.stat-card { display: flex; flex-direction: column; }
+.code-tabs { overflow: hidden; }
+.code-tabs-list { display: flex; }
+.code-tabs-btn { cursor: pointer; }
+.editorial-banner { display: flex; }
+.infobox { overflow-wrap: anywhere; }
+.infobox-series { display: flex; flex-direction: column; }
+.heading-anchor,
+.ref-backlink,
+.reference-link { text-decoration: none; }
+
 /* ---- stored tab groups (activateTabGroups) --------------------------------
    Only the active panel shows. Before the script runs, the first tab's content
    stands in for the group rather than every tab at once. */
@@ -174,7 +195,7 @@ pre:hover > .code-copy-btn,
    `TimeChart`: the canvas, a loading or empty state over it, and the range and
    step buttons pinned to its top-left corner. A site gives the buttons and the
    box their look; pressed is all this marks. */
-.chart { position: relative; margin: 0; }
+.chart { position: relative; margin: 0; overflow: hidden; }
 /* Its own stacking context: the library's canvases stack themselves, and the buttons go over them. */
 .chart-canvas { position: relative; z-index: 0; height: var(--chart-height, 15rem); }
 /* The chart lays itself out in a <table>; a site's table styles are not for it. */
@@ -192,7 +213,7 @@ pre:hover > .code-copy-btn,
 .chart-controls > div { display: flex; gap: 2px; }
 /* A rule between groups: ranges, then steps, then the candles switch. */
 .chart-controls > * + * { border-inline-start: 1px solid color-mix(in srgb, currentColor 25%, transparent); padding-inline-start: 0.5rem; }
-.chart-controls :is(button, a) { font: inherit; color: inherit; text-decoration: none; background: none; cursor: pointer; opacity: 0.6; }
+.chart-controls :is(button, a) { padding: 0.125rem 0.375rem; font: inherit; color: inherit; text-decoration: none; background: none; cursor: pointer; opacity: 0.6; }
 /* An icon sits on the text's line, so an icon button is as tall as a labelled one. */
 .chart-icon { display: inline-block; width: 1em; height: 1em; vertical-align: -0.125em; }
 /* A button is pressed; a link (a stats page's window) is the page shown. */

package/dist/blocks.d.ts

@@ -1,5 +1,12 @@
 import { type RelativeTimeStyle } from './freshness.js';
 import type { BlockGroup } from './revisions.js';
+/**
+ * The languages a code block or code tab offers, and the one a new one opens
+ * on. Two wikis carried this list character for character; a wiki with its own
+ * passes it to `createCodeBlock` and its tab editor.
+ */
+export declare const CODE_LANGS: readonly ["javascript", "typescript", "css", "json", "bash", "python", "rust", "sql", "html", "xml", "jsx", "tsx", "markdown", "yaml", "toml"];
+export declare const DEFAULT_LANG = "rust";
 export interface CodeTab {
     label: string;
     language?: string;
@@ -137,14 +144,8 @@ export declare function someBlock<B>(blocks: readonly B[], predicate: (block: B)
  * contains a fence cannot close this one early.
  */
 export declare function codeTabsToMarkdown(tabs: readonly CodeTab[]): string;
-/** A maintenance notice as a blockquote. `label` is the caller's display string. */
-export declare function bannerToMarkdown(label: string, text?: string | null): string;
-/** A numbered citation list, or `''` when there is nothing to cite. */
-export declare function referencesToMarkdown(items: readonly ReferenceItem[], title?: string): string;
 /** Metric cards as a bullet list, or `''` when empty. */
 export declare function statsToMarkdown(items: readonly StatItem[]): string;
-/** Grouped links under their headings, with an optional lead paragraph. */
-export declare function linkGridToMarkdown(groups: readonly LinkGridGroup[], intro?: string | null): string;
 /** A flat bullet list of links — resolved page lists, feed items, link rails. */
 export declare function linkList(items: readonly LinkGridLink[]): string;
 /**

package/dist/blocks.js

@@ -13,6 +13,14 @@
 import { htmlToMarkdown, inlineToMarkdown } from './markdown.js';
 import { relativeTime } from './freshness.js';
 import { BANNER_LABELS, bannerToText, codeTabsToText, linkGridToText, pageListToText, referencesToText, statsToText, stripHtml, } from './text.js';
+// ---- the shapes the standard block types carry ------------------------------
+/**
+ * The languages a code block or code tab offers, and the one a new one opens
+ * on. Two wikis carried this list character for character; a wiki with its own
+ * passes it to `createCodeBlock` and its tab editor.
+ */
+export const CODE_LANGS = ['javascript', 'typescript', 'css', 'json', 'bash', 'python', 'rust', 'sql', 'html', 'xml', 'jsx', 'tsx', 'markdown', 'yaml', 'toml'];
+export const DEFAULT_LANG = 'rust';
 export function pageRef(page, now, style = 'long') {
     return {
         title: page.title,
@@ -163,11 +171,11 @@ export function codeTabsToMarkdown(tabs) {
     })
         .join('\n\n');
 }
-/** A maintenance notice as a blockquote. `label` is the caller's display string. */
+/** A maintenance notice as a blockquote. `label` is the caller's display string. @internal */
 export function bannerToMarkdown(label, text) {
     return `> **[${label}]**${text ? ` ${inlineToMarkdown(text)}` : ''}`;
 }
-/** A numbered citation list, or `''` when there is nothing to cite. */
+/** A numbered citation list, or `''` when there is nothing to cite. @internal */
 export function referencesToMarkdown(items, title = 'References') {
     if (!items.length)
         return '';
@@ -180,7 +188,7 @@ export function statsToMarkdown(items) {
         return '';
     return items.map(s => `- **${s.value}${s.suffix ?? ''}** — ${s.label}`).join('\n');
 }
-/** Grouped links under their headings, with an optional lead paragraph. */
+/** Grouped links under their headings, with an optional lead paragraph. @internal */
 export function linkGridToMarkdown(groups, intro) {
     const lead = intro ? `${inlineToMarkdown(intro)}\n\n` : '';
     const rendered = groups.map(g => [

package/dist/chart.d.ts

@@ -18,6 +18,16 @@ export type ChartResolution = 'hour' | '4h' | 'day';
 export type ChartStep = 'day' | 'week' | 'month';
 /** Points by resolution, from `from` (Unix seconds, 0 for all time), oldest first. */
 export type ChartLoader = (resolution: ChartResolution, from: number) => Promise<readonly ChartPoint[]>;
+/** Something that happened at a time, in Unix seconds, drawn on the point that holds it. */
+export type ChartMarker = {
+    time: number;
+    label: string;
+};
+/** The range and step a reader has picked, for a page that keeps them in its URL. */
+export type ChartView = {
+    range: ChartRange;
+    step: ChartStep | null;
+};
 /** Every range, shortest first. A chart fed daily points offers the ones from 30D up. */
 export declare const CHART_RANGES: readonly ChartRange[];
 /** A step is offered once it makes four points, and the default is the finest that makes 200 or fewer. */
@@ -25,13 +35,6 @@ export declare function chartSteps(span: number): {
     steps: ChartStep[];
     fallback: ChartStep;
 };
-/**
- * Points, oldest first, one per step. A price keeps the last value in each
- * step, as a candle does its close: the first open, the highest high, the
- * lowest low. A count takes the mean of its days, so the week in progress does
- * not read as a collapse. Volume is summed.
- */
-export declare function bucketChart(points: readonly ChartPoint[], step: ChartStep, aggregate: 'last' | 'mean'): ChartPoint[];
 /** Compact from a thousand up, four significant figures below. */
 export declare const formatChartValue: (n: number) => string;
 export interface TimeChartProps {
@@ -58,6 +61,12 @@ export interface TimeChartProps {
      * window links, which load another digest rather than slice this one.
      */
     controls?: ReactNode;
+    /** Events drawn on the points that hold them. */
+    markers?: readonly ChartMarker[];
+    /** The step shown first, where the range can make it. */
+    step?: ChartStep;
+    /** Called with the range and step on mount and on every change. */
+    onView?: (view: ChartView) => void;
     className?: string;
 }
 /**
@@ -65,4 +74,4 @@ export interface TimeChartProps {
  * `.chart-controls button[aria-pressed]`, and a site's stylesheet gives them
  * and the box their look; the line and fill are the canvas box's `color`.
  */
-export declare function TimeChart({ series, label, ranges, range: initial, aggregate, fromZero, format, candles: initialCandles, height, controls, className, }: TimeChartProps): import("react").JSX.Element;
+export declare function TimeChart({ series, label, ranges, range: initial, aggregate, fromZero, format, candles: initialCandles, height, controls, markers, step: initialStep, onView, className, }: TimeChartProps): import("react").JSX.Element;

package/dist/chart.js

@@ -8,7 +8,8 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 // loaded on mount, so the page paints without it. Every colour is the canvas
 // box's own `color`, its axis `--chart-axis`, and a candle `--chart-up` or
 // `--chart-down`, each if set. A count's line is curved; a price's is straight,
-// since a curve between two closes draws prices nobody paid.
+// since a curve between two closes draws prices nobody paid. Events are markers
+// on the point they fall in, so a spike carries the reason for it.
 import { useEffect, useMemo, useRef, useState } from 'react';
 const DAY = 86_400;
 const RANGE = {
@@ -49,6 +50,8 @@ function bucketStart(time, step) {
  * step, as a candle does its close: the first open, the highest high, the
  * lowest low. A count takes the mean of its days, so the week in progress does
  * not read as a collapse. Volume is summed.
+ *
+ * @internal
  */
 export function bucketChart(points, step, aggregate) {
     const out = [];
@@ -74,6 +77,31 @@ export function bucketChart(points, step, aggregate) {
     }
     return out;
 }
+/**
+ * Markers on the points drawn: each on the last point at or before it, so one
+ * mid-week sits on its week. Markers on one point share it, labels joined; one
+ * before the first point or after the last point's step is left off.
+ *
+ * @internal
+ */
+export function placeMarkers(markers, shown, step) {
+    const first = shown[0];
+    const last = shown.at(-1);
+    if (!first || !last)
+        return [];
+    const end = last.time + (step ? STEP[step].span : DAY);
+    const placed = new Map();
+    for (const m of [...markers].sort((a, b) => a.time - b.time)) {
+        if (m.time < first.time || m.time >= end)
+            continue;
+        let i = shown.length - 1;
+        while (i > 0 && shown[i].time > m.time)
+            i--;
+        const time = shown[i].time;
+        placed.set(time, [...(placed.get(time) ?? []), m.label]);
+    }
+    return [...placed].map(([time, labels]) => ({ time, label: labels.join(' · ') }));
+}
 const isCandle = (p) => p.open !== undefined && p.high !== undefined && p.low !== undefined;
 const compact = new Intl.NumberFormat('en', { notation: 'compact', maximumFractionDigits: 2 });
 const precise = new Intl.NumberFormat('en', { maximumSignificantDigits: 4 });
@@ -102,14 +130,16 @@ const fromZeroScale = (base) => {
  * `.chart-controls button[aria-pressed]`, and a site's stylesheet gives them
  * and the box their look; the line and fill are the canvas box's `color`.
  */
-export function TimeChart({ series, label, ranges = typeof series === 'function' ? CHART_RANGES : DAILY_RANGES, range: initial = ranges.includes('30d') ? '30d' : ranges[0], aggregate = 'last', fromZero = false, format = formatChartValue, candles: initialCandles = false, height, controls, className, }) {
+export function TimeChart({ series, label, ranges = typeof series === 'function' ? CHART_RANGES : DAILY_RANGES, range: initial = ranges.includes('30d') ? '30d' : ranges[0], aggregate = 'last', fromZero = false, format = formatChartValue, candles: initialCandles = false, height, controls, markers, step: initialStep, onView, className, }) {
     const box = useRef(null);
     const chart = useRef(null);
     const formatRef = useRef(format);
     formatRef.current = format;
+    const onViewRef = useRef(onView);
+    onViewRef.current = onView;
     const [ready, setReady] = useState(false);
     const [range, setRange] = useState(initial);
-    const [step, setStep] = useState(null);
+    const [step, setStep] = useState(initialStep ?? null);
     const [candles, setCandles] = useState(initialCandles);
     const [loaded, setLoaded] = useState(null);
     const resolution = RANGE[range].resolution;
@@ -118,7 +148,7 @@ export function TimeChart({ series, label, ranges = typeof series === 'function'
         if (!el)
             return;
         let disposed = false;
-        import('lightweight-charts').then(({ createChart, AreaSeries, CandlestickSeries, HistogramSeries, ColorType, CrosshairMode, LineStyle, LineType }) => {
+        import('lightweight-charts').then(({ createChart, createSeriesMarkers, AreaSeries, CandlestickSeries, HistogramSeries, ColorType, CrosshairMode, LineStyle, LineType }) => {
             if (disposed)
                 return;
             const style = getComputedStyle(el);
@@ -177,7 +207,11 @@ export function TimeChart({ series, label, ranges = typeof series === 'function'
                 api.panes()[1]?.setStretchFactor(1);
                 return volume;
             };
-            chart.current = { api, area, candle, volume: null, addVolume, up, down };
+            chart.current = {
+                api, area, candle, volume: null, addVolume, up, down, ink,
+                areaMarkers: createSeriesMarkers(area, []),
+                candleMarkers: createSeriesMarkers(candle, []),
+            };
             setReady(true);
         });
         return () => {
@@ -259,8 +293,21 @@ export function TimeChart({ series, label, ranges = typeof series === 'function'
             const rising = p.value >= (p.open ?? shown[i - 1]?.value ?? p.value);
             return { time: time(p), value: p.volume ?? 0, color: (rising ? c.up : c.down).replace(/[\d.]+\)$/, '0.5)') };
         }));
+        const drawn = placeMarkers(markers ?? [], shown, view?.step ?? null).map(m => ({
+            time: time(m),
+            position: 'aboveBar',
+            shape: 'arrowDown',
+            color: c.ink,
+            text: m.label,
+        }));
+        c.areaMarkers.setMarkers(asCandles ? [] : drawn);
+        c.candleMarkers.setMarkers(asCandles ? drawn : []);
         c.api.timeScale().fitContent();
-    }, [ready, source, view, candles]);
+    }, [ready, source, view, candles, markers]);
+    const shownStep = view?.step ?? null;
+    useEffect(() => {
+        onViewRef.current?.({ range, step: shownStep });
+    }, [range, shownStep]);
     // The steps always show where a range is drawn by day, so the buttons do not jump about; one
     // the range cannot make (any, under 24H and 7D) is disabled.
     const daily = ranges.some(r => RANGE[r].resolution === 'day');

package/dist/combobox.d.ts

@@ -43,10 +43,6 @@ export interface ComboboxAria {
     listProps: ComboboxListProps;
     optionProps: (index: number) => ComboboxOptionProps;
 }
-/** The id of one option row. Exported because a caller that scrolls the
- *  highlighted row into view has to find it by the same id the input points at. */
-export declare function optionId(baseId: string, listKey: string | undefined, index: number): string;
-export declare function listId(baseId: string, listKey?: string): string;
 /**
  * Every attribute the three parts of a combobox need, derived from what the
  * typeahead already knows.

package/dist/combobox.js

@@ -12,9 +12,11 @@
 // Enter does.
 /** The id of one option row. Exported because a caller that scrolls the
  *  highlighted row into view has to find it by the same id the input points at. */
+/** @internal */
 export function optionId(baseId, listKey, index) {
     return `${listId(baseId, listKey)}-opt-${index}`;
 }
+/** @internal */
 export function listId(baseId, listKey) {
     return listKey ? `${baseId}-${listKey}` : `${baseId}-list`;
 }

package/dist/crawlers.d.ts

@@ -12,15 +12,6 @@ export interface AiCrawler {
      */
     fetches: boolean;
 }
-/**
- * Order is significant: `detectAiBot` returns the first token the user agent
- * contains, so a token that is a substring of another must come after it.
- */
-export declare const AI_CRAWLERS: readonly AiCrawler[];
-/** The event label for a user agent, or null when it is not a known crawler. */
-export declare function detectAiBot(userAgent: string | null | undefined): string | null;
-/** Every token that needs its own robots.txt group — which is all of them. */
-export declare function aiCrawlerTokens(): string[];
 /**
  * Structurally what Next's `MetadataRoute.Robots['rules']` wants, without
  * importing Next: this package has no runtime dependencies and is not going to
@@ -31,21 +22,6 @@ export interface RobotsGroup {
     allow?: string | string[];
     disallow?: string | string[];
 }
-/**
- * The agent surface an S10 origin serves, allowed in every group. All three
- * `robots.ts` files listed these by hand, and a path missing from one list is
- * an endpoint the origin advertises and then closes to the callers it named.
- */
-export declare const AGENT_SURFACE_PATHS: readonly string[];
-/**
- * The React Server Components payload a `<Link>` prefetches. A crawler that
- * renders a page runs those prefetches too — 43% of Googlebot's requests on
- * one wiki, against 10% for HTML — and nothing that reads robots.txt can use
- * one. Every group gets it.
- */
-export declare const RSC_DISALLOW: readonly string[];
-/** The search engines that get the HTML site and none of its twins. */
-export declare const SEARCH_ENGINES: readonly string[];
 /**
  * Every group robots.txt needs: the wildcard, one per AI crawler, one per
  * search engine.

package/dist/crawlers.js

@@ -14,6 +14,8 @@
 /**
  * Order is significant: `detectAiBot` returns the first token the user agent
  * contains, so a token that is a substring of another must come after it.
+ *
+ * @internal
  */
 export const AI_CRAWLERS = [
     { token: 'GPTBot', label: 'GPTBot', fetches: true },
@@ -39,7 +41,7 @@ export const AI_CRAWLERS = [
     { token: 'DuckAssistBot', label: 'DuckAssistBot', fetches: true },
     { token: 'Applebot-Extended', label: 'AppleExtended', fetches: false },
 ];
-/** The event label for a user agent, or null when it is not a known crawler. */
+/** The event label for a user agent, or null when it is not a known crawler. @internal */
 export function detectAiBot(userAgent) {
     if (!userAgent)
         return null;
@@ -49,7 +51,7 @@ export function detectAiBot(userAgent) {
     }
     return null;
 }
-/** Every token that needs its own robots.txt group — which is all of them. */
+/** Every token that needs its own robots.txt group — which is all of them. @internal */
 export function aiCrawlerTokens() {
     return AI_CRAWLERS.map(c => c.token);
 }
@@ -57,6 +59,8 @@ export function aiCrawlerTokens() {
  * The agent surface an S10 origin serves, allowed in every group. All three
  * `robots.ts` files listed these by hand, and a path missing from one list is
  * an endpoint the origin advertises and then closes to the callers it named.
+ *
+ * @internal
  */
 export const AGENT_SURFACE_PATHS = [
     '/api/mcp',
@@ -71,9 +75,11 @@ export const AGENT_SURFACE_PATHS = [
  * renders a page runs those prefetches too — 43% of Googlebot's requests on
  * one wiki, against 10% for HTML — and nothing that reads robots.txt can use
  * one. Every group gets it.
+ *
+ * @internal
  */
 export const RSC_DISALLOW = ['/*?_rsc=', '/*&_rsc='];
-/** The search engines that get the HTML site and none of its twins. */
+/** The search engines that get the HTML site and none of its twins. @internal */
 export const SEARCH_ENGINES = ['Googlebot', 'Bingbot'];
 /**
  * Every group robots.txt needs: the wildcard, one per AI crawler, one per

package/dist/dom.d.ts

@@ -17,11 +17,6 @@ export interface CopyButtonOptions {
  * Returns the number of buttons added, so a caller can skip work when zero.
  */
 export declare function addCopyButtons(root: ParentNode, options?: CopyButtonOptions): number;
-/**
- * The one place this origin is written down. It is both the embed host and the
- * allow-list the resize listener checks.
- */
-export declare const TWITTER_ORIGIN = "https://platform.twitter.com";
 /** The embed iframe's src. `dnt=true` opts the embed out of Twitter's tracking. */
 export declare const tweetEmbedSrc: (tweetId: string | number) => string;
 /**

package/dist/dom.js

@@ -56,6 +56,8 @@ export function addCopyButtons(root, options = {}) {
 /**
  * The one place this origin is written down. It is both the embed host and the
  * allow-list the resize listener checks.
+ *
+ * @internal
  */
 export const TWITTER_ORIGIN = 'https://platform.twitter.com';
 /** The embed iframe's src. `dnt=true` opts the embed out of Twitter's tracking. */

package/dist/editor.d.ts

@@ -15,19 +15,6 @@ export type { StarterKitOptions } from '@tiptap/starter-kit';
 export type { LinkOptions } from '@tiptap/extension-link';
 export type { ImageOptions } from '@tiptap/extension-image';
 export type { TableOptions } from '@tiptap/extension-table';
-/**
- * Tiptap's Link, storing an href and the `link` class and nothing else.
- *
- * Stock Link writes `target="_blank" rel="noopener noreferrer nofollow"` onto
- * every link, internal ones included, and the schema then reads both back from
- * stored HTML, so a page edited once kept them for good. Nofollow on a site's
- * own links throws away its link equity, and a new tab for in-site navigation
- * is a bug. Whether a link is external depends on the host it is served from,
- * which the editor cannot know, so the render path decides: `normaliseLinks`
- * from `wiki-formant/links`. Dropping both attributes from the mark also cleans
- * a legacy link the next time its page is saved.
- */
-export declare const wikiLink: import("@tiptap/core").Mark<import("@tiptap/extension-link").LinkOptions, any>;
 export interface WikiEditorExtensionOptions {
     /** Empty-document prompt. */
     placeholder?: string;
@@ -41,20 +28,6 @@ export interface WikiEditorExtensionOptions {
      */
     nodes?: readonly AnyExtension[];
 }
-/**
- * Turn a pasted URL into the richest node that fits it, falling back to a bare
- * iframe. Order matters: a YouTube URL is also a valid iframe source, so the
- * specific cases have to be tried before the general one.
- *
- * A shortened map link inserts IMMEDIATELY with `about:blank` and swaps its
- * `src` once the redirect resolves. Pasting must not block on a network hop,
- * and the node has to already exist for the reader to see anything happen. The
- * swap re-finds the node by its `url` attribute rather than caching a position,
- * because every keystroke between the paste and the resolve moves it.
- */
-export declare function insertEmbed(editor: Editor, url: string, { resolveMapUrl }: {
-    resolveMapUrl: (url: string) => Promise<string | null>;
-}): void;
 /** The table controls, shown only while the selection is inside a table. */
 export declare const TABLE_ACTIONS: ReadonlyArray<[command: string, label: string, danger?: boolean]>;
 /** `editor.isActive` as a toolbar button's `active` descriptor expresses it. */
@@ -71,13 +44,6 @@ export interface ToolbarAction {
     run?: (editor: Editor) => void;
     withUrl?: (editor: Editor, url: string) => void;
 }
-/**
- * The formatting commands, labelled. Three toolbars ran these identically and
- * two titled their buttons with the internal key — a screen reader said
- * "codeBlock", and inline code and code block shared one icon and one name.
- * Upload and embed stay with the caller: they are the parts that differ.
- */
-export declare const TOOLBAR_ACTIONS: readonly ToolbarAction[];
 /** The actions a toolbar shows, in the order it shows them. */
 export declare function toolbarActions(keys: readonly ToolbarKey[]): ToolbarAction[];
 /**
@@ -92,15 +58,6 @@ export declare function ToolbarButton({ label, pressed, onPress, className, chil
     children: ReactNode;
 }): import("react").JSX.Element;
 export type UrlPromptKind = 'link' | 'embed';
-/**
- * What a link or embed field does with its address. A link sets or replaces
- * the link the cursor is in, across the whole link rather than the collapsed
- * selection, and an emptied address takes it off while keeping the text. An
- * embed with no address does nothing.
- */
-export declare function applyUrlPrompt(editor: Editor, kind: UrlPromptKind, url: string, { resolveMapUrl }: {
-    resolveMapUrl: (url: string) => Promise<string | null>;
-}): void;
 export interface UrlPromptState {
     /** The open field, or null. */
     kind: UrlPromptKind | null;