// PROCITY Lane B — tram.js // v2 tram (?tram=1), default-off, NON-BLOCKING. One small bus/tram runs a seeded out-and-back loop // along the main-street spine, pausing (door dwell) at each bus_shelter stop (busShelterStops), then // reversing at the ends. Deterministic: the route + speed + dwell are fixed, so position is a pure // function of elapsed time — same each run. ≤2 draws (a textured body + a merged headlight pair). // Composes with weather/night (headlights glow at night). Flag-off identical (shell never builds it). // Bell-ready: ring() is a stub for the future door-bell audio. No traffic sim, no collision (v0). import * as THREE from 'three'; import { busShelterStops } from './furniture.js'; const SPEED = 9; // m/s cruising const DWELL = 3.5; // s door pause at each stop const LANE = 3.2; // offset from the road centreline (drive on the left, AU) // Ordered spine polyline: walk the chain of MAIN edges from a spine end. Returns [[x,z],…] or null. function spinePolyline(plan) { const nodes = new Map(plan.streets.nodes.map((n) => [n.id, n])); const mains = plan.streets.edges.filter((e) => e.kind === 'main'); if (!mains.length) return null; const byNode = new Map(); for (const e of mains) for (const nid of [e.a, e.b]) { if (!byNode.has(nid)) byNode.set(nid, []); byNode.get(nid).push(e); } let start = null; for (const [nid, es] of byNode) if (es.length === 1) { start = nid; break; } if (start == null) start = mains[0].a; const seq = [start]; const used = new Set(); let cur = start; for (;;) { const next = (byNode.get(cur) || []).find((e) => !used.has(e.id)); if (!next) break; used.add(next.id); cur = next.a === cur ? next.b : next.a; seq.push(cur); } return seq.map((id) => { const n = nodes.get(id); return [n.x, n.z]; }); } // bus livery texture (canvas — no fetch): cream body, window band, a red stripe + a route blind. function busTexture() { const c = document.createElement('canvas'); c.width = 256; c.height = 128; const x = c.getContext('2d'); x.fillStyle = '#e8e0cf'; x.fillRect(0, 0, 256, 128); // cream x.fillStyle = '#233043'; x.fillRect(0, 30, 256, 42); // window band for (let i = 12; i < 256; i += 34) { x.fillStyle = '#9fb2c8'; x.fillRect(i, 34, 24, 34); } // panes x.fillStyle = '#9a2f2a'; x.fillRect(0, 78, 256, 10); // red stripe x.fillStyle = '#1a1a1a'; x.fillRect(96, 6, 64, 20); // route blind x.fillStyle = '#ffd75e'; x.font = 'bold 15px Arial'; x.textAlign = 'center'; x.textBaseline = 'middle'; x.fillText('TOWN LOOP', 128, 16); const t = new THREE.CanvasTexture(c); t.colorSpace = THREE.SRGBColorSpace; t.anisotropy = 4; return t; } export function createTram({ scene, plan, camera, lighting }) { const route = spinePolyline(plan); const group = new THREE.Group(); group.name = 'tram'; if (!route || route.length < 2) { scene.add(group); return { group, update() {}, ring() {}, dispose() { scene.remove(group); } }; } // ── cumulative arc length + stop positions projected to arc length ── const seg = []; // { x0,z0, dx,dz, len, s0 } let total = 0; for (let i = 0; i < route.length - 1; i++) { const [x0, z0] = route[i], [x1, z1] = route[i + 1]; const dx = x1 - x0, dz = z1 - z0, len = Math.hypot(dx, dz) || 1; seg.push({ x0, z0, dx: dx / len, dz: dz / len, len, s0: total }); total += len; } const posAt = (s) => { s = Math.max(0, Math.min(total, s)); let g = seg[0]; for (const q of seg) if (s >= q.s0) g = q; const d = s - g.s0; return { x: g.x0 + g.dx * d, z: g.z0 + g.dz * d, dx: g.dx, dz: g.dz }; }; // project each shelter stop onto the route → sorted arc-length stop marks const stopS = busShelterStops(plan).map((st) => { let best = 0, bd = 1e18; for (let s = 0; s <= total; s += 3) { const p = posAt(s); const dd = (p.x - st.x) ** 2 + (p.z - st.z) ** 2; if (dd < bd) { bd = dd; best = s; } } return best; }).sort((a, b) => a - b); // ── tram mesh: textured body (1 draw) + merged emissive headlights (1 draw) ── const bodyMat = new THREE.MeshStandardMaterial({ map: busTexture(), roughness: 0.7, metalness: 0.1 }); const body = new THREE.Mesh(new THREE.BoxGeometry(2.4, 2.7, 9.0), bodyMat); body.position.y = 1.55; body.castShadow = true; group.add(body); const headMat = new THREE.MeshStandardMaterial({ color: 0xfff2cc, emissive: new THREE.Color(0xffe6a0), emissiveIntensity: 0.2, roughness: 0.4 }); const hl = (x) => { const q = new THREE.PlaneGeometry(0.4, 0.3); q.rotateY(0).translate(x, 0.9, 4.55); return q; }; const heads = new THREE.Mesh(mergeQuads([hl(-0.8), hl(0.8)]), headMat); group.add(heads); scene.add(group); // ── deterministic schedule: position s(t) with dwell at stops, ping-pong at the ends ── let s = 0, dir = 1, dwell = 0, nextStop = 0; const EPS = 2.5; function update(dt) { if (dwell > 0) { dwell = Math.max(0, dwell - dt); } else { s += dir * SPEED * dt; // stop dwell when passing a mark in the travel direction if (dir > 0 && nextStop < stopS.length && s >= stopS[nextStop] - EPS) { s = stopS[nextStop]; dwell = DWELL; nextStop++; } else if (dir < 0 && nextStop >= 0 && stopS[nextStop] != null && s <= stopS[nextStop] + EPS) { s = stopS[nextStop]; dwell = DWELL; nextStop--; } if (s >= total) { s = total; dir = -1; nextStop = stopS.length - 1; } else if (s <= 0) { s = 0; dir = 1; nextStop = 0; } } const p = posAt(s); // sit in the left lane relative to travel direction, face along travel const perpx = -p.dz * dir, perpz = p.dx * dir; group.position.set(p.x + perpx * LANE, 0, p.z + perpz * LANE); group.rotation.y = Math.atan2(p.dx * dir, p.dz * dir); headMat.emissiveIntensity = (lighting && lighting.isNight && lighting.isNight()) ? 1.6 : 0.15; } update(0); function ring() { /* door-bell hook — audio parked (V2_IDEAS greenfield) */ } function dispose() { body.geometry.dispose(); bodyMat.map.dispose(); bodyMat.dispose(); heads.geometry.dispose(); headMat.dispose(); scene.remove(group); } return { group, update, ring, dispose, get stops() { return stopS.length; } }; } function mergeQuads(geos) { // tiny local merge (headlight quads share a material) — avoids importing BufferGeometryUtils for 2 quads let n = 0; for (const g of geos) n += g.attributes.position.count; const pos = new Float32Array(n * 3), uv = new Float32Array(n * 2), nor = new Float32Array(n * 3); const idx = []; let vo = 0; for (const g of geos) { const gp = g.attributes.position.array, gu = g.attributes.uv.array, gn = g.attributes.normal.array; pos.set(gp, vo * 3); uv.set(gu, vo * 2); nor.set(gn, vo * 3); const gi = g.index ? g.index.array : [...Array(g.attributes.position.count).keys()]; for (const i of gi) idx.push(i + vo); vo += g.attributes.position.count; g.dispose(); } const m = new THREE.BufferGeometry(); m.setAttribute('position', new THREE.BufferAttribute(pos, 3)); m.setAttribute('uv', new THREE.BufferAttribute(uv, 2)); m.setAttribute('normal', new THREE.BufferAttribute(nor, 3)); m.setIndex(idx); return m; }