@pretextbook/pretext-html 0.4.0 → 0.6.0

package/dist/cli-Cp6C0sif.js

@@ -1,654 +0,0 @@
-import { readFile as j, writeFile as _ } from "node:fs/promises";
-import * as w from "node:process";
-import * as c from "node:path";
-import { fileURLToPath as fe } from "node:url";
-import { fromXml as v } from "xast-util-from-xml";
-import { toXml as T } from "xast-util-to-xml";
-import { injectThemeBridge as he } from "./theme.js";
-async function Z(e, r) {
-  const t = c.resolve(e), n = c.resolve(t, `.${c.posix.normalize(r)}`);
-  if (n !== t && !n.startsWith(t + c.sep)) {
-    console.error(
-      `pretext-html: refusing to serve ${r} from outside ${t}`
-    );
-    return;
-  }
-  try {
-    return new Uint8Array(await j(n));
-  } catch {
-    return;
-  }
-}
-async function F(e) {
-  try {
-    return await j(e, "utf8");
-  } catch {
-    return;
-  }
-}
-let K;
-function Qe(e) {
-  K = e;
-}
-function I() {
-  return K ?? process.env.PRETEXT_HTML_ASSETS ?? c.resolve(c.dirname(fe(import.meta.url)), "..", "assets");
-}
-function me(e, r) {
-  return c.join(e, r);
-}
-const L = /* @__PURE__ */ new Map(), ee = /* @__PURE__ */ new Map();
-let M, pe = 0, te = Z;
-function Ve(e) {
-  te = e;
-}
-function we(e, r) {
-  const t = typeof e == "string" ? e : e instanceof URL ? e.href : e.url, n = ee.get(t);
-  if (n !== void 0)
-    return Promise.resolve(new Response(n, { status: 200 }));
-  let o;
-  try {
-    o = new URL(t).host;
-  } catch {
-    o = "";
-  }
-  const i = L.get(o);
-  return i !== void 0 ? ge(i, t) : M(e, r);
-}
-const be = '<?xml version="1.0"?><pretext-preview-missing-file/>';
-async function ge(e, r) {
-  const t = decodeURIComponent(new URL(r).pathname), n = await te(e, t);
-  if (n === void 0)
-    return new Response(be, { status: 200 });
-  const o = typeof n == "string" ? n : new Uint8Array(n);
-  return new Response(o, { status: 200 });
-}
-function re() {
-  M || (M = globalThis.fetch, globalThis.fetch = we);
-}
-function ne(e) {
-  re();
-  const r = `mnt${++pe}.ptx.invalid`;
-  return L.set(r, e), `http://${r}`;
-}
-function ye(e) {
-  L.delete(new URL(e).host);
-}
-function xe(e, r) {
-  re(), ee.set(e, r);
-}
-const A = `<?xml version="1.0" encoding="UTF-8"?>
-<publication>
-  <source>
-    <directories external="../assets" generated="../generated-assets" />
-  </source>
-  <html>
-    <platform portable="yes"/>
-  </html>
-</publication>
-`, ve = ["theme", "style", "shell"];
-function b(e, r) {
-  for (const t of e.children)
-    if (t.type === "element" && t.name === r)
-      return t;
-}
-function X(e, r) {
-  let t = b(e, r);
-  return t || (t = { type: "element", name: r, attributes: {}, children: [] }, e.children.push(t)), t;
-}
-function Ee(e, r) {
-  const t = b(e, "css");
-  if (t && ve.some((o) => t.attributes?.[o]))
-    return;
-  const n = t ?? X(e, "css");
-  n.attributes = { ...n.attributes, theme: r };
-}
-function Te(e, r) {
-  const t = r?.trim();
-  if (!e && !t)
-    return A;
-  const n = v(e ?? A), o = b(n, "publication");
-  if (!o)
-    throw new Error(
-      "Invalid publication file: no root <publication> element found"
-    );
-  const i = X(o, "html"), a = X(i, "platform");
-  return a.attributes = { ...a.attributes, portable: "yes" }, t && Ee(i, t), T(n);
-}
-function H(e) {
-  if (!(e === void 0 || e === "" || e.startsWith("/")))
-    return e.endsWith("/") ? e : `${e}/`;
-}
-function $e(e) {
-  const r = v(e ?? A), t = b(r, "publication"), n = t && b(t, "source"), o = n && b(n, "directories"), i = H(
-    o?.attributes?.external ?? void 0
-  ), a = H(
-    o?.attributes?.generated ?? void 0
-  );
-  return {
-    external: i,
-    generated: a,
-    managed: i !== void 0 && a !== void 0
-  };
-}
-const oe = "http://www.w3.org/2001/XInclude", N = 64;
-async function Pe(e, r, t) {
-  return e.includes("include") ? (await ie(e, r, t)).content : e;
-}
-async function ie(e, r, t) {
-  const n = v(e), o = {
-    projectDir: c.resolve(t),
-    stack: [c.resolve(r)]
-  }, i = await x(
-    n,
-    c.dirname(c.resolve(r)),
-    { "": "" },
-    o
-  );
-  return { tree: n, content: i ? T(n) : e };
-}
-function ke(e) {
-  return e.data?.ptxIncludedFile;
-}
-function Se(e, r) {
-  const t = e.data ?? (e.data = {});
-  t.ptxIncludedFile = r;
-}
-function $(e, r) {
-  let t = e;
-  for (const [n, o] of Object.entries(r.attributes))
-    (n === "xmlns" || n.startsWith("xmlns:")) && (t === e && (t = { ...e }), t[n === "xmlns" ? "" : n.slice(6)] = o ?? "");
-  return t;
-}
-function se(e, r) {
-  const t = e.name.indexOf(":"), n = t === -1 ? "" : e.name.slice(0, t);
-  return (t === -1 ? e.name : e.name.slice(t + 1)) === "include" && r[n] === oe;
-}
-async function x(e, r, t, n) {
-  let o = !1;
-  for (let i = 0; i < e.children.length; i++) {
-    const a = e.children[i];
-    if (a.type !== "element")
-      continue;
-    const s = $(t, a);
-    if (se(a, s)) {
-      const u = await ae(
-        a,
-        r,
-        s,
-        n
-      );
-      e.children.splice(i, 1, ...u), i += u.length - 1, o = !0;
-    } else await x(a, r, s, n) && (o = !0);
-  }
-  return o;
-}
-async function ae(e, r, t, n) {
-  const o = n.stack[n.stack.length - 1];
-  if (e.attributes.xpointer)
-    throw new Error(
-      `xi:include with xpointer is not supported by the JS preview build (in ${o})`
-    );
-  const i = e.attributes.href;
-  if (!i)
-    throw new Error(`xi:include without href (in ${o})`);
-  let a = i;
-  try {
-    a = decodeURIComponent(i);
-  } catch {
-  }
-  const s = c.resolve(r, a);
-  if (s !== n.projectDir && !s.startsWith(n.projectDir + c.sep))
-    throw new Error(
-      `xi:include escapes the project directory: ${i} (in ${o})`
-    );
-  if (n.stack.includes(s))
-    throw new Error(
-      `Circular xi:include: ${[...n.stack, s].join(" -> ")}`
-    );
-  if (n.stack.length >= N)
-    throw new Error(`xi:include nesting exceeds ${N} levels`);
-  const u = await F(s);
-  if (u === void 0) {
-    const d = Ie(e, t);
-    if (d)
-      return await x(d, r, t, n), d.children;
-    throw new Error(`xi:include target not found: ${i} (in ${o})`);
-  }
-  if (e.attributes.parse === "text")
-    return [{ type: "text", value: u }];
-  let l;
-  try {
-    l = v(u);
-  } catch (d) {
-    throw new Error(
-      `Could not parse xi:include target ${s} as XML: ${d instanceof Error ? d.message : d}. (Included files must be well-formed, with a single root element.)`
-    );
-  }
-  n.stack.push(s);
-  try {
-    await x(l, c.dirname(s), { "": "" }, n);
-  } finally {
-    n.stack.pop();
-  }
-  const f = l.children.filter(
-    (d) => d.type === "element"
-  );
-  for (const d of f)
-    Se(d, s);
-  return f;
-}
-function J(e) {
-  return e.name === "docinfo";
-}
-async function De(e, r, t) {
-  try {
-    const o = v(e).children.find(
-      (l) => l.type === "element"
-    );
-    if (!o)
-      return;
-    const i = c.resolve(r), a = c.dirname(i), s = {
-      projectDir: c.resolve(t),
-      stack: [i]
-    }, u = $({ "": "" }, o);
-    for (const l of o.children) {
-      if (l.type !== "element")
-        continue;
-      const f = $(u, l);
-      if (J(l))
-        return await x(l, a, f, s), T(l);
-      if (se(l, f)) {
-        const g = (await ae(
-          l,
-          a,
-          f,
-          s
-        )).find(
-          (m) => m.type === "element" && J(m)
-        );
-        if (g)
-          return T(g);
-        continue;
-      }
-      break;
-    }
-    return;
-  } catch {
-    return;
-  }
-}
-function Ie(e, r) {
-  for (const t of e.children) {
-    if (t.type !== "element")
-      continue;
-    const n = $(r, t), o = t.name.indexOf(":"), i = o === -1 ? "" : t.name.slice(0, o);
-    if ((o === -1 ? t.name : t.name.slice(o + 1)) === "fallback" && n[i] === oe)
-      return t;
-  }
-}
-function ce(e) {
-  return typeof e == "object" && e !== null && e.type === "element";
-}
-function Me(e) {
-  return /^(pf|xhtml):/.test(e.name);
-}
-function Ae(e, r, t) {
-  const n = [], o = e.children.find(ce);
-  if (o) {
-    const i = t?.parentId ?? "root";
-    le(o, i, t?.position ?? 1, r, i, n);
-  }
-  return n;
-}
-function le(e, r, t, n, o, i) {
-  const a = ke(e) ?? n;
-  let s, u;
-  if (Me(e))
-    u = "root";
-  else {
-    const f = e.attributes.label ?? e.attributes["xml:id"];
-    s = f ?? `${r}-${t}`, i.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: o
-    }), u = s;
-  }
-  let l = 0;
-  for (const f of e.children)
-    ce(f) && (l += 1, le(
-      f,
-      u,
-      l,
-      a,
-      s ?? o,
-      i
-    ));
-}
-function Ze(e, r) {
-  let t;
-  for (const n of e)
-    n.line <= r && (t = n);
-  return t ?? e[0];
-}
-function Xe() {
-  return me(I(), "xsl");
-}
-function je() {
-  return "Suspending" in WebAssembly;
-}
-function Fe() {
-  if (!je())
-    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 z(e) {
-  return e.includes("'") ? e.includes('"') ? `concat(${e.split("'").map((t) => `'${t}'`).join(`, "'", `)})` : `"${e}"` : `'${e}'`;
-}
-function Le(e) {
-  return e.replace(
-    /from '\.\/(https:\/\/[^']+)'/g,
-    (r, t) => `from '${t}'`
-  );
-}
-function Re(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 q(e) {
-  const r = await F(e);
-  if (r === 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 r;
-}
-async function Ue(e, r) {
-  const t = c.resolve(e), n = await F(t);
-  if (n !== void 0)
-    return De(n, t, r);
-}
-function Ce(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()}
-` : ""}<${o}>
-<title/>
-${n}
-</${o}>
-</pretext>
-`;
-}
-let ue = !1;
-function We(e) {
-  return e instanceof Error && /\bAborted\(/.test(e.message);
-}
-function Be(e) {
-  return e instanceof Error && /memory access|out of bounds/i.test(e.message);
-}
-function Oe() {
-  if (ue)
-    throw new Error(
-      "The WebAssembly renderer aborted earlier in this process and cannot be reused. Restart the process (or reload the page) to render again."
-    );
-}
-function G(e) {
-  if (We(e))
-    throw ue = !0, new Error(
-      "The WebAssembly renderer aborted and cannot be reused. Restart the process (or reload the page) to render again.",
-      { cause: e }
-    );
-  if (Be(e))
-    throw new Error(
-      "The WebAssembly renderer hit a memory fault. Most often the document is too large for this build's stack — whole-book builds are a known limitation, so try a smaller document, or see the README about rebuilding libxslt-wasm with a larger stack. The same fault also results from running two renders concurrently against the shared libxslt state.",
-      { cause: e }
-    );
-}
-let S;
-async function de() {
-  return S || (S = (async () => {
-    const [e, r] = await Promise.all([
-      import("@pretextbook/libxslt-wasm"),
-      import("@pretextbook/libxslt-wasm/exslt")
-    ]);
-    return r.registerAll(), e;
-  })()), S;
-}
-const D = /* @__PURE__ */ new Map();
-async function _e(e) {
-  const r = e;
-  let t = D.get(r);
-  return t || (t = (async () => {
-    const { XmlDocument: n, XsltStylesheet: o } = await de(), i = ne(r), a = await Z(
-      I(),
-      "/preview-html.xsl"
-    );
-    if (a === void 0)
-      throw new Error(
-        `Could not read preview-html.xsl from ${I()}. Check the assets location (PRETEXT_HTML_ASSETS under Node, setAssetsBase() in the browser).`
-      );
-    const s = new TextDecoder().decode(a), u = await n.fromString(s, {
-      url: `${i}/preview-html.xsl`,
-      options: { noEnt: !0, dtdLoad: !0, huge: !0 }
-    });
-    return o.fromXmlDocument(u);
-  })(), D.set(r, t), t.catch(() => D.delete(r))), t;
-}
-let Y = Promise.resolve();
-function He(e) {
-  const r = Y.then(
-    () => Q(e),
-    () => Q(e)
-  );
-  return Y = r.catch(() => {
-  }), r;
-}
-async function Q(e) {
-  Fe(), Oe();
-  const { XmlDocument: r } = await de(), t = await _e(e.xslDir ?? Xe()), n = c.resolve(e.sourcePath), o = c.resolve(
-    e.projectDir ?? c.dirname(n)
-  ), i = e.sourceContent ?? await q(n), a = c.relative(o, n);
-  if (a.startsWith(".."))
-    throw new Error(
-      `sourcePath (${n}) must live inside projectDir (${o})`
-    );
-  const s = c.relative(
-    o,
-    c.resolve(e.mainSourcePath ?? n)
-  ), u = s.startsWith("..") ? a : s, l = ne(o);
-  try {
-    let f, d = `${l}/__pretext-preview-publication.xml`;
-    if (e.publicationPath) {
-      const h = c.resolve(e.publicationPath);
-      f = await q(h);
-      const y = c.relative(o, h);
-      y.startsWith("..") || (d = `${l}/${y.split(c.sep).join("/")}`);
-    }
-    const g = Te(
-      f,
-      e.cssTheme
-    );
-    xe(d, g);
-    const m = $e(g), R = c.dirname(c.resolve(o, u)), U = m.external !== void 0 && m.generated !== void 0 ? {
-      external: c.resolve(R, m.external),
-      generated: c.resolve(R, m.generated)
-    } : void 0;
-    let P, p;
-    if (e.sourceMap) {
-      const h = await ie(
-        i,
-        n,
-        o
-      );
-      P = h.tree, p = h.content;
-    } else
-      p = await Pe(
-        i,
-        n,
-        o
-      );
-    const E = Re(p);
-    let C = { parentId: "root", position: 1 };
-    if (E !== "pretext" && E !== "mathbook")
-      if (e.fragment) {
-        const h = e.docinfo ?? (e.docinfoSourcePath ? await Ue(e.docinfoSourcePath, o) : void 0);
-        p = Ce(p, E, h), C = { parentId: h?.trim() ? "root-1-2" : "root-1-1", position: 2 };
-      } else
-        throw new Error(
-          `The document root is <${E ?? "?"}>, not <pretext> — this looks like an xi:included fragment. Render the project's main source file instead, or pass the fragment option.`
-        );
-    const W = P ? Ae(P, n, C) : void 0, B = await r.fromString(p, {
-      url: `${l}/${u.split(c.sep).join("/")}`,
-      options: { noEnt: !0, dtdLoad: !0, huge: !0 }
-    }), O = {
-      publisher: z(d)
-    };
-    for (const [h, y] of Object.entries(e.stringParams ?? {}))
-      O[h] = z(y);
-    let k;
-    try {
-      k = await t.apply(B, O);
-    } catch (h) {
-      throw G(h), new Error(
-        "PreTeXt XSLT transform failed; see the PTX:ERROR/PTX:FATAL messages on stderr for details.",
-        { cause: h }
-      );
-    } finally {
-      B.delete();
-    }
-    try {
-      let h = Le(k.toHtmlString());
-      return e.theme && (h = he(h, e.theme)), {
-        html: h,
-        ...W ? { sourceMap: W } : {},
-        ...U ? { assetDirs: U } : {}
-      };
-    } catch (h) {
-      throw G(h), h;
-    } finally {
-      k.delete();
-    }
-  } finally {
-    ye(l);
-  }
-}
-const V = `Usage: pretext-html <source.ptx> [options]
-
-Render a PreTeXt document to a single standalone HTML page (portable build:
-one page, css/js/MathJax from CDN). No PreTeXt installation required.
-
-Options:
-  -o, --output <file>       Write HTML to a file instead of stdout
-  --publication <file>      Publication file (portable html is forced on)
-  --css-theme <name>        HTML theme to use when the publication file names
-                            none of its own: default-modern (PreTeXt's default),
-                            denver, tacoma, salem, greeley or boulder
-  --project-dir <dir>       Directory served to the transform for xi:includes
-                            (default: the source file's directory)
-  --param <name=value>      Extra XSLT string parameter (repeatable)
-  --xsl-dir <dir>           Use PreTeXt stylesheets from this directory
-                            instead of the vendored copy
-  --fragment                Allow a non-root source file: wrap the fragment
-                            in a minimal <pretext> document (an <article>,
-                            or a <book> for <chapter>/<part> fragments)
-  --docinfo <file>          File whose contents (a <docinfo> element) are
-                            injected into the wrapper in --fragment mode, so
-                            the fragment keeps the project's LaTeX macros
-  --docinfo-source <file>   Complete source file (e.g. main.ptx) to lift the
-                            <docinfo> from for --fragment mode, resolving
-                            xi:includes (used when --docinfo is not given)
-  --source-map <file>       Also write a JSON source map: HTML id → source
-                            file/line for every element (for editor sync)
-  -h, --help                Show this help
-`;
-function Ne(e) {
-  let r, t, n, o;
-  const i = {}, a = {};
-  for (let s = 0; s < e.length; s++) {
-    const u = e[s], l = () => {
-      if (s += 1, s >= e.length)
-        throw new Error(`Missing value for ${u}`);
-      return e[s];
-    };
-    switch (u) {
-      case "-h":
-      case "--help":
-        w.stdout.write(V), w.exit(0);
-        break;
-      case "-o":
-      case "--output":
-        t = l();
-        break;
-      case "--publication":
-        i.publicationPath = l();
-        break;
-      case "--css-theme":
-        i.cssTheme = l();
-        break;
-      case "--project-dir":
-        i.projectDir = l();
-        break;
-      case "--xsl-dir":
-        i.xslDir = l();
-        break;
-      case "--fragment":
-        i.fragment = !0;
-        break;
-      case "--docinfo":
-        n = l();
-        break;
-      case "--docinfo-source":
-        i.docinfoSourcePath = l();
-        break;
-      case "--source-map":
-        o = l(), i.sourceMap = !0;
-        break;
-      case "--param": {
-        const f = l(), d = f.indexOf("=");
-        if (d === -1)
-          throw new Error(`--param expects name=value, got: ${f}`);
-        a[f.slice(0, d)] = f.slice(d + 1);
-        break;
-      }
-      default:
-        if (u.startsWith("-"))
-          throw new Error(`Unknown option: ${u}`);
-        if (r)
-          throw new Error(`Unexpected extra argument: ${u}`);
-        r = u;
-    }
-  }
-  if (!r)
-    throw new Error(`No source file given.
-
-` + V);
-  return Object.keys(a).length > 0 && (i.stringParams = a), {
-    options: { ...i, sourcePath: r },
-    output: t,
-    docinfoPath: n,
-    sourceMapPath: o
-  };
-}
-async function Ke(e) {
-  const { options: r, output: t, docinfoPath: n, sourceMapPath: o } = Ne(e);
-  n && (r.docinfo = await j(n, "utf8"));
-  const i = Date.now(), { html: a, sourceMap: s } = await He(r);
-  w.stderr.write(`pretext-html: rendered in ${Date.now() - i}ms
-`), o && s && (await _(o, JSON.stringify(s, null, 2)), w.stderr.write(`pretext-html: wrote ${o}
-`)), t ? (await _(t, a), w.stderr.write(`pretext-html: wrote ${t}
-`)) : w.stdout.write(a);
-}
-export {
-  Te as a,
-  Ve as b,
-  Xe as d,
-  Ze as f,
-  je as i,
-  Ke as m,
-  Ne as p,
-  He as r,
-  Qe as s,
-  z as x
-};