@pretextbook/pretext-html 0.1.1 → 0.3.0

package/dist/cli-BQizBK0N.js

@@ -1,555 +0,0 @@
-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";
-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 }));
-  let o;
-  try {
-    o = new URL(t).host;
-  } catch {
-    o = "";
-  }
-  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 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(
-      `pretext-html: refusing to serve ${t} from outside ${e}`
-    ), new Response(F, { status: 200 });
-  try {
-    const o = await m(n);
-    return new Response(new Uint8Array(o), { status: 200 });
-  } catch {
-    return new Response(F, { status: 200 });
-  }
-}
-function B() {
-  S || (S = globalThis.fetch, globalThis.fetch = te);
-}
-function N(e) {
-  B();
-  const r = `mnt${++ee}.ptx.invalid`;
-  return T.set(r, c.resolve(e)), `http://${r}`;
-}
-function ne(e) {
-  T.delete(new URL(e).host);
-}
-function oe(e, r) {
-  B(), W.set(e, r);
-}
-const ie = `<?xml version="1.0" encoding="UTF-8"?>
-<publication>
-  <source>
-    <directories external="../assets" generated="../generated-assets" />
-  </source>
-  <html>
-    <platform portable="yes"/>
-  </html>
-</publication>
-`;
-function _(e, r) {
-  for (const t of e.children)
-    if (t.type === "element" && t.name === r)
-      return t;
-}
-function M(e, r) {
-  let t = _(e, r);
-  return t || (t = { type: "element", name: r, attributes: {}, children: [] }, e.children.push(t)), t;
-}
-function L(e) {
-  if (!e)
-    return ie;
-  const r = $(e), t = _(r, "publication");
-  if (!t)
-    throw new Error(
-      "Invalid publication file: no root <publication> element found"
-    );
-  const n = M(t, "html"), o = M(n, "platform");
-  return o.attributes = { ...o.attributes, portable: "yes" }, y(r);
-}
-const H = "http://www.w3.org/2001/XInclude", R = 64;
-async function se(e, r, t) {
-  return e.includes("include") ? (await J(e, r, t)).content : e;
-}
-async function J(e, r, t) {
-  const n = $(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 ? y(n) : e };
-}
-function ae(e) {
-  return e.data?.ptxIncludedFile;
-}
-function ce(e, r) {
-  const t = e.data ?? (e.data = {});
-  t.ptxIncludedFile = r;
-}
-function v(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 q(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] === H;
-}
-async function x(e, r, t, n) {
-  let o = !1;
-  for (let i = 0; i < e.children.length; i++) {
-    const l = e.children[i];
-    if (l.type !== "element")
-      continue;
-    const s = v(t, l);
-    if (q(l, s)) {
-      const f = await z(
-        l,
-        r,
-        s,
-        n
-      );
-      e.children.splice(i, 1, ...f), i += f.length - 1, o = !0;
-    } else await x(l, r, s, n) && (o = !0);
-  }
-  return o;
-}
-async function z(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 l = i;
-  try {
-    l = decodeURIComponent(i);
-  } catch {
-  }
-  const s = c.resolve(r, l);
-  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 >= R)
-    throw new Error(`xi:include nesting exceeds ${R} levels`);
-  let f;
-  try {
-    f = await m(s, "utf8");
-  } catch {
-    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})`);
-  }
-  if (e.attributes.parse === "text")
-    return [{ type: "text", value: f }];
-  let a;
-  try {
-    a = $(f);
-  } catch (u) {
-    throw new Error(
-      `Could not parse xi:include target ${s} as XML: ${u instanceof Error ? u.message : u}. (Included files must be well-formed, with a single root element.)`
-    );
-  }
-  n.stack.push(s);
-  try {
-    await x(a, c.dirname(s), { "": "" }, n);
-  } finally {
-    n.stack.pop();
-  }
-  const d = a.children.filter(
-    (u) => u.type === "element"
-  );
-  for (const u of d)
-    ce(u, s);
-  return d;
-}
-function A(e) {
-  return e.name === "docinfo";
-}
-async function le(e, r, t) {
-  try {
-    const o = $(e).children.find(
-      (a) => a.type === "element"
-    );
-    if (!o)
-      return;
-    const i = c.resolve(r), l = c.dirname(i), s = {
-      projectDir: c.resolve(t),
-      stack: [i]
-    }, f = v({ "": "" }, o);
-    for (const a of o.children) {
-      if (a.type !== "element")
-        continue;
-      const d = v(f, a);
-      if (A(a))
-        return await x(a, l, d, s), y(a);
-      if (q(a, d)) {
-        const h = (await z(
-          a,
-          l,
-          d,
-          s
-        )).find(
-          (g) => g.type === "element" && A(g)
-        );
-        if (h)
-          return y(h);
-        continue;
-      }
-      break;
-    }
-    return;
-  } catch {
-    return;
-  }
-}
-function ue(e, r) {
-  for (const t of e.children) {
-    if (t.type !== "element")
-      continue;
-    const n = v(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] === H)
-      return t;
-  }
-}
-function G(e) {
-  return typeof e == "object" && e !== null && e.type === "element";
-}
-function fe(e) {
-  return /^(pf|xhtml):/.test(e.name);
-}
-function de(e, r, t) {
-  const n = [], o = e.children.find(G);
-  if (o) {
-    const i = t?.parentId ?? "root";
-    Y(o, i, t?.position ?? 1, r, i, n);
-  }
-  return n;
-}
-function Y(e, r, t, n, o, i) {
-  const l = ae(e) ?? n;
-  let s, f;
-  if (fe(e))
-    f = "root";
-  else {
-    const d = e.attributes.label ?? e.attributes["xml:id"];
-    s = d ?? `${r}-${t}`, i.push({
-      id: s,
-      file: l,
-      line: e.position?.start.line ?? 1,
-      column: e.position?.start.column ?? 1,
-      endLine: e.position?.end.line ?? e.position?.start.line ?? 1,
-      parent: o
-    }), f = s;
-  }
-  let a = 0;
-  for (const d of e.children)
-    G(d) && (a += 1, Y(
-      d,
-      f,
-      a,
-      l,
-      s ?? o,
-      i
-    ));
-}
-function De(e, r) {
-  let t;
-  for (const n of e)
-    n.line <= r && (t = n);
-  return t ?? e[0];
-}
-function V() {
-  return process.env.PRETEXT_HTML_ASSETS ?? c.resolve(c.dirname(K(import.meta.url)), "..", "assets");
-}
-function pe() {
-  return c.join(V(), "xsl");
-}
-function he() {
-  return c.join(V(), "preview-html.xsl");
-}
-function me() {
-  return "Suspending" in WebAssembly;
-}
-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)."
-    );
-}
-function U(e) {
-  return e.includes("'") ? e.includes('"') ? `concat(${e.split("'").map((t) => `'${t}'`).join(`, "'", `)})` : `"${e}"` : `'${e}'`;
-}
-function ge(e) {
-  return e.replace(
-    /from '\.\/(https:\/\/[^']+)'/g,
-    (r, t) => `from '${t}'`
-  );
-}
-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 xe(e, r) {
-  const t = c.resolve(e);
-  let n;
-  try {
-    n = await m(t, "utf8");
-  } catch {
-    return;
-  }
-  return le(n, t, r);
-}
-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()}
-` : ""}<${o}>
-<title/>
-${n}
-</${o}>
-</pretext>
-`;
-}
-function C(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 P;
-async function Z() {
-  return P || (P = (async () => {
-    const [e, r] = await Promise.all([
-      import("@pretextbook/libxslt-wasm"),
-      import("@pretextbook/libxslt-wasm/exslt")
-    ]);
-    return r.registerAll(), e;
-  })()), P;
-}
-const k = /* @__PURE__ */ new Map();
-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 = 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 $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 = N(o);
-  try {
-    let f, a = `${s}/__pretext-preview-publication.xml`;
-    if (e.publicationPath) {
-      const p = c.resolve(e.publicationPath);
-      f = L(
-        await m(p, "utf8")
-      );
-      const b = c.relative(o, p);
-      b.startsWith("..") || (a = `${s}/${b.split(c.sep).join("/")}`);
-    } else
-      f = L();
-    oe(a, f);
-    let d, u;
-    if (e.sourceMap) {
-      const p = await J(
-        i,
-        n,
-        o
-      );
-      d = p.tree, u = p.content;
-    } else
-      u = await se(
-        i,
-        n,
-        o
-      );
-    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 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 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 }
-    }), j = {
-      publisher: U(a)
-    };
-    for (const [p, b] of Object.entries(e.stringParams ?? {}))
-      j[p] = U(b);
-    let E;
-    try {
-      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.",
-        { cause: p }
-      );
-    } finally {
-      D.delete();
-    }
-    try {
-      let p = ge(E.toHtmlString());
-      return e.theme && (p = Q(p, e.theme)), {
-        html: p,
-        ...I ? { sourceMap: I } : {}
-      };
-    } catch (p) {
-      throw C(p), p;
-    } finally {
-      E.delete();
-    }
-  } finally {
-    ne(s);
-  }
-}
-const O = `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)
-  --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 Ee(e) {
-  let r, t, n, o;
-  const i = {}, l = {};
-  for (let s = 0; s < e.length; s++) {
-    const f = e[s], a = () => {
-      if (s += 1, s >= e.length)
-        throw new Error(`Missing value for ${f}`);
-      return e[s];
-    };
-    switch (f) {
-      case "-h":
-      case "--help":
-        w.stdout.write(O), w.exit(0);
-        break;
-      case "-o":
-      case "--output":
-        t = a();
-        break;
-      case "--publication":
-        i.publicationPath = a();
-        break;
-      case "--project-dir":
-        i.projectDir = a();
-        break;
-      case "--xsl-dir":
-        i.xslDir = a();
-        break;
-      case "--fragment":
-        i.fragment = !0;
-        break;
-      case "--docinfo":
-        n = a();
-        break;
-      case "--docinfo-source":
-        i.docinfoSourcePath = a();
-        break;
-      case "--source-map":
-        o = a(), i.sourceMap = !0;
-        break;
-      case "--param": {
-        const d = a(), u = d.indexOf("=");
-        if (u === -1)
-          throw new Error(`--param expects name=value, got: ${d}`);
-        l[d.slice(0, u)] = d.slice(u + 1);
-        break;
-      }
-      default:
-        if (f.startsWith("-"))
-          throw new Error(`Unknown option: ${f}`);
-        if (r)
-          throw new Error(`Unexpected extra argument: ${f}`);
-        r = f;
-    }
-  }
-  if (!r)
-    throw new Error(`No source file given.
-
-` + O);
-  return Object.keys(l).length > 0 && (i.stringParams = l), {
-    options: { ...i, sourcePath: r },
-    output: t,
-    docinfoPath: n,
-    sourceMapPath: o
-  };
-}
-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 $e(r);
-  w.stderr.write(`pretext-html: rendered in ${Date.now() - i}ms
-`), 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,
-  pe as d,
-  De as f,
-  me as i,
-  je as m,
-  Ee as p,
-  $e as r,
-  U as x
-};