watch-site.js

const chokidar = require('chokidar')
const bs = require('browser-sync').create()
const generator = require('@antora/site-generator')
const Lock = require('./lock.js')
const processorLock = new Lock()

const antoraArgs = ['--playbook', 'site.yml']

const watcher = chokidar.watch([
  `src/docs/**`,
], {
  ignored: [
    /(^|[\/\\])\../, // ignore dotfiles
  ],
  persistent: true,
  // avoid issues with Intellij IDEA temporary files (used to automatically save changes)
  // [Error: ENOENT: no such file or directory, lstat '/path/to/.../file.adoc~' in /path/to/... (ref: antora-local-dev <worktree> | path: modules/...)] {
  //   errno: -2,
  //   code: 'ENOENT',
  //   syscall: 'lstat',
  //   path: '/path/to/.../file.adoc~'
  // }
  awaitWriteFinish: {
    stabilityThreshold: 100,
    pollInterval: 50
  }
})

async function generate(_) {
  try {
    const hasQueuedEvents = await processorLock.acquire()
    if (!hasQueuedEvents) {
      await generator(antoraArgs, process.env)
      bs.reload({
        notify: false
      })
    }
  } catch (err) {
    console.error(err)
  } finally {
    processorLock.release()
  }
}

watcher.on('change', async e => await generate(e))
watcher.on('unlink', async e => await generate(e))

;(async () => {
  await generate()
  bs.init({
    notify: false,
    server: './public'
  })
})()