@wizzlethorpe/vaults 0.6.1 → 0.7.1

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

@@ -0,0 +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,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

@@ -0,0 +1,83 @@
+// Built-in inline `fm:` handler — inserts a frontmatter value into prose.
+//
+//   ---
+//   class: Wizard
+//   level: 7
+//   stats:
+//     hp: 22
+//   ---
+//   The `fm: class` is level `fm: level` with `fm: stats.hp` HP.
+//
+// Renders as: "The Wizard is level 7 with 22 HP."
+//
+// Dot-path lookups (`fm: a.b.c`) walk nested objects. Keys with literal
+// dots in their names are unreachable, which we accept because such keys
+// are vanishingly rare in vault frontmatter.
+//
+// String/number/boolean values render as HTML with a small inline-markup
+// pass (**bold**, *italic*, `code`) so authors can put light formatting
+// in frontmatter and have it survive. Returning HTML rather than markdown
+// lets fm work when invoked recursively from another handler (e.g. inside
+// a `statblock` field), since the dispatcher only re-pipelines top-level
+// markdown returns. Wikilinks in frontmatter are NOT processed; cross-page
+// reference belongs in prose.
+//
+// Dates (YAML auto-parses ISO 8601 strings to Date) format as YYYY-MM-DD.
+// 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 "../../../escape.js";
+import { formatInline } from "./inline-format.js";
+export const fmHandler = {
+    inline: "fm",
+    render(content, ctx) {
+        const path = content.trim();
+        if (!path)
+            return missing("(empty)");
+        const value = lookup(ctx.frontmatter, path);
+        const formatted = formatScalar(value);
+        if (formatted !== null)
+            return { html: wrap(formatInline(formatted)) };
+        if (Array.isArray(value)) {
+            return { html: wrap(formatInline(value.map((v) => formatScalar(v) ?? "").join(", "))) };
+        }
+        return missing(path);
+    },
+};
+// Bare-text HTML AST nodes get dropped by the markdown → HTML stage
+// (rehype-raw needs an actual element to anchor onto in inline contexts);
+// 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>`; }
+/** 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) {
+        if (cursor === null || cursor === undefined)
+            return undefined;
+        if (typeof cursor !== "object")
+            return undefined;
+        cursor = cursor[seg];
+    }
+    return cursor;
+}
+function formatScalar(v) {
+    if (v === null || v === undefined)
+        return null;
+    if (typeof v === "string")
+        return v;
+    if (typeof v === "number" || typeof v === "boolean")
+        return String(v);
+    if (v instanceof Date && !isNaN(v.getTime()))
+        return v.toISOString().slice(0, 10);
+    return null;
+}
+function missing(key) {
+    return {
+        html: `<code class="fm-missing" title="frontmatter key not found">{{${htmlEscape(key)}}}</code>`,
+    };
+}
+//# sourceMappingURL=fm.js.map

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,13 @@
+// Registry of built-in handlers shipped with vaults-cli.
+//
+// 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, fmCodeHandler, statblockHandler, battlemapHandler,
+];
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +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,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"}