@kensnzk/koyu 0.16.0 → 0.18.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/analysis/contracts.d.ts +217 -0
- package/dist/analysis/contracts.d.ts.map +1 -0
- package/dist/analysis/contracts.js +27 -0
- package/dist/analysis/contracts.js.map +1 -0
- package/dist/analysis/index.d.ts +5 -0
- package/dist/analysis/index.d.ts.map +1 -0
- package/dist/analysis/index.js +17 -0
- package/dist/analysis/index.js.map +1 -0
- package/dist/analysis/json.d.ts +21 -0
- package/dist/analysis/json.d.ts.map +1 -0
- package/dist/analysis/json.js +111 -0
- package/dist/analysis/json.js.map +1 -0
- package/dist/cli.js +106 -35
- 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 +9 -0
- package/dist/core/site.d.ts.map +1 -1
- package/dist/core/site.js +8 -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/diagnostics.d.ts +2 -0
- package/dist/diagnostics.d.ts.map +1 -0
- package/dist/diagnostics.js +3 -0
- package/dist/diagnostics.js.map +1 -0
- package/dist/diff.d.ts +2 -0
- package/dist/diff.d.ts.map +1 -0
- package/dist/diff.js +3 -0
- package/dist/diff.js.map +1 -0
- 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/form.d.ts +5 -0
- package/dist/form.d.ts.map +1 -0
- package/dist/form.js +4 -0
- package/dist/form.js.map +1 -0
- package/dist/graph.d.ts +2 -0
- package/dist/graph.d.ts.map +1 -0
- package/dist/graph.js +3 -0
- package/dist/graph.js.map +1 -0
- package/dist/index.d.ts +2 -14
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +36 -45
- package/dist/index.js.map +1 -1
- package/dist/mcp.js +81 -30
- package/dist/mcp.js.map +1 -1
- package/dist/model.d.ts +3 -0
- package/dist/model.d.ts.map +1 -0
- package/dist/model.js +3 -0
- package/dist/model.js.map +1 -0
- 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/assessment.d.ts +8 -0
- package/dist/validate/assessment.d.ts.map +1 -0
- package/dist/validate/assessment.js +1738 -0
- package/dist/validate/assessment.js.map +1 -0
- package/dist/validate/builtin/access.d.ts +55 -0
- package/dist/validate/builtin/access.d.ts.map +1 -0
- package/dist/validate/builtin/access.js +494 -0
- package/dist/validate/builtin/access.js.map +1 -0
- package/dist/validate/builtin/daylight.d.ts +44 -0
- package/dist/validate/builtin/daylight.d.ts.map +1 -0
- package/dist/validate/builtin/daylight.js +233 -0
- package/dist/validate/builtin/daylight.js.map +1 -0
- package/dist/validate/builtin/door-column-collisions.d.ts +47 -0
- package/dist/validate/builtin/door-column-collisions.d.ts.map +1 -0
- package/dist/validate/builtin/door-column-collisions.js +189 -0
- package/dist/validate/builtin/door-column-collisions.js.map +1 -0
- package/dist/validate/builtin/envelope.d.ts +30 -0
- package/dist/validate/builtin/envelope.d.ts.map +1 -0
- package/dist/validate/builtin/envelope.js +169 -0
- package/dist/validate/builtin/envelope.js.map +1 -0
- package/dist/validate/builtin/freeze.d.ts +3 -0
- package/dist/validate/builtin/freeze.d.ts.map +1 -0
- package/dist/validate/builtin/freeze.js +21 -0
- package/dist/validate/builtin/freeze.js.map +1 -0
- package/dist/validate/builtin/index.d.ts +38 -0
- package/dist/validate/builtin/index.d.ts.map +1 -0
- package/dist/validate/builtin/index.js +106 -0
- package/dist/validate/builtin/index.js.map +1 -0
- package/dist/validate/builtin/site.d.ts +62 -0
- package/dist/validate/builtin/site.d.ts.map +1 -0
- package/dist/validate/builtin/site.js +333 -0
- package/dist/validate/builtin/site.js.map +1 -0
- package/dist/validate/builtin/vertical-runs.d.ts +53 -0
- package/dist/validate/builtin/vertical-runs.d.ts.map +1 -0
- package/dist/validate/builtin/vertical-runs.js +290 -0
- package/dist/validate/builtin/vertical-runs.js.map +1 -0
- package/dist/validate/contracts.d.ts +188 -0
- package/dist/validate/contracts.d.ts.map +1 -0
- package/dist/validate/contracts.js +28 -0
- package/dist/validate/contracts.js.map +1 -0
- package/dist/validate/index.d.ts +2 -59
- package/dist/validate/index.d.ts.map +1 -1
- package/dist/validate/index.js +22 -70
- package/dist/validate/index.js.map +1 -1
- package/dist/vocabulary.d.ts +2 -0
- package/dist/vocabulary.d.ts.map +1 -0
- package/dist/vocabulary.js +3 -0
- package/dist/vocabulary.js.map +1 -0
- 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 +41 -9
- package/src/analysis/contracts.ts +234 -0
- package/src/analysis/index.ts +61 -0
- package/src/analysis/json.ts +117 -0
- package/src/cli.ts +116 -36
- 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 +19 -2
- package/src/core/tolerance.ts +2 -2
- package/src/core/vertical.ts +10 -3
- package/src/core/vocabulary.ts +18 -5
- package/src/diagnostics.ts +8 -0
- package/src/diff.ts +14 -0
- package/src/draw/index.ts +1 -1
- package/src/draw/plan.ts +5 -5
- package/src/form.ts +37 -0
- package/src/graph.ts +12 -0
- package/src/index.ts +40 -175
- package/src/mcp.ts +85 -35
- package/src/model.ts +43 -0
- package/src/parse-file.ts +17 -3
- package/src/validate/assessment.ts +1934 -0
- package/src/validate/builtin/access.ts +642 -0
- package/src/validate/builtin/daylight.ts +321 -0
- package/src/validate/builtin/door-column-collisions.ts +266 -0
- package/src/validate/builtin/envelope.ts +227 -0
- package/src/validate/builtin/freeze.ts +19 -0
- package/src/validate/builtin/index.ts +156 -0
- package/src/validate/builtin/site.ts +445 -0
- package/src/validate/builtin/vertical-runs.ts +390 -0
- package/src/validate/contracts.ts +240 -0
- package/src/validate/index.ts +45 -99
- package/src/vocabulary.ts +9 -0
- package/dist/validate/access.d.ts +0 -6
- package/dist/validate/access.d.ts.map +0 -1
- package/dist/validate/access.js +0 -238
- package/dist/validate/access.js.map +0 -1
- package/dist/validate/envelope.d.ts +0 -4
- package/dist/validate/envelope.d.ts.map +0 -1
- package/dist/validate/envelope.js +0 -55
- package/dist/validate/envelope.js.map +0 -1
- package/dist/validate/light.d.ts +0 -6
- package/dist/validate/light.d.ts.map +0 -1
- package/dist/validate/light.js +0 -28
- package/dist/validate/light.js.map +0 -1
- package/dist/validate/runs.d.ts +0 -16
- package/dist/validate/runs.d.ts.map +0 -1
- package/dist/validate/runs.js +0 -60
- package/dist/validate/runs.js.map +0 -1
- package/dist/validate/site.d.ts +0 -6
- package/dist/validate/site.d.ts.map +0 -1
- package/dist/validate/site.js +0 -63
- package/dist/validate/site.js.map +0 -1
- 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/src/validate/access.ts +0 -279
- package/src/validate/envelope.ts +0 -59
- package/src/validate/light.ts +0 -43
- package/src/validate/runs.ts +0 -87
- package/src/validate/site.ts +0 -84
package/dist/validate/runs.js
DELETED
|
@@ -1,60 +0,0 @@
|
|
|
1
|
-
// 検証 — 縦動線の建築的な妥当性 (ADR-0021)
|
|
2
|
-
//
|
|
3
|
-
// core が保証するのは「宣言から**形が一意に決まる**」までである (RUN01〜RUN05)。
|
|
4
|
-
// 決まった形が**登りやすいか**は建築の側の判断で、ここが引き受ける。
|
|
5
|
-
//
|
|
6
|
-
// 段数も踏面も勾配も原本には書かれない — 領域と階高から導出される。
|
|
7
|
-
// だから検査の対象は「書かれた値」ではなく「導出された値」である。
|
|
8
|
-
// 閾値 (踏面240mm・2R+T の 550〜700・エスカレーターの常用域) は日本の慣行の粗い写しで、
|
|
9
|
-
// 管轄が二つ目を持ったときに章の下へ足す。凍らないので、その時に足せばよい。
|
|
10
|
-
import { slopeText, verticalRuns } from "../core/vertical.js";
|
|
11
|
-
import { finding } from "./index.js";
|
|
12
|
-
/** 踏面の下限 mm — 令23条の一般的な下限に倣う粗い値 */
|
|
13
|
-
export const TREAD_MIN = 240;
|
|
14
|
-
/** 2×蹴上 + 踏面 の目安 mm (歩幅則) */
|
|
15
|
-
export const STEP_RULE = { lo: 550, hi: 700 };
|
|
16
|
-
/** エスカレーターの常用勾配 (約1/1.7 = 30度) の許容幅 */
|
|
17
|
-
export const ESCALATOR_SLOPE = { lo: 1 / 2.3, hi: 1 / 1.4 };
|
|
18
|
-
export function runFindings(model) {
|
|
19
|
-
const out = [];
|
|
20
|
-
// 上下を繋ぐ垂直境界を持つ空間 — 形があってもここに無ければグラフでは通れない
|
|
21
|
-
const stairLinked = new Set();
|
|
22
|
-
for (const b of model.boundaries) {
|
|
23
|
-
if (b.kind === "stair" || b.kind === "shaft") {
|
|
24
|
-
stairLinked.add(b.a);
|
|
25
|
-
stairLinked.add(b.b);
|
|
26
|
-
}
|
|
27
|
-
}
|
|
28
|
-
for (const run of verticalRuns(model)) {
|
|
29
|
-
const s = model.spaces.get(run.path);
|
|
30
|
-
if (!s)
|
|
31
|
-
continue;
|
|
32
|
-
const at = { line: s.line, file: s.file, path: [s.path] };
|
|
33
|
-
if (run.device === "lift")
|
|
34
|
-
continue;
|
|
35
|
-
if (!stairLinked.has(run.path)) {
|
|
36
|
-
out.push(finding("run.disconnected", `${run.path} has a vertical-circulation form but no vertical boundary connecting the levels (write stack or boundary type:stair — the form exists, but the graph cannot pass)`, at));
|
|
37
|
-
}
|
|
38
|
-
if (run.device === "stair") {
|
|
39
|
-
const t = Math.round(run.tread);
|
|
40
|
-
const r = Math.round(run.riser);
|
|
41
|
-
const rule = 2 * r + t;
|
|
42
|
-
if (t < TREAD_MIN || rule < STEP_RULE.lo || rule > STEP_RULE.hi) {
|
|
43
|
-
out.push(finding("stair.proportion", `Derived step dimensions are cramped: ${run.risers} risers of ${r}mm, tread ${t}mm (2*riser+tread = ${Math.round(rule)}mm; expected ${STEP_RULE.lo}-${STEP_RULE.hi}mm)`, at));
|
|
44
|
-
}
|
|
45
|
-
}
|
|
46
|
-
else if (run.device === "ramp") {
|
|
47
|
-
const declared = s.attrs["slope"];
|
|
48
|
-
if (typeof declared === "number" && declared > 0 && run.slope > 1 / declared + 1e-9) {
|
|
49
|
-
out.push(finding("run.slope", `Derived slope ${slopeText(run.slope)} is steeper than the declared 1/${declared} (lengthen the run or lower the storey height)`, at));
|
|
50
|
-
}
|
|
51
|
-
}
|
|
52
|
-
else if (run.device === "escalator") {
|
|
53
|
-
if (run.slope < ESCALATOR_SLOPE.lo || run.slope > ESCALATOR_SLOPE.hi) {
|
|
54
|
-
out.push(finding("run.slope", `Derived slope ${slopeText(run.slope)} is outside the usual escalator range (about 1/1.7 = 30 degrees)`, at));
|
|
55
|
-
}
|
|
56
|
-
}
|
|
57
|
-
}
|
|
58
|
-
return out;
|
|
59
|
-
}
|
|
60
|
-
//# sourceMappingURL=runs.js.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"runs.js","sourceRoot":"","sources":["../../src/validate/runs.ts"],"names":[],"mappings":"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"}
|
package/dist/validate/site.d.ts
DELETED
|
@@ -1,6 +0,0 @@
|
|
|
1
|
-
import { type Model } from "../core/model.js";
|
|
2
|
-
import { type Finding } from "./index.js";
|
|
3
|
-
/** 接道長の下限 mm — 法43条 (接道義務) の粗い写し */
|
|
4
|
-
export declare const FRONTAGE_MIN = 2000;
|
|
5
|
-
export declare function siteFindings(model: Model): Finding[];
|
|
6
|
-
//# sourceMappingURL=site.d.ts.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"site.d.ts","sourceRoot":"","sources":["../../src/validate/site.ts"],"names":[],"mappings":"AAYA,OAAO,EAAgD,KAAK,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAE5F,OAAO,EAAW,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AAMnD,oCAAoC;AACpC,eAAO,MAAM,YAAY,OAAO,CAAC;AAEjC,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,EAAE,CA4DpD"}
|
package/dist/validate/site.js
DELETED
|
@@ -1,63 +0,0 @@
|
|
|
1
|
-
// 検証 — 敷地に対する建物の判断 (ADR-0009 / ADR-0011)
|
|
2
|
-
//
|
|
3
|
-
// 敷地形状そのものの健全性 (重複頂点・自己交差・対応ゾーンの不在) は **core に残る** —
|
|
4
|
-
// 与件が壊れていれば形が作れないので、あれは読解の一部である。
|
|
5
|
-
//
|
|
6
|
-
// ここが持つのは建物と敷地の**関係についての判断**の二つだけ:
|
|
7
|
-
// - 建物が敷地からはみ出していないか (形は一意に出る。出た形が法に触れるかは別の話)
|
|
8
|
-
// - 測量値として書かれた面積と、多角形から導出される面積が食い違わないか
|
|
9
|
-
//
|
|
10
|
-
// 建蔽率・容積率は**数**なので core の siteReport が返す。上限と較べるのは、
|
|
11
|
-
// 用途地域という原本の外の事実を要するので、ここでも持たない — 持てるようになったら足す。
|
|
12
|
-
import { polygonAreaM2, regionOf, shapeEscapesPolygon } from "../core/model.js";
|
|
13
|
-
import { siteReport } from "../core/site.js";
|
|
14
|
-
import { finding } from "./index.js";
|
|
15
|
-
/** 敷地の許容 mm — 境界上は内側扱い */
|
|
16
|
-
const EPS_SITE = 1;
|
|
17
|
-
/** 面積照合の許容 ㎡ */
|
|
18
|
-
const AREA_TOLERANCE = 0.05;
|
|
19
|
-
/** 接道長の下限 mm — 法43条 (接道義務) の粗い写し */
|
|
20
|
-
export const FRONTAGE_MIN = 2000;
|
|
21
|
-
export function siteFindings(model) {
|
|
22
|
-
const out = [];
|
|
23
|
-
const withRect = [...model.spaces.values()].filter((s) => s.rects.length > 0);
|
|
24
|
-
// 接道 — core が返すのは接道長という数だけで、2m という下限は建築の側の規則である。
|
|
25
|
-
//
|
|
26
|
-
// **敷地が宣言されていなければ問わない。**接道長は「敷地と道路が共有する境界の長さ」なので、
|
|
27
|
-
// site:1 のゾーンが無い模型では 0 が導かれるが、それは「接道が無い」ではなく
|
|
28
|
-
// 「導けていない」である。地下の断面だけを書いた例のように、道路は書くが敷地は書かない
|
|
29
|
-
// 模型は現にある — 導けていない数に線を引くと、書いていないことが違反になる。
|
|
30
|
-
const report = siteReport(model);
|
|
31
|
-
for (const road of report.siteZone ? report.roads : []) {
|
|
32
|
-
if (road.frontage >= FRONTAGE_MIN)
|
|
33
|
-
continue;
|
|
34
|
-
out.push(finding("site.frontage", `Road frontage is too short: ${road.road.path} — ${road.frontage}mm (needs at least ${FRONTAGE_MIN}mm)`, { line: road.road.line, file: road.road.file, path: [road.road.path] }));
|
|
35
|
-
}
|
|
36
|
-
for (const poly of model.polygons.values()) {
|
|
37
|
-
const zone = model.zones.get(poly.path);
|
|
38
|
-
// 形の健全性と対応ゾーンの不在は core が既に言っている — ここでは黙って飛ばす
|
|
39
|
-
if (!zone || zone.attrs["site"] !== 1)
|
|
40
|
-
continue;
|
|
41
|
-
const declared = zone.attrs["area"];
|
|
42
|
-
if (typeof declared === "number") {
|
|
43
|
-
const derived = polygonAreaM2(poly.points);
|
|
44
|
-
if (Math.abs(declared - derived) >= AREA_TOLERANCE) {
|
|
45
|
-
out.push(finding("site.area", `Declared and derived site areas disagree: declared ${declared} m2 / derived ${derived.toFixed(2)} m2`, { line: zone.line, file: zone.file, path: [zone.path] }));
|
|
46
|
-
}
|
|
47
|
-
}
|
|
48
|
-
for (const s of withRect) {
|
|
49
|
-
if (s.type === "exterior" || s.path.startsWith(poly.path + "/"))
|
|
50
|
-
continue;
|
|
51
|
-
// 照合するのは割付ではなく**導出された領域** — 敷地なりに切った外形はここで通る
|
|
52
|
-
for (const r of regionOf(s)) {
|
|
53
|
-
const esc = shapeEscapesPolygon(r, poly.points, EPS_SITE);
|
|
54
|
-
if (esc) {
|
|
55
|
-
out.push(finding("site.escape", `${s.path} escapes the site shape (near ${Math.round(esc.x)},${Math.round(esc.y)})`, { line: s.line, file: s.file, path: [s.path] }));
|
|
56
|
-
break;
|
|
57
|
-
}
|
|
58
|
-
}
|
|
59
|
-
}
|
|
60
|
-
}
|
|
61
|
-
return out;
|
|
62
|
-
}
|
|
63
|
-
//# sourceMappingURL=site.js.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"site.js","sourceRoot":"","sources":["../../src/validate/site.ts"],"names":[],"mappings":"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"}
|
package/spec/README.md
DELETED
|
@@ -1,28 +0,0 @@
|
|
|
1
|
-
[English](en/README.md) · **日本語**
|
|
2
|
-
|
|
3
|
-
# spec/ — koyuの仕様 (現在形)
|
|
4
|
-
|
|
5
|
-
> **これはリファレンスである。koyuをこれから学ぶなら [guide/start.md](../guide/start.md) から始めること。**引くための文書であって、通して読んで身につく作りにはしていない。
|
|
6
|
-
|
|
7
|
-
このフォルダは**いまのkoyuがどう振る舞うか**の規範文書 (normative reference) である。経緯や理由は書かない — それは [docs/decisions/](../docs/decisions/) (ADR) と [docs/log/](../docs/log/) の仕事で、specは決定が積もった後の**結論の現在形**だけを保つ。両者が食い違ったら、実装とテストが正であり、specを直す。
|
|
8
|
-
|
|
9
|
-
## 文書の地図
|
|
10
|
-
|
|
11
|
-
| 文書 | 内容 | 読者 |
|
|
12
|
-
|---|---|---|
|
|
13
|
-
| [language.md](language.md) | **言語リファレンス** — 字句・全宣言の文法・合成 (import)・既定値・位置指定 | .muroを書く人・パーサを触る人 |
|
|
14
|
-
| [semantics.md](semantics.md) | **意味論リファレンス** — モデル・導出 (壁線分/垂直隣接/半屋外/高さ)・検査の一覧・問い (doors/stats/light/site) の定義 | 導出やcheckを触る人・結果を解釈する人 |
|
|
15
|
-
| [derivation.md](derivation.md) | **導出の規範** — 書かれた構成から一意な形へ。領域・境界・実体・縦動線・導出の定数・許容値、そして形と見た目の線引き | 形を作る消費者・ビュアーを書く人 |
|
|
16
|
-
| [vocabulary.md](vocabulary.md) | **語彙の台帳** — 属性の契約 (どの語をツールが解釈するか)・開かれた語彙の開き方の規則 | 属性を足す人・全員 |
|
|
17
|
-
| [canonical-json.md](canonical-json.md) | **機械形式** — 正準JSONのスキーマと安定性の規則 | 外部接続・diff・合成を作る人 |
|
|
18
|
-
| [tools.md](tools.md) | **ツールリファレンス** — CLI・MCPサーバー・公開API | koyuを使うプログラム・エージェント |
|
|
19
|
-
| [notation-v0.md](notation-v0.md) | 記法の**成立記録** — v0の書き比べ (DSL/YAML/JSON) と各版の追補。歴史文書であり現在形はlanguage.mdが正 | 経緯を知りたい人 |
|
|
20
|
-
| [../guide/](../guide/README.md) | **学ぶための対の本** — チュートリアル・六つの考え・how-to・診断の原因と直し方・実例集。規範は持たず、ここへリンクする | koyuを学ぶ人・使い方から引きたい人 |
|
|
21
|
-
|
|
22
|
-
## 更新の作法
|
|
23
|
-
|
|
24
|
-
機能の変更は三点セットで着地する: **ADR (なぜ) + テスト (保証) + spec (現在形)**。ADRを書いてspecを更新しない変更は未完了である。specには日付や「追補」を積まない — 本文をその場で書き換え、版はgitが持つ。語彙 (解釈される属性) の追加は vocabulary.md の表に載せることが契約であり、載っていない解釈は実装してはならない (ADR-0008)。
|
|
25
|
-
|
|
26
|
-
## 対象の版
|
|
27
|
-
|
|
28
|
-
この文書群は koyu v0.16.0 の記述である。パッケージの版と乖離したら、乖離した箇所を直す。
|
package/spec/canonical-json.md
DELETED
|
@@ -1,98 +0,0 @@
|
|
|
1
|
-
[English](en/canonical-json.md) · **日本語**
|
|
2
|
-
|
|
3
|
-
# 機械形式リファレンス — 正準JSON
|
|
4
|
-
|
|
5
|
-
koyu v0.16.0 現在。`koyu json <entry>` / `toCanonical(model)` が出力する。
|
|
6
|
-
|
|
7
|
-
**これは何のためにあるか。****「同じ建物とは何か」の定義を書き下したもの**である。
|
|
8
|
-
原本 (.muro) は行順も綴りも自由なので、二つのファイルが同じ建物かどうかはテキストでは決まらない。
|
|
9
|
-
正準形はその問いに一意な答えを与える — 同じ構成なら常に同じバイト列、違う構成なら必ず違うバイト列。
|
|
10
|
-
|
|
11
|
-
だから使い道は二つに絞られる。**意味差分 (`koyu diff`) が正しいことを確かめる物差し**
|
|
12
|
-
(diff 自身に聞いても意味が無いので、独立した判定が要る — テストがこれで書かれている) と、
|
|
13
|
-
**`.muro` のパーサを持たないプログラムへの出口** (穿つのエクスポート、MCP の `canonical_json`) である。
|
|
14
|
-
|
|
15
|
-
**土台ではない。**`semanticDiff` は Model を受け取り、正準JSONを経由しない。
|
|
16
|
-
レイヤー合成は `parse-file.ts` が `.muro` の層に対して行い、正準化はその後である。
|
|
17
|
-
読み込む側 (`fromCanonical`) は無く、系への入口は `parse` だけ — 原本は一つでよい、という選択である。
|
|
18
|
-
|
|
19
|
-
## 二つの版 — 形式の版と言語の版
|
|
20
|
-
|
|
21
|
-
文書が最初に名乗るのは**この形式自身の版**である。`koyu` はその次に来る言語版であって、形式版ではない。
|
|
22
|
-
|
|
23
|
-
| キー | 何の版か | 上がるとき |
|
|
24
|
-
|---|---|---|
|
|
25
|
-
| `format` | **正準JSONの綴り** — キーの集合・並び・照合順・正規化・数の綴り。現在は `koyu-canonical/1.0` | minorはキーが増えたとき (増えたキーを持たない文書のバイトは変わらない)、majorは既存の綴りが変わったとき (既存の文書のバイトが変わる) |
|
|
26
|
-
| `koyu` | **原本の言語版** ([language.md](language.md) §2) の素通し。**書かれていなければ出ない** | 言語の意味論が変わったとき (ADR-0017) |
|
|
27
|
-
|
|
28
|
-
二つが別なのは、**同じ意味論を別のキーで綴り直すことがありうる**からである。境界の向き (`a` キー) の追加は言語を一語も変えずに綴りを変えた。逆に、言語版が上がっても綴りが変わらないことはある。
|
|
29
|
-
|
|
30
|
-
**版宣言の無い原本には版を刻まない。**言語版の既定は「そのツールの最新版」なので (language.md §2)、刻めば著者の書いていない版を名乗ることになり、しかもツールの既定が動いた日に**同じ入力のバイトが変わる**。決定性はこの形式の側の約束であって、ツールの既定に預けるものではない。意味を固定したい原本は `koyu 1.0` と書く。
|
|
31
|
-
|
|
32
|
-
## 安定性の規則 (この形式の存在理由)
|
|
33
|
-
|
|
34
|
-
1. **同じ構成からは常にバイト同一のJSONが出る。** 記録の形のキー (最上位・レベル・空間・境界・開口・seg・柱) は**このスキーマが定める固定順**で、原本に由来するキー (レベル名・パス・アセット名・属性キー) は**照合順**に並ぶ。`spaces` はパス順、`boundaries` は `between` の辞書順 (同一 `between` は内容の正準順)、`zones`・`assets`・`polygons` はキー順に並ぶ。**宣言順に意味の無い配列 (openings・segs・areas・領域合併・柱の通り名 `x`/`y`・描かれた線の端点) も内容の正準順に並ぶ** — 同じ構成を別の行順で書いても同じバイト列になる (ADR-0013)。
|
|
35
|
-
|
|
36
|
-
**例外は `columns` である — 柱の宣言順は意味だから並べ替えない** (ADR-0029)。同じ通りの交点に二本は立たず先の宣言が勝つ (ADR-0023) ので、二行を入れ替えると実際に立つ柱が変わる。並べ替えると別の建物が同一のバイト列になり、この形式の存在理由が柱について失われる。**順序が意味を持つ配列の正準順は、宣言順そのものである。**
|
|
37
|
-
2. **合成後の、書かれた構成である。** import・スパン・stack・**帯 (band)** は展開済みで残らない。既定境界 (derived — ADR-0014) は出ない — 正準JSONは書かれた構成のみで、意味 (既定壁を含む) は導出後のModelが持つ。消費者は `deriveDefaultBoundaries` を適用してから意味を読むこと。
|
|
38
|
-
3. **書かれた表記を保存する。** 位置は通り参照のまま (`"at": "Y2+1820"`)、領域は通り名4つ組、**境界の向きは `a` キー** (先に書いた空間 — `edge`/`swing` はこの側から読む。ADR-0013で追加: これが無いとJSONだけでは開き勝手を復元できない) — 正準形は語り直さない。例外は意味を持たない綴りだけ: 領域の逆順表記 (`X2..X1`) は座標昇順に正規化される。polygonの頂点列は幾何 (巡回) なので並べ替えない。帯 (band — language.md §3) が導出する内側の切り位置は、書かれた綴りが存在しないため**床規則**で綴られる: その座標以下で最も大きい通り芯からのオフセット (オフセット0なら通り名だけ)。帯の両端と直交方向の両端は書かれた綴りのままである。
|
|
39
|
-
|
|
40
|
-
## バイトの規範 (照合順・正規化・数)
|
|
41
|
-
|
|
42
|
-
規則1の「バイト同一」は、次の四つが規範として定まっていて初めて意味を持つ。**別の言語で書かれた実装も、これに従えば同じバイト列を出す。**
|
|
43
|
-
|
|
44
|
-
1. **符号化は UTF-8、改行は LF、字下げは空白2つ、文書の末尾に改行が一つ。**非ASCIIはエスケープせず生のまま出る (`"name": "居室"`)。エスケープするのはJSONが要求するもの (`"` `\` 制御文字) だけである。
|
|
45
|
-
2. **照合順は符号位置の昇順であり、これは出力されるUTF-8バイトの昇順に等しい。**ロケールの照合 (`localeCompare` の類) は使わない。**JavaScriptの `<` と既定の `sort` はここでは使えない** — あれはUTF-16コード単位順で、符号位置順と一致しない: 𠮟 (U+20B9F) は代用対なので `<` では 﨑 (U+FA11) より小さいが、UTF-8では `EF A8 91` (﨑) が `F0 A0 AE 9F` (𠮟) より前である。どちらも日本語の実在の字であり、差は理論上のものではない。規範を「この形式自身のバイト」に置くのは、素直に書かれた他言語の実装と一致する側だからである。実装は `compareCanonical` (`src/core/model.ts`)。
|
|
46
|
-
3. **文字は NFC である。**原本は読み込みのときにNFCへ正規化され、**同一性 (パス・uid・名) もそこで決まる** — `が` を「か + 濁点」と綴った空間は、合成済みの `が` と綴った空間と同じ空間であり、両方書けばパスの重複エラーになる。正規化しなければ、見分けのつかない二つのキーが並ぶ文書が出る。**NFKCは採らない** — `㎡` を `m2` に、`①` を `1` に書き換えてしまい、それは書かれた表記の保存 (規則3) に反する。
|
|
47
|
-
4. **数は最短往復表記で綴る。**`0.30` は `0.3` として出る。丸めも桁揃えも単位変換もしない。指数が要る大きさ (`1e+23`・`1e-7`) は指数表記になる。
|
|
48
|
-
|
|
49
|
-
## スキーマ
|
|
50
|
-
|
|
51
|
-
```jsonc
|
|
52
|
-
{
|
|
53
|
-
"format": "koyu-canonical/1.0", // 形式版 (この文書自身の綴りの版)
|
|
54
|
-
"koyu": "1.0", // 言語版 (書かれた版宣言の素通し。省略された原本では出ない)
|
|
55
|
-
"name": "…", // 任意
|
|
56
|
-
"unit": "mm",
|
|
57
|
-
"grid": { "X": [0, 6400, …], "Y": [0, 5600, …] }, // 座標配列 (通り名は X1.. が暗黙)
|
|
58
|
-
"levels": { "L1": { "z": 0, "h": 3600, "slab": 600 },
|
|
59
|
-
"B1": { "z": -4200, "h": 3600, "slab": 600, "underground": 1 }, … }, // underground は宣言のみ (zの負値から推定しない — ADR-0022)
|
|
60
|
-
"assets": { "SD1": { "kind": "door", "attrs": { "w": 800, "style": "sliding", … } }, … }, // 任意
|
|
61
|
-
"polygons": { "/site": [[-2600, -7000], [38000, -7000], …] }, // 任意
|
|
62
|
-
"columns": [ // 任意 (ADR-0023)。**宣言順のまま** — 先勝ちの規則を持つため
|
|
63
|
-
{ "size": 900, "d": 1200, "levels": ["B2","B1","L1"], "x": ["X2","X3"], "y": ["Y2"], "attrs": { "spec": "SRC" } }, …
|
|
64
|
-
],
|
|
65
|
-
"zones": { "/L3/A": { "attrs": { "name": "Aタイプ", "use": "exclusive" } }, … }, // 任意
|
|
66
|
-
"spaces": {
|
|
67
|
-
"/L5/A/ldk": {
|
|
68
|
-
"type": "ldk",
|
|
69
|
-
"level": "L5", // 明示の level: (パス先頭と異なる所属 — メゾネット等) のみ。既定 (パス先頭) は省略
|
|
70
|
-
"at": [["X1+3200","Y1","X2+3200","Y1+4000"], ["X2+3200","Y1","X3","Y1+2400"]], // 矩形1つなら平坦な4つ組
|
|
71
|
-
"attrs": { "name": "LDK", "floor": "オーク" },
|
|
72
|
-
"areas": [{ "at": ["X1","Y1-4600","X2","Y1-2600"], "attrs": { … } }] // 任意
|
|
73
|
-
}, …
|
|
74
|
-
},
|
|
75
|
-
"boundaries": [
|
|
76
|
-
{
|
|
77
|
-
"between": ["/L5/A/hall", "/L5/corridor"], // 昇順の2パス
|
|
78
|
-
"a": "/L5/A/hall", // 書かれた向き — edge/swingはa側から読む
|
|
79
|
-
"kind": "wall", // wall|open|stair|shaft|void
|
|
80
|
-
"t": 180, "air": true, "edge": "S", // それぞれ任意
|
|
81
|
-
"attrs": { "spec": "RC" }, // 任意
|
|
82
|
-
"line": ["X3,Y1", "X3+600,Y2-900"], // 任意 (ADR-0022)。描かれた線の端点 — 通り語の綴りのまま。
|
|
83
|
-
// 線分は向きを持たないので、対は解決座標の昇順に正準化される
|
|
84
|
-
"openings": [{ "kind": "door", "ref": "D1", "w": 900, "h": 2100,
|
|
85
|
-
"at": "X4", // 比率なら数値、通り参照なら文字列
|
|
86
|
-
"edge": "S", "hinge": "E", "swing": "b", // 任意
|
|
87
|
-
"attrs": { "name": "玄関", "style": "hinged" } }],
|
|
88
|
-
"segs": [{ "w": 1800, "at": "X5", "edge": "S", "attrs": { "spec": "受付ガラス" } }]
|
|
89
|
-
}, …
|
|
90
|
-
]
|
|
91
|
-
}
|
|
92
|
-
```
|
|
93
|
-
|
|
94
|
-
省略規則: 値の無いキー (koyu・h・slab・t・edge・attrs・line等) は出力されない。空のブロック (assets/polygons/columns/zones/areas/openings/segs) も出力されない。属性値は数値の形なら数値、それ以外は文字列。`underground` は真のときだけ `1` として出る。
|
|
95
|
-
|
|
96
|
-
## 実装の正
|
|
97
|
-
|
|
98
|
-
`src/core/model.ts` の `toCanonical()` が正であり、本書はその写しである。乖離したらどちらを直すかをその場で決め、specを合わせる。
|
package/spec/composition.md
DELETED
|
@@ -1,121 +0,0 @@
|
|
|
1
|
-
[English](en/composition.md) · **日本語**
|
|
2
|
-
|
|
3
|
-
# 合成の規則
|
|
4
|
-
|
|
5
|
-
koyu v0.16.0 / muro 1.0 現在。文法は [language.md](language.md) §8、範囲の規範は [scope.md](scope.md)。
|
|
6
|
-
|
|
7
|
-
**合成は時間と分担のためにあり、大きさのためではない。**分担して書く、例外を差分として書く、計画の上に as-built を重ねる — これらが合成の用途である。一棟が大きいから分けるのではない。
|
|
8
|
-
|
|
9
|
-
USD に倣って六つの規則を定める。**この六つが揃ってはじめて合成が使える。**揃っていないことの帰結は「同じ入力から違う結果が出る」であって、それは原本ではない。
|
|
10
|
-
|
|
11
|
-
---
|
|
12
|
-
|
|
13
|
-
## 規則1 — 層は明示された強度順序を持つ
|
|
14
|
-
|
|
15
|
-
**`import` 行の並びが強度の宣言である。**深さ優先で平坦化した列が層の順序であり、**後の層ほど強い**。entry は添字0で最も弱い。同じ層が二度 import されれば、最初の位置を保つ (合成は一度だけ)。
|
|
16
|
-
|
|
17
|
-
```muro-part
|
|
18
|
-
koyu 1.0
|
|
19
|
-
grid X 0 6400 12800
|
|
20
|
-
level L1 0 h:3600 slab:600
|
|
21
|
-
import ./plan.muro # 層1
|
|
22
|
-
import ./as-built.muro # 層2 — こちらが強い
|
|
23
|
-
```
|
|
24
|
-
|
|
25
|
-
**強度は走査の順ではない。**entry の行が `import` より後ろにあっても、entry は添字0のままである。順序で決めていたら、`import` 行を上下に動かしただけで結果が変わってしまう。
|
|
26
|
-
|
|
27
|
-
```sh
|
|
28
|
-
koyu layers <entry.muro> # 層を強度順に印字する
|
|
29
|
-
```
|
|
30
|
-
|
|
31
|
-
## 規則2 — 単一の値は、最も強い層の意見が勝つ
|
|
32
|
-
|
|
33
|
-
厚みも仕様も用途も階高も、上書きは一つの規則で説明される。
|
|
34
|
-
|
|
35
|
-
```muro-part
|
|
36
|
-
over /L5/A/ldk h:2600 spec:改修後
|
|
37
|
-
over /L5/A/hall /L5/corridor t:200 type:open
|
|
38
|
-
over level L3 h:2600
|
|
39
|
-
over asset SD1 w:900
|
|
40
|
-
```
|
|
41
|
-
|
|
42
|
-
`over` は空間・ゾーン・境界・レベル・アセットを対象にとる。書き方から対象の種別が決まる — パス1つなら空間 (無ければゾーン)、パス2つなら境界、`level` / `asset` に続けて名を書けばそれぞれ。
|
|
43
|
-
|
|
44
|
-
**同じ層が同じ属性に二度意見を持つのはエラーである。**どちらが勝つかが決まらないからで、これは「暗黙の解決を残さない」の直接の帰結である。
|
|
45
|
-
|
|
46
|
-
## 規則3 — 集合は、明示された編集で合成する
|
|
47
|
-
|
|
48
|
-
**暗黙のマージをしない。**同じ座に複数の意見がありうるもの — 開口・seg・area・柱 — はすべてこの規則に属す。
|
|
49
|
-
|
|
50
|
-
```muro-part
|
|
51
|
-
over /L5/A/hall /L5/corridor
|
|
52
|
-
- door D2 # 削除
|
|
53
|
-
= door D1 w:1000 # 置換 (書いた属性だけを差し替える)
|
|
54
|
-
+ window w:600 h:1200 at:0.9 name:W1 # 追加
|
|
55
|
-
drop /L5/A/store # 空間 (その関係も一緒に消える)
|
|
56
|
-
drop /L5/a /L5/b # 境界
|
|
57
|
-
drop column C1 # 柱の宣言
|
|
58
|
-
```
|
|
59
|
-
|
|
60
|
-
**同一性は「含む対象 + その中で一意な名」である** ([scope.md §5](scope.md#5-同一性))。`name:` を持たない要素は編集の対象にできない — 指す言葉が無いからである。`+` で足す要素には `name:` が要り、同じ対象の中で重複すればエラーである。
|
|
61
|
-
|
|
62
|
-
**規則3が、これまで特殊扱いされてきたものを普通にする。**同じ場所に複数の層が意見を持ちうるものは、暗黙の勝ち負けではなく明示された編集で解決される。**特殊なのは値の種類であって、規則ではない。**専用構文を作らない。
|
|
63
|
-
|
|
64
|
-
## 規則4 — 定義と上書きを区別する
|
|
65
|
-
|
|
66
|
-
| | 文 | 対象が既にあるとき | 対象が無いとき |
|
|
67
|
-
|---|---|---|---|
|
|
68
|
-
| **定義** | `space` `boundary` `zone` `asset` `level` `polygon` | **エラー** (重複) | 定義する |
|
|
69
|
-
| **上書き** | `over` | 上書きする | **エラー** |
|
|
70
|
-
|
|
71
|
-
二つは別の文であって、書き方から区別がつく。存在しないものに意見だけを足すのは、たいてい綴り違いか、層の順序の思い違いである。
|
|
72
|
-
|
|
73
|
-
## 規則5 — 同じ入力からは常に同じ結果が出る
|
|
74
|
-
|
|
75
|
-
入力には**層とその順序の宣言**を含む。同じ entry からは常に同じ層の列が出て、同じ層の列からは常に同じモデルが出る。
|
|
76
|
-
|
|
77
|
-
**上書きの跡は機械形式に残らない。**`over` で `h:2400` にした模型と、最初から `h:2400` と書いた模型は、同じ正準JSONを与える。正準形が答えるのは「同じ建物か」であって「どう書かれたか」ではない。
|
|
78
|
-
|
|
79
|
-
## 規則6 — 出所が追える
|
|
80
|
-
|
|
81
|
-
最終的な値を、どの層が与えたかを示せる。
|
|
82
|
-
|
|
83
|
-
```sh
|
|
84
|
-
koyu layers <entry.muro> --attrs
|
|
85
|
-
```
|
|
86
|
-
|
|
87
|
-
```text
|
|
88
|
-
Layers (weakest first — later layers are stronger):
|
|
89
|
-
0 main.muro
|
|
90
|
-
1 plan.muro
|
|
91
|
-
2 as-built.muro
|
|
92
|
-
|
|
93
|
-
Attribute provenance:
|
|
94
|
-
boundary:/L1/a|/L1/b:t ← 2 as-built.muro
|
|
95
|
-
space:/L1/a:h ← 2 as-built.muro
|
|
96
|
-
space:/L1/a:spec ← 2 as-built.muro
|
|
97
|
-
```
|
|
98
|
-
|
|
99
|
-
API では `model.attrSrc` (キーは `<種別>:<対象>:<属性キー>`、値は `model.layers` の添字)。
|
|
100
|
-
|
|
101
|
-
---
|
|
102
|
-
|
|
103
|
-
## 衝突とエラー
|
|
104
|
-
|
|
105
|
-
合成の解決が定まらない状態は、**モデルが組み上がる前に止まる** (構文・合成エラー = `SourceError`。`check --json` では SYN01 に写る)。壊れた JSON を JSON パーサが弾くのと同じ層にあり、診断として後から報告するものではない。
|
|
106
|
-
|
|
107
|
-
| 状態 | 扱い |
|
|
108
|
-
|---|---|
|
|
109
|
-
| 空間パス・ゾーンパス・アセット名・敷地形状の重複 | エラー (両者の出所つき) |
|
|
110
|
-
| `grid` / `name` / `koyu` の再宣言 | エラー (同値でも) |
|
|
111
|
-
| `over` の対象が無い / `drop` の対象が無い | エラー |
|
|
112
|
-
| 同じ層が同じ属性に二度意見を持つ | エラー |
|
|
113
|
-
| 集合の編集で名が無い / 一意でない / 重複する | エラー |
|
|
114
|
-
| 同じファイルの二重 import・循環 | 冪等 (一度だけ合成される) |
|
|
115
|
-
|
|
116
|
-
## 何を合成しないか
|
|
117
|
-
|
|
118
|
-
- **バリアント (USD の variant)** — 案の分岐は持たない。分岐は git が持つ
|
|
119
|
-
- **アセットの入れ子参照** — アセットはアセットを参照しない
|
|
120
|
-
- **層ごとの名前空間接頭辞** — パスの階層がすでに名前空間である
|
|
121
|
-
- **層の部分的な読み込み** — 層は丸ごと合成される
|