text-compositor 0.2.0__tar.gz

text_compositor-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 tokudiro
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

text_compositor-0.2.0/PKG-INFO

@@ -0,0 +1,161 @@
+Metadata-Version: 2.4
+Name: text-compositor
+Version: 0.2.0
+Summary: A tool for composing multiple text files into a PDF document.
+License-Expression: MIT
+Project-URL: Repository, https://github.com/tokudiro/text-compositor
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: typst==0.15.0
+Requires-Dist: markdown-it-py==3.0.0
+Requires-Dist: mdit-py-plugins==0.6.1
+Requires-Dist: PyYAML==6.0.2
+Requires-Dist: platformdirs==4.3.6
+Provides-Extra: mermaid
+Requires-Dist: playwright==1.62.0; extra == "mermaid"
+Dynamic: license-file
+
+# text-compositor
+
+*[日本語版 (Japanese version)](README-ja.md)*
+
+A tool that treats multiple text files as independent fragments and deterministically composes them into a single human-readable PDF document. Works equally well for AI-generated drafts refined by humans and for existing, hand-authored documents you want to organize and consolidate.
+
+This README covers only the essentials needed to get started quickly. For a full walkthrough of `config.yaml` and how to write your source documents, see the [usage guide](doc/usage/) (which can also be built into a PDF with `cd doc/usage && python ../../build.py`). For detailed design rationale and implementation status, see [doc/spec.md](doc/spec.md). Differences from general-purpose tools like Quarto are summarized in [doc/diff.md](doc/diff.md).
+
+## Features
+
+- Combines multiple text files (chapters) into a single PDF
+- Markdown → AST via [markdown-it-py](https://github.com/executablebooks/markdown-it-py) → deterministic conversion to [Typst](https://typst.app/) syntax → PDF output
+- Outputs other text files to the PDF unchanged
+- Separates the tool itself from the documentation (source files), which can live anywhere outside the repository
+- Python-centric with minimal downloads, no dependency on external servers or SaaS (runs the same way on GitHub Actions and locally on Windows/Linux/macOS)
+
+Files listed in `chapters` are handled differently depending on their extension:
+
+- `.md`/`.markdown`: converted as Markdown
+- `.yaml`/`.yml`/`.json`: rendered as monospaced text with syntax highlighting
+- `.dot`/`.gv`, `.mmd`, `.puml`/`.plantuml`/`.pu`, `.d2`: each rendered as a one-chapter diagram (Graphviz, Mermaid, PlantUML, D2 respectively)
+- `.csv`: rendered as a structured Typst table
+- everything else (plain text, code files, etc.): rendered as plain monospaced text
+
+See the [usage guide](doc/usage/) for details.
+
+## Requirements
+
+- Python 3.10+
+
+> **Windows note — Microsoft Store Python is not supported, even inside `pipx`/`venv`:** If Python was installed from the Microsoft Store, this tool cannot be used with it, full stop — `pipx` or a `venv` does **not** work around this.
+>
+> Windows redirects that Python's writes under `%LOCALAPPDATA%` into a package-private folder, and this redirection follows the Store installation into any `venv`/`pipx` environment created from it (verified by testing), breaking every subprocess-based feature (PlantUML, Mermaid, D2) even though the files appear to exist to Python itself.
+>
+> Before installing this tool, install Python from [python.org](https://www.python.org/downloads/) (or another non-Store distribution such as `winget install Python.Python.3.12`) and use that Python for the steps below. Run `text-compositor --check-env` afterward to confirm the environment is set up correctly.
+
+There are two ways to install and run this tool.
+
+### Option A: `pip install` (recommended)
+
+```bash
+pipx install text-compositor
+```
+
+`pipx` installs the tool into an isolated environment and exposes the `text-compositor` command — recommended for most users. If you're developing this tool itself, use a `venv` instead so an editable install (`pip install -e .`) picks up code changes immediately:
+
+```bash
+python -m venv .venv
+.venv/bin/pip install -e .        # Windows: .venv\Scripts\pip install -e .
+```
+
+### Option B: Clone and run directly (no installation)
+
+```bash
+pip install -r requirements.txt
+```
+
+No Typst compiler binary is bundled; it's obtained from the `typst` package (PyPI wheel) installed via `pip install` above. No additional downloads or installation steps are needed.
+
+### Using Mermaid diagrams (optional)
+
+This is only needed if your source documents use ` ```mermaid ` fences (or specify an `.mmd` file directly in `chapters`). With Option A, install the `mermaid` extra:
+
+```bash
+pipx install "text-compositor[mermaid]"
+# or, if already installed: pipx inject text-compositor playwright==1.62.0
+```
+
+With Option B (clone and run directly):
+
+```bash
+pip install playwright==1.62.0
+```
+
+- **A Google Chrome or Microsoft Edge installation already present on your system** (no new download by default; it's auto-detected and reused at build time)
+- The `playwright` package above (used only to connect to the existing browser via CDP; Playwright's own browser-download feature is not used by default)
+
+Node.js/npm is not required. At build time, the official single-file Mermaid bundle (`mermaid.min.js`, ~3.4MB) is fetched and loaded into a headless browser to convert diagrams to SVG (the bundle JS itself is cached under an OS-standard user cache directory — e.g. `%LOCALAPPDATA%\text-compositor\Cache` on Windows, `~/.cache/text-compositor` on Linux — and conversion results are cached under `.text-compositor/cache/`; neither is re-fetched afterward). None of this is needed for documents that don't use Mermaid.
+
+If no Chrome/Edge is found on the system, the build fails by default. Setting `plugins: { mermaid_auto_download: true }` instead auto-fetches Playwright's own Chromium, but **this download is about 700MB** (this setting exists as a last resort for when no pre-installed browser is available; downloading that much by default is intentionally avoided).
+
+### Using PlantUML diagrams (optional)
+
+No extra `config.yaml` settings are needed to use ` ```plantuml ` fences in your source documents (or to specify a `.puml` file directly in `chapters`) — `plugins.plantuml` defaults to `true` and no additional `pip install` is required.
+
+- If Java (11+) is available locally, it's reused as-is
+- Otherwise, Eclipse Temurin JRE (Adoptium distribution, ~49.7MB) is auto-fetched and cached by default under the same user cache directory as above. Setting `plugins: { plantuml_auto_download: false }` disables the auto-fetch and fails the build instead
+- GitHub Actions' `ubuntu-latest` ships with Java by default, so no extra download happens on CI
+
+The layout engine is the pure-Java Smetana implementation, so no external binary like Graphviz (`dot`) is required. PlantUML itself (MIT edition, ~17.6MB) is cached under the same user cache directory, and conversion results are cached under `.text-compositor/cache/`, same as Mermaid.
+
+### Using D2 diagrams (optional)
+
+No extra `config.yaml` settings are needed to use ` ```d2 ` fences in your source documents (or to specify a `.d2` file directly in `chapters`) — `plugins.d2` defaults to `true` and no additional `pip install` is required.
+
+- If the `d2` command is available locally, it's reused as-is
+- Otherwise, the official D2 CLI binary (a single Go executable, ~13MB) is auto-fetched and cached by default under the same user cache directory as above. Setting `plugins: { d2_auto_download: false }` disables the auto-fetch and fails the build instead
+
+Unlike Java (used by PlantUML) or a browser (used by Mermaid), GitHub Actions' `ubuntu-latest` does not ship with D2 preinstalled, so a `d2` diagram triggers this ~13MB download on every CI run (this project's workflows don't persist the cache directory across separate runs).
+
+## Usage
+
+If installed via `pip`/`pipx` (Option A):
+
+```bash
+text-compositor --config <path/to/text-compositor.config.yaml>
+```
+
+If cloned and run directly (Option B):
+
+```bash
+python build.py --config <path/to/text-compositor.config.yaml>
+```
+
+If `--config` is omitted, `text-compositor.config.yaml` (or `.json`) located directly in the current directory is auto-detected.
+
+```bash
+cd my-project/
+python /path/to/text-compositor/build.py
+```
+
+Run `text-compositor --check-env` (or `python build.py --check-env`) to check your environment (dependencies, Typst version, cached assets, Mermaid/PlantUML/D2 prerequisites) without running a build.
+
+Other flags control runtime behavior only (not document content, which stays entirely in `config.yaml`): `-q`/`--quiet` suppresses `[Info]`-level logging, `-v`/`--verbose` adds extra detail (which chapter is being processed, cache reuse), and `--keep-temp` keeps the intermediate `temp_build.typ` around after a successful build instead of deleting it (useful for debugging; it's always kept after a failed build).
+
+See [sample/text-compositor.config.yaml](sample/text-compositor.config.yaml) for how to write the config file, and the [usage guide](doc/usage/) for details on `document:`/`plugins:`, front matter, Marp directives, and more. The Markdown files listed in `chapters` are concatenated in order to produce the PDF.
+
+## Trying the sample
+
+```bash
+cd sample/
+python ../build.py
+```
+
+This generates `sample/System_Specification.pdf`.
+
+## Implementation status
+
+The core feature implemented so far is combining multiple files into a single PDF according to the config file specified via `--config` (or auto-detected). Expanding CLI options (e.g., overriding the output path) is still in the planning stage. See [GitHub Issues](https://github.com/tokudiro/text-compositor/issues) for known issues and upcoming plans.
+
+## License
+
+[MIT License](LICENSE)

text_compositor-0.2.0/README.md

@@ -0,0 +1,143 @@
+# text-compositor
+
+*[日本語版 (Japanese version)](README-ja.md)*
+
+A tool that treats multiple text files as independent fragments and deterministically composes them into a single human-readable PDF document. Works equally well for AI-generated drafts refined by humans and for existing, hand-authored documents you want to organize and consolidate.
+
+This README covers only the essentials needed to get started quickly. For a full walkthrough of `config.yaml` and how to write your source documents, see the [usage guide](doc/usage/) (which can also be built into a PDF with `cd doc/usage && python ../../build.py`). For detailed design rationale and implementation status, see [doc/spec.md](doc/spec.md). Differences from general-purpose tools like Quarto are summarized in [doc/diff.md](doc/diff.md).
+
+## Features
+
+- Combines multiple text files (chapters) into a single PDF
+- Markdown → AST via [markdown-it-py](https://github.com/executablebooks/markdown-it-py) → deterministic conversion to [Typst](https://typst.app/) syntax → PDF output
+- Outputs other text files to the PDF unchanged
+- Separates the tool itself from the documentation (source files), which can live anywhere outside the repository
+- Python-centric with minimal downloads, no dependency on external servers or SaaS (runs the same way on GitHub Actions and locally on Windows/Linux/macOS)
+
+Files listed in `chapters` are handled differently depending on their extension:
+
+- `.md`/`.markdown`: converted as Markdown
+- `.yaml`/`.yml`/`.json`: rendered as monospaced text with syntax highlighting
+- `.dot`/`.gv`, `.mmd`, `.puml`/`.plantuml`/`.pu`, `.d2`: each rendered as a one-chapter diagram (Graphviz, Mermaid, PlantUML, D2 respectively)
+- `.csv`: rendered as a structured Typst table
+- everything else (plain text, code files, etc.): rendered as plain monospaced text
+
+See the [usage guide](doc/usage/) for details.
+
+## Requirements
+
+- Python 3.10+
+
+> **Windows note — Microsoft Store Python is not supported, even inside `pipx`/`venv`:** If Python was installed from the Microsoft Store, this tool cannot be used with it, full stop — `pipx` or a `venv` does **not** work around this.
+>
+> Windows redirects that Python's writes under `%LOCALAPPDATA%` into a package-private folder, and this redirection follows the Store installation into any `venv`/`pipx` environment created from it (verified by testing), breaking every subprocess-based feature (PlantUML, Mermaid, D2) even though the files appear to exist to Python itself.
+>
+> Before installing this tool, install Python from [python.org](https://www.python.org/downloads/) (or another non-Store distribution such as `winget install Python.Python.3.12`) and use that Python for the steps below. Run `text-compositor --check-env` afterward to confirm the environment is set up correctly.
+
+There are two ways to install and run this tool.
+
+### Option A: `pip install` (recommended)
+
+```bash
+pipx install text-compositor
+```
+
+`pipx` installs the tool into an isolated environment and exposes the `text-compositor` command — recommended for most users. If you're developing this tool itself, use a `venv` instead so an editable install (`pip install -e .`) picks up code changes immediately:
+
+```bash
+python -m venv .venv
+.venv/bin/pip install -e .        # Windows: .venv\Scripts\pip install -e .
+```
+
+### Option B: Clone and run directly (no installation)
+
+```bash
+pip install -r requirements.txt
+```
+
+No Typst compiler binary is bundled; it's obtained from the `typst` package (PyPI wheel) installed via `pip install` above. No additional downloads or installation steps are needed.
+
+### Using Mermaid diagrams (optional)
+
+This is only needed if your source documents use ` ```mermaid ` fences (or specify an `.mmd` file directly in `chapters`). With Option A, install the `mermaid` extra:
+
+```bash
+pipx install "text-compositor[mermaid]"
+# or, if already installed: pipx inject text-compositor playwright==1.62.0
+```
+
+With Option B (clone and run directly):
+
+```bash
+pip install playwright==1.62.0
+```
+
+- **A Google Chrome or Microsoft Edge installation already present on your system** (no new download by default; it's auto-detected and reused at build time)
+- The `playwright` package above (used only to connect to the existing browser via CDP; Playwright's own browser-download feature is not used by default)
+
+Node.js/npm is not required. At build time, the official single-file Mermaid bundle (`mermaid.min.js`, ~3.4MB) is fetched and loaded into a headless browser to convert diagrams to SVG (the bundle JS itself is cached under an OS-standard user cache directory — e.g. `%LOCALAPPDATA%\text-compositor\Cache` on Windows, `~/.cache/text-compositor` on Linux — and conversion results are cached under `.text-compositor/cache/`; neither is re-fetched afterward). None of this is needed for documents that don't use Mermaid.
+
+If no Chrome/Edge is found on the system, the build fails by default. Setting `plugins: { mermaid_auto_download: true }` instead auto-fetches Playwright's own Chromium, but **this download is about 700MB** (this setting exists as a last resort for when no pre-installed browser is available; downloading that much by default is intentionally avoided).
+
+### Using PlantUML diagrams (optional)
+
+No extra `config.yaml` settings are needed to use ` ```plantuml ` fences in your source documents (or to specify a `.puml` file directly in `chapters`) — `plugins.plantuml` defaults to `true` and no additional `pip install` is required.
+
+- If Java (11+) is available locally, it's reused as-is
+- Otherwise, Eclipse Temurin JRE (Adoptium distribution, ~49.7MB) is auto-fetched and cached by default under the same user cache directory as above. Setting `plugins: { plantuml_auto_download: false }` disables the auto-fetch and fails the build instead
+- GitHub Actions' `ubuntu-latest` ships with Java by default, so no extra download happens on CI
+
+The layout engine is the pure-Java Smetana implementation, so no external binary like Graphviz (`dot`) is required. PlantUML itself (MIT edition, ~17.6MB) is cached under the same user cache directory, and conversion results are cached under `.text-compositor/cache/`, same as Mermaid.
+
+### Using D2 diagrams (optional)
+
+No extra `config.yaml` settings are needed to use ` ```d2 ` fences in your source documents (or to specify a `.d2` file directly in `chapters`) — `plugins.d2` defaults to `true` and no additional `pip install` is required.
+
+- If the `d2` command is available locally, it's reused as-is
+- Otherwise, the official D2 CLI binary (a single Go executable, ~13MB) is auto-fetched and cached by default under the same user cache directory as above. Setting `plugins: { d2_auto_download: false }` disables the auto-fetch and fails the build instead
+
+Unlike Java (used by PlantUML) or a browser (used by Mermaid), GitHub Actions' `ubuntu-latest` does not ship with D2 preinstalled, so a `d2` diagram triggers this ~13MB download on every CI run (this project's workflows don't persist the cache directory across separate runs).
+
+## Usage
+
+If installed via `pip`/`pipx` (Option A):
+
+```bash
+text-compositor --config <path/to/text-compositor.config.yaml>
+```
+
+If cloned and run directly (Option B):
+
+```bash
+python build.py --config <path/to/text-compositor.config.yaml>
+```
+
+If `--config` is omitted, `text-compositor.config.yaml` (or `.json`) located directly in the current directory is auto-detected.
+
+```bash
+cd my-project/
+python /path/to/text-compositor/build.py
+```
+
+Run `text-compositor --check-env` (or `python build.py --check-env`) to check your environment (dependencies, Typst version, cached assets, Mermaid/PlantUML/D2 prerequisites) without running a build.
+
+Other flags control runtime behavior only (not document content, which stays entirely in `config.yaml`): `-q`/`--quiet` suppresses `[Info]`-level logging, `-v`/`--verbose` adds extra detail (which chapter is being processed, cache reuse), and `--keep-temp` keeps the intermediate `temp_build.typ` around after a successful build instead of deleting it (useful for debugging; it's always kept after a failed build).
+
+See [sample/text-compositor.config.yaml](sample/text-compositor.config.yaml) for how to write the config file, and the [usage guide](doc/usage/) for details on `document:`/`plugins:`, front matter, Marp directives, and more. The Markdown files listed in `chapters` are concatenated in order to produce the PDF.
+
+## Trying the sample
+
+```bash
+cd sample/
+python ../build.py
+```
+
+This generates `sample/System_Specification.pdf`.
+
+## Implementation status
+
+The core feature implemented so far is combining multiple files into a single PDF according to the config file specified via `--config` (or auto-detected). Expanding CLI options (e.g., overriding the output path) is still in the planning stage. See [GitHub Issues](https://github.com/tokudiro/text-compositor/issues) for known issues and upcoming plans.
+
+## License
+
+[MIT License](LICENSE)

text_compositor-0.2.0/pyproject.toml

@@ -0,0 +1,38 @@
+[build-system]
+requires = ["setuptools>=77.0.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "text-compositor"
+version = "0.2.0"
+description = "A tool for composing multiple text files into a PDF document."
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.10"
+dependencies = [
+    "typst==0.15.0",
+    "markdown-it-py==3.0.0",
+    "mdit-py-plugins==0.6.1",
+    "PyYAML==6.0.2",
+    "platformdirs==4.3.6",
+]
+
+# plugins.mermaid: true（既定）を使う場合のみ必要（11章）。
+# `pip install text-compositor[mermaid]` でまとめて導入できる。
+[project.optional-dependencies]
+mermaid = ["playwright==1.62.0"]
+
+[project.urls]
+Repository = "https://github.com/tokudiro/text-compositor"
+
+# `text-compositor --config ...` コマンドを提供する（#111）。
+# 「クローンして直接叩く」既存の使い方（`python build.py --config ...`）も
+# トップレベルの build.py ラッパー経由で引き続き使える。
+[project.scripts]
+text-compositor = "text_compositor.build:build"
+
+[tool.setuptools]
+packages = ["text_compositor", "text_compositor.templates"]
+
+[tool.setuptools.package-data]
+text_compositor = ["templates/*.typ"]

text_compositor-0.2.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

text_compositor-0.2.0/tests/test_asset_resolution.py

@@ -0,0 +1,73 @@
+"""画像パス解決（_resolve_asset、_resolve_project_image_path）のリグレッションテスト（#96）。
+
+いずれも仕様9章のFail-fast方針どおり、画像欠損時はフォールバックせず即エラー終了する。
+"""
+import os
+
+import pytest
+
+import text_compositor.build as build
+
+
+class TestResolveAsset:
+    """TypstRenderer._resolve_asset(): Markdownファイル基準の相対パスを、
+    temp_build.typの置き場所に依存しないtypst_root起点のルート絶対パスへ変換する。"""
+
+    def _renderer(self, tmp_path):
+        renderer = build.TypstRenderer(line_mapping="off", base_dir=str(tmp_path), typst_root=str(tmp_path))
+        renderer.current_dir = str(tmp_path)
+        renderer.current_file = str(tmp_path / "doc.md")
+        return renderer
+
+    def test_relative_path_resolves_to_root_absolute_path(self, tmp_path):
+        (tmp_path / "images").mkdir()
+        (tmp_path / "images" / "a.png").write_bytes(b"\x89PNG")
+        renderer = self._renderer(tmp_path)
+        assert renderer._resolve_asset("images/a.png") == "/images/a.png"
+
+    def test_root_absolute_path_is_passed_through_unresolved(self, tmp_path):
+        renderer = self._renderer(tmp_path)
+        assert renderer._resolve_asset("/already/absolute.png") == "/already/absolute.png"
+
+    def test_url_is_passed_through_unresolved(self, tmp_path):
+        renderer = self._renderer(tmp_path)
+        assert renderer._resolve_asset("https://example.com/a.png") == "https://example.com/a.png"
+
+    def test_missing_file_exits(self, tmp_path):
+        renderer = self._renderer(tmp_path)
+        with pytest.raises(SystemExit):
+            renderer._resolve_asset("missing.png")
+
+    def test_resolves_relative_to_typst_root_not_base_dir(self, tmp_path):
+        """base_dir（原稿側）とtypst_root（--rootに相当）が異なる場合、ルート絶対パスは
+        typst_root基準で組み立てる（5章）。"""
+        project_dir = tmp_path / "project"
+        project_dir.mkdir()
+        (project_dir / "a.png").write_bytes(b"\x89PNG")
+        renderer = build.TypstRenderer(line_mapping="off", base_dir=str(project_dir), typst_root=str(tmp_path))
+        renderer.current_dir = str(project_dir)
+        renderer.current_file = str(project_dir / "doc.md")
+        assert renderer._resolve_asset("a.png") == "/project/a.png"
+
+
+class TestResolveProjectImagePath:
+    """document.background/logo、chapters[].background/logo（project_dir基準）の解決。"""
+
+    def test_none_path_returns_none(self, tmp_path):
+        assert build._resolve_project_image_path(None, str(tmp_path), str(tmp_path), "Logo") is None
+
+    def test_existing_file_resolves_to_root_absolute_path(self, tmp_path):
+        (tmp_path / "logo.png").write_bytes(b"\x89PNG")
+        result = build._resolve_project_image_path("logo.png", str(tmp_path), str(tmp_path), "Logo")
+        assert result == "/logo.png"
+
+    def test_missing_file_exits(self, tmp_path):
+        with pytest.raises(SystemExit):
+            build._resolve_project_image_path("missing.png", str(tmp_path), str(tmp_path), "Logo")
+
+    def test_resolves_relative_to_typst_root_not_base_dir(self, tmp_path):
+        project_dir = tmp_path / "project"
+        project_dir.mkdir()
+        (project_dir / "logo.png").write_bytes(b"\x89PNG")
+        result = build._resolve_project_image_path("logo.png", str(project_dir), str(tmp_path), "Logo")
+        assert result == "/project/logo.png"

text_compositor-0.2.0/tests/test_config.py

@@ -0,0 +1,65 @@
+"""config.yamlの読み込み・デフォルト値マージ・chaptersエントリ解析のリグレッションテスト（#96）。"""
+import pytest
+
+import text_compositor.build as build
+
+
+class TestDeepUpdate:
+    def test_merges_flat_keys(self):
+        d = {"a": 1, "b": 2}
+        result = build.deep_update(d, {"b": 20, "c": 3})
+        assert result == {"a": 1, "b": 20, "c": 3}
+
+    def test_merges_nested_dict_without_dropping_untouched_keys(self):
+        d = {"document": {"title": "t", "author": "a"}}
+        result = build.deep_update(d, {"document": {"title": "new"}})
+        assert result == {"document": {"title": "new", "author": "a"}}
+
+    def test_overwriting_nested_dict_with_non_dict_replaces_it(self):
+        d = {"a": {"b": 1}}
+        result = build.deep_update(d, {"a": "scalar"})
+        assert result == {"a": "scalar"}
+
+    def test_mutates_and_returns_same_object(self):
+        d = {"a": 1}
+        assert build.deep_update(d, {"b": 2}) is d
+
+
+class TestDefaultConfig:
+    def test_has_expected_top_level_sections(self):
+        config = build.default_config()
+        assert set(config.keys()) == {"document", "output", "template", "inputs"}
+
+    def test_default_line_mapping_is_block(self):
+        assert build.default_config()["document"]["diagnostics"]["line_mapping"] == "block"
+
+    def test_default_template_is_named_template(self):
+        assert build.default_config()["template"]["path"] == "template"
+
+    def test_returns_a_fresh_dict_each_call(self):
+        """既定値を呼び出し元が書き換えても、他の呼び出しに影響しないこと（共有可変状態のバグ防止）。"""
+        a = build.default_config()
+        a["document"]["title"] = "changed"
+        b = build.default_config()
+        assert b["document"]["title"] != "changed"
+
+
+class TestParseChapterEntry:
+    def test_string_entry_is_a_plain_file_chapter(self):
+        assert build._parse_chapter_entry("a.md") == ("a.md", {}, "file")
+
+    def test_dict_with_file_key(self):
+        ch = {"file": "a.md", "landscape": True}
+        assert build._parse_chapter_entry(ch) == ("a.md", ch, "file")
+
+    def test_dict_with_aggregate_key(self):
+        ch = {"aggregate": "data.yaml"}
+        assert build._parse_chapter_entry(ch) == ("data.yaml", ch, "aggregate")
+
+    def test_dict_without_file_or_aggregate_exits(self):
+        with pytest.raises(SystemExit):
+            build._parse_chapter_entry({"landscape": True})
+
+    def test_non_string_non_dict_entry_exits(self):
+        with pytest.raises(SystemExit):
+            build._parse_chapter_entry(123)

text_compositor-0.2.0/tests/test_csv_table.py

@@ -0,0 +1,78 @@
+"""CSVファイルをTypstテーブルへ変換する機能（#36）のリグレッションテスト。"""
+import pytest
+
+import text_compositor.build as build
+
+
+def render_csv(csv_text, filepath="data.csv", table_header_style=None):
+    renderer = build.TypstRenderer(line_mapping="off")
+    if table_header_style is not None:
+        renderer.table_header_style = table_header_style
+    return renderer.render_chapter(csv_text, filepath=filepath)
+
+
+class TestBasicConversion:
+    def test_header_and_rows(self):
+        out = render_csv("name,age\nAlice,30\nBob,25\n")
+        assert out == (
+            "#table(\n"
+            "  columns: 2,\n"
+            "  table.header(\n"
+            "  [name], [age], \n"
+            "  ),\n"
+            "  [Alice], [30], \n"
+            "  [Bob], [25], \n"
+            "  \n"
+            ")\n\n"
+        )
+
+    def test_header_only_no_data_rows(self):
+        out = render_csv("a,b\n")
+        assert out == "#table(\n  columns: 2,\n  table.header(\n  [a], [b], \n  ),\n  \n)\n\n"
+
+
+class TestRfc4180Quoting:
+    def test_quoted_comma_in_cell(self):
+        out = render_csv('a,b\n"1, 2",3\n')
+        assert "[1, 2]" in out
+
+    def test_quoted_newline_in_cell(self):
+        out = render_csv('a\n"line1\nline2"\n')
+        assert "[line1\nline2]" in out
+
+    def test_escaped_quote_char(self):
+        out = render_csv('a\n"she said ""hi"""\n')
+        assert '[she said "hi"]' in out
+
+
+class TestEscaping:
+    def test_typst_special_characters_are_escaped(self):
+        out = render_csv("a\n#tag $x@y\n")
+        assert "[\\#tag \\$x\\@y]" in out
+
+    def test_leading_block_marker_is_escaped(self):
+        out = render_csv("a\n= heading like\n- list like\n")
+        assert "[\\= heading like]" in out
+        assert "[\\- list like]" in out
+
+    def test_content_is_not_parsed_as_markdown(self):
+        out = render_csv("a\n**not bold**\n")
+        assert "[\\*\\*not bold\\*\\*]" in out
+
+
+class TestFailFast:
+    def test_empty_file_exits(self):
+        with pytest.raises(SystemExit):
+            render_csv("")
+
+    def test_uneven_row_exits(self):
+        with pytest.raises(SystemExit):
+            render_csv("a,b\n1,2\n3\n")
+
+
+class TestHeaderStyle:
+    def test_table_header_style_applies(self):
+        out = render_csv("a,b\n1,2\n", table_header_style={"bold": True, "background": "red"})
+        assert "fill: (col, row) => if row == 0 { red } else { none }" in out
+        assert "[#strong[a]]" in out
+        assert "[1], [2]" in out