@pretextbook/pretext-html 0.1.0 → 0.2.0

package/dist/index.browser.js

@@ -0,0 +1,650 @@
+import { fromXml as x } from "xast-util-from-xml";
+import { toXml as y } from "xast-util-to-xml";
+const T = "/";
+function ie(e) {
+  if (!e)
+    return ".";
+  const t = e.startsWith("/"), n = e.length > 1 && e.endsWith("/"), r = [];
+  for (const o of e.split("/"))
+    if (!(!o || o === ".")) {
+      if (o === "..") {
+        const a = r[r.length - 1];
+        r.length > 0 && a !== ".." ? r.pop() : t || r.push("..");
+        continue;
+      }
+      r.push(o);
+    }
+  let i = r.join("/");
+  return t && (i = `/${i}`), i ? (n && !i.endsWith("/") && (i += "/"), i) : t ? "/" : ".";
+}
+function h(...e) {
+  let t = "";
+  for (let r = e.length - 1; r >= 0; r--) {
+    const i = e[r];
+    if (i && (t = t ? `${i}/${t}` : i, i.startsWith("/")))
+      break;
+  }
+  t.startsWith("/") || (t = `/${t}`);
+  const n = ie(t);
+  return n.length > 1 && n.endsWith("/") ? n.slice(0, -1) : n;
+}
+function E(e) {
+  const t = e.replace(/\/+$/, "");
+  if (!t)
+    return e.startsWith("/") ? "/" : ".";
+  const n = t.lastIndexOf("/");
+  return n < 0 ? "." : n === 0 ? "/" : t.slice(0, n);
+}
+function F(e, t) {
+  const n = h(e).split("/").filter(Boolean), r = h(t).split("/").filter(Boolean);
+  let i = 0;
+  for (; i < n.length && i < r.length && n[i] === r[i]; )
+    i += 1;
+  return [...new Array(n.length - i).fill(".."), ...r.slice(i)].join("/");
+}
+const oe = "https://cdn.jsdelivr.net/npm/@pretextbook/pretext-html@0.2.0/assets";
+let O;
+function Ae(e) {
+  O = e.replace(/\/+$/, "");
+}
+function v() {
+  return O ?? oe;
+}
+function H(e, t) {
+  return `${e.replace(/\/+$/, "")}/${t.replace(/^\/+/, "")}`;
+}
+const j = /* @__PURE__ */ new Map();
+function se(e) {
+  return `${e.replace(/\/+$/, "")}-bundle.json`;
+}
+function ae(e) {
+  let t = j.get(e);
+  return t || (t = (async () => {
+    try {
+      const n = await fetch(se(e));
+      if (!n.ok)
+        return /* @__PURE__ */ new Map();
+      const r = await n.json();
+      return new Map(Object.entries(r));
+    } catch {
+      return /* @__PURE__ */ new Map();
+    }
+  })(), j.set(e, t)), t;
+}
+function ce(e) {
+  return e === H(v(), "xsl");
+}
+async function N(e, t) {
+  if (ce(e)) {
+    const o = (await ae(e)).get(t.replace(/^\/+/, ""));
+    if (o !== void 0)
+      return new TextEncoder().encode(o);
+  }
+  const n = `${e.replace(/\/+$/, "")}/`;
+  let r;
+  try {
+    r = new URL(t.replace(/^\/+/, ""), n);
+  } catch {
+    return;
+  }
+  if (!r.href.startsWith(n)) {
+    console.error(
+      `pretext-html: refusing to serve ${t} from outside ${e}`
+    );
+    return;
+  }
+  try {
+    const i = await fetch(r.href);
+    return i.ok ? new Uint8Array(await i.arrayBuffer()) : void 0;
+  } catch {
+    return;
+  }
+}
+async function S(e) {
+  if (/^[a-z][a-z0-9+.-]*:\/\//i.test(e))
+    try {
+      const t = await fetch(e);
+      return t.ok ? await t.text() : void 0;
+    } catch {
+      return;
+    }
+}
+const D = /* @__PURE__ */ new Map(), J = /* @__PURE__ */ new Map();
+let I, le = 0, Y = N;
+function Re(e) {
+  Y = e;
+}
+function ue(e, t) {
+  const n = typeof e == "string" ? e : e instanceof URL ? e.href : e.url, r = J.get(n);
+  if (r !== void 0)
+    return Promise.resolve(new Response(r, { status: 200 }));
+  let i;
+  try {
+    i = new URL(n).host;
+  } catch {
+    i = "";
+  }
+  const o = D.get(i);
+  return o !== void 0 ? fe(o, n) : I(e, t);
+}
+const de = '<?xml version="1.0"?><pretext-preview-missing-file/>';
+async function fe(e, t) {
+  const n = decodeURIComponent(new URL(t).pathname), r = await Y(e, n);
+  if (r === void 0)
+    return new Response(de, { status: 200 });
+  const i = typeof r == "string" ? r : new Uint8Array(r);
+  return new Response(i, { status: 200 });
+}
+function z() {
+  I || (I = globalThis.fetch, globalThis.fetch = ue);
+}
+function G(e) {
+  z();
+  const t = `mnt${++le}.ptx.invalid`;
+  return D.set(t, e), `http://${t}`;
+}
+function he(e) {
+  D.delete(new URL(e).host);
+}
+function pe(e, t) {
+  z(), J.set(e, t);
+}
+const me = `<?xml version="1.0" encoding="UTF-8"?>
+<publication>
+  <source>
+    <directories external="../assets" generated="../generated-assets" />
+  </source>
+  <html>
+    <platform portable="yes"/>
+  </html>
+</publication>
+`;
+function K(e, t) {
+  for (const n of e.children)
+    if (n.type === "element" && n.name === t)
+      return n;
+}
+function A(e, t) {
+  let n = K(e, t);
+  return n || (n = { type: "element", name: t, attributes: {}, children: [] }, e.children.push(n)), n;
+}
+function R(e) {
+  if (!e)
+    return me;
+  const t = x(e), n = K(t, "publication");
+  if (!n)
+    throw new Error(
+      "Invalid publication file: no root <publication> element found"
+    );
+  const r = A(n, "html"), i = A(r, "platform");
+  return i.attributes = { ...i.attributes, portable: "yes" }, y(t);
+}
+const q = "http://www.w3.org/2001/XInclude", B = 64;
+async function we(e, t, n) {
+  return e.includes("include") ? (await V(e, t, n)).content : e;
+}
+async function V(e, t, n) {
+  const r = x(e), i = {
+    projectDir: h(n),
+    stack: [h(t)]
+  }, o = await g(
+    r,
+    E(h(t)),
+    { "": "" },
+    i
+  );
+  return { tree: r, content: o ? y(r) : e };
+}
+function ge(e) {
+  return e.data?.ptxIncludedFile;
+}
+function ye(e, t) {
+  const n = e.data ?? (e.data = {});
+  n.ptxIncludedFile = t;
+}
+function b(e, t) {
+  let n = e;
+  for (const [r, i] of Object.entries(t.attributes))
+    (r === "xmlns" || r.startsWith("xmlns:")) && (n === e && (n = { ...e }), n[r === "xmlns" ? "" : r.slice(6)] = i ?? "");
+  return n;
+}
+function Z(e, t) {
+  const n = e.name.indexOf(":"), r = n === -1 ? "" : e.name.slice(0, n);
+  return (n === -1 ? e.name : e.name.slice(n + 1)) === "include" && t[r] === q;
+}
+async function g(e, t, n, r) {
+  let i = !1;
+  for (let o = 0; o < e.children.length; o++) {
+    const a = e.children[o];
+    if (a.type !== "element")
+      continue;
+    const s = b(n, a);
+    if (Z(a, s)) {
+      const d = await Q(
+        a,
+        t,
+        s,
+        r
+      );
+      e.children.splice(o, 1, ...d), o += d.length - 1, i = !0;
+    } else await g(a, t, s, r) && (i = !0);
+  }
+  return i;
+}
+async function Q(e, t, n, r) {
+  const i = r.stack[r.stack.length - 1];
+  if (e.attributes.xpointer)
+    throw new Error(
+      `xi:include with xpointer is not supported by the JS preview build (in ${i})`
+    );
+  const o = e.attributes.href;
+  if (!o)
+    throw new Error(`xi:include without href (in ${i})`);
+  let a = o;
+  try {
+    a = decodeURIComponent(o);
+  } catch {
+  }
+  const s = h(t, a);
+  if (s !== r.projectDir && !s.startsWith(r.projectDir + T))
+    throw new Error(
+      `xi:include escapes the project directory: ${o} (in ${i})`
+    );
+  if (r.stack.includes(s))
+    throw new Error(
+      `Circular xi:include: ${[...r.stack, s].join(" -> ")}`
+    );
+  if (r.stack.length >= B)
+    throw new Error(`xi:include nesting exceeds ${B} levels`);
+  const d = await S(s);
+  if (d === void 0) {
+    const l = be(e, n);
+    if (l)
+      return await g(l, t, n, r), l.children;
+    throw new Error(`xi:include target not found: ${o} (in ${i})`);
+  }
+  if (e.attributes.parse === "text")
+    return [{ type: "text", value: d }];
+  let c;
+  try {
+    c = x(d);
+  } catch (l) {
+    throw new Error(
+      `Could not parse xi:include target ${s} as XML: ${l instanceof Error ? l.message : l}. (Included files must be well-formed, with a single root element.)`
+    );
+  }
+  r.stack.push(s);
+  try {
+    await g(c, E(s), { "": "" }, r);
+  } finally {
+    r.stack.pop();
+  }
+  const f = c.children.filter(
+    (l) => l.type === "element"
+  );
+  for (const l of f)
+    ye(l, s);
+  return f;
+}
+function X(e) {
+  return e.name === "docinfo";
+}
+async function ve(e, t, n) {
+  try {
+    const i = x(e).children.find(
+      (c) => c.type === "element"
+    );
+    if (!i)
+      return;
+    const o = h(t), a = E(o), s = {
+      projectDir: h(n),
+      stack: [o]
+    }, d = b({ "": "" }, i);
+    for (const c of i.children) {
+      if (c.type !== "element")
+        continue;
+      const f = b(d, c);
+      if (X(c))
+        return await g(c, a, f, s), y(c);
+      if (Z(c, f)) {
+        const p = (await Q(
+          c,
+          a,
+          f,
+          s
+        )).find(
+          (m) => m.type === "element" && X(m)
+        );
+        if (p)
+          return y(p);
+        continue;
+      }
+      break;
+    }
+    return;
+  } catch {
+    return;
+  }
+}
+function be(e, t) {
+  for (const n of e.children) {
+    if (n.type !== "element")
+      continue;
+    const r = b(t, n), i = n.name.indexOf(":"), o = i === -1 ? "" : n.name.slice(0, i);
+    if ((i === -1 ? n.name : n.name.slice(i + 1)) === "fallback" && r[o] === q)
+      return n;
+  }
+}
+function ee(e) {
+  return typeof e == "object" && e !== null && e.type === "element";
+}
+function xe(e) {
+  return /^(pf|xhtml):/.test(e.name);
+}
+function Ee(e, t, n) {
+  const r = [], i = e.children.find(ee);
+  if (i) {
+    const o = n?.parentId ?? "root";
+    te(i, o, n?.position ?? 1, t, o, r);
+  }
+  return r;
+}
+function te(e, t, n, r, i, o) {
+  const a = ge(e) ?? r;
+  let s, d;
+  if (xe(e))
+    d = "root";
+  else {
+    const f = e.attributes.label ?? e.attributes["xml:id"];
+    s = f ?? `${t}-${n}`, o.push({
+      id: s,
+      file: a,
+      line: e.position?.start.line ?? 1,
+      column: e.position?.start.column ?? 1,
+      endLine: e.position?.end.line ?? e.position?.start.line ?? 1,
+      parent: i
+    }), d = s;
+  }
+  let c = 0;
+  for (const f of e.children)
+    ee(f) && (c += 1, te(
+      f,
+      d,
+      c,
+      a,
+      s ?? i,
+      o
+    ));
+}
+function Be(e, t) {
+  let n;
+  for (const r of e)
+    r.line <= t && (n = r);
+  return n ?? e[0];
+}
+const ne = "pretext-html:set-theme";
+function Xe(e) {
+  return e === "dark" || e === "light" || e === "system";
+}
+function Ce(e) {
+  return { type: ne, theme: e };
+}
+function $e(e) {
+  return [
+    "<script>",
+    "(function () {",
+    "  var CFG = " + JSON.stringify({ msg: ne, 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 ke(e, t) {
+  const n = $e(t);
+  return /<head[^>]*>/i.test(e) ? e.replace(/<head([^>]*)>/i, `<head$1>
+${n}`) : e;
+}
+function Me() {
+  return H(v(), "xsl");
+}
+function Te() {
+  return "Suspending" in WebAssembly;
+}
+function Ie() {
+  if (!Te())
+    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)."
+    );
+}
+function C(e) {
+  return e.includes("'") ? e.includes('"') ? `concat(${e.split("'").map((n) => `'${n}'`).join(`, "'", `)})` : `"${e}"` : `'${e}'`;
+}
+function Se(e) {
+  return e.replace(
+    /from '\.\/(https:\/\/[^']+)'/g,
+    (t, n) => `from '${n}'`
+  );
+}
+function De(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 W(e) {
+  const t = await S(e);
+  if (t === void 0)
+    throw new Error(
+      `Could not read ${e}. (In the browser build only absolute URLs are readable — pass sourceContent instead of relying on sourcePath.)`
+    );
+  return t;
+}
+async function _e(e, t) {
+  const n = h(e), r = await S(n);
+  if (r !== void 0)
+    return ve(r, n, t);
+}
+function Le(e, t, n) {
+  const r = e.replace(/^\uFEFF/, "").replace(/<\?xml[\s\S]*?\?>/, "").replace(/<!DOCTYPE[^>]*>/i, ""), i = t === "chapter" || t === "part" ? "book" : "article";
+  return `<pretext>
+${n?.trim() ? `${n.trim()}
+` : ""}<${i}>
+<title/>
+${r}
+</${i}>
+</pretext>
+`;
+}
+function U(e) {
+  if (e instanceof Error && /memory access|out of bounds/i.test(e.message))
+    throw new Error(
+      "The document is too large for the current WebAssembly build (stack overflow). Whole-book builds are a known limitation; try a smaller document, or see the README about rebuilding libxslt-wasm with a larger stack.",
+      { cause: e }
+    );
+}
+let k;
+async function re() {
+  return k || (k = (async () => {
+    const [e, t] = await Promise.all([
+      import("@pretextbook/libxslt-wasm"),
+      import("@pretextbook/libxslt-wasm/exslt")
+    ]);
+    return t.registerAll(), e;
+  })()), k;
+}
+const M = /* @__PURE__ */ new Map();
+async function Pe(e) {
+  const t = e;
+  let n = M.get(t);
+  return n || (n = (async () => {
+    const { XmlDocument: r, XsltStylesheet: i } = await re(), o = G(t), a = await N(
+      v(),
+      "/preview-html.xsl"
+    );
+    if (a === void 0)
+      throw new Error(
+        `Could not read preview-html.xsl from ${v()}. Check the assets location (PRETEXT_HTML_ASSETS under Node, setAssetsBase() in the browser).`
+      );
+    const s = new TextDecoder().decode(a), d = await r.fromString(s, {
+      url: `${o}/preview-html.xsl`,
+      options: { noEnt: !0, dtdLoad: !0, huge: !0 }
+    });
+    return i.fromXmlDocument(d);
+  })(), M.set(t, n), n.catch(() => M.delete(t))), n;
+}
+async function We(e) {
+  Ie();
+  const { XmlDocument: t } = await re(), n = await Pe(e.xslDir ?? Me()), r = h(e.sourcePath), i = h(
+    e.projectDir ?? E(r)
+  ), o = e.sourceContent ?? await W(r), a = F(i, r);
+  if (a.startsWith(".."))
+    throw new Error(
+      `sourcePath (${r}) must live inside projectDir (${i})`
+    );
+  const s = G(i);
+  try {
+    let d, c = `${s}/__pretext-preview-publication.xml`;
+    if (e.publicationPath) {
+      const u = h(e.publicationPath);
+      d = R(
+        await W(u)
+      );
+      const w = F(i, u);
+      w.startsWith("..") || (c = `${s}/${w.split(T).join("/")}`);
+    } else
+      d = R();
+    pe(c, d);
+    let f, l;
+    if (e.sourceMap) {
+      const u = await V(
+        o,
+        r,
+        i
+      );
+      f = u.tree, l = u.content;
+    } else
+      l = await we(
+        o,
+        r,
+        i
+      );
+    const p = De(l);
+    let m = { parentId: "root", position: 1 };
+    if (p !== "pretext" && p !== "mathbook")
+      if (e.fragment) {
+        const u = e.docinfo ?? (e.docinfoSourcePath ? await _e(e.docinfoSourcePath, i) : void 0);
+        l = Le(l, p, u), m = { parentId: u?.trim() ? "root-1-2" : "root-1-1", position: 2 };
+      } else
+        throw new Error(
+          `The document root is <${p ?? "?"}>, not <pretext> — this looks like an xi:included fragment. Render the project's main source file instead, or pass the fragment option.`
+        );
+    const _ = f ? Ee(f, r, m) : void 0, L = await t.fromString(l, {
+      url: `${s}/${a.split(T).join("/")}`,
+      options: { noEnt: !0, dtdLoad: !0, huge: !0 }
+    }), P = {
+      publisher: C(c)
+    };
+    for (const [u, w] of Object.entries(e.stringParams ?? {}))
+      P[u] = C(w);
+    let $;
+    try {
+      $ = await n.apply(L, P);
+    } catch (u) {
+      throw U(u), new Error(
+        "PreTeXt XSLT transform failed; see the PTX:ERROR/PTX:FATAL messages on stderr for details.",
+        { cause: u }
+      );
+    } finally {
+      L.delete();
+    }
+    try {
+      let u = Se($.toHtmlString());
+      return e.theme && (u = ke(u, e.theme)), {
+        html: u,
+        ..._ ? { sourceMap: _ } : {}
+      };
+    } catch (u) {
+      throw U(u), u;
+    } finally {
+      $.delete();
+    }
+  } finally {
+    he(s);
+  }
+}
+export {
+  ne as PREVIEW_THEME_MESSAGE,
+  Me as defaultXslDir,
+  Be as findSourceMapEntry,
+  R as forcePortablePublication,
+  ke as injectThemeBridge,
+  Te as isJspiAvailable,
+  Xe as isPreviewTheme,
+  Ce as previewThemeMessage,
+  We as renderHtml,
+  Ae as setAssetsBase,
+  Re as setMountReader,
+  $e as themeBridgeScript,
+  C as xpathStringLiteral
+};

package/dist/index.d.ts

@@ -3,4 +3,9 @@ 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';
+export { setAssetsBase } from './host.js';
+export { setMountReader } from './mounts.js';
+export type { MountReader } from './mounts.js';

package/dist/index.js

@@ -1,10 +1,18 @@
-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 a, f as r, a as i, i as t, r as l, m as o, s as m, b as n, x as d } from "./cli-B2LiKunq.js";
+import { PREVIEW_THEME_MESSAGE as E, injectThemeBridge as f, isPreviewTheme as c, previewThemeMessage as h, themeBridgeScript as u } from "./theme.js";
 export {
-  i as defaultXslDir,
-  s as findSourceMapEntry,
-  e as forcePortablePublication,
-  l as isJspiAvailable,
-  t as renderHtml,
-  n as runCli,
-  o as xpathStringLiteral
+  E as PREVIEW_THEME_MESSAGE,
+  a as defaultXslDir,
+  r as findSourceMapEntry,
+  i as forcePortablePublication,
+  f as injectThemeBridge,
+  t as isJspiAvailable,
+  c as isPreviewTheme,
+  h as previewThemeMessage,
+  l as renderHtml,
+  o as runCli,
+  m as setAssetsBase,
+  n as setMountReader,
+  u as themeBridgeScript,
+  d as xpathStringLiteral
 };