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

package/dist/types/FileCityTrailExplorerPanel.d.ts

@@ -0,0 +1,83 @@
+/**
+ * FileCityTrailExplorerPanel — actions, context, and slice data types.
+ *
+ * Mirrors the per-panel pattern of `FileCitySequenceExplorerPanel.ts`:
+ * actions are panel-private (not on the shared `PanelActions` umbrella),
+ * every slice and action is required, and "feature disabled" hosts
+ * permanently wire `data: null` to gate the corresponding UI.
+ *
+ * Context surface is intentionally narrower than the sequence panel:
+ * trails don't have scopes/areas (sequence-diagram authoring concepts)
+ * and v1 trails don't need the working-tree / commit affordances.
+ *
+ * See `docs/TRAIL_RENAME.md` for the medium design and
+ * `docs/EXPLORER_SHAREABLES.md` for the shared-vs-specific catalog.
+ */
+import type { PanelActions as CorePanelActions, PanelComponentProps as CorePanelComponentProps, DataSlice } from '@principal-ade/panel-framework-core';
+import type { FileTree } from '@principal-ai/repository-abstraction';
+import type { TrailPayload, TrailNote, TrailNoteDraft } from './Trail';
+import type { LineCountsSliceData } from './index';
+/**
+ * Identifier for the repo this panel represents. The host's
+ * panel→repo-id registry uses this to decide which trail markers
+ * belong to this panel.
+ *
+ * `id` is what `TrailMarker.repo` references. The optional path / owner
+ * / name fields are host-private resolution hints (electron has an
+ * absolute filesystem `path`; web hosts have GitHub `owner`/`name`).
+ * Trails themselves never carry filesystem paths — those live on the
+ * panel's identifier, not on the payload.
+ */
+export interface FileCityTrailExplorerRepository {
+    /**
+     * Stable repo id matching `TrailRepo.id` on payloads. The trail
+     * panel filters markers by this — only markers with `marker.repo`
+     * matching this id (or unspecified, when the trail is single-repo)
+     * highlight in this panel's city.
+     */
+    id: string;
+    path?: string | null;
+    owner?: string | null;
+    name?: string | null;
+}
+export interface FileCityTrailExplorerPanelContext {
+    /** Required, always-loaded — the panel cannot render without a tree. */
+    fileTree: DataSlice<FileTree>;
+    /** Per-file line counts for building heights. */
+    lineCounts: DataSlice<LineCountsSliceData | null>;
+    /**
+     * Active trail payload. Drives every overlay and the marker drawer.
+     * `data: null` means "no trail loaded" — the panel renders an empty
+     * state.
+     */
+    trail: DataSlice<TrailPayload | null>;
+    /** Repository identifier — not a slice. */
+    repository: FileCityTrailExplorerRepository | null;
+}
+export interface FileCityTrailExplorerPanelActions extends CorePanelActions {
+    /** Open a file in the host's active editor. */
+    openFile: (filePath: string, line?: number) => void;
+    /**
+     * Read a file's text content for snippet rendering. Path is
+     * repo-relative (`marker.sourcePath`); the host scopes the read to
+     * this panel's repo via its panel→repo-id registry.
+     *
+     * This is the v1 snippet resolver. The panel routes all snippet
+     * content through this action — never reads the filesystem directly
+     * — so future content sources (baked snippet content, historic
+     * fetches) plug in without changing the panel.
+     */
+    readFile: (path: string) => Promise<string>;
+    /**
+     * Persist a new note on the active trail. Returns the saved note
+     * (host fills id + timestamps), or `null` if the host couldn't
+     * persist.
+     */
+    createTrailNote: (payloadId: string, draft: TrailNoteDraft) => Promise<TrailNote | null>;
+    /** Update a note's body. Returns the updated note. */
+    updateTrailNote: (payloadId: string, noteId: string, body: string) => Promise<TrailNote | null>;
+    /** Delete a note. */
+    deleteTrailNote: (payloadId: string, noteId: string) => Promise<void>;
+}
+export type FileCityTrailExplorerPanelPropsTyped = CorePanelComponentProps<FileCityTrailExplorerPanelActions, FileCityTrailExplorerPanelContext>;
+//# sourceMappingURL=FileCityTrailExplorerPanel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"FileCityTrailExplorerPanel.d.ts","sourceRoot":"","sources":["../../src/types/FileCityTrailExplorerPanel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EACV,YAAY,IAAI,gBAAgB,EAChC,mBAAmB,IAAI,uBAAuB,EAC9C,SAAS,EACV,MAAM,qCAAqC,CAAC;AAC7C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sCAAsC,CAAC;AACrE,OAAO,KAAK,EACV,YAAY,EACZ,SAAS,EACT,cAAc,EACf,MAAM,SAAS,CAAC;AACjB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAMnD;;;;;;;;;;GAUG;AACH,MAAM,WAAW,+BAA+B;IAC9C;;;;;OAKG;IACH,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAMD,MAAM,WAAW,iCAAiC;IAChD,wEAAwE;IACxE,QAAQ,EAAE,SAAS,CAAC,QAAQ,CAAC,CAAC;IAE9B,iDAAiD;IACjD,UAAU,EAAE,SAAS,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAAC;IAElD;;;;OAIG;IACH,KAAK,EAAE,SAAS,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;IAEtC,2CAA2C;IAC3C,UAAU,EAAE,+BAA+B,GAAG,IAAI,CAAC;CACpD;AAMD,MAAM,WAAW,iCAAkC,SAAQ,gBAAgB;IACzE,+CAA+C;IAC/C,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAEpD;;;;;;;;;OASG;IACH,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAK5C;;;;OAIG;IACH,eAAe,EAAE,CACf,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,cAAc,KAClB,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;IAE/B,sDAAsD;IACtD,eAAe,EAAE,CACf,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,KACT,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;IAE/B,qBAAqB;IACrB,eAAe,EAAE,CACf,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,KACX,OAAO,CAAC,IAAI,CAAC,CAAC;CACpB;AAMD,MAAM,MAAM,oCAAoC,GAAG,uBAAuB,CACxE,iCAAiC,EACjC,iCAAiC,CAClC,CAAC"}

package/dist/types/Trail.d.ts

@@ -0,0 +1,508 @@
+/**
+ * Trail types.
+ *
+ * Trails are a new authored-walkthrough medium that ships parallel to the
+ * existing sequence-diagram stack (`./SequenceDiagram.ts`). Trails do not
+ * read sequence-diagram payloads; sequence-diagram code does not read trail
+ * payloads. The only shared point of contact is the upstream
+ * `SequenceDiagramRenderer` from `@principal-ai/principal-view-react`,
+ * which the `views[].kind:'sequence'` renderer feeds at render time.
+ *
+ * See `docs/TRAIL_RENAME.md` for the full design — particularly the
+ * "Coexistence with sequence diagrams" and "Addressing markers across
+ * repos and time" sections.
+ *
+ * v1 ships:
+ * - `TrailPayload` shape, including the `repos[]` registry and provenance
+ * - `TrailMarker` content fields (sourcePath, snippet, description)
+ * - `TrailSliceSnippet` and `TrailDiffSnippet`
+ * - `TrailView` discriminated union (only `kind:'sequence'` has a registered
+ *   renderer in v1; other kinds are declared so the schema is committed)
+ * - Notes anchored to marker ids (snippet anchors and markdown anchors)
+ *
+ * v1 explicitly does NOT ship (all non-breaking future additions):
+ * - Per-marker time pin (`marker.at`)
+ * - Baked slice content (`TrailSliceSnippet.contents`)
+ * - Two-sided historic diffs (`TrailDiffSnippet.oldRef` / `newRef`)
+ * - File-rename archeology for File City highlight
+ *
+ * Two consumer-side disciplines that are cheap now and expensive to
+ * retrofit (renderer-side, not schema-side):
+ * 1. `marker.sourcePath` resolves against the marker's repo at trail
+ *    authoring time, not against "the working tree." V1 happens to read
+ *    the working tree because no historic resolver exists yet, but the
+ *    *contract* is "resolve against trail provenance."
+ * 2. `TrailSliceSnippet`'s contract is "line numbers index into a content
+ *    source" — content source unspecified. Route content through a
+ *    resolver, not direct fs reads.
+ */
+import type { SequenceEdge } from '@principal-ai/principal-view-react';
+/**
+ * One repo a trail touches. Carries portable identity (so a trail authored
+ * on machine A renders on machine B) and the commit it was authored
+ * against (provenance — recorded now, interpreted later).
+ *
+ * Filesystem paths are deliberately absent: hosts maintain their own
+ * private mapping from "open File City panel" → "which `TrailRepo.id`
+ * this panel represents." The schema never carries a producer-machine
+ * filesystem layout.
+ */
+export interface TrailRepo {
+    /**
+     * Stable repo identity referenced by `TrailMarker.repo`. Producer
+     * choice — typically the human-friendly repo name (e.g. `auth-server`).
+     * See `docs/TRAIL_RENAME.md` open question on identity stability.
+     */
+    id: string;
+    /** Human label for picker UIs and overlays. */
+    name: string;
+    /**
+     * Remote location — meaningful on any machine. Optional because not
+     * every repo has a remote (private internal tools, throwaway local
+     * projects). When set, consumers can resolve historic content via the
+     * remote's API.
+     */
+    remote?: {
+        host: 'github' | 'gitlab' | 'bitbucket' | 'other';
+        owner: string;
+        name: string;
+    };
+    /**
+     * The commit this trail was authored against. Producers fill via
+     * `git rev-parse HEAD` at payload construction; consumers tolerate
+     * absence. v1 doesn't use this for content resolution (the working
+     * tree is the only resolver), but recording it now is what unlocks
+     * future historic-content features without bifurcating trail cohorts.
+     */
+    authoredAtSha?: string;
+    /**
+     * Branch/tag at author time — for human display ("authored on `main` at
+     * `abc1234`"). Not used for resolution; the sha is authoritative.
+     */
+    authoredAtRef?: string;
+    /**
+     * Future hydration baseline — the ref a future content-fetcher uses
+     * when no per-marker time pin is set. v1 consumers ignore this.
+     */
+    defaultRef?: string;
+}
+/**
+ * Single-file window over the marker's `sourcePath`. Line numbers index
+ * into the resolved content source.
+ *
+ * V1 content source is the working tree (resolved via a host-provided
+ * resolver — not a direct fs read). Future, non-breaking addition:
+ * `contents?: string` for durable archival trails that bake content at
+ * author time.
+ */
+export interface TrailSliceSnippet {
+    kind: 'slice';
+    /** First line of the snippet (1-based, inclusive). */
+    startLine: number;
+    /** Last line of the snippet (1-based, inclusive). */
+    endLine: number;
+    /** Line to highlight as the focus point. Defaults to `startLine`. */
+    focusLine?: number;
+    /** Lines of context above/below the snippet. Defaults to 2. */
+    contextLines?: number;
+}
+/**
+ * Before/after view inline. Used by code-review walkthroughs where each
+ * marker represents a change region in a PR.
+ */
+export interface TrailDiffSnippet {
+    kind: 'diff';
+    /** Pre-change file contents (full file or a pre-sliced window). */
+    oldContents: string;
+    /**
+     * Post-change file contents. When omitted, the renderer resolves the
+     * post-change content via the host's resolver and diffs against
+     * `oldContents`.
+     */
+    newContents?: string;
+    /**
+     * Snippet window (1-based, inclusive) applied to both sides before
+     * diffing. Producers must set this — derive from contents length when
+     * the snippet covers the whole file.
+     */
+    startLine: number;
+    /** 1-based, inclusive. */
+    endLine: number;
+    /** Line in the post-change window to call out (1-based). */
+    focusLine?: number;
+    /** Lines of unchanged context kept around the window. Defaults to 2. */
+    contextLines?: number;
+    /** Pierre rendering style. Defaults to `'unified'`. */
+    diffStyle?: 'unified' | 'split';
+    /** Syntax-highlighting hint (e.g. `'typescript'`, `'python'`). */
+    language?: string;
+    /**
+     * Forward-compat scaffolding for two-sided historic diffs. No producer
+     * sets this in v1; the field is declared so future consumers can
+     * resolve `oldContents`/`newContents` from a remote ref.
+     */
+    gitRef?: {
+        sha: string;
+        path: string;
+        branch?: string;
+    };
+}
+export type TrailMarkerSnippet = TrailSliceSnippet | TrailDiffSnippet;
+/**
+ * One marker on a trail. Carries the *content* a reader consumes at this
+ * stop (sourcePath, snippet, description) — the *structure between
+ * markers* (lanes/edges/tree shape/etc.) lives on the matching `TrailView`
+ * block, not here.
+ *
+ * Marker ids are referenced by every view block, every note, and every
+ * edge. They must be stable across edits.
+ */
+export interface TrailMarker {
+    /** Stable id referenced by views and notes. */
+    id: string;
+    /**
+     * Display label. Falls back to a view-derived name when omitted (e.g.
+     * the sequence view uses its `name` namespace).
+     */
+    label?: string;
+    /**
+     * Which `TrailRepo.id` this marker is anchored to. Defaults to
+     * `repos[0].id` when the trail has a single repo. Required when
+     * `payload.repos.length > 1`.
+     */
+    repo?: string;
+    /**
+     * Path within the marker's repo (repo-relative, never absolute). Drives
+     * the File City highlight + leader line + Pierre snippet drawer.
+     *
+     * Resolution contract: against the marker's repo at trail authoring
+     * time. V1 consumers happen to read the working tree because no
+     * historic resolver exists yet, but writing the contract this way
+     * means future historic resolution is a strict refinement.
+     */
+    sourcePath?: string;
+    /** Slice or diff snippet rendered inline in the panel's drawer. */
+    snippet?: TrailMarkerSnippet;
+    /**
+     * Markdown description surfaced in the left-edge overlay when the
+     * marker is selected. Provides the "why" alongside the snippet's
+     * "what."
+     */
+    description?: string;
+}
+/**
+ * Per-marker structural data for the sequence view. References a marker
+ * by id and carries the swimlane-renderer-specific fields (lane derivation
+ * via dotted namespace, participant override, move-event flag, type
+ * styling).
+ *
+ * The trail explorer panel constructs `SequenceEvent[]` inputs for the
+ * upstream `SequenceDiagramRenderer` by joining each `SequenceMarkerRef`
+ * with its `TrailMarker` at render time.
+ */
+export interface SequenceMarkerRef {
+    /** Foreign key into `TrailPayload.markers[].id`. */
+    markerId: string;
+    /**
+     * Dotted, namespaced identifier the swimlane renderer uses to derive
+     * lanes (e.g. `auth.validation.started`). The first dotted segment
+     * becomes the default lane.
+     */
+    name: string;
+    /**
+     * Lane bucket override. For move events, this is the *target* lane.
+     * When unset, the lane derives from `name`.
+     */
+    participant?: string;
+    /** Whether this marker crosses participant boundaries (move event). */
+    moveEvent?: boolean;
+    /** Optional event type for styling. */
+    type?: string;
+}
+/** Layout knobs forwarded to the sequence renderer. */
+export interface SequenceViewLayout {
+    /**
+     * Resolved namespaces in left-to-right order. Listed lanes are placed
+     * first; unlisted lanes fall back to first-marker order behind them.
+     * Unknown entries are ignored.
+     */
+    laneOrder?: string[];
+}
+/**
+ * Discriminated union of view blocks. The host's renderer registry maps
+ * each `kind` to a React component; the panel picks `views[0]` by
+ * default and exposes a toggle when more than one is present.
+ *
+ * v1 only registers a renderer for `kind:'sequence'`. The other kinds
+ * are declared so the schema is committed in code, but producers
+ * shipping v1 trails should ship `views: [{ kind: 'sequence', ... }]`.
+ *
+ * Each view references marker ids; first-class actor nodes that don't
+ * correspond to a marker (e.g. `User`, `Browser` in a sequence view)
+ * live in the view block as their own typed entries — see
+ * `SequenceViewActor`.
+ */
+export type TrailView = TrailSequenceView | TrailLinearView | TrailGraphView | TrailTreeView | TrailTimelineView;
+/** First-class actor in a sequence view that doesn't correspond to a marker. */
+export interface SequenceViewActor {
+    /** Lane id — namespace string just like `SequenceMarkerRef.name`. */
+    name: string;
+    /** Display label; defaults to last namespace segment of `name`. */
+    label?: string;
+}
+/**
+ * Swimlane node-and-edge view. Same renderer as the existing
+ * sequence-diagram implementation (`SequenceDiagramRenderer` from
+ * `@principal-ai/principal-view-react`); only the inputs differ.
+ */
+export interface TrailSequenceView {
+    kind: 'sequence';
+    /** Per-marker structural fields. Order in this array drives default render order. */
+    markers: SequenceMarkerRef[];
+    /** Edges between markers (by marker id). Reuses the upstream edge type. */
+    edges: SequenceEdge[];
+    /** Optional first-class actor lanes that don't correspond to markers. */
+    actors?: SequenceViewActor[];
+    /** Renderer layout knobs. */
+    layout?: SequenceViewLayout;
+}
+/**
+ * Linear list. v1 has no registered renderer; declared so producers can
+ * commit to a linear-only trail and a future linear renderer picks it
+ * up without schema changes.
+ */
+export interface TrailLinearView {
+    kind: 'linear';
+    /**
+     * Marker ids in display order. When omitted, defaults to the order
+     * of `payload.markers[]`.
+     */
+    order?: string[];
+}
+/**
+ * Graph view — nodes and edges, free-form layout. v1 has no registered
+ * renderer; node/edge/layout shapes are intentionally `unknown` until
+ * a renderer claims the kind and commits to a contract.
+ */
+export interface TrailGraphView {
+    kind: 'graph';
+    nodes: unknown[];
+    edges: unknown[];
+    layout?: unknown;
+}
+/**
+ * Tree view — parent/child relationships keyed by marker id. v1 has no
+ * registered renderer.
+ */
+export interface TrailTreeView {
+    kind: 'tree';
+    /** `parent[childMarkerId]` = parent marker id, or `null` for roots. */
+    parent: Record<string, string | null>;
+}
+/**
+ * Timeline view — markers placed at ISO 8601 timestamps. v1 has no
+ * registered renderer.
+ */
+export interface TrailTimelineView {
+    kind: 'timeline';
+    /** `at[markerId]` = ISO 8601 timestamp. */
+    at: Record<string, string>;
+}
+/**
+ * One disjoint line range covered by a slice anchor. Multi-range notes
+ * (e.g. a comment that spans two related code blocks) carry their own
+ * re-anchor fingerprints per range.
+ */
+export interface TrailSliceRange {
+    /** 1-based absolute line in the source file (inclusive). */
+    startLine: number;
+    /** 1-based absolute line (inclusive). For single-line ranges, equals `startLine`. */
+    endLine: number;
+    /** `startLine`'s text at creation time — re-anchor fingerprint. */
+    startLineText: string;
+    /** `endLine`'s text at creation time. Equals `startLineText` for single-line ranges. */
+    endLineText: string;
+}
+export interface TrailSnippetSliceAnchor {
+    kind: 'slice';
+    /**
+     * One or more disjoint ranges this note covers. Multi-range notes show
+     * one indicator pill per range start; the side panel renders one
+     * thread.
+     */
+    ranges: TrailSliceRange[];
+}
+export interface TrailSnippetDiffAnchor {
+    kind: 'diff';
+    side: 'deletions' | 'additions';
+    lineNumber: number;
+}
+/**
+ * Note attached to a snippet line. Lives on `payload.notes` so persistence
+ * and broadcast piggyback on the existing payload path. Only the renderer
+ * or host can mutate notes — external HTTP POSTs of payloads must strip
+ * this field during validation.
+ */
+export interface TrailSnippetNote {
+    id: string;
+    kind: 'snippet';
+    scope: {
+        markerId: string;
+    };
+    anchor: TrailSnippetSliceAnchor | TrailSnippetDiffAnchor;
+    body: string;
+    /** Required. Hosts identify the author at write time. */
+    author: string;
+    /** ISO 8601. */
+    createdAt: string;
+    /** ISO 8601 — equals `createdAt` until first edit. */
+    updatedAt: string;
+}
+/**
+ * Markdown notes anchor to a quoted span using the W3C text-quote
+ * selector (matches themed-markdown's `Annotation.anchor` shape).
+ */
+export interface TrailMarkdownTextQuoteAnchor {
+    kind: 'text-quote';
+    exact: string;
+    prefix?: string;
+    suffix?: string;
+}
+/**
+ * Where in the markdown overlay the note is anchored. The overlay swaps
+ * between a marker's `description` and the payload's `summary`.
+ */
+export type TrailMarkdownNoteScope = {
+    kind: 'description';
+    markerId: string;
+} | {
+    kind: 'summary';
+};
+/**
+ * Note attached to a markdown selection in the left-edge overlay. Same
+ * persistence story as `TrailSnippetNote` — lives on `payload.notes`,
+ * mutated only via host actions, stripped from external HTTP payloads
+ * during validation.
+ */
+export interface TrailMarkdownNote {
+    id: string;
+    kind: 'markdown';
+    scope: TrailMarkdownNoteScope;
+    anchor: TrailMarkdownTextQuoteAnchor;
+    body: string;
+    author: string;
+    createdAt: string;
+    updatedAt: string;
+}
+/** Discriminated union of all note variants. */
+export type TrailNote = TrailSnippetNote | TrailMarkdownNote;
+/**
+ * Payload accepted by note-creation endpoints. Server fills `id`,
+ * `createdAt`, `updatedAt`. Discriminated on `kind` so handlers can
+ * narrow without conditional fields.
+ */
+export type TrailNoteDraft = Omit<TrailSnippetNote, 'id' | 'createdAt' | 'updatedAt'> | Omit<TrailMarkdownNote, 'id' | 'createdAt' | 'updatedAt'>;
+/**
+ * Trail payload. The complete artifact a trail explorer panel renders.
+ *
+ * Producers build it with `id` and timestamps already set; storage layers
+ * reject payloads missing required fields.
+ */
+export interface TrailPayload {
+    /**
+     * Stable id. Producers generate it (e.g. `crypto.randomUUID()`);
+     * storage layers reject payloads missing it.
+     */
+    id: string;
+    /**
+     * Title shown in the drawer header. Hosts derive a default
+     * (e.g. first marker label or `"Untitled trail"`) at construction time.
+     */
+    title: string;
+    /**
+     * Free-form categorization. Used by web-ade's share flow to tag
+     * payloads (e.g. `'pr-walkthrough'`, `'incident'`).
+     */
+    kind?: string;
+    /**
+     * Markdown summary of the whole trail. Surfaced in the left-edge
+     * overlay when no marker is selected; per-marker `description` takes
+     * over once the user picks a marker.
+     */
+    summary?: string;
+    /**
+     * Repo registry. Optional for single-repo trails, in which case the
+     * payload-level `authoredAt` shorthand provides provenance and markers
+     * omit `repo`. When `repos.length > 1`, every marker must set `repo`
+     * to a registered id.
+     *
+     * Consumers normalize both shapes (registry vs. shorthand) into a
+     * one-element registry at read time.
+     */
+    repos?: TrailRepo[];
+    /**
+     * Single-repo provenance shorthand. Set when `repos[]` is omitted
+     * (single-repo trails); ignored when `repos[]` is present.
+     */
+    authoredAt?: {
+        sha: string;
+        ref?: string;
+    };
+    /** Markers in default display order. */
+    markers: TrailMarker[];
+    /**
+     * One or more view blocks. v1 only registers a renderer for
+     * `kind:'sequence'`; producers should ship that view in v1 trails.
+     */
+    views: TrailView[];
+    /**
+     * User-authored notes anchored to markers. Mutated only via host
+     * endpoints; external HTTP POSTs must strip this field during
+     * validation.
+     */
+    notes?: TrailNote[];
+    /**
+     * ISO 8601 — set at payload creation. Storage layers reject payloads
+     * missing it.
+     */
+    createdAt: string;
+    /**
+     * ISO 8601 — equals `createdAt` until first edit, then bumped on
+     * every persist.
+     */
+    updatedAt: string;
+}
+/**
+ * Manifest entry that summarizes a trail without loading it. Only the
+ * fields any picker UI actually needs.
+ *
+ * Each host extends this with storage-specific fields (filesystem path /
+ * S3 ownership / GitHub repo id / etc.) on its own side. Do NOT add
+ * storage-coupled fields here — they're host-private by design.
+ */
+export interface BaseTrailIndexEntry {
+    id: string;
+    /**
+     * Required. Hosts must provide a non-empty string — derive from the
+     * payload (e.g. first marker label) or fall back to a placeholder
+     * like `"Untitled trail"` at index time.
+     */
+    title: string;
+    /**
+     * Required. First ~200 chars of `payload.summary`, or empty string
+     * when the payload has no summary.
+     */
+    summaryPreview: string;
+    /** Number of markers. */
+    markerCount: number;
+    /** Repo names (for multi-repo trail badges in pickers). */
+    repoNames: string[];
+    /** Convenience: whether any marker carries a diff snippet. */
+    hasDiffSnippets: boolean;
+    /** ISO 8601. */
+    createdAt: string;
+    /** ISO 8601. */
+    updatedAt: string;
+    sizeBytes: number;
+}
+//# sourceMappingURL=Trail.d.ts.map

package/dist/types/Trail.d.ts.map

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

package/dist/types/index.d.ts

@@ -199,6 +199,8 @@ export type { TextToSpeechAdapter, TTSState, TTSOptions, TTSEvent, TourAudioCont
 export type { ImageResolutionContext, } from './TourExtensions';
 export { resolveImageUrl } from './TourExtensions';
 export type { SequenceEvent, SequenceEdge, SliceSnippet, DiffSnippet, SequenceEventSnippet, FileCitySequenceEventDef, SequenceLayoutOptions, SliceRange, SnippetSliceAnchor, SnippetDiffAnchor, SequenceSnippetNote, MarkdownTextQuoteAnchor, MarkdownNoteScope, SequenceMarkdownNote, SequenceNote, SequenceNoteDraft, SequenceDiagramPayload, BaseSequenceDiagramIndexEntry, } from './SequenceDiagram';
+export type { 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, } from './Trail';
 export type { NodePosition, EventAttributeSchema, EventRecord, NamespaceRecord, ScopeRecord, ScopeWorkspace, AddScopeInput, AddNamespaceInput, AddPathToNamespaceInput, AddEventInput, } from './Scope';
 export type { LatestCommitFileEntry, LatestCommitSliceData, AreaWorkspace, FileCitySequenceExplorerRepository, FileCitySequenceExplorerPanelContext, AddToScopeActionInput, AddAreaActionInput, AddPathToAreaActionInput, FileCitySequenceExplorerPanelActions, FileCitySequenceExplorerPanelPropsTyped, } from './FileCitySequenceExplorerPanel';
+export type { FileCityTrailExplorerRepository, FileCityTrailExplorerPanelContext, FileCityTrailExplorerPanelActions, FileCityTrailExplorerPanelPropsTyped, } from './FileCityTrailExplorerPanel';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@industry-theme/file-city-panel",
-  "version": "0.5.60",
+  "version": "0.5.62",
   "description": "File City visualization panel extension for @principal-ade/panel-framework-core",
   "type": "module",
   "main": "dist/panels.bundle.js",