texsmith 0.2.1.dev0__tar.gz → 0.2.2__tar.gz

{texsmith-0.2.1.dev0 → texsmith-0.2.2}/.github/workflows/ci.yml

@@ -21,6 +21,7 @@ jobs:
       - name: Install uv
         uses: astral-sh/setup-uv@v7
         with:
+          version: "0.9.18"
           enable-cache: true
           cache-python: false
         env:
@@ -55,6 +56,7 @@ jobs:
       - name: Install uv
         uses: astral-sh/setup-uv@v7
         with:
+          version: "0.9.18"
           enable-cache: true
           cache-python: false
         env:
@@ -65,7 +67,7 @@ jobs:
 
       - name: Install Cairo (macOS)
         if: runner.os == 'macOS'
-        run: brew install cairo
+        run: brew list cairo >/dev/null 2>&1 || brew install cairo
 
       - name: Run pytest
         run: uv run pytest
@@ -92,6 +94,7 @@ jobs:
       - name: Install uv
         uses: astral-sh/setup-uv@v7
         with:
+          version: "0.9.18"
           enable-cache: true
           cache-python: false
         env:
@@ -128,6 +131,7 @@ jobs:
       # Install system dependencies (Playwright, cairo, etc.)
       - name: Install system dependencies
         run: |
+          sudo apt-get update
           sudo apt-get install -y libglib2.0-0 libnspr4 libnss3 libatk1.0-0 \
           libatk-bridge2.0-0 libcups2 libxkbcommon0 libatspi2.0-0 libxcomposite1 \
           libxdamage1 libxfixes3 libxrandr2 libgbm1 libcairo2 libpango-1.0-0
@@ -136,6 +140,7 @@ jobs:
       - name: Install uv
         uses: astral-sh/setup-uv@v7
         with:
+          version: "0.9.18"
           enable-cache: true
           cache-python: false
 
@@ -149,6 +154,21 @@ jobs:
           uv run playwright install-deps
           uv run playwright install chromium
 
+      # Build the main Python package distribution before docs/examples touch the repo
+      - name: Build distributions (texsmith)
+        run: uv build
+
+      # Build the MkDocs plugin distribution before docs/examples touch the repo
+      - name: Build distributions (mkdocs_texsmith)
+        working-directory: packages/mkdocs_texsmith
+        run: uv build
+
+      # Ensure no generated artifacts pollute the version calculation
+      - name: Verify clean git state
+        run: |
+          git status --porcelain
+          test -z "$(git status --porcelain)"
+
       # Build all examples (clean + all)
       - name: Build examples
         run: |
@@ -165,15 +185,6 @@ jobs:
         run: |
           make docs
 
-      # Build the main Python package distribution
-      - name: Build distributions (texsmith)
-        run: uv build
-
-      # Build the MkDocs plugin distribution
-      - name: Build distributions (mkdocs_texsmith)
-        working-directory: packages/mkdocs_texsmith
-        run: uv build
-
       # Upload all artifacts needed for the release job
       - name: Upload release artifacts
         uses: actions/upload-artifact@v4
@@ -242,6 +253,7 @@ jobs:
       - name: Install uv
         uses: astral-sh/setup-uv@v7
         with:
+          version: "0.9.18"
           enable-cache: true
           cache-python: false
         env:

texsmith-0.2.2/.wiki/README.md

@@ -0,0 +1,20 @@
+# Cached Wikipedia images
+
+This folder contains locally cached copies of Wikipedia images used in the examples.
+
+Why this exists:
+
+- CI (especially Windows) occasionally hits HTTP 429 rate limits when fetching directly from `upload.wikimedia.org`.
+- Keeping a local copy makes the examples deterministic and prevents flaky builds.
+
+How it works:
+
+- The Markdown examples still reference HTTP URLs, but we point them to the repo via
+  `https://raw.githubusercontent.com/yves-chevallier/texsmith/refs/heads/master/.wiki/...`.
+- This preserves the HTTP fetch path in the renderer while avoiding third‑party rate limits.
+
+If you need to add new images:
+
+1. Download the file from Wikipedia (or another source with a compatible license).
+2. Place it in this folder using a stable filename.
+3. Update the example markdown to reference the raw GitHub URL.

{texsmith-0.2.1.dev0 → texsmith-0.2.2}/CHANGELOG.md

@@ -7,26 +7,33 @@ and the project follows [Semantic Versioning](https://semver.org/spec/v2.0.0.htm
 
 ## [Unreleased]
 
-### Changed
+### Added
+
+- Nothing yet.
 
-- Collapsed conversion settings to a single `ConversionRequest` model (removed `RenderSettings`).
-- Folded document render options and slot tracking into `Document` for a single SSOT.
-- Simplified template options handling to use plain mappings in `TemplateSession`.
-- Bumped the minimum PyXindy dependency to `0.0.6`.
-- Expanded CI to test on Windows and macOS, and added a Windows examples build job.
+## [0.2.2] - 2026-02-24
 
 ### Added
 
-- Documented the `--legacy-latex-accents` CLI flag and its API equivalent via `ConversionRequest`.
+- CLI/API version reporting (`texsmith --version`, `get_version()`).
+- Configurable HTTP user agent for remote asset and emoji fetching (`--http-user-agent` / `TEXSMITH_HTTP_USER_AGENT`).
+- TLS download helper with cert guidance for network fetches.
+- Cached Wikipedia images for the book example under `.wiki/` with documentation.
+
+### Changed
+
+- Horizontal rules now force a page break in LaTeX output.
+- Asset summaries hide temporary build roots and `.converted` cache files.
+- Letter example no longer hard-codes the format, allowing snippet overrides; docs include local build steps.
+- Book example images now resolve via raw GitHub URLs to avoid third‑party rate limits.
+- CI now runs `apt-get update` before installing system dependencies.
 
 ### Fixed
 
-- Use the bundled `biber` path when invoking bibliography builds to fix Windows CI failures.
-- Make placeholder PDFs valid so Tectonic can include them when SVG conversion fails.
-- Add a Playwright fallback for SVG-to-PDF conversion when Cairo isn't available.
-- Try multiple Biber download names on macOS arm64 to avoid 404s on the CI runners.
-- Honor the diagrams backend when converting letter signature SVG assets.
-- Avoid markdown-escaping letter `source_dir` so Windows paths resolve correctly.
+- Playwright SVG conversion now handles `viewBox`-only SVGs to prevent blank PDFs.
+- Suppressed noisy Tectonic `lineno` UTF‑8 warnings and made console output encoding-safe.
+- XeTeX fallback transitions no longer leak across scripts; arrow glyphs prefer Noto Sans Symbols.
+- Convert common Unicode symbols to LaTeX math macros to avoid missing glyphs.
 
 ## [0.1.0] - 2025-12-20
 

{texsmith-0.2.1.dev0 → texsmith-0.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: texsmith
-Version: 0.2.1.dev0
+Version: 0.2.2
 Summary: A Markdown to LaTeX converter.
 Project-URL: Homepage, https://github.com/yves-chevallier/texsmith
 Author-email: Yves Chevallier <yves.chevalier@heig-vd.ch>
@@ -57,7 +57,8 @@ Description-Content-Type: text/markdown
 TeXSmith is a [Python](https://www.python.org/) package and CLI tool to convert **Markdown** or **HTML** documents into LaTeX format. It is designed to be extensible via templates and integrates with [MkDocs](https://www.mkdocs.org/) for generating printable documents from documentation sites.
 
 <p align="center">
-<img src="docs/assets/ts-logo.svg" width="70%" />
+<!-- Absolute link for compatibility with PyPi -->
+<img src="https://raw.githubusercontent.com/yves-chevallier/texsmith/master/docs/assets/ts-logo.svg" width="70%" />
 </p>
 
 ## TL;DR
@@ -67,6 +68,8 @@ pip install texsmith
 texsmith input.md input.bib -o build/ --build
 ```
 
+Check the installed version with `texsmith --version` or in Python with `texsmith.get_version()`.
+
 ## Key features
 
 - **MkDocs-native Markdown** – Ships with the same Material + pymdown extension stack you use in MkDocs, so tabs, callouts, annotations, tooltips, and data tables survive the conversion.

{texsmith-0.2.1.dev0 → texsmith-0.2.2}/README.md

@@ -14,7 +14,8 @@
 TeXSmith is a [Python](https://www.python.org/) package and CLI tool to convert **Markdown** or **HTML** documents into LaTeX format. It is designed to be extensible via templates and integrates with [MkDocs](https://www.mkdocs.org/) for generating printable documents from documentation sites.
 
 <p align="center">
-<img src="docs/assets/ts-logo.svg" width="70%" />
+<!-- Absolute link for compatibility with PyPi -->
+<img src="https://raw.githubusercontent.com/yves-chevallier/texsmith/master/docs/assets/ts-logo.svg" width="70%" />
 </p>
 
 ## TL;DR
@@ -24,6 +25,8 @@ pip install texsmith
 texsmith input.md input.bib -o build/ --build
 ```
 
+Check the installed version with `texsmith --version` or in Python with `texsmith.get_version()`.
+
 ## Key features
 
 - **MkDocs-native Markdown** – Ships with the same Material + pymdown extension stack you use in MkDocs, so tabs, callouts, annotations, tooltips, and data tables survive the conversion.

{texsmith-0.2.1.dev0 → texsmith-0.2.2}/docs/cli/index.md

@@ -134,6 +134,9 @@ $ texsmith --help
 `--hash-assets`
 : Hash the filenames of stored assets instead of preserving their original names. This helps avoid filename collisions when multiple assets with the same name are used in different documents.
 
+`--http-user-agent`
+: Override the User-Agent header used when fetching remote assets (images, emoji). You can also set `TEXSMITH_HTTP_USER_AGENT` in the environment.
+
 `--manifest`, `-m`
 : Generate a `manifest.json` file alongside the LaTeX output, containing metadata about the rendered document, including input sources, template details, and rendering options.
 

{texsmith-0.2.1.dev0 → texsmith-0.2.2}/docs/examples/letters.md

@@ -98,3 +98,15 @@ The former French AFNOR standard **NF Z 11-001**, replaced by ISO 269 back in 19
 While our documentation already covers the underlying standards that govern letter layout, what actually matters in practice is finding a tool that can embody these rules with precision, consistency, and a healthy respect for typographic sanity. This is the point where LaTeX—and specifically KOMA-Script’s `scrlttr2`—quietly distinguishes itself from the rest. Designed in the German tradition of rigorous typesetting, `scrlttr2` follows the logic of formal letter standards with an almost pedantic accuracy, offering a layout engine that behaves predictably and stays faithful to the structural constraints imposed by modern correspondence norms. Yet it remains flexible enough to emulate the conventions of other national styles without falling apart or requiring awkward hacks.
 
 In short, choosing `scrlttr2` was less about tradition and more about engineering. It gives us a letter typesetting engine that is standards-aware, robust enough for large-scale automation, and structured enough to keep our layouts consistent across contexts. It is not the easiest tool, nor the most forgiving, but for anyone who values correctness, longevity, and the quiet satisfaction of seeing a letter snap perfectly into place, it is simply the right one.
+
+## Build the exemple locally
+
+To build the letter example locally, navigate to the `examples/letter` directory and run the following command:
+
+```bash
+git clone https://github.com/yves-chevallier/texsmith.git
+cd texsmith
+uv sync
+cd examples/letter
+make
+```

{texsmith-0.2.1.dev0 → texsmith-0.2.2}/docs/syntax/supported.md

@@ -35,8 +35,9 @@ Horizontal rules:
 
 All standard Markdown constructs—headings, emphasis, lists, code blocks,
 blockquotes, links, images, and horizontal rules—render exactly as you would
-expect. TeXSmith relies on fenced code blocks by default, so triple backticks
-(```` ``) are the recommended way to author code samples.
+expect. In LaTeX output, horizontal rules become `\clearpage` page breaks rather
+than a literal line. TeXSmith relies on fenced code blocks by default, so triple
+backticks (```` ``) are the recommended way to author code samples.
 
 ## Extension Cheat Sheet
 

{texsmith-0.2.1.dev0 → texsmith-0.2.2}/src/texsmith/__init__.py

@@ -2,8 +2,6 @@
 
 from __future__ import annotations
 
-from importlib.metadata import PackageNotFoundError, version as _pkg_version
-
 from texsmith.core.bibliography import (
     BibliographyCollection,
     BibliographyIssue,
@@ -50,12 +48,10 @@ from texsmith.core.user_dir import (
     get_user_dir,
     user_dir_context,
 )
+from texsmith.version import get_version
 
 
-try:
-    __version__ = _pkg_version("texsmith")
-except PackageNotFoundError:
-    __version__ = "0.0.0"
+__version__ = get_version()
 
 __all__ = [
     "DEFAULT_TEMPLATE_LANGUAGE",
@@ -94,6 +90,7 @@ __all__ = [
     "copy_template_assets",
     "get_template",
     "get_user_dir",
+    "get_version",
     "load_template",
     "load_template_runtime",
     "renders",

{texsmith-0.2.1.dev0 → texsmith-0.2.2}/src/texsmith/adapters/handlers/_assets.py

@@ -57,6 +57,15 @@ _PLACEHOLDER_PDF = (
 )
 
 
+def _resolve_http_user_agent(context: RenderContext) -> str | None:
+    candidate = context.runtime.get("http_user_agent")
+    if isinstance(candidate, str):
+        candidate = candidate.strip()
+        if candidate:
+            return candidate
+    return None
+
+
 def store_local_image_asset(context: RenderContext, resolved: Path) -> Path:
     """Copy or convert a local asset and register it on the context."""
     asset_key = str(resolved)
@@ -135,6 +144,9 @@ def store_remote_image_asset(context: RenderContext, url: str) -> Path:
         "manifest_dirty": manifest_dirty,
         "emitter": emitter,
     }
+    user_agent = _resolve_http_user_agent(context)
+    if user_agent:
+        fetch_options["user_agent"] = user_agent
     if convert_requested:
         fetch_options["output_suffix"] = ".pdf"
     elif suffix_hint:

{texsmith-0.2.1.dev0 → texsmith-0.2.2}/src/texsmith/adapters/handlers/inline.py

@@ -293,10 +293,21 @@ def _emoji_twemoji_url(token: str) -> str:
     return f"https://twemoji.maxcdn.com/v/latest/svg/{codepoints}.svg"
 
 
+def _resolve_http_user_agent(context: RenderContext) -> str | None:
+    candidate = context.runtime.get("http_user_agent")
+    if isinstance(candidate, str):
+        candidate = candidate.strip()
+        if candidate:
+            return candidate
+    return None
+
+
 def _render_emoji(token: str, context: RenderContext) -> str:
     url = _emoji_twemoji_url(token)
     try:
-        artefact = fetch_image(url, output_dir=context.assets.output_root)
+        user_agent = _resolve_http_user_agent(context)
+        options = {"user_agent": user_agent} if user_agent else {}
+        artefact = fetch_image(url, output_dir=context.assets.output_root, **options)
     except TransformerExecutionError as exc:
         warnings.warn(f"Failed to fetch emoji '{token}': {exc}", stacklevel=2)
         legacy = getattr(context.config, "legacy_latex_accents", False)
@@ -700,7 +711,9 @@ def render_twemoji_image(element: Tag, context: RenderContext) -> None:
     if not is_valid_url(src):
         raise InvalidNodeError("Twemoji images must reference remote assets")
 
-    artefact = fetch_image(src, output_dir=context.assets.output_root)
+    user_agent = _resolve_http_user_agent(context)
+    options = {"user_agent": user_agent} if user_agent else {}
+    artefact = fetch_image(src, output_dir=context.assets.output_root, **options)
     stored_path = context.assets.register(src, artefact)
     asset_path = context.assets.latex_path(stored_path)
 

{texsmith-0.2.1.dev0 → texsmith-0.2.2}/src/texsmith/adapters/latex/engines/tectonic/__init__.py

@@ -11,6 +11,15 @@ from rich.console import Console
 from ..latex import LatexStreamResult
 
 
+_SUPPRESSED_WARNINGS = (
+    "warning: lineno.sty:296: Invalid UTF-8 byte or sequence at line 296 replaced by U+FFFD",
+)
+
+
+def _should_suppress(line: str) -> bool:
+    return any(token in line for token in _SUPPRESSED_WARNINGS)
+
+
 def run_tectonic_engine(
     argv: Sequence[str],
     *,
@@ -19,6 +28,19 @@ def run_tectonic_engine(
     console: Console,
 ) -> LatexStreamResult:
     """Execute a tectonic command, streaming plain output."""
+
+    def _safe_console_print(text: str) -> None:
+        try:
+            console.print(text)
+        except UnicodeEncodeError:
+            stream = getattr(console, "file", None)
+            if stream is None:
+                return
+            encoding = getattr(stream, "encoding", None) or "utf-8"
+            sanitized = text.encode(encoding, errors="replace").decode(encoding, errors="replace")
+            stream.write(f"{sanitized}\n")
+            stream.flush()
+
     with subprocess.Popen(
         argv,
         cwd=str(workdir),
@@ -32,7 +54,9 @@ def run_tectonic_engine(
     ) as process:
         assert process.stdout is not None
         for line in process.stdout:
-            console.print(line.rstrip())
+            if _should_suppress(line):
+                continue
+            _safe_console_print(line.rstrip())
         returncode = process.wait()
 
     return LatexStreamResult(returncode=returncode, messages=[])

texsmith-0.2.2/src/texsmith/adapters/latex/partials/horizontal_rule.tex

@@ -0,0 +1 @@
+\clearpage

{texsmith-0.2.1.dev0 → texsmith-0.2.2}/src/texsmith/adapters/latex/tectonic.py

@@ -12,11 +12,11 @@ import sys
 import tarfile
 import tempfile
 from urllib.error import URLError
-from urllib.request import urlopen
 import zipfile
 
 from rich.console import Console
 
+from texsmith.core.http import open_url
 from texsmith.core.user_dir import get_user_dir
 
 
@@ -218,7 +218,7 @@ def _install_dir() -> Path:
 
 
 def _download_file(url: str, destination: Path) -> None:
-    with urlopen(url) as response, destination.open("wb") as handle:
+    with open_url(url) as response, destination.open("wb") as handle:
         shutil.copyfileobj(response, handle)
 
 

{texsmith-0.2.1.dev0 → texsmith-0.2.2}/src/texsmith/adapters/latex/utils.py

@@ -21,6 +21,21 @@ _BASIC_LATEX_ESCAPE_MAP = {
     "\\": r"\textbackslash{}",
 }
 
+_COMMON_SYMBOL_MAP = {
+    "→": r"\(\rightarrow\)",
+    "←": r"\(\leftarrow\)",
+    "⇒": r"\(\Rightarrow\)",
+    "⇐": r"\(\Leftarrow\)",
+    "≥": r"\(\geq\)",
+    "≤": r"\(\leq\)",
+    "≠": r"\(\neq\)",
+    "≈": r"\(\approx\)",
+    "±": r"\(\pm\)",
+    "×": r"\(\times\)",  # noqa: RUF001
+    "÷": r"\(\div\)",
+    "∞": r"\(\infty\)",
+}
+
 _ACCENT_NEEDS_BRACES_PATTERN = re.compile(
     r"\\([" + re.escape("`'^\"~=\\.Hrvuck") + r"])\s*([A-Za-z])(?!\{)"
 )
@@ -69,6 +84,13 @@ def escape_latex_chars(text: str, *, legacy_accents: bool = False) -> str:
         return "MODIFIER LETTER" in name and ("SMALL" in name or "CAPITAL" in name)
 
     for char in text:
+        replacement = _COMMON_SYMBOL_MAP.get(char)
+        if replacement is not None:
+            if buffer:
+                parts.append(_encode_chunk("".join(buffer)))
+                buffer.clear()
+            parts.append(replacement)
+            continue
         if _should_skip_encoding(char):
             if buffer:
                 parts.append(_encode_chunk("".join(buffer)))

{texsmith-0.2.1.dev0 → texsmith-0.2.2}/src/texsmith/adapters/transformers/strategies.py

@@ -6,12 +6,12 @@ import atexit
 from collections.abc import Callable, Mapping, Sequence
 import contextlib
 from datetime import datetime, timezone
-from importlib import metadata as importlib_metadata
 from io import BytesIO
 import json
 import math
 import os
 from pathlib import Path
+import re
 import shlex
 import shutil
 import subprocess
@@ -20,11 +20,11 @@ import threading
 from threading import Lock, Thread
 from typing import Any, ClassVar, TypeVar
 from urllib.parse import unquote, urlparse
-from urllib.request import urlopen
 import warnings
 
 from texsmith.core.conversion.debug import ensure_emitter, record_event
 from texsmith.core.exceptions import TransformerExecutionError
+from texsmith.core.http import open_url
 from texsmith.core.user_dir import get_user_dir
 
 from ..docker import DockerLimits, VolumeMount, run_container
@@ -125,6 +125,40 @@ def _wrap_playwright_error(exc: Exception, emitter: Any = None) -> TransformerEx
     return TransformerExecutionError(message)
 
 
+def _normalise_svg_for_playwright(svg: str) -> str:
+    """Ensure Playwright has explicit SVG dimensions when width/height are missing."""
+    svg = re.sub(r"^\s*<\?xml[^>]*>\s*", "", svg)
+    match = re.search(r"<svg\b[^>]*>", svg, flags=re.IGNORECASE | re.DOTALL)
+    if not match:
+        return svg
+
+    tag = match.group(0)
+    has_width = re.search(r"\bwidth\s*=", tag, flags=re.IGNORECASE)
+    has_height = re.search(r"\bheight\s*=", tag, flags=re.IGNORECASE)
+    if has_width and has_height:
+        return svg
+
+    viewbox_match = re.search(
+        r"\bviewBox\s*=\s*['\"]([^'\"]+)['\"]",
+        tag,
+        flags=re.IGNORECASE,
+    )
+    if not viewbox_match:
+        return svg
+
+    parts = re.split(r"[\s,]+", viewbox_match.group(1).strip())
+    if len(parts) != 4:
+        return svg
+
+    width, height = parts[2], parts[3]
+    if tag.endswith("/>"):
+        replacement = tag[:-2] + f' width="{width}" height="{height}" />'
+    else:
+        replacement = tag[:-1] + f' width="{width}" height="{height}">'
+
+    return svg[: match.start()] + replacement + svg[match.end() :]
+
+
 def _resolve_cli(names: Sequence[str], hints: Sequence[Path]) -> tuple[str | None, bool]:
     """Return an executable path and whether it was discovered via $PATH."""
     for name in names:
@@ -295,6 +329,7 @@ class SvgToPdfStrategy(CachedConversionStrategy):
         return target
 
     def _svg_to_pdf(self, browser: Any, svg: str, target: Path) -> None:
+        svg = _normalise_svg_for_playwright(svg)
         page = browser.new_page()
         page.set_content(f"<html><body style='margin:0; display:inline-block'>{svg}</body></html>")
         locator = page.locator("svg")
@@ -416,11 +451,7 @@ class FetchImageStrategy(CachedConversionStrategy):
         elif os.getenv("TEXSMITH_HTTP_USER_AGENT"):
             user_agent = os.environ["TEXSMITH_HTTP_USER_AGENT"].strip()
         else:
-            try:
-                version = importlib_metadata.version("texsmith")
-            except importlib_metadata.PackageNotFoundError:
-                version = "unknown"
-            user_agent = f"texsmith/{version}"
+            user_agent = "Mozilla/5.0"
 
         headers = {"User-Agent": user_agent}
 
@@ -1389,7 +1420,7 @@ class DrawioToPdfStrategy(CachedConversionStrategy):
                 export_url = None
                 if not export_page.exists():
                     try:
-                        with urlopen(self.export_url) as response:
+                        with open_url(self.export_url) as response:
                             export_page.write_bytes(response.read())
                     except Exception:
                         export_url = self.export_url

{texsmith-0.2.1.dev0 → texsmith-0.2.2}/src/texsmith/core/conversion/core.py

@@ -267,6 +267,7 @@ def convert_document(
         wrap_document=wrap_document,
         legacy_latex_accents=request.legacy_latex_accents,
         diagrams_backend=request.diagrams_backend,
+        http_user_agent=request.http_user_agent,
     )
 
 
@@ -283,6 +284,7 @@ def _render_document(
     wrap_document: bool,
     legacy_latex_accents: bool,
     diagrams_backend: str | None,
+    http_user_agent: str | None,
 ) -> ConversionResult:
     if persist_debug_html:
         persist_debug_artifacts(
@@ -305,6 +307,7 @@ def _render_document(
         strategy=strategy,
         diagrams_backend=diagrams_backend,
         emitter=emitter,
+        http_user_agent=http_user_agent,
     )
 
     active_slot_requests = binder_context.slot_requests
@@ -490,6 +493,7 @@ def _build_runtime_common(
     strategy: GenerationStrategy,
     diagrams_backend: str | None,
     emitter: DiagnosticEmitter,
+    http_user_agent: str | None,
 ) -> dict[str, object]:
     """Prepare immutable runtime metadata shared across fragment rendering."""
     code_options = _resolve_code_options(binding, binder_context.template_overrides)
@@ -504,6 +508,8 @@ def _build_runtime_common(
         "language": binder_context.language,
         "emitter": emitter,
     }
+    if isinstance(http_user_agent, str) and http_user_agent.strip():
+        runtime_common["http_user_agent"] = http_user_agent.strip()
     template_callouts = binder_context.template_overrides.get("callouts")
     runtime_common["callouts_definitions"] = normalise_callouts(
         merge_callouts(

{texsmith-0.2.1.dev0 → texsmith-0.2.2}/src/texsmith/core/conversion/models.py

@@ -55,6 +55,7 @@ class ConversionRequest:
     manifest: bool = False
     persist_debug_html: bool = False
     language: str | None = None
+    http_user_agent: str | None = None
     legacy_latex_accents: bool = False
     diagrams_backend: str | None = None