Angular Migration Tool: Update Texts (#1008)

Author: arman-boyakhchyan

CHANGELOG.md

@@ -1,6 +1,23 @@
-## v1.11.0
+## v1.12.1
+
+- `migrate` command descriptions were updated.
+- Added dependency fixes.
+
+## v1.12.0
+
+- The `migrate` command was added to DevExtreme CLI.
+- The `angular-config-components` schematic was added to DevExtreme Schematics.
+
+## v1.11.2
 
-The requirements for DevExtreme CLI were updated:
+- Minor improvements.
+
+## v1.11.1
+
+- Minor improvements.
+
+## v1.11.0
 
-- Node.js v20.19.0 or later
-- npm v9.6.0 or later
+- The requirements for DevExtreme CLI were updated:    
+    - Node.js v20.19.0 or later.
+    - npm v9.6.0 or later.

packages/devextreme-cli/index.js

@@ -41,7 +41,7 @@ const run = async(commands, options) => {
         await application.run(commands, options, devextremeConfig.read());
     } else if(application.isMigrationCommand(commands[0])) {
         if(!commands[1]) {
-            console.error('Please specify a change name for migration.');
+            console.error('Please specify a migration command.');
             printHelp('migrate');
             return;
         }

packages/devextreme-cli/src/application.js

@@ -19,7 +19,7 @@ const handleWrongAppType = (appType, command) => {
 };
 
 const handleWrongChangeName = (changeName, command) => {
-    console.error(`The '${changeName}' change name is not valid`);
+    console.error(`Invalid migration command: ${changeName}`);
     printHelp(command);
 };
 

packages/devextreme-cli/src/applications/application.angular.js

@@ -194,7 +194,7 @@ const migrateConfigComponents = async(options = {}) => {
     if(!collectionPath) {
         const prompts = require('prompts');
 
-        console.log(`\nThe '${collectionName}' package is required to run this command.`);
+        console.log(`\nRequired package is missing: '${collectionName}'`);
 
         const response = await prompts({
             type: 'confirm',
@@ -204,7 +204,7 @@ const migrateConfigComponents = async(options = {}) => {
         });
 
         if(!response.install) {
-            console.log('Migration cancelled. Install devextreme-schematics manually and rerun the command.');
+            console.log('Migration was canceled.');
             process.exit(1);
         }
     }

packages/devextreme-cli/src/commands.json

@@ -51,19 +51,19 @@
     }, {
         "name": "migrate",
         "description": "Migration commands for DevExtreme applications",
-        "usage": "devextreme migrate <change name> [options]",
+        "usage": "devextreme migrate <migration command> [options]",
         "arguments": [{
             "name": "angular-config-components",
-            "description": "Migrate to the latest DevExtreme configuration components.",
+            "description": "Migrates DevExtreme Angular applications to named configuration components.",
             "options": [{
                 "name": "--include",
-                "description": "Template file glob patterns to include (default: **/*.html). You can pass multiple patterns as a comma-separated string (e.g. \"**/a.html,**/b.html\") or as an array (e.g. [\"**/a.html\",\"**/b.html\"])."
+                "description": "Template file glob patterns to include (default: **/*.html). You can pass multiple patterns as a comma-separated string (\"**/a.html,**/b.html\") or as an array ([\"**/a.html\",\"**/b.html\"])."
             }, {
                 "name": "--script-include",
-                "description": "TypeScript/JavaScript file glob patterns to scan for inline templates (default: **/*.ts,**/*.js). You can pass multiple patterns as a comma-separated string or as an array. Pass an empty value ('' or []) to disable."
+                "description": "TypeScript/JavaScript file glob patterns to scan for inline templates (default: **/*.ts,**/*.js). You can pass multiple patterns as a comma-separated string or as an array. Pass an empty value to disable ('' or [])."
             }, {
                 "name": "--dry",
-                "description": "Run in dry mode to preview changes without applying them (default: false)."
+                "description": "Run in dry mode to preview changes."
             }]
         }]
     }, {

packages/devextreme-schematics/src/migrate-config-components/README.md

@@ -10,7 +10,7 @@ This schematic automatically migrates generic configuration components to named
 
 ### Via DevExtreme CLI (Recommended)
 
-You can run the migration command from any directory, including both inside and outside Angular workspaces:
+You can run the migration command from any directory, both inside and outside Angular workspaces:
 
 ```bash
 devextreme migrate angular-config-components

packages/devextreme-schematics/src/migrate-config-components/schema.json

@@ -1,7 +1,7 @@
 {
   "$schema": "http://json-schema.org/schema",
   "$id": "SchematicsDevextremeMigrateConfigComponents",
-  "title": "Migrate to the latest DevExtreme configuration components.",
+  "title": "Migrates DevExtreme Angular applications to named configuration components.",
   "type": "object",
   "properties": {
     "include": {
@@ -16,13 +16,14 @@
         { "type": "array", "items": { "type": "string" } },
         { "type": "string" }
       ],
-      "description": "Glob(s) of TS/JS files to scan for inline templates (default: ['**/*.ts','**/*.js']; set empty ('' or []) to disable)"
+      "description": "Glob(s) of TS/JS files to scan for inline templates (default: ['**/*.ts','**/*.js']). To disable, set to '' or []."
     },
     "dry": {
       "oneOf": [
         { "type": "boolean", "default": false },
         { "type": "string", "enum": ["true", "false"], "default": "false" }
-      ]
+      ],
+      "description": "Run in dry mode to preview changes."
     }
   }
 }

packages/devextreme-schematics/src/migrate-config-components/template-migrator.ts

@@ -81,16 +81,16 @@ export async function applyInlineComponentTemplateMigrations(
         ? `Resolution attempts:\n${tsResolutionErrors.map(e => '  - ' + e).join('\n')}\n`
         : '';
       exec.logger.warn(
-        '[config-migrator] Failed to import TypeScript. Skipping inline template migration.\n' +
+        '[config-migrator] Skipping inline template migration.\n' +
         errorDetails +
-        'The schematic attempted to import TypeScript from the following locations:\n' +
+        'Failed to import TypeScript from the following locations:\n' +
         '  1. Project node_modules\n' +
         '  2. Global node_modules\n' +
         '  3. Temporary installation (npm cache)\n\n' +
-        'To resolve this issue, install TypeScript.\n\n' +
-        'Project install:\n' +
+        'To resolve this issue, install TypeScript manually.\n\n' +
+        'Project installation:\n' +
         '  npm install typescript --save-dev\n\n' +
-        'Global install:\n' +
+        'Global installation:\n' +
         '  npm install -g typescript\n\n'
       );
       return;

packages/devextreme-schematics/src/utility/typescript-resolver.ts

@@ -27,7 +27,7 @@ export function resolveTypeScript(): TypeScriptResolutionResult {
       };
     }
   } catch (err) {
-    errors.push(`Project resolution failed: ${err?.message || err}`);
+    errors.push(`Failed to import TypeScript from project: ${err?.message || err}`);
   }
 
   try {
@@ -40,7 +40,7 @@ export function resolveTypeScript(): TypeScriptResolutionResult {
       };
     }
   } catch (err) {
-    errors.push(`Global resolution failed: ${err?.message || err}`);
+    errors.push(`Failed to import TypeScript from global node_modules: ${err?.message || err}`);
   }
 
   try {
@@ -53,7 +53,7 @@ export function resolveTypeScript(): TypeScriptResolutionResult {
       };
     }
   } catch (err) {
-    errors.push(`Temporary install failed: ${err?.message || err}`);
+    errors.push(`Failed to import TypeScript from temporary installation (npm cache): ${err?.message || err}`);
   }
 
   return {