jwwkit 0.2.0__tar.gz

jwwkit-0.2.0/LICENSE

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

jwwkit-0.2.0/MANIFEST.in

@@ -0,0 +1,5 @@
+include README.md LICENSE THIRD_PARTY_NOTICES.md
+recursive-include src/jwwkit/resources *.json *.jww *.md *.toml
+recursive-include src/jwwkit/guides *.md
+prune tests
+global-exclude *.py[cod]

jwwkit-0.2.0/PKG-INFO

@@ -0,0 +1,174 @@
+Metadata-Version: 2.4
+Name: jwwkit
+Version: 0.2.0
+Summary: Read, inspect, and safely edit Jw_cad drawing files
+Author: tetsuo-m
+License-Expression: MIT
+Project-URL: Repository, https://github.com/tetsuo-m/jwwkit
+Classifier: Development Status :: 3 - Alpha
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Topic :: Scientific/Engineering
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+License-File: THIRD_PARTY_NOTICES.md
+Requires-Dist: ezjww<0.3,>=0.2.13
+Dynamic: license-file
+
+# jwwkit
+
+**既存のJw_cad図面（.jww）を、壊さずに読み書きするためのPythonライブラリ**
+
+jwwkitは、Jw_cadの図面ファイル（JWW形式）をPythonから読み込み、編集し、保存するためのライブラリです。
+いちばんの特徴は、**既存の図面を、触っていない部分を一切変えずに編集できること**です。
+何も編集せずに保存すれば元のファイルとバイト単位で一致し、線を1本動かしても、それ以外の要素はそのまま残ります。
+
+日本中の設計事務所や現場には、Jw_cadで描かれた膨大な図面があります。
+jwwkitは、それらの図面資産を、AIやプログラムから安全に扱えるようにするために作りました。
+
+> **非公式ツールです。** jwwkitはJw_cadの作者とは関係のない、個人による非公式のライブラリです。
+> **jwwkitについて、Jw_cadの作者の方々へ問い合わせることはお控えください。**
+
+---
+
+## できること
+
+- **読み込み**：線・円・弧・点・文字・ソリッド・寸法・ブロックなどの要素と、レイヤ・グループ・縮尺・線色・線種などの属性の取得
+- **既存図面の安全な編集**：要素の移動・複写・回転・反転・拡大縮小・属性変更・削除・追加、レイヤ名・グループ名・縮尺・表示状態の変更など。編集していない要素は変わりません
+- **登録図形（JWS）**：登録図形（230〜700形式）の読み込みと配置
+- **ブロック**：ブロック定義の読み込み、作成、配置、既存要素のブロック化と置換
+- **グループ（レイヤグループ）ごとの縮尺**に対応（実寸mm・紙面mmの両方で指定可能）
+- **大きな図面**：65,535要素を超える図面に対応
+- **SXF拡張線色・線種**：読み取り、検索、属性変更などの編集
+- **別の図面からのグループの取り込みと、2点による位置合わせ**：建築図だけを新しいものに差し替え、設備のグループはそのまま残す、といった使い方ができます
+- **図面どうしの比較**：設計変更の前後などで、追加・削除・属性の変化・文字の変化を一覧にします
+- **条件検索**：AND/OR/NOT、属性のフラグ、線の向き、長さ・半径、表示状態、文字の前方一致・正規表現、全角半角などの表記揺れ（指定した場合のみ）
+- **形状と位置からの検索**：要素の外形・中心・文字枠の取得、指定した点の近くにある要素・最も近い要素の検索
+- **Jw_cadの環境設定ファイル（.jwf）**の読み取りと比較
+- **他のCADが出力したJWW**：TFAS 14eの出力はそのまま、Rebroの出力は対象のクラス宣言欄の明示的な正規化の後に扱えます
+- **AIに使わせるための安全な編集手順（safe_edit）**：「計画 → 確認・承認 → 実行」の2段階で編集し、意図しない変更を防ぎます。編集の結果は、追加・変更・削除・拒否・注意を共通の形で返します
+- **AI向けの利用ガイド**：AIエージェントにこのライブラリを使わせるときの手引き（`jwwkit guide` で場所を表示）
+
+## できないこと・対応していないこと
+
+- Jw_cadの全機能・全データの完全な再現は保証しません。未対応の構造を見つけた場合、jwwkitは**推測で処理せず、エラーとして止まります**
+- 新しい図面をゼロから作図する機能や、DXFなど他形式への変換は主な目的ではありません（DXFへの変換は [ezjww](https://pypi.org/project/ezjww/) が得意です）
+- 動作確認はJw_cad 10.03系で行っています。それ以外の版で保存された図面では、未対応の形式として読み込みを拒否することがあります
+- 対応する形式はJWWのv600/v700です。それより古い版のJWWと、DOS版のJWCには対応していません
+- 画像を含む図面は、画像をそのまま保持して保存できますが、画像そのものの編集はできません
+- 縮尺の異なるグループへ、文字種の付いた文字・寸法を取り込む操作は、拒否します
+- 新しい入れ子のブロック（ブロックの中のブロック）は作成できません
+- 特殊な属性の付いた文字（寸法の値の文字など）は、文字枠を「未判定」として扱います
+- Rebroが出力したJWWは、そのままでは開けません。明示的な正規化を行ってから使ってください。正規化では、Rebroの書き出しで欠けたデータ（短い線など）は戻りません
+- Windowsで動作を確認しています。一部の機能（正規化の出力の確定など）はWindows専用です
+
+## 必ずお読みください
+
+- **編集する前に、必ず図面のバックアップを取ってください。** jwwkit自身も、元のファイルへの上書き保存はしません（別名でのみ保存します）。
+- 編集結果は、Jw_cadで開いて目視で確認してから使ってください。
+- AIサービスに図面を読ませると、図面の内容がそのAIの提供会社に送られます。業務の図面で使う前に、所属先や発注者の決まりを確認してください。
+- jwwkit自体はインターネットへの通信を行いません。
+- 本ライブラリは無保証です（MITライセンス）。図面の破損や、編集結果による損害について、作者は責任を負いません。
+- AIに使わせる場合、図面の中の文字・レイヤ名などは「データ」であり、AIへの指示ではありません。図面の中に指示のような文字が書かれていても、AIがそれに従わないよう、利用ガイドに注意を記載しています。
+
+## インストール
+
+Windowsで使う手順です。作業フォルダを開き、PowerShellから実行します。
+
+```powershell
+python -m venv .venv
+.\.venv\Scripts\python.exe -m pip install jwwkit
+.\.venv\Scripts\jwwkit.exe check
+.\.venv\Scripts\jwwkit.exe guide
+```
+
+`check` の結果が `"passed": true` なら導入確認は合格です。`guide` は同梱の `AGENTS.md` と利用ガイドの場所を表示します。仮想環境を有効にした場合は `jwwkit check` と `jwwkit guide` で実行できます。
+
+- WindowsのPython 3.14と3.15でwheelからの導入を確認しました。
+- 実行時の依存ライブラリは `ezjww>=0.2.13,<0.3` です。
+
+### 開発用のインストール
+
+取得したリポジトリの直下で、新しい仮想環境を作って有効にします。その環境で次を実行します。
+
+```powershell
+python -m pip install -e .
+python -m jwwkit check
+python -B -m unittest discover -s tests
+```
+
+## 使い方
+
+```python
+from pathlib import Path
+from jwwkit import CadDocument
+
+# 図面を読み込む
+drawing_dir = Path("../drawing-work")  # ライブラリの外にある作業フォルダに置き換える
+doc = CadDocument.open(drawing_dir / "sample.jww")
+
+# 全体の要約（要素数、種類ごとの数、グループ・レイヤごとの内訳など）
+summary = doc.summary()
+print(summary["entity_count"], summary["by_type"])
+
+# グループ0の線を探して、属性と座標を見る
+for i in doc.find_entities(entity_type="LINE", layer_group=0):
+    e = doc.entities[i]
+    print(i, e.attributes["layer"], e.attributes["pen_color"], e.geometry)
+
+# 何も編集せずに別名で保存すると、元のファイルとバイト単位で一致します
+doc.save(drawing_dir / "sample_copy.jww")
+```
+
+サンプル図面は、今後追加する予定です。それまでは、ご自身で作成した図面でお試しください（業務の図面を使う場合は、必ずバックアップを取ってから）。
+
+AIに既存図面の編集を頼む場合、AIが示す計画の内容とSHA256を確かめ、会話で了承を伝えてください。元図面の上書きはできないため、編集結果は別名で保存します。空テンプレートから新規作図を頼む場合は、先に作る内容と保存先を確認します。詳しくは [AGENTS.md](https://github.com/tetsuo-m/jwwkit/blob/main/AGENTS.md) と [利用ガイド](https://github.com/tetsuo-m/jwwkit/blob/main/docs/usage_guide.md) を参照してください。関数の一覧は [API一覧](https://github.com/tetsuo-m/jwwkit/blob/main/docs/api_list.md) を参照してください。
+
+### コマンド
+
+- `jwwkit summarize --source input.jww --output summary.json` で図面を集計します。
+- `jwwkit compare --left before.jww --right after.jww --output comparison.json` で図面を比較します。
+- `jwwkit inspect-jwf --source settings.jwf --output settings.json` でJWFを読み取ります。
+- `jwwkit recognize-tategu --source input.jww --tolerances tolerances.json --output candidates.json` で建具の候補を抽出します。許容値は [建具候補の抽出](https://github.com/tetsuo-m/jwwkit/blob/main/docs/tategu_recognition.md) を参照してください。
+
+出力には新しいファイル名を指定してください。Pythonから手引きの場所を得るには `jwwkit.guide_paths()`、空テンプレートの場所を得るには `jwwkit.template_path()` を使います。
+
+## 検証について
+
+jwwkitは、業務で安心して使えることを目標に、一つひとつ検証しながら作りました。
+無編集保存でのバイト一致、編集後にJw_cadで開いて再保存できること、DXF・PDF出力での照合など、検証の方法と結果は [VERIFICATION.md](https://github.com/tetsuo-m/jwwkit/blob/main/VERIFICATION.md) にまとめています。
+
+## 作った人について
+
+電気設備の設計者が、日々の業務を楽にしたいという動機から、AIと一緒に作りました。作者はプログラマーではありません。
+JWW形式は、公開されているファイル形式の資料と、自作の図面の解析、Jw_cad本体で保存した結果との照合をもとに読み解いています。実務の図面は検証にのみ使い、公開していません。
+図面のヘッダーの読み取りと、独自の読み取り結果の照合には、[ezjww](https://pypi.org/project/ezjww/)（MITライセンス）を利用しています。
+Jw_cad本体や付属ファイルは含んでいません。ライブラリの確認用に、図形のない空テンプレートを収録しています。
+
+## サポートについて
+
+- 不具合や危険な動作は、[非公開の報告手順](https://github.com/tetsuo-m/jwwkit/blob/main/SECURITY.md)に沿って報告してください。改善要望はGitHubのIssueで受け付けます。
+- 返信は不定期です。すべての要望に応えられるとは限りません。
+- 報告や要望に図面は添付しないでください。
+
+## 関連プロジェクト
+
+JWW形式を扱うオープンソースには、ほかにも次のようなものがあります。目的に合わせて選んでください。
+
+- [ezjww](https://pypi.org/project/ezjww/) — JWWの読み込み・新規作成・変換に強いライブラリ（Rust製、Python・TypeScriptから利用可能）。jwwkitも内部で利用しています
+- [zumen](https://pypi.org/project/zumen/) — SXF・JWW・DXF・DWGを読み込み、表示・比較・変換するライブラリ（Rust製、Python・ブラウザから利用可能）
+
+## ライセンス
+
+[MIT License](https://github.com/tetsuo-m/jwwkit/blob/main/LICENSE) · [第三者のデータと依存ライブラリ](https://github.com/tetsuo-m/jwwkit/blob/main/THIRD_PARTY_NOTICES.md)
+
+「Jw_cad」は、その作者の方々に帰属する名称です。
+「Rebro」と「TFAS」は、それぞれの権利者に帰属する名称です。
+
+---
+
+## English summary
+
+jwwkit is an unofficial Python library for reading and **safely editing existing Jw_cad (.jww) drawings** without altering untouched elements (a no-edit save is byte-identical to the original). It supports registered figures (JWS), blocks, per-group scales, drawings with more than 65,535 elements, SXF extended line colors/types, importing layer groups from another drawing with two-point alignment, drawing comparison, structured search, and a two-step plan/approve/execute editing workflow designed for AI agents. It is tested on Windows with Python 3.14 and 3.15 and with Jw_cad 10.03.6, and uses ezjww (MIT) for header reading and cross-checking. Not affiliated with the authors of Jw_cad — please do not contact them about this library. Always back up your drawings before editing.

jwwkit-0.2.0/README.md

@@ -0,0 +1,155 @@
+# jwwkit
+
+**既存のJw_cad図面（.jww）を、壊さずに読み書きするためのPythonライブラリ**
+
+jwwkitは、Jw_cadの図面ファイル（JWW形式）をPythonから読み込み、編集し、保存するためのライブラリです。
+いちばんの特徴は、**既存の図面を、触っていない部分を一切変えずに編集できること**です。
+何も編集せずに保存すれば元のファイルとバイト単位で一致し、線を1本動かしても、それ以外の要素はそのまま残ります。
+
+日本中の設計事務所や現場には、Jw_cadで描かれた膨大な図面があります。
+jwwkitは、それらの図面資産を、AIやプログラムから安全に扱えるようにするために作りました。
+
+> **非公式ツールです。** jwwkitはJw_cadの作者とは関係のない、個人による非公式のライブラリです。
+> **jwwkitについて、Jw_cadの作者の方々へ問い合わせることはお控えください。**
+
+---
+
+## できること
+
+- **読み込み**：線・円・弧・点・文字・ソリッド・寸法・ブロックなどの要素と、レイヤ・グループ・縮尺・線色・線種などの属性の取得
+- **既存図面の安全な編集**：要素の移動・複写・回転・反転・拡大縮小・属性変更・削除・追加、レイヤ名・グループ名・縮尺・表示状態の変更など。編集していない要素は変わりません
+- **登録図形（JWS）**：登録図形（230〜700形式）の読み込みと配置
+- **ブロック**：ブロック定義の読み込み、作成、配置、既存要素のブロック化と置換
+- **グループ（レイヤグループ）ごとの縮尺**に対応（実寸mm・紙面mmの両方で指定可能）
+- **大きな図面**：65,535要素を超える図面に対応
+- **SXF拡張線色・線種**：読み取り、検索、属性変更などの編集
+- **別の図面からのグループの取り込みと、2点による位置合わせ**：建築図だけを新しいものに差し替え、設備のグループはそのまま残す、といった使い方ができます
+- **図面どうしの比較**：設計変更の前後などで、追加・削除・属性の変化・文字の変化を一覧にします
+- **条件検索**：AND/OR/NOT、属性のフラグ、線の向き、長さ・半径、表示状態、文字の前方一致・正規表現、全角半角などの表記揺れ（指定した場合のみ）
+- **形状と位置からの検索**：要素の外形・中心・文字枠の取得、指定した点の近くにある要素・最も近い要素の検索
+- **Jw_cadの環境設定ファイル（.jwf）**の読み取りと比較
+- **他のCADが出力したJWW**：TFAS 14eの出力はそのまま、Rebroの出力は対象のクラス宣言欄の明示的な正規化の後に扱えます
+- **AIに使わせるための安全な編集手順（safe_edit）**：「計画 → 確認・承認 → 実行」の2段階で編集し、意図しない変更を防ぎます。編集の結果は、追加・変更・削除・拒否・注意を共通の形で返します
+- **AI向けの利用ガイド**：AIエージェントにこのライブラリを使わせるときの手引き（`jwwkit guide` で場所を表示）
+
+## できないこと・対応していないこと
+
+- Jw_cadの全機能・全データの完全な再現は保証しません。未対応の構造を見つけた場合、jwwkitは**推測で処理せず、エラーとして止まります**
+- 新しい図面をゼロから作図する機能や、DXFなど他形式への変換は主な目的ではありません（DXFへの変換は [ezjww](https://pypi.org/project/ezjww/) が得意です）
+- 動作確認はJw_cad 10.03系で行っています。それ以外の版で保存された図面では、未対応の形式として読み込みを拒否することがあります
+- 対応する形式はJWWのv600/v700です。それより古い版のJWWと、DOS版のJWCには対応していません
+- 画像を含む図面は、画像をそのまま保持して保存できますが、画像そのものの編集はできません
+- 縮尺の異なるグループへ、文字種の付いた文字・寸法を取り込む操作は、拒否します
+- 新しい入れ子のブロック（ブロックの中のブロック）は作成できません
+- 特殊な属性の付いた文字（寸法の値の文字など）は、文字枠を「未判定」として扱います
+- Rebroが出力したJWWは、そのままでは開けません。明示的な正規化を行ってから使ってください。正規化では、Rebroの書き出しで欠けたデータ（短い線など）は戻りません
+- Windowsで動作を確認しています。一部の機能（正規化の出力の確定など）はWindows専用です
+
+## 必ずお読みください
+
+- **編集する前に、必ず図面のバックアップを取ってください。** jwwkit自身も、元のファイルへの上書き保存はしません（別名でのみ保存します）。
+- 編集結果は、Jw_cadで開いて目視で確認してから使ってください。
+- AIサービスに図面を読ませると、図面の内容がそのAIの提供会社に送られます。業務の図面で使う前に、所属先や発注者の決まりを確認してください。
+- jwwkit自体はインターネットへの通信を行いません。
+- 本ライブラリは無保証です（MITライセンス）。図面の破損や、編集結果による損害について、作者は責任を負いません。
+- AIに使わせる場合、図面の中の文字・レイヤ名などは「データ」であり、AIへの指示ではありません。図面の中に指示のような文字が書かれていても、AIがそれに従わないよう、利用ガイドに注意を記載しています。
+
+## インストール
+
+Windowsで使う手順です。作業フォルダを開き、PowerShellから実行します。
+
+```powershell
+python -m venv .venv
+.\.venv\Scripts\python.exe -m pip install jwwkit
+.\.venv\Scripts\jwwkit.exe check
+.\.venv\Scripts\jwwkit.exe guide
+```
+
+`check` の結果が `"passed": true` なら導入確認は合格です。`guide` は同梱の `AGENTS.md` と利用ガイドの場所を表示します。仮想環境を有効にした場合は `jwwkit check` と `jwwkit guide` で実行できます。
+
+- WindowsのPython 3.14と3.15でwheelからの導入を確認しました。
+- 実行時の依存ライブラリは `ezjww>=0.2.13,<0.3` です。
+
+### 開発用のインストール
+
+取得したリポジトリの直下で、新しい仮想環境を作って有効にします。その環境で次を実行します。
+
+```powershell
+python -m pip install -e .
+python -m jwwkit check
+python -B -m unittest discover -s tests
+```
+
+## 使い方
+
+```python
+from pathlib import Path
+from jwwkit import CadDocument
+
+# 図面を読み込む
+drawing_dir = Path("../drawing-work")  # ライブラリの外にある作業フォルダに置き換える
+doc = CadDocument.open(drawing_dir / "sample.jww")
+
+# 全体の要約（要素数、種類ごとの数、グループ・レイヤごとの内訳など）
+summary = doc.summary()
+print(summary["entity_count"], summary["by_type"])
+
+# グループ0の線を探して、属性と座標を見る
+for i in doc.find_entities(entity_type="LINE", layer_group=0):
+    e = doc.entities[i]
+    print(i, e.attributes["layer"], e.attributes["pen_color"], e.geometry)
+
+# 何も編集せずに別名で保存すると、元のファイルとバイト単位で一致します
+doc.save(drawing_dir / "sample_copy.jww")
+```
+
+サンプル図面は、今後追加する予定です。それまでは、ご自身で作成した図面でお試しください（業務の図面を使う場合は、必ずバックアップを取ってから）。
+
+AIに既存図面の編集を頼む場合、AIが示す計画の内容とSHA256を確かめ、会話で了承を伝えてください。元図面の上書きはできないため、編集結果は別名で保存します。空テンプレートから新規作図を頼む場合は、先に作る内容と保存先を確認します。詳しくは [AGENTS.md](https://github.com/tetsuo-m/jwwkit/blob/main/AGENTS.md) と [利用ガイド](https://github.com/tetsuo-m/jwwkit/blob/main/docs/usage_guide.md) を参照してください。関数の一覧は [API一覧](https://github.com/tetsuo-m/jwwkit/blob/main/docs/api_list.md) を参照してください。
+
+### コマンド
+
+- `jwwkit summarize --source input.jww --output summary.json` で図面を集計します。
+- `jwwkit compare --left before.jww --right after.jww --output comparison.json` で図面を比較します。
+- `jwwkit inspect-jwf --source settings.jwf --output settings.json` でJWFを読み取ります。
+- `jwwkit recognize-tategu --source input.jww --tolerances tolerances.json --output candidates.json` で建具の候補を抽出します。許容値は [建具候補の抽出](https://github.com/tetsuo-m/jwwkit/blob/main/docs/tategu_recognition.md) を参照してください。
+
+出力には新しいファイル名を指定してください。Pythonから手引きの場所を得るには `jwwkit.guide_paths()`、空テンプレートの場所を得るには `jwwkit.template_path()` を使います。
+
+## 検証について
+
+jwwkitは、業務で安心して使えることを目標に、一つひとつ検証しながら作りました。
+無編集保存でのバイト一致、編集後にJw_cadで開いて再保存できること、DXF・PDF出力での照合など、検証の方法と結果は [VERIFICATION.md](https://github.com/tetsuo-m/jwwkit/blob/main/VERIFICATION.md) にまとめています。
+
+## 作った人について
+
+電気設備の設計者が、日々の業務を楽にしたいという動機から、AIと一緒に作りました。作者はプログラマーではありません。
+JWW形式は、公開されているファイル形式の資料と、自作の図面の解析、Jw_cad本体で保存した結果との照合をもとに読み解いています。実務の図面は検証にのみ使い、公開していません。
+図面のヘッダーの読み取りと、独自の読み取り結果の照合には、[ezjww](https://pypi.org/project/ezjww/)（MITライセンス）を利用しています。
+Jw_cad本体や付属ファイルは含んでいません。ライブラリの確認用に、図形のない空テンプレートを収録しています。
+
+## サポートについて
+
+- 不具合や危険な動作は、[非公開の報告手順](https://github.com/tetsuo-m/jwwkit/blob/main/SECURITY.md)に沿って報告してください。改善要望はGitHubのIssueで受け付けます。
+- 返信は不定期です。すべての要望に応えられるとは限りません。
+- 報告や要望に図面は添付しないでください。
+
+## 関連プロジェクト
+
+JWW形式を扱うオープンソースには、ほかにも次のようなものがあります。目的に合わせて選んでください。
+
+- [ezjww](https://pypi.org/project/ezjww/) — JWWの読み込み・新規作成・変換に強いライブラリ（Rust製、Python・TypeScriptから利用可能）。jwwkitも内部で利用しています
+- [zumen](https://pypi.org/project/zumen/) — SXF・JWW・DXF・DWGを読み込み、表示・比較・変換するライブラリ（Rust製、Python・ブラウザから利用可能）
+
+## ライセンス
+
+[MIT License](https://github.com/tetsuo-m/jwwkit/blob/main/LICENSE) · [第三者のデータと依存ライブラリ](https://github.com/tetsuo-m/jwwkit/blob/main/THIRD_PARTY_NOTICES.md)
+
+「Jw_cad」は、その作者の方々に帰属する名称です。
+「Rebro」と「TFAS」は、それぞれの権利者に帰属する名称です。
+
+---
+
+## English summary
+
+jwwkit is an unofficial Python library for reading and **safely editing existing Jw_cad (.jww) drawings** without altering untouched elements (a no-edit save is byte-identical to the original). It supports registered figures (JWS), blocks, per-group scales, drawings with more than 65,535 elements, SXF extended line colors/types, importing layer groups from another drawing with two-point alignment, drawing comparison, structured search, and a two-step plan/approve/execute editing workflow designed for AI agents. It is tested on Windows with Python 3.14 and 3.15 and with Jw_cad 10.03.6, and uses ezjww (MIT) for header reading and cross-checking. Not affiliated with the authors of Jw_cad — please do not contact them about this library. Always back up your drawings before editing.

jwwkit-0.2.0/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,51 @@
+# 第三者のデータと依存ライブラリ
+
+## Unicode Character Database 16.0.0
+
+文字検索の固定対応表には、Unicode Character Database 16.0.0に由来するデータを含みます。Unicode, Inc. © 2024。対象は `src/jwwkit/resources/text_equivalence_v1.json`、`src/jwwkit/resources/halfwidth_kana_composition_v1.json` と、`docs/design/text_equivalence_proposal.md`、`docs/design/text_equivalence_proposal.json` に掲載した対応表です。case folding、空白の分類、半角カナの合成などに使っています。対応表はjwwkitの検索用に抽出・整形したものです。[Unicode 16.0.0 UCD](https://www.unicode.org/Public/16.0.0/ucd/ReadMe.txt) · [CaseFolding.txt](https://www.unicode.org/Public/16.0.0/ucd/CaseFolding.txt) · [Unicode License v3](https://www.unicode.org/license.txt)
+
+```text
+UNICODE LICENSE V3
+
+COPYRIGHT AND PERMISSION NOTICE
+
+Copyright © 1991-2026 Unicode, Inc.
+
+NOTICE TO USER: Carefully read the following legal agreement. BY
+DOWNLOADING, INSTALLING, COPYING OR OTHERWISE USING DATA FILES, AND/OR
+SOFTWARE, YOU UNEQUIVOCALLY ACCEPT, AND AGREE TO BE BOUND BY, ALL OF THE
+TERMS AND CONDITIONS OF THIS AGREEMENT. IF YOU DO NOT AGREE, DO NOT
+DOWNLOAD, INSTALL, COPY, DISTRIBUTE OR USE THE DATA FILES OR SOFTWARE.
+Permission is hereby granted, free of charge, to any person obtaining a
+copy of data files and any associated documentation (the "Data Files") or
+software and any associated documentation (the "Software") to deal in the
+Data Files or Software without restriction, including without limitation
+the rights to use, copy, modify, merge, publish, distribute, and/or sell
+copies of the Data Files or Software, and to permit persons to whom the
+Data Files or Software are furnished to do so, provided that either (a)
+this copyright and permission notice appear with all copies of the Data
+Files or Software, or (b) this copyright and permission notice appear in
+associated Documentation.
+THE DATA FILES AND SOFTWARE ARE 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 OF
+THIRD PARTY RIGHTS.
+IN NO EVENT SHALL THE COPYRIGHT HOLDER OR HOLDERS INCLUDED IN THIS NOTICE
+BE LIABLE FOR ANY CLAIM, OR ANY SPECIAL INDIRECT OR CONSEQUENTIAL DAMAGES,
+OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,
+WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION,
+ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THE DATA
+FILES OR SOFTWARE.
+Except as contained in this notice, the name of a copyright holder shall
+not be used in advertising or otherwise to promote the sale, use or other
+dealings in these Data Files or Software without prior written
+authorization of the copyright holder.
+```
+
+## Pythonの依存ライブラリ
+
+|依存|固定版|ライセンス|配布元|
+|---|---|---|---|
+|ezjww|0.2.13|MIT|[ezjww 0.2.13](https://pypi.org/project/ezjww/0.2.13/)|
+
+依存のコードとバイナリは各配布元から取得します。

jwwkit-0.2.0/pyproject.toml

@@ -0,0 +1,39 @@
+[build-system]
+requires = ["setuptools>=77"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "jwwkit"
+version = "0.2.0"
+description = "Read, inspect, and safely edit Jw_cad drawing files"
+readme = "README.md"
+requires-python = ">=3.11"
+license = "MIT"
+license-files = ["LICENSE", "THIRD_PARTY_NOTICES.md"]
+authors = [{name = "tetsuo-m"}]
+dependencies = ["ezjww>=0.2.13,<0.3"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Operating System :: Microsoft :: Windows",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Topic :: Scientific/Engineering",
+]
+
+[project.scripts]
+jwwkit = "jwwkit.cli:main"
+
+[project.urls]
+Repository = "https://github.com/tetsuo-m/jwwkit"
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+include-package-data = false
+
+[tool.setuptools.packages.find]
+where = ["src"]
+include = ["jwwkit", "jwwkit.*"]
+namespaces = false
+
+[tool.setuptools.package-data]
+jwwkit = ["resources/*.jww", "resources/*.json", "resources/*.md", "resources/*.toml", "guides/AGENTS.md", "guides/docs/*.md"]

jwwkit-0.2.0/setup.cfg

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

jwwkit-0.2.0/src/jwwkit/__init__.py

@@ -0,0 +1,14 @@
+"""Read, inspect and safely edit Jw_cad drawings."""
+from ._resources import guide_paths, template_path
+from .cad_model import CadBlockDefinition, CadDocument, CadEntity, JwsDocument
+from .jwf import JwfDocument, JwfSetting, jwf_setting_catalog
+from .legacy_document import LegacyDocument
+from .line_document import (
+    BlockDefinition, BlockReference, Circle, Dimension, JwwDocument, Line, Point, Solid, Text,
+)
+
+__all__ = [
+    "BlockDefinition", "BlockReference", "CadBlockDefinition", "CadDocument", "CadEntity",
+    "Circle", "Dimension", "JwfDocument", "JwfSetting", "JwsDocument", "JwwDocument",
+    "LegacyDocument", "Line", "Point", "Solid", "Text", "guide_paths", "jwf_setting_catalog", "template_path",
+]

jwwkit-0.2.0/src/jwwkit/__main__.py

@@ -0,0 +1,4 @@
+from .cli import main
+
+if __name__ == "__main__":
+    raise SystemExit(main())

jwwkit-0.2.0/src/jwwkit/_commands/__init__.py

@@ -0,0 +1 @@
+"""Command implementations for jwwkit."""

jwwkit-0.2.0/src/jwwkit/_commands/_integrity.py

@@ -0,0 +1,55 @@
+"""Offline checks for package data and the installed wheel's RECORD."""
+import base64
+import hashlib
+from importlib import metadata
+from pathlib import Path
+
+from jwwkit import template_path
+
+
+_TEMPLATE_SHA256 = "0913d5f6755b7038c11cda8be75c2502511ce85a007f9bcc2f10df049f6eff1e"
+_DRAWINGS = {".jww", ".jws", ".jwc", ".jwk", ".jwf", ".dxf", ".pdf"}
+
+
+def check_installed_files() -> int:
+    template = template_path()
+    package_root = template.parent.parent
+    if hashlib.sha256(template.read_bytes()).hexdigest() != _TEMPLATE_SHA256:
+        raise ValueError("Installed empty template hash mismatch")
+
+    files = set()
+    for path in package_root.rglob("*"):
+        if "__pycache__" in path.parts:
+            continue
+        if path.is_symlink() or getattr(path.stat(), "st_file_attributes", 0) & 0x400:
+            raise ValueError(f"Link or reparse point in jwwkit: {path}")
+        if not path.is_file():
+            continue
+        if path.name.casefold() in {"desktop.ini", "thumbs.db"} or path.suffix == ".pyc":
+            continue
+        if path.name.casefold() == "ai_settings_summary.json":
+            raise ValueError(f"Personal JWF summary in jwwkit: {path}")
+        if path.suffix.casefold() in _DRAWINGS and path != template:
+            raise ValueError(f"Unexpected drawing in jwwkit: {path}")
+        files.add(path)
+
+    distribution = metadata.distribution("jwwkit")
+    records = {
+        Path(item.locate()): item
+        for item in distribution.files or ()
+        if item.parts[0] == "jwwkit" and "__pycache__" not in item.parts
+    }
+    # Editable installations record the path hook and metadata, not package files.
+    if records:
+        if set(records) != files:
+            extra = sorted(str(path.relative_to(package_root)) for path in files - records.keys())
+            missing = sorted(str(path.relative_to(package_root)) for path in records.keys() - files)
+            raise ValueError(f"Unexpected or missing installed jwwkit files: extra={extra}, missing={missing}")
+        for path, record in records.items():
+            data = path.read_bytes()
+            if record.hash is None or record.size != len(data):
+                raise ValueError(f"Installed jwwkit file size or RECORD mismatch: {path.name}")
+            digest = hashlib.new(record.hash.mode, data).digest()
+            if base64.urlsafe_b64encode(digest).rstrip(b"=").decode("ascii") != record.hash.value:
+                raise ValueError(f"Installed jwwkit file hash mismatch: {path.name}")
+    return len(files)