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

package/dist/command.d.ts

@@ -8,6 +8,10 @@ declare const scaffoldCommand: import("citty").CommandDef<{
         readonly type: "string";
         readonly description: "Application ID (e.g., com.example.myapp)";
     };
+    readonly "display-name": {
+        readonly type: "string";
+        readonly description: "Application display name (e.g., My App)";
+    };
     readonly "package-manager": {
         readonly type: "string";
         readonly alias: "p";
@@ -34,7 +38,11 @@ declare const scaffoldCommand: import("citty").CommandDef<{
     readonly overwrite: {
         readonly type: "boolean";
         readonly alias: "f";
-        readonly description: "Overwrite the contents of a non-empty target directory when running without prompts";
+        readonly description: "Replace scaffold files in a non-empty target directory when running without prompts";
+    };
+    readonly "skip-install": {
+        readonly type: "boolean";
+        readonly description: "Create the project without installing dependencies";
     };
 }>;
 export { scaffoldCommand };

package/dist/command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../src/command.ts"],"names":[],"mappings":"AAkBA,QAAA,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+CnB,CAAC;AAgCH,OAAO,EAAE,eAAe,EAAE,CAAC"}
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../src/command.ts"],"names":[],"mappings":"AAqBA,QAAA,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAuDnB,CAAC;AAmCH,OAAO,EAAE,eAAe,EAAE,CAAC"}

package/dist/command.js

@@ -1,4 +1,5 @@
 import * as p from "@clack/prompts";
+import { assertSupportedNodeVersion } from "@gtkx/config/internal";
 import { errorMessage } from "@gtkx/utils";
 import { defineCommand } from "citty";
 import { OperationCanceledError, ScaffoldAbortedError } from "./errors.js";
@@ -19,6 +20,10 @@ const scaffoldCommand = defineCommand({
             type: "string",
             description: "Application ID (e.g., com.example.myapp)",
         },
+        "display-name": {
+            type: "string",
+            description: "Application display name (e.g., My App)",
+        },
         "package-manager": {
             type: "string",
             alias: "p",
@@ -46,7 +51,11 @@ const scaffoldCommand = defineCommand({
         overwrite: {
             type: "boolean",
             alias: "f",
-            description: "Overwrite the contents of a non-empty target directory when running without prompts",
+            description: "Replace scaffold files in a non-empty target directory when running without prompts",
+        },
+        "skip-install": {
+            type: "boolean",
+            description: "Create the project without installing dependencies",
         },
     },
     run: ({ args }) => runCreate(args),
@@ -63,14 +72,17 @@ const settleScaffoldFailure = (error) => {
 const runCreate = async (args) => {
     const isInteractive = args["no-interactive"] || args.yes ? false : process.stdin.isTTY;
     try {
+        assertSupportedNodeVersion();
         await scaffold({
             name: args.name,
             applicationId: args["application-id"],
+            displayName: args["display-name"],
             packageManager: args["package-manager"],
             isTypescript: args.typescript,
             shouldIncludeTesting: args.vitest,
             isInteractive,
             shouldOverwrite: args.overwrite,
+            shouldInstallDependencies: args["skip-install"] !== true,
         });
     }
     catch (error) {

package/dist/command.js.map

@@ -1 +1 @@
-{"version":3,"file":"command.js","sourceRoot":"","sources":["../src/command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,gBAAgB,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAC3E,OAAO,EAAE,gCAAgC,EAAE,MAAM,uBAAuB,CAAC;AACzE,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAa3C,MAAM,eAAe,GAAG,aAAa,CAAC;IAClC,IAAI,EAAE;QACF,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,+BAA+B;KAC/C;IACD,IAAI,EAAE;QACF,IAAI,EAAE;YACF,IAAI,EAAE,YAAY;YAClB,WAAW,EAAE,gEAAgE;YAC7E,QAAQ,EAAE,KAAK;SAClB;QACD,gBAAgB,EAAE;YACd,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,0CAA0C;SAC1D;QACD,iBAAiB,EAAE;YACf,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,GAAG;YACV,WAAW,EAAE,gCAAgC;SAChD;QACD,UAAU,EAAE;YACR,IAAI,EAAE,SAAS;YACf,mBAAmB,EAAE,8DAA8D;YACnF,WAAW,EAAE,wCAAwC;SACxD;QACD,MAAM,EAAE;YACJ,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,gCAAgC;SAChD;QACD,GAAG,EAAE;YACD,IAAI,EAAE,SAAS;YACf,KAAK,EAAE,GAAG;YACV,WAAW,EAAE,0DAA0D;SAC1E;QACD,gBAAgB,EAAE;YACd,IAAI,EAAE,SAAS;YACf,WAAW,EACP,yFAAyF;gBACzF,iBAAiB;SACxB;QACD,SAAS,EAAE;YACP,IAAI,EAAE,SAAS;YACf,KAAK,EAAE,GAAG;YACV,WAAW,EAAE,qFAAqF;SACrG;KACJ;IACD,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC;CACrC,CAAC,CAAC;AAEH,MAAM,qBAAqB,GAAG,CAAC,KAAc,EAAQ,EAAE;IACnD,IAAI,KAAK,YAAY,sBAAsB,EAAE,CAAC;QAC1C,OAAO;IACX,CAAC;IAED,IAAI,CAAC,CAAC,KAAK,YAAY,oBAAoB,CAAC,EAAE,CAAC;QAC3C,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;IACrC,CAAC;IAED,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACzB,CAAC,CAAC;AAEF,MAAM,SAAS,GAAG,KAAK,EAAE,IAAuB,EAAiB,EAAE;IAC/D,MAAM,aAAa,GAAG,IAAI,CAAC,gBAAgB,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC;IAEvF,IAAI,CAAC;QACD,MAAM,QAAQ,CAAC;YACX,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,aAAa,EAAE,IAAI,CAAC,gBAAgB,CAAC;YACrC,cAAc,EAAE,IAAI,CAAC,iBAAiB,CAAC;YACvC,YAAY,EAAE,IAAI,CAAC,UAAU;YAC7B,oBAAoB,EAAE,IAAI,CAAC,MAAM;YACjC,aAAa;YACb,eAAe,EAAE,IAAI,CAAC,SAAS;SAClC,CAAC,CAAC;IACP,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,qBAAqB,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC;AACL,CAAC,CAAC;AAEF,OAAO,EAAE,eAAe,EAAE,CAAC","sourcesContent":["import * as p from \"@clack/prompts\";\nimport { errorMessage } from \"@gtkx/utils\";\nimport { defineCommand } from \"citty\";\nimport { OperationCanceledError, ScaffoldAbortedError } from \"./errors.js\";\nimport { PACKAGE_MANAGER_FLAG_DESCRIPTION } from \"./package-managers.js\";\nimport { scaffold } from \"./scaffolder.js\";\n\ntype CreateCommandArgs = {\n    name?: string | undefined;\n    \"application-id\"?: string | undefined;\n    \"package-manager\"?: string | undefined;\n    typescript?: boolean | undefined;\n    vitest?: boolean | undefined;\n    yes?: boolean | undefined;\n    \"no-interactive\"?: boolean | undefined;\n    overwrite?: boolean | undefined;\n};\n\nconst scaffoldCommand = defineCommand({\n    meta: {\n        name: \"create\",\n        description: \"Create a new GTKX application\",\n    },\n    args: {\n        name: {\n            type: \"positional\",\n            description: \"Target directory or project name (e.g. my-app, ., apps/my-app)\",\n            required: false,\n        },\n        \"application-id\": {\n            type: \"string\",\n            description: \"Application ID (e.g., com.example.myapp)\",\n        },\n        \"package-manager\": {\n            type: \"string\",\n            alias: \"p\",\n            description: PACKAGE_MANAGER_FLAG_DESCRIPTION,\n        },\n        typescript: {\n            type: \"boolean\",\n            negativeDescription: \"Scaffold the application in JavaScript instead of TypeScript\",\n            description: \"Scaffold the application in TypeScript\",\n        },\n        vitest: {\n            type: \"boolean\",\n            description: \"Include a Vitest testing setup\",\n        },\n        yes: {\n            type: \"boolean\",\n            alias: \"y\",\n            description: \"Skip prompts and accept defaults for unspecified options\",\n        },\n        \"no-interactive\": {\n            type: \"boolean\",\n            description:\n                \"Run without prompts, using the default for every option not passed on the command line \" +\n                \"(same as --yes)\",\n        },\n        overwrite: {\n            type: \"boolean\",\n            alias: \"f\",\n            description: \"Overwrite the contents of a non-empty target directory when running without prompts\",\n        },\n    },\n    run: ({ args }) => runCreate(args),\n});\n\nconst settleScaffoldFailure = (error: unknown): void => {\n    if (error instanceof OperationCanceledError) {\n        return;\n    }\n\n    if (!(error instanceof ScaffoldAbortedError)) {\n        p.log.error(errorMessage(error));\n    }\n\n    process.exitCode = 1;\n};\n\nconst runCreate = async (args: CreateCommandArgs): Promise<void> => {\n    const isInteractive = args[\"no-interactive\"] || args.yes ? false : process.stdin.isTTY;\n\n    try {\n        await scaffold({\n            name: args.name,\n            applicationId: args[\"application-id\"],\n            packageManager: args[\"package-manager\"],\n            isTypescript: args.typescript,\n            shouldIncludeTesting: args.vitest,\n            isInteractive,\n            shouldOverwrite: args.overwrite,\n        });\n    } catch (error) {\n        settleScaffoldFailure(error);\n    }\n};\n\nexport { scaffoldCommand };\n"]}
+{"version":3,"file":"command.js","sourceRoot":"","sources":["../src/command.ts"],"names":[],"mappings":"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","sourcesContent":["import * as p from \"@clack/prompts\";\nimport { assertSupportedNodeVersion } from \"@gtkx/config/internal\";\nimport { errorMessage } from \"@gtkx/utils\";\nimport { defineCommand } from \"citty\";\nimport { OperationCanceledError, ScaffoldAbortedError } from \"./errors.js\";\nimport { PACKAGE_MANAGER_FLAG_DESCRIPTION } from \"./package-managers.js\";\nimport { scaffold } from \"./scaffolder.js\";\n\ntype CreateCommandArgs = {\n    name?: string | undefined;\n    \"application-id\"?: string | undefined;\n    \"display-name\"?: string | undefined;\n    \"package-manager\"?: string | undefined;\n    typescript?: boolean | undefined;\n    vitest?: boolean | undefined;\n    yes?: boolean | undefined;\n    \"no-interactive\"?: boolean | undefined;\n    overwrite?: boolean | undefined;\n    \"skip-install\"?: boolean | undefined;\n};\n\nconst scaffoldCommand = defineCommand({\n    meta: {\n        name: \"create\",\n        description: \"Create a new GTKX application\",\n    },\n    args: {\n        name: {\n            type: \"positional\",\n            description: \"Target directory or project name (e.g. my-app, ., apps/my-app)\",\n            required: false,\n        },\n        \"application-id\": {\n            type: \"string\",\n            description: \"Application ID (e.g., com.example.myapp)\",\n        },\n        \"display-name\": {\n            type: \"string\",\n            description: \"Application display name (e.g., My App)\",\n        },\n        \"package-manager\": {\n            type: \"string\",\n            alias: \"p\",\n            description: PACKAGE_MANAGER_FLAG_DESCRIPTION,\n        },\n        typescript: {\n            type: \"boolean\",\n            negativeDescription: \"Scaffold the application in JavaScript instead of TypeScript\",\n            description: \"Scaffold the application in TypeScript\",\n        },\n        vitest: {\n            type: \"boolean\",\n            description: \"Include a Vitest testing setup\",\n        },\n        yes: {\n            type: \"boolean\",\n            alias: \"y\",\n            description: \"Skip prompts and accept defaults for unspecified options\",\n        },\n        \"no-interactive\": {\n            type: \"boolean\",\n            description:\n                \"Run without prompts, using the default for every option not passed on the command line \" +\n                \"(same as --yes)\",\n        },\n        overwrite: {\n            type: \"boolean\",\n            alias: \"f\",\n            description: \"Replace scaffold files in a non-empty target directory when running without prompts\",\n        },\n        \"skip-install\": {\n            type: \"boolean\",\n            description: \"Create the project without installing dependencies\",\n        },\n    },\n    run: ({ args }) => runCreate(args),\n});\n\nconst settleScaffoldFailure = (error: unknown): void => {\n    if (error instanceof OperationCanceledError) {\n        return;\n    }\n\n    if (!(error instanceof ScaffoldAbortedError)) {\n        p.log.error(errorMessage(error));\n    }\n\n    process.exitCode = 1;\n};\n\nconst runCreate = async (args: CreateCommandArgs): Promise<void> => {\n    const isInteractive = args[\"no-interactive\"] || args.yes ? false : process.stdin.isTTY;\n\n    try {\n        assertSupportedNodeVersion();\n        await scaffold({\n            name: args.name,\n            applicationId: args[\"application-id\"],\n            displayName: args[\"display-name\"],\n            packageManager: args[\"package-manager\"],\n            isTypescript: args.typescript,\n            shouldIncludeTesting: args.vitest,\n            isInteractive,\n            shouldOverwrite: args.overwrite,\n            shouldInstallDependencies: args[\"skip-install\"] !== true,\n        });\n    } catch (error) {\n        settleScaffoldFailure(error);\n    }\n};\n\nexport { scaffoldCommand };\n"]}

package/dist/manifest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAKA,QAAA,MAAM,cAAc,GAAI,MAAM,MAAM,EAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,KAAG,IAO3F,CAAC;AAEF,OAAO,EAAE,cAAc,EAAE,CAAC"}
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAMA,QAAA,MAAM,cAAc,GAAI,MAAM,MAAM,EAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,KAAG,IAY3F,CAAC;AAEF,OAAO,EAAE,cAAc,EAAE,CAAC"}

package/dist/manifest.js

@@ -1,13 +1,19 @@
-import { readFileSync, renameSync, writeFileSync } from "node:fs";
+import { randomUUID } from "node:crypto";
+import { readFileSync, renameSync, rmSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
 const PACKAGE_JSON_FILE = "package.json";
 const updateManifest = (root, mutate) => {
     const manifestPath = join(root, PACKAGE_JSON_FILE);
     const manifest = JSON.parse(readFileSync(manifestPath, "utf8"));
     mutate(manifest);
-    const pendingPath = `${manifestPath}.pending`;
-    writeFileSync(pendingPath, `${JSON.stringify(manifest, null, 4)}\n`);
-    renameSync(pendingPath, manifestPath);
+    const pendingPath = join(root, `.package-${randomUUID()}.json`);
+    try {
+        writeFileSync(pendingPath, `${JSON.stringify(manifest, null, 4)}\n`, { flag: "wx", mode: 0o600 });
+        renameSync(pendingPath, manifestPath);
+    }
+    finally {
+        rmSync(pendingPath, { force: true });
+    }
 };
 export { updateManifest };
 //# sourceMappingURL=manifest.js.map

package/dist/manifest.js.map

@@ -1 +1 @@
-{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAClE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,iBAAiB,GAAG,cAAc,CAAC;AAEzC,MAAM,cAAc,GAAG,CAAC,IAAY,EAAE,MAAmD,EAAQ,EAAE;IAC/F,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC;IACnD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,YAAY,EAAE,MAAM,CAAC,CAA4B,CAAC;IAC3F,MAAM,CAAC,QAAQ,CAAC,CAAC;IACjB,MAAM,WAAW,GAAG,GAAG,YAAY,UAAU,CAAC;IAC9C,aAAa,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;IACrE,UAAU,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;AAC1C,CAAC,CAAC;AAEF,OAAO,EAAE,cAAc,EAAE,CAAC","sourcesContent":["import { readFileSync, renameSync, writeFileSync } from \"node:fs\";\nimport { join } from \"node:path\";\n\nconst PACKAGE_JSON_FILE = \"package.json\";\n\nconst updateManifest = (root: string, mutate: (manifest: Record<string, unknown>) => void): void => {\n    const manifestPath = join(root, PACKAGE_JSON_FILE);\n    const manifest = JSON.parse(readFileSync(manifestPath, \"utf8\")) as Record<string, unknown>;\n    mutate(manifest);\n    const pendingPath = `${manifestPath}.pending`;\n    writeFileSync(pendingPath, `${JSON.stringify(manifest, null, 4)}\\n`);\n    renameSync(pendingPath, manifestPath);\n};\n\nexport { updateManifest };\n"]}
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC1E,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,iBAAiB,GAAG,cAAc,CAAC;AAEzC,MAAM,cAAc,GAAG,CAAC,IAAY,EAAE,MAAmD,EAAQ,EAAE;IAC/F,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC;IACnD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,YAAY,EAAE,MAAM,CAAC,CAA4B,CAAC;IAC3F,MAAM,CAAC,QAAQ,CAAC,CAAC;IACjB,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,EAAE,YAAY,UAAU,EAAE,OAAO,CAAC,CAAC;IAEhE,IAAI,CAAC;QACD,aAAa,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QAClG,UAAU,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;IAC1C,CAAC;YAAS,CAAC;QACP,MAAM,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACzC,CAAC;AACL,CAAC,CAAC;AAEF,OAAO,EAAE,cAAc,EAAE,CAAC","sourcesContent":["import { randomUUID } from \"node:crypto\";\nimport { readFileSync, renameSync, rmSync, writeFileSync } from \"node:fs\";\nimport { join } from \"node:path\";\n\nconst PACKAGE_JSON_FILE = \"package.json\";\n\nconst updateManifest = (root: string, mutate: (manifest: Record<string, unknown>) => void): void => {\n    const manifestPath = join(root, PACKAGE_JSON_FILE);\n    const manifest = JSON.parse(readFileSync(manifestPath, \"utf8\")) as Record<string, unknown>;\n    mutate(manifest);\n    const pendingPath = join(root, `.package-${randomUUID()}.json`);\n\n    try {\n        writeFileSync(pendingPath, `${JSON.stringify(manifest, null, 4)}\\n`, { flag: \"wx\", mode: 0o600 });\n        renameSync(pendingPath, manifestPath);\n    } finally {\n        rmSync(pendingPath, { force: true });\n    }\n};\n\nexport { updateManifest };\n"]}

package/dist/package-managers.d.ts

@@ -4,18 +4,21 @@ declare const PACKAGE_MANAGERS: readonly [{
     readonly label: "pnpm";
     readonly devCommand: "pnpm dev";
     readonly addCommand: "pnpm add";
+    readonly installCommand: "pnpm install";
     readonly isRecommended: true;
 }, {
     readonly value: "npm";
     readonly label: "npm";
     readonly devCommand: "npm run dev";
     readonly addCommand: "npm install";
+    readonly installCommand: "npm install";
     readonly isRecommended: false;
 }, {
     readonly value: "yarn";
     readonly label: "yarn";
     readonly devCommand: "yarn dev";
     readonly addCommand: "yarn add";
+    readonly installCommand: "yarn install";
     readonly isRecommended: false;
 }];
 declare const PACKAGE_MANAGER_VALUES: PackageManager[];

package/dist/package-managers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"package-managers.d.ts","sourceRoot":"","sources":["../src/package-managers.ts"],"names":[],"mappings":"AAAA,KAAK,cAAc,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC;AAEjE,QAAA,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;EAIZ,CAAC;AAEX,QAAA,MAAM,sBAAsB,EAAE,cAAc,EAAqD,CAAC;AAClG,QAAA,MAAM,gCAAgC,QAA2D,CAAC;AAElG,QAAA,MAAM,qBAAqB,GAAI,MAAM,MAAM,KAAG,IAAI,IAAI,cACC,CAAC;AAExD,OAAO,EACH,gBAAgB,EAChB,gCAAgC,EAChC,sBAAsB,EACtB,qBAAqB,EACrB,KAAK,cAAc,GACtB,CAAC"}
+{"version":3,"file":"package-managers.d.ts","sourceRoot":"","sources":["../src/package-managers.ts"],"names":[],"mappings":"AAAA,KAAK,cAAc,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC;AAEjE,QAAA,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;EAyBZ,CAAC;AAEX,QAAA,MAAM,sBAAsB,EAAE,cAAc,EAAqD,CAAC;AAClG,QAAA,MAAM,gCAAgC,QAA2D,CAAC;AAElG,QAAA,MAAM,qBAAqB,GAAI,MAAM,MAAM,KAAG,IAAI,IAAI,cACC,CAAC;AAExD,OAAO,EACH,gBAAgB,EAChB,gCAAgC,EAChC,sBAAsB,EACtB,qBAAqB,EACrB,KAAK,cAAc,GACtB,CAAC"}

package/dist/package-managers.js

@@ -1,7 +1,28 @@
 const PACKAGE_MANAGERS = [
-    { value: "pnpm", label: "pnpm", devCommand: "pnpm dev", addCommand: "pnpm add", isRecommended: true },
-    { value: "npm", label: "npm", devCommand: "npm run dev", addCommand: "npm install", isRecommended: false },
-    { value: "yarn", label: "yarn", devCommand: "yarn dev", addCommand: "yarn add", isRecommended: false },
+    {
+        value: "pnpm",
+        label: "pnpm",
+        devCommand: "pnpm dev",
+        addCommand: "pnpm add",
+        installCommand: "pnpm install",
+        isRecommended: true,
+    },
+    {
+        value: "npm",
+        label: "npm",
+        devCommand: "npm run dev",
+        addCommand: "npm install",
+        installCommand: "npm install",
+        isRecommended: false,
+    },
+    {
+        value: "yarn",
+        label: "yarn",
+        devCommand: "yarn dev",
+        addCommand: "yarn add",
+        installCommand: "yarn install",
+        isRecommended: false,
+    },
 ];
 const PACKAGE_MANAGER_VALUES = PACKAGE_MANAGERS.map((manager) => manager.value);
 const PACKAGE_MANAGER_FLAG_DESCRIPTION = `Package manager (${PACKAGE_MANAGER_VALUES.join(", ")})`;

package/dist/package-managers.js.map

@@ -1 +1 @@
-{"version":3,"file":"package-managers.js","sourceRoot":"","sources":["../src/package-managers.ts"],"names":[],"mappings":"AAEA,MAAM,gBAAgB,GAAG;IACrB,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,aAAa,EAAE,IAAI,EAAE;IACrG,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,UAAU,EAAE,aAAa,EAAE,aAAa,EAAE,KAAK,EAAE;IAC1G,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,aAAa,EAAE,KAAK,EAAE;CAChG,CAAC;AAEX,MAAM,sBAAsB,GAAqB,gBAAgB,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAClG,MAAM,gCAAgC,GAAG,oBAAoB,sBAAsB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;AAElG,MAAM,qBAAqB,GAAG,CAAC,IAAY,EAA0B,EAAE,CAClE,sBAAmC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AAExD,OAAO,EACH,gBAAgB,EAChB,gCAAgC,EAChC,sBAAsB,EACtB,qBAAqB,GAExB,CAAC","sourcesContent":["type PackageManager = (typeof PACKAGE_MANAGERS)[number][\"value\"];\n\nconst PACKAGE_MANAGERS = [\n    { value: \"pnpm\", label: \"pnpm\", devCommand: \"pnpm dev\", addCommand: \"pnpm add\", isRecommended: true },\n    { value: \"npm\", label: \"npm\", devCommand: \"npm run dev\", addCommand: \"npm install\", isRecommended: false },\n    { value: \"yarn\", label: \"yarn\", devCommand: \"yarn dev\", addCommand: \"yarn add\", isRecommended: false },\n] as const;\n\nconst PACKAGE_MANAGER_VALUES: PackageManager[] = PACKAGE_MANAGERS.map((manager) => manager.value);\nconst PACKAGE_MANAGER_FLAG_DESCRIPTION = `Package manager (${PACKAGE_MANAGER_VALUES.join(\", \")})`;\n\nconst isKnownPackageManager = (name: string): name is PackageManager =>\n    (PACKAGE_MANAGER_VALUES as string[]).includes(name);\n\nexport {\n    PACKAGE_MANAGERS,\n    PACKAGE_MANAGER_FLAG_DESCRIPTION,\n    PACKAGE_MANAGER_VALUES,\n    isKnownPackageManager,\n    type PackageManager,\n};\n"]}
+{"version":3,"file":"package-managers.js","sourceRoot":"","sources":["../src/package-managers.ts"],"names":[],"mappings":"AAEA,MAAM,gBAAgB,GAAG;IACrB;QACI,KAAK,EAAE,MAAM;QACb,KAAK,EAAE,MAAM;QACb,UAAU,EAAE,UAAU;QACtB,UAAU,EAAE,UAAU;QACtB,cAAc,EAAE,cAAc;QAC9B,aAAa,EAAE,IAAI;KACtB;IACD;QACI,KAAK,EAAE,KAAK;QACZ,KAAK,EAAE,KAAK;QACZ,UAAU,EAAE,aAAa;QACzB,UAAU,EAAE,aAAa;QACzB,cAAc,EAAE,aAAa;QAC7B,aAAa,EAAE,KAAK;KACvB;IACD;QACI,KAAK,EAAE,MAAM;QACb,KAAK,EAAE,MAAM;QACb,UAAU,EAAE,UAAU;QACtB,UAAU,EAAE,UAAU;QACtB,cAAc,EAAE,cAAc;QAC9B,aAAa,EAAE,KAAK;KACvB;CACK,CAAC;AAEX,MAAM,sBAAsB,GAAqB,gBAAgB,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAClG,MAAM,gCAAgC,GAAG,oBAAoB,sBAAsB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;AAElG,MAAM,qBAAqB,GAAG,CAAC,IAAY,EAA0B,EAAE,CAClE,sBAAmC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AAExD,OAAO,EACH,gBAAgB,EAChB,gCAAgC,EAChC,sBAAsB,EACtB,qBAAqB,GAExB,CAAC","sourcesContent":["type PackageManager = (typeof PACKAGE_MANAGERS)[number][\"value\"];\n\nconst PACKAGE_MANAGERS = [\n    {\n        value: \"pnpm\",\n        label: \"pnpm\",\n        devCommand: \"pnpm dev\",\n        addCommand: \"pnpm add\",\n        installCommand: \"pnpm install\",\n        isRecommended: true,\n    },\n    {\n        value: \"npm\",\n        label: \"npm\",\n        devCommand: \"npm run dev\",\n        addCommand: \"npm install\",\n        installCommand: \"npm install\",\n        isRecommended: false,\n    },\n    {\n        value: \"yarn\",\n        label: \"yarn\",\n        devCommand: \"yarn dev\",\n        addCommand: \"yarn add\",\n        installCommand: \"yarn install\",\n        isRecommended: false,\n    },\n] as const;\n\nconst PACKAGE_MANAGER_VALUES: PackageManager[] = PACKAGE_MANAGERS.map((manager) => manager.value);\nconst PACKAGE_MANAGER_FLAG_DESCRIPTION = `Package manager (${PACKAGE_MANAGER_VALUES.join(\", \")})`;\n\nconst isKnownPackageManager = (name: string): name is PackageManager =>\n    (PACKAGE_MANAGER_VALUES as string[]).includes(name);\n\nexport {\n    PACKAGE_MANAGERS,\n    PACKAGE_MANAGER_FLAG_DESCRIPTION,\n    PACKAGE_MANAGER_VALUES,\n    isKnownPackageManager,\n    type PackageManager,\n};\n"]}

package/dist/scaffolder.d.ts

@@ -1,11 +1,13 @@
 type CreateOptions = {
     name?: string | undefined;
     applicationId?: string | undefined;
+    displayName?: string | undefined;
     packageManager?: string | undefined;
     isTypescript?: boolean | undefined;
     shouldIncludeTesting?: boolean | undefined;
     isInteractive?: boolean | undefined;
     shouldOverwrite?: boolean | undefined;
+    shouldInstallDependencies?: boolean | undefined;
 };
 declare const scaffold: (options?: CreateOptions) => Promise<void>;
 export { scaffold };

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":"AAsBA,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;AA4tBF,QAAA,MAAM,QAAQ,GAAU,UAAS,aAAkB,KAAG,OAAO,CAAC,IAAI,CAejE,CAAC;AAEF,OAAO,EAAE,QAAQ,EAAE,CAAC"}

package/dist/scaffolder.js

@@ -2,8 +2,8 @@ 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, isAbsolute, 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" };
@@ -25,6 +25,7 @@ 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"]);
@@ -39,7 +40,7 @@ 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) {
@@ -71,6 +72,10 @@ 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) {
@@ -100,6 +105,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);
@@ -134,6 +146,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) {
@@ -166,38 +187,30 @@ 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 shouldOverwriteDirectory = async (target, options) => {
     if (!options.isInteractive) {
         return options.shouldOverwrite === true;
     }
     return guardCancellation(await p.confirm({
-        message: `Directory "${target}" is not empty. Overwrite its contents?`,
+        message: `Directory "${target}" is not empty. Replace scaffold files?`,
         initialValue: false,
     }));
 };
-const shouldEmptyTargetDirectory = async (root, target, options) => {
+const validateTargetAvailability = async (root, target, options) => {
     const stats = statSync(root, { throwIfNoEntry: false });
     if (stats === undefined) {
-        return false;
+        return;
     }
     if (!stats.isDirectory()) {
         return fail(`Target "${target}" is not a directory`);
     }
     if (isDirEmpty(root)) {
-        return false;
+        return;
     }
     if (await shouldOverwriteDirectory(target, options)) {
-        return true;
+        return;
     }
-    return fail(`Directory "${target}" is not empty`);
+    fail(`Directory "${target}" is not empty`);
 };
 const resolveTarget = async (options) => {
     if (options.name === undefined && options.isInteractive) {
@@ -213,6 +226,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,10 +245,12 @@ 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);
+    await validateTargetAvailability(root, target, options);
     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)?");
@@ -238,11 +259,13 @@ const resolveOptions = async (options) => {
         root,
         isCurrentDirectory,
         name,
+        displayName,
         applicationId,
         packageManager,
         isTypescript,
         shouldIncludeTesting,
-        shouldEmptyTarget,
+        shouldInitializeGit: shouldInitialize,
+        shouldInstallDependencies: options.shouldInstallDependencies !== false,
     };
 };
 const isTemplateIncluded = (templateRelativePath, resolved) => {
@@ -263,22 +286,98 @@ 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 replaceTemplateDestination = (destination) => {
+    const entry = lstatSync(destination, { throwIfNoEntry: false });
+    if (entry === undefined) {
+        return;
+    }
+    if (!entry.isFile() && !entry.isSymbolicLink()) {
+        fail(`Cannot replace scaffold file because its destination is not a file: ${destination}`);
+    }
+    rmSync(destination, { force: true });
+};
+const projectRelativeDestination = (root, destination) => {
+    const relativePath = relative(root, destination);
+    const isOutsideProject = relativePath.length === 0 || relativePath.startsWith(`..${sep}`) ||
+        isAbsolute(relativePath);
+    if (isOutsideProject) {
+        fail(`Scaffold destination is outside the project: ${destination}`);
+    }
+    return relativePath;
+};
+const assertRootIsNotSymbolicLink = (root) => {
+    const rootEntry = lstatSync(root, { throwIfNoEntry: false });
+    if (rootEntry?.isSymbolicLink()) {
+        fail(`Cannot scaffold through a symbolic link: ${root}`);
+    }
+};
+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 assertReplaceableDestination = (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}`);
+    }
+};
+const assertSafeDestination = (root, destination) => {
+    const relativePath = projectRelativeDestination(root, destination);
+    assertRootIsNotSymbolicLink(root);
+    assertSafeAncestors(root, relativePath);
+    assertReplaceableDestination(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));
+    }
+    return files;
+};
+const auxiliaryDestinations = (root, resolved) => [
+    ...(resolved.packageManager === "pnpm" ? [join(root, "pnpm-workspace.yaml")] : []),
+    ...(resolved.isTypescript ? [join(root, "node_modules", ".gtkx", "env.d.ts")] : []),
+];
+const scaffoldProject = async (root, resolved) => {
+    const files = await plannedScaffoldFiles(root, resolved);
+    const destinations = [...files.map((file) => file.destination), ...auxiliaryDestinations(root, resolved)];
+    for (const destination of destinations) {
+        assertSafeDestination(root, destination);
+    }
+    for (const destination of destinations) {
+        replaceTemplateDestination(destination);
+    }
+    for (const file of files) {
+        mkdirSync(dirname(file.destination), { recursive: true });
+        writeFileSync(file.destination, file.contents);
     }
     if (resolved.shouldIncludeTesting) {
         updateManifest(root, (manifest) => {
@@ -309,6 +408,13 @@ const installDependencies = async (options) => {
     });
 };
 const pin = (names) => names.map((dependency) => dependency.startsWith("@gtkx/") ? `${dependency}@^${selfVersion}` : dependency);
+const dependencyVersions = (names) => Object.fromEntries(names.map((dependency) => [dependency, dependency.startsWith("@gtkx/") ? `^${selfVersion}` : "latest"]));
+const writeDependencies = (root, devDependencies) => {
+    updateManifest(root, (manifest) => {
+        manifest.dependencies = dependencyVersions(DEPENDENCIES);
+        manifest.devDependencies = dependencyVersions(devDependencies);
+    });
+};
 const formatRecovery = ({ resolved, devDependencies }) => {
     const add = ADD_COMMAND[resolved.packageManager];
     const steps = [
@@ -361,7 +467,23 @@ const writeInitialEnvModule = (root) => {
     mkdirSync(storeDir, { recursive: true });
     writeFileSync(join(storeDir, "env.d.ts"), `${GTKX_ENV_MODULE_HEADER}\n`);
 };
-const initializeGitRepo = async (root) => {
+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, shouldInitialize) => {
+    if (!shouldInitialize || isInsideGitRepository(root)) {
+        return;
+    }
     const spinner = p.spinner();
     spinner.start("Initializing git repository...");
     try {
@@ -378,8 +500,9 @@ 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(`${cdStep}${installStep}${devCmd}${testingNote}`, "Next steps");
 };
 const createProjectStructure = async (root, resolved) => {
     await runWithSpinner({
@@ -388,11 +511,11 @@ const createProjectStructure = async (root, resolved) => {
         failed: "Failed to create the project structure",
         run: async () => {
             mkdirSync(root, { recursive: true });
-            if (resolved.shouldEmptyTarget) {
-                emptyDir(root);
-            }
             await scaffoldProject(root, resolved);
             writeBuildAllowance(root, resolved.packageManager);
+            if (resolved.isTypescript) {
+                writeInitialEnvModule(root);
+            }
         },
     });
 };
@@ -402,11 +525,13 @@ const scaffold = async (options = {}) => {
     const { root } = resolved;
     const devDeps = getDevDependencies(resolved);
     await createProjectStructure(root, resolved);
-    await installAllDependencies({ resolved, devDependencies: devDeps });
-    if (resolved.isTypescript) {
-        writeInitialEnvModule(root);
+    if (resolved.shouldInstallDependencies) {
+        await installAllDependencies({ resolved, devDependencies: devDeps });
+    }
+    else {
+        writeDependencies(root, devDeps);
     }
-    await initializeGitRepo(root);
+    await initializeGitRepo(root, resolved.shouldInitializeGit);
     printNextSteps(resolved);
 };
 export { scaffold };