feat(mapillary): Street Level panel in the right context rail

An ordinary collapsible GEV panel between CCTV and Context, starting
collapsed with the Mapillary mark in its strip. Body: a gated empty state
when no client token is present, plain-English query box (ASK becomes STOP
while running), streamed result chips, imagery filters with a colour
legend, and the embedded viewer whose expanded mode is a focus-trapped
dialog. All wording lives in a pure presentation module.

Co-Authored-By: Claude Fable 5.1 <[email protected]>
This commit is contained in:
Said TurkseverandClaude Fable 5.1 committed 2026-09-23 15:44:32 +01:00
1 parent 791e77fa33
commit 3169d205d9
11 files changed
+1073 -1072

No files matched your search

+310 -400
View File
@@ -1,31 +1,17 @@
import { makeFloating } from './floatingWindow.js';
import { presentMapillaryPanel } from './mapillaryPresentation.js';
export { mapillaryImageUrl } from './mapillaryPresentation.js';
const DOCK_STORAGE_KEY = 'gev:mapillary-dock:collapsed';
const DOCK_MINIMIZED_KEY = 'gev:mapillary-dock:minimized';
const DOCK_WINDOW_KEY = 'gev:mapillary-dock:window:v1';
const RENDER_MODE_KEY = 'gev:mapillary:render-mode';
const MAPILLARY_APP_URL = 'https://www.mapillary.com/app/';
/** Deep link to an image on mapillary.com, as the web app shares them. */
export function mapillaryImageUrl(imageId) {
const id = String(imageId || '').trim();
if (!id) return MAPILLARY_APP_URL;
return `${MAPILLARY_APP_URL}?pKey=${encodeURIComponent(id)}&focus=photo`;
}
function formatDate(ms) {
if (!Number.isFinite(ms)) return '';
try {
return new Date(ms).toISOString().slice(0, 10);
} catch {
return '';
}
}
const FOCUSABLE =
'a[href], button:not([disabled]), input:not([disabled]), select:not([disabled]), [tabindex]:not([tabindex="-1"])';
/**
* Own the Mapillary dock: the AI query box, result chips, progress, the
* street-level viewer host and its controls. Receives the layer instance and
* application actions; never reaches into the layer's internals.
* Own the Street Level panel: the query box, result chips, progress, the
* imagery filters and the embedded MapillaryJS viewer. The panel itself is
* ordinary GEV chrome (collapse button, rail layout, persistence) driven by
* the application shell; this class only fills the body and asks the shell
* to open the panel when something worth seeing arrives.
*/
export class MapillaryControls {
constructor({ root, mapillary, actions }) {
@@ -36,52 +22,50 @@ export class MapillaryControls {
this.listeners = new AbortController();
this._unsubscribe = null;
this._state = null;
this._view = null;
this._wasEnabled = null;
this._wasStreetOpen = false;
this._lastStage = null;
this._wrapHome = null;
this._expandReturnFocus = null;
this._elements = this._collect();
this._bind();
this._restoreCollapsed();
this._restoreMinimized();
}
_collect() {
const byId = (id) => this.root?.querySelector(`#${id}`) || null;
return {
toggle: byId('mly-dock-toggle'),
body: byId('mly-body'),
statusChip: byId('mly-status-chip'),
status: byId('mly-status'),
keyless: byId('mly-keyless'),
keylessBtn: byId('mly-keyless-btn'),
controls: byId('mly-controls'),
enableBtn: byId('mly-enable-btn'),
minimizeBtn: byId('mly-minimize-btn'),
minimized: byId('mly-minimized'),
minimizedBadge: byId('mly-minimized-badge'),
lookBtn: byId('mly-look-btn'),
form: byId('mly-query-form'),
input: byId('mly-query-input'),
runBtn: byId('mly-query-run'),
hint: byId('mly-ai-hint'),
answer: byId('mly-answer'),
error: byId('mly-error'),
errorText: byId('mly-error-text'),
progress: byId('mly-progress'),
progressFill: byId('mly-progress-fill'),
progressLabel: byId('mly-progress-label'),
results: byId('mly-results'),
chips: byId('mly-result-chips'),
frameBtn: byId('mly-frame-btn'),
threeDBtn: byId('mly-3d-btn'),
threeDNote: byId('mly-3d-note'),
photorealBtn: byId('mly-photoreal-btn'),
sinceSelect: byId('mly-since'),
aiHint: byId('mly-ai-hint'),
aiModel: byId('mly-ai-model'),
clearBtn: byId('mly-clear-btn'),
lookBtn: byId('mly-look-btn'),
sinceSelect: byId('mly-since'),
legend: byId('mly-legend'),
followBtn: byId('mly-follow-btn'),
closeBtn: byId('mly-viewer-close'),
viewerWrap: byId('mly-viewer-wrap'),
viewerExpand: byId('mly-viewer-expand'),
viewerFit: byId('mly-viewer-fit'),
viewerClose: byId('mly-viewer-close'),
viewerPlaceholder: byId('mly-viewer-placeholder'),
viewer: byId('mly-viewer'),
imageBy: byId('mly-image-by'),
imageWhen: byId('mly-image-when'),
imageLink: byId('mly-image-link'),
header: this.root?.querySelector('.mly-header') || null,
viewer: byId('mly-viewer'),
imageMeta: byId('mly-image-meta'),
coverageMeta: byId('mly-coverage-meta'),
};
}
@@ -97,67 +81,17 @@ export class MapillaryControls {
const el = this._elements;
if (!this.root) return;
this.mapillary.attachViewerHost?.(el.viewer);
this.listen(el.toggle, 'click', () =>
this.setCollapsed(!this.root.classList.contains('collapsed')),
);
// Portable, resizable window: drag the header, resize from the grip.
this._floating = makeFloating(this.root, {
handle: el.header,
storageKey: DOCK_WINDOW_KEY,
dragThrough: '.mly-title-btn',
minWidth: 320,
minHeight: 220,
onChange: () => this.mapillary.resizeViewer?.(),
});
this.listen(el.viewerExpand, 'click', () =>
this.setViewerExpanded(
!this.root.classList.contains('mly-viewer-expanded'),
),
);
this.listen(document, 'keydown', (event) => {
if (
event.key === 'Escape' &&
this.root.classList.contains('mly-viewer-expanded')
)
this.setViewerExpanded(false);
});
this.listen(el.viewerFit, 'click', () => {
const next =
this._state?.street?.renderMode === 'fill' ? 'letterbox' : 'fill';
this.mapillary.setViewerRenderMode?.(next);
try {
localStorage.setItem(RENDER_MODE_KEY, next);
} catch {
/* storage unavailable */
}
});
try {
const stored = localStorage.getItem(RENDER_MODE_KEY);
if (stored === 'fill' || stored === 'letterbox')
this.mapillary.setViewerRenderMode?.(stored);
} catch {
/* storage unavailable */
}
// MapillaryJS only tracks window resizes; the dock resizes on its own
// (drag grip, expand, reflow), so watch the host element directly.
if (typeof ResizeObserver === 'function' && el.viewer) {
let queued = false;
this._resizeObserver = new ResizeObserver(() => {
if (queued) return;
queued = true;
requestAnimationFrame(() => {
queued = false;
this.mapillary.resizeViewer?.();
});
});
this._resizeObserver.observe(el.viewer);
}
this.listen(el.minimizeBtn, 'click', () => this.setMinimized(true));
this.listen(el.minimized, 'click', () => this.setMinimized(false));
this.listen(el.keylessBtn, 'click', () => this.actions.openKeySetup?.());
this.listen(el.enableBtn, 'click', () => this._toggleEnabled());
this.listen(el.lookBtn, 'click', async () => {
if (!(await this._ensureEnabled())) return;
this.mapillary.openNearest?.();
});
this.listen(el.form, 'submit', (event) => {
event.preventDefault();
this._run(el.input?.value);
if (this._view?.query.submitIsStop) this.mapillary.abortQuery?.();
else this._run(el.input?.value);
});
for (const button of this.root.querySelectorAll('[data-mly-suggestion]')) {
this.listen(button, 'click', () => {
@@ -167,19 +101,14 @@ export class MapillaryControls {
}
this.listen(el.frameBtn, 'click', () => this.mapillary.frameResults?.());
this.listen(el.clearBtn, 'click', () => this.mapillary.clearQuery?.());
this.listen(el.lookBtn, 'click', async () => {
if (!(await this._ensureEnabled())) return;
this.setCollapsed(false);
this.mapillary.openNearest?.();
});
this.listen(el.followBtn, 'click', () => {
const next = !(this._state?.street?.follow === true);
this.mapillary.setFollow?.(next);
});
this.listen(el.closeBtn, 'click', () => this.mapillary.closeViewer?.());
this.listen(el.threeDBtn, 'click', () => {
const next = !(this._state?.objects3d?.enabled === true);
this.mapillary.setObjects3d?.(next);
this.listen(el.chips, 'click', (event) => {
const more = event.target.closest?.('[data-mly-more]');
if (!more) return;
const expanded = el.chips.classList.toggle('is-expanded');
more.setAttribute('aria-expanded', String(expanded));
more.textContent = expanded
? 'FEWER'
: `+${more.dataset.mlyMore} CLASSES`;
});
for (const button of this.root.querySelectorAll('[data-mly-pano]')) {
this.listen(button, 'click', () =>
@@ -195,13 +124,53 @@ export class MapillaryControls {
sinceMs = Date.now() - Number(value) * 86_400_000;
this.mapillary.setCoverageFilter?.({ sinceMs });
});
this.listen(el.photorealBtn, 'click', async () => {
const result = await this.actions.setMapStack?.('photoreal');
if (result?.error) this.actions.showToast?.(result.error);
this.listen(el.followBtn, 'click', () => {
this.mapillary.setFollow?.(!(this._state?.street?.follow === true));
});
// Keep the app's keyboard shortcuts from firing while typing a query.
this.listen(el.input, 'keydown', (event) => event.stopPropagation());
this.listen(el.input, 'keyup', (event) => event.stopPropagation());
this.listen(el.viewerClose, 'click', () => this.mapillary.closeViewer?.());
this.listen(el.viewerExpand, 'click', () =>
this.setViewerExpanded(!this.isViewerExpanded()),
);
for (const button of this.root.querySelectorAll('[data-mly-render]')) {
this.listen(button, 'click', () => {
const mode = button.dataset.mlyRender;
this.mapillary.setViewerRenderMode?.(mode);
try {
localStorage.setItem(RENDER_MODE_KEY, mode);
} catch {
/* storage unavailable */
}
});
}
try {
const stored = localStorage.getItem(RENDER_MODE_KEY);
if (stored === 'fill' || stored === 'letterbox')
this.mapillary.setViewerRenderMode?.(stored);
} catch {
/* storage unavailable */
}
// The expanded viewer is a dialog: Esc closes it, Tab stays inside.
this.listen(el.viewerWrap, 'keydown', (event) => this._onDialogKey(event));
// Keep the app's keyboard shortcuts from firing while typing a query,
// but let Escape through so GEV's panel disclosure can collapse the panel.
const shield = (event) => {
if (event.key !== 'Escape') event.stopPropagation();
};
this.listen(el.input, 'keydown', shield);
this.listen(el.input, 'keyup', shield);
// MapillaryJS only tracks window resizes; the panel resizes on its own.
if (typeof ResizeObserver === 'function' && el.viewer) {
let queued = false;
this._resizeObserver = new ResizeObserver(() => {
if (queued) return;
queued = true;
requestAnimationFrame(() => {
queued = false;
this.mapillary.resizeViewer?.();
});
});
this._resizeObserver.observe(el.viewer);
}
}
async _ensureEnabled() {
@@ -224,14 +193,12 @@ export class MapillaryControls {
} catch (error) {
this.actions.showToast?.(error?.message || 'Street Level toggle failed');
}
if (!enabled) this.setCollapsed(false);
}
async _run(prompt) {
const text = String(prompt || '').trim();
if (!text) return;
if (!(await this._ensureEnabled())) return;
this.setCollapsed(false);
this.mapillary.runQuery?.(text);
}
@@ -245,92 +212,53 @@ export class MapillaryControls {
if (this.mapillary.getUIState) this.render(this.mapillary.getUIState());
}
_restoreCollapsed() {
// Open by default: the typed Mapillary AI box is the front door.
let collapsed = false;
try {
const stored = localStorage.getItem(DOCK_STORAGE_KEY);
if (stored === '1') collapsed = true;
} catch {
/* storage unavailable */
}
this.setCollapsed(collapsed, { persist: false });
}
_restoreMinimized() {
let minimized = false;
try {
minimized = localStorage.getItem(DOCK_MINIMIZED_KEY) === '1';
} catch {
/* storage unavailable */
}
this.setMinimized(minimized, { persist: false });
}
/**
* Shrink the whole panel to a round Mapillary logo, or bring it back.
* The logo carries the layer's on/off state and a result-count badge.
*/
setMinimized(minimized, { persist = true } = {}) {
if (!this.root) return;
const on = minimized === true;
if (on) this.setViewerExpanded(false);
this.root.classList.toggle('minimized', on);
if (this._elements.minimized) this._elements.minimized.hidden = !on;
this.root.setAttribute('aria-expanded', String(!on));
if (!on) {
this.setCollapsed(false, { persist });
/** Ask the shell to open (or close) the rail panel. */
setCollapsed(collapsed, options = {}) {
this.actions.setPanelCollapsed?.(collapsed, options);
if (!collapsed)
requestAnimationFrame(() => this.mapillary.resizeViewer?.());
}
if (persist) {
try {
localStorage.setItem(DOCK_MINIMIZED_KEY, on ? '1' : '0');
} catch {
/* storage unavailable */
}
}
this._renderMinimized(this._state);
}
isMinimized() {
return this.root?.classList.contains('minimized') === true;
}
_renderMinimized(state) {
const el = this._elements;
if (!el.minimized) return;
const enabled = state?.enabled === true;
el.minimized.classList.toggle('is-off', !enabled);
const total = state?.features?.total || 0;
if (el.minimizedBadge) {
el.minimizedBadge.hidden = !(enabled && total > 0);
el.minimizedBadge.textContent =
total >= 1000 ? `${Math.round(total / 1000)}k` : String(total);
}
el.minimized.title = enabled
? `Open Mapillary · Street Level on${total ? ` · ${total.toLocaleString()} results` : ''}`
: 'Open Mapillary';
isViewerExpanded() {
return (
this._elements.viewerWrap?.classList.contains(
'mly-viewer-wrap-expanded',
) === true
);
}
/** Grow the street-level viewer to most of the screen, or shrink it back. */
setViewerExpanded(expanded) {
if (!this.root) return;
const on = expanded === true;
const wrap = this._elements.viewerWrap;
if (on === this.root.classList.contains('mly-viewer-expanded')) return;
this.root.classList.toggle('mly-viewer-expanded', on);
if (wrap) {
if (on) {
// Lift the viewer out of the dock: the dock's backdrop-filter would
// otherwise pin a fixed-position child inside the panel.
this._wrapHome = { parent: wrap.parentNode, next: wrap.nextSibling };
document.body.appendChild(wrap);
wrap.classList.add('mly-viewer-wrap-expanded');
} else if (this._wrapHome?.parent) {
wrap.classList.remove('mly-viewer-wrap-expanded');
if (!wrap) return;
const on = expanded === true;
if (on === this.isViewerExpanded()) return;
if (on) {
// Lift the viewer out of the panel: the panel's backdrop-filter would
// otherwise pin a fixed-position child inside it.
this._wrapHome = { parent: wrap.parentNode, next: wrap.nextSibling };
this._expandReturnFocus = document.activeElement;
document.body.appendChild(wrap);
wrap.classList.add('mly-viewer-wrap-expanded');
wrap.setAttribute('role', 'dialog');
wrap.setAttribute('aria-modal', 'true');
wrap.setAttribute('aria-label', 'Street-level image');
wrap.tabIndex = -1;
wrap.focus({ preventScroll: true });
} else {
wrap.classList.remove('mly-viewer-wrap-expanded');
wrap.removeAttribute('role');
wrap.removeAttribute('aria-modal');
wrap.removeAttribute('aria-label');
wrap.removeAttribute('tabindex');
if (this._wrapHome?.parent)
this._wrapHome.parent.insertBefore(wrap, this._wrapHome.next);
this._wrapHome = null;
}
this._wrapHome = null;
const target = this._expandReturnFocus;
this._expandReturnFocus = null;
if (target?.isConnected && typeof target.focus === 'function')
target.focus({ preventScroll: true });
else this._elements.viewerExpand?.focus?.({ preventScroll: true });
}
const button = this._elements.viewerExpand;
if (button) {
@@ -344,230 +272,213 @@ export class MapillaryControls {
requestAnimationFrame(() => this.mapillary.resizeViewer?.());
}
setCollapsed(collapsed, { persist = true } = {}) {
if (!this.root) return;
this.root.classList.toggle('collapsed', collapsed);
this._elements.toggle?.setAttribute('aria-expanded', String(!collapsed));
this._elements.toggle?.setAttribute(
'title',
collapsed ? 'Expand Mapillary' : 'Collapse Mapillary',
_onDialogKey(event) {
if (!this.isViewerExpanded()) return;
if (event.key === 'Escape') {
event.preventDefault();
event.stopPropagation();
this.setViewerExpanded(false);
return;
}
if (event.key !== 'Tab') return;
const wrap = this._elements.viewerWrap;
const focusable = [...wrap.querySelectorAll(FOCUSABLE)].filter(
(node) => node.offsetParent !== null || node === document.activeElement,
);
if (!collapsed) this.mapillary.resizeViewer?.();
if (persist) {
try {
localStorage.setItem(DOCK_STORAGE_KEY, collapsed ? '1' : '0');
} catch {
/* storage unavailable */
}
if (!focusable.length) return;
const first = focusable[0];
const last = focusable[focusable.length - 1];
if (event.shiftKey && document.activeElement === first) {
event.preventDefault();
last.focus();
} else if (!event.shiftKey && document.activeElement === last) {
event.preventDefault();
first.focus();
} else if (!wrap.contains(document.activeElement)) {
event.preventDefault();
first.focus();
}
}
render(state) {
if (this.destroyed || !state || !this.root) return;
this._state = state;
const view = presentMapillaryPanel(state);
this._view = view;
this._renderHeader(view);
this._renderEmptyState(view);
this._renderQuery(view);
this._renderResults(view);
this._renderFilters(view);
this._renderViewer(view, state);
this._renderMeta(view);
this._reactToTransitions(view, state);
}
_renderHeader(view) {
const el = this._elements;
const enabled = state.enabled === true;
el.enableBtn.textContent = enabled ? 'STREET LEVEL ON' : 'STREET LEVEL OFF';
el.enableBtn.setAttribute('aria-pressed', String(enabled));
let chip = enabled ? 'ON' : 'OFF';
let chipClass = enabled ? 'is-on' : '';
if (state.keyRequired) {
chip = 'KEY REQUIRED';
chipClass = 'is-warn';
} else if (state.query.busy) {
chip = `AI · ${state.query.stage.toUpperCase()}`;
chipClass = 'is-busy';
} else if (state.coverage.loading || state.features.loading) {
chip = 'LOADING';
chipClass = 'is-busy';
this.root.dataset.mlyEnabled = String(view.enabled);
if (el.status) {
el.status.textContent = view.status.text;
el.status.className = `mly-status${view.status.tone ? ` is-${view.status.tone}` : ''}`;
}
el.statusChip.textContent = chip;
el.statusChip.className = `mly-chip ${chipClass}`.trim();
if (enabled && this._wasEnabled === false) this.setCollapsed(false);
this._wasEnabled = enabled;
this._renderMinimized(state);
// Imagery needs the panel: opening an image brings a minimized dock back.
if (state.street.open && !this._wasStreetOpen && this.isMinimized())
this.setMinimized(false);
this._wasStreetOpen = state.street.open === true;
el.runBtn.disabled = state.query.busy;
el.runBtn.textContent = state.query.busy ? '…' : 'ASK';
el.input.disabled = false;
el.input.placeholder = state.planner
? 'Type a question, e.g. show me all fire hydrants in Sacramento'
: 'Add an Anthropic key in POWER UP to enable Mapillary AI';
if (el.aiModel)
el.aiModel.textContent = state.plannerModel
? `· ${state.plannerModel}`
: '';
if (el.aiHint) {
el.aiHint.classList.toggle('is-warn', !state.planner);
el.aiHint.textContent = state.planner
? 'Type what you want to see in plain English — objects, traffic signs, coverage or a street view of any place — and press Enter. Follow-ups refine the last answer.'
: 'Mapillary AI is off until an Anthropic key is added in POWER UP. Coverage, sequences and the viewer work without it.';
if (el.enableBtn) {
el.enableBtn.textContent = view.enableButton.text;
el.enableBtn.setAttribute(
'aria-pressed',
String(view.enableButton.pressed),
);
}
}
// Imagery filters.
const filter = state.coverage.filter || { pano: 'all', sinceMs: null };
_renderEmptyState(view) {
const el = this._elements;
if (el.keyless) el.keyless.hidden = !view.keyless.visible;
if (el.controls) el.controls.disabled = view.controlsDisabled;
}
_renderQuery(view) {
const el = this._elements;
const { query } = view;
if (el.input) {
el.input.placeholder = query.placeholder;
el.input.disabled = query.inputDisabled;
}
if (el.runBtn) {
el.runBtn.textContent = query.submitLabel;
el.runBtn.classList.toggle('is-stop', query.submitIsStop);
el.runBtn.disabled = query.inputDisabled && !query.submitIsStop;
el.runBtn.setAttribute(
'aria-label',
query.submitIsStop ? 'Stop the query' : 'Ask',
);
}
for (const button of this.root.querySelectorAll('[data-mly-suggestion]'))
button.disabled = query.suggestionsDisabled;
if (el.hint) {
el.hint.textContent = query.hint;
el.hint.classList.toggle('is-warn', query.hintWarn);
}
if (el.answer) el.answer.textContent = view.answer;
if (el.error) {
el.error.hidden = !view.error;
if (el.errorText) el.errorText.textContent = view.error || '';
}
if (el.progress) {
el.progress.hidden = !view.progress.visible;
el.progress.classList.toggle(
'is-indeterminate',
view.progress.indeterminate,
);
if (el.progressFill && !view.progress.indeterminate)
el.progressFill.style.width = `${view.progress.percent}%`;
if (el.progressFill && view.progress.indeterminate)
el.progressFill.style.removeProperty('width');
if (el.progressLabel) el.progressLabel.textContent = view.progress.label;
}
}
_renderResults(view) {
const el = this._elements;
if (!el.results) return;
el.results.hidden = !view.results.visible;
if (!view.results.visible || !el.chips) return;
const expanded = el.chips.classList.contains('is-expanded');
const chip = (entry, overflow) => {
const node = document.createElement('span');
node.className = `mly-value-chip${overflow ? ' is-overflow' : ''}`;
node.title = entry.value;
const dot = document.createElement('i');
dot.style.background = entry.color;
const text = document.createElement('span');
text.textContent = entry.label;
const num = document.createElement('b');
num.textContent = entry.count;
node.append(dot, text, num);
return node;
};
const nodes = view.results.all.map((entry, index) =>
chip(entry, index >= view.results.chips.length),
);
if (view.results.more) {
const more = document.createElement('button');
more.type = 'button';
more.className = 'mly-value-chip';
more.dataset.mlyMore = String(view.results.more.count);
more.title = view.results.more.title;
more.setAttribute('aria-expanded', String(expanded));
more.textContent = expanded
? 'FEWER'
: `+${view.results.more.count} CLASSES`;
nodes.push(more);
} else el.chips.classList.remove('is-expanded');
el.chips.replaceChildren(...nodes);
}
_renderFilters(view) {
const el = this._elements;
for (const button of this.root.querySelectorAll('[data-mly-pano]')) {
const active = button.dataset.mlyPano === filter.pano;
const active = button.dataset.mlyPano === view.filter.pano;
button.classList.toggle('is-active', active);
button.setAttribute('aria-checked', String(active));
}
// 3D objects.
const objects = state.objects3d || {};
el.threeDBtn.setAttribute('aria-pressed', String(objects.enabled === true));
el.threeDBtn.textContent = objects.building
? '3D OBJECTS …'
: objects.enabled
? '3D OBJECTS ON'
: '3D OBJECTS OFF';
el.threeDNote.hidden = !(
objects.enabled &&
(objects.error || objects.active)
);
el.threeDNote.textContent = objects.error
? objects.error
: objects.active
? `${objects.count.toLocaleString()} objects standing in 3D · click one to open its image`
: '';
el.photorealBtn.setAttribute(
'aria-pressed',
String(this.actions.isMapStackActive?.('photoreal') === true),
);
// Answer / error line.
const error = state.query.error || state.street.error;
if (error) {
el.answer.textContent = error;
el.answer.classList.add('is-error');
} else {
el.answer.classList.remove('is-error');
if (state.query.answer) el.answer.textContent = state.query.answer;
else if (state.query.busy) el.answer.textContent = 'Planning…';
else if (!enabled)
el.answer.textContent =
'Turn on Street Level to see Mapillary coverage, then ask for anything that appears in street imagery.';
else if (state.coverage.hint) el.answer.textContent = state.coverage.hint;
else
el.answer.textContent =
'Click a green sequence to see its images, or ask Mapillary AI for objects and signs.';
}
// Progress bar while tiles stream.
const { progress } = state.features;
const showProgress = state.features.loading && progress.tiles > 0;
el.progress.hidden = !showProgress;
if (showProgress) {
const pct = Math.round((progress.done / progress.tiles) * 100);
el.progressFill.style.width = `${pct}%`;
el.progressLabel.textContent = `${progress.done}/${progress.tiles} tiles · ${state.features.total.toLocaleString()} found`;
}
// Result chips.
const hasResults = state.features.total > 0 || state.features.hasBbox;
el.results.hidden = !hasResults;
if (hasResults) {
el.chips.replaceChildren(
...state.features.counts
.slice(0, 8)
.map(({ value, count, label, color }) => {
const chipEl = document.createElement('span');
chipEl.className = 'mly-value-chip';
chipEl.title = value;
const dot = document.createElement('i');
dot.style.background = color;
const text = document.createElement('span');
text.textContent = label;
const num = document.createElement('b');
num.textContent = count.toLocaleString();
chipEl.append(dot, text, num);
return chipEl;
}),
if (el.legend && el.legend.childElementCount !== view.legend.length) {
el.legend.replaceChildren(
...view.legend.map((entry) => {
const item = document.createElement('li');
const swatch = document.createElement('i');
swatch.className = 'mly-legend-swatch';
swatch.style.background = entry.color;
const label = document.createElement('span');
label.textContent = entry.label;
item.append(swatch, label);
return item;
}),
);
if (state.features.counts.length > 8) {
const more = document.createElement('span');
more.className = 'mly-value-chip';
more.textContent = `+${state.features.counts.length - 8} classes`;
el.chips.append(more);
}
}
}
// Street-level viewer.
const { street } = state;
el.viewerWrap.hidden = !street.open;
this.root.classList.toggle('mly-has-viewer', street.open === true);
if (!street.open && this.root.classList.contains('mly-viewer-expanded'))
this.setViewerExpanded(false);
el.followBtn.setAttribute('aria-pressed', String(street.follow === true));
el.followBtn.textContent = street.follow
? 'STREET COCKPIT ON'
: 'STREET COCKPIT OFF';
el.followBtn.disabled = !street.open;
if (el.viewerFit) {
const fill = street.renderMode === 'fill';
el.viewerFit.textContent = fill ? 'FILL' : 'FIT';
el.viewerFit.title = fill
? 'Filling the frame (cropped) · click to show the whole image'
: 'Showing the whole image · click to fill the frame';
_renderViewer(view, state) {
const el = this._elements;
const { viewer } = view;
if (el.viewerWrap) el.viewerWrap.hidden = !viewer.open;
if (!viewer.open && this.isViewerExpanded()) this.setViewerExpanded(false);
if (el.viewerPlaceholder) el.viewerPlaceholder.hidden = !viewer.loading;
if (el.followBtn) {
el.followBtn.setAttribute('aria-pressed', String(viewer.follow.pressed));
el.followBtn.disabled = viewer.follow.disabled;
}
if (street.open) {
// Caption bar as on mapillary.com: "Image by …" left, date right.
const left = [];
if (street.loading) left.push('LOADING…');
if (street.feature?.label)
left.push(
`${street.feature.label}${street.feature.imageCount ? ` · ${street.feature.imageCount} sightings` : ''}`,
);
if (street.highlight?.count)
left.push(
`${street.highlight.count} detection${street.highlight.count === 1 ? '' : 's'} outlined`,
);
if (street.creator) left.push(`Image by ${street.creator}`);
const right = [];
if (street.isPano) right.push('360°');
if (Number.isFinite(street.bearing))
right.push(`${Math.round(street.bearing)}°`);
if (street.capturedAt) right.push(formatDate(street.capturedAt));
if (el.imageBy) el.imageBy.textContent = left.join(' · ');
if (el.imageWhen) el.imageWhen.textContent = right.join(' · ');
if (el.imageLink) {
el.imageLink.href = mapillaryImageUrl(street.imageId);
el.imageLink.hidden = !street.imageId;
}
this.mapillary.resizeViewer?.();
for (const button of this.root.querySelectorAll('[data-mly-render]')) {
const active = button.dataset.mlyRender === viewer.renderMode;
button.classList.toggle('is-active', active);
button.setAttribute('aria-checked', String(active));
}
if (!viewer.open) return;
if (el.imageBy) el.imageBy.textContent = viewer.captionLeft;
if (el.imageWhen) el.imageWhen.textContent = viewer.captionRight;
if (el.imageLink) {
el.imageLink.hidden = !viewer.link;
if (viewer.link) el.imageLink.href = viewer.link;
}
if (state.street.open) this.mapillary.resizeViewer?.();
}
// Coverage meta line.
const coverageBits = [];
if (enabled && state.coverage.zoom)
coverageBits.push(
`coverage z${state.coverage.zoom} · ${state.coverage.sequences.toLocaleString()} sequences`,
);
if (state.sequence.selectedId)
coverageBits.push(
state.sequence.loading
? 'loading sequence…'
: `${state.sequence.images} images in sequence · Esc clears`,
);
if (state.query.usage?.model)
coverageBits.push(
`${state.query.usage.model} · ${state.query.usage.input_tokens ?? '?'}→${state.query.usage.output_tokens ?? '?'} tok`,
);
el.coverageMeta.textContent = coverageBits.join(' · ');
_renderMeta(view) {
const el = this._elements;
if (el.coverageMeta) el.coverageMeta.textContent = view.meta;
}
/** Open the panel at the moments a user would look for it. */
_reactToTransitions(view, state) {
const enabled = view.enabled;
if (enabled && this._wasEnabled === false) this.setCollapsed(false);
this._wasEnabled = enabled;
if (state.street.open && !this._wasStreetOpen) this.setCollapsed(false);
this._wasStreetOpen = state.street.open === true;
if (state.query.stage !== this._lastStage) {
this._lastStage = state.query.stage;
if (state.query.stage === 'done' || state.query.stage === 'error') {
if (state.query.stage === 'done' || state.query.stage === 'error')
this.setCollapsed(false);
if (this.isMinimized()) this.setMinimized(false);
}
}
}
@@ -578,7 +489,6 @@ export class MapillaryControls {
this.listeners.abort();
this._resizeObserver?.disconnect();
this._resizeObserver = null;
this._floating?.destroy();
this._unsubscribe?.();
this._unsubscribe = null;
this.mapillary.attachViewerHost?.(null);