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 = `
${layerState.enabled ? 'CONTEXT READY' : 'GLOBAL CONTEXT OFF'} ${layerState.enabled ? 'SELECT A FLIGHT, VESSEL, OR MAPPED INSTALLATION' : 'ENABLE TO LOAD OBSERVED / MAPPED PROXIMITY'}
`; layerState.panel.hidden = false; if (layerState.panelMarkup !== markup) { layerState.panel.innerHTML = markup; layerState.panelMarkup = markup; } } if (layerState.directionRoot) layerState.directionRoot.hidden = true; } function rowHtml(cohort) { const summary = cohort.summary; const count = formatAwarenessCount(summary); const page = layerState.cohortPages.get(cohort.id) || 0; const nearest = summary.nearest .slice(page, page + AWARENESS_PAGE_SIZE) .map((item) => { const label = formatAwarenessLabel(item); const targetId = item.icao24 || item.mmsi || item.id; if (!targetId) { return `
  • ${escapeHtml(label)} ${formatAwarenessDistance(item.distanceM)}
  • `; } const accessibleLabel = label === '—' ? 'Unavailable' : label; return `
  • ${namedAreasHtml(item.memberNames)}
  • `; }) .join(''); const pageCount = Math.max( 1, Math.ceil(summary.nearest.length / AWARENESS_PAGE_SIZE), ); const pageLabel = pageCount > 1 ? ` · ${Math.floor(page / AWARENESS_PAGE_SIZE) + 1}/${pageCount}` : ''; const coverage = cohort.coverage ? ` · ${escapeHtml(cohort.coverage)}` : ''; return `
    ${escapeHtml(cohort.label)}${count}${pageLabel}
    ${escapeHtml(cohort.source)}${coverage} · ${escapeHtml(summary.reason)} ${nearest ? `` : ''}
    `; } function navigationControlsHtml() { const canPrevious = layerState.navigationIndex > 0; return `
    `; } /** Stable identity for a delegated Contacts-panel button across live repaints. */ function awarenessPanelControlKey(element) { const control = element?.closest?.( 'button[data-awareness-action], button[data-awareness-layer][data-awareness-id]', ); if (!control) return null; if (control.dataset.awarenessAction) return `action:${control.dataset.awarenessAction}`; return `target:${control.dataset.awarenessLayer}:${control.dataset.awarenessId}`; } /** Capture stable identity so a live repaint can restore only the same control. */ function captureAwarenessPanelFocus( panel, activeElement = document.activeElement, ) { if (!panel?.contains?.(activeElement)) return null; if (activeElement?.matches?.('[data-awareness-focus-continuation]')) { return { key: 'continuation' }; } const key = awarenessPanelControlKey(activeElement); if (!key) return null; return { key }; } /** Restore the same control, or continue beyond the list when it is no longer rendered. */ function restoreAwarenessPanelFocus(panel, snapshot) { if (!panel || !snapshot) return null; const continuation = panel.querySelector( '[data-awareness-focus-continuation]', ); const controls = [ ...panel.querySelectorAll( 'button[data-awareness-action], button[data-awareness-layer][data-awareness-id]', ), ].filter((control) => !control.disabled); const retained = snapshot.key === 'continuation' ? continuation : controls.find( (control) => awarenessPanelControlKey(control) === snapshot.key, ); const target = retained || continuation; target?.focus?.({ preventScroll: true }); return target || null; } function escapeHtml(value) { return String(value ?? '').replace( /[&<>'"]/g, (char) => ({ '&': '&', '<': '<', '>': '>', "'": ''', '"': '"', })[char], ); } function namedAreasHtml(names) { return names?.length ? `
    Named areas (${names.length})
    ${names.map((name) => escapeHtml(name)).join('
    ')}
    ` : ''; } function renderResults() { if (!layerState.enabled || !layerState.results) return hidePanel(); const panel = ensurePanel(); const { subject, cohorts } = layerState.results; const markup = `
    ${escapeHtml(subject.label)} · ${formatAwarenessDistance(AWARENESS_RADIUS_M)} FLIGHT / VESSEL WINDOW
    ${namedAreasHtml(subject.memberNames)} ${navigationControlsHtml()} ${cohorts.map(rowHtml).join('')}

    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, }; }