@xpack/doxygen2docusaurus 1.0.2 → 2.0.0

package/dist/docusaurus/cli-options.js

@@ -12,97 +12,278 @@
 import assert from 'node:assert';
 import * as fs from 'node:fs/promises';
 import * as path from 'node:path';
-// import * as util from 'node:util'
-// https://www.npmjs.com/package/commander
-import { Command } from 'commander';
 /**
- * Options, as seen by the application. Most are mandatory.
+ * Comprehensive CLI options class for documentation generation configuration.
+ *
+ * @remarks
+ * The CliOptions class contains all configuration parameters that control
+ * the behaviour of the doxygen2docusaurus conversion process, including
+ * paths, URLs, styling, and feature toggles.
  *
  * @public
  */
 export class CliOptions {
     /**
-     * Relative to the current website folder, like `doxygen/xml`, no initial/
-     * final slashes.
+     * Path to the Doxygen XML input folder relative to the website folder.
+     *
+     * @remarks
+     * Specifies the location of XML files generated by Doxygen, typically
+     * containing the parsed documentation data. Path should not include
+     * initial or final slashes.
+     *
+     * @defaultValue 'doxygen/xml'
      */
     doxygenXmlInputFolderPath = 'doxygen/xml';
     /**
-     * Relative to the current website folder, like `docs`, no initial/final
-     * slashes.
+     * Path to the documentation folder relative to the website folder.
+     *
+     * @remarks
+     * Defines the base folder where generated documentation will be placed
+     * within the Docusaurus website structure. Path should not include
+     * initial or final slashes.
+     *
+     * @defaultValue 'docs'
      */
     docsFolderPath = 'docs';
-    /** Relative to the docs folder, like `api`, no initial/final slashes. */
+    /**
+     * Path to the API documentation folder relative to the docs folder.
+     *
+     * @remarks
+     * Specifies the subfolder within the docs folder where API reference
+     * documentation will be generated. Path should not include initial
+     * or final slashes.
+     *
+     * @defaultValue 'api'
+     */
     apiFolderPath = 'api';
-    /** Site base URL, like / or /xxx/. */
+    /**
+     * Base URL for the entire website.
+     *
+     * @remarks
+     * Defines the root URL path for the website, typically '/' for root
+     * deployment or '/project-name/' for GitHub Pages or similar hosting.
+     *
+     * @defaultValue '/'
+     */
     baseUrl = '/';
-    /** Relative to the web home, like `docs`, without initial/final slashes. */
+    /**
+     * URL path to the documentation section relative to the website root.
+     *
+     * @remarks
+     * Specifies the URL segment that leads to the documentation section,
+     * without initial or final slashes. Used for navigation and linking.
+     *
+     * @defaultValue 'docs'
+     */
     docsBaseUrl = 'docs';
-    /** Relative to the docs home, like `api`, without initial/final slashes. */
+    /**
+     * URL path to the API documentation relative to the docs section.
+     *
+     * @remarks
+     * Defines the URL segment for API documentation within the docs section,
+     * without initial or final slashes. Used for generating navigation links.
+     *
+     * @defaultValue 'api'
+     */
     apiBaseUrl = 'api';
-    /** Relative to `static` */
-    imagesFolderPath = 'img/doxygen';
-    /**  Relative to the current `website/static` folder, like `reference`. */
+    /**
+     * Path for images relative to the `static` folder.
+     *
+     * @remarks
+     * Specifies where Doxygen-generated images will be stored within the
+     * Docusaurus static assets folder structure.
+     *
+     * @defaultValue 'assets/images/doxygen'
+     */
+    imagesFolderPath = 'assets/images/doxygen';
+    /**
+     * Output folder for compatibility redirect files.
+     *
+     * @remarks
+     * Optional path relative to the website/static folder where HTML redirect
+     * files will be generated to maintain compatibility with original Doxygen
+     * URLs. When undefined, no redirect files are created.
+     */
     compatibilityRedirectsOutputFolderPath;
-    /** The title to be displayed on the main page. */
+    /**
+     * Title displayed on the main API documentation page.
+     *
+     * @remarks
+     * When specified, this title overrides the default title generated from
+     * the project brief. When empty, the title is automatically constructed
+     * from the project configuration.
+     *
+     * @defaultValue ''
+     */
     mainPageTitle = '';
     /**
-     * Relative to the current website folder, default
-     * `sidebar-category-doxygen.json`.
+     * Path to the sidebar category configuration file.
+     *
+     * @remarks
+     * Specifies the location where the generated sidebar category JSON
+     * configuration will be written, relative to the current website folder.
+     *
+     * @defaultValue 'sidebar-category-doxygen.json'
      */
     sidebarCategoryFilePath = 'sidebar-category-doxygen.json';
-    /** Short text to be displayed in the sidebar. */
+    /**
+     * Label displayed in the Docusaurus sidebar for the API documentation.
+     *
+     * @remarks
+     * Short descriptive text that appears in the sidebar navigation to
+     * identify the API reference section.
+     *
+     * @defaultValue 'API Reference (Doxygen)'
+     */
     sidebarCategoryLabel = 'API Reference (Doxygen)';
     /**
-     * Relative to the current website folder, default
-     * `docusaurus-config-doxygen-menu-dropdown.json`.
+     * Path to the navbar configuration file.
+     *
+     * @remarks
+     * Specifies the location where the generated navbar dropdown JSON
+     * configuration will be written, relative to the current website folder.
+     *
+     * @defaultValue 'docusaurus-config-navbar-doxygen.json'
+     */
+    navbarFilePath = 'docusaurus-config-navbar-doxygen.json';
+    /**
+     * Label displayed in the top navigation bar.
+     *
+     * @remarks
+     * Short text that appears in the Docusaurus top navigation bar to
+     * provide access to the API documentation section.
+     *
+     * @defaultValue 'Reference'
+     */
+    navbarLabel = 'Reference';
+    /**
+     * Position of the navigation menu in the top bar.
+     *
+     * @remarks
+     * Determines whether the API documentation menu appears on the left
+     * or right side of the Docusaurus navigation bar.
+     *
+     * @defaultValue 'left'
      */
-    menuDropdownFilePath = 'docusaurus-config-menu-doxygen.json';
-    /** Short text to be displayed in the menu. */
-    menuDropdownLabel = 'Reference';
+    navbarPosition = 'left';
     /**
-     * Relative to the current website folder, default
-     * `src/css/custom-doxygen.css`
+     * Path to the custom CSS file for styling overrides.
+     *
+     * @remarks
+     * Specifies the location where custom CSS styles will be written to
+     * provide Doxygen-specific styling within the Docusaurus theme.
+     * Path is relative to the current website folder.
+     *
+     * @defaultValue 'src/css/custom-doxygen2docusaurus.css'
      */
     customCssFilePath = 'src/css/custom-doxygen2docusaurus.css';
-    /** Boolean to control verbosity. */
+    /**
+     * Controls verbose output during the conversion process.
+     *
+     * @remarks
+     * When enabled, provides detailed logging information about the
+     * conversion process, including file processing status and statistics.
+     *
+     * @defaultValue false
+     */
     verbose = false;
-    /** Boolean to control debug verbosity. */
+    /**
+     * Controls debug-level output during the conversion process.
+     *
+     * @remarks
+     * When enabled, provides extensive debugging information useful for
+     * troubleshooting issues. Automatically enables verbose output as well.
+     *
+     * @defaultValue false
+     */
     debug = false;
-    /** Boolean to control if the TODO suggestions are shown. */
+    /**
+     * Controls whether TODO suggestion descriptions are displayed.
+     *
+     * @remarks
+     * When enabled, shows suggestions for improvements or missing content
+     * that could enhance the generated documentation quality.
+     *
+     * @defaultValue false
+     */
     suggestToDoDescriptions = false;
-    /** Boolean to render the pages to the top. */
-    renderPagesAtTop = true;
-    /** Boolean to render the program listing in the File pages. */
+    /**
+     * Controls whether pages are listed at the top of the sidebar.
+     *
+     * @remarks
+     * When enabled, places page links prominently at the top of the sidebar
+     * navigation structure for easier access to important pages.
+     *
+     * @defaultValue true
+     */
+    listPagesAtTop = true;
+    /**
+     * Controls program listing rendering in File pages.
+     *
+     * @remarks
+     * When enabled, includes syntax-highlighted source code listings
+     * within the generated File documentation pages.
+     *
+     * @defaultValue true
+     */
     renderProgramListing = true;
     /**
-     * Boolean to render the program listing in the member definitions sections.
+     * Controls program listing rendering in member definition sections.
+     *
+     * @remarks
+     * When enabled, includes inline syntax-highlighted code snippets
+     * within member documentation sections for better context.
+     *
+     * @defaultValue true
      */
     renderProgramListingInline = true;
     /**
-     * Location of original Doxygen pages
+     * Note about the 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.'
+     * @remarks
+     * Provides information about where to find the original Doxygen HTML
+     * pages for comparison purposes. When populated, this note is displayed
+     * to inform users about the availability of alternative documentation
+     * formats.
      */
     originalPagesNote = '';
-    /** String identifier in case of multiple instances. */
+    /**
+     * String identifier for distinguishing multiple configuration instances.
+     *
+     * @remarks
+     * Used when multiple configuration instances exist to provide unique
+     * identification. Particularly useful in multi-configuration scenarios
+     * where different settings need to be applied to different outputs.
+     *
+     * @defaultValue 'default'
+     */
     id = 'default';
-    constructor(argv) {
-        const program = new Command();
-        program.option('--id <name>', 'id, for multi-configurations');
-        program.parse(argv);
-        const programOptions = program.opts();
-        this.id = programOptions.id ?? 'default';
+    /**
+     * Creates a new CliOptions instance with the specified command options.
+     *
+     * @remarks
+     * Initialises the configuration object by setting the ID and optional
+     * flags like verbose and debug. When the ID is not 'default', adjusts
+     * folder paths and file names to include the ID for multi-configuration
+     * scenarios.
+     *
+     * @param commandOptions - Command-line options object containing ID and flags
+     */
+    constructor(commandOptions) {
+        this.id = commandOptions.id;
+        if (commandOptions.verbose !== undefined) {
+            this.verbose = true;
+        }
+        if (commandOptions.debug !== undefined) {
+            this.debug = true;
+        }
         if (this.id !== 'default') {
             this.apiFolderPath = this.id;
             this.apiBaseUrl = this.id;
             this.imagesFolderPath = `img/doxygen-${this.id}`;
             this.sidebarCategoryFilePath =
                 'sidebar-category-doxygen' + `-${this.id}.json`;
-            this.menuDropdownFilePath =
+            this.navbarFilePath =
                 'docusaurus-config-navbar-doxygen' + `-${this.id}.json`;
         }
         else {
@@ -110,9 +291,20 @@ export class CliOptions {
             this.apiBaseUrl = 'api';
             this.imagesFolderPath = `img/doxygen`;
             this.sidebarCategoryFilePath = `sidebar-category-doxygen.json`;
-            this.menuDropdownFilePath = `docusaurus-config-navbar-doxygen.json`;
+            this.navbarFilePath = `docusaurus-config-navbar-doxygen.json`;
         }
     }
+    /**
+     * Parses configuration options from various JSON configuration sources.
+     *
+     * @remarks
+     * Attempts to load configuration from multiple locations in order of
+     * preference: config/doxygen2docusaurus.json, doxygen2docusaurus.json,
+     * and package.json. Validates required properties and enables debug
+     * output if requested.
+     *
+     * @throws Assertion error if required configuration properties are missing
+     */
     async parse() {
         let configurationOptions = undefined;
         try {
@@ -159,10 +351,10 @@ export class CliOptions {
                 /* Cannot read/parse JSON */
             }
         }
-        if (this.debug) {
-            console.log(configurationOptions);
-        }
         if (configurationOptions !== undefined) {
+            if (this.debug) {
+                console.log(configurationOptions);
+            }
             // Override only properties that exist in CliOptions
             const thisProperties = Object.getOwnPropertyNames(this);
             for (const key of Object.keys(configurationOptions)) {
@@ -172,7 +364,10 @@ export class CliOptions {
                     const thisProperty = this[key];
                     const thisType = typeof thisProperty;
                     const valueType = typeof value;
-                    // Only override if types match
+                    if (['id', 'verbose', 'debug'].includes(key)) {
+                        continue;
+                    }
+                    // Override only if types match.
                     if (thisType === valueType) {
                         ;
                         this[key] = value;
@@ -180,6 +375,9 @@ export class CliOptions {
                 }
             }
         }
+        if (this.debug) {
+            this.verbose = true;
+        }
         if (this.verbose) {
             console.log();
             console.log(this);
@@ -191,6 +389,17 @@ export class CliOptions {
         // assert(this.apiBaseUrl.length > 0, 'apiBaseUrl is required')
         assert(this.sidebarCategoryFilePath.length > 0, 'sidebarCategoryFilePath is required');
     }
+    /**
+     * Selects the appropriate configuration from multi-configuration options.
+     *
+     * @remarks
+     * When using a specific ID, returns the corresponding configuration.
+     * For the default ID, returns either the 'default' configuration or
+     * treats the entire object as a single configuration.
+     *
+     * @param multiConfigurations - Configuration object or multi-config map
+     * @returns Selected configuration options or undefined if not found
+     */
     selectMultiConfiguration(multiConfigurations) {
         let configurationOptions = undefined;
         if (this.id !== 'default') {
@@ -200,13 +409,18 @@ 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;
+// Does not make noticeable differences.
 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,22 +1,197 @@
 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';
+/**
+ * Generates Docusaurus-compatible Markdown files and configuration from
+ * Doxygen XML output.
+ *
+ * @remarks
+ * This class orchestrates the conversion process, creating documentation pages,
+ * navigation structures, and associated assets for integration with Docusaurus
+ * websites. It handles parallel processing for performance optimisation and
+ * manages the complete workflow from XML parsing to final site generation.
+ *
+ * @public
+ */
 export declare class DocusaurusGenerator {
+    /** The workspace containing the data model and configuration options. */
     workspace: Workspace;
+    /** CLI options that control the generation process. */
     options: CliOptions;
+    /**
+     * Constructs a new Docusaurus generator instance.
+     *
+     * @remarks
+     * Initialises the generator with the provided workspace, which contains
+     * the parsed Doxygen data model and configuration options required for
+     * the generation process.
+     *
+     * @param workspace - The workspace containing the data model and
+     * configuration.
+     */
     constructor(workspace: Workspace);
+    /**
+     * Executes the complete generation process.
+     *
+     * @remarks
+     * Orchestrates the creation of all Docusaurus assets including Markdown
+     * files, navigation structures, redirect files, and static assets. The
+     * process follows a specific sequence to ensure proper dependencies and
+     * optimal performance through parallel processing where appropriate.
+     *
+     * @returns A promise that resolves to the exit code (0 for success).
+     */
     run(): Promise<number>;
+    /**
+     * Prepares the output folder for generated content.
+     *
+     * @remarks
+     * Removes any existing output folder and creates a new empty directory
+     * structure for the generated Docusaurus files. This ensures a clean
+     * starting state for each generation run and prevents conflicts with
+     * previous builds.
+     */
     prepareOutputFolder(): Promise<void>;
-    generateSidebarFile(): Promise<void>;
-    generateMenuFile(): Promise<void>;
+    /**
+     * Generates the sidebar category structure for Docusaurus navigation.
+     *
+     * @remarks
+     * Creates a hierarchical category structure that organises all generated
+     * documentation pages into a logical navigation tree. The structure includes
+     * top-level pages and follows the configured collection ordering to maintain
+     * consistent navigation patterns.
+     *
+     * @returns The complete sidebar category configuration object.
+     */
+    generateSidebarCategory(): SidebarCategory;
+    /**
+     * Writes the sidebar configuration to a JSON file.
+     *
+     * @remarks
+     * Serialises the sidebar category structure and writes it to the configured
+     * output path for integration with Docusaurus. The resulting JSON file
+     * provides the complete navigation structure for the documentation site.
+     *
+     * @param sidebarCategory - The sidebar configuration to write.
+     */
+    writeSidebarFile(sidebarCategory: SidebarCategory): Promise<void>;
+    /**
+     * Generates the navbar dropdown configuration for the top navigation.
+     *
+     * @remarks
+     * Creates a navigation menu structure that provides quick access to
+     * different sections of the generated documentation. When no items are
+     * available, falls back to a simple link format for consistency.
+     *
+     * @returns The navbar item configuration for Docusaurus.
+     */
+    generateNavbarItem(): NavbarItem;
+    /**
+     * Writes the navbar configuration to a JSON file.
+     *
+     * @remarks
+     * Serialises the navbar item structure and writes it to the configured
+     * output path for integration with Docusaurus navigation. The resulting
+     * JSON file provides the top-level navigation menu configuration.
+     *
+     * @param navbarItem - The navbar configuration to write.
+     */
+    writeNavbarFile(navbarItem: NavbarItem): Promise<void>;
+    /**
+     * Generates index Markdown files for all collections.
+     *
+     * @remarks
+     * Creates overview pages for each documentation collection (classes, files,
+     * namespaces, etc.) that provide organised access to the content. These
+     * index files serve as entry points for navigating large documentation
+     * collections efficiently.
+     */
     generateCollectionsIndexDotMdFiles(): Promise<void>;
+    /**
+     * Generates the main index Markdown file for the API documentation.
+     *
+     * @remarks
+     * Creates the landing page that serves as the entry point to the generated
+     * documentation, including topics overview and main page content. This
+     * combines the Doxygen @mainpage content with a structured topics table
+     * for comprehensive navigation.
+     */
     generateTopIndexDotMdFile(): Promise<void>;
-    generatePerInitialsIndexMdFiles(): Promise<void>;
-    generatePages(): Promise<void>;
+    /**
+     * Generates alphabetical index files organised by initial letters.
+     *
+     * @remarks
+     * Creates index pages that group documentation items by their first letter,
+     * facilitating alphabetical navigation through large sets of documentation.
+     * This approach improves usability when dealing with extensive API
+     * documentation containing numerous items.
+     */
+    generatePerInitialsIndexDotMdFiles(): Promise<void>;
+    /**
+     * Generates all individual Markdown files for documentation compounds.
+     *
+     * @remarks
+     * Processes all compounds (classes, files, namespaces, etc.) from the
+     * Doxygen XML and converts them into Docusaurus-compatible Markdown pages.
+     * Supports parallel processing for improved performance whilst maintaining
+     * proper error handling and resource management.
+     */
+    generateMdFiles(): Promise<void>;
+    /**
+     * Generates a single Markdown page for a documentation compound.
+     *
+     * @remarks
+     * Converts an individual compound (class, file, namespace, etc.) into a
+     * properly formatted Docusaurus Markdown file with appropriate front matter
+     * and content. The method handles permalink generation, metadata creation,
+     * and content rendering for optimal integration with Docusaurus.
+     *
+     * @param compound - The compound to generate a page for.
+     */
     generatePage(compound: CompoundBase): Promise<void>;
+    /**
+     * Generates HTML redirect files for backwards compatibility.
+     *
+     * @remarks
+     * Creates redirect files that map original Doxygen URLs to the new
+     * Docusaurus URLs, maintaining compatibility with existing bookmarks
+     * and external links. This ensures a smooth transition when migrating
+     * from Doxygen-generated documentation to Docusaurus.
+     */
     generateCompatibilityRedirectFiles(): Promise<void>;
+    /**
+     * Generates an HTML redirect file for URL redirection.
+     *
+     * @remarks
+     * Creates a client-side redirect page that automatically forwards visitors
+     * from old Doxygen URLs to the corresponding Docusaurus pages. The redirect
+     * preserves query parameters and hash fragments to maintain deep linking
+     * functionality across the migration.
+     *
+     * @param filePath - The path where the redirect file should be created.
+     * @param permalink - The target URL to redirect to.
+     */
     private generateRedirectFile;
+    /**
+     * Copies required static files to the output directory.
+     *
+     * @remarks
+     * Transfers essential template files including SVG icons and CSS
+     * stylesheets to the appropriate locations in the static directory
+     * for use by the generated documentation. These assets provide the
+     * visual styling and iconography for the documentation site.
+     */
     copyFiles(): Promise<void>;
+    /**
+     * Copies image files referenced in the documentation.
+     *
+     * @remarks
+     * Transfers all image files that are referenced within the Doxygen
+     * documentation to the appropriate static directory, ensuring they
+     * remain accessible in the generated Docusaurus site. Duplicate
+     * image names are automatically deduplicated for efficiency.
+     */
     copyImageFiles(): Promise<void>;
 }
 //# sourceMappingURL=generator.d.ts.map

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;AAKpE;;;;;;;;;;;GAWG;AACH,qBAAa,mBAAmB;IAC9B,yEAAyE;IACzE,SAAS,EAAE,SAAS,CAAA;IAEpB,uDAAuD;IACvD,OAAO,EAAE,UAAU,CAAA;IAInB;;;;;;;;;;OAUG;gBACS,SAAS,EAAE,SAAS;IAQhC;;;;;;;;;;OAUG;IACG,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC;IA+C5B;;;;;;;;OAQG;IAEG,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;IAiB1C;;;;;;;;;;OAUG;IACH,uBAAuB,IAAI,eAAe;IA8B1C;;;;;;;;;OASG;IACG,gBAAgB,CAAC,eAAe,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAYvE;;;;;;;;;OASG;IACH,kBAAkB,IAAI,UAAU;IAoChC;;;;;;;;;OASG;IACG,eAAe,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAa5D;;;;;;;;OAQG;IACG,kCAAkC,IAAI,OAAO,CAAC,IAAI,CAAC;IAYzD;;;;;;;;OAQG;IACG,yBAAyB,IAAI,OAAO,CAAC,IAAI,CAAC;IA2EhD;;;;;;;;OAQG;IACG,kCAAkC,IAAI,OAAO,CAAC,IAAI,CAAC;IAYzD;;;;;;;;OAQG;IACG,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IA+CtC;;;;;;;;;;OAUG;IACG,YAAY,CAAC,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAkCzD;;;;;;;;OAQG;IACG,kCAAkC,IAAI,OAAO,CAAC,IAAI,CAAC;IA0GzD;;;;;;;;;;;OAWG;YAGW,oBAAoB;IAuClC;;;;;;;;OAQG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAyChC;;;;;;;;OAQG;IACG,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;CA0CtC"}