Files
gods-eye-view/src/layers/perimeters/cards.js
T

238 lines
8.0 KiB
JavaScript

/** Card model for one selected fire-perimeter incident. Pure — no Cesium types. */
import { formatNumber, t, tn } from '../../i18n/index.js';
export const PERIMETER_OVERLAY_SOURCE_ID = 'fire-perimeters';
/** CSS accent for a perimeter card by containment progress (mirrors the fill). */
export function containmentAccent(containedPct) {
if (!Number.isFinite(containedPct) || containedPct <= 0) return '#ff3b30';
if (containedPct < 50) return '#ff7a00';
if (containedPct < 100) return '#ffb300';
return '#8bc34a';
}
/** Shoelace area along short longitude edges (degree², relative sizes only). */
function ringArea(ring) {
let sum = 0;
let [x1, y1] = ring[0];
for (let i = 1; i < ring.length; i++) {
let delta = ring[i][0] - ring[i - 1][0];
if (delta > 180) delta -= 360;
else if (delta < -180) delta += 360;
const x2 = x1 + delta;
const y2 = ring[i][1];
sum += x1 * y2 - x2 * y1;
x1 = x2;
y1 = y2;
}
return Math.abs(sum / 2);
}
/**
* Anchor point for the incident card: the vertex mean of the largest polygon's
* outer ring, with circular longitude. Callers own the Cartesian conversion.
* @param {Array<Array<Array<[number, number]>>>} polygons - Normalized rows' polygons.
* @returns {{lon: number, lat: number}}
*/
export function perimeterAnchorDegrees(polygons) {
let best = null;
let bestArea = -1;
for (const rings of polygons) {
const outer = rings[0];
const area = ringArea(outer);
if (area > bestArea) {
bestArea = area;
best = outer;
}
}
// Vertex mean over the closed ring (first == last point dropped): perimeters
// are compact enough that this stays inside or near the polygon.
let sinLon = 0;
let cosLon = 0;
let lat = 0;
const count = best.length - 1;
const toRad = Math.PI / 180;
for (let i = 0; i < count; i++) {
sinLon += Math.sin(best[i][0] * toRad);
cosLon += Math.cos(best[i][0] * toRad);
lat += best[i][1];
}
return { lon: Math.atan2(sinLon, cosLon) / toRad, lat: lat / count };
}
/**
* Compact USD in the UI language: en "$85K / $4.2M / $1.3B", ru "4,2 млн $",
* es "4,2 M$". Null under $1,000.
*/
function formatCost(dollars) {
if (!Number.isFinite(dollars) || dollars < 1000) return null;
const units = [1e3, 1e6, 1e9];
let index = 0;
for (let i = units.length - 1; i >= 0; i--) {
if (dollars >= units[i]) {
index = i;
break;
}
}
// 999,500 must promote to $1M, never render as $1000K.
if (dollars >= units[index] * 999.5 && index < units.length - 1) index++;
const value = dollars / units[index];
const amount = formatNumber(
value >= 10 ? Math.round(value) : Math.round(value * 10) / 10,
);
if (index === 0) return t('${amount}K', { amount });
if (index === 1) return t('${amount}M', { amount });
return t('${amount}B', { amount });
}
/** WFIGS attr_FireCause values in the UI language; others as sent. */
function causeLabel(cause) {
switch (cause) {
case 'Human':
return t('Human', { context: 'fire cause' });
case 'Natural':
return t('Natural', { context: 'fire cause' });
case 'Undetermined':
return t('Undetermined', { context: 'fire cause' });
case 'Unknown':
return t('Unknown', { context: 'fire cause' });
default:
return cause;
}
}
/** WFIGS attr_FireBehaviorGeneral values in the UI language; others as sent. */
function behaviorLabel(behavior) {
switch (behavior) {
case 'Minimal':
return t('Minimal', { context: 'fire behavior' });
case 'Moderate':
return t('Moderate', { context: 'fire behavior' });
case 'Active':
return t('Active', { context: 'fire behavior' });
case 'Extreme':
return t('Extreme', { context: 'fire behavior' });
default:
return behavior;
}
}
/**
* WFIGS attr_IncidentComplexityLevel ("Type 1 Incident" … "Type 5 Incident")
* in the UI language; other values as sent.
*/
function complexityLabel(complexity) {
const match = /^Type ([1-5]) Incident$/.exec(complexity);
return match ? t('Type {level} Incident', { level: match[1] }) : complexity;
}
/** WFIGS complex names arrive ALL-CAPS; render them in title case. */
function titleCase(name) {
return String(name)
.toLowerCase()
.replace(/\b[a-z]/g, (letter) => letter.toUpperCase());
}
/** Compact age, "5m" / "3h" / "2d", in the UI language ("3 h", "3 ч"). */
function formatAge(deltaMs) {
if (!Number.isFinite(deltaMs) || deltaMs < 0) return null;
const hours = Math.floor(deltaMs / 3600000);
if (hours < 1)
return t('{count}m', {
context: 'age',
count: Math.max(1, Math.floor(deltaMs / 60000)),
});
if (hours < 24) return t('{count}h', { context: 'age', count: hours });
return t('{count}d', { context: 'age', count: Math.floor(hours / 24) });
}
/**
* Build the overlay-host entry for one selected incident. The caller supplies
* `position` (Cartesian) separately — this model stays JSON-safe for tests.
* @param {Object} row - Normalized perimeter row (see records.js).
* @param {number} nowMs - Current epoch milliseconds.
* @param {{link: ?string}} [extras] - Optional InciWeb page for this incident.
* @returns {Object} World-overlay entry without `position`.
*/
export function buildIncidentCard(row, nowMs, { link = null } = {}) {
// The row keeps WFIGS values as sent (AI tools read them); the card translates
// the known cause, behavior and complexity values and the wording around them.
const facts = [];
if (Number.isFinite(row.acres)) {
const acres =
row.acres < 1 ? Math.round(row.acres * 100) / 100 : Math.round(row.acres);
facts.push(
tn(acres, '{acres} ac', '{acres} ac', { acres: formatNumber(acres) }),
);
}
facts.push(
Number.isFinite(row.containedPct)
? t('{percent}% contained', { percent: Math.round(row.containedPct) })
: t('containment unknown'),
);
if (row.state) facts.push(row.state);
else if (row.category) facts.push(row.category);
const situation = [];
if (row.cause)
situation.push(t('{cause} cause', { cause: causeLabel(row.cause) }));
if (row.behavior) situation.push(behaviorLabel(row.behavior));
if (row.complexity) situation.push(complexityLabel(row.complexity));
const response = [];
if (Number.isFinite(row.personnel)) {
const personnel = Math.round(row.personnel);
response.push(
tn(personnel, '{personnel} personnel', '{personnel} personnel', {
personnel: formatNumber(personnel),
}),
);
}
if (row.county) response.push(t('{county} County', { county: row.county }));
if (Number.isFinite(row.costToDate)) {
const cost = formatCost(row.costToDate);
if (cost) response.push(t('{cost} to date', { cost }));
}
const ages = [];
const discovered = formatAge(nowMs - row.discoveredTime);
if (row.discoveredTime != null && discovered)
ages.push(t('discovered {age} ago', { age: discovered }));
const updated = formatAge(nowMs - row.updatedTime);
if (row.updatedTime != null && updated)
ages.push(t('updated {age} ago', { age: updated }));
const details = [facts.join(' · ')];
if (row.complexName)
details.push(
t('part of {complex}', { complex: titleCase(row.complexName) }),
);
if (situation.length) details.push(situation.join(' · '));
if (response.length) details.push(response.join(' · '));
if (ages.length) details.push(ages.join(' · '));
if (link) details.push(t('InciWeb ↗ · click card to open'));
const title = t('FIRE · {name}', {
name: row.name || t('Unnamed incident'),
});
return {
id: `fire-perimeter-card:${row.stableId}`,
// `selected` picks the paint lane and collision protection; an explicit
// paintLane would override it in the host's lane resolver.
selected: true,
// Only a linked card is clickable — the overlay host registers hit
// rectangles solely for interactive entries.
interactive: Boolean(link),
...(link
? { accessibilityLabel: t('Open {title} on InciWeb', { title }) }
: undefined),
title,
details,
accent: containmentAccent(row.containedPct),
priority: Number.MAX_SAFE_INTEGER,
gapPx: 15,
verticalOnly: true,
placement: 'above',
};
}