mirror of
https://github.com/bilawalsidhu/gods-eye-view.git
synced 2026-11-05 02:44:02 +00:00
Sameh Khamis
51e32a30f2
A failure now ends when its city leaves range or the camera rises above the activation gate, so an empty map no longer reads LOAD FAILED. Late activation and status rejections are ignored like late successes. Partial failure reads DEGRADED, every in-range city failing over cached points reads STALE, and freshness advances only on a refresh that succeeded. Behavioural tests drive the real proximity, update and enable paths. Docs say no licence is published for Toronto and list Social Bicycles and PBSC. The merge also restored the #61 GBFS v3 changelog entry that an earlier merge on main dropped.
119 lines
3.7 KiB
JavaScript
119 lines
3.7 KiB
JavaScript
export function createState({ services }) {
|
|
const { setOverlayEntries, setOverlaySourceVisible, clearOverlaySource } =
|
|
services.overlays;
|
|
const layerState = {};
|
|
|
|
layerState.DEFAULT_OVERLAY_HOST = Object.freeze({
|
|
setEntries: setOverlayEntries,
|
|
setVisible: setOverlaySourceVisible,
|
|
clearSource: clearOverlaySource,
|
|
});
|
|
|
|
layerState._overlayHost = layerState.DEFAULT_OVERLAY_HOST;
|
|
|
|
// ---------------------------------------------------------------------------
|
|
// Module-level mutable state
|
|
// ---------------------------------------------------------------------------
|
|
|
|
/** @type {Cesium.Viewer|null} Active Cesium viewer instance. */
|
|
|
|
layerState._viewer = null;
|
|
|
|
/** @type {Cesium.PointPrimitiveCollection|null} Primitive collection for station dots. */
|
|
|
|
layerState._pointCollection = null;
|
|
|
|
/** Whether the bikeshare layer is currently enabled. */
|
|
|
|
layerState._enabled = false;
|
|
|
|
/** Timer handle for camera-move debounce. */
|
|
|
|
layerState._cameraDebounceTimer = null;
|
|
|
|
/** Whether the camera.changed listener is currently attached. */
|
|
|
|
layerState._cameraChangedAttached = false;
|
|
|
|
/** Hysteresis flag for altitude-based activation. */
|
|
|
|
layerState._altitudeGateEnabled = false;
|
|
|
|
/** Monotonic generation counter; incremented on each proximity check to cancel stale work. */
|
|
|
|
layerState._proximityGeneration = 0;
|
|
|
|
/** @type {Set<string>} City ids currently considered in-range. */
|
|
|
|
layerState._activeCityIds = new Set();
|
|
|
|
/** @type {Map<string, { stationKeys: Set<string> }>} Per-city runtime tracking of rendered station keys. */
|
|
|
|
layerState._cityRuntime = new Map();
|
|
|
|
/** @type {Map<string, Map<string, Object>>} Cached station information per city (cityId -> stationId -> StationInfo). */
|
|
|
|
layerState._stationInfoCache = new Map();
|
|
|
|
/** @type {Map<string, { timestamp: number, statusMap: Map<string, Object> }>} Cached station status per city. */
|
|
|
|
layerState._statusCache = new Map();
|
|
|
|
/** @type {Map<string, { promise: Promise, controller: AbortController, generation: number }>} In-flight station info requests. */
|
|
|
|
layerState._inFlightInfo = new Map();
|
|
|
|
/** @type {Map<string, { promise: Promise, controller: AbortController, generation: number }>} In-flight station status requests. */
|
|
|
|
layerState._inFlightStatus = new Map();
|
|
|
|
/** @type {Map<string, Object>} Render records keyed by "cityId:stationId". */
|
|
|
|
layerState._stationRenderMap = new Map();
|
|
|
|
/** @type {Cesium.ScreenSpaceEventHandler|null} Click handler for station selection. */
|
|
|
|
layerState._clickHandler = null;
|
|
|
|
/** @type {string|null} Key of the currently selected station, or null. */
|
|
|
|
layerState._selectedKey = null;
|
|
|
|
/** @type {Cesium.Entity|null} Entity used to display the selected-station point highlight. */
|
|
|
|
layerState._selectedEntity = null;
|
|
|
|
/** Total number of currently rendered station points. */
|
|
|
|
layerState._count = 0;
|
|
|
|
/** Timestamp (ms) of the last successful status update. */
|
|
|
|
layerState._lastUpdate = null;
|
|
|
|
/** Whether any GBFS fetch is currently in progress. */
|
|
|
|
layerState._loading = false;
|
|
|
|
/** Reference count of concurrent loading operations. */
|
|
|
|
layerState._loadingOps = 0;
|
|
|
|
/**
|
|
* @type {Set<string>} City ids whose most recent fetch failed.
|
|
*
|
|
* Per city rather than one layer-wide flag: feeds are fetched independently,
|
|
* so a retired operator must not mark a layer that other cities are still
|
|
* populating as failed. Entries are dropped when their city leaves range.
|
|
* The layer reports failure only when these cost it everything it had to
|
|
* draw, and degraded otherwise — see `getStats()` in controls.js.
|
|
*/
|
|
|
|
layerState._failedCityIds = new Set();
|
|
|
|
/** Whether the MAX_TOTAL_POINTS cap warning has already been logged. */
|
|
|
|
layerState._limitWarned = false;
|
|
return layerState;
|
|
}
|