@things-factory/figure-service 10.1.69 → 10.1.71

package/recipes/stopper/recipe.json

@@ -0,0 +1,108 @@
+{
+  "name": "stopper",
+  "title": {
+    "ko": "스토퍼",
+    "en": "stopper"
+  },
+  "description": {
+    "ko": "고른 부품 윗면에 오르내리는 스토퍼를 넣습니다. 조작값으로 올라와 물건을 멈춥니다.",
+    "en": "A stopper on the chosen part's top that rises on a control to stop what travels."
+  },
+  "category": "conveyor",
+  "tags": [
+    "stopper",
+    "conveyor",
+    "stop"
+  ],
+  "target": "part",
+  "params": [
+    {
+      "name": "position",
+      "kind": "ratio",
+      "default": 0.3,
+      "min": -0.45,
+      "max": 0.45,
+      "label": {
+        "ko": "위치 (부품 길이에 대해)",
+        "en": "position (along the part)"
+      },
+      "hint": {
+        "ko": "가운데에서 길이 방향으로 떨어진 비율. 음수는 왼쪽",
+        "en": "how far along from the middle, as a share of the length; negative is left"
+      }
+    }
+  ],
+  "steps": [
+    {
+      "kind": "add-part",
+      "part": {
+        "id": "{id}-block",
+        "kind": "box",
+        "dimensions": {
+          "width": 40,
+          "height": 60,
+          "depth": 600
+        }
+      }
+    },
+    {
+      "kind": "link-dimension",
+      "part": "{id}-block",
+      "axis": "z",
+      "source": {
+        "of": "part",
+        "part": "{target}",
+        "axis": "z"
+      },
+      "times": 0.75,
+      "narrowRange": true
+    },
+    {
+      "kind": "set-joint",
+      "joint": {
+        "id": "{id}-block",
+        "type": "prismatic",
+        "body0": {
+          "part": "{target}",
+          "face": "top"
+        },
+        "body1": {
+          "part": "{id}-block",
+          "face": "bottom"
+        },
+        "origin": {
+          "align": {
+            "x": {
+              "mm": {
+                "from": {
+                  "of": "part",
+                  "part": "{target}",
+                  "axis": "x"
+                },
+                "times": {
+                  "param": "position"
+                }
+              }
+            }
+          }
+        },
+        "axis": "Y",
+        "lowerLimit": 0,
+        "upperLimit": 60,
+        "state": {
+          "id": "{id}-raise"
+        }
+      }
+    },
+    {
+      "kind": "set-material",
+      "target": "{id}-block",
+      "material": {
+        "token": "palette.tpl-e0a800"
+      },
+      "palette": {
+        "palette.tpl-e0a800": "#e0a800"
+      }
+    }
+  ]
+}

package/recipes/stopper/spec.json

@@ -0,0 +1,45 @@
+{
+  "name": "stopper",
+  "category": "conveyor",
+  "tags": [
+    "stopper",
+    "conveyor",
+    "stop"
+  ],
+  "title": {
+    "ko": "스토퍼",
+    "en": "stopper"
+  },
+  "description": {
+    "ko": "고른 부품 윗면에 오르내리는 스토퍼를 넣습니다. 조작값으로 올라와 물건을 멈춥니다.",
+    "en": "A stopper on the chosen part's top that rises on a control to stop what travels."
+  },
+  "params": [
+    {
+      "name": "position",
+      "kind": "ratio",
+      "default": 0.3,
+      "min": -0.45,
+      "max": 0.45,
+      "label": {
+        "ko": "위치 (부품 길이에 대해)",
+        "en": "position (along the part)"
+      },
+      "hint": {
+        "ko": "가운데에서 길이 방향으로 떨어진 비율. 음수는 왼쪽",
+        "en": "how far along from the middle, as a share of the length; negative is left"
+      },
+      "bind": [
+        {
+          "step": {
+            "kind": "set-joint",
+            "joint": {
+              "id": "{id}-block"
+            }
+          },
+          "path": "joint.origin.align.x.mm.times"
+        }
+      ]
+    }
+  ]
+}

package/recipes/suction-pads/build.mts

@@ -0,0 +1,11 @@
+/* 흡착 패드 줄 — the model. */
+import { host, Model } from '../_lib/model.mts'
+
+export default function build() {
+  const m = new Model(host({ x: 800, y: 40, z: 150 }, 'TPL_SUCTION_PADS', 500))
+  m.add({ id: 'pad', kind: 'cylinder', dimensions: { radius: 25, length: 40 } } as never)
+    .on('pad', 'top', 'host', 'bottom')
+    .colour('pad', 'palette.finger', '#44505a')
+    .do({ kind: 'make-repeat', part: 'pad', axis: 'x', pitch: 120, narrowRange: true })
+  return m.asset
+}

package/recipes/suction-pads/facts.md

@@ -0,0 +1,3 @@
+# suction-pads — facts (not shown on screen; the guide's basis and our review)
+
+아랫면. 원기둥 r25×40 되풀이(간격).

package/recipes/suction-pads/guide.en.md

@@ -0,0 +1,18 @@
+## When to use it
+
+For a row of suction pads on a head that lifts by vacuum.
+
+## Putting it in
+
+1. Choose the head; the pads hang in a row under its **bottom**.
+2. Set the **pitch** in mm.
+3. Press "put in".
+
+## Afterwards
+
+- A longer head gets more pads at the pitch.
+- The parts are ordinary parts: change them one by one, or take them all out with one undo.
+
+## Good to know
+
+- There is no suction.

package/recipes/suction-pads/guide.ko.md

@@ -0,0 +1,18 @@
+## 언제 쓰나
+
+판이나 상자를 흡착으로 드는 헤드에 흡착 패드를 줄지어 달 때 씁니다.
+
+## 넣는 순서
+
+1. 헤드 부품을 고릅니다. 패드는 **아랫면**에 한 줄로 매달립니다.
+2. **간격**을 mm로 정합니다.
+3. 「넣기」를 누릅니다.
+
+## 넣은 뒤
+
+- 헤드가 길어지면 패드가 간격마다 더 들어갑니다.
+- 넣은 부품은 보통 부품이라 하나씩 고칠 수 있고, 되돌리기 한 번에 모두 빠집니다.
+
+## 알아 둘 것
+
+- 흡착 동작은 없습니다.

package/recipes/suction-pads/models/default.json

@@ -0,0 +1 @@
+{"version":"figure-v3-asset-1","name":"TPL_SUCTION_PADS","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":"pad.dimension.radius","unit":"mm","min":0,"max":1.7976931348623157e+308,"role":"design"},{"id":"pad.dimension.length","unit":"mm","min":0,"max":1.7976931348623157e+308,"role":"design"}],"constants":[{"id":"d.mm.0","unit":"mm","value":0},{"id":"a.deg.0","unit":"deg","value":0},{"id":"d.mm.500","unit":"mm","value":500},{"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":"limit.count.100","unit":"count","value":100},{"id":"d.mm.120","unit":"mm","value":120}],"nodes":[{"id":"host.shape","op":"box-shape@1","args":["host.size.x","host.size.y","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":"pad.shape","op":"cylinder-shape@1","args":["pad.dimension.radius","pad.dimension.length"],"outputs":{"shape":"pad.shapeValue"},"params":{"frame":"pad.local"}},{"id":"pad.pose","op":"rigid@1","args":["d.mm.0","pad.on.host.along.y.1.sum.value","d.mm.0","a.deg.0","a.deg.0","a.deg.0"],"outputs":{"pose":"pad.poseValue"},"params":{"from":"pad.local","to":"pad.seat"}},{"id":"pad","op":"member@1","args":["pad.shapeValue","pad.poseValue"],"outputs":{"placed":"pad.placed"}},{"id":"host.on.plane.stand.y.0.times","op":"mul@1","args":["host.size.y","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.500"],"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":"pad.on.host.seat.y.0.times","op":"mul@1","args":["host.size.y","k.ratio._0_5"],"outputs":{"value":"pad.on.host.seat.y.0.times.value"}},{"id":"pad.on.host.along.y.0.times","op":"mul@1","args":["pad.dimension.length","k.ratio._0_5"],"outputs":{"value":"pad.on.host.along.y.0.times.value"}},{"id":"pad.on.host.along.y.1.times","op":"mul@1","args":["d.mm.0","k.ratio._1"],"outputs":{"value":"pad.on.host.along.y.1.times.value"}},{"id":"pad.on.host.along.y.1.sum","op":"add@1","args":["pad.on.host.along.y.0.times.value","pad.on.host.along.y.1.times.value"],"outputs":{"value":"pad.on.host.along.y.1.sum.value"}},{"id":"pad.seat.rigid","op":"rigid@1","args":["pad.row.start.0.times.value","pad.on.host.seat.y.0.times.value","d.mm.0","a.deg.0","a.deg.0","a.deg.0"],"outputs":{"pose":"pad.seat.value"},"params":{"from":"pad.seat","to":"host.local"}},{"id":"pad.row.start.0.times","op":"mul@1","args":["host.size.x","k.ratio._0_5"],"outputs":{"value":"pad.row.start.0.times.value"}},{"id":"pad.row.length.0.times","op":"mul@1","args":["host.size.x","k.ratio.0_5"],"outputs":{"value":"pad.row.length.0.times.value"}},{"id":"pad.row.length.1.times","op":"mul@1","args":["host.size.x","k.ratio.0_5"],"outputs":{"value":"pad.row.length.1.times.value"}},{"id":"pad.row.length.1.sum","op":"add@1","args":["pad.row.length.0.times.value","pad.row.length.1.times.value"],"outputs":{"value":"pad.row.length.1.sum.value"}},{"id":"pad.row.extent.1.sum","op":"add@1","args":["pad.dimension.radius","pad.dimension.radius"],"outputs":{"value":"pad.row.extent.1.sum.value"}},{"id":"pad.layout","op":"fit-pitch@1","args":["pad.row.length.1.sum.value","d.mm.0","d.mm.0","pad.row.extent.1.sum.value","d.mm.120","k.ratio.0_5","limit.count.100"],"outputs":{"layout":"pad.layout.value"}},{"id":"pad.assembly","op":"assembly@1","args":["pad.placed"],"outputs":{"assembly":"pad.assembly.value"}},{"id":"pad.row","op":"compose@1","args":["host.chain.value","pad.seat.value"],"outputs":{"pose":"pad.row.value"}},{"id":"pad.repeat","op":"repeat@1","args":["pad.layout.value","pad.assembly.value","pad.row.value"],"outputs":{"collection":"pad.repeat.value"},"params":{"axis":"x"}}]},"capabilities":{"version":"r3-capability-3","assetFrame":"asset","bindings":[]}},"designInputs":{"host.size.x":800,"host.size.y":40,"host.size.z":150,"pad.dimension.radius":25,"pad.dimension.length":40},"stateDefaults":{},"palette":{"palette.primary":"#477b9e","palette.host":"#d9dde2","palette.tpl-44505a":"#44505a"},"appearance":[{"target":"host","material":{"token":"palette.host"}},{"target":"pad","material":{"token":"palette.tpl-44505a"},"segments":12}],"joints":[{"id":"host","type":"fixed","body0":{"plane":"mounting-plane"},"body1":{"part":"host","face":"bottom"},"origin":{"gap":500}},{"id":"pad","type":"fixed","body0":{"part":"host","face":"bottom"},"body1":{"part":"pad","face":"top"},"origin":{},"repeat":{"axis":"X","pitch":120}}]}

package/recipes/suction-pads/recipe.json

@@ -0,0 +1,86 @@
+{
+  "name": "suction-pads",
+  "title": {
+    "ko": "흡착 패드 줄",
+    "en": "suction pad row"
+  },
+  "description": {
+    "ko": "고른 부품 아랫면에 흡착 패드를 한 줄로 매답니다. 부품 길이를 따라 간격마다 들어갑니다.",
+    "en": "A row of suction pads under the chosen part, one every pitch along its length."
+  },
+  "category": "handling",
+  "tags": [
+    "suction",
+    "vacuum",
+    "pads"
+  ],
+  "target": "part",
+  "params": [
+    {
+      "name": "pitch",
+      "kind": "mm",
+      "default": 120,
+      "label": {
+        "ko": "간격 (mm)",
+        "en": "pitch (mm)"
+      },
+      "hint": {
+        "ko": "패드 사이 거리",
+        "en": "the distance between pads"
+      },
+      "min": 40,
+      "max": 1000
+    }
+  ],
+  "steps": [
+    {
+      "kind": "add-part",
+      "part": {
+        "id": "{id}-pad",
+        "kind": "cylinder",
+        "dimensions": {
+          "radius": 25,
+          "length": 40
+        }
+      }
+    },
+    {
+      "kind": "set-joint",
+      "joint": {
+        "id": "{id}-pad",
+        "type": "fixed",
+        "body0": {
+          "part": "{target}",
+          "face": "bottom"
+        },
+        "body1": {
+          "part": "{id}-pad",
+          "face": "top"
+        },
+        "origin": {},
+        "repeat": {
+          "axis": "X",
+          "pitch": {
+            "param": "pitch"
+          }
+        }
+      },
+      "narrowRange": true
+    },
+    {
+      "kind": "set-material",
+      "target": "{id}-pad",
+      "material": {
+        "token": "palette.tpl-44505a"
+      },
+      "palette": {
+        "palette.tpl-44505a": "#44505a"
+      }
+    },
+    {
+      "kind": "set-segments",
+      "target": "{id}-pad",
+      "segments": 12
+    }
+  ]
+}

package/recipes/suction-pads/spec.json

@@ -0,0 +1,45 @@
+{
+  "name": "suction-pads",
+  "category": "handling",
+  "tags": [
+    "suction",
+    "vacuum",
+    "pads"
+  ],
+  "title": {
+    "ko": "흡착 패드 줄",
+    "en": "suction pad row"
+  },
+  "description": {
+    "ko": "고른 부품 아랫면에 흡착 패드를 한 줄로 매답니다. 부품 길이를 따라 간격마다 들어갑니다.",
+    "en": "A row of suction pads under the chosen part, one every pitch along its length."
+  },
+  "params": [
+    {
+      "name": "pitch",
+      "kind": "mm",
+      "default": 120,
+      "label": {
+        "ko": "간격 (mm)",
+        "en": "pitch (mm)"
+      },
+      "hint": {
+        "ko": "패드 사이 거리",
+        "en": "the distance between pads"
+      },
+      "min": 40,
+      "max": 1000,
+      "bind": [
+        {
+          "step": {
+            "kind": "set-joint",
+            "joint": {
+              "id": "{id}-pad"
+            }
+          },
+          "path": "joint.repeat.pitch"
+        }
+      ]
+    }
+  ]
+}

package/recipes/tank/build.mts

@@ -0,0 +1,12 @@
+/* 원통 탱크 — the model. */
+import { host, Model } from '../_lib/model.mts'
+
+export default function build() {
+  const m = new Model(host({ x: 2000, y: 200, z: 2000 }, 'TPL_TANK'))
+  m.add({ id: 'tank', kind: 'cylinder', dimensions: { radius: 800, length: 1800 } } as never)
+    .follow('tank', 'x', 'host', 'z', 0.4)
+    .follow('tank', 'y', 'host', 'x', 0.9)
+    .on('tank', 'bottom', 'host', 'top')
+    .colour('tank', 'palette.pipe', '#8e9aa6')
+  return m.asset
+}

package/recipes/tank/facts.md

@@ -0,0 +1,3 @@
+# tank — facts (not shown on screen; the guide's basis and our review)
+
+윗면 가운데. 반지름 = 받침 Z × 비율, 높이 = 받침 X × 0.9.

package/recipes/tank/guide.en.md

@@ -0,0 +1,18 @@
+## When to use it
+
+For a cylindrical tank on a base.
+
+## Putting it in
+
+1. Choose the base; the tank stands in the middle of its **top**.
+2. Set the **radius** as a % of the base's depth.
+3. Press "put in".
+
+## Afterwards
+
+- The tank is 90% of the base's length tall; it grows with the base.
+- The parts are ordinary parts: change them one by one, or take them all out with one undo.
+
+## Good to know
+
+- No lid or nozzles are drawn.

package/recipes/tank/guide.ko.md

@@ -0,0 +1,18 @@
+## 언제 쓰나
+
+받침 위에 원통 탱크를 세울 때 씁니다.
+
+## 넣는 순서
+
+1. 받침 부품을 고릅니다. 탱크는 **윗면 가운데**에 섭니다.
+2. **반지름**을 받침 폭에 대한 %로 정합니다.
+3. 「넣기」를 누릅니다.
+
+## 넣은 뒤
+
+- 탱크 높이는 받침 길이의 90%입니다. 받침을 키우면 탱크도 커집니다.
+- 넣은 부품은 보통 부품이라 하나씩 고칠 수 있고, 되돌리기 한 번에 모두 빠집니다.
+
+## 알아 둘 것
+
+- 뚜껑과 노즐은 그리지 않습니다.

package/recipes/tank/models/default.json

@@ -0,0 +1 @@
+{"version":"figure-v3-asset-1","name":"TPL_TANK","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"}],"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.1","unit":"ratio","value":1},{"id":"k.ratio.0_4","unit":"ratio","value":0.4},{"id":"k.ratio.0_9","unit":"ratio","value":0.9}],"nodes":[{"id":"host.shape","op":"box-shape@1","args":["host.dimension.x.value","host.size.y","host.dimension.z.value"],"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":"tank.shape","op":"cylinder-shape@1","args":["tank.dimension.x.value","tank.dimension.y.value"],"outputs":{"shape":"tank.shapeValue"},"params":{"frame":"tank.local"}},{"id":"tank.pose","op":"rigid@1","args":["d.mm.0","tank.on.host.along.y.1.sum.value","d.mm.0","a.deg.0","a.deg.0","a.deg.0"],"outputs":{"pose":"tank.poseValue"},"params":{"from":"tank.local","to":"tank.seat"}},{"id":"tank","op":"place@1","args":["tank.shapeValue","tank.world.value"],"outputs":{"placed":"tank.placed"}},{"id":"tank.dimension.x","op":"mul@1","args":["tank.x.follows.times.value","k.ratio.1"],"outputs":{"value":"tank.dimension.x.value"}},{"id":"host.dimension.z","op":"mul@1","args":["host.size.z","k.ratio.1"],"outputs":{"value":"host.dimension.z.value"}},{"id":"tank.x.follows.times","op":"mul@1","args":["host.dimension.z.value","k.ratio.0_4"],"outputs":{"value":"tank.x.follows.times.value"}},{"id":"tank.dimension.y","op":"mul@1","args":["tank.y.follows.times.value","k.ratio.1"],"outputs":{"value":"tank.dimension.y.value"}},{"id":"host.dimension.x","op":"mul@1","args":["host.size.x","k.ratio.1"],"outputs":{"value":"host.dimension.x.value"}},{"id":"tank.y.follows.times","op":"mul@1","args":["host.dimension.x.value","k.ratio.0_9"],"outputs":{"value":"tank.y.follows.times.value"}},{"id":"host.on.plane.stand.y.0.times","op":"mul@1","args":["host.size.y","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":"tank.on.host.seat.y.0.times","op":"mul@1","args":["host.size.y","k.ratio.0_5"],"outputs":{"value":"tank.on.host.seat.y.0.times.value"}},{"id":"tank.on.host.along.y.0.times","op":"mul@1","args":["tank.dimension.y.value","k.ratio.0_5"],"outputs":{"value":"tank.on.host.along.y.0.times.value"}},{"id":"tank.on.host.along.y.1.sum","op":"add@1","args":["tank.on.host.along.y.0.times.value","d.mm.0"],"outputs":{"value":"tank.on.host.along.y.1.sum.value"}},{"id":"tank.seat.rigid","op":"rigid@1","args":["d.mm.0","tank.on.host.seat.y.0.times.value","d.mm.0","a.deg.0","a.deg.0","a.deg.0"],"outputs":{"pose":"tank.seat.value"},"params":{"from":"tank.seat","to":"host.local"}},{"id":"tank.chain","op":"compose@1","args":["tank.seat.value","tank.poseValue"],"outputs":{"pose":"tank.chain.value"}},{"id":"tank.world","op":"compose@1","args":["host.chain.value","tank.chain.value"],"outputs":{"pose":"tank.world.value"}}]},"capabilities":{"version":"r3-capability-3","assetFrame":"asset","bindings":[]}},"designInputs":{"host.size.x":2000,"host.size.y":200,"host.size.z":2000},"stateDefaults":{},"palette":{"palette.primary":"#477b9e","palette.host":"#d9dde2","palette.tpl-8e9aa6":"#8e9aa6"},"appearance":[{"target":"host","material":{"token":"palette.host"}},{"target":"tank","material":{"token":"palette.tpl-8e9aa6"},"segments":12}],"joints":[{"id":"host","type":"fixed","body0":{"plane":"mounting-plane"},"body1":{"part":"host","face":"bottom"},"origin":{}},{"id":"tank","type":"fixed","body0":{"part":"host","face":"top"},"body1":{"part":"tank","face":"bottom"},"origin":{}}]}

package/recipes/tank/recipe.json

@@ -0,0 +1,105 @@
+{
+  "name": "tank",
+  "title": {
+    "ko": "원통 탱크",
+    "en": "cylindrical tank"
+  },
+  "description": {
+    "ko": "고른 부품(받침) 윗면 가운데에 원통 탱크를 세웁니다. 탱크 굵기와 높이는 받침을 따릅니다.",
+    "en": "A cylindrical tank in the middle of the chosen part's top (a base); its width and height follow the base."
+  },
+  "category": "utility",
+  "tags": [
+    "tank",
+    "vessel",
+    "storage"
+  ],
+  "target": "part",
+  "params": [
+    {
+      "name": "size",
+      "kind": "ratio",
+      "default": 0.4,
+      "label": {
+        "ko": "반지름 (받침 폭에 대해)",
+        "en": "radius (of the base's width)"
+      },
+      "hint": {
+        "ko": "받침 폭(Z)에 대한 탱크 반지름",
+        "en": "the tank's radius as a share of the base's depth"
+      },
+      "min": 0.1,
+      "max": 0.5
+    }
+  ],
+  "steps": [
+    {
+      "kind": "add-part",
+      "part": {
+        "id": "{id}-tank",
+        "kind": "cylinder",
+        "dimensions": {
+          "radius": 800,
+          "length": 1800
+        }
+      }
+    },
+    {
+      "kind": "link-dimension",
+      "part": "{id}-tank",
+      "axis": "x",
+      "source": {
+        "of": "part",
+        "part": "{target}",
+        "axis": "z"
+      },
+      "times": {
+        "param": "size"
+      },
+      "narrowRange": true
+    },
+    {
+      "kind": "link-dimension",
+      "part": "{id}-tank",
+      "axis": "y",
+      "source": {
+        "of": "part",
+        "part": "{target}",
+        "axis": "x"
+      },
+      "times": 0.9,
+      "narrowRange": true
+    },
+    {
+      "kind": "set-joint",
+      "joint": {
+        "id": "{id}-tank",
+        "type": "fixed",
+        "body0": {
+          "part": "{target}",
+          "face": "top"
+        },
+        "body1": {
+          "part": "{id}-tank",
+          "face": "bottom"
+        },
+        "origin": {}
+      }
+    },
+    {
+      "kind": "set-material",
+      "target": "{id}-tank",
+      "material": {
+        "token": "palette.tpl-8e9aa6"
+      },
+      "palette": {
+        "palette.tpl-8e9aa6": "#8e9aa6"
+      }
+    },
+    {
+      "kind": "set-segments",
+      "target": "{id}-tank",
+      "segments": 12
+    }
+  ]
+}

package/recipes/tank/spec.json

@@ -0,0 +1,44 @@
+{
+  "name": "tank",
+  "category": "utility",
+  "tags": [
+    "tank",
+    "vessel",
+    "storage"
+  ],
+  "title": {
+    "ko": "원통 탱크",
+    "en": "cylindrical tank"
+  },
+  "description": {
+    "ko": "고른 부품(받침) 윗면 가운데에 원통 탱크를 세웁니다. 탱크 굵기와 높이는 받침을 따릅니다.",
+    "en": "A cylindrical tank in the middle of the chosen part's top (a base); its width and height follow the base."
+  },
+  "params": [
+    {
+      "name": "size",
+      "kind": "ratio",
+      "default": 0.4,
+      "label": {
+        "ko": "반지름 (받침 폭에 대해)",
+        "en": "radius (of the base's width)"
+      },
+      "hint": {
+        "ko": "받침 폭(Z)에 대한 탱크 반지름",
+        "en": "the tank's radius as a share of the base's depth"
+      },
+      "min": 0.1,
+      "max": 0.5,
+      "bind": [
+        {
+          "step": {
+            "kind": "link-dimension",
+            "part": "{id}-tank",
+            "axis": "x"
+          },
+          "path": "times"
+        }
+      ]
+    }
+  ]
+}

package/recipes/telescopic-arm/build.mts

@@ -0,0 +1,15 @@
+/* 텔레스코픽 암 — the model. */
+import { host, Model } from '../_lib/model.mts'
+
+export default function build() {
+  const m = new Model(host({ x: 3000, y: 700, z: 800 }, 'TPL_TELESCOPIC_ARM'))
+  m.box('stage-1', 1200, 60, 200)
+    .on('stage-1', 'bottom', 'host', 'top')
+    .colour('stage-1', 'frame', '#4f5d6b')
+    .moves('stage-1', { type: 'prismatic', axis: 'X', lower: 0, upper: 800, state: 'extend' })
+    .box('stage-2', 1100, 50, 160)
+    .on('stage-2', 'bottom', 'stage-1', 'top')
+    .colour('stage-2', 'stop', '#e0a800')
+    .moves('stage-2', { type: 'prismatic', axis: 'X', mimic: { joint: 'stage-1', multiplier: 1 } })
+  return m.asset
+}

package/recipes/telescopic-arm/facts.md

@@ -0,0 +1,3 @@
+# telescopic-arm — facts (not shown on screen; the guide's basis and our review)
+
+윗면 가운데. 아랫단 1200×60×200 미끄러짐 X 0~800, 윗단 1100×50×160 아랫단 위, 같이 따라감.

package/recipes/telescopic-arm/guide.en.md

@@ -0,0 +1,17 @@
+## When to use it
+
+For a two-stage telescopic arm of a shuttle or a stacker.
+
+## Putting it in
+
+1. Choose the part; the arm lies in the middle of its **top**.
+2. Press "put in".
+
+## Afterwards
+
+- The **extend** control reaches both stages out; the top stage goes as far again.
+- The parts are ordinary parts: change them one by one, or take them all out with one undo.
+
+## Good to know
+
+- The reach is 800 mm per stage.

package/recipes/telescopic-arm/guide.ko.md

@@ -0,0 +1,17 @@
+## 언제 쓰나
+
+셔틀이나 스태커의 두 단 텔레스코픽 암을 만들 때 씁니다.
+
+## 넣는 순서
+
+1. 부품을 고릅니다. 암은 **윗면 가운데**에 놓입니다.
+2. 「넣기」를 누릅니다.
+
+## 넣은 뒤
+
+- **뻗음** 조작값으로 두 단이 함께 옆으로 뻗습니다. 윗단은 아랫단만큼 더 나갑니다.
+- 넣은 부품은 보통 부품이라 하나씩 고칠 수 있고, 되돌리기 한 번에 모두 빠집니다.
+
+## 알아 둘 것
+
+- 뻗는 거리는 800 mm로 고정입니다.