@wizzlethorpe/vaults 0.7.0 → 0.7.1

package/dist/render/handlers/builtin/battlemap.js

@@ -0,0 +1,199 @@
+// Built-in `battlemap` code-block handler.
+//
+// Renders a layered, multi-level battle map with controls to switch level,
+// toggle a grid overlay, and download the current level as a PNG. Syntax:
+//
+//   ```battlemap
+//   grid: 140                 # px per grid cell at the image's native size (optional)
+//   default_level: 1          # 0-based index of the level shown first (optional)
+//   name: Wizard Prison       # download-filename prefix (optional)
+//   levels:
+//     - name: Rock
+//       layers:               # composited bottom-to-top
+//         - "attachments/foundry/wizard-prison/...-Rock-...webp"
+//     - name: First Floor
+//       layers:
+//         - "attachments/foundry/wizard-prison/...-Rock-...webp"
+//         - "attachments/foundry/wizard-prison/...-First Floor-...webp"
+//   ```
+//
+// The browser runtime (BATTLEMAP_RUNTIME below) ships as a built-in asset
+// concatenated into _handlers.js; styles go into _handlers.css.
+//
+// Layer paths are vault-relative and resolve to the absolute served URL. They
+// must also be staged into the deploy — true when the page already references
+// them (e.g. a Scene's foundry.data_json), which is the common case.
+import yaml from "js-yaml";
+import { htmlEscape } from "../../../escape.js";
+import { registerBuiltinAssets } from "../assets.js";
+/** Vault-relative path -> absolute, percent-encoded served URL. */
+function servedSrc(path) {
+    return "/" + path.replace(/^\/+/, "").split("/").map(encodeURIComponent).join("/");
+}
+function errorBox(message) {
+    return { html: `<div class="vaults-bm-error">${htmlEscape(message)}</div>` };
+}
+export const battlemapHandler = {
+    codeBlock: "battlemap",
+    render(content) {
+        let spec;
+        try {
+            spec = (yaml.load(content) ?? {});
+        }
+        catch {
+            return errorBox("battlemap: could not parse YAML");
+        }
+        const levels = (Array.isArray(spec.levels) ? spec.levels : [])
+            .map((lv) => ({
+            name: typeof lv?.name === "string" ? lv.name : "",
+            layers: Array.isArray(lv?.layers)
+                ? lv.layers.filter((s) => typeof s === "string" && s.length > 0)
+                : [],
+        }))
+            .filter((lv) => lv.layers.length > 0);
+        if (levels.length === 0)
+            return errorBox("battlemap: no levels with layers");
+        const grid = Number(spec.grid) > 0 ? Number(spec.grid) : 0;
+        let active = Number.isInteger(Number(spec.default_level)) ? Number(spec.default_level) : 0;
+        if (active < 0 || active >= levels.length)
+            active = 0;
+        const mapName = typeof spec.name === "string" ? spec.name.trim() : "";
+        const levelBtns = levels
+            .map((lv, i) => `<button type="button" class="vaults-bm-level" role="tab" data-level="${i}"`
+            + ` aria-selected="${i === active ? "true" : "false"}">${htmlEscape(lv.name || `Level ${i + 1}`)}</button>`)
+            .join("");
+        const tools = (grid ? `<button type="button" class="vaults-bm-grid" aria-pressed="false" title="Toggle grid">Grid</button>` : "")
+            + `<button type="button" class="vaults-bm-download" title="Download this level as an image">Download</button>`;
+        const panes = levels
+            .map((lv, i) => {
+            const imgs = lv.layers
+                .map((p, j) => `<img src="${servedSrc(p)}" alt="${htmlEscape(lv.name)} layer ${j + 1}" loading="lazy">`)
+                .join("");
+            return `<div class="vaults-bm-pane${i === active ? " is-active" : ""}" data-level="${i}"`
+                + ` data-name="${htmlEscape(lv.name)}">${imgs}</div>`;
+        })
+            .join("");
+        const overlay = grid ? `<div class="vaults-bm-grid-overlay" aria-hidden="true"></div>` : "";
+        const html = `<div class="vaults-battlemap"${grid ? ` data-grid="${grid}"` : ""}`
+            + `${mapName ? ` data-name="${htmlEscape(mapName)}"` : ""}>`
+            + `<div class="vaults-bm-bar">`
+            + `<div class="vaults-bm-levels" role="tablist">${levelBtns}</div>`
+            + `<div class="vaults-bm-tools">${tools}</div>`
+            + `</div>`
+            + `<div class="vaults-bm-stage">${panes}${overlay}</div>`
+            + `</div>`;
+        return { html };
+    },
+};
+// ── Browser runtime ───────────────────────────────────────────────────────
+const BATTLEMAP_RUNTIME = `
+(function () {
+  function initMap(root) {
+    var grid = parseFloat(root.getAttribute('data-grid')) || 0;
+    var overlay = root.querySelector('.vaults-bm-grid-overlay');
+    var panes = root.querySelectorAll('.vaults-bm-pane');
+    var btns = root.querySelectorAll('.vaults-bm-level');
+
+    function active() { return root.querySelector('.vaults-bm-pane.is-active'); }
+
+    function sizeGrid() {
+      if (!grid || !overlay) return;
+      var pane = active();
+      var img = pane && pane.querySelector('img');
+      if (!img || !img.naturalWidth) return;
+      overlay.style.backgroundSize =
+        (grid / img.naturalWidth * 100) + '% ' + (grid / img.naturalHeight * 100) + '%';
+    }
+
+    function setLevel(i) {
+      panes.forEach(function (p) { p.classList.toggle('is-active', p.getAttribute('data-level') === i); });
+      btns.forEach(function (b) { b.setAttribute('aria-selected', b.getAttribute('data-level') === i ? 'true' : 'false'); });
+      sizeGrid();
+    }
+
+    btns.forEach(function (b) {
+      b.addEventListener('click', function () { setLevel(b.getAttribute('data-level')); });
+    });
+
+    var gridBtn = root.querySelector('.vaults-bm-grid');
+    if (gridBtn) gridBtn.addEventListener('click', function () {
+      var on = root.classList.toggle('show-grid');
+      gridBtn.setAttribute('aria-pressed', on ? 'true' : 'false');
+      if (on) sizeGrid();
+    });
+
+    var dlBtn = root.querySelector('.vaults-bm-download');
+    if (dlBtn) dlBtn.addEventListener('click', function () { download(root); });
+
+    root.querySelectorAll('img').forEach(function (img) {
+      if (img.complete) sizeGrid(); else img.addEventListener('load', sizeGrid);
+    });
+    window.addEventListener('resize', sizeGrid);
+  }
+
+  function download(root) {
+    var pane = root.querySelector('.vaults-bm-pane.is-active');
+    var imgs = pane ? pane.querySelectorAll('img') : [];
+    if (!imgs.length || !imgs[0].naturalWidth) return;
+    var canvas = document.createElement('canvas');
+    canvas.width = imgs[0].naturalWidth;
+    canvas.height = imgs[0].naturalHeight;
+    var ctx = canvas.getContext('2d');
+    imgs.forEach(function (img) { ctx.drawImage(img, 0, 0, canvas.width, canvas.height); });
+
+    // Bake in the grid only when it's currently shown, matching the overlay.
+    var grid = parseFloat(root.getAttribute('data-grid')) || 0;
+    if (grid > 0 && root.classList.contains('show-grid')) {
+      // Scale the line to the on-screen 1px so the baked grid looks the same.
+      var scale = imgs[0].width ? imgs[0].naturalWidth / imgs[0].width : 1;
+      ctx.strokeStyle = 'rgba(0,0,0,0.5)';
+      ctx.lineWidth = Math.max(1, scale);
+      ctx.beginPath();
+      for (var gx = 0; gx <= canvas.width; gx += grid) { ctx.moveTo(gx, 0); ctx.lineTo(gx, canvas.height); }
+      for (var gy = 0; gy <= canvas.height; gy += grid) { ctx.moveTo(0, gy); ctx.lineTo(canvas.width, gy); }
+      ctx.stroke();
+    }
+
+    var prefix = root.getAttribute('data-name');
+    var name = (prefix ? prefix + ' - ' : '') + (pane.getAttribute('data-name') || 'map');
+    try {
+      canvas.toBlob(function (blob) {
+        if (!blob) return;
+        var url = URL.createObjectURL(blob);
+        var a = document.createElement('a');
+        a.href = url; a.download = name + '.png';
+        document.body.appendChild(a); a.click(); a.remove();
+        setTimeout(function () { URL.revokeObjectURL(url); }, 1000);
+      }, 'image/png');
+    } catch (e) {
+      // Tainted canvas (cross-origin image): fall back to opening the base layer.
+      window.open(imgs[0].src, '_blank');
+    }
+  }
+
+  function initAll() { document.querySelectorAll('.vaults-battlemap').forEach(initMap); }
+  if (document.readyState === 'loading') document.addEventListener('DOMContentLoaded', initAll);
+  else initAll();
+})();
+`;
+const BATTLEMAP_STYLES = `
+.vaults-battlemap { margin: 1rem 0; }
+.vaults-bm-bar { display: flex; flex-wrap: wrap; gap: .5rem; align-items: center; justify-content: space-between; margin-bottom: .5rem; }
+.vaults-bm-levels, .vaults-bm-tools { display: flex; flex-wrap: wrap; gap: .25rem; }
+.vaults-battlemap button { font: inherit; font-size: .85rem; line-height: 1.2; padding: .3rem .7rem; border: 1px solid var(--rule, #ccc); border-radius: 4px; background: var(--bg, #fff); color: var(--fg, #222); cursor: pointer; }
+.vaults-battlemap button:hover { border-color: var(--accent, #888); }
+.vaults-bm-level[aria-selected="true"], .vaults-bm-grid[aria-pressed="true"] { background: var(--accent, #333); color: var(--accent-fg, #fff); border-color: var(--accent, #333); }
+.vaults-bm-stage { position: relative; line-height: 0; border: 1px solid var(--rule, #ccc); border-radius: 4px; overflow: hidden; background: #15151a; }
+.vaults-bm-pane { display: none; position: relative; }
+.vaults-bm-pane.is-active { display: block; }
+.vaults-bm-pane img { display: block; width: 100%; height: auto; -webkit-user-drag: none; user-select: none; }
+.vaults-bm-pane img:not(:first-child) { position: absolute; inset: 0; }
+.vaults-bm-grid-overlay { position: absolute; inset: 0; display: none; pointer-events: none; background-image: linear-gradient(to right, rgba(0,0,0,.5) 0 1px, transparent 1px), linear-gradient(to bottom, rgba(0,0,0,.5) 0 1px, transparent 1px); }
+.vaults-battlemap.show-grid .vaults-bm-grid-overlay { display: block; }
+.vaults-bm-error { padding: .5rem .75rem; border: 1px solid #b94a3a; border-radius: 4px; color: #b94a3a; font-size: .85rem; }
+`;
+registerBuiltinAssets(battlemapHandler, {
+    scripts: [{ source: "builtin/battlemap.runtime.js", content: BATTLEMAP_RUNTIME }],
+    styles: [{ source: "builtin/battlemap.css", content: BATTLEMAP_STYLES }],
+});
+//# sourceMappingURL=battlemap.js.map

package/dist/render/handlers/builtin/battlemap.js.map

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

package/dist/render/handlers/builtin/dice.js

@@ -11,7 +11,7 @@
 //
 // Subset of Dice Roller's syntax: basic XdY +/- Z arithmetic, optional X.
 // More complex modifiers (kh, kl, explode, etc.) are not supported.
-import { htmlEscape } from "../types.js";
+import { htmlEscape } from "../../../escape.js";
 import { registerBuiltinAssets } from "../assets.js";
 // Formula validation: optional X, then 'd', then Y, then optional ± integer.
 // Only used at build time to decide whether render() emits a clickable

package/dist/render/handlers/builtin/dice.js.map

@@ -1 +1 @@
-{"version":3,"file":"dice.js","sourceRoot":"","sources":["../../../../src/render/handlers/builtin/dice.ts"],"names":[],"mappings":"AAAA,mCAAmC;AACnC,EAAE;AACF,mEAAmE;AACnE,EAAE;AACF,qEAAqE;AACrE,EAAE;AACF,0EAA0E;AAC1E,oEAAoE;AACpE,2EAA2E;AAC3E,kDAAkD;AAClD,EAAE;AACF,0EAA0E;AAC1E,oEAAoE;AAGpE,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAErD,6EAA6E;AAC7E,uEAAuE;AACvE,wEAAwE;AACxE,4DAA4D;AAC5D,MAAM,UAAU,GAAG,gCAAgC,CAAC;AAEpD,MAAM,CAAC,MAAM,WAAW,GAAkB;IACxC,MAAM,EAAE,MAAM;IACd,MAAM,CAAC,OAAe;QACpB,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;QAC/B,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;QACpC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YAC9B,iEAAiE;YACjE,oDAAoD;YACpD,OAAO;gBACL,IAAI,EAAE,+EAA+E,OAAO,SAAS;aACtG,CAAC;QACJ,CAAC;QACD,OAAO;YACL,IAAI,EAAE,yDAAyD,OAAO,2BAA2B,OAAO,WAAW;SACpH,CAAC;IACJ,CAAC;CACF,CAAC;AAEF,6EAA6E;AAC7E,wEAAwE;AACxE,uEAAuE;AACvE,yDAAyD;AAEzD,MAAM,mBAAmB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgC3B,CAAC;AAEF,qBAAqB,CAAC,WAAW,EAAE;IACjC,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,yBAAyB,EAAE,OAAO,EAAE,mBAAmB,EAAE,CAAC;CAC/E,CAAC,CAAC"}
+{"version":3,"file":"dice.js","sourceRoot":"","sources":["../../../../src/render/handlers/builtin/dice.ts"],"names":[],"mappings":"AAAA,mCAAmC;AACnC,EAAE;AACF,mEAAmE;AACnE,EAAE;AACF,qEAAqE;AACrE,EAAE;AACF,0EAA0E;AAC1E,oEAAoE;AACpE,2EAA2E;AAC3E,kDAAkD;AAClD,EAAE;AACF,0EAA0E;AAC1E,oEAAoE;AAGpE,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAErD,6EAA6E;AAC7E,uEAAuE;AACvE,wEAAwE;AACxE,4DAA4D;AAC5D,MAAM,UAAU,GAAG,gCAAgC,CAAC;AAEpD,MAAM,CAAC,MAAM,WAAW,GAAkB;IACxC,MAAM,EAAE,MAAM;IACd,MAAM,CAAC,OAAe;QACpB,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;QAC/B,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;QACpC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YAC9B,iEAAiE;YACjE,oDAAoD;YACpD,OAAO;gBACL,IAAI,EAAE,+EAA+E,OAAO,SAAS;aACtG,CAAC;QACJ,CAAC;QACD,OAAO;YACL,IAAI,EAAE,yDAAyD,OAAO,2BAA2B,OAAO,WAAW;SACpH,CAAC;IACJ,CAAC;CACF,CAAC;AAEF,6EAA6E;AAC7E,wEAAwE;AACxE,uEAAuE;AACvE,yDAAyD;AAEzD,MAAM,mBAAmB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgC3B,CAAC;AAEF,qBAAqB,CAAC,WAAW,EAAE;IACjC,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,yBAAyB,EAAE,OAAO,EAAE,mBAAmB,EAAE,CAAC;CAC/E,CAAC,CAAC"}

package/dist/render/handlers/builtin/fm-code.js

@@ -0,0 +1,50 @@
+// Built-in code-block `fm` handler — renders a frontmatter value as a fenced
+// code block, with an optional language hint via the fence meta string.
+//
+// Usage:
+//
+//   ```fm javascript
+//   foundry.data.command
+//   ```
+//
+// Renders as:
+//
+//   <pre><code class="language-javascript">…value of frontmatter.foundry.data.command…</code></pre>
+//
+// Companion to the inline `fm:` handler. Inline form is used in prose to
+// pull a frontmatter value into a sentence; this code-block form is used
+// when the value IS code (or otherwise wants a `<pre>` wrapper) and you
+// want a single source of truth for that code rather than duplicating it
+// between the frontmatter and the page body.
+//
+// The body of the fence is the dot-path (single token, leading/trailing
+// whitespace tolerated). Anything beyond the lang on the fence is the
+// optional language hint — `lang className="language-…"` so client-side
+// highlighters can pick it up. Missing path or non-string value renders
+// as a visible warning marker rather than failing the build, same policy
+// as the inline handler.
+import { htmlEscape } from "../../../escape.js";
+import { lookup } from "./fm.js";
+export const fmCodeHandler = {
+    codeBlock: "fm",
+    render(content, ctx) {
+        const path = content.trim();
+        if (!path)
+            return missing("(empty)");
+        const value = lookup(ctx.frontmatter, path);
+        if (typeof value !== "string")
+            return missing(`${path}: not a string`);
+        const langClass = ctx.codeBlockMeta
+            ? ` class="language-${htmlEscape(ctx.codeBlockMeta)}"`
+            : "";
+        return {
+            html: `<pre><code${langClass}>${htmlEscape(value)}</code></pre>`,
+        };
+    },
+};
+function missing(key) {
+    return {
+        html: `<pre><code class="fm-missing" title="frontmatter key not found">{{${htmlEscape(key)}}}</code></pre>`,
+    };
+}
+//# sourceMappingURL=fm-code.js.map

package/dist/render/handlers/builtin/fm-code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fm-code.js","sourceRoot":"","sources":["../../../../src/render/handlers/builtin/fm-code.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,wEAAwE;AACxE,EAAE;AACF,SAAS;AACT,EAAE;AACF,qBAAqB;AACrB,yBAAyB;AACzB,QAAQ;AACR,EAAE;AACF,cAAc;AACd,EAAE;AACF,oGAAoG;AACpG,EAAE;AACF,yEAAyE;AACzE,yEAAyE;AACzE,wEAAwE;AACxE,yEAAyE;AACzE,6CAA6C;AAC7C,EAAE;AACF,wEAAwE;AACxE,sEAAsE;AACtE,wEAAwE;AACxE,wEAAwE;AACxE,yEAAyE;AACzE,yBAAyB;AAGzB,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEjC,MAAM,CAAC,MAAM,aAAa,GAAqB;IAC7C,SAAS,EAAE,IAAI;IACf,MAAM,CAAC,OAAO,EAAE,GAAG;QACjB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;QAC5B,IAAI,CAAC,IAAI;YAAE,OAAO,OAAO,CAAC,SAAS,CAAC,CAAC;QACrC,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;QAC5C,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,OAAO,OAAO,CAAC,GAAG,IAAI,gBAAgB,CAAC,CAAC;QACvE,MAAM,SAAS,GAAG,GAAG,CAAC,aAAa;YACjC,CAAC,CAAC,oBAAoB,UAAU,CAAC,GAAG,CAAC,aAAa,CAAC,GAAG;YACtD,CAAC,CAAC,EAAE,CAAC;QACP,OAAO;YACL,IAAI,EAAE,aAAa,SAAS,IAAI,UAAU,CAAC,KAAK,CAAC,eAAe;SACjE,CAAC;IACJ,CAAC;CACF,CAAC;AAEF,SAAS,OAAO,CAAC,GAAW;IAC1B,OAAO;QACL,IAAI,EAAE,qEAAqE,UAAU,CAAC,GAAG,CAAC,iBAAiB;KAC5G,CAAC;AACJ,CAAC"}

package/dist/render/handlers/builtin/fm.js

@@ -26,7 +26,8 @@
 // Arrays are joined with ", ". Missing keys and unsupported value shapes
 // (plain objects, null) render a visible warning marker so the page
 // surfaces the problem instead of silently emitting "undefined".
-import { htmlEscape } from "../types.js";
+import { htmlEscape } from "../../../escape.js";
+import { formatInline } from "./inline-format.js";
 export const fmHandler = {
     inline: "fm",
     render(content, ctx) {
@@ -48,7 +49,10 @@ export const fmHandler = {
 // wrapping in a <span> keeps the value visible. The span is invisible in
 // the final layout so it doesn't change typography.
 function wrap(inner) { return `<span class="fm-value">${inner}</span>`; }
-function lookup(root, path) {
+/** Walk a dot-path into the page's frontmatter; numeric segments index
+ *  arrays. Exported so the sibling fm code-block handler reuses the same
+ *  resolution semantics. */
+export function lookup(root, path) {
     const segments = path.split(".");
     let cursor = root;
     for (const seg of segments) {
@@ -60,16 +64,6 @@ function lookup(root, path) {
     }
     return cursor;
 }
-// HTML-escape, then a tiny inline-markdown pass: bold (** **) before italic
-// (* *) so bold doesn't get eaten, then code spans. Matches the same subset
-// the statblock handler's formatInline supports — keep these in sync.
-function formatInline(s) {
-    let out = htmlEscape(s);
-    out = out.replace(/\*\*([^*]+)\*\*/g, "<strong>$1</strong>");
-    out = out.replace(/(^|[^*])\*([^*\n]+)\*(?!\*)/g, "$1<em>$2</em>");
-    out = out.replace(/`([^`]+)`/g, "<code>$1</code>");
-    return out;
-}
 function formatScalar(v) {
     if (v === null || v === undefined)
         return null;

package/dist/render/handlers/builtin/fm.js.map

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

package/dist/render/handlers/builtin/index.js

@@ -2,8 +2,12 @@
 //
 // User-defined handlers (loaded from .vaults/handlers/) override built-ins
 // of the same name; see buildRegistry() in handlers/types.ts.
+import { battlemapHandler } from "./battlemap.js";
 import { diceHandler } from "./dice.js";
 import { fmHandler } from "./fm.js";
+import { fmCodeHandler } from "./fm-code.js";
 import { statblockHandler } from "./statblock.js";
-export const BUILTIN_HANDLERS = [diceHandler, fmHandler, statblockHandler];
+export const BUILTIN_HANDLERS = [
+    diceHandler, fmHandler, fmCodeHandler, statblockHandler, battlemapHandler,
+];
 //# sourceMappingURL=index.js.map

package/dist/render/handlers/builtin/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/render/handlers/builtin/index.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,EAAE;AACF,2EAA2E;AAC3E,8DAA8D;AAG9D,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElD,MAAM,CAAC,MAAM,gBAAgB,GAAc,CAAC,WAAW,EAAE,SAAS,EAAE,gBAAgB,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/render/handlers/builtin/index.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,EAAE;AACF,2EAA2E;AAC3E,8DAA8D;AAG9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElD,MAAM,CAAC,MAAM,gBAAgB,GAAc;IACzC,WAAW,EAAE,SAAS,EAAE,aAAa,EAAE,gBAAgB,EAAE,gBAAgB;CAC1E,CAAC"}

package/dist/render/handlers/builtin/inline-format.js

@@ -0,0 +1,26 @@
+// Tiny inline-markdown formatter shared by the built-in `fm` and `statblock`
+// handlers. Both render frontmatter scalars or bespoke content directly to
+// HTML rather than re-feeding it through the full markdown pipeline, but
+// authors still expect basic ** ** / * * / `` markup to survive. This is
+// the smallest formatter that supports that.
+//
+// Bold runs first (** **) so the italic regex can't gobble its asterisks.
+// Italic uses a leading non-`*` guard so `**bold**` doesn't match. Code
+// spans run last; their delimiter (`) is HTML-safe after htmlEscape.
+//
+// Wikilinks are intentionally NOT processed here — wikilink resolution
+// requires the full RenderContext and lives in render/wikilink.ts. Authors
+// who need wikilinks should put them in regular prose.
+import { htmlEscape } from "../../../escape.js";
+/**
+ * HTML-escape `s`, then apply a small inline-markdown subset
+ * (bold, italic, code spans). Returns ready-to-insert HTML.
+ */
+export function formatInline(s) {
+    let out = htmlEscape(s);
+    out = out.replace(/\*\*([^*]+)\*\*/g, "<strong>$1</strong>");
+    out = out.replace(/(^|[^*])\*([^*\n]+)\*(?!\*)/g, "$1<em>$2</em>");
+    out = out.replace(/`([^`]+)`/g, "<code>$1</code>");
+    return out;
+}
+//# sourceMappingURL=inline-format.js.map

package/dist/render/handlers/builtin/inline-format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inline-format.js","sourceRoot":"","sources":["../../../../src/render/handlers/builtin/inline-format.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,2EAA2E;AAC3E,yEAAyE;AACzE,yEAAyE;AACzE,6CAA6C;AAC7C,EAAE;AACF,0EAA0E;AAC1E,wEAAwE;AACxE,qEAAqE;AACrE,EAAE;AACF,uEAAuE;AACvE,2EAA2E;AAC3E,uDAAuD;AAEvD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhD;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,CAAS;IACpC,IAAI,GAAG,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;IACxB,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,kBAAkB,EAAE,qBAAqB,CAAC,CAAC;IAC7D,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,8BAA8B,EAAE,eAAe,CAAC,CAAC;IACnE,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,YAAY,EAAE,iBAAiB,CAAC,CAAC;IACnD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/render/handlers/builtin/statblock.js

@@ -30,13 +30,13 @@
 //
 // Coverage: name/size/type/subtype/alignment, ac (+ ac_class), hp (+ hit_dice),
 // speed, six abilities (stats), saves, skillsaves, damage_*, condition_immunities,
-// senses, languages, cr, traits, actions, reactions, legendary_actions
-// (+ legendary_description). Inline markdown in `desc` fields supports **bold**,
-// *italic*, and `code`. Other Fantasy Statblocks features (spells nested
-// formatting, custom layouts, dice-roller integration, JS callbacks, image
-// fields) are not supported in v1.
+// senses, languages, cr, traits, spells (basic spellcasting list), actions,
+// reactions, legendary_actions (+ legendary_description). Inline markdown in
+// `desc` fields supports **bold**, *italic*, and `code`. Other Fantasy Statblocks
+// features (innate spellcasting, PF2e/13th-age custom layouts, dice-roller
+// integration, JS callbacks, image fields) are not supported in v1.
 import yaml from "js-yaml";
-import { htmlEscape } from "../types.js";
+import { htmlEscape } from "../../../escape.js";
 import { registerBuiltinAssets } from "../assets.js";
 const ABILITY_NAMES = ["STR", "DEX", "CON", "INT", "WIS", "CHA"];
 const ABILITY_SHORT = {
@@ -109,10 +109,24 @@ async function preprocessHandlers(m, ctx) {
         if (typeof mAny[k] === "string")
             mAny[k] = await tokenize(mAny[k]);
     }
-    // Per-entry name and desc inside trait/action lists.
+    // Per-entry name and desc inside trait/action lists. Nested traits are
+    // hoisted to the top level prefixed with the parent's name (v1: flat).
     const list = async (xs) => {
         if (!xs)
             return;
+        // Inline-flatten one level of nested .traits[].traits before tokenizing.
+        for (let i = 0; i < xs.length; i++) {
+            const x = xs[i];
+            if (Array.isArray(x.traits) && x.traits.length) {
+                const parentName = x.name ?? "";
+                const flattened = x.traits.map((nested) => ({
+                    ...nested,
+                    name: parentName ? `${parentName}: ${nested.name ?? ""}`.trim() : (nested.name ?? ""),
+                }));
+                delete x.traits;
+                xs.splice(i + 1, 0, ...flattened);
+            }
+        }
         for (const x of xs) {
             if (typeof x.name === "string")
                 x.name = await tokenize(x.name);
@@ -122,8 +136,30 @@ async function preprocessHandlers(m, ctx) {
     };
     await list(m.traits);
     await list(m.actions);
+    await list(m.bonus_actions);
     await list(m.reactions);
     await list(m.legendary_actions);
+    await list(m.mythic_actions);
+    await list(m.lair_actions);
+    await list(m.triggered_actions);
+    // spells: each entry is a string OR object. Tokenize string values
+    // (top-level entries and per-key values inside object entries) so
+    // dice:/fm: work inside.
+    if (m.spells) {
+        for (let i = 0; i < m.spells.length; i++) {
+            const s = m.spells[i];
+            if (typeof s === "string") {
+                m.spells[i] = (await tokenize(s)) ?? s;
+            }
+            else if (s && typeof s === "object") {
+                for (const k of Object.keys(s)) {
+                    const v = s[k];
+                    if (typeof v === "string")
+                        s[k] = (await tokenize(v)) ?? v;
+                }
+            }
+        }
+    }
     return spliceback;
 }
 function property(label, value, spliceback) {
@@ -135,10 +171,17 @@ function header(m, spliceback) {
     const name = m.name ?? "Unnamed";
     const sub = [m.size, m.type, m.subtype && `(${m.subtype})`, m.alignment]
         .filter(Boolean).join(" ");
+    // The image path is treated as a vault-relative reference; we emit it
+    // verbatim. Authors typically use a path their wiki's image cache serves
+    // (e.g. "portraits/foo.webp"). The sanitizer allows src/alt/class on img.
+    const img = m.image
+        ? `<img class="statblock-image" src="${htmlEscape(m.image)}" alt="${htmlEscape(name)}">`
+        : "";
     // Rendered as a div, not an h2: the page sanitizer restricts <h2> to
     // class="sr-only" only (GFM footnotes use it). The name is also not part
     // of the page's article outline — pages can have multiple statblocks.
     return (`<div class="statblock-header">` +
+        img +
         `<div class="statblock-name">${formatInline(name, spliceback)}</div>` +
         (sub ? `<p class="statblock-subheading">${formatInline(sub, spliceback)}</p>` : "") +
         `</div>`);
@@ -164,19 +207,32 @@ function stats(m) {
         `</div>`).join("");
     return `<div class="statblock-stats">${cells}</div>`;
 }
+// FS accepts saves/skillsaves either as an array of single-key objects OR a
+// single multi-key object. Normalize to a flat list of [key, val] pairs.
 function bonusList(entries, labelFor) {
-    if (!entries?.length)
+    if (!entries)
         return "";
-    return entries.map(entry => {
-        const pair = Object.entries(entry)[0];
-        if (!pair)
-            return "";
-        const [key, val] = pair;
-        if (val === undefined)
-            return "";
+    const pairs = [];
+    if (Array.isArray(entries)) {
+        for (const entry of entries) {
+            for (const [k, v] of Object.entries(entry)) {
+                if (typeof v === "number")
+                    pairs.push([k, v]);
+            }
+        }
+    }
+    else if (typeof entries === "object") {
+        for (const [k, v] of Object.entries(entries)) {
+            if (typeof v === "number")
+                pairs.push([k, v]);
+        }
+    }
+    if (!pairs.length)
+        return "";
+    return pairs.map(([key, val]) => {
         const sign = val >= 0 ? "+" : "";
         return `${labelFor(key)} ${sign}${val}`;
-    }).filter(Boolean).join(", ");
+    }).join(", ");
 }
 function midProperties(m, spliceback) {
     const saves = bonusList(m.saves, k => ABILITY_SHORT[k.toLowerCase()] ?? k);
@@ -199,6 +255,52 @@ function trait(t, spliceback) {
         formatInline(t.desc ?? "", spliceback) +
         `</p>`;
 }
+// Render a single per-level line: bold label + comma-separated, auto-italicized
+// spell list. Used for both string entries (split on first `:`) and object
+// entries (key = label, value = spell list string).
+function spellLevelLine(label, list, spliceback) {
+    const spellList = list.split(",")
+        .map(s => s.trim()).filter(Boolean)
+        .map(s => `<em>${formatInline(s, spliceback)}</em>`)
+        .join(", ");
+    return `<p class="statblock-spell-level">` +
+        `<strong>${formatInline(label, spliceback)}</strong>: ${spellList}` +
+        `</p>`;
+}
+// Render Fantasy Statblocks `spells:` — first entry is intro prose shown as
+// a Spellcasting trait header; remaining entries are per-level lines.
+//
+// Each entry can be a string (split on `:`) OR an object whose keys are
+// level labels and values are the spell list strings (FS Spell type).
+// Entries without a `:` fall through as plain paragraphs.
+function spellcasting(spells, spliceback) {
+    if (!spells?.length)
+        return "";
+    const [first, ...rest] = spells;
+    // Object as the first entry has no obvious "intro prose" interpretation;
+    // treat all entries as levels in that case (no Spellcasting header).
+    const introIsString = typeof first === "string";
+    const head = introIsString
+        ? `<p class="statblock-trait">` +
+            `<strong><em>Spellcasting.</em></strong> ` +
+            formatInline(first, spliceback) +
+            `</p>`
+        : "";
+    const levels = introIsString ? rest : spells;
+    const lines = levels.map(entry => {
+        if (typeof entry === "string") {
+            const colon = entry.indexOf(":");
+            if (colon < 0)
+                return `<p class="statblock-spell-level">${formatInline(entry, spliceback)}</p>`;
+            return spellLevelLine(entry.slice(0, colon), entry.slice(colon + 1), spliceback);
+        }
+        // Object form: render each key/value pair as its own level line.
+        return Object.entries(entry)
+            .map(([label, list]) => spellLevelLine(label, String(list ?? ""), spliceback))
+            .join("");
+    }).join("");
+    return head + lines;
+}
 function section(label, items, spliceback, intro) {
     if (!items?.length)
         return "";
@@ -229,8 +331,16 @@ export const statblockHandler = {
         // fields with sentinel tokens; spliceback holds the resulting HTML and
         // formatInline weaves it back in after escaping.
         const spliceback = await preprocessHandlers(m, ctx);
-        const traitsHtml = m.traits?.length
-            ? `<div class="statblock-section">${m.traits.map(t => trait(t, spliceback)).join("")}</div>`
+        const spellsHtml = spellcasting(m.spells, spliceback);
+        const traitsHtml = m.traits?.length || spellsHtml
+            ? `<div class="statblock-section">${(m.traits ?? []).map(t => trait(t, spliceback)).join("")}${spellsHtml}</div>`
+            : "";
+        const sourceText = Array.isArray(m.source) ? m.source.join(", ") : m.source;
+        const sourceHtml = sourceText
+            ? `<p class="statblock-source"><em>${formatInline(sourceText, spliceback)}</em></p>`
+            : "";
+        const noteHtml = m.note
+            ? `<p class="statblock-note"><em>${formatInline(m.note, spliceback)}</em></p>`
             : "";
         const body = [
             header(m, spliceback),
@@ -243,8 +353,14 @@ export const statblockHandler = {
             `<div class="statblock-rule statblock-rule-tapered"></div>`,
             traitsHtml,
             section("Actions", m.actions, spliceback),
+            section("Bonus Actions", m.bonus_actions, spliceback),
             section("Reactions", m.reactions, spliceback),
             section("Legendary Actions", m.legendary_actions, spliceback, m.legendary_description),
+            section("Mythic Actions", m.mythic_actions, spliceback, m.mythic_description),
+            section("Lair Actions", m.lair_actions, spliceback),
+            section("Triggered Actions", m.triggered_actions, spliceback),
+            sourceHtml,
+            noteHtml,
         ].join("");
         return { html: `<div class="statblock">${body}</div>` };
     },
@@ -335,6 +451,11 @@ const STATBLOCK_CSS = `
   font-weight: bold;
   font-style: italic;
 }
+.statblock-spell-level {
+  margin: 0.15rem 0 0.15rem 1rem;
+  text-indent: -1rem;
+  padding-left: 1rem;
+}
 .statblock-section-intro {
   font-style: italic;
   margin: 0.3rem 0;
@@ -344,8 +465,27 @@ const STATBLOCK_CSS = `
   color: #7a200d;
   border-color: #7a200d;
 }
+.statblock-image {
+  float: right;
+  width: 75px;
+  height: 75px;
+  object-fit: cover;
+  margin: 0 0 0.4rem 0.5rem;
+  border: 2px solid var(--statblock-rule-color);
+  border-radius: 2px;
+}
+.statblock-source,
+.statblock-note {
+  font-size: 0.85rem;
+  margin-top: 0.4rem;
+  color: #555;
+}
 `;
 registerBuiltinAssets(statblockHandler, {
     styles: [{ source: "builtin/statblock.css", content: STATBLOCK_CSS }],
+    // Styles ride into the Foundry-import bundle so synced statblocks
+    // render identically. Scripts intentionally omitted: dice runtime is
+    // replaced by Foundry's [[/r]] enricher in links.mjs.
+    foundry: { styles: true },
 });
 //# sourceMappingURL=statblock.js.map