Files
fusion/packages/dashboard/app/components/SetupProjectForm.tsx
gsxdsm b800f7d0df FN-7469: select newly created project directories
Project setup now targets folders immediately after they are created from the directory picker.

- Add an opt-in DirectoryPicker mode that selects the API-returned created folder path.
- Enable the mode for setup wizard and project setup forms while preserving other picker behavior.
- Clear wizard path errors on path changes and document the setup behavior.
- Cover created-folder selection and default-picker preservation with dashboard tests.

Files changed:
 .../fn-7469-select-created-project-directory.md    |   7 ++
 docs/dashboard-guide.md                            |   2 +
 docs/getting-started.md                            |   1 +
 .../dashboard/app/components/DirectoryPicker.tsx   |  16 +++-
 .../dashboard/app/components/SetupProjectForm.tsx  |   1 +
 .../dashboard/app/components/SetupWizardModal.tsx  |   3 +-
 .../components/__tests__/DirectoryPicker.test.tsx  | 101 +++++++++++++++++----
 .../components/__tests__/SetupProjectForm.test.tsx |  10 ++
 .../components/__tests__/SetupWizardModal.test.tsx |  43 ++++++++-
 9 files changed, 162 insertions(+), 22 deletions(-)

Fusion-Task-Id: FN-7469

Fusion-Task-Lineage: 1883262f-3fdf-4583-9bb0-e9435039e17d

Co-authored-by: Fusion (runfusion.ai) <noreply@runfusion.ai>
2026-07-03 21:45:20 -07:00

251 lines
8.7 KiB
TypeScript

import { useState, useCallback, useMemo } from "react";
import { useTranslation } from "react-i18next";
import { Check, Loader2 } from "lucide-react";
import { validateProjectPath, validateProjectName, suggestProjectName } from "../utils/projectDetection";
import type { ProjectCreateInput, NodeInfo } from "../api";
import { DirectoryPicker } from "./DirectoryPicker";
export interface SetupProjectFormProps {
/** Called when the form is submitted with valid data */
onSubmit: (input: ProjectCreateInput) => void;
/** Called when validation state changes */
onValidationChange?: (isValid: boolean) => void;
/** Existing projects for duplicate checking */
existingProjects?: { name: string; path: string }[];
/** Loading state while submitting */
isSubmitting?: boolean;
/** Optional default path value */
defaultPath?: string;
/** Available nodes for the node selector */
nodes?: NodeInfo[];
/** Currently selected node ID (for controlled/default state) */
selectedNodeId?: string;
}
/**
* SetupProjectForm - Manual project registration form
*
* Form for manually registering a new project with:
* - Node selector for runtime node selection
* - Directory picker for path selection (node-aware)
* - Name input with auto-suggestion
* - Isolation mode selector
* - Real-time validation
*/
export function SetupProjectForm({
onSubmit,
onValidationChange,
existingProjects = [],
isSubmitting = false,
defaultPath = "",
nodes = [],
selectedNodeId,
}: SetupProjectFormProps) {
const { t } = useTranslation("app");
const [path, setPath] = useState(defaultPath);
const [name, setName] = useState("");
const [isolationMode, setIsolationMode] = useState<"in-process" | "child-process">("in-process");
const [pathError, setPathError] = useState<string | null>(null);
const [nameError, setNameError] = useState<string | null>(null);
const [touched, setTouched] = useState({ path: false, name: false });
const [nodeId, setNodeId] = useState(selectedNodeId ?? "");
// Compute the local node ID from the nodes list
const localNodeId = useMemo(() => nodes.find((n) => n.type === "local")?.id, [nodes]);
// Validate path
const validatePath = useCallback((value: string) => {
const result = validateProjectPath(value);
setPathError(result.valid ? null : (result.error ?? null));
return result.valid;
}, []);
// Validate name
const validateNameField = useCallback((value: string) => {
const result = validateProjectName(value, existingProjects);
setNameError(result.valid ? null : (result.error ?? null));
return result.valid;
}, [existingProjects]);
// Auto-suggest name from path
const handlePathChange = useCallback((value: string) => {
setPath(value);
setTouched((prev) => ({ ...prev, path: true }));
const isValid = validatePath(value);
// Auto-suggest name if name is empty and path is valid
if (isValid && !name && value) {
const suggested = suggestProjectName(value);
if (suggested) {
setName(suggested);
}
}
}, [name, validatePath]);
const handleNameChange = useCallback((value: string) => {
setName(value);
setTouched((prev) => ({ ...prev, name: true }));
validateNameField(value);
}, [validateNameField]);
// Check overall form validity
const isFormValid = useMemo(() => {
const pathResult = validateProjectPath(path);
const nameResult = validateProjectName(name, existingProjects);
return pathResult.valid && nameResult.valid && !isSubmitting;
}, [path, name, existingProjects, isSubmitting]);
// Report validation state to parent
useMemo(() => {
onValidationChange?.(isFormValid);
}, [isFormValid, onValidationChange]);
const handleSubmit = useCallback((e: React.FormEvent) => {
e.preventDefault();
const isPathValid = validatePath(path);
const isNameValid = validateNameField(name);
if (isPathValid && isNameValid) {
onSubmit({
name,
path,
isolationMode,
nodeId: nodeId || undefined,
});
}
}, [path, name, isolationMode, nodeId, onSubmit, validatePath, validateNameField]);
return (
<form onSubmit={handleSubmit} className="setup-project-form">
{/* Node selector */}
<div className="form-group">
<div className="project-node-selector">
<span className="project-node-selector__label">{t("setup.runtimeNode", "Runtime Node")}</span>
<select
value={nodeId}
onChange={(e) => setNodeId(e.target.value)}
disabled={isSubmitting}
>
<option value="">{t("setup.localNode", "Local node")}</option>
{nodes.map((node) => (
<option key={node.id} value={node.id}>
{node.name} ({node.type})
</option>
))}
</select>
</div>
</div>
{/* Path input */}
<div className="form-group">
<label htmlFor="project-path">
{t("setup.directoryPath", "Directory Path")} <span className="required">*</span>
</label>
<DirectoryPicker
value={path}
onChange={handlePathChange}
nodeId={nodeId || undefined}
localNodeId={localNodeId}
selectCreatedDirectory
placeholder={t("setup.pathPlaceholder", "/path/to/your/project")}
/>
{pathError && touched.path && (
<div className="field-error">
<span>{pathError}</span>
</div>
)}
<div className="field-hint">
{t("setup.pathHint", "Enter the absolute path to your project directory")}
</div>
</div>
{/* Name input */}
<div className="form-group">
<label htmlFor="project-name">
{t("setup.projectName", "Project Name")} <span className="required">*</span>
</label>
<div className={`input-wrapper ${nameError && touched.name ? "error" : ""}`}>
<input
id="project-name"
type="text"
value={name}
onChange={(e) => handleNameChange(e.target.value)}
onBlur={() => {
setTouched((prev) => ({ ...prev, name: true }));
validateNameField(name);
}}
placeholder={t("setup.namePlaceholder", "my-project")}
disabled={isSubmitting}
/>
{name && !nameError && touched.name && (
<Check size={16} className="input-success-icon" />
)}
</div>
{nameError && touched.name && (
<div className="field-error">
<span>{nameError}</span>
</div>
)}
<div className="field-hint">
{t("setup.nameHint", "Use letters, numbers, hyphens, and underscores only")}
</div>
</div>
{/* Isolation mode */}
<div className="form-group">
<label>{t("setup.executionMode", "Execution Mode")}</label>
<div className="radio-group">
<label className={`radio-option ${isolationMode === "in-process" ? "selected" : ""}`}>
<input
type="radio"
name="isolation-mode"
value="in-process"
checked={isolationMode === "in-process"}
onChange={() => setIsolationMode("in-process")}
disabled={isSubmitting}
/>
<div className="radio-content">
<strong>{t("setup.inProcessLabel", "In-Process (Default)")}</strong>
<span>{t("setup.inProcessDesc", "Fast, low overhead. Tasks run in the main process.")}</span>
</div>
</label>
<label className={`radio-option ${isolationMode === "child-process" ? "selected" : ""}`}>
<input
type="radio"
name="isolation-mode"
value="child-process"
checked={isolationMode === "child-process"}
onChange={() => setIsolationMode("child-process")}
disabled={isSubmitting}
/>
<div className="radio-content">
<strong>{t("setup.childProcessLabel", "Child Process (Isolated)")}</strong>
<span>{t("setup.childProcessDesc", "Strong isolation. Tasks run in separate processes.")}</span>
</div>
</label>
</div>
</div>
{/* Submit button */}
<div className="form-actions">
<button
type="submit"
className="btn btn-primary"
disabled={!isFormValid || isSubmitting}
>
{isSubmitting ? (
<>
<Loader2 size={16} className="spin" />
{t("setup.creating", "Creating...")}
</>
) : (
t("setup.createProject", "Create Project")
)}
</button>
</div>
</form>
);
}