codeviz 0.1.0 → 0.1.2

package/README.md

@@ -1 +1,446 @@
-# codeviz
+# CodeViz
+
+**Interactive 2D codebase visualization with hierarchical semantic zoom**
+
+[![npm version](https://img.shields.io/npm/v/codeviz.svg)](https://www.npmjs.com/package/codeviz)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.3+-blue.svg)](https://www.typescriptlang.org/)
+
+CodeViz is a React component library for visualizing codebases as interactive 2D maps. It provides developers with an intuitive, map-like interface for understanding code structure, dependencies, and relationships at multiple levels of abstraction.
+
+## Features
+
+- **Hierarchical Visualization** - Directories as nested containment regions (scopes)
+- **Semantic Zoom** - 5 discrete zoom levels showing different information density
+- **Multi-Language Support** - TypeScript, JavaScript, Python via tree-sitter parsing
+- **Dependency Visualization** - Import and call graph relationships as edges
+- **Overlay System** - Cursors, badges, annotations for collaboration
+- **Theme Support** - Light and dark themes with full customization
+- **Dual Renderers** - React Flow (default) or Sigma.js (WebGL) for large graphs
+- **High Performance** - Supports codebases up to 10,000+ files with Sigma renderer
+
+## Quick Start
+
+```bash
+npm install codeviz
+```
+
+```tsx
+import { CodeMapComponent, useLayout, analyzeCodebase } from 'codeviz';
+
+function App() {
+  const [codeGraph, setCodeGraph] = useState(null);
+
+  useEffect(() => {
+    analyzeCodebase('./src').then(result => {
+      setCodeGraph(result.codeGraph);
+    });
+  }, []);
+
+  const { codeMap, isComputing } = useLayout(codeGraph);
+
+  if (isComputing || !codeMap) {
+    return <div>Loading...</div>;
+  }
+
+  return (
+    <CodeMapComponent
+      codeMap={codeMap}
+      theme="dark"
+      onNodeClick={(node) => console.log('Clicked:', node)}
+    />
+  );
+}
+```
+
+## Installation
+
+```bash
+# npm
+npm install codeviz
+
+# yarn
+yarn add codeviz
+
+# pnpm
+pnpm add codeviz
+```
+
+### Peer Dependencies
+
+CodeViz requires React 18+:
+
+```bash
+npm install react react-dom
+```
+
+## Usage
+
+### Analyzing a Codebase
+
+Use `analyzeCodebase` to scan and parse source files:
+
+```tsx
+import { analyzeCodebase } from 'codeviz';
+
+const result = await analyzeCodebase('./src', {
+  extensions: ['.ts', '.tsx', '.js', '.jsx'],
+  ignorePatterns: ['node_modules', 'dist', '*.test.ts'],
+  maxDepth: 10,
+});
+
+// result.codeGraph contains:
+// - files: FileNode[]
+// - directories: DirectoryNode[]
+// - symbols: SymbolNode[]
+// - imports: ImportEdge[]
+// - calls: CallEdge[]
+```
+
+### Computing Layout
+
+Transform a `CodeGraph` into positioned `CodeMap`:
+
+```tsx
+import { useLayout, computeLayout } from 'codeviz';
+
+// React hook (recommended)
+const { codeMap, isComputing, error } = useLayout(codeGraph, {
+  algorithm: 'force-directed',
+  clusteringEnabled: true,
+});
+
+// Or imperative API
+const codeMap = await computeLayout(codeGraph, layoutConfig);
+```
+
+### Rendering the Map
+
+```tsx
+import { CodeMapComponent } from 'codeviz';
+
+<CodeMapComponent
+  codeMap={codeMap}
+  theme="dark"
+
+  // Interaction callbacks
+  onNodeClick={(node) => handleNodeClick(node)}
+  onNodeHover={(node) => handleNodeHover(node)}
+  onScopeToggle={(scopeId, expanded) => handleScopeToggle(scopeId, expanded)}
+  onViewportChange={(viewport) => handleViewportChange(viewport)}
+  onZoomLevelChange={(level) => handleZoomLevelChange(level)}
+
+  // Selection (controlled)
+  selectedNodes={['file-1', 'file-2']}
+  onSelectionChange={(nodeIds) => setSelectedNodes(nodeIds)}
+/>
+```
+
+### Using Overlays
+
+Add cursors, badges, and annotations:
+
+```tsx
+import { useOverlayPort, CodeMapComponent } from 'codeviz';
+
+function CollaborativeMap({ codeMap }) {
+  const { port, overlays } = useOverlayPort();
+
+  // Add a cursor overlay
+  const cursorId = port.bind({
+    type: 'cursor',
+    position: { type: 'absolute', x: 100, y: 200 },
+    color: '#6366f1',
+    label: 'Alice',
+  });
+
+  // Add a badge to a node
+  port.bind({
+    type: 'badge',
+    position: { type: 'node', nodeId: 'file-1', anchor: 'top-right' },
+    variant: 'count',
+    value: 3,
+  });
+
+  // Update cursor position
+  port.update(cursorId, {
+    position: { type: 'absolute', x: 150, y: 250 },
+  });
+
+  return (
+    <CodeMapComponent
+      codeMap={codeMap}
+      overlayPort={port}
+      onOverlayClick={(id, overlay) => console.log('Overlay clicked:', id)}
+    />
+  );
+}
+```
+
+## Sigma Renderer (WebGL)
+
+For large codebases (1,000+ files), use the Sigma.js renderer for better performance:
+
+```tsx
+import { CodeMap } from 'codeviz';
+
+<CodeMap
+  codeMap={codeMap}
+  codeGraph={codeGraph}  // Required for nexus view
+  renderer="sigma"       // Use WebGL renderer
+  view="structure"       // "structure" or "nexus"
+  theme="dark"
+  onNodeClick={(nodeId, node) => console.log('Clicked:', nodeId)}
+/>
+```
+
+### View Modes
+
+| Mode | Description | Data Source | Best For |
+|------|-------------|-------------|----------|
+| `structure` | File system hierarchy with scopes | `CodeMap` | Understanding project organization |
+| `nexus` | Flat relationship graph | `CodeGraph` | Exploring dependencies and imports |
+
+### When to Use Sigma vs React Flow
+
+| Scenario | Recommended Renderer |
+|----------|---------------------|
+| < 500 nodes | React Flow (richer interactions) |
+| 500 - 2,000 nodes | Either (test both) |
+| 2,000+ nodes | Sigma (WebGL performance) |
+| Need nested scopes | React Flow |
+| Need force-directed layout | Sigma |
+
+### Sigma-Specific Features
+
+```tsx
+import { SigmaRenderer } from 'codeviz';
+
+// Direct Sigma renderer access (advanced)
+<SigmaRenderer
+  graph={graphologyGraph}
+  view="nexus"
+  theme={darkTheme}
+
+  // Selection
+  selectedNodeId={selectedNode}
+  onSelectedNodeChange={setSelectedNode}
+
+  // Highlights (e.g., from AI/search)
+  highlightedNodeIds={['file-1', 'file-2']}
+
+  // Controls
+  showControls={true}
+  controlsPosition="bottom-right"
+
+  // Overlays work with Sigma too
+  overlays={overlays}
+  onOverlayClick={handleOverlayClick}
+/>
+```
+
+### Imperative API
+
+```tsx
+import { useRef } from 'react';
+import { SigmaRenderer, SigmaRendererHandle } from 'codeviz';
+
+function MyComponent() {
+  const sigmaRef = useRef<SigmaRendererHandle>(null);
+
+  const handleFocus = () => {
+    sigmaRef.current?.focusNode('file-1');
+  };
+
+  const handleFitAll = () => {
+    sigmaRef.current?.fitToNodes(['file-1', 'file-2', 'file-3']);
+  };
+
+  return (
+    <>
+      <SigmaRenderer ref={sigmaRef} ... />
+      <button onClick={handleFocus}>Focus Node</button>
+      <button onClick={() => sigmaRef.current?.zoomIn()}>Zoom In</button>
+      <button onClick={() => sigmaRef.current?.resetView()}>Reset</button>
+    </>
+  );
+}
+```
+
+## Zoom Levels
+
+CodeViz uses 5 semantic zoom levels:
+
+| Level | Name | Zoom Range | Content |
+|-------|------|------------|---------|
+| 0 | Overview | 0 - 0.25 | Top directories only, aggregated edges |
+| 1 | Modules | 0.25 - 0.5 | Subdirectories + large files (>200 LOC) |
+| 2 | Files | 0.5 - 1.0 | All files + exported symbols |
+| 3 | Symbols | 1.0 - 2.0 | All symbols + call graph edges |
+| 4 | Code | 2.0+ | Code preview panels, all details |
+
+## Configuration
+
+### Layout Configuration
+
+```tsx
+import { computeLayout, DEFAULT_LAYOUT_CONFIG } from 'codeviz';
+
+const layoutConfig = {
+  ...DEFAULT_LAYOUT_CONFIG,
+
+  // Clustering
+  clusteringEnabled: true,
+  clusteringResolution: 1.0,
+
+  // Force-directed layout
+  forceIterations: 100,
+  forceGravity: 0.1,
+  forceRepulsion: 1.0,
+
+  // Sizing
+  nodeSizeBase: 40,
+  nodeSizeScale: 1.5,
+  scopePadding: { top: 40, right: 20, bottom: 20, left: 20 },
+};
+
+const codeMap = await computeLayout(codeGraph, layoutConfig);
+```
+
+### Theme Customization
+
+```tsx
+import { CodeMapComponent, darkTheme, mergeTheme } from 'codeviz';
+
+const customTheme = mergeTheme(darkTheme, {
+  colors: {
+    nodes: {
+      file: { background: '#1e293b', border: '#334155' },
+    },
+    scopes: {
+      depth0: '#0f172a',
+      depth1: '#1e293b',
+      depth2: '#334155',
+    },
+  },
+});
+
+<CodeMapComponent codeMap={codeMap} theme={customTheme} />
+```
+
+## API Overview
+
+### Components
+
+| Component | Description |
+|-----------|-------------|
+| `CodeMapComponent` | Main visualization component (React Flow renderer) |
+| `CodeMap` | Unified component supporting both renderers |
+| `SigmaRenderer` | WebGL-based Sigma.js renderer |
+| `ThemeProvider` | Theme context provider |
+| `OverlayLayer` | Overlay rendering layer |
+| `GraphControls` | Zoom/pan controls for Sigma renderer |
+
+### Hooks
+
+| Hook | Description |
+|------|-------------|
+| `useLayout` | Compute layout from CodeGraph |
+| `useOverlayPort` | Manage overlay state |
+| `useTheme` | Access current theme |
+
+### Core Functions
+
+| Function | Description |
+|----------|-------------|
+| `analyzeCodebase` | Scan and parse source files |
+| `computeLayout` | Transform CodeGraph to CodeMap |
+| `createOverlayPort` | Create imperative overlay controller |
+
+### Types
+
+```tsx
+import type {
+  // Input types
+  CodeGraph,
+  FileNode,
+  DirectoryNode,
+  SymbolNode,
+
+  // Output types
+  CodeMap,
+  MapNode,
+  MapScope,
+  MapEdge,
+
+  // Configuration
+  LayoutConfig,
+  ZoomLevelConfig,
+  Theme,
+
+  // Overlays
+  Overlay,
+  CursorOverlay,
+  BadgeOverlay,
+  AnnotationOverlay,
+} from 'codeviz';
+```
+
+## Storybook
+
+Explore components interactively:
+
+```bash
+npm run storybook
+```
+
+Visit http://localhost:6006 to see:
+- CodeMap with sample data
+- Theme comparisons (light/dark)
+- Overlay demonstrations
+- Hook integration examples
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Run tests
+npm test
+
+# Run tests once
+npm run test:run
+
+# Type checking
+npm run typecheck
+
+# Build library
+npm run build
+
+# Start Storybook
+npm run storybook
+```
+
+## Contributing
+
+1. Fork the repository
+2. Create your feature branch (`git checkout -b feature/amazing-feature`)
+3. Run tests (`npm test`)
+4. Commit your changes (`git commit -m 'Add amazing feature'`)
+5. Push to the branch (`git push origin feature/amazing-feature`)
+6. Open a Pull Request
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details.
+
+## Acknowledgments
+
+Built with:
+- [React Flow](https://reactflow.dev/) - React library for node-based UIs
+- [Sigma.js](https://www.sigmajs.org/) - WebGL graph visualization
+- [tree-sitter](https://tree-sitter.github.io/) - Incremental parsing system
+- [graphology](https://graphology.github.io/) - Graph data structure
+- [ELK](https://www.eclipse.org/elk/) - Eclipse Layout Kernel
+- [Lucide](https://lucide.dev/) - Icon library

package/dist/browser.d.mts

@@ -0,0 +1,19 @@
+export { cl as AbsolutePosition, cL as AgentStatus, cw as AgentWidgetOverlay, cE as AgentWidgetOverlayInput, bM as AggregateNodeComponent, A as AggregateNodeData, c6 as AggregateReactFlowNodeData, ck as AnchorPoint, s as AnimationConfig, cI as AnnotationContentType, cu as AnnotationOverlay, cC as AnnotationOverlayInput, ct as BadgeOverlay, cB as BadgeOverlayInput, cH as BadgeSize, cG as BadgeVariant, cq as BaseOverlay, B as BoundingBox, bQ as BundledEdgeComponent, cb as BundledEdgeData, cS as CalculatedPosition, C as CallEdge, bP as CallEdgeComponent, ca as CallEdgeData, aU as ClusteringOptions, aV as ClusteringResult, i as CodeGraph, p as CodeMap, bD as CodeMapComponent, t as CodeMapConfig, b$ as CodeMapProps, h as CodebaseMetadata, ag as ColorPalette, b3 as ComputeLayoutOptions, cr as CursorOverlay, cz as CursorOverlayInput, w as DEFAULT_ANIMATION_CONFIG, x as DEFAULT_CODEMAP_CONFIG, v as DEFAULT_LAYOUT_CONFIG, u as DEFAULT_ZOOM_LEVELS, aQ as DirectoryEdgeAttributes, aW as DirectoryForceOptions, aX as DirectoryForceResult, aT as DirectoryGraphResult, D as DirectoryMetrics, e as DirectoryNode, cv as DocumentOverlay, cD as DocumentOverlayInput, cK as DocumentStatus, cJ as DocumentType, aj as EdgeColors, cU as EdgePath, cn as EdgePosition, b0 as EdgeRoutingOptions, c3 as EdgeType, aR as EntityIdMapping, F as FileMetrics, d as FileNode, bJ as FileNodeComponent, c4 as FileNodeData, bE as Flow, c0 as FlowProps, a_ as ForcePositioningOptions, aP as GraphEdgeAttributes, aO as GraphNodeAttributes, aS as GraphologyConversionResult, aY as HierarchyOptions, aZ as HierarchyResult, cs as HighlightOverlay, cA as HighlightOverlayInput, cF as HighlightStyle, cQ as IOverlayPort, I as ImportEdge, bO as ImportEdgeComponent, c9 as ImportEdgeData, L as LayoutConfig, cf as LayoutProgress, b4 as LayoutProgressCallback, o as MapEdge, n as MapEdgeType, k as MapNode, j as MapNodeData, M as MapNodeType, m as MapScope, l as MapScopeData, cT as NodeBounds, ai as NodeColors, cm as NodePosition, c2 as NodeType, a$ as NoverlapOptions, cx as Overlay, cN as OverlayBatchUpdate, cO as OverlayClickHandler, ak as OverlayColors, cM as OverlayFilter, cP as OverlayHoverHandler, cy as OverlayInput, cY as OverlayLayer, cR as OverlayLayerProps, cW as OverlayPort, co as OverlayPosition, cp as OverlayType, a as Padding, c_ as PortalOverlayLayer, P as Position, af as RGBAColor, ae as RGBColor, cc as ReactFlowEdgeData, c8 as ReactFlowNodeData, cZ as SVGOverlayLayer, ah as ScopeDepthColors, bK as ScopeNodeComponent, c7 as ScopeNodeData, c1 as ScopeNodeProps, S as Size, b as SourceLocation, f as SymbolKind, c as SymbolMetrics, g as SymbolNode, bL as SymbolNodeComponent, c5 as SymbolNodeData, am as Theme, an as ThemeContextValue, bF as ThemeProvider, ao as ThemeProviderProps, al as UIColors, cg as UseLayoutOptions, ch as UseLayoutResult, ci as UseOverlayPortOptions, cj as UseOverlayPortResult, cV as ViewportTransform, Z as ZoomLevel, r as ZoomLevelConfig, b2 as ZoomLevelData, q as ZoomLevelName, b1 as ZoomPrecomputeOptions, be as assignClusterColors, W as boundingBoxFromCorners, _ as boundingBoxesOverlap, b6 as buildDirectoryGraph, bq as calculateNodeSize, c$ as calculateOverlayPosition, a4 as clampPosition, b5 as codeGraphToGraphology, bY as codeMapToReactFlowEdges, bX as codeMapToReactFlowNodes, bg as computeDirectoryForces, bt as computeEdges, bk as computeHierarchy, bC as computeLayout, bw as computeZoomLevels, V as createBoundingBox, cX as createOverlayPort, aM as createScopeColorGetter, aq as darkTheme, aB as darken, bb as detectCommunities, ab as detectLanguage, a2 as distance, bR as edgeTypes, a0 as expandBoundingBox, bW as formatLoc, bV as formatNumber, H as generateCallEdgeId, z as generateDirectoryId, y as generateFileId, G as generateImportEdgeId, aH as generateScopeDepthColors, E as generateSymbolId, d0 as getAnchorOffset, Q as getBasename, X as getBoundingBoxCenter, bm as getChildScopes, bd as getClusterStats, aJ as getContrastRatio, bZ as getDefaultExpandedScopes, au as getDefaultTheme, K as getDirectory, ba as getDirectoryConnectionWeight, bi as getDirectoryPosition, bv as getEdgeLabel, bu as getEdgesAtZoomLevel, b7 as getEntityId, O as getExtension, bS as getFileIcon, N as getFilename, b9 as getFilesInDirectory, ad as getIconName, aI as getLuminance, aa as getMediumFileLabel, bf as getNodeCluster, b8 as getNodeKey, bB as getNodeOpacityAtLevel, bA as getNodeSizeAtLevel, bc as getNodesInCluster, R as getParentDirectories, T as getPathDepth, bj as getPositionsAtDepth, bn as getRootScopes, bl as getScopeByDirectoryId, aG as getScopeDepthColor, a9 as getShortFileLabel, bT as getSymbolIcon, bU as getSymbolKindLabel, aL as getTextColorForBackground, ar as getTheme, at as getThemeIds, bz as getVisibleEdges, bx as getVisibleNodes, by as getVisibleScopes, a7 as getZoomLevel, b_ as getZoomLevelFromZoom, d1 as graphToScreen, av as hexToRgb, ay as hslToHex, ax as hslToRgb, ac as isCodeFile, Y as isPointInBoundingBox, a3 as lerp, ap as lightTheme, aA as lighten, U as matchesPattern, aN as mergeTheme, aD as mix, bN as nodeTypes, J as normalizePath, bh as normalizePositions, bp as positionAllNodes, bo as positionNodesInScope, as as registerTheme, bs as removeAllOverlaps, br as removeOverlapsInScope, aw as rgbToHex, az as rgbToHsl, aF as rgbaToCss, aC as saturate, a5 as scaleSize, d2 as screenToGraph, aK as shouldUseDarkText, a1 as shrinkBoundingBox, a8 as truncateLabel, a6 as uniformPadding, $ as unionBoundingBoxes, bH as useCurrentTheme, bI as useIsDarkTheme, cd as useLayout, ce as useOverlayPort, bG as useTheme, aE as withOpacity } from './useOverlayPort-dGxZQTue.mjs';
+import 'graphology';
+import 'react/jsx-runtime';
+import '@xyflow/react';
+import 'graphology-types';
+import 'react';
+import 'lucide-react';
+
+/**
+ * CodeViz - Browser-safe exports (excludes Node.js-only analyzer)
+ *
+ * Use this entry point for browser environments:
+ * import { CodeMapComponent, useLayout } from 'codeviz/browser'
+ *
+ * @packageDocumentation
+ */
+declare const VERSION = "0.1.0";
+
+export { VERSION };

package/dist/browser.d.ts

@@ -0,0 +1,19 @@
+export { cl as AbsolutePosition, cL as AgentStatus, cw as AgentWidgetOverlay, cE as AgentWidgetOverlayInput, bM as AggregateNodeComponent, A as AggregateNodeData, c6 as AggregateReactFlowNodeData, ck as AnchorPoint, s as AnimationConfig, cI as AnnotationContentType, cu as AnnotationOverlay, cC as AnnotationOverlayInput, ct as BadgeOverlay, cB as BadgeOverlayInput, cH as BadgeSize, cG as BadgeVariant, cq as BaseOverlay, B as BoundingBox, bQ as BundledEdgeComponent, cb as BundledEdgeData, cS as CalculatedPosition, C as CallEdge, bP as CallEdgeComponent, ca as CallEdgeData, aU as ClusteringOptions, aV as ClusteringResult, i as CodeGraph, p as CodeMap, bD as CodeMapComponent, t as CodeMapConfig, b$ as CodeMapProps, h as CodebaseMetadata, ag as ColorPalette, b3 as ComputeLayoutOptions, cr as CursorOverlay, cz as CursorOverlayInput, w as DEFAULT_ANIMATION_CONFIG, x as DEFAULT_CODEMAP_CONFIG, v as DEFAULT_LAYOUT_CONFIG, u as DEFAULT_ZOOM_LEVELS, aQ as DirectoryEdgeAttributes, aW as DirectoryForceOptions, aX as DirectoryForceResult, aT as DirectoryGraphResult, D as DirectoryMetrics, e as DirectoryNode, cv as DocumentOverlay, cD as DocumentOverlayInput, cK as DocumentStatus, cJ as DocumentType, aj as EdgeColors, cU as EdgePath, cn as EdgePosition, b0 as EdgeRoutingOptions, c3 as EdgeType, aR as EntityIdMapping, F as FileMetrics, d as FileNode, bJ as FileNodeComponent, c4 as FileNodeData, bE as Flow, c0 as FlowProps, a_ as ForcePositioningOptions, aP as GraphEdgeAttributes, aO as GraphNodeAttributes, aS as GraphologyConversionResult, aY as HierarchyOptions, aZ as HierarchyResult, cs as HighlightOverlay, cA as HighlightOverlayInput, cF as HighlightStyle, cQ as IOverlayPort, I as ImportEdge, bO as ImportEdgeComponent, c9 as ImportEdgeData, L as LayoutConfig, cf as LayoutProgress, b4 as LayoutProgressCallback, o as MapEdge, n as MapEdgeType, k as MapNode, j as MapNodeData, M as MapNodeType, m as MapScope, l as MapScopeData, cT as NodeBounds, ai as NodeColors, cm as NodePosition, c2 as NodeType, a$ as NoverlapOptions, cx as Overlay, cN as OverlayBatchUpdate, cO as OverlayClickHandler, ak as OverlayColors, cM as OverlayFilter, cP as OverlayHoverHandler, cy as OverlayInput, cY as OverlayLayer, cR as OverlayLayerProps, cW as OverlayPort, co as OverlayPosition, cp as OverlayType, a as Padding, c_ as PortalOverlayLayer, P as Position, af as RGBAColor, ae as RGBColor, cc as ReactFlowEdgeData, c8 as ReactFlowNodeData, cZ as SVGOverlayLayer, ah as ScopeDepthColors, bK as ScopeNodeComponent, c7 as ScopeNodeData, c1 as ScopeNodeProps, S as Size, b as SourceLocation, f as SymbolKind, c as SymbolMetrics, g as SymbolNode, bL as SymbolNodeComponent, c5 as SymbolNodeData, am as Theme, an as ThemeContextValue, bF as ThemeProvider, ao as ThemeProviderProps, al as UIColors, cg as UseLayoutOptions, ch as UseLayoutResult, ci as UseOverlayPortOptions, cj as UseOverlayPortResult, cV as ViewportTransform, Z as ZoomLevel, r as ZoomLevelConfig, b2 as ZoomLevelData, q as ZoomLevelName, b1 as ZoomPrecomputeOptions, be as assignClusterColors, W as boundingBoxFromCorners, _ as boundingBoxesOverlap, b6 as buildDirectoryGraph, bq as calculateNodeSize, c$ as calculateOverlayPosition, a4 as clampPosition, b5 as codeGraphToGraphology, bY as codeMapToReactFlowEdges, bX as codeMapToReactFlowNodes, bg as computeDirectoryForces, bt as computeEdges, bk as computeHierarchy, bC as computeLayout, bw as computeZoomLevels, V as createBoundingBox, cX as createOverlayPort, aM as createScopeColorGetter, aq as darkTheme, aB as darken, bb as detectCommunities, ab as detectLanguage, a2 as distance, bR as edgeTypes, a0 as expandBoundingBox, bW as formatLoc, bV as formatNumber, H as generateCallEdgeId, z as generateDirectoryId, y as generateFileId, G as generateImportEdgeId, aH as generateScopeDepthColors, E as generateSymbolId, d0 as getAnchorOffset, Q as getBasename, X as getBoundingBoxCenter, bm as getChildScopes, bd as getClusterStats, aJ as getContrastRatio, bZ as getDefaultExpandedScopes, au as getDefaultTheme, K as getDirectory, ba as getDirectoryConnectionWeight, bi as getDirectoryPosition, bv as getEdgeLabel, bu as getEdgesAtZoomLevel, b7 as getEntityId, O as getExtension, bS as getFileIcon, N as getFilename, b9 as getFilesInDirectory, ad as getIconName, aI as getLuminance, aa as getMediumFileLabel, bf as getNodeCluster, b8 as getNodeKey, bB as getNodeOpacityAtLevel, bA as getNodeSizeAtLevel, bc as getNodesInCluster, R as getParentDirectories, T as getPathDepth, bj as getPositionsAtDepth, bn as getRootScopes, bl as getScopeByDirectoryId, aG as getScopeDepthColor, a9 as getShortFileLabel, bT as getSymbolIcon, bU as getSymbolKindLabel, aL as getTextColorForBackground, ar as getTheme, at as getThemeIds, bz as getVisibleEdges, bx as getVisibleNodes, by as getVisibleScopes, a7 as getZoomLevel, b_ as getZoomLevelFromZoom, d1 as graphToScreen, av as hexToRgb, ay as hslToHex, ax as hslToRgb, ac as isCodeFile, Y as isPointInBoundingBox, a3 as lerp, ap as lightTheme, aA as lighten, U as matchesPattern, aN as mergeTheme, aD as mix, bN as nodeTypes, J as normalizePath, bh as normalizePositions, bp as positionAllNodes, bo as positionNodesInScope, as as registerTheme, bs as removeAllOverlaps, br as removeOverlapsInScope, aw as rgbToHex, az as rgbToHsl, aF as rgbaToCss, aC as saturate, a5 as scaleSize, d2 as screenToGraph, aK as shouldUseDarkText, a1 as shrinkBoundingBox, a8 as truncateLabel, a6 as uniformPadding, $ as unionBoundingBoxes, bH as useCurrentTheme, bI as useIsDarkTheme, cd as useLayout, ce as useOverlayPort, bG as useTheme, aE as withOpacity } from './useOverlayPort-dGxZQTue.js';
+import 'graphology';
+import 'react/jsx-runtime';
+import '@xyflow/react';
+import 'graphology-types';
+import 'react';
+import 'lucide-react';
+
+/**
+ * CodeViz - Browser-safe exports (excludes Node.js-only analyzer)
+ *
+ * Use this entry point for browser environments:
+ * import { CodeMapComponent, useLayout } from 'codeviz/browser'
+ *
+ * @packageDocumentation
+ */
+declare const VERSION = "0.1.0";
+
+export { VERSION };