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

package/dist/panels/components/StoryboardFilesCardList.d.ts

@@ -0,0 +1,28 @@
+import React from 'react';
+import type { StoryboardContextSliceData } from '../CodeCityPanel';
+/** File category for selection callbacks */
+export type StoryboardFileCategory = 'source' | 'supporting';
+interface StoryboardFilesCardListProps {
+    /** Storyboard context data */
+    storyboardContext: StoryboardContextSliceData;
+    /** Horizontal padding for cards */
+    horizontalPadding?: string;
+    /** Callback when a file is clicked */
+    onFileClick?: (filePath: string, category?: StoryboardFileCategory) => void;
+    /** Callback when a file is hovered */
+    onFileHover?: (filePath: string | null) => void;
+    /** Whether to show the header (hierarchy breadcrumb and legend). Default true. */
+    showHeader?: boolean;
+    /** Currently selected file path (shows selection styling and Open button) */
+    selectedFile?: string | null;
+    /** Callback when Open button is clicked on selected file */
+    onOpenFile?: (filePath: string) => void;
+}
+/**
+ * StoryboardFilesCardList displays storyboard-associated files as a flat list of cards.
+ * Shows the hierarchy header (storyboard → workflow → scenario) and files categorized
+ * as source files (blue) or supporting files (gray).
+ */
+export declare const StoryboardFilesCardList: React.FC<StoryboardFilesCardListProps>;
+export {};
+//# sourceMappingURL=StoryboardFilesCardList.d.ts.map

package/dist/panels/components/StoryboardFilesCardList.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StoryboardFilesCardList.d.ts","sourceRoot":"","sources":["../../../src/panels/components/StoryboardFilesCardList.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA+B,MAAM,OAAO,CAAC;AAGpD,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AAEnE,4CAA4C;AAC5C,MAAM,MAAM,sBAAsB,GAAG,QAAQ,GAAG,YAAY,CAAC;AAE7D,UAAU,4BAA4B;IACpC,8BAA8B;IAC9B,iBAAiB,EAAE,0BAA0B,CAAC;IAC9C,mCAAmC;IACnC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,sCAAsC;IACtC,WAAW,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,sBAAsB,KAAK,IAAI,CAAC;IAC5E,sCAAsC;IACtC,WAAW,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IAChD,kFAAkF;IAClF,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,6EAA6E;IAC7E,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,4DAA4D;IAC5D,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;CACzC;AAED;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,EAAE,KAAK,CAAC,EAAE,CAAC,4BAA4B,CA6I1E,CAAC"}

package/dist/panels/components/StoryboardFilesTree.d.ts

@@ -0,0 +1,26 @@
+import React from 'react';
+import type { StoryboardContextSliceData } from '../CodeCityPanel';
+/** File category for selection callbacks */
+export type StoryboardFileCategory = 'source' | 'supporting';
+interface StoryboardFilesTreeProps {
+    /** Storyboard context data */
+    storyboardContext: StoryboardContextSliceData;
+    /** Root path for the repository (used for building file trees) */
+    rootPath?: string;
+    /** Horizontal padding for tree nodes */
+    horizontalPadding?: string;
+    /** Callback when a file is clicked */
+    onFileClick?: (filePath: string, category?: StoryboardFileCategory) => void;
+    /** Callback when a node is hovered */
+    onNodeHover?: (nodePath: string | null, isFolder: boolean) => void;
+    /** Whether to show the header (hierarchy breadcrumb and legend). Default true. */
+    showHeader?: boolean;
+}
+/**
+ * StoryboardFilesTree component that displays storyboard-associated files in a tree format.
+ * Shows the hierarchy header (storyboard → workflow → scenario) and files categorized
+ * as source files (from nodes' pv.sources) or supporting files (canvas, docs, workflow).
+ */
+export declare const StoryboardFilesTree: React.FC<StoryboardFilesTreeProps>;
+export {};
+//# sourceMappingURL=StoryboardFilesTree.d.ts.map

package/dist/panels/components/StoryboardFilesTree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StoryboardFilesTree.d.ts","sourceRoot":"","sources":["../../../src/panels/components/StoryboardFilesTree.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA+B,MAAM,OAAO,CAAC;AAIpD,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AAEnE,4CAA4C;AAC5C,MAAM,MAAM,sBAAsB,GAAG,QAAQ,GAAG,YAAY,CAAC;AAQ7D,UAAU,wBAAwB;IAChC,8BAA8B;IAC9B,iBAAiB,EAAE,0BAA0B,CAAC;IAC9C,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,sCAAsC;IACtC,WAAW,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,sBAAsB,KAAK,IAAI,CAAC;IAC5E,sCAAsC;IACtC,WAAW,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,EAAE,QAAQ,EAAE,OAAO,KAAK,IAAI,CAAC;IACnE,kFAAkF;IAClF,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,EAAE,KAAK,CAAC,EAAE,CAAC,wBAAwB,CA0NlE,CAAC"}

package/dist/panels/components/StoryboardView.d.ts

@@ -0,0 +1,38 @@
+import React from 'react';
+import { type StoryboardFileCategory } from './StoryboardFilesCardList';
+import type { StoryboardContextSliceData } from '../CodeCityPanel';
+interface StoryboardViewProps {
+    /** Storyboard context data */
+    storyboardContext: StoryboardContextSliceData;
+    /** Whether to show section header (default: true) */
+    showHeader?: boolean;
+    /** Horizontal padding for content */
+    horizontalPadding?: string;
+    /** Callback when the storyboard name is clicked (to focus on canvas panel) */
+    onStoryboardClick?: (storyboard: {
+        id: string;
+        name: string;
+        path: string;
+    }) => void;
+    /** Callback when the workflow name is clicked (to focus on workflow panel) */
+    onWorkflowClick?: (workflow: {
+        id: string;
+        name: string;
+        path: string;
+    }) => void;
+    /** Callback when a storyboard file is clicked */
+    onFileClick?: (filePath: string, category?: StoryboardFileCategory) => void;
+    /** Callback when a storyboard node is hovered */
+    onFileHover?: (filePath: string | null) => void;
+    /** Currently selected file in storyboard (for selection styling) */
+    selectedFile?: string | null;
+    /** Callback when Open button is clicked on a storyboard file */
+    onOpenFile?: (filePath: string) => void;
+}
+/**
+ * StoryboardView displays the storyboard context with hierarchy breadcrumb and file list.
+ * Provides a view suitable for the tab panel.
+ */
+export declare const StoryboardView: React.FC<StoryboardViewProps>;
+export {};
+//# sourceMappingURL=StoryboardView.d.ts.map

package/dist/panels/components/StoryboardView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StoryboardView.d.ts","sourceRoot":"","sources":["../../../src/panels/components/StoryboardView.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,OAAO,EAA2B,KAAK,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACjG,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AAEnE,UAAU,mBAAmB;IAC3B,8BAA8B;IAC9B,iBAAiB,EAAE,0BAA0B,CAAC;IAC9C,qDAAqD;IACrD,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,qCAAqC;IACrC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,8EAA8E;IAC9E,iBAAiB,CAAC,EAAE,CAAC,UAAU,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IACrF,8EAA8E;IAC9E,eAAe,CAAC,EAAE,CAAC,QAAQ,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IACjF,iDAAiD;IACjD,WAAW,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,sBAAsB,KAAK,IAAI,CAAC;IAC5E,iDAAiD;IACjD,WAAW,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IAChD,oEAAoE;IACpE,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,gEAAgE;IAChE,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;CACzC;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,KAAK,CAAC,EAAE,CAAC,mBAAmB,CA+HxD,CAAC"}

package/dist/panels/index.d.ts

@@ -0,0 +1,4 @@
+export { CodeCityPanel, CodeCityPanelPreview, CodeCityPanelContent } from './CodeCityPanel';
+export { FeedCodeCityPanel, FeedCodeCityPanelPreview } from './FeedCodeCityPanel';
+export type { PrFilesSliceData, CommitFilesSliceData, StoryboardContextSliceData, } from './CodeCityPanel';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/panels/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAC5F,OAAO,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAGlF,YAAY,EACV,gBAAgB,EAChB,oBAAoB,EACpB,0BAA0B,GAC3B,MAAM,iBAAiB,CAAC"}

package/dist/panels/stress-test-data.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Stress test data generator for testing subdirectory selection performance
+ * with large repository simulations.
+ */
+interface FileInfo {
+    path: string;
+    name: string;
+    size: number;
+}
+/**
+ * Generate a large number of file paths with realistic nested directory structures
+ */
+export declare function generateLargeFilePaths(fileCount: number): string[];
+/**
+ * Convert file paths to FileInfo objects for the panel
+ */
+export declare function createFileInfoList(paths: string[]): FileInfo[];
+/**
+ * Create file list with a large number of files for stress testing subdirectory selection
+ *
+ * @param fileCount - Number of files to generate (default: 8000)
+ * @param useCache - Whether to cache results (default: true)
+ */
+export declare function createStressTestFileList(fileCount?: number, useCache?: boolean): FileInfo[];
+/**
+ * Get unique directory paths at each depth level from file list
+ * Useful for creating navigation buttons in stress test UI
+ */
+export declare function getDirectoryPaths(files: FileInfo[]): {
+    topLevel: string[];
+    depth2: string[];
+    depth3: string[];
+    depth4: string[];
+};
+/**
+ * Clear the stress test cache (useful for testing memory)
+ */
+export declare function clearStressTestCache(): void;
+export {};
+//# sourceMappingURL=stress-test-data.d.ts.map

package/dist/panels/stress-test-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stress-test-data.d.ts","sourceRoot":"","sources":["../../src/panels/stress-test-data.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,UAAU,QAAQ;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAiCD;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAoElE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE,CAO9D;AAKD;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,SAAS,GAAE,MAAa,EAAE,QAAQ,GAAE,OAAc,GAAG,QAAQ,EAAE,CAavG;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG;IACpD,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CAmBA;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C"}

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

@@ -0,0 +1,5 @@
+import type { CityData } from '@principal-ai/file-city-builder';
+export type LineCountData = Record<string, number>;
+export declare function enrichWithLineCounts(cityData: CityData, lineCounts: LineCountData): CityData;
+export declare function estimateLineCounts(cityData: CityData): CityData;
+//# sourceMappingURL=cityData.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cityData.d.ts","sourceRoot":"","sources":["../../../src/panels/utils/cityData.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAEhE,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEnD,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,QAAQ,EAClB,UAAU,EAAE,aAAa,GACxB,QAAQ,CAQV;AAUD,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,GAAG,QAAQ,CAoB/D"}

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

@@ -0,0 +1,119 @@
+/**
+ * Quality highlight layer generators for File City visualization
+ *
+ * Creates highlight layers from quality metrics data (coverage, linting, etc.)
+ */
+import type { CityBuilding, LayerItem, HighlightLayer } from '@principal-ai/file-city-react';
+import { type ColorMode as QualityColorMode, type LensColorMode, type ColorModeConfig, type FileMetricData, type QualitySliceData } from '@principal-ai/quality-lens-registry';
+export type { LensColorMode, ColorModeConfig, FileMetricData, QualitySliceData };
+export type { HighlightLayer, LayerItem };
+export type ColorMode = QualityColorMode | 'fileTypes' | 'git' | 'pr' | 'commit' | 'storyboard';
+/**
+ * Get all available color modes from the registry
+ */
+export declare function getAvailableColorModes(): ColorModeConfig[];
+/**
+ * Available color modes (derived from registry)
+ * @deprecated Use getAvailableColorModes() for dynamic list
+ */
+export declare const COLOR_MODES: ColorModeConfig[];
+/**
+ * Default color modes (always available without quality data)
+ */
+export declare const DEFAULT_COLOR_MODES: ColorModeConfig[];
+/**
+ * Quality-based color modes (require quality data)
+ */
+export declare const QUALITY_COLOR_MODES: ColorModeConfig[];
+/**
+ * File City color modes slice data structure.
+ * Hosts populate this slice to control which color modes are available.
+ * If not populated, only default modes (fileTypes, git) are available.
+ */
+export interface FileCityColorModesSliceData {
+    /** Additional color modes to enable (beyond fileTypes and git) */
+    enabledModes?: ColorMode[];
+    /** The currently selected color mode (set by PanelContext via events) */
+    selectedColorMode?: ColorMode | null;
+    /** Quality data for quality-based color modes */
+    qualityData?: QualitySliceData;
+}
+/**
+ * Convert a score (0-100) to a color on the red-yellow-green gradient
+ * Higher scores = greener (better)
+ */
+export declare function scoreToColor(score: number): string;
+/**
+ * Convert coverage percentage to color
+ * High coverage = green, low coverage = red
+ */
+export declare function coverageToColor(coverage: number): string;
+/**
+ * Convert issue count to color (inverse - fewer issues = greener)
+ * Uses a log scale for better distribution
+ */
+export declare function issueCountToColor(issueCount: number, maxIssues?: number): string;
+/**
+ * Color thresholds for gradient legend
+ */
+export declare const SCORE_THRESHOLDS: {
+    min: number;
+    max: number;
+    color: string;
+    label: string;
+}[];
+/**
+ * Create highlight layers for test coverage visualization
+ * Simple scheme: green = has coverage, red = no coverage, gray = not applicable
+ */
+export declare function createCoverageHighlightLayers(buildings: CityBuilding[], fileCoverage: Record<string, number>): HighlightLayer[];
+/**
+ * Create highlight layers for file metrics (ESLint, TypeScript, etc.)
+ * Uses issue-count-based categories for clarity
+ */
+export declare function createMetricHighlightLayers(buildings: CityBuilding[], metrics: FileMetricData[], metricId: string, _metricName: string): HighlightLayer[];
+/**
+ * Create ESLint highlight layers
+ * Uses a stricter color scheme: green only for clean files, orange-to-red for any issues
+ */
+export declare function createEslintHighlightLayers(buildings: CityBuilding[], eslintMetrics: FileMetricData[]): HighlightLayer[];
+/**
+ * Create Biome Lint highlight layers
+ * Uses a stricter color scheme: green only for clean files, orange-to-red for any issues
+ */
+export declare function createBiomeLintHighlightLayers(buildings: CityBuilding[], biomeLintMetrics: FileMetricData[]): HighlightLayer[];
+/**
+ * Create TypeScript highlight layers
+ * Uses a stricter color scheme: green only for clean files, orange-to-red for any issues
+ */
+export declare function createTypescriptHighlightLayers(buildings: CityBuilding[], typescriptMetrics: FileMetricData[]): HighlightLayer[];
+/**
+ * Create Prettier highlight layers
+ * Uses a stricter color scheme: green only for clean files, orange-to-red for any issues
+ */
+export declare function createPrettierHighlightLayers(buildings: CityBuilding[], prettierMetrics: FileMetricData[]): HighlightLayer[];
+/**
+ * Create Biome Format highlight layers
+ * Uses a stricter color scheme: green only for clean files, orange-to-red for any issues
+ */
+export declare function createBiomeFormatHighlightLayers(buildings: CityBuilding[], biomeFormatMetrics: FileMetricData[]): HighlightLayer[];
+/**
+ * Create Knip highlight layers
+ * Uses a stricter color scheme: green only for clean files, orange-to-red for any issues
+ */
+export declare function createKnipHighlightLayers(buildings: CityBuilding[], knipMetrics: FileMetricData[]): HighlightLayer[];
+/**
+ * Create Alexandria highlight layers
+ * Simple scheme: green = documented, red = needs docs, gray = not applicable
+ */
+export declare function createAlexandriaHighlightLayers(buildings: CityBuilding[], alexandriaMetrics: FileMetricData[]): HighlightLayer[];
+/**
+ * Check if quality data is available for a given color mode
+ */
+export declare function isColorModeAvailable(mode: ColorMode, qualityData: QualitySliceData | null | undefined, hasGitData: boolean): boolean;
+/**
+ * Get highlight layers for a given color mode.
+ * Uses specialized layer generators for known lenses, falls back to generic metric layers.
+ */
+export declare function getLayersForColorMode(mode: ColorMode, buildings: CityBuilding[], qualityData: QualitySliceData | null | undefined, fileColorLayers: HighlightLayer[], gitLayers: HighlightLayer[]): HighlightLayer[];
+//# sourceMappingURL=qualityLayers.d.ts.map

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

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

package/dist/tools/index.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Panel Tools
+ *
+ * UTCP-compatible tools for the File City panel extension.
+ * These tools can be invoked by AI agents and emit events that panels listen for.
+ *
+ * IMPORTANT: This file should NOT import any React components to ensure
+ * it can be imported server-side without pulling in React dependencies.
+ * Use the './tools' subpath export for server-safe imports.
+ */
+import type { PanelTool, PanelToolsMetadata } from '@principal-ade/utcp-panel-event';
+/**
+ * Tool: Focus Building
+ */
+export declare const focusBuildingTool: PanelTool;
+/**
+ * Tool: Select District
+ */
+export declare const selectDistrictTool: PanelTool;
+/**
+ * Tool: Reset View
+ */
+export declare const resetViewTool: PanelTool;
+/**
+ * All tools exported as an array.
+ */
+export declare const codeCityPanelTools: PanelTool[];
+/**
+ * Panel tools metadata for registration with PanelToolRegistry.
+ */
+export declare const codeCityPanelToolsMetadata: PanelToolsMetadata;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAErF;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,SA6B/B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,SA6BhC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,SAuB3B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,SAAS,EAIzC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,0BAA0B,EAAE,kBAKxC,CAAC"}

package/dist/tools.bundle.js

@@ -0,0 +1,103 @@
+// src/tools/index.ts
+var focusBuildingTool = {
+  name: "focus_building",
+  description: "Focuses the camera on a specific file (building) in the file city visualization",
+  inputs: {
+    type: "object",
+    properties: {
+      filePath: {
+        type: "string",
+        description: "Path to the file to focus on"
+      },
+      animate: {
+        type: "boolean",
+        description: "Whether to animate the camera transition"
+      }
+    },
+    required: ["filePath"]
+  },
+  outputs: {
+    type: "object",
+    properties: {
+      success: { type: "boolean" },
+      message: { type: "string" }
+    }
+  },
+  tags: ["navigation", "camera", "focus"],
+  tool_call_template: {
+    call_template_type: "panel_event",
+    event_type: "industry-theme.file-city-panel:focus-building"
+  }
+};
+var selectDistrictTool = {
+  name: "select_district",
+  description: "Selects and highlights a directory (district) in the file city visualization",
+  inputs: {
+    type: "object",
+    properties: {
+      directoryPath: {
+        type: "string",
+        description: "Path to the directory to select"
+      },
+      expandChildren: {
+        type: "boolean",
+        description: "Whether to expand and show child buildings"
+      }
+    },
+    required: ["directoryPath"]
+  },
+  outputs: {
+    type: "object",
+    properties: {
+      success: { type: "boolean" },
+      selectedDistrict: { type: "string" }
+    }
+  },
+  tags: ["selection", "district", "directory"],
+  tool_call_template: {
+    call_template_type: "panel_event",
+    event_type: "industry-theme.file-city-panel:select-district"
+  }
+};
+var resetViewTool = {
+  name: "reset_view",
+  description: "Resets the file city view to the default camera position",
+  inputs: {
+    type: "object",
+    properties: {
+      animate: {
+        type: "boolean",
+        description: "Whether to animate the camera reset"
+      }
+    }
+  },
+  outputs: {
+    type: "object",
+    properties: {
+      success: { type: "boolean" }
+    }
+  },
+  tags: ["navigation", "camera", "reset"],
+  tool_call_template: {
+    call_template_type: "panel_event",
+    event_type: "industry-theme.file-city-panel:reset-view"
+  }
+};
+var codeCityPanelTools = [
+  focusBuildingTool,
+  selectDistrictTool,
+  resetViewTool
+];
+var codeCityPanelToolsMetadata = {
+  id: "industry-theme.file-city-panel",
+  name: "File City Panel",
+  description: "Tools provided by the file city visualization panel extension",
+  tools: codeCityPanelTools
+};
+export {
+  selectDistrictTool,
+  resetViewTool,
+  focusBuildingTool,
+  codeCityPanelToolsMetadata,
+  codeCityPanelTools
+};

package/dist/types/FileCityExplorerPanel.d.ts

@@ -0,0 +1,132 @@
+/**
+ * FileCityExplorerPanel — actions, context, and slice data types.
+ *
+ * Mirrors the per-panel pattern already used by `CodeCityPanelContext` /
+ * `FeedCodeCityPanelContext`, but with two differences spelled out in
+ * `docs/FILE_CITY_EXPLORER_PORT.md`:
+ *
+ *   1. Actions are panel-private (`FileCityExplorerPanelActions`), not
+ *      added to the shared `PanelActions` umbrella. Mis-wiring surfaces at
+ *      compile time on this panel only.
+ *   2. Every action and every slice is required. Nullability lives on the
+ *      slice's data, not on the slice itself — the explorer reads
+ *      `context.scopeWorkspace.data?.scopes` rather than guarding both the
+ *      slice and its data. "Feature disabled" hosts wire the slice with
+ *      permanent `data: null`; the corresponding UI never mounts and the
+ *      paired action is unreachable.
+ */
+import type { PanelActions as CorePanelActions, PanelComponentProps as CorePanelComponentProps, DataSlice } from '@principal-ade/panel-framework-core';
+import type { FileTree, GitStatusWithFiles } from '@principal-ai/repository-abstraction';
+import type { ProjectArea } from '@principal-ai/principal-view-core';
+import type { ScopeWorkspace } from './Scope';
+import type { SequenceDiagramPayload, SequenceNote, SequenceNoteDraft } from './SequenceDiagram';
+import type { LineCountsSliceData } from './index';
+/**
+ * Latest-commit metadata. Replaces the electron-only `useLatestCommit` hook
+ * — the host fetches once and on `git:committed` events, exposes the result
+ * here.
+ */
+export interface LatestCommitFileEntry {
+    path: string;
+    status: 'A' | 'M' | 'D' | 'R' | 'C';
+}
+export interface LatestCommitSliceData {
+    sha: string;
+    subject: string;
+    author: string;
+    /** ISO 8601. */
+    authoredAt: string;
+    filesChanged: number;
+    additions: number;
+    deletions: number;
+    files: LatestCommitFileEntry[];
+}
+/**
+ * Area-workspace slice. Wraps `ProjectArea[]` so the slice signal is "no
+ * areas loaded yet" (`data: null`) vs. "loaded, possibly empty"
+ * (`data.areas = []`). `AuxiliaryManifest` from principal-view-core is the
+ * on-disk superset; this slim shape is what the panel actually reads.
+ */
+export interface AreaWorkspace {
+    areas: ProjectArea[];
+}
+/**
+ * Identifier for the repository the panel is currently looking at. All
+ * three fields are optional because hosts cover different cases:
+ *   - electron has an absolute filesystem `path`;
+ *   - web hosts have `owner`/`name` from GitHub but no local path;
+ *   - storybook may have neither.
+ */
+export interface FileCityExplorerRepository {
+    path?: string | null;
+    owner?: string | null;
+    name?: string | null;
+}
+export interface FileCityExplorerPanelContext {
+    /** Required, always-loaded — the panel cannot render without a tree. */
+    fileTree: DataSlice<FileTree>;
+    /** Working-tree changes. `data: null` means "host doesn't expose git
+     *  status" (web tour-only viewer) or "not loaded yet". */
+    gitStatusWithFiles: DataSlice<GitStatusWithFiles | null>;
+    /** Per-file line counts for building heights. */
+    lineCounts: DataSlice<LineCountsSliceData | null>;
+    /** Latest commit. Drives the floating `RecentCommitCard`. */
+    latestCommit: DataSlice<LatestCommitSliceData | null>;
+    /** Scopes workspace. `data: null` hides the Scopes tab and the
+     *  `addToScope` action becomes unreachable. */
+    scopeWorkspace: DataSlice<ScopeWorkspace | null>;
+    /** Areas workspace. Same gating story as scopes. */
+    areaWorkspace: DataSlice<AreaWorkspace | null>;
+    /** Active sequence-diagram payload. Drives the sequence overlays. */
+    sequenceDiagram: DataSlice<SequenceDiagramPayload | null>;
+    /** Repository identifier — not a slice. */
+    repository: FileCityExplorerRepository | null;
+}
+export interface AddToScopeActionInput {
+    scopeName: string;
+    /** Omit to add at scope level (no namespace). */
+    namespaceName?: string;
+    paths: string[];
+    description?: string;
+    /** Pre-picked color for new namespaces. Use `pickNamespaceColor()` from
+     *  the explorer's `layers.ts` to get a unique-in-workspace color. */
+    namespaceColor?: string;
+}
+export interface AddAreaActionInput {
+    name: string;
+    description?: string;
+    paths: string[];
+}
+export interface AddPathToAreaActionInput {
+    areaName: string;
+    path: string;
+}
+export interface FileCityExplorerPanelActions extends CorePanelActions {
+    /** Open a file in the host's active editor. */
+    openFile: (filePath: string, line?: number) => void;
+    /** Read a file's text content. Path may be absolute (electron) or
+     *  repo-relative (web) — host normalizes. */
+    readFile: (path: string) => Promise<string>;
+    /** Unified-diff text for a single commit. The host's closure binds
+     *  the repository identifier; the panel only knows the commit hash. */
+    getCommitDiff: (commitHash: string) => Promise<string>;
+    /** Unified-diff text for the current working tree. */
+    getWorkingTreeDiff: () => Promise<string>;
+    /** Mirror of `ScopeManager.addToScope` — single entry point, host
+     *  decides whether to create scope/namespace or extend existing.
+     *  Reachable only when `context.scopeWorkspace.data !== null`. */
+    addToScope: (input: AddToScopeActionInput) => Promise<void>;
+    /** Reachable only when `context.areaWorkspace.data !== null`. */
+    addArea: (input: AddAreaActionInput) => Promise<void>;
+    addPathToArea: (input: AddPathToAreaActionInput) => Promise<void>;
+    /** Persist a new note on the active payload. Returns the saved note
+     *  (host fills id + timestamps), or `null` if the host couldn't
+     *  persist (e.g. transient backend failure). */
+    createSequenceNote: (payloadId: string, draft: SequenceNoteDraft) => Promise<SequenceNote | null>;
+    /** Update a note's body. Returns the updated note. */
+    updateSequenceNote: (payloadId: string, noteId: string, body: string) => Promise<SequenceNote | null>;
+    /** Delete a note. */
+    deleteSequenceNote: (payloadId: string, noteId: string) => Promise<void>;
+}
+export type FileCityExplorerPanelPropsTyped = CorePanelComponentProps<FileCityExplorerPanelActions, FileCityExplorerPanelContext>;
+//# sourceMappingURL=FileCityExplorerPanel.d.ts.map

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

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