latextify 0.3.0__tar.gz → 0.3.2__tar.gz

{latextify-0.3.0 → latextify-0.3.2}/.github/workflows/ci.yml

@@ -138,9 +138,8 @@ jobs:
     # OLDEST supported Python (3.10, our documented floor -- see
     # requires-python in pyproject.toml) on the platform most kit users
     # actually run: Windows. A future dependency bump could silently break
-    # the 3.10 floor without this catching it. Kept fast: emit-only
-    # (--no-warm-tex, no --pdf) -- the PDF/Tectonic offline path is already
-    # covered by the `offline-kit` job above.
+    # the 3.10 floor without this catching it. This job also freezes and boots
+    # the no-Python portable application while the network is poisoned.
     runs-on: windows-latest
     steps:
       - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
@@ -148,14 +147,14 @@ jobs:
         with:
           python-version: "3.13"
       - name: Install
-        run: uv sync --locked
+        run: uv sync --locked --group portable
       - name: Set up the TARGET Python 3.10 (what install.py will run under)
         id: py310
         uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7.0.0
         with:
           python-version: "3.10"
-      - name: Build an emit-only kit covering Python 3.10 (network ON)
-        run: uv run latextify make-kit --target current --python-versions 3.10 --no-warm-tex --output build
+      - name: Build a GUI kit covering Python 3.10 and warm one journal (network ON)
+        run: uv run latextify make-kit --target current --python-versions 3.10 --with-gui --journals revtex4-2 --output build
       - name: Install the kit under Python 3.10, network POISONED
         env:
           # Same reasoning as the Linux offline-kit job: uppercase only, one
@@ -166,6 +165,12 @@ jobs:
         run: |
           & "${{ steps.py310.outputs.python-path }}" "build/latextify-offline-windows-x64/install.py"
           if ($LASTEXITCODE -ne 0) { throw "install.py failed under Python 3.10 (exit $LASTEXITCODE)" }
+          $kit = "build/latextify-offline-windows-x64"
+          & "$kit/.venv/Scripts/python.exe" -c "import fastapi, uvicorn, multipart; import latextify.gui.server"
+          if ($LASTEXITCODE -ne 0) { throw "offline GUI imports failed (exit $LASTEXITCODE)" }
+          if (-not (Test-Path "$kit/Start-LaTeXtify-GUI.bat")) {
+            throw "offline GUI launcher was not generated"
+          }
       - name: Convert a fixture manuscript offline (emit-only, no --pdf)
         env:
           HTTPS_PROXY: http://127.0.0.1:9
@@ -178,3 +183,40 @@ jobs:
             throw "Python 3.10 kit did not produce demo-out/revtex4-2/main.tex"
           }
           Write-Host "offline (Python 3.10, Windows): produced demo-out/revtex4-2/main.tex"
+      - name: Build the no-install portable Windows application
+        run: uv run --group portable python tools/build_windows_portable.py --kit build/latextify-offline-windows-x64 --output build/portable
+      - name: Exercise the frozen application with the network poisoned
+        env:
+          HTTPS_PROXY: http://127.0.0.1:9
+          HTTP_PROXY: http://127.0.0.1:9
+          ALL_PROXY: http://127.0.0.1:9
+        run: |
+          $app = Resolve-Path "build/portable/LaTeXtify-Windows-Portable/LaTeXtify.exe"
+          $selfTest = Start-Process -FilePath $app -ArgumentList "--self-test" -PassThru -Wait -WindowStyle Hidden
+          if ($selfTest.ExitCode -ne 0) {
+            Get-Content "build/portable/LaTeXtify-Windows-Portable/latextify-startup.log" -ErrorAction SilentlyContinue
+            throw "portable self-test failed (exit $($selfTest.ExitCode))"
+          }
+          $env:LATEXTIFY_NO_BROWSER = "1"
+          $env:LATEXTIFY_PORT = "8765"
+          $process = Start-Process -FilePath $app -PassThru -WindowStyle Hidden
+          try {
+            $ready = $false
+            foreach ($attempt in 1..30) {
+              Start-Sleep -Seconds 1
+              try {
+                $response = Invoke-WebRequest "http://127.0.0.1:8765/" -UseBasicParsing -NoProxy
+                if ($response.StatusCode -eq 200 -and $response.Content -match "LaTeXtify") {
+                  $ready = $true
+                  break
+                }
+              } catch {}
+              if ($process.HasExited) { break }
+            }
+            if (-not $ready) {
+              Get-Content "build/portable/LaTeXtify-Windows-Portable/latextify-startup.log" -ErrorAction SilentlyContinue
+              throw "portable GUI did not answer on loopback"
+            }
+          } finally {
+            if (-not $process.HasExited) { Stop-Process -Id $process.Id -Force }
+          }

{latextify-0.3.0 → latextify-0.3.2}/.github/workflows/release.yml

@@ -27,7 +27,50 @@ concurrency:
   cancel-in-progress: false
 
 jobs:
+  build-windows-portable:
+    runs-on: windows-latest
+    timeout-minutes: 60
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
+        with:
+          ref: ${{ github.event.inputs.tag || github.ref_name }}
+      - uses: astral-sh/setup-uv@bec219d24cd3e171d82865faccec33120bb574f4 # v10.1.0
+        with:
+          python-version: "3.13"
+      - name: Cache Tectonic binary and package bundle
+        uses: actions/cache@55cc8345863c7cc4c66a329aec7e433d2d1c52a9 # v6
+        with:
+          path: |
+            ~/.cache/latextify
+            ~/.cache/Tectonic
+          key: tectonic-${{ runner.os }}-v1
+      - name: Install build dependencies
+        run: uv sync --locked --no-dev --extra gui --group portable
+      - name: Build native Windows runtime assets
+        env:
+          GITHUB_TOKEN: ${{ github.token }}
+        run: uv run latextify make-kit --target current --python-versions 3.13 --with-gui -o build
+      - name: Freeze and verify the portable application
+        env:
+          HTTPS_PROXY: http://127.0.0.1:9
+          HTTP_PROXY: http://127.0.0.1:9
+          ALL_PROXY: http://127.0.0.1:9
+        run: |
+          uv run --group portable python tools/build_windows_portable.py --kit build/latextify-offline-windows-x64 --output build/portable
+          $app = Resolve-Path "build/portable/LaTeXtify-Windows-Portable/LaTeXtify.exe"
+          $selfTest = Start-Process -FilePath $app -ArgumentList "--self-test" -PassThru -Wait -WindowStyle Hidden
+          if ($selfTest.ExitCode -ne 0) {
+            Get-Content "build/portable/LaTeXtify-Windows-Portable/latextify-startup.log" -ErrorAction SilentlyContinue
+            throw "portable self-test failed (exit $($selfTest.ExitCode))"
+          }
+      - uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7
+        with:
+          name: windows-portable
+          path: build/portable/LaTeXtify-Windows-Portable.zip
+          if-no-files-found: error
+
   build-kits:
+    needs: build-windows-portable
     runs-on: ubuntu-latest
     timeout-minutes: 60
     steps:
@@ -54,7 +97,7 @@ jobs:
       - name: Build native Linux kit (warms the shared, portable TeX cache)
         env:
           GITHUB_TOKEN: ${{ github.token }}
-        run: uv run latextify make-kit --target linux-x64 -o build
+        run: uv run latextify make-kit --target linux-x64 --with-gui -o build
 
       # NOTE -- native-build preference: this workflow cross-builds the
       # win-x64 (and macos-arm64) kits from a single Linux runner, on a
@@ -80,7 +123,7 @@ jobs:
           # and reuse it for the cross targets rather than re-downloading the
           # whole TeX bundle two more times.
           for tgt in win-x64 macos-arm64; do
-            uv run latextify make-kit --target "$tgt" --no-warm-tex -o build
+            uv run latextify make-kit --target "$tgt" --with-gui --no-warm-tex -o build
           done
           uv run python - <<'PY'
           import json
@@ -116,6 +159,17 @@ jobs:
           ls -lh *.zip SHA256SUMS.txt
           cat SHA256SUMS.txt
 
+      - uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8
+        with:
+          name: windows-portable
+          path: build
+
+      - name: Add the portable Windows application to checksums
+        run: |
+          cd build
+          sha256sum LaTeXtify-Windows-Portable.zip >> SHA256SUMS.txt
+          cat SHA256SUMS.txt
+
       - name: Create release (if missing) and upload assets
         env:
           GH_TOKEN: ${{ github.token }}
@@ -126,6 +180,7 @@ jobs:
             latextify-offline-windows-x64.zip
             latextify-offline-linux-x64.zip
             latextify-offline-macos-arm64.zip
+            LaTeXtify-Windows-Portable.zip
             latextify-source.zip
             SHA256SUMS.txt
           )

{latextify-0.3.0 → latextify-0.3.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: latextify
-Version: 0.3.0
+Version: 0.3.2
 Summary: Convert Word manuscripts to journal-ready LaTeX projects and PDFs
 Project-URL: Homepage, https://github.com/pquarterman17/LaTeXtify
 Project-URL: Repository, https://github.com/pquarterman17/LaTeXtify
@@ -252,8 +252,9 @@ holds real vector for anything drawn:
   Metafile)*. That lands as EMF, which is vector. A plain Ctrl+V usually gives
   you a bitmap.
 - **LaTeXtify converts EMF and WMF to PDF** when LibreOffice or Inkscape is on
-  your PATH. Neither is a dependency — without one, the figure is skipped and
-  the warning names the fix.
+  your PATH or in its usual Windows install directory. If neither is available,
+  it tries a 600-DPI PNG fallback and warns that the result is no longer vector;
+  a metafile it cannot safely decode is skipped with an actionable warning.
 - **Export from the plotting tool.** Saving directly to PDF or SVG and dropping
   it in as `figures/fig<N>.pdf` skips Word entirely and is the most reliable
   route.
@@ -330,7 +331,34 @@ To start the web GUI without touching a command line, double-click
 **`startup.bat`** (Windows) or run **`./startup.sh`** (macOS/Linux). It installs
 dependencies on first run, opens the GUI in your browser, and — if anything
 goes wrong — writes an easy-to-find `latextify-startup.log` next to the script
-and prints it for you to copy.
+and prints it for you to copy. This source-tree launcher needs internet access
+on its first run.
+
+### Offline / firewalled Windows computer
+
+Do not transfer GitHub's automatically generated source-code ZIP or
+`latextify-source.zip`: their `startup.bat` must fetch `uv` and Python packages.
+For a locked-down work computer, download the release asset named
+**`LaTeXtify-Windows-Portable.zip`**, transfer it using an approved method,
+extract the whole folder to a short writable path such as `C:\LaTeXtify`, and
+double-click **`LaTeXtify.exe`**. It carries its own Python runtime, GUI,
+Pandoc, Tectonic, and warmed TeX cache. It performs no installation and needs
+no administrator rights, Python, `uv`, `pip`, GitHub, Astral, or PyPI access.
+
+The older **`latextify-offline-windows-x64.zip`** remains available for users
+who prefer a conventional, inspectable Python environment. It requires a
+supported 64-bit Python already present. Extract it and run:
+
+```bat
+py install.py
+```
+
+Then double-click **`Start-LaTeXtify-GUI.bat`**. That offline package contains
+the GUI, Pandoc, Tectonic, dependencies, and a warmed TeX cache; it does not
+contact GitHub, Astral, PyPI, or Crossref. It requires a supported 64-bit
+Python already present on the work computer. Embedded EMF/WMF figures work,
+but preserving them as vectors requires an offline installation of LibreOffice
+or Inkscape; otherwise Windows attempts a 600-DPI raster fallback.
 
 ## Usage
 
@@ -347,6 +375,18 @@ latextify convert paper.docx --journal elsarticle --citation-style authoryear
 # Supplementary material: S-numbered second document sharing the bibliography
 latextify convert paper.docx --journal revtex4-2 --supplement si.docx --pdf
 
+# Main text + supplement in ONE Word file and ONE main.pdf. Put a heading named
+# "Supplementary Material", "Supplementary Information", "Supplemental
+# Material", or "Supporting Information" at the boundary.
+latextify convert merged.docx --journal revtex4-2 --inline-supplement --pdf
+
+# Inline supplements cannot be combined with --figures-at-end: delayed floats
+# would cross the numbering boundary. LaTeXtify rejects that combination.
+# If the merged file contains separate main and supplementary reference lists,
+# LaTeXtify combines them into one bibliography at the end of the PDF. Numeric
+# citation numbering is continuous across the whole document and a warning is
+# written to the conversion report so this policy is never implicit.
+
 # ...and staple the main text + supplement into one combined.pdf
 latextify convert paper.docx --journal revtex4-2 --supplement si.docx --pdf --combine-supplement
 
@@ -366,6 +406,11 @@ latextify figures paper.docx
 # Convert, reporting every figure that is still a screenshot rather than vector
 latextify convert paper.docx --journal revtex4-2 --pdf --vector-figures
 
+# Force selected embedded or external figures to one/two columns. Numbers are
+# document order as shown by `latextify figures`; all others stay automatic.
+latextify convert paper.docx --journal revtex4-2 --pdf \
+  --figure-column 1=one --figure-column 2=two
+
 # A folder of manuscripts at once (continue-on-error + summary)
 latextify batch drafts/ --journal revtex4-2 --pdf
 
@@ -385,9 +430,11 @@ latextify journals
 `127.0.0.1` only — your uploads never leave your machine) and opens a tab.
 Drop your whole submission in at once — **main `.docx`, supplement `.docx`,
 figure files, and a `.bib` reference library together** — then set each
-file's role, pick a journal from the full publisher list, choose options
-(compile PDF, combine supplement, one-column SI, equation audit, project
-`.zip`), and click **Preview**. The compiled PDFs render inline so you can
+file's role, pick a journal from the full publisher list, choose options,
+and click **Preview**. The GUI reads the selected manuscript's figures and
+gives every figure its own **Automatic / 1 column / 2 columns** selector;
+separately uploaded replacements appear under the same document-order number.
+The compiled PDFs render inline so you can
 confirm the conversion worked. A preview is held only in **temporary local
 storage** (a private working directory the app owns) — it is pruned
 automatically about an hour after its last use and deleted when the app shuts
@@ -396,6 +443,21 @@ panel lets you pick a destination folder (a native "Browse…" dialog) and copy
 any subset of the outputs — the LaTeX project, individual PDFs, or the `.zip` —
 to the folder you choose to keep.
 
+For a merged main+supplement Word file, upload it only as **Main text**, do not
+add a separate Supplement file, and choose one **Combined main + supplement
+Word file** layout:
+
+- **Single-column throughout (closest to Word)**
+- **Main two columns; supplement two columns**
+- **Main two columns; supplement one column**
+
+Every combined mode produces one `main.pdf`, starts the recognized
+Supplementary Material/Information heading on a new page, and restarts figures,
+tables, equations, and sections as S1. **Check references online**, **Strip
+figure metadata**, and **Optimize figure placement** are independent toggles.
+The offline launcher disables the online reference check; the other two remain
+available. Manual per-figure column choices override automatic placement.
+
 Output layout per conversion:
 
 ```

{latextify-0.3.0 → latextify-0.3.2}/README.md

@@ -206,8 +206,9 @@ holds real vector for anything drawn:
   Metafile)*. That lands as EMF, which is vector. A plain Ctrl+V usually gives
   you a bitmap.
 - **LaTeXtify converts EMF and WMF to PDF** when LibreOffice or Inkscape is on
-  your PATH. Neither is a dependency — without one, the figure is skipped and
-  the warning names the fix.
+  your PATH or in its usual Windows install directory. If neither is available,
+  it tries a 600-DPI PNG fallback and warns that the result is no longer vector;
+  a metafile it cannot safely decode is skipped with an actionable warning.
 - **Export from the plotting tool.** Saving directly to PDF or SVG and dropping
   it in as `figures/fig<N>.pdf` skips Word entirely and is the most reliable
   route.
@@ -284,7 +285,34 @@ To start the web GUI without touching a command line, double-click
 **`startup.bat`** (Windows) or run **`./startup.sh`** (macOS/Linux). It installs
 dependencies on first run, opens the GUI in your browser, and — if anything
 goes wrong — writes an easy-to-find `latextify-startup.log` next to the script
-and prints it for you to copy.
+and prints it for you to copy. This source-tree launcher needs internet access
+on its first run.
+
+### Offline / firewalled Windows computer
+
+Do not transfer GitHub's automatically generated source-code ZIP or
+`latextify-source.zip`: their `startup.bat` must fetch `uv` and Python packages.
+For a locked-down work computer, download the release asset named
+**`LaTeXtify-Windows-Portable.zip`**, transfer it using an approved method,
+extract the whole folder to a short writable path such as `C:\LaTeXtify`, and
+double-click **`LaTeXtify.exe`**. It carries its own Python runtime, GUI,
+Pandoc, Tectonic, and warmed TeX cache. It performs no installation and needs
+no administrator rights, Python, `uv`, `pip`, GitHub, Astral, or PyPI access.
+
+The older **`latextify-offline-windows-x64.zip`** remains available for users
+who prefer a conventional, inspectable Python environment. It requires a
+supported 64-bit Python already present. Extract it and run:
+
+```bat
+py install.py
+```
+
+Then double-click **`Start-LaTeXtify-GUI.bat`**. That offline package contains
+the GUI, Pandoc, Tectonic, dependencies, and a warmed TeX cache; it does not
+contact GitHub, Astral, PyPI, or Crossref. It requires a supported 64-bit
+Python already present on the work computer. Embedded EMF/WMF figures work,
+but preserving them as vectors requires an offline installation of LibreOffice
+or Inkscape; otherwise Windows attempts a 600-DPI raster fallback.
 
 ## Usage
 
@@ -301,6 +329,18 @@ latextify convert paper.docx --journal elsarticle --citation-style authoryear
 # Supplementary material: S-numbered second document sharing the bibliography
 latextify convert paper.docx --journal revtex4-2 --supplement si.docx --pdf
 
+# Main text + supplement in ONE Word file and ONE main.pdf. Put a heading named
+# "Supplementary Material", "Supplementary Information", "Supplemental
+# Material", or "Supporting Information" at the boundary.
+latextify convert merged.docx --journal revtex4-2 --inline-supplement --pdf
+
+# Inline supplements cannot be combined with --figures-at-end: delayed floats
+# would cross the numbering boundary. LaTeXtify rejects that combination.
+# If the merged file contains separate main and supplementary reference lists,
+# LaTeXtify combines them into one bibliography at the end of the PDF. Numeric
+# citation numbering is continuous across the whole document and a warning is
+# written to the conversion report so this policy is never implicit.
+
 # ...and staple the main text + supplement into one combined.pdf
 latextify convert paper.docx --journal revtex4-2 --supplement si.docx --pdf --combine-supplement
 
@@ -320,6 +360,11 @@ latextify figures paper.docx
 # Convert, reporting every figure that is still a screenshot rather than vector
 latextify convert paper.docx --journal revtex4-2 --pdf --vector-figures
 
+# Force selected embedded or external figures to one/two columns. Numbers are
+# document order as shown by `latextify figures`; all others stay automatic.
+latextify convert paper.docx --journal revtex4-2 --pdf \
+  --figure-column 1=one --figure-column 2=two
+
 # A folder of manuscripts at once (continue-on-error + summary)
 latextify batch drafts/ --journal revtex4-2 --pdf
 
@@ -339,9 +384,11 @@ latextify journals
 `127.0.0.1` only — your uploads never leave your machine) and opens a tab.
 Drop your whole submission in at once — **main `.docx`, supplement `.docx`,
 figure files, and a `.bib` reference library together** — then set each
-file's role, pick a journal from the full publisher list, choose options
-(compile PDF, combine supplement, one-column SI, equation audit, project
-`.zip`), and click **Preview**. The compiled PDFs render inline so you can
+file's role, pick a journal from the full publisher list, choose options,
+and click **Preview**. The GUI reads the selected manuscript's figures and
+gives every figure its own **Automatic / 1 column / 2 columns** selector;
+separately uploaded replacements appear under the same document-order number.
+The compiled PDFs render inline so you can
 confirm the conversion worked. A preview is held only in **temporary local
 storage** (a private working directory the app owns) — it is pruned
 automatically about an hour after its last use and deleted when the app shuts
@@ -350,6 +397,21 @@ panel lets you pick a destination folder (a native "Browse…" dialog) and copy
 any subset of the outputs — the LaTeX project, individual PDFs, or the `.zip` —
 to the folder you choose to keep.
 
+For a merged main+supplement Word file, upload it only as **Main text**, do not
+add a separate Supplement file, and choose one **Combined main + supplement
+Word file** layout:
+
+- **Single-column throughout (closest to Word)**
+- **Main two columns; supplement two columns**
+- **Main two columns; supplement one column**
+
+Every combined mode produces one `main.pdf`, starts the recognized
+Supplementary Material/Information heading on a new page, and restarts figures,
+tables, equations, and sections as S1. **Check references online**, **Strip
+figure metadata**, and **Optimize figure placement** are independent toggles.
+The offline launcher disables the online reference check; the other two remain
+available. Manual per-figure column choices override automatic placement.
+
 Output layout per conversion:
 
 ```

{latextify-0.3.0 → latextify-0.3.2}/latextify/citations/body_markers.py

@@ -235,12 +235,21 @@ def strip_reference_section_to_eof(tex: str) -> str:
     (:mod:`latextify.emit.project`) strips the reference manager's own
     formatted bibliography, which duplicates the generated ``\\bibliography``.
     """
+
+    def cut(start: int) -> str:
+        # A merged main+SI manuscript can put its main reference list before
+        # the supplementary heading. Preserve that protected tail rather than
+        # applying the historical "references are always EOF" assumption.
+        marker = tex.find("%%LATEXTIFY_INLINE_SUPPLEMENT%%", start)
+        tail = strip_reference_section_to_eof(tex[marker:]) if marker >= 0 else ""
+        return tex[:start].rstrip() + "\n" + tail
+
     for match in _REF_SECTION_RE.finditer(tex):
         if is_reference_heading_text(match.group(1).strip()):
-            return tex[: match.start()].rstrip() + "\n"
+            return cut(match.start())
     offset = _find_bare_reference_heading(tex)
     if offset is not None:
-        return tex[:offset].rstrip() + "\n"
+        return cut(offset)
     return tex
 
 

{latextify-0.3.0 → latextify-0.3.2}/latextify/citations/crossref.py

@@ -56,6 +56,7 @@ from .bib import csl_type_to_bibtex
 #: Placeholder contact address; override with a real one in production use.
 DEFAULT_MAILTO = "latextify@example.com"
 _MAILTO_ENV = "LATEXTIFY_CROSSREF_MAILTO"
+_OFFLINE_ENV = "LATEXTIFY_OFFLINE"
 
 DEFAULT_BASE_URL = "https://api.crossref.org"
 _USER_AGENT_PRODUCT = "LaTeXtify/0.1 (https://github.com/latextify/latextify)"
@@ -313,6 +314,8 @@ class CrossrefClient:
         consecutive calls have failed, further calls raise immediately so a
         full outage costs a few timeouts, not one per remaining reference.
         """
+        if os.environ.get(_OFFLINE_ENV, "").lower() in {"1", "true", "yes"}:
+            raise CrossrefUnavailable("Crossref disabled by LATEXTIFY_OFFLINE")
         if self._consecutive_failures >= _BREAKER_THRESHOLD:
             raise CrossrefUnavailable(
                 f"skipped after {self._consecutive_failures} consecutive Crossref failures"

{latextify-0.3.0 → latextify-0.3.2}/latextify/citations/plaintext.py

@@ -113,6 +113,12 @@ def is_reference_heading_text(text: str) -> bool:
     return _is_heading_paragraph(text)
 
 
+_SUPPLEMENT_HEADING_RE = re.compile(
+    r"^(?:supplement(?:ary|al)?\s+(?:material|information)|supporting\s+information)\s*:?$",
+    re.IGNORECASE,
+)
+
+
 def _has_list_numbering(paragraph) -> bool:
     """True when a paragraph carries real Word list numbering (``w:numPr``).
 
@@ -139,6 +145,7 @@ class ReferenceList:
 
     heading: str | None
     references: list[ReferenceItem] = field(default_factory=list)
+    supplement: bool = False
 
     @property
     def found(self) -> bool:
@@ -155,46 +162,57 @@ def segment_reference_list(docx_path: Path | str) -> ReferenceList:
     ``word/document.xml`` to read) dispatches to
     :mod:`latextify.citations.reflist_nondocx` instead.
     """
+    lists = segment_reference_lists(docx_path)
+    return lists[0] if lists else ReferenceList(heading=None)
+
+
+def segment_reference_lists(docx_path: Path | str) -> tuple[ReferenceList, ...]:
+    """Return each typed reference list, tagged as main or supplementary."""
     if not is_docx(docx_path):
         from .reflist_nondocx import segment_reference_list_from_manuscript
 
-        return segment_reference_list_from_manuscript(Path(docx_path))
+        found = segment_reference_list_from_manuscript(Path(docx_path))
+        return (found,) if found.heading is not None else ()
     root = etree.fromstring(read_document_xml(docx_path))
     paragraphs = list(root.iter(_q("p")))
-
-    heading_index: int | None = None
-    heading_text: str | None = None
-    for index, paragraph in enumerate(paragraphs):
-        text = _paragraph_text(paragraph)
-        if _is_heading_paragraph(text):
-            heading_index = index
-            heading_text = text.strip().rstrip(":").strip()
-            break
-
-    if heading_index is None:
-        return ReferenceList(heading=None)
-
-    references: list[ReferenceItem] = []
-    auto_number = 0
-    for paragraph in paragraphs[heading_index + 1 :]:
-        text = _paragraph_text(paragraph).strip()
-        if not text:
-            continue
-        match = _LIST_NUMBER_RE.match(text)
-        if match:
-            number = int(match.group("br") or match.group("pr") or match.group("dot"))
-            body = text[match.end() :].strip()
-            references.append(ReferenceItem(text=body, number=number))
-        elif _has_list_numbering(paragraph):
-            # Word's own auto-numbering: no typed digits to parse, so assign
-            # sequential numbers in document order (a fresh Word list always
-            # starts at 1 and increments by 1, matching what the reader sees).
-            auto_number += 1
-            references.append(ReferenceItem(text=text, number=auto_number))
-        else:
-            references.append(ReferenceItem(text=text, number=None))
-
-    return ReferenceList(heading=heading_text, references=references)
+    texts = [_paragraph_text(paragraph).strip() for paragraph in paragraphs]
+    supplement_at = next(
+        (index for index, text in enumerate(texts) if _SUPPLEMENT_HEADING_RE.match(text)), None
+    )
+    headings = [index for index, text in enumerate(texts) if _is_heading_paragraph(text)]
+    lists: list[ReferenceList] = []
+    for position, heading_index in enumerate(headings):
+        stops = [len(paragraphs)]
+        if position + 1 < len(headings):
+            stops.append(headings[position + 1])
+        if supplement_at is not None and heading_index < supplement_at:
+            stops.append(supplement_at)
+        references: list[ReferenceItem] = []
+        auto_number = 0
+        for paragraph, text in zip(
+            paragraphs[heading_index + 1 : min(stops)],
+            texts[heading_index + 1 : min(stops)],
+            strict=True,
+        ):
+            if not text:
+                continue
+            match = _LIST_NUMBER_RE.match(text)
+            if match:
+                number = int(match.group("br") or match.group("pr") or match.group("dot"))
+                references.append(ReferenceItem(text=text[match.end() :].strip(), number=number))
+            elif _has_list_numbering(paragraph):
+                auto_number += 1
+                references.append(ReferenceItem(text=text, number=auto_number))
+            else:
+                references.append(ReferenceItem(text=text, number=None))
+        lists.append(
+            ReferenceList(
+                heading=texts[heading_index].rstrip(":").strip(),
+                references=references,
+                supplement=supplement_at is not None and heading_index > supplement_at,
+            )
+        )
+    return tuple(lists)
 
 
 # --- reconstruction ----------------------------------------------------------
@@ -217,6 +235,7 @@ class PlaintextResult:
     author_year_keys: dict[tuple[str, str], list[str]] = field(default_factory=dict)
     heading: str | None = None
     has_reference_list: bool = False
+    supplement: bool = False
 
     @property
     def report(self) -> ReconciliationReport:
@@ -256,6 +275,10 @@ def reconstruct_citations(
         if owns_client:
             client.close()
 
+    return _result_from_outcome(reflist, outcome)
+
+
+def _result_from_outcome(reflist: ReferenceList, outcome) -> PlaintextResult:
     keys_by_number = {
         record.ref_number: record.key for record in outcome.records if record.ref_number is not None
     }
@@ -266,4 +289,33 @@ def reconstruct_citations(
         author_year_keys=build_author_year_index(outcome.entries),
         heading=reflist.heading,
         has_reference_list=True,
+        supplement=reflist.supplement,
     )
+
+
+def reconstruct_citation_lists(
+    docx_path: Path | str,
+    *,
+    mailto: str | None = None,
+    threshold: float = reconcile.DEFAULT_THRESHOLD,
+    client: crossref.CrossrefClient | None = None,
+    bib_entries: list[RefEntry] | None = None,
+) -> tuple[PlaintextResult, ...]:
+    """Reconstruct every typed reference list in a merged main+SI manuscript."""
+    reflists = tuple(item for item in segment_reference_lists(docx_path) if item.found)
+    if not reflists:
+        return ()
+    owns_client = client is None
+    if client is None:
+        client = crossref.CrossrefClient(mailto=mailto)
+    results: list[PlaintextResult] = []
+    try:
+        for reflist in reflists:
+            outcome = reconcile.reconcile_references(
+                reflist.references, client, threshold=threshold, bib_entries=bib_entries
+            )
+            results.append(_result_from_outcome(reflist, outcome))
+    finally:
+        if owns_client:
+            client.close()
+    return tuple(results)