typsphinx 0.4.3__tar.gz → 0.4.4__tar.gz

{typsphinx-0.4.3/typsphinx.egg-info → typsphinx-0.4.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: typsphinx
-Version: 0.4.3
+Version: 0.4.4
 Summary: Sphinx extension for Typst output
 Author-email: YuSabo <yusabo90002@gmail.com>
 License-Expression: MIT
@@ -13,27 +13,26 @@ Classifier: Development Status :: 5 - Production/Stable
 Classifier: Framework :: Sphinx :: Extension
 Classifier: Intended Audience :: Developers
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Documentation :: Sphinx
 Classifier: Topic :: Software Development :: Documentation
-Requires-Python: >=3.9
+Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: sphinx>=5.0
-Requires-Dist: docutils>=0.18
-Requires-Dist: typst>=0.14.1
+Requires-Dist: sphinx<9,>=5.0
+Requires-Dist: docutils<0.22,>=0.18
+Requires-Dist: typst<0.15,>=0.14.1
 Provides-Extra: dev
-Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest<10,>=8.4; extra == "dev"
 Requires-Dist: pytest-cov>=4.0; extra == "dev"
-Requires-Dist: tox>=4.0; extra == "dev"
-Requires-Dist: tox-uv>=1.0; extra == "dev"
-Requires-Dist: black>=23.0; extra == "dev"
-Requires-Dist: ruff>=0.1.0; extra == "dev"
-Requires-Dist: mypy>=1.0; extra == "dev"
-Requires-Dist: sphinx-testing>=1.0; extra == "dev"
+Requires-Dist: tox<5,>=4.56; extra == "dev"
+Requires-Dist: tox-uv<2,>=1.35; extra == "dev"
+Requires-Dist: black<27,>=26; extra == "dev"
+Requires-Dist: ruff<0.16,>=0.15; extra == "dev"
+Requires-Dist: mypy<3.0,>=1.13; extra == "dev"
 Requires-Dist: pre-commit>=3.0; extra == "dev"
 Requires-Dist: types-docutils>=0.18; extra == "dev"
 Requires-Dist: twine>=5.0; extra == "dev"
@@ -41,10 +40,13 @@ Requires-Dist: build>=1.0; extra == "dev"
 Provides-Extra: docs
 Requires-Dist: furo>=2024.0; extra == "docs"
 Requires-Dist: sphinx-autodoc-typehints>=1.0; extra == "docs"
+Requires-Dist: sphinx-intl>=2.0; extra == "docs"
+Requires-Dist: tomli>=2.0; python_version < "3.11" and extra == "docs"
 Dynamic: license-file
 
 # typsphinx
 
+[![CI](https://github.com/YuSabo90002/typsphinx/actions/workflows/ci.yml/badge.svg)](https://github.com/YuSabo90002/typsphinx/actions/workflows/ci.yml)
 [![PyPI version](https://badge.fury.io/py/typsphinx.svg)](https://badge.fury.io/py/typsphinx)
 [![Python Support](https://img.shields.io/pypi/pyversions/typsphinx.svg)](https://pypi.org/project/typsphinx/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
@@ -78,7 +80,7 @@ typsphinx is a Sphinx extension that enables generating Typst documents from reS
 
 ## Requirements
 
-- Python 3.9 or higher
+- Python 3.10 or higher
 - Sphinx 5.0 or higher
 - typst-py 0.11.1 or higher
 
@@ -365,4 +367,4 @@ See [CHANGELOG.md](CHANGELOG.md) for detailed version history.
 ---
 
 **Status**: Stable (v0.4.2) - Production ready
-**Python**: 3.9+ | **Sphinx**: 5.0+ | **Typst**: 0.11.1+
+**Python**: 3.10+ | **Sphinx**: 5.0+ | **Typst**: 0.11.1+

{typsphinx-0.4.3 → typsphinx-0.4.4}/README.md

@@ -1,5 +1,6 @@
 # typsphinx
 
+[![CI](https://github.com/YuSabo90002/typsphinx/actions/workflows/ci.yml/badge.svg)](https://github.com/YuSabo90002/typsphinx/actions/workflows/ci.yml)
 [![PyPI version](https://badge.fury.io/py/typsphinx.svg)](https://badge.fury.io/py/typsphinx)
 [![Python Support](https://img.shields.io/pypi/pyversions/typsphinx.svg)](https://pypi.org/project/typsphinx/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
@@ -33,7 +34,7 @@ typsphinx is a Sphinx extension that enables generating Typst documents from reS
 
 ## Requirements
 
-- Python 3.9 or higher
+- Python 3.10 or higher
 - Sphinx 5.0 or higher
 - typst-py 0.11.1 or higher
 
@@ -320,4 +321,4 @@ See [CHANGELOG.md](CHANGELOG.md) for detailed version history.
 ---
 
 **Status**: Stable (v0.4.2) - Production ready
-**Python**: 3.9+ | **Sphinx**: 5.0+ | **Typst**: 0.11.1+
+**Python**: 3.10+ | **Sphinx**: 5.0+ | **Typst**: 0.11.1+

{typsphinx-0.4.3 → typsphinx-0.4.4}/pyproject.toml

@@ -4,10 +4,10 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "typsphinx"
-version = "0.4.3"
+version = "0.4.4"
 description = "Sphinx extension for Typst output"
 readme = "README.md"
-requires-python = ">=3.9"
+requires-python = ">=3.10"
 license = "MIT"
 authors = [
     {name = "YuSabo", email = "yusabo90002@gmail.com"}
@@ -18,30 +18,29 @@ classifiers = [
     "Framework :: Sphinx :: Extension",
     "Intended Audience :: Developers",
     "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.9",
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
     "Topic :: Documentation :: Sphinx",
     "Topic :: Software Development :: Documentation",
 ]
 
 dependencies = [
-    "sphinx>=5.0",
-    "docutils>=0.18",
-    "typst>=0.14.1",
+    "sphinx>=5.0,<9",
+    "docutils>=0.18,<0.22",
+    "typst>=0.14.1,<0.15",
 ]
 
 [project.optional-dependencies]
 dev = [
-    "pytest>=7.0",
+    "pytest>=8.4,<10",
     "pytest-cov>=4.0",
-    "tox>=4.0",
-    "tox-uv>=1.0",
-    "black>=23.0",
-    "ruff>=0.1.0",
-    "mypy>=1.0",
-    "sphinx-testing>=1.0",
+    "tox>=4.56,<5",
+    "tox-uv>=1.35,<2",
+    "black>=26,<27",
+    "ruff>=0.15,<0.16",
+    "mypy>=1.13,<3.0",
     "pre-commit>=3.0",
     "types-docutils>=0.18",
     "twine>=5.0",
@@ -50,6 +49,8 @@ dev = [
 docs = [
     "furo>=2024.0",
     "sphinx-autodoc-typehints>=1.0",
+    "sphinx-intl>=2.0",
+    "tomli>=2.0; python_version < '3.11'",
 ]
 
 [project.urls]
@@ -84,7 +85,7 @@ markers = [
 
 [tool.black]
 line-length = 88
-target-version = ["py39", "py310", "py311", "py312"]
+target-version = ["py310", "py311", "py312", "py313"]
 include = '\.pyi?$'
 exclude = '''
 /(
@@ -99,7 +100,7 @@ exclude = '''
 
 [tool.ruff]
 line-length = 88
-target-version = "py39"
+target-version = "py310"
 
 [tool.ruff.lint]
 select = ["E", "F", "W", "I", "N", "UP", "B", "A", "C4", "T20"]
@@ -107,8 +108,8 @@ ignore = [
     "E501",   # Line too long (handled by black)
     "T201",   # print found (used in tests for debugging)
     "B017",   # asserting blind exception in tests
-    "UP035",  # typing.Dict/List/Set deprecation (Python 3.9+ support)
-    "UP006",  # Use dict instead of Dict (Python 3.9+ support)
+    "UP035",  # typing.Dict/List/Set deprecation (Python 3.10+ support)
+    "UP006",  # Use dict instead of Dict (Python 3.10+ support)
     "UP028",  # yield from (minor optimization)
     "N802",   # Function naming (docutils visitor pattern uses PascalCase)
     "A001",   # Shadowing builtins (copyright in conf.py is Sphinx convention)
@@ -116,7 +117,7 @@ ignore = [
 ]
 
 [tool.mypy]
-python_version = "3.9"
+python_version = "3.10"
 warn_return_any = false
 warn_unused_configs = true
 disallow_untyped_defs = false

{typsphinx-0.4.3 → typsphinx-0.4.4}/tests/test_config_other_options.py

@@ -12,12 +12,10 @@ def test_typst_package_config_registered(make_app, tmp_path):
     """Test that typst_package is registered as a config value"""
     # Arrange: Create conf.py with typst_package setting
     conf_py = tmp_path / "conf.py"
-    conf_py.write_text(
-        """
+    conf_py.write_text("""
 extensions = ['typsphinx']
 typst_package = "@preview/diagraph:0.2.5"
-"""
-    )
+""")
 
     # Create minimal index.rst
     index_rst = tmp_path / "index.rst"
@@ -35,15 +33,13 @@ def test_typst_package_imports_config_registered(make_app, tmp_path):
     """Test that typst_package_imports is registered as a config value"""
     # Arrange: Create conf.py with typst_package_imports setting
     conf_py = tmp_path / "conf.py"
-    conf_py.write_text(
-        """
+    conf_py.write_text("""
 extensions = ['typsphinx']
 typst_package_imports = [
     '#import "@preview/diagraph:0.2.5": *',
     '#import "@preview/tablex:0.1.0": *',
 ]
-"""
-    )
+""")
 
     # Create minimal index.rst
     index_rst = tmp_path / "index.rst"
@@ -65,12 +61,10 @@ def test_typst_template_function_config_registered(make_app, tmp_path):
     """Test that typst_template_function is registered as a config value"""
     # Arrange: Create conf.py with typst_template_function setting
     conf_py = tmp_path / "conf.py"
-    conf_py.write_text(
-        """
+    conf_py.write_text("""
 extensions = ['typsphinx']
 typst_template_function = "custom_template"
-"""
-    )
+""")
 
     # Create minimal index.rst
     index_rst = tmp_path / "index.rst"
@@ -88,11 +82,9 @@ def test_typst_package_default_none(make_app, tmp_path):
     """Test that typst_package defaults to None when not set"""
     # Arrange: Create conf.py without typst_package
     conf_py = tmp_path / "conf.py"
-    conf_py.write_text(
-        """
+    conf_py.write_text("""
 extensions = ['typsphinx']
-"""
-    )
+""")
 
     # Create minimal index.rst
     index_rst = tmp_path / "index.rst"
@@ -110,11 +102,9 @@ def test_typst_package_imports_default_none(make_app, tmp_path):
     """Test that typst_package_imports defaults to None when not set"""
     # Arrange: Create conf.py without typst_package_imports
     conf_py = tmp_path / "conf.py"
-    conf_py.write_text(
-        """
+    conf_py.write_text("""
 extensions = ['typsphinx']
-"""
-    )
+""")
 
     # Create minimal index.rst
     index_rst = tmp_path / "index.rst"
@@ -132,11 +122,9 @@ def test_typst_template_function_default_none(make_app, tmp_path):
     """Test that typst_template_function defaults to None when not set"""
     # Arrange: Create conf.py without typst_template_function
     conf_py = tmp_path / "conf.py"
-    conf_py.write_text(
-        """
+    conf_py.write_text("""
 extensions = ['typsphinx']
-"""
-    )
+""")
 
     # Create minimal index.rst
     index_rst = tmp_path / "index.rst"
@@ -154,12 +142,10 @@ def test_typst_output_dir_config_registered(make_app, tmp_path):
     """Test that typst_output_dir is registered as a config value"""
     # Arrange: Create conf.py with typst_output_dir setting
     conf_py = tmp_path / "conf.py"
-    conf_py.write_text(
-        """
+    conf_py.write_text("""
 extensions = ['typsphinx']
 typst_output_dir = '_custom/typst'
-"""
-    )
+""")
 
     # Create minimal index.rst
     index_rst = tmp_path / "index.rst"
@@ -177,11 +163,9 @@ def test_typst_output_dir_default_value(make_app, tmp_path):
     """Test that typst_output_dir defaults to '_build/typst' when not set"""
     # Arrange: Create conf.py without typst_output_dir
     conf_py = tmp_path / "conf.py"
-    conf_py.write_text(
-        """
+    conf_py.write_text("""
 extensions = ['typsphinx']
-"""
-    )
+""")
 
     # Create minimal index.rst
     index_rst = tmp_path / "index.rst"
@@ -199,12 +183,10 @@ def test_typst_debug_config_registered(make_app, tmp_path):
     """Test that typst_debug is registered as a config value"""
     # Arrange: Create conf.py with typst_debug setting
     conf_py = tmp_path / "conf.py"
-    conf_py.write_text(
-        """
+    conf_py.write_text("""
 extensions = ['typsphinx']
 typst_debug = True
-"""
-    )
+""")
 
     # Create minimal index.rst
     index_rst = tmp_path / "index.rst"
@@ -222,11 +204,9 @@ def test_typst_debug_default_false(make_app, tmp_path):
     """Test that typst_debug defaults to False when not set"""
     # Arrange: Create conf.py without typst_debug
     conf_py = tmp_path / "conf.py"
-    conf_py.write_text(
-        """
+    conf_py.write_text("""
 extensions = ['typsphinx']
-"""
-    )
+""")
 
     # Create minimal index.rst
     index_rst = tmp_path / "index.rst"

{typsphinx-0.4.3 → typsphinx-0.4.4}/tests/test_config_toctree_defaults.py

@@ -77,8 +77,7 @@ typst_toctree_defaults = {
 typst_documents = [('index', 'index', 'Test', 'Author')]
 """
     (srcdir / "conf.py").write_text(conf_content)
-    (srcdir / "index.rst").write_text(
-        """
+    (srcdir / "index.rst").write_text("""
 Test Document
 =============
 
@@ -86,8 +85,7 @@ Test Document
    :maxdepth: 2
 
    chapter1
-"""
-    )
+""")
     (srcdir / "chapter1.rst").write_text("Chapter 1\n=========\n")
 
     app = make_app(srcdir=srcdir, buildername="typst")
@@ -123,8 +121,7 @@ typst_documents = [('index', 'index', 'Test', 'Author')]
     (srcdir / "conf.py").write_text(conf_content)
 
     # toctree with explicit maxdepth:2 (should override default maxdepth:4)
-    (srcdir / "index.rst").write_text(
-        """
+    (srcdir / "index.rst").write_text("""
 Test
 ====
 
@@ -133,8 +130,7 @@ Test
    :numbered:
 
    chapter1
-"""
-    )
+""")
     (srcdir / "chapter1.rst").write_text("Chapter\n=======\n")
 
     app = make_app(srcdir=srcdir, buildername="typst")

{typsphinx-0.4.3 → typsphinx-0.4.4}/tests/test_entry_points.py

@@ -2,20 +2,13 @@
 Tests for entry points configuration.
 """
 
-import sys
 from importlib.metadata import entry_points
 
 
 def test_entry_point_registration():
     """Test that entry points are defined in pyproject.toml."""
     # Get entry points for sphinx.builders group
-    if sys.version_info >= (3, 10):
-        # Python 3.10+ uses select() method
-        eps = entry_points(group="sphinx.builders")
-    else:
-        # Python 3.9 uses dict-like access
-        all_eps = entry_points()
-        eps = all_eps.get("sphinx.builders", [])
+    eps = entry_points(group="sphinx.builders")
 
     # Convert to list of names
     ep_names = [ep.name for ep in eps]
@@ -32,11 +25,7 @@ def test_entry_point_registration():
 def test_entry_point_value():
     """Test that the entry points point to the correct module."""
     # Get entry points for sphinx.builders group
-    if sys.version_info >= (3, 10):
-        eps = entry_points(group="sphinx.builders")
-    else:
-        all_eps = entry_points()
-        eps = all_eps.get("sphinx.builders", [])
+    eps = entry_points(group="sphinx.builders")
 
     # Find the entry points
     typst_ep = None

typsphinx-0.4.4/tests/test_preview_version_sync.py

@@ -0,0 +1,105 @@
+"""
+Tests guarding the 3-way `@preview` version-sync hazard.
+
+typsphinx declares the same four Typst Universe `@preview` package versions
+(codly, codly-languages, mitex, gentle-clues) in three separate places:
+`typsphinx/writer.py`, `typsphinx/template_engine.py`, and
+`typsphinx/templates/base.typ`. These must stay in lockstep, or generated
+Typst documents can end up importing mismatched package versions depending
+on which code path produced them. This module asserts the three declaration
+sites agree, so a future single-file edit fails CI loudly instead of
+silently (D-03).
+"""
+
+import re
+from pathlib import Path
+
+REPO_ROOT = Path(__file__).resolve().parents[1]
+
+WRITER_PATH = REPO_ROOT / "typsphinx" / "writer.py"
+TEMPLATE_ENGINE_PATH = REPO_ROOT / "typsphinx" / "template_engine.py"
+BASE_TYP_PATH = REPO_ROOT / "typsphinx" / "templates" / "base.typ"
+
+EXPECTED_PACKAGES = {"codly", "codly-languages", "mitex", "gentle-clues"}
+
+# Matches an actual Typst `#import "@preview/<name>:<version>"` statement
+# (not a bare mention in a comment or docstring example). name is
+# letters/digits/underscore/hyphen; version is a three-part semver.
+_PREVIEW_IMPORT_RE = re.compile(
+    r'#import\s+"@preview/(?P<name>[A-Za-z0-9_-]+):(?P<version>\d+\.\d+\.\d+)"'
+)
+
+
+def _extract_preview_versions(path):
+    """Parse a file's raw text for `#import "@preview/<name>:<version>"` lines.
+
+    Only matches actual Typst import statements, not bare `@preview/...`
+    text appearing in comments or docstring examples (e.g. a docstring
+    illustrating the `typst_package` config option format). Returns a dict
+    mapping package name to version string. If a package name appears more
+    than once in a file, the last occurrence wins (mirrors how a human
+    reading the file top-to-bottom would resolve it).
+    """
+    text = path.read_text()
+    versions = {}
+    for match in _PREVIEW_IMPORT_RE.finditer(text):
+        versions[match.group("name")] = match.group("version")
+    return versions
+
+
+def test_preview_versions_identical_across_declaration_sites():
+    """The three declaration sites must agree on every @preview version.
+
+    This compares the files against each other (not against a hardcoded
+    expected mapping) so the test stays correct if the whole set is
+    intentionally rebumped in lockstep — it only fails on a *divergence*.
+    """
+    writer_versions = _extract_preview_versions(WRITER_PATH)
+    template_engine_versions = _extract_preview_versions(TEMPLATE_ENGINE_PATH)
+    base_typ_versions = _extract_preview_versions(BASE_TYP_PATH)
+
+    all_files = {
+        "writer.py": writer_versions,
+        "template_engine.py": template_engine_versions,
+        "base.typ": base_typ_versions,
+    }
+
+    all_packages = set()
+    for versions in all_files.values():
+        all_packages.update(versions.keys())
+
+    divergences = []
+    for package in sorted(all_packages):
+        per_file_versions = {
+            filename: versions.get(package, "<missing>")
+            for filename, versions in all_files.items()
+        }
+        if len(set(per_file_versions.values())) > 1:
+            divergences.append((package, per_file_versions))
+
+    assert (
+        not divergences
+    ), "@preview version desync detected across declaration sites: " + "; ".join(
+        f"{package}: {per_file_versions}" for package, per_file_versions in divergences
+    )
+
+
+def test_all_four_packages_declared():
+    """Each declaration site must declare all four expected packages.
+
+    Without this, a dropped import in one file could make the identity
+    check above vacuously pass (an empty dict equals another empty dict).
+    """
+    files = {
+        "writer.py": WRITER_PATH,
+        "template_engine.py": TEMPLATE_ENGINE_PATH,
+        "base.typ": BASE_TYP_PATH,
+    }
+
+    for filename, path in files.items():
+        declared = set(_extract_preview_versions(path).keys())
+        missing = EXPECTED_PACKAGES - declared
+        assert not missing, (
+            f"{filename} is missing expected @preview packages: {missing} "
+            f"(declared: {declared})"
+        )

{typsphinx-0.4.3 → typsphinx-0.4.4}/typsphinx/builder.py

@@ -8,7 +8,7 @@ building Typst output from Sphinx documentation.
 import shutil
 from collections.abc import Iterator
 from os import path
-from typing import Optional, Set
+from typing import Set
 
 from docutils import nodes
 from sphinx.builders import Builder
@@ -57,7 +57,7 @@ class TypstBuilder(Builder):
         for docname in self.env.found_docs:
             yield docname
 
-    def get_target_uri(self, docname: str, typ: Optional[str] = None) -> str:
+    def get_target_uri(self, docname: str, typ: str | None = None) -> str:
         """
         Return the target URI for a document.
 
@@ -88,7 +88,7 @@ class TypstBuilder(Builder):
 
     def write(
         self,
-        build_docnames: Optional[Set[str]],
+        build_docnames: Set[str] | None,
         updated_docnames: Set[str],
         method: str = "update",
     ) -> None:

{typsphinx-0.4.3 → typsphinx-0.4.4}/typsphinx/pdf.py

@@ -8,7 +8,6 @@ using the typst Python package (Requirement 9).
 import logging
 import os
 import tempfile
-from typing import Optional
 
 logger = logging.getLogger(__name__)
 
@@ -32,8 +31,8 @@ class TypstCompilationError(Exception):
     def __init__(
         self,
         message: str,
-        typst_error: Optional[Exception] = None,
-        source_location: Optional[str] = None,
+        typst_error: Exception | None = None,
+        source_location: str | None = None,
     ):
         """
         Initialize TypstCompilationError.
@@ -108,7 +107,7 @@ def get_typst_version() -> str:
         return "not installed"
 
 
-def compile_typst_to_pdf(typst_content: str, root_dir: Optional[str] = None) -> bytes:
+def compile_typst_to_pdf(typst_content: str, root_dir: str | None = None) -> bytes:
     """
     Compile Typst content to PDF bytes.
 

{typsphinx-0.4.3 → typsphinx-0.4.4}/typsphinx/template_engine.py

@@ -7,7 +7,7 @@ for Typst documents (Requirement 8).
 
 import logging
 from pathlib import Path
-from typing import Any, Dict, List, Optional
+from typing import Any, Dict, List
 
 logger = logging.getLogger(__name__)
 
@@ -40,15 +40,15 @@ class TemplateEngine:
 
     def __init__(
         self,
-        template_path: Optional[str] = None,
-        template_name: Optional[str] = None,
-        search_paths: Optional[List[str]] = None,
-        parameter_mapping: Optional[Dict[str, str]] = None,
-        typst_package: Optional[str] = None,
-        typst_template_function: Optional[Any] = None,
-        typst_package_imports: Optional[List[str]] = None,
-        typst_authors: Optional[Dict[str, Dict[str, Any]]] = None,
-        typst_author_params: Optional[Dict[str, Dict[str, Any]]] = None,
+        template_path: str | None = None,
+        template_name: str | None = None,
+        search_paths: List[str] | None = None,
+        parameter_mapping: Dict[str, str] | None = None,
+        typst_package: str | None = None,
+        typst_template_function: Any | None = None,
+        typst_package_imports: List[str] | None = None,
+        typst_authors: Dict[str, Dict[str, Any]] | None = None,
+        typst_author_params: Dict[str, Dict[str, Any]] | None = None,
     ):
         """
         Initialize TemplateEngine.
@@ -404,7 +404,7 @@ class TemplateEngine:
         else:
             return (str(author_value),)
 
-    def _try_load_file(self, file_path: str) -> Optional[str]:
+    def _try_load_file(self, file_path: str) -> str | None:
         """
         Try to load content from file.
 
@@ -420,7 +420,7 @@ class TemplateEngine:
         except (FileNotFoundError, OSError):
             return None
 
-    def _format_authors_with_details(self, authors: Optional[tuple] = None) -> str:
+    def _format_authors_with_details(self, authors: tuple | None = None) -> str:
         """
         Format authors with detailed information as Typst dict tuple.
 

{typsphinx-0.4.3 → typsphinx-0.4.4}/typsphinx/translator.py

@@ -6,7 +6,7 @@ nodes to Typst markup.
 """
 
 import re
-from typing import Any, List, Optional, Union
+from typing import Any, List
 
 from docutils import nodes
 from sphinx import addnodes
@@ -83,10 +83,10 @@ class TypstTranslator(SphinxTranslator):
 
         # Definition list state
         self.in_definition_list = False
-        self.current_term_buffer: Union[str, List[str], None] = None
-        self.current_definition_buffer: Optional[List[str]] = None
+        self.current_term_buffer: str | List[str] | None = None
+        self.current_definition_buffer: List[str] | None = None
         self.definition_list_items = []  # List of (term, definition) tuples
-        self.saved_body: Optional[List[Any]] = (
+        self.saved_body: List[Any] | None = (
             None  # Used by definition lists for body swapping
         )
 
@@ -1596,7 +1596,7 @@ class TypstTranslator(SphinxTranslator):
             self.add_text("]")
 
     def _compute_relative_include_path(
-        self, target_docname: str, current_docname: Optional[str]
+        self, target_docname: str, current_docname: str | None
     ) -> str:
         """
         Compute relative path for toctree #include() directive.
@@ -1677,7 +1677,7 @@ class TypstTranslator(SphinxTranslator):
 
             # Find common parent by comparing path components
             common_length = 0
-            for i, (c, t) in enumerate(zip(current_parts, target_parts)):
+            for i, (c, t) in enumerate(zip(current_parts, target_parts, strict=False)):
                 if c == t:
                     common_length = i + 1
                 else:
@@ -1707,7 +1707,7 @@ class TypstTranslator(SphinxTranslator):
             return relative_path
 
     def _compute_relative_image_path(
-        self, image_uri: str, current_docname: Optional[str]
+        self, image_uri: str, current_docname: str | None
     ) -> str:
         """
         Compute relative path for image() function.
@@ -1782,7 +1782,7 @@ class TypstTranslator(SphinxTranslator):
 
             # Find common parent by comparing path components
             common_length = 0
-            for i, (c, img) in enumerate(zip(current_parts, image_parts)):
+            for i, (c, img) in enumerate(zip(current_parts, image_parts, strict=False)):
                 if c == img:
                     common_length = i + 1
                 else:

{typsphinx-0.4.3 → typsphinx-0.4.4/typsphinx.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: typsphinx
-Version: 0.4.3
+Version: 0.4.4
 Summary: Sphinx extension for Typst output
 Author-email: YuSabo <yusabo90002@gmail.com>
 License-Expression: MIT
@@ -13,27 +13,26 @@ Classifier: Development Status :: 5 - Production/Stable
 Classifier: Framework :: Sphinx :: Extension
 Classifier: Intended Audience :: Developers
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Documentation :: Sphinx
 Classifier: Topic :: Software Development :: Documentation
-Requires-Python: >=3.9
+Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: sphinx>=5.0
-Requires-Dist: docutils>=0.18
-Requires-Dist: typst>=0.14.1
+Requires-Dist: sphinx<9,>=5.0
+Requires-Dist: docutils<0.22,>=0.18
+Requires-Dist: typst<0.15,>=0.14.1
 Provides-Extra: dev
-Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest<10,>=8.4; extra == "dev"
 Requires-Dist: pytest-cov>=4.0; extra == "dev"
-Requires-Dist: tox>=4.0; extra == "dev"
-Requires-Dist: tox-uv>=1.0; extra == "dev"
-Requires-Dist: black>=23.0; extra == "dev"
-Requires-Dist: ruff>=0.1.0; extra == "dev"
-Requires-Dist: mypy>=1.0; extra == "dev"
-Requires-Dist: sphinx-testing>=1.0; extra == "dev"
+Requires-Dist: tox<5,>=4.56; extra == "dev"
+Requires-Dist: tox-uv<2,>=1.35; extra == "dev"
+Requires-Dist: black<27,>=26; extra == "dev"
+Requires-Dist: ruff<0.16,>=0.15; extra == "dev"
+Requires-Dist: mypy<3.0,>=1.13; extra == "dev"
 Requires-Dist: pre-commit>=3.0; extra == "dev"
 Requires-Dist: types-docutils>=0.18; extra == "dev"
 Requires-Dist: twine>=5.0; extra == "dev"
@@ -41,10 +40,13 @@ Requires-Dist: build>=1.0; extra == "dev"
 Provides-Extra: docs
 Requires-Dist: furo>=2024.0; extra == "docs"
 Requires-Dist: sphinx-autodoc-typehints>=1.0; extra == "docs"
+Requires-Dist: sphinx-intl>=2.0; extra == "docs"
+Requires-Dist: tomli>=2.0; python_version < "3.11" and extra == "docs"
 Dynamic: license-file
 
 # typsphinx
 
+[![CI](https://github.com/YuSabo90002/typsphinx/actions/workflows/ci.yml/badge.svg)](https://github.com/YuSabo90002/typsphinx/actions/workflows/ci.yml)
 [![PyPI version](https://badge.fury.io/py/typsphinx.svg)](https://badge.fury.io/py/typsphinx)
 [![Python Support](https://img.shields.io/pypi/pyversions/typsphinx.svg)](https://pypi.org/project/typsphinx/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
@@ -78,7 +80,7 @@ typsphinx is a Sphinx extension that enables generating Typst documents from reS
 
 ## Requirements
 
-- Python 3.9 or higher
+- Python 3.10 or higher
 - Sphinx 5.0 or higher
 - typst-py 0.11.1 or higher
 
@@ -365,4 +367,4 @@ See [CHANGELOG.md](CHANGELOG.md) for detailed version history.
 ---
 
 **Status**: Stable (v0.4.2) - Production ready
-**Python**: 3.9+ | **Sphinx**: 5.0+ | **Typst**: 0.11.1+
+**Python**: 3.10+ | **Sphinx**: 5.0+ | **Typst**: 0.11.1+

{typsphinx-0.4.3 → typsphinx-0.4.4}/typsphinx.egg-info/SOURCES.txt

@@ -24,6 +24,7 @@ tests/test_math_mitex.py
 tests/test_math_native.py
 tests/test_nested_toctree_paths.py
 tests/test_pdf_generation.py
+tests/test_preview_version_sync.py
 tests/test_template_assets.py
 tests/test_template_codly.py
 tests/test_template_engine.py

typsphinx-0.4.4/typsphinx.egg-info/requires.txt

@@ -0,0 +1,24 @@
+sphinx<9,>=5.0
+docutils<0.22,>=0.18
+typst<0.15,>=0.14.1
+
+[dev]
+pytest<10,>=8.4
+pytest-cov>=4.0
+tox<5,>=4.56
+tox-uv<2,>=1.35
+black<27,>=26
+ruff<0.16,>=0.15
+mypy<3.0,>=1.13
+pre-commit>=3.0
+types-docutils>=0.18
+twine>=5.0
+build>=1.0
+
+[docs]
+furo>=2024.0
+sphinx-autodoc-typehints>=1.0
+sphinx-intl>=2.0
+
+[docs:python_version < "3.11"]
+tomli>=2.0

typsphinx-0.4.3/typsphinx.egg-info/requires.txt

@@ -1,21 +0,0 @@
-sphinx>=5.0
-docutils>=0.18
-typst>=0.14.1
-
-[dev]
-pytest>=7.0
-pytest-cov>=4.0
-tox>=4.0
-tox-uv>=1.0
-black>=23.0
-ruff>=0.1.0
-mypy>=1.0
-sphinx-testing>=1.0
-pre-commit>=3.0
-types-docutils>=0.18
-twine>=5.0
-build>=1.0
-
-[docs]
-furo>=2024.0
-sphinx-autodoc-typehints>=1.0