@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
package/src/fabric.ts ADDED
@@ -0,0 +1,123 @@
1
+ // koyu — 面の要素の導出 (ADR-0024)
2
+ // 床・天井・屋根。**語彙は一つも増えない。**
3
+ //
4
+ // level の `slab` (床組み厚) は既に床を宣言していて、`h` (天井高) は既に天井を宣言している。
5
+ // 屋根は「上に何も無い床」の裏返しであり、これも既にモデルにある事実である。
6
+ // 壁が境界から現れ、柱が通りの交点から現れるのと同じ構えで、面もまた宣言から現れる —
7
+ // 床を置く操作も、天井を張る操作も、屋根を架ける操作も存在しない。
8
+
9
+ import { heff, isSemiOutdoor, levelsSorted, type Model, type Pt, type Space } from "./model.js";
10
+ import { areaOf, rectToPoly, subtract } from "./poly.js";
11
+ import { runDecls } from "./vertical.js";
12
+
13
+ /** 天井面の見付け厚 mm (仕上げの面としての厚み) */
14
+ const CEILING_T = 30;
15
+ /** 上に何も無いときの屋根版の厚さ mm (上階レベルの slab が無い場合の既定) */
16
+ const ROOF_T = 200;
17
+
18
+ /** 空間の導出された領域。parse の出口で必ず埋まる (ADR-0022) — 割付への退避は持たない */
19
+ export const regionOf = (s: Space): Pt[][] =>
20
+ s.pieces.length > 0 ? s.pieces : s.rects.map(rectToPoly);
21
+
22
+ export type SlabKind = "floor" | "ceiling" | "roof";
23
+
24
+ /** 生成された面。ビュアーはこれを幾何へ写すだけである */
25
+ export interface Slab {
26
+ kind: SlabKind;
27
+ /** どの空間の面か */
28
+ space: string;
29
+ level: string;
30
+ /** 輪郭 — 導出された凸片 (描かれた線で切られていれば斜めになる) */
31
+ outline: Pt[];
32
+ z0: number;
33
+ z1: number;
34
+ }
35
+
36
+ /**
37
+ * 床・天井・屋根を導く。
38
+ *
39
+ * - **床** は level の `slab` (床組み厚) が与える。吹抜け (type:void) には無い —
40
+ * 床の不在こそが吹抜けの定義だからである (ADR-0006)。外部空間にも無い (地面である)。
41
+ * - **天井** は `h` (天井高) が与える。吹抜け・半屋外・縦動線には無い —
42
+ * 縦動線の天井は上の走りに沿って傾いていて、一つの面ではない (ADR-0021)。
43
+ * - **屋根** は「上に空間が重なっていない床つき空間」の上に架かる。上階レベルの
44
+ * `slab` を厚さに使い、上階が無ければ天井高の上に既定厚で載る。
45
+ * 基壇の上の塔屋が覆わない部分に、書かずに屋根が現れる。
46
+ */
47
+ export function slabs(model: Model): Slab[] {
48
+ const levels = levelsSorted(model);
49
+ const out: Slab[] = [];
50
+ const byLevel = new Map<string, Space[]>();
51
+ for (const s of model.spaces.values()) {
52
+ if (s.rects.length === 0 || !s.level) continue;
53
+ const arr = byLevel.get(s.level) ?? [];
54
+ arr.push(s);
55
+ byLevel.set(s.level, arr);
56
+ }
57
+
58
+ for (const [li, level] of levels.entries()) {
59
+ const upper = levels[li + 1];
60
+ for (const s of byLevel.get(level.name) ?? []) {
61
+ const pieces = regionOf(s);
62
+ const isVoid = s.type === "void";
63
+ const isExterior = s.type === "exterior";
64
+ const semi = isSemiOutdoor(model, s);
65
+ const isRun = runDecls(s).length > 0;
66
+
67
+ // 床: 階のFLの下に床組みが下がる
68
+ if (!isVoid && !isExterior && level.slab !== undefined) {
69
+ for (const outline of pieces) {
70
+ out.push({ kind: "floor", space: s.path, level: level.name, outline, z0: level.z - level.slab, z1: level.z });
71
+ }
72
+ }
73
+
74
+ const h = heff(model, s);
75
+ // 天井: 一つの面として語れる空間にだけ張られる。
76
+ // **天井は室の輪郭と必ずしも一致しない** — 折上げ・下がり天井 (梁型)・数室に
77
+ // またがる連続天井・カーテンウォール手前の見切り。導出は基本計画の解像度での
78
+ // 近似であり、`ceiling:0` が唯一の逃げ道 (現し天井) である。作図された天井を
79
+ // 受け取る余地は ADR-0024 が開けてある
80
+ const declared = s.attrs["ceiling"];
81
+ if (declared !== 0 && !isVoid && !isExterior && !semi && !isRun && h !== undefined) {
82
+ for (const outline of pieces) {
83
+ out.push({
84
+ kind: "ceiling",
85
+ space: s.path,
86
+ level: level.name,
87
+ outline,
88
+ z0: level.z + h - CEILING_T,
89
+ z1: level.z + h,
90
+ });
91
+ }
92
+ }
93
+
94
+ // 屋根: 上に空間が重なっていない範囲に架かる。
95
+ // **一部だけ覆われている空間には、覆われていない範囲にだけ屋根が架かる** —
96
+ // 基壇の上に塔屋が載る建物では、これが基壇屋上として現れる。書かれていない。
97
+ //
98
+ // **床の不在は屋根の不在ではない。**吹抜けにも屋根は架かる — 上に何も無い
99
+ // 吹抜けは、天窓で塞がれた竪穴か、空に開いた中庭かのどちらかであり、
100
+ // 後者は半屋外として導出される (ADR-0007)。だから除くのは外部と半屋外だけである。
101
+ // 逆に**覆っている側には吹抜けも数える** — 竪穴の途中の階に屋根は架からない。
102
+ if (isExterior || semi) continue;
103
+ // **覆っているものも導出された形で取る。**割付で取ると、上階を斜めに切った
104
+ // 範囲まで「覆われている」と数えてしまい、その真下に屋根が架からなかった
105
+ const covers: Pt[][] = [];
106
+ for (const up of levels.slice(li + 1)) {
107
+ for (const o of byLevel.get(up.name) ?? []) {
108
+ if (o.type === "exterior") continue;
109
+ covers.push(...regionOf(o));
110
+ }
111
+ }
112
+ const top = upper ? upper.z : level.z + (h ?? 0) + ROOF_T;
113
+ const t = upper?.slab ?? ROOF_T;
114
+ for (const outline of pieces) {
115
+ for (const tile of subtract(outline, covers)) {
116
+ if (areaOf([tile]) < 1) continue;
117
+ out.push({ kind: "roof", space: s.path, level: level.name, outline: tile, z0: top - t, z1: top });
118
+ }
119
+ }
120
+ }
121
+ }
122
+ return out;
123
+ }