fix: only show error messages related to configured severities

fixes #4

.github/workflows/build.yml

@@ -10,7 +10,7 @@ jobs:
   build:
     runs-on: 'ubuntu-latest'
     steps:
-      - uses: 'actions/checkout@v3.5.2'
+      - uses: 'actions/checkout@v3.5.3'
 
       - name: 'Setup Node.js'
         uses: 'actions/setup-node@v3.6.0'

.github/workflows/lint.yml

@@ -10,7 +10,7 @@ jobs:
   lint:
     runs-on: 'ubuntu-latest'
     steps:
-      - uses: 'actions/checkout@v3.5.2'
+      - uses: 'actions/checkout@v3.5.3'
 
       - name: 'Setup Node.js'
         uses: 'actions/setup-node@v3.6.0'

.github/workflows/release.yml

@@ -13,7 +13,7 @@ jobs:
       pull-requests: 'write'
       id-token: 'write'
     steps:
-      - uses: 'actions/checkout@v3.5.2'
+      - uses: 'actions/checkout@v3.5.3'
         with:
           fetch-depth: 0
           persist-credentials: false

.github/workflows/test.yml

@@ -10,7 +10,7 @@ jobs:
   test:
     runs-on: 'ubuntu-latest'
     steps:
-      - uses: 'actions/checkout@v3.5.2'
+      - uses: 'actions/checkout@v3.5.3'
 
       - name: 'Setup Node.js'
         uses: 'actions/setup-node@v3.6.0'

.html-w3c-validatorrc.json

@@ -0,0 +1,3 @@
+{
+  "files": ["./example/build/index.html", "./example/build/about.html"]
+}

.prettierignore

@@ -0,0 +1 @@
+fixtures

.swcrc

@@ -1,22 +1,13 @@
 {
+  "sourceMaps": true,
   "jsc": {
     "parser": {
       "syntax": "typescript",
-      "decorators": true,
       "dynamicImport": true
     },
-    "transform": {
+    "target": "es2022"
-      "legacyDecorator": true,
-      "decoratorMetadata": true
-    },
-    "target": "es2022",
-    "loose": true
   },
   "module": {
-    "type": "es6",
+    "type": "es6"
-    "strict": false,
-    "strictMode": true,
-    "lazy": false,
-    "noInterop": false
   }
 }

.taprc

@@ -1,9 +0,0 @@
-ts: false
-jsx: false
-flow: false
-check-coverage: false
-coverage: false
-timeout: 120000
-
-files:
-  - 'build/**/*.test.js'

CODE_OF_CONDUCT.md

@@ -60,7 +60,7 @@ representative at an online or offline event.
 
 Instances of abusive, harassing, or otherwise unacceptable behavior may be
 reported to the community leaders responsible for enforcement at
-<contact@divlo.fr>.
+<contact@theoludwig.fr>.
 All complaints will be reviewed and investigated promptly and fairly.
 
 All community leaders are obligated to respect the privacy and security of the

CONTRIBUTING.md

@@ -19,7 +19,7 @@ All work on **html-w3c-validator** happens directly on this repository. Both cor
 
 ## Pull Requests
 
-- **Please first discuss** the change you wish to make via [issue](https://github.com/Divlo/html-w3c-validator/issues) before making a change. It might avoid a waste of your time.
+- **Please first discuss** the change you wish to make via [issue](https://github.com/theoludwig/html-w3c-validator/issues) before making a change. It might avoid a waste of your time.
 
 - Ensure your code respect linting.
 

LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) Divlo
+Copyright (c) Théo LUDWIG
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

README.md

@@ -11,9 +11,9 @@
   <a href="./LICENSE"><img src="https://img.shields.io/badge/licence-MIT-blue.svg" alt="Licence MIT"/></a>
   <a href="./CODE_OF_CONDUCT.md"><img src="https://img.shields.io/badge/Contributor%20Covenant-v2.0%20adopted-ff69b4.svg" alt="Contributor Covenant" /></a>
   <br />
-  <a href="https://github.com/Divlo/html-w3c-validator/actions/workflows/build.yml"><img src="https://github.com/Divlo/html-w3c-validator/actions/workflows/build.yml/badge.svg?branch=develop" /></a>
+  <a href="https://github.com/theoludwig/html-w3c-validator/actions/workflows/build.yml"><img src="https://github.com/theoludwig/html-w3c-validator/actions/workflows/build.yml/badge.svg?branch=develop" /></a>
-  <a href="https://github.com/Divlo/html-w3c-validator/actions/workflows/lint.yml"><img src="https://github.com/Divlo/html-w3c-validator/actions/workflows/lint.yml/badge.svg?branch=develop" /></a>
+  <a href="https://github.com/theoludwig/html-w3c-validator/actions/workflows/lint.yml"><img src="https://github.com/theoludwig/html-w3c-validator/actions/workflows/lint.yml/badge.svg?branch=develop" /></a>
-  <a href="https://github.com/Divlo/html-w3c-validator/actions/workflows/test.yml"><img src="https://github.com/Divlo/html-w3c-validator/actions/workflows/test.yml/badge.svg?branch=develop" /></a>
+  <a href="https://github.com/theoludwig/html-w3c-validator/actions/workflows/test.yml"><img src="https://github.com/theoludwig/html-w3c-validator/actions/workflows/test.yml/badge.svg?branch=develop" /></a>
   <br />
   <a href="https://conventionalcommits.org"><img src="https://img.shields.io/badge/Conventional%20Commits-1.0.0-yellow.svg" alt="Conventional Commits" /></a>
   <a href="https://github.com/semantic-release/semantic-release"><img src="https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg" alt="semantic-release" /></a>
@@ -71,7 +71,10 @@ npm install --save-dev html-w3c-validator start-server-and-test
   "urls": ["http://127.0.0.1:3000/", "http://127.0.0.1:3000/about"],
 
   // You can also specify HTML files instead of URLs
-  "files": ["./index.html", "./about.html"]
+  "files": ["./index.html", "./about.html"],
+
+  // Specify the severities of the validator (default: ["warning", "error"])
+  "severities": ["info", "warning", "error"]
 }
 ```
 

example/build/about.html

@@ -1,4 +1,4 @@
-<!DOCTYPE html>
+<!doctype html>
 <html lang="en">
   <head>
     <meta charset="UTF-8" />

example/build/index.html

@@ -1,4 +1,4 @@
-<!DOCTYPE html>
+<!doctype html>
 <html lang="en">
   <head>
     <meta charset="UTF-8" />

example/package-lock.json

@@ -16,11 +16,11 @@
       "dev": true,
       "license": "MIT",
       "dependencies": {
-        "chalk": "5.2.0",
+        "chalk": "5.3.0",
-        "clipanion": "3.2.0",
+        "clipanion": "3.2.1",
         "html-validator": "6.0.1",
         "log-symbols": "5.1.0",
-        "ora": "6.3.0",
+        "ora": "7.0.1",
         "read-pkg": "8.0.0",
         "table": "6.8.1"
       },
@@ -28,35 +28,36 @@
         "html-w3c-validator": "build/index.js"
       },
       "devDependencies": {
-        "@commitlint/cli": "17.6.3",
+        "@commitlint/cli": "17.7.0",
-        "@commitlint/config-conventional": "17.6.3",
+        "@commitlint/config-conventional": "17.7.0",
         "@swc/cli": "0.1.62",
-        "@swc/core": "1.3.57",
+        "@swc/core": "1.3.75",
         "@tsconfig/strictest": "2.0.1",
         "@types/html-validator": "5.0.3",
         "@types/mock-fs": "4.13.1",
-        "@types/node": "20.1.3",
+        "@types/node": "20.4.9",
-        "@types/tap": "15.0.8",
+        "@types/sinon": "10.0.16",
-        "@typescript-eslint/eslint-plugin": "5.59.5",
+        "@typescript-eslint/eslint-plugin": "6.3.0",
-        "editorconfig-checker": "5.0.1",
+        "@typescript-eslint/parser": "6.3.0",
-        "eslint": "8.40.0",
+        "editorconfig-checker": "5.1.1",
-        "eslint-config-conventions": "9.0.0",
+        "eslint": "8.46.0",
-        "eslint-config-prettier": "8.8.0",
+        "eslint-config-conventions": "11.0.1",
-        "eslint-plugin-import": "2.27.5",
+        "eslint-config-prettier": "9.0.0",
-        "eslint-plugin-prettier": "4.2.1",
+        "eslint-plugin-import": "2.28.0",
+        "eslint-plugin-prettier": "5.0.0",
         "eslint-plugin-promise": "6.1.1",
-        "eslint-plugin-unicorn": "47.0.0",
+        "eslint-plugin-unicorn": "48.0.1",
-        "execa": "7.1.1",
+        "execa": "7.2.0",
-        "lint-staged": "13.2.2",
+        "lint-staged": "13.2.3",
-        "markdownlint-cli2": "0.7.1",
+        "markdownlint-cli2": "0.8.1",
-        "markdownlint-rule-relative-links": "1.2.0",
+        "markdownlint-rule-relative-links": "2.1.0",
         "mock-fs": "5.2.0",
-        "prettier": "2.8.8",
+        "prettier": "3.0.1",
-        "rimraf": "5.0.0",
+        "rimraf": "5.0.1",
-        "semantic-release": "21.0.2",
+        "semantic-release": "21.0.7",
         "serve": "14.2.0",
-        "tap": "16.3.4",
+        "sinon": "15.2.0",
-        "typescript": "5.0.4"
+        "typescript": "5.1.6"
       },
       "engines": {
         "node": ">=16.0.0",
@@ -1188,9 +1189,9 @@
       }
     },
     "node_modules/strip-ansi": {
-      "version": "7.0.1",
+      "version": "7.1.0",
-      "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-7.0.1.tgz",
+      "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-7.1.0.tgz",
-      "integrity": "sha512-cXNxvT8dFNRVfhVME3JAe98mkXDYN2O1l7jmcwMnOslDeESg1rF/OZMtK0nRAhiari1unG5cD4jG3rapUAkLbw==",
+      "integrity": "sha512-iq6eVVI64nQQTRYq2KtEg2d2uU7LElhTJwsH4YzIHZshxlgZms/wIc4VoDQTlG/IvVIrBKG06CrZnp0qv7hkcQ==",
       "dev": true,
       "dependencies": {
         "ansi-regex": "^6.0.1"
@@ -1239,9 +1240,9 @@
       "dev": true
     },
     "node_modules/tslib": {
-      "version": "2.5.0",
+      "version": "2.6.1",
-      "resolved": "https://registry.npmjs.org/tslib/-/tslib-2.5.0.tgz",
+      "resolved": "https://registry.npmjs.org/tslib/-/tslib-2.6.1.tgz",
-      "integrity": "sha512-336iVw3rtn2BUK7ORdIAHTyxHGRIHVReokCR3XjbckJMK7ms8FysBfhLR8IXnAgy7T0PTPNBWKiH514FOW/WSg==",
+      "integrity": "sha512-t0hLfiEKfMUoqhG+U1oid7Pva4bbDPHYfJNiB7BiIjRkj1pyC++4N3huJfqY6aRH6VTB0rvtzQwjM4K6qpfOig==",
       "dev": true
     },
     "node_modules/type-fest": {

example/package.json

@@ -2,7 +2,7 @@
   "name": "example",
   "private": true,
   "scripts": {
-    "start": "serve \"./build\"",
+    "start": "serve ./build",
     "test:html-w3c-validator": "start-server-and-test \"start\" \"http://127.0.0.1:3000\" \"html-w3c-validator\""
   },
   "devDependencies": {

package.json

@@ -4,16 +4,16 @@
   "public": true,
   "description": "CLI for validating multiple html pages using validator.w3.org.",
   "type": "module",
-  "author": "Divlo <contact@divlo.fr>",
+  "author": "Théo LUDWIG <contact@theoludwig.fr>",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/Divlo/html-w3c-validator.git"
+    "url": "https://github.com/theoludwig/html-w3c-validator.git"
   },
   "bugs": {
-    "url": "https://github.com/Divlo/html-w3c-validator/issues"
+    "url": "https://github.com/theoludwig/html-w3c-validator/issues"
   },
-  "homepage": "https://github.com/Divlo/html-w3c-validator#readme",
+  "homepage": "https://github.com/theoludwig/html-w3c-validator#readme",
   "keywords": [
     "cli",
     "html-validator",
@@ -23,7 +23,9 @@
   "main": "build/index.js",
   "bin": "build/index.js",
   "files": [
-    "build"
+    "build",
+    "!**/*.test.js",
+    "!**/*.map"
   ],
   "publishConfig": {
     "access": "public",
@@ -36,53 +38,55 @@
   "scripts": {
     "build": "rimraf ./build && swc ./src --out-dir ./build",
     "build:typescript": "tsc",
+    "start": "node --enable-source-maps build/index.js",
     "lint:commit": "commitlint",
     "lint:editorconfig": "editorconfig-checker",
     "lint:markdown": "markdownlint-cli2",
-    "lint:eslint": "eslint \".\" --ignore-path \".gitignore\"",
+    "lint:eslint": "eslint . --max-warnings 0 --report-unused-disable-directives --ignore-path .gitignore",
-    "lint:prettier": "prettier \".\" --check --ignore-path \".gitignore\"",
+    "lint:prettier": "prettier . --check",
     "lint:staged": "lint-staged",
-    "test": "tap",
+    "test": "node --enable-source-maps --test build/",
     "release": "semantic-release"
   },
   "dependencies": {
-    "chalk": "5.2.0",
+    "chalk": "5.3.0",
-    "clipanion": "3.2.0",
+    "clipanion": "3.2.1",
     "html-validator": "6.0.1",
     "log-symbols": "5.1.0",
-    "ora": "6.3.0",
+    "ora": "7.0.1",
     "read-pkg": "8.0.0",
     "table": "6.8.1"
   },
   "devDependencies": {
-    "@commitlint/cli": "17.6.3",
+    "@commitlint/cli": "17.7.0",
-    "@commitlint/config-conventional": "17.6.3",
+    "@commitlint/config-conventional": "17.7.0",
     "@swc/cli": "0.1.62",
-    "@swc/core": "1.3.57",
+    "@swc/core": "1.3.75",
     "@tsconfig/strictest": "2.0.1",
     "@types/html-validator": "5.0.3",
     "@types/mock-fs": "4.13.1",
-    "@types/node": "20.1.3",
+    "@types/node": "20.4.9",
-    "@types/tap": "15.0.8",
+    "@types/sinon": "10.0.16",
-    "@typescript-eslint/eslint-plugin": "5.59.5",
+    "@typescript-eslint/eslint-plugin": "6.3.0",
-    "editorconfig-checker": "5.0.1",
+    "@typescript-eslint/parser": "6.3.0",
-    "eslint": "8.40.0",
+    "editorconfig-checker": "5.1.1",
-    "eslint-config-conventions": "9.0.0",
+    "eslint": "8.46.0",
-    "eslint-config-prettier": "8.8.0",
+    "eslint-config-conventions": "11.0.1",
-    "eslint-plugin-import": "2.27.5",
+    "eslint-config-prettier": "9.0.0",
-    "eslint-plugin-prettier": "4.2.1",
+    "eslint-plugin-import": "2.28.0",
+    "eslint-plugin-prettier": "5.0.0",
     "eslint-plugin-promise": "6.1.1",
-    "eslint-plugin-unicorn": "47.0.0",
+    "eslint-plugin-unicorn": "48.0.1",
-    "execa": "7.1.1",
+    "execa": "7.2.0",
-    "lint-staged": "13.2.2",
+    "lint-staged": "13.2.3",
-    "markdownlint-cli2": "0.7.1",
+    "markdownlint-cli2": "0.8.1",
-    "markdownlint-rule-relative-links": "1.2.0",
+    "markdownlint-rule-relative-links": "2.1.0",
     "mock-fs": "5.2.0",
-    "prettier": "2.8.8",
+    "prettier": "3.0.1",
-    "rimraf": "5.0.0",
+    "rimraf": "5.0.1",
-    "semantic-release": "21.0.2",
+    "semantic-release": "21.0.7",
     "serve": "14.2.0",
-    "tap": "16.3.4",
+    "sinon": "15.2.0",
-    "typescript": "5.0.4"
+    "typescript": "5.1.6"
   }
 }

src/HTMLValidatorCommand.ts

@@ -1,7 +1,8 @@
 import path from 'node:path'
 import fs from 'node:fs'
 
-import { Command } from 'clipanion'
+import { Command, Option } from 'clipanion'
+import * as typanion from 'typanion'
 import chalk from 'chalk'
 import ora from 'ora'
 import logSymbols from 'log-symbols'
@@ -14,12 +15,16 @@ import { table } from 'table'
 
 import { isExistingPath } from './utils/isExistingPath.js'
 
-const CURRENT_DIRECTORY = process.cwd()
+export const CONFIG_FILE_NAME = '.html-w3c-validatorrc.json'
-const CONFIG_FILE_NAME = '.html-w3c-validatorrc.json'
+
+export const SEVERITIES = ['error', 'warning', 'info'] as const
+
+export type Severity = (typeof SEVERITIES)[number]
 
 interface Config {
   urls?: string[]
   files?: string[]
+  severities?: Severity[]
 }
 
 interface Error {
@@ -48,12 +53,21 @@ export class HTMLValidatorCommand extends Command {
       'CLI for validating multiple html pages using <https://validator.w3.org/>.'
   }
 
+  public currentWorkingDirectory = Option.String(
+    '--current-working-directory',
+    process.cwd(),
+    {
+      description: 'The current working directory.',
+      validator: typanion.isString()
+    }
+  )
+
   public async execute(): Promise<number> {
-    const configPath = path.join(CURRENT_DIRECTORY, CONFIG_FILE_NAME)
+    const configPath = path.join(this.currentWorkingDirectory, CONFIG_FILE_NAME)
     try {
       if (!(await isExistingPath(configPath))) {
         throw new Error(
-          `No config file found at ${configPath}. Please create ${CONFIG_FILE_NAME}.`
+          `No config file found at ${configPath}. Please create "${CONFIG_FILE_NAME}".`
         )
       }
       const configData = await fs.promises.readFile(configPath, {
@@ -66,12 +80,19 @@ export class HTMLValidatorCommand extends Command {
       } catch {
         isValidConfig = false
       }
-      isValidConfig =
-        isValidConfig &&
-        (Array.isArray(config.urls) || Array.isArray(config.urls))
       if (!isValidConfig) {
         throw new Error(
-          `Invalid config file at ${configPath}. Please check the syntax.`
+          `Invalid config file at "${configPath}". Please check the JSON syntax.`
+        )
+      }
+      if (config.urls != null && !Array.isArray(config.urls)) {
+        throw new Error(
+          `Invalid config file at "${configPath}". Please include an array of URLs.`
+        )
+      }
+      if (config.files != null && !Array.isArray(config.files)) {
+        throw new Error(
+          `Invalid config file at "${configPath}". Please include an array of files.`
         )
       }
       const urls =
@@ -87,6 +108,28 @@ export class HTMLValidatorCommand extends Command {
               return { type: 'file', data: file }
             })
       const dataToValidate = [...urls, ...files]
+      if (dataToValidate.length === 0) {
+        throw new Error(
+          `Invalid config file at "${configPath}". Please add URLs or files.`
+        )
+      }
+      const severities: Severity[] = config.severities ?? ['warning', 'error']
+      for (const severity of severities) {
+        if (!SEVERITIES.includes(severity)) {
+          throw new Error(
+            `Invalid config file at "${configPath}". Please add valid severities (${SEVERITIES.join(
+              ', '
+            )}).`
+          )
+        }
+      }
+      if (severities.length === 0) {
+        throw new Error(
+          `Invalid config file at "${configPath}". Please add valid severities (${SEVERITIES.join(
+            ', '
+          )}).`
+        )
+      }
       const errors: Error[] = []
       let isValid = true
       const loader = ora(`Validating HTML (W3C)...`).start()
@@ -105,10 +148,10 @@ export class HTMLValidatorCommand extends Command {
                 ...options
               })
             } else if (type === 'file') {
-              const htmlPath = path.resolve(CURRENT_DIRECTORY, data)
+              const htmlPath = path.resolve(this.currentWorkingDirectory, data)
               if (!(await isExistingPath(htmlPath))) {
                 throw new Error(
-                  `No file found at ${htmlPath}. Please check the path.`
+                  `No file found at "${htmlPath}". Please check the path.`
                 )
               }
               const html = await fs.promises.readFile(htmlPath, {
@@ -122,7 +165,10 @@ export class HTMLValidatorCommand extends Command {
               throw new Error('Invalid type')
             }
             const hasErrors = result.messages.some((message) => {
-              return message.type === 'error'
+              return (
+                severities.includes(message.type as Severity) ||
+                severities.includes(message.subType as Severity)
+              )
             })
             if (!hasErrors) {
               results.push({ data, isSuccess: true })
@@ -130,18 +176,31 @@ export class HTMLValidatorCommand extends Command {
               results.push({ data, isSuccess: false })
               const messagesTable: string[][] = []
               for (const message of result.messages) {
-                if (message.type === 'error') {
+                if (
-                  const row: string[] = []
+                  !severities.includes(message.type as Severity) &&
-                  row.push(chalk.red(message.type))
+                  !severities.includes(message.subType as Severity)
-                  row.push(message.message)
+                ) {
-                  const violation = message as ValidationMessageLocationObject
+                  continue
-                  if (violation.extract != null) {
-                    row.push(
-                      `line: ${violation.lastLine}, column: ${violation.firstColumn}-${violation.lastColumn}`
-                    )
-                  }
-                  messagesTable.push(row)
                 }
+
+                const row: string[] = []
+                if (message.type === 'info') {
+                  if (message.subType === 'warning') {
+                    row.push(chalk.yellow(message.subType))
+                  } else {
+                    row.push(chalk.blue(message.type))
+                  }
+                } else {
+                  row.push(chalk.red(message.type))
+                }
+                row.push(message.message)
+                const violation = message as ValidationMessageLocationObject
+                if (violation.extract != null) {
+                  row.push(
+                    `line: ${violation.lastLine}, column: ${violation.firstColumn}-${violation.lastColumn}`
+                  )
+                }
+                messagesTable.push(row)
               }
               errors.push({ data, messagesTable })
               isValid = false

src/__test__/HTMLValidatorCommand.test.ts

@@ -1,21 +1,416 @@
-import tap from 'tap'
+import test from 'node:test'
+import assert from 'node:assert/strict'
+import path from 'node:path'
+import { PassThrough } from 'node:stream'
+
+import sinon from 'sinon'
 import { execa } from 'execa'
+import { table } from 'table'
+import chalk from 'chalk'
+import logSymbols from 'log-symbols'
 
 import { cli } from '../cli.js'
-import { HTMLValidatorCommand } from '../HTMLValidatorCommand.js'
+import {
+  HTMLValidatorCommand,
+  CONFIG_FILE_NAME,
+  SEVERITIES
+} from '../HTMLValidatorCommand.js'
 
-await tap.test('html-w3c-validator', async (t) => {
+const FIXTURES_PATH = path.join(process.cwd(), 'src', '__test__', 'fixtures')
-  await t.test('should be instance of the command', async (t) => {
+
-    const command = cli.process([])
+await test('html-w3c-validator', async (t) => {
-    t.equal(command instanceof HTMLValidatorCommand, true)
+  t.afterEach(() => {
+    sinon.restore()
   })
 
-  await t.test('succeeds and validate the html correctly', async (t) => {
+  await t.test('should be instance of the command', async () => {
-    const exampleURL = new URL('../../example', import.meta.url)
+    const command = cli.process([])
-    process.chdir(exampleURL.pathname)
+    assert(command instanceof HTMLValidatorCommand)
-    await execa('rimraf', ['node_modules'])
+  })
-    await execa('npm', ['install'])
+
-    const { exitCode } = await execa('npm', ['run', 'test:html-w3c-validator'])
+  await t.test(
-    t.equal(exitCode, 0)
+    'succeeds and validate the html correctly (example)',
+    async () => {
+      const exampleURL = new URL('../../example', import.meta.url)
+      process.chdir(exampleURL.pathname)
+      await execa('rimraf', ['node_modules'])
+      await execa('npm', ['install'])
+      const { exitCode } = await execa('npm', [
+        'run',
+        'test:html-w3c-validator'
+      ])
+      assert.strictEqual(exitCode, 0)
+    }
+  )
+
+  await t.test(
+    'succeeds and validate the html correctly (example without working directory)',
+    async () => {
+      const logs: string[] = []
+      sinon.stub(console, 'log').value((log: string) => {
+        logs.push(log)
+      })
+      const consoleLogSpy = sinon.spy(console, 'log')
+      const stream = new PassThrough()
+      const exitCode = await cli.run([], {
+        stdin: process.stdin,
+        stdout: stream,
+        stderr: stream
+      })
+      stream.end()
+      assert.strictEqual(exitCode, 0)
+      assert.strictEqual(
+        consoleLogSpy.calledWith(
+          logSymbols.success,
+          './example/build/index.html'
+        ),
+        true,
+        logs.join('\n')
+      )
+      assert.strictEqual(
+        consoleLogSpy.calledWith(
+          logSymbols.success,
+          './example/build/about.html'
+        ),
+        true,
+        logs.join('\n')
+      )
+    }
+  )
+
+  await t.test(
+    'succeeds and validate the html correctly (fixture)',
+    async () => {
+      const workingDirectory = path.join(FIXTURES_PATH, 'success')
+      const logs: string[] = []
+      sinon.stub(console, 'log').value((log: string) => {
+        logs.push(log)
+      })
+      const consoleLogSpy = sinon.spy(console, 'log')
+      const stream = new PassThrough()
+      const exitCode = await cli.run(
+        [`--current-working-directory=${workingDirectory}`],
+        {
+          stdin: process.stdin,
+          stdout: stream,
+          stderr: stream
+        }
+      )
+      stream.end()
+      assert.strictEqual(exitCode, 0)
+      assert.strictEqual(
+        consoleLogSpy.calledWith(logSymbols.success, './build/index.html'),
+        true,
+        logs.join('\n')
+      )
+      assert.strictEqual(
+        consoleLogSpy.calledWith(logSymbols.success, './build/about.html'),
+        true,
+        logs.join('\n')
+      )
+    }
+  )
+
+  await t.test('fails with not found config', async () => {
+    const workingDirectory = path.join(FIXTURES_PATH, 'error-config-not-found')
+    const configPath = path.join(workingDirectory, CONFIG_FILE_NAME)
+    const errors: string[] = []
+    sinon.stub(console, 'error').value((error: string) => {
+      errors.push(error)
+    })
+    const consoleErrorSpy = sinon.spy(console, 'error')
+    const stream = new PassThrough()
+    const exitCode = await cli.run(
+      [`--current-working-directory=${workingDirectory}`],
+      {
+        stdin: process.stdin,
+        stdout: stream,
+        stderr: stream
+      }
+    )
+    stream.end()
+    assert.strictEqual(exitCode, 1)
+    assert.strictEqual(
+      consoleErrorSpy.calledWith(
+        chalk.bold.red('Error:') +
+          ` No config file found at ${configPath}. Please create "${CONFIG_FILE_NAME}".`
+      ),
+      true,
+      errors.join('\n')
+    )
+  })
+
+  await t.test('fails with invalid JSON config', async () => {
+    const workingDirectory = path.join(
+      FIXTURES_PATH,
+      'error-config-invalid-json'
+    )
+    const configPath = path.join(workingDirectory, CONFIG_FILE_NAME)
+    const errors: string[] = []
+    sinon.stub(console, 'error').value((error: string) => {
+      errors.push(error)
+    })
+    const consoleErrorSpy = sinon.spy(console, 'error')
+    const stream = new PassThrough()
+    const exitCode = await cli.run(
+      [`--current-working-directory=${workingDirectory}`],
+      {
+        stdin: process.stdin,
+        stdout: stream,
+        stderr: stream
+      }
+    )
+    stream.end()
+    assert.strictEqual(exitCode, 1)
+    assert.strictEqual(
+      consoleErrorSpy.calledWith(
+        chalk.bold.red('Error:') +
+          ` Invalid config file at "${configPath}". Please check the JSON syntax.`
+      ),
+      true,
+      errors.join('\n')
+    )
+  })
+
+  await t.test('fails with invalid URLs config', async () => {
+    const workingDirectory = path.join(
+      FIXTURES_PATH,
+      'error-config-invalid-urls'
+    )
+    const configPath = path.join(workingDirectory, CONFIG_FILE_NAME)
+    const errors: string[] = []
+    sinon.stub(console, 'error').value((error: string) => {
+      errors.push(error)
+    })
+    const consoleErrorSpy = sinon.spy(console, 'error')
+    const stream = new PassThrough()
+    const exitCode = await cli.run(
+      [`--current-working-directory=${workingDirectory}`],
+      {
+        stdin: process.stdin,
+        stdout: stream,
+        stderr: stream
+      }
+    )
+    stream.end()
+    assert.strictEqual(exitCode, 1)
+    assert.strictEqual(
+      consoleErrorSpy.calledWith(
+        chalk.bold.red('Error:') +
+          ` Invalid config file at "${configPath}". Please include an array of URLs.`
+      ),
+      true,
+      errors.join('\n')
+    )
+  })
+
+  await t.test('fails with invalid files config', async () => {
+    const workingDirectory = path.join(
+      FIXTURES_PATH,
+      'error-config-invalid-files'
+    )
+    const configPath = path.join(workingDirectory, CONFIG_FILE_NAME)
+    const errors: string[] = []
+    sinon.stub(console, 'error').value((error: string) => {
+      errors.push(error)
+    })
+    const consoleErrorSpy = sinon.spy(console, 'error')
+    const stream = new PassThrough()
+    const exitCode = await cli.run(
+      [`--current-working-directory=${workingDirectory}`],
+      {
+        stdin: process.stdin,
+        stdout: stream,
+        stderr: stream
+      }
+    )
+    stream.end()
+    assert.strictEqual(exitCode, 1)
+    assert.strictEqual(
+      consoleErrorSpy.calledWith(
+        chalk.bold.red('Error:') +
+          ` Invalid config file at "${configPath}". Please include an array of files.`
+      ),
+      true,
+      errors.join('\n')
+    )
+  })
+
+  await t.test('fails with invalid files and urls config', async () => {
+    const workingDirectory = path.join(
+      FIXTURES_PATH,
+      'error-config-invalid-files-and-urls'
+    )
+    const configPath = path.join(workingDirectory, CONFIG_FILE_NAME)
+    const errors: string[] = []
+    sinon.stub(console, 'error').value((error: string) => {
+      errors.push(error)
+    })
+    const consoleErrorSpy = sinon.spy(console, 'error')
+    const stream = new PassThrough()
+    const exitCode = await cli.run(
+      [`--current-working-directory=${workingDirectory}`],
+      {
+        stdin: process.stdin,
+        stdout: stream,
+        stderr: stream
+      }
+    )
+    stream.end()
+    assert.strictEqual(exitCode, 1)
+    assert.strictEqual(
+      consoleErrorSpy.calledWith(
+        chalk.bold.red('Error:') +
+          ` Invalid config file at "${configPath}". Please add URLs or files.`
+      ),
+      true,
+      errors.join('\n')
+    )
+  })
+
+  await t.test('fails with invalid severities config', async () => {
+    const workingDirectory = path.join(
+      FIXTURES_PATH,
+      'error-config-invalid-severities'
+    )
+    const configPath = path.join(workingDirectory, CONFIG_FILE_NAME)
+    const errors: string[] = []
+    sinon.stub(console, 'error').value((error: string) => {
+      errors.push(error)
+    })
+    const consoleErrorSpy = sinon.spy(console, 'error')
+    const stream = new PassThrough()
+    const exitCode = await cli.run(
+      [`--current-working-directory=${workingDirectory}`],
+      {
+        stdin: process.stdin,
+        stdout: stream,
+        stderr: stream
+      }
+    )
+    stream.end()
+    assert.strictEqual(exitCode, 1)
+    assert.strictEqual(
+      consoleErrorSpy.calledWith(
+        chalk.bold.red('Error:') +
+          ` Invalid config file at "${configPath}". Please add valid severities (${SEVERITIES.join(
+            ', '
+          )}).`
+      ),
+      true,
+      errors.join('\n')
+    )
+  })
+
+  await t.test('fails with invalid empty severities config', async () => {
+    const workingDirectory = path.join(
+      FIXTURES_PATH,
+      'error-config-invalid-severities-empty'
+    )
+    const configPath = path.join(workingDirectory, CONFIG_FILE_NAME)
+    const errors: string[] = []
+    sinon.stub(console, 'error').value((error: string) => {
+      errors.push(error)
+    })
+    const consoleErrorSpy = sinon.spy(console, 'error')
+    const stream = new PassThrough()
+    const exitCode = await cli.run(
+      [`--current-working-directory=${workingDirectory}`],
+      {
+        stdin: process.stdin,
+        stdout: stream,
+        stderr: stream
+      }
+    )
+    stream.end()
+    assert.strictEqual(exitCode, 1)
+    assert.strictEqual(
+      consoleErrorSpy.calledWith(
+        chalk.bold.red('Error:') +
+          ` Invalid config file at "${configPath}". Please add valid severities (${SEVERITIES.join(
+            ', '
+          )}).`
+      ),
+      true,
+      errors.join('\n')
+    )
+  })
+
+  await t.test('fails with invalid files paths to check', async () => {
+    const workingDirectory = path.join(
+      FIXTURES_PATH,
+      'error-invalid-files-paths-to-check'
+    )
+    const htmlPath = path.resolve(workingDirectory, 'index.html')
+    const errors: string[] = []
+    sinon.stub(console, 'error').value((error: string) => {
+      errors.push(error)
+    })
+    const consoleErrorSpy = sinon.spy(console, 'error')
+    const stream = new PassThrough()
+    const exitCode = await cli.run(
+      [`--current-working-directory=${workingDirectory}`],
+      {
+        stdin: process.stdin,
+        stdout: stream,
+        stderr: stream
+      }
+    )
+    stream.end()
+    assert.strictEqual(exitCode, 1)
+    const messagesTable = [
+      [`No file found at "${htmlPath}". Please check the path.`]
+    ]
+    assert.strictEqual(
+      consoleErrorSpy.calledWith(
+        chalk.bold.red('Error:') + ' HTML validation (W3C) failed!'
+      ),
+      true,
+      errors.join('\n')
+    )
+    assert.strictEqual(
+      consoleErrorSpy.calledWith(table(messagesTable)),
+      true,
+      errors.join('\n')
+    )
+  })
+
+  await t.test('fails with invalid W3C HTML', async () => {
+    const workingDirectory = path.join(FIXTURES_PATH, 'error-invalid-w3c-html')
+    const errors: string[] = []
+    sinon.stub(console, 'error').value((error: string) => {
+      errors.push(error)
+    })
+    const consoleErrorSpy = sinon.spy(console, 'error')
+    const stream = new PassThrough()
+    const exitCode = await cli.run(
+      [`--current-working-directory=${workingDirectory}`],
+      {
+        stdin: process.stdin,
+        stdout: stream,
+        stderr: stream
+      }
+    )
+    stream.end()
+    assert.strictEqual(exitCode, 1)
+    const messagesTable = [
+      [
+        chalk.yellow('warning'),
+        'Consider adding a “lang” attribute to the “html” start tag to declare the language of this document.',
+        'line: 2, column: 16-6'
+      ]
+    ]
+    assert.strictEqual(
+      consoleErrorSpy.calledWith(
+        chalk.bold.red('Error:') + ' HTML validation (W3C) failed!'
+      ),
+      true,
+      errors.join('\n')
+    )
+    assert.strictEqual(
+      consoleErrorSpy.calledWith(table(messagesTable)),
+      true,
+      errors.join('\n')
+    )
   })
 })

src/__test__/fixtures/error-config-invalid-files-and-urls/.html-w3c-validatorrc.json

@@ -0,0 +1,4 @@
+{
+  "urls": [],
+  "files": []
+}

src/__test__/fixtures/error-config-invalid-files/.html-w3c-validatorrc.json

@@ -0,0 +1,3 @@
+{
+  "files": "Invalid"
+}

src/__test__/fixtures/error-config-invalid-json/.html-w3c-validatorrc.json

@@ -0,0 +1 @@
+Invalid JSON

src/__test__/fixtures/error-config-invalid-severities-empty/.html-w3c-validatorrc.json

@@ -0,0 +1,4 @@
+{
+  "files": ["./index.html"],
+  "severities": []
+}

src/__test__/fixtures/error-config-invalid-severities-empty/index.html

@@ -0,0 +1,9 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Home</title>
+  </head>
+  <body></body>
+</html>

src/__test__/fixtures/error-config-invalid-severities/.html-w3c-validatorrc.json

@@ -0,0 +1,4 @@
+{
+  "files": ["./index.html"],
+  "severities": ["errors-invalid"]
+}

src/__test__/fixtures/error-config-invalid-severities/index.html

@@ -0,0 +1,9 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Home</title>
+  </head>
+  <body></body>
+</html>

src/__test__/fixtures/error-config-invalid-urls/.html-w3c-validatorrc.json

@@ -0,0 +1,3 @@
+{
+  "urls": "Invalid"
+}

src/__test__/fixtures/error-invalid-files-paths-to-check/.html-w3c-validatorrc.json

@@ -0,0 +1,3 @@
+{
+  "files": ["./index.html"]
+}

src/__test__/fixtures/error-invalid-w3c-html/.html-w3c-validatorrc.json

@@ -0,0 +1,3 @@
+{
+  "files": ["./build/index.html", "./build/about.html"]
+}

src/__test__/fixtures/error-invalid-w3c-html/build/about.html

@@ -0,0 +1,9 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>About</title>
+  </head>
+  <body></body>
+</html>

src/__test__/fixtures/error-invalid-w3c-html/build/index.html

@@ -0,0 +1,9 @@
+<!doctype html>
+<html>
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Home</title>
+  </head>
+  <body></body>
+</html>

src/__test__/fixtures/success/.html-w3c-validatorrc.json

@@ -0,0 +1,3 @@
+{
+  "files": ["./build/index.html", "./build/about.html"]
+}

src/__test__/fixtures/success/build/about.html

@@ -0,0 +1,9 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>About</title>
+  </head>
+  <body></body>
+</html>

src/__test__/fixtures/success/build/index.html

@@ -0,0 +1,9 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Home</title>
+  </head>
+  <body></body>
+</html>

src/utils/__test__/isExistingPath.test.ts

@@ -1,9 +1,11 @@
+import test from 'node:test'
+import assert from 'node:assert/strict'
+
 import fsMock from 'mock-fs'
-import tap from 'tap'
 
 import { isExistingPath } from '../isExistingPath.js'
 
-await tap.test('utils/isExistingPath', async (t) => {
+await test('utils/isExistingPath', async (t) => {
   t.afterEach(() => {
     fsMock.restore()
   })
@@ -12,13 +14,13 @@ await tap.test('utils/isExistingPath', async (t) => {
     fsMock({
       '/file.txt': ''
     })
-    t.equal(await isExistingPath('/file.txt'), true)
+    assert.strictEqual(await isExistingPath('/file.txt'), true)
   })
 
   await t.test("should return false if the file doesn't exists", async () => {
     fsMock({
       '/file.txt': ''
     })
-    t.equal(await isExistingPath('/randomfile.txt'), false)
+    assert.strictEqual(await isExistingPath('/randomfile.txt'), false)
   })
 })