@kensnzk/koyu 0.16.0 → 0.17.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 +12 -8
- package/README.md +13 -10
- package/dist/cli.js +14 -11
- package/dist/cli.js.map +1 -1
- package/dist/core/derive.d.ts +13 -8
- package/dist/core/derive.d.ts.map +1 -1
- package/dist/core/derive.js +19 -13
- package/dist/core/derive.js.map +1 -1
- package/dist/core/diagnose.d.ts +4 -3
- package/dist/core/diagnose.d.ts.map +1 -1
- package/dist/core/diagnose.js +46 -11
- package/dist/core/diagnose.js.map +1 -1
- package/dist/core/diff.d.ts +3 -2
- package/dist/core/diff.d.ts.map +1 -1
- package/dist/core/diff.js +8 -5
- package/dist/core/diff.js.map +1 -1
- package/dist/core/fabric.d.ts +1 -3
- package/dist/core/fabric.d.ts.map +1 -1
- package/dist/core/fabric.js +8 -8
- package/dist/core/fabric.js.map +1 -1
- package/dist/core/graph.d.ts +2 -2
- package/dist/core/graph.d.ts.map +1 -1
- package/dist/core/graph.js +12 -5
- package/dist/core/graph.js.map +1 -1
- package/dist/core/light.d.ts.map +1 -1
- package/dist/core/light.js +2 -2
- package/dist/core/light.js.map +1 -1
- package/dist/core/model.d.ts +59 -10
- package/dist/core/model.d.ts.map +1 -1
- package/dist/core/model.js +128 -26
- package/dist/core/model.js.map +1 -1
- package/dist/core/parse.d.ts.map +1 -1
- package/dist/core/parse.js +83 -82
- package/dist/core/parse.js.map +1 -1
- package/dist/core/poly.d.ts +0 -4
- package/dist/core/poly.d.ts.map +1 -1
- package/dist/core/poly.js +1 -5
- package/dist/core/poly.js.map +1 -1
- package/dist/core/site.d.ts.map +1 -1
- package/dist/core/site.js +2 -2
- package/dist/core/site.js.map +1 -1
- package/dist/core/tolerance.d.ts +1 -1
- package/dist/core/tolerance.js +2 -2
- package/dist/core/tolerance.js.map +1 -1
- package/dist/core/vertical.d.ts +9 -2
- package/dist/core/vertical.d.ts.map +1 -1
- package/dist/core/vertical.js +8 -1
- package/dist/core/vertical.js.map +1 -1
- package/dist/core/vocabulary.d.ts.map +1 -1
- package/dist/core/vocabulary.js +17 -5
- package/dist/core/vocabulary.js.map +1 -1
- package/dist/draw/index.js +1 -1
- package/dist/draw/index.js.map +1 -1
- package/dist/draw/plan.js +5 -5
- package/dist/draw/plan.js.map +1 -1
- package/dist/index.d.ts +3 -2
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +17 -11
- package/dist/index.js.map +1 -1
- package/dist/mcp.js +43 -12
- package/dist/mcp.js.map +1 -1
- package/dist/parse-file.d.ts.map +1 -1
- package/dist/parse-file.js +18 -3
- package/dist/parse-file.js.map +1 -1
- package/dist/validate/access.d.ts.map +1 -1
- package/dist/validate/access.js +23 -13
- package/dist/validate/access.js.map +1 -1
- package/dist/validate/envelope.d.ts.map +1 -1
- package/dist/validate/envelope.js +3 -3
- package/dist/validate/envelope.js.map +1 -1
- package/dist/validate/index.d.ts +1 -1
- package/dist/validate/index.d.ts.map +1 -1
- package/dist/validate/index.js +1 -1
- package/dist/validate/index.js.map +1 -1
- package/dist/validate/light.js +1 -1
- package/dist/validate/light.js.map +1 -1
- package/dist/validate/site.d.ts.map +1 -1
- package/dist/validate/site.js +2 -2
- package/dist/validate/site.js.map +1 -1
- package/editors/vscode/syntaxes/koyu.tmLanguage.json +2 -2
- package/examples/basement/main.muro +3 -3
- package/examples/complex/main.muro +1 -1
- package/examples/complex/podium.muro +1 -1
- package/examples/complex/site.muro +6 -6
- package/examples/house/L2.muro +1 -1
- package/examples/house/main.muro +1 -1
- package/examples/house/site.muro +4 -4
- package/examples/house.muro +6 -6
- package/examples/mansion.muro +2 -2
- package/examples/office.muro +3 -3
- 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/L2.muro +1 -1
- package/examples/tower/main.muro +1 -1
- package/examples/tower/site.muro +4 -4
- package/examples/twin/main.muro +1 -1
- package/examples/twin/podium.muro +4 -4
- package/examples/twin/site.muro +8 -8
- package/examples/two-rooms.canonical.json +4 -4
- package/examples/two-rooms.muro +2 -2
- package/package.json +5 -5
- package/src/cli.ts +15 -10
- package/src/core/derive.ts +32 -15
- package/src/core/diagnose.ts +63 -16
- package/src/core/diff.ts +10 -6
- package/src/core/fabric.ts +18 -9
- package/src/core/graph.ts +19 -5
- package/src/core/light.ts +2 -2
- package/src/core/model.ts +141 -31
- package/src/core/parse.ts +100 -85
- package/src/core/poly.ts +1 -8
- package/src/core/site.ts +2 -2
- package/src/core/tolerance.ts +2 -2
- package/src/core/vertical.ts +10 -3
- package/src/core/vocabulary.ts +18 -5
- package/src/draw/index.ts +1 -1
- package/src/draw/plan.ts +5 -5
- package/src/index.ts +30 -9
- package/src/mcp.ts +44 -11
- package/src/parse-file.ts +17 -3
- package/src/validate/access.ts +24 -12
- package/src/validate/envelope.ts +3 -3
- package/src/validate/index.ts +2 -2
- package/src/validate/light.ts +1 -1
- package/src/validate/site.ts +2 -2
- package/spec/README.md +0 -28
- package/spec/canonical-json.md +0 -98
- package/spec/composition.md +0 -121
- package/spec/derivation.md +0 -393
- package/spec/en/README.md +0 -30
- package/spec/en/canonical-json.md +0 -101
- package/spec/en/composition.md +0 -121
- package/spec/en/derivation.md +0 -393
- package/spec/en/language.md +0 -164
- package/spec/en/notation-v0.md +0 -145
- package/spec/en/scope.md +0 -229
- package/spec/en/semantics.md +0 -132
- package/spec/en/tools.md +0 -108
- package/spec/en/validation.md +0 -79
- package/spec/en/vocabulary.md +0 -103
- package/spec/language.md +0 -163
- package/spec/notation-v0.md +0 -184
- package/spec/scope.md +0 -229
- package/spec/semantics.md +0 -130
- package/spec/tools.md +0 -106
- package/spec/validation.md +0 -79
- package/spec/vocabulary.md +0 -114
package/spec/semantics.md
DELETED
|
@@ -1,130 +0,0 @@
|
|
|
1
|
-
[English](en/semantics.md) · **日本語**
|
|
2
|
-
|
|
3
|
-
# 意味論リファレンス — 導出・検査・問い
|
|
4
|
-
|
|
5
|
-
koyu v0.16.0 現在。文法は [language.md](language.md)。ここに書くのは「書かれたものから何が導かれ、何が検査され、問いに何が返るか」— 形も数量も内外の別も、原本には無く、すべてここに定義される導出である。
|
|
6
|
-
|
|
7
|
-
## 1. モデル
|
|
8
|
-
|
|
9
|
-
合成後のモデルは次からなる: `spaces` (パス→空間: 型・レベル・矩形合併・areas・属性・出所)、`boundaries` (関係の列: a/b パス・kind・t/air/edge・openings・segs・出所)、`zones` (パス→集約)、`assets` (名→建具型)、`polygons` (パス→敷地形状)、`grid` / `levels`。出所 (`file`) は**ローダーが与えたキー**で、エラー・警告の位置表記 (`file:行`) に使われる。CLI と MCP はファイルを読むので**解決済みの絶対パス**が入る (`parseFiles` に文字列の辞書を渡した場合はそのキー)。`columns` (柱の宣言 — ADR-0023) も合成後のモデルに含まれ、宣言順を保つ (ADR-0029)。
|
|
10
|
-
|
|
11
|
-
## 2. 平面の導出
|
|
12
|
-
|
|
13
|
-
**共有辺。** 二つの空間の壁芯線分は、矩形合併同士の共有辺 (同一直線上で重なる区間) として導出される。共線の区間は一本にマージされるため、複数矩形をまたぐ開口も一つの線分上に置ける。
|
|
14
|
-
|
|
15
|
-
**外部境界。** 領域を持たない空間 (exterior等) との境界は、部屋の外周から「他の空間と接する区間」を除いた残りである。複数辺に分かれるため、開口を置くには `edge:` で辺を選ぶ。`edge` の方角は a側 (先に書いた空間) の矩形から見る。
|
|
16
|
-
|
|
17
|
-
**既定境界 (ADR-0014)。** 同一レベル (未特定同士を含む) で平面が接する領域つき空間の組に、宣言境界がその組に一つも無ければ、`wall` の既定境界が合成後に導出される (`derived`)。垂直の「既定は床」と対称の、水平の「既定は壁」— 未宣言の接触は「未定義」ではなく「壁」を意味する。既定の壁は扉を持たないため通れず、描画は素の宣言wallと同一。宣言がその組に一つでもあれば (edge限定含む) 導出しない。領域つきのexteriorとの接触にも導出される (接道長に算入される)。既定境界は正準JSONに出ない — 正準JSONは書かれた構成、意味は導出後のModelが持つ。
|
|
18
|
-
|
|
19
|
-
**開口の配置。** 比率 `at` は線分長に対する中心位置で、開口が線分に収まるようクランプされる。通り参照の明示位置はクランプされない — 中心±w/2 が線分から出ればエラー (許容範囲つき)、水平線分にY系・垂直線分にX系の参照もエラー。同じ線分上の開口は中心間距離 ≥ (w₁+w₂)/2 でなければエラー。
|
|
20
|
-
|
|
21
|
-
## 3. 垂直の導出と高さの不変量
|
|
22
|
-
|
|
23
|
-
**垂直隣接は宣言しない。** 連続するレベルの空間同士は、平面の重なりから垂直に隣接する。既定の解釈は「床がある」。例外だけを境界で宣言する: `stair` (通行可) / `shaft` (連続するが通行不可) / `void` (床の不在)。
|
|
24
|
-
|
|
25
|
-
**高さの不変量 (階高検査)。** 各空間について `天井高 (heff) + 上階のslab ≤ 階高 (次レベルzまで)` を検査し、超えれば食い込みエラー。`levels` がこの積み上がりをテキストの矩計として表示する。**void免除**: void境界で結ばれた下階空間は不変量を宣言的に免除される。被覆率 ≥99% (全面吹抜け) のときだけ階をまたぐ天井高を宣言できる — 部分吹抜けでは下階の天井高は階高内のまま。void空間の上側は `type:void` を想定 (違えば警告 — 実装とテストが正でありspecを合わせた。ADR-0013)。
|
|
26
|
-
|
|
27
|
-
**面の要素 (床・天井・屋根)。** 床は level の `slab` (床組み厚) だけが与える — 書かなければその階に床は一枚も生成されない (SUF03)。天井は有効天井高 `heff` (空間の `h` → 所属レベルの `h`) が与える — 決まらなければ天井は生成されない (SUF01)。吹抜け (`type:void`) に床と天井は無く、外部と半屋外に天井と屋根は無い。屋根は「上に空間が重なっていない範囲」に架かり、**上のレベルがあれば天井高を読まない** — 頂点も厚さもそのレベルが与える (ADR-0024。式は [derivation.md §3.6](derivation.md))。**規則は決定的である** — 値が無いときに既定値を捏造せず、要素を作らない。だから同じ構成からは常に同じ形が出るが、**形が痩せていることは知らされなければならない**。これが充足性の検査 (SUF01-04) の在る理由である。
|
|
28
|
-
|
|
29
|
-
## 4. 導出される性質
|
|
30
|
-
|
|
31
|
-
**半屋外 (isSemiOutdoor)。** 宣言ではなく導出: 外部 (`type:exterior`) に対して `open` または `air:1` の境界を持つ、領域つきの空間。バルコニー・テラス・屋外階段・庭がこれになる。面積表で別掲 (屋内床面積に算入しない)、採光で係数、平面で淡色/細線。
|
|
32
|
-
|
|
33
|
-
**庇下 (isCoveredAbove)。** 上に (どのレベルであれ) 空間が重なっているか。屋根の有無すら宣言でなく導出 — 採光の半屋外係数 (下記) が読む。
|
|
34
|
-
|
|
35
|
-
**通行可能性 (passable)。** wall は扉があるときだけ通行可。open・stair は常に通行可。shaft・void は通行不可。air:1 は遮蔽の話であって通行の話ではない (手すり壁は通れない)。
|
|
36
|
-
|
|
37
|
-
## 5. 検査 (check) の一覧
|
|
38
|
-
|
|
39
|
-
`check` の一次形式は構造化診断 (`checkDiagnostics` — ADR-0016): `code` (下表の台帳 = 実装の `DIAGNOSTIC_CODES`。テストが一致を機械検査する)、`severity` (コードの不変属性 — 重さを変えるときは新コードを切る)、`message` (日本語本文 — 位置接頭辞なし)、出所 (`line`/`file`)、対象パス (`path` — 境界は両パス)、関連位置 (`related` — 重複の既出側など)。`check` は互換の文字列形式 (`file:N行目: 本文`) を同件・同順で返す。エラーは構成が成立していないこと、警告は疑わしいことを言う。
|
|
40
|
-
|
|
41
|
-
**並びは契約である。**診断は**走査の順**に出る — 検査は節 (下表の族におおむね対応する) の列として実行され、各節はモデルの一つの集合 (境界・空間・柱の宣言・多角形…) を宣言順に一周する。したがって**一つの境界が出す複数のコードは離れない**。並びに依存してよいのはこの規則までで、節の順序そのものは規範ではない (テストが現状を固定している)。
|
|
42
|
-
|
|
43
|
-
| コード | severity | 概要 |
|
|
44
|
-
|---|---|---|
|
|
45
|
-
| REF01 | error | 境界が未定義の空間パスを参照している |
|
|
46
|
-
| BND01 | error | 同一空間同士の境界 |
|
|
47
|
-
| BND02 | error | 同一空間対の境界の重複 (edge限定まで同一 — wall/open矛盾を含む。ADR-0013。related=既出側) |
|
|
48
|
-
| BND03 | error | 異なるレベルの空間への壁境界 (垂直は type:stair/shaft/void) |
|
|
49
|
-
| BND04 | error | 接していない空間の境界 (線分が導けない) |
|
|
50
|
-
| LVL01 | error | レベルzの重複 |
|
|
51
|
-
| GEO01 | error | 空間の領域 (合併の矩形) 同士の重なり |
|
|
52
|
-
| GEO02 | error | 同一レベルの空間同士の領域の重なり (related=後出側) |
|
|
53
|
-
| VRT01 | error | 垂直境界 (stair/shaft/void) の前提 — 領域とレベルを持つ空間同士にのみ書ける |
|
|
54
|
-
| VRT02 | error | 非隣接レベル間の垂直境界 |
|
|
55
|
-
| VRT03 | error | 平面が重ならない垂直境界 |
|
|
56
|
-
| OPN01 | error | hingeの軸違い (水平線分はW/E・垂直線分はN/S) |
|
|
57
|
-
| OPN02 | error | 同一線分上の開口同士の重なり (中心間 < (w₁+w₂)/2) |
|
|
58
|
-
| OPN04 | error | 開口を置ける境界線分が無い |
|
|
59
|
-
| OPN05 | error | 境界線分が複数で曖昧 (edge: で辺を指定する) |
|
|
60
|
-
| OPN06 | error | 開口の幅が境界線分の長さを超える |
|
|
61
|
-
| OPN07 | error | 開口の明示位置の軸違い (水平線分にY系・垂直線分にX系の通り参照) |
|
|
62
|
-
| OPN08 | error | 開口の明示位置のはみ出し (通り参照はクランプしない — 許容範囲つき) |
|
|
63
|
-
| SEG01 | error | 領域を持たない空間への area |
|
|
64
|
-
| SEG04 | error | seg を置ける境界線分が無い (OPN04のseg版) |
|
|
65
|
-
| SEG05 | error | seg の境界線分が複数で曖昧 (OPN05のseg版) |
|
|
66
|
-
| SEG06 | error | seg の幅が境界線分の長さを超える (OPN06のseg版) |
|
|
67
|
-
| SEG07 | error | seg の明示位置の軸違い (OPN07のseg版) |
|
|
68
|
-
| SEG08 | error | seg の明示位置のはみ出し (OPN08のseg版) |
|
|
69
|
-
| HGT01 | error | 高さ不変量違反 — 上階への食い込み (天井高 + 上階slab > 階高) |
|
|
70
|
-
| HGT02 | error | 部分吹抜けの被覆不足 (被覆 <99% では階をまたぐ天井高を宣言できない) |
|
|
71
|
-
| SUF01 | error | 天井高が決まらない — 空間の `h` もレベルの `h` も無い。押し出す高さが無く、天井も屋根も生成できない (吹抜け・外部・半屋外は除く — ADR-0034) |
|
|
72
|
-
| SUF02 | error | レベルが特定できない領域つき空間 — z が決まらず、立体が一つも生成できない |
|
|
73
|
-
| SIT01 | error | 敷地形状の重複頂点 |
|
|
74
|
-
| SIT02 | error | 敷地形状の自己交差 |
|
|
75
|
-
| UID01 | error | 数字だけのuid (parseの数値化でトークンの区別が失われる — ADR-0015) |
|
|
76
|
-
| UID02 | error | 空白を含むuid |
|
|
77
|
-
| UID03 | error | uidの重複 (space/zone横断でモデル全体一意) |
|
|
78
|
-
| UID04 | error | 含む対象の中で `name` が重複 (開口・segは境界の中、areaは空間の中、柱はモデルの中。開口がアセットから継いだ名は型の名なので数えない — ADR-0039) |
|
|
79
|
-
| ATT01 | error | 解釈される属性の値が正の数値でない (`h` `riser` `tread` `entry` `landing` `lane` `slope` `road` `area` — 台帳の型に合わない値は黙って既定へ落とさない。ADR-0028) |
|
|
80
|
-
| ATT02 | error | 解釈される属性の値が台帳の語彙にない (`ceiling` 0/1・`turn` R/L・`site` 0/1・`style` hinged/sliding/auto — ADR-0028) |
|
|
81
|
-
| ATT03 | error | 台帳に無い属性キー — 名前空間 (`acme.sensor` のようなドット区切り) を持たないものは書けない (ADR-0033) |
|
|
82
|
-
| DAY01 | error | daylightの値が 0/1 以外 (採光の対象は二値の宣言 — ADR-0020) |
|
|
83
|
-
| RUN01 | error | 一つの空間に縦動線の宣言が複数 (stair/ramp/escalator/lift は一つの空間に一つ — ADR-0021) |
|
|
84
|
-
| RUN02 | error | 縦動線の値が上る向き (N/E/S/W) でない (lift は 1) |
|
|
85
|
-
| RUN03 | error | 縦動線の領域が矩形一つでない、またはレベルが特定できない (合併では段割りが決まらない) |
|
|
86
|
-
| RUN05 | error | form の値が straight/return 以外、または踊り場が全長を超えて形が決まらない |
|
|
87
|
-
| LIN01 | error | 描かれた線が二つの空間を分離しない (両側の割付の偏りが同じ、または割付をちょうど二等分して残す側が決まらない — ADR-0022) |
|
|
88
|
-
| LIN02 | error | 垂直境界に描かれた線 (線は平面を区切る行為) |
|
|
89
|
-
| VER01 | error | koyu 0.1 での既定境界の導出 (旧版は意味保存の場合のみ受理 — ADR-0017) |
|
|
90
|
-
| VER02 | error | koyu 0.3以前で、採光の対象と推定されていた型 (unit/room/ldk/bedroom/living) の空間に daylight が無い (0.4では対象から外れ意味が変わる — ADR-0020) |
|
|
91
|
-
| VER03 | error | koyu 0.4以前のファイルに 0.5 の語 (縦動線の宣言・描かれた線・柱・地下) がある (旧処理系は知らない語なので黙って形が生成されない — ADR-0017/0021/0022/0023) |
|
|
92
|
-
| VER04 | error | koyu 0.5以前のファイルに 1.0 の語 (上書き `over`・削除 `drop`・`over` 直下の集合編集 `+` `-` `=`) がある (旧処理系は知らない語なので上書きも削除も起きず、黙って別の建物になる — ADR-0017/0035/0038) |
|
|
93
|
-
| SYN01 | error | 構文・合成エラー (SourceError の写し — `check --json` のみ。checkは投げられた例外を診断にせず、parseが投げる) |
|
|
94
|
-
| BND05 | warning | 同一空間対でedge限定の有無が混在する境界 (線分が重なる) |
|
|
95
|
-
| BND06 | warning | 境界線分がゼロ (外周に残る辺が無い) |
|
|
96
|
-
| VRT04 | warning | void境界の上側が type:void でない |
|
|
97
|
-
| VRT05 | warning | 垂直境界の開口 (解釈されない) |
|
|
98
|
-
| VRT06 | warning | 垂直境界の seg (解釈されない) |
|
|
99
|
-
| OPN03 | warning | open境界の開口 (通行に影響しない — 常に通れる) |
|
|
100
|
-
| SEG02 | warning | area が親の領域からはみ出している |
|
|
101
|
-
| SEG03 | warning | open境界 (壁が無い) の seg (解釈されない) |
|
|
102
|
-
| ZON01 | warning | 空のゾーン (配下に空間が無い) |
|
|
103
|
-
| ZON02 | warning | ゾーンと同パスの空間 |
|
|
104
|
-
| SUF03 | warning | レベルに `slab` が無く、その階の床が一枚も生成されない (高さ不変量も立式できない。形は定まるので警告 — ADR-0034) |
|
|
105
|
-
| SIT04 | warning | 対応するゾーンの無い polygon |
|
|
106
|
-
| SUF04 | warning | 縦動線の宣言があるのに形が一つも生成されない (上にレベルが無い — 最上階の階段など) |
|
|
107
|
-
| LIN03 | warning | 描かれた線が何も切っていない (既定の隣接線と同じか、線の及ぶ範囲に割付が無い) |
|
|
108
|
-
| COL01 | warning | 柱の宣言に対して立つ柱が一本も無い (通りの交点にその階の床が無い — ADR-0023) |
|
|
109
|
-
| COL02 | warning | 通りを限定しない柱の宣言が同じレベルに複数 (同じ交点では先の宣言が勝つ) |
|
|
110
|
-
| BND07 | — | 欠番 — 「接しているのに境界が無い」警告はADR-0014で廃止 (未宣言の接触は既定の壁を意味する) |
|
|
111
|
-
| HGT03 | — | 欠番 — 「上階の slab が無い」は SUF03 へ合流 (ADR-0034) |
|
|
112
|
-
| HGT04 | — | 欠番 — 「天井高が不明」は SUF01 へ合流し、error になった (ADR-0034) |
|
|
113
|
-
| HGT05 | — | 欠番 — 「レベルが特定できない」は SUF02 へ合流し、error になった (ADR-0034) |
|
|
114
|
-
| RUN04 | — | 欠番 — 「上にレベルが無く形が生成されない」は SUF04 へ合流 (ADR-0034) |
|
|
115
|
-
|
|
116
|
-
## 6. 問い — 同じ記述の異なる読み方
|
|
117
|
-
|
|
118
|
-
**doors (避難・動線)。** 空間グラフ (§4の通行可能性で辺を張る) 上の最少扉数経路。`doorsBetween(from, to)` → 扉数と経由パス列、到達不能なら undefined。
|
|
119
|
-
|
|
120
|
-
**stats (面積)。** 屋内床面積 = 領域とレベルを持ち、void でも exterior でも半屋外でもない空間の壁芯面積の合計。レベル別小計・半屋外の別掲・ゾーン別 (パス接頭辞の合計 — 間取りに割っても住戸の言葉を保つ)・型別・use別 (zone→space継承後の実効use)。
|
|
121
|
-
|
|
122
|
-
**light (採光)。** 対象: `daylight:1` を書いた領域つき空間**だけ** — 採光の対象は宣言であり、型からは推定しない (既定は対象外。ADR-0020)。判定の分母をどの粒度に置くか (住戸まるごとか、割った室ごとか) は `daylight:1` を書く位置として書き手が決める。窓面積 = その空間の境界上の `h` を持つwindowの w×h の合計。係数: 窓の先の半屋外が**上に空間を持つ** (バルコニー下・庇下) なら0.7、上が開いていれば1.0。判定: 有効窓面積 ≥ 床面積/7 (補正係数なしの粗い判定)。
|
|
123
|
-
|
|
124
|
-
**site (敷地)。** 対象: `site:1` のゾーン。敷地面積 = polygonがあればシューレース、なければ敷地内空間+屋内投影の合併 — 宣言 (`area:` 測量値) と照合 (±0.05㎡)。不一致は `check` の警告にもなる (polygonがある場合 — CLI/API/MCPで同じ判定。ADR-0013)。接道 = 敷地ゾーン配下の空間と `road:幅員` を持つexteriorとの境界線分長の合計 (建物外壁が道路に面する分は数えない)。建築面積 = 屋内空間の水平投影の合併 (算入細則は粗い)。建蔽率・容積率はこれらの商。
|
|
125
|
-
|
|
126
|
-
**levels (矩計)。** レベルをz順に、階高 = 天井高 + slab + 余り の積み上がりとして表示する。
|
|
127
|
-
|
|
128
|
-
## 7. 描画 (plan) の規約
|
|
129
|
-
|
|
130
|
-
形は生成物 — 同じ構成から複数の形が出ることは欠陥ではない。svgPlanの規約: 空間は淡い面 (半屋外はさらに淡く)、壁は導出線分の黒帯 (t で太さ)、open境界は破線、air:1 は細実線、吹抜けは破線対角線 (下階には「上部吹抜け」の投影)、扉は吊元と1/4円の軌跡 (sliding/autoは戸袋側パネル)、窓は芯線、seg は色調変化、area は淡面+破線。通り芯と記号。最下階は配置図兼用で、敷地形状を一点二点鎖線の敷地境界線として描く (polygonを含めて紙面を確保)。
|
package/spec/tools.md
DELETED
|
@@ -1,106 +0,0 @@
|
|
|
1
|
-
[English](en/tools.md) · **日本語**
|
|
2
|
-
|
|
3
|
-
# ツールリファレンス — CLI・MCP・公開API
|
|
4
|
-
|
|
5
|
-
koyu v0.16.0 現在。すべてのツールは同じ導出 (semantics.md) の別の入口である — CLIは人の手、MCPはエージェント、APIはプログラム。
|
|
6
|
-
|
|
7
|
-
## CLI (`koyu` / `npm run koyu --`)
|
|
8
|
-
|
|
9
|
-
```
|
|
10
|
-
koyu <check|validate|layers|diff|plan|axo|doors|graph|stats|levels|runs|light|site|json> <file.muro> [引数...]
|
|
11
|
-
```
|
|
12
|
-
|
|
13
|
-
| コマンド | 引数 | 出力 | 終了コード |
|
|
14
|
-
|---|---|---|---|
|
|
15
|
-
| `check` | `--json` (Diagnostic[]をJSON出力 — 構文・合成エラーはSYN01の1件に写して有効JSONのまま), `--strict` (警告があれば終了コード1) | 構造整合の可否・エラー/警告 (出所つき)。診断コード台帳は semantics.md §5。**建築的な妥当性は言わない** (scope.md §3) | 0=緑 / 1=エラー (--strict時は警告も) |
|
|
16
|
-
| `validate` | `--json` (Finding[]をJSON出力) | 建築的な判定 (validation.md の台帳)。**checkの保証ではない** — 型もコードの綴りも別で、終了コードの流儀だけが同じ | 0=違反なし / 1=違反あり |
|
|
17
|
-
| `layers` | `--attrs` (属性ごとの最終値の出所) | 合成に参加した層を弱い順に。**暗黙の解決はどこにも無い**ことを目で確かめる面 (composition.md 規則1・6) | 0 |
|
|
18
|
-
| `diff` | `<b.muro>` (比較先 — entryが比較元), `--json` (ModelDiffをJSON出力) | 構成の言葉の差分 (ADR-0018): grid移動・改名 (uid一致・パス不一致)・空間/境界/開口のフィールド変化。行順・書式・素wall宣言と省略 (既定壁) の違いは差分にしない | 0=差分なし / 1=差分あり / 2=入力が壊れている |
|
|
19
|
-
| `plan` | `-l レベル` (既定: 最初のレベル), `-o 出力.svg` (既定: `<entry>-<レベル>.svg`) | 平面SVG生成 | 0 / 2 (未宣言のレベル名 — 呼び方の問題。ADR-0028) |
|
|
20
|
-
| `axo` | `-o 出力.svg` (既定 `out/axo.svg`), `-d NE\|NW\|SE\|SW` (既定 SE), `-l L1..L5` または `-l L1,L3`, `-s 縮尺`, `--no-walls`, `--ceilings` | 軸測図SVG生成 — 床・屋根・壁・柱・縦動線を投影する (ADR-0026)。実行環境もWebGLも要らないので、平面と同じ「生成して見る」手で立体を確かめられる | 0 / 2 (未宣言のレベル名・読めない縮尺・未知の向き — 空のSVGも `NaN` のSVGも黙って書かない。ADR-0028) |
|
|
21
|
-
| `doors` | `/パスA /パスB` | 扉数と経由列、到達不能なら1 | 0/1/2 |
|
|
22
|
-
| `graph` | — | 空間ごとの隣接 (境界種別・扉数) | 0 |
|
|
23
|
-
| `stats` | — | レベル別面積・半屋外別掲・ゾーン別・型別・use別 | 0 |
|
|
24
|
-
| `levels` | — | テキストの矩計 (階高の積み上がり) | 0 / 1 |
|
|
25
|
-
| `runs` | — | 縦動線の一覧 — 装置・上る高さ・折返しの有無・導出された勾配と走り長 (ADR-0021)。段数と踏面は `check` の RUN06 が検査する | 0 |
|
|
26
|
-
| `light` | — | **`daylight:1` と宣言された室**の1/7採光判定 (対象は型から推定しない — ADR-0020) | 0=全て✔ / 1 / 1=対象なし |
|
|
27
|
-
| `site` | — | 敷地面積 (宣言/導出照合)・接道・建蔽率・容積率 | 0 / 1=敷地なし |
|
|
28
|
-
| `json` | — | 正準JSON (canonical-json.md) | 0 |
|
|
29
|
-
|
|
30
|
-
entryは常にファイルパスで、importは自動で合成される。
|
|
31
|
-
|
|
32
|
-
## MCPサーバー (`koyu-mcp` — ADR-0012)
|
|
33
|
-
|
|
34
|
-
stdio上のMCP (JSON-RPC 2.0、行区切りJSON)。依存ゼロ・ステートレス (全ツールが `file` = entryパスを受け、毎回合成する)。登録例: `claude mcp add koyu -- npx -p @kensnzk/koyu koyu-mcp`。
|
|
35
|
-
|
|
36
|
-
| ツール | 引数 | 返り |
|
|
37
|
-
|---|---|---|
|
|
38
|
-
| `model_summary` | file | 名前・レベル・レイヤー構成・ゾーン・アセット・面積・check件数 — **まず呼ぶ** |
|
|
39
|
-
| `check` | file | ok・エラー/警告 (出所レイヤー:行つき)・diagnostics (構造化診断 — ADR-0016。文字列と同件・同順) — **編集のたびに呼ぶ門番** |
|
|
40
|
-
| `layers` | file | 合成に参加した全レイヤーの {file, source} — 原本を読む |
|
|
41
|
-
| `write_layer` | file, layer, content | 検査してから全置換 (parse不能な合成になる内容は書き込まれない — 原本不変。checkエラーは返すが途中状態の保存は許す)。書き込みはatomic。`.muro` のみ・entryのディレクトリ配下のみ (相対パスとsymlink実体で検査。合成に参加しないファイルの内容は検証されない) |
|
|
42
|
-
| `doors` | file, from, to | 最少扉数の経路、到達不能なら {unreachable} |
|
|
43
|
-
| `validate` | file | 建築的な判定 (`findings` は `rule`/`level`)。**checkの保証ではない** — 増える面である |
|
|
44
|
-
| `spaces` | file, [level] | 空間一覧 (パス・型・面積・半屋外・出所) |
|
|
45
|
-
| `light` | file | 居室ごとの採光判定 |
|
|
46
|
-
| `site` | file | 敷地レポート (面積照合 `areaMatch`・接道・建蔽率・容積率) |
|
|
47
|
-
| `new_uids` | file, [count] | 永続同一性トークン (uid) を作る — 合成済みのモデルとは衝突しない。**自分から付与するものは無い**ので、改名を跨いで指す必要が出たときにだけ呼ぶ |
|
|
48
|
-
| `plan_svg` | file, level | 平面SVG文字列 |
|
|
49
|
-
| `canonical_json` | file | 正準JSON |
|
|
50
|
-
|
|
51
|
-
エージェントの標準ループ: `model_summary` → `layers` → `write_layer` → (返ってきたcheckがエラーなら直す) → `doors`/`light`/`site` で帰結を確かめる。履歴はgitに任せる。
|
|
52
|
-
|
|
53
|
-
## 公開API (`@kensnzk/koyu`)
|
|
54
|
-
|
|
55
|
-
**ルートエントリはブラウザ安全** (node:fs を引かない)。fsを使う入口だけ `@kensnzk/koyu/node` に分離。動作環境は Node 22 以上 (`engines`)。
|
|
56
|
-
|
|
57
|
-
| 入口 | 中身 | 凍結 |
|
|
58
|
-
|---|---|---|
|
|
59
|
-
| `@kensnzk/koyu` | 下の一覧のすべて | core の部分が凍る (scope.md §8) |
|
|
60
|
-
| `@kensnzk/koyu/node` | `parseFile(path)` / `parseFileWith(path, overlay)` — fsから合成する二つだけ | 凍る |
|
|
61
|
-
| `@kensnzk/koyu/validate` | 建築的な判定 (validation.md) | **凍らない** — 増える面 |
|
|
62
|
-
| `@kensnzk/koyu/draw` | SVG生成 | **凍らない** — 呼び方は凍り、SVGの中身は凍らない |
|
|
63
|
-
| `@kensnzk/koyu/examples/*` | 同梱の建物 | — |
|
|
64
|
-
| `@kensnzk/koyu/spec/*` | この仕様書そのもの (配布物に同梱する) | — |
|
|
65
|
-
|
|
66
|
-
```ts
|
|
67
|
-
import { parse, check, doorsBetween, siteReport, svgPlan, toCanonical } from "@kensnzk/koyu";
|
|
68
|
-
import { parseFile } from "@kensnzk/koyu/node";
|
|
69
|
-
```
|
|
70
|
-
|
|
71
|
-
### 面の一覧
|
|
72
|
-
|
|
73
|
-
**この表と実装の export は集合として一致する** — 食い違えばテストが落ちる (ADR-0037)。`export *` は使わない。モジュールに export を足した瞬間に、誰も宣言していない約束が凍る面へ増えてしまうからである。**凍らせる面は、書き下されていなければならない。**
|
|
74
|
-
|
|
75
|
-
<!-- api-surface -->
|
|
76
|
-
|
|
77
|
-
| 面 | 値 | 型 |
|
|
78
|
-
|---|---|---|
|
|
79
|
-
| 解析と合成 | `parse` `parseFiles` `parseWith` `tokenize` | `LayerLoader` |
|
|
80
|
-
| モデルの語彙 | — | `Model` `Space` `Zone` `Boundary` `Opening` `Seg` `Area` `Asset` `Level` `Rect` `Pt` `GridAxis` `GridRef` `SitePolygon` `Column` `ColumnDecl` `DrawnLine` `Edge` `BoundaryKind` `Attrs` `AttrValue` |
|
|
81
|
-
| 問い・導出・機械形式 | `areaM2` `zoneAreaM2` `unionAreaM2` `polygonAreaM2` `pointInPolygon` `polyBounds` `rectToPoly` `columnsFor` `displayName` `effectiveUse` `heff` `isIndoor` `isSemiOutdoor` `isCoveredAbove` `levelsSorted` `newUids` `toCanonical` `srcRef` `SourceError` `SUPPORTED_LANGUAGE_VERSIONS` `DEFAULT_LANGUAGE_VERSION` | — |
|
|
82
|
-
| 構造整合の診断 | `check` `checkDiagnostics` `DIAGNOSTIC_CODES` | `Diagnostic` `DiagnosticCode` `CheckResult` |
|
|
83
|
-
| 空間グラフ | `doorsBetween` `neighbors` `passable` `segmentsFor` `envelopeGaps` `deriveDefaultBoundaries` `placeOpening` `placeBand` | `Segment` `Route` `NeighborInfo` `Band` `PlacedBand` `BandError` `BandCode` |
|
|
84
|
-
| 形の参照実装 | `derive` `levelPitch` `DERIVATION_CONSTANTS` `TOLERANCES` `thicken` `bandLine` `band` `columnRect` `runPrism` `canonicalBoundaryOrder` | `Form` `FormInput` `FormLevel` `FormSpace` `FormBoundary` `FormPanel` `FormOpening` `FormSwing` `FormSeg` `FormColumn` `FormRun` `FormSite` `FormPlan` `FormPrism` `PlanEntity` `PlanClass` `PlanSubject` `PlanRole` `DeriveOptions` |
|
|
85
|
-
| 床・天井・屋根 | `slabs` | `Slab` `SlabKind` |
|
|
86
|
-
| 採光 | `daylightInputs` | `DaylightInput` |
|
|
87
|
-
| 縦動線 | `verticalRuns` `runSolids` `runDrawsForLevel` `slopeText` | `VerticalRun` `RunPart` `RunSolid` `RunDraw` `RunArrow` `RunDevice` `RunForm` `Seg2` |
|
|
88
|
-
| 敷地 | `siteReport` | `SiteReport` `RoadFrontage` |
|
|
89
|
-
| 差分 | `semanticDiff` `renderDiff` | `ModelDiff` `FieldChange` `ChangedItem` `RenamedItem` `GridChange` `SpaceItem` `BoundaryItem` `BoundaryChange` `ColumnItem` |
|
|
90
|
-
| 生成 (凍らない) | `svgPlan` `svgAxo` | `PlanOptions` `AxoOptions` |
|
|
91
|
-
| 検証 (凍らない) | `validate` `VALIDATION_RULES` | `Finding` `ValidationRule` |
|
|
92
|
-
|
|
93
|
-
### 面の約束
|
|
94
|
-
|
|
95
|
-
- **合成の入口**: `parse(source)` (単一ソース — importはエラー) / `parseFiles(files, entry)` (仮想ファイル群 — キー空間の中でimport解決。ブラウザ向け) / `parseFile(path)` (fs) / `parseFileWith(path, overlay)` (fs+差し替え — 書き込み前の門番用) / `parseWith(loader, entry)` (独自ローダー)。合成に参加した全レイヤーは `model.layers` (合成順)。
|
|
96
|
-
- **検査と問い**: `checkDiagnostics(model)` → `Diagnostic[]` (一次形式 — code/severity/message/出所/path/related。台帳は `DIAGNOSTIC_CODES`、コード表は semantics.md §5。ADR-0016) / `check(model)` → {errors, warnings} (互換の文字列形式 — 同件・同順)。問いは `doorsBetween` / `daylightInputs` / `siteReport` / `zoneAreaM2` / `neighbors` / `passable` / `envelopeGaps` — **どれも合否を言わない** (scope.md §4)。
|
|
97
|
-
- **導出の部品**: `segmentsFor` / `deriveDefaultBoundaries` (既定境界 — parse系は適用済み。正準JSON由来のモデルに意味を与えるときに使う) / `placeOpening` / `placeBand` (この「帯」は境界線分上の区間 = 開口・seg のことで、記法のキーワード `band` 〈language.md §3〉とは別の層である) / `columnsFor` / `heff` / `isSemiOutdoor` / `isCoveredAbove` / `levelsSorted`。
|
|
98
|
-
- **形の唯一の入口**: `derive(model, {cut?})` → `Form` (ADR-0040)。**規則は [derivation.md](derivation.md) が持ち、これはその参照実装である。**`Form` は見た目を一つも持たない — 色も書体も線幅も注記文字列も記号も縮尺も返さない (scope.md §6)。定数の台帳は `DERIVATION_CONSTANTS`、許容値の台帳は `TOLERANCES` で、derivation.md §5・§6 の表はその写しである。`levelPitch(model, level)` は階高 (壁と柱がどこまで立つか) を単独で答える。
|
|
99
|
-
- **正準の境界順**: `canonicalBoundaryOrder(model)` — 宣言順は正準JSONが捨てる情報なので、**境界を順に読む導出はこの並びを使う** (ADR-0041)。`Form` の境界・開口・seg の添字 (`FormSeg.boundary` ほか) はこの並びの添字である。宣言順の配列を引くと、行を入れ替えただけで別の境界の注記を読む。
|
|
100
|
-
- **生成物** (Form が組み上げる部品。個別にも呼べる): `slabs(model)` (床・天井・屋根 — ADR-0024) / `verticalRuns(model)` (縦動線の形 — ADR-0021) / `runSolids(run)` (その立体) / `runDrawsForLevel(model, level)` (そのレベルで切った作図)。**どれも見た目を持たない** — 色も線幅も注記文字列も返さない。ビュアーはこれを幾何へ写すだけである (scope.md §6)。
|
|
101
|
-
- **描画**: `svgPlan(model, {level, scale?})` / `svgAxo(model, {dir?, levels?, scale?, ceilings?, walls?})` / `toCanonical(model)`。
|
|
102
|
-
- **差分**: `semanticDiff(a, b)` → `ModelDiff` (構成の言葉の差分 — 改名はuidで検出、境界は実効集合で比較。`toCanonical` 同一なら空。ADR-0018) / `renderDiff(d)` → 日本語の行 (空配列=差分なし)。
|
|
103
|
-
- **同一性**: `newUids(model, count?)` → 新しい uid の列 (ADR-0039)。**合成済みのそのモデルとは衝突しない**が、まだ合成されていない層との非衝突は 80 ビットの乱数による確率的な保証であり、証明するのは `check` の UID03 だけである ([scope.md §5](scope.md))。**呼ばないかぎり、どのツールも uid を書かない。**
|
|
104
|
-
- **エラー**: 構文・合成エラーは `SourceError` (line / raw / file — messageは `レイヤー:行目: 本文`)。checkは投げず配列で返す。
|
|
105
|
-
|
|
106
|
-
利用例はビューワー ugatsu (github.com/kensnzk/ugatsu) — 導出をすべてこのAPIの呼び出しで行い、自前の「答え」を持たない。
|
package/spec/validation.md
DELETED
|
@@ -1,79 +0,0 @@
|
|
|
1
|
-
[English](en/validation.md) · **日本語**
|
|
2
|
-
|
|
3
|
-
# 判定の台帳 — 検証の面
|
|
4
|
-
|
|
5
|
-
koyu v0.16.0 現在。**この面は凍らない** ([scope.md §8](scope.md#8-100-が凍結する八つの面))。
|
|
6
|
-
|
|
7
|
-
`koyu check` が言うのは「書かれたものがデータとして矛盾していない」までである ([scope.md §3](scope.md#3-保証の範囲--検査が通ったの意味))。建築として妥当かは、この面が言う。原因と直し方は [guide/validation.md](../guide/validation.md)。
|
|
8
|
-
|
|
9
|
-
## core との分け方
|
|
10
|
-
|
|
11
|
-
判定の出力が原本の保証と読まれないよう、**型からして別にしてある**。
|
|
12
|
-
|
|
13
|
-
| | core の診断 | 検証の判定 |
|
|
14
|
-
|---|---|---|
|
|
15
|
-
| 型 | `Diagnostic` | `Finding` |
|
|
16
|
-
| 識別子 | `code: "BND04"` | `rule: "daylight.ratio"` |
|
|
17
|
-
| 重さ | `severity: "error" \| "warning"` | `level: "violation" \| "caution"` |
|
|
18
|
-
| 入口 | `checkDiagnostics(model)` / `koyu check` | `validate(model)` / `koyu validate` |
|
|
19
|
-
| 版 | **凍る** | 凍らない — 増える・精度が上がる・捨てられる |
|
|
20
|
-
|
|
21
|
-
フィールド名が違うので二つの配列は取り違えようがなく、連結しようとすれば型が落ちる。**「core の緑」と「判定の緑」を同じ言葉で語れないようにすること**が、この分離の目的である。
|
|
22
|
-
|
|
23
|
-
`level` はコードの不変属性である — 同じ規則が場合によって `violation` になったり `caution` になったりはしない (core の severity と同じ規律)。重さを変えるときは新しい規則名を切る。
|
|
24
|
-
|
|
25
|
-
## 台帳
|
|
26
|
-
|
|
27
|
-
実装の `VALIDATION_RULES` (`src/validate/index.ts`) が正であり、本表はその写しである。テストが集合一致を守る。
|
|
28
|
-
|
|
29
|
-
| 規則 | level | 概要 |
|
|
30
|
-
|---|---|---|
|
|
31
|
-
| `envelope.gap` | caution | 外皮に穴 — 他の空間とも宣言された境界とも向かい合っていない外周がある ([ADR-0025](../docs/decisions/0025-envelope-gaps.md))。**外部への境界を一本でも書いたレベルだけ**を検査する (書き始めたなら閉じきる、という整合であって完全性の要求ではない) |
|
|
32
|
-
| `daylight.ratio` | violation | 有効窓面積 < 床面積/7。対象は `daylight:1` を書いた空間だけ ([ADR-0020](../docs/decisions/0020-daylight-scope-is-declared.md))。補正係数を掛けない粗い判定 |
|
|
33
|
-
| `daylight.unknown` | caution | `h` を持たない窓があり、窓面積を数え切れていない — 足りているのか数えていないのかを区別するための印 |
|
|
34
|
-
| `stair.proportion` | caution | 導出された段が窮屈 (踏面 <240mm、または 2×蹴上+踏面 が 550〜700mm の外)。折返しでは**最も窮屈な走り**が代表する |
|
|
35
|
-
| `run.slope` | caution | 導出された勾配が宣言 `slope:` より急、またはエスカレーターの常用域 (約1/1.7) から外れる |
|
|
36
|
-
| `run.disconnected` | caution | 縦動線の形はあるが上下を繋ぐ垂直境界が無い (形はあってもグラフでは通れない) |
|
|
37
|
-
| `access.unreachable` | violation | 領域を持つ室から、通れる境界を辿って外部空間へ出られない。**扉の有無ではなく到達性**を問う。シャフト (人が通れない)・吹抜け (床が無い)・外部は対象外 |
|
|
38
|
-
| `access.voidonly` | violation | 通れる境界を持つのに、その行き先が全部 `type:void` — 扉が床の無い穴に向かって開いている |
|
|
39
|
-
| `access.throughtenant` | caution | 階段室から外部へ出る経路が `use:rentable` の空間を必ず通る (テナントが施錠すると死ぬ避難路)。専用通路として通す設計もあるので caution |
|
|
40
|
-
| `access.parking` | violation | `use:parking` の空間から車が外部へ出られない。車が通れるのは `type:open` の境界・幅 2400mm 以上の扉・斜路 (`ramp:` を持つ空間の縦連結) だけ |
|
|
41
|
-
| `access.backofhouse` | caution | 縦動線の宣言を持つ共用空間へ、共用廊下から `type:backyard` を通らずに届かない。共用廊下が一つも無い建物では問わない。当の空間へは**水平に**入れることを要求する〈近似〉 |
|
|
42
|
-
| `column.blocksdoor` | violation | 導出された柱が導出された扉と重なる ([ADR-0023](../docs/decisions/0023-columns.md))。**どちらも原本には座標が無い**ので、衝突は導出でしか分からない |
|
|
43
|
-
| `site.escape` | violation | 建物が敷地形状からはみ出す。四隅の内包に加え頂点の入り込みと辺の交差を見るため凹敷地でも正しい。境界上は内側扱い・許容1mm。外部空間タイルは検査しない〈近似〉 |
|
|
44
|
-
| `site.area` | caution | 敷地面積の宣言 (`area:` 測量値) と多角形からの導出が ±0.05㎡ を超えて食い違う |
|
|
45
|
-
| `site.frontage` | violation | 接道長が 2000mm 未満 (法43条の粗い写し)。建物外壁が道路に面する分は数えない。**`site:1` のゾーンが無い模型では問わない** — 導かれる0は「接道が無い」ではなく「導けていない」である |
|
|
46
|
-
|
|
47
|
-
## 閾値
|
|
48
|
-
|
|
49
|
-
判定の閾値は**建築の側の数**であって、原本の構成が満たすべき不変量ではない。すべて実装の定数として一箇所にあり、管轄が二つ目を持ったときに章の下へ足す。
|
|
50
|
-
|
|
51
|
-
| 定数 | 値 | 出所 |
|
|
52
|
-
|---|---|---|
|
|
53
|
-
| `DAYLIGHT_DIVISOR` | 7 | `src/validate/light.ts` |
|
|
54
|
-
| `TREAD_MIN` | 240mm | `src/validate/runs.ts` |
|
|
55
|
-
| `STEP_RULE` | 550〜700mm | 同上 |
|
|
56
|
-
| `ESCALATOR_SLOPE` | 1/2.3 〜 1/1.4 | 同上 |
|
|
57
|
-
| `CAR_WIDTH_MIN` | 2400mm | `src/validate/access.ts` — 車が通れる開口の最小幅 (人の扉 900mm では車は出られない) |
|
|
58
|
-
| `FRONTAGE_MIN` | 2000mm | `src/validate/site.ts` |
|
|
59
|
-
| `COVERED_SEMI_FACTOR` | 0.7 | `src/core/light.ts` — これは**係数であって閾値ではない**ので core にある (窓の先が何かという導出) |
|
|
60
|
-
|
|
61
|
-
## 入口
|
|
62
|
-
|
|
63
|
-
```sh
|
|
64
|
-
koyu validate <file.muro> # 人向け。0=違反なし / 1=違反あり
|
|
65
|
-
koyu validate <file.muro> --json # Finding[]
|
|
66
|
-
```
|
|
67
|
-
|
|
68
|
-
```ts
|
|
69
|
-
import { validate, VALIDATION_RULES, type Finding } from "@kensnzk/koyu";
|
|
70
|
-
```
|
|
71
|
-
|
|
72
|
-
MCP では `validate` ツール。**すべての判定は MCP から呼べる** — 呼べない判定は、機械にとって存在しないに等しい。
|
|
73
|
-
|
|
74
|
-
## 増やすときの規律
|
|
75
|
-
|
|
76
|
-
判定を足すのは安い。面を一つ増やすだけで、言語の版は動かない。守るのは二つだけである。
|
|
77
|
-
|
|
78
|
-
1. **`VALIDATION_RULES` に載せ、本表と [guide/validation.md](../guide/validation.md) に節を書く。**テストが集合一致を守る
|
|
79
|
-
2. **core を触らない。**判定のために core へ属性や診断を足したくなったら、それは判定ではなく構造整合かもしれない — [scope.md §3](scope.md#3-保証の範囲--検査が通ったの意味) に照らして決める
|
package/spec/vocabulary.md
DELETED
|
@@ -1,114 +0,0 @@
|
|
|
1
|
-
[English](en/vocabulary.md) · **日本語**
|
|
2
|
-
|
|
3
|
-
# 語彙の台帳
|
|
4
|
-
|
|
5
|
-
原稿の方針「意味の与え方は、巨大なクラス階層ではなく語彙」を運用に落とした文書。要素ごとに何が付くか、どの語をツールが解釈するかの契約であり、開かれた語彙の「開き方」の規則である (ADR-0007 / ADR-0008)。
|
|
6
|
-
|
|
7
|
-
## 五つの規則
|
|
8
|
-
|
|
9
|
-
**1. kindは関係のトポロジーだけを言う。** boundaryのtype (wall/open/stair/shaft/void) はグラフ・導出・検査が構造として解釈する語で、増やすのは最後の手段。IFCが空間境界 (IfcRelSpaceBoundary) に Physical/Virtual しか言わせないのと同じ構えをとる。spaceのtypeで構造として解釈するのは `exterior` と `void` の二語だけである — どちらも構成の事実 (外部か・床面積に算入するか) に対応する。**判定の入口は型ではなく属性の側にあり、どの属性もツールの振る舞いを名指す** (`daylight` 採光判定・`road` 接道の幅員・`site` 敷地の集約・`use` 集計軸 — ADR-0020)。
|
|
10
|
-
|
|
11
|
-
**2. 物の名はspec語彙。** 手すり・RC・LGS・EW・ガラスパーティション… specの値は自由語で、ツールは解釈しない (運ぶだけ)。IFCで要素クラス (IfcRailing, IfcCurtainWall) にあたるものは、ここではspecの値である — 物は関係の属性、という転回の帰結。
|
|
12
|
-
|
|
13
|
-
**3. 解釈される属性は台帳に載せる。** ツールが読む属性 (下表の★) は契約であり、変えるときはADRを書く。それ以外の k:v は自由だが、同じ意味に別の語を使わないため、意味の定まった語はこの台帳に追記して育てる。台帳は一つ。
|
|
14
|
-
|
|
15
|
-
**4. 単位と形式。** 長さはmm、線分上の位置は0..1、面積の出力は㎡。属性キーは小文字英字、値は自由 (日本語可)、コアの値は英字。
|
|
16
|
-
|
|
17
|
-
**★の値は検査される。** 台帳に載せた属性の値が台帳の型に合わなければエラーである — 数値でなければ **ATT01**、決まった語彙 (`ceiling` 0/1・`turn` R/L・`site` 0/1・`style` hinged/sliding/auto) の外なら **ATT02** (`daylight` は DAY01、`form` は RUN05、縦動線の向きは RUN02 が既に守っている)。**書いたのに解釈されなかった値を、黙って既定へ落とさない** — `site:yes` は敷地の検査を、`h:35OO` は高さ不変量を、それぞれ丸ごと無音にする (ADR-0028)。
|
|
18
|
-
|
|
19
|
-
**5. 継承と上書き。** `use` は zone→space に継承され、spaceの宣言が勝つ。`floor` は space→area が区間上書き。`spec` は boundary→seg が区間上書き。数えない分節 (area/seg) は上書きだけを運び、構成に影響しない (ADR-0003)。
|
|
20
|
-
|
|
21
|
-
## 要素別の台帳
|
|
22
|
-
|
|
23
|
-
### space
|
|
24
|
-
| 属性 | 解釈 | 意味 |
|
|
25
|
-
|---|---|---|
|
|
26
|
-
| type | ★一部 | 開かれた語彙。構造として解釈するのは `exterior` (外部 — 複数に割れる: /out/road等) と `void` (吹抜け) の二語だけ。他は自由語で、採光判定の対象かどうかも型からは推定しない (ADR-0020) |
|
|
27
|
-
| road | ★ | exterior空間の幅員mm — 道路の印。siteコマンドが接道を導出する (ADR-0009) |
|
|
28
|
-
| 領域 | ★ | `X?..X? Y?..Y?` を `+` で合併 (L字)。オフセット `X2+600` 可 |
|
|
29
|
-
| level: | ★ | 所属レベルの明示。既定はパス先頭セグメント。階を跨ぐくくり (メゾネット) で使う |
|
|
30
|
-
| h | ★ | 天井高mm (既定はレベルのh)。高さ不変量とlevelsが読む |
|
|
31
|
-
| use | ★ | statsの集計軸 (rentable/exclusive/common…)。zoneから継承 |
|
|
32
|
-
| stair / ramp / escalator | ★ | **縦動線の宣言** (ADR-0021)。キーが装置 (=形の生成規則) を名指し、値が上る向き `N`/`E`/`S`/`W`。段数・踏面・踊り場・勾配は書かない — 領域と階高から導出される。一つの空間に一つだけ |
|
|
33
|
-
| lift | ★ | 昇降機の宣言。値は `1` (向きを持たない)。平面はかごの記号、立体はかごの箱になる |
|
|
34
|
-
| form | ★ | 縦動線の折返し `straight` (既定) / `return`。曲線は無い — 螺旋は折返しの連続として書く |
|
|
35
|
-
| turn | ★ | 折返しの向き `R` (既定・踊り場で右へ回る) / `L` |
|
|
36
|
-
| entry | ★ | 乗り込みの床の奥行mm (既定1100)。走りが領域の縁から始まらないための帯 — **踊り場ではなく階の床**で、扉はここに開く |
|
|
37
|
-
| landing | ★ | 折返しの中間踊り場の奥行mm。既定は導出 (目標踏面から残余として決まる)。書けば踏面が残余になる |
|
|
38
|
-
| riser / tread | ★ | 蹴上げの上限mm (既定180) / 目標踏面mm (既定300)。どちらも導出の入力であって結果ではない |
|
|
39
|
-
| lane | ★ | 一台/一車線の幅mm (エスカレーターの既定1200)。幅を割った台数が並び、**台ごとに走る向きが交互になる** (上りの隣は下り) |
|
|
40
|
-
| slope | ★ | 斜路の**許容勾配の分母** (`slope:6` = 1/6 まで)。書く勾配ではなく検査の上限 |
|
|
41
|
-
| ceiling | ★ | `0` で天井を張らない (現し天井 — ADR-0024)。既定は導出 (室の輪郭 × `h`)。天井が室の輪郭と一致しない場合 (折上げ・下がり天井・連続天井) は基本計画の解像度の外であり、作図された天井を受け取る余地は将来の値の拡張に残してある |
|
|
42
|
-
| daylight | ★ | **採光判定の対象の宣言** — `1` で `light` の 1/7 判定を掛ける、`0`・未指定で対象外 (ADR-0020)。値は0/1のみ。継承しない (室ごとに違うため)。属性は法概念 (法2条4号の居室) ではなくツールの振る舞いを名指す — 法28条1項の適用建築物と令19条3項の用途別割合は扱わないので、1/7を掛ける先は書き手が決める |
|
|
43
|
-
| uid | ★ | 任意の永続同一性トークン (ADR-0015)。不透明・モデル全体 (space/zone横断) で一意・パスから導出しない。数字だけの形と空白はエラー。renameを跨ぐ外部join (センサー・台帳) 用 — リポジトリ内の参照は従来どおりパス。**書けるのは space と zone だけで、この一覧は閉じている** (他の要素では ATT03)。機械に作らせるなら `newUids` / MCP の `new_uids` (ADR-0039) |
|
|
44
|
-
| w | ★ (帯の要素のみ) | 帯の向きの寸法mm。`w:rest` は残りを吸収する印 (帯に高々一つ)。帯の外の `space` には書けない |
|
|
45
|
-
| name / floor / … | — | 自由。floorはareaが上書きできる |
|
|
46
|
-
|
|
47
|
-
### boundary
|
|
48
|
-
| 属性 | 解釈 | 意味 |
|
|
49
|
-
|---|---|---|
|
|
50
|
-
| type | ★ | wall / open (水平) / stair / shaft / void (垂直)。既定 wall。**縦の通行可能性は `stair` の一語が引き受ける** — 斜路もエスカレーターもトポロジーは同じなので型は増やさない (ADR-0021) |
|
|
51
|
-
| t | ★ | 壁厚mm (芯振り分け)。描画と既定値100 |
|
|
52
|
-
| air | ★ | 1=遮蔽しない物 (手すり・柵)。半屋外の導出・細線描画・light 0.7 に効く |
|
|
53
|
-
| edge | ★ | 線分をa側矩形の特定の辺に限定 (N/E/S/W) |
|
|
54
|
-
| h | ★ | `air:1` の境界の天端高mm (手すり・腰壁。既定1100)。軸測図が読む — 値が正の数値でなければ ATT01 (ADR-0028) |
|
|
55
|
-
| spec / fire / sound / … | — | 自由 (specは物の名。fire/soundはM2の区画クエリで解釈予定) |
|
|
56
|
-
|
|
57
|
-
### opening (boundaryの字下げ)
|
|
58
|
-
| 属性 | 解釈 | 意味 |
|
|
59
|
-
|---|---|---|
|
|
60
|
-
| kind | ★ | door (通行) / window (採光。通行しない) |
|
|
61
|
-
| (先頭トークン) | ★ | 建具アセットの参照 (`door SD1 …` — Reference)。アセットの属性が既定になり、インスタンスが上書きする (ADR-0010) |
|
|
62
|
-
| w / h | ★ | 幅・高さmm。windowのhはlightが読む |
|
|
63
|
-
| at | ★ | 位置。比率0..1 (既定0.5、線分内にクランプ) または通り芯参照 `at:X2+450` (絶対 — クランプせず、はみ出し・軸違い・開口同士の重なりはエラー) |
|
|
64
|
-
| edge | ★ | 複数線分の辺選択 |
|
|
65
|
-
| hinge | ★ | 開き勝手: 吊元 (水平線分はW/E、垂直線分はN/S。既定は始端側) |
|
|
66
|
-
| swing | ★ | 開き勝手: 開く側 (a/b。既定はa=領域を持つ側) |
|
|
67
|
-
| style | ★ | 建具の型: hinged (開き戸・既定) / sliding (引き戸) / auto (自動ドア)。平面の建具表現が変わる |
|
|
68
|
-
| sill / name / … | — | 自由 |
|
|
69
|
-
|
|
70
|
-
### asset (建具アセット — ADR-0010)
|
|
71
|
-
`asset 名 door|window 属性…` — 参照される既定値の束 (RevitのFamily、USDのReference)。第4の要素ではなく、開口の属性の出所を一箇所にするだけ。kindは参照する開口と一致していなければならない。名前の重複は合成時もエラー。
|
|
72
|
-
|
|
73
|
-
### band (帯 — ADR-0019)
|
|
74
|
-
`band <軸> <X?..X?> <Y?..Y?>` + 字下げした `space` 行。位置ではなく寸法と並びを書く記法で、垂直の矩計の水平版である。
|
|
75
|
-
|
|
76
|
-
| 位置引数 | 解釈 | 意味 |
|
|
77
|
-
|---|---|---|
|
|
78
|
-
| 軸 | ★ | 割る向き `X` (西→東) / `Y` (南→北)。第1位置引数 |
|
|
79
|
-
| 領域 | ★ | `X?..X? Y?..Y?` の2つ。昇順必須 (並びが意味を持つため)。`+` の合併は不可 |
|
|
80
|
-
|
|
81
|
-
`key:value` は書けない — 帯はモデルに残らないので属性の運び先が無い (属性は要素の `space` 行に書く)。帯は parse 時に通常の空間へ展開され、正準JSONにも残らない。
|
|
82
|
-
|
|
83
|
-
### line (描かれた線 — ADR-0022)
|
|
84
|
-
`line <始点> <終点>` を boundary の直下に字下げして書く。端点は通り語の対 `X3,Y1` / `X3+600,Y2-900` で、**生の座標も角度も書けない**。境界の実現を、隣接からの導出ではなく設計の行為として与える (★)。二空間の割付の合併を線の両側へ分け直すので、一方が失う面積をもう一方が得る。片側が領域を持たない外部なら外皮を切る線になり、切られた側は面積を失うだけである。一つの境界に線は一本。斜めの線分の上では開口の `at:` は 0..1 の比率でしか書けない (通り参照は位置を一意に定めない)。
|
|
85
|
-
|
|
86
|
-
### column (柱 — ADR-0023)
|
|
87
|
-
`column <一辺mm> <レベル範囲|レベル名> [属性...]` — **位置は書かない**。通り芯の交点のうち、そのレベルに床のある (exterior でも void でもない領域つき空間の内側にある) 所に立つ (★)。ただし半屋外で上に床の無い空間 (露天のテラス・屋上庭園) は柱の敷地にならない (ADR-0030)。
|
|
88
|
-
|
|
89
|
-
| 属性 | 解釈 | 意味 |
|
|
90
|
-
|---|---|---|
|
|
91
|
-
| d | ★ | 矩形断面の奥行mm (既定は一辺と同じ = 角柱) |
|
|
92
|
-
| x / y | ★ | 立てる通りの限定 (カンマ区切り。未指定は全通り) |
|
|
93
|
-
| spec / … | — | 自由 |
|
|
94
|
-
|
|
95
|
-
同じ交点に二本は立たない (先の宣言が勝つ)。柱は空間でも境界でもないので、面積にもグラフにも現れない。
|
|
96
|
-
|
|
97
|
-
### polygon (敷地形状 — ADR-0011)
|
|
98
|
-
`polygon /ゾーンパス x,y x,y x,y ...` — 所与のジオメトリ (測量由来)。この記法で唯一「書かれる形」で、site:1のゾーンに対応する (無ければ警告)。導出面積 (シューレース)・建物のはみ出し検査・配置図の敷地境界線をツールが解釈する (★)。別ファイル+importの隔離レイヤー運用を標準とする。
|
|
99
|
-
|
|
100
|
-
### import (合成 — ADR-0010)
|
|
101
|
-
`import ./L1.muro` — 書かれたファイルからの相対パス。base層が基盤 (koyu/name/unit/grid/level) を一度だけ宣言し、層は空間・境界・ゾーン・アセットを加算する。衝突 (空間パス・アセット名の重複、grid/nameの再宣言) は出所つきのビルドエラー。同一ファイルの二重importは冪等。
|
|
102
|
-
|
|
103
|
-
### level
|
|
104
|
-
`z` (位置引数)、`h` (基準天井高)、`slab` (床組み厚)、`pitch` (範囲宣言のみ)、`underground` (1=地下) — すべて★。`slab` は床を、`h` は天井を**既に宣言している** — 面の要素 (床・天井・屋根) はこの二つから導出され、専用の語彙を持たない (ADR-0024)。屋根は「上に空間が重なっていない範囲」に架かるので、基壇の上に塔屋が載れば基壇屋上が書かずに現れる。`underground` は宣言であって推定ではない (ADR-0022) — 地盤面は敷地の事実であり、zの負値は座標系の原点の事実にすぎない。土に接する壁は境界の型でも属性でもなく **spec 語彙** が運ぶ (`spec:RC土圧壁` — 規則2)。
|
|
105
|
-
|
|
106
|
-
### zone
|
|
107
|
-
`name` (自由)、`use` (★継承元)、`site` (★ 1=敷地の集約 — siteコマンドの対象)、`area` (★ 敷地の宣言面積㎡ — 導出面積と照合される)、`uid` (★ 永続同一性トークン — spaceと同じ規則で一意)。幾何を持たない。
|
|
108
|
-
|
|
109
|
-
### area / seg (数えない分節)
|
|
110
|
-
位置 (areaは領域、segはat/w/edge — ★。segのatも通り芯参照可) + 任意の上書き属性 (—)。
|
|
111
|
-
|
|
112
|
-
## IFCとの対応 (参考)
|
|
113
|
-
|
|
114
|
-
縦動線 (stair:/ramp:/escalator:/lift:) ↔ IfcStair / IfcRamp / IfcTransportElement (段割りや傾きは IFC では形状として持つが、koyu では宣言から導出される)。column ↔ IfcColumn (位置は IfcLocalPlacement が持つが、koyu では通り芯の交点から導出される)。boundary wall/open ↔ IfcRelSpaceBoundary の PHYSICAL/VIRTUAL。内外の別 ↔ InternalOrExternalBoundary (こちらは宣言でなく導出)。spec:手すり ↔ IfcRailing (要素クラスは語彙の値になる)。opening ↔ IfcOpeningElement + IfcDoor/IfcWindow。asset ↔ IfcDoorType/IfcWindowType (タイプとオカレンス — RevitのFamily)、style ↔ IfcDoorTypeOperationEnum の粗い射影 (SINGLE_SWING/SLIDING…)。zone ↔ IfcZone。stair/shaft/void の垂直境界と slab の既定は、空間一次ゆえにIFCに直接の相当物を持たない。importの合成はIFC4に相当物がなく (単一ファイルが原則)、IFCX/USDのレイヤー合成に対応する。
|