Online JSDoc Generator

Purpose & User Intent: The tool generates JSDoc documentation from JavaScript and TypeScript sources. It reads source files, extracts documented declarations, and produces a structured API reference suitable for library authors, SDK teams, and open source projects. It supports TS types when present, improving accuracy of parameter descriptions and enabling precise cross-linking between modules and symbols.\n\nCore Logic & Features: The tool ingests sources, extracts JSDoc blocks, resolves symbols, and outputs in HTML, Markdown, or JSON. It supports multi-file projects, directories, and repository inputs. Advanced options include custom templates, module grouping, private member visibility, incremental generation, TypeScript type inference, and post-processing hooks for CI.\n\nInputs & Outputs: Inputs include source_paths (string or array, file paths or repo URL), language (JS/TS), output_format (html, markdown, json), template (name or content), include_private (boolean). Outputs include docs_html, docs_markdown, docs_json, and an index of modules/classes plus a searchable index.\n\nAlgorithms & Calculations: It uses AST parsing to collect symbols and JSDoc comments, associates comments to declarations, resolves module boundaries, and applies templates to produce structured docs. It validates input syntax and gracefully skips unsupported syntax while emitting placeholders for missing comments.\n\nError & Edge Cases: Handles missing or incomplete JSDoc by emitting warnings in logs and generating partial docs; handles large codebases with streaming processing; returns defaults for unspecified options; alerts on repository access failures or rate limits.\n\nIndustry/Region & Localization: Uses standard US-English code comment conventions; output templates support localized headings; no currency or region-specific data; aligns with common JS/TS documentation conventions.\n\nAssumptions & Exclusions: Assumes input is accessible code and valid for parsing; excludes live code execution docs, runtime data, or UI generation; not responsible for hosting or rendering beyond the selected output formats.