jpoke 0.1.0__tar.gz

jpoke-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 tmwork1
+
+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.

jpoke-0.1.0/MANIFEST.in

@@ -0,0 +1,5 @@
+prune tests
+prune docs
+prune scripts
+prune .claude
+prune .loop

jpoke-0.1.0/PKG-INFO

@@ -0,0 +1,226 @@
+Metadata-Version: 2.4
+Name: jpoke
+Version: 0.1.0
+Summary: Event-driven Pokemon Champions single-battle simulation library (unofficial)
+Author-email: Tomoo Mari <tmtm.holmes@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/tmwork1/jpoke
+Project-URL: Repository, https://github.com/tmwork1/jpoke
+Project-URL: Issues, https://github.com/tmwork1/jpoke/issues
+Project-URL: Changelog, https://github.com/tmwork1/jpoke/blob/main/CHANGELOG.md
+Keywords: pokemon,battle,simulator,bot
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Games/Entertainment :: Turn Based Strategy
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Operating System :: OS Independent
+Classifier: Natural Language :: Japanese
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# jpoke
+
+ポケモンバトルシミュレーション開発用の Python ライブラリ。イベント駆動でポケモンの技・特性・アイテム・
+状態異常・場の効果などを再現し、bot 開発や乱数調整・ダメージ計算・木探索などの用途に使う。
+
+jpoke is an event-driven Python library for simulating Pokémon Champions single battles, reproducing
+moves, abilities, items, status conditions, and field effects. It targets bot development, RNG tuning,
+damage calculation, and tree search.
+
+> 本プロジェクトは株式会社ポケモン・任天堂・株式会社ゲームフリークとは無関係の非公式（fan-made）
+> プロジェクトです。
+> This is an unofficial, fan-made project and is not affiliated with, endorsed by, or sponsored by
+> Nintendo, Game Freak, or The Pokémon Company.
+
+## 対象範囲
+
+- **対象はポケモンチャンピオンズのシングルバトルのみ**（ダブルバトル等は対象外）
+- 技・特性・アイテム・ポケモンなどの仕様ソースは **第9世代（スカーレット・バイオレット）** を基本とし、
+  ポケモンチャンピオンズ側でルールが異なる場合はそちらを優先する
+- 第9世代で実装されていない技・アイテム・特性・ポケモンなどは実装しない
+
+このプロジェクトの規約・アーキテクチャの詳細は
+[CLAUDE.md](https://github.com/tmwork1/jpoke/blob/main/CLAUDE.md) を参照（この README の対象範囲の
+定義を正とし、CLAUDE.md 側はこの記述を参照する）。
+
+## インストール
+
+```bash
+pip install jpoke
+```
+
+`requires-python = ">=3.10"`。型アノテーションは Python 3.10+ の構文（`X | Y`, `list[X]`）を使用する。
+
+バージョニングは [Semantic Versioning](https://semver.org/lang/ja/) に準拠するが、0.x 系の間は
+minor バージョンの更新（例: 0.1.0 → 0.2.0）でも破壊的変更が入る場合がある。変更履歴は
+[CHANGELOG.md](https://github.com/tmwork1/jpoke/blob/main/CHANGELOG.md) を参照。
+
+## クイックスタート
+
+もっとも低レベルな API（`Battle` / `Player` / `Pokemon`）だけを使った最小例:
+
+```python
+from jpoke import Battle, Player, Pokemon
+
+player1 = Player("Player 1")
+player1.team.append(Pokemon("ピカチュウ", move_names=["でんこうせっか"]))
+player2 = Player("Player 2")
+player2.team.append(Pokemon("フシギダネ", move_names=["たいあたり"]))
+
+# n_selected: 選出数（チームが1匹だけの場合は1にする。デフォルトは3）
+battle = Battle((player1, player2), n_selected=1)
+battle.start()
+
+while battle.judge_winner() is None and battle.turn < 100:
+    # commands=None の場合は各 Player.choose_command() が使われる
+    # （デフォルト実装は利用可能な最初のコマンドを選ぶだけの単純なプレイヤー）
+    battle.step()
+
+print(battle.judge_winner().username)   # 勝者の名前
+battle.print_logs()                 # このターンのログを表示
+```
+
+## アーキテクチャ
+
+イベント駆動モデルを採用している:
+
+1. バトルロジックが `Event` を発火する
+2. `EventManager` が登録済み `Handler` を優先度順に呼び出す
+3. 各 `Handler` は `HandlerReturn(value, stop_event)` を返す
+4. ハンドラの登録は `data/ability.py`, `data/item.py`, `data/move.py` などで行う
+
+| クラス／モジュール | 役割 |
+|---|---|
+| `core/battle.py` `Battle` | バトル全体の状態管理・ターン進行 |
+| `core/turn_controller.py` | ターン順・行動順の制御 |
+| `core/event_manager.py` | イベント発火・ハンドラ呼び出し |
+| `core/handler.py` `Handler` | ハンドラ定義（subject, subject_spec, 関数） |
+| `core/context.py` `BaseContext` / `EventContext` / `AttackContext` | ハンドラに渡すイベントコンテキスト（攻撃フローは `AttackContext`、それ以外は `EventContext`） |
+| `model/` | `Pokemon`, `Move`, `Field` などのモデル |
+| `data/` | `ability.py`, `move.py`, `item.py` など — 各エンティティのデータ定義とハンドラ登録 |
+| `handlers/` | `ability.py`, `ability_paradox.py`, `ailment.py`, `field.py`, `item.py`, `lethal.py`, `move.py`, `move_attack.py`, `move_status.py`, `volatile.py` など — ハンドラ実装 |
+| `enums/` | `Event`, `Command`, `Interrupt`, `LogCode` |
+| `types/` | `Stat`, `Type`, `AilmentName`, `VolatileName` など Literal 型の定義 |
+
+技データ（`data/move.py`）は五十音の行ごとに `data/moves/move_<行>.py` へ分割されている
+（`data/move.py` はそれらを統合する薄いファイル）。
+
+## ドキュメント
+
+| ディレクトリ | 役割 |
+|---|---|
+| `docs/spec/` | 技・アイテム・特性・場の効果の挙動仕様 |
+| `docs/plan/` | 実行計画と優先順位 |
+| `docs/progress/` | カテゴリ別の実装追跡（`ability.md`, `item.md`, `move.md` 等） |
+| `docs/tests/` | テスト一覧（`scripts/generate_test_list.py` で生成） |
+
+## 実装状況
+
+`docs/progress/*.md` に基づく件数（データ定義済みの実数、内部用の空エントリ等を除く）:
+
+| カテゴリ | 件数 |
+|---|---|
+| 特性（ability） | 310 |
+| アイテム（item） | 247 |
+| 技（move） | 733 |
+| 揮発性状態（volatile） | 66 |
+| 状態異常（ailment） | 7 |
+| 場の効果（field: 天候・地形・グローバル・サイド） | 31 |
+
+最新の詳細は `docs/progress/` 配下の各ファイルを参照。
+
+## 開発（clone 前提）
+
+ソースを直接編集する場合や、テストヘルパーを使ってピンポイントな状態検証をしたい場合は
+リポジトリを clone してセットアップする。
+
+```bash
+git clone https://github.com/tmwork1/jpoke.git
+cd jpoke
+pip install -e .
+
+# 開発（テスト・lint・型チェック）に必要な依存を含める場合
+pip install -e . pytest pytest-cov ruff mypy
+# または uv を使う場合
+uv sync
+```
+
+### テストヘルパーを使った検証
+
+任意ターンでのピンポイントな状態検証や技の実行など、クイックスタートより細かい制御をしたい場合は
+`tests/test_utils.py` のヘルパー（`start_battle` / `run_move` / `run_switch` 等）が便利。
+これはテスト用のヘルパーだが、プロジェクトルートから実行すれば（`tests/` が import できる状態）
+通常のスクリプトからも使える。詳細な使い方は
+[tests/CLAUDE.md](https://github.com/tmwork1/jpoke/blob/main/tests/CLAUDE.md) を参照:
+
+```python
+# プロジェクトルートから実行する想定（tests/ が import できる状態）
+from jpoke import Pokemon
+from tests import test_utils as t
+
+battle = t.start_battle(
+    team0=[Pokemon("ピカチュウ", ability_name="せいでんき", move_names=["でんこうせっか"])],
+    team1=[Pokemon("カビゴン", move_names=["たいあたり"])],
+    accuracy=100,  # 命中率を固定して再現性を上げる
+)
+t.run_move(battle, atk_idx=0, move_idx=0)
+```
+
+## テストの実行
+
+```bash
+# 全テスト
+python -m pytest tests/ -v
+
+# カテゴリ別
+python -m pytest tests/abilities/ -v
+python -m pytest tests/items/ -v
+python -m pytest tests/moves_attack/ -v
+python -m pytest tests/moves_status/ -v
+python -m pytest tests/volatiles/ -v
+
+# 特定ファイル
+python -m pytest tests/abilities/test_ability_ka.py -v
+
+# 特定テスト関数（日本語関数名も可）
+python -m pytest tests/abilities/ -k "ARシステム" -v
+
+# カバレッジ付き
+python -m pytest tests/ -q --cov=jpoke --cov-report=term
+```
+
+テストは `tests/` 直下（`test_ailment.py`, `test_copy.py`, `test_damage.py`, `test_field.py`,
+`test_lethal.py` など）とサブディレクトリ（`abilities/`, `items/`, `moves_attack/`,
+`moves_status/`, `volatiles/`）に分かれている。`tests/test_utils.py` はテストヘルパー（テスト対象外）。
+
+## 開発ツール
+
+```bash
+# lint
+python -m ruff check src/ tests/ scripts/
+
+# 型チェック（src/jpoke/core のみを対象に段階導入中）
+python -m mypy
+
+# 五十音順の維持・データ整合性チェック（--check は変更せず確認のみ）
+python scripts/sort_handlers.py --check
+python scripts/sort_data/sort_abilities.py --check
+python scripts/sort_data/sort_items.py --check
+python scripts/sort_data/sort_moves.py --check
+python scripts/sort_tests.py --check tests/**/test_*.py
+```
+
+CI（`.github/workflows/test.yml`）で push/PR ごとに Windows + Linux × Python 3.10/3.12 のマトリクスで
+テスト・lint・型チェックを実行する。`.github/workflows/nightly-fuzz.yml` が毎日 `scripts/fuzz_battle.py`
+を random / tree_search の両プレイヤーモデル（`--player`）で実行し、回帰シードを検出する。`.pre-commit-config.yaml` を使うと
+コミット前にこれらのチェック（の一部）をローカルで実行できる。
+
+## ライセンス
+
+MIT License

jpoke-0.1.0/README.md

@@ -0,0 +1,200 @@
+# jpoke
+
+ポケモンバトルシミュレーション開発用の Python ライブラリ。イベント駆動でポケモンの技・特性・アイテム・
+状態異常・場の効果などを再現し、bot 開発や乱数調整・ダメージ計算・木探索などの用途に使う。
+
+jpoke is an event-driven Python library for simulating Pokémon Champions single battles, reproducing
+moves, abilities, items, status conditions, and field effects. It targets bot development, RNG tuning,
+damage calculation, and tree search.
+
+> 本プロジェクトは株式会社ポケモン・任天堂・株式会社ゲームフリークとは無関係の非公式（fan-made）
+> プロジェクトです。
+> This is an unofficial, fan-made project and is not affiliated with, endorsed by, or sponsored by
+> Nintendo, Game Freak, or The Pokémon Company.
+
+## 対象範囲
+
+- **対象はポケモンチャンピオンズのシングルバトルのみ**（ダブルバトル等は対象外）
+- 技・特性・アイテム・ポケモンなどの仕様ソースは **第9世代（スカーレット・バイオレット）** を基本とし、
+  ポケモンチャンピオンズ側でルールが異なる場合はそちらを優先する
+- 第9世代で実装されていない技・アイテム・特性・ポケモンなどは実装しない
+
+このプロジェクトの規約・アーキテクチャの詳細は
+[CLAUDE.md](https://github.com/tmwork1/jpoke/blob/main/CLAUDE.md) を参照（この README の対象範囲の
+定義を正とし、CLAUDE.md 側はこの記述を参照する）。
+
+## インストール
+
+```bash
+pip install jpoke
+```
+
+`requires-python = ">=3.10"`。型アノテーションは Python 3.10+ の構文（`X | Y`, `list[X]`）を使用する。
+
+バージョニングは [Semantic Versioning](https://semver.org/lang/ja/) に準拠するが、0.x 系の間は
+minor バージョンの更新（例: 0.1.0 → 0.2.0）でも破壊的変更が入る場合がある。変更履歴は
+[CHANGELOG.md](https://github.com/tmwork1/jpoke/blob/main/CHANGELOG.md) を参照。
+
+## クイックスタート
+
+もっとも低レベルな API（`Battle` / `Player` / `Pokemon`）だけを使った最小例:
+
+```python
+from jpoke import Battle, Player, Pokemon
+
+player1 = Player("Player 1")
+player1.team.append(Pokemon("ピカチュウ", move_names=["でんこうせっか"]))
+player2 = Player("Player 2")
+player2.team.append(Pokemon("フシギダネ", move_names=["たいあたり"]))
+
+# n_selected: 選出数（チームが1匹だけの場合は1にする。デフォルトは3）
+battle = Battle((player1, player2), n_selected=1)
+battle.start()
+
+while battle.judge_winner() is None and battle.turn < 100:
+    # commands=None の場合は各 Player.choose_command() が使われる
+    # （デフォルト実装は利用可能な最初のコマンドを選ぶだけの単純なプレイヤー）
+    battle.step()
+
+print(battle.judge_winner().username)   # 勝者の名前
+battle.print_logs()                 # このターンのログを表示
+```
+
+## アーキテクチャ
+
+イベント駆動モデルを採用している:
+
+1. バトルロジックが `Event` を発火する
+2. `EventManager` が登録済み `Handler` を優先度順に呼び出す
+3. 各 `Handler` は `HandlerReturn(value, stop_event)` を返す
+4. ハンドラの登録は `data/ability.py`, `data/item.py`, `data/move.py` などで行う
+
+| クラス／モジュール | 役割 |
+|---|---|
+| `core/battle.py` `Battle` | バトル全体の状態管理・ターン進行 |
+| `core/turn_controller.py` | ターン順・行動順の制御 |
+| `core/event_manager.py` | イベント発火・ハンドラ呼び出し |
+| `core/handler.py` `Handler` | ハンドラ定義（subject, subject_spec, 関数） |
+| `core/context.py` `BaseContext` / `EventContext` / `AttackContext` | ハンドラに渡すイベントコンテキスト（攻撃フローは `AttackContext`、それ以外は `EventContext`） |
+| `model/` | `Pokemon`, `Move`, `Field` などのモデル |
+| `data/` | `ability.py`, `move.py`, `item.py` など — 各エンティティのデータ定義とハンドラ登録 |
+| `handlers/` | `ability.py`, `ability_paradox.py`, `ailment.py`, `field.py`, `item.py`, `lethal.py`, `move.py`, `move_attack.py`, `move_status.py`, `volatile.py` など — ハンドラ実装 |
+| `enums/` | `Event`, `Command`, `Interrupt`, `LogCode` |
+| `types/` | `Stat`, `Type`, `AilmentName`, `VolatileName` など Literal 型の定義 |
+
+技データ（`data/move.py`）は五十音の行ごとに `data/moves/move_<行>.py` へ分割されている
+（`data/move.py` はそれらを統合する薄いファイル）。
+
+## ドキュメント
+
+| ディレクトリ | 役割 |
+|---|---|
+| `docs/spec/` | 技・アイテム・特性・場の効果の挙動仕様 |
+| `docs/plan/` | 実行計画と優先順位 |
+| `docs/progress/` | カテゴリ別の実装追跡（`ability.md`, `item.md`, `move.md` 等） |
+| `docs/tests/` | テスト一覧（`scripts/generate_test_list.py` で生成） |
+
+## 実装状況
+
+`docs/progress/*.md` に基づく件数（データ定義済みの実数、内部用の空エントリ等を除く）:
+
+| カテゴリ | 件数 |
+|---|---|
+| 特性（ability） | 310 |
+| アイテム（item） | 247 |
+| 技（move） | 733 |
+| 揮発性状態（volatile） | 66 |
+| 状態異常（ailment） | 7 |
+| 場の効果（field: 天候・地形・グローバル・サイド） | 31 |
+
+最新の詳細は `docs/progress/` 配下の各ファイルを参照。
+
+## 開発（clone 前提）
+
+ソースを直接編集する場合や、テストヘルパーを使ってピンポイントな状態検証をしたい場合は
+リポジトリを clone してセットアップする。
+
+```bash
+git clone https://github.com/tmwork1/jpoke.git
+cd jpoke
+pip install -e .
+
+# 開発（テスト・lint・型チェック）に必要な依存を含める場合
+pip install -e . pytest pytest-cov ruff mypy
+# または uv を使う場合
+uv sync
+```
+
+### テストヘルパーを使った検証
+
+任意ターンでのピンポイントな状態検証や技の実行など、クイックスタートより細かい制御をしたい場合は
+`tests/test_utils.py` のヘルパー（`start_battle` / `run_move` / `run_switch` 等）が便利。
+これはテスト用のヘルパーだが、プロジェクトルートから実行すれば（`tests/` が import できる状態）
+通常のスクリプトからも使える。詳細な使い方は
+[tests/CLAUDE.md](https://github.com/tmwork1/jpoke/blob/main/tests/CLAUDE.md) を参照:
+
+```python
+# プロジェクトルートから実行する想定（tests/ が import できる状態）
+from jpoke import Pokemon
+from tests import test_utils as t
+
+battle = t.start_battle(
+    team0=[Pokemon("ピカチュウ", ability_name="せいでんき", move_names=["でんこうせっか"])],
+    team1=[Pokemon("カビゴン", move_names=["たいあたり"])],
+    accuracy=100,  # 命中率を固定して再現性を上げる
+)
+t.run_move(battle, atk_idx=0, move_idx=0)
+```
+
+## テストの実行
+
+```bash
+# 全テスト
+python -m pytest tests/ -v
+
+# カテゴリ別
+python -m pytest tests/abilities/ -v
+python -m pytest tests/items/ -v
+python -m pytest tests/moves_attack/ -v
+python -m pytest tests/moves_status/ -v
+python -m pytest tests/volatiles/ -v
+
+# 特定ファイル
+python -m pytest tests/abilities/test_ability_ka.py -v
+
+# 特定テスト関数（日本語関数名も可）
+python -m pytest tests/abilities/ -k "ARシステム" -v
+
+# カバレッジ付き
+python -m pytest tests/ -q --cov=jpoke --cov-report=term
+```
+
+テストは `tests/` 直下（`test_ailment.py`, `test_copy.py`, `test_damage.py`, `test_field.py`,
+`test_lethal.py` など）とサブディレクトリ（`abilities/`, `items/`, `moves_attack/`,
+`moves_status/`, `volatiles/`）に分かれている。`tests/test_utils.py` はテストヘルパー（テスト対象外）。
+
+## 開発ツール
+
+```bash
+# lint
+python -m ruff check src/ tests/ scripts/
+
+# 型チェック（src/jpoke/core のみを対象に段階導入中）
+python -m mypy
+
+# 五十音順の維持・データ整合性チェック（--check は変更せず確認のみ）
+python scripts/sort_handlers.py --check
+python scripts/sort_data/sort_abilities.py --check
+python scripts/sort_data/sort_items.py --check
+python scripts/sort_data/sort_moves.py --check
+python scripts/sort_tests.py --check tests/**/test_*.py
+```
+
+CI（`.github/workflows/test.yml`）で push/PR ごとに Windows + Linux × Python 3.10/3.12 のマトリクスで
+テスト・lint・型チェックを実行する。`.github/workflows/nightly-fuzz.yml` が毎日 `scripts/fuzz_battle.py`
+を random / tree_search の両プレイヤーモデル（`--player`）で実行し、回帰シードを検出する。`.pre-commit-config.yaml` を使うと
+コミット前にこれらのチェック（の一部）をローカルで実行できる。
+
+## ライセンス
+
+MIT License

jpoke-0.1.0/pyproject.toml

@@ -0,0 +1,92 @@
+[project]
+name = "jpoke"
+version = "0.1.0"
+description = "Event-driven Pokemon Champions single-battle simulation library (unofficial)"
+authors = [
+    { name = "Tomoo Mari", email = "tmtm.holmes@gmail.com" }
+]
+license = "MIT"
+license-files = ["LICENSE"]
+readme = "README.md"
+requires-python = ">=3.10"
+dependencies = []
+keywords = ["pokemon", "battle", "simulator", "bot"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Topic :: Games/Entertainment :: Turn Based Strategy",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Operating System :: OS Independent",
+    "Natural Language :: Japanese",
+    "Typing :: Typed",
+]
+
+[project.urls]
+Homepage = "https://github.com/tmwork1/jpoke"
+Repository = "https://github.com/tmwork1/jpoke"
+Issues = "https://github.com/tmwork1/jpoke/issues"
+Changelog = "https://github.com/tmwork1/jpoke/blob/main/CHANGELOG.md"
+
+[dependency-groups]
+dev = [
+    "pytest>=8.0",
+    "pytest-cov>=5.0",
+    "ruff>=0.5",
+    "mypy>=1.10",
+]
+
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+jpoke = ["py.typed"]
+"jpoke.data" = ["*.json"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["src"]
+
+[tool.ruff]
+line-length = 200
+target-version = "py310"
+src = ["src"]
+
+[tool.ruff.lint]
+# E/W: pycodestyle, F: pyflakes, B: flake8-bugbear（B006 が可変デフォルト引数を検出する）
+select = ["E", "F", "W", "B"]
+ignore = [
+    "E741",  # あいまいな変数名 l: data/move.py が handlers.lethal を l として import している
+    "B905",  # zip(strict=) は挙動変更（長さ不一致で例外）を伴うため個別に判断して導入する
+]
+
+[tool.ruff.lint.per-file-ignores]
+"**/__init__.py" = ["F401"]        # 再エクスポートのための import
+"src/jpoke/types/*.py" = ["E501"]  # scripts/generate_literals による自動生成の長行
+"scripts/**" = ["F841"]            # 実験用スクリプトの未使用変数は許容
+
+[tool.mypy]
+# 段階導入: まず core のみを対象にし、警告を解消しながら対象を広げる
+# follow_imports = "silent" で core が import する core 外モジュール（handlers/model 等）の
+# 型エラーは黙殺する（段階導入の対象外のため）。core 自身のエラーのみ報告させる。
+python_version = "3.10"
+files = ["src/jpoke/core"]
+mypy_path = "src"
+ignore_missing_imports = true
+check_untyped_defs = false
+follow_imports = "silent"
+
+[tool.coverage.run]
+source = ["src/jpoke"]
+
+[tool.coverage.report]
+exclude_lines = [
+    "pragma: no cover",
+    "if TYPE_CHECKING:",
+]

jpoke-0.1.0/setup.cfg

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

jpoke-0.1.0/src/jpoke/__init__.py

@@ -0,0 +1,22 @@
+"""jpokeパッケージ - ポケモンバトルシミュレータ。
+
+バトル、プレイヤー、ポケモン、技、特性、アイテムなどの主要クラスと、
+ポケモン図鑑データを提供します。
+"""
+from importlib.metadata import version as _version
+
+from .core import Battle, Player
+from .model import Pokemon, Ability, Item, Move
+from .data import POKEDEX
+
+__version__ = _version("jpoke")
+
+__all__ = [
+    "Battle",
+    "Player",
+    "Pokemon",
+    "Ability",
+    "Item",
+    "Move",
+    "POKEDEX",
+]

jpoke-0.1.0/src/jpoke/core/__init__.py

@@ -0,0 +1,12 @@
+from .handler import Handler, HandlerReturn
+from .lethal import StateDist, LethalHandler, LethalContext
+from .context import BaseContext, EventContext, AttackContext
+from .event_manager import EventManager
+from .battle import Battle
+from .player import Player
+from .player_state import PlayerState
+from .ailment_manager import AilmentManager
+from .volatile_manager import VolatileManager
+from .field_manager import SideFieldManager
+from .status_manager import StatusManager
+from .query import PokemonQuery