@geekity/cms 0.3.0 → 0.5.0

package/dist/web/navigation.d.ts

@@ -0,0 +1,195 @@
+import type { SiteData } from './context.ts';
+/**
+ * The menu a theme renders when nothing says which one it means: the menu that
+ * was the whole of `navigation` before menus had names (TASK-107).
+ */
+export declare const DEFAULT_MENU_NAME = "primary";
+/**
+ * The flags one menu item may carry, as `site.json` spells them and as the
+ * settings screen writes them at the end of a line.
+ *
+ * A flag is a word rather than a value, and the list is here rather than
+ * spread through the parsers so that a second one — `nofollow`, say, or a flag
+ * that opens a link in its own tab — is one entry and its handling in the
+ * theme, not a new shape for an item.
+ */
+export declare const MENU_ITEM_FLAGS: readonly ['me'];
+/** One of {@link MENU_ITEM_FLAGS}. */
+export type MenuItemFlag = (typeof MENU_ITEM_FLAGS)[number];
+/**
+ * What a menu name may be spelled with.
+ *
+ * A menu name is the word a theme writes after the dot in
+ * `{% for item in menus.footer %}`, and the key `site.json` stores that menu
+ * under. So it is an identifier before it is a slug: in a template
+ * `menus.top-bar` is `menus.top` minus `bar`, which renders nothing, raises
+ * nothing and leaves somebody looking at an empty page wondering which half is
+ * broken. A hyphen is refused here so that cannot happen.
+ *
+ * Lower case is the other half of the rule, and it is what refuses the
+ * spellings that would be confused with each other: `footer` and `Footer`
+ * would be two menus on the Navigation screen, one of them rendered nowhere,
+ * and no way to see the difference between them at a glance.
+ */
+export declare const MENU_NAME_PATTERN: RegExp;
+/** The longest a menu name may be. Long enough for a phrase, short enough to read. */
+export declare const MENU_NAME_MAX_LENGTH = 32;
+/**
+ * What is wrong with a proposed menu name, or `undefined` when nothing is.
+ *
+ * The rule governs a name somebody types on the Navigation screen (TASK-108).
+ * A name a `theme.json` declares is a menu name by declaration and is shown as
+ * the theme spells it: the theme decides where its own menus go, and a screen
+ * that hid a declared area because it disliked the spelling would leave
+ * somebody unable to fill in a menu their site renders.
+ */
+export declare function menuNameProblem(name: string): string | undefined;
+/** One entry of a menu, as `site.json` and the settings screen spell it. */
+export interface NavigationItem {
+    /** The words on the link. */
+    label: string;
+    /** Where it goes: a site-root path, or an absolute URL for somewhere else. */
+    url: string;
+    /**
+     * Whether the link carries `rel="me"`, which is how Mastodon and the rest of
+     * the IndieWeb verify that the site and the profile it links are the same
+     * person.
+     *
+     * Present only when it is set. An unmarked item is spelled exactly as every
+     * item was before flags existed, so a `site.json` holding a plain
+     * `{ label, url }` is a complete item rather than one missing a key, and a
+     * flag added later never has to be written across a file to mean nothing.
+     */
+    me?: true;
+}
+/** Every menu one site stores, by name. */
+export type NavigationMenus = Record<string, NavigationItem[]>;
+/** One entry of the menu a theme renders. */
+export interface MenuItem extends NavigationItem {
+    /** Whether this is the page being looked at, for `aria-current`. */
+    current: boolean;
+}
+/** Every menu a theme renders, by name, marked for the page being rendered. */
+export type MenuList = Record<string, MenuItem[]>;
+/** What {@link navigationMenu} builds a menu out of. */
+export interface NavigationMenuOptions {
+    /** The site data, whose `menus` hold every menu it has. */
+    site: SiteData;
+    /** The path being rendered, which is what marks an item current. */
+    url: string;
+    /** Which menu. {@link DEFAULT_MENU_NAME} when nothing says. */
+    name?: string | undefined;
+}
+/**
+ * One named menu for one request: the items the site stores under that name,
+ * with the one the request is on marked.
+ *
+ * The setting is the only source of a menu (TASK-106). A page cannot put
+ * itself in one, so there is one screen to edit a menu on, one order — the
+ * order the lines were typed in — and no way for one link to appear twice. A
+ * page that should be linked is linked by typing a line for it, including the
+ * page a site serves as its front page: that one is typed `Home | /`, the URL
+ * a reader lands on, rather than the permalink that redirects there.
+ *
+ * A name the site has stored nothing under is an empty menu rather than an
+ * error: a theme declaring an area the site has not filled in yet renders
+ * nothing there, which is what an unfilled area should look like.
+ */
+export declare function navigationMenu(options: NavigationMenuOptions): MenuItem[];
+/** What {@link navigationMenus} builds every menu out of. */
+export interface NavigationMenusOptions {
+    /** The site data, whose `menus` hold every menu it has. */
+    site: SiteData;
+    /** The path being rendered, which is what marks an item current. */
+    url: string;
+}
+/**
+ * Every menu one site stores, by name, marked for this request: what the
+ * template context carries as `menus`.
+ *
+ * Every stored menu is here, not only the ones the theme in use declares an
+ * area for. The declaration in `theme.json` is what the Navigation screen
+ * reads to say where a menu can go (TASK-108); it is not a filter on the
+ * render, because a theme that renders a menu it forgot to declare should look
+ * wrong on the screen that lists areas rather than silently render nothing.
+ * A menu no template loops over is simply rendered nowhere, and kept.
+ */
+export declare function navigationMenus(options: NavigationMenusOptions): MenuList;
+/**
+ * The items of one named menu, ignoring anything that is not one.
+ *
+ * Tolerant on the way out, the way `taxonomyBasesOrDefault` is: the settings
+ * screen refuses a malformed item, so anything unreadable here came from a
+ * hand-edited `site.json`, and a menu that quietly loses a line is a better
+ * answer than a site that will not render.
+ */
+export declare function navigationItems(site: SiteData, name?: string): NavigationItem[];
+/**
+ * Every menu the site data stores, by name.
+ *
+ * The one place `site.menus` is read on the render side, the way
+ * {@link navigationItems} was the one place `site.navigation` was read before
+ * menus had names. The old key is not read at all: a site.json still carrying
+ * `navigation` has a key nothing looks at, which is what a rename means.
+ */
+export declare function siteMenus(site: SiteData): NavigationMenus;
+/**
+ * A `menus` value as the menus it names, ignoring anything that is not one.
+ *
+ * One spelling for the site data a render reads and the `menus` the settings
+ * screen writes, so a menu means the same thing to the theme and to the form
+ * that edits it. Anything but a plain object — a list, a string, nothing at
+ * all — is a site with no menus; a name holding something that is not a list
+ * is a menu with nothing in it, because the name is still a menu this site
+ * holds and the Navigation screen has to be able to show it.
+ */
+export declare function menusOf(value: unknown): NavigationMenus;
+/**
+ * One menu's stored value as the items it names, ignoring anything that is not
+ * one.
+ *
+ * A flag is read only when it is spelled exactly `true`: `"yes"`, `1` and
+ * `false` all leave the item unmarked, so a flag is either set or it is not
+ * and a theme writes `{% if item.me %}` without wondering what else the file
+ * might have put there.
+ */
+export declare function navigationItemsOf(value: unknown): NavigationItem[];
+/**
+ * One `Label | URL` line as a menu item, or `undefined` when it is not one.
+ *
+ * The URL is either a site-root path or an absolute http(s) URL: a bare
+ * `about/` would be resolved against whatever page it was printed on, which is
+ * never what a menu means.
+ *
+ * A line may end in the flags the item carries, one per bar — `Mastodon |
+ * https://example.social/@me | me` — and those are taken off the end first,
+ * from the right, and only while the last part is the name of a flag this CMS
+ * actually has ({@link MENU_ITEM_FLAGS}). That is what lets a URL still hold a
+ * bar, a query string say: a trailing `| elsewhere` is not a flag, so it stays
+ * part of the URL and the line is refused for not naming one, rather than
+ * being quietly read as a flag nobody asked for.
+ *
+ * What is left splits at its first bar, so a label still cannot hold one.
+ */
+export declare function menuItemOf(line: string): NavigationItem | undefined;
+/**
+ * A menu box as the ordered items it names, dropping the lines that are not
+ * items.
+ *
+ * Call {@link menuItemLineProblem} first where a person is waiting to be told:
+ * this is the tolerant read, which is what the old settings table's rows and a
+ * validated box both go through. `site.json` is read by {@link menusOf}
+ * instead, because the file holds objects rather than lines.
+ */
+export declare function menuItemsFromText(value: string): NavigationItem[];
+/** The items as a box shows them: one line each, in order. */
+export declare function menuItemsText(items: readonly NavigationItem[]): string;
+/**
+ * What is wrong with a typed menu, or `undefined` when nothing is.
+ *
+ * One message naming the first bad line rather than a count of how many there
+ * are: a box is fixed a line at a time, and the line to fix is the useful
+ * half of the sentence.
+ */
+export declare function menuItemLineProblem(value: string): string | undefined;
+//# sourceMappingURL=navigation.d.ts.map

package/dist/web/navigation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation.d.ts","sourceRoot":"","sources":["../../src/web/navigation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAE7C;;;GAGG;AACH,eAAO,MAAM,iBAAiB,YAAY,CAAC;AAE3C;;;;;;;;GAQG;AACH,eAAO,MAAM,eAAe,YAAI,IAAI,CAAU,CAAC;AAE/C,sCAAsC;AACtC,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5D;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,iBAAiB,QAAsB,CAAC;AAErD,sFAAsF;AACtF,eAAO,MAAM,oBAAoB,KAAK,CAAC;AAEvC;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAmBhE;AAED,4EAA4E;AAC5E,MAAM,WAAW,cAAc;IAC7B,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,8EAA8E;IAC9E,GAAG,EAAE,MAAM,CAAC;IACZ;;;;;;;;;OASG;IACH,EAAE,CAAC,EAAE,IAAI,CAAC;CACX;AAED,2CAA2C;AAC3C,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC,CAAC;AAE/D,6CAA6C;AAC7C,MAAM,WAAW,QAAS,SAAQ,cAAc;IAC9C,oEAAoE;IACpE,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,+EAA+E;AAC/E,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;AAElD,wDAAwD;AACxD,MAAM,WAAW,qBAAqB;IACpC,2DAA2D;IAC3D,IAAI,EAAE,QAAQ,CAAC;IACf,oEAAoE;IACpE,GAAG,EAAE,MAAM,CAAC;IACZ,+DAA+D;IAC/D,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,QAAQ,EAAE,CAEzE;AAED,6DAA6D;AAC7D,MAAM,WAAW,sBAAsB;IACrC,2DAA2D;IAC3D,IAAI,EAAE,QAAQ,CAAC;IACf,oEAAoE;IACpE,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,QAAQ,CAMzE;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,QAAQ,EACd,IAAI,GAAE,MAA0B,GAC/B,cAAc,EAAE,CAElB;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,QAAQ,GAAG,eAAe,CAEzD;AAED;;;;;;;;;GASG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,CASvD;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,EAAE,CAYlE;AAeD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAyBnE;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,EAAE,CAOjE;AAED,8DAA8D;AAC9D,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,cAAc,EAAE,GAAG,MAAM,CAItE;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAOrE"}

package/dist/web/navigation.js

@@ -0,0 +1,300 @@
+/**
+ * The menu a theme renders when nothing says which one it means: the menu that
+ * was the whole of `navigation` before menus had names (TASK-107).
+ */
+export const DEFAULT_MENU_NAME = 'primary';
+/**
+ * The flags one menu item may carry, as `site.json` spells them and as the
+ * settings screen writes them at the end of a line.
+ *
+ * A flag is a word rather than a value, and the list is here rather than
+ * spread through the parsers so that a second one — `nofollow`, say, or a flag
+ * that opens a link in its own tab — is one entry and its handling in the
+ * theme, not a new shape for an item.
+ */
+export const MENU_ITEM_FLAGS = ['me'];
+/**
+ * What a menu name may be spelled with.
+ *
+ * A menu name is the word a theme writes after the dot in
+ * `{% for item in menus.footer %}`, and the key `site.json` stores that menu
+ * under. So it is an identifier before it is a slug: in a template
+ * `menus.top-bar` is `menus.top` minus `bar`, which renders nothing, raises
+ * nothing and leaves somebody looking at an empty page wondering which half is
+ * broken. A hyphen is refused here so that cannot happen.
+ *
+ * Lower case is the other half of the rule, and it is what refuses the
+ * spellings that would be confused with each other: `footer` and `Footer`
+ * would be two menus on the Navigation screen, one of them rendered nowhere,
+ * and no way to see the difference between them at a glance.
+ */
+export const MENU_NAME_PATTERN = /^[a-z][a-z0-9_]*$/;
+/** The longest a menu name may be. Long enough for a phrase, short enough to read. */
+export const MENU_NAME_MAX_LENGTH = 32;
+/**
+ * What is wrong with a proposed menu name, or `undefined` when nothing is.
+ *
+ * The rule governs a name somebody types on the Navigation screen (TASK-108).
+ * A name a `theme.json` declares is a menu name by declaration and is shown as
+ * the theme spells it: the theme decides where its own menus go, and a screen
+ * that hid a declared area because it disliked the spelling would leave
+ * somebody unable to fill in a menu their site renders.
+ */
+export function menuNameProblem(name) {
+    const proposed = name.trim();
+    if (proposed === '')
+        return 'A menu needs a name: it is what a theme asks for the menu by.';
+    if (proposed.length > MENU_NAME_MAX_LENGTH) {
+        return `A menu name is at most ${String(MENU_NAME_MAX_LENGTH)} characters, and "${proposed}" is longer.`;
+    }
+    if (proposed !== proposed.toLowerCase()) {
+        return `A menu name is lower case, so "${proposed}" would be a second menu beside "${proposed.toLowerCase()}" that nothing could tell apart. Try "${proposed.toLowerCase()}".`;
+    }
+    if (!MENU_NAME_PATTERN.test(proposed)) {
+        return (`"${proposed}" is not a menu name. A name is lower-case letters, digits and ` +
+            `underscores and has to start with a letter, because a theme writes it after ` +
+            `the dot — menus.footer — where a dash would be a minus sign.`);
+    }
+    return undefined;
+}
+/**
+ * One named menu for one request: the items the site stores under that name,
+ * with the one the request is on marked.
+ *
+ * The setting is the only source of a menu (TASK-106). A page cannot put
+ * itself in one, so there is one screen to edit a menu on, one order — the
+ * order the lines were typed in — and no way for one link to appear twice. A
+ * page that should be linked is linked by typing a line for it, including the
+ * page a site serves as its front page: that one is typed `Home | /`, the URL
+ * a reader lands on, rather than the permalink that redirects there.
+ *
+ * A name the site has stored nothing under is an empty menu rather than an
+ * error: a theme declaring an area the site has not filled in yet renders
+ * nothing there, which is what an unfilled area should look like.
+ */
+export function navigationMenu(options) {
+    return markCurrent(navigationItems(options.site, options.name), options.url);
+}
+/**
+ * Every menu one site stores, by name, marked for this request: what the
+ * template context carries as `menus`.
+ *
+ * Every stored menu is here, not only the ones the theme in use declares an
+ * area for. The declaration in `theme.json` is what the Navigation screen
+ * reads to say where a menu can go (TASK-108); it is not a filter on the
+ * render, because a theme that renders a menu it forgot to declare should look
+ * wrong on the screen that lists areas rather than silently render nothing.
+ * A menu no template loops over is simply rendered nowhere, and kept.
+ */
+export function navigationMenus(options) {
+    const menus = {};
+    for (const [name, items] of Object.entries(siteMenus(options.site))) {
+        menus[name] = markCurrent(items, options.url);
+    }
+    return menus;
+}
+/**
+ * The items of one named menu, ignoring anything that is not one.
+ *
+ * Tolerant on the way out, the way `taxonomyBasesOrDefault` is: the settings
+ * screen refuses a malformed item, so anything unreadable here came from a
+ * hand-edited `site.json`, and a menu that quietly loses a line is a better
+ * answer than a site that will not render.
+ */
+export function navigationItems(site, name = DEFAULT_MENU_NAME) {
+    return navigationItemsOf(menusOf(site['menus'])[name]);
+}
+/**
+ * Every menu the site data stores, by name.
+ *
+ * The one place `site.menus` is read on the render side, the way
+ * {@link navigationItems} was the one place `site.navigation` was read before
+ * menus had names. The old key is not read at all: a site.json still carrying
+ * `navigation` has a key nothing looks at, which is what a rename means.
+ */
+export function siteMenus(site) {
+    return menusOf(site['menus']);
+}
+/**
+ * A `menus` value as the menus it names, ignoring anything that is not one.
+ *
+ * One spelling for the site data a render reads and the `menus` the settings
+ * screen writes, so a menu means the same thing to the theme and to the form
+ * that edits it. Anything but a plain object — a list, a string, nothing at
+ * all — is a site with no menus; a name holding something that is not a list
+ * is a menu with nothing in it, because the name is still a menu this site
+ * holds and the Navigation screen has to be able to show it.
+ */
+export function menusOf(value) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value))
+        return {};
+    const menus = {};
+    for (const [name, items] of Object.entries(value)) {
+        if (name === '')
+            continue;
+        menus[name] = navigationItemsOf(items);
+    }
+    return menus;
+}
+/**
+ * One menu's stored value as the items it names, ignoring anything that is not
+ * one.
+ *
+ * A flag is read only when it is spelled exactly `true`: `"yes"`, `1` and
+ * `false` all leave the item unmarked, so a flag is either set or it is not
+ * and a theme writes `{% if item.me %}` without wondering what else the file
+ * might have put there.
+ */
+export function navigationItemsOf(value) {
+    if (!Array.isArray(value))
+        return [];
+    const items = [];
+    for (const entry of value) {
+        if (typeof entry !== 'object' || entry === null)
+            continue;
+        const { label, url, me } = entry;
+        if (typeof label !== 'string' || label === '')
+            continue;
+        if (typeof url !== 'string' || url === '')
+            continue;
+        items.push({ label, url, ...(me === true ? { me: true } : {}) });
+    }
+    return items;
+}
+/**
+ * The non-empty lines of a menu box, trimmed.
+ *
+ * A blank line is not an error, exactly as it is not in the relay list: a
+ * pasted menu leaves them, and a blank line asks for nothing.
+ */
+function menuLines(value) {
+    return value
+        .split('\n')
+        .map((line) => line.trim())
+        .filter((line) => line !== '');
+}
+/**
+ * One `Label | URL` line as a menu item, or `undefined` when it is not one.
+ *
+ * The URL is either a site-root path or an absolute http(s) URL: a bare
+ * `about/` would be resolved against whatever page it was printed on, which is
+ * never what a menu means.
+ *
+ * A line may end in the flags the item carries, one per bar — `Mastodon |
+ * https://example.social/@me | me` — and those are taken off the end first,
+ * from the right, and only while the last part is the name of a flag this CMS
+ * actually has ({@link MENU_ITEM_FLAGS}). That is what lets a URL still hold a
+ * bar, a query string say: a trailing `| elsewhere` is not a flag, so it stays
+ * part of the URL and the line is refused for not naming one, rather than
+ * being quietly read as a flag nobody asked for.
+ *
+ * What is left splits at its first bar, so a label still cannot hold one.
+ */
+export function menuItemOf(line) {
+    const flags = new Set();
+    let rest = line;
+    for (;;) {
+        const bar = rest.lastIndexOf('|');
+        if (bar === -1)
+            break;
+        const flag = rest
+            .slice(bar + 1)
+            .trim()
+            .toLowerCase();
+        if (!MENU_ITEM_FLAGS.includes(flag))
+            break;
+        flags.add(flag);
+        rest = rest.slice(0, bar);
+    }
+    const bar = rest.indexOf('|');
+    if (bar === -1)
+        return undefined;
+    const label = rest.slice(0, bar).trim();
+    const url = rest.slice(bar + 1).trim();
+    if (label === '' || url === '')
+        return undefined;
+    if (!url.startsWith('/') && !isAbsoluteHttpUrl(url))
+        return undefined;
+    return { label, url, ...(flags.has('me') ? { me: true } : {}) };
+}
+/**
+ * A menu box as the ordered items it names, dropping the lines that are not
+ * items.
+ *
+ * Call {@link menuItemLineProblem} first where a person is waiting to be told:
+ * this is the tolerant read, which is what the old settings table's rows and a
+ * validated box both go through. `site.json` is read by {@link menusOf}
+ * instead, because the file holds objects rather than lines.
+ */
+export function menuItemsFromText(value) {
+    const items = [];
+    for (const line of menuLines(value)) {
+        const item = menuItemOf(line);
+        if (item !== undefined)
+            items.push(item);
+    }
+    return items;
+}
+/** The items as a box shows them: one line each, in order. */
+export function menuItemsText(items) {
+    return items
+        .map((item) => `${item.label} | ${item.url}${item.me === true ? ' | me' : ''}`)
+        .join('\n');
+}
+/**
+ * What is wrong with a typed menu, or `undefined` when nothing is.
+ *
+ * One message naming the first bad line rather than a count of how many there
+ * are: a box is fixed a line at a time, and the line to fix is the useful
+ * half of the sentence.
+ */
+export function menuItemLineProblem(value) {
+    const bad = menuLines(value).find((line) => menuItemOf(line) === undefined);
+    return bad === undefined
+        ? undefined
+        : `A menu item is "Label | URL", one per line, where the URL is a path ` +
+            `like /about/ or an absolute http:// or https:// URL, and ends ` +
+            `"| me" for a link that should carry rel="me". "${bad}" is not one.`;
+}
+/**
+ * Whether a menu URL is an absolute http(s) one.
+ *
+ * Deliberately a test rather than a normaliser: a menu keeps the URL as it was
+ * typed, so `https://example.social/@me` is what the link says and what the
+ * box shows it back as.
+ */
+function isAbsoluteHttpUrl(url) {
+    let parsed;
+    try {
+        parsed = new URL(url);
+    }
+    catch {
+        return false;
+    }
+    return parsed.protocol === 'http:' || parsed.protocol === 'https:';
+}
+/** One menu's items, with the one the request is on marked. */
+function markCurrent(items, url) {
+    const here = comparablePath(url);
+    return items.map((item) => ({
+        ...item,
+        current: here !== undefined && comparablePath(item.url) === here,
+    }));
+}
+/**
+ * A menu URL as the string two of them are compared by: its path without the
+ * trailing slash that is canonical here, or `undefined` when it is not a path
+ * on this site at all.
+ *
+ * An item pointing somewhere else is never the page being looked at, even when
+ * its URL happens to name this origin: it is a link off the site as far as the
+ * menu is concerned, and the request path it would be compared against is
+ * never absolute.
+ */
+function comparablePath(url) {
+    if (!url.startsWith('/'))
+        return undefined;
+    const path = url.split(/[?#]/)[0] ?? url;
+    return path.length > 1 && path.endsWith('/') ? path.slice(0, -1) : path;
+}
+//# sourceMappingURL=navigation.js.map

package/dist/web/navigation.js.map

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

package/dist/web/negotiate.d.ts

@@ -141,6 +141,28 @@ export interface RepresentationResponseOptions {
     href: string;
     /** Which representations this resource offers, for the `Link` alternates. */
     available: readonly Representation[];
+    /**
+     * Whole `Link` header values to advertise alongside the alternates — the
+     * webmention endpoint is the one that uses it (TASK-51).
+     *
+     * Spelled by the caller rather than built here, because they are not
+     * representations of this resource and nothing about them is this module's
+     * business beyond joining them to the header.
+     */
+    links?: readonly string[] | undefined;
+    /**
+     * Whether this response was drawn for one named reader rather than for
+     * everybody (TASK-103).
+     *
+     * A post page is the same for every reader, which is what lets a CDN or a
+     * reverse proxy — the Docker deployment documents one — hold it and hand it
+     * out. The moment it says "Commenting as ada" it is one person's page, and
+     * anything in front of the site holding it would hand her name to the next
+     * reader. Such a response says so, and carries no validator either: a
+     * browser revalidating its own copy would otherwise be told a page drawn for
+     * somebody signed in is still fresh after they signed out.
+     */
+    private?: boolean | undefined;
     /** Validator for this representation. Omit when one cannot be trusted. */
     etag?: string | undefined;
     /** When the resource last changed. */
@@ -158,6 +180,15 @@ export interface RepresentationResponseOptions {
  * one exit means one place where the headers are decided.
  */
 export declare function representationResponse(options: RepresentationResponseOptions): Response;
+/**
+ * What a response drawn for one named reader says about itself.
+ *
+ * `private` is the part that matters: it tells a shared cache this belongs to
+ * one reader and must not be handed to another. `no-store` is the belt to its
+ * braces, and keeps the page off the disk of a browser somebody else uses
+ * after them.
+ */
+export declare const PRIVATE_CACHE_CONTROL = "private, no-store";
 /**
  * The 406 a request earns when it accepts none of the representations on
  * offer, with the options in the body so a client can pick one and retry.

package/dist/web/negotiate.d.ts.map

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

package/dist/web/negotiate.js

@@ -204,20 +204,31 @@ const CONTENT_TYPES = {
 export function representationResponse(options) {
     const headers = new Headers({
         vary: 'Accept',
-        link: alternateLinks(options.href, options.representation, options.available),
+        link: [
+            alternateLinks(options.href, options.representation, options.available),
+            ...(options.links ?? []),
+        ]
+            .filter((value) => value !== '')
+            .join(', '),
     });
-    if (options.etag !== undefined)
-        headers.set('etag', options.etag);
-    if (options.lastModified !== undefined) {
-        headers.set('last-modified', options.lastModified.toUTCString());
+    const personal = options.private === true;
+    if (!personal) {
+        if (options.etag !== undefined)
+            headers.set('etag', options.etag);
+        if (options.lastModified !== undefined) {
+            headers.set('last-modified', options.lastModified.toUTCString());
+        }
+        // A validator without a directive leaves the browser to guess how long the
+        // response stays fresh. `no-cache` keeps the validator's value — a cheap
+        // 304 — without ever letting a stale page through.
+        if (options.etag !== undefined || options.lastModified !== undefined) {
+            headers.set('cache-control', 'no-cache');
+        }
     }
-    // A validator without a directive leaves the browser to guess how long the
-    // response stays fresh. `no-cache` keeps the validator's value — a cheap 304
-    // — without ever letting a stale page through.
-    if (options.etag !== undefined || options.lastModified !== undefined) {
-        headers.set('cache-control', 'no-cache');
+    else {
+        headers.set('cache-control', PRIVATE_CACHE_CONTROL);
     }
-    if (isNotModified(options.conditional, options.etag, options.lastModified)) {
+    if (!personal && isNotModified(options.conditional, options.etag, options.lastModified)) {
         return new Response(null, { status: 304, headers });
     }
     headers.set('content-type', CONTENT_TYPES[options.representation]);
@@ -230,6 +241,15 @@ export function representationResponse(options) {
         : String(options.body);
     return new Response(body, { headers });
 }
+/**
+ * What a response drawn for one named reader says about itself.
+ *
+ * `private` is the part that matters: it tells a shared cache this belongs to
+ * one reader and must not be handed to another. `no-store` is the belt to its
+ * braces, and keeps the page off the disk of a browser somebody else uses
+ * after them.
+ */
+export const PRIVATE_CACHE_CONTROL = 'private, no-store';
 /**
  * The 406 a request earns when it accepts none of the representations on
  * offer, with the options in the body so a client can pick one and retry.