Commit Graph
100 Commits
Author SHA1 Message Date
Sameh Khamis 39f2d0b165 Merge remote-tracking branch 'origin/main' into fix/models-black
# Conflicts:
#	docs/CURRENT-STATE.md
2026-11-17 16:54:43 -08:00
Sameh Khamis e83c1672dd fix(models): tracked and emergency tints mix into aircraft paint instead of multiplying it
Aircraft models multiplied their tint into the shaded paint (HIGHLIGHT).
A saturated tint zeroes every channel it lacks: the tracked cyan (no red)
drew a red helicopter solid black, day or night, and a white Cessna one
flat cyan. Tinted models now mix the colour in at 30%
(AIRCRAFT_MODEL_TINT_MIX), so the paint stays readable and the colour
still marks them; untinted models still draw their own colours, and the
IR boost stays flat white.

Neither the multi-part models nor the part shader were involved: old and
new GLBs, with and without the shader, render the same pixels, and an
untinted model at night is lit by the default ambient term.

The new conformance check draw.models.paint draws a model painted with
COLOR_0 under a fixed sun and reads its colour by day, at night, and
under a tint mixed in. The parts test model can now carry vertex paint.
2026-11-17 16:50:52 -08:00
Sameh Khamis d79494ac89 fix(flights): panels show the reported ground speed while a placement waits
A host-supplied placement's speed is how fast the marker is drawn. While it
waits for its fixes to catch up it stands still at 0, so tracked-aircraft
panels and the cockpit readout showed 0 m/s for an aircraft in flight.

displayedKinematics now takes derivedFromPlacement: when the drawn speed is a
placement's, the reported ground speed is shown, and the placement's only when
nothing is reported. The placement speed still drives motion and dead
reckoning. Civil and military tracked descriptors pass it from the new
_drSpeedPlaced scratch, which placeLiveAircraft sets.
2026-11-17 16:31:03 -08:00
Sameh Khamis ae43284d3f Merge remote-tracking branch 'origin/main' into models/three-km-true-size 2026-11-17 16:22:28 -08:00
Sameh Khamis 1f9d88ca1a Merge remote-tracking branch 'origin/main' into models/three-km-true-size 2026-11-17 16:06:36 -08:00
Sameh Khamis d146c4bb5a Add the changelog entry for the parts check fix 2026-11-17 15:59:17 -08:00
Sameh Khamis 7ea0903fe2 fix(conformance): draw.models.parts waits for frames, not a settled scene, while a part spins 2026-11-17 15:59:10 -08:00
Sameh Khamis ca0aec4d66 Add the changelog entry for the vessel toggle fix 2026-11-17 15:46:06 -08:00
Sameh Khamis 14aa85e638 fix(vessels): the layer turns on even when its feed fails
Turning vessels on returned what the first live poll answered, so a
failing feed (such as a missing AIS key) made enable() resolve false and
the layer reported it could not be turned on. loadLivePositions again
resolves with nothing once the poll is done; going back to live reads the
poll's answer through its own path.
2026-11-17 15:45:49 -08:00
Sameh Khamis b9cbc42f20 Merge remote-tracking branch 'origin/main' into models/three-km-true-size
# Conflicts:
#	docs/CURRENT-STATE.md
2026-11-17 15:29:39 -08:00
Sameh Khamis 3c3893d18a Merge remote-tracking branch 'origin/main' into models/multi-part-v4 2026-11-17 15:27:35 -08:00
Sameh Khamis 08ababc4fc Add the changelog entry for the multi-part fleet models 2026-11-17 15:17:42 -08:00
Sameh Khamis 0b751c2118 Multi-part fleet models: named parts (rotors, propellers, gear, doors) on every aircraft, helicopter, vessel, vehicle and transit model; rocket type rules 2026-11-17 15:17:34 -08:00
Sameh Khamis a1bcce0f63 Merge remote-tracking branch 'origin/main' into sprites/kinds-history-live 2026-11-17 15:12:06 -08:00
Sameh Khamis 49eb5b53c8 Credit the changelog entry to the author's handle 2026-11-17 15:10:12 -08:00
Sameh Khamis c0b31e7edc Add the changelog entry for sprites by kind and the history-to-live handover 2026-11-17 15:10:06 -08:00
Sameh Khamis 7186f720df Sprites for helicopters, ground vehicles, stations and vessel types; history to live without an empty map; model parts in Cesium
Aircraft icons are one size; helicopters turn a three-frame rotor while
airborne or moving; ADS-B ground vehicles share one amber sprite and
stations/obstacles one mast; vessels get hull sprites by type and one buoy.
Going live keeps contacts until the first live answer and replaces them by
id; fast playback holds before the loaded positions end and prefetches
ahead. Cesium models move their parts from the optional model part state.
2026-11-17 15:09:54 -08:00
Sameh Khamis 28baddb923 Name the changelog entry for its pull request number 2026-11-17 11:56:59 -08:00
Sameh Khamis 463946abfa Bring the tracking harness's cameras within 3 km of the planes it models
The tracked-model checks zoom the follow camera to within 2 km of the plane,
and the grounded-model check parks the camera 2 km above the planes instead
of 8 km, since models now draw only within 3 km.
2026-11-17 11:52:34 -08:00
Sameh Khamis 1048a71d73 Add the changelog entry for 3D models within 3 km 2026-11-17 11:27:34 -08:00
Sameh Khamis b041fea7a6 Deselecting a plane drawn as a model no longer flashes its icon
A selected plane is drawn by its own model, and its fleet model was let go once
that model drew. Deselecting showed the icon at once, and the icon stayed for
about a second while a new fleet model loaded.

The fleet model now stays loaded but hidden while the plane is selected, kept
where the plane is. Deselecting hands the plane back to it in the same frame,
and the icon shows only when there is no loaded fleet model. Military aircraft
share this code. Vessels never swap models on selection, so they had no flash.
2026-11-17 11:27:21 -08:00
Sameh Khamis 36624cd329 3D models only within 3 km of the camera, at true size
An aircraft, vessel, transit or rail vehicle now draws as its 3D model only
when it is within 3 km of the camera, and as its icon farther away. A model
already drawn is kept out to 3.6 km, so a vehicle on the edge does not flicker.
Proximity and All use the same distance and still differ by how many models
they allow (150 and 350). Models are drawn at their true size: the minimum
pixel size that inflated distant models is gone.

The camera altitude above which no model is considered is now the highest
aircraft the layers draw (30 km) plus the 3.6 km, so a camera high above the
ground still models an aircraft close to it. Cockpit's aircraft silhouettes
keep their own 150/185 km and 400/450 km bands, since they are icons.
2026-11-17 11:21:08 -08:00
Sameh Khamis 9db71ad443 Add the changelog entry for the world clock fix 2026-11-16 21:19:09 -08:00
Sameh Khamis ee306a46fc Launches and satellites leave the world clock when destroyed
Both layers registered their time coverage with the page's world clock when
created and never unregistered it, so an application destroyed and started
again kept each old layer, and its scene and tiles, reachable through the clock.
They now unregister on destroy and register again on init, as earthquakes do.
2026-11-16 21:18:58 -08:00
Sameh Khamis 30705b5785 Add the changelog entry for the base map through the globe port 2026-11-16 17:06:35 -08:00
Sameh Khamis 8ff9a1fa29 Base map through the globe port
Cesium switches the map stacks through its globe port, as any renderer
does, rather than through a map engine of its own. Every route keeps its
behaviour:

- Google 3D turned off is kept hidden, and shown again without loading it
  anew; the key route's tiles take clamped marks, as the token routes' do.
- Esri goes to its deepest level (23); its "Map data not yet available"
  picture is a missing tile, so the parent's imagery stays.
- Cesium ion's world imagery is Bing over HTTPS on any page, with ion's
  credits; a token ion refuses refuses the switch, as before.
- Keyless terrain that does not answer is the flat ellipsoid, tried again
  behind it; world terrain asks ion first, as before.
- window.__godsEyeView.tileset is the Cesium photoreal tileset.
2026-11-16 17:06:35 -08:00
Sameh Khamis 23adcf1112 Voice: tools accept voice: null again when reading openStories 2026-11-16 16:38:44 -08:00
Sameh Khamis b1b2ac91c0 Voice: an app can supply what open_stories does
createApplicationTools took the Stories page as the open_stories action
even when the app's voice options gave its own. voice.openStories now
takes precedence, spoken or typed, with the Stories page as the default.
2026-11-16 16:33:46 -08:00
Sameh KhamisandManjunath Paparaju efffe3005c Fix the card previews' review findings
- A route globe that cannot draw tells the card, which shows another view.
- A card opened before the model set has loaded waits for that load.
- The model turns at the same rate on any display, and holds still under
  reduced motion.
- A hidden cockpit view stops drawing.
- The route plane keeps the craft's latest position through the fly-in.
- Metric altitude graphs keep main's 0.5% change threshold.

Co-authored-by: Manjunath Paparaju <[email protected]>
2026-11-16 15:57:40 -08:00
Sameh KhamisandManjunath Paparaju 7b53427a28 Add the changelog entry for the card previews
Co-authored-by: Manjunath Paparaju <[email protected]>
2026-11-16 15:45:13 -08:00
Sameh KhamisandManjunath Paparaju e6fb6be4d9 Translate the card previews
Co-authored-by: Manjunath Paparaju <[email protected]>
2026-11-16 15:44:35 -08:00
Sameh KhamisandManjunath Paparaju 3a0842c103 Draw the card previews through the renderer, and show vessel photos too
- The route globe, turning model and cockpit view are the renderer's: the
  Cesium plugin hands them over as its `cardPreviews` application hook
  (src/render/cesium/cardPreviews.js), and the card's tiles keep only the
  words, figures and HUD laid over them. Nothing in the UI reaches Cesium,
  and a renderer without the hook leaves the card its photo and figures.
- The turning model is the fleet model the globe draws for the aircraft's
  type, from the set loaded at startup, so opening a card fetches nothing.
  The flights layer's record now carries the type code and emitter category
  that pick it.
- The photo comes from the item's own layer: the flights layer's
  Planespotters photo for the plane it tracks, and the vessels layer's Open
  Vessel Photos photo for the vessel selected, with its credit. It no longer
  waits for Contacts to follow the same aircraft.
- The satellite models are left out: the card shows a satellite's ground
  view and graphs its altitude and speed.
- The route globe's airport codes are drawn into its own small scene, the
  compass reads its course in the active language, the callouts no longer
  speak to screen readers every six seconds, and figures use the app's
  number format. Esri's tile address and credit live in one place.

Co-authored-by: Manjunath Paparaju <[email protected]>
2026-11-16 15:44:35 -08:00
Sameh KhamisandManjunath Paparaju 2209810cdd Carry Context's package and same-as-English entries onto the latest main
Co-authored-by: Manjunath Paparaju <[email protected]>
2026-11-16 15:02:31 -08:00
Sameh KhamisandManjunath Paparaju 57f9c03eaa Keep Context's follow, clicks, Radio, Cockpit entry and credits right
- Following comes only from the camera's own follow, never claimed ahead
  of it; vessels, which the camera does not follow, are flown to.
- A drag or a long press never selects, and only a clean click on open map
  closes the card; a card painted on the overlay is not open map.
- Closing the card lets go through its own layer only, as the person's
  action, leaving other layers' selections alone.
- Radio's panel, with its local SDR tuner, shows whether or not the Radio
  layer is on; Contacts' Cockpit entry hides only while the card offers its
  own.
- Expanded Context keeps the credits beside it right to left and with the
  minimal HUD.
- Context counts as closed until its panel says it is open; closed, the
  card's refresh and the view reading pause, and opening reads the view.
- The five-minute re-read fetches again past the caches, keeps what is
  shown meanwhile, and an empty brief is not kept.

Co-authored-by: Manjunath Paparaju <[email protected]>
2026-11-16 14:59:18 -08:00
Sameh KhamisandManjunath Paparaju 547687fecf Add the changelog entry for the Context panel
Co-authored-by: Manjunath Paparaju <[email protected]>
2026-11-16 14:59:18 -08:00
Sameh KhamisandManjunath Paparaju 13e1f19f85 Keep the renderer's credits line clear of expanded Context too
Co-authored-by: Manjunath Paparaju <[email protected]>
2026-11-16 14:59:18 -08:00
Sameh KhamisandManjunath Paparaju 46851db515 Read Context's camera and clicks through the renderer's ports
Context no longer reaches into Cesium or the viewer: the view it describes
comes from the camera port (pose, view rectangle, moveEnd and changed), a
fly-to goes through flyToBounds, and clicks come from the input dispatcher,
which picks each click once for every layer and skips it while a tool holds
the pointer. The card says Following while the camera follows its own item,
as the follow's key names it (src/data/followed.js), whoever started the
follow.

Co-authored-by: Manjunath Paparaju <[email protected]>
2026-11-16 14:59:18 -08:00
Sameh KhamisandManjunath Paparaju 7552763ea1 Describe the Context panel in the current state
Co-authored-by: Manjunath Paparaju <[email protected]>
2026-11-16 14:59:18 -08:00
Sameh KhamisandManjunath Paparaju 4a2c989859 Make Context do its work only while open and keep its actions honest
- Closed, the panel mounts neither the card nor the view summary, so it
  reads no layer records and fetches nothing.
- The weather and news brief goes through the app's regional service
  (endpoint overrides, lifetime signal), and a failed read is not kept.
- A spot that stays put reads its brief and hazards again every five
  minutes; turning FIRMS on or off updates the hazards at once.
- Enter Cockpit is offered only for layers the tracking action can follow
  (not local ADS-B), and a failed attempt leaves the card as it is; a
  satellite ride gives up when the card changes or Context goes away.
- Closing the card lets go of the camera when it follows the card's item.
- Map picks leave Context alone while Cockpit runs.
- Expanded Context sits on the left edge in right-to-left languages, lets
  go on the phone layout or in Cockpit, and a remount starts collapsed
  without leftover tab classes.
- The Inspector and Properties tabs have tab ids, panels and arrow keys.
- Town lookups run again after zooming back in, the camera preview shows
  facts only for its own camera, route places wait for the same route, and
  acres and heights use the app's number format.
- The omnibar gets no runner from a voice session already disposed.

Co-authored-by: Manjunath Paparaju <[email protected]>
2026-11-16 14:59:18 -08:00
Sameh KhamisandManjunath Paparaju 6e03871d5a Mark the card followed only while the camera follows its own pick
Tracking set by another control or by voice for another craft no longer
shows Following on the open card: the card remembers the entity its own
pick started tracking, and any other tracked entity clears Following.

Co-authored-by: Manjunath Paparaju <[email protected]>
2026-11-16 14:59:17 -08:00
Sameh KhamisandManjunath Paparaju ee22aace8d Describe the view the camera stops at, after a jump too
A share link or restored view moves the camera without a moveEnd, and the
once-a-second read of camera changes dropped the last one, so Context named
a point from the fly-in. A last read now follows the final change.

Co-authored-by: Manjunath Paparaju <[email protected]>
2026-11-16 14:59:17 -08:00
Sameh KhamisandManjunath Paparaju 90510bf9e6 Read satellite fire hits in Context only while the FIRMS layer is on
FIRMS needs a key the browser cannot see. Without one the proxy answers
503, so Context no longer asks for fire hits unless the FIRMS layer is on.

Co-authored-by: Manjunath Paparaju <[email protected]>
2026-11-16 14:59:17 -08:00
Sameh KhamisandManjunath Paparaju b6b7874b97 Keep the map credits clear of expanded Context
Expanded, Context covers the right edge from top to bottom, so the credit
row now ends short of it. The credit model knows the expanded column and
pins the gap, the header test lists the new search and expand buttons, and
the controls tolerate operations without an annotation resolver.

Co-authored-by: Manjunath Paparaju <[email protected]>
2026-11-16 14:59:17 -08:00
Sameh KhamisandManjunath Paparaju 4b350cb9ae Translate the rest of the Context card's facts
Co-authored-by: Manjunath Paparaju <[email protected]>
2026-11-16 14:59:17 -08:00
Sameh KhamisandManjunath Paparaju 4554713f98 Translate the Context panel
Marks the Context panel's remaining strings and translates them into every locale.

Co-authored-by: Manjunath Paparaju <[email protected]>
2026-11-16 14:59:17 -08:00
Sameh KhamisandManjunath Paparaju 902689da8a Keep Context inside the package boundaries
The shell passes the ground picker to the click bridge, so the UI shell no
longer pulls in the annotation and search stack. Context's new modules are
owned by the packages that import them and formatted with the rest.

Co-authored-by: Manjunath Paparaju <[email protected]>
2026-11-16 14:59:01 -08:00
Sameh Khamis 56bd14d5f2 Merge remote-tracking branch 'origin/main' into stories/gev-stories 2026-11-16 14:28:09 -08:00
Sameh Khamis 2788a9f667 Docs: the timeline waits at a shot's end while a restarted clip plays 2026-11-16 14:20:55 -08:00
Sameh Khamis 186f8b76d9 Scenes: a clip restarted without a media gate plays its hold out
A resumed hold waited only its rest unless the layer gave a media gate,
and only trimmed clips have one, so an untrimmed clip started again (as
on Gyirong) was cut short. The layer now says when a run going on from a
seek started its clip again, and the hold then plays out as from its
start: through the media gate when there is one, else for the whole hold.
2026-11-16 14:20:55 -08:00
Sameh Khamis 5cce9d0705 Nepal evidence: a seek in the hold places a camera-led shot's sequence
For a shot whose path runs during the camera move, a seek in the hold
showed its evidence sequence at the start and a resumed run jumped to
its end. The sequence now stands where its own clock has it (after the
clip and its exit), and a resumed run carries on from there.
2026-11-16 14:18:21 -08:00
Sameh Khamis c3b8013038 Stories: format the corner-controls test 2026-11-16 14:15:15 -08:00
Sameh Khamis 9e6207d7f2 Stories: the button sits left of elements marked data-stories-corner
The corner controls are the ACTIVE STYLE readout and any element marked
with data-stories-corner, looked for again for 20 s after Stories mounts,
in place of an element id this app never has.
2026-11-16 14:14:27 -08:00
Sameh Khamis 78b8d8dc78 Stories: read whether the story was playing before the press stops it
The director's own pointerdown listener, added first, stops a run whose
camera it drives before Stories heard the press, so the tap still played
the story again. Stories now reads the press in the capture phase, and
its tap listeners are removed on teardown.
2026-11-16 14:13:06 -08:00
Sameh Khamis 0ed6cde956 Idle frame rate in the app, timed line batching, KEY REQUIRED status
Three fixes to how the globe draws and reports loading.

**The idle frame rate is the app's rule.** The Cesium frame port capped the loop at `IDLE_FRAME_RATE` whenever nothing held it, so the rule lived inside the renderer. The render governor now sets the rate: the display's own while the loop is held, `IDLE_FRAME_RATE` while not. The frame port gains `onHeldChange(cb)`, which says when its first hold is taken and its last released (animated visual styles included), so the governor hears every hold. The quality setting's frame-rate cap is kept apart from the governor's rate, and the loop draws at the lower of the two, so neither overwrites the other.

**Line batching is timed.** A line set waited 30 drawn frames before its unchanged lines settled into a static batch (300 for the long wait), so the batch built twice as fast at 120 Hz as at 60 Hz, and took seconds at the idle rate. It now waits `SETTLE_MS` (500 ms) and `LONG_SETTLE_MS` (5 s), and moved shapes go back into their batches on the same timing.

**KEY REQUIRED.** A layer that cannot load without a provider key ended the global status chip LOAD FAILED. The chip now has a KEY REQUIRED outcome, ranked below a real failure: a layer whose stats say `keyRequired` ends KEY REQUIRED, any other failure still ends LOAD FAILED. Vessels report a missing AISStream key as `keyRequired` and name the key in the panel; a later outage clears it, as it is no longer the key that is missing.

Checked: the full suite (new tests for `onHeldChange`, the quality cap against the governor's rate, timed settling, and the chip with and without a key), format, boundaries, build, the stub renderer boot and the Cesium conformance run; in the browser, the idle and held frame rates; and the first-run check now asserts that with no keys set the chip never says LOAD FAILED.
2026-11-16 14:10:01 -08:00
Sameh Khamis 40f537a8b9 Stories: drop the Live chip and filter no story can show
No GEV story is live, so the LIVE card chip, the Live topic filter, the
catalog's live field and their styles are removed.
2026-11-16 14:01:56 -08:00
Sameh Khamis 095e4161d8 Scene document: accept the Stories fields from version 6 again
Early Stories builds wrote stories, storyThumb and storyTags in version 6
projects, so those projects load again; the fields stay refused before
version 6. The version 6 round trip is tested again.
2026-11-16 14:00:30 -08:00
Sameh Khamis 807e872731 Stories: a tap pauses a story whose camera move stopped on the press
A camera move the scene drives frame by frame (an authored move, or a
flight resumed partway) stops the run on pointerdown, so the story read
as stopped when the tap ended and the tap played it again. The tap now
goes by whether the story was playing when it began.
2026-11-16 14:00:09 -08:00
Sameh Khamis 8f2155d6c7 Scenes: startup selects the first scene after shot-pack upgrades
An upgrade of a later scene's pack selected that scene; the first scene
and shot are now selected once the upgrades are done.
2026-11-16 13:59:09 -08:00
Sameh Khamis 82475bced3 Stories: an entry for a deleted story drops its ?story= in any mode
Back or Forward into such an entry from Explore or an open story clears
the story and its time from the address and the entry's history state,
keeping the globe hash and, when the entry is Explore, Explore itself.
2026-11-16 13:57:23 -08:00
Sameh Khamis 6904ce0e7a Scenes: a hold resumed partway waits for the clip it started again
The resumed hold reads scene media like any hold: a clip still playing
is waited for, and only without one does it wait out the rest of the
hold.
2026-11-16 13:55:07 -08:00
Sameh Khamis b2c7144cce Scenes: a run resumed inside a hold plays its layers on from that moment
After placing the layers at the seek's moment, the hold settles them
without the seek, so the reveal continues from where the seek put it and
a clip the moment falls in starts again from its beginning (a clip
cannot be joined partway); one the moment is past stays finished.
2026-11-16 13:54:40 -08:00
Sameh Khamis 87b6a4d0c8 Scenes: a revocation also covers the release a stopped run reaches later
A run or LOAD takes the release authority when it starts, so cleanup it
reaches after revokeSceneRelease() turns no layer off.
2026-11-16 13:50:39 -08:00
Sameh Khamis a9990018ea Stories: name the Opened in GEV toast for what it is 2026-11-16 13:48:14 -08:00
Sameh Khamis a5065743d9 Merge remote-tracking branch 'origin/main' into stories/gev-stories 2026-11-16 13:41:09 -08:00
Sameh Khamis 1f6fc86c1a QA: Play on a paused story link goes on from its time 2026-11-16 13:41:09 -08:00
Sameh Khamis 20f6ceb74c Scene document: accept the Stories fields only from version 7
stories, storyThumb and storyTags arrived with version 7, so they are
gated by version like anchors and dataPacks.
2026-11-16 13:40:17 -08:00
Sameh Khamis 1fa053e22d Share link: restore() reports false when the hash is not a share state 2026-11-16 13:38:42 -08:00
Sameh Khamis de0be208da Scenes: an import counts appended packs as built in, as drafts do 2026-11-16 13:37:51 -08:00
Sameh Khamis c8b440dded Scenes: SAVE TO STORIES and tags roll back when the project cannot be saved 2026-11-16 13:37:21 -08:00
Sameh Khamis 85c9f95838 Stories: Back into a deleted story's entry clears ?story= from the address 2026-11-16 13:36:13 -08:00
Sameh Khamis 26893ae37e Vessel tracks end at the vessel
The selected vessel's track drew every fix it held. Following the world
clock, it ran ahead of the icon to the vessel's newest fix; live, it
stopped at the last fix while the icon moved on from it. A change of time
restarted it from a single point until the track at the new time arrived,
so it went blank at every step.

- The track draws the fixes at or before the time the vessel is drawn at;
  live, every fix.
- Each frame a head joins its last drawn fix to the icon where it is drawn,
  as flight tracks do; none past TRAIL_HEAD_MAX_M (20 km), where the clock
  has moved beyond the fixes the track holds.
- A change of time keeps the track, drawn up to the new time, until the
  track at that time replaces it.
2026-11-16 13:35:38 -08:00
Sameh Khamis 7a0b649bf5 Stories: remove unreachable prototype paths
GEV stories never explore, carry no world time and are never live:
drop the resume play state, Jump to live, the exploring branches and
world-time arguments, the overridden play button rules, and the hidden
rail and fill. The legend reads a plain field instead of a mock one.
2026-11-16 13:35:05 -08:00
Sameh Khamis f4b535d89e Stories: remove the Mute button, which controlled nothing
Scene media plays muted and offers no audio control to wire it to.
2026-11-16 13:32:38 -08:00
Sameh Khamis 4fa80fb18c Stories: a teardown that times out cannot undo the restored view
directorSettled now tells a timeout from settlement, and on a timeout
revokes the scene's layer cleanup still in flight before Close puts the
view back.
2026-11-16 13:31:51 -08:00
Sameh Khamis 0a39b05cdb Authoring: pick any scene again, and select the first scene on load
Restores the scene picker and its selection on load, after a delete and
after an import, so PLAY and NEXT work after a reload. Open in GEV
selecting a shot and NEW SCENE stay as they are.
2026-11-16 13:30:22 -08:00
Sameh Khamis 1cb3e88027 Scenes: drop a wall-clock check from the resumed-hold test 2026-11-16 13:29:58 -08:00
Sameh Khamis 8734f5e515 Stories: Play resumes at the exact paused or sought moment
startScene takes fromProgress and starts partway into a shot: the camera
goes on along the rest of the flight, the hold waits only what is left
and the scene clock carries on from the same point.
2026-11-16 13:24:59 -08:00
Sameh Khamis 0a0c6a0e5b Vessel playback moves icons on the renderer's clock
While the timeline plays or is scrubbed, each vessel icon is handed to the
renderer as a motion segment along its track (a straight piece of at most
10 km between two fixes, on the scene clock), as aircraft already are. The
layer writes an icon again only when its segment runs out or the time
moves back before it, instead of moving every icon on the CPU every frame.

Behaviour is kept:
- Icons follow the same great-circle track between fixes (a 10 km chord
  stays within 2 m of it) with the same course.
- A vessel still appears TIMELINE_UNSEEN_MS before its first fix and
  hides again when the time moves back before that.
- Cards, the selected vessel, ship models and the vessel the bridge camera
  rides are read where they are every frame; the rest within
  HIDDEN_FOLLOW_MS, as before.
- Position reads (getAllPositions, getNearby, the focus pass, the
  detection overlay, single-vessel lookups) return where the icon is drawn
  at the world time.
- Going live, each icon holds where its segment last drew it, unless a
  live update has drawn it since.
- Trails are unchanged: they are built from the feed's fixes, not from the
  per-frame position.
- Live mode and renderers without the motionSegments capability take the
  previous path unchanged.
2026-11-15 23:56:03 -08:00
Sameh Khamis a7fe3eebc6 Credits keep their linked words: only the words a source linked are the link
A credit read from markup keeps the first link's own words as linkText, and the Cesium credit display and the credit line link just those words, as the source wrote them (Street Level's "© Mapillary contributors" links Mapillary only). The Street Level gate reads a drawn item's pick id from its draw-set id.
2026-11-15 20:12:14 -08:00
Sameh Khamis 74673f3c85 World overlay: the distance curve is computed in the projection pass, so its result is never boxed
On Node 26 the engine inlined the projection pass's helpers in another order and left distanceScale out, so every label's paint scale allocated a number: 158 B per candidate per frame against the 154 B budget, where main measures 136 B. The curve now sits beside the altitude curve in snapshotAndProject, with the same arithmetic.
2026-11-15 20:12:14 -08:00
Sameh Khamis 256e992372 The contract text speaks of the renderer 2026-11-15 19:20:48 -08:00
Sameh Khamis 9862b2a165 Contract and docs text describe the ports and the Cesium renderer only 2026-11-15 19:08:46 -08:00
Sameh Khamis 1fdf52198d CONTACTS: a selected vessel's subject is labelled as its selection is; test doubles without the new lookup still activate 2026-11-15 18:42:06 -08:00
Sameh Khamis 4b0958b9e8 Merge main (87ab9d2b1, #1758 and the #1757 revert) into the renderer branch
Grounded aircraft turn 3D on the first settled frame: streaming tiles are not a miss. groundSnap's tests keep main's cases against the branch's query port; trackedModelForm.test.mjs (the branch's form of trackedModelRegime.test.mjs) takes main's edits.
2026-11-15 18:42:06 -08:00
Sameh Khamis 2ac157aca2 CONTACTS takes the selected vessel as its subject instead of following the nearest flight
Turning CONTACTS on with a vessel selected made the nearest flight to the view the subject and followed it. The selected vessel is now adopted as if it had been selected while CONTACTS was on; a followed flight still comes first, and with nothing selected the nearest flight is still focused.
2026-11-15 18:33:29 -08:00
Sameh Khamis 725f2f2998 Moving transit allocates nothing per frame: reusable positions, kept lists, and the frame probe back in testing.js
- Scratch and marker positions are a Cesium-free Vec3 (src/geo/vector.js), so writing a coordinate does not allocate.
- The dirty set and the upsert lists are kept between frames instead of rebuilt; patchDrawnIcons reuses its lookup arrays.
- measureFrames and stopFrameProbe live in src/layers/transit/testing.js again.
- Tests: 3000 moving vehicles stay under 8 KiB per frame of layer allocation; moving 500 icons allocates under 256 B per upsert.
2026-11-15 18:27:10 -08:00
Sameh Khamis 33c98118ba Revert "Merge pull request #1757 from bilawalsidhu/perf/vessel-labels-merge"
This reverts commit 15d1855dd3, reversing
changes made to 663b56f620.
2026-11-15 18:18:42 -08:00
Sameh Khamis 2fa89a98ae changelog: grounded aircraft models after the tiles settle 2026-11-15 17:41:58 -08:00
Sameh Khamis d232d9afe4 flights: grounded aircraft turn 3D as soon as the tiles settle
Tiles still streaming no longer count as a failed ground sample: they leave
the retry backoff alone and return the last measured ground, if any, so the
first tick after the tiles settle samples and hands the icon to the model.
2026-11-15 17:41:37 -08:00
Sameh Khamis 0ab31d4fb8 The renderer seam: clicks go to the newest tool, recession and display groups through the contract, drawing at parity with Cesium
- Clicks: when two tools want the globe's clicks, the newest takes them and the older is told and turns itself off; a click is decided when it arrives, and ambient selection fires only when no tool holds the pointer. The "map is busy" paths and their strings are removed.
- Recession: the limb fade is shared (src/render/recession.js) and reaches icon and model sets through SetSpec.recede; tuning applies on the next frame.
- Display panel groups are published through src/ui/displayGroups.js; the Weather group and src/viewWeather.js are removed.
- Draw port: a set whose icons only move is moved in place, and models that did not change are not restyled each frame, so moving fleets cost what they did when drawn directly; an untinted, fully opaque model is drawn without a colour.
- Conformance: input.lease.lost checks the new lease inside onLost and reports a throwing onLost; draw.sets.recede covers model sets.
- QA scripts read the renderer host instead of internals the seam replaced.
2026-11-15 17:03:09 -08:00
Sameh Khamis a0d299523d Merge main (663b56f62, #1755) into the renderer branch 2026-11-15 16:34:05 -08:00
Sameh Khamis 3909c7735a changelog: vessel labels and fix merge 2026-11-15 16:13:56 -08:00
Sameh Khamis 121b69561a timeline: read each entry's time once when merging runs
mergeTimelineRuns read an entry's time again on every comparison, and the
vessel layer passed a new arrow for every vessel. Times are now read once
into arrays, the leading older entries the loop would keep one by one are
sliced in one step, and the layer passes one function. The result is the
same entries in the same order; a test checks 3,000 random merges against
the previous algorithm.

Measured in the browser, one implementation per page, 9,000 vessels with
240 kept fixes each, 5 alternating pairs: 65-87 ms -> 57-61 ms per snapshot.
2026-11-15 16:13:28 -08:00
Sameh Khamis b65bb86db3 vessels: project label candidates with the camera read once per pass
The label pass projects every vessel in view each time it runs. It asked
Cesium for each one, which reads the camera and allocates for every point.
createWindowProjector reads the camera's matrices and the canvas size once
and runs the same arithmetic in the same order, so the window positions are
the same numbers (a test compares them bit for bit with Cesium); outside a
3D perspective view it asks Cesium as before.

Grid cells are keyed by number, a cell's candidate is made only for its
first vessel and updated in place, and whether a name is worth a card is
kept per vessel until its name, MMSI or id changes.

Measured in the browser (perf harness, 9,000 vessels, 1 min/s): the label
pass 33 ms -> 11 ms, the forced visibility pass 42 ms -> 27 ms.
2026-11-15 16:13:28 -08:00
Sameh Khamis 9a568020fb changelog: vessel playback frames 2026-11-15 13:35:35 -08:00
Sameh Khamis 1f6e8914f2 vessels: move drawn vessels following the clock once they would move half a pixel
A profile of about 9,000 vessels following a playing world clock spent
~13 ms of every frame in the clock pass, moving every drawn vessel a
fraction of a pixel, and ~4 ms more re-uploading their billboards.

- Drawn vessels move again once the fastest would have moved half a pixel
  on screen at the speed each last moved (measured from the world time it
  was drawn at), at least once a second, and at once when the camera moves
  or changes height by a tenth of its height or the view zooms. A pass that
  holds them back asks for a frame, so a paused clock settles on the time.
- Hidden vessels move a share of them each pass, each within 250 ms, rather
  than all of them in one frame; the visibility pass moves one coming into
  view to the time first.
- A vessel's three positions are written from one surface point and normal
  (Cesium's own formula) instead of three fromDegrees calls; the unused
  normal is dropped. The great-circle step builds no arrays.

The pass falls from 4.6 ms to 0.37 ms a frame on average in a benchmark of
9,000 vessels (3,000 drawn) at 240 frames a second.
2026-11-15 13:35:11 -08:00
Sameh Khamis 8af8c086a6 render: hold continuous render while the world clock plays away from live
Playback moves something every frame, so it draws at the display's rate
rather than the parked scene's 60 FPS cap. followWorldTime reports when the
clock starts and stops playing (not live, not stepped, not waiting for data).
2026-11-15 13:35:11 -08:00
Sameh Khamis d49552af57 Merge remote-tracking branch 'origin/main' into flights/course-from-fixes
# Conflicts:
#	docs/CURRENT-STATE.md
#	scripts/package-boundaries.json
2026-11-15 11:26:28 -08:00
Sameh Khamis fc4db81d0b Course from fixes only moves forward in time, from an anchor fix, and not for a standing contact; military contacts too
A fix that is not a second newer (a repeat, or an older position from another
feed) never gives a course, so a source switch cannot turn an aircraft
around. The course runs from an anchor fix that moves only when a course is
read, so frequent short steps add up, and a contact reported under 2 m/s
reads none. The helper moves to src/data/courseFromFixes.js and the military
records use it as well.
2026-11-15 11:19:58 -08:00
Sameh Khamis e08dcd0326 Changelog fragment for #1753 2026-11-15 11:11:42 -08:00