Phase 1: 基盤の刷新と不具合修正

.github/workflows/tests.yml

@@ -0,0 +1,63 @@
+name: tests
+
+on:
+  push:
+  pull_request:
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  unit:
+    name: unit
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+      - uses: astral-sh/setup-uv@c18668ad3cf93ea998bef934396af7bb5c839dc7 # v10.2.0
+        with:
+          enable-cache: true
+      - run: uv sync --locked
+      - run: uv run pytest
+
+  e2e:
+    name: e2e
+    # push では実行しない（pull_request と手動実行のみ）
+    if: github.event_name == 'pull_request' || github.event_name == 'workflow_dispatch'
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+      # GitHub Pages (legacy build) と同じ Jekyll ビルドで _site を作る
+      - uses: actions/jekyll-build-pages@44a6e6beabd48582f863aeeb6cb2151cc1716697 # v1.0.13
+        with:
+          source: ./
+          destination: ./_site
+      - uses: astral-sh/setup-uv@c18668ad3cf93ea998bef934396af7bb5c839dc7 # v10.2.0
+        with:
+          enable-cache: true
+      - run: uv sync --locked
+      - run: uv run playwright install --with-deps chromium
+      # Pages と同じ /matplotlib_gui/ サブパス配下で配信して検証する
+      - name: Run E2E tests
+        env:
+          E2E_SERVE_DIR: _site
+          E2E_BASE_PATH: /matplotlib_gui/
+        run: uv run pytest tests/e2e --tracing retain-on-failure --output test-results
+      - name: Upload Playwright traces
+        if: failure()
+        uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2
+        with:
+          name: test-results
+          path: test-results/
+          if-no-files-found: ignore
+          retention-days: 7

.gitignore

@@ -0,0 +1,10 @@
+.venv/
+__pycache__/
+.pytest_cache/
+test-results/
+*.pyc
+.DS_Store
+# ベンチマークの出力・生成データ
+tests/perf/out/
+tests/perf/.tmp/
+_site/

.python-version

@@ -0,0 +1 @@
+3.14

README.md

@@ -1,15 +1,57 @@
-# matplotlib browser GUI
+# Matplotlib GUI
 
-`index.html`をブラウザで開くだけで、`matplotlib`をGUI操作できます。
+CSV / TXT / XLSX のデータから、ブラウザ上の操作だけで matplotlib の図を作るツールです。サーバーを使わず、Python（PyScript / Pyodide）をブラウザの中で実行します。
 
 ## 使い方
 
-1. `index.html` をブラウザで開く
-2. `.xlsx/.csv/.txt` を選択
-3. 必要なら区切り文字や列を指定
-4. `描画する` を押す
+https://mioupa.github.io/matplotlib_gui/ を開いてください。`index.html` を `file://` で直接開く使い方には対応していません。
 
-## 注意
+1. 「入力ファイル」で `.csv` / `.txt` / `.xlsx` を選びます。
+2. 読み込みと描画は自動で行われます（「描画する」ボタンはありません）。設定を変えると、すぐ再描画されます。
+3. 「描画系列」でX列・Y列・色などを選び、必要なら系列を追加します。
+4. 「保存設定」でファイル名と形式を選び、「保存する」で書き出します。
 
-- 初回はブラウザ側のPythonパッケージ読込で時間がかかることがあります。
-- 完全ブラウザ実行のため、サーバー起動は不要です。
+対応する文字コードは UTF-8、UTF-8（BOM付き）、Shift_JIS（CP932）、EUC-JP です。判定した文字コードは、読み込み後に画面へ表示されます。
+
+## 主な機能
+
+- 系列カード（複数系列、X/Y列、色、線幅、線種、点サイズ、凡例名）と、第2Y軸
+- プロット種別: line / scatter / bar
+- 軸の対数表示と範囲指定、余白指定、主目盛線・副目盛線、凡例位置
+- 保存: png / jpg / svg / pdf、背景透過
+- データ確認タブ: 先頭100行を表示し、描画から除外される先頭行をグレーで表示
+- Pythonコード(beta)タブ: 描画用コードの確認と実行（Phase 2 で作り替え予定）
+- 数値に変換できず除外した値の警告、日本語のエラーメッセージ
+
+## プライバシー
+
+読み込んだデータの処理はすべてブラウザの中で行い、外部には送信しません。外部への通信は、ライブラリ（PyScript / Pyodide / pandas / matplotlib など）とフォントの取得だけです。通信先は次のとおりです。
+
+| ホスト | 取得するもの |
+|---|---|
+| `pyscript.net` | PyScript 本体 |
+| `cdn.jsdelivr.net` | Pyodide 本体と同梱パッケージ（pandas / matplotlib など）、画面用フォント（Noto Sans JP）、グラフ用の日本語フォント（Noto Sans CJK JP） |
+| `files.pythonhosted.org` | openpyxl の wheel（`.xlsx` を初めて開くときだけ） |
+
+初回の訪問では、Pyodide とライブラリ（数十 MB）と、日本語フォント（約 16 MB）をダウンロードするため、時間がかかります。2回目以降はキャッシュを使います（フォントはブラウザの Cache Storage に保存し、再ダウンロードしません）。
+
+## 開発
+
+開発用の依存は [uv](https://docs.astral.sh/uv/) で管理します（実行時には使いません）。
+
+```sh
+uv sync
+uv run playwright install chromium
+uv run pytest                 # 単体テスト
+uv run pytest tests/e2e       # E2E テスト（Chromium で実際に動かす）
+uv run python -m http.server  # ローカルで確認: http://localhost:8000/
+uv run python tests/perf/bench.py --reps 5   # 起動・描画の計測（結果は docs/PERFORMANCE.md）
+```
+
+CI（GitHub Actions）は、push のたびに単体テストを、プルリクエストのたびに E2E テストを実行します。E2E は Pages と同じ Jekyll ビルドの結果を `/matplotlib_gui/` 配下で配信して検証します。
+
+要件は `docs/REQUIREMENTS.md`、AI エージェント向けの引き継ぎ情報は `AGENTS.md` にあります。
+
+## ライセンス
+
+[LICENSE.md](LICENSE.md)（MIT License）を参照してください。

_config.yml

@@ -0,0 +1,13 @@
+# GitHub Pages (Jekyll) の配信設定
+# Jekyll は "_" で始まるファイルを既定で配信しないため、Python パッケージの __init__.py だけ明示的に含める
+include:
+  - __init__.py
+# 開発用のファイルはリポジトリには置くが、Pages では配信しない
+exclude:
+  - docs/
+  - AGENTS.md
+  - tests/
+  - pyproject.toml
+  - uv.lock
+  - .python-version
+  - .github/