Codebase intelligence for AI and humans: code health scores, auto-generated docs, git analytics, dead code detection, and architectural decisions via MCP.
Python aicode-complexitycode-healthcode-intelligencecode-qualitydead-codedeveloper-toolsdocumentationgit-analyticsmcpopen-sourcepythonrefactoringstatic-analysistechnical-debt
feat(web): upgrade external dependency explorer (#1943)
Raghav Chamadiya38fa788386dc
diff --git a/packages/ui/__tests__/dependencies/external-dependencies-table.test.tsx b/packages/ui/__tests__/dependencies/external-dependencies-table.test.tsxnew file mode 100644index 000000000..bd4ac19b5--- /dev/null+++ b/packages/ui/__tests__/dependencies/external-dependencies-table.test.tsx@@ -0,0 +1,145 @@+import * as React from "react";+import { fireEvent, render, screen, within } from "@testing-library/react";+import { describe, expect, it, vi } from "vitest";+import type {+ ExternalSystemSummaryEntry,+ ExternalSystemsSummary,+} from "@repowise-dev/types/external-systems";+import {+ DEFAULT_EXTERNAL_DEPENDENCY_STATE,+ ExternalDependenciesTable,+ type ExternalDependencyTableState,+} from "../../src/dependencies";++function entry(index: number, overrides: Partial<ExternalSystemSummaryEntry> = {}): ExternalSystemSummaryEntry {+ return {+ package_key: `npm:pkg-${index}`,+ name: `pkg-${index}`,+ display_name: `pkg-${index}`,+ ecosystem: index % 2 ? "pypi" : "npm",+ category: "library",+ io_kind: null,+ runtime_declared: index % 3 !== 0,+ dev_declared: index % 3 === 0,+ declaration_count: 1,+ manifest_count: 1,+ versions: [`^${index}.0.0`],+ versions_total: 1,+ versions_truncated: false,+ multiple_versions: false,+ external_node_count: index % 4 === 0 ? 0 : 1,+ import_edge_count: index,+ importing_file_count: index,+ link_state: index % 4 === 0 ? "unlinked" : "linked",+ ...overrides,+ };+}++function summary(items: ExternalSystemSummaryEntry[]): ExternalSystemsSummary {+ return {+ items,+ returned: items.length,+ total_packages: items.length,+ limit: 400,+ offset: 0,+ truncated: false,+ scope: "primary",+ excluded_declarations: 7,+ total_declarations: items.length,+ runtime_packages: items.filter((item) => item.runtime_declared).length,+ dev_only_packages: items.filter((item) => !item.runtime_declared && item.dev_declared).length,+ observed_packages: items.filter((item) => item.import_edge_count > 0).length,+ linked_packages: items.filter((item) => item.link_state === "linked").length,+ unlinked_packages: items.filter((item) => item.link_state === "unlinked").length,+ linked_without_imports: items.filter((item) => item.link_state === "linked" && item.import_edge_count === 0).length,+ ecosystems: [...new Set(items.map((item) => item.ecosystem))],+ manifest_count: 3,+ };+}++function Harness({ data }: { data: ExternalSystemsSummary }) {+ const [state, setState] = React.useState<ExternalDependencyTableState>({+ ...DEFAULT_EXTERNAL_DEPENDENCY_STATE,+ sort: "name",+ order: "asc",+ });+ const [selected, setSelected] = React.useState<ExternalSystemSummaryEntry | null>(null);+ return (+ <ExternalDependenciesTable+ data={data}+ state={state}+ onStateChange={setState}+ selected={selected}+ onSelectedChange={setSelected}+ />+ );+}++describe("ExternalDependenciesTable", () => {+ it("keeps the rendered package page bounded and paginates", () => {+ render(<Harness data={summary(Array.from({ length: 60 }, (_, index) => entry(index)))} />);++ expect(screen.getAllByText("pkg-0").length).toBeGreaterThan(0);+ expect(screen.queryByText("pkg-31")).not.toBeInTheDocument();+ expect(screen.getByText("Page 1 of 3")).toBeInTheDocument();++ fireEvent.click(screen.getByRole("button", { name: /next/i }));+ expect(screen.getAllByText("pkg-31").length).toBeGreaterThan(0);+ expect(screen.queryByText("pkg-0")).not.toBeInTheDocument();+ });++ it("searches quickly and reports an honest filtered empty state", () => {+ render(<Harness data={summary([entry(1), entry(2), entry(3)])} />);+ const search = screen.getByRole("searchbox", { name: "Search packages" });++ fireEvent.change(search, { target: { value: "pkg-2" } });+ expect(screen.getAllByText("pkg-2").length).toBeGreaterThan(0);+ expect(screen.queryByText("pkg-1")).not.toBeInTheDocument();++ fireEvent.change(search, { target: { value: "missing" } });+ expect(screen.getByText("No packages match these filters")).toBeInTheDocument();+ });++ it("opens a keyboard-accessible package inspector", () => {+ render(<Harness data={summary([entry(7, { display_name: "selected-package" })])} />);+ const row = screen.getAllByText("selected-package")[0]!.closest("tr");+ expect(row).not.toBeNull();+ fireEvent.keyDown(row!, { key: "Enter" });++ const dialog = screen.getByRole("dialog");+ expect(within(dialog).getByText("selected-package")).toBeInTheDocument();+ expect(within(dialog).getByText(/1 declaration/)).toBeInTheDocument();+ });++ it("renders a repository-level empty state", () => {+ const onStateChange = vi.fn();+ render(+ <ExternalDependenciesTable+ data={summary([])}+ state={DEFAULT_EXTERNAL_DEPENDENCY_STATE}+ onStateChange={onStateChange}+ selected={null}+ onSelectedChange={vi.fn()}+ />,+ );+ expect(screen.getByText("No external dependencies recorded")).toBeInTheDocument();+ });++ it("offers bounded server-page traversal when more summaries exist", () => {+ const onLoadMore = vi.fn();+ const data = { ...summary([entry(1)]), total_packages: 501, returned: 400, truncated: true };+ render(+ <ExternalDependenciesTable+ data={data}+ state={DEFAULT_EXTERNAL_DEPENDENCY_STATE}+ onStateChange={vi.fn()}+ selected={null}+ onSelectedChange={vi.fn()}+ onLoadMore={onLoadMore}+ />,+ );+ fireEvent.click(screen.getByRole("button", { name: "Load next 101" }));+ expect(onLoadMore).toHaveBeenCalledOnce();+ expect(screen.getByText(/apply to 400 loaded packages out of 501/)).toBeInTheDocument();+ });+});diff --git a/packages/ui/src/dependencies/external-dependencies-table.tsx b/packages/ui/src/dependencies/external-dependencies-table.tsxnew file mode 100644index 000000000..1968f2c93--- /dev/null+++ b/packages/ui/src/dependencies/external-dependencies-table.tsx@@ -0,0 +1,586 @@+"use client";++import * as React from "react";+import {+ ArrowRight,+ Box,+ ChevronLeft,+ ChevronRight,+ ExternalLink,+ FileCode2,+ Search,+} from "lucide-react";+import type {+ ExternalSystemSummaryEntry,+ ExternalSystemsSummary,+} from "@repowise-dev/types/external-systems";+import { EmptyState } from "../shared/empty-state";+import {+ ResponsiveTable,+ type ResponsiveColumn,+} from "../shared/responsive-table";+import { Button } from "../ui/button";+import {+ Select,+ SelectContent,+ SelectItem,+ SelectTrigger,+ SelectValue,+} from "../ui/select";+import { Sheet, SheetContent, SheetTitle } from "../ui/sheet";++export type ExternalDependencyRole = "all" | "runtime" | "dev-only" | "mixed";+export type ExternalDependencyUsage =+ | "all"+ | "observed"+ | "linked-unobserved"+ | "unlinked";+export type ExternalDependencySort =+ | "importers"+ | "edges"+ | "name"+ | "declarations"+ | "manifests"+ | "versions";++export interface ExternalDependencyTableState {+ query: string;+ ecosystem: string;+ role: ExternalDependencyRole;+ usage: ExternalDependencyUsage;+ category: string;+ sort: ExternalDependencySort;+ order: "asc" | "desc";+ page: number;+}++export const DEFAULT_EXTERNAL_DEPENDENCY_STATE: ExternalDependencyTableState = {+ query: "",+ ecosystem: "all",+ role: "all",+ usage: "all",+ category: "all",+ sort: "importers",+ order: "desc",+ page: 1,+};++export interface PackageGraphEvidence {+ centerNodeId: string;+ importingFiles: string[];+ importEdgeCount: number;+ totalNodes: number;+}++export interface ExternalDependenciesTableProps {+ data: ExternalSystemsSummary;+ state: ExternalDependencyTableState;+ onStateChange: (state: ExternalDependencyTableState) => void;+ selected: ExternalSystemSummaryEntry | null;+ onSelectedChange: (entry: ExternalSystemSummaryEntry | null) => void;+ evidence?: PackageGraphEvidence | undefined;+ evidenceLoading?: boolean | undefined;+ evidenceError?: string | null | undefined;+ graphHref?: string | undefined;+ renderFileLink?: ((path: string, children: React.ReactNode) => React.ReactNode) | undefined;+ pageSize?: number | undefined;+ onLoadMore?: (() => void) | undefined;+ loadingMore?: boolean | undefined;+ loadMoreError?: string | null | undefined;+ onRetryLoadMore?: (() => void) | undefined;+}++function roleOf(entry: ExternalSystemSummaryEntry): Exclude<ExternalDependencyRole, "all"> {+ if (entry.runtime_declared && entry.dev_declared) return "mixed";+ return entry.runtime_declared ? "runtime" : "dev-only";+}++function usageOf(entry: ExternalSystemSummaryEntry): Exclude<ExternalDependencyUsage, "all"> {+ if (entry.import_edge_count > 0) return "observed";+ return entry.link_state === "linked" ? "linked-unobserved" : "unlinked";+}++function compareEntries(+ a: ExternalSystemSummaryEntry,+ b: ExternalSystemSummaryEntry,+ sort: ExternalDependencySort,+): number {+ if (sort === "name") return a.display_name.localeCompare(b.display_name);+ const values: Record<Exclude<ExternalDependencySort, "name">, [number, number]> = {+ importers: [a.importing_file_count, b.importing_file_count],+ edges: [a.import_edge_count, b.import_edge_count],+ declarations: [a.declaration_count, b.declaration_count],+ manifests: [a.manifest_count, b.manifest_count],+ versions: [a.versions_total, b.versions_total],+ };+ const [av, bv] = values[sort];+ return av - bv || a.display_name.localeCompare(b.display_name);+}++function updateState(+ state: ExternalDependencyTableState,+ patch: Partial<ExternalDependencyTableState>,+): ExternalDependencyTableState {+ return { ...state, ...patch, page: patch.page ?? 1 };+}++function RoleLabel({ entry }: { entry: ExternalSystemSummaryEntry }) {+ const role = roleOf(entry);+ return (+ <span className="text-xs text-[var(--color-text-secondary)]">+ {role === "runtime" ? "Runtime" : role === "mixed" ? "Runtime + dev" : "Dev-only"}+ </span>+ );+}++function LinkageLabel({ entry }: { entry: ExternalSystemSummaryEntry }) {+ const usage = usageOf(entry);+ return (+ <span className="inline-flex items-center gap-1.5 text-xs text-[var(--color-text-secondary)]">+ <span+ aria-hidden+ className={+ usage === "observed"+ ? "h-1.5 w-1.5 rounded-full bg-[var(--color-success)]"+ : "h-1.5 w-1.5 rounded-full bg-[var(--color-text-tertiary)]"+ }+ />+ {usage === "observed"+ ? "Observed"+ : usage === "linked-unobserved"+ ? "Linked, no imports"+ : "No graph link"}+ </span>+ );+}++function Versions({ entry }: { entry: ExternalSystemSummaryEntry }) {+ if (entry.versions_total === 0) {+ return <span className="text-[var(--color-text-tertiary)]">Not specified</span>;+ }+ const label = entry.versions.join(", ");+ return (+ <span className="font-mono text-xs text-[var(--color-text-secondary)]" title={label}>+ {label}+ {entry.versions_truncated ? ` +${entry.versions_total - entry.versions.length}` : ""}+ {entry.multiple_versions ? (+ <span className="ml-1.5 font-sans text-[var(--color-text-tertiary)]">+ ({entry.versions_total} versions)+ </span>+ ) : null}+ </span>+ );+}++function PackageInspector({+ entry,+ evidence,+ evidenceLoading,+ evidenceError,+ graphHref,+ renderFileLink,+ onClose,+}: {+ entry: ExternalSystemSummaryEntry | null;+ evidence?: PackageGraphEvidence | undefined;+ evidenceLoading?: boolean | undefined;+ evidenceError?: string | null | undefined;+ graphHref?: string | undefined;+ renderFileLink?: ExternalDependenciesTableProps["renderFileLink"];+ onClose: () => void;+}) {+ return (+ <Sheet open={entry !== null} onOpenChange={(open) => !open && onClose()}>+ <SheetContent+ side="right"+ closeLabel="Close package details"+ className="w-[min(92vw,440px)] sm:w-[440px]"+ >+ {entry ? (+ <div className="flex min-h-0 flex-1 flex-col">+ <header className="border-b border-[var(--color-border-default)] px-5 py-4 pr-12">+ <p className="font-mono text-2xs uppercase tracking-wider text-[var(--color-text-tertiary)]">+ {entry.ecosystem} package+ </p>+ <SheetTitle className="mt-1 break-words text-[15px]">{entry.display_name}</SheetTitle>+ <div className="mt-2 flex flex-wrap gap-x-4 gap-y-1">+ <RoleLabel entry={entry} />+ <LinkageLabel entry={entry} />+ </div>+ </header>++ <div className="min-h-0 flex-1 space-y-6 overflow-y-auto px-5 py-5">+ <section>+ <h3 className="text-sm font-semibold text-[var(--color-text-primary)]">Declarations</h3>+ <p className="mt-2 text-xs text-[var(--color-text-secondary)]">+ {entry.declaration_count} declaration{entry.declaration_count === 1 ? "" : "s"} across {entry.manifest_count} manifest{entry.manifest_count === 1 ? "" : "s"}.+ </p>+ <div className="mt-2"><Versions entry={entry} /></div>+ {entry.versions_truncated ? (+ <p className="mt-1 text-xs text-[var(--color-text-tertiary)]">+ Showing {entry.versions.length} of {entry.versions_total} declared versions.+ </p>+ ) : null}+ </section>++ <section>+ <h3 className="text-sm font-semibold text-[var(--color-text-primary)]">Import graph evidence</h3>+ {evidenceLoading && !evidence ? (+ <p className="mt-2 text-xs text-[var(--color-text-tertiary)]">Loading focused graph evidence…</p>+ ) : evidenceError ? (+ <p className="mt-2 text-xs text-[var(--color-text-tertiary)]">{evidenceError}</p>+ ) : evidence ? (+ <>+ <p className="mt-2 text-xs text-[var(--color-text-secondary)]">+ {entry.importing_file_count} importing file{entry.importing_file_count === 1 ? "" : "s"} and {entry.import_edge_count} import edge{entry.import_edge_count === 1 ? "" : "s"} in the persisted graph.+ </p>+ <ul className="mt-3 space-y-1.5">+ {evidence.importingFiles.slice(0, 20).map((path) => (+ <li key={path} className="flex items-start gap-2 text-xs">+ <FileCode2 className="mt-0.5 h-3.5 w-3.5 shrink-0 text-[var(--color-text-tertiary)]" />+ <span className="min-w-0 break-all font-mono text-[var(--color-text-secondary)]">+ {renderFileLink ? renderFileLink(path, path) : path}+ </span>+ </li>+ ))}+ </ul>+ {entry.importing_file_count > evidence.importingFiles.length ? (+ <p className="mt-2 text-xs text-[var(--color-text-tertiary)]">+ Focused evidence returned {evidence.importingFiles.length} of {entry.importing_file_count} importing files.+ </p>+ ) : null}+ {entry.external_node_count > 1 ? (+ <p className="mt-2 text-xs text-[var(--color-text-tertiary)]">+ This focus shows one of {entry.external_node_count} linked graph targets. Package totals above include all targets.+ </p>+ ) : null}+ </>+ ) : (+ <p className="mt-2 text-xs text-[var(--color-text-tertiary)]">+ {entry.link_state === "unlinked"+ ? "This declaration is not linked to a persisted graph node."+ : "No import edges were observed for the linked graph node."}+ </p>+ )}+ </section>+ </div>++ {graphHref ? (+ <footer className="border-t border-[var(--color-border-default)] p-4">+ <Button asChild className="w-full">+ <a href={graphHref}>+ Open focused package in graph+ <ExternalLink className="h-4 w-4" />+ </a>+ </Button>+ </footer>+ ) : null}+ </div>+ ) : null}+ </SheetContent>+ </Sheet>+ );+}++export function ExternalDependenciesTable({+ data,+ state,+ onStateChange,+ selected,+ onSelectedChange,+ evidence,+ evidenceLoading,+ evidenceError,+ graphHref,+ renderFileLink,+ pageSize = 25,+ onLoadMore,+ loadingMore,+ loadMoreError,+ onRetryLoadMore,+}: ExternalDependenciesTableProps) {+ const deferredQuery = React.useDeferredValue(state.query.trim().toLowerCase());+ const categories = React.useMemo(+ () => [...new Set(data.items.map((entry) => entry.category))].sort(),+ [data.items],+ );++ const filtered = React.useMemo(() => {+ const rows = data.items.filter((entry) => {+ if (+ deferredQuery &&+ !entry.name.toLowerCase().includes(deferredQuery) &&+ !entry.display_name.toLowerCase().includes(deferredQuery) &&+ !entry.versions.some((version) => version.toLowerCase().includes(deferredQuery))+ )+ return false;+ if (state.ecosystem !== "all" && entry.ecosystem !== state.ecosystem) return false;+ if (state.role !== "all" && roleOf(entry) !== state.role) return false;+ if (state.usage !== "all" && usageOf(entry) !== state.usage) return false;+ if (state.category !== "all" && entry.category !== state.category) return false;+ return true;+ });+ return rows.sort((a, b) => {+ const result = compareEntries(a, b, state.sort);+ return state.order === "asc" ? result : -result;+ });+ }, [data.items, deferredQuery, state]);++ const pageCount = Math.max(1, Math.ceil(filtered.length / pageSize));+ const page = Math.min(Math.max(1, state.page), pageCount);+ const pageRows = filtered.slice((page - 1) * pageSize, page * pageSize);+ const activeFilters =+ Number(Boolean(state.query)) ++ Number(state.ecosystem !== "all") ++ Number(state.role !== "all") ++ Number(state.usage !== "all") ++ Number(state.category !== "all");++ const handleSort = (key: string) => {+ const sort = key as ExternalDependencySort;+ onStateChange(+ updateState(state, {+ sort,+ order: state.sort === sort ? (state.order === "asc" ? "desc" : "asc") : sort === "name" ? "asc" : "desc",+ }),+ );+ };++ const columns: ResponsiveColumn<ExternalSystemSummaryEntry>[] = [+ {+ key: "name",+ header: "Package",+ priority: 1,+ sortable: true,+ cellClassName: "min-w-[220px]",+ render: (entry) => (+ <div className="min-w-0">+ <div className="flex items-start gap-2">+ <Box className="mt-0.5 h-4 w-4 shrink-0 text-[var(--color-text-tertiary)]" />+ <div className="min-w-0">+ <p className="break-words font-mono text-sm font-medium text-[var(--color-text-primary)]">+ {entry.display_name}+ </p>+ <p className="mt-0.5 text-xs text-[var(--color-text-tertiary)]">+ {entry.ecosystem} · {entry.category}+ </p>+ </div>+ </div>+ </div>+ ),+ },+ {+ key: "versions",+ header: "Versions",+ priority: 2,+ sortable: true,+ cellClassName: "min-w-[170px] max-w-[300px]",+ render: (entry) => <Versions entry={entry} />,+ },+ {+ key: "declarations",+ header: "Declarations",+ mobileLabel: "Declared",+ priority: 2,+ align: "right",+ sortable: true,+ render: (entry) => (+ <span className="font-mono text-xs tabular-nums">+ {entry.declaration_count} / {entry.manifest_count} manifest{entry.manifest_count === 1 ? "" : "s"}+ </span>+ ),+ },+ {+ key: "role",+ header: "Role",+ priority: 2,+ render: (entry) => <RoleLabel entry={entry} />,+ },+ {+ key: "importers",+ header: "Files",+ mobileLabel: "Importing files",+ priority: 1,+ align: "right",+ sortable: true,+ render: (entry) => <span className="font-mono tabular-nums">{entry.importing_file_count}</span>,+ },+ {+ key: "edges",+ header: "Edges",+ mobileLabel: "Import edges",+ priority: 3,+ align: "right",+ sortable: true,+ render: (entry) => <span className="font-mono tabular-nums">{entry.import_edge_count}</span>,+ },+ {+ key: "linkage",+ header: "Graph linkage",+ priority: 1,+ render: (entry) => <LinkageLabel entry={entry} />,+ },+ {+ key: "open",+ header: <span className="sr-only">Open</span>,+ priority: 3,+ align: "right",+ hideInCard: true,+ render: () => <ArrowRight className="ml-auto h-4 w-4 text-[var(--color-text-tertiary)]" aria-hidden />,+ },+ ];++ if (data.total_packages === 0) {+ return (+ <EmptyState+ icon={<Box className="h-6 w-6" />}+ title="No external dependencies recorded"+ description="No supported manifests declared third-party packages in this repository scope."+ />+ );+ }++ return (+ <div className="space-y-5">+ <dl className="grid grid-cols-2 border-y border-[var(--color-border-default)] sm:grid-cols-3 lg:grid-cols-6">+ {[+ ["Packages", data.total_packages],+ ["Declarations", data.total_declarations],+ ["Manifests", data.manifest_count],+ ["Observed", data.observed_packages],+ ["Dev-only", data.dev_only_packages],+ ["No graph link", data.unlinked_packages],+ ].map(([label, value]) => (+ <div key={String(label)} className="border-b border-[var(--color-table-divider)] px-3 py-3 last:border-b-0 sm:border-b-0 sm:border-r sm:last:border-r-0">+ <dt className="font-mono text-2xs uppercase tracking-wider text-[var(--color-text-tertiary)]">{label}</dt>+ <dd className="mt-1 text-[22px] font-semibold tabular-nums text-[var(--color-text-primary)]">{value}</dd>+ </div>+ ))}+ </dl>++ <div className="space-y-3">+ <div className="grid gap-2 sm:grid-cols-2 xl:grid-cols-[minmax(240px,1fr)_170px_170px_190px_170px_auto]">+ <label className="relative min-w-0">+ <span className="sr-only">Search packages</span>+ <Search className="pointer-events-none absolute left-3 top-2.5 h-4 w-4 text-[var(--color-text-tertiary)]" />+ <input+ type="search"+ value={state.query}+ onChange={(event) => onStateChange(updateState(state, { query: event.target.value }))}+ placeholder="Search packages or versions"+ className="h-9 w-full rounded-md border border-[var(--color-border-default)] bg-[var(--color-bg-surface)] pl-9 pr-3 text-sm text-[var(--color-text-primary)] outline-none placeholder:text-[var(--color-text-tertiary)] focus:ring-1 focus:ring-[var(--color-accent-primary)]"+ />+ </label>+ <Select value={state.ecosystem} onValueChange={(ecosystem) => onStateChange(updateState(state, { ecosystem }))}>+ <SelectTrigger aria-label="Filter by ecosystem"><SelectValue placeholder="All ecosystems" /></SelectTrigger>+ <SelectContent>+ <SelectItem value="all">All ecosystems</SelectItem>+ {data.ecosystems.map((ecosystem) => <SelectItem key={ecosystem} value={ecosystem}>{ecosystem}</SelectItem>)}+ </SelectContent>+ </Select>+ <Select value={state.role} onValueChange={(role) => onStateChange(updateState(state, { role: role as ExternalDependencyRole }))}>+ <SelectTrigger aria-label="Filter by dependency role"><SelectValue /></SelectTrigger>+ <SelectContent>+ <SelectItem value="all">Any role</SelectItem>+ <SelectItem value="runtime">Runtime</SelectItem>+ <SelectItem value="mixed">Runtime + dev</SelectItem>+ <SelectItem value="dev-only">Dev-only</SelectItem>+ </SelectContent>+ </Select>+ <Select value={state.usage} onValueChange={(usage) => onStateChange(updateState(state, { usage: usage as ExternalDependencyUsage }))}>+ <SelectTrigger aria-label="Filter by graph linkage"><SelectValue /></SelectTrigger>+ <SelectContent>+ <SelectItem value="all">Any graph state</SelectItem>+ <SelectItem value="observed">Observed imports</SelectItem>+ <SelectItem value="linked-unobserved">Linked, no imports</SelectItem>+ <SelectItem value="unlinked">No graph link</SelectItem>+ </SelectContent>+ </Select>+ <Select value={state.category} onValueChange={(category) => onStateChange(updateState(state, { category }))}>+ <SelectTrigger aria-label="Filter by package category"><SelectValue /></SelectTrigger>+ <SelectContent>+ <SelectItem value="all">Any category</SelectItem>+ {categories.map((category) => <SelectItem key={category} value={category}>{category}</SelectItem>)}+ </SelectContent>+ </Select>+ {activeFilters > 0 ? (+ <Button variant="ghost" size="sm" className="h-9" onClick={() => onStateChange({ ...DEFAULT_EXTERNAL_DEPENDENCY_STATE, sort: state.sort, order: state.order })}>+ Clear {activeFilters}+ </Button>+ ) : null}+ </div>++ <div className="flex flex-wrap items-center justify-between gap-2 text-xs text-[var(--color-text-tertiary)]">+ <p aria-live="polite">+ {filtered.length} {data.truncated ? "loaded " : ""}package{filtered.length === 1 ? "" : "s"} match · showing {pageRows.length ? (page - 1) * pageSize + 1 : 0}–{(page - 1) * pageSize + pageRows.length}+ </p>+ {data.truncated ? <p>Search, filters, and sorting apply to {data.returned} loaded packages out of {data.total_packages}.</p> : null}+ </div>+ </div>++ <ResponsiveTable+ rows={pageRows}+ rowKey={(entry) => entry.package_key}+ columns={columns}+ onRowClick={onSelectedChange}+ selectedKey={selected?.package_key}+ sortField={state.sort}+ sortOrder={state.order}+ onSort={handleSort}+ stacked="md"+ caption="External package declarations and persisted import-graph evidence"+ empty={+ <EmptyState+ title="No packages match these filters"+ description="Clear a filter or search for a different package, ecosystem, or version."+ action={{ label: "Clear filters", onClick: () => onStateChange(DEFAULT_EXTERNAL_DEPENDENCY_STATE) }}+ />+ }+ />++ {pageCount > 1 ? (+ <nav className="flex items-center justify-between" aria-label="Package pages">+ <Button variant="outline" size="sm" disabled={page === 1} onClick={() => onStateChange(updateState(state, { page: page - 1 }))}>+ <ChevronLeft className="h-4 w-4" /> Previous+ </Button>+ <span className="font-mono text-xs tabular-nums text-[var(--color-text-tertiary)]">Page {page} of {pageCount}</span>+ <Button variant="outline" size="sm" disabled={page === pageCount} onClick={() => onStateChange(updateState(state, { page: page + 1 }))}>+ Next <ChevronRight className="h-4 w-4" />+ </Button>+ </nav>+ ) : null}++ {data.truncated && onLoadMore ? (+ <div className="flex flex-col items-center gap-2 border-t border-[var(--color-border-default)] pt-4 text-center">+ {loadMoreError ? (+ <>+ <p className="text-xs text-[var(--color-error)]">+ More package summaries couldn't be loaded: {loadMoreError}+ </p>+ {onRetryLoadMore ? <Button variant="outline" size="sm" onClick={onRetryLoadMore}>Retry loading more</Button> : null}+ </>+ ) : (+ <>+ <p className="text-xs text-[var(--color-text-tertiary)]">+ {data.total_packages - data.returned} package summaries remain on the server.+ </p>+ <Button variant="outline" size="sm" onClick={onLoadMore} disabled={loadingMore}>+ {loadingMore ? "Loading more…" : `Load next ${Math.min(data.limit, data.total_packages - data.returned)}`}+ </Button>+ </>+ )}+ </div>+ ) : null}++ <PackageInspector+ entry={selected}+ evidence={evidence}+ evidenceLoading={evidenceLoading}+ evidenceError={evidenceError}+ graphHref={graphHref}+ renderFileLink={renderFileLink}+ onClose={() => onSelectedChange(null)}+ />+ </div>+ );+}diff --git a/packages/ui/src/dependencies/index.ts b/packages/ui/src/dependencies/index.tsindex 2216b6a9c..739c6e25b 100644--- a/packages/ui/src/dependencies/index.ts+++ b/packages/ui/src/dependencies/index.ts@@ -2,3 +2,13 @@ export {DependencyRegistry,type DependencyRegistryProps,} from "./dependency-registry";+export {+ DEFAULT_EXTERNAL_DEPENDENCY_STATE,+ ExternalDependenciesTable,+ type ExternalDependenciesTableProps,+ type ExternalDependencyRole,+ type ExternalDependencySort,+ type ExternalDependencyTableState,+ type ExternalDependencyUsage,+ type PackageGraphEvidence,+} from "./external-dependencies-table";diff --git a/packages/web/src/app/repos/[id]/architecture/page.tsx b/packages/web/src/app/repos/[id]/architecture/page.tsxindex 12b584ab1..f8efa5e7e 100644--- a/packages/web/src/app/repos/[id]/architecture/page.tsx+++ b/packages/web/src/app/repos/[id]/architecture/page.tsx@@ -95,7 +95,7 @@ const TAB_FOR_VIEW: Record<CanonicalView, string> = {const TABS: { id: string; label: string }[] = [{ id: "map", label: "Map" },{ id: "coupling", label: "Coupling" },- { id: "packages", label: "Packages" },+ { id: "packages", label: "Third-party" },{ id: "symbols", label: "Symbols" },];diff --git a/packages/web/src/components/architecture/dependencies-view.integration.test.tsx b/packages/web/src/components/architecture/dependencies-view.integration.test.tsxnew file mode 100644index 000000000..19ae859fd--- /dev/null+++ b/packages/web/src/components/architecture/dependencies-view.integration.test.tsx@@ -0,0 +1,143 @@+// @vitest-environment jsdom++import * as React from "react";+import { cleanup, fireEvent, render, screen } from "@testing-library/react";+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";+import type { ExternalSystemsSummary } from "@repowise-dev/types/external-systems";++const mocks = vi.hoisted(() => ({+ setQueryStates: vi.fn(),+ setPackage: vi.fn(),+ setScope: vi.fn(),+ infiniteResult: {} as Record<string, unknown>,+ focusedResult: {} as Record<string, unknown>,+ summaryKey: "",+}));++vi.mock("next/link", () => ({+ default: ({ children, ...props }: React.AnchorHTMLAttributes<HTMLAnchorElement>) => (+ <a {...props}>{children}</a>+ ),+}));++vi.mock("nuqs", () => {+ const parser = (defaultValue: unknown = null) => ({+ defaultValue,+ withDefault(value: unknown) {+ return parser(value);+ },+ });+ return {+ parseAsInteger: parser(),+ parseAsString: parser(),+ parseAsStringLiteral: () => parser(),+ useQueryState: (name: string, value: { defaultValue?: unknown }) => [+ value?.defaultValue ?? null,+ name === "package" ? mocks.setPackage : mocks.setScope,+ ],+ useQueryStates: (config: Record<string, { defaultValue?: unknown }>) => [+ Object.fromEntries(Object.entries(config).map(([key, value]) => [key, value.defaultValue])),+ mocks.setQueryStates,+ ],+ };+});++vi.mock("swr/infinite", () => ({+ default: (getKey: (index: number, previous: ExternalSystemsSummary | null) => string) => {+ mocks.summaryKey = getKey(0, null);+ return mocks.infiniteResult;+ },+}));++vi.mock("swr", () => ({ default: () => mocks.focusedResult }));+vi.mock("@repowise-dev/api-client", () => ({ apiGet: vi.fn() }));+vi.mock("@/lib/api/client", () => ({}));++vi.mock("@repowise-dev/ui/dependencies", async () => {+ const actual = await vi.importActual<typeof import("@repowise-dev/ui/dependencies")>(+ "@repowise-dev/ui/dependencies",+ );+ return {+ ...actual,+ ExternalDependenciesTable: (props: {+ onStateChange: (state: typeof actual.DEFAULT_EXTERNAL_DEPENDENCY_STATE) => void;+ onSelectedChange: (entry: { package_key: string }) => void;+ }) => (+ <div>+ <button+ onClick={() => props.onStateChange({ ...actual.DEFAULT_EXTERNAL_DEPENDENCY_STATE, query: "react", page: 2 })}+ >+ Change package query+ </button>+ <button onClick={() => props.onSelectedChange({ package_key: "npm:react" })}>+ Select package+ </button>+ </div>+ ),+ };+});++import { DependenciesView } from "./dependencies-view";++afterEach(cleanup);++const summary: ExternalSystemsSummary = {+ items: [],+ returned: 0,+ total_packages: 1,+ limit: 400,+ offset: 0,+ truncated: false,+ scope: "primary",+ excluded_declarations: 0,+ total_declarations: 1,+ runtime_packages: 1,+ dev_only_packages: 0,+ observed_packages: 0,+ linked_packages: 0,+ unlinked_packages: 1,+ linked_without_imports: 0,+ ecosystems: ["npm"],+ manifest_count: 1,+};++describe("DependenciesView wiring", () => {+ beforeEach(() => {+ vi.clearAllMocks();+ mocks.infiniteResult = {+ data: [summary],+ error: undefined,+ isLoading: false,+ isValidating: false,+ mutate: vi.fn(),+ size: 1,+ setSize: vi.fn(),+ };+ mocks.focusedResult = { data: undefined, error: undefined, isLoading: false };+ });++ it("starts from the bounded summary key and does not activate a graph request", () => {+ render(<DependenciesView repoId="repo-id" />);+ expect(mocks.summaryKey).toBe("external-systems-summary:repo-id:primary:0");+ expect(mocks.focusedResult).toEqual({ data: undefined, error: undefined, isLoading: false });+ });++ it("renders loading and error states", () => {+ mocks.infiniteResult = { ...mocks.infiniteResult, data: undefined, isLoading: true };+ const { rerender } = render(<DependenciesView repoId="repo-id" />);+ expect(screen.getByLabelText("Loading external dependencies")).toBeTruthy();++ mocks.infiniteResult = { ...mocks.infiniteResult, isLoading: false, error: new Error("offline") };+ rerender(<DependenciesView repoId="repo-id" />);+ expect(screen.getByText("Couldn't load external dependencies")).toBeTruthy();+ });++ it("writes controlled filter and package selection state back to the URL layer", () => {+ render(<DependenciesView repoId="repo-id" />);+ fireEvent.click(screen.getByRole("button", { name: "Change package query" }));+ expect(mocks.setQueryStates).toHaveBeenCalledWith(expect.objectContaining({ q: "react", page: 2 }));++ fireEvent.click(screen.getByRole("button", { name: "Select package" }));+ expect(mocks.setPackage).toHaveBeenCalledWith("npm:react");+ });+});diff --git a/packages/web/src/components/architecture/dependencies-view.test.ts b/packages/web/src/components/architecture/dependencies-view.test.tsnew file mode 100644index 000000000..a8c210f32--- /dev/null+++ b/packages/web/src/components/architecture/dependencies-view.test.ts@@ -0,0 +1,80 @@+import { describe, expect, it } from "vitest";+import type { NodeSearchResult } from "../../lib/api/types";+import {+ chooseExternalPackageNode,+ packageSummaryRequest,+ PACKAGE_SUMMARY_LIMIT,+} from "./package-graph";+import {+ DEFAULT_PACKAGE_QUERY_VALUES,+ queryFromTableState,+ tableStateFromQuery,+} from "./package-query-state";++function candidate(node_id: string): NodeSearchResult {+ return { node_id, language: "", symbol_count: 0 };+}++describe("chooseExternalPackageNode", () => {+ it("prefers the exact package node over subpaths and fuzzy matches", () => {+ expect(+ chooseExternalPackageNode(+ [candidate("external:react-dom"), candidate("external:react/jsx-runtime"), candidate("external:react")],+ "react",+ ),+ ).toBe("external:react");+ });++ it("falls back to a package subpath and ignores repository files", () => {+ expect(+ chooseExternalPackageNode(+ [candidate("packages/react/index.ts"), candidate("external:@scope/pkg/subpath")],+ "@scope/pkg",+ ),+ ).toBe("external:@scope/pkg/subpath");+ });++ it("returns null when node search has no external match", () => {+ expect(chooseExternalPackageNode([candidate("src/pkg.py")], "pkg")).toBeNull();+ });++ it("does not fuzzy-focus a sibling package", () => {+ expect(chooseExternalPackageNode([candidate("external:react-dom")], "react")).toBeNull();+ });+});++describe("package query state", () => {+ it("round-trips shareable filter, sort, and page state", () => {+ const state = tableStateFromQuery({+ ...DEFAULT_PACKAGE_QUERY_VALUES,+ q: "react",+ ecosystem: "npm",+ usage: "observed",+ sort: "edges",+ order: "asc",+ page: 3,+ });+ expect(queryFromTableState(state)).toEqual({+ ...DEFAULT_PACKAGE_QUERY_VALUES,+ q: "react",+ ecosystem: "npm",+ usage: "observed",+ sort: "edges",+ order: "asc",+ page: 3,+ });+ });++ it("clamps invalid URL pages to the first page", () => {+ expect(tableStateFromQuery({ ...DEFAULT_PACKAGE_QUERY_VALUES, page: -4 }).page).toBe(1);+ });+});++describe("initial package request", () => {+ it("uses one bounded summary resource rather than a graph endpoint", () => {+ const request = packageSummaryRequest("repo-id", "primary");+ expect(request.path).toBe("/api/repos/repo-id/external-systems/summary");+ expect(request.path).not.toContain("/api/graph/");+ expect(request.params).toEqual({ scope: "primary", limit: PACKAGE_SUMMARY_LIMIT });+ });+});diff --git a/packages/web/src/components/architecture/dependencies-view.tsx b/packages/web/src/components/architecture/dependencies-view.tsxindex afa4b6813..93d625976 100644--- a/packages/web/src/components/architecture/dependencies-view.tsx+++ b/packages/web/src/components/architecture/dependencies-view.tsx@@ -1,63 +1,266 @@"use client";-import useSWR from "swr";+import React, { useCallback, useEffect, useMemo, useRef } from "react";import Link from "next/link";import { Package } from "lucide-react";-import { DependencyRegistry } from "@repowise-dev/ui/dependencies";+import useSWR from "swr";+import useSWRInfinite from "swr/infinite";+import {+ parseAsInteger,+ parseAsString,+ parseAsStringLiteral,+ useQueryState,+ useQueryStates,+} from "nuqs";+import {+ ExternalDependenciesTable,+ type ExternalDependencyTableState,+ type PackageGraphEvidence,+} from "@repowise-dev/ui/dependencies";import { ApiError } from "@repowise-dev/ui/shared/api-error";-import { Skeleton } from "@repowise-dev/ui/ui/skeleton";import { fileEntityPath } from "@repowise-dev/ui/shared/entity";-import { getExternalSystems } from "@/lib/api/external-systems";+import { Skeleton } from "@repowise-dev/ui/ui/skeleton";import { toFriendlyMessage } from "@repowise-dev/ui/lib/errors";+import type {+ ExternalSystemSummaryEntry,+ ExternalSystemsSummary,+} from "@repowise-dev/types/external-systems";+import { apiGet } from "@repowise-dev/api-client";+import type { EgoGraphResponse, NodeSearchResult } from "@/lib/api/types";+import "@/lib/api/client";+import {+ chooseExternalPackageNode,+ packageSummaryRequest,+ PACKAGE_SUMMARY_LIMIT,+} from "./package-graph";+import { queryFromTableState, tableStateFromQuery } from "./package-query-state";++const ROLES = ["all", "runtime", "dev-only", "mixed"] as const;+const USAGE_STATES = ["all", "observed", "linked-unobserved", "unlinked"] as const;+const SORTS = ["importers", "edges", "name", "declarations", "manifests", "versions"] as const;+const ORDERS = ["asc", "desc"] as const;+const SCOPES = ["primary", "all"] as const;++async function getFocusedPackageEvidence(+ repoId: string,+ entry: ExternalSystemSummaryEntry,+ signal: AbortSignal,+): Promise<PackageGraphEvidence> {+ const candidates = await apiGet<NodeSearchResult[]>(+ `/api/graph/${repoId}/nodes/search`,+ { q: entry.name, limit: 20 },+ { signal },+ );+ const centerNodeId = chooseExternalPackageNode(candidates, entry.name);+ if (!centerNodeId) throw new Error("No matching external graph node was returned for this package.");++ const ego = await apiGet<EgoGraphResponse>(+ `/api/graph/${repoId}/ego`,+ { node_id: centerNodeId, hops: 1 },+ { signal },+ );+ const importingFiles = [+ ...new Set(+ ego.links+ .filter((link) => link.target === centerNodeId && link.source !== centerNodeId)+ .map((link) => link.source),+ ),+ ].sort();++ return {+ centerNodeId,+ importingFiles,+ importEdgeCount: ego.links.filter((link) => link.target === centerNodeId).length,+ totalNodes: ego.nodes.length,+ };+}export function DependenciesView({ repoId }: { repoId: string }) {- const { data, error, isLoading, mutate } = useSWR(- `external-systems:${repoId}`,- () => getExternalSystems(repoId),- { revalidateOnFocus: false },+ const summaryAbortRef = useRef<AbortController | null>(null);+ const evidenceAbortRef = useRef<AbortController | null>(null);+ const [scope, setScope] = useQueryState(+ "scope",+ parseAsStringLiteral(SCOPES).withDefault("primary"),+ );+ const [selectedKey, setSelectedKey] = useQueryState("package", parseAsString);+ const [queryState, setQueryState] = useQueryStates({+ q: parseAsString.withDefault(""),+ ecosystem: parseAsString.withDefault("all"),+ role: parseAsStringLiteral(ROLES).withDefault("all"),+ usage: parseAsStringLiteral(USAGE_STATES).withDefault("all"),+ category: parseAsString.withDefault("all"),+ sort: parseAsStringLiteral(SORTS).withDefault("importers"),+ order: parseAsStringLiteral(ORDERS).withDefault("desc"),+ page: parseAsInteger.withDefault(1),+ });++ const fetchSummary = useCallback((offset: number) => {+ summaryAbortRef.current?.abort();+ const controller = new AbortController();+ summaryAbortRef.current = controller;+ const request = packageSummaryRequest(repoId, scope);+ return apiGet<ExternalSystemsSummary>(+ request.path,+ { ...request.params, offset },+ { signal: controller.signal },+ );+ }, [repoId, scope]);++ const {+ data: summaryPages,+ error,+ isLoading,+ isValidating: summaryValidating,+ mutate,+ size,+ setSize,+ } = useSWRInfinite(+ (pageIndex, previous: ExternalSystemsSummary | null) => {+ if (previous && !previous.truncated) return null;+ return `external-systems-summary:${repoId}:${scope}:${pageIndex * PACKAGE_SUMMARY_LIMIT}`;+ },+ (key: string) => {+ const offset = Number(key.split(":").pop() ?? 0);+ return fetchSummary(offset);+ },+ { revalidateOnFocus: false, revalidateOnReconnect: false, persistSize: false },+ );++ const data = useMemo<ExternalSystemsSummary | undefined>(() => {+ if (!summaryPages?.length) return undefined;+ const first = summaryPages[0]!;+ const last = summaryPages[summaryPages.length - 1]!;+ const items = summaryPages.flatMap((page) => page.items);+ return {+ ...first,+ items,+ returned: items.length,+ offset: 0,+ truncated: last.truncated,+ };+ }, [summaryPages]);++ const selected = useMemo(+ () => data?.items.find((entry) => entry.package_key === selectedKey) ?? null,+ [data?.items, selectedKey],+ );++ // Focused graph evidence is deliberately dormant on the initial page.+ // Selecting a linked row activates node search plus a one-hop ego request.+ const fetchEvidence = useCallback(() => {+ evidenceAbortRef.current?.abort();+ const controller = new AbortController();+ evidenceAbortRef.current = controller;+ return getFocusedPackageEvidence(repoId, selected!, controller.signal);+ }, [repoId, selected]);+ const {+ data: evidence,+ error: evidenceError,+ isLoading: evidenceLoading,+ } = useSWR(+ selected?.link_state === "linked"+ ? `external-system-evidence:${repoId}:${selected.package_key}`+ : null,+ fetchEvidence,+ { revalidateOnFocus: false, revalidateOnReconnect: false },+ );++ useEffect(() => {+ if (!selected || selected.link_state !== "linked") evidenceAbortRef.current?.abort();+ }, [selected]);+ useEffect(+ () => () => {+ summaryAbortRef.current?.abort();+ evidenceAbortRef.current?.abort();+ },+ [],);+ const tableState: ExternalDependencyTableState = tableStateFromQuery(queryState);++ const handleTableStateChange = (next: ExternalDependencyTableState) => {+ void setQueryState(queryFromTableState(next));+ };+return (- <div className="max-w-[1600px] space-y-6 p-4 sm:p-6">- <div>- <h1 className="mb-1 flex items-center gap-2 text-xl font-semibold text-[var(--color-text-primary)]">- <Package className="h-5 w-5 text-[var(--color-accent-primary)]" />- {/* Matches the tab. "Dependencies" collided with the Map tab, which- IS the dependency graph — this page is the declared package- manifest, which is a different thing entirely. */}- Packages- </h1>- <p className="text-sm text-[var(--color-text-secondary)]">- Third-party dependencies declared in this repo's manifests.- </p>+ <div className="max-w-[1600px] space-y-5 p-4 sm:p-6">+ <div className="flex flex-col gap-3 border-b border-[var(--color-border-default)] pb-4 sm:flex-row sm:items-start sm:justify-between">+ <div className="min-w-0">+ <h1 className="mb-1 flex items-center gap-2 text-xl font-semibold text-[var(--color-text-primary)]">+ <Package className="h-5 w-5 text-[var(--color-accent-primary)]" />+ External dependencies+ </h1>+ <p className="max-w-3xl text-sm text-[var(--color-text-secondary)]">+ Declared third-party packages, joined to persisted import-graph evidence. Select a package to inspect declaration counts, versions, and importing files.+ </p>+ </div>+ {(scope === "all" || (data?.excluded_declarations ?? 0) > 0) ? <div className="shrink-0">+ <label className="flex items-center gap-2 text-xs text-[var(--color-text-secondary)]">+ <input+ type="checkbox"+ checked={scope === "all"}+ onChange={(event) => {+ void setScope(event.target.checked ? "all" : "primary");+ void setSelectedKey(null);+ handleTableStateChange({ ...tableState, page: 1 });+ }}+ className="h-4 w-4 rounded border-[var(--color-border-default)] accent-[var(--color-accent-primary)]"+ />+ Include auxiliary declarations+ </label>+ <p className="mt-1 max-w-xs text-right text-2xs text-[var(--color-text-tertiary)]">+ {scope === "primary"+ ? `${data?.excluded_declarations ?? 0} declarations from auxiliary directories excluded`+ : "Showing primary and auxiliary directories present in this indexed checkout"}+ </p>+ </div> : null}</div>- {error ? (+ {error && !data ? (<ApiError- title="Couldn't load the dependency registry"+ title="Couldn't load external dependencies"message={toFriendlyMessage(error)}onRetry={() => void mutate()}/>) : isLoading || !data ? (- <div className="space-y-3">- <Skeleton className="h-8 w-72" />- <div className="grid grid-cols-1 gap-2 sm:grid-cols-2 xl:grid-cols-3">- {Array.from({ length: 6 }).map((_, i) => (- <Skeleton key={i} className="h-20" />- ))}- </div>+ <div className="space-y-4" aria-label="Loading external dependencies">+ <Skeleton className="h-20 w-full" />+ <Skeleton className="h-9 w-full" />+ {Array.from({ length: 8 }).map((_, index) => (+ <Skeleton key={index} className="h-12 w-full" />+ ))}</div>) : (- <DependencyRegistry+ <ExternalDependenciesTabledata={data}- renderManifestLink={(declaredIn, children) => (+ state={tableState}+ onStateChange={handleTableStateChange}+ selected={selected}+ onSelectedChange={(entry) => void setSelectedKey(entry?.package_key ?? null)}+ evidence={evidence}+ evidenceLoading={evidenceLoading}+ evidenceError={+ evidenceError+ ? `Focused graph evidence couldn't be loaded: ${toFriendlyMessage(evidenceError)}`+ : null+ }+ graphHref={+ evidence+ ? `/repos/${repoId}/architecture?view=files&node=${encodeURIComponent(evidence.centerNodeId)}`+ : undefined+ }+ renderFileLink={(path, children) => (<Link- href={fileEntityPath(`/repos/${repoId}`, declaredIn)}+ href={fileEntityPath(`/repos/${repoId}`, path)}className="hover:text-[var(--color-accent-primary)] hover:underline">{children}</Link>)}+ onLoadMore={data.truncated ? () => void setSize(size + 1) : undefined}+ loadingMore={summaryValidating && summaryPages !== undefined}+ loadMoreError={error ? toFriendlyMessage(error) : null}+ onRetryLoadMore={error ? () => void mutate() : undefined}/>)}</div>diff --git a/packages/web/src/components/architecture/package-graph.ts b/packages/web/src/components/architecture/package-graph.tsnew file mode 100644index 000000000..26db4e5e5--- /dev/null+++ b/packages/web/src/components/architecture/package-graph.ts@@ -0,0 +1,31 @@+import type { NodeSearchResult } from "../../lib/api/types";+import type { ExternalSystemsSummaryScope } from "@repowise-dev/types/external-systems";++export const PACKAGE_SUMMARY_LIMIT = 400;++export function packageSummaryRequest(repoId: string, scope: ExternalSystemsSummaryScope) {+ return {+ path: `/api/repos/${repoId}/external-systems/summary`,+ params: { scope, limit: PACKAGE_SUMMARY_LIMIT },+ } as const;+}++function externalCandidateScore(candidate: NodeSearchResult, packageName: string): number {+ const nodeId = candidate.node_id.toLowerCase();+ const expected = `external:${packageName}`.toLowerCase();+ if (nodeId === expected) return 3;+ if (nodeId.startsWith(`${expected}/`) || nodeId.startsWith(`${expected}:`)) return 2;+ return 0;+}++export function chooseExternalPackageNode(+ candidates: NodeSearchResult[],+ packageName: string,+): string | null {+ return candidates+ .filter((candidate) => candidate.node_id.startsWith("external:"))+ .map((candidate) => ({ candidate, score: externalCandidateScore(candidate, packageName) }))+ .filter(({ score }) => score > 0)+ .sort((a, b) => b.score - a.score || a.candidate.node_id.localeCompare(b.candidate.node_id))[0]+ ?.candidate.node_id ?? null;+}diff --git a/packages/web/src/components/architecture/package-query-state.ts b/packages/web/src/components/architecture/package-query-state.tsnew file mode 100644index 000000000..0f2bc55cd--- /dev/null+++ b/packages/web/src/components/architecture/package-query-state.ts@@ -0,0 +1,48 @@+import {+ DEFAULT_EXTERNAL_DEPENDENCY_STATE,+ type ExternalDependencyRole,+ type ExternalDependencySort,+ type ExternalDependencyTableState,+ type ExternalDependencyUsage,+} from "@repowise-dev/ui/dependencies";++export interface PackageQueryValues {+ q: string;+ ecosystem: string;+ role: ExternalDependencyRole;+ usage: ExternalDependencyUsage;+ category: string;+ sort: ExternalDependencySort;+ order: "asc" | "desc";+ page: number;+}++export function tableStateFromQuery(values: PackageQueryValues): ExternalDependencyTableState {+ return {+ query: values.q,+ ecosystem: values.ecosystem,+ role: values.role,+ usage: values.usage,+ category: values.category,+ sort: values.sort,+ order: values.order,+ page: Math.max(1, values.page),+ };+}++export function queryFromTableState(state: ExternalDependencyTableState): PackageQueryValues {+ return {+ q: state.query,+ ecosystem: state.ecosystem,+ role: state.role,+ usage: state.usage,+ category: state.category,+ sort: state.sort,+ order: state.order,+ page: Math.max(1, state.page),+ };+}++export const DEFAULT_PACKAGE_QUERY_VALUES: PackageQueryValues = queryFromTableState(+ DEFAULT_EXTERNAL_DEPENDENCY_STATE,+);diff --git a/packages/web/vitest.config.ts b/packages/web/vitest.config.tsindex 37a6fab48..8d0405a66 100644--- a/packages/web/vitest.config.ts+++ b/packages/web/vitest.config.ts@@ -1,7 +1,11 @@import { defineConfig } from "vitest/config";+import path from "node:path";export default defineConfig({test: {include: ["src/**/*.{test,spec}.{ts,tsx}"],},+ resolve: {+ alias: { "@": path.resolve(__dirname, "src") },+ },});