@xpack/doxygen2docusaurus 1.1.0 → 2.1.0

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2024 Liviu Ionescu
+Copyright (c) 2024-2026 Liviu Ionescu
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -1,20 +1,21 @@
 [![GitHub package.json version](https://img.shields.io/github/package-json/v/xpack/doxygen2docusaurus-cli-ts)](https://github.com/xpack/doxygen2docusaurus-cli-ts/blob/master/package.json)
 [![NPM Version](https://img.shields.io/npm/v/@xpack/doxygen2docusaurus?color=blue)](https://www.npmjs.com/package/@xpack/doxygen2docusaurus/)
 [![license](https://img.shields.io/github/license/xpack/doxygen2docusaurus-cli-ts)](https://github.com/xpack/doxygen2docusaurus-cli-ts/blob/master/LICENSE)
+[![Website](https://img.shields.io/website?url=https%3A%2F%2Fxpack.github.io%2Fdoxygen2docusaurus-cli-ts%2F)](https://xpack.github.io/doxygen2docusaurus/)
 
-# The doxygen2docusaurus
+# The Doxygen Documentation Converter
 
 A Node.js CLI application to convert Doxygen XML files into Docusaurus documentation.
 
 ## Project documentation
 
 For information on how to install and use this project, please refer to the
-[project website](https://xpack.github.io/doxygen2docusaurus-cli-ts/).
+[project website](https://xpack.github.io/doxygen2docusaurus/).
 
 ## Project source
 
 The source code of the current release is available on
-[GitHub tag v1.0.2 tree](https://github.com/xpack/doxygen2docusaurus-cli-ts/tree/v1.0.2).
+[GitHub tag v2.1.0 tree](https://github.com/xpack/doxygen2docusaurus-cli-ts/tree/v2.1.0).
 
 ## License
 

package/bin/doxygen2docusaurus.js

@@ -3,7 +3,7 @@
 
 /*
  * This file is part of the xPack project (http://xpack.github.io).
- * Copyright (c) 2025 Liviu Ionescu. All rights reserved.
+ * 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.

package/dist/cli/main.d.ts

@@ -1,10 +1,2 @@
-/**
- * Main entry point for the doxygen2docusaurus CLI tool.
- *
- * @param argv - Command line arguments array
- * @returns Promise that resolves to the exit code (0 for success, 1 for error)
- *
- * @public
- */
 export declare function main(argv: string[]): Promise<number>;
 //# sourceMappingURL=main.d.ts.map

package/dist/cli/main.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../src/cli/main.ts"],"names":[],"mappings":"AA8BA;;;;;;;GAOG;AACH,wBAAsB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CA2E1D"}
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../src/cli/main.ts"],"names":[],"mappings":"AA4CA,wBAAsB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CA2E1D"}

package/dist/cli/main.js

@@ -1,45 +1,18 @@
-/*
- * This file is part of the xPack project (http://xpack.github.io).
- * Copyright (c) 2025 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 * as util from 'node:util'
-// https://www.npmjs.com/package/commander
+import { fileURLToPath } from 'node:url';
 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';
-import { fileURLToPath } from 'node:url';
-// https://www.npmjs.com/package/commander
 import { Command } from 'commander';
-// ----------------------------------------------------------------------------
-/**
- * Main entry point for the doxygen2docusaurus CLI tool.
- *
- * @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) {
     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 = packageJson.version;
     const program = new Command();
     program.option('--id <name>', 'configuration id, for multi-configurations');
@@ -83,5 +56,4 @@ export async function main(argv) {
     }
     return exitCode;
 }
-// ----------------------------------------------------------------------------
 //# sourceMappingURL=main.js.map

package/dist/cli/main.js.map

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

package/dist/docusaurus/cli-options.d.ts

@@ -2,93 +2,32 @@ export interface Redirects {
     from: string | string[];
     to: string;
 }
-/**
- * Options, as written by the user. All are optional.
- *
- * @public
- */
 export type CliConfigurationOptions = Record<string, string | boolean>;
 export type CommandOptions = Record<string, string | boolean | undefined>;
-/**
- * Options, when multi-configurations are used.
- *
- * @public
- */
 export type MultiConfigurations = Record<string, CliConfigurationOptions>;
-/**
- * Options, as seen by the application. Most are mandatory.
- *
- * @public
- */
 export declare class CliOptions {
-    /**
-     * Relative to the current website folder, like `doxygen/xml`, no initial/
-     * final slashes.
-     */
     doxygenXmlInputFolderPath: string;
-    /**
-     * Relative to the current website folder, like `docs`, no initial/final
-     * slashes.
-     */
     docsFolderPath: string;
-    /** Relative to the docs folder, like `api`, no initial/final slashes. */
     apiFolderPath: string;
-    /** Site base URL, like / or /xxx/. */
     baseUrl: string;
-    /** Relative to the web home, like `docs`, without initial/final slashes. */
     docsBaseUrl: string;
-    /** Relative to the docs home, like `api`, without initial/final slashes. */
     apiBaseUrl: string;
-    /** Relative to `static` */
     imagesFolderPath: string;
-    /**  Relative to the current `website/static` folder, like `reference`. */
     compatibilityRedirectsOutputFolderPath?: string | undefined;
-    /** The title to be displayed on the main page. */
     mainPageTitle: string;
-    /**
-     * Relative to the current website folder, default
-     * `sidebar-category-doxygen.json`.
-     */
     sidebarCategoryFilePath: string;
-    /** Short text to be displayed in the sidebar. */
     sidebarCategoryLabel: string;
-    /**
-     * Relative to the current website folder, default
-     * `docusaurus-config-doxygen-menu-dropdown.json`.
-     */
-    menuDropdownFilePath: string;
-    /** Short text to be displayed in the menu. */
-    menuDropdownLabel: string;
-    /**
-     * Relative to the current website folder, default
-     * `src/css/custom-doxygen.css`
-     */
+    navbarDropdownFilePath: string;
+    navbarDropdownLabel: string;
+    navbarDropdownPosition: 'left' | 'right';
     customCssFilePath: string;
-    /** Boolean to control verbosity. */
     verbose: boolean;
-    /** Boolean to control debug verbosity. */
     debug: boolean;
-    /** Boolean to control if the TODO suggestions are shown. */
     suggestToDoDescriptions: boolean;
-    /** Boolean to render the pages to the top. */
-    renderPagesAtTop: boolean;
-    /** Boolean to render the program listing in the File pages. */
+    listPagesAtTop: boolean;
     renderProgramListing: boolean;
-    /**
-     * Boolean to render the program listing in the member definitions sections.
-     */
     renderProgramListingInline: boolean;
-    /**
-     * Location of original Doxygen pages
-     *
-     * 'For comparison, the original Doxygen html pages, styled with the
-     * <a href="https://jothepro.github.io/doxygen-awesome-css/">doxygen-awesome-css</a>
-     * plugin, continue to be available via the
-     * <a href="pathname:///doxygen/topics.html"><code>.../doxygen/*.html</b></code>
-     * URLs.'
-     */
     originalPagesNote: string;
-    /** String identifier in case of multiple instances. */
     id: string;
     constructor(commandOptions: CommandOptions);
     parse(): Promise<void>;

package/dist/docusaurus/cli-options.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli-options.d.ts","sourceRoot":"","sources":["../../src/docusaurus/cli-options.ts"],"names":[],"mappings":"AAoBA,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;IACvB,EAAE,EAAE,MAAM,CAAA;CACX;AAED;;;;GAIG;AACH,MAAM,MAAM,uBAAuB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAA;AAEtE,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,CAAA;AAEzE;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAA;AAQzE;;;;GAIG;AACH,qBAAa,UAAU;IACrB;;;OAGG;IACH,yBAAyB,SAAgB;IAEzC;;;OAGG;IACH,cAAc,SAAS;IAEvB,yEAAyE;IACzE,aAAa,SAAQ;IAErB,sCAAsC;IACtC,OAAO,SAAM;IAEb,4EAA4E;IAC5E,WAAW,SAAS;IAEpB,4EAA4E;IAC5E,UAAU,SAAQ;IAElB,2BAA2B;IAC3B,gBAAgB,SAAgB;IAEhC,0EAA0E;IAC1E,sCAAsC,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAE3D,kDAAkD;IAClD,aAAa,SAAK;IAElB;;;OAGG;IACH,uBAAuB,SAAkC;IAEzD,iDAAiD;IACjD,oBAAoB,SAA4B;IAEhD;;;OAGG;IACH,oBAAoB,SAAwC;IAE5D,8CAA8C;IAC9C,iBAAiB,SAAc;IAE/B;;;OAGG;IACH,iBAAiB,SAA0C;IAE3D,oCAAoC;IACpC,OAAO,UAAQ;IAEf,0CAA0C;IAC1C,KAAK,UAAQ;IAEb,4DAA4D;IAC5D,uBAAuB,UAAQ;IAE/B,8CAA8C;IAC9C,gBAAgB,UAAO;IAEvB,+DAA+D;IAC/D,oBAAoB,UAAO;IAE3B;;OAEG;IACH,0BAA0B,UAAO;IAEjC;;;;;;;;OAQG;IACH,iBAAiB,SAAK;IAEtB,uDAAuD;IACvD,EAAE,SAAY;gBAEF,cAAc,EAAE,cAAc;IA4BpC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAuH5B,wBAAwB,CACtB,mBAAmB,EAAE,uBAAuB,GAAG,mBAAmB,GACjE,uBAAuB,GAAG,SAAS;CAkBvC;AAGD,eAAO,MAAM,gBAAgB,OAAO,CAAA;AAEpC,eAAO,MAAM,mBAAmB,KAAK,CAAA"}
+{"version":3,"file":"cli-options.d.ts","sourceRoot":"","sources":["../../src/docusaurus/cli-options.ts"],"names":[],"mappings":"AAyBA,MAAM,WAAW,SAAS;IAExB,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;IAEvB,EAAE,EAAE,MAAM,CAAA;CACX;AAWD,MAAM,MAAM,uBAAuB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAA;AAWtE,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,CAAA;AAWzE,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAA;AAyBzE,qBAAa,UAAU;IAWrB,yBAAyB,SAAgB;IAYzC,cAAc,SAAS;IAYvB,aAAa,SAAQ;IAWrB,OAAO,SAAM;IAWb,WAAW,SAAS;IAWpB,UAAU,SAAQ;IAWlB,gBAAgB,SAA0B;IAU1C,sCAAsC,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAY3D,aAAa,SAAK;IAWlB,uBAAuB,SAAkC;IAWzD,oBAAoB,SAA4B;IAWhD,sBAAsB,SAA0C;IAWhE,mBAAmB,SAAkB;IAWrC,sBAAsB,EAAE,MAAM,GAAG,OAAO,CAAS;IAYjD,iBAAiB,SAA0C;IAW3D,OAAO,UAAQ;IAWf,KAAK,UAAQ;IAWb,uBAAuB,UAAQ;IAW/B,cAAc,UAAO;IAWrB,oBAAoB,UAAO;IAW3B,0BAA0B,UAAO;IAWjC,iBAAiB,SAAK;IAYtB,EAAE,SAAY;gBAaF,cAAc,EAAE,cAAc;IAuCpC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAkI5B,wBAAwB,CACtB,mBAAmB,EAAE,uBAAuB,GAAG,mBAAmB,GACjE,uBAAuB,GAAG,SAAS;CAsBvC;AAGD,eAAO,MAAM,gBAAgB,OAAO,CAAA;AAGpC,eAAO,MAAM,mBAAmB,KAAK,CAAA"}

package/dist/docusaurus/cli-options.js

@@ -1,91 +1,29 @@
-/*
- * This file is part of the xPack project (http://xpack.github.io).
- * Copyright (c) 2025 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 fs from 'node:fs/promises';
 import * as path from 'node:path';
-/**
- * Options, as seen by the application. Most are mandatory.
- *
- * @public
- */
 export class CliOptions {
-    /**
-     * Relative to the current website folder, like `doxygen/xml`, no initial/
-     * final slashes.
-     */
     doxygenXmlInputFolderPath = 'doxygen/xml';
-    /**
-     * Relative to the current website folder, like `docs`, no initial/final
-     * slashes.
-     */
     docsFolderPath = 'docs';
-    /** Relative to the docs folder, like `api`, no initial/final slashes. */
     apiFolderPath = 'api';
-    /** Site base URL, like / or /xxx/. */
     baseUrl = '/';
-    /** Relative to the web home, like `docs`, without initial/final slashes. */
     docsBaseUrl = 'docs';
-    /** Relative to the docs home, like `api`, without initial/final slashes. */
     apiBaseUrl = 'api';
-    /** Relative to `static` */
-    imagesFolderPath = 'img/doxygen';
-    /**  Relative to the current `website/static` folder, like `reference`. */
+    imagesFolderPath = 'assets/images/doxygen';
     compatibilityRedirectsOutputFolderPath;
-    /** The title to be displayed on the main page. */
     mainPageTitle = '';
-    /**
-     * Relative to the current website folder, default
-     * `sidebar-category-doxygen.json`.
-     */
     sidebarCategoryFilePath = 'sidebar-category-doxygen.json';
-    /** Short text to be displayed in the sidebar. */
     sidebarCategoryLabel = 'API Reference (Doxygen)';
-    /**
-     * Relative to the current website folder, default
-     * `docusaurus-config-doxygen-menu-dropdown.json`.
-     */
-    menuDropdownFilePath = 'docusaurus-config-menu-doxygen.json';
-    /** Short text to be displayed in the menu. */
-    menuDropdownLabel = 'Reference';
-    /**
-     * Relative to the current website folder, default
-     * `src/css/custom-doxygen.css`
-     */
+    navbarDropdownFilePath = 'docusaurus-config-navbar-doxygen.json';
+    navbarDropdownLabel = 'API Reference';
+    navbarDropdownPosition = 'left';
     customCssFilePath = 'src/css/custom-doxygen2docusaurus.css';
-    /** Boolean to control verbosity. */
     verbose = false;
-    /** Boolean to control debug verbosity. */
     debug = false;
-    /** Boolean to control if the TODO suggestions are shown. */
     suggestToDoDescriptions = false;
-    /** Boolean to render the pages to the top. */
-    renderPagesAtTop = true;
-    /** Boolean to render the program listing in the File pages. */
+    listPagesAtTop = true;
     renderProgramListing = true;
-    /**
-     * Boolean to render the program listing in the member definitions sections.
-     */
     renderProgramListingInline = true;
-    /**
-     * Location of original Doxygen pages
-     *
-     * 'For comparison, the original Doxygen html pages, styled with the
-     * <a href="https://jothepro.github.io/doxygen-awesome-css/">doxygen-awesome-css</a>
-     * plugin, continue to be available via the
-     * <a href="pathname:///doxygen/topics.html"><code>.../doxygen/*.html</b></code>
-     * URLs.'
-     */
     originalPagesNote = '';
-    /** String identifier in case of multiple instances. */
     id = 'default';
     constructor(commandOptions) {
         this.id = commandOptions.id;
@@ -101,7 +39,7 @@ export class CliOptions {
             this.imagesFolderPath = `img/doxygen-${this.id}`;
             this.sidebarCategoryFilePath =
                 'sidebar-category-doxygen' + `-${this.id}.json`;
-            this.menuDropdownFilePath =
+            this.navbarDropdownFilePath =
                 'docusaurus-config-navbar-doxygen' + `-${this.id}.json`;
         }
         else {
@@ -109,7 +47,7 @@ export class CliOptions {
             this.apiBaseUrl = 'api';
             this.imagesFolderPath = `img/doxygen`;
             this.sidebarCategoryFilePath = `sidebar-category-doxygen.json`;
-            this.menuDropdownFilePath = `docusaurus-config-navbar-doxygen.json`;
+            this.navbarDropdownFilePath = `docusaurus-config-navbar-doxygen.json`;
         }
     }
     async parse() {
@@ -117,64 +55,50 @@ export class CliOptions {
         try {
             const userPackageJsonPath = path.resolve(process.cwd(), 'config', 'doxygen2docusaurus.json');
             const pkgJsonRaw = await fs.readFile(userPackageJsonPath, 'utf8');
-            // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
             const multiConfigurations = JSON.parse(pkgJsonRaw);
             configurationOptions = this.selectMultiConfiguration(multiConfigurations);
-            // eslint-disable-next-line @typescript-eslint/no-unused-vars
         }
         catch (err) {
-            /* Cannot read/parse JSON */
         }
         if (configurationOptions === undefined) {
             try {
                 const userPackageJsonPath = path.resolve(process.cwd(), 'doxygen2docusaurus.json');
                 const pkgJsonRaw = await fs.readFile(userPackageJsonPath, 'utf8');
-                // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
                 const multiConfigurations = JSON.parse(pkgJsonRaw);
                 configurationOptions =
                     this.selectMultiConfiguration(multiConfigurations);
-                // eslint-disable-next-line @typescript-eslint/no-unused-vars
             }
             catch (err) {
-                /* Cannot read/parse JSON */
             }
         }
         if (configurationOptions === undefined) {
             try {
-                // Try to get the configuration from
-                // package.json/[config/]doxygen2docusaurus.
                 const userPackageJsonPath = path.resolve(process.cwd(), 'package.json');
                 const pkgJsonRaw = await fs.readFile(userPackageJsonPath, 'utf8');
-                // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
                 const pkgJson = JSON.parse(pkgJsonRaw);
                 const multiConfigurations = pkgJson.config?.doxygen2docusaurus ?? pkgJson.doxygen2docusaurus;
                 if (multiConfigurations !== undefined) {
                     configurationOptions =
                         this.selectMultiConfiguration(multiConfigurations);
                 }
-                // eslint-disable-next-line @typescript-eslint/no-unused-vars
             }
             catch (err) {
-                /* Cannot read/parse JSON */
             }
         }
-        if (this.debug) {
-            console.log(configurationOptions);
-        }
         if (configurationOptions !== undefined) {
-            // Override only properties that exist in CliOptions
+            if (this.debug) {
+                console.log(configurationOptions);
+            }
             const thisProperties = Object.getOwnPropertyNames(this);
             for (const key of Object.keys(configurationOptions)) {
                 const value = configurationOptions[key];
-                // console.log(key, value)
                 if (value !== undefined && thisProperties.includes(key)) {
                     const thisProperty = this[key];
                     const thisType = typeof thisProperty;
                     const valueType = typeof value;
-                    if (['id', 'verbose', 'debug'].includes(key)) {
+                    if (['id'].includes(key)) {
                         continue;
                     }
-                    // Override only if types match.
                     if (thisType === valueType) {
                         ;
                         this[key] = value;
@@ -193,7 +117,6 @@ export class CliOptions {
         assert(this.docsFolderPath.length > 0, 'docsFolderPath is required');
         assert(this.apiFolderPath.length > 0, 'apiFolderPath is required');
         assert(this.docsBaseUrl.length > 0, 'docsBaseUrl is required');
-        // assert(this.apiBaseUrl.length > 0, 'apiBaseUrl is required')
         assert(this.sidebarCategoryFilePath.length > 0, 'sidebarCategoryFilePath is required');
     }
     selectMultiConfiguration(multiConfigurations) {
@@ -205,13 +128,15 @@ export class CliOptions {
             }
         }
         else {
-            configurationOptions = multiConfigurations;
+            const multiConfig = multiConfigurations;
+            configurationOptions =
+                'default' in multiConfig
+                    ? multiConfig.default
+                    : multiConfigurations;
         }
         return configurationOptions;
     }
 }
-// Was used during development. Now stick to true.
 export const renderParagraphs = true;
 export const maxParallelPromises = 42;
-// ----------------------------------------------------------------------------
 //# sourceMappingURL=cli-options.js.map

package/dist/docusaurus/cli-options.js.map

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

package/dist/docusaurus/generator.d.ts

@@ -1,5 +1,6 @@
 import { Workspace } from './workspace.js';
 import { CliOptions } from './cli-options.js';
+import type { SidebarCategory, NavbarItem } from './types.js';
 import type { CompoundBase } from './view-model/compound-base-vm.js';
 export declare class DocusaurusGenerator {
     workspace: Workspace;
@@ -7,12 +8,14 @@ export declare class DocusaurusGenerator {
     constructor(workspace: Workspace);
     run(): Promise<number>;
     prepareOutputFolder(): Promise<void>;
-    generateSidebarFile(): Promise<void>;
-    generateMenuFile(): Promise<void>;
+    generateSidebarCategory(): SidebarCategory;
+    writeSidebarFile(sidebarCategory: SidebarCategory): Promise<void>;
+    generateNavbarItem(): NavbarItem;
+    writeNavbarFile(navbarItem: NavbarItem): Promise<void>;
     generateCollectionsIndexDotMdFiles(): Promise<void>;
     generateTopIndexDotMdFile(): Promise<void>;
-    generatePerInitialsIndexMdFiles(): Promise<void>;
-    generatePages(): Promise<void>;
+    generatePerInitialsIndexDotMdFiles(): Promise<void>;
+    generateMdFiles(): Promise<void>;
     generatePage(compound: CompoundBase): Promise<void>;
     generateCompatibilityRedirectFiles(): Promise<void>;
     private generateRedirectFile;

package/dist/docusaurus/generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../src/docusaurus/generator.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,EAAE,UAAU,EAAuB,MAAM,kBAAkB,CAAA;AAMlE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAA;AAKpE,qBAAa,mBAAmB;IAC9B,SAAS,EAAE,SAAS,CAAA;IAEpB,OAAO,EAAE,UAAU,CAAA;gBAIP,SAAS,EAAE,SAAS;IAQ1B,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC;IAuCtB,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;IAiBpC,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;IA4CpC,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;IAyDjC,kCAAkC,IAAI,OAAO,CAAC,IAAI,CAAC;IAYnD,yBAAyB,IAAI,OAAO,CAAC,IAAI,CAAC;IA2E1C,+BAA+B,IAAI,OAAO,CAAC,IAAI,CAAC;IAYhD,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IA+C9B,YAAY,CAAC,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAkCnD,kCAAkC,IAAI,OAAO,CAAC,IAAI,CAAC;YA4G3C,oBAAoB;IAuC5B,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAyC1B,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;CA0CtC"}
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../src/docusaurus/generator.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,EAAE,UAAU,EAAuB,MAAM,kBAAkB,CAAA;AAClE,OAAO,KAAK,EAAE,eAAe,EAAe,UAAU,EAAE,MAAM,YAAY,CAAA;AAK1E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAA;AAiBpE,qBAAa,mBAAmB;IAE9B,SAAS,EAAE,SAAS,CAAA;IAGpB,OAAO,EAAE,UAAU,CAAA;gBAeP,SAAS,EAAE,SAAS;IAmB1B,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC;IAyDtB,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;IA4B1C,uBAAuB,IAAI,eAAe;IAwCpC,gBAAgB,CAAC,eAAe,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBvE,kBAAkB,IAAI,UAAU;IA8C1B,eAAe,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBtD,kCAAkC,IAAI,OAAO,CAAC,IAAI,CAAC;IAqBnD,yBAAyB,IAAI,OAAO,CAAC,IAAI,CAAC;IAoF1C,kCAAkC,IAAI,OAAO,CAAC,IAAI,CAAC;IAqBnD,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IA0DhC,YAAY,CAAC,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IA2CnD,kCAAkC,IAAI,OAAO,CAAC,IAAI,CAAC;YA0H3C,oBAAoB;IAgD5B,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAkD1B,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;CA0CtC"}