@git-snitch/renderer 0.0.3

package/dist/inline-plugin.d.ts

@@ -0,0 +1,13 @@
+import type { Plugin } from "vite";
+export interface InlineHtmlAsset {
+    readonly fileName: string;
+    readonly source: string;
+    readonly kind: "script" | "style";
+}
+export interface InlineHtmlResult {
+    readonly html: string;
+    readonly inlinedFileNames: readonly string[];
+}
+export declare function inlineHtmlAssets(html: string, assets: readonly InlineHtmlAsset[]): InlineHtmlResult;
+export declare function createInlineHtmlPlugin(): Plugin;
+//# sourceMappingURL=inline-plugin.d.ts.map

package/dist/inline-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inline-plugin.d.ts","sourceRoot":"","sources":["../src/inline-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAEnC,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC;CACnC;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;CAC9C;AAYD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,eAAe,EAAE,GAAG,gBAAgB,CA+CnG;AAMD,wBAAgB,sBAAsB,IAAI,MAAM,CA8C/C"}

package/dist/inline-plugin.js

@@ -0,0 +1,81 @@
+function normalizeAssetReference(reference) {
+    return reference.replace(/^\.\//, "").replace(/^\//, "");
+}
+function findInlineAsset(assets, reference, kind) {
+    const normalizedReference = normalizeAssetReference(reference);
+    return assets.find((asset) => asset.kind === kind && asset.fileName === normalizedReference);
+}
+export function inlineHtmlAssets(html, assets) {
+    const inlined = new Set();
+    let output = html.replace(/<link\s+[^>]*rel=["']modulepreload["'][^>]*>/g, "");
+    output = output.replace(/<script\s+([^>]*?)src=["']([^"']+)["']([^>]*)><\/script>/g, (tag, beforeAttributes, source, afterAttributes) => {
+        const asset = findInlineAsset(assets, source, "script");
+        if (!asset) {
+            return tag;
+        }
+        inlined.add(asset.fileName);
+        const attributes = `${beforeAttributes} ${afterAttributes}`.replace(/\s*crossorigin(?:=["'][^"']*["'])?/, "").trim();
+        const attributeText = attributes.length > 0 ? ` ${attributes}` : "";
+        return `<script${attributeText}>\n${asset.source}\n</script>`;
+    });
+    output = output.replace(/<link\s+([^>]*?)rel=["']stylesheet["']([^>]*?)href=["']([^"']+)["']([^>]*)>/g, (tag, beforeAttributes, middleAttributes, href) => {
+        const asset = findInlineAsset(assets, href, "style");
+        if (!asset) {
+            return tag;
+        }
+        inlined.add(asset.fileName);
+        const mediaMatch = `${beforeAttributes} ${middleAttributes}`.match(/\smedia=["']([^"']+)["']/);
+        const mediaAttribute = mediaMatch ? ` media="${mediaMatch[1]}"` : "";
+        return `<style${mediaAttribute}>\n${asset.source}\n</style>`;
+    });
+    output = output.replace(/<link\s+([^>]*?)href=["']([^"']+)["']([^>]*?)rel=["']stylesheet["']([^>]*)>/g, (tag, beforeAttributes, href, middleAttributes) => {
+        const asset = findInlineAsset(assets, href, "style");
+        if (!asset) {
+            return tag;
+        }
+        inlined.add(asset.fileName);
+        const mediaMatch = `${beforeAttributes} ${middleAttributes}`.match(/\smedia=["']([^"']+)["']/);
+        const mediaAttribute = mediaMatch ? ` media="${mediaMatch[1]}"` : "";
+        return `<style${mediaAttribute}>\n${asset.source}\n</style>`;
+    });
+    return { html: output, inlinedFileNames: [...inlined] };
+}
+function sourceToString(source) {
+    return typeof source === "string" ? source : new TextDecoder().decode(source);
+}
+export function createInlineHtmlPlugin() {
+    return {
+        name: "git-snitch-inline-html",
+        enforce: "post",
+        generateBundle(_options, bundle) {
+            const htmlEntries = [];
+            const assets = [];
+            for (const [fileName, entry] of Object.entries(bundle)) {
+                if (entry.type === "chunk") {
+                    assets.push({ fileName: entry.fileName, source: entry.code, kind: "script" });
+                }
+                if (entry.type === "asset" && entry.fileName.endsWith(".css")) {
+                    assets.push({ fileName: entry.fileName, source: sourceToString(entry.source), kind: "style" });
+                }
+                if (entry.type === "asset" && entry.fileName.endsWith(".html")) {
+                    htmlEntries.push({ fileName, asset: entry });
+                }
+            }
+            if (htmlEntries.length !== 1) {
+                throw new Error(`Expected exactly one HTML asset to inline, found ${htmlEntries.length}.`);
+            }
+            const htmlEntry = htmlEntries[0];
+            if (!htmlEntry) {
+                throw new Error("Expected one HTML asset to inline, but none was available after validation.");
+            }
+            const result = inlineHtmlAssets(sourceToString(htmlEntry.asset.source), assets);
+            htmlEntry.asset.source = result.html;
+            for (const fileName of result.inlinedFileNames) {
+                delete bundle[fileName];
+            }
+            if (htmlEntry.fileName !== "report-template.html") {
+                throw new Error(`Expected Vite to emit report-template.html, received ${htmlEntry.fileName}.`);
+            }
+        },
+    };
+}

package/dist/layout.d.ts

@@ -0,0 +1,43 @@
+import type { ReactNode } from "react";
+export type NavigationItem = {
+    readonly label: string;
+    readonly href: string;
+    readonly current?: boolean;
+    readonly disabled?: boolean;
+};
+export type StatItem = {
+    readonly label: string;
+    readonly value: string | number;
+    readonly description?: string;
+};
+type HeaderProps = {
+    readonly title: string;
+    readonly titleHref?: string;
+    readonly eyebrow?: string;
+    readonly description?: string;
+    readonly actions?: ReactNode;
+};
+type NavigationProps = {
+    readonly items: readonly NavigationItem[];
+    readonly label?: string;
+};
+type StatsGridProps = {
+    readonly stats: readonly StatItem[];
+    readonly emptyTitle?: string;
+    readonly emptyDescription?: string;
+};
+type AppShellProps = {
+    readonly title: string;
+    readonly titleHref?: string;
+    readonly eyebrow?: string;
+    readonly description?: string;
+    readonly navigationItems?: readonly NavigationItem[];
+    readonly headerActions?: ReactNode;
+    readonly children: ReactNode;
+};
+export declare function Header({ title, titleHref, eyebrow, description, actions }: HeaderProps): import("react/jsx-runtime").JSX.Element;
+export declare function Navigation({ items, label }: NavigationProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function StatsGrid({ stats, emptyTitle, emptyDescription, }: StatsGridProps): import("react/jsx-runtime").JSX.Element;
+export declare function AppShell({ title, titleHref, eyebrow, description, navigationItems, headerActions, children, }: AppShellProps): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=layout.d.ts.map

package/dist/layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../src/layout.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAKvC,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IAChC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B,CAAC;AAEF,KAAK,WAAW,GAAG;IACjB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,CAAC;CAC9B,CAAC;AAEF,KAAK,eAAe,GAAG;IACrB,QAAQ,CAAC,KAAK,EAAE,SAAS,cAAc,EAAE,CAAC;IAC1C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,KAAK,cAAc,GAAG;IACpB,QAAQ,CAAC,KAAK,EAAE,SAAS,QAAQ,EAAE,CAAC;IACpC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CACpC,CAAC;AAEF,KAAK,aAAa,GAAG;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;IACrD,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,CAAC;IACnC,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;CAC9B,CAAC;AAEF,wBAAgB,MAAM,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,WAAW,2CAwBtF;AAED,wBAAgB,UAAU,CAAC,EAAE,KAAK,EAAE,KAAyB,EAAE,EAAE,eAAe,kDA+B/E;AAED,wBAAgB,SAAS,CAAC,EACxB,KAAK,EACL,UAAuC,EACvC,gBAAqF,GACtF,EAAE,cAAc,2CAoBhB;AAED,wBAAgB,QAAQ,CAAC,EACvB,KAAK,EACL,SAAS,EACT,OAAO,EACP,WAAW,EACX,eAAoB,EACpB,aAAa,EACb,QAAQ,GACT,EAAE,aAAa,2CAQf"}

package/dist/layout.js

@@ -0,0 +1,25 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { buttonVariants } from "@git-snitch/ui/components/button";
+import { Card, CardContent, CardHeader, CardTitle } from "@git-snitch/ui/components/card";
+import { cn } from "@git-snitch/ui/lib/utils";
+import { EmptyState } from "./empty-state.js";
+import { ThemeToggle } from "./theme-toggle.js";
+export function Header({ title, titleHref, eyebrow, description, actions }) {
+    const titleContent = _jsx("h1", { className: "mt-3 text-3xl font-semibold tracking-tight text-foreground sm:text-4xl", children: title });
+    return (_jsx("header", { className: "border-b bg-background/95 backdrop-blur supports-[backdrop-filter]:bg-background/75", children: _jsxs("div", { className: "mx-auto flex w-full max-w-7xl flex-col gap-6 px-5 py-8 sm:px-8 lg:flex-row lg:items-end lg:justify-between", children: [_jsxs("div", { className: "max-w-4xl", children: [eyebrow ? _jsx("p", { className: "text-xs font-medium uppercase tracking-[0.24em] text-muted-foreground", children: eyebrow }) : null, titleHref ? (_jsx("a", { href: titleHref, target: "_blank", rel: "noopener noreferrer", className: "hover:underline", children: titleContent })) : (titleContent), description ? _jsx("p", { className: "mt-3 max-w-2xl text-sm leading-6 text-muted-foreground", children: description }) : null] }), _jsxs("div", { className: "flex flex-wrap items-center gap-2", children: [actions, _jsx(ThemeToggle, {})] })] }) }));
+}
+export function Navigation({ items, label = "Report sections" }) {
+    if (items.length === 0) {
+        return null;
+    }
+    return (_jsx("nav", { "aria-label": label, className: "border-b bg-background/80", children: _jsx("div", { className: "mx-auto flex w-full max-w-7xl gap-2 overflow-x-auto px-5 py-3 sm:px-8", children: items.map((item) => item.disabled ? (_jsx("span", { "aria-disabled": "true", className: "inline-flex h-8 shrink-0 items-center border border-transparent px-3 text-xs font-medium text-muted-foreground/60", children: item.label }, item.href)) : (_jsx("a", { href: item.href, "aria-current": item.current ? "page" : undefined, className: buttonVariants({ variant: item.current ? "secondary" : "ghost", size: "sm", className: "shrink-0" }), children: item.label }, item.href))) }) }));
+}
+export function StatsGrid({ stats, emptyTitle = "No report statistics yet", emptyDescription = "This report does not include enough data for summary statistics.", }) {
+    if (stats.length === 0) {
+        return _jsx(EmptyState, { title: emptyTitle, description: emptyDescription });
+    }
+    return (_jsx("section", { "aria-label": "Report summary statistics", className: "grid grid-flow-dense gap-3 sm:grid-cols-2 lg:grid-cols-4", children: stats.map((stat) => (_jsxs(Card, { className: "min-h-32 shadow-none", children: [_jsx(CardHeader, { children: _jsx(CardTitle, { className: "text-xs font-medium uppercase tracking-[0.18em] text-muted-foreground", children: stat.label }) }), _jsxs(CardContent, { children: [_jsx("p", { className: "text-3xl font-semibold tracking-tight text-foreground", children: stat.value }), stat.description ? _jsx("p", { className: "mt-2 text-xs leading-5 text-muted-foreground", children: stat.description }) : null] })] }, stat.label))) }));
+}
+export function AppShell({ title, titleHref, eyebrow, description, navigationItems = [], headerActions, children, }) {
+    return (_jsxs("main", { className: "min-h-screen w-full max-w-full overflow-x-hidden bg-background text-foreground transition-colors", children: [_jsx(Header, { title: title, titleHref: titleHref, eyebrow: eyebrow, description: description, actions: headerActions }), _jsx(Navigation, { items: navigationItems }), _jsx("div", { className: cn("mx-auto flex w-full max-w-7xl flex-col gap-8 px-5 py-8 sm:px-8 sm:py-10"), children: children })] }));
+}

package/dist/remote-urls.d.ts

@@ -0,0 +1,6 @@
+export type GitProvider = "github" | "gitlab" | "bitbucket" | "unknown";
+export declare function normalizeRemoteToWebUrl(remoteUrl: string): string;
+export declare function detectProvider(remoteUrl: string | undefined): GitProvider;
+export declare function buildCommitUrl(remoteUrl: string | undefined, hash: string): string | undefined;
+export declare function buildFileUrl(remoteUrl: string | undefined, branch: string | undefined, filePath: string): string | undefined;
+//# sourceMappingURL=remote-urls.d.ts.map

package/dist/remote-urls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-urls.d.ts","sourceRoot":"","sources":["../src/remote-urls.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,WAAW,GAAG,SAAS,CAAC;AAIxE,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAmBjE;AAED,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,WAAW,CAqBzE;AAED,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAkB9F;AAED,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAkB5H"}

package/dist/remote-urls.js

@@ -0,0 +1,82 @@
+const SCP_REMOTE = /^git@([^:]+):(.+?)$/;
+export function normalizeRemoteToWebUrl(remoteUrl) {
+    const trimmed = remoteUrl.replace(/\/+$/, "");
+    const scpMatch = SCP_REMOTE.exec(trimmed);
+    if (scpMatch && scpMatch[1] !== undefined && scpMatch[2] !== undefined) {
+        return `https://${scpMatch[1]}/${scpMatch[2].replace(/\.git$/, "")}`;
+    }
+    if (trimmed.startsWith("ssh://")) {
+        try {
+            const parsed = new URL(trimmed);
+            const path = parsed.pathname.replace(/^\/+/, "").replace(/\.git$/, "");
+            return `https://${parsed.hostname}/${path}`;
+        }
+        catch {
+            return trimmed.replace(/\.git$/, "");
+        }
+    }
+    return trimmed.replace(/\.git$/, "");
+}
+export function detectProvider(remoteUrl) {
+    if (remoteUrl === undefined) {
+        return "unknown";
+    }
+    const host = extractHost(remoteUrl);
+    if (host === undefined) {
+        return "unknown";
+    }
+    if (host === "github.com" || host.endsWith(".github.com")) {
+        return "github";
+    }
+    if (host === "gitlab.com" || host.endsWith(".gitlab.com")) {
+        return "gitlab";
+    }
+    if (host === "bitbucket.org" || host.endsWith(".bitbucket.org")) {
+        return "bitbucket";
+    }
+    return "unknown";
+}
+export function buildCommitUrl(remoteUrl, hash) {
+    if (remoteUrl === undefined) {
+        return undefined;
+    }
+    const provider = detectProvider(remoteUrl);
+    const base = normalizeRemoteToWebUrl(remoteUrl);
+    switch (provider) {
+        case "github":
+            return `${base}/commit/${hash}`;
+        case "gitlab":
+            return `${base}/-/commit/${hash}`;
+        case "bitbucket":
+            return `${base}/commits/${hash}`;
+        default:
+            return `${base}/commit/${hash}`;
+    }
+}
+export function buildFileUrl(remoteUrl, branch, filePath) {
+    if (remoteUrl === undefined || branch === undefined) {
+        return undefined;
+    }
+    const provider = detectProvider(remoteUrl);
+    const base = normalizeRemoteToWebUrl(remoteUrl);
+    switch (provider) {
+        case "github":
+            return `${base}/blob/${branch}/${filePath}`;
+        case "gitlab":
+            return `${base}/-/blob/${branch}/${filePath}`;
+        case "bitbucket":
+            return `${base}/src/${branch}/${filePath}`;
+        default:
+            return `${base}/blob/${branch}/${filePath}`;
+    }
+}
+function extractHost(remoteUrl) {
+    try {
+        const parsed = new URL(remoteUrl);
+        return parsed.hostname;
+    }
+    catch {
+        const scpMatch = SCP_REMOTE.exec(remoteUrl);
+        return scpMatch?.[1];
+    }
+}

package/dist/serialization.d.ts

@@ -0,0 +1,5 @@
+import type { ReportData } from "@git-snitch/core";
+export declare const REPORT_DATA_PLACEHOLDER = "__GIT_SNITCH_REPORT_DATA__";
+export declare function serializeReportDataForHtml(report: ReportData): string;
+export declare function injectReportDataIntoHtml(templateHtml: string, report: ReportData): string;
+//# sourceMappingURL=serialization.d.ts.map

package/dist/serialization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialization.d.ts","sourceRoot":"","sources":["../src/serialization.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,eAAO,MAAM,uBAAuB,+BAA+B,CAAC;AAyBpE,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAerE;AAED,wBAAgB,wBAAwB,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,MAAM,CAazF"}

package/dist/serialization.js

@@ -0,0 +1,46 @@
+export const REPORT_DATA_PLACEHOLDER = "__GIT_SNITCH_REPORT_DATA__";
+const escapedCharacters = /[<>&\u2028\u2029]/g;
+function escapeCharacter(character) {
+    switch (character) {
+        case "<":
+            return "\\u003c";
+        case ">":
+            return "\\u003e";
+        case "&":
+            return "\\u0026";
+        case "\u2028":
+            return "\\u2028";
+        case "\u2029":
+            return "\\u2029";
+        default:
+            return character;
+    }
+}
+function escapeJsonForScript(json) {
+    return json.replace(escapedCharacters, escapeCharacter);
+}
+export function serializeReportDataForHtml(report) {
+    let json;
+    try {
+        json = JSON.stringify(report);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : "unknown serialization error";
+        throw new Error(`Report data could not be serialized for HTML injection: ${message}`);
+    }
+    if (json === undefined) {
+        throw new Error("Report data could not be serialized for HTML injection: JSON.stringify returned undefined.");
+    }
+    return escapeJsonForScript(json);
+}
+export function injectReportDataIntoHtml(templateHtml, report) {
+    const placeholderLiteral = JSON.stringify(REPORT_DATA_PLACEHOLDER);
+    const placeholderIndex = templateHtml.indexOf(placeholderLiteral);
+    if (placeholderIndex === -1) {
+        throw new Error(`Report template is missing the ${REPORT_DATA_PLACEHOLDER} data placeholder.`);
+    }
+    if (templateHtml.indexOf(placeholderLiteral, placeholderIndex + placeholderLiteral.length) !== -1) {
+        throw new Error(`Report template must contain exactly one ${REPORT_DATA_PLACEHOLDER} data placeholder.`);
+    }
+    return templateHtml.replace(placeholderLiteral, serializeReportDataForHtml(report));
+}

package/dist/tables.d.ts

@@ -0,0 +1,50 @@
+import type { ColumnDef } from "@tanstack/react-table";
+import type { FileHotspot, CommitRecord, ContributorSummary } from "@git-snitch/core";
+import type { CsvRow, DownloadResult } from "./export.js";
+type CsvDownloader = (filename: string, rows: readonly CsvRow[], columns?: readonly string[]) => DownloadResult;
+export type DataTableExport<TData> = {
+    readonly filename: string;
+    readonly mapRow: (row: TData) => CsvRow;
+    readonly columns?: readonly string[];
+    readonly downloader?: CsvDownloader;
+};
+export type DataTableEmptyState = {
+    readonly title: string;
+    readonly description: string;
+};
+export type DataTableProps<TData> = {
+    readonly data: readonly TData[];
+    readonly columns: ColumnDef<TData>[];
+    readonly emptyState: DataTableEmptyState;
+    readonly search?: {
+        readonly placeholder: string;
+        readonly toText: (row: TData) => string;
+    };
+    readonly exportConfig?: DataTableExport<TData>;
+    readonly initialPageSize?: number;
+    readonly ariaLabel: string;
+};
+export declare function DataTable<TData>({ data, columns, emptyState, search, exportConfig, initialPageSize, ariaLabel, }: DataTableProps<TData>): import("react/jsx-runtime").JSX.Element;
+export type CommitsTableProps = {
+    readonly commits: readonly CommitRecord[];
+    readonly exportFilename?: string;
+    readonly downloader?: CsvDownloader;
+    readonly remoteUrl?: string;
+};
+export declare function CommitsTable({ commits, exportFilename, downloader, remoteUrl }: CommitsTableProps): import("react/jsx-runtime").JSX.Element;
+export type ContributorsTableProps = {
+    readonly contributors: readonly ContributorSummary[];
+    readonly exportFilename?: string;
+    readonly downloader?: CsvDownloader;
+};
+export declare function ContributorsTable({ contributors, exportFilename, downloader }: ContributorsTableProps): import("react/jsx-runtime").JSX.Element;
+export type HotspotsTableProps = {
+    readonly hotspots: readonly FileHotspot[];
+    readonly exportFilename?: string;
+    readonly downloader?: CsvDownloader;
+    readonly remoteUrl?: string;
+    readonly currentBranch?: string;
+};
+export declare function HotspotsTable({ hotspots, exportFilename, downloader, remoteUrl, currentBranch }: HotspotsTableProps): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=tables.d.ts.map

package/dist/tables.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tables.d.ts","sourceRoot":"","sources":["../src/tables.tsx"],"names":[],"mappings":"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"}

package/dist/tables.js

@@ -0,0 +1,228 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { flexRender, getCoreRowModel, getPaginationRowModel, getSortedRowModel, useReactTable, } from "@tanstack/react-table";
+import { Button } from "@git-snitch/ui/components/button";
+import { Input } from "@git-snitch/ui/components/input";
+import { Table, TableBody, TableCell, TableHead, TableHeader, TableRow } from "@git-snitch/ui/components/table";
+import { cn } from "@git-snitch/ui/lib/utils";
+import { useMemo, useState } from "react";
+import { buildCommitUrl, buildFileUrl } from "./remote-urls.js";
+import { EmptyState } from "./empty-state.js";
+import { downloadCsv } from "./export.js";
+const defaultPageSize = 10;
+const pageSizes = [5, 10, 25, 50];
+function getAriaSort(sortDirection) {
+    if (sortDirection === "asc") {
+        return "ascending";
+    }
+    if (sortDirection === "desc") {
+        return "descending";
+    }
+    return "none";
+}
+export function DataTable({ data, columns, emptyState, search, exportConfig, initialPageSize = defaultPageSize, ariaLabel, }) {
+    const [query, setQuery] = useState("");
+    const [sorting, setSorting] = useState([]);
+    const [pagination, setPagination] = useState({ pageIndex: 0, pageSize: initialPageSize });
+    const [exportStatus, setExportStatus] = useState();
+    const filteredData = useMemo(() => {
+        const normalizedQuery = query.trim().toLocaleLowerCase();
+        if (search === undefined || normalizedQuery.length === 0) {
+            return data;
+        }
+        return data.filter((row) => search.toText(row).toLocaleLowerCase().includes(normalizedQuery));
+    }, [data, query, search]);
+    const tableData = useMemo(() => [...filteredData], [filteredData]);
+    const table = useReactTable({
+        data: tableData,
+        columns,
+        getCoreRowModel: getCoreRowModel(),
+        getPaginationRowModel: getPaginationRowModel(),
+        getSortedRowModel: getSortedRowModel(),
+        onPaginationChange: setPagination,
+        onSortingChange: setSorting,
+        state: { pagination, sorting },
+    });
+    const totalRows = filteredData.length;
+    const firstVisibleRow = totalRows === 0 ? 0 : pagination.pageIndex * pagination.pageSize + 1;
+    const lastVisibleRow = Math.min(totalRows, (pagination.pageIndex + 1) * pagination.pageSize);
+    const canExport = exportConfig !== undefined && totalRows > 0;
+    function handleSearchChange(value) {
+        setQuery(value);
+        setPagination((current) => ({ ...current, pageIndex: 0 }));
+    }
+    function handleExport() {
+        if (exportConfig === undefined) {
+            return;
+        }
+        const rows = table.getSortedRowModel().rows.map((row) => exportConfig.mapRow(row.original));
+        const result = (exportConfig.downloader ?? downloadCsv)(exportConfig.filename, rows, exportConfig.columns);
+        setExportStatus(result.status === "downloaded" ? "CSV export started." : result.reason);
+    }
+    if (data.length === 0) {
+        return _jsx(EmptyState, { title: emptyState.title, description: emptyState.description });
+    }
+    return (_jsxs("section", { className: "rounded-xl border border-border/70 bg-card/80 shadow-sm", "aria-label": ariaLabel, children: [_jsxs("div", { className: "flex flex-col gap-3 border-b border-border/70 p-3 sm:flex-row sm:items-center sm:justify-between", children: [search ? (_jsxs("label", { className: "min-w-0 flex-1 sm:max-w-sm", children: [_jsx("span", { className: "sr-only", children: "Search table" }), _jsx(Input, { value: query, onChange: (event) => handleSearchChange(event.currentTarget.value), placeholder: search.placeholder, className: "h-9 rounded-lg border-border/70 bg-background/70 text-sm" })] })) : (_jsx("div", {})), _jsxs("div", { className: "flex items-center gap-2", children: [_jsx("p", { className: "text-xs text-muted-foreground", "aria-live": "polite", children: totalRows === 0 ? "No matching rows" : `${firstVisibleRow}-${lastVisibleRow} of ${totalRows}` }), exportConfig ? (_jsx(Button, { variant: "outline", size: "sm", onClick: handleExport, disabled: !canExport, children: "Export CSV" })) : null] })] }), totalRows === 0 ? (_jsx("div", { className: "p-4", children: _jsx(EmptyState, { title: "No matching rows", description: "Adjust the search term to bring matching report rows back into view." }) })) : (_jsxs(Table, { "aria-label": ariaLabel, children: [_jsx(TableHeader, { children: table.getHeaderGroups().map((headerGroup) => (_jsx(TableRow, { className: "hover:bg-transparent", children: headerGroup.headers.map((header) => {
+                                const canSort = header.column.getCanSort();
+                                const sortDirection = header.column.getIsSorted();
+                                return (_jsx(TableHead, { className: "bg-muted/30 px-3 py-2 text-[0.7rem] uppercase tracking-[0.18em] text-muted-foreground", "aria-sort": canSort ? getAriaSort(sortDirection) : undefined, children: header.isPlaceholder ? null : canSort ? (_jsxs("button", { type: "button", className: "inline-flex items-center gap-1 rounded-md text-left font-semibold outline-none transition-colors hover:text-foreground focus-visible:ring-1 focus-visible:ring-ring", onClick: header.column.getToggleSortingHandler(), "aria-label": `Sort by ${String(header.column.columnDef.header)}`, children: [flexRender(header.column.columnDef.header, header.getContext()), _jsx("span", { "aria-hidden": "true", children: sortDirection === "asc" ? "↑" : sortDirection === "desc" ? "↓" : "↕" })] })) : (flexRender(header.column.columnDef.header, header.getContext())) }, header.id));
+                            }) }, headerGroup.id))) }), _jsx(TableBody, { children: table.getRowModel().rows.map((row) => (_jsx(TableRow, { children: row.getVisibleCells().map((cell) => (_jsx(TableCell, { className: "px-3 py-3 text-sm", children: flexRender(cell.column.columnDef.cell, cell.getContext()) }, cell.id))) }, row.id))) })] })), _jsxs("div", { className: "flex flex-col gap-3 border-t border-border/70 p-3 sm:flex-row sm:items-center sm:justify-between", children: [_jsxs("div", { className: "flex items-center gap-2", children: [_jsx("span", { className: "text-xs text-muted-foreground", children: "Rows per page" }), _jsx("div", { className: "flex gap-1", role: "group", "aria-label": "Rows per page", children: pageSizes.map((size) => (_jsx(Button, { type: "button", variant: pagination.pageSize === size ? "secondary" : "ghost", size: "xs", onClick: () => table.setPageSize(size), "aria-pressed": pagination.pageSize === size, "aria-label": `${size} rows per page`, children: size }, size))) })] }), _jsxs("div", { className: "flex items-center justify-between gap-2 sm:justify-end", children: [_jsx(Button, { type: "button", variant: "outline", size: "sm", onClick: () => table.previousPage(), disabled: !table.getCanPreviousPage(), children: "Previous" }), _jsxs("span", { className: "min-w-20 text-center text-xs text-muted-foreground", children: ["Page ", table.getState().pagination.pageIndex + 1, " of ", Math.max(table.getPageCount(), 1)] }), _jsx(Button, { type: "button", variant: "outline", size: "sm", onClick: () => table.nextPage(), disabled: !table.getCanNextPage(), children: "Next" })] })] }), exportStatus ? _jsx("p", { className: "border-t border-border/70 px-3 py-2 text-xs text-muted-foreground", "aria-live": "polite", children: exportStatus }) : null] }));
+}
+export function CommitsTable({ commits, exportFilename = "commits.csv", downloader, remoteUrl }) {
+    return (_jsx(DataTable, { ariaLabel: "Commits table", data: commits, columns: buildCommitColumns(remoteUrl), search: { placeholder: "Search commits, authors, files", toText: commitSearchText }, emptyState: { title: "No commits to show", description: "This report did not include commits for the selected repository and branch scope." }, exportConfig: { filename: exportFilename, mapRow: commitToCsvRow, columns: commitCsvColumns, downloader } }));
+}
+export function ContributorsTable({ contributors, exportFilename = "contributors.csv", downloader }) {
+    return (_jsx(DataTable, { ariaLabel: "Contributors table", data: contributors, columns: contributorColumns, search: { placeholder: "Search contributors", toText: contributorSearchText }, emptyState: { title: "No contributors to show", description: "This report has no contributor activity yet." }, exportConfig: { filename: exportFilename, mapRow: contributorToCsvRow, columns: contributorCsvColumns, downloader } }));
+}
+export function HotspotsTable({ hotspots, exportFilename = "hotspots.csv", downloader, remoteUrl, currentBranch }) {
+    return (_jsx(DataTable, { ariaLabel: "Hotspots table", data: hotspots, columns: buildHotspotColumns(remoteUrl, currentBranch), search: { placeholder: "Search files or contributors", toText: hotspotSearchText }, emptyState: { title: "No hotspots to show", description: "This repository has no file churn data to rank yet." }, exportConfig: { filename: exportFilename, mapRow: hotspotToCsvRow, columns: hotspotCsvColumns, downloader } }));
+}
+function commitAdditions(commit) {
+    return commit.files.reduce((sum, file) => sum + file.additions, 0);
+}
+function commitDeletions(commit) {
+    return commit.files.reduce((sum, file) => sum + file.deletions, 0);
+}
+function formatDate(isoDate) {
+    if (isoDate === undefined) {
+        return "—";
+    }
+    return new Intl.DateTimeFormat("en", { dateStyle: "medium", timeStyle: "short", timeZone: "UTC" }).format(new Date(isoDate));
+}
+function numberCell(value) {
+    return value.toLocaleString("en");
+}
+function RiskBadge({ level }) {
+    return (_jsx("span", { className: cn("inline-flex rounded-full border px-2 py-0.5 text-xs font-medium capitalize", level === "high" ? "border-red-500/30 bg-red-500/10 text-red-700 dark:text-red-300" : undefined, level === "medium" ? "border-amber-500/30 bg-amber-500/10 text-amber-700 dark:text-amber-300" : undefined, level === "low" ? "border-emerald-500/30 bg-emerald-500/10 text-emerald-700 dark:text-emerald-300" : undefined), children: level }));
+}
+function buildCommitColumns(remoteUrl) {
+    return [
+        {
+            accessorKey: "shortHash",
+            header: "Commit",
+            cell: ({ row }) => {
+                const url = buildCommitUrl(remoteUrl, row.original.hash);
+                const inner = _jsx("span", { className: "font-mono text-xs text-muted-foreground", children: row.original.shortHash });
+                return url ? _jsx("a", { href: url, target: "_blank", rel: "noopener noreferrer", children: inner }) : inner;
+            },
+        },
+        {
+            accessorKey: "message",
+            header: "Message",
+            cell: ({ row }) => _jsx("span", { className: "block max-w-xl truncate font-medium text-foreground", children: row.original.message }),
+        },
+        {
+            accessorFn: (commit) => commit.author.name,
+            id: "author",
+            header: "Author",
+        },
+        {
+            accessorKey: "classification",
+            header: "Type",
+            cell: ({ row }) => _jsx("span", { className: "capitalize", children: row.original.classification }),
+        },
+        {
+            accessorFn: (commit) => commitAdditions(commit),
+            id: "additions",
+            header: "Additions",
+            cell: ({ row }) => numberCell(commitAdditions(row.original)),
+        },
+        {
+            accessorFn: (commit) => commitDeletions(commit),
+            id: "deletions",
+            header: "Deletions",
+            cell: ({ row }) => numberCell(commitDeletions(row.original)),
+        },
+        {
+            accessorKey: "authoredAt",
+            header: "Authored",
+            cell: ({ row }) => formatDate(row.original.authoredAt),
+        },
+    ];
+}
+const contributorColumns = [
+    { accessorKey: "name", header: "Contributor", cell: ({ row }) => _jsx("span", { className: "font-medium text-foreground", children: row.original.name }) },
+    { accessorKey: "email", header: "Email" },
+    { accessorKey: "commitCount", header: "Commits", cell: ({ row }) => numberCell(row.original.commitCount) },
+    { accessorKey: "additions", header: "Additions", cell: ({ row }) => numberCell(row.original.additions) },
+    { accessorKey: "deletions", header: "Deletions", cell: ({ row }) => numberCell(row.original.deletions) },
+    { accessorKey: "filesChanged", header: "Files", cell: ({ row }) => numberCell(row.original.filesChanged) },
+    { accessorKey: "lastCommitAt", header: "Last seen", cell: ({ row }) => formatDate(row.original.lastCommitAt) },
+];
+function buildHotspotColumns(remoteUrl, currentBranch) {
+    return [
+        {
+            accessorKey: "path",
+            header: "File",
+            cell: ({ row }) => {
+                const url = buildFileUrl(remoteUrl, currentBranch, row.original.path);
+                const inner = _jsx("span", { className: "font-mono text-xs text-foreground", children: row.original.path });
+                return url ? _jsx("a", { href: url, target: "_blank", rel: "noopener noreferrer", children: inner }) : inner;
+            },
+        },
+        { accessorKey: "riskLevel.level", header: "Risk", cell: ({ row }) => _jsx(RiskBadge, { level: row.original.riskLevel.level }) },
+        { accessorKey: "hotspotScore", header: "Score", cell: ({ row }) => numberCell(row.original.hotspotScore) },
+        { accessorKey: "changeCount", header: "Changes", cell: ({ row }) => numberCell(row.original.changeCount) },
+        { accessorKey: "churn", header: "Churn", cell: ({ row }) => numberCell(row.original.churn) },
+        { accessorKey: "contributorCount", header: "Contributors", cell: ({ row }) => numberCell(row.original.contributorCount) },
+        { accessorKey: "lastChangedAt", header: "Last changed", cell: ({ row }) => formatDate(row.original.lastChangedAt) },
+    ];
+}
+const commitCsvColumns = ["hash", "message", "author", "email", "classification", "additions", "deletions", "authoredAt", "files"];
+const contributorCsvColumns = ["name", "email", "commitCount", "additions", "deletions", "filesChanged", "firstCommitAt", "lastCommitAt"];
+const hotspotCsvColumns = ["path", "risk", "hotspotScore", "changeCount", "additions", "deletions", "churn", "contributors", "lastChangedAt"];
+function commitSearchText(commit) {
+    return [
+        commit.hash,
+        commit.shortHash,
+        commit.message,
+        commit.author.name,
+        commit.author.email,
+        commit.classification,
+        ...commit.refs,
+        ...commit.files.map((file) => file.path),
+    ].join(" ");
+}
+function contributorSearchText(contributor) {
+    return `${contributor.name} ${contributor.email}`;
+}
+function hotspotSearchText(hotspot) {
+    return `${hotspot.path} ${hotspot.riskLevel.level} ${hotspot.contributors.join(" ")}`;
+}
+function commitToCsvRow(commit) {
+    return {
+        hash: commit.hash,
+        message: commit.message,
+        author: commit.author.name,
+        email: commit.author.email,
+        classification: commit.classification,
+        additions: commitAdditions(commit),
+        deletions: commitDeletions(commit),
+        authoredAt: commit.authoredAt,
+        files: commit.files.map((file) => file.path).join("; "),
+    };
+}
+function contributorToCsvRow(contributor) {
+    return {
+        name: contributor.name,
+        email: contributor.email,
+        commitCount: contributor.commitCount,
+        additions: contributor.additions,
+        deletions: contributor.deletions,
+        filesChanged: contributor.filesChanged,
+        firstCommitAt: contributor.firstCommitAt,
+        lastCommitAt: contributor.lastCommitAt,
+    };
+}
+function hotspotToCsvRow(hotspot) {
+    return {
+        path: hotspot.path,
+        risk: hotspot.riskLevel.level,
+        hotspotScore: hotspot.hotspotScore,
+        changeCount: hotspot.changeCount,
+        additions: hotspot.additions,
+        deletions: hotspot.deletions,
+        churn: hotspot.churn,
+        contributors: hotspot.contributors.join("; "),
+        lastChangedAt: hotspot.lastChangedAt,
+    };
+}