astraeus 0.6.0 → 0.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (60) hide show
  1. package/CHANGELOG.md +16 -0
  2. package/README.md +31 -8
  3. package/package.json +1 -1
  4. package/src/api/AstraeusScene.d.ts +4 -2
  5. package/src/api/AstraeusScene.js +13 -10
  6. package/src/api/AstraeusScene.node.js +13 -10
  7. package/src/api/errors.d.ts +1 -1
  8. package/src/api/index.d.ts +1 -0
  9. package/src/api/mount.d.ts +5 -1
  10. package/src/api/mount.js +2 -0
  11. package/src/api/mount.node.js +2 -0
  12. package/src/api/pathProvenance.d.ts +15 -6
  13. package/src/api/pathProvenance.js +23 -11
  14. package/src/api/scene.d.ts +18 -1
  15. package/src/api/scene.js +88 -10
  16. package/src/api/sphereOfInfluence.d.ts +20 -0
  17. package/src/api/sphereOfInfluence.js +48 -0
  18. package/src/api/viewerLink.d.ts +7 -1
  19. package/src/api/viewerLink.js +13 -2
  20. package/src/api/views.d.ts +42 -0
  21. package/src/api/views.js +80 -0
  22. package/src/app/App.js +32 -5
  23. package/src/app/App.node.js +32 -5
  24. package/src/app/AstraeusScene.d.ts +3 -0
  25. package/src/app/CameraController.d.ts +6 -0
  26. package/src/app/CameraController.js +3 -1
  27. package/src/app/StoryMarkers.d.ts +4 -1
  28. package/src/app/StoryMarkers.js +3 -2
  29. package/src/app/TrackedBodyView.d.ts +1 -1
  30. package/src/app/TrackedBodyView.js +20 -11
  31. package/src/app/experienceDefinition.d.ts +3 -0
  32. package/src/app/mission.d.ts +15 -2
  33. package/src/app/mission.js +15 -0
  34. package/src/app/sceneCamera.d.ts +2 -0
  35. package/src/app/sceneCamera.js +14 -0
  36. package/src/app/sceneFrame.d.ts +2 -0
  37. package/src/app/sceneFrame.js +42 -6
  38. package/src/app/viewHiding.d.ts +13 -0
  39. package/src/app/viewHiding.js +37 -0
  40. package/src/app/viewerPort.d.ts +6 -0
  41. package/src/app/views.d.ts +31 -0
  42. package/src/app/views.js +2 -0
  43. package/src/shell/AstraeusShell.d.ts +12 -2
  44. package/src/shell/AstraeusShell.js +42 -4
  45. package/src/shell/AstraeusShell.node.js +42 -4
  46. package/src/shell/DisplaySwitches.d.ts +18 -1
  47. package/src/shell/DisplaySwitches.js +18 -5
  48. package/src/shell/TimelineBar.css +18 -0
  49. package/src/shell/TimelineBar.js +29 -4
  50. package/src/shell/TimelineBar.node.js +29 -4
  51. package/src/shell/TopBar.d.ts +4 -2
  52. package/src/shell/TopBar.js +3 -3
  53. package/src/shell/TopBar.node.js +3 -3
  54. package/src/shell/timelineModel.d.ts +13 -0
  55. package/src/shell/timelineModel.js +25 -0
  56. package/src/shell/viewCamera.d.ts +4 -0
  57. package/src/shell/viewCamera.js +13 -0
  58. package/src/synthetic/syntheticJourneyScene.js +11 -1
  59. package/src/synthetic/syntheticViewsDefinition.d.ts +6 -0
  60. package/src/synthetic/syntheticViewsDefinition.js +44 -0
@@ -27,6 +27,7 @@ import { resolveSkySettings, withSkyObject } from "./skyModel.js";
27
27
  import { ORBIT_LOOK_LIMITS, resolveOrbitLook } from "../assets/orbitLook.js";
28
28
  import { DEFAULT_BODY_SET_LOOK } from "./bodySet.js";
29
29
  import { displaySwitchItems, orbitStart } from "./displaySwitches.js";
30
+ import { experienceInView, hiddenByView, viewById } from "./viewHiding.js";
30
31
  import { baseGlowOf, glowLookFromSearch, markerSettingsFromSearch } from "./bodyDraw.js";
31
32
  import { brightnessFromSearch, milkyWayFromSearch, skyHiddenBySearch } from "./SkyView.js";
32
33
  /** Frames-per-second readings kept for the graph: one per 250 ms poll, so about 15 seconds. */
@@ -137,6 +138,7 @@ function initialSceneControls(definition, runtime, experience, startScale, glowB
137
138
  hiddenLabels: hiddenLabelsFrom(search, labelStart(definition) === undefined ? experience.objects : experience.objects.map(({ id }) => ({ id, showLabel: labelStart(definition) }))),
138
139
  ...startOrbitControls(definition),
139
140
  labelObjects: experience.objects,
141
+ viewHidden: hiddenByView(definition.views, viewById(definition.views, definition.views?.start ?? ""), experience),
140
142
  storyMarkers,
141
143
  featureMarkers: featureMarkerSpecs(definition.experience.bodyFeatures),
142
144
  featureMinBodyPx: featureMinBodyPxFromSearch(search),
@@ -182,7 +184,11 @@ export function App({ definition, onOpenAddress, writeTitle = true, host }) {
182
184
  });
183
185
  return () => { cancelled = true; };
184
186
  }, []);
185
- const shellExperience = useMemo(() => withSkyObject(experience, runtime.sky.visible, starStatus), [experience, runtime.sky.visible, starStatus]);
187
+ // The current view (App state, like the display switches). The shell's lists read one experience, filtered here once; the scene hides the same ids from `controls.viewHidden`.
188
+ const [viewId, setViewId] = useState(() => definition.views?.start ?? "");
189
+ const currentView = useMemo(() => viewById(definition.views, viewId), [definition.views, viewId]);
190
+ const viewExperience = useMemo(() => experienceInView(experience, definition.views, currentView), [experience, definition.views, currentView]);
191
+ const shellExperience = useMemo(() => withSkyObject(viewExperience, runtime.sky.visible, starStatus), [viewExperience, runtime.sky.visible, starStatus]);
186
192
  const metricsFor = useMemo(() => definition.createMetrics(experienceRuntime), [definition, experienceRuntime]);
187
193
  const glowBase = useMemo(() => baseGlowOf(runtime.bodies.map((id) => runtime.catalogue.get(id))), [runtime]);
188
194
  const storySet = definition.experience.storyPanels;
@@ -244,6 +250,7 @@ export function App({ definition, onOpenAddress, writeTitle = true, host }) {
244
250
  const updateCameraRequest = useCallback((request) => {
245
251
  controls.current.cameraRequest = request;
246
252
  }, []);
253
+ const holdCamera = useCallback(() => { controls.current.cameraRequest = { kind: "hold" }; }, []);
247
254
  const requestPanel = useCallback((id) => setPanelRequest((previous) => ({ id, serial: (previous?.serial ?? 0) + 1 })), []);
248
255
  const requestPick = useCallback((id) => setPickRequest((previous) => ({ id, serial: (previous?.serial ?? 0) + 1 })), []);
249
256
  const requestFeature = useCallback((key) => setFeatureRequest((previous) => ({ key, serial: (previous?.serial ?? 0) + 1 })), []);
@@ -266,7 +273,19 @@ export function App({ definition, onOpenAddress, writeTitle = true, host }) {
266
273
  controls.current.policy = scalePolicyFor(id, suppliedPolicies);
267
274
  setScale(id);
268
275
  }, [suppliedPolicies]);
269
- const stateNow = useCallback(() => ({ ...runtime.clock.snapshot(), ...(runtime.pacing === undefined ? {} : { auto: controls.current.paceAuto === true }) }), [runtime]);
276
+ // The view showing is read from a ref set at the switch, so a publish right after a switch already names the new view.
277
+ const viewRef = useRef(viewId);
278
+ const chooseView = useCallback((id) => {
279
+ viewRef.current = id;
280
+ controls.current.viewHidden = hiddenByView(definition.views, viewById(definition.views, id), experience);
281
+ setViewId(id);
282
+ }, [definition, experience]);
283
+ const viewIds = useMemo(() => definition.views?.views.map((view) => view.id) ?? [], [definition]);
284
+ const stateNow = useCallback(() => ({
285
+ ...runtime.clock.snapshot(),
286
+ ...(runtime.pacing === undefined ? {} : { auto: controls.current.paceAuto === true }),
287
+ ...(definition.views === undefined ? {} : { view: viewRef.current }),
288
+ }), [runtime, definition]);
270
289
  useEffect(() => {
271
290
  const id = window.setInterval(() => {
272
291
  // The readout wraps with the scene, so the shown time never rests past the end while looping.
@@ -302,9 +321,9 @@ export function App({ definition, onOpenAddress, writeTitle = true, host }) {
302
321
  useEffect(() => {
303
322
  if (host === undefined)
304
323
  return undefined;
305
- host.attach({ window: runtime.loopWindow, rates: definition.experience.rates, paced: runtime.pacing !== undefined, read: stateNow, seek: seekTo, setRate: changeRate });
324
+ host.attach({ window: runtime.loopWindow, rates: definition.experience.rates, paced: runtime.pacing !== undefined, read: stateNow, seek: seekTo, setRate: changeRate, views: viewIds, setView: chooseView });
306
325
  return () => host.detach();
307
- }, [host, runtime, definition, seekTo, changeRate]);
326
+ }, [host, runtime, definition, seekTo, changeRate, viewIds, chooseView]);
308
327
  useEffect(() => {
309
328
  if (!developerMode)
310
329
  return undefined;
@@ -333,6 +352,14 @@ export function App({ definition, onOpenAddress, writeTitle = true, host }) {
333
352
  return;
334
353
  setViewLink(await shareViewLink({ view, scaleId: scale, up: upChoice, timeUtcMs: runtime.clock.snapshot().timeUtcMs }));
335
354
  };
355
+ const viewChoice = definition.views === undefined ? undefined : {
356
+ place: definition.views.place,
357
+ options: definition.views.views.map((view) => ({ id: view.id, label: view.label, active: view.id === currentView?.id })),
358
+ onSelect: (id) => {
359
+ chooseView(id);
360
+ host?.publish(stateNow(), "visitor");
361
+ },
362
+ };
336
363
  const displaySwitches = displaySwitchItems({
337
364
  settings: definition.displaySwitches,
338
365
  orbit: { present: orbitPaths.length > 0, look: orbitShown, set: setOrbit },
@@ -433,5 +460,5 @@ export function App({ definition, onOpenAddress, writeTitle = true, host }) {
433
460
  }, onSeek: (timeUtcMs) => {
434
461
  seekTo(timeUtcMs);
435
462
  host?.publish(stateNow(), "visitor");
436
- }, onCameraRequest: updateCameraRequest, onSelectionChange: updateSelectedObject, scaleId: scale, onScaleChange: updateScale, scaleChoices: scaleChoices, switcher: switcherOf(definition, runtime, onOpenAddress), displaySwitches: displaySwitches, metricsFor: metricsFor, developerTools: developerTools, storyPanelSettings: { autoOpen: storyAutoOpen, pauseSeconds: storyPauseSeconds }, timelineGlow: timelineGlow, phoneLayout: phoneLayout, highlightedFamily: setLook.highlightFamily, onHighlightFamily: highlightFamily, onSetPlaying: setPlaying, panelRequest: panelRequest, onOpenPanelChange: markOpenPanel, featureRequest: featureRequest, pickRequest: pickRequest, onOpenFeatureChange: markOpenFeature, children: _jsx("div", { className: "canvas-host", children: _jsx(AstraeusScene, { runtime: runtime, controls: controls.current, readout: readout, scaleId: scale }) }) }));
463
+ }, onCameraRequest: updateCameraRequest, onCameraHold: holdCamera, onSelectionChange: updateSelectedObject, scaleId: scale, onScaleChange: updateScale, scaleChoices: scaleChoices, switcher: switcherOf(definition, runtime, onOpenAddress), displaySwitches: displaySwitches, viewChoice: viewChoice, viewCamera: currentView === undefined ? undefined : { id: currentView.id, rule: currentView.camera }, metricsFor: metricsFor, developerTools: developerTools, storyPanelSettings: { autoOpen: storyAutoOpen, pauseSeconds: storyPauseSeconds }, timelineGlow: timelineGlow, phoneLayout: phoneLayout, highlightedFamily: setLook.highlightFamily, onHighlightFamily: highlightFamily, onSetPlaying: setPlaying, panelRequest: panelRequest, onOpenPanelChange: markOpenPanel, featureRequest: featureRequest, pickRequest: pickRequest, onOpenFeatureChange: markOpenFeature, children: _jsx("div", { className: "canvas-host", children: _jsx(AstraeusScene, { runtime: runtime, controls: controls.current, readout: readout, scaleId: scale }) }) }));
437
464
  }
@@ -1,3 +1,4 @@
1
+ import type { ViewHidden } from "./viewHiding.js";
1
2
  import type { SimulationClock } from "../core/clock.js";
2
3
  import type { Pacing } from "../core/pacing.js";
3
4
  import type { BodyId } from "../core/body.js";
@@ -99,6 +100,8 @@ export interface SceneControls {
99
100
  up?: RenderVector;
100
101
  /** Ids of objects whose label is switched off (live). Their objects stay listed and selectable. */
101
102
  hiddenLabels?: Set<string>;
103
+ /** Presentation only (views): the ids the current view hides, read by the frame stages (groups, labels, picking, story markers). Absent or empty: everything shows. Replaced, never edited, on a switch. */
104
+ viewHidden?: ViewHidden;
102
105
  readonly labelObjects: readonly ExperienceObject[];
103
106
  /** Objects that story panels name; each gets a marker that reopens its panel. */
104
107
  readonly storyMarkers?: readonly StoryMarkerSpec[];
@@ -10,6 +10,10 @@ export type CameraRequest = {
10
10
  readonly target: FocusId;
11
11
  } | {
12
12
  readonly kind: "overview";
13
+ }
14
+ /** Holds the camera where it is: its target becomes the point it looks at now, fixed in the scene frame; the pose is kept. A later focus, follow or overview request replaces it. */
15
+ | {
16
+ readonly kind: "hold";
13
17
  };
14
18
  export interface OrbitCameraState {
15
19
  azimuth: number;
@@ -20,6 +24,8 @@ export interface OrbitCameraState {
20
24
  distance: number;
21
25
  targetDistance: number;
22
26
  focus: FocusId;
27
+ /** Set by a `hold` request: the target stays at this scaled point (scene frame, render axes) whatever `focus` does, until a new focus request clears it. */
28
+ fixedPoint: [number, number, number] | null;
23
29
  /** Decaying offset that tweens the displayed target from the previous focus to the new one. */
24
30
  transition: [number, number, number];
25
31
  /** Scaled absolute camera/target positions (Float64, render axes) for the latest frame. */
@@ -9,6 +9,7 @@ export function createOrbitCameraState(distance, focus) {
9
9
  distance,
10
10
  targetDistance: distance,
11
11
  focus,
12
+ fixedPoint: null,
12
13
  transition: [0, 0, 0],
13
14
  cameraAbsolute: [0, 0, 0],
14
15
  targetAbsolute: [0, 0, 0],
@@ -114,11 +115,12 @@ function pointerSpread(pointers) {
114
115
  }
115
116
  /** Starts a tween from the currently displayed target to a new focus without moving the camera. */
116
117
  export function switchFocus(state, focus, newTargetAbsolute) {
117
- if (focus === state.focus)
118
+ if (focus === state.focus && state.fixedPoint === null)
118
119
  return;
119
120
  for (let i = 0; i < 3; i += 1)
120
121
  state.transition[i] = state.targetAbsolute[i] - newTargetAbsolute[i];
121
122
  state.focus = focus;
123
+ state.fixedPoint = null;
122
124
  }
123
125
  /**
124
126
  * Step 1 (before bodies are placed): computes the absolute target/camera in Float64 render axes
@@ -33,6 +33,9 @@ export declare function panelForMarkerPress(group: StoryMarkerGroup, timeUtcMs:
33
33
  export declare class StoryMarkerLayer {
34
34
  #private;
35
35
  constructor(host: HTMLElement, specs: readonly StoryMarkerSpec[], onOpen: (panelId: string) => void);
36
- update(positionFor: (objectId: string) => RenderVector | null, camera: Camera, widthPx: number, heightPx: number, origin: FloatingOrigin, openPanelId: string | null, timeUtcMs: number): void;
36
+ update(positionFor: (objectId: string) => RenderVector | null, camera: Camera, widthPx: number, heightPx: number, origin: FloatingOrigin, openPanelId: string | null, timeUtcMs: number, hidden?: {
37
+ readonly objects: ReadonlySet<string>;
38
+ readonly panels: ReadonlySet<string>;
39
+ }): void;
37
40
  dispose(): void;
38
41
  }
@@ -61,12 +61,13 @@ export class StoryMarkerLayer {
61
61
  });
62
62
  host.appendChild(this.#root);
63
63
  }
64
- update(positionFor, camera, widthPx, heightPx, origin, openPanelId, timeUtcMs) {
64
+ update(positionFor, camera, widthPx, heightPx, origin, openPanelId, timeUtcMs, hidden) {
65
65
  this.#timeUtcMs = timeUtcMs;
66
66
  this.#openPanelId = openPanelId;
67
67
  camera.updateMatrixWorld(true);
68
68
  for (const { group, element } of this.#entries) {
69
- const absolute = positionFor(group.objectId);
69
+ // A marker the current view owns no panel of, or on an object the view hides, is not drawn.
70
+ const absolute = hidden?.objects.has(group.objectId) === true || group.panels.every((panel) => hidden?.panels.has(panel.panelId) === true) ? null : positionFor(group.objectId);
70
71
  const screen = absolute === null ? null : projectToScreen(this.#local.fromArray(origin.toLocal(absolute)), camera, widthPx, heightPx);
71
72
  element.hidden = screen === null;
72
73
  if (screen === null)
@@ -23,7 +23,7 @@ export declare function releaseAnchorSprite(): void;
23
23
  export declare class TrackedBodyView {
24
24
  #private;
25
25
  readonly body: TrackedBody;
26
- /** Every tracked body's path is one rule, a relative trail (`pathRules.ts`); the body it is drawn against is the path's own `lineFixedTo`, default the scene centre. */
26
+ /** Every tracked body's path is one rule, a relative trail (`pathRules.ts`); the body it is drawn against is the path's own `lineFixedTo` (one body or per-stretch), default the scene centre. */
27
27
  static readonly pathRule: PathRule;
28
28
  readonly group: Group<import("three").Object3DEventMap>;
29
29
  /** Anchor labels in anchor order, or null when the body has none. */
@@ -1,6 +1,6 @@
1
1
  import { BufferAttribute, BufferGeometry, DataTexture, Group, Line, LineBasicMaterial, Mesh, MeshBasicMaterial, Points, RGBAFormat, SphereGeometry, Vector3, } from "three";
2
2
  import { dotMaterial } from "./dotMaterial.js";
3
- import { anchorLabelsOf, markerRadiusUnits, sampleTrackedPositions, stateClampedToBounds, stateIfInBounds, travelledCount } from "./mission.js";
3
+ import { anchorLabelsOf, markerRadiusUnits, lineAgainstAt, lineBodies, sampleTrackedPositions, stateClampedToBounds, stateIfInBounds, travelledCount } from "./mission.js";
4
4
  import { mapPathKm, relativeTrailKm, shiftedBy } from "./pathRules.js";
5
5
  import { eqjToRenderVector } from "./renderCoordinates.js";
6
6
  import { sceneOffsetKm, trackedAbsolute } from "./sceneLayout.js";
@@ -55,7 +55,7 @@ export function releaseAnchorSprite() {
55
55
  */
56
56
  export class TrackedBodyView {
57
57
  body;
58
- /** Every tracked body's path is one rule, a relative trail (`pathRules.ts`); the body it is drawn against is the path's own `lineFixedTo`, default the scene centre. */
58
+ /** Every tracked body's path is one rule, a relative trail (`pathRules.ts`); the body it is drawn against is the path's own `lineFixedTo` (one body or per-stretch), default the scene centre. */
59
59
  static pathRule = Object.freeze({ kind: "trail", frame: "relative" });
60
60
  group = new Group();
61
61
  #marker;
@@ -131,7 +131,7 @@ export class TrackedBodyView {
131
131
  */
132
132
  #remap(policy, placement, timeUtcMs) {
133
133
  const placed = placement.center;
134
- const moves = this.#against(placement) !== placed;
134
+ const moves = lineBodies(this.body.lineFixedTo).some(({ body }) => body !== placed);
135
135
  if (this.#mappedFor === policy.id && this.#placedFor === placed && (!moves || this.#mappedAt === timeUtcMs))
136
136
  return;
137
137
  this.#mappedPath = mapPathKm(this.#relative(this.#samples, placement, timeUtcMs), policy);
@@ -140,16 +140,25 @@ export class TrackedBodyView {
140
140
  this.#placedFor = placed;
141
141
  this.#mappedAt = timeUtcMs;
142
142
  }
143
- #against(placement) {
144
- return this.body.lineFixedTo ?? placement.center;
145
- }
143
+ /** Each run of samples drawn against one body (a plain `lineFixedTo` is one run) is placed from that body at its own times, then carried to the scene centre at the display time. */
146
144
  #relative(samples, placement, timeUtcMs) {
147
- if (samples.timesUtcMs.length === 0)
145
+ const count = samples.timesUtcMs.length;
146
+ if (count === 0)
148
147
  return samples.positionsKm;
149
- const against = this.#against(placement);
150
- const drawn = relativeTrailKm(samples, this.body.trajectory.stateAt(samples.timesUtcMs[0]).center, placement, against);
151
- const carry = sceneOffsetKm(placement, against, timeUtcMs);
152
- return carry === null ? drawn : shiftedBy(drawn, carry);
148
+ const native = this.body.trajectory.stateAt(samples.timesUtcMs[0]).center;
149
+ const out = new Float64Array(samples.positionsKm.length);
150
+ for (let from = 0; from < count;) {
151
+ const against = lineAgainstAt(this.body.lineFixedTo, samples.timesUtcMs[from], placement.center);
152
+ let to = from + 1;
153
+ while (to < count && lineAgainstAt(this.body.lineFixedTo, samples.timesUtcMs[to], placement.center) === against)
154
+ to += 1;
155
+ const run = { timesUtcMs: samples.timesUtcMs.slice(from, to), positionsKm: samples.positionsKm.subarray(from * 3, to * 3) };
156
+ const drawn = relativeTrailKm(run, native, placement, against);
157
+ const carry = sceneOffsetKm(placement, against, timeUtcMs);
158
+ out.set(carry === null ? drawn : shiftedBy(drawn, carry), from * 3);
159
+ from = to;
160
+ }
161
+ return out;
153
162
  }
154
163
  /** Writes [leading?] samples [from, to) [trailing?] into the line and sets how much of it is drawn. */
155
164
  #fillPath(line, from, to, leading, trailing, origin) {
@@ -16,6 +16,7 @@ import type { TrackedBody } from "./mission.js";
16
16
  import type { SkySettings } from "../assets/sky.js";
17
17
  import { type BodySetLayer } from "./bodySet.js";
18
18
  import type { DisplaySwitchSettings } from "./displaySwitches.js";
19
+ import type { ViewSettings } from "./views.js";
19
20
  /** Generic scene parts an experience opts into. Nothing here names a mission. */
20
21
  export type SceneLayerId = "tracked-bodies" | "points" | "sun-centred";
21
22
  /** What the generic app owns and hands to the experience's factories. */
@@ -213,6 +214,8 @@ export interface ExperienceDefinition {
213
214
  readonly switcher?: import("../shell/SwitchControl.js").ExperienceSwitch;
214
215
  /** Where the orbit-lines, labels and Milky Way switches show (top bar, switch panel or the Developer drawer only) and whether each starts on. Absent: all in the Developer drawer, the scene's own start. The address (`?labels=`, `?sky=`) still overrides the start. */
215
216
  readonly displaySwitches?: DisplaySwitchSettings;
217
+ /** Named views of this one scene (presentation only), resolved once: per view, the object, event and story-panel ids it shows. Anything no view names is in every view. Absent: no views, everything shows. */
218
+ readonly views?: ViewSettings;
216
219
  /** Which direction the camera treats as up (default "equatorial", celestial north; "ecliptic" orbits about the ecliptic pole so the planets' plane reads flat). */
217
220
  readonly viewUp?: import("./viewUp.js").ViewUp;
218
221
  /** The camera view to open on (focus id, azimuth and elevation in degrees, distance in scaled units). Absent: the usual opening. `?view=` overrides it. */
@@ -4,6 +4,19 @@ import type { Provenance } from "../core/provenance.js";
4
4
  import type { State } from "../core/state.js";
5
5
  import type { TimeBounds, Trajectory } from "../core/trajectory.js";
6
6
  import type { PathSamples } from "./pathRules.js";
7
+ /** One stretch of a path's line, `[startUtcMs, endUtcMs)` (the last may include its end), drawn against `body`. */
8
+ export interface LineStretch {
9
+ readonly startUtcMs: number;
10
+ readonly endUtcMs: number;
11
+ readonly body: string;
12
+ }
13
+ /** The body a path's line is drawn against at `timeUtcMs`: the one named, the covering stretch's, or `fallback` (the scene centre). A shared boundary belongs to the later stretch. */
14
+ export declare function lineAgainstAt(lineFixedTo: TrackedBody["lineFixedTo"], timeUtcMs: number, fallback: string): string;
15
+ /** Every body a path's line is drawn against, in order, with the `lineFixedTo` index of each (a plain id is index null). */
16
+ export declare function lineBodies(lineFixedTo: TrackedBody["lineFixedTo"]): readonly {
17
+ readonly index: number | null;
18
+ readonly body: string;
19
+ }[];
7
20
  /** A bounded trajectory the scene can draw. Nothing here names a mission. */
8
21
  export interface TrackedBody {
9
22
  readonly id: string;
@@ -20,8 +33,8 @@ export interface TrackedBody {
20
33
  readonly anchorLabels?: readonly string[];
21
34
  /** Published position discrepancy per reconstruction segment, in time order. */
22
35
  readonly positionDiscrepancies?: readonly PositionDiscrepancy[];
23
- /** The body the line is drawn against, at each sample's own time; absent: the scene centre. */
24
- readonly lineFixedTo?: string;
36
+ /** The body the line is drawn against, at each sample's own time; absent: the scene centre. A list draws each stretch against its own body (time outside every stretch: the scene centre). */
37
+ readonly lineFixedTo?: string | readonly LineStretch[];
25
38
  /** The trajectory's own Provenance, passed through unchanged. */
26
39
  readonly provenance?: Provenance;
27
40
  }
@@ -1,3 +1,18 @@
1
+ /** The body a path's line is drawn against at `timeUtcMs`: the one named, the covering stretch's, or `fallback` (the scene centre). A shared boundary belongs to the later stretch. */
2
+ export function lineAgainstAt(lineFixedTo, timeUtcMs, fallback) {
3
+ if (lineFixedTo === undefined)
4
+ return fallback;
5
+ if (typeof lineFixedTo === "string")
6
+ return lineFixedTo;
7
+ const last = lineFixedTo[lineFixedTo.length - 1];
8
+ return lineFixedTo.find((stretch) => timeUtcMs >= stretch.startUtcMs && timeUtcMs < stretch.endUtcMs)?.body ?? (last !== undefined && timeUtcMs === last.endUtcMs ? last.body : fallback);
9
+ }
10
+ /** Every body a path's line is drawn against, in order, with the `lineFixedTo` index of each (a plain id is index null). */
11
+ export function lineBodies(lineFixedTo) {
12
+ if (lineFixedTo === undefined)
13
+ return [];
14
+ return typeof lineFixedTo === "string" ? [{ index: null, body: lineFixedTo }] : lineFixedTo.map((stretch, index) => ({ index, body: stretch.body }));
15
+ }
1
16
  /** The segment covering `timeUtcMs`; a shared boundary belongs to the later segment. */
2
17
  export function discrepancyAt(body, timeUtcMs) {
3
18
  const segments = body.positionDiscrepancies ?? [];
@@ -27,6 +27,8 @@ export interface CameraStepInput {
27
27
  }
28
28
  /** Keeps the same relative framing when the visual scale changes (physical state is untouched). */
29
29
  export declare function rescaleCameraForPolicy(camState: OrbitCameraState, sceneCenter: BodyId, factor: number): void;
30
+ /** Where the camera's target is this frame: the held point after a `hold` request, else the focus. */
31
+ export declare function cameraTargetAbsolute(camState: OrbitCameraState, targets: SceneTargets): RenderVector;
30
32
  /**
31
33
  * One frame of camera decisions before the camera is posed: the opening view, a pending request, a change of up, and the zoom limits.
32
34
  * Returns the body (or other id) the camera is focused on.
@@ -9,6 +9,13 @@ export function rescaleCameraForPolicy(camState, sceneCenter, factor) {
9
9
  camState.distance *= factor;
10
10
  for (let i = 0; i < 3; i += 1)
11
11
  camState.transition[i] *= factor;
12
+ if (camState.fixedPoint !== null)
13
+ for (let i = 0; i < 3; i += 1)
14
+ camState.fixedPoint[i] *= factor;
15
+ }
16
+ /** Where the camera's target is this frame: the held point after a `hold` request, else the focus. */
17
+ export function cameraTargetAbsolute(camState, targets) {
18
+ return camState.fixedPoint ?? focusAbsoluteOf(targets, camState.focus);
12
19
  }
13
20
  /** An explicit start view wins over the overview rule: the camera opens exactly there (the zoom limits still apply). */
14
21
  function applyStartView(camState, view) {
@@ -66,6 +73,13 @@ function faceParent(camState, targets, viewUp, body, parent) {
66
73
  }
67
74
  function applyCameraRequest(input, request) {
68
75
  const { camState, targets, frame, catalogue, viewUp } = input;
76
+ if (request.kind === "hold") {
77
+ // The target stops where it is (including any tween still running); angles and distance are untouched. Scene-frame state only: nothing in State changes.
78
+ const now = cameraTargetAbsolute(camState, targets);
79
+ camState.fixedPoint = [now[0] + camState.transition[0], now[1] + camState.transition[1], now[2] + camState.transition[2]];
80
+ camState.transition.fill(0);
81
+ return;
82
+ }
69
83
  const target = request.kind === "overview" ? frame.centre : request.target;
70
84
  const targetBody = targets.bodyIdFor(target);
71
85
  switchFocus(camState, target, focusAbsoluteOf(targets, target));
@@ -142,6 +142,8 @@ export declare function publishOrbitHeadGap(canvas: HTMLCanvasElement, views: re
142
142
  export declare function publishCanvasReadouts(ctx: FrameContext): void;
143
143
  /** Stage 5: places every view about the floating origin and publishes the views' readouts. Returns the hover brightness gain. */
144
144
  export declare function placeViews(ctx: FrameContext, t: number, placed: PlacedScene, setLook: BodySetLook): number;
145
+ /** Stage 5b: shows or hides each drawn group by the current view's hidden ids (bodies, paths, point groups, body sets). One set, read here; nothing is rebuilt. */
146
+ export declare function applyViewVisibility(ctx: FrameContext): void;
145
147
  /** A mounted body's drawn sphere and radius for the feature markers, or null when the body is not drawn as a sphere. */
146
148
  export declare function featureHostOf(assets: readonly BodyAsset[], parts: ReadonlyMap<BodyId, BodyParts>, id: string, policy: ScalePolicy): FeatureHost | null;
147
149
  /** Stage 6: updates the overlay layers (names, story and feature markers) and rebuilds what a tap or hover can pick. */
@@ -5,7 +5,7 @@ import { applyPacing } from "../core/pacing.js";
5
5
  import { poseCamera, resolveCamera } from "./CameraController.js";
6
6
  import { DEFAULT_CAMERA_FAR } from "./experienceDefinition.js";
7
7
  import { DEFAULT_FEATURE_MIN_BODY_PX } from "./FeatureMarkers.js";
8
- import { rescaleCameraForPolicy, stepCameraTarget } from "./sceneCamera.js";
8
+ import { cameraTargetAbsolute, rescaleCameraForPolicy, stepCameraTarget } from "./sceneCamera.js";
9
9
  import { buildFrameReadout, publishBodyData, publishPathData, publishPointsData, publishSceneData, recordFrameStats } from "./sceneDebug.js";
10
10
  import { focusRadius, liveReach } from "./sceneFraming.js";
11
11
  import { bodyScreenReadouts, placeBodies, swapSmallBodiesToMarkers } from "./sceneBodies.js";
@@ -14,7 +14,7 @@ import { bodyAbsolute, placeComposition } from "./sceneLayout.js";
14
14
  import { placeBodyLights } from "./sceneLights.js";
15
15
  import { clampHoverBrightness, HOVER_BRIGHTNESS_DEFAULT, hoverTarget, pickCandidatesOf } from "./scenePicking.js";
16
16
  import { updateSky } from "./sceneSky.js";
17
- import { focusAbsoluteOf, labelPositionOf } from "./sceneTargets.js";
17
+ import { labelPositionOf } from "./sceneTargets.js";
18
18
  import { viewFromAngles } from "./viewLink.js";
19
19
  import { EQUATORIAL_UP } from "./viewUp.js";
20
20
  /** Floating-origin rebase threshold in scaled units (Earth radii). */
@@ -103,7 +103,7 @@ export function stepAndPoseCamera(ctx, t, placed) {
103
103
  const reach = liveReach(runtime.cameraReach, policy, camera.aspect);
104
104
  const focusBody = stepCameraTarget({ camState: orbit, controls, targets, frame, catalogue, reach, fovDeg: camera.fov, viewUp, firstFrame, previousUp: state.lastUp });
105
105
  state.lastUp = viewUp;
106
- resolveCamera(orbit, focusAbsoluteOf(targets, orbit.focus), ctx.origin, ctx.delta, REBASE_THRESHOLD, viewUp);
106
+ resolveCamera(orbit, cameraTargetAbsolute(orbit, targets), ctx.origin, ctx.delta, REBASE_THRESHOLD, viewUp);
107
107
  placeBodies(ctx.assets, placed.composed.states, ctx.bodyRefs, policy, ctx.origin);
108
108
  poseCamera(camera, orbit, focusRadius(focusBody, policy, catalogue), ctx.origin, reach.far ?? DEFAULT_CAMERA_FAR, viewUp);
109
109
  if (firstFrame)
@@ -156,12 +156,46 @@ export function placeViews(ctx, t, placed, setLook) {
156
156
  publishPointsData(canvas, views.groupViews, camera, views.bodySetViews);
157
157
  return hoverGain;
158
158
  }
159
+ /** Stage 5b: shows or hides each drawn group by the current view's hidden ids (bodies, paths, point groups, body sets). One set, read here; nothing is rebuilt. */
160
+ export function applyViewVisibility(ctx) {
161
+ const hidden = ctx.controls.viewHidden?.objects;
162
+ const { views, bodyRefs } = ctx;
163
+ const show = (id, group) => { group.visible = hidden?.has(id) !== true; };
164
+ for (const [id, group] of bodyRefs.groups)
165
+ show(id, group);
166
+ for (const view of views.trackedViews)
167
+ show(view.body.id, view.group);
168
+ for (const view of views.groupViews)
169
+ show(view.id, view.group);
170
+ for (const view of views.sunCentredViews)
171
+ show(view.id, view.group);
172
+ // A line follows the body or set it belongs to (the link the line already carries), so a view never names orbit lines.
173
+ const showOwned = (id, owner, group) => { group.visible = hidden?.has(id) !== true && hidden?.has(owner) !== true; };
174
+ for (const view of views.compositionPaths)
175
+ showOwned(view.id, String(view.layer.source.body), view.group);
176
+ for (const view of views.bodySetViews)
177
+ show(view.id, view.group);
178
+ for (const view of views.orbitSetViews)
179
+ showOwned(view.id, view.layer.id, view.group);
180
+ }
159
181
  /** A mounted body's drawn sphere and radius for the feature markers, or null when the body is not drawn as a sphere. */
160
182
  export function featureHostOf(assets, parts, id, policy) {
161
183
  const sphere = parts.get(id)?.sphere;
162
184
  const asset = assets.find((candidate) => candidate.definition.id === id);
163
185
  return sphere === undefined || asset === undefined ? null : { sphere, radius: drawnRadii(asset.definition, policy).equatorial };
164
186
  }
187
+ /** What the labels and taps see under the current view: the objects and body sets it shows, and the label-hidden ids with the view's own added. Allocates only when a view hides something. */
188
+ function shownUnderView(ctx) {
189
+ const { controls, views } = ctx;
190
+ const hidden = controls.viewHidden?.objects;
191
+ if (hidden === undefined || hidden.size === 0)
192
+ return { objects: controls.labelObjects, bodySetViews: views.bodySetViews, hiddenLabels: controls.hiddenLabels };
193
+ return {
194
+ objects: controls.labelObjects.filter((object) => !hidden.has(object.id)),
195
+ bodySetViews: views.bodySetViews.filter((view) => !hidden.has(view.id)),
196
+ hiddenLabels: new Set([...(controls.hiddenLabels ?? []), ...hidden]),
197
+ };
198
+ }
165
199
  /** Stage 6: updates the overlay layers (names, story and feature markers) and rebuilds what a tap or hover can pick. */
166
200
  export function updateOverlays(ctx, t, step, hoverGain) {
167
201
  const { controls, camera, canvas, size, origin, state, layers } = ctx;
@@ -169,13 +203,14 @@ export function updateOverlays(ctx, t, step, hoverGain) {
169
203
  publishBodyData(canvas, bodyScreens);
170
204
  layers.anchorLabels.current?.update(controls.showAnchorLabels, camera, size.width, size.height);
171
205
  const positionFor = (id) => labelPositionOf(step.targets, id);
172
- layers.sceneLabels.current?.update(positionFor, camera, size.width, size.height, origin, controls.selectedObjectId, controls.hiddenLabels);
173
- state.pickables = pickCandidatesOf({ objects: controls.labelObjects, bodyIdFor: ctx.bodyIdFor, bodyScreens, widthPx: size.width, heightPx: size.height, labelRects: layers.sceneLabels.current?.shownRects, canvas, bodySetViews: ctx.views.bodySetViews });
206
+ const shown = shownUnderView(ctx);
207
+ layers.sceneLabels.current?.update(positionFor, camera, size.width, size.height, origin, controls.selectedObjectId, shown.hiddenLabels);
208
+ state.pickables = pickCandidatesOf({ objects: shown.objects, bodyIdFor: ctx.bodyIdFor, bodyScreens, widthPx: size.width, heightPx: size.height, labelRects: layers.sceneLabels.current?.shownRects, canvas, bodySetViews: shown.bodySetViews });
174
209
  const hover = state.hoverPoint === null ? null : hoverTarget(state.pickables, state.hoverPoint.x, state.hoverPoint.y, "mouse");
175
210
  canvas.style.cursor = hover === null ? "" : "pointer";
176
211
  canvas.dataset.pickHover = hover ?? "";
177
212
  layers.sceneLabels.current?.setHover(hover, hoverGain);
178
- layers.storyMarkers.current?.update(positionFor, camera, size.width, size.height, origin, controls.openStoryPanelId ?? null, t);
213
+ layers.storyMarkers.current?.update(positionFor, camera, size.width, size.height, origin, controls.openStoryPanelId ?? null, t, controls.viewHidden);
179
214
  const featureReadout = layers.featureMarkers.current?.update((id) => featureHostOf(ctx.assets, ctx.bodyRefs.parts, id, controls.policy), camera, camera.fov, size.width, size.height, controls.openFeatureKey ?? null, controls.featureMinBodyPx ?? DEFAULT_FEATURE_MIN_BODY_PX);
180
215
  if (featureReadout !== null && featureReadout !== undefined)
181
216
  canvas.dataset.featureMarkers = JSON.stringify(featureReadout);
@@ -271,6 +306,7 @@ export function runFrame(ctx) {
271
306
  const placed = placeScene(ctx, t);
272
307
  const step = stepAndPoseCamera(ctx, t, placed);
273
308
  publishCanvasReadouts(ctx);
309
+ applyViewVisibility(ctx);
274
310
  const hoverGain = placeViews(ctx, t, placed, setLook);
275
311
  updateOverlays(ctx, t, step, hoverGain);
276
312
  placeLightsAndReadout(ctx, t, placed);
@@ -0,0 +1,13 @@
1
+ import type { ExperienceConfig } from "../shell/experience.js";
2
+ import type { ResolvedView, ViewSettings } from "./views.js";
3
+ /** The ids the current view hides: objects (bodies, paths, groups) and story panels. Empty sets: everything shows. */
4
+ export interface ViewHidden {
5
+ readonly objects: ReadonlySet<string>;
6
+ readonly panels: ReadonlySet<string>;
7
+ }
8
+ /** The view with this id, else the opening one; undefined for a scene without views. */
9
+ export declare function viewById(settings: ViewSettings | undefined, id: string): ResolvedView | undefined;
10
+ /** What `view` hides. A scene without views hides nothing. An object that belongs to a hidden one (`partOf`: a body's Sun-orbit line) is hidden with it, so a view never names orbit lines. */
11
+ export declare function hiddenByView(settings: ViewSettings | undefined, view: ResolvedView | undefined, experience?: ExperienceConfig): ViewHidden;
12
+ /** The experience as the view shows it: its objects, timeline events and story panels. The same object when there are no views, so a scene without views is untouched. */
13
+ export declare function experienceInView(experience: ExperienceConfig, settings: ViewSettings | undefined, view: ResolvedView | undefined): ExperienceConfig;
@@ -0,0 +1,37 @@
1
+ /** The view with this id, else the opening one; undefined for a scene without views. */
2
+ export function viewById(settings, id) {
3
+ return settings?.views.find((view) => view.id === id) ?? settings?.views.find((view) => view.id === settings.start);
4
+ }
5
+ /** The ids of `kind` some view shows and `view` does not. An id no view's set holds (the sky, an orbit line) is never the views' to hide. */
6
+ function hiddenIds(settings, view, kind) {
7
+ const hidden = new Set();
8
+ for (const other of settings.views)
9
+ for (const id of other[kind])
10
+ if (!view[kind].has(id))
11
+ hidden.add(id);
12
+ return hidden;
13
+ }
14
+ /** What `view` hides. A scene without views hides nothing. An object that belongs to a hidden one (`partOf`: a body's Sun-orbit line) is hidden with it, so a view never names orbit lines. */
15
+ export function hiddenByView(settings, view, experience) {
16
+ if (settings === undefined || view === undefined)
17
+ return { objects: new Set(), panels: new Set() };
18
+ const objects = new Set(hiddenIds(settings, view, "objects"));
19
+ for (const object of experience?.objects ?? [])
20
+ if (object.partOf !== undefined && objects.has(object.partOf))
21
+ objects.add(object.id);
22
+ return { objects, panels: hiddenIds(settings, view, "panels") };
23
+ }
24
+ /** The experience as the view shows it: its objects, timeline events and story panels. The same object when there are no views, so a scene without views is untouched. */
25
+ export function experienceInView(experience, settings, view) {
26
+ if (settings === undefined || view === undefined)
27
+ return experience;
28
+ const hiddenEvents = hiddenIds(settings, view, "events");
29
+ const { objects, panels } = hiddenByView(settings, view, experience);
30
+ const storySet = experience.storyPanels;
31
+ return {
32
+ ...experience,
33
+ objects: experience.objects.filter((object) => !objects.has(object.id)),
34
+ events: experience.events.filter((event) => !hiddenEvents.has(event.id)),
35
+ ...(storySet === undefined ? {} : { storyPanels: { ...storySet, panels: storySet.panels.filter((panel) => !panels.has(panel.id)) } }),
36
+ };
37
+ }
@@ -7,6 +7,8 @@ export interface ViewerState {
7
7
  readonly playing: boolean;
8
8
  /** Only in a scene with pacing: true while pacing sets the rate, false once a visitor or the host has picked a speed. */
9
9
  readonly auto?: boolean;
10
+ /** Only in a scene with views: the id of the view showing. */
11
+ readonly view?: string;
10
12
  }
11
13
  /** Who moved the clock: the clock running (`playback`), a person at the controls (`visitor`) or the host page (`host`). */
12
14
  export type ViewerChangeCause = "playback" | "visitor" | "host";
@@ -21,6 +23,10 @@ export interface ViewerControl {
21
23
  readonly paced: boolean;
22
24
  /** A number is a chosen speed; `"auto"` gives the rate back to the scene's pacing. */
23
25
  setRate(rate: number | "auto"): void;
26
+ /** The ids of the scene's views, in order; empty without views. */
27
+ readonly views: readonly string[];
28
+ /** Switches to the view with this id (one of `views`), as a visitor's button does. */
29
+ setView(id: string): void;
24
30
  }
25
31
  /** The viewer's side of the host link; the public API supplies the implementation (`ViewerLink`). */
26
32
  export interface ViewerPort {
@@ -0,0 +1,31 @@
1
+ /** Where the view choice shows: a button group in the top bar, or a row in the one switch panel opened from the bar (as for the display switches). */
2
+ export declare const VIEW_PLACES: readonly ["top-bar", "panel"];
3
+ export type ViewPlace = (typeof VIEW_PLACES)[number];
4
+ /** What the camera does when it switches to a view whose members no longer include what it follows or focuses on. `stay`: keep the pose and stop following. `start`: take the view's own framing, else the scene's start. */
5
+ export type ViewCameraRule = {
6
+ readonly rule: "stay";
7
+ } | {
8
+ readonly rule: "start";
9
+ readonly framing?: {
10
+ readonly follow: string;
11
+ } | {
12
+ readonly focus: string;
13
+ };
14
+ };
15
+ /** One view, resolved once when the scene is built. The sets hold every id of that kind the view shows (an id no view names is in every view's set); switching only changes which set is read. */
16
+ export interface ResolvedView {
17
+ readonly id: string;
18
+ readonly label: string;
19
+ readonly camera: ViewCameraRule;
20
+ /** Bodies, paths and groups: the ids the menu lists and the scene draws. */
21
+ readonly objects: ReadonlySet<string>;
22
+ readonly events: ReadonlySet<string>;
23
+ readonly panels: ReadonlySet<string>;
24
+ }
25
+ /** The views a scene names: presentation only (no State changes), so a hidden object keeps its state. */
26
+ export interface ViewSettings {
27
+ readonly place: ViewPlace;
28
+ /** Id of the opening view. */
29
+ readonly start: string;
30
+ readonly views: readonly ResolvedView[];
31
+ }
@@ -0,0 +1,2 @@
1
+ /** Where the view choice shows: a button group in the top bar, or a row in the one switch panel opened from the bar (as for the display switches). */
2
+ export const VIEW_PLACES = ["top-bar", "panel"];
@@ -5,7 +5,8 @@ import type { TimelineGlowLook } from "./timelineGlow.js";
5
5
  import type { ExperienceCameraPreset, ExperienceConfig } from "./experience.js";
6
6
  import type { Metric } from "./metrics.js";
7
7
  import { type PhoneLayoutSettings } from "./phoneLayout.js";
8
- import type { DisplaySwitchItem } from "./DisplaySwitches.js";
8
+ import type { DisplaySwitchItem, ViewChoice } from "./DisplaySwitches.js";
9
+ import type { ViewCameraRule } from "../app/views.js";
9
10
  import type { ExperienceSwitch } from "./SwitchControl.js";
10
11
  import type { ScaleChoice, ScaleId } from "./scaleModel.js";
11
12
  import "./controls.css";
@@ -25,6 +26,8 @@ interface Props {
25
26
  readonly paceAuto?: boolean | undefined;
26
27
  readonly onSeek: (timeUtcMs: number) => void;
27
28
  readonly onCameraRequest: (request: ExperienceCameraPreset["request"]) => void;
29
+ /** Holds the camera where it is, its target fixed in the scene (a view's `stay` rule); a later camera request replaces it. */
30
+ readonly onCameraHold?: () => void;
28
31
  readonly onSelectionChange: (objectId: string) => void;
29
32
  readonly scaleId: ScaleId;
30
33
  readonly onScaleChange: (id: ScaleId) => void;
@@ -33,6 +36,13 @@ interface Props {
33
36
  readonly switcher?: ExperienceSwitch;
34
37
  /** Display switches a story placed in the top bar or its switch panel (also in the phone drawer); absent or empty: none. */
35
38
  readonly displaySwitches?: readonly DisplaySwitchItem[];
39
+ /** The views the scene names (T-219); absent: none. The experience this shell gets is already the current view's. */
40
+ readonly viewChoice?: ViewChoice;
41
+ /** The view showing and its camera rule (T-220): on a switch of `id`, a followed or focused object the new view does not show is handled by the rule; absent: no views. */
42
+ readonly viewCamera?: {
43
+ readonly id: string;
44
+ readonly rule: ViewCameraRule;
45
+ };
36
46
  /** Live measurements for an object's info panel, from the app's own State; empty when it has none. */
37
47
  readonly metricsFor?: (objectId: string, timeUtcMs: number) => readonly Metric[];
38
48
  readonly developerTools?: ReactNode;
@@ -69,5 +79,5 @@ interface Props {
69
79
  readonly children: ReactNode;
70
80
  }
71
81
  /** Canvas-first layout shared by astronomy experiences. Scene and diagnostics stay app-owned. */
72
- export declare function AstraeusShell({ experience, snapshot, developerMode, onDeveloperModeChange, onTogglePlayback, onRateChange, paceAuto, onSeek, onCameraRequest, onSelectionChange, scaleId, onScaleChange, scaleChoices, switcher, displaySwitches, metricsFor, developerTools, storyPanelSettings, timelineGlow, phoneLayout, highlightedFamily, onHighlightFamily, onSetPlaying, panelRequest, onOpenPanelChange, featureRequest, onOpenFeatureChange, pickRequest, children, }: Props): import("react").JSX.Element;
82
+ export declare function AstraeusShell({ experience, snapshot, developerMode, onDeveloperModeChange, onTogglePlayback, onRateChange, paceAuto, onSeek, onCameraRequest, onCameraHold, onSelectionChange, scaleId, onScaleChange, scaleChoices, switcher, displaySwitches, viewChoice, viewCamera, metricsFor, developerTools, storyPanelSettings, timelineGlow, phoneLayout, highlightedFamily, onHighlightFamily, onSetPlaying, panelRequest, onOpenPanelChange, featureRequest, onOpenFeatureChange, pickRequest, children, }: Props): import("react").JSX.Element;
73
83
  export {};