astraeus 0.6.0 → 0.8.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 (288) hide show
  1. package/CHANGELOG.md +192 -0
  2. package/README.md +205 -34
  3. package/package.json +5 -4
  4. package/src/api/AstraeusScene.d.ts +24 -6
  5. package/src/api/AstraeusScene.js +46 -19
  6. package/src/api/AstraeusScene.node.js +46 -19
  7. package/src/api/assembleScene.d.ts +36 -0
  8. package/src/api/assembleScene.js +175 -0
  9. package/src/api/bodySetChecks.d.ts +10 -0
  10. package/src/api/bodySetChecks.js +117 -0
  11. package/src/api/bodySetInput.d.ts +81 -0
  12. package/src/api/bodySetInput.js +1 -0
  13. package/src/api/containingBlock.d.ts +6 -0
  14. package/src/api/containingBlock.js +16 -0
  15. package/src/api/data.d.ts +17 -5
  16. package/src/api/data.js +28 -10
  17. package/src/api/definitionOf.d.ts +16 -0
  18. package/src/api/definitionOf.js +20 -0
  19. package/src/api/errors.d.ts +61 -1
  20. package/src/api/frozenCopy.d.ts +6 -0
  21. package/src/api/frozenCopy.js +26 -0
  22. package/src/api/group.d.ts +8 -2
  23. package/src/api/group.js +24 -5
  24. package/src/api/index.d.ts +19 -7
  25. package/src/api/index.js +2 -2
  26. package/src/api/index.node.js +2 -2
  27. package/src/api/listeners.d.ts +5 -0
  28. package/src/api/listeners.js +25 -0
  29. package/src/api/look.d.ts +47 -0
  30. package/src/api/look.js +1 -0
  31. package/src/api/lookInput.d.ts +3 -0
  32. package/src/api/lookInput.js +41 -0
  33. package/src/api/moonPanelInput.d.ts +60 -0
  34. package/src/api/moonPanelInput.js +1 -0
  35. package/src/api/mount.d.ts +10 -16
  36. package/src/api/mount.js +27 -11
  37. package/src/api/mount.node.js +27 -11
  38. package/src/api/pathProvenance.d.ts +15 -6
  39. package/src/api/pathProvenance.js +23 -11
  40. package/src/api/pickerInput.d.ts +25 -0
  41. package/src/api/pickerInput.js +1 -0
  42. package/src/api/planBodies.d.ts +72 -0
  43. package/src/api/planBodies.js +300 -0
  44. package/src/api/planBodySets.d.ts +68 -0
  45. package/src/api/planBodySets.js +234 -0
  46. package/src/api/planCamera.d.ts +83 -0
  47. package/src/api/planCamera.js +184 -0
  48. package/src/api/planGroups.d.ts +36 -0
  49. package/src/api/planGroups.js +103 -0
  50. package/src/api/planMoonPanel.d.ts +19 -0
  51. package/src/api/planMoonPanel.js +104 -0
  52. package/src/api/planPaths.d.ts +40 -0
  53. package/src/api/planPaths.js +212 -0
  54. package/src/api/planPicker.d.ts +12 -0
  55. package/src/api/planPicker.js +40 -0
  56. package/src/api/planPlaces.d.ts +16 -0
  57. package/src/api/planPlaces.js +99 -0
  58. package/src/api/planStory.d.ts +26 -0
  59. package/src/api/planStory.js +66 -0
  60. package/src/api/planTimeline.d.ts +27 -0
  61. package/src/api/planTimeline.js +68 -0
  62. package/src/api/planViews.d.ts +25 -0
  63. package/src/api/planViews.js +35 -0
  64. package/src/api/prepared.js +4 -1
  65. package/src/api/renamedInputs.d.ts +15 -0
  66. package/src/api/renamedInputs.js +39 -0
  67. package/src/api/scene.d.ts +176 -65
  68. package/src/api/scene.js +257 -725
  69. package/src/api/sceneFreeze.d.ts +4 -0
  70. package/src/api/sceneFreeze.js +10 -0
  71. package/src/api/sceneReads.d.ts +171 -0
  72. package/src/api/sceneReads.js +6 -0
  73. package/src/api/sphereOfInfluence.d.ts +20 -0
  74. package/src/api/sphereOfInfluence.js +48 -0
  75. package/src/api/story.d.ts +49 -19
  76. package/src/api/story.js +54 -22
  77. package/src/api/sunOrbit.js +9 -11
  78. package/src/api/time.d.ts +2 -1
  79. package/src/api/time.js +2 -1
  80. package/src/api/viewerCamera.d.ts +22 -0
  81. package/src/api/viewerCamera.js +84 -0
  82. package/src/api/viewerClock.d.ts +30 -0
  83. package/src/api/viewerClock.js +85 -0
  84. package/src/api/viewerFirstDraw.d.ts +14 -0
  85. package/src/api/viewerFirstDraw.js +26 -0
  86. package/src/api/viewerHandle.d.ts +79 -0
  87. package/src/api/viewerHandle.js +31 -0
  88. package/src/api/viewerLink.d.ts +91 -13
  89. package/src/api/viewerLink.js +111 -64
  90. package/src/api/viewerLooks.d.ts +19 -0
  91. package/src/api/viewerLooks.js +37 -0
  92. package/src/api/viewerPicker.d.ts +22 -0
  93. package/src/api/viewerPicker.js +49 -0
  94. package/src/api/viewerSelection.d.ts +25 -0
  95. package/src/api/viewerSelection.js +31 -0
  96. package/src/api/viewerViews.d.ts +10 -0
  97. package/src/api/viewerViews.js +18 -0
  98. package/src/api/viewerZones.d.ts +20 -0
  99. package/src/api/viewerZones.js +47 -0
  100. package/src/api/views.d.ts +41 -0
  101. package/src/api/views.js +82 -0
  102. package/src/app/App.d.ts +5 -3
  103. package/src/app/App.js +211 -75
  104. package/src/app/App.node.js +211 -75
  105. package/src/app/AstraeusScene.d.ts +19 -2
  106. package/src/app/AstraeusScene.js +4 -4
  107. package/src/app/BodyView.d.ts +4 -1
  108. package/src/app/BodyView.js +2 -2
  109. package/src/app/CameraController.d.ts +12 -0
  110. package/src/app/CameraController.js +3 -1
  111. package/src/app/DeveloperSettings.d.ts +1 -4
  112. package/src/app/DeveloperSettings.js +6 -10
  113. package/src/app/FeatureMarkers.d.ts +4 -3
  114. package/src/app/FeatureMarkers.js +8 -13
  115. package/src/app/FrameRateSection.js +2 -1
  116. package/src/app/OrbitSetView.js +1 -1
  117. package/src/app/SettingControls.d.ts +11 -3
  118. package/src/app/SettingControls.js +10 -2
  119. package/src/app/SkyView.d.ts +3 -10
  120. package/src/app/SkyView.js +6 -28
  121. package/src/app/StoryMarkers.d.ts +4 -1
  122. package/src/app/StoryMarkers.js +3 -2
  123. package/src/app/TrackedBodyView.d.ts +1 -1
  124. package/src/app/TrackedBodyView.js +20 -11
  125. package/src/app/address.d.ts +16 -0
  126. package/src/app/address.js +31 -0
  127. package/src/app/bodyDraw.d.ts +10 -7
  128. package/src/app/bodyDraw.js +12 -32
  129. package/src/app/bodyMetrics.js +2 -2
  130. package/src/app/bodySet.d.ts +4 -20
  131. package/src/app/bodySet.js +5 -16
  132. package/src/app/debugReadout.js +1 -1
  133. package/src/app/displaySwitches.d.ts +4 -0
  134. package/src/app/displaySwitches.js +6 -0
  135. package/src/app/experienceDefinition.d.ts +14 -23
  136. package/src/app/listSwitch.d.ts +8 -14
  137. package/src/app/listSwitch.js +3 -10
  138. package/src/app/liveLook.d.ts +39 -0
  139. package/src/app/liveLook.js +66 -0
  140. package/src/app/look.d.ts +36 -0
  141. package/src/app/look.js +61 -0
  142. package/src/app/mission.d.ts +16 -3
  143. package/src/app/mission.js +16 -1
  144. package/src/app/openClock.d.ts +3 -2
  145. package/src/app/openClock.js +3 -3
  146. package/src/app/sceneCamera.d.ts +2 -0
  147. package/src/app/sceneCamera.js +23 -0
  148. package/src/app/sceneFrame.d.ts +6 -4
  149. package/src/app/sceneFrame.js +55 -14
  150. package/src/app/sceneHooks.js +3 -2
  151. package/src/app/style.css +114 -139
  152. package/src/app/trackedMetrics.d.ts +10 -3
  153. package/src/app/trackedMetrics.js +22 -11
  154. package/src/app/viewHiding.d.ts +13 -0
  155. package/src/app/viewHiding.js +37 -0
  156. package/src/app/viewLink.d.ts +10 -32
  157. package/src/app/viewLink.js +10 -49
  158. package/src/app/viewerPort.d.ts +56 -0
  159. package/src/app/views.d.ts +32 -0
  160. package/src/app/views.js +2 -0
  161. package/src/assets/bodies/galileanMoons.js +1 -2
  162. package/src/assets/bodies/io.js +2 -2
  163. package/src/assets/bodies/listedMoons.d.ts +1 -1
  164. package/src/assets/bodies/listedMoons.js +2 -3
  165. package/src/assets/bodies/planetSystemMaps.js +2 -3
  166. package/src/assets/bodies/venus.js +2 -6
  167. package/src/assets/catalogue.js +1 -2
  168. package/src/assets/licence.d.ts +3 -3
  169. package/src/assets/licence.js +3 -3
  170. package/src/assets/pictures.d.ts +15 -12
  171. package/src/assets/pictures.js +24 -20
  172. package/src/assets/sky.d.ts +6 -5
  173. package/src/assets/sky.js +6 -9
  174. package/src/assets/visual.d.ts +4 -0
  175. package/src/core/bodies/index.d.ts +0 -4
  176. package/src/core/bodies/index.js +1 -6
  177. package/src/core/bodies/jupiterData.d.ts +0 -1
  178. package/src/core/bodies/jupiterData.js +2 -5
  179. package/src/core/bodies/moonSystem.d.ts +1 -1
  180. package/src/core/bodies/moonSystem.js +102 -55
  181. package/src/core/bodies/outerPlanetRingData.js +2 -2
  182. package/src/core/bodies/planetTrajectory.js +1 -1
  183. package/src/core/bodySetFamilies.d.ts +20 -0
  184. package/src/core/bodySetFamilies.js +14 -0
  185. package/src/core/chebyshevEphemeris.js +1 -1
  186. package/src/core/elementsBody.d.ts +8 -4
  187. package/src/core/elementsBody.js +32 -11
  188. package/src/core/elementsGroup.d.ts +27 -0
  189. package/src/core/elementsGroup.js +85 -0
  190. package/src/core/events.d.ts +2 -0
  191. package/src/core/events.js +2 -0
  192. package/src/core/illumination.js +1 -1
  193. package/src/core/listedOrbitGroup.d.ts +2 -0
  194. package/src/core/listedOrbitGroup.js +11 -7
  195. package/src/core/moonListText.d.ts +6 -0
  196. package/src/core/moonListText.js +19 -0
  197. package/src/core/moonTrajectory.js +1 -1
  198. package/src/core/pacing.d.ts +38 -3
  199. package/src/core/pacing.js +55 -4
  200. package/src/core/planetModels.js +2 -2
  201. package/src/core/planetSeries.d.ts +8 -0
  202. package/src/core/planetSeries.js +16 -2
  203. package/src/core/pointGroup.js +1 -1
  204. package/src/core/provenance.d.ts +2 -1
  205. package/src/core/provenance.js +2 -2
  206. package/src/core/referenceCenters.js +5 -5
  207. package/src/core/sampledTrajectory.js +1 -1
  208. package/src/core/scalePolicy.d.ts +1 -0
  209. package/src/core/startView.d.ts +19 -0
  210. package/src/core/startView.js +28 -0
  211. package/src/core/state.d.ts +6 -2
  212. package/src/core/state.js +3 -3
  213. package/src/core/storyPanels.d.ts +63 -0
  214. package/src/core/storyPanels.js +111 -0
  215. package/src/core/sunCentredSources.d.ts +4 -0
  216. package/src/core/sunCentredSources.js +9 -2
  217. package/src/core/timeInput.d.ts +4 -0
  218. package/src/core/timeInput.js +4 -0
  219. package/src/shell/AstraeusShell.d.ts +17 -3
  220. package/src/shell/AstraeusShell.js +60 -13
  221. package/src/shell/AstraeusShell.node.js +60 -13
  222. package/src/shell/Collapsible.d.ts +4 -3
  223. package/src/shell/Collapsible.js +5 -5
  224. package/src/shell/ControlsDrawer.d.ts +1 -1
  225. package/src/shell/ControlsDrawer.js +3 -1
  226. package/src/shell/DisplaySwitches.d.ts +18 -1
  227. package/src/shell/DisplaySwitches.js +20 -6
  228. package/src/shell/InfoPanel.d.ts +3 -1
  229. package/src/shell/InfoPanel.js +5 -4
  230. package/src/shell/MoonFamilyPanel.js +1 -1
  231. package/src/shell/ObjectControls.d.ts +3 -1
  232. package/src/shell/ObjectControls.js +2 -2
  233. package/src/shell/Sources.d.ts +5 -3
  234. package/src/shell/Sources.js +5 -5
  235. package/src/shell/StoryPanelView.d.ts +4 -3
  236. package/src/shell/StoryPanelView.js +8 -6
  237. package/src/shell/SwitchControl.d.ts +5 -11
  238. package/src/shell/SwitchControl.js +2 -20
  239. package/src/shell/TimelineBar.css +84 -66
  240. package/src/shell/TimelineBar.d.ts +5 -2
  241. package/src/shell/TimelineBar.js +37 -11
  242. package/src/shell/TimelineBar.node.js +37 -11
  243. package/src/shell/TopBar.css +22 -22
  244. package/src/shell/TopBar.d.ts +9 -3
  245. package/src/shell/TopBar.js +5 -5
  246. package/src/shell/TopBar.node.js +5 -5
  247. package/src/shell/bootLoader.d.ts +4 -10
  248. package/src/shell/bootLoader.js +6 -52
  249. package/src/shell/embedded.css +18 -18
  250. package/src/shell/experience.d.ts +1 -1
  251. package/src/shell/moonFamilies.d.ts +2 -6
  252. package/src/shell/moonFamilies.js +2 -18
  253. package/src/shell/phone.css +58 -58
  254. package/src/shell/storyPanels.d.ts +2 -53
  255. package/src/shell/storyPanels.js +1 -106
  256. package/src/shell/style.css +153 -134
  257. package/src/shell/timelineModel.d.ts +13 -0
  258. package/src/shell/timelineModel.js +25 -0
  259. package/src/shell/useDrawers.d.ts +3 -2
  260. package/src/shell/useDrawers.js +4 -3
  261. package/src/shell/viewCamera.d.ts +4 -0
  262. package/src/shell/viewCamera.js +13 -0
  263. package/src/shell/viewerKeys.d.ts +8 -0
  264. package/src/shell/viewerKeys.js +16 -0
  265. package/src/synthetic/syntheticDefinition.js +20 -24
  266. package/src/synthetic/syntheticJourneyScene.js +14 -4
  267. package/src/synthetic/syntheticProbeDefinition.js +2 -1
  268. package/src/synthetic/syntheticViewsDefinition.d.ts +3 -0
  269. package/src/synthetic/syntheticViewsDefinition.js +38 -0
  270. package/data/moons/jupiter.json +0 -3333
  271. package/data/moons/neptune.json +0 -555
  272. package/data/moons/pluto.json +0 -205
  273. package/data/moons/saturn.json +0 -8267
  274. package/data/moons/uranus.json +0 -887
  275. package/src/app/addressNavigation.d.ts +0 -17
  276. package/src/app/addressNavigation.js +0 -16
  277. package/src/assets/bodies/jupiterMoonCatalogue.d.ts +0 -3
  278. package/src/assets/bodies/jupiterMoonCatalogue.js +0 -4
  279. package/src/assets/bodies/outerPlanetCatalogues.d.ts +0 -7
  280. package/src/assets/bodies/outerPlanetCatalogues.js +0 -8
  281. package/src/assets/bodies/swiftTuttle.d.ts +0 -12
  282. package/src/assets/bodies/swiftTuttle.js +0 -13
  283. package/src/assets/moonCatalogue.d.ts +0 -49
  284. package/src/assets/moonCatalogue.js +0 -80
  285. package/src/core/bodies/outerPlanetData.d.ts +0 -4
  286. package/src/core/bodies/outerPlanetData.js +0 -13
  287. package/src/core/bodies/swiftTuttle.d.ts +0 -46
  288. package/src/core/bodies/swiftTuttle.js +0 -106
@@ -1,6 +1,6 @@
1
1
  import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
2
- import { useMemo, useState } from "react";
3
- import { eventContextAt, eventPositionPercent, formatUtcTimestamp, formatWindowRate, navigationStops, windowContextAt, timePositionPercent, speedsOf, TIMELINE_STEP_MS, clampToBounds, formatRateCompact, formatRate } from "./timelineModel.js";
2
+ import { useEffect, useId, useMemo, useRef, useState } from "react";
3
+ import { eventContextAt, formatUtcTimestamp, formatWindowRate, navigationStops, windowContextAt, timePositionPercent, speedsOf, TIMELINE_STEP_MS, clampToBounds, formatRateCompact, formatRate, groupMarkers } from "./timelineModel.js";
4
4
  import { activityAt, DEFAULT_TIMELINE_GLOW, glowDescription, glowGradient, glowProfile, glowTooltip } from "./timelineGlow.js";
5
5
  import { Label } from "./Label.js";
6
6
  import { useDrawerSwipe } from "./useDrawerSwipe.js";
@@ -18,7 +18,8 @@ function seekValueText(timeUtcMs, activityNow) {
18
18
  return formatUtcTimestamp(timeUtcMs);
19
19
  return `${formatUtcTimestamp(timeUtcMs)}, ${activityNow.window.label}: ${formatWindowRate(activityNow.rate, activityNow.window.rate.unit)}`;
20
20
  }
21
- export function TimelineBar({ experience, snapshot, onTogglePlayback, onRateChange, paceAuto, onSeek, panels = [], openPanelId = null, onPanelOpen, onEventSeek, onEventInfo, onWindowSeek, onWindowInfo, glowLook = DEFAULT_TIMELINE_GLOW, drawer }) {
21
+ export function TimelineBar({ experience, snapshot, onTogglePlayback, onRateChange, paceAuto, onSeek, panels = [], openPanelId = null, onPanelOpen, onEventSeek, onEventInfo, onWindowSeek, onWindowInfo, glowLook = DEFAULT_TIMELINE_GLOW, drawer, infoPanelId }) {
22
+ const drawerId = `${useId()}-timeline-drawer`;
22
23
  const windows = experience.windows ?? [];
23
24
  const profile = useMemo(() => glowProfile(windows, experience.window), [windows, experience.window]);
24
25
  const gradients = useMemo(() => ({ ahead: glowGradient(profile, glowLook, "ahead"), played: glowGradient(profile, glowLook, "played") }), [profile, glowLook]);
@@ -52,19 +53,44 @@ export function TimelineBar({ experience, snapshot, onTogglePlayback, onRateChan
52
53
  });
53
54
  const speedIndex = Math.max(0, speeds.findIndex((speed) => speed.rate === snapshot.rate));
54
55
  const speedText = paceAuto === true ? autoLabel(true, snapshot.rate) : speeds[speedIndex]?.label;
56
+ const markersRef = useRef(null);
57
+ const [trackWidth, setTrackWidth] = useState(0);
58
+ const [openGroup, setOpenGroup] = useState(null);
59
+ useEffect(() => {
60
+ const node = markersRef.current;
61
+ if (node === null)
62
+ return undefined;
63
+ const measure = () => { const width = node.getBoundingClientRect().width; if (width > 0)
64
+ setTrackWidth(width); };
65
+ measure();
66
+ if (typeof ResizeObserver === "undefined")
67
+ return undefined;
68
+ const observer = new ResizeObserver(measure);
69
+ observer.observe(node);
70
+ return () => observer.disconnect();
71
+ }, [drawer?.open]);
72
+ const markers = [
73
+ ...experience.events.map((event) => ({ kind: "event", key: event.id, timeUtcMs: event.timeUtcMs, text: event.label, ariaLabel: `Go to ${event.label}`, activate: () => { onEventSeek(event); onEventInfo(event); } })),
74
+ ...panels.map((panel) => ({ kind: "panel", key: panel.id, timeUtcMs: panel.timeUtcMs, text: panel.title, ariaLabel: `Open story panel: ${panel.title}`, activate: () => onPanelOpen?.(panel) })),
75
+ ...windows.flatMap((window) => window.peakUtcMs === undefined ? [] : [{ kind: "peak", key: `peak-${window.id}`, timeUtcMs: window.peakUtcMs, text: `${window.label} peak`, ariaLabel: `Go to peak of ${window.label}`, activate: () => { onWindowSeek(window, window.peakUtcMs ?? 0); onWindowInfo(window); } }]),
76
+ ];
77
+ const groups = groupMarkers(markers, experience.window, trackWidth);
78
+ const renderMarker = (marker, percent) => marker.kind === "event" ? (_jsx("button", { className: "timeline-marker", type: "button", "aria-label": marker.ariaLabel, title: marker.text, style: { left: `${percent}%` }, onClick: marker.activate, children: _jsx(Label, { text: marker.text, className: "timeline-marker-label" }) }, marker.key)) : marker.kind === "panel" ? (_jsx("button", { className: "timeline-marker timeline-panel-marker", type: "button", "data-panel-id": marker.key, "aria-pressed": openPanelId === marker.key, "aria-label": marker.ariaLabel, title: marker.text, style: { left: `${percent}%` }, onClick: marker.activate, children: _jsx(Label, { text: marker.text, className: "timeline-marker-label" }) }, marker.key)) : (_jsx("button", { type: "button", className: "timeline-marker timeline-window-peak", "aria-label": marker.ariaLabel, title: marker.text, "data-time-utc-ms": marker.timeUtcMs, style: { left: `${percent}%` }, onClick: marker.activate }, marker.key));
55
79
  const scrubber = (_jsxs("div", { className: "timeline-scrubber", children: [_jsxs("div", { className: "timeline-track", title: profile === null ? undefined : hoverTitle ?? description, onPointerMove: moveOnTrack, onPointerLeave: () => setHoverTitle(null), children: [_jsxs("div", { className: "timeline-glow", ...(description === "" ? { "aria-hidden": true } : { role: "img", "aria-label": description }), style: {
56
80
  "--glow-ahead": gradients.ahead,
57
81
  "--glow-played": gradients.played,
58
82
  "--glow-played-edge": `${(100 - playedPercent).toFixed(3)}%`,
59
83
  "--glow-thickness": `${glowLook.thicknessPx}px`,
60
84
  "--glow-halo": `${glowLook.haloPx}px`,
61
- }, children: [_jsx("span", { className: "timeline-glow-ahead" }), _jsx("span", { className: "timeline-glow-played", children: _jsx("span", { className: "timeline-glow-line" }) })] }), _jsxs("div", { className: "timeline-markers", "aria-label": "Timeline event markers", children: [experience.events.map((event) => (_jsx("button", { className: "timeline-marker", type: "button", "aria-label": `Go to ${event.label}`, title: event.label, style: { left: `${eventPositionPercent(event, experience.window)}%` }, onClick: () => { onEventSeek(event); onEventInfo(event); }, children: _jsx(Label, { text: event.label, className: "timeline-marker-label" }) }, event.id))), panels.map((panel) => (_jsx("button", { className: "timeline-marker timeline-panel-marker", type: "button", "data-panel-id": panel.id, "aria-pressed": openPanelId === panel.id, "aria-label": `Open story panel: ${panel.title}`, title: panel.title, style: { left: `${timePositionPercent(panel.timeUtcMs, experience.window)}%` }, onClick: () => onPanelOpen?.(panel), children: _jsx(Label, { text: panel.title, className: "timeline-marker-label" }) }, panel.id))), windows.filter((window) => window.peakUtcMs !== undefined).map((window) => (_jsx("button", { type: "button", className: "timeline-marker timeline-window-peak", "aria-label": `Go to peak of ${window.label}`, title: `${window.label} peak`, "data-time-utc-ms": window.peakUtcMs, style: { left: `${timePositionPercent(window.peakUtcMs ?? 0, experience.window)}%` }, onClick: () => { if (window.peakUtcMs !== undefined)
62
- onWindowSeek(window, window.peakUtcMs); onWindowInfo(window); } }, `peak-${window.id}`)))] }), _jsx("input", { type: "range", "aria-label": "Seek timeline", "aria-valuetext": valueText, min: experience.window.startUtcMs, max: experience.window.endUtcMs, step: TIMELINE_STEP_MS, value: clampToBounds(snapshot.timeUtcMs, experience.window), onChange: (event) => onSeek(Number(event.target.value)) })] }), _jsxs("div", { className: "timeline-bounds", "aria-hidden": "true", children: [_jsx("time", { dateTime: formatUtcTimestamp(experience.window.startUtcMs), children: formatUtcTimestamp(experience.window.startUtcMs).slice(0, 10) }), _jsx("time", { dateTime: formatUtcTimestamp(experience.window.endUtcMs), children: formatUtcTimestamp(experience.window.endUtcMs).slice(0, 10) })] })] }));
63
- return (_jsxs("section", { className: "timeline-bar", "aria-label": "Timeline controls", "data-drawer-open": drawer?.open, children: [drawer !== undefined && (_jsx("button", { type: "button", className: "drawer-handle drawer-handle-top ui-bare", "aria-label": "Timeline drawer", "aria-expanded": drawer.open, "aria-controls": "timeline-drawer", ...handle, children: _jsx("span", {}) })), _jsxs("div", { className: "timeline-main-row", children: [_jsxs("div", { className: "timeline-transport", children: [_jsx("button", { type: "button", className: "timeline-play ui-icon ui-accent", title: snapshot.playing ? "Pause" : "Play", onClick: onTogglePlayback, "aria-label": snapshot.playing ? "Pause playback" : "Play playback", children: snapshot.playing ? _jsx(Symbol, { path: "M7 5h3.5v14H7zM13.5 5H17v14h-3.5z" }) : _jsx(Symbol, { path: "M7 5v14l12-7z" }) }), _jsx("button", { type: "button", className: "timeline-previous ui-icon ui-ghost", "aria-label": stopLabel("Previous", navigation.previous), title: stopLabel("Previous", navigation.previous), disabled: navigation.previous === null, onClick: () => { if (navigation.previous !== null)
85
+ }, children: [_jsx("span", { className: "timeline-glow-ahead" }), _jsx("span", { className: "timeline-glow-played", children: _jsx("span", { className: "timeline-glow-line" }) })] }), _jsx("div", { className: "timeline-markers", ref: markersRef, "aria-label": "Timeline event markers", children: groups.map((group) => group.members.length === 1
86
+ ? renderMarker(group.members[0], group.positionPercent)
87
+ : (_jsxs("div", { className: "timeline-marker-group", "data-align": group.positionPercent < 25 ? "start" : group.positionPercent > 75 ? "end" : "middle", style: { left: `${group.positionPercent}%` }, onKeyDown: (event) => { if (event.key === "Escape")
88
+ setOpenGroup(null); }, children: [_jsx("button", { type: "button", className: "timeline-marker timeline-group-toggle", "aria-expanded": openGroup === group.members[0].key, "aria-label": `${group.members.length} markers close together: show list`, title: `${group.members.length} markers`, onClick: () => setOpenGroup((open) => (open === group.members[0].key ? null : group.members[0].key)), children: _jsx("span", { className: "timeline-group-count", children: group.members.length }) }), openGroup === group.members[0].key && (_jsx("ul", { className: "timeline-group-list", "aria-label": "Markers close together", children: group.members.map((member) => (_jsx("li", { children: _jsx("button", { type: "button", className: "timeline-group-item", "aria-label": member.ariaLabel, "data-time-utc-ms": member.timeUtcMs, "data-panel-id": member.kind === "panel" ? member.key : undefined, onClick: () => { member.activate(); setOpenGroup(null); }, children: member.text }) }, member.key))) }))] }, `group-${group.members[0].key}`))) }), _jsx("input", { type: "range", "aria-label": "Seek timeline", "aria-valuetext": valueText, min: experience.window.startUtcMs, max: experience.window.endUtcMs, step: TIMELINE_STEP_MS, value: clampToBounds(snapshot.timeUtcMs, experience.window), onChange: (event) => onSeek(Number(event.target.value)) })] }), _jsxs("div", { className: "timeline-bounds", "aria-hidden": "true", children: [_jsx("time", { dateTime: formatUtcTimestamp(experience.window.startUtcMs), children: formatUtcTimestamp(experience.window.startUtcMs).slice(0, 10) }), _jsx("time", { dateTime: formatUtcTimestamp(experience.window.endUtcMs), children: formatUtcTimestamp(experience.window.endUtcMs).slice(0, 10) })] })] }));
89
+ return (_jsxs("section", { className: "timeline-bar", "aria-label": "Timeline controls", "data-drawer-open": drawer?.open, children: [drawer !== undefined && (_jsx("button", { type: "button", className: "drawer-handle drawer-handle-top ui-bare", "aria-label": "Timeline drawer", "aria-expanded": drawer.open, "aria-controls": drawerId, ...handle, children: _jsx("span", {}) })), _jsxs("div", { className: "timeline-main-row", children: [_jsxs("div", { className: "timeline-transport", children: [_jsx("button", { type: "button", className: "timeline-play ui-icon ui-accent", title: snapshot.playing ? "Pause" : "Play", onClick: onTogglePlayback, "aria-label": snapshot.playing ? "Pause playback" : "Play playback", children: snapshot.playing ? _jsx(Symbol, { path: "M7 5h3.5v14H7zM13.5 5H17v14h-3.5z" }) : _jsx(Symbol, { path: "M7 5v14l12-7z" }) }), _jsx("button", { type: "button", className: "timeline-previous ui-icon ui-ghost", "aria-label": stopLabel("Previous", navigation.previous), title: stopLabel("Previous", navigation.previous), disabled: navigation.previous === null, onClick: () => { if (navigation.previous !== null)
64
90
  goToStop(navigation.previous); }, children: _jsx(Symbol, { path: "M6 5h2v14H6zM19 5v14L9 12z" }) }), _jsx("button", { type: "button", className: "timeline-next ui-icon ui-ghost", "aria-label": stopLabel("Next", navigation.next), title: stopLabel("Next", navigation.next), disabled: navigation.next === null, onClick: () => { if (navigation.next !== null)
65
- goToStop(navigation.next); }, children: _jsx(Symbol, { path: "M16 5h2v14h-2zM5 5v14l10-7z" }) })] }), _jsxs("time", { className: "timeline-time", dateTime: timestamp, "aria-label": timestamp, children: [_jsx("span", { className: "timeline-time-full", children: timestamp }), _jsx("span", { className: "timeline-time-short", "aria-hidden": "true", children: timestamp.slice(0, 16).replace("T", " ") })] }), _jsx(SpeedMenu, { speeds: speeds, rate: snapshot.rate, paceAuto: paceAuto, compact: drawer !== undefined, onRateChange: onRateChange }), scrubber, drawer === undefined && (_jsxs("details", { className: "timeline-event-list", children: [_jsxs("summary", { className: "ui-button", title: "Events: what just happened, what is next, and the full list", children: ["Events ", _jsxs("span", { children: ["(", experience.events.length, ")"] })] }), _jsx(TimelineExpanded, { experience: experience, snapshot: snapshot, onEventSeek: onEventSeek, onEventInfo: onEventInfo, onWindowInfo: onWindowInfo })] }))] }), drawer !== undefined && (_jsx("div", { id: "timeline-drawer", className: "timeline-drawer", role: "region", "aria-label": "Timeline details", "data-open": drawer.open, onClick: (event) => { const closer = event.target.closest("[data-closes-drawer]"); if (closer !== null && closer.tagName !== "SELECT")
91
+ goToStop(navigation.next); }, children: _jsx(Symbol, { path: "M16 5h2v14h-2zM5 5v14l10-7z" }) })] }), _jsxs("time", { className: "timeline-time", dateTime: timestamp, "aria-label": timestamp, children: [_jsx("span", { className: "timeline-time-full", children: timestamp }), _jsx("span", { className: "timeline-time-short", "aria-hidden": "true", children: timestamp.slice(0, 16).replace("T", " ") })] }), _jsx(SpeedMenu, { speeds: speeds, rate: snapshot.rate, paceAuto: paceAuto, compact: drawer !== undefined, onRateChange: onRateChange }), scrubber, drawer === undefined && (_jsxs("details", { className: "timeline-event-list", children: [_jsxs("summary", { className: "ui-button", title: "Events: what just happened, what is next, and the full list", children: ["Events ", _jsxs("span", { children: ["(", experience.events.length, ")"] })] }), _jsx(TimelineExpanded, { experience: experience, snapshot: snapshot, onEventSeek: onEventSeek, onEventInfo: onEventInfo, onWindowInfo: onWindowInfo, infoPanelId: infoPanelId })] }))] }), drawer !== undefined && (_jsx("div", { id: drawerId, className: "timeline-drawer", role: "region", "aria-label": "Timeline details", "data-open": drawer.open, onClick: (event) => { const closer = event.target.closest("[data-closes-drawer]"); if (closer !== null && closer.tagName !== "SELECT")
66
92
  drawer.onOpenChange(false); }, children: _jsxs("div", { className: "timeline-drawer-body", children: [_jsxs("div", { className: "timeline-speed-slider", children: [_jsx("span", { "aria-hidden": "true", children: "Playback speed" }), _jsx("input", { type: "range", "aria-label": "Speed slider", "aria-valuetext": speedText, min: 0, max: speeds.length - 1, step: 1, value: speedIndex, onChange: (event) => { const next = speeds[Number(event.target.value)]; if (next !== undefined)
67
- onRateChange(next.rate); } }), _jsx("output", { children: speedText })] }), _jsx(TimelineExpanded, { experience: experience, snapshot: snapshot, onEventSeek: onEventSeek, onEventInfo: onEventInfo, onWindowInfo: onWindowInfo })] }) }))] }));
93
+ onRateChange(next.rate); } }), _jsx("output", { children: speedText })] }), _jsx(TimelineExpanded, { experience: experience, snapshot: snapshot, onEventSeek: onEventSeek, onEventInfo: onEventInfo, onWindowInfo: onWindowInfo, infoPanelId: infoPanelId })] }) }))] }));
68
94
  }
69
95
  /** A 24x24 filled symbol; the button around it carries the accessible name and tooltip. */
70
96
  function Symbol({ path }) {
@@ -74,11 +100,11 @@ function Symbol({ path }) {
74
100
  * The timeline's expanded content: "Just happened / Up next / Inside" and the full event list.
75
101
  * On larger screens it opens from the Events button; the phone drawer shows the same content when expanded.
76
102
  */
77
- export function TimelineExpanded({ experience, snapshot, onEventSeek, onEventInfo, onWindowInfo }) {
103
+ export function TimelineExpanded({ experience, snapshot, onEventSeek, onEventInfo, onWindowInfo, infoPanelId }) {
78
104
  const context = eventContextAt(experience.events, snapshot.timeUtcMs);
79
105
  const inside = windowContextAt(experience.windows ?? [], snapshot.timeUtcMs);
80
106
  return (_jsxs("div", { className: "timeline-expanded", children: [_jsxs("div", { className: "timeline-event-context", "aria-label": "Event context", children: [context.current === null
81
107
  ? _jsxs("span", { children: [_jsx("strong", { children: "Just happened:" }), " No event yet"] })
82
- : (_jsxs("button", { type: "button", className: "timeline-event-current ui-row", "data-closes-drawer": "", "aria-label": `Information about ${context.current.label}`, "aria-controls": "info-panel", onClick: () => { if (context.current !== null)
83
- onEventInfo(context.current); }, children: [_jsx("strong", { children: "Just happened:" }), " ", context.current.label, " ", _jsx("span", { "aria-hidden": "true", children: "\u24D8" })] })), _jsxs("span", { children: [_jsx("strong", { children: "Up next:" }), " ", context.next?.label ?? "No upcoming event"] }), inside.map(({ window, rate }) => (_jsxs("button", { type: "button", className: "timeline-event-current timeline-window-current ui-row", "data-closes-drawer": "", "aria-label": `Information about ${window.label}`, "aria-controls": "info-panel", onClick: () => onWindowInfo(window), children: [_jsx("strong", { children: "Inside:" }), " ", window.label, rate !== null && window.rate !== undefined && _jsxs(_Fragment, { children: [" \u2014 ", formatWindowRate(rate, window.rate.unit)] }), " ", _jsx("span", { "aria-hidden": "true", children: "\u24D8" })] }, window.id)))] }), _jsx("ol", { children: experience.events.map((event) => (_jsx("li", { children: _jsxs("button", { type: "button", className: "ui-row", "data-closes-drawer": "", "aria-current": context.current?.id === event.id ? "time" : undefined, onClick: () => { onEventSeek(event); onEventInfo(event); }, children: [_jsx("time", { dateTime: formatUtcTimestamp(event.timeUtcMs), children: formatUtcTimestamp(event.timeUtcMs) }), _jsx("span", { children: event.label })] }) }, event.id))) })] }));
108
+ : (_jsxs("button", { type: "button", className: "timeline-event-current ui-row", "data-closes-drawer": "", "aria-label": `Information about ${context.current.label}`, "aria-controls": infoPanelId, onClick: () => { if (context.current !== null)
109
+ onEventInfo(context.current); }, children: [_jsx("strong", { children: "Just happened:" }), " ", context.current.label, " ", _jsx("span", { "aria-hidden": "true", children: "\u24D8" })] })), _jsxs("span", { children: [_jsx("strong", { children: "Up next:" }), " ", context.next?.label ?? "No upcoming event"] }), inside.map(({ window, rate }) => (_jsxs("button", { type: "button", className: "timeline-event-current timeline-window-current ui-row", "data-closes-drawer": "", "aria-label": `Information about ${window.label}`, "aria-controls": infoPanelId, onClick: () => onWindowInfo(window), children: [_jsx("strong", { children: "Inside:" }), " ", window.label, rate !== null && window.rate !== undefined && _jsxs(_Fragment, { children: [" \u2014 ", formatWindowRate(rate, window.rate.unit)] }), " ", _jsx("span", { "aria-hidden": "true", children: "\u24D8" })] }, window.id)))] }), _jsx("ol", { children: experience.events.map((event) => (_jsx("li", { children: _jsxs("button", { type: "button", className: "ui-row", "data-closes-drawer": "", "aria-current": context.current?.id === event.id ? "time" : undefined, onClick: () => { onEventSeek(event); onEventInfo(event); }, children: [_jsx("time", { dateTime: formatUtcTimestamp(event.timeUtcMs), children: formatUtcTimestamp(event.timeUtcMs) }), _jsx("span", { children: event.label })] }) }, event.id))) })] }));
84
110
  }
@@ -1,8 +1,8 @@
1
1
  /* The top bar: one compact row of icon buttons at the top left, and the Developer cog on its own at the top right. */
2
2
 
3
- .shell-toolbar { position: relative; z-index: 1; max-width: 100%; }
3
+ .astraeus-shell .shell-toolbar { position: relative; z-index: 1; max-width: 100%; }
4
4
 
5
- .top-bar {
5
+ .astraeus-shell .top-bar {
6
6
  display: flex;
7
7
  align-items: center;
8
8
  gap: 6px;
@@ -13,19 +13,19 @@
13
13
  box-shadow: 0 8px 24px rgba(0, 0, 0, .24);
14
14
  backdrop-filter: blur(8px);
15
15
  }
16
- .top-bar .object-controls,
17
- .top-bar .scale-control,
18
- .top-bar .switch-control { display: contents; }
19
- .object-camera-actions { display: flex; align-items: center; gap: 6px; }
20
- .top-bar-divider { flex: 0 0 auto; width: 1px; height: 22px; margin: 0 4px; background: var(--ui-border, rgba(240, 230, 218, .18)); }
16
+ .astraeus-shell .top-bar .object-controls,
17
+ .astraeus-shell .top-bar .scale-control,
18
+ .astraeus-shell .top-bar .switch-control { display: contents; }
19
+ .astraeus-shell .object-camera-actions { display: flex; align-items: center; gap: 6px; }
20
+ .astraeus-shell .top-bar-divider { flex: 0 0 auto; width: 1px; height: 22px; margin: 0 4px; background: var(--ui-border, rgba(240, 230, 218, .18)); }
21
21
 
22
22
  .astraeus-shell .object-picker { min-width: 0; max-width: 220px; }
23
- .top-bar-button-text { display: none; }
23
+ .astraeus-shell .top-bar-button-text { display: none; }
24
24
 
25
- .scale-control { position: relative; }
25
+ .astraeus-shell .scale-control { position: relative; }
26
26
  .astraeus-shell .scale-toggle { width: auto; white-space: nowrap; }
27
27
 
28
- .scale-menu {
28
+ .astraeus-shell .scale-menu {
29
29
  position: absolute;
30
30
  z-index: 6;
31
31
  top: calc(100% + 8px);
@@ -39,10 +39,10 @@
39
39
  background: rgba(13, 13, 13, .97);
40
40
  box-shadow: 0 8px 24px rgba(0, 0, 0, .42);
41
41
  }
42
- .scale-menu[hidden] { display: none !important; }
42
+ .astraeus-shell .scale-menu[hidden] { display: none !important; }
43
43
 
44
- .top-bar .scale-explanation { display: contents; }
45
- .scale-explanation-panel {
44
+ .astraeus-shell .top-bar .scale-explanation { display: contents; }
45
+ .astraeus-shell .scale-explanation-panel {
46
46
  position: absolute;
47
47
  z-index: 6;
48
48
  top: calc(100% + 8px);
@@ -56,11 +56,11 @@
56
56
  font-size: 13px;
57
57
  line-height: 1.45;
58
58
  }
59
- .scale-explanation-panel[hidden] { display: none !important; }
60
- .scale-explanation-panel p { margin: 0 0 8px; }
61
- .scale-explanation-panel .scale-explanation-note { margin: 0; opacity: .75; }
59
+ .astraeus-shell .scale-explanation-panel[hidden] { display: none !important; }
60
+ .astraeus-shell .scale-explanation-panel p { margin: 0 0 8px; }
61
+ .astraeus-shell .scale-explanation-panel .scale-explanation-note { margin: 0; opacity: .75; }
62
62
 
63
- .developer-mode-toggle {
63
+ .astraeus-shell .developer-mode-toggle {
64
64
  position: absolute;
65
65
  z-index: 5;
66
66
  /* Level with the row of controls in the bar beside it (the bar's 12 px offset, its border and its padding). */
@@ -70,13 +70,13 @@
70
70
 
71
71
  /* The tablet band keeps the row; its 44 px targets come from the shared control stylesheet. */
72
72
  @media (min-width: 701px) and (max-width: 900px) {
73
- .shell-toolbar { max-width: calc(100vw - 72px); }
73
+ .astraeus-shell .shell-toolbar { max-width: calc(100vw - 72px); }
74
74
  }
75
75
 
76
76
  /* Display switches a story placed: buttons in the bar, and one small panel opened from a Display button (same look as the scale menu). */
77
- .top-bar .display-switches,
78
- .top-bar .switch-panel-host { display: contents; }
79
- .switch-panel {
77
+ .astraeus-shell .top-bar .display-switches,
78
+ .astraeus-shell .top-bar .switch-panel-host { display: contents; }
79
+ .astraeus-shell .switch-panel {
80
80
  position: absolute;
81
81
  z-index: 6;
82
82
  top: calc(100% + 8px);
@@ -91,4 +91,4 @@
91
91
  background: rgba(13, 13, 13, .97);
92
92
  box-shadow: 0 8px 24px rgba(0, 0, 0, .42);
93
93
  }
94
- .switch-panel[hidden] { display: none !important; }
94
+ .astraeus-shell .switch-panel[hidden] { display: none !important; }
@@ -1,5 +1,5 @@
1
1
  import type { ExperienceCameraPreset, ExperienceConfig } from "./experience.js";
2
- import { type DisplaySwitchItem } from "./DisplaySwitches.js";
2
+ import { type DisplaySwitchItem, type ViewChoice } from "./DisplaySwitches.js";
3
3
  import { type ExperienceSwitch } from "./SwitchControl.js";
4
4
  import type { ScaleChoice, ScaleId } from "./scaleModel.js";
5
5
  import "./TopBar.css";
@@ -12,6 +12,8 @@ interface Props {
12
12
  readonly onCameraPreset: (preset: ExperienceCameraPreset) => void;
13
13
  readonly infoOpen: boolean;
14
14
  readonly onToggleInfo: () => void;
15
+ /** The id of the information panel the Info button opens, made once per viewer by the shell. */
16
+ readonly infoPanelId: string;
15
17
  readonly scaleId: ScaleId;
16
18
  readonly onScaleChange: (id: ScaleId) => void;
17
19
  readonly scaleChoices?: readonly ScaleChoice[];
@@ -19,13 +21,17 @@ interface Props {
19
21
  readonly switcher?: ExperienceSwitch;
20
22
  /** Display switches a story placed in the bar or its panel; absent or empty: none, the bar as it was. */
21
23
  readonly displaySwitches?: readonly DisplaySwitchItem[];
24
+ /** The views the scene names, in the bar or its switch panel; absent: none. */
25
+ readonly viewChoice?: ViewChoice;
22
26
  }
23
27
  interface DeveloperProps {
28
+ /** The id of the drawer this cog opens, made once per viewer by the shell. */
29
+ readonly drawerId: string;
24
30
  readonly developerMode: boolean;
25
31
  readonly onDeveloperModeChange: (enabled: boolean) => void;
26
32
  }
27
33
  /** The single compact bar: body picker, Info, camera buttons and Scale in one row. */
28
- export declare function TopBar({ scaleId, onScaleChange, scaleChoices, switcher, displaySwitches, ...objectControls }: Props): import("react").JSX.Element;
34
+ export declare function TopBar({ scaleId, onScaleChange, scaleChoices, switcher, displaySwitches, viewChoice, ...objectControls }: Props): import("react").JSX.Element;
29
35
  /** Developer mode stays public, as a cog on its own at the top right of the shell. */
30
- export declare function DeveloperToggle({ developerMode, onDeveloperModeChange }: DeveloperProps): import("react").JSX.Element;
36
+ export declare function DeveloperToggle({ developerMode, onDeveloperModeChange, drawerId }: DeveloperProps): import("react").JSX.Element;
31
37
  export {};
@@ -1,15 +1,15 @@
1
1
  import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
2
2
  import { ObjectControls } from "./ObjectControls.js";
3
3
  import { ScaleControl } from "./ScaleControl.js";
4
- import { DisplaySwitches } from "./DisplaySwitches.js";
4
+ import { DisplaySwitches, ViewButtons, viewChoiceInPanel } from "./DisplaySwitches.js";
5
5
  import { SwitchControl } from "./SwitchControl.js";
6
6
  import { CogIcon } from "./topBarIcons.js";
7
7
  import "./TopBar.css";
8
8
  /** The single compact bar: body picker, Info, camera buttons and Scale in one row. */
9
- export function TopBar({ scaleId, onScaleChange, scaleChoices, switcher, displaySwitches = [], ...objectControls }) {
10
- return (_jsx("div", { className: "shell-toolbar", children: _jsxs("div", { className: "top-bar", children: [switcher !== undefined && switcher.options.length > 1 && (_jsxs(_Fragment, { children: [_jsx(SwitchControl, { choice: switcher }), _jsx("span", { className: "top-bar-divider", "aria-hidden": "true" })] })), _jsx(ObjectControls, { ...objectControls }), _jsx("span", { className: "top-bar-divider", "aria-hidden": "true" }), _jsx(ScaleControl, { scaleId: scaleId, onScaleChange: onScaleChange, choices: scaleChoices }), displaySwitches.length > 0 && (_jsxs(_Fragment, { children: [_jsx("span", { className: "top-bar-divider", "aria-hidden": "true" }), _jsx(DisplaySwitches, { switches: displaySwitches })] }))] }) }));
9
+ export function TopBar({ scaleId, onScaleChange, scaleChoices, switcher, displaySwitches = [], viewChoice, ...objectControls }) {
10
+ return (_jsx("div", { className: "shell-toolbar", children: _jsxs("div", { className: "top-bar", children: [switcher !== undefined && switcher.options.length > 1 && (_jsxs(_Fragment, { children: [_jsx(SwitchControl, { choice: switcher }), _jsx("span", { className: "top-bar-divider", "aria-hidden": "true" })] })), viewChoice !== undefined && viewChoice.place === "top-bar" && viewChoice.options.length > 1 && (_jsxs(_Fragment, { children: [_jsx(ViewButtons, { choice: viewChoice }), _jsx("span", { className: "top-bar-divider", "aria-hidden": "true" })] })), _jsx(ObjectControls, { ...objectControls }), _jsx("span", { className: "top-bar-divider", "aria-hidden": "true" }), _jsx(ScaleControl, { scaleId: scaleId, onScaleChange: onScaleChange, choices: scaleChoices }), (displaySwitches.length > 0 || viewChoiceInPanel(viewChoice)) && (_jsxs(_Fragment, { children: [_jsx("span", { className: "top-bar-divider", "aria-hidden": "true" }), _jsx(DisplaySwitches, { switches: displaySwitches, viewChoice: viewChoice })] }))] }) }));
11
11
  }
12
12
  /** Developer mode stays public, as a cog on its own at the top right of the shell. */
13
- export function DeveloperToggle({ developerMode, onDeveloperModeChange }) {
14
- return (_jsx("button", { className: "developer-mode-toggle ui-icon ui-pill", type: "button", "aria-label": "Developer mode", title: "Developer mode", "aria-pressed": developerMode, "aria-expanded": developerMode, "aria-controls": "developer-tools", onClick: () => onDeveloperModeChange(!developerMode), children: _jsx(CogIcon, {}) }));
13
+ export function DeveloperToggle({ developerMode, onDeveloperModeChange, drawerId }) {
14
+ return (_jsx("button", { className: "developer-mode-toggle ui-icon ui-pill", type: "button", "aria-label": "Developer mode", title: "Developer mode", "aria-pressed": developerMode, "aria-expanded": developerMode, "aria-controls": drawerId, onClick: () => onDeveloperModeChange(!developerMode), children: _jsx(CogIcon, {}) }));
15
15
  }
@@ -1,14 +1,14 @@
1
1
  import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
2
2
  import { ObjectControls } from "./ObjectControls.js";
3
3
  import { ScaleControl } from "./ScaleControl.js";
4
- import { DisplaySwitches } from "./DisplaySwitches.js";
4
+ import { DisplaySwitches, ViewButtons, viewChoiceInPanel } from "./DisplaySwitches.js";
5
5
  import { SwitchControl } from "./SwitchControl.js";
6
6
  import { CogIcon } from "./topBarIcons.js";
7
7
  /** The single compact bar: body picker, Info, camera buttons and Scale in one row. */
8
- export function TopBar({ scaleId, onScaleChange, scaleChoices, switcher, displaySwitches = [], ...objectControls }) {
9
- return (_jsx("div", { className: "shell-toolbar", children: _jsxs("div", { className: "top-bar", children: [switcher !== undefined && switcher.options.length > 1 && (_jsxs(_Fragment, { children: [_jsx(SwitchControl, { choice: switcher }), _jsx("span", { className: "top-bar-divider", "aria-hidden": "true" })] })), _jsx(ObjectControls, { ...objectControls }), _jsx("span", { className: "top-bar-divider", "aria-hidden": "true" }), _jsx(ScaleControl, { scaleId: scaleId, onScaleChange: onScaleChange, choices: scaleChoices }), displaySwitches.length > 0 && (_jsxs(_Fragment, { children: [_jsx("span", { className: "top-bar-divider", "aria-hidden": "true" }), _jsx(DisplaySwitches, { switches: displaySwitches })] }))] }) }));
8
+ export function TopBar({ scaleId, onScaleChange, scaleChoices, switcher, displaySwitches = [], viewChoice, ...objectControls }) {
9
+ return (_jsx("div", { className: "shell-toolbar", children: _jsxs("div", { className: "top-bar", children: [switcher !== undefined && switcher.options.length > 1 && (_jsxs(_Fragment, { children: [_jsx(SwitchControl, { choice: switcher }), _jsx("span", { className: "top-bar-divider", "aria-hidden": "true" })] })), viewChoice !== undefined && viewChoice.place === "top-bar" && viewChoice.options.length > 1 && (_jsxs(_Fragment, { children: [_jsx(ViewButtons, { choice: viewChoice }), _jsx("span", { className: "top-bar-divider", "aria-hidden": "true" })] })), _jsx(ObjectControls, { ...objectControls }), _jsx("span", { className: "top-bar-divider", "aria-hidden": "true" }), _jsx(ScaleControl, { scaleId: scaleId, onScaleChange: onScaleChange, choices: scaleChoices }), (displaySwitches.length > 0 || viewChoiceInPanel(viewChoice)) && (_jsxs(_Fragment, { children: [_jsx("span", { className: "top-bar-divider", "aria-hidden": "true" }), _jsx(DisplaySwitches, { switches: displaySwitches, viewChoice: viewChoice })] }))] }) }));
10
10
  }
11
11
  /** Developer mode stays public, as a cog on its own at the top right of the shell. */
12
- export function DeveloperToggle({ developerMode, onDeveloperModeChange }) {
13
- return (_jsx("button", { className: "developer-mode-toggle ui-icon ui-pill", type: "button", "aria-label": "Developer mode", title: "Developer mode", "aria-pressed": developerMode, "aria-expanded": developerMode, "aria-controls": "developer-tools", onClick: () => onDeveloperModeChange(!developerMode), children: _jsx(CogIcon, {}) }));
12
+ export function DeveloperToggle({ developerMode, onDeveloperModeChange, drawerId }) {
13
+ return (_jsx("button", { className: "developer-mode-toggle ui-icon ui-pill", type: "button", "aria-label": "Developer mode", title: "Developer mode", "aria-pressed": developerMode, "aria-expanded": developerMode, "aria-controls": drawerId, onClick: () => onDeveloperModeChange(!developerMode), children: _jsx(CogIcon, {}) }));
14
14
  }
@@ -3,15 +3,9 @@ export declare const BOOT_FADE_LIMITS: {
3
3
  readonly min: 0;
4
4
  readonly max: 3;
5
5
  };
6
- /** The fade time in force: `?loadfade=<seconds>`, else the saved setting, else the default. */
7
- export declare function bootFadeSeconds(search?: string): number;
6
+ /** The fade time in force: the look's `loadFadeSeconds` (the scene's, or the address's over it), else the saved setting, else the default. */
7
+ export declare function bootFadeSeconds(look?: {
8
+ readonly loadFadeSeconds?: number;
9
+ }): number;
8
10
  /** Saves the fade time for the next load. */
9
11
  export declare function saveBootFadeSeconds(seconds: number): void;
10
- /** The cover's current showing; a scene notes it when it mounts and hands it to `hideBootLoader`. */
11
- export declare function bootShowing(): number;
12
- /** Brings the loading cover back (a switch inside the page); a no-op when the page never had one. Hidden again by `hideBootLoader` on the next scene's first frame. */
13
- export declare function showBootLoader(): void;
14
- /** Fades the loader out and removes it. Safe to call more than once. A scene passes the showing it mounted under; a later showing is not its to hide. */
15
- export declare function hideBootLoader(showing?: number): void;
16
- /** Replaces the loader's animation with its failure message. */
17
- export declare function failBootLoader(): void;
@@ -1,16 +1,15 @@
1
- // The loading screen is plain markup and styles in app.html (so it shows before any script); this module only ends it.
2
- // It knows nothing of any demo: `hideBootLoader` is called on each scene's first drawn frame (`showBootLoader` brings the cover back for a switch), and `failBootLoader` when the start fails.
1
+ // The loading fade time the viewer keeps: the look's `loadFadeSeconds`, the Developer drawer's saved setting, else the default.
2
+ // The cover itself belongs to the host page (the demo site owns its markup, showing, fading and failure); the engine never looks one up.
3
3
  export const BOOT_FADE_DEFAULT_SECONDS = 0.6;
4
4
  export const BOOT_FADE_LIMITS = { min: 0, max: 3 };
5
5
  const STORAGE_KEY = "astraeus.loadFade";
6
6
  function clampFade(seconds) {
7
7
  return Number.isFinite(seconds) ? Math.min(BOOT_FADE_LIMITS.max, Math.max(BOOT_FADE_LIMITS.min, seconds)) : BOOT_FADE_DEFAULT_SECONDS;
8
8
  }
9
- /** The fade time in force: `?loadfade=<seconds>`, else the saved setting, else the default. */
10
- export function bootFadeSeconds(search = window.location.search) {
11
- const asked = new URLSearchParams(search).get("loadfade");
12
- if (asked !== null && asked.trim() !== "")
13
- return clampFade(Number(asked));
9
+ /** The fade time in force: the look's `loadFadeSeconds` (the scene's, or the address's over it), else the saved setting, else the default. */
10
+ export function bootFadeSeconds(look = {}) {
11
+ if (look.loadFadeSeconds !== undefined)
12
+ return clampFade(look.loadFadeSeconds);
14
13
  try {
15
14
  const saved = window.localStorage.getItem(STORAGE_KEY);
16
15
  if (saved !== null)
@@ -26,48 +25,3 @@ export function saveBootFadeSeconds(seconds) {
26
25
  }
27
26
  catch { /* not saved */ }
28
27
  }
29
- // The loader's markup as the page first had it, kept so a switch inside the page can bring the cover back after it was removed.
30
- const bootTemplate = typeof document === "undefined" ? null : document.getElementById("boot")?.cloneNode(true) ?? null;
31
- // How many times the cover has been brought back, so a scene mounted before the latest showing cannot hide it (I-074).
32
- let showings = 0;
33
- // The removal a hide scheduled after its fade, cancelled when the cover is shown again before it runs (I-074).
34
- let removal;
35
- /** The cover's current showing; a scene notes it when it mounts and hands it to `hideBootLoader`. */
36
- export function bootShowing() {
37
- return showings;
38
- }
39
- /** Brings the loading cover back (a switch inside the page); a no-op when the page never had one. Hidden again by `hideBootLoader` on the next scene's first frame. */
40
- export function showBootLoader() {
41
- showings += 1;
42
- if (removal !== undefined) {
43
- window.clearTimeout(removal);
44
- removal = undefined;
45
- }
46
- const existing = document.getElementById("boot");
47
- if (existing !== null) {
48
- existing.style.removeProperty("--boot-fade");
49
- existing.dataset.state = "loading";
50
- return;
51
- }
52
- if (bootTemplate === null)
53
- return;
54
- const boot = bootTemplate.cloneNode(true);
55
- boot.dataset.state = "loading";
56
- document.body.prepend(boot);
57
- }
58
- /** Fades the loader out and removes it. Safe to call more than once. A scene passes the showing it mounted under; a later showing is not its to hide. */
59
- export function hideBootLoader(showing = showings) {
60
- const boot = document.getElementById("boot");
61
- if (showing !== showings || boot === null || boot.dataset.state === "done" || boot.dataset.state === "failed")
62
- return;
63
- const seconds = bootFadeSeconds();
64
- boot.style.setProperty("--boot-fade", `${seconds}s`);
65
- boot.dataset.state = "done";
66
- removal = window.setTimeout(() => { removal = undefined; boot.remove(); }, seconds * 1000 + 100);
67
- }
68
- /** Replaces the loader's animation with its failure message. */
69
- export function failBootLoader() {
70
- const boot = document.getElementById("boot");
71
- if (boot !== null)
72
- boot.dataset.state = "failed";
73
- }
@@ -10,27 +10,27 @@
10
10
  }
11
11
 
12
12
  /* Top bar: one tight row, close to the corner. */
13
- [data-embedded="true"][data-phone="false"] .shell-top { top: 6px; left: 6px; max-width: calc(100vw - 120px); --shell-timeline-space: 60px; }
14
- [data-embedded="true"][data-phone="false"] .top-bar { gap: 4px; padding: 3px; border-radius: 10px; box-shadow: 0 4px 14px rgba(0, 0, 0, .24); }
15
- [data-embedded="true"][data-phone="false"] .top-bar-divider { height: 16px; margin: 0 2px; }
16
- [data-embedded="true"][data-phone="false"] .developer-mode-toggle { top: 9px; right: 8px; }
17
- [data-embedded="true"][data-phone="false"] .scale-menu,
18
- [data-embedded="true"][data-phone="false"] .scale-explanation-panel { top: calc(100% + 4px); }
13
+ .astraeus-shell[data-embedded="true"]:where([data-phone="false"]) .shell-top { top: 6px; left: 6px; max-width: calc(100vw - 120px); --shell-timeline-space: 60px; }
14
+ .astraeus-shell[data-embedded="true"][data-phone="false"] .top-bar { gap: 4px; padding: 3px; border-radius: 10px; box-shadow: 0 4px 14px rgba(0, 0, 0, .24); }
15
+ .astraeus-shell[data-embedded="true"][data-phone="false"] .top-bar-divider { height: 16px; margin: 0 2px; }
16
+ .astraeus-shell[data-embedded="true"][data-phone="false"] .developer-mode-toggle { top: 9px; right: 8px; }
17
+ .astraeus-shell[data-embedded="true"][data-phone="false"] .scale-menu,
18
+ .astraeus-shell[data-embedded="true"][data-phone="false"] .scale-explanation-panel { top: calc(100% + 4px); }
19
19
 
20
20
  /* Timeline: one slim line, a thinner scrubber. */
21
- [data-embedded="true"][data-phone="false"] .timeline-bar { right: 6px; bottom: 6px; left: 6px; padding: 3px 8px; border-radius: 10px; font-size: 12px; }
22
- [data-embedded="true"][data-phone="false"] .timeline-main-row { gap: 8px; }
23
- [data-embedded="true"][data-phone="false"] .timeline-time { font-size: 12px; }
24
- [data-embedded="true"][data-phone="false"] .timeline-bar .timeline-speed select { width: 150px; }
21
+ .astraeus-shell[data-embedded="true"][data-phone="false"] .timeline-bar { right: 6px; bottom: 6px; left: 6px; padding: 3px 8px; border-radius: 10px; font-size: 12px; }
22
+ .astraeus-shell[data-embedded="true"][data-phone="false"] .timeline-main-row { gap: 8px; }
23
+ .astraeus-shell[data-embedded="true"][data-phone="false"] .timeline-time { font-size: 12px; }
24
+ .astraeus-shell[data-embedded="true"][data-phone="false"] .timeline-bar .timeline-speed select { width: 150px; }
25
25
  @media (pointer: fine) {
26
- [data-embedded="true"][data-phone="false"] .timeline-track,
27
- [data-embedded="true"][data-phone="false"] .timeline-track input[type="range"],
28
- [data-embedded="true"][data-phone="false"] .timeline-track input[type="range"]::-webkit-slider-runnable-track { height: 20px; }
29
- [data-embedded="true"][data-phone="false"] .timeline-track input[type="range"]::-webkit-slider-thumb { margin-top: 1px; }
26
+ .astraeus-shell[data-embedded="true"][data-phone="false"] .timeline-track,
27
+ .astraeus-shell[data-embedded="true"][data-phone="false"] .timeline-track input[type="range"],
28
+ .astraeus-shell[data-embedded="true"][data-phone="false"] .timeline-track input[type="range"]::-webkit-slider-runnable-track { height: 20px; }
29
+ .astraeus-shell[data-embedded="true"][data-phone="false"] .timeline-track input[type="range"]::-webkit-slider-thumb { margin-top: 1px; }
30
30
  }
31
- [data-embedded="true"][data-phone="false"] .timeline-bar .timeline-expanded { bottom: calc(100% + 6px); }
31
+ .astraeus-shell[data-embedded="true"][data-phone="false"] .timeline-bar .timeline-expanded { bottom: calc(100% + 6px); }
32
32
 
33
33
  /* A phone-sized frame keeps its pill, drawers and 44 px targets; only the margins and the timeline's padding tighten. */
34
- [data-embedded="true"][data-phone="true"] .controls-pill { top: calc(4px + var(--safe-top)); left: calc(4px + var(--safe-left)); }
35
- [data-embedded="true"][data-phone="true"] .developer-mode-toggle { top: calc(4px + var(--safe-top)); right: calc(4px + var(--safe-right)); }
36
- [data-embedded="true"][data-phone="true"] .timeline-bar { right: calc(4px + var(--safe-right)); bottom: calc(4px + var(--safe-bottom)); left: calc(4px + var(--safe-left)); padding: 14px 8px 1px; }
34
+ .astraeus-shell[data-embedded="true"][data-phone="true"] .controls-pill { top: calc(4px + var(--safe-top)); left: calc(4px + var(--safe-left)); }
35
+ .astraeus-shell[data-embedded="true"][data-phone="true"] .developer-mode-toggle { top: calc(4px + var(--safe-top)); right: calc(4px + var(--safe-right)); }
36
+ .astraeus-shell[data-embedded="true"][data-phone="true"] .timeline-bar { right: calc(4px + var(--safe-right)); bottom: calc(4px + var(--safe-bottom)); left: calc(4px + var(--safe-left)); padding: 14px 8px 1px; }
@@ -65,7 +65,7 @@ export interface ExperienceConfig {
65
65
  readonly rates: readonly number[];
66
66
  /** True draws no timeline bar (and no phone timeline drawer or reserved space); the clock then runs or stays frozen as the definition says. Absent: the bar is shown. */
67
67
  readonly hideTimeline?: boolean;
68
- /** Short story panels that open as playback reaches their time; see `parseStoryPanels`. Omit for an experience with none. */
68
+ /** Short story panels that open as playback reaches their time; see `resolveStoryPanels`. Omit for an experience with none. */
69
69
  readonly storyPanels?: StoryPanelSet;
70
70
  /** A planet's moons by family for the sliding moon panel; omit for an experience with none. Every moon listed must also be an object. */
71
71
  readonly moonFamilies?: MoonFamilyList;
@@ -1,3 +1,5 @@
1
+ import { moonCountText, moonListDateText, moonListSummary } from "../core/moonListText.js";
2
+ export { moonCountText, moonListDateText, moonListSummary };
1
3
  /**
2
4
  * What the moon browser (the sliding panel of a planet's moons by family) needs, as plain data any experience can hand the shell
3
5
  * (ARCH-01): families with a one-line description, and each family's moons. The panel shows named moons first and folds the unnamed away.
@@ -35,12 +37,6 @@ export interface MoonSplit {
35
37
  }
36
38
  /** Named moons first (as listed), provisional designations apart. */
37
39
  export declare function splitNamed(moons: readonly MoonListing[]): MoonSplit;
38
- /** A family's heading count: "5 moons", "1 moon". */
39
- export declare function moonCountText(count: number): string;
40
- /** A date from the data (YYYY-MM-DD, or an ISO timestamp) as "18 October 2026"; the text itself when it is not a date. */
41
- export declare function moonListDateText(date: string): string;
42
- /** "115 moons in the JPL Horizons list of 18 October 2026": the count is the moons the list holds, the source and date come from the data. */
43
- export declare function moonListSummary(count: number, source?: string, date?: string): string;
44
40
  /** The summary of a whole moon list: every moon in every family, counted live. */
45
41
  export declare const moonFamilyListSummary: (list: MoonFamilyList) => string;
46
42
  export interface MoonMatch {
@@ -1,26 +1,10 @@
1
+ import { moonCountText, moonListDateText, moonListSummary } from "../core/moonListText.js";
2
+ export { moonCountText, moonListDateText, moonListSummary };
1
3
  /** Named moons first (as listed), provisional designations apart. */
2
4
  export function splitNamed(moons) {
3
5
  return { named: moons.filter((moon) => moon.named), unnamed: moons.filter((moon) => !moon.named) };
4
6
  }
5
7
  const squash = (text) => text.toLowerCase().replace(/[^a-z0-9]+/g, "");
6
- /** A family's heading count: "5 moons", "1 moon". */
7
- export function moonCountText(count) {
8
- return count === 1 ? "1 moon" : `${count} moons`;
9
- }
10
- /** A date from the data (YYYY-MM-DD, or an ISO timestamp) as "18 October 2026"; the text itself when it is not a date. */
11
- export function moonListDateText(date) {
12
- const parsed = /^\d{4}-\d{2}-\d{2}/.test(date) ? new Date(`${date.slice(0, 10)}T00:00:00Z`) : new Date(Number.NaN);
13
- return Number.isNaN(parsed.getTime()) ? date : parsed.toLocaleDateString("en-GB", { day: "numeric", month: "long", year: "numeric", timeZone: "UTC" });
14
- }
15
- /** "115 moons in the JPL Horizons list of 18 October 2026": the count is the moons the list holds, the source and date come from the data. */
16
- export function moonListSummary(count, source, date) {
17
- const head = moonCountText(count);
18
- if (source !== undefined && date !== undefined)
19
- return `${head} in the ${source} list of ${moonListDateText(date)}`;
20
- if (date !== undefined)
21
- return `${head}, list of ${moonListDateText(date)}`;
22
- return head;
23
- }
24
8
  /** The summary of a whole moon list: every moon in every family, counted live. */
25
9
  export const moonFamilyListSummary = (list) => moonListSummary(list.families.reduce((total, family) => total + family.moons.length, 0), list.listSource, list.listDate);
26
10
  /** The moons whose name or designation contains the query, ignoring case, spaces and punctuation ("s2003 j19" finds "S/2003 J 19"); none for an empty query. */