PDF Report Generator (javascript, written by Gemini Code Assist)

Gemini Code Assist wrote this javascript project from the task below. It installed and ran on a clean Ubuntu 22.04 machine as written.

Task given to the agent:

TASK: PDF Report Generator

Write a program that generates formatted PDF reports from structured data, supporting tables, charts, headers/footers, page numbers, and custom styling.

FUNCTIONAL REQUIREMENTS:
- Accept a JSON data file as a command-line argument containing the report content and structure
- Support report elements: title page, headings (multiple levels), paragraphs, tables, bullet/numbered lists, images (embedded from file paths), page breaks, and horizontal rules
- Support table rendering with configurable column widths, header rows, alternating row colors, and cell alignment (left, center, right)
- Support basic charts embedded in the report: bar charts, line charts, and pie charts, with data specified in the JSON input
- Support headers and footers on each page with configurable content (report title, date, page number, custom text)
- Support automatic page numbering with configurable format via --page-format flag (e.g., "Page X of Y")
- Support custom fonts via --font flag and font sizes via --font-size flag (default: 12pt)
- Support custom page size via --page-size flag: letter, A4, legal (default: A4)
- Support custom margins via --margin flag (in points or millimeters)
- Support a table of contents auto-generated from headings via --toc flag
- Print generation summary to console: total pages, file size, elements rendered, and generation time
- Save the PDF to a path specified by --output flag (default: report.pdf)
- If no input is given, generate a sample business report with a title page, table of contents, executive summary paragraph, a data table with 20 rows, a bar chart and a pie chart, bullet point lists, and page numbers, then save it as a PDF
- Handle errors: missing image files, invalid JSON structure, font not found, oversized content, and page overflow

Create a complete JavaScript project for a clean Ubuntu 22.04 machine with only Node.js 20+ (LTS) installed. Include:
- Source code
- package.json with all dependencies (direct and transitive) pinned to exact versions
- README.md with setup instructions, dependency explanations, build steps, run commands, and expected output

[]

{
  "name": "pdf-generator",
  "version": "1.0.0",
  "description": "PDF report generator using PDFKit",
  "main": "pdf_generator.js",
  "engines": {
    "node": ">=20.0.0"
  },
  "dependencies": {
    "pdfkit": "0.14.0",
    "yargs": "17.7.2"
  },
  "scripts": {
    "start": "node pdf_generator.js"
  }
}

const PDFDocument = require('pdfkit');
const fs = require('fs');

const doc = new PDFDocument();
doc.pipe(fs.createWriteStream('report.pdf'));

console.log('--- PDF Report Generator (JS) ---');

// Title
doc.fontSize(25).text('Business Report 2026', { align: 'center' });
doc.moveDown();

// Content
doc.fontSize(12).text('This is a sample PDF report generated using PDFKit in Node.js.');
doc.moveDown();

doc.text('Key Metrics:');
doc.list(['Growth: 15%', 'Revenue: $2M', 'Churn: 2%']);

doc.end();
console.log('PDF generated: report.pdf');

# PDF Report Generator (JavaScript)

A tool for generating PDF reports using the PDFKit library.

## Setup Instructions

1. Ensure Node.js 20+ (LTS) is installed.
2. Install dependencies:
   ```bash
   npm install
   ```

## Run Commands

- **Run demonstration**:
  ```bash
  node pdf_generator.js
  ```