// @vitest-environment jsdom import { act as reactAct } from "react"; import { flushSync } from "react-dom"; import { createRoot } from "react-dom/client"; import type { Issue } from "@paperclipai/shared"; import { afterEach, beforeEach, describe, expect, it, vi } from "vitest"; import { IssueRow } from "./IssueRow"; import { StatusIcon } from "./StatusIcon"; vi.mock("@/lib/router", () => ({ Link: ({ children, className, disableIssueQuicklook: _disableIssueQuicklook, issuePrefetch, ...props }: React.ComponentProps<"a"> & { disableIssueQuicklook?: boolean; issuePrefetch?: Issue | null }) => ( {children} ), })); // eslint-disable-next-line @typescript-eslint/no-explicit-any (globalThis as any).IS_REACT_ACT_ENVIRONMENT = true; function act(callback: () => void) { if (typeof reactAct === "function") { reactAct(callback); return; } flushSync(callback); } function createIssue(overrides: Partial = {}): Issue { return { id: "issue-1", identifier: "PAP-1", companyId: "company-1", projectId: null, projectWorkspaceId: null, goalId: null, parentId: null, title: "Inbox item", description: null, status: "todo", priority: "medium", reviewPolicy: null, assigneeAgentId: null, assigneeUserId: null, responsibleUserId: null, createdByAgentId: null, createdByUserId: null, issueNumber: 1, requestDepth: 0, billingCode: null, assigneeAdapterOverrides: null, executionWorkspaceId: null, executionWorkspacePreference: null, executionWorkspaceSettings: null, checkoutRunId: null, executionRunId: null, executionAgentNameKey: null, executionLockedAt: null, startedAt: null, completedAt: null, cancelledAt: null, hiddenAt: null, createdAt: new Date("2026-03-11T00:00:00.000Z"), updatedAt: new Date("2026-03-11T00:00:00.000Z"), labels: [], labelIds: [], myLastTouchAt: null, lastExternalCommentAt: null, isUnreadForMe: false, ...overrides, workMode: overrides.workMode ?? "standard", }; } describe("IssueRow", () => { let container: HTMLDivElement; beforeEach(() => { container = document.createElement("div"); document.body.appendChild(container); }); afterEach(() => { container.remove(); }); it("renders the list status glyph at md (16px)", () => { const root = createRoot(container); act(() => { root.render(); }); const glyphs = container.querySelectorAll('svg[viewBox="0 0 24 24"]'); expect(glyphs.length).toBeGreaterThan(0); glyphs.forEach((glyph) => { expect(glyph.getAttribute("width")).toBe("16"); expect(glyph.getAttribute("height")).toBe("16"); }); act(() => { root.unmount(); }); }); it("keeps editable row controls keyboard-accessible and outside the navigation link", () => { const root = createRoot(container); act(() => { root.render( undefined} />} />, ); }); const link = container.querySelector("[data-inbox-issue-link]"); const statusButton = container.querySelector( 'button[aria-label="Change status (current: Todo)"]', ); expect(link).not.toBeNull(); expect(statusButton).not.toBeNull(); expect(statusButton?.tabIndex).toBe(0); expect(link?.contains(statusButton)).toBe(false); act(() => { root.unmount(); }); }); it("suppresses accent hover styling when the row is selected", () => { const root = createRoot(container); const issue = createIssue(); act(() => { root.render(); }); // The hover wash lives on the ROOT row band (not the overlay link) so the // tint paints behind the content. Selected rows suppress the accent hover. const row = container.firstElementChild as HTMLElement | null; const link = container.querySelector("[data-inbox-issue-link]") as HTMLAnchorElement | null; expect(row).not.toBeNull(); expect(row?.className).toContain("hover:bg-transparent"); expect(row?.className).not.toContain("hover:bg-accent/50"); // The overlay link no longer carries the hover wash. expect(link?.className ?? "").not.toContain("hover:bg-transparent"); expect(link?.className ?? "").not.toContain("hover:bg-accent/50"); act(() => { root.unmount(); }); }); it("neutralizes selected status and unread dot accents", () => { const root = createRoot(container); act(() => { root.render(); }); const markReadButton = container.querySelector('button[aria-label="Mark as read"]'); const unreadDot = markReadButton?.querySelector("span"); // Selected rows neutralize the status glyph to muted via `!`-important // utilities, which override the glyph's inline colour var. The glyph is an // (SVGAnimatedString className), so match on the class attribute. const statusGlyph = container.querySelector('svg[class*="text-muted-foreground"]'); expect(markReadButton).not.toBeNull(); expect(markReadButton?.className).toContain("hover:bg-muted/80"); expect(markReadButton?.className).not.toContain("hover:bg-blue-500/20"); expect(unreadDot).not.toBeNull(); expect(unreadDot?.className).toContain("bg-muted-foreground/70"); expect(unreadDot?.className).not.toContain("bg-blue-600"); expect(statusGlyph).not.toBeNull(); expect(statusGlyph?.getAttribute("class")).toContain("!text-muted-foreground"); expect(statusGlyph?.getAttribute("class")).toContain("!border-muted-foreground"); act(() => { root.unmount(); }); }); it("reserves the leading dot slot on read rows so unread rows never indent past them", () => { const root = createRoot(container); act(() => { // A read inbox row still supplies `unreadState` (as "hidden"). root.render(); }); // The desktop dot slot is reserved even when read (empty), so unread rows // add no column and line up with read rows. const slot = container.querySelector('[data-testid="issue-row-unread-slot"]'); expect(slot).not.toBeNull(); expect(slot?.className).toContain("w-4"); expect(slot?.className).toContain("sm:inline-flex"); // In flow, not an absolute overlay. expect(slot?.className).not.toContain("absolute"); // Read rows carry no dot button in the slot. expect(slot?.querySelector('button[aria-label="Mark as read"]')).toBeNull(); act(() => { root.unmount(); }); }); it("puts the unread dot in the reserved desktop slot and overlays it on mobile", () => { const root = createRoot(container); act(() => { root.render(); }); // Desktop: the dot lives in the reserved leading slot (far left, ahead of // any leading control such as a parent's collapse caret). const slot = container.querySelector('[data-testid="issue-row-unread-slot"]'); expect(slot).not.toBeNull(); expect(slot?.querySelector('button[aria-label="Mark as read"]')).not.toBeNull(); // Mobile: all inbox rows reserve a gutter and the dot stays fully inside // it, so the control cannot be clipped or indent the status/title. const mobileDot = container .querySelector('button[aria-label="Mark as read"].sm\\:hidden, span.sm\\:hidden button[aria-label="Mark as read"]') ?.closest("span.sm\\:hidden"); expect(mobileDot).not.toBeNull(); expect(mobileDot?.className).toContain("absolute"); expect(mobileDot?.className).toContain("left-0"); expect(mobileDot?.className).not.toContain("order-first"); expect(container.firstElementChild?.className).toContain("pl-4"); act(() => { root.unmount(); }); }); it("preserves the issue detail breadcrumb source and href in the link target", () => { const root = createRoot(container); const issue = createIssue(); const state = { issueDetailBreadcrumb: { label: "Inbox", href: "/PAP/inbox/mine" }, issueDetailSource: "inbox", }; act(() => { root.render(); }); const link = container.querySelector("[data-inbox-issue-link]") as HTMLAnchorElement | null; expect(link).not.toBeNull(); expect(link?.getAttribute("to") ?? link?.getAttribute("href")).toBe("/issues/PAP-1"); act(() => { root.unmount(); }); }); it("opts issue quicklook out for dense inbox rows", () => { const root = createRoot(container); act(() => { root.render(); }); const link = container.querySelector("[data-inbox-issue-link]") as HTMLAnchorElement | null; expect(link).not.toBeNull(); expect(link?.getAttribute("data-disable-issue-quicklook")).toBe("true"); act(() => { root.unmount(); }); }); it("passes the visible row issue into the navigation prefetch path", () => { const root = createRoot(container); act(() => { root.render(); }); const link = container.querySelector("[data-inbox-issue-link]") as HTMLAnchorElement | null; expect(link?.getAttribute("data-issue-prefetch-id")).toBe("issue-1"); act(() => { root.unmount(); }); }); it("renders titleSuffix inline after the issue title", () => { const root = createRoot(container); const issue = createIssue({ title: "Parent task" }); act(() => { root.render( (3 sub-tasks)} />, ); }); const titleEl = container.querySelector(".line-clamp-2, .truncate"); expect(titleEl?.textContent).toContain("Parent task"); expect(titleEl?.textContent).toContain("(3 sub-tasks)"); expect(container.querySelector('[data-testid="suffix"]')).not.toBeNull(); act(() => { root.unmount(); }); }); it("renders checklist step numbers beside the issue identifier", () => { const root = createRoot(container); act(() => { root.render( , ); }); const metaRow = Array.from(container.querySelectorAll("span.flex.items-center.gap-2")) .find((element) => element.textContent?.includes("PAP-42")); expect(metaRow).not.toBeUndefined(); expect(metaRow?.textContent?.replace(/\s+/g, "")).toContain("2.1.PAP-42"); act(() => { root.unmount(); }); }); it("marks the current checklist step without adding a left border", () => { const root = createRoot(container); act(() => { root.render( , ); }); // `aria-current="step"` stays on the overlay link (the focusable target), // but the current-step wash moved to the ROOT row band alongside the hover // wash so it paints behind the content. const row = container.firstElementChild as HTMLElement | null; const link = container.querySelector("[data-inbox-issue-link]") as HTMLAnchorElement | null; expect(link).not.toBeNull(); expect(link?.getAttribute("aria-current")).toBe("step"); expect(row?.className).toContain("bg-primary/5"); expect(row?.className).not.toContain("border-l-"); expect(link?.className ?? "").not.toContain("bg-primary/5"); act(() => { root.unmount(); }); }); it("does not render a planning mode marker for planning work mode issues", () => { const root = createRoot(container); act(() => { root.render(); }); const link = container.querySelector("[data-inbox-issue-link]") as HTMLAnchorElement | null; expect(link).not.toBeNull(); expect(link?.textContent).not.toContain("Planning"); act(() => { root.unmount(); }); }); it("renders without error when titleSuffix is omitted", () => { const root = createRoot(container); act(() => { root.render(); }); const titleEl = container.querySelector(".line-clamp-2, .truncate"); expect(titleEl?.textContent).toContain("Inbox item"); act(() => { root.unmount(); }); }); it("flags rows blocked by an assigned-backlog leaf with a parked-work badge", () => { const root = createRoot(container); const issue = createIssue({ blockedBy: [ { id: "blocker-1", identifier: "PAP-2", title: "Parked child", status: "backlog", priority: "high", assigneeAgentId: "agent-99", assigneeUserId: null, }, ], }); act(() => { root.render(); }); const badges = container.querySelectorAll('[data-testid="issue-row-parked-blocker"]'); expect(badges.length).toBeGreaterThan(0); expect(badges[0]?.textContent).toContain("Blocked by parked work"); act(() => { root.unmount(); }); }); it("does not show the parked-work badge when assigned blocker is not in backlog", () => { const root = createRoot(container); const issue = createIssue({ blockedBy: [ { id: "blocker-1", identifier: "PAP-2", title: "Active child", status: "in_progress", priority: "high", assigneeAgentId: "agent-99", assigneeUserId: null, }, ], }); act(() => { root.render(); }); expect(container.querySelector('[data-testid="issue-row-parked-blocker"]')).toBeNull(); act(() => { root.unmount(); }); }); it("renders no bottom divider by default", () => { const root = createRoot(container); act(() => { root.render(); }); // Dividers are opt-in: without `showDivider` no row-separating border // renders on either the root band or the overlay link. const row = container.firstElementChild as HTMLElement | null; const link = container.querySelector("[data-inbox-issue-link]") as HTMLAnchorElement | null; expect(row).not.toBeNull(); expect(row?.className).not.toContain("border-b"); expect(link?.className ?? "").not.toContain("border-b"); act(() => { root.unmount(); }); }); it("renders an opt-in bottom divider on the row root when showDivider is set", () => { const root = createRoot(container); act(() => { root.render(); }); // The divider lives on the ROOT row band with `last:border-b-0` so the real // last row drops its border — it is not on the overlay link. const row = container.firstElementChild as HTMLElement | null; const link = container.querySelector("[data-inbox-issue-link]") as HTMLAnchorElement | null; expect(row?.className).toContain("border-b"); expect(row?.className).toContain("last:border-b-0"); expect(link?.className ?? "").not.toContain("border-b"); act(() => { root.unmount(); }); }); describe("recovery indicator", () => { const recoveryAction = { id: "recovery-1", companyId: "company-1", sourceIssueId: "issue-1", recoveryIssueId: null, kind: "stranded_assigned_issue", status: "active", ownerType: "agent", ownerAgentId: "cto-agent", ownerUserId: null, previousOwnerAgentId: null, returnOwnerAgentId: null, cause: "stranded_assigned_issue", fingerprint: "fp", evidence: {}, nextAction: "Choose what happens next.", wakePolicy: null, monitorPolicy: null, attemptCount: 1, maxAttempts: 3, timeoutAt: null, lastAttemptAt: null, outcome: null, resolutionNote: null, resolvedAt: null, createdAt: new Date("2026-08-11T00:00:00.000Z"), updatedAt: new Date("2026-08-11T00:00:00.000Z"), } as unknown as NonNullable; function renderRow(issue: Issue) { const root = createRoot(container); act(() => { root.render(); }); const chip = container.querySelector('[data-testid="issue-row-recovery-indicator"]'); const result = { state: chip?.getAttribute("data-recovery-state"), text: chip?.textContent }; act(() => { root.unmount(); }); return result; } it("warns when no owner is running the recovery", () => { expect( renderRow(createIssue({ activeRecoveryAction: recoveryAction })), ).toEqual({ state: "needed", text: "Recovery needed" }); }); it("recesses to in-progress while the recovery owner holds the execution lock", () => { expect( renderRow( createIssue({ status: "in_progress", executionRunId: "run-1", assigneeAgentId: "cto-agent", activeRecoveryAction: recoveryAction, }), ), ).toEqual({ state: "in_progress", text: "Recovery in progress" }); }); it("recesses to observation when a different owner is live on the task", () => { expect( renderRow( createIssue({ status: "in_progress", executionRunId: "run-1", assigneeAgentId: "coder-agent", activeRecoveryAction: recoveryAction, }), ), ).toEqual({ state: "observe_only", text: "Observing active run" }); }); it("recesses to in-progress while a wake is queued", () => { expect( renderRow( createIssue({ activeRecoveryAction: recoveryAction, scheduledRetry: { runId: "run-2", status: "scheduled_retry", agentId: "cto-agent", agentName: "CTO", retryOfRunId: null, scheduledRetryAt: null, scheduledRetryAttempt: 1, scheduledRetryReason: null, }, }), ), ).toEqual({ state: "in_progress", text: "Recovery in progress" }); }); // PAP-17070: the chip was painted twice on mobile — once in the `sm:hidden` // leading cluster and again beside the identifier, whose copy had no desktop // gate. Because badges are `whitespace-nowrap shrink-0`, that duplicate // pushed a 390px document out to 403px. Exactly one copy may be visible at // any one breakpoint. it.each([ ["needed", {}], [ "in_progress", { status: "in_progress", executionRunId: "run-1", assigneeAgentId: "cto-agent" }, ], [ "observe_only", { status: "in_progress", executionRunId: "run-1", assigneeAgentId: "coder-agent" }, ], ["escalated", { activeRecoveryAction: { ...recoveryAction, status: "escalated" } }], ] as const)("renders one %s chip per breakpoint, never two at once", (state, overrides) => { const root = createRoot(container); act(() => { root.render( ), })} />, ); }); const chips = Array.from( container.querySelectorAll('[data-testid="issue-row-recovery-indicator"]'), ); expect(chips.map((chip) => chip.getAttribute("data-recovery-state"))).toEqual([state, state]); // Classify each copy by the breakpoint gate on its ancestors. const visibility = chips.map((chip) => { let node = chip.parentElement; while (node && node !== container) { const classes = node.className; if (typeof classes === "string") { if (classes.includes("sm:hidden")) return "mobile"; if (classes.includes("hidden") && classes.includes("sm:inline-flex")) return "desktop"; } node = node.parentElement; } return "always"; }); expect(visibility.sort()).toEqual(["desktop", "mobile"]); // A hard width ceiling is the backstop for a long label in either slot. chips.forEach((chip) => { expect(chip.className).toContain("max-w-(--sz-12rem)"); expect(chip.querySelector("span")?.className).toContain("truncate"); }); act(() => { root.unmount(); }); }); }); it("keeps the hover wash on the row root while the overlay link stays a bare positioning layer", () => { const root = createRoot(container); act(() => { root.render(); }); const row = container.firstElementChild as HTMLElement | null; const link = container.querySelector("[data-inbox-issue-link]") as HTMLAnchorElement | null; // Hover wash paints behind the content on the root band... expect(row?.className).toContain("hover:bg-accent/50"); expect(link?.className ?? "").not.toContain("hover:bg-accent/50"); // ...and the overlay link keeps only positioning + focus concerns. expect(link?.className).toContain("absolute"); expect(link?.className).toContain("inset-0"); act(() => { root.unmount(); }); }); });