jwwkit 0.2.0__py3-none-any.whl

jwwkit/guides/docs/common_edit_result_coverage.md

@@ -0,0 +1,40 @@
+# 共通編集結果の対応表
+
+CadDocumentの31メソッド。ソースの許可表/実際の関数引数から生成し、各メソッドを計画→保存/読戻しと旧APIの全バイト一致で試験する。従来の戻り値と例外は変えない。詳細はedit_results.md。
+
+|メソッド|実際の引数|計画の対象指定|
+|---|---|---|
+|CadDocument.delete_entity|`(self, index)`|indicesに対象1件|
+|CadDocument.delete_entities|`(self, indices)`|indicesに対象一覧|
+|CadDocument.move_entities|`(self, indices, delta, *, units='paper')`|indicesに対象一覧|
+|CadDocument.move_entity|`(self, index, delta, *, units='paper')`|indicesに対象1件|
+|CadDocument.transform_entities|`(self, indices, **options)`|indicesに対象一覧|
+|CadDocument.copy_entities|`(self, indices, delta=(0, 0), *, units='paper')`|indicesに対象一覧|
+|CadDocument.align_two_points|`(self, indices, source_points, target_points, *, distance_tolerance, angle_tolerance, angle_units='rad', allow_scale=False)`|indicesに対象一覧|
+|CadDocument.rotate_entities|`(self, indices, angle, **options)`|indicesに対象一覧|
+|CadDocument.reflect_entities|`(self, indices, **options)`|indicesに対象一覧|
+|CadDocument.scale_entities|`(self, indices, scale_x, scale_y=None, **options)`|indicesに対象一覧|
+|CadDocument.set_entity_attributes|`(self, index, *, color=None, linetype=None, width=None, layer=None, layer_group=None, preserve='paper')`|indicesに対象1件|
+|CadDocument.set_text|`(self, index: 'int', content: 'str', *, recalculate_end: 'bool' = False) -> 'None'`|indicesに対象1件|
+|CadDocument.recalculate_text_endpoint|`(self, index: 'int') -> 'None'`|indicesに対象1件|
+|CadDocument.set_group_scale|`(self, layer_group: 'int', scale: 'float') -> 'None'`|kwargs（要素indicesなし）|
+|CadDocument.add_line|`(self, start, end, *, layer_group=0, units='paper', **attributes) -> 'CadEntity'`|kwargs（要素indicesなし）|
+|CadDocument.add_text|`(self, start, end=None, content=None, *, layer_group=0, units='paper', **attributes) -> 'CadEntity'`|kwargs（要素indicesなし）|
+|CadDocument.add_circle|`(self, center, radius, *, layer_group=0, units='paper', flatness=1.0, tilt_angle=0.0, **attributes) -> 'CadEntity'`|kwargs（要素indicesなし）|
+|CadDocument.add_point|`(self, position, *, layer_group=0, units='paper', **attributes) -> 'CadEntity'`|kwargs（要素indicesなし）|
+|CadDocument.add_solid|`(self, points, *, rgb=None, layer_group=0, units='paper', **attributes) -> 'CadEntity'`|kwargs（要素indicesなし）|
+|CadDocument.add_circle_solid|`(self, center, radius, *, solid_mode=100.0, flatness=1.0, tilt_angle=0.0, start_angle=0.0, arc_angle=6.283185307179586, rgb=None, inner_radius=None, layer_group=0, units='paper', **attributes) -> 'CadEntity'`|kwargs（要素indicesなし）|
+|CadDocument.set_group_state|`(self, layer_group, state)`|kwargs（要素indicesなし）|
+|CadDocument.set_layer_state|`(self, layer_group, layer, state)`|kwargs（要素indicesなし）|
+|CadDocument.set_layer_name|`(self, layer_group, layer, name)`|kwargs（要素indicesなし）|
+|CadDocument.set_group_name|`(self, layer_group, name)`|kwargs（要素indicesなし）|
+|CadDocument.add_block_definition|`(self, name, entities, *, timestamp=0, compound_kind=None)`|kwargs（定義は選択indicesまたは宣言entities）|
+|CadDocument.add_arc|`(self, center, radius, start_angle, arc_angle, *, layer_group=0, units='paper', **attributes) -> 'CadEntity'`|kwargs（要素indicesなし）|
+|CadDocument.set_dimension_text|`(self, index: 'int', content: 'str') -> 'None'`|indicesに対象1件|
+|CadDocument.place_block|`(self, def_number, position, *, layer_group=0, units='paper', **attributes) -> 'CadEntity'`|kwargs（要素indicesなし）|
+|CadDocument.replace_entities_with_block|`(self, indices, name, **options)`|indicesに対象一覧|
+|CadDocument.set_block_layer_priority|`(self, index: 'int', enabled: 'bool') -> 'None'`|indicesに対象1件|
+|CadDocument.import_group|`(self, path, source_group, target_group, *, sync_scale=False, sync_group_name=True, sync_layer_names=True, block_renames=None, settings_policy='strict')`|kwargs（要素indicesなし）|
+
+JwwDocument13/LegacyDocument1は対象外。名前の推測で別のメソッドへ回避しない。保存/factory/読取りは31件に含めない。
+既存計画の28編集操作は従来の許可表のまま。追加4名はschema5だけで許可し、編集権限の黙示拡大を防ぐ。

jwwkit/guides/docs/drawing_comparison.md

@@ -0,0 +1,79 @@
+# 独立した2つのJWWを比べる（複合要素対応）
+
+`drawing_comparison.compare_drawings` は2ファイルを厳密に読み取り、辞書を返す。元図面を編集せず、比較結果だけ新規JSONに保存できる。種類・幾何を照合した後で、保存属性・内容を比較する。同じ要素番号が別図面で同じ物を示すとは仮定しない。
+
+AIは、利用者から頼まれた作業に必要な範囲で図面を読んでよい。図面の文字・形状・画像・名前・パスと、図面から作った計画、結果、集計、画面画像は、同じ作業の会話内で扱う。利用者が明示的に指示した場合を除き、これらをウェブ検索の語句に使ったり、外部サイト・API・他サービスや第三者へ送ったり、公開リポジトリやIssueに載せたりしない。会話では件数や要約を優先し、全文の一覧などは利用者に求められたときだけ示す。計画・結果ファイルにも図面の内容が含まれるため、図面と同じ扱いでローカルに保管する。
+
+## 基本例
+
+```python
+from jwwkit.drawing_comparison import compare_drawings, write_comparison
+result = compare_drawings("before.jww", "after.jww",
+                          left_scope={"groups": [0]}, right_scope={"groups": [0]})
+write_comparison(result, "comparison.json")
+```
+
+通常は実寸mmで比較する。対象を絞るなら `left_scope={"groups": [0], "layers": [(0, 0), (0, 1)]}`、右側も `right_scope` を指定する。groupsだけならその群の全層、未指定なら16群すべて、groups=[]なら空。非表示要素も対象に含む。群/層設定は両方の選択範囲で共通する同じ番号を比較し、異なる番号の群を自動で対応付けない。
+
+設計変更を見るときは、上の例のように比べたい群を両側で指定する。例えば旧建築を群8へ退避した差し替え図面では、建築群0だけを比べると新旧の建築形状の差を調べられる。全体を比べると、群8の旧建築も非表示のまま比較に含まれ、位置が同じ形状の対応や退避による属性差が混ざる。どちらも正しい範囲だが、同じ問いへの答えではない。
+
+自分が実行した編集の確認には、`safe_edit.execute_plan` の戻り値と、別名出力に対応する `edited.changes.json` を使う。元要素番号を追跡し、承認計画SHA・原本/出力SHA・保存読戻しの一致・変更/追加/削除数を確認する。独立比較で同じ形が対応したことを、承認した編集だけが行われた証拠へ置き換えない。非対象群の完全不変は既存の群監査で確認する。
+
+コマンドからも使用できる：`jwwkit compare --left before.jww --right after.jww --left-groups 0 --right-groups 0 --output new_report.json`。既存出力は拒否。結果が完全なら終了コード0、保留があればJSONを書いたうえで2。元ファイル変更/不正指定/読取り失敗は例外で停止する。
+
+## 対応範囲
+
+- LINE、CIRCLE（楕円を含む）、ARC、POINT、TEXT、DIMENSION、BLOCK、SOLID、CIRCLE_SOLID。群名・縮尺・レイヤ名・群/層の保存状態・保護状態・書込み層の差。
+- 文字種1〜10を参照する文字は、その設定差も属性比較へ含む。標準表示色とSXFの定義も確認済みの読取り欄を依存値として比較。点記号の角度/倍率、全flag、曲線属性番号も黙って無視しない。
+- 画像、未確認の寸法mode/塗り表現、欠落・循環するブロック依存等は対象外。一覧に側・番号・型・理由を残し、選択範囲にあれば `complete=False` にする。通常の読込み/編集APIの拒否条件は緩めない。
+- 未解析の全体ヘッダー、標準線種パターン/印刷状態等は意味上の比較対象外。ヘッダーのSHAを残すが、completeは全設定/全バイト/見え方の同一保証ではない。
+
+確認用の色分け図面を作る機能はない。建具認識・タスクDの編集処理も実装していない。
+
+## 寸法・ブロック・塗り図形
+
+寸法は外側DIMENSIONを1件として数える。主線/文字/補助線/点の全属性と文字内容を、`attribute_changes`/`content_changes` の子パスで報告する。観測済みmode0だけを意味比較し、未使用補助欄の**座標**差は `representation_differences` に残す。補助要素のレイヤ・flag・点記号等は属性差として検出する。内包要素を追加/削除数へ二重計上しない。主線や文字位置が変われば寸法全体の削除＋追加、寸法文字だけ変わればtext_changed。
+
+ブロックは参照の位置・回転・符号付き倍率を幾何として、レイヤ優先/保存属性と定義の名前/基底属性/全子要素を構造として比較する。定義の座標は局所の紙面mmで、子要素の群縮尺を掛けない。定義の幾何が変われば参照は削除＋追加、定義内属性だけの差はattributes_changed、内包文字内容差はtext_changedとなる。共有定義の差は影響する選択参照すべてに現れる。
+
+定義の番号・日時・参照有無の保存欄・子の並び順は意味上の差から分ける。`definitions.matches` に番号の前後/number_changed、geometry_equal/semantic_equal、内容差と全保存差を残す。対応する参照にも `definition_representation_differences` を付ける。番号や名前だけで同値にしない。子の並びは多重集合で比較し、一意でない許容内対応は保留。名前だけ同じで形が違う定義も一覧で確認できる。
+
+選択参照から到達する入れ子も局所構造を再帰比較する。勝手に平らな図形へ展開しない。欠落・番号重複・循環・深さ64超・参照の未確認レイヤ優先表現は保留。全複合展開は片側20万レコード上限、定義内候補は20万組上限で、超えたら停止/保留理由を報告する。**編集/取込みで入れ子を許可する変更ではない。** 選択参照外の定義は `definitions.outside_selected_references` に保存値を残すが、意味比較の完了範囲には含めない。
+
+多角形ソリッドは保存頂点順1,3,2,4から外周を比べ、巡回・逆順の差は保存表現差に残す。任意RGB/線色/線種/線幅/レイヤ/flagは比較し、GUI再保存による31→1等をこのAPIで暗黙に正規化しない。円ソリッドは既存の確認済み保存表現（101の全円/楕円/弓形、105の真円全周円環）を扱い、中心・半径/軸・傾き・弓形の範囲・塗り・RGBを比べる。円環の内半径も幾何比較に必ず含める。未観測の塗り/flag組合せは理由付き対象外。
+
+## 許容・位置合わせ
+
+許容はすべて既定0。`position_tolerance` は選んだunitsの座標/半径/軸長、`angle_tolerance_degrees` は度（0〜180）、`text_size_tolerance` は文字幅/高さ/間隔の紙面mmである。整数/文字列/フラグへ誤差を適用しない。真偽値、非有限値、負値を拒否する。実務の正の許容を自動で選ばない。
+
+右側だけ読取り上の位置合わせをする場合は `right_transform={"rotation_degrees": 5, "translation": [1000, -500]}` と明示する。選んだ座標単位の原点周りに回転した後、平行移動する。元図面は変えず、倍率・反転・基準点の自動推定はしない。2点からの算出/誤差確認は既存の位置合わせ機能で別途行い、その結果を明示入力する。
+
+候補探索に空間索引を使うが、丸めた値だけで一致にしない。各候補の点距離・軸長差・角度差を検査する。点/文字の基準点、円/円弧の中心、線の中点が候補索引の基準である。角度許容だけ広げても端点/円弧の位置差が座標許容を超えれば一致しない。候補数の上限 `max_candidate_pairs` は既定200万。超えたら結果を返さず、対象範囲を絞るか明示的に上限を変更する。
+
+## 分類と保留
+
+| category/欄 | 意味 |
+|---|---|
+| unchanged | 対象とした幾何・属性・内容が許容内で一致 |
+| attributes_changed | 幾何/内容は対応し、属性または参照する設定が異なる |
+| text_changed | 基準位置/方向が対応し文字内容が異なる。字体等の併発差も残す |
+| added / deleted | 右にだけ/左にだけある。元図面の削除操作を意味しない |
+| ambiguous | 対応候補が一意でない。最近傍で無理に決めない |
+| partial_lines | 部分被覆、隙間、非一意の行先/属性、重複の多重度差等 |
+| unsupported | 初版対象外の種類、未確認依存等 |
+
+移動や形状変更は原則、削除＋追加になる。文字は内容に伴う保存終点の変化だけで別位置にしない。元の保存表現（端点順、終点、角度表現等）の差は `representation_differences` に別記する。符号付き0や表現の差があっても幾何が等しい場合があるので、unchangedをバイト同一と読まない。
+
+完全な同値を先に対応付け、その後の幾何候補は双方から一意の対応だけを採用する。より複雑な候補グラフを最適化して無理に結ばず、曖昧として残す。同値の重複は多重集合で扱い、余剰は追加/削除へ残す。同じ重複群の番号対応は集計上の対応で、同一個体の履歴を復元したものではない。
+
+線の分割/結合は、タスクDで承認済みの全区間被覆・一意の行先の規則を基に、A→B/B→A両方向を確認する。元線は分割/結合しない。各側の属性/行先が一意で、全体を覆い、重複線の多重度差を隠さない場合だけ `line_partition_equivalent`。部分/曖昧はcomplete=False。保存分割の違いをそのまま追加/削除で見たい場合は `line_coverage=False`。
+
+## JSONの見方と実図面での注意
+
+最初に `complete`、`unsupported`、`ambiguous`、`partial_lines` を確認する。summaryの一致件数だけで合格にしない。matchesの件数は対応群数なので、線1対2は1群である。`element_accounting` にA/B各側の要素数と分類別数を出し、選択した全要素がいずれかに含まれることを検証する。
+
+`left_entities/right_entities` に元の全保存欄・比較座標・属性依存、matchesに番号・変更欄/旧新値・残差、settings_differencesに群/層の差を持つ。`A_difference_indices/B_difference_indices` は、Jw_cadの「読込み済み側の選択」「指定ファイル側の仮線」という確認の役割に対応する。ただしJw_cadと同じ内部比較アルゴリズムと保証するものではない。
+
+実図面の差し替え前後では、新しい建築に旧建築と同じ形・属性が含まれることがある。独立比較はそれを同値と認めるため、「退避した495件」といった編集履歴の数と一致しない場合がある。編集操作の証拠は既存safe_edit.diff_report、指定群の完全不変の証拠はsnapshot_group/audit_group_unchangedで確認する。新APIでそれらの厳密条件を緩めない。
+
+原本のSHAは比較の前後で確認する。比較JSONは図面と同じ扱いで、ローカルに新規名で保存する。既存JWFの運用前提を尊重し、比較結果をJWW/JWFへ自動反映しない。

jwwkit/guides/docs/edit_results.md

@@ -0,0 +1,59 @@
+# 編集結果の共通形（CadDocument31メソッド）
+
+従来のCadDocumentの戻り値と例外、safe_edit.execute_planの結果は変えない。共通結果が必要な場合だけedit_resultの新しい窓口を使う。直接編集する承認不要の入口は追加しない。元図面を上書きせず、具体的な計画とSHAをチャットで示し、利用者承認後に実行する。
+
+```python
+from jwwkit import CadDocument
+from jwwkit.edit_result import write_edit_plan, preview_plan_result, execute_plan_result
+
+def prepare_move(source, output, plan_path, indices, delta_real_mm):
+    cad = CadDocument.open(source)
+    actions = [{'op': 'move_entities', 'indices': list(indices),
+                'kwargs': {'delta': list(delta_real_mm), 'units': 'real'}}]
+    return write_edit_plan(cad, list(indices), actions, output, plan_path)
+
+def inspect_plan(plan_path, plan_sha):
+    return preview_plan_result(plan_path, plan_sha256=plan_sha, mode='summary')
+
+def run_approved(plan_path, approved_hash):
+    # approved_hashは、この計画の一覧をチャットで示し承認を得た後に渡す。
+    # EditExecutionErrorが出たら、その.resultを報告して処理を止める。
+    return execute_plan_result(plan_path, approved_sha256=approved_hash)
+```
+
+prepare_moveは計画JSONだけを書き、図面は保存しない。戻ったplan.path/sha256と、計画内の全対象・操作・出力を示して承認を得る。status=plannedのprojected_countsは見込みであり実施件数ではない。inspect_planはSHAが一致する計画の読取り/試行だけで、実行の承認にはならない。
+
+write_edit_planはcommon_result=Trueのsafe_edit計画schema5を作る。CadDocument31メソッドだけの許可表を持ち、任意メソッド名・任意Pythonを実行しない。未編集のファイル由来CadDocumentと従来の対象/依存/全属性検査が必要。JwwDocument・LegacyDocument・place_jws・GUIはこの窓口の対象外。
+
+旧計画schema1～4でも31メソッドの範囲ならexecute_plan_resultで共通結果を受け取れる。既知のworkflow付きschema4も既存の完全監査を維持する。新しいschema5を従来execute_planへ渡した場合は拒否し、共通結果窓口へ案内する。schema5とworkflowの同時計画作成は拒否し、既存schema4を共通結果で実行する。旧計画の内容や承認SHAは書き換えない。
+
+## 結果
+
+- schema_version/operation/status/phase：planned/applied/unchanged/rejected/failed、plan/memory/saved/verifiedを区別する。各操作はメモリ段階、全体は保存/読戻しが合格して初めてverifiedとなる。
+- counts：added/modified/deleted/rejected/unchangedは図面直下の要素数。定義の子を直下要素として重複計上しない。新しい要素のsource_index=Noneが複数あっても、操作内の位置でそれぞれ数える。
+- resource_counts：definitions/groups/layersを別集計。群の名前/縮尺/状態と、各レイヤの名前/状態を分離する。定義は日時を含む保存レコードの全欄で比べる。
+- changes：before_index/after_index、前後の内容、resource_type。source_indexや番号は同じ取引内の追跡用で、別図面の対応付けや永続IDではない。
+- rejections/rejected_operation_count：拒否された操作と理由。counts.rejectedは特定できる既存対象数、対象を特定できなければnull。新規追加の拒否はrejected_addition_count、資源はresource_rejectionsへ分ける。
+- warnings/warning_count/warning_codes：群縮尺の変更で実寸が変わること、destination設定方針、既知の定義内flag2正規化等の注意。error_summaryはcount/summaryでも拒否理由を示す（長大な文面は4096文字まで、切詰めを明示）。
+- before_model_sha256/after_model_sha256：現在の要素・定義・群/層・metadata等を含むモデル監査値。原本ファイルのSHAとは別。approval_plan_sha256で承認した計画を識別する。
+- operation_data：必要な場合の旧戻り値のJSON表現。operation_totalsは操作別合計、最上位countsは元図面からの純変更。追加→変更→削除等では一致しないことがある。
+
+operation_countはCadDocumentメソッドの呼出し件数、action_countは計画の行数。1行が複数対象へ単体メソッドを呼ぶ場合は異なる。試行ではprojected_operation_totals、破棄されたメモリ処理ではstaged_operation_totalsを使い、実施済みの合計と混同しない。
+
+ブロック置換は従来の取引追跡に合わせ、先頭対象のsource_indexを参照が引き継ぐため変更1、残りの対象は削除として数える。定義追加は別。内容ハッシュの一致で別の要素を勝手に同一視しない。
+
+## 原子的な処理と失敗
+
+モデルと引数をコピーしたステージ上でメソッドを呼び、保存前検証まで通った場合だけその取引内へ反映する。呼出し元のモデルや要素リストを途中で変更しない。既知のValueError/TypeError/IndexErrorによる拒否は、元の文面と型を保ってrejectedへ写す。許容超過をpassed=Falseで返す位置合わせも拒否とする。
+
+予期しない不具合、読書き、監査、保存後の検査失敗はEditExecutionErrorとして再送出し、.resultに証拠を付ける。例外を無視して次の操作へ進めない。途中で拒否された計画は、前のメモリ操作も取引として破棄し、prior_operations_discarded/各操作のdiscardedを示す。前の操作のメモリ件数を、保存済みの変更数と呼ばない。
+
+成功時は別名JWW・従来.changes.jsonに加え、同じ出力名の.edit-result.jsonを新規保存する。入力/依存/計画/設定と重なる場合、または既存ファイルがある場合は事前に停止する。報告書だけの保存が失敗しても例外で止まり、既に検証済みの図面と未検証の残存ファイルを区別してfiles_createdへ残す。失敗ファイルを自動削除せず、原本を変更しない。
+
+## 詳細の上限
+
+limit既定100/最大1000、mode=details/summary/count。見込み/実件数は全対象を検査した集計であり、詳細の切詰めと別。changes/operations/拒否/注意にtotal/returned/truncatedを付け、1一覧の詳細JSONは最大1MiBとする。巨大な1件が枠に収まらなければ省略を明示する。count/summaryでは詳細・operation_dataを返さないが、件数・ハッシュ・検証・error_summaryは残す。別プロセスの続き取得やnext_cursorは作っていない。
+
+完全なステージ検証のため内部ではモデルを複製する。件数だけの指定が処理を省略する意味ではない。大図面での速度/メモリ保証はしていない。diff_reportは同じ元の編集追跡、群不変監査は対象外の保全、図面比較は独立図面の意味照合として使い分ける。
+
+全31メソッドの一覧は[common_edit_result_coverage.md](common_edit_result_coverage.md)、関数引数は[api_list.md](api_list.md)。

jwwkit/guides/docs/geometry_view.md

@@ -0,0 +1,64 @@
+# 共通形状
+
+不変のReadViewに対して `geometry_view` を呼ぶ。元図面を編集・保存せず、実寸mmは `units="real"`（既定）、紙面mmは `"paper"` を指定する。実寸はルートの群縮尺を適用し、ブロックの子は定義の紙面座標に配置・回転・倍率を順次合成する。子の保存群の縮尺は重ねて掛けない。要素番号はこのビュー内だけの番号であり、図面間のIDではない。
+
+## 使い方
+
+次は全コードを合成図面で実行するテストに登録している。`input.jww` を利用者のローカルのファイル名へ置き換える。既存の `geometry.json` は上書きしない。
+
+```python
+import json
+from jwwkit import CadDocument
+from jwwkit.read_view import create_read_view
+from jwwkit.geometry_view import entity_geometry, geometry_page, text_frame_distance
+
+view = create_read_view(CadDocument.open('input.jww'))
+first = entity_geometry(view, 0, units='real', text_mode='frame')
+details = geometry_page(view, limit=2, text_mode='frame')
+counts = geometry_page(view, mode='count')
+summary = geometry_page(view, mode='summary', fields=['bbox'], text_mode='frame')
+frame_distance = text_frame_distance(first, [0, 0])
+with open('geometry.json', 'x', encoding='utf-8') as stream:
+    json.dump(dict(first=first, details=details, counts=counts,
+                   summary=summary, frame_distance=frame_distance),
+              stream, ensure_ascii=False, indent=2, allow_nan=False)
+```
+
+`entity_geometry` は1要素、`child_path` は読取りビューと同じ寸法の `['line']` / `['text']`、参照の `['definition', 子番号]` 等を指定できる。子を引いてもルートからの配置を合成した座標を返す。mode0寸法の未使用補助欄を描画形状に含めない。`basis="persisted"` は現在のルートに対応する保存時のレコードを使い、新規要素なら未判定となる。削除済み要素を復元する指定ではない。
+
+## 返す値と判定
+
+形状の各欄は `status/value/reason/method` を持つ。`exact` は保存情報から解析的に確定、`approximate` は明示した誤差内の折線近似、`undetermined` は未判定、`not_applicable` はその量なし、`not_requested` は要求していない欄。`complete` は要求欄について判定できたかを示し、Jw_cadの画面のピクセルや文字の字形との一致を保証しない。
+
+| 欄 | 意味 |
+|---|---|
+| kind | line / circle / arc / point / text / solid / circle_solid / dimension / block |
+| bbox | `[xmin,ymin,xmax,ymax]`。線幅・点記号・字形のはみ出しを含めない幾何範囲 |
+| segments | 始終点の線分一覧。曲線は明示したcurve_toleranceがある場合だけ近似 |
+| contours | 開いた線、解析的な円・円弧、閉じた多角形、円環の穴等。全てが閉輪郭とは限らない |
+| center | 中点、支持円の中心、多角形面積重心等。center_kindで区別。複合要素の一意な中心は返さない |
+| representative_points | 始終点・中点・頂点・配置点等。point_kind/on_geometryで区別 |
+| text_frame | 保存始点・終点・高さ・角度による通常文字の論理枠。字形外形ではない |
+| glyph_bbox | 実際の字体の字形範囲。共通形状では未判定 |
+
+既定のfieldsはbbox/contours/center/representative_points/text_frame。`fields=['bbox','segments']` のように絞れる。円弧のbboxは端点と区間内の座標極値で解析的に求め、折線近似から推定しない。曲線の線分が必要なら `curve_tolerance=0.01` 等を**利用者が指定**する（選択したunitsのmm）。矢高の上限・実際の上限を返し、segment上限超過時は黙って粗くせず未判定とする。
+
+文字は既定 `text_mode="glyph"` では字形bboxを未判定とする。`"frame"` を明示するとbbox/輪郭/中心も文字枠のものになる。枠は既存の通常文字の終点規則で保存終点を照合し、確認済み字体・基準点・通常flagの範囲に限って返す。64 ULPの照合幅は浮動小数点演算用であり、図面の業務許容値ではない。文字種の保存サイズと宣言サイズが矛盾する場合、縦書き・寸法文字等の特殊flag、未確認字体・制御文字、非等方なブロック内の文字は未判定とする。
+
+`text_frame_distance` は枠の**領域**への距離（内部は0）、`boundary=True` は枠の境界への距離。`distance_kind` はそれぞれtext_frame_distance/text_frame_boundary_distanceで、字形への距離とは別。枠が未判定なら距離も未判定。全要素の最近検索は位置検索で扱い、共通形状には含めない。
+
+真円・円弧と確認済みの円ソリッド（円板・弓形・円環）は解析的に返す。楕円や円が非等方倍率で楕円になる配置は、中心だけ確定し外形等は未判定とする。多角形は保存頂点順1,3,2,4から単純な非ゼロ面積の輪郭を確認する。自己交差等を推測で補正しない。ブロックの循環・欠落・未確認参照属性、未知要素は未判定。ある子の範囲が不明な場合、既知の子だけのpartial_bboxを全体bboxとして扱わない。これらは読取り専用で、入れ子の新規作成など編集の拒否条件を変更しない。
+
+## 件数と実行量
+
+`geometry_page` のdetailsは既定100/最大1000ルートまで、total/returned/truncatedを返す。子はpartsに含まれ、ルート件数へ二重計上しない。countは形状計算なし。summaryは全ルートを順次評価し、判定別件数・未判定の理由を返す。`evaluation_complete` と `examined` を必ず確認する。時間上限（既定30秒、最大300秒）はルート間で確認する協調的な上限で、1つのルートの計算中に強制終了するものではない。上限で残りを計算できなければTIME_LIMITと未完了を明記する。未判定0を意味するdetermination_completeとは区別する。
+
+1ルートあたりmax_segments=10000、max_children=100000、max_depth=64を既定の上限とし、limitsでは小さくする指定だけ受ける。件数上限はJSONバイト数や厳密なRAM上限ではない。別プロセスの続き取得・カーソル・offsetは**今回作らない**。背景は[ページ継続の検討](https://github.com/tetsuo-m/jwwkit/blob/main/docs/design/read_view_continuation.md)を参照。
+
+## 保存値・意味値・表示値
+
+保存値は読取りビューの `storage.persisted_record`（元レコード）、現在の値は読取りビューのvalues等で読む。共通形状はそこから群縮尺と配置を適用した**意味としての幾何値**を返し、単位と計算根拠を明記する。人に見せる丸め・単位付き表現は読取りビューのdisplay/propertiesや利用側で作り、丸めた表示値を形状計算に戻さない。読取りビューの未計算bboxを書き換えたり、保存された値を共通形状の近似値に置き換えたりしない。名前はkind/bbox等を採用するが他ライブラリとのJSON互換を意味しない。
+# 文字終点の数値比較
+
+通常文字枠の既知終点を比較する丸めガードは、ローカル紙面の文字長Lと座標桁Mに対しmax(64*ulp(M), 1e-9*L)。図面の寸法誤差の許容ではない。群縮尺と等方なブロック配置倍率で実寸換算したガードが1e-4mm以上なら未判定とし、上限へ切り詰めない。紙面/実寸の出力指定で判定を変えず、元の終点も補正しない。特殊flag・保存線幅・文字種の条件は維持する。
+

jwwkit/guides/docs/jwf_key_catalog.md

@@ -0,0 +1,244 @@
+# JWFのキーと保存区分
+
+jwwkitが識別する230キーと、JWWへの保存に関する分類です。各設定の意味や入力できる値は、お手元のJw_cadのヘルプで確認してください。
+
+|保存区分|説明|
+|---|---|
+|`drawing_saved`|図面の保存欄に対応する設定です。|
+|`drawing_saved_or_conditional`|図面への保存や対応が条件によって変わる設定です。|
+|`environment_behavior`|作図環境や操作時の動きに関わる設定です。|
+|`mixed_or_control`|複数の設定や読み込みの制御を含む項目です。|
+|`unresolved`|図面の保存欄との対応を確認中の項目です。|
+
+|キー|保存区分|
+|---|---|
+|`S_COMM_0`|`mixed_or_control`|
+|`S_COMM_1`|`mixed_or_control`|
+|`S_COMM_2`|`mixed_or_control`|
+|`S_COMM_3`|`mixed_or_control`|
+|`S_COMM_4`|`mixed_or_control`|
+|`S_COMM_5`|`mixed_or_control`|
+|`S_COMM_6`|`mixed_or_control`|
+|`S_COMM_7`|`mixed_or_control`|
+|`S_COMM_8`|`mixed_or_control`|
+|`S_COMM_9`|`mixed_or_control`|
+|`R_STR0_00`|`mixed_or_control`|
+|`R_CROSS_SET`|`environment_behavior`|
+|`S_MESH_0`|`unresolved`|
+|`ZOOM`|`environment_behavior`|
+|`LAYSCALE`|`drawing_saved`|
+|`LTYPE_02`|`drawing_saved_or_conditional`|
+|`LTYPE_03`|`drawing_saved_or_conditional`|
+|`LTYPE_04`|`drawing_saved_or_conditional`|
+|`LTYPE_05`|`drawing_saved_or_conditional`|
+|`LTYPE_06`|`drawing_saved_or_conditional`|
+|`LTYPE_07`|`drawing_saved_or_conditional`|
+|`LTYPE_08`|`drawing_saved_or_conditional`|
+|`LTYPE_09`|`drawing_saved_or_conditional`|
+|`LTYPE_R1`|`drawing_saved_or_conditional`|
+|`LTYPE_R2`|`drawing_saved_or_conditional`|
+|`LTYPE_R3`|`drawing_saved_or_conditional`|
+|`LTYPE_R4`|`drawing_saved_or_conditional`|
+|`LTYPE_R5`|`drawing_saved_or_conditional`|
+|`LTYPE_L1`|`drawing_saved_or_conditional`|
+|`LTYPE_L2`|`drawing_saved_or_conditional`|
+|`LTYPE_L3`|`drawing_saved_or_conditional`|
+|`LTYPE_L4`|`drawing_saved_or_conditional`|
+|`LTYPE_HC`|`drawing_saved_or_conditional`|
+|`LCOLLOR_1`|`drawing_saved_or_conditional`|
+|`LCOLLOR_2`|`drawing_saved_or_conditional`|
+|`LCOLLOR_3`|`drawing_saved_or_conditional`|
+|`LCOLLOR_4`|`drawing_saved_or_conditional`|
+|`LCOLLOR_5`|`drawing_saved_or_conditional`|
+|`LCOLLOR_6`|`drawing_saved_or_conditional`|
+|`LCOLLOR_7`|`drawing_saved_or_conditional`|
+|`LCOLLOR_8`|`drawing_saved_or_conditional`|
+|`LCOLLOR_G`|`mixed_or_control`|
+|`LCOLLOR_H`|`unresolved`|
+|`LCOLLOR_S`|`unresolved`|
+|`LCOLLOR_K`|`unresolved`|
+|`LCOLLOR_B`|`unresolved`|
+|`LCOLLOR_Z`|`unresolved`|
+|`LCOLLOR_M`|`unresolved`|
+|`PCOLLOR_1`|`drawing_saved_or_conditional`|
+|`PCOLLOR_2`|`drawing_saved_or_conditional`|
+|`PCOLLOR_3`|`drawing_saved_or_conditional`|
+|`PCOLLOR_4`|`drawing_saved_or_conditional`|
+|`PCOLLOR_5`|`drawing_saved_or_conditional`|
+|`PCOLLOR_6`|`drawing_saved_or_conditional`|
+|`PCOLLOR_7`|`drawing_saved_or_conditional`|
+|`PCOLLOR_8`|`drawing_saved_or_conditional`|
+|`PCOLLOR_G`|`drawing_saved_or_conditional`|
+|`MSET`|`mixed_or_control`|
+|`MHEN`|`mixed_or_control`|
+|`MWIDE`|`drawing_saved`|
+|`MHIGH`|`drawing_saved`|
+|`MDIST`|`drawing_saved`|
+|`MPEN`|`drawing_saved`|
+|`MOFST`|`drawing_saved_or_conditional`|
+|`S_STR1`|`drawing_saved_or_conditional`|
+|`S_STR2`|`drawing_saved_or_conditional`|
+|`S_STR3`|`drawing_saved_or_conditional`|
+|`S_SET1`|`drawing_saved_or_conditional`|
+|`S_SET2`|`drawing_saved_or_conditional`|
+|`S_SET3`|`drawing_saved_or_conditional`|
+|`S_SET4`|`drawing_saved_or_conditional`|
+|`S_SET5`|`drawing_saved_or_conditional`|
+|`ZF_SET`|`unresolved`|
+|`SL_SET`|`unresolved`|
+|`CU_SET`|`unresolved`|
+|`MS_SET`|`unresolved`|
+|`HATCH_0`|`unresolved`|
+|`HATCH_1`|`unresolved`|
+|`HATCH_2`|`unresolved`|
+|`HATCH_3`|`unresolved`|
+|`HATCH_4`|`unresolved`|
+|`HATCH_5`|`unresolved`|
+|`LAYNAM_N`|`mixed_or_control`|
+|`LAYNAM_0`|`drawing_saved`|
+|`LAYNAM_1`|`drawing_saved`|
+|`LAYNAM_2`|`drawing_saved`|
+|`LAYNAM_3`|`drawing_saved`|
+|`LAYNAM_4`|`drawing_saved`|
+|`LAYNAM_5`|`drawing_saved`|
+|`LAYNAM_6`|`drawing_saved`|
+|`LAYNAM_7`|`drawing_saved`|
+|`LAYNAM_8`|`drawing_saved`|
+|`LAYNAM_9`|`drawing_saved`|
+|`LAYNAM_A`|`drawing_saved`|
+|`LAYNAM_B`|`drawing_saved`|
+|`LAYNAM_C`|`drawing_saved`|
+|`LAYNAM_D`|`drawing_saved`|
+|`LAYNAM_E`|`drawing_saved`|
+|`LAYNAM_F`|`drawing_saved`|
+|`LAYCOL_0`|`environment_behavior`|
+|`LAYCOL_1`|`environment_behavior`|
+|`LAYCOL_2`|`environment_behavior`|
+|`LAYCOL_3`|`environment_behavior`|
+|`LAYCOL_4`|`environment_behavior`|
+|`LAYCOL_5`|`environment_behavior`|
+|`LAYCOL_6`|`environment_behavior`|
+|`LAYCOL_7`|`environment_behavior`|
+|`LAYCOL_8`|`environment_behavior`|
+|`LAYCOL_9`|`environment_behavior`|
+|`LAYCOL_A`|`environment_behavior`|
+|`LAYCOL_B`|`environment_behavior`|
+|`LAYCOL_C`|`environment_behavior`|
+|`LAYCOL_D`|`environment_behavior`|
+|`LAYCOL_E`|`environment_behavior`|
+|`LAYCOL_F`|`environment_behavior`|
+|`LAYWID_0`|`environment_behavior`|
+|`LAYWID_1`|`environment_behavior`|
+|`LAYWID_2`|`environment_behavior`|
+|`LAYWID_3`|`environment_behavior`|
+|`LAYWID_4`|`environment_behavior`|
+|`LAYWID_5`|`environment_behavior`|
+|`LAYWID_6`|`environment_behavior`|
+|`LAYWID_7`|`environment_behavior`|
+|`LAYWID_8`|`environment_behavior`|
+|`LAYWID_9`|`environment_behavior`|
+|`LAYWID_A`|`environment_behavior`|
+|`LAYWID_B`|`environment_behavior`|
+|`LAYWID_C`|`environment_behavior`|
+|`LAYWID_D`|`environment_behavior`|
+|`LAYWID_E`|`environment_behavior`|
+|`LAYWID_F`|`environment_behavior`|
+|`LAYTYP_0`|`environment_behavior`|
+|`LAYTYP_1`|`environment_behavior`|
+|`LAYTYP_2`|`environment_behavior`|
+|`LAYTYP_3`|`environment_behavior`|
+|`LAYTYP_4`|`environment_behavior`|
+|`LAYTYP_5`|`environment_behavior`|
+|`LAYTYP_6`|`environment_behavior`|
+|`LAYTYP_7`|`environment_behavior`|
+|`LAYTYP_8`|`environment_behavior`|
+|`LAYTYP_9`|`environment_behavior`|
+|`LAYTYP_A`|`environment_behavior`|
+|`LAYTYP_B`|`environment_behavior`|
+|`LAYTYP_C`|`environment_behavior`|
+|`LAYTYP_D`|`environment_behavior`|
+|`LAYTYP_E`|`environment_behavior`|
+|`LAYTYP_F`|`environment_behavior`|
+|`COM_LAY00`|`environment_behavior`|
+|`COM_LAY01`|`environment_behavior`|
+|`COM_LAY11`|`environment_behavior`|
+|`COM_LAY21`|`environment_behavior`|
+|`COM_LAY31`|`environment_behavior`|
+|`COM_LAY41`|`environment_behavior`|
+|`LD_AM`|`environment_behavior`|
+|`LD_PM`|`environment_behavior`|
+|`RD_AM`|`environment_behavior`|
+|`RD_PM`|`environment_behavior`|
+|`LD2_AM`|`environment_behavior`|
+|`LD2_PM`|`environment_behavior`|
+|`RD2_AM`|`environment_behavior`|
+|`RD2_PM`|`environment_behavior`|
+|`GCOM_100`|`environment_behavior`|
+|`GCOM_110`|`environment_behavior`|
+|`GCOM_120`|`environment_behavior`|
+|`GCOM_130`|`environment_behavior`|
+|`GCOM_140`|`environment_behavior`|
+|`GCOM_150`|`environment_behavior`|
+|`GCOM_160`|`environment_behavior`|
+|`GCOM_170`|`environment_behavior`|
+|`GCOM_180`|`environment_behavior`|
+|`GCOM_190`|`environment_behavior`|
+|`N_KEY`|`environment_behavior`|
+|`KEY_A`|`environment_behavior`|
+|`KEY_B`|`environment_behavior`|
+|`KEY_C`|`environment_behavior`|
+|`KEY_D`|`environment_behavior`|
+|`KEY_E`|`environment_behavior`|
+|`KEY_F`|`environment_behavior`|
+|`KEY_G`|`environment_behavior`|
+|`KEY_H`|`environment_behavior`|
+|`KEY_I`|`environment_behavior`|
+|`KEY_J`|`environment_behavior`|
+|`KEY_K`|`environment_behavior`|
+|`KEY_L`|`environment_behavior`|
+|`KEY_M`|`environment_behavior`|
+|`KEY_N`|`environment_behavior`|
+|`KEY_O`|`environment_behavior`|
+|`KEY_P`|`environment_behavior`|
+|`KEY_Q`|`environment_behavior`|
+|`KEY_R`|`environment_behavior`|
+|`KEY_S`|`environment_behavior`|
+|`KEY_T`|`environment_behavior`|
+|`KEY_U`|`environment_behavior`|
+|`KEY_V`|`environment_behavior`|
+|`KEY_W`|`environment_behavior`|
+|`KEY_X`|`environment_behavior`|
+|`KEY_Y`|`environment_behavior`|
+|`KEY_Z`|`environment_behavior`|
+|`KEYF2`|`environment_behavior`|
+|`KEYF3`|`environment_behavior`|
+|`KEYF4`|`environment_behavior`|
+|`KEYF5`|`environment_behavior`|
+|`KEYF6`|`environment_behavior`|
+|`KEYF7`|`environment_behavior`|
+|`KEYF8`|`environment_behavior`|
+|`KEYF9`|`environment_behavior`|
+|`KEYSP`|`environment_behavior`|
+|`KEY76`|`environment_behavior`|
+|`WD_COM`|`environment_behavior`|
+|`AC_COM`|`environment_behavior`|
+|`LD2_RV`|`environment_behavior`|
+|`RD2_RV`|`environment_behavior`|
+|`COM_RV01`|`unresolved`|
+|`COM_RV11`|`unresolved`|
+|`COM_RV21`|`unresolved`|
+|`COM_RV31`|`unresolved`|
+|`COM_RV41`|`unresolved`|
+|`COM_RV_C`|`unresolved`|
+|`R_CROSS_ST1`|`unresolved`|
+|`R_CROSS_ST2`|`unresolved`|
+|`R_CROSS_ST3`|`unresolved`|
+|`R_CROSS_ST4`|`unresolved`|
+|`R_CROSS_ST5`|`unresolved`|
+|`R_CROSS_ST6`|`unresolved`|
+|`P_dpi`|`unresolved`|
+|`TNKZ_SET`|`unresolved`|
+|`TNK3_NM1`|`unresolved`|
+|`TNK3_NM2`|`unresolved`|
+|`TNKN_SET`|`unresolved`|
+|`REF_FILE`|`unresolved`|

jwwkit/guides/docs/jwf_readonly.md

@@ -0,0 +1,76 @@
+# JWF 読取り・要約を前提にした作図運用
+
+目的は、AIの作図と人の目視確認で同じ前提を共有すること。現段階は**読取り・宣言値の比較のみ**。Jw_cadへの適用、JWF/JWWの編集、書出しは行わない。識別できるキーと保存区分は[JWFのキー一覧](jwf_key_catalog.md)または `jwf_setting_catalog()` で確認できます。設定値の詳しい意味は、お手元のJw_cadのヘルプを参照してください。
+
+## 書式と読取りの範囲
+
+- Jw_cad同梱Sample.jwfと単位指定例はCP932で検査した。利用者のJWFには不完全なCP932名を含む場合もある。置換・補完・切捨てはしない。openの既定はstrict、明示errors="preserve"なら生バイト/不完全値を保持し、値の解釈は拒否する。UTF-8/UTF-16は明示指定で検査できるが、Jw_cadがその符号化を読めると確認した意味ではない。自動推測しない。
+- `KEY = values`。半角スペースを数値区切りとする。同梱例にはタブもあり本Readerでは区切るが、Jw側の全ケースの受入れを保証しない。全角空白は数値区切りにせず診断する。
+- `#`行は注釈、`END`以降は非活性。Sample冒頭ENDを削除したものと勝手に読み替えない。未記載は未指定であり、前回環境/プロフィール/JWW/既定値のいずれになるかを推測しない。
+- 名前は半角カンマ区切り、空欄も保持。`LAYNAM_N=0`の空欄は無変更、1は無名指定。名前の途中のカンマにCSVの引用規則を推測適用しない。17欄超は図面との比較を未確定にする。
+- 通常数値、16進bitパターン、`S_COMM_0`の群層16進やA0/2A用紙名、桁別の複数フラグが混在する。valuesは文字列、numberは明示base=10/16だけ。意味の未確認な値を汎用の浮動小数へ変換しない。
+- フォントの `"$<ＭＳ ゴシック>` は通常の閉じた引用文字列ではない。先頭の引用符から行末を保持する。`#`を値の途中でコメント開始と推測しない。
+- 重複キーの優先順位は未確認。勝手なlast-winsにせずgetを拒否、diffではambiguous_duplicate。未知キー/未知構文も診断し、他設定の読取りと区別する。
+- `A-Read` / `A-Read0` が先頭10行にある場合は、編集後自動読込の指示として記録するだけで、本APIでは実行しない。起動時専用指定と手動読込みの違いもある。
+
+## 使い方（読み取りだけ）
+
+```python
+from pathlib import Path
+from jwwkit import JwfDocument, jwf_setting_catalog
+from jwwkit import CadDocument
+
+config = JwfDocument.open(Path("settings.jwf"), errors="preserve")
+red = config.get("PCOLLOR_1").number(0)  # 先頭のR値。0始まり。
+fields = config.get("PCOLLOR_1").values()
+info = jwf_setting_catalog()["PCOLLOR_1"]  # 項目名と保存区分
+other = JwfDocument.open(Path("other.jwf"))
+changes = config.diff(other)
+stored = config.compare_drawing(CadDocument.open(Path("drawing.jww")))
+```
+
+JWFの要約や差分は、業務名やパスを含むことがあるため、図面と同じ範囲で扱う。JSONに保存するときはensure_ascii=Trueで不完全CP932のsurrogate escapeを欠損せず記録する。
+
+コマンドで調べる場合：`jwwkit inspect-jwf --source settings.jwf --other other.jwf --drawing drawing.jww --preserve-invalid --output new_report.json`。同名出力は拒否する。比較にSampleを使う場合は既定では適用0件同士の比較となる。END後の例を意図して参照するときだけ `--include-after-end` を指定し、既定値や有効環境と混同しない。
+
+## JWW保存の区別と比較の意味
+
+| 分類 | 例 | 確認範囲 |
+|---|---|---|
+| drawing_saved | LAYSCALE、LAYNAM_0〜F、MWIDE/MHIGH/MDIST/MPEN | 同梱説明と既存の確定JWW欄。縮尺0/既存データ群、空名/保護など、JWF適用には条件がある |
+| drawing_saved_or_conditional | 表示/印刷色、線種、寸法設定、文字基準点ずれ | 同梱HelpがJWW保存と読込選択を説明。全ビットの保存位置/対照は未確定 |
+| environment_behavior | キー/クロック割当、コマンド層切替、外部変形登録、入力時層色/幅/種、画面操作 | 環境動作の説明は確認。これらの値がJWW内に絶対存在しないことを全バイト対照で証明した区分ではない |
+| mixed_or_control | S_COMM_*、MSET、MHEN等 | 保存される値/環境操作/適用制御が混在。一行全体を「JWWだけ/環境だけ」と断定しない |
+| unresolved | その他未確定欄 | 未確定のまま返す。必要なら計画/承認後にネイティブ対照 |
+
+compare_drawingで現在対応するのは文字種40欄、16群縮尺、群/層名、LCOLLOR_1〜8のRGB。RGBは確定したJWW palette COLORREFの下位R/G/Bと比較。LCOLLOR幅やPCOLLOR印刷値のJWW欄は未確定で、比較不能を返す。0/空欄は無変更条件でnot_applicable。名前の保護/260byte制限、占有群、実読込順をシミュレートしない。sameは「保存値/宣言欄が一致」であり、画面/印刷まで同じ有効環境を保証しない。not_comparable/unresolvedを一致数に加えない。
+
+重要な依存：Sample S_COMM_8の第3欄（0始まり2）は寸法設定の保存/読込制御（十の位保存、一の位読込）。Help基本設定の「ファイル読込項目」は線色/線種/点半径、描画印刷状態、文字基準点ずれの取込みを選べると説明している。したがって**同じJWFを使うだけでは、開いたJWWの後の画面/印刷が同じと断定できない**。JWF→JWWとJWW→JWFの順序、起動時専用指定、プロフィール、フォント、プリンタ/Direct2Dも確認する。
+
+## 採用した運用：AIは要約を参照し、目視は利用者の環境で行う
+
+JWFとJWWの設定優先関係・未解析欄は未確定として扱う。本手順はJw_cadの環境へJWFを読込ませず、追加のGUI対照や再試行を自動で行わない。公開読取りAPIで確定した保存欄と未確定を区別する。
+
+AIが図面を作成・編集するときは、ローカルの `AI_settings_summary.json` を前提とし、利用者が自身のJw_cad環境で最終の表示・印刷を目視確認する。利用者は要約と対応するJWFをローカル作業フォルダに用意する。
+
+1. 要約の `source_sha256` と参照元JWFの実ハッシュを照合する。JWFが変わっていたら、古い要約を流用せず差を報告して要約を更新する。要約自体のSHAも図面の計画/実行記録に残す。既存safe_editがこのJSONを自動依存登録する機能は実装されていないため、記録を省略せず、同期機能があるように説明しない。
+2. 要約の設定宣言と利用者確認の意図を分けて読む。例えば書込みレイヤを赤、他をグレーにする確認用運用もあるが、配布版の既定ではない。採用したJWFの前提を利用者に確認し、要素の保存線色番号へ一律に反映しない。
+3. 位置・寸法は実寸mmを基本にし、対象群の実際の縮尺を読む。文字種番号・幅/高さ/間隔・字体、線色/線種/線幅は要約の前提と図面の保存属性の両方を確認する。文字幅等の紙面mmと実寸mmを混同しない。依頼/図面/要約が食い違うときは勝手に優先順位を決めず報告する。
+4. 既存図面の編集は従来の対象一覧→計画JSON/SHA→利用者承認→実行→保存後読戻し/差分報告を守る。要約を使うこと自体は編集や環境適用の承認ではない。JWWの設定や全体ヘッダーを要約へ自動同期しない。
+5. 利用者へ別名出力、変更要素数/内容、参照JWF/要約のハッシュ、使用した設定・未確定欄を渡す。見え方、印刷色、線幅、字体、寸法の最終確認は利用者の環境で行う。読み直しや属性監査が合格しても、同じ有効環境/同じ表示を証明したとはしない。
+
+要約は未指定値/未知値を補う既定値表ではない。JWF由来の名前や業務情報も、図面と同じ範囲で扱う。不完全CP932、名前の欄数超過、フォント/描画方式/出力機器/読込順の未確定をそのまま報告する。既存のPDF自動検査・JWW全属性/DXF監査を行う場面では、従来の条件も維持する。
+
+## JWF作成・書出しの設計記録
+
+JWFの作成や書出しは未実装です。検討内容は[JWF作成・書出しの設計記録](https://github.com/tetsuo-m/jwwkit/blob/main/docs/design/jwf_writing_proposal.md)にあります。
+
+## 根拠
+
+- Jw_cadの付属ヘルプとSample.jwfを参照し、JWWへの保存に関する確認結果を分類した。
+- 公式配布：https://www.jwcad.net/download.htm
+- 公式サイトの相談記録（同梱説明との照合に使用）：https://www.jwcad.net/log/infox3/infox3-0707-12/thread10524.htm 、https://www.jwcad.net/log/consult2/consult2-0610-12/thread17978.htm 。主根拠は現地同梱Help/Sampleと実ファイル・確定JWW欄であり、古い掲示板だけで現行値を断定しない。
+
+## 別PCでの個人設定の用意
+
+参照JWFとAI_settings_summary.jsonは利用者がローカルに用意し、元JWFのSHAと要約の対応を確認する。JWF・要約・設定値・診断ログは図面と同じ扱いでローカルに保管する。ファイルの移動や変更があれば、採用する参照とSHAを利用者と確認し直す。印刷色の宣言だけから描画状態やJWW読込み時の優先関係を推測しない。