@things-factory/figure-service 10.1.69 → 10.1.71

package/recipes/roll-up-shutter/recipe.json

@@ -0,0 +1,200 @@
+{
+  "name": "roll-up-shutter",
+  "title": {
+    "ko": "롤업 셔터",
+    "en": "roll-up shutter"
+  },
+  "description": {
+    "ko": "고른 부품의 앞면에 셔터 박스와 커튼을 넣습니다. 조작값으로 커튼이 박스 쪽으로 올라갑니다.",
+    "en": "A shutter box and curtain on the chosen part's front; a control raises the curtain into the box."
+  },
+  "category": "door",
+  "tags": [
+    "shutter",
+    "roll-up",
+    "door"
+  ],
+  "target": "part",
+  "params": [
+    {
+      "name": "share",
+      "kind": "ratio",
+      "default": 0.4,
+      "label": {
+        "ko": "셔터 폭 (부품 폭에 대해)",
+        "en": "shutter width (of the part's)"
+      },
+      "hint": {
+        "ko": "고른 부품 폭에 대한 셔터 폭",
+        "en": "the shutter's width as a share of the part's"
+      },
+      "min": 0.1,
+      "max": 0.95
+    },
+    {
+      "name": "height",
+      "kind": "ratio",
+      "default": 0.8,
+      "label": {
+        "ko": "셔터 높이 (부품 높이에 대해)",
+        "en": "shutter height (of the part's)"
+      },
+      "hint": {
+        "ko": "고른 부품 높이에 대한 커튼 높이",
+        "en": "the curtain's height as a share of the part's"
+      },
+      "min": 0.3,
+      "max": 0.95
+    }
+  ],
+  "steps": [
+    {
+      "kind": "add-part",
+      "part": {
+        "id": "{id}-curtain",
+        "kind": "box",
+        "dimensions": {
+          "width": 1600,
+          "height": 2400,
+          "depth": 30
+        }
+      }
+    },
+    {
+      "kind": "add-part",
+      "part": {
+        "id": "{id}-housing",
+        "kind": "box",
+        "dimensions": {
+          "width": 1700,
+          "height": 350,
+          "depth": 350
+        }
+      }
+    },
+    {
+      "kind": "link-dimension",
+      "part": "{id}-curtain",
+      "axis": "x",
+      "source": {
+        "of": "part",
+        "part": "{target}",
+        "axis": "x"
+      },
+      "times": {
+        "param": "share"
+      },
+      "narrowRange": true
+    },
+    {
+      "kind": "link-dimension",
+      "part": "{id}-curtain",
+      "axis": "y",
+      "source": {
+        "of": "part",
+        "part": "{target}",
+        "axis": "y"
+      },
+      "times": {
+        "param": "height"
+      },
+      "narrowRange": true
+    },
+    {
+      "kind": "link-dimension",
+      "part": "{id}-housing",
+      "axis": "x",
+      "source": {
+        "of": "part",
+        "part": "{id}-curtain",
+        "axis": "x"
+      },
+      "plus": 100,
+      "narrowRange": true
+    },
+    {
+      "kind": "set-joint",
+      "joint": {
+        "id": "{id}-curtain",
+        "type": "prismatic",
+        "body0": {
+          "part": "{target}",
+          "face": "front"
+        },
+        "body1": {
+          "part": "{id}-curtain",
+          "face": "back"
+        },
+        "origin": {
+          "align": {
+            "y": "min"
+          }
+        },
+        "axis": "Y",
+        "lowerLimit": 0,
+        "upperLimit": 1,
+        "travel": {
+          "source": {
+            "of": "part",
+            "part": "{id}-curtain",
+            "axis": "y"
+          },
+          "times": 0.95
+        },
+        "state": {
+          "id": "{id}-open"
+        }
+      }
+    },
+    {
+      "kind": "set-joint",
+      "joint": {
+        "id": "{id}-housing",
+        "type": "fixed",
+        "body0": {
+          "part": "{target}",
+          "face": "front"
+        },
+        "body1": {
+          "part": "{id}-housing",
+          "face": "back"
+        },
+        "origin": {
+          "align": {
+            "y": {
+              "mm": {
+                "from": {
+                  "of": "part",
+                  "part": "{target}",
+                  "axis": "y"
+                },
+                "times": 0.3,
+                "plus": 175
+              }
+            }
+          }
+        }
+      }
+    },
+    {
+      "kind": "set-material",
+      "target": "{id}-curtain",
+      "material": {
+        "token": "palette.tpl-8a9aa9"
+      },
+      "palette": {
+        "palette.tpl-8a9aa9": "#8a9aa9"
+      }
+    },
+    {
+      "kind": "set-material",
+      "target": "{id}-housing",
+      "material": {
+        "token": "palette.tpl-5d6d7e"
+      },
+      "palette": {
+        "palette.tpl-5d6d7e": "#5d6d7e"
+      }
+    }
+  ]
+}

package/recipes/roll-up-shutter/spec.json

@@ -0,0 +1,69 @@
+{
+  "name": "roll-up-shutter",
+  "category": "door",
+  "tags": [
+    "shutter",
+    "roll-up",
+    "door"
+  ],
+  "title": {
+    "ko": "롤업 셔터",
+    "en": "roll-up shutter"
+  },
+  "description": {
+    "ko": "고른 부품의 앞면에 셔터 박스와 커튼을 넣습니다. 조작값으로 커튼이 박스 쪽으로 올라갑니다.",
+    "en": "A shutter box and curtain on the chosen part's front; a control raises the curtain into the box."
+  },
+  "params": [
+    {
+      "name": "share",
+      "kind": "ratio",
+      "default": 0.4,
+      "label": {
+        "ko": "셔터 폭 (부품 폭에 대해)",
+        "en": "shutter width (of the part's)"
+      },
+      "hint": {
+        "ko": "고른 부품 폭에 대한 셔터 폭",
+        "en": "the shutter's width as a share of the part's"
+      },
+      "min": 0.1,
+      "max": 0.95,
+      "bind": [
+        {
+          "step": {
+            "kind": "link-dimension",
+            "part": "{id}-curtain",
+            "axis": "x"
+          },
+          "path": "times"
+        }
+      ]
+    },
+    {
+      "name": "height",
+      "kind": "ratio",
+      "default": 0.8,
+      "label": {
+        "ko": "셔터 높이 (부품 높이에 대해)",
+        "en": "shutter height (of the part's)"
+      },
+      "hint": {
+        "ko": "고른 부품 높이에 대한 커튼 높이",
+        "en": "the curtain's height as a share of the part's"
+      },
+      "min": 0.3,
+      "max": 0.95,
+      "bind": [
+        {
+          "step": {
+            "kind": "link-dimension",
+            "part": "{id}-curtain",
+            "axis": "y"
+          },
+          "path": "times"
+        }
+      ]
+    }
+  ]
+}

package/recipes/roller-row/build.mts

@@ -0,0 +1,18 @@
+/* 롤러 줄 — the model: rollers across the host's depth on its top, as many as fit along its length at the pitch, all spinning on one control. */
+import { host, Model } from '../_lib/model.mts'
+
+export default function build() {
+  const m = new Model(host({ x: 3000, y: 700, z: 800 }, 'TPL_ROLLER_ROW'))
+  m.add({ id: 'roller', kind: 'cylinder', dimensions: { radius: 30, length: 720 }, rotation: { x: 90, y: 0, z: 0 } } as never)
+    .follow('roller', 'y', 'host', 'z', 0.9)
+    /* By its centre, a radius above the top: it spins in place (ADR-0093, 2026-09-26). */
+    .do({ kind: 'attach', part: 'roller', face: 'centre', to: { part: 'host', face: 'top' }, gap: 30 } as never)
+    .moves('roller', { type: 'revolute', axis: 'Z', lower: -360, upper: 360, state: 'spin' })
+    /* A stripe along each roller, so its turning shows: a plain cylinder looks the same at any angle. */
+    .box('stripe', 12, 20, 720)
+    .follow('stripe', 'z', 'roller', 'y')
+    .on('stripe', 'right', 'roller', 'left')
+    .colour('stripe', 'stripe', '#2f3437')
+    .do({ kind: 'make-repeat', part: 'roller', axis: 'x', pitch: 200, narrowRange: true })
+  return m.asset
+}

package/recipes/roller-row/facts.md

@@ -0,0 +1,20 @@
+# roller-row — facts (not shown on screen; input for the guide writer and our review)
+
+
+고른 부품의 윗면에 롤러를 한 줄로 깝니다.
+
+## 넣는 것
+- 부품의 폭을 가로지르는 롤러. 부품 길이를 따라 간격마다 들어가고, 부품이 길어지면 롤러 수도 늘어납니다.
+
+## 고르는 값
+- 롤러 간격 (mm)
+- 롤러 반지름 (mm)
+
+## 붙는 면 · 따라가는 크기
+- 고른 부품의 윗면(top)에, 부품의 X 방향으로 한 줄.
+- 롤러 길이 = 고른 부품 깊이(Z) × 0.9. 롤러 수 = 부품 길이에 간격마다 들어가는 만큼(최대 100개).
+- 롤러는 가운데(centre)로 붙고 틈 = 반지름이라 윗면에 얹힌다. 회전 Z −360~360, 조작값 spin 하나로 모든 복제가 돈다. 줄무늬 12×20 이 롤러 left 면에 붙어 복제마다 따라온다(ADR-0093 2026-09-26).
+
+## 알려진 한계
+- 롤러는 X 방향으로만 줄을 선다.
+- 한 줄 100개를 넘는 길이에서는 그릴 수 없어, 도형의 가장 큰 크기가 줄어든다.

package/recipes/roller-row/guide.en.md

@@ -0,0 +1,21 @@
+## When to use it
+
+For equipment with a row of rollers on top -- a roller conveyor, a lift table, a tilt tray. A longer part holds more rollers on its own.
+
+## Putting it in
+
+1. Choose the part (the conveyor body) the rollers go on. They lie on its **top**, in a row along its length (X).
+2. Set the **pitch** in mm; a smaller pitch means more rollers.
+3. Set the **roller radius**.
+4. Press "put in".
+
+## Afterwards
+
+- Each roller is 90% of the part's width (Z) long, and follows it.
+- Changing the part's length changes how many rollers fit at the pitch.
+- One **spin** control turns every roller in place, from −360° to 360°. Link it to a live value to show the conveyor running.
+
+## Good to know
+
+- Each roller carries a dark stripe, so its turning shows.
+- A row holds at most 100 rollers; beyond that length the figure's largest size is lowered.

package/recipes/roller-row/guide.ko.md

@@ -0,0 +1,21 @@
+## 언제 쓰나
+
+롤러 컨베이어, 리프트 테이블, 틸트 트레이처럼 윗면에 롤러가 줄지어 있는 설비를 만들 때 씁니다. 부품이 길어지면 롤러가 저절로 더 들어갑니다.
+
+## 넣는 순서
+
+1. 롤러를 깔 부품(컨베이어 몸체)을 고릅니다. 롤러는 그 부품의 **윗면**에, 부품의 길이(X) 방향으로 줄지어 놓입니다.
+2. **롤러 간격**을 mm로 정합니다. 간격이 좁을수록 롤러가 많아집니다.
+3. **롤러 반지름**을 정합니다.
+4. 「넣기」를 누릅니다.
+
+## 넣은 뒤
+
+- 롤러 길이는 부품 폭(Z)의 90%입니다. 부품 폭을 바꾸면 롤러도 따라 길어집니다.
+- 부품 길이를 바꾸면 간격에 맞게 롤러 수가 바뀝니다.
+- **회전** 조작값 하나로 모든 롤러가 제자리에서 −360°~360° 돕니다. 라이브 값에 이으면 컨베이어가 도는 것을 보일 수 있습니다.
+
+## 알아 둘 것
+
+- 롤러마다 짙은 줄무늬가 있어 도는 것이 보입니다.
+- 한 줄에 100개까지 놓입니다. 그보다 길어지는 크기에서는 도형의 가장 큰 크기가 줄어듭니다.

package/recipes/roller-row/models/default.json

@@ -0,0 +1 @@
+{"version":"figure-v3-asset-1","name":"TPL_ROLLER_ROW","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":"roller.dimension.radius","unit":"mm","min":0,"max":1.7976931348623157e+308,"role":"design"},{"id":"stripe.dimension.width","unit":"mm","min":0,"max":1.7976931348623157e+308,"role":"design"},{"id":"stripe.dimension.height","unit":"mm","min":0,"max":1.7976931348623157e+308,"role":"design"},{"id":"spin","unit":"deg","min":-360,"max":360,"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_9","unit":"ratio","value":0.9},{"id":"a.deg.90","unit":"deg","value":90},{"id":"d.mm.30","unit":"mm","value":30},{"id":"axis.ratio.0","unit":"ratio","value":0},{"id":"a.deg._90","unit":"deg","value":-90},{"id":"k.ratio._1","unit":"ratio","value":-1},{"id":"k.ratio._0_5","unit":"ratio","value":-0.5},{"id":"limit.count.100","unit":"count","value":100},{"id":"d.mm.200","unit":"mm","value":200}],"nodes":[{"id":"host.shape","op":"box-shape@1","args":["host.size.x","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":"roller.shape","op":"cylinder-shape@1","args":["roller.dimension.radius","roller.dimension.y.value"],"outputs":{"shape":"roller.shapeValue"},"params":{"frame":"roller.local"}},{"id":"roller.pose","op":"rigid@1","args":["d.mm.0","d.mm.0","d.mm.0","a.deg.90","a.deg.0","a.deg.0"],"outputs":{"pose":"roller.poseValue"},"params":{"from":"roller.local","to":"roller.seat"}},{"id":"roller","op":"member@1","args":["roller.shapeValue","roller.turned.value"],"outputs":{"placed":"roller.placed"}},{"id":"roller.dimension.y","op":"mul@1","args":["roller.y.follows.times.value","k.ratio.1"],"outputs":{"value":"roller.dimension.y.value"}},{"id":"host.dimension.z","op":"mul@1","args":["host.size.z","k.ratio.1"],"outputs":{"value":"host.dimension.z.value"}},{"id":"roller.y.follows.times","op":"mul@1","args":["host.dimension.z.value","k.ratio.0_9"],"outputs":{"value":"roller.y.follows.times.value"}},{"id":"stripe.shape","op":"box-shape@1","args":["stripe.dimension.width","stripe.dimension.height","stripe.dimension.z.value"],"outputs":{"shape":"stripe.shapeValue"},"params":{"frame":"stripe.local"}},{"id":"stripe.pose","op":"rigid@1","args":["stripe.on.roller.along.x.1.sum.value","d.mm.0","d.mm.0","a.deg._90","a.deg.0","a.deg.0"],"outputs":{"pose":"stripe.poseValue"},"params":{"from":"stripe.local","to":"stripe.seat"}},{"id":"stripe","op":"member@1","args":["stripe.shapeValue","stripe.world.value"],"outputs":{"placed":"stripe.placed"}},{"id":"stripe.dimension.z","op":"mul@1","args":["roller.dimension.y.value","k.ratio.1"],"outputs":{"value":"stripe.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":"roller.on.host.seat.y.0.times","op":"mul@1","args":["host.size.y","k.ratio.0_5"],"outputs":{"value":"roller.on.host.seat.y.0.times.value"}},{"id":"roller.on.host.seat.y.1.sum","op":"add@1","args":["roller.on.host.seat.y.0.times.value","d.mm.30"],"outputs":{"value":"roller.on.host.seat.y.1.sum.value"}},{"id":"roller.seat.rigid","op":"rigid@1","args":["roller.row.start.0.times.value","roller.on.host.seat.y.1.sum.value","d.mm.0","a.deg.0","a.deg.0","a.deg.0"],"outputs":{"pose":"roller.seat.value"},"params":{"from":"roller.joint","to":"host.local"}},{"id":"roller.motion","op":"axis-turn@1","args":["axis.ratio.0","axis.ratio.0","k.ratio.1","spin"],"outputs":{"pose":"roller.motion.value"},"params":{"from":"roller.seat","to":"roller.joint"}},{"id":"roller.turned","op":"compose@1","args":["roller.motion.value","roller.poseValue"],"outputs":{"pose":"roller.turned.value"}},{"id":"roller.row.start.0.times","op":"mul@1","args":["host.size.x","k.ratio._0_5"],"outputs":{"value":"roller.row.start.0.times.value"}},{"id":"roller.row.length.0.times","op":"mul@1","args":["host.size.x","k.ratio.0_5"],"outputs":{"value":"roller.row.length.0.times.value"}},{"id":"roller.row.length.1.times","op":"mul@1","args":["host.size.x","k.ratio.0_5"],"outputs":{"value":"roller.row.length.1.times.value"}},{"id":"roller.row.length.1.sum","op":"add@1","args":["roller.row.length.0.times.value","roller.row.length.1.times.value"],"outputs":{"value":"roller.row.length.1.sum.value"}},{"id":"roller.row.extent.1.sum","op":"add@1","args":["roller.dimension.radius","roller.dimension.radius"],"outputs":{"value":"roller.row.extent.1.sum.value"}},{"id":"roller.layout","op":"fit-pitch@1","args":["roller.row.length.1.sum.value","d.mm.0","d.mm.0","roller.row.extent.1.sum.value","d.mm.200","k.ratio.0_5","limit.count.100"],"outputs":{"layout":"roller.layout.value"}},{"id":"roller.assembly","op":"assembly@1","args":["roller.placed","stripe.placed"],"outputs":{"assembly":"roller.assembly.value"}},{"id":"roller.row","op":"compose@1","args":["host.chain.value","roller.seat.value"],"outputs":{"pose":"roller.row.value"}},{"id":"roller.repeat","op":"repeat@1","args":["roller.layout.value","roller.assembly.value","roller.row.value"],"outputs":{"collection":"roller.repeat.value"},"params":{"axis":"x"}},{"id":"stripe.on.roller.seat.x.0.times","op":"mul@1","args":["roller.dimension.radius","k.ratio._1"],"outputs":{"value":"stripe.on.roller.seat.x.0.times.value"}},{"id":"stripe.on.roller.along.x.0.times","op":"mul@1","args":["stripe.dimension.width","k.ratio._0_5"],"outputs":{"value":"stripe.on.roller.along.x.0.times.value"}},{"id":"stripe.on.roller.along.x.1.times","op":"mul@1","args":["d.mm.0","k.ratio._1"],"outputs":{"value":"stripe.on.roller.along.x.1.times.value"}},{"id":"stripe.on.roller.along.x.1.sum","op":"add@1","args":["stripe.on.roller.along.x.0.times.value","stripe.on.roller.along.x.1.times.value"],"outputs":{"value":"stripe.on.roller.along.x.1.sum.value"}},{"id":"stripe.seat.rigid","op":"rigid@1","args":["stripe.on.roller.seat.x.0.times.value","d.mm.0","d.mm.0","a.deg.0","a.deg.0","a.deg.0"],"outputs":{"pose":"stripe.seat.value"},"params":{"from":"stripe.seat","to":"roller.local"}},{"id":"stripe.chain","op":"compose@1","args":["stripe.seat.value","stripe.poseValue"],"outputs":{"pose":"stripe.chain.value"}},{"id":"stripe.world","op":"compose@1","args":["roller.turned.value","stripe.chain.value"],"outputs":{"pose":"stripe.world.value"}}]},"capabilities":{"version":"r3-capability-3","assetFrame":"asset","bindings":[]}},"designInputs":{"host.size.x":3000,"host.size.y":700,"host.size.z":800,"roller.dimension.radius":30,"stripe.dimension.width":12,"stripe.dimension.height":20},"stateDefaults":{"spin":0},"palette":{"palette.primary":"#477b9e","palette.host":"#d9dde2","palette.tpl-2f3437":"#2f3437"},"appearance":[{"target":"host","material":{"token":"palette.host"}},{"target":"roller","material":{"token":"palette.primary"},"segments":12},{"target":"stripe","material":{"token":"palette.tpl-2f3437"}}],"joints":[{"id":"host","type":"fixed","body0":{"plane":"mounting-plane"},"body1":{"part":"host","face":"bottom"},"origin":{}},{"id":"stripe","type":"fixed","body0":{"part":"roller","face":"left"},"body1":{"part":"stripe","face":"right"},"origin":{}},{"id":"roller","type":"revolute","body0":{"part":"host","face":"top"},"body1":{"part":"roller","face":"centre"},"origin":{"gap":30,"turn":{"x":90,"y":0,"z":0}},"axis":"Z","lowerLimit":-360,"upperLimit":360,"state":{"id":"spin"},"repeat":{"axis":"X","pitch":200}}]}

package/recipes/roller-row/recipe.json

@@ -0,0 +1,179 @@
+{
+  "name": "roller-row",
+  "title": {
+    "ko": "롤러 줄",
+    "en": "roller row"
+  },
+  "description": {
+    "ko": "고른 부품(컨베이어 몸체) 윗면에 롤러를 줄지어 놓습니다. 롤러 수는 부품 길이를 따르고, 조작값 하나로 모든 롤러가 돕니다.",
+    "en": "Rollers in a row on the chosen part's top (a conveyor body); their number follows its length, and one control spins them all."
+  },
+  "category": "conveyor",
+  "tags": [
+    "roller",
+    "conveyor",
+    "row"
+  ],
+  "target": "part",
+  "params": [
+    {
+      "name": "pitch",
+      "kind": "mm",
+      "default": 200,
+      "min": 20,
+      "max": 2000,
+      "label": {
+        "ko": "롤러 간격 (mm)",
+        "en": "pitch (mm)"
+      },
+      "hint": {
+        "ko": "롤러 사이 거리. 부품이 길면 롤러가 늘어난다",
+        "en": "the distance between rollers; a longer part holds more"
+      }
+    },
+    {
+      "name": "radius",
+      "kind": "mm",
+      "default": 30,
+      "min": 5,
+      "max": 500,
+      "label": {
+        "ko": "롤러 반지름 (mm)",
+        "en": "roller radius (mm)"
+      },
+      "hint": {
+        "ko": "롤러 굵기",
+        "en": "how thick each roller is"
+      }
+    }
+  ],
+  "steps": [
+    {
+      "kind": "add-part",
+      "part": {
+        "id": "{id}-roller",
+        "kind": "cylinder",
+        "dimensions": {
+          "radius": {
+            "param": "radius"
+          },
+          "length": 720
+        }
+      }
+    },
+    {
+      "kind": "add-part",
+      "part": {
+        "id": "{id}-stripe",
+        "kind": "box",
+        "dimensions": {
+          "width": 12,
+          "height": 20,
+          "depth": 720
+        }
+      }
+    },
+    {
+      "kind": "link-dimension",
+      "part": "{id}-roller",
+      "axis": "y",
+      "source": {
+        "of": "part",
+        "part": "{target}",
+        "axis": "z"
+      },
+      "times": 0.9,
+      "narrowRange": true
+    },
+    {
+      "kind": "link-dimension",
+      "part": "{id}-stripe",
+      "axis": "z",
+      "source": {
+        "of": "part",
+        "part": "{id}-roller",
+        "axis": "y"
+      },
+      "narrowRange": true
+    },
+    {
+      "kind": "set-joint",
+      "joint": {
+        "id": "{id}-roller",
+        "type": "revolute",
+        "body0": {
+          "part": "{target}",
+          "face": "top"
+        },
+        "body1": {
+          "part": "{id}-roller",
+          "face": "centre"
+        },
+        "origin": {
+          "gap": {
+            "param": "radius"
+          },
+          "turn": {
+            "x": 90,
+            "y": 0,
+            "z": 0
+          }
+        },
+        "axis": "Z",
+        "lowerLimit": -360,
+        "upperLimit": 360,
+        "state": {
+          "id": "{id}-spin"
+        },
+        "repeat": {
+          "axis": "X",
+          "pitch": {
+            "param": "pitch"
+          }
+        }
+      },
+      "narrowRange": true
+    },
+    {
+      "kind": "set-joint",
+      "joint": {
+        "id": "{id}-stripe",
+        "type": "fixed",
+        "body0": {
+          "part": "{id}-roller",
+          "face": "left"
+        },
+        "body1": {
+          "part": "{id}-stripe",
+          "face": "right"
+        },
+        "origin": {}
+      }
+    },
+    {
+      "kind": "set-material",
+      "target": "{id}-roller",
+      "material": {
+        "token": "palette.primary"
+      },
+      "palette": {
+        "palette.primary": "#477b9e"
+      }
+    },
+    {
+      "kind": "set-segments",
+      "target": "{id}-roller",
+      "segments": 12
+    },
+    {
+      "kind": "set-material",
+      "target": "{id}-stripe",
+      "material": {
+        "token": "palette.tpl-2f3437"
+      },
+      "palette": {
+        "palette.tpl-2f3437": "#2f3437"
+      }
+    }
+  ]
+}

package/recipes/roller-row/spec.json

@@ -0,0 +1,80 @@
+{
+  "name": "roller-row",
+  "category": "conveyor",
+  "tags": [
+    "roller",
+    "conveyor",
+    "row"
+  ],
+  "title": {
+    "ko": "롤러 줄",
+    "en": "roller row"
+  },
+  "description": {
+    "ko": "고른 부품(컨베이어 몸체) 윗면에 롤러를 줄지어 놓습니다. 롤러 수는 부품 길이를 따르고, 조작값 하나로 모든 롤러가 돕니다.",
+    "en": "Rollers in a row on the chosen part's top (a conveyor body); their number follows its length, and one control spins them all."
+  },
+  "params": [
+    {
+      "name": "pitch",
+      "kind": "mm",
+      "default": 200,
+      "min": 20,
+      "max": 2000,
+      "label": {
+        "ko": "롤러 간격 (mm)",
+        "en": "pitch (mm)"
+      },
+      "hint": {
+        "ko": "롤러 사이 거리. 부품이 길면 롤러가 늘어난다",
+        "en": "the distance between rollers; a longer part holds more"
+      },
+      "bind": [
+        {
+          "step": {
+            "kind": "set-joint",
+            "joint": {
+              "id": "{id}-roller"
+            }
+          },
+          "path": "joint.repeat.pitch"
+        }
+      ]
+    },
+    {
+      "name": "radius",
+      "kind": "mm",
+      "default": 30,
+      "min": 5,
+      "max": 500,
+      "label": {
+        "ko": "롤러 반지름 (mm)",
+        "en": "roller radius (mm)"
+      },
+      "hint": {
+        "ko": "롤러 굵기",
+        "en": "how thick each roller is"
+      },
+      "bind": [
+        {
+          "step": {
+            "kind": "add-part",
+            "part": {
+              "id": "{id}-roller"
+            }
+          },
+          "path": "part.dimensions.radius"
+        },
+        {
+          "step": {
+            "kind": "set-joint",
+            "joint": {
+              "id": "{id}-roller"
+            }
+          },
+          "path": "joint.origin.gap"
+        }
+      ]
+    }
+  ]
+}

package/recipes/room-shell/build.mts

@@ -0,0 +1,16 @@
+/* 방 벽체 — the model. */
+import { host, Model } from '../_lib/model.mts'
+
+export default function build() {
+  const m = new Model(host({ x: 6000, y: 50, z: 4000 }, 'TPL_ROOM_SHELL'))
+  for (const [w, z] of [['wall-front', 'max'], ['wall-back', 'min']] as const)
+    m.box(w, 6000, 3000, 100).follow(w, 'x', 'host', 'x').on(w, 'bottom', 'host', 'top', { z }).colour(w, 'room-wall', '#9fb0c0')
+  for (const [w, x] of [['wall-left', 'min'], ['wall-right', 'max']] as const)
+    m.box(w, 100, 3000, 3800).follow(w, 'z', 'host', 'z', 1, -200).on(w, 'bottom', 'host', 'top', { x }).colour(w, 'room-wall', '#9fb0c0')
+  m.box('ceiling', 6000, 50, 4000)
+    .follow('ceiling', 'x', 'host', 'x')
+    .follow('ceiling', 'z', 'host', 'z')
+    .on('ceiling', 'bottom', 'host', 'top', undefined, 3000)
+    .edit({ kind: 'set-material', target: 'ceiling', material: { token: 'palette.tpl-dfe4e8', transparent: true }, palette: { 'palette.tpl-dfe4e8': '#dfe4e8' } } as never)
+  return m.asset
+}

package/recipes/room-shell/facts.md

@@ -0,0 +1,3 @@
+# room-shell — facts (not shown on screen; the guide's basis and our review)
+
+윗면. 앞뒤 벽 X = 바닥 X, 좌우 벽 Z = 바닥 Z − 200, 두께 100. 천장 X·Z = 바닥, 윗면에서 벽 높이만큼 띄움, 반투명. 높이 2000~10000.