@things-factory/figure-service 10.1.70 → 10.1.72

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@things-factory/figure-service",
-  "version": "10.1.70",
+  "version": "10.1.72",
   "publishConfig": {
     "access": "public",
     "@things-factory:registry": "https://registry.npmjs.org"
@@ -20,10 +20,12 @@
     "build:server": "npm run clean:server && tsc",
     "clean:server": "rm -rf dist-server",
     "clean": "npm run clean:server",
-    "migration:create": "node ../../node_modules/typeorm/cli.js migration:create ./server/migrations/migration"
+    "migration:create": "node ../../node_modules/typeorm/cli.js migration:create ./server/migrations/migration",
+    "build:templates": "node scripts/build-templates.mts",
+    "test:templates": "node --test scripts/templates.test.mts"
   },
   "dependencies": {
-    "@hatiolab/figure-model": "^0.1.82",
+    "@hatiolab/figure-model": "^0.1.87",
     "@operato/typeorm-history": "^10.0.0",
     "@things-factory/ai-client-base": "^10.1.53",
     "@things-factory/auth-base": "^10.1.47",
@@ -33,5 +35,5 @@
     "graphql-upload": "^15.0.2",
     "koa-router": "^7.4.0"
   },
-  "gitHead": "7c9c614b0cb1d02d401211db76ec0ca0ead344af"
+  "gitHead": "fdf6d4faac454dbdca62d8fe7409395dff1ada22"
 }

package/recipes/_lib/model.mts

@@ -0,0 +1,71 @@
+/*
+ * What a template's model is built with (ADR-0095 amended: model first). A model is a figure: a `host` box standing
+ * for the part the template is put onto, and the template's parts fastened to it, made with the modeller's own commands.
+ */
+import { addV3Box, addV3Primitive, applyV3Authoring, createV3Asset, editV3Part } from '@hatiolab/figure-model'
+import type { V3Asset, V3AuthoringAction, V3PartEdit, V3PrimitiveCreation } from '@hatiolab/figure-model'
+
+export type Values = Record<string, number | string | boolean>
+
+/** A model's host: a box of this size on the floor. */
+export function host(size: { x: number; y: number; z: number }, name = 'Template model', gap = 0): V3Asset {
+  const asset = addV3Box(createV3Asset(name), { id: 'host', size, position: { x: 0, y: size.y / 2, z: 0 } })
+  /* The host is only where the template goes: drawn pale, so the template's own parts stand out in the model and its picture. */
+  const pale = editV3Part(asset, { kind: 'set-material', target: 'host', material: { token: 'palette.host' }, palette: { 'palette.host': '#d9dde2' } } as V3PartEdit)
+  return applyV3Authoring(pale, { kind: 'attach', part: 'host', face: 'bottom', to: { plane: 'mounting-plane' }, ...(gap ? { gap } : {}) })
+}
+
+/** A small builder over the modeller's commands: each call one command, as a person's step would be. */
+export class Model {
+  asset: V3Asset
+  constructor(asset: V3Asset) {
+    this.asset = asset
+  }
+  add(part: V3PrimitiveCreation): this {
+    this.asset = addV3Primitive(this.asset, { position: { x: 0, y: 0, z: 0 }, ...part } as V3PrimitiveCreation)
+    return this
+  }
+  box(id: string, width: number, height: number, depth: number): this {
+    return this.add({ id, kind: 'box', dimensions: { width, height, depth } } as V3PrimitiveCreation)
+  }
+  do(action: V3AuthoringAction): this {
+    this.asset = applyV3Authoring(this.asset, action)
+    return this
+  }
+  edit(edit: V3PartEdit): this {
+    this.asset = editV3Part(this.asset, edit)
+    return this
+  }
+  /** Fasten a part's face to another's (or the host's) face; `align` places it across that face. */
+  on(part: string, face: string, to: string, toFace: string, align?: Record<string, unknown>, gap?: number): this {
+    return this.do({ kind: 'attach', part, face, to: { part: to, face: toFace }, ...(align ? { align } : {}), ...(gap ? { gap } : {}) } as V3AuthoringAction)
+  }
+  /**
+   * A part's colour. The palette is the figure's, shared by every template put into it: a token named for its value
+   * (`palette.tpl-5c7c96`) means two templates never recolour each other's parts. The name given says what it is for.
+   */
+  colour(part: string, _for: string, value: string, glow = false): this {
+    const token = `palette.tpl-${value.replace('#', '').toLowerCase()}`
+    return this.edit({ kind: 'set-material', target: part, material: { token, ...(glow ? { emissive: { on: true, token, intensity: 1 } } : {}) }, palette: { [token]: value } } as V3PartEdit)
+  }
+  /** A moving joint on a part already fastened: its record as it is, made to slide or turn on a control. */
+  moves(part: string, motion: { type: 'prismatic' | 'revolute'; axis: 'X' | 'Y' | 'Z'; lower?: number; upper?: number; state?: string; mimic?: { joint: string; multiplier: number } }): this {
+    const joint = this.asset.joints!.find(j => j.body1.part === part)!
+    return this.do({
+      kind: 'set-joint',
+      joint: {
+        ...joint,
+        type: motion.type,
+        axis: motion.axis,
+        ...(motion.lower !== undefined ? { lowerLimit: motion.lower } : {}),
+        ...(motion.upper !== undefined ? { upperLimit: motion.upper } : {}),
+        ...(motion.state ? { state: { id: motion.state } } : {}),
+        ...(motion.mimic ? { mimic: motion.mimic } : {})
+      }
+    } as V3AuthoringAction)
+  }
+  /** One measure following another part's, in a share (and a difference). */
+  follow(part: string, axis: 'x' | 'y' | 'z', of: string, ofAxis: 'x' | 'y' | 'z', times = 1, plus = 0): this {
+    return this.do({ kind: 'link-dimension', part, axis, source: { of: 'part', part: of, axis: ofAxis }, ...(times !== 1 ? { times } : {}), ...(plus ? { plus } : {}), narrowRange: true } as V3AuthoringAction)
+  }
+}

package/recipes/air-cylinder/build.mts

@@ -0,0 +1,14 @@
+/* 에어 실린더 — 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_AIR_CYLINDER'))
+  m.add({ id: 'body', kind: 'cylinder', dimensions: { radius: 40, length: 300 } } as never)
+    .on('body', 'bottom', 'host', 'top')
+    .colour('body', 'palette.rail', '#9aa3ab')
+    .add({ id: 'rod', kind: 'cylinder', dimensions: { radius: 12, length: 250 } } as never)
+    .on('rod', 'bottom', 'body', 'top')
+    .colour('rod', 'palette.rod', '#d0d4d8')
+    .moves('rod', { type: 'prismatic', axis: 'Y', lower: 0, upper: 200, state: 'extend' })
+  return m.asset
+}

package/recipes/air-cylinder/facts.md

@@ -0,0 +1,3 @@
+# air-cylinder — facts (not shown on screen; the guide's basis and our review)
+
+윗면 가운데. 몸통 r40×300, 로드 r12×250, 미끄러짐 Y 0~행정.

package/recipes/air-cylinder/guide.en.md

@@ -0,0 +1,18 @@
+## When to use it
+
+For an upright air cylinder that pushes up.
+
+## Putting it in
+
+1. Choose the body; the cylinder stands in the middle of its **top**.
+2. Set the **stroke** in mm.
+3. Press "put in".
+
+## Afterwards
+
+- The **extend** control pushes the rod up by the stroke.
+- The parts are ordinary parts: change them one by one, or take them all out with one undo.
+
+## Good to know
+
+- To lay it down, turn the parts after putting them in.

package/recipes/air-cylinder/guide.ko.md

@@ -0,0 +1,18 @@
+## 언제 쓰나
+
+밀어 올리는 에어 실린더를 세울 때 씁니다.
+
+## 넣는 순서
+
+1. 몸체를 고릅니다. 실린더는 **윗면 가운데**에 섭니다.
+2. **행정**을 mm로 정합니다.
+3. 「넣기」를 누릅니다.
+
+## 넣은 뒤
+
+- **뻗음** 조작값으로 로드가 행정만큼 올라옵니다.
+- 넣은 부품은 보통 부품이라 하나씩 고칠 수 있고, 되돌리기 한 번에 모두 빠집니다.
+
+## 알아 둘 것
+
+- 눕혀 쓰려면 넣은 뒤 부품을 돌립니다.

package/recipes/air-cylinder/models/default.json

@@ -0,0 +1 @@
+{"version":"figure-v3-asset-1","name":"TPL_AIR_CYLINDER","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":"body.dimension.radius","unit":"mm","min":0,"max":1.7976931348623157e+308,"role":"design"},{"id":"body.dimension.length","unit":"mm","min":0,"max":1.7976931348623157e+308,"role":"design"},{"id":"rod.dimension.radius","unit":"mm","min":0,"max":1.7976931348623157e+308,"role":"design"},{"id":"rod.dimension.length","unit":"mm","min":0,"max":1.7976931348623157e+308,"role":"design"},{"id":"extend","unit":"mm","min":0,"max":200,"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":"axis.ratio.0","unit":"ratio","value":0},{"id":"axis.ratio.1","unit":"ratio","value":1}],"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":"body.shape","op":"cylinder-shape@1","args":["body.dimension.radius","body.dimension.length"],"outputs":{"shape":"body.shapeValue"},"params":{"frame":"body.local"}},{"id":"body.pose","op":"rigid@1","args":["d.mm.0","body.on.host.along.y.1.sum.value","d.mm.0","a.deg.0","a.deg.0","a.deg.0"],"outputs":{"pose":"body.poseValue"},"params":{"from":"body.local","to":"body.seat"}},{"id":"body","op":"place@1","args":["body.shapeValue","body.world.value"],"outputs":{"placed":"body.placed"}},{"id":"rod.shape","op":"cylinder-shape@1","args":["rod.dimension.radius","rod.dimension.length"],"outputs":{"shape":"rod.shapeValue"},"params":{"frame":"rod.local"}},{"id":"rod.pose","op":"rigid@1","args":["d.mm.0","rod.on.body.along.y.1.sum.value","d.mm.0","a.deg.0","a.deg.0","a.deg.0"],"outputs":{"pose":"rod.poseValue"},"params":{"from":"rod.local","to":"rod.seat"}},{"id":"rod","op":"place@1","args":["rod.shapeValue","rod.world.value"],"outputs":{"placed":"rod.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.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":"body.on.host.seat.y.0.times","op":"mul@1","args":["host.size.y","k.ratio.0_5"],"outputs":{"value":"body.on.host.seat.y.0.times.value"}},{"id":"body.on.host.along.y.0.times","op":"mul@1","args":["body.dimension.length","k.ratio.0_5"],"outputs":{"value":"body.on.host.along.y.0.times.value"}},{"id":"body.on.host.along.y.1.sum","op":"add@1","args":["body.on.host.along.y.0.times.value","d.mm.0"],"outputs":{"value":"body.on.host.along.y.1.sum.value"}},{"id":"body.seat.rigid","op":"rigid@1","args":["d.mm.0","body.on.host.seat.y.0.times.value","d.mm.0","a.deg.0","a.deg.0","a.deg.0"],"outputs":{"pose":"body.seat.value"},"params":{"from":"body.seat","to":"host.local"}},{"id":"body.chain","op":"compose@1","args":["body.seat.value","body.poseValue"],"outputs":{"pose":"body.chain.value"}},{"id":"body.world","op":"compose@1","args":["host.chain.value","body.chain.value"],"outputs":{"pose":"body.world.value"}},{"id":"rod.on.body.seat.y.0.times","op":"mul@1","args":["body.dimension.length","k.ratio.0_5"],"outputs":{"value":"rod.on.body.seat.y.0.times.value"}},{"id":"rod.on.body.along.y.0.times","op":"mul@1","args":["rod.dimension.length","k.ratio.0_5"],"outputs":{"value":"rod.on.body.along.y.0.times.value"}},{"id":"rod.on.body.along.y.1.sum","op":"add@1","args":["rod.on.body.along.y.0.times.value","d.mm.0"],"outputs":{"value":"rod.on.body.along.y.1.sum.value"}},{"id":"rod.seat.rigid","op":"rigid@1","args":["d.mm.0","rod.on.body.seat.y.0.times.value","d.mm.0","a.deg.0","a.deg.0","a.deg.0"],"outputs":{"pose":"rod.seat.value"},"params":{"from":"rod.joint","to":"body.local"}},{"id":"rod.chain","op":"compose@1","args":["rod.seat.value","rod.turned.value"],"outputs":{"pose":"rod.chain.value"}},{"id":"rod.world","op":"compose@1","args":["body.world.value","rod.chain.value"],"outputs":{"pose":"rod.world.value"}},{"id":"rod.motion","op":"axis-slide@1","args":["axis.ratio.0","axis.ratio.1","axis.ratio.0","extend"],"outputs":{"pose":"rod.motion.value"},"params":{"from":"rod.seat","to":"rod.joint"}},{"id":"rod.turned","op":"compose@1","args":["rod.motion.value","rod.poseValue"],"outputs":{"pose":"rod.turned.value"}}]},"capabilities":{"version":"r3-capability-3","assetFrame":"asset","bindings":[]}},"designInputs":{"host.size.x":3000,"host.size.y":700,"host.size.z":800,"body.dimension.radius":40,"body.dimension.length":300,"rod.dimension.radius":12,"rod.dimension.length":250},"stateDefaults":{"extend":0},"palette":{"palette.primary":"#477b9e","palette.host":"#d9dde2","palette.tpl-9aa3ab":"#9aa3ab","palette.tpl-d0d4d8":"#d0d4d8"},"appearance":[{"target":"host","material":{"token":"palette.host"}},{"target":"body","material":{"token":"palette.tpl-9aa3ab"},"segments":12},{"target":"rod","material":{"token":"palette.tpl-d0d4d8"},"segments":12}],"joints":[{"id":"host","type":"fixed","body0":{"plane":"mounting-plane"},"body1":{"part":"host","face":"bottom"},"origin":{}},{"id":"body","type":"fixed","body0":{"part":"host","face":"top"},"body1":{"part":"body","face":"bottom"},"origin":{}},{"id":"rod","type":"prismatic","body0":{"part":"body","face":"top"},"body1":{"part":"rod","face":"bottom"},"origin":{},"axis":"Y","lowerLimit":0,"upperLimit":200,"state":{"id":"extend"}}]}

package/recipes/air-cylinder/recipe.json

@@ -0,0 +1,129 @@
+{
+  "name": "air-cylinder",
+  "title": {
+    "ko": "에어 실린더",
+    "en": "air cylinder"
+  },
+  "description": {
+    "ko": "고른 부품 윗면에 세운 에어 실린더를 넣습니다. 조작값으로 로드가 올라옵니다.",
+    "en": "An upright air cylinder on the chosen part's top; a control pushes the rod out."
+  },
+  "category": "handling",
+  "tags": [
+    "cylinder",
+    "pneumatic",
+    "actuator"
+  ],
+  "target": "part",
+  "params": [
+    {
+      "name": "stroke",
+      "kind": "mm",
+      "default": 200,
+      "label": {
+        "ko": "행정 (mm)",
+        "en": "stroke (mm)"
+      },
+      "hint": {
+        "ko": "로드가 나오는 길이",
+        "en": "how far the rod comes out"
+      },
+      "min": 20,
+      "max": 1000
+    }
+  ],
+  "steps": [
+    {
+      "kind": "add-part",
+      "part": {
+        "id": "{id}-body",
+        "kind": "cylinder",
+        "dimensions": {
+          "radius": 40,
+          "length": 300
+        }
+      }
+    },
+    {
+      "kind": "add-part",
+      "part": {
+        "id": "{id}-rod",
+        "kind": "cylinder",
+        "dimensions": {
+          "radius": 12,
+          "length": 250
+        }
+      }
+    },
+    {
+      "kind": "set-joint",
+      "joint": {
+        "id": "{id}-body",
+        "type": "fixed",
+        "body0": {
+          "part": "{target}",
+          "face": "top"
+        },
+        "body1": {
+          "part": "{id}-body",
+          "face": "bottom"
+        },
+        "origin": {}
+      }
+    },
+    {
+      "kind": "set-joint",
+      "joint": {
+        "id": "{id}-rod",
+        "type": "prismatic",
+        "body0": {
+          "part": "{id}-body",
+          "face": "top"
+        },
+        "body1": {
+          "part": "{id}-rod",
+          "face": "bottom"
+        },
+        "origin": {},
+        "axis": "Y",
+        "lowerLimit": 0,
+        "upperLimit": {
+          "param": "stroke"
+        },
+        "state": {
+          "id": "{id}-extend"
+        }
+      }
+    },
+    {
+      "kind": "set-material",
+      "target": "{id}-body",
+      "material": {
+        "token": "palette.tpl-9aa3ab"
+      },
+      "palette": {
+        "palette.tpl-9aa3ab": "#9aa3ab"
+      }
+    },
+    {
+      "kind": "set-segments",
+      "target": "{id}-body",
+      "segments": 12
+    },
+    {
+      "kind": "set-material",
+      "target": "{id}-rod",
+      "material": {
+        "token": "palette.tpl-d0d4d8"
+      },
+      "palette": {
+        "palette.tpl-d0d4d8": "#d0d4d8"
+      }
+    },
+    {
+      "kind": "set-segments",
+      "target": "{id}-rod",
+      "segments": 12
+    }
+  ]
+}

package/recipes/air-cylinder/spec.json

@@ -0,0 +1,45 @@
+{
+  "name": "air-cylinder",
+  "category": "handling",
+  "tags": [
+    "cylinder",
+    "pneumatic",
+    "actuator"
+  ],
+  "title": {
+    "ko": "에어 실린더",
+    "en": "air cylinder"
+  },
+  "description": {
+    "ko": "고른 부품 윗면에 세운 에어 실린더를 넣습니다. 조작값으로 로드가 올라옵니다.",
+    "en": "An upright air cylinder on the chosen part's top; a control pushes the rod out."
+  },
+  "params": [
+    {
+      "name": "stroke",
+      "kind": "mm",
+      "default": 200,
+      "label": {
+        "ko": "행정 (mm)",
+        "en": "stroke (mm)"
+      },
+      "hint": {
+        "ko": "로드가 나오는 길이",
+        "en": "how far the rod comes out"
+      },
+      "min": 20,
+      "max": 1000,
+      "bind": [
+        {
+          "step": {
+            "kind": "set-joint",
+            "joint": {
+              "id": "{id}-rod"
+            }
+          },
+          "path": "joint.upperLimit"
+        }
+      ]
+    }
+  ]
+}

package/recipes/air-shower/build.mts

@@ -0,0 +1,14 @@
+/* 에어샤워 부스 — the model. */
+import { host, Model } from '../_lib/model.mts'
+
+export default function build() {
+  const m = new Model(host({ x: 4000, y: 3000, z: 6000 }, 'TPL_AIR_SHOWER'))
+  m.box('booth', 1200, 2300, 1000)
+    .on('booth', 'back', 'host', 'front', { y: 'min' })
+    .colour('booth', 'booth', '#7f93a6')
+    .box('door', 800, 2000, 30)
+    .on('door', 'back', 'booth', 'front', { y: 'min' })
+    .colour('door', 'glass-door', '#7fb8d6')
+    .moves('door', { type: 'revolute', axis: 'Y', lower: -100, upper: 0, state: 'open' })
+  return m.asset
+}

package/recipes/air-shower/facts.md

@@ -0,0 +1,3 @@
+# air-shower — facts (not shown on screen; the guide's basis and our review)
+
+앞면 y 최소 가운데. 부스 1200×2300×1000, 문 800×2000×30, 회전 −100~0°.

package/recipes/air-shower/guide.en.md

@@ -0,0 +1,17 @@
+## When to use it
+
+For an air shower booth at a clean room's entrance.
+
+## Putting it in
+
+1. Choose the clean-room wall; the booth goes low in the middle of its **front**.
+2. Press "put in".
+
+## Afterwards
+
+- The **open** control swings the entrance door 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 booth's size is fixed.

package/recipes/air-shower/guide.ko.md

@@ -0,0 +1,17 @@
+## 언제 쓰나
+
+클린룸 입구에 에어샤워 부스를 붙일 때 씁니다.
+
+## 넣는 순서
+
+1. 클린룸 벽을 고릅니다. 부스는 **앞면 아래쪽 가운데**에 붙습니다.
+2. 「넣기」를 누릅니다.
+
+## 넣은 뒤
+
+- **열림** 조작값으로 입구 문이 100°까지 열립니다.
+- 넣은 부품은 보통 부품이라 하나씩 고칠 수 있고, 되돌리기 한 번에 모두 빠집니다.
+
+## 알아 둘 것
+
+- 부스 크기는 고정입니다.

package/recipes/air-shower/models/default.json

@@ -0,0 +1 @@
+{"version":"figure-v3-asset-1","name":"TPL_AIR_SHOWER","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":"booth.dimension.width","unit":"mm","min":0,"max":1.7976931348623157e+308,"role":"design"},{"id":"booth.dimension.height","unit":"mm","min":0,"max":1.7976931348623157e+308,"role":"design"},{"id":"booth.dimension.depth","unit":"mm","min":0,"max":1.7976931348623157e+308,"role":"design"},{"id":"door.dimension.width","unit":"mm","min":0,"max":1.7976931348623157e+308,"role":"design"},{"id":"door.dimension.height","unit":"mm","min":0,"max":1.7976931348623157e+308,"role":"design"},{"id":"door.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":"axis.ratio.0","unit":"ratio","value":0},{"id":"axis.ratio.1","unit":"ratio","value":1}],"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":"booth.shape","op":"box-shape@1","args":["booth.dimension.width","booth.dimension.height","booth.dimension.depth"],"outputs":{"shape":"booth.shapeValue"},"params":{"frame":"booth.local"}},{"id":"booth.pose","op":"rigid@1","args":["d.mm.0","booth.on.host.own-edge.y.0.times.value","booth.on.host.along.z.1.sum.value","a.deg.0","a.deg.0","a.deg.0"],"outputs":{"pose":"booth.poseValue"},"params":{"from":"booth.local","to":"booth.seat"}},{"id":"booth","op":"place@1","args":["booth.shapeValue","booth.world.value"],"outputs":{"placed":"booth.placed"}},{"id":"door.shape","op":"box-shape@1","args":["door.dimension.width","door.dimension.height","door.dimension.depth"],"outputs":{"shape":"door.shapeValue"},"params":{"frame":"door.local"}},{"id":"door.pose","op":"rigid@1","args":["d.mm.0","door.on.booth.own-edge.y.0.times.value","door.on.booth.along.z.1.sum.value","a.deg.0","a.deg.0","a.deg.0"],"outputs":{"pose":"door.poseValue"},"params":{"from":"door.local","to":"door.seat"}},{"id":"door","op":"place@1","args":["door.shapeValue","door.world.value"],"outputs":{"placed":"door.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.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":"booth.on.host.seat.z.0.times","op":"mul@1","args":["host.size.z","k.ratio.0_5"],"outputs":{"value":"booth.on.host.seat.z.0.times.value"}},{"id":"booth.on.host.along.z.0.times","op":"mul@1","args":["booth.dimension.depth","k.ratio.0_5"],"outputs":{"value":"booth.on.host.along.z.0.times.value"}},{"id":"booth.on.host.along.z.1.sum","op":"add@1","args":["booth.on.host.along.z.0.times.value","d.mm.0"],"outputs":{"value":"booth.on.host.along.z.1.sum.value"}},{"id":"booth.on.host.edge.y.0.times","op":"mul@1","args":["host.size.y","k.ratio._0_5"],"outputs":{"value":"booth.on.host.edge.y.0.times.value"}},{"id":"booth.on.host.own-edge.y.0.times","op":"mul@1","args":["booth.dimension.height","k.ratio.0_5"],"outputs":{"value":"booth.on.host.own-edge.y.0.times.value"}},{"id":"booth.seat.rigid","op":"rigid@1","args":["d.mm.0","booth.on.host.edge.y.0.times.value","booth.on.host.seat.z.0.times.value","a.deg.0","a.deg.0","a.deg.0"],"outputs":{"pose":"booth.seat.value"},"params":{"from":"booth.seat","to":"host.local"}},{"id":"booth.chain","op":"compose@1","args":["booth.seat.value","booth.poseValue"],"outputs":{"pose":"booth.chain.value"}},{"id":"booth.world","op":"compose@1","args":["host.chain.value","booth.chain.value"],"outputs":{"pose":"booth.world.value"}},{"id":"door.on.booth.seat.z.0.times","op":"mul@1","args":["booth.dimension.depth","k.ratio.0_5"],"outputs":{"value":"door.on.booth.seat.z.0.times.value"}},{"id":"door.on.booth.along.z.0.times","op":"mul@1","args":["door.dimension.depth","k.ratio.0_5"],"outputs":{"value":"door.on.booth.along.z.0.times.value"}},{"id":"door.on.booth.along.z.1.sum","op":"add@1","args":["door.on.booth.along.z.0.times.value","d.mm.0"],"outputs":{"value":"door.on.booth.along.z.1.sum.value"}},{"id":"door.on.booth.edge.y.0.times","op":"mul@1","args":["booth.dimension.height","k.ratio._0_5"],"outputs":{"value":"door.on.booth.edge.y.0.times.value"}},{"id":"door.on.booth.own-edge.y.0.times","op":"mul@1","args":["door.dimension.height","k.ratio.0_5"],"outputs":{"value":"door.on.booth.own-edge.y.0.times.value"}},{"id":"door.seat.rigid","op":"rigid@1","args":["d.mm.0","door.on.booth.edge.y.0.times.value","door.on.booth.seat.z.0.times.value","a.deg.0","a.deg.0","a.deg.0"],"outputs":{"pose":"door.seat.value"},"params":{"from":"door.joint","to":"booth.local"}},{"id":"door.chain","op":"compose@1","args":["door.seat.value","door.turned.value"],"outputs":{"pose":"door.chain.value"}},{"id":"door.world","op":"compose@1","args":["booth.world.value","door.chain.value"],"outputs":{"pose":"door.world.value"}},{"id":"door.motion","op":"axis-turn@1","args":["axis.ratio.0","axis.ratio.1","axis.ratio.0","open"],"outputs":{"pose":"door.motion.value"},"params":{"from":"door.seat","to":"door.joint"}},{"id":"door.turned","op":"compose@1","args":["door.motion.value","door.poseValue"],"outputs":{"pose":"door.turned.value"}}]},"capabilities":{"version":"r3-capability-3","assetFrame":"asset","bindings":[]}},"designInputs":{"host.size.x":4000,"host.size.y":3000,"host.size.z":6000,"booth.dimension.width":1200,"booth.dimension.height":2300,"booth.dimension.depth":1000,"door.dimension.width":800,"door.dimension.height":2000,"door.dimension.depth":30},"stateDefaults":{"open":0},"palette":{"palette.primary":"#477b9e","palette.host":"#d9dde2","palette.tpl-7f93a6":"#7f93a6","palette.tpl-7fb8d6":"#7fb8d6"},"appearance":[{"target":"host","material":{"token":"palette.host"}},{"target":"booth","material":{"token":"palette.tpl-7f93a6"}},{"target":"door","material":{"token":"palette.tpl-7fb8d6"}}],"joints":[{"id":"host","type":"fixed","body0":{"plane":"mounting-plane"},"body1":{"part":"host","face":"bottom"},"origin":{}},{"id":"booth","type":"fixed","body0":{"part":"host","face":"front"},"body1":{"part":"booth","face":"back"},"origin":{"align":{"y":"min"}}},{"id":"door","type":"revolute","body0":{"part":"booth","face":"front"},"body1":{"part":"door","face":"back"},"origin":{"align":{"y":"min"}},"axis":"Y","lowerLimit":-100,"upperLimit":0,"state":{"id":"open"}}]}

package/recipes/air-shower/recipe.json

@@ -0,0 +1,111 @@
+{
+  "name": "air-shower",
+  "title": {
+    "ko": "에어샤워 부스",
+    "en": "air shower booth"
+  },
+  "description": {
+    "ko": "고른 부품(클린룸 벽)의 앞면에 에어샤워 부스와 입구 문을 붙입니다.",
+    "en": "An air shower booth and its entrance door on the chosen part's front (a clean-room wall)."
+  },
+  "category": "door",
+  "tags": [
+    "air shower",
+    "cleanroom",
+    "booth"
+  ],
+  "target": "part",
+  "params": [],
+  "steps": [
+    {
+      "kind": "add-part",
+      "part": {
+        "id": "{id}-booth",
+        "kind": "box",
+        "dimensions": {
+          "width": 1200,
+          "height": 2300,
+          "depth": 1000
+        }
+      }
+    },
+    {
+      "kind": "add-part",
+      "part": {
+        "id": "{id}-door",
+        "kind": "box",
+        "dimensions": {
+          "width": 800,
+          "height": 2000,
+          "depth": 30
+        }
+      }
+    },
+    {
+      "kind": "set-joint",
+      "joint": {
+        "id": "{id}-booth",
+        "type": "fixed",
+        "body0": {
+          "part": "{target}",
+          "face": "front"
+        },
+        "body1": {
+          "part": "{id}-booth",
+          "face": "back"
+        },
+        "origin": {
+          "align": {
+            "y": "min"
+          }
+        }
+      }
+    },
+    {
+      "kind": "set-joint",
+      "joint": {
+        "id": "{id}-door",
+        "type": "revolute",
+        "body0": {
+          "part": "{id}-booth",
+          "face": "front"
+        },
+        "body1": {
+          "part": "{id}-door",
+          "face": "back"
+        },
+        "origin": {
+          "align": {
+            "y": "min"
+          }
+        },
+        "axis": "Y",
+        "lowerLimit": -100,
+        "upperLimit": 0,
+        "state": {
+          "id": "{id}-open"
+        }
+      }
+    },
+    {
+      "kind": "set-material",
+      "target": "{id}-booth",
+      "material": {
+        "token": "palette.tpl-7f93a6"
+      },
+      "palette": {
+        "palette.tpl-7f93a6": "#7f93a6"
+      }
+    },
+    {
+      "kind": "set-material",
+      "target": "{id}-door",
+      "material": {
+        "token": "palette.tpl-7fb8d6"
+      },
+      "palette": {
+        "palette.tpl-7fb8d6": "#7fb8d6"
+      }
+    }
+  ]
+}

package/recipes/air-shower/spec.json

@@ -0,0 +1,18 @@
+{
+  "name": "air-shower",
+  "category": "door",
+  "tags": [
+    "air shower",
+    "cleanroom",
+    "booth"
+  ],
+  "title": {
+    "ko": "에어샤워 부스",
+    "en": "air shower booth"
+  },
+  "description": {
+    "ko": "고른 부품(클린룸 벽)의 앞면에 에어샤워 부스와 입구 문을 붙입니다.",
+    "en": "An air shower booth and its entrance door on the chosen part's front (a clean-room wall)."
+  },
+  "params": []
+}

package/recipes/barrier-gate/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: 300, y: 1000, z: 300 }, 'TPL_BARRIER_GATE'))
+  m.box('arm', 3000, 80, 60)
+    .on('arm', 'bottom', 'host', 'top', { x: 'min' })
+    .colour('arm', 'palette.arm', '#d9534f')
+    .moves('arm', { type: 'revolute', axis: 'Z', lower: 0, upper: 90, state: 'raise' })
+  return m.asset
+}

package/recipes/barrier-gate/facts.md

@@ -0,0 +1,3 @@
+# barrier-gate — facts (not shown on screen; the guide's basis and our review)
+
+윗면, x 최소 끝에 붙음. 막대 3000×80×60 기본, 길이만 매개변수. 회전 Z 0~90°(들어올림). 한계: 막대 길이 고정.

package/recipes/barrier-gate/guide.en.md

@@ -0,0 +1,18 @@
+## When to use it
+
+For a barrier at a car park, a controlled area or an AGV lane; put it on the part that stands as the post.
+
+## Putting it in
+
+1. Choose the post. The arm reaches right from the left end of its **top**.
+2. Set the **arm length** in mm.
+3. Press "put in".
+
+## Afterwards
+
+- Move the **raise** control from 0 to 90: the arm lifts about its end.
+- The parts are ordinary parts: change them one by one, or take them all out with one undo.
+
+## Good to know
+
+- The arm's length does not follow the post; it stays as set.

package/recipes/barrier-gate/guide.ko.md

@@ -0,0 +1,18 @@
+## 언제 쓰나
+
+주차장, 출입 통제 구역, AGV 통로의 차단기를 만들 때 씁니다. 기둥 역할을 하는 부품에 넣습니다.
+
+## 넣는 순서
+
+1. 기둥 부품을 고릅니다. 막대는 그 부품 **윗면**의 왼쪽 끝에서 오른쪽으로 뻗습니다.
+2. **막대 길이**를 mm로 정합니다.
+3. 「넣기」를 누릅니다.
+
+## 넣은 뒤
+
+- **들어올림** 조작값을 0에서 90으로 움직이면 막대가 한쪽 끝을 축으로 들립니다.
+- 넣은 부품은 보통 부품이라 하나씩 고칠 수 있고, 되돌리기 한 번에 모두 빠집니다.
+
+## 알아 둘 것
+
+- 막대 길이는 기둥 크기를 따르지 않습니다. 기둥을 키워도 길이는 정한 값입니다.