mirror of
https://github.com/bilawalsidhu/gods-eye-view.git
synced 2026-11-16 16:22:20 +00:00
The points-of-interest keys (Q/W/E/R/T while a city is expanded) are a second bare-key document listener, and it did not look at modifiers either: Alt+R or a delivered Ctrl+R picked the fourth POI and flew the camera there. It now leaves Cmd, Ctrl and Alt chords to the browser like the application shortcuts; Shift still counts as the key. The docs and the changelog entry say so.
281 lines
8.7 KiB
JavaScript
281 lines
8.7 KiB
JavaScript
import { locationMiniStatus } from '../locationStatus.js';
|
|
import { onLocaleChange, t } from '../i18n/index.js';
|
|
import { localizePlaceName } from './placeNames.js';
|
|
|
|
const POI_KEYS = ['Q', 'W', 'E', 'R', 'T'];
|
|
|
|
/**
|
|
* locationStatus.js placeholder lines, built by the module itself; renderStatus
|
|
* swaps them for translated text. Place names are shown as they are.
|
|
*/
|
|
const LOCATION_MINI_EMPTY = Object.freeze(locationMiniStatus());
|
|
const LOCATION_MINI_SEARCHED_PLACEHOLDER = Object.freeze(
|
|
locationMiniStatus({ searchedLabel: '·' }),
|
|
);
|
|
|
|
/**
|
|
* The location tray's presentation, keyboard handling and pending row
|
|
* animation over supplied actions. The city pills, the landmark row, the
|
|
* mini status, the search error and the ORBIT indicator are presented as a
|
|
* plain view and handed to `publish`; Core's dock renders them and calls
|
|
* `chooseCity()` and `choosePoi()`, and the scene chrome shows the indicator.
|
|
* The globe actions and the cockpit call `reset()`. The search field's open
|
|
* and searching state is presented too, and the dock's toggle calls
|
|
* `toggleSearch()`; the field keeps its own key, input and blur listeners.
|
|
*/
|
|
export class LocationControls {
|
|
constructor({
|
|
elements,
|
|
cities,
|
|
getExpandedCity,
|
|
onCity,
|
|
onPoi,
|
|
onSearch,
|
|
onSearchEdit,
|
|
onReset,
|
|
searchExpanded = false,
|
|
publish = () => {},
|
|
doc = document,
|
|
requestFrame = (callback) => requestAnimationFrame(callback),
|
|
cancelFrame = (id) => cancelAnimationFrame(id),
|
|
}) {
|
|
Object.assign(this, {
|
|
elements,
|
|
cities,
|
|
getExpandedCity,
|
|
onCity,
|
|
onPoi,
|
|
onSearch,
|
|
onReset,
|
|
publish,
|
|
doc,
|
|
requestFrame,
|
|
cancelFrame,
|
|
});
|
|
this.removers = [];
|
|
this.frame = null;
|
|
this.destroyed = false;
|
|
// City names and the status lines are translated here; show them again
|
|
// in a new locale.
|
|
this.removers.push(
|
|
onLocaleChange(() => {
|
|
if (this._statusRecord !== undefined)
|
|
this.renderStatus(this._statusRecord);
|
|
else this.present();
|
|
}),
|
|
);
|
|
this.rowGeneration = 0;
|
|
this.activeCity = null;
|
|
this.poiCity = null;
|
|
this.activePoi = null;
|
|
this.poisExpanded = false;
|
|
this.status = {
|
|
city: t('📍 Location: --'),
|
|
poi: t('Landmark: --'),
|
|
};
|
|
this.searchError = null;
|
|
// The search field: whether it is open, and whether a lookup runs.
|
|
this.searchExpanded = Boolean(searchExpanded);
|
|
this.searching = false;
|
|
// The ORBIT indicator: null until the shell offers it, then whether the
|
|
// camera orbits.
|
|
this.orbit = null;
|
|
this.bind(doc, 'keydown', (event) => {
|
|
const cityId = getExpandedCity();
|
|
if (
|
|
!cityId ||
|
|
event.target?.matches?.('select, input, textarea') ||
|
|
event.target === elements.search
|
|
)
|
|
return;
|
|
// As for the application shortcuts: Cmd+R, Ctrl+W, Alt+E and the like
|
|
// belong to the browser and the system. Shift is not a chord.
|
|
if (event.metaKey || event.ctrlKey || event.altKey) return;
|
|
const index = POI_KEYS.indexOf(event.key.toUpperCase());
|
|
if (index !== -1 && index < (cities[cityId]?.pois.length || 0))
|
|
onPoi(cityId, index);
|
|
});
|
|
this.bind(elements.search, 'keydown', (event) => {
|
|
if (event.key === 'Enter') void onSearch(elements.search.value);
|
|
});
|
|
// Typing corrects a failed query; closing the field (which empties it) drops its error.
|
|
this.bind(elements.search, 'input', () => onSearchEdit?.());
|
|
this.bind(elements.search, 'blur', () => {
|
|
if (!elements.search.value) onSearchEdit?.();
|
|
});
|
|
this.present();
|
|
}
|
|
bind(element, event, handler, removers = this.removers) {
|
|
if (!element) return;
|
|
const listener = (...args) => {
|
|
if (!this.destroyed) return handler(...args);
|
|
};
|
|
element.addEventListener(event, listener);
|
|
removers.push(() => element.removeEventListener(event, listener));
|
|
}
|
|
/** Publish the tray as it stands. */
|
|
present() {
|
|
if (!this.destroyed) this.publish(this.presentation());
|
|
}
|
|
/** The tray as it stands. */
|
|
presentation() {
|
|
const pois = this.cities[this.poiCity]?.pois || [];
|
|
return {
|
|
cities: Object.entries(this.cities).map(([id, city]) => ({
|
|
id,
|
|
label: localizePlaceName(city.name),
|
|
active: id === this.activeCity,
|
|
})),
|
|
poiCity: this.poiCity,
|
|
pois: pois.map((poi, index) => ({
|
|
index,
|
|
key: String(POI_KEYS[index] || index + 1),
|
|
name: String(poi.name ?? ''),
|
|
active: index === this.activePoi,
|
|
})),
|
|
poisExpanded: this.poisExpanded,
|
|
status: { ...this.status },
|
|
searchError: this.searchError,
|
|
searchExpanded: this.searchExpanded,
|
|
searching: this.searching,
|
|
orbit: this.orbit && { ...this.orbit },
|
|
};
|
|
}
|
|
/** A city pill was clicked. */
|
|
chooseCity(id) {
|
|
if (!this.destroyed) this.onCity(id);
|
|
}
|
|
/** A reset to the full globe view was asked for. */
|
|
reset() {
|
|
if (!this.destroyed) return this.onReset();
|
|
}
|
|
/** A landmark pill of the shown city was clicked. */
|
|
choosePoi(index) {
|
|
if (!this.destroyed && this.poiCity !== null)
|
|
this.onPoi(this.poiCity, index);
|
|
}
|
|
cancelExpansion() {
|
|
this.rowGeneration++;
|
|
if (this.frame !== null) this.cancelFrame(this.frame);
|
|
this.frame = null;
|
|
}
|
|
showPois(cityId) {
|
|
if (this.destroyed) return;
|
|
const city = this.cities[cityId];
|
|
if (!city) return;
|
|
this.cancelExpansion();
|
|
const generation = this.rowGeneration;
|
|
this.poiCity = cityId;
|
|
this.activePoi = null;
|
|
this.present();
|
|
// The row expands a frame after its pills render, so the transition runs.
|
|
this.frame = this.requestFrame(() => {
|
|
if (this.destroyed || generation !== this.rowGeneration) return;
|
|
this.frame = null;
|
|
this.poisExpanded = true;
|
|
this.present();
|
|
});
|
|
}
|
|
hidePois() {
|
|
if (this.destroyed) return;
|
|
this.cancelExpansion();
|
|
this.poisExpanded = false;
|
|
this.present();
|
|
}
|
|
highlightPoi(index) {
|
|
if (this.destroyed) return;
|
|
this.activePoi = index;
|
|
this.present();
|
|
}
|
|
highlightCity(id) {
|
|
if (this.destroyed) return;
|
|
this.activeCity = id;
|
|
this.present();
|
|
}
|
|
renderStatus(record) {
|
|
if (this.destroyed) return;
|
|
this._statusRecord = record;
|
|
// A preset city shows its name in the UI language; the record stays English.
|
|
const state = record?.city?.name
|
|
? {
|
|
...record,
|
|
city: { ...record.city, name: localizePlaceName(record.city.name) },
|
|
}
|
|
: record;
|
|
const lines = locationMiniStatus(state);
|
|
this.status = {
|
|
city:
|
|
lines.city === LOCATION_MINI_EMPTY.city
|
|
? t('📍 Location: --')
|
|
: lines.city,
|
|
poi:
|
|
lines.poi === LOCATION_MINI_EMPTY.poi
|
|
? t('Landmark: --')
|
|
: lines.poi === LOCATION_MINI_SEARCHED_PLACEHOLDER.poi
|
|
? t('Searched location')
|
|
: lines.poi,
|
|
};
|
|
this.present();
|
|
}
|
|
/** Show, or with null clear, the announced error under the search field. */
|
|
setSearchError(message) {
|
|
if (this.destroyed) return;
|
|
this.searchError = message || null;
|
|
this.present();
|
|
}
|
|
/** The search toggle was clicked: open the field and focus it, or close it. */
|
|
toggleSearch() {
|
|
if (this.destroyed) return;
|
|
this.searchExpanded = !this.searchExpanded;
|
|
this.present();
|
|
if (this.searchExpanded) this.elements.search?.focus();
|
|
}
|
|
/** Mark the search field while a lookup runs. */
|
|
setSearching(active) {
|
|
if (this.destroyed) return;
|
|
this.searching = Boolean(active);
|
|
this.present();
|
|
}
|
|
/**
|
|
* A lookup settled. One that found nothing keeps its query, the open field
|
|
* and focus so it can be corrected; any other clears and closes the field.
|
|
*/
|
|
settleSearch({ keepQuery = false } = {}) {
|
|
if (this.destroyed) return;
|
|
this.searching = false;
|
|
if (!keepQuery) {
|
|
this.closeSearch();
|
|
return;
|
|
}
|
|
this.present();
|
|
this.elements.search?.focus();
|
|
this.elements.search?.select?.();
|
|
}
|
|
/** Close the search field and drop its query. */
|
|
closeSearch() {
|
|
if (this.destroyed) return;
|
|
this.searchExpanded = false;
|
|
this.present();
|
|
const field = this.elements.search;
|
|
if (field) field.value = '';
|
|
field?.blur?.();
|
|
}
|
|
/** Offer the ORBIT indicator, lit while the camera orbits. */
|
|
showOrbit(active = false) {
|
|
if (this.destroyed) return;
|
|
this.orbit = { active: Boolean(active) };
|
|
this.present();
|
|
}
|
|
destroy() {
|
|
if (this.destroyed) return;
|
|
this.destroyed = true;
|
|
this.cancelExpansion();
|
|
for (const remove of this.removers.splice(0)) remove();
|
|
// The ORBIT indicator leaves with its owner.
|
|
if (this.orbit) {
|
|
this.orbit = null;
|
|
this.publish(this.presentation());
|
|
}
|
|
}
|
|
}
|