@industry-theme/file-city-panel 0.5.63 → 0.5.64

package/dist/panels/FileCityTrailExplorerPanel/FileCityTrailExplorerPanel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FileCityTrailExplorerPanel.d.ts","sourceRoot":"","sources":["../../../src/panels/FileCityTrailExplorerPanel/FileCityTrailExplorerPanel.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAa1B,OAAO,8BAA8B,CAAC;AAatC,OAAO,KAAK,EAEV,oCAAoC,EAErC,MAAM,wCAAwC,CAAC;AA4BhD;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,0BAA0B,EAAE,KAAK,CAAC,EAAE,CAC/C,oCAAoC,CA+ErC,CAAC"}
+{"version":3,"file":"FileCityTrailExplorerPanel.d.ts","sourceRoot":"","sources":["../../../src/panels/FileCityTrailExplorerPanel/FileCityTrailExplorerPanel.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAa1B,OAAO,8BAA8B,CAAC;AAiBtC,OAAO,KAAK,EAEV,oCAAoC,EAErC,MAAM,wCAAwC,CAAC;AA4BhD;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,0BAA0B,EAAE,KAAK,CAAC,EAAE,CAC/C,oCAAoC,CA+ErC,CAAC"}

package/dist/panels/FileCityTrailExplorerPanel/overlays/TrailFilePath.d.ts

@@ -0,0 +1,34 @@
+import React from 'react';
+import type { CityBuilding } from '@principal-ai/file-city-react';
+import type { OnCameraFrame } from './TrailLeaderLine';
+export interface TrailFilePathHandle {
+    /** Pass this through alongside the leader-line's `onCameraFrame`. */
+    onCameraFrame: OnCameraFrame;
+}
+export interface TrailFilePathProps {
+    /** Container the SVG sits inside; used to convert client-rect coords to local. */
+    containerRef: React.RefObject<HTMLDivElement | null>;
+    /**
+     * Ordered list of buildings to walk through, one per marker. Empty
+     * (or single-entry) lists hide the path entirely. Repeats are kept
+     * — if a trail visits the same file twice, the path returns there.
+     */
+    buildings: readonly CityBuilding[];
+    /**
+     * `FileCity3D` re-centers the city around the world origin, so building
+     * positions need this offset subtracted before projecting through the
+     * camera. Compute as `(bounds.minX + bounds.maxX) / 2` etc.
+     */
+    cityCenter: {
+        x: number;
+        z: number;
+    } | null;
+}
+/**
+ * Sequential-path overlay: connects every marker's building in order
+ * with a dashed curve, dots at each step, and step indices floating
+ * above the dots. Drawn imperatively from inside `onCameraFrame` so it
+ * stays in lockstep with the city's camera without re-rendering React.
+ */
+export declare const TrailFilePath: React.ForwardRefExoticComponent<TrailFilePathProps & React.RefAttributes<TrailFilePathHandle>>;
+//# sourceMappingURL=TrailFilePath.d.ts.map

package/dist/panels/FileCityTrailExplorerPanel/overlays/TrailFilePath.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TrailFilePath.d.ts","sourceRoot":"","sources":["../../../../src/panels/FileCityTrailExplorerPanel/overlays/TrailFilePath.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAElE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD,MAAM,WAAW,mBAAmB;IAClC,qEAAqE;IACrE,aAAa,EAAE,aAAa,CAAC;CAC9B;AAED,MAAM,WAAW,kBAAkB;IACjC,kFAAkF;IAClF,YAAY,EAAE,KAAK,CAAC,SAAS,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IACrD;;;;OAIG;IACH,SAAS,EAAE,SAAS,YAAY,EAAE,CAAC;IACnC;;;;OAIG;IACH,UAAU,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CAC7C;AAED;;;;;GAKG;AACH,eAAO,MAAM,aAAa,gGAsKxB,CAAC"}

package/dist/panels/FileCityTrailExplorerPanel/overlays/TrailLeaderLine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TrailLeaderLine.d.ts","sourceRoot":"","sources":["../../../../src/panels/FileCityTrailExplorerPanel/overlays/TrailLeaderLine.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAElE;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,CAC1B,MAAM,EAAE,KAAK,CAAC,MAAM,EACpB,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,KACpC,IAAI,CAAC;AAEV,MAAM,WAAW,qBAAqB;IACpC,+DAA+D;IAC/D,aAAa,EAAE,aAAa,CAAC;CAC9B;AAED,MAAM,WAAW,oBAAoB;IACnC,kFAAkF;IAClF,YAAY,EAAE,KAAK,CAAC,SAAS,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IACrD,0DAA0D;IAC1D,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAC;IAC9B;;;;OAIG;IACH,UAAU,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC5C,2EAA2E;IAC3E,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;CAChD;AAED;;;;GAIG;AACH,eAAO,MAAM,eAAe,oGA6K1B,CAAC"}
+{"version":3,"file":"TrailLeaderLine.d.ts","sourceRoot":"","sources":["../../../../src/panels/FileCityTrailExplorerPanel/overlays/TrailLeaderLine.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAElE;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,CAC1B,MAAM,EAAE,KAAK,CAAC,MAAM,EACpB,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,KACpC,IAAI,CAAC;AAEV,MAAM,WAAW,qBAAqB;IACpC,+DAA+D;IAC/D,aAAa,EAAE,aAAa,CAAC;CAC9B;AAED,MAAM,WAAW,oBAAoB;IACnC,kFAAkF;IAClF,YAAY,EAAE,KAAK,CAAC,SAAS,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IACrD,0DAA0D;IAC1D,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAC;IAC9B;;;;OAIG;IACH,UAAU,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC5C,2EAA2E;IAC3E,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;CAChD;AAED;;;;GAIG;AACH,eAAO,MAAM,eAAe,oGAoM1B,CAAC"}

package/dist/panels.bundle.js

@@ -257701,14 +257701,30 @@ const TrailLeaderLine = React.forwardRef(function TrailLeaderLine2({ containerRe
       const sx = canvasLeft + (v.x * 0.5 + 0.5) * size.width;
       const sy = canvasTop + (v.y * -0.5 + 0.5) * size.height;
       const HEADER_BAND_OFFSET = 22;
-      const nodeCenterX = nodeRect.left + nodeRect.width / 2 - containerRect.left;
-      const aimRight = nodeCenterX < sx;
-      const bx = aimRight ? nodeRect.right - containerRect.left : nodeRect.left - containerRect.left;
+      const bx = nodeRect.left - containerRect.left;
       const by = nodeRect.top - containerRect.top + HEADER_BAND_OFFSET;
-      const dxRaw = (bx - sx) * 0.5;
-      const dxAbs = Math.max(80, Math.abs(dxRaw));
-      const dx = dxRaw < 0 ? -dxAbs : dxAbs;
-      const d = `M ${sx} ${sy} C ${sx + dx} ${sy}, ${bx - dx} ${by}, ${bx} ${by}`;
+      const ELBOW_GAP = 60;
+      const CORNER_RADIUS = 14;
+      const elbowX = Math.max(
+        canvasLeft + 8,
+        Math.min(sx, bx) - ELBOW_GAP
+      );
+      const goingUp = by < sy;
+      const r2 = Math.min(
+        CORNER_RADIUS,
+        Math.abs(sy - by) / 2,
+        Math.abs(sx - elbowX) / 2,
+        Math.abs(bx - elbowX) / 2
+      );
+      const cornerSign = goingUp ? -1 : 1;
+      const d = [
+        `M ${sx} ${sy}`,
+        `L ${elbowX + r2} ${sy}`,
+        `Q ${elbowX} ${sy} ${elbowX} ${sy + cornerSign * r2}`,
+        `L ${elbowX} ${by - cornerSign * r2}`,
+        `Q ${elbowX} ${by} ${elbowX + r2} ${by}`,
+        `L ${bx} ${by}`
+      ].join(" ");
       const pathEl = pathRef.current;
       const buildingEl = buildingMarkerRef.current;
       const nodeMarkerEl = nodeMarkerRef.current;
@@ -257790,6 +257806,139 @@ const TrailLeaderLine = React.forwardRef(function TrailLeaderLine2({ containerRe
     )
   ] });
 });
+const TrailFilePath = React.forwardRef(function TrailFilePath2({ containerRef, buildings, cityCenter }, ref) {
+  const { theme: theme2 } = useTheme();
+  const color2 = theme2.colors.accent ?? "#22d3ee";
+  const groupRef = React.useRef(null);
+  const projectScratch = React.useRef(new THREE.Vector3());
+  const buildingsRef = React.useRef(buildings);
+  const cityCenterRef = React.useRef(cityCenter);
+  React.useEffect(() => {
+    buildingsRef.current = buildings;
+  }, [buildings]);
+  React.useEffect(() => {
+    cityCenterRef.current = cityCenter;
+  }, [cityCenter]);
+  const hideAll = React.useCallback(() => {
+    const g2 = groupRef.current;
+    if (!g2) return;
+    g2.setAttribute("opacity", "0");
+  }, []);
+  React.useEffect(() => {
+    if (buildings.length < 2) hideAll();
+  }, [buildings, hideAll]);
+  const onCameraFrame = React.useCallback(
+    (camera, size) => {
+      const targets = buildingsRef.current;
+      const center = cityCenterRef.current;
+      const container = containerRef.current;
+      const g2 = groupRef.current;
+      if (!targets || targets.length < 2 || !center || !container || !g2 || size.width === 0) {
+        hideAll();
+        return;
+      }
+      const containerRect = container.getBoundingClientRect();
+      const canvasEl = container.querySelector("canvas");
+      if (!canvasEl) {
+        hideAll();
+        return;
+      }
+      const canvasRect = canvasEl.getBoundingClientRect();
+      const canvasLeft = canvasRect.left - containerRect.left;
+      const canvasTop = canvasRect.top - containerRect.top;
+      const points = [];
+      const v = projectScratch.current;
+      for (const b of targets) {
+        v.set(b.position.x - center.x, 0, b.position.z - center.z).project(
+          camera
+        );
+        const visible = v.z <= 1;
+        const x2 = canvasLeft + (v.x * 0.5 + 0.5) * size.width;
+        const y2 = canvasTop + (v.y * -0.5 + 0.5) * size.height;
+        points.push({ x: x2, y: y2, visible });
+      }
+      let d = "";
+      for (let i = 0; i < points.length; i++) {
+        const p2 = points[i];
+        if (!p2.visible) {
+          d += "";
+          continue;
+        }
+        if (i === 0 || !points[i - 1].visible) {
+          d += `M ${p2.x} ${p2.y} `;
+        } else {
+          d += `L ${p2.x} ${p2.y} `;
+        }
+      }
+      while (g2.children.length < 1 + targets.length * 2) {
+        g2.appendChild(
+          document.createElementNS("http://www.w3.org/2000/svg", "path")
+        );
+        g2.appendChild(
+          document.createElementNS("http://www.w3.org/2000/svg", "circle")
+        );
+        g2.appendChild(
+          document.createElementNS("http://www.w3.org/2000/svg", "text")
+        );
+      }
+      while (g2.children.length > 1 + targets.length * 2) {
+        g2.removeChild(g2.children[g2.children.length - 1]);
+      }
+      const pathEl = g2.children[0];
+      pathEl.setAttribute("d", d.trim() || "M 0 0");
+      pathEl.setAttribute("fill", "none");
+      pathEl.setAttribute("stroke", color2);
+      pathEl.setAttribute("stroke-width", "2");
+      pathEl.setAttribute("stroke-dasharray", "6 4");
+      pathEl.setAttribute("opacity", "0.75");
+      for (let i = 0; i < targets.length; i++) {
+        const dot = g2.children[1 + i * 2];
+        const label = g2.children[1 + i * 2 + 1];
+        const p2 = points[i];
+        if (!p2.visible) {
+          dot.setAttribute("opacity", "0");
+          label.setAttribute("opacity", "0");
+          continue;
+        }
+        dot.setAttribute("cx", String(p2.x));
+        dot.setAttribute("cy", String(p2.y));
+        dot.setAttribute("r", "6");
+        dot.setAttribute("fill", color2);
+        dot.setAttribute("stroke", "#0f1419");
+        dot.setAttribute("stroke-width", "1.5");
+        dot.setAttribute("opacity", "1");
+        label.setAttribute("x", String(p2.x));
+        label.setAttribute("y", String(p2.y - 10));
+        label.setAttribute("text-anchor", "middle");
+        label.setAttribute("fill", color2);
+        label.setAttribute("font-size", "11");
+        label.setAttribute("font-weight", "600");
+        label.setAttribute("opacity", "1");
+        label.textContent = String(i + 1);
+      }
+      g2.setAttribute("opacity", "1");
+    },
+    [containerRef, hideAll, color2]
+  );
+  React.useImperativeHandle(ref, () => ({ onCameraFrame }), [onCameraFrame]);
+  return /* @__PURE__ */ jsx(
+    "svg",
+    {
+      width: "100%",
+      height: "100%",
+      style: {
+        position: "absolute",
+        inset: 0,
+        pointerEvents: "none",
+        overflow: "visible",
+        // Above the city canvas (auto z-index) but below the floating
+        // overlays (z 1900) so the path only paints over the city.
+        zIndex: 26
+      },
+      children: /* @__PURE__ */ jsx("g", { ref: groupRef, opacity: 0 })
+    }
+  );
+});
 const PANEL_WIDTH_PCT = 38;
 const FLOAT_INSET = 16;
 const MIN_WIDTH_PX = 360;
@@ -257970,8 +258119,8 @@ const TrailMarkdownOverlay = ({
             ) })
           }
         ),
-        files && files.length > 0 ? /* @__PURE__ */ jsx(TrailFilesList, { files }) : null,
         nav ? /* @__PURE__ */ jsx(TrailMarkdownOverlayFooter, { nav }) : null,
+        files && files.length > 0 ? /* @__PURE__ */ jsx(TrailFilesList, { files }) : null,
         /* @__PURE__ */ jsx(
           "div",
           {
@@ -258533,7 +258682,7 @@ const pierreOptionsBase = {
 const pierreStyle = {
   display: "block"
 };
-const SEQUENCE_DRAWER_HEIGHT_PCT = 35;
+const SEQUENCE_DRAWER_HEIGHT_PCT = 45;
 const SNIPPET_PANE_WIDTH_PX = 460;
 const HEADER_HEIGHT_PX = 48;
 const PANEL_TRANSITION_MS = 280;
@@ -258648,6 +258797,10 @@ const FileCityTrailSequenceLayout = ({
     const first = markersForThisRepo[0];
     if (first) onSelectMarker(first.id);
   }, [markersForThisRepo, onSelectMarker]);
+  const [snippetExpanded, setSnippetExpanded] = React.useState(false);
+  React.useEffect(() => {
+    setSnippetExpanded(false);
+  }, [selectedMarkerId]);
   const handleStepPrev = React.useCallback(() => {
     if (stepperIndex < 0) return;
     if (stepperIndex === 0) {
@@ -258756,6 +258909,7 @@ const FileCityTrailSequenceLayout = ({
   const containerRef = React.useRef(null);
   const snippetPaneRef = React.useRef(null);
   const leaderLineRef = React.useRef(null);
+  const filePathRef = React.useRef(null);
   const [markdownOverlayWidth, setMarkdownOverlayWidth] = React.useState(null);
   const [snippetPaneEl, setSnippetPaneEl] = React.useState(null);
   const snippetPaneCallbackRef = React.useCallback(
@@ -258779,10 +258933,22 @@ const FileCityTrailSequenceLayout = ({
       z: (cityData.bounds.minZ + cityData.bounds.maxZ) / 2
     };
   }, [cityData]);
+  const trailPathBuildings = React.useMemo(() => {
+    if (!cityData || markersForThisRepo.length === 0) return [];
+    const buildingByPath = new Map(cityData.buildings.map((b) => [b.path, b]));
+    const out = [];
+    for (const m of markersForThisRepo) {
+      if (!m.sourcePath) continue;
+      const b = buildingByPath.get(m.sourcePath) ?? cityData.buildings.find((cb) => cb.path.endsWith(`/${m.sourcePath}`));
+      if (b) out.push(b);
+    }
+    return out;
+  }, [cityData, markersForThisRepo]);
   const onCameraFrame = React.useCallback(
     (camera, size) => {
-      var _a2;
+      var _a2, _b2;
       (_a2 = leaderLineRef.current) == null ? void 0 : _a2.onCameraFrame(camera, size);
+      (_b2 = filePathRef.current) == null ? void 0 : _b2.onCameraFrame(camera, size);
     },
     []
   );
@@ -258844,10 +259010,9 @@ const FileCityTrailSequenceLayout = ({
       if (showSnippetPane && snippetPaneWidth == null) return;
       const FLOAT_INSET2 = 16;
       const leftInset = hasOverlayMarkdown ? markdownOverlayWidth ?? 0 : 0;
-      const snippetW = snippetPaneWidth ?? SNIPPET_PANE_WIDTH_PX;
-      const rightInset = showSnippetPane ? snippetW + FLOAT_INSET2 : 0;
-      const topInset = FLOAT_INSET2;
-      const bottomInset = drawerHeightPct / 100 * containerSize.height;
+      const rightInset = 0;
+      const topInset = showSnippetPane ? containerSize.height * 0.5 + FLOAT_INSET2 : FLOAT_INSET2;
+      const bottomInset = showSnippetPane ? 0 : drawerHeightPct / 100 * containerSize.height;
       const result = computeCameraFraming({
         canvasW: containerSize.width,
         canvasH: containerSize.height,
@@ -258920,6 +259085,13 @@ const FileCityTrailSequenceLayout = ({
             onToggleSequenceDrawer: () => {
               setDrawerHeightOverridePct(null);
               setShowSequenceDrawer((v) => !v);
+            },
+            canExit: selectedMarkerId != null || showSequenceDrawer || snippetExpanded,
+            onExitTrail: () => {
+              onSelectMarker(null);
+              setShowSequenceDrawer(false);
+              setDrawerHeightOverridePct(null);
+              setSnippetExpanded(false);
             }
           }
         ),
@@ -258951,6 +259123,15 @@ const FileCityTrailSequenceLayout = ({
                   defaultBuildingColor: trailFilesActive ? theme2.colors.textTertiary : void 0
                 }
               ) : /* @__PURE__ */ jsx(CityLoadingPlaceholder, {}),
+              /* @__PURE__ */ jsx(
+                TrailFilePath,
+                {
+                  ref: filePathRef,
+                  containerRef,
+                  buildings: trailPathBuildings,
+                  cityCenter
+                }
+              ),
               /* @__PURE__ */ jsx(
                 TrailLeaderLine,
                 {
@@ -258978,7 +259159,7 @@ const FileCityTrailSequenceLayout = ({
                     onPrev: handleStepPrev,
                     onNext: handleStepNext
                   } : void 0,
-                  files: trailFiles
+                  files: showSequenceDrawer ? void 0 : trailFiles
                 }
               ) : null,
               /* @__PURE__ */ jsx(
@@ -259005,7 +259186,9 @@ const FileCityTrailSequenceLayout = ({
                   readFile,
                   onClose: () => onSelectMarker(null),
                   drawerHeightPct,
-                  disableBottomTransition: isResizingDrawer
+                  disableBottomTransition: isResizingDrawer,
+                  expanded: snippetExpanded,
+                  onToggleExpanded: () => setSnippetExpanded((v) => !v)
                 }
               ) : null
             ]
@@ -259167,7 +259350,9 @@ const SnippetSidePane = React.forwardRef(function SnippetSidePane2({
   readFile,
   onClose,
   drawerHeightPct,
-  disableBottomTransition
+  disableBottomTransition,
+  expanded,
+  onToggleExpanded
 }, ref) {
   const { theme: theme2 } = useTheme();
   if (!marker.sourcePath) {
@@ -259179,6 +259364,8 @@ const SnippetSidePane = React.forwardRef(function SnippetSidePane2({
         onClose,
         drawerHeightPct,
         disableBottomTransition,
+        expanded,
+        onToggleExpanded,
         children: /* @__PURE__ */ jsx(
           "div",
           {
@@ -259202,6 +259389,8 @@ const SnippetSidePane = React.forwardRef(function SnippetSidePane2({
       onClose,
       drawerHeightPct,
       disableBottomTransition,
+      expanded,
+      onToggleExpanded,
       children: snippet2.kind === "slice" ? /* @__PURE__ */ jsx(
         TrailSnippetView,
         {
@@ -259236,7 +259425,15 @@ const SnippetSidePane = React.forwardRef(function SnippetSidePane2({
 const SNIPPET_PANE_MIN_WIDTH_PX = 320;
 const SNIPPET_PANE_RESIZE_HANDLE_WIDTH = 6;
 const SidePaneFrame = React.forwardRef(
-  function SidePaneFrame2({ marker, onClose, children: children2, drawerHeightPct, disableBottomTransition }, ref) {
+  function SidePaneFrame2({
+    marker,
+    onClose,
+    children: children2,
+    drawerHeightPct,
+    disableBottomTransition,
+    expanded,
+    onToggleExpanded
+  }, ref) {
     const { theme: theme2 } = useTheme();
     const [widthPx, setWidthPx] = React.useState(null);
     const [isResizing, setIsResizing] = React.useState(false);
@@ -259307,7 +259504,7 @@ const SidePaneFrame = React.forwardRef(
           position: "absolute",
           top: 16,
           right: 16,
-          bottom: `calc(${drawerHeightPct}% + 16px)`,
+          bottom: expanded ? `calc(${drawerHeightPct}% + 16px)` : "50%",
           width: widthPx ?? SNIPPET_PANE_WIDTH_PX,
           minWidth: SNIPPET_PANE_MIN_WIDTH_PX,
           backgroundColor: theme2.colors.background,
@@ -259398,24 +259595,45 @@ const SidePaneFrame = React.forwardRef(
                     }
                   ) : null
                 ] }),
-                /* @__PURE__ */ jsx(
-                  "button",
-                  {
-                    onClick: onClose,
-                    style: {
-                      background: "transparent",
-                      color: theme2.colors.text,
-                      border: `1px solid ${theme2.colors.muted}`,
-                      borderRadius: theme2.radii[2],
-                      padding: "2px 8px",
-                      cursor: "pointer",
-                      fontSize: theme2.fontSizes[0],
-                      fontFamily: theme2.fonts.body,
-                      flexShrink: 0
-                    },
-                    children: "Close"
-                  }
-                )
+                /* @__PURE__ */ jsxs("div", { style: { display: "flex", gap: 6, flexShrink: 0 }, children: [
+                  /* @__PURE__ */ jsx(
+                    "button",
+                    {
+                      onClick: onToggleExpanded,
+                      "aria-pressed": expanded,
+                      title: expanded ? "Collapse to top half (city visible below)" : "Expand to fill the right column",
+                      style: {
+                        background: "transparent",
+                        color: theme2.colors.text,
+                        border: `1px solid ${theme2.colors.muted}`,
+                        borderRadius: theme2.radii[2],
+                        padding: "2px 8px",
+                        cursor: "pointer",
+                        fontSize: theme2.fontSizes[0],
+                        fontFamily: theme2.fonts.body,
+                        lineHeight: 1.2
+                      },
+                      children: expanded ? "▾" : "▴"
+                    }
+                  ),
+                  /* @__PURE__ */ jsx(
+                    "button",
+                    {
+                      onClick: onClose,
+                      style: {
+                        background: "transparent",
+                        color: theme2.colors.text,
+                        border: `1px solid ${theme2.colors.muted}`,
+                        borderRadius: theme2.radii[2],
+                        padding: "2px 8px",
+                        cursor: "pointer",
+                        fontSize: theme2.fontSizes[0],
+                        fontFamily: theme2.fonts.body
+                      },
+                      children: "Close"
+                    }
+                  )
+                ] })
               ]
             }
           ),
@@ -259432,7 +259650,9 @@ const TrailHeader = ({
   onToggle3D,
   hideToggle = false,
   showSequenceDrawer,
-  onToggleSequenceDrawer
+  onToggleSequenceDrawer,
+  canExit,
+  onExitTrail
 }) => {
   const { theme: theme2 } = useTheme();
   const toggleButtonStyle = (active) => ({
@@ -259517,6 +259737,30 @@ const TrailHeader = ({
               children: "Diagram"
             }
           ),
+          /* @__PURE__ */ jsx(
+            "button",
+            {
+              type: "button",
+              onClick: onExitTrail,
+              disabled: !canExit,
+              title: canExit ? "Return to the trail summary" : "Already at the trail summary",
+              style: {
+                flexShrink: 0,
+                fontFamily: theme2.fonts.body,
+                fontSize: theme2.fontSizes[0],
+                fontWeight: theme2.fontWeights.medium,
+                color: canExit ? theme2.colors.text : theme2.colors.textTertiary,
+                background: "transparent",
+                border: `1px solid ${theme2.colors.muted}`,
+                borderRadius: theme2.radii[3],
+                padding: "4px 10px",
+                cursor: canExit ? "pointer" : "not-allowed",
+                opacity: canExit ? 1 : 0.5,
+                lineHeight: 1.2
+              },
+              children: "Exit"
+            }
+          ),
           hideToggle ? null : /* @__PURE__ */ jsx(
             "button",
             {