@principal-ai/file-city-react 0.5.38 → 0.5.40

package/dist/components/FileCity3D/FileCity3D.d.ts

@@ -63,6 +63,11 @@ export interface ElevatedScopePanel {
     label?: string;
     /** Hex color for the label (default white). */
     labelColor?: string;
+    /**
+     * Absolute label font size in world units. When omitted, falls back to a
+     * size derived from the panel's footprint. Always clamped to fit the tile.
+     */
+    labelSize?: number;
     /** Click handler. When set, the slab becomes interactive and shows a pointer cursor. */
     onClick?: () => void;
 }

package/dist/components/FileCity3D/FileCity3D.d.ts.map

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

package/dist/components/FileCity3D/FileCity3D.js

@@ -1692,8 +1692,11 @@ function CityScene({ cityData, onBuildingHover, onBuildingClick, hoveredBuilding
                     const topY = y + t / 2;
                     // Size text to the panel: roughly fit longest reasonable label,
                     // clamped so tiny tiles still render legibly and huge ones don't
-                    // get absurd.
-                    const labelSize = Math.max(4, Math.min(24, Math.min(w, d) / 6));
+                    // get absurd. Callers may override via panel.labelSize, but we
+                    // still cap to the tile footprint so the label fits.
+                    const tileMax = Math.min(w, d) / 2;
+                    const requested = panel.labelSize ?? Math.min(w, d) / 6;
+                    const labelSize = Math.max(4, Math.min(tileMax, requested));
                     const handleClick = panel.onClick
                         ? (e) => {
                             e.stopPropagation();
@@ -1711,7 +1714,7 @@ function CityScene({ cityData, onBuildingHover, onBuildingClick, hoveredBuilding
                             document.body.style.cursor = '';
                         }
                         : undefined;
-                    return (_jsxs("group", { children: [_jsxs("mesh", { position: [cx, y, cz], renderOrder: 10, onClick: handleClick, onPointerOver: handlePointerOver, onPointerOut: handlePointerOut, children: [_jsx("boxGeometry", { args: [w, t, d] }), _jsx("meshBasicMaterial", { color: panel.color, transparent: !isOpaque, opacity: opacity, depthWrite: isOpaque })] }), panel.label && (_jsxs(Text, { position: [cx, topY + 0.05, cz], rotation: [-Math.PI / 2, 0, 0], fontSize: labelSize, color: panel.labelColor ?? '#ffffff', anchorX: "center", anchorY: "middle", maxWidth: w * 0.9, textAlign: "center", renderOrder: 11, children: [panel.label, _jsx("meshBasicMaterial", { attach: "material", color: panel.labelColor ?? '#ffffff', depthWrite: false })] }))] }, panel.id));
+                    return (_jsxs("group", { children: [_jsxs("mesh", { position: [cx, y, cz], renderOrder: 10, onClick: handleClick, onPointerOver: handlePointerOver, onPointerOut: handlePointerOut, children: [_jsx("boxGeometry", { args: [w, t, d] }), _jsx("meshBasicMaterial", { color: panel.color, transparent: !isOpaque, opacity: opacity, depthWrite: isOpaque })] }), panel.label && (_jsxs(Text, { position: [cx, topY + 0.05, cz], rotation: [-Math.PI / 2, 0, 0], fontSize: labelSize, color: panel.labelColor ?? '#ffffff', anchorX: "center", anchorY: "middle", maxWidth: w * 0.9, textAlign: "center", renderOrder: 11, frustumCulled: false, children: [panel.label, _jsx("meshBasicMaterial", { attach: "material", color: panel.labelColor ?? '#ffffff', depthWrite: false, depthTest: false })] }))] }, panel.id));
                 })] }));
 }
 /**

package/dist/index.d.ts

@@ -16,6 +16,8 @@ export { ThemeProvider, useTheme } from '@principal-ade/industry-theme';
 export { FileCity3D, resetCamera, DEFAULT_FLAT_PATTERNS } from './components/FileCity3D';
 export type { FileCity3DProps, AnimationConfig, HighlightLayer as FileCity3DHighlightLayer, IsolationMode, HeightScaling, FlatPattern, ElevatedScopePanel, } from './components/FileCity3D';
 export type { HighlightLayer as FileCity3DHL } from './components/FileCity3D';
+export { buildFolderElevatedPanels, buildFolderIndex, hashFolderColor, } from './utils/folderElevatedPanels';
+export type { BuildFolderElevatedPanelsOptions } from './utils/folderElevatedPanels';
 export { resolveVisualizationIntent } from './utils/visualizationResolution';
 export type { VisualizationIntent, ResolvedVisualizationState, } from './utils/visualizationResolution';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,8BAA8B,EAC9B,KAAK,mCAAmC,GACzC,MAAM,6CAA6C,CAAC;AAGrD,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,SAAS,EACd,KAAK,cAAc,EACnB,UAAU,GACX,MAAM,sCAAsC,CAAC;AAG9C,OAAO,EAAE,KAAK,mBAAmB,EAAE,KAAK,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAGvF,OAAO,EACL,gCAAgC,EAChC,6BAA6B,EAC7B,oCAAoC,GACrC,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EACL,8BAA8B,EAC9B,yBAAyB,EACzB,mBAAmB,GACpB,MAAM,kCAAkC,CAAC;AAE1C,YAAY,EACV,gBAAgB,EAChB,gBAAgB,EAChB,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,kCAAkC,CAAC;AAG1C,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAGzF,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAG7F,YAAY,EACV,QAAQ,EACR,YAAY,EACZ,YAAY,EACZ,sBAAsB,EACtB,QAAQ,EACR,UAAU,GACX,MAAM,iCAAiC,CAAC;AAGzC,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAG1E,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,YAAY,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAG7F,YAAY,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAGhE,OAAO,EACL,qBAAqB,EACrB,KAAK,0BAA0B,GAChC,MAAM,oCAAoC,CAAC;AAG5C,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAGxE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AACzF,YAAY,EACV,eAAe,EACf,eAAe,EACf,cAAc,IAAI,wBAAwB,EAC1C,aAAa,EACb,aAAa,EACb,WAAW,EACX,kBAAkB,GACnB,MAAM,yBAAyB,CAAC;AAIjC,YAAY,EAAE,cAAc,IAAI,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAI9E,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAC7E,YAAY,EACV,mBAAmB,EACnB,0BAA0B,GAC3B,MAAM,iCAAiC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,8BAA8B,EAC9B,KAAK,mCAAmC,GACzC,MAAM,6CAA6C,CAAC;AAGrD,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,SAAS,EACd,KAAK,cAAc,EACnB,UAAU,GACX,MAAM,sCAAsC,CAAC;AAG9C,OAAO,EAAE,KAAK,mBAAmB,EAAE,KAAK,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAGvF,OAAO,EACL,gCAAgC,EAChC,6BAA6B,EAC7B,oCAAoC,GACrC,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EACL,8BAA8B,EAC9B,yBAAyB,EACzB,mBAAmB,GACpB,MAAM,kCAAkC,CAAC;AAE1C,YAAY,EACV,gBAAgB,EAChB,gBAAgB,EAChB,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,kCAAkC,CAAC;AAG1C,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAGzF,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAG7F,YAAY,EACV,QAAQ,EACR,YAAY,EACZ,YAAY,EACZ,sBAAsB,EACtB,QAAQ,EACR,UAAU,GACX,MAAM,iCAAiC,CAAC;AAGzC,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAG1E,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,YAAY,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAG7F,YAAY,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAGhE,OAAO,EACL,qBAAqB,EACrB,KAAK,0BAA0B,GAChC,MAAM,oCAAoC,CAAC;AAG5C,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAGxE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AACzF,YAAY,EACV,eAAe,EACf,eAAe,EACf,cAAc,IAAI,wBAAwB,EAC1C,aAAa,EACb,aAAa,EACb,WAAW,EACX,kBAAkB,GACnB,MAAM,yBAAyB,CAAC;AAIjC,YAAY,EAAE,cAAc,IAAI,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAG9E,OAAO,EACL,yBAAyB,EACzB,gBAAgB,EAChB,eAAe,GAChB,MAAM,8BAA8B,CAAC;AACtC,YAAY,EAAE,gCAAgC,EAAE,MAAM,8BAA8B,CAAC;AAIrF,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAC7E,YAAY,EACV,mBAAmB,EACnB,0BAA0B,GAC3B,MAAM,iCAAiC,CAAC"}

package/dist/index.js

@@ -20,6 +20,8 @@ export { CityViewWithReactFlow, } from './components/CityViewWithReactFlow';
 export { ThemeProvider, useTheme } from '@principal-ade/industry-theme';
 // 3D visualization component
 export { FileCity3D, resetCamera, DEFAULT_FLAT_PATTERNS } from './components/FileCity3D';
+// Folder-driven elevated panels (file-tree expansion → 3D umbrella tiles)
+export { buildFolderElevatedPanels, buildFolderIndex, hashFolderColor, } from './utils/folderElevatedPanels';
 // Visualization resolution utilities
 // See docs/VISUALIZATION_STATE_RESOLUTION.md for documentation
 export { resolveVisualizationIntent } from './utils/visualizationResolution';

package/dist/utils/folderElevatedPanels.d.ts

@@ -0,0 +1,60 @@
+import type { CityData } from '@principal-ai/file-city-builder';
+import type { ElevatedScopePanel } from '../components/FileCity3D';
+/**
+ * Stable color for a folder path, picked from a small palette via a string
+ * hash. Two folders at the same depth get visibly different colors; the
+ * same folder always gets the same color across renders.
+ */
+export declare function hashFolderColor(path: string): string;
+interface Bounds {
+    minX: number;
+    maxX: number;
+    minZ: number;
+    maxZ: number;
+}
+interface FolderIndex {
+    /** Parent directory → list of immediate child directories. Top-level folders live under '' (empty string). */
+    children: Map<string, string[]>;
+    /** Folder path → world bounds spanning every descendant district. */
+    bounds: Map<string, Bounds>;
+    /** Folder path → number of descendant files. */
+    fileCounts: Map<string, number>;
+}
+/**
+ * Precompute the data structures `buildFolderElevatedPanels` needs from a
+ * `CityData`. Cache this when the city data is stable to avoid redoing the
+ * O(districts × depth) walk on every render.
+ */
+export declare function buildFolderIndex(cityData: CityData): FolderIndex;
+export interface BuildFolderElevatedPanelsOptions {
+    cityData: CityData;
+    /**
+     * Set of folder paths that are currently expanded in the file tree. A folder
+     * not in this set is treated as collapsed.
+     */
+    expandedFolders: ReadonlySet<string>;
+    /** Toggle handler invoked when an umbrella tile is clicked. */
+    onToggleFolder?: (folderPath: string) => void;
+    /**
+     * Scale label font size by descendant file count. Default true. When false,
+     * the renderer's auto-sized label is used (size derived from tile footprint).
+     */
+    scaleLabelByFileCount?: boolean;
+    /**
+     * Pre-built index from `buildFolderIndex(cityData)`. Pass when you cache the
+     * city's index across renders to avoid recomputing it.
+     */
+    index?: FolderIndex;
+}
+/**
+ * Walks the folder hierarchy from the top-level folders of a `CityData`. For
+ * each folder:
+ *   - if expanded → recurse into child folders
+ *   - if collapsed → emit one elevated panel covering the union of every
+ *     descendant district's world bounds, colored via `hashFolderColor`.
+ *
+ * Mirror of the scope-tree expansion behavior, applied to file-tree folders.
+ */
+export declare function buildFolderElevatedPanels(options: BuildFolderElevatedPanelsOptions): ElevatedScopePanel[];
+export {};
+//# sourceMappingURL=folderElevatedPanels.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"folderElevatedPanels.d.ts","sourceRoot":"","sources":["../../src/utils/folderElevatedPanels.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAenE;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMpD;AAED,UAAU,MAAM;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,UAAU,WAAW;IACnB,8GAA8G;IAC9G,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAChC,qEAAqE;IACrE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,gDAAgD;IAChD,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,GAAG,WAAW,CA+ChE;AAED,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,EAAE,QAAQ,CAAC;IACnB;;;OAGG;IACH,eAAe,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACrC,+DAA+D;IAC/D,cAAc,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9C;;;OAGG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC;;;OAGG;IACH,KAAK,CAAC,EAAE,WAAW,CAAC;CACrB;AAED;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,gCAAgC,GACxC,kBAAkB,EAAE,CAsCtB"}

package/dist/utils/folderElevatedPanels.js

@@ -0,0 +1,127 @@
+const FOLDER_PALETTE = [
+    '#3b82f6',
+    '#22c55e',
+    '#f59e0b',
+    '#ec4899',
+    '#8b5cf6',
+    '#06b6d4',
+    '#ef4444',
+    '#14b8a6',
+    '#a855f7',
+    '#eab308',
+];
+/**
+ * Stable color for a folder path, picked from a small palette via a string
+ * hash. Two folders at the same depth get visibly different colors; the
+ * same folder always gets the same color across renders.
+ */
+export function hashFolderColor(path) {
+    let h = 0;
+    for (let i = 0; i < path.length; i++) {
+        h = (h * 31 + path.charCodeAt(i)) | 0;
+    }
+    return FOLDER_PALETTE[Math.abs(h) % FOLDER_PALETTE.length];
+}
+/**
+ * Precompute the data structures `buildFolderElevatedPanels` needs from a
+ * `CityData`. Cache this when the city data is stable to avoid redoing the
+ * O(districts × depth) walk on every render.
+ */
+export function buildFolderIndex(cityData) {
+    const children = new Map();
+    const directorySet = new Set();
+    for (const d of cityData.districts)
+        directorySet.add(d.path);
+    const dirs = Array.from(directorySet).sort();
+    for (const dir of dirs) {
+        const slash = dir.lastIndexOf('/');
+        const parent = slash >= 0 ? dir.slice(0, slash) : '';
+        const arr = children.get(parent);
+        if (arr)
+            arr.push(dir);
+        else
+            children.set(parent, [dir]);
+    }
+    const bounds = new Map();
+    for (const district of cityData.districts) {
+        const b = district.worldBounds;
+        let path = district.path;
+        while (path) {
+            const cur = bounds.get(path);
+            if (!cur) {
+                bounds.set(path, { minX: b.minX, maxX: b.maxX, minZ: b.minZ, maxZ: b.maxZ });
+            }
+            else {
+                if (b.minX < cur.minX)
+                    cur.minX = b.minX;
+                if (b.maxX > cur.maxX)
+                    cur.maxX = b.maxX;
+                if (b.minZ < cur.minZ)
+                    cur.minZ = b.minZ;
+                if (b.maxZ > cur.maxZ)
+                    cur.maxZ = b.maxZ;
+            }
+            const slash = path.lastIndexOf('/');
+            if (slash < 0)
+                break;
+            path = path.slice(0, slash);
+        }
+    }
+    const fileCounts = new Map();
+    for (const b of cityData.buildings) {
+        let path = b.path;
+        const slash = path.lastIndexOf('/');
+        path = slash >= 0 ? path.slice(0, slash) : '';
+        while (path) {
+            fileCounts.set(path, (fileCounts.get(path) ?? 0) + 1);
+            const s = path.lastIndexOf('/');
+            if (s < 0)
+                break;
+            path = path.slice(0, s);
+        }
+    }
+    return { children, bounds, fileCounts };
+}
+/**
+ * Walks the folder hierarchy from the top-level folders of a `CityData`. For
+ * each folder:
+ *   - if expanded → recurse into child folders
+ *   - if collapsed → emit one elevated panel covering the union of every
+ *     descendant district's world bounds, colored via `hashFolderColor`.
+ *
+ * Mirror of the scope-tree expansion behavior, applied to file-tree folders.
+ */
+export function buildFolderElevatedPanels(options) {
+    const { cityData, expandedFolders, onToggleFolder, scaleLabelByFileCount = true, } = options;
+    const index = options.index ?? buildFolderIndex(cityData);
+    const panels = [];
+    const walk = (folderPath) => {
+        if (expandedFolders.has(folderPath)) {
+            const kids = index.children.get(folderPath) ?? [];
+            for (const child of kids)
+                walk(child);
+            return;
+        }
+        const bounds = index.bounds.get(folderPath);
+        if (!bounds)
+            return;
+        const label = folderPath.split('/').pop() ?? folderPath;
+        const fileCount = index.fileCounts.get(folderPath) ?? 0;
+        const labelSize = scaleLabelByFileCount
+            ? Math.max(12, Math.min(240, 8 + Math.sqrt(fileCount) * 5))
+            : undefined;
+        panels.push({
+            id: `folder::${folderPath}`,
+            color: hashFolderColor(folderPath),
+            height: 4,
+            thickness: 2,
+            bounds,
+            label,
+            labelSize,
+            onClick: onToggleFolder ? () => onToggleFolder(folderPath) : undefined,
+        });
+    };
+    for (const top of index.children.get('') ?? [])
+        walk(top);
+    return panels;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@principal-ai/file-city-react",
-  "version": "0.5.38",
+  "version": "0.5.40",
   "type": "module",
   "description": "React components for File City visualization",
   "main": "dist/index.js",

package/src/components/FileCity3D/FileCity3D.tsx

@@ -88,6 +88,11 @@ export interface ElevatedScopePanel {
   label?: string;
   /** Hex color for the label (default white). */
   labelColor?: string;
+  /**
+   * Absolute label font size in world units. When omitted, falls back to a
+   * size derived from the panel's footprint. Always clamped to fit the tile.
+   */
+  labelSize?: number;
   /** Click handler. When set, the slab becomes interactive and shows a pointer cursor. */
   onClick?: () => void;
 }
@@ -2666,8 +2671,11 @@ function CityScene({
           const topY = y + t / 2;
           // Size text to the panel: roughly fit longest reasonable label,
           // clamped so tiny tiles still render legibly and huge ones don't
-          // get absurd.
-          const labelSize = Math.max(4, Math.min(24, Math.min(w, d) / 6));
+          // get absurd. Callers may override via panel.labelSize, but we
+          // still cap to the tile footprint so the label fits.
+          const tileMax = Math.min(w, d) / 2;
+          const requested = panel.labelSize ?? Math.min(w, d) / 6;
+          const labelSize = Math.max(4, Math.min(tileMax, requested));
 
           const handleClick = panel.onClick
             ? (e: ThreeEvent<MouseEvent>) => {
@@ -2715,12 +2723,14 @@ function CityScene({
                   maxWidth={w * 0.9}
                   textAlign="center"
                   renderOrder={11}
+                  frustumCulled={false}
                 >
                   {panel.label}
                   <meshBasicMaterial
                     attach="material"
                     color={panel.labelColor ?? '#ffffff'}
                     depthWrite={false}
+                    depthTest={false}
                   />
                 </Text>
               )}

package/src/index.ts

@@ -87,6 +87,14 @@ export type {
 // with the 2D HighlightLayer from drawLayeredBuildings
 export type { HighlightLayer as FileCity3DHL } from './components/FileCity3D';
 
+// Folder-driven elevated panels (file-tree expansion → 3D umbrella tiles)
+export {
+  buildFolderElevatedPanels,
+  buildFolderIndex,
+  hashFolderColor,
+} from './utils/folderElevatedPanels';
+export type { BuildFolderElevatedPanelsOptions } from './utils/folderElevatedPanels';
+
 // Visualization resolution utilities
 // See docs/VISUALIZATION_STATE_RESOLUTION.md for documentation
 export { resolveVisualizationIntent } from './utils/visualizationResolution';

package/src/stories/ScopeOverlay.stories.tsx

@@ -14,6 +14,7 @@ import {
   type HighlightLayer,
 } from '../components/FileCity3D';
 import { createFileColorHighlightLayers } from '../utils/fileColorHighlightLayers';
+import { buildFolderElevatedPanels, buildFolderIndex } from '../utils/folderElevatedPanels';
 
 import electronAppCityData from '../../../../assets/electron-app-city-data.json';
 
@@ -116,6 +117,13 @@ const ELECTRON_DISTRICTS_BY_PATH: Map<string, CityDistrict> = new Map(
   (electronAppCityData as CityData).districts.map(d => [d.path, d]),
 );
 
+/**
+ * Pre-built folder index (children, bounds, file counts) for the static
+ * electron-app city. Cached once at module load so the story doesn't
+ * recompute on every render.
+ */
+const ELECTRON_FOLDER_INDEX = buildFolderIndex(electronAppCityData as CityData);
+
 // ---------------------------------------------------------------------------
 // Scope tree paths
 // ---------------------------------------------------------------------------
@@ -1079,6 +1087,42 @@ const SingleScopeTemplate: React.FC = () => {
     return panels.length > 0 ? panels : undefined;
   }, [activeTab, scopes, scopeTreeModel, treeExpansion]);
 
+  // Track which folders are expanded in the file tree. The file-tree tab's
+  // elevated panels mirror this: a collapsed folder shows one umbrella tile
+  // covering every descendant district; expanding the folder reveals its
+  // sub-folder tiles (or the buildings themselves at the leaves).
+  const folderTreeExpansion = useFileTreeSelector(
+    treeModel,
+    React.useCallback((model: FileTree) => {
+      const expanded = new Set<string>();
+      for (const dir of ELECTRON_DIRECTORIES) {
+        const item = model.getItem(dir);
+        if (item?.isDirectory() && item.isExpanded()) expanded.add(dir);
+      }
+      return { expanded };
+    }, []),
+    React.useCallback((prev, next) => {
+      if (prev.expanded.size !== next.expanded.size) return false;
+      for (const k of prev.expanded) if (!next.expanded.has(k)) return false;
+      return true;
+    }, []),
+  );
+
+  // Elevated folder panels — driven by the file tree's expansion state.
+  const folderElevatedPanels = React.useMemo<ElevatedScopePanel[] | undefined>(() => {
+    if (activeTab !== 'files') return undefined;
+    const panels = buildFolderElevatedPanels({
+      cityData: electronAppCityData as CityData,
+      expandedFolders: folderTreeExpansion.expanded,
+      onToggleFolder: (folderPath) => {
+        const item = treeModel.getItem(folderPath);
+        if (item?.isDirectory()) item.toggle();
+      },
+      index: ELECTRON_FOLDER_INDEX,
+    });
+    return panels.length > 0 ? panels : undefined;
+  }, [activeTab, treeModel, folderTreeExpansion]);
+
   const openAddModal = React.useCallback((prefillScopeId?: string) => {
     setModalScopeId(prefillScopeId ?? '');
     setModalNamespaceName('');
@@ -1484,7 +1528,7 @@ const SingleScopeTemplate: React.FC = () => {
           linearScale={0.5}
           focusDirectory={focusDirectory}
           highlightLayers={cityHighlightLayers}
-          elevatedScopePanels={cityElevatedPanels}
+          elevatedScopePanels={cityElevatedPanels ?? folderElevatedPanels}
           animation={{
             startFlat: true,
             autoStartDelay: null,
@@ -1495,6 +1539,37 @@ const SingleScopeTemplate: React.FC = () => {
           showControls={true}
         />
 
+        {/* Debug overlay — current focusDirectory */}
+        <div
+          style={{
+            position: 'absolute',
+            top: 16,
+            left: 16,
+            padding: '8px 12px',
+            background: 'rgba(15, 23, 42, 0.92)',
+            border: '1px solid #334155',
+            borderRadius: 6,
+            color: '#e2e8f0',
+            fontFamily: 'system-ui, sans-serif',
+            fontSize: 12,
+            zIndex: 100,
+            maxWidth: 480,
+          }}
+        >
+          <div style={sectionLabelStyle}>focusDirectory</div>
+          <div
+            style={{
+              marginTop: 4,
+              fontFamily: 'monospace',
+              fontSize: 12,
+              color: focusDirectory ? '#fde68a' : '#64748b',
+              wordBreak: 'break-all',
+            }}
+          >
+            {focusDirectory ?? '(null)'}
+          </div>
+        </div>
+
         {/* Info overlay — driven by scope tree selection */}
       {scopeInfo && <ScopeInfoOverlay info={scopeInfo} />}
       </div>

package/src/utils/folderElevatedPanels.ts

@@ -0,0 +1,170 @@
+import type { CityData } from '@principal-ai/file-city-builder';
+import type { ElevatedScopePanel } from '../components/FileCity3D';
+
+const FOLDER_PALETTE = [
+  '#3b82f6',
+  '#22c55e',
+  '#f59e0b',
+  '#ec4899',
+  '#8b5cf6',
+  '#06b6d4',
+  '#ef4444',
+  '#14b8a6',
+  '#a855f7',
+  '#eab308',
+];
+
+/**
+ * Stable color for a folder path, picked from a small palette via a string
+ * hash. Two folders at the same depth get visibly different colors; the
+ * same folder always gets the same color across renders.
+ */
+export function hashFolderColor(path: string): string {
+  let h = 0;
+  for (let i = 0; i < path.length; i++) {
+    h = (h * 31 + path.charCodeAt(i)) | 0;
+  }
+  return FOLDER_PALETTE[Math.abs(h) % FOLDER_PALETTE.length];
+}
+
+interface Bounds {
+  minX: number;
+  maxX: number;
+  minZ: number;
+  maxZ: number;
+}
+
+interface FolderIndex {
+  /** Parent directory → list of immediate child directories. Top-level folders live under '' (empty string). */
+  children: Map<string, string[]>;
+  /** Folder path → world bounds spanning every descendant district. */
+  bounds: Map<string, Bounds>;
+  /** Folder path → number of descendant files. */
+  fileCounts: Map<string, number>;
+}
+
+/**
+ * Precompute the data structures `buildFolderElevatedPanels` needs from a
+ * `CityData`. Cache this when the city data is stable to avoid redoing the
+ * O(districts × depth) walk on every render.
+ */
+export function buildFolderIndex(cityData: CityData): FolderIndex {
+  const children = new Map<string, string[]>();
+  const directorySet = new Set<string>();
+  for (const d of cityData.districts) directorySet.add(d.path);
+  const dirs = Array.from(directorySet).sort();
+  for (const dir of dirs) {
+    const slash = dir.lastIndexOf('/');
+    const parent = slash >= 0 ? dir.slice(0, slash) : '';
+    const arr = children.get(parent);
+    if (arr) arr.push(dir);
+    else children.set(parent, [dir]);
+  }
+
+  const bounds = new Map<string, Bounds>();
+  for (const district of cityData.districts) {
+    const b = district.worldBounds;
+    let path = district.path;
+    while (path) {
+      const cur = bounds.get(path);
+      if (!cur) {
+        bounds.set(path, { minX: b.minX, maxX: b.maxX, minZ: b.minZ, maxZ: b.maxZ });
+      } else {
+        if (b.minX < cur.minX) cur.minX = b.minX;
+        if (b.maxX > cur.maxX) cur.maxX = b.maxX;
+        if (b.minZ < cur.minZ) cur.minZ = b.minZ;
+        if (b.maxZ > cur.maxZ) cur.maxZ = b.maxZ;
+      }
+      const slash = path.lastIndexOf('/');
+      if (slash < 0) break;
+      path = path.slice(0, slash);
+    }
+  }
+
+  const fileCounts = new Map<string, number>();
+  for (const b of cityData.buildings) {
+    let path = b.path;
+    const slash = path.lastIndexOf('/');
+    path = slash >= 0 ? path.slice(0, slash) : '';
+    while (path) {
+      fileCounts.set(path, (fileCounts.get(path) ?? 0) + 1);
+      const s = path.lastIndexOf('/');
+      if (s < 0) break;
+      path = path.slice(0, s);
+    }
+  }
+
+  return { children, bounds, fileCounts };
+}
+
+export interface BuildFolderElevatedPanelsOptions {
+  cityData: CityData;
+  /**
+   * Set of folder paths that are currently expanded in the file tree. A folder
+   * not in this set is treated as collapsed.
+   */
+  expandedFolders: ReadonlySet<string>;
+  /** Toggle handler invoked when an umbrella tile is clicked. */
+  onToggleFolder?: (folderPath: string) => void;
+  /**
+   * Scale label font size by descendant file count. Default true. When false,
+   * the renderer's auto-sized label is used (size derived from tile footprint).
+   */
+  scaleLabelByFileCount?: boolean;
+  /**
+   * Pre-built index from `buildFolderIndex(cityData)`. Pass when you cache the
+   * city's index across renders to avoid recomputing it.
+   */
+  index?: FolderIndex;
+}
+
+/**
+ * Walks the folder hierarchy from the top-level folders of a `CityData`. For
+ * each folder:
+ *   - if expanded → recurse into child folders
+ *   - if collapsed → emit one elevated panel covering the union of every
+ *     descendant district's world bounds, colored via `hashFolderColor`.
+ *
+ * Mirror of the scope-tree expansion behavior, applied to file-tree folders.
+ */
+export function buildFolderElevatedPanels(
+  options: BuildFolderElevatedPanelsOptions,
+): ElevatedScopePanel[] {
+  const {
+    cityData,
+    expandedFolders,
+    onToggleFolder,
+    scaleLabelByFileCount = true,
+  } = options;
+  const index = options.index ?? buildFolderIndex(cityData);
+
+  const panels: ElevatedScopePanel[] = [];
+
+  const walk = (folderPath: string): void => {
+    if (expandedFolders.has(folderPath)) {
+      const kids = index.children.get(folderPath) ?? [];
+      for (const child of kids) walk(child);
+      return;
+    }
+    const bounds = index.bounds.get(folderPath);
+    if (!bounds) return;
+    const label = folderPath.split('/').pop() ?? folderPath;
+    const fileCount = index.fileCounts.get(folderPath) ?? 0;
+    const labelSize = scaleLabelByFileCount
+      ? Math.max(12, Math.min(240, 8 + Math.sqrt(fileCount) * 5))
+      : undefined;
+    panels.push({
+      id: `folder::${folderPath}`,
+      color: hashFolderColor(folderPath),
+      height: 4,
+      thickness: 2,
+      bounds,
+      label,
+      labelSize,
+      onClick: onToggleFolder ? () => onToggleFolder(folderPath) : undefined,
+    });
+  };
+
+  for (const top of index.children.get('') ?? []) walk(top);
+  return panels;
+}