jtypeset 0.1.0__tar.gz

jtypeset-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,89 @@
+# C++ ライブラリのビルドとテスト（Windows / Linux）
+#
+# vcpkg は lukka/run-vcpkg でセットアップし、CMake の preset（CMakePresets.json）で構成する。
+# テスト用フォントは data/download_fonts.py で取る（無いテストは skip するが、あった方が検査が効く）。
+
+name: ci
+
+on:
+  push:
+    branches: [main, master]
+  pull_request:
+  workflow_dispatch:
+
+jobs:
+  build:
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: windows-latest
+            preset: x64-windows
+            tests: build/x64-windows/tests/Release/typeset_tests.exe
+          - os: ubuntu-latest
+            preset: x64-linux
+            tests: build/x64-linux/tests/typeset_tests
+    runs-on: ${{ matrix.os }}
+    env:
+      VCPKG_ROOT: ${{ github.workspace }}/vcpkg
+      VCPKG_BINARY_SOURCES: "clear;x-gha,readwrite"
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Export GitHub Actions cache environment variables (vcpkg binary cache)
+        uses: actions/github-script@v7
+        with:
+          script: |
+            core.exportVariable('ACTIONS_CACHE_URL', process.env.ACTIONS_CACHE_URL || '');
+            core.exportVariable('ACTIONS_RUNTIME_TOKEN', process.env.ACTIONS_RUNTIME_TOKEN || '');
+
+      - name: Linux packages
+        if: runner.os == 'Linux'
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y ninja-build autoconf automake libtool pkg-config
+
+      - name: Windows packages
+        if: runner.os == 'Windows'
+        run: choco install ninja -y
+
+      # preset は Ninja + cl なので MSVC の環境変数（vcvars）が要る
+      - name: MSVC environment
+        if: runner.os == 'Windows'
+        uses: ilammy/msvc-dev-cmd@v1
+        with:
+          arch: x64
+
+      - uses: lukka/run-vcpkg@v11
+        with:
+          vcpkgDirectory: ${{ github.workspace }}/vcpkg
+          vcpkgJsonGlob: vcpkg.json
+          runVcpkgInstall: false
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Fonts for tests
+        run: python data/download_fonts.py
+
+      - name: Configure
+        shell: bash
+        run: cmake --preset ${{ matrix.preset }} -DTYPESET_BUILD_PYTHON=OFF
+
+      - name: Build
+        shell: bash
+        run: cmake --build build/${{ matrix.preset }} --config Release
+
+      - name: Test
+        shell: bash
+        run: |
+          if [ -f "${{ matrix.tests }}" ]; then "${{ matrix.tests }}"; else ctest --test-dir build/${{ matrix.preset }} -C Release --output-on-failure; fi
+
+      - name: Samples
+        shell: bash
+        run: |
+          for s in sample_inline sample_script sample_novel sample_tech sample_report sample_objects; do
+            exe=$(find build/${{ matrix.preset }} -name "$s" -o -name "$s.exe" | head -1)
+            [ -n "$exe" ] && "$exe" > /dev/null || true
+          done

jtypeset-0.1.0/.github/workflows/docs.yml

@@ -0,0 +1,84 @@
+# ドキュメントサイトを GitHub Pages に配信する
+#
+#   build/site = MkDocs（docs/*.md） + Doxygen（C++ リファレンス → cpp/） + pdoc（Python リファレンス → python/）
+#
+# Python リファレンスには拡張モジュールのビルドが要るので、vcpkg で依存を入れて pip install する。
+# それが失敗してもサイト自体（手引き・C++ リファレンス）は配信する（continue-on-error）。
+# リポジトリの Settings → Pages → Source を "GitHub Actions" にしておく。
+
+name: docs
+
+on:
+  push:
+    branches: [main, master]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: true
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    env:
+      VCPKG_ROOT: ${{ github.workspace }}/vcpkg
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install tools
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y doxygen ninja-build
+          python -m pip install --upgrade pip
+          python -m pip install mkdocs pdoc pybind11-stubgen pybind11 markdown-it-py mdit-py-plugins PyYAML Pygments
+
+      - name: C++ reference (Doxygen)
+        run: |
+          mkdir -p build/docs
+          doxygen docs/Doxyfile
+
+      - name: vcpkg
+        uses: lukka/run-vcpkg@v11
+        with:
+          vcpkgDirectory: ${{ github.workspace }}/vcpkg
+          vcpkgJsonGlob: vcpkg.json
+          runVcpkgInstall: false
+
+      - name: Build Python package
+        id: pybuild
+        continue-on-error: true
+        run: |
+          python -m pip install . --no-deps -v
+
+      - name: Python reference (pdoc)
+        if: steps.pybuild.outcome == 'success'
+        continue-on-error: true
+        run: |
+          mkdir -p build/docs
+          pdoc jtypeset -o build/docs/python --no-show-source
+
+      - name: Site (MkDocs)
+        run: |
+          mkdocs build
+          mkdir -p build/site/cpp build/site/python
+          cp -r build/docs/cpp/html build/site/cpp/
+          if [ -d build/docs/python ]; then cp -r build/docs/python/. build/site/python/; else echo "<p>Python リファレンスはこのビルドでは生成されませんでした。</p>" > build/site/python/index.html; fi
+
+      - uses: actions/upload-pages-artifact@v3
+        with:
+          path: build/site
+
+  deploy:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - id: deployment
+        uses: actions/deploy-pages@v4

jtypeset-0.1.0/.github/workflows/wheels.yml

@@ -0,0 +1,121 @@
+# Python パッケージ jtypeset の wheel / sdist を作り、タグ v* で PyPI に公開する
+#
+# - wheel は cibuildwheel（Windows x64 / Linux x86_64 manylinux / macOS arm64・x86_64、CPython 3.9〜3.13）
+# - 依存は vcpkg。manylinux コンテナでは CIBW_BEFORE_ALL で vcpkg を bootstrap する（freetype / harfbuzz をソースから
+#   ビルドするので初回は時間がかかる。ビルド結果は vcpkg の binary cache に乗らないので毎回 10〜20 分程度）
+# - 公開は PyPI の Trusted Publishing（OIDC）。PyPI 側で publisher（owner: wamsoft, repo: jtypeset,
+#   workflow: wheels.yml, environment: pypi）を登録しておく。API トークンの secret は要らない
+# - 手動実行（workflow_dispatch）では wheel を作るだけで公開しない
+
+name: wheels
+
+on:
+  push:
+    tags: ["v*"]
+  workflow_dispatch:
+
+jobs:
+  sdist:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - run: |
+          python -m pip install build
+          python -m build --sdist
+      - uses: actions/upload-artifact@v4
+        with:
+          name: sdist
+          path: dist/*.tar.gz
+
+  wheels:
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: windows-latest
+            arch: AMD64
+          - os: ubuntu-latest
+            arch: x86_64
+          # macOS は Apple Silicon のランナーで両アーキテクチャを作る（Intel ランナー macos-13 は少なく待ちが長い）。
+          # x86_64 は cibuildwheel のクロスビルド。vcpkg の依存も triplet を x64-osx にして x86_64 で作る
+          - os: macos-14
+            arch: arm64
+            triplet: arm64-osx
+            cmake_arch: arm64
+          - os: macos-14
+            arch: x86_64
+            triplet: x64-osx
+            cmake_arch: x86_64
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      # Windows / macOS はホストに vcpkg を用意する（manylinux はコンテナ内で bootstrap）
+      - uses: lukka/run-vcpkg@v11
+        if: runner.os != 'Linux'
+        with:
+          vcpkgDirectory: ${{ github.workspace }}/vcpkg
+          vcpkgJsonGlob: vcpkg.json
+          runVcpkgInstall: false
+
+      - name: macOS packages
+        if: runner.os == 'macOS'
+        run: brew install ninja autoconf automake libtool pkg-config
+
+      - name: Build wheels
+        uses: pypa/cibuildwheel@v3.2.1
+        env:
+          CIBW_ARCHS: ${{ matrix.arch }}
+          CIBW_BUILD: "cp39-* cp310-* cp311-* cp312-* cp313-*"
+          CIBW_SKIP: "*-musllinux_* *-win32 *_i686"
+          CIBW_MANYLINUX_X86_64_IMAGE: manylinux_2_28
+          # Windows / macOS: ホストの vcpkg
+          CIBW_ENVIRONMENT_WINDOWS: VCPKG_ROOT='${{ github.workspace }}\vcpkg'
+          CIBW_ENVIRONMENT_MACOS: >-
+            VCPKG_ROOT='${{ github.workspace }}/vcpkg'
+            MACOSX_DEPLOYMENT_TARGET=11.0
+            SKBUILD_CMAKE_DEFINE='VCPKG_TARGET_TRIPLET=${{ matrix.triplet }};CMAKE_OSX_ARCHITECTURES=${{ matrix.cmake_arch }}'
+          # Linux: コンテナ内に vcpkg を入れる。vcpkg.json の builtin-baseline のコミットだけを浅く取って
+          # チェックアウトする（Windows / macOS の run-vcpkg と同じコミットになり、再現性が揃う）
+          CIBW_BEFORE_ALL_LINUX: >
+            yum install -y curl zip unzip tar perl-IPC-Cmd ninja-build autoconf automake libtool pkgconfig &&
+            BASE=$(grep -oP '"builtin-baseline":\s*"\K[0-9a-f]+' vcpkg.json) &&
+            echo "vcpkg baseline: $BASE" &&
+            git init /opt/vcpkg &&
+            git -C /opt/vcpkg remote add origin https://github.com/microsoft/vcpkg.git &&
+            git -C /opt/vcpkg fetch --depth 1 origin "$BASE" &&
+            git -C /opt/vcpkg checkout FETCH_HEAD &&
+            /opt/vcpkg/bootstrap-vcpkg.sh -disableMetrics
+          CIBW_ENVIRONMENT_LINUX: VCPKG_ROOT=/opt/vcpkg VCPKG_FORCE_SYSTEM_BINARIES=1
+          CIBW_TEST_REQUIRES: markdown-it-py mdit-py-plugins PyYAML
+          CIBW_TEST_COMMAND: python -c "import jtypeset, jtypeset.md; print(jtypeset.__version__)"
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: wheels-${{ matrix.os }}-${{ matrix.arch }}
+          path: wheelhouse/*.whl
+          compression-level: 0
+
+  publish:
+    if: startsWith(github.ref, 'refs/tags/v')
+    needs: [sdist, wheels]
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/jtypeset
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          path: dist
+          merge-multiple: true
+      - run: ls -la dist
+      - uses: pypa/gh-action-pypi-publish@release/v1

jtypeset-0.1.0/.gitignore

@@ -0,0 +1,15 @@
+build/
+.vscode/
+.claude/
+.venv/
+__pycache__/
+*.egg-info/
+out/
+output*.png
+output*.bmp
+output*.pdf
+output*.svg
+data/*.ttf
+data/*.otf
+build_configure.log
+dist/

jtypeset-0.1.0/CLAUDE.md

@@ -0,0 +1,98 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## 概要
+
+縦書き・横書きの日本語組版（JLReq 水準）を 1 つのエンジンで行い、同一の組版結果をラスタ / PDF / SVG へ出す
+C++17 ライブラリ。用途は台本・小説・技術文書などのツール作成（Python バインディングあり）。
+フォント層は glyphware（FreeType + HarfBuzz）。richtext の縦組みエンジンを書字方向非依存に一般化して移植した。
+**minikin と ICU は使わない**（UAX #14 は libunibreak、双方向は SheenBidi、スクリプト判定は HarfBuzz）。
+
+## ビルド
+
+`VCPKG_ROOT` を設定しておく。glyphware は開発中はローカルツリー（`GLYPHWARE_DIR`）、未指定なら GitHub から FetchContent。
+
+```bash
+make fontdata                                            # テスト用 Noto フォント → data/
+make prebuild GLYPHWARE_DIR=d:/work/kirikiri/glyphware   # CMakeOPT=-DTYPESET_BUILD_PYTHON=ON で Python も
+make build                                               # BUILD_TYPE=Debug も可
+make test                                                # ctest（doctest。リポジトリルートで動く前提）
+./build/x64-windows/Release/sample_tech.exe              # サンプルは必ずリポジトリルートで実行（./data/ を読む）
+```
+
+Bash ツールから直接叩く場合: `cmake --build build/x64-windows --config Release`、
+テストは `./build/x64-windows/tests/Release/typeset_tests.exe`（フォントが無いテストは skip する）。
+
+## レイヤー構造（下から上へ）
+
+```
+font/      FontSet            glyphware の包み。family 列＋文字カバレッジでフォールバック解決。
+                              シェイピング用 hb_font はフォントのバイト列から OT funcs で自前に作る
+                              （glyphware の Face::hb() は hb-ft でピクセルサイズに縛られるので使わない）
+text/      CharClass          JLReq 附属書 A の文字クラス。ASCII の約物は欧文扱い
+           SpacingTable       JLReq 表 3 のアキ量（自然値・伸び・縮み = TeX の glue）
+           orientation        UAX #50（縦組みの正立／横倒し）
+           line_break         libunibreak（UAX #14）。欧文単語内を割らないためだけに使う
+inl/       shaper             Itemizer（スタイル・face・向き）＋ HarfBuzz。正立は TTB、他は LTR
+           item_builder       クラスタ列＋注記 → Box / Glue / Penalty（禁則・ぶら下げ・ルビ・縦中横・圏点・割注・字取り）
+           line_breaker       Greedy / Knuth–Plass。行長は LineShapeProvider::at(lineIndex) で行ごと（\parshape）
+           paragraph          Paragraph → ParagraphFragment（LineBox 列）。charStart からの再開と maxLines。
+                              行内オブジェクト／画像が行送りの箱から出る行は extraBefore/After で送りを広げる
+                              （行位置は lineCenterOffset、消費量は blockExtent。等間隔の pitch × n を仮定しない）
+block/     Block              段落・見出し・罫線・ラベル付き段落・画像・表・セクション、BlockStyle（orphans/widows/keepWithNext/改ページ）
+page/      PageMaster/Region  判型・余白・段。Region は排除領域（回り込み）を持ち RegionLineShape が行の形を返す
+           FlowLayouter       Flow をページ列へ流し込む。柱・ノンブル（{page} {pages} {title}）。
+                              段組ページの途中の段抜きと最終ページの段揃えは、ページの再開点（pageStart_）から段を縮めて
+                              組み直す試行モード（trial_ / trialOverflow_）で行う。再開点には採番状態（pageNumbering_）も持つ。
+                              見出しの採番・図表番号・相互参照（{ref:} {page:}）・目次は 2〜3 パス（RefInfo を次パスへ渡す）。
+                              表は owner グリッド（colspan / rowspan）で罫線を決め、段より高い行はセルごとに続きから分ける。
+                              脚注は段落を組む前に番号を振り、断片に載る注の高さを Region::reserved に確保して finishPage で描く
+dl/        DisplayList        GlyphRun / Path / Rect / Image / Group。レイアウトと backend の分割線
+           glyph_transform    グリフ固有の変形（回転・平体長体・斜体）。3 backend で共有
+backend/   raster             glyphware のカバレッジマスク＋自前合成。パスは自前スキャンライン AA。PNG 出力
+           pdf_writer         Identity-H でグリフ ID 直書き、hb-subset でサブセット化、Flate 圧縮、画像 XObject
+           svg_writer         グリフは <defs>+<use>、画像は data URI
+image/     stb_image 読み込み、PNG エンコード、base64
+obj/       ObjectRegistry     外部オブジェクト（数式・グラフ）の差し込み口。関数ハンドラ／外部コマンド（JSON → SVG）を登録し、
+                              (ハンドラ, ソース, パラメータ, サイズ) でキャッシュ。本体は数式の知識を持たない
+           svg_import         SVG サブセット → dl（path 全コマンド・基本図形・defs/use・transform・塗り線）。
+                              ベースラインは <!-- typeset baseline="pt" --> か vertical-align(ex)
+python/    jtypeset/          パッケージ（PyPI 名 jtypeset）。`_jtypeset`（pybind11 拡張。typeset_module.cpp）を `__init__.py` が再エクスポート。
+                              ビルドツリーでは build/<preset>/python/<Config>/jtypeset/ にまとまる（PYTHONPATH にその親を足す）
+           jtypeset/md/       Markdown → Flow → PDF（markdown-it-py）。CLI `jtypeset-md` / `python -m jtypeset.md`。
+                              front matter の Options、`{#label}` と `{ref:}`、脚注・数式・ルビ記法。pybind の vector 属性は
+                              コピーを返すので Python 側でリストを作って代入する
+handlers/  microtex/          MicroTeX（LaTeX 数式）のサンプルハンドラ。任意ターゲット（TYPESET_HANDLER_MICROTEX、vcpkg feature microtex）。
+                              tex::Font / TextLayout / Graphics2D を実装して数式を GlyphRun + Path で返す。本体は依存しない
+```
+
+## 設計上の約束（変えるときは 設計.md も直す）
+
+- 文書内部の単位は **pt**。座標はページ左上原点・y-down。ラスタは dpi/72 を掛ける
+- 行内は論理座標 **inline_（送り）/ block（行の中心線からのずれ。縦組みは右が正、横組みは下が正）**で組み、
+  物理化は `inl::emitParagraph` / `toPhysical` の 1 箇所。注記の付く側は `annotationSide()`（縦: 右、横: 上）
+- ブロック軸は「**em box の中心＝行の中心線**」。横組みのベースラインは第一候補フォントの ascender/descender から
+  `baselineOffset()` で決め、フォールバック先も同じベースラインに乗せる
+- 和文組版は「1 文字＝1em の箱」ではなく **Box / Glue / Penalty 列を解く**。禁則は Glue の直前の Penalty(∞)、
+  ぶら下げは幅が負の Penalty、和字間には `kanjiSkipStretch` の伸び（追い出し用）
+- 揃えない段落（ragged）では縮みを使わずに収まりを判定する（TeX の ragged-right と同じ）
+- 組版結果は表示リストで切る。backend は組版の知識を持たない。グリフ変形の組み立ては `glyph_transform.hpp` のみ
+- PDF: `Tm` にフォントサイズを入れない（`Tf` が掛ける）。y-down → y-up は Y 反転で共役（シアーの符号が入れ替わる）。
+  縦組みでも Identity-V は使わない
+- Windows の `windows.h` を含むサンプルでは `small` など Windows のマクロ名を変数に使わない
+
+## テストとサンプル
+
+- `tests/` は doctest。組版結果は数値で検算する（禁則違反 0、両端揃えの行長一致、グリフが版面内、ヘッダ行の繰り返し等）。
+  フォントは `data/` から読むので `WORKING_DIRECTORY` はリポジトリルート
+- `samples/sample_inline`（縦横同一文）、`sample_script`（台本）、`sample_novel`（小説 2 段）、`sample_tech`（技術文書：回り込み・表・2 段組）、
+  `sample_dl`（表示リスト直書き）。出力 `output_*.png/.pdf/.svg` はリポジトリルートに出る（gitignore 済み）
+- 3 backend の一致確認は Inkscape で SVG / PDF（`--pdf-poppler`）を PNG にして ImageMagick `compare -metric RMSE`。
+  外接矩形が 1〜2px 以内、RMSE 数%（AA 差）なら一致とみなす
+
+## 参考ドキュメント
+
+- `検討.md` — 既存資産（richtext / glyphware）の棚卸し、設計判断、参照仕様、フェーズ計画、決定事項
+- `設計.md` — 型・処理の流れの具体化
+- `実装.md` — フェーズ別の進捗・確認結果・積み残し（作業を進めたらここを更新する）

jtypeset-0.1.0/CMakeLists.txt

@@ -0,0 +1,156 @@
+cmake_minimum_required(VERSION 3.24)
+
+if(CMAKE_SOURCE_DIR STREQUAL CMAKE_CURRENT_SOURCE_DIR)
+    add_compile_options("$<$<AND:$<C_COMPILER_ID:MSVC>,$<COMPILE_LANGUAGE:C>>:/utf-8>")
+    add_compile_options("$<$<AND:$<CXX_COMPILER_ID:MSVC>,$<COMPILE_LANGUAGE:CXX>>:/utf-8>")
+    add_compile_options("$<$<AND:$<CXX_COMPILER_ID:MSVC>,$<COMPILE_LANGUAGE:CXX>>:/Zc:__cplusplus>")
+endif()
+
+# vcpkg: toolchain が渡されていなければ VCPKG_ROOT から補う（pip / scikit-build-core 経由のビルド用）
+if(NOT CMAKE_TOOLCHAIN_FILE AND DEFINED ENV{VCPKG_ROOT} AND EXISTS "$ENV{VCPKG_ROOT}/scripts/buildsystems/vcpkg.cmake")
+    set(CMAKE_TOOLCHAIN_FILE "$ENV{VCPKG_ROOT}/scripts/buildsystems/vcpkg.cmake" CACHE FILEPATH "vcpkg toolchain")
+endif()
+
+project(typeset VERSION 0.1.0 LANGUAGES C CXX)
+
+set(CMAKE_CXX_STANDARD 17)
+set(CMAKE_CXX_STANDARD_REQUIRED ON)
+set(CMAKE_CXX_EXTENSIONS OFF)
+
+option(TYPESET_BUILD_SAMPLES "Build sample executables" ${PROJECT_IS_TOP_LEVEL})
+option(TYPESET_BUILD_TESTS "Build unit tests (doctest)" ${PROJECT_IS_TOP_LEVEL})
+option(TYPESET_BUILD_PYTHON "Build pybind11 Python bindings" OFF)
+option(TYPESET_HANDLER_MICROTEX "Build the MicroTeX (LaTeX math) object handler (default ON; tinyxml2 from vcpkg, MicroTeX via FetchContent)" ON)
+
+if(TYPESET_BUILD_PYTHON)
+    # 拡張モジュールに静的ライブラリをリンクするので全部 PIC にする
+    set(CMAKE_POSITION_INDEPENDENT_CODE ON)
+endif()
+
+#------------------------------------------------------------------------------
+# 依存
+#------------------------------------------------------------------------------
+find_package(Freetype REQUIRED)
+find_package(harfbuzz CONFIG REQUIRED)
+find_package(ZLIB REQUIRED)
+find_package(libunibreak CONFIG REQUIRED)
+find_path(STB_INCLUDE_DIRS "stb_image.h" REQUIRED)
+
+# glyphware（フォントエンジン）。GLYPHWARE_DIR でローカルツリーを指すか、
+# 未指定なら GitHub から FetchContent で取る（cmake/glyphware.cmake）
+include(cmake/glyphware.cmake)
+
+#------------------------------------------------------------------------------
+# ライブラリ本体
+#------------------------------------------------------------------------------
+set(TYPESET_SOURCES
+    src/geom.cpp
+    src/font/font_set.cpp
+    src/dl/display_list.cpp
+    src/image/image.cpp
+    src/obj/object.cpp
+    src/obj/svg_import.cpp
+    # text: Unicode / JLReq のテーブル
+    src/text/utf.cpp
+    src/text/char_class.cpp
+    src/text/spacing_table.cpp
+    src/text/orientation.cpp
+    src/text/line_break.cpp
+    # inl: インライン組版
+    src/inl/shaper.cpp
+    src/inl/annotation.cpp
+    src/inl/item_builder.cpp
+    src/inl/line_breaker.cpp
+    src/inl/paragraph_layouter.cpp
+    # page: ブロック／ページ
+    src/page/page.cpp
+    src/page/flow_layouter.cpp
+    src/backend/raster.cpp
+    src/backend/path_raster.cpp
+    src/backend/sfnt_info.cpp
+    src/backend/pdf_writer.cpp
+    src/backend/svg_writer.cpp
+)
+
+add_library(typeset STATIC ${TYPESET_SOURCES})
+add_library(typeset::typeset ALIAS typeset)
+
+target_include_directories(typeset
+    PUBLIC
+        $<BUILD_INTERFACE:${CMAKE_CURRENT_SOURCE_DIR}/include>
+        $<INSTALL_INTERFACE:include>
+    PRIVATE
+        ${STB_INCLUDE_DIRS}
+)
+target_link_libraries(typeset
+    PUBLIC
+        glyphware::glyphware
+    PRIVATE
+        Freetype::Freetype
+        harfbuzz::harfbuzz
+        harfbuzz::harfbuzz-subset
+        ZLIB::ZLIB
+        libunibreak::libunibreak
+)
+
+if(MSVC)
+    target_compile_definitions(typeset PUBLIC NOMINMAX)
+    target_compile_options(typeset PRIVATE /W3 /permissive-)
+else()
+    target_compile_options(typeset PRIVATE -Wall -Wextra)
+endif()
+
+#------------------------------------------------------------------------------
+# サンプル
+#------------------------------------------------------------------------------
+if(TYPESET_BUILD_SAMPLES)
+    add_executable(sample_dl samples/sample_dl.cpp)
+    target_link_libraries(sample_dl PRIVATE typeset)
+
+    add_executable(sample_inline samples/sample_inline.cpp)
+    target_link_libraries(sample_inline PRIVATE typeset)
+
+    add_executable(sample_script samples/sample_script.cpp)
+    target_link_libraries(sample_script PRIVATE typeset)
+
+    add_executable(sample_novel samples/sample_novel.cpp)
+    target_link_libraries(sample_novel PRIVATE typeset)
+
+    add_executable(sample_tech samples/sample_tech.cpp)
+    target_link_libraries(sample_tech PRIVATE typeset)
+
+    add_executable(sample_objects samples/sample_objects.cpp)
+    target_link_libraries(sample_objects PRIVATE typeset)
+
+    add_executable(sample_report samples/sample_report.cpp)
+    target_link_libraries(sample_report PRIVATE typeset)
+endif()
+
+#------------------------------------------------------------------------------
+# テスト
+#------------------------------------------------------------------------------
+if(TYPESET_BUILD_TESTS)
+    enable_testing()
+    add_subdirectory(tests)
+endif()
+
+#------------------------------------------------------------------------------
+# Python バインド
+#------------------------------------------------------------------------------
+if(TYPESET_HANDLER_MICROTEX)
+    add_subdirectory(handlers/microtex)
+endif()
+
+# リファレンス（Doxygen があれば）: cmake --build <build> --target docs → build/docs/cpp/html/index.html
+find_package(Doxygen QUIET)
+if(DOXYGEN_FOUND)
+    add_custom_target(docs
+        COMMAND ${DOXYGEN_EXECUTABLE} ${CMAKE_SOURCE_DIR}/docs/Doxyfile
+        WORKING_DIRECTORY ${CMAKE_SOURCE_DIR}
+        COMMENT "Doxygen: C++ reference → build/docs/cpp"
+        VERBATIM)
+endif()
+
+if(TYPESET_BUILD_PYTHON)
+    add_subdirectory(python)
+endif()