{ "$schema": "https://ui.shadcn.com/schema/registry-item.json", "name": "opportunities", "title": "Opportunities", "description": "The opportunity matrix family: every routing pathway considered for a material requirement — multi-step routes, itemised cost estimates, compatibility scores and AI viability assessments — presented visually first (a proximity map, a cost-proportional flow canvas and a cost-vs-readiness decision grid) with comparable cards, a baseline-anchored comparison, a full transparency matrix and a composable detail record behind.", "dependencies": [ "@untitledui/icons@^0.0.22" ], "registryDependencies": [ "@nx-ui/badge", "@nx-ui/card", "@nx-ui/table", "@nx-ui/utils" ], "files": [ { "path": "components/blocks/domain/opportunities/cost-breakdown.tsx", "content": "import { cn } from \"@/lib/utils\"\nimport { SavingsDelta } from \"./opportunity-primitives\"\nimport {\n COST_KIND_LABELS,\n formatMoney,\n formatPerTonne,\n opportunityTotalCost,\n type CostKind,\n type MaterialRequirement,\n type Opportunity,\n} from \"./types\"\n\n/**\n * CostBreakdown — the itemised cost estimate for one pathway: a proportional\n * composition bar (positive lines only, coloured by cost kind), the line\n * items with notes and estimated/quoted treatment, the net total (with a\n * per-tonne rate when the requirement is supplied) and, against a baseline,\n * the delta. Credits (negative lines) render green and sit outside the bar.\n */\n\nconst COST_KIND_BAR_CLASSES: Record = {\n haulage: \"bg-utility-blue-500\",\n gate_fee: \"bg-utility-orange-500\",\n landfill_tax: \"bg-utility-red-500\",\n treatment: \"bg-utility-purple-500\",\n testing: \"bg-utility-sky-500\",\n storage: \"bg-utility-amber-500\",\n material_purchase: \"bg-utility-indigo-500\",\n processing: \"bg-utility-fuchsia-500\",\n admin: \"bg-utility-neutral-500\",\n credit: \"bg-utility-green-500\",\n other: \"bg-utility-slate-500\",\n}\n\nfunction amountLabel(amount: number, estimated?: boolean): string {\n const formatted = formatMoney(amount)\n return estimated ? `~${formatted}` : formatted\n}\n\nexport function CostBreakdown({\n opportunity,\n baseline,\n requirement,\n className,\n}: {\n opportunity: Opportunity\n /** When given (and this isn't it), a comparison row is appended. */\n baseline?: Opportunity\n /** Enables the per-tonne rate on the total row. */\n requirement?: MaterialRequirement\n className?: string\n}) {\n const positive = opportunity.costs.filter((line) => line.amount > 0)\n const grossPositive = positive.reduce((sum, line) => sum + line.amount, 0)\n const total = opportunityTotalCost(opportunity)\n const legendKinds = [...new Set(positive.map((line) => line.kind))]\n\n return (\n
\n {positive.length > 0 ? (\n
\n
\n {positive.map((line) => (\n \n ))}\n
\n
\n {legendKinds.map((kind) => (\n \n \n {COST_KIND_LABELS[kind]}\n \n ))}\n
\n
\n ) : null}\n\n \n\n
\n \n Estimated net cost\n \n \n {requirement ? (\n \n {formatPerTonne(total, requirement)}\n \n ) : null}\n \n {formatMoney(total)}\n \n \n
\n\n {baseline && !opportunity.isBaseline ? (\n
\n \n Baseline — {baseline.name}: {formatMoney(opportunityTotalCost(baseline))}\n \n \n
\n ) : null}\n
\n )\n}\n", "type": "registry:component", "target": "components/blocks/domain/opportunities/cost-breakdown.tsx" }, { "path": "components/blocks/domain/opportunities/data.ts", "content": "/**\n * Demo datasets for the opportunity matrix family. Two scenarios exercise\n * both requirement directions: a topsoil surplus (export) with disposal,\n * re-use, treatment and storage pathways, and a 6F2 capping need (import)\n * with primary, recycled, surplus and site-won sources. Figures are\n * illustrative but internally consistent (same load counts, per-tonne rates\n * and volumes across lines) so comparison surfaces read sensibly.\n */\n\nimport type { MaterialRequirement, Opportunity } from \"./types\"\n\n// ---------------------------------------------------------------------------\n// Scenario 1 — export: surplus topsoil, Riverside Quarter (Bristol)\n// ---------------------------------------------------------------------------\n\nexport const TOPSOIL_REQUIREMENT: MaterialRequirement = {\n id: \"req-topsoil-export\",\n direction: \"export\",\n title: \"Surplus topsoil — Riverside Quarter\",\n projectName: \"Riverside Quarter\",\n material: {\n classLabel: \"Topsoil\",\n termLabel: \"Topsoil — natural, stripped\",\n ewcCode: \"17 05 04\",\n regulatoryStatus: \"waste\",\n qualityLevel: \"tested\",\n },\n quantity: { value: 3800, unit: \"m³\", volumeM3: 3800, tonnes: 5300 },\n location: { name: \"Bedminster, Bristol\", postcode: \"BS3 4NA\" },\n window: { from: \"2026-08-03\", until: \"2026-10-30\" },\n summary:\n \"Phase 1 earthworks strip generates 3,800 m³ of tested topsoil that must leave site between August and the end of October. The engine considered 7 pathways; 5 remain open.\",\n}\n\nexport const TOPSOIL_OPPORTUNITIES: Opportunity[] = [\n {\n id: \"opp-shortwood-landfill\",\n requirementId: \"req-topsoil-export\",\n name: \"Disposal — Shortwood Landfill\",\n strategy: \"landfill_disposal\",\n isBaseline: true,\n headline: \"The default route: guaranteed capacity at the highest cost.\",\n partner: { name: \"Vale Waste Management\", siteName: \"Shortwood Landfill\" },\n route: [\n { id: \"n1\", kind: \"site\", label: \"Riverside Quarter\" },\n {\n id: \"n2\",\n kind: \"landfill\",\n label: \"Shortwood Landfill\",\n geo: { bearingDeg: 75, distanceKm: 16 },\n detail: \"Disposal as inert waste, EWC 17 05 04\",\n legDistanceKm: 18,\n },\n ],\n totalDistanceKm: 18,\n costs: [\n {\n id: \"c1\",\n kind: \"haulage\",\n label: \"Haulage — 265 loads to Shortwood\",\n amount: 47700,\n note: \"18 km each way at ~£9/t\",\n estimated: true,\n },\n {\n id: \"c2\",\n kind: \"gate_fee\",\n label: \"Gate fee\",\n amount: 95400,\n note: \"£18/t on 5,300 t\",\n },\n {\n id: \"c3\",\n kind: \"landfill_tax\",\n label: \"Landfill tax — lower (inert) rate\",\n amount: 21465,\n note: \"£4.05/t; standard rate £126.15/t applies if WAC fails\",\n },\n ],\n timing: { fit: \"good\", note: \"Accepts material year-round\" },\n viability: {\n verdict: \"viable\",\n confidence: 0.95,\n summary:\n \"Always available as a fallback, but the most expensive open pathway by a wide margin and the worst sustainability outcome.\",\n strengths: [\"Guaranteed capacity with no counterparty risk\", \"No programme dependency\"],\n risks: [\n \"A failed WAC test reclassifies the load at the standard tax rate — roughly £640,000 more\",\n \"Scores zero against the project's material re-use targets\",\n ],\n conditions: [\n {\n id: \"v1\",\n label: \"WAC characterisation testing\",\n status: \"pending\",\n detail: \"Sampling booked for the week of 20 July\",\n },\n ],\n assessedAt: \"2026-07-04T06:12:00Z\",\n },\n compliance: [\n { id: \"k1\", label: \"Waste transfer notes per load\", status: \"ok\" },\n { id: \"k2\", label: \"Carrier registration (WCL)\", status: \"ok\" },\n { id: \"k3\", label: \"Receiver environmental permit\", status: \"ok\" },\n { id: \"k4\", label: \"WAC test results\", status: \"pending\" },\n ],\n status: \"new\",\n },\n {\n id: \"opp-meadowbank-reuse\",\n requirementId: \"req-topsoil-export\",\n name: \"Direct re-use — Meadowbank Park\",\n strategy: \"direct_reuse\",\n headline: \"Their landscaping needs 5,000 m³ from September — an exact material match 12 km away.\",\n partner: { name: \"Harborne Developments\", siteName: \"Meadowbank Park\" },\n route: [\n { id: \"n1\", kind: \"site\", label: \"Riverside Quarter\" },\n {\n id: \"n2\",\n kind: \"receiving_site\",\n label: \"Meadowbank Park\",\n geo: { bearingDeg: 20, distanceKm: 11 },\n detail: \"Placed as landscaping fill under DoW:CoP\",\n legDistanceKm: 12,\n },\n ],\n totalDistanceKm: 12,\n costs: [\n {\n id: \"c1\",\n kind: \"haulage\",\n label: \"Haulage — 265 loads to Meadowbank\",\n amount: 31800,\n note: \"12 km each way at ~£6/t\",\n estimated: true,\n },\n {\n id: \"c2\",\n kind: \"testing\",\n label: \"BS 3882 laboratory suite\",\n amount: 3400,\n note: \"MFT, pH, nutrients and contamination screen\",\n },\n {\n id: \"c3\",\n kind: \"admin\",\n label: \"DoW:CoP declaration and materials management plan\",\n amount: 1900,\n },\n ],\n timing: {\n fit: \"good\",\n note: \"They take delivery from September; your clearance runs to end October\",\n },\n compatibility: {\n score: 92,\n breakdown: { material: 1, distance: 0.93, quantity: 0.85 },\n relation: \"exact\",\n explainers: [\n \"Exact material term match\",\n \"Very close proximity (12 km)\",\n \"Receiving requirement of 5,000 m³ absorbs the full volume\",\n ],\n },\n viability: {\n verdict: \"conditional\",\n confidence: 0.78,\n summary:\n \"Strong match with major savings, provided the BS 3882 results come back within specification.\",\n strengths: [\n \"Waste-to-product transfer under DoW:CoP removes gate fee and landfill tax entirely\",\n \"Programme windows align with six weeks of slack\",\n \"Shortest haul of any open pathway\",\n ],\n risks: [\n \"Prior observations show slightly elevated pH — a failed MFT would need blending before placement\",\n \"Receiving site's landscaping package is not yet let\",\n ],\n conditions: [\n { id: \"v1\", label: \"BS 3882 laboratory results\", status: \"pending\", detail: \"Results expected 24 July\" },\n { id: \"v2\", label: \"DoW:CoP declaration\", status: \"action_needed\", detail: \"Draft prepared; needs both parties' sign-off\" },\n { id: \"v3\", label: \"Receiving materials management plan\", status: \"met\" },\n ],\n assessedAt: \"2026-07-04T06:12:00Z\",\n },\n compliance: [\n { id: \"k1\", label: \"Materials management plan\", status: \"ok\" },\n { id: \"k2\", label: \"DoW:CoP declaration\", status: \"gap\" },\n { id: \"k3\", label: \"Carrier registration (WCL)\", status: \"ok\" },\n ],\n status: \"shortlisted\",\n },\n {\n id: \"opp-avonmouth-hartcliffe\",\n requirementId: \"req-topsoil-export\",\n name: \"Treat, then re-use — Hartcliffe Green\",\n strategy: \"treat_then_reuse\",\n headline: \"Screening at Avonmouth brings the soil to BS 3882, opening a confirmed placement.\",\n partner: { name: \"Severn Soils\", siteName: \"Avonmouth Soil Treatment Centre\" },\n route: [\n { id: \"n1\", kind: \"site\", label: \"Riverside Quarter\" },\n {\n id: \"n2\",\n kind: \"treatment_facility\",\n label: \"Avonmouth Soil Treatment Centre\",\n geo: { bearingDeg: 310, distanceKm: 8 },\n detail: \"Screen to 10 mm and blend to BS 3882 general purpose\",\n legDistanceKm: 9,\n },\n {\n id: \"n3\",\n kind: \"receiving_site\",\n label: \"Hartcliffe Green scheme\",\n geo: { bearingDeg: 170, distanceKm: 5 },\n detail: \"Placed as amenity topsoil\",\n legDistanceKm: 14,\n },\n ],\n totalDistanceKm: 23,\n costs: [\n {\n id: \"c1\",\n kind: \"haulage\",\n label: \"Haulage — site to Avonmouth\",\n amount: 23850,\n note: \"9 km at ~£4.50/t\",\n estimated: true,\n },\n {\n id: \"c2\",\n kind: \"treatment\",\n label: \"Screening and blending\",\n amount: 42400,\n note: \"£8/t on 5,300 t, quoted\",\n },\n {\n id: \"c3\",\n kind: \"haulage\",\n label: \"Haulage — Avonmouth to Hartcliffe\",\n amount: 37100,\n note: \"14 km at ~£7/t\",\n estimated: true,\n },\n {\n id: \"c4\",\n kind: \"testing\",\n label: \"Post-treatment validation\",\n amount: 2800,\n },\n ],\n timing: { fit: \"good\", note: \"Facility throughput 1,200 t/week — five weeks of processing\" },\n compatibility: {\n score: 81,\n breakdown: { material: 0.7, distance: 0.88, quantity: 1 },\n relation: \"same_class\",\n explainers: [\n \"Same material class; treatment closes the specification gap\",\n \"Both legs well inside the haulage radius\",\n \"Quantity fully meets the receiving requirement\",\n ],\n },\n viability: {\n verdict: \"viable\",\n confidence: 0.86,\n summary:\n \"The treatment step guarantees specification, converting an uncertain match into a confirmed placement at well under landfill cost.\",\n strengths: [\n \"Facility has confirmed capacity in writing\",\n \"Treatment de-risks the specification question entirely\",\n \"Receiving scheme has an agreed take-off\",\n ],\n risks: [\"Two handling steps add programme dependency\", \"Quoted treatment rate holds until 15 August\"],\n conditions: [\n { id: \"v1\", label: \"Facility acceptance criteria\", status: \"met\" },\n { id: \"v2\", label: \"Post-treatment validation testing\", status: \"pending\" },\n ],\n assessedAt: \"2026-07-04T06:12:00Z\",\n },\n compliance: [\n { id: \"k1\", label: \"Waste transfer notes per load\", status: \"ok\" },\n { id: \"k2\", label: \"Treatment facility permit\", status: \"ok\" },\n { id: \"k3\", label: \"Carrier registration (WCL)\", status: \"ok\" },\n { id: \"k4\", label: \"Post-treatment quality declaration\", status: \"pending\" },\n ],\n status: \"new\",\n },\n {\n id: \"opp-treat-and-return\",\n requirementId: \"req-topsoil-export\",\n name: \"Treat off site and return\",\n strategy: \"treat_and_return\",\n headline: \"Screen at Avonmouth, hold, and return for phase 2 landscaping — avoiding a future purchase.\",\n partner: { name: \"Severn Soils\", siteName: \"Avonmouth Soil Treatment Centre\" },\n route: [\n { id: \"n1\", kind: \"site\", label: \"Riverside Quarter\" },\n {\n id: \"n2\",\n kind: \"treatment_facility\",\n label: \"Avonmouth Soil Treatment Centre\",\n geo: { bearingDeg: 310, distanceKm: 8 },\n detail: \"Screen and blend to BS 3882, then hold\",\n legDistanceKm: 9,\n dwellNote: \"held ~10 weeks\",\n },\n {\n id: \"n3\",\n kind: \"site\",\n label: \"Riverside Quarter (return)\",\n geo: { bearingDeg: 0, distanceKm: 0 },\n detail: \"Placed in phase 2 landscaping\",\n legDistanceKm: 9,\n },\n ],\n totalDistanceKm: 18,\n costs: [\n {\n id: \"c1\",\n kind: \"haulage\",\n label: \"Haulage — site to Avonmouth\",\n amount: 23850,\n note: \"9 km at ~£4.50/t\",\n estimated: true,\n },\n {\n id: \"c2\",\n kind: \"treatment\",\n label: \"Screening and blending\",\n amount: 42400,\n note: \"£8/t on 5,300 t, quoted\",\n },\n {\n id: \"c3\",\n kind: \"storage\",\n label: \"Holding at facility — 10 weeks\",\n amount: 13250,\n estimated: true,\n },\n {\n id: \"c4\",\n kind: \"haulage\",\n label: \"Haulage — return to site\",\n amount: 23850,\n estimated: true,\n },\n {\n id: \"c5\",\n kind: \"credit\",\n label: \"Avoided phase 2 topsoil purchase\",\n amount: -83600,\n note: \"3,800 m³ at ~£22/m³ delivered\",\n estimated: true,\n },\n ],\n timing: { fit: \"tight\", note: \"Return depends on phase 2 landscaping starting in November as programmed\" },\n viability: {\n verdict: \"conditional\",\n confidence: 0.62,\n summary:\n \"The cheapest net position of any pathway if phase 2 proceeds on programme — but highly sensitive to the phase 2 start date.\",\n strengths: [\n \"Offsets a purchase you would otherwise make in November\",\n \"Material provenance stays under your control\",\n \"Waste-to-product transfer removes disposal costs\",\n ],\n risks: [\n \"A phase 2 slip turns holding into an open-ended monthly cost\",\n \"Double handling raises the damage and segregation risk\",\n ],\n conditions: [\n { id: \"v1\", label: \"Phase 2 start date confirmed\", status: \"action_needed\", detail: \"Awaiting the November programme freeze\" },\n { id: \"v2\", label: \"Facility storage agreement\", status: \"pending\" },\n ],\n assessedAt: \"2026-07-04T06:12:00Z\",\n },\n compliance: [\n { id: \"k1\", label: \"Waste transfer notes per load\", status: \"ok\" },\n { id: \"k2\", label: \"Treatment facility permit\", status: \"ok\" },\n { id: \"k3\", label: \"Post-treatment quality declaration\", status: \"pending\" },\n ],\n status: \"new\",\n },\n {\n id: \"opp-severnside-stockpile\",\n requirementId: \"req-topsoil-export\",\n name: \"Stockpile — Severnside Storage Yard\",\n strategy: \"stockpile_hold\",\n headline: \"Move it 6 km and hold while a better match is found.\",\n partner: { name: \"Severnside Yard Ltd\" },\n route: [\n { id: \"n1\", kind: \"site\", label: \"Riverside Quarter\" },\n {\n id: \"n2\",\n kind: \"stockpile\",\n label: \"Severnside Storage Yard\",\n geo: { bearingDeg: 343, distanceKm: 5.5 },\n detail: \"Open stockpile, tarped\",\n legDistanceKm: 6,\n dwellNote: \"held until matched\",\n },\n ],\n totalDistanceKm: 6,\n costs: [\n {\n id: \"c1\",\n kind: \"haulage\",\n label: \"Haulage — 265 loads to Severnside\",\n amount: 15900,\n note: \"6 km at ~£3/t\",\n estimated: true,\n },\n {\n id: \"c2\",\n kind: \"storage\",\n label: \"Storage — 4 months modelled\",\n amount: 44520,\n note: \"£2.10/t per month; accrues until matched\",\n estimated: true,\n },\n { id: \"c3\", kind: \"admin\", label: \"Yard licence and records\", amount: 950 },\n ],\n timing: { fit: \"tight\", note: \"Clears your window, but the end use is unmatched\" },\n viability: {\n verdict: \"unlikely\",\n confidence: 0.45,\n summary:\n \"Defers the problem rather than solving it: storage accrues monthly, a second haul is still to pay, and no end use is matched yet.\",\n strengths: [\"Preserves optionality if a premium match appears later\", \"Clears the site fastest\"],\n risks: [\n \"Open-ended monthly cost with no matched buyer\",\n \"Outdoor storage degrades topsoil structure over winter\",\n \"Second haulage movement still to fund\",\n ],\n conditions: [\n { id: \"v1\", label: \"End use identified\", status: \"action_needed\" },\n { id: \"v2\", label: \"Yard permit headroom\", status: \"met\" },\n ],\n assessedAt: \"2026-07-04T06:12:00Z\",\n },\n compliance: [\n { id: \"k1\", label: \"Waste transfer notes per load\", status: \"ok\" },\n { id: \"k2\", label: \"Storage site permit\", status: \"ok\" },\n ],\n status: \"new\",\n },\n {\n id: \"opp-wraxall-recovery\",\n requirementId: \"req-topsoil-export\",\n name: \"Land recovery — Wraxall Farm\",\n strategy: \"recovery\",\n headline: \"Agricultural improvement 21 km south — capped by the receiving exemption.\",\n partner: { name: \"Wraxall Farm Partnership\" },\n route: [\n { id: \"n1\", kind: \"site\", label: \"Riverside Quarter\" },\n {\n id: \"n2\",\n kind: \"receiving_site\",\n label: \"Wraxall Farm\",\n geo: { bearingDeg: 215, distanceKm: 18 },\n detail: \"Spread for agricultural improvement under a U1 exemption\",\n legDistanceKm: 21,\n },\n ],\n totalDistanceKm: 21,\n costs: [\n {\n id: \"c1\",\n kind: \"haulage\",\n label: \"Haulage — full volume\",\n amount: 55650,\n note: \"21 km at ~£10.50/t\",\n estimated: true,\n },\n { id: \"c2\", kind: \"processing\", label: \"Spreading and placement\", amount: 12000, estimated: true },\n ],\n timing: { fit: \"good\", note: \"Receiving land available through autumn\" },\n compatibility: {\n score: 74,\n breakdown: { material: 0.7, distance: 0.62, quantity: 1 },\n relation: \"same_class\",\n explainers: [\"Same material class\", \"Within the haulage radius\", \"Land could notionally take the full volume\"],\n },\n viability: {\n verdict: \"ruled_out\",\n confidence: 0.9,\n summary:\n \"The receiving land's U1 exemption caps deposits at 1,000 t — under a fifth of the volume — so the pathway cannot clear the requirement.\",\n strengths: [],\n risks: [],\n conditions: [],\n ruledOutReason: \"Volume exceeds the receiving U1 exemption limit (1,000 t)\",\n assessedAt: \"2026-07-04T06:12:00Z\",\n },\n compliance: [\n { id: \"k1\", label: \"Receiving exemption headroom\", status: \"gap\" },\n ],\n status: \"dismissed\",\n },\n {\n id: \"opp-bathside-link\",\n requirementId: \"req-topsoil-export\",\n name: \"Direct re-use — Bathside Link Road\",\n strategy: \"direct_reuse\",\n headline: \"An exact material match, but their programme starts after your site must clear.\",\n partner: { name: \"Kennet Infrastructure\", siteName: \"Bathside Link Road\" },\n route: [\n { id: \"n1\", kind: \"site\", label: \"Riverside Quarter\" },\n {\n id: \"n2\",\n kind: \"receiving_site\",\n label: \"Bathside Link Road\",\n geo: { bearingDeg: 100, distanceKm: 23 },\n detail: \"Verge and embankment topsoiling\",\n legDistanceKm: 26,\n },\n ],\n totalDistanceKm: 26,\n costs: [\n {\n id: \"c1\",\n kind: \"haulage\",\n label: \"Haulage — full volume\",\n amount: 63600,\n note: \"26 km at ~£12/t\",\n estimated: true,\n },\n { id: \"c2\", kind: \"testing\", label: \"BS 3882 laboratory suite\", amount: 3400 },\n ],\n timing: { fit: \"mismatch\", note: \"They need material from January 2027; you must clear by end October\" },\n compatibility: {\n score: 68,\n breakdown: { material: 1, distance: 0.55, quantity: 0.6 },\n relation: \"exact\",\n explainers: [\"Exact material term match\", \"Moderate haul (26 km)\", \"Their requirement takes ~60% of the volume\"],\n },\n viability: {\n verdict: \"ruled_out\",\n confidence: 0.85,\n summary:\n \"Programme windows do not overlap: the receiving scheme cannot take material until January, three months after your clearance deadline.\",\n strengths: [],\n risks: [],\n conditions: [],\n ruledOutReason: \"Programme windows do not overlap (theirs opens January 2027)\",\n assessedAt: \"2026-07-04T06:12:00Z\",\n },\n compliance: [],\n status: \"dismissed\",\n },\n]\n\n// ---------------------------------------------------------------------------\n// Scenario 2 — import: 6F2 capping aggregate, Temple Quay Phase 2 (Bristol)\n// ---------------------------------------------------------------------------\n\nexport const AGGREGATE_REQUIREMENT: MaterialRequirement = {\n id: \"req-aggregate-import\",\n direction: \"import\",\n title: \"6F2 capping aggregate — Temple Quay Phase 2\",\n projectName: \"Temple Quay Phase 2\",\n material: {\n classLabel: \"Aggregate\",\n termLabel: \"6F2 capping / fill\",\n regulatoryStatus: \"product\",\n qualityLevel: \"declared\",\n },\n quantity: { value: 2400, unit: \"m³\", volumeM3: 2400, tonnes: 4800 },\n location: { name: \"Temple Quay, Bristol\", postcode: \"BS1 6DG\" },\n window: { from: \"2026-09-14\", until: \"2026-11-20\" },\n summary:\n \"The podium slab programme needs 2,400 m³ of 6F2 capping between mid-September and late November. The engine considered 5 sources; 4 remain open.\",\n}\n\nexport const AGGREGATE_OPPORTUNITIES: Opportunity[] = [\n {\n id: \"opp-wenvoe-quarry\",\n requirementId: \"req-aggregate-import\",\n name: \"Primary supply — Wenvoe Quarry\",\n strategy: \"supply_primary\",\n isBaseline: true,\n headline: \"The default route: quarried limestone 6F2, guaranteed spec, longest haul.\",\n partner: { name: \"Cambrian Aggregates\", siteName: \"Wenvoe Quarry\" },\n route: [\n {\n id: \"n1\",\n kind: \"supplier\",\n label: \"Wenvoe Quarry\",\n detail: \"Quarried limestone 6F2\",\n geo: { bearingDeg: 275, distanceKm: 32 },\n },\n { id: \"n2\", kind: \"site\", label: \"Temple Quay Phase 2\", legDistanceKm: 34 },\n ],\n totalDistanceKm: 34,\n costs: [\n {\n id: \"c1\",\n kind: \"material_purchase\",\n label: \"Material — quarried 6F2\",\n amount: 64800,\n note: \"£13.50/t on 4,800 t\",\n },\n {\n id: \"c2\",\n kind: \"haulage\",\n label: \"Haulage — 240 loads from Wenvoe\",\n amount: 52800,\n note: \"34 km at ~£11/t\",\n estimated: true,\n },\n ],\n timing: { fit: \"good\", note: \"Quarry can supply on two days' notice\" },\n viability: {\n verdict: \"viable\",\n confidence: 0.92,\n summary:\n \"Guaranteed specification and availability at the highest cost, with the heaviest embodied carbon of the open sources.\",\n strengths: [\"Certain specification and supply rate\", \"No dependency on another project's programme\"],\n risks: [\"Highest cost and highest embodied carbon of the open pathways\"],\n conditions: [{ id: \"v1\", label: \"Framework order placed\", status: \"action_needed\" }],\n assessedAt: \"2026-07-04T06:12:00Z\",\n },\n compliance: [\n { id: \"k1\", label: \"Declaration of performance\", status: \"ok\" },\n { id: \"k2\", label: \"Delivery tickets per load\", status: \"ok\" },\n ],\n status: \"new\",\n },\n {\n id: \"opp-avon-recycled\",\n requirementId: \"req-aggregate-import\",\n name: \"Recycled supply — Avon Aggregates\",\n strategy: \"supply_recycled\",\n headline: \"WRAP-protocol crushed concrete 6F2 from 11 km away at roughly half the cost.\",\n partner: { name: \"Avon Aggregates Recycling\" },\n route: [\n {\n id: \"n1\",\n kind: \"recycling_facility\",\n label: \"Avon Aggregates Recycling\",\n geo: { bearingDeg: 355, distanceKm: 10 },\n detail: \"Crushed concrete 6F2, WRAP quality protocol\",\n },\n { id: \"n2\", kind: \"site\", label: \"Temple Quay Phase 2\", legDistanceKm: 11 },\n ],\n totalDistanceKm: 11,\n costs: [\n {\n id: \"c1\",\n kind: \"material_purchase\",\n label: \"Material — recycled 6F2\",\n amount: 38400,\n note: \"£8/t on 4,800 t\",\n },\n {\n id: \"c2\",\n kind: \"haulage\",\n label: \"Haulage — 240 loads\",\n amount: 21600,\n note: \"11 km at ~£4.50/t\",\n estimated: true,\n },\n ],\n timing: { fit: \"good\", note: \"Stock on the ground covers the full requirement\" },\n compatibility: {\n score: 88,\n breakdown: { material: 0.85, distance: 0.95, quantity: 1 },\n relation: \"same_class\",\n explainers: [\n \"Recycled 6F2 meets the capping specification\",\n \"Very close proximity (11 km)\",\n \"Stocked volume fully covers the requirement\",\n ],\n },\n viability: {\n verdict: \"viable\",\n confidence: 0.88,\n summary:\n \"A drop-in substitute under the WRAP quality protocol at 49% below the primary baseline, with a fraction of the embodied carbon.\",\n strengths: [\n \"Quality protocol means the material arrives as product, not waste\",\n \"£57,600 below the primary baseline\",\n \"Stock already crushed and graded\",\n ],\n risks: [\"Grading envelope certificate for the current stock batch still to be issued\"],\n conditions: [\n { id: \"v1\", label: \"WRAP quality protocol certificate\", status: \"met\" },\n { id: \"v2\", label: \"Grading envelope confirmation\", status: \"pending\" },\n ],\n assessedAt: \"2026-07-04T06:12:00Z\",\n },\n compliance: [\n { id: \"k1\", label: \"Quality protocol documentation\", status: \"ok\" },\n { id: \"k2\", label: \"Delivery tickets per load\", status: \"ok\" },\n ],\n status: \"shortlisted\",\n },\n {\n id: \"opp-redcliffe-surplus\",\n requirementId: \"req-aggregate-import\",\n name: \"Surplus — Redcliffe Wharf demolition\",\n strategy: \"supply_surplus\",\n headline: \"Crushed demolition arisings 7 km away, offered at a loading charge only.\",\n partner: { name: \"Brunel Demolition\", siteName: \"Redcliffe Wharf\" },\n route: [\n {\n id: \"n1\",\n kind: \"site\",\n label: \"Redcliffe Wharf demolition\",\n geo: { bearingDeg: 265, distanceKm: 5 },\n detail: \"Crushed demolition arisings, 6F2 equivalent\",\n },\n { id: \"n2\", kind: \"site\", label: \"Temple Quay Phase 2\", legDistanceKm: 7 },\n ],\n totalDistanceKm: 7,\n costs: [\n {\n id: \"c1\",\n kind: \"material_purchase\",\n label: \"Loading charge\",\n amount: 9600,\n note: \"£2/t on 4,800 t\",\n },\n {\n id: \"c2\",\n kind: \"haulage\",\n label: \"Haulage — 240 loads\",\n amount: 14400,\n note: \"7 km at ~£3/t\",\n estimated: true,\n },\n {\n id: \"c3\",\n kind: \"testing\",\n label: \"Grading and contamination testing\",\n amount: 1850,\n },\n ],\n timing: { fit: \"tight\", note: \"Their crushing runs to mid-October; your need opens mid-September\" },\n compatibility: {\n score: 84,\n breakdown: { material: 0.7, distance: 0.96, quantity: 0.75 },\n relation: \"cross_class_rule\",\n explainers: [\n \"Compatible by rule: crushed C&D arisings → 6F2 capping\",\n \"Very close proximity (7 km)\",\n \"Their surplus covers ~75% of the requirement\",\n ],\n },\n viability: {\n verdict: \"conditional\",\n confidence: 0.71,\n summary:\n \"By far the cheapest source if grading results confirm the 6F2 envelope — but the supply rate tracks their demolition programme and covers three-quarters of the need.\",\n strengths: [\n \"£91,750 below the primary baseline for the covered volume\",\n \"Shortest haul of any source\",\n \"Diverts a neighbouring project's waste stream\",\n ],\n risks: [\n \"Supply rate depends on their crushing programme\",\n \"Remaining ~25% must come from another source\",\n \"Grading results not yet returned\",\n ],\n conditions: [\n { id: \"v1\", label: \"Grading test results\", status: \"pending\", detail: \"Samples taken 1 July\" },\n { id: \"v2\", label: \"Supply rate agreement\", status: \"action_needed\" },\n ],\n assessedAt: \"2026-07-04T06:12:00Z\",\n },\n compliance: [\n { id: \"k1\", label: \"Quality protocol or DoW:CoP position\", status: \"pending\" },\n { id: \"k2\", label: \"Delivery tickets per load\", status: \"ok\" },\n ],\n status: \"shortlisted\",\n },\n {\n id: \"opp-site-won\",\n requirementId: \"req-aggregate-import\",\n name: \"Site-won — crush demolition arisings\",\n strategy: \"site_won\",\n headline: \"A mobile crusher turns your own arisings into two-thirds of the capping, with zero haulage.\",\n route: [\n {\n id: \"n1\",\n kind: \"site\",\n label: \"Temple Quay Phase 2\",\n detail: \"Mobile crusher processes ~3,100 t of demolition arisings in situ\",\n },\n ],\n totalDistanceKm: 0,\n costs: [\n { id: \"c1\", kind: \"processing\", label: \"Crusher mobilisation\", amount: 8500 },\n {\n id: \"c2\",\n kind: \"processing\",\n label: \"Crushing — 3,100 t site arisings\",\n amount: 19220,\n note: \"£6.20/t\",\n estimated: true,\n },\n {\n id: \"c3\",\n kind: \"material_purchase\",\n label: \"Top-up — recycled 6F2 (1,700 t)\",\n amount: 13600,\n note: \"£8/t from Avon Aggregates\",\n },\n {\n id: \"c4\",\n kind: \"haulage\",\n label: \"Top-up haulage\",\n amount: 7650,\n estimated: true,\n },\n ],\n timing: { fit: \"tight\", note: \"Crusher slot must land before the podium programme opens\" },\n viability: {\n verdict: \"conditional\",\n confidence: 0.66,\n summary:\n \"The best carbon outcome and £68,600 below baseline, if the mobile plant permit and site space can be secured in time.\",\n strengths: [\n \"Zero haulage on two-thirds of the requirement\",\n \"Lowest embodied carbon of any pathway\",\n \"Arisings volume already surveyed\",\n ],\n risks: [\n \"Mobile plant permit (noise) not yet applied for\",\n \"Crushing pad competes with the phase 2 laydown area\",\n ],\n conditions: [\n { id: \"v1\", label: \"Mobile plant permit\", status: \"action_needed\" },\n { id: \"v2\", label: \"Arisings volume survey\", status: \"met\" },\n { id: \"v3\", label: \"Top-up source confirmed\", status: \"met\" },\n ],\n assessedAt: \"2026-07-04T06:12:00Z\",\n },\n compliance: [\n { id: \"k1\", label: \"Mobile plant permit\", status: \"gap\" },\n { id: \"k2\", label: \"Crushing records and quality declaration\", status: \"pending\" },\n ],\n status: \"new\",\n },\n {\n id: \"opp-severn-vale\",\n requirementId: \"req-aggregate-import\",\n name: \"Surplus — Severn Vale earthworks\",\n strategy: \"supply_surplus\",\n headline: \"A large surplus 68 km north — the haul erases the discount.\",\n partner: { name: \"Vale Groundworks\", siteName: \"Severn Vale earthworks\" },\n route: [\n {\n id: \"n1\",\n kind: \"site\",\n label: \"Severn Vale earthworks\",\n detail: \"Surplus crushed fill\",\n geo: { bearingDeg: 25, distanceKm: 60 },\n },\n { id: \"n2\", kind: \"site\", label: \"Temple Quay Phase 2\", legDistanceKm: 68 },\n ],\n totalDistanceKm: 68,\n costs: [\n { id: \"c1\", kind: \"material_purchase\", label: \"Loading charge\", amount: 9600, note: \"£2/t\" },\n {\n id: \"c2\",\n kind: \"haulage\",\n label: \"Haulage — 240 loads over 68 km\",\n amount: 79200,\n note: \"~£16.50/t\",\n estimated: true,\n },\n ],\n timing: { fit: \"good\", note: \"Material available now\" },\n compatibility: {\n score: 58,\n breakdown: { material: 0.7, distance: 0.18, quantity: 1 },\n relation: \"cross_class_rule\",\n explainers: [\"Compatible by rule\", \"Far outside the economic haulage radius (68 km)\"],\n },\n viability: {\n verdict: \"ruled_out\",\n confidence: 0.82,\n summary:\n \"Haulage over 68 km erases the loading-charge discount: modelled £28,800 above the recycled supply option, with added programme risk.\",\n strengths: [],\n risks: [],\n conditions: [],\n ruledOutReason: \"Haulage cost erases the saving (£28,800 over the recycled source)\",\n assessedAt: \"2026-07-04T06:12:00Z\",\n },\n compliance: [],\n status: \"dismissed\",\n },\n]\n\n// ---------------------------------------------------------------------------\n// Scenario bundles\n// ---------------------------------------------------------------------------\n\nexport interface OpportunityScenario {\n requirement: MaterialRequirement\n opportunities: Opportunity[]\n}\n\nexport const OPPORTUNITY_SCENARIOS: OpportunityScenario[] = [\n { requirement: TOPSOIL_REQUIREMENT, opportunities: TOPSOIL_OPPORTUNITIES },\n { requirement: AGGREGATE_REQUIREMENT, opportunities: AGGREGATE_OPPORTUNITIES },\n]\n", "type": "registry:component", "target": "components/blocks/domain/opportunities/data.ts" }, { "path": "components/blocks/domain/opportunities/index.ts", "content": "export * from \"./types\"\nexport * from \"./data\"\nexport {\n CompatibilityRing,\n OpportunityStatusBadge,\n RouteNodeIcon,\n RouteSummary,\n SavingsDelta,\n StrategyBadge,\n TimingBadge,\n ViabilityBadge,\n} from \"./opportunity-primitives\"\nexport { OpportunityCard } from \"./opportunity-card\"\nexport { RoutePathway } from \"./route-pathway\"\nexport { CostBreakdown } from \"./cost-breakdown\"\nexport { ViabilityPanel } from \"./viability-panel\"\nexport { OpportunityComparison } from \"./opportunity-comparison\"\nexport { OptionsMatrix } from \"./options-matrix\"\nexport { OpportunityDetail } from \"./opportunity-detail\"\nexport { OpportunityMap } from \"./opportunity-map\"\nexport { OpportunityFlow } from \"./opportunity-flow\"\nexport { OpportunityDecision, opportunityReadiness } from \"./opportunity-decision\"\nexport { VerdictLegend } from \"./viz-utils\"\n", "type": "registry:component", "target": "components/blocks/domain/opportunities/index.ts" }, { "path": "components/blocks/domain/opportunities/opportunity-card.tsx", "content": "\"use client\"\n\nimport * as React from \"react\"\n\nimport {\n Card,\n CardAction,\n CardContent,\n CardDescription,\n CardFooter,\n CardHeader,\n CardTitle,\n} from \"@/components/ui/card\"\nimport { cn } from \"@/lib/utils\"\nimport {\n CompatibilityRing,\n OpportunityStatusBadge,\n RouteSummary,\n SavingsDelta,\n StrategyBadge,\n TimingBadge,\n ViabilityBadge,\n} from \"./opportunity-primitives\"\nimport {\n formatDistanceKm,\n formatMoney,\n formatPerTonne,\n opportunityIsEstimated,\n opportunityTotalCost,\n type MaterialRequirement,\n type Opportunity,\n} from \"./types\"\n\n/**\n * OpportunityCard — the comparable unit of the opportunity matrix. One card\n * per considered pathway: strategy and status up top, the route strip in the\n * middle, and the money story (net estimated cost, per-tonne rate and the\n * saving against the baseline route) along the foot. Ruled-out pathways stay\n * visible but muted, keeping the \"everything was considered\" promise; the\n * baseline route reads as the dashed anchor the others are measured against.\n */\n\nexport function OpportunityCard({\n requirement,\n opportunity,\n baseline,\n selected = false,\n onSelect,\n className,\n}: {\n requirement: MaterialRequirement\n opportunity: Opportunity\n /** The pathway savings are measured against (usually `isBaseline`). */\n baseline?: Opportunity\n selected?: boolean\n onSelect?: (id: string) => void\n className?: string\n}) {\n const total = opportunityTotalCost(opportunity)\n const estimated = opportunityIsEstimated(opportunity)\n const ruledOut = opportunity.viability.verdict === \"ruled_out\"\n const interactive = onSelect != null\n\n const handleKeyDown = (event: React.KeyboardEvent) => {\n if (event.key === \"Enter\" || event.key === \" \") {\n event.preventDefault()\n onSelect?.(opportunity.id)\n }\n }\n\n return (\n onSelect(opportunity.id) : undefined}\n onKeyDown={interactive ? handleKeyDown : undefined}\n className={cn(\n \"gap-3\",\n interactive &&\n \"cursor-pointer transition-shadow outline-none hover:shadow-md focus-visible:ring-4 focus-visible:ring-ring/25\",\n selected && \"ring-2 ring-ring\",\n opportunity.isBaseline && !selected && \"border border-dashed border-border ring-0\",\n className\n )}\n >\n \n
\n
\n \n \n
\n {opportunity.name}\n {opportunity.headline}\n {opportunity.partner ? (\n

\n with {opportunity.partner.name}\n {opportunity.partner.siteName ? ` · ${opportunity.partner.siteName}` : null}\n

\n ) : null}\n
\n \n \n \n \n\n \n \n \n\n {ruledOut && opportunity.viability.ruledOutReason ? (\n \n

\n Ruled out: {opportunity.viability.ruledOutReason}\n

\n \n ) : null}\n\n \n
\n \n {estimated ? \"~\" : \"\"}\n {formatMoney(total)}\n \n \n {formatPerTonne(total, requirement)}\n {opportunity.totalDistanceKm > 0\n ? ` · ${formatDistanceKm(opportunity.totalDistanceKm)}`\n : \" · on site\"}\n \n \n
\n
\n \n {opportunity.compatibility ? (\n \n ) : null}\n
\n \n \n )\n}\n", "type": "registry:component", "target": "components/blocks/domain/opportunities/opportunity-card.tsx" }, { "path": "components/blocks/domain/opportunities/opportunity-comparison.tsx", "content": "\"use client\"\n\nimport * as React from \"react\"\nimport { Check } from \"@untitledui/icons\"\n\nimport { cn } from \"@/lib/utils\"\nimport {\n CompatibilityRing,\n SavingsDelta,\n StrategyBadge,\n TimingBadge,\n ViabilityBadge,\n} from \"./opportunity-primitives\"\nimport {\n baselineOf,\n formatDistanceKm,\n formatMoney,\n formatPerTonne,\n opportunityIsEstimated,\n opportunityTotalCost,\n rankOpportunities,\n type MaterialRequirement,\n type Opportunity,\n} from \"./types\"\n\n/**\n * OpportunityComparison — the side-by-side view: pathways as columns,\n * decision dimensions as rows. Only open pathways are shown (ruled-out\n * options live in the options matrix); the baseline route is pinned as the\n * first, tinted column so every figure reads against the industry default.\n * Winning cells for cost, saving and distance carry a check so the best\n * option surfaces at a glance. Scrolls horizontally with a sticky label\n * column rather than squashing.\n */\n\ninterface ComparisonRow {\n key: string\n label: string\n render: (opportunity: Opportunity) => React.ReactNode\n}\n\nexport function OpportunityComparison({\n requirement,\n opportunities,\n selectedIds,\n onSelect,\n className,\n}: {\n requirement: MaterialRequirement\n opportunities: Opportunity[]\n /** Column headers render as pressed when included here. */\n selectedIds?: string[]\n /** Makes column headers selectable (e.g. for shortlisting). */\n onSelect?: (id: string) => void\n className?: string\n}) {\n const open = opportunities.filter(\n (opportunity) => opportunity.viability.verdict !== \"ruled_out\"\n )\n const baseline = baselineOf(open)\n const rest = rankOpportunities(open.filter((opportunity) => !opportunity.isBaseline))\n const shown = baseline ? [baseline, ...rest] : rest\n\n const totals = new Map(shown.map((o) => [o.id, opportunityTotalCost(o)]))\n const bestCost = Math.min(...totals.values())\n const bestDistance = Math.min(...shown.map((o) => o.totalDistanceKm))\n\n const winner = {\n cost: (o: Opportunity) => totals.get(o.id) === bestCost,\n distance: (o: Opportunity) => o.totalDistanceKm === bestDistance,\n }\n\n const winnerMark = (\n \n )\n\n const rows: ComparisonRow[] = [\n {\n key: \"cost\",\n label: \"Estimated net cost\",\n render: (o) => (\n \n {opportunityIsEstimated(o) ? \"~\" : \"\"}\n {formatMoney(totals.get(o.id) ?? 0)}\n {winner.cost(o) ? winnerMark : null}\n \n ),\n },\n {\n key: \"saving\",\n label: \"Saving vs baseline\",\n render: (o) => (\n \n \n {!o.isBaseline && winner.cost(o) ? winnerMark : null}\n \n ),\n },\n {\n key: \"per-tonne\",\n label: \"Cost per tonne\",\n render: (o) => (\n \n {formatPerTonne(totals.get(o.id) ?? 0, requirement)}\n \n ),\n },\n {\n key: \"distance\",\n label: \"Total distance\",\n render: (o) => (\n \n {formatDistanceKm(o.totalDistanceKm)}\n {winner.distance(o) ? winnerMark : null}\n \n ),\n },\n {\n key: \"timing\",\n label: \"Timing\",\n render: (o) => (\n \n \n {o.timing.note}\n \n ),\n },\n {\n key: \"compatibility\",\n label: \"Compatibility\",\n render: (o) =>\n o.compatibility ? (\n \n ) : (\n —\n ),\n },\n {\n key: \"conditions\",\n label: \"Conditions\",\n render: (o) => {\n const outstanding = o.viability.conditions.filter(\n (condition) => condition.status !== \"met\"\n ).length\n return outstanding > 0 ? (\n \n {outstanding} outstanding\n \n ) : (\n None\n )\n },\n },\n {\n key: \"compliance\",\n label: \"Compliance\",\n render: (o) => {\n const gaps = o.compliance.filter((item) => item.status === \"gap\").length\n const pending = o.compliance.filter((item) => item.status === \"pending\").length\n if (gaps > 0)\n return (\n \n {gaps} {gaps === 1 ? \"gap\" : \"gaps\"}\n \n )\n if (pending > 0)\n return (\n \n {pending} pending\n \n )\n return In order\n },\n },\n ]\n\n const columnClass = (o: Opportunity) =>\n cn(\"px-4 py-3\", o.isBaseline && \"bg-secondary/50\")\n\n return (\n \n \n {/* Header row */}\n
\n {shown.map((o) => {\n const selected = selectedIds?.includes(o.id) ?? false\n const header = (\n
\n \n \n {o.name}\n \n {o.isBaseline ? (\n \n Baseline\n \n ) : null}\n \n \n \n \n \n {o.partner ? (\n \n {o.partner.name}\n {o.partner.siteName ? ` · ${o.partner.siteName}` : \"\"}\n \n ) : null}\n
\n )\n return onSelect ? (\n onSelect(o.id)}\n aria-pressed={selected}\n className={cn(\n \"cursor-pointer border-b border-border text-left transition-colors hover:bg-muted focus-visible:ring-4 focus-visible:ring-ring/25 focus-visible:outline-none\",\n columnClass(o),\n selected && \"bg-brand-primary ring-1 ring-border-brand ring-inset\"\n )}\n >\n {header}\n \n ) : (\n
\n {header}\n
\n )\n })}\n\n {/* Dimension rows */}\n {rows.map((row, rowIndex) => (\n \n \n {row.label}\n
\n {shown.map((o) => (\n \n {row.render(o)}\n \n ))}\n \n ))}\n \n \n )\n}\n", "type": "registry:component", "target": "components/blocks/domain/opportunities/opportunity-comparison.tsx" }, { "path": "components/blocks/domain/opportunities/opportunity-decision.tsx", "content": "\"use client\"\n\nimport * as React from \"react\"\n\nimport { cn } from \"@/lib/utils\"\nimport {\n baselineOf,\n formatMoney,\n opportunityTotalCost,\n rankOpportunities,\n type MaterialRequirement,\n type Opportunity,\n} from \"./types\"\nimport {\n opportunityShortName,\n useVizTip,\n VERDICT_MARK_COLORS,\n VerdictLegend,\n VizTooltip,\n} from \"./viz-utils\"\n\n/**\n * OpportunityDecision — the decision grid. One dot per pathway, placed by\n * what actually drives the choice: estimated net cost across, and the share\n * of its gates already cleared (viability conditions + compliance items) up.\n * The strong options collect top-left — ready and affordable; colour is the\n * AI verdict and the baseline route is pinned as a reference line.\n */\n\nconst W = 900\nconst H = 460\nconst ML = 70\nconst MR = 180\nconst MT = 30\nconst MB = 52\nconst PLOT_W = W - ML - MR\nconst PLOT_H = H - MT - MB\n\n/** Share of gates (conditions + compliance) already cleared, 0–1. */\nexport function opportunityReadiness(opportunity: Opportunity): number {\n const gates = [\n ...opportunity.viability.conditions.map((item) => item.status === \"met\"),\n ...opportunity.compliance.map((item) => item.status === \"ok\"),\n ]\n if (gates.length === 0) return 1\n return gates.filter(Boolean).length / gates.length\n}\n\nfunction niceCostCeil(max: number): number {\n const step = max > 120_000 ? 50_000 : 25_000\n return Math.ceil((max * 1.08) / step) * step\n}\n\nfunction formatCostTick(value: number): string {\n return value === 0 ? \"£0\" : `£${Math.round(value / 1000)}k`\n}\n\nexport function OpportunityDecision({\n requirement,\n opportunities,\n onOpenDetail,\n className,\n}: {\n requirement: MaterialRequirement\n opportunities: Opportunity[]\n onOpenDetail?: (id: string) => void\n className?: string\n}) {\n const { tip, move, pin, clear, containerRef } = useVizTip()\n const [hoveredId, setHoveredId] = React.useState(null)\n\n const baseline = baselineOf(opportunities)\n const ranked = rankOpportunities(opportunities)\n\n const xMax = niceCostCeil(\n Math.max(...opportunities.map((o) => Math.abs(opportunityTotalCost(o))), 1)\n )\n const xTickStep = xMax > 120_000 ? 50_000 : 25_000\n const xTicks = Array.from(\n { length: Math.floor(xMax / xTickStep) + 1 },\n (_, index) => index * xTickStep\n )\n const yTicks = [0, 0.25, 0.5, 0.75, 1]\n\n const px = (cost: number) => ML + (cost / xMax) * PLOT_W\n // 10px vertical inset keeps 0%/100% dots off the plot edges\n const py = (ready: number) => MT + 10 + (1 - ready) * (PLOT_H - 20)\n\n const points = ranked.map((opportunity) => ({\n opportunity,\n x: px(opportunityTotalCost(opportunity)),\n y: py(opportunityReadiness(opportunity)),\n }))\n\n // Direct labels: anchor away from the plot edge, nudge collisions apart.\n const labels = new Map()\n for (const side of [\"start\", \"end\"] as const) {\n const group = points\n .filter((point) =>\n side === \"start\" ? point.x <= ML + PLOT_W * 0.62 : point.x > ML + PLOT_W * 0.62\n )\n .sort((a, b) => a.y - b.y)\n let lastY = -Infinity\n for (const point of group) {\n const y = Math.max(point.y + 4, lastY + 14)\n lastY = y\n labels.set(point.opportunity.id, {\n x: side === \"start\" ? point.x + 13 : point.x - 13,\n y,\n anchor: side,\n })\n }\n }\n\n const baselineX = baseline ? px(opportunityTotalCost(baseline)) : null\n\n return (\n \n \n \n {/* Grid */}\n {yTicks.map((tick) => (\n \n \n \n {Math.round(tick * 100)}%\n \n \n ))}\n {xTicks.map((tick) => (\n \n \n \n {formatCostTick(tick)}\n \n \n ))}\n\n {/* Baseline reference */}\n {baselineX != null && baseline ? (\n \n \n \n baseline · {formatMoney(opportunityTotalCost(baseline))}\n \n \n ) : null}\n\n {/* Corner reading aids */}\n \n ready & affordable\n \n \n costly · gated\n \n\n {/* Axis titles */}\n \n estimated net cost →\n \n \n gates cleared ↑\n \n\n {/* Dots + direct labels */}\n {points.map(({ opportunity, x, y }) => {\n const ruledOut = opportunity.viability.verdict === \"ruled_out\"\n const color = VERDICT_MARK_COLORS[opportunity.viability.verdict]\n const active = hoveredId === opportunity.id\n const dimmed = hoveredId != null && !active\n const label = labels.get(opportunity.id)!\n return (\n setHoveredId(opportunity.id)}\n onMouseLeave={() => {\n setHoveredId(null)\n clear()\n }}\n onClick={() => onOpenDetail?.(opportunity.id)}\n onFocus={pin(opportunity, x, y)}\n onBlur={clear}\n onKeyDown={(event) => {\n if (event.key === \"Enter\" || event.key === \" \") {\n event.preventDefault()\n onOpenDetail?.(opportunity.id)\n }\n }}\n tabIndex={0}\n role=\"button\"\n aria-label={`${opportunity.name}, ${formatMoney(opportunityTotalCost(opportunity))}, ${Math.round(opportunityReadiness(opportunity) * 100)}% of gates cleared`}\n >\n \n {ruledOut ? (\n \n ) : (\n \n )}\n \n {opportunityShortName(opportunity)}\n {opportunity.isBaseline ? \" (baseline)\" : \"\"}\n \n \n )\n })}\n \n \n \n )\n}\n", "type": "registry:component", "target": "components/blocks/domain/opportunities/opportunity-decision.tsx" }, { "path": "components/blocks/domain/opportunities/opportunity-detail.tsx", "content": "import type * as React from \"react\"\nimport { AlertCircle, CheckCircle, Clock } from \"@untitledui/icons\"\n\nimport { Badge } from \"@/components/ui/badge\"\nimport { cn } from \"@/lib/utils\"\nimport { CostBreakdown } from \"./cost-breakdown\"\nimport {\n CompatibilityRing,\n OpportunityStatusBadge,\n SavingsDelta,\n StrategyBadge,\n TimingBadge,\n ViabilityBadge,\n} from \"./opportunity-primitives\"\nimport { RoutePathway } from \"./route-pathway\"\nimport {\n formatDistanceKm,\n formatMoney,\n MATERIAL_RELATION_LABELS,\n opportunityIsEstimated,\n opportunityTotalCost,\n SCORE_TIER_LABELS,\n scoreTier,\n type ComplianceItem,\n type ComplianceStatus,\n type MaterialRequirement,\n type Opportunity,\n} from \"./types\"\nimport { ViabilityPanel } from \"./viability-panel\"\n\n/**\n * OpportunityDetail — the full record for one pathway, composed from the\n * family's surfaces: headline figures, the route drawn step by step, the\n * itemised cost estimate against the baseline, the AI viability assessment\n * and the derived compliance position. Designed to sit inside a sheet or\n * drawer (vertical rhythm, no fixed width) but works as a standalone panel.\n */\n\nconst COMPLIANCE_META: Record<\n ComplianceStatus,\n {\n icon: React.ComponentType<{ className?: string }>\n iconClass: string\n label: string\n variant: React.ComponentProps[\"variant\"]\n }\n> = {\n ok: {\n icon: CheckCircle,\n iconClass: \"text-fg-success-primary\",\n label: \"In order\",\n variant: \"success\",\n },\n gap: {\n icon: AlertCircle,\n iconClass: \"text-fg-error-primary\",\n label: \"Gap\",\n variant: \"error\",\n },\n pending: {\n icon: Clock,\n iconClass: \"text-fg-quaternary\",\n label: \"Pending\",\n variant: \"gray\",\n },\n}\n\nfunction SectionHeading({ children }: { children: React.ReactNode }) {\n return (\n

\n {children}\n

\n )\n}\n\nfunction ComplianceList({ items }: { items: ComplianceItem[] }) {\n return (\n
    \n {items.map((item) => {\n const meta = COMPLIANCE_META[item.status]\n const Icon = meta.icon\n return (\n
  • \n \n
    \n {item.label}\n {item.detail ? (\n {item.detail}\n ) : null}\n
    \n \n {meta.label}\n \n
    • \n )\n })}\n
\n )\n}\n\nexport function OpportunityDetail({\n requirement,\n opportunity,\n baseline,\n className,\n}: {\n requirement: MaterialRequirement\n opportunity: Opportunity\n /** Enables the delta rows (usually the scenario's `isBaseline` pathway). */\n baseline?: Opportunity\n className?: string\n}) {\n const total = opportunityTotalCost(opportunity)\n const estimated = opportunityIsEstimated(opportunity)\n\n return (\n \n {/* Headline */}\n
\n
\n \n \n \n
\n
\n

{opportunity.name}

\n

{opportunity.headline}

\n {opportunity.partner ? (\n

\n with {opportunity.partner.name}\n {opportunity.partner.siteName ? ` · ${opportunity.partner.siteName}` : null}\n

\n ) : null}\n
\n
\n
\n \n {estimated ? \"~\" : \"\"}\n {formatMoney(total)}\n \n \n
\n
\n \n {opportunity.compatibility ? (\n \n ) : null}\n
\n
\n
\n\n {/* Route */}\n
\n
\n Route\n {opportunity.totalDistanceKm > 0 ? (\n \n {formatDistanceKm(opportunity.totalDistanceKm)} total\n \n ) : null}\n
\n \n
\n\n {/* Costs */}\n
\n Estimated costs\n \n
\n\n {/* Compatibility explainers */}\n {opportunity.compatibility ? (\n
\n Compatibility\n

\n Scored {opportunity.compatibility.score}/100 —{\" \"}\n {SCORE_TIER_LABELS[scoreTier(opportunity.compatibility.score)]} (\n {MATERIAL_RELATION_LABELS[opportunity.compatibility.relation]}).\n

\n
    \n {opportunity.compatibility.explainers.map((explainer) => (\n
  • {explainer}
    • \n ))}\n
\n
\n ) : null}\n\n {/* Viability */}\n \n\n {/* Compliance */}\n {opportunity.compliance.length > 0 ? (\n
\n Compliance position\n \n
\n ) : null}\n \n )\n}\n", "type": "registry:component", "target": "components/blocks/domain/opportunities/opportunity-detail.tsx" }, { "path": "components/blocks/domain/opportunities/opportunity-flow.tsx", "content": "\"use client\"\n\nimport * as React from \"react\"\n\nimport { cn } from \"@/lib/utils\"\nimport {\n baselineOf,\n formatMoney,\n formatMoneyDelta,\n opportunityIsEstimated,\n opportunityTotalCost,\n rankOpportunities,\n savingsVsBaseline,\n STRATEGY_LABELS,\n type MaterialRequirement,\n type Opportunity,\n} from \"./types\"\nimport {\n opportunityShortName,\n RULED_OUT_DASH,\n useVizTip,\n VERDICT_MARK_COLORS,\n verdictWash,\n VerdictLegend,\n VizTooltip,\n} from \"./viz-utils\"\n\n/**\n * OpportunityFlow — the cost canvas. Every considered pathway fans out from\n * the requirement as a ribbon whose width is its estimated net cost, so the\n * money story is legible before a single number is read: the fat ribbon is\n * the expensive route, the thin one the bargain. Facilities a route passes\n * through sit as waypoints on the ribbon; colour is the AI verdict and\n * ruled-out pathways stay visible, dashed and washed out.\n */\n\nconst W = 920\nconst ROW_H = 76\nconst PAD_Y = 24\nconst X1 = 192\nconst X2 = 604\nconst TEXT_X = 622\nconst RIGHT_X = W - 16\nconst MIN_W = 7\nconst MAX_W = 44\n\nfunction truncate(text: string, max: number): string {\n return text.length > max ? `${text.slice(0, max - 1).trimEnd()}…` : text\n}\n\n/** Sankey-style link of width `w` between two horizontal anchors. */\nfunction ribbonPath(y1: number, y2: number, w: number): string {\n const k = (X2 - X1) / 2\n const top1 = y1 - w / 2\n const top2 = y2 - w / 2\n const bottom1 = y1 + w / 2\n const bottom2 = y2 + w / 2\n return [\n `M ${X1} ${top1}`,\n `C ${X1 + k} ${top1} ${X2 - k} ${top2} ${X2} ${top2}`,\n `L ${X2} ${bottom2}`,\n `C ${X2 - k} ${bottom2} ${X1 + k} ${bottom1} ${X1} ${bottom1}`,\n \"Z\",\n ].join(\" \")\n}\n\n/** Point at parameter t along the ribbon's centreline. */\nfunction centrePoint(y1: number, y2: number, t: number) {\n const k = (X2 - X1) / 2\n const u = 1 - t\n const x =\n u * u * u * X1 + 3 * u * u * t * (X1 + k) + 3 * u * t * t * (X2 - k) + t * t * t * X2\n const y = u * u * u * y1 + 3 * u * u * t * y1 + 3 * u * t * t * y2 + t * t * t * y2\n return { x, y }\n}\n\nexport function OpportunityFlow({\n requirement,\n opportunities,\n onOpenDetail,\n className,\n}: {\n requirement: MaterialRequirement\n opportunities: Opportunity[]\n onOpenDetail?: (id: string) => void\n className?: string\n}) {\n const { tip, move, pin, clear, containerRef } = useVizTip()\n const [hoveredId, setHoveredId] = React.useState(null)\n\n const baseline = baselineOf(opportunities)\n const ranked = rankOpportunities(opportunities)\n const H = ranked.length * ROW_H + PAD_Y * 2\n\n const costs = ranked.map(opportunityTotalCost)\n const maxCost = Math.max(...costs.map(Math.abs), 1)\n const widths = costs.map(\n (cost) => MIN_W + (MAX_W - MIN_W) * (Math.abs(cost) / maxCost)\n )\n\n // Origin-side stack: ribbons leave the requirement in rank order.\n const stackTotal =\n widths.reduce((sum, w) => sum + w, 0) + (ranked.length - 1) * 6\n let cursor = (H - stackTotal) / 2\n const stackY = widths.map((w) => {\n const y = cursor + w / 2\n cursor += w + 6\n return y\n })\n\n const rowY = (index: number) => PAD_Y + index * ROW_H + ROW_H / 2\n\n const exportDirection = requirement.direction === \"export\"\n const quantityLabel = `${requirement.quantity.value.toLocaleString(\"en-GB\")} ${requirement.quantity.unit}`\n\n return (\n \n \n \n {/* Ribbons first, so labels stay on top */}\n {ranked.map((opportunity, index) => {\n const ruledOut = opportunity.viability.verdict === \"ruled_out\"\n const active = hoveredId === opportunity.id\n const dimmed = hoveredId != null && !active\n const wash = ruledOut ? 10 : active ? 40 : dimmed ? 10 : 26\n const waypoints = opportunity.route.slice(1, -1)\n const totalKm = opportunity.totalDistanceKm || 1\n return (\n setHoveredId(opportunity.id)}\n onMouseLeave={() => {\n setHoveredId(null)\n clear()\n }}\n onClick={() => onOpenDetail?.(opportunity.id)}\n onFocus={pin(opportunity, X2, rowY(index))}\n onBlur={clear}\n onKeyDown={(event) => {\n if (event.key === \"Enter\" || event.key === \" \") {\n event.preventDefault()\n onOpenDetail?.(opportunity.id)\n }\n }}\n tabIndex={0}\n role=\"button\"\n aria-label={`${opportunity.name}, ${formatMoney(costs[index])}`}\n >\n \n {ruledOut ? (\n \n ) : null}\n {/* facility waypoints along the route */}\n {waypoints.map((node) => {\n const along = (node.legDistanceKm ?? totalKm / 2) / totalKm\n const point = centrePoint(\n stackY[index],\n rowY(index),\n Math.min(Math.max(along, 0.25), 0.75)\n )\n return (\n \n \n {/* below the dot, on the ribbon's own wash */}\n \n {truncate(node.label, 34)}\n \n \n )\n })}\n \n )\n })}\n\n {/* Requirement block */}\n \n \n \n \n {truncate(requirement.location.name.split(\",\")[0], 16)}\n \n \n {quantityLabel} {exportDirection ? \"to place\" : \"needed\"}\n \n \n\n {/* Row labels */}\n {ranked.map((opportunity, index) => {\n const y = rowY(index)\n const cost = costs[index]\n const active = hoveredId === opportunity.id\n const dimmed = hoveredId != null && !active\n const ruledOut = opportunity.viability.verdict === \"ruled_out\"\n const savings =\n baseline && !opportunity.isBaseline\n ? savingsVsBaseline(opportunity, baseline)\n : null\n return (\n setHoveredId(opportunity.id)}\n onMouseLeave={() => {\n setHoveredId(null)\n clear()\n }}\n onClick={() => onOpenDetail?.(opportunity.id)}\n >\n \n {opportunity.viability.verdict === \"ruled_out\" ? (\n \n ) : (\n \n )}\n \n {truncate(opportunityShortName(opportunity), 27)}\n \n \n {STRATEGY_LABELS[opportunity.strategy]}\n {opportunity.totalDistanceKm > 0\n ? ` · ${opportunity.totalDistanceKm} km`\n : null}\n {opportunity.isBaseline ? \" · BASELINE\" : null}\n \n \n {opportunityIsEstimated(opportunity) ? \"~\" : \"\"}\n {formatMoney(cost)}\n \n {savings != null ? (\n = 0\n ? \"var(--color-text-success-primary)\"\n : \"var(--color-text-error-primary)\"\n }\n >\n {formatMoneyDelta(savings)}\n \n ) : (\n \n baseline\n \n )}\n \n )\n })}\n \n \n \n )\n}\n", "type": "registry:component", "target": "components/blocks/domain/opportunities/opportunity-flow.tsx" }, { "path": "components/blocks/domain/opportunities/opportunity-map.tsx", "content": "\"use client\"\n\nimport * as React from \"react\"\n\nimport { cn } from \"@/lib/utils\"\nimport {\n baselineOf,\n formatMoney,\n opportunityTotalCost,\n rankOpportunities,\n type MaterialRequirement,\n type Opportunity,\n type RouteNode,\n} from \"./types\"\nimport {\n opportunityShortName,\n RULED_OUT_DASH,\n useVizTip,\n VERDICT_MARK_COLORS,\n VerdictLegend,\n VizTooltip,\n} from \"./viz-utils\"\n\n/**\n * OpportunityMap — the proximity view. The requirement site sits at the\n * centre; every considered pathway radiates out to its counterparty sites,\n * plotted by compass bearing and straight-line distance against faint\n * distance rings. Multi-step routes chain through their facility; arrows\n * carry the direction of movement (out for exports, in for imports);\n * zero-distance pathways (site-won, treat-and-return) loop back to the\n * centre. Colour is the AI verdict; ruled-out routes stay visible, dashed.\n */\n\nconst W = 860\nconst H = 560\nconst CX = W / 2\nconst CY = H / 2\nconst PAD = 84\n\ninterface XY {\n x: number\n y: number\n}\n\nfunction polar(bearingDeg: number, r: number): XY {\n const rad = (bearingDeg * Math.PI) / 180\n return { x: CX + Math.sin(rad) * r, y: CY - Math.cos(rad) * r }\n}\n\n/** Ring step so 2–4 rings cover the furthest site. */\nfunction ringStep(maxKm: number): number {\n const steps = [1, 2, 5, 10, 20, 25, 50]\n const target = maxKm / 2.5\n return steps.find((step) => step >= target) ?? 50\n}\n\nfunction nodePoint(node: RouteNode, toRadius: (km: number) => number): XY {\n if (!node.geo || node.geo.distanceKm === 0) return { x: CX, y: CY }\n return polar(node.geo.bearingDeg, toRadius(node.geo.distanceKm))\n}\n\n/** Gentle quadratic between two points; `side` flips the bow. */\nfunction legPath(from: XY, to: XY, side: number): string {\n const mx = (from.x + to.x) / 2\n const my = (from.y + to.y) / 2\n const dx = to.x - from.x\n const dy = to.y - from.y\n const len = Math.hypot(dx, dy) || 1\n const bow = Math.min(len * 0.14, 26) * side\n const cx = mx - (dy / len) * bow\n const cy = my + (dx / len) * bow\n return `M ${from.x} ${from.y} Q ${cx} ${cy} ${to.x} ${to.y}`\n}\n\n/** Curve midpoint (t = 0.5) + travel angle, for the direction arrow. */\nfunction legArrow(from: XY, to: XY, side: number) {\n const mx = (from.x + to.x) / 2\n const my = (from.y + to.y) / 2\n const dx = to.x - from.x\n const dy = to.y - from.y\n const len = Math.hypot(dx, dy) || 1\n const bow = Math.min(len * 0.14, 26) * side\n return {\n x: mx - (dy / len) * (bow / 2),\n y: my + (dx / len) * (bow / 2),\n angle: (Math.atan2(dy, dx) * 180) / Math.PI,\n }\n}\n\nexport function OpportunityMap({\n requirement,\n opportunities,\n onOpenDetail,\n className,\n}: {\n requirement: MaterialRequirement\n opportunities: Opportunity[]\n onOpenDetail?: (id: string) => void\n className?: string\n}) {\n const { tip, move, pin, clear, containerRef } = useVizTip()\n const [hoveredId, setHoveredId] = React.useState(null)\n\n const baseline = baselineOf(opportunities)\n const ranked = rankOpportunities(opportunities)\n\n // Unique off-centre sites across every route, keyed by label.\n const sites = new Map()\n for (const opportunity of opportunities) {\n for (const node of opportunity.route) {\n if (node.geo && node.geo.distanceKm > 0 && !sites.has(node.label)) {\n sites.set(node.label, node)\n }\n }\n }\n\n const maxKm = Math.max(\n 1,\n ...[...sites.values()].map((node) => node.geo?.distanceKm ?? 0)\n )\n const step = ringStep(maxKm)\n // Square-root radial scale: distance-true rings, but the near-in sites —\n // where most matches live — get room instead of piling on the centre.\n const plotR = Math.min(W, H) / 2 - PAD\n const toRadius = (km: number) => plotR * Math.sqrt(km / (maxKm * 1.06))\n const rings: number[] = []\n for (let km = step; km <= maxKm * 1.02; km += step) rings.push(km)\n if (rings.length === 0) rings.push(step)\n\n // The single pathway terminating at a site (for its money label).\n const terminal = new Map()\n for (const opportunity of opportunities) {\n const last = opportunity.route[opportunity.route.length - 1]\n const target =\n requirement.direction === \"import\" ? opportunity.route[0] : last\n if (target.geo && target.geo.distanceKm > 0 && !terminal.has(target.label)) {\n terminal.set(target.label, opportunity)\n }\n }\n\n const dim = (id: string) => hoveredId != null && hoveredId !== id\n\n // Site labels with a greedy collision pass: sorted top-to-bottom, any label\n // whose box overlaps an already-placed one slides below it.\n const siteLabels = [...sites.values()]\n .map((node) => {\n const point = nodePoint(node, toRadius)\n const geo = node.geo!\n const rad = (geo.bearingDeg * Math.PI) / 180\n const sin = Math.sin(rad)\n const cos = Math.cos(rad)\n const anchor: \"start\" | \"middle\" | \"end\" =\n sin > 0.3 ? \"start\" : sin < -0.3 ? \"end\" : \"middle\"\n const owner = terminal.get(node.label)\n const money = owner\n ? `~${formatMoney(opportunityTotalCost(owner))}`\n : undefined\n const width = 6.2 * Math.max(node.label.length, money?.length ?? 0)\n return {\n node,\n point,\n owner,\n money,\n anchor,\n lx: point.x + sin * 14,\n ly: point.y - cos * 14 + (cos < -0.3 ? 16 : cos > 0.3 ? -8 : 4),\n width,\n height: money ? 28 : 14,\n }\n })\n .sort((a, b) => a.ly - b.ly)\n interface LabelBox {\n lx: number\n ly: number\n width: number\n height: number\n anchor: \"start\" | \"middle\" | \"end\"\n }\n // Ring labels are fixed obstacles the site labels must slide past.\n const obstacles: LabelBox[] = rings.map((km) => ({\n lx: CX + toRadius(km) * 0.707 + 4,\n ly: CY + toRadius(km) * 0.707 + 10,\n width: 36,\n height: 12,\n anchor: \"start\",\n }))\n const x0 = (box: LabelBox) =>\n box.anchor === \"start\"\n ? box.lx\n : box.anchor === \"end\"\n ? box.lx - box.width\n : box.lx - box.width / 2\n for (let i = 0; i < siteLabels.length; i++) {\n const label = siteLabels[i]\n for (const prior of [...obstacles, ...siteLabels.slice(0, i)]) {\n const overlapX = x0(label) < x0(prior) + prior.width && x0(prior) < x0(label) + label.width\n const overlapY =\n label.ly - 11 < prior.ly - 11 + prior.height + 3 && prior.ly - 11 < label.ly + label.height\n if (overlapX && overlapY) label.ly = prior.ly + prior.height + 3\n }\n }\n\n // Put the centre label on whichever side has the most breathing room.\n const sitePoints = [...sites.values()].map((node) => nodePoint(node, toRadius))\n const centerLabel = [\n { x: CX, y: CY - 26, anchor: \"middle\" as const },\n { x: CX, y: CY + 36, anchor: \"middle\" as const },\n { x: CX - 22, y: CY + 4, anchor: \"end\" as const },\n { x: CX + 22, y: CY + 4, anchor: \"start\" as const },\n ]\n .map((candidate) => ({\n ...candidate,\n score: Math.min(\n ...sitePoints.map((point) =>\n Math.hypot(point.x - candidate.x, point.y - candidate.y)\n )\n ),\n }))\n .sort((a, b) => b.score - a.score)[0]\n\n return (\n \n \n \n {/* Distance rings — labels ride the SE diagonal, out of the way */}\n {rings.map((km) => (\n \n \n \n {km} km\n \n \n ))}\n \n N ↑\n \n\n {/* Routes (ranked so open pathways draw above ruled-out ones) */}\n {[...ranked].reverse().map((opportunity, reverseIndex) => {\n const ruledOut = opportunity.viability.verdict === \"ruled_out\"\n const color = VERDICT_MARK_COLORS[opportunity.viability.verdict]\n const points = opportunity.route.map((node) => nodePoint(node, toRadius))\n const legs = points\n .slice(1)\n .map((to, index) => ({ from: points[index], to, index }))\n .filter(({ from, to }) => Math.hypot(to.x - from.x, to.y - from.y) > 1)\n const selfLoop = legs.length === 0\n const active = hoveredId === opportunity.id\n const strokeWidth = active ? 3 : opportunity.status === \"shortlisted\" ? 2.5 : 2\n const common = {\n onMouseMove: move(opportunity),\n onMouseEnter: () => setHoveredId(opportunity.id),\n onMouseLeave: () => {\n setHoveredId(null)\n clear()\n },\n onClick: () => onOpenDetail?.(opportunity.id),\n onFocus: pin(opportunity, CX, CY),\n onBlur: clear,\n onKeyDown: (event: React.KeyboardEvent) => {\n if (event.key === \"Enter\" || event.key === \" \") {\n event.preventDefault()\n onOpenDetail?.(opportunity.id)\n }\n },\n tabIndex: 0,\n role: \"button\" as const,\n \"aria-label\": `${opportunity.name}, ${formatMoney(opportunityTotalCost(opportunity))}`,\n }\n const side = reverseIndex % 2 === 0 ? 1 : -1\n return (\n \n {selfLoop ? (\n <>\n \n \n \n {opportunityShortName(opportunity)} — on site\n \n \n ~{formatMoney(opportunityTotalCost(opportunity))}\n \n \n ) : (\n legs.map(({ from, to, index }) => {\n const legSide = side * (index % 2 === 0 ? 1 : -1)\n const arrow = legArrow(from, to, legSide)\n return (\n \n {/* generous hit area */}\n \n \n {/* route order is travel order, so the angle is the direction */}\n \n \n )\n })\n )}\n \n )\n })}\n\n {/* Sites */}\n {siteLabels.map(({ node, point, owner, money, anchor, lx, ly }) => {\n const endColor = owner\n ? VERDICT_MARK_COLORS[owner.viability.verdict]\n : undefined\n const ruledOut = owner?.viability.verdict === \"ruled_out\"\n return (\n \n \n \n {node.label}\n \n {money ? (\n \n {money}\n \n ) : null}\n \n )\n })}\n\n {/* The requirement site */}\n \n \n \n \n {requirement.location.name.split(\",\")[0]}\n \n \n \n \n \n )\n}\n", "type": "registry:component", "target": "components/blocks/domain/opportunities/opportunity-map.tsx" }, { "path": "components/blocks/domain/opportunities/opportunity-primitives.tsx", "content": "import type * as React from \"react\"\nimport {\n AlertCircle,\n AlertTriangle,\n Archive,\n ArrowNarrowRight,\n Building07,\n CheckCircle,\n Clock,\n Home02,\n Package,\n RefreshCcw02,\n SlashOctagon,\n Tool02,\n Trash03,\n Truck01,\n} from \"@untitledui/icons\"\n\nimport { Badge } from \"@/components/ui/badge\"\nimport { cn } from \"@/lib/utils\"\nimport {\n formatMoneyDelta,\n MATERIAL_RELATION_LABELS,\n OPPORTUNITY_STATUS_LABELS,\n savingsVsBaseline,\n SCORE_TIER_LABELS,\n scoreTier,\n STRATEGY_LABELS,\n TIMING_FIT_LABELS,\n VERDICT_LABELS,\n type Compatibility,\n type Opportunity,\n type OpportunityStatus,\n type OpportunityStrategy,\n type RouteNode,\n type RouteNodeKind,\n type ScoreTier,\n type TimingFit,\n type Viability,\n type ViabilityVerdict,\n} from \"./types\"\n\n/**\n * Shared atoms for the opportunity matrix family: node icons, the verdict /\n * timing / strategy / status badges, the compatibility ring and the\n * savings-vs-baseline delta. Every surface (cards, comparison, matrix,\n * detail) renders these so the vocabulary cannot drift between views.\n */\n\n// ---------------------------------------------------------------------------\n// Route node icons\n// ---------------------------------------------------------------------------\n\nconst NODE_ICONS: Record> = {\n site: Building07,\n receiving_site: Home02,\n treatment_facility: Tool02,\n recycling_facility: RefreshCcw02,\n transfer_station: Truck01,\n landfill: Trash03,\n stockpile: Archive,\n supplier: Package,\n}\n\nexport function RouteNodeIcon({\n kind,\n className,\n}: {\n kind: RouteNodeKind\n className?: string\n}) {\n const Icon = NODE_ICONS[kind]\n return \n}\n\n/** Inline chip strip: origin → … → destination with leg distances. */\nexport function RouteSummary({\n route,\n className,\n}: {\n route: RouteNode[]\n className?: string\n}) {\n return (\n \n {route.map((node, index) => (\n \n {index > 0 ? (\n \n \n {node.legDistanceKm != null ? (\n {node.legDistanceKm} km\n ) : null}\n \n ) : null}\n \n \n {node.label}\n \n \n ))}\n \n )\n}\n\n// ---------------------------------------------------------------------------\n// Viability\n// ---------------------------------------------------------------------------\n\nconst VERDICT_BADGE_VARIANTS: Record<\n ViabilityVerdict,\n React.ComponentProps[\"variant\"]\n> = {\n viable: \"success\",\n conditional: \"warning\",\n unlikely: \"gray\",\n ruled_out: \"error\",\n}\n\nconst VERDICT_ICONS: Record> = {\n viable: CheckCircle,\n conditional: AlertCircle,\n unlikely: AlertTriangle,\n ruled_out: SlashOctagon,\n}\n\nexport function ViabilityBadge({\n viability,\n showConfidence = false,\n className,\n}: {\n viability: Viability\n /** Append \"· 78%\" for detail surfaces. */\n showConfidence?: boolean\n className?: string\n}) {\n const Icon = VERDICT_ICONS[viability.verdict]\n return (\n \n \n {VERDICT_LABELS[viability.verdict]}\n {showConfidence ? (\n \n · {Math.round(viability.confidence * 100)}%\n \n ) : null}\n \n )\n}\n\n// ---------------------------------------------------------------------------\n// Compatibility ring (nexus4 MatchScoreBadge tiers)\n// ---------------------------------------------------------------------------\n\nconst TIER_RING_CLASSES: Record = {\n excellent: \"text-utility-green-600\",\n good: \"text-utility-blue-600\",\n fair: \"text-utility-amber-600\",\n poor: \"text-utility-orange-600\",\n low: \"text-utility-red-600\",\n}\n\n/** Compact score ring; colour follows the nexus4 tier bands. */\nexport function CompatibilityRing({\n compatibility,\n size = 36,\n className,\n}: {\n compatibility: Compatibility\n /** Outer box in px. */\n size?: number\n className?: string\n}) {\n const stroke = 3.5\n const radius = (size - stroke) / 2\n const circumference = 2 * Math.PI * radius\n const tier = scoreTier(compatibility.score)\n const offset = circumference - (compatibility.score / 100) * circumference\n return (\n \n \n \n \n \n \n {compatibility.score}\n \n \n )\n}\n\n// ---------------------------------------------------------------------------\n// Cost delta vs baseline\n// ---------------------------------------------------------------------------\n\n/** \"+£127,465 vs baseline\" (green = saving) or the baseline marker itself. */\nexport function SavingsDelta({\n opportunity,\n baseline,\n className,\n}: {\n opportunity: Opportunity\n baseline: Opportunity | undefined\n className?: string\n}) {\n if (!baseline || opportunity.isBaseline) {\n return (\n \n Baseline route\n \n )\n }\n const savings = savingsVsBaseline(opportunity, baseline)\n return (\n = 0 ? \"text-success-primary\" : \"text-error-primary\",\n className\n )}\n >\n {formatMoneyDelta(savings)} vs baseline\n \n )\n}\n\n// ---------------------------------------------------------------------------\n// Timing / strategy / status badges\n// ---------------------------------------------------------------------------\n\nconst TIMING_BADGE_VARIANTS: Record<\n TimingFit,\n React.ComponentProps[\"variant\"]\n> = {\n good: \"success\",\n tight: \"warning\",\n mismatch: \"error\",\n}\n\nexport function TimingBadge({\n timing,\n className,\n}: {\n timing: { fit: TimingFit; note: string }\n className?: string\n}) {\n return (\n \n \n {TIMING_FIT_LABELS[timing.fit]}\n \n )\n}\n\nexport function StrategyBadge({\n strategy,\n className,\n}: {\n strategy: OpportunityStrategy\n className?: string\n}) {\n return (\n \n {STRATEGY_LABELS[strategy]}\n \n )\n}\n\nconst STATUS_BADGE_VARIANTS: Record<\n OpportunityStatus,\n React.ComponentProps[\"variant\"]\n> = {\n new: \"blue\",\n shortlisted: \"brand\",\n enquiry_sent: \"success\",\n dismissed: \"gray\",\n}\n\nexport function OpportunityStatusBadge({\n status,\n className,\n}: {\n status: OpportunityStatus\n className?: string\n}) {\n return (\n \n {OPPORTUNITY_STATUS_LABELS[status]}\n \n )\n}\n", "type": "registry:component", "target": "components/blocks/domain/opportunities/opportunity-primitives.tsx" }, { "path": "components/blocks/domain/opportunities/options-matrix.tsx", "content": "\"use client\"\n\nimport * as React from \"react\"\n\nimport {\n Table,\n TableBody,\n TableCell,\n TableHead,\n TableHeader,\n TableRow,\n} from \"@/components/ui/table\"\nimport { cn } from \"@/lib/utils\"\nimport {\n CompatibilityRing,\n OpportunityStatusBadge,\n RouteSummary,\n SavingsDelta,\n StrategyBadge,\n TimingBadge,\n ViabilityBadge,\n} from \"./opportunity-primitives\"\nimport {\n baselineOf,\n formatDistanceKm,\n formatMoney,\n opportunityIsEstimated,\n opportunityTotalCost,\n rankOpportunities,\n type MaterialRequirement,\n type Opportunity,\n} from \"./types\"\n\n/**\n * OptionsMatrix — the full transparency view: every pathway the engine\n * considered for a requirement, including the ones it ruled out and why.\n * Where the comparison view helps choose between open options, this table\n * builds trust in the recommendation by showing the whole decision space —\n * ruled-out rows stay legible enough to read their exclusion reason.\n */\n\nexport function OptionsMatrix({\n requirement,\n opportunities,\n onOpenDetail,\n showSummary = true,\n className,\n}: {\n requirement: MaterialRequirement\n opportunities: Opportunity[]\n /** Rows become clickable when provided. */\n onOpenDetail?: (id: string) => void\n /** Hide the considered/open/ruled-out note when the host page carries it. */\n showSummary?: boolean\n className?: string\n}) {\n const ranked = rankOpportunities(opportunities)\n const baseline = baselineOf(opportunities)\n const ruledOut = opportunities.filter(\n (opportunity) => opportunity.viability.verdict === \"ruled_out\"\n ).length\n const open = opportunities.length - ruledOut\n\n return (\n
\n {showSummary ? (\n

\n {opportunities.length} pathways considered · {open} open · {ruledOut} ruled out\n

\n ) : null}\n
\n \n \n \n Pathway\n Route\n Verdict\n Compatibility\n Distance\n Timing\n Est. cost\n vs baseline\n Status\n \n \n \n {ranked.map((o) => {\n const dimmed = o.viability.verdict === \"ruled_out\"\n const mute = (children: React.ReactNode) =>\n dimmed ? {children} : children\n return (\n onOpenDetail(o.id) : undefined}\n className={cn(onOpenDetail && \"cursor-pointer\")}\n >\n \n
\n \n {onOpenDetail ? (\n {\n event.stopPropagation()\n onOpenDetail(o.id)\n }}\n className=\"cursor-pointer rounded-xs text-left text-sm font-semibold text-foreground focus-visible:ring-4 focus-visible:ring-ring/25 focus-visible:outline-none\"\n >\n {o.name}\n \n ) : (\n \n {o.name}\n \n )}\n \n \n \n {o.isBaseline ? (\n \n Baseline\n \n ) : null}\n \n {o.partner ? (\n \n {o.partner.name}\n \n ) : null}\n {dimmed && o.viability.ruledOutReason ? (\n \n {o.viability.ruledOutReason}\n \n ) : null}\n
\n \n \n {mute(\n \n )}\n \n \n \n \n \n {mute(\n o.compatibility ? (\n \n ) : (\n —\n )\n )}\n \n \n {mute(formatDistanceKm(o.totalDistanceKm))}\n \n {mute()}\n \n {mute(\n \n {opportunityIsEstimated(o) ? \"~\" : \"\"}\n {formatMoney(opportunityTotalCost(o))}\n \n )}\n \n \n {mute()}\n \n \n {mute()}\n \n \n )\n })}\n \n
\n
\n
\n )\n}\n", "type": "registry:component", "target": "components/blocks/domain/opportunities/options-matrix.tsx" }, { "path": "components/blocks/domain/opportunities/route-pathway.tsx", "content": "import { Truck01 } from \"@untitledui/icons\"\n\nimport { cn } from \"@/lib/utils\"\nimport { RouteNodeIcon } from \"./opportunity-primitives\"\nimport { formatDistanceKm, ROUTE_NODE_LABELS, type RouteNode } from \"./types\"\n\n/**\n * RoutePathway — the multi-step route visualisation for an opportunity:\n * every node in the chain (site, treatment facility, receiving site,\n * landfill, …) drawn as a labelled disc, joined by connector legs carrying\n * the haulage distance. Horizontal reads left-to-right for cards and\n * comparison surfaces; vertical is the compact rail variant for drawers and\n * narrow columns. Single-node routes (e.g. site-won processing) render the\n * node alone, no connectors.\n */\n\nconst DISC_BASE =\n \"flex size-10 shrink-0 items-center justify-center rounded-full ring-1\"\nconst DISC_DEFAULT = \"bg-bg-secondary text-fg-secondary ring-border\"\nconst DISC_TERMINAL = \"bg-bg-brand-primary text-fg-brand-primary ring-border-brand\"\n\nfunction NodeDisc({ node, terminal }: { node: RouteNode; terminal: boolean }) {\n return (\n \n \n \n )\n}\n\nfunction DwellPill({ note }: { note: string }) {\n return (\n \n {note}\n \n )\n}\n\nfunction LegChip({ distanceKm }: { distanceKm?: number }) {\n return (\n \n \n {distanceKm != null ? (\n {formatDistanceKm(distanceKm)}\n ) : null}\n \n )\n}\n\nexport function RoutePathway({\n route,\n orientation = \"horizontal\",\n className,\n}: {\n route: RouteNode[]\n /** Horizontal for cards and wide surfaces; vertical for drawers/rails. */\n orientation?: \"horizontal\" | \"vertical\"\n className?: string\n}) {\n if (orientation === \"vertical\") {\n return (\n
    \n {route.map((node, index) => {\n const terminal = index === route.length - 1 && route.length > 1\n return (\n
  1. \n {index > 0 ? (\n
    \n \n \n \n \n
    \n ) : null}\n
    \n \n
    \n \n {node.label}\n \n \n {ROUTE_NODE_LABELS[node.kind]}\n \n {node.detail ? (\n {node.detail}\n ) : null}\n {node.dwellNote ? : null}\n
    \n
    \n
    2. \n )\n })}\n
\n )\n }\n\n return (\n
\n
    \n {route.map((node, index) => {\n const terminal = index === route.length - 1 && route.length > 1\n return (\n
  1. \n {index > 0 ? (\n \n \n \n \n
\n ) : null}\n
\n \n
\n \n {node.label}\n \n \n {ROUTE_NODE_LABELS[node.kind]}\n \n {node.detail ? (\n \n {node.detail}\n \n ) : null}\n {node.dwellNote ? : null}\n
\n
\n \n )\n })}\n \n \n )\n}\n", "type": "registry:component", "target": "components/blocks/domain/opportunities/route-pathway.tsx" }, { "path": "components/blocks/domain/opportunities/types.ts", "content": "/**\n * opportunities — the shared contract for the opportunity matrix family\n * (opportunity-card, route-pathway, cost-breakdown, opportunity-comparison,\n * options-matrix, viability-panel, opportunity-detail).\n *\n * Like `marketplace-types` for the map family, this module holds the\n * vocabulary and nothing else. It models how Nexus presents the *routing\n * matrix* for a material requirement: every pathway the engine considered\n * for sourcing (imports) or placing (exports) a material — landfill\n * disposal, direct re-use, treat-then-reuse, stockpile-and-hold, primary or\n * recycled supply — each carrying route legs, an itemised cost estimate, a\n * compatibility score (mirroring the nexus4 matching engine's 1–100\n * composite with its material / distance / quantity breakdown) and an\n * AI-assessed viability verdict. Blocks depend on this and stay\n * data-agnostic; demo datasets live in `data.ts`.\n */\n\n// ---------------------------------------------------------------------------\n// The requirement (the base position an opportunity set is computed for)\n// ---------------------------------------------------------------------------\n\n/** `export` = surplus to move off site; `import` = a need to source. */\nexport type RequirementDirection = \"export\" | \"import\"\n\n/** Mirrors nexus4 `regulatoryStatus` (lowercased for display data). */\nexport type RegulatoryStatus = \"waste\" | \"product\" | \"byproduct\" | \"unknown\"\n\n/** Mirrors nexus4 `qualityLevel`. */\nexport type QualityLevel = \"unknown\" | \"declared\" | \"tested\" | \"certified\"\n\nexport interface RequirementMaterial {\n /** Taxonomy class, e.g. \"Topsoil\". */\n classLabel: string\n /** Leaf term, e.g. \"Topsoil — BS 3882 multipurpose grade\". */\n termLabel: string\n /** Six-digit EWC code where the material is (currently) waste. */\n ewcCode?: string\n regulatoryStatus: RegulatoryStatus\n qualityLevel: QualityLevel\n}\n\nexport interface RequirementQuantity {\n value: number\n /** Display unit, e.g. \"m³\" or \"t\". */\n unit: string\n /** Normalised volume for comparisons. */\n volumeM3: number\n /** Normalised mass for per-tonne costs. */\n tonnes: number\n}\n\nexport interface MaterialRequirement {\n id: string\n direction: RequirementDirection\n /** e.g. \"Surplus topsoil — Riverside Quarter\". */\n title: string\n projectName: string\n material: RequirementMaterial\n quantity: RequirementQuantity\n location: { name: string; postcode: string }\n /** Availability / need window, ISO dates. */\n window: { from: string; until: string }\n /** One-paragraph context shown on requirement headers. */\n summary?: string\n}\n\n// ---------------------------------------------------------------------------\n// Routes — a pathway is an ordered chain of nodes with legs between them\n// ---------------------------------------------------------------------------\n\n/** Node kinds mirror nexus4 movement endpoint kinds + facility types. */\nexport type RouteNodeKind =\n | \"site\"\n | \"receiving_site\"\n | \"treatment_facility\"\n | \"recycling_facility\"\n | \"transfer_station\"\n | \"landfill\"\n | \"stockpile\"\n | \"supplier\"\n\nexport interface RouteNode {\n id: string\n kind: RouteNodeKind\n /** e.g. \"Avonmouth Soil Treatment Centre\". */\n label: string\n /** What happens at this node, e.g. \"Screen to 10mm and blend to BS 3882\". */\n detail?: string\n /** Road distance of the leg *arriving* at this node (absent on the first). */\n legDistanceKm?: number\n /** Dwell annotation, e.g. \"held ~10 weeks\". */\n dwellNote?: string\n /**\n * Position relative to the requirement site for spatial views: compass\n * bearing and straight-line distance (road distances stay on the legs).\n * Omit on nodes at the requirement site itself — they sit at the centre.\n */\n geo?: { bearingDeg: number; distanceKm: number }\n}\n\nexport const ROUTE_NODE_LABELS: Record = {\n site: \"Own site\",\n receiving_site: \"Receiving site\",\n treatment_facility: \"Treatment facility\",\n recycling_facility: \"Recycling facility\",\n transfer_station: \"Transfer station\",\n landfill: \"Landfill\",\n stockpile: \"Storage / stockpile\",\n supplier: \"Supplier\",\n}\n\n// ---------------------------------------------------------------------------\n// Costs — itemised estimate lines; negative amounts are credits\n// ---------------------------------------------------------------------------\n\nexport type CostKind =\n | \"haulage\"\n | \"gate_fee\"\n | \"landfill_tax\"\n | \"treatment\"\n | \"testing\"\n | \"storage\"\n | \"material_purchase\"\n | \"processing\"\n | \"admin\"\n | \"credit\"\n | \"other\"\n\nexport const COST_KIND_LABELS: Record = {\n haulage: \"Haulage\",\n gate_fee: \"Gate fee\",\n landfill_tax: \"Landfill tax\",\n treatment: \"Treatment\",\n testing: \"Testing\",\n storage: \"Storage\",\n material_purchase: \"Material purchase\",\n processing: \"Processing\",\n admin: \"Administration\",\n credit: \"Credit\",\n other: \"Other\",\n}\n\nexport interface CostLine {\n id: string\n kind: CostKind\n /** e.g. \"Haulage — 265 loads to Shortwood\". */\n label: string\n /** GBP. Negative = credit/avoided cost (rendered as a saving). */\n amount: number\n /** Qualifier, e.g. \"at £4.05/t inert rate\". */\n note?: string\n /** True when modelled rather than quoted — rendered with a tilde. */\n estimated?: boolean\n}\n\n// ---------------------------------------------------------------------------\n// Compatibility — mirrors the nexus4 matching engine output\n// ---------------------------------------------------------------------------\n\nexport type MaterialRelation =\n | \"exact\"\n | \"same_class\"\n | \"same_family\"\n | \"cross_class_rule\"\n\nexport const MATERIAL_RELATION_LABELS: Record = {\n exact: \"Exact material match\",\n same_class: \"Same material class\",\n same_family: \"Same material family\",\n cross_class_rule: \"Compatible by rule\",\n}\n\n/** The engine's composite (1–100) and its factor breakdown (each 0–1). */\nexport interface Compatibility {\n score: number\n breakdown: { material: number; distance: number; quantity: number }\n relation: MaterialRelation\n /** Human explainers, e.g. \"Quantity fully meets requirement\". */\n explainers: string[]\n}\n\nexport type ScoreTier = \"excellent\" | \"good\" | \"fair\" | \"poor\" | \"low\"\n\n/** The nexus4 `MatchScoreBadge` tier bands. */\nexport function scoreTier(score: number): ScoreTier {\n if (score >= 80) return \"excellent\"\n if (score >= 60) return \"good\"\n if (score >= 40) return \"fair\"\n if (score >= 20) return \"poor\"\n return \"low\"\n}\n\nexport const SCORE_TIER_LABELS: Record = {\n excellent: \"Excellent\",\n good: \"Good\",\n fair: \"Fair\",\n poor: \"Poor\",\n low: \"Low\",\n}\n\n// ---------------------------------------------------------------------------\n// Viability — the AI assessment layer (new; no nexus4 equivalent yet)\n// ---------------------------------------------------------------------------\n\nexport type ViabilityVerdict = \"viable\" | \"conditional\" | \"unlikely\" | \"ruled_out\"\n\nexport const VERDICT_LABELS: Record = {\n viable: \"Viable\",\n conditional: \"Conditional\",\n unlikely: \"Unlikely\",\n ruled_out: \"Ruled out\",\n}\n\nexport type ConditionStatus = \"met\" | \"action_needed\" | \"pending\"\n\n/** A gate the pathway must pass, e.g. \"BS 3882 test results\". */\nexport interface ViabilityCondition {\n id: string\n label: string\n status: ConditionStatus\n detail?: string\n}\n\nexport interface Viability {\n verdict: ViabilityVerdict\n /** Assessment confidence, 0–1. */\n confidence: number\n /** One-sentence plain-English assessment. */\n summary: string\n strengths: string[]\n risks: string[]\n conditions: ViabilityCondition[]\n /** Single reason shown for ruled-out options in the matrix. */\n ruledOutReason?: string\n /** ISO datetime of the assessment run. */\n assessedAt: string\n}\n\n// ---------------------------------------------------------------------------\n// Compliance — derived requirement items (nexus4 requirements engine style)\n// ---------------------------------------------------------------------------\n\nexport type ComplianceStatus = \"ok\" | \"gap\" | \"pending\"\n\nexport interface ComplianceItem {\n id: string\n /** e.g. \"Waste transfer notes per load\". */\n label: string\n status: ComplianceStatus\n detail?: string\n}\n\n// ---------------------------------------------------------------------------\n// The opportunity — one considered pathway\n// ---------------------------------------------------------------------------\n\nexport type OpportunityStrategy =\n | \"landfill_disposal\"\n | \"direct_reuse\"\n | \"treat_then_reuse\"\n | \"treat_and_return\"\n | \"stockpile_hold\"\n | \"recovery\"\n | \"supply_primary\"\n | \"supply_recycled\"\n | \"supply_surplus\"\n | \"site_won\"\n\nexport const STRATEGY_LABELS: Record = {\n landfill_disposal: \"Landfill disposal\",\n direct_reuse: \"Direct re-use\",\n treat_then_reuse: \"Treat, then re-use\",\n treat_and_return: \"Treat and return\",\n stockpile_hold: \"Stockpile and hold\",\n recovery: \"Land recovery\",\n supply_primary: \"Primary supply\",\n supply_recycled: \"Recycled supply\",\n supply_surplus: \"Surplus from site\",\n site_won: \"Site-won processing\",\n}\n\nexport type TimingFit = \"good\" | \"tight\" | \"mismatch\"\n\nexport const TIMING_FIT_LABELS: Record = {\n good: \"Windows align\",\n tight: \"Tight window\",\n mismatch: \"Window mismatch\",\n}\n\nexport type OpportunityStatus = \"new\" | \"shortlisted\" | \"enquiry_sent\" | \"dismissed\"\n\nexport const OPPORTUNITY_STATUS_LABELS: Record = {\n new: \"New\",\n shortlisted: \"Shortlisted\",\n enquiry_sent: \"Enquiry sent\",\n dismissed: \"Dismissed\",\n}\n\nexport interface Opportunity {\n id: string\n requirementId: string\n /** Card title, e.g. \"Direct re-use — Meadowbank Park\". */\n name: string\n strategy: OpportunityStrategy\n /** The industry-default route others are compared against. */\n isBaseline?: boolean\n /** One-line pitch under the title. */\n headline: string\n /** Counterparty, where one exists. */\n partner?: { name: string; siteName?: string }\n route: RouteNode[]\n totalDistanceKm: number\n costs: CostLine[]\n timing: { fit: TimingFit; note: string }\n /** Absent where there is no matched counterpart (e.g. landfill). */\n compatibility?: Compatibility\n viability: Viability\n compliance: ComplianceItem[]\n status: OpportunityStatus\n}\n\n// ---------------------------------------------------------------------------\n// Derivations & formatting\n// ---------------------------------------------------------------------------\n\n/** Net estimated cost of a pathway (credits subtract). */\nexport function opportunityTotalCost(opportunity: Opportunity): number {\n return opportunity.costs.reduce((sum, line) => sum + line.amount, 0)\n}\n\n/** True when any cost line is modelled rather than quoted. */\nexport function opportunityIsEstimated(opportunity: Opportunity): boolean {\n return opportunity.costs.some((line) => line.estimated)\n}\n\n/** Positive = cheaper than the baseline pathway. */\nexport function savingsVsBaseline(\n opportunity: Opportunity,\n baseline: Opportunity\n): number {\n return opportunityTotalCost(baseline) - opportunityTotalCost(opportunity)\n}\n\nexport function baselineOf(\n opportunities: Opportunity[]\n): Opportunity | undefined {\n return opportunities.find((opportunity) => opportunity.isBaseline)\n}\n\n/** £12,400 / −£3,150; whole pounds. */\nexport function formatMoney(amount: number): string {\n const rounded = Math.round(Math.abs(amount))\n const formatted = `£${rounded.toLocaleString(\"en-GB\")}`\n return amount < 0 ? `−${formatted}` : formatted\n}\n\n/** Signed delta for savings copy: \"+£128,200\" (saving) / \"−£9,000\". */\nexport function formatMoneyDelta(amount: number): string {\n return `${amount >= 0 ? \"+\" : \"−\"}£${Math.round(Math.abs(amount)).toLocaleString(\"en-GB\")}`\n}\n\nexport function formatPerTonne(\n total: number,\n requirement: MaterialRequirement\n): string {\n if (!requirement.quantity.tonnes) return \"—\"\n return `£${(total / requirement.quantity.tonnes).toFixed(2)}/t`\n}\n\nexport function formatDistanceKm(km: number): string {\n return km < 10 ? `${km.toFixed(1)} km` : `${Math.round(km)} km`\n}\n\nexport function formatQuantity(requirement: MaterialRequirement): string {\n const { value, unit, tonnes } = requirement.quantity\n return `${value.toLocaleString(\"en-GB\")} ${unit} (~${tonnes.toLocaleString(\"en-GB\")} t)`\n}\n\nconst WINDOW_FORMAT = new Intl.DateTimeFormat(\"en-GB\", {\n month: \"short\",\n year: \"numeric\",\n})\n\nexport function formatWindow(window: { from: string; until: string }): string {\n const from = WINDOW_FORMAT.format(new Date(window.from))\n const until = WINDOW_FORMAT.format(new Date(window.until))\n return from === until ? from : `${from} – ${until}`\n}\n\nexport function formatConfidence(confidence: number): string {\n return `${Math.round(confidence * 100)}% confidence`\n}\n\n/** Sort: baseline last within equal verdicts; viable-first, cheapest-first. */\nconst VERDICT_ORDER: Record = {\n viable: 0,\n conditional: 1,\n unlikely: 2,\n ruled_out: 3,\n}\n\nexport function rankOpportunities(opportunities: Opportunity[]): Opportunity[] {\n return [...opportunities].sort((a, b) => {\n const verdict = VERDICT_ORDER[a.viability.verdict] - VERDICT_ORDER[b.viability.verdict]\n if (verdict !== 0) return verdict\n return opportunityTotalCost(a) - opportunityTotalCost(b)\n })\n}\n", "type": "registry:component", "target": "components/blocks/domain/opportunities/types.ts" }, { "path": "components/blocks/domain/opportunities/viability-panel.tsx", "content": "import type * as React from \"react\"\nimport {\n AlertCircle,\n AlertTriangle,\n CheckCircle,\n Clock,\n SlashOctagon,\n Stars01,\n} from \"@untitledui/icons\"\n\nimport { Badge } from \"@/components/ui/badge\"\nimport { cn } from \"@/lib/utils\"\nimport { ViabilityBadge } from \"./opportunity-primitives\"\nimport {\n formatConfidence,\n type ConditionStatus,\n type Viability,\n type ViabilityCondition,\n type ViabilityVerdict,\n} from \"./types\"\n\n/**\n * ViabilityPanel — the AI reasoning surface. Shows how the assessment was\n * reached, not just the verdict: the plain-English summary, a confidence\n * meter, the strengths and risks the model weighed, and the conditions the\n * pathway must still pass (each a checklist gate with its own status).\n * Ruled-out pathways swap the lists for a single error callout carrying the\n * reason, so a dead option never masquerades as an open one.\n */\n\nconst ASSESSED_FORMAT = new Intl.DateTimeFormat(\"en-GB\", {\n day: \"numeric\",\n month: \"short\",\n year: \"numeric\",\n})\n\nconst CONFIDENCE_FILL: Record = {\n viable: \"bg-utility-green-500\",\n conditional: \"bg-utility-amber-500\",\n unlikely: \"bg-utility-neutral-400\",\n ruled_out: \"bg-utility-red-500\",\n}\n\nconst CONDITION_META: Record<\n ConditionStatus,\n {\n icon: React.ComponentType<{ className?: string }>\n iconClass: string\n label: string\n variant: React.ComponentProps[\"variant\"]\n }\n> = {\n met: {\n icon: CheckCircle,\n iconClass: \"text-fg-success-primary\",\n label: \"Met\",\n variant: \"success\",\n },\n action_needed: {\n icon: AlertCircle,\n iconClass: \"text-fg-warning-primary\",\n label: \"Action needed\",\n variant: \"warning\",\n },\n pending: {\n icon: Clock,\n iconClass: \"text-fg-quaternary\",\n label: \"Pending\",\n variant: \"gray\",\n },\n}\n\nfunction ConditionRow({ condition }: { condition: ViabilityCondition }) {\n const meta = CONDITION_META[condition.status]\n const Icon = meta.icon\n return (\n
  • \n \n
    \n {condition.label}\n {condition.detail ? (\n {condition.detail}\n ) : null}\n
    \n \n {meta.label}\n \n
    • \n )\n}\n\nfunction AssessmentList({\n title,\n items,\n icon: Icon,\n iconClass,\n}: {\n title: string\n items: string[]\n icon: React.ComponentType<{ className?: string }>\n iconClass: string\n}) {\n if (items.length === 0) return null\n return (\n
    \n

    \n {title}\n

    \n
      \n {items.map((item) => (\n
    • \n \n {item}\n
      • \n ))}\n
    \n
    \n )\n}\n\nexport function ViabilityPanel({\n viability,\n className,\n}: {\n viability: Viability\n className?: string\n}) {\n const ruledOut = viability.verdict === \"ruled_out\"\n\n return (\n \n
    \n \n

    Viability assessment

    \n \n
    \n\n

    {viability.summary}

    \n\n
    \n
    \n \n
    \n \n {formatConfidence(viability.confidence)}\n \n
    \n\n {ruledOut && viability.ruledOutReason ? (\n
    \n \n
    \n Ruled out\n {viability.ruledOutReason}\n
    \n
    \n ) : null}\n\n \n \n\n {viability.conditions.length > 0 ? (\n
    \n

    \n Conditions\n

    \n
      \n {viability.conditions.map((condition) => (\n \n ))}\n
    \n
    \n ) : null}\n\n

    \n Assessed by Nexus AI · {ASSESSED_FORMAT.format(new Date(viability.assessedAt))}\n

    \n \n )\n}\n", "type": "registry:component", "target": "components/blocks/domain/opportunities/viability-panel.tsx" }, { "path": "components/blocks/domain/opportunities/viz-utils.tsx", "content": "\"use client\"\n\nimport * as React from \"react\"\n\nimport { cn } from \"@/lib/utils\"\nimport { ViabilityBadge } from \"./opportunity-primitives\"\nimport {\n formatMoney,\n formatMoneyDelta,\n opportunityTotalCost,\n savingsVsBaseline,\n STRATEGY_LABELS,\n VERDICT_LABELS,\n type Opportunity,\n type ViabilityVerdict,\n} from \"./types\"\n\n/**\n * Shared pieces for the visual surfaces (proximity map, cost flow, decision\n * grid): the verdict mark colours, the hover tooltip and the legend. Marks\n * wear these colours; text always stays on text tokens.\n */\n\n// ---------------------------------------------------------------------------\n// Verdict mark colours — theme-flipping fg steps (500 light / 400 dark)\n// ---------------------------------------------------------------------------\n\nexport const VERDICT_MARK_COLORS: Record = {\n viable: \"var(--color-fg-success-secondary)\",\n conditional: \"var(--color-fg-warning-secondary)\",\n unlikely: \"var(--color-fg-quaternary)\",\n ruled_out: \"var(--color-fg-quaternary)\",\n}\n\n/** Soft fill for ribbon/area marks (a wash of the mark colour). */\nexport function verdictWash(verdict: ViabilityVerdict, pct = 24): string {\n return `color-mix(in oklab, ${VERDICT_MARK_COLORS[verdict]} ${pct}%, transparent)`\n}\n\nexport const RULED_OUT_DASH = \"5 4\"\n\n/** Short display name: the part after the dash (\"Direct re-use — Meadowbank\n * Park\" → \"Meadowbank Park\"), else the full name. */\nexport function opportunityShortName(opportunity: Opportunity): string {\n return opportunity.name.split(\"—\")[1]?.trim() || opportunity.name\n}\n\n// ---------------------------------------------------------------------------\n// Legend\n// ---------------------------------------------------------------------------\n\nconst LEGEND_VERDICTS: ViabilityVerdict[] = [\n \"viable\",\n \"conditional\",\n \"unlikely\",\n \"ruled_out\",\n]\n\n/** Verdict swatch row shown above every visual surface. */\nexport function VerdictLegend({\n note,\n className,\n}: {\n /** Right-aligned caption, e.g. \"ribbon width = estimated net cost\". */\n note?: string\n className?: string\n}) {\n return (\n \n
    \n {LEGEND_VERDICTS.map((verdict) => (\n \n \n {verdict === \"ruled_out\" ? (\n \n ) : (\n \n )}\n \n {VERDICT_LABELS[verdict]}\n \n ))}\n
    \n {note ?

    {note}

    : null}\n \n )\n}\n\n// ---------------------------------------------------------------------------\n// Hover tooltip\n// ---------------------------------------------------------------------------\n\nexport interface VizTipState {\n opportunity: Opportunity\n x: number\n y: number\n}\n\n/** Pointer-tracked tooltip state, positioned within a relative container. */\nexport function useVizTip() {\n const [tip, setTip] = React.useState(null)\n const containerRef = React.useRef(null)\n\n const move = React.useCallback(\n (opportunity: Opportunity) => (event: React.MouseEvent) => {\n const bounds = containerRef.current?.getBoundingClientRect()\n if (!bounds) return\n setTip({\n opportunity,\n x: event.clientX - bounds.left,\n y: event.clientY - bounds.top,\n })\n },\n []\n )\n\n /** Keyboard-focus fallback: pin the tip at a fixed point of the mark. */\n const pin = React.useCallback(\n (opportunity: Opportunity, x: number, y: number) => () =>\n setTip({ opportunity, x, y }),\n []\n )\n\n const clear = React.useCallback(() => setTip(null), [])\n\n return { tip, move, pin, clear, containerRef }\n}\n\nexport function VizTooltip({\n tip,\n baseline,\n}: {\n tip: VizTipState | null\n baseline: Opportunity | undefined\n}) {\n if (!tip) return null\n const { opportunity } = tip\n const cost = opportunityTotalCost(opportunity)\n const savings =\n baseline && !opportunity.isBaseline\n ? savingsVsBaseline(opportunity, baseline)\n : null\n return (\n 320 ? \"translateX(-100%) translateX(-24px)\" : undefined,\n }}\n >\n
    \n

    \n {opportunityShortName(opportunity)}\n

    \n \n
    \n

    \n {STRATEGY_LABELS[opportunity.strategy]}\n {opportunity.partner ? ` · ${opportunity.partner.name}` : null}\n

    \n

    \n ~{formatMoney(cost)}\n {savings != null ? (\n = 0 ? \"text-success-primary\" : \"text-error-primary\"\n )}\n >\n {formatMoneyDelta(savings)} vs baseline\n \n ) : (\n \n baseline\n \n )}\n

    \n {opportunity.viability.verdict === \"ruled_out\" &&\n opportunity.viability.ruledOutReason ? (\n

    \n Ruled out: {opportunity.viability.ruledOutReason}\n

    \n ) : null}\n

    Click for the full pathway

    \n \n )\n}\n", "type": "registry:component", "target": "components/blocks/domain/opportunities/viz-utils.tsx" } ], "type": "registry:block" }