Skip to content

Database governance built for humans and agents — controlling changes and access across every major database.

refactor: project switch (#20947)

ecmadao0765ec3b2722
diff --git a/frontend/src/components/header/HeaderBreadcrumb.test.tsx b/frontend/src/components/header/HeaderBreadcrumb.test.tsx
new file mode 100644
index 0000000000..89d9e335ab
--- /dev/null
+++ b/frontend/src/components/header/HeaderBreadcrumb.test.tsx
@@ -0,0 +1,204 @@
+import type { MouseEvent, ReactElement, ReactNode } from "react";
+import { cloneElement, createContext, useContext } from "react";
+import { act } from "react";
+import { createRoot } from "react-dom/client";
+import { beforeEach, describe, expect, test, vi } from "vitest";
+import { PROJECT_V1_ROUTE_ISSUES } from "@/app/router/handles";
+
+(
+ globalThis as { IS_REACT_ACT_ENVIRONMENT?: boolean }
+).IS_REACT_ACT_ENVIRONMENT = true;
+
+const mocks = vi.hoisted(() => ({
+ currentRoute: {
+ name: "workspace.project.database",
+ fullPath: "/projects/recent-project/databases",
+ params: {
+ projectId: "recent-project",
+ },
+ query: {},
+ },
+ record: vi.fn(),
+ resolve: vi.fn(({ name }: { name: string }) => ({
+ fullPath: `/${name}`,
+ })),
+ switchWorkspace: vi.fn(),
+}));
+
+vi.mock("react-i18next", () => ({
+ initReactI18next: { type: "3rdParty", init: () => {} },
+ useTranslation: () => ({
+ t: (key: string) =>
+ ({
+ "project.select": "Select project",
+ "subscription.plan.free.title": "Free",
+ })[key] ?? key,
+ }),
+}));
+
+vi.mock("@/app/router", () => ({
+ useCurrentRoute: () => mocks.currentRoute,
+ useNavigate: () => ({
+ resolve: mocks.resolve,
+ }),
+ WORKSPACE_ROUTE_LANDING: "workspace.landing",
+}));
+
+vi.mock("@/hooks/useAppState", () => ({
+ useProject: () => ({
+ name: "projects/recent-project",
+ title: "Recent Project",
+ }),
+ useRecentVisit: () => ({
+ record: mocks.record,
+ }),
+ useSubscription: () => ({
+ subscription: undefined,
+ }),
+ useSwitchWorkspace: () => mocks.switchWorkspace,
+ useWorkspace: () => ({
+ name: "workspaces/default",
+ title: "Default Workspace",
+ }),
+ useWorkspaceList: () => [
+ {
+ name: "workspaces/default",
+ title: "Default Workspace",
+ },
+ ],
+}));
+
+vi.mock("@/components/RouterLink", () => ({
+ RouterLink: ({
+ to,
+ children,
+ className,
+ onClick,
+ }: {
+ to: { name?: string; params?: Record<string, string | undefined> };
+ children: ReactNode;
+ className?: string;
+ onClick?: () => void;
+ }) => (
+ <a
+ className={className}
+ data-route-name={to.name}
+ data-project-id={to.params?.projectId}
+ href={`/${to.name ?? ""}`}
+ onClick={(event: MouseEvent<HTMLAnchorElement>) => {
+ event.preventDefault();
+ onClick?.();
+ }}
+ >
+ {children}
+ </a>
+ ),
+}));
+
+type PopoverContextValue = {
+ open: boolean;
+ onOpenChange: (open: boolean) => void;
+};
+
+const PopoverContext = createContext<PopoverContextValue | undefined>(
+ undefined
+);
+
+vi.mock("@/components/ui/popover", () => ({
+ Popover: ({
+ open,
+ onOpenChange,
+ children,
+ }: PopoverContextValue & { children: ReactNode }) => (
+ <PopoverContext.Provider value={{ open, onOpenChange }}>
+ {children}
+ </PopoverContext.Provider>
+ ),
+ PopoverContent: ({ children }: { children: ReactNode }) => {
+ const context = useContext(PopoverContext);
+ return context?.open ? <div>{children}</div> : null;
+ },
+ PopoverTrigger: ({
+ render,
+ children,
+ }: {
+ render: ReactElement<{ onClick?: () => void; children?: ReactNode }>;
+ children: ReactNode;
+ }) => {
+ const context = useContext(PopoverContext);
+ return cloneElement(render, {
+ onClick: () => context?.onOpenChange(!context.open),
+ children,
+ });
+ },
+}));
+
+vi.mock("@/components/header/ProjectSwitchPanel", () => ({
+ ProjectSwitchPanel: () => <div data-testid="project-switch-panel" />,
+}));
+
+vi.mock("@/components/header/ProjectCreateDialog", () => ({
+ ProjectCreateDialog: () => null,
+}));
+
+let HeaderBreadcrumb: typeof import("./HeaderBreadcrumb").HeaderBreadcrumb;
+
+const renderIntoContainer = (element: ReactElement) => {
+ const container = document.createElement("div");
+ document.body.appendChild(container);
+ const root = createRoot(container);
+ return {
+ container,
+ render: () => {
+ act(() => {
+ root.render(element);
+ });
+ },
+ unmount: () =>
+ act(() => {
+ root.unmount();
+ container.remove();
+ }),
+ };
+};
+
+beforeEach(async () => {
+ vi.clearAllMocks();
+ ({ HeaderBreadcrumb } = await import("./HeaderBreadcrumb"));
+});
+
+describe("HeaderBreadcrumb", () => {
+ test("opens project switcher only from the chevron and links title to project issues", () => {
+ const { container, render, unmount } = renderIntoContainer(
+ <HeaderBreadcrumb />
+ );
+
+ render();
+
+ const projectLink = container.querySelector<HTMLAnchorElement>(
+ `a[data-route-name="${PROJECT_V1_ROUTE_ISSUES}"]`
+ );
+ expect(projectLink).not.toBeNull();
+ expect(projectLink?.textContent).toContain("Recent Project");
+ expect(projectLink?.dataset.projectId).toBe("recent-project");
+
+ act(() => {
+ projectLink?.click();
+ });
+ expect(
+ container.querySelector('[data-testid="project-switch-panel"]')
+ ).toBeNull();
+
+ const projectSwitchButton = container.querySelector<HTMLButtonElement>(
+ "button"
+ );
+ act(() => {
+ projectSwitchButton?.click();
+ });
+ expect(
+ container.querySelector('[data-testid="project-switch-panel"]')
+ ).not.toBeNull();
+
+ unmount();
+ });
+});
diff --git a/frontend/src/components/header/HeaderBreadcrumb.tsx b/frontend/src/components/header/HeaderBreadcrumb.tsx
index c38ab20a5e..7e3f2a4f3d 100644
--- a/frontend/src/components/header/HeaderBreadcrumb.tsx
+++ b/frontend/src/components/header/HeaderBreadcrumb.tsx
@@ -6,8 +6,10 @@ import {
useNavigate,
WORKSPACE_ROUTE_LANDING,
} from "@/app/router";
+import { PROJECT_V1_ROUTE_ISSUES } from "@/app/router/handles";
import { RouterLink } from "@/components/RouterLink";
import { Badge } from "@/components/ui/badge";
+import { Button } from "@/components/ui/button";
import {
Popover,
PopoverContent,
@@ -178,6 +180,8 @@ export function ProjectSegment() {
: "";
const currentProject = useProject(currentProjectName);
const hasProject = isValidProjectName(currentProject?.name);
+ const { record } = useRecentVisit();
+ const navigate = useNavigate();
useEffect(() => {
setOpen(false);
@@ -185,39 +189,62 @@ export function ProjectSegment() {
return (
<>
- <Popover open={open} onOpenChange={setOpen}>
- <PopoverTrigger
- render={
- <button
- type="button"
- className="inline-flex items-center gap-x-1.5 rounded-xs px-2 py-1 text-sm font-medium text-control hover:bg-control-bg cursor-pointer"
- />
- }
- >
- <FolderKanban className="size-4 text-control-light shrink-0" />
- {hasProject ? (
+ <div className="inline-flex items-center">
+ {hasProject && projectId ? (
+ <RouterLink
+ to={{
+ name: PROJECT_V1_ROUTE_ISSUES,
+ params: { projectId },
+ }}
+ onClick={() => {
+ const resolvedRoute = navigate.resolve({
+ name: PROJECT_V1_ROUTE_ISSUES,
+ params: { projectId },
+ });
+ record(resolvedRoute.fullPath);
+ }}
+ className="inline-flex items-center gap-x-1.5 rounded-xs px-2 py-1 text-sm font-medium text-control hover:bg-control-bg cursor-pointer no-underline"
+ >
+ <FolderKanban className="size-4 text-control-light shrink-0" />
<span className="truncate max-w-48">{currentProject.title}</span>
- ) : (
+ </RouterLink>
+ ) : (
+ <div className="inline-flex items-center gap-x-1.5 rounded-xs px-2 py-1 text-sm font-medium text-control">
+ <FolderKanban className="size-4 text-control-light shrink-0" />
<span className="truncate max-w-48 text-control-placeholder">
{t("project.select")}
</span>
- )}
- <ChevronDown className="size-3.5 text-control-placeholder shrink-0" />
- </PopoverTrigger>
- <PopoverContent
- align="start"
- sideOffset={6}
- className="w-[24rem] max-w-[calc(100vw-2rem)] p-0! py-3!"
- >
- <ProjectSwitchPanel
- onClose={() => setOpen(false)}
- onRequestCreate={() => {
- setOpen(false);
- setCreateOpen(true);
- }}
- />
- </PopoverContent>
- </Popover>
+ </div>
+ )}
+ <Popover open={open} onOpenChange={setOpen}>
+ <PopoverTrigger
+ render={
+ <Button
+ type="button"
+ appearance="secondary"
+ aria-label={t("project.select")}
+ size="xs"
+ className="size-6 p-0 text-control-placeholder"
+ />
+ }
+ >
+ <ChevronDown className="size-3.5" />
+ </PopoverTrigger>
+ <PopoverContent
+ align="start"
+ sideOffset={6}
+ className="w-[24rem] max-w-[calc(100vw-2rem)] p-0! py-3!"
+ >
+ <ProjectSwitchPanel
+ onClose={() => setOpen(false)}
+ onRequestCreate={() => {
+ setOpen(false);
+ setCreateOpen(true);
+ }}
+ />
+ </PopoverContent>
+ </Popover>
+ </div>
<ProjectCreateDialog
open={createOpen}