@industry-theme/file-city-panel 0.5.53 → 0.5.54

package/dist/panels/FileCityExplorerPanel/FileCityExplorer/AddToAreaModal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AddToAreaModal.d.ts","sourceRoot":"","sources":["../../../../src/panels/FileCityExplorerPanel/FileCityExplorer/AddToAreaModal.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAC;AAIrE,eAAO,MAAM,cAAc,EAAE,KAAK,CAAC,EAAE,CAAC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,SAAS,WAAW,EAAE,CAAC;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,mBAAmB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7C,cAAc,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3C,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB,CAgQA,CAAC"}

package/dist/panels/FileCityExplorerPanel/FileCityExplorer/AddToScopeModal.d.ts

@@ -0,0 +1,14 @@
+import React from 'react';
+import type { ScopeRecord } from '../../../types/Scope';
+export declare const AddToScopeModal: React.FC<{
+    path: string;
+    scopes: readonly ScopeRecord[];
+    scopeId: string;
+    namespaceName: string;
+    onScopeIdChange: (value: string) => void;
+    onNamespaceNameChange: (value: string) => void;
+    onPickExisting: (scopeId: string, namespaceName: string) => void;
+    onSubmit: () => void;
+    onClose: () => void;
+}>;
+//# sourceMappingURL=AddToScopeModal.d.ts.map

package/dist/panels/FileCityExplorerPanel/FileCityExplorer/AddToScopeModal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AddToScopeModal.d.ts","sourceRoot":"","sources":["../../../../src/panels/FileCityExplorerPanel/FileCityExplorer/AddToScopeModal.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAIxD,eAAO,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,SAAS,WAAW,EAAE,CAAC;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,qBAAqB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/C,cAAc,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,KAAK,IAAI,CAAC;IACjE,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB,CAgTA,CAAC"}

package/dist/panels/FileCityExplorerPanel/FileCityExplorer/CommitFileOverlay.d.ts

@@ -0,0 +1,18 @@
+import React from 'react';
+export interface CommitFileOverlayProps {
+    /** Host-supplied diff fetcher; the closure binds the repository
+     *  identifier so this overlay only knows the commit hash. */
+    getCommitDiff: (commitHash: string) => Promise<string>;
+    commitHash: string;
+    /** Repo-relative path that was clicked (post-rename). */
+    filePath: string;
+    onClose: () => void;
+    onOpenInTab?: () => void;
+}
+/**
+ * Slide-in overlay that fetches the commit diff once per commit and renders
+ * the `FileDiff` for the selected path. Mirrors `FileOverlay`'s visual idiom so
+ * commit diffs and file previews feel like the same surface.
+ */
+export declare const CommitFileOverlay: React.FC<CommitFileOverlayProps>;
+//# sourceMappingURL=CommitFileOverlay.d.ts.map

package/dist/panels/FileCityExplorerPanel/FileCityExplorer/CommitFileOverlay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CommitFileOverlay.d.ts","sourceRoot":"","sources":["../../../../src/panels/FileCityExplorerPanel/FileCityExplorer/CommitFileOverlay.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAW1B,MAAM,WAAW,sBAAsB;IACrC;iEAC6D;IAC7D,aAAa,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACvD,UAAU,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;CAC1B;AAED;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAE,KAAK,CAAC,EAAE,CAAC,sBAAsB,CA4Q9D,CAAC"}

package/dist/panels/FileCityExplorerPanel/FileCityExplorer/FileCityExplorer.d.ts

@@ -0,0 +1,87 @@
+import React from 'react';
+import { type CityData } from '@principal-ai/file-city-react';
+import type * as THREE from 'three';
+/**
+ * Mirror of `OnCameraFrame` from `@principal-ai/file-city-react`'s internals;
+ * not re-exported from the package's public surface.
+ */
+type OnCameraFrame = (camera: THREE.Camera, size: {
+    width: number;
+    height: number;
+}) => void;
+import type { ProjectArea } from '@principal-ai/principal-view-core';
+import type { ScopeRecord } from '../../../types/Scope';
+import type { AddAreaActionInput, AddPathToAreaActionInput, AddToScopeActionInput, LatestCommitSliceData } from '../../../types/FileCityExplorerPanel';
+import type { GitStatusWithFiles } from '@principal-ai/repository-abstraction';
+export interface FileCityExplorerProps {
+    /** City data to render in the 3D canvas. */
+    cityData: CityData;
+    /**
+     * Prefix that scopes/namespace paths are stripped of when read out of
+     * `cityData` (e.g. `'electron-app/'`). Pass `''` if the city data is already
+     * rooted at the project root.
+     */
+    packageRoot: string;
+    /**
+     * Initial focused directory (city path). Defaults to the city root derived
+     * from `packageRoot` (with trailing slash stripped).
+     */
+    initialFocusDirectory?: string | null;
+    /**
+     * Fired when the user wants to open a file — either by clicking a
+     * building in the 3D canvas or by selecting a file leaf in the left
+     * file tree. The wrapper panel hooks this up to the panel-framework
+     * `file:open` event so editors and terminals can react.
+     */
+    onFileOpen?: (cityPath: string) => void;
+    /**
+     * Repo label shown in the path header when no directory is focused (e.g.
+     * `"owner/repo"`). Used purely for display; doesn't affect path
+     * conversion or city geometry.
+     */
+    repoLabel?: string | null;
+    /**
+     * Currently-selected sequence-diagram event. When set, paints a
+     * single-file highlight layer over the matching building so the
+     * sequence overlay can drive selection in the city below.
+     */
+    sequenceSelection?: {
+        sourcePath: string;
+    } | null;
+    /**
+     * Repo-relative paths for every event in the active sequence diagram.
+     * When non-empty, the city dims everything outside this set so only the
+     * files referenced by the explainer keep their natural color.
+     */
+    sequenceSourcePaths?: readonly string[] | null;
+    /**
+     * When true, the elevated folder/scope panels floating above the city
+     * are suppressed. Useful when another overlay (like the sequence
+     * diagram) should be the primary structure shown.
+     */
+    hideFolderPanels?: boolean;
+    /**
+     * Forwarded to `FileCity3D`. Fires once per R3F render frame with the
+     * live camera and canvas size; lets the host project building world
+     * positions to screen pixels for HTML/SVG overlays (leader lines, etc).
+     */
+    onCameraFrame?: OnCameraFrame;
+    /** Latest commit metadata. `null` hides the RecentCommitCard. */
+    latestCommit: LatestCommitSliceData | null;
+    /** Working-tree git status. `null` hides the WorkingTreeCard. */
+    gitStatusWithFiles: GitStatusWithFiles | null;
+    /** Scopes workspace. `null` hides the Scopes tab and disables
+     *  scope-authoring modals. */
+    scopes: readonly ScopeRecord[] | null;
+    /** Areas workspace. `null` disables area-authoring modals. */
+    areas: readonly ProjectArea[] | null;
+    getCommitDiff: (commitHash: string) => Promise<string>;
+    getWorkingTreeDiff: () => Promise<string>;
+    readFile: (path: string) => Promise<string>;
+    addToScope: (input: AddToScopeActionInput) => Promise<void>;
+    addArea: (input: AddAreaActionInput) => Promise<void>;
+    addPathToArea: (input: AddPathToAreaActionInput) => Promise<void>;
+}
+export declare const FileCityExplorer: React.FC<FileCityExplorerProps>;
+export {};
+//# sourceMappingURL=FileCityExplorer.d.ts.map

package/dist/panels/FileCityExplorerPanel/FileCityExplorer/FileCityExplorer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileCityExplorer.d.ts","sourceRoot":"","sources":["../../../../src/panels/FileCityExplorerPanel/FileCityExplorer/FileCityExplorer.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,sCAAsC,CAAC;AAC9C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AA6F/E,MAAM,WAAW,qBAAqB;IACpC,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,gBAAgB,EAAE,KAAK,CAAC,EAAE,CAAC,qBAAqB,CAy+D5D,CAAC"}

package/dist/panels/FileCityExplorerPanel/FileCityExplorer/RecentCommitCard.d.ts

@@ -0,0 +1,37 @@
+import React from 'react';
+export type RecentCommitFileStatus = 'A' | 'M' | 'D' | 'R' | 'C' | 'T';
+export interface RecentCommitFile {
+    path: string;
+    status: RecentCommitFileStatus;
+}
+export interface RecentCommit {
+    sha: string;
+    subject: string;
+    author: string;
+    authoredAt: Date;
+    filesChanged: number;
+    additions: number;
+    deletions: number;
+    files: RecentCommitFile[];
+}
+interface RecentCommitCardProps {
+    commit: RecentCommit;
+    onClick?: () => void;
+    /** When true, render a highlighted border so users can see the
+     *  paired city-highlight layer is active. */
+    active?: boolean;
+    /** Fired when a row in the expanded file list is clicked. The file's
+     *  status comes through so deletes can be skipped (no diff to show). */
+    onFileClick?: (file: RecentCommitFile) => void;
+    /** Fired with the row's repo-relative path and its status color on
+     *  mouse enter, and `null` on leave. The parent uses the color to paint
+     *  a darkened hover-highlight that ties the city to the row visually. */
+    onFileHoverChange?: (payload: {
+        path: string;
+        color: string;
+    } | null) => void;
+    style?: React.CSSProperties;
+}
+export declare const RecentCommitCard: React.FC<RecentCommitCardProps>;
+export {};
+//# sourceMappingURL=RecentCommitCard.d.ts.map

package/dist/panels/FileCityExplorerPanel/FileCityExplorer/RecentCommitCard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RecentCommitCard.d.ts","sourceRoot":"","sources":["../../../../src/panels/FileCityExplorerPanel/FileCityExplorer/RecentCommitCard.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAI1B,MAAM,MAAM,sBAAsB,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;AAEvE,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,sBAAsB,CAAC;CAChC;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,IAAI,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,gBAAgB,EAAE,CAAC;CAC3B;AAED,UAAU,qBAAqB;IAC7B,MAAM,EAAE,YAAY,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB;iDAC6C;IAC7C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;4EACwE;IACxE,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAC/C;;6EAEyE;IACzE,iBAAiB,CAAC,EAAE,CAClB,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,KAC5C,IAAI,CAAC;IACV,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;CAC7B;AAcD,eAAO,MAAM,gBAAgB,EAAE,KAAK,CAAC,EAAE,CAAC,qBAAqB,CAsO5D,CAAC"}

package/dist/panels/FileCityExplorerPanel/FileCityExplorer/ScopeInfoOverlay.d.ts

@@ -0,0 +1,10 @@
+import React from 'react';
+import type { EventRecord, NamespaceRecord, ScopeRecord } from '../../../types/Scope';
+export declare const ScopeInfoOverlay: React.FC<{
+    info: {
+        scope: ScopeRecord;
+        ns: NamespaceRecord | null;
+        ev: EventRecord | null;
+    };
+}>;
+//# sourceMappingURL=ScopeInfoOverlay.d.ts.map

package/dist/panels/FileCityExplorerPanel/FileCityExplorer/ScopeInfoOverlay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScopeInfoOverlay.d.ts","sourceRoot":"","sources":["../../../../src/panels/FileCityExplorerPanel/FileCityExplorer/ScopeInfoOverlay.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EACV,WAAW,EACX,eAAe,EACf,WAAW,EACZ,MAAM,sBAAsB,CAAC;AAI9B,eAAO,MAAM,gBAAgB,EAAE,KAAK,CAAC,EAAE,CAAC;IACtC,IAAI,EAAE;QAAE,KAAK,EAAE,WAAW,CAAC;QAAC,EAAE,EAAE,eAAe,GAAG,IAAI,CAAC;QAAC,EAAE,EAAE,WAAW,GAAG,IAAI,CAAA;KAAE,CAAC;CAClF,CA6NA,CAAC"}

package/dist/panels/FileCityExplorerPanel/FileCityExplorer/WorkingTreeCard.d.ts

@@ -0,0 +1,32 @@
+import React from 'react';
+export type WorkingTreeFileStatus = 'A' | 'M' | 'D';
+export interface WorkingTreeFile {
+    path: string;
+    status: WorkingTreeFileStatus;
+    /** True when at least one change to this path is staged. */
+    staged: boolean;
+}
+export interface WorkingTreeChanges {
+    branch: string;
+    ahead: number;
+    behind: number;
+    filesChanged: number;
+    files: WorkingTreeFile[];
+}
+interface WorkingTreeCardProps {
+    changes: WorkingTreeChanges;
+    onClick?: () => void;
+    active?: boolean;
+    onFileClick?: (file: WorkingTreeFile) => void;
+    /** Fired with the row's repo-relative path and its status color on
+     *  mouse enter, and `null` on leave. The parent uses the color to paint
+     *  a darkened hover-highlight that ties the city to the row visually. */
+    onFileHoverChange?: (payload: {
+        path: string;
+        color: string;
+    } | null) => void;
+    style?: React.CSSProperties;
+}
+export declare const WorkingTreeCard: React.FC<WorkingTreeCardProps>;
+export {};
+//# sourceMappingURL=WorkingTreeCard.d.ts.map

package/dist/panels/FileCityExplorerPanel/FileCityExplorer/WorkingTreeCard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkingTreeCard.d.ts","sourceRoot":"","sources":["../../../../src/panels/FileCityExplorerPanel/FileCityExplorer/WorkingTreeCard.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAI1B,MAAM,MAAM,qBAAqB,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;AAEpD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,qBAAqB,CAAC;IAC9B,4DAA4D;IAC5D,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,eAAe,EAAE,CAAC;CAC1B;AAED,UAAU,oBAAoB;IAC5B,OAAO,EAAE,kBAAkB,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,eAAe,KAAK,IAAI,CAAC;IAC9C;;6EAEyE;IACzE,iBAAiB,CAAC,EAAE,CAClB,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,KAC5C,IAAI,CAAC;IACV,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;CAC7B;AAED,eAAO,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC,oBAAoB,CAgO1D,CAAC"}

package/dist/panels/FileCityExplorerPanel/FileCityExplorer/WorkingTreeFileOverlay.d.ts

@@ -0,0 +1,21 @@
+import React from 'react';
+export interface WorkingTreeFileOverlayProps {
+    /** Host-supplied diff fetcher. Returns the unified-diff text for the
+     *  current working tree (typically `git diff HEAD`). */
+    getWorkingTreeDiff: () => Promise<string>;
+    /** Host-supplied file reader. Used as a fallback for untracked files
+     *  (which `git diff HEAD` skips). The host normalizes the path. */
+    readFile: (path: string) => Promise<string>;
+    /** Repo-relative path that was clicked. */
+    filePath: string;
+    onClose: () => void;
+    onOpenInTab?: () => void;
+}
+/**
+ * Slide-in twin of `CommitFileOverlay` but driven by the working-tree diff
+ * instead of a commit-specific one. Untracked files won't appear in the
+ * patch (no HEAD baseline) — the fallback reads the file via
+ * `actions.readFile` and synthesizes an all-additions patch.
+ */
+export declare const WorkingTreeFileOverlay: React.FC<WorkingTreeFileOverlayProps>;
+//# sourceMappingURL=WorkingTreeFileOverlay.d.ts.map

package/dist/panels/FileCityExplorerPanel/FileCityExplorer/WorkingTreeFileOverlay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkingTreeFileOverlay.d.ts","sourceRoot":"","sources":["../../../../src/panels/FileCityExplorerPanel/FileCityExplorer/WorkingTreeFileOverlay.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAwC1B,MAAM,WAAW,2BAA2B;IAC1C;4DACwD;IACxD,kBAAkB,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1C;uEACmE;IACnE,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5C,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;CAC1B;AAED;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,EAAE,KAAK,CAAC,EAAE,CAAC,2BAA2B,CAmSxE,CAAC"}

package/dist/panels/FileCityExplorerPanel/FileCityExplorer/index.d.ts

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

package/dist/panels/FileCityExplorerPanel/FileCityExplorer/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/panels/FileCityExplorerPanel/FileCityExplorer/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,KAAK,qBAAqB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/panels/FileCityExplorerPanel/FileCityExplorer/layers.d.ts

@@ -0,0 +1,22 @@
+import type { HighlightLayer } from '@principal-ai/file-city-react';
+import type { ScopeRecord } from '../../../types/Scope';
+export declare const NAMESPACE_PALETTE: string[];
+/**
+ * Fallback when a namespace has no `color` set on disk. Read sites use this
+ * via `ns.color ?? DEFAULT_NAMESPACE_COLOR` so the UI can render every
+ * namespace, including ones authored before colors were captured.
+ */
+export declare const DEFAULT_NAMESPACE_COLOR: string;
+/** Colour used for area umbrella tiles and their picker swatches. */
+export declare const AREA_PANEL_COLOR = "#64748b";
+export declare function pickNamespaceColor(scopes: readonly ScopeRecord[]): string;
+/**
+ * Build highlight layers for a scope: one fill layer per namespace plus a
+ * border-only layer for scope-level paths. Priority is path depth (longest-
+ * prefix wins) per the partition convention in docs/scope-namespace-overlay.md.
+ *
+ * `toCityPath` translates scope-relative paths back to city paths so
+ * districts can be matched.
+ */
+export declare function buildLayersForScope(scope: ScopeRecord, toCityPath: (scopePath: string) => string): HighlightLayer[];
+//# sourceMappingURL=layers.d.ts.map

package/dist/panels/FileCityExplorerPanel/FileCityExplorer/layers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layers.d.ts","sourceRoot":"","sources":["../../../../src/panels/FileCityExplorerPanel/FileCityExplorer/layers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD,eAAO,MAAM,iBAAiB,UAW7B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,QAAuB,CAAC;AAE5D,qEAAqE;AACrE,eAAO,MAAM,gBAAgB,YAAY,CAAC;AAE1C,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,GAAG,MAAM,CAMzE;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,WAAW,EAClB,UAAU,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,GACxC,cAAc,EAAE,CAiClB"}

package/dist/panels/FileCityExplorerPanel/FileCityExplorer/pathConversion.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Path converters for the explorer.
+ *
+ * City data is rooted at `packageRoot` (e.g. `electron-app/`). Scope/namespace
+ * paths are authored relative to the package root (matching how principal-view
+ * canvases are stored). These converters round-trip between the two
+ * representations.
+ *
+ * `packageRoot` should include a trailing slash. Pass `''` if the city data
+ * is already rooted at the project root.
+ */
+export interface PathConverters {
+    /** City path → scope/namespace path (strip the package-root prefix). */
+    toScopePath: (cityPath: string) => string;
+    /** Scope/namespace path → city path (re-add the package-root prefix). */
+    toCityPath: (scopePath: string) => string;
+}
+export declare function createPathConverters(packageRoot: string): PathConverters;
+//# sourceMappingURL=pathConversion.d.ts.map

package/dist/panels/FileCityExplorerPanel/FileCityExplorer/pathConversion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pathConversion.d.ts","sourceRoot":"","sources":["../../../../src/panels/FileCityExplorerPanel/FileCityExplorer/pathConversion.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,cAAc;IAC7B,wEAAwE;IACxE,WAAW,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC;IAC1C,yEAAyE;IACzE,UAAU,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC;CAC3C;AAED,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc,CAYxE"}

package/dist/panels/FileCityExplorerPanel/FileCityExplorer/scopeTreePaths.d.ts

@@ -0,0 +1,21 @@
+import type { ScopeRecord } from '../../../types/Scope';
+export interface ScopeTreeSelection {
+    scopeId: string;
+    namespaceName?: string;
+    eventName?: string;
+}
+/**
+ * Sentinel leaves used when a scope has no namespaces or a namespace has no
+ * events — the trees library infers directories from paths, so empty branches
+ * need a placeholder leaf to render.
+ */
+export declare const EMPTY_NS_SENTINEL = "(no namespaces)";
+export declare const EMPTY_EVENTS_SENTINEL = "(no events)";
+/**
+ * Build canonical paths for the scope tree: `<scope.name>/<namespace.name>/<event.name>`.
+ * Scopes are top-level directories, namespaces children, events leaves.
+ * Empty scopes/namespaces emit a sentinel leaf so they still appear.
+ */
+export declare function buildScopeTreePaths(scopes: readonly ScopeRecord[]): string[];
+export declare function parseScopeTreePath(path: string): ScopeTreeSelection;
+//# sourceMappingURL=scopeTreePaths.d.ts.map

package/dist/panels/FileCityExplorerPanel/FileCityExplorer/scopeTreePaths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scopeTreePaths.d.ts","sourceRoot":"","sources":["../../../../src/panels/FileCityExplorerPanel/FileCityExplorer/scopeTreePaths.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,oBAAoB,CAAC;AACnD,eAAO,MAAM,qBAAqB,gBAAgB,CAAC;AAEnD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,GAAG,MAAM,EAAE,CAkB5E;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,CAUnE"}

package/dist/panels/FileCityExplorerPanel/FileCityExplorer/styles.d.ts

@@ -0,0 +1,9 @@
+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;
+/** 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. */
+export declare const makeOverlayStyle: (theme: Theme) => React.CSSProperties;
+//# sourceMappingURL=styles.d.ts.map

package/dist/panels/FileCityExplorerPanel/FileCityExplorer/styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../../../../src/panels/FileCityExplorerPanel/FileCityExplorer/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"}

package/dist/panels/FileCityExplorerPanel/FileCityExplorerPanel.d.ts

@@ -0,0 +1,4 @@
+import React from 'react';
+import type { FileCityExplorerPanelPropsTyped } from '../../types/FileCityExplorerPanel';
+export declare const FileCityExplorerPanel: React.FC<FileCityExplorerPanelPropsTyped>;
+//# sourceMappingURL=FileCityExplorerPanel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"FileCityExplorerPanel.d.ts","sourceRoot":"","sources":["../../../src/panels/FileCityExplorerPanel/FileCityExplorerPanel.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AA+B1B,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,mCAAmC,CAAC;AAoCzF,eAAO,MAAM,qBAAqB,EAAE,KAAK,CAAC,EAAE,CAAC,+BAA+B,CAikB3E,CAAC"}

package/dist/panels/FileCityExplorerPanel/buildCityDataFromContext.d.ts

@@ -0,0 +1,34 @@
+import { type CityData } from '@principal-ai/file-city-builder';
+import type { FileTree as RepoFileTree } from '@principal-ai/repository-abstraction';
+export interface BuildCityDataInput {
+    fileTree: RepoFileTree;
+    /**
+     * Pre-computed file line counts keyed by repo-relative path (the
+     * shape `LineCountsSliceData.lineCounts` produces). Pass `null`/
+     * `undefined` to fall back to the heuristic estimator.
+     */
+    lineCounts?: Record<string, number> | null;
+}
+/**
+ * Builds `CityData` from a repo file tree.
+ *
+ * Building paths come out repo-relative (e.g. `src/x.ts`), matching the
+ * documented `LayerItem.path` contract ("relative to repository root"). We
+ * deliberately pass an empty `rootPath` into the city builder so it doesn't
+ * leak the `FileTree`'s generated `metadata.id`
+ * (`git-<sha>-<dirty>-<ts>`) onto every building.
+ *
+ * When real line counts are supplied via the `lineCounts` slice, building
+ * heights reflect them; otherwise we fall back to a heuristic estimate so
+ * the city still renders.
+ */
+export declare function buildCityDataFromContext(input: BuildCityDataInput): CityData;
+/**
+ * Strip the `FileTree`'s generated `rootPath` (`git-<sha>-<dirty>-<ts>`)
+ * from a path. Kept for callers that still see prefixed paths (e.g.
+ * file-tree selection paths sourced from `tree.allFiles[].path`). Building
+ * paths produced by `buildCityDataFromContext` are already repo-relative so
+ * this is a no-op there.
+ */
+export declare function stripRootPath(path: string, rootPath: string): string;
+//# sourceMappingURL=buildCityDataFromContext.d.ts.map

package/dist/panels/FileCityExplorerPanel/buildCityDataFromContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildCityDataFromContext.d.ts","sourceRoot":"","sources":["../../../src/panels/FileCityExplorerPanel/buildCityDataFromContext.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,QAAQ,EACd,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EAAE,QAAQ,IAAI,YAAY,EAAE,MAAM,sCAAsC,CAAC;AAMrF,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,YAAY,CAAC;IACvB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;CAC5C;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,kBAAkB,GACxB,QAAQ,CAQV;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAKpE"}

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

@@ -0,0 +1,4 @@
+export { FileCityExplorerPanel } from './FileCityExplorerPanel';
+export { buildCityDataFromContext, stripRootPath, type BuildCityDataInput, } from './buildCityDataFromContext';
+export { FileCityExplorer, type FileCityExplorerProps, } from './FileCityExplorer';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/panels/FileCityExplorerPanel/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EACL,wBAAwB,EACxB,aAAa,EACb,KAAK,kBAAkB,GACxB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,gBAAgB,EAChB,KAAK,qBAAqB,GAC3B,MAAM,oBAAoB,CAAC"}

package/dist/panels/FileCityExplorerPanel/overlays/FileOverlay.d.ts

@@ -0,0 +1,11 @@
+import React from 'react';
+export interface FileOverlayProps {
+    filePath: string;
+    fileName: string;
+    /** Host-supplied file reader, forwarded to PierreFileView. */
+    readFile: (path: string) => Promise<string>;
+    onClose: () => void;
+    onOpenInTab?: () => void;
+}
+export declare const FileOverlay: React.FC<FileOverlayProps>;
+//# sourceMappingURL=FileOverlay.d.ts.map

package/dist/panels/FileCityExplorerPanel/overlays/FileOverlay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileOverlay.d.ts","sourceRoot":"","sources":["../../../../src/panels/FileCityExplorerPanel/overlays/FileOverlay.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAM1B,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,8DAA8D;IAC9D,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5C,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;CAC1B;AAMD,eAAO,MAAM,WAAW,EAAE,KAAK,CAAC,EAAE,CAAC,gBAAgB,CAkKlD,CAAC"}

package/dist/panels/FileCityExplorerPanel/overlays/MarkdownNotes.d.ts

@@ -0,0 +1,58 @@
+import React from 'react';
+export interface MarkdownNote {
+    id: string;
+    /** themed-markdown anchor — same shape we send back via the API. */
+    anchor: {
+        exact: string;
+        prefix?: string;
+        suffix?: string;
+    };
+    body: string;
+    author?: string;
+    /** ms epoch — projection from the persisted ISO string. */
+    createdAt: number;
+}
+export type MarkdownNotesSelection = {
+    kind: 'thread';
+    noteId: string;
+} | {
+    kind: 'composer';
+    anchor: {
+        exact: string;
+        prefix?: string;
+        suffix?: string;
+    };
+};
+interface SelectionPillProps {
+    /** Pixel rect of the current selection in the parent container's coords. */
+    rect: {
+        left: number;
+        top: number;
+        right: number;
+        bottom: number;
+    };
+    onClick: () => void;
+}
+/**
+ * Floating "Add note" pill that hovers above (or just below) the active text
+ * selection. Position is computed by the parent — this component just paints.
+ */
+export declare const MarkdownSelectionPill: React.FC<SelectionPillProps>;
+interface NotePanelProps {
+    selection: MarkdownNotesSelection;
+    notes: MarkdownNote[];
+    style: React.CSSProperties;
+    onClose: () => void;
+    /** Submit composer with the pending anchor. */
+    onSubmitNote: (anchor: {
+        exact: string;
+        prefix?: string;
+        suffix?: string;
+    }, body: string) => void;
+    /** Reply to an existing thread; replies share the head's anchor. */
+    onReplyNote: (noteId: string, body: string) => void;
+    onDeleteNote: (id: string) => void;
+}
+export declare const MarkdownNotePanel: React.FC<NotePanelProps>;
+export {};
+//# sourceMappingURL=MarkdownNotes.d.ts.map

package/dist/panels/FileCityExplorerPanel/overlays/MarkdownNotes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MarkdownNotes.d.ts","sourceRoot":"","sources":["../../../../src/panels/FileCityExplorerPanel/overlays/MarkdownNotes.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAI1B,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,oEAAoE;IACpE,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2DAA2D;IAC3D,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,sBAAsB,GAC9B;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAClC;IACE,IAAI,EAAE,UAAU,CAAC;IACjB,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC7D,CAAC;AAsBN,UAAU,kBAAkB;IAC1B,4EAA4E;IAC5E,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACnE,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,KAAK,CAAC,EAAE,CAAC,kBAAkB,CA4C9D,CAAC;AAEF,UAAU,cAAc;IACtB,SAAS,EAAE,sBAAsB,CAAC;IAClC,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,KAAK,EAAE,KAAK,CAAC,aAAa,CAAC;IAC3B,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,+CAA+C;IAC/C,YAAY,EAAE,CACZ,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,EAC3D,IAAI,EAAE,MAAM,KACT,IAAI,CAAC;IACV,oEAAoE;IACpE,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACpD,YAAY,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;CACpC;AAED,eAAO,MAAM,iBAAiB,EAAE,KAAK,CAAC,EAAE,CAAC,cAAc,CAqKtD,CAAC"}

package/dist/panels/FileCityExplorerPanel/overlays/PierreFileView.d.ts

@@ -0,0 +1,11 @@
+import React from 'react';
+export interface PierreFileViewProps {
+    filePath: string;
+    fileName: string;
+    /** Host-supplied file reader (closures bind any path-normalization). */
+    readFile: (path: string) => Promise<string>;
+    /** Override Pierre's container background. Any CSS color string. */
+    background?: string;
+}
+export declare const PierreFileView: React.FC<PierreFileViewProps>;
+//# sourceMappingURL=PierreFileView.d.ts.map

package/dist/panels/FileCityExplorerPanel/overlays/PierreFileView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PierreFileView.d.ts","sourceRoot":"","sources":["../../../../src/panels/FileCityExplorerPanel/overlays/PierreFileView.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAI1B,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,wEAAwE;IACxE,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5C,oEAAoE;IACpE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,cAAc,EAAE,KAAK,CAAC,EAAE,CAAC,mBAAmB,CAsDxD,CAAC"}

package/dist/panels/FileCityExplorerPanel/overlays/PierreSnippetDiffView.d.ts

@@ -0,0 +1,28 @@
+import React from 'react';
+export type PierreSnippetDiffStyle = 'unified' | 'split';
+export interface PierreSnippetDiffViewProps {
+    /** File name used for display + syntax-highlighting language inference. */
+    fileName: string;
+    /** Pre-change file contents. Pass the full file or a pre-sliced window. */
+    oldContents: string;
+    /** Post-change file contents. Should align line-wise with `oldContents`. */
+    newContents: string;
+    /**
+     * Optional snippet window applied to both contents before diffing
+     * (1-based, inclusive). Use this when `oldContents`/`newContents` are full
+     * files and you want the diff scoped to a region. 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 to keep above/below the snippet window. 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?: PierreSnippetDiffStyle;
+}
+export declare const PierreSnippetDiffView: React.FC<PierreSnippetDiffViewProps>;
+//# sourceMappingURL=PierreSnippetDiffView.d.ts.map

package/dist/panels/FileCityExplorerPanel/overlays/PierreSnippetDiffView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PierreSnippetDiffView.d.ts","sourceRoot":"","sources":["../../../../src/panels/FileCityExplorerPanel/overlays/PierreSnippetDiffView.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAK1B,MAAM,MAAM,sBAAsB,GAAG,SAAS,GAAG,OAAO,CAAC;AAEzD,MAAM,WAAW,0BAA0B;IACzC,2EAA2E;IAC3E,QAAQ,EAAE,MAAM,CAAC;IACjB,2EAA2E;IAC3E,WAAW,EAAE,MAAM,CAAC;IACpB,4EAA4E;IAC5E,WAAW,EAAE,MAAM,CAAC;IACpB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sFAAsF;IACtF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oFAAoF;IACpF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oEAAoE;IACpE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kEAAkE;IAClE,SAAS,CAAC,EAAE,sBAAsB,CAAC;CACpC;AA8CD,eAAO,MAAM,qBAAqB,EAAE,KAAK,CAAC,EAAE,CAAC,0BAA0B,CA8FtE,CAAC"}

package/dist/panels/FileCityExplorerPanel/overlays/PierreSnippetView.d.ts

@@ -0,0 +1,42 @@
+import React from 'react';
+import { type SnippetNote } from './SnippetNotes';
+export interface PierreSnippetViewProps {
+    filePath: string;
+    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. */
+    readFile: (path: string) => Promise<string>;
+    /** Override Pierre's container background. Any CSS color string. */
+    background?: string;
+    /** Notes anchored to absolute file ranges. */
+    notes?: SnippetNote[];
+    /** Thread whose notes panel is currently open (renders matching indicators as active). */
+    activeThreadKey?: string | null;
+    /** While true, indicators are dimmed and don't respond to clicks. */
+    composerOpen?: boolean;
+    /** Open the side panel in thread-view mode for the given threadKey. */
+    onOpenThread?: (threadKey: string) => void;
+    /** Close the side panel — wired to indicator clicks on the active thread. */
+    onCloseThread?: () => void;
+    /**
+     * Open or extend the side panel composer with a range. Called when the
+     * user uses Pierre's gutter "+" (with or without a multi-line drag-select).
+     * The line text endpoints are captured so the consumer can persist them as
+     * re-anchor fingerprints on the note's anchor.
+     */
+    onOpenComposer?: (input: {
+        startLine: number;
+        endLine: number;
+        startLineText: string;
+        endLineText: string;
+    }) => void;
+}
+export declare const PierreSnippetView: React.FC<PierreSnippetViewProps>;
+//# sourceMappingURL=PierreSnippetView.d.ts.map

package/dist/panels/FileCityExplorerPanel/overlays/PierreSnippetView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PierreSnippetView.d.ts","sourceRoot":"","sources":["../../../../src/panels/FileCityExplorerPanel/overlays/PierreSnippetView.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAK1B,OAAO,EAEL,KAAK,WAAW,EAEjB,MAAM,gBAAgB,CAAC;AAexB,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,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,iCAAiC;IACjC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5C,oEAAoE;IACpE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8CAA8C;IAC9C,KAAK,CAAC,EAAE,WAAW,EAAE,CAAC;IACtB,0FAA0F;IAC1F,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,qEAAqE;IACrE,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,uEAAuE;IACvE,YAAY,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3C,6EAA6E;IAC7E,aAAa,CAAC,EAAE,MAAM,IAAI,CAAC;IAC3B;;;;;OAKG;IACH,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE;QACvB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,aAAa,EAAE,MAAM,CAAC;QACtB,WAAW,EAAE,MAAM,CAAC;KACrB,KAAK,IAAI,CAAC;CACZ;AAED,eAAO,MAAM,iBAAiB,EAAE,KAAK,CAAC,EAAE,CAAC,sBAAsB,CA6O9D,CAAC"}

package/dist/panels/FileCityExplorerPanel/overlays/SequenceDiagramOverlay.d.ts

@@ -0,0 +1,15 @@
+import React from 'react';
+import '@xyflow/react/dist/style.css';
+import type { SequenceDiagramPayload } from '../../../types/SequenceDiagram';
+export interface SequenceDiagramOverlayProps {
+    payload: SequenceDiagramPayload;
+    selectedEventId: string | null;
+    onNodeClick: (nodeId: string | null) => void;
+    onClose: () => void;
+    /** Drawer height as a percentage of the panel height. */
+    heightPct: number;
+    /** Called as the user drags the top edge to resize. */
+    onHeightChange: (pct: number) => void;
+}
+export declare const SequenceDiagramOverlay: React.FC<SequenceDiagramOverlayProps>;
+//# sourceMappingURL=SequenceDiagramOverlay.d.ts.map