@kensnzk/koyu 0.5.0 → 0.13.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (160) hide show
  1. package/README.ja.md +43 -11
  2. package/README.md +51 -11
  3. package/dist/axo.d.ts +16 -0
  4. package/dist/axo.d.ts.map +1 -0
  5. package/dist/axo.js +211 -0
  6. package/dist/axo.js.map +1 -0
  7. package/dist/check.d.ts +109 -0
  8. package/dist/check.d.ts.map +1 -0
  9. package/dist/check.js +957 -0
  10. package/dist/check.js.map +1 -0
  11. package/dist/cli.d.ts +3 -0
  12. package/dist/cli.d.ts.map +1 -0
  13. package/dist/cli.js +410 -0
  14. package/dist/cli.js.map +1 -0
  15. package/dist/diff.d.ts +105 -0
  16. package/dist/diff.d.ts.map +1 -0
  17. package/dist/diff.js +583 -0
  18. package/dist/diff.js.map +1 -0
  19. package/dist/fabric.d.ts +28 -0
  20. package/dist/fabric.d.ts.map +1 -0
  21. package/dist/fabric.js +105 -0
  22. package/dist/fabric.js.map +1 -0
  23. package/dist/graph.d.ts +118 -0
  24. package/dist/graph.d.ts.map +1 -0
  25. package/dist/graph.js +627 -0
  26. package/dist/graph.js.map +1 -0
  27. package/dist/index.d.ts +12 -0
  28. package/dist/index.d.ts.map +1 -0
  29. package/dist/index.js +13 -0
  30. package/dist/index.js.map +1 -0
  31. package/dist/light.d.ts +15 -0
  32. package/dist/light.d.ts.map +1 -0
  33. package/dist/light.js +53 -0
  34. package/dist/light.js.map +1 -0
  35. package/dist/mcp.d.ts +3 -0
  36. package/dist/mcp.d.ts.map +1 -0
  37. package/dist/mcp.js +361 -0
  38. package/dist/mcp.js.map +1 -0
  39. package/dist/model.d.ts +379 -0
  40. package/dist/model.d.ts.map +1 -0
  41. package/dist/model.js +464 -0
  42. package/dist/model.js.map +1 -0
  43. package/dist/parse-file.d.ts +9 -0
  44. package/dist/parse-file.d.ts.map +1 -0
  45. package/dist/parse-file.js +22 -0
  46. package/dist/parse-file.js.map +1 -0
  47. package/dist/parse.d.ts +16 -0
  48. package/dist/parse.d.ts.map +1 -0
  49. package/dist/parse.js +1040 -0
  50. package/dist/parse.js.map +1 -0
  51. package/dist/plan.d.ts +10 -0
  52. package/dist/plan.d.ts.map +1 -0
  53. package/dist/plan.js +354 -0
  54. package/dist/plan.js.map +1 -0
  55. package/dist/poly.d.ts +78 -0
  56. package/dist/poly.d.ts.map +1 -0
  57. package/dist/poly.js +277 -0
  58. package/dist/poly.js.map +1 -0
  59. package/dist/site.d.ts +24 -0
  60. package/dist/site.d.ts.map +1 -0
  61. package/dist/site.js +54 -0
  62. package/dist/site.js.map +1 -0
  63. package/dist/vertical.d.ts +176 -0
  64. package/dist/vertical.d.ts.map +1 -0
  65. package/dist/vertical.js +669 -0
  66. package/dist/vertical.js.map +1 -0
  67. package/examples/basement/main.muro +84 -0
  68. package/examples/comparison/README.md +64 -1
  69. package/examples/comparison/gen-ifc4.ts +1 -1
  70. package/examples/comparison/gen-ifcx.ts +2 -2
  71. package/examples/comparison/two-rooms.ifcx +1 -1
  72. package/examples/complex/L1.muro +132 -0
  73. package/examples/complex/assets.muro +17 -0
  74. package/examples/complex/basement.muro +40 -0
  75. package/examples/complex/core.muro +40 -0
  76. package/examples/complex/hotel.muro +117 -0
  77. package/examples/complex/main.muro +67 -0
  78. package/examples/complex/office.muro +41 -0
  79. package/examples/complex/plant.muro +34 -0
  80. package/examples/complex/podium.muro +140 -0
  81. package/examples/complex/site.muro +18 -0
  82. package/examples/house/L1.muro +16 -0
  83. package/examples/house/L2.muro +19 -0
  84. package/examples/house/assets.muro +9 -0
  85. package/examples/house/main.muro +27 -0
  86. package/examples/house/site.muro +31 -0
  87. package/examples/house.muro +3 -3
  88. package/examples/mansion.muro +18 -13
  89. package/examples/office.muro +1 -1
  90. package/examples/steps/01-one-room.muro +4 -0
  91. package/examples/steps/02-two-rooms.muro +5 -0
  92. package/examples/steps/03-door.muro +9 -0
  93. package/examples/steps/04-exterior.muro +15 -0
  94. package/examples/steps/05-two-storeys.muro +27 -0
  95. package/examples/steps/06-finished.muro +30 -0
  96. package/examples/steps/README.md +25 -0
  97. package/examples/tower/L1.muro +80 -0
  98. package/examples/tower/L11.muro +49 -0
  99. package/examples/tower/L2.muro +71 -0
  100. package/examples/tower/L3.muro +31 -0
  101. package/examples/tower/assets.muro +14 -0
  102. package/examples/tower/main.muro +37 -0
  103. package/examples/tower/site-geometry.muro +7 -0
  104. package/examples/tower/site.muro +33 -0
  105. package/examples/tower/typical.muro +131 -0
  106. package/examples/two-rooms.canonical.json +30 -3
  107. package/examples/two-rooms.muro +11 -7
  108. package/package.json +29 -2
  109. package/src/axo.ts +258 -0
  110. package/src/check.ts +948 -122
  111. package/src/cli.ts +175 -12
  112. package/src/diff.ts +676 -0
  113. package/src/fabric.ts +123 -0
  114. package/src/graph.ts +451 -61
  115. package/src/index.ts +38 -2
  116. package/src/light.ts +4 -7
  117. package/src/mcp.ts +397 -0
  118. package/src/model.ts +462 -67
  119. package/src/parse-file.ts +28 -0
  120. package/src/parse.ts +682 -45
  121. package/src/plan.ts +152 -14
  122. package/src/poly.ts +295 -0
  123. package/src/site.ts +19 -11
  124. package/src/vertical.ts +884 -0
  125. package/.github/workflows/ci.yml +0 -16
  126. package/.zenodo.json +0 -20
  127. package/CITATION.cff +0 -26
  128. package/docs/decisions/0001-notation-v0.md +0 -29
  129. package/docs/decisions/0002-height-and-offsets.md +0 -27
  130. package/docs/decisions/0003-uncounted-divisions.md +0 -36
  131. package/docs/decisions/0004-typical-floors.md +0 -21
  132. package/docs/decisions/0005-zones-and-unions.md +0 -23
  133. package/docs/decisions/0006-voids-and-light.md +0 -31
  134. package/docs/decisions/0007-semi-outdoor-air.md +0 -27
  135. package/docs/decisions/0008-vocabulary-and-level-attr.md +0 -23
  136. package/docs/decisions/0009-site-and-exterior.md +0 -29
  137. package/docs/ifc-coverage.md +0 -82
  138. package/docs/ifcx-notes.md +0 -25
  139. package/docs/img/house-L1.svg +0 -80
  140. package/docs/img/house-L2.svg +0 -53
  141. package/docs/img/mansion-L1.svg +0 -113
  142. package/docs/img/mansion-L10.svg +0 -111
  143. package/docs/img/mansion-L5.svg +0 -160
  144. package/docs/img/office-L1.svg +0 -116
  145. package/docs/img/office-L2.svg +0 -109
  146. package/docs/img/two-rooms.svg +0 -39
  147. package/docs/log/2026-07-22.md +0 -13
  148. package/docs/log/2026-07-23.md +0 -51
  149. package/docs/roadmap.md +0 -55
  150. package/docs/writing-architecture.md +0 -119
  151. package/spec/notation-v0.md +0 -164
  152. package/spec/vocabulary.md +0 -62
  153. package/test/core.test.ts +0 -171
  154. package/test/design2.test.ts +0 -97
  155. package/test/house.test.ts +0 -74
  156. package/test/mansion.test.ts +0 -99
  157. package/test/office.test.ts +0 -71
  158. package/test/uncounted.test.ts +0 -120
  159. package/test/vertical.test.ts +0 -75
  160. package/tsconfig.json +0 -13
@@ -0,0 +1,669 @@
1
+ // koyu — 縦動線の導出 (ADR-0021)
2
+ // 階段・斜路・エスカレーター・昇降機は「レベル間を通れる」という一つの関係の、
3
+ // 装置の違いにすぎない。トポロジー (どのレベルとどのレベルが繋がるか) は
4
+ // 垂直境界 (type:stair — graph.ts) が持ち、ここが答えるのは形である。
5
+ //
6
+ // 形はソースに無い。空間の領域と階高と「上る向き」の宣言だけから、
7
+ // 段割り・踊り場・勾配・立体・平面の切断をルールで生成する。
8
+ // 段数も踏面も勾配も書かれない — 書かないが検査する (RUN06 / RUN07)。
9
+ import { levelsSorted } from "./model.js";
10
+ /** 宣言に使う属性キー = 装置名。値は上る向き (lift だけ 1) */
11
+ export const RUN_KEYS = ["stair", "ramp", "escalator", "lift"];
12
+ export const RUN_FORMS = ["straight", "return"];
13
+ /** 既定の蹴上げ上限 mm (riser: で上書き) */
14
+ const DEFAULT_RISER_MAX = 180;
15
+ /** 踏面がこれを下回ると窮屈 (RUN06) */
16
+ const TREAD_MIN = 240;
17
+ /** 折返し階段の踊り場を導くときの目標踏面 mm (tread: で上書き) */
18
+ const TREAD_TARGET = 300;
19
+ /** 蹴上げ2倍+踏面 の快適域 (RUN06) */
20
+ const STEP_RULE = { lo: 550, hi: 700 };
21
+ /** エスカレーターの標準勾配 (30度 ≒ 1/1.73) と許容 */
22
+ const ESCALATOR_SLOPE = { lo: 1 / 2.3, hi: 1 / 1.4 };
23
+ /** 平面図の切断面 — FLからの高さ mm */
24
+ export const CUT_HEIGHT = 1200;
25
+ /** 踊り場の最小奥行 mm */
26
+ const LANDING_MIN = 1100;
27
+ /** 乗り込みの床の既定の奥行 mm (entry: で上書き) — 扉が段板に直接ぶつからないための帯 */
28
+ const ENTRY_LANDING = 1100;
29
+ /** エスカレーター一台の既定の呼び幅 mm (lane: で上書き) */
30
+ const LANE_ESCALATOR = 1200;
31
+ /** 平面のエスカレーターの段の刻みのピッチ mm */
32
+ const STEP_MARK = 400;
33
+ /** 段板の見付け厚 (立体) mm */
34
+ const TREAD_SOLID = 200;
35
+ /** 斜路・エスカレーター床版の厚さ mm */
36
+ const SLAB_T = 200;
37
+ /** 空間に書かれた縦動線の宣言をすべて返す (複数は RUN01) */
38
+ export function runDecls(s) {
39
+ const out = [];
40
+ for (const k of RUN_KEYS) {
41
+ const v = s.attrs[k];
42
+ if (v !== undefined)
43
+ out.push({ device: k, value: String(v) });
44
+ }
45
+ return out;
46
+ }
47
+ const EDGES = new Set(["N", "E", "S", "W"]);
48
+ const OPPOSITE = { N: "S", S: "N", E: "W", W: "E" };
49
+ // ---- 局所座標 (t = 進む向き / s = 進行方向の左からの距離) ----
50
+ /**
51
+ * 走りの局所座標 (t,s) を世界の矩形へ写す。
52
+ * t は進む向きに 0 から、s は**進行方向の左**から測る (折返しの左右がここで決まる)
53
+ */
54
+ export function toWorld(rect, up, t0, t1, s0, s1) {
55
+ switch (up) {
56
+ case "N":
57
+ return { x1: rect.x1 + s0, x2: rect.x1 + s1, y1: rect.y1 + t0, y2: rect.y1 + t1 };
58
+ case "S":
59
+ return { x1: rect.x2 - s1, x2: rect.x2 - s0, y1: rect.y2 - t1, y2: rect.y2 - t0 };
60
+ case "E":
61
+ return { x1: rect.x1 + t0, x2: rect.x1 + t1, y1: rect.y2 - s1, y2: rect.y2 - s0 };
62
+ case "W":
63
+ return { x1: rect.x2 - t1, x2: rect.x2 - t0, y1: rect.y1 + s0, y2: rect.y1 + s1 };
64
+ }
65
+ }
66
+ /** 走り方向の全長と幅 */
67
+ function extent(rect, up) {
68
+ const dx = rect.x2 - rect.x1;
69
+ const dy = rect.y2 - rect.y1;
70
+ return up === "N" || up === "S" ? { length: dy, width: dx } : { length: dx, width: dy };
71
+ }
72
+ // ---- 導出 ----
73
+ /**
74
+ * モデル中の縦動線をすべて導く。
75
+ * 宣言が壊れている空間 (値が方位でない・領域が単一矩形でない・レベル不明) は
76
+ * ここでは黙って落とし、check が RUN01..RUN05 として言葉にする。
77
+ */
78
+ export function verticalRuns(model) {
79
+ const levels = levelsSorted(model);
80
+ const out = [];
81
+ for (const s of model.spaces.values()) {
82
+ const run = verticalRun(model, s, levels);
83
+ if (run)
84
+ out.push(run);
85
+ }
86
+ return out.sort((a, b) => (a.z0 - b.z0) || (a.path < b.path ? -1 : 1));
87
+ }
88
+ /** 一つの空間の縦動線。宣言が無い/壊れているときは undefined */
89
+ export function verticalRun(model, s, levels = levelsSorted(model)) {
90
+ const decls = runDecls(s);
91
+ if (decls.length !== 1)
92
+ return undefined;
93
+ const { device, value } = decls[0];
94
+ if (s.rects.length !== 1 || !s.level)
95
+ return undefined;
96
+ const rect = s.rects[0];
97
+ const li = levels.findIndex((l) => l.name === s.level);
98
+ if (li < 0)
99
+ return undefined;
100
+ const up = device === "lift" ? "N" : value;
101
+ if (device !== "lift" && !EDGES.has(value))
102
+ return undefined;
103
+ if (device === "lift" && value !== "1")
104
+ return undefined;
105
+ const formRaw = String(s.attrs["form"] ?? "straight");
106
+ if (!RUN_FORMS.includes(formRaw))
107
+ return undefined;
108
+ const form = formRaw;
109
+ if (device !== "stair" && device !== "ramp" && form !== "straight")
110
+ return undefined;
111
+ const z0 = levels[li].z;
112
+ const upper = levels[li + 1];
113
+ if (!upper && device !== "lift")
114
+ return undefined; // 上る先が無い — RUN04
115
+ const z1 = upper?.z ?? z0;
116
+ const rise = z1 - z0;
117
+ const turn = s.attrs["turn"] === "L" ? "L" : "R";
118
+ const { length, width } = extent(rect, up);
119
+ const base = {
120
+ path: s.path,
121
+ device,
122
+ form,
123
+ level: s.level,
124
+ ...(upper ? { upper: upper.name } : {}),
125
+ z0,
126
+ z1,
127
+ rise,
128
+ up,
129
+ turn: turn,
130
+ rect,
131
+ length,
132
+ width,
133
+ };
134
+ if (device === "lift") {
135
+ return { ...base, entry: 0, lanes: 1, parts: [], risers: 0, riser: 0, tread: 0, slope: 0, going: 0 };
136
+ }
137
+ // 乗り込みの床 (ADR-0021)。走りは領域の縁からは始まらない — 縁から始めると、
138
+ // 階段室の扉が段板に直接ぶつかる。近端 (と直階段では遠端) に階の床が残り、
139
+ // そこが扉の開く場所になる。この帯は走りではないので部品にはしない (階の床である)。
140
+ const entry = Math.max(0, numAttr(s, "entry") ?? ENTRY_LANDING);
141
+ const usable = form === "return" ? length - entry : length - entry * 2;
142
+ if (usable <= 0)
143
+ return undefined; // 乗り込みが全長を食う — RUN05
144
+ // 並列の台数 (エスカレーター)。一台の呼び幅は lane: (既定1200mm)。
145
+ // 上りと下りが並ぶのが実機の姿なので、台ごとに走る向きが交互になる
146
+ const lane = Math.max(1, numAttr(s, "lane") ?? (device === "escalator" ? LANE_ESCALATOR : width));
147
+ const lanes = device === "escalator" ? Math.max(1, Math.floor(width / lane)) : 1;
148
+ const laneW = device === "escalator" ? Math.min(lane, width / lanes) : width;
149
+ const laneMargin = (width - laneW * lanes) / 2;
150
+ const parts = [];
151
+ let risersTotal = 0;
152
+ let riser = 0;
153
+ let tread = 0;
154
+ if (form === "return") {
155
+ // 折返し: 幅を二分し、遠端に中間踊り場。turn:R なら第一の走りが進行方向の左
156
+ const mid = returnLanding(s, device, rise, length - entry, width);
157
+ const flightLen = length - entry - mid;
158
+ if (flightLen <= 0)
159
+ return undefined; // RUN05
160
+ const half = width / 2;
161
+ const [aS, aE] = turn === "R" ? [0, half] : [half, width];
162
+ const [bS, bE] = turn === "R" ? [half, width] : [0, half];
163
+ const tA0 = entry;
164
+ const tA1 = entry + flightLen;
165
+ if (device === "stair") {
166
+ risersTotal = Math.max(2, Math.ceil(rise / (numAttr(s, "riser") ?? DEFAULT_RISER_MAX)));
167
+ riser = rise / risersTotal;
168
+ const k = Math.min(risersTotal - 1, Math.max(1, Math.round(risersTotal / 2)));
169
+ const zMid = z0 + k * riser;
170
+ tread = flightLen / Math.max(1, k - 1);
171
+ parts.push(flight(rect, up, tA0, tA1, aS, aE, z0, zMid, false, k, flightLen / Math.max(1, k - 1)), landingPart(rect, up, tA1, length, 0, width, zMid),
172
+ // 二本目は遠端から近端へ戻る — t が減る向きに走り、z は増える
173
+ flight(rect, up, tA0, tA1, bS, bE, z1, zMid, true, risersTotal - k, flightLen / Math.max(1, risersTotal - k - 1)));
174
+ }
175
+ else {
176
+ const zMid = z0 + rise / 2;
177
+ parts.push(flight(rect, up, tA0, tA1, aS, aE, z0, zMid, false), landingPart(rect, up, tA1, length, 0, width, zMid), flight(rect, up, tA0, tA1, bS, bE, z1, zMid, true));
178
+ }
179
+ }
180
+ else {
181
+ const t0 = entry;
182
+ const t1 = length - entry;
183
+ if (device === "stair") {
184
+ risersTotal = Math.max(2, Math.ceil(rise / (numAttr(s, "riser") ?? DEFAULT_RISER_MAX)));
185
+ riser = rise / risersTotal;
186
+ tread = usable / Math.max(1, risersTotal - 1);
187
+ parts.push(flight(rect, up, t0, t1, 0, width, z0, z1, false, risersTotal, tread));
188
+ }
189
+ else {
190
+ // 並列の台。台ごとに走る向きが交互 — 上りの隣は上から降りてくる一台である
191
+ for (let i = 0; i < lanes; i++) {
192
+ const s0 = laneMargin + i * laneW;
193
+ parts.push(flight(rect, up, t0, t1, s0, s0 + laneW, z0, z1, i % 2 === 1, undefined, undefined, i));
194
+ }
195
+ }
196
+ }
197
+ const going = parts
198
+ .filter((p) => p.kind === "flight" && (p.lane ?? 0) === 0)
199
+ .reduce((a, p) => a + (p.t1 - p.t0), 0);
200
+ // **踏面は走りごとに違う。**折返しの二本目は段数が多い分だけ細かいので、
201
+ // 一本目だけを見ると窮屈な走りが検査 (RUN06) をすり抜ける。最も窮屈な走りが代表する
202
+ const perFlight = parts.flatMap((p) => (p.kind === "flight" && p.tread ? [p.tread] : []));
203
+ if (perFlight.length > 0)
204
+ tread = Math.min(...perFlight);
205
+ const slope = Math.max(...parts
206
+ .filter((p) => p.kind === "flight")
207
+ .map((p) => (p.t1 - p.t0 > 0 ? Math.abs(p.z1 - p.z0) / (p.t1 - p.t0) : 0)));
208
+ return { ...base, entry, lanes, parts, risers: risersTotal, riser, tread, slope, going };
209
+ }
210
+ /** 走りの部品。z0/z1 は t0/t1 における高さ (走る向きは reversed が言う) */
211
+ function flight(rect, up, t0, t1, s0, s1, z0, z1, reversed, risers, tread, lane) {
212
+ return {
213
+ kind: "flight",
214
+ rect: toWorld(rect, up, t0, t1, s0, s1),
215
+ t0,
216
+ t1,
217
+ s0,
218
+ s1,
219
+ z0,
220
+ z1,
221
+ reversed,
222
+ ...(risers !== undefined ? { risers } : {}),
223
+ ...(tread !== undefined ? { tread } : {}),
224
+ ...(lane !== undefined ? { lane } : {}),
225
+ };
226
+ }
227
+ function landingPart(rect, up, t0, t1, s0, s1, z) {
228
+ return {
229
+ kind: "landing",
230
+ rect: toWorld(rect, up, t0, t1, s0, s1),
231
+ t0,
232
+ t1,
233
+ s0,
234
+ s1,
235
+ z0: z,
236
+ z1: z,
237
+ reversed: false,
238
+ };
239
+ }
240
+ function numAttr(s, key) {
241
+ const v = s.attrs[key];
242
+ return typeof v === "number" ? v : undefined;
243
+ }
244
+ /**
245
+ * 折返しの中間踊り場の奥行 mm。`landing:` があればそれ、無ければ導く。
246
+ *
247
+ * 走り長・踏面・踊り場は一つの式で結ばれていて、書けるのは高々二つである。
248
+ * 領域 (平面が決める) と目標踏面 (快適さの定数) を与えると、踊り場は残余として決まる。
249
+ * 逆に踊り場を書けば踏面が残余になる — **設計者が握りたいのは踏面の快適さ**なので、
250
+ * 既定では残余を踊り場へ寄せる。踊り場が設計量になる場合は `landing:` で書き、
251
+ * その結果の踏面は RUN06 が検査する (ADR-0021)。
252
+ */
253
+ function returnLanding(s, device, rise, length, width) {
254
+ const written = numAttr(s, "landing");
255
+ if (written !== undefined)
256
+ return Math.max(LANDING_MIN, written);
257
+ if (device !== "stair") {
258
+ // 斜路: 走りが長いほど勾配が緩い。踊り場は要る分だけ (幅の半分か最小値)
259
+ return Math.max(LANDING_MIN, Math.min(width / 2, length / 3));
260
+ }
261
+ const target = numAttr(s, "tread") ?? TREAD_TARGET;
262
+ const riserMax = numAttr(s, "riser") ?? DEFAULT_RISER_MAX;
263
+ const n = Math.max(2, Math.ceil(rise / riserMax));
264
+ const k = Math.min(n - 1, Math.max(1, Math.round(n / 2)));
265
+ const treads = Math.max(1, Math.max(k - 1, n - k - 1));
266
+ return Math.max(LANDING_MIN, Math.min(length - treads * target, length - LANDING_MIN));
267
+ }
268
+ /** 勾配の 1/N 表記 (N は小数第1位) */
269
+ export function slopeText(slope) {
270
+ if (slope <= 0)
271
+ return "—";
272
+ return `1/${(1 / slope).toFixed(1).replace(/\.0$/, "")}`;
273
+ }
274
+ // ---- 局所座標の点 ----
275
+ /** 走りの局所座標 (t,s) を世界の点へ (toWorld の点版 — 向きが保たれる) */
276
+ export function toPoint(rect, up, t, s) {
277
+ switch (up) {
278
+ case "N":
279
+ return { x: rect.x1 + s, y: rect.y1 + t };
280
+ case "S":
281
+ return { x: rect.x2 - s, y: rect.y2 - t };
282
+ case "E":
283
+ return { x: rect.x1 + t, y: rect.y2 - s };
284
+ case "W":
285
+ return { x: rect.x2 - t, y: rect.y1 + s };
286
+ }
287
+ }
288
+ /** 縦動線の三次元形状。段は段として、斜路は傾いた版として立ち上がる */
289
+ export function runSolids(run) {
290
+ const out = [];
291
+ if (run.device === "lift") {
292
+ const m = Math.min(300, (run.rect.x2 - run.rect.x1) / 6, (run.rect.y2 - run.rect.y1) / 6);
293
+ out.push({
294
+ kind: "box",
295
+ rect: { x1: run.rect.x1 + m, y1: run.rect.y1 + m, x2: run.rect.x2 - m, y2: run.rect.y2 - m },
296
+ z0: run.z0 + 60,
297
+ z1: run.z0 + 2400,
298
+ });
299
+ return out;
300
+ }
301
+ for (const p of run.parts) {
302
+ if (p.kind === "landing") {
303
+ out.push({ kind: "box", rect: p.rect, z0: p.z0 - SLAB_T, z1: p.z0 });
304
+ continue;
305
+ }
306
+ const len = p.t1 - p.t0;
307
+ // **傾きは z から決める。**reversed (人の進む向き) では決めない —
308
+ // 下りのエスカレーターは幾何としては上りと同じ向きに傾いている
309
+ const dir = p.z1 >= p.z0 ? run.up : OPPOSITE[run.up];
310
+ const zLow = Math.min(p.z0, p.z1);
311
+ const zHigh = Math.max(p.z0, p.z1);
312
+ if (run.device === "stair") {
313
+ const k = p.risers ?? 1;
314
+ const treads = Math.max(1, k - 1);
315
+ const d = len / treads;
316
+ const rise = (zHigh - zLow) / k;
317
+ for (let i = 1; i <= treads; i++) {
318
+ // 走る向きに i 段目。段板は蹴上げ+控えの厚みを持ち、隣と重なって連続した段形になる
319
+ const fromT1 = p.z0 > p.z1; // 高いのが t0 側なら、段は t1 から t0 へ上がる
320
+ const a = fromT1 ? p.t1 - i * d : p.t0 + (i - 1) * d;
321
+ const b = fromT1 ? p.t1 - (i - 1) * d : p.t0 + i * d;
322
+ const top = zLow + i * rise;
323
+ out.push({
324
+ kind: "box",
325
+ rect: toWorld(run.rect, run.up, Math.min(a, b), Math.max(a, b), p.s0, p.s1),
326
+ z0: top - rise - TREAD_SOLID,
327
+ z1: top,
328
+ });
329
+ }
330
+ continue;
331
+ }
332
+ // 斜路・エスカレーター: 傾いた版。dir 側へ上がる
333
+ out.push({ kind: "incline", rect: p.rect, up: dir, z0: zLow, z1: zHigh, t: SLAB_T });
334
+ if (run.device === "escalator") {
335
+ // 欄干 (両側の傾いた薄板) — 一台ごとに二枚。見た目がエスカレーターになる最小
336
+ const bal = Math.min(140, (p.s1 - p.s0) / 8);
337
+ for (const [q0, q1] of [
338
+ [p.s0, p.s0 + bal],
339
+ [p.s1 - bal, p.s1],
340
+ ]) {
341
+ out.push({
342
+ kind: "incline",
343
+ rect: toWorld(run.rect, run.up, p.t0, p.t1, q0, q1),
344
+ up: dir,
345
+ z0: zLow + 900,
346
+ z1: zHigh + 900,
347
+ t: 100,
348
+ });
349
+ }
350
+ }
351
+ }
352
+ return out;
353
+ }
354
+ /**
355
+ * 上る走りのうち、**切断面より下に残る**区間 (部品ごと、原点の枠での [t0,t1])。
356
+ *
357
+ * 判定は幾何 — 部品の z の範囲と切断面の高さだけで決まる。部品の番号 (何本目か) では
358
+ * 決めない。並列の台は同じ高さで切られるので、この書き方でしか二台目に窓が出ない。
359
+ */
360
+ function upWindows(run, cutZ) {
361
+ return run.parts.map((p) => {
362
+ if (cutZ === undefined)
363
+ return [p.t0, p.t1];
364
+ const lo = Math.min(p.z0, p.z1);
365
+ const hi = Math.max(p.z0, p.z1);
366
+ if (cutZ >= hi - 1)
367
+ return [p.t0, p.t1]; // 丸ごと切断面より下
368
+ if (cutZ <= lo + 1 || hi - lo < 1)
369
+ return undefined; // 丸ごと上 (踊り場もここ)
370
+ const t = p.t0 + ((cutZ - p.z0) / (p.z1 - p.z0)) * (p.t1 - p.t0);
371
+ const [a, b] = p.z0 < p.z1 ? [p.t0, t] : [t, p.t1];
372
+ return b - a > 1 ? [a, b] : undefined;
373
+ });
374
+ }
375
+ /**
376
+ * 下りる走りは、**双子の上る走りが隠した残り**に現れる。
377
+ *
378
+ * 平面図が「そのレベルで切った断面」である以上、同じ枠を共有する二つの走りは
379
+ * 補い合う — 上りが切断線までを占め、その先に下りが見える。双子が無い (上る走りが
380
+ * 無い / 枠が違う) なら、下りる走りは丸ごと見える。
381
+ */
382
+ function downWindows(run, twin) {
383
+ return run.parts.map((p, i) => {
384
+ const w = twin?.[i];
385
+ if (!w)
386
+ return [p.t0, p.t1];
387
+ const [a, b] = w;
388
+ // 上りが占めたのが手前側 ([t0,t]) なら残りは奥側、逆なら手前側
389
+ const out = a <= p.t0 + 1 ? [b, p.t1] : [p.t0, a];
390
+ return out[1] - out[0] > 1 ? out : undefined;
391
+ });
392
+ }
393
+ /**
394
+ * そのレベルの平面に現れる縦動線を描く。
395
+ *
396
+ * 一枚の平面には二つの走りが出る — このレベルから**上る**走り (切断線で切れる) と、
397
+ * このレベルへ**下りる**走り (下階の走りを上から見たもの)。切断より先には上る走りは
398
+ * 描かれず、その位置から先に下りる走りが見える。これが階段が階ごとに違う姿で現れる
399
+ * 理由であり、平面図が「そのレベルで切った断面」だという事実そのものである。
400
+ */
401
+ export function runDrawsForLevel(model, level, cut = CUT_HEIGHT) {
402
+ const z = model.levels[level]?.z;
403
+ if (z === undefined)
404
+ return [];
405
+ const cutZ = z + cut;
406
+ const runs = verticalRuns(model);
407
+ const out = [];
408
+ const upRuns = runs.filter((r) => r.level === level);
409
+ for (const r of upRuns) {
410
+ const wins = r.device === "lift" ? undefined : upWindows(r, cutZ);
411
+ out.push(drawRun(r, wins, r.device === "lift" ? undefined : crossings(r, cutZ), "up"));
412
+ }
413
+ for (const r of runs.filter((x) => x.upper === level)) {
414
+ if (r.device === "lift")
415
+ continue; // かごの記号は自レベルに一つで足りる
416
+ const twin = upRuns.find((u) => sameFrame(u, r));
417
+ out.push(drawRun(r, downWindows(r, twin ? upWindows(twin, cutZ) : undefined), undefined, "down"));
418
+ }
419
+ return out;
420
+ }
421
+ /**
422
+ * 同じ枠を共有する走りか。**位置だけでは足りない** — 向き (up) と形 (form) と
423
+ * 台数が揃って初めて部品が番号どおりに対応する。向きが違う走りに双子の切断位置を
424
+ * 当てると、鏡像の平面が出る。
425
+ */
426
+ function sameFrame(a, b) {
427
+ return (Math.abs(a.rect.x1 - b.rect.x1) < 1 &&
428
+ Math.abs(a.rect.y1 - b.rect.y1) < 1 &&
429
+ Math.abs(a.rect.x2 - b.rect.x2) < 1 &&
430
+ Math.abs(a.rect.y2 - b.rect.y2) < 1 &&
431
+ a.up === b.up &&
432
+ a.form === b.form &&
433
+ a.device === b.device &&
434
+ a.parts.length === b.parts.length);
435
+ }
436
+ /** 走りが切断面を跨ぐ位置 (部品ごと、跨がなければ undefined) */
437
+ function crossings(run, cutZ) {
438
+ return run.parts.map((p) => {
439
+ if (p.kind !== "flight")
440
+ return undefined;
441
+ const lo = Math.min(p.z0, p.z1);
442
+ const hi = Math.max(p.z0, p.z1);
443
+ if (cutZ < lo || cutZ > hi || hi - lo < 1)
444
+ return undefined;
445
+ return p.t0 + ((cutZ - p.z0) / (p.z1 - p.z0)) * (p.t1 - p.t0);
446
+ });
447
+ }
448
+ function drawRun(run, windows, cross, dir) {
449
+ const draw = {
450
+ path: run.path,
451
+ device: run.device,
452
+ treads: [],
453
+ outline: [],
454
+ breaks: [],
455
+ arrows: [],
456
+ notes: [],
457
+ };
458
+ const { rect, up } = run;
459
+ const seg = (t0, s0, t1, s1) => {
460
+ const a = toPoint(rect, up, t0, s0);
461
+ const b = toPoint(rect, up, t1, s1);
462
+ return { x1: a.x, y1: a.y, x2: b.x, y2: b.y };
463
+ };
464
+ if (run.device === "lift") {
465
+ // 昇降機の記号: かごの輪郭と対角線 (作図慣習)
466
+ const m = Math.min(250, run.width / 8);
467
+ const [t0, t1, s0, s1] = [m, run.length - m, m, run.width - m];
468
+ draw.outline.push(seg(t0, s0, t1, s0), seg(t0, s1, t1, s1), seg(t0, s0, t0, s1), seg(t1, s0, t1, s1));
469
+ draw.treads.push(seg(t0, s0, t1, s1), seg(t0, s1, t1, s0));
470
+ return draw;
471
+ }
472
+ for (let i = 0; i < run.parts.length; i++) {
473
+ const p = run.parts[i];
474
+ const win = windows ? windows[i] : [p.t0, p.t1];
475
+ if (!win)
476
+ continue;
477
+ const [lo, hi] = win;
478
+ draw.outline.push(seg(lo, p.s0, hi, p.s0), seg(lo, p.s1, hi, p.s1));
479
+ if (p.kind === "landing")
480
+ continue;
481
+ if (run.device === "stair") {
482
+ const d = (p.t1 - p.t0) / Math.max(1, (p.risers ?? 2) - 1);
483
+ for (let t = p.t0 + d; t < p.t1 - 1; t += d) {
484
+ if (t < lo - 0.5 || t > hi + 0.5)
485
+ continue;
486
+ draw.treads.push(seg(t, p.s0, t, p.s1));
487
+ }
488
+ }
489
+ else if (run.device === "escalator") {
490
+ for (let t = lo + STEP_MARK; t < hi - 1; t += STEP_MARK) {
491
+ draw.treads.push(seg(t, p.s0, t, p.s1));
492
+ }
493
+ }
494
+ // 矢印: 一台ごと (エスカレーターの上り/下りが並ぶ)。折返しは走りごとには描かず、
495
+ // 出発する走り (上り) / 到着する走り (下り) に一本だけ
496
+ const isFirst = i === run.parts.findIndex((q) => q.kind === "flight");
497
+ const isLast = i === run.parts.map((q) => q.kind).lastIndexOf("flight");
498
+ const wantArrow = run.device === "escalator" ? true : dir === "up" ? isFirst : isLast;
499
+ if (wantArrow && hi - lo > 900) {
500
+ const c = (p.s0 + p.s1) / 2;
501
+ // **矢印は人の進む向きだけから決まる。**reversed が「t の減る向きに進む」、
502
+ // 昇り降りは進む先の高さで決まる。エスカレーターは機械の向きが固定なので
503
+ // どちらの平面でも同じ向きを指し、階段と斜路は下りの平面で反転する
504
+ const partUp = (p.reversed ? p.z0 : p.z1) > (p.reversed ? p.z1 : p.z0);
505
+ const flip = run.device !== "escalator" && dir === "down";
506
+ const goUp = flip ? !partUp : partUp;
507
+ const back = flip ? !p.reversed : p.reversed; // t が減る向きに進むか
508
+ const from = back ? hi - 150 : lo + 150;
509
+ const to = back ? lo + 150 : hi - 150;
510
+ draw.arrows.push({ ...seg(from, c, to, c), label: goUp ? "UP" : "DN" });
511
+ }
512
+ }
513
+ // 切断線: 走りを横切る平行な二本の斜線 (作図慣習)。交差させると吹抜けの対角線と紛れる
514
+ if (dir === "up" && cross) {
515
+ // 並列の台はどれも同じ高さで切られる。切断線は**跨いだ走りに、その走り自身の
516
+ // 位置で**引く — 一台の位置を全台に配ると、何も無い所に線が乗る
517
+ for (let i = 0; i < run.parts.length; i++) {
518
+ const p = run.parts[i];
519
+ const ct = cross[i];
520
+ if (ct === undefined || !windows?.[i])
521
+ continue;
522
+ const g = Math.min(300, (p.s1 - p.s0) / 4);
523
+ const off = Math.min(220, g);
524
+ draw.breaks.push(seg(ct - g - off, p.s0, ct + g - off, p.s1), seg(ct - g + off, p.s0, ct + g + off, p.s1));
525
+ }
526
+ }
527
+ if (dir === "up") {
528
+ draw.notes.push({
529
+ x: (rect.x1 + rect.x2) / 2,
530
+ y: (rect.y1 + rect.y2) / 2,
531
+ text: run.device === "stair"
532
+ ? `${run.risers}段 蹴上${Math.round(run.riser)}/踏面${Math.round(run.tread)}`
533
+ : `${run.lanes > 1 ? `${run.lanes}台 ` : ""}勾配 ${slopeText(run.slope)}`,
534
+ });
535
+ }
536
+ return draw;
537
+ }
538
+ /**
539
+ * 縦動線の検査。宣言の妥当性 (RUN01..05) と、**書かれていない導出値**の妥当性
540
+ * (RUN06 段の寸法 / RUN07 勾配 / RUN08 トポロジーの欠落)。
541
+ * 勾配も段数も書かない — だから検査する、という構えの実装 (ADR-0021)。
542
+ */
543
+ export function runIssues(model) {
544
+ const out = [];
545
+ const levels = levelsSorted(model);
546
+ const stairLinked = new Set();
547
+ for (const b of model.boundaries) {
548
+ if (b.kind === "stair" || b.kind === "shaft") {
549
+ stairLinked.add(b.a);
550
+ stairLinked.add(b.b);
551
+ }
552
+ }
553
+ for (const s of model.spaces.values()) {
554
+ const decls = runDecls(s);
555
+ if (decls.length === 0)
556
+ continue;
557
+ const at = { path: s.path, line: s.line, ...(s.file !== undefined ? { file: s.file } : {}) };
558
+ if (decls.length > 1) {
559
+ out.push({
560
+ code: "RUN01",
561
+ message: `縦動線の宣言が複数あります: ${decls.map((d) => `${d.device}:${d.value}`).join(" ")} (一つの空間に一つです)`,
562
+ ...at,
563
+ });
564
+ continue;
565
+ }
566
+ const { device, value } = decls[0];
567
+ if (device === "lift" ? value !== "1" : !EDGES.has(value)) {
568
+ out.push({
569
+ code: "RUN02",
570
+ message: device === "lift"
571
+ ? `lift の値は 1 です: lift:${value}`
572
+ : `${device} の値は上る向き N/E/S/W です: ${device}:${value}`,
573
+ ...at,
574
+ });
575
+ continue;
576
+ }
577
+ if (s.rects.length !== 1) {
578
+ out.push({
579
+ code: "RUN03",
580
+ message: s.rects.length === 0
581
+ ? `縦動線には領域が要ります: ${s.path}`
582
+ : `縦動線の領域は矩形一つです (合併は段割りが決まりません): ${s.path}`,
583
+ ...at,
584
+ });
585
+ continue;
586
+ }
587
+ if (!s.level) {
588
+ out.push({ code: "RUN03", message: `縦動線のレベルが特定できません: ${s.path}`, ...at });
589
+ continue;
590
+ }
591
+ const formRaw = String(s.attrs["form"] ?? "straight");
592
+ if (!RUN_FORMS.includes(formRaw)) {
593
+ out.push({
594
+ code: "RUN05",
595
+ message: `form は ${RUN_FORMS.join(" / ")} です: form:${formRaw} (螺旋は折返しの連続として書きます)`,
596
+ ...at,
597
+ });
598
+ continue;
599
+ }
600
+ if (device !== "stair" && device !== "ramp" && formRaw !== "straight") {
601
+ out.push({
602
+ code: "RUN05",
603
+ message: `${device} に form:${formRaw} は書けません (折返せるのは階段と斜路です)`,
604
+ ...at,
605
+ });
606
+ continue;
607
+ }
608
+ const li = levels.findIndex((l) => l.name === s.level);
609
+ if (device !== "lift" && (li < 0 || !levels[li + 1])) {
610
+ out.push({
611
+ code: "RUN04",
612
+ message: `${s.level} の上にレベルが無いため、${s.path} の形は生成されません`,
613
+ ...at,
614
+ });
615
+ continue;
616
+ }
617
+ const run = verticalRun(model, s, levels);
618
+ if (!run) {
619
+ out.push({
620
+ code: "RUN05",
621
+ message: `縦動線の形が決まりません: ${s.path} (踊り場が全長を超えていないか確かめます)`,
622
+ ...at,
623
+ });
624
+ continue;
625
+ }
626
+ if (device === "lift")
627
+ continue;
628
+ if (!stairLinked.has(s.path)) {
629
+ out.push({
630
+ code: "RUN08",
631
+ message: `${s.path} は縦動線の形を持ちますが、上下を繋ぐ垂直境界がありません (stack か boundary type:stair を書きます — 形はあってもグラフでは通れません)`,
632
+ ...at,
633
+ });
634
+ }
635
+ if (device === "stair") {
636
+ const t = Math.round(run.tread);
637
+ const r = Math.round(run.riser);
638
+ const rule = 2 * r + t;
639
+ if (t < TREAD_MIN || rule < STEP_RULE.lo || rule > STEP_RULE.hi) {
640
+ out.push({
641
+ code: "RUN06",
642
+ message: `導出された段の寸法が窮屈です: ${run.risers}段 蹴上${r}mm / 踏面${t}mm (2×蹴上+踏面 = ${Math.round(rule)}mm、目安 ${STEP_RULE.lo}〜${STEP_RULE.hi}mm)`,
643
+ ...at,
644
+ });
645
+ }
646
+ }
647
+ else if (device === "ramp") {
648
+ const declared = s.attrs["slope"];
649
+ if (typeof declared === "number" && declared > 0 && run.slope > 1 / declared + 1e-9) {
650
+ out.push({
651
+ code: "RUN07",
652
+ message: `導出された勾配 ${slopeText(run.slope)} が宣言 1/${declared} より急です (走り長を伸ばすか階高を下げます)`,
653
+ ...at,
654
+ });
655
+ }
656
+ }
657
+ else if (device === "escalator") {
658
+ if (run.slope < ESCALATOR_SLOPE.lo || run.slope > ESCALATOR_SLOPE.hi) {
659
+ out.push({
660
+ code: "RUN07",
661
+ message: `導出された勾配 ${slopeText(run.slope)} はエスカレーターの常用域 (約1/1.7 = 30度) から外れています`,
662
+ ...at,
663
+ });
664
+ }
665
+ }
666
+ }
667
+ return out;
668
+ }
669
+ //# sourceMappingURL=vertical.js.map