chore: rename builder to workflow

Author: orochaa

.changeset/red-walls-greet.md

@@ -2,4 +2,4 @@
 '@clack/prompts': minor
 ---
 
-add prompt `builder`
+add prompt `workflow` builder

examples/package.json

@@ -13,7 +13,7 @@
     "spinner": "jiti ./spinner.ts",
     "spinner-ci": "npx cross-env CI=\"true\" jiti ./spinner-ci.ts",
     "changesets": "jiti ./changesets.ts",
-    "builder": "jiti ./builder.ts"
+    "workflow": "jiti ./workflow.ts"
   },
   "devDependencies": {
     "jiti": "^1.17.0"

examples/builder.ts renamed to examples/workflow.ts

@@ -2,8 +2,8 @@ import * as p from '@clack/prompts';
 
 (async () => {
 	const results = await p
-		.builder()
-		.add('path', () =>
+		.workflow()
+		.step('path', () =>
 			p.text({
 				message: 'Where should we create your project?',
 				placeholder: './sparkling-solid',
@@ -13,7 +13,7 @@ import * as p from '@clack/prompts';
 				},
 			})
 		)
-		.add('password', () =>
+		.step('password', () =>
 			p.password({
 				message: 'Provide a password',
 				validate: (value) => {
@@ -22,7 +22,7 @@ import * as p from '@clack/prompts';
 				},
 			})
 		)
-		.add('type', ({ results }) =>
+		.step('type', ({ results }) =>
 			p.select({
 				message: `Pick a project type within "${results.path}"`,
 				initialValue: 'ts',
@@ -37,7 +37,7 @@ import * as p from '@clack/prompts';
 				],
 			})
 		)
-		.add('tools', () =>
+		.step('tools', () =>
 			p.multiselect({
 				message: 'Select additional tools.',
 				initialValues: ['prettier', 'eslint'],
@@ -49,7 +49,7 @@ import * as p from '@clack/prompts';
 				],
 			})
 		)
-		.add('install', ({ results }) =>
+		.step('install', ({ results }) =>
 			p.confirm({
 				message: 'Install dependencies?',
 				initialValue: false,
@@ -58,11 +58,11 @@ import * as p from '@clack/prompts';
 		.run();
 
 	await p
-		.builder()
-		.add('cancel', () => p.text({ message: 'Try cancel prompt (Ctrl + C):' }))
-		.add('afterCancel', () => p.text({ message: 'This will not appear!' }))
+		.workflow()
+		.step('cancel', () => p.text({ message: 'Try cancel prompt (Ctrl + C):' }))
+		.step('afterCancel', () => p.text({ message: 'This will not appear!' }))
 		.onCancel(({ results }) => {
-			p.cancel('Builder canceled');
+			p.cancel('Workflow canceled');
 			process.exit(0);
 		})
 		.run();

packages/prompts/README.md

@@ -125,7 +125,7 @@ s.stop('Installed via npm');
 
 ## Utilities
 
-### Grouping
+### Group
 
 Grouping prompts together is a great way to keep your code organized. This accepts a JSON object with a name that can be used to reference the group later. The second argument is an optional but has a `onCancel` callback that will be called if the user cancels one of the prompts in the group.
 
@@ -190,18 +190,18 @@ log.message('Hello, World', { symbol: color.cyan('~') });
 
 [clack-log-prompts](https://github.com/natemoo-re/clack/blob/main/.github/assets/clack-logs.png)
 
-### Building
+### Workflow
 
-Just like `group`, but on `builder` way, so you can choose which one fits better.
+Just like `group`, but on builder way, so you can choose which one fits better.
 
 ```js
 import * as p from '@clack/prompts';
 
 const results = await p
-  .builder()
-  .add('name', () => p.text({ message: 'What is your name?' }))
-  .add('age', () => p.text({ message: 'What is your age?' }))
-  .add('color', ({ results }) =>
+  .workflow()
+  .step('name', () => p.text({ message: 'What is your name?' }))
+  .step('age', () => p.text({ message: 'What is your age?' }))
+  .step('color', ({ results }) =>
     p.multiselect({
       message: `What is your favorite color ${results.name}?`,
       options: [
@@ -212,7 +212,7 @@ const results = await p
     })
   )
   .onCancel(() => {
-    p.cancel('Builder canceled');
+    p.cancel('Workflow canceled');
     process.exit(0);
   })
   .run();

packages/prompts/src/index.ts

@@ -860,32 +860,32 @@ export const tasks = async (tasks: Task[]) => {
 	}
 };
 
-type NextPromptBuilder<
+type NextWorkflowBuilder<
 	TResults extends Record<string, unknown>,
 	TKey extends string,
 	TResult,
-> = PromptBuilder<
+> = WorkflowBuilder<
 	{
 		[Key in keyof TResults]: Key extends TKey ? TResult : TResults[Key];
 	} & {
 		[Key in TKey]: TResult;
 	}
 >;
 
-class PromptBuilder<TResults extends Record<string, unknown> = {}> {
+class WorkflowBuilder<TResults extends Record<string, unknown> = {}> {
 	private results: TResults = {} as TResults;
 	private prompts: Record<string, PromptWithOptions<TResults, unknown>> = {};
 	private cancelCallback: PromptWithOptions<Partial<TResults>, void> | undefined;
 
-	public add<TKey extends string, TResult>(
+	public step<TKey extends string, TResult>(
 		key: TKey extends keyof TResults ? never : TKey,
 		prompt: PromptWithOptions<TResults, TResult>
-	): NextPromptBuilder<TResults, TKey, TResult> {
+	): NextWorkflowBuilder<TResults, TKey, TResult> {
 		this.prompts[key] = prompt;
-		return this as NextPromptBuilder<TResults, TKey, TResult>;
+		return this as NextWorkflowBuilder<TResults, TKey, TResult>;
 	}
 
-	public onCancel(cb: PromptWithOptions<Partial<TResults>, void>): PromptBuilder<TResults> {
+	public onCancel(cb: PromptWithOptions<Partial<TResults>, void>): WorkflowBuilder<TResults> {
 		this.cancelCallback = cb;
 		return this;
 	}
@@ -904,6 +904,6 @@ class PromptBuilder<TResults extends Record<string, unknown> = {}> {
 	}
 }
 
-export const builder = () => {
-	return new PromptBuilder();
+export const workflow = () => {
+	return new WorkflowBuilder();
 };