@wizzlethorpe/vaults 0.13.2 → 0.14.0

package/dist/foundry-importer.js

@@ -1,17 +1,14 @@
 // Build helper: the Foundry-side importer is pre-bundled at CLI build time
 // (see scripts/bundle-importer.mjs) into `dist/foundry-importer.bundle.js`,
 // which ships inside the npm package. At deploy time we copy that bundle to
-// `_foundry/importer.js` and emit a `_foundry/version.json` sidecar carrying
-// `{ version, sha256 }` so the Foundry host can detect skew before evaluating.
+// `_foundry/importer.js`, which the Foundry host fetches and evaluates.
 //
 // Bundling ahead of publish (not here) means the installed CLI never runs
 // esbuild on the user's machine and doesn't need the foundry/ source tree,
 // which isn't part of the npm package.
-import { createHash } from "node:crypto";
 import { mkdir, readFile, writeFile } from "node:fs/promises";
 import { basename, dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
-import { CLI_VERSION } from "./version.js";
 // scripts/bundle-importer.mjs always emits the bundle into dist/. This module
 // runs from dist/ once published, but from src/ under tsx (tests) — resolve to
 // dist/ either way.
@@ -19,17 +16,15 @@ const here = dirname(fileURLToPath(import.meta.url));
 const distDir = basename(here) === "src" ? join(here, "..", "dist") : here;
 const BUNDLE_PATH = join(distDir, "foundry-importer.bundle.js");
 /**
- * Write `_foundry/importer.js` + `_foundry/version.json` into the deploy.
+ * Write `_foundry/importer.js` into the deploy.
  * Called from build.ts after the variant outputs are in place — the
  * bundle is a shared root-level asset (not per-variant), since it has
  * no role-gated content.
  */
 export async function writeFoundryImporter(outputDir) {
     const source = await readFile(BUNDLE_PATH, "utf8");
-    const sha256 = createHash("sha256").update(source).digest("hex");
     const dir = join(outputDir, "_foundry");
     await mkdir(dir, { recursive: true });
     await writeFile(join(dir, "importer.js"), source);
-    await writeFile(join(dir, "version.json"), JSON.stringify({ version: CLI_VERSION, sha256 }, null, 2));
 }
 //# sourceMappingURL=foundry-importer.js.map

package/dist/foundry-importer.js.map

@@ -1 +1 @@
-{"version":3,"file":"foundry-importer.js","sourceRoot":"","sources":["../src/foundry-importer.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,4EAA4E;AAC5E,4EAA4E;AAC5E,6EAA6E;AAC7E,+EAA+E;AAC/E,EAAE;AACF,0EAA0E;AAC1E,2EAA2E;AAC3E,uCAAuC;AAEvC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,8EAA8E;AAC9E,+EAA+E;AAC/E,oBAAoB;AACpB,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AACrD,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC3E,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,EAAE,4BAA4B,CAAC,CAAC;AAEhE;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,SAAiB;IAC1D,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IACnD,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACjE,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IACxC,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtC,MAAM,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,aAAa,CAAC,EAAE,MAAM,CAAC,CAAC;IAClD,MAAM,SAAS,CACb,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,EACzB,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAC1D,CAAC;AACJ,CAAC"}
+{"version":3,"file":"foundry-importer.js","sourceRoot":"","sources":["../src/foundry-importer.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,4EAA4E;AAC5E,4EAA4E;AAC5E,wEAAwE;AACxE,EAAE;AACF,0EAA0E;AAC1E,2EAA2E;AAC3E,uCAAuC;AAEvC,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,8EAA8E;AAC9E,+EAA+E;AAC/E,oBAAoB;AACpB,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AACrD,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC3E,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,EAAE,4BAA4B,CAAC,CAAC;AAEhE;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,SAAiB;IAC1D,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IACnD,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IACxC,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtC,MAAM,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,aAAa,CAAC,EAAE,MAAM,CAAC,CAAC;AACpD,CAAC"}

package/dist/foundry-meta.js

@@ -0,0 +1,284 @@
+// 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.
+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;
+}
+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)
+            continue;
+        const docType = foundryBaseDocName(specs[0]);
+        if (!docType)
+            continue;
+        if (!willInstantiate(specs, 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 name = p.title || p.path.split("/").pop().replace(/\.md$/i, "");
+        const key = `${docType}\u0000${folder}\u0000${name}`;
+        const previous = seen.get(key);
+        if (previous === undefined) {
+            seen.set(key, p.path);
+            continue;
+        }
+        console.warn(`  ${p.path}: would create a ${docType} named '${name}' in the same Foundry `
+            + `folder ('${folder || "(vault root)"}') as '${previous}'. Rename one, or `
+            + `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`.
+ *  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) {
+    const abs = join(vaultPath, relPath);
+    try {
+        const raw = await readFile(abs, "utf8");
+        return JSON.parse(raw);
+    }
+    catch (err) {
+        const code = err.code;
+        if (code === "ENOENT") {
+            console.warn(`  ${pagePath}: foundry.data_json "${relPath}" not found, skipping`);
+        }
+        else {
+            console.warn(`  ${pagePath}: foundry.data_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

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

package/dist/foundry-module-journal.js

@@ -0,0 +1,112 @@
+// Build a module's JournalEntry pack from the pages the wiki already rendered.
+//
+// Mirrors the sync model exactly: one JournalEntry per vault directory, every
+// .md file in that directory an embedded JournalEntryPage. Matching it is the
+// point — a document's description embeds a journal page, and if the module
+// laid its journals out differently, the same vault would produce two
+// different-shaped things depending on how a reader got it.
+//
+// The HTML is the wiki's own rendered body, not a second rendering of the
+// markdown. That matters: a page's battlemap, statblock and `fm:` values only
+// exist in the rendered output, so re-rendering the source with a plain
+// markdown parser would quietly ship a different article than the one on the
+// site.
+import { createHash } from "node:crypto";
+/** The sync path's id scheme, namespaced to the module instead of the vault. */
+function det(kind, key) {
+    return createHash("sha1").update(`vaults:${kind}:${key}`).digest("hex").slice(0, 16);
+}
+export function folderOfPath(path) {
+    const i = path.lastIndexOf("/");
+    return i < 0 ? "" : path.slice(0, i);
+}
+/** One entry per directory, so every page in a folder shares an id. */
+export const journalEntryId = (ns, path) => det("entry", `${ns}:${folderOfPath(path)}`);
+export const journalPageId = (ns, path) => det("page", `${ns}:${path}`);
+/**
+ * Rewrite the wiki's HTML into something a Foundry journal can render.
+ *
+ * Two things have to change and the rest is already fine. An internal link is
+ * a site path that means nothing inside Foundry, so it becomes a `@UUID`
+ * enricher pointing at the compendium page. A media src is a deploy-absolute
+ * path, so it becomes a module-relative one and the file is bundled.
+ *
+ * Deliberately narrower than the sync path's transform, which also converts
+ * role-gated callouts into Foundry secret blocks. A module carries only one
+ * role's pages, so there is no gated content inside them to convert.
+ */
+export function transformForModule(html, moduleId, targets, assets) {
+    // An internal link the renderer marked. Attribute order is not fixed — the
+    // renderer emits `class` before `href` in some cases and after in others —
+    // so match the whole tag and read the attributes out of it rather than
+    // assuming a shape. Anchoring on `href` first silently missed every link
+    // that happened to be written the other way round.
+    let out = html.replace(/<a\s+([^>]*)>([\s\S]*?)<\/a>/g, (whole, attrs, label) => {
+        if (!/\bclass="[^"]*\binternal\b/.test(attrs))
+            return whole;
+        const href = /href="([^"]*)"/.exec(attrs)?.[1];
+        if (!href || !href.startsWith("/"))
+            return whole;
+        const key = decodeURIComponent(href.replace(/^\//, "").split("#")[0] ?? "");
+        const target = targets.get(key) ?? targets.get(`${key}.md`);
+        if (!target)
+            return label; // page not in the module: keep the words, drop the dead link
+        // Strip tags from the label: an enricher's {…} is plain text.
+        const text = label.replace(/<[^>]+>/g, "").trim();
+        return `@UUID[${target.uuid}]{${text}}`;
+    });
+    // src="/attachments/x.webp" — deploy-absolute, meaningless in a module.
+    out = out.replace(/(\ssrc=")\/([^"]+)"/g, (_whole, prefix, path) => {
+        const rel = decodeURIComponent(path);
+        assets.add(rel);
+        return `${prefix}modules/${moduleId}/assets/${rel}"`;
+    });
+    return out;
+}
+/**
+ * Group pages into one JournalEntry per directory.
+ *
+ * The entry's name is the directory's own name, and a root-level page lands in
+ * 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.
+ */
+export function buildJournalEntries(sources, ns, rootName, stats) {
+    const byFolder = new Map();
+    for (const s of sources) {
+        const folder = folderOfPath(s.path);
+        const list = byFolder.get(folder) ?? [];
+        list.push(s);
+        byFolder.set(folder, list);
+    }
+    const entries = [];
+    for (const [folder, pages] of [...byFolder].sort(([a], [b]) => a.localeCompare(b))) {
+        const id = journalEntryId(ns, pages[0].path);
+        entries.push({
+            _id: id,
+            name: folder ? folder.split("/").pop() : rootName,
+            pages: pages.map((p, i) => {
+                const pid = journalPageId(ns, p.path);
+                return {
+                    _id: pid,
+                    name: p.title,
+                    type: "text",
+                    title: { show: true, level: 1 },
+                    text: { format: 1, content: p.html },
+                    sort: (i + 1) * 100000,
+                    ownership: { default: -1 },
+                    flags: {},
+                    _stats: stats,
+                    _key: `!journal.pages!${id}.${pid}`,
+                };
+            }),
+            folder: null,
+            sort: 0,
+            flags: {},
+            ownership: { default: 0 },
+            _stats: stats,
+            _key: `!journal!${id}`,
+        });
+    }
+    return entries;
+}
+//# sourceMappingURL=foundry-module-journal.js.map

package/dist/foundry-module-journal.js.map

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

package/dist/foundry-module-render.js

@@ -0,0 +1,75 @@
+// Render a vault page's markdown body into Foundry-flavoured description HTML,
+// and build a pack's compendium folders.
+//
+// Ported from the standalone compiler this replaced, so `vaults build --module` can
+// replace it. A vault body is Obsidian/vaults markdown; a Foundry sheet wants
+// HTML with native inline rolls and Compendium @UUID cross-links.
+import { createHash } from "node:crypto";
+import { marked } from "marked";
+// Fenced blocks that are wiki chrome: the Foundry sheet renders the same
+// mechanics natively, so carrying the block's source into a description would
+// show the reader a code listing of something already on their screen.
+const HANDLER_FENCES = new Set([
+    "spell-card", "item-card", "statblock", "statblock-fm", "gallery", "battlemap",
+    "rolltable", "dice", "download", "foundry-manifest",
+]);
+function dropHandlerFences(md) {
+    return md.replace(/^```([\w-]+)[^\n]*\n[\s\S]*?^```[ \t]*$/gm, (block, lang) => HANDLER_FENCES.has(lang) ? "" : block);
+}
+/** `dice: 2d6+1` in backticks becomes dnd5e's native inline roll. */
+function diceToRolls(md) {
+    return md.replace(/`dice:\s*([^`]+?)`/gi, (_m, f) => `[[/r ${f.trim()}]]`);
+}
+function rewriteWikilinks(md, index) {
+    return md.replace(/\[\[([^\]|#]+)(?:#[^\]|]+)?(?:\|([^\]]+))?\]\]/g, (_m, target, label) => {
+        const entry = index.get(target.trim().toLowerCase());
+        const text = (label ?? target).trim();
+        return entry ? `@UUID[${entry.uuid}]{${text}}` : text;
+    });
+}
+/**
+ * Wikilinks are rewritten before dice, not after: at that point a `dice:` span
+ * is still inside backticks, so the wikilink pass cannot mistake the `[[/r …]]`
+ * this would otherwise have produced for a link of its own.
+ */
+export function renderBody(md, index) {
+    let out = dropHandlerFences(md);
+    out = rewriteWikilinks(out, index);
+    out = diceToRolls(out);
+    return marked.parse(out, { async: false }).trim();
+}
+function folderId(packName, pathStr) {
+    return createHash("sha1").update(`folder:${packName}:${pathStr}`).digest("base64")
+        .replace(/[^A-Za-z0-9]/g, "").slice(0, 16).padEnd(16, "0");
+}
+/**
+ * Build `!folders!` documents for a pack, plus the leaf folder each entry
+ * belongs in. `fvtt package pack` turns these keys into real compendium
+ * folders, so a pack of 500 items is browsable rather than one flat list.
+ */
+export function buildFolders(entries, packName, docType, stats) {
+    const docs = new Map();
+    const leafFor = new Map();
+    const ensure = (segments) => {
+        let parent = null;
+        let pathStr = "";
+        for (const seg of segments) {
+            pathStr = pathStr ? `${pathStr}/${seg}` : seg;
+            if (!docs.has(pathStr)) {
+                const id = folderId(packName, pathStr);
+                docs.set(pathStr, {
+                    _id: id, name: seg, type: docType, folder: parent,
+                    sort: 0, color: null, sorting: "a", flags: {},
+                    _stats: stats, _key: `!folders!${id}`,
+                });
+            }
+            parent = docs.get(pathStr)._id;
+        }
+        return parent;
+    };
+    for (const e of entries) {
+        leafFor.set(e.key, ensure(e.folderPath.split("/").map((s) => s.trim()).filter(Boolean)));
+    }
+    return { folderDocs: [...docs.values()], leafFor };
+}
+//# sourceMappingURL=foundry-module-render.js.map

package/dist/foundry-module-render.js.map

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