diff --git a/changelog.d/1724-stories.md b/changelog.d/1724-stories.md new file mode 100644 index 0000000000..f02c337616 --- /dev/null +++ b/changelog.d/1724-stories.md @@ -0,0 +1,8 @@ +- Stories: GEV scenes told as stories on the live globe. A Stories button + opens Explore, a feed of the scenes GEV ships and the person's own (saved + from AUTHORING, or drafts) with a pin each and an idle tour between them; a + story plays with chapters, key moments and its data sources, and Close puts + the person's view, clock and layers back. Play after a pause, a seek or a + paused story link goes on from that exact moment. AUTHORING gains + THUMBNAIL, topic tags and SAVE TO STORIES + (Manjunath, @manjunath22466; Kevin Rajan, @kvnloo; #1724). diff --git a/changelog.d/1773-context-panel.md b/changelog.d/1773-context-panel.md new file mode 100644 index 0000000000..cf2bf3d1cc --- /dev/null +++ b/changelog.d/1773-context-panel.md @@ -0,0 +1,5 @@ +- Rebuild Context around one card for whatever is picked (facts, route, + weather, local news and what is nearby) and a description of the view when + nothing is; Contacts, Space Missions and Radio stay in it, and the Labels + and 3D aircraft settings move into its Properties tab while their layers + are on (manjunath22466, samehkhamis, #1773). diff --git a/changelog.d/1774-card-previews.md b/changelog.d/1774-card-previews.md new file mode 100644 index 0000000000..8a7a24c0e2 --- /dev/null +++ b/changelog.d/1774-card-previews.md @@ -0,0 +1,4 @@ +- Preview what Context's card shows: a flight's photo, its route on a small + globe, its fleet model turning and the view from its cockpit; a vessel's + photo; and the ground beneath a satellite, with its altitude and speed + graphed (manjunath22466, samehkhamis, #1774). diff --git a/changelog.d/1775-base-map-globe-port.md b/changelog.d/1775-base-map-globe-port.md new file mode 100644 index 0000000000..4817a0145b --- /dev/null +++ b/changelog.d/1775-base-map-globe-port.md @@ -0,0 +1,5 @@ +- Switch the base map through the globe port on Cesium as well: Google 3D + turned off is kept and shown again without reloading, Esri reaches its + deepest level with the parent's imagery where it has none, and keyless + terrain that does not answer falls back to the flat ellipsoid (Sameh + Khamis, @samehkhamis, #1775). diff --git a/changelog.d/1778-clock-sources-on-destroy.md b/changelog.d/1778-clock-sources-on-destroy.md new file mode 100644 index 0000000000..7f4a491447 --- /dev/null +++ b/changelog.d/1778-clock-sources-on-destroy.md @@ -0,0 +1,3 @@ +- Launches and satellites stop holding the world clock after they are + destroyed, so an application started again in the same page no longer keeps + the old one in memory (Sameh Khamis, @samehkhamis, #1778). diff --git a/docs/APPLICATION.md b/docs/APPLICATION.md index 10673fd07f..301ca53cd2 100644 --- a/docs/APPLICATION.md +++ b/docs/APPLICATION.md @@ -284,7 +284,10 @@ rejects delayed responses; a new start requests a fresh secret. Secret expiry limits connection creation and does not describe the connected session lifetime. `createStandaloneApplication({ voice })` passes these construction options to -the controls. An incompatible protocol needs a separate controller adapter; +the controls. An app can supply `voice.openStories({ isCurrent })` for what the +`open_stories` action does, spoken or typed; it answers true when it opened, +`'already-open'`, or false. Without it the action opens the Stories page. +An incompatible protocol needs a separate controller adapter; changing an endpoint alone does not translate protocol messages. No alternate model is bundled by this extraction. The Node Realtime provider accepts `realtime: { endpoint, models: { standard, mini }, resolveApiKey, fetchImpl }`; diff --git a/docs/CURRENT-STATE.md b/docs/CURRENT-STATE.md index 811e2a1fd6..4a5d97da6e 100644 --- a/docs/CURRENT-STATE.md +++ b/docs/CURRENT-STATE.md @@ -12,11 +12,13 @@ north. While anything moves (a layer in motion, the camera, a followed contact), the globe draws at the display's own refresh rate; there is no fixed 60 FPS cap. -The Cesium frame port (`src/render/cesium/ports.js`, its `idleFps`) caps a -parked scene at `IDLE_FRAME_RATE` (60, `src/renderGovernor.js`) ticks a -second while no hold is out, because Cesium still runs the clock, data sources -and update listeners on every animation frame even when it skips the draw; the -viewer starts at that cap until the frame port takes over. Through the idle +The render governor (`src/renderGovernor.js`) caps a parked scene at +`IDLE_FRAME_RATE` (60) ticks a second while nothing holds the loop, because +Cesium still runs the clock, data sources and update listeners on every +animation frame even when it skips the draw, and lifts the cap while anything +does: the frame port tells it when the loop's first hold is taken and its last +released, its own holds (animated visual styles) included. The viewer starts +at that cap until the governor is installed. Through the idle render governor, the camera port holds continuous render from `moveStart` to `moveEnd`, and samples its pose every 250 ms in between, so a camera drifting by rounding errors (no `moveEnd`) is released after half a second at rest and held again if it moves. The world clock holds continuous render while @@ -658,6 +660,147 @@ owner (open state, filters, the rows they show, Remove all) and the text helpers the view renders, so every label follows the locale. Only the modal open/close and focus moves are imperative. +## Stories — November 13, 2026 + +A Stories button (top right, `#hStories`) opens Explore: a feed of stories +over GEV's own globe with their pins, then a Story screen with a +timeline, chapters and context. Every GEV page loads only what the +closed state needs: the boot shell (`src/stories/boot.js`), the store, +`StoriesView.vue` with the Stories button, first-visit popup and +back-to-story toast, and their styles (`stories-entry.css`). The screens +(`ExploreScreen.vue`, `StoryScreen.vue` and their parts), their styles +(`stories.css`), the story data (`storyMeta.js`, `catalog.js`) and the +controller are separate chunks fetched together on first open, on a +`?stories=` / `?story=` link, or on Back or Forward into Stories; a failed +fetch is reported and the next attempt tries again. Stories keeps its place +in the query, not the share-state hash, with one history entry per screen; +Close steps back over those entries, so Back afterwards does not reopen it, +and share links carry the Stories screen and place. Explore links use +`stories=explore` and optionally `selectedStory`. Player links use `story` +and optionally `storyTime` in milliseconds, opening paused at that time. +GEV's share link keeps +`history.state` when it rewrites the hash, so Stories' entries survive. + +Every story is a GEV scene, played on the person's own globe through +`SceneDirector`, with its labels, embedded media, A/B imagery split (marked +`data-globe-overlay`) and data-pack cards kept while the rest of GEV is +hidden. Explore lists the scenes the person saved to Stories from AUTHORING +first (`SceneDirector.storyScenes()`, refreshed on every `stories-changed`), +then the person's other scenes with a shot as drafts +(`SceneDirector.draftScenes()`, marked DRAFT), then the +scenes GEV ships with a camera path while they are in the project +(`SceneDirector.hasScene`). Zero-shot drafts can be reopened or deleted +from the scene selector in AUTHORING after a reload. A saved scene brings the card image and topics +picked for it in AUTHORING; the topic chips use AUTHORING's tag names and +order. Explore opens at country level +(2,500 km) over the first story and, while idle, flies on to the next story +every few seconds, for a minute after the last touch (never with a story +picked or with reduced motion). The start view and a picked story's place +(at an angle, −60°) are framed in the middle of the map Explore leaves +visible (`.ex-map`: beside the feed on a wide screen, above the sheet on a +phone), not of the whole canvas; a flight that lands after that area has +moved makes one short correction. Stories reaches the globe only +through the renderer's ports (`src/render/rendererOf.js`): its flights, +pose and Close's restore go through the camera port, and after each landing +a continuous-render hold keeps the globe drawing only until the globe port +reports the base settled (at most 10 s). Each story's pin, in the +world overlay's label style (`src/overlays/worldOverlayTokens.js`), is placed +from the query port's projection in the frame port's `postRender`, on every +drawn frame, written straight to the pin's transform, and hidden behind the +globe (`query.isOccluded`); the pins ask for no frames of their own. Card +images are drawn from the keyless Esri World Imagery tiles around the +story's place (`src/stories/thumbs.js`: the same Web Mercator tiles, from +the same host, that GEV's Esri map draws, read as images) unless the scene +has its own; with any other map stack than Esri Satellite +(`mapStackController.getActiveId()`) the card shows its placeholder, and a +card drawn from Esri earlier is dropped. AUTHORING captures thumbnails only +on a ready Esri World Imagery stack and embeds the imagery credit in the +exported image. A shot +tied to an anchor rather than a place pins the whole-globe view. + +A shipped story's context comes from what GEV knows about it +(`src/stories/catalog.js`): what it shows, the place each shot goes, and, +for each layer it turns on, what the layer shows and the data sources +DATA_SOURCES.md lists for it. The Nepal story carries the event pack's own +facts and sources (Vantor imagery and the GeoPera reconstruction, CC BY-NC +4.0), and its key moments are the chapters that show them. Topic chips and +region choices are the ones the listed stories carry. Closing Stories after +a story played puts AUTHORING's own selection back; +Open in GEV leaves the story's scene selected there. Entering Stories +cancels in-flight Authoring work before it captures the view it will +restore. Dragging the timeline previews the time, and releasing +it seeks the globe once. Play after a pause, a seek or a paused link goes on +from that exact moment (`SceneDirector.startScene` with `fromProgress`), even +inside a shot or its final quarter-second: the camera, the hold, the scene +clock and the layers' reveals carry on from there (a clip that moment falls in +starts again from its beginning, and the hold waits for it, with the +timeline held at the shot's end meanwhile). A scene that has actually ended replays from the +beginning. + +Opening Stories claims the camera through the shared navigation policy, so +orbit, a tracked contact or a flight end, and Cockpit refuses with the +policy's own toast ("Exit cockpit to open Stories"). Those owners are not +started again on Close: the camera and the world clock (`src/time/worldClock.js`: +live, or the time it showed, playing on as if never paused) come back, a +follow or orbit does not. While Stories is open it owns the keyboard (`src/stories/keyboard.js`): +a key pressed in Stories stops at its root, and a key pressed anywhere else +stops at the window, so none of GEV's document-level shortcuts act behind it, +except on a playing GEV scene's own on-globe controls (`data-globe-overlay`); +the capture-phase listeners (hold Space to talk, a surface's Tab trap, the +wildlife card's Escape) check `body.stories-mode` themselves. "Open Stories" +works from voice or typed AI chat. Entering Stories ends active or pending +microphone capture and blocks microphone starts while Stories owns the +globe. Stories shows a notice when it turns off an active or connecting +voice session. A typed reply can finish after opening Stories. Globe tool calls +are refused while `stories-mode` is set ("Close Stories first"). + +The address bar names only the story while Stories is open. Stories holds +hash writes (`ShareLinkManager.holdWrites`) and saves a snapshot of the live +globe, including when it opens from a story link without a hash. +Close dismisses the Stories screens and keeps the keyboard and microphone +guards until the previous view is back. The director is waited +on until idle (`SceneDirector.whenIdle`: no run and no pending LOAD, seek or +interaction; at most 15 s). When the 15 s run out, the scene's layer cleanup +still under way is revoked (`SceneDirector.revokeSceneRelease`) before +anything is put back, so it cannot turn off a layer Close restores. The camera and world clock are put back (a clock +nothing moved while Stories was open, with no jump and the same mode and +rate, is left alone), unless a +camera owner took over during the wait (a drag on the globe, a layer's +focus). History steps back over Stories' entries; once that lands (or after +2 s if it never does), the saved share state is re-applied directly +(`ShareLinkManager.restore`, since the share link skips a hash it already +knows) and the share link writes the live view again. Back out of Stories +re-applies it the same way, and Back to Explore from a story re-applies it +once the scene has torn down, with the address still naming only Stories. +"Open in GEV" (GEV scene stories only) closes the +same way but keeps the place and look: nothing is put back, the scene and its +current shot are selected (`SceneDirector.selectShot`) and the Scenes panel +opens for authoring; Back then goes to the page before Stories. A Close or +open made while a traversal is landing runs once it has landed; a second Back +to Explore is ignored. Reopening Stories while a closed GEV scene is still +tearing down keeps the view from before Stories as the one Close restores. +Inside an inline embed Stories is not offered: the URL and history are the +host's. + +The Stories button sits left of whatever holds GEV's top-right corner: the +ACTIVE STYLE readout (`#style-indicator`), or an element marked with +`data-stories-corner` (with or beside the readout; one added after Stories +mounts is found within 20 s). On GEV's phone layout, +where neither shows, it is icon-only under the corner-actions column +(`#corner-actions`), aligned with its right edge. The first-visit popup +is a labelled region that does not take focus. The story page's rail offers +Open in GEV and Share only. Share on Explore reopens the list with the same +shipped story selected. A story link opens paused at the shared +point on its timeline. A scene of the person's own (saved or draft) +shows as theirs ("You") and has no Share: the project lives on this device, +so a link to it would open nothing elsewhere; a link to a story that is not +here opens Explore and says so. GEV's own credit line stays on screen throughout, inside the +Stories map while a scene plays (`creditPlacement` in +`src/stories/format.js`): `stories.css` places the renderer's own credit +display (`#cesium-credits`) and the application's credit line +(`#gev-credits`, `src/ui/creditsView.js`, with its list opening above it) +alike, and exempts both from the rule that hides GEV's chrome. + ## Utilities panel — October 29, 2026 UTILITIES is its own left-side panel, between Data Layers and Scenes, with @@ -755,6 +898,54 @@ and touch screens, while the rails are hidden (clean view, recording), and it follows the rails' sides in a right-to-left language. On a phone, Visual is in the More sheet with the dock's Visual Presets, as before. +## Context panel — November 16, 2026 + +Context leads with one card for whatever is picked. A click on anything a +layer can identify (`src/ui/entityContextBridge.js`, through +`src/data/pickedContext.js`) opens its card (`src/ui/stores/entityCard.js`, +`src/ui/views/panels/EntityCard.vue`): the item's facts from its record, a +route with progress for a flight, an altitude graph, the weather, local +time and news where it is, and the flights, vessels, hazards and warnings +within the radius the panel sets (25 to 2,500 km). Aircraft, satellites and +vessels are followed as they are picked; the card says Following only while +the camera follows the card's own item, and closing the card lets go. +Aircraft and satellites offer Enter Cockpit and Enter orbital view; transit +vehicles show their motion and fleet. A camera's card shows its latest frame +from the CCTV panel. + +With nothing picked, the panel describes the view +(`src/ui/views/panels/ViewContext.vue`): the place under the middle of the +screen and the towns around it from the Wikidata cities pack, the height, +the local solar time and daylight, what is in view per layer with live +counts and breakdowns, and the same weather and hazards. A search field in +the header narrows every list. Expanded, Context becomes a full-height +column at the right edge (the left edge right to left) and the map credits +stop short of it. + +The Contacts and Space Missions modes and the Radio strip stay in the +panel's main tab, below the card. When Contacts follows the aircraft the +card shows, its list sits inside the card. Turning Radio or Launches on +opens Context. The Properties tab holds the Labels and 3D aircraft +settings from Visual while a layer they act on is on. + +Context does its reading only while its panel is open. Weather and news +come through the regional brief service; earthquakes, tropical storms and +fire perimeters come from the same feeds as their layers, cached for five +minutes; satellite fire hits only while the FIRMS layer is on. + +The card's top tile previews what is picked. A flight shows its +Planespotters photo once the flights layer has looked one up for the plane +it tracks, its route on a small globe (origin to destination, flown part +solid, the plane on it), its fleet model turning with callouts of what can +be worked out about the flight, and the view ahead from its cockpit with +speed and altitude tapes; the model and the cockpit view take turns. A +vessel shows its Open Vessel Photos photo, a satellite the ground beneath it +from Esri World Imagery with its altitude and speed graphed. The globe, model +and cockpit view are drawn by the renderer through its `cardPreviews` +application hook (`src/render/cesium/cardPreviews.js`), each in a small scene +of its own that frees its graphics context as it closes; the model comes from +the fleet set loaded at startup, so opening a card fetches no model. + ## Wikidata cities pack — November 15, 2026 `src/data/local_data/wikidata_cities/cities.json` bundles 31,827 settlements of @@ -1271,7 +1462,7 @@ Native `