specpress/lib/cli/export-docx.js

Export PDF and/or DOCX files from a subset of Markdown, ASN.1 and JSON files

#!/usr/bin/env node
/**
 * CLI wrapper for MarkdownToDocxConverter.
 *
 * Usage:
 *   node cli/export-docx.js <inputDir> <outputFile> [--spec-root <dir>] [--mermaid-config <file>]
 *
 * Options:
 *   --spec-root <dir>        Specification root for section numbering (enables x-placeholder resolution).
 *   --mermaid-config <file>  Path to a mermaid configuration JSON file.
 *
 * When --spec-root is provided, section numbers are derived from the folder/file
 * hierarchy and x-placeholders in headings and captions are resolved.
 *
 * Mermaid diagrams are rendered via a headless Chromium browser (Chrome or Edge
 * must be installed). This is the fallback path used when VS Code is not available.
 */
const fs = require('fs')
const path = require('path')
const { MarkdownToDocxConverter } = require('../md2docx/md2docx')
const { buildFrontPageDocx } = require('../md2docx/frontPage')
const { collectFiles, concatenateFiles } = require('../common/specProcessor')

const args = process.argv.slice(2)
function flag(name) {
  const i = args.indexOf(name)
  if (i === -1) return null
  const val = args[i + 1]
  args.splice(i, 2)
  return val
}

const specRoot = flag('--spec-root') || ''
const mermaidFile = flag('--mermaid-config')
const frontPageDataFile = flag('--front-page-data')
const crCoverPageDataFile = flag('--cr-cover-page-data')
const inputDir = args[0]
const outputFile = args[1]

if (!inputDir || !outputFile) {
  console.error('Usage: node cli/export-docx.js <inputDir> <outputFile> [--spec-root <dir>] [--mermaid-config <file>] [--front-page-data <file>] [--cr-cover-page-data <file>]')
  process.exit(1)
}

const absInput = path.resolve(inputDir)
const absOutput = path.resolve(outputFile)
const absSpecRoot = specRoot ? path.resolve(specRoot) : ''

if (!fs.existsSync(absInput)) {
  console.error(`Input directory not found: ${absInput}`)
  process.exit(1)
}

const files = collectFiles(absInput)
if (files.length === 0) {
  console.error(`No .md / .markdown / .asn files found in ${absInput}`)
  process.exit(1)
}

const content = concatenateFiles(files, undefined, absSpecRoot)

// Write concatenated content to a temp file for the converter
const tmpDir = require('os').tmpdir()
const ts = Date.now()
const tempMd = path.join(tmpDir, `.~cli_export_${ts}.md`)
fs.writeFileSync(tempMd, content)

// Resolve mermaid config
let mermaidConfig = null
if (mermaidFile && fs.existsSync(mermaidFile)) {
  mermaidConfig = fs.readFileSync(path.resolve(mermaidFile), 'utf8')
} else {
  const defaultMermaidPath = path.join(__dirname, '../css/mermaid-config.json')
  if (fs.existsSync(defaultMermaidPath)) {
    mermaidConfig = fs.readFileSync(defaultMermaidPath, 'utf8')
  }
}

async function run() {
  const { findBrowser } = require('../md2docx/handlers/mermaidHandler')
  if (!findBrowser()) {
    console.warn('Warning: No Chromium-based browser found. Mermaid diagrams will not be rendered.')
    console.warn('  Install Chrome/Chromium or set the CHROME_BIN environment variable.')
  }

  try {
    const converter = new MarkdownToDocxConverter(mermaidConfig, absSpecRoot)

    let frontPage = null
    let crCoverPageData = null
    
    // Load CR cover page data if provided
    if (crCoverPageDataFile && fs.existsSync(crCoverPageDataFile)) {
      try {
        const { loadCRCoverPageData } = require('../common/crCoverPageLoader')
        const result = loadCRCoverPageData(crCoverPageDataFile)
        if (!result.valid) {
          console.error(`CR cover page validation failed:`)
          result.errors.forEach(err => console.error(`  - ${err}`))
          process.exit(1)
        }
        crCoverPageData = result.data
      } catch (e) {
        console.error(`Failed to load CR cover page data: ${e.message}`)
        process.exit(1)
      }
    }
    
    // Load standard front page data if provided (and no CR cover page)
    if (!crCoverPageData && frontPageDataFile && fs.existsSync(frontPageDataFile)) {
      try {
        const data = JSON.parse(fs.readFileSync(frontPageDataFile, 'utf8'))
        frontPage = buildFrontPageDocx(data)
      } catch (e) {
        console.error(`Failed to load front page data: ${e.message}`)
        process.exit(1)
      }
    }

    await converter.convert(tempMd, absOutput, path.dirname(files[0]), frontPage, { crCoverPageData })
    const imageCount = converter.imageCount
    console.log(`Exported ${files.length} file(s) → ${absOutput} (${imageCount} image(s))`)
  } catch (e) {
    console.error(`DOCX export failed: ${e.message}`)
    process.exit(1)
  } finally {
    if (fs.existsSync(tempMd)) fs.unlinkSync(tempMd)
  }
}

run()