@industry-theme/file-city-panel 0.5.60 → 0.5.62

package/dist/index.d.ts

@@ -1,10 +1,10 @@
-import type { PanelDefinition, PanelActions, CodeCityPanelContext, FeedCodeCityPanelContext, FileCitySequenceExplorerPanelActions, FileCitySequenceExplorerPanelContext } from './types';
+import type { PanelDefinition, PanelActions, CodeCityPanelContext, FeedCodeCityPanelContext, FileCitySequenceExplorerPanelActions, FileCitySequenceExplorerPanelContext, FileCityTrailExplorerPanelActions, FileCityTrailExplorerPanelContext } from './types';
 /**
  * Export array of panel definitions.
  * This is the required export for panel extensions.
  * Using generic types for v0.4.2+ typed actions and context.
  */
-export declare const panels: (PanelDefinition<PanelActions, CodeCityPanelContext> | PanelDefinition<PanelActions, FeedCodeCityPanelContext> | PanelDefinition<FileCitySequenceExplorerPanelActions, FileCitySequenceExplorerPanelContext>)[];
+export declare const panels: (PanelDefinition<PanelActions, CodeCityPanelContext> | PanelDefinition<PanelActions, FeedCodeCityPanelContext> | PanelDefinition<FileCitySequenceExplorerPanelActions, FileCitySequenceExplorerPanelContext> | PanelDefinition<FileCityTrailExplorerPanelActions, FileCityTrailExplorerPanelContext>)[];
 /**
  * Optional: Called once when the entire package is loaded.
  * Use this for package-level initialization.
@@ -23,7 +23,7 @@ export { codeCityPanelTools, codeCityPanelToolsMetadata, focusBuildingTool, sele
 /**
  * Export types for host applications to create the fileCityColorModes slice.
  */
-export type { FileCityColorModesSliceData, QualitySliceData, ColorMode, ColorModeConfig, FileMetricData, HighlightLayer, CodeCityPanelPropsTyped, CodeCityPanelContext, CommitFilesSliceData, PrFilesSliceData, PackagesSliceData, AlexandriaEntry, ActivityDay, ActivityHeatmapSliceData, ForkTourSliceData, LineCountsSliceData, SequenceEvent, SequenceEdge, SliceSnippet, DiffSnippet, SequenceEventSnippet, FileCitySequenceEventDef, SequenceLayoutOptions, SliceRange, SnippetSliceAnchor, SnippetDiffAnchor, SequenceSnippetNote, MarkdownTextQuoteAnchor, MarkdownNoteScope, SequenceMarkdownNote, SequenceNote, SequenceNoteDraft, SequenceDiagramPayload, BaseSequenceDiagramIndexEntry, NodePosition, EventAttributeSchema, EventRecord, NamespaceRecord, ScopeRecord, ScopeWorkspace, AddScopeInput, AddNamespaceInput, AddPathToNamespaceInput, AddEventInput, LatestCommitFileEntry, LatestCommitSliceData, AreaWorkspace, FileCitySequenceExplorerRepository, FileCitySequenceExplorerPanelContext, AddToScopeActionInput, AddAreaActionInput, AddPathToAreaActionInput, FileCitySequenceExplorerPanelActions, FileCitySequenceExplorerPanelPropsTyped, } from './types';
+export type { FileCityColorModesSliceData, QualitySliceData, ColorMode, ColorModeConfig, FileMetricData, HighlightLayer, CodeCityPanelPropsTyped, CodeCityPanelContext, CommitFilesSliceData, PrFilesSliceData, PackagesSliceData, AlexandriaEntry, ActivityDay, ActivityHeatmapSliceData, ForkTourSliceData, LineCountsSliceData, SequenceEvent, SequenceEdge, SliceSnippet, DiffSnippet, SequenceEventSnippet, FileCitySequenceEventDef, SequenceLayoutOptions, SliceRange, SnippetSliceAnchor, SnippetDiffAnchor, SequenceSnippetNote, MarkdownTextQuoteAnchor, MarkdownNoteScope, SequenceMarkdownNote, SequenceNote, SequenceNoteDraft, SequenceDiagramPayload, BaseSequenceDiagramIndexEntry, NodePosition, EventAttributeSchema, EventRecord, NamespaceRecord, ScopeRecord, ScopeWorkspace, AddScopeInput, AddNamespaceInput, AddPathToNamespaceInput, AddEventInput, LatestCommitFileEntry, LatestCommitSliceData, AreaWorkspace, FileCitySequenceExplorerRepository, FileCitySequenceExplorerPanelContext, AddToScopeActionInput, AddAreaActionInput, AddPathToAreaActionInput, FileCitySequenceExplorerPanelActions, FileCitySequenceExplorerPanelPropsTyped, TrailRepo, TrailSliceSnippet, TrailDiffSnippet, TrailMarkerSnippet, TrailMarker, SequenceMarkerRef, SequenceViewActor, SequenceViewLayout, TrailView, TrailSequenceView, TrailLinearView, TrailGraphView, TrailTreeView, TrailTimelineView, TrailSliceRange, TrailSnippetSliceAnchor, TrailSnippetDiffAnchor, TrailSnippetNote, TrailMarkdownTextQuoteAnchor, TrailMarkdownNoteScope, TrailMarkdownNote, TrailNote, TrailNoteDraft, TrailPayload, BaseTrailIndexEntry, FileCityTrailExplorerRepository, FileCityTrailExplorerPanelContext, FileCityTrailExplorerPanelActions, FileCityTrailExplorerPanelPropsTyped, } from './types';
 /**
  * Export color mode constants for host applications.
  */
@@ -45,9 +45,19 @@ export type { FeedProjectSliceData, FeedCodeCityPanelPropsTyped, FeedCodeCityPan
  * Hosts wire it via FileCitySequenceExplorerPanelContext (slices) and
  * FileCitySequenceExplorerPanelActions (required actions). See
  * docs/FILE_CITY_EXPLORER_PORT.md for the full alignment doc.
+ *
+ * @deprecated Use {@link FileCityTrailExplorerPanel} instead. The trail medium
+ * supersedes the sequence-diagram panel; this surface is retained for existing
+ * hosts but should not be wired into new integrations.
  */
 export { FileCitySequenceExplorerPanel, FileCitySequenceExplorer, buildCityDataFromContext, stripRootPath, } from './panels/FileCitySequenceExplorerPanel';
 export type { FileCitySequenceExplorerProps, BuildCityDataInput, } from './panels/FileCitySequenceExplorerPanel';
+/**
+ * FileCityTrailExplorerPanel — explorer for the new trail medium (parallel
+ * to the sequence-diagram panel above; not a replacement). See
+ * docs/TRAIL_RENAME.md for the medium design.
+ */
+export { FileCityTrailExplorerPanel } from './panels/FileCityTrailExplorerPanel';
 export { FileCardList } from './panels/components/FileCardList';
 export type { FileCardItem } from './panels/components/FileCardList';
 export { GitChangesCardList } from './panels/components/GitChangesCardList';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.tsx"],"names":[],"mappings":"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"}

package/dist/panels/FileCitySequenceExplorerPanel/FileCitySequenceExplorer/FileCitySequenceExplorer.d.ts

@@ -82,6 +82,12 @@ export interface FileCitySequenceExplorerProps {
     addArea: (input: AddAreaActionInput) => Promise<void>;
     addPathToArea: (input: AddPathToAreaActionInput) => Promise<void>;
 }
+/**
+ * @deprecated Use the trail explorer (`FileCityTrailExplorerPanel` /
+ * `FileCityTrailExplorer`) instead. The trail medium supersedes the
+ * sequence-diagram explorer; this component is retained for existing hosts
+ * but should not be wired into new integrations.
+ */
 export declare const FileCitySequenceExplorer: React.FC<FileCitySequenceExplorerProps>;
 export {};
 //# sourceMappingURL=FileCitySequenceExplorer.d.ts.map

package/dist/panels/FileCitySequenceExplorerPanel/FileCitySequenceExplorer/FileCitySequenceExplorer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FileCitySequenceExplorer.d.ts","sourceRoot":"","sources":["../../../../src/panels/FileCitySequenceExplorerPanel/FileCitySequenceExplorer/FileCitySequenceExplorer.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAW1B,OAAO,EAIL,KAAK,QAAQ,EAId,MAAM,+BAA+B,CAAC;AAEvC,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AAEpC;;;GAGG;AACH,KAAK,aAAa,GAAG,CACnB,MAAM,EAAE,KAAK,CAAC,MAAM,EACpB,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,KACpC,IAAI,CAAC;AACV,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAC;AAErE,OAAO,KAAK,EAEV,WAAW,EACZ,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EACV,kBAAkB,EAClB,wBAAwB,EACxB,qBAAqB,EACrB,qBAAqB,EACtB,MAAM,8CAA8C,CAAC;AACtD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AA6F/E,MAAM,WAAW,6BAA6B;IAC5C,4CAA4C;IAC5C,QAAQ,EAAE,QAAQ,CAAC;IACnB;;;;OAIG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,qBAAqB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC;;;;;OAKG;IACH,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B;;;;OAIG;IACH,iBAAiB,CAAC,EAAE;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAClD;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAC;IAC/C;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B;;;;OAIG;IACH,aAAa,CAAC,EAAE,aAAa,CAAC;IAI9B,iEAAiE;IACjE,YAAY,EAAE,qBAAqB,GAAG,IAAI,CAAC;IAC3C,iEAAiE;IACjE,kBAAkB,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAC9C;kCAC8B;IAC9B,MAAM,EAAE,SAAS,WAAW,EAAE,GAAG,IAAI,CAAC;IACtC,8DAA8D;IAC9D,KAAK,EAAE,SAAS,WAAW,EAAE,GAAG,IAAI,CAAC;IAIrC,aAAa,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACvD,kBAAkB,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1C,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5C,UAAU,EAAE,CAAC,KAAK,EAAE,qBAAqB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5D,OAAO,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,aAAa,EAAE,CAAC,KAAK,EAAE,wBAAwB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACnE;AAOD,eAAO,MAAM,wBAAwB,EAAE,KAAK,CAAC,EAAE,CAAC,6BAA6B,CA++D5E,CAAC"}
+{"version":3,"file":"FileCitySequenceExplorer.d.ts","sourceRoot":"","sources":["../../../../src/panels/FileCitySequenceExplorerPanel/FileCitySequenceExplorer/FileCitySequenceExplorer.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAW1B,OAAO,EAIL,KAAK,QAAQ,EAId,MAAM,+BAA+B,CAAC;AAEvC,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AAEpC;;;GAGG;AACH,KAAK,aAAa,GAAG,CACnB,MAAM,EAAE,KAAK,CAAC,MAAM,EACpB,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,KACpC,IAAI,CAAC;AACV,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAC;AAErE,OAAO,KAAK,EAEV,WAAW,EACZ,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EACV,kBAAkB,EAClB,wBAAwB,EACxB,qBAAqB,EACrB,qBAAqB,EACtB,MAAM,8CAA8C,CAAC;AACtD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AA6F/E,MAAM,WAAW,6BAA6B;IAC5C,4CAA4C;IAC5C,QAAQ,EAAE,QAAQ,CAAC;IACnB;;;;OAIG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,qBAAqB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC;;;;;OAKG;IACH,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B;;;;OAIG;IACH,iBAAiB,CAAC,EAAE;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAClD;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAC;IAC/C;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B;;;;OAIG;IACH,aAAa,CAAC,EAAE,aAAa,CAAC;IAI9B,iEAAiE;IACjE,YAAY,EAAE,qBAAqB,GAAG,IAAI,CAAC;IAC3C,iEAAiE;IACjE,kBAAkB,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAC9C;kCAC8B;IAC9B,MAAM,EAAE,SAAS,WAAW,EAAE,GAAG,IAAI,CAAC;IACtC,8DAA8D;IAC9D,KAAK,EAAE,SAAS,WAAW,EAAE,GAAG,IAAI,CAAC;IAIrC,aAAa,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACvD,kBAAkB,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1C,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5C,UAAU,EAAE,CAAC,KAAK,EAAE,qBAAqB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5D,OAAO,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,aAAa,EAAE,CAAC,KAAK,EAAE,wBAAwB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACnE;AAOD;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,EAAE,KAAK,CAAC,EAAE,CAAC,6BAA6B,CA++D5E,CAAC"}

package/dist/panels/FileCitySequenceExplorerPanel/FileCitySequenceExplorer/styles.d.ts

@@ -1,7 +1,6 @@
 import type React from 'react';
 import type { Theme } from '@principal-ade/industry-theme';
-/** Translucent overlay using the theme's background colour. */
-export declare const withAlpha: (color: string, percent: number) => string;
+export { withAlpha } from '../../utils/styles';
 /** Reused across overlays, modals, and the selected-folder card. */
 export declare const makeSectionLabelStyle: (theme: Theme) => React.CSSProperties;
 /** Frame style for the right-side info overlay. */

package/dist/panels/FileCitySequenceExplorerPanel/FileCitySequenceExplorer/styles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../../../../src/panels/FileCitySequenceExplorerPanel/FileCitySequenceExplorer/styles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,+BAA+B,CAAC;AAE3D,+DAA+D;AAC/D,eAAO,MAAM,SAAS,GAAI,OAAO,MAAM,EAAE,SAAS,MAAM,KAAG,MACD,CAAC;AAE3D,oEAAoE;AACpE,eAAO,MAAM,qBAAqB,GAAI,OAAO,KAAK,KAAG,KAAK,CAAC,aAKzD,CAAC;AAEH,mDAAmD;AACnD,eAAO,MAAM,gBAAgB,GAAI,OAAO,KAAK,KAAG,KAAK,CAAC,aAiBpD,CAAC"}
+{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../../../../src/panels/FileCitySequenceExplorerPanel/FileCitySequenceExplorer/styles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,+BAA+B,CAAC;AAE3D,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAG/C,oEAAoE;AACpE,eAAO,MAAM,qBAAqB,GAAI,OAAO,KAAK,KAAG,KAAK,CAAC,aAKzD,CAAC;AAEH,mDAAmD;AACnD,eAAO,MAAM,gBAAgB,GAAI,OAAO,KAAK,KAAG,KAAK,CAAC,aAiBpD,CAAC"}

package/dist/panels/FileCitySequenceExplorerPanel/FileCitySequenceExplorerPanel.d.ts

@@ -1,4 +1,9 @@
 import React from 'react';
 import type { FileCitySequenceExplorerPanelPropsTyped } from '../../types/FileCitySequenceExplorerPanel';
+/**
+ * @deprecated Use `FileCityTrailExplorerPanel` instead. The trail medium
+ * supersedes the sequence-diagram panel; this component is retained for
+ * existing hosts but should not be wired into new integrations.
+ */
 export declare const FileCitySequenceExplorerPanel: React.FC<FileCitySequenceExplorerPanelPropsTyped>;
 //# sourceMappingURL=FileCitySequenceExplorerPanel.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"FileCitySequenceExplorerPanel.d.ts","sourceRoot":"","sources":["../../../src/panels/FileCitySequenceExplorerPanel/FileCitySequenceExplorerPanel.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAmC1B,OAAO,KAAK,EAAE,uCAAuC,EAAE,MAAM,2CAA2C,CAAC;AAoCzG,eAAO,MAAM,6BAA6B,EAAE,KAAK,CAAC,EAAE,CAAC,uCAAuC,CA00B3F,CAAC"}
+{"version":3,"file":"FileCitySequenceExplorerPanel.d.ts","sourceRoot":"","sources":["../../../src/panels/FileCitySequenceExplorerPanel/FileCitySequenceExplorerPanel.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAmC1B,OAAO,KAAK,EAAE,uCAAuC,EAAE,MAAM,2CAA2C,CAAC;AAoCzG;;;;GAIG;AACH,eAAO,MAAM,6BAA6B,EAAE,KAAK,CAAC,EAAE,CAAC,uCAAuC,CA00B3F,CAAC"}

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

@@ -0,0 +1,23 @@
+import React from 'react';
+import '@xyflow/react/dist/style.css';
+import type { FileCityTrailExplorerPanelPropsTyped } from '../../types/FileCityTrailExplorerPanel';
+/**
+ * FileCityTrailExplorerPanel — explorer for the new **trail** medium.
+ *
+ * Renders a single panel scoped to one repo (per the host's
+ * panel→repo-id registry) and surfaces a `TrailPayload` from
+ * `context.trail`. v1 only registers a renderer for
+ * `views[].kind:'sequence'`; other view kinds render an
+ * "unsupported view" placeholder.
+ *
+ * Layout (when a trail is loaded):
+ *   ┌─ TrailHeader ─────────────────────────────────────┐
+ *   │ Markdown overlay (left) │ FileCity3D │ Snippet pane│
+ *   │  • trail.summary idle   │   + leader │ (right,     │
+ *   │  • marker.description   │     line   │  on select) │
+ *   │    when selected        │            │             │
+ *   ├─ SequenceDiagramRenderer (drawer) ────────────────┤
+ *   └────────────────────────────────────────────────────┘
+ */
+export declare const FileCityTrailExplorerPanel: React.FC<FileCityTrailExplorerPanelPropsTyped>;
+//# sourceMappingURL=FileCityTrailExplorerPanel.d.ts.map

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

@@ -0,0 +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;AAqBhD;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,0BAA0B,EAAE,KAAK,CAAC,EAAE,CAC/C,oCAAoC,CA+ErC,CAAC"}

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

@@ -0,0 +1,29 @@
+import type { SequenceEdge, SequenceEvent, UseSequenceLayoutOptions } from '@principal-ai/principal-view-react';
+import type { TrailPayload, TrailSequenceView } from '../../types/Trail';
+export interface SequenceViewInputs {
+    events: SequenceEvent[];
+    edges: SequenceEdge[];
+    layoutOptions: UseSequenceLayoutOptions;
+}
+/**
+ * Build the upstream `SequenceDiagramRenderer` inputs (events, edges,
+ * layoutOptions) from a trail payload and one of its sequence views.
+ *
+ * The trail's content lives in `payload.markers` (id, label, sourcePath,
+ * snippet, description); the sequence view's `markers: SequenceMarkerRef[]`
+ * carries the per-marker structural fields the swimlane renderer needs
+ * (name namespace, participant override, move-event flag, type styling).
+ *
+ * This helper joins them on `markerId` and produces the upstream
+ * `SequenceEvent[]` shape. Refs that point at non-existent markers are
+ * dropped (with a warning); markers absent from the view are not
+ * rendered (the view's `markers[]` is the authority for which markers
+ * appear in this view, in what order).
+ *
+ * Multi-repo trails: every panel renders the *full* sequence view (a
+ * cross-service flow is more useful complete than partial). Per-panel
+ * filtering happens at the highlight layer (only markers whose `repo`
+ * matches the panel's repo light up a building) — not here.
+ */
+export declare function buildSequenceViewInputs(payload: TrailPayload, view: TrailSequenceView): SequenceViewInputs;
+//# sourceMappingURL=buildSequenceViewInputs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"buildSequenceViewInputs.d.ts","sourceRoot":"","sources":["../../../src/panels/FileCityTrailExplorerPanel/buildSequenceViewInputs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,aAAa,EACb,wBAAwB,EACzB,MAAM,oCAAoC,CAAC;AAE5C,OAAO,KAAK,EAEV,YAAY,EACZ,iBAAiB,EAClB,MAAM,mBAAmB,CAAC;AAE3B,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,aAAa,EAAE,wBAAwB,CAAC;CACzC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,YAAY,EACrB,IAAI,EAAE,iBAAiB,GACtB,kBAAkB,CA6CpB"}

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

@@ -0,0 +1,42 @@
+/**
+ * Camera-framing math for the trail explorer panel.
+ *
+ * `FileCity3D` mounts in flat (top-down) mode and uses a 50° vertical
+ * FOV. When overlays cover part of the canvas, we want the city to fit
+ * the *visible* sub-rect — not the full canvas — so the user doesn't
+ * have to manually pan to see the buildings under the markdown overlay
+ * or the snippet pane.
+ *
+ * The output is fed straight to `setCameraFlatView(targetX, targetZ,
+ * height, { duration })`. Mirrors the math in
+ * `docs/CAMERA_OFFSET_FOR_OVERLAYS.md` and the existing sequence
+ * panel's implementation.
+ */
+import type { CityData } from '@principal-ai/file-city-react';
+export interface CameraFramingInputs {
+    /** Canvas width in CSS pixels. */
+    canvasW: number;
+    /** Canvas height in CSS pixels. */
+    canvasH: number;
+    cityBounds: CityData['bounds'];
+    /** Left overlay inset in CSS pixels (markdown overlay + outer gutter). */
+    leftInset: number;
+    /** Right overlay inset in CSS pixels (snippet pane + outer gutter). */
+    rightInset: number;
+    /** Top inset in CSS pixels. */
+    topInset: number;
+    /** Bottom inset in CSS pixels (sequence drawer height). */
+    bottomInset: number;
+}
+export interface CameraFramingResult {
+    targetX: number;
+    targetZ: number;
+    height: number;
+}
+/**
+ * Compute the `setCameraFlatView` arguments that frame the city in the
+ * canvas sub-rect not covered by overlays. Returns `null` when the
+ * inputs would produce a degenerate (zero or negative) visible rect.
+ */
+export declare function computeCameraFraming(inputs: CameraFramingInputs): CameraFramingResult | null;
+//# sourceMappingURL=cameraFraming.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cameraFraming.d.ts","sourceRoot":"","sources":["../../../src/panels/FileCityTrailExplorerPanel/cameraFraming.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAE9D,MAAM,WAAW,mBAAmB;IAClC,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC/B,0EAA0E;IAC1E,SAAS,EAAE,MAAM,CAAC;IAClB,uEAAuE;IACvE,UAAU,EAAE,MAAM,CAAC;IACnB,+BAA+B;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,2DAA2D;IAC3D,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAQD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,mBAAmB,GAC1B,mBAAmB,GAAG,IAAI,CAuC5B"}

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

@@ -0,0 +1,2 @@
+export { FileCityTrailExplorerPanel } from './FileCityTrailExplorerPanel';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/panels/FileCityTrailExplorerPanel/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC"}

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

@@ -0,0 +1,45 @@
+import React from 'react';
+export type TrailDiffStyle = 'unified' | 'split';
+/**
+ * Diff snippet renderer for the trail panel.
+ *
+ * Takes pre-change contents directly (always required on
+ * `TrailDiffSnippet.oldContents`). Post-change contents come from the
+ * snippet when set, otherwise the host's `readFile` action resolves
+ * them — that's the seam future content sources (baked content,
+ * historic fetch) plug into without changing the panel.
+ *
+ * Slicing logic mirrors `TrailSnippetView`: optional `startLine`/
+ * `endLine` window, `contextLines` of padding, optional `focusLine`.
+ */
+export interface TrailDiffSnippetViewProps {
+    /** Repo-relative path; passed to `readFile` when newContents resolution is needed. */
+    filePath: string;
+    /** Display name (drives Pierre's syntax-highlight language detection). */
+    fileName: string;
+    /** Pre-change file contents. Pass the full file or a pre-sliced window. */
+    oldContents: string;
+    /**
+     * Post-change file contents. When omitted, resolved via `readFile`
+     * (working tree in v1).
+     */
+    newContents?: string;
+    /** Host-supplied file reader (the panel's `readFile` action). */
+    readFile: (path: string) => Promise<string>;
+    /**
+     * Optional snippet window applied to both contents before diffing
+     * (1-based, inclusive). When omitted, the entire diff is rendered.
+     */
+    startLine?: number;
+    endLine?: number;
+    /** Line in the post-change window to call out (1-based, relative to the new file). */
+    focusLine?: number;
+    /** Lines of unchanged context kept above/below the snippet. Default 2. */
+    contextLines?: number;
+    /** Override Pierre's container background. Any CSS color string. */
+    background?: string;
+    /** Side-by-side or unified rendering. Defaults to `'unified'`. */
+    diffStyle?: TrailDiffStyle;
+}
+export declare const TrailDiffSnippetView: React.FC<TrailDiffSnippetViewProps>;
+//# sourceMappingURL=TrailDiffSnippetView.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TrailDiffSnippetView.d.ts","sourceRoot":"","sources":["../../../../src/panels/FileCityTrailExplorerPanel/overlays/TrailDiffSnippetView.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAK1B,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,OAAO,CAAC;AAEjD;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,yBAAyB;IACxC,sFAAsF;IACtF,QAAQ,EAAE,MAAM,CAAC;IACjB,0EAA0E;IAC1E,QAAQ,EAAE,MAAM,CAAC;IACjB,2EAA2E;IAC3E,WAAW,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iEAAiE;IACjE,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5C;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sFAAsF;IACtF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0EAA0E;IAC1E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oEAAoE;IACpE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kEAAkE;IAClE,SAAS,CAAC,EAAE,cAAc,CAAC;CAC5B;AA+CD,eAAO,MAAM,oBAAoB,EAAE,KAAK,CAAC,EAAE,CAAC,yBAAyB,CA6IpE,CAAC"}

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

@@ -0,0 +1,39 @@
+import React from 'react';
+import * as THREE from 'three';
+import type { CityBuilding } from '@principal-ai/file-city-react';
+/**
+ * Mirror of `OnCameraFrame` from `@principal-ai/file-city-react`'s internals;
+ * not re-exported from the package's public surface.
+ */
+export type OnCameraFrame = (camera: THREE.Camera, size: {
+    width: number;
+    height: number;
+}) => void;
+export interface TrailLeaderLineHandle {
+    /** Pass this through to `<FileCity3D onCameraFrame={...}>`. */
+    onCameraFrame: OnCameraFrame;
+}
+export interface TrailLeaderLineProps {
+    /** Container the SVG sits inside; used to convert client-rect coords to local. */
+    containerRef: React.RefObject<HTMLDivElement | null>;
+    /** Building the line points to. `null` hides the line. */
+    building: CityBuilding | null;
+    /**
+     * `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;
+    /** Element the line lands on (the snippet pane). `null` hides the line. */
+    targetRef: React.RefObject<HTMLElement | null>;
+}
+/**
+ * Single leader-line from the building of the selected trail marker to the
+ * matching snippet pane. SVG attrs are written imperatively inside
+ * `onCameraFrame` so we don't trigger React reconciliation 60×/sec.
+ */
+export declare const TrailLeaderLine: React.ForwardRefExoticComponent<TrailLeaderLineProps & React.RefAttributes<TrailLeaderLineHandle>>;
+//# sourceMappingURL=TrailLeaderLine.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,50 @@
+import React from 'react';
+/**
+ * Left-edge markdown overlay for the trail panel.
+ *
+ * Renders `trail.summary` (idle) or `marker.description` (when a marker
+ * is selected) as themed markdown. The reader can drag the right edge
+ * to widen the panel. Note-annotation pills from the original
+ * sequence-panel overlay are dropped — trail v1 doesn't need them.
+ *
+ * Optionally renders a footer with marker navigation: a "Start trail"
+ * button when no marker is selected, and prev/next chevrons + position
+ * counter once the trail is active.
+ */
+export interface TrailMarkerNav {
+    /** -1 = idle (no marker selected); >= 0 = active marker index. */
+    position: number;
+    /** Total markers walkable in this panel's repo. */
+    total: number;
+    /** Selects the first marker. Called when the user clicks "Start trail". */
+    onStart: () => void;
+    /** Steps to the previous marker. No-op at the start of the trail. */
+    onPrev: () => void;
+    /** Steps to the next marker. No-op at the end of the trail. */
+    onNext: () => void;
+}
+export interface TrailMarkdownOverlayProps {
+    /** Small caps label shown above the title (e.g. "Overview", "Marker"). */
+    eyebrow: string;
+    /** Bold heading shown under the eyebrow. */
+    title: string;
+    /** Markdown body. The overlay short-circuits to `null` when this is empty. */
+    markdown: string;
+    /** Stable prefix used by `IndustryMarkdownSlide` for slide ids. */
+    slideIdPrefix: string;
+    /** Bottom inset (number → px, string → CSS) so the panel sits above the sequence drawer. */
+    bottomOffset: number | string;
+    /**
+     * Notified when the panel container element mounts or unmounts.
+     * Accepts either a mutable ref object or a callback ref — siblings
+     * (e.g. the camera-framing effect) use this to observe width changes.
+     */
+    containerRef?: React.Ref<HTMLDivElement>;
+    /**
+     * Optional marker navigation footer. When omitted (e.g. trail has no
+     * markers in this repo), the footer is not rendered.
+     */
+    nav?: TrailMarkerNav;
+}
+export declare const TrailMarkdownOverlay: React.FC<TrailMarkdownOverlayProps>;
+//# sourceMappingURL=TrailMarkdownOverlay.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TrailMarkdownOverlay.d.ts","sourceRoot":"","sources":["../../../../src/panels/FileCityTrailExplorerPanel/overlays/TrailMarkdownOverlay.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAI1B;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,cAAc;IAC7B,kEAAkE;IAClE,QAAQ,EAAE,MAAM,CAAC;IACjB,mDAAmD;IACnD,KAAK,EAAE,MAAM,CAAC;IACd,2EAA2E;IAC3E,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,qEAAqE;IACrE,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,+DAA+D;IAC/D,MAAM,EAAE,MAAM,IAAI,CAAC;CACpB;AAED,MAAM,WAAW,yBAAyB;IACxC,0EAA0E;IAC1E,OAAO,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,8EAA8E;IAC9E,QAAQ,EAAE,MAAM,CAAC;IACjB,mEAAmE;IACnE,aAAa,EAAE,MAAM,CAAC;IACtB,4FAA4F;IAC5F,YAAY,EAAE,MAAM,GAAG,MAAM,CAAC;IAC9B;;;;OAIG;IACH,YAAY,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IACzC;;;OAGG;IACH,GAAG,CAAC,EAAE,cAAc,CAAC;CACtB;AAQD,eAAO,MAAM,oBAAoB,EAAE,KAAK,CAAC,EAAE,CAAC,yBAAyB,CA+MpE,CAAC"}

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

@@ -0,0 +1,35 @@
+import React from 'react';
+/**
+ * Slice snippet renderer for the trail panel.
+ *
+ * Reads the file via the host's `readFile` action, slices it to the
+ * requested window with `contextLines` of padding above/below, and hands
+ * the slice to Pierre's `<File>` for syntax-highlighted rendering. Gutter
+ * line numbers are rewritten on post-render so they show the original
+ * file range (e.g. 320..334) instead of Pierre's default 1..N over the
+ * slice.
+ *
+ * v1 doesn't surface notes — `TrailSnippetNote` is in the schema but
+ * the panel has no notes UI yet. Add line annotations when notes UI
+ * lands.
+ */
+export interface TrailSnippetViewProps {
+    /** Repo-relative path; passed to `readFile`. */
+    filePath: string;
+    /** Display name (drives Pierre's syntax-highlight language detection). */
+    fileName: string;
+    /** First line of the snippet (1-based, inclusive). */
+    startLine: number;
+    /** Last line of the snippet (1-based, inclusive). */
+    endLine: number;
+    /** Line to call out as the focus point; defaults to `startLine`. */
+    focusLine?: number;
+    /** Lines of context above/below the snippet; defaults to 2. */
+    contextLines?: number;
+    /** Host-supplied file reader (the panel's `readFile` action). */
+    readFile: (path: string) => Promise<string>;
+    /** Override Pierre's container background. Any CSS color string. */
+    background?: string;
+}
+export declare const TrailSnippetView: React.FC<TrailSnippetViewProps>;
+//# sourceMappingURL=TrailSnippetView.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TrailSnippetView.d.ts","sourceRoot":"","sources":["../../../../src/panels/FileCityTrailExplorerPanel/overlays/TrailSnippetView.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAI1B;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,qBAAqB;IACpC,gDAAgD;IAChD,QAAQ,EAAE,MAAM,CAAC;IACjB,0EAA0E;IAC1E,QAAQ,EAAE,MAAM,CAAC;IACjB,sDAAsD;IACtD,SAAS,EAAE,MAAM,CAAC;IAClB,qDAAqD;IACrD,OAAO,EAAE,MAAM,CAAC;IAChB,oEAAoE;IACpE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+DAA+D;IAC/D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iEAAiE;IACjE,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5C,oEAAoE;IACpE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,gBAAgB,EAAE,KAAK,CAAC,EAAE,CAAC,qBAAqB,CA+I5D,CAAC"}

package/dist/panels/utils/styles.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Theme-aware style helpers shared across panels.
+ *
+ * Keep this file medium-agnostic — anything specific to a single panel
+ * (sequence, trail, code-city) belongs next to that panel. The pattern
+ * established by the sequence explorer is to compose translucent
+ * surfaces from theme color tokens via `withAlpha` rather than writing
+ * raw `rgba(...)` literals, so panels stay theme-portable.
+ */
+/**
+ * Build a translucent variant of a theme color.
+ *
+ * Uses `color-mix(in oklab, …)` so the input can be any valid CSS color
+ * (hex, named, oklch, etc.) — callers don't have to convert tokens to
+ * rgb before mixing.
+ *
+ * @param color - Source color (typically a `theme.colors.*` token).
+ * @param percent - Opacity percentage (0–100). 100 returns the color
+ *   unchanged; 0 returns fully transparent.
+ */
+export declare const withAlpha: (color: string, percent: number) => string;
+//# sourceMappingURL=styles.d.ts.map

package/dist/panels/utils/styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../../../src/panels/utils/styles.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;;;;;;GAUG;AACH,eAAO,MAAM,SAAS,GAAI,OAAO,MAAM,EAAE,SAAS,MAAM,KAAG,MACD,CAAC"}