@things-factory/figure-service 10.1.70 → 10.1.71

package/recipes/gripper-2f/build.mts

@@ -0,0 +1,16 @@
+/* 2핑거 그리퍼 — the model. */
+import { host, Model } from '../_lib/model.mts'
+
+export default function build() {
+  const m = new Model(host({ x: 300, y: 300, z: 300 }, 'TPL_GRIPPER_2F', 600))
+  m.box('palm', 220, 50, 100)
+    .on('palm', 'top', 'host', 'bottom')
+    .colour('palm', 'palette.rail', '#9aa3ab')
+  for (const [f, x] of [['left', 'min'], ['right', 'max']] as const)
+    m.box(f, 30, 140, 80)
+      .on(f, 'top', 'palm', 'bottom', { x })
+      .colour(f, 'palette.finger', '#44505a')
+  m.moves('left', { type: 'prismatic', axis: 'X', lower: 0, upper: 40, state: 'grip' })
+    .moves('right', { type: 'prismatic', axis: 'X', mimic: { joint: 'left', multiplier: -1 } })
+  return m.asset
+}

package/recipes/gripper-2f/facts.md

@@ -0,0 +1,3 @@
+# gripper-2f — facts (not shown on screen; the guide's basis and our review)
+
+아랫면. 손바닥 220×50×100, 손가락 30×140×80 둘(x 최소·최대), 왼쪽 미끄러짐 X 0~행정, 오른쪽 반대로 따라감.

package/recipes/gripper-2f/guide.en.md

@@ -0,0 +1,18 @@
+## When to use it
+
+For a two-finger gripper at a robot's end or on a transfer unit.
+
+## Putting it in
+
+1. Choose the part to hang it from (the robot's end); the gripper hangs under its **bottom**.
+2. Set the **stroke per finger** in mm.
+3. Press "put in".
+
+## Afterwards
+
+- The **grip** control moves both fingers towards each other.
+- The parts are ordinary parts: change them one by one, or take them all out with one undo.
+
+## Good to know
+
+- The fingers are square bars.

package/recipes/gripper-2f/guide.ko.md

@@ -0,0 +1,18 @@
+## 언제 쓰나
+
+로봇 끝이나 이송 장치에 두 손가락 그리퍼를 달 때 씁니다.
+
+## 넣는 순서
+
+1. 매달 부품(로봇 끝)을 고릅니다. 그리퍼는 **아랫면**에 매달립니다.
+2. **한쪽 행정**을 mm로 정합니다.
+3. 「넣기」를 누릅니다.
+
+## 넣은 뒤
+
+- **잡기** 조작값으로 두 손가락이 마주 움직입니다.
+- 넣은 부품은 보통 부품이라 하나씩 고칠 수 있고, 되돌리기 한 번에 모두 빠집니다.
+
+## 알아 둘 것
+
+- 손가락 모양은 네모 막대입니다.

package/recipes/gripper-2f/models/default.json

@@ -0,0 +1 @@
+{"version":"figure-v3-asset-1","name":"TPL_GRIPPER_2F","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":"palm.dimension.width","unit":"mm","min":0,"max":1.7976931348623157e+308,"role":"design"},{"id":"palm.dimension.height","unit":"mm","min":0,"max":1.7976931348623157e+308,"role":"design"},{"id":"palm.dimension.depth","unit":"mm","min":0,"max":1.7976931348623157e+308,"role":"design"},{"id":"left.dimension.width","unit":"mm","min":0,"max":1.7976931348623157e+308,"role":"design"},{"id":"left.dimension.height","unit":"mm","min":0,"max":1.7976931348623157e+308,"role":"design"},{"id":"left.dimension.depth","unit":"mm","min":0,"max":1.7976931348623157e+308,"role":"design"},{"id":"right.dimension.width","unit":"mm","min":0,"max":1.7976931348623157e+308,"role":"design"},{"id":"right.dimension.height","unit":"mm","min":0,"max":1.7976931348623157e+308,"role":"design"},{"id":"right.dimension.depth","unit":"mm","min":0,"max":1.7976931348623157e+308,"role":"design"},{"id":"grip","unit":"mm","min":0,"max":40,"role":"state"}],"constants":[{"id":"d.mm.0","unit":"mm","value":0},{"id":"a.deg.0","unit":"deg","value":0},{"id":"d.mm.600","unit":"mm","value":600},{"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":"axis.ratio.1","unit":"ratio","value":1},{"id":"axis.ratio.0","unit":"ratio","value":0}],"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":"palm.shape","op":"box-shape@1","args":["palm.dimension.width","palm.dimension.height","palm.dimension.depth"],"outputs":{"shape":"palm.shapeValue"},"params":{"frame":"palm.local"}},{"id":"palm.pose","op":"rigid@1","args":["d.mm.0","palm.on.host.along.y.1.sum.value","d.mm.0","a.deg.0","a.deg.0","a.deg.0"],"outputs":{"pose":"palm.poseValue"},"params":{"from":"palm.local","to":"palm.seat"}},{"id":"palm","op":"place@1","args":["palm.shapeValue","palm.world.value"],"outputs":{"placed":"palm.placed"}},{"id":"left.shape","op":"box-shape@1","args":["left.dimension.width","left.dimension.height","left.dimension.depth"],"outputs":{"shape":"left.shapeValue"},"params":{"frame":"left.local"}},{"id":"left.pose","op":"rigid@1","args":["left.on.palm.own-edge.x.0.times.value","left.on.palm.along.y.1.sum.value","d.mm.0","a.deg.0","a.deg.0","a.deg.0"],"outputs":{"pose":"left.poseValue"},"params":{"from":"left.local","to":"left.seat"}},{"id":"left","op":"place@1","args":["left.shapeValue","left.world.value"],"outputs":{"placed":"left.placed"}},{"id":"right.shape","op":"box-shape@1","args":["right.dimension.width","right.dimension.height","right.dimension.depth"],"outputs":{"shape":"right.shapeValue"},"params":{"frame":"right.local"}},{"id":"right.pose","op":"rigid@1","args":["right.on.palm.own-edge.x.0.times.value","right.on.palm.along.y.1.sum.value","d.mm.0","a.deg.0","a.deg.0","a.deg.0"],"outputs":{"pose":"right.poseValue"},"params":{"from":"right.local","to":"right.seat"}},{"id":"right","op":"place@1","args":["right.shapeValue","right.world.value"],"outputs":{"placed":"right.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.600"],"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":"palm.on.host.seat.y.0.times","op":"mul@1","args":["host.size.y","k.ratio._0_5"],"outputs":{"value":"palm.on.host.seat.y.0.times.value"}},{"id":"palm.on.host.along.y.0.times","op":"mul@1","args":["palm.dimension.height","k.ratio._0_5"],"outputs":{"value":"palm.on.host.along.y.0.times.value"}},{"id":"palm.on.host.along.y.1.times","op":"mul@1","args":["d.mm.0","k.ratio._1"],"outputs":{"value":"palm.on.host.along.y.1.times.value"}},{"id":"palm.on.host.along.y.1.sum","op":"add@1","args":["palm.on.host.along.y.0.times.value","palm.on.host.along.y.1.times.value"],"outputs":{"value":"palm.on.host.along.y.1.sum.value"}},{"id":"palm.seat.rigid","op":"rigid@1","args":["d.mm.0","palm.on.host.seat.y.0.times.value","d.mm.0","a.deg.0","a.deg.0","a.deg.0"],"outputs":{"pose":"palm.seat.value"},"params":{"from":"palm.seat","to":"host.local"}},{"id":"palm.chain","op":"compose@1","args":["palm.seat.value","palm.poseValue"],"outputs":{"pose":"palm.chain.value"}},{"id":"palm.world","op":"compose@1","args":["host.chain.value","palm.chain.value"],"outputs":{"pose":"palm.world.value"}},{"id":"left.on.palm.seat.y.0.times","op":"mul@1","args":["palm.dimension.height","k.ratio._0_5"],"outputs":{"value":"left.on.palm.seat.y.0.times.value"}},{"id":"left.on.palm.along.y.0.times","op":"mul@1","args":["left.dimension.height","k.ratio._0_5"],"outputs":{"value":"left.on.palm.along.y.0.times.value"}},{"id":"left.on.palm.along.y.1.times","op":"mul@1","args":["d.mm.0","k.ratio._1"],"outputs":{"value":"left.on.palm.along.y.1.times.value"}},{"id":"left.on.palm.along.y.1.sum","op":"add@1","args":["left.on.palm.along.y.0.times.value","left.on.palm.along.y.1.times.value"],"outputs":{"value":"left.on.palm.along.y.1.sum.value"}},{"id":"left.on.palm.edge.x.0.times","op":"mul@1","args":["palm.dimension.width","k.ratio._0_5"],"outputs":{"value":"left.on.palm.edge.x.0.times.value"}},{"id":"left.on.palm.own-edge.x.0.times","op":"mul@1","args":["left.dimension.width","k.ratio.0_5"],"outputs":{"value":"left.on.palm.own-edge.x.0.times.value"}},{"id":"left.seat.rigid","op":"rigid@1","args":["left.on.palm.edge.x.0.times.value","left.on.palm.seat.y.0.times.value","d.mm.0","a.deg.0","a.deg.0","a.deg.0"],"outputs":{"pose":"left.seat.value"},"params":{"from":"left.joint","to":"palm.local"}},{"id":"left.chain","op":"compose@1","args":["left.seat.value","left.turned.value"],"outputs":{"pose":"left.chain.value"}},{"id":"left.world","op":"compose@1","args":["palm.world.value","left.chain.value"],"outputs":{"pose":"left.world.value"}},{"id":"left.motion","op":"axis-slide@1","args":["axis.ratio.1","axis.ratio.0","axis.ratio.0","grip"],"outputs":{"pose":"left.motion.value"},"params":{"from":"left.seat","to":"left.joint"}},{"id":"left.turned","op":"compose@1","args":["left.motion.value","left.poseValue"],"outputs":{"pose":"left.turned.value"}},{"id":"right.on.palm.seat.y.0.times","op":"mul@1","args":["palm.dimension.height","k.ratio._0_5"],"outputs":{"value":"right.on.palm.seat.y.0.times.value"}},{"id":"right.on.palm.along.y.0.times","op":"mul@1","args":["right.dimension.height","k.ratio._0_5"],"outputs":{"value":"right.on.palm.along.y.0.times.value"}},{"id":"right.on.palm.along.y.1.times","op":"mul@1","args":["d.mm.0","k.ratio._1"],"outputs":{"value":"right.on.palm.along.y.1.times.value"}},{"id":"right.on.palm.along.y.1.sum","op":"add@1","args":["right.on.palm.along.y.0.times.value","right.on.palm.along.y.1.times.value"],"outputs":{"value":"right.on.palm.along.y.1.sum.value"}},{"id":"right.on.palm.edge.x.0.times","op":"mul@1","args":["palm.dimension.width","k.ratio.0_5"],"outputs":{"value":"right.on.palm.edge.x.0.times.value"}},{"id":"right.on.palm.own-edge.x.0.times","op":"mul@1","args":["right.dimension.width","k.ratio._0_5"],"outputs":{"value":"right.on.palm.own-edge.x.0.times.value"}},{"id":"right.seat.rigid","op":"rigid@1","args":["right.on.palm.edge.x.0.times.value","right.on.palm.seat.y.0.times.value","d.mm.0","a.deg.0","a.deg.0","a.deg.0"],"outputs":{"pose":"right.seat.value"},"params":{"from":"right.joint","to":"palm.local"}},{"id":"right.chain","op":"compose@1","args":["right.seat.value","right.turned.value"],"outputs":{"pose":"right.chain.value"}},{"id":"right.world","op":"compose@1","args":["palm.world.value","right.chain.value"],"outputs":{"pose":"right.world.value"}},{"id":"right.motion.mimic","op":"mul@1","args":["grip","k.ratio._1"],"outputs":{"value":"right.motion.mimic.value"}},{"id":"right.motion","op":"axis-slide@1","args":["axis.ratio.1","axis.ratio.0","axis.ratio.0","right.motion.mimic.value"],"outputs":{"pose":"right.motion.value"},"params":{"from":"right.seat","to":"right.joint"}},{"id":"right.turned","op":"compose@1","args":["right.motion.value","right.poseValue"],"outputs":{"pose":"right.turned.value"}}]},"capabilities":{"version":"r3-capability-3","assetFrame":"asset","bindings":[]}},"designInputs":{"host.size.x":300,"host.size.y":300,"host.size.z":300,"palm.dimension.width":220,"palm.dimension.height":50,"palm.dimension.depth":100,"left.dimension.width":30,"left.dimension.height":140,"left.dimension.depth":80,"right.dimension.width":30,"right.dimension.height":140,"right.dimension.depth":80},"stateDefaults":{"grip":0},"palette":{"palette.primary":"#477b9e","palette.host":"#d9dde2","palette.tpl-9aa3ab":"#9aa3ab","palette.tpl-44505a":"#44505a"},"appearance":[{"target":"host","material":{"token":"palette.host"}},{"target":"palm","material":{"token":"palette.tpl-9aa3ab"}},{"target":"left","material":{"token":"palette.tpl-44505a"}},{"target":"right","material":{"token":"palette.tpl-44505a"}}],"joints":[{"id":"host","type":"fixed","body0":{"plane":"mounting-plane"},"body1":{"part":"host","face":"bottom"},"origin":{"gap":600}},{"id":"palm","type":"fixed","body0":{"part":"host","face":"bottom"},"body1":{"part":"palm","face":"top"},"origin":{}},{"id":"left","type":"prismatic","body0":{"part":"palm","face":"bottom"},"body1":{"part":"left","face":"top"},"origin":{"align":{"x":"min"}},"axis":"X","lowerLimit":0,"upperLimit":40,"state":{"id":"grip"}},{"id":"right","type":"prismatic","body0":{"part":"palm","face":"bottom"},"body1":{"part":"right","face":"top"},"origin":{"align":{"x":"max"}},"axis":"X","mimic":{"joint":"left","multiplier":-1}}]}

package/recipes/gripper-2f/recipe.json

@@ -0,0 +1,172 @@
+{
+  "name": "gripper-2f",
+  "title": {
+    "ko": "2핑거 그리퍼",
+    "en": "two-finger gripper"
+  },
+  "description": {
+    "ko": "고른 부품 아랫면에 손바닥과 손가락 두 개를 매답니다. 조작값 하나로 두 손가락이 마주 닫힙니다.",
+    "en": "A palm and two fingers under the chosen part; one control closes the fingers together."
+  },
+  "category": "handling",
+  "tags": [
+    "gripper",
+    "fingers",
+    "robot"
+  ],
+  "target": "part",
+  "params": [
+    {
+      "name": "stroke",
+      "kind": "mm",
+      "default": 40,
+      "label": {
+        "ko": "한쪽 행정 (mm)",
+        "en": "stroke per finger (mm)"
+      },
+      "hint": {
+        "ko": "손가락 하나가 움직이는 거리",
+        "en": "how far each finger moves"
+      },
+      "min": 5,
+      "max": 200
+    }
+  ],
+  "steps": [
+    {
+      "kind": "add-part",
+      "part": {
+        "id": "{id}-palm",
+        "kind": "box",
+        "dimensions": {
+          "width": 220,
+          "height": 50,
+          "depth": 100
+        }
+      }
+    },
+    {
+      "kind": "add-part",
+      "part": {
+        "id": "{id}-left",
+        "kind": "box",
+        "dimensions": {
+          "width": 30,
+          "height": 140,
+          "depth": 80
+        }
+      }
+    },
+    {
+      "kind": "add-part",
+      "part": {
+        "id": "{id}-right",
+        "kind": "box",
+        "dimensions": {
+          "width": 30,
+          "height": 140,
+          "depth": 80
+        }
+      }
+    },
+    {
+      "kind": "set-joint",
+      "joint": {
+        "id": "{id}-palm",
+        "type": "fixed",
+        "body0": {
+          "part": "{target}",
+          "face": "bottom"
+        },
+        "body1": {
+          "part": "{id}-palm",
+          "face": "top"
+        },
+        "origin": {}
+      }
+    },
+    {
+      "kind": "set-joint",
+      "joint": {
+        "id": "{id}-left",
+        "type": "prismatic",
+        "body0": {
+          "part": "{id}-palm",
+          "face": "bottom"
+        },
+        "body1": {
+          "part": "{id}-left",
+          "face": "top"
+        },
+        "origin": {
+          "align": {
+            "x": "min"
+          }
+        },
+        "axis": "X",
+        "lowerLimit": 0,
+        "upperLimit": {
+          "param": "stroke"
+        },
+        "state": {
+          "id": "{id}-grip"
+        }
+      }
+    },
+    {
+      "kind": "set-joint",
+      "joint": {
+        "id": "{id}-right",
+        "type": "prismatic",
+        "body0": {
+          "part": "{id}-palm",
+          "face": "bottom"
+        },
+        "body1": {
+          "part": "{id}-right",
+          "face": "top"
+        },
+        "origin": {
+          "align": {
+            "x": "max"
+          }
+        },
+        "axis": "X",
+        "mimic": {
+          "joint": "{id}-left",
+          "multiplier": -1
+        }
+      }
+    },
+    {
+      "kind": "set-material",
+      "target": "{id}-palm",
+      "material": {
+        "token": "palette.tpl-9aa3ab"
+      },
+      "palette": {
+        "palette.tpl-9aa3ab": "#9aa3ab"
+      }
+    },
+    {
+      "kind": "set-material",
+      "target": "{id}-left",
+      "material": {
+        "token": "palette.tpl-44505a"
+      },
+      "palette": {
+        "palette.tpl-44505a": "#44505a"
+      }
+    },
+    {
+      "kind": "set-material",
+      "target": "{id}-right",
+      "material": {
+        "token": "palette.tpl-44505a"
+      },
+      "palette": {
+        "palette.tpl-44505a": "#44505a"
+      }
+    }
+  ]
+}

package/recipes/gripper-2f/spec.json

@@ -0,0 +1,45 @@
+{
+  "name": "gripper-2f",
+  "category": "handling",
+  "tags": [
+    "gripper",
+    "fingers",
+    "robot"
+  ],
+  "title": {
+    "ko": "2핑거 그리퍼",
+    "en": "two-finger gripper"
+  },
+  "description": {
+    "ko": "고른 부품 아랫면에 손바닥과 손가락 두 개를 매답니다. 조작값 하나로 두 손가락이 마주 닫힙니다.",
+    "en": "A palm and two fingers under the chosen part; one control closes the fingers together."
+  },
+  "params": [
+    {
+      "name": "stroke",
+      "kind": "mm",
+      "default": 40,
+      "label": {
+        "ko": "한쪽 행정 (mm)",
+        "en": "stroke per finger (mm)"
+      },
+      "hint": {
+        "ko": "손가락 하나가 움직이는 거리",
+        "en": "how far each finger moves"
+      },
+      "min": 5,
+      "max": 200,
+      "bind": [
+        {
+          "step": {
+            "kind": "set-joint",
+            "joint": {
+              "id": "{id}-left"
+            }
+          },
+          "path": "joint.upperLimit"
+        }
+      ]
+    }
+  ]
+}

package/recipes/guard-cover/build.mts

@@ -0,0 +1,13 @@
+/* 보호 커버 — 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_GUARD_COVER'))
+  m.box('cover', 3000, 20, 800)
+    .follow('cover', 'x', 'host', 'x')
+    .follow('cover', 'z', 'host', 'z')
+    .on('cover', 'bottom', 'host', 'top', { z: 'min' })
+    .edit({ kind: 'set-material', target: 'cover', material: { token: 'palette.tpl-a7d3e8', transparent: true }, palette: { 'palette.tpl-a7d3e8': '#a7d3e8' } } as never)
+    .moves('cover', { type: 'revolute', axis: 'X', lower: -110, upper: 0, state: 'open' })
+  return m.asset
+}

package/recipes/guard-cover/facts.md

@@ -0,0 +1,3 @@
+# guard-cover — facts (not shown on screen; the guide's basis and our review)
+
+윗면, z 최소 경첩. 부품 X × 20 × 부품 Z, 반투명, 회전 X −110~0°.

package/recipes/guard-cover/guide.en.md

@@ -0,0 +1,18 @@
+## When to use it
+
+For a guard cover over a conveyor or a machine.
+
+## Putting it in
+
+1. Choose the part; the cover lies over its **top**, hinged at the back edge.
+2. Press "put in".
+
+## Afterwards
+
+- The **open** control lifts the cover up to 110°.
+- The cover follows the part's size and is see-through.
+- The parts are ordinary parts: change them one by one, or take them all out with one undo.
+
+## Good to know
+
+- It hinges at the back only.

package/recipes/guard-cover/guide.ko.md

@@ -0,0 +1,18 @@
+## 언제 쓰나
+
+컨베이어나 설비 위를 덮는 보호 커버를 달 때 씁니다.
+
+## 넣는 순서
+
+1. 부품을 고릅니다. 커버는 **윗면**을 덮고, 뒤쪽 가장자리에 경첩이 있습니다.
+2. 「넣기」를 누릅니다.
+
+## 넣은 뒤
+
+- **열림** 조작값으로 커버가 110°까지 들립니다.
+- 커버는 부품 크기를 따르고 반투명입니다.
+- 넣은 부품은 보통 부품이라 하나씩 고칠 수 있고, 되돌리기 한 번에 모두 빠집니다.
+
+## 알아 둘 것
+
+- 뒤쪽 경첩 하나만 있습니다.

package/recipes/guard-cover/models/default.json

@@ -0,0 +1 @@
+{"version":"figure-v3-asset-1","name":"TPL_GUARD_COVER","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":"cover.dimension.height","unit":"mm","min":0,"max":1.7976931348623157e+308,"role":"design"},{"id":"open","unit":"deg","min":-110,"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.1","unit":"ratio","value":1},{"id":"k.ratio._0_5","unit":"ratio","value":-0.5},{"id":"axis.ratio.0","unit":"ratio","value":0}],"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":"cover.shape","op":"box-shape@1","args":["cover.dimension.x.value","cover.dimension.height","cover.dimension.z.value"],"outputs":{"shape":"cover.shapeValue"},"params":{"frame":"cover.local"}},{"id":"cover.pose","op":"rigid@1","args":["d.mm.0","cover.on.host.along.y.1.sum.value","cover.on.host.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":["host.dimension.x.value","k.ratio.1"],"outputs":{"value":"cover.dimension.x.value"}},{"id":"host.dimension.x","op":"mul@1","args":["host.size.x","k.ratio.1"],"outputs":{"value":"host.dimension.x.value"}},{"id":"cover.dimension.z","op":"mul@1","args":["host.dimension.z.value","k.ratio.1"],"outputs":{"value":"cover.dimension.z.value"}},{"id":"host.dimension.z","op":"mul@1","args":["host.size.z","k.ratio.1"],"outputs":{"value":"host.dimension.z.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":"cover.on.host.seat.y.0.times","op":"mul@1","args":["host.size.y","k.ratio.0_5"],"outputs":{"value":"cover.on.host.seat.y.0.times.value"}},{"id":"cover.on.host.along.y.0.times","op":"mul@1","args":["cover.dimension.height","k.ratio.0_5"],"outputs":{"value":"cover.on.host.along.y.0.times.value"}},{"id":"cover.on.host.along.y.1.sum","op":"add@1","args":["cover.on.host.along.y.0.times.value","d.mm.0"],"outputs":{"value":"cover.on.host.along.y.1.sum.value"}},{"id":"cover.on.host.edge.z.0.times","op":"mul@1","args":["host.dimension.z.value","k.ratio._0_5"],"outputs":{"value":"cover.on.host.edge.z.0.times.value"}},{"id":"cover.on.host.own-edge.z.0.times","op":"mul@1","args":["cover.dimension.z.value","k.ratio.0_5"],"outputs":{"value":"cover.on.host.own-edge.z.0.times.value"}},{"id":"cover.seat.rigid","op":"rigid@1","args":["d.mm.0","cover.on.host.seat.y.0.times.value","cover.on.host.edge.z.0.times.value","a.deg.0","a.deg.0","a.deg.0"],"outputs":{"pose":"cover.seat.value"},"params":{"from":"cover.joint","to":"host.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":["host.chain.value","cover.chain.value"],"outputs":{"pose":"cover.world.value"}},{"id":"cover.motion","op":"axis-turn@1","args":["k.ratio.1","axis.ratio.0","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":3000,"host.size.y":700,"host.size.z":800,"cover.dimension.height":20},"stateDefaults":{"open":0},"palette":{"palette.primary":"#477b9e","palette.host":"#d9dde2","palette.tpl-a7d3e8":"#a7d3e8"},"appearance":[{"target":"host","material":{"token":"palette.host"}},{"target":"cover","material":{"token":"palette.tpl-a7d3e8","transparent":true}}],"joints":[{"id":"host","type":"fixed","body0":{"plane":"mounting-plane"},"body1":{"part":"host","face":"bottom"},"origin":{}},{"id":"cover","type":"revolute","body0":{"part":"host","face":"top"},"body1":{"part":"cover","face":"bottom"},"origin":{"align":{"z":"min"}},"axis":"X","lowerLimit":-110,"upperLimit":0,"state":{"id":"open"}}]}

package/recipes/guard-cover/recipe.json

@@ -0,0 +1,92 @@
+{
+  "name": "guard-cover",
+  "title": {
+    "ko": "보호 커버",
+    "en": "guard cover"
+  },
+  "description": {
+    "ko": "고른 부품 윗면을 덮는 여닫이 보호 커버를 넣습니다. 뒤쪽을 축으로 들어 올려 엽니다.",
+    "en": "A hinged guard cover over the chosen part's top, lifted open about its back edge."
+  },
+  "category": "safety",
+  "tags": [
+    "cover",
+    "guard",
+    "hinged"
+  ],
+  "target": "part",
+  "params": [],
+  "steps": [
+    {
+      "kind": "add-part",
+      "part": {
+        "id": "{id}-cover",
+        "kind": "box",
+        "dimensions": {
+          "width": 3000,
+          "height": 20,
+          "depth": 800
+        }
+      }
+    },
+    {
+      "kind": "link-dimension",
+      "part": "{id}-cover",
+      "axis": "x",
+      "source": {
+        "of": "part",
+        "part": "{target}",
+        "axis": "x"
+      },
+      "narrowRange": true
+    },
+    {
+      "kind": "link-dimension",
+      "part": "{id}-cover",
+      "axis": "z",
+      "source": {
+        "of": "part",
+        "part": "{target}",
+        "axis": "z"
+      },
+      "narrowRange": true
+    },
+    {
+      "kind": "set-joint",
+      "joint": {
+        "id": "{id}-cover",
+        "type": "revolute",
+        "body0": {
+          "part": "{target}",
+          "face": "top"
+        },
+        "body1": {
+          "part": "{id}-cover",
+          "face": "bottom"
+        },
+        "origin": {
+          "align": {
+            "z": "min"
+          }
+        },
+        "axis": "X",
+        "lowerLimit": -110,
+        "upperLimit": 0,
+        "state": {
+          "id": "{id}-open"
+        }
+      }
+    },
+    {
+      "kind": "set-material",
+      "target": "{id}-cover",
+      "material": {
+        "token": "palette.tpl-a7d3e8",
+        "transparent": true
+      },
+      "palette": {
+        "palette.tpl-a7d3e8": "#a7d3e8"
+      }
+    }
+  ]
+}

package/recipes/guard-cover/spec.json

@@ -0,0 +1,18 @@
+{
+  "name": "guard-cover",
+  "category": "safety",
+  "tags": [
+    "cover",
+    "guard",
+    "hinged"
+  ],
+  "title": {
+    "ko": "보호 커버",
+    "en": "guard cover"
+  },
+  "description": {
+    "ko": "고른 부품 윗면을 덮는 여닫이 보호 커버를 넣습니다. 뒤쪽을 축으로 들어 올려 엽니다.",
+    "en": "A hinged guard cover over the chosen part's top, lifted open about its back edge."
+  },
+  "params": []
+}

package/recipes/handrail/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: 40, z: 1500 }, 'TPL_HANDRAIL', 800))
+  m.box('post', 40, 1100, 40)
+    .on('post', 'bottom', 'host', 'top', { z: 'max' })
+    .colour('post', 'rail-yellow', '#e0b000')
+    .do({ kind: 'make-repeat', part: 'post', axis: 'x', pitch: 1000, narrowRange: true })
+    .box('rail', 3000, 40, 40)
+    .follow('rail', 'x', 'host', 'x')
+    .on('rail', 'bottom', 'host', 'top', { z: 'max' }, 1100)
+    .colour('rail', 'rail-yellow', '#e0b000')
+  return m.asset
+}

package/recipes/handrail/facts.md

@@ -0,0 +1,3 @@
+# handrail — facts (not shown on screen; the guide's basis and our review)
+
+윗면 z 최대 가장자리. 기둥 40×1100×40 되풀이, 손잡이 = 발판 X × 40 × 40, 1100 높이.

package/recipes/handrail/guide.en.md

@@ -0,0 +1,18 @@
+## When to use it
+
+For a rail along the edge of a deck or a landing.
+
+## Putting it in
+
+1. Choose the deck; the rail runs along the front edge of its **top**.
+2. Set the **post pitch** in mm.
+3. Press "put in".
+
+## Afterwards
+
+- A longer deck gets more posts and a longer rail.
+- The parts are ordinary parts: change them one by one, or take them all out with one undo.
+
+## Good to know
+
+- The rail is 1100 mm high.

package/recipes/handrail/guide.ko.md

@@ -0,0 +1,18 @@
+## 언제 쓰나
+
+발판이나 계단참 가장자리에 난간을 세울 때 씁니다.
+
+## 넣는 순서
+
+1. 발판을 고릅니다. 난간은 **윗면 앞쪽 가장자리**를 따라 섭니다.
+2. **기둥 간격**을 mm로 정합니다.
+3. 「넣기」를 누릅니다.
+
+## 넣은 뒤
+
+- 발판이 길어지면 기둥이 더 들어가고 손잡이가 늘어납니다.
+- 넣은 부품은 보통 부품이라 하나씩 고칠 수 있고, 되돌리기 한 번에 모두 빠집니다.
+
+## 알아 둘 것
+
+- 난간 높이는 1100 mm입니다.

package/recipes/handrail/models/default.json

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