@geekity/cms 0.3.0 → 0.4.0

package/dist/contact/routes.js

@@ -0,0 +1,127 @@
+import { clientAddress, createLoginThrottle } from '../admin/throttle.js';
+import { isPublicDocument } from '../web/documents.js';
+import { sendContactMessage } from './delivery.js';
+import { CONTACT_ANCHOR, CONTACT_FIELDS, CONTACT_NOTICE_PARAM, CONTACT_POST_PATH, contactOpen, contactValuesOf, refilledContactForm, } from './form.js';
+import { CONTACT_RATE_LIMIT, CONTACT_RATE_WINDOW_SECONDS, submitContactMessage, } from './submission.js';
+/**
+ * The one public endpoint the contact form adds: where the form on a page
+ * posts to.
+ *
+ * A single path rather than one per page because the page is a field of the
+ * form. That keeps it out of the way of every permalink a site might mint — a
+ * path under `/_geekity/` is the CMS's own, like the comment endpoint beside
+ * it — and means the route table does not grow with the site.
+ *
+ * Everything it answers is either a redirect or the page rendered again with
+ * the form still filled in. There is no JSON, no fragment and no script.
+ */
+/** Register the contact endpoint. Mounted by the public site. */
+export function mountContact(app) {
+    // One limiter for the whole mount, built on the first submission because the
+    // clock is on the context. It holds nothing but recent submissions, so it
+    // belongs to the process rather than the database: a restart clears it,
+    // which is the right trade for state an anonymous caller can create.
+    let limiter;
+    function throttle(config) {
+        limiter ??= createLoginThrottle({
+            attempts: CONTACT_RATE_LIMIT,
+            lockoutSeconds: CONTACT_RATE_WINDOW_SECONDS,
+            now: config.now,
+        });
+        return limiter;
+    }
+    app.post(CONTACT_POST_PATH, async (c) => {
+        const { store, config } = c.var;
+        const body = await c.req.parseBody();
+        const form = formOf(body);
+        const document = store.getBySlug(form.page);
+        if (document === undefined || !isPublicDocument(document, store.now())) {
+            return c.text('There is no such page to write to.', 404);
+        }
+        if (!contactOpen(document)) {
+            // 403 rather than 404: the page is there, and a reader can see for
+            // themselves that it is. It simply does not take messages.
+            return c.text('That page is not taking messages.', 403);
+        }
+        const now = config.now();
+        const outcome = await submitContactMessage({
+            dataDir: config.dataDir,
+            document,
+            form,
+            baseUrl: config.baseUrl,
+            // The same checker comments go through, told this is a contact form.
+            checker: config.commentChecker,
+            address: clientAddress(c, config),
+            userAgent: c.req.header('user-agent'),
+            referrer: c.req.header('referer'),
+            throttle: throttle(config),
+            now,
+        });
+        if (outcome.kind === 'stored') {
+            // The message is on disk already, so the sender is thanked now and the
+            // mail goes out behind them. A provider that is down costs a
+            // notification rather than the message.
+            sendContactMessage({
+                mail: c.var.mail,
+                contentDir: config.contentDir,
+                dataDir: config.dataDir,
+                baseUrl: config.baseUrl,
+                message: outcome.message,
+            });
+            return c.redirect(sentUrl(document), 303);
+        }
+        const refusal = outcome.refusal;
+        if (refusal.kind === 'discarded') {
+            // Nothing is said about why. A robot that filled the honeypot, or that a
+            // checker recognised, learns exactly as much from this as from a
+            // message that went — which is the point of both defences.
+            return c.redirect(sentUrl(document), 303);
+        }
+        if (refusal.kind === 'rate-limited') {
+            c.header('Retry-After', String(refusal.retryAfter));
+            return page(c, document, 429, {
+                ...refilledContactForm(document, contactValuesOf(form), {}, now),
+                error: 'That is a lot of messages in a short time. Try again in a few minutes.',
+            });
+        }
+        const message = refusal.kind === 'too-quick'
+            ? 'That was sent faster than anybody types. Try again.'
+            : refusal.kind === 'stale'
+                ? 'That form had been open a long time. Here it is again — the words are still there.'
+                : undefined;
+        return page(c, document, 400, {
+            ...refilledContactForm(document, contactValuesOf(form), problemsOf(refusal), now),
+            ...(message === undefined ? {} : { error: message }),
+        });
+    });
+}
+/** Where a sender is redirected once the message is stored. */
+function sentUrl(document) {
+    return `${document.permalink}?${CONTACT_NOTICE_PARAM}=sent#${CONTACT_ANCHOR}`;
+}
+/** The page itself, rendered again with this form on it. */
+function page(c, document, status, form) {
+    c.status(status);
+    return c.html(c.var.renderer.renderDocument(document, { contactForm: form }));
+}
+/** The per-field messages a refusal carries, if it carries any. */
+function problemsOf(refusal) {
+    return refusal.kind === 'invalid' ? (refusal.problems ?? {}) : {};
+}
+/** A submitted body as the form it is, every field a string. */
+function formOf(body) {
+    return {
+        page: text(body[CONTACT_FIELDS.page]),
+        name: text(body[CONTACT_FIELDS.name]),
+        email: text(body[CONTACT_FIELDS.email]),
+        subject: text(body[CONTACT_FIELDS.subject]),
+        message: text(body[CONTACT_FIELDS.message]),
+        trap: text(body[CONTACT_FIELDS.trap]),
+        loaded: text(body[CONTACT_FIELDS.loaded]),
+    };
+}
+/** A form field as a string. A file upload, or a missing field, is the empty one. */
+function text(value) {
+    return typeof value === 'string' ? value : '';
+}
+//# sourceMappingURL=routes.js.map

package/dist/contact/routes.js.map

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

package/dist/contact/submission.d.ts

@@ -0,0 +1,103 @@
+import type { CommentChecker } from '../comments/submission.ts';
+import type { Document } from '../content/document.ts';
+import type { ContactForm, ContactProblems } from './form.ts';
+import type { ContactMessage } from './records.ts';
+/**
+ * What happens between somebody pressing Send and a message existing.
+ *
+ * The same four defences a comment goes through, in the same order and out of
+ * the same modules, because a contact form is the same problem as a comment
+ * form wearing different fields:
+ *
+ * 1. **The honeypot**, first, because it costs one comparison and because a
+ *    submission that tripped it should not reach anything that could tell it
+ *    so.
+ * 2. **The age of the form** — too new to have been typed, or too old to be
+ *    the form it claims to be.
+ * 3. **The per-address rate limit**, the same limiter the login form and the
+ *    comment form use, so one machine cannot send a hundred messages while
+ *    nobody is looking.
+ * 4. **{@link CommentChecker}**, the one seam a third-party service plugs
+ *    into, told this is a `contact-form` rather than a comment.
+ *
+ * Then the file, and only then the mail. The order is the point: a message is
+ * on disk before anything is asked to deliver it, so a provider that is down
+ * costs a notification rather than the message.
+ */
+/** How many messages one address may send before it has to wait. */
+export declare const CONTACT_RATE_LIMIT = 5;
+/** How long that window is, and how long the first wait after it lasts. */
+export declare const CONTACT_RATE_WINDOW_SECONDS = 600;
+/** The part of the login throttle a contact form needs. */
+export interface ContactThrottle {
+    /** Seconds before this address may send again, or `undefined`. */
+    retryAfter(keys: readonly string[]): number | undefined;
+    /** Count one submission against it. */
+    fail(keys: readonly string[]): void;
+}
+/** The keys a submission is rate limited against. */
+export declare function contactKeys(address: string | undefined): string[];
+/** Why a submission did not become a message. */
+export type ContactRefusal = 
+/** The form said something a person can put right. */
+{
+    kind: 'invalid';
+    problems: ContactProblems;
+}
+/** The form was submitted faster than a person types. */
+ | {
+    kind: 'too-quick';
+}
+/** The form was rendered too long ago to still be one. */
+ | {
+    kind: 'stale';
+}
+/** This address has sent enough for now. `retryAfter` is in seconds. */
+ | {
+    kind: 'rate-limited';
+    retryAfter: number;
+}
+/** The honeypot was filled in, or a checker said to throw it away. */
+ | {
+    kind: 'discarded';
+};
+/** What became of a submission. */
+export type ContactOutcome = {
+    kind: 'stored';
+    message: ContactMessage;
+} | {
+    kind: 'refused';
+    refusal: ContactRefusal;
+};
+/** What {@link submitContactMessage} needs around it. */
+export interface SubmitContactMessageOptions {
+    /** Where `data/contact/` is, and where the address salt lives. */
+    dataDir: string;
+    /** The page the form was on. */
+    document: Document;
+    /** What was submitted. */
+    form: ContactForm;
+    /** The site's public origin, for the checker. */
+    baseUrl: string;
+    /** The checker, when the site has one. */
+    checker?: CommentChecker | undefined;
+    /** Where the request came from, as far as the site can tell. */
+    address?: string | undefined;
+    /** The `User-Agent` header, for the checker. */
+    userAgent?: string | undefined;
+    /** The `Referer` header, for the checker. */
+    referrer?: string | undefined;
+    /** The rate limiter, kept by the mount so it outlives one request. */
+    throttle: ContactThrottle;
+    /** The clock. */
+    now?: Date | undefined;
+}
+/**
+ * Take a submitted form and, if it survives everything, store the message.
+ *
+ * The caller has already decided that the page offers a form at all: whether
+ * one should exist is `contactOpen`'s question, and asking it here as well
+ * would let the two answers differ.
+ */
+export declare function submitContactMessage(options: SubmitContactMessageOptions): Promise<ContactOutcome>;
+//# sourceMappingURL=submission.d.ts.map

package/dist/contact/submission.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"submission.d.ts","sourceRoot":"","sources":["../../src/contact/submission.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAkB,MAAM,2BAA2B,CAAC;AAChF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAGvD,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAE9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,oEAAoE;AACpE,eAAO,MAAM,kBAAkB,IAAI,CAAC;AAEpC,2EAA2E;AAC3E,eAAO,MAAM,2BAA2B,MAAM,CAAC;AAE/C,2DAA2D;AAC3D,MAAM,WAAW,eAAe;IAC9B,kEAAkE;IAClE,UAAU,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,CAAC;IACxD,uCAAuC;IACvC,IAAI,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAC;CACrC;AAED,qDAAqD;AACrD,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,EAAE,CAEjE;AAED,iDAAiD;AACjD,MAAM,MAAM,cAAc;AACxB,sDAAsD;AACpD;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,EAAE,eAAe,CAAA;CAAE;AAChD,yDAAyD;GACvD;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE;AACvB,0DAA0D;GACxD;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE;AACnB,wEAAwE;GACtE;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE;AAC9C,sEAAsE;GACpE;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,CAAC;AAE1B,mCAAmC;AACnC,MAAM,MAAM,cAAc,GACxB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,cAAc,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,cAAc,CAAA;CAAE,CAAC;AAE7F,yDAAyD;AACzD,MAAM,WAAW,2BAA2B;IAC1C,kEAAkE;IAClE,OAAO,EAAE,MAAM,CAAC;IAChB,gCAAgC;IAChC,QAAQ,EAAE,QAAQ,CAAC;IACnB,0BAA0B;IAC1B,IAAI,EAAE,WAAW,CAAC;IAClB,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,0CAA0C;IAC1C,OAAO,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;IACrC,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,sEAAsE;IACtE,QAAQ,EAAE,eAAe,CAAC;IAC1B,iBAAiB;IACjB,GAAG,CAAC,EAAE,IAAI,GAAG,SAAS,CAAC;CACxB;AAED;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,cAAc,CAAC,CAkDzB"}

package/dist/contact/submission.js

@@ -0,0 +1,166 @@
+import { formTimingRefusal, hashClientAddress, trapped } from '../forms/protection.js';
+import { contactProblems } from './form.js';
+import { addContactMessage } from './records.js';
+/**
+ * What happens between somebody pressing Send and a message existing.
+ *
+ * The same four defences a comment goes through, in the same order and out of
+ * the same modules, because a contact form is the same problem as a comment
+ * form wearing different fields:
+ *
+ * 1. **The honeypot**, first, because it costs one comparison and because a
+ *    submission that tripped it should not reach anything that could tell it
+ *    so.
+ * 2. **The age of the form** — too new to have been typed, or too old to be
+ *    the form it claims to be.
+ * 3. **The per-address rate limit**, the same limiter the login form and the
+ *    comment form use, so one machine cannot send a hundred messages while
+ *    nobody is looking.
+ * 4. **{@link CommentChecker}**, the one seam a third-party service plugs
+ *    into, told this is a `contact-form` rather than a comment.
+ *
+ * Then the file, and only then the mail. The order is the point: a message is
+ * on disk before anything is asked to deliver it, so a provider that is down
+ * costs a notification rather than the message.
+ */
+/** How many messages one address may send before it has to wait. */
+export const CONTACT_RATE_LIMIT = 5;
+/** How long that window is, and how long the first wait after it lasts. */
+export const CONTACT_RATE_WINDOW_SECONDS = 600;
+/** The keys a submission is rate limited against. */
+export function contactKeys(address) {
+    return address === undefined ? [] : [`contact:${address}`];
+}
+/**
+ * Take a submitted form and, if it survives everything, store the message.
+ *
+ * The caller has already decided that the page offers a form at all: whether
+ * one should exist is `contactOpen`'s question, and asking it here as well
+ * would let the two answers differ.
+ */
+export async function submitContactMessage(options) {
+    const { form, throttle } = options;
+    const now = options.now ?? new Date();
+    // The honeypot first, because a submission that tripped it should not reach
+    // anything that could tell it why.
+    if (trapped(form.trap))
+        return refused({ kind: 'discarded' });
+    const problems = contactProblems(form);
+    if (Object.keys(problems).length > 0)
+        return refused({ kind: 'invalid', problems });
+    const timing = formTimingRefusal(form.loaded, now);
+    if (timing !== undefined)
+        return refused({ kind: timing });
+    const keys = contactKeys(options.address);
+    const wait = throttle.retryAfter(keys);
+    if (wait !== undefined)
+        return refused({ kind: 'rate-limited', retryAfter: wait });
+    const proposed = {
+        received: now.toISOString(),
+        status: 'received',
+        page: {
+            slug: options.document.slug,
+            permalink: options.document.permalink,
+            title: options.document.title,
+        },
+        from: { name: form.name.trim(), email: form.email.trim() },
+        subject: form.subject.trim(),
+        message: form.message.trim(),
+        addressHash: hashClientAddress(options.dataDir, options.address),
+    };
+    const verdict = await ask(options, proposed, now);
+    if (verdict === 'discard') {
+        // Counted against the address even so: a machine sending rubbish should
+        // not get unlimited free attempts because the rubbish was recognised.
+        throttle.fail(keys);
+        return refused({ kind: 'discarded' });
+    }
+    // A message a checker called spam is stored all the same, on a list of its
+    // own. A false positive on a contact form is somebody's message vanishing,
+    // which is a worse failure than a spam list to glance at.
+    const message = await addContactMessage(options.dataDir, {
+        ...proposed,
+        status: verdict === 'spam' ? 'spam' : 'received',
+    });
+    throttle.fail(keys);
+    return { kind: 'stored', message };
+}
+/** Ask the checker, if there is one, and treat a broken one as no opinion. */
+async function ask(options, proposed, now) {
+    const checker = options.checker;
+    if (checker === undefined)
+        return 'unknown';
+    try {
+        return await checker.check({
+            // The seam takes a comment, and a contact message is not one — so it is
+            // described as the comment it most nearly is, and `type` says what it
+            // actually is. Akismet sends that as `comment_type: contact-form`, which
+            // is a value it documents; a site's own checker can read it or ignore it.
+            type: 'contact-form',
+            comment: asComment(proposed, now),
+            post: {
+                slug: options.document.slug,
+                title: options.document.title,
+                url: absolute(options.document.permalink, options.baseUrl),
+            },
+            address: options.address,
+            userAgent: options.userAgent,
+            referrer: options.referrer,
+            baseUrl: options.baseUrl,
+        });
+    }
+    catch (error) {
+        // A checker that is down must not stop a site taking messages; the message
+        // is stored exactly as it would have been before anybody had a checker.
+        console.warn(`The comment checker refused to answer about a message: ${messageOf(error)}`);
+        return 'unknown';
+    }
+}
+/**
+ * A proposed message in the shape the checker seam speaks.
+ *
+ * The subject is put in front of the message rather than dropped, because it
+ * is text a person wrote and a spam service should see it; the address is
+ * `null` here because the record keeps a salted hash and the seam is handed
+ * the real one separately.
+ */
+function asComment(proposed, now) {
+    const content = proposed.subject === '' ? proposed.message : `${proposed.subject}\n\n${proposed.message}`;
+    return {
+        slug: proposed.page.slug,
+        permalink: proposed.page.permalink,
+        source: 'comment',
+        kind: 'reply',
+        status: 'pending',
+        author: {
+            name: proposed.from.name,
+            url: null,
+            email: proposed.from.email,
+            avatar: null,
+        },
+        // Plain text, and plain text is its own HTML for a checker's purposes:
+        // nothing here is ever rendered onto a page.
+        content: { markdown: content, html: content },
+        submitted: now.toISOString(),
+        addressHash: proposed.addressHash,
+        inReplyTo: null,
+        url: null,
+        notify: false,
+    };
+}
+/** A site-root path as an absolute URL. */
+function absolute(pathname, baseUrl) {
+    try {
+        return new URL(pathname, baseUrl).href;
+    }
+    catch {
+        return pathname;
+    }
+}
+function refused(refusal) {
+    return { kind: 'refused', refusal };
+}
+function messageOf(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=submission.js.map

package/dist/contact/submission.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"submission.js","sourceRoot":"","sources":["../../src/contact/submission.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACvF,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAE5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAGjD;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,oEAAoE;AACpE,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC;AAEpC,2EAA2E;AAC3E,MAAM,CAAC,MAAM,2BAA2B,GAAG,GAAG,CAAC;AAU/C,qDAAqD;AACrD,MAAM,UAAU,WAAW,CAAC,OAA2B;IACrD,OAAO,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,WAAW,OAAO,EAAE,CAAC,CAAC;AAC7D,CAAC;AA2CD;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,OAAoC;IAEpC,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;IACnC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC;IAEtC,4EAA4E;IAC5E,mCAAmC;IACnC,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,OAAO,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;IAE9D,MAAM,QAAQ,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IACvC,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,OAAO,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAC;IAEpF,MAAM,MAAM,GAAG,iBAAiB,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACnD,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IAE3D,MAAM,IAAI,GAAG,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1C,MAAM,IAAI,GAAG,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IACvC,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,OAAO,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;IAEnF,MAAM,QAAQ,GAAG;QACf,QAAQ,EAAE,GAAG,CAAC,WAAW,EAAE;QAC3B,MAAM,EAAE,UAAmB;QAC3B,IAAI,EAAE;YACJ,IAAI,EAAE,OAAO,CAAC,QAAQ,CAAC,IAAI;YAC3B,SAAS,EAAE,OAAO,CAAC,QAAQ,CAAC,SAAS;YACrC,KAAK,EAAE,OAAO,CAAC,QAAQ,CAAC,KAAK;SAC9B;QACD,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE;QAC1D,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE;QAC5B,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE;QAC5B,WAAW,EAAE,iBAAiB,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC;KACjE,CAAC;IAEF,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC;IAClD,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,wEAAwE;QACxE,sEAAsE;QACtE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpB,OAAO,OAAO,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;IACxC,CAAC;IAED,2EAA2E;IAC3E,2EAA2E;IAC3E,0DAA0D;IAC1D,MAAM,OAAO,GAAG,MAAM,iBAAiB,CAAC,OAAO,CAAC,OAAO,EAAE;QACvD,GAAG,QAAQ;QACX,MAAM,EAAE,OAAO,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU;KACjD,CAAC,CAAC;IAEH,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpB,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;AACrC,CAAC;AAED,8EAA8E;AAC9E,KAAK,UAAU,GAAG,CAChB,OAAoC,EACpC,QAA6C,EAC7C,GAAS;IAET,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAChC,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAE5C,IAAI,CAAC;QACH,OAAO,MAAM,OAAO,CAAC,KAAK,CAAC;YACzB,wEAAwE;YACxE,sEAAsE;YACtE,yEAAyE;YACzE,0EAA0E;YAC1E,IAAI,EAAE,cAAc;YACpB,OAAO,EAAE,SAAS,CAAC,QAAQ,EAAE,GAAG,CAAC;YACjC,IAAI,EAAE;gBACJ,IAAI,EAAE,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAC3B,KAAK,EAAE,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAC7B,GAAG,EAAE,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,OAAO,CAAC;aAC3D;YACD,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,OAAO,EAAE,OAAO,CAAC,OAAO;SACzB,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,2EAA2E;QAC3E,wEAAwE;QACxE,OAAO,CAAC,IAAI,CAAC,0DAA0D,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC3F,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,SAAS,CAChB,QAA6C,EAC7C,GAAS;IAET,MAAM,OAAO,GACX,QAAQ,CAAC,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,OAAO,OAAO,QAAQ,CAAC,OAAO,EAAE,CAAC;IAE5F,OAAO;QACL,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,IAAI;QACxB,SAAS,EAAE,QAAQ,CAAC,IAAI,CAAC,SAAS;QAClC,MAAM,EAAE,SAAS;QACjB,IAAI,EAAE,OAAO;QACb,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,IAAI;YACxB,GAAG,EAAE,IAAI;YACT,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC,KAAK;YAC1B,MAAM,EAAE,IAAI;SACb;QACD,uEAAuE;QACvE,6CAA6C;QAC7C,OAAO,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE;QAC7C,SAAS,EAAE,GAAG,CAAC,WAAW,EAAE;QAC5B,WAAW,EAAE,QAAQ,CAAC,WAAW;QACjC,SAAS,EAAE,IAAI;QACf,GAAG,EAAE,IAAI;QACT,MAAM,EAAE,KAAK;KACd,CAAC;AACJ,CAAC;AAED,2CAA2C;AAC3C,SAAS,QAAQ,CAAC,QAAgB,EAAE,OAAe;IACjD,IAAI,CAAC;QACH,OAAO,IAAI,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,QAAQ,CAAC;IAClB,CAAC;AACH,CAAC;AAED,SAAS,OAAO,CAAC,OAAuB;IACtC,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC;AACtC,CAAC;AAED,SAAS,SAAS,CAAC,KAAc;IAC/B,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAChE,CAAC"}

package/dist/content/document.d.ts

@@ -38,6 +38,11 @@ export interface Document {
     updated?: string | undefined;
     /** Taxonomy. The `post` tag comes from `posts.json`, not from the file. */
     tags: string[];
+    /**
+     * The second taxonomy: what the document is filed under, as WordPress files
+     * a post under a category. Eleventy reads it as an ordinary data key.
+     */
+    categories: string[];
     /** `true` hides the document from the public site and the feeds. */
     draft: boolean;
     /** Meta description and excerpt fallback. */
@@ -60,7 +65,7 @@ export interface Document {
     hash: string;
 }
 /** The part of a {@link Document} that a file is written from. */
-export type DocumentContent = Pick<Document, 'title' | 'date' | 'updated' | 'permalink' | 'tags' | 'draft' | 'description' | 'author' | 'activitypub' | 'extra' | 'body'>;
+export type DocumentContent = Pick<Document, 'title' | 'date' | 'updated' | 'permalink' | 'tags' | 'categories' | 'draft' | 'description' | 'author' | 'activitypub' | 'extra' | 'body'>;
 /** Front-matter keys the CMS models. Everything else lands in `extra`. */
-export declare const KNOWN_FRONT_MATTER_KEYS: readonly ['title', 'date', 'updated', 'permalink', 'tags', 'draft', 'description', 'author', 'activitypub'];
+export declare const KNOWN_FRONT_MATTER_KEYS: readonly ['title', 'date', 'updated', 'permalink', 'tags', 'categories', 'draft', 'description', 'author', 'activitypub'];
 //# sourceMappingURL=document.d.ts.map

package/dist/content/document.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"document.d.ts","sourceRoot":"","sources":["../../src/content/document.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,CAAC;AAE3C;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,qCAAqC;IACrC,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxB,qDAAqD;IACrD,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAChC;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,QAAQ;IACvB,yDAAyD;IACzD,IAAI,EAAE,YAAY,CAAC;IACnB,mEAAmE;IACnE,IAAI,EAAE,MAAM,CAAC;IACb,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAC;IACb,8EAA8E;IAC9E,SAAS,EAAE,MAAM,CAAC;IAClB,qBAAqB;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,8DAA8D;IAC9D,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,iEAAiE;IACjE,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,2EAA2E;IAC3E,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,oEAAoE;IACpE,KAAK,EAAE,OAAO,CAAC;IACf,6CAA6C;IAC7C,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,6DAA6D;IAC7D,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,yEAAyE;IACzE,WAAW,CAAC,EAAE,mBAAmB,GAAG,SAAS,CAAC;IAC9C,oEAAoE;IACpE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,IAAI,EAAE,MAAM,CAAC;CACd;AAED,kEAAkE;AAClE,MAAM,MAAM,eAAe,GAAG,IAAI,CAChC,QAAQ,EACN,OAAO,GACP,MAAM,GACN,SAAS,GACT,WAAW,GACX,MAAM,GACN,OAAO,GACP,aAAa,GACb,QAAQ,GACR,aAAa,GACb,OAAO,GACP,MAAM,CACT,CAAC;AAEF,0EAA0E;AAC1E,eAAO,MAAM,uBAAuB,YAClC,OAAO,EACP,MAAM,EACN,SAAS,EACT,WAAW,EACX,MAAM,EACN,OAAO,EACP,aAAa,EACb,QAAQ,EACR,aAAa,CACL,CAAC"}
+{"version":3,"file":"document.d.ts","sourceRoot":"","sources":["../../src/content/document.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,CAAC;AAE3C;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,qCAAqC;IACrC,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxB,qDAAqD;IACrD,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAChC;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,QAAQ;IACvB,yDAAyD;IACzD,IAAI,EAAE,YAAY,CAAC;IACnB,mEAAmE;IACnE,IAAI,EAAE,MAAM,CAAC;IACb,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAC;IACb,8EAA8E;IAC9E,SAAS,EAAE,MAAM,CAAC;IAClB,qBAAqB;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,8DAA8D;IAC9D,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,iEAAiE;IACjE,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,2EAA2E;IAC3E,IAAI,EAAE,MAAM,EAAE,CAAC;IACf;;;OAGG;IACH,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,oEAAoE;IACpE,KAAK,EAAE,OAAO,CAAC;IACf,6CAA6C;IAC7C,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,6DAA6D;IAC7D,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,yEAAyE;IACzE,WAAW,CAAC,EAAE,mBAAmB,GAAG,SAAS,CAAC;IAC9C,oEAAoE;IACpE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,IAAI,EAAE,MAAM,CAAC;CACd;AAED,kEAAkE;AAClE,MAAM,MAAM,eAAe,GAAG,IAAI,CAChC,QAAQ,EACN,OAAO,GACP,MAAM,GACN,SAAS,GACT,WAAW,GACX,MAAM,GACN,YAAY,GACZ,OAAO,GACP,aAAa,GACb,QAAQ,GACR,aAAa,GACb,OAAO,GACP,MAAM,CACT,CAAC;AAEF,0EAA0E;AAC1E,eAAO,MAAM,uBAAuB,YAClC,OAAO,EACP,MAAM,EACN,SAAS,EACT,WAAW,EACX,MAAM,EACN,YAAY,EACZ,OAAO,EACP,aAAa,EACb,QAAQ,EACR,aAAa,CACL,CAAC"}

package/dist/content/document.js

@@ -5,6 +5,7 @@ export const KNOWN_FRONT_MATTER_KEYS = [
     'updated',
     'permalink',
     'tags',
+    'categories',
     'draft',
     'description',
     'author',

package/dist/content/document.js.map

@@ -1 +1 @@
-{"version":3,"file":"document.js","sourceRoot":"","sources":["../../src/content/document.ts"],"names":[],"mappings":"AAgFA,0EAA0E;AAC1E,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,OAAO;IACP,MAAM;IACN,SAAS;IACT,WAAW;IACX,MAAM;IACN,OAAO;IACP,aAAa;IACb,QAAQ;IACR,aAAa;CACL,CAAC"}
+{"version":3,"file":"document.js","sourceRoot":"","sources":["../../src/content/document.ts"],"names":[],"mappings":"AAsFA,0EAA0E;AAC1E,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,OAAO;IACP,MAAM;IACN,SAAS;IACT,WAAW;IACX,MAAM;IACN,YAAY;IACZ,OAAO;IACP,aAAa;IACb,QAAQ;IACR,aAAa;CACL,CAAC"}

package/dist/content/index.d.ts

@@ -7,11 +7,16 @@ export { hashDocument, parseDocument, typeForPath } from './parser.ts';
 export type { ParseDocumentOptions } from './parser.ts';
 export { contentFilePath, freeSlug, saveDocument } from './save.ts';
 export type { ContentFilePathInput, FreeSlugOptions, SaveDocumentOptions } from './save.ts';
+export { htmlToText, MAXIMUM_QUERY_TERMS, searchExpression, searchText, SNIPPET_CLOSE, SNIPPET_OPEN, } from './search.ts';
+export type { SearchText } from './search.ts';
 export { defaultPermalink, slugify } from './slug.ts';
 export type { DefaultPermalinkInput } from './slug.ts';
 export { documentContent, documentFrontMatter, normalizeBody, serializeDocument, } from './writer.ts';
-export { DATABASE_FILE, dateSortKey, DuplicatePermalinkError, isTrashedPath, openContentStore, TRASH_DIRECTORY, } from './store.ts';
-export type { ContentCounts, ContentStore, ListAllOptions, ListByTagOptions, ListOptions, OpenContentStoreOptions, TagCount, } from './store.ts';
+export { createScheduler, isScheduled, MAXIMUM_DELAY_MS, SCHEDULE_ORIGIN, scheduledFor, systemTimers, } from './schedule.ts';
+export type { CreateSchedulerOptions, ScheduleLogger, Scheduler, ScheduleTimers, ScheduleWatermark, } from './schedule.ts';
+export { DATABASE_FILE, dateSortKey, DuplicatePermalinkError, isTrashedPath, openContentStore, systemClock, TRASH_DIRECTORY, } from './store.ts';
+export type { CategoryCount, Clock, ContentCounts, ContentStore, ListAllOptions, ListByTagOptions, ListOptions, OpenContentStoreOptions, SearchHit, TagCount, } from './store.ts';
+export { calendarDayIn, DEFAULT_TIMEZONE, toUtcInstant, wallClockIn, zoneLabel } from './time.ts';
 export { createContentSync, DEFAULT_DEBOUNCE_MS } from './sync.ts';
 export type { ChangeOrigin, ContentEventListener, ContentEventMap, ContentEvents, ContentSync, CreateContentSyncOptions, DocumentChange, DocumentChangeType, SyncLogger, SyncResult, } from './sync.ts';
 //# sourceMappingURL=index.d.ts.map

package/dist/content/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/content/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AACxD,YAAY,EAAE,mBAAmB,EAAE,QAAQ,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClG,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACvE,YAAY,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACpE,YAAY,EAAE,oBAAoB,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAC5F,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACtD,YAAY,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AACvD,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,aAAa,EACb,iBAAiB,GAClB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,aAAa,EACb,WAAW,EACX,uBAAuB,EACvB,aAAa,EACb,gBAAgB,EAChB,eAAe,GAChB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,aAAa,EACb,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,WAAW,EACX,uBAAuB,EACvB,QAAQ,GACT,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AACnE,YAAY,EACV,YAAY,EACZ,oBAAoB,EACpB,eAAe,EACf,aAAa,EACb,WAAW,EACX,wBAAwB,EACxB,cAAc,EACd,kBAAkB,EAClB,UAAU,EACV,UAAU,GACX,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/content/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AACxD,YAAY,EAAE,mBAAmB,EAAE,QAAQ,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClG,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACvE,YAAY,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACpE,YAAY,EAAE,oBAAoB,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAC5F,OAAO,EACL,UAAU,EACV,mBAAmB,EACnB,gBAAgB,EAChB,UAAU,EACV,aAAa,EACb,YAAY,GACb,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACtD,YAAY,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AACvD,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,aAAa,EACb,iBAAiB,GAClB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,eAAe,EACf,WAAW,EACX,gBAAgB,EAChB,eAAe,EACf,YAAY,EACZ,YAAY,GACb,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,sBAAsB,EACtB,cAAc,EACd,SAAS,EACT,cAAc,EACd,iBAAiB,GAClB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,aAAa,EACb,WAAW,EACX,uBAAuB,EACvB,aAAa,EACb,gBAAgB,EAChB,WAAW,EACX,eAAe,GAChB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,aAAa,EACb,KAAK,EACL,aAAa,EACb,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,WAAW,EACX,uBAAuB,EACvB,SAAS,EACT,QAAQ,GACT,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAClG,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AACnE,YAAY,EACV,YAAY,EACZ,oBAAoB,EACpB,eAAe,EACf,aAAa,EACb,WAAW,EACX,wBAAwB,EACxB,cAAc,EACd,kBAAkB,EAClB,UAAU,EACV,UAAU,GACX,MAAM,WAAW,CAAC"}

package/dist/content/index.js

@@ -3,8 +3,11 @@ export { renderMarkdown } from './markdown.js';
 export { KNOWN_UPLOAD_TYPES, matchesSignature, normalizeUploadType, UPLOAD_MEDIA_TYPES, } from './media.js';
 export { hashDocument, parseDocument, typeForPath } from './parser.js';
 export { contentFilePath, freeSlug, saveDocument } from './save.js';
+export { htmlToText, MAXIMUM_QUERY_TERMS, searchExpression, searchText, SNIPPET_CLOSE, SNIPPET_OPEN, } from './search.js';
 export { defaultPermalink, slugify } from './slug.js';
 export { documentContent, documentFrontMatter, normalizeBody, serializeDocument, } from './writer.js';
-export { DATABASE_FILE, dateSortKey, DuplicatePermalinkError, isTrashedPath, openContentStore, TRASH_DIRECTORY, } from './store.js';
+export { createScheduler, isScheduled, MAXIMUM_DELAY_MS, SCHEDULE_ORIGIN, scheduledFor, systemTimers, } from './schedule.js';
+export { DATABASE_FILE, dateSortKey, DuplicatePermalinkError, isTrashedPath, openContentStore, systemClock, TRASH_DIRECTORY, } from './store.js';
+export { calendarDayIn, DEFAULT_TIMEZONE, toUtcInstant, wallClockIn, zoneLabel } from './time.js';
 export { createContentSync, DEFAULT_DEBOUNCE_MS } from './sync.js';
 //# sourceMappingURL=index.js.map

package/dist/content/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/content/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAExD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAEvE,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEpE,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEtD,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,aAAa,EACb,iBAAiB,GAClB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,aAAa,EACb,WAAW,EACX,uBAAuB,EACvB,aAAa,EACb,gBAAgB,EAChB,eAAe,GAChB,MAAM,YAAY,CAAC;AAUpB,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/content/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAExD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAEvE,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEpE,OAAO,EACL,UAAU,EACV,mBAAmB,EACnB,gBAAgB,EAChB,UAAU,EACV,aAAa,EACb,YAAY,GACb,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEtD,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,aAAa,EACb,iBAAiB,GAClB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,eAAe,EACf,WAAW,EACX,gBAAgB,EAChB,eAAe,EACf,YAAY,EACZ,YAAY,GACb,MAAM,eAAe,CAAC;AAQvB,OAAO,EACL,aAAa,EACb,WAAW,EACX,uBAAuB,EACvB,aAAa,EACb,gBAAgB,EAChB,WAAW,EACX,eAAe,GAChB,MAAM,YAAY,CAAC;AAapB,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAClG,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC"}

package/dist/content/markdown.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../src/content/markdown.ts"],"names":[],"mappings":"AAeA,uEAAuE;AACvE,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD"}
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../src/content/markdown.ts"],"names":[],"mappings":"AAiBA,uEAAuE;AACvE,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD"}

package/dist/content/markdown.js

@@ -4,15 +4,37 @@ import { slugify } from './slug.js';
 /**
  * The renderer: markdown-it with Eleventy's default option (`html: true`),
  * plus footnotes and heading anchors. Code blocks get a language class and no
- * highlighting, so a theme can pick its own highlighter on the client.
+ * highlighting and a `tabindex` on the `<pre>`, so a theme can pick its own
+ * highlighter on the client and a wide block scrolls by keyboard.
  */
 const markdown = new MarkdownIt({ html: true })
     .use(footnote)
-    .use(headingAnchors);
+    .use(headingAnchors)
+    .use(focusableCodeBlocks);
 /** Render a Markdown body to the HTML the site and the feeds serve. */
 export function renderMarkdown(body) {
     return markdown.render(body);
 }
+/**
+ * Put `tabindex="0"` on every `<pre>`, so a block of code wider than the
+ * measure can be scrolled from the keyboard.
+ *
+ * A `<pre>` scrolls sideways rather than wrapping, and a scroll container that
+ * nothing can focus is unreachable without a pointer — WCAG 2.2's keyboard
+ * criterion, and the reason the Eleventy site this design comes from passed
+ * `preAttributes: { tabindex: 0 }` to its highlighter. There is no highlighter
+ * here (a theme highlights on the client), so the renderer does it.
+ *
+ * Both block rules are wrapped: `fence` for a ``` block and `code_block` for an
+ * indented one.
+ */
+function focusableCodeBlocks(md) {
+    for (const rule of ['fence', 'code_block']) {
+        const original = md.renderer.rules[rule]?.bind(md.renderer.rules);
+        const render = original ?? md.renderer.renderToken.bind(md.renderer);
+        md.renderer.rules[rule] = (tokens, index, options, env, self) => render(tokens, index, options, env, self).replace('<pre>', '<pre tabindex="0">');
+    }
+}
 /**
  * Give every heading an `id` so a URL can point at it. Ids come from the same
  * slugifier as permalinks, and repeat headings get a numeric suffix so the ids

package/dist/content/markdown.js.map

@@ -1 +1 @@
-{"version":3,"file":"markdown.js","sourceRoot":"","sources":["../../src/content/markdown.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,MAAM,aAAa,CAAC;AAErC,OAAO,QAAQ,MAAM,sBAAsB,CAAC;AAE5C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC;;;;GAIG;AACH,MAAM,QAAQ,GAAuB,IAAI,UAAU,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;KAChE,GAAG,CAAC,QAAQ,CAAC;KACb,GAAG,CAAC,cAAc,CAAC,CAAC;AAEvB,uEAAuE;AACvE,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AAC/B,CAAC;AAED;;;;GAIG;AACH,SAAS,cAAc,CAAC,EAAsB;IAC5C,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,yBAAyB,EAAE,CAAC,KAAK,EAAE,EAAE;QACtD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAkB,CAAC;QACvC,IAAI,KAAK,GAAG,CAAC,CAAC;QAEd,KAAK,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC;YACvD,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc;gBAAE,SAAS;YAC5C,KAAK,IAAI,CAAC,CAAC;YAEX,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC;YAC1C,MAAM,IAAI,GAAG,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;YACxD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,WAAW,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAE/E,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACjC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,GAAG,CAAC,CAAC,CAAC;YACzB,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,MAAM,CAAC,IAAI,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;QACzE,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"markdown.js","sourceRoot":"","sources":["../../src/content/markdown.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,MAAM,aAAa,CAAC;AAErC,OAAO,QAAQ,MAAM,sBAAsB,CAAC;AAE5C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC;;;;;GAKG;AACH,MAAM,QAAQ,GAAuB,IAAI,UAAU,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;KAChE,GAAG,CAAC,QAAQ,CAAC;KACb,GAAG,CAAC,cAAc,CAAC;KACnB,GAAG,CAAC,mBAAmB,CAAC,CAAC;AAE5B,uEAAuE;AACvE,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AAC/B,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,SAAS,mBAAmB,CAAC,EAAsB;IACjD,KAAK,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE,YAAY,CAAU,EAAE,CAAC;QACpD,MAAM,QAAQ,GAAG,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAClE,MAAM,MAAM,GAAG,QAAQ,IAAI,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC;QAErE,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,CAC9D,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,oBAAoB,CAAC,CAAC;IACrF,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,SAAS,cAAc,CAAC,EAAsB;IAC5C,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,yBAAyB,EAAE,CAAC,KAAK,EAAE,EAAE;QACtD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAkB,CAAC;QACvC,IAAI,KAAK,GAAG,CAAC,CAAC;QAEd,KAAK,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC;YACvD,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc;gBAAE,SAAS;YAC5C,KAAK,IAAI,CAAC,CAAC;YAEX,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC;YAC1C,MAAM,IAAI,GAAG,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;YACxD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,WAAW,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAE/E,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACjC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,GAAG,CAAC,CAAC,CAAC;YACzB,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,MAAM,CAAC,IAAI,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;QACzE,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/content/parser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/content/parser.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAuB,QAAQ,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAOlG,wEAAwE;AACxE,MAAM,WAAW,oBAAoB;IACnC,gFAAgF;IAChF,IAAI,EAAE,MAAM,CAAC;IACb,6EAA6E;IAC7E,IAAI,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;CACjC;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,oBAAoB,GAAG,QAAQ,CAgDrF;AAED,iFAAiF;AACjF,wBAAgB,YAAY,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CAE7D;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAQtD"}
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/content/parser.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAuB,QAAQ,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAOlG,wEAAwE;AACxE,MAAM,WAAW,oBAAoB;IACnC,gFAAgF;IAChF,IAAI,EAAE,MAAM,CAAC;IACb,6EAA6E;IAC7E,IAAI,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;CACjC;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,oBAAoB,GAAG,QAAQ,CAiDrF;AAED,iFAAiF;AACjF,wBAAgB,YAAY,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CAE7D;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAQtD"}

package/dist/content/parser.js

@@ -35,7 +35,8 @@ export function parseDocument(source, options) {
     const content = {
         title,
         permalink,
-        tags: asTags(data['tags']),
+        tags: asTerms(data['tags']),
+        categories: asTerms(data['categories']),
         draft: data['draft'] === true,
         extra: extraOf(data),
         body,
@@ -139,15 +140,21 @@ function asDate(value, key, path) {
     }
     return text;
 }
-/** Eleventy accepts one tag as a bare string; the CMS always keeps a list. */
-function asTags(value) {
+/**
+ * One taxonomy's terms: `tags` or `categories`.
+ *
+ * Eleventy accepts one tag as a bare string, so both keys do; the CMS always
+ * keeps a list, and both taxonomies are read the same way so a category
+ * behaves exactly as a tag does.
+ */
+function asTerms(value) {
     if (value === undefined || value === null)
         return [];
     if (typeof value === 'string')
         return value === '' ? [] : [value];
     if (!Array.isArray(value))
         return [];
-    return value.filter((tag) => typeof tag === 'string' && tag !== '');
+    return value.filter((term) => typeof term === 'string' && term !== '');
 }
 function asActivityPub(value, path) {
     if (value === undefined || value === null)