[0.76] Introducing --list option to init-windows (#13991)

danielayala94 · TatianaKapos · web-flow · commit c147dcb404ad · 2024-10-18T20:22:09.000Z
* Introducing `--list` option to `init-windows` (#13986) * Added --list option to init-windows * Change files * Remove unnecessary indentation * Indicate the default template * Change files --------- Co-authored-by: Tatiana Kapos <tatianakapos@microsoft.com>
diff --git a/change/@react-native-windows-cli-c88dbeae-73cb-4394-b26a-9eed7864646c.json b/change/@react-native-windows-cli-c88dbeae-73cb-4394-b26a-9eed7864646c.json
@@ -0,0 +1,7 @@
+{
+  "type": "prerelease",
+  "comment": "Introducing `--list` option to `init-windows` (#13986)",
+  "packageName": "@react-native-windows/cli",
+  "email": "14967941+danielayala94@users.noreply.github.com",
+  "dependentChangeType": "patch"
+}
diff --git a/packages/@react-native-windows/cli/src/commands/initWindows/initWindows.ts b/packages/@react-native-windows/cli/src/commands/initWindows/initWindows.ts
@@ -125,11 +125,29 @@ export class InitWindows {
     return name;
   }
 
+  protected printTemplateList() {
+    if (this.templates.size === 0) {
+      console.log('\nNo templates found.\n');
+      return;
+    }
+
+    for (const [key, value] of this.templates.entries()) {
+      const defaultLabel = value.isDefault ? chalk.yellow('[Default] ') : '';
+      console.log(`\n${key} - ${value.name}\n    ${defaultLabel}${value.description}`);      
+    }
+    console.log(`\n`)
+  }
+
   public async run(spinner: Ora) {
     await this.loadTemplates();
 
     spinner.info();
 
+    if (this.options.list) {
+      this.printTemplateList();
+      return;
+    }
+
     this.options.template ??= this.getDefaultTemplateName();
 
     spinner.info(`Using template '${this.options.template}'...`);
@@ -259,6 +277,7 @@ function optionSanitizer(key: keyof InitOptions, value: any): any {
     case 'template':
     case 'overwrite':
     case 'telemetry':
+    case 'list':
       return value === undefined ? false : value; // Return value
   }
 }
diff --git a/packages/@react-native-windows/cli/src/commands/initWindows/initWindowsOptions.ts b/packages/@react-native-windows/cli/src/commands/initWindows/initWindowsOptions.ts
@@ -13,6 +13,7 @@ export interface InitOptions {
   namespace?: string;
   overwrite?: boolean;
   telemetry?: boolean;
+  list?: boolean;
 }
 
 export const initOptions: CommandOption[] = [
@@ -46,4 +47,9 @@ export const initOptions: CommandOption[] = [
     description:
       'Disables sending telemetry that allows analysis of usage and failures of the react-native-windows CLI',
   },
+  {
+    name: '--list',
+    description:
+      'Shows a list with all available templates with their descriptions.',
+  },
 ];
diff --git a/packages/@react-native-windows/cli/src/e2etest/initWindows.test.ts b/packages/@react-native-windows/cli/src/e2etest/initWindows.test.ts
@@ -25,6 +25,7 @@ function validateOptionName(
     case 'namespace':
     case 'overwrite':
     case 'telemetry':
+    case 'list':
       return true;
   }
   throw new Error(

Original file line number	Diff line number	Diff line change
`@@ -25,6 +25,7 @@ function validateOptionName(`
`25`	`25`	`case 'namespace':`
`26`	`26`	`case 'overwrite':`
`27`	`27`	`case 'telemetry':`
	`28`	`+ case 'list':`
`28`	`29`	`return true;`
`29`	`30`	`}`
`30`	`31`	`throw new Error(`