@heroiclands/package-build 25.6.2 → 25.7.0

package/engine/site-config.mjs

@@ -60,6 +60,9 @@ export const BRAND = Object.freeze({
 /** Where the navigation is published. */
 export const NAVIGATION_URL = "https://www.heroiclands.org/nav.json";
 
+// Shared with the pathname leaf without importing configuration back into it.
+export { CANONICAL_CDN_ORIGIN } from "./site-origins.mjs";
+
 /** The cached navigation's file name. */
 export const NAVIGATION_FILE = "nav.json";
 
@@ -101,7 +104,7 @@ function requireNonEmptyString(value, where) {
 /**
  * Check a navigation's shape, and return it.
  *
- * `[{name, url, children?: [{name, url}]}]`, every `url` absolute. Checked
+ * `[{name, url, children?: [{name, url}]}]`, every `url` a non-empty string. Checked
  * on fetch and again on read: a file that is not a navigation would otherwise
  * reach the menu as `undefined` labels and links.
  *
@@ -148,7 +151,22 @@ export function navigationCacheDir(config) {
 }
 
 /**
- * The cached navigation.
+ * Project a canonical owned chrome link onto the selected site origin.
+ * Attribution and ordinary content links do not pass through this function.
+ *
+ * @param {string} value - A chrome URL.
+ * @param {object} config - The effective configuration.
+ * @returns {string} The selected URL, or the unchanged external URL.
+ */
+function chromeURL(value, config) {
+    if (!URL.canParse(value)) return value;
+    const url = new URL(value);
+    if (url.origin !== new URL(NAVIGATION_URL).origin) return value;
+    return new URL(`${url.pathname}${url.search}${url.hash}`, new URL(config.homepage).origin).href;
+}
+
+/**
+ * The cached navigation, with canonical owned links on the effective homepage origin.
  *
  * **Reads the cache only.** A cold cache is an error naming the command that
  * fills it, rather than a download nobody asked for: a site build that reaches
@@ -168,7 +186,18 @@ export function readCachedNavigation(config) {
             "the site navigation has not been fetched. Run `package-build deps fetch` first.",
         );
     }
-    return checkNavigation(JSON.parse(fs.readFileSync(file, "utf8")), file);
+    return checkNavigation(JSON.parse(fs.readFileSync(file, "utf8")), file).map((entry) => ({
+        ...entry,
+        url: chromeURL(entry.url, config),
+        ...(entry.children ?
+            {
+                children: entry.children.map((child) => ({
+                    ...child,
+                    url: chromeURL(child.url, config),
+                })),
+            }
+        :   {}),
+    }));
 }
 
 /**
@@ -252,7 +281,7 @@ export function siteSettings({ config }) {
     const params = { description: config.site.description };
     if (config.author?.name) params.author = config.author.name;
     if (config.site.assets) params.cdnBaseURL = config.site.assets;
-    params.brand = { ...BRAND };
+    params.brand = { ...BRAND, licenseURL: chromeURL(BRAND.licenseURL, config) };
     if (config.site.notfound) params.notfound = structuredClone(config.site.notfound);
     // Named only when the build copies the fonts, so the theme links nothing
     // it does not ship.

package/engine/site-maps.mjs

@@ -95,20 +95,33 @@ export function inlineSvg(svg) {
  * @param {object} opts.config - The resolved configuration.
  * @param {string} opts.base - The site base every page is served under,
  *   ending in a slash: what every name in a drawing links through.
+ * @param {Iterable<string>} [opts.only] - The places to draw, by shortcode,
+ *   of those given a map; absent, every one.
+ * @param {string} [opts.outDir] - Where to draw, emptied first;
+ *   {@link SITE_MAP_DIR} under the package root by default.
  * @returns {{maps: Map<string, SiteMap>, findings: Array<{file: string,
  *   line?: number, column?: number, severity: "error"|"warning",
  *   message: string}>}} The drawings, keyed by the file name a **From here**
  *   section names, and warnings for relations that name no place.
  */
-export function drawSiteMaps({ records, foreignIndex, config, base }) {
+export function drawSiteMaps({
+    records,
+    foreignIndex,
+    config,
+    base,
+    only,
+    outDir = path.join(config.rootDir, ...SITE_MAP_DIR.split("/")),
+}) {
     /** @type {Map<string, SiteMap>} */
     const maps = new Map();
-    const outDir = path.join(config.rootDir, ...SITE_MAP_DIR.split("/"));
+    const wanted = only ? new Set(only) : undefined;
     // Every run draws afresh: a place that lost its relations must not keep
     // the map an earlier run drew.
     fs.rmSync(outDir, { recursive: true, force: true });
 
-    const centres = placesWithMaps(records, { foreignIndex, config });
+    const centres = placesWithMaps(records, { foreignIndex, config }).filter(
+        (centre) => !wanted || wanted.has(centre),
+    );
     if (centres.length === 0) return { maps, findings: [] };
     const world = mapWorld({
         records,
@@ -126,24 +139,3 @@ export function drawSiteMaps({ records, foreignIndex, config, base }) {
     }
     return { maps, findings };
 }
-
-/**
- * The figure the website sets a drawing in: the SVG inline, so its place names
- * stay links, with no blank line inside it — a blank line would end the HTML
- * block and hand the rest of the drawing to the Markdown renderer.
- *
- * @param {string} svg - The drawing, as {@link inlineSvg} wrote it.
- * @param {string} alt - What the drawing shows, for a screen reader.
- * @returns {string} One HTML block.
- */
-export function inlineDrawingFigure(svg, alt) {
-    const label = String(alt ?? "").replace(/[&<>"]/g, (c) => `&#${c.charCodeAt(0)};`);
-    const body = String(svg)
-        .split("\n")
-        .filter((line) => line.trim() !== "")
-        .join("\n");
-    return (
-        `<figure class="note-image note-image-full-width" role="img" ` +
-        `aria-label="${label}">\n${body}\n</figure>`
-    );
-}

package/engine/site-origins.mjs

@@ -0,0 +1,23 @@
+/*
+ * 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
+ */
+
+/**
+ * The owned CDN origin, re-exported by site-config beside the chrome addresses.
+ * Kept in a leaf because site-config reaches pathnames through configuration and
+ * content rendering; importing site-config from pathnames would close that cycle.
+ *
+ * @module
+ */
+
+/** The canonical public origin whose asset URLs follow the selected build host. */
+export const CANONICAL_CDN_ORIGIN = "https://cdn.heroiclands.org";