Codebase Overview

The Mind Map Wizard codebase is structured to separate core application logic from external dependencies and AI-specific functionalities. The primary language used across the application logic is JavaScript, augmented by well-established third-party libraries for common tasks.

The codebase is organized into the following main components:

scripts/mmw.js

This file serves as the main entry point for the client-side application logic and user interface interactions. Its core responsibilities include:

• Application Initialization: Setting up initial UI states and event listeners when the DOM is loaded.
• UI Interactions: Handling toggles for the header, left sidebar, and various navigation elements. This includes dynamic class assignments to control visibility and layout.
• Keyboard Shortcuts: Implementing global keyboard shortcuts for efficient navigation and interaction with the mind map and application features (e.g., search, edit, download).
• History Management Utilities: Providing utility functions for displaying and formatting mind map history entries in the UI, such as getTimeAgo and formatDateLeftSidebar. It also manages general popups like the "Clear History" confirmation.
• General Popup Management: Functions for displaying and managing application-wide popups (e.g., license information).
• URL Parameter Handling: Initial processing of URL parameters to determine whether to load an existing mind map or prepare for a new generation.
• Mind Map Rendering: Contains the renderMindmap and renderMindmapInternal functions, which are responsible for taking Markdown content and rendering it into an interactive mind map using the markmap.js library. This includes error handling for the rendering process.

scripts/new.js

This file encapsulates the AI integration, API key management, model selection, mind map generation requests, and all functionalities related to editing and downloading mind maps. Its main responsibilities are:

• AI Integration: The generateMindmap function orchestrates the communication with the OpenRouter AI API. It constructs the prompt, sends the request, and processes the AI's Markdown response.
• OpenRouter API Key Management: Manages the storage (encrypted in local storage), retrieval, and validation of the OpenRouter API key. It includes logic for prompting the user for an API key when missing or invalid, and a dedicated management popup.
• Model Selection: Handles fetching available AI models from OpenRouter, caching them, filtering them, and allowing users to select their preferred model for generation.
• Mind Map Generation Requests: Formulates and sends fetch requests to the OpenRouter API, handling various API response statuses (e.g., 401 for invalid keys, 429 for rate limits).
• Markdown Formatting: Processes the raw Markdown received from the AI, standardizing its structure and cleaning potential inconsistencies to ensure proper rendering by markmap.js.
• Downloading Functionality: Implements the DownloadHandler module, which provides methods to export the current mind map in various formats such as Markdown, SVG, PDF, and JPG. This module handles the conversion from SVG to image formats and triggers the download.
• Edit Mode Logic: Manages the toggling of the mind map editing interface, allowing users to view and modify the raw Markdown content, and saving those changes back to the mind map and local history.
• Specific History Management: Provides functions for saving newly generated mind maps, updating existing mind maps, and deleting mind maps from local storage.
• Search Functionality: Implements the search overlay and filtering logic for finding saved mind maps.
• URL Parameter Handling: Processes specific URL parameters like q (for direct query generation) and id (for loading a specific mind map from history).

scripts/libraries/

This folder contains third-party, minified JavaScript libraries that Mind Map Wizard relies on for enhanced functionality, but which are not part of its core logic:

• jquery-3.7.1.min.js: A fast, small, and feature-rich JavaScript library providing a simplified API for DOM traversal and manipulation, event handling, animation, and Ajax.
• qrcode.min.js: A library specifically designed for generating QR codes, likely for features like sharing or linking, though its direct use is not immediately apparent in the main JS files provided.

This architectural separation allows for clearer development boundaries, easier maintenance, and the ability to update individual components or libraries without affecting the entire system.