@pretextbook/import 0.8.0 → 0.9.0

package/README.md

@@ -187,3 +187,40 @@ and use a fixed configuration.
 confirm). Its source-selection step — format dropdown, main-document picker,
 and per-file attach controls — appears whenever the upload leaves a real choice
 open, and is always reachable from the review step.
+
+### Choosing the default import style
+
+A LaTeX or Markdown upload can be imported two ways: `"converted"` (the
+generated PreTeXt) or `"native"` (the cleaned original source, unconverted).
+Each host picks which one the review step starts on — the VS Code extension
+reads the `pretext-tools.import.defaultMode` setting; another host might read
+an account preference:
+
+```tsx
+<ImportWizard
+  defaultImportMode="native" // starts on "Keep as LaTeX"; user can still switch
+  onImportModeChange={(mode) => remember(mode)}
+  onConfirm={handleConfirm}
+/>
+```
+
+Pass `lockImportMode` alongside it to hide the chooser entirely and import in
+that one style — for hosts that only support one.
+
+A PreTeXt upload has no native alternative, so the chooser is hidden and the
+mode handed to `onConfirm` is always `"converted"`, whatever the default said.
+Outside the wizard the same rules are available directly:
+
+```ts
+import {
+  DEFAULT_IMPORT_MODE, // "converted"
+  hasNativeImportMode, // does this result carry a native alternative?
+  resolveImportMode, // preference + result → the mode that really applies
+  filesForImportMode,
+  assetsForImportMode,
+  projectForImportMode,
+} from "@pretextbook/import";
+
+const mode = resolveImportMode(result, preferredMode);
+const files = filesForImportMode(result, mode);
+```

package/dist/import-mode-BaaBvzcy.js

@@ -0,0 +1,122 @@
+import { X as p, a4 as h } from "./upload-BmErkg8I.js";
+function u(e, t) {
+  const o = e.length === 0 ? [] : e.split(`
+`), i = t.length === 0 ? [] : t.split(`
+`);
+  if (o.length + i.length > d)
+    return [
+      ...o.map(
+        (s, l) => ({ op: "remove", text: s, beforeLine: l + 1 })
+      ),
+      ...i.map((s, l) => ({ op: "add", text: s, afterLine: l + 1 }))
+    ];
+  const a = Array.from(
+    { length: o.length + 1 },
+    () => new Array(i.length + 1).fill(0)
+  );
+  for (let s = o.length - 1; s >= 0; s--)
+    for (let l = i.length - 1; l >= 0; l--)
+      a[s][l] = o[s] === i[l] ? a[s + 1][l + 1] + 1 : Math.max(a[s + 1][l], a[s][l + 1]);
+  const c = [];
+  let n = 0, r = 0;
+  for (; n < o.length && r < i.length; )
+    o[n] === i[r] ? (c.push({
+      op: "keep",
+      text: o[n],
+      beforeLine: n + 1,
+      afterLine: r + 1
+    }), n++, r++) : a[n + 1][r] >= a[n][r + 1] ? (c.push({ op: "remove", text: o[n], beforeLine: n + 1 }), n++) : (c.push({ op: "add", text: i[r], afterLine: r + 1 }), r++);
+  for (; n < o.length; )
+    c.push({ op: "remove", text: o[n], beforeLine: ++n });
+  for (; r < i.length; ) c.push({ op: "add", text: i[r], afterLine: ++r });
+  return c;
+}
+const d = 2e4;
+function m(e) {
+  let t = 0, o = 0;
+  for (const i of e)
+    i.op === "add" ? t++ : i.op === "remove" && o++;
+  return { added: t, removed: o };
+}
+function v(e, t = 2) {
+  const o = e.map((n, r) => n.op === "keep" ? -1 : r).filter((n) => n >= 0);
+  if (o.length === 0) return [];
+  const i = [];
+  let a = Math.max(0, o[0] - t), c = Math.min(e.length - 1, o[0] + t);
+  for (const n of o.slice(1)) {
+    if (n - t <= c + 1) {
+      c = Math.min(e.length - 1, n + t);
+      continue;
+    }
+    i.push({ lines: e.slice(a, c + 1) }), a = Math.max(0, n - t), c = Math.min(e.length - 1, n + t);
+  }
+  return i.push({ lines: e.slice(a, c + 1) }), i;
+}
+function k(e, t = e.splitLevel) {
+  if (e.cleanChunks.length === 0) return [];
+  const o = p(e.cleanChunks, t), i = g(o), { pathByRef: a } = h(e.project, {
+    mainSourcePath: e.projectLayout.mainSourcePath,
+    publicationPath: e.projectLayout.publicationPath,
+    projectFilePath: e.projectLayout.projectFilePath,
+    includeScaffold: !e.projectLayout.preserved
+  }), c = [];
+  for (const n of e.project.divisions) {
+    const r = a[n.xmlId];
+    if (!r) continue;
+    const s = n.isRoot ? o.find((f) => f.kind === "preamble" || f.kind === "lead") : i.get(n.title);
+    if (!s) continue;
+    const l = u(s.before, s.after);
+    c.push({
+      path: r,
+      title: n.title,
+      before: s.before,
+      after: s.after,
+      stats: m(l),
+      hunks: v(l),
+      fixCount: s.fixes.length
+    });
+  }
+  return c.sort((n, r) => n.path.localeCompare(r.path));
+}
+function g(e) {
+  const t = /* @__PURE__ */ new Map();
+  for (const i of e)
+    i.kind !== "division" || !i.title || t.set(i.title, t.has(i.title) ? null : i);
+  const o = /* @__PURE__ */ new Map();
+  for (const [i, a] of t)
+    a && o.set(i, a);
+  return o;
+}
+const L = "converted";
+function M(e) {
+  return e.nativeOutputFiles !== void 0;
+}
+function F(e, t = L) {
+  return t === "native" && !M(e) ? "converted" : t;
+}
+function b(e, t) {
+  return t === "native" ? e.nativeProject ?? e.project : e.project;
+}
+function x(e, t) {
+  return t === "converted" ? e.outputFiles : e.nativeOutputFiles ?? e.files;
+}
+function I(e, t) {
+  return t === "converted" ? e.outputAssets : e.assets;
+}
+function y(e) {
+  const t = e.action === "replace" || e.action === "rewrite" ? `replaced with \`${e.replacement}\`` : e.message ?? e.action, o = e.occurrences > 1 ? ` (x${e.occurrences})` : "";
+  return `[${e.severity}] ${e.macro}: ${t}${o}`;
+}
+export {
+  L as D,
+  I as a,
+  u as b,
+  m as c,
+  v as d,
+  x as e,
+  k as f,
+  y as g,
+  M as h,
+  b as p,
+  F as r
+};

package/dist/import-mode-DuPFMu97.cjs

@@ -0,0 +1,3 @@
+"use strict";const p=require("./upload-BtS22hIH.cjs");function h(e,t){const n=e.length===0?[]:e.split(`
+`),i=t.length===0?[]:t.split(`
+`);if(n.length+i.length>M)return[...n.map((s,f)=>({op:"remove",text:s,beforeLine:f+1})),...i.map((s,f)=>({op:"add",text:s,afterLine:f+1}))];const c=Array.from({length:n.length+1},()=>new Array(i.length+1).fill(0));for(let s=n.length-1;s>=0;s--)for(let f=i.length-1;f>=0;f--)c[s][f]=n[s]===i[f]?c[s+1][f+1]+1:Math.max(c[s+1][f],c[s][f+1]);const a=[];let o=0,r=0;for(;o<n.length&&r<i.length;)n[o]===i[r]?(a.push({op:"keep",text:n[o],beforeLine:o+1,afterLine:r+1}),o++,r++):c[o+1][r]>=c[o][r+1]?(a.push({op:"remove",text:n[o],beforeLine:o+1}),o++):(a.push({op:"add",text:i[r],afterLine:r+1}),r++);for(;o<n.length;)a.push({op:"remove",text:n[o],beforeLine:++o});for(;r<i.length;)a.push({op:"add",text:i[r],afterLine:++r});return a}const M=2e4;function u(e){let t=0,n=0;for(const i of e)i.op==="add"?t++:i.op==="remove"&&n++;return{added:t,removed:n}}function d(e,t=2){const n=e.map((o,r)=>o.op==="keep"?-1:r).filter(o=>o>=0);if(n.length===0)return[];const i=[];let c=Math.max(0,n[0]-t),a=Math.min(e.length-1,n[0]+t);for(const o of n.slice(1)){if(o-t<=a+1){a=Math.min(e.length-1,o+t);continue}i.push({lines:e.slice(c,a+1)}),c=Math.max(0,o-t),a=Math.min(e.length-1,o+t)}return i.push({lines:e.slice(c,a+1)}),i}function L(e,t=e.splitLevel){if(e.cleanChunks.length===0)return[];const n=p.mergeChunksAtLevel(e.cleanChunks,t),i=g(n),{pathByRef:c}=p.serializeProjectToFiles(e.project,{mainSourcePath:e.projectLayout.mainSourcePath,publicationPath:e.projectLayout.publicationPath,projectFilePath:e.projectLayout.projectFilePath,includeScaffold:!e.projectLayout.preserved}),a=[];for(const o of e.project.divisions){const r=c[o.xmlId];if(!r)continue;const s=o.isRoot?n.find(l=>l.kind==="preamble"||l.kind==="lead"):i.get(o.title);if(!s)continue;const f=h(s.before,s.after);a.push({path:r,title:o.title,before:s.before,after:s.after,stats:u(f),hunks:d(f),fixCount:s.fixes.length})}return a.sort((o,r)=>o.path.localeCompare(r.path))}function g(e){const t=new Map;for(const i of e)i.kind!=="division"||!i.title||t.set(i.title,t.has(i.title)?null:i);const n=new Map;for(const[i,c]of t)c&&n.set(i,c);return n}const m="converted";function v(e){return e.nativeOutputFiles!==void 0}function F(e,t=m){return t==="native"&&!v(e)?"converted":t}function I(e,t){return t==="native"?e.nativeProject??e.project:e.project}function j(e,t){return t==="converted"?e.outputFiles:e.nativeOutputFiles??e.files}function k(e,t){return t==="converted"?e.outputAssets:e.assets}function b(e){const t=e.action==="replace"||e.action==="rewrite"?`replaced with \`${e.replacement}\``:e.message??e.action,n=e.occurrences>1?` (x${e.occurrences})`:"";return`[${e.severity}] ${e.macro}: ${t}${n}`}exports.DEFAULT_IMPORT_MODE=m;exports.assetsForImportMode=k;exports.diffHunks=d;exports.diffLines=h;exports.diffStats=u;exports.fileChangesForImport=L;exports.filesForImportMode=j;exports.formatWarningLine=b;exports.hasNativeImportMode=v;exports.projectForImportMode=I;exports.resolveImportMode=F;

package/dist/index.cjs

@@ -1,3 +1,3 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./upload-BtS22hIH.cjs"),g=require("./import-mode-D1gOJw3N.cjs"),I={png:"image/png",jpg:"image/jpeg",jpeg:"image/jpeg",gif:"image/gif",pdf:"application/pdf",eps:"application/postscript",ps:"application/postscript",bmp:"image/bmp",tiff:"image/tiff",tif:"image/tiff",webp:"image/webp",ico:"image/vnd.microsoft.icon"};function b(t){const o=t.split(".").pop()?.toLowerCase()??"";return I[o]??"application/octet-stream"}const h="ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";function A(t){const o=t.length,s=[];for(let n=0;n<o;n+=3){const r=t[n],l=n+1<o,a=n+2<o,u=l?t[n+1]:0,c=a?t[n+2]:0;s.push(h[r>>2]),s.push(h[(r&3)<<4|u>>4]),s.push(l?h[(u&15)<<2|c>>6]:"="),s.push(a?h[c&63]:"=")}return s.join("")}function M(t){return{ref:t.ref,kind:"file",title:t.fileName,short_description:t.fileName,file:{filename:t.fileName,content_type:b(t.fileName),data:A(t.data)}}}function _(t){return{title:t.title,docinfo:t.docinfo,document_type:t.documentKind,divisions_attributes:t.divisions.map(o=>({ref:o.xmlId,source:o.content,source_format:o.sourceFormat,is_root:o.isRoot})),assets_attributes:t.assets.map(M)}}const v={mainSourcePath:"source/main.ptx",publicationPath:"publication/publication.ptx",projectFilePath:"project.ptx",docinfoPath:"source/docinfo.ptx"};function T(t){return e.findAnyElement(t,"pretext")?t:`<pretext>
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./upload-BtS22hIH.cjs"),f=require("./import-mode-DuPFMu97.cjs"),F={png:"image/png",jpg:"image/jpeg",jpeg:"image/jpeg",gif:"image/gif",pdf:"application/pdf",eps:"application/postscript",ps:"application/postscript",bmp:"image/bmp",tiff:"image/tiff",tif:"image/tiff",webp:"image/webp",ico:"image/vnd.microsoft.icon"};function M(t){const o=t.split(".").pop()?.toLowerCase()??"";return F[o]??"application/octet-stream"}const h="ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";function _(t){const o=t.length,s=[];for(let n=0;n<o;n+=3){const r=t[n],l=n+1<o,a=n+2<o,u=l?t[n+1]:0,c=a?t[n+2]:0;s.push(h[r>>2]),s.push(h[(r&3)<<4|u>>4]),s.push(l?h[(u&15)<<2|c>>6]:"="),s.push(a?h[c&63]:"=")}return s.join("")}function b(t){return{ref:t.ref,kind:"file",title:t.fileName,short_description:t.fileName,file:{filename:t.fileName,content_type:M(t.fileName),data:_(t.data)}}}function A(t){return{title:t.title,docinfo:t.docinfo,document_type:t.documentKind,divisions_attributes:t.divisions.map(o=>({ref:o.xmlId,source:o.content,source_format:o.sourceFormat,is_root:o.isRoot})),assets_attributes:t.assets.map(b)}}const v={mainSourcePath:"source/main.ptx",publicationPath:"publication/publication.ptx",projectFilePath:"project.ptx",docinfoPath:"source/docinfo.ptx"};function T(t){return e.findAnyElement(t,"pretext")?t:`<pretext>
 ${t}
-</pretext>`}function L(t,o,s){const n=new Map,r=[],l=`${o}-`;return t.forEach((a,u)=>{const c=a.attributes["xml:id"];let p;if(c){const m=e.slugify(c);p=m.startsWith(l)?m:`${l}${m}`}else p=`${l}${e.padIndex(u+1,t.length)}`,s.push({action:"anomaly",severity:"info",kind:"structure",category:"missing_xml_id",macro:a.name,occurrences:1,message:`<${a.name}> at position ${u+1} has no xml:id; using \`${p}\` as filename.`});const d=n.get(p)??0;n.set(p,d+1);const i=d===0?p:`${p}-${d+1}`;r.push({span:a,slug:i,filename:`${i}.ptx`})}),r}function C(t,o,s,n){const r=e.findTopLevelElements(t,"section");if(r.length===0)return t;const a=L(r,"sec",n).map(u=>{const c=`source/${o}/${u.filename}`;return s[c]=e.withProlog(u.span.outer),{start:u.span.start,end:u.span.end,replacement:`<xi:include href="${o}/${u.filename}"/>`}});return e.spliceReplacements(t,a)}function R(t,o,s){const n=e.findAnyElement(t,"book");if(!n)return s.push({action:"anomaly",severity:"warning",kind:"structure",category:"missing_root",macro:"book",occurrences:1,message:"Document was treated as a book but no <book> element found; emitting as a single file."}),S(t,o);const r={},l=e.findTopLevelElements(n.inner,"chapter");let a=n.inner;if(o.splitChapters&&l.length>0){const d=L(l,"ch",s).map(i=>{let m=i.span.outer;if(o.splitSections){const f=i.span.inner,P=C(f,i.slug,r,s);m=i.span.outer.slice(0,i.span.startTagEnd-i.span.start)+P+i.span.outer.slice(i.span.contentEnd-i.span.start)}const x=`source/${i.filename}`;return r[x]=e.withProlog(m),{start:i.span.start,end:i.span.end,replacement:`<xi:include href="${i.filename}"/>`}});a=e.spliceReplacements(n.inner,d)}const u=t.slice(n.start,n.startTagEnd)+a+t.slice(n.contentEnd,n.end),c=t.slice(0,n.start)+u+t.slice(n.end);return r[o.mainSourcePath]=e.withProlog(e.ensureXIncludeNamespace(T(c.trim()))),r}function S(t,o,s){const n={};return n[o.mainSourcePath]=e.withProlog(T(t.trim())),n}function y(t,o={}){const s=[],n=o.documentKind??e.detectDocumentKind(t),r={splitChapters:o.splitChapters??n==="book",splitSections:o.splitSections??!1,mainSourcePath:o.mainSourcePath??v.mainSourcePath,publicationPath:o.publicationPath??v.publicationPath,projectFilePath:o.projectFilePath??v.projectFilePath,docinfoPath:o.docinfoPath??v.docinfoPath},l=n==="book"?R(t,r,s):S(t,r);return l[r.projectFilePath]=e.renderProjectPtx({mainSource:r.mainSourcePath,publication:r.publicationPath}),l[r.publicationPath]=e.renderPublicationPtx(),{files:l,documentKind:n,warnings:s}}class E extends Error{constructor(){super("Import cancelled."),this.name="ConversionCancelledError"}}let j=0;function F(t,o,s={}){const n=`convert-${j++}`,r=t(),{assets:l={},...a}=s;let u;const c=new Promise((d,i)=>{let m=!1;const x=f=>{m||(m=!0,r.terminate(),f())};u=()=>x(()=>i(new E)),r.addEventListener("message",f=>{const P=f.data;if(!(!P||P.requestId!==n)){if(P.type==="result"){x(()=>d(P.result));return}x(()=>i(new Error(P.message)))}}),r.addEventListener("error",f=>{const P=typeof f=="object"&&f&&"message"in f?String(f.message):"The import worker failed to start.";x(()=>i(new Error(P)))})}),p=[...new Set(Object.values(l).map(d=>d.buffer).filter(d=>d instanceof ArrayBuffer))];return r.postMessage({type:"convert",requestId:n,files:o,assets:l,options:a},p),{result:c,cancel:()=>u?.()}}function k(t){const{createWorker:o,id:s="worker",label:n="Built-in converter",description:r="Create a new project starting with LaTeX, Markdown, or PreTeXt files.",acceptExtensions:l}=t;let a=null;const u=async(c,p)=>{a?.cancel(),a=F(o,c,p);try{return await a.result}finally{a=null}};return{id:s,label:n,description:r,acceptExtensions:l,prepare:async c=>{const{files:p,assets:d}=await e.extractUpload(c);return{fileName:c.name,files:p,assets:d,analysis:e.analyzeImportSources(p)}},convertPrepared:(c,p)=>u(c.files,{...p,assets:c.assets}),convertFile:async(c,p)=>{const{files:d,assets:i}=await e.extractUpload(c);return u(d,{...p,assets:i})},cancel:()=>{a?.cancel(),a=null}}}exports.CLEAN_RULES=e.CLEAN_RULES;exports.LATEX_DIVISION_COMMANDS=e.LATEX_DIVISION_COMMANDS;exports.LATEX_FORMAT_MARKERS=e.LATEX_FORMAT_MARKERS;exports.MARKDOWN_FORMAT_MARKERS=e.MARKDOWN_FORMAT_MARKERS;exports.MAX_SUGGESTED_SPLIT_LEVEL=e.MAX_SUGGESTED_SPLIT_LEVEL;exports.PRETEXT_DIVISION_TAGS=e.PRETEXT_DIVISION_TAGS;exports.PRETEXT_ROOT_TAGS=e.PRETEXT_ROOT_TAGS;exports.analyzeImportSources=e.analyzeImportSources;exports.applyLatexFixes=e.applyLatexFixes;exports.attachLatexRoots=e.attachLatexRoots;exports.attachMarkdownRoots=e.attachMarkdownRoots;exports.buildDivisionPool=e.buildDivisionPool;exports.buildNativeDivisionPool=e.buildNativeDivisionPool;exports.carryOverProjectFiles=e.carryOverProjectFiles;exports.cleanLatex=e.cleanLatex;exports.cleanLatexInChunks=e.cleanLatexInChunks;exports.cleanLatexText=e.cleanLatexText;exports.convertLatexToPretext=e.convertLatexToPretext;exports.convertMarkdownToPretext=e.convertMarkdownToPretext;exports.convertSourceToPretext=e.convertSourceToPretext;exports.defaultAttachLevel=e.defaultAttachLevel;exports.defaultManifestTarget=e.defaultManifestTarget;exports.detectDocumentKind=e.detectDocumentKind;exports.detectSourceFormat=e.detectSourceFormat;exports.divisionChildRefs=e.divisionChildRefs;exports.divisionsAtLevel=e.divisionsAtLevel;exports.expandPretextIncludes=e.expandPretextIncludes;exports.extractUpload=e.extractUpload;exports.filePrefixForDivision=e.filePrefixForDivision;exports.findLatexFixes=e.findLatexFixes;exports.findLatexHeaders=e.findLatexHeaders;exports.findProjectManifest=e.findProjectManifest;exports.fixesToWarnings=e.fixesToWarnings;exports.getConversionErrorMessage=e.getConversionErrorMessage;exports.getLatexCleanDiagnostics=e.getLatexCleanDiagnostics;exports.handleImportUploadFile=e.handleImportUploadFile;exports.importProjectFromFiles=e.importProjectFromFiles;exports.isDivisionTag=e.isDivisionTag;exports.latexDivisionHierarchy=e.latexDivisionHierarchy;exports.latexFixesToCodeActions=e.latexFixesToCodeActions;exports.mergeChunksAtLevel=e.mergeChunksAtLevel;exports.normalizePretextSource=e.normalizePretextSource;exports.parseLatexDivisions=e.parseLatexDivisions;exports.parseProjectManifest=e.parseProjectManifest;exports.relayoutImport=e.relayoutImport;exports.renderProjectPtx=e.renderProjectPtx;exports.renderProjectPtxFromManifest=e.renderProjectPtxFromManifest;exports.renderPublicationPtx=e.renderPublicationPtx;exports.resolveImportSplitLevel=e.resolveImportSplitLevel;exports.resolveSplitLevel=e.resolveSplitLevel;exports.sanitizeRef=e.sanitizeRef;exports.serializeProjectToFiles=e.serializeProjectToFiles;exports.suggestSplitLevel=e.suggestSplitLevel;exports.assetsForImportMode=g.assetsForImportMode;exports.diffHunks=g.diffHunks;exports.diffLines=g.diffLines;exports.diffStats=g.diffStats;exports.fileChangesForImport=g.fileChangesForImport;exports.filesForImportMode=g.filesForImportMode;exports.formatWarningLine=g.formatWarningLine;exports.projectForImportMode=g.projectForImportMode;exports.ConversionCancelledError=E;exports.buildPretextProjectFiles=y;exports.createWorkerEngine=k;exports.runConversionInWorker=F;exports.serializeProjectToPlusPayload=_;
+</pretext>`}function E(t,o,s){const n=new Map,r=[],l=`${o}-`;return t.forEach((a,u)=>{const c=a.attributes["xml:id"];let p;if(c){const P=e.slugify(c);p=P.startsWith(l)?P:`${l}${P}`}else p=`${l}${e.padIndex(u+1,t.length)}`,s.push({action:"anomaly",severity:"info",kind:"structure",category:"missing_xml_id",macro:a.name,occurrences:1,message:`<${a.name}> at position ${u+1} has no xml:id; using \`${p}\` as filename.`});const d=n.get(p)??0;n.set(p,d+1);const i=d===0?p:`${p}-${d+1}`;r.push({span:a,slug:i,filename:`${i}.ptx`})}),r}function C(t,o,s,n){const r=e.findTopLevelElements(t,"section");if(r.length===0)return t;const a=E(r,"sec",n).map(u=>{const c=`source/${o}/${u.filename}`;return s[c]=e.withProlog(u.span.outer),{start:u.span.start,end:u.span.end,replacement:`<xi:include href="${o}/${u.filename}"/>`}});return e.spliceReplacements(t,a)}function R(t,o,s){const n=e.findAnyElement(t,"book");if(!n)return s.push({action:"anomaly",severity:"warning",kind:"structure",category:"missing_root",macro:"book",occurrences:1,message:"Document was treated as a book but no <book> element found; emitting as a single file."}),L(t,o);const r={},l=e.findTopLevelElements(n.inner,"chapter");let a=n.inner;if(o.splitChapters&&l.length>0){const d=E(l,"ch",s).map(i=>{let P=i.span.outer;if(o.splitSections){const m=i.span.inner,g=C(m,i.slug,r,s);P=i.span.outer.slice(0,i.span.startTagEnd-i.span.start)+g+i.span.outer.slice(i.span.contentEnd-i.span.start)}const x=`source/${i.filename}`;return r[x]=e.withProlog(P),{start:i.span.start,end:i.span.end,replacement:`<xi:include href="${i.filename}"/>`}});a=e.spliceReplacements(n.inner,d)}const u=t.slice(n.start,n.startTagEnd)+a+t.slice(n.contentEnd,n.end),c=t.slice(0,n.start)+u+t.slice(n.end);return r[o.mainSourcePath]=e.withProlog(e.ensureXIncludeNamespace(T(c.trim()))),r}function L(t,o,s){const n={};return n[o.mainSourcePath]=e.withProlog(T(t.trim())),n}function y(t,o={}){const s=[],n=o.documentKind??e.detectDocumentKind(t),r={splitChapters:o.splitChapters??n==="book",splitSections:o.splitSections??!1,mainSourcePath:o.mainSourcePath??v.mainSourcePath,publicationPath:o.publicationPath??v.publicationPath,projectFilePath:o.projectFilePath??v.projectFilePath,docinfoPath:o.docinfoPath??v.docinfoPath},l=n==="book"?R(t,r,s):L(t,r);return l[r.projectFilePath]=e.renderProjectPtx({mainSource:r.mainSourcePath,publication:r.publicationPath}),l[r.publicationPath]=e.renderPublicationPtx(),{files:l,documentKind:n,warnings:s}}class S extends Error{constructor(){super("Import cancelled."),this.name="ConversionCancelledError"}}let D=0;function I(t,o,s={}){const n=`convert-${D++}`,r=t(),{assets:l={},...a}=s;let u;const c=new Promise((d,i)=>{let P=!1;const x=m=>{P||(P=!0,r.terminate(),m())};u=()=>x(()=>i(new S)),r.addEventListener("message",m=>{const g=m.data;if(!(!g||g.requestId!==n)){if(g.type==="result"){x(()=>d(g.result));return}x(()=>i(new Error(g.message)))}}),r.addEventListener("error",m=>{const g=typeof m=="object"&&m&&"message"in m?String(m.message):"The import worker failed to start.";x(()=>i(new Error(g)))})}),p=[...new Set(Object.values(l).map(d=>d.buffer).filter(d=>d instanceof ArrayBuffer))];return r.postMessage({type:"convert",requestId:n,files:o,assets:l,options:a},p),{result:c,cancel:()=>u?.()}}function j(t){const{createWorker:o,id:s="worker",label:n="Built-in converter",description:r="Create a new project starting with LaTeX, Markdown, or PreTeXt files.",acceptExtensions:l}=t;let a=null;const u=async(c,p)=>{a?.cancel(),a=I(o,c,p);try{return await a.result}finally{a=null}};return{id:s,label:n,description:r,acceptExtensions:l,prepare:async c=>{const{files:p,assets:d}=await e.extractUpload(c);return{fileName:c.name,files:p,assets:d,analysis:e.analyzeImportSources(p)}},convertPrepared:(c,p)=>u(c.files,{...p,assets:c.assets}),convertFile:async(c,p)=>{const{files:d,assets:i}=await e.extractUpload(c);return u(d,{...p,assets:i})},cancel:()=>{a?.cancel(),a=null}}}exports.CLEAN_RULES=e.CLEAN_RULES;exports.LATEX_DIVISION_COMMANDS=e.LATEX_DIVISION_COMMANDS;exports.LATEX_FORMAT_MARKERS=e.LATEX_FORMAT_MARKERS;exports.MARKDOWN_FORMAT_MARKERS=e.MARKDOWN_FORMAT_MARKERS;exports.MAX_SUGGESTED_SPLIT_LEVEL=e.MAX_SUGGESTED_SPLIT_LEVEL;exports.PRETEXT_DIVISION_TAGS=e.PRETEXT_DIVISION_TAGS;exports.PRETEXT_ROOT_TAGS=e.PRETEXT_ROOT_TAGS;exports.analyzeImportSources=e.analyzeImportSources;exports.applyLatexFixes=e.applyLatexFixes;exports.attachLatexRoots=e.attachLatexRoots;exports.attachMarkdownRoots=e.attachMarkdownRoots;exports.buildDivisionPool=e.buildDivisionPool;exports.buildNativeDivisionPool=e.buildNativeDivisionPool;exports.carryOverProjectFiles=e.carryOverProjectFiles;exports.cleanLatex=e.cleanLatex;exports.cleanLatexInChunks=e.cleanLatexInChunks;exports.cleanLatexText=e.cleanLatexText;exports.convertLatexToPretext=e.convertLatexToPretext;exports.convertMarkdownToPretext=e.convertMarkdownToPretext;exports.convertSourceToPretext=e.convertSourceToPretext;exports.defaultAttachLevel=e.defaultAttachLevel;exports.defaultManifestTarget=e.defaultManifestTarget;exports.detectDocumentKind=e.detectDocumentKind;exports.detectSourceFormat=e.detectSourceFormat;exports.divisionChildRefs=e.divisionChildRefs;exports.divisionsAtLevel=e.divisionsAtLevel;exports.expandPretextIncludes=e.expandPretextIncludes;exports.extractUpload=e.extractUpload;exports.filePrefixForDivision=e.filePrefixForDivision;exports.findLatexFixes=e.findLatexFixes;exports.findLatexHeaders=e.findLatexHeaders;exports.findProjectManifest=e.findProjectManifest;exports.fixesToWarnings=e.fixesToWarnings;exports.getConversionErrorMessage=e.getConversionErrorMessage;exports.getLatexCleanDiagnostics=e.getLatexCleanDiagnostics;exports.handleImportUploadFile=e.handleImportUploadFile;exports.importProjectFromFiles=e.importProjectFromFiles;exports.isDivisionTag=e.isDivisionTag;exports.latexDivisionHierarchy=e.latexDivisionHierarchy;exports.latexFixesToCodeActions=e.latexFixesToCodeActions;exports.mergeChunksAtLevel=e.mergeChunksAtLevel;exports.normalizePretextSource=e.normalizePretextSource;exports.parseLatexDivisions=e.parseLatexDivisions;exports.parseProjectManifest=e.parseProjectManifest;exports.relayoutImport=e.relayoutImport;exports.renderProjectPtx=e.renderProjectPtx;exports.renderProjectPtxFromManifest=e.renderProjectPtxFromManifest;exports.renderPublicationPtx=e.renderPublicationPtx;exports.resolveImportSplitLevel=e.resolveImportSplitLevel;exports.resolveSplitLevel=e.resolveSplitLevel;exports.sanitizeRef=e.sanitizeRef;exports.serializeProjectToFiles=e.serializeProjectToFiles;exports.suggestSplitLevel=e.suggestSplitLevel;exports.DEFAULT_IMPORT_MODE=f.DEFAULT_IMPORT_MODE;exports.assetsForImportMode=f.assetsForImportMode;exports.diffHunks=f.diffHunks;exports.diffLines=f.diffLines;exports.diffStats=f.diffStats;exports.fileChangesForImport=f.fileChangesForImport;exports.filesForImportMode=f.filesForImportMode;exports.formatWarningLine=f.formatWarningLine;exports.hasNativeImportMode=f.hasNativeImportMode;exports.projectForImportMode=f.projectForImportMode;exports.resolveImportMode=f.resolveImportMode;exports.ConversionCancelledError=S;exports.buildPretextProjectFiles=y;exports.createWorkerEngine=j;exports.runConversionInWorker=I;exports.serializeProjectToPlusPayload=A;

package/dist/index.d.ts

@@ -11,7 +11,7 @@ export { attachLatexRoots, attachMarkdownRoots, defaultAttachLevel, type AttachL
 export { defaultManifestTarget, findProjectManifest, parseProjectManifest, type ManifestTarget, type ProjectManifest, } from './lib/project/manifest';
 export { carryOverProjectFiles, renderProjectPtxFromManifest, type CarryOverOptions, type CarryOverResult, } from './lib/project/existing-project';
 export { PRETEXT_DIVISION_TAGS, PRETEXT_ROOT_TAGS, filePrefixForDivision, isDivisionTag, type PretextDivisionTag, type PretextRootTag, } from './lib/pretext-divisions';
-export { filesForImportMode, assetsForImportMode, projectForImportMode, formatWarningLine, type ImportMode, } from './lib/import-mode';
+export { DEFAULT_IMPORT_MODE, filesForImportMode, assetsForImportMode, hasNativeImportMode, projectForImportMode, resolveImportMode, formatWarningLine, type ImportMode, } from './lib/import-mode';
 export { cleanLatex, fixesToWarnings } from './lib/clean/clean-latex';
 export type { CleanLatexOptions, CleanLatexResult, } from './lib/clean/clean-latex';
 export { CLEAN_RULES, findLatexFixes, applyLatexFixes, cleanLatexText, getLatexCleanDiagnostics, latexFixesToCodeActions, } from '@pretextbook/latex-style-pretext';

package/dist/index.js

@@ -1,6 +1,6 @@
-import { d as w, r as I, a as _, f as E, b as T, w as x, s as v, e as C, c as k, p as y, g as b, h as A } from "./upload-BmErkg8I.js";
-import { C as q, L as V, i as Y, M as J, j as Q, P as Z, k as ee, l as te, m as se, n as ne, o as ae, q as oe, t as re, u as ie, v as ce, x as le, y as ue, z as pe, A as fe, B as me, D as de, E as ge, F as Pe, G as he, H as xe, I as be, J as Ee, K as Te, N as ve, O as Se, Q as Le, R as Fe, S as we, T as Ie, U as _e, V as Ce, W as ke, X as ye, Y as Ae, Z as Me, _ as je, $ as Re, a0 as $e, a1 as De, a2 as Ne, a3 as Oe, a4 as Be, a5 as We } from "./upload-BmErkg8I.js";
-import { a as Ke, d as ze, b as Ue, c as Ge, f as He, e as qe, g as Ve, p as Ye } from "./import-mode-BCGuSwkM.js";
+import { d as I, r as _, a as w, f as T, b, w as x, s as v, e as C, c as k, p as y, g as E, h as A } from "./upload-BmErkg8I.js";
+import { C as q, L as V, i as Y, M as J, j as Q, P as Z, k as ee, l as te, m as se, n as ae, o as ne, q as oe, t as re, u as ie, v as ce, x as le, y as ue, z as pe, A as fe, B as me, D as de, E as ge, F as Pe, G as he, H as xe, I as Ee, J as Te, K as be, N as ve, O as Se, Q as Le, R as Fe, S as Ie, T as _e, U as we, V as Ce, W as ke, X as ye, Y as Ae, Z as Me, _ as Re, $ as je, a0 as De, a1 as $e, a2 as Ne, a3 as Oe, a4 as Be, a5 as We } from "./upload-BmErkg8I.js";
+import { D as Ke, a as ze, d as Ue, b as Ge, c as He, f as qe, e as Ve, g as Ye, h as Je, p as Qe, r as Ze } from "./import-mode-BaaBvzcy.js";
 const M = {
   png: "image/png",
   jpg: "image/jpeg",
@@ -15,20 +15,20 @@ const M = {
   webp: "image/webp",
   ico: "image/vnd.microsoft.icon"
 };
-function j(e) {
+function R(e) {
   const s = e.split(".").pop()?.toLowerCase() ?? "";
   return M[s] ?? "application/octet-stream";
 }
 const P = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
-function R(e) {
+function j(e) {
   const s = e.length, o = [];
   for (let t = 0; t < s; t += 3) {
-    const n = e[t], c = t + 1 < s, r = t + 2 < s, l = c ? e[t + 1] : 0, i = r ? e[t + 2] : 0;
-    o.push(P[n >> 2]), o.push(P[(n & 3) << 4 | l >> 4]), o.push(c ? P[(l & 15) << 2 | i >> 6] : "="), o.push(r ? P[i & 63] : "=");
+    const a = e[t], c = t + 1 < s, r = t + 2 < s, l = c ? e[t + 1] : 0, i = r ? e[t + 2] : 0;
+    o.push(P[a >> 2]), o.push(P[(a & 3) << 4 | l >> 4]), o.push(c ? P[(l & 15) << 2 | i >> 6] : "="), o.push(r ? P[i & 63] : "=");
   }
   return o.join("");
 }
-function $(e) {
+function D(e) {
   return {
     ref: e.ref,
     kind: "file",
@@ -36,8 +36,8 @@ function $(e) {
     short_description: e.fileName,
     file: {
       filename: e.fileName,
-      content_type: j(e.fileName),
-      data: R(e.data)
+      content_type: R(e.fileName),
+      data: j(e.data)
     }
   };
 }
@@ -52,7 +52,7 @@ function K(e) {
       source_format: s.sourceFormat,
       is_root: s.isRoot
     })),
-    assets_attributes: e.assets.map($)
+    assets_attributes: e.assets.map(D)
   };
 }
 const h = {
@@ -62,12 +62,12 @@ const h = {
   docinfoPath: "source/docinfo.ptx"
 };
 function S(e) {
-  return E(e, "pretext") ? e : `<pretext>
+  return T(e, "pretext") ? e : `<pretext>
 ${e}
 </pretext>`;
 }
 function L(e, s, o) {
-  const t = /* @__PURE__ */ new Map(), n = [], c = `${s}-`;
+  const t = /* @__PURE__ */ new Map(), a = [], c = `${s}-`;
   return e.forEach((r, l) => {
     const i = r.attributes["xml:id"];
     let u;
@@ -86,19 +86,19 @@ function L(e, s, o) {
       });
     const p = t.get(u) ?? 0;
     t.set(u, p + 1);
-    const a = p === 0 ? u : `${u}-${p + 1}`;
-    n.push({
+    const n = p === 0 ? u : `${u}-${p + 1}`;
+    a.push({
       span: r,
-      slug: a,
-      filename: `${a}.ptx`
+      slug: n,
+      filename: `${n}.ptx`
     });
-  }), n;
+  }), a;
 }
-function D(e, s, o, t) {
-  const n = T(e, "section");
-  if (n.length === 0)
+function $(e, s, o, t) {
+  const a = b(e, "section");
+  if (a.length === 0)
     return e;
-  const r = L(n, "sec", t).map((l) => {
+  const r = L(a, "sec", t).map((l) => {
     const i = `source/${s}/${l.filename}`;
     return o[i] = x(l.span.outer), {
       start: l.span.start,
@@ -109,7 +109,7 @@ function D(e, s, o, t) {
   return v(e, r);
 }
 function N(e, s, o) {
-  const t = E(e, "book");
+  const t = T(e, "book");
   if (!t)
     return o.push({
       action: "anomaly",
@@ -120,33 +120,33 @@ function N(e, s, o) {
       occurrences: 1,
       message: "Document was treated as a book but no <book> element found; emitting as a single file."
     }), F(e, s);
-  const n = {}, c = T(t.inner, "chapter");
+  const a = {}, c = b(t.inner, "chapter");
   let r = t.inner;
   if (s.splitChapters && c.length > 0) {
-    const p = L(c, "ch", o).map((a) => {
-      let m = a.span.outer;
+    const p = L(c, "ch", o).map((n) => {
+      let m = n.span.outer;
       if (s.splitSections) {
-        const f = a.span.inner, d = D(
+        const f = n.span.inner, d = $(
           f,
-          a.slug,
-          n,
+          n.slug,
+          a,
           o
         );
-        m = a.span.outer.slice(0, a.span.startTagEnd - a.span.start) + d + a.span.outer.slice(a.span.contentEnd - a.span.start);
+        m = n.span.outer.slice(0, n.span.startTagEnd - n.span.start) + d + n.span.outer.slice(n.span.contentEnd - n.span.start);
       }
-      const g = `source/${a.filename}`;
-      return n[g] = x(m), {
-        start: a.span.start,
-        end: a.span.end,
-        replacement: `<xi:include href="${a.filename}"/>`
+      const g = `source/${n.filename}`;
+      return a[g] = x(m), {
+        start: n.span.start,
+        end: n.span.end,
+        replacement: `<xi:include href="${n.filename}"/>`
       };
     });
     r = v(t.inner, p);
   }
   const l = e.slice(t.start, t.startTagEnd) + r + e.slice(t.contentEnd, t.end), i = e.slice(0, t.start) + l + e.slice(t.end);
-  return n[s.mainSourcePath] = x(
+  return a[s.mainSourcePath] = x(
     C(S(i.trim()))
-  ), n;
+  ), a;
 }
 function F(e, s, o) {
   const t = {};
@@ -155,18 +155,18 @@ function F(e, s, o) {
   ), t;
 }
 function z(e, s = {}) {
-  const o = [], t = s.documentKind ?? w(e), n = {
+  const o = [], t = s.documentKind ?? I(e), a = {
     splitChapters: s.splitChapters ?? t === "book",
     splitSections: s.splitSections ?? !1,
     mainSourcePath: s.mainSourcePath ?? h.mainSourcePath,
     publicationPath: s.publicationPath ?? h.publicationPath,
     projectFilePath: s.projectFilePath ?? h.projectFilePath,
     docinfoPath: s.docinfoPath ?? h.docinfoPath
-  }, c = t === "book" ? N(e, n, o) : F(e, n);
-  return c[n.projectFilePath] = I({
-    mainSource: n.mainSourcePath,
-    publication: n.publicationPath
-  }), c[n.publicationPath] = _(), { files: c, documentKind: t, warnings: o };
+  }, c = t === "book" ? N(e, a, o) : F(e, a);
+  return c[a.projectFilePath] = _({
+    mainSource: a.mainSourcePath,
+    publication: a.publicationPath
+  }), c[a.publicationPath] = w(), { files: c, documentKind: t, warnings: o };
 }
 class O extends Error {
   constructor() {
@@ -175,25 +175,25 @@ class O extends Error {
 }
 let B = 0;
 function W(e, s, o = {}) {
-  const t = `convert-${B++}`, n = e(), { assets: c = {}, ...r } = o;
+  const t = `convert-${B++}`, a = e(), { assets: c = {}, ...r } = o;
   let l;
-  const i = new Promise((p, a) => {
+  const i = new Promise((p, n) => {
     let m = !1;
     const g = (f) => {
-      m || (m = !0, n.terminate(), f());
+      m || (m = !0, a.terminate(), f());
     };
-    l = () => g(() => a(new O())), n.addEventListener("message", (f) => {
+    l = () => g(() => n(new O())), a.addEventListener("message", (f) => {
       const d = f.data;
       if (!(!d || d.requestId !== t)) {
         if (d.type === "result") {
           g(() => p(d.result));
           return;
         }
-        g(() => a(new Error(d.message)));
+        g(() => n(new Error(d.message)));
       }
-    }), n.addEventListener("error", (f) => {
+    }), a.addEventListener("error", (f) => {
       const d = typeof f == "object" && f && "message" in f ? String(f.message) : "The import worker failed to start.";
-      g(() => a(new Error(d)));
+      g(() => n(new Error(d)));
     });
   }), u = [
     ...new Set(
@@ -202,7 +202,7 @@ function W(e, s, o = {}) {
       )
     )
   ];
-  return n.postMessage(
+  return a.postMessage(
     { type: "convert", requestId: t, files: s, assets: c, options: r },
     u
   ), { result: i, cancel: () => l?.() };
@@ -212,7 +212,7 @@ function U(e) {
     createWorker: s,
     id: o = "worker",
     label: t = "Built-in converter",
-    description: n = "Create a new project starting with LaTeX, Markdown, or PreTeXt files.",
+    description: a = "Create a new project starting with LaTeX, Markdown, or PreTeXt files.",
     acceptExtensions: c
   } = e;
   let r = null;
@@ -227,10 +227,10 @@ function U(e) {
   return {
     id: o,
     label: t,
-    description: n,
+    description: a,
     acceptExtensions: c,
     prepare: async (i) => {
-      const { files: u, assets: p } = await b(i);
+      const { files: u, assets: p } = await E(i);
       return {
         fileName: i.name,
         files: u,
@@ -240,8 +240,8 @@ function U(e) {
     },
     convertPrepared: (i, u) => l(i.files, { ...u, assets: i.assets }),
     convertFile: async (i, u) => {
-      const { files: p, assets: a } = await b(i);
-      return l(p, { ...u, assets: a });
+      const { files: p, assets: n } = await E(i);
+      return l(p, { ...u, assets: n });
     },
     cancel: () => {
       r?.cancel(), r = null;
@@ -251,6 +251,7 @@ function U(e) {
 export {
   q as CLEAN_RULES,
   O as ConversionCancelledError,
+  Ke as DEFAULT_IMPORT_MODE,
   V as LATEX_DIVISION_COMMANDS,
   Y as LATEX_FORMAT_MARKERS,
   J as MARKDOWN_FORMAT_MARKERS,
@@ -259,10 +260,10 @@ export {
   ee as PRETEXT_ROOT_TAGS,
   A as analyzeImportSources,
   te as applyLatexFixes,
-  Ke as assetsForImportMode,
+  ze as assetsForImportMode,
   se as attachLatexRoots,
-  ne as attachMarkdownRoots,
-  ae as buildDivisionPool,
+  ae as attachMarkdownRoots,
+  ne as buildDivisionPool,
   oe as buildNativeDivisionPool,
   z as buildPretextProjectFiles,
   re as carryOverProjectFiles,
@@ -275,40 +276,42 @@ export {
   U as createWorkerEngine,
   me as defaultAttachLevel,
   de as defaultManifestTarget,
-  w as detectDocumentKind,
+  I as detectDocumentKind,
   ge as detectSourceFormat,
-  ze as diffHunks,
-  Ue as diffLines,
-  Ge as diffStats,
+  Ue as diffHunks,
+  Ge as diffLines,
+  He as diffStats,
   Pe as divisionChildRefs,
   he as divisionsAtLevel,
   xe as expandPretextIncludes,
-  b as extractUpload,
-  He as fileChangesForImport,
-  be as filePrefixForDivision,
-  qe as filesForImportMode,
-  Ee as findLatexFixes,
-  Te as findLatexHeaders,
+  E as extractUpload,
+  qe as fileChangesForImport,
+  Ee as filePrefixForDivision,
+  Ve as filesForImportMode,
+  Te as findLatexFixes,
+  be as findLatexHeaders,
   ve as findProjectManifest,
   Se as fixesToWarnings,
-  Ve as formatWarningLine,
+  Ye as formatWarningLine,
   Le as getConversionErrorMessage,
   Fe as getLatexCleanDiagnostics,
-  we as handleImportUploadFile,
-  Ie as importProjectFromFiles,
-  _e as isDivisionTag,
+  Ie as handleImportUploadFile,
+  Je as hasNativeImportMode,
+  _e as importProjectFromFiles,
+  we as isDivisionTag,
   Ce as latexDivisionHierarchy,
   ke as latexFixesToCodeActions,
   ye as mergeChunksAtLevel,
   Ae as normalizePretextSource,
   Me as parseLatexDivisions,
-  je as parseProjectManifest,
-  Ye as projectForImportMode,
-  Re as relayoutImport,
-  I as renderProjectPtx,
-  $e as renderProjectPtxFromManifest,
-  _ as renderPublicationPtx,
-  De as resolveImportSplitLevel,
+  Re as parseProjectManifest,
+  Qe as projectForImportMode,
+  je as relayoutImport,
+  _ as renderProjectPtx,
+  De as renderProjectPtxFromManifest,
+  w as renderPublicationPtx,
+  Ze as resolveImportMode,
+  $e as resolveImportSplitLevel,
   Ne as resolveSplitLevel,
   W as runConversionInWorker,
   Oe as sanitizeRef,

package/dist/lib/import-mode.d.ts

@@ -2,6 +2,28 @@ import { CleaningWarning } from './clean/warnings';
 import { ImportedProject, ImportedProjectSuccess } from './types';
 /** Which of the result's alternatives the user chose to import. */
 export type ImportMode = "converted" | "native";
+/**
+ * The mode a host gets when it expresses no preference: convert to PreTeXt.
+ * Exported so consumers that surface their own default (a VS Code setting, a
+ * pretext-plus account preference) can name this one rather than re-spelling
+ * the string literal.
+ */
+export declare const DEFAULT_IMPORT_MODE: ImportMode;
+/**
+ * Does this result actually carry a native alternative? Only LaTeX and
+ * Markdown imports produce one — a PreTeXt upload has nothing to keep — so a
+ * host or UI that offers the choice should ask this first rather than keying
+ * off the detected format.
+ */
+export declare function hasNativeImportMode(result: ImportedProjectSuccess): boolean;
+/**
+ * The mode that will really be applied to this result, given a preference.
+ * A preferred `"native"` collapses to `"converted"` when the result has no
+ * native projection, which keeps the mode a host reports (and stores) in step
+ * with the files it actually writes — the `*ForImportMode` helpers fall back
+ * silently on their own.
+ */
+export declare function resolveImportMode(result: ImportedProjectSuccess, preferred?: ImportMode): ImportMode;
 /**
  * The division pool the pretext-plus host should serialize for the chosen
  * mode: the native (LaTeX/Markdown) pool when the user keeps the source

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

@@ -68,10 +68,25 @@ export interface ImportWizardProps {
     /** Pass fixed options to skip the document-kind / split-sections controls. */
     importOptions?: ImportProjectOptions;
     defaultDocumentKind?: DocumentKind | "auto";
+    /**
+     * Which import style the review step starts on: `"converted"` (the PreTeXt
+     * output) or `"native"` (the cleaned LaTeX/Markdown source, unconverted).
+     * The user can still switch, unless `lockImportMode` is set. Ignored for
+     * results with no native alternative — a PreTeXt upload always reviews as
+     * converted.
+     */
+    defaultImportMode?: ImportMode;
+    /**
+     * Hide the import-mode chooser and import in `defaultImportMode` only. For
+     * hosts that support just one style, or that already asked elsewhere.
+     */
+    lockImportMode?: boolean;
+    /** Called when the user picks a different import mode on the review step. */
+    onImportModeChange?: (mode: ImportMode) => void;
     /**
      * Converters offered to the user. When more than one is supplied, an engine
      * selector is shown on the upload step. Defaults to a single built-in engine.
      */
     engines?: ImportEngine[];
 }
-export declare function ImportWizard({ onConfirm, onCancel, importOptions, defaultDocumentKind, engines, }: ImportWizardProps): import("react").JSX.Element;
+export declare function ImportWizard({ onConfirm, onCancel, importOptions, defaultDocumentKind, defaultImportMode, lockImportMode, onImportModeChange, engines, }: ImportWizardProps): import("react").JSX.Element;