@pretextbook/pretext-html 0.1.0 → 0.1.1

package/dist/{cli-C6tfAVvi.js → cli-BQizBK0N.js}

@@ -1,12 +1,13 @@
-import { readFile as m, writeFile as j } from "node:fs/promises";
+import { readFile as m, writeFile as X } from "node:fs/promises";
 import * as w from "node:process";
 import * as c from "node:path";
 import { fileURLToPath as K } from "node:url";
 import { fromXml as $ } from "xast-util-from-xml";
 import { toXml as y } from "xast-util-to-xml";
-const I = /* @__PURE__ */ new Map(), W = /* @__PURE__ */ new Map();
-let S, Q = 0;
-function ee(e, r) {
+import { injectThemeBridge as Q } from "./theme.js";
+const T = /* @__PURE__ */ new Map(), W = /* @__PURE__ */ new Map();
+let S, ee = 0;
+function te(e, r) {
   const t = typeof e == "string" ? e : e instanceof URL ? e.href : e.url, n = W.get(t);
   if (n !== void 0)
     return Promise.resolve(new Response(n, { status: 200 }));
@@ -16,11 +17,11 @@ function ee(e, r) {
   } catch {
     o = "";
   }
-  const i = I.get(o);
-  return i !== void 0 ? te(i, t) : S(e, r);
+  const i = T.get(o);
+  return i !== void 0 ? re(i, t) : S(e, r);
 }
 const F = '<?xml version="1.0"?><pretext-preview-missing-file/>';
-async function te(e, r) {
+async function re(e, r) {
   const t = decodeURIComponent(new URL(r).pathname), n = c.resolve(e, "." + c.posix.normalize(t));
   if (n !== e && !n.startsWith(e + c.sep))
     return console.error(
@@ -33,21 +34,21 @@ async function te(e, r) {
     return new Response(F, { status: 200 });
   }
 }
-function N() {
-  S || (S = globalThis.fetch, globalThis.fetch = ee);
+function B() {
+  S || (S = globalThis.fetch, globalThis.fetch = te);
 }
-function B(e) {
-  N();
-  const r = `mnt${++Q}.ptx.invalid`;
-  return I.set(r, c.resolve(e)), `http://${r}`;
+function N(e) {
+  B();
+  const r = `mnt${++ee}.ptx.invalid`;
+  return T.set(r, c.resolve(e)), `http://${r}`;
 }
-function re(e) {
-  I.delete(new URL(e).host);
+function ne(e) {
+  T.delete(new URL(e).host);
 }
-function ne(e, r) {
-  N(), W.set(e, r);
+function oe(e, r) {
+  B(), W.set(e, r);
 }
-const oe = `<?xml version="1.0" encoding="UTF-8"?>
+const ie = `<?xml version="1.0" encoding="UTF-8"?>
 <publication>
   <source>
     <directories external="../assets" generated="../generated-assets" />
@@ -68,7 +69,7 @@ function M(e, r) {
 }
 function L(e) {
   if (!e)
-    return oe;
+    return ie;
   const r = $(e), t = _(r, "publication");
   if (!t)
     throw new Error(
@@ -78,7 +79,7 @@ function L(e) {
   return o.attributes = { ...o.attributes, portable: "yes" }, y(r);
 }
 const H = "http://www.w3.org/2001/XInclude", R = 64;
-async function ie(e, r, t) {
+async function se(e, r, t) {
   return e.includes("include") ? (await J(e, r, t)).content : e;
 }
 async function J(e, r, t) {
@@ -93,10 +94,10 @@ async function J(e, r, t) {
   );
   return { tree: n, content: i ? y(n) : e };
 }
-function se(e) {
+function ae(e) {
   return e.data?.ptxIncludedFile;
 }
-function ae(e, r) {
+function ce(e, r) {
   const t = e.data ?? (e.data = {});
   t.ptxIncludedFile = r;
 }
@@ -158,7 +159,7 @@ async function z(e, r, t, n) {
   try {
     f = await m(s, "utf8");
   } catch {
-    const u = le(e, t);
+    const u = ue(e, t);
     if (u)
       return await x(u, r, t, n), u.children;
     throw new Error(`xi:include target not found: ${i} (in ${o})`);
@@ -183,13 +184,13 @@ async function z(e, r, t, n) {
     (u) => u.type === "element"
   );
   for (const u of d)
-    ae(u, s);
+    ce(u, s);
   return d;
 }
 function A(e) {
   return e.name === "docinfo";
 }
-async function ce(e, r, t) {
+async function le(e, r, t) {
   try {
     const o = $(e).children.find(
       (a) => a.type === "element"
@@ -226,7 +227,7 @@ async function ce(e, r, t) {
     return;
   }
 }
-function le(e, r) {
+function ue(e, r) {
   for (const t of e.children) {
     if (t.type !== "element")
       continue;
@@ -238,10 +239,10 @@ function le(e, r) {
 function G(e) {
   return typeof e == "object" && e !== null && e.type === "element";
 }
-function ue(e) {
+function fe(e) {
   return /^(pf|xhtml):/.test(e.name);
 }
-function fe(e, r, t) {
+function de(e, r, t) {
   const n = [], o = e.children.find(G);
   if (o) {
     const i = t?.parentId ?? "root";
@@ -250,9 +251,9 @@ function fe(e, r, t) {
   return n;
 }
 function Y(e, r, t, n, o, i) {
-  const l = se(e) ?? n;
+  const l = ae(e) ?? n;
   let s, f;
-  if (ue(e))
+  if (fe(e))
     f = "root";
   else {
     const d = e.attributes.label ?? e.attributes["xml:id"];
@@ -276,7 +277,7 @@ function Y(e, r, t, n, o, i) {
       i
     ));
 }
-function Ie(e, r) {
+function De(e, r) {
   let t;
   for (const n of e)
     n.line <= r && (t = n);
@@ -285,17 +286,17 @@ function Ie(e, r) {
 function V() {
   return process.env.PRETEXT_HTML_ASSETS ?? c.resolve(c.dirname(K(import.meta.url)), "..", "assets");
 }
-function de() {
+function pe() {
   return c.join(V(), "xsl");
 }
-function pe() {
+function he() {
   return c.join(V(), "preview-html.xsl");
 }
-function he() {
+function me() {
   return "Suspending" in WebAssembly;
 }
-function me() {
-  if (!he())
+function we() {
+  if (!me())
     throw new Error(
       "WebAssembly JSPI is not enabled. Run Node with --experimental-wasm-jspi (or use the pretext-html CLI, which re-launches itself with the flag)."
     );
@@ -303,16 +304,16 @@ function me() {
 function U(e) {
   return e.includes("'") ? e.includes('"') ? `concat(${e.split("'").map((t) => `'${t}'`).join(`, "'", `)})` : `"${e}"` : `'${e}'`;
 }
-function we(e) {
+function ge(e) {
   return e.replace(
     /from '\.\/(https:\/\/[^']+)'/g,
     (r, t) => `from '${t}'`
   );
 }
-function ge(e) {
+function be(e) {
   return e.slice(0, 65536).replace(/<\?[\s\S]*?\?>/g, " ").replace(/<!--[\s\S]*?-->/g, " ").replace(/<!DOCTYPE[^>]*>/gi, " ").match(/<\s*([A-Za-z][\w:-]*)/)?.[1];
 }
-async function be(e, r) {
+async function xe(e, r) {
   const t = c.resolve(e);
   let n;
   try {
@@ -320,9 +321,9 @@ async function be(e, r) {
   } catch {
     return;
   }
-  return ce(n, t, r);
+  return le(n, t, r);
 }
-function xe(e, r, t) {
+function ye(e, r, t) {
   const n = e.replace(/^\uFEFF/, "").replace(/<\?xml[\s\S]*?\?>/, "").replace(/<!DOCTYPE[^>]*>/i, ""), o = r === "chapter" || r === "part" ? "book" : "article";
   return `<pretext>
 ${t?.trim() ? `${t.trim()}
@@ -351,27 +352,27 @@ async function Z() {
   })()), P;
 }
 const k = /* @__PURE__ */ new Map();
-async function ye(e) {
+async function ve(e) {
   const r = c.resolve(e);
   let t = k.get(r);
   return t || (t = (async () => {
-    const { XmlDocument: n, XsltStylesheet: o } = await Z(), i = B(r), l = await m(pe(), "utf8"), s = await n.fromString(l, {
+    const { XmlDocument: n, XsltStylesheet: o } = await Z(), i = N(r), l = await m(he(), "utf8"), s = await n.fromString(l, {
       url: `${i}/preview-html.xsl`,
       options: { noEnt: !0, dtdLoad: !0, huge: !0 }
     });
     return o.fromXmlDocument(s);
   })(), k.set(r, t), t.catch(() => k.delete(r))), t;
 }
-async function ve(e) {
-  me();
-  const { XmlDocument: r } = await Z(), t = await ye(e.xslDir ?? de()), n = c.resolve(e.sourcePath), o = c.resolve(
+async function $e(e) {
+  we();
+  const { XmlDocument: r } = await Z(), t = await ve(e.xslDir ?? pe()), n = c.resolve(e.sourcePath), o = c.resolve(
     e.projectDir ?? c.dirname(n)
   ), i = e.sourceContent ?? await m(n, "utf8"), l = c.relative(o, n);
   if (l.startsWith(".."))
     throw new Error(
       `sourcePath (${n}) must live inside projectDir (${o})`
     );
-  const s = B(o);
+  const s = N(o);
   try {
     let f, a = `${s}/__pretext-preview-publication.xml`;
     if (e.publicationPath) {
@@ -383,7 +384,7 @@ async function ve(e) {
       b.startsWith("..") || (a = `${s}/${b.split(c.sep).join("/")}`);
     } else
       f = L();
-    ne(a, f);
+    oe(a, f);
     let d, u;
     if (e.sourceMap) {
       const p = await J(
@@ -393,32 +394,32 @@ async function ve(e) {
       );
       d = p.tree, u = p.content;
     } else
-      u = await ie(
+      u = await se(
         i,
         n,
         o
       );
-    const h = ge(u);
+    const h = be(u);
     let g = { parentId: "root", position: 1 };
     if (h !== "pretext" && h !== "mathbook")
       if (e.fragment) {
-        const p = e.docinfo ?? (e.docinfoSourcePath ? await be(e.docinfoSourcePath, o) : void 0);
-        u = xe(u, h, p), g = { parentId: p?.trim() ? "root-1-2" : "root-1-1", position: 2 };
+        const p = e.docinfo ?? (e.docinfoSourcePath ? await xe(e.docinfoSourcePath, o) : void 0);
+        u = ye(u, h, p), g = { parentId: p?.trim() ? "root-1-2" : "root-1-1", position: 2 };
       } else
         throw new Error(
           `The document root is <${h ?? "?"}>, not <pretext> — this looks like an xi:included fragment. Render the project's main source file instead, or pass the fragment option.`
         );
-    const T = d ? fe(d, n, g) : void 0, D = await r.fromString(u, {
+    const I = d ? de(d, n, g) : void 0, D = await r.fromString(u, {
       url: `${s}/${l.split(c.sep).join("/")}`,
       options: { noEnt: !0, dtdLoad: !0, huge: !0 }
-    }), X = {
+    }), j = {
       publisher: U(a)
     };
     for (const [p, b] of Object.entries(e.stringParams ?? {}))
-      X[p] = U(b);
+      j[p] = U(b);
     let E;
     try {
-      E = await t.apply(D, X);
+      E = await t.apply(D, j);
     } catch (p) {
       throw C(p), new Error(
         "PreTeXt XSLT transform failed; see the PTX:ERROR/PTX:FATAL messages on stderr for details.",
@@ -428,9 +429,10 @@ async function ve(e) {
       D.delete();
     }
     try {
-      return {
-        html: we(E.toHtmlString()),
-        ...T ? { sourceMap: T } : {}
+      let p = ge(E.toHtmlString());
+      return e.theme && (p = Q(p, e.theme)), {
+        html: p,
+        ...I ? { sourceMap: I } : {}
       };
     } catch (p) {
       throw C(p), p;
@@ -438,7 +440,7 @@ async function ve(e) {
       E.delete();
     }
   } finally {
-    re(s);
+    ne(s);
   }
 }
 const O = `Usage: pretext-html <source.ptx> [options]
@@ -467,7 +469,7 @@ Options:
                             file/line for every element (for editor sync)
   -h, --help                Show this help
 `;
-function $e(e) {
+function Ee(e) {
   let r, t, n, o;
   const i = {}, l = {};
   for (let s = 0; s < e.length; s++) {
@@ -532,22 +534,22 @@ function $e(e) {
     sourceMapPath: o
   };
 }
-async function Te(e) {
-  const { options: r, output: t, docinfoPath: n, sourceMapPath: o } = $e(e);
+async function je(e) {
+  const { options: r, output: t, docinfoPath: n, sourceMapPath: o } = Ee(e);
   n && (r.docinfo = await m(n, "utf8"));
-  const i = Date.now(), { html: l, sourceMap: s } = await ve(r);
+  const i = Date.now(), { html: l, sourceMap: s } = await $e(r);
   w.stderr.write(`pretext-html: rendered in ${Date.now() - i}ms
-`), o && s && (await j(o, JSON.stringify(s, null, 2)), w.stderr.write(`pretext-html: wrote ${o}
-`)), t ? (await j(t, l), w.stderr.write(`pretext-html: wrote ${t}
+`), o && s && (await X(o, JSON.stringify(s, null, 2)), w.stderr.write(`pretext-html: wrote ${o}
+`)), t ? (await X(t, l), w.stderr.write(`pretext-html: wrote ${t}
 `)) : w.stdout.write(l);
 }
 export {
   L as a,
-  de as d,
-  Ie as f,
-  he as i,
-  Te as m,
-  $e as p,
-  ve as r,
+  pe as d,
+  De as f,
+  me as i,
+  je as m,
+  Ee as p,
+  $e as r,
   U as x
 };

package/dist/cli.js

@@ -1,6 +1,6 @@
 import "node:fs/promises";
 import "node:process";
-import { m as o, p as s } from "./cli-C6tfAVvi.js";
+import { m as o, p as s } from "./cli-BQizBK0N.js";
 export {
   o as main,
   s as parseArgs

package/dist/index.d.ts

@@ -3,4 +3,6 @@ export type { RenderOptions, RenderResult } from './renderer.js';
 export { findSourceMapEntry } from './sourcemap.js';
 export type { PtxSourceMap, SourceMapEntry } from './sourcemap.js';
 export { forcePortablePublication } from './publication.js';
+export { PREVIEW_THEME_MESSAGE, isPreviewTheme, previewThemeMessage, themeBridgeScript, injectThemeBridge, } from './theme.js';
+export type { PreviewTheme, PreviewThemeMessage } from './theme.js';
 export { main as runCli } from './cli.js';

package/dist/index.js

@@ -1,10 +1,16 @@
-import { d as i, f as s, a as e, i as l, r as t, m as n, x as o } from "./cli-C6tfAVvi.js";
+import { d as i, f as a, a as s, i as t, r as l, m, x as o } from "./cli-BQizBK0N.js";
+import { PREVIEW_THEME_MESSAGE as p, injectThemeBridge as E, isPreviewTheme as d, previewThemeMessage as f, themeBridgeScript as c } from "./theme.js";
 export {
+  p as PREVIEW_THEME_MESSAGE,
   i as defaultXslDir,
-  s as findSourceMapEntry,
-  e as forcePortablePublication,
-  l as isJspiAvailable,
-  t as renderHtml,
-  n as runCli,
+  a as findSourceMapEntry,
+  s as forcePortablePublication,
+  E as injectThemeBridge,
+  t as isJspiAvailable,
+  d as isPreviewTheme,
+  f as previewThemeMessage,
+  l as renderHtml,
+  m as runCli,
+  c as themeBridgeScript,
   o as xpathStringLiteral
 };

package/dist/renderer.d.ts

@@ -1,4 +1,5 @@
 import { PtxSourceMap } from './sourcemap.js';
+import { PreviewTheme } from './theme.js';
 export interface RenderOptions {
     /** Path to the root PreTeXt source file (typically source/main.ptx). */
     sourcePath: string;
@@ -61,6 +62,15 @@ export interface RenderOptions {
      * sourcemap.ts for the id contract with pretext-assembly.xsl.
      */
     sourceMap?: boolean;
+    /**
+     * Let the embedding app control the preview's light/dark theme. When set, a
+     * small bridge script is injected into the page that applies this value as
+     * the initial theme and then follows `postMessage`s from the embedder (see
+     * `previewThemeMessage` / theme.ts). Omit to leave the page's native
+     * behaviour (localStorage + `prefers-color-scheme`) untouched — the output
+     * is then byte-identical to a render without this option.
+     */
+    theme?: PreviewTheme;
 }
 export interface RenderResult {
     /** Complete standalone HTML page (CDN-hosted css/js/MathJax). */

package/dist/theme.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Runtime light/dark theme control for rendered previews.
+ *
+ * A rendered PreTeXt page already knows how to switch between light and dark
+ * — pretext-core.js exposes a global `window.setDarkMode(isDark)` — but it
+ * only ever decides *which* to use from `localStorage` and the browser's
+ * `prefers-color-scheme`. Neither reflects the surroundings an embedder cares
+ * about: "VS Code is using a dark editor theme", "pretext.plus is in dark
+ * mode". This module lets the embedding app drive the preview's theme instead.
+ *
+ * It is entirely opt-in, controlled by `RenderOptions.theme`. When set, the
+ * renderer injects the small script produced by {@link themeBridgeScript},
+ * which:
+ *
+ *   1. applies an *initial* theme baked into the page (so an explicit dark
+ *      preview does not flash light first), and
+ *   2. listens for a `postMessage` from the embedder and re-applies the theme
+ *      live — no re-render needed.
+ *
+ * The embedder posts {@link previewThemeMessage}`(theme)` to the preview's
+ * window (a VS Code webview, an `<iframe>`'s `contentWindow`, or the page's
+ * own `window` for an inline render). This module has no runtime dependencies,
+ * so an embedder can import just the protocol (`@pretextbook/pretext-html/theme`)
+ * without pulling in the WASM renderer.
+ *
+ * Timing note: `window.setDarkMode` is defined by pretext-core.js only inside
+ * its `DOMContentLoaded` handler, so the injected script cannot assume it
+ * exists yet — it retries on `DOMContentLoaded`/`load` and remembers the last
+ * requested theme on `window` so it survives the extension's in-place
+ * `document.write` rebuilds.
+ */
+export type PreviewTheme = "dark" | "light" | "system";
+/**
+ * The `type` field of the message an embedder posts to drive the preview's
+ * theme. Namespaced so it does not collide with an embedder's own messages.
+ */
+export declare const PREVIEW_THEME_MESSAGE = "pretext-html:set-theme";
+export interface PreviewThemeMessage {
+    type: typeof PREVIEW_THEME_MESSAGE;
+    theme: PreviewTheme;
+}
+/** True when `value` is one of the three {@link PreviewTheme} strings. */
+export declare function isPreviewTheme(value: unknown): value is PreviewTheme;
+/**
+ * Build the message an embedder posts to a rendered preview to set its theme.
+ * Send it with `webview.postMessage(...)` (VS Code), `iframe.contentWindow
+ * .postMessage(..., "*")` (embedded), or `window.postMessage(...)` (inline).
+ */
+export declare function previewThemeMessage(theme: PreviewTheme): PreviewThemeMessage;
+/**
+ * The inline `<script>` (as a string) that wires a rendered page to the
+ * embedder's theme. Injected into the page `<head>` by the renderer when
+ * `RenderOptions.theme` is set; `initial` is baked in as the starting theme.
+ *
+ * Written in ES5-ish, self-contained JS because it is embedded verbatim in the
+ * output page (no bundler runs over it) and re-executes on every in-place
+ * `document.write` rebuild. It is idempotent: handlers are keyed on `window`
+ * and removed before being re-added, and the last requested theme persists on
+ * `window` so a rebuilt document re-applies it rather than snapping back to
+ * `initial`.
+ */
+export declare function themeBridgeScript(initial: PreviewTheme): string;
+/**
+ * Inject the theme bridge script into a rendered HTML page's `<head>` (as
+ * early as possible, to minimise any flash). Returns the page unchanged when
+ * it has no recognisable `<head>`.
+ */
+export declare function injectThemeBridge(html: string, theme: PreviewTheme): string;

package/dist/theme.js

@@ -0,0 +1,93 @@
+const n = "pretext-html:set-theme";
+function i(e) {
+  return e === "dark" || e === "light" || e === "system";
+}
+function d(e) {
+  return { type: n, theme: e };
+}
+function a(e) {
+  return [
+    "<script>",
+    "(function () {",
+    "  var CFG = " + JSON.stringify({ msg: n, initial: e }) + ";",
+    // Where the last requested theme is remembered so it survives an in-place
+    // document rewrite (same Window) and outranks the baked initial value.
+    "  var KEY = '__ptxPreviewTheme';",
+    "  var MEDIA = '(prefers-color-scheme: dark)';",
+    "  function isTheme(v) {",
+    "    return v === 'dark' || v === 'light' || v === 'system';",
+    "  }",
+    "  function prefersDark() {",
+    "    return !!(window.matchMedia && window.matchMedia(MEDIA).matches);",
+    "  }",
+    "  function resolveDark(theme) {",
+    "    if (theme === 'dark') return true;",
+    "    if (theme === 'light') return false;",
+    "    return prefersDark();",
+    // "system"
+    "  }",
+    "  function current() {",
+    "    return isTheme(window[KEY]) ? window[KEY] : CFG.initial;",
+    "  }",
+    // A theme with no dark variant marks the root data-darkmode="disabled";
+    // never force dark mode on in that case (mirrors setDarkMode's own guard).
+    "  function darkModeDisabled() {",
+    "    var el = document.documentElement;",
+    "    return !!(el && el.dataset && el.dataset.darkmode === 'disabled');",
+    "  }",
+    "  function apply(theme) {",
+    "    window[KEY] = theme;",
+    "    if (darkModeDisabled()) return;",
+    "    var dark = resolveDark(theme);",
+    // Toggle the class setDarkMode would set, right now, so an explicit theme
+    // does not flash before pretext-core.js defines setDarkMode. setDarkMode
+    // (once available) then does the complete job, including iframes.
+    "    var el = document.documentElement;",
+    "    if (el && el.classList) { el.classList.toggle('dark-mode', dark); }",
+    "    if (typeof window.setDarkMode === 'function') { window.setDarkMode(dark); }",
+    "  }",
+    "  function reapply() { apply(current()); }",
+    // Immediately (no-op until setDarkMode exists), then again once the page's
+    // own script has defined it.
+    "  reapply();",
+    "  document.addEventListener('DOMContentLoaded', reapply);",
+    "  window.addEventListener('load', reapply);",
+    // Embedder -> preview live updates.
+    "  if (window.__ptxThemeMsgHandler) {",
+    "    window.removeEventListener('message', window.__ptxThemeMsgHandler);",
+    "  }",
+    "  window.__ptxThemeMsgHandler = function (event) {",
+    "    var data = event && event.data;",
+    "    if (data && data.type === CFG.msg && isTheme(data.theme)) {",
+    "      apply(data.theme);",
+    "    }",
+    "  };",
+    "  window.addEventListener('message', window.__ptxThemeMsgHandler);",
+    // Track OS changes while following the system theme.
+    "  if (window.matchMedia) {",
+    "    var mq = window.matchMedia(MEDIA);",
+    "    if (window.__ptxThemeMediaHandler) {",
+    "      try { mq.removeEventListener('change', window.__ptxThemeMediaHandler); } catch (e) {}",
+    "    }",
+    "    window.__ptxThemeMediaHandler = function () {",
+    "      if (current() === 'system') { reapply(); }",
+    "    };",
+    "    try { mq.addEventListener('change', window.__ptxThemeMediaHandler); } catch (e) {}",
+    "  }",
+    "})();",
+    "<\/script>"
+  ].join(`
+`);
+}
+function o(e, t) {
+  const r = a(t);
+  return /<head[^>]*>/i.test(e) ? e.replace(/<head([^>]*)>/i, `<head$1>
+${r}`) : e;
+}
+export {
+  n as PREVIEW_THEME_MESSAGE,
+  o as injectThemeBridge,
+  i as isPreviewTheme,
+  d as previewThemeMessage,
+  a as themeBridgeScript
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pretextbook/pretext-html",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Convert PreTeXt documents to HTML in pure JavaScript using the official PreTeXt XSLT stylesheets via libxslt-wasm. No Python or PreTeXt installation required.",
   "author": "Oscar Levin",
   "license": "MIT",
@@ -16,6 +16,13 @@
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
+  "typesVersions": {
+    "*": {
+      "theme": [
+        "./dist/theme.d.ts"
+      ]
+    }
+  },
   "bin": {
     "pretext-html": "./cli.mjs"
   },
@@ -25,6 +32,11 @@
       "import": "./dist/index.js",
       "default": "./dist/index.js"
     },
+    "./theme": {
+      "types": "./dist/theme.d.ts",
+      "import": "./dist/theme.js",
+      "default": "./dist/theme.js"
+    },
     "./cli": "./dist/cli.js"
   },
   "sideEffects": false,
@@ -44,7 +56,7 @@
     "xast-util-to-xml": "^4.0.0"
   },
   "engines": {
-    "node": ">=22"
+    "node": ">=24"
   },
   "publishConfig": {
     "access": "public"