@pretextbook/pretext-html 0.2.0 → 0.4.0

package/dist/cli-B2LiKunq.js

@@ -1,588 +0,0 @@
-import { readFile as S, writeFile as L } from "node:fs/promises";
-import * as m from "node:process";
-import * as l from "node:path";
-import { fileURLToPath as re } from "node:url";
-import { fromXml as v } from "xast-util-from-xml";
-import { toXml as y } from "xast-util-to-xml";
-import { injectThemeBridge as ne } from "./theme.js";
-async function N(e, r) {
-  const t = l.resolve(e), n = l.resolve(t, `.${l.posix.normalize(r)}`);
-  if (n !== t && !n.startsWith(t + l.sep)) {
-    console.error(
-      `pretext-html: refusing to serve ${r} from outside ${t}`
-    );
-    return;
-  }
-  try {
-    return new Uint8Array(await S(n));
-  } catch {
-    return;
-  }
-}
-async function I(e) {
-  try {
-    return await S(e, "utf8");
-  } catch {
-    return;
-  }
-}
-let _;
-function Fe(e) {
-  _ = e;
-}
-function k() {
-  return _ ?? process.env.PRETEXT_HTML_ASSETS ?? l.resolve(l.dirname(re(import.meta.url)), "..", "assets");
-}
-function oe(e, r) {
-  return l.join(e, r);
-}
-const D = /* @__PURE__ */ new Map(), H = /* @__PURE__ */ new Map();
-let T, ie = 0, J = N;
-function Re(e) {
-  J = e;
-}
-function se(e, r) {
-  const t = typeof e == "string" ? e : e instanceof URL ? e.href : e.url, n = H.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 = D.get(o);
-  return i !== void 0 ? ce(i, t) : T(e, r);
-}
-const ae = '<?xml version="1.0"?><pretext-preview-missing-file/>';
-async function ce(e, r) {
-  const t = decodeURIComponent(new URL(r).pathname), n = await J(e, t);
-  if (n === void 0)
-    return new Response(ae, { status: 200 });
-  const o = typeof n == "string" ? n : new Uint8Array(n);
-  return new Response(o, { status: 200 });
-}
-function q() {
-  T || (T = globalThis.fetch, globalThis.fetch = se);
-}
-function z(e) {
-  q();
-  const r = `mnt${++ie}.ptx.invalid`;
-  return D.set(r, e), `http://${r}`;
-}
-function le(e) {
-  D.delete(new URL(e).host);
-}
-function ue(e, r) {
-  q(), H.set(e, r);
-}
-const fe = `<?xml version="1.0" encoding="UTF-8"?>
-<publication>
-  <source>
-    <directories external="../assets" generated="../generated-assets" />
-  </source>
-  <html>
-    <platform portable="yes"/>
-  </html>
-</publication>
-`;
-function G(e, r) {
-  for (const t of e.children)
-    if (t.type === "element" && t.name === r)
-      return t;
-}
-function F(e, r) {
-  let t = G(e, r);
-  return t || (t = { type: "element", name: r, attributes: {}, children: [] }, e.children.push(t)), t;
-}
-function R(e) {
-  if (!e)
-    return fe;
-  const r = v(e), t = G(r, "publication");
-  if (!t)
-    throw new Error(
-      "Invalid publication file: no root <publication> element found"
-    );
-  const n = F(t, "html"), o = F(n, "platform");
-  return o.attributes = { ...o.attributes, portable: "yes" }, y(r);
-}
-const Y = "http://www.w3.org/2001/XInclude", A = 64;
-async function de(e, r, t) {
-  return e.includes("include") ? (await V(e, r, t)).content : e;
-}
-async function V(e, r, t) {
-  const n = v(e), o = {
-    projectDir: l.resolve(t),
-    stack: [l.resolve(r)]
-  }, i = await g(
-    n,
-    l.dirname(l.resolve(r)),
-    { "": "" },
-    o
-  );
-  return { tree: n, content: i ? y(n) : e };
-}
-function he(e) {
-  return e.data?.ptxIncludedFile;
-}
-function pe(e, r) {
-  const t = e.data ?? (e.data = {});
-  t.ptxIncludedFile = r;
-}
-function x(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 Z(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] === Y;
-}
-async function g(e, r, t, n) {
-  let o = !1;
-  for (let i = 0; i < e.children.length; i++) {
-    const c = e.children[i];
-    if (c.type !== "element")
-      continue;
-    const s = x(t, c);
-    if (Z(c, s)) {
-      const u = await K(
-        c,
-        r,
-        s,
-        n
-      );
-      e.children.splice(i, 1, ...u), i += u.length - 1, o = !0;
-    } else await g(c, r, s, n) && (o = !0);
-  }
-  return o;
-}
-async function K(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 c = i;
-  try {
-    c = decodeURIComponent(i);
-  } catch {
-  }
-  const s = l.resolve(r, c);
-  if (s !== n.projectDir && !s.startsWith(n.projectDir + l.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 >= A)
-    throw new Error(`xi:include nesting exceeds ${A} levels`);
-  const u = await I(s);
-  if (u === void 0) {
-    const f = we(e, t);
-    if (f)
-      return await g(f, r, t, n), f.children;
-    throw new Error(`xi:include target not found: ${i} (in ${o})`);
-  }
-  if (e.attributes.parse === "text")
-    return [{ type: "text", value: u }];
-  let a;
-  try {
-    a = v(u);
-  } catch (f) {
-    throw new Error(
-      `Could not parse xi:include target ${s} as XML: ${f instanceof Error ? f.message : f}. (Included files must be well-formed, with a single root element.)`
-    );
-  }
-  n.stack.push(s);
-  try {
-    await g(a, l.dirname(s), { "": "" }, n);
-  } finally {
-    n.stack.pop();
-  }
-  const d = a.children.filter(
-    (f) => f.type === "element"
-  );
-  for (const f of d)
-    pe(f, s);
-  return d;
-}
-function U(e) {
-  return e.name === "docinfo";
-}
-async function me(e, r, t) {
-  try {
-    const o = v(e).children.find(
-      (a) => a.type === "element"
-    );
-    if (!o)
-      return;
-    const i = l.resolve(r), c = l.dirname(i), s = {
-      projectDir: l.resolve(t),
-      stack: [i]
-    }, u = x({ "": "" }, o);
-    for (const a of o.children) {
-      if (a.type !== "element")
-        continue;
-      const d = x(u, a);
-      if (U(a))
-        return await g(a, c, d, s), y(a);
-      if (Z(a, d)) {
-        const p = (await K(
-          a,
-          c,
-          d,
-          s
-        )).find(
-          (w) => w.type === "element" && U(w)
-        );
-        if (p)
-          return y(p);
-        continue;
-      }
-      break;
-    }
-    return;
-  } catch {
-    return;
-  }
-}
-function we(e, r) {
-  for (const t of e.children) {
-    if (t.type !== "element")
-      continue;
-    const n = x(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] === Y)
-      return t;
-  }
-}
-function Q(e) {
-  return typeof e == "object" && e !== null && e.type === "element";
-}
-function be(e) {
-  return /^(pf|xhtml):/.test(e.name);
-}
-function ge(e, r, t) {
-  const n = [], o = e.children.find(Q);
-  if (o) {
-    const i = t?.parentId ?? "root";
-    ee(o, i, t?.position ?? 1, r, i, n);
-  }
-  return n;
-}
-function ee(e, r, t, n, o, i) {
-  const c = he(e) ?? n;
-  let s, u;
-  if (be(e))
-    u = "root";
-  else {
-    const d = e.attributes.label ?? e.attributes["xml:id"];
-    s = d ?? `${r}-${t}`, i.push({
-      id: s,
-      file: c,
-      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 a = 0;
-  for (const d of e.children)
-    Q(d) && (a += 1, ee(
-      d,
-      u,
-      a,
-      c,
-      s ?? o,
-      i
-    ));
-}
-function Ae(e, r) {
-  let t;
-  for (const n of e)
-    n.line <= r && (t = n);
-  return t ?? e[0];
-}
-function ye() {
-  return oe(k(), "xsl");
-}
-function xe() {
-  return "Suspending" in WebAssembly;
-}
-function ve() {
-  if (!xe())
-    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((t) => `'${t}'`).join(`, "'", `)})` : `"${e}"` : `'${e}'`;
-}
-function Ee(e) {
-  return e.replace(
-    /from '\.\/(https:\/\/[^']+)'/g,
-    (r, t) => `from '${t}'`
-  );
-}
-function $e(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 O(e) {
-  const r = await I(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 Pe(e, r) {
-  const t = l.resolve(e), n = await I(t);
-  if (n !== void 0)
-    return me(n, t, r);
-}
-function ke(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 B(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 $;
-async function te() {
-  return $ || ($ = (async () => {
-    const [e, r] = await Promise.all([
-      import("@pretextbook/libxslt-wasm"),
-      import("@pretextbook/libxslt-wasm/exslt")
-    ]);
-    return r.registerAll(), e;
-  })()), $;
-}
-const P = /* @__PURE__ */ new Map();
-async function Te(e) {
-  const r = e;
-  let t = P.get(r);
-  return t || (t = (async () => {
-    const { XmlDocument: n, XsltStylesheet: o } = await te(), i = z(r), c = await N(
-      k(),
-      "/preview-html.xsl"
-    );
-    if (c === void 0)
-      throw new Error(
-        `Could not read preview-html.xsl from ${k()}. Check the assets location (PRETEXT_HTML_ASSETS under Node, setAssetsBase() in the browser).`
-      );
-    const s = new TextDecoder().decode(c), u = await n.fromString(s, {
-      url: `${i}/preview-html.xsl`,
-      options: { noEnt: !0, dtdLoad: !0, huge: !0 }
-    });
-    return o.fromXmlDocument(u);
-  })(), P.set(r, t), t.catch(() => P.delete(r))), t;
-}
-async function Se(e) {
-  ve();
-  const { XmlDocument: r } = await te(), t = await Te(e.xslDir ?? ye()), n = l.resolve(e.sourcePath), o = l.resolve(
-    e.projectDir ?? l.dirname(n)
-  ), i = e.sourceContent ?? await O(n), c = l.relative(o, n);
-  if (c.startsWith(".."))
-    throw new Error(
-      `sourcePath (${n}) must live inside projectDir (${o})`
-    );
-  const s = z(o);
-  try {
-    let u, a = `${s}/__pretext-preview-publication.xml`;
-    if (e.publicationPath) {
-      const h = l.resolve(e.publicationPath);
-      u = R(
-        await O(h)
-      );
-      const b = l.relative(o, h);
-      b.startsWith("..") || (a = `${s}/${b.split(l.sep).join("/")}`);
-    } else
-      u = R();
-    ue(a, u);
-    let d, f;
-    if (e.sourceMap) {
-      const h = await V(
-        i,
-        n,
-        o
-      );
-      d = h.tree, f = h.content;
-    } else
-      f = await de(
-        i,
-        n,
-        o
-      );
-    const p = $e(f);
-    let w = { parentId: "root", position: 1 };
-    if (p !== "pretext" && p !== "mathbook")
-      if (e.fragment) {
-        const h = e.docinfo ?? (e.docinfoSourcePath ? await Pe(e.docinfoSourcePath, o) : void 0);
-        f = ke(f, p, h), w = { parentId: h?.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 M = d ? ge(d, n, w) : void 0, X = await r.fromString(f, {
-      url: `${s}/${c.split(l.sep).join("/")}`,
-      options: { noEnt: !0, dtdLoad: !0, huge: !0 }
-    }), j = {
-      publisher: C(a)
-    };
-    for (const [h, b] of Object.entries(e.stringParams ?? {}))
-      j[h] = C(b);
-    let E;
-    try {
-      E = await t.apply(X, j);
-    } catch (h) {
-      throw B(h), new Error(
-        "PreTeXt XSLT transform failed; see the PTX:ERROR/PTX:FATAL messages on stderr for details.",
-        { cause: h }
-      );
-    } finally {
-      X.delete();
-    }
-    try {
-      let h = Ee(E.toHtmlString());
-      return e.theme && (h = ne(h, e.theme)), {
-        html: h,
-        ...M ? { sourceMap: M } : {}
-      };
-    } catch (h) {
-      throw B(h), h;
-    } finally {
-      E.delete();
-    }
-  } finally {
-    le(s);
-  }
-}
-const W = `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 Ie(e) {
-  let r, t, n, o;
-  const i = {}, c = {};
-  for (let s = 0; s < e.length; s++) {
-    const u = e[s], a = () => {
-      if (s += 1, s >= e.length)
-        throw new Error(`Missing value for ${u}`);
-      return e[s];
-    };
-    switch (u) {
-      case "-h":
-      case "--help":
-        m.stdout.write(W), m.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(), f = d.indexOf("=");
-        if (f === -1)
-          throw new Error(`--param expects name=value, got: ${d}`);
-        c[d.slice(0, f)] = d.slice(f + 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.
-
-` + W);
-  return Object.keys(c).length > 0 && (i.stringParams = c), {
-    options: { ...i, sourcePath: r },
-    output: t,
-    docinfoPath: n,
-    sourceMapPath: o
-  };
-}
-async function Ue(e) {
-  const { options: r, output: t, docinfoPath: n, sourceMapPath: o } = Ie(e);
-  n && (r.docinfo = await S(n, "utf8"));
-  const i = Date.now(), { html: c, sourceMap: s } = await Se(r);
-  m.stderr.write(`pretext-html: rendered in ${Date.now() - i}ms
-`), o && s && (await L(o, JSON.stringify(s, null, 2)), m.stderr.write(`pretext-html: wrote ${o}
-`)), t ? (await L(t, c), m.stderr.write(`pretext-html: wrote ${t}
-`)) : m.stdout.write(c);
-}
-export {
-  R as a,
-  Re as b,
-  ye as d,
-  Ae as f,
-  xe as i,
-  Ue as m,
-  Ie as p,
-  Se as r,
-  Fe as s,
-  C as x
-};