Skip to content

Releases: zeyuyang42/ByeTex

ByeTex v0.7.3 — TikZ placeholders, convert purity, honest install paths

Choose a tag to compare

@zeyuyang42 zeyuyang42 released this 26 Jul 17:43
20172e2

First release since v0.6.29. Everything from 0.6.30 → 0.7.3 was previously unreleased — including several fixes that broke whole documents.

Fixed since v0.6.29

Silent data loss

  • TikZ pictures were dropped with no placeholder and no warning (warnings.json came back []). They now leave a marked placeholder and a tikz warning that routes to the byetex-tikz-to-typst skill.
  • Multi-file projects lost most of their body. The pre-parse guard for _ in \label/\ref keys ran only on the entry file, so every \inputed file still hit the tree-sitter parse cascade — the exact layout --project mode exists for.
  • Converting a file read every other .tex in its directory, injecting unrelated projects' label keys as hidden anchors and making output depend on neighbouring files.

Crashes and uncompilable output

  • A non-ASCII \verb delimiter (\verb§…§) panicked the whole conversion — exit 1, no output.
  • A repeated \bibliography{} emitted two #bibliography(…) calls, which Typst rejects outright: the generated project could not compile at all.
  • A .bib registered twice was materialised empty, breaking every citation.

Fidelity

  • Table rules are drawn where the LaTeX declares them. Mid-table \midrule group separators used to collapse into one — one corpus paper declares 91 rules and got 45.
  • \cmidrule no longer draws a spurious full-width line through the header, and \cmidrule{a-b} without a trim prefix now produces a rule at all.
  • Symlinked directories, entry-file detection in repos with several \documentclass files, \multirow placeholder rows, and more — see CHANGELOG.md.

Archives

Each archive bundles the byetex binary and the 14 repair skills (skills/<name>/SKILL.md) — the previous release shipped only the binary. Verify against SHA256SUMS.

macOS arm64/x86_64 · Linux musl arm64/x86_64 · Windows x86_64 (gnu)

curl -fsSL https://raw.githubusercontent.com/zeyuyang42/ByeTex/main/install.sh | sh

cargo install byetex and brew install are not available — neither was ever published, and both have been removed from the docs. Build from source with cargo install --git https://github.com/zeyuyang42/ByeTex byetex.

ByeTex v0.6.29 — beamer presentation fidelity

Choose a tag to compare

@zeyuyang42 zeyuyang42 released this 25 Jun 16:08
b185643

A beamer-fidelity release (everything since v0.6.6), driven by a vision-based visual grader scoring each converted deck against its LaTeX truth render. The metropolis demo deck went from 11 pages (raw-LaTeX leaks, orange theme) to 15 pages — matching the truth exactly — with the deck's real teal accent.

Highlights

  • Beamer slide structure — metropolis \sections now render their section-divider slides, \begin{frame}[standout] becomes a touying #focus-slide (dark focus slide), and a titleless \begin{frame} is its own slide instead of merging onto the previous one.
  • Beamer theme colour — a deck's accent set via \setbeamercolor{alerted text} (or structure) now drives touying's primary (progress bar / section rule / \alert), resolved even through an \inputed colour file.
  • Raw-LaTeX leaks fixed\usetheme[opts]{name}, \institute[short]{…} + \inst{N} markers, the \color{name} switch form, and nested \texttt{\textit{…}} no longer leak source text onto slides; \begin{verbatim} renders as a #raw block instead of being dropped; the beamer \appendix heading no longer shows a degenerate -.1.
  • Corpus — four presentation decks added (three metropolis + one Madrid/default theme), each truth-rendered, measured, and gated in the fidelity baseline.

Eleven visual-grader findings fixed in total; corpus fidelity 0.827 → 0.834.

Install

Download the asset for your platform below, extract, and put byetex on your PATH. Verify against SHA256SUMS.

See the CHANGELOG for the full per-version detail (0.6.7–0.6.29).

🤖 Generated with Claude Code

ByeTex v0.6.6 — touying beamer + thesis fidelity

Choose a tag to compare

@zeyuyang42 zeyuyang42 released this 24 Jun 10:07

A fidelity-driven release (everything since v0.5.20), with every fix grounded against a reproducible truth render of the source LaTeX.

Highlights

  • Beamer → real Typst touying presentations (metropolis theme): dark header bar + footer/slide-number chrome, \section dividers gated on \AtBeginSection, detected theme colors, and incremental overlay builds (\pause / \item<n-> / \only<n>).
  • Thesis/report fidelity — generic cover page for \coverimage/\makecover, and chapter-per-page density (each \chapter starts a fresh page; tudelft thesis 6 → 10 pages).
  • Paper fidelity — ACL title size + reworked ACL author block (institutions kept, \thanks/\footnotemark no longer leaking).
  • Math — a comma in \overset/\stackrel over-text no longer breaks Typst attach (closed an acceptance blind spot).
  • Truth-render pipelinescripts/setup_truth_deps.sh provisions a version-matched biber + fonts; corpus ingestion now gates on a successful truth render.

See CHANGELOG.md for the full list.

Install

Download the archive for your platform below, extract, and put byetex on your PATH. Verify with shasum -a 256 -c SHA256SUMS.

Targets: macOS (arm64/x86_64), Linux musl (arm64/x86_64, static), Windows (x86_64).

ByeTex v0.5.20 — beamer + book/thesis support

Choose a tag to compare

@zeyuyang42 zeyuyang42 released this 21 Jun 22:26
278f9ae

First release since v0.3.0 — bundles all the 0.4.x/0.5.x work. Built locally (5 targets).

Highlights

  • Beamer presentation support — a LaTeX beamer deck → Typst slides: frames (one page each), columns→grid, blocks→titled #block, the title slide, overlays collapsed, per-deck theme colors (detected, not hard-coded), 4:3 / 16:9 geometry.
  • Book/report/thesis support — chapter/section heading hierarchy, \tableofcontents#outline, \frontmatter/\mainmatter page numbering, longtable#table, \subtitle, \appendix lettering, isolated \begin{titlepage}.
  • Agent surfacediagnose <.typ> leaked-LaTeX scan, a warnings.json sidecar from diagnose --project, and new byetex-beamer / byetex-book skills (15 skills total).
  • Many converter fixes — author-block leaks, counter/label underscore leaks, inner-math, and more.

See CHANGELOG.md for the full per-version detail.

Install

Download the archive for your platform below, extract, and put byetex on your PATH. Verify with shasum -a 256 -c SHA256SUMS.

ByeTex v0.3.0 — Agent in the loop

Choose a tag to compare

@zeyuyang42 zeyuyang42 released this 15 Jun 09:11
d01acb5

ByeTex v0.3.0 — Agent in the loop

ByeTex converts LaTeX to Typst for AI agents. v0.3.0 is the "agent in the loop" release:
the MCP server grows from 7 to 11 tools, the visual-fidelity loop becomes one command,
and ByeTex now installs as a Claude Code plugin (plus an install script, crates.io, and Homebrew).

Highlights

11 MCP tools (was 7) — with full CLI parity

  • validate — Stage-0 oracle: compile the input LaTeX with tectonic to tell a broken
    source from a ByeTex bug, before you start repairing.
  • compile / rendertypst compile to PDF / per-page PNGs with structured
    errors ({ok, errors, …}) — no more shelling out to typst and scraping stderr.
  • explain — a per-node LaTeX→Typst map: "why did this LaTeX emit this Typst?"
  • convert_fragment now honours its context_hint (math hints wrap the fragment so bare
    math like \frac{1}{2} converts as math, not an unknown text command).

One-command visual-fidelity loop

  • byetex review <paper> renders the converted Typst to per-page PNGs and rasterises the
    original LaTeX render alongside, emitting a grading_packet.json for the
    byetex-visual-grading skill.
  • A two-layer fidelity regression gate: deterministic structural metrics
    (scripts/fidelity_gate.sh) + a vision-graded findings diff (scripts/findings_diff.py).

Reproducible snippet primitives

  • byetex convert -c '\frac12' (or - for stdin) — convert a snippet to stdout, no files.
  • byetex explain -c '…' — the source map for any fragment.

Installs four ways

# Claude Code plugin (skills + MCP server)
claude plugin marketplace add zeyuyang42/ByeTex && claude plugin install byetex@byetex
# Prebuilt binary
curl -fsSL https://raw.githubusercontent.com/zeyuyang42/ByeTex/main/install.sh | sh
# crates.io
cargo install byetex --features mcp
# Homebrew
brew install zeyuyang42/byetex/byetex

Status

  • Compile-rate (the gate): 59/59 ByeTex-attributable arXiv papers compile (100%).
  • Visual fidelity (the driver): 0.821 corpus composite score.
  • CI runs cargo fmt --check + cargo clippy -D warnings + cargo test --workspace (904 tests).

Notes

  • The CLI crate is now published as byetex (so cargo install byetex works); the binary
    name and the crates/byetex-cli directory are unchanged.
  • No conversion-logic changes in this release — it is entirely new agent tooling, packaging,
    and docs, so the 59/59 compile-rate is preserved.
  • Full changelog: CHANGELOG.md.

Binaries in this release

Prebuilt, statically-linked binaries (built locally), verifiable against SHA256SUMS:

Platform Asset
macOS arm64 byetex-v0.3.0-aarch64-apple-darwin.tar.gz
macOS x86_64 byetex-v0.3.0-x86_64-apple-darwin.tar.gz
Linux x86_64 (musl) byetex-v0.3.0-x86_64-unknown-linux-musl.tar.gz
Linux arm64 (musl) byetex-v0.3.0-aarch64-unknown-linux-musl.tar.gz
Windows x86_64 byetex-v0.3.0-x86_64-pc-windows-gnu.zip

The Windows build is the GNU ABI (x86_64-pc-windows-gnu, cross-built via Zig with a static
CRT — imports only Windows system DLLs, no MinGW runtime needed), not MSVC. It runs on Windows
10/11; for a native MSVC build use cargo install byetex or build from source on Windows.

Full Changelog: v0.2.0...v0.3.0