import { formatAwarenessLabel, formatAwarenessDistance, AWARENESS_RADIUS_M, } from '../../data/militaryAwarenessEngine.js'; import { AWARENESS_PAGE_SIZE, AWARENESS_PAGE_ROTATE_MS } from './policy.js'; /** Format a cohort total without presenting a retained cap as exact. */ export function formatAwarenessCount(summary = {}) { if (!Number.isFinite(summary.count)) return '?'; const count = summary.count.toLocaleString('en-US'); return summary.complete === false || summary.truncated === true ? `At least ${count}` : count; } export function createPanel({ state: layerState, services, parts, source }) { function ensurePanel() { if (layerState.panel) return layerState.panel; const existing = document.getElementById('military-awareness-panel'); const panel = existing || document.createElement('aside'); layerState.panelOwned = !existing; if (!existing) { panel.id = 'military-awareness-panel'; } layerState.panelClickListener = (event) => { const action = event.target.closest('button[data-awareness-action]'); if (action) { event.preventDefault(); if (action.dataset.awarenessAction === 'previous') parts.history.navigateHistory(-1, { origin: 'user' }); if (action.dataset.awarenessAction === 'next') parts.history.navigateHistory(1, { origin: 'user' }); if (action.dataset.awarenessAction === 'focus') parts.focus.focusCurrentSubject({ origin: 'user' }); return; } const target = event.target.closest( 'button[data-awareness-layer][data-awareness-id]', ); if (!target) return; event.preventDefault(); parts.focus.requestFocus( target.dataset.awarenessLayer, target.dataset.awarenessId, false, { origin: 'user' }, ); }; panel.addEventListener('click', layerState.panelClickListener); if (!existing) document.body.appendChild(panel); layerState.panel = panel; return panel; } function hidePanel() { if (layerState.panel) { const markup = `
Open-source mapped/observed context. Missing broadcasts, unloaded map areas, or unmapped sites are not evidence of absence.
`; panel.hidden = false; if (layerState.panelMarkup !== markup) { const focusSnapshot = captureAwarenessPanelFocus(panel); panel.innerHTML = markup; layerState.panelMarkup = markup; restoreAwarenessPanelFocus(panel, focusSnapshot); } } function rotateAwarenessPages() { if (!layerState.enabled || !layerState.results) return; let changed = false; for (const cohort of layerState.results.cohorts) { const pageCount = Math.max( 1, Math.ceil(cohort.summary.nearest.length / AWARENESS_PAGE_SIZE), ); if (pageCount <= 1) continue; const current = layerState.cohortPages.get(cohort.id) || 0; layerState.cohortPages.set( cohort.id, ((Math.floor(current / AWARENESS_PAGE_SIZE) + 1) % pageCount) * AWARENESS_PAGE_SIZE, ); changed = true; } if (changed) { renderResults(); parts.rendering.scheduleDirectionOverlayUpdate(true); } } function startAwarenessPageRotation() { if (!layerState.pageTimer) layerState.pageTimer = window.setInterval( rotateAwarenessPages, AWARENESS_PAGE_ROTATE_MS, ); } function stopAwarenessPageRotation() { if (layerState.pageTimer) window.clearInterval(layerState.pageTimer); layerState.pageTimer = null; } /** * Whether an evaluation actually has a contact to point an arrow at. * * A cohort reports `count: null` when its feed is unavailable or stale, and `0` * when the feed is healthy but empty. Only a positive count puts a marker on * the compass rim, so anything else means there is nothing to animate. * @param {?{cohorts?: Array<{summary?: {count: ?number}}>}} results * @returns {boolean} */ function awarenessResultsAreLive(results) { const cohorts = Array.isArray(results?.cohorts) ? results.cohorts : []; return cohorts.some((cohort) => Number(cohort?.summary?.count) > 0); } return { ensurePanel, hidePanel, rowHtml, navigationControlsHtml, awarenessPanelControlKey, captureAwarenessPanelFocus, restoreAwarenessPanelFocus, escapeHtml, renderResults, rotateAwarenessPages, startAwarenessPageRotation, stopAwarenessPageRotation, awarenessResultsAreLive, }; }