gbu-accessibility-package 3.1.0 → 3.1.3

package/CHANGELOG.md

@@ -5,6 +5,21 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [3.1.0] - 2024-07-25
+
+### Changed
+- **BREAKING**: Default behavior now **no backup files** for faster processing
+- **Backup is now optional**: Use `--backup` flag when you need backup files
+- **Performance improvement**: Faster processing by default without backup creation
+- **CLI help updated**: Reflects new default behavior
+- **Documentation updated**: README and README-vi updated with new backup behavior
+
+### Migration Guide
+- **No action needed for most users** - you get faster processing by default
+- **If you want backup files**: Add `--backup` flag to your commands
+- **Old behavior**: `gbu-a11y` (created backups) → **New behavior**: `gbu-a11y --backup`
+- **Scripts using --no-backup**: Can remove the flag (now default behavior)
+
 ## [3.0.0] - 2024-07-25
 
 ### Added

package/README-vi.md

@@ -19,7 +19,7 @@
 - 📑 **Phân tích Headings** - Phân tích cấu trúc heading với đề xuất
 - 🧹 **Dọn dẹp trùng lặp** - Xóa role attributes trùng lặp
 - 📁 **Xử lý hàng loạt** - Xử lý toàn bộ thư mục đệ quy
-- 💾 **Backup tự động** - Sửa đổi an toàn với file backup
+- 💾 **Backup tùy chọn** - Tạo file backup khi cần với flag --backup
 - 🔍 **Chế độ xem trước** - Xem trước thay đổi trước khi áp dụng
 - 📊 **Báo cáo chi tiết** - Tóm tắt sửa chữa toàn diện
 
@@ -61,8 +61,8 @@ gbu-a11y [options] [directory/file]
 Tùy chọn:
   -d, --directory <path>    Thư mục đích (mặc định: thư mục hiện tại)
   -l, --language <lang>     Ngôn ngữ cho thuộc tính lang (mặc định: ja)
-  --backup                 Tạo file backup (mặc định: bật)
-  --no-backup              Không tạo file backup
+  --backup                 Tạo file backup
+  --no-backup              Không tạo file backup (mặc định)
   --dry-run                Xem trước thay đổi mà không áp dụng
   --comprehensive, --all   Chạy sửa toàn diện (giống mặc định)
   --cleanup-only           Chỉ dọn dẹp role attributes trùng lặp
@@ -103,28 +103,28 @@ gbu-a11y --alt-only --dry-run ./src    # Xem trước sửa alt
 gbu-a11y --forms-only -l en ./public   # Sửa form với tiếng Anh
 
 # Tùy chọn backup
-gbu-a11y --backup ./dist             # Bật backup rõ ràng (mặc định)
-gbu-a11y --no-backup ./dist          # Tắt backup để xử lý nhanh hơn
+gbu-a11y --backup ./dist             # Bật backup để an toàn
+gbu-a11y --no-backup ./dist          # Tắt backup (mặc định - xử lý nhanh hơn)
 ```
 
 ## 🔧 Sử dụng lập trình
 
 ```javascript
-const AccessibilityFixer = require('gbu-accessibility-package');
+const AccessibilityFixer = require("gbu-accessibility-package");
 
 const fixer = new AccessibilityFixer({
-  language: 'vi',
+  language: "vi",
   backupFiles: true,
-  dryRun: false
+  dryRun: false,
 });
 
 // Sửa tất cả vấn đề accessibility
 async function fixAccessibility() {
   try {
-    const results = await fixer.fixAllAccessibilityIssues('./src');
-    console.log('File đã sửa:', results);
+    const results = await fixer.fixAllAccessibilityIssues("./src");
+    console.log("File đã sửa:", results);
   } catch (error) {
-    console.error('Lỗi:', error);
+    console.error("Lỗi:", error);
   }
 }
 
@@ -134,6 +134,7 @@ fixAccessibility();
 ## 🎯 Chế độ sửa
 
 ### Chế độ toàn diện (Mặc định)
+
 Chạy tất cả các bước sửa bao gồm dọn dẹp:
 
 1. **HTML lang attributes** - Thêm thuộc tính ngôn ngữ
@@ -147,6 +148,7 @@ Chạy tất cả các bước sửa bao gồm dọn dẹp:
 9. **Cleanup** - Dọn dẹp role attributes trùng lặp
 
 ### Chế độ riêng lẻ
+
 Mỗi chế độ riêng lẻ đều bao gồm bước dọn dẹp:
 
 - `--alt-only` - Chỉ sửa alt attributes + dọn dẹp
@@ -159,35 +161,40 @@ Mỗi chế độ riêng lẻ đều bao gồm bước dọn dẹp:
 ## 🔧 Những gì được sửa
 
 ### 1. Alt Attributes
+
 - **Alt attributes thiếu** → Thêm alt text theo ngữ cảnh
 - **Alt attributes rỗng** → Tạo mô tả có ý nghĩa
 - **Tạo theo ngữ cảnh** → Sử dụng text xung quanh, tiêu đề, chú thích
 
 ```html
 <!-- Trước -->
-<img src="logo.png">
-<img src="chart.jpg" alt="">
+<img src="logo.png" />
+<img src="chart.jpg" alt="" />
 
 <!-- Sau -->
-<img src="logo.png" alt="ロゴ" role="img" aria-label="ロゴ">
-<img src="chart.jpg" alt="グラフ" role="img" aria-label="グラフ">
+<img src="logo.png" alt="ロゴ" role="img" aria-label="ロゴ" />
+<img src="chart.jpg" alt="グラフ" role="img" aria-label="グラフ" />
 ```
 
 ### 2. HTML Lang Attributes
+
 - **Lang attributes thiếu** → Thêm ngôn ngữ được chỉ định
 - **Lang attributes rỗng** → Đặt mã ngôn ngữ phù hợp
 
 ```html
 <!-- Trước -->
 <html>
-<html lang="">
-
-<!-- Sau -->
-<html lang="ja">
-<html lang="ja">
+  <html lang="">
+    <!-- Sau -->
+    <html lang="ja">
+      <html lang="ja"></html>
+    </html>
+  </html>
+</html>
 ```
 
 ### 3. Role Attributes & Aria Labels
+
 - **Images** → `role="img"` + `aria-label` (khớp với alt text)
 - **Picture elements** → Di chuyển `role="img"` từ `<picture>` vào `<img>` bên trong
 - **Links** → `role="link"`
@@ -197,55 +204,58 @@ Mỗi chế độ riêng lẻ đều bao gồm bước dọn dẹp:
 
 ```html
 <!-- Trước -->
-<img src="icon.png" alt="Icon">
+<img src="icon.png" alt="Icon" />
 <picture role="img">
-  <img src="photo.jpg" alt="Photo">
+  <img src="photo.jpg" alt="Photo" />
 </picture>
 <a href="/home">Home</a>
 <div class="btn-click">Click me</div>
 
 <!-- Sau -->
-<img src="icon.png" alt="Icon" role="img" aria-label="Icon">
+<img src="icon.png" alt="Icon" role="img" aria-label="Icon" />
 <picture>
-  <img src="photo.jpg" alt="Photo" role="img" aria-label="Photo">
+  <img src="photo.jpg" alt="Photo" role="img" aria-label="Photo" />
 </picture>
 <a href="/home" role="link">Home</a>
 <div class="btn-click" role="button">Click me</div>
 ```
 
 ### 4. Form Labels
+
 - **Input thiếu label** → Thêm `aria-label` phù hợp
 - **Hỗ trợ nhiều loại input** → text, email, password, tel, etc.
 
 ```html
 <!-- Trước -->
-<input type="text" placeholder="Name">
-<input type="email">
-<input type="password">
+<input type="text" placeholder="Name" />
+<input type="email" />
+<input type="password" />
 
 <!-- Sau -->
-<input type="text" placeholder="Name" aria-label="テキスト入力">
-<input type="email" aria-label="メールアドレス">
-<input type="password" aria-label="パスワード">
+<input type="text" placeholder="Name" aria-label="テキスト入力" />
+<input type="email" aria-label="メールアドレス" />
+<input type="password" aria-label="パスワード" />
 ```
 
 ### 5. Button Names
+
 - **Button rỗng** → Thêm text và aria-label
 - **Input button thiếu value** → Thêm value phù hợp
 
 ```html
 <!-- Trước -->
 <button></button>
-<input type="submit">
-<input type="button">
+<input type="submit" />
+<input type="button" />
 
 <!-- Sau -->
 <button aria-label="ボタン">ボタン</button>
-<input type="submit" value="送信">
-<input type="button" value="ボタン">
+<input type="submit" value="送信" />
+<input type="button" value="ボタン" />
 ```
 
 ### 6. Link Names
+
 - **Link rỗng** → Thêm aria-label
 - **Generic text** → Phát hiện "Click here", "Read more"
 - **Image links** → Xử lý link chỉ chứa hình ảnh
@@ -254,15 +264,17 @@ Mỗi chế độ riêng lẻ đều bao gồm bước dọn dẹp:
 <!-- Trước -->
 <a href="/home"></a>
 <a href="/more">Click here</a>
-<a href="/image"><img src="icon.png"></a>
+<a href="/image"><img src="icon.png" /></a>
 
 <!-- Sau -->
 <a href="/home" aria-label="リンク">リンク</a>
-<a href="/more">Click here</a> <!-- Được phát hiện nhưng không tự động sửa -->
-<a href="/image" aria-label="画像リンク"><img src="icon.png"></a>
+<a href="/more">Click here</a>
+<!-- Được phát hiện nhưng không tự động sửa -->
+<a href="/image" aria-label="画像リンク"><img src="icon.png" /></a>
 ```
 
 ### 7. Landmarks
+
 - **Main landmark thiếu** → Thêm `role="main"`
 - **Navigation landmark thiếu** → Thêm `role="navigation"`
 
@@ -285,26 +297,29 @@ Mỗi chế độ riêng lẻ đều bao gồm bước dọn dẹp:
 ```
 
 ### 8. Heading Analysis
+
 - **Multiple h1** → Phát hiện và đề xuất
 - **Heading level skip** → Phát hiện nhảy cấp (h1 → h3)
 - **Empty headings** → Phát hiện heading rỗng
 - **Chỉ phân tích, không tự động sửa** → An toàn cho cấu trúc nội dung
 
 ### 9. Aria Label Enhancement
+
 - **Tự động aria-label** → Thêm `aria-label` khớp với `alt` text cho images
 - **Bảo tồn hiện có** → Không ghi đè `aria-label` đã có
 - **Phát hiện thông minh** → Chỉ thêm khi `alt` text tồn tại và không rỗng
 
 ### 10. Dọn dẹp trùng lặp
+
 - **Xóa role attributes trùng lặp** → Giữ lại occurrence đầu tiên
 - **Xử lý mixed quotes** → role="button" role='button'
 
 ```html
 <!-- Trước -->
-<img src="test.jpg" role="img" role="img" alt="Test">
+<img src="test.jpg" role="img" role="img" alt="Test" />
 
 <!-- Sau -->
-<img src="test.jpg" role="img" alt="Test">
+<img src="test.jpg" role="img" alt="Test" />
 ```
 
 ## 🌟 Tạo Alt Text thông minh
@@ -312,8 +327,9 @@ Mỗi chế độ riêng lẻ đều bao gồm bước dọn dẹp:
 Package sử dụng phân tích ngữ cảnh thông minh để tạo alt text có ý nghĩa:
 
 ### Nguồn ngữ cảnh
+
 1. **Title attributes**
-2. **Aria-label attributes**  
+2. **Aria-label attributes**
 3. **Definition terms (dt elements)**
 4. **Parent link text**
 5. **Nearby headings**
@@ -321,6 +337,7 @@ Package sử dụng phân tích ngữ cảnh thông minh để tạo alt text c
 7. **Surrounding text content**
 
 ### Mẫu dự phòng
+
 - `logo.png` → "ロゴ" (Logo)
 - `icon.svg` → "アイコン" (Icon)
 - `banner.jpg` → "バナー" (Banner)
@@ -330,6 +347,7 @@ Package sử dụng phân tích ngữ cảnh thông minh để tạo alt text c
 ## 📊 Ví dụ đầu ra
 
 ### Chế độ toàn diện
+
 ```
 🚀 Starting Accessibility Fixer...
 🎯 Running comprehensive accessibility fixes...
@@ -340,7 +358,7 @@ Package sử dụng phân tích ngữ cảnh thông minh để tạo alt text c
 🖼️ Step 2: Alt attributes...
 ✅ Fixed alt attributes in 12 files (34 issues)
 
-🎭 Step 3: Role attributes...  
+🎭 Step 3: Role attributes...
 ✅ Fixed role attributes in 8 files (67 issues)
 
 📋 Step 4: Form labels...
@@ -369,6 +387,7 @@ Package sử dụng phân tích ngữ cảnh thông minh để tạo alt text c
 ```
 
 ### Chế độ riêng lẻ
+
 ```
 🚀 Starting Accessibility Fixer...
 📋 Running form label fixes + cleanup...
@@ -392,30 +411,119 @@ Package sử dụng phân tích ngữ cảnh thông minh để tạo alt text c
 ## 🔒 Tính năng an toàn
 
 ### Tùy chọn Backup
-- **Hành vi mặc định**: Tự động tạo file `.backup` để an toàn
-- **Tắt backup**: Sử dụng `--no-backup` để xử lý nhanh hơn
-- **Bật rõ ràng**: Sử dụng `--backup` để rõ ràng về việc tạo backup
+
+- **Hành vi mặc định**: Không tạo backup files để xử lý nhanh hơn
+- **Bật backup**: Sử dụng `--backup` để an toàn khi cần
+- **Tắt rõ ràng**: Sử dụng `--no-backup` để rõ ràng (giống mặc định)
 
 ```bash
-# Chế độ an toàn (mặc định) - tạo backup
+# Chế độ nhanh (mặc định) - không backup
 gbu-a11y --comprehensive
 
-# Chế độ nhanh - không backup
-gbu-a11y --no-backup --comprehensive
-
-# Chế độ backup rõ ràng
+# Chế độ an toàn - tạo backup
 gbu-a11y --backup --comprehensive
+
+# Chế độ không backup rõ ràng (giống mặc định)
+gbu-a11y --no-backup --comprehensive
 ```
 
 ### Các tính năng an toàn khác
+
 - **Chế độ xem trước** để xem trước an toàn với `--dry-run`
 - **Không phá hoại** - chỉ thêm attributes thiếu
 - **Ngăn chặn trùng lặp** - không thêm attributes đã có
 - **Xử lý lỗi** - tiếp tục xử lý khi có lỗi file riêng lẻ
 
+## 🔧 Quản lý Package
+
+### Gỡ cài đặt và Cài đặt lại
+
+Nếu bạn gặp vấn đề hoặc muốn cập nhật lên phiên bản mới nhất:
+
+```bash
+# Gỡ cài đặt package global
+npm uninstall -g gbu-accessibility-package
+
+# Xóa npm cache
+npm cache clean --force
+
+# Cài đặt lại phiên bản mới nhất
+npm install -g gbu-accessibility-package@latest
+
+# Kiểm tra cài đặt
+gbu-a11y --version
+gbu-a11y --help
+```
+
+### Quản lý dự án cục bộ
+
+```bash
+# Xóa khỏi dự án cục bộ
+npm uninstall gbu-accessibility-package
+
+# Xóa package-lock và node_modules
+rm -rf node_modules package-lock.json
+
+# Cài đặt lại dependencies
+npm install
+
+# Thêm phiên bản mới nhất
+npm install gbu-accessibility-package@latest
+```
+
+### Xóa file Backup
+
+```bash
+# Xóa tất cả file backup trong thư mục hiện tại
+find . -name "*.backup" -type f -delete
+
+# Xóa file backup trong thư mục cụ thể
+find ./src -name "*.backup" -type f -delete
+
+# Sử dụng npm script (nếu đã cấu hình)
+npm run cleanup-backups
+```
+
+### Khắc phục sự cố cài đặt
+
+```bash
+# Kiểm tra cấu hình npm
+npm config list
+
+# Reset npm registry (nếu cần)
+npm config set registry https://registry.npmjs.org/
+
+# Kiểm tra global packages
+npm list -g --depth=0
+
+# Sửa quyền (macOS/Linux)
+sudo chown -R $(whoami) ~/.npm
+sudo chown -R $(whoami) /usr/local/lib/node_modules
+
+# Thay thế: Sử dụng npx mà không cài global
+npx gbu-accessibility-package --help
+```
+
+### Quản lý phiên bản
+
+```bash
+# Kiểm tra phiên bản hiện tại
+gbu-a11y --version
+
+# Kiểm tra các phiên bản có sẵn
+npm view gbu-accessibility-package versions --json
+
+# Cài đặt phiên bản cụ thể
+npm install -g gbu-accessibility-package@2.0.0
+
+# Cập nhật lên mới nhất
+npm update -g gbu-accessibility-package
+```
+
 ## 🛠️ Cấu hình
 
 ### Package.json Scripts
+
 ```json
 {
   "scripts": {
@@ -434,12 +542,13 @@ gbu-a11y --backup --comprehensive
 ```
 
 ### Tích hợp CI/CD
+
 ```yaml
 # Ví dụ GitHub Actions
 - name: Check Accessibility
   run: npx gbu-accessibility-package --dry-run
 
-- name: Fix Accessibility Issues  
+- name: Fix Accessibility Issues
   run: npx gbu-accessibility-package --comprehensive
 ```
 
@@ -455,6 +564,115 @@ gbu-a11y --backup --comprehensive
 
 Dự án này được cấp phép theo Giấy phép MIT - xem file [LICENSE](LICENSE) để biết chi tiết.
 
+## 🔧 Khắc phục sự cố
+
+### Các vấn đề thường gặp và giải pháp
+
+#### Package không tìm thấy hoặc lệnh không hoạt động
+
+```bash
+# Kiểm tra package đã cài global chưa
+npm list -g gbu-accessibility-package
+
+# Nếu không tìm thấy, cài đặt global
+npm install -g gbu-accessibility-package
+
+# Kiểm tra PATH có chứa npm global bin không
+echo $PATH | grep npm
+
+# Thêm npm global bin vào PATH (nếu cần)
+export PATH=$PATH:$(npm config get prefix)/bin
+```
+
+#### Lỗi quyền truy cập
+
+```bash
+# macOS/Linux: Sửa quyền npm
+sudo chown -R $(whoami) ~/.npm
+sudo chown -R $(whoami) $(npm config get prefix)
+
+# Thay thế: Sử dụng npx
+npx gbu-accessibility-package --help
+
+# Windows: Chạy với quyền Administrator hoặc dùng npx
+```
+
+#### Package không hoạt động sau khi cập nhật
+
+```bash
+# Cài đặt lại hoàn toàn
+npm uninstall -g gbu-accessibility-package
+npm cache clean --force
+npm install -g gbu-accessibility-package@latest
+
+# Kiểm tra cài đặt
+gbu-a11y --version
+which gbu-a11y
+```
+
+#### File không được xử lý
+
+```bash
+# Kiểm tra phần mở rộng file (chỉ hỗ trợ .html)
+ls -la *.html
+
+# Kiểm tra quyền file
+ls -la your-file.html
+
+# Chạy với output chi tiết
+gbu-a11y --dry-run your-file.html
+```
+
+#### File backup tích tụ quá nhiều
+
+```bash
+# Xóa tất cả file backup
+find . -name "*.backup" -type f -delete
+
+# Ngăn tạo backup
+gbu-a11y --no-backup
+
+# Cấu hình script cleanup
+echo 'alias cleanup-backups="find . -name \"*.backup\" -type f -delete"' >> ~/.bashrc
+```
+
+#### Vấn đề hiệu suất
+
+```bash
+# Sử dụng --no-backup để xử lý nhanh hơn
+gbu-a11y --no-backup
+
+# Xử lý thư mục cụ thể thay vì toàn bộ dự án
+gbu-a11y ./src
+
+# Sử dụng individual modes cho sửa chữa có mục tiêu
+gbu-a11y --alt-only ./images
+```
+
+#### Vấn đề phiên bản Node.js
+
+```bash
+# Kiểm tra phiên bản Node.js (yêu cầu >=12.0.0)
+node --version
+
+# Cập nhật Node.js nếu cần
+# Truy cập: https://nodejs.org/
+
+# Sử dụng nvm để quản lý phiên bản Node.js
+nvm install 18
+nvm use 18
+```
+
+### Nhận trợ giúp
+
+Nếu bạn vẫn gặp vấn đề:
+
+1. **Kiểm tra phiên bản**: `gbu-a11y --version`
+2. **Thử dry run trước**: `gbu-a11y --dry-run`
+3. **Kiểm tra quyền file**: `ls -la your-files.html`
+4. **Xóa cache và cài lại**: Xem phần quản lý package ở trên
+5. **Sử dụng npx thay thế**: `npx gbu-accessibility-package --help`
+
 ## 🆘 Hỗ trợ
 
 - 📧 **Issues**: [GitHub Issues](https://github.com/dangpv94/gbu-accessibility-tool/issues)
@@ -478,6 +696,7 @@ Dự án này được cấp phép theo Giấy phép MIT - xem file [LICENSE](LI
 Package này giải quyết các vấn đề accessibility phổ biến từ axe DevTools:
 
 ### ✅ Đã hỗ trợ
+
 - `image-alt` - Images must have alternate text
 - `html-has-lang` - HTML element must have lang attribute
 - `label` - Form elements must have labels (cơ bản)
@@ -489,6 +708,7 @@ Package này giải quyết các vấn đề accessibility phổ biến từ axe
 - Duplicate role attributes cleanup
 
 ### 🔄 Đang phát triển
+
 - `color-contrast` - Color contrast checking
 - `focus-order-semantics` - Focus order validation
 - `aria-*` attributes validation
@@ -497,4 +717,4 @@ Package này giải quyết các vấn đề accessibility phổ biến từ axe
 
 ---
 
-Được tạo với ❤️ bởi GBU Team
+Được tạo với ❤️ bởi GBU Team

package/README.md

@@ -19,7 +19,7 @@
 - 📑 **Heading Analysis** - Analyze heading structure with suggestions (no auto-fix)
 - 🧹 **Duplicate Cleanup** - Remove duplicate role attributes
 - 📁 **Batch Processing** - Process entire directories recursively
-- 💾 **Automatic Backups** - Safe modifications with backup files
+- 💾 **Optional Backups** - Create backup files when needed with --backup flag
 - 🔍 **Dry Run Mode** - Preview changes before applying
 - 📊 **Detailed Reports** - Comprehensive fix summaries
 
@@ -61,8 +61,8 @@ gbu-a11y [options] [directory/file]
 Options:
   -d, --directory <path>    Target directory (default: current directory)
   -l, --language <lang>     Language for lang attribute (default: ja)
-  --backup                 Create backup files (default: enabled)
-  --no-backup              Don't create backup files
+  --backup                 Create backup files
+  --no-backup              Don't create backup files (default)
   --dry-run                Preview changes without applying
   --comprehensive, --all   Run comprehensive fixes (same as default)
   --cleanup-only           Only cleanup duplicate role attributes
@@ -103,8 +103,8 @@ gbu-a11y --alt-only --dry-run ./src    # Preview alt fixes + cleanup
 gbu-a11y --forms-only -l en ./public   # Form fixes + cleanup with English lang
 
 # Backup options
-gbu-a11y --backup ./dist             # Explicitly enable backups (default)
-gbu-a11y --no-backup ./dist          # Disable backups for faster processing
+gbu-a11y --backup ./dist             # Enable backups for safety
+gbu-a11y --no-backup ./dist          # Disable backups (default - faster processing)
 ```
 
 ## 🔧 Programmatic Usage
@@ -367,19 +367,19 @@ The package uses intelligent context analysis to generate meaningful alt text:
 ## 🔒 Safety Features
 
 ### Backup Options
-- **Default behavior**: Creates `.backup` files automatically for safety
-- **Disable backups**: Use `--no-backup` for faster processing
-- **Explicit enable**: Use `--backup` to be explicit about backup creation
+- **Default behavior**: No backup files for faster processing
+- **Enable backups**: Use `--backup` for safety when needed
+- **Explicit disable**: Use `--no-backup` to be explicit (same as default)
 
 ```bash
-# Safe mode (default) - creates backups
+# Fast mode (default) - no backups
 gbu-a11y --comprehensive
 
-# Fast mode - no backups
-gbu-a11y --no-backup --comprehensive
-
-# Explicit backup mode
+# Safe mode - creates backups
 gbu-a11y --backup --comprehensive
+
+# Explicit no backup mode (same as default)
+gbu-a11y --no-backup --comprehensive
 ```
 
 ### Other Safety Features
@@ -388,6 +388,92 @@ gbu-a11y --backup --comprehensive
 - **Duplicate prevention** - won't add existing attributes
 - **Error handling** - continues processing on individual file errors
 
+## 🔧 Package Management
+
+### Uninstall and Reinstall
+
+If you encounter issues or want to update to the latest version:
+
+```bash
+# Uninstall global package
+npm uninstall -g gbu-accessibility-package
+
+# Clear npm cache
+npm cache clean --force
+
+# Reinstall latest version
+npm install -g gbu-accessibility-package@latest
+
+# Verify installation
+gbu-a11y --version
+gbu-a11y --help
+```
+
+### Local Project Management
+
+```bash
+# Remove from local project
+npm uninstall gbu-accessibility-package
+
+# Clear package-lock and node_modules
+rm -rf node_modules package-lock.json
+
+# Reinstall dependencies
+npm install
+
+# Add latest version
+npm install gbu-accessibility-package@latest
+```
+
+### Clear Backup Files
+
+```bash
+# Remove all backup files in current directory
+find . -name "*.backup" -type f -delete
+
+# Remove backup files in specific directory
+find ./src -name "*.backup" -type f -delete
+
+# Using npm script (if configured)
+npm run cleanup-backups
+```
+
+### Troubleshooting Installation
+
+```bash
+# Check npm configuration
+npm config list
+
+# Reset npm registry (if needed)
+npm config set registry https://registry.npmjs.org/
+
+# Check global packages
+npm list -g --depth=0
+
+# Fix permissions (macOS/Linux)
+sudo chown -R $(whoami) ~/.npm
+sudo chown -R $(whoami) /usr/local/lib/node_modules
+
+# Alternative: Use npx without global install
+npx gbu-accessibility-package --help
+```
+
+### Version Management
+
+```bash
+# Check current version
+gbu-a11y --version
+
+# Check available versions
+npm view gbu-accessibility-package versions --json
+
+# Install specific version
+npm install -g gbu-accessibility-package@2.0.0
+
+# Update to latest
+npm update -g gbu-accessibility-package
+```
+
 ## 🛠️ Configuration
 
 ### Package.json Scripts
@@ -452,6 +538,108 @@ This package addresses common issues found by axe DevTools:
 
 This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
 
+## 🔧 Troubleshooting
+
+### Common Issues and Solutions
+
+#### Package Not Found or Command Not Working
+```bash
+# Check if package is installed globally
+npm list -g gbu-accessibility-package
+
+# If not found, install globally
+npm install -g gbu-accessibility-package
+
+# Check PATH includes npm global bin
+echo $PATH | grep npm
+
+# Add npm global bin to PATH (if needed)
+export PATH=$PATH:$(npm config get prefix)/bin
+```
+
+#### Permission Errors
+```bash
+# macOS/Linux: Fix npm permissions
+sudo chown -R $(whoami) ~/.npm
+sudo chown -R $(whoami) $(npm config get prefix)
+
+# Alternative: Use npx
+npx gbu-accessibility-package --help
+
+# Windows: Run as Administrator or use npx
+```
+
+#### Package Not Working After Update
+```bash
+# Complete reinstall
+npm uninstall -g gbu-accessibility-package
+npm cache clean --force
+npm install -g gbu-accessibility-package@latest
+
+# Verify installation
+gbu-a11y --version
+which gbu-a11y
+```
+
+#### Files Not Being Processed
+```bash
+# Check file extensions (only .html files supported)
+ls -la *.html
+
+# Check file permissions
+ls -la your-file.html
+
+# Run with verbose output
+gbu-a11y --dry-run your-file.html
+```
+
+#### Backup Files Accumulating
+```bash
+# Clean all backup files
+find . -name "*.backup" -type f -delete
+
+# Prevent backup creation
+gbu-a11y --no-backup
+
+# Configure cleanup script
+echo 'alias cleanup-backups="find . -name \"*.backup\" -type f -delete"' >> ~/.bashrc
+```
+
+#### Performance Issues
+```bash
+# Use --no-backup for faster processing
+gbu-a11y --no-backup
+
+# Process specific directories instead of entire project
+gbu-a11y ./src
+
+# Use individual modes for targeted fixes
+gbu-a11y --alt-only ./images
+```
+
+#### Node.js Version Issues
+```bash
+# Check Node.js version (requires >=12.0.0)
+node --version
+
+# Update Node.js if needed
+# Visit: https://nodejs.org/
+
+# Use nvm to manage Node.js versions
+nvm install 18
+nvm use 18
+```
+
+### Getting Help
+
+If you're still experiencing issues:
+
+1. **Check the version**: `gbu-a11y --version`
+2. **Try dry run first**: `gbu-a11y --dry-run`
+3. **Check file permissions**: `ls -la your-files.html`
+4. **Clear cache and reinstall**: See package management section above
+5. **Use npx as alternative**: `npx gbu-accessibility-package --help`
+
 ## 🆘 Support
 
 - 📧 **Issues**: [GitHub Issues](https://github.com/dangpv94/gbu-accessibility-tool/issues)

package/cli.js

@@ -14,7 +14,7 @@ const args = process.argv.slice(2);
 const options = {
   directory: '.',
   language: 'ja',
-  backupFiles: true, // Default to true for safety
+  backupFiles: false, // Default to false for faster processing
   dryRun: false,
   help: false,
   cleanupOnly: false,
@@ -103,8 +103,8 @@ Usage: node cli.js [options] [directory]
 Options:
   -d, --directory <path>    Target directory (default: current directory)
   -l, --language <lang>     Language for lang attribute (default: ja)
-  --backup                 Create backup files (default: enabled)
-  --no-backup              Don't create backup files
+  --backup                 Create backup files
+  --no-backup              Don't create backup files (default)
   --dry-run                Preview changes without applying
   --comprehensive, --all   Run comprehensive fixes (same as default)
   --cleanup-only           Only cleanup duplicate role attributes
@@ -119,7 +119,7 @@ Options:
   -h, --help               Show this help message
 
 Examples:
-  node cli.js                          # Comprehensive fixes (default mode)
+  node cli.js                          # Comprehensive fixes (no backup by default)
   node cli.js --comprehensive          # Comprehensive fixes (same as default)
   node cli.js --alt-only               # Fix alt attributes + cleanup
   node cli.js --forms-only             # Fix form labels + cleanup
@@ -130,7 +130,7 @@ Examples:
   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
-  node cli.js --no-backup ./public    # Comprehensive fixes without backups
+  node cli.js --backup ./public       # Comprehensive fixes with backups
 
 Features:
   ✅ Alt attributes for images
@@ -153,7 +153,7 @@ function showCompletionMessage(options, mode = 'fixes') {
       console.log(chalk.gray('   📁 Backup files created with .backup extension'));
       console.log(chalk.gray('   💡 Use --no-backup to disable backups in future runs'));
     } else {
-      console.log(chalk.yellow('   ⚠️  No backup files created (--no-backup was used)'));
+      console.log(chalk.blue('   ⚡ No backup files created (default behavior for faster processing)'));
       console.log(chalk.gray('   💡 Use --backup to enable backups for safety'));
     }
   }

package/demo/no-backup-test.html

@@ -0,0 +1,12 @@
+<!DOCTYPE html>
+<html>
+<head>
+    <meta charset="UTF-8">
+    <title>No Backup Test</title>
+</head>
+<body>
+    <h1>No Backup Test</h1>
+    <img src="test.jpg" alt="Test image" role="img" aria-label="Test image">
+    <a href="/home" role="link">Home</a>
+</body>
+</html>

package/demo/no-backup-test.html.backup

@@ -0,0 +1,12 @@
+<!DOCTYPE html>
+<html>
+<head>
+    <meta charset="UTF-8">
+    <title>No Backup Test</title>
+</head>
+<body>
+    <h1>No Backup Test</h1>
+    <img src="test.jpg" alt="Test image">
+    <a href="/home">Home</a>
+</body>
+</html>

package/lib/fixer.js

@@ -10,7 +10,7 @@ const chalk = require('chalk');
 class AccessibilityFixer {
   constructor(config = {}) {
     this.config = {
-      backupFiles: config.backupFiles !== false,
+      backupFiles: config.backupFiles === true,
       language: config.language || 'ja',
       dryRun: config.dryRun || false,
       ...config

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gbu-accessibility-package",
-  "version": "3.1.0",
+  "version": "3.1.3",
   "description": "Comprehensive accessibility fixes for HTML files. Smart context-aware alt text generation, form labels, button names, link names, landmarks, heading analysis, and WCAG-compliant role attributes. Covers major axe DevTools issues with individual fix modes.",
   "main": "index.js",
   "bin": {