Add verbose option for more info

lib/file-set-pipeline/log.js

@@ -58,7 +58,8 @@ export async function log(context, settings) {
       ...settings.reporterOptions,
       color: settings.color,
       quiet: settings.quiet,
-      silent: settings.silent
+      silent: settings.silent,
+      verbose: settings.verbose
     }
   )
 

lib/index.js

@@ -142,6 +142,8 @@
  *   Whether to treat input as a syntax tree (default: `options.tree`).
  * @property {boolean | undefined} [treeOut]
  *   Whether to output as a syntax tree (default: `options.tree`).
+ * @property {boolean | undefined} [verbose=false]
+ *   Report extra info (default: `false`); given to the reporter.
  *
  * @typedef Settings
  *   Resolved {@link Options `Options`} passed around.
@@ -182,6 +184,7 @@
  * @property {Options['silent']} silent
  * @property {Options['quiet']} quiet
  * @property {Options['frail']} frail
+ * @property {Options['verbose']} verbose
  *
  * @callback VFileReporter
  *   Reporter.
@@ -368,6 +371,7 @@ export function engine(options, callback) {
   settings.silent = options.silent
   settings.quiet = options.quiet
   settings.frail = options.frail
+  settings.verbose = options.verbose
 
   // Process.
   fileSetPipeline.run({files: settings.files}, settings, next)

readme.md

@@ -370,6 +370,8 @@ Configuration (TypeScript type).
     — whether to treat input as a syntax tree
 *   `treeOut` (`boolean`, default: `options.tree`)
     — whether to output as a syntax tree
+*   `verbose` (`boolean`, default: `false`)
+    — report extra info; given to the reporter
 
 ### `Preset`
 

test/reporting.js

@@ -130,6 +130,44 @@ test('reporting', async function (t) {
     }
   )
 
+  await t.test('should report extra info w/ `verbose`', async function () {
+    const stderr = spy()
+
+    const code = await run({
+      cwd: new URL('one-file/', fixtures),
+      extensions: ['txt'],
+      files: ['.'],
+      processor: noop().use(
+        /** @type {import('unified').Plugin<[], Literal>} */
+        function () {
+          return function (_, file) {
+            const message = file.message('x')
+            message.url = 'https://example.com'
+            message.note = 'lorem ipsum'
+          }
+        }
+      ),
+      streamError: stderr.stream,
+      verbose: true
+    })
+
+    assert.equal(code, 0)
+    assert.equal(
+      stderr(),
+      [
+        'one.txt',
+        ' warning x',
+        '  [url]:',
+        '    https://example.com',
+        '  [note]:',
+        '    lorem ipsum',
+        '',
+        '⚠ 1 warning',
+        ''
+      ].join('\n')
+    )
+  })
+
   await t.test('should support custom given reporters', async function () {
     const stderr = spy()