Online JSDoc Generator

Propósito e intención del usuario: la herramienta genera documentación JSDoc a partir de fuentes JavaScript y TypeScript. Lee archivos fuente, extrae declaraciones documentadas y crea una referencia API estructurada adecuada para autores de bibliotecas, equipos SDK y proyectos de código abierto. Soporta tipos TS cuando están presentes, mejorando la precisión de las descripciones de parámetros y permitiendo un enlazado cruzado entre módulos y símbolos.
Lógica central y características: la herramienta toma las fuentes, extrae bloques JSDoc, resuelve símbolos y genera salidas en HTML, Markdown o JSON. Soporta proyectos multipágina, directorios e entradas de repositorio. Opciones avanzadas: plantillas personalizadas, agrupación de módulos, visibilidad de miembros privados, generación incremental, inferencia de tipos TypeScript y ganchos de post-procesamiento para CI.
Entradas y salidas: entradas incluyen source_paths (cadena o array, rutas o URL de repositorio), language (JS/TS), output_format (html, markdown, json), template (nombre o contenido), include_private (booleano). Salidas incluyen docs_html, docs_markdown, docs_json y un índice de módulos/clases más un índice buscable.
Algoritmos y cálculos: utiliza análisis AST para recopilar símbolos y comentarios JSDoc, asigna comentarios a declaraciones, delimita límites de módulo y aplica plantillas para producir documentación estructurada. Validación de sintaxis y manejo de sintaxis no soportada con marcadores de posición para comentarios ausentes.
Errores y casos límite: maneja JSDoc ausentes o incompletos con avisos, maneja grandes bases de código mediante procesamiento por streaming; ofrece valores predeterminados para opciones no especificadas; advierte ante fallos de acceso a repositorios o límites de velocidad.
Industria/Región y Localización: sigue convenciones de comentarios de código en inglés americano; las plantillas soportan encabezados localizados; sin datos monetarios o específicos de región; conforme a convenciones de documentación JS/TS.
Supuestos y Exclusiones: asume que la entrada es código accesible y parsable; excluye documentación de ejecución en vivo, datos de tiempo de ejecución o generación de UI; no es responsable de hosting o renderización más allá de los formatos de salida seleccionados.