@pretextbook/import 0.11.0 → 0.12.0

package/dist/index.js

@@ -1,6 +1,6 @@
-import { i as W, P as H, d as U, r as G, a as V, f as C, b as R, w as v, s as k, e as q, c as Z, p as Y, g as $, h as J, j as Q } from "./upload-H_OCZBBn.js";
-import { C as Xe, D as ze, L as Be, k as Ke, l as We, M as He, m as Ue, n as Ge, o as Ve, q as qe, t as Ze, u as Ye, v as Je, x as Qe, y as et, z as tt, A as nt, B as rt, E as ot, F as st, G as at, H as it, I as ct, J as lt, K as ut, N as pt, O as dt, Q as mt, R as ft, S as ht, T as gt, U as wt, V as Tt, W as xt, X as Pt, Y as Et, Z as vt, _ as St, $ as bt, a0 as It, a1 as _t, a2 as $t, a3 as At, a4 as Ft, a5 as Lt, a6 as yt, a7 as Ct, a8 as Rt, a9 as kt, aa as Dt, ab as Mt, ac as Ot, ad as Nt, ae as jt, af as Xt, ag as zt, ah as Bt, ai as Kt, aj as Wt, ak as Ht, al as Ut, am as Gt } from "./upload-H_OCZBBn.js";
-import { D as qt, a as Zt, d as Yt, b as Jt, c as Qt, f as en, e as tn, g as nn, h as rn, p as on, r as sn } from "./import-mode-DQ8g5P8P.js";
+import { i as W, P as U, d as H, r as G, a as q, f as C, b as k, w as S, s as R, e as V, c as Z, p as Y, g as A, h as J, j as Q } from "./upload-H_OCZBBn.js";
+import { C as Xe, D as ze, L as Be, k as Ke, l as We, M as Ue, m as He, n as Ge, o as qe, q as Ve, t as Ze, u as Ye, v as Je, x as Qe, y as et, z as tt, A as nt, B as rt, E as st, F as ot, G as at, H as it, I as ct, J as lt, K as ut, N as pt, O as dt, Q as mt, R as ft, S as ht, T as gt, U as wt, V as Tt, W as xt, X as Pt, Y as Et, Z as St, _ as vt, $ as bt, a0 as It, a1 as _t, a2 as At, a3 as $t, a4 as Ft, a5 as Lt, a6 as yt, a7 as Ct, a8 as kt, a9 as Rt, aa as Dt, ab as Mt, ac as Ot, ad as Nt, ae as jt, af as Xt, ag as zt, ah as Bt, ai as Kt, aj as Wt, ak as Ut, al as Ht, am as Gt } from "./upload-H_OCZBBn.js";
+import { D as Vt, a as Zt, b as Yt, c as Jt, d as Qt, e as en, f as tn, g as nn, h as rn, i as sn, j as on, k as an, l as cn, m as ln, n as un, o as pn, p as dn, r as mn, q as fn, u as hn } from "./engine-routing-Bu0zM4aw.js";
 const ee = /\$(?![\s$])([^$\n]{1,200})\$/;
 function te(e) {
   const t = ee.exec(e);
@@ -41,22 +41,22 @@ const ne = [
   { pattern: /(?:^|\s)_[^_\s][^_\n]*_(?:\s|[.,;:!?]|$)/, weight: 1 },
   // Inline code span.
   { pattern: /`[^`\n]+`/, weight: 1 }
-], oe = 2;
-function A(e, t) {
+], se = 2;
+function $(e, t) {
   return t.reduce(
-    (n, { pattern: r, weight: o }) => n + (r.test(e) ? o : 0),
+    (n, { pattern: r, weight: s }) => n + (r.test(e) ? s : 0),
     0
   );
 }
-function se(e) {
-  return { latex: A(e, ne) + (te(e) ? 2 : 0), markdown: A(e, re) };
+function oe(e) {
+  return { latex: $(e, ne) + (te(e) ? 2 : 0), markdown: $(e, re) };
 }
 function Fe(e) {
   const t = e.trim();
   if (!t || t.startsWith("<"))
     return;
-  const { latex: n, markdown: r } = se(t);
-  if (!(Math.max(n, r) < oe))
+  const { latex: n, markdown: r } = oe(t);
+  if (!(Math.max(n, r) < se))
     return n >= r ? "latex" : "markdown";
 }
 const ae = {
@@ -81,8 +81,8 @@ const P = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
 function ce(e) {
   const t = e.length, n = [];
   for (let r = 0; r < t; r += 3) {
-    const o = e[r], a = r + 1 < t, s = r + 2 < t, i = a ? e[r + 1] : 0, c = s ? e[r + 2] : 0;
-    n.push(P[o >> 2]), n.push(P[(o & 3) << 4 | i >> 4]), n.push(a ? P[(i & 15) << 2 | c >> 6] : "="), n.push(s ? P[c & 63] : "=");
+    const s = e[r], a = r + 1 < t, o = r + 2 < t, i = a ? e[r + 1] : 0, c = o ? e[r + 2] : 0;
+    n.push(P[s >> 2]), n.push(P[(s & 3) << 4 | i >> 4]), n.push(a ? P[(i & 15) << 2 | c >> 6] : "="), n.push(o ? P[c & 63] : "=");
   }
   return n.join("");
 }
@@ -142,14 +142,14 @@ function Le(e) {
   return pe(le(e));
 }
 function ye(e, t) {
-  const { root: n, entries: r } = W(e, t), o = new Set(r.map((s) => s.xmlId)), a = e.divisions.filter(
-    (s) => !o.has(s.xmlId) && !(t.unwrapRoot && s.xmlId === n.xmlId)
+  const { root: n, entries: r } = W(e, t), s = new Set(r.map((o) => o.xmlId)), a = e.divisions.filter(
+    (o) => !s.has(o.xmlId) && !(t.unwrapRoot && o.xmlId === n.xmlId)
   );
   return {
     divisions: [...r, ...a].map(M),
     assets: e.assets.map(D),
     placeholders: r.map(
-      (s) => `<plus:${s.type} ref="${s.xmlId}"/>`
+      (o) => `<plus:${o.type} ref="${o.xmlId}"/>`
     )
   };
 }
@@ -163,7 +163,7 @@ function Ce(e) {
   return t > 0;
 }
 const de = new RegExp(
-  `<(${H.join("|")})(?=[\\s>/])`
+  `<(${U.join("|")})(?=[\\s>/])`
 );
 function me(e) {
   return de.exec(e)?.[1];
@@ -171,15 +171,15 @@ function me(e) {
 function fe(e, t, n) {
   return e.split(`
 `).map(
-    (r, o) => o === 0 && n ? r : r && t + r
+    (r, s) => s === 0 && n ? r : r && t + r
   ).join(`
 `);
 }
-function Re(e, t) {
+function ke(e, t) {
   let n = e.trim(), r;
   if (t.inline) {
-    const o = n.replace(/^<p>\s*([\s\S]*?)\s*<\/p>$/, "$1");
-    n = o !== n ? o : n.replace(/^<p>/, "");
+    const s = n.replace(/^<p>\s*([\s\S]*?)\s*<\/p>$/, "$1");
+    n = s !== n ? s : n.replace(/^<p>/, "");
     const a = me(n);
     a && (r = `Pasted content produced a <${a}>, which cannot sit inside a <p>. It was inserted as-is — move it out of the paragraph to make the document valid.`);
   }
@@ -197,9 +197,9 @@ ${e}
 </pretext>`;
 }
 function N(e, t, n) {
-  const r = /* @__PURE__ */ new Map(), o = [], a = `${t}-`;
-  return e.forEach((s, i) => {
-    const c = s.attributes["xml:id"];
+  const r = /* @__PURE__ */ new Map(), s = [], a = `${t}-`;
+  return e.forEach((o, i) => {
+    const c = o.attributes["xml:id"];
     let l;
     if (c) {
       const m = Z(c);
@@ -210,33 +210,33 @@ function N(e, t, n) {
         severity: "info",
         kind: "structure",
         category: "missing_xml_id",
-        macro: s.name,
+        macro: o.name,
         occurrences: 1,
-        message: `<${s.name}> at position ${i + 1} has no xml:id; using \`${l}\` as filename.`
+        message: `<${o.name}> at position ${i + 1} has no xml:id; using \`${l}\` as filename.`
       });
     const p = r.get(l) ?? 0;
     r.set(l, p + 1);
     const u = p === 0 ? l : `${l}-${p + 1}`;
-    o.push({
-      span: s,
+    s.push({
+      span: o,
       slug: u,
       filename: `${u}.ptx`
     });
-  }), o;
+  }), s;
 }
 function he(e, t, n, r) {
-  const o = R(e, "section");
-  if (o.length === 0)
+  const s = k(e, "section");
+  if (s.length === 0)
     return e;
-  const s = N(o, "sec", r).map((i) => {
+  const o = N(s, "sec", r).map((i) => {
     const c = `source/${t}/${i.filename}`;
-    return n[c] = v(i.span.outer), {
+    return n[c] = S(i.span.outer), {
       start: i.span.start,
       end: i.span.end,
       replacement: `<xi:include href="${t}/${i.filename}"/>`
     };
   });
-  return k(e, s);
+  return R(e, o);
 }
 function ge(e, t, n) {
   const r = C(e, "book");
@@ -250,8 +250,8 @@ function ge(e, t, n) {
       occurrences: 1,
       message: "Document was treated as a book but no <book> element found; emitting as a single file."
     }), j(e, t);
-  const o = {}, a = R(r.inner, "chapter");
-  let s = r.inner;
+  const s = {}, a = k(r.inner, "chapter");
+  let o = r.inner;
   if (t.splitChapters && a.length > 0) {
     const p = N(a, "ch", n).map((u) => {
       let m = u.span.outer;
@@ -259,44 +259,44 @@ function ge(e, t, n) {
         const d = u.span.inner, f = he(
           d,
           u.slug,
-          o,
+          s,
           n
         );
         m = u.span.outer.slice(0, u.span.startTagEnd - u.span.start) + f + u.span.outer.slice(u.span.contentEnd - u.span.start);
       }
       const h = `source/${u.filename}`;
-      return o[h] = v(m), {
+      return s[h] = S(m), {
         start: u.span.start,
         end: u.span.end,
         replacement: `<xi:include href="${u.filename}"/>`
       };
     });
-    s = k(r.inner, p);
+    o = R(r.inner, p);
   }
-  const i = e.slice(r.start, r.startTagEnd) + s + e.slice(r.contentEnd, r.end), c = e.slice(0, r.start) + i + e.slice(r.end);
-  return o[t.mainSourcePath] = v(
-    q(O(c.trim()))
-  ), o;
+  const i = e.slice(r.start, r.startTagEnd) + o + e.slice(r.contentEnd, r.end), c = e.slice(0, r.start) + i + e.slice(r.end);
+  return s[t.mainSourcePath] = S(
+    V(O(c.trim()))
+  ), s;
 }
 function j(e, t, n) {
   const r = {};
-  return r[t.mainSourcePath] = v(
+  return r[t.mainSourcePath] = S(
     O(e.trim())
   ), r;
 }
-function ke(e, t = {}) {
-  const n = [], r = t.documentKind ?? U(e), o = {
+function Re(e, t = {}) {
+  const n = [], r = t.documentKind ?? H(e), s = {
     splitChapters: t.splitChapters ?? r === "book",
     splitSections: t.splitSections ?? !1,
     mainSourcePath: t.mainSourcePath ?? E.mainSourcePath,
     publicationPath: t.publicationPath ?? E.publicationPath,
     projectFilePath: t.projectFilePath ?? E.projectFilePath,
     docinfoPath: t.docinfoPath ?? E.docinfoPath
-  }, a = r === "book" ? ge(e, o, n) : j(e, o);
-  return a[o.projectFilePath] = G({
-    mainSource: o.mainSourcePath,
-    publication: o.publicationPath
-  }), a[o.publicationPath] = V(), { files: a, documentKind: r, warnings: n };
+  }, a = r === "book" ? ge(e, s, n) : j(e, s);
+  return a[s.projectFilePath] = G({
+    mainSource: s.mainSourcePath,
+    publication: s.publicationPath
+  }), a[s.publicationPath] = q(), { files: a, documentKind: r, warnings: n };
 }
 class we extends Error {
   constructor() {
@@ -305,14 +305,14 @@ class we extends Error {
 }
 let Te = 0;
 function xe(e, t, n = {}) {
-  const r = `convert-${Te++}`, o = e(), { assets: a = {}, ...s } = n;
+  const r = `convert-${Te++}`, s = e(), { assets: a = {}, ...o } = n;
   let i;
   const c = new Promise((p, u) => {
     let m = !1;
     const h = (d) => {
-      m || (m = !0, o.terminate(), d());
+      m || (m = !0, s.terminate(), d());
     };
-    i = () => h(() => u(new we())), o.addEventListener("message", (d) => {
+    i = () => h(() => u(new we())), s.addEventListener("message", (d) => {
       const f = d.data;
       if (!(!f || f.requestId !== r)) {
         if (f.type === "result") {
@@ -321,7 +321,7 @@ function xe(e, t, n = {}) {
         }
         h(() => u(new Error(f.message)));
       }
-    }), o.addEventListener("error", (d) => {
+    }), s.addEventListener("error", (d) => {
       const f = typeof d == "object" && d && "message" in d ? String(d.message) : "The import worker failed to start.";
       h(() => u(new Error(f)));
     });
@@ -332,8 +332,8 @@ function xe(e, t, n = {}) {
       )
     )
   ];
-  return o.postMessage(
-    { type: "convert", requestId: r, files: t, assets: a, options: s },
+  return s.postMessage(
+    { type: "convert", requestId: r, files: t, assets: a, options: o },
     l
   ), { result: c, cancel: () => i?.() };
 }
@@ -342,25 +342,25 @@ function De(e) {
     createWorker: t,
     id: n = "worker",
     label: r = "Built-in converter",
-    description: o = "Create a new project starting with LaTeX, Markdown, or PreTeXt files.",
+    description: s = "Create a new project starting with LaTeX, Markdown, or PreTeXt files.",
     acceptExtensions: a
   } = e;
-  let s = null;
+  let o = null;
   const i = async (c, l) => {
-    s?.cancel(), s = xe(t, c, l);
+    o?.cancel(), o = xe(t, c, l);
     try {
-      return await s.result;
+      return await o.result;
     } finally {
-      s = null;
+      o = null;
     }
   };
   return {
     id: n,
     label: r,
-    description: o,
+    description: s,
     acceptExtensions: a,
     prepare: async (c) => {
-      const { files: l, assets: p } = await $(c);
+      const { files: l, assets: p } = await A(c);
       return {
         fileName: c.name,
         files: l,
@@ -370,11 +370,11 @@ function De(e) {
     },
     convertPrepared: (c, l) => i(c.files, { ...l, assets: c.assets }),
     convertFile: async (c, l) => {
-      const { files: p, assets: u } = await $(c);
+      const { files: p, assets: u } = await A(c);
       return i(p, { ...l, assets: u });
     },
     cancel: () => {
-      s?.cancel(), s = null;
+      o?.cancel(), o = null;
     }
   };
 }
@@ -417,24 +417,24 @@ function z(e) {
 function Ee(e) {
   return Pe[z(e)];
 }
-function ve(e) {
+function Se(e) {
   const {
     convertToPretext: t,
     id: n = "pandoc",
     label: r = "Pandoc",
-    description: o = "Convert Word, OpenOffice, EPUB, HTML, reStructuredText, and more.",
+    description: s = "Convert Word, OpenOffice, EPUB, HTML, reStructuredText, and more.",
     acceptExtensions: a = X
   } = e;
   return {
     id: n,
     label: r,
-    description: o,
+    description: s,
     acceptExtensions: a,
-    convertFile: async (s, i) => {
-      const c = await t(s, i);
+    convertFile: async (o, i) => {
+      const c = await t(o, i);
       if (!c.trim())
         throw new Error(
-          `Pandoc produced no output for ${s.name}. The file may be empty or in an unexpected format.`
+          `Pandoc produced no output for ${o.name}. The file may be empty or in an unexpected format.`
         );
       const l = Q(
         { "source.ptx": c },
@@ -445,20 +445,20 @@ function ve(e) {
           splitLevel: i.splitLevel
         }
       );
-      return "pretextError" in l || (l.sourceName = s.name, l.sourcePath = s.name), l;
+      return "pretextError" in l || (l.sourceName = o.name, l.sourcePath = o.name), l;
     }
   };
 }
-const Se = 3e4;
+const ve = 3e4;
 function be(e) {
   const t = /<pre>([\s\S]*?)<\/pre>/i.exec(e);
   return (t ? t[1] : e).replace(/<[^>]+>/g, "").replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&quot;/g, '"').replace(/&#39;/g, "'").replace(/&amp;/g, "&").trim();
 }
 function Ie(e, t, n) {
-  const r = _e(be(t)), o = r ? ` (${y(r)})` : "";
+  const r = _e(be(t)), s = r ? ` (${y(r)})` : "";
   switch (e) {
     case 400:
-      return `The pandoc server will not convert ${n}${o}.${T(n)}`;
+      return `The pandoc server will not convert ${n}${s}.${T(n)}`;
     case 401:
     case 403:
       return `The pandoc server rejected this site's credentials, so ${n} was never converted. Nothing is wrong with your file — this is a configuration problem with the service, and worth reporting.${T(n)}`;
@@ -467,7 +467,7 @@ function Ie(e, t, n) {
     case 413:
       return `${n} is too large for the pandoc server to accept. Splitting it into chapters and importing them one at a time should get through.`;
     case 422:
-      return `Pandoc could not read ${n}${o}. The file may be damaged, or may use features pandoc does not support.`;
+      return `Pandoc could not read ${n}${s}. The file may be damaged, or may use features pandoc does not support.`;
     case 503:
       return `The pandoc server is running without its PreTeXt writer, so it cannot convert anything right now. Nothing is wrong with your file — this is a problem with the service, and worth reporting.${T(n)}`;
     case 504:
@@ -485,38 +485,38 @@ function _e(e) {
 function y(e) {
   return e.length <= L ? e : `${e.slice(0, L).trimEnd()}…`;
 }
-const $e = /* @__PURE__ */ new Set([
+const Ae = /* @__PURE__ */ new Set([
   ".tex",
   ".ltx",
   ".md",
   ".markdown"
 ]);
 function T(e) {
-  return $e.has(z(e)) ? " You can import this file with the built-in converter instead." : "";
+  return Ae.has(z(e)) ? " You can import this file with the built-in converter instead." : "";
 }
 function Oe(e) {
   const {
     url: t,
     token: n,
     headers: r,
-    credentials: o,
+    credentials: s,
     standalone: a = !0,
-    from: s,
-    timeoutMs: i = Se,
+    from: o,
+    timeoutMs: i = ve,
     fetchImpl: c,
     id: l = "pandoc-remote",
     label: p = "Pandoc (server)",
     description: u = "Convert Word, OpenOffice, EPUB, HTML, reStructuredText, and more — no local install needed.",
     acceptExtensions: m = X
   } = e;
-  return ve({
+  return Se({
     convertToPretext: async (d, f) => {
-      const S = c ?? globalThis.fetch;
-      if (typeof S != "function")
+      const v = c ?? globalThis.fetch;
+      if (typeof v != "function")
         throw new Error(
           "This environment has no fetch; pass fetchImpl to createRemotePandocEngine."
         );
-      const b = s ?? Ee(d.name);
+      const b = o ?? Ee(d.name);
       if (!b)
         throw new Error(
           `Pandoc cannot determine a format for ${d.name}. Supported extensions: ${m.join(", ")}.`
@@ -526,11 +526,11 @@ function Oe(e) {
       const I = new AbortController(), B = setTimeout(() => I.abort(), i);
       let x;
       try {
-        x = await S(t, {
+        x = await v(t, {
           method: "POST",
           body: g,
           headers: r,
-          credentials: o,
+          credentials: s,
           signal: I.signal
         });
       } catch (w) {
@@ -559,106 +559,115 @@ function Oe(e) {
 export {
   Xe as CLEAN_RULES,
   we as ConversionCancelledError,
-  qt as DEFAULT_IMPORT_MODE,
-  Se as DEFAULT_REMOTE_PANDOC_TIMEOUT_MS,
+  Vt as DEFAULT_ACCEPT_EXTENSIONS,
+  Zt as DEFAULT_IMPORT_MODE,
+  ve as DEFAULT_REMOTE_PANDOC_TIMEOUT_MS,
   ze as DIVISION_LADDER,
   Be as LADDER_OVERFLOW_TAG,
   Ke as LATEX_DIVISION_COMMANDS,
   We as LATEX_FORMAT_MARKERS,
-  He as MARKDOWN_FORMAT_MARKERS,
-  Ue as MAX_SUGGESTED_SPLIT_LEVEL,
+  Ue as MARKDOWN_FORMAT_MARKERS,
+  He as MAX_SUGGESTED_SPLIT_LEVEL,
   X as PANDOC_ACCEPT_EXTENSIONS,
   Me as PANDOC_BINARY_FORMATS,
   Pe as PANDOC_EXTENSION_FORMATS,
-  H as PRETEXT_DIVISION_TAGS,
+  U as PRETEXT_DIVISION_TAGS,
   Ge as PRETEXT_ROOT_TAGS,
-  Ve as PROJECT_DESTINATION,
+  qe as PROJECT_DESTINATION,
+  Yt as allAcceptExtensions,
+  Jt as alternateEngine,
+  Qt as alternateFor,
   J as analyzeImportSources,
-  qe as applyLatexFixes,
-  Zt as assetsForImportMode,
+  Ve as applyLatexFixes,
+  en as assetsForImportMode,
   Ze as attachLatexRoots,
   Ye as attachMarkdownRoots,
   Je as buildDivisionPool,
   Qe as buildNativeDivisionPool,
-  ke as buildPretextProjectFiles,
+  Re as buildPretextProjectFiles,
   et as carryOverProjectFiles,
   tt as cleanLatex,
   nt as cleanLatexInChunks,
   rt as cleanLatexText,
-  ot as convertLatexToPretext,
-  st as convertMarkdownToPretext,
+  st as convertLatexToPretext,
+  ot as convertMarkdownToPretext,
   at as convertSourceToPretext,
-  ve as createPandocEngine,
+  Se as createPandocEngine,
   Oe as createRemotePandocEngine,
   De as createWorkerEngine,
   it as dedupeXmlIds,
   ct as defaultAttachLevel,
   lt as defaultManifestTarget,
   Ie as describeRemotePandocFailure,
-  U as detectDocumentKind,
+  H as detectDocumentKind,
   Fe as detectSnippetFormat,
   ut as detectSourceFormat,
-  Yt as diffHunks,
-  Jt as diffLines,
-  Qt as diffStats,
+  tn as diffHunks,
+  nn as diffLines,
+  rn as diffStats,
   pt as divisionChildRefs,
   dt as divisionsAtLevel,
+  sn as engineAccepts,
+  on as engineExtensions,
   mt as expandPretextIncludes,
   be as extractPandocErrorDetail,
-  $ as extractUpload,
-  en as fileChangesForImport,
+  A as extractUpload,
+  an as fileChangesForImport,
   z as fileExtension,
   ft as filePrefixForDivision,
-  tn as filesForImportMode,
+  cn as filesForImportMode,
   ht as findLatexFixes,
   gt as findLatexHeaders,
   wt as findProjectManifest,
   me as firstDivisionTag,
   Tt as fixesToWarnings,
-  nn as formatWarningLine,
+  ln as formatWarningLine,
   xt as getConversionErrorMessage,
   Pt as getLatexCleanDiagnostics,
   Et as handleImportUploadFile,
-  rn as hasNativeImportMode,
+  un as hasNativeImportMode,
   Q as importProjectFromFiles,
-  vt as isDivisionTag,
+  St as isDivisionTag,
   Ce as isInlineContext,
-  St as ladderDepth,
+  vt as ladderDepth,
   bt as latexDivisionHierarchy,
   It as latexFixesToCodeActions,
+  pn as matchesExtension,
   _t as mergeChunksAtLevel,
-  $t as normalizePretextSource,
-  At as outlineDivisions,
+  At as normalizePretextSource,
+  $t as outlineDivisions,
   Ee as pandocFormatForFileName,
   Ft as parseLatexDivisions,
   Lt as parseProjectManifest,
-  Re as placeConvertedMarkup,
+  ke as placeConvertedMarkup,
   yt as prepareInsertSource,
-  on as projectForImportMode,
+  dn as projectForImportMode,
   Ct as pruneDivisions,
-  Rt as rebuildImport,
+  kt as rebuildImport,
   pe as recordsToPlusPayload,
   fe as reindentForContext,
-  kt as relayoutImport,
+  Rt as relayoutImport,
   G as renderProjectPtx,
   Dt as renderProjectPtxFromManifest,
-  V as renderPublicationPtx,
+  q as renderPublicationPtx,
   Mt as reselectImport,
-  sn as resolveImportMode,
+  mn as resolveImportMode,
   Ot as resolveImportSplitLevel,
   Nt as resolveSplitLevel,
   jt as retargetFragment,
   Xt as retargetFragmentToDepth,
   zt as retargetImport,
+  fn as routeEngine,
   xe as runConversionInWorker,
   Bt as sanitizeRef,
-  se as scoreSnippetFormats,
+  oe as scoreSnippetFormats,
   Kt as serializeForDestination,
   Wt as serializeInsertFiles,
   ye as serializeInsertToRecords,
-  Ht as serializeProjectToFiles,
+  Ut as serializeProjectToFiles,
   Le as serializeProjectToPlusPayload,
   le as serializeProjectToRecords,
-  Ut as shiftLadderTag,
-  Gt as suggestSplitLevel
+  Ht as shiftLadderTag,
+  Gt as suggestSplitLevel,
+  hn as unsupportedFileMessage
 };

package/dist/lib/engine-routing.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Which converter handles which upload.
+ *
+ * The wizard used to ask the author to pick a converter before picking a file,
+ * which made them learn something they have no way of knowing: that Word and
+ * EPUB need pandoc while LaTeX and Markdown do not. The file itself already
+ * says which converter can read it, so the routing is derived from its
+ * extension instead, and nothing is asked up front.
+ *
+ * Precedence is the order the host lists its engines in: the first engine that
+ * accepts an extension owns it. For a format two engines both read, the second
+ * one is available as an `alternateFor` that upload — offered only once the
+ * file is in hand and there is a converted result to judge it against, since
+ * "would the other converter do better?" is not a question anyone can answer
+ * before seeing the first one's output.
+ */
+/** The part of `ImportEngine` routing cares about. */
+export interface RoutableEngine {
+    id: string;
+    label: string;
+    description?: string;
+    /** Extensions this engine accepts, with leading dots. */
+    acceptExtensions?: string[];
+}
+/** File extensions accepted by the built-in converter. */
+export declare const DEFAULT_ACCEPT_EXTENSIONS: string[];
+/** What `engine` reads, falling back to the built-in set. */
+export declare function engineExtensions(engine: RoutableEngine): string[];
+/**
+ * Does `fileName` end in one of `extensions`?
+ *
+ * Suffix matching rather than "the text after the last dot", because
+ * `.tar.gz` is in the accept list and is not one dot's worth of extension.
+ */
+export declare function matchesExtension(fileName: string, extensions: string[]): boolean;
+/** Can `engine` read a file named `fileName`? */
+export declare function engineAccepts(engine: RoutableEngine, fileName: string): boolean;
+/**
+ * Every extension any engine reads, in engine order, deduplicated.
+ *
+ * This is the file picker's whole `accept` list: one picker, every format the
+ * host can import, no converter chosen up front.
+ */
+export declare function allAcceptExtensions(engines: RoutableEngine[]): string[];
+/**
+ * The engine an author may opt into: the first one that duplicates coverage an
+ * earlier engine already has. `undefined` when no two engines overlap, in
+ * which case routing is fully determined by the file and there is nothing to
+ * ask about.
+ */
+export declare function alternateEngine(engines: RoutableEngine[]): RoutableEngine | undefined;
+/** Pick the engine for an upload, or `undefined` when nothing reads it. */
+export declare function routeEngine<T extends RoutableEngine>(engines: T[], fileName: string): T | undefined;
+/**
+ * The second converter this particular upload could go through, or
+ * `undefined` when it has only one.
+ *
+ * This is what makes the override self-explanatory: it exists for a `.tex`,
+ * where both converters have an opinion, and simply is not there for a `.docx`
+ * or a `.zip`, where only one converter can read the file at all. Nobody has
+ * to be told which is which.
+ */
+export declare function alternateFor<T extends RoutableEngine>(engines: T[], fileName: string): T | undefined;
+/** The message shown when no engine can read the file the author chose. */
+export declare function unsupportedFileMessage(fileName: string, engines: RoutableEngine[]): string;

package/dist/react/import-wizard.d.ts

@@ -26,13 +26,19 @@ export interface PreparedUpload {
  * An engine that implements the optional `prepare`/`convertPrepared` pair also
  * gets the source-selection step; one that only implements `convertFile` keeps
  * the original single-shot flow.
+ *
+ * Engines are never chosen by hand: the wizard routes each upload by its
+ * extension, in list order, so list the engine that should own a shared format
+ * first (see `lib/engine-routing.ts`). `label` and `description` surface only
+ * in the opt-in checkbox for an engine that overlaps an earlier one, and in
+ * error messages — so word them for that, not as a menu entry.
  */
 export interface ImportEngine {
-    /** Stable identifier, used as the radio value. */
+    /** Stable identifier. */
     id: string;
-    /** Short name shown in the engine selector. */
+    /** Short name, used in the opt-in checkbox and in error messages. */
     label: string;
-    /** Optional one-line explanation shown under the label. */
+    /** Optional one-line explanation shown under the opt-in checkbox. */
     description?: string;
     /** Extensions this engine accepts (with leading dot). Defaults to the built-in set. */
     acceptExtensions?: string[];