builddocs

import { build } from 'builddocs'; import * as fs from 'fs'; import * as path from 'path'; // Simulate a source file with getdocs-ts comments const sourceCode = ` /** * Represents a point in 2D space. * @class * @property {number} x - The X coordinate. * @property {number} y - The Y coordinate. */ class Point { /** * Creates a new Point instance. * @param {number} x Initial X coordinate. * @param {number} y Initial Y coordinate. */ constructor(x, y) { this.x = x; this.y = y; } /** * Calculates the distance from the origin (0,0). * @returns {number} The distance. */ distance() { return Math.sqrt(this.x ** 2 + this.y ** 2); } } export { Point }; `; const tempDir = path.join(process.cwd(), 'temp-docs'); if (!fs.existsSync(tempDir)) { fs.mkdirSync(tempDir); } const tempSourceFile = path.join(tempDir, 'point.js'); fs.writeFileSync(tempSourceFile, sourceCode); const config = { name: 'GeometryLib', filename: tempSourceFile, mainText: ` # Geometry Library Documentation This document describes the core components of our geometry library. @Point `, anchorPrefix: 'geom.', allowUnresolvedTypes: true, env: { currentDate: new Date().toLocaleDateString() } }; try { const htmlOutput = build(config); const outputFile = path.join(tempDir, 'index.html'); fs.writeFileSync(outputFile, htmlOutput); console.log(`Documentation generated successfully to ${outputFile}`); console.log(`\n--- Generated HTML ---\n${htmlOutput.substring(0, 500)}...`); } catch (error) { console.error('Error generating documentation:', error); } finally { // Clean up temporary files fs.unlinkSync(tempSourceFile); fs.rmdirSync(tempDir); }