- Redesign GitHubImportModal layout with improved UI/UX\n- Add comprehensive tests covering all modal states\n- Update import modal documentation in README\n- Add CSS styling for polished modal appearance\n- Include changeset for patch release
459 lines
18 KiB
TypeScript
459 lines
18 KiB
TypeScript
import { useState, useEffect, useCallback, useRef } from "react";
|
|
import type { Task } from "@kb/core";
|
|
import { apiFetchGitHubIssues, apiImportGitHubIssue, fetchGitRemotes, type GitHubIssue, type GitRemote } from "../api";
|
|
import { Loader2 } from "lucide-react";
|
|
|
|
interface GitHubImportModalProps {
|
|
isOpen: boolean;
|
|
onClose: () => void;
|
|
onImport: (task: Task) => void;
|
|
tasks: Task[];
|
|
}
|
|
|
|
export function GitHubImportModal({ isOpen, onClose, onImport, tasks }: GitHubImportModalProps) {
|
|
const [owner, setOwner] = useState("");
|
|
const [repo, setRepo] = useState("");
|
|
const [labels, setLabels] = useState("");
|
|
const [loading, setLoading] = useState(false);
|
|
const [issues, setIssues] = useState<GitHubIssue[]>([]);
|
|
const [selectedIssueNumber, setSelectedIssueNumber] = useState<number | null>(null);
|
|
const [error, setError] = useState<string | null>(null);
|
|
const [importing, setImporting] = useState(false);
|
|
|
|
// Git remotes state
|
|
const [remotes, setRemotes] = useState<GitRemote[]>([]);
|
|
const [loadingRemotes, setLoadingRemotes] = useState(false);
|
|
const [selectedRemoteName, setSelectedRemoteName] = useState<string>("");
|
|
const mountedRef = useRef(false);
|
|
|
|
// Build set of already imported URLs from existing tasks
|
|
const importedUrls = new Set<string>();
|
|
for (const task of tasks) {
|
|
const match = task.description.match(/Source: (https:\/\/github\.com\/[^/]+\/[^/]+\/issues\/\d+)/);
|
|
if (match) {
|
|
importedUrls.add(match[1]);
|
|
}
|
|
}
|
|
|
|
// Reset state when modal opens and fetch remotes
|
|
useEffect(() => {
|
|
if (isOpen) {
|
|
setOwner("");
|
|
setRepo("");
|
|
setLabels("");
|
|
setIssues([]);
|
|
setSelectedIssueNumber(null);
|
|
setError(null);
|
|
setImporting(false);
|
|
setRemotes([]);
|
|
setLoadingRemotes(true);
|
|
setSelectedRemoteName("");
|
|
|
|
mountedRef.current = true;
|
|
|
|
// Fetch git remotes
|
|
fetchGitRemotes()
|
|
.then((fetchedRemotes) => {
|
|
if (!mountedRef.current) return;
|
|
|
|
setRemotes(fetchedRemotes);
|
|
setLoadingRemotes(false);
|
|
|
|
if (fetchedRemotes.length === 1) {
|
|
// Single remote: auto-select it
|
|
const remote = fetchedRemotes[0];
|
|
setOwner(remote.owner);
|
|
setRepo(remote.repo);
|
|
setSelectedRemoteName(remote.name);
|
|
} else if (fetchedRemotes.length > 1) {
|
|
// Multiple remotes: don't auto-select, user must choose
|
|
setOwner("");
|
|
setRepo("");
|
|
setSelectedRemoteName("");
|
|
}
|
|
// If no remotes, owner/repo remain empty
|
|
})
|
|
.catch(() => {
|
|
if (mountedRef.current) {
|
|
setLoadingRemotes(false);
|
|
}
|
|
});
|
|
|
|
return () => {
|
|
mountedRef.current = false;
|
|
};
|
|
}
|
|
}, [isOpen]);
|
|
|
|
// Handle remote selection change
|
|
const handleRemoteChange = useCallback((remoteName: string) => {
|
|
setSelectedRemoteName(remoteName);
|
|
if (remoteName === "") {
|
|
setOwner("");
|
|
setRepo("");
|
|
} else {
|
|
const remote = remotes.find((r) => r.name === remoteName);
|
|
if (remote) {
|
|
setOwner(remote.owner);
|
|
setRepo(remote.repo);
|
|
}
|
|
}
|
|
}, [remotes]);
|
|
|
|
// Handle escape key
|
|
useEffect(() => {
|
|
if (!isOpen) return;
|
|
const handleKey = (e: KeyboardEvent) => {
|
|
if (e.key === "Escape") onClose();
|
|
};
|
|
document.addEventListener("keydown", handleKey);
|
|
return () => document.removeEventListener("keydown", handleKey);
|
|
}, [isOpen, onClose]);
|
|
|
|
const handleLoad = useCallback(async () => {
|
|
if (!owner.trim() || !repo.trim()) {
|
|
setError("Repository must be selected");
|
|
return;
|
|
}
|
|
|
|
setLoading(true);
|
|
setError(null);
|
|
setIssues([]);
|
|
setSelectedIssueNumber(null);
|
|
|
|
try {
|
|
const labelArray = labels
|
|
.split(",")
|
|
.map((l) => l.trim())
|
|
.filter(Boolean);
|
|
const fetchedIssues = await apiFetchGitHubIssues(owner.trim(), repo.trim(), 30, labelArray.length > 0 ? labelArray : undefined);
|
|
setIssues(fetchedIssues);
|
|
if (fetchedIssues.length === 0) {
|
|
setError("No open issues found");
|
|
}
|
|
} catch (err: any) {
|
|
setError(err.message || "Failed to fetch issues");
|
|
} finally {
|
|
setLoading(false);
|
|
}
|
|
}, [owner, repo, labels]);
|
|
|
|
const handleImport = useCallback(async () => {
|
|
if (selectedIssueNumber === null) return;
|
|
|
|
setImporting(true);
|
|
setError(null);
|
|
|
|
try {
|
|
const task = await apiImportGitHubIssue(owner.trim(), repo.trim(), selectedIssueNumber);
|
|
onImport(task);
|
|
onClose();
|
|
} catch (err: any) {
|
|
if (err.message?.includes("already imported")) {
|
|
setError(err.message);
|
|
} else {
|
|
setError(err.message || "Failed to import issue");
|
|
}
|
|
} finally {
|
|
setImporting(false);
|
|
}
|
|
}, [selectedIssueNumber, owner, repo, onImport, onClose]);
|
|
|
|
const selectedIssue = issues.find((i) => i.number === selectedIssueNumber);
|
|
|
|
if (!isOpen) return null;
|
|
|
|
// Determine the repository selection UI state
|
|
const hasRemotes = remotes.length > 0;
|
|
const singleRemote = remotes.length === 1;
|
|
const multipleRemotes = remotes.length > 1;
|
|
const repositoryName = owner.trim() && repo.trim() ? `${owner.trim()}/${repo.trim()}` : "No repository selected";
|
|
const importedIssueCount = issues.filter((issue) => importedUrls.has(issue.html_url)).length;
|
|
const isEmptyState = error === "No open issues found";
|
|
const isResultsError = Boolean(error) && !isEmptyState && issues.length === 0 && !loading;
|
|
const hasResultsContent = loading || issues.length > 0 || isEmptyState || isResultsError;
|
|
const showInlineErrorBanner = Boolean(error) && issues.length > 0 && !isEmptyState;
|
|
|
|
return (
|
|
<div className="modal-overlay open" onClick={(e) => e.target === e.currentTarget && onClose()}>
|
|
<div className="modal modal-lg github-import-modal">
|
|
<div className="modal-header github-import-modal__header">
|
|
<div>
|
|
<h3>Import from GitHub</h3>
|
|
<p className="github-import-modal__subtitle">
|
|
Choose a detected remote, load open issues, and import one into the board.
|
|
</p>
|
|
</div>
|
|
<button className="modal-close" onClick={onClose} aria-label="Close import modal">
|
|
×
|
|
</button>
|
|
</div>
|
|
|
|
<div className="modal-body github-import-modal__body">
|
|
<section className="github-import-section" aria-labelledby="github-import-source-heading">
|
|
<div className="github-import-section__header">
|
|
<div>
|
|
<h4 id="github-import-source-heading">Repository source</h4>
|
|
<p className="github-import-section__helper">
|
|
kb reads Git remotes from your current repository so you can load issues without typing owner/repo by hand.
|
|
</p>
|
|
</div>
|
|
<div className="github-import-repository-pill" aria-live="polite">
|
|
<span className="github-import-repository-pill__label">Repository</span>
|
|
<span className="github-import-repository-pill__value">{repositoryName}</span>
|
|
</div>
|
|
</div>
|
|
|
|
{loadingRemotes && (
|
|
<div className="github-import-state github-import-state--loading" role="status" aria-live="polite">
|
|
<Loader2 size={16} className="spin" />
|
|
<div>
|
|
<strong>Detecting Git remotes…</strong>
|
|
<span>Scanning this worktree for GitHub remotes.</span>
|
|
</div>
|
|
</div>
|
|
)}
|
|
|
|
{!loadingRemotes && !hasRemotes && (
|
|
<div className="github-import-state github-import-state--warning" role="alert">
|
|
<div>
|
|
<strong>No GitHub remotes detected</strong>
|
|
<span>Add a GitHub remote to this repository, then reopen the modal.</span>
|
|
</div>
|
|
<code className="github-import-command">
|
|
git remote add origin https://github.com/owner/repo.git
|
|
</code>
|
|
</div>
|
|
)}
|
|
|
|
{!loadingRemotes && singleRemote && (
|
|
<div className="github-import-remote-card" data-testid="github-import-single-remote">
|
|
<div>
|
|
<div className="github-import-remote-card__eyebrow">Auto-detected remote</div>
|
|
<div className="github-import-remote-card__title">
|
|
{remotes[0].name} <span>{remotes[0].owner}/{remotes[0].repo}</span>
|
|
</div>
|
|
</div>
|
|
<span className="github-import-badge">Ready</span>
|
|
</div>
|
|
)}
|
|
|
|
{!loadingRemotes && multipleRemotes && (
|
|
<div className="github-import-controls-grid">
|
|
<div className="form-group github-import-form-group github-import-form-group--remote">
|
|
<label htmlFor="gh-remote">Repository</label>
|
|
<select
|
|
id="gh-remote"
|
|
value={selectedRemoteName}
|
|
onChange={(e) => handleRemoteChange(e.target.value)}
|
|
disabled={loading || importing}
|
|
>
|
|
<option value="">Select a remote...</option>
|
|
{remotes.map((remote) => (
|
|
<option key={remote.name} value={remote.name}>
|
|
{remote.name} ({remote.owner}/{remote.repo})
|
|
</option>
|
|
))}
|
|
</select>
|
|
<small>Pick which remote to query when more than one GitHub origin is available.</small>
|
|
</div>
|
|
</div>
|
|
)}
|
|
</section>
|
|
|
|
<section className="github-import-section" aria-labelledby="github-import-filters-heading">
|
|
<div className="github-import-section__header">
|
|
<div>
|
|
<h4 id="github-import-filters-heading">Filters & sync</h4>
|
|
<p className="github-import-section__helper">
|
|
Narrow the issue list with labels, then fetch up to 30 open issues from the selected repository.
|
|
</p>
|
|
</div>
|
|
</div>
|
|
|
|
<div className="github-import-controls-grid">
|
|
<div className="form-group github-import-form-group">
|
|
<label htmlFor="gh-labels">Labels (optional)</label>
|
|
<input
|
|
id="gh-labels"
|
|
type="text"
|
|
placeholder="bug,enhancement"
|
|
value={labels}
|
|
onChange={(e) => setLabels(e.target.value)}
|
|
onKeyDown={(e) => e.key === "Enter" && handleLoad()}
|
|
disabled={loading || importing}
|
|
/>
|
|
<small>Use comma-separated labels to filter the GitHub issue query.</small>
|
|
</div>
|
|
|
|
<div className="form-group github-import-form-group github-import-form-group--action">
|
|
<label htmlFor="gh-load">Load issues</label>
|
|
<button
|
|
id="gh-load"
|
|
className="btn btn-primary github-import-load-button"
|
|
onClick={handleLoad}
|
|
disabled={loading || importing || !owner.trim() || !repo.trim()}
|
|
>
|
|
{loading ? <Loader2 size={14} className="spin" /> : "Load"}
|
|
</button>
|
|
<small>Load issues from the selected repository without changing any board data.</small>
|
|
</div>
|
|
</div>
|
|
</section>
|
|
|
|
{showInlineErrorBanner && (
|
|
<div className="form-error github-import-banner" role="alert">
|
|
{error}
|
|
</div>
|
|
)}
|
|
|
|
<div className="github-import-workspace">
|
|
<section
|
|
className="github-import-section github-import-section--results"
|
|
aria-labelledby="github-import-results-heading"
|
|
>
|
|
<div className="github-import-section__header">
|
|
<div>
|
|
<h4 id="github-import-results-heading">Results</h4>
|
|
<p className="github-import-section__helper">
|
|
Imported issues stay visible but cannot be selected again.
|
|
</p>
|
|
</div>
|
|
{issues.length > 0 && (
|
|
<div className="github-import-results-meta" aria-live="polite">
|
|
<span>{issues.length} issue{issues.length === 1 ? "" : "s"}</span>
|
|
<span>{importedIssueCount} imported</span>
|
|
</div>
|
|
)}
|
|
</div>
|
|
|
|
{!hasResultsContent && (
|
|
<div className="github-import-state github-import-state--idle" data-testid="github-import-results-idle">
|
|
<div>
|
|
<strong>Nothing loaded yet</strong>
|
|
<span>Select a repository and load issues to start reviewing import candidates.</span>
|
|
</div>
|
|
</div>
|
|
)}
|
|
|
|
{loading && (
|
|
<div className="github-import-state github-import-state--loading" role="status" aria-live="polite">
|
|
<Loader2 size={16} className="spin" />
|
|
<div>
|
|
<strong>Loading open issues…</strong>
|
|
<span>Fetching the latest issue list from GitHub.</span>
|
|
</div>
|
|
</div>
|
|
)}
|
|
|
|
{isResultsError && (
|
|
<div className="github-import-state github-import-state--error" role="alert">
|
|
<div>
|
|
<strong>Could not load issues</strong>
|
|
<span>{error}</span>
|
|
</div>
|
|
</div>
|
|
)}
|
|
|
|
{isEmptyState && (
|
|
<div className="github-import-state github-import-state--empty" role="status">
|
|
<div>
|
|
<strong>No open issues found</strong>
|
|
<span>Try a different label filter or choose another repository.</span>
|
|
</div>
|
|
</div>
|
|
)}
|
|
|
|
{issues.length > 0 && (
|
|
<div className="issues-list" aria-live="polite">
|
|
{issues.map((issue) => {
|
|
const isImported = importedUrls.has(issue.html_url);
|
|
return (
|
|
<div
|
|
key={issue.number}
|
|
className={`issue-item ${selectedIssueNumber === issue.number ? "selected" : ""} ${isImported ? "imported" : ""}`}
|
|
onClick={() => !isImported && setSelectedIssueNumber(issue.number)}
|
|
>
|
|
<input
|
|
type="radio"
|
|
name="issue"
|
|
checked={selectedIssueNumber === issue.number}
|
|
onChange={() => setSelectedIssueNumber(issue.number)}
|
|
disabled={isImported}
|
|
aria-label={`Select issue #${issue.number}`}
|
|
/>
|
|
<div className="issue-main">
|
|
<div className="issue-heading-row">
|
|
<span className="issue-number">#{issue.number}</span>
|
|
<span className="issue-title">{issue.title}</span>
|
|
</div>
|
|
{issue.labels.length > 0 && (
|
|
<span className="issue-labels">
|
|
{issue.labels.map((l) => (
|
|
<span key={l.name} className="label-chip">
|
|
{l.name}
|
|
</span>
|
|
))}
|
|
</span>
|
|
)}
|
|
</div>
|
|
{isImported && <span className="imported-badge">Imported</span>}
|
|
</div>
|
|
);
|
|
})}
|
|
</div>
|
|
)}
|
|
</section>
|
|
|
|
<section
|
|
className="github-import-section github-import-section--preview"
|
|
aria-labelledby="github-import-preview-heading"
|
|
>
|
|
<div className="github-import-section__header">
|
|
<div>
|
|
<h4 id="github-import-preview-heading">Preview</h4>
|
|
<p className="github-import-section__helper">
|
|
Review the selected issue before importing it as a task.
|
|
</p>
|
|
</div>
|
|
</div>
|
|
|
|
{selectedIssue ? (
|
|
<div className="issue-preview" data-testid="github-import-preview-card">
|
|
<div className="preview-meta">Issue #{selectedIssue.number}</div>
|
|
<div className="preview-title">{selectedIssue.title}</div>
|
|
<div className="preview-body">
|
|
{selectedIssue.body
|
|
? selectedIssue.body.slice(0, 200) + (selectedIssue.body.length > 200 ? "…" : "")
|
|
: "(no description)"}
|
|
</div>
|
|
</div>
|
|
) : (
|
|
<div className="github-import-state github-import-state--idle" data-testid="github-import-preview-empty">
|
|
<div>
|
|
<strong>No issue selected</strong>
|
|
<span>Choose an issue from the results list to inspect its title and description.</span>
|
|
</div>
|
|
</div>
|
|
)}
|
|
</section>
|
|
</div>
|
|
</div>
|
|
|
|
<div className="modal-actions github-import-modal__actions">
|
|
<button className="btn" onClick={onClose} disabled={importing}>
|
|
Cancel
|
|
</button>
|
|
<button
|
|
className="btn btn-primary"
|
|
onClick={handleImport}
|
|
disabled={selectedIssueNumber === null || importing}
|
|
>
|
|
{importing ? <Loader2 size={14} className="spin" /> : "Import"}
|
|
</button>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
);
|
|
}
|