{
  "source_file": "src/rendering/html_report.py",
  "generated_at": "2026-01-10T22:55:11.154765",
  "summary": {
    "purpose": "This file contains functions and classes for rendering an HTML report based on structured artifacts and a reusable HTML template. It handles data transformation and rendering logic, separating HTML structure and styling from Python code.",
    "exports": [
      "_escape_html",
      "_markdown_to_html",
      "close_list",
      "close_table",
      "close_blockquote",
      "process_inline",
      "_load_template",
      "_get_fallback_template",
      "HTMLReportRenderer",
      "template",
      "render",
      "_render_nav_items",
      "save",
      "_render_header",
      "_generate_summary_from_reduce",
      "_render_diagram_section",
      "_render_diagram_content",
      "_render_file_selection_section",
      "_render_metadata_section",
      "_format_bytes",
      "render_field",
      "_render_scripts"
    ],
    "imports": [
      "html",
      "json",
      "os",
      "re",
      "ast",
      "datetime",
      "typing",
      "Path",
      "ArtifactManager",
      "paths"
    ],
    "key_components": [
      {
        "name": "_escape_html",
        "type": "function",
        "description": "Safely escapes HTML special characters."
      },
      {
        "name": "_markdown_to_html",
        "type": "function",
        "description": "Converts markdown to HTML, handling various markdown elements."
      },
      {
        "name": "HTMLReportRenderer",
        "type": "class",
        "description": "Class for rendering the HTML report, encapsulating various rendering methods."
      }
    ],
    "data_structures": "None explicitly defined, but data transformation and rendering are handled.",
    "algorithms": "None explicitly defined, but data transformation logic is implied.",
    "configuration": "No explicit configuration is handled in this file.",
    "notes": "This file focuses on rendering an HTML report by transforming structured data and applying a reusable HTML template. It separates HTML structure and styling from Python code, making the HTML layout maintainable and independent of the data transformation logic."
  }
}