@jti/adoc2typst2pdf 1.0.0

package/adoc2typst2pdf.js

@@ -0,0 +1,761 @@
+#!/usr/bin/env node
+
+/**
+ * adoc2typst2pdf.js
+ *
+ * Drop-in replacement for asciidoctor-pdf using the pipeline:
+ *   asciidoctor -b docbook → docbook2typst.js → typst compile
+ *
+ * Usage:
+ *   node adoc2typst2pdf.js [options] <input.adoc>
+ *
+ * Recognized options (all others are silently ignored, so this can replace
+ * asciidoctor-pdf on existing command lines):
+ *   -a name[=value]   AsciiDoc attribute definition (repeatable)
+ *   -o <file>         Output PDF path (default: <input>.pdf)
+ */
+
+'use strict';
+
+const { spawn, execFileSync } = require('child_process')
+const fs   = require('fs')
+const path = require('path')
+
+const VERSION = '1.0.0'
+
+
+// ── 1. Parse CLI arguments ────────────────────────────────────────────────────
+
+const argv = process.argv.slice(2)
+
+if (argv.includes('--version')) {
+  console.log(VERSION)
+  process.exit(0)
+}
+
+if (argv.length === 0 || argv.includes('--help') || argv.includes('-h')) {
+  console.log(`
+Usage: node adoc2typst2pdf.js [options] <input.adoc|->
+
+Converts an AsciiDoc file to PDF using the pipeline:
+  asciidoctor -b docbook  →  docbook2typst.js  →  typst compile
+
+Requires asciidoctor and typst.
+Pass - as the input file to read AsciiDoc from stdin (-o is required in that case).
+
+Options:
+  -a name[=value]        AsciiDoc attribute definition (passed through to
+                         asciidoctor; may be repeated)
+  -d, --doctype <type>   Set the document type (passed through to asciidoctor)
+  -n, --section-numbers  Auto-number section titles (passed through to asciidoctor)
+  -o <file>              Output PDF path (required when reading from stdin;
+                         default for file input: <input-dir>/<component>-<date>.pdf)
+  -S, --safe-mode <lvl>  Set safe mode: unsafe, safe, server, secure
+                         (passed through to asciidoctor)
+      --safe             Set safe mode to "safe" (passed through to asciidoctor)
+  -t, --typst-template <file>
+                         Path to a Typst preamble file.  When provided, the
+                         generated .typ file is prefixed with an import of
+                         this file and title/subtitle are passed to typst via
+                         --input.  When omitted, no preamble is added.
+  -v, --verbose          Show full command lines for each pipeline step
+      --version          Print the version and exit
+  -h, --help             Show this help and exit
+`)
+  process.exit(0)
+}
+
+// Flags that take a following argument but whose value we don't need.
+const SKIP_VALUE_FLAGS = new Set([
+  '-D', '--destination-dir',
+  '-B', '--base-dir',
+  '-T', '--template-dir',
+  '-E', '--template-engine',
+  '--failure-level',
+  '--log-level',
+  '-I', '--load-path',
+  '--theme', '--pdf-theme'
+])
+
+const attributes    = []  // collected -a / --attribute entries
+const safeArgs      = []  // collected --safe / --safe-mode / -S entries
+const requireArgs   = []  // collected --require / -r entries
+let sectionNumbers  = false
+let doctype         = null
+let typstTemplate   = null
+let verbose         = false
+let inputFile       = null
+let outputFile      = null
+
+// Process CLI parameters.
+for (let i = 0; i < argv.length; i++) {
+  const arg = argv[i]
+
+  // -a name[=value]
+  if (arg === '-a' || arg === '--attribute') {
+    const val = argv[++i]
+    if (val !== undefined) attributes.push(val)
+    continue
+  }
+  if (arg.startsWith('-a') && arg.length > 2) {
+    attributes.push(arg.slice(2))
+    continue
+  }
+  if (arg.startsWith('--attribute=')) {
+    attributes.push(arg.slice('--attribute='.length))
+    continue
+  }
+
+  // -d / --doctype <type>
+  if (arg === '-d' || arg === '--doctype') {
+    const val = argv[++i]
+    if (val !== undefined) doctype = val
+    continue
+  }
+  if (arg.startsWith('--doctype=')) {
+    doctype = arg.slice('--doctype='.length)
+    continue
+  }
+
+  // -n / --section-numbers (boolean flag)
+  if (arg === '-n' || arg === '--section-numbers') {
+    sectionNumbers = true
+    continue
+  }
+
+  // --require (string)
+  if (arg === '--require' || arg === '-r') {
+    const val = argv[++i]
+    if (val !== undefined) requireArgs.push('-r', val)
+    continue
+  }
+
+  // --safe (boolean flag)
+  if (arg === '--safe') {
+    safeArgs.push('--safe')
+    continue
+  }
+  // --safe-mode <level> / -S <level>
+  if (arg === '--safe-mode' || arg === '-S') {
+    const val = argv[++i]
+    if (val !== undefined) safeArgs.push('--safe-mode', val)
+    continue
+  }
+  if (arg.startsWith('--safe-mode=')) {
+    safeArgs.push(arg)
+    continue
+  }
+
+  // -t / --typst-template <file>
+  if (arg === '-t' || arg === '--typst-template') {
+    const val = argv[++i]
+    if (val !== undefined) typstTemplate = val
+    continue
+  }
+  if (arg.startsWith('--typst-template=')) {
+    typstTemplate = arg.slice('--typst-template='.length)
+    continue
+  }
+
+  // -v / --verbose
+  if (arg === '-v' || arg === '--verbose') {
+    verbose = true
+    continue
+  }
+
+  // -o / --out-file
+  if (arg === '-o' || arg === '--out-file') {
+    outputFile = argv[++i]
+    continue
+  }
+  if (arg.startsWith('--out-file=')) {
+    outputFile = arg.slice('--out-file='.length)
+    continue
+  }
+
+  // flags whose value we skip
+  if (SKIP_VALUE_FLAGS.has(arg)) {
+    i++   // consume the next token
+    continue
+  }
+  // long --flag=value forms that we skip
+  if (arg.startsWith('--') && arg.includes('=')) {
+    continue
+  }
+  // '-' on its own means read from stdin — treat as a positional
+  if (arg === '-') {
+    inputFile = arg
+    continue
+  }
+
+  // other short/long flags with no value
+  if (arg.startsWith('-')) {
+    continue
+  }
+
+  // positional argument → the AsciiDoc input file
+  inputFile = arg
+}
+
+if (!inputFile) {
+  console.error('Error: no input file specified.')
+  console.error('Run with --help for usage information.')
+  process.exit(1)
+}
+
+const stdinMode = inputFile === '-'
+
+if (stdinMode && !outputFile) {
+  console.error('Error: -o <file> is required when reading from stdin.')
+  process.exit(1)
+}
+
+if (stdinMode) {
+  const adocFile = path.join(
+    path.dirname(outputFile),
+    path.basename(outputFile, path.extname(outputFile)) + '.adoc'
+  )
+  fs.writeFileSync(adocFile, fs.readFileSync(0, 'utf-8'), 'utf-8')
+  inputFile = adocFile
+} else if (!fs.existsSync(inputFile)) {
+  console.error(`Error: input file not found: ${inputFile}`)
+  process.exit(1)
+}
+
+
+// ── Derive Antora component title ─────────────────────────────────────────────
+
+// Walk upward from `startDir` looking for an antora.yml that declares a `title`.
+function findAntoraTitle(startDir) {
+  let dir = path.resolve(startDir)
+  while (true) {
+    const candidate = path.join(dir, 'antora.yml')
+    if (fs.existsSync(candidate)) {
+      // Match: title: "quoted value"  |  title: 'quoted value'  |  title: bare value
+      const m = fs.readFileSync(candidate, 'utf-8')
+        .match(/^title:\s*(?:"([^"]*?)"|'([^']*?)'|(.*?))\s*$/m)
+      if (m) {
+        const title = (m[1] ?? m[2] ?? m[3] ?? '').trim()
+        if (title) return title
+      }
+    }
+    const parent = path.dirname(dir)
+    if (parent === dir) break  // reached filesystem root
+    dir = parent
+  }
+  return null
+}
+
+// Convert a title string to a filename-safe slug:
+//   spaces → underscores, strip punctuation, collapse runs of underscores.
+function titleToSlug(title) {
+  return title
+    .replace(/\s+/g, '_')   // spaces → underscores
+    .replace(/[^\w]/g, '')  // remove anything not a word char (a-z, A-Z, 0-9, _)
+    .replace(/_+/g, '_')    // collapse consecutive underscores
+    .replace(/^_|_$/g, '')  // strip leading/trailing underscores
+}
+
+const componentTitle =
+  findAntoraTitle(stdinMode ? process.cwd() : path.dirname(path.resolve(inputFile))) ||
+  findAntoraTitle(path.join(__dirname, 'docs')) ||
+  'document'
+
+const componentName = titleToSlug(componentTitle)
+
+
+// ── Derive intermediate and final paths ───────────────────────────────────────
+
+const today   = new Date()
+const year    = today.getFullYear()
+const month   = today.getMonth() + 1
+const day     = today.getDate()
+const dateStr = `${year}-${String(month).padStart(2, '0')}-${String(day).padStart(2, '0')}`
+
+const inputBase = inputFile.replace(/\.(adoc|asciidoc|asc)$/i, '')
+const xmlFile   = inputBase + '.xml'
+const typFile   = inputBase + '.typ'
+const pdfFile   = outputFile ||
+  path.join(process.cwd(), `${componentName}-${dateStr}.pdf`)
+
+
+// ── 2. Check tool availability ────────────────────────────────────────────────
+
+function toolExists(name) {
+  try {
+    execFileSync('which', [name], { stdio: 'ignore' })
+    return true
+  } catch {
+    return false
+  }
+}
+
+const missing = ['asciidoctor'].filter(t => !toolExists(t))
+if (missing.length > 0) {
+  console.error(
+    `Error: the following required tools are not on your PATH: ${missing.join(', ')}`
+  )
+  console.error('Please install them before running this script.')
+  process.exit(1)
+}
+
+// ── Helpers ───────────────────────────────────────────────────────────────────
+
+// Return p as a path relative to cwd; if p is not absolute, resolve it first.
+function relPath(p) {
+  return path.relative(process.cwd(), path.resolve(p)) || p
+}
+
+// For verbose display: only convert absolute paths, leave flags/values as-is.
+function relIfAbs(s) {
+  return path.isAbsolute(s) ? relPath(s) : s
+}
+
+function extractTitle(adocPath) {
+  try {
+    const lines = fs.readFileSync(adocPath, 'utf-8').split('\n')
+    for (const line of lines) {
+      const m = line.match(/^=\s+(.+)/)
+      if (m) return m[1].trim()
+    }
+  } catch { /* fall through */ }
+  return path.basename(adocPath, path.extname(adocPath))
+}
+
+
+// ── Timing ────────────────────────────────────────────────────────────────────
+
+const t0 = performance.now()
+
+function fmtElapsed() {
+  const ms = performance.now() - t0
+  const s  = ms / 1000
+  if (s < 60) return `${s.toFixed(2)}s`
+
+  const m    = Math.floor(s / 60)
+  const sRem = (s % 60).toFixed(2).padStart(5, '0')
+  return `${m}:${sRem}s`
+}
+
+// ── Command runner ─────────────────────────────────────────────────────────────
+
+async function run(phase, cmd, args) {
+  const phaseStart = performance.now()
+  if (verbose) {
+    const display = cmd === process.execPath ? 'node' : cmd
+    console.log(`\n→ ${display} ${args.map(relIfAbs).join(' ')}`)
+  }
+  setPhase(phase)
+
+  return new Promise((resolve, reject) => {
+    // In non-verbose mode suppress child stdout/stderr so they don't tear
+    // the spinner; capture stderr to surface on failure.
+    const stdio = verbose ? 'inherit' : ['ignore', 'ignore', 'pipe']
+    const proc  = spawn(cmd, args, { stdio })
+
+    let stderr = ''
+    if (proc.stderr) proc.stderr.on('data', d => { stderr += d })
+
+    proc.on('close', code => {
+      if (verbose) {
+        const ms = performance.now() - phaseStart
+        console.log(`Elapsed: ${(ms / 1000).toFixed(2)} secs`)
+      }
+      if (code !== 0) {
+        if (stderr) process.stderr.write(stderr)
+        const cmdLabel = cmd === process.execPath ? 'docbook2typst converter' : cmd
+        reject(new Error(`${cmdLabel} exited with an error.`))
+      } else {
+        resolve()
+      }
+    })
+    proc.on('error', reject)
+  })
+}
+
+
+// ── Setup: symlinks and build args ────────────────────────────────────────────
+
+const typstRoot  = path.dirname(path.dirname(path.resolve(pdfFile)))
+const fontRoot   = typstTemplate
+  ? path.join(path.dirname(path.resolve(typstTemplate)), 'fonts')
+  : null
+
+// Create a symlink idempotently. EEXIST is silently ignored so concurrent
+// invocations don't race; the symlinks are stable build artifacts and are
+// intentionally left in place after the process exits.
+function ensureSymlink(target, linkPath, type) {
+  try {
+    fs.symlinkSync(target, linkPath, type)
+  } catch (err) {
+    if (err.code !== 'EEXIST') throw err
+  }
+}
+
+ensureSymlink(path.join(__dirname, 'typst'), path.join(typstRoot, 'typst'), 'dir')
+
+const componentFolder = path.relative(typstRoot, outputFile).split(path.sep)[0]
+const imageSymlinkDir  = path.join(typstRoot, componentFolder)
+fs.mkdirSync(imageSymlinkDir, { recursive: true })
+ensureSymlink(path.join('..', componentFolder), path.join(imageSymlinkDir, componentFolder), 'dir')
+
+
+// ── Concurrent progress display ───────────────────────────────────────────────
+//
+// Multiple concurrent invocations each own one line in a shared "progress
+// block" at the bottom of the terminal.  A file-based lock serialises all
+// writes; each writer moves the cursor up to its line, rewrites it, then
+// moves the cursor back down so the next writer finds the anchor in the
+// expected position.
+
+const isTTY       = Boolean(process.stdout.isTTY)
+const progressDir = path.join(typstRoot, '.progress')
+const lockFile    = path.join(progressDir, 'lock')
+const totalFile   = path.join(progressDir, 'total')
+
+fs.mkdirSync(progressDir, { recursive: true })
+cleanStaleSlots()
+
+// Remove slot files whose owning process is no longer alive.  When no live
+// peers remain, reset the line counter so the next batch starts a fresh block.
+function cleanStaleSlots() {
+  // Clear a stale TTY lock left by a crashed process.
+  try {
+    const lockPid = parseInt(fs.readFileSync(lockFile, 'utf-8').trim(), 10)
+    if (Number.isFinite(lockPid)) {
+      try { process.kill(lockPid, 0) }
+      catch (e) { if (e.code === 'ESRCH') try { fs.unlinkSync(lockFile) } catch {} }
+    }
+  } catch {}
+
+  let hasLive = false
+  let files
+  try { files = fs.readdirSync(progressDir) }
+  catch { return }
+
+  for (const f of files) {
+    if (!f.startsWith('slot-')) continue
+    const slotFile = path.join(progressDir, f)
+    try {
+      const pid = parseInt(fs.readFileSync(slotFile, 'utf-8').trim(), 10)
+      if (!Number.isFinite(pid)) {
+        try { fs.unlinkSync(slotFile) }
+        catch {} continue
+      }
+      process.kill(pid, 0)   // throws ESRCH if dead
+      hasLive = true
+    } catch (e) {
+      if (e.code === 'ESRCH') try { fs.unlinkSync(slotFile) } catch {}
+      else hasLive = true    // EPERM → process exists but belongs to another user
+    }
+  }
+  if (!hasLive) try { fs.writeFileSync(totalFile, '0', 'utf-8') } catch {}
+}
+
+// Spin-acquire the file-based TTY write lock (held only for the duration of
+// a single terminal write, so contention is brief).
+function acquireTTYLock() {
+  const deadline = Date.now() + 5000
+  while (Date.now() < deadline) {
+    try {
+      fs.writeFileSync(lockFile, String(process.pid), { flag: 'wx' })
+      return
+    } catch (e) {
+      if (e.code !== 'EEXIST') throw e
+      const t = Date.now() + 1
+      while (Date.now() < t) {}   // 1 ms busy-wait
+    }
+  }
+  fs.writeFileSync(lockFile, String(process.pid))  // stale lock: forcibly claim
+}
+
+function releaseTTYLock() {
+  try { fs.unlinkSync(lockFile) }
+  catch {}
+}
+
+function readTotal() {
+  try { return parseInt(fs.readFileSync(totalFile, 'utf-8'), 10) || 0 }
+  catch { return 0 }
+}
+
+// Claim the lowest available slot index (one per concurrent invocation).
+let mySlot = -1
+function claimSlot() {
+  for (let n = 0; ; n++) {
+    try {
+      fs.writeFileSync(path.join(progressDir, `slot-${n}`), String(process.pid), { flag: 'wx' })
+      mySlot = n
+      return
+    } catch (e) {
+      if (e.code !== 'EEXIST') throw e
+    }
+  }
+}
+
+function releaseSlot() {
+  if (mySlot < 0) return
+  try { fs.unlinkSync(path.join(progressDir, `slot-${mySlot}`)) }
+  catch {}
+
+  mySlot = -1
+  // If no slots remain, we are the last invocation: remove build symlinks so
+  // subsequent tools (e.g. htmltest) don't follow them into a loop.
+  try {
+    if (fs.readdirSync(progressDir).every(f => !f.startsWith('slot-'))) {
+      cleanupSymlinks()
+    }
+  }
+  catch {}
+}
+
+function cleanupSymlinks() {
+  // Shared typst theme symlink.
+  try {
+    fs.unlinkSync(path.join(typstRoot, 'typst'))
+  }
+  catch {}
+
+  // Per-component image symlinks: each lives at typstRoot/<dir>/<dir>.
+  try {
+    for (const entry of fs.readdirSync(typstRoot, { withFileTypes: true })) {
+      if (!entry.isDirectory() || entry.name.startsWith('.')) continue
+      const link = path.join(typstRoot, entry.name, entry.name)
+      try {
+        if (fs.lstatSync(link).isSymbolicLink()) fs.unlinkSync(link)
+      }
+      catch {}
+    }
+  }
+  catch {}
+}
+
+// Write the initial two-line block for this invocation (header + spinner),
+// claiming the next two rows in the shared progress block.  myLineIndex is
+// set to the spinner line so that updateProgressLine targets it correctly.
+let myLineIndex = -1
+function initProgressLine(header, spinner) {
+  acquireTTYLock()
+  try {
+    const T = readTotal()
+    myLineIndex = T + 1   // spinner is the second of the two lines
+    process.stdout.write(`${header}\n${spinner}\n`)
+    fs.writeFileSync(totalFile, String(T + 2), 'utf-8')
+  } finally {
+    releaseTTYLock()
+  }
+}
+
+// Overwrite this invocation's line in-place.  The cursor is left at the
+// bottom of the progress block (base + totalLines) after every locked write,
+// so the distance from cursor to our line is always (total − myLineIndex).
+function updateProgressLine(text) {
+  if (myLineIndex < 0) return
+  acquireTTYLock()
+  try {
+    const dist = readTotal() - myLineIndex
+    process.stdout.write(`\x1b[${dist}A\r\x1b[2K${text}\x1b[${dist}B\r`)
+  }
+  finally {
+    releaseTTYLock()
+  }
+}
+
+// ── Spinner state ─────────────────────────────────────────────────────────────
+
+// Select spinners from the cli-spinners package.
+const spinners = {
+  "dots": [ "⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏" ],
+  "dots2": [ "⣾", "⣽", "⣻", "⢿", "⡿", "⣟", "⣯", "⣷" ],
+  "dots3": [ "⠋", "⠙", "⠚", "⠞", "⠖", "⠦", "⠴", "⠲", "⠳", "⠓" ],
+  "dots4": [ "⠄", "⠆", "⠇", "⠋", "⠙", "⠸", "⠰", "⠠", "⠰", "⠸", "⠙", "⠋", "⠇", "⠆" ],
+  "dots5": [ "⠋", "⠙", "⠚", "⠒", "⠂", "⠂", "⠒", "⠲", "⠴", "⠦", "⠖", "⠒", "⠐", "⠐", "⠒", "⠓", "⠋" ],
+  "dots6": [ "⠁", "⠉", "⠙", "⠚", "⠒", "⠂", "⠂", "⠒", "⠲", "⠴", "⠤", "⠄", "⠄", "⠤", "⠴", "⠲", "⠒", "⠂", "⠂", "⠒", "⠚", "⠙", "⠉", "⠁" ],
+  "dots7": [ "⠈", "⠉", "⠋", "⠓", "⠒", "⠐", "⠐", "⠒", "⠖", "⠦", "⠤", "⠠", "⠠", "⠤", "⠦", "⠖", "⠒", "⠐", "⠐", "⠒", "⠓", "⠋", "⠉", "⠈" ],
+  "dots8": [ "⠁", "⠁", "⠉", "⠙", "⠚", "⠒", "⠂", "⠂", "⠒", "⠲", "⠴", "⠤", "⠄", "⠄", "⠤", "⠠", "⠠", "⠤", "⠦", "⠖", "⠒", "⠐", "⠐", "⠒", "⠓", "⠋", "⠉", "⠈", "⠈" ],
+  "dots9": [ "⢹", "⢺", "⢼", "⣸", "⣇", "⡧", "⡗", "⡏" ],
+  "dots10": [ "⢄", "⢂", "⢁", "⡁", "⡈", "⡐", "⡠" ],
+  "dots11": [ "⠁", "⠂", "⠄", "⡀", "⢀", "⠠", "⠐", "⠈" ],
+  "dots12": [ "⢀⠀", "⡀⠀", "⠄⠀", "⢂⠀", "⡂⠀", "⠅⠀", "⢃⠀", "⡃⠀", "⠍⠀", "⢋⠀", "⡋⠀", "⠍⠁", "⢋⠁", "⡋⠁", "⠍⠉", "⠋⠉", "⠋⠉", "⠉⠙", "⠉⠙", "⠉⠩", "⠈⢙", "⠈⡙", "⢈⠩", "⡀⢙", "⠄⡙", "⢂⠩", "⡂⢘", "⠅⡘", "⢃⠨", "⡃⢐", "⠍⡐", "⢋⠠", "⡋⢀", "⠍⡁", "⢋⠁", "⡋⠁", "⠍⠉", "⠋⠉", "⠋⠉", "⠉⠙", "⠉⠙", "⠉⠩", "⠈⢙", "⠈⡙", "⠈⠩", "⠀⢙", "⠀⡙", "⠀⠩", "⠀⢘", "⠀⡘", "⠀⠨", "⠀⢐", "⠀⡐", "⠀⠠", "⠀⢀", "⠀⡀" ],
+  "dots13": [ "⣼", "⣹", "⢻", "⠿", "⡟", "⣏", "⣧", "⣶" ],
+  "dots14": [ "⠉⠉", "⠈⠙", "⠀⠹", "⠀⢸", "⠀⣰", "⢀⣠", "⣀⣀", "⣄⡀", "⣆⠀", "⡇⠀", "⠏⠀", "⠋⠁" ],
+  "dots8Bit": [ "⠀", "⠁", "⠂", "⠃", "⠄", "⠅", "⠆", "⠇", "⡀", "⡁", "⡂", "⡃", "⡄", "⡅", "⡆", "⡇", "⠈", "⠉", "⠊", "⠋", "⠌", "⠍", "⠎", "⠏", "⡈", "⡉", "⡊", "⡋", "⡌", "⡍", "⡎", "⡏", "⠐", "⠑", "⠒", "⠓", "⠔", "⠕", "⠖", "⠗", "⡐", "⡑", "⡒", "⡓", "⡔", "⡕", "⡖", "⡗", "⠘", "⠙", "⠚", "⠛", "⠜", "⠝", "⠞", "⠟", "⡘", "⡙", "⡚", "⡛", "⡜", "⡝", "⡞", "⡟", "⠠", "⠡", "⠢", "⠣", "⠤", "⠥", "⠦", "⠧", "⡠", "⡡", "⡢", "⡣", "⡤", "⡥", "⡦", "⡧", "⠨", "⠩", "⠪", "⠫", "⠬", "⠭", "⠮", "⠯", "⡨", "⡩", "⡪", "⡫", "⡬", "⡭", "⡮", "⡯", "⠰", "⠱", "⠲", "⠳", "⠴", "⠵", "⠶", "⠷", "⡰", "⡱", "⡲", "⡳", "⡴", "⡵", "⡶", "⡷", "⠸", "⠹", "⠺", "⠻", "⠼", "⠽", "⠾", "⠿", "⡸", "⡹", "⡺", "⡻", "⡼", "⡽", "⡾", "⡿", "⢀", "⢁", "⢂", "⢃", "⢄", "⢅", "⢆", "⢇", "⣀", "⣁", "⣂", "⣃", "⣄", "⣅", "⣆", "⣇", "⢈", "⢉", "⢊", "⢋", "⢌", "⢍", "⢎", "⢏", "⣈", "⣉", "⣊", "⣋", "⣌", "⣍", "⣎", "⣏", "⢐", "⢑", "⢒", "⢓", "⢔", "⢕", "⢖", "⢗", "⣐", "⣑", "⣒", "⣓", "⣔", "⣕", "⣖", "⣗", "⢘", "⢙", "⢚", "⢛", "⢜", "⢝", "⢞", "⢟", "⣘", "⣙", "⣚", "⣛", "⣜", "⣝", "⣞", "⣟", "⢠", "⢡", "⢢", "⢣", "⢤", "⢥", "⢦", "⢧", "⣠", "⣡", "⣢", "⣣", "⣤", "⣥", "⣦", "⣧", "⢨", "⢩", "⢪", "⢫", "⢬", "⢭", "⢮", "⢯", "⣨", "⣩", "⣪", "⣫", "⣬", "⣭", "⣮", "⣯", "⢰", "⢱", "⢲", "⢳", "⢴", "⢵", "⢶", "⢷", "⣰", "⣱", "⣲", "⣳", "⣴", "⣵", "⣶", "⣷", "⢸", "⢹", "⢺", "⢻", "⢼", "⢽", "⢾", "⢿", "⣸", "⣹", "⣺", "⣻", "⣼", "⣽", "⣾", "⣿" ],
+  "dotsCircle": [ "⢎ ", "⠎⠁", "⠊⠑", "⠈⠱", " ⡱", "⢀⡰", "⢄⡠", "⢆⡀" ],
+  "sand": [ "⠁", "⠂", "⠄", "⡀", "⡈", "⡐", "⡠", "⣀", "⣁", "⣂", "⣄", "⣌", "⣔", "⣤", "⣥", "⣦", "⣮", "⣶", "⣷", "⣿", "⡿", "⠿", "⢟", "⠟", "⡛", "⠛", "⠫", "⢋", "⠋", "⠍", "⡉", "⠉", "⠑", "⠡", "⢁" ],
+  "line": [ "-", "\\", "|", "/" ],
+  "line2": [ "⠂", "-", "–", "—", "–", "-" ],
+  "rollingLine": [ "/  ", " - ", " \\ ", "  |", "  |", " \\ ", " - ", "/  " ],
+  "pipe": [ "┤", "┘", "┴", "└", "├", "┌", "┬", "┐" ],
+  "simpleDots": [ ".  ", ".. ", "...", "   " ],
+  "simpleDotsScrolling": [ ".  ", ".. ", "...", " ..", "  .", "   " ],
+  "star": [ "✶", "✸", "✹", "✺", "✹", "✷" ],
+  "star2": [ "+", "x", "*" ],
+  "flip": [ "_", "_", "_", "-", "`", "`", "'", "´", "-", "_", "_", "_" ],
+  "hamburger": [ "☱", "☲", "☴" ],
+  "growVertical": [ "▁", "▃", "▄", "▅", "▆", "▇", "▆", "▅", "▄", "▃" ],
+  "growHorizontal": [ "▏", "▎", "▍", "▌", "▋", "▊", "▉", "▊", "▋", "▌", "▍", "▎" ],
+  "balloon": [ " ", ".", "o", "O", "@", "*", " " ],
+  "balloon2": [ ".", "o", "O", "°", "O", "o", "." ],
+  "noise": [ "▓", "▒", "░" ],
+  "bounce": [ "⠁", "⠂", "⠄", "⠂" ]
+}
+
+const SPINNER_CHARS  = spinners['dots']
+let spinFrame        = 0
+let spinTimer        = null
+let phaseMsg         = ''
+const progressLabel  = `[${componentName}]`
+
+function fmtLine(ch) {
+  return `  ${ch} ${fmtElapsed()} ${phaseMsg}`
+  // return `  ${ch} ${fmtElapsed()} ${progressLabel} ${phaseMsg}`
+}
+
+function tickSpinner() {
+  if (!isTTY) return
+  updateProgressLine(fmtLine(SPINNER_CHARS[spinFrame++ % SPINNER_CHARS.length]))
+}
+
+function setPhase(msg) {
+  phaseMsg = msg
+  if (!verbose) tickSpinner()
+}
+
+function endProgress() {
+  if (spinTimer) {
+    clearInterval(spinTimer)
+    spinTimer = null
+  }
+  if (!verbose && isTTY) {
+    updateProgressLine(`  ✓ ${fmtElapsed()} Done.`)
+    // updateProgressLine(`  ✓ ${fmtElapsed()} ${progressLabel} Done.`)
+  } else if (!verbose) {
+    process.stdout.write(`  ✓ ${fmtElapsed()} Done.\n`)
+  }
+}
+
+process.on('exit', releaseSlot)
+
+const asciidoctorArgs = [
+  '-b', 'docbook',
+  '-a', 'experimental',
+  '-o', xmlFile,
+  ...requireArgs,
+  ...safeArgs,
+  ...(sectionNumbers ? ['-n'] : []),
+  ...(doctype ? ['-d', doctype] : []),
+  ...attributes.flatMap(a => ['-a', a]),
+  inputFile,
+]
+
+const converterArgs   = [
+  'docbook2typst',
+  '-o', typFile,
+  ...(typstTemplate ? [] : ['--no-theme']),
+  xmlFile,
+]
+
+const typstBaseArgs = [
+  'typst',
+  'compile',
+  '--root', typstRoot,
+  '--pdf-standard', '2.0',
+  ...(fontRoot ? ['--font-path', fontRoot, '--ignore-system-fonts'] : []),
+]
+
+
+// ── 3–6. Pipeline ─────────────────────────────────────────────────────────────
+
+(async () => {
+  claimSlot()
+  if (verbose) {
+    console.log(`Generating PDF: ${relPath(pdfFile)}`)
+  } else if (isTTY) {
+    initProgressLine(`Generating PDF: ${path.basename(pdfFile)}`, fmtLine(SPINNER_CHARS[0]))
+    spinTimer = setInterval(tickSpinner, 80)
+  } else {
+    process.stdout.write(`Generating PDF: ${relPath(pdfFile)}\n`)
+  }
+
+  try {
+    await run('Running asciidoctor...', 'asciidoctor', asciidoctorArgs)
+
+    // Postprocess DocBook XML: the Assembler titles each assembled file as
+    // "Component Name: Page Title", which Asciidoctor splits into <title> and
+    // <subtitle> on the <book><info> block.  The first content section becomes
+    // a <preface> whose <title> is left empty.  Copy the subtitle into it so
+    // the first entry in the PDF table of contents has a visible title.
+    // Also capture the title and subtitle for passing to Typst via --input.
+    // The XML <info><title> holds the clean component title; the assembled
+    // AsciiDoc heading combines both as "Title: Subtitle", so reading from
+    // the XML avoids duplicating the subtitle on the cover page.
+    let xmlTitle = ''
+    let subtitle = ''
+    {
+      let xml = fs.readFileSync(xmlFile, 'utf-8')
+      const info = xml.match(/<info>([\s\S]*?)<\/info>/)
+      if (info) {
+        const mTitle = info[1].match(/<title>([^<]*)<\/title>/)
+        if (mTitle) xmlTitle = mTitle[1].trim()
+        const mSub = info[1].match(/<subtitle>([^<]*)<\/subtitle>/)
+        if (mSub) subtitle = mSub[1].trim()
+      }
+      if (subtitle) {
+        xml = xml.replace(
+          /(<preface(?:\s[^>]*)?>)([ \t\n]*)<title>([ \t\n]*)<\/title>/,
+          (_, tag, ws) => `${tag}${ws}<title>${subtitle}</title>`
+        )
+        fs.writeFileSync(xmlFile, xml, 'utf-8')
+      }
+    }
+
+    await run('Converting to Docbook...', 'npx', converterArgs)
+
+    // Prepend Typst preamble import; title/subtitle are passed via --input.
+    // When no template is specified the generated .typ is compiled as-is.
+    const typstInputArgs = []
+    if (typstTemplate) {
+      const preamble = fs.readFileSync(path.resolve(typstTemplate), 'utf-8').trimEnd()
+        + '\n#show: book-setup\n'
+      fs.writeFileSync(typFile, preamble + fs.readFileSync(typFile, 'utf-8'), 'utf-8')
+      if (verbose) console.log(`\n→ Prepended Typst preamble to ${relPath(typFile)}`)
+
+      const title = xmlTitle || extractTitle(inputFile)
+      typstInputArgs.push('--input', `title=${title}`, '--input', `subtitle=${subtitle}`)
+    } else {
+      // No theme — emit a bare document-title directive so PDF/UA-1 is satisfied.
+      const title = xmlTitle || extractTitle(inputFile)
+      const docTitle = subtitle ? `${title}: ${subtitle}` : title
+      const header = `#set document(title: [${docTitle}])\n`
+      fs.writeFileSync(typFile, header + fs.readFileSync(typFile, 'utf-8'), 'utf-8')
+    }
+
+    // FIXME
+    await run('Running Typst...', 'npx', [
+      'typst',
+      ...typstBaseArgs,
+      ...typstInputArgs,
+      typFile,
+      pdfFile,
+    ])
+
+    endProgress()
+
+    if (verbose) console.log(`\nDone. PDF written to: ${relPath(pdfFile)}`)
+
+    // Typst files are intentionally preserved for inspection.
+  } catch (err) {
+    if (spinTimer) {
+      clearInterval(spinTimer)
+      spinTimer = null
+    }
+    if (!verbose && isTTY) {
+      updateProgressLine(`  ✗ ${fmtElapsed()} Error.`)
+      // updateProgressLine(`  ✗ ${fmtElapsed()} ${progressLabel} Error.`)
+    } else if (!verbose) {
+      process.stdout.write('\n')
+    }
+    console.error(err.message)
+    process.exit(1)
+  }
+})()