srcly 0.1.23__tar.gz → 0.1.24__tar.gz

{srcly-0.1.23 → srcly-0.1.24}/.gitignore

@@ -64,4 +64,6 @@ venv.bak/
 
 # uv
 .python-version
-# uv.lock is intentionally not ignored as this is an application
+# uv.lock is intentionally not ignored as this is an application
+
+.tmp

{srcly-0.1.23 → srcly-0.1.24}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: srcly
-Version: 0.1.23
+Version: 0.1.24
 Summary: Interactive codebase treemap and metrics viewer.
 Requires-Python: >=3.13
 Requires-Dist: fastapi>=0.121.3

{srcly-0.1.23 → srcly-0.1.24}/app/models.py

@@ -73,3 +73,24 @@ class DependencyEdge(BaseModel):
 class DependencyGraph(BaseModel):
     nodes: List[DependencyNode]
     edges: List[DependencyEdge]
+
+
+class FocusOverlayRequest(BaseModel):
+    path: str
+    sliceStartLine: int
+    sliceEndLine: int
+    focusStartLine: int | None = None
+    focusEndLine: int | None = None
+
+
+class OverlayToken(BaseModel):
+    fileLine: int
+    startCol: int
+    endCol: int
+    category: str
+    symbolId: str
+    tooltip: str
+
+
+class FocusOverlayResponse(BaseModel):
+    tokens: List[OverlayToken] = Field(default_factory=list)

{srcly-0.1.23 → srcly-0.1.24}/app/routers/analysis.py

@@ -8,6 +8,7 @@ from app.models import Node, DependencyGraph, DependencyNode, DependencyEdge
 from app.services import analysis, cache
 from app.services.typescript import typescript_analysis
 from app.config import IGNORE_DIRS
+from app.models import FocusOverlayRequest, FocusOverlayResponse
 
 router = APIRouter(prefix="/api/analysis", tags=["analysis"])
 
@@ -614,3 +615,36 @@ async def get_data_flow(path: str):
     except Exception as e:
         print(f"Error analyzing data flow for {path}: {e}")
         raise HTTPException(status_code=500, detail=str(e))
+
+
+@router.post("/focus/overlay", response_model=FocusOverlayResponse)
+async def get_focus_overlay(req: FocusOverlayRequest):
+    """
+    Return a minimal overlay model for a single file and a focus range.
+
+    The client uses this to decorate Shiki-rendered HTML with subtle identifier
+    background highlights + provenance tooltips.
+    """
+    target_path = Path(req.path)
+    if not target_path.exists() or not target_path.is_file():
+        raise HTTPException(status_code=404, detail="File not found")
+
+    # If no focus is provided, return an empty overlay.
+    if req.focusStartLine is None or req.focusEndLine is None:
+        return FocusOverlayResponse(tokens=[])
+
+    from app.services.focus_overlay import compute_focus_overlay
+
+    try:
+        return compute_focus_overlay(
+            file_path=str(target_path),
+            slice_start_line=req.sliceStartLine,
+            slice_end_line=req.sliceEndLine,
+            focus_start_line=req.focusStartLine,
+            focus_end_line=req.focusEndLine,
+        )
+    except HTTPException:
+        raise
+    except Exception as e:
+        print(f"Error computing focus overlay for {req.path}: {e}")
+        raise HTTPException(status_code=500, detail=str(e))