@git-snitch/renderer 0.0.3

package/dist/template.d.ts

@@ -0,0 +1,21 @@
+import type { RepoTemplateContext, ScanProjectTemplateContext, ScanTemplateContext, TemplateRouteId } from "@git-snitch/core";
+import type { ReactNode } from "react";
+export type TemplateComponent<Props> = (props: Props) => ReactNode;
+export interface RouteTemplatePropsById {
+    readonly overview: RepoTemplateContext;
+    readonly commits: RepoTemplateContext;
+    readonly contributors: RepoTemplateContext;
+    readonly charts: RepoTemplateContext;
+    readonly quality: RepoTemplateContext;
+    readonly hotspots: RepoTemplateContext;
+    readonly scanOverview: ScanTemplateContext;
+    readonly scanProject: ScanProjectTemplateContext;
+}
+export type RouteTemplateOverrides = {
+    readonly [RouteId in TemplateRouteId]?: TemplateComponent<RouteTemplatePropsById[RouteId]>;
+};
+export interface TemplateModule {
+    readonly templates: RouteTemplateOverrides;
+}
+export type { RepoTemplateContext, ScanProjectTemplateContext, ScanTemplateContext, TemplateRouteId } from "@git-snitch/core";
+//# sourceMappingURL=template.d.ts.map

package/dist/template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../src/template.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,0BAA0B,EAC1B,mBAAmB,EACnB,eAAe,EAChB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,MAAM,MAAM,iBAAiB,CAAC,KAAK,IAAI,CAAC,KAAK,EAAE,KAAK,KAAK,SAAS,CAAC;AAEnE,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAC;IACtC,QAAQ,CAAC,YAAY,EAAE,mBAAmB,CAAC;IAC3C,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAC;IACtC,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,CAAC;IACvC,QAAQ,CAAC,YAAY,EAAE,mBAAmB,CAAC;IAC3C,QAAQ,CAAC,WAAW,EAAE,0BAA0B,CAAC;CAClD;AAED,MAAM,MAAM,sBAAsB,GAAG;IACnC,QAAQ,EAAE,OAAO,IAAI,eAAe,CAAC,CAAC,EAAE,iBAAiB,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC;CAC3F,CAAC;AAEF,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,SAAS,EAAE,sBAAsB,CAAC;CAC5C;AAED,YAAY,EAAE,mBAAmB,EAAE,0BAA0B,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/template.js

@@ -0,0 +1 @@
+export {};

package/dist/theme-toggle.d.ts

@@ -0,0 +1,2 @@
+export declare function ThemeToggle(): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=theme-toggle.d.ts.map

package/dist/theme-toggle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-toggle.d.ts","sourceRoot":"","sources":["../src/theme-toggle.tsx"],"names":[],"mappings":"AAIA,wBAAgB,WAAW,4CAmB1B"}

package/dist/theme-toggle.js

@@ -0,0 +1,9 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Button } from "@git-snitch/ui/components/button";
+import { useTheme } from "./theme.js";
+export function ThemeToggle() {
+    const { theme, toggleTheme } = useTheme();
+    const isDark = theme === "dark";
+    const label = isDark ? "Switch to light theme" : "Switch to dark theme";
+    return (_jsxs(Button, { type: "button", variant: "outline", size: "sm", "aria-label": label, "aria-pressed": isDark, onClick: toggleTheme, className: "border-foreground/15 bg-background/80 text-foreground shadow-sm backdrop-blur transition-colors hover:bg-muted", children: [_jsx("span", { "aria-hidden": "true", className: "size-2 rounded-full bg-current" }), _jsx("span", { children: isDark ? "Light" : "Dark" })] }));
+}

package/dist/theme.d.ts

@@ -0,0 +1,16 @@
+import type { ReactNode } from "react";
+export type Theme = "light" | "dark";
+type ThemeContextValue = {
+    theme: Theme;
+    setTheme: (theme: Theme) => void;
+    toggleTheme: () => void;
+};
+type ThemeProviderProps = {
+    children: ReactNode;
+    defaultTheme?: Theme;
+    storageKey?: string;
+};
+export declare function ThemeProvider({ children, defaultTheme, storageKey, }: ThemeProviderProps): import("react/jsx-runtime").JSX.Element;
+export declare function useTheme(): ThemeContextValue;
+export {};
+//# sourceMappingURL=theme.d.ts.map

package/dist/theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../src/theme.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,MAAM,MAAM,KAAK,GAAG,OAAO,GAAG,MAAM,CAAC;AAErC,KAAK,iBAAiB,GAAG;IACvB,KAAK,EAAE,KAAK,CAAC;IACb,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,WAAW,EAAE,MAAM,IAAI,CAAC;CACzB,CAAC;AAEF,KAAK,kBAAkB,GAAG;IACxB,QAAQ,EAAE,SAAS,CAAC;IACpB,YAAY,CAAC,EAAE,KAAK,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAqDF,wBAAgB,aAAa,CAAC,EAC5B,QAAQ,EACR,YAA4B,EAC5B,UAAgC,GACjC,EAAE,kBAAkB,2CAyBpB;AAED,wBAAgB,QAAQ,sBAQvB"}

package/dist/theme.js

@@ -0,0 +1,70 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useContext, useEffect, useMemo, useState } from "react";
+const DEFAULT_THEME = "light";
+const DEFAULT_STORAGE_KEY = "git-snitch-theme";
+const ThemeContext = createContext(null);
+function isTheme(value) {
+    return value === "light" || value === "dark";
+}
+function getStoredTheme(storageKey) {
+    if (typeof window === "undefined") {
+        return null;
+    }
+    try {
+        const storedTheme = window.localStorage.getItem(storageKey);
+        return isTheme(storedTheme) ? storedTheme : null;
+    }
+    catch {
+        return null;
+    }
+}
+function getSystemTheme() {
+    if (typeof window === "undefined" || typeof window.matchMedia !== "function") {
+        return null;
+    }
+    return window.matchMedia("(prefers-color-scheme: dark)").matches ? "dark" : "light";
+}
+function persistTheme(storageKey, theme) {
+    if (typeof window === "undefined") {
+        return;
+    }
+    try {
+        window.localStorage.setItem(storageKey, theme);
+    }
+    catch {
+        return;
+    }
+}
+function applyThemeClass(theme) {
+    if (typeof document === "undefined") {
+        return;
+    }
+    document.documentElement.classList.toggle("dark", theme === "dark");
+    document.documentElement.style.colorScheme = theme;
+}
+export function ThemeProvider({ children, defaultTheme = DEFAULT_THEME, storageKey = DEFAULT_STORAGE_KEY, }) {
+    const [theme, setThemeState] = useState(defaultTheme);
+    useEffect(() => {
+        const initialTheme = getStoredTheme(storageKey) ?? getSystemTheme() ?? defaultTheme;
+        setThemeState(initialTheme);
+    }, [defaultTheme, storageKey]);
+    useEffect(() => {
+        applyThemeClass(theme);
+        persistTheme(storageKey, theme);
+    }, [storageKey, theme]);
+    const value = useMemo(() => ({
+        theme,
+        setTheme: setThemeState,
+        toggleTheme: () => {
+            setThemeState((currentTheme) => (currentTheme === "dark" ? "light" : "dark"));
+        },
+    }), [theme]);
+    return _jsx(ThemeContext.Provider, { value: value, children: children });
+}
+export function useTheme() {
+    const context = useContext(ThemeContext);
+    if (!context) {
+        throw new Error("useTheme must be used within ThemeProvider.");
+    }
+    return context;
+}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@git-snitch/renderer",
+  "version": "0.0.3",
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./src/index.ts",
+      "default": "./dist/index.js"
+    },
+    "./template": {
+      "types": "./src/template.ts",
+      "default": "./dist/template.js"
+    },
+    "./build": {
+      "types": "./src/build.ts",
+      "default": "./dist/build.js"
+    }
+  },
+  "files": [
+    "dist",
+    "report-template.html",
+    "src",
+    "vite.config.ts",
+    "package.json"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json && vite build",
+    "typecheck": "tsc --noEmit",
+    "check-types": "tsc --noEmit",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@git-snitch/core": "workspace:*",
+    "@git-snitch/ui": "workspace:*",
+    "@tailwindcss/vite": "^4.2.2",
+    "@tanstack/react-router": "^1.168.22",
+    "@tanstack/react-table": "^8.21.3",
+    "@vitejs/plugin-react": "^6.0.1",
+    "react": "^19.2.5",
+    "react-dom": "^19.2.5",
+    "recharts": "3.8.0",
+    "vite": "^8.0.8"
+  },
+  "devDependencies": {
+    "@git-snitch/config": "workspace:*",
+    "@testing-library/dom": "^10.4.1",
+    "@testing-library/react": "^16.3.2",
+    "@types/react": "^19.2.14",
+    "@types/react-dom": "catalog:",
+    "jsdom": "^29.0.2",
+    "typescript": "catalog:",
+    "vitest": "catalog:"
+  }
+}

package/report-template.html

@@ -0,0 +1,15 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>git-snitch report</title>
+    <script>
+      window.__GIT_SNITCH_REPORT_DATA__ = "__GIT_SNITCH_REPORT_DATA__";
+    </script>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>

package/src/app.tsx

@@ -0,0 +1,351 @@
+import {
+  createHashHistory,
+  createMemoryHistory,
+  createRootRoute,
+  createRoute,
+  createRouter,
+  Navigate,
+  Outlet,
+  RouterProvider,
+  useRouterState,
+} from "@tanstack/react-router";
+
+import type { RepoReportData, ScanReportData, TemplateExportHelpers } from "@git-snitch/core";
+
+import { templates as customTemplates } from "virtual:git-snitch-custom-templates";
+import { useReportData } from "./data.js";
+import { EmptyState } from "./empty-state.js";
+import { downloadCsv, downloadJson } from "./export.js";
+import { AppShell, StatsGrid } from "./layout.js";
+import { ChartsRoute } from "./charts-route.js";
+import { RepoOverview } from "./overview.js";
+import { HotspotsRoute, QualityRoute } from "./quality-hotspots-routes.js";
+import { CommitsRoute, ContributorsRoute } from "./repo-routes.js";
+import { ScanOverview, ScanProjectRoute, deriveScanProjectRouteEntries } from "./scan-routes.js";
+import { ThemeProvider } from "./theme.js";
+
+const rootRoute = createRootRoute({
+  component: ReportShell,
+});
+
+const indexRoute = createRoute({
+  getParentRoute: () => rootRoute,
+  path: "/",
+  component: IndexRoute,
+});
+
+const overviewRoute = createRoute({
+  getParentRoute: () => rootRoute,
+  path: "/overview",
+  component: OverviewRoute,
+});
+
+const commitsRoute = createRoute({
+  getParentRoute: () => rootRoute,
+  path: "/commits",
+  component: CommitsRouteContainer,
+});
+
+const contributorsRoute = createRoute({
+  getParentRoute: () => rootRoute,
+  path: "/contributors",
+  component: ContributorsRouteContainer,
+});
+
+const chartsRoute = createRoute({
+  getParentRoute: () => rootRoute,
+  path: "/charts",
+  component: ChartsRouteContainer,
+});
+
+const qualityRoute = createRoute({
+  getParentRoute: () => rootRoute,
+  path: "/quality",
+  component: QualityRouteContainer,
+});
+
+const hotspotsRoute = createRoute({
+  getParentRoute: () => rootRoute,
+  path: "/hotspots",
+  component: HotspotsRouteContainer,
+});
+
+const scanOverviewRoute = createRoute({
+  getParentRoute: () => rootRoute,
+  path: "/scan",
+  component: ScanOverviewRouteContainer,
+});
+
+const scanProjectRoute = createRoute({
+  getParentRoute: () => rootRoute,
+  path: "/scan/projects/$projectSlug",
+  component: ScanProjectRouteContainer,
+});
+
+const routeTree = rootRoute.addChildren([
+  indexRoute,
+  overviewRoute,
+  commitsRoute,
+  contributorsRoute,
+  chartsRoute,
+  qualityRoute,
+  hotspotsRoute,
+  scanOverviewRoute,
+  scanProjectRoute,
+]);
+
+function createRouterHistory() {
+  if (typeof window === "undefined") {
+    return createMemoryHistory({ initialEntries: ["/"] });
+  }
+
+  return createHashHistory();
+}
+
+export const router = createRouter({
+  history: createRouterHistory(),
+  routeTree,
+});
+
+declare module "@tanstack/react-router" {
+  interface Register {
+    router: typeof router;
+  }
+}
+
+function normalizeGitRemote(remoteUrl: string): string | undefined {
+  // SSH format: git@github.com:org/repo.git
+  const scpMatch = /^git@github\.com:([^/]+)\/(.+?)(?:\.git)?$/.exec(remoteUrl);
+  if (scpMatch?.[1] !== undefined && scpMatch[2] !== undefined) {
+    return `https://github.com/${scpMatch[1]}/${scpMatch[2]}`;
+  }
+
+  // SSH format: ssh://git@github.com/org/repo.git
+  const sshMatch = /^ssh:\/\/git@github\.com\/([^/]+)\/(.+?)(?:\.git)?$/.exec(remoteUrl);
+  if (sshMatch?.[1] !== undefined && sshMatch[2] !== undefined) {
+    return `https://github.com/${sshMatch[1]}/${sshMatch[2]}`;
+  }
+
+  // HTTPS: only return if it starts with http:// or https://
+  if (remoteUrl.startsWith("http://") || remoteUrl.startsWith("https://")) {
+    return remoteUrl.replace(/\.git$/, "");
+  }
+
+  return undefined;
+}
+
+function ReportShell() {
+  return (
+    <ThemeProvider>
+      <ReportRootLayout />
+    </ThemeProvider>
+  );
+}
+
+function IndexRoute() {
+  const state = useReportData();
+  return <Navigate to={state.status === "ready" && state.report.kind === "scan" ? "/scan" : "/overview"} replace />;
+}
+
+const repoNavigationItems = [
+  { label: "Overview", href: "#/overview", path: "/overview", disabled: false },
+  { label: "Commits", href: "#/commits", path: "/commits", disabled: false },
+  { label: "Contributors", href: "#/contributors", path: "/contributors", disabled: false },
+  { label: "Charts", href: "#/charts", path: "/charts", disabled: false },
+  { label: "Quality", href: "#/quality", path: "/quality", disabled: false },
+  { label: "Hotspots", href: "#/hotspots", path: "/hotspots", disabled: false },
+] as const;
+
+function ReportRootLayout() {
+  const state = useReportData();
+  const pathname = useRouterState({ select: (routerState) => routerState.location.pathname });
+
+  if (state.status === "missing") {
+    return (
+      <AppShell title="git-snitch report template" description="A standalone renderer shell for CLI-generated git activity reports.">
+        <EmptyState
+          title="Report data has not been injected"
+          description="Build the report through the CLI pipeline so the standalone HTML receives a JSON-safe report payload."
+        />
+      </AppShell>
+    );
+  }
+
+  if (state.status === "invalid") {
+    return (
+      <AppShell title="Report data could not be loaded" description="The injected payload failed the renderer contract checks.">
+        <EmptyState title="Invalid report data" description={state.reason} />
+      </AppShell>
+    );
+  }
+
+  const report = state.report;
+  const isAnonymized = report.anonymization?.applied === true;
+  const title = report.kind === "repo" ? report.repository.name : "Scan report";
+  const titleHref = report.kind === "repo" && !isAnonymized && report.repository.remoteUrl
+    ? normalizeGitRemote(report.repository.remoteUrl)
+    : undefined;
+  const scanNavigationItems = report.kind === "scan"
+    ? [
+        { label: "Scan Overview", href: "#/scan", current: pathname === "/scan", disabled: false },
+        ...deriveScanProjectRouteEntries(report).map((entry) => ({
+          label: entry.label,
+          href: entry.href,
+          current: pathname === `/scan/projects/${entry.slug}`,
+          disabled: false,
+        })),
+      ]
+    : [{ label: "Scan Overview", href: "#/scan", current: pathname === "/scan", disabled: false }];
+  const navigationItems = report.kind === "scan"
+    ? scanNavigationItems
+    : [
+        ...repoNavigationItems.map((item) => ({
+          label: item.label,
+          href: item.href,
+          current: item.path === pathname,
+          disabled: item.disabled,
+        })),
+        ...scanNavigationItems,
+      ];
+
+  const headerActions = isAnonymized
+    ? <span className="inline-flex items-center rounded-full bg-muted px-2.5 py-0.5 text-xs font-medium text-muted-foreground">Anonymized</span>
+    : undefined;
+
+  return (
+    <AppShell
+      title={title}
+      titleHref={titleHref}
+      eyebrow="Standalone git activity report"
+      description={`Renderer pipeline loaded a ${report.kind} report generated at ${report.generatedAt}.`}
+      navigationItems={navigationItems}
+      headerActions={headerActions}
+    >
+      <Outlet />
+    </AppShell>
+  );
+}
+
+function OverviewRoute() {
+  const state = useReportData();
+
+  if (state.status !== "ready") {
+    return <StatsGrid stats={[]} />;
+  }
+
+  if (state.report.kind === "repo" && customTemplates.overview) {
+    return customTemplates.overview({ report: state.report, helpers: createTemplateHelpers(state.report) });
+  }
+
+  return <RepoOverview report={state.report} />;
+}
+
+function CommitsRouteContainer() {
+  const state = useReportData();
+
+  if (state.status !== "ready") {
+    return <StatsGrid stats={[]} />;
+  }
+
+  if (state.report.kind === "repo" && customTemplates.commits) {
+    return customTemplates.commits({ report: state.report, helpers: createTemplateHelpers(state.report) });
+  }
+
+  return <CommitsRoute report={state.report} />;
+}
+
+function ContributorsRouteContainer() {
+  const state = useReportData();
+
+  if (state.status !== "ready") {
+    return <StatsGrid stats={[]} />;
+  }
+
+  if (state.report.kind === "repo" && customTemplates.contributors) {
+    return customTemplates.contributors({ report: state.report, helpers: createTemplateHelpers(state.report) });
+  }
+
+  return <ContributorsRoute report={state.report} />;
+}
+
+function ChartsRouteContainer() {
+  const state = useReportData();
+
+  if (state.status !== "ready") {
+    return <StatsGrid stats={[]} />;
+  }
+
+  if (state.report.kind === "repo" && customTemplates.charts) {
+    return customTemplates.charts({ report: state.report, helpers: createTemplateHelpers(state.report) });
+  }
+
+  return <ChartsRoute report={state.report} />;
+}
+
+function QualityRouteContainer() {
+  const state = useReportData();
+
+  if (state.status !== "ready") {
+    return <StatsGrid stats={[]} />;
+  }
+
+  if (state.report.kind === "repo" && customTemplates.quality) {
+    return customTemplates.quality({ report: state.report, helpers: createTemplateHelpers(state.report) });
+  }
+
+  return <QualityRoute report={state.report} />;
+}
+
+function HotspotsRouteContainer() {
+  const state = useReportData();
+
+  if (state.status !== "ready") {
+    return <StatsGrid stats={[]} />;
+  }
+
+  if (state.report.kind === "repo" && customTemplates.hotspots) {
+    return customTemplates.hotspots({ report: state.report, helpers: createTemplateHelpers(state.report) });
+  }
+
+  return <HotspotsRoute report={state.report} />;
+}
+
+function ScanOverviewRouteContainer() {
+  const state = useReportData();
+
+  if (state.status !== "ready") {
+    return <StatsGrid stats={[]} />;
+  }
+
+  if (state.report.kind === "scan" && customTemplates.scanOverview) {
+    return customTemplates.scanOverview({ report: state.report, helpers: createTemplateHelpers(state.report) });
+  }
+
+  return <ScanOverview report={state.report} />;
+}
+
+function ScanProjectRouteContainer() {
+  const state = useReportData();
+  const params = scanProjectRoute.useParams();
+
+  if (state.status !== "ready") {
+    return <StatsGrid stats={[]} />;
+  }
+
+  if (state.report.kind === "scan" && customTemplates.scanProject) {
+    return customTemplates.scanProject({ report: state.report, helpers: createTemplateHelpers(state.report), projectId: params.projectSlug });
+  }
+
+  return <ScanProjectRoute report={state.report} projectSlug={params.projectSlug} />;
+}
+
+function createTemplateHelpers(report: RepoReportData | ScanReportData): TemplateExportHelpers {
+  return {
+    downloadJson: (fileName) => downloadJson(fileName, report),
+    downloadCsv: (fileName, rows) => downloadCsv(fileName, rows),
+  };
+}
+
+export function App() {
+  return <RouterProvider router={router} />;
+}

package/src/build.ts

@@ -0,0 +1,68 @@
+import { mkdir, readFile, rm } from "node:fs/promises";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+
+import type { ReportData } from "@git-snitch/core";
+
+import { build as viteBuild } from "vite";
+
+import { injectReportDataIntoHtml } from "./serialization.js";
+
+export interface BuildReportHtmlOptions {
+  readonly report: ReportData;
+  readonly templatePath?: string;
+}
+
+const moduleDirectory = fileURLToPath(new URL(".", import.meta.url));
+
+export async function buildStandaloneReportHtml(options: BuildReportHtmlOptions): Promise<string> {
+  const templatePath = options.templatePath ? resolve(options.templatePath) : undefined;
+  const templateHtmlPath = await buildRendererTemplate(templatePath);
+  const templateHtml = await readFile(templateHtmlPath, "utf8");
+
+  return injectReportDataIntoHtml(templateHtml, options.report);
+}
+
+async function buildRendererTemplate(templatePath: string | undefined): Promise<string> {
+  const packageDirectory = resolve(moduleDirectory, "..");
+  const outDir = resolve(packageDirectory, "dist", "template");
+  const configFile = resolve(packageDirectory, "vite.config.ts");
+
+  await mkdir(dirname(outDir), { recursive: true });
+  await rm(outDir, { recursive: true, force: true });
+
+  const previousTemplateModule = process.env.GIT_SNITCH_TEMPLATE_MODULE;
+
+  try {
+    if (templatePath) {
+      process.env.GIT_SNITCH_TEMPLATE_MODULE = templatePath;
+      await ensureTemplateReadable(templatePath);
+    } else {
+      delete process.env.GIT_SNITCH_TEMPLATE_MODULE;
+    }
+
+    await viteBuild({ configFile, root: packageDirectory, logLevel: "silent" });
+  } catch (error) {
+    throw new Error(`Unable to compile report renderer${templatePath ? ` with template ${templatePath}` : ""}: ${errorMessage(error)}`);
+  } finally {
+    if (previousTemplateModule === undefined) {
+      delete process.env.GIT_SNITCH_TEMPLATE_MODULE;
+    } else {
+      process.env.GIT_SNITCH_TEMPLATE_MODULE = previousTemplateModule;
+    }
+  }
+
+  return resolve(outDir, "report-template.html");
+}
+
+async function ensureTemplateReadable(templatePath: string): Promise<void> {
+  try {
+    await readFile(templatePath, "utf8");
+  } catch (error) {
+    throw new Error(`Unable to read custom template ${templatePath}: ${errorMessage(error)}`);
+  }
+}
+
+function errorMessage(error: unknown): string {
+  return error instanceof Error ? error.message : "unknown error";
+}