@wizzlethorpe/vaults 0.14.0 → 0.15.0

package/dist/foundry-html.js

@@ -0,0 +1,196 @@
+// Turn a page's rendered article HTML into what a Foundry journal wants:
+// links become Foundry UUIDs, media becomes `@vaults/<variant>/<path>`
+// references the provider resolves on the reader's machine.
+//
+// The variant segment is load-bearing: each role's deploy holds only the
+// files its pages reference, so resolving without it means guessing, and
+// guessing upward hands a player a file their role was built to withhold.
+// A `.foundry.html` suffix marks a body to inline; anything else is a file.
+import { createHash } from "node:crypto";
+import { htmlAttr, htmlUnescape } from "./escape.js";
+const ANCHOR_RE = /<a\b([^>]*)>([\s\S]*?)<\/a>/gi;
+const MEDIA_SRC_RE = /<(img|audio|video)\b([^>]*?)src="([^"]+)"([^>]*)>/gi;
+const HREF_RE = /\bhref="([^"]+)"/i;
+const CLASS_RE = /\bclass="([^"]+)"/i;
+const TAG_RE = /<[^>]+>/g;
+/** `"/Characters/Marlo"` back to `"Characters/Marlo.md"`. */
+export function pathFromHref(href) {
+    // The entity pass comes first because it is the parser layer: the serializer
+    // wrote `'` as `&#x27;`, and only what it produces is percent-encoded.
+    const unescaped = htmlUnescape(href);
+    if (!unescaped.startsWith("/"))
+        return null;
+    const clean = unescaped.split("#")[0].split("?")[0];
+    let decoded;
+    try {
+        decoded = decodeURIComponent(clean);
+    }
+    catch {
+        decoded = clean;
+    }
+    const trimmed = decoded.replace(/^\/+/, "").replace(/\.html$/i, "");
+    return trimmed ? `${trimmed}.md` : null;
+}
+/** The UUID a link to `path` should carry, or null if nothing points there. */
+export function uuidFor(path, index, prefer = "journal") {
+    const target = index.targets.get(path);
+    if (!target)
+        return null;
+    const docUuid = target.doc
+        ? (index.packaging === "adventure"
+            ? `${target.doc.type}.${target.doc.id}`
+            : `Compendium.${index.moduleId}.${target.doc.pack}.${target.doc.type}.${target.doc.id}`)
+        : null;
+    const pageUuid = target.entry && target.page
+        ? (index.packaging === "adventure"
+            ? `JournalEntry.${target.entry}.JournalEntryPage.${target.page}`
+            : `Compendium.${index.moduleId}.${index.journalPack}.JournalEntry.${target.entry}.JournalEntryPage.${target.page}`)
+        : null;
+    return prefer === "doc" ? (docUuid ?? pageUuid) : (pageUuid ?? docUuid);
+}
+const stripTags = (s) => s.replace(TAG_RE, "").trim();
+/** `}` inside a label would close the enricher early. */
+const escapeBraces = (s) => s.replace(/\{/g, "&lbrace;").replace(/\}/g, "&rbrace;");
+/**
+ * Rewrite internal links to Foundry UUID enrichers.
+ *
+ * A link the index cannot place is left exactly as it is: an unresolved
+ * wikilink already renders as broken-styled text on the wiki, and turning it
+ * into a UUID that resolves to nothing would look worse in Foundry, not
+ * better.
+ */
+export function rewriteLinks(html, index) {
+    return html.replace(ANCHOR_RE, (whole, attrs, inner) => {
+        const cls = CLASS_RE.exec(attrs)?.[1] ?? "";
+        const card = /\bbases-card\b/.test(cls);
+        if (!card && !/\binternal-link\b/.test(cls))
+            return whole;
+        if (/\bis-unresolved\b/.test(cls))
+            return whole;
+        const href = HREF_RE.exec(attrs)?.[1];
+        if (!href)
+            return whole;
+        const path = pathFromHref(href);
+        if (!path)
+            return whole;
+        const uuid = uuidFor(path, index, /\bfvtt-doc-link\b/.test(cls) ? "doc" : "journal");
+        if (!uuid)
+            return whole;
+        // A card's layout lives in its markup, which an @UUID enricher would
+        // flatten to a text link. A content-link anchor keeps the markup and
+        // Foundry's click handler opens the document all the same.
+        if (card) {
+            return `<a class="${htmlAttr(cls)} content-link" draggable="true" data-link="" data-uuid="${htmlAttr(uuid)}">${inner}</a>`;
+        }
+        const label = escapeBraces(stripTags(inner));
+        return label ? `@UUID[${uuid}]{${label}}` : `@UUID[${uuid}]`;
+    });
+}
+/**
+ * Point media at the variant-scoped file the provider should fetch.
+ *
+ * Where a file lands is a runtime fact — it depends on the world it is being
+ * built into — so the CLI names what it wants rather than guessing a path.
+ */
+export function rewriteAssets(html, variant) {
+    const mark = (p) => `@vaults/${variant}/${p.replace(/^\/+/, "")}`;
+    let out = html.replace(MEDIA_SRC_RE, (whole, tag, before, src, after) => src.startsWith("/") ? `<${tag}${before}src="${htmlAttr(mark(src))}"${after}>` : whole);
+    out = out.replace(ANCHOR_RE, (whole, attrs, inner) => {
+        const cls = CLASS_RE.exec(attrs)?.[1] ?? "";
+        if (!/\bpassthrough-link\b/.test(cls))
+            return whole;
+        const href = HREF_RE.exec(attrs)?.[1];
+        if (!href?.startsWith("/"))
+            return whole;
+        return `<a${attrs.replace(HREF_RE, `href="${htmlAttr(mark(href))}"`)}>${inner}</a>`;
+    });
+    return out;
+}
+/**
+ * Rewrite `@vault/PATH` values inside a document patch to vault references.
+ *
+ * `@vault/` is the authoring form: written by hand in frontmatter, and left in
+ * the Scene sidecars exported from Foundry. It has no variant because the
+ * author is describing their own vault, where there is only one copy of the
+ * file. Resolving it means deciding which role's copy this document reads, and
+ * that is the same decision `visibility` already made for the body.
+ */
+export function rewriteVaultRefs(value, variant) {
+    if (typeof value === "string") {
+        return (value.startsWith("@vault/")
+            ? `@vaults/${variant}/${value.slice("@vault/".length)}`
+            : value);
+    }
+    if (Array.isArray(value))
+        return value.map((v) => rewriteVaultRefs(v, variant));
+    if (value && typeof value === "object") {
+        return Object.fromEntries(Object.entries(value)
+            .map(([k, v]) => [k, rewriteVaultRefs(v, variant)]));
+    }
+    return value;
+}
+/** Everything a body needs before it can be a journal page. */
+/**
+ * Wrap role-gated callouts in Foundry's own secret sections.
+ *
+ * A player-visible document carries the GM's body, so DM callouts reach the
+ * table inside it — hidden by Foundry from anyone below owner, which is what
+ * `<section class="secret">` means to a journal. Hidden, not absent: the text
+ * is in the document's data, the same trade the old sync made.
+ */
+/** Where the element opening at `start` closes, balancing same-name tags. */
+function elementEnd(html, start, tagName) {
+    const tag = new RegExp(`</?${tagName}\\b`, "g");
+    tag.lastIndex = start;
+    let depth = 0;
+    let t;
+    while ((t = tag.exec(html)) !== null) {
+        depth += t[0].startsWith("</") ? -1 : 1;
+        if (depth === 0)
+            return html.indexOf(">", t.index) + 1;
+    }
+    return -1;
+}
+/**
+ * A player-visible document's body: the GM's full rendering inside one
+ * secret section (stripped by Foundry below owner), then the player
+ * variant's in the open. The player gets the actual player render, so no
+ * difference between the two — base rows, transclusions, links — needs to
+ * be found and marked. The module's CSS hides the player copy for the GM.
+ */
+export function dualVariantBody(gmHtml, playerHtml) {
+    const id = createHash("sha1").update(gmHtml).digest("hex").slice(0, 16);
+    return `<section class="secret vaults-gm" id="secret-${id}">${gmHtml}</section>`
+        + `<div class="vaults-player-view">${playerHtml}</div>`;
+}
+/**
+ * Drop every element carrying the `vaults-web-only` class from the Foundry
+ * body; the wiki keeps it. Handlers set it on their wrapper, and a page can
+ * put it on raw HTML of its own.
+ */
+export function stripWebOnly(html) {
+    // The class matched as a whole token: \b treats a hyphen as a boundary, so
+    // it alone would also match "vaults-web-only-not".
+    const open = /<([a-zA-Z][a-zA-Z0-9-]*)\b[^>]*\bclass="(?:[^"]* )?vaults-web-only(?: [^"]*)?"[^>]*>/g;
+    let out = "";
+    let at = 0;
+    let m;
+    while ((m = open.exec(html)) !== null) {
+        if (m.index < at)
+            continue; // nested inside something already dropped
+        const end = VOID_TAGS.has(m[1].toLowerCase()) || m[0].endsWith("/>")
+            ? m.index + m[0].length
+            : elementEnd(html, m.index, m[1]);
+        if (end < 0)
+            continue; // unclosed: leave it, keep looking
+        out += html.slice(at, m.index);
+        at = end;
+        open.lastIndex = end;
+    }
+    return out + html.slice(at);
+}
+const VOID_TAGS = new Set(["img", "br", "hr", "input", "source", "track", "wbr", "embed", "area", "col", "link", "meta"]);
+export function toFoundryHtml(html, index, variant) {
+    return rewriteAssets(rewriteLinks(stripWebOnly(html), index), variant);
+}
+//# sourceMappingURL=foundry-html.js.map

package/dist/foundry-html.js.map

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

package/dist/foundry-importer.bundle.js

@@ -85,6 +85,15 @@ var PACK_KEY = {
   Cards: "cards",
   Playlist: "playlists"
 };
+var CORE_PAGE_TYPES = ["text", "image", "pdf", "video"];
+function journalPageSpec(fm) {
+  const j = fm?.journal;
+  if (j === false) return null;
+  const overlay = j && typeof j === "object" && !Array.isArray(j) ? { ...j } : {};
+  const type = typeof overlay.type === "string" && overlay.type ? overlay.type : "text";
+  delete overlay.type;
+  return { type, overlay, dropsBody: type !== "text" };
+}
 var BLANK_DOC_TYPES = [
   "Actor",
   "Item",
@@ -915,6 +924,28 @@ function buildFolderInfo(mdPaths) {
 function isIndexFile(filename) {
   return filename.replace(/\.md$/i, "") === INDEX_BASENAME;
 }
+function resolvePageType(want, path) {
+  if (want === "text") return "text";
+  const known = /* @__PURE__ */ new Set([
+    ...CORE_PAGE_TYPES,
+    ...game.documentTypes?.JournalEntryPage ?? []
+  ]);
+  if (known.has(want)) return want;
+  console.warn(
+    `Vaults | ${path}: this world has no "${want}" journal page type (${game.system?.id ?? "no system"} provides ${[...known].join(", ")}). Imported as a text page instead.`
+  );
+  return "text";
+}
+function deepMergePage(target, patch) {
+  for (const [k, v] of Object.entries(patch)) {
+    if (v && typeof v === "object" && !Array.isArray(v) && target[k] && typeof target[k] === "object" && !Array.isArray(target[k])) {
+      deepMergePage(target[k], v);
+    } else {
+      target[k] = v;
+    }
+  }
+  return target;
+}
 async function upsertFile(target, vault, path, body, index, meta, folderInfo, mediaRefs) {
   let html = await transformHtmlForFoundry(vault, body, index, mediaRefs);
   html = await appendInstanceDocLink(html, vault, path, meta);
@@ -932,15 +963,19 @@ async function upsertFile(target, vault, path, body, index, meta, folderInfo, me
   const pId = typeof idOverride === "string" && idOverride ? idOverride : await pageId(vault.id, path);
   const pageOwnership = pageOwnershipLevelFor(vault, meta?.role);
   const flags = { [MODULE_ID]: { vaultId: vault.id, path } };
+  const spec = journalPageSpec(meta?.foundry);
+  const type = resolvePageType(spec.type, path);
   const pageData = {
     _id: pId,
     name: pageName,
-    type: "text",
-    text: {
+    type,
+    // A page whose content is its `src` has nowhere to put an article, so the
+    // body is dropped rather than written somewhere it will not be read.
+    ...type === "text" ? { text: {
       content: html,
       format: 1
       /* HTML */
-    },
+    } } : {},
     sort: isIndexFile(filename) ? 0 : NON_INDEX_SORT_BASE,
     flags,
     // Ownership is set on the *page*, not the parent entry: in the
@@ -952,6 +987,7 @@ async function upsertFile(target, vault, path, body, index, meta, folderInfo, me
     // page in it). See reconcileOwnership below.
     ...pageOwnership !== null ? { ownership: { default: pageOwnership } } : {}
   };
+  if (Object.keys(spec.overlay).length > 0) deepMergePage(pageData, spec.overlay);
   const existing = await target.get("JournalEntry", eId);
   if (existing) {
     const pages = (existing.pages ?? []).filter((pg) => pg._id !== pId);

package/dist/foundry-meta.js

@@ -1,50 +1,26 @@
-// Everything the CLI knows about the `foundry:` frontmatter block.
-//
-// Kept in one file because this is a shared contract, not a private detail:
-// foundry/scripts/ reads exactly these keys back out of the manifest, and the
-// two sides disagreeing is how `base: actor:npc` once created an Actor while
-// every inbound wikilink addressed a nonexistent "actor". The doc-type rule
-// here is held to foundry/scripts/foundry-base.mjs by
-// cli/test/foundry-base-conformance.test.ts.
+// What the CLI knows about the `foundry:` frontmatter block: which document a
+// `source` names, and whether two pages are fighting over the same one.
 import { readFile } from "node:fs/promises";
 import { join } from "node:path";
-/**
- * Whether a `foundry.base` will actually produce a document.
- *
- * Both forms do, for every type vaults can instantiate. This used to be
- * narrower — the module cloned from a UUID only for Actor and Item, so a lone
- * `Compendium.<pkg>.<pack>.Scene.<id>` created nothing and warning about a
- * collision would have described documents that never exist. That restriction
- * is gone (map packs ship their content as compendium Scenes, and those were
- * all being skipped), so a well-formed base always produces a document and
- * the only question left is whether the type is one we recognise.
- *
- * All entries name the same type by the time this runs, so `docType` answers
- * for the whole list.
- */
-function willInstantiate(_specs, docType) {
-    return canonicalFoundryType(docType) !== null;
-}
+import { DOC_TYPES } from "./foundry-types.js";
+import { documentFolder, documentTypeOf, firstBase } from "./foundry-grafts.js";
 export function warnFoundryDocCollisions(pages) {
     const seen = new Map(); // key → first page path
     for (const p of pages) {
         const fo = p.frontmatter?.["foundry"];
         if (!fo || typeof fo !== "object" || Array.isArray(fo))
             continue;
-        const base = fo["base"];
-        const specs = (Array.isArray(base) ? base : [base])
-            .filter((x) => typeof x === "string" && x.length > 0);
-        if (specs.length === 0)
+        if (fo["sync"] === false)
             continue;
-        const docType = foundryBaseDocName(specs[0]);
-        if (!docType)
+        const spec = firstBase(fo["source"]);
+        if (!spec)
             continue;
-        if (!willInstantiate(specs, docType))
+        // The same reading the emitter uses, so a warning never describes a
+        // document that will not exist: a type with no pack produces nothing.
+        const docType = documentTypeOf(spec);
+        if (!docType || !DOC_TYPES[docType])
             continue;
-        const override = fo["folder"];
-        const folder = typeof override === "string" && override.trim()
-            ? override.trim().replace(/^\/+|\/+$/g, "")
-            : p.path.split("/").slice(0, -1).join("/");
+        const folder = documentFolder({ path: p.path, foundry: fo });
         const name = p.title || p.path.split("/").pop().replace(/\.md$/i, "");
         const key = `${docType}\u0000${folder}\u0000${name}`;
         const previous = seen.get(key);
@@ -57,208 +33,7 @@ export function warnFoundryDocCollisions(pages) {
             + `separate them with foundry.folder.`);
     }
 }
-/**
- * The document type a `foundry.base` spec names, read off the string without
- * resolving anything. Every UUID form puts the type second-to-last
- * (`Actor.<id>`, `Compendium.<pkg>.<pack>.Actor.<id>`), and a blank-doc spec
- * (`Actor:npc`) carries it outright. `links.mjs` derives it the same way, so
- * both sides agree on where a wikilink to the page points.
- */
-export function foundryBaseDocName(spec) {
-    // A Moulinette reference names no type. Checked before the UUID rule
-    // because its file segment ends in ".json", which the dot test would
-    // otherwise read as a UUID. The type comes from another entry in the list;
-    // normalizeFoundryBase makes sure one is there.
-    if (spec.startsWith("@moulinette/"))
-        return null;
-    if (spec.includes(".")) {
-        const parts = spec.split(".");
-        if (parts.length < 2)
-            return null;
-        const raw = parts[parts.length - 2];
-        // Unknown types pass through: vaults can't instantiate a Combat, but
-        // Foundry may still resolve the UUID, and reporting the type beats
-        // claiming the spec names none.
-        return canonicalFoundryType(raw) ?? raw ?? null;
-    }
-    // Blank-document form. An unrecognised type is not a base at all, so it is
-    // rejected rather than passed through — matching the Foundry module, which
-    // would create nothing for it.
-    return canonicalFoundryType(spec.split(":")[0]);
-}
-/**
- * Fold a type segment to its canonical spelling, or null if vaults doesn't
- * instantiate it.
- *
- * Case matters downstream and is hand-typed here: `base: actor:npc` is
- * supported, but Foundry's `@UUID[...]` enricher does a case-sensitive
- * lookup. Returning "actor" made the CLI treat it as a different type from
- * "Actor" — so a list mixing the two failed the same-type check and had its
- * whole foundry.base dropped. Kept in step with
- * foundry/scripts/foundry-base.mjs by cli/test/foundry-base-conformance.test.ts.
- */
-export function canonicalFoundryType(raw) {
-    if (!raw)
-        return null;
-    return FOUNDRY_BLANK_DOC_TYPES.find((t) => t.toLowerCase() === raw.toLowerCase()) ?? null;
-}
-export const FOUNDRY_BLANK_DOC_TYPES = [
-    "Actor", "Item", "Scene", "JournalEntry",
-    "RollTable", "Macro", "Cards", "Playlist",
-];
-/**
- * Validate `foundry.base` and normalize it for the manifest: a single string
- * stays a string (so an older Foundry module keeps working), a list of two or
- * more stays a list. Returns null when the value can't be used, having said
- * why — the build continues, and the page syncs as a journal with no document.
- *
- * Every entry must name the same document type. The module reads that type
- * off the spec rather than off a resolved template, and `links.mjs` has to
- * reach the same answer with no lookup at all, so a list that disagrees with
- * itself has no single answer to give.
- */
-function normalizeFoundryBase(base, pagePath) {
-    const raw = Array.isArray(base) ? base : [base];
-    const specs = [];
-    for (const entry of raw) {
-        if (typeof entry !== "string" || entry.trim().length === 0) {
-            console.warn(`  ${pagePath}: foundry.base entries must be non-empty strings (a UUID like `
-                + `"Compendium.<pkg>.<pack>.Actor.<id>", or a type like "Actor:npc"); `
-                + `got ${entry === null ? "null" : typeof entry}. Ignoring foundry.base — this page `
-                + `will sync as a journal but create no document.`);
-            return null;
-        }
-        specs.push(entry.trim());
-    }
-    if (specs.length === 0) {
-        console.warn(`  ${pagePath}: foundry.base is an empty list; ignoring.`);
-        return null;
-    }
-    const types = new Map(); // docName → first spec that named it
-    for (const spec of specs) {
-        // A Moulinette entry is deliberately typeless: only the reader's own
-        // library knows whether that asset is a Scene or an Actor, and this runs
-        // at build time with no library to ask.
-        if (spec.startsWith("@moulinette/"))
-            continue;
-        const docName = foundryBaseDocName(spec);
-        if (!docName) {
-            console.warn(`  ${pagePath}: foundry.base entry "${spec}" names no document type; ignoring foundry.base.`);
-            return null;
-        }
-        if (!types.has(docName))
-            types.set(docName, spec);
-    }
-    if (types.size === 0) {
-        console.warn(`  ${pagePath}: foundry.base names only Moulinette references, which carry no document `
-            + `type. Add an entry naming the type (e.g. "Scene") — it is also what the page falls `
-            + `back to for a reader without that pack. Ignoring foundry.base.`);
-        return null;
-    }
-    if (types.size > 1) {
-        const detail = [...types].map(([t, spec]) => `${t} (from "${spec}")`).join(", ");
-        console.warn(`  ${pagePath}: every foundry.base entry must name the same document type, got ${detail}. `
-            + `Ignoring foundry.base — this page will sync as a journal but create no document.`);
-        return null;
-    }
-    // A list whose last entry is a UUID can still fail on a world that lacks
-    // every package named. A blank-doc tail is what makes the chain total.
-    const last = specs[specs.length - 1];
-    if (specs.length > 1 && (last.includes(".") || last.startsWith("@moulinette/"))) {
-        console.warn(`  ${pagePath}: foundry.base list ends with "${last}", so it can still resolve to nothing. `
-            + `End with a blank-document entry (e.g. "${[...types.keys()][0]}:npc" or "${[...types.keys()][0]}") `
-            + `to guarantee a document.`);
-    }
-    return specs.length === 1 ? specs[0] : specs;
-}
-export async function collectBodyMeta(p, vaultPath) {
-    const fm = p.frontmatter ?? {};
-    const out = { role: p.role };
-    const basename = p.path.split("/").pop().replace(/\.md$/i, "");
-    if (p.title && p.title !== basename)
-        out.title = p.title;
-    const fo = fm["foundry"];
-    if (fo && typeof fo === "object" && !Array.isArray(fo)) {
-        const block = {};
-        // `base` is one spec, or a priority list the module tries in order so a
-        // vault degrades across worlds with different content installed. A
-        // malformed base is dropped with a warning rather than failing the build,
-        // same as foundry.id below. Silence here is worse than it looks: the
-        // module never receives the key, so it can't report the page either, and
-        // the page syncs as a journal with no Actor/Item and no explanation.
-        const base = fo["base"];
-        if (base !== undefined && base !== null) {
-            const normalized = normalizeFoundryBase(base, p.path);
-            if (normalized !== null)
-                block.base = normalized;
-        }
-        const embed = fo["embed"];
-        if (typeof embed === "boolean")
-            block.embed = embed;
-        // foundry.sync: false keeps the page out of Foundry altogether — no
-        // JournalEntryPage, no derived doc. The page still renders on the wiki.
-        // Unlike `embed`, which only suppresses the article inside a derived
-        // doc's description, this drops the page from the sync set entirely.
-        const sync = fo["sync"];
-        if (typeof sync === "boolean")
-            block.sync = sync;
-        // foundry.journal: false makes the derived doc without the JournalEntryPage
-        // that normally accompanies it. For a page that exists to carry a Scene or
-        // an Actor and has no article worth reading in the sidebar.
-        const journal = fo["journal"];
-        if (typeof journal === "boolean")
-            block.journal = journal;
-        // foundry.link: "doc" makes wikilinks to this page resolve to the document
-        // it instantiates rather than to its journal page. Implied by
-        // `journal: false`, where there is no journal page to link to.
-        const link = fo["link"];
-        if (link === "doc" || link === "journal")
-            block.link = link;
-        const data = fo["data"];
-        if (data && typeof data === "object" && !Array.isArray(data))
-            block.data = data;
-        // foundry.folder: a "/"-separated folder path the instantiated doc is
-        // filed under, nested inside the vault's own sidebar folder. Absent
-        // means the vault folder itself, which is where everything used to land.
-        const folder = fo["folder"];
-        if (typeof folder === "string" && folder.trim().length > 0)
-            block.folder = folder.trim();
-        // foundry.id: an explicit Foundry document id for this page. When set,
-        // overrides the SHA1-derived id used for both the JournalEntryPage and
-        // (if foundry.base is present) the instantiated derived doc. Lets users
-        // hardcode UUIDs that other Foundry-side code (macros, scene flags,
-        // module integrations) needs to reference. Foundry ids are 16 chars from
-        // [A-Za-z0-9]; a malformed value is dropped with a warning rather than
-        // failing the build.
-        const idVal = fo["id"];
-        if (typeof idVal === "string") {
-            const trimmed = idVal.trim();
-            if (FOUNDRY_ID_RE.test(trimmed))
-                block.id = trimmed;
-            else if (trimmed.length > 0) {
-                console.warn(`  ${p.path}: foundry.id "${trimmed}" is not a valid Foundry id (16 chars [A-Za-z0-9]); ignoring`);
-            }
-        }
-        // foundry.data_json: vault-relative path to a JSON file. Read + parse
-        // at build time and inline into the meta as `data_json`. The Foundry
-        // module deep-merges it onto the base doc BEFORE foundry.data, so a
-        // user can layer hand-tuned overrides on top of an exported sheet.
-        // Folding the parsed object into meta means the body-row hash already
-        // changes when the JSON content does — no separate change-detection.
-        const dataJsonPath = fo["data_json"];
-        if (typeof dataJsonPath === "string" && dataJsonPath.trim().length > 0) {
-            const parsed = await loadDataJson(vaultPath, dataJsonPath.trim(), p.path);
-            if (parsed !== null)
-                block.data_json = parsed;
-        }
-        if (Object.keys(block).length > 0)
-            out.foundry = block;
-    }
-    if (p.coverImage)
-        out.image = p.coverImage;
-    return out;
-}
-/** Read + parse a vault-relative JSON file referenced by `foundry.data_json`.
+/** Read + parse a vault-relative JSON file referenced by `foundry.patch_json`.
  *  Warns on missing / unparseable file and returns null so the page renders
  *  without the overlay rather than failing the build. */
 export async function loadDataJson(vaultPath, relPath, pagePath) {
@@ -270,15 +45,12 @@ export async function loadDataJson(vaultPath, relPath, pagePath) {
     catch (err) {
         const code = err.code;
         if (code === "ENOENT") {
-            console.warn(`  ${pagePath}: foundry.data_json "${relPath}" not found, skipping`);
+            console.warn(`  ${pagePath}: foundry.patch_json "${relPath}" not found, skipping`);
         }
         else {
-            console.warn(`  ${pagePath}: foundry.data_json "${relPath}" failed to parse: ${err.message}`);
+            console.warn(`  ${pagePath}: foundry.patch_json "${relPath}" failed to parse: ${err.message}`);
         }
         return null;
     }
 }
-/** Foundry document ids: exactly 16 chars from [A-Za-z0-9]. Validated when
- *  authors set `foundry.id` to override the SHA1-derived default. */
-const FOUNDRY_ID_RE = /^[A-Za-z0-9]{16}$/;
 //# sourceMappingURL=foundry-meta.js.map

package/dist/foundry-meta.js.map

@@ -1 +1 @@
-{"version":3,"file":"foundry-meta.js","sourceRoot":"","sources":["../src/foundry-meta.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"foundry-meta.js","sourceRoot":"","sources":["../src/foundry-meta.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,wEAAwE;AAExE,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAGhF,MAAM,UAAU,wBAAwB,CAAC,KAAiB;IACxD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAkB,CAAC,CAAC,wBAAwB;IAChE,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,MAAM,EAAE,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC,SAAS,CAAC,CAAC;QACtC,IAAI,CAAC,EAAE,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;YAAE,SAAS;QACjE,IAAK,EAA8B,CAAC,MAAM,CAAC,KAAK,KAAK;YAAE,SAAS;QAChE,MAAM,IAAI,GAAG,SAAS,CAAE,EAA8B,CAAC,QAAQ,CAAC,CAAC,CAAC;QAClE,IAAI,CAAC,IAAI;YAAE,SAAS;QACpB,oEAAoE;QACpE,sEAAsE;QACtE,MAAM,OAAO,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;QACrC,IAAI,CAAC,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;YAAE,SAAS;QAE9C,MAAM,MAAM,GAAG,cAAc,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,EAAyB,EAAE,CAAC,CAAC;QACpF,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAG,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QAEvE,MAAM,GAAG,GAAG,GAAG,OAAO,SAAS,MAAM,SAAS,IAAI,EAAE,CAAC;QACrD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC/B,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;YACtB,SAAS;QACX,CAAC;QACD,OAAO,CAAC,IAAI,CACV,KAAK,CAAC,CAAC,IAAI,oBAAoB,OAAO,WAAW,IAAI,wBAAwB;cAC3E,YAAY,MAAM,IAAI,cAAc,UAAU,QAAQ,oBAAoB;cAC1E,oCAAoC,CACvC,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;yDAEyD;AACzD,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,SAAiB,EACjB,OAAe,EACf,QAAgB;IAEhB,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACrC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACxC,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAY,CAAC;IACpC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,GAAI,GAA6B,CAAC,IAAI,CAAC;QACjD,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;YACtB,OAAO,CAAC,IAAI,CAAC,KAAK,QAAQ,yBAAyB,OAAO,uBAAuB,CAAC,CAAC;QACrF,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,IAAI,CAAC,KAAK,QAAQ,yBAAyB,OAAO,sBAAuB,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;QAC5G,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/foundry-module-journal.js

@@ -70,6 +70,20 @@ export function transformForModule(html, moduleId, targets, assets) {
  * an entry named for the module — the same shape the sync path produces, where
  * a directory becomes an entry and its files become that entry's pages.
  */
+/** Deep-merge an overlay onto page data, arrays and scalars replacing. */
+function deepMergePage(target, patch) {
+    for (const [k, v] of Object.entries(patch)) {
+        const cur = target[k];
+        if (v && typeof v === "object" && !Array.isArray(v)
+            && cur && typeof cur === "object" && !Array.isArray(cur)) {
+            deepMergePage(cur, v);
+        }
+        else {
+            target[k] = v;
+        }
+    }
+    return target;
+}
 export function buildJournalEntries(sources, ns, rootName, stats) {
     const byFolder = new Map();
     for (const s of sources) {
@@ -86,18 +100,25 @@ export function buildJournalEntries(sources, ns, rootName, stats) {
             name: folder ? folder.split("/").pop() : rootName,
             pages: pages.map((p, i) => {
                 const pid = journalPageId(ns, p.path);
-                return {
+                const type = p.spec?.type ?? "text";
+                const page = {
                     _id: pid,
                     name: p.title,
-                    type: "text",
+                    type,
                     title: { show: true, level: 1 },
-                    text: { format: 1, content: p.html },
+                    // A page whose content is its `src` has nowhere to put an article.
+                    // Unlike sync, the compiler cannot degrade an unknown type: it does
+                    // not know the system of the world this module will be installed in.
+                    ...(type === "text" ? { text: { format: 1, content: p.html } } : {}),
                     sort: (i + 1) * 100000,
                     ownership: { default: -1 },
                     flags: {},
                     _stats: stats,
                     _key: `!journal.pages!${id}.${pid}`,
                 };
+                if (p.spec && Object.keys(p.spec.overlay).length > 0)
+                    deepMergePage(page, p.spec.overlay);
+                return page;
             }),
             folder: null,
             sort: 0,