Files
gods-eye-view/src/ui/stores/owners.js
T
Sameh Khamis eccaeea0c4 feat(globe): render the tilt and north-up buttons from the globe actions store
The camera orientation controls publish whether the map is tilted and the
camera's whole-degree heading instead of writing the buttons' attributes,
and answer tilt and north-up through the globe actions store. The new
GlobeCompass renders the heading, so a rotating camera re-renders only the
compass. The store drops an unchanged camera state and keeps each clear
owner's busy state, so the buttons show the shell that answers them: a
shell replaced by a newer one, or disposed mid-clear, leaves the live
shell's state alone, and an older shell that answers again shows its own.
createOwners gains owns() and ownerOf().
2026-11-01 13:37:06 -08:00

65 lines
1.9 KiB
JavaScript

/**
* The owners answering a store's controls. A view calls `act(name, ...args)`;
* the newest connected owner with an action of that name answers it, so an
* owner that connects again replaces itself, and owners of different actions
* sit side by side.
* @returns {{connect: Function, detach: Function, act: Function, owns: Function, ownerOf: Function}}
*/
export function createOwners() {
/** @type {Array<{actions: object}>} Oldest first. */
const owners = [];
/**
* Answer the actions named in `actions`.
* @param {Record<string, Function>} actions
* @returns {object} Token for detach().
*/
function connect(actions) {
const token = { actions };
owners.push(token);
return token;
}
/** Stop answering for the owner holding `token`; the others stay. */
function detach(token) {
const index = owners.indexOf(token);
if (index >= 0) owners.splice(index, 1);
}
/**
* A control's change: call the newest connected owner's action of that
* name, if any.
* @param {string} name
* @param {...unknown} args
* @returns {unknown} What the action returned, if one answered.
*/
function act(name, ...args) {
for (let index = owners.length - 1; index >= 0; index -= 1) {
const action = owners[index].actions[name];
if (action) return action(...args);
}
}
/**
* The token of the owner that answers `name`, if any.
* @param {string} name
* @returns {object | undefined}
*/
function ownerOf(name) {
for (let index = owners.length - 1; index >= 0; index -= 1)
if (owners[index].actions[name]) return owners[index];
}
/**
* Whether the owner holding `token` is the one that answers `name`, so an
* owner that also publishes state can leave it to a newer one.
* @param {object} token
* @param {string} name
*/
function owns(token, name) {
return Boolean(token) && ownerOf(name) === token;
}
return { connect, detach, act, owns, ownerOf };
}