feat(FN-1178): harden mobile responsiveness across agent modals

- Add mobile full-screen and safe-area CSS rules for agent dialogs, including touch-friendly inputs and footer actions
- Remove hardcoded inline width constraints from AgentGenerationModal so mobile styles can fully apply
- Fill AgentListModal mobile gaps with improved control sizing, wrapped layouts, and single-column behavior at small breakpoints
- Add agent modal mobile regression tests covering responsive classes, breakpoints, and dialog sizing expectations
This commit is contained in:
gsxdsm
2026-04-08 12:18:55 -07:00
parent e4b758d901
commit dc4db25786
4 changed files with 453 additions and 1 deletions

View File

@@ -166,7 +166,6 @@ export function AgentGenerationModal({
role="dialog"
aria-modal="true"
aria-label="Generate agent with AI"
style={{ width: 520, maxWidth: "90vw" }}
>
{/* Header */}
<div className="agent-dialog-header">

View File

@@ -986,6 +986,22 @@ export function AgentListModal({ isOpen, onClose, addToast, projectId }: AgentLi
.agent-modal-content {
padding: var(--space-lg, 16px) var(--space-lg, 16px);
padding-bottom: max(var(--space-lg, 16px), env(safe-area-inset-bottom, 0px));
}
.agent-state-filter-select {
font-size: 16px;
min-height: 44px;
}
.agent-board-actions .btn {
min-height: 44px;
min-width: 44px;
}
.view-toggle-btn {
min-height: 44px;
min-width: 44px;
}
/* Header actions wrap safely */
@@ -1030,8 +1046,15 @@ export function AgentListModal({ isOpen, onClose, addToast, projectId }: AgentLi
align-items: stretch;
}
.agent-create-form .input,
.agent-create-form .select {
width: 100%;
font-size: 16px;
min-height: 44px;
}
.agent-create-form .btn {
min-height: 44px;
}
/* Board goes to single-column */

View File

@@ -0,0 +1,305 @@
import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
import { render, screen, waitFor } from "@testing-library/react";
import userEvent from "@testing-library/user-event";
import fs from "node:fs";
import path from "node:path";
import { AgentDetailView } from "../AgentDetailView";
import { AgentGenerationModal } from "../AgentGenerationModal";
import { AgentImportModal } from "../AgentImportModal";
import { AgentListModal } from "../AgentListModal";
import * as api from "../../api";
vi.mock("../../api", () => ({
fetchAgent: vi.fn(),
updateAgent: vi.fn(),
updateAgentState: vi.fn(),
deleteAgent: vi.fn(),
fetchAgentLogs: vi.fn(),
fetchAgentRunLogs: vi.fn(),
fetchAgentRuns: vi.fn(),
fetchAgentRunDetail: vi.fn(),
startAgentRun: vi.fn(),
fetchAgentTasks: vi.fn(),
fetchChainOfCommand: vi.fn(),
fetchAgents: vi.fn(),
createAgent: vi.fn(),
startAgentGeneration: vi.fn(),
generateAgentSpec: vi.fn(),
cancelAgentGeneration: vi.fn(),
}));
vi.mock("../AgentLogViewer", () => ({
AgentLogViewer: ({ entries }: { entries: Array<{ text: string }> }) => (
<div data-testid="agent-log-viewer">{entries.map((entry, index) => <span key={index}>{entry.text}</span>)}</div>
),
}));
const mockFetchAgent = vi.mocked(api.fetchAgent);
const mockUpdateAgent = vi.mocked(api.updateAgent);
const mockUpdateAgentState = vi.mocked(api.updateAgentState);
const mockDeleteAgent = vi.mocked(api.deleteAgent);
const mockFetchAgentLogs = vi.mocked(api.fetchAgentLogs);
const mockFetchAgentRunLogs = vi.mocked(api.fetchAgentRunLogs);
const mockFetchAgentRuns = vi.mocked(api.fetchAgentRuns);
const mockFetchAgentRunDetail = vi.mocked(api.fetchAgentRunDetail);
const mockStartAgentRun = vi.mocked(api.startAgentRun);
const mockFetchAgentTasks = vi.mocked(api.fetchAgentTasks);
const mockFetchChainOfCommand = vi.mocked(api.fetchChainOfCommand);
const mockFetchAgents = vi.mocked(api.fetchAgents);
const mockCreateAgent = vi.mocked(api.createAgent);
const mockStartAgentGeneration = vi.mocked(api.startAgentGeneration);
const mockGenerateAgentSpec = vi.mocked(api.generateAgentSpec);
const mockCancelAgentGeneration = vi.mocked(api.cancelAgentGeneration);
const originalFetch = globalThis.fetch;
const stylesPath = path.join(__dirname, "../../styles.css");
function readStyles(): string {
return fs.readFileSync(stylesPath, "utf-8");
}
function readRenderedInlineStyles(): string {
return Array.from(document.querySelectorAll("style"))
.map((el) => el.textContent ?? "")
.join("\n");
}
describe("agent modal mobile CSS structure", () => {
beforeEach(() => {
vi.clearAllMocks();
const mockAgent = {
id: "agent-001",
name: "Test Agent",
role: "executor",
state: "active",
taskId: "FN-001",
createdAt: "2026-01-01T00:00:00.000Z",
updatedAt: "2026-01-01T00:00:00.000Z",
lastHeartbeatAt: "2026-01-01T00:10:00.000Z",
metadata: {},
runtimeConfig: {},
heartbeatHistory: [],
activeRun: null,
completedRuns: [],
};
mockFetchAgent.mockResolvedValue(mockAgent as any);
mockUpdateAgent.mockResolvedValue(mockAgent as any);
mockUpdateAgentState.mockResolvedValue({ ...mockAgent, state: "paused" } as any);
mockDeleteAgent.mockResolvedValue(undefined as any);
mockFetchAgentLogs.mockResolvedValue([]);
mockFetchAgentRunLogs.mockResolvedValue([]);
mockFetchAgentRuns.mockResolvedValue([]);
mockFetchAgentRunDetail.mockResolvedValue(undefined as any);
mockStartAgentRun.mockResolvedValue({ id: "run-001", status: "active" } as any);
mockFetchAgentTasks.mockResolvedValue([]);
mockFetchChainOfCommand.mockResolvedValue([mockAgent] as any);
mockFetchAgents.mockResolvedValue([
{
id: "agent-001",
name: "Test Agent",
role: "executor",
state: "idle",
createdAt: "2026-01-01T00:00:00.000Z",
updatedAt: "2026-01-01T00:00:00.000Z",
metadata: {},
},
] as any);
mockCreateAgent.mockResolvedValue({
id: "agent-002",
name: "New Agent",
role: "executor",
state: "idle",
createdAt: "2026-01-01T00:00:00.000Z",
updatedAt: "2026-01-01T00:00:00.000Z",
metadata: {},
} as any);
mockStartAgentGeneration.mockResolvedValue({
sessionId: "session-1",
roleDescription: "Build a reviewer agent",
});
mockGenerateAgentSpec.mockResolvedValue({
spec: {
title: "Accessibility Reviewer",
icon: "♿",
role: "reviewer",
description: "Reviews UI accessibility compliance",
systemPrompt: "You are an accessibility expert.",
thinkingLevel: "high",
maxTurns: 8,
},
});
mockCancelAgentGeneration.mockResolvedValue({ success: true });
globalThis.fetch = vi.fn(async () =>
({
ok: true,
status: 200,
json: async () => ({
companyName: "Acme AI",
agents: [{ name: "Reviewer", role: "reviewer", title: "Code Reviewer" }],
created: ["Reviewer"],
skipped: [],
errors: [],
dryRun: true,
}),
}) as Response,
);
});
afterEach(() => {
globalThis.fetch = originalFetch;
});
describe("AgentDetailView", () => {
it("overlay and modal have mobile-targetable classes", async () => {
render(<AgentDetailView agentId="agent-001" onClose={vi.fn()} addToast={vi.fn()} />);
await waitFor(() => {
expect(document.querySelector(".agent-detail-overlay")).toBeTruthy();
expect(document.querySelector(".agent-detail-modal")).toBeTruthy();
});
});
it("tabs have scrollable container class", async () => {
render(<AgentDetailView agentId="agent-001" onClose={vi.fn()} addToast={vi.fn()} />);
await waitFor(() => {
expect(document.querySelector(".agent-detail-tabs")).toBeTruthy();
expect(document.querySelectorAll(".agent-detail-tab").length).toBeGreaterThan(0);
});
});
it("footer has safe-area class", async () => {
render(<AgentDetailView agentId="agent-001" onClose={vi.fn()} addToast={vi.fn()} />);
await waitFor(() => {
expect(document.querySelector(".agent-detail-footer")).toBeTruthy();
});
});
it("styles.css has mobile full-screen rules for agent-detail modal", () => {
const styles = readStyles();
expect(styles).toMatch(/@media \(max-width: 768px\)[\s\S]*?\.agent-detail-modal[\s\S]*?width:\s*100vw/);
expect(styles).toMatch(/@media \(max-width: 768px\)[\s\S]*?\.agent-detail-modal[\s\S]*?height:\s*100dvh/);
expect(styles).toMatch(/@media \(max-width: 768px\)[\s\S]*?\.agent-detail-modal[\s\S]*?border-radius:\s*0/);
});
});
describe("AgentGenerationModal", () => {
it("overlay and dialog classes exist", () => {
render(<AgentGenerationModal isOpen={true} onClose={vi.fn()} onGenerated={vi.fn()} />);
expect(document.querySelector(".agent-dialog-overlay")).toBeTruthy();
expect(document.querySelector(".agent-dialog")).toBeTruthy();
});
it("does not hardcode inline width on dialog", () => {
render(<AgentGenerationModal isOpen={true} onClose={vi.fn()} onGenerated={vi.fn()} />);
const dialog = document.querySelector(".agent-dialog") as HTMLElement | null;
expect(dialog).toBeTruthy();
expect(dialog?.style.width).toBe("");
expect(dialog?.style.maxWidth).toBe("");
});
it("summary rows have targetable classes in preview", async () => {
render(<AgentGenerationModal isOpen={true} onClose={vi.fn()} onGenerated={vi.fn()} />);
const user = userEvent.setup();
await user.type(screen.getByLabelText("Role Description"), "Build an accessibility reviewer");
await user.click(screen.getByRole("button", { name: "Generate" }));
await waitFor(() => {
expect(screen.getByRole("button", { name: "Use This" })).toBeInTheDocument();
});
expect(document.querySelectorAll(".agent-dialog-summary-row").length).toBeGreaterThan(0);
});
it("styles.css has mobile full-screen rules for agent-dialog", () => {
const styles = readStyles();
expect(styles).toMatch(/@media \(max-width: 768px\)[\s\S]*?\.agent-dialog[\s\S]*?width:\s*100vw(?:\s*!important)?/);
expect(styles).toMatch(/@media \(max-width: 768px\)[\s\S]*?\.agent-dialog[\s\S]*?border-radius:\s*0/);
});
});
describe("AgentImportModal", () => {
it("import dialog class exists", () => {
render(<AgentImportModal isOpen={true} onClose={vi.fn()} onImported={vi.fn()} />);
expect(document.querySelector(".agent-import-dialog")).toBeTruthy();
});
it("file upload area has targetable class", () => {
render(<AgentImportModal isOpen={true} onClose={vi.fn()} onImported={vi.fn()} />);
expect(document.querySelector(".agent-import-file-upload")).toBeTruthy();
});
it("styles.css has mobile rules for agent-import classes", () => {
const styles = readStyles();
expect(styles).toMatch(/@media \(max-width: 768px\)[\s\S]*?\.agent-import-file-upload[\s\S]*?flex-direction:\s*column/);
});
});
describe("AgentListModal", () => {
it("renders modal with modal--wide class", async () => {
render(<AgentListModal isOpen={true} onClose={vi.fn()} addToast={vi.fn()} />);
await waitFor(() => {
expect(document.querySelector(".modal--wide")).toBeTruthy();
});
});
it("inline CSS contains 768px and 640px breakpoints", async () => {
render(<AgentListModal isOpen={true} onClose={vi.fn()} addToast={vi.fn()} />);
await waitFor(() => {
expect(screen.getByText("Agents")).toBeInTheDocument();
});
const css = readRenderedInlineStyles();
expect(css).toContain("@media (max-width: 768px)");
expect(css).toContain("@media (max-width: 640px)");
});
it("inline CSS has board single-column at 640px", async () => {
render(<AgentListModal isOpen={true} onClose={vi.fn()} addToast={vi.fn()} />);
await waitFor(() => {
expect(screen.getByText("Agents")).toBeInTheDocument();
});
const css = readRenderedInlineStyles();
expect(css).toMatch(/@media \(max-width: 640px\)[\s\S]*?\.agent-board\s*{[\s\S]*?grid-template-columns:\s*1fr/);
});
it("inline CSS has controls stacking at 640px", async () => {
render(<AgentListModal isOpen={true} onClose={vi.fn()} addToast={vi.fn()} />);
await waitFor(() => {
expect(screen.getByText("Agents")).toBeInTheDocument();
});
const css = readRenderedInlineStyles();
expect(css).toMatch(/@media \(max-width: 640px\)[\s\S]*?\.agent-controls\s*{[\s\S]*?flex-direction:\s*column/);
});
});
describe("Cross-cutting mobile CSS", () => {
it("agent-dialog mobile rules include safe-area inset handling", () => {
const styles = readStyles();
expect(styles).toMatch(/@media \(max-width: 768px\)[\s\S]*?\.agent-dialog[\s\S]*?safe-area-inset-bottom/);
});
it("agent-dialog mobile rules include 16px field font-size", () => {
const styles = readStyles();
expect(styles).toMatch(/@media \(max-width: 768px\)[\s\S]*?\.agent-dialog-field[\s\S]*?font-size:\s*16px/);
});
});
});

View File

@@ -22714,15 +22714,30 @@ body[data-color-theme="terminal"][data-theme="light"]::before {
font-size: 12px;
}
.log-text {
min-width: 0;
overflow-wrap: anywhere;
}
/* Runs Tab mobile */
.run-card {
padding: var(--space-md);
}
.run-header {
flex-wrap: wrap;
gap: 6px;
}
.run-details {
flex-wrap: wrap;
}
.run-details .text-muted {
min-width: 0;
overflow-wrap: anywhere;
}
/* Config Tab mobile */
.config-tab {
gap: 16px;
@@ -22732,6 +22747,13 @@ body[data-color-theme="terminal"][data-theme="light"]::before {
padding: 16px;
}
.config-section .input,
.config-section .select,
.config-section textarea {
font-size: 16px;
min-height: 44px;
}
.config-actions {
flex-direction: column;
align-items: stretch;
@@ -25202,3 +25224,106 @@ body[data-color-theme="terminal"][data-theme="light"]::before {
min-width: 200px;
}
}
/* === Agent Dialog Mobile Responsive === */
@media (max-width: 768px) {
.agent-dialog-overlay {
padding: 0;
align-items: stretch;
}
.agent-dialog {
width: 100vw !important;
height: 100vh;
height: 100dvh;
max-width: 100% !important;
max-height: 100vh;
max-height: 100dvh;
border-radius: 0;
border: none;
}
.agent-dialog-header {
padding: max(12px, env(safe-area-inset-top, 0px)) 16px 12px 16px;
flex-shrink: 0;
}
.agent-dialog-body {
padding: 16px;
-webkit-overflow-scrolling: touch;
}
.agent-dialog-footer {
padding: 12px 16px;
padding-bottom: max(12px, env(safe-area-inset-bottom, 0px));
flex-wrap: wrap;
gap: var(--space-sm);
}
/* Form fields stack full-width */
.agent-dialog-field .input,
.agent-dialog-field .select,
.agent-dialog-field textarea {
font-size: 16px; /* prevent iOS zoom */
min-height: 44px;
}
/* Summary rows adapt — used by AgentGenerationModal and NewAgentDialog */
.agent-dialog-summary-row {
flex-direction: column;
gap: 2px;
}
.agent-dialog-summary-row > span:first-child,
.agent-dialog-summary-row-label {
width: auto;
}
/* Step indicators stay visible */
.agent-dialog-steps {
padding: 8px 16px;
}
.agent-dialog-step {
flex: 1;
width: auto;
height: 3px;
}
/* Agent Import specific */
.agent-import-file-upload {
flex-direction: column;
align-items: stretch;
gap: var(--space-sm);
}
.agent-import-textarea {
font-size: 16px; /* prevent iOS zoom */
min-height: 100px;
}
.agent-import-agent-list {
max-height: 200px;
}
.agent-import-result-stats {
flex-direction: column;
gap: var(--space-sm);
align-items: center;
}
}
@media (max-width: 480px) {
.agent-dialog-body {
padding: 12px;
}
.agent-dialog-footer {
flex-direction: column;
}
.agent-dialog-footer .btn {
width: 100%;
justify-content: center;
}
}