simple-scaffold 2.3.3 → 3.0.0

package/cmd.js.map

@@ -1 +1 @@
-{"version":3,"file":"cmd.js","sourceRoot":"","sources":["../src/cmd.ts"],"names":[],"mappings":";;;;;;AAaA,oCA8PC;AAzQD,0DAA4B;AAC5B,gEAAiC;AACjC,qCAAiC;AACjC,mCAA4E;AAC5E,yCAAqC;AACrC,qCAA0E;AAC1E,qCAA8B;AAC9B,6CAAgD;AAChD,iCAAkE;AAClE,mCAAkC;AAE3B,KAAK,UAAU,YAAY,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IAC7D,MAAM,aAAa,GAAG,OAAO,CAAC,MAAM,kBAAE,CAAC,IAAI,CAAC,mBAAI,CAAC,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,CAAA;IACrG,MAAM,OAAO,GAAG,MAAM,kBAAE,CAAC,QAAQ,CAAC,mBAAI,CAAC,OAAO,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC,CAAA;IACtG,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAA;IAC1C,MAAM,aAAa,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;IACvE,MAAM,oBAAoB,GAAG,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;IAC7E,MAAM,aAAa,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;IACnE,MAAM,gBAAgB,GAAG,oBAAoB,IAAI,aAAa,IAAI,aAAa,CAAA;IAE/E,OAAO,IAAA,iBAAO,EAAoB;QAChC,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,WAAW,EAAE,GAAG,CAAC,WAAW;KAC7B,CAAC;SACC,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE;QACrB,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;YACxB,OAAM;QACR,CAAC;QACD,IAAA,YAAG,EAAC,MAAM,EAAE,gBAAQ,CAAC,IAAI,EAAE,oBAAoB,GAAG,CAAC,OAAO,EAAE,CAAC,CAAA;QAC7D,MAAM,CAAC,MAAM,GAAG,IAAA,uBAAqB,GAAE,CAAA;QACvC,IAAI,CAAC;YACH,IAAA,YAAG,EAAC,MAAM,EAAE,gBAAQ,CAAC,KAAK,EAAE,wBAAwB,EAAE,MAAM,CAAC,CAAA;YAC7D,MAAM,MAAM,GAAG,MAAM,IAAA,wBAAe,EAAC,MAAM,CAAC,CAAA;YAC5C,MAAM,IAAA,mBAAQ,EAAC,MAAM,CAAC,CAAA;QACxB,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,OAAO,GAAG,SAAS,IAAK,CAAY,CAAC,CAAC,CAAE,CAAW,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAA;YACjF,IAAA,YAAG,EAAC,MAAM,EAAE,gBAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;QACtC,CAAC;gBAAS,CAAC;YACT,IAAA,YAAG,EAAC,MAAM,EAAE,gBAAQ,CAAC,KAAK,EAAE,gCAAgC,EAAE,MAAM,CAAC,MAAM,CAAC,CAAA;YAC5E,MAAM,kBAAE,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;QAC9D,CAAC;IACH,CAAC,CAAC;SACD,MAAM,CAAC;QACN,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,CAAC,GAAG,CAAC;QACd,WAAW,EACT,wFAAwF;YACxF,0FAA0F;YAC1F,2BAA2B;QAC7B,SAAS,EAAE,IAAI;QACf,QAAQ,EAAE,CAAC,gBAAgB;KAC5B,CAAC;SACD,MAAM,CAAC;QACN,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,CAAC,GAAG,CAAC;QACd,WAAW,EAAE,2CAA2C;KACzD,CAAC;SACD,MAAM,CAAC;QACN,IAAI,EAAE,KAAK;QACX,OAAO,EAAE,CAAC,GAAG,CAAC;QACd,WAAW,EAAE,iDAAiD;KAC/D,CAAC;SACD,MAAM,CAAC;QACN,IAAI,EAAE,KAAK;QACX,OAAO,EAAE,CAAC,GAAG,CAAC;QACd,WAAW,EACT,4GAA4G;YAC5G,6CAA6C;KAChD,CAAC;SACD,MAAM,CAAC;QACN,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,CAAC,GAAG,CAAC;QACd,WAAW,EACT,iFAAiF;YACjF,kDAAkD;QACpD,QAAQ,EAAE,CAAC,gBAAgB;KAC5B,CAAC;SACD,MAAM,CAAC;QACN,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,CAAC,GAAG,CAAC;QACd,KAAK,EAAE,IAAI;QACX,WAAW,EACT,qGAAqG;YACrG,iBAAiB;YACjB,sDAAsD;QACxD,QAAQ,EAAE,CAAC,gBAAgB;KAC5B,CAAC;SACD,IAAI,CAAC;QACJ,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,CAAC,GAAG,CAAC;QACd,YAAY,EAAE,KAAK;QACnB,WAAW,EAAE,8DAA8D;QAC3E,SAAS,EAAE,IAAI;KAChB,CAAC;SACD,MAAM,CAAC;QACN,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,CAAC,GAAG,CAAC;QACd,WAAW,EAAE,+EAA+E;QAC5F,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;KAC5B,CAAC;SACD,MAAM,CAAC;QACN,IAAI,EAAE,aAAa;QACnB,OAAO,EAAE,CAAC,GAAG,CAAC;QACd,WAAW,EACT,4GAA4G;YAC5G,gEAAgE;QAClE,KAAK,EAAE,wBAAe;KACvB,CAAC;SACD,IAAI,CAAC;QACJ,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,CAAC,GAAG,CAAC;QACd,YAAY,EAAE,KAAK;QACnB,WAAW,EAAE,+EAA+E;QAC5F,SAAS,EAAE,IAAI;QACf,YAAY,EAAE,WAAW;KAC1B,CAAC;SACD,MAAM,CAAC;QACN,IAAI,EAAE,eAAe;QACrB,OAAO,EAAE,CAAC,GAAG,CAAC;QACd,WAAW,EAAE,+DAA+D;KAC7E,CAAC;SACD,IAAI,CAAC;QACJ,IAAI,EAAE,OAAO;QACb,OAAO,EAAE,CAAC,GAAG,CAAC;QACd,YAAY,EAAE,KAAK;QACnB,WAAW,EAAE,mDAAmD;KACjE,CAAC;SACD,MAAM,CAAC;QACN,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,CAAC,GAAG,CAAC;QACd,YAAY,EAAE,gBAAQ,CAAC,IAAI;QAC3B,WAAW,EACT,uDAAuD;YACvD,GAAG,gBAAQ,CAAC,IAAI,CAAA,wCAAwC,IAAI;YAC5D,uEAAuE;QACzE,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE;YACX,MAAM,GAAG,GAAG,CAAC,CAAC,WAAW,EAAE,CAAA;YAC3B,IAAI,CAAC,CAAC,GAAG,IAAI,gBAAQ,CAAC,EAAE,CAAC;gBACvB,MAAM,IAAI,KAAK,CAAC,sBAAsB,GAAG,qBAAqB,MAAM,CAAC,IAAI,CAAC,gBAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;YACnG,CAAC;YACD,OAAO,GAAG,CAAA;QACZ,CAAC;KACF,CAAC;SACD,MAAM,CAAC;QACN,IAAI,EAAE,cAAc;QACpB,OAAO,EAAE,CAAC,GAAG,CAAC;QACd,WAAW,EACT,6EAA6E;YAC7E,0FAA0F;YAC1F,uCAAuC;KAC1C,CAAC;SACD,IAAI,CAAC;QACJ,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,CAAC,IAAI,CAAC;QACf,YAAY,EAAE,KAAK;QACnB,WAAW,EACT,iFAAiF;YACjF,iFAAiF;KACpF,CAAC;SACD,IAAI,CAAC;QACJ,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,CAAC,GAAG,CAAC;QACd,WAAW,EAAE,kBAAkB;KAChC,CAAC;SACD,OAAO,CACN,IAAI,wBAAc,CAAwB;QACxC,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,CAAC,IAAI,CAAC;QACf,WAAW,EAAE,sFAAsF;QACnG,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YACrB,MAAM,MAAM,GAAG;gBACb,SAAS,EAAE,EAAE;gBACb,IAAI,EAAE,EAAE;gBACR,OAAO,EAAE,KAAK;gBACd,MAAM,EAAE,EAAE;gBACV,MAAM,EAAE,KAAK;gBACb,SAAS,EAAE,KAAK;gBAChB,MAAM,EAAE,KAAK;gBACb,MAAM,EAAE,IAAA,uBAAqB,GAAE;gBAC/B,GAAG,OAAO;gBACV,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;aACrE,CAAA;YACD,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,MAAM,IAAA,sBAAa,EAAC,MAAM,CAAC,CAAA;gBACxC,OAAO,CAAC,GAAG,CAAC,gBAAQ,CAAC,SAAS,CAAA,wBAAwB,CAAC,CAAA;gBACvD,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;YAC3C,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,MAAM,OAAO,GAAG,SAAS,IAAK,CAAY,CAAC,CAAC,CAAE,CAAW,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAA;gBACjF,IAAA,YAAG,EAAC,MAAM,EAAE,gBAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;YACtC,CAAC;oBAAS,CAAC;gBACT,IAAA,YAAG,EAAC,MAAM,EAAE,gBAAQ,CAAC,KAAK,EAAE,gCAAgC,EAAE,MAAM,CAAC,MAAM,CAAC,CAAA;gBAC5E,MAAM,kBAAE,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;YAC9D,CAAC;QACH,CAAC;KACF,CAAC;SACC,MAAM,CAAC;QACN,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,CAAC,GAAG,CAAC;QACd,WAAW,EAAE,mFAAmF;KACjG,CAAC;SACD,MAAM,CAAC;QACN,IAAI,EAAE,KAAK;QACX,OAAO,EAAE,CAAC,GAAG,CAAC;QACd,WAAW,EAAE,iDAAiD;KAC/D,CAAC;SACD,MAAM,CAAC;QACN,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,CAAC,GAAG,CAAC;QACd,YAAY,EAAE,gBAAQ,CAAC,IAAI;QAC3B,WAAW,EACT,uDAAuD;YACvD,GAAG,gBAAQ,CAAC,IAAI,CAAA,wCAAwC,IAAI;YAC5D,uEAAuE;QACzE,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE;YACX,MAAM,GAAG,GAAG,CAAC,CAAC,WAAW,EAAE,CAAA;YAC3B,IAAI,CAAC,CAAC,GAAG,IAAI,gBAAQ,CAAC,EAAE,CAAC;gBACvB,MAAM,IAAI,KAAK,CAAC,sBAAsB,GAAG,qBAAqB,MAAM,CAAC,IAAI,CAAC,gBAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;YACnG,CAAC;YACD,OAAO,GAAG,CAAA;QACZ,CAAC;KACF,CAAC;SACD,IAAI,CAAC;QACJ,UAAU,EAAE,IAAI;KACjB,CAAC,CACL;SACA,OAAO,CAAC;QACP,WAAW,EAAE,wBAAwB;QACrC,KAAK,EAAE,oDAAoD;KAC5D,CAAC;SACD,OAAO,CAAC;QACP,WAAW,EAAE,+BAA+B;QAC5C,KAAK,EAAE,8DAA8D;KACtE,CAAC;SACD,OAAO,CAAC;QACP,WAAW,EAAE,2CAA2C;QACxD,KAAK,EAAE,6FAA6F;KACrG,CAAC;SACD,OAAO,CAAC;QACP,WAAW,EAAE,8CAA8C;QAC3D,KAAK,EAAE,gDAAgD;KACxD,CAAC;SACD,OAAO,CAAC;QACP,WAAW,EACT,uGAAuG;QACzG,KAAK,EAAE,0DAA0D;KAClE,CAAC;SACD,IAAI,CAAC;QACJ,UAAU,EAAE,IAAI;QAChB,UAAU,EAAE,GAAG;QACf,qBAAqB,EAAE,IAAI;QAC3B,SAAS,EAAE,CAAC,gBAAQ,CAAC,MAAM,CAAA,iBAAiB,EAAE,gBAAQ,CAAC,IAAI,CAAA,WAAW,EAAE,gBAAQ,CAAC,IAAI,CAAA,QAAQ,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;QACxG,aAAa,EAAE;YACb,gBAAgB,EAAE,IAAI;SACvB;QACD,UAAU,EAAE;YACV,aAAa,GAAG,CAAC,OAAO,EAAE;YAC1B,+BAA+B,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE;YACzD,EAAE;YACF,mBAAmB,gBAAQ,CAAC,SAAS,CAAA,6CAA6C,EAAE;YACpF,SAAS,gBAAQ,CAAC,SAAS,CAAA,2CAA2C,EAAE;YACxE,YAAY,gBAAQ,CAAC,SAAS,CAAA,8CAA8C,EAAE;SAC/E,CAAC,IAAI,CAAC,IAAI,CAAC;KACb,CAAC;SACD,KAAK,CAAC,IAAI,CAAC,CAAA;AAChB,CAAC;AAED,YAAY,EAAE,CAAA"}
+{"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":"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"}

package/colors.d.ts

@@ -0,0 +1,32 @@
+/** ANSI color code mapping for terminal output. */
+declare const colorMap: {
+    readonly reset: 0;
+    readonly dim: 2;
+    readonly bold: 1;
+    readonly italic: 3;
+    readonly underline: 4;
+    readonly red: 31;
+    readonly green: 32;
+    readonly yellow: 33;
+    readonly blue: 34;
+    readonly magenta: 35;
+    readonly cyan: 36;
+    readonly white: 37;
+    readonly gray: 90;
+};
+/** Available terminal color names. */
+export type TermColor = keyof typeof colorMap;
+declare function _colorize(text: string, color: TermColor): string;
+declare const createColorize: (color: TermColor) => (template: TemplateStringsArray | unknown, ...params: unknown[]) => string;
+type TemplateStringsFn = ReturnType<typeof createColorize> & ((text: string) => string);
+type TemplateStringsFns = {
+    [key in TermColor]: TemplateStringsFn;
+};
+/**
+ * Colorize text for terminal output.
+ *
+ * Can be used as a function: `colorize("text", "red")`
+ * Or via named helpers: `colorize.red("text")` / `colorize.red\`template\``
+ */
+export declare const colorize: typeof _colorize & TemplateStringsFns;
+export {};

package/config.d.ts

@@ -1,17 +1,19 @@
-import { ConfigLoadConfig, FileResponse, LogConfig, RemoteConfigLoadConfig, ScaffoldCmdConfig, ScaffoldConfig, ScaffoldConfigFile, ScaffoldConfigMap } from "./types";
-/** @internal */
-export declare function getOptionValueForFile<T>(config: ScaffoldConfig, filePath: string, fn: FileResponse<T>, defaultValue?: T): T;
-/** @internal */
+import { ConfigLoadConfig, LogConfig, RemoteConfigLoadConfig, ScaffoldCmdConfig, ScaffoldConfig, ScaffoldConfigFile, ScaffoldConfigMap } from "./types";
+export { getOptionValueForFile } from "./file";
+/** Parses CLI append-data syntax (`key=value` or `key:=jsonValue`) into a data object. @internal */
 export declare function parseAppendData(value: string, options: ScaffoldCmdConfig): unknown;
-/** @internal */
+/** Loads and resolves a config file (local or remote). @internal */
 export declare function getConfigFile(config: ScaffoldCmdConfig): Promise<ScaffoldConfigMap>;
-/** @internal */
+/**
+ * Parses a CLI config into a full ScaffoldConfig by merging CLI args, config file values,
+ * and append-data overrides. @internal
+ */
 export declare function parseConfigFile(config: ScaffoldCmdConfig): Promise<ScaffoldConfig>;
-/** @internal */
+/** Converts a GitHub shorthand (user/repo) to a full HTTPS git URL. @internal */
 export declare function githubPartToUrl(part: string): string;
-/** @internal */
+/** Loads a scaffold config from a local file or directory. @internal */
 export declare function getLocalConfig(config: ConfigLoadConfig & Partial<LogConfig>): Promise<ScaffoldConfigFile>;
-/** @internal */
+/** Loads a scaffold config from a remote git repository. @internal */
 export declare function getRemoteConfig(config: RemoteConfigLoadConfig & Partial<LogConfig>): Promise<ScaffoldConfigFile>;
-/** @internal */
+/** Searches for a scaffold config file in the given directory, trying known filenames in order. @internal */
 export declare function findConfigFile(root: string): Promise<string>;

package/file.d.ts

@@ -1,19 +1,30 @@
-import { LogConfig, ScaffoldConfig } from "./types";
-export declare function createDirIfNotExists(dir: string, config: LogConfig & Pick<ScaffoldConfig, "dryRun">): Promise<void>;
-export declare function pathExists(filePath: string): Promise<boolean>;
-export declare function isDir(path: string): Promise<boolean>;
-export declare function removeGlob(template: string): string;
-export declare function makeRelativePath(str: string): string;
-export declare function getBasePath(relPath: string): string;
-export declare function getFileList(config: ScaffoldConfig, templates: string[]): Promise<string[]>;
+import { FileResponse, ScaffoldConfig } from "./types";
+export { createDirIfNotExists, pathExists, isDir, getUniqueTmpPath } from "./fs-utils";
+export { removeGlob, makeRelativePath, getBasePath } from "./path-utils";
+/**
+ * Resolves a config option that may be either a static value or a per-file function.
+ * For function values, the file path is parsed through Handlebars before being passed.
+ * @internal
+ */
+export declare function getOptionValueForFile<T>(config: ScaffoldConfig, filePath: string, fn: FileResponse<T>, defaultValue?: T): T;
+/** Information about a template glob pattern and how it was resolved. */
 export interface GlobInfo {
-    nonGlobTemplate: string;
+    /** The template path with glob wildcards stripped. */
+    baseTemplatePath: string;
+    /** The original template string as provided by the user. */
     origTemplate: string;
+    /** Whether the template is a directory or contains glob patterns. */
     isDirOrGlob: boolean;
+    /** Whether the template contains glob wildcard characters. */
     isGlob: boolean;
+    /** The final resolved template path (with `**\/*` appended for directories). */
     template: string;
 }
+/** Expands a list of glob patterns into a flat list of matching file paths. */
+export declare function getFileList(config: ScaffoldConfig, templates: string[]): Promise<string[]>;
+/** Analyzes a template path to determine if it's a glob, directory, or single file. */
 export declare function getTemplateGlobInfo(config: ScaffoldConfig, template: string): Promise<GlobInfo>;
+/** Complete information about a template file's output destination. */
 export interface OutputFileInfo {
     inputPath: string;
     outputPathOpt: string;
@@ -21,20 +32,28 @@ export interface OutputFileInfo {
     outputPath: string;
     exists: boolean;
 }
+/** Computes the full output path and metadata for a single template file. */
 export declare function getTemplateFileInfo(config: ScaffoldConfig, { templatePath, basePath }: {
     templatePath: string;
     basePath: string;
 }): Promise<OutputFileInfo>;
+/**
+ * Reads a template file, applies Handlebars parsing, runs the beforeWrite hook,
+ * and writes the result to the output path.
+ */
 export declare function copyFileTransformed(config: ScaffoldConfig, { exists, overwrite, outputPath, inputPath, }: {
     exists: boolean;
     overwrite: boolean;
     outputPath: string;
     inputPath: string;
 }): Promise<void>;
+/** Computes the output directory for a file, combining the output path, base path, and optional subdir. */
 export declare function getOutputDir(config: ScaffoldConfig, outputPathOpt: string, basePath: string): string;
+/**
+ * Processes a single template file: resolves output paths, creates directories,
+ * and writes the transformed output.
+ */
 export declare function handleTemplateFile(config: ScaffoldConfig, { templatePath, basePath }: {
     templatePath: string;
     basePath: string;
 }): Promise<void>;
-/** @internal */
-export declare function getUniqueTmpPath(): string;

package/fs-utils.d.ts

@@ -0,0 +1,9 @@
+import { LogConfig, ScaffoldConfig } from "./types";
+/** Recursively creates a directory and its parents if they don't exist. */
+export declare function createDirIfNotExists(dir: string, config: LogConfig & Pick<ScaffoldConfig, "dryRun">): Promise<void>;
+/** Checks whether a file or directory exists at the given path. */
+export declare function pathExists(filePath: string): Promise<boolean>;
+/** Returns true if the given path is a directory. */
+export declare function isDir(dirPath: string): Promise<boolean>;
+/** Generates a unique temporary directory path for scaffold operations. @internal */
+export declare function getUniqueTmpPath(): string;

package/index.js

@@ -1,24 +1,13 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./scaffold"), exports);
-__exportStar(require("./types"), exports);
-const scaffold_1 = __importDefault(require("./scaffold"));
-exports.default = scaffold_1.default;
+Object.defineProperties(exports, {
+	__esModule: { value: true },
+	[Symbol.toStringTag]: { value: "Module" }
+});
+const require_scaffold = require("./scaffold-Ce-rIwy9.js");
+//#region src/index.ts
+var src_default = require_scaffold.Scaffold;
+//#endregion
+exports.LogLevel = require_scaffold.LogLevel;
+exports.Scaffold = require_scaffold.Scaffold;
+exports.default = src_default;
+
 //# sourceMappingURL=index.js.map

package/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;AAAA,6CAA0B;AAC1B,0CAAuB;AACvB,0DAAiC;AAEjC,kBAAe,kBAAQ,CAAA"}
+{"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"}

package/logger.d.ts

@@ -1,5 +1,10 @@
 import { LogConfig, LogLevel, ScaffoldConfig } from "./types";
+/** Logs a message at the given level, respecting the configured log level filter. */
 export declare function log(config: LogConfig, level: LogLevel, ...obj: unknown[]): void;
+/**
+ * Logs detailed file processing information at debug level.
+ * @deprecated Use `log(config, LogLevel.debug, data)` directly instead.
+ */
 export declare function logInputFile(config: ScaffoldConfig, data: {
     originalTemplate: string;
     relativePath: string;
@@ -10,4 +15,5 @@ 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. */
 export declare function logInitStep(config: ScaffoldConfig): void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "simple-scaffold",
-  "version": "2.3.3",
+  "version": "3.0.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": {
@@ -27,34 +27,36 @@
   ],
   "scripts": {
     "clean": "rimraf dist",
-    "build": "pnpm clean && tsc && chmod -R +x ./dist && cp ./package.json ./README.md ./dist/",
-    "dev": "tsc --watch",
-    "start": "ts-node src/scaffold.ts",
-    "test": "jest",
-    "coverage": "open coverage/lcov-report/index.html",
-    "cmd": "ts-node src/cmd.ts",
+    "build": "pnpm clean && vite build && tsc --emitDeclarationOnly && chmod -R +x ./dist && cp ./package.json ./README.md ./dist/",
+    "dev": "vite build --watch",
+    "start": "vite-node src/scaffold.ts",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "coverage": "vitest run --coverage && open coverage/lcov-report/index.html",
+    "cmd": "vite-node src/cmd.ts",
     "docs:build": "cd docs && pnpm build",
     "docs:watch": "cd docs && pnpm start",
     "audit-fix": "pnpm audit --fix",
     "ci": "pnpm install --frozen-lockfile"
   },
   "dependencies": {
+    "@inquirer/input": "^5.0.10",
+    "@inquirer/select": "^5.1.2",
     "date-fns": "^4.1.0",
-    "glob": "^11.0.3",
+    "glob": "^13.0.6",
     "handlebars": "^4.7.8",
-    "massarg": "2.0.1"
+    "massarg": "2.1.1"
   },
   "devDependencies": {
-    "@eslint/js": "^9.29.0",
-    "@types/jest": "^30.0.0",
-    "@types/mock-fs": "^4.13.4",
-    "@types/node": "^24.0.3",
-    "jest": "^30.0.0",
+    "@eslint/js": "^10.0.1",
+    "@types/node": "^25.5.0",
+    "@vitest/coverage-v8": "^4.1.0",
     "mock-fs": "^5.5.0",
-    "rimraf": "^6.0.1",
-    "ts-jest": "^29.4.0",
-    "ts-node": "^10.9.2",
-    "typescript": "^5.8.3",
-    "typescript-eslint": "^8.34.1"
+    "rimraf": "^6.1.3",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.57.1",
+    "vite": "^8.0.1",
+    "vite-node": "^6.0.0",
+    "vitest": "^4.1.0"
   }
 }

package/parser.d.ts

@@ -1,5 +1,5 @@
 import { DefaultHelpers, Helper, ScaffoldConfig } from "./types";
-import { Duration } from "date-fns";
+import { type Duration } from "date-fns";
 export declare const defaultHelpers: Record<DefaultHelpers, Helper>;
 export declare function nowHelper(formatString: string): string;
 export declare function nowHelper(formatString: string, durationDifference: number, durationType: keyof Duration): string;

package/path-utils.d.ts

@@ -0,0 +1,6 @@
+/** Strips glob wildcard characters from a template path. */
+export declare function removeGlob(template: string): string;
+/** Removes a leading path separator, making the path relative. */
+export declare function makeRelativePath(str: string): string;
+/** Computes a base path relative to the current working directory. */
+export declare function getBasePath(relPath: string): string;

package/prompts.d.ts

@@ -0,0 +1,27 @@
+import { ScaffoldCmdConfig, ScaffoldConfig, ScaffoldConfigMap, ScaffoldInput } from "./types";
+/** Prompts the user for a scaffold name. */
+export declare function promptForName(): Promise<string>;
+/** Prompts the user to select a template key from the available config keys. */
+export declare function promptForTemplateKey(configMap: ScaffoldConfigMap): Promise<string>;
+/** Prompts the user for an output directory path. */
+export declare function promptForOutput(): Promise<string>;
+/** Prompts the user for template paths (comma-separated). */
+export declare function promptForTemplates(): Promise<string[]>;
+/**
+ * Prompts the user for any required scaffold inputs that are not already provided in data.
+ * Also applies default values for optional inputs that have one.
+ * Returns the merged data object.
+ */
+export declare function promptForInputs(inputs: Record<string, ScaffoldInput>, existingData?: Record<string, unknown>): Promise<Record<string, unknown>>;
+/** 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.
+ */
+export declare function promptForMissingConfig(config: ScaffoldCmdConfig, configMap?: ScaffoldConfigMap): Promise<ScaffoldCmdConfig>;
+/**
+ * Prompts for any required inputs defined in the scaffold config and merges them into data.
+ * Only prompts in interactive mode; in non-interactive mode, only applies defaults.
+ */
+export declare function resolveInputs(config: ScaffoldConfig): Promise<ScaffoldConfig>;