@kensnzk/koyu 0.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (61) hide show
  1. package/.github/workflows/ci.yml +16 -0
  2. package/.zenodo.json +20 -0
  3. package/CITATION.cff +26 -0
  4. package/LICENSE +73 -0
  5. package/NOTICE +2 -0
  6. package/README.ja.md +71 -0
  7. package/README.md +72 -0
  8. package/docs/decisions/0001-notation-v0.md +29 -0
  9. package/docs/decisions/0002-height-and-offsets.md +27 -0
  10. package/docs/decisions/0003-uncounted-divisions.md +36 -0
  11. package/docs/decisions/0004-typical-floors.md +21 -0
  12. package/docs/decisions/0005-zones-and-unions.md +23 -0
  13. package/docs/decisions/0006-voids-and-light.md +31 -0
  14. package/docs/decisions/0007-semi-outdoor-air.md +27 -0
  15. package/docs/decisions/0008-vocabulary-and-level-attr.md +23 -0
  16. package/docs/decisions/0009-site-and-exterior.md +29 -0
  17. package/docs/ifc-coverage.md +82 -0
  18. package/docs/ifcx-notes.md +25 -0
  19. package/docs/img/house-L1.svg +80 -0
  20. package/docs/img/house-L2.svg +53 -0
  21. package/docs/img/mansion-L1.svg +113 -0
  22. package/docs/img/mansion-L10.svg +111 -0
  23. package/docs/img/mansion-L5.svg +160 -0
  24. package/docs/img/office-L1.svg +116 -0
  25. package/docs/img/office-L2.svg +109 -0
  26. package/docs/img/two-rooms.svg +39 -0
  27. package/docs/log/2026-07-22.md +13 -0
  28. package/docs/log/2026-07-23.md +51 -0
  29. package/docs/roadmap.md +55 -0
  30. package/docs/writing-architecture.md +119 -0
  31. package/examples/comparison/README.md +38 -0
  32. package/examples/comparison/gen-ifc4.ts +133 -0
  33. package/examples/comparison/gen-ifcx.ts +134 -0
  34. package/examples/comparison/two-rooms.ifc +152 -0
  35. package/examples/comparison/two-rooms.ifcx +1030 -0
  36. package/examples/comparison/validate-ifc.ts +33 -0
  37. package/examples/house.muro +89 -0
  38. package/examples/mansion.muro +187 -0
  39. package/examples/office.muro +110 -0
  40. package/examples/two-rooms.canonical.json +111 -0
  41. package/examples/two-rooms.muro +22 -0
  42. package/package.json +33 -0
  43. package/spec/notation-v0.md +164 -0
  44. package/spec/vocabulary.md +62 -0
  45. package/src/check.ts +302 -0
  46. package/src/cli.ts +281 -0
  47. package/src/graph.ts +306 -0
  48. package/src/index.ts +8 -0
  49. package/src/light.ts +66 -0
  50. package/src/model.ts +367 -0
  51. package/src/parse.ts +512 -0
  52. package/src/plan.ts +334 -0
  53. package/src/site.ts +82 -0
  54. package/test/core.test.ts +171 -0
  55. package/test/design2.test.ts +97 -0
  56. package/test/house.test.ts +74 -0
  57. package/test/mansion.test.ts +99 -0
  58. package/test/office.test.ts +71 -0
  59. package/test/uncounted.test.ts +120 -0
  60. package/test/vertical.test.ts +75 -0
  61. package/tsconfig.json +13 -0
@@ -0,0 +1,164 @@
1
+ # koyu 記法 v0 (draft)
2
+
3
+ 状態: 素振り。この文書は二室一扉を書くために生まれた最初の記法の記録であり、確定仕様ではない。ここでの決定の理由は docs/decisions/0001-notation-v0.md に、思想は docs/writing-architecture.md にある。
4
+
5
+ 設計基準はひとつに固定する。**LLMが一つのコンテキストで読み切り、正しく部分編集できるか。** この基準から、テキストネイティブであること、参照が人間の読める階層パスであること、小さなファイルであること、単位と座標系を先頭で一度だけ宣言することが導かれる。
6
+
7
+ ## モデル
8
+
9
+ 一次要素は空間である。`space` は室・ゾーン・外部の領域を表し、階層パスで名指される。壁はそれ自体が独立した物ではなく、二つの空間の境界という関係 (`boundary`) として持つ。境界には厚み・仕様・耐火などの性能が属性として乗る。開口 (`door` / `window`) は境界に開いた接続である。骨格はグリッド (`grid`) とレベル (`level`) が与える。型は巨大なクラス階層ではなく開かれた語彙であり、`room` `corridor` `exterior` などのコア語彙に自由な語を足してよい。
10
+
11
+ 形はこのソースには無い。壁の線分は空間の割付から導出され、平面図は必要になった時に生成される。同じ構成から複数の形が出ることは欠陥ではない。
12
+
13
+ ## 記法 (author形式: 独自DSL)
14
+
15
+ ```
16
+ # 二室一扉 — 最初の一手
17
+
18
+ koyu 0.1
19
+ name 二室一扉
20
+ unit mm
21
+
22
+ grid X 0 3600 7200 # 通り芯 X1, X2, X3
23
+ grid Y 0 4500 # 通り芯 Y1, Y2
24
+ level L1 0 h:2400 # FL高さ 0、基準天井高 2400
25
+
26
+ space /L1/a room X1..X2 Y1..Y2 name:居室A
27
+ space /L1/b room X2..X3 Y1..Y2 name:居室B
28
+ space /out exterior name:外部
29
+
30
+ boundary /L1/a /L1/b t:120 spec:PW1
31
+ door w:780 h:2000
32
+
33
+ boundary /L1/a /out t:150 spec:EW1 fire:60
34
+ boundary /L1/b /out t:150 spec:EW1 fire:60
35
+ door w:900 h:2100 edge:S name:玄関
36
+ ```
37
+
38
+ 文法は次の通り。一行が一文であり、`キーワード 位置引数... key:value...` の形をとる。`#` 以降はコメント、値に空白を含めるときは `"..."` で囲む。字下げした行は直前の `boundary` に属する開口 (`door` / `window`) である。
39
+
40
+ `grid X 0 3600 7200` は昇順の座標 (mm) を宣言し、通り名 X1, X2, ... が自動で振られる。`level 名 z [h:天井高]` がレベルを宣言する。`space パス 型 [X?..X? Y?..Y?] [属性...]` は空間を宣言し、パスの先頭セグメントがレベル名ならそのレベルに属する。領域は v0 では通り芯で囲む矩形ひとつに限る。`exterior` のように領域を持たない空間も書ける。
41
+
42
+ `boundary パスA パスB [t:厚 type:wall|open 属性...]` は境界を宣言する。境界の壁芯線分は書かない — 二空間の割付から導出される。接していない空間の境界はエラーになる。`type:open` は垂れ壁のない開放境界で、扉なしで通行できる。外部のような領域なし空間との境界は、部屋の外周から他室と接する区間を除いた残りとなり、複数辺に分かれるため、開口を置くときは `edge:N/E/S/W` で辺を指定する。開口の位置は `at:0..1` (既定 0.5) で線分上に置く。
43
+
44
+ 既定値: 境界は `type:wall`、開口位置は `at:0.5`、描画時の壁厚は t 未指定なら 100mm。面積は壁芯で算定する。
45
+
46
+ ## 書き比べ — 同じ二室一扉を三つの形式で
47
+
48
+ v0 を決めるために、同じ場面を三つの形式で書いた。上の DSL が一つ目である。
49
+
50
+ 二つ目、YAML:
51
+
52
+ ```yaml
53
+ koyu: "0.1"
54
+ name: 二室一扉
55
+ unit: mm
56
+ grid:
57
+ X: [0, 3600, 7200]
58
+ Y: [0, 4500]
59
+ levels:
60
+ L1: {z: 0, h: 2400}
61
+ spaces:
62
+ /L1/a: {type: room, at: [X1, Y1, X2, Y2], name: 居室A}
63
+ /L1/b: {type: room, at: [X2, Y1, X3, Y2], name: 居室B}
64
+ /out: {type: exterior, name: 外部}
65
+ boundaries:
66
+ - between: [/L1/a, /L1/b]
67
+ t: 120
68
+ spec: PW1
69
+ openings:
70
+ - {kind: door, w: 780, h: 2000}
71
+ - between: [/L1/a, /out]
72
+ t: 150
73
+ spec: EW1
74
+ fire: 60
75
+ - between: [/L1/b, /out]
76
+ t: 150
77
+ spec: EW1
78
+ fire: 60
79
+ openings:
80
+ - {kind: door, w: 900, h: 2100, edge: S, name: 玄関}
81
+ ```
82
+
83
+ 三つ目、JSON。これは `koyu json` が吐く正準形そのものであり、全文は examples/two-rooms.canonical.json にある (111行)。抜粋:
84
+
85
+ ```json
86
+ {
87
+ "koyu": "0.1",
88
+ "name": "二室一扉",
89
+ "unit": "mm",
90
+ "grid": { "X": [0, 3600, 7200], "Y": [0, 4500] },
91
+ "spaces": {
92
+ "/L1/a": { "type": "room", "at": ["X1", "Y1", "X2", "Y2"], "attrs": { "name": "居室A" } }
93
+ },
94
+ "boundaries": [
95
+ { "between": ["/L1/a", "/L1/b"], "kind": "wall", "t": 120,
96
+ "openings": [{ "kind": "door", "w": 780, "h": 2000, "at": 0.5 }] }
97
+ ]
98
+ }
99
+ ```
100
+
101
+ | 観点 | DSL | YAML | JSON |
102
+ |---|---|---|---|
103
+ | 同じ場面の行数 | 14 (コメント除く) | 約30 | 111 |
104
+ | 人間の読み書き | 図面の密度に最も近い | 十分読める | 構造は明快だが冗長 |
105
+ | LLMの部分編集 | 一行一文で差し替えが局所的 | 良好 | 良好だが括弧の整合が絡む |
106
+ | diffの言葉 | 「この室が広がった」が一行で出る | 良好 | ノイズ多め |
107
+ | パーサ | 自作 (約300行で済んだ) | 既存 | 既存 |
108
+ | レイヤー合成 | 直接は不向き | 中間 | 最も素直 (IFCX/USDと同じ土俵) |
109
+
110
+ **決定: author形式はDSL、機械形式は正準JSON。** 人が(そしてLLMが)読み書きする原本はDSLで持ち、合成・diff・外部接続の土台には `koyu json` の正準形を使う。YAMLは両者の中間で決め手を欠くため見送る。DSLの代償はエディタ支援が無いことと文法の保守だが、文法を「一行一文 + key:value + 字下げ」から増やさないことで抑える。
111
+
112
+ ## 正準JSONの形 (機械形式)
113
+
114
+ `koyu json` が吐く正準JSONは次のキーを持つ。`koyu` (版)、`name`、`unit`、`grid` (X/Y各軸の座標配列 mm)、`levels` (名前→ `{z, h?}`)、`spaces` (パス→ `{type, at?, attrs?}`。`at` は `[XA, YA, XB, YB]` の通り名4つ)、`boundaries` (配列。各要素は `{between, kind, t?, edge?, attrs?, openings?}` で、`between` は昇順に並べた2パス、`openings` の各要素は `{kind, w, h?, at, edge?, attrs?}`)。
115
+
116
+ 安定性の規則: すべてのオブジェクトキーはソートされ、`spaces` はパス順、`boundaries` は `between` の辞書順に並ぶ。同じ構成からは常にバイト同一のJSONが出るため、diff・ハッシュ・レイヤー合成の土台に使える。素振り段階の現在は src/model.ts の `toCanonical()` の実装を正とし、本節はその写しである (乖離したらどちらを直すかをその時に決め、ADRに残す)。
117
+
118
+ ## v0.1 追補 — オフセットと高さ方向 (2026-07-23)
119
+
120
+ 複数レベル・廊下と複数室・芯外の壁を書くための追補。理由は ADR-0002、実例は examples/office.muro (2フロアのオフィス、約100行)。
121
+
122
+ **通り芯オフセット。** 領域の参照は `X2+600` `Y3-150` のように芯からの寸法を足し引きできる。座標の直書きは無い — 芯の言語を保つ。
123
+
124
+ **レベルと高さ。** `level L2 4000 h:2700 slab:1300` — z (FL)、h (基準天井高)、slab (その階の床組み厚: 下階天井面から自階FLまで)。空間は `h:` 属性で天井高を個別に持てる。checkが不変量「天井高 + 上階slab ≤ 階高」を検査し、超えると食い込みエラー。`levels` コマンドがテキストの矩計として積み上がりを表示する。最上部に空間を持たないレベル (屋根面) を宣言すると最上階にも上限が効く。
125
+
126
+ **垂直の境界。** 床は書かない — 垂直の隣接は平面の重なりから導出され、既定は床である。例外だけを書く: `boundary /L1/stair /L2/stair type:stair` (扉0枚で通行可)、`type:shaft` (EV等 — 連続するが通行不可)。壁境界 (`wall`/`open`) を異なるレベル間に書くとエラー。吹抜けは `type:void` として設計予定 (未実装)。
127
+
128
+ **基本計画の解像度。** このデータが表現するのは計画初期の解像度であり、垂れ壁・建具詳細・仕上げは持たない。`type:open` の境界は「垂れ壁があるか」を言わない — その決定は後段に属する。平面図では開放的な分節を破線で描く。
129
+
130
+ **stats の use 集計。** 空間に `use:rentable` / `use:common` などの属性を与えると、statsが面積比 (レンタブル比) を返す。
131
+
132
+ **基準階の反復 — 一度だけ書く (v0.2 / ADR-0004)。** レベルの等差宣言 `level L3..L9 6700 pitch:2900 h:2400 slab:500`、パスのスパン展開 `space /L2..L9/A unit ...` (宣言済みレベルのz順の並びへ展開。一行内の複数パスは同じスパンで、同じ階に揃う)、垂直積層の宣言 `stack ev L1..L10 type:shaft` (連続レベル対に垂直境界)。DSLは意図 (基準階は一つ) を保持し、正準JSONは展開後を持つ。例外階 (特定階だけ違う) は未対応 — 吹抜け (type:void) と同時に設計する。実例: examples/mansion.muro (10階建て43戸が159行 → 90空間・244境界)。
133
+
134
+ **数えない分節 (area / seg)。** 室を割らずに床材の切替や壁材の途中変更を書く従属要素 (ADR-0003)。`space` の字下げに `area X?..X? Y?..Y? floor:モルタル name:土間`、`boundary` の字下げに `seg at:0.75 w:3600 spec:ガラスパーティション` (位置は開口と同じ流儀)。隔離則: これらは面積・室数・グラフに一切影響しない。リトマス試験は「面積表に一行として現れてほしいか」(欲しければspace) と「そこを通れるかが問題になるか」(なるならboundary/opening)。平面図ではareaは淡い面+破線、segは壁の色調変化として描かれる。
135
+
136
+ ## v0.3 追補 — 間取り・L字・吹抜け・採光 (2026-07-23)
137
+
138
+ **L字の室 (ADR-0005)。** 領域は `+` で矩形を複数書ける合併になった: `space .../ldk ldk X1+2600..X2 Y1..Y2-1800 + X1..X1+2600 Y1..Y1+1400`。面積は合計、壁は合併の外周から導出、共線の外周は一本にマージされる。同一ペアがL字で2辺接するときの扉は `edge:` で辺を選ぶ。
139
+
140
+ **ゾーン = 数える集約 (ADR-0005)。** `zone /L2..L9/A name:Aタイプ use:exclusive` — 幾何を持たず、パス接頭辞で室を束ねる。面積は配下の合計、`use` は配下へ継承。住戸を間取りに割っても「専有面積」の言葉は壊れない。粒度は混在してよい (Aタイプだけ間取り、B〜Eは住戸一室)。
141
+
142
+ **吹抜け (ADR-0006)。** 上階に `type:void` の空間を置き、`boundary /L1/hall /L2/void type:void` で結ぶ。床は既定・接続 (stair) は例外・不在 (void) も例外。void境界は高さ不変量の宣言的免除で、下階は `h:6700` と階をまたげる (境界を消せばエラーが戻る)。voidは床面積不算入・通行不可、平面図では破線の対角線。**例外階は新記法なし** — スパンを割って書く。
143
+
144
+ **採光 `light` (ADR-0006)。** 住居系の居室で窓面積/床面積 ≥ 1/7 の粗い判定 (補正係数なし)。窓は `h:` があるものだけ数える。法規検証の芽の第一号。
145
+
146
+ ## v0.4 追補 — 半屋外・語彙の台帳・開き勝手・メゾネット (2026-07-23)
147
+
148
+ **air:1 と半屋外 (ADR-0007)。** kindに物の名は入れない (IfcRailingが要素であることに倣う)。手すりは `wall + spec:手すり + air:1` (遮蔽しない物)。半屋外は宣言ではなく導出 — 外部に対しopenまたはair:1の境界を持つ空間。statsで別掲、専有面積から除外、light 0.7掛け、平面図は細実線。
149
+
150
+ **語彙の台帳 (ADR-0008)。** 属性の付け方の規則は [vocabulary.md](vocabulary.md) が契約。kindはトポロジーだけ・物の名はspec・解釈される属性は台帳に載せる。
151
+
152
+ **開き勝手。** `door ... hinge:E swing:b` — 吊元 (線分の端) と開く側 (境界のa/b)。既定は始端・a側。
153
+
154
+ **メゾネット (ADR-0008)。** パスの第一義は集計の階層。階を跨ぐくくりは `level:` 属性で階を明示する: `space /home/bed1 ... level:L2`。ゾーンが階を跨いで住戸を束ねる (examples/house.muro)。
155
+
156
+ **部分吹抜け (ADR-0006追記)。** 下階の天井高は階高内のまま、吹抜け部分の高さは導出。全面吹抜け (被覆≥99%) のときだけ階をまたぐ天井高を宣言できる。下階平面に「上部吹抜け」の破線表示。
157
+
158
+ ## この数十行で決まったこと
159
+
160
+ 原稿の予告どおり、二室一扉を書くだけで四つの設計判断が言葉になった。空間の同一性は人間可読の階層パスに与える。境界はどちらの空間にも属させず、二つのパスを結ぶ第一級の関係とする。接続は境界上の開口とし、垂れ壁のない分節は `type:open` で表す。パスは `/レベル/空間` で切り、レベルに属さない外部はサイト直下に置く。それぞれの理由と代替案は ADR-0001 に記録した。
161
+
162
+ ## 開いている問い
163
+
164
+ 吹抜けと階をまたぐ空間、半屋外と外部空間の分節 (`/out` が一枚岩で良いはずがない)、室とゾーンの二層粒度 — これらは一フロアを書くとき (M1) に正面からぶつかる。記法側では、矩形ひとつに限った領域 (L字型の室が書けない)、開き勝手の記述 (v0は「先に書いた空間側へ開く」という描画規約に逃げている)、建具語彙の粒度、壁厚の振り分け (v0は芯振り分け固定)、面積規約 (v0は壁芯固定) が残っている。IFCのGUIDとの対応は、取り込み (M5) の際に `id:` 属性のレイヤーとして後置する。
@@ -0,0 +1,62 @@
1
+ # 語彙の台帳
2
+
3
+ 原稿の方針「意味の与え方は、巨大なクラス階層ではなく語彙」を運用に落とした文書。要素ごとに何が付くか、どの語をツールが解釈するかの契約であり、開かれた語彙の「開き方」の規則である (ADR-0007 / ADR-0008)。
4
+
5
+ ## 五つの規則
6
+
7
+ **1. kindは関係のトポロジーだけを言う。** boundaryのtype (wall/open/stair/shaft/void) はグラフ・導出・検査が構造として解釈する語で、増やすのは最後の手段。IFCが空間境界 (IfcRelSpaceBoundary) に Physical/Virtual しか言わせないのと同じ構えをとる。
8
+
9
+ **2. 物の名はspec語彙。** 手すり・RC・LGS・EW・ガラスパーティション… specの値は自由語で、ツールは解釈しない (運ぶだけ)。IFCで要素クラス (IfcRailing, IfcCurtainWall) にあたるものは、ここではspecの値である — 物は関係の属性、という転回の帰結。
10
+
11
+ **3. 解釈される属性は台帳に載せる。** ツールが読む属性 (下表の★) は契約であり、変えるときはADRを書く。それ以外の k:v は自由だが、同じ意味に別の語を使わないため、意味の定まった語はこの台帳に追記して育てる。台帳は一つ。
12
+
13
+ **4. 単位と形式。** 長さはmm、線分上の位置は0..1、面積の出力は㎡。属性キーは小文字英字、値は自由 (日本語可)、コアの値は英字。
14
+
15
+ **5. 継承と上書き。** `use` は zone→space に継承され、spaceの宣言が勝つ。`floor` は space→area が区間上書き。`spec` は boundary→seg が区間上書き。数えない分節 (area/seg) は上書きだけを運び、構成に影響しない (ADR-0003)。
16
+
17
+ ## 要素別の台帳
18
+
19
+ ### space
20
+ | 属性 | 解釈 | 意味 |
21
+ |---|---|---|
22
+ | type | ★一部 | 開かれた語彙。構造として解釈: `exterior` (外部 — 複数に割れる: /out/road等)・`void` (吹抜け)。lightの対象: `unit` `room` `ldk` `bedroom` `living` |
23
+ | road | ★ | exterior空間の幅員mm — 道路の印。siteコマンドが接道を導出する (ADR-0009) |
24
+ | 領域 | ★ | `X?..X? Y?..Y?` を `+` で合併 (L字)。オフセット `X2+600` 可 |
25
+ | level: | ★ | 所属レベルの明示。既定はパス先頭セグメント。階を跨ぐくくり (メゾネット) で使う |
26
+ | h | ★ | 天井高mm (既定はレベルのh)。高さ不変量とlevelsが読む |
27
+ | use | ★ | statsの集計軸 (rentable/exclusive/common…)。zoneから継承 |
28
+ | hab | ★ | lightの対象制御 (1で追加、0で除外) |
29
+ | name / floor / … | — | 自由。floorはareaが上書きできる |
30
+
31
+ ### boundary
32
+ | 属性 | 解釈 | 意味 |
33
+ |---|---|---|
34
+ | type | ★ | wall / open (水平) / stair / shaft / void (垂直)。既定 wall |
35
+ | t | ★ | 壁厚mm (芯振り分け)。描画と既定値100 |
36
+ | air | ★ | 1=遮蔽しない物 (手すり・柵)。半屋外の導出・細線描画・light 0.7 に効く |
37
+ | edge | ★ | 線分をa側矩形の特定の辺に限定 (N/E/S/W) |
38
+ | spec / fire / sound / h / … | — | 自由 (specは物の名。fire/soundはM2の区画クエリで解釈予定) |
39
+
40
+ ### opening (boundaryの字下げ)
41
+ | 属性 | 解釈 | 意味 |
42
+ |---|---|---|
43
+ | kind | ★ | door (通行) / window (採光。通行しない) |
44
+ | w / h | ★ | 幅・高さmm。windowのhはlightが読む |
45
+ | at | ★ | 線分上の位置0..1 (既定0.5) |
46
+ | edge | ★ | 複数線分の辺選択 |
47
+ | hinge | ★ | 開き勝手: 吊元 (水平線分はW/E、垂直線分はN/S。既定は始端側) |
48
+ | swing | ★ | 開き勝手: 開く側 (a/b。既定はa=領域を持つ側) |
49
+ | sill / name / … | — | 自由 |
50
+
51
+ ### level
52
+ `z` (位置引数)、`h` (基準天井高)、`slab` (床組み厚)、`pitch` (範囲宣言のみ) — すべて★。
53
+
54
+ ### zone
55
+ `name` (自由)、`use` (★継承元)、`site` (★ 1=敷地の集約 — siteコマンドの対象)、`area` (★ 敷地の宣言面積㎡ — 導出面積と照合される)。幾何を持たない。
56
+
57
+ ### area / seg (数えない分節)
58
+ 位置 (areaは領域、segはat/w/edge — ★) + 任意の上書き属性 (—)。
59
+
60
+ ## IFCとの対応 (参考)
61
+
62
+ boundary wall/open ↔ IfcRelSpaceBoundary の PHYSICAL/VIRTUAL。内外の別 ↔ InternalOrExternalBoundary (こちらは宣言でなく導出)。spec:手すり ↔ IfcRailing (要素クラスは語彙の値になる)。opening ↔ IfcOpeningElement + IfcDoor/IfcWindow。zone ↔ IfcZone。stair/shaft/void の垂直境界と slab の既定は、空間一次ゆえにIFCに直接の相当物を持たない。
package/src/check.ts ADDED
@@ -0,0 +1,302 @@
1
+ // koyu — 整合チェック
2
+ // コミットのたびに自動で回る検証の芽。構成の矛盾はここで言葉として現れる。
3
+ // 高さ方向の一貫性 — BIMが3Dであることで暗黙に担保していたもの — は、
4
+ // ここでは宣言された不変量 (天井高 + 上階slab ≤ 階高) の検査として明示的に持つ。
5
+ // 吹抜け (type:void) はこの不変量の宣言的な免除である。
6
+
7
+ import {
8
+ placeBand,
9
+ placeOpening,
10
+ planOverlap,
11
+ segmentsFor,
12
+ sharedSegment,
13
+ spacesOverlap,
14
+ } from "./graph.js";
15
+ import { heff, isSemiOutdoor, levelsSorted, type Model, type Space } from "./model.js";
16
+
17
+ export interface CheckResult {
18
+ errors: string[];
19
+ warnings: string[];
20
+ }
21
+
22
+ const EPS = 0.5;
23
+ const VERTICAL = new Set(["stair", "shaft", "void"]);
24
+
25
+ export function check(model: Model): CheckResult {
26
+ const errors: string[] = [];
27
+ const warnings: string[] = [];
28
+
29
+ // 境界の参照先
30
+ for (const b of model.boundaries) {
31
+ for (const p of [b.a, b.b]) {
32
+ if (!model.spaces.has(p)) {
33
+ errors.push(`${b.line}行目: 未定義の空間を参照しています: ${p}`);
34
+ }
35
+ }
36
+ if (b.a === b.b) {
37
+ errors.push(`${b.line}行目: 同じ空間同士の境界は書けません: ${b.a}`);
38
+ }
39
+ }
40
+
41
+ const withRect = [...model.spaces.values()].filter((s) => s.rects.length > 0);
42
+ const levels = levelsSorted(model);
43
+
44
+ // レベルの重複
45
+ for (let i = 1; i < levels.length; i++) {
46
+ if (Math.abs(levels[i]!.z - levels[i - 1]!.z) < EPS) {
47
+ errors.push(`レベル ${levels[i - 1]!.name} と ${levels[i]!.name} のzが同じです`);
48
+ }
49
+ }
50
+
51
+ // 自らの領域 (合併の矩形同士) の重なり
52
+ for (const s of withRect) {
53
+ for (let i = 0; i < s.rects.length; i++) {
54
+ for (let j = i + 1; j < s.rects.length; j++) {
55
+ if (planOverlap(s.rects[i]!, s.rects[j]!)) {
56
+ errors.push(`${s.line}行目: ${s.path} の領域同士が重なっています`);
57
+ }
58
+ }
59
+ }
60
+ }
61
+
62
+ // 同一レベルでの空間同士の重なり
63
+ for (let i = 0; i < withRect.length; i++) {
64
+ for (let j = i + 1; j < withRect.length; j++) {
65
+ const a = withRect[i]!;
66
+ const b = withRect[j]!;
67
+ if (a.level !== b.level) continue;
68
+ if (spacesOverlap(a, b)) {
69
+ errors.push(`空間の領域が重なっています: ${a.path} と ${b.path}`);
70
+ }
71
+ }
72
+ }
73
+
74
+ // 接しているのに境界が宣言されていない組 (同一レベル)
75
+ const declared = new Set(model.boundaries.map((b) => [b.a, b.b].sort().join("|")));
76
+ for (let i = 0; i < withRect.length; i++) {
77
+ for (let j = i + 1; j < withRect.length; j++) {
78
+ const a = withRect[i]!;
79
+ const b = withRect[j]!;
80
+ if (a.level !== b.level) continue;
81
+ const touching = a.rects.some((ra) => b.rects.some((rb) => sharedSegment(ra, rb)));
82
+ if (!touching) continue;
83
+ if (!declared.has([a.path, b.path].sort().join("|"))) {
84
+ warnings.push(`接しているのに境界が宣言されていません: ${a.path} | ${b.path}`);
85
+ }
86
+ }
87
+ }
88
+
89
+ // 境界の妥当性
90
+ const levelIndex = new Map(levels.map((l, i) => [l.name, i]));
91
+ for (const b of model.boundaries) {
92
+ const sa = model.spaces.get(b.a);
93
+ const sb = model.spaces.get(b.b);
94
+ if (!sa || !sb) continue;
95
+
96
+ if (VERTICAL.has(b.kind)) {
97
+ // 垂直境界: 隣り合うレベルの、平面で重なる空間同士にしか張れない
98
+ if (sa.rects.length === 0 || sb.rects.length === 0 || !sa.level || !sb.level) {
99
+ errors.push(`${b.line}行目: ${b.kind} 境界は領域とレベルを持つ空間同士に書きます`);
100
+ continue;
101
+ }
102
+ const ia = levelIndex.get(sa.level);
103
+ const ib = levelIndex.get(sb.level);
104
+ if (ia === undefined || ib === undefined || Math.abs(ia - ib) !== 1) {
105
+ errors.push(
106
+ `${b.line}行目: ${b.kind} 境界は隣り合うレベルの間に書きます: ${b.a} | ${b.b}`,
107
+ );
108
+ } else if (!spacesOverlap(sa, sb)) {
109
+ errors.push(
110
+ `${b.line}行目: ${b.kind} 境界の空間が平面上で重なっていません: ${b.a} | ${b.b}`,
111
+ );
112
+ }
113
+ if (b.kind === "void") {
114
+ const upper = (ia ?? 0) > (ib ?? 0) ? sa : sb;
115
+ if (upper.type !== "void") {
116
+ warnings.push(
117
+ `${b.line}行目: void境界の上側は type:void の空間を想定しています: ${upper.path}`,
118
+ );
119
+ }
120
+ }
121
+ if (b.openings.length > 0) {
122
+ warnings.push(`${b.line}行目: 垂直境界の開口は解釈されません`);
123
+ }
124
+ if (b.segs.length > 0) {
125
+ warnings.push(`${b.line}行目: 垂直境界の seg は解釈されません`);
126
+ }
127
+ continue;
128
+ }
129
+
130
+ // 水平境界
131
+ if (sa.rects.length > 0 && sb.rects.length > 0 && sa.level !== sb.level) {
132
+ errors.push(
133
+ `${b.line}行目: 異なるレベルの空間に壁境界は書けません (垂直は type:stair/shaft/void): ${b.a} | ${b.b}`,
134
+ );
135
+ continue;
136
+ }
137
+ const segs = segmentsFor(model, b);
138
+ if (sa.rects.length > 0 && sb.rects.length > 0 && segs.length === 0) {
139
+ errors.push(`${b.line}行目: 空間が接していないため境界を導けません: ${b.a} | ${b.b}`);
140
+ }
141
+ if ((sa.rects.length > 0 ? 1 : 0) + (sb.rects.length > 0 ? 1 : 0) === 1 && segs.length === 0) {
142
+ warnings.push(`${b.line}行目: 外周に残る辺が無く、境界線分がゼロです: ${b.a} | ${b.b}`);
143
+ }
144
+ if (b.kind === "open" && b.openings.length > 0) {
145
+ warnings.push(`${b.line}行目: open境界の開口は通行に影響しません (常に通れます)`);
146
+ }
147
+ for (const o of b.openings) {
148
+ const placed = placeOpening(model, b, o);
149
+ if ("error" in placed && placed.error) {
150
+ errors.push(placed.error);
151
+ continue;
152
+ }
153
+ if (o.hinge && "segment" in placed) {
154
+ const okAxis = placed.segment.horizontal
155
+ ? o.hinge === "W" || o.hinge === "E"
156
+ : o.hinge === "N" || o.hinge === "S";
157
+ if (!okAxis) {
158
+ errors.push(
159
+ `${o.line}行目: hinge:${o.hinge} は${
160
+ placed.segment.horizontal ? "水平線分 (W/E)" : "垂直線分 (N/S)"
161
+ }で指定します`,
162
+ );
163
+ }
164
+ }
165
+ }
166
+ for (const g of b.segs) {
167
+ if (b.kind === "open") {
168
+ warnings.push(`${g.line}行目: open境界 (壁が無い) の seg は解釈されません`);
169
+ continue;
170
+ }
171
+ const placed = placeBand(model, b, g, "seg");
172
+ if ("error" in placed && placed.error) {
173
+ errors.push(placed.error);
174
+ }
175
+ }
176
+ }
177
+
178
+ // 数えない分節 (area) は親の領域に収まっているか
179
+ for (const s of model.spaces.values()) {
180
+ for (const a of s.areas) {
181
+ if (s.rects.length === 0) {
182
+ errors.push(`${a.line}行目: 領域を持たない空間 ${s.path} に area は書けません`);
183
+ continue;
184
+ }
185
+ const inside = s.rects.some(
186
+ (r) =>
187
+ a.rect.x1 >= r.x1 - EPS &&
188
+ a.rect.x2 <= r.x2 + EPS &&
189
+ a.rect.y1 >= r.y1 - EPS &&
190
+ a.rect.y2 <= r.y2 + EPS,
191
+ );
192
+ if (!inside) {
193
+ warnings.push(`${a.line}行目: area が ${s.path} の領域からはみ出しています`);
194
+ }
195
+ }
196
+ }
197
+
198
+ // ゾーン: 束ねる空間が実在するか
199
+ for (const z of model.zones.values()) {
200
+ const children = [...model.spaces.keys()].filter((p) => p.startsWith(z.path + "/"));
201
+ if (children.length === 0) {
202
+ warnings.push(`${z.line}行目: ゾーン ${z.path} の下に空間がありません`);
203
+ }
204
+ if (model.spaces.has(z.path)) {
205
+ warnings.push(`${z.line}行目: ゾーンと同じパスの空間があります (どちらかに寄せます): ${z.path}`);
206
+ }
207
+ }
208
+
209
+ // 高さ方向の一貫性: 下階の空間の天井高 + 上階のslab ≤ 階高
210
+ // 吹抜け (void境界) は宣言的な免除だが、免除が効くのは吹抜けが平面を覆う範囲まで —
211
+ // 部分吹抜けでは下階の天井高は階高内に収める (吹抜け部分の高さは導出) (ADR-0006追記)
212
+ const voidPartners = new Map<string, Space[]>();
213
+ for (const b of model.boundaries) {
214
+ if (b.kind !== "void") continue;
215
+ const sa = model.spaces.get(b.a);
216
+ const sb = model.spaces.get(b.b);
217
+ if (!sa?.level || !sb?.level) continue;
218
+ const ia = levelIndex.get(sa.level) ?? 0;
219
+ const ib = levelIndex.get(sb.level) ?? 0;
220
+ const lower = ia < ib ? sa : sb;
221
+ const upper = ia < ib ? sb : sa;
222
+ const key = `${lower.path}|${upper.level}`;
223
+ const arr = voidPartners.get(key) ?? [];
224
+ arr.push(upper);
225
+ voidPartners.set(key, arr);
226
+ }
227
+
228
+ const byLevel = new Map<string, Space[]>();
229
+ for (const s of withRect) {
230
+ if (!s.level) continue;
231
+ const arr = byLevel.get(s.level) ?? [];
232
+ arr.push(s);
233
+ byLevel.set(s.level, arr);
234
+ }
235
+ for (let i = 0; i + 1 < levels.length; i++) {
236
+ const lb = levels[i]!;
237
+ const lu = levels[i + 1]!;
238
+ const below = byLevel.get(lb.name) ?? [];
239
+ const above = byLevel.get(lu.name) ?? [];
240
+ const pitch = lu.z - lb.z;
241
+ let slabMissing = false;
242
+ for (const s of below) {
243
+ if (isSemiOutdoor(model, s)) continue; // 屋外・半屋外 (庭・バルコニー等) に天井は無い
244
+ const covered = above.some((u) => spacesOverlap(s, u)) || above.length === 0;
245
+ if (!covered) continue;
246
+ if (lu.slab === undefined) {
247
+ slabMissing = true;
248
+ continue;
249
+ }
250
+ const h = heff(model, s);
251
+ if (h === undefined) {
252
+ warnings.push(`${s.path} の天井高が不明で、${lu.name} との高さ検査ができません`);
253
+ continue;
254
+ }
255
+ if (h + lu.slab > pitch + EPS) {
256
+ const partners = voidPartners.get(`${s.path}|${lu.name}`) ?? [];
257
+ const cover = partners.length ? voidCoverage(s, partners) : 0;
258
+ if (cover >= 0.99) continue; // 全面吹抜け — 宣言的免除
259
+ errors.push(
260
+ partners.length
261
+ ? `${s.path} の天井高${h}は階高${pitch}を超えますが、吹抜けの被覆は${Math.round(
262
+ cover * 100,
263
+ )}%です。部分吹抜けでは天井高を階高内に収めます (吹抜け部分の高さは導出)`
264
+ : `${s.path} が上階に食い込みます: 天井高${h} + ${lu.name}のslab${lu.slab} = ${
265
+ h + lu.slab
266
+ } > 階高${pitch}`,
267
+ );
268
+ }
269
+ }
270
+ if (slabMissing) {
271
+ warnings.push(
272
+ `レベル ${lu.name} に slab が未宣言のため、${lb.name} との高さ検査ができません`,
273
+ );
274
+ }
275
+ }
276
+
277
+ // レベルに載らない領域つき空間
278
+ for (const s of withRect) {
279
+ if (!s.level) {
280
+ warnings.push(
281
+ `${s.line}行目: ${s.path} は領域を持ちますが、レベルが特定できません (パス先頭か level: で指定します)`,
282
+ );
283
+ }
284
+ }
285
+
286
+ return { errors, warnings };
287
+ }
288
+
289
+ /** 吹抜けが下階の空間の平面をどれだけ覆うか (0..1) */
290
+ function voidCoverage(s: Space, partners: Space[]): number {
291
+ let inter = 0;
292
+ for (const r of s.rects) {
293
+ for (const p of partners) {
294
+ for (const pr of p.rects) {
295
+ const o = planOverlap(r, pr);
296
+ if (o) inter += (o.x2 - o.x1) * (o.y2 - o.y1);
297
+ }
298
+ }
299
+ }
300
+ const area = s.rects.reduce((sum, r) => sum + (r.x2 - r.x1) * (r.y2 - r.y1), 0);
301
+ return area > 0 ? inter / area : 0;
302
+ }