@kensnzk/koyu 0.14.0 → 0.16.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.
- package/README.ja.md +4 -2
- package/README.md +5 -3
- package/dist/cli.js +156 -81
- package/dist/cli.js.map +1 -1
- package/dist/core/derive.d.ts +259 -0
- package/dist/core/derive.d.ts.map +1 -0
- package/dist/core/derive.js +570 -0
- package/dist/core/derive.js.map +1 -0
- package/dist/{check.d.ts → core/diagnose.d.ts} +11 -12
- package/dist/core/diagnose.d.ts.map +1 -0
- package/dist/{check.js → core/diagnose.js} +232 -221
- package/dist/core/diagnose.js.map +1 -0
- package/dist/core/diff.d.ts.map +1 -0
- package/dist/{diff.js → core/diff.js} +84 -41
- package/dist/core/diff.js.map +1 -0
- package/dist/{fabric.d.ts → core/fabric.d.ts} +4 -0
- package/dist/core/fabric.d.ts.map +1 -0
- package/dist/{fabric.js → core/fabric.js} +4 -3
- package/dist/core/fabric.js.map +1 -0
- package/dist/{graph.d.ts → core/graph.d.ts} +1 -3
- package/dist/core/graph.d.ts.map +1 -0
- package/dist/{graph.js → core/graph.js} +43 -51
- package/dist/core/graph.js.map +1 -0
- package/dist/core/light.d.ts +24 -0
- package/dist/core/light.d.ts.map +1 -0
- package/dist/{light.js → core/light.js} +15 -10
- package/dist/core/light.js.map +1 -0
- package/dist/{model.d.ts → core/model.d.ts} +124 -13
- package/dist/core/model.d.ts.map +1 -0
- package/dist/{model.js → core/model.js} +193 -50
- package/dist/core/model.js.map +1 -0
- package/dist/core/parse.d.ts.map +1 -0
- package/dist/{parse.js → core/parse.js} +528 -116
- package/dist/core/parse.js.map +1 -0
- package/dist/{poly.d.ts → core/poly.d.ts} +3 -2
- package/dist/core/poly.d.ts.map +1 -0
- package/dist/{poly.js → core/poly.js} +8 -9
- package/dist/core/poly.js.map +1 -0
- package/dist/core/site.d.ts.map +1 -0
- package/dist/core/site.js.map +1 -0
- package/dist/core/tolerance.d.ts +26 -0
- package/dist/core/tolerance.d.ts.map +1 -0
- package/dist/core/tolerance.js +48 -0
- package/dist/core/tolerance.js.map +1 -0
- package/dist/{vertical.d.ts → core/vertical.d.ts} +41 -12
- package/dist/core/vertical.d.ts.map +1 -0
- package/dist/{vertical.js → core/vertical.js} +45 -104
- package/dist/core/vertical.js.map +1 -0
- package/dist/core/vocabulary.d.ts +40 -0
- package/dist/core/vocabulary.d.ts.map +1 -0
- package/dist/core/vocabulary.js +164 -0
- package/dist/core/vocabulary.js.map +1 -0
- package/dist/{axo.d.ts → draw/axo.d.ts} +1 -1
- package/dist/draw/axo.d.ts.map +1 -0
- package/dist/{axo.js → draw/axo.js} +53 -81
- package/dist/draw/axo.js.map +1 -0
- package/dist/draw/index.d.ts +3 -0
- package/dist/draw/index.d.ts.map +1 -0
- package/dist/draw/index.js +11 -0
- package/dist/draw/index.js.map +1 -0
- package/dist/draw/plan.d.ts +10 -0
- package/dist/draw/plan.d.ts.map +1 -0
- package/dist/draw/plan.js +284 -0
- package/dist/draw/plan.js.map +1 -0
- package/dist/index.d.ts +15 -11
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +49 -12
- package/dist/index.js.map +1 -1
- package/dist/mcp.js +71 -40
- package/dist/mcp.js.map +1 -1
- package/dist/parse-file.d.ts +1 -1
- package/dist/parse-file.d.ts.map +1 -1
- package/dist/parse-file.js +1 -1
- package/dist/parse-file.js.map +1 -1
- package/dist/validate/access.d.ts +6 -0
- package/dist/validate/access.d.ts.map +1 -0
- package/dist/validate/access.js +238 -0
- package/dist/validate/access.js.map +1 -0
- package/dist/validate/envelope.d.ts +4 -0
- package/dist/validate/envelope.d.ts.map +1 -0
- package/dist/validate/envelope.js +55 -0
- package/dist/validate/envelope.js.map +1 -0
- package/dist/validate/index.d.ts +60 -0
- package/dist/validate/index.d.ts.map +1 -0
- package/dist/validate/index.js +77 -0
- package/dist/validate/index.js.map +1 -0
- package/dist/validate/light.d.ts +6 -0
- package/dist/validate/light.d.ts.map +1 -0
- package/dist/validate/light.js +28 -0
- package/dist/validate/light.js.map +1 -0
- package/dist/validate/runs.d.ts +16 -0
- package/dist/validate/runs.d.ts.map +1 -0
- package/dist/validate/runs.js +60 -0
- package/dist/validate/runs.js.map +1 -0
- package/dist/validate/site.d.ts +6 -0
- package/dist/validate/site.d.ts.map +1 -0
- package/dist/validate/site.js +63 -0
- package/dist/validate/site.js.map +1 -0
- package/editors/vscode/.vscodeignore +2 -0
- package/editors/vscode/README.md +28 -0
- package/editors/vscode/extension.js +150 -0
- package/editors/vscode/language-configuration.json +19 -0
- package/editors/vscode/package.json +57 -0
- package/editors/vscode/syntaxes/koyu.tmLanguage.json +226 -0
- package/examples/basement/main.muro +1 -1
- package/examples/complex/main.muro +1 -1
- package/examples/house/main.muro +2 -2
- package/examples/house.muro +2 -2
- package/examples/mansion.muro +2 -2
- package/examples/office.muro +2 -2
- package/examples/steps/01-one-room.muro +1 -1
- package/examples/steps/02-two-rooms.muro +1 -1
- package/examples/steps/03-door.muro +1 -1
- package/examples/steps/04-exterior.muro +1 -1
- package/examples/steps/05-two-storeys.muro +1 -1
- package/examples/steps/06-finished.muro +2 -2
- package/examples/tower/main.muro +1 -1
- package/examples/twin/L1.muro +136 -119
- package/examples/twin/L5.muro +85 -123
- package/examples/twin/assets.muro +10 -8
- package/examples/twin/basement.muro +43 -34
- package/examples/twin/core.muro +148 -65
- package/examples/twin/hotel.muro +66 -107
- package/examples/twin/main.muro +73 -67
- package/examples/twin/office.muro +87 -88
- package/examples/twin/podium.muro +309 -97
- package/examples/twin/residence.muro +61 -116
- package/examples/twin/site.muro +16 -13
- package/examples/two-rooms.canonical.json +4 -2
- package/examples/two-rooms.muro +2 -2
- package/package.json +16 -1
- package/spec/README.md +28 -0
- package/spec/canonical-json.md +98 -0
- package/spec/composition.md +121 -0
- package/spec/derivation.md +393 -0
- package/spec/en/README.md +30 -0
- package/spec/en/canonical-json.md +101 -0
- package/spec/en/composition.md +121 -0
- package/spec/en/derivation.md +393 -0
- package/spec/en/language.md +164 -0
- package/spec/en/notation-v0.md +145 -0
- package/spec/en/scope.md +229 -0
- package/spec/en/semantics.md +132 -0
- package/spec/en/tools.md +108 -0
- package/spec/en/validation.md +79 -0
- package/spec/en/vocabulary.md +103 -0
- package/spec/language.md +163 -0
- package/spec/notation-v0.md +184 -0
- package/spec/scope.md +229 -0
- package/spec/semantics.md +130 -0
- package/spec/tools.md +106 -0
- package/spec/validation.md +79 -0
- package/spec/vocabulary.md +114 -0
- package/src/cli.ts +165 -80
- package/src/core/derive.ts +852 -0
- package/src/{check.ts → core/diagnose.ts} +260 -229
- package/src/{diff.ts → core/diff.ts} +84 -40
- package/src/{fabric.ts → core/fabric.ts} +4 -3
- package/src/{graph.ts → core/graph.ts} +47 -60
- package/src/core/light.ts +69 -0
- package/src/{model.ts → core/model.ts} +236 -52
- package/src/{parse.ts → core/parse.ts} +584 -116
- package/src/{poly.ts → core/poly.ts} +8 -9
- package/src/core/tolerance.ts +55 -0
- package/src/{vertical.ts → core/vertical.ts} +65 -115
- package/src/core/vocabulary.ts +197 -0
- package/src/{axo.ts → draw/axo.ts} +51 -94
- package/src/draw/index.ts +11 -0
- package/src/draw/plan.ts +344 -0
- package/src/index.ts +181 -35
- package/src/mcp.ts +76 -40
- package/src/parse-file.ts +2 -2
- package/src/validate/access.ts +279 -0
- package/src/validate/envelope.ts +59 -0
- package/src/validate/index.ts +107 -0
- package/src/validate/light.ts +43 -0
- package/src/validate/runs.ts +87 -0
- package/src/validate/site.ts +84 -0
- package/dist/axo.d.ts.map +0 -1
- package/dist/axo.js.map +0 -1
- package/dist/check.d.ts.map +0 -1
- package/dist/check.js.map +0 -1
- package/dist/diff.d.ts.map +0 -1
- package/dist/diff.js.map +0 -1
- package/dist/fabric.d.ts.map +0 -1
- package/dist/fabric.js.map +0 -1
- package/dist/graph.d.ts.map +0 -1
- package/dist/graph.js.map +0 -1
- package/dist/light.d.ts +0 -15
- package/dist/light.d.ts.map +0 -1
- package/dist/light.js.map +0 -1
- package/dist/model.d.ts.map +0 -1
- package/dist/model.js.map +0 -1
- package/dist/parse.d.ts.map +0 -1
- package/dist/parse.js.map +0 -1
- package/dist/plan.d.ts +0 -10
- package/dist/plan.d.ts.map +0 -1
- package/dist/plan.js +0 -354
- package/dist/plan.js.map +0 -1
- package/dist/poly.d.ts.map +0 -1
- package/dist/poly.js.map +0 -1
- package/dist/site.d.ts.map +0 -1
- package/dist/site.js.map +0 -1
- package/dist/vertical.d.ts.map +0 -1
- package/dist/vertical.js.map +0 -1
- package/src/light.ts +0 -63
- package/src/plan.ts +0 -472
- /package/dist/{diff.d.ts → core/diff.d.ts} +0 -0
- /package/dist/{parse.d.ts → core/parse.d.ts} +0 -0
- /package/dist/{site.d.ts → core/site.d.ts} +0 -0
- /package/dist/{site.js → core/site.js} +0 -0
- /package/src/{site.ts → core/site.ts} +0 -0
package/spec/language.md
ADDED
|
@@ -0,0 +1,163 @@
|
|
|
1
|
+
[English](en/language.md) · **日本語**
|
|
2
|
+
|
|
3
|
+
# 言語リファレンス — .muro (author形式)
|
|
4
|
+
|
|
5
|
+
koyu v0.16.0 現在の記法の規範。意味論 (導出・検査・問い) は [semantics.md](semantics.md)、属性の契約は [vocabulary.md](vocabulary.md)。
|
|
6
|
+
|
|
7
|
+
## 1. 字句
|
|
8
|
+
|
|
9
|
+
**一行が一文。** 各行は `キーワード 位置引数... key:value...` の形をとる。トークンは空白区切り。`#` 以降は行末までコメント。値に空白や `#` を含めるときは `"..."` で囲む (引用符はトークンのどこに現れてもよく、閉じなければエラー)。字下げ (行頭の空白) された行は**直前の親行に従属する** — `boundary` の下の `door` / `window` / `seg`、`space` の下の `area`、`band` の下の `space` (§3 帯)。字下げは一段だけで、入れ子は無い。空行は無視。
|
|
10
|
+
|
|
11
|
+
**属性 `key:value`。** キーは `:` の左、値は右 (値が空ならエラー)。値が数値の形 (`-?\d+(\.\d+)?`) なら数値として、それ以外は文字列として保持される。同一行内の同名キーの重複はエラー — 後勝ちの黙認はtypoとマージ事故を隠す (ADR-0013。アセット既定値のインスタンス上書き〈§6〉は二つの出所であって重複ではない)。解釈される属性 (★) は vocabulary.md の台帳が契約で、それ以外のk:vは自由に書けてそのまま運ばれる。
|
|
12
|
+
|
|
13
|
+
**単位と座標系。** 長さはmm。平面は X (東+)・Y (北+)、高さは z (上+)。線分上の比率位置は 0..1。面積の出力は㎡ (壁芯)。
|
|
14
|
+
|
|
15
|
+
## 2. 基盤の宣言 (base層が一度だけ持つ)
|
|
16
|
+
|
|
17
|
+
```
|
|
18
|
+
koyu 1.0 # 版宣言 (base層でのみ・一度だけ)
|
|
19
|
+
name 街角の複合ビル # 建物名 (残りの行全体、空白可)
|
|
20
|
+
unit mm # v0はmmのみ
|
|
21
|
+
grid X 0 6400 12800 19200 # X軸の通り芯座標 (昇順・2つ以上)。X1,X2,...が自動命名
|
|
22
|
+
grid Y 0 5600 7600 13200
|
|
23
|
+
level L1 0 h:3600 slab:600 # レベル: 名 z [h:天井高] [slab:床組み厚]
|
|
24
|
+
level L4..L10 11000 pitch:3000 h:2500 slab:450 # 範囲宣言 (等差)。pitch必須
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
`grid` は軸ごとに一度だけ (合成時はbase層で)。`name` も一度だけ (同文なら再宣言可)。`level` の範囲宣言 `L4..L10` は接頭辞+連番で、`z + pitch×k` に展開される。レベル名の重複はエラー。空間を持たないレベル (例: 屋上 `R`) を宣言すると最上階の高さ検査の上限になる。
|
|
28
|
+
|
|
29
|
+
**版の規範 (ADR-0017)。** このツールが対応する言語版は `0.1, 0.2, 0.3, 0.4, 0.5, 1.0`、宣言を省略した場合は最新版 `1.0` の意味論で読む (省略はツール版を跨いで意味安定ではない — 意味を固定したいファイルは版を書く)。版の新旧はこの並びの順であって綴りの辞書順ではない (`1.0` は `0.5` より新しい)。版宣言は `koyu <版>` の2トークン (版なし・余分なトークンはエラー)、base層 (entry) でのみ・一度だけ (gridの規律 — 再宣言は同値でもエラー。合成順による黙った上書きを禁じる)。旧版は**意味保存の場合のみ**受理される — parseは読めるが、意味が変わるファイルは check がエラーにして二択を示す。`0.1` は既定境界 (§4) の導出が起きるとき (**VER01** — 境界を宣言するか `koyu 0.2` へ上げる)。`0.3` 以前は採光の対象を型から推定していたので、その型 (`unit` `room` `ldk` `bedroom` `living`) の空間に `daylight` が書かれていないとき (**VER02** — `daylight:1`/`daylight:0` を書いてから `koyu 0.4` へ上げる。ADR-0020)。`0.4` 以前は縦動線の宣言 (`stair:` `ramp:` `escalator:` `lift:`)・描かれた線 (`line`)・柱 (`column`)・地下 (`underground:`) を知らないので、それらが書かれているとき (**VER03** — `koyu 0.5` へ上げる。ADR-0021/0022/0023)。`0.5` 以前は合成の上書き (`over`)・削除 (`drop`)・`over` 直下の集合編集 (`+` `-` `=`) を知らないので、それらが書かれているとき (**VER04** — `koyu 1.0` へ上げる。ADR-0035/0038)。言語を変える変更は版を上げ、ADRに移行を書く。
|
|
30
|
+
|
|
31
|
+
### 通り参照とオフセット
|
|
32
|
+
|
|
33
|
+
座標の直書きは無い — 位置は常に通り芯の言葉で書く: `X2`、`X2+600`、`Y3-150`。範囲は `X1..X2+3200` のように両端を通り参照で書く。
|
|
34
|
+
|
|
35
|
+
## 3. space — 空間
|
|
36
|
+
|
|
37
|
+
```
|
|
38
|
+
space /L5/A/ldk ldk X1+3200..X2+3200 Y1..Y1+4000 + X2+3200..X3 Y1..Y1+2400 name:LDK floor:オーク
|
|
39
|
+
space /out/road-s exterior name:南側道路 road:12000
|
|
40
|
+
area X1..X2 Y1-4600..Y1-2600 name:土間 floor:タイル # 字下げ: 数えない分節
|
|
41
|
+
```
|
|
42
|
+
|
|
43
|
+
- **パスが同一性。** `/` 区切りの階層。パスの第一義は集計の階層で、先頭セグメントがレベル名ならそのレベルに属する。階を跨ぐくくり (メゾネット等) は `level:` 属性で明示する。
|
|
44
|
+
- **型は開かれた語彙** (第2位置引数、必須)。構造として解釈されるのは `exterior` (領域なし可・外部) と `void` (吹抜け — 床面積不算入・通行不可) の二語だけ。**採光の対象は型から推定しない** — `light` が見るのは `daylight:1` を書いた空間である (既定は対象外。ADR-0020)。
|
|
45
|
+
- **領域は矩形の合併。** `X?..X? Y?..Y?` を `+` で複数書ける (L字など)。領域を持たない空間 (exterior等) も可。同一空間内・空間同士の領域の重なりはエラー。
|
|
46
|
+
- **`area` (字下げ)** は室内の数えない分節: 領域+上書き属性のみ。面積・室数・グラフに影響しない (隔離則)。親の領域からのはみ出しは警告。
|
|
47
|
+
- **スパン展開**: パスの**先頭セグメント**が `L3..L10` の形なら、宣言済みレベルのz順の並びに展開される (各行のスパンは一つに揃える)。
|
|
48
|
+
|
|
49
|
+
### 帯 (band) — 寸法と並びで空間を割る
|
|
50
|
+
|
|
51
|
+
```
|
|
52
|
+
band X X1+3200..X2+3200 Y1+4000..Y2 # 帯: どの範囲を、どちら向きに割るか
|
|
53
|
+
space /L3..L10/A/wet wet w:4800 name:水回り # 字下げ: 帯の要素 (領域の代わりに寸法)
|
|
54
|
+
space /L3..L10/A/hall hall w:1600 name:玄関
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
**帯は位置ではなく寸法と並びを書く記法である** (ADR-0019)。垂直の矩計 (`level` の積み上げ) を水平へ拡張したもので、書かれるのは各室の寸法と並びであり、位置はそこから導出される。既存の領域記法と併存し、どちらで書くかは強制しない。
|
|
58
|
+
|
|
59
|
+
- **`band <軸> <X?..X?> <Y?..Y?>`。** 第1位置引数は割る向き (`X` = 西→東 / `Y` = 南→北) で、`grid X 0 6400 …` と同じ綴り方である。残り2つは帯の範囲で、`space` の領域と同じ字句・順不同 (`+` の合併は書けない)。**この行に `key:value` は書けない** — 帯はモデルに残らないので属性の運び先が無い。**範囲は昇順で書く** — 要素の並びが意味を持つため、`space` と違って逆順表記を正規化しない。
|
|
60
|
+
- **要素は字下げした `space` 行**であり、領域の代わりに幅 `w:` を持つ。それ以外は通常の `space` 行と同じ (パス・型・属性・レベルスパン)。`w` は帯の向きの寸法mmで、`door w:800` が線分方向の幅であるのと同じく軸相対である。`level:` と `area` は書けない。要素は帯の中で同じレベルに展開されなければならない。
|
|
61
|
+
- **`w:rest` は残りを吸収する要素の印**で、帯に高々一つ、位置は問わない。**既定は `rest` を使わない「閉じた帯」である** — 全要素に寸法を書き、合計が帯の幅と一致することを parse が照合する。図面の「部分寸法の合計 = 総寸法」と同じ検算であり、寸法の打ち間違いをその場で捕まえる唯一の防御である。`rest` は残りが設計判断でないときの例外語彙とする。
|
|
62
|
+
- **過剰決定 (合計が帯を超える) と不足 (合計が足りず `w:rest` も無い) はどちらもエラー**である。ソルバーは無い — 足し算と一回の引き算だけで、順序は宣言順、向きは常に低座標→高座標である。帯の破れは**すべて parse のエラー**であり (帯が壊れていれば矩形が一つも作れない = 形の問題)、`check --json` では SYN01 として現れる。新しい診断コードは切らない。
|
|
63
|
+
- **帯は parse 時に通常の空間へ展開され、モデルにも正準JSONにも残らない** (import・スパン・stack と同じ流儀)。帯で書いた版と位置で書いた版は同じ正準JSONを与える。
|
|
64
|
+
- **導出される切り位置の綴り (床規則)。** 帯の両端と直交方向の両端は**書かれた綴りがそのまま**使われ、内側の切り位置だけが綴られる。規則は「その座標**以下**で最も大きい通り芯からのオフセット」で、オフセットが0なら通り名だけ、先頭の通り芯より手前なら負のオフセットになる (`8000` → `X2+1600`、`12800` → `X3`)。**上の通り芯から引く綴り (`Y2-1800`) は導出では生じない** — その流儀で書かれた領域を帯に書き直すと、幾何は同一でも綴りが変わり semantic diff に現れる。
|
|
65
|
+
- **`space` 行に `w:` は書けない** — 幅で書く空間は必ず帯の直下に字下げする。字下げを落とした要素が「領域を持たない空間」として黙って通るのを防ぐ。
|
|
66
|
+
|
|
67
|
+
## 4. boundary — 境界 (壁は関係であって物ではない)
|
|
68
|
+
|
|
69
|
+
```
|
|
70
|
+
boundary /L5/A/hall /L5/corridor t:180 spec:RC
|
|
71
|
+
door D1 at:X4 name:玄関 # 字下げ: 開口
|
|
72
|
+
seg w:1800 at:X5 edge:S spec:受付ガラス # 字下げ: 数えない分節
|
|
73
|
+
boundary /L1/hall /L2/void type:void # 垂直の例外
|
|
74
|
+
```
|
|
75
|
+
|
|
76
|
+
- 二つの空間パスを結ぶ第一級の関係。壁芯線分は書かない — 両空間の割付から導出される (semantics.md §2)。接していない空間の境界はエラー。**同じ空間対への境界の重複 (edge限定まで同一) もエラー** — wall/openの食い違いを黙って通さない (ADR-0013)。edge限定の有無が混在する対は警告 (線分が重なる)。
|
|
77
|
+
- **接する空間の既定は壁 (ADR-0014)。** 同一レベルで平面が接する領域つき空間の組には、宣言が無ければ `wall` の既定境界が導出される — 垂直の「既定は床」と対称で、宣言は例外 (open・手すり) と属性・開口のためにある。領域を持たない空間 (exterior等) との境界は従来どおり宣言する (どの外部かの名指しが情報)。吹抜け (type:void) の縁も既定は壁 — 手すり (air:1) やopenは宣言する。既定境界は正準JSONには出ない。
|
|
78
|
+
- **type (kind) はトポロジーだけ**: 水平は `wall` (既定 — 物がある。扉がなければ通れない) / `open` (何もない — 常に通行可)。垂直は `stair` (通行可) / `shaft` (連続するが通行不可) / `void` (床の不在)。床は書かない — 垂直の隣接は平面の重なりから導出され、既定は床。壁境界を異なるレベル間に書くとエラー。
|
|
79
|
+
- **物の名は `spec` 語彙** (手すり・RC・LGS・カーテンウォール…)。ツールは解釈しない。
|
|
80
|
+
- **`air:1`** = 物はあるが外気・光を遮らない (手すり・柵・フェンス)。半屋外の導出・採光係数・細線描画に効く。
|
|
81
|
+
- **`t`** = 壁厚mm (芯振り分け。未指定の描画既定は100)。**`edge`** = 線分をa側 (先に書いた空間) の矩形から見た辺 N/E/S/W に限定する。
|
|
82
|
+
- **`stack 名 L1..L11 type:stair|shaft|void`** は垂直積層の一括宣言: 連続レベル対 `/Lk/名 | /Lk+1/名` に垂直境界を張る。**縦の通行可能性は `stair` の一語が引き受ける** — 階段も斜路もエスカレーターもトポロジーは同じなので、型は増やさない (ADR-0021)。装置の違いは空間側の宣言 (`stair:` `ramp:` `escalator:` `lift:`) が形の生成規則として持つ。
|
|
83
|
+
- **`line <始点> <終点>`** (字下げ) は**描かれた線** — 境界の実現を、隣接からの導出ではなく設計の行為として与える (ADR-0022)。端点は通り語の対 (`X3,Y1` / `X3+600,Y2-900`) で、生の座標も角度も書けない。一つの境界に一本。線は二空間の割付の合併を両側へ分け直すので合計面積は保存され、片側が領域を持たない外部なら外皮を切る線になる。斜めの線分の上では開口の `at:` は 0..1 の比率のみ。
|
|
84
|
+
|
|
85
|
+
### 開口 (door / window)
|
|
86
|
+
|
|
87
|
+
- `door` は通行、`window` は採光 (通行しない)。**幅 `w` は必須** (アセット側でも可)。`h` は任意 (windowの採光計算は `h` を持つものだけ数える)。
|
|
88
|
+
- **アセット参照**: 先頭の非key:valueトークンはアセット名 (`door SD1 sill:800`)。アセットの属性が既定になり、インスタンスの属性が上書きする。kind不一致・未定義はエラー。
|
|
89
|
+
- **位置 `at`**: 比率 `0..1` (既定0.5 — 線分内に収まるようクランプ) または通り参照 `at:X2+450` (絶対位置 — クランプしない。はみ出し・軸違い〈水平線分はX系・垂直線分はY系〉はエラー)。同じ線分上の開口同士の重なりはエラー。
|
|
90
|
+
- **複数線分の辺選択 `edge`**、**開き勝手 `hinge`** (吊元: 水平線分はW/E、垂直線分はN/S。既定は始端側)・**`swing`** (開く側 a/b。既定はa=領域を持つ側)。`style` (hinged/sliding/auto) は平面の建具表現を変える。
|
|
91
|
+
- **`seg`** は境界上の数えない分節: 位置 (at/w/edge — 開口と同じ流儀) + 上書き属性。通行・接続に影響しない。
|
|
92
|
+
|
|
93
|
+
## 5. zone — 数える集約
|
|
94
|
+
|
|
95
|
+
```
|
|
96
|
+
zone /L3..L10/A name:Aタイプ use:exclusive
|
|
97
|
+
zone /site name:敷地 site:1 area:1097.80
|
|
98
|
+
```
|
|
99
|
+
|
|
100
|
+
幾何を持たず、パス接頭辞で配下の空間を束ねる。面積は配下の合計、`use` は配下に継承 (空間側の宣言が勝つ)。`site:1` は敷地の印で `site` の問いの対象になり、`area:` (測量値㎡) は導出面積と照合される。パスの重複はエラー、配下に空間が無ければ警告。
|
|
101
|
+
|
|
102
|
+
## 6. asset — 建具アセット
|
|
103
|
+
|
|
104
|
+
```
|
|
105
|
+
asset SD1 door w:800 h:2000 style:sliding name:片引き戸
|
|
106
|
+
```
|
|
107
|
+
|
|
108
|
+
参照される既定値の束 (RevitのFamily / USDのReference)。第4の要素ではない — 開口の属性の出所を一箇所にするだけ。名前の重複は (合成時も) エラー。
|
|
109
|
+
|
|
110
|
+
## 7. polygon — 敷地形状
|
|
111
|
+
|
|
112
|
+
```
|
|
113
|
+
polygon /site -2600,-7000 38000,-7000 38000,19600 2000,21000 -2600,15000
|
|
114
|
+
```
|
|
115
|
+
|
|
116
|
+
**この記法で唯一、格子に載らない自由頂点で「書かれる形」** (空間の領域もグリッド参照の矩形として書かれるが、任意の頂点列はpolygonだけ)。敷地の形は測量由来の所与であって設計の生成物ではないため、例外として認める。頂点は `x,y` のmm座標 (グリッドと同じ座標系) を3つ以上。site:1のゾーンパスに対応させる (対応が無ければ警告)。導出面積・建物のはみ出し検査・配置図の敷地境界線がここから出る (semantics.md §5)。隔離レイヤー (別ファイル+import) に置く運用を標準とする。重複はエラー。
|
|
117
|
+
|
|
118
|
+
## 8. import / over / drop — 合成
|
|
119
|
+
|
|
120
|
+
規範は [composition.md](composition.md) が持つ。ここは綴りだけを書く。
|
|
121
|
+
|
|
122
|
+
```
|
|
123
|
+
import ./assets.muro # 層を重ねる。**並びが強度の宣言** (後の層ほど強い)
|
|
124
|
+
|
|
125
|
+
over /L5/A/ldk h:2600 spec:改修後 # 空間の上書き (パス1つ。空間が無ければゾーン)
|
|
126
|
+
over /L5/A/hall /L5/corridor t:200 # 境界の上書き (パス2つ)
|
|
127
|
+
over level L3 h:2600 # レベルの上書き (h / slab / underground のみ)
|
|
128
|
+
over asset SD1 w:900 # アセットの上書き
|
|
129
|
+
- door D2 # 字下げ: 集合の削除 (名で指す)
|
|
130
|
+
= door D1 w:1000 # 集合の置換 (書いた属性だけを差し替える)
|
|
131
|
+
+ window w:600 h:1200 name:W1 # 集合の追加 (name: が要る)
|
|
132
|
+
|
|
133
|
+
drop /L5/A/store # 空間の削除 (その空間に繋がる境界も消える)
|
|
134
|
+
drop /L5/a /L5/b # 境界の削除
|
|
135
|
+
drop column C1 # 柱の宣言の削除
|
|
136
|
+
```
|
|
137
|
+
|
|
138
|
+
- **`import`** は書かれたファイルからの相対パス。base層 (entry) が基盤 (`koyu`/`name`/`unit`/`grid`/`level`) を一度だけ宣言する。同じレイヤーは一度だけ合成される (二重import・循環は冪等)。
|
|
139
|
+
- **`space` / `boundary` / `zone` / `asset` / `polygon` は定義**であり、重複はビルドエラーである (両者の出所つき)。**`over` は上書き**であり、対象が無ければエラーである。
|
|
140
|
+
- **`over` の直下に置けるのは `+` / `-` / `=` だけ**である。集合の要素は `name:` で指す — 名を持たない要素は編集の対象にできない。
|
|
141
|
+
- 合成の入口の一覧は [tools.md](tools.md) の公開API節 (`parse` / `parseFile` / `parseFiles` / `parseFileWith` / `parseWith`)。
|
|
142
|
+
- 正準JSONは合成後の単一モデルであり、`import` も `over` も `drop` も残らない。
|
|
143
|
+
- **`over` / `drop` / 集合編集は muro 1.0 の語である。**`0.5` 以前を宣言したファイルにこれらを書けば **VER04** で止まる (§2 版の規範)。
|
|
144
|
+
|
|
145
|
+
## 9. column — 柱 (位置を書かない要素)
|
|
146
|
+
|
|
147
|
+
`column <一辺mm> <レベル範囲|レベル名> [d:奥行] [x:通り,..] [y:通り,..] [自由属性]`
|
|
148
|
+
|
|
149
|
+
**位置はどこにも書かれない。**柱は「通り芯の交点のうち、そのレベルに床のある所」に立つ (ADR-0023) — 壁が「二つの空間が接する所」に現れるのと同型の規則である。床の有無は `exterior` でも `void` でもない領域つき空間の内側かどうかで決まる。ただし**空しか支えない床は柱を立てない** (ADR-0030): 半屋外 (外部に open か air:1 で接する — ADR-0007) で、かつ上にどのレベルの床も重なっていない空間 (ADR-0009 の導出) は、柱の敷地から除かれる。露天のテラス・屋上庭園に柱は立たず、上階が張り出したバルコニーの下には立つ。`x:` / `y:` は立てる通りの限定 (カンマ区切り、未指定は全通り)。同じ交点に二本は立たず、先の宣言が勝つ。階の範囲を分けて三行書けば、上へ行くほど細くなる柱が出る。柱は空間でも境界でもないので、面積にもグラフにも現れない。
|
|
150
|
+
|
|
151
|
+
## 10. 既定値の一覧
|
|
152
|
+
|
|
153
|
+
| 項目 | 既定 |
|
|
154
|
+
|---|---|
|
|
155
|
+
| boundary type | `wall` |
|
|
156
|
+
| boundary t | なし (導出の既定は 100mm — [derivation.md §5](derivation.md)) |
|
|
157
|
+
| 接する空間の境界 | `wall` — 書かない。例外だけ宣言 (open / air:1 / 属性・開口つき — ADR-0014) |
|
|
158
|
+
| opening at | 0.5 (比率 — クランプあり) |
|
|
159
|
+
| opening hinge / swing | 線分の始端側 / a側 (領域を持つ方) |
|
|
160
|
+
| space level | パス先頭セグメント (レベル名のとき) |
|
|
161
|
+
| space h | レベルの h |
|
|
162
|
+
| 垂直の隣接 | 床 (slab) — 書かない。例外だけ宣言 (stair/shaft/void) |
|
|
163
|
+
| 面積算定 | 壁芯 |
|
|
@@ -0,0 +1,184 @@
|
|
|
1
|
+
[English](en/notation-v0.md) · **日本語**
|
|
2
|
+
|
|
3
|
+
# koyu 記法 v0 — 成立の記録 (歴史文書)
|
|
4
|
+
|
|
5
|
+
**現在の仕様は [language.md](language.md) / [semantics.md](semantics.md) / [canonical-json.md](canonical-json.md) / [tools.md](tools.md) が正である。** 本書は記法が生まれた過程の記録 — v0の書き比べ (DSL/YAML/JSON) と各版の追補を、書かれた当時のまま保存する。決定の理由は docs/decisions/ (ADR)、思想は docs/writing-architecture.md。
|
|
6
|
+
|
|
7
|
+
設計基準はひとつに固定する。**LLMが一つのコンテキストで読み切り、正しく部分編集できるか。** この基準から、テキストネイティブであること、参照が人間の読める階層パスであること、小さなファイルであること、単位と座標系を先頭で一度だけ宣言することが導かれる。
|
|
8
|
+
|
|
9
|
+
## モデル
|
|
10
|
+
|
|
11
|
+
一次要素は空間である。`space` は室・ゾーン・外部の領域を表し、階層パスで名指される。壁はそれ自体が独立した物ではなく、二つの空間の境界という関係 (`boundary`) として持つ。境界には厚み・仕様・耐火などの性能が属性として乗る。開口 (`door` / `window`) は境界に開いた接続である。骨格はグリッド (`grid`) とレベル (`level`) が与える。型は巨大なクラス階層ではなく開かれた語彙であり、`room` `corridor` `exterior` などのコア語彙に自由な語を足してよい。
|
|
12
|
+
|
|
13
|
+
形はこのソースには無い。壁の線分は空間の割付から導出され、平面図は必要になった時に生成される。同じ構成から複数の形が出ることは欠陥ではない。
|
|
14
|
+
|
|
15
|
+
## 記法 (author形式: 独自DSL)
|
|
16
|
+
|
|
17
|
+
```
|
|
18
|
+
# 二室一扉 — 最初の一手
|
|
19
|
+
|
|
20
|
+
koyu 0.1
|
|
21
|
+
name 二室一扉
|
|
22
|
+
unit mm
|
|
23
|
+
|
|
24
|
+
grid X 0 3600 7200 # 通り芯 X1, X2, X3
|
|
25
|
+
grid Y 0 4500 # 通り芯 Y1, Y2
|
|
26
|
+
level L1 0 h:2400 # FL高さ 0、基準天井高 2400
|
|
27
|
+
|
|
28
|
+
space /L1/a room X1..X2 Y1..Y2 name:居室A
|
|
29
|
+
space /L1/b room X2..X3 Y1..Y2 name:居室B
|
|
30
|
+
space /out exterior name:外部
|
|
31
|
+
|
|
32
|
+
boundary /L1/a /L1/b t:120 spec:PW1
|
|
33
|
+
door w:780 h:2000
|
|
34
|
+
|
|
35
|
+
boundary /L1/a /out t:150 spec:EW1 fire:60
|
|
36
|
+
boundary /L1/b /out t:150 spec:EW1 fire:60
|
|
37
|
+
door w:900 h:2100 edge:S name:玄関
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
文法は次の通り。一行が一文であり、`キーワード 位置引数... key:value...` の形をとる。`#` 以降はコメント、値に空白を含めるときは `"..."` で囲む。字下げした行は直前の `boundary` に属する開口 (`door` / `window`) である。
|
|
41
|
+
|
|
42
|
+
`grid X 0 3600 7200` は昇順の座標 (mm) を宣言し、通り名 X1, X2, ... が自動で振られる。`level 名 z [h:天井高]` がレベルを宣言する。`space パス 型 [X?..X? Y?..Y?] [属性...]` は空間を宣言し、パスの先頭セグメントがレベル名ならそのレベルに属する。領域は v0 では通り芯で囲む矩形ひとつに限る。`exterior` のように領域を持たない空間も書ける。
|
|
43
|
+
|
|
44
|
+
`boundary パスA パスB [t:厚 type:wall|open 属性...]` は境界を宣言する。境界の壁芯線分は書かない — 二空間の割付から導出される。接していない空間の境界はエラーになる。`type:open` は垂れ壁のない開放境界で、扉なしで通行できる。外部のような領域なし空間との境界は、部屋の外周から他室と接する区間を除いた残りとなり、複数辺に分かれるため、開口を置くときは `edge:N/E/S/W` で辺を指定する。開口の位置は `at:0..1` (既定 0.5) で線分上に置く。
|
|
45
|
+
|
|
46
|
+
既定値: 境界は `type:wall`、開口位置は `at:0.5`、描画時の壁厚は t 未指定なら 100mm。面積は壁芯で算定する。
|
|
47
|
+
|
|
48
|
+
## 書き比べ — 同じ二室一扉を三つの形式で
|
|
49
|
+
|
|
50
|
+
v0 を決めるために、同じ場面を三つの形式で書いた。上の DSL が一つ目である。
|
|
51
|
+
|
|
52
|
+
二つ目、YAML:
|
|
53
|
+
|
|
54
|
+
```yaml
|
|
55
|
+
koyu: "0.1"
|
|
56
|
+
name: 二室一扉
|
|
57
|
+
unit: mm
|
|
58
|
+
grid:
|
|
59
|
+
X: [0, 3600, 7200]
|
|
60
|
+
Y: [0, 4500]
|
|
61
|
+
levels:
|
|
62
|
+
L1: {z: 0, h: 2400}
|
|
63
|
+
spaces:
|
|
64
|
+
/L1/a: {type: room, at: [X1, Y1, X2, Y2], name: 居室A}
|
|
65
|
+
/L1/b: {type: room, at: [X2, Y1, X3, Y2], name: 居室B}
|
|
66
|
+
/out: {type: exterior, name: 外部}
|
|
67
|
+
boundaries:
|
|
68
|
+
- between: [/L1/a, /L1/b]
|
|
69
|
+
t: 120
|
|
70
|
+
spec: PW1
|
|
71
|
+
openings:
|
|
72
|
+
- {kind: door, w: 780, h: 2000}
|
|
73
|
+
- between: [/L1/a, /out]
|
|
74
|
+
t: 150
|
|
75
|
+
spec: EW1
|
|
76
|
+
fire: 60
|
|
77
|
+
- between: [/L1/b, /out]
|
|
78
|
+
t: 150
|
|
79
|
+
spec: EW1
|
|
80
|
+
fire: 60
|
|
81
|
+
openings:
|
|
82
|
+
- {kind: door, w: 900, h: 2100, edge: S, name: 玄関}
|
|
83
|
+
```
|
|
84
|
+
|
|
85
|
+
三つ目、JSON。これは `koyu json` が吐く正準形そのものであり、全文は examples/two-rooms.canonical.json にある (111行)。抜粋:
|
|
86
|
+
|
|
87
|
+
```json
|
|
88
|
+
{
|
|
89
|
+
"koyu": "0.1",
|
|
90
|
+
"name": "二室一扉",
|
|
91
|
+
"unit": "mm",
|
|
92
|
+
"grid": { "X": [0, 3600, 7200], "Y": [0, 4500] },
|
|
93
|
+
"spaces": {
|
|
94
|
+
"/L1/a": { "type": "room", "at": ["X1", "Y1", "X2", "Y2"], "attrs": { "name": "居室A" } }
|
|
95
|
+
},
|
|
96
|
+
"boundaries": [
|
|
97
|
+
{ "between": ["/L1/a", "/L1/b"], "kind": "wall", "t": 120,
|
|
98
|
+
"openings": [{ "kind": "door", "w": 780, "h": 2000, "at": 0.5 }] }
|
|
99
|
+
]
|
|
100
|
+
}
|
|
101
|
+
```
|
|
102
|
+
|
|
103
|
+
| 観点 | DSL | YAML | JSON |
|
|
104
|
+
|---|---|---|---|
|
|
105
|
+
| 同じ場面の行数 | 14 (コメント除く) | 約30 | 111 |
|
|
106
|
+
| 人間の読み書き | 図面の密度に最も近い | 十分読める | 構造は明快だが冗長 |
|
|
107
|
+
| LLMの部分編集 | 一行一文で差し替えが局所的 | 良好 | 良好だが括弧の整合が絡む |
|
|
108
|
+
| diffの言葉 | 「この室が広がった」が一行で出る | 良好 | ノイズ多め |
|
|
109
|
+
| パーサ | 自作 (約300行で済んだ) | 既存 | 既存 |
|
|
110
|
+
| レイヤー合成 | 直接は不向き | 中間 | 最も素直 (IFCX/USDと同じ土俵) |
|
|
111
|
+
|
|
112
|
+
**決定: author形式はDSL、機械形式は正準JSON。** 人が(そしてLLMが)読み書きする原本はDSLで持ち、合成・diff・外部接続の土台には `koyu json` の正準形を使う。YAMLは両者の中間で決め手を欠くため見送る。DSLの代償はエディタ支援が無いことと文法の保守だが、文法を「一行一文 + key:value + 字下げ」から増やさないことで抑える。
|
|
113
|
+
|
|
114
|
+
## 正準JSONの形 (機械形式)
|
|
115
|
+
|
|
116
|
+
`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?}`)。
|
|
117
|
+
|
|
118
|
+
安定性の規則: すべてのオブジェクトキーはソートされ、`spaces` はパス順、`boundaries` は `between` の辞書順に並ぶ。同じ構成からは常にバイト同一のJSONが出るため、diff・ハッシュ・レイヤー合成の土台に使える。素振り段階の現在は src/model.ts の `toCanonical()` の実装を正とし、本節はその写しである (乖離したらどちらを直すかをその時に決め、ADRに残す)。
|
|
119
|
+
|
|
120
|
+
## v0.1 追補 — オフセットと高さ方向 (2026-07-23)
|
|
121
|
+
|
|
122
|
+
複数レベル・廊下と複数室・芯外の壁を書くための追補。理由は ADR-0002、実例は examples/office.muro (2フロアのオフィス、約100行)。
|
|
123
|
+
|
|
124
|
+
**通り芯オフセット。** 領域の参照は `X2+600` `Y3-150` のように芯からの寸法を足し引きできる。座標の直書きは無い — 芯の言語を保つ。
|
|
125
|
+
|
|
126
|
+
**レベルと高さ。** `level L2 4000 h:2700 slab:1300` — z (FL)、h (基準天井高)、slab (その階の床組み厚: 下階天井面から自階FLまで)。空間は `h:` 属性で天井高を個別に持てる。checkが不変量「天井高 + 上階slab ≤ 階高」を検査し、超えると食い込みエラー。`levels` コマンドがテキストの矩計として積み上がりを表示する。最上部に空間を持たないレベル (屋根面) を宣言すると最上階にも上限が効く。
|
|
127
|
+
|
|
128
|
+
**垂直の境界。** 床は書かない — 垂直の隣接は平面の重なりから導出され、既定は床である。例外だけを書く: `boundary /L1/stair /L2/stair type:stair` (扉0枚で通行可)、`type:shaft` (EV等 — 連続するが通行不可)。壁境界 (`wall`/`open`) を異なるレベル間に書くとエラー。吹抜けは `type:void` として設計予定 (未実装)。
|
|
129
|
+
|
|
130
|
+
**基本計画の解像度。** このデータが表現するのは計画初期の解像度であり、垂れ壁・建具詳細・仕上げは持たない。`type:open` の境界は「垂れ壁があるか」を言わない — その決定は後段に属する。平面図では開放的な分節を破線で描く。
|
|
131
|
+
|
|
132
|
+
**stats の use 集計。** 空間に `use:rentable` / `use:common` などの属性を与えると、statsが面積比 (レンタブル比) を返す。
|
|
133
|
+
|
|
134
|
+
**基準階の反復 — 一度だけ書く (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境界)。
|
|
135
|
+
|
|
136
|
+
**数えない分節 (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は壁の色調変化として描かれる。
|
|
137
|
+
|
|
138
|
+
## v0.3 追補 — 間取り・L字・吹抜け・採光 (2026-07-23)
|
|
139
|
+
|
|
140
|
+
**L字の室 (ADR-0005)。** 領域は `+` で矩形を複数書ける合併になった: `space .../ldk ldk X1+2600..X2 Y1..Y2-1800 + X1..X1+2600 Y1..Y1+1400`。面積は合計、壁は合併の外周から導出、共線の外周は一本にマージされる。同一ペアがL字で2辺接するときの扉は `edge:` で辺を選ぶ。
|
|
141
|
+
|
|
142
|
+
**ゾーン = 数える集約 (ADR-0005)。** `zone /L2..L9/A name:Aタイプ use:exclusive` — 幾何を持たず、パス接頭辞で室を束ねる。面積は配下の合計、`use` は配下へ継承。住戸を間取りに割っても「専有面積」の言葉は壊れない。粒度は混在してよい (Aタイプだけ間取り、B〜Eは住戸一室)。
|
|
143
|
+
|
|
144
|
+
**吹抜け (ADR-0006)。** 上階に `type:void` の空間を置き、`boundary /L1/hall /L2/void type:void` で結ぶ。床は既定・接続 (stair) は例外・不在 (void) も例外。void境界は高さ不変量の宣言的免除で、下階は `h:6700` と階をまたげる (境界を消せばエラーが戻る)。voidは床面積不算入・通行不可、平面図では破線の対角線。**例外階は新記法なし** — スパンを割って書く。
|
|
145
|
+
|
|
146
|
+
**採光 `light` (ADR-0006)。** 住居系の居室で窓面積/床面積 ≥ 1/7 の粗い判定 (補正係数なし)。窓は `h:` があるものだけ数える。法規検証の芽の第一号。
|
|
147
|
+
|
|
148
|
+
## v0.4 追補 — 半屋外・語彙の台帳・開き勝手・メゾネット (2026-07-23)
|
|
149
|
+
|
|
150
|
+
**air:1 と半屋外 (ADR-0007)。** kindに物の名は入れない (IfcRailingが要素であることに倣う)。手すりは `wall + spec:手すり + air:1` (遮蔽しない物)。半屋外は宣言ではなく導出 — 外部に対しopenまたはair:1の境界を持つ空間。statsで別掲、専有面積から除外、light 0.7掛け、平面図は細実線。
|
|
151
|
+
|
|
152
|
+
**語彙の台帳 (ADR-0008)。** 属性の付け方の規則は [vocabulary.md](vocabulary.md) が契約。kindはトポロジーだけ・物の名はspec・解釈される属性は台帳に載せる。
|
|
153
|
+
|
|
154
|
+
**開き勝手。** `door ... hinge:E swing:b` — 吊元 (線分の端) と開く側 (境界のa/b)。既定は始端・a側。
|
|
155
|
+
|
|
156
|
+
**メゾネット (ADR-0008)。** パスの第一義は集計の階層。階を跨ぐくくりは `level:` 属性で階を明示する: `space /home/bed1 ... level:L2`。ゾーンが階を跨いで住戸を束ねる (examples/house.muro)。
|
|
157
|
+
|
|
158
|
+
**部分吹抜け (ADR-0006追記)。** 下階の天井高は階高内のまま、吹抜け部分の高さは導出。全面吹抜け (被覆≥99%) のときだけ階をまたぐ天井高を宣言できる。下階平面に「上部吹抜け」の破線表示。
|
|
159
|
+
|
|
160
|
+
## v0.5 追補 — 敷地と外部 (2026-07-23)
|
|
161
|
+
|
|
162
|
+
**外もまた空間である (ADR-0009)。** `/out` は方角・性格ごとの複数のexterior空間に割れ (`space /out/road exterior road:6000` — 道路は幅員の解釈属性)、地上の外部空間 (庭・通路) はL1上の実在の空間として建物の周りをタイルする。敷地は `zone /site site:1 area:126.24` — 宣言面積 (測量値) と導出面積を `site` コマンドが照合し、接道・建蔽率・容積率まで導出する。塀は境界の語彙 (`spec:ブロック塀 air:1 h:1200`)、門扉はその境界のdoor。
|
|
163
|
+
|
|
164
|
+
## v0.6 追補 — 明示位置・建具アセット・合成 (2026-07-23)
|
|
165
|
+
|
|
166
|
+
**明示位置 (ADR-0010)。** `door D1 at:Y2+1820` — 比率 (0..1、クランプ) に加えて通り芯参照の絶対位置。こちらはクランプしない — はみ出しは許容範囲つきのエラー、軸違い (垂直線分にX系) もエラー、同じ線分上の開口同士の重なりもエラー。位置が言葉になれば、位置の間違いも言葉で指摘される。
|
|
167
|
+
|
|
168
|
+
**建具アセット (ADR-0010)。** `asset SD1 door w:800 h:2000 style:sliding` — RevitのFamily、USDのReferenceにあたる既定値の束。開口は `door SD1 sill:800` と先頭トークンで参照し (Instance)、インスタンスの属性が上書きする。`style` (hinged/sliding/auto) は解釈される語彙で、平面の建具表現が変わる。第4の要素ではない — 三つ組は増えない。
|
|
169
|
+
|
|
170
|
+
**import合成 (ADR-0010)。** `import ./L1.muro` — base層が基盤 (koyu/name/unit/grid/level) を一度だけ宣言し、アセット・敷地・各フロアの層を加算で重ねる。衝突 (空間パス・アセット名の重複、grid/nameの再宣言) は出所 (ファイル:行) つきのビルドエラー。`koyu check main.muro` が一棟のビルドの門番。正準JSONは合成後の単一モデルで、importは残らない。examples/house/ (5ファイル) が実証 — 単一ファイル版と同じ答えを返す。
|
|
171
|
+
|
|
172
|
+
## v0.7 追補 — 敷地形状とショーケース (2026-07-23)
|
|
173
|
+
|
|
174
|
+
**敷地形状 (ADR-0011)。** `polygon /site -2600,-7000 38000,-7000 ...` — 敷地はまず矩形にならない。敷地の形は設計の生成物ではなく測量由来の所与なので、唯一「書かれる形」として認め、隔離レイヤー (site-geometry.muro) に置いてimportする。導出面積はシューレース、宣言 (測量値) と照合。建物のはみ出しはエラー。タイル (ADR-0009) はグラフ・接道を担う近似に格下げ。配置図には一点二点鎖線の敷地境界線。
|
|
175
|
+
|
|
176
|
+
**ショーケース (examples/tower/)。** 全機能を一棟に: 低層商業+高層住宅の11階建て複合ビル、延床4,785.92㎡。9ファイル合成 (base+敷地形状+外構+建具+L1+L2+基準階+L3差分+PH)、非矩形敷地 (五角形1,097.80㎡)、角地2道路 (接道40.6m+20.2m)、2層吹抜け、噛み合うL字住戸 (A/B)、バルコニー、低層部屋根のテラス (例外階の差分レイヤー)、スパン展開とstack、建具アセット (自動ドア/防火戸/引き戸)、明示位置、Aタイプの間取り、粒度の混在。178空間・543境界が警告ゼロ、居室66室の採光、避難「9階LDKから道路まで扉4枚」。
|
|
177
|
+
|
|
178
|
+
## この数十行で決まったこと
|
|
179
|
+
|
|
180
|
+
原稿の予告どおり、二室一扉を書くだけで四つの設計判断が言葉になった。空間の同一性は人間可読の階層パスに与える。境界はどちらの空間にも属させず、二つのパスを結ぶ第一級の関係とする。接続は境界上の開口とし、垂れ壁のない分節は `type:open` で表す。パスは `/レベル/空間` で切り、レベルに属さない外部はサイト直下に置く。それぞれの理由と代替案は ADR-0001 に記録した。
|
|
181
|
+
|
|
182
|
+
## 開いている問い
|
|
183
|
+
|
|
184
|
+
吹抜けと階をまたぐ空間、半屋外と外部空間の分節 (`/out` が一枚岩で良いはずがない)、室とゾーンの二層粒度 — これらは一フロアを書くとき (M1) に正面からぶつかる。記法側では、矩形ひとつに限った領域 (L字型の室が書けない)、開き勝手の記述 (v0は「先に書いた空間側へ開く」という描画規約に逃げている)、建具語彙の粒度、壁厚の振り分け (v0は芯振り分け固定)、面積規約 (v0は壁芯固定) が残っている。IFCのGUIDとの対応は、取り込み (M5) の際に `id:` 属性のレイヤーとして後置する。
|
package/spec/scope.md
ADDED
|
@@ -0,0 +1,229 @@
|
|
|
1
|
+
[English](en/scope.md) · **日本語**
|
|
2
|
+
|
|
3
|
+
# 範囲の規範 — 三つの領域と、凍る面
|
|
4
|
+
|
|
5
|
+
koyu v0.16.0 / muro 1.0 現在。**この文書が「何を約束し、何を約束しないか」の規範である。**
|
|
6
|
+
文法は [language.md](language.md)、意味論は [semantics.md](semantics.md)、判定の台帳は [validation.md](validation.md)。
|
|
7
|
+
|
|
8
|
+
ここに書かれた線は、他のどの文書よりも強い。spec の別の頁とここが食い違ったら、**ここが正である**。
|
|
9
|
+
|
|
10
|
+
---
|
|
11
|
+
|
|
12
|
+
## 1. 三つの領域
|
|
13
|
+
|
|
14
|
+
koyu は三つの領域からなる。**求められる品質が違うので、分けてある。**
|
|
15
|
+
|
|
16
|
+
| 領域 | 場所 | 大きさ | 品質 | 版 |
|
|
17
|
+
|---|---|---|---|---|
|
|
18
|
+
| **core** | `src/core/` | 小さい | **きれいでなければならない** | **凍る** |
|
|
19
|
+
| **検証** | `src/validate/` | 大きくなる | 汚くてよい | 凍らない |
|
|
20
|
+
| **表現・ビルド** | `src/draw/` と [ugatsu](https://github.com/kensnzk/ugatsu) | 大きくなる | 汚くてよい | 凍らない |
|
|
21
|
+
|
|
22
|
+
**依存は一方向である。**検証も表現も core に依存し、core はどちらにも依存しない。core は自分だけで完結して動く。この一方向は文ではなく `test/domains.test.ts` が機械的に守る。
|
|
23
|
+
|
|
24
|
+
分けないと二つのことが同時に起きる — **汚さが core に染み出して凍り、core の慎重さが検証と表現の成長を止める。**分けることそのものが、検証と表現が汚くてよい条件である。凍らない領域の汚れはいつでも書き直せるので安い。凍る領域の汚れは永久に残る。
|
|
25
|
+
|
|
26
|
+
> **koyu は座標を作らない。ugatsu は意味を作らない。**
|
|
27
|
+
|
|
28
|
+
---
|
|
29
|
+
|
|
30
|
+
## 2. core が持つもの
|
|
31
|
+
|
|
32
|
+
原本の言語と、その意味論と、機械への口。
|
|
33
|
+
|
|
34
|
+
- **muro の文法と意味論** — 何が書けて、書いたものが何を意味するか
|
|
35
|
+
- **合成** — 層の強度順序、単一値の解決、集合の編集、出所 ([composition.md](composition.md))
|
|
36
|
+
- **同一性** — uid とパス、関係の同一性 ([§5](#5-同一性))
|
|
37
|
+
- **導出** — 書かれた構成から**一意な形**を作る規則と、その参照実装 ([§6](#6-導出の契約))
|
|
38
|
+
- **構造整合の診断** — `check` が返す `Diagnostic[]`
|
|
39
|
+
- **問い** — 面積・グラフ・経路・開口面積。**ただし合否を言わない** ([§4](#4-問いは合否を言わない))
|
|
40
|
+
- **機械形式** — 正準JSON ([canonical-json.md](canonical-json.md))
|
|
41
|
+
|
|
42
|
+
---
|
|
43
|
+
|
|
44
|
+
## 3. 保証の範囲 — 「検査が通った」の意味
|
|
45
|
+
|
|
46
|
+
**`koyu check` が緑であることの意味は、次のとおりに定義される。**
|
|
47
|
+
|
|
48
|
+
> **構造層と解釈層について、宣言された不変量が成り立つ。運搬層については何も言わない。建築としての妥当性については何も言わない。**
|
|
49
|
+
|
|
50
|
+
これは判定ではなく**読解の一部**であって、壊れた JSON を JSON パーサが弾くのと同じ層にある。
|
|
51
|
+
|
|
52
|
+
### 3.1 保証するもの
|
|
53
|
+
|
|
54
|
+
| 保証 | 診断 |
|
|
55
|
+
|---|---|
|
|
56
|
+
| パスと同一性の一意性 | UID01-04 / ZON02 / 合成時のパス重複エラー |
|
|
57
|
+
| 参照先の存在 | REF01 / アセット未定義 / polygon の対応ゾーン (SIT04) |
|
|
58
|
+
| レベルの定義 | LVL01 / VRT02 |
|
|
59
|
+
| 区画の重なり (平面) | GEO01 / GEO02 |
|
|
60
|
+
| 区画の重なり (断面) | HGT01 / HGT02 |
|
|
61
|
+
| 合成の解決が定まること | 合成エラー (`SourceError` — [composition.md](composition.md)) |
|
|
62
|
+
| **形を作るのに必要な情報の充足** | SUF01-04 |
|
|
63
|
+
| 関係の健全性 | BND01-06 / VRT01-06 |
|
|
64
|
+
| 導出の一意性 (開口・seg・線・柱・縦動線の形) | OPN01-08 / SEG01-08 / LIN01-03 / COL01-02 / RUN01-05 |
|
|
65
|
+
| 解釈される属性の値域 | ATT01-03 / DAY01 |
|
|
66
|
+
| 与件の健全性 | SIT01 / SIT02 |
|
|
67
|
+
|
|
68
|
+
**断面の重なり (HGT01/HGT02) が core にあるのは、それが平面の重なり (GEO01/GEO02) の断面版だからである。**下階の天井と上階の床が同じ z を占める状態は、二つの空間の領域が重なる状態と同じ種類の矛盾であり、そこからは一意な形が作れない。「階高・軒高・斜線」のような建築的な高さの判断は保証しない — それは検証の面である。
|
|
69
|
+
|
|
70
|
+
### 3.2 保証しないもの
|
|
71
|
+
|
|
72
|
+
**採光・面積率・容積率・外皮の連続・階段の登りやすさ・扉の設置可能性・避難・接道 — その他あらゆる建築的な妥当性。**そして**運搬層の属性の意味**。
|
|
73
|
+
|
|
74
|
+
これらは存在しないのではなく、**別の面にある**。[validation.md](validation.md) と `koyu validate` が持つ。
|
|
75
|
+
|
|
76
|
+
### 3.3 緑を根拠に「動く」と主張しない
|
|
77
|
+
|
|
78
|
+
`check` が緑でも建物が使えるとは限らない。接する空間の既定は壁なので ([ADR-0014](../docs/decisions/0014-default-boundaries.md))、扉を一枚も宣言しない二階建ては**緑のまま完全に密封される**。外皮も自動では生えない。動線は `doors`、判定は `validate` が別に答える。
|
|
79
|
+
|
|
80
|
+
---
|
|
81
|
+
|
|
82
|
+
## 4. 問いは合否を言わない
|
|
83
|
+
|
|
84
|
+
集計とグラフの問いは core が持つ。**ただし合否を言わない。**
|
|
85
|
+
|
|
86
|
+
| 問い | core が返すもの | 検証が言うこと |
|
|
87
|
+
|---|---|---|
|
|
88
|
+
| 採光 | 床面積と有効窓面積 (`daylightInputs`) | 1/7 を満たすか (`daylight.ratio`) |
|
|
89
|
+
| 敷地 | 敷地面積・接道長・建築面積・延べ面積・その商 (`siteReport`) | 2m の接道 (`site.frontage`)・はみ出し (`site.escape`) |
|
|
90
|
+
| 縦動線 | 段数・蹴上・踏面・勾配 (`verticalRuns`) | 窮屈さ (`stair.proportion`)・勾配 (`run.slope`) |
|
|
91
|
+
| 外皮 | 何にも面していない外周の線分 (`envelopeGaps`) | それが穴か (`envelope.gap`) |
|
|
92
|
+
| 動線 | 最少扉数の経路と通行可能性 (`doorsBetween` / `passable`) | 外部へ出られるか (`access.unreachable` ほか `access.*`) |
|
|
93
|
+
| 柱と開口 | 通り芯から立つ柱と線分上の開口 (`columnsFor` / `placeOpening`) | 重なっているか (`column.blocksdoor`) |
|
|
94
|
+
|
|
95
|
+
**閾値は建築の側にある。**1/7 も 2m も 240mm も、原本の構成が満たすべき不変量ではない。数を返すところまでが core で、数に線を引くのが検証である。
|
|
96
|
+
|
|
97
|
+
---
|
|
98
|
+
|
|
99
|
+
## 5. 同一性
|
|
100
|
+
|
|
101
|
+
**uid を持つのは空間と集約 (space / zone) だけである。そして必須ではない。**
|
|
102
|
+
|
|
103
|
+
- **uid が書かれた空間**は、その uid が正典である。パスが変わっても同じものである
|
|
104
|
+
- **書かれていない空間**は、パスで対応づく。改名すれば対応は切れる
|
|
105
|
+
- **関係 (boundary) の同一性は、両端の空間から導かれる。**関係に uid は書けない — 関係は必ず二つの空間の間にあるので、両端が定まれば関係も定まる。関係ごとに uid を書けば関係の数が空間の数を上回り、「一棟が機械の視野に入る」という目的を自分で削ることになる
|
|
106
|
+
- **開口と内包物 (柱) の同一性は、それを含む対象と、その中で一意な名から導かれる**
|
|
107
|
+
|
|
108
|
+
必須にしないのは、**保証の強さを書き手が選べるようにするため**である。時点をまたいで指す必要がある空間にだけ付ければよい。
|
|
109
|
+
|
|
110
|
+
> **同一性には責任を持ち、内容には持たない。**
|
|
111
|
+
|
|
112
|
+
### 5.1 uid を書ける対象は閉じている
|
|
113
|
+
|
|
114
|
+
`uid` を書けるのは `space` と `zone` だけであり、**この一覧は閉じている**。台帳 ([vocabulary.md](vocabulary.md)) に `uid` が載っているのはこの二つの要素だけで、他の要素に書けば ATT03 (台帳に無いキー)、`level` に書けば構文エラーになる。**黙って無視される経路は無い。**
|
|
115
|
+
|
|
116
|
+
`acme.uid:` のように名前空間を付ければ書けるが、それは運搬層である ([§7](#7-属性の三層)) — core は見ない。**「同一性を持たせた」ことにはならない。**
|
|
117
|
+
|
|
118
|
+
### 5.2 生成の規則と、衝突しないことの範囲
|
|
119
|
+
|
|
120
|
+
**uid はパスからもモデルの中身からも導出しない。**導出すれば改名でトークンが変わり、uid の意味 (改名を跨ぐ) が消える。機械が作るときは**乱数**である — 接頭辞 `u-` + Crockford base32 の16字、合わせて 80 ビット ([ADR-0039](../docs/decisions/0039-identity-generation.md))。
|
|
121
|
+
|
|
122
|
+
```
|
|
123
|
+
u-7f3k9m2qx4b8dhtv
|
|
124
|
+
```
|
|
125
|
+
|
|
126
|
+
**保証は二段である。**
|
|
127
|
+
|
|
128
|
+
| 相手 | 保証 |
|
|
129
|
+
|---|---|
|
|
130
|
+
| 合成済みのモデル | **衝突しない。**生成器が検査し、`check` の UID03 が証明する |
|
|
131
|
+
| まだ合成されていない層・他のリポジトリ | **確率でしか保証しない。**80ビットなので 100 万個でも衝突確率は 10⁻¹² を下回る。確実さが要るなら合成して `check` を通す |
|
|
132
|
+
|
|
133
|
+
**付与は明示の行為である。**書き手が書くか、`newUids` / MCP の `new_uids` を呼ぶまで、どのツールも uid を書かない。`write_layer` も書かない。
|
|
134
|
+
|
|
135
|
+
### 5.3 名は、一つのものを指していなければならない
|
|
136
|
+
|
|
137
|
+
「含む対象 + その中で一意な名」が同一性である以上、**一つの名が二つを指す状態は同一性の破れである** — 合成の集合編集 (`= window W1` / `- column C1`) がどちらを指すのか決まらない。これは検査され (UID04)、合成の側でも拒まれる。
|
|
138
|
+
|
|
139
|
+
**アセットから継いだ名は、同一性の主張ではない。**`asset W1 window … name:掃き出し窓` の `name` は型の名であり、同じ建具を一枚の壁に二枚並べるのは普通の設計である。主張は、その開口の行に書かれた名だけである。
|
|
140
|
+
|
|
141
|
+
---
|
|
142
|
+
|
|
143
|
+
## 6. 導出の契約
|
|
144
|
+
|
|
145
|
+
形を作らないことと、形を作れないことは違う。**この記述からは、一意な形が作れなければならない。**
|
|
146
|
+
|
|
147
|
+
担保は第一に構造による — 与件が座標を与え、関係が共有面という座を与え、実体はその座に乗る。**実体は座を持って生まれる。**加えて四つを定める。
|
|
148
|
+
|
|
149
|
+
1. **導出の規則は仕様が持つ。**実装ではない。規則が消費者ごとに違えば、同じ原本から違う建物が出る。それは原本ではない。規則は [derivation.md](derivation.md) が持つ (意味論の側からの記述は [semantics.md](semantics.md) §2-4)
|
|
150
|
+
2. **充足性を検査する。**形を作るのに必要な情報が揃っているかは構造の整合の一部である (SUF01-04)。**妥当性の判定ではなく、完全性の検査である**
|
|
151
|
+
3. **参照実装を持ち、検査で回す。**`derive(model): Form` が唯一の入口であり、**見た目を持たない** — 色も書体も線幅も注記文字列も返さない。`src/draw/` と ugatsu はこの `Form` を描くだけである ([derivation.md §7](derivation.md))
|
|
152
|
+
4. **一意性は機械が縛れる述語である。**「一意」は文としての約束ではなく、次の含意として書かれる ([ADR-0041](../docs/decisions/0041-derivation-uniqueness.md))
|
|
153
|
+
|
|
154
|
+
```
|
|
155
|
+
toCanonical(a) === toCanonical(b) ⟹ derive(a) ≡ derive(b)
|
|
156
|
+
```
|
|
157
|
+
|
|
158
|
+
**形は正準形の関数である。**正準形は「同じ建物とは何か」の定義なので ([canonical-json.md](canonical-json.md))、正準形が捨てる情報 — 線の端点の書き順・境界の宣言順・行の並び — は形を変えてはならない。変えるなら、捨ててよいものを捨てていないか、捨ててはいけないものを捨てているかのどちらかである
|
|
159
|
+
|
|
160
|
+
**「同じ構成から複数の形が出る」ことは欠陥である。**複数あってよいのは**見た目**であって、形ではない。
|
|
161
|
+
|
|
162
|
+
---
|
|
163
|
+
|
|
164
|
+
## 7. 属性の三層
|
|
165
|
+
|
|
166
|
+
| 層 | 例 | core の態度 |
|
|
167
|
+
|---|---|---|
|
|
168
|
+
| **構造** | パス・型・区画・レベル・関係の相手・kind | **必ず見る。**壊れていれば読まない |
|
|
169
|
+
| **解釈** | `h` `w` `at` `daylight` `road` `site` `style` … | 台帳 ([vocabulary.md](vocabulary.md)) が値域を定義し、**見る** |
|
|
170
|
+
| **運搬** | `acme.sensor` `bems.temp` `survey.measured` … | **見ない。**名前空間つきで開いている |
|
|
171
|
+
|
|
172
|
+
**運搬層は名前空間 (ドット区切り) を持つ。**`acme.sensor:23` のように書く。名前空間を持たない未知のキーは**エラー (ATT03)** である — `heigh:2400` のような一字違いが黙って効かないことを防ぐためで、これが「見ていないこと」と「見て問題がないこと」を区別できる唯一の形である。
|
|
173
|
+
|
|
174
|
+
開いていることと信頼できることは、境界が宣言されていれば両立する。宣言が無ければ、**見ていないことと、見て問題がないことが区別できない。**その状態の「異常なし」は何も意味しない。**持てるが判定しないは正当な状態であり、それを明示することが自由の条件である。**
|
|
175
|
+
|
|
176
|
+
詳細は [vocabulary.md](vocabulary.md)。
|
|
177
|
+
|
|
178
|
+
---
|
|
179
|
+
|
|
180
|
+
## 8. 1.0.0 が凍結する八つの面
|
|
181
|
+
|
|
182
|
+
**1.0.0 は機能の完成ではない。壊さないと約束する面の確定である。**
|
|
183
|
+
|
|
184
|
+
| 面 | 約束の内容 |
|
|
185
|
+
|---|---|
|
|
186
|
+
| **muro 1.0 の文法と意味論** | この版で読めたものは、以後も同じ意味で読める |
|
|
187
|
+
| **合成の規則** | [composition.md](composition.md) の六つ。同じ入力からは常に同じ結果が出る |
|
|
188
|
+
| **同一性** | §5 の規則。uid が同じなら同じものである |
|
|
189
|
+
| **属性の三層と名前空間** | §7。運搬層は見ない、という約束を含む |
|
|
190
|
+
| **機械形式** | **形式版を名乗る** ([canonical-json.md](canonical-json.md))。同じ入力からは同じバイト列が出る — 照合順と正規化を規範が定める。合成の結果を持ち、形を持たない |
|
|
191
|
+
| **導出規則** | §6。仕様として明文であり、参照実装が API として提供される |
|
|
192
|
+
| **構造整合の診断** | コードと severity。緑の意味が §3 の定義と一致する |
|
|
193
|
+
| **公開 API と CLI** | 解析・合成・正準化・問い・導出。コマンド、引数、終了コード |
|
|
194
|
+
|
|
195
|
+
### 凍結の対象でないもの
|
|
196
|
+
|
|
197
|
+
**存在してよいが、凍結対象でないことが明示されている。**
|
|
198
|
+
|
|
199
|
+
- **形の生成と描画** — `svgPlan` / `svgAxo` / CLI の `plan` `axo` / MCP の `plan_svg`。CLI の**面** (サブコマンド名・引数・終了コード) は凍るが、**SVG の中身は凍らない**。描画は `Form` を描くだけなので、**変わってはならないのは SVG ではなく `Form` である** ([derivation.md §9](derivation.md))
|
|
200
|
+
- **建築的な判定** — [validation.md](validation.md) の規則群と `koyu validate` の出力。増える面である
|
|
201
|
+
- **MCP のツール群** — 追加的に増える面として扱う
|
|
202
|
+
- **外部形式との往復と取り込み**
|
|
203
|
+
- **人のための面** — エディタ支援・オーサリング。ugatsu が持つ
|
|
204
|
+
- **運搬層の属性の意味**
|
|
205
|
+
|
|
206
|
+
---
|
|
207
|
+
|
|
208
|
+
## 9. 版の数え方
|
|
209
|
+
|
|
210
|
+
版は二本である。
|
|
211
|
+
|
|
212
|
+
- **muro の版** — 言語と意味論と合成の規則。機械形式が持つ**意味**はこの版に従う (同じ意味論の別の綴りである)
|
|
213
|
+
- **koyu の版** — 実装。どの muro を実装するかを宣言する
|
|
214
|
+
|
|
215
|
+
**機械形式はこの二本のどちらでもない、綴りの版を持つ** — `format` キー ([canonical-json.md](canonical-json.md))。意味論は muro が持つが、同じ意味論を別のキーで綴り直すことはありうるので、綴りの版は別に数える。
|
|
216
|
+
|
|
217
|
+
ugatsu は独立に版を持ち、従う muro の版を宣言する。検証の面は版を持たず、追加的に増える。
|
|
218
|
+
|
|
219
|
+
**二本は別の約束なので、同時に到達する必要はない** ([ADR-0042](../docs/decisions/0042-two-version-lines.md))。muro の版は「このように書かれたファイルは、この意味であり続ける」を約束し、koyu の版は「この実装の面を壊さない」を約束する。現に muro は 1.0 に到達し、koyu は 0.x のまま — **言語は確定し、実装はまだ何も凍結を約束していない。**
|
|
220
|
+
|
|
221
|
+
---
|
|
222
|
+
|
|
223
|
+
## 10. 持たないもの
|
|
224
|
+
|
|
225
|
+
- **原本における幾何** (例外は所与 — 敷地形状の `polygon`)
|
|
226
|
+
- **配置の仕組み** — 内包は座を与えない。柱と機器は「どの空間に含まれるか」だけを持ち、そこから形は作れない
|
|
227
|
+
- **建築的な判定を原本の契約に含めること**
|
|
228
|
+
- **実務解像度の追求。**カバー率は価値ではない — 足せば機械の視野から外れ、目的が壊れる
|
|
229
|
+
- **往復互換。**出口は作るが往復は作らない
|