create-gtkx 2.0.0-beta.1 → 2.0.0-beta.11

package/dist/scaffolder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scaffolder.d.ts","sourceRoot":"","sources":["../src/scaffolder.ts"],"names":[],"mappings":"AAsBA,KAAK,aAAa,GAAG;IACjB,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,YAAY,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACnC,oBAAoB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC3C,aAAa,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACpC,eAAe,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACzC,CAAC;AAkjBF,QAAA,MAAM,QAAQ,GAAU,UAAS,aAAkB,KAAG,OAAO,CAAC,IAAI,CAcjE,CAAC;AAEF,OAAO,EAAE,QAAQ,EAAE,CAAC"}
+{"version":3,"file":"scaffolder.d.ts","sourceRoot":"","sources":["../src/scaffolder.ts"],"names":[],"mappings":"AAqBA,KAAK,aAAa,GAAG;IACjB,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,YAAY,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACnC,oBAAoB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC3C,aAAa,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACpC,eAAe,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACtC,yBAAyB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACnD,CAAC;AA8qBF,QAAA,MAAM,QAAQ,GAAU,UAAS,aAAkB,KAAG,OAAO,CAAC,IAAI,CAkBjE,CAAC;AAEF,OAAO,EAAE,QAAQ,EAAE,CAAC"}

package/dist/scaffolder.js

@@ -2,29 +2,26 @@ import * as p from "@clack/prompts";
 import { APPLICATION_ID_MAX_LENGTH, isValidApplicationId } from "@gtkx/config/internal";
 import { errorMessage, tryResolveExecutable, upperFirst } from "@gtkx/utils";
 import { execFileSync } from "node:child_process";
-import { mkdirSync, readdirSync, rmSync, statSync, writeFileSync } from "node:fs";
-import { basename, dirname, join, resolve } from "node:path";
+import { lstatSync, mkdirSync, readdirSync, rmSync, statSync, writeFileSync } from "node:fs";
+import { basename, dirname, join, relative, resolve, sep } from "node:path";
 import { addDependency, detectPackageManager as nypmDetectPackageManager } from "nypm";
 import { x } from "tinyexec";
 import packageManifest from "../package.json" with { type: "json" };
 import { writeBuildAllowance } from "./build-allowance.js";
 import { OperationCanceledError, ScaffoldAbortedError } from "./errors.js";
-import { getInstallHint } from "./install-hints.js";
 import { updateManifest } from "./manifest.js";
 import { isKnownPackageManager, PACKAGE_MANAGER_VALUES, PACKAGE_MANAGERS, } from "./package-managers.js";
 import { isValidProjectName } from "./project-name.js";
 import { listTemplates, renderFile } from "./templates.js";
 const selfVersion = packageManifest.version;
 const ICON_TEMPLATE_NAME = "icon.svg";
-const GTKX_ENV_MODULE_HEADER = `/**
- * Generated by \`gtkx codegen\`, \`gtkx dev\`, and \`gtkx build\`; do not edit.
- */`;
+const TYPESCRIPT_VERSION = "^6.0.3";
 const DEPENDENCIES = ["@gtkx/cairo", "@gtkx/css", "@gtkx/runtime", "@gtkx/react", "react"];
 const DEV_DEPENDENCIES = ["@gtkx/cli", "@gtkx/config", "@gtkx/mcp", "vite"];
 const TYPESCRIPT_DEV_DEPENDENCIES = ["@types/node", "@types/react", "typescript"];
 const TESTING_DEV_DEPENDENCIES = ["@gtkx/testing", "vitest"];
 const DEV_COMMAND = Object.fromEntries(PACKAGE_MANAGERS.map((manager) => [manager.value, manager.devCommand]));
-const ADD_COMMAND = Object.fromEntries(PACKAGE_MANAGERS.map((manager) => [manager.value, manager.addCommand]));
+const INSTALL_COMMAND = Object.fromEntries(PACKAGE_MANAGERS.map((manager) => [manager.value, manager.installCommand]));
 const INHERITED_SCRIPT_POLICY_VARS = ["npm_config_allow_scripts", "npm_config_allow-scripts"];
 const TESTING_TEMPLATES = new Set(["vitest.config.ts", "tests/app.test.tsx"]);
 const TYPESCRIPT_TEMPLATES = new Set(["tsconfig.json", "src/gtkx-env.d.ts"]);
@@ -33,13 +30,12 @@ const HEADLESS_COMPOSITOR_NOTE = `
 To run tests, you need a headless Wayland compositor installed:
   Fedora: sudo dnf install sway
   Ubuntu: sudo apt install sway`;
-const RECOVERY_HEADING = "Finish the setup by adding the dependencies again, which is safe to repeat:";
 const APPLICATION_ID_FORMAT_ERROR = "Application ID must be reverse domain notation (e.g., com.example.myapp)";
 const APPLICATION_ID_PREFIX = "com.";
 const APPLICATION_ID_SUFFIX = ".app";
 const APPLICATION_ID_SEGMENT_LIMIT = APPLICATION_ID_MAX_LENGTH - APPLICATION_ID_PREFIX.length -
     APPLICATION_ID_SUFFIX.length;
-const titleFromName = (name) => name.split("-").map((part) => upperFirst(part)).join(" ");
+const displayNameFromProjectName = (name) => name.split("-").map((part) => upperFirst(part)).join(" ");
 const gitConfigValue = (key) => {
     const git = tryResolveExecutable("git");
     if (git === undefined) {
@@ -58,19 +54,15 @@ const applicationIdSegment = (name) => {
     return segment.slice(0, APPLICATION_ID_SEGMENT_LIMIT);
 };
 const suggestApplicationId = (name) => `${APPLICATION_ID_PREFIX}${applicationIdSegment(name)}${APPLICATION_ID_SUFFIX}`;
-const stripTrailingSlashes = (value) => {
-    let end = value.length;
-    while (end > 0 && value[end - 1] === "/") {
-        end--;
-    }
-    return value.slice(0, end);
-};
-const formatTargetDir = (target) => stripTrailingSlashes(target.trim().replaceAll(/[<>:"\\|?*]/g, ""));
 const deriveProjectName = (target) => basename(resolve(process.cwd(), target));
 const isDirEmpty = (dir) => {
     const entries = readdirSync(dir);
     return entries.length === 0 || (entries.length === 1 && entries[0] === ".git");
 };
+const shouldInitializeGit = (root) => {
+    const entry = lstatSync(root, { throwIfNoEntry: false });
+    return entry === undefined || (entry.isDirectory() && readdirSync(root).length === 0);
+};
 const getDevDependencies = ({ isTypescript, shouldIncludeTesting, }) => {
     const devDeps = [...DEV_DEPENDENCIES];
     if (isTypescript) {
@@ -81,8 +73,9 @@ const getDevDependencies = ({ isTypescript, shouldIncludeTesting, }) => {
     }
     return devDeps;
 };
+const isCancellation = (value) => p.isCancel(value);
 const guardCancellation = (value) => {
-    if (p.isCancel(value)) {
+    if (isCancellation(value)) {
         p.cancel("Operation canceled");
         throw new OperationCanceledError();
     }
@@ -100,6 +93,13 @@ const validateProjectName = (value) => {
 const validateApplicationIdFormat = (value) => isValidApplicationId(value) ? undefined : APPLICATION_ID_FORMAT_ERROR;
 const validateApplicationIdInput = (value) => value ? validateApplicationIdFormat(value) : "Application ID is required";
 const validateApplicationIdAnswer = (value) => value ? validateApplicationIdFormat(value) : undefined;
+const validateDisplayName = (value) => {
+    if (value === undefined || value.trim().length === 0) {
+        return "Display name is required";
+    }
+    return value.includes("\n") || value.includes("\r") ? "Display name must be a single line" : undefined;
+};
+const validateDisplayNameAnswer = (value) => value ? validateDisplayName(value) : undefined;
 const fail = (message) => {
     p.log.error(message);
     throw new ScaffoldAbortedError(message);
@@ -119,12 +119,12 @@ const validateTargetDir = (target) => {
     }
     return validateProjectName(deriveProjectName(target));
 };
-const validateTargetAnswer = (value) => validateTargetDir(formatTargetDir(value ?? ""));
-const promptTarget = async () => formatTargetDir(guardCancellation(await p.text({
+const validateTargetAnswer = (value) => validateTargetDir(value ?? "");
+const promptTarget = async () => guardCancellation(await p.text({
     message: "Project directory",
     placeholder: "my-app",
     validate: validateTargetAnswer,
-})));
+}));
 const promptApplicationId = async (name) => {
     const defaultApplicationId = suggestApplicationId(name);
     return guardCancellation(await p.text({
@@ -134,6 +134,15 @@ const promptApplicationId = async (name) => {
         validate: validateApplicationIdAnswer,
     }));
 };
+const promptDisplayName = async (name) => {
+    const defaultDisplayName = displayNameFromProjectName(name);
+    return guardCancellation(await p.text({
+        message: "Display name",
+        placeholder: defaultDisplayName,
+        defaultValue: defaultDisplayName,
+        validate: validateDisplayNameAnswer,
+    }));
+};
 const packageManagerOption = (manager, detected) => {
     let hint;
     if (detected === manager.value) {
@@ -162,48 +171,69 @@ const promptPackageManager = async () => {
         initialValue: initial,
     }));
 };
-const isOptionEnabled = async (value, isInteractive, message) => value ??
-    (isInteractive
-        ? guardCancellation(await p.confirm({ message, initialValue: true }))
-        : true);
-const emptyDir = (root) => {
-    for (const entry of readdirSync(root)) {
-        if (entry === ".git") {
-            continue;
-        }
-        rmSync(join(root, entry), { recursive: true, force: true });
+const isOptionEnabled = async (value, isInteractive, message) => value ?? (!isInteractive || guardCancellation(await p.confirm({ message, initialValue: true })));
+const formatFileList = (heading, files) => {
+    const indentedFiles = files.map((file) => `  ${file}`).join("\n");
+    return `${heading}:\n${indentedFiles}`;
+};
+const reportPlannedChanges = (changes) => {
+    if (changes.length > 0) {
+        p.log.info(formatFileList("Scaffold files to replace", changes));
     }
 };
-const shouldOverwriteDirectory = async (target, options) => {
-    if (!options.isInteractive) {
-        return options.shouldOverwrite === true;
+const reportCompletedChanges = (changes) => {
+    if (changes.length > 0) {
+        p.log.success(formatFileList("Replaced scaffold files", changes));
     }
-    return guardCancellation(await p.confirm({
-        message: `Directory "${target}" is not empty. Overwrite its contents?`,
+};
+const confirmOverwrite = async (target, changes) => {
+    reportPlannedChanges(changes);
+    const shouldReplace = guardCancellation(await p.confirm({
+        message: `Directory "${target}" is not empty. Replace scaffold files?`,
         initialValue: false,
     }));
+    if (!shouldReplace) {
+        fail(`Directory "${target}" is not empty`);
+    }
 };
-const shouldEmptyTargetDirectory = async (root, target, options) => {
-    const stats = statSync(root, { throwIfNoEntry: false });
-    if (stats === undefined) {
-        return false;
+const refuseNonEmptyDirectory = (target, changes) => {
+    const heading = `Directory "${target}" is not empty. Pass --overwrite to`;
+    return fail(changes.length === 0
+        ? `${heading} scaffold into it`
+        : formatFileList(`${heading} replace these scaffold files`, changes));
+};
+const acceptNonEmptyDirectory = async (target, options, changes) => {
+    if (options.isInteractive) {
+        await confirmOverwrite(target, changes);
+        return;
     }
-    if (!stats.isDirectory()) {
-        return fail(`Target "${target}" is not a directory`);
+    if (options.shouldOverwrite === true) {
+        reportPlannedChanges(changes);
+        return;
     }
-    if (isDirEmpty(root)) {
-        return false;
+    refuseNonEmptyDirectory(target, changes);
+};
+const assertTargetIsDirectory = (root, target) => {
+    const stats = lstatSync(root, { throwIfNoEntry: false });
+    if (stats?.isSymbolicLink()) {
+        fail(`Cannot scaffold through a symbolic link: ${root}`);
     }
-    if (await shouldOverwriteDirectory(target, options)) {
-        return true;
+    if (stats !== undefined && !stats.isDirectory()) {
+        fail(`Target "${target}" is not a directory`);
     }
-    return fail(`Directory "${target}" is not empty`);
+};
+const validateTargetAvailability = async (root, target, options, changes) => {
+    const stats = statSync(root, { throwIfNoEntry: false });
+    if (stats === undefined || isDirEmpty(root)) {
+        return;
+    }
+    await acceptNonEmptyDirectory(target, options, changes);
 };
 const resolveTarget = async (options) => {
     if (options.name === undefined && options.isInteractive) {
         return promptTarget();
     }
-    const target = formatTargetDir(options.name ?? "");
+    const target = options.name ?? "";
     const error = validateTargetDir(target);
     return error === undefined ? target : fail(error);
 };
@@ -213,6 +243,12 @@ const resolveApplicationId = async (options, name) => {
     const error = validateApplicationIdInput(applicationId);
     return error === undefined ? applicationId : fail(error);
 };
+const resolveDisplayName = async (options, name) => {
+    const value = options.displayName ??
+        (options.isInteractive ? await promptDisplayName(name) : displayNameFromProjectName(name));
+    const error = validateDisplayName(value);
+    return error === undefined ? value.trim() : fail(error);
+};
 const resolvePackageManager = async (requested, options) => {
     if (requested !== undefined) {
         return requested;
@@ -226,23 +262,24 @@ const resolveOptions = async (options) => {
     const requested = requestedPackageManager(options.packageManager);
     const target = await resolveTarget(options);
     const name = deriveProjectName(target);
+    const displayName = await resolveDisplayName(options, name);
     const applicationId = await resolveApplicationId(options, name);
     const root = resolve(process.cwd(), target);
-    const isCurrentDirectory = root === process.cwd();
-    const shouldEmptyTarget = await shouldEmptyTargetDirectory(root, target, options);
+    const shouldInitialize = shouldInitializeGit(root);
     const packageManager = await resolvePackageManager(requested, options);
     const isTypescript = await isOptionEnabled(options.isTypescript, options.isInteractive, "Use TypeScript?");
     const shouldIncludeTesting = await isOptionEnabled(options.shouldIncludeTesting, options.isInteractive, "Include testing setup (Vitest)?");
     return {
         target,
         root,
-        isCurrentDirectory,
         name,
+        displayName,
         applicationId,
         packageManager,
         isTypescript,
         shouldIncludeTesting,
-        shouldEmptyTarget,
+        shouldInitializeGit: shouldInitialize,
+        shouldInstallDependencies: options.shouldInstallDependencies !== false,
     };
 };
 const isTemplateIncluded = (templateRelativePath, resolved) => {
@@ -263,27 +300,74 @@ const destinationPath = (template, resolved) => {
 const templateContext = (resolved) => ({
     name: resolved.name,
     applicationId: resolved.applicationId,
-    title: titleFromName(resolved.name),
+    displayName: resolved.displayName,
     shouldIncludeTesting: resolved.shouldIncludeTesting,
     isTypescript: resolved.isTypescript,
     importExtension: resolved.isTypescript ? ".js" : ".jsx",
-    developerName: gitConfigValue("user.name") ?? titleFromName(resolved.name),
+    developerName: gitConfigValue("user.name") ?? resolved.displayName,
     developerEmail: gitConfigValue("user.email"),
 });
-const scaffoldProject = async (root, resolved) => {
+const assertSafeAncestor = (ancestor) => {
+    const entry = lstatSync(ancestor, { throwIfNoEntry: false });
+    if (entry?.isSymbolicLink()) {
+        fail(`Cannot scaffold through a symbolic link: ${ancestor}`);
+    }
+    if (entry !== undefined && !entry.isDirectory()) {
+        fail(`Cannot scaffold through a non-directory path: ${ancestor}`);
+    }
+};
+const assertSafeAncestors = (root, relativePath) => {
+    let ancestor = root;
+    const segments = relativePath.split(sep);
+    const ancestorSegments = segments.slice(0, -1);
+    for (const segment of ancestorSegments) {
+        ancestor = join(ancestor, segment);
+        assertSafeAncestor(ancestor);
+    }
+};
+const hasReplaceableDestination = (destination) => {
+    const entry = lstatSync(destination, { throwIfNoEntry: false });
+    const isReplaceable = entry === undefined || entry.isFile() || entry.isSymbolicLink();
+    if (!isReplaceable) {
+        fail(`Cannot replace scaffold file because its destination is not a file: ${destination}`);
+    }
+    return entry !== undefined;
+};
+const hasExistingDestination = (root, destination) => {
+    assertSafeAncestors(root, relative(root, destination));
+    return hasReplaceableDestination(destination);
+};
+const plannedScaffoldFiles = async (root, resolved) => {
     const context = templateContext(resolved);
+    const files = [];
     for (const template of listTemplates()) {
-        if (!isTemplateIncluded(template, resolved)) {
-            continue;
+        if (isTemplateIncluded(template, resolved)) {
+            files.push({
+                destination: join(root, destinationPath(template, resolved)),
+                contents: await renderFile(template, context),
+            });
         }
-        const destination = join(root, destinationPath(template, resolved));
-        mkdirSync(dirname(destination), { recursive: true });
-        writeFileSync(destination, await renderFile(template, context));
     }
-    if (resolved.shouldIncludeTesting) {
-        updateManifest(root, (manifest) => {
-            manifest.scripts.test = "vitest run";
-        });
+    return files;
+};
+const auxiliaryDestinations = (root, resolved) => resolved.packageManager === "pnpm" ? [join(root, "pnpm-workspace.yaml")] : [];
+const planScaffoldProject = async (root, resolved) => {
+    const files = await plannedScaffoldFiles(root, resolved);
+    const destinations = [...files.map((file) => file.destination), ...auxiliaryDestinations(root, resolved)];
+    const replaceDestinations = destinations.filter((destination) => hasExistingDestination(root, destination));
+    return {
+        files,
+        replaceDestinations,
+        changes: replaceDestinations.map((destination) => relative(root, destination)),
+    };
+};
+const scaffoldProject = (plan) => {
+    for (const destination of plan.replaceDestinations) {
+        rmSync(destination);
+    }
+    for (const file of plan.files) {
+        mkdirSync(dirname(file.destination), { recursive: true });
+        writeFileSync(file.destination, file.contents);
     }
 };
 const withoutInheritedScriptPolicy = async (run) => {
@@ -302,30 +386,20 @@ const withoutInheritedScriptPolicy = async (run) => {
         }
     }
 };
-const installDependencies = async (options) => {
-    const { cwd, packageManager, dependencies, isDev } = options;
-    await withoutInheritedScriptPolicy(async () => {
-        await addDependency(dependencies, { cwd, packageManager, dev: isDev, silent: true });
-    });
-};
-const pin = (names) => names.map((dependency) => dependency.startsWith("@gtkx/") ? `${dependency}@^${selfVersion}` : dependency);
-const formatRecovery = ({ resolved, devDependencies }) => {
-    const add = ADD_COMMAND[resolved.packageManager];
-    const steps = [
-        ...(resolved.isCurrentDirectory ? [] : [`cd ${resolved.target}`]),
-        `${add} ${pin(DEPENDENCIES).join(" ")}`,
-        `${add} -D ${pin(devDependencies).join(" ")}`,
-    ];
-    const indented = steps.map((step) => `  ${step}`).join("\n");
-    return `${RECOVERY_HEADING}\n${indented}`;
-};
-const explainInstallFailure = (options) => {
-    const hint = getInstallHint(errorMessage(options.error));
-    if (hint !== undefined) {
-        p.log.warn(hint);
+const dependencyVersions = (names) => Object.fromEntries(names.map((dependency) => {
+    if (dependency.startsWith("@gtkx/")) {
+        return [dependency, `^${selfVersion}`];
     }
-    p.log.info(formatRecovery(options));
+    return [dependency, dependency === "typescript" ? TYPESCRIPT_VERSION : "latest"];
+}));
+const dependencyArguments = (names) => Object.entries(dependencyVersions(names)).map(([name, version]) => version === "latest" ? name : `${name}@${version}`);
+const writeDependencies = (root, devDependencies) => {
+    updateManifest(root, (manifest) => {
+        manifest.dependencies = dependencyVersions(DEPENDENCIES);
+        manifest.devDependencies = dependencyVersions(devDependencies);
+    });
 };
+const formatRecovery = (resolved) => `To finish setup, run ${INSTALL_COMMAND[resolved.packageManager]} in ${resolved.root}.`;
 const runWithSpinner = async (step) => {
     const spinner = p.spinner();
     spinner.start(step.pending);
@@ -336,32 +410,45 @@ const runWithSpinner = async (step) => {
     catch (error) {
         spinner.error(step.failed);
         p.log.error(errorMessage(error));
-        step.explain?.(error);
+        step.explain?.();
         throw new ScaffoldAbortedError(step.failed);
     }
 };
-const installAllDependencies = async (options) => {
-    const { resolved, devDependencies } = options;
+const installAllDependencies = async (resolved, devDependencies) => {
     const { root, packageManager } = resolved;
     await runWithSpinner({
         pending: "Installing dependencies...",
         done: "Dependencies installed",
         failed: "Failed to install dependencies",
         run: async () => {
-            await installDependencies({ cwd: root, packageManager, dependencies: pin(DEPENDENCIES), isDev: false });
-            await installDependencies({ cwd: root, packageManager, dependencies: pin(devDependencies), isDev: true });
+            await withoutInheritedScriptPolicy(async () => {
+                const options = { cwd: root, packageManager, silent: true };
+                await addDependency(dependencyArguments(DEPENDENCIES), options);
+                await addDependency(dependencyArguments(devDependencies), { ...options, dev: true });
+            });
         },
-        explain: (error) => {
-            explainInstallFailure({ error, resolved, devDependencies });
+        explain: () => {
+            p.log.info(formatRecovery(resolved));
         },
     });
 };
-const writeInitialEnvModule = (root) => {
-    const storeDir = join(root, "node_modules", ".gtkx");
-    mkdirSync(storeDir, { recursive: true });
-    writeFileSync(join(storeDir, "env.d.ts"), `${GTKX_ENV_MODULE_HEADER}\n`);
+const isInsideGitRepository = (root) => {
+    const git = tryResolveExecutable("git");
+    if (git === undefined) {
+        return false;
+    }
+    try {
+        execFileSync(git, ["-C", root, "rev-parse", "--show-toplevel"], { stdio: "ignore" });
+        return true;
+    }
+    catch {
+        return false;
+    }
 };
-const initializeGitRepo = async (root) => {
+const initializeGitRepo = async (root, shouldInitialize) => {
+    if (!shouldInitialize || isInsideGitRepository(root)) {
+        return;
+    }
     const spinner = p.spinner();
     spinner.start("Initializing git repository...");
     try {
@@ -377,21 +464,18 @@ const initializeGitRepo = async (root) => {
 };
 const printNextSteps = (resolved) => {
     const devCmd = DEV_COMMAND[resolved.packageManager];
-    const cdStep = resolved.isCurrentDirectory ? "" : `cd ${resolved.target}\n`;
+    const installStep = resolved.shouldInstallDependencies ? "" : `${INSTALL_COMMAND[resolved.packageManager]}\n`;
     const testingNote = resolved.shouldIncludeTesting ? HEADLESS_COMPOSITOR_NOTE : "";
-    p.note(`${cdStep}${devCmd}${testingNote}`, "Next steps");
+    p.note(`${installStep}${devCmd}${testingNote}`, `Run in ${resolved.root}`);
 };
-const createProjectStructure = async (root, resolved) => {
+const createProjectStructure = async (root, resolved, plan) => {
     await runWithSpinner({
         pending: "Creating project structure...",
         done: "Project structure created",
         failed: "Failed to create the project structure",
-        run: async () => {
+        run: () => {
             mkdirSync(root, { recursive: true });
-            if (resolved.shouldEmptyTarget) {
-                emptyDir(root);
-            }
-            await scaffoldProject(root, resolved);
+            scaffoldProject(plan);
             writeBuildAllowance(root, resolved.packageManager);
         },
     });
@@ -401,12 +485,16 @@ const scaffold = async (options = {}) => {
     const resolved = await resolveOptions(options);
     const { root } = resolved;
     const devDeps = getDevDependencies(resolved);
-    await createProjectStructure(root, resolved);
-    await installAllDependencies({ resolved, devDependencies: devDeps });
-    if (resolved.isTypescript) {
-        writeInitialEnvModule(root);
-    }
-    await initializeGitRepo(root);
+    assertTargetIsDirectory(root, resolved.target);
+    const plan = await planScaffoldProject(root, resolved);
+    await validateTargetAvailability(root, resolved.target, options, plan.changes);
+    await createProjectStructure(root, resolved, plan);
+    writeDependencies(root, devDeps);
+    reportCompletedChanges(plan.changes);
+    if (resolved.shouldInstallDependencies) {
+        await installAllDependencies(resolved, devDeps);
+    }
+    await initializeGitRepo(root, resolved.shouldInitializeGit);
     printNextSteps(resolved);
 };
 export { scaffold };