Files
gods-eye-view/src/ui/stores/streetLevel.js
T
Said Turksever 7703090d90 fix(street-level): retire lookups and preserve embedded photos
Clear cancelled lookup loading over an existing photo, release caller abort listeners on internal retirement, surface embedded errors, and permit embedded photos over the clean globe. Add seven regression cases and update runtime documentation. Preserve the published localization and other review fixes.
2026-11-03 15:40:46 +00:00

90 lines
2.5 KiB
JavaScript

import { defineStore } from 'pinia';
import { markRaw, shallowRef } from 'vue';
/**
* @typedef {object} StreetLevelHandlers
* @property {(stop: number) => void} setSinceStop Record a SINCE stop.
* @property {(stop: number) => string} describeSinceStop A stop's readout.
*/
/**
* The Street Level panel as its view renders it. StreetLevelControls owns
* the presentation (`presentStreetLevelPanel()`), the viewer and EXPAND: it
* publishes here and attaches the actions the view forwards.
*/
export const useStreetLevelStore = defineStore('gev-street-level', () => {
/** The presented panel; null until an owner renders, then its last render. */
const view = shallowRef(null);
/** Whether EXPAND has the viewer full screen; null until first synced. */
const expanded = shallowRef(null);
/** False on a page with neither element fullscreen nor popovers. */
const expandAvailable = shallowRef(true);
/** Whether the photo is shown over the globe on an embedded page. */
const embedOverlay = shallowRef(false);
/** @type {{handlers: StreetLevelHandlers}|null} */
let owner = null;
/**
* Present the panel for an owner, replacing any earlier owner.
* @param {StreetLevelHandlers} handlers
* @returns {object} Token for detach().
*/
function attach(handlers) {
owner = { handlers };
return owner;
}
/** @param {object} next A fresh presentation; every publish re-renders. */
function publish(next) {
view.value = markRaw(next);
}
/** @param {boolean} on */
function setExpanded(on) {
expanded.value = Boolean(on);
}
/** @param {boolean} available */
function setExpandAvailable(available) {
expandAvailable.value = Boolean(available);
}
/** @param {boolean} on */
function setEmbedOverlay(on) {
embedOverlay.value = Boolean(on);
}
/**
* Stop forwarding actions to the owner holding `token`. The panel keeps
* its last render, as the page did when its controls were wired by hand.
*/
function detach(token) {
if (owner === token) owner = null;
}
/** Forward a view action to the owner. */
function act(name, ...args) {
owner?.handlers[name]?.(...args);
}
/** The readout of a SINCE stop while its thumb is dragged. */
function describeSinceStop(stop) {
return owner?.handlers.describeSinceStop?.(stop) ?? '';
}
return {
view,
expanded,
expandAvailable,
embedOverlay,
attach,
publish,
setExpanded,
setExpandAvailable,
setEmbedOverlay,
detach,
act,
describeSinceStop,
};
});