npm - xcode-graph - Versions diffs - 0.1.0 → 0.2.0 - Mend

xcode-graph 0.1.0 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (14) hide show

package/LICENSE +21 -0
package/README.md +364 -41
package/custom-elements.json +1418 -537
package/dist/elk-worker.js +104592 -0
package/dist/elk.bundled.js +5907 -5981
package/dist/{assets/micro-layout.worker-CSeqAKhL.js → micro-layout.worker.js} +58 -364
package/dist/xcode-graph.js +28509 -0
package/dist/xcode-graph.service.js +4917 -0
package/dist/xcodegraph.js +1 -22164
package/package.json +49 -45
package/vscode.css-custom-data.json +0 -5
package/vscode.html-custom-data.json +358 -78
package/web-types.json +918 -202
package/dist/flow.js +0 -883

package/custom-elements.json CHANGED Viewed

@@ -17,6 +17,7 @@
               "type": {
                 "text": "GraphNode[]"
               },
+              "description": "All graph nodes to expose for screen reader navigation",
               "default": "[]"
             },
             {
@@ -25,6 +26,7 @@
               "type": {
                 "text": "GraphEdge[]"
               },
+              "description": "All graph edges to expose as an accessible table",
               "default": "[]"
             },
             {
@@ -33,6 +35,7 @@
               "type": {
                 "text": "GraphNode | null"
               },
+              "description": "Currently selected node for aria-selected state",
               "default": "null"
             },
             {
@@ -56,12 +59,14 @@
                     "text": "KeyboardEvent"
                   }
                 }
-              ]
+              ],
+              "description": "Handles arrow key navigation, Home/End, and Enter/Space selection within the node tree."
             },
             {
               "kind": "method",
               "name": "focusCurrentNode",
-              "privacy": "private"
+              "privacy": "private",
+              "description": "Moves DOM focus to the tree item at the current focused index."
             },
             {
               "kind": "method",
@@ -99,7 +104,7 @@
               "privacy": "private",
               "return": {
                 "type": {
-                  "text": "string"
+                  "text": ""
                 }
               },
               "parameters": [
@@ -107,9 +112,11 @@
                   "name": "node",
                   "type": {
                     "text": "GraphNode"
-                  }
+                  },
+                  "description": "The graph node to describe."
                 }
-              ]
+              ],
+              "description": "Builds a human-readable description of a node for screen readers."
             },
             {
               "kind": "method",
@@ -172,15 +179,25 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "Canvas-based graph visualization component. Renders nodes, edges, and clusters\non an HTML canvas with pan, zoom, and interactive selection support.",
+          "description": "Canvas2D graph visualization component. Renders nodes, edges, and clusters\nusing raw Canvas2D with pan, zoom, and interactive selection support.",
           "name": "GraphCanvas",
           "members": [
+            {
+              "kind": "field",
+              "name": "CANVAS_PROPS",
+              "privacy": "private",
+              "static": true,
+              "readonly": true,
+              "default": "new Set([ 'nodes', 'edges', 'selectedNode', 'selectedCluster', 'searchQuery', 'viewMode', 'enableAnimation', 'showDirectDeps', 'showTransitiveDeps', 'showDirectDependents', 'showTransitiveDependents', ])",
+              "description": "Properties that affect canvas rendering — other Lit properties (e.g. internal state) don't need a render."
+            },
             {
               "kind": "field",
               "name": "nodes",
               "type": {
                 "text": "GraphNode[]"
               },
+              "description": "Graph nodes to render",
               "default": "[]"
             },
             {
@@ -189,6 +206,7 @@
               "type": {
                 "text": "GraphEdge[]"
               },
+              "description": "Graph edges to render",
               "default": "[]"
             },
             {
@@ -197,6 +215,7 @@
               "type": {
                 "text": "GraphNode | null"
               },
+              "description": "Currently selected node (highlighted with ring and connected edges)",
               "default": "null"
             },
             {
@@ -205,6 +224,7 @@
               "type": {
                 "text": "string | null"
               },
+              "description": "Currently selected cluster ID (dims non-member nodes)",
               "default": "null"
             },
             {
@@ -213,7 +233,8 @@
               "type": {
                 "text": "string | null"
               },
-              "default": "null"
+              "default": "null",
+              "description": "Currently hovered node ID — plain field, only used for canvas rendering."
             },
             {
               "kind": "field",
@@ -221,6 +242,7 @@
               "type": {
                 "text": "string"
               },
+              "description": "Active search query — attribute-bound from parent via search-query=\"...\"",
               "default": "''",
               "attribute": "search-query"
             },
@@ -230,16 +252,28 @@
               "type": {
                 "text": "ViewMode"
               },
-              "attribute": "view-mode"
+              "description": "Display mode — attribute-bound from parent via view-mode=\"...\"",
+              "attribute": "view-mode",
+              "parsedType": {
+                "text": "'full' | 'focused' | 'path' | 'dependents' | 'both'"
+              }
             },
             {
               "kind": "field",
-              "name": "zoom",
+              "name": "_zoom",
               "type": {
                 "text": "number"
               },
+              "privacy": "private",
               "default": "1",
-              "attribute": "zoom"
+              "description": "Current zoom level.\nUses a plain field + setter to trigger canvas re-render without a full\nLit update cycle, which was causing lag during wheel-zoom."
+            },
+            {
+              "kind": "field",
+              "name": "zoom",
+              "type": {
+                "text": "number"
+              }
             },
             {
               "kind": "field",
@@ -247,6 +281,7 @@
               "type": {
                 "text": "boolean"
               },
+              "description": "Whether physics animation is enabled for layout settling",
               "default": "false",
               "attribute": "enable-animation"
             },
@@ -255,20 +290,26 @@
               "name": "transitiveDeps",
               "type": {
                 "text": "TransitiveResult | undefined"
-              }
+              },
+              "description": "Transitive dependency chain — plain field, only used for canvas rendering."
             },
             {
               "kind": "field",
               "name": "transitiveDependents",
               "type": {
                 "text": "TransitiveResult | undefined"
-              }
+              },
+              "description": "Transitive dependent chain — plain field, only used for canvas rendering."
             },
             {
               "kind": "field",
               "name": "previewFilter",
               "type": {
                 "text": "PreviewFilter | undefined"
+              },
+              "description": "Active filter preview — plain field, only used for canvas rendering.",
+              "parsedType": {
+                "text": "null | { type: 'platform' | 'origin' | 'project' | 'nodeType' | 'package' | 'cluster', value: string } | undefined"
               }
             },
             {
@@ -277,6 +318,7 @@
               "type": {
                 "text": "boolean"
               },
+              "description": "Whether to highlight direct dependency edges — attribute-bound via ?show-direct-deps",
               "default": "false",
               "attribute": "show-direct-deps"
             },
@@ -286,6 +328,7 @@
               "type": {
                 "text": "boolean"
               },
+              "description": "Whether to highlight transitive dependency edges — attribute-bound via ?show-transitive-deps",
               "default": "false",
               "attribute": "show-transitive-deps"
             },
@@ -295,6 +338,7 @@
               "type": {
                 "text": "boolean"
               },
+              "description": "Whether to highlight direct dependent edges — attribute-bound via ?show-direct-dependents",
               "default": "false",
               "attribute": "show-direct-dependents"
             },
@@ -304,6 +348,7 @@
               "type": {
                 "text": "boolean"
               },
+              "description": "Whether to highlight transitive dependent edges — attribute-bound via ?show-transitive-dependents",
               "default": "false",
               "attribute": "show-transitive-dependents"
             },
@@ -313,23 +358,25 @@
               "type": {
                 "text": "Set<string>"
               },
-              "default": "new Set()"
+              "default": "new Set()",
+              "description": "Set of node IDs that should be visually dimmed"
             },
             {
               "kind": "field",
-              "name": "canvas",
+              "name": "containerEl",
               "type": {
-                "text": "HTMLCanvasElement"
+                "text": "HTMLDivElement"
               },
               "privacy": "private"
             },
             {
               "kind": "field",
-              "name": "ctx",
+              "name": "scene",
               "type": {
-                "text": "CanvasRenderingContext2D | undefined"
+                "text": "CanvasScene | null"
               },
-              "privacy": "private"
+              "privacy": "private",
+              "default": "null"
             },
             {
               "kind": "field",
@@ -340,62 +387,51 @@
             },
             {
               "kind": "field",
-              "name": "_resize",
+              "name": "resizeObserver",
+              "type": {
+                "text": "ResizeObserver | null"
+              },
               "privacy": "private",
-              "readonly": true,
-              "default": "new ResizeController(this, { callback: () => this.resizeCanvas(), })"
+              "default": "null"
             },
             {
               "kind": "field",
-              "name": "_visibility",
+              "name": "resizeRafId",
+              "type": {
+                "text": "number | null"
+              },
               "privacy": "private",
-              "readonly": true,
-              "default": "new IntersectionController(this, { callback: (entries) => entries.some((e) => e.isIntersecting), })"
+              "default": "null"
             },
             {
               "kind": "field",
-              "name": "interactionState",
+              "name": "intersectionObserver",
               "type": {
-                "text": "InteractionState"
+                "text": "IntersectionObserver | null"
               },
               "privacy": "private",
-              "default": "{ pan: { x: window.innerWidth / 2, y: window.innerHeight / 2 }, zoom: 1, isDragging: false, draggedNodeId: null, draggedClusterId: null, lastMousePos: { x: 0, y: 0 }, clickedEmptySpace: false, hasMoved: false, hoveredNode: null, hoveredCluster: null, }"
+              "default": "null"
             },
             {
               "kind": "field",
-              "name": "manualNodePositions",
+              "name": "_isVisible",
+              "type": {
+                "text": "boolean"
+              },
               "privacy": "private",
-              "default": "new Map<string, { x: number; y: number }>()"
+              "default": "true"
             },
             {
               "kind": "field",
-              "name": "manualClusterPositions",
+              "name": "manualNodePositions",
               "privacy": "private",
               "default": "new Map<string, { x: number; y: number }>()"
             },
             {
               "kind": "field",
-              "name": "pathCache",
-              "privacy": "private",
-              "default": "new Map<string, Path2D>()"
-            },
-            {
-              "kind": "field",
-              "name": "edgePathCache",
-              "privacy": "private",
-              "default": "new Map<string, Path2D>()"
-            },
-            {
-              "kind": "field",
-              "name": "nodeWeights",
-              "privacy": "private",
-              "default": "new Map<string, number>()"
-            },
-            {
-              "kind": "field",
-              "name": "nodeMap",
+              "name": "manualClusterPositions",
               "privacy": "private",
-              "default": "new Map<string, GraphNode>()"
+              "default": "new Map<string, { x: number; y: number }>()"
             },
             {
               "kind": "field",
@@ -406,24 +442,6 @@
               "privacy": "private",
               "default": "null"
             },
-            {
-              "kind": "field",
-              "name": "routedEdgeMapCache",
-              "type": {
-                "text": "Map<string, RoutedEdge> | null"
-              },
-              "privacy": "private",
-              "default": "null"
-            },
-            {
-              "kind": "field",
-              "name": "lastRoutedEdgesRef",
-              "type": {
-                "text": "RoutedEdge[] | undefined"
-              },
-              "privacy": "private",
-              "default": "undefined"
-            },
             {
               "kind": "field",
               "name": "theme",
@@ -437,7 +455,7 @@
               "name": "animationLoop",
               "privacy": "private",
               "readonly": true,
-              "default": "new AnimationLoopController(this, { onRender: (timestamp, dt) => this.onFrame(timestamp, dt), shouldAnimate: () => this.isAnimating, isVisible: () => this._visibility.value !== false, })"
+              "default": "new AnimationLoopController(this, { onRender: (timestamp, dt) => this.onFrame(timestamp, dt), shouldAnimate: () => this.isAnimating, isVisible: () => this._isVisible, })"
             },
             {
               "kind": "field",
@@ -476,18 +494,7 @@
               "kind": "field",
               "name": "fadingOutNodes",
               "privacy": "private",
-              "default": "new Map<string, { node: GraphNode; startTime: number }>()"
-            },
-            {
-              "kind": "field",
-              "name": "FADE_OUT_DURATION",
-              "type": {
-                "text": "number"
-              },
-              "privacy": "private",
-              "static": true,
-              "readonly": true,
-              "default": "250"
+              "default": "new Map<string, FadingNode>()"
             },
             {
               "kind": "method",
@@ -500,22 +507,14 @@
                     "text": "PropertyValues<this>"
                   }
                 }
-              ]
-            },
-            {
-              "kind": "method",
-              "name": "updatePathCache",
-              "privacy": "private"
-            },
-            {
-              "kind": "method",
-              "name": "rebuildNodeMap",
-              "privacy": "private"
+              ],
+              "description": "Detects nodes removed between updates and queues them for fade-out animation."
             },
             {
               "kind": "method",
               "name": "updateNodeAlphaTargets",
-              "privacy": "private"
+              "privacy": "private",
+              "description": "Updates opacity animation targets based on current selection and cluster state."
             },
             {
               "kind": "method",
@@ -525,27 +524,14 @@
                 "type": {
                   "text": "Set<string>"
                 }
-              }
-            },
-            {
-              "kind": "method",
-              "name": "getRoutedEdgeMap",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "Map<string, RoutedEdge>"
-                }
-              }
-            },
-            {
-              "kind": "field",
-              "name": "getPathForNode",
-              "privacy": "private"
+              },
+              "description": "Returns the cached set of node IDs connected to the selected node."
             },
             {
               "kind": "method",
               "name": "centerGraph",
-              "privacy": "private"
+              "privacy": "private",
+              "description": "Centers the pan offset to the middle of the component's bounding rectangle."
             },
             {
               "kind": "method",
@@ -554,22 +540,20 @@
                 "type": {
                   "text": "void"
                 }
-              }
+              },
+              "description": "Adjusts zoom and pan so that all clusters fit within the visible viewport."
             },
             {
               "kind": "method",
-              "name": "getInteractionContext",
+              "name": "scheduleResize",
               "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "InteractionContext"
-                }
-              }
+              "description": "Debounces resize via rAF so the scene resize and re-render happen\nin the same frame, preventing visible flashes during CSS transitions."
             },
             {
               "kind": "method",
-              "name": "resizeCanvas",
-              "privacy": "private"
+              "name": "resizeScene",
+              "privacy": "private",
+              "description": "Resizes the canvas to match the element dimensions."
             },
             {
               "kind": "field",
@@ -578,33 +562,14 @@
             },
             {
               "kind": "field",
-              "name": "handleCanvasMouseDown",
-              "privacy": "private"
-            },
-            {
-              "kind": "field",
-              "name": "handleCanvasMouseMove",
-              "privacy": "private"
-            },
-            {
-              "kind": "field",
-              "name": "handleCanvasMouseUp",
-              "privacy": "private"
-            },
-            {
-              "kind": "field",
-              "name": "handleCanvasWheel",
-              "privacy": "private"
-            },
-            {
-              "kind": "field",
-              "name": "handleCanvasKeyDown",
+              "name": "handleContainerKeyDown",
               "privacy": "private"
             },
             {
               "kind": "method",
               "name": "requestRender",
-              "privacy": "private"
+              "privacy": "private",
+              "description": "Schedules a canvas render on the next animation frame."
             },
             {
               "kind": "method",
@@ -629,32 +594,19 @@
                   }
                 }
               ],
-              "description": "Frame callback invoked by AnimationLoopController when a render is needed.\nHandles animation ticking and delegates to renderCanvas()."
+              "description": "Frame callback invoked by AnimationLoopController when a render is needed.\nHandles animation ticking and delegates to renderScene()."
             },
             {
               "kind": "method",
               "name": "updateAnimatingState",
-              "privacy": "private"
-            },
-            {
-              "kind": "method",
-              "name": "renderCanvas",
-              "privacy": "private"
+              "privacy": "private",
+              "description": "Recalculates whether the animation loop should remain active based on current state."
             },
             {
               "kind": "method",
-              "name": "renderFadingNodes",
-              "privacy": "private"
-            },
-            {
-              "kind": "field",
-              "name": "getMousePos",
-              "privacy": "private"
-            },
-            {
-              "kind": "field",
-              "name": "screenToWorld",
-              "privacy": "private"
+              "name": "renderScene",
+              "privacy": "private",
+              "description": "Builds the scene config and delegates rendering to the canvas scene."
             }
           ],
           "events": [
@@ -703,6 +655,7 @@
               "type": {
                 "text": "string"
               },
+              "description": "Active search query — attribute-bound from parent via search-query=\"...\"",
               "default": "''",
               "fieldName": "searchQuery"
             },
@@ -711,21 +664,18 @@
               "type": {
                 "text": "ViewMode"
               },
-              "fieldName": "viewMode"
-            },
-            {
-              "name": "zoom",
-              "type": {
-                "text": "number"
-              },
-              "default": "1",
-              "fieldName": "zoom"
+              "description": "Display mode — attribute-bound from parent via view-mode=\"...\"",
+              "fieldName": "viewMode",
+              "parsedType": {
+                "text": "'full' | 'focused' | 'path' | 'dependents' | 'both'"
+              }
             },
             {
               "name": "enable-animation",
               "type": {
                 "text": "boolean"
               },
+              "description": "Whether physics animation is enabled for layout settling",
               "default": "false",
               "fieldName": "enableAnimation"
             },
@@ -734,6 +684,7 @@
               "type": {
                 "text": "boolean"
               },
+              "description": "Whether to highlight direct dependency edges — attribute-bound via ?show-direct-deps",
               "default": "false",
               "fieldName": "showDirectDeps"
             },
@@ -742,6 +693,7 @@
               "type": {
                 "text": "boolean"
               },
+              "description": "Whether to highlight transitive dependency edges — attribute-bound via ?show-transitive-deps",
               "default": "false",
               "fieldName": "showTransitiveDeps"
             },
@@ -750,6 +702,7 @@
               "type": {
                 "text": "boolean"
               },
+              "description": "Whether to highlight direct dependent edges — attribute-bound via ?show-direct-dependents",
               "default": "false",
               "fieldName": "showDirectDependents"
             },
@@ -758,6 +711,7 @@
               "type": {
                 "text": "boolean"
               },
+              "description": "Whether to highlight transitive dependent edges — attribute-bound via ?show-transitive-dependents",
               "default": "false",
               "fieldName": "showTransitiveDependents"
             }
@@ -766,7 +720,7 @@
             "name": "LitElement",
             "package": "lit"
           },
-          "summary": "Canvas-based interactive graph visualization",
+          "summary": "Canvas2D interactive graph visualization",
           "tagName": "xcode-graph-canvas",
           "customElement": true
         }
@@ -818,6 +772,7 @@
               "type": {
                 "text": "number"
               },
+              "description": "Current absolute zoom level",
               "attribute": "zoom"
             },
             {
@@ -826,6 +781,7 @@
               "type": {
                 "text": "number"
               },
+              "description": "Baseline zoom level used for ratio display (fit-to-view = 1x)",
               "attribute": "base-zoom"
             },
             {
@@ -869,17 +825,20 @@
             {
               "kind": "method",
               "name": "handleZoomIn",
-              "privacy": "private"
+              "privacy": "private",
+              "description": "Steps zoom to the next predefined level and dispatches a 'zoom-step' event."
             },
             {
               "kind": "method",
               "name": "handleZoomOut",
-              "privacy": "private"
+              "privacy": "private",
+              "description": "Steps zoom to the previous predefined level and dispatches a 'zoom-step' event."
             },
             {
               "kind": "method",
               "name": "handleZoomReset",
-              "privacy": "private"
+              "privacy": "private",
+              "description": "Dispatches a 'zoom-reset' event to fit the graph to the viewport."
             },
             {
               "kind": "method",
@@ -892,7 +851,8 @@
                     "text": "WheelEvent"
                   }
                 }
-              ]
+              ],
+              "description": "Stops wheel events from propagating to the canvas zoom handler."
             },
             {
               "kind": "method",
@@ -905,7 +865,8 @@
                     "text": "MouseEvent"
                   }
                 }
-              ]
+              ],
+              "description": "Stops mousedown events from propagating to the canvas drag handler."
             }
           ],
           "events": [
@@ -930,6 +891,7 @@
               "type": {
                 "text": "number"
               },
+              "description": "Current absolute zoom level",
               "fieldName": "zoom"
             },
             {
@@ -937,6 +899,7 @@
               "type": {
                 "text": "number"
               },
+              "description": "Baseline zoom level used for ratio display (fit-to-view = 1x)",
               "fieldName": "baseZoom"
             }
           ],
@@ -1132,7 +1095,7 @@
               "description": "Button variant style",
               "default": "'ghost'",
               "attribute": "variant",
-              "expandedType": {
+              "parsedType": {
                 "text": "'ghost' | 'subtle' | 'solid'"
               }
             },
@@ -1145,7 +1108,7 @@
               "description": "Button color scheme",
               "default": "'neutral'",
               "attribute": "color",
-              "expandedType": {
+              "parsedType": {
                 "text": "'neutral' | 'primary' | 'destructive'"
               }
             },
@@ -1158,7 +1121,7 @@
               "description": "Button size",
               "default": "'md'",
               "attribute": "size",
-              "expandedType": {
+              "parsedType": {
                 "text": "'sm' | 'md'"
               }
             },
@@ -1192,7 +1155,7 @@
               "description": "Button variant style",
               "default": "'ghost'",
               "fieldName": "variant",
-              "expandedType": {
+              "parsedType": {
                 "text": "'ghost' | 'subtle' | 'solid'"
               }
             },
@@ -1204,7 +1167,7 @@
               "description": "Button color scheme",
               "default": "'neutral'",
               "fieldName": "color",
-              "expandedType": {
+              "parsedType": {
                 "text": "'neutral' | 'primary' | 'destructive'"
               }
             },
@@ -1216,7 +1179,7 @@
               "description": "Button size",
               "default": "'md'",
               "fieldName": "size",
-              "expandedType": {
+              "parsedType": {
                 "text": "'sm' | 'md'"
               }
             },
@@ -1282,6 +1245,7 @@
               "type": {
                 "text": "string"
               },
+              "description": "Title text displayed in the header",
               "attribute": "title"
             },
             {
@@ -1290,6 +1254,7 @@
               "type": {
                 "text": "boolean"
               },
+              "description": "Whether the sidebar is currently collapsed",
               "attribute": "is-collapsed"
             },
             {
@@ -1298,12 +1263,14 @@
               "type": {
                 "text": "boolean"
               },
+              "description": "Whether any filters are currently active (shows indicator dot)",
               "attribute": "has-active-filters"
             },
             {
               "kind": "method",
               "name": "handleToggle",
-              "privacy": "private"
+              "privacy": "private",
+              "description": "Dispatches the toggle-collapse event when the collapse button is clicked"
             }
           ],
           "events": [
@@ -1321,6 +1288,7 @@
               "type": {
                 "text": "string"
               },
+              "description": "Title text displayed in the header",
               "fieldName": "title"
             },
             {
@@ -1328,6 +1296,7 @@
               "type": {
                 "text": "boolean"
               },
+              "description": "Whether the sidebar is currently collapsed",
               "fieldName": "isCollapsed"
             },
             {
@@ -1335,6 +1304,7 @@
               "type": {
                 "text": "boolean"
               },
+              "description": "Whether any filters are currently active (shows indicator dot)",
               "fieldName": "hasActiveFilters"
             }
           ],
@@ -1368,7 +1338,7 @@
     },
     {
       "kind": "javascript-module",
-      "path": "src/ui/components/collapsed-sidebar.ts",
+      "path": "src/ui/components/right-sidebar-collapsed.ts",
       "declarations": [
         {
           "kind": "class",
@@ -1380,42 +1350,48 @@
               "name": "filteredNodes",
               "type": {
                 "text": "GraphNode[]"
-              }
+              },
+              "description": "Nodes remaining after filter application"
             },
             {
               "kind": "field",
               "name": "filteredEdges",
               "type": {
                 "text": "GraphEdge[]"
-              }
+              },
+              "description": "Edges remaining after filter application"
             },
             {
               "kind": "field",
               "name": "typeCounts",
               "type": {
                 "text": "Map<string, number>"
-              }
+              },
+              "description": "Count of nodes per node type"
             },
             {
               "kind": "field",
               "name": "platformCounts",
               "type": {
                 "text": "Map<string, number>"
-              }
+              },
+              "description": "Count of nodes per platform"
             },
             {
               "kind": "field",
               "name": "projectCounts",
               "type": {
                 "text": "Map<string, number>"
-              }
+              },
+              "description": "Count of nodes per project"
             },
             {
               "kind": "field",
               "name": "packageCounts",
               "type": {
                 "text": "Map<string, number>"
-              }
+              },
+              "description": "Count of nodes per package"
             },
             {
               "kind": "field",
@@ -1423,6 +1399,7 @@
               "type": {
                 "text": "number"
               },
+              "description": "Number of currently selected node type filters",
               "attribute": "node-types-filter-size"
             },
             {
@@ -1431,6 +1408,7 @@
               "type": {
                 "text": "number"
               },
+              "description": "Number of currently selected platform filters",
               "attribute": "platforms-filter-size"
             },
             {
@@ -1439,6 +1417,7 @@
               "type": {
                 "text": "number"
               },
+              "description": "Number of currently selected project filters",
               "attribute": "projects-filter-size"
             },
             {
@@ -1447,6 +1426,7 @@
               "type": {
                 "text": "number"
               },
+              "description": "Number of currently selected package filters",
               "attribute": "packages-filter-size"
             },
             {
@@ -1460,27 +1440,8 @@
                     "text": "string"
                   }
                 }
-              ]
-            },
-            {
-              "kind": "method",
-              "name": "renderProductTypesIcon",
-              "privacy": "private"
-            },
-            {
-              "kind": "method",
-              "name": "renderPlatformsIcon",
-              "privacy": "private"
-            },
-            {
-              "kind": "method",
-              "name": "renderProjectsIcon",
-              "privacy": "private"
-            },
-            {
-              "kind": "method",
-              "name": "renderPackagesIcon",
-              "privacy": "private"
+              ],
+              "description": "Dispatches an event to expand the sidebar to the given filter section"
             }
           ],
           "events": [
@@ -1498,6 +1459,7 @@
               "type": {
                 "text": "number"
               },
+              "description": "Number of currently selected node type filters",
               "fieldName": "nodeTypesFilterSize"
             },
             {
@@ -1505,6 +1467,7 @@
               "type": {
                 "text": "number"
               },
+              "description": "Number of currently selected platform filters",
               "fieldName": "platformsFilterSize"
             },
             {
@@ -1512,6 +1475,7 @@
               "type": {
                 "text": "number"
               },
+              "description": "Number of currently selected project filters",
               "fieldName": "projectsFilterSize"
             },
             {
@@ -1519,6 +1483,7 @@
               "type": {
                 "text": "number"
               },
+              "description": "Number of currently selected package filters",
               "fieldName": "packagesFilterSize"
             }
           ],
@@ -1537,7 +1502,7 @@
           "name": "GraphCollapsedSidebar",
           "declaration": {
             "name": "GraphCollapsedSidebar",
-            "module": "src/ui/components/collapsed-sidebar.ts"
+            "module": "src/ui/components/right-sidebar-collapsed.ts"
           }
         },
         {
@@ -1545,7 +1510,7 @@
           "name": "xcode-graph-collapsed-sidebar",
           "declaration": {
             "name": "GraphCollapsedSidebar",
-            "module": "src/ui/components/collapsed-sidebar.ts"
+            "module": "src/ui/components/right-sidebar-collapsed.ts"
           }
         }
       ]
@@ -1673,7 +1638,8 @@
             {
               "kind": "method",
               "name": "toggleExpanded",
-              "privacy": "private"
+              "privacy": "private",
+              "description": "Toggles the expanded/collapsed state"
             },
             {
               "kind": "field",
@@ -1701,7 +1667,8 @@
                 "type": {
                   "text": "TemplateResult | typeof nothing"
                 }
-              }
+              },
+              "description": "Renders the code signing settings subsection"
             },
             {
               "kind": "method",
@@ -1711,7 +1678,8 @@
                 "type": {
                   "text": "TemplateResult | typeof nothing"
                 }
-              }
+              },
+              "description": "Renders the expanded build settings content"
             }
           ],
           "attributes": [
@@ -1759,7 +1727,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "Reusable stats card component for displaying metrics.\nFeatures bold left accent border and monospace typography.\nCan be toggleable for interactive highlight controls.",
+          "description": "Reusable stats card component for displaying metrics.\nCan be toggleable for interactive highlight controls.",
           "name": "GraphStatsCard",
           "members": [
             {
@@ -1819,7 +1787,8 @@
             {
               "kind": "method",
               "name": "handleClick",
-              "privacy": "private"
+              "privacy": "private",
+              "description": "Dispatches card-toggle event when the card is toggleable and clicked"
             }
           ],
           "events": [
@@ -1924,6 +1893,7 @@
               "type": {
                 "text": "number"
               },
+              "description": "Number of direct dependencies (filtered)",
               "attribute": "dependencies-count"
             },
             {
@@ -1932,6 +1902,7 @@
               "type": {
                 "text": "number"
               },
+              "description": "Number of direct dependents (filtered)",
               "attribute": "dependents-count"
             },
             {
@@ -1940,6 +1911,7 @@
               "type": {
                 "text": "number"
               },
+              "description": "Total number of direct dependencies (unfiltered)",
               "attribute": "total-dependencies-count"
             },
             {
@@ -1948,6 +1920,7 @@
               "type": {
                 "text": "number"
               },
+              "description": "Total number of direct dependents (unfiltered)",
               "attribute": "total-dependents-count"
             },
             {
@@ -1956,6 +1929,7 @@
               "type": {
                 "text": "number"
               },
+              "description": "Number of transitive dependencies",
               "attribute": "transitive-dependencies-count"
             },
             {
@@ -1964,6 +1938,7 @@
               "type": {
                 "text": "number"
               },
+              "description": "Number of transitive dependents",
               "attribute": "transitive-dependents-count"
             },
             {
@@ -1972,6 +1947,7 @@
               "type": {
                 "text": "boolean"
               },
+              "description": "Whether this node has high fan-in (many dependents)",
               "attribute": "is-high-fan-in"
             },
             {
@@ -1980,6 +1956,7 @@
               "type": {
                 "text": "boolean"
               },
+              "description": "Whether this node has high fan-out (many dependencies)",
               "attribute": "is-high-fan-out"
             },
             {
@@ -1988,6 +1965,7 @@
               "type": {
                 "text": "boolean"
               },
+              "description": "Whether the direct dependencies card is toggled on",
               "attribute": "active-direct-deps"
             },
             {
@@ -1996,6 +1974,7 @@
               "type": {
                 "text": "boolean"
               },
+              "description": "Whether the transitive dependencies card is toggled on",
               "attribute": "active-transitive-deps"
             },
             {
@@ -2004,6 +1983,7 @@
               "type": {
                 "text": "boolean"
               },
+              "description": "Whether the direct dependents card is toggled on",
               "attribute": "active-direct-dependents"
             },
             {
@@ -2012,6 +1992,7 @@
               "type": {
                 "text": "boolean"
               },
+              "description": "Whether the transitive dependents card is toggled on",
               "attribute": "active-transitive-dependents"
             },
             {
@@ -2020,6 +2001,7 @@
               "type": {
                 "text": "boolean"
               },
+              "description": "Whether the section starts expanded",
               "default": "true",
               "attribute": "expanded"
             },
@@ -2035,7 +2017,8 @@
             {
               "kind": "method",
               "name": "toggleExpanded",
-              "privacy": "private"
+              "privacy": "private",
+              "description": "Toggles the section expanded/collapsed state"
             },
             {
               "kind": "method",
@@ -2048,7 +2031,8 @@
                     "text": "string"
                   }
                 }
-              ]
+              ],
+              "description": "Dispatches a toggle event for the specified metric card"
             }
           ],
           "events": [
@@ -2081,6 +2065,7 @@
               "type": {
                 "text": "number"
               },
+              "description": "Number of direct dependencies (filtered)",
               "fieldName": "dependenciesCount"
             },
             {
@@ -2088,6 +2073,7 @@
               "type": {
                 "text": "number"
               },
+              "description": "Number of direct dependents (filtered)",
               "fieldName": "dependentsCount"
             },
             {
@@ -2095,6 +2081,7 @@
               "type": {
                 "text": "number"
               },
+              "description": "Total number of direct dependencies (unfiltered)",
               "fieldName": "totalDependenciesCount"
             },
             {
@@ -2102,6 +2089,7 @@
               "type": {
                 "text": "number"
               },
+              "description": "Total number of direct dependents (unfiltered)",
               "fieldName": "totalDependentsCount"
             },
             {
@@ -2109,6 +2097,7 @@
               "type": {
                 "text": "number"
               },
+              "description": "Number of transitive dependencies",
               "fieldName": "transitiveDependenciesCount"
             },
             {
@@ -2116,6 +2105,7 @@
               "type": {
                 "text": "number"
               },
+              "description": "Number of transitive dependents",
               "fieldName": "transitiveDependentsCount"
             },
             {
@@ -2123,6 +2113,7 @@
               "type": {
                 "text": "boolean"
               },
+              "description": "Whether this node has high fan-in (many dependents)",
               "fieldName": "isHighFanIn"
             },
             {
@@ -2130,6 +2121,7 @@
               "type": {
                 "text": "boolean"
               },
+              "description": "Whether this node has high fan-out (many dependencies)",
               "fieldName": "isHighFanOut"
             },
             {
@@ -2137,6 +2129,7 @@
               "type": {
                 "text": "boolean"
               },
+              "description": "Whether the direct dependencies card is toggled on",
               "fieldName": "activeDirectDeps"
             },
             {
@@ -2144,6 +2137,7 @@
               "type": {
                 "text": "boolean"
               },
+              "description": "Whether the transitive dependencies card is toggled on",
               "fieldName": "activeTransitiveDeps"
             },
             {
@@ -2151,6 +2145,7 @@
               "type": {
                 "text": "boolean"
               },
+              "description": "Whether the direct dependents card is toggled on",
               "fieldName": "activeDirectDependents"
             },
             {
@@ -2158,6 +2153,7 @@
               "type": {
                 "text": "boolean"
               },
+              "description": "Whether the transitive dependents card is toggled on",
               "fieldName": "activeTransitiveDependents"
             },
             {
@@ -2165,6 +2161,7 @@
               "type": {
                 "text": "boolean"
               },
+              "description": "Whether the section starts expanded",
               "default": "true",
               "fieldName": "expanded"
             }
@@ -2225,10 +2222,6 @@
             {
               "description": "Border color on hover (computed from color prop)",
               "name": "--badge-border-hover"
-            },
-            {
-              "description": "Glow color on hover (computed from color prop)",
-              "name": "--badge-glow"
             }
           ],
           "members": [
@@ -2259,7 +2252,7 @@
               "description": "Badge shape variant\n- 'pill': Fully rounded (radii-full)\n- 'rounded': Small border radius (radii-sm)\n- 'accent': Small radius with left accent border",
               "default": "'pill'",
               "attribute": "variant",
-              "expandedType": {
+              "parsedType": {
                 "text": "'pill' | 'rounded' | 'accent'"
               }
             },
@@ -2272,7 +2265,7 @@
               "description": "Badge size\n- 'sm': Smaller text (xs), monospace font\n- 'md': Medium text (sm), body font",
               "default": "'md'",
               "attribute": "size",
-              "expandedType": {
+              "parsedType": {
                 "text": "'sm' | 'md'"
               }
             },
@@ -2285,16 +2278,6 @@
               "description": "Whether the badge has interactive hover states",
               "default": "false",
               "attribute": "interactive"
-            },
-            {
-              "kind": "field",
-              "name": "glow",
-              "type": {
-                "text": "boolean"
-              },
-              "description": "Whether to show glow effect on hover",
-              "default": "false",
-              "attribute": "glow"
             }
           ],
           "attributes": [
@@ -2322,7 +2305,7 @@
               "description": "Badge shape variant\n- 'pill': Fully rounded (radii-full)\n- 'rounded': Small border radius (radii-sm)\n- 'accent': Small radius with left accent border",
               "default": "'pill'",
               "fieldName": "variant",
-              "expandedType": {
+              "parsedType": {
                 "text": "'pill' | 'rounded' | 'accent'"
               }
             },
@@ -2334,7 +2317,7 @@
               "description": "Badge size\n- 'sm': Smaller text (xs), monospace font\n- 'md': Medium text (sm), body font",
               "default": "'md'",
               "fieldName": "size",
-              "expandedType": {
+              "parsedType": {
                 "text": "'sm' | 'md'"
               }
             },
@@ -2346,15 +2329,6 @@
               "description": "Whether the badge has interactive hover states",
               "default": "false",
               "fieldName": "interactive"
-            },
-            {
-              "name": "glow",
-              "type": {
-                "text": "boolean"
-              },
-              "description": "Whether to show glow effect on hover",
-              "default": "false",
-              "fieldName": "glow"
             }
           ],
           "superclass": {
@@ -2428,7 +2402,7 @@
               "type": {
                 "text": "string"
               },
-              "description": "Theme color for the icon box glow",
+              "description": "Theme color for the icon box",
               "attribute": "color"
             },
             {
@@ -2444,7 +2418,8 @@
             {
               "kind": "method",
               "name": "handleBack",
-              "privacy": "private"
+              "privacy": "private",
+              "description": "Handles back button click and dispatches back event"
             }
           ],
           "events": [
@@ -2478,7 +2453,7 @@
               "type": {
                 "text": "string"
               },
-              "description": "Theme color for the icon box glow",
+              "description": "Theme color for the icon box",
               "fieldName": "color"
             },
             {
@@ -2555,7 +2530,8 @@
                 "type": {
                   "text": "{ prefix: string; value: string; color: string }"
                 }
-              }
+              },
+              "description": "Splits the tag into prefix and value, returning the associated color"
             }
           ],
           "attributes": [
@@ -2619,7 +2595,8 @@
               "name": "node",
               "type": {
                 "text": "GraphNode"
-              }
+              },
+              "description": "The graph node to display in the header"
             },
             {
               "kind": "field",
@@ -2627,6 +2604,7 @@
               "type": {
                 "text": "number"
               },
+              "description": "Current canvas zoom level for color adjustments",
               "attribute": "zoom"
             },
             {
@@ -2635,13 +2613,15 @@
               "type": {
                 "text": "boolean"
               },
+              "description": "Whether clicking back navigates to the parent cluster instead of closing",
               "default": "true",
               "attribute": "show-cluster-link"
             },
             {
               "kind": "method",
               "name": "handleBack",
-              "privacy": "private"
+              "privacy": "private",
+              "description": "Handles back navigation to parent cluster or dispatches close event"
             }
           ],
           "events": [
@@ -2666,6 +2646,7 @@
               "type": {
                 "text": "number"
               },
+              "description": "Current canvas zoom level for color adjustments",
               "fieldName": "zoom"
             },
             {
@@ -2673,6 +2654,7 @@
               "type": {
                 "text": "boolean"
               },
+              "description": "Whether clicking back navigates to the parent cluster instead of closing",
               "default": "true",
               "fieldName": "showClusterLink"
             }
@@ -2743,12 +2725,14 @@
             {
               "kind": "method",
               "name": "renderPlatformTargets",
-              "privacy": "private"
+              "privacy": "private",
+              "description": "Renders platform minimum OS version badges"
             },
             {
               "kind": "method",
               "name": "renderDestinations",
-              "privacy": "private"
+              "privacy": "private",
+              "description": "Renders destination device type badges"
             }
           ],
           "attributes": [
@@ -2804,7 +2788,8 @@
               "name": "node",
               "type": {
                 "text": "GraphNode"
-              }
+              },
+              "description": "The graph node to display information for"
             },
             {
               "kind": "field",
@@ -2812,6 +2797,7 @@
               "type": {
                 "text": "boolean"
               },
+              "description": "Whether the section starts expanded",
               "default": "true",
               "attribute": "expanded"
             },
@@ -2836,7 +2822,8 @@
             {
               "kind": "method",
               "name": "toggleExpanded",
-              "privacy": "private"
+              "privacy": "private",
+              "description": "Toggles the section expanded/collapsed state"
             },
             {
               "kind": "field",
@@ -2868,7 +2855,8 @@
             {
               "kind": "method",
               "name": "renderForeignBuild",
-              "privacy": "private"
+              "privacy": "private",
+              "description": "Renders the foreign build details section if present"
             },
             {
               "kind": "method",
@@ -2878,7 +2866,8 @@
                 "type": {
                   "text": "TemplateResult"
                 }
-              }
+              },
+              "description": "Renders the expanded node info rows and subsections"
             }
           ],
           "attributes": [
@@ -2887,6 +2876,7 @@
               "type": {
                 "text": "boolean"
               },
+              "description": "Whether the section starts expanded",
               "default": "true",
               "fieldName": "expanded"
             }
@@ -2925,7 +2915,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "Reusable row component for displaying nodes in lists.\nFeatures sharp edges, accent borders, and monospace typography.",
+          "description": "Reusable row component for displaying nodes in lists.",
           "name": "GraphListItemRow",
           "members": [
             {
@@ -2933,7 +2923,8 @@
               "name": "node",
               "type": {
                 "text": "GraphNode"
-              }
+              },
+              "description": "The graph node to display in this row"
             },
             {
               "kind": "field",
@@ -2941,6 +2932,7 @@
               "type": {
                 "text": "string"
               },
+              "description": "Optional subtitle text shown below the node name",
               "attribute": "subtitle"
             },
             {
@@ -2949,6 +2941,7 @@
               "type": {
                 "text": "number"
               },
+              "description": "Current canvas zoom level for color adjustments",
               "default": "1",
               "attribute": "zoom"
             },
@@ -2958,6 +2951,7 @@
               "type": {
                 "text": "boolean"
               },
+              "description": "Whether this row is currently selected",
               "attribute": "is-selected"
             },
             {
@@ -2971,17 +2965,20 @@
             {
               "kind": "method",
               "name": "handleClick",
-              "privacy": "private"
+              "privacy": "private",
+              "description": "Handles row click and dispatches row-select event"
             },
             {
               "kind": "method",
               "name": "handleMouseEnter",
-              "privacy": "private"
+              "privacy": "private",
+              "description": "Handles mouse enter and dispatches row-hover event"
             },
             {
               "kind": "method",
               "name": "handleMouseLeave",
-              "privacy": "private"
+              "privacy": "private",
+              "description": "Handles mouse leave and dispatches row-hover-end event"
             }
           ],
           "events": [
@@ -3013,6 +3010,7 @@
               "type": {
                 "text": "string"
               },
+              "description": "Optional subtitle text shown below the node name",
               "fieldName": "subtitle"
             },
             {
@@ -3020,6 +3018,7 @@
               "type": {
                 "text": "number"
               },
+              "description": "Current canvas zoom level for color adjustments",
               "default": "1",
               "fieldName": "zoom"
             },
@@ -3028,6 +3027,7 @@
               "type": {
                 "text": "boolean"
               },
+              "description": "Whether this row is currently selected",
               "fieldName": "isSelected"
             }
           ],
@@ -3061,7 +3061,7 @@
     },
     {
       "kind": "javascript-module",
-      "path": "src/ui/components/node-list-events.ts",
+      "path": "src/ui/components/node-list-base.ts",
       "declarations": [
         {
           "kind": "class",
@@ -3145,7 +3145,7 @@
           "name": "NodeListEventsBase",
           "declaration": {
             "name": "NodeListEventsBase",
-            "module": "src/ui/components/node-list-events.ts"
+            "module": "src/ui/components/node-list-base.ts"
           }
         }
       ]
@@ -3237,7 +3237,8 @@
             {
               "kind": "method",
               "name": "toggleExpanded",
-              "privacy": "private"
+              "privacy": "private",
+              "description": "Toggles the list expanded/collapsed state"
             },
             {
               "kind": "field",
@@ -3246,26 +3247,9 @@
                 "text": "NodeWithEdge[]"
               },
               "privacy": "private",
+              "description": "Returns the resolved item list, supporting both items and legacy nodes props",
               "readonly": true
             },
-            {
-              "kind": "method",
-              "name": "getNodeSubtitle",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "string"
-                }
-              },
-              "parameters": [
-                {
-                  "name": "node",
-                  "type": {
-                    "text": "GraphNode"
-                  }
-                }
-              ]
-            },
             {
               "kind": "method",
               "name": "renderKindBadge",
@@ -3277,7 +3261,8 @@
                     "text": "NodeWithEdge"
                   }
                 }
-              ]
+              ],
+              "description": "Renders a dependency kind badge for the given item"
             },
             {
               "kind": "method",
@@ -3299,7 +3284,7 @@
               "description": "Forward node selection event",
               "inheritedFrom": {
                 "name": "NodeListEventsBase",
-                "module": "src/ui/components/node-list-events.ts"
+                "module": "src/ui/components/node-list-base.ts"
               }
             },
             {
@@ -3322,7 +3307,7 @@
               "description": "Forward node hover event",
               "inheritedFrom": {
                 "name": "NodeListEventsBase",
-                "module": "src/ui/components/node-list-events.ts"
+                "module": "src/ui/components/node-list-base.ts"
               }
             },
             {
@@ -3337,7 +3322,7 @@
               "description": "Handle hover end - dispatch with null nodeId",
               "inheritedFrom": {
                 "name": "NodeListEventsBase",
-                "module": "src/ui/components/node-list-events.ts"
+                "module": "src/ui/components/node-list-base.ts"
               }
             }
           ],
@@ -3350,7 +3335,7 @@
               "description": "Dispatched when a node row is clicked (detail: { node })",
               "inheritedFrom": {
                 "name": "NodeListEventsBase",
-                "module": "src/ui/components/node-list-events.ts"
+                "module": "src/ui/components/node-list-base.ts"
               }
             },
             {
@@ -3361,7 +3346,7 @@
               "description": "Dispatched on node row hover (detail: { nodeId })",
               "inheritedFrom": {
                 "name": "NodeListEventsBase",
-                "module": "src/ui/components/node-list-events.ts"
+                "module": "src/ui/components/node-list-base.ts"
               }
             }
           ],
@@ -3414,7 +3399,7 @@
           ],
           "superclass": {
             "name": "NodeListEventsBase",
-            "module": "/src/ui/components/node-list-events"
+            "module": "/src/ui/components/node-list-base"
           },
           "summary": "Collapsible node list with section header and kind badges",
           "tagName": "xcode-graph-node-list",
@@ -3455,7 +3440,8 @@
               "privacy": "public",
               "type": {
                 "text": "GraphNode"
-              }
+              },
+              "description": "The node to display details for"
             },
             {
               "kind": "field",
@@ -3463,7 +3449,8 @@
               "privacy": "public",
               "type": {
                 "text": "GraphNode[]"
-              }
+              },
+              "description": "All nodes in the graph (for dependency resolution)"
             },
             {
               "kind": "field",
@@ -3471,7 +3458,8 @@
               "privacy": "public",
               "type": {
                 "text": "GraphEdge[]"
-              }
+              },
+              "description": "All edges in the graph"
             },
             {
               "kind": "field",
@@ -3479,7 +3467,8 @@
               "privacy": "public",
               "type": {
                 "text": "GraphEdge[] | undefined"
-              }
+              },
+              "description": "Edges remaining after filter application"
             },
             {
               "kind": "field",
@@ -3487,7 +3476,8 @@
               "privacy": "public",
               "type": {
                 "text": "Cluster[] | undefined"
-              }
+              },
+              "description": "Available clusters for cluster navigation"
             },
             {
               "kind": "field",
@@ -3496,6 +3486,7 @@
               "type": {
                 "text": "boolean"
               },
+              "description": "Whether direct dependencies highlighting is active",
               "attribute": "active-direct-deps"
             },
             {
@@ -3505,6 +3496,7 @@
               "type": {
                 "text": "boolean"
               },
+              "description": "Whether transitive dependencies highlighting is active",
               "attribute": "active-transitive-deps"
             },
             {
@@ -3514,6 +3506,7 @@
               "type": {
                 "text": "boolean"
               },
+              "description": "Whether direct dependents highlighting is active",
               "attribute": "active-direct-dependents"
             },
             {
@@ -3523,6 +3516,7 @@
               "type": {
                 "text": "boolean"
               },
+              "description": "Whether transitive dependents highlighting is active",
               "attribute": "active-transitive-dependents"
             },
             {
@@ -3532,6 +3526,7 @@
               "type": {
                 "text": "number"
               },
+              "description": "Current canvas zoom level for color adjustments",
               "attribute": "zoom"
             },
             {
@@ -3539,7 +3534,7 @@
               "name": "focusTrap",
               "privacy": "private",
               "readonly": true,
-              "default": "new FocusTrapController(this, { isActive: () => !!this.node, onDeactivate: () => this.bubbleEvent('close'), escapeDeactivates: true, clickOutsideDeactivates: true, })"
+              "default": "new FocusTrapController(this, { isActive: () => Boolean(this.node), onDeactivate: () => this.bubbleEvent('close'), escapeDeactivates: true, clickOutsideDeactivates: true, })"
             },
             {
               "kind": "field",
@@ -3565,7 +3560,8 @@
                     "text": "unknown"
                   }
                 }
-              ]
+              ],
+              "description": "Dispatches a composed bubbling custom event with the given name and detail"
             }
           ],
           "events": [
@@ -3614,6 +3610,7 @@
               "type": {
                 "text": "boolean"
               },
+              "description": "Whether direct dependencies highlighting is active",
               "fieldName": "activeDirectDeps"
             },
             {
@@ -3621,6 +3618,7 @@
               "type": {
                 "text": "boolean"
               },
+              "description": "Whether transitive dependencies highlighting is active",
               "fieldName": "activeTransitiveDeps"
             },
             {
@@ -3628,6 +3626,7 @@
               "type": {
                 "text": "boolean"
               },
+              "description": "Whether direct dependents highlighting is active",
               "fieldName": "activeDirectDependents"
             },
             {
@@ -3635,6 +3634,7 @@
               "type": {
                 "text": "boolean"
               },
+              "description": "Whether transitive dependents highlighting is active",
               "fieldName": "activeTransitiveDependents"
             },
             {
@@ -3642,6 +3642,7 @@
               "type": {
                 "text": "number"
               },
+              "description": "Current canvas zoom level for color adjustments",
               "fieldName": "zoom"
             }
           ],
@@ -3808,7 +3809,8 @@
             {
               "kind": "method",
               "name": "toggleExpanded",
-              "privacy": "private"
+              "privacy": "private",
+              "description": "Toggles the expanded/collapsed state"
             },
             {
               "kind": "field",
@@ -3919,6 +3921,7 @@
               "type": {
                 "text": "string"
               },
+              "description": "Display name of the cluster",
               "attribute": "cluster-name"
             },
             {
@@ -3927,6 +3930,7 @@
               "type": {
                 "text": "'package' | 'project'"
               },
+              "description": "Whether this cluster is a package or project",
               "attribute": "cluster-type"
             },
             {
@@ -3935,6 +3939,7 @@
               "type": {
                 "text": "string"
               },
+              "description": "Accent color for the cluster icon and badges",
               "attribute": "cluster-color"
             },
             {
@@ -3943,6 +3948,7 @@
               "type": {
                 "text": "string"
               },
+              "description": "Filesystem path to the cluster source (used for source type detection and copy)",
               "attribute": "cluster-path"
             },
             {
@@ -3951,6 +3957,7 @@
               "type": {
                 "text": "boolean"
               },
+              "description": "Whether the cluster comes from an external dependency",
               "attribute": "is-external"
             },
             {
@@ -3970,7 +3977,8 @@
                 "type": {
                   "text": "SourceType"
                 }
-              }
+              },
+              "description": "Determines the source type (Local/Registry/Git) from the cluster path"
             },
             {
               "kind": "method",
@@ -3980,12 +3988,14 @@
                 "type": {
                   "text": "string"
                 }
-              }
+              },
+              "description": "Extracts a shortened display path from the full cluster path"
             },
             {
               "kind": "method",
               "name": "handleCopyPath",
-              "privacy": "private"
+              "privacy": "private",
+              "description": "Copies the full cluster path to the clipboard"
             }
           ],
           "events": [
@@ -4000,6 +4010,7 @@
               "type": {
                 "text": "string"
               },
+              "description": "Display name of the cluster",
               "fieldName": "clusterName"
             },
             {
@@ -4007,6 +4018,7 @@
               "type": {
                 "text": "'package' | 'project'"
               },
+              "description": "Whether this cluster is a package or project",
               "fieldName": "clusterType"
             },
             {
@@ -4014,6 +4026,7 @@
               "type": {
                 "text": "string"
               },
+              "description": "Accent color for the cluster icon and badges",
               "fieldName": "clusterColor"
             },
             {
@@ -4021,6 +4034,7 @@
               "type": {
                 "text": "string"
               },
+              "description": "Filesystem path to the cluster source (used for source type detection and copy)",
               "fieldName": "clusterPath"
             },
             {
@@ -4028,6 +4042,7 @@
               "type": {
                 "text": "boolean"
               },
+              "description": "Whether the cluster comes from an external dependency",
               "fieldName": "isExternal"
             }
           ],
@@ -4074,6 +4089,7 @@
               "type": {
                 "text": "number"
               },
+              "description": "Number of dependencies visible after filtering",
               "attribute": "filtered-dependencies"
             },
             {
@@ -4082,6 +4098,7 @@
               "type": {
                 "text": "number"
               },
+              "description": "Total number of dependencies before filtering",
               "attribute": "total-dependencies"
             },
             {
@@ -4090,6 +4107,7 @@
               "type": {
                 "text": "number"
               },
+              "description": "Number of dependents visible after filtering",
               "attribute": "filtered-dependents"
             },
             {
@@ -4098,6 +4116,7 @@
               "type": {
                 "text": "number"
               },
+              "description": "Total number of dependents before filtering",
               "attribute": "total-dependents"
             },
             {
@@ -4106,6 +4125,7 @@
               "type": {
                 "text": "boolean"
               },
+              "description": "Whether the direct dependencies card is toggled on",
               "attribute": "active-direct-deps"
             },
             {
@@ -4114,6 +4134,7 @@
               "type": {
                 "text": "boolean"
               },
+              "description": "Whether the direct dependents card is toggled on",
               "attribute": "active-direct-dependents"
             },
             {
@@ -4121,7 +4142,8 @@
               "name": "platforms",
               "type": {
                 "text": "Set<string>"
-              }
+              },
+              "description": "Set of platform names present in this cluster"
             },
             {
               "kind": "field",
@@ -4137,6 +4159,7 @@
               "type": {
                 "text": "boolean"
               },
+              "description": "Whether the section starts expanded",
               "default": "true",
               "attribute": "expanded"
             },
@@ -4152,7 +4175,8 @@
             {
               "kind": "method",
               "name": "toggleExpanded",
-              "privacy": "private"
+              "privacy": "private",
+              "description": "Toggles the expanded/collapsed state"
             },
             {
               "kind": "method",
@@ -4165,12 +4189,14 @@
                     "text": "string"
                   }
                 }
-              ]
+              ],
+              "description": "Dispatches a toggle event for the given stats card"
             },
             {
               "kind": "method",
               "name": "renderTargetBreakdown",
-              "privacy": "private"
+              "privacy": "private",
+              "description": "Renders the target type breakdown badges"
             },
             {
               "kind": "method",
@@ -4180,7 +4206,8 @@
                 "type": {
                   "text": "TemplateResult"
                 }
-              }
+              },
+              "description": "Renders the expanded stats content with cards and breakdowns"
             }
           ],
           "events": [
@@ -4205,6 +4232,7 @@
               "type": {
                 "text": "number"
               },
+              "description": "Number of dependencies visible after filtering",
               "fieldName": "filteredDependencies"
             },
             {
@@ -4212,6 +4240,7 @@
               "type": {
                 "text": "number"
               },
+              "description": "Total number of dependencies before filtering",
               "fieldName": "totalDependencies"
             },
             {
@@ -4219,6 +4248,7 @@
               "type": {
                 "text": "number"
               },
+              "description": "Number of dependents visible after filtering",
               "fieldName": "filteredDependents"
             },
             {
@@ -4226,6 +4256,7 @@
               "type": {
                 "text": "number"
               },
+              "description": "Total number of dependents before filtering",
               "fieldName": "totalDependents"
             },
             {
@@ -4233,6 +4264,7 @@
               "type": {
                 "text": "boolean"
               },
+              "description": "Whether the direct dependencies card is toggled on",
               "fieldName": "activeDirectDeps"
             },
             {
@@ -4240,6 +4272,7 @@
               "type": {
                 "text": "boolean"
               },
+              "description": "Whether the direct dependents card is toggled on",
               "fieldName": "activeDirectDependents"
             },
             {
@@ -4247,6 +4280,7 @@
               "type": {
                 "text": "boolean"
               },
+              "description": "Whether the section starts expanded",
               "default": "true",
               "fieldName": "expanded"
             }
@@ -4293,14 +4327,16 @@
               "name": "clusterNodes",
               "type": {
                 "text": "GraphNode[]"
-              }
+              },
+              "description": "All nodes belonging to this cluster"
             },
             {
               "kind": "field",
               "name": "nodesByType",
               "type": {
                 "text": "Record<string, GraphNode[]>"
-              }
+              },
+              "description": "Nodes grouped by their type (e.g., framework, library)"
             },
             {
               "kind": "field",
@@ -4308,6 +4344,7 @@
               "type": {
                 "text": "number"
               },
+              "description": "Number of targets visible after filtering",
               "attribute": "filtered-targets-count"
             },
             {
@@ -4316,6 +4353,7 @@
               "type": {
                 "text": "number"
               },
+              "description": "Total number of targets in the cluster",
               "attribute": "total-targets-count"
             },
             {
@@ -4323,7 +4361,8 @@
               "name": "edges",
               "type": {
                 "text": "GraphEdge[]"
-              }
+              },
+              "description": "All edges in the graph (for dependency counting)"
             },
             {
               "kind": "field",
@@ -4331,6 +4370,7 @@
               "type": {
                 "text": "number"
               },
+              "description": "Current canvas zoom level for color adjustments",
               "attribute": "zoom"
             },
             {
@@ -4355,7 +4395,8 @@
             {
               "kind": "method",
               "name": "toggleExpanded",
-              "privacy": "private"
+              "privacy": "private",
+              "description": "Toggles the expanded/collapsed state"
             },
             {
               "kind": "field",
@@ -4374,7 +4415,8 @@
                 "type": {
                   "text": "ClusterListItem[]"
                 }
-              }
+              },
+              "description": "Builds a flat list of headers and nodes for virtualized rendering"
             },
             {
               "kind": "method",
@@ -4392,7 +4434,8 @@
                     "text": "{\n    dependencies: number;\n    dependents: number;\n  }"
                   }
                 }
-              ]
+              ],
+              "description": "Formats dependency and dependent counts into a subtitle string"
             },
             {
               "kind": "method",
@@ -4414,7 +4457,7 @@
               "description": "Forward node selection event",
               "inheritedFrom": {
                 "name": "NodeListEventsBase",
-                "module": "src/ui/components/node-list-events.ts"
+                "module": "src/ui/components/node-list-base.ts"
               }
             },
             {
@@ -4437,7 +4480,7 @@
               "description": "Forward node hover event",
               "inheritedFrom": {
                 "name": "NodeListEventsBase",
-                "module": "src/ui/components/node-list-events.ts"
+                "module": "src/ui/components/node-list-base.ts"
               }
             },
             {
@@ -4452,7 +4495,7 @@
               "description": "Handle hover end - dispatch with null nodeId",
               "inheritedFrom": {
                 "name": "NodeListEventsBase",
-                "module": "src/ui/components/node-list-events.ts"
+                "module": "src/ui/components/node-list-base.ts"
               }
             }
           ],
@@ -4465,7 +4508,7 @@
               "description": "Dispatched when a target is clicked (detail: { node })",
               "inheritedFrom": {
                 "name": "NodeListEventsBase",
-                "module": "src/ui/components/node-list-events.ts"
+                "module": "src/ui/components/node-list-base.ts"
               }
             },
             {
@@ -4476,7 +4519,7 @@
               "description": "Dispatched on hover (detail: { nodeId })",
               "inheritedFrom": {
                 "name": "NodeListEventsBase",
-                "module": "src/ui/components/node-list-events.ts"
+                "module": "src/ui/components/node-list-base.ts"
               }
             }
           ],
@@ -4486,6 +4529,7 @@
               "type": {
                 "text": "number"
               },
+              "description": "Number of targets visible after filtering",
               "fieldName": "filteredTargetsCount"
             },
             {
@@ -4493,6 +4537,7 @@
               "type": {
                 "text": "number"
               },
+              "description": "Total number of targets in the cluster",
               "fieldName": "totalTargetsCount"
             },
             {
@@ -4500,6 +4545,7 @@
               "type": {
                 "text": "number"
               },
+              "description": "Current canvas zoom level for color adjustments",
               "fieldName": "zoom"
             },
             {
@@ -4514,7 +4560,7 @@
           ],
           "superclass": {
             "name": "NodeListEventsBase",
-            "module": "/src/ui/components/node-list-events"
+            "module": "/src/ui/components/node-list-base"
           },
           "summary": "Collapsible cluster targets list grouped by node type",
           "tagName": "xcode-graph-cluster-targets-list",
@@ -4554,35 +4600,40 @@
               "name": "cluster",
               "type": {
                 "text": "Cluster"
-              }
+              },
+              "description": "The cluster to display details for"
             },
             {
               "kind": "field",
               "name": "clusterNodes",
               "type": {
                 "text": "GraphNode[]"
-              }
+              },
+              "description": "Nodes belonging to this cluster"
             },
             {
               "kind": "field",
               "name": "allNodes",
               "type": {
                 "text": "GraphNode[]"
-              }
+              },
+              "description": "All nodes in the graph (for dependency resolution)"
             },
             {
               "kind": "field",
               "name": "edges",
               "type": {
                 "text": "GraphEdge[]"
-              }
+              },
+              "description": "All edges in the graph"
             },
             {
               "kind": "field",
               "name": "filteredEdges",
               "type": {
                 "text": "GraphEdge[] | undefined"
-              }
+              },
+              "description": "Edges remaining after filter application"
             },
             {
               "kind": "field",
@@ -4590,6 +4641,7 @@
               "type": {
                 "text": "boolean"
               },
+              "description": "Whether direct dependencies highlighting is active",
               "attribute": "active-direct-deps"
             },
             {
@@ -4598,6 +4650,7 @@
               "type": {
                 "text": "boolean"
               },
+              "description": "Whether direct dependents highlighting is active",
               "attribute": "active-direct-dependents"
             },
             {
@@ -4606,6 +4659,7 @@
               "type": {
                 "text": "number"
               },
+              "description": "Current canvas zoom level for color adjustments",
               "attribute": "zoom"
             },
             {
@@ -4613,7 +4667,7 @@
               "name": "focusTrap",
               "privacy": "private",
               "readonly": true,
-              "default": "new FocusTrapController(this, { isActive: () => !!this.cluster, onDeactivate: () => this.bubbleEvent('close'), escapeDeactivates: true, clickOutsideDeactivates: true, })"
+              "default": "new FocusTrapController(this, { isActive: () => Boolean(this.cluster), onDeactivate: () => this.bubbleEvent('close'), escapeDeactivates: true, clickOutsideDeactivates: true, })"
             },
             {
               "kind": "field",
@@ -4654,7 +4708,8 @@
                     "text": "unknown"
                   }
                 }
-              ]
+              ],
+              "description": "Dispatches a bubbling composed custom event"
             }
           ],
           "events": [
@@ -4683,6 +4738,7 @@
               "type": {
                 "text": "boolean"
               },
+              "description": "Whether direct dependencies highlighting is active",
               "fieldName": "activeDirectDeps"
             },
             {
@@ -4690,6 +4746,7 @@
               "type": {
                 "text": "boolean"
               },
+              "description": "Whether direct dependents highlighting is active",
               "fieldName": "activeDirectDependents"
             },
             {
@@ -4697,6 +4754,7 @@
               "type": {
                 "text": "number"
               },
+              "description": "Current canvas zoom level for color adjustments",
               "fieldName": "zoom"
             }
           ],
@@ -4749,7 +4807,8 @@
             {
               "kind": "method",
               "name": "handleClick",
-              "privacy": "private"
+              "privacy": "private",
+              "description": "Handles the click event and dispatches clear-filters"
             }
           ],
           "events": [
@@ -4805,7 +4864,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "Input field for filtering nodes by name/text search.\nFeatures sharp edges, dramatic focus glow, and animated icon.",
+          "description": "Input field for filtering nodes by name/text search.",
           "name": "GraphSearchBar",
           "members": [
             {
@@ -4854,12 +4913,14 @@
                     "text": "Event"
                   }
                 }
-              ]
+              ],
+              "description": "Dispatches search-change with the current input value"
             },
             {
               "kind": "method",
               "name": "handleClear",
-              "privacy": "private"
+              "privacy": "private",
+              "description": "Dispatches search-clear to reset the search input"
             },
             {
               "kind": "method",
@@ -4872,7 +4933,8 @@
                     "text": "KeyboardEvent"
                   }
                 }
-              ]
+              ],
+              "description": "Clears the search and blurs the input when Escape is pressed"
             }
           ],
           "events": [
@@ -4950,6 +5012,7 @@
               "type": {
                 "text": "string"
               },
+              "description": "Unique section identifier",
               "attribute": "id"
             },
             {
@@ -4958,6 +5021,7 @@
               "type": {
                 "text": "string"
               },
+              "description": "Display title for the section header",
               "attribute": "title"
             },
             {
@@ -4966,6 +5030,7 @@
               "type": {
                 "text": "string"
               },
+              "description": "Icon name for the section header slot",
               "attribute": "icon-name"
             },
             {
@@ -4974,6 +5039,7 @@
               "type": {
                 "text": "boolean"
               },
+              "description": "Whether the section is currently expanded",
               "attribute": "is-expanded"
             },
             {
@@ -4981,14 +5047,16 @@
               "name": "items",
               "type": {
                 "text": "FilterItem[]"
-              }
+              },
+              "description": "Filter items to display as toggleable checkboxes"
             },
             {
               "kind": "field",
               "name": "selectedItems",
               "type": {
                 "text": "Set<string>"
-              }
+              },
+              "description": "Set of currently selected item keys"
             },
             {
               "kind": "field",
@@ -4996,9 +5064,10 @@
               "type": {
                 "text": "FilterType"
               },
+              "description": "The type of filter this section controls",
               "attribute": "filter-type",
-              "expandedType": {
-                "text": "'nodeType' | 'platform' | 'project' | 'package'"
+              "parsedType": {
+                "text": "'platform' | 'project' | 'nodeType' | 'package'"
               }
             },
             {
@@ -5007,12 +5076,14 @@
               "type": {
                 "text": "number"
               },
+              "description": "Current canvas zoom level for color adjustments",
               "attribute": "zoom"
             },
             {
               "kind": "method",
               "name": "handleToggle",
-              "privacy": "private"
+              "privacy": "private",
+              "description": "Dispatches section-toggle event when header is clicked"
             },
             {
               "kind": "method",
@@ -5031,7 +5102,8 @@
                     "text": "boolean"
                   }
                 }
-              ]
+              ],
+              "description": "Dispatches item-toggle event when a checkbox item is toggled"
             },
             {
               "kind": "method",
@@ -5044,7 +5116,8 @@
                     "text": "FilterItem | null"
                   }
                 }
-              ]
+              ],
+              "description": "Dispatches preview-change event on item hover for filter preview"
             },
             {
               "kind": "method",
@@ -5069,7 +5142,8 @@
                     "text": "string"
                   }
                 }
-              ]
+              ],
+              "description": "Renders the appropriate icon for a filter item based on filter type"
             },
             {
               "kind": "method",
@@ -5082,7 +5156,8 @@
                     "text": "FilterItem"
                   }
                 }
-              ]
+              ],
+              "description": "Renders a single filter item as a toggleable button"
             }
           ],
           "events": [
@@ -5114,6 +5189,7 @@
               "type": {
                 "text": "string"
               },
+              "description": "Unique section identifier",
               "fieldName": "id"
             },
             {
@@ -5121,6 +5197,7 @@
               "type": {
                 "text": "string"
               },
+              "description": "Display title for the section header",
               "fieldName": "title"
             },
             {
@@ -5128,6 +5205,7 @@
               "type": {
                 "text": "string"
               },
+              "description": "Icon name for the section header slot",
               "fieldName": "iconName"
             },
             {
@@ -5135,6 +5213,7 @@
               "type": {
                 "text": "boolean"
               },
+              "description": "Whether the section is currently expanded",
               "fieldName": "isExpanded"
             },
             {
@@ -5142,9 +5221,10 @@
               "type": {
                 "text": "FilterType"
               },
+              "description": "The type of filter this section controls",
               "fieldName": "filterType",
-              "expandedType": {
-                "text": "'nodeType' | 'platform' | 'project' | 'package'"
+              "parsedType": {
+                "text": "'platform' | 'project' | 'nodeType' | 'package'"
               }
             },
             {
@@ -5152,6 +5232,7 @@
               "type": {
                 "text": "number"
               },
+              "description": "Current canvas zoom level for color adjustments",
               "fieldName": "zoom"
             }
           ],
@@ -5204,17 +5285,8 @@
             {
               "kind": "method",
               "name": "handleClearFilters",
-              "privacy": "private"
-            },
-            {
-              "kind": "method",
-              "name": "renderSearchIcon",
-              "privacy": "private"
-            },
-            {
-              "kind": "method",
-              "name": "renderClearIcon",
-              "privacy": "private"
+              "privacy": "private",
+              "description": "Handles the clear filters button click"
             }
           ],
           "events": [
@@ -5278,35 +5350,40 @@
               "name": "allNodes",
               "type": {
                 "text": "GraphNode[]"
-              }
+              },
+              "description": "All nodes in the graph (unfiltered)"
             },
             {
               "kind": "field",
               "name": "allEdges",
               "type": {
                 "text": "GraphEdge[]"
-              }
+              },
+              "description": "All edges in the graph (unfiltered)"
             },
             {
               "kind": "field",
               "name": "filteredNodes",
               "type": {
                 "text": "GraphNode[]"
-              }
+              },
+              "description": "Nodes remaining after filter and search application"
             },
             {
               "kind": "field",
               "name": "filteredEdges",
               "type": {
                 "text": "GraphEdge[]"
-              }
+              },
+              "description": "Edges remaining after filter and search application"
             },
             {
               "kind": "field",
               "name": "clusters",
               "type": {
                 "text": "Cluster[] | undefined"
-              }
+              },
+              "description": "Available clusters from the layout engine"
             },
             {
               "kind": "field",
@@ -5342,7 +5419,8 @@
                     "text": "string | null"
                   }
                 }
-              ]
+              ],
+              "description": "Finds an existing cluster or synthesizes one from matching nodes"
             },
             {
               "kind": "field",
@@ -5383,12 +5461,14 @@
                     "text": "string"
                   }
                 }
-              ]
+              ],
+              "description": "Updates the global search query signal when the search bar value changes."
             },
             {
               "kind": "method",
               "name": "handleClearFilters",
-              "privacy": "private"
+              "privacy": "private",
+              "description": "Resets all filters and clears the search query"
             },
             {
               "kind": "method",
@@ -5413,7 +5493,8 @@
                     "text": "boolean"
                   }
                 }
-              ]
+              ],
+              "description": "Toggles a single filter item on or off within its filter category"
             },
             {
               "kind": "method",
@@ -5426,12 +5507,14 @@
                     "text": "PreviewFilter"
                   }
                 }
-              ]
+              ],
+              "description": "Updates the global preview filter signal to highlight matching nodes on the canvas."
             },
             {
               "kind": "method",
               "name": "handleToggleCollapse",
-              "privacy": "private"
+              "privacy": "private",
+              "description": "Toggles the sidebar between collapsed and expanded states"
             },
             {
               "kind": "method",
@@ -5444,7 +5527,8 @@
                     "text": "SidebarSection"
                   }
                 }
-              ]
+              ],
+              "description": "Toggles a filter section between expanded and collapsed"
             },
             {
               "kind": "method",
@@ -5457,7 +5541,8 @@
                     "text": "SidebarSection"
                   }
                 }
-              ]
+              ],
+              "description": "Expands the sidebar, clears selection, and scrolls to the given filter section"
             },
             {
               "kind": "method",
@@ -5470,7 +5555,8 @@
                     "text": "ReturnType<typeof filters.get>"
                   }
                 }
-              ]
+              ],
+              "description": "Renders the collapsed sidebar icon bar with filter badges"
             },
             {
               "kind": "method",
@@ -5495,7 +5581,8 @@
                     "text": "{\n      activeDirectDeps: boolean;\n      activeTransitiveDeps: boolean;\n      activeDirectDependents: boolean;\n      activeTransitiveDependents: boolean;\n    }"
                   }
                 }
-              ]
+              ],
+              "description": "Renders the node details panel with dependency highlight toggles"
             },
             {
               "kind": "method",
@@ -5520,7 +5607,8 @@
                     "text": "{\n      activeDirectDeps: boolean;\n      activeDirectDependents: boolean;\n    }"
                   }
                 }
-              ]
+              ],
+              "description": "Renders the cluster details panel with dependency highlight toggles"
             },
             {
               "kind": "method",
@@ -5533,7 +5621,8 @@
                     "text": "FilterViewOptions"
                   }
                 }
-              ]
+              ],
+              "description": "Renders the filter view with search bar, stats, and filter sections"
             },
             {
               "kind": "method",
@@ -5564,17 +5653,20 @@
                     "text": "FilterItemsGroup"
                   }
                 }
-              ]
+              ],
+              "description": "Renders the product types, platforms, projects, and packages filter sections"
             },
             {
               "kind": "method",
               "name": "handleBackToFilters",
-              "privacy": "private"
+              "privacy": "private",
+              "description": "Clears both node and cluster selection to return to the filter view."
             },
             {
               "kind": "method",
               "name": "renderDetailsToolbar",
-              "privacy": "private"
+              "privacy": "private",
+              "description": "Renders the toolbar with back-to-filters breadcrumb and collapse button"
             },
             {
               "kind": "method",
@@ -5587,7 +5679,8 @@
                     "text": "ExpandedContentOptions"
                   }
                 }
-              ]
+              ],
+              "description": "Renders expanded content: node details, cluster details, or filter view"
             }
           ],
           "superclass": {
@@ -5646,63 +5739,72 @@
               "name": "displayNodes",
               "type": {
                 "text": "GraphNode[]"
-              }
+              },
+              "description": "Nodes to render on the canvas (after search/filter/highlight processing)"
             },
             {
               "kind": "field",
               "name": "displayEdges",
               "type": {
                 "text": "GraphEdge[]"
-              }
+              },
+              "description": "Edges to render on the canvas (after search/filter/highlight processing)"
             },
             {
               "kind": "field",
               "name": "filteredNodes",
               "type": {
                 "text": "GraphNode[]"
-              }
+              },
+              "description": "Nodes remaining after filter application (for sidebar stats)"
             },
             {
               "kind": "field",
               "name": "filteredEdges",
               "type": {
                 "text": "GraphEdge[]"
-              }
+              },
+              "description": "Edges remaining after filter application (for sidebar stats)"
             },
             {
               "kind": "field",
               "name": "allNodes",
               "type": {
                 "text": "GraphNode[]"
-              }
+              },
+              "description": "All nodes in the graph (unfiltered, for sidebar filter computation)"
             },
             {
               "kind": "field",
               "name": "allEdges",
               "type": {
                 "text": "GraphEdge[]"
-              }
+              },
+              "description": "All edges in the graph (unfiltered, for sidebar filter computation)"
             },
             {
               "kind": "field",
               "name": "clusters",
               "type": {
                 "text": "Cluster[] | undefined"
-              }
+              },
+              "description": "Available clusters from the layout engine"
             },
             {
               "kind": "field",
               "name": "transitiveDeps",
               "type": {
                 "text": "TransitiveResult"
-              }
+              },
+              "description": "Transitive dependency chain for the selected node"
             },
             {
               "kind": "field",
               "name": "transitiveDependents",
               "type": {
                 "text": "TransitiveResult"
-              }
+              },
+              "description": "Transitive dependent chain for the selected node"
             },
             {
               "kind": "method",
@@ -5833,6 +5935,7 @@
               "type": {
                 "text": "AppError | null"
               },
+              "description": "The error to display in this toast",
               "default": "null"
             },
             {
@@ -5841,6 +5944,7 @@
               "type": {
                 "text": "boolean"
               },
+              "description": "Whether the toast is currently visible (triggers slide-in animation)",
               "default": "false",
               "attribute": "visible",
               "reflects": true
@@ -5853,7 +5957,8 @@
                 "type": {
                   "text": "void"
                 }
-              }
+              },
+              "description": "Handles the dismiss event with slide-out animation"
             },
             {
               "kind": "method",
@@ -5863,7 +5968,8 @@
                 "type": {
                   "text": "void"
                 }
-              }
+              },
+              "description": "Handles the action button click"
             }
           ],
           "events": [
@@ -5888,6 +5994,7 @@
               "type": {
                 "text": "boolean"
               },
+              "description": "Whether the toast is currently visible (triggers slide-in animation)",
               "default": "false",
               "fieldName": "visible"
             }
@@ -5922,7 +6029,7 @@
     },
     {
       "kind": "javascript-module",
-      "path": "src/ui/components/error-notification-container.ts",
+      "path": "src/ui/components/toast-container.ts",
       "declarations": [
         {
           "kind": "class",
@@ -5945,7 +6052,8 @@
                     "text": "CustomEvent<{ errorId: string }>"
                   }
                 }
-              ]
+              ],
+              "description": "Dismisses an error toast by forwarding the error ID to the error service."
             },
             {
               "kind": "method",
@@ -5963,12 +6071,13 @@
                     "text": "CustomEvent<{ error: AppError }>"
                   }
                 }
-              ]
+              ],
+              "description": "Executes the action associated with an error toast (e.g. retry)."
             }
           ],
           "superclass": {
             "name": "SignalWatcherLitElement",
-            "module": "src/ui/components/error-notification-container.ts"
+            "module": "src/ui/components/toast-container.ts"
           },
           "summary": "Error toast notification stack manager",
           "tagName": "xcode-graph-error-notification-container",
@@ -5981,7 +6090,7 @@
           "name": "GraphErrorNotificationContainer",
           "declaration": {
             "name": "GraphErrorNotificationContainer",
-            "module": "src/ui/components/error-notification-container.ts"
+            "module": "src/ui/components/toast-container.ts"
           }
         },
         {
@@ -5989,104 +6098,306 @@
           "name": "xcode-graph-error-notification-container",
           "declaration": {
             "name": "GraphErrorNotificationContainer",
-            "module": "src/ui/components/error-notification-container.ts"
+            "module": "src/ui/components/toast-container.ts"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/components/graph-app.ts",
+      "path": "src/ui/components/file-upload.ts",
       "declarations": [
         {
           "kind": "class",
-          "description": "Root application component that orchestrates the entire graph visualization.\nAccepts graph data via `.nodes` and `.edges` properties, making it a\nself-contained web component that can be embedded in any host application.",
-          "name": "GraphApp",
+          "description": "Overlay button for loading a Tuist graph JSON file via file picker or drag-and-drop.",
+          "name": "GraphFileUpload",
           "members": [
             {
               "kind": "field",
-              "name": "nodes",
-              "type": {
-                "text": "GraphNode[]"
-              }
-            },
-            {
-              "kind": "field",
-              "name": "edges",
-              "type": {
-                "text": "GraphEdge[]"
-              }
-            },
-            {
-              "kind": "field",
-              "name": "layoutOptions",
-              "type": {
-                "text": "LayoutOptions | undefined"
-              }
-            },
-            {
-              "kind": "field",
-              "name": "graphDataService",
+              "name": "isDragOver",
               "type": {
-                "text": "GraphDataService | null"
+                "text": "boolean"
               },
               "privacy": "private",
-              "default": "null"
+              "default": "false"
             },
             {
-              "kind": "field",
-              "name": "dataFingerprint",
-              "type": {
-                "text": "string | null"
-              },
+              "kind": "method",
+              "name": "handleClick",
               "privacy": "private",
-              "default": "null"
+              "description": "Opens the hidden file input dialog"
             },
             {
-              "kind": "field",
-              "name": "filtersInitialized",
-              "type": {
-                "text": "boolean"
-              },
+              "kind": "method",
+              "name": "handleKeyDown",
               "privacy": "private",
-              "default": "false"
+              "parameters": [
+                {
+                  "name": "e",
+                  "type": {
+                    "text": "KeyboardEvent"
+                  }
+                }
+              ],
+              "description": "Handles keyboard activation (Enter/Space) to open file dialog"
             },
             {
               "kind": "method",
-              "name": "refreshGraphData",
+              "name": "handleFileChange",
               "privacy": "private",
               "parameters": [
                 {
-                  "name": "nodes",
+                  "name": "e",
                   "type": {
-                    "text": "GraphNode[]"
+                    "text": "Event"
                   }
-                },
+                }
+              ],
+              "description": "Handles file input change and reads the selected file"
+            },
+            {
+              "kind": "method",
+              "name": "handleDragOver",
+              "privacy": "private",
+              "parameters": [
                 {
-                  "name": "edges",
+                  "name": "e",
                   "type": {
-                    "text": "GraphEdge[]"
+                    "text": "DragEvent"
                   }
                 }
-              ]
+              ],
+              "description": "Handles dragover to enable drop and show visual feedback"
             },
             {
               "kind": "method",
-              "name": "seedData",
+              "name": "handleDragLeave",
               "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "void"
+              "description": "Handles dragleave to reset visual feedback"
+            },
+            {
+              "kind": "method",
+              "name": "handleDrop",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "e",
+                  "type": {
+                    "text": "DragEvent"
+                  }
+                }
+              ],
+              "description": "Handles file drop and reads the dropped file"
+            },
+            {
+              "kind": "method",
+              "name": "readFile",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "file",
+                  "type": {
+                    "text": "File"
+                  }
+                }
+              ],
+              "description": "Reads a file as text, parses JSON, and dispatches graph-file-loaded event"
+            }
+          ],
+          "events": [
+            {
+              "name": "graph-file-loaded",
+              "type": {
+                "text": "CustomEvent"
+              },
+              "description": "Dispatched when a valid JSON file is loaded (detail: { raw: unknown })"
+            }
+          ],
+          "superclass": {
+            "name": "LitElement",
+            "package": "lit"
+          },
+          "summary": "File upload button with drag-and-drop support",
+          "tagName": "xcode-graph-file-upload",
+          "customElement": true
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "GraphFileUpload",
+          "declaration": {
+            "name": "GraphFileUpload",
+            "module": "src/ui/components/file-upload.ts"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "xcode-graph-file-upload",
+          "declaration": {
+            "name": "GraphFileUpload",
+            "module": "src/ui/components/file-upload.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/xcode-graph.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "Root application component that orchestrates the entire graph visualization.\nAccepts graph data via `.nodes` and `.edges` properties, making it a\nself-contained web component that can be embedded in any host application.",
+          "name": "GraphApp",
+          "members": [
+            {
+              "kind": "field",
+              "name": "nodes",
+              "type": {
+                "text": "GraphNode[]"
+              },
+              "description": "Graph nodes to visualize"
+            },
+            {
+              "kind": "field",
+              "name": "edges",
+              "type": {
+                "text": "GraphEdge[]"
+              },
+              "description": "Graph edges connecting the nodes"
+            },
+            {
+              "kind": "field",
+              "name": "layoutOptions",
+              "type": {
+                "text": "LayoutOptions | undefined"
+              },
+              "description": "Optional layout configuration for ELK hierarchical layout"
+            },
+            {
+              "kind": "field",
+              "name": "showUpload",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Whether to show the file upload overlay for loading graph JSON",
+              "attribute": "show-upload"
+            },
+            {
+              "kind": "field",
+              "name": "colorScheme",
+              "type": {
+                "text": "ColorScheme"
+              },
+              "description": "Color scheme preference. Set to `'light'` or `'dark'` to force a mode,\nor `'auto'` (default) to follow the user's system preference.",
+              "attribute": "color-scheme",
+              "parsedType": {
+                "text": "'light' | 'dark' | 'auto'"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "graphDataService",
+              "type": {
+                "text": "GraphDataService | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "dataFingerprint",
+              "type": {
+                "text": "string | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "filtersInitialized",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "mediaQueryCleanup",
+              "type": {
+                "text": "(() => void) | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
+            {
+              "kind": "method",
+              "name": "refreshGraphData",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "nodes",
+                  "type": {
+                    "text": "GraphNode[]"
+                  }
+                },
+                {
+                  "name": "edges",
+                  "type": {
+                    "text": "GraphEdge[]"
+                  }
+                }
+              ],
+              "description": "Recomputes graph services and circular dependency analysis when data changes."
+            },
+            {
+              "kind": "method",
+              "name": "applyColorScheme",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
                 }
               }
             },
+            {
+              "kind": "method",
+              "name": "setThemeAttribute",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "theme",
+                  "type": {
+                    "text": "'light' | 'dark'"
+                  }
+                }
+              ],
+              "description": "Sets the `data-theme` attribute on the host element to the given theme."
+            },
+            {
+              "kind": "method",
+              "name": "seedData",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Pushes current nodes and edges into global signals and refreshes the graph data service."
+            },
             {
               "kind": "method",
               "name": "loadRawGraph",
               "privacy": "public",
               "return": {
                 "type": {
-                  "text": "void"
+                  "text": "Promise<void>"
                 }
               },
               "parameters": [
@@ -6097,12 +6408,47 @@
                   }
                 }
               ],
-              "description": "Load raw Tuist graph JSON (the output of `tuist graph --format json`).\nTransforms it into GraphData and sets nodes/edges automatically.\nShows user-facing warnings/errors via ErrorService if the transform has issues."
+              "description": "Load raw Tuist graph JSON (the output of `tuist graph --format json`).\nTransforms it into GraphData and sets nodes/edges automatically.\nShows user-facing warnings/errors via ErrorService if the transform has issues.\n\nThe transform service (and its Zod dependency) is lazy-loaded on first\ncall so the main bundle stays small until validation is actually needed."
+            },
+            {
+              "kind": "method",
+              "name": "handleFileLoaded",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "e",
+                  "type": {
+                    "text": "CustomEvent<{ raw: unknown }>"
+                  }
+                }
+              ],
+              "description": "Handles the `graph-file-loaded` event from the file upload component."
+            }
+          ],
+          "attributes": [
+            {
+              "name": "show-upload",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Whether to show the file upload overlay for loading graph JSON",
+              "fieldName": "showUpload"
+            },
+            {
+              "name": "color-scheme",
+              "type": {
+                "text": "ColorScheme"
+              },
+              "description": "Color scheme preference. Set to `'light'` or `'dark'` to force a mode,\nor `'auto'` (default) to follow the user's system preference.",
+              "fieldName": "colorScheme",
+              "parsedType": {
+                "text": "'light' | 'dark' | 'auto'"
+              }
             }
           ],
           "superclass": {
             "name": "SignalWatcherLitElement",
-            "module": "src/components/graph-app.ts"
+            "module": "src/components/xcode-graph.ts"
           },
           "summary": "Embeddable graph visualization entry point",
           "tagName": "xcode-graph",
@@ -6115,7 +6461,7 @@
           "name": "GraphApp",
           "declaration": {
             "name": "GraphApp",
-            "module": "src/components/graph-app.ts"
+            "module": "src/components/xcode-graph.ts"
           }
         },
         {
@@ -6123,7 +6469,30 @@
           "name": "xcode-graph",
           "declaration": {
             "name": "GraphApp",
-            "module": "src/components/graph-app.ts"
+            "module": "src/components/xcode-graph.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/index.ts",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "ColorScheme",
+          "declaration": {
+            "name": "ColorScheme",
+            "module": "./xcode-graph"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "GraphApp",
+          "declaration": {
+            "name": "GraphApp",
+            "module": "./xcode-graph"
           }
         }
       ]
@@ -6220,7 +6589,8 @@
             {
               "kind": "method",
               "name": "resolveEdgeProps",
-              "privacy": "private"
+              "privacy": "private",
+              "description": "Resolves edge properties by merging declared values with defaults."
             }
           ],
           "attributes": [
@@ -6329,7 +6699,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "",
+          "description": "Generates and renders a cached parallax starfield on a canvas.",
           "name": "Starfield",
           "members": [
             {
@@ -6515,7 +6885,7 @@
               "privacy": "private",
               "return": {
                 "type": {
-                  "text": "Star"
+                  "text": ""
                 }
               },
               "parameters": [
@@ -6523,33 +6893,39 @@
                   "name": "isBright",
                   "type": {
                     "text": "boolean"
-                  }
+                  },
+                  "description": "Whether the star should use bright star parameters."
                 },
                 {
                   "name": "spanX",
                   "type": {
                     "text": "number"
-                  }
+                  },
+                  "description": "Horizontal spawn region width."
                 },
                 {
                   "name": "spanY",
                   "type": {
                     "text": "number"
-                  }
+                  },
+                  "description": "Vertical spawn region height."
                 },
                 {
                   "name": "offsetX",
                   "type": {
                     "text": "number"
-                  }
+                  },
+                  "description": "Horizontal offset to center the spawn region."
                 },
                 {
                   "name": "offsetY",
                   "type": {
                     "text": "number"
-                  }
+                  },
+                  "description": "Vertical offset to center the spawn region."
                 }
-              ]
+              ],
+              "description": "Creates a single star with randomized position, size, opacity, and color."
             },
             {
               "kind": "method",
@@ -6565,15 +6941,18 @@
                   "name": "panX",
                   "type": {
                     "text": "number"
-                  }
+                  },
+                  "description": "Rounded camera X offset in world space."
                 },
                 {
                   "name": "panY",
                   "type": {
                     "text": "number"
-                  }
+                  },
+                  "description": "Rounded camera Y offset in world space."
                 }
-              ]
+              ],
+              "description": "Renders all stars with parallax offsets to an OffscreenCanvas cache."
             },
             {
               "kind": "field",
@@ -6648,32 +7027,127 @@
     },
     {
       "kind": "javascript-module",
-      "path": "src/ui/components/action-button.ts",
-      "declarations": [
+      "path": "src/graph/components/index.ts",
+      "declarations": [],
+      "exports": [
         {
-          "kind": "class",
-          "description": "A semantic action button with color variants and active states.\nUsed for action buttons in panels and forms.",
-          "name": "GraphActionButton",
-          "slots": [
-            {
-              "description": "Optional icon to display before the text",
-              "name": "icon"
-            },
-            {
-              "description": "Button text content",
-              "name": ""
-            }
-          ],
-          "members": [
-            {
-              "kind": "field",
-              "name": "shadowRootOptions",
-              "type": {
-                "text": "ShadowRootInit"
-              },
-              "static": true,
-              "default": "{ ...LitElement.shadowRootOptions, delegatesFocus: true, }"
-            },
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "module": "src/graph/components/canvas"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "GraphCanvas",
+          "declaration": {
+            "name": "GraphCanvas",
+            "module": "./graph-canvas"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "GraphEdge",
+          "declaration": {
+            "name": "GraphEdge",
+            "module": "./graph-edge"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "GraphHiddenDom",
+          "declaration": {
+            "name": "GraphHiddenDom",
+            "module": "./graph-hidden-dom"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "GraphBackground",
+          "declaration": {
+            "name": "GraphBackground",
+            "module": "./graph-overlays"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "GraphControls",
+          "declaration": {
+            "name": "GraphControls",
+            "module": "./graph-overlays"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "GraphEmptyStateOverlay",
+          "declaration": {
+            "name": "GraphEmptyStateOverlay",
+            "module": "./graph-overlays"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "GraphInstructions",
+          "declaration": {
+            "name": "GraphInstructions",
+            "module": "./graph-overlays"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "Star",
+          "declaration": {
+            "name": "Star",
+            "module": "./starfield"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "StarfieldOptions",
+          "declaration": {
+            "name": "StarfieldOptions",
+            "module": "./starfield"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "Starfield",
+          "declaration": {
+            "name": "Starfield",
+            "module": "./starfield"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/ui/components/action-button.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "A semantic action button with color variants and active states.\nUsed for action buttons in panels and forms.",
+          "name": "GraphActionButton",
+          "slots": [
+            {
+              "description": "Optional icon to display before the text",
+              "name": "icon"
+            },
+            {
+              "description": "Button text content",
+              "name": ""
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "shadowRootOptions",
+              "type": {
+                "text": "ShadowRootInit"
+              },
+              "static": true,
+              "default": "{ ...LitElement.shadowRootOptions, delegatesFocus: true, }"
+            },
             {
               "kind": "field",
               "name": "variant",
@@ -6683,8 +7157,8 @@
               "description": "Button color variant",
               "default": "'neutral'",
               "attribute": "variant",
-              "expandedType": {
-                "text": "'primary' | 'success' | 'warning' | 'neutral'"
+              "parsedType": {
+                "text": "'neutral' | 'primary' | 'success' | 'warning'"
               }
             },
             {
@@ -6727,8 +7201,8 @@
               "description": "Button color variant",
               "default": "'neutral'",
               "fieldName": "variant",
-              "expandedType": {
-                "text": "'primary' | 'success' | 'warning' | 'neutral'"
+              "parsedType": {
+                "text": "'neutral' | 'primary' | 'success' | 'warning'"
               }
             },
             {
@@ -6823,8 +7297,8 @@
               "description": "Alert variant (determines color scheme)",
               "default": "'info'",
               "attribute": "variant",
-              "expandedType": {
-                "text": "'warning' | 'error' | 'info' | 'success'"
+              "parsedType": {
+                "text": "'success' | 'warning' | 'error' | 'info'"
               }
             },
             {
@@ -6869,7 +7343,8 @@
             {
               "kind": "method",
               "name": "handleDismiss",
-              "privacy": "private"
+              "privacy": "private",
+              "description": "Handles the dismiss event and hides the banner"
             }
           ],
           "events": [
@@ -6890,8 +7365,8 @@
               "description": "Alert variant (determines color scheme)",
               "default": "'info'",
               "fieldName": "variant",
-              "expandedType": {
-                "text": "'warning' | 'error' | 'info' | 'success'"
+              "parsedType": {
+                "text": "'success' | 'warning' | 'error' | 'info'"
               }
             },
             {
@@ -6956,7 +7431,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "Displays package/project badge with sharp styling and monospace typography.\nWrapper around graph-badge with container styling.",
+          "description": "Displays package/project badge with accent styling and monospace typography.\nWrapper around graph-badge with container styling.",
           "name": "GraphClusterTypeBadge",
           "members": [
             {
@@ -7048,6 +7523,7 @@
               "type": {
                 "text": "string[][]"
               },
+              "description": "Array of circular dependency cycles, each cycle is a list of node names",
               "default": "[]"
             },
             {
@@ -7071,30 +7547,14 @@
             {
               "kind": "method",
               "name": "handleToggleExpand",
-              "privacy": "private"
+              "privacy": "private",
+              "description": "Toggles the expanded details view"
             },
             {
               "kind": "method",
               "name": "handleDismiss",
-              "privacy": "private"
-            },
-            {
-              "kind": "method",
-              "name": "formatCycle",
               "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "string"
-                }
-              },
-              "parameters": [
-                {
-                  "name": "cycle",
-                  "type": {
-                    "text": "string[]"
-                  }
-                }
-              ]
+              "description": "Handles the dismiss event and hides the warning"
             }
           ],
           "events": [
@@ -7152,8 +7612,8 @@
               "description": "The icon name to render",
               "default": "'product-types'",
               "attribute": "name",
-              "expandedType": {
-                "text": "'product-types' | 'platforms' | 'projects' | 'packages'"
+              "parsedType": {
+                "text": "'platforms' | 'projects' | 'packages' | 'product-types'"
               }
             },
             {
@@ -7169,22 +7629,26 @@
             {
               "kind": "method",
               "name": "renderProductTypes",
-              "privacy": "private"
+              "privacy": "private",
+              "description": "Renders the product types grid icon"
             },
             {
               "kind": "method",
               "name": "renderPlatforms",
-              "privacy": "private"
+              "privacy": "private",
+              "description": "Renders the platforms grid icon"
             },
             {
               "kind": "method",
               "name": "renderProjects",
-              "privacy": "private"
+              "privacy": "private",
+              "description": "Renders the projects folder icon"
             },
             {
               "kind": "method",
               "name": "renderPackages",
-              "privacy": "private"
+              "privacy": "private",
+              "description": "Renders the packages box icon"
             }
           ],
           "attributes": [
@@ -7196,8 +7660,8 @@
               "description": "The icon name to render",
               "default": "'product-types'",
               "fieldName": "name",
-              "expandedType": {
-                "text": "'product-types' | 'platforms' | 'projects' | 'packages'"
+              "parsedType": {
+                "text": "'platforms' | 'projects' | 'packages' | 'product-types'"
               }
             },
             {
@@ -7238,31 +7702,403 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/ui/components/index.ts",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "ActionButtonVariant",
+          "declaration": {
+            "name": "ActionButtonVariant",
+            "module": "./action-button"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "GraphActionButton",
+          "declaration": {
+            "name": "GraphActionButton",
+            "module": "./action-button"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "AlertBannerVariant",
+          "declaration": {
+            "name": "AlertBannerVariant",
+            "module": "./alert-banner"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "GraphAlertBanner",
+          "declaration": {
+            "name": "GraphAlertBanner",
+            "module": "./alert-banner"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "BadgeSize",
+          "declaration": {
+            "name": "BadgeSize",
+            "module": "./badge"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "BadgeVariant",
+          "declaration": {
+            "name": "BadgeVariant",
+            "module": "./badge"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "GraphBadge",
+          "declaration": {
+            "name": "GraphBadge",
+            "module": "./badge"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "GraphBuildSettings",
+          "declaration": {
+            "name": "GraphBuildSettings",
+            "module": "./build-settings"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "GraphClearFiltersButton",
+          "declaration": {
+            "name": "GraphClearFiltersButton",
+            "module": "./clear-filters-button"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "GraphClusterComposition",
+          "declaration": {
+            "name": "GraphClusterComposition",
+            "module": "./cluster-composition"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "GraphClusterDetailsPanel",
+          "declaration": {
+            "name": "GraphClusterDetailsPanel",
+            "module": "./cluster-details-panel"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "GraphClusterHeader",
+          "declaration": {
+            "name": "GraphClusterHeader",
+            "module": "./cluster-header"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "GraphClusterStats",
+          "declaration": {
+            "name": "GraphClusterStats",
+            "module": "./cluster-stats"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "GraphClusterTargetsList",
+          "declaration": {
+            "name": "GraphClusterTargetsList",
+            "module": "./cluster-targets-list"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "GraphClusterTypeBadge",
+          "declaration": {
+            "name": "GraphClusterTypeBadge",
+            "module": "./cluster-type-badge"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "GraphCycleWarning",
+          "declaration": {
+            "name": "GraphCycleWarning",
+            "module": "./cycle-warning"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "GraphDeploymentTargets",
+          "declaration": {
+            "name": "GraphDeploymentTargets",
+            "module": "./deployment-targets"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "GraphEmptyState",
+          "declaration": {
+            "name": "GraphEmptyState",
+            "module": "./empty-state"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "GraphErrorToast",
+          "declaration": {
+            "name": "GraphErrorToast",
+            "module": "./error-toast"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "GraphFileUpload",
+          "declaration": {
+            "name": "GraphFileUpload",
+            "module": "./file-upload"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "FilterIconName",
+          "declaration": {
+            "name": "FilterIconName",
+            "module": "./filter-icon"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "GraphFilterIcon",
+          "declaration": {
+            "name": "GraphFilterIcon",
+            "module": "./filter-icon"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "FilterItem",
+          "declaration": {
+            "name": "FilterItem",
+            "module": "./filter-section"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "FilterType",
+          "declaration": {
+            "name": "FilterType",
+            "module": "./filter-section"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "GraphFilterSection",
+          "declaration": {
+            "name": "GraphFilterSection",
+            "module": "./filter-section"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "IconButtonColor",
+          "declaration": {
+            "name": "IconButtonColor",
+            "module": "./icon-button"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "IconButtonSize",
+          "declaration": {
+            "name": "IconButtonSize",
+            "module": "./icon-button"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "IconButtonVariant",
+          "declaration": {
+            "name": "IconButtonVariant",
+            "module": "./icon-button"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "GraphIconButton",
+          "declaration": {
+            "name": "GraphIconButton",
+            "module": "./icon-button"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "GraphInfoRow",
+          "declaration": {
+            "name": "GraphInfoRow",
+            "module": "./info-row"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "GraphListItemRow",
+          "declaration": {
+            "name": "GraphListItemRow",
+            "module": "./list-item-row"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "GraphMetricsSection",
+          "declaration": {
+            "name": "GraphMetricsSection",
+            "module": "./metrics-section"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "GraphNodeDetailsPanel",
+          "declaration": {
+            "name": "GraphNodeDetailsPanel",
+            "module": "./node-details-panel"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "GraphNodeHeader",
+          "declaration": {
+            "name": "GraphNodeHeader",
+            "module": "./node-header"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "GraphNodeInfo",
+          "declaration": {
+            "name": "GraphNodeInfo",
+            "module": "./node-info"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "GraphNodeList",
+          "declaration": {
+            "name": "GraphNodeList",
+            "module": "./node-list"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "NodeListEventsBase",
+          "declaration": {
+            "name": "NodeListEventsBase",
+            "module": "./node-list-base"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "GraphPanelHeader",
+          "declaration": {
+            "name": "GraphPanelHeader",
+            "module": "./panel-header"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "GraphRightSidebar",
+          "declaration": {
+            "name": "GraphRightSidebar",
+            "module": "./right-sidebar"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "GraphCollapsedSidebar",
+          "declaration": {
+            "name": "GraphCollapsedSidebar",
+            "module": "./right-sidebar-collapsed"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "GraphRightSidebarHeader",
+          "declaration": {
+            "name": "GraphRightSidebarHeader",
+            "module": "./right-sidebar-header"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "GraphSearchBar",
+          "declaration": {
+            "name": "GraphSearchBar",
+            "module": "./search-bar"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "GraphSectionHeader",
+          "declaration": {
+            "name": "GraphSectionHeader",
+            "module": "./section-header"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "GraphSidebarCollapseIcon",
+          "declaration": {
+            "name": "GraphSidebarCollapseIcon",
+            "module": "./sidebar-collapse-icon"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "GraphStatsCard",
+          "declaration": {
+            "name": "GraphStatsCard",
+            "module": "./stats-card"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "GraphTagBadge",
+          "declaration": {
+            "name": "GraphTagBadge",
+            "module": "./tag-badge"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "GraphErrorNotificationContainer",
+          "declaration": {
+            "name": "GraphErrorNotificationContainer",
+            "module": "./toast-container"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/ui/layout/header.ts",
       "declarations": [
         {
           "kind": "class",
-          "description": "Top header component with bold identity. Features scan line effect,\nglowing logo, and monospace typography.",
+          "description": "Top header component with logo and breadcrumb navigation.",
           "name": "GraphHeader",
-          "members": [
-            {
-              "kind": "method",
-              "name": "renderSelectorIcon",
-              "privacy": "private"
-            },
-            {
-              "kind": "method",
-              "name": "renderSlashIcon",
-              "privacy": "private"
-            }
-          ],
+          "members": [],
           "superclass": {
             "name": "LitElement",
             "package": "lit"
           },
-          "summary": "Mission control themed header bar",
+          "summary": "Application header bar",
           "tagName": "xcode-graph-header",
           "customElement": true
         }
@@ -7349,7 +8185,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "Left sidebar navigation with staggered entrance animations.\nFeatures noise texture, accent borders, and monospace typography.",
+          "description": "Left sidebar navigation with tab items.",
           "name": "GraphSidebar",
           "members": [
             {
@@ -7358,6 +8194,7 @@
               "type": {
                 "text": "boolean"
               },
+              "description": "Whether the sidebar is currently collapsed",
               "attribute": "collapsed",
               "reflects": true
             },
@@ -7367,6 +8204,7 @@
               "type": {
                 "text": "boolean"
               },
+              "description": "Whether the sidebar should start collapsed on first render",
               "attribute": "defaultCollapsed"
             },
             {
@@ -7398,12 +8236,14 @@
                     "text": "ActiveTabType"
                   }
                 }
-              ]
+              ],
+              "description": "Dispatches a tab-change event when a navigation item is clicked"
             },
             {
               "kind": "method",
               "name": "toggleCollapse",
-              "privacy": "private"
+              "privacy": "private",
+              "description": "Toggles the sidebar between collapsed and expanded states"
             }
           ],
           "events": [
@@ -7421,6 +8261,7 @@
               "type": {
                 "text": "boolean"
               },
+              "description": "Whether the sidebar is currently collapsed",
               "fieldName": "collapsed"
             },
             {
@@ -7428,6 +8269,7 @@
               "type": {
                 "text": "boolean"
               },
+              "description": "Whether the sidebar should start collapsed on first render",
               "fieldName": "defaultCollapsed"
             },
             {
@@ -7474,6 +8316,45 @@
           }
         }
       ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/ui/layout/index.ts",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "GraphTab",
+          "declaration": {
+            "name": "GraphTab",
+            "module": "./graph-tab"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "GraphHeader",
+          "declaration": {
+            "name": "GraphHeader",
+            "module": "./header"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "GraphPlaceholderTab",
+          "declaration": {
+            "name": "GraphPlaceholderTab",
+            "module": "./placeholder-tab"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "GraphSidebar",
+          "declaration": {
+            "name": "GraphSidebar",
+            "module": "./sidebar"
+          }
+        }
+      ]
     }
   ]
 }