Files
paperclip/ui/storybook/stories/dialogs-modals.stories.tsx
T
Dotta 2de893f624 [codex] add comprehensive UI Storybook coverage (#4132)
## Thinking Path

> - Paperclip orchestrates AI agents for zero-human companies.
> - The board UI is the main operator surface, so its component and
workflow coverage needs to stay reviewable as the product grows.
> - This branch adds Storybook as a dedicated UI reference surface for
core Paperclip screens and interaction patterns.
> - That work spans Storybook infrastructure, app-level provider wiring,
and a large fixture set that can render real control-plane states
without a live backend.
> - The branch also expands coverage across agents, budgets, issues,
chat, dialogs, navigation, projects, and data visualization so future UI
changes have a concrete visual baseline.
> - This pull request packages that Storybook work on top of the latest
`master`, excludes the lockfile from the final diff per repo policy, and
fixes one fixture contract drift caught during verification.
> - The benefit is a single reviewable PR that adds broad UI
documentation and regression-surfacing coverage without losing the
existing branch work.

## What Changed

- Added Storybook 10 wiring for the UI package, including root scripts,
UI package scripts, Storybook config, preview wrappers, Tailwind
entrypoints, and setup docs.
- Added a large fixture-backed data source for Storybook so complex
board states can render without a live server.
- Added story suites covering foundations, status language,
control-plane surfaces, overview, UX labs, agent management, budget and
finance, forms and editors, issue management, navigation and layout,
chat and comments, data visualization, dialogs and modals, and
projects/goals/workspaces.
- Adjusted several UI components for Storybook parity so dialogs, menus,
keyboard shortcuts, budget markers, markdown editing, and related
surfaces render correctly in isolation.
- Rebasing work for PR assembly: replayed the branch onto current
`master`, removed `pnpm-lock.yaml` from the final PR diff, and aligned
the dashboard fixture with the current `DashboardSummary.runActivity`
API contract.

## Verification

- `pnpm --filter @paperclipai/ui typecheck`
- `pnpm --filter @paperclipai/ui build-storybook`
- Manual diff audit after rebase: verified the PR no longer includes
`pnpm-lock.yaml` and now cleanly targets current `master`.
- Before/after UI note: before this branch there was no dedicated
Storybook surface for these Paperclip views; after this branch the local
Storybook build includes the new overview and domain story suites in
`ui/storybook-static`.

## Risks

- Large static fixture files can drift from shared types as dashboard
and UI contracts evolve; this PR already needed one fixture correction
for `runActivity`.
- Storybook bundle output includes some large chunks, so future growth
may need chunking work if build performance becomes an issue.
- Several component tweaks were made for isolated rendering parity, so
reviewers should spot-check key board surfaces against the live app
behavior.

## Model Used

- OpenAI Codex, GPT-5-based coding agent in the Paperclip harness; exact
serving model ID is not exposed in-runtime to the agent.
- Tool-assisted workflow with terminal execution, git operations, local
typecheck/build verification, and GitHub CLI PR creation.
- Context window/reasoning mode not surfaced by the harness.

## Checklist

- [x] I have included a thinking path that traces from project context
to this change
- [x] I have specified the model used (with version and capability
details)
- [x] I have checked ROADMAP.md and confirmed this PR does not duplicate
planned core work
- [x] I have run tests locally and they pass
- [x] I have added or updated tests where applicable
- [ ] If this change affects the UI, I have included before/after
screenshots
- [x] I have updated relevant documentation to reflect my changes
- [x] I have considered and documented any risks above
- [x] I will address all Greptile and reviewer comments before
requesting merge

---------

Co-authored-by: Paperclip <noreply@paperclip.ing>
2026-04-20 12:13:23 -05:00

837 lines
28 KiB
TypeScript

import { useEffect, useLayoutEffect, useRef, useState, type ReactNode } from "react";
import type { Meta, StoryObj } from "@storybook/react-vite";
import type {
DocumentRevision,
ExecutionWorkspaceCloseReadiness,
Goal,
IssueAttachment,
} from "@paperclipai/shared";
import { useQueryClient } from "@tanstack/react-query";
import { Badge } from "@/components/ui/badge";
import { DocumentDiffModal } from "@/components/DocumentDiffModal";
import { ExecutionWorkspaceCloseDialog } from "@/components/ExecutionWorkspaceCloseDialog";
import { ImageGalleryModal } from "@/components/ImageGalleryModal";
import { NewAgentDialog } from "@/components/NewAgentDialog";
import { NewGoalDialog } from "@/components/NewGoalDialog";
import { NewIssueDialog } from "@/components/NewIssueDialog";
import { NewProjectDialog } from "@/components/NewProjectDialog";
import { PathInstructionsModal } from "@/components/PathInstructionsModal";
import { useCompany } from "@/context/CompanyContext";
import { useDialog } from "@/context/DialogContext";
import { queryKeys } from "@/lib/queryKeys";
import {
storybookAgents,
storybookAuthSession,
storybookCompanies,
storybookExecutionWorkspaces,
storybookIssueDocuments,
storybookIssueLabels,
storybookIssues,
storybookProjects,
} from "../fixtures/paperclipData";
const COMPANY_ID = "company-storybook";
const SELECTED_COMPANY_STORAGE_KEY = "paperclip.selectedCompanyId";
const ISSUE_DRAFT_STORAGE_KEY = "paperclip:issue-draft";
const storybookGoals: Goal[] = [
{
id: "goal-company",
companyId: COMPANY_ID,
title: "Build Paperclip",
description: "Make autonomous companies easier to run and govern.",
level: "company",
status: "active",
parentId: null,
ownerAgentId: "agent-cto",
createdAt: new Date("2026-04-01T09:00:00.000Z"),
updatedAt: new Date("2026-04-20T11:00:00.000Z"),
},
{
id: "goal-storybook",
companyId: COMPANY_ID,
title: "Complete Storybook coverage",
description: "Expose dense board UI states for review before release.",
level: "team",
status: "active",
parentId: "goal-company",
ownerAgentId: "agent-codex",
createdAt: new Date("2026-04-17T09:00:00.000Z"),
updatedAt: new Date("2026-04-20T11:10:00.000Z"),
},
{
id: "goal-governance",
companyId: COMPANY_ID,
title: "Tighten governance review",
description: "Make review and approval gates visible in every operator flow.",
level: "team",
status: "planned",
parentId: "goal-company",
ownerAgentId: "agent-cto",
createdAt: new Date("2026-04-18T09:00:00.000Z"),
updatedAt: new Date("2026-04-20T11:15:00.000Z"),
},
];
const documentRevisions: DocumentRevision[] = [
{
id: "revision-plan-1",
companyId: COMPANY_ID,
documentId: "document-plan-storybook",
issueId: "issue-storybook-1",
key: "plan",
revisionNumber: 1,
title: "Plan",
format: "markdown",
body: [
"# Plan",
"",
"- Add overview stories for the dashboard.",
"- Create issue list stories for filters and grouping.",
"- Ask QA to review the final Storybook build.",
].join("\n"),
changeSummary: "Initial plan",
createdByAgentId: "agent-codex",
createdByUserId: null,
createdAt: new Date("2026-04-20T08:00:00.000Z"),
},
{
id: "revision-plan-2",
companyId: COMPANY_ID,
documentId: "document-plan-storybook",
issueId: "issue-storybook-1",
key: "plan",
revisionNumber: 2,
title: "Plan",
format: "markdown",
body: [
"# Plan",
"",
"- Add overview stories for the dashboard.",
"- Create issue list stories for filters, grouping, and workspace state.",
"- Add dialog stories for issue, goal, project, and workspace workflows.",
"- Ask QA to review the final Storybook build.",
].join("\n"),
changeSummary: "Expanded component coverage",
createdByAgentId: "agent-codex",
createdByUserId: null,
createdAt: new Date("2026-04-20T10:00:00.000Z"),
},
{
id: "revision-plan-3",
companyId: COMPANY_ID,
documentId: "document-plan-storybook",
issueId: "issue-storybook-1",
key: "plan",
revisionNumber: 3,
title: "Plan",
format: "markdown",
body: storybookIssueDocuments[0]?.body ?? "",
changeSummary: "Aligned with current issue scope",
createdByAgentId: "agent-codex",
createdByUserId: null,
createdAt: new Date("2026-04-20T11:30:00.000Z"),
},
];
const closeReadinessReady: ExecutionWorkspaceCloseReadiness = {
workspaceId: "execution-workspace-storybook",
state: "ready_with_warnings",
blockingReasons: [],
warnings: [
"The branch is still two commits ahead of master.",
"One shared runtime service will be stopped during cleanup.",
],
linkedIssues: [
{
id: "issue-storybook-1",
identifier: "PAP-1641",
title: "Create super-detailed storybooks for the project",
status: "done",
isTerminal: true,
},
{
id: "issue-storybook-6",
identifier: "PAP-1670",
title: "Publish static Storybook preview",
status: "todo",
isTerminal: false,
},
],
plannedActions: [
{
kind: "stop_runtime_services",
label: "Stop Storybook preview",
description: "Stops the managed Storybook preview service before archiving the workspace record.",
command: "pnpm dev:stop",
},
{
kind: "git_worktree_remove",
label: "Remove git worktree",
description: "Removes the issue worktree from the local worktree parent directory.",
command: "git worktree remove .paperclip/worktrees/PAP-1641-create-super-detailed-storybooks-for-our-project",
},
{
kind: "archive_record",
label: "Archive workspace record",
description: "Keeps audit history while removing the workspace from active workspace views.",
command: null,
},
],
isDestructiveCloseAllowed: true,
isSharedWorkspace: false,
isProjectPrimaryWorkspace: false,
git: {
repoRoot: "/Users/dotta/paperclip",
workspacePath: "/Users/dotta/paperclip/.paperclip/worktrees/PAP-1641-create-super-detailed-storybooks-for-our-project",
branchName: "PAP-1641-create-super-detailed-storybooks-for-our-project",
baseRef: "master",
hasDirtyTrackedFiles: true,
hasUntrackedFiles: false,
dirtyEntryCount: 3,
untrackedEntryCount: 0,
aheadCount: 2,
behindCount: 0,
isMergedIntoBase: false,
createdByRuntime: true,
},
runtimeServices: storybookExecutionWorkspaces[0]?.runtimeServices ?? [],
};
const closeReadinessBlocked: ExecutionWorkspaceCloseReadiness = {
...closeReadinessReady,
state: "blocked",
blockingReasons: [
"PAP-1670 is still open and references this execution workspace.",
"The worktree has dirty tracked files that have not been committed.",
],
warnings: [],
plannedActions: closeReadinessReady.plannedActions.slice(0, 1),
};
const galleryImages: IssueAttachment[] = [
{
id: "attachment-storybook-dashboard",
companyId: COMPANY_ID,
issueId: "issue-storybook-1",
issueCommentId: null,
assetId: "asset-dashboard",
provider: "storybook",
objectKey: "storybook/dashboard-preview.svg",
contentType: "image/svg+xml",
byteSize: 1480,
sha256: "storybook-dashboard-preview",
originalFilename: "dashboard-preview.png",
createdByAgentId: "agent-codex",
createdByUserId: null,
createdAt: new Date("2026-04-20T10:30:00.000Z"),
updatedAt: new Date("2026-04-20T10:30:00.000Z"),
contentPath:
"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='1400' height='900' viewBox='0 0 1400 900'%3E%3Crect width='1400' height='900' fill='%230f172a'/%3E%3Crect x='88' y='96' width='1224' height='708' rx='28' fill='%23111827' stroke='%23334155' stroke-width='4'/%3E%3Crect x='136' y='148' width='264' height='604' rx='18' fill='%231e293b'/%3E%3Crect x='444' y='148' width='380' height='190' rx='18' fill='%230f766e'/%3E%3Crect x='860' y='148' width='348' height='190' rx='18' fill='%232563eb'/%3E%3Crect x='444' y='382' width='764' height='104' rx='18' fill='%23334155'/%3E%3Crect x='444' y='526' width='764' height='104' rx='18' fill='%23334155'/%3E%3Crect x='444' y='670' width='520' height='82' rx='18' fill='%23334155'/%3E%3Ccircle cx='236' cy='236' r='58' fill='%2314b8a6'/%3E%3Crect x='188' y='334' width='164' height='18' rx='9' fill='%2394a3b8'/%3E%3Crect x='188' y='386' width='128' height='18' rx='9' fill='%2364748b'/%3E%3Crect x='188' y='438' width='176' height='18' rx='9' fill='%2364748b'/%3E%3C/svg%3E",
},
{
id: "attachment-storybook-diff",
companyId: COMPANY_ID,
issueId: "issue-storybook-1",
issueCommentId: null,
assetId: "asset-diff",
provider: "storybook",
objectKey: "storybook/diff-preview.svg",
contentType: "image/svg+xml",
byteSize: 1320,
sha256: "storybook-diff-preview",
originalFilename: "document-diff-preview.png",
createdByAgentId: "agent-qa",
createdByUserId: null,
createdAt: new Date("2026-04-20T10:40:00.000Z"),
updatedAt: new Date("2026-04-20T10:40:00.000Z"),
contentPath:
"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='1400' height='900' viewBox='0 0 1400 900'%3E%3Crect width='1400' height='900' fill='%23171717'/%3E%3Crect x='110' y='104' width='1180' height='692' rx='24' fill='%230a0a0a' stroke='%23333333' stroke-width='4'/%3E%3Crect x='160' y='164' width='1080' height='48' rx='12' fill='%23262626'/%3E%3Crect x='160' y='260' width='1080' height='52' fill='%2315221a'/%3E%3Crect x='160' y='312' width='1080' height='52' fill='%23231818'/%3E%3Crect x='160' y='364' width='1080' height='52' fill='%2315221a'/%3E%3Crect x='160' y='468' width='1080' height='52' fill='%23231818'/%3E%3Crect x='160' y='520' width='1080' height='52' fill='%2315221a'/%3E%3Crect x='220' y='276' width='720' height='18' rx='9' fill='%2374c69d'/%3E%3Crect x='220' y='328' width='540' height='18' rx='9' fill='%23fca5a5'/%3E%3Crect x='220' y='380' width='820' height='18' rx='9' fill='%2374c69d'/%3E%3Crect x='220' y='484' width='480' height='18' rx='9' fill='%23fca5a5'/%3E%3Crect x='220' y='536' width='760' height='18' rx='9' fill='%2374c69d'/%3E%3C/svg%3E",
},
];
function Section({
eyebrow,
title,
description,
children,
}: {
eyebrow: string;
title: string;
description?: string;
children: ReactNode;
}) {
return (
<section className="paperclip-story__frame overflow-hidden">
<div className="border-b border-border px-5 py-4">
<div className="paperclip-story__label">{eyebrow}</div>
<div className="mt-1 flex flex-wrap items-end justify-between gap-3">
<div>
<h2 className="text-xl font-semibold">{title}</h2>
{description ? (
<p className="mt-2 max-w-3xl text-sm leading-6 text-muted-foreground">{description}</p>
) : null}
</div>
</div>
</div>
<div className="p-5">{children}</div>
</section>
);
}
function StoryShell({ children }: { children: ReactNode }) {
return (
<div className="paperclip-story">
<main className="paperclip-story__inner space-y-6">{children}</main>
</div>
);
}
function DialogBackdropFrame({
eyebrow,
title,
description,
badges,
}: {
eyebrow: string;
title: string;
description: string;
badges: string[];
}) {
return (
<StoryShell>
<Section eyebrow={eyebrow} title={title} description={description}>
<div className="grid gap-4 md:grid-cols-[minmax(0,1fr)_260px]">
<div className="space-y-3">
<div className="h-3 w-36 rounded-full bg-muted" />
<div className="h-24 rounded-lg border border-dashed border-border bg-muted/30" />
<div className="grid gap-3 sm:grid-cols-3">
<div className="h-16 rounded-lg border border-border bg-background/70" />
<div className="h-16 rounded-lg border border-border bg-background/70" />
<div className="h-16 rounded-lg border border-border bg-background/70" />
</div>
</div>
<div className="rounded-lg border border-border bg-background/70 p-4">
<div className="mb-3 text-sm font-medium">Story state</div>
<div className="flex flex-wrap gap-2">
{badges.map((badge) => (
<Badge key={badge} variant="outline">
{badge}
</Badge>
))}
</div>
</div>
</div>
</Section>
</StoryShell>
);
}
function hydrateDialogQueries(queryClient: ReturnType<typeof useQueryClient>) {
queryClient.setQueryData(queryKeys.companies.all, storybookCompanies);
queryClient.setQueryData(queryKeys.auth.session, storybookAuthSession);
queryClient.setQueryData(queryKeys.agents.list(COMPANY_ID), storybookAgents);
queryClient.setQueryData(queryKeys.projects.list(COMPANY_ID), storybookProjects);
queryClient.setQueryData(queryKeys.goals.list(COMPANY_ID), storybookGoals);
queryClient.setQueryData(queryKeys.issues.list(COMPANY_ID), storybookIssues);
queryClient.setQueryData(queryKeys.issues.labels(COMPANY_ID), storybookIssueLabels);
queryClient.setQueryData(queryKeys.issues.documents("issue-storybook-1"), storybookIssueDocuments);
queryClient.setQueryData(queryKeys.issues.documentRevisions("issue-storybook-1", "plan"), documentRevisions);
queryClient.setQueryData(queryKeys.executionWorkspaces.closeReadiness("execution-workspace-storybook"), closeReadinessReady);
queryClient.setQueryData(queryKeys.executionWorkspaces.closeReadiness("execution-workspace-blocked"), closeReadinessBlocked);
queryClient.setQueryData(
queryKeys.executionWorkspaces.list(COMPANY_ID, {
projectId: "project-board-ui",
projectWorkspaceId: "workspace-board-ui",
reuseEligible: true,
}),
storybookExecutionWorkspaces,
);
queryClient.setQueryData(queryKeys.instance.experimentalSettings, {
enableIsolatedWorkspaces: true,
enableRoutineTriggers: true,
});
queryClient.setQueryData(queryKeys.access.companyUserDirectory(COMPANY_ID), {
users: [
{
principalId: "user-board",
status: "active",
user: {
id: "user-board",
email: "riley@paperclip.local",
name: "Riley Board",
image: null,
},
},
],
});
queryClient.setQueryData(
queryKeys.sidebarPreferences.projectOrder(COMPANY_ID, storybookAuthSession.user.id),
{ orderedIds: storybookProjects.map((project) => project.id), updatedAt: null },
);
queryClient.setQueryData(queryKeys.adapters.all, [
{
type: "codex_local",
label: "Codex local",
source: "builtin",
modelsCount: 5,
loaded: true,
disabled: false,
capabilities: {
supportsInstructionsBundle: true,
supportsSkills: true,
supportsLocalAgentJwt: true,
requiresMaterializedRuntimeSkills: false,
},
},
{
type: "claude_local",
label: "Claude local",
source: "builtin",
modelsCount: 4,
loaded: true,
disabled: false,
capabilities: {
supportsInstructionsBundle: true,
supportsSkills: true,
supportsLocalAgentJwt: true,
requiresMaterializedRuntimeSkills: false,
},
},
]);
queryClient.setQueryData(queryKeys.agents.adapterModels(COMPANY_ID, "codex_local"), [
{ id: "gpt-5.4", label: "GPT-5.4" },
{ id: "gpt-5.4-mini", label: "GPT-5.4 Mini" },
]);
}
function StorybookDialogFixtures({ children }: { children: ReactNode }) {
const queryClient = useQueryClient();
const [ready] = useState(() => {
if (typeof window !== "undefined") {
window.localStorage.setItem(SELECTED_COMPANY_STORAGE_KEY, COMPANY_ID);
window.localStorage.removeItem(ISSUE_DRAFT_STORAGE_KEY);
}
hydrateDialogQueries(queryClient);
return true;
});
return ready ? children : null;
}
function useIssueCreateErrorMock(enabled: boolean) {
useLayoutEffect(() => {
if (!enabled || typeof window === "undefined") return undefined;
const originalFetch = window.fetch.bind(window);
window.fetch = async (input: RequestInfo | URL, init?: RequestInit) => {
const rawUrl =
typeof input === "string"
? input
: input instanceof URL
? input.href
: input.url;
const url = new URL(rawUrl, window.location.origin);
if (url.pathname === `/api/companies/${COMPANY_ID}/issues` && init?.method === "POST") {
return Response.json(
{ error: "Validation failed: add a reviewer before creating governed release work." },
{ status: 422 },
);
}
return originalFetch(input, init);
};
return () => {
window.fetch = originalFetch;
};
}, [enabled]);
}
function setFieldValue(element: HTMLInputElement | HTMLTextAreaElement, value: string) {
const prototype = Object.getPrototypeOf(element) as HTMLInputElement | HTMLTextAreaElement;
const valueSetter = Object.getOwnPropertyDescriptor(prototype, "value")?.set;
valueSetter?.call(element, value);
element.dispatchEvent(new Event("input", { bubbles: true }));
element.dispatchEvent(new Event("change", { bubbles: true }));
}
function fillFirstField(selector: string, value: string) {
const element = document.querySelector<HTMLInputElement | HTMLTextAreaElement>(selector);
if (!element) return false;
setFieldValue(element, value);
return true;
}
function clickButtonByText(text: string) {
const buttons = Array.from(document.querySelectorAll<HTMLButtonElement>("button"));
const button = buttons.find((candidate) => candidate.textContent?.trim().includes(text));
button?.click();
}
function useOpenWhenCompanyReady(open: () => void) {
const { selectedCompanyId, setSelectedCompanyId } = useCompany();
const didOpenRef = useRef(false);
useLayoutEffect(() => {
if (selectedCompanyId !== COMPANY_ID) {
setSelectedCompanyId(COMPANY_ID);
return;
}
if (didOpenRef.current) return;
didOpenRef.current = true;
open();
}, [open, selectedCompanyId, setSelectedCompanyId]);
}
function IssueDialogOpener({
variant,
}: {
variant: "empty" | "prefilled" | "validation";
}) {
const { openNewIssue } = useDialog();
useIssueCreateErrorMock(variant === "validation");
useOpenWhenCompanyReady(() => {
openNewIssue(
variant === "empty"
? {}
: {
title: variant === "validation" ? "Ship guarded release checklist" : "Create dialog Storybook coverage",
description: [
"Cover modal flows with fixture-backed states.",
"",
"- Keep dialogs open by default",
"- Show project workspace selection",
"- Include reviewer and approver context",
].join("\n"),
status: "todo",
priority: "high",
projectId: "project-board-ui",
projectWorkspaceId: "workspace-board-ui",
assigneeAgentId: "agent-codex",
executionWorkspaceMode: "isolated_workspace",
},
);
});
useEffect(() => {
if (variant !== "validation") return undefined;
const timer = window.setTimeout(() => {
clickButtonByText("Create Issue");
}, 500);
return () => window.clearTimeout(timer);
}, [variant]);
return <NewIssueDialog />;
}
function AgentDialogOpener({ advanced }: { advanced?: boolean }) {
const { openNewAgent } = useDialog();
useOpenWhenCompanyReady(() => {
openNewAgent();
});
useEffect(() => {
if (!advanced) return undefined;
const timer = window.setTimeout(() => {
clickButtonByText("advanced configuration");
}, 250);
return () => window.clearTimeout(timer);
}, [advanced]);
return <NewAgentDialog />;
}
function GoalDialogOpener({ populated }: { populated?: boolean }) {
const { openNewGoal } = useDialog();
useOpenWhenCompanyReady(() => {
openNewGoal(populated ? { parentId: "goal-company" } : {});
});
useEffect(() => {
if (!populated) return undefined;
const timer = window.setTimeout(() => {
fillFirstField("input[placeholder='Goal title']", "Add modal review coverage");
}, 250);
return () => window.clearTimeout(timer);
}, [populated]);
return <NewGoalDialog />;
}
function ProjectDialogOpener({ populated }: { populated?: boolean }) {
const { openNewProject } = useDialog();
useOpenWhenCompanyReady(() => {
openNewProject();
});
useEffect(() => {
if (!populated) return undefined;
const timer = window.setTimeout(() => {
fillFirstField("input[placeholder='Project name']", "Storybook review workspace");
fillFirstField("input[placeholder='https://github.com/org/repo']", "https://github.com/paperclipai/paperclip");
fillFirstField("input[placeholder='/absolute/path/to/workspace']", "/Users/dotta/paperclip/ui");
fillFirstField("input[type='date']", "2026-04-30");
}, 250);
return () => window.clearTimeout(timer);
}, [populated]);
return <NewProjectDialog />;
}
function DialogStory({
eyebrow,
title,
description,
badges,
children,
}: {
eyebrow: string;
title: string;
description: string;
badges: string[];
children: ReactNode;
}) {
return (
<StorybookDialogFixtures>
<DialogBackdropFrame eyebrow={eyebrow} title={title} description={description} badges={badges} />
{children}
</StorybookDialogFixtures>
);
}
function ExecutionWorkspaceDialogStory({ blocked }: { blocked?: boolean }) {
const workspace = storybookExecutionWorkspaces[0]!;
return (
<DialogStory
eyebrow="ExecutionWorkspaceCloseDialog"
title={blocked ? "Blocked workspace close confirmation" : "Workspace close confirmation"}
description="The close dialog exposes linked issues, git state, runtime services, and planned cleanup actions before archiving an execution workspace."
badges={blocked ? ["blocked", "dirty worktree", "linked issue"] : ["ready with warnings", "cleanup actions"]}
>
<ExecutionWorkspaceCloseDialog
workspaceId={blocked ? "execution-workspace-blocked" : workspace.id}
workspaceName={blocked ? "PAP-1670 publish preview worktree" : workspace.name}
currentStatus={workspace.status}
open
onOpenChange={() => undefined}
/>
</DialogStory>
);
}
function DocumentDiffModalStory() {
return (
<DialogStory
eyebrow="DocumentDiffModal"
title="Revision diff view"
description="The diff modal compares document revisions with selectable old and new snapshots."
badges={["revision selector", "line diff", "document history"]}
>
<DocumentDiffModal
issueId="issue-storybook-1"
documentKey="plan"
latestRevisionNumber={3}
open
onOpenChange={() => undefined}
/>
</DialogStory>
);
}
function ImageGalleryModalStory() {
return (
<DialogStory
eyebrow="ImageGalleryModal"
title="Attachment gallery"
description="The image gallery opens full-screen with attachment metadata, download action, and previous/next navigation."
badges={["full-screen", "navigation", "visual attachment"]}
>
<ImageGalleryModal images={galleryImages} initialIndex={0} open onOpenChange={() => undefined} />
</DialogStory>
);
}
function PathInstructionsModalStory() {
return (
<DialogStory
eyebrow="PathInstructionsModal"
title="Absolute path instructions"
description="The path helper opens directly to platform-specific steps for copying a full local workspace path."
badges={["macOS", "Windows", "Linux"]}
>
<PathInstructionsModal open onOpenChange={() => undefined} />
</DialogStory>
);
}
const meta = {
title: "Product/Dialogs & Modals",
parameters: {
docs: {
description: {
component:
"Open-state stories for Paperclip creation dialogs, workspace confirmations, document diffing, image attachments, and path helper modals.",
},
},
},
} satisfies Meta;
export default meta;
type Story = StoryObj<typeof meta>;
export const NewIssueEmpty: Story = {
name: "New Issue - Empty",
render: () => (
<DialogStory
eyebrow="NewIssueDialog"
title="Empty issue form"
description="Default issue creation state with no assignee, project, priority, or workspace selected."
badges={["empty", "creation", "draft"]}
>
<IssueDialogOpener variant="empty" />
</DialogStory>
),
};
export const NewIssuePrefilled: Story = {
name: "New Issue - Prefilled",
render: () => (
<DialogStory
eyebrow="NewIssueDialog"
title="Prefilled issue form"
description="Populated issue creation state with project context, assignee, priority, description, and isolated workspace selection."
badges={["populated", "assignee", "workspace"]}
>
<IssueDialogOpener variant="prefilled" />
</DialogStory>
),
};
export const NewIssueValidationError: Story = {
name: "New Issue - Validation Error",
render: () => (
<DialogStory
eyebrow="NewIssueDialog"
title="Validation error after submit"
description="The submit path is mocked to return a 422 so the footer error state remains visible for review."
badges={["validation", "422", "error"]}
>
<IssueDialogOpener variant="validation" />
</DialogStory>
),
};
export const NewAgentRecommendation: Story = {
name: "New Agent - Recommendation",
render: () => (
<DialogStory
eyebrow="NewAgentDialog"
title="Recommended CEO-assisted setup"
description="Initial agent creation wizard state that routes operators toward CEO-owned agent setup."
badges={["empty", "wizard", "CEO handoff"]}
>
<AgentDialogOpener />
</DialogStory>
),
};
export const NewAgentAdapterSelection: Story = {
name: "New Agent - Adapter Selection",
render: () => (
<DialogStory
eyebrow="NewAgentDialog"
title="Advanced adapter selection"
description="Advanced branch of the agent creation wizard showing registered adapter choices and recommended states."
badges={["populated", "adapters", "advanced"]}
>
<AgentDialogOpener advanced />
</DialogStory>
),
};
export const NewGoalEmpty: Story = {
name: "New Goal - Empty",
render: () => (
<DialogStory
eyebrow="NewGoalDialog"
title="Empty goal form"
description="Default goal creation state with status, level, and parent-goal controls available."
badges={["empty", "goal", "parent picker"]}
>
<GoalDialogOpener />
</DialogStory>
),
};
export const NewGoalWithParent: Story = {
name: "New Goal - Parent Selected",
render: () => (
<DialogStory
eyebrow="NewGoalDialog"
title="Goal creation with parent context"
description="Populated goal creation state with a seeded title and company-level parent goal selected."
badges={["populated", "sub-goal", "parent selected"]}
>
<GoalDialogOpener populated />
</DialogStory>
),
};
export const NewProjectEmpty: Story = {
name: "New Project - Empty",
render: () => (
<DialogStory
eyebrow="NewProjectDialog"
title="Empty project form"
description="Default project creation state with description, goal, target date, and workspace fields empty."
badges={["empty", "project", "workspace"]}
>
<ProjectDialogOpener />
</DialogStory>
),
};
export const NewProjectWorkspaceConfig: Story = {
name: "New Project - Workspace Config",
render: () => (
<DialogStory
eyebrow="NewProjectDialog"
title="Project creation with workspace config"
description="Populated project creation state with repo URL, local folder path, and target date filled in."
badges={["populated", "repo URL", "local path"]}
>
<ProjectDialogOpener populated />
</DialogStory>
),
};
export const ExecutionWorkspaceCloseReady: Story = {
name: "Execution Workspace Close - Ready",
render: () => <ExecutionWorkspaceDialogStory />,
};
export const ExecutionWorkspaceCloseBlocked: Story = {
name: "Execution Workspace Close - Blocked",
render: () => <ExecutionWorkspaceDialogStory blocked />,
};
export const DocumentDiffOpen: Story = {
name: "Document Diff",
render: () => <DocumentDiffModalStory />,
};
export const ImageGalleryOpen: Story = {
name: "Image Gallery",
render: () => <ImageGalleryModalStory />,
};
export const PathInstructionsOpen: Story = {
name: "Path Instructions",
render: () => <PathInstructionsModalStory />,
};