gbu-accessibility-package 3.11.0 → 3.12.1

package/cli.js

@@ -32,12 +32,11 @@ const options = {
   dlOnly: false,
   brokenLinksOnly: false,
   unusedFilesOnly: false,
+  unusedFilesListOnly: false,
+  deleteUnusedFilesFromList: false,
   deadCodeOnly: false,
   fileSizeOnly: false,
-  metaCheckOnly: false,
-  metaFixOnly: false,
-  fullReport: false,
-  reportOutput: null,
+  listFile: 'unused-files-list.txt',
   // Enhanced alt options
   enhancedAlt: false,
   altCreativity: 'balanced', // conservative, balanced, creative
@@ -133,31 +132,42 @@ for (let i = 0; i < args.length; i++) {
     case '--google-tag-manager':
       options.gtmCheckOnly = true;
       break;
-    case '--unused-files':
-      options.unusedFilesOnly = true;
-      break;
-    case '--dead-code':
-      options.deadCodeOnly = true;
-      break;
-    case '--file-size':
-    case '--size-check':
-      options.fileSizeOnly = true;
-      break;
+    case '--check-meta':
     case '--meta-check':
-      options.metaCheckOnly = true;
+      options.checkMetaOnly = true;
       break;
+    case '--fix-meta':
     case '--meta-fix':
-      options.metaFixOnly = true;
+      options.fixMetaOnly = true;
       break;
     case '--full-report':
-    case '--export-report':
     case '--report':
+    case '--excel-report':
       options.fullReport = true;
       break;
-    case '--report-output':
     case '-o':
+    case '--output':
       options.reportOutput = args[++i];
       break;
+    case '--unused-files':
+      options.unusedFilesOnly = true;
+      break;
+    case '--unused-files-list':
+      options.unusedFilesListOnly = true;
+      break;
+    case '--delete-unused-files':
+      options.deleteUnusedFilesFromList = true;
+      break;
+    case '--list-file':
+      options.listFile = args[++i];
+      break;
+    case '--dead-code':
+      options.deadCodeOnly = true;
+      break;
+    case '--file-size':
+    case '--size-check':
+      options.fileSizeOnly = true;
+      break;
     case '--auto-fix-headings':
       options.autoFixHeadings = true;
       break;
@@ -217,13 +227,16 @@ Options:
   --broken-links           Check for broken external links only (no auto-fix)
   --404-resources          Check for missing local resources only (no auto-fix)
   --gtm-check              Check Google Tag Manager installation (no auto-fix)
+  --check-meta             Check meta tags and Open Graph Protocol (no auto-fix)
+  --fix-meta               Auto-fix missing meta tags and OGP tags
+  --full-report            Generate comprehensive Excel report (all checks)
+  -o, --output <file>      Output path for Excel report (use with --full-report)
   --unused-files           Check for unused files in project (no auto-fix)
+  --unused-files-list      Create unused-files-list.txt from detected unused files
+  --delete-unused-files    Delete all files listed in unused-files-list.txt
+  --list-file <file>       Custom list file name/path inside target directory
   --dead-code              Check for dead code in CSS and JavaScript (no auto-fix)
   --file-size, --size-check Check file sizes and suggest optimizations (no auto-fix)
-  --meta-check             Check Meta Tags and Open Graph Protocol (no auto-fix)
-  --meta-fix               Auto-fix Meta Tags syntax and typos
-  --full-report            Generate comprehensive Excel report (all checks)
-  --report-output, -o      Output path for report file (default: accessibility-report-YYYY-MM-DD.xlsx)
   --enhanced-alt           Use enhanced alt attribute analysis and generation
   --alt-creativity <mode>  Alt text creativity: conservative, balanced, creative (default: balanced)
   --include-emotions       Include emotional descriptors in alt text
@@ -258,13 +271,17 @@ Examples:
   node cli.js --broken-links           # Check for broken external links only
   node cli.js --404-resources          # Check for missing local resources only
   node cli.js --gtm-check              # Check Google Tag Manager installation
+  node cli.js --check-meta             # Check meta tags and Open Graph Protocol
+  node cli.js --fix-meta               # Auto-fix missing meta tags and OGP
+  node cli.js --fix-meta --dry-run     # Preview meta tag fixes
+  node cli.js --full-report            # Generate comprehensive Excel report
+  node cli.js --full-report ./project -o report.xlsx  # Custom output path
   node cli.js --unused-files           # Check for unused files in project
+  node cli.js --unused-files-list      # Create ./unused-files-list.txt
+  node cli.js --delete-unused-files    # Delete files listed in ./unused-files-list.txt
+  node cli.js --delete-unused-files --dry-run  # Preview files that would be deleted
   node cli.js --dead-code              # Check for dead CSS and JavaScript code
   node cli.js --file-size              # Check file sizes and suggest optimizations
-  node cli.js --meta-check             # Check Meta Tags and Open Graph Protocol
-  node cli.js --meta-fix               # Auto-fix Meta Tags syntax and typos
-  node cli.js --full-report            # Generate comprehensive Excel report
-  node cli.js --full-report ./project -o report.xlsx  # Custom output path
   node cli.js --cleanup-only           # Only cleanup duplicate roles
   node cli.js ./src                    # Fix src directory (comprehensive)
   node cli.js -l en --dry-run ./dist   # Preview comprehensive fixes in English
@@ -323,17 +340,17 @@ async function main() {
   });
 
   try {
-    // Handle Full Report mode first (independent, doesn't need other options)
+    // Handle Full Report mode first
     if (options.fullReport) {
       console.log(chalk.blue('📊 Đang tạo báo cáo toàn diện...'));
       await fixer.generateFullReport(options.directory, options.reportOutput);
-      process.exit(0);
+      return;
     }
     
     // Handle different modes - All modes now include cleanup
     if (options.cleanupOnly || options.altOnly || options.langOnly || options.roleOnly || options.ariaLabelOnly ||
         options.formsOnly || options.nestedOnly || options.buttonsOnly || options.linksOnly || options.landmarksOnly || 
-        options.headingsOnly || options.dlOnly || options.linksCheckOnly || options.brokenLinksOnly || options.missingResourcesOnly || options.gtmCheckOnly || options.unusedFilesOnly || options.deadCodeOnly || options.fileSizeOnly || options.metaCheckOnly || options.metaFixOnly) {
+        options.headingsOnly || options.dlOnly || options.linksCheckOnly || options.brokenLinksOnly || options.missingResourcesOnly || options.gtmCheckOnly || options.checkMetaOnly || options.fixMetaOnly || options.unusedFilesOnly || options.unusedFilesListOnly || options.deleteUnusedFilesFromList || options.deadCodeOnly || options.fileSizeOnly) {
       // Individual modes - handle each separately, then run cleanup
     } else {
       // Default mode: Run comprehensive fix (all fixes including cleanup)
@@ -625,6 +642,22 @@ async function main() {
       showCompletionMessage(options, 'Kiểm tra GTM');
       return;
       
+    } else if (options.checkMetaOnly) {
+      // Check meta tags only (no fixes)
+      console.log(chalk.blue('🏷️ Đang kiểm tra meta tags và Open Graph Protocol...'));
+      await fixer.checkMetaTags(options.directory);
+      
+      showCompletionMessage(options, 'Kiểm tra meta tags');
+      return;
+      
+    } else if (options.fixMetaOnly) {
+      // Fix meta tags
+      console.log(chalk.blue('🔧 Đang tự động sửa meta tags...')); 
+      await fixer.fixMetaTags(options.directory, { dryRun: options.dryRun, backup: options.backupFiles });
+      
+      showCompletionMessage(options, 'Sửa meta tags');
+      return;
+      
     } else if (options.unusedFilesOnly) {
       // Check unused files only (no fixes, no cleanup)
       console.log(chalk.blue('🗂️ Đang kiểm tra file không sử dụng...'));
@@ -641,6 +674,39 @@ async function main() {
       
       showCompletionMessage(options, 'Kiểm tra file không sử dụng');
       return;
+
+    } else if (options.unusedFilesListOnly) {
+      console.log(chalk.blue('📝 Đang tạo danh sách file không sử dụng...'));
+      const listResults = await fixer.generateUnusedFilesList(options.directory, options.listFile);
+
+      console.log(chalk.green(`\n✅ Đã tạo file list: ${listResults.outputPath}`));
+      console.log(chalk.gray(`📊 ${listResults.unusedCount} path đã được ghi vào list`));
+      console.log(chalk.gray('💡 Danh sách dùng path tương đối so với thư mục target và có thể dùng lại với --delete-unused-files'));
+      return;
+
+    } else if (options.deleteUnusedFilesFromList) {
+      console.log(chalk.blue('🗑️ Đang xóa file theo danh sách unused files...'));
+      const deleteResults = await fixer.deleteUnusedFilesFromList(options.directory, options.listFile, {
+        dryRun: options.dryRun
+      });
+
+      console.log(chalk.green(`\n✅ ${options.dryRun ? 'Đã mô phỏng xóa' : 'Đã xử lý xóa'} ${deleteResults.deletedCount} file từ list`));
+      console.log(chalk.gray(`📄 File list: ${deleteResults.listPath}`));
+
+      if (deleteResults.missingCount > 0) {
+        console.log(chalk.yellow(`⚠️ ${deleteResults.missingCount} file trong list không còn tồn tại`));
+      }
+
+      if (deleteResults.skippedCount > 0) {
+        console.log(chalk.yellow(`⚠️ ${deleteResults.skippedCount} entry bị bỏ qua vì không an toàn hoặc không hợp lệ`));
+      }
+
+      if (options.dryRun) {
+        console.log(chalk.cyan('\n💡 Đây là chế độ xem trước. Chạy lại không kèm --dry-run để xóa thật.'));
+      } else {
+        console.log(chalk.gray('💡 File list được giữ nguyên để bạn có thể đối chiếu sau khi xóa'));
+      }
+      return;
       
     } else if (options.deadCodeOnly) {
       // Check dead code only (no fixes, no cleanup)
@@ -665,42 +731,6 @@ async function main() {
       
       showCompletionMessage(options, 'Phân tích kích thước file');
       return;
-      
-    } else if (options.metaCheckOnly) {
-      // Check Meta Tags and Open Graph Protocol only (no fixes, no cleanup)
-      console.log(chalk.blue('🏷️  Đang kiểm tra Meta Tags và Open Graph Protocol...'));
-      const metaResults = await fixer.checkMetaTags(options.directory);
-      const filesWithOG = metaResults.filter(r => r.metaAnalysis?.hasOpenGraph).length;
-      const filesWithIssues = metaResults.filter(r => r.metaAnalysis?.issues?.length > 0).length;
-      const totalIssues = metaResults.reduce((sum, r) => sum + (r.metaAnalysis?.issues?.length || 0), 0);
-      
-      console.log(chalk.green(`\n✅ Phân tích hoàn tất: ${metaResults.length} file`));
-      console.log(chalk.green(`  ✅ File có Open Graph: ${filesWithOG}`));
-      if (filesWithIssues > 0) {
-        console.log(chalk.yellow(`  ⚠️ ${filesWithIssues} file có vấn đề (${totalIssues} vấn đề)`));
-      }
-      console.log(chalk.gray('💡 Open Graph Protocol cần có 4 thẻ bắt buộc: og:title, og:type, og:image, og:url'));
-      
-      showCompletionMessage(options, 'Kiểm tra Meta Tags');
-      return;
-      
-    } else if (options.metaFixOnly) {
-      // Auto-fix Meta Tags syntax and typos
-      console.log(chalk.blue('🔧 Đang sửa Meta Tags và Open Graph Protocol...'));
-      const fixResults = await fixer.fixMetaTags(options.directory);
-      const filesFixed = fixResults.filter(r => r.status === 'fixed').length;
-      const totalFixes = fixResults.reduce((sum, r) => sum + (r.fixes || 0), 0);
-      
-      console.log(chalk.green(`\n✅ Xử lý hoàn tất: ${fixResults.length} file`));
-      if (filesFixed > 0) {
-        console.log(chalk.green(`  ✅ Đã sửa: ${filesFixed} file (${totalFixes} vấn đề)`));
-      } else {
-        console.log(chalk.green(`  ✅ Không có lỗi cú pháp hoặc chính tả cần sửa`));
-      }
-      console.log(chalk.gray('💡 Chức năng này sửa lỗi chính tả OG property và cú pháp sai (name= thay vì property=)'));
-      
-      showCompletionMessage(options, 'Sửa Meta Tags');
-      return;
     }
 
   } catch (error) {
@@ -710,4 +740,4 @@ async function main() {
 }
 
 // Run the CLI
-main();
+main();