npm - gbu-accessibility-package - Versions diffs - 3.10.0 → 3.10.2 - Mend

gbu-accessibility-package 3.10.0 → 3.10.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (3) hide show

package/CHANGELOG.md CHANGED Viewed

@@ -5,6 +5,29 @@ 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.10.2] - 2025-12-09
+### Improved
+- **Smarter Partial File Detection**: Enhanced detection of HTML partial/include files using 3 methods:
+  1. Files containing `<!--#include virtual="...">` or `<!--#include file="...">`
+  2. Files in `/inc/` directory (common pattern for partials)
+  3. Files without `<!DOCTYPE html>` or `<html>` tag (HTML fragments)
+- Partial files are automatically skipped during meta tag analysis
+- Each detection method provides a specific skip reason in the summary
+## [3.10.1] - 2025-12-09
+### Changed
+- **SSI Include Files Ignored**: Files containing `<!--#include virtual="...">` are now skipped during meta tag analysis
+- **Recommendations vs Warnings**: Separated optional improvements from actual warnings:
+  - `og:image:width`, `og:image:height`, `og:image:alt` → Now shown as 💎 recommendations
+  - `Canonical URL` → Now shown as 💎 recommendation
+  - These are optional best practices, not errors or warnings
+### Improved
+- **Summary Statistics**: Now shows count of skipped files and recommendations separately
+- **Output Clarity**: Clear distinction between ❌ issues, ⚠️ warnings, and 💎 recommendations
 ## [3.10.0] - 2025-12-09
 ### Added

package/lib/fixer.js CHANGED Viewed

@@ -7258,7 +7258,18 @@ class AccessibilityFixer {
         const content = await fs.readFile(file, 'utf8');
         const metaAnalysis = this.analyzeMetaTags(content, file);
-        if (metaAnalysis.issues.length > 0 || metaAnalysis.warnings.length > 0) {
+        // Skip SSI include files
+        if (metaAnalysis.isIncludeFile) {
+          results.push({
+            file,
+            status: 'skipped',
+            reason: 'SSI include file',
+            metaAnalysis
+          });
+          continue;
+        }
+        if (metaAnalysis.issues.length > 0 || metaAnalysis.warnings.length > 0 || metaAnalysis.recommendations.length > 0) {
           console.log(chalk.cyan(`\n📁 ${path.relative(directory, file)}:`));
           // Show status for required OG tags
@@ -7282,7 +7293,7 @@ class AccessibilityFixer {
             console.log(chalk.green(`  ✅ Twitter Card: Đã cài đặt`));
           }
-          // Show issues
+          // Show issues (errors)
           metaAnalysis.issues.forEach(issue => {
             console.log(chalk.red(`  ❌ ${issue.type}: ${issue.description}`));
             if (issue.suggestion) {
@@ -7297,6 +7308,16 @@ class AccessibilityFixer {
               console.log(chalk.gray(`    💡 ${warning.suggestion}`));
             }
           });
+          // Show recommendations (optional improvements)
+          if (metaAnalysis.recommendations.length > 0) {
+            metaAnalysis.recommendations.forEach(rec => {
+              console.log(chalk.blue(`  💎 ${rec.type}: ${rec.description}`));
+              if (rec.suggestion) {
+                console.log(chalk.gray(`    ℹ️ ${rec.suggestion}`));
+              }
+            });
+          }
         }
         results.push({
@@ -7310,16 +7331,30 @@ class AccessibilityFixer {
       }
     }
+    const filesAnalyzed = results.filter(r => r.status === 'analyzed').length;
+    const filesSkipped = results.filter(r => r.status === 'skipped').length;
     const filesWithOG = results.filter(r => r.metaAnalysis?.hasOpenGraph).length;
     const filesWithIssues = results.filter(r => r.metaAnalysis?.issues?.length > 0).length;
     const filesWithWarnings = results.filter(r => r.metaAnalysis?.warnings?.length > 0).length;
+    const filesWithRecs = results.filter(r => r.metaAnalysis?.recommendations?.length > 0).length;
     const totalIssues = results.reduce((sum, r) => sum + (r.metaAnalysis?.issues?.length || 0), 0);
     const totalWarnings = results.reduce((sum, r) => sum + (r.metaAnalysis?.warnings?.length || 0), 0);
+    const totalRecs = results.reduce((sum, r) => sum + (r.metaAnalysis?.recommendations?.length || 0), 0);
-    console.log(chalk.blue(`\n📊 Tóm tắt: Đã phân tích ${results.length} file`));
+    console.log(chalk.blue(`\n📊 Tóm tắt: Đã phân tích ${filesAnalyzed} file`));
+    if (filesSkipped > 0) {
+      console.log(chalk.gray(`  ⏭️ Bỏ qua: ${filesSkipped} file (SSI include)`));
+    }
     console.log(chalk.green(`  ✅ File có Open Graph: ${filesWithOG}`));
-    console.log(chalk.red(`  ❌ File có lỗi: ${filesWithIssues} (${totalIssues} vấn đề)`));
-    console.log(chalk.yellow(`  ⚠️ File có cảnh báo: ${filesWithWarnings} (${totalWarnings} cảnh báo)`));
+    if (totalIssues > 0) {
+      console.log(chalk.red(`  ❌ File có lỗi: ${filesWithIssues} (${totalIssues} vấn đề)`));
+    }
+    if (totalWarnings > 0) {
+      console.log(chalk.yellow(`  ⚠️ File có cảnh báo: ${filesWithWarnings} (${totalWarnings} cảnh báo)`));
+    }
+    if (totalRecs > 0) {
+      console.log(chalk.blue(`  💎 File có khuyến nghị: ${filesWithRecs} (${totalRecs} khuyến nghị)`));
+    }
     console.log(chalk.gray('💡 Open Graph Protocol cần có 4 thẻ bắt buộc: og:title, og:type, og:image, og:url'));
     return results;
@@ -7330,16 +7365,43 @@ class AccessibilityFixer {
       hasOpenGraph: false,
       hasTwitterCard: false,
       hasBasicMeta: false,
+      isIncludeFile: false, // New: track if this is an SSI include file
       requiredTags: [],
       optionalTags: [],
       twitterTags: [],
       basicTags: [],
       issues: [],
       warnings: [],
+      recommendations: [], // New: optional improvements, not errors
       syntaxErrors: [],
       typos: [] // New: track typos for auto-fix
     };
+    // Check if this is an SSI include file or partial file (should be skipped)
+    // Method 1: File contains SSI include directive
+    const ssiIncludePattern = /<!--#include\s+(virtual|file)\s*=\s*["'][^"']+["']\s*-->/i;
+    if (ssiIncludePattern.test(content)) {
+      result.isIncludeFile = true;
+      result.skipReason = 'Chứa SSI include directive';
+      return result; // Skip analysis for include files
+    }
+    // Method 2: File path contains /inc/ directory (common pattern for partials)
+    if (filePath && /[\/\\]inc[\/\\]/i.test(filePath)) {
+      result.isIncludeFile = true;
+      result.skipReason = 'File partial trong thư mục /inc/';
+      return result;
+    }
+    // Method 3: File doesn't have DOCTYPE or <html> tag (likely a partial)
+    const hasDoctype = /<!DOCTYPE\s+html/i.test(content);
+    const hasHtmlTag = /<html[\s>]/i.test(content);
+    if (!hasDoctype && !hasHtmlTag) {
+      result.isIncludeFile = true;
+      result.skipReason = 'File partial (không có DOCTYPE/html)';
+      return result;
+    }
     // Required OG Tags according to Open Graph Protocol
     const requiredOGTags = ['og:title', 'og:type', 'og:image', 'og:url'];
     const optionalOGTags = ['og:description', 'og:site_name', 'og:locale', 'og:image:width', 'og:image:height', 'og:image:alt', 'og:image:secure_url', 'og:audio', 'og:video', 'og:determiner'];
@@ -7704,7 +7766,7 @@ class AccessibilityFixer {
       });
     });
-    // Check og:image dimensions
+    // Check og:image dimensions - these are recommendations, not required
     const ogImage = allMetaTags.find(t => t.property === 'og:image');
     if (ogImage) {
       const ogImageWidth = allMetaTags.find(t => t.property === 'og:image:width');
@@ -7712,17 +7774,17 @@ class AccessibilityFixer {
       const ogImageAlt = allMetaTags.find(t => t.property === 'og:image:alt');
       if (!ogImageWidth || !ogImageHeight) {
-        result.warnings.push({
-          type: 'Thiếu kích thước og:image',
-          description: 'Chưa khai báo kích thước hình ảnh og:image',
+        result.recommendations.push({
+          type: 'Kích thước og:image',
+          description: 'Cân nhắc thêm kích thước hình ảnh og:image',
           suggestion: 'Thêm og:image:width và og:image:height để tối ưu hiển thị. Khuyến nghị: 1200x630 pixels'
         });
       }
       if (!ogImageAlt) {
-        result.warnings.push({
-          type: 'Thiếu og:image:alt',
-          description: 'Chưa có mô tả alt text cho og:image',
+        result.recommendations.push({
+          type: 'og:image:alt',
+          description: 'Cân nhắc thêm alt text cho og:image',
           suggestion: 'Thêm <meta property="og:image:alt" content="Mô tả hình ảnh"> để cải thiện accessibility'
         });
       }
@@ -7760,14 +7822,14 @@ class AccessibilityFixer {
       });
     }
-    // Check for canonical URL
+    // Check for canonical URL - this is a recommendation, not required
     const canonicalPattern = /<link\s+[^>]*rel\s*=\s*["']canonical["'][^>]*>/i;
     const canonicalMatch = content.match(canonicalPattern);
     if (!canonicalMatch) {
-      result.warnings.push({
-        type: 'Thiếu Canonical URL',
-        description: 'Không tìm thấy thẻ link rel="canonical"',
-        suggestion: 'Thêm <link rel="canonical" href="https://example.com/your-page"> để tránh duplicate content'
+      result.recommendations.push({
+        type: 'Canonical URL',
+        description: 'Chưa có thẻ link rel="canonical"',
+        suggestion: 'Cân nhắc thêm <link rel="canonical" href="..."> để tránh duplicate content'
       });
     }
@@ -7855,6 +7917,17 @@ class AccessibilityFixer {
         const originalContent = content;
         const metaAnalysis = this.analyzeMetaTags(content, file);
+        // Skip SSI include files
+        if (metaAnalysis.isIncludeFile) {
+          results.push({
+            file,
+            status: 'skipped',
+            reason: 'SSI include file',
+            fixes: 0
+          });
+          continue;
+        }
         let fixCount = 0;
         const fixes = [];

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "gbu-accessibility-package",
-  "version": "3.10.0",
+  "version": "3.10.2",
   "description": "Comprehensive accessibility fixes and project optimization for HTML files. Smart context-aware alt text generation, form labels, button names, link names, landmarks, heading analysis, WCAG-compliant role attributes, unused files detection, dead code analysis, broken external links detection, missing local resources detection, and Meta Tags & Open Graph Protocol validation. Covers major axe DevTools issues with individual fix modes.",
   "main": "index.js",
   "bin": {