@geekity/cms 0.3.0 → 0.5.0

package/dist/web/taxonomy.js

@@ -0,0 +1,237 @@
+/**
+ * Where the taxonomy archives live, and how their URLs are spelled.
+ *
+ * The bases are a setting rather than a constant: a site moving off WordPress
+ * keeps `/tag/` and `/category/`, and a site that spells them otherwise says
+ * so on the settings screen. Everything that builds or parses one of those
+ * URLs — the public routes, the canonical redirects, the feeds, the theme, the
+ * ActivityStreams hashtags — goes through this module, so they cannot
+ * disagree about where an archive is.
+ */
+/** Where a paginated listing's later pages live, under any listing root. */
+export const PAGE_SEGMENT = 'page';
+/** Both taxonomies, in the order a screen or a loop should take them. */
+export const TAXONOMIES = ['tag', 'category'];
+/**
+ * The bases a site has before anybody says otherwise: WordPress's own, so a
+ * site imported from it keeps every archive URL it had published.
+ */
+export const DEFAULT_TAXONOMY_BASES = {
+    tag: 'tag',
+    category: 'category',
+};
+/** The word each taxonomy is called on a screen. */
+export const TAXONOMY_LABELS = {
+    tag: 'tag',
+    category: 'category',
+};
+/**
+ * What a base may be made of: one path segment, starting with a letter or a
+ * digit, of at most 64 characters.
+ *
+ * Deliberately narrower than what a URL would carry. A base is the first
+ * segment of every archive URL the site publishes and the thing the router
+ * matches on, so it holds nothing that would need percent-encoding, nothing
+ * that could be read as a file extension, and no slash that would make it two
+ * segments.
+ */
+export const TAXONOMY_BASE_PATTERN = /^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$/;
+/**
+ * Top-level paths the site already answers on, which a base may not take over.
+ *
+ * `feed` was here before anything served it: TASK-37 put the feeds at `/feed/`,
+ * and a site that had taken the word would find its archives shadowed by an
+ * upgrade. `comments` is the site-wide comments feed's root, for the same
+ * reason. `taxonomy.test.ts` pins this list against the prefixes those routes
+ * are actually registered under, so it cannot fall behind them.
+ *
+ * `sitemap.xml` and `robots.txt` are here because they are paths the site
+ * answers on, which is what the list is: {@link TAXONOMY_BASE_PATTERN} would
+ * refuse either of them anyway for the dot, so the entries are belt and
+ * braces rather than the only thing standing in the way.
+ *
+ * `author` and `inbox` are reserved harder than the rest (decision-14). Every
+ * user is an actor at `/author/{username}/` and the shared inbox is `/inbox/`,
+ * and an actor id is a name a follower's server has filed the account under:
+ * a base that took one of those words would not shadow an archive, it would
+ * unmake an account. `web/authors.ts` spells them as `AUTHOR_BASE` and
+ * `INBOX_BASE`, and `taxonomy.test.ts` holds this list against those two
+ * constants, so the reservation and the URLs cannot drift apart; they are
+ * literals here only because that module reads {@link PAGE_SEGMENT} from this
+ * one, and a cycle between two files of constants is not worth the tidiness.
+ */
+export const RESERVED_TOP_LEVEL_PATHS = [
+    PAGE_SEGMENT,
+    'feed',
+    'comments',
+    'admin',
+    'theme',
+    'uploads',
+    'nodeinfo',
+    'author',
+    'inbox',
+    'sitemap.xml',
+    'robots.txt',
+    'search',
+];
+/**
+ * The URL of a page of either taxonomy's archive, by zero-based index.
+ *
+ * This is the one place a taxonomy archive URL is spelled, so the routes, the
+ * pager, the canonical redirect, the theme links and the ActivityStreams
+ * hashtags cannot disagree about where an archive lives.
+ */
+export function termHref(term, index, bases) {
+    const root = `/${bases[term.taxonomy]}/${encodeURIComponent(term.term)}/`;
+    return index === 0 ? root : `${root}${PAGE_SEGMENT}/${String(index + 1)}/`;
+}
+/** The URL of a page of a tag archive, by zero-based index. */
+export function tagHref(tag, index, bases) {
+    return termHref({ taxonomy: 'tag', term: tag }, index, bases);
+}
+/** The URL of a page of a category archive, by zero-based index. */
+export function categoryHref(category, index, bases) {
+    return termHref({ taxonomy: 'category', term: category }, index, bases);
+}
+/** The taxonomy a first URL segment names, or `undefined` when it names none. */
+export function taxonomyForSegment(segment, bases) {
+    if (segment === undefined)
+        return undefined;
+    for (const taxonomy of TAXONOMIES) {
+        if (bases[taxonomy] === segment)
+            return taxonomy;
+    }
+    return undefined;
+}
+/**
+ * What is wrong with a pair of bases, one message per taxonomy.
+ *
+ * The pair is checked together rather than one at a time because two of the
+ * rules are about the pair: they may not be the same word, and neither may be
+ * a path the site already answers on.
+ */
+export function taxonomyBaseProblems(bases) {
+    const problems = {};
+    for (const taxonomy of TAXONOMIES) {
+        const value = bases[taxonomy].trim();
+        const label = TAXONOMY_LABELS[taxonomy];
+        if (value === '') {
+            problems[taxonomy] = `The ${label} base cannot be empty.`;
+        }
+        else if (!TAXONOMY_BASE_PATTERN.test(value)) {
+            problems[taxonomy] =
+                `A ${label} base is one path segment: up to 64 letters, digits, dashes or ` +
+                    'underscores, starting with a letter or a digit, and no slash.';
+        }
+        else if (RESERVED_TOP_LEVEL_PATHS.includes(value.toLowerCase())) {
+            problems[taxonomy] =
+                `“${value}” is already a path this site answers on. Reserved: ` +
+                    `${RESERVED_TOP_LEVEL_PATHS.join(', ')}.`;
+        }
+    }
+    if (problems.tag === undefined &&
+        problems.category === undefined &&
+        bases.tag.trim() === bases.category.trim()) {
+        const message = 'The tag base and the category base have to be different words.';
+        problems.tag = message;
+        problems.category = message;
+    }
+    return problems;
+}
+/**
+ * A pair of bases as they should be stored: trimmed, and each replaced by its
+ * default when it is not usable. Only for reading a value back out of storage
+ * or a data file, where a bad value should not take the site down; a value on
+ * its way in goes through {@link taxonomyBaseProblems} and is refused.
+ */
+export function taxonomyBasesOrDefault(bases) {
+    const candidate = { ...DEFAULT_TAXONOMY_BASES };
+    for (const taxonomy of TAXONOMIES) {
+        const value = bases[taxonomy];
+        if (typeof value !== 'string')
+            continue;
+        const trimmed = value.trim();
+        if (TAXONOMY_BASE_PATTERN.test(trimmed) && !RESERVED_TOP_LEVEL_PATHS.includes(trimmed)) {
+            candidate[taxonomy] = trimmed;
+        }
+    }
+    // Two taxonomies at the same base would make one of the archives
+    // unreachable, so a pair that collides falls back to the defaults rather
+    // than serving half of what was asked for.
+    return candidate.tag === candidate.category ? DEFAULT_TAXONOMY_BASES : candidate;
+}
+/**
+ * The recorded renames after one more, with chains collapsed.
+ *
+ * Three rules, all of them about not making a browser walk a history it does
+ * not care about. Anything that pointed at `from` is repointed at `to`, so
+ * `a → b` followed by `b → c` is stored as `a → c` and answered in one hop. An
+ * older record of `from` moving somewhere else is replaced, because it is no
+ * longer true. And any record of `to` having moved away is dropped, because
+ * the term is back and an archive that answers always beats a record of where
+ * it used to be.
+ */
+export function recordTermRename(existing, change) {
+    const recorded = [];
+    for (const entry of existing) {
+        if (entry.taxonomy !== change.taxonomy) {
+            recorded.push(entry);
+            continue;
+        }
+        if (entry.from === change.from || entry.from === change.to)
+            continue;
+        recorded.push(entry.to === change.from ? { ...entry, to: change.to } : entry);
+    }
+    recorded.push(change);
+    return recorded.filter((entry) => entry.from !== entry.to);
+}
+/**
+ * The recorded renames after a term is deleted.
+ *
+ * Every record pointing at it goes: the archive it named is about to 404, and
+ * a redirect to a 404 costs a round trip and tells the reader nothing. So does
+ * any record of that term having moved, which the delete has just settled.
+ */
+export function forgetTerm(existing, taxonomy, term) {
+    return existing.filter((entry) => entry.taxonomy !== taxonomy || (entry.from !== term && entry.to !== term));
+}
+/**
+ * Where a term went, or `undefined` when nothing says it went anywhere.
+ *
+ * One hop, deliberately: the list is written with its chains already collapsed
+ * ({@link recordTermRename}), and following it further would let a hand-edited
+ * `site.json` send a reader round a loop.
+ */
+export function redirectedTerm(redirects, term) {
+    const found = redirects.find((entry) => entry.taxonomy === term.taxonomy && entry.from === term.term);
+    return found?.to;
+}
+/**
+ * A value out of `site.json` or a stored setting as the renames it names.
+ *
+ * Tolerant, like everything that reads that file: an entry that is not a
+ * `{ taxonomy, from, to }` of three non-empty strings is dropped rather than
+ * failing the read, and so is one that redirects a term to itself.
+ */
+export function taxonomyRedirectsOf(value) {
+    if (!Array.isArray(value))
+        return [];
+    const redirects = [];
+    for (const entry of value) {
+        if (typeof entry !== 'object' || entry === null)
+            continue;
+        const record = entry;
+        const taxonomy = record['taxonomy'];
+        const from = record['from'];
+        const to = record['to'];
+        if (!TAXONOMIES.includes(taxonomy))
+            continue;
+        if (typeof from !== 'string' || typeof to !== 'string')
+            continue;
+        if (from.trim() === '' || to.trim() === '' || from === to)
+            continue;
+        redirects.push({ taxonomy: taxonomy, from, to });
+    }
+    return redirects;
+}
+//# sourceMappingURL=taxonomy.js.map

package/dist/web/taxonomy.js.map

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

package/dist/web/templates.d.ts

@@ -1,14 +1,16 @@
 import { Environment } from 'nunjucks';
-/**
- * The theme that ships inside the package, resolved from this module rather
- * than from the working directory, so it is found whether the CMS is running
- * from `src/` under tsx or from `dist/` as an installed dependency.
- */
-export declare const PACKAGED_THEME_DIR: string;
 /** Where a {@link createTemplateEnvironment} looks, and how it caches. */
 export interface CreateTemplateEnvironmentOptions {
-    /** The site's own theme directory. Searched first. It need not exist. */
-    themeDir: string;
+    /**
+     * The theme directories to read, in the order {@link themeSearchPath} gives
+     * them. Defaults to the packaged theme alone, which is what a site that has
+     * chosen no theme of its own renders through. None of them need exist.
+     *
+     * Where they came from is the caller's business, and changing them later is
+     * {@link useThemeDirs}: this is the environment's starting point, not a
+     * promise that it will read the same directories forever.
+     */
+    themeDirs?: readonly string[] | undefined;
     /** Public origin, for the `url` and `absoluteUrl` filters. */
     baseUrl: string;
     /**
@@ -17,18 +19,54 @@ export interface CreateTemplateEnvironmentOptions {
      * without a restart.
      */
     noCache?: boolean | undefined;
+    /**
+     * Whether `{{ }}` escapes for HTML. On everywhere a page is rendered, and
+     * off for the plain text half of an email (TASK-55): a text body and a
+     * subject line are not HTML, so escaping there turns an ampersand in a URL
+     * into `&` and an apostrophe in a name into `'`.
+     */
+    autoescape?: boolean | undefined;
 }
 /**
- * A Nunjucks environment whose loader searches the site theme first and the
- * packaged default theme second, one file at a time.
+ * A Nunjucks environment whose loader searches the theme directories in the
+ * order {@link themeSearchPath} gives them, one file at a time.
  *
- * That is the whole override mechanism: a site that ships only
- * `theme/layouts/post.njk` replaces the post layout and keeps receiving
- * updates to every other template.
+ * That is the whole override mechanism: a theme that ships only
+ * `layouts/post.njk` replaces the post layout and keeps receiving updates to
+ * every other template.
  */
 export declare function createTemplateEnvironment(options: CreateTemplateEnvironmentOptions): Environment;
+/**
+ * Point an environment at these theme directories for the renders that follow.
+ *
+ * This is what makes a change of theme take effect without a restart. An
+ * environment is built once per process and holds the filters a site added to
+ * it, so switching theme by building a second one would either lose those
+ * filters or hand two objects to something that was promised one. Nunjucks
+ * reads `searchPaths` afresh on every miss, so moving the path and dropping
+ * the compiled templates is the whole of it.
+ *
+ * Directories that have not changed cost nothing: the compiled templates are
+ * only thrown away when the answer is actually different, so the ordinary
+ * request — every request on a site that never changes theme — pays one array
+ * comparison.
+ */
+export declare function useThemeDirs(environment: Environment, dirs: readonly string[]): void;
 /** How `date` renders a value. */
-export type DateFormat = 'readable' | 'iso' | 'html' | 'year';
-/** `date` filter. An unparseable value renders as the empty string. */
-export declare function formatDate(value: unknown, format: string): string;
+export type DateFormat = 'readable' | 'iso' | 'html' | 'year' | 'month';
+/**
+ * `date` filter. An unparseable value renders as the empty string.
+ *
+ * `iso` is the instant, always in UTC, because that is what a `<time
+ * datetime>` and a feed want and it must not move when a setting does. The
+ * other four are the calendar the reader in `timezone` is on, which is what
+ * makes a post published at half past midnight in Berlin say 1 October rather
+ * than the 30 September UTC was still on.
+ *
+ * `month` is the month that calendar day falls in, "September 2026", which is
+ * what heads a group of an archive page (TASK-85). It is a format rather than
+ * something the archive works out for itself so that the month names are in
+ * one table and a theme can head a group of its own the same way.
+ */
+export declare function formatDate(value: unknown, format: string, timezone?: string): string;
 //# sourceMappingURL=templates.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../src/web/templates.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAoB,MAAM,UAAU,CAAC;AAEzD;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAEhC,CAAC;AAEF,0EAA0E;AAC1E,MAAM,WAAW,gCAAgC;IAC/C,yEAAyE;IACzE,QAAQ,EAAE,MAAM,CAAC;IACjB,8DAA8D;IAC9D,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAC/B;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,gCAAgC,GAAG,WAAW,CAahG;AAED,kCAAkC;AAClC,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;AA0D9D,uEAAuE;AACvE,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAmBjE"}
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../src/web/templates.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAoB,MAAM,UAAU,CAAC;AAKzD,0EAA0E;AAC1E,MAAM,WAAW,gCAAgC;IAC/C;;;;;;;;OAQG;IACH,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IAC1C,8DAA8D;IAC9D,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B;;;;;OAKG;IACH,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAClC;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,gCAAgC,GAAG,WAAW,CAahG;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAiBpF;AAED,kCAAkC;AAClC,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAsExE;;;;;;;;;;;;;GAaG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,MAAM,EACd,QAAQ,GAAE,MAAyB,GAClC,MAAM,CAqBR"}

package/dist/web/templates.js

@@ -1,44 +1,76 @@
-import { fileURLToPath } from 'node:url';
 import { Environment, FileSystemLoader } from 'nunjucks';
+import { calendarDayIn, DEFAULT_TIMEZONE } from '../content/time.js';
+import { themeSearchPath } from './themes.js';
 /**
- * The theme that ships inside the package, resolved from this module rather
- * than from the working directory, so it is found whether the CMS is running
- * from `src/` under tsx or from `dist/` as an installed dependency.
- */
-export const PACKAGED_THEME_DIR = fileURLToPath(new URL('../../themes/default/', import.meta.url));
-/**
- * A Nunjucks environment whose loader searches the site theme first and the
- * packaged default theme second, one file at a time.
+ * A Nunjucks environment whose loader searches the theme directories in the
+ * order {@link themeSearchPath} gives them, one file at a time.
  *
- * That is the whole override mechanism: a site that ships only
- * `theme/layouts/post.njk` replaces the post layout and keeps receiving
- * updates to every other template.
+ * That is the whole override mechanism: a theme that ships only
+ * `layouts/post.njk` replaces the post layout and keeps receiving updates to
+ * every other template.
  */
 export function createTemplateEnvironment(options) {
-    const loader = new FileSystemLoader([options.themeDir, PACKAGED_THEME_DIR], {
+    const loader = new FileSystemLoader([...(options.themeDirs ?? themeSearchPath())], {
         noCache: options.noCache === true,
     });
     const environment = new Environment(loader, {
-        autoescape: true,
+        autoescape: options.autoescape ?? true,
         throwOnUndefined: false,
         trimBlocks: true,
         lstripBlocks: true,
     });
     return addFilters(environment, options.baseUrl);
 }
+/**
+ * Point an environment at these theme directories for the renders that follow.
+ *
+ * This is what makes a change of theme take effect without a restart. An
+ * environment is built once per process and holds the filters a site added to
+ * it, so switching theme by building a second one would either lose those
+ * filters or hand two objects to something that was promised one. Nunjucks
+ * reads `searchPaths` afresh on every miss, so moving the path and dropping
+ * the compiled templates is the whole of it.
+ *
+ * Directories that have not changed cost nothing: the compiled templates are
+ * only thrown away when the answer is actually different, so the ordinary
+ * request — every request on a site that never changes theme — pays one array
+ * comparison.
+ */
+export function useThemeDirs(environment, dirs) {
+    // Through a cast because neither the loader's search paths nor the cache it
+    // keeps them for are in the published types, though both are documented API
+    // and both have been there since Nunjucks 2.
+    const internals = environment;
+    for (const loader of internals.loaders) {
+        const paths = loader.searchPaths;
+        if (paths === undefined)
+            continue;
+        if (paths.length === dirs.length && paths.every((dir, index) => dir === dirs[index]))
+            continue;
+        loader.searchPaths = [...dirs];
+        internals.invalidateCache();
+    }
+}
 /**
  * The filter set, which is part of the semver contract because site templates
  * are written against it.
  *
- * Dates are formatted in UTC. A date in the front matter keeps its offset in
- * the file and in the JSON representation; what a theme prints is the same
- * instant expressed as UTC, which is what an Eleventy site using Luxon with
- * `zone: 'utc'` prints too.
+ * Per decision-11 a date in a file is a UTC instant and the site's `timezone`
+ * setting is the lens it is read through, so `readable`, `html`, `year` and
+ * `month` are rendered in the site's zone and `iso` stays the instant. The
+ * zone comes from
+ * the `site` global of the render in hand — Nunjucks calls a filter with the
+ * template context as `this`, so nothing has to be threaded through every
+ * template — which is what lets the setting change what every page shows
+ * without a file changing. An Eleventy build of the same content applies the
+ * same lens with Luxon and `zone` read from `site.json`.
  */
 function addFilters(environment, baseUrl) {
     const base = new URL(baseUrl.endsWith('/') ? baseUrl : `${baseUrl}/`);
     const basePath = base.pathname === '/' ? '' : base.pathname.replace(/\/$/, '');
-    environment.addFilter('date', (value, format = 'readable') => formatDate(value, typeof format === 'string' ? format : 'readable'));
+    environment.addFilter('date', function (value, format = 'readable', timezone) {
+        return formatDate(value, typeof format === 'string' ? format : 'readable', typeof timezone === 'string' && timezone !== '' ? timezone : siteTimezone(this));
+    });
     // Eleventy's `url` filter: make a site-root path absolute against the base
     // path, so a site served from a subdirectory links correctly.
     const withBasePath = (value) => {
@@ -74,29 +106,78 @@ const MONTHS = [
     'November',
     'December',
 ];
-/** `date` filter. An unparseable value renders as the empty string. */
-export function formatDate(value, format) {
+/**
+ * `date` filter. An unparseable value renders as the empty string.
+ *
+ * `iso` is the instant, always in UTC, because that is what a `<time
+ * datetime>` and a feed want and it must not move when a setting does. The
+ * other four are the calendar the reader in `timezone` is on, which is what
+ * makes a post published at half past midnight in Berlin say 1 October rather
+ * than the 30 September UTC was still on.
+ *
+ * `month` is the month that calendar day falls in, "September 2026", which is
+ * what heads a group of an archive page (TASK-85). It is a format rather than
+ * something the archive works out for itself so that the month names are in
+ * one table and a theme can head a group of its own the same way.
+ */
+export function formatDate(value, format, timezone = DEFAULT_TIMEZONE) {
     const date = toDate(value);
     if (date === undefined)
         return '';
-    const year = String(date.getUTCFullYear());
-    const month = String(date.getUTCMonth() + 1).padStart(2, '0');
-    const day = String(date.getUTCDate()).padStart(2, '0');
+    if (format === 'iso')
+        return date.toISOString();
+    const day = calendarDayIn(date, timezone);
+    if (day === undefined)
+        return '';
+    const [year = '', month = '', dayOfMonth = ''] = day.split('-');
     switch (format) {
-        case 'iso':
-            return date.toISOString();
         case 'html':
-            return `${year}-${month}-${day}`;
+            return day;
         case 'year':
             return year;
+        case 'month':
+            return `${MONTHS[Number(month) - 1] ?? ''} ${year}`;
         case 'readable':
         default:
-            return `${String(date.getUTCDate())} ${MONTHS[date.getUTCMonth()] ?? ''} ${year}`;
+            return `${String(Number(dayOfMonth))} ${MONTHS[Number(month) - 1] ?? ''} ${year}`;
     }
 }
+/**
+ * The zone the render in hand is in: the `timezone` of its `site` global.
+ *
+ * Nunjucks calls a filter with the template context as `this`, so the filter
+ * can read a per-render value without the environment holding any state of its
+ * own — which matters, because one environment serves every request and a zone
+ * stored on it would be a race between two of them.
+ */
+function siteTimezone(context) {
+    if (typeof context !== 'object' || context === null)
+        return DEFAULT_TIMEZONE;
+    const lookup = context.lookup;
+    if (typeof lookup !== 'function')
+        return DEFAULT_TIMEZONE;
+    const site = lookup.call(context, 'site');
+    if (typeof site !== 'object' || site === null)
+        return DEFAULT_TIMEZONE;
+    const timezone = site['timezone'];
+    return typeof timezone === 'string' && timezone !== '' ? timezone : DEFAULT_TIMEZONE;
+}
+/**
+ * A value as an instant, or `undefined` when it is not one.
+ *
+ * `'now'` is the one word the filter reads rather than parses, for the thing a
+ * page has that no file carries: the year in the footer's copyright line. It is
+ * read at render time rather than at boot so a site left running over New Year
+ * says the new one, and it goes through the same zone lens as every other date,
+ * so a site in Auckland turns the year over when Auckland does. Eleventy themes
+ * spell it the same way, and `docs/eleventy.config.example.js` answers to it
+ * too, so one footer renders identically in both builds.
+ */
 function toDate(value) {
     if (value instanceof Date)
         return Number.isNaN(value.getTime()) ? undefined : value;
+    if (value === 'now')
+        return new Date();
     if (typeof value === 'string' || typeof value === 'number') {
         const parsed = new Date(value);
         return Number.isNaN(parsed.getTime()) ? undefined : parsed;

package/dist/web/templates.js.map

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