simple-scaffold 3.0.0 → 3.1.0

package/README.md

@@ -40,6 +40,21 @@ See full documentation [here](https://chenasraf.github.io/simple-scaffold).
 
 ## Getting Started
 
+### Quick Start
+
+The fastest way to get started is to run `init` in your project directory:
+
+```sh
+npx simple-scaffold init
+```
+
+This creates a `scaffold.config.js` and an example template in `templates/default/`. Then generate
+files with:
+
+```sh
+npx simple-scaffold MyProject
+```
+
 ### Cheat Sheet
 
 A quick rundown of common usage scenarios:

package/cmd.js

@@ -1,20 +1,110 @@
 #!/usr/bin/env node
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_scaffold = require("./scaffold-Ce-rIwy9.js");
+const require_scaffold = require("./scaffold-DOzCgpZT.js");
 let node_path = require("node:path");
 node_path = require_scaffold.__toESM(node_path);
 let node_fs_promises = require("node:fs/promises");
 node_fs_promises = require_scaffold.__toESM(node_fs_promises);
+let _inquirer_select = require("@inquirer/select");
+_inquirer_select = require_scaffold.__toESM(_inquirer_select);
 let massarg = require("massarg");
 let massarg_command = require("massarg/command");
+//#region src/init.ts
+var CONFIG_EXTENSIONS = {
+	js: "scaffold.config.js",
+	mjs: "scaffold.config.mjs",
+	json: "scaffold.config.json"
+};
+var CONFIG_TEMPLATES = {
+	js: `/** @type {import('simple-scaffold').ScaffoldConfigMap} */
+module.exports = {
+  default: {
+    templates: ["templates/default"],
+    output: ".",
+    // inputs: {
+    //   author: { message: "Author name", required: true },
+    //   license: { message: "License", default: "MIT" },
+    // },
+  },
+}
+`,
+	mjs: `/** @type {import('simple-scaffold').ScaffoldConfigMap} */
+export default {
+  default: {
+    templates: ["templates/default"],
+    output: ".",
+    // inputs: {
+    //   author: { message: "Author name", required: true },
+    //   license: { message: "License", default: "MIT" },
+    // },
+  },
+}
+`,
+	json: `{
+  "default": {
+    "templates": ["templates/default"],
+    "output": "."
+  }
+}
+`
+};
+var EXAMPLE_TEMPLATE_CONTENT = `# {{ name }}
+
+Created by Simple Scaffold.
+
+{{#if description}}{{ description }}{{/if}}
+`;
+/**
+* Initializes a new Simple Scaffold project by creating a config file
+* and an optional example template directory.
+*/
+async function initScaffold(options = {}) {
+	const dir = options.dir ?? process.cwd();
+	const format = options.format ?? await (0, _inquirer_select.default)({
+		message: require_scaffold.colorize.cyan("Config file format:"),
+		choices: [
+			{
+				name: "JavaScript (CommonJS)",
+				value: "js"
+			},
+			{
+				name: "JavaScript (ESM)",
+				value: "mjs"
+			},
+			{
+				name: "JSON",
+				value: "json"
+			}
+		]
+	});
+	const filename = CONFIG_EXTENSIONS[format];
+	const configPath = node_path.default.resolve(dir, filename);
+	if (await require_scaffold.pathExists(configPath)) console.log(require_scaffold.colorize.yellow(`${filename} already exists, skipping config creation.`));
+	else {
+		await node_fs_promises.default.writeFile(configPath, CONFIG_TEMPLATES[format]);
+		console.log(require_scaffold.colorize.green(`Created ${filename}`));
+	}
+	if (options.createExample ?? true) {
+		const templateDir = node_path.default.resolve(dir, "templates", "default");
+		const templateFile = node_path.default.join(templateDir, "{{name}}.md");
+		if (await require_scaffold.pathExists(templateDir)) console.log(require_scaffold.colorize.yellow("templates/default/ already exists, skipping example template."));
+		else {
+			await node_fs_promises.default.mkdir(templateDir, { recursive: true });
+			await node_fs_promises.default.writeFile(templateFile, EXAMPLE_TEMPLATE_CONTENT);
+			console.log(require_scaffold.colorize.green("Created templates/default/{{name}}.md"));
+		}
+	}
+	console.log();
+	console.log(require_scaffold.colorize.dim("Get started:"));
+	console.log(require_scaffold.colorize.dim(`  npx simple-scaffold MyProject`));
+	console.log();
+}
+//#endregion
 //#region src/cmd.ts
 async function parseCliArgs(args = process.argv.slice(2)) {
 	const isProjectRoot = Boolean(await node_fs_promises.default.stat(node_path.default.join(__dirname, "package.json")).catch(() => false));
 	const pkgFile = await node_fs_promises.default.readFile(node_path.default.resolve(__dirname, isProjectRoot ? "." : "..", "package.json"));
 	const pkg = JSON.parse(pkgFile.toString());
-	args.includes("--version") || args.includes("-v");
-	args.includes("--config") || args.includes("-c");
-	args.includes("--git") || args.includes("-g");
 	return (0, massarg.massarg)({
 		name: pkg.name,
 		description: pkg.description
@@ -23,19 +113,20 @@ async function parseCliArgs(args = process.argv.slice(2)) {
 			console.log(pkg.version);
 			return;
 		}
-		require_scaffold.log(config, require_scaffold.LogLevel.info, `Simple Scaffold v${pkg.version}`);
+		require_scaffold.log(config, require_scaffold.LogLevel.debug, `Simple Scaffold v${pkg.version}`);
 		config.tmpDir = require_scaffold.getUniqueTmpPath();
 		try {
-			if (!config.config && !config.git) try {
+			const isOneTimeRun = config.templates?.length > 0 || config.output;
+			if (!config.config && !config.git && !isOneTimeRun) try {
 				config.config = await require_scaffold.findConfigFile(process.cwd());
 				require_scaffold.log(config, require_scaffold.LogLevel.debug, `Auto-detected config file: ${config.config}`);
 			} catch {}
 			const hasConfigSource = Boolean(config.config || config.git);
 			let configMap;
 			if (hasConfigSource) configMap = await require_scaffold.getConfigFile(config);
-			config = await require_scaffold.promptForMissingConfig(config, configMap);
+			config = await require_scaffold.promptBeforeConfig(config, configMap);
 			require_scaffold.log(config, require_scaffold.LogLevel.debug, "Parsing config file...", config);
-			await require_scaffold.Scaffold(await require_scaffold.resolveInputs(await require_scaffold.parseConfigFile(config)));
+			await require_scaffold.Scaffold(await require_scaffold.resolveInputs(await require_scaffold.promptAfterConfig(await require_scaffold.parseConfigFile(config))));
 		} catch (e) {
 			const message = "message" in e ? e.message : e?.toString();
 			require_scaffold.log(config, require_scaffold.LogLevel.error, message);
@@ -118,6 +209,10 @@ async function parseCliArgs(args = process.argv.slice(2)) {
 		name: "before-write",
 		aliases: ["B"],
 		description: "Run a script before writing the files. This can be a command or a path to a file. A temporary file path will be passed to the given command and the command should return a string for the final output."
+	}).option({
+		name: "after-scaffold",
+		aliases: ["A"],
+		description: "Run a shell command after all files have been written. The command is executed in the output directory. For example: `--after-scaffold 'npm install'`"
 	}).flag({
 		name: "dry-run",
 		aliases: ["dr"],
@@ -177,6 +272,29 @@ async function parseCliArgs(args = process.argv.slice(2)) {
 			if (!(val in require_scaffold.LogLevel)) throw new Error(`Invalid log level: ${val}, must be one of: ${Object.keys(require_scaffold.LogLevel).join(", ")}`);
 			return val;
 		}
+	}).help({ bindOption: true })).command(new massarg_command.MassargCommand({
+		name: "init",
+		aliases: [],
+		description: "Initialize a new scaffold config file and example template in the current directory.",
+		run: async (config) => {
+			try {
+				await initScaffold({
+					dir: config.dir,
+					format: config.format
+				});
+			} catch (e) {
+				const message = "message" in e ? e.message : e?.toString();
+				console.error(require_scaffold.colorize.red(message ?? "Unknown error"));
+			}
+		}
+	}).option({
+		name: "dir",
+		aliases: ["d"],
+		description: "Directory to create the config in. Defaults to current working directory."
+	}).option({
+		name: "format",
+		aliases: ["f"],
+		description: "Config file format: js, mjs, or json. If omitted, you will be prompted."
 	}).help({ bindOption: true })).example({
 		description: "Usage with config file",
 		input: "simple-scaffold -c scaffold.cmd.js --key component"

package/cmd.js.map

@@ -1 +1 @@
-{"version":3,"file":"cmd.js","names":[],"sources":["../src/cmd.ts"],"sourcesContent":["#!/usr/bin/env node\n\nimport path from \"node:path\"\nimport fs from \"node:fs/promises\"\nimport { massarg } from \"massarg\"\nimport { ListCommandCliOptions, LogLevel, ScaffoldCmdConfig, ScaffoldConfigMap } from \"./types\"\nimport { Scaffold } from \"./scaffold\"\nimport { findConfigFile, getConfigFile, parseAppendData, parseConfigFile } from \"./config\"\nimport { log } from \"./logger\"\nimport { MassargCommand } from \"massarg/command\"\nimport { getUniqueTmpPath as generateUniqueTmpPath } from \"./file\"\nimport { colorize } from \"./colors\"\nimport { promptForMissingConfig, resolveInputs } from \"./prompts\"\n\nexport async function parseCliArgs(args = process.argv.slice(2)) {\n  const isProjectRoot = Boolean(await fs.stat(path.join(__dirname, \"package.json\")).catch(() => false))\n  const pkgFile = await fs.readFile(path.resolve(__dirname, isProjectRoot ? \".\" : \"..\", \"package.json\"))\n  const pkg = JSON.parse(pkgFile.toString())\n  const isVersionFlag = args.includes(\"--version\") || args.includes(\"-v\")\n  const isConfigFileProvided = args.includes(\"--config\") || args.includes(\"-c\")\n  const isGitProvided = args.includes(\"--git\") || args.includes(\"-g\")\n  const isConfigProvided = isConfigFileProvided || isGitProvided || isVersionFlag\n\n  return massarg<ScaffoldCmdConfig>({\n    name: pkg.name,\n    description: pkg.description,\n  })\n    .main(async (config) => {\n      if (config.version) {\n        console.log(pkg.version)\n        return\n      }\n      log(config, LogLevel.info, `Simple Scaffold v${pkg.version}`)\n      config.tmpDir = generateUniqueTmpPath()\n      try {\n        // Auto-detect config file in cwd if not explicitly provided\n        if (!config.config && !config.git) {\n          try {\n            config.config = await findConfigFile(process.cwd())\n            log(config, LogLevel.debug, `Auto-detected config file: ${config.config}`)\n          } catch {\n            // No config file found — that's fine, continue without one\n          }\n        }\n\n        // Load config early so we can prompt for template key\n        const hasConfigSource = Boolean(config.config || config.git)\n        let configMap: ScaffoldConfigMap | undefined\n        if (hasConfigSource) {\n          configMap = await getConfigFile(config)\n        }\n\n        // Prompt for missing values interactively\n        config = await promptForMissingConfig(config, configMap)\n\n        log(config, LogLevel.debug, \"Parsing config file...\", config)\n        const parsed = await parseConfigFile(config)\n        const resolved = await resolveInputs(parsed)\n        await Scaffold(resolved)\n      } catch (e) {\n        const message = \"message\" in (e as object) ? (e as Error).message : e?.toString()\n        log(config, LogLevel.error, message)\n      } finally {\n        log(config, LogLevel.debug, \"Cleaning up temporary files...\", config.tmpDir)\n        if (config.tmpDir) await fs.rm(config.tmpDir, { recursive: true, force: true })\n      }\n    })\n    .option({\n      name: \"name\",\n      aliases: [\"n\"],\n      description:\n        \"Name to be passed to the generated files. `{{name}}` and other data parameters inside \" +\n        \"contents and file names will be replaced accordingly. You may omit the `--name` or `-n` \" +\n        \"for this specific option. If omitted in an interactive terminal, you will be prompted.\",\n      isDefault: true,\n    })\n    .option({\n      name: \"config\",\n      aliases: [\"c\"],\n      description: \"Filename or directory to load config from\",\n    })\n    .option({\n      name: \"git\",\n      aliases: [\"g\"],\n      description: \"Git URL or GitHub path to load a template from.\",\n    })\n    .option({\n      name: \"key\",\n      aliases: [\"k\"],\n      description:\n        \"Key to load inside the config file. This overwrites the config key provided after the colon in `--config` \" +\n        \"(e.g. `--config scaffold.cmd.js:component)`. If omitted and multiple templates are available, \" +\n        \"you will be prompted to select one.\",\n    })\n    .option({\n      name: \"output\",\n      aliases: [\"o\"],\n      description:\n        \"Path to output to. If `--subdir` is enabled, the subdir will be created inside \" +\n        \"this path. If omitted in an interactive terminal, you will be prompted.\",\n    })\n    .option({\n      name: \"templates\",\n      aliases: [\"t\"],\n      array: true,\n      description:\n        \"Template files to use as input. You may provide multiple files, each of which can be a relative or \" +\n        \"absolute path, \" +\n        \"or a glob pattern for multiple file matching easily. If omitted in an interactive terminal, \" +\n        \"you will be prompted for a comma-separated list.\",\n    })\n    .flag({\n      name: \"overwrite\",\n      aliases: [\"w\"],\n      defaultValue: false,\n      description: \"Enable to override output files, even if they already exist.\",\n      negatable: true,\n    })\n    .option({\n      name: \"data\",\n      aliases: [\"d\"],\n      description: \"Add custom data to the templates. By default, only your app name is included.\",\n      parse: (v) => JSON.parse(v),\n    })\n    .option({\n      name: \"append-data\",\n      aliases: [\"D\"],\n      description:\n        \"Append additional custom data to the templates, which will overwrite `--data`, using an alternate syntax, \" +\n        \"which is easier to use with CLI: `-D key1=string -D key2:=raw`\",\n      parse: parseAppendData,\n    })\n    .flag({\n      name: \"subdir\",\n      aliases: [\"s\"],\n      defaultValue: false,\n      description: \"Create a parent directory with the input name (and possibly `--subdir-helper`\",\n      negatable: true,\n      negationName: \"no-subdir\",\n    })\n    .option({\n      name: \"subdir-helper\",\n      aliases: [\"H\"],\n      description: \"Default helper to apply to subdir name when using `--subdir`.\",\n    })\n    .flag({\n      name: \"quiet\",\n      aliases: [\"q\"],\n      defaultValue: false,\n      description: \"Suppress output logs (Same as `--log-level none`)\",\n    })\n    .option({\n      name: \"log-level\",\n      aliases: [\"l\"],\n      defaultValue: LogLevel.info,\n      description:\n        \"Determine amount of logs to display. The values are: \" +\n        `${colorize.bold`\\`none | debug | info | warn | error\\``}. ` +\n        \"The provided level will display messages of the same level or higher.\",\n      parse: (v) => {\n        const val = v.toLowerCase()\n        if (!(val in LogLevel)) {\n          throw new Error(`Invalid log level: ${val}, must be one of: ${Object.keys(LogLevel).join(\", \")}`)\n        }\n        return val\n      },\n    })\n    .option({\n      name: \"before-write\",\n      aliases: [\"B\"],\n      description:\n        \"Run a script before writing the files. This can be a command or a path to a\" +\n        \" file. A temporary file path will be passed to the given command and the command should \" +\n        \"return a string for the final output.\",\n    })\n    .flag({\n      name: \"dry-run\",\n      aliases: [\"dr\"],\n      defaultValue: false,\n      description:\n        \"Don't emit files. This is good for testing your scaffolds and making sure they \" +\n        \"don't fail, without having to write actual file contents or create directories.\",\n    })\n    .flag({\n      name: \"version\",\n      aliases: [\"v\"],\n      description: \"Display version.\",\n    })\n    .command(\n      new MassargCommand<ListCommandCliOptions>({\n        name: \"list\",\n        aliases: [\"ls\"],\n        description: \"List all available templates for a given config. See `list -h` for more information.\",\n        run: async (_config) => {\n          const config = {\n            templates: [],\n            name: \"\",\n            version: false,\n            output: \"\",\n            subdir: false,\n            overwrite: false,\n            dryRun: false,\n            tmpDir: generateUniqueTmpPath(),\n            ..._config,\n            config: _config.config ?? (!_config.git ? process.cwd() : undefined),\n          }\n          try {\n            const file = await getConfigFile(config)\n            console.log(colorize.underline`Available templates:\\n`)\n            console.log(Object.keys(file).join(\"\\n\"))\n          } catch (e) {\n            const message = \"message\" in (e as object) ? (e as Error).message : e?.toString()\n            log(config, LogLevel.error, message)\n          } finally {\n            log(config, LogLevel.debug, \"Cleaning up temporary files...\", config.tmpDir)\n            if (config.tmpDir) await fs.rm(config.tmpDir, { recursive: true, force: true })\n          }\n        },\n      })\n        .option({\n          name: \"config\",\n          aliases: [\"c\"],\n          description: \"Filename or directory to load config from. Defaults to current working directory.\",\n        })\n        .option({\n          name: \"git\",\n          aliases: [\"g\"],\n          description: \"Git URL or GitHub path to load a template from.\",\n        })\n        .option({\n          name: \"log-level\",\n          aliases: [\"l\"],\n          defaultValue: LogLevel.none,\n          description:\n            \"Determine amount of logs to display. The values are: \" +\n            `${colorize.bold`\\`none | debug | info | warn | error\\``}. ` +\n            \"The provided level will display messages of the same level or higher.\",\n          parse: (v) => {\n            const val = v.toLowerCase()\n            if (!(val in LogLevel)) {\n              throw new Error(`Invalid log level: ${val}, must be one of: ${Object.keys(LogLevel).join(\", \")}`)\n            }\n            return val\n          },\n        })\n        .help({\n          bindOption: true,\n        }),\n    )\n    .example({\n      description: \"Usage with config file\",\n      input: \"simple-scaffold -c scaffold.cmd.js --key component\",\n    })\n    .example({\n      description: \"Usage with GitHub config file\",\n      input: \"simple-scaffold -g chenasraf/simple-scaffold --key component\",\n    })\n    .example({\n      description: \"Usage with https git URL (for non-GitHub)\",\n      input: \"simple-scaffold -g https://example.com/user/template.git -c scaffold.cmd.js --key component\",\n    })\n    .example({\n      description: \"Excluded template key, assumes 'default' key\",\n      input: \"simple-scaffold -c scaffold.cmd.js MyComponent\",\n    })\n    .example({\n      description:\n        \"Shortest syntax for GitHub, searches for config file automaticlly, assumes and template key 'default'\",\n      input: \"simple-scaffold -g chenasraf/simple-scaffold MyComponent\",\n    })\n    .help({\n      bindOption: true,\n      lineLength: 100,\n      useGlobalTableColumns: true,\n      usageText: [colorize.yellow`simple-scaffold`, colorize.gray`[options]`, colorize.cyan`<name>`].join(\" \"),\n      optionOptions: {\n        displayNegations: true,\n      },\n      footerText: [\n        `Version:  ${pkg.version}`,\n        `Copyright © Chen Asraf 2017-${new Date().getFullYear()}`,\n        ``,\n        `Documentation:  ${colorize.underline`https://chenasraf.github.io/simple-scaffold`}`,\n        `NPM:  ${colorize.underline`https://npmjs.com/package/simple-scaffold`}`,\n        `GitHub:  ${colorize.underline`https://github.com/chenasraf/simple-scaffold`}`,\n      ].join(\"\\n\"),\n    })\n    .parse(args)\n}\n\nparseCliArgs()\n"],"mappings":";;;;;;;;;;AAcA,eAAsB,aAAa,OAAO,QAAQ,KAAK,MAAM,EAAE,EAAE;CAC/D,MAAM,gBAAgB,QAAQ,MAAM,iBAAA,QAAG,KAAK,UAAA,QAAK,KAAK,WAAW,eAAe,CAAC,CAAC,YAAY,MAAM,CAAC;CACrG,MAAM,UAAU,MAAM,iBAAA,QAAG,SAAS,UAAA,QAAK,QAAQ,WAAW,gBAAgB,MAAM,MAAM,eAAe,CAAC;CACtG,MAAM,MAAM,KAAK,MAAM,QAAQ,UAAU,CAAC;AACpB,MAAK,SAAS,YAAY,IAAI,KAAK,SAAS,KAAK;AAC1C,MAAK,SAAS,WAAW,IAAI,KAAK,SAAS,KAAK;AACvD,MAAK,SAAS,QAAQ,IAAI,KAAK,SAAS,KAAK;AAGnE,SAAA,GAAA,QAAA,SAAkC;EAChC,MAAM,IAAI;EACV,aAAa,IAAI;EAClB,CAAC,CACC,KAAK,OAAO,WAAW;AACtB,MAAI,OAAO,SAAS;AAClB,WAAQ,IAAI,IAAI,QAAQ;AACxB;;AAEF,mBAAA,IAAI,QAAQ,iBAAA,SAAS,MAAM,oBAAoB,IAAI,UAAU;AAC7D,SAAO,SAAS,iBAAA,kBAAuB;AACvC,MAAI;AAEF,OAAI,CAAC,OAAO,UAAU,CAAC,OAAO,IAC5B,KAAI;AACF,WAAO,SAAS,MAAM,iBAAA,eAAe,QAAQ,KAAK,CAAC;AACnD,qBAAA,IAAI,QAAQ,iBAAA,SAAS,OAAO,8BAA8B,OAAO,SAAS;WACpE;GAMV,MAAM,kBAAkB,QAAQ,OAAO,UAAU,OAAO,IAAI;GAC5D,IAAI;AACJ,OAAI,gBACF,aAAY,MAAM,iBAAA,cAAc,OAAO;AAIzC,YAAS,MAAM,iBAAA,uBAAuB,QAAQ,UAAU;AAExD,oBAAA,IAAI,QAAQ,iBAAA,SAAS,OAAO,0BAA0B,OAAO;AAG7D,SAAM,iBAAA,SADW,MAAM,iBAAA,cADR,MAAM,iBAAA,gBAAgB,OAAO,CACA,CACpB;WACjB,GAAG;GACV,MAAM,UAAU,aAAc,IAAgB,EAAY,UAAU,GAAG,UAAU;AACjF,oBAAA,IAAI,QAAQ,iBAAA,SAAS,OAAO,QAAQ;YAC5B;AACR,oBAAA,IAAI,QAAQ,iBAAA,SAAS,OAAO,kCAAkC,OAAO,OAAO;AAC5E,OAAI,OAAO,OAAQ,OAAM,iBAAA,QAAG,GAAG,OAAO,QAAQ;IAAE,WAAW;IAAM,OAAO;IAAM,CAAC;;GAEjF,CACD,OAAO;EACN,MAAM;EACN,SAAS,CAAC,IAAI;EACd,aACE;EAGF,WAAW;EACZ,CAAC,CACD,OAAO;EACN,MAAM;EACN,SAAS,CAAC,IAAI;EACd,aAAa;EACd,CAAC,CACD,OAAO;EACN,MAAM;EACN,SAAS,CAAC,IAAI;EACd,aAAa;EACd,CAAC,CACD,OAAO;EACN,MAAM;EACN,SAAS,CAAC,IAAI;EACd,aACE;EAGH,CAAC,CACD,OAAO;EACN,MAAM;EACN,SAAS,CAAC,IAAI;EACd,aACE;EAEH,CAAC,CACD,OAAO;EACN,MAAM;EACN,SAAS,CAAC,IAAI;EACd,OAAO;EACP,aACE;EAIH,CAAC,CACD,KAAK;EACJ,MAAM;EACN,SAAS,CAAC,IAAI;EACd,cAAc;EACd,aAAa;EACb,WAAW;EACZ,CAAC,CACD,OAAO;EACN,MAAM;EACN,SAAS,CAAC,IAAI;EACd,aAAa;EACb,QAAQ,MAAM,KAAK,MAAM,EAAE;EAC5B,CAAC,CACD,OAAO;EACN,MAAM;EACN,SAAS,CAAC,IAAI;EACd,aACE;EAEF,OAAO,iBAAA;EACR,CAAC,CACD,KAAK;EACJ,MAAM;EACN,SAAS,CAAC,IAAI;EACd,cAAc;EACd,aAAa;EACb,WAAW;EACX,cAAc;EACf,CAAC,CACD,OAAO;EACN,MAAM;EACN,SAAS,CAAC,IAAI;EACd,aAAa;EACd,CAAC,CACD,KAAK;EACJ,MAAM;EACN,SAAS,CAAC,IAAI;EACd,cAAc;EACd,aAAa;EACd,CAAC,CACD,OAAO;EACN,MAAM;EACN,SAAS,CAAC,IAAI;EACd,cAAc,iBAAA,SAAS;EACvB,aACE,wDACG,iBAAA,SAAS,IAAI,yCAAyC;EAE3D,QAAQ,MAAM;GACZ,MAAM,MAAM,EAAE,aAAa;AAC3B,OAAI,EAAE,OAAO,iBAAA,UACX,OAAM,IAAI,MAAM,sBAAsB,IAAI,oBAAoB,OAAO,KAAK,iBAAA,SAAS,CAAC,KAAK,KAAK,GAAG;AAEnG,UAAO;;EAEV,CAAC,CACD,OAAO;EACN,MAAM;EACN,SAAS,CAAC,IAAI;EACd,aACE;EAGH,CAAC,CACD,KAAK;EACJ,MAAM;EACN,SAAS,CAAC,KAAK;EACf,cAAc;EACd,aACE;EAEH,CAAC,CACD,KAAK;EACJ,MAAM;EACN,SAAS,CAAC,IAAI;EACd,aAAa;EACd,CAAC,CACD,QACC,IAAI,gBAAA,eAAsC;EACxC,MAAM;EACN,SAAS,CAAC,KAAK;EACf,aAAa;EACb,KAAK,OAAO,YAAY;GACtB,MAAM,SAAS;IACb,WAAW,EAAE;IACb,MAAM;IACN,SAAS;IACT,QAAQ;IACR,QAAQ;IACR,WAAW;IACX,QAAQ;IACR,QAAQ,iBAAA,kBAAuB;IAC/B,GAAG;IACH,QAAQ,QAAQ,WAAW,CAAC,QAAQ,MAAM,QAAQ,KAAK,GAAG,KAAA;IAC3D;AACD,OAAI;IACF,MAAM,OAAO,MAAM,iBAAA,cAAc,OAAO;AACxC,YAAQ,IAAI,iBAAA,SAAS,SAAS,yBAAyB;AACvD,YAAQ,IAAI,OAAO,KAAK,KAAK,CAAC,KAAK,KAAK,CAAC;YAClC,GAAG;IACV,MAAM,UAAU,aAAc,IAAgB,EAAY,UAAU,GAAG,UAAU;AACjF,qBAAA,IAAI,QAAQ,iBAAA,SAAS,OAAO,QAAQ;aAC5B;AACR,qBAAA,IAAI,QAAQ,iBAAA,SAAS,OAAO,kCAAkC,OAAO,OAAO;AAC5E,QAAI,OAAO,OAAQ,OAAM,iBAAA,QAAG,GAAG,OAAO,QAAQ;KAAE,WAAW;KAAM,OAAO;KAAM,CAAC;;;EAGpF,CAAC,CACC,OAAO;EACN,MAAM;EACN,SAAS,CAAC,IAAI;EACd,aAAa;EACd,CAAC,CACD,OAAO;EACN,MAAM;EACN,SAAS,CAAC,IAAI;EACd,aAAa;EACd,CAAC,CACD,OAAO;EACN,MAAM;EACN,SAAS,CAAC,IAAI;EACd,cAAc,iBAAA,SAAS;EACvB,aACE,wDACG,iBAAA,SAAS,IAAI,yCAAyC;EAE3D,QAAQ,MAAM;GACZ,MAAM,MAAM,EAAE,aAAa;AAC3B,OAAI,EAAE,OAAO,iBAAA,UACX,OAAM,IAAI,MAAM,sBAAsB,IAAI,oBAAoB,OAAO,KAAK,iBAAA,SAAS,CAAC,KAAK,KAAK,GAAG;AAEnG,UAAO;;EAEV,CAAC,CACD,KAAK,EACJ,YAAY,MACb,CAAC,CACL,CACA,QAAQ;EACP,aAAa;EACb,OAAO;EACR,CAAC,CACD,QAAQ;EACP,aAAa;EACb,OAAO;EACR,CAAC,CACD,QAAQ;EACP,aAAa;EACb,OAAO;EACR,CAAC,CACD,QAAQ;EACP,aAAa;EACb,OAAO;EACR,CAAC,CACD,QAAQ;EACP,aACE;EACF,OAAO;EACR,CAAC,CACD,KAAK;EACJ,YAAY;EACZ,YAAY;EACZ,uBAAuB;EACvB,WAAW;GAAC,iBAAA,SAAS,MAAM;GAAmB,iBAAA,SAAS,IAAI;GAAa,iBAAA,SAAS,IAAI;GAAS,CAAC,KAAK,IAAI;EACxG,eAAe,EACb,kBAAkB,MACnB;EACD,YAAY;GACV,aAAa,IAAI;GACjB,gDAA+B,IAAI,MAAM,EAAC,aAAa;GACvD;GACA,mBAAmB,iBAAA,SAAS,SAAS;GACrC,SAAS,iBAAA,SAAS,SAAS;GAC3B,YAAY,iBAAA,SAAS,SAAS;GAC/B,CAAC,KAAK,KAAK;EACb,CAAC,CACD,MAAM,KAAK;;AAGhB,cAAc"}
+{"version":3,"file":"cmd.js","names":[],"sources":["../src/init.ts","../src/cmd.ts"],"sourcesContent":["import path from \"node:path\"\nimport fs from \"node:fs/promises\"\nimport select from \"@inquirer/select\"\nimport { colorize } from \"./colors\"\nimport { pathExists } from \"./fs-utils\"\n\nconst CONFIG_EXTENSIONS = {\n  js: \"scaffold.config.js\",\n  mjs: \"scaffold.config.mjs\",\n  json: \"scaffold.config.json\",\n} as const\n\ntype ConfigFormat = keyof typeof CONFIG_EXTENSIONS\n\nconst CONFIG_TEMPLATES: Record<ConfigFormat, string> = {\n  js: `/** @type {import('simple-scaffold').ScaffoldConfigMap} */\nmodule.exports = {\n  default: {\n    templates: [\"templates/default\"],\n    output: \".\",\n    // inputs: {\n    //   author: { message: \"Author name\", required: true },\n    //   license: { message: \"License\", default: \"MIT\" },\n    // },\n  },\n}\n`,\n  mjs: `/** @type {import('simple-scaffold').ScaffoldConfigMap} */\nexport default {\n  default: {\n    templates: [\"templates/default\"],\n    output: \".\",\n    // inputs: {\n    //   author: { message: \"Author name\", required: true },\n    //   license: { message: \"License\", default: \"MIT\" },\n    // },\n  },\n}\n`,\n  json: `{\n  \"default\": {\n    \"templates\": [\"templates/default\"],\n    \"output\": \".\"\n  }\n}\n`,\n}\n\nconst EXAMPLE_TEMPLATE_CONTENT = `# {{ name }}\n\nCreated by Simple Scaffold.\n\n{{#if description}}{{ description }}{{/if}}\n`\n\nexport interface InitOptions {\n  /** Working directory to create the config in. Defaults to cwd. */\n  dir?: string\n  /** Config format to use. If not provided, the user is prompted. */\n  format?: ConfigFormat\n  /** Whether to create an example template directory. Defaults to true. */\n  createExample?: boolean\n}\n\n/**\n * Initializes a new Simple Scaffold project by creating a config file\n * and an optional example template directory.\n */\nexport async function initScaffold(options: InitOptions = {}): Promise<void> {\n  const dir = options.dir ?? process.cwd()\n\n  const format =\n    options.format ??\n    (await select<ConfigFormat>({\n      message: colorize.cyan(\"Config file format:\"),\n      choices: [\n        { name: \"JavaScript (CommonJS)\", value: \"js\" },\n        { name: \"JavaScript (ESM)\", value: \"mjs\" },\n        { name: \"JSON\", value: \"json\" },\n      ],\n    }))\n\n  const filename = CONFIG_EXTENSIONS[format]\n  const configPath = path.resolve(dir, filename)\n\n  if (await pathExists(configPath)) {\n    console.log(colorize.yellow(`${filename} already exists, skipping config creation.`))\n  } else {\n    await fs.writeFile(configPath, CONFIG_TEMPLATES[format])\n    console.log(colorize.green(`Created ${filename}`))\n  }\n\n  const createExample = options.createExample ?? true\n  if (createExample) {\n    const templateDir = path.resolve(dir, \"templates\", \"default\")\n    const templateFile = path.join(templateDir, \"{{name}}.md\")\n\n    if (await pathExists(templateDir)) {\n      console.log(colorize.yellow(\"templates/default/ already exists, skipping example template.\"))\n    } else {\n      await fs.mkdir(templateDir, { recursive: true })\n      await fs.writeFile(templateFile, EXAMPLE_TEMPLATE_CONTENT)\n      console.log(colorize.green(\"Created templates/default/{{name}}.md\"))\n    }\n  }\n\n  console.log()\n  console.log(colorize.dim(\"Get started:\"))\n  console.log(colorize.dim(`  npx simple-scaffold MyProject`))\n  console.log()\n}\n","#!/usr/bin/env node\n\nimport path from \"node:path\"\nimport fs from \"node:fs/promises\"\nimport { massarg } from \"massarg\"\nimport { ListCommandCliOptions, LogLevel, ScaffoldCmdConfig, ScaffoldConfigMap } from \"./types\"\nimport { Scaffold } from \"./scaffold\"\nimport { findConfigFile, getConfigFile, parseAppendData, parseConfigFile } from \"./config\"\nimport { log } from \"./logger\"\nimport { MassargCommand } from \"massarg/command\"\nimport { getUniqueTmpPath as generateUniqueTmpPath } from \"./file\"\nimport { colorize } from \"./colors\"\nimport { promptBeforeConfig, promptAfterConfig, resolveInputs } from \"./prompts\"\nimport { initScaffold } from \"./init\"\n\nexport async function parseCliArgs(args = process.argv.slice(2)) {\n  const isProjectRoot = Boolean(\n    await fs.stat(path.join(__dirname, \"package.json\")).catch(() => false),\n  )\n  const pkgFile = await fs.readFile(\n    path.resolve(__dirname, isProjectRoot ? \".\" : \"..\", \"package.json\"),\n  )\n  const pkg = JSON.parse(pkgFile.toString())\n  return massarg<ScaffoldCmdConfig>({\n    name: pkg.name,\n    description: pkg.description,\n  })\n    .main(async (config) => {\n      if (config.version) {\n        console.log(pkg.version)\n        return\n      }\n      log(config, LogLevel.debug, `Simple Scaffold v${pkg.version}`)\n      config.tmpDir = generateUniqueTmpPath()\n      try {\n        // Auto-detect config file in cwd — but only if the user didn't\n        // explicitly provide templates/output (which signals a one-time run)\n        const isOneTimeRun = config.templates?.length > 0 || config.output\n        if (!config.config && !config.git && !isOneTimeRun) {\n          try {\n            config.config = await findConfigFile(process.cwd())\n            log(config, LogLevel.debug, `Auto-detected config file: ${config.config}`)\n          } catch {\n            // No config file found — that's fine, continue without one\n          }\n        }\n\n        // Load config map early so we can prompt for name and template key\n        const hasConfigSource = Boolean(config.config || config.git)\n        let configMap: ScaffoldConfigMap | undefined\n        if (hasConfigSource) {\n          configMap = await getConfigFile(config)\n        }\n\n        // Phase 1: prompt for name + key (needed before parseConfigFile)\n        config = await promptBeforeConfig(config, configMap)\n\n        // Parse and merge the config file\n        log(config, LogLevel.debug, \"Parsing config file...\", config)\n        const parsed = await parseConfigFile(config)\n\n        // Phase 2: prompt for anything still missing after config merge\n        const prompted = await promptAfterConfig(parsed)\n\n        const resolved = await resolveInputs(prompted)\n        await Scaffold(resolved)\n      } catch (e) {\n        const message = \"message\" in (e as object) ? (e as Error).message : e?.toString()\n        log(config, LogLevel.error, message)\n      } finally {\n        log(config, LogLevel.debug, \"Cleaning up temporary files...\", config.tmpDir)\n        if (config.tmpDir) await fs.rm(config.tmpDir, { recursive: true, force: true })\n      }\n    })\n    .option({\n      name: \"name\",\n      aliases: [\"n\"],\n      description:\n        \"Name to be passed to the generated files. `{{name}}` and other data parameters inside \" +\n        \"contents and file names will be replaced accordingly. You may omit the `--name` or `-n` \" +\n        \"for this specific option. If omitted in an interactive terminal, you will be prompted.\",\n      isDefault: true,\n    })\n    .option({\n      name: \"config\",\n      aliases: [\"c\"],\n      description: \"Filename or directory to load config from\",\n    })\n    .option({\n      name: \"git\",\n      aliases: [\"g\"],\n      description: \"Git URL or GitHub path to load a template from.\",\n    })\n    .option({\n      name: \"key\",\n      aliases: [\"k\"],\n      description:\n        \"Key to load inside the config file. This overwrites the config key provided after the colon in `--config` \" +\n        \"(e.g. `--config scaffold.cmd.js:component)`. If omitted and multiple templates are available, \" +\n        \"you will be prompted to select one.\",\n    })\n    .option({\n      name: \"output\",\n      aliases: [\"o\"],\n      description:\n        \"Path to output to. If `--subdir` is enabled, the subdir will be created inside \" +\n        \"this path. If omitted in an interactive terminal, you will be prompted.\",\n    })\n    .option({\n      name: \"templates\",\n      aliases: [\"t\"],\n      array: true,\n      description:\n        \"Template files to use as input. You may provide multiple files, each of which can be a relative or \" +\n        \"absolute path, \" +\n        \"or a glob pattern for multiple file matching easily. If omitted in an interactive terminal, \" +\n        \"you will be prompted for a comma-separated list.\",\n    })\n    .flag({\n      name: \"overwrite\",\n      aliases: [\"w\"],\n      defaultValue: false,\n      description: \"Enable to override output files, even if they already exist.\",\n      negatable: true,\n    })\n    .option({\n      name: \"data\",\n      aliases: [\"d\"],\n      description: \"Add custom data to the templates. By default, only your app name is included.\",\n      parse: (v) => JSON.parse(v),\n    })\n    .option({\n      name: \"append-data\",\n      aliases: [\"D\"],\n      description:\n        \"Append additional custom data to the templates, which will overwrite `--data`, using an alternate syntax, \" +\n        \"which is easier to use with CLI: `-D key1=string -D key2:=raw`\",\n      parse: parseAppendData,\n    })\n    .flag({\n      name: \"subdir\",\n      aliases: [\"s\"],\n      defaultValue: false,\n      description: \"Create a parent directory with the input name (and possibly `--subdir-helper`\",\n      negatable: true,\n      negationName: \"no-subdir\",\n    })\n    .option({\n      name: \"subdir-helper\",\n      aliases: [\"H\"],\n      description: \"Default helper to apply to subdir name when using `--subdir`.\",\n    })\n    .flag({\n      name: \"quiet\",\n      aliases: [\"q\"],\n      defaultValue: false,\n      description: \"Suppress output logs (Same as `--log-level none`)\",\n    })\n    .option({\n      name: \"log-level\",\n      aliases: [\"l\"],\n      defaultValue: LogLevel.info,\n      description:\n        \"Determine amount of logs to display. The values are: \" +\n        `${colorize.bold`\\`none | debug | info | warn | error\\``}. ` +\n        \"The provided level will display messages of the same level or higher.\",\n      parse: (v) => {\n        const val = v.toLowerCase()\n        if (!(val in LogLevel)) {\n          throw new Error(\n            `Invalid log level: ${val}, must be one of: ${Object.keys(LogLevel).join(\", \")}`,\n          )\n        }\n        return val\n      },\n    })\n    .option({\n      name: \"before-write\",\n      aliases: [\"B\"],\n      description:\n        \"Run a script before writing the files. This can be a command or a path to a\" +\n        \" file. A temporary file path will be passed to the given command and the command should \" +\n        \"return a string for the final output.\",\n    })\n    .option({\n      name: \"after-scaffold\",\n      aliases: [\"A\"],\n      description:\n        \"Run a shell command after all files have been written. \" +\n        \"The command is executed in the output directory. \" +\n        \"For example: `--after-scaffold 'npm install'`\",\n    })\n    .flag({\n      name: \"dry-run\",\n      aliases: [\"dr\"],\n      defaultValue: false,\n      description:\n        \"Don't emit files. This is good for testing your scaffolds and making sure they \" +\n        \"don't fail, without having to write actual file contents or create directories.\",\n    })\n    .flag({\n      name: \"version\",\n      aliases: [\"v\"],\n      description: \"Display version.\",\n    })\n    .command(\n      new MassargCommand<ListCommandCliOptions>({\n        name: \"list\",\n        aliases: [\"ls\"],\n        description:\n          \"List all available templates for a given config. See `list -h` for more information.\",\n        run: async (_config) => {\n          const config = {\n            templates: [],\n            name: \"\",\n            version: false,\n            output: \"\",\n            subdir: false,\n            overwrite: false,\n            dryRun: false,\n            tmpDir: generateUniqueTmpPath(),\n            ..._config,\n            config: _config.config ?? (!_config.git ? process.cwd() : undefined),\n          }\n          try {\n            const file = await getConfigFile(config)\n            console.log(colorize.underline`Available templates:\\n`)\n            console.log(Object.keys(file).join(\"\\n\"))\n          } catch (e) {\n            const message = \"message\" in (e as object) ? (e as Error).message : e?.toString()\n            log(config, LogLevel.error, message)\n          } finally {\n            log(config, LogLevel.debug, \"Cleaning up temporary files...\", config.tmpDir)\n            if (config.tmpDir) await fs.rm(config.tmpDir, { recursive: true, force: true })\n          }\n        },\n      })\n        .option({\n          name: \"config\",\n          aliases: [\"c\"],\n          description:\n            \"Filename or directory to load config from. Defaults to current working directory.\",\n        })\n        .option({\n          name: \"git\",\n          aliases: [\"g\"],\n          description: \"Git URL or GitHub path to load a template from.\",\n        })\n        .option({\n          name: \"log-level\",\n          aliases: [\"l\"],\n          defaultValue: LogLevel.none,\n          description:\n            \"Determine amount of logs to display. The values are: \" +\n            `${colorize.bold`\\`none | debug | info | warn | error\\``}. ` +\n            \"The provided level will display messages of the same level or higher.\",\n          parse: (v) => {\n            const val = v.toLowerCase()\n            if (!(val in LogLevel)) {\n              throw new Error(\n                `Invalid log level: ${val}, must be one of: ${Object.keys(LogLevel).join(\", \")}`,\n              )\n            }\n            return val\n          },\n        })\n        .help({\n          bindOption: true,\n        }),\n    )\n    .command(\n      new MassargCommand<{ dir?: string; format?: string }>({\n        name: \"init\",\n        aliases: [],\n        description:\n          \"Initialize a new scaffold config file and example template in the current directory.\",\n        run: async (config) => {\n          try {\n            await initScaffold({\n              dir: config.dir,\n              format: config.format as \"js\" | \"mjs\" | \"json\" | undefined,\n            })\n          } catch (e) {\n            const message = \"message\" in (e as object) ? (e as Error).message : e?.toString()\n            console.error(colorize.red(message ?? \"Unknown error\"))\n          }\n        },\n      })\n        .option({\n          name: \"dir\",\n          aliases: [\"d\"],\n          description: \"Directory to create the config in. Defaults to current working directory.\",\n        })\n        .option({\n          name: \"format\",\n          aliases: [\"f\"],\n          description: \"Config file format: js, mjs, or json. If omitted, you will be prompted.\",\n        })\n        .help({\n          bindOption: true,\n        }),\n    )\n    .example({\n      description: \"Usage with config file\",\n      input: \"simple-scaffold -c scaffold.cmd.js --key component\",\n    })\n    .example({\n      description: \"Usage with GitHub config file\",\n      input: \"simple-scaffold -g chenasraf/simple-scaffold --key component\",\n    })\n    .example({\n      description: \"Usage with https git URL (for non-GitHub)\",\n      input:\n        \"simple-scaffold -g https://example.com/user/template.git -c scaffold.cmd.js --key component\",\n    })\n    .example({\n      description: \"Excluded template key, assumes 'default' key\",\n      input: \"simple-scaffold -c scaffold.cmd.js MyComponent\",\n    })\n    .example({\n      description:\n        \"Shortest syntax for GitHub, searches for config file automaticlly, assumes and template key 'default'\",\n      input: \"simple-scaffold -g chenasraf/simple-scaffold MyComponent\",\n    })\n    .help({\n      bindOption: true,\n      lineLength: 100,\n      useGlobalTableColumns: true,\n      usageText: [\n        colorize.yellow`simple-scaffold`,\n        colorize.gray`[options]`,\n        colorize.cyan`<name>`,\n      ].join(\" \"),\n      optionOptions: {\n        displayNegations: true,\n      },\n      footerText: [\n        `Version:  ${pkg.version}`,\n        `Copyright © Chen Asraf 2017-${new Date().getFullYear()}`,\n        ``,\n        `Documentation:  ${colorize.underline`https://chenasraf.github.io/simple-scaffold`}`,\n        `NPM:  ${colorize.underline`https://npmjs.com/package/simple-scaffold`}`,\n        `GitHub:  ${colorize.underline`https://github.com/chenasraf/simple-scaffold`}`,\n      ].join(\"\\n\"),\n    })\n    .parse(args)\n}\n\nparseCliArgs()\n"],"mappings":"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"}

package/file.d.ts

@@ -52,8 +52,9 @@ export declare function getOutputDir(config: ScaffoldConfig, outputPathOpt: stri
 /**
  * Processes a single template file: resolves output paths, creates directories,
  * and writes the transformed output.
+ * Returns the output path if the file was written, or null if skipped.
  */
 export declare function handleTemplateFile(config: ScaffoldConfig, { templatePath, basePath }: {
     templatePath: string;
     basePath: string;
-}): Promise<void>;
+}): Promise<string | null>;

package/ignore.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Reads a `.scaffoldignore` file from the given directory and returns
+ * the parsed patterns for filtering.
+ *
+ * Lines starting with `#` are comments. Empty lines are skipped.
+ *
+ * @param dir The directory to search for `.scaffoldignore`
+ * @returns Array of glob patterns to ignore
+ */
+export declare function loadIgnorePatterns(dir: string): Promise<string[]>;
+/**
+ * Parses the contents of a `.scaffoldignore` file into glob patterns.
+ * @internal
+ */
+export declare function parseIgnoreFile(content: string): string[];
+/**
+ * Filters a list of file paths, removing any that match the ignore patterns.
+ * Patterns are matched against the relative path from baseDir.
+ * Also always excludes `.scaffoldignore` itself.
+ */
+export declare function filterIgnoredFiles(files: string[], ignorePatterns: string[], baseDir: string): string[];

package/index.d.ts

@@ -1,4 +1,5 @@
 export * from "./scaffold";
 export * from "./types";
+export { validateConfig, assertConfigValid, scaffoldConfigSchema } from "./validate";
 import Scaffold from "./scaffold";
 export default Scaffold;

package/index.js

@@ -2,12 +2,15 @@ Object.defineProperties(exports, {
 	__esModule: { value: true },
 	[Symbol.toStringTag]: { value: "Module" }
 });
-const require_scaffold = require("./scaffold-Ce-rIwy9.js");
+const require_scaffold = require("./scaffold-DOzCgpZT.js");
 //#region src/index.ts
 var src_default = require_scaffold.Scaffold;
 //#endregion
 exports.LogLevel = require_scaffold.LogLevel;
 exports.Scaffold = require_scaffold.Scaffold;
+exports.assertConfigValid = require_scaffold.assertConfigValid;
 exports.default = src_default;
+exports.scaffoldConfigSchema = require_scaffold.scaffoldConfigSchema;
+exports.validateConfig = require_scaffold.validateConfig;
 
 //# sourceMappingURL=index.js.map

package/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["export * from \"./scaffold\"\nexport * from \"./types\"\nimport Scaffold from \"./scaffold\"\n\nexport default Scaffold\n"],"mappings":";;;;;;AAIA,IAAA,cAAe,iBAAA"}
+{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["export * from \"./scaffold\"\nexport * from \"./types\"\nexport { validateConfig, assertConfigValid, scaffoldConfigSchema } from \"./validate\"\nimport Scaffold from \"./scaffold\"\n\nexport default Scaffold\n"],"mappings":";;;;;;AAKA,IAAA,cAAe,iBAAA"}

package/init.d.ts

@@ -0,0 +1,20 @@
+declare const CONFIG_EXTENSIONS: {
+    readonly js: "scaffold.config.js";
+    readonly mjs: "scaffold.config.mjs";
+    readonly json: "scaffold.config.json";
+};
+type ConfigFormat = keyof typeof CONFIG_EXTENSIONS;
+export interface InitOptions {
+    /** Working directory to create the config in. Defaults to cwd. */
+    dir?: string;
+    /** Config format to use. If not provided, the user is prompted. */
+    format?: ConfigFormat;
+    /** Whether to create an example template directory. Defaults to true. */
+    createExample?: boolean;
+}
+/**
+ * Initializes a new Simple Scaffold project by creating a config file
+ * and an optional example template directory.
+ */
+export declare function initScaffold(options?: InitOptions): Promise<void>;
+export {};

package/logger.d.ts

@@ -15,5 +15,13 @@ export declare function logInputFile(config: ScaffoldConfig, data: {
     isDirOrGlob: boolean;
     isGlob: boolean;
 }): void;
-/** Logs the full scaffold configuration at debug level, with a data summary at info level. */
+/** Logs the full scaffold configuration at debug level. */
 export declare function logInitStep(config: ScaffoldConfig): void;
+/**
+ * Logs a tree of created files, grouped by directory.
+ */
+export declare function logFileTree(config: LogConfig, files: string[]): void;
+/**
+ * Logs a final summary line with file count and elapsed time.
+ */
+export declare function logSummary(config: LogConfig, fileCount: number, elapsedMs: number, dryRun?: boolean): void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "simple-scaffold",
-  "version": "3.0.0",
+  "version": "3.1.0",
   "description": "Generate any file structure - from single components to entire app boilerplates, with a single command.",
   "homepage": "https://chenasraf.github.io/simple-scaffold",
   "repository": {
@@ -37,21 +37,41 @@
     "docs:build": "cd docs && pnpm build",
     "docs:watch": "cd docs && pnpm start",
     "audit-fix": "pnpm audit --fix",
-    "ci": "pnpm install --frozen-lockfile"
+    "ci": "pnpm install --frozen-lockfile",
+    "lint": "eslint src/ tests/",
+    "format": "prettier --write .",
+    "lint-staged": "lint-staged",
+    "prepare": "husky"
+  },
+  "lint-staged": {
+    "*.{ts,mts,js,mjs}": [
+      "eslint --fix",
+      "prettier --write"
+    ],
+    "*.{json,md,yml,yaml,css}": [
+      "prettier --write"
+    ]
   },
   "dependencies": {
+    "@inquirer/confirm": "^6.0.10",
     "@inquirer/input": "^5.0.10",
+    "@inquirer/number": "^4.0.10",
     "@inquirer/select": "^5.1.2",
     "date-fns": "^4.1.0",
     "glob": "^13.0.6",
     "handlebars": "^4.7.8",
-    "massarg": "2.1.1"
+    "massarg": "2.1.1",
+    "minimatch": "^10.2.4",
+    "zod": "^4.3.6"
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",
     "@types/node": "^25.5.0",
     "@vitest/coverage-v8": "^4.1.0",
+    "husky": "^9.1.7",
+    "lint-staged": "^16.4.0",
     "mock-fs": "^5.5.0",
+    "prettier": "^3.8.1",
     "rimraf": "^6.1.3",
     "typescript": "^5.9.3",
     "typescript-eslint": "^8.57.1",

package/prompts.d.ts

@@ -16,8 +16,17 @@ export declare function promptForInputs(inputs: Record<string, ScaffoldInput>, e
 /** Returns true if the process is running in an interactive terminal. */
 export declare function isInteractive(): boolean;
 /**
- * Fills in missing config values by prompting the user interactively.
- * Only prompts when running in a TTY — in non-interactive mode, returns config as-is.
+ * Prompts for name and template key before the config file is parsed.
+ * These are needed by parseConfigFile to know which template to load.
+ */
+export declare function promptBeforeConfig(config: ScaffoldCmdConfig, configMap?: ScaffoldConfigMap): Promise<ScaffoldCmdConfig>;
+/**
+ * Prompts for any values still missing after the config file has been parsed.
+ * Only prompts in interactive mode.
+ */
+export declare function promptAfterConfig(config: ScaffoldConfig): Promise<ScaffoldConfig>;
+/**
+ * @deprecated Use {@link promptBeforeConfig} and {@link promptAfterConfig} instead.
  */
 export declare function promptForMissingConfig(config: ScaffoldCmdConfig, configMap?: ScaffoldConfigMap): Promise<ScaffoldCmdConfig>;
 /**