{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "umbilical-termination-assembly",
  "type": "registry:component",
  "title": "Umbilical termination assembly (UTA)",
  "description": "Subsea UTA on a skirted mudmat: square-tube frame with lift points, grab bars and anodes; umbilical termination head bolted to a bulkhead frame, vertebrae bend restrictor dropping to the seabed and an umbilical stub lying on the seabed to its cut end. ROV panel with a fixed MQC stab plate (`couplers`) carrying a mated flying MQC half with ROV handle and bucket, its hydraulic flying lead running to a parking bracket on the mudmat; wet-mate electrical receptacles with dust caps (`electrical`) plus one mated electrical jumper parked on a second bracket. Internal tubing and cables run from the head to the plates. y = 0 is the seabed.",
  "dependencies": [
    "three",
    "@react-three/fiber",
    "@react-three/drei"
  ],
  "registryDependencies": [
    "https://deck-twin-library.demoareeb.workers.dev/r/core.json"
  ],
  "files": [
    {
      "path": "drilling/umbilical-termination-assembly.tsx",
      "type": "registry:file",
      "target": "components/deck-twin/drilling/umbilical-termination-assembly.tsx",
      "content": "// Subsea umbilical termination assembly (UTA): mudmat, frame, umbilical termination head with bend restrictor, MQC stab plate, wet-mate electrical plate, parked flying leads (API 17E / ISO 13628-5).\nimport * as THREE from 'three'\nimport { Kit, type MatKey, type V3 } from '../lib/kit'\nimport { paint } from '../lib/materials'\nimport { KitMesh, useKit, type GroupProps } from '../lib/mesh'\nimport { member, tagPlate } from '../lib/parts'\nimport { port, type Port } from '../lib/ports'\nimport { anode, grabBar, mudmat, rovBucket } from './_drill'\n\nexport interface UmbilicalTerminationAssemblyProps {\n  /** umbilical outside diameter, m */\n  umbilicalOd?: number\n  /** hydraulic / chemical couplers on the MQC plate */\n  couplers?: number\n  /** wet-mate electrical connectors */\n  electrical?: number\n  tag?: string\n}\n\nexport const defaults = { umbilicalOd: 0.16, couplers: 8, electrical: 2, tag: 'UTA-01' }\n\ntype P = typeof defaults\n\nconst Lm = 4.4\nconst Wm = 3.2\n\nfunction layout(p: Omit<P, 'tag'>) {\n  const ne = Math.max(1, Math.min(4, Math.round(p.electrical)))\n  const yPlate = 1.05\n  const xPlate = Lm / 2 - 0.55\n  return {\n    ne,\n    yPlate,\n    xPlate,\n    umb: [-Lm / 2 - 1.6, p.umbilicalOd / 2, 0] as V3,\n    park: [Lm / 2 - 0.45, 0.62, -Wm / 2 + 0.55] as V3,\n    elec: Array.from({ length: ne }, (_, i) => [xPlate + 0.06, yPlate + 0.15 - (i % 2) * 0.22, Wm / 2 - 0.95 - Math.floor(i / 2) * 0.24] as V3),\n  }\n}\n\nexport function ports(props: UmbilicalTerminationAssemblyProps = {}): Port[] {\n  const p = { ...defaults, ...props }\n  const l = layout(p)\n  return [\n    port('umbilical', 'Umbilical (cut end)', l.umb, [-1, 0, 0], 6, undefined, 'utility'),\n    port('hydraulic', 'Hydraulic flying lead (parked MQC head)', [l.park[0] + 0.02, l.park[1], l.park[2]], [1, 0, 0], 2, undefined, 'utility'),\n    ...l.elec.map((e, i) => port(`electrical-${i + 1}`, `Wet-mate electrical ${i + 1}`, e, [1, 0, 0], 1, undefined, 'electrical')),\n  ]\n}\n\nexport function UmbilicalTerminationAssembly({ umbilicalOd = defaults.umbilicalOd, couplers = defaults.couplers, electrical = defaults.electrical, tag = defaults.tag, ...group }: UmbilicalTerminationAssemblyProps & GroupProps) {\n  const data = useKit((k) => build(k, { umbilicalOd, couplers, electrical, tag }), [umbilicalOd, couplers, electrical, tag])\n  return (\n    <group {...group}>\n      <KitMesh data={data} />\n    </group>\n  )\n}\n\nexport default UmbilicalTerminationAssembly\n\n/** MQC plate (fixed or flying half) facing +X at c: plate, guide pins, couplers on a circle, central latch screw. */\nfunction mqc(k: Kit, c: V3, R: number, n: number, mat: MatKey, flying: boolean) {\n  k.cyl(mat, R, 0.05, [c[0] - 0.025, c[1], c[2]], 'x', 40)\n  k.around(n, R * 0.62, [c[0], c[1], c[2]], 'x', (q) => {\n    k.cyl('stainless', 0.032, 0.06, [q[0] + (flying ? -0.06 : 0.01), q[1], q[2]], 'x', 14)\n    k.cyl('brass', 0.022, 0.012, [q[0] + (flying ? -0.095 : 0.045), q[1], q[2]], 'x', 12)\n  })\n  for (const s of [-1, 1]) k.cyl('stainless', 0.025, 0.12, [c[0] + 0.04, c[1] + s * R * 0.85, c[2]], 'x', 12)\n  k.cyl('nut', 0.05, 0.08, [c[0] + (flying ? -0.08 : 0.04), c[1], c[2]], 'x', 6)\n}\n\nfunction build(k: Kit, p: P) {\n  const l = layout(p)\n  const { yPlate, xPlate, umb, park, elec } = l\n  const Y: MatKey = paint('#e3b512', { weather: 1 })\n  const UMB: MatKey = paint('#2b2d30', { metalness: 0.1, roughness: 0.7 })\n  const t = mudmat(k, Lm, Wm, { mat: Y, skirt: 0.25 })\n  const ro = p.umbilicalOd / 2\n\n  // frame: corner posts, top rails, mid bulkhead frame carrying the termination head\n  const fx = Lm / 2 - 0.12\n  const fz = Wm / 2 - 0.12\n  const yTop = 1.65\n  for (const sx of [-1, 1]) for (const sz of [-1, 1]) member(k, [sx * fx, t, sz * fz], [sx * fx, yTop, sz * fz], 'SHS 150x150x8', Y)\n  for (const sz of [-1, 1]) member(k, [-fx, yTop, sz * fz], [fx, yTop, sz * fz], 'SHS 150x150x8', Y)\n  for (const sx of [-1, 1]) member(k, [sx * fx, yTop, -fz], [sx * fx, yTop, fz], 'SHS 150x150x8', Y)\n  for (const sz of [-1, 1]) member(k, [-fx, t + 0.1, sz * fz], [-0.2, yTop - 0.1, sz * fz], 'CHS 88.9x6.3', Y)\n  const xb = -0.55\n  for (const sz of [-1, 1]) member(k, [xb, t, sz * 0.7], [xb, 1.35, sz * 0.7], 'HEA 200', Y)\n  member(k, [xb, 1.35, -0.8], [xb, 1.35, 0.8], 'HEA 200', Y)\n  k.box(Y, [0.04, 0.9, 1.3], [xb + 0.12, 0.85, 0])\n  for (const sx of [-1, 1])\n    for (const sz of [-1, 1]) {\n      k.box(Y, [0.28, 0.2, 0.04], [sx * fx, yTop + 0.17, sz * fz])\n      k.torus('nut', 0.05, 0.012, [sx * fx, yTop + 0.22, sz * fz], 'z', 6, 16)\n    }\n\n  // umbilical termination head: armour pot, split flange, bolted to the bulkhead plate\n  const yH = 0.85\n  const xh0 = xb - 0.1\n  k.cyl(Y, 0.3, 0.06, [xh0 + 0.12 + 0.03, yH, 0], 'x', 40)\n  k.around(12, 0.26, [xh0 + 0.12, yH, 0], 'x', (q) => k.hex('nut', 0.03, 0.02, [q[0] + 0.06, q[1], q[2]], 'x'))\n  k.lathe(Y, [[ro * 1.6, xh0 - 0.85], [0.17, xh0 - 0.55], [0.22, xh0 - 0.25], [0.22, xh0 + 0.12]], [0, yH, 0], 'x', 36)\n  k.cyl(Y, 0.24, 0.03, [xh0 - 0.25, yH, 0], 'x', 36)\n  k.around(8, 0.21, [xh0 - 0.22, yH, 0], 'x', (q) => k.hex('nut', 0.025, 0.02, q, 'x'))\n  k.box(Y, [0.6, yH - 0.22 - t, 0.06], [xh0 - 0.3, (yH - 0.22 + t) / 2, 0])\n  // bend restrictor (vertebrae) dropping to the seabed, then the umbilical lying on the seabed to its cut end\n  const c = new THREE.CubicBezierCurve3(new THREE.Vector3(xh0 - 0.85, yH, 0), new THREE.Vector3(xh0 - 1.6, yH, 0), new THREE.Vector3(-Lm / 2 - 0.2, ro + 0.02, 0), new THREE.Vector3(-Lm / 2 - 0.8, ro + 0.02, 0))\n  const N = 22\n  for (let i = 0; i < N; i++) {\n    const a = c.getPointAt(i / N)\n    const b = c.getPointAt((i + 0.85) / N)\n    k.rod(UMB, a.toArray() as V3, b.toArray() as V3, ro * 1.55, 20)\n    k.rod(UMB, b.toArray() as V3, c.getPointAt(Math.min(1, (i + 1) / N)).toArray() as V3, ro * 1.25, 20)\n  }\n  k.tube(UMB, [[-Lm / 2 - 0.8, ro + 0.001, 0], [umb[0], ro + 0.001, 0]], ro, 20)\n  k.disc('copper', ro * 0.95, [umb[0] - 0.001, umb[1], 0], '-x', 20)\n  for (let i = 0; i < 8; i++) {\n    const a = (i / 8) * Math.PI * 2\n    k.disc('rubberBlack', ro * 0.18, [umb[0] - 0.002, umb[1] + Math.sin(a) * ro * 0.55, Math.cos(a) * ro * 0.55], '-x', 10)\n  }\n\n  // ROV panel at +X: fixed MQC stab plate (hydraulic / chemical), wet-mate electrical plate; tubing and cables from the bulkhead\n  k.box(Y, [0.04, 1.0, 2.2], [xPlate - 0.02, 0.9 + 0.1, 0])\n  for (const sz of [-1, 1]) member(k, [xPlate - 0.06, t, sz * 1.1], [xPlate - 0.06, 1.55, sz * 1.1], 'HEA 160', Y)\n  const zq = -0.55\n  const R = 0.24\n  const nc = Math.max(4, Math.min(16, Math.round(p.couplers)))\n  mqc(k, [xPlate, yPlate, zq], R, nc, 'stainless', false)\n  // flying MQC half mated on the plate, ROV handle and bucket for the latch\n  mqc(k, [xPlate + 0.2, yPlate, zq], R, nc, Y, true)\n  k.rod(Y, [xPlate + 0.2, yPlate + R + 0.02, zq - 0.15], [xPlate + 0.35, yPlate + R + 0.18, zq - 0.15], 0.02, 8)\n  k.rod(Y, [xPlate + 0.2, yPlate + R + 0.02, zq + 0.15], [xPlate + 0.35, yPlate + R + 0.18, zq + 0.15], 0.02, 8)\n  k.rod(Y, [xPlate + 0.35, yPlate + R + 0.18, zq - 0.15], [xPlate + 0.35, yPlate + R + 0.18, zq + 0.15], 0.025, 8)\n  rovBucket(k, [xPlate + 0.24, yPlate, zq], 'x', Y)\n  // hydraulic flying lead: steel tube bundle in a sheath from the flying MQC down to the parking stand, cobra head parked\n  const hose: V3[] = [[xPlate + 0.45, yPlate, zq], [xPlate + 0.7, yPlate - 0.2, zq], [xPlate + 0.55, 0.3, zq - 0.2], [park[0] - 0.35, 0.3, park[2] + 0.2], [park[0] - 0.25, park[1], park[2]]]\n  k.spline(UMB, hose, 0.04, 12, 60)\n  k.lathe(Y, [[0.04, -0.25], [0.11, -0.08], [0.11, 0], [0, 0]], [park[0], park[1], park[2]], 'x', 24)\n  mqc(k, [park[0] + 0.02, park[1], park[2]], 0.16, nc, Y, true)\n  for (const sz of [-1, 1]) member(k, [park[0] - 0.05, t, park[2] + sz * 0.2], [park[0] - 0.05, park[1] + 0.2, park[2] + sz * 0.2], 'SHS 100x100x6.3', Y)\n  k.box(Y, [0.03, 0.42, 0.5], [park[0] - 0.05, park[1], park[2]])\n  k.box('nut', [0.003, 0.08, 0.3], [park[0] - 0.034, park[1] + 0.25, park[2]])\n  // electrical plate: receptacles with dust caps (free) and one mated jumper looping to a second parking slot\n  for (const e of elec) {\n    k.cyl('stainless', 0.06, 0.12, [e[0] - 0.06, e[1], e[2]], 'x', 20)\n    k.cyl('actuatorRed', 0.065, 0.05, [e[0] - 0.025, e[1], e[2]], 'x', 20)\n    k.rod('actuatorRed', [e[0] - 0.025, e[1] + 0.065, e[2]], [e[0] + 0.02, e[1] + 0.1, e[2]], 0.01, 6)\n  }\n  const em: V3 = [xPlate, yPlate - 0.15, 0.25]\n  k.cyl('stainless', 0.06, 0.12, [em[0] + 0.04, em[1], em[2]], 'x', 20)\n  k.cyl(Y, 0.075, 0.2, [em[0] + 0.2, em[1], em[2]], 'x', 20)\n  k.rod(Y, [em[0] + 0.2, em[1] + 0.08, em[2]], [em[0] + 0.2, em[1] + 0.2, em[2]], 0.015, 8)\n  k.spline('cable', [[em[0] + 0.3, em[1], em[2]], [em[0] + 0.6, em[1] - 0.2, em[2] + 0.1], [em[0] + 0.35, 0.25, em[2] + 0.55], [em[0] - 0.4, 0.2, Wm / 2 - 0.45], [em[0] - 0.8, 0.45, Wm / 2 - 0.45]], 0.025, 10, 60)\n  k.box(Y, [0.03, 0.4, 0.4], [em[0] - 0.85, 0.45, Wm / 2 - 0.45])\n  k.cyl(Y, 0.07, 0.18, [em[0] - 0.75, 0.45, Wm / 2 - 0.45], 'x', 20)\n  for (const sz of [-1, 1]) member(k, [em[0] - 0.87, t, Wm / 2 - 0.45 + sz * 0.15], [em[0] - 0.87, 0.65, Wm / 2 - 0.45 + sz * 0.15], 'SHS 100x100x6.3', Y)\n  // internal tubing and cables from the termination head through the bulkhead to the plates\n  for (let i = 0; i < nc; i++) {\n    const a = (i / nc) * Math.PI * 2\n    const q: V3 = [xPlate - 0.04, yPlate + Math.sin(a) * R * 0.62, zq + Math.cos(a) * R * 0.62]\n    const off = (i - nc / 2) * 0.03\n    k.tube('tubing', [[xb + 0.14, yH + off * 0.5, off], [xb + 0.5, yH + off * 0.5, off], [xb + 0.9, q[1], zq + off], [q[0] - 0.2, q[1], q[2]], q], 0.008, 6, 0.08)\n  }\n  for (const e of [...elec, [em[0] + 0.04, em[1], em[2]] as V3]) k.spline('cable', [[xb + 0.14, yH - 0.1, 0.1], [xb + 0.6, yH - 0.1, 0.25], [e[0] - 0.5, e[1], e[2]], [e[0] - 0.12, e[1], e[2]]], 0.012, 8, 30)\n\n  // grab bars, anodes, nameplate\n  for (const sz of [-1, 1]) grabBar(k, [-1.2, yTop - 0.4, sz * fz], [1.0, yTop - 0.4, sz * fz], [0, 0, sz])\n  for (const sx of [-1, 1]) for (const sz of [-1, 1]) anode(k, [sx * (fx - 0.3), t + 0.5, sz * (fz + 0.14)], 'y', 0.5)\n  k.box(Y, [1.0, 0.36, 0.02], [0, yTop - 0.75, fz + 0.1])\n  for (const s of [-1, 1]) k.box(Y, [0.06, 0.62, 0.02], [s * 0.4, yTop - 0.36, fz + 0.09])\n  tagPlate(k, p.tag, [0, yTop - 0.75, fz + 0.112], 'z', 0.9)\n}\n"
    },
    {
      "path": "drilling/_drill.ts",
      "type": "registry:file",
      "target": "components/deck-twin/drilling/_drill.ts",
      "content": "// Shared drilling & subsea parts: API 6A flanges and gate valves, hammer-lug covers, convex hulls, ROV buckets, hubs and clamps, mudmats.\nimport * as THREE from 'three'\nimport { mat4, type Kit, type MatKey, type V3 } from '../lib/kit'\nimport { flange, liftingLug } from '../lib/parts'\nimport { flange as asmeFlange, inch, nearest, pipeOD, type Rating } from '../lib/standards'\n\n// ------------------------------------------------------------------ API 6A (typical 6B / 6BX dims, inches: OD, thickness, bolt circle, bolts, bolt dia)\n\nexport type Psi = 5000 | 10000 | 15000\n\ntype Row = [od: number, t: number, bc: number, n: number, bd: number]\n\nconst API: Record<Psi, Record<number, Row>> = {\n  5000: {\n    2.0625: [8.5, 1.81, 6.5, 8, 0.875], 2.5625: [9.62, 1.94, 7.5, 8, 1.0], 3.125: [10.5, 2.19, 8.0, 8, 1.125],\n    4.0625: [12.25, 2.44, 9.5, 8, 1.25], 5.125: [14.75, 3.19, 11.5, 8, 1.5], 7.0625: [15.5, 3.62, 12.5, 12, 1.375],\n  },\n  10000: {\n    2.0625: [7.88, 1.73, 6.25, 8, 0.75], 2.5625: [9.12, 2.02, 7.25, 8, 0.875], 3.0625: [10.62, 2.3, 8.5, 8, 1.0],\n    4.0625: [12.44, 2.77, 10.19, 8, 1.125], 5.125: [14.06, 3.12, 11.81, 12, 1.125], 7.0625: [18.88, 4.06, 15.88, 12, 1.5],\n  },\n  15000: {\n    2.0625: [8.75, 2.0, 6.88, 8, 0.875], 2.5625: [10.0, 2.25, 7.88, 8, 1.0], 3.0625: [11.31, 2.53, 9.06, 8, 1.125],\n    4.0625: [14.19, 3.09, 11.44, 8, 1.375], 5.125: [16.5, 3.88, 13.63, 12, 1.5], 7.0625: [19.88, 4.69, 16.88, 16, 1.5],\n  },\n}\n\n// typical API 6A slab-gate face-to-face, inches\nconst GATE: Record<Psi, Record<number, number>> = {\n  5000: { 2.0625: 14.62, 2.5625: 16.62, 3.125: 18.62, 4.0625: 21.62, 5.125: 28.62, 7.0625: 29.0 },\n  10000: { 2.0625: 20.5, 2.5625: 22.25, 3.0625: 24.38, 4.0625: 26.38, 5.125: 29.0, 7.0625: 35.0 },\n  15000: { 2.0625: 19.0, 2.5625: 21.0, 3.0625: 23.56, 4.0625: 29.0, 5.125: 35.0, 7.0625: 40.0 },\n}\n\nexport interface ApiFlange {\n  bore: number\n  od: number\n  t: number\n  bolts: number\n  boltDia: number\n  boltCircle: number\n  ring: number\n}\n\nexport function apiFlange(bore: number, psi: Psi = 10000): ApiFlange {\n  const tbl = API[psi] ?? API[10000]\n  const b = nearest(Object.keys(tbl).map(Number), bore)\n  const [od, t, bc, n, bd] = tbl[b]\n  return { bore: b, od: inch(od), t: inch(t), bolts: n, boltDia: inch(bd), boltCircle: inch(bc), ring: inch(bc - bd * 1.9) }\n}\n\nexport function apiGateLength(bore: number, psi: Psi = 10000): number {\n  const tbl = GATE[psi] ?? GATE[10000]\n  return inch(tbl[nearest(Object.keys(tbl).map(Number), bore)])\n}\n\n/** ring-gasket half gap at an RTJ joint */\nexport const G = 0.003\nconst rBore = (d: ApiFlange) => d.bore * 0.0127\n\n/** Hollow tube along local Y. */\nexport function tubeY(k: Kit, mat: MatKey, ro: number, ri: number, y0: number, y1: number, seg = 28) {\n  k.lathe(mat, [[ri, y0], [ro, y0], [ro, y1], [ri, y1]], [0, 0, 0], 'y', seg)\n  k.lathe('pipeBore', [[ri, Math.max(y0, y1)], [ri, Math.min(y0, y1)]], [0, 0, 0], 'y', seg)\n}\n\n/** Integral API flange, ring face at local y = face, body on side s (+1 above, -1 below). */\nexport function apiFlangeAt(k: Kit, d: ApiFlange, face: number, s: 1 | -1, mat: MatKey) {\n  const f0 = face + s * G\n  const f1 = face + s * (G + d.t)\n  const lo = Math.min(f0, f1)\n  const hi = Math.max(f0, f1)\n  const ch = Math.min(0.006, d.t * 0.12)\n  const rb = rBore(d)\n  const R = d.od / 2\n  const prof: [number, number][] = s > 0 ? [[rb, lo], [R, lo], [R, hi - ch], [R - ch, hi], [rb, hi]] : [[rb, lo], [R - ch, lo], [R, lo + ch], [R, hi], [rb, hi]]\n  k.lathe(mat, prof, [0, 0, 0], 'y', d.bolts >= 12 ? 40 : 28)\n}\n\n/** Studs, nuts and ring gasket for two API flanges meeting at local y = yj. */\nexport function apiJoint(k: Kit, d: ApiFlange, yj: number) {\n  const nh = d.boltDia * 0.95\n  const so = d.boltDia * 0.4\n  const len = 2 * (G + d.t) + 2 * nh + 2 * so\n  k.boltCircle('boltXylan', 'nut', d.bolts, d.boltCircle / 2, [0, yj - len / 2, 0], 'y', d.boltDia, len, [so + nh / 2, len - so - nh / 2])\n  k.torus('stainless', d.ring / 2, Math.max(0.004, d.boltDia * 0.18), [0, yj, 0], 'y', 4, 28)\n}\n\n/** Flanged spool between API faces y = 0 and y = L (local Y). */\nexport function apiSpool(k: Kit, d: ApiFlange, L: number, mat: MatKey) {\n  apiFlangeAt(k, d, 0, 1, mat)\n  apiFlangeAt(k, d, L, -1, mat)\n  tubeY(k, mat, d.od * 0.3, rBore(d), G + d.t - 0.002, L - G - d.t + 0.002, 24)\n}\n\n/** Open API face at local y = 0 (flange body below): machined face and ring groove; optional studs for a studded outlet. */\nexport function apiStuddedFace(k: Kit, d: ApiFlange, studs = true) {\n  const nh = d.boltDia * 0.95\n  k.lathe('machined', [[d.ring / 2 + d.boltDia * 0.6, -G + 0.0008], [rBore(d), -G + 0.0008]], [0, 0, 0], 'y', 32)\n  k.torus('pipeBore', d.ring / 2, Math.max(0.003, d.boltDia * 0.16), [0, -G + 0.001, 0], 'y', 6, 32)\n  if (studs) k.boltCircle('boltXylan', 'nut', d.bolts, d.boltCircle / 2, [0, -d.boltDia * 1.2, 0], 'y', d.boltDia, d.boltDia * 1.2 + G * 2 + d.t + nh * 1.4, [d.boltDia * 1.2 + G * 2 + d.t + nh * 0.5])\n}\n\nexport type GateOp = { kind: 'handwheel'; D: number; mat?: MatKey } | { kind: 'hydraulic'; r: number; len: number }\n\n/** API 6A slab gate valve between flange faces y = 0 and y = L, bonnet along local +Z. */\nexport function apiGate(k: Kit, d: ApiFlange, L: number, op: GateOp, mat: MatKey = 'valveBody') {\n  apiFlangeAt(k, d, 0, 1, mat)\n  apiFlangeAt(k, d, L, -1, mat)\n  const rb = rBore(d)\n  tubeY(k, mat, d.od * 0.3, rb, G + d.t - 0.002, L - G - d.t + 0.002, 24)\n  const w = d.od * 0.8\n  const dz = d.od * 0.92\n  const hb = Math.max(0.05, Math.min(d.od * 1.0, L - 2 * (G + d.t) - 0.02))\n  const yc = L / 2\n  k.rbox(mat, [w, hb, dz], Math.min(0.025, w * 0.1), [0, yc, 0])\n  k.cyl('brass', 0.008, 0.03, [w / 2 + 0.012, yc + hb * 0.25, 0], 'x', 8)\n  k.hex('brass', 0.017, 0.012, [w / 2 + 0.029, yc + hb * 0.25, 0], 'x')\n  const rbf = Math.min(w * 0.5, hb * 0.5)\n  let z = dz / 2\n  const tbf = Math.max(0.03, d.t * 0.6)\n  k.cyl(mat, rbf, tbf, [0, yc, z + tbf / 2], 'z', 28)\n  k.around(8, rbf * 0.8, [0, yc, z + tbf + 0.008], 'z', (p) => k.hex('nut', Math.max(0.022, d.boltDia * 1.3), 0.016, p, 'z'), Math.PI / 8)\n  z += tbf\n  const bl = 0.07 + d.od * 0.18\n  const rbo = rbf * 0.66\n  k.cyl(mat, rbo, bl, [0, yc, z + bl / 2], 'z', 24)\n  z += bl\n  if (op.kind === 'handwheel') {\n    const sr = Math.max(0.011, d.od * 0.045)\n    k.cyl(mat, rbo * 0.62, 0.04, [0, yc, z + 0.02], 'z', 18)\n    k.cyl('stainless', sr, 0.12, [0, yc, z + 0.06], 'z', 12)\n    k.handwheel(op.mat ?? 'actuatorRed', op.D, [0, yc, z + 0.1], 'z', 4)\n    k.hex('nut', sr * 2.4, 0.02, [0, yc, z + 0.12], 'z')\n    return z + 0.13\n  }\n  k.cyl(mat, rbo * 0.85, 0.05, [0, yc, z + 0.025], 'z', 24)\n  z += 0.05\n  const { r, len } = op\n  k.cyl('actuatorYellow', r * 1.08, 0.03, [0, yc, z + 0.015], 'z', 32)\n  k.cyl('actuatorYellow', r, len, [0, yc, z + 0.03 + len / 2], 'z', 32)\n  k.cyl('actuatorYellow', r * 1.08, 0.035, [0, yc, z + 0.03 + len + 0.0175], 'z', 32)\n  k.around(4, r * 1.04, [0, yc, 0], 'z', (p) => {\n    k.rod('stainless', [p[0], p[1], z], [p[0], p[1], z + 0.065 + len + 0.012], 0.007, 8)\n    k.hex('nut', 0.02, 0.012, [p[0], p[1], z + 0.065 + len + 0.006], 'z')\n  }, Math.PI / 4)\n  const zt = z + 0.065 + len\n  k.cyl('stainless', 0.02, 0.1, [0, yc, zt + 0.05], 'z', 14)\n  k.cyl('safetyGreen', 0.023, 0.025, [0, yc, zt + 0.03], 'z', 14)\n  k.cyl('nameplate', r * 1.002, 0.04, [0, yc, z + 0.03 + len * 0.62], 'z', 32)\n  return zt + 0.1\n}\n\n/** 1/2\" needle valve on a boss along +axis from base, T-handle to the side. Returns the outlet end. */\nexport function needleValve(k: Kit, base: V3, axis: 'x' | 'y' | 'z' | '-x' | '-z', handle: MatKey = 'actuatorRed'): V3 {\n  const v: V3 = axis === 'y' ? [0, 1, 0] : axis === 'z' ? [0, 0, 1] : axis === '-z' ? [0, 0, -1] : axis === 'x' ? [1, 0, 0] : [-1, 0, 0]\n  const p = (t: number): V3 => [base[0] + v[0] * t, base[1] + v[1] * t, base[2] + v[2] * t]\n  k.hex('stainless', 0.032, 0.02, p(0.01), axis)\n  k.box('stainless', [0.036, 0.036, 0.036], p(0.042))\n  const side: V3 = axis === 'y' ? [1, 0, 0] : [0, 1, 0]\n  const q = p(0.042)\n  k.rod('stainless', q, [q[0] + side[0] * 0.05, q[1] + side[1] * 0.05, q[2] + side[2] * 0.05], 0.006, 8)\n  k.box(handle, axis === 'y' ? [0.012, 0.012, 0.06] : [0.06, 0.012, 0.012], [q[0] + side[0] * 0.055, q[1] + side[1] * 0.055, q[2] + side[2] * 0.055])\n  k.rod('stainless', p(0.06), p(0.105), 0.008, 8)\n  return p(0.105)\n}\n\n/** Threaded hammer-lug cover (mud pump valve cover, union nut) on local +Y from y = 0: body, three lugs, centre boss. */\nexport function hammerCap(k: Kit, mat: MatKey, R: number, h: number, lugs = 3) {\n  k.cyl(mat, R, h, [0, h / 2, 0], 'y', 32)\n  k.cyl(mat, R * 0.96, 0.006, [0, h + 0.003, 0], 'y', 32)\n  for (let i = 0; i < lugs; i++) {\n    const a = (i / lugs) * Math.PI * 2\n    k.box(mat, [R * 0.42, h * 0.8, R * 0.32], [Math.cos(a) * (R + R * 0.14), h * 0.45, Math.sin(a) * (R + R * 0.14)], new THREE.Quaternion().setFromAxisAngle(new THREE.Vector3(0, 1, 0), -a))\n  }\n  k.cyl(mat, R * 0.35, h * 0.3, [0, h + h * 0.15, 0], 'y', 20)\n}\n\n// ------------------------------------------------------------------ 2D helpers\n\n/** Convex hull (CCW) of circles sampled at n points each, as a THREE.Shape in XY. */\nexport function hullOfCircles(circles: [number, number, number][], n = 32): THREE.Shape {\n  const hull = hullPoints(circles, n)\n  const sh = new THREE.Shape()\n  hull.forEach(([x, y], i) => (i ? sh.lineTo(x, y) : sh.moveTo(x, y)))\n  sh.closePath()\n  return sh\n}\n\n/** Plate band of `thick` × `depth` (along +Z from z0) following the hull outline of the circles: guard rims, belts. */\nexport function hullBand(k: Kit, mat: MatKey, circles: [number, number, number][], z0: number, depth: number, thick: number, n = 48) {\n  const h = hullPoints(circles, n)\n  for (let i = 0; i < h.length; i++) {\n    const [x0, y0] = h[i]\n    const [x1, y1] = h[(i + 1) % h.length]\n    const len = Math.hypot(x1 - x0, y1 - y0)\n    if (len < 1e-5) continue\n    const nx = (y1 - y0) / len\n    const ny = -(x1 - x0) / len\n    const q = new THREE.Quaternion().setFromAxisAngle(new THREE.Vector3(0, 0, 1), Math.atan2(y1 - y0, x1 - x0))\n    k.box(mat, [len + thick * 0.6, thick, depth], [(x0 + x1) / 2 - (nx * thick) / 2, (y0 + y1) / 2 - (ny * thick) / 2, z0 + depth / 2], q)\n  }\n}\n\n/** Flat convex face (triangle fan) over the hull of the circles at z = z0, facing +Z (or -Z when flip). UVs scaled by uvs per metre. */\nexport function hullFace(circles: [number, number, number][], z0: number, flip = false, uvs = 1, n = 48): THREE.BufferGeometry {\n  const h = hullPoints(circles, n)\n  const cx = h.reduce((a, p) => a + p[0], 0) / h.length\n  const cy = h.reduce((a, p) => a + p[1], 0) / h.length\n  const pos: number[] = [cx, cy, z0]\n  const uv: number[] = [cx * uvs, cy * uvs]\n  for (const [x, y] of h) pos.push(x, y, z0), uv.push(x * uvs, y * uvs)\n  const idx: number[] = []\n  for (let i = 0; i < h.length; i++) {\n    const a = 1 + i\n    const b = 1 + ((i + 1) % h.length)\n    if (flip) idx.push(0, b, a)\n    else idx.push(0, a, b)\n  }\n  const g = new THREE.BufferGeometry()\n  g.setAttribute('position', new THREE.Float32BufferAttribute(pos, 3))\n  g.setAttribute('uv', new THREE.Float32BufferAttribute(uv, 2))\n  g.setIndex(idx)\n  g.computeVertexNormals()\n  return g\n}\n\nexport function hullPoints(circles: [number, number, number][], n = 32): [number, number][] {\n  const pts: [number, number][] = []\n  for (const [x, y, r] of circles) for (let i = 0; i < n; i++) pts.push([x + Math.cos((i / n) * Math.PI * 2) * r, y + Math.sin((i / n) * Math.PI * 2) * r])\n  pts.sort((a, b) => a[0] - b[0] || a[1] - b[1])\n  const cross = (o: number[], a: number[], b: number[]) => (a[0] - o[0]) * (b[1] - o[1]) - (a[1] - o[1]) * (b[0] - o[0])\n  const lo: [number, number][] = []\n  for (const p of pts) {\n    while (lo.length >= 2 && cross(lo[lo.length - 2], lo[lo.length - 1], p) <= 0) lo.pop()\n    lo.push(p)\n  }\n  const up: [number, number][] = []\n  for (let i = pts.length - 1; i >= 0; i--) {\n    const p = pts[i]\n    while (up.length >= 2 && cross(up[up.length - 2], up[up.length - 1], p) <= 0) up.pop()\n    up.push(p)\n  }\n  return lo.slice(0, -1).concat(up.slice(0, -1))\n}\n\n/** Matrix placing a shape drawn in XY onto the plane z = z0 (extrusion runs +Z). */\nexport const atZ = (z0: number) => mat4([0, 0, z0])\n\n// ------------------------------------------------------------------ subsea\n\n/** Mudmat at seabed y = 0: plate with edge skirts and stiffeners, top at y = t. */\nexport function mudmat(k: Kit, sx: number, sz: number, opts: { skirt?: number; mat?: MatKey; t?: number; padeyes?: boolean } = {}) {\n  const mat = opts.mat ?? 'equipmentPaint'\n  const t = opts.t ?? 0.05\n  const sk = opts.skirt ?? 0.25\n  // skirts penetrate the seabed; plate rests on y = 0\n  k.box(mat, [sx, t, sz], [0, t / 2, 0])\n  for (const s of [-1, 1]) {\n    k.box(mat, [sx, sk, 0.02], [0, -sk / 2 + 0.001, s * (sz / 2 - 0.01)])\n    k.box(mat, [0.02, sk, sz], [s * (sx / 2 - 0.01), -sk / 2 + 0.001, 0])\n  }\n  // top stiffeners (flat bar grid)\n  const nx = Math.max(2, Math.round(sx / 1.2))\n  const nz = Math.max(2, Math.round(sz / 1.2))\n  for (let i = 1; i < nx; i++) k.box(mat, [0.02, 0.12, sz - 0.04], [-sx / 2 + (sx * i) / nx, t + 0.06, 0])\n  for (let i = 1; i < nz; i++) k.box(mat, [sx - 0.04, 0.12, 0.02], [0, t + 0.06, -sz / 2 + (sz * i) / nz])\n  // water evacuation holes with short vent pipes\n  for (const sx2 of [-1, 1]) for (const sz2 of [-1, 1]) k.cyl(mat, 0.05, 0.1, [sx2 * sx * 0.25, t + 0.05, sz2 * sz * 0.25], 'y', 14, undefined, true)\n  if (opts.padeyes !== false) for (const sx2 of [-1, 1]) for (const sz2 of [-1, 1]) liftingLug(k, [sx2 * (sx / 2 - 0.2), t, sz2 * (sz / 2 - 0.2)], 'x', 1.6, mat)\n  return t\n}\n\n/** Sacrificial Al-Zn-In anode on two stand-off cores, long axis along `along`, centre at c. */\nexport function anode(k: Kit, c: V3, along: 'x' | 'z' | 'y' = 'x', len = 0.6) {\n  const size: V3 = along === 'x' ? [len, 0.1, 0.12] : along === 'z' ? [0.12, 0.1, len] : [0.12, len, 0.1]\n  k.rbox('aluminium', size, 0.02, c)\n  const off = len * 0.55\n  for (const s of [-1, 1]) {\n    const e: V3 = along === 'x' ? [c[0] + s * off, c[1], c[2]] : along === 'z' ? [c[0], c[1], c[2] + s * off] : [c[0], c[1] + s * off, c[2]]\n    k.box('stainless', [0.03, 0.03, 0.03], e)\n  }\n}\n\n/** API 17D class-4 style ROV torque bucket (open funnel, docking slots) on a back plate, opening facing +axis from base. */\nexport function rovBucket(k: Kit, base: V3, axis: 'x' | 'z' | '-x' | '-z' | 'y', mat: MatKey = 'actuatorYellow') {\n  k.at(base, axis, () => {\n    k.box(mat, [0.32, 0.02, 0.32], [0, 0.01, 0])\n    k.lathe(mat, [[0.07, 0.02], [0.085, 0.02], [0.085, 0.14], [0.11, 0.2], [0.1, 0.2], [0.075, 0.145], [0.07, 0.145]], [0, 0, 0], 'y', 28)\n    k.lathe('pipeBore', [[0.07, 0.145], [0.07, 0.025]], [0, 0, 0], 'y', 24)\n    k.cyl('stainless', 0.025, 0.04, [0, 0.04, 0], 'y', 6)\n    // docking slots and position indicator\n    for (const s of [-1, 1]) k.box('nut', [0.016, 0.05, 0.02], [s * 0.086, 0.17, 0])\n    k.box('nut', [0.05, 0.004, 0.012], [0, 0.022, 0.13])\n  })\n}\n\n/** Subsea hub (API 17R style) on local +Y from base along `axis`: neck, tapered hub profile, seal face, optional protection cap. Face at base + len. */\nexport function hub(k: Kit, base: V3, axis: 'x' | 'z' | '-x' | '-z' | 'y', boreR: number, len = 0.35, mat: MatKey = 'equipmentPaint', cap = false) {\n  const R = Math.max(0.12, boreR * 2.4)\n  k.at(base, axis, () => {\n    k.lathe(mat, [[boreR, 0], [R * 0.62, 0], [R * 0.62, len * 0.5], [R * 0.75, len * 0.55], [R, len * 0.78], [R, len - 0.01], [R * 0.95, len], [boreR, len]], [0, 0, 0], 'y', 40)\n    k.lathe('pipeBore', [[boreR, len], [boreR, -0.05]], [0, 0, 0], 'y', 24)\n    k.lathe('machined', [[R * 0.9, len + 0.001], [boreR, len + 0.001]], [0, 0, 0], 'y', 32)\n    if (cap) {\n      k.lathe('actuatorYellow', [[R * 1.04, len * 0.7], [R * 1.12, len * 0.7], [R * 1.12, len + 0.12], [0, len + 0.12]], [0, 0, 0], 'y', 32)\n      k.cyl('nut', 0.03, 0.08, [0, len + 0.16, 0], 'y', 6)\n    }\n  })\n  return R\n}\n\n// ------------------------------------------------------------------ chokes and frames\n\n/** Matrix whose local +Y runs along `flow` and local +Z along `stem`, origin at o. */\nexport function flowFrame(o: V3, flow: V3, stem: V3) {\n  const y = new THREE.Vector3(...flow).normalize()\n  const z = new THREE.Vector3(...stem).normalize()\n  const x = new THREE.Vector3().crossVectors(y, z).normalize()\n  return new THREE.Matrix4().makeBasis(x, y, z).setPosition(...o)\n}\n\n/** Angle choke body centre to inlet face (along -X) and outlet face (along -Y). */\nexport function chokeDims(dIn: ApiFlange, dOut: ApiFlange) {\n  const B = Math.max(dIn.od, dOut.od) * 0.78\n  return { B, inlet: B / 2 + 0.05 + dIn.t + G, outlet: B / 2 + 0.09 + dOut.t + G }\n}\n\n/** API 6A / 16C angle choke at the origin: inlet face -X, outlet face -Y, bonnet and operator along +X. Returns the operator's far x and its hose port. */\nexport function angleChoke(k: Kit, dIn: ApiFlange, dOut: ApiFlange, op: 'handwheel' | 'hydraulic', mat: MatKey = 'valveBody'): { end: number; hose: V3 | null } {\n  const { B, inlet, outlet } = chokeDims(dIn, dOut)\n  k.rbox(mat, [B, B, B * 0.92], Math.min(0.03, B * 0.12), [0, 0, 0])\n  const ri = rBore(dIn)\n  const ro = rBore(dOut)\n  k.at([0, 0, 0], '-x', () => tubeY(k, mat, dIn.od * 0.3, ri, B / 2 - 0.01, inlet - dIn.t - G + 0.002, 24))\n  k.at([0, 0, 0], '-y', () => tubeY(k, mat, dOut.od * 0.32, ro, B / 2 - 0.01, outlet - dOut.t - G + 0.002, 24))\n  k.at([-inlet, 0, 0], '-x', () => apiFlangeAt(k, dIn, 0, -1, mat))\n  k.at([0, -outlet, 0], '-y', () => apiFlangeAt(k, dOut, 0, -1, mat))\n  k.disc('internalsSteel', ri * 1.02, [-B / 2 + 0.012, 0, 0], '-x', 24)\n  k.disc('internalsSteel', ro * 1.02, [0, -B / 2 + 0.012, 0], '-y', 24)\n  // bonnet nut with hammer lugs, wear-sleeve bleed plug\n  k.hex('brass', 0.022, 0.016, [0, B * 0.25, B * 0.46 + 0.008], 'z')\n  let x = B / 2\n  const rn = B * 0.42\n  k.cyl(mat, rn * 0.9, 0.02, [x + 0.01, 0, 0], 'x', 24)\n  x += 0.02\n  k.cyl(mat, rn, 0.07, [x + 0.035, 0, 0], 'x', 24)\n  for (let i = 0; i < 3; i++) {\n    const a = (i / 3) * Math.PI * 2 + Math.PI / 6\n    k.box(mat, [0.06, B * 0.2, B * 0.13], [x + 0.035, Math.cos(a) * (rn + B * 0.08), Math.sin(a) * (rn + B * 0.08)], new THREE.Quaternion().setFromEuler(new THREE.Euler(-a, 0, 0)))\n  }\n  x += 0.07\n  k.cyl(mat, rn * 0.55, 0.1, [x + 0.05, 0, 0], 'x', 20)\n  x += 0.1\n  // position indicator sleeve with scale ring\n  k.cyl('stainless', rn * 0.4, 0.07, [x + 0.035, 0, 0], 'x', 18)\n  k.cyl('brass', rn * 0.42, 0.012, [x + 0.02, 0, 0], 'x', 18)\n  k.box('actuatorRed', [0.05, 0.004, 0.012], [x + 0.035, rn * 0.4 + 0.002, 0])\n  x += 0.07\n  if (op === 'handwheel') {\n    k.cyl('stainless', 0.014, 0.1, [x + 0.05, 0, 0], 'x', 10)\n    k.handwheel('actuatorRed', Math.max(0.3, B * 1.3), [x + 0.07, 0, 0], 'x', 4)\n    return { end: x + 0.1, hose: null }\n  }\n  // hydraulic rotary-gear actuator: gear housing, double-acting cylinder, stroke-position transmitter, manual override\n  k.cyl(mat, rn * 0.35, 0.05, [x + 0.025, 0, 0], 'x', 14)\n  x += 0.05\n  k.rbox('actuatorYellow', [0.2, 0.2, 0.22], 0.02, [x + 0.1, 0, 0])\n  k.cyl('actuatorYellow', 0.07, 0.42, [x + 0.1, 0.0, 0.0], 'z', 24)\n  for (const s of [-1, 1]) {\n    k.cyl('actuatorYellow', 0.078, 0.03, [x + 0.1, 0, s * 0.21], 'z', 24)\n    k.cyl('brass', 0.012, 0.035, [x + 0.1, 0.07, s * 0.19], 'y', 10)\n  }\n  k.rbox('stainless', [0.08, 0.1, 0.08], 0.01, [x + 0.25, 0.04, 0])\n  k.cyl('brass', 0.012, 0.03, [x + 0.25, -0.025, 0], 'y', 8)\n  k.hex('nut', 0.04, 0.03, [x + 0.1, 0.115, 0], 'y')\n  k.box('nameplate', [0.08, 0.05, 0.002], [x + 0.1, 0, 0.112])\n  return { end: x + 0.3, hose: [x + 0.1, 0.105, 0.19] }\n}\n\n/** ROV grab bar: round bar on two stand-offs between a and b, stand-off along `out`. */\nexport function grabBar(k: Kit, a: V3, b: V3, out: V3, mat: MatKey = 'actuatorYellow') {\n  const o = (p: V3, s: number): V3 => [p[0] + out[0] * s, p[1] + out[1] * s, p[2] + out[2] * s]\n  k.rod(mat, o(a, 0.12), o(b, 0.12), 0.019, 10)\n  for (const p of [a, b]) k.rod(mat, p, o(p, 0.12), 0.015, 8)\n}\n\n/**\n * Subsea trunnion ball valve between flange faces at local y = 0 and y = L (flow along local +Y), stem and ROV\n * gearbox along local +Z, class-4 bucket opening along local +X. Flanges are ASME B16.5 with studs.\n */\nexport function subseaBall(k: Kit, nps: number, rating: Rating, L: number, opts: { mat?: MatKey; bucket?: boolean } = {}) {\n  const mat = opts.mat ?? 'equipmentPaint'\n  const f = asmeFlange(nps, rating)\n  const ro = pipeOD(nps) / 2\n  const R = Math.max(ro * 1.55, f.od * 0.5)\n  const fl0 = flange(k, nps, rating, [0, 0, 0], '-y', true)\n  const fl1 = flange(k, nps, rating, [0, L, 0], 'y', true)\n  k.lathe(mat, [[ro * 0.9, fl0], [ro * 1.15, fl0], [R * 0.9, L / 2 - R * 0.75], [R, L / 2 - R * 0.35], [R, L / 2 + R * 0.35], [R * 0.9, L / 2 + R * 0.75], [ro * 1.15, L - fl1], [ro * 0.9, L - fl1]], [0, 0, 0], 'y', 40)\n  // body joint flanges with studs\n  for (const y of [L / 2 - R * 0.55, L / 2 + R * 0.55]) {\n    k.cyl(mat, R * 1.08, 0.05, [0, y, 0], 'y', 40)\n    k.around(12, R * 1.0, [0, y + 0.035, 0], 'y', (p) => k.hex('nut', 0.05, 0.03, p, 'y'), Math.PI / 12)\n  }\n  // trunnion boss, stem housing, gearbox, bucket\n  k.cyl(mat, R * 0.45, R * 0.4, [0, L / 2, -R - R * 0.15], 'z', 28)\n  k.cyl(mat, R * 0.45, R * 0.5, [0, L / 2, R + R * 0.2], 'z', 28)\n  const zg = R + R * 0.45\n  k.rbox('actuatorYellow', [R * 1.5, R * 1.2, R * 0.9], 0.04, [0, L / 2, zg + R * 0.45])\n  k.cyl('actuatorYellow', R * 0.35, R * 0.5, [R * 0.75, L / 2, zg + R * 0.45], 'x', 24)\n  k.box('nut', [0.12, 0.02, 0.012], [0, L / 2 + R * 0.6, zg + R * 0.9 + 0.006])\n  if (opts.bucket !== false) rovBucket(k, [R * 1.05 + 0.25, L / 2, zg + R * 0.45], 'x')\n  k.rod('actuatorYellow', [R * 1.0, L / 2, zg + R * 0.45], [R * 1.05 + 0.25, L / 2, zg + R * 0.45], 0.05, 16)\n  return { R, top: zg + R * 0.9 }\n}\n"
    }
  ],
  "categories": [
    "drilling"
  ],
  "meta": {
    "export": "UmbilicalTerminationAssembly",
    "anchor": "base",
    "standards": [
      "API 17E",
      "ISO 13628-5",
      "API 17D",
      "ISO 13628-8 (ROV interfaces)"
    ]
  }
}