{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "hydrocyclone-package",
  "type": "registry:component",
  "title": "De-oiling hydrocyclone package",
  "description": "Produced-water de-oiling hydrocyclone skid: horizontal multi-liner vessels on saddles with a bolted reject-end cover showing the liner end caps and a cover lifting eye, inlet header with gate-valved top branches, underflow gate valves into an outlet header with level control valve, reject ball valves into a reject header with a PDR (pressure-differential-ratio) control valve, DP transmitters, OIW monitor with sample line, gauges, drains, vents and a JB with cable tray. `vessels` sets the count; the reject end is kept clear for liner withdrawal.",
  "dependencies": [
    "three",
    "@react-three/fiber",
    "@react-three/drei"
  ],
  "registryDependencies": [
    "https://deck-twin-library.demoareeb.workers.dev/r/core.json"
  ],
  "files": [
    {
      "path": "packages/hydrocyclone-package.tsx",
      "type": "registry:file",
      "target": "components/deck-twin/packages/hydrocyclone-package.tsx",
      "content": "// Produced-water de-oiling hydrocyclone package: horizontal multi-liner vessels on saddles, inlet / outlet / reject headers, PDR-controlled reject valve, OIW monitor. ASME VIII-1, ASME B16.5.\nimport { Kit, type MatKey } from '../lib/kit'\nimport { KitMesh, useKit, type GroupProps } from '../lib/mesh'\nimport { gauge, nozzle, pipeRun, saddle, skid, tagPlate } from '../lib/parts'\nimport { port, type Port } from '../lib/ports'\nimport { SECTIONS, flange as flangeDims, headDepth, pipeOD, shellThickness, type Rating } from '../lib/standards'\nimport { textMaterial } from '../lib/textures'\nimport { addv, blFlange, branchMouth, cableTray, earthBoss, localPanel, mateFlange, padeyeShackles, pipeSupport, smallValve, transmitter, valve, valveSpan } from './_skid'\n\nexport interface HydrocyclonePackageProps {\n  /** hydrocyclone vessels in parallel */\n  vessels?: number\n  /** vessel inside diameter, m */\n  vesselDiameter?: number\n  /** vessel tangent length (liner length + chambers), m */\n  vesselLength?: number\n  /** design pressure, barg */\n  pressure?: number\n  inletNps?: number\n  outletNps?: number\n  rejectNps?: number\n  rating?: Rating\n  tag?: string\n}\n\nexport const defaults = {\n  vessels: 2,\n  vesselDiameter: 0.6,\n  vesselLength: 3.0,\n  pressure: 30,\n  inletNps: 8,\n  outletNps: 8,\n  rejectNps: 2,\n  rating: 300 as Rating,\n  tag: 'X-4200',\n}\n\ntype P = typeof defaults\n\nconst SKID = 'HEB 200'\nconst VES: MatKey = 'equipmentPaint'\n\nfunction layout(p: P) {\n  const N = Math.max(1, Math.min(4, Math.round(p.vessels)))\n  const D = p.vesselDiameter\n  const wall = shellThickness(p.pressure, D)\n  const Ro = D / 2 + wall\n  const hd = headDepth('2:1-ellipsoidal', D) + wall\n  const TT = p.vesselLength\n  const sp = 2 * Ro + 0.9\n  const zV = Array.from({ length: N }, (_, i) => (i - (N - 1) / 2) * sp)\n  const zBack = zV[0] - Ro - 0.45\n  const zFront = zV[N - 1] + Ro + 0.45\n  const W = zFront - zBack + 1.0\n  const zc = (zFront + zBack) / 2\n  const shift = (z: number) => z - zc\n  const xV0 = -TT / 2\n  const xV1 = TT / 2\n  const bn = Math.min(6, p.inletNps)\n  const Sg = valveSpan('gate', bn, p.rating)\n  const Sr = valveSpan('ball', p.rejectNps, p.rating)\n  const xUf = xV0 - hd - 0.25 // underflow nozzle face\n  const xOH = xUf - Sg - 0.25 - pipeOD(p.outletNps) / 2\n  const coverT = 0.09\n  const xRf = xV1 + coverT + 0.12 // reject neck end (valve weld end)\n  const xRH = xRf + Sr + 0.2\n  const L = Math.max(xRH + 1.4, -xOH + 1.0) * 2\n  const y0 = SECTIONS[SKID].d + 0.008\n  const yc = y0 + 0.65 + Ro\n  const yH = yc + Ro + 0.25 + Sg + 0.35\n  return { N, D, wall, Ro, hd, TT, sp, zV: zV.map(shift), zBack: shift(zBack), zFront: shift(zFront), W, xV0, xV1, bn, Sg, Sr, xUf, xOH, coverT, xRf, xRH, L, y0, yc, yH, xIn: xV1 - 0.6 }\n}\n\nexport function ports(props: HydrocyclonePackageProps = {}): Port[] {\n  const p = { ...defaults, ...props }\n  const g = layout(p)\n  return [\n    port('inlet', 'Produced water in', [-g.L / 2, g.yH, g.zBack], [-1, 0, 0], p.inletNps, p.rating),\n    port('outlet', 'Treated water out', [-g.L / 2, g.yc, g.zFront], [-1, 0, 0], p.outletNps, p.rating),\n    port('reject', 'Oily reject', [g.L / 2, g.yc, g.zFront], [1, 0, 0], p.rejectNps, p.rating),\n  ]\n}\n\nexport function HydrocyclonePackage(props: HydrocyclonePackageProps & GroupProps) {\n  const { vessels, vesselDiameter, vesselLength, pressure, inletNps, outletNps, rejectNps, rating, tag, ...group } = { ...defaults, ...props }\n  const p = { vessels, vesselDiameter, vesselLength, pressure, inletNps, outletNps, rejectNps, rating, tag }\n  const data = useKit((k) => build(k, p), Object.values(p))\n  return (\n    <group {...group}>\n      <KitMesh data={data} />\n    </group>\n  )\n}\n\nexport default HydrocyclonePackage\n\nfunction build(k: Kit, p: P) {\n  const g = layout(p)\n  const { L, W, y0, yc, yH, Ro, hd, xV0, xV1, zV, zBack, zFront } = g\n  const R = p.rating\n  skid(k, L, W, SKID)\n  padeyeShackles(k, L, W, y0)\n  tagPlate(k, p.tag, [-L / 2 + 0.8, SECTIONS[SKID].d * 0.5, W / 2 + 0.002], 'z', 0.3)\n  earthBoss(k, [L / 2 - 0.4, SECTIONS[SKID].d * 0.5, W / 2], [0, 0, 1])\n\n  for (const [i, z] of zV.entries()) {\n    // shell with 2:1 head at the underflow (-X) end and a body flange at the reject (+X) end\n    const prof: [number, number][] = []\n    for (let j = 0; j <= 12; j++) {\n      const t = (j / 12) * (Math.PI / 2)\n      prof.push([Ro * Math.sin(t), xV0 - hd * Math.cos(t)])\n    }\n    prof.push([Ro, xV1])\n    k.lathe(VES, prof, [0, yc, z], 'x', 48)\n    k.torus(VES, Ro + 0.001, 0.005, [xV0, yc, z], 'x', 6, 48)\n    k.cyl(VES, Ro + 0.08, 0.06, [xV1 - 0.03, yc, z], 'x', 48)\n    k.cyl(VES, Ro + 0.08, g.coverT, [xV1 + g.coverT / 2 + 0.003, yc, z], 'x', 48)\n    k.cyl('gasket', Ro + 0.02, 0.006, [xV1 + 0.003, yc, z], 'x', 48)\n    k.around(Math.max(12, Math.round(Ro * 60)), Ro + 0.05, [xV1 - 0.065, yc, z], 'x', (q) => {\n      k.cyl('boltXylan', 0.012, 0.21, addv(q, [0.105, 0, 0]), 'x', 6)\n      k.hex('nut', 0.036, 0.02, q, 'x')\n      k.hex('nut', 0.036, 0.02, addv(q, [0.2, 0, 0]), 'x')\n    })\n    // liner end caps on the reject cover (hex pattern)\n    const lr = 0.032\n    const pitch = 0.085\n    for (let row = -6; row <= 6; row++)\n      for (let col = -6; col <= 6; col++) {\n        const yy = row * pitch * 0.866\n        const zz = (col + (row % 2 ? 0.5 : 0)) * pitch\n        const r = Math.hypot(yy, zz)\n        if (r > Ro * 0.78 || r < 0.06) continue\n        k.cyl('stainless', lr, 0.03, [xV1 + g.coverT + 0.018, yc + yy, z + zz], 'x', 14)\n        k.dome('stainless', lr, [xV1 + g.coverT + 0.033, yc + yy, z + zz], 'x', Math.PI / 2, 0.4, 14)\n      }\n    k.torus('nut', 0.05, 0.012, [xV1 + g.coverT + 0.02, yc + Ro * 0.85, z], 'z', 6, 16, Math.PI) // cover lifting eye\n    k.plane(textMaterial(`HYDROCYCLONE ${String.fromCharCode(65 + i)}`, '#f2f2ee', '#111', 512, 64), 0.6, 0.075, [0, yc, z + Ro + 0.004])\n    k.at([0, yc, z], undefined, () => {\n      saddle(k, xV0 + 0.45, Ro, y0 - yc)\n      saddle(k, xV1 - 0.5, Ro, y0 - yc, { sliding: true })\n    })\n    // inlet branch from the header through a gate valve into the top nozzle\n    const inFace = nozzle(k, { base: [g.xIn, yc + Ro, z], dir: [0, 1, 0], nps: g.bn, rating: R, standout: 0.25, mat: VES, studs: false })\n    const w1 = mateFlange(k, inFace, [0, 1, 0], g.bn, R)\n    valve(k, 'gate', [g.xIn, w1[1] + 0.05 + g.Sg / 2, z], [0, 1, 0], g.bn, R, [1, 0, 0])\n    const yBr = yH - pipeOD(p.inletNps) / 2 + 0.004\n    k.pipe('pipePaint', w1, [g.xIn, w1[1] + 0.05, z], pipeOD(g.bn), 0.007)\n    k.pipe('pipePaint', [g.xIn, w1[1] + 0.05 + g.Sg, z], [g.xIn, yBr, z], pipeOD(g.bn), 0.007)\n    branchMouth(k, [g.xIn, yBr - 0.0005, z], [0, -1, 0], g.bn)\n    // underflow (clean water) through a gate valve into the outlet header\n    const uf = nozzle(k, { base: [xV0 - hd, yc, z], dir: [-1, 0, 0], nps: g.bn, rating: R, standout: 0.25, mat: VES, studs: false })\n    const w2 = mateFlange(k, uf, [-1, 0, 0], g.bn, R)\n    valve(k, 'gate', [w2[0] - 0.05 - g.Sg / 2, yc, z], [-1, 0, 0], g.bn, R)\n    k.pipe('pipePaint', w2, [w2[0] - 0.05, yc, z], pipeOD(g.bn), 0.007)\n    const xOHs = g.xOH + pipeOD(p.outletNps) / 2 - 0.004\n    k.pipe('pipePaint', [w2[0] - 0.05 - g.Sg, yc, z], [xOHs, yc, z], pipeOD(g.bn), 0.007)\n    branchMouth(k, [xOHs + 0.0005, yc, z], [1, 0, 0], g.bn)\n    // reject (overflow) through a ball valve into the reject header\n    k.pipe(VES, [xV1 + g.coverT - 0.01, yc, z], [g.xRf, yc, z], pipeOD(p.rejectNps), 0.006)\n    valve(k, 'ball', [g.xRf + g.Sr / 2, yc, z], [1, 0, 0], p.rejectNps, R)\n    k.pipe('pipePaint', [g.xRf + g.Sr, yc, z], [g.xRH - pipeOD(p.rejectNps) / 2, yc, z], pipeOD(p.rejectNps), 0.005)\n    // drains and vent, sample points\n    nozzle(k, { base: [xV0 + 0.25, yc - Ro, z], dir: [0, -1, 0], nps: 2, rating: R, standout: 0.15, mat: VES, blind: true })\n    nozzle(k, { base: [xV1 - 0.25, yc + Ro, z], dir: [0, 1, 0], nps: 1, rating: R, standout: 0.15, mat: VES, blind: true })\n    gauge(k, [xV0 + 0.6, yc + Ro + 0.16, z + 0.02], 'z', 0.1, 'bar', 40)\n    k.rod('stainless', [xV0 + 0.6, yc + Ro - 0.01, z], [xV0 + 0.6, yc + Ro + 0.1, z], 0.008, 8)\n  }\n\n  // inlet: BL → back lane → header across the vessels (blind end), PT and PSV\n  const fi = flangeDims(p.inletNps, R)\n  const iw = blFlange(k, [-L / 2, yH, zBack], [-1, 0, 0], p.inletNps, R)\n  const zEnd = zFront - 0.15\n  pipeRun(k, [iw, [g.xIn, yH, zBack], [g.xIn, yH, zEnd - fi.hubLength - fi.raisedFaceHeight]], p.inletNps)\n  blFlange(k, [g.xIn, yH, zEnd], [0, 0, 1], p.inletNps, R)\n  k.cyl('flangeSteel', fi.od / 2, fi.thickness * 1.15, [g.xIn, yH, zEnd + 0.0045 + fi.thickness * 0.575], 'z', 32)\n  transmitter(k, [g.xIn - 0.3, yH + pipeOD(p.inletNps) / 2, zBack], [0, 1, 0], 0.08)\n  for (const z of [zBack + 0.2, zFront - 0.6]) pipeSupport(k, [g.xIn, yH, z], pipeOD(p.inletNps), y0, 'z')\n  // outlet header → level control valve → BL\n  const Sl = valveSpan('globe', p.outletNps, R)\n  const xLv = -L / 2 + 0.25 + fi.hubLength + Sl / 2 + 0.1\n  const ow = blFlange(k, [-L / 2, yc, zFront], [-1, 0, 0], p.outletNps, R)\n  pipeRun(k, [[g.xOH, yc, zV[0] - 0.3], [g.xOH, yc, zFront], [xLv + Sl / 2, yc, zFront]], p.outletNps)\n  k.dome('pipePaint', pipeOD(p.outletNps) / 2, [g.xOH, yc, zV[0] - 0.3], '-z', Math.PI / 2, 0.5, 24)\n  valve(k, 'globe', [xLv, yc, zFront], [-1, 0, 0], p.outletNps, R, [0, 1, 0], 'valveBody', 1, 'diaphragm')\n  pipeRun(k, [[xLv - Sl / 2, yc, zFront], ow], p.outletNps)\n  // OIW monitor on the outlet header\n  k.tube('tubing', [[g.xOH, yc + pipeOD(p.outletNps) / 2, zFront - 0.3], [g.xOH, yc + 0.45, zFront - 0.3], [g.xOH + 0.5, yc + 0.45, zFront - 0.3]], 0.006, 6, 0.03)\n  k.rbox('stainless', [0.35, 0.45, 0.2], 0.015, [g.xOH + 0.7, yc + 0.35, zFront - 0.3])\n  k.plane(textMaterial('OIW MONITOR', '#f2f2ee', '#111', 256, 64), 0.25, 0.06, [g.xOH + 0.7, yc + 0.5, zFront - 0.199])\n  k.box('galvanised', [0.05, yc + 0.12 - y0, 0.05], [g.xOH + 0.7, (yc + 0.12 + y0) / 2, zFront - 0.42])\n  smallValve(k, 'needle', [g.xOH + 0.25, yc + 0.45, zFront - 0.3], [1, 0, 0], 0.007)\n  for (const z of [zV[0], zFront - 0.6]) pipeSupport(k, [g.xOH, yc, z + 0.25], pipeOD(p.outletNps), y0, 'z')\n  // reject header → PDR control valve → BL\n  const Sp = valveSpan('globe', p.rejectNps, R)\n  const xPd = L / 2 - 0.3 - Sp / 2\n  const rw = blFlange(k, [L / 2, yc, zFront], [1, 0, 0], p.rejectNps, R)\n  pipeRun(k, [[g.xRH, yc, zV[0] - 0.15], [g.xRH, yc, zFront], [xPd - Sp / 2, yc, zFront]], p.rejectNps)\n  k.dome('pipePaint', pipeOD(p.rejectNps) / 2, [g.xRH, yc, zV[0] - 0.15], '-z', Math.PI / 2, 0.5, 16)\n  valve(k, 'globe', [xPd, yc, zFront], [1, 0, 0], p.rejectNps, R, [0, 1, 0], 'valveBody', 1, 'diaphragm')\n  pipeRun(k, [[xPd + Sp / 2, yc, zFront], rw], p.rejectNps)\n  pipeSupport(k, [g.xRH, yc, zFront - 0.3], pipeOD(p.rejectNps), y0, 'z')\n  // PDR instrumentation: DP transmitters inlet-reject and inlet-outlet on a stand, impulse tubing\n  const sx = g.xRH + 0.45\n  const sz = zBack + 0.1\n  k.box('galvanised', [0.06, 1.45, 0.06], [sx, y0 + 0.725, sz])\n  k.box('galvanised', [0.18, 0.012, 0.18], [sx, y0 + 0.006, sz])\n  for (const [j, y] of [y0 + 1.2, y0 + 0.85].entries()) {\n    k.box('stainless', [0.18, 0.08, 0.06], [sx, y, sz + 0.06])\n    k.cyl('actuatorBlue', 0.045, 0.1, [sx, y + 0.1, sz + 0.06], 'z', 18)\n    k.plane(textMaterial(j ? 'PDT IN-OUT' : 'PDT IN-REJ', '#111', '#fff', 256, 48), 0.12, 0.022, [sx, y - 0.06, sz + 0.092])\n  }\n  k.tube('tubing', [[g.xIn + 0.2, yH, zBack], [sx - 0.05, yH, zBack], [sx - 0.05, y0 + 1.2, sz + 0.06]], 0.005, 6, 0.03)\n  k.tube('tubing', [[g.xRH, yc + 0.03, zV[0] - 0.1], [g.xRH, y0 + 1.2, zV[0] - 0.1], [sx + 0.05, y0 + 1.2, sz + 0.06]], 0.005, 6, 0.03)\n  // junction box, cable tray and local panel\n  const px = 0.2\n  const gl = localPanel(k, [px, y0, W / 2 - 0.3], [0, 0, 1], { w: 0.5, h: 0.6, top: 1.8, title: 'HYDROCYCLONE JB', screen: false, buttons: 0 })\n  const tz = W / 2 - 0.12\n  cableTray(k, [[px, gl[1] - 0.04, gl[2]], [px, y0 + 0.2, gl[2]], [px, y0 + 0.2, tz], [g.xRH + 0.2, y0 + 0.2, tz]], [1, 0, 0], 0.15, 2)\n  k.spline('cable', [[g.xRH + 0.2, y0 + 0.22, tz], [sx, y0 + 0.3, zFront - 0.6], [sx, y0 + 0.75, sz + 0.06]], 0.008, 6, 16)\n}\n"
    },
    {
      "path": "packages/_skid.ts",
      "type": "registry:file",
      "target": "components/deck-twin/packages/_skid.ts",
      "content": "// Shared package-skid parts: battery-limit flanges, in-kit valves, instruments, local panels, cable tray, supports, vessels, drip pans.\nimport * as THREE from 'three'\nimport { Kit, type MatKey, type V3 } from '../lib/kit'\nimport { flange, flangedJoint, gasket, gauge, member } from '../lib/parts'\nimport { faceToFace, flange as flangeDims, handwheelDia, headDepth, pipeOD, pipeWall, type Rating } from '../lib/standards'\nimport { lcdMaterial, textMaterial } from '../lib/textures'\n\nconst V = (v: V3) => new THREE.Vector3(...v)\nconst arr = (v: THREE.Vector3) => v.toArray() as V3\nexport const addv = (a: V3, d: V3, s = 1): V3 => [a[0] + d[0] * s, a[1] + d[1] * s, a[2] + d[2] * s]\n\n/** Local frame with +X along `dir` and +Y as close to `up` as possible, origin at `pos`. */\nexport function frame(pos: V3, dir: V3, up: V3 = [0, 1, 0]) {\n  const x = V(dir).normalize()\n  let u = V(up).normalize()\n  if (Math.abs(u.dot(x)) > 0.99) u = Math.abs(x.y) > 0.9 ? new THREE.Vector3(0, 0, 1) : new THREE.Vector3(0, 1, 0)\n  const z = new THREE.Vector3().crossVectors(x, u).normalize()\n  const y = new THREE.Vector3().crossVectors(z, x).normalize()\n  return new THREE.Matrix4().makeBasis(x, y, z).setPosition(V(pos))\n}\n\n/** Battery-limit weld-neck flange with studs, face at `face` pointing along `dir`. Returns the weld end for the neck pipe. */\nexport function blFlange(k: Kit, face: V3, dir: V3, nps: number, rating: Rating, studs = true): V3 {\n  const L = flange(k, nps, rating, face, dir, studs)\n  liner(k, nps, face, dir, L)\n  return addv(face, dir, -L)\n}\n\n/** Bore lining through a weld-neck flange (face to weld end) so a flange reads hollow when looked into. */\nexport function liner(k: Kit, nps: number, face: V3, dir: V3, len: number) {\n  const ro = pipeOD(nps) / 2\n  const ri = ro - pipeWall(nps, 'STD')\n  k.lathe('machined', [[ro * 0.88, 0], [ri, 0]], face, dir, 24)\n  k.lathe('pipeBore', [[ri, 0], [ri, -len]], face, dir, 24)\n}\n\nexport type ValveKind = 'ball' | 'gate' | 'globe' | 'check'\n\n/** Overall length of an in-kit flanged valve including both mating pipe flanges (weld end to weld end). */\nexport function valveSpan(kind: ValveKind, nps: number, rating: Rating) {\n  const f = flangeDims(nps, rating)\n  const fam = kind === 'ball' ? 'ball-full' : kind === 'check' ? 'swing-check' : kind\n  return faceToFace(fam, nps, rating) + 2 * (0.0045 + f.hubLength + f.raisedFaceHeight)\n}\n\n/**\n * Flanged valve centred at `pos` on a line along `dir`, operator towards `up`. Both mating pipe flanges, gaskets\n * and studs are included, so the line pipe stops at pos ± dir·valveSpan/2.\n */\nexport function valve(k: Kit, kind: ValveKind, pos: V3, dir: V3, nps: number, rating: Rating, up: V3 = [0, 1, 0], body: MatKey = 'valveBody', open = 1, op: 'manual' | 'mov' | 'diaphragm' = 'manual') {\n  const fam = kind === 'ball' ? 'ball-full' : kind === 'check' ? 'swing-check' : kind\n  const L = faceToFace(fam, nps, rating)\n  const f = flangeDims(nps, rating)\n  const D = pipeOD(nps)\n  const fl = f.thickness + f.raisedFaceHeight\n  k.with(frame(pos, dir, up), () => {\n    spoolJoint(k, [L / 2 + 0.00225, 0, 0], [1, 0, 0], nps, rating)\n    spoolJoint(k, [-L / 2 - 0.00225, 0, 0], [-1, 0, 0], nps, rating)\n    const inner = L / 2 - fl\n    const ri = D / 2 - pipeWall(nps, 'STD')\n    k.pipe(body, [-inner - 0.002, 0, 0], [inner + 0.002, 0, 0], D * 1.24, D * 0.62 - ri + 0.003, 28)\n    if (kind === 'ball') {\n      k.sphere(body, D * 0.82, [0, 0, 0], [1.05, 1, 1], 28)\n      for (const s of [-1, 1]) k.cyl(body, D * 0.78, 0.012, [s * D * 0.55, 0, 0], 'x', 28)\n      k.around(8, D * 0.7, [D * 0.55, 0, 0], 'x', (p) => k.hex('nut', 0.016, 0.01, addv(p, [0.008, 0, 0])))\n      const yTop = D * 0.95\n      k.cyl(body, D * 0.3, yTop - D * 0.6, [0, (yTop + D * 0.6) / 2, 0], 'y', 16)\n      k.cyl(body, D * 0.36, 0.012, [0, yTop, 0], 'y', 16)\n      if (op === 'mov') movActuator(k, yTop, D, body)\n      else if (nps <= 4) {\n        const lever = Math.max(0.15, handwheelDia('ball-full', nps, rating))\n        const a = (1 - open) * (Math.PI / 2)\n        k.cyl('nut', D * 0.12, 0.04, [0, yTop + 0.02, 0], 'y', 10)\n        k.box('actuatorRed', [lever, 0.012, 0.03], [(Math.cos(a) * lever) / 2 - Math.cos(a) * 0.02, yTop + 0.045, (-Math.sin(a) * lever) / 2], new THREE.Quaternion().setFromAxisAngle(new THREE.Vector3(0, 1, 0), a))\n      } else {\n        const gb = Math.max(0.12, D * 0.7)\n        k.rbox(body, [gb, gb * 0.6, gb * 0.8], gb * 0.08, [0, yTop + gb * 0.3, 0])\n        k.cyl(body, gb * 0.15, gb * 0.5, [0, yTop + gb * 0.3, gb * 0.6], 'z', 12)\n        k.handwheel('handwheel', Math.max(0.3, gb * 1.8), [0, yTop + gb * 0.3, gb * 0.85], 'z', 5)\n      }\n    } else if (kind === 'check') {\n      k.sphere(body, D * 0.78, [0, 0, 0], [1.25, 1, 0.95], 24)\n      const yc = D * 0.72\n      k.cyl(body, D * 0.62, 0.04, [0, yc, 0], 'y', 24)\n      k.cyl(body, D * 0.66, 0.025, [0, yc + 0.032, 0], 'y', 24)\n      k.around(8, D * 0.58, [0, yc + 0.045, 0], 'y', (p) => k.hex('nut', 0.018, 0.012, p))\n      k.box('stainless', [D * 0.5, 0.002, D * 0.25], [0, 0, D * 0.79])\n    } else {\n      // gate / globe: bolted bonnet, yoke, rising stem, handwheel\n      if (kind === 'globe') k.sphere(body, D * 0.85, [0, 0, 0], [1.2, 1, 0.95], 24)\n      else k.add(body, new THREE.CylinderGeometry(1, 1, D * 1.5, 28), new THREE.Matrix4().compose(new THREE.Vector3(0, D * 0.15, 0), new THREE.Quaternion(), new THREE.Vector3(D * 0.62, 1, D * 0.72)))\n      const yb = kind === 'globe' ? D * 0.8 : D * 0.9\n      k.cyl(body, D * 0.62, 0.03, [0, yb, 0], 'y', 24)\n      k.around(8, D * 0.55, [0, yb + 0.02, 0], 'y', (p) => k.hex('nut', 0.018, 0.012, p))\n      const hB = Math.max(0.08, D * 0.9)\n      k.cyl(body, D * 0.3, hB, [0, yb + hB / 2, 0], 'y', 16, D * 0.22)\n      const yoke = Math.max(0.12, D * 1.3)\n      const y0 = yb + hB\n      for (const s of [-1, 1]) k.box(body, [Math.max(0.012, D * 0.12), yoke, Math.max(0.012, D * 0.1)], [s * D * 0.28, y0 + yoke / 2, 0])\n      k.box(body, [D * 0.7, Math.max(0.016, D * 0.12), D * 0.2], [0, y0 + yoke, 0])\n      if (op === 'diaphragm') {\n        // spring-opposed diaphragm actuator with positioner\n        const Ra = THREE.MathUtils.clamp(D * 1.6, 0.14, 0.3)\n        const ya = y0 + yoke + 0.02\n        k.cyl('stainless', Math.max(0.006, D * 0.05), yoke * 0.8, [0, y0 + yoke * 0.5, 0], 'y', 10)\n        k.lathe('actuatorBlue', [[0.02, 0], [Ra * 0.9, 0], [Ra, Ra * 0.12], [Ra, Ra * 0.18], [Ra * 0.9, Ra * 0.2]], [0, ya, 0], 'y', 32)\n        k.lathe('actuatorBlue', [[Ra * 0.9, Ra * 0.2], [Ra, Ra * 0.22], [Ra, Ra * 0.28], [Ra * 0.7, Ra * 0.55], [0.02, Ra * 0.6]], [0, ya, 0], 'y', 32)\n        k.around(12, Ra * 0.95, [0, ya + Ra * 0.2, 0], 'y', (p) => k.hex('nut', 0.014, 0.012, p))\n        k.rbox('aluminium', [0.1, 0.12, 0.06], 0.01, [D * 0.35 + 0.05, y0 + yoke * 0.5, 0.04])\n        k.tube('tubing', [[D * 0.35 + 0.05, y0 + yoke * 0.5 + 0.06, 0.04], [D * 0.35 + 0.05, ya + Ra * 0.4, 0.04], [0.02, ya + Ra * 0.62, 0.04]], 0.004, 6, 0.02)\n      } else {\n        const stemTop = y0 + yoke + 0.04 + open * D * 0.6\n        k.cyl('stainless', Math.max(0.006, D * 0.05), stemTop - y0, [0, (stemTop + y0) / 2, 0], 'y', 10)\n        k.handwheel('handwheel', Math.max(0.16, handwheelDia(kind, nps, rating)), [0, y0 + yoke + 0.04, 0], 'y', 4)\n      }\n    }\n    k.box('stainless', [D * 0.45, D * 0.2, 0.002], [0, -D * 0.2, D * 0.63])\n  })\n  return valveSpan(kind, nps, rating)\n}\n\n/** Electric multi-turn actuator on a gearbox (valve-local frame, stem +Y from `y`). */\nfunction movActuator(k: Kit, y: number, D: number, body: MatKey) {\n  const s = THREE.MathUtils.clamp(D * 1.8, 0.45, 1.2)\n  k.cyl(body, D * 0.36, 0.06 * s, [0, y + 0.03 * s, 0], 'y', 20)\n  k.rbox(body, [0.24 * s, 0.2 * s, 0.26 * s], 0.02 * s, [0, y + 0.16 * s, 0])\n  k.rbox('actuatorBlue', [0.2 * s, 0.26 * s, 0.22 * s], 0.025 * s, [0, y + 0.39 * s, 0])\n  k.cyl('actuatorBlue', 0.08 * s, 0.28 * s, [0, y + 0.37 * s, 0.24 * s], 'z', 20)\n  k.cyl('actuatorBlue', 0.085 * s, 0.03 * s, [0, y + 0.37 * s, 0.38 * s], 'z', 20)\n  k.rbox('actuatorBlue', [0.16 * s, 0.1 * s, 0.14 * s], 0.015 * s, [0, y + 0.57 * s, 0])\n  k.disc('glass', 0.035 * s, [0, y + 0.39 * s, 0.111 * s], 'z', 18)\n  k.handwheel('handwheel', 0.3 * s, [-0.16 * s, y + 0.39 * s, 0], '-x', 4)\n  for (const dx of [-0.05, 0.05]) k.cyl('brass', 0.012 * s, 0.04 * s, [dx * s, y + 0.25 * s, -0.12 * s], 'z', 8)\n}\n\n/** Small-bore instrument / tubing valve (needle or ball) on a line along `dir`, handle towards `up`. Body length ≈ 8 r. */\nexport function smallValve(k: Kit, kind: 'needle' | 'ball', pos: V3, dir: V3, r: number, up: V3 = [0, 1, 0], mat: MatKey = 'stainless') {\n  const b = Math.max(0.012, r * 2.2)\n  k.with(frame(pos, dir, up), () => {\n    k.box(mat, [b * 2.6, b * 1.4, b * 1.4], [0, 0, 0])\n    for (const s of [-1, 1]) k.hex(mat, b * 1.25, b * 0.8, [s * b * 1.6, 0, 0], 'x')\n    if (kind === 'needle') {\n      k.cyl(mat, b * 0.45, b * 1.6, [0, b * 1.4, 0], 'y', 10)\n      k.hex(mat, b * 1.1, b * 0.5, [0, b * 1.1, 0], 'y')\n      k.box('handwheel', [b * 2.2, b * 0.35, b * 0.4], [0, b * 2.25, 0])\n    } else {\n      k.cyl(mat, b * 0.35, b * 0.8, [0, b * 1.0, 0], 'y', 10)\n      k.box('actuatorRed', [b * 4, b * 0.25, b * 0.6], [b * 1.6, b * 1.45, 0])\n    }\n  })\n}\n\n/** Small conventional relief valve: inlet at `inlet` going up (+Y), outlet towards `out`. Returns the outlet connection point. */\nexport function smallPsv(k: Kit, inlet: V3, out: V3, size = 0.025, body: MatKey = 'stainless', bonnet: MatKey = 'actuatorRed') {\n  const s = size\n  const o = V(out).normalize()\n  const c = addv(inlet, [0, 1, 0], s * 2.2)\n  k.hex(body, s * 1.6, s * 0.9, addv(inlet, [0, 1, 0], s * 0.45))\n  k.cyl(body, s * 1.0, s * 2.4, addv(c, [0, -1, 0], s * 0.3), 'y', 16)\n  k.sphere(body, s * 1.15, c, undefined, 14)\n  const oc = addv(c, arr(o), s * 1.4)\n  k.rod(body, c, oc, s * 0.7, 12)\n  k.hex(body, s * 1.6, s * 0.9, addv(c, arr(o), s * 1.9), arr(o))\n  k.cyl(bonnet, s * 0.75, s * 3.2, addv(c, [0, 1, 0], s * 2.4), 'y', 14, s * 0.55)\n  k.cyl(bonnet, s * 0.6, s * 0.9, addv(c, [0, 1, 0], s * 4.4), 'y', 12, s * 0.4)\n  k.box('nut', [s * 2.2, s * 0.2, s * 0.35], addv(c, [0, 1, 0], s * 4.2))\n  k.box('stainless', [s * 0.03 + 0.012, s * 1.2, 0.0015], addv(addv(c, [0, 1, 0], s * 2.4), [0, 0, 1], s * 0.8))\n  return addv(c, arr(o), s * 2.35)\n}\n\n/** Pressure transmitter (coplanar, 2-valve manifold) on an impulse stub from `tap` along `n`; dual-compartment head with LCD. */\nexport function transmitter(k: Kit, tap: V3, n: V3, standoff = 0.1, housing: MatKey = 'actuatorBlue') {\n  const d = V(n).normalize()\n  const m = addv(tap, arr(d), standoff)\n  k.rod('tubing', tap, m, 0.007, 8)\n  k.with(frame(m, arr(d)), () => {\n    k.box('stainless', [0.05, 0.05, 0.07], [0.025, 0, 0])\n    for (const s of [-1, 1]) k.cyl('handwheel', 0.006, 0.04, [0.025, 0, s * 0.055], 'z', 6)\n    k.box('stainless', [0.03, 0.06, 0.06], [0.065, 0.01, 0])\n    k.cyl('stainless', 0.03, 0.07, [0.07, 0.075, 0], 'y', 16)\n    k.cyl(housing, 0.042, 0.1, [0.07, 0.15, 0], 'x', 20)\n    for (const s of [-1, 1]) k.cyl(housing, 0.046, 0.022, [0.07 + s * 0.06, 0.15, 0], 'x', 20)\n    k.disc(lcdMaterial(), 0.03, [0.132, 0.15, 0], 'x', 20)\n    k.disc('glass', 0.034, [0.133, 0.15, 0], 'x', 20)\n    k.cyl('brass', 0.011, 0.03, [0.07, 0.15, 0.055], 'z', 8)\n  })\n}\n\n/** Thermowell with transmitter head, inserted at `at` on a pipe, head out along `n`. */\nexport function tempElement(k: Kit, at: V3, n: V3, od: number) {\n  const d = V(n).normalize()\n  const base = addv(at, arr(d), od / 2)\n  k.with(frame(base, arr(d)), () => {\n    k.cyl('stainless', 0.02, 0.04, [0.02, 0, 0], 'x', 12)\n    k.hex('stainless', 0.032, 0.02, [0.05, 0, 0], 'x')\n    k.cyl('stainless', 0.008, 0.06, [0.09, 0, 0], 'x', 8)\n    k.cyl('aluminium', 0.04, 0.06, [0.15, 0, 0], 'x', 18)\n    k.cyl('aluminium', 0.043, 0.015, [0.185, 0, 0], 'x', 18)\n    k.cyl('brass', 0.009, 0.025, [0.15, -0.045, 0], 'y', 8)\n  })\n}\n\n/** Instrument tapping with root valve and pressure gauge, from `tap` along `n`. */\nexport function gaugeTap(k: Kit, tap: V3, n: V3, max = 100, d = 0.1, unit: 'bar' | '°C' = 'bar') {\n  const v = V(n).normalize()\n  const a = addv(tap, arr(v), 0.05)\n  k.rod('tubing', tap, addv(tap, arr(v), 0.12), 0.007, 8)\n  smallValve(k, 'needle', a, arr(v), 0.006, Math.abs(v.y) > 0.9 ? [0, 0, 1] : [0, 1, 0])\n  const g = addv(tap, arr(v), 0.12 + d * 0.16)\n  const face: V3 = Math.abs(v.y) > 0.9 ? [0, 0, 1] : arr(v)\n  if (Math.abs(v.y) > 0.9) {\n    k.rod('tubing', addv(tap, arr(v), 0.12), addv(addv(tap, arr(v), 0.12), [0, 0, 1], 0.001), 0.007, 8)\n    gauge(k, addv(tap, arr(v), 0.12 + d / 2), face, d, unit, max)\n  } else gauge(k, g, face, d, unit, max)\n}\n\n/** Ladder cable tray along a polyline. Horizontal runs lie flat; vertical runs use `side` (horizontal) as the width direction. */\nexport function cableTray(k: Kit, pts: V3[], side: V3, w = 0.15, cables = 3) {\n  const sv = V(side).normalize()\n  const UP = new THREE.Vector3(0, 1, 0)\n  const sideOf = (d: THREE.Vector3) => (Math.abs(d.y) > 0.9 ? sv.clone() : new THREE.Vector3().crossVectors(UP, d).normalize())\n  const segs: { a: THREE.Vector3; d: THREE.Vector3; L: number; s: THREE.Vector3; n: THREE.Vector3 }[] = []\n  for (let i = 0; i < pts.length - 1; i++) {\n    const a = V(pts[i])\n    const d = V(pts[i + 1]).sub(a)\n    const L = d.length()\n    if (L < 1e-4) continue\n    d.normalize()\n    const s = sideOf(d)\n    let n = new THREE.Vector3().crossVectors(s, d).normalize()\n    if (Math.abs(d.y) < 0.9 && n.y < 0) n = n.negate()\n    segs.push({ a, d, L, s, n })\n  }\n  for (const { a, d, L, s, n } of segs) {\n    const q = new THREE.Quaternion().setFromRotationMatrix(new THREE.Matrix4().makeBasis(d, n, new THREE.Vector3().crossVectors(d, n)))\n    const mid = a.clone().addScaledVector(d, L / 2)\n    for (const sg of [-1, 1]) k.box('cableTray', [L + 0.01, 0.05, 0.003], arr(mid.clone().addScaledVector(s, (sg * w) / 2).addScaledVector(n, 0.02)), q)\n    const nr = Math.max(1, Math.floor(L / 0.25))\n    for (let j = 0; j <= nr; j++) k.box('cableTray', [0.02, 0.006, w], arr(a.clone().addScaledVector(d, (j / nr) * L).addScaledVector(n, 0.003)), q)\n  }\n  for (let c = 0; c < cables; c++) {\n    const off = ((c + 0.5) / cables - 0.5) * w * 0.7\n    const P: V3[] = []\n    segs.forEach(({ a, d, L, s, n }, i) => {\n      if (i === 0) P.push(arr(a.clone().addScaledVector(s, off).addScaledVector(n, 0.014)))\n      P.push(arr(a.clone().addScaledVector(d, L).addScaledVector(s, off).addScaledVector(n, 0.014)))\n    })\n    k.tube('cable', P, 0.008, 6, 0.08)\n  }\n}\n\n/**\n * Local control panel on two posts, door facing `n` (±X or ±Z), standing on the deck at `base`.\n * Returns the cable-gland point under the enclosure (for a tray run).\n */\nexport function localPanel(k: Kit, base: V3, n: V3, opts: { w?: number; h?: number; top?: number; title?: string; screen?: boolean; buttons?: number } = {}) {\n  const w = opts.w ?? 0.6\n  const h = opts.h ?? 0.7\n  const top = opts.top ?? 1.75\n  const dep = 0.25\n  const nn = V(n).normalize()\n  const side = new THREE.Vector3(0, 1, 0).cross(nn).normalize()\n  const q = new THREE.Quaternion().setFromUnitVectors(new THREE.Vector3(0, 0, 1), nn)\n  const at = (x: number, y: number, z: number) => arr(V(base).addScaledVector(side, x).add(new THREE.Vector3(0, y, 0)).addScaledVector(nn, z))\n  for (const s of [-1, 1]) {\n    member(k, at(s * (w / 2 - 0.05), 0, -0.05), at(s * (w / 2 - 0.05), top + 0.15, -0.05), 'UPN 80', 'galvanised', arr(nn))\n    k.box('galvanised', [0.16, 0.012, 0.16], at(s * (w / 2 - 0.05), 0.006, -0.05), q)\n  }\n  for (const y of [0.35, top - h - 0.05]) member(k, at(-w / 2, y, -0.03), at(w / 2, y, -0.03), 'L50x50x5', 'galvanised', [0, 1, 0])\n  const yc = top - h / 2\n  k.rbox('stainless', [w, h, dep], 0.015, at(0, yc, dep / 2), q)\n  k.rbox('stainless', [w - 0.03, h - 0.03, 0.012], 0.006, at(0, yc, dep + 0.006), q)\n  for (const s of [-0.3, 0.3]) k.box('nut', [0.02, 0.06, 0.012], at(w / 2 - 0.04, yc + s * h, dep + 0.016), q)\n  k.box('stainless', [w + 0.12, 0.01, dep + 0.2], at(0, top + 0.1, dep / 2 + 0.03), new THREE.Quaternion().setFromUnitVectors(new THREE.Vector3(0, 0, 1), nn).multiply(new THREE.Quaternion().setFromAxisAngle(new THREE.Vector3(1, 0, 0), 0.12)))\n  const fz = dep + 0.013\n  if (opts.screen !== false) {\n    k.box('rubberBlack', [w * 0.5, h * 0.3, 0.006], at(0, yc + h * 0.18, fz), q)\n    k.plane(lcdMaterial(), w * 0.45, h * 0.26, at(0, yc + h * 0.18, fz + 0.0035), q)\n  }\n  const nb = opts.buttons ?? 3\n  const mats: MatKey[] = ['safetyGreen', 'actuatorRed', 'actuatorYellow', 'lampLens', 'safetyGreen', 'actuatorRed']\n  for (let i = 0; i < nb; i++) k.cyl(mats[i % mats.length], 0.016, 0.02, at(-w * 0.3 + (i * w * 0.6) / Math.max(1, nb - 1), yc - h * 0.18, fz + 0.01), arr(nn), 14)\n  k.cyl('actuatorYellow', 0.04, 0.004, at(w * 0.3, yc - h * 0.36, fz), arr(nn), 20)\n  k.dome('actuatorRed', 0.025, at(w * 0.3, yc - h * 0.36, fz + 0.01), arr(nn), Math.PI / 2, 0.7, 16)\n  if (opts.title) k.plane(textMaterial(opts.title, '#f2f2ee', '#111', 512, 96), w * 0.7, w * 0.13, at(0, yc + h * 0.42, fz + 0.001), q)\n  for (let i = 0; i < 4; i++) k.cyl('brass', 0.012, 0.035, at(-w * 0.3 + i * w * 0.2, top - h - 0.015, dep / 2), 'y', 8)\n  return at(0, top - h - 0.04, dep / 2)\n}\n\n/** Pipe stanchion from the deck to under a pipe centred at `at`, with saddle plate and U-bolt. Pipe runs along `along`. */\nexport function pipeSupport(k: Kit, at: V3, od: number, deckY: number, along: 'x' | 'z', mat: MatKey = 'galvanised') {\n  const top = at[1] - od / 2 - 0.006\n  if (top - deckY < 0.05) return\n  const big = od > 0.12\n  const sec = big ? 'HEB 100' : 'L50x50x5'\n  member(k, [at[0], deckY, at[2]], [at[0], top - 0.01, at[2]], sec, mat, along === 'x' ? [1, 0, 0] : [0, 0, 1])\n  const w = Math.max(0.1, od + 0.06)\n  k.box(mat, along === 'x' ? [0.1, 0.012, w] : [w, 0.012, 0.1], [at[0], top - 0.004, at[2]])\n  k.box(mat, [0.16, 0.012, 0.16], [at[0], deckY + 0.006, at[2]])\n  k.torus('boltXylan', od / 2 + 0.006, Math.max(0.004, od * 0.03), [at[0], at[1], at[2]], along === 'x' ? 'x' : 'z', 6, 20, Math.PI)\n  for (const s of [-1, 1]) {\n    const p: V3 = along === 'x' ? [at[0], top + 0.004, at[2] + s * (od / 2 + 0.006)] : [at[0] + s * (od / 2 + 0.006), top + 0.004, at[2]]\n    k.hex('nut', Math.max(0.014, od * 0.12), 0.01, p)\n  }\n}\n\nexport interface VesselDims {\n  Ro: number\n  hd: number\n  /** bottom of the lower head */\n  yBot: number\n  /** top of the upper head */\n  yTop: number\n}\n\n/** Vertical 2:1 ellipsoidal-head vessel, bottom tangent line at `yTL`, with girth seams. */\nexport function vVessel(k: Kit, x: number, z: number, yTL: number, id: number, tt: number, wall: number, mat: MatKey = 'equipmentPaint', seg = 48): VesselDims {\n  const Ro = id / 2 + wall\n  const hd = headDepth('2:1-ellipsoidal', id) + wall\n  const prof: [number, number][] = [[0, -hd]]\n  for (let i = 1; i <= 12; i++) {\n    const t = (i / 12) * (Math.PI / 2)\n    prof.push([Ro * Math.sin(t), -hd * Math.cos(t)])\n  }\n  for (let i = 0; i <= 12; i++) {\n    const t = (i / 12) * (Math.PI / 2)\n    prof.push([Ro * Math.cos(t), tt + hd * Math.sin(t)])\n  }\n  k.lathe(mat, prof, [x, yTL, z], 'y', seg)\n  for (const y of [0, tt]) k.torus(mat, Ro + 0.0008, Math.max(0.003, Ro * 0.008), [x, yTL + y, z], 'y', 6, seg)\n  return { Ro, hd, yBot: yTL - hd, yTop: yTL + tt + hd }\n}\n\n/** Angle or pipe legs welded to a vertical shell, with base plates and anchor nuts. */\nexport function vesselLegs(k: Kit, x: number, z: number, Ro: number, yAttach: number, deckY: number, n = 4, mat: MatKey = 'equipmentPaint', phase = Math.PI / 4) {\n  const lr = Math.max(0.03, Ro * 0.12)\n  for (let i = 0; i < n; i++) {\n    const a = phase + (i / n) * Math.PI * 2\n    const px = x + Math.cos(a) * (Ro + lr * 0.6)\n    const pz = z + Math.sin(a) * (Ro + lr * 0.6)\n    k.cyl(mat, lr, yAttach - deckY, [px, (yAttach + deckY) / 2, pz], 'y', 12)\n    k.box(mat, [0.01, Math.min(0.3, (yAttach - deckY) * 0.3), lr * 2.4], [x + Math.cos(a) * (Ro + 0.005), yAttach - 0.1, z + Math.sin(a) * (Ro + 0.005)], new THREE.Quaternion().setFromAxisAngle(new THREE.Vector3(0, 1, 0), -a))\n    const bp = lr * 3.2\n    k.box(mat, [bp, 0.014, bp], [px, deckY + 0.007, pz])\n    for (const s of [-1, 1]) k.hex('nut', 0.026, 0.016, [px + s * bp * 0.32, deckY + 0.022, pz + s * bp * 0.32])\n  }\n}\n\n/** Bunded drip tray: floor plate, upstand rim and a drain coupling on the -X end. */\nexport function dripPan(k: Kit, cx: number, cz: number, sx: number, sz: number, y: number, rim = 0.06, mat: MatKey = 'stainless') {\n  k.box(mat, [sx, 0.005, sz], [cx, y + 0.0025, cz])\n  for (const s of [-1, 1]) {\n    k.box(mat, [sx, rim, 0.004], [cx, y + rim / 2, cz + s * (sz / 2 - 0.002)])\n    k.box(mat, [0.004, rim, sz], [cx + s * (sx / 2 - 0.002), y + rim / 2, cz])\n  }\n  k.cyl(mat, 0.016, 0.06, [cx - sx / 2 - 0.02, y + 0.02, cz], 'x', 10)\n  k.hex('nut', 0.03, 0.02, [cx - sx / 2 - 0.05, y + 0.02, cz], 'x')\n}\n\n/** Brass earth boss on a steel face. */\nexport function earthBoss(k: Kit, pos: V3, n: V3) {\n  k.cyl('brass', 0.014, 0.025, pos, n, 10)\n  k.hex('brass', 0.024, 0.008, addv(pos, n, 0.012), n)\n}\n\n/** Flanged spool joint inside the skid piping (both flanges, gasket, studs), centred at `pos` along `dir`. */\nexport function spoolJoint(k: Kit, pos: V3, dir: V3, nps: number, rating: Rating) {\n  flangedJoint(k, nps, rating, pos, dir)\n  const f = flangeDims(nps, rating)\n  const L = f.hubLength + f.raisedFaceHeight\n  liner(k, nps, addv(pos, dir, -0.00225), dir, L)\n  liner(k, nps, addv(pos, dir, 0.00225), [-dir[0], -dir[1], -dir[2]], L)\n}\n\n/** Curved painted label band on a vertical shell (axis +Y at x, z), centred on the +Z side, `h` tall over `arc` radians. */\nexport function shellLabel(k: Kit, text: string, x: number, y: number, z: number, Ro: number, h: number, arc = 1.1, bg = '#1f5fa0', fg = '#ffffff') {\n  k.add(textMaterial(text, bg, fg, 512, Math.round((512 * h) / (Ro * arc))), new THREE.CylinderGeometry(Ro + 0.003, Ro + 0.003, h, 24, 1, true, -arc / 2, arc), new THREE.Matrix4().makeTranslation(x, y, z))\n}\n\n/** Open mouth where a branch meets a run or shell: dark bore disc on the surface at `at` facing `dir`, plus the fillet weld. */\nexport function branchMouth(k: Kit, at: V3, dir: V3, nps: number, wall = 0.006) {\n  const r = pipeOD(nps) / 2\n  k.disc('pipeBore', r - wall, addv(at, dir, 0.0012), dir, 24)\n  k.torus('flangeSteel', r + 0.001, Math.max(0.003, r * 0.06), addv(at, dir, 0.002), dir, 6, 24)\n}\n\n/** Bow shackles with screw pins through the four lib `skid()` padeyes (skid of length L, width W, deck top `deckY`). */\nexport function padeyeShackles(k: Kit, L: number, W: number, deckY: number) {\n  for (const sx of [-1, 1])\n    for (const sz of [-1, 1]) {\n      const x = sx * (L / 2 - 0.25)\n      const z = sz * (W / 2 - 0.03)\n      const hy = deckY + 0.078\n      k.rod('galvanised', [x, hy, z - 0.05], [x, hy, z + 0.05], 0.011, 10)\n      k.hex('nut', 0.03, 0.016, [x, hy, z - 0.055], 'z')\n      k.cyl('galvanised', 0.02, 0.012, [x, hy, z + 0.055], 'z', 12)\n      k.tube('actuatorRed', [[x, hy, z - 0.042], [x, hy + 0.11, z - 0.042], [x, hy + 0.11, z + 0.042], [x, hy, z + 0.042]], 0.011, 8, 0.04)\n    }\n}\n\n/** Basket strainer on a line along +X centred at `pos` (flanged ends are spool joints at ±len/2), with pot, cover, drain and DP gauge. */\nexport function basketStrainer(k: Kit, pos: V3, nps: number, rating: Rating, len: number, mat: MatKey = 'valveBody') {\n  const D = pipeOD(nps)\n  const f = flangeDims(nps, rating)\n  const fl = f.hubLength + f.raisedFaceHeight\n  const [x, y, z] = pos\n  for (const s of [-1, 1]) spoolJoint(k, [x + (s * len) / 2, y, z], [s, 0, 0], nps, rating)\n  const inner = len / 2 - fl\n  k.pipe(mat, [x - inner - 0.002, y, z], [x + inner + 0.002, y, z], D * 1.1, D * 0.05 + 0.004, 28)\n  const R = D * 0.85\n  k.cyl(mat, R, D * 1.9, [x, y + D * 0.15, z], 'y', 32)\n  k.dome(mat, R, [x, y - D * 0.8, z], '-y', Math.PI / 2, 0.6, 32)\n  const yc = y + D * 1.1\n  k.cyl(mat, R + 0.05, 0.05, [x, yc, z], 'y', 32)\n  k.cyl(mat, R + 0.05, 0.04, [x, yc + 0.045, z], 'y', 32)\n  k.around(12, R + 0.025, [x, yc + 0.07, z], 'y', (p) => k.hex('nut', 0.03, 0.02, p))\n  k.box('handwheel', [R * 1.2, 0.025, 0.03], [x, yc + 0.08, z])\n  k.cyl('stainless', 0.012, 0.08, [x, y - D * 0.8 - R * 0.6 - 0.03, z], 'y', 10)\n  k.hex('nut', 0.03, 0.02, [x, y - D * 0.8 - R * 0.6 - 0.08, z])\n  k.tube('tubing', [[x - R * 0.7, y + D * 0.3, z + R * 0.75], [x - R * 0.7, yc + 0.15, z + R + 0.08], [x + R * 0.7, yc + 0.15, z + R + 0.08], [x + R * 0.7, y + D * 0.3, z + R * 0.75]], 0.005, 6, 0.03)\n  gauge(k, [x, yc + 0.2, z + R + 0.1], 'z', 0.1, 'bar', 2)\n}\n\n/** Spring-loaded back-pressure / thermal relief valve body on a line point, bonnet towards `up`. */\nexport function reliefBody(k: Kit, pos: V3, up: V3, s = 0.02) {\n  k.sphere('valveBody', s * 1.2, pos, undefined, 14)\n  k.cyl('actuatorRed', s * 0.7, s * 3, addv(pos, up, s * 2.4), up, 12, s * 0.5)\n  k.cyl('actuatorRed', s * 0.5, s * 0.8, addv(pos, up, s * 4.2), up, 10)\n}\n\n/**\n * Mating pipe flange bolted to a nozzle face that points along `dir` (nozzle drawn with studs: false): gasket, flange\n * facing back, bore liner and through-studs with two nuts. Returns the weld end of the mating flange.\n */\nexport function mateFlange(k: Kit, face: V3, dir: V3, nps: number, rating: Rating): V3 {\n  const f = flangeDims(nps, rating)\n  const g = 0.0045\n  gasket(k, nps, rating, addv(face, dir, g / 2), dir, g)\n  const mf = addv(face, dir, g)\n  const back: V3 = [-dir[0], -dir[1], -dir[2]]\n  blFlange(k, mf, back, nps, rating, false)\n  const span = 2 * (f.thickness + f.raisedFaceHeight) + g\n  const studL = span + f.boltDia * 3\n  k.boltCircle('boltXylan', 'nut', f.bolts, f.boltCircle / 2, addv(addv(face, dir, g / 2), dir, -studL / 2), dir, f.boltDia, studL, [f.boltDia * 0.95, studL - f.boltDia * 0.95])\n  return addv(mf, dir, f.hubLength + f.raisedFaceHeight)\n}\n\n/** Weld-to-weld length of an in-kit wafer butterfly valve between two weld-neck flanges. */\nexport function butterflySpan(nps: number, rating: Rating) {\n  const f = flangeDims(nps, rating)\n  return faceToFace('butterfly-wafer', nps, rating) + 2 * (0.003 + f.hubLength + f.raisedFaceHeight)\n}\n\n/** Wafer butterfly valve clamped between two pipe flanges, centred at `pos` on a line along `dir`; lever, gear or pneumatic rack-and-pinion actuator towards `up`. */\nexport function butterflyValve(k: Kit, pos: V3, dir: V3, nps: number, rating: Rating, up: V3 = [0, 1, 0], op: 'lever' | 'gear' | 'pneumatic' = 'pneumatic') {\n  const f = flangeDims(nps, rating)\n  const w = faceToFace('butterfly-wafer', nps, rating)\n  const D = pipeOD(nps)\n  const fl = f.hubLength + f.raisedFaceHeight\n  k.with(frame(pos, dir, up), () => {\n    for (const s of [-1, 1]) {\n      const face: V3 = [s * (w / 2 + 0.003), 0, 0]\n      flange(k, nps, rating, face, [-s, 0, 0], false)\n      liner(k, nps, face, [-s, 0, 0], fl)\n      gasket(k, nps, rating, [s * (w / 2 + 0.0015), 0, 0], 'x', 0.003)\n    }\n    const ri = D / 2 - 0.004\n    k.lathe('valveBody', [[ri, -w / 2], [f.raisedFace / 2 + 0.01, -w / 2], [f.raisedFace / 2 + 0.01, w / 2], [ri, w / 2]], [0, 0, 0], 'x', 32)\n    k.lathe('pipeBore', [[ri, w / 2], [ri, -w / 2]], [0, 0, 0], 'x', 24)\n    k.box('stainless', [0.006, 2 * ri, 2 * ri * 0.15], [0, 0, 0]) // disc edge-on (open)\n    const studL = w + 2 * (f.thickness + f.raisedFaceHeight) + f.boltDia * 3.2\n    k.boltCircle('boltXylan', 'nut', f.bolts, f.boltCircle / 2, [-studL / 2, 0, 0], 'x', f.boltDia, studL, [f.boltDia * 0.95, studL - f.boltDia * 0.95])\n    const yN = f.raisedFace / 2 + 0.01\n    k.cyl('valveBody', Math.max(0.018, D * 0.14), 0.09 + D * 0.2, [0, yN + (0.09 + D * 0.2) / 2, 0], 'y', 16)\n    const yT = yN + 0.09 + D * 0.2\n    k.box('valveBody', [0.1 + D * 0.3, 0.012, 0.1 + D * 0.3], [0, yT, 0])\n    if (op === 'pneumatic') {\n      const s = THREE.MathUtils.clamp(D * 2.2, 0.18, 0.6)\n      k.rbox('actuatorYellow', [s * 0.45, s * 0.4, s * 1.2], s * 0.06, [0, yT + s * 0.2 + 0.006, 0])\n      for (const sz of [-1, 1]) k.cyl('actuatorYellow', s * 0.22, s * 0.03, [0, yT + s * 0.2 + 0.006, sz * s * 0.6], 'z', 18)\n      k.rbox('aluminium', [s * 0.3, s * 0.2, s * 0.3], s * 0.03, [0, yT + s * 0.5, 0]) // limit switch box\n      k.cyl('actuatorRed', s * 0.08, s * 0.05, [0, yT + s * 0.62, 0], 'y', 12)\n    } else if (op === 'gear') {\n      const gb = Math.max(0.1, D * 0.6)\n      k.rbox('valveBody', [gb, gb * 0.6, gb * 0.8], gb * 0.08, [0, yT + gb * 0.3, 0])\n      k.handwheel('handwheel', Math.max(0.25, gb * 1.8), [0, yT + gb * 0.3, gb * 0.7], 'z', 5)\n    } else k.box('actuatorRed', [0.04, 0.02, Math.max(0.2, D * 1.6)], [0, yT + 0.02, Math.max(0.1, D * 0.8) - 0.03])\n  })\n  return w + 2 * (0.003 + fl)\n}\n"
    }
  ],
  "categories": [
    "packages"
  ],
  "meta": {
    "export": "HydrocyclonePackage",
    "anchor": "base",
    "standards": [
      "ASME BPVC VIII-1",
      "ASME B16.5",
      "ASME B16.10"
    ]
  }
}