@xpack/doxygen2docusaurus 1.1.0 → 2.1.0

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,55 +1,27 @@
 {
   "name": "@xpack/doxygen2docusaurus",
-  "version": "1.1.0",
+  "version": "2.1.0",
   "description": "A Node.js CLI application to convert Doxygen XML files into Docusaurus documentation",
   "type": "module",
   "main": "./dist/index.js",
-  "typings": "./dist/doxygen2docusaurus.d.ts",
+  "typings": "./dist/index.d.ts",
   "bin": {
     "doxygen2docusaurus": "./bin/doxygen2docusaurus.js"
   },
   "files": [
     "dist/",
-    "template"
+    "src/",
+    "templates/"
   ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/xpack/doxygen2docusaurus-cli-ts.git"
+  },
   "keywords": [
     "docusaurus",
     "doxygen",
     "cli"
   ],
-  "scripts": {
-    "generate-top-commons": "bash node_modules/@xpack/npm-packages-helper/maintenance-scripts/generate-top-commons.sh --xpack",
-    "api-extractor": "api-extractor run --local --verbose",
-    "prepare": "del-cli dist && npm run prettier && npm run lint && npm run compile && npm run api-extractor",
-    "compile-watch": "tsc --build --verbose --watch src",
-    "compile": "tsc --build --verbose src",
-    "prettier": "prettier src --write",
-    "fix": "eslint --fix src",
-    "generate-tsdoc": "api-extractor run --local --verbose && api-documenter markdown --input-folder api-extractor --output-folder api-extractor/markdown",
-    "dev-cycle": "npm run fix && npm run compile && npm run test",
-    "npm-install": "npm install",
-    "npm-link-helpers": "npm link @xpack/npm-packages-helper @xpack/docusaurus-template-liquid",
-    "npm-link": "npm link",
-    "npm-outdated": "npm outdated",
-    "npm-update": "npm update",
-    "npm-pack": "npm pack",
-    "npm-version-patch": "npm version patch",
-    "npm-version-minor": "npm version minor",
-    "postversion": "git push origin --all && git push origin --tags",
-    "git-log": "git log --pretty='%cd * %h %s' --date=short",
-    "lint": "eslint src",
-    "test": "echo 'No tests defined'",
-    "prepublishOnly": "npm run lint && npm run test",
-    "postpublish": "git push origin --follow-tags",
-    "clean": "del-cli dist cjs 'tests/**/cjs' 'src/**/*.d.ts' 'src/**/*.d.ts.map' 'src/**/*.js' 'src/**/*.js.map' 'tests/**/*.d.ts' 'tests/**/*.d.ts.map' 'tests/**/*.js' 'tests/**/*.js.map' '**/tsconfig.tsbuildinfo' .nyc_output coverage",
-    "deep-clean": "npm run clean && rm -rf node_modules package-lock.json",
-    "dumpconf": "env | sort | uniq",
-    "show-versions": "echo $(which node) $(node --version) && echo $(which npm) $(npm --version)"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/xpack/doxygen2docusaurus-cli-ts.git"
-  },
   "author": {
     "name": "Liviu Ionescu",
     "email": "ilg@livius.net",
@@ -59,42 +31,67 @@
   "bugs": {
     "url": "https://github.com/xpack/doxygen2docusaurus-cli-ts/issues"
   },
-  "homepage": "https://xpack.github.io/doxygen2docusaurus-cli-ts/",
+  "homepage": "https://xpack.github.io/doxygen2docusaurus/",
+  "homepagePreview": "https://xpack.github.io/doxygen2docusaurus-cli-ts/",
   "dependencies": {
-    "commander": "^14.0.0",
-    "fast-xml-parser": "^5.2.5"
+    "commander": "^14.0.3",
+    "fast-xml-parser": "^5.7.2"
   },
   "devDependencies": {
-    "@microsoft/api-extractor": "^7.52.8",
+    "@eslint/js": "^9.31.0",
     "@tsconfig/node20": "^20.1.6",
-    "@types/node": "^24.0.14",
-    "del-cli": "^6.0.0",
+    "@types/node": "^25.0.9",
+    "del-cli": "^7.0.0",
     "eslint": "^9.31.0",
     "eslint-config-prettier": "^10.1.8",
-    "fs-extra": "^11.3.0",
+    "fs-extra": "^11.3.4",
     "json": "^11.0.0",
-    "liquidjs": "^10.19.1",
-    "prettier": "3.6.2",
+    "liquidjs": "^10.24.0",
+    "prettier": "^3.8.1",
     "ts-node": "^10.9.2",
     "typescript": "^5.8.3",
-    "typescript-eslint": "^8.38.0",
-    "@eslint/js": "^9.31.0"
+    "typescript-eslint": "^8.38.0"
+  },
+  "scripts": {
+    "generate-top-commons": "bash node_modules/@xpack/npm-packages-helper/maintenance-scripts/generate-top-commons.sh --xpack",
+    "compile-watch": "tsc --build --verbose --watch src",
+    "prettier": "prettier src tests --write --config config/.prettierrc.json --ignore-path config/.prettierignore",
+    "fix": "eslint --config config/eslint.config.js --fix src",
+    "compile": "tsc --project tsconfig.json",
+    "fix-compile": "npm run prettier && npm run fix && npm run compile",
+    "lint": "eslint --config config/eslint.config.js src",
+    "npm-install": "npm install",
+    "npm-link": "npm link",
+    "npm-link-helpers": "npm link @xpack/npm-packages-helper @xpack/docusaurus-template-liquid",
+    "npm-outdated": "npm outdated",
+    "npm-update": "npm update",
+    "postversion": "git push origin --all && git push origin --tags",
+    "npm-pack": "npm pack",
+    "git-log": "git log --pretty='%cd * %h %s' --date=short",
+    "prepare": "del-cli dist && npm run prettier && npm run lint && npm run compile",
+    "test": "echo 'No tests defined'",
+    "dev-cycle": "npm run fix && npm run compile && npm run test",
+    "clean": "del-cli --force dist build .tap",
+    "deep-clean": "npm run clean && del-cli --force node_modules package-lock.json",
+    "npm-audit": "npm audit fix --force",
+    "dumpconf": "env | sort | uniq",
+    "show-versions": "echo $(which node) $(node --version) && echo $(which npm) $(npm --version)",
+    "prepublishOnly": "npm run lint && npm run test",
+    "postpublish": "git push origin --follow-tags"
   },
   "topConfig": {
-    "descriptiveName": "doxygen2docusaurus",
+    "descriptiveName": "Doxygen Documentation Converter",
     "permalinkName": "doxygen2docusaurus",
+    "preferShortName": "true",
     "skipCiTests": "true",
     "hasNoGithubReleases": "true",
     "hasCli": "true",
-    "useEslint": "true"
-  },
-  "prettier": {
-    "printWidth": 80,
-    "semi": false,
-    "singleQuote": true,
-    "trailingComma": "es5"
+    "useEslint": "true",
+    "usePrettier": "true",
+    "hasTriggerPublish": "true",
+    "isWebPreview": "true"
   },
   "engines": {
-    "node": " >=20.0.0"
+    "node": ">=20.0"
   }
 }

package/src/cli/main.ts

@@ -0,0 +1,122 @@
+/*
+ * This file is part of the xPack project (http://xpack.github.io).
+ * Copyright (c) 2025-2026 Liviu Ionescu. All rights reserved.
+ *
+ * Permission to use, copy, modify, and/or distribute this software
+ * for any purpose is hereby granted, under the terms of the MIT license.
+ *
+ * If a copy of the license was not distributed with this file, it can
+ * be obtained from https://opensource.org/licenses/MIT.
+ */
+
+// ----------------------------------------------------------------------------
+
+// import assert from 'node:assert'
+import * as path from 'node:path'
+import * as fs from 'node:fs/promises'
+import { fileURLToPath } from 'node:url'
+// import * as util from 'node:util'
+
+// https://www.npmjs.com/package/commander
+import { CliOptions } from '../docusaurus/cli-options.js'
+import { formatDuration } from '../docusaurus/utils.js'
+import { DataModel } from '../doxygen/data-model/data-model.js'
+import { DocusaurusGenerator } from '../docusaurus/generator.js'
+import { Workspace } from '../docusaurus/workspace.js'
+// https://www.npmjs.com/package/commander
+import { Command } from 'commander'
+
+// ----------------------------------------------------------------------------
+
+/**
+ * Main entry point for the doxygen2docusaurus CLI tool.
+ *
+ * @remarks
+ * Orchestrates the complete conversion process from Doxygen XML to Docusaurus
+ * documentation. Handles command-line argument parsing, configuration loading,
+ * data model creation, workspace initialisation, and documentation generation.
+ * Provides timing information and appropriate exit codes for integration.
+ *
+ * @param argv - Command line arguments array
+ * @returns Promise that resolves to the exit code (0 for success, 1 for error)
+ *
+ * @public
+ */
+export async function main(argv: string[]): Promise<number> {
+  const startTime = Date.now()
+
+  // Like .../doxygen2docusaurus/dist/cli
+  const __dirname = path.dirname(fileURLToPath(import.meta.url))
+  const packageJsonPath = path.join(
+    path.dirname(path.dirname(__dirname)),
+    'package.json'
+  )
+  const packageJsonContent = await fs.readFile(packageJsonPath)
+
+  // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+  const packageJson = JSON.parse(packageJsonContent.toString())
+  // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-member-access
+  const packageVersion: string = packageJson.version
+
+  const program = new Command()
+
+  program.option('--id <name>', 'configuration id, for multi-configurations')
+  program.option('--verbose', 'display more details during the conversion')
+  program.option('--debug', 'display debug lines during the conversion')
+  program.option('-C <path>', 'change the current folder')
+  program.option('-v, --version', 'display version')
+  program.parse(argv)
+
+  const programOptions = program.opts()
+
+  if (programOptions.version) {
+    console.log(packageVersion)
+    return 0
+  }
+
+  if (programOptions.C) {
+    process.chdir(programOptions.C as string)
+  }
+
+  let commandLine: string = path.basename(argv[1] ?? 'doxygen2docusaurus')
+  if (argv.length > 2) {
+    commandLine += ` ${argv.slice(2).join(' ')}`
+  }
+
+  console.log(`Running '${commandLine}' (v${packageVersion})...`)
+
+  const id = (programOptions.id as string | undefined) ?? 'default'
+  const verbose = programOptions.verbose as boolean | undefined
+  const debug = programOptions.debug as boolean | undefined
+
+  const commandOptions = { id, verbose, debug }
+  const options = new CliOptions(commandOptions)
+  await options.parse()
+
+  let exitCode = 0
+
+  console.log()
+
+  const dataModel = new DataModel(options)
+  await dataModel.parse()
+  dataModel.projectVersion = packageVersion
+
+  const workspace = new Workspace(dataModel)
+
+  const generator = new DocusaurusGenerator(workspace)
+  exitCode = await generator.run()
+
+  const durationString = formatDuration(Date.now() - startTime)
+
+  if (exitCode === 0) {
+    console.log()
+    console.log(
+      `Running '${commandLine}' has completed successfully ` +
+        `in ${durationString}.`
+    )
+  }
+
+  return exitCode
+}
+
+// ----------------------------------------------------------------------------