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

package/dist/types/index.d.ts

@@ -0,0 +1,204 @@
+/**
+ * Panel Extension Type Definitions
+ *
+ * Re-exports core types from @principal-ade/panel-framework-core
+ */
+export type { DataSlice, WorkspaceMetadata, RepositoryMetadata, FileTreeSource, ActiveFileSlice, PanelEventType, PanelEvent, PanelEventEmitter, PanelContextValue, PanelComponentProps, PanelMetadata, PanelLifecycleHooks, PanelDefinition, PanelModule, PanelRegistryEntry, PanelLoader, PanelRegistryConfig, } from '@principal-ade/panel-framework-core';
+import type { PanelActions as CorePanelActions, PanelComponentProps as CorePanelComponentProps, DataSlice } from '@principal-ade/panel-framework-core';
+import type { TourAudioContext } from './TextToSpeech';
+import type { FileTree, GitStatusWithFiles } from '@principal-ai/repository-abstraction';
+import type { AlexandriaEntry } from '@principal-ai/alexandria-core-library';
+import type { StoryboardContextSliceData } from '@principal-ai/principal-view-core';
+import type { FileCityColorModesSliceData } from '../panels/utils/qualityLayers';
+import type { HighlightLayer } from '@principal-ai/file-city-react';
+import type { GitHubRepoInfo, RootPackageInfo } from '../panels/components/FeedProjectHeader';
+/**
+ * Extended PanelActions with File City specific actions
+ * Extends the base PanelActions from panel-framework-core
+ */
+export interface PanelActions extends CorePanelActions {
+    /**
+     * Fetch audio URLs for a tour
+     *
+     * The host application implements this to fetch audio from its TTS backend.
+     * Returns a Map of stepId -> audioUrl for all steps in the tour.
+     *
+     * @param context - Tour source context (owner, repo, path, commitSha)
+     * @returns Map of stepId to audio URL
+     */
+    fetchAudioUrls?: (context: TourAudioContext) => Promise<Map<string, string>>;
+    /**
+     * Stage a file for git commit
+     *
+     * The host application implements this to stage a file in git.
+     *
+     * @param filePath - Path to the file to stage
+     */
+    stageFile?: (filePath: string) => void;
+    /**
+     * Unstage a file from git staging area
+     *
+     * The host application implements this to unstage a file in git.
+     *
+     * @param filePath - Path to the file to unstage
+     */
+    unstageFile?: (filePath: string) => void;
+    /**
+     * Open a file in the active editor
+     *
+     * @param filePath - Path to the file to open
+     * @param line - Optional line number to navigate to
+     */
+    openFile?: (filePath: string, line?: number) => void;
+    /**
+     * Learn more action - typically opens documentation or help
+     *
+     * When provided, a "Learn More" button will appear in the panel header.
+     */
+    learnMore?: () => void;
+}
+import type { PackagesSliceData } from '@principal-ai/codebase-composition';
+export type { PackagesSliceData };
+/**
+ * PR files data - files changed in a selected pull request
+ */
+export interface PrFilesSliceData {
+    files: Array<{
+        sha: string;
+        filename: string;
+        status: 'added' | 'removed' | 'modified' | 'renamed' | 'copied' | 'changed' | 'unchanged';
+        additions: number;
+        deletions: number;
+        changes: number;
+    }>;
+    filesByStatus: {
+        added: string[];
+        modified: string[];
+        removed: string[];
+        renamed: {
+            filename: string;
+            previous_filename?: string;
+        }[];
+    };
+    pullNumber: number | null;
+    owner?: string;
+    repo?: string;
+}
+/**
+ * Commit files data - files changed in a selected commit
+ */
+export interface CommitFilesSliceData {
+    filesByStatus: {
+        added: string[];
+        modified: string[];
+        removed: string[];
+        renamed: string[];
+    };
+    commitHash: string | null;
+    stats?: {
+        total: number;
+        additions: number;
+        deletions: number;
+    };
+}
+/**
+ * Activity data for a single day
+ */
+export interface ActivityDay {
+    date: string;
+    count: number;
+}
+/**
+ * Activity heatmap slice data - commit activity over time
+ */
+export interface ActivityHeatmapSliceData {
+    /** Activity data points */
+    days: ActivityDay[];
+}
+/**
+ * Fork tour availability slice data
+ * When viewing a parent repo that has a tour available in a fork
+ */
+export interface ForkTourSliceData {
+    /** Raw tour file content (JSON string) - consumer parses with parseTour */
+    tourContent: string;
+    /** Fork owner where the tour exists */
+    forkOwner: string;
+    /** Fork repo name */
+    forkRepo: string;
+    /** Path to the tour file in the fork */
+    tourPath: string;
+}
+/**
+ * Feed project slice data - GitHub repo and package info for feed view
+ */
+export interface FeedProjectSliceData {
+    /** GitHub repository information */
+    repo: GitHubRepoInfo;
+    /** Root package information (optional) */
+    rootPackage?: RootPackageInfo;
+}
+export type { AlexandriaEntry } from '@principal-ai/alexandria-core-library';
+/**
+ * Line counts data - maps file paths to line counts
+ * Used to set building heights in File City 3D visualization
+ */
+export interface LineCountsSliceData {
+    /** Map of file path to line count */
+    lineCounts: Record<string, number>;
+    /** Status of line counts availability */
+    status: 'available' | 'too-large' | 'auth-required' | 'loading' | null;
+    /** Message to display when line counts are unavailable */
+    message?: string;
+}
+/**
+ * Typed context for CodeCityPanel
+ *
+ * Note: Optional slices use `DataSlice<T | null>` to distinguish between:
+ * - `null` = "not fetched yet" or "not available"
+ * - Empty data = "fetched successfully, no items"
+ */
+export interface CodeCityPanelContext {
+    fileTree: DataSlice<FileTree>;
+    fileCityColorModes: DataSlice<FileCityColorModesSliceData>;
+    gitStatusWithFiles?: DataSlice<GitStatusWithFiles | null>;
+    prFiles?: DataSlice<PrFilesSliceData | null>;
+    commitFiles?: DataSlice<CommitFilesSliceData | null>;
+    storyboardContext?: DataSlice<StoryboardContextSliceData | null>;
+    agentHighlightLayers?: DataSlice<HighlightLayer[]>;
+    packages?: DataSlice<PackagesSliceData | null>;
+    /** Repository entry with GitHub metadata */
+    repositoryEntry?: DataSlice<AlexandriaEntry | null>;
+    /** Activity heatmap data (commits per day) */
+    activityHeatmap?: DataSlice<ActivityHeatmapSliceData | null>;
+    /** Tour from a fork repo (when parent repo has tour available in fork) */
+    forkTour?: DataSlice<ForkTourSliceData | null>;
+    /** Line counts for building heights (from cache or computed) */
+    lineCounts?: DataSlice<LineCountsSliceData | null>;
+    /** Whether to show the architecture scopes canvas tab (default: false) */
+    showScopesCanvas?: boolean;
+}
+/**
+ * Typed panel props for CodeCityPanel
+ */
+export type CodeCityPanelPropsTyped = CorePanelComponentProps<PanelActions, CodeCityPanelContext>;
+/**
+ * Typed context for FeedCodeCityPanel
+ */
+export interface FeedCodeCityPanelContext {
+    fileTree: DataSlice<FileTree>;
+    feedProject: DataSlice<FeedProjectSliceData>;
+}
+/**
+ * Typed panel props for FeedCodeCityPanel
+ */
+export type FeedCodeCityPanelPropsTyped = CorePanelComponentProps<PanelActions, FeedCodeCityPanelContext>;
+export type { FileCityColorModesSliceData, QualitySliceData, ColorMode, ColorModeConfig, FileMetricData, HighlightLayer, } from '../panels/utils/qualityLayers';
+export type { IntroductionTour, IntroductionTourStep, HighlightLayerConfig, InteractiveAction, TourResource, TourMetadata, ColorMode as TourColorMode, } from '@principal-ai/file-city-builder';
+export type { TextToSpeechAdapter, TTSState, TTSOptions, TTSEvent, TourAudioContext, } from './TextToSpeech';
+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 { NodePosition, EventAttributeSchema, EventRecord, NamespaceRecord, ScopeRecord, ScopeWorkspace, AddScopeInput, AddNamespaceInput, AddPathToNamespaceInput, AddEventInput, } from './Scope';
+export type { LatestCommitFileEntry, LatestCommitSliceData, AreaWorkspace, FileCityExplorerRepository, FileCityExplorerPanelContext, AddToScopeActionInput, AddAreaActionInput, AddPathToAreaActionInput, FileCityExplorerPanelActions, FileCityExplorerPanelPropsTyped, } from './FileCityExplorerPanel';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,YAAY,EAEV,SAAS,EACT,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,EACd,eAAe,EAGf,cAAc,EACd,UAAU,EACV,iBAAiB,EAGjB,iBAAiB,EACjB,mBAAmB,EAGnB,aAAa,EACb,mBAAmB,EACnB,eAAe,EACf,WAAW,EAGX,kBAAkB,EAClB,WAAW,EACX,mBAAmB,GACpB,MAAM,qCAAqC,CAAC;AAE7C,OAAO,KAAK,EACV,YAAY,IAAI,gBAAgB,EAChC,mBAAmB,IAAI,uBAAuB,EAC9C,SAAS,EACV,MAAM,qCAAqC,CAAC;AAC7C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,KAAK,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AACzF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AAC7E,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AACpF,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AACjF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,wCAAwC,CAAC;AAE9F;;;GAGG;AACH,MAAM,WAAW,YAAa,SAAQ,gBAAgB;IACpD;;;;;;;;OAQG;IACH,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAE7E;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAEvC;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAEzC;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAErD;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;CACxB;AAOD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAC5E,YAAY,EAAE,iBAAiB,EAAE,CAAC;AAElC;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,KAAK,CAAC;QACX,GAAG,EAAE,MAAM,CAAC;QACZ,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,OAAO,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,CAAC;QAC1F,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC,CAAC;IACH,aAAa,EAAE;QACb,KAAK,EAAE,MAAM,EAAE,CAAC;QAChB,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,OAAO,EAAE,MAAM,EAAE,CAAC;QAClB,OAAO,EAAE;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,iBAAiB,CAAC,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;KAC7D,CAAC;IACF,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,aAAa,EAAE;QACb,KAAK,EAAE,MAAM,EAAE,CAAC;QAChB,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,OAAO,EAAE,MAAM,EAAE,CAAC;QAClB,OAAO,EAAE,MAAM,EAAE,CAAC;KACnB,CAAC;IACF,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,KAAK,CAAC,EAAE;QACN,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,2BAA2B;IAC3B,IAAI,EAAE,WAAW,EAAE,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,2EAA2E;IAC3E,WAAW,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,qBAAqB;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,wCAAwC;IACxC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,oCAAoC;IACpC,IAAI,EAAE,cAAc,CAAC;IACrB,0CAA0C;IAC1C,WAAW,CAAC,EAAE,eAAe,CAAC;CAC/B;AAGD,YAAY,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AAE7E;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,qCAAqC;IACrC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,yCAAyC;IACzC,MAAM,EAAE,WAAW,GAAG,WAAW,GAAG,eAAe,GAAG,SAAS,GAAG,IAAI,CAAC;IACvE,0DAA0D;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,SAAS,CAAC,QAAQ,CAAC,CAAC;IAC9B,kBAAkB,EAAE,SAAS,CAAC,2BAA2B,CAAC,CAAC;IAC3D,kBAAkB,CAAC,EAAE,SAAS,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAAC;IAC1D,OAAO,CAAC,EAAE,SAAS,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;IAC7C,WAAW,CAAC,EAAE,SAAS,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAAC;IACrD,iBAAiB,CAAC,EAAE,SAAS,CAAC,0BAA0B,GAAG,IAAI,CAAC,CAAC;IACjE,oBAAoB,CAAC,EAAE,SAAS,CAAC,cAAc,EAAE,CAAC,CAAC;IACnD,QAAQ,CAAC,EAAE,SAAS,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC;IAC/C,4CAA4C;IAC5C,eAAe,CAAC,EAAE,SAAS,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC;IACpD,8CAA8C;IAC9C,eAAe,CAAC,EAAE,SAAS,CAAC,wBAAwB,GAAG,IAAI,CAAC,CAAC;IAC7D,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,SAAS,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC;IAC/C,gEAAgE;IAChE,UAAU,CAAC,EAAE,SAAS,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAAC;IACnD,0EAA0E;IAC1E,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,uBAAuB,CAC3D,YAAY,EACZ,oBAAoB,CACrB,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,SAAS,CAAC,QAAQ,CAAC,CAAC;IAC9B,WAAW,EAAE,SAAS,CAAC,oBAAoB,CAAC,CAAC;CAC9C;AAED;;GAEG;AACH,MAAM,MAAM,2BAA2B,GAAG,uBAAuB,CAC/D,YAAY,EACZ,wBAAwB,CACzB,CAAC;AAGF,YAAY,EACV,2BAA2B,EAC3B,gBAAgB,EAChB,SAAS,EACT,eAAe,EACf,cAAc,EACd,cAAc,GACf,MAAM,+BAA+B,CAAC;AAGvC,YAAY,EACV,gBAAgB,EAChB,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,EACjB,YAAY,EACZ,YAAY,EACZ,SAAS,IAAI,aAAa,GAC3B,MAAM,iCAAiC,CAAC;AAGzC,YAAY,EACV,mBAAmB,EACnB,QAAQ,EACR,UAAU,EACV,QAAQ,EACR,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AAGxB,YAAY,EACV,sBAAsB,GACvB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAInD,YAAY,EACV,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,oBAAoB,EACpB,wBAAwB,EACxB,qBAAqB,EACrB,UAAU,EACV,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,uBAAuB,EACvB,iBAAiB,EACjB,oBAAoB,EACpB,YAAY,EACZ,iBAAiB,EACjB,sBAAsB,EACtB,6BAA6B,GAC9B,MAAM,mBAAmB,CAAC;AAI3B,YAAY,EACV,YAAY,EACZ,oBAAoB,EACpB,WAAW,EACX,eAAe,EACf,WAAW,EACX,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,uBAAuB,EACvB,aAAa,GACd,MAAM,SAAS,CAAC;AAGjB,YAAY,EACV,qBAAqB,EACrB,qBAAqB,EACrB,aAAa,EACb,0BAA0B,EAC1B,4BAA4B,EAC5B,qBAAqB,EACrB,kBAAkB,EAClB,wBAAwB,EACxB,4BAA4B,EAC5B,+BAA+B,GAChC,MAAM,yBAAyB,CAAC"}

package/dist/utils/index.d.ts

@@ -0,0 +1,3 @@
+export { parseTour, parseTourOrThrow, loadTourFromFileTree, TourValidationError, findTourFilePathInFileTree, findAllTourFilesInFileTree, } from '@principal-ai/file-city-builder';
+export type { TourParseResult } from '@principal-ai/file-city-builder';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,SAAS,EACT,gBAAgB,EAChB,oBAAoB,EACpB,mBAAmB,EACnB,0BAA0B,EAC1B,0BAA0B,GAC3B,MAAM,iCAAiC,CAAC;AACzC,YAAY,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC"}

package/package.json

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