@things-factory/figure-service 10.1.70 → 10.1.71

package/recipes/handrail/recipe.json

@@ -0,0 +1,140 @@
+{
+  "name": "handrail",
+  "title": {
+    "ko": "난간",
+    "en": "handrail"
+  },
+  "description": {
+    "ko": "고른 부품(발판) 윗면의 앞쪽 가장자리를 따라 난간 기둥과 손잡이를 세웁니다.",
+    "en": "Rail posts and a top rail along the front edge of the chosen part's top (a deck)."
+  },
+  "category": "support",
+  "tags": [
+    "handrail",
+    "railing",
+    "guard"
+  ],
+  "target": "part",
+  "params": [
+    {
+      "name": "pitch",
+      "kind": "mm",
+      "default": 1000,
+      "label": {
+        "ko": "기둥 간격 (mm)",
+        "en": "post pitch (mm)"
+      },
+      "hint": {
+        "ko": "난간 기둥 사이 거리",
+        "en": "the distance between posts"
+      },
+      "min": 300,
+      "max": 3000
+    }
+  ],
+  "steps": [
+    {
+      "kind": "add-part",
+      "part": {
+        "id": "{id}-post",
+        "kind": "box",
+        "dimensions": {
+          "width": 40,
+          "height": 1100,
+          "depth": 40
+        }
+      }
+    },
+    {
+      "kind": "add-part",
+      "part": {
+        "id": "{id}-rail",
+        "kind": "box",
+        "dimensions": {
+          "width": 3000,
+          "height": 40,
+          "depth": 40
+        }
+      }
+    },
+    {
+      "kind": "link-dimension",
+      "part": "{id}-rail",
+      "axis": "x",
+      "source": {
+        "of": "part",
+        "part": "{target}",
+        "axis": "x"
+      },
+      "narrowRange": true
+    },
+    {
+      "kind": "set-joint",
+      "joint": {
+        "id": "{id}-post",
+        "type": "fixed",
+        "body0": {
+          "part": "{target}",
+          "face": "top"
+        },
+        "body1": {
+          "part": "{id}-post",
+          "face": "bottom"
+        },
+        "origin": {
+          "align": {
+            "z": "max"
+          }
+        },
+        "repeat": {
+          "axis": "X",
+          "pitch": {
+            "param": "pitch"
+          }
+        }
+      },
+      "narrowRange": true
+    },
+    {
+      "kind": "set-joint",
+      "joint": {
+        "id": "{id}-rail",
+        "type": "fixed",
+        "body0": {
+          "part": "{target}",
+          "face": "top"
+        },
+        "body1": {
+          "part": "{id}-rail",
+          "face": "bottom"
+        },
+        "origin": {
+          "gap": 1100,
+          "align": {
+            "z": "max"
+          }
+        }
+      }
+    },
+    {
+      "kind": "set-material",
+      "target": "{id}-post",
+      "material": {
+        "token": "palette.tpl-e0b000"
+      },
+      "palette": {
+        "palette.tpl-e0b000": "#e0b000"
+      }
+    },
+    {
+      "kind": "set-material",
+      "target": "{id}-rail",
+      "material": {
+        "token": "palette.tpl-e0b000"
+      },
+      "palette": {
+        "palette.tpl-e0b000": "#e0b000"
+      }
+    }
+  ]
+}

package/recipes/handrail/spec.json

@@ -0,0 +1,45 @@
+{
+  "name": "handrail",
+  "category": "support",
+  "tags": [
+    "handrail",
+    "railing",
+    "guard"
+  ],
+  "title": {
+    "ko": "난간",
+    "en": "handrail"
+  },
+  "description": {
+    "ko": "고른 부품(발판) 윗면의 앞쪽 가장자리를 따라 난간 기둥과 손잡이를 세웁니다.",
+    "en": "Rail posts and a top rail along the front edge of the chosen part's top (a deck)."
+  },
+  "params": [
+    {
+      "name": "pitch",
+      "kind": "mm",
+      "default": 1000,
+      "label": {
+        "ko": "기둥 간격 (mm)",
+        "en": "post pitch (mm)"
+      },
+      "hint": {
+        "ko": "난간 기둥 사이 거리",
+        "en": "the distance between posts"
+      },
+      "min": 300,
+      "max": 3000,
+      "bind": [
+        {
+          "step": {
+            "kind": "set-joint",
+            "joint": {
+              "id": "{id}-post"
+            }
+          },
+          "path": "joint.repeat.pitch"
+        }
+      ]
+    }
+  ]
+}

package/recipes/hatch/build.mts

@@ -0,0 +1,17 @@
+/* 점검구 — the model. */
+import { host, Model } from '../_lib/model.mts'
+
+export default function build() {
+  const m = new Model(host({ x: 1600, y: 1400, z: 1000 }, 'TPL_HATCH'))
+  m.add({ id: 'frame', kind: 'portal', dimensions: { width: 480, height: 420, depth: 30, jamb: 30, head: 30 } } as never)
+    .on('frame', 'back', 'host', 'front')
+    .follow('frame', 'x', 'host', 'x', 0.3)
+    .follow('frame', 'y', 'host', 'y', 0.3)
+    .box('cover', 410, 385, 12)
+    .follow('cover', 'x', 'frame', 'x', 1, -70)
+    .follow('cover', 'y', 'frame', 'y', 1, -35)
+    .on('cover', 'left', 'frame', 'opening-left', { y: 'min', z: 'max' }, 5)
+    .colour('cover', 'palette.leaf', '#5c7c96')
+    .moves('cover', { type: 'revolute', axis: 'Y', lower: -100, upper: 0, state: 'open' })
+  return m.asset
+}

package/recipes/hatch/facts.md

@@ -0,0 +1,3 @@
+# hatch — facts (not shown on screen; the guide's basis and our review)
+
+앞면 가운데. 틀 30 mm. 덮개 = 틀 − (70, 35), 두께 12, 왼쪽 개구부 면에 5 mm 띄움. 회전 −100~0°.

package/recipes/hatch/guide.en.md

@@ -0,0 +1,18 @@
+## When to use it
+
+For an inspection hatch that opens on an equipment body or a cabinet.
+
+## Putting it in
+
+1. Choose the part; the hatch goes in the middle of its **front**.
+2. Set the **hatch width** and **height** as a % of the part.
+3. Press "put in".
+
+## Afterwards
+
+- The **open** control swings the cover about its left side, up to 100°.
+- The parts are ordinary parts: change them one by one, or take them all out with one undo.
+
+## Good to know
+
+- The cover opens outward.

package/recipes/hatch/guide.ko.md

@@ -0,0 +1,18 @@
+## 언제 쓰나
+
+설비 몸체나 제어함에 여닫는 점검구를 낼 때 씁니다.
+
+## 넣는 순서
+
+1. 점검구를 낼 부품을 고릅니다. 점검구는 **앞면 가운데**에 붙습니다.
+2. **점검구 폭**과 **높이**를 부품에 대한 %로 정합니다.
+3. 「넣기」를 누릅니다.
+
+## 넣은 뒤
+
+- **열림** 조작값으로 덮개가 왼쪽을 축으로 100°까지 열립니다.
+- 넣은 부품은 보통 부품이라 하나씩 고칠 수 있고, 되돌리기 한 번에 모두 빠집니다.
+
+## 알아 둘 것
+
+- 덮개는 바깥쪽으로 열립니다.

package/recipes/hatch/models/default.json

@@ -0,0 +1 @@
+{"version":"figure-v3-asset-1","name":"TPL_HATCH","document":{"version":"figure-v3-prototype-1","model":{"version":"r3-spatial-1","inputs":[{"id":"host.size.x","unit":"mm","min":5e-324,"max":1.7976931348623157e+308,"role":"design"},{"id":"host.size.y","unit":"mm","min":5e-324,"max":1.7976931348623157e+308,"role":"design"},{"id":"host.size.z","unit":"mm","min":5e-324,"max":1.7976931348623157e+308,"role":"design"},{"id":"frame.dimension.depth","unit":"mm","min":0,"max":1.7976931348623157e+308,"role":"design"},{"id":"frame.dimension.jamb","unit":"mm","min":0,"max":1.7976931348623157e+308,"role":"design"},{"id":"frame.dimension.head","unit":"mm","min":0,"max":1.7976931348623157e+308,"role":"design"},{"id":"cover.dimension.depth","unit":"mm","min":0,"max":1.7976931348623157e+308,"role":"design"},{"id":"open","unit":"deg","min":-100,"max":0,"role":"state"}],"constants":[{"id":"d.mm.0","unit":"mm","value":0},{"id":"a.deg.0","unit":"deg","value":0},{"id":"k.ratio.0_5","unit":"ratio","value":0.5},{"id":"k.ratio._0_5","unit":"ratio","value":-0.5},{"id":"k.ratio.1","unit":"ratio","value":1},{"id":"k.ratio.0_3","unit":"ratio","value":0.3},{"id":"d.mm._70","unit":"mm","value":-70},{"id":"d.mm._35","unit":"mm","value":-35},{"id":"d.mm.5","unit":"mm","value":5},{"id":"axis.ratio.0","unit":"ratio","value":0}],"nodes":[{"id":"host.shape","op":"box-shape@1","args":["host.dimension.x.value","host.dimension.y.value","host.size.z"],"outputs":{"shape":"host.shapeValue"},"params":{"frame":"host.local"}},{"id":"host.pose","op":"rigid@1","args":["d.mm.0","host.on.plane.stand.y.1.sum.value","d.mm.0","a.deg.0","a.deg.0","a.deg.0"],"outputs":{"pose":"host.poseValue"},"params":{"from":"host.local","to":"host.seat"}},{"id":"host","op":"place@1","args":["host.shapeValue","host.chain.value"],"outputs":{"placed":"host.placed"}},{"id":"frame.shape","op":"portal-profile@2","args":["frame.dimension.x.value","frame.dimension.y.value","frame.dimension.depth","frame.dimension.jamb","frame.dimension.head"],"outputs":{"shape":"frame.shapeValue"},"params":{"frame":"frame.local"}},{"id":"frame.pose","op":"rigid@1","args":["d.mm.0","frame.on.host.own-centre.y.0.times.value","frame.on.host.along.z.1.sum.value","a.deg.0","a.deg.0","a.deg.0"],"outputs":{"pose":"frame.poseValue"},"params":{"from":"frame.local","to":"frame.seat"}},{"id":"frame","op":"place@1","args":["frame.shapeValue","frame.world.value"],"outputs":{"placed":"frame.placed"}},{"id":"frame.dimension.x","op":"mul@1","args":["frame.x.follows.times.value","k.ratio.1"],"outputs":{"value":"frame.dimension.x.value"}},{"id":"host.dimension.x","op":"mul@1","args":["host.size.x","k.ratio.1"],"outputs":{"value":"host.dimension.x.value"}},{"id":"frame.x.follows.times","op":"mul@1","args":["host.dimension.x.value","k.ratio.0_3"],"outputs":{"value":"frame.x.follows.times.value"}},{"id":"frame.dimension.y","op":"mul@1","args":["frame.y.follows.times.value","k.ratio.1"],"outputs":{"value":"frame.dimension.y.value"}},{"id":"host.dimension.y","op":"mul@1","args":["host.size.y","k.ratio.1"],"outputs":{"value":"host.dimension.y.value"}},{"id":"frame.y.follows.times","op":"mul@1","args":["host.dimension.y.value","k.ratio.0_3"],"outputs":{"value":"frame.y.follows.times.value"}},{"id":"cover.shape","op":"box-shape@1","args":["cover.dimension.x.value","cover.dimension.y.value","cover.dimension.depth"],"outputs":{"shape":"cover.shapeValue"},"params":{"frame":"cover.local"}},{"id":"cover.pose","op":"rigid@1","args":["cover.on.frame.along.x.1.sum.value","cover.on.frame.own-edge.y.0.times.value","cover.on.frame.own-edge.z.0.times.value","a.deg.0","a.deg.0","a.deg.0"],"outputs":{"pose":"cover.poseValue"},"params":{"from":"cover.local","to":"cover.seat"}},{"id":"cover","op":"place@1","args":["cover.shapeValue","cover.world.value"],"outputs":{"placed":"cover.placed"}},{"id":"cover.dimension.x","op":"mul@1","args":["cover.x.follows.plus.value","k.ratio.1"],"outputs":{"value":"cover.dimension.x.value"}},{"id":"cover.x.follows.plus","op":"add@1","args":["frame.dimension.x.value","d.mm._70"],"outputs":{"value":"cover.x.follows.plus.value"}},{"id":"cover.dimension.y","op":"mul@1","args":["cover.y.follows.plus.value","k.ratio.1"],"outputs":{"value":"cover.dimension.y.value"}},{"id":"cover.y.follows.plus","op":"add@1","args":["frame.dimension.y.value","d.mm._35"],"outputs":{"value":"cover.y.follows.plus.value"}},{"id":"host.on.plane.stand.y.0.times","op":"mul@1","args":["host.dimension.y.value","k.ratio.0_5"],"outputs":{"value":"host.on.plane.stand.y.0.times.value"}},{"id":"host.on.plane.stand.y.1.sum","op":"add@1","args":["host.on.plane.stand.y.0.times.value","d.mm.0"],"outputs":{"value":"host.on.plane.stand.y.1.sum.value"}},{"id":"host.seat.rigid","op":"rigid@1","args":["d.mm.0","d.mm.0","d.mm.0","a.deg.0","a.deg.0","a.deg.0"],"outputs":{"pose":"host.seat.value"},"params":{"from":"host.seat","to":"asset"}},{"id":"host.chain","op":"compose@1","args":["host.seat.value","host.poseValue"],"outputs":{"pose":"host.chain.value"}},{"id":"frame.on.host.seat.z.0.times","op":"mul@1","args":["host.size.z","k.ratio.0_5"],"outputs":{"value":"frame.on.host.seat.z.0.times.value"}},{"id":"frame.on.host.along.z.0.times","op":"mul@1","args":["frame.dimension.depth","k.ratio.0_5"],"outputs":{"value":"frame.on.host.along.z.0.times.value"}},{"id":"frame.on.host.along.z.1.sum","op":"add@1","args":["frame.on.host.along.z.0.times.value","d.mm.0"],"outputs":{"value":"frame.on.host.along.z.1.sum.value"}},{"id":"frame.on.host.own-centre.y.0.times","op":"mul@1","args":["frame.dimension.y.value","k.ratio._0_5"],"outputs":{"value":"frame.on.host.own-centre.y.0.times.value"}},{"id":"frame.seat.rigid","op":"rigid@1","args":["d.mm.0","d.mm.0","frame.on.host.seat.z.0.times.value","a.deg.0","a.deg.0","a.deg.0"],"outputs":{"pose":"frame.seat.value"},"params":{"from":"frame.seat","to":"host.local"}},{"id":"frame.chain","op":"compose@1","args":["frame.seat.value","frame.poseValue"],"outputs":{"pose":"frame.chain.value"}},{"id":"frame.world","op":"compose@1","args":["host.chain.value","frame.chain.value"],"outputs":{"pose":"frame.world.value"}},{"id":"cover.on.frame.seat.x.0.times","op":"mul@1","args":["frame.dimension.x.value","k.ratio._0_5"],"outputs":{"value":"cover.on.frame.seat.x.0.times.value"}},{"id":"cover.on.frame.seat.x.1.sum","op":"add@1","args":["cover.on.frame.seat.x.0.times.value","frame.dimension.jamb"],"outputs":{"value":"cover.on.frame.seat.x.1.sum.value"}},{"id":"cover.on.frame.along.x.0.times","op":"mul@1","args":["cover.dimension.x.value","k.ratio.0_5"],"outputs":{"value":"cover.on.frame.along.x.0.times.value"}},{"id":"cover.on.frame.along.x.1.sum","op":"add@1","args":["cover.on.frame.along.x.0.times.value","d.mm.5"],"outputs":{"value":"cover.on.frame.along.x.1.sum.value"}},{"id":"cover.on.frame.own-edge.y.0.times","op":"mul@1","args":["cover.dimension.y.value","k.ratio.0_5"],"outputs":{"value":"cover.on.frame.own-edge.y.0.times.value"}},{"id":"cover.on.frame.edge.z.0.times","op":"mul@1","args":["frame.dimension.depth","k.ratio.0_5"],"outputs":{"value":"cover.on.frame.edge.z.0.times.value"}},{"id":"cover.on.frame.own-edge.z.0.times","op":"mul@1","args":["cover.dimension.depth","k.ratio._0_5"],"outputs":{"value":"cover.on.frame.own-edge.z.0.times.value"}},{"id":"cover.seat.rigid","op":"rigid@1","args":["cover.on.frame.seat.x.1.sum.value","d.mm.0","cover.on.frame.edge.z.0.times.value","a.deg.0","a.deg.0","a.deg.0"],"outputs":{"pose":"cover.seat.value"},"params":{"from":"cover.joint","to":"frame.local"}},{"id":"cover.chain","op":"compose@1","args":["cover.seat.value","cover.turned.value"],"outputs":{"pose":"cover.chain.value"}},{"id":"cover.world","op":"compose@1","args":["frame.world.value","cover.chain.value"],"outputs":{"pose":"cover.world.value"}},{"id":"cover.motion","op":"axis-turn@1","args":["axis.ratio.0","k.ratio.1","axis.ratio.0","open"],"outputs":{"pose":"cover.motion.value"},"params":{"from":"cover.seat","to":"cover.joint"}},{"id":"cover.turned","op":"compose@1","args":["cover.motion.value","cover.poseValue"],"outputs":{"pose":"cover.turned.value"}}]},"capabilities":{"version":"r3-capability-3","assetFrame":"asset","bindings":[]}},"designInputs":{"host.size.x":1600,"host.size.y":1400,"host.size.z":1000,"frame.dimension.depth":30,"frame.dimension.jamb":30,"frame.dimension.head":30,"cover.dimension.depth":12},"stateDefaults":{"open":0},"palette":{"palette.primary":"#477b9e","palette.host":"#d9dde2","palette.tpl-5c7c96":"#5c7c96"},"appearance":[{"target":"host","material":{"token":"palette.host"}},{"target":"frame","material":{"token":"palette.primary"}},{"target":"cover","material":{"token":"palette.tpl-5c7c96"}}],"joints":[{"id":"host","type":"fixed","body0":{"plane":"mounting-plane"},"body1":{"part":"host","face":"bottom"},"origin":{}},{"id":"frame","type":"fixed","body0":{"part":"host","face":"front"},"body1":{"part":"frame","face":"back"},"origin":{}},{"id":"cover","type":"revolute","body0":{"part":"frame","face":"opening-left"},"body1":{"part":"cover","face":"left"},"origin":{"gap":5,"align":{"y":"min","z":"max"}},"axis":"Y","lowerLimit":-100,"upperLimit":0,"state":{"id":"open"}}]}

package/recipes/hatch/recipe.json

@@ -0,0 +1,194 @@
+{
+  "name": "hatch",
+  "title": {
+    "ko": "점검구",
+    "en": "inspection hatch"
+  },
+  "description": {
+    "ko": "고른 부품의 앞면 가운데에 작은 틀과 여닫이 덮개를 넣습니다.",
+    "en": "A small frame and a hinged cover in the middle of the chosen part's front."
+  },
+  "category": "door",
+  "tags": [
+    "hatch",
+    "inspection",
+    "door"
+  ],
+  "target": "part",
+  "params": [
+    {
+      "name": "share",
+      "kind": "ratio",
+      "default": 0.3,
+      "min": 0.05,
+      "max": 0.9,
+      "label": {
+        "ko": "점검구 폭 (부품 폭에 대해)",
+        "en": "hatch width (of the part's)"
+      },
+      "hint": {
+        "ko": "고른 부품 폭에 대한 점검구 폭",
+        "en": "the hatch's width as a share of the part's"
+      }
+    },
+    {
+      "name": "height",
+      "kind": "ratio",
+      "default": 0.3,
+      "min": 0.05,
+      "max": 0.9,
+      "label": {
+        "ko": "점검구 높이 (부품 높이에 대해)",
+        "en": "hatch height (of the part's)"
+      },
+      "hint": {
+        "ko": "고른 부품 높이에 대한 점검구 높이",
+        "en": "the hatch's height as a share of the part's"
+      }
+    }
+  ],
+  "steps": [
+    {
+      "kind": "add-part",
+      "part": {
+        "id": "{id}-frame",
+        "kind": "portal",
+        "dimensions": {
+          "width": 480,
+          "height": 420,
+          "depth": 30,
+          "jamb": 30,
+          "head": 30
+        }
+      }
+    },
+    {
+      "kind": "add-part",
+      "part": {
+        "id": "{id}-cover",
+        "kind": "box",
+        "dimensions": {
+          "width": 410,
+          "height": 385,
+          "depth": 12
+        }
+      }
+    },
+    {
+      "kind": "link-dimension",
+      "part": "{id}-frame",
+      "axis": "x",
+      "source": {
+        "of": "part",
+        "part": "{target}",
+        "axis": "x"
+      },
+      "times": {
+        "param": "share"
+      },
+      "narrowRange": true
+    },
+    {
+      "kind": "link-dimension",
+      "part": "{id}-frame",
+      "axis": "y",
+      "source": {
+        "of": "part",
+        "part": "{target}",
+        "axis": "y"
+      },
+      "times": {
+        "param": "height"
+      },
+      "narrowRange": true
+    },
+    {
+      "kind": "link-dimension",
+      "part": "{id}-cover",
+      "axis": "x",
+      "source": {
+        "of": "part",
+        "part": "{id}-frame",
+        "axis": "x"
+      },
+      "plus": -70,
+      "narrowRange": true
+    },
+    {
+      "kind": "link-dimension",
+      "part": "{id}-cover",
+      "axis": "y",
+      "source": {
+        "of": "part",
+        "part": "{id}-frame",
+        "axis": "y"
+      },
+      "plus": -35,
+      "narrowRange": true
+    },
+    {
+      "kind": "set-joint",
+      "joint": {
+        "id": "{id}-frame",
+        "type": "fixed",
+        "body0": {
+          "part": "{target}",
+          "face": "front"
+        },
+        "body1": {
+          "part": "{id}-frame",
+          "face": "back"
+        },
+        "origin": {}
+      }
+    },
+    {
+      "kind": "set-joint",
+      "joint": {
+        "id": "{id}-cover",
+        "type": "revolute",
+        "body0": {
+          "part": "{id}-frame",
+          "face": "opening-left"
+        },
+        "body1": {
+          "part": "{id}-cover",
+          "face": "left"
+        },
+        "origin": {
+          "gap": 5,
+          "align": {
+            "y": "min",
+            "z": "max"
+          }
+        },
+        "axis": "Y",
+        "lowerLimit": -100,
+        "upperLimit": 0,
+        "state": {
+          "id": "{id}-open"
+        }
+      }
+    },
+    {
+      "kind": "set-material",
+      "target": "{id}-frame",
+      "material": {
+        "token": "palette.primary"
+      },
+      "palette": {
+        "palette.primary": "#477b9e"
+      }
+    },
+    {
+      "kind": "set-material",
+      "target": "{id}-cover",
+      "material": {
+        "token": "palette.tpl-5c7c96"
+      },
+      "palette": {
+        "palette.tpl-5c7c96": "#5c7c96"
+      }
+    }
+  ]
+}

package/recipes/hatch/spec.json

@@ -0,0 +1,69 @@
+{
+  "name": "hatch",
+  "category": "door",
+  "tags": [
+    "hatch",
+    "inspection",
+    "door"
+  ],
+  "title": {
+    "ko": "점검구",
+    "en": "inspection hatch"
+  },
+  "description": {
+    "ko": "고른 부품의 앞면 가운데에 작은 틀과 여닫이 덮개를 넣습니다.",
+    "en": "A small frame and a hinged cover in the middle of the chosen part's front."
+  },
+  "params": [
+    {
+      "name": "share",
+      "kind": "ratio",
+      "default": 0.3,
+      "min": 0.05,
+      "max": 0.9,
+      "label": {
+        "ko": "점검구 폭 (부품 폭에 대해)",
+        "en": "hatch width (of the part's)"
+      },
+      "hint": {
+        "ko": "고른 부품 폭에 대한 점검구 폭",
+        "en": "the hatch's width as a share of the part's"
+      },
+      "bind": [
+        {
+          "step": {
+            "kind": "link-dimension",
+            "part": "{id}-frame",
+            "axis": "x"
+          },
+          "path": "times"
+        }
+      ]
+    },
+    {
+      "name": "height",
+      "kind": "ratio",
+      "default": 0.3,
+      "min": 0.05,
+      "max": 0.9,
+      "label": {
+        "ko": "점검구 높이 (부품 높이에 대해)",
+        "en": "hatch height (of the part's)"
+      },
+      "hint": {
+        "ko": "고른 부품 높이에 대한 점검구 높이",
+        "en": "the hatch's height as a share of the part's"
+      },
+      "bind": [
+        {
+          "step": {
+            "kind": "link-dimension",
+            "part": "{id}-frame",
+            "axis": "y"
+          },
+          "path": "times"
+        }
+      ]
+    }
+  ]
+}

package/recipes/hinged-door/build.mts

@@ -0,0 +1,26 @@
+/* 여닫이 문 — the model: a frame on the host's front and one leaf swinging 90° outward about its hinge side. */
+import { host, Model, type Values } from '../_lib/model.mts'
+
+export default function build(values: Values) {
+  const left = values.hinge !== 'right'
+  const m = new Model(host({ x: 4000, y: 3000, z: 6000 }, 'TPL_HINGED_DOOR'))
+  m.add({ id: 'frame', kind: 'portal', dimensions: { width: 1000, height: 2400, depth: 150, jamb: 100, head: 100 } } as never)
+    .do({ kind: 'attach', part: 'frame', face: 'back', to: { part: 'host', face: 'front' }, align: { y: 'min' } })
+    .follow('frame', 'x', 'host', 'x', 0.25)
+    .follow('frame', 'y', 'host', 'y', 0.8)
+    .box('leaf', 790, 2290, 40)
+    .follow('leaf', 'x', 'frame', 'x', 1, -210)
+    .follow('leaf', 'y', 'frame', 'y', 1, -110)
+    .do({
+      kind: 'set-joint',
+      joint: {
+        id: 'leaf', type: 'revolute',
+        body0: { part: 'frame', face: left ? 'opening-left' : 'opening-right' } as never, body1: { part: 'leaf', face: left ? 'left' : 'right' },
+        origin: { facing: 'meet', gap: 5, align: { y: 'min', z: 'max' } },
+        axis: 'Y', lowerLimit: left ? -90 : 0, upperLimit: left ? 0 : 90,
+        state: { id: 'open' }
+      }
+    })
+    .edit({ kind: 'set-material', target: 'leaf', material: { token: 'palette.tpl-5c7c96' }, palette: { 'palette.tpl-5c7c96': '#5c7c96' } } as never)
+  return m.asset
+}

package/recipes/hinged-door/facts.md

@@ -0,0 +1,21 @@
+# hinged-door — facts (not shown on screen; input for the guide writer and our review)
+
+
+고른 부품의 앞면에 문틀과 여닫이 문짝 하나를 넣습니다.
+
+## 넣는 것
+- 문틀 하나. 폭과 높이는 고른 부품에 대한 비율로 따라갑니다.
+- 문짝 하나. 경첩 쪽을 축으로 바깥으로 90° 열립니다.
+
+## 고르는 값
+- 문틀 폭 · 높이 (고른 부품에 대한 %)
+- 경첩 쪽 (왼쪽 · 오른쪽)
+
+## 붙는 면 · 따라가는 크기
+- 고른 부품의 앞면(front)에만 붙는다.
+- 문틀 폭 · 높이는 고른 부품에 대한 비율. 기둥 · 윗틀 100 mm 고정.
+- 문짝 = 문틀 − (폭 210 mm, 높이 110 mm). 경첩 쪽 개구부 면에 5 mm 띄워 단다.
+
+## 알려진 한계
+- 바깥으로만 90° 열린다. 안쪽 열림은 없다.
+- 문틀 폭이 210 mm 이하가 되는 크기에서는 그릴 수 없다.

package/recipes/hinged-door/guide.en.md

@@ -0,0 +1,19 @@
+## When to use it
+
+For a door one person passes through -- an inspection room, an office, a control cabinet. It follows the part's size, so it stays in place when the part is resized.
+
+## Putting it in
+
+1. Choose the part the door goes on. It is fastened to the part's **front**.
+2. Set the **frame width** and **frame height** as a % of the part.
+3. Choose the **hinge side**: on the left, the leaf turns about the left jamb.
+4. Press "put in".
+
+## Afterwards
+
+- Move the **open** control in the motion tab: the leaf swings outward up to 90°.
+- The leaf hangs 5 mm inside the frame's opening.
+
+## Good to know
+
+- It opens outward only. For a door that opens inward, change the joint's range after putting it in.

package/recipes/hinged-door/guide.ko.md

@@ -0,0 +1,19 @@
+## 언제 쓰나
+
+점검실, 사무실, 제어함처럼 한 사람이 드나드는 문에 씁니다. 문이 방 크기를 따라가므로 방을 키우거나 줄여도 맞게 남습니다.
+
+## 넣는 순서
+
+1. 문을 달 부품을 고릅니다. 문은 그 부품의 **앞면**에 붙습니다.
+2. **문틀 폭**과 **문틀 높이**를 부품에 대한 %로 정합니다.
+3. **경첩 쪽**을 고릅니다. 왼쪽이면 문짝이 왼쪽 기둥을 축으로 돕니다.
+4. 「넣기」를 누릅니다.
+
+## 넣은 뒤
+
+- 움직임 칸의 **열림** 조작값을 움직이면 문짝이 바깥으로 90°까지 열립니다.
+- 문짝은 문틀 안쪽에서 5 mm 띄워 달립니다.
+
+## 알아 둘 것
+
+- 바깥쪽으로만 열립니다. 안쪽으로 여는 문이 필요하면 넣은 뒤 관절의 범위를 바꿉니다.