@pixpilot/scaffoldfy 0.8.0 → 0.9.0

package/README.md

@@ -9,7 +9,8 @@ A flexible and powerful template initialization utility for automating project s
 - 🔍 **Dry-Run Mode with Diff** - Preview exact changes before applying
 - 🔌 **Plugin System** - Create custom task types and lifecycle hooks
 - 💬 **Interactive Prompts** - Collect user input with input, select, confirm, number, and password prompts
-- 📦 **JSON/TypeScript Config** - Define tasks in JSON or TypeScript files
+- � **Variables** - Define reusable values from static or executable sources without user interaction
+- �📦 **JSON/TypeScript Config** - Define tasks in JSON or TypeScript files
 - 🔗 **Task Dependencies** - Ensure tasks run in the correct order
 - ✅ **Type-Safe** - Full TypeScript support with JSON schema validation
 - 🎯 **Template Variables** - Use `{{variable}}` syntax for dynamic configuration
@@ -346,6 +347,7 @@ Control execution order:
 - **[Getting Started](https://pixpilot.github.io/scaffoldfy/GETTING_STARTED.html)** - Installation, CLI usage, and examples
 - **[Task Types Reference](https://pixpilot.github.io/scaffoldfy/TASK_TYPES.html)** - All 9 built-in task types
 - **[Interactive Prompts](https://pixpilot.github.io/scaffoldfy/PROMPTS.html)** - Collect user input
+- **[Variables](https://pixpilot.github.io/scaffoldfy/VARIABLES.html)** - Reusable values without user interaction
 - **[Advanced Features](https://pixpilot.github.io/scaffoldfy/FEATURES.html)** - Conditional execution, global prompts, Handlebars
 - **[Template Inheritance](https://pixpilot.github.io/scaffoldfy/TEMPLATE_INHERITANCE.html)** - Extend and compose templates
 - **[Plugin System](https://pixpilot.github.io/scaffoldfy/PLUGINS.html)** - Create custom task types

package/dist/cli.cjs

@@ -1,2 +1,2 @@
 #!/usr/bin/env node
-const e=require(`./src-CFP-DJ0M.cjs`);let t=require(`node:fs`);t=e.q(t);let n=require(`node:path`);n=e.q(n);let r=require(`node:process`);r=e.q(r);let i=require(`commander`);i=e.q(i);const a=1,o=new i.Command,s=n.default.join(__dirname,`..`,`package.json`);let c=`0.0.0`;try{c=JSON.parse(t.default.readFileSync(s,`utf-8`)).version??`0.0.0`}catch{}o.name(`scaffoldfy`).description(`Initialize and configure project templates with customizable tasks`).version(c),o.option(`--dry-run`,`Run in dry mode without making any changes`).option(`--force`,`Force re-initialization even if already initialized`).option(`--tasks-file <path>`,`Path to JSON file containing task definitions`,`./template-tasks.json`).option(`--tasks-ts <path>`,`Path to TypeScript file exporting tasks`,`./template-tasks.ts`).action(async i=>{try{let a=[],o;if(i.tasksTs!=null&&i.tasksTs!==``){let s=n.default.resolve(r.default.cwd(),i.tasksTs);if(t.default.existsSync(s)){e.U(`Loading tasks from TypeScript file: ${i.tasksTs}`,`info`),o=s;try{let t=await import(s);a=t.default??t.tasks??[],(!Array.isArray(a)||a.length===0)&&(e.U(`⚠️  No tasks found in TypeScript file or invalid format`,`warn`),e.U(`Expected default export or named export "tasks" with TaskDefinition[]`,`info`))}catch(t){e.U(`Failed to load TypeScript tasks file: ${i.tasksTs}`,`error`),t instanceof Error&&e.U(`  Error: ${t.message}`,`error`),r.default.exit(1)}}}if(a.length===0&&i.tasksFile!=null&&i.tasksFile!==``){let s=n.default.resolve(r.default.cwd(),i.tasksFile);if(t.default.existsSync(s)){o=s;try{a=await e.a(s),Array.isArray(a)||(e.U(`❌ Invalid tasks file format`,`error`),e.U(`Expected JSON with { "tasks": [...] } structure`,`info`),r.default.exit(1))}catch(t){e.U(`Failed to load JSON tasks file: ${i.tasksFile}`,`error`),t instanceof Error&&e.U(`  Error: ${t.message}`,`error`),r.default.exit(1)}}else e.U(`Tasks file not found: ${i.tasksFile}`,`warn`)}a.length===0&&(e.U(`❌ No tasks defined`,`error`),console.log(``),e.U(`Please provide tasks using one of these methods:`,`info`),e.U(`  1. Create a template-tasks.json file in the current directory`,`info`),e.U(`  2. Create a template-tasks.ts file in the current directory`,`info`),e.U(`  3. Use --tasks-file option to specify a different JSON file`,`info`),e.U(`  4. Use --tasks-ts option to specify a different TypeScript file`,`info`),console.log(``),e.U(`Example JSON structure:`,`info`),console.log(JSON.stringify({tasks:[{id:`update-package`,name:`Update package.json`,description:`Update package.json with repository information`,required:!0,enabled:!0,type:`update-json`,prompts:[{id:`projectName`,type:`input`,message:`What is your project name?`,default:`my-project`,required:!0},{id:`includeTests`,type:`confirm`,message:`Include test files?`,default:!0}],config:{file:`package.json`,updates:{name:`{{projectName}}`,author:`{{author}}`}}}]},null,2)),console.log(``),r.default.exit(1)),console.log(``),e.U(`Loaded ${a.length} task(s)`,`success`),console.log(``),await e.n(a,{dryRun:i.dryRun,force:i.force,tasksFilePath:o})}catch(t){if(e.U(`❌ CLI execution failed`,`error`),t instanceof Error){e.U(`Error: ${t.message}`,`error`);let n=r.default.env.DEBUG;n!=null&&n!==``&&console.error(t.stack)}else console.error(t);r.default.exit(1)}}),o.parse(r.default.argv);
+const e=require(`./src-DxvGGX8s.cjs`);let t=require(`node:fs`);t=e.Z(t);let n=require(`node:path`);n=e.Z(n);let r=require(`node:process`);r=e.Z(r);let i=require(`commander`);i=e.Z(i);const a=1,o=new i.Command,s=n.default.join(__dirname,`..`,`package.json`);let c=`0.0.0`;try{c=JSON.parse(t.default.readFileSync(s,`utf-8`)).version??`0.0.0`}catch{}o.name(`scaffoldfy`).description(`Initialize and configure project templates with customizable tasks`).version(c),o.option(`--dry-run`,`Run in dry mode without making any changes`).option(`--force`,`Force re-initialization even if already initialized`).option(`--tasks-file <path>`,`Path to JSON file containing task definitions`,`./template-tasks.json`).option(`--tasks-ts <path>`,`Path to TypeScript file exporting tasks`,`./template-tasks.ts`).action(async i=>{try{let a=[],o,s,c;if(i.tasksTs!=null&&i.tasksTs!==``){let o=n.default.resolve(r.default.cwd(),i.tasksTs);if(t.default.existsSync(o)){e.q(`Loading tasks from TypeScript file: ${i.tasksTs}`,`info`),c=o;try{let t=await import(o);a=t.default??t.tasks??[],(!Array.isArray(a)||a.length===0)&&(e.q(`⚠️  No tasks found in TypeScript file or invalid format`,`warn`),e.q(`Expected default export or named export "tasks" with TaskDefinition[]`,`info`))}catch(t){e.q(`Failed to load TypeScript tasks file: ${i.tasksTs}`,`error`),t instanceof Error&&e.q(`  Error: ${t.message}`,`error`),r.default.exit(1)}}}if(a.length===0&&i.tasksFile!=null&&i.tasksFile!==``){let l=n.default.resolve(r.default.cwd(),i.tasksFile);if(t.default.existsSync(l)){c=l;try{let t=await e.a(l);a=t.tasks,o=t.variables,s=t.prompts,Array.isArray(a)||(e.q(`❌ Invalid tasks file format`,`error`),e.q(`Expected JSON with { "tasks": [...] } structure`,`info`),r.default.exit(1))}catch(t){e.q(`Failed to load JSON tasks file: ${i.tasksFile}`,`error`),t instanceof Error&&e.q(`  Error: ${t.message}`,`error`),r.default.exit(1)}}else e.q(`Tasks file not found: ${i.tasksFile}`,`warn`)}a.length===0&&(e.q(`❌ No tasks defined`,`error`),console.log(``),e.q(`Please provide tasks using one of these methods:`,`info`),e.q(`  1. Create a template-tasks.json file in the current directory`,`info`),e.q(`  2. Create a template-tasks.ts file in the current directory`,`info`),e.q(`  3. Use --tasks-file option to specify a different JSON file`,`info`),e.q(`  4. Use --tasks-ts option to specify a different TypeScript file`,`info`),console.log(``),e.q(`Example JSON structure:`,`info`),console.log(JSON.stringify({tasks:[{id:`update-package`,name:`Update package.json`,description:`Update package.json with repository information`,required:!0,enabled:!0,type:`update-json`,prompts:[{id:`projectName`,type:`input`,message:`What is your project name?`,default:`my-project`,required:!0},{id:`includeTests`,type:`confirm`,message:`Include test files?`,default:!0}],config:{file:`package.json`,updates:{name:`{{projectName}}`,author:`{{author}}`}}}]},null,2)),console.log(``),r.default.exit(1)),console.log(``),e.q(`Loaded ${a.length} task(s)`,`success`),console.log(``),await e.n(a,{dryRun:i.dryRun,force:i.force,tasksFilePath:c,globalVariables:o,globalPrompts:s})}catch(t){if(e.q(`❌ CLI execution failed`,`error`),t instanceof Error){e.q(`Error: ${t.message}`,`error`);let n=r.default.env.DEBUG;n!=null&&n!==``&&console.error(t.stack)}else console.error(t);r.default.exit(1)}}),o.parse(r.default.argv);

package/dist/cli.js

@@ -1,2 +1,2 @@
 #!/usr/bin/env node
-import{U as e,a as t,n}from"./src-RfAsa6ai.js";import r from"node:path";import{fileURLToPath as i}from"node:url";import a from"node:fs";import o from"node:process";import{Command as s}from"commander";const c=()=>i(import.meta.url),l=(()=>r.dirname(c()))(),u=new s,d=r.join(l,`..`,`package.json`);let f=`0.0.0`;try{f=JSON.parse(a.readFileSync(d,`utf-8`)).version??`0.0.0`}catch{}u.name(`scaffoldfy`).description(`Initialize and configure project templates with customizable tasks`).version(f),u.option(`--dry-run`,`Run in dry mode without making any changes`).option(`--force`,`Force re-initialization even if already initialized`).option(`--tasks-file <path>`,`Path to JSON file containing task definitions`,`./template-tasks.json`).option(`--tasks-ts <path>`,`Path to TypeScript file exporting tasks`,`./template-tasks.ts`).action(async i=>{try{let s=[],c;if(i.tasksTs!=null&&i.tasksTs!==``){let t=r.resolve(o.cwd(),i.tasksTs);if(a.existsSync(t)){e(`Loading tasks from TypeScript file: ${i.tasksTs}`,`info`),c=t;try{let n=await import(t);s=n.default??n.tasks??[],(!Array.isArray(s)||s.length===0)&&(e(`⚠️  No tasks found in TypeScript file or invalid format`,`warn`),e(`Expected default export or named export "tasks" with TaskDefinition[]`,`info`))}catch(t){e(`Failed to load TypeScript tasks file: ${i.tasksTs}`,`error`),t instanceof Error&&e(`  Error: ${t.message}`,`error`),o.exit(1)}}}if(s.length===0&&i.tasksFile!=null&&i.tasksFile!==``){let n=r.resolve(o.cwd(),i.tasksFile);if(a.existsSync(n)){c=n;try{s=await t(n),Array.isArray(s)||(e(`❌ Invalid tasks file format`,`error`),e(`Expected JSON with { "tasks": [...] } structure`,`info`),o.exit(1))}catch(t){e(`Failed to load JSON tasks file: ${i.tasksFile}`,`error`),t instanceof Error&&e(`  Error: ${t.message}`,`error`),o.exit(1)}}else e(`Tasks file not found: ${i.tasksFile}`,`warn`)}s.length===0&&(e(`❌ No tasks defined`,`error`),console.log(``),e(`Please provide tasks using one of these methods:`,`info`),e(`  1. Create a template-tasks.json file in the current directory`,`info`),e(`  2. Create a template-tasks.ts file in the current directory`,`info`),e(`  3. Use --tasks-file option to specify a different JSON file`,`info`),e(`  4. Use --tasks-ts option to specify a different TypeScript file`,`info`),console.log(``),e(`Example JSON structure:`,`info`),console.log(JSON.stringify({tasks:[{id:`update-package`,name:`Update package.json`,description:`Update package.json with repository information`,required:!0,enabled:!0,type:`update-json`,prompts:[{id:`projectName`,type:`input`,message:`What is your project name?`,default:`my-project`,required:!0},{id:`includeTests`,type:`confirm`,message:`Include test files?`,default:!0}],config:{file:`package.json`,updates:{name:`{{projectName}}`,author:`{{author}}`}}}]},null,2)),console.log(``),o.exit(1)),console.log(``),e(`Loaded ${s.length} task(s)`,`success`),console.log(``),await n(s,{dryRun:i.dryRun,force:i.force,tasksFilePath:c})}catch(t){if(e(`❌ CLI execution failed`,`error`),t instanceof Error){e(`Error: ${t.message}`,`error`);let n=o.env.DEBUG;n!=null&&n!==``&&console.error(t.stack)}else console.error(t);o.exit(1)}}),u.parse(o.argv);export{};
+import{a as e,n as t,q as n}from"./src-IzX9FHaO.js";import r from"node:path";import{fileURLToPath as i}from"node:url";import a from"node:fs";import o from"node:process";import{Command as s}from"commander";const c=()=>i(import.meta.url),l=(()=>r.dirname(c()))(),u=new s,d=r.join(l,`..`,`package.json`);let f=`0.0.0`;try{f=JSON.parse(a.readFileSync(d,`utf-8`)).version??`0.0.0`}catch{}u.name(`scaffoldfy`).description(`Initialize and configure project templates with customizable tasks`).version(f),u.option(`--dry-run`,`Run in dry mode without making any changes`).option(`--force`,`Force re-initialization even if already initialized`).option(`--tasks-file <path>`,`Path to JSON file containing task definitions`,`./template-tasks.json`).option(`--tasks-ts <path>`,`Path to TypeScript file exporting tasks`,`./template-tasks.ts`).action(async i=>{try{let s=[],c,l,u;if(i.tasksTs!=null&&i.tasksTs!==``){let e=r.resolve(o.cwd(),i.tasksTs);if(a.existsSync(e)){n(`Loading tasks from TypeScript file: ${i.tasksTs}`,`info`),u=e;try{let t=await import(e);s=t.default??t.tasks??[],(!Array.isArray(s)||s.length===0)&&(n(`⚠️  No tasks found in TypeScript file or invalid format`,`warn`),n(`Expected default export or named export "tasks" with TaskDefinition[]`,`info`))}catch(e){n(`Failed to load TypeScript tasks file: ${i.tasksTs}`,`error`),e instanceof Error&&n(`  Error: ${e.message}`,`error`),o.exit(1)}}}if(s.length===0&&i.tasksFile!=null&&i.tasksFile!==``){let t=r.resolve(o.cwd(),i.tasksFile);if(a.existsSync(t)){u=t;try{let r=await e(t);s=r.tasks,c=r.variables,l=r.prompts,Array.isArray(s)||(n(`❌ Invalid tasks file format`,`error`),n(`Expected JSON with { "tasks": [...] } structure`,`info`),o.exit(1))}catch(e){n(`Failed to load JSON tasks file: ${i.tasksFile}`,`error`),e instanceof Error&&n(`  Error: ${e.message}`,`error`),o.exit(1)}}else n(`Tasks file not found: ${i.tasksFile}`,`warn`)}s.length===0&&(n(`❌ No tasks defined`,`error`),console.log(``),n(`Please provide tasks using one of these methods:`,`info`),n(`  1. Create a template-tasks.json file in the current directory`,`info`),n(`  2. Create a template-tasks.ts file in the current directory`,`info`),n(`  3. Use --tasks-file option to specify a different JSON file`,`info`),n(`  4. Use --tasks-ts option to specify a different TypeScript file`,`info`),console.log(``),n(`Example JSON structure:`,`info`),console.log(JSON.stringify({tasks:[{id:`update-package`,name:`Update package.json`,description:`Update package.json with repository information`,required:!0,enabled:!0,type:`update-json`,prompts:[{id:`projectName`,type:`input`,message:`What is your project name?`,default:`my-project`,required:!0},{id:`includeTests`,type:`confirm`,message:`Include test files?`,default:!0}],config:{file:`package.json`,updates:{name:`{{projectName}}`,author:`{{author}}`}}}]},null,2)),console.log(``),o.exit(1)),console.log(``),n(`Loaded ${s.length} task(s)`,`success`),console.log(``),await t(s,{dryRun:i.dryRun,force:i.force,tasksFilePath:u,globalVariables:c,globalPrompts:l})}catch(e){if(n(`❌ CLI execution failed`,`error`),e instanceof Error){n(`Error: ${e.message}`,`error`);let t=o.env.DEBUG;t!=null&&t!==``&&console.error(e.stack)}else console.error(e);o.exit(1)}}),u.parse(o.argv);export{};

package/dist/index.cjs

@@ -1 +1 @@
-const e=require(`./src-CFP-DJ0M.cjs`);exports.callHook=e._,exports.clearPlugins=e.v,exports.clearTemplateCache=e.r,exports.collectPrompts=e.g,exports.createPlugin=e.y,exports.displayTasksDiff=e.A,exports.evaluateCondition=e.B,exports.executePluginTask=e.b,exports.executeTask=e.l,exports.getDeleteDiff=e.j,exports.getExecDiff=e.M,exports.getGitInitDiff=e.N,exports.getGitRepoInfo=e.V,exports.getPlugin=e.x,exports.getPluginForTaskType=e.S,exports.getPluginTaskDiff=e.C,exports.getRegexReplaceDiff=e.P,exports.getRenameDiff=e.F,exports.getReplaceInFileDiff=e.I,exports.getTaskDiff=e.L,exports.getTemplateDiff=e.R,exports.getUpdateJsonDiff=e.z,exports.interpolateTemplate=e.H,exports.isPluginTaskType=e.w,exports.listPlugins=e.T,exports.loadAndMergeTemplate=e.i,exports.loadInitializationState=e.d,exports.loadTasksWithInheritance=e.a,exports.loadTemplate=e.o,exports.log=e.U,exports.main=e.t,exports.mergeTemplates=e.s,exports.prompt=e.W,exports.promptYesNo=e.G,exports.registerHooks=e.E,exports.registerPlugin=e.D,exports.resolveAllDefaultValues=e.m,exports.resolveDefaultValue=e.h,exports.runTask=e.u,exports.runWithTasks=e.n,exports.saveInitializationState=e.f,exports.setNestedProperty=e.K,exports.topologicalSort=e.c,exports.unregisterPlugin=e.O,exports.validatePluginTask=e.k,exports.validatePrompts=e.p;
+const e=require(`./src-DxvGGX8s.cjs`);exports.callHook=e.x,exports.clearPlugins=e.S,exports.clearTemplateCache=e.r,exports.collectPrompts=e.b,exports.collectVariables=e.d,exports.createPlugin=e.C,exports.displayTasksDiff=e.P,exports.evaluateCondition=e.W,exports.executePluginTask=e.w,exports.executeTask=e.p,exports.getDeleteDiff=e.F,exports.getExecDiff=e.I,exports.getGitInitDiff=e.L,exports.getGitRepoInfo=e.G,exports.getPlugin=e.T,exports.getPluginForTaskType=e.E,exports.getPluginTaskDiff=e.D,exports.getRegexReplaceDiff=e.R,exports.getRenameDiff=e.z,exports.getReplaceInFileDiff=e.B,exports.getTaskDiff=e.V,exports.getTemplateDiff=e.H,exports.getUpdateJsonDiff=e.U,exports.interpolateTemplate=e.K,exports.isPluginTaskType=e.O,exports.listPlugins=e.k,exports.loadAndMergeTemplate=e.i,exports.loadInitializationState=e.h,exports.loadTasksWithInheritance=e.a,exports.loadTemplate=e.o,exports.log=e.q,exports.main=e.t,exports.mergeTemplates=e.s,exports.prompt=e.J,exports.promptYesNo=e.Y,exports.registerHooks=e.A,exports.registerPlugin=e.j,exports.resolveAllDefaultValues=e.v,exports.resolveAllVariableValues=e.l,exports.resolveDefaultValue=e.y,exports.resolveVariableValue=e.u,exports.runTask=e.m,exports.runWithTasks=e.n,exports.saveInitializationState=e.g,exports.setNestedProperty=e.X,exports.topologicalSort=e.f,exports.unregisterPlugin=e.M,exports.validatePluginTask=e.N,exports.validatePrompts=e._,exports.validateVariables=e.c;

package/dist/index.d.cts

@@ -1,7 +1,75 @@
+//#region src/plugins/create/types.d.ts
+
+interface CreateConfig {
+  file: string;
+  template?: string;
+  templateFile?: string;
+  condition?: ConditionExpression;
+}
+//#endregion
+//#region src/plugins/delete/types.d.ts
+interface DeleteConfig {
+  paths: string[];
+  condition?: ConditionExpression;
+}
+//#endregion
+//#region src/plugins/exec/types.d.ts
+interface ExecConfig {
+  command: string;
+  cwd?: string;
+  condition?: ConditionExpression;
+}
+//#endregion
+//#region src/plugins/git-init/types.d.ts
+interface GitInitConfig {
+  removeExisting: boolean;
+  initialCommit: boolean;
+  message?: string;
+  condition?: ConditionExpression;
+}
+//#endregion
+//#region src/plugins/regex-replace/types.d.ts
+interface RegexReplaceConfig {
+  file: string;
+  pattern: string;
+  flags?: string;
+  replacement: string;
+  condition?: ConditionExpression;
+}
+//#endregion
+//#region src/plugins/rename/types.d.ts
+interface RenameConfig {
+  from: string;
+  to: string;
+  condition?: ConditionExpression;
+}
+//#endregion
+//#region src/plugins/replace-in-file/types.d.ts
+interface ReplaceInFileConfig {
+  file: string;
+  replacements: Array<{
+    find: string;
+    replace: string;
+  }>;
+  condition?: ConditionExpression;
+}
+//#endregion
+//#region src/plugins/template/types.d.ts
+interface TemplateConfig {
+  file: string;
+  template?: string;
+  templateFile?: string;
+  condition?: ConditionExpression;
+}
+//#endregion
+//#region src/plugins/update-json/types.d.ts
+interface UpdateJsonConfig {
+  file: string;
+  updates: Record<string, unknown>;
+  condition?: ConditionExpression;
+}
+//#endregion
 //#region src/types.d.ts
-/**
- * Task Types and Interfaces for Template Initialization
- */
 interface InitConfig {
   [key: string]: unknown;
 }
@@ -29,12 +97,23 @@ interface DefaultValueConfig<T = string | number | boolean> {
  * - For explicit static values, use { type: 'static', value: yourValue }
  */
 type DefaultValue<T = string | number | boolean> = T | DefaultValueConfig<T>;
+/**
+ * Conditional enabled configuration for prompts and tasks
+ * Allows dynamic enabling/disabling based on runtime conditions
+ */
+interface ConditionalEnabled {
+  condition: ConditionExpression;
+}
+/**
+ * Type for enabled field that can be boolean or conditional
+ */
+type EnabledValue = boolean | ConditionalEnabled;
 interface BasePrompt {
   id: string;
   type: PromptType;
   message: string;
   required?: boolean;
-  global?: boolean;
+  enabled?: EnabledValue;
 }
 interface InputPrompt extends BasePrompt {
   type: 'input' | 'password';
@@ -60,15 +139,26 @@ interface ConfirmPrompt extends BasePrompt {
   default?: DefaultValue<boolean>;
 }
 type PromptDefinition = InputPrompt | NumberPrompt | SelectPrompt | ConfirmPrompt;
+/**
+ * Variable value configuration for defining optional global or task-scoped variables
+ * Variables are similar to prompts but don't require user input - they can have static
+ * values or values resolved from executable commands
+ *
+ * Note: Top-level variables are always global. Task-level variables are task-scoped.
+ */
+interface VariableDefinition {
+  id: string;
+  value: DefaultValue;
+}
 /**
  * JavaScript expression evaluated at runtime to determine if a task or operation should execute.
- * Has access to all prompt values and config variables.
+ * Has access to all prompt values, variables, and config variables.
  * @example "useTypeScript === true"
  * @example "nodeVersion >= 16 && includeTests === true"
  * @example "packageManager === 'pnpm'"
  */
 type ConditionExpression = string;
-type TaskType = 'update-json' | 'template' | 'regex-replace' | 'replace-in-file' | 'delete' | 'rename' | 'git-init' | 'exec';
+type TaskType = 'update-json' | 'template' | 'create' | 'regex-replace' | 'replace-in-file' | 'delete' | 'rename' | 'git-init' | 'exec';
 interface RollbackConfig {
   type: TaskType;
   config: unknown;
@@ -78,58 +168,13 @@ interface TaskDefinition {
   name: string;
   description: string;
   required: boolean;
-  enabled: boolean;
+  enabled: EnabledValue;
   type: TaskType;
-  config: UpdateJsonConfig | TemplateConfig | RegexReplaceConfig | ReplaceInFileConfig | DeleteConfig | RenameConfig | GitInitConfig | ExecConfig | Record<string, unknown>;
+  config: UpdateJsonConfig | TemplateConfig | CreateConfig | RegexReplaceConfig | ReplaceInFileConfig | DeleteConfig | RenameConfig | GitInitConfig | ExecConfig | Record<string, unknown>;
   dependencies?: string[];
   rollback?: RollbackConfig;
   prompts?: PromptDefinition[];
-}
-interface UpdateJsonConfig {
-  file: string;
-  updates: Record<string, unknown>;
-  condition?: ConditionExpression;
-}
-interface TemplateConfig {
-  file: string;
-  template?: string;
-  templateFile?: string;
-  condition?: ConditionExpression;
-}
-interface RegexReplaceConfig {
-  file: string;
-  pattern: string;
-  flags?: string;
-  replacement: string;
-  condition?: ConditionExpression;
-}
-interface ReplaceInFileConfig {
-  file: string;
-  replacements: Array<{
-    find: string;
-    replace: string;
-  }>;
-  condition?: ConditionExpression;
-}
-interface DeleteConfig {
-  paths: string[];
-  condition?: ConditionExpression;
-}
-interface RenameConfig {
-  from: string;
-  to: string;
-  condition?: ConditionExpression;
-}
-interface GitInitConfig {
-  removeExisting: boolean;
-  initialCommit: boolean;
-  message?: string;
-  condition?: ConditionExpression;
-}
-interface ExecConfig {
-  command: string;
-  cwd?: string;
-  condition?: ConditionExpression;
+  variables?: VariableDefinition[];
 }
 interface InitializationMetadata {
   initializedAt: string;
@@ -142,6 +187,8 @@ interface InitializationMetadata {
  */
 interface TasksConfiguration {
   extends?: string | string[];
+  variables?: VariableDefinition[];
+  prompts?: PromptDefinition[];
   tasks: TaskDefinition[];
 }
 /**
@@ -319,11 +366,13 @@ declare function createPlugin(name: string, taskType: string, execute: (task: Ta
 //#region src/prompts/collect-prompts.d.ts
 /**
  * Collect prompt answers from task-defined prompts
+ * Only prompts with enabled=true (or enabled condition that evaluates to true) will be shown
  * @param prompts - Array of prompt definitions from tasks
  * @param resolvedDefaults - Map of pre-resolved default values
+ * @param config - Current configuration context (for evaluating enabled conditions)
  * @returns Object mapping prompt IDs to their values
  */
-declare function collectPrompts(prompts: PromptDefinition[], resolvedDefaults?: Map<string, unknown>): Promise<Record<string, unknown>>;
+declare function collectPrompts(prompts: PromptDefinition[], resolvedDefaults?: Map<string, unknown>, config?: InitConfig): Promise<Record<string, unknown>>;
 //#endregion
 //#region src/prompts/resolve-all-default-values.d.ts
 /**
@@ -406,9 +455,13 @@ declare function clearTemplateCache(): void;
 /**
  * Load tasks from a configuration file with template inheritance support
  * @param tasksFilePath - Path to the tasks configuration file
- * @returns Array of task definitions
+ * @returns Task configuration with tasks, optional variables, and optional prompts
  */
-declare function loadTasksWithInheritance(tasksFilePath: string): Promise<TaskDefinition[]>;
+declare function loadTasksWithInheritance(tasksFilePath: string): Promise<{
+  tasks: TaskDefinition[];
+  variables?: VariableDefinition[];
+  prompts?: PromptDefinition[];
+}>;
 //#endregion
 //#region src/utils.d.ts
 /**
@@ -444,6 +497,43 @@ declare function setNestedProperty(obj: Record<string, unknown>, propertyPath: s
  */
 declare function evaluateCondition(condition: string, config: InitConfig): boolean;
 //#endregion
+//#region src/variables/collect-variables.d.ts
+/**
+ * Collect variable values from resolved variables
+ * Variables don't require user interaction - they're just resolved from static
+ * values or executable commands
+ *
+ * @param variables - Array of variable definitions
+ * @param resolvedValues - Map of pre-resolved variable values
+ * @returns Object mapping variable IDs to their values
+ */
+declare function collectVariables(variables: VariableDefinition[], resolvedValues?: Map<string, unknown>): Record<string, unknown>;
+//#endregion
+//#region src/variables/resolve-all-variable-values.d.ts
+/**
+ * Pre-resolve all variable values (execute commands in parallel for efficiency)
+ * @param variables - Array of variable definitions
+ * @returns Map of variable IDs to their resolved values
+ */
+declare function resolveAllVariableValues(variables: VariableDefinition[]): Promise<Map<string, unknown>>;
+//#endregion
+//#region src/variables/resolve-variable-value.d.ts
+/**
+ * Resolve a variable value that may be static or executable
+ * @param value - The variable value configuration
+ * @param variableId - The variable ID for error reporting
+ * @returns The resolved variable value
+ */
+declare function resolveVariableValue<T = string | number | boolean>(value: DefaultValue<T>, variableId: string): Promise<T | undefined>;
+//#endregion
+//#region src/variables/validate-variables.d.ts
+/**
+ * Validate variable definitions for common errors
+ * @param variables - Array of variable definitions to validate
+ * @returns Array of error messages (empty if no errors)
+ */
+declare function validateVariables(variables: VariableDefinition[]): string[];
+//#endregion
 //#region src/index.d.ts
 /**
  * Main function for running initialization with default/empty tasks
@@ -457,11 +547,15 @@ declare function main(customTasks?: TaskDefinition[]): Promise<void>;
  * @param options.dryRun - Preview changes without applying them
  * @param options.force - Force re-initialization even if already initialized
  * @param options.tasksFilePath - Path to the tasks file
+ * @param options.globalVariables - Optional top-level global variables
+ * @param options.globalPrompts - Optional top-level global prompts
  */
 declare function runWithTasks(customTasks: TaskDefinition[], options?: {
   dryRun?: boolean | undefined;
   force?: boolean | undefined;
   tasksFilePath?: string | undefined;
+  globalVariables?: VariableDefinition[] | undefined;
+  globalPrompts?: PromptDefinition[] | undefined;
 }): Promise<void>;
 //#endregion
-export { BasePrompt, ConditionExpression, ConfirmPrompt, DefaultValue, DefaultValueConfig, DefaultValueType, DeleteConfig, ExecConfig, GitInitConfig, InitConfig, InitializationMetadata, InputPrompt, NumberPrompt, PluginHooks, PromptDefinition, PromptType, RegexReplaceConfig, RenameConfig, ReplaceInFileConfig, RollbackConfig, SelectPrompt, TaskDefinition, TaskPlugin, TaskType, TasksConfiguration, TemplateConfig, UpdateJsonConfig, callHook, clearPlugins, clearTemplateCache, collectPrompts, createPlugin, displayTasksDiff, evaluateCondition, executePluginTask, executeTask, getDeleteDiff, getExecDiff, getGitInitDiff, getGitRepoInfo, getPlugin, getPluginForTaskType, getPluginTaskDiff, getRegexReplaceDiff, getRenameDiff, getReplaceInFileDiff, getTaskDiff, getTemplateDiff, getUpdateJsonDiff, interpolateTemplate, isPluginTaskType, listPlugins, loadAndMergeTemplate, loadInitializationState, loadTasksWithInheritance, loadTemplate, log, main, mergeTemplates, prompt, promptYesNo, registerHooks, registerPlugin, resolveAllDefaultValues, resolveDefaultValue, runTask, runWithTasks, saveInitializationState, setNestedProperty, topologicalSort, unregisterPlugin, validatePluginTask, validatePrompts };
+export { BasePrompt, ConditionExpression, ConditionalEnabled, ConfirmPrompt, type CreateConfig, DefaultValue, DefaultValueConfig, DefaultValueType, type DeleteConfig, EnabledValue, type ExecConfig, type GitInitConfig, InitConfig, InitializationMetadata, InputPrompt, NumberPrompt, PluginHooks, PromptDefinition, PromptType, type RegexReplaceConfig, type RenameConfig, type ReplaceInFileConfig, RollbackConfig, SelectPrompt, TaskDefinition, TaskPlugin, TaskType, TasksConfiguration, type TemplateConfig, type UpdateJsonConfig, VariableDefinition, callHook, clearPlugins, clearTemplateCache, collectPrompts, collectVariables, createPlugin, displayTasksDiff, evaluateCondition, executePluginTask, executeTask, getDeleteDiff, getExecDiff, getGitInitDiff, getGitRepoInfo, getPlugin, getPluginForTaskType, getPluginTaskDiff, getRegexReplaceDiff, getRenameDiff, getReplaceInFileDiff, getTaskDiff, getTemplateDiff, getUpdateJsonDiff, interpolateTemplate, isPluginTaskType, listPlugins, loadAndMergeTemplate, loadInitializationState, loadTasksWithInheritance, loadTemplate, log, main, mergeTemplates, prompt, promptYesNo, registerHooks, registerPlugin, resolveAllDefaultValues, resolveAllVariableValues, resolveDefaultValue, resolveVariableValue, runTask, runWithTasks, saveInitializationState, setNestedProperty, topologicalSort, unregisterPlugin, validatePluginTask, validatePrompts, validateVariables };

package/dist/index.d.ts

@@ -1,7 +1,75 @@
+//#region src/plugins/create/types.d.ts
+
+interface CreateConfig {
+  file: string;
+  template?: string;
+  templateFile?: string;
+  condition?: ConditionExpression;
+}
+//#endregion
+//#region src/plugins/delete/types.d.ts
+interface DeleteConfig {
+  paths: string[];
+  condition?: ConditionExpression;
+}
+//#endregion
+//#region src/plugins/exec/types.d.ts
+interface ExecConfig {
+  command: string;
+  cwd?: string;
+  condition?: ConditionExpression;
+}
+//#endregion
+//#region src/plugins/git-init/types.d.ts
+interface GitInitConfig {
+  removeExisting: boolean;
+  initialCommit: boolean;
+  message?: string;
+  condition?: ConditionExpression;
+}
+//#endregion
+//#region src/plugins/regex-replace/types.d.ts
+interface RegexReplaceConfig {
+  file: string;
+  pattern: string;
+  flags?: string;
+  replacement: string;
+  condition?: ConditionExpression;
+}
+//#endregion
+//#region src/plugins/rename/types.d.ts
+interface RenameConfig {
+  from: string;
+  to: string;
+  condition?: ConditionExpression;
+}
+//#endregion
+//#region src/plugins/replace-in-file/types.d.ts
+interface ReplaceInFileConfig {
+  file: string;
+  replacements: Array<{
+    find: string;
+    replace: string;
+  }>;
+  condition?: ConditionExpression;
+}
+//#endregion
+//#region src/plugins/template/types.d.ts
+interface TemplateConfig {
+  file: string;
+  template?: string;
+  templateFile?: string;
+  condition?: ConditionExpression;
+}
+//#endregion
+//#region src/plugins/update-json/types.d.ts
+interface UpdateJsonConfig {
+  file: string;
+  updates: Record<string, unknown>;
+  condition?: ConditionExpression;
+}
+//#endregion
 //#region src/types.d.ts
-/**
- * Task Types and Interfaces for Template Initialization
- */
 interface InitConfig {
   [key: string]: unknown;
 }
@@ -29,12 +97,23 @@ interface DefaultValueConfig<T = string | number | boolean> {
  * - For explicit static values, use { type: 'static', value: yourValue }
  */
 type DefaultValue<T = string | number | boolean> = T | DefaultValueConfig<T>;
+/**
+ * Conditional enabled configuration for prompts and tasks
+ * Allows dynamic enabling/disabling based on runtime conditions
+ */
+interface ConditionalEnabled {
+  condition: ConditionExpression;
+}
+/**
+ * Type for enabled field that can be boolean or conditional
+ */
+type EnabledValue = boolean | ConditionalEnabled;
 interface BasePrompt {
   id: string;
   type: PromptType;
   message: string;
   required?: boolean;
-  global?: boolean;
+  enabled?: EnabledValue;
 }
 interface InputPrompt extends BasePrompt {
   type: 'input' | 'password';
@@ -60,15 +139,26 @@ interface ConfirmPrompt extends BasePrompt {
   default?: DefaultValue<boolean>;
 }
 type PromptDefinition = InputPrompt | NumberPrompt | SelectPrompt | ConfirmPrompt;
+/**
+ * Variable value configuration for defining optional global or task-scoped variables
+ * Variables are similar to prompts but don't require user input - they can have static
+ * values or values resolved from executable commands
+ *
+ * Note: Top-level variables are always global. Task-level variables are task-scoped.
+ */
+interface VariableDefinition {
+  id: string;
+  value: DefaultValue;
+}
 /**
  * JavaScript expression evaluated at runtime to determine if a task or operation should execute.
- * Has access to all prompt values and config variables.
+ * Has access to all prompt values, variables, and config variables.
  * @example "useTypeScript === true"
  * @example "nodeVersion >= 16 && includeTests === true"
  * @example "packageManager === 'pnpm'"
  */
 type ConditionExpression = string;
-type TaskType = 'update-json' | 'template' | 'regex-replace' | 'replace-in-file' | 'delete' | 'rename' | 'git-init' | 'exec';
+type TaskType = 'update-json' | 'template' | 'create' | 'regex-replace' | 'replace-in-file' | 'delete' | 'rename' | 'git-init' | 'exec';
 interface RollbackConfig {
   type: TaskType;
   config: unknown;
@@ -78,58 +168,13 @@ interface TaskDefinition {
   name: string;
   description: string;
   required: boolean;
-  enabled: boolean;
+  enabled: EnabledValue;
   type: TaskType;
-  config: UpdateJsonConfig | TemplateConfig | RegexReplaceConfig | ReplaceInFileConfig | DeleteConfig | RenameConfig | GitInitConfig | ExecConfig | Record<string, unknown>;
+  config: UpdateJsonConfig | TemplateConfig | CreateConfig | RegexReplaceConfig | ReplaceInFileConfig | DeleteConfig | RenameConfig | GitInitConfig | ExecConfig | Record<string, unknown>;
   dependencies?: string[];
   rollback?: RollbackConfig;
   prompts?: PromptDefinition[];
-}
-interface UpdateJsonConfig {
-  file: string;
-  updates: Record<string, unknown>;
-  condition?: ConditionExpression;
-}
-interface TemplateConfig {
-  file: string;
-  template?: string;
-  templateFile?: string;
-  condition?: ConditionExpression;
-}
-interface RegexReplaceConfig {
-  file: string;
-  pattern: string;
-  flags?: string;
-  replacement: string;
-  condition?: ConditionExpression;
-}
-interface ReplaceInFileConfig {
-  file: string;
-  replacements: Array<{
-    find: string;
-    replace: string;
-  }>;
-  condition?: ConditionExpression;
-}
-interface DeleteConfig {
-  paths: string[];
-  condition?: ConditionExpression;
-}
-interface RenameConfig {
-  from: string;
-  to: string;
-  condition?: ConditionExpression;
-}
-interface GitInitConfig {
-  removeExisting: boolean;
-  initialCommit: boolean;
-  message?: string;
-  condition?: ConditionExpression;
-}
-interface ExecConfig {
-  command: string;
-  cwd?: string;
-  condition?: ConditionExpression;
+  variables?: VariableDefinition[];
 }
 interface InitializationMetadata {
   initializedAt: string;
@@ -142,6 +187,8 @@ interface InitializationMetadata {
  */
 interface TasksConfiguration {
   extends?: string | string[];
+  variables?: VariableDefinition[];
+  prompts?: PromptDefinition[];
   tasks: TaskDefinition[];
 }
 /**
@@ -319,11 +366,13 @@ declare function createPlugin(name: string, taskType: string, execute: (task: Ta
 //#region src/prompts/collect-prompts.d.ts
 /**
  * Collect prompt answers from task-defined prompts
+ * Only prompts with enabled=true (or enabled condition that evaluates to true) will be shown
  * @param prompts - Array of prompt definitions from tasks
  * @param resolvedDefaults - Map of pre-resolved default values
+ * @param config - Current configuration context (for evaluating enabled conditions)
  * @returns Object mapping prompt IDs to their values
  */
-declare function collectPrompts(prompts: PromptDefinition[], resolvedDefaults?: Map<string, unknown>): Promise<Record<string, unknown>>;
+declare function collectPrompts(prompts: PromptDefinition[], resolvedDefaults?: Map<string, unknown>, config?: InitConfig): Promise<Record<string, unknown>>;
 //#endregion
 //#region src/prompts/resolve-all-default-values.d.ts
 /**
@@ -406,9 +455,13 @@ declare function clearTemplateCache(): void;
 /**
  * Load tasks from a configuration file with template inheritance support
  * @param tasksFilePath - Path to the tasks configuration file
- * @returns Array of task definitions
+ * @returns Task configuration with tasks, optional variables, and optional prompts
  */
-declare function loadTasksWithInheritance(tasksFilePath: string): Promise<TaskDefinition[]>;
+declare function loadTasksWithInheritance(tasksFilePath: string): Promise<{
+  tasks: TaskDefinition[];
+  variables?: VariableDefinition[];
+  prompts?: PromptDefinition[];
+}>;
 //#endregion
 //#region src/utils.d.ts
 /**
@@ -444,6 +497,43 @@ declare function setNestedProperty(obj: Record<string, unknown>, propertyPath: s
  */
 declare function evaluateCondition(condition: string, config: InitConfig): boolean;
 //#endregion
+//#region src/variables/collect-variables.d.ts
+/**
+ * Collect variable values from resolved variables
+ * Variables don't require user interaction - they're just resolved from static
+ * values or executable commands
+ *
+ * @param variables - Array of variable definitions
+ * @param resolvedValues - Map of pre-resolved variable values
+ * @returns Object mapping variable IDs to their values
+ */
+declare function collectVariables(variables: VariableDefinition[], resolvedValues?: Map<string, unknown>): Record<string, unknown>;
+//#endregion
+//#region src/variables/resolve-all-variable-values.d.ts
+/**
+ * Pre-resolve all variable values (execute commands in parallel for efficiency)
+ * @param variables - Array of variable definitions
+ * @returns Map of variable IDs to their resolved values
+ */
+declare function resolveAllVariableValues(variables: VariableDefinition[]): Promise<Map<string, unknown>>;
+//#endregion
+//#region src/variables/resolve-variable-value.d.ts
+/**
+ * Resolve a variable value that may be static or executable
+ * @param value - The variable value configuration
+ * @param variableId - The variable ID for error reporting
+ * @returns The resolved variable value
+ */
+declare function resolveVariableValue<T = string | number | boolean>(value: DefaultValue<T>, variableId: string): Promise<T | undefined>;
+//#endregion
+//#region src/variables/validate-variables.d.ts
+/**
+ * Validate variable definitions for common errors
+ * @param variables - Array of variable definitions to validate
+ * @returns Array of error messages (empty if no errors)
+ */
+declare function validateVariables(variables: VariableDefinition[]): string[];
+//#endregion
 //#region src/index.d.ts
 /**
  * Main function for running initialization with default/empty tasks
@@ -457,11 +547,15 @@ declare function main(customTasks?: TaskDefinition[]): Promise<void>;
  * @param options.dryRun - Preview changes without applying them
  * @param options.force - Force re-initialization even if already initialized
  * @param options.tasksFilePath - Path to the tasks file
+ * @param options.globalVariables - Optional top-level global variables
+ * @param options.globalPrompts - Optional top-level global prompts
  */
 declare function runWithTasks(customTasks: TaskDefinition[], options?: {
   dryRun?: boolean | undefined;
   force?: boolean | undefined;
   tasksFilePath?: string | undefined;
+  globalVariables?: VariableDefinition[] | undefined;
+  globalPrompts?: PromptDefinition[] | undefined;
 }): Promise<void>;
 //#endregion
-export { BasePrompt, ConditionExpression, ConfirmPrompt, DefaultValue, DefaultValueConfig, DefaultValueType, DeleteConfig, ExecConfig, GitInitConfig, InitConfig, InitializationMetadata, InputPrompt, NumberPrompt, PluginHooks, PromptDefinition, PromptType, RegexReplaceConfig, RenameConfig, ReplaceInFileConfig, RollbackConfig, SelectPrompt, TaskDefinition, TaskPlugin, TaskType, TasksConfiguration, TemplateConfig, UpdateJsonConfig, callHook, clearPlugins, clearTemplateCache, collectPrompts, createPlugin, displayTasksDiff, evaluateCondition, executePluginTask, executeTask, getDeleteDiff, getExecDiff, getGitInitDiff, getGitRepoInfo, getPlugin, getPluginForTaskType, getPluginTaskDiff, getRegexReplaceDiff, getRenameDiff, getReplaceInFileDiff, getTaskDiff, getTemplateDiff, getUpdateJsonDiff, interpolateTemplate, isPluginTaskType, listPlugins, loadAndMergeTemplate, loadInitializationState, loadTasksWithInheritance, loadTemplate, log, main, mergeTemplates, prompt, promptYesNo, registerHooks, registerPlugin, resolveAllDefaultValues, resolveDefaultValue, runTask, runWithTasks, saveInitializationState, setNestedProperty, topologicalSort, unregisterPlugin, validatePluginTask, validatePrompts };
+export { BasePrompt, ConditionExpression, ConditionalEnabled, ConfirmPrompt, type CreateConfig, DefaultValue, DefaultValueConfig, DefaultValueType, type DeleteConfig, EnabledValue, type ExecConfig, type GitInitConfig, InitConfig, InitializationMetadata, InputPrompt, NumberPrompt, PluginHooks, PromptDefinition, PromptType, type RegexReplaceConfig, type RenameConfig, type ReplaceInFileConfig, RollbackConfig, SelectPrompt, TaskDefinition, TaskPlugin, TaskType, TasksConfiguration, type TemplateConfig, type UpdateJsonConfig, VariableDefinition, callHook, clearPlugins, clearTemplateCache, collectPrompts, collectVariables, createPlugin, displayTasksDiff, evaluateCondition, executePluginTask, executeTask, getDeleteDiff, getExecDiff, getGitInitDiff, getGitRepoInfo, getPlugin, getPluginForTaskType, getPluginTaskDiff, getRegexReplaceDiff, getRenameDiff, getReplaceInFileDiff, getTaskDiff, getTemplateDiff, getUpdateJsonDiff, interpolateTemplate, isPluginTaskType, listPlugins, loadAndMergeTemplate, loadInitializationState, loadTasksWithInheritance, loadTemplate, log, main, mergeTemplates, prompt, promptYesNo, registerHooks, registerPlugin, resolveAllDefaultValues, resolveAllVariableValues, resolveDefaultValue, resolveVariableValue, runTask, runWithTasks, saveInitializationState, setNestedProperty, topologicalSort, unregisterPlugin, validatePluginTask, validatePrompts, validateVariables };