sql-code-graph 1.36.2__py3-none-any.whl → 1.37.1__py3-none-any.whl

{sql_code_graph-1.36.2.dist-info → sql_code_graph-1.37.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sql-code-graph
-Version: 1.36.2
+Version: 1.37.1
 Summary: SQL code graph analyzer and lineage tracer
 Project-URL: Homepage, https://github.com/Warhorze/sql-code-graph
 Project-URL: Repository, https://github.com/Warhorze/sql-code-graph

{sql_code_graph-1.36.2.dist-info → sql_code_graph-1.37.1.dist-info}/RECORD

@@ -1,4 +1,4 @@
-sqlcg/__init__.py,sha256=lDqeTiiKtYlwFCXOBJv--TA4e7oisecgTT3NeETH6eY,116
+sqlcg/__init__.py,sha256=bfwekIDaFpChaS-yg8BLF_HhMid1W5BaoDHobS3Ryyc,116
 sqlcg/__main__.py,sha256=1YoFLcqEgTwYq1J3TbUwpkdG0zeeLIf2fJvwWI-CLFU,109
 sqlcg/cli/__init__.py,sha256=W8fD0LpMq2xm_5WKGNMvJh2WBL1ho5E8hUeAqXQYT1g,28
 sqlcg/cli/coverage.py,sha256=Xm9ITzZDHv2mJ70Q5jCacVuhDStVrE3gq12_-Ypvtd8,43823
@@ -72,8 +72,8 @@ sqlcg/viz/data.py,sha256=deLWOZBgewM1x-kk1NhUnt0mswyt0nzqSevHzBCOHHc,5899
 sqlcg/viz/render.py,sha256=BINkGbJbbb_iqhrkN795RaQsdg8nqCiJtsEFF1yo22Y,2737
 sqlcg/viz/tags.py,sha256=6zRnGlHjuGmEeB6yN1uhzm8rqL7ZGoyL1Ki7jI5oM6A,5368
 sqlcg/viz/assets/force-graph.min.js,sha256=jNdYdDdrYiUdUlElxRkolPBt30rstQk2q15Q32VVdzc,177272
-sqlcg/viz/assets/template.html,sha256=9_j-mvo1ZxwgiJPDdVrNmca37dTrTjjYVd3977u-DxE,12294
-sql_code_graph-1.36.2.dist-info/METADATA,sha256=if10KHC8utK49r0BY4N9DmsK98-Uz1mUlauVqTiFEaE,19208
-sql_code_graph-1.36.2.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
-sql_code_graph-1.36.2.dist-info/entry_points.txt,sha256=Wfe49sVzV9p4eVFGo5RxcV-frr3HOP0yzzst8JBxQLQ,46
-sql_code_graph-1.36.2.dist-info/RECORD,,
+sqlcg/viz/assets/template.html,sha256=48ACoI2EjhITfvxDpSo_Js4OVG3L2BGq56eiwJfBupA,17404
+sql_code_graph-1.37.1.dist-info/METADATA,sha256=5iPu-AfnvE_myVt6yjW2ix66uwp_5ZJay0dFgcJieAA,19208
+sql_code_graph-1.37.1.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
+sql_code_graph-1.37.1.dist-info/entry_points.txt,sha256=Wfe49sVzV9p4eVFGo5RxcV-frr3HOP0yzzst8JBxQLQ,46
+sql_code_graph-1.37.1.dist-info/RECORD,,

sqlcg/__init__.py

@@ -1,5 +1,5 @@
 """SQL Code Graph - SQL lineage and dependency analysis tool."""
 
-__version__ = "1.36.2"
+__version__ = "1.37.1"
 
 __all__ = ["__version__"]

sqlcg/viz/assets/template.html

@@ -29,14 +29,14 @@
  <div class="facet" id="kind-facet"><b>kind</b></div>
  <div class="facet" id="tag-facet"><b>tag</b></div>
  <select id="jobsel"><option value="">all jobs</option></select>
- <label>min deg <input id="mindeg" type="number" value="0" min="0" style="width:3.2em"></label>
+ <label>min deg <input id="mindeg" type="number" value="1" min="0" style="width:3.2em"></label>
  <label><input id="egomode" type="checkbox"> ego</label>
  <label><input id="labelmode" type="checkbox" checked> labels</label>
  <label><input id="tagcolor" type="checkbox"> color by tag</label>
  <span id="meta"></span>
 </div>
 <div id="graph"></div>
-<div id="info">click a node · scroll to zoom · drag to pan · click a chip to toggle, alt/right-click to solo</div>
+<div id="info">hover/click a node to trace its 1-hop lineage (Esc or background clears) · scroll to zoom · drag to pan · click a chip to toggle, alt/right-click to solo · set min deg 0 to show isolated tables</div>
 <script>
 const DATA = /*__DATA__*/;
 const TAGS = /*__TAGS__*/;
@@ -57,6 +57,22 @@ for (const l of DATA.links) {
   adj.get(s).add(t); adj.get(t).add(s);
 }
 
+// ── Neighborhood highlight (headline) ───────────────────────────────────────
+// Pure, side-effect-free: given the adjacency map and a focus id, return the
+// 1-hop highlight set = focus ∪ direct neighbors. Returns an EMPTY Set when id
+// is null (no highlight active). Factored out as a standalone fn so it can be
+// asserted directly in a Node harness (no DOM, no force-graph) — this is the
+// AC2 binding guard that the highlight is wired to the baked adjacency, not an
+// orphaned reference. (Amendment 1.)
+function computeHighlightSet(adjMap, id) {
+  const out = new Set();
+  if (id == null) return out;
+  out.add(id);
+  const nbrs = adjMap.get(id);
+  if (nbrs) for (const n of nbrs) out.add(n);
+  return out;
+}
+
 // ── Schema palette + colors ──────────────────────────────────────────────
 const SCHEMA_PALETTE = SCHEMA_CONFIG.palette;
 const SCHEMA_OTHER_COLOR = SCHEMA_CONFIG.other;
@@ -69,10 +85,12 @@ curatedSchemas.forEach((s, i) => schemaColour.set(s, SCHEMA_PALETTE[i % SCHEMA_P
 dataSchemas.forEach(s => { if (!schemaColour.has(s)) schemaColour.set(s, SCHEMA_OTHER_COLOR); });
 function schemaFill(n) { return schemaColour.get(n.schema) || SCHEMA_OTHER_COLOR; }
 
-// ── Kind vocabulary (B2): table/view/temp default ON; cte/derived default OFF.
-//    "external" is never emitted. Unknown kinds bucket into "table". ─────────
+// ── Kind vocabulary: table/view default ON; temp/cte/derived default OFF.
+//    "external" is never emitted. Unknown kinds bucket into "table".
+//    temp stays in KNOWN_KINDS so it remains a toggleable chip (804 temp nodes
+//    at live scale are clutter by default; one chip click reveals them). ──────
 const KNOWN_KINDS = ['table', 'view', 'temp', 'cte', 'derived'];
-const KIND_DEFAULT_ON = new Set(['table', 'view', 'temp']);
+const KIND_DEFAULT_ON = new Set(['table', 'view']);
 function kindBucket(k) { return KNOWN_KINDS.includes(k) ? k : 'table'; }
 
 // ── Facet selection state. Empty selected-set for a facet = "do not filter". ─
@@ -83,8 +101,20 @@ const sel = {
 };
 const soloBackup = { schema: null, kind: null, tag: null };
 
-let focusNode = null;
-let hoveredNode = null;
+let focusNode = null;   // ego-mode focus (orthogonal to highlight)
+let hoveredNode = null; // transient hover target
+let pinnedNode = null;  // click-pinned highlight focus (survives cursor leave)
+
+// highlightId: pin wins over hover. highlightSet: focus ∪ 1-hop neighbors,
+// recomputed only when the focus changes (cheap; not per frame). These are read
+// by the styling accessors below — repaint is styling-only, NEVER a graphData()
+// rebuild (Amendment 2: a rebuild re-seeds the force layout → the graph jumps).
+let highlightId = null;
+let highlightSet = new Set();
+function setHighlight(id) {
+  highlightId = id;
+  highlightSet = computeHighlightSet(adj, id);
+}
 
 function buildFacet(facetId, key, items, colorOf, defaultOn) {
   const root = document.getElementById(facetId);
@@ -145,9 +175,15 @@ buildFacet('schema-facet', 'schema', curatedSchemas,
   s => schemaColour.get(s) || SCHEMA_OTHER_COLOR, () => false);
 // kind facet
 buildFacet('kind-facet', 'kind', KNOWN_KINDS, null, k => KIND_DEFAULT_ON.has(k));
-// tag facet (legend swatches double as filter controls)
-buildFacet('tag-facet', 'tag', TAGS.labels || [],
-  t => (TAGS.colors || {})[t] || SCHEMA_OTHER_COLOR, () => false);
+// tag facet (legend swatches double as filter controls). When no --tags were
+// passed the label list is empty; hide the whole facet container so a lonely
+// "TAG" header is not shown (Phase 4 empty-facet polish). No JS error either way.
+if ((TAGS.labels || []).length) {
+  buildFacet('tag-facet', 'tag', TAGS.labels,
+    t => (TAGS.colors || {})[t] || SCHEMA_OTHER_COLOR, () => false);
+} else {
+  document.getElementById('tag-facet').style.display = 'none';
+}
 
 // ── Job facet → dropdown (filter only). ──────────────────────────────────
 const jobSel = document.getElementById('jobsel');
@@ -227,24 +263,67 @@ function tagRing(n) {
 
 function drawNodeCanvas(node, ctx, globalScale) {
   const r = Math.max(1, Math.sqrt(node.deg || 1));
+  // Highlight-aware alpha: when a highlight is active, nodes outside the 1-hop
+  // set dim; nodes inside paint full. No highlight → everything full.
+  const inSet = highlightSet.has(node.id);
+  const dim = highlightId !== null && !inSet;
+  ctx.globalAlpha = dim ? 0.12 : 1;
   ctx.beginPath();
   ctx.arc(node.x, node.y, r, 0, 2 * Math.PI);
   ctx.fillStyle = nodeFill(node);
   ctx.fill();
   const ring = tagRing(node);
-  if (ring && !node._hit) {
+  if (ring && !node._hit && !dim) {
     ctx.lineWidth = 1.5 / globalScale;
     ctx.strokeStyle = ring;
     ctx.beginPath();
     ctx.arc(node.x, node.y, r + 1.5 / globalScale, 0, 2 * Math.PI);
     ctx.stroke();
   }
+  // Focus ring on the highlightId node itself (white, distinct from tag ring).
+  if (node.id === highlightId) {
+    ctx.lineWidth = 2 / globalScale;
+    ctx.strokeStyle = '#ffffff';
+    ctx.beginPath();
+    ctx.arc(node.x, node.y, r + 3 / globalScale, 0, 2 * Math.PI);
+    ctx.stroke();
+  }
   const showLabels = document.getElementById('labelmode').checked;
-  if (showLabels && (r * globalScale > 6 || node._hit || node.id === hoveredNode)) {
+  if (showLabels && !dim
+      && (r * globalScale > 6 || node._hit || inSet || node.id === hoveredNode)) {
     ctx.font = `${10 / globalScale}px system-ui`;
     ctx.fillStyle = '#c9d1d9';
     ctx.fillText(node.id, node.x + r + 1, node.y + 3 / globalScale);
   }
+  ctx.globalAlpha = 1;
+}
+
+// ── Edge styling (Item 2): legible base edges on #0d1117; dim/bright tiers and
+//    directional arrows driven by highlightId/highlightSet. A link is "incident"
+//    to the highlight iff BOTH endpoints are in highlightSet (highlightSet is
+//    focus + its neighbors, so this is exactly the focus's own edges). ─────────
+function linkEnds(l) {
+  return [l.source.id ?? l.source, l.target.id ?? l.target];
+}
+function linkIncident(l) {
+  if (highlightId === null) return false;
+  const [s, t] = linkEnds(l);
+  return highlightSet.has(s) && highlightSet.has(t);
+}
+function linkColor(l) {
+  if (highlightId === null) return '#3b4350';          // legible base on dark bg
+  if (linkIncident(l)) return '#79c0ff';               // bright (traced lineage)
+  return 'rgba(59,67,80,0.08)';                        // dimmed away from focus
+}
+function linkWidth(l) {
+  if (highlightId !== null && linkIncident(l)) return 2;
+  return 1;
+}
+// Directional arrows on HIGHLIGHTED edges ONLY (D3): base state stays clean.
+// DATA.links carry source->target = producer->consumer (data.py), so the arrow
+// points producer→consumer with no data change.
+function linkArrowLen(l) {
+  return (highlightId !== null && linkIncident(l)) ? 4 : 0;
 }
 
 // ── Graph init ────────────────────────────────────────────────────────────
@@ -252,12 +331,39 @@ const Graph = ForceGraph()(document.getElementById('graph'))
   .graphData(currentData())
   .nodeId('id')
   .nodeCanvasObject(drawNodeCanvas)
+  .linkColor(linkColor)
+  .linkWidth(linkWidth)
+  .linkDirectionalArrowLength(linkArrowLen)
+  .linkDirectionalArrowRelPos(1)
   .nodeLabel(n => `${n.id}\nschema: ${n.schema} · kind: ${n.kind} · degree: ${n.deg}`
     + ((n.tags || []).length ? `\ntags: ${n.tags.join(', ')}` : '')
     + ((n.jobs || []).length ? `\njobs: ${n.jobs.join(', ')}` : ''))
-  .onNodeClick(n => { focusNode = n.id; refresh(); })
-  .onNodeHover(n => { hoveredNode = n ? n.id : null; });
+  // Highlight handlers mutate ONLY hover/pin state, then recompute highlightSet.
+  // They DO NOT call refresh()/graphData() — that would re-seed the force layout
+  // and make the graph jump at 3069/6671 scale (Amendment 2). force-graph
+  // repaints every animation frame, re-reading the closure-visible highlightId/
+  // highlightSet, so updating state is enough; ego-mode keeps focusNode separate.
+  .onNodeClick(n => {
+    pinnedNode = (pinnedNode === n.id) ? null : n.id;   // toggle pin
+    setHighlight(pinnedNode ?? hoveredNode);
+    focusNode = n.id;  // ego-mode focus (orthogonal; only used when ego is on)
+  })
+  .onNodeHover(n => {
+    hoveredNode = n ? n.id : null;
+    if (pinnedNode === null) setHighlight(hoveredNode);  // pin wins over hover
+  })
+  .onBackgroundClick(() => {           // click empty space clears the pin
+    pinnedNode = null;
+    setHighlight(hoveredNode);
+  });
+
+// Escape clears the pin (transient hover clears on its own via onNodeHover).
+document.addEventListener('keydown', e => {
+  if (e.key === 'Escape') { pinnedNode = null; setHighlight(hoveredNode); }
+});
 
+// refresh() rebuilds graphData → re-seeds layout. Reserved for FILTER changes
+// (facets / mindeg / search / ego) ONLY, never for highlight (Amendment 2).
 function refresh() { Graph.graphData(currentData()); }
 
 for (const id of ['search', 'mindeg', 'egomode', 'labelmode', 'tagcolor']) {