@heroiclands/package-build 23.11.0 → 23.12.0

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # @heroiclands/package-build
 
+## 23.12.0
+
+### Minor Changes
+
+**Preview and layout**
+
+- Preview Markdown buffers directly in light or dark themes, without building a content index; cross-note constructs remain highlighted source.
+- Definition lists use bold terms and hanging definitions across websites, Foundry, preview and books, with a narrower definition column on small screens.
+
+**Dates and spoilers**
+
+- One setting-wide current date, defaulting to 720.1, drives age calculations; world-note dates are retired and authored ages are preserved.
+- Secret spans in Foundry and preview redact until hover or keyboard focus; secret preview sections and fences open as spoilers.
+- PDF inline secret spans print normally with their formatting; secret sections and fences retain labelled boxes.
+
+### Patch Changes
+
+**Alerts**
+
+- Note, Tip, Important and Warning alerts have tinted backgrounds with coordinated icons, headings and borders, adapting to each surface's color scheme.
+
 ## 23.11.0
 
 ### Minor Changes

package/README.md

@@ -69,6 +69,7 @@ The documentation lives in the Markdown files in this repository. Start with [th
 | Localization and templates                        | [Localization](docs/guides/localization.md)                               |
 | Foundry integration testing                       | [End-to-end testing](docs/guides/e2e.md), including an optional S3 server |
 | Release and deployment                            | [Release and deploy](docs/guides/release-and-deploy.md)                   |
+| Buffer-only preview and Gitea rendering           | [Source preview](docs/source-preview.md)                                  |
 | Every CLI command                                 | [Commands](docs/commands.md)                                              |
 | Every build setting                               | [Configuration](docs/configuration.md)                                    |
 | Programmatic exports                              | [API](docs/api.md)                                                        |

package/assets/preview/check-sanitizer.go

@@ -0,0 +1,68 @@
+// Copyright (c) 2026 Tom Rodriguez ("Toasty") — <toasty@heroiclands.org>
+// SPDX-License-Identifier: GPL-3.0-or-later
+
+// Replay the preview INI rules with the real bluemonday UGC sanitizer.
+// Gitea also adds default rules; include the defaults needed by preview icons.
+// This validates the shared policy primitives, not a deployed Gitea instance.
+package main
+
+import (
+	"bufio"
+	"fmt"
+	"io"
+	"os"
+	"regexp"
+	"strings"
+
+	"github.com/microcosm-cc/bluemonday"
+)
+
+func main() {
+	if len(os.Args) != 2 {
+		panic("usage: check-sanitizer path/to/gitea.ini < preview.html")
+	}
+	file, err := os.Open(os.Args[1])
+	if err != nil {
+		panic(err)
+	}
+	defer file.Close()
+	policy := bluemonday.UGCPolicy()
+	// Gitea modules/markup/sanitizer_default.go permits these SVG attributes.
+	policy.AllowAttrs("viewBox", "width", "height", "aria-hidden", "data-attr-class").OnElements("svg")
+	policy.AllowAttrs("fill-rule", "d").OnElements("path")
+	policy.AllowAttrs("aria-hidden").OnElements("span", "div")
+	var section string
+	rule := map[string]string{}
+	flush := func() {
+		if !strings.HasPrefix(section, "markup.sanitizer.markdown.") {
+			return
+		}
+		element, attr, pattern := rule["ELEMENT"], rule["ALLOW_ATTR"], rule["REGEXP"]
+		if element == "" || attr == "" || pattern == "" {
+			panic("incomplete sanitizer rule: " + section)
+		}
+		policy.AllowAttrs(attr).Matching(regexp.MustCompile(pattern)).OnElements(element)
+	}
+	scanner := bufio.NewScanner(file)
+	for scanner.Scan() {
+		line := strings.TrimSpace(scanner.Text())
+		if strings.HasPrefix(line, "[") {
+			flush()
+			section = strings.Trim(line, "[]")
+			rule = map[string]string{}
+			continue
+		}
+		if key, value, ok := strings.Cut(line, "="); ok {
+			rule[strings.TrimSpace(key)] = strings.TrimSpace(value)
+		}
+	}
+	flush()
+	if err := scanner.Err(); err != nil {
+		panic(err)
+	}
+	input, err := io.ReadAll(os.Stdin)
+	if err != nil {
+		panic(err)
+	}
+	fmt.Print(policy.Sanitize(string(input)))
+}

package/assets/preview/gitea-theme.js

@@ -0,0 +1,36 @@
+/*
+ * This file is part of the Song of Heroic Lands (SoHL) system for Foundry VTT.
+ * Copyright (c) 2024-2026 Tom Rodriguez ("Toasty") — <toasty@heroiclands.org>
+ *
+ * This work is licensed under the GNU General Public License v3.0 (GPLv3).
+ * You may copy, modify, and distribute it under the terms of that license.
+ *
+ * For full terms, see the LICENSE.md file in the project root or visit:
+ * https://www.gnu.org/licenses/gpl-3.0.html
+ *
+ * SPDX-License-Identifier: GPL-3.0-or-later
+ */
+
+// Installed by the Gitea administrator, outside user-authored rendered markup.
+(() => {
+    const root = document.documentElement;
+    function update() {
+        const scheme = getComputedStyle(root).getPropertyValue("--is-dark-theme").trim();
+        // An unknown custom theme keeps the renderer's explicit initial mode.
+        if (scheme !== "true" && scheme !== "false") return;
+        for (const preview of document.querySelectorAll(".markup.markdown .hl-preview")) {
+            preview.classList.toggle("hl-preview-dark", scheme === "true");
+            preview.classList.toggle("hl-preview-light", scheme === "false");
+        }
+    }
+    new MutationObserver(update).observe(root, {
+        attributes: true,
+        attributeFilter: ["data-theme"],
+        childList: true,
+        subtree: true,
+    });
+    // Theme stylesheets can finish loading after data-theme changes.
+    document.addEventListener("load", update, true);
+    document.addEventListener("DOMContentLoaded", update, { once: true });
+    update();
+})();

package/assets/preview/gitea.ini

@@ -0,0 +1,127 @@
+[markup.markdown]
+ENABLED = true
+FILE_EXTENSIONS = .md,.markdown,.mdown,.mkd
+RENDER_COMMAND = /opt/heroiclands/node_modules/.bin/package-build-preview
+IS_INPUT_FILE = false
+NEED_POST_PROCESS = false
+RENDER_CONTENT_MODE = sanitized
+
+[markup.sanitizer.markdown.previewDiv]
+ELEMENT = div
+ALLOW_ATTR = class
+REGEXP = ^(hl-preview(?:-[a-z-]+)?|alert(?:-(?:note|tip|important|warning))?|content-figure(?:-[a-z-]+)?|poetry)( (hl-preview(?:-[a-z-]+)?|alert(?:-(?:note|tip|important|warning))?|content-figure(?:-[a-z-]+)?|poetry))*$
+
+[markup.sanitizer.markdown.previewSpan]
+ELEMENT = span
+ALLOW_ATTR = class
+REGEXP = ^(hl-preview-[a-z-]+|alert-(?:title|icon)|poetry-[a-z-]+|i[0-8])( (hl-preview-[a-z-]+|alert-(?:title|icon)|poetry-[a-z-]+|i[0-8]))*$
+
+[markup.sanitizer.markdown.previewPre]
+ELEMENT = pre
+ALLOW_ATTR = class
+REGEXP = ^hl-preview-(fence|dependent)$
+
+[markup.sanitizer.markdown.previewCode]
+ELEMENT = code
+ALLOW_ATTR = class
+REGEXP = ^(hl-preview-fence|language-[A-Za-z0-9_-]+)$
+
+[markup.sanitizer.markdown.previewAside]
+ELEMENT = aside
+ALLOW_ATTR = class
+REGEXP = ^hl-preview-infobox$
+
+[markup.sanitizer.markdown.alertSvgFill]
+ELEMENT = svg
+ALLOW_ATTR = fill
+REGEXP = ^currentColor$
+
+[markup.sanitizer.markdown.alertCircleX]
+ELEMENT = circle
+ALLOW_ATTR = cx
+REGEXP = ^[0-9.]+$
+
+[markup.sanitizer.markdown.alertCircleY]
+ELEMENT = circle
+ALLOW_ATTR = cy
+REGEXP = ^[0-9.]+$
+
+[markup.sanitizer.markdown.alertCircleRadius]
+ELEMENT = circle
+ALLOW_ATTR = r
+REGEXP = ^[0-9.]+$
+
+[markup.sanitizer.markdown.previewMain]
+ELEMENT = main
+ALLOW_ATTR = class
+REGEXP = ^hl-preview-main$
+
+[markup.sanitizer.markdown.alertBox]
+ELEMENT = blockquote
+ALLOW_ATTR = class
+REGEXP = ^alert alert-(note|tip|important|warning)$
+
+[markup.sanitizer.markdown.previewParagraph]
+ELEMENT = p
+ALLOW_ATTR = class
+REGEXP = ^(alert-title|content-figure-label)$
+
+[markup.sanitizer.markdown.alertSvgClass]
+ELEMENT = svg
+ALLOW_ATTR = class
+REGEXP = ^alert-icon$
+
+[markup.sanitizer.markdown.previewDetails]
+ELEMENT = details
+ALLOW_ATTR = class
+REGEXP = ^secret$
+
+[markup.sanitizer.markdown.footnoteSection]
+ELEMENT = section
+ALLOW_ATTR = class
+REGEXP = ^footnotes$
+
+[markup.sanitizer.markdown.footnoteSeparator]
+ELEMENT = hr
+ALLOW_ATTR = class
+REGEXP = ^footnotes-sep$
+
+[markup.sanitizer.markdown.footnoteList]
+ELEMENT = ol
+ALLOW_ATTR = class
+REGEXP = ^footnotes-list$
+
+[markup.sanitizer.markdown.footnoteItem]
+ELEMENT = li
+ALLOW_ATTR = class
+REGEXP = ^footnote-item$
+
+[markup.sanitizer.markdown.footnoteLink]
+ELEMENT = a
+ALLOW_ATTR = class
+REGEXP = ^footnote-(ref|backref)$
+
+[markup.sanitizer.markdown.footnoteRef]
+ELEMENT = sup
+ALLOW_ATTR = class
+REGEXP = ^footnote-ref$
+
+[markup.sanitizer.markdown.tableHeaderAlign]
+ELEMENT = th
+ALLOW_ATTR = class
+REGEXP = ^hl-preview-align-(left|center|right)$
+
+[markup.sanitizer.markdown.tableCellAlign]
+ELEMENT = td
+ALLOW_ATTR = class
+REGEXP = ^hl-preview-align-(left|center|right)$
+
+[markup.sanitizer.markdown.dictionaryList]
+ELEMENT = dl
+ALLOW_ATTR = class
+REGEXP = ^dictionary$
+
+[markup.sanitizer.markdown.secretFocus]
+ELEMENT = span
+ALLOW_ATTR = tabindex
+REGEXP = ^0$

package/assets/styles/content-base.css

@@ -31,7 +31,7 @@
  */
 
 /*
- * Definition lists, in two states of one style.
+ * Profile definition grids, in two states of one style.
  *
  * **Wide.** Two columns, the term right-aligned against a fixed gutter so every
  * term in the list shares one right edge, the definition in the remaining
@@ -58,7 +58,8 @@
  * The three tunable values are custom properties, so a package adjusts the term
  * column, the gutter or the stacking point without copying the rule.
  */
-:is(.journal-entry-page, .journal-entry-content, .editor-content, .prosemirror) dl {
+:is(.journal-entry-page, .journal-entry-content, .editor-content, .prosemirror)
+    dl:not(.dictionary) {
     display: grid;
     /* `minmax(0, …)` keeps the track at its full width wherever there is room
      * and lets it shrink rather than overflow where there is not. */
@@ -68,7 +69,9 @@
     container-name: pb-deflist;
 }
 
-:is(.journal-entry-page, .journal-entry-content, .editor-content, .prosemirror) dl > dt {
+:is(.journal-entry-page, .journal-entry-content, .editor-content, .prosemirror)
+    dl:not(.dictionary)
+    > dt {
     grid-column: 1;
     /* The one rule that holds on every surface, so an author writes the term
      * and nothing else rather than bolding it by hand. */
@@ -78,13 +81,17 @@
     margin: 0;
 }
 
-:is(.journal-entry-page, .journal-entry-content, .editor-content, .prosemirror) dl > dd {
+:is(.journal-entry-page, .journal-entry-content, .editor-content, .prosemirror)
+    dl:not(.dictionary)
+    > dd {
     grid-column: 2;
     margin: 0 0 var(--pb-deflist-row-gap, 1.5rem);
     line-height: 1.6;
 }
 
-:is(.journal-entry-page, .journal-entry-content, .editor-content, .prosemirror) dl > dd:last-child {
+:is(.journal-entry-page, .journal-entry-content, .editor-content, .prosemirror)
+    dl:not(.dictionary)
+    > dd:last-child {
     margin-bottom: 0;
 }
 
@@ -96,12 +103,16 @@
  * against whichever ancestor container happens to be nearest.
  */
 @container pb-deflist (max-width: 32rem) {
-    dt {
+    :is(.journal-entry-page, .journal-entry-content, .editor-content, .prosemirror)
+        dl:not(.dictionary)
+        > dt {
         grid-column: 1 / -1;
         text-align: left;
     }
 
-    dd {
+    :is(.journal-entry-page, .journal-entry-content, .editor-content, .prosemirror)
+        dl:not(.dictionary)
+        > dd {
         grid-column: 1 / -1;
     }
 }
@@ -205,20 +216,22 @@
     }
 }
 
-/* Alerts share ordinary body colors, with an accent on their edge and title. */
+/* Alerts select a tinted palette from the host's color scheme. */
 :is(.journal-entry-page, .journal-entry-content, .editor-content, .prosemirror) .alert {
     border-inline-start: 0.25rem solid var(--pb-alert-color);
-    padding: 0.5rem 1rem;
+    border-radius: 0.375rem;
+    padding: 1rem;
     margin: 1rem 0;
-    color: inherit;
-    background: transparent;
+    color: #24292f;
+    color: light-dark(#24292f, #e6edf3);
+    background: var(--pb-alert-background);
 }
 :is(.journal-entry-page, .journal-entry-content, .editor-content, .prosemirror) .alert-title {
     display: flex;
     align-items: center;
     gap: 0.5em;
     margin: 0 0 0.5rem;
-    font-weight: 600;
+    font-weight: 700;
     color: var(--pb-alert-color);
 }
 :is(.journal-entry-page, .journal-entry-content, .editor-content, .prosemirror) .alert-icon {
@@ -234,17 +247,107 @@
 }
 :is(.journal-entry-page, .journal-entry-content, .editor-content, .prosemirror) .alert-note {
     --pb-alert-color: #0969da;
-    --pb-alert-color: light-dark(#0969da, #4493f8);
+    --pb-alert-color: light-dark(#0969da, #58a6ff);
+    --pb-alert-background: #f6faff;
+    --pb-alert-background: light-dark(#f6faff, #101a28);
 }
 :is(.journal-entry-page, .journal-entry-content, .editor-content, .prosemirror) .alert-tip {
     --pb-alert-color: #1a7f37;
-    --pb-alert-color: light-dark(#1a7f37, #3fb950);
+    --pb-alert-color: light-dark(#1a7f37, #7ee787);
+    --pb-alert-background: #f4fbf5;
+    --pb-alert-background: light-dark(#f4fbf5, #102018);
 }
 :is(.journal-entry-page, .journal-entry-content, .editor-content, .prosemirror) .alert-important {
-    --pb-alert-color: #8250df;
-    --pb-alert-color: light-dark(#8250df, #ab7df8);
+    --pb-alert-color: #6c3fd1;
+    --pb-alert-color: light-dark(#6c3fd1, #c4b0ff);
+    --pb-alert-background: #faf7ff;
+    --pb-alert-background: light-dark(#faf7ff, #1c172a);
 }
 :is(.journal-entry-page, .journal-entry-content, .editor-content, .prosemirror) .alert-warning {
     --pb-alert-color: #9a6700;
     --pb-alert-color: light-dark(#9a6700, #d29922);
+    --pb-alert-background: #fffaf0;
+    --pb-alert-background: light-dark(#fffaf0, #241d10);
+}
+
+/* Authored definition lists use dictionary rows; profile grids remain separate. */
+:is(.journal-entry-page, .journal-entry-content, .editor-content, .prosemirror) .dictionary {
+    --indent: 150px;
+    --gap: 0.75em;
+    margin: 0;
+    display: block;
+}
+:is(.journal-entry-page, .journal-entry-content, .editor-content, .prosemirror) .dictionary > div {
+    padding-left: var(--indent);
+    text-indent: calc(-1 * var(--indent));
+    margin-bottom: 0.5em;
+}
+:is(.journal-entry-page, .journal-entry-content, .editor-content, .prosemirror)
+    .dictionary
+    > div
+    > dt {
+    display: inline-block;
+    min-width: calc(var(--indent) - var(--gap));
+    margin-right: var(--gap);
+    font-weight: bold;
+    white-space: nowrap;
+    text-indent: 0;
+    text-align: left;
+}
+:is(.journal-entry-page, .journal-entry-content, .editor-content, .prosemirror)
+    .dictionary
+    > div
+    > dd {
+    display: inline;
+    margin: 0;
+    font-weight: normal;
+}
+:is(.journal-entry-page, .journal-entry-content, .editor-content, .prosemirror)
+    .dictionary
+    > div
+    > dd
+    > :is(p, ul, ol, dl, blockquote, pre, table, div) {
+    text-indent: 0;
+}
+:is(.journal-entry-page, .journal-entry-content, .editor-content, .prosemirror)
+    .dictionary
+    > div
+    > dd
+    > p:first-child {
+    display: inline;
+}
+@media (max-width: 600px) {
+    :is(.journal-entry-page, .journal-entry-content, .editor-content, .prosemirror) .dictionary {
+        --indent: 100px;
+    }
+}
+
+/* Inline spoilers reveal on pointer hover or keyboard focus. Native secret
+ * sections retain Foundry's separate GM reveal control. */
+:is(.journal-entry-page, .journal-entry-content, .editor-content, .prosemirror)
+    span.secret[data-inline-spoiler] {
+    cursor: help;
+    border-radius: 0.15em;
+}
+:is(.journal-entry-page, .journal-entry-content, .editor-content, .prosemirror)
+    span.secret[data-inline-spoiler]:not(:hover):not(:focus):not(:focus-within) {
+    color: transparent !important;
+    -webkit-text-fill-color: transparent !important;
+    background-color: var(--pb-redaction-fill, #24292f) !important;
+    text-shadow: none !important;
+    text-decoration-color: transparent !important;
+}
+:is(.journal-entry-page, .journal-entry-content, .editor-content, .prosemirror)
+    span.secret[data-inline-spoiler]:not(:hover):not(:focus):not(:focus-within)
+    * {
+    color: transparent !important;
+    -webkit-text-fill-color: transparent !important;
+    visibility: hidden !important;
+    text-shadow: none !important;
+    text-decoration-color: transparent !important;
+}
+:is(.journal-entry-page, .journal-entry-content, .editor-content, .prosemirror)
+    span.secret[data-inline-spoiler]:focus-visible {
+    outline: 2px solid currentColor;
+    outline-offset: 2px;
 }

package/bin/content-commands.mjs

@@ -144,7 +144,6 @@ import { GRAPHVIZ_ENGINES } from "../engine/map-graphviz.mjs";
 import { loadMapWorld } from "../engine/map-places.mjs";
 import { encodeAddresses } from "../engine/address-values.mjs";
 import YAML from "yaml";
-import { worldInvariants } from "../engine/calendar-notes.mjs";
 import { reckoningContext } from "../engine/reckoning-markers.mjs";
 import { BEING_LOOK_VOCABULARY } from "../engine/note-vocabulary.mjs";
 import { profileFindings } from "../engine/appearance-profile.mjs";
@@ -1054,6 +1053,7 @@ function lintCommand() {
                     );
                 }
                 const frontmatter = lintFrontmatter(index, {
+                    currentDate: config.currentDate,
                     schemas: { ...ENGINE_NOTE_SCHEMAS, ...NOTE_SCHEMAS },
                     // The closed frontmatter regions. Passed in rather
                     // than reached for, so the linter stays a checker of
@@ -2905,7 +2905,7 @@ function newNpc(config, argv) {
             names,
             language: languageKey,
             seed: argv.seed,
-            present: worldInvariants(index).present,
+            currentDate: config.currentDate,
             dateContext: reckoningContext(index),
             defaults,
             taken,

package/bin/package-build-preview.mjs

@@ -0,0 +1,75 @@
+#!/usr/bin/env node
+/*
+ * This file is part of the Song of Heroic Lands (SoHL) system for Foundry VTT.
+ * Copyright (c) 2024-2026 Tom Rodriguez ("Toasty") — <toasty@heroiclands.org>
+ *
+ * This work is licensed under the GNU General Public License v3.0 (GPLv3).
+ * You may copy, modify, and distribute it under the terms of that license.
+ *
+ * For full terms, see the LICENSE.md file in the project root or visit:
+ * https://www.gnu.org/licenses/gpl-3.0.html
+ *
+ * SPDX-License-Identifier: GPL-3.0-or-later
+ */
+
+/** Render stdin with optional date-only configuration and no content index. */
+import { readFileSync } from "node:fs";
+import { formatDiagnostic } from "../engine/diagnostics.mjs";
+
+const HELP = `Usage: package-build-preview [--dark] [--current-date DATE] [--css]
+
+Read Markdown from stdin and write an HTML fragment to stdout.
+No package configuration, content tree or content index is required.
+
+Options:
+  --dark       Select the dark palette (default: light).
+  --current-date DATE  Override the setting's neutral current date (default: 720.1).
+  --css        Write shared scoped CSS instead of HTML; does not read stdin.
+  --help, -h   Show this help.
+
+Findings go to stderr. Exit status: 0 for success, 1 for errors.
+`;
+
+try {
+    let dark = false;
+    let css = false;
+    let help = false;
+    let currentDate;
+    const args = process.argv.slice(2);
+    for (let index = 0; index < args.length; index++) {
+        const arg = args[index];
+        if (arg === "--dark") dark = true;
+        else if (arg === "--current-date") {
+            currentDate = args[++index];
+            if (!currentDate || currentDate.startsWith("--"))
+                throw new Error("--current-date requires a neutral date");
+        } else if (arg === "--css") css = true;
+        else if (arg === "--help" || arg === "-h") help = true;
+        else
+            throw new Error(
+                `${arg.startsWith("-") ? "Unknown option" : "Unexpected argument"}: ${arg}`,
+            );
+    }
+    if (help) process.stdout.write(HELP);
+    else {
+        const { renderPreview, previewStyles, readPreviewCurrentDate } =
+            await import("../engine/site-preview.mjs");
+        if (css) process.stdout.write(`${previewStyles()}\n`);
+        else {
+            currentDate ??= await readPreviewCurrentDate(process.cwd());
+            const result = await renderPreview(readFileSync(0, "utf8"), {
+                dark,
+                file: "<stdin>",
+                currentDate,
+            });
+            for (const finding of result.findings) {
+                process.stderr.write(`${formatDiagnostic(finding)}\n`);
+            }
+            process.stdout.write(result.html);
+            if (!result.ok) process.exitCode = 1;
+        }
+    }
+} catch (error) {
+    process.stderr.write(`package-build-preview: ${error.message}\n`);
+    process.exitCode = 1;
+}

package/content-config.mjs

@@ -65,6 +65,7 @@ import fs from "node:fs";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
 import YAML from "yaml";
+import { normalizeCurrentDate } from "./engine/current-date.mjs";
 
 // Leaves with no local imports of their own, so naming them here cannot close
 // a cycle around a consumer's config file (see `engine/pack-config.mjs`).
@@ -569,6 +570,7 @@ export function publishesContentPages(config) {
  *                                          repository — every configured path is
  *                                          resolved against it, so the build never
  *                                          depends on the working directory.
+ * @property {string} [currentDate] Setting-wide neutral current date; defaults to "720.1".
  * @property {string} contentPackage        Content package name — the address
  *                                          namespace every note in this
  *                                          repository is published under.
@@ -643,6 +645,7 @@ export function publishesContentPages(config) {
  * The normalized, frozen configuration the toolchain reads.
  *
  * @typedef {object} ContentBuildConfig
+ * @property {string} currentDate Setting-wide neutral current date.
  * @property {string} rootDir
  * @property {string} contentPackage
  * @property {string|null} foundryPackage  `null` for a `documentation`
@@ -726,6 +729,7 @@ export function publishesContentPages(config) {
 const CONFIG_KEYS = [
     "rootDir",
     "contentPackage",
+    "currentDate",
     "foundryPackage",
     "homepage",
     "authors",
@@ -2943,6 +2947,13 @@ export function defineConfig(config) {
 
     return Object.freeze({
         rootDir,
+        currentDate: (() => {
+            try {
+                return normalizeCurrentDate(input.currentDate);
+            } catch (error) {
+                fail("currentDate", error.message);
+            }
+        })(),
         contentPackage: requireContentPackage(input.contentPackage, docEntryTypes, {
             rootDir,
             packageKind,