Authoring Rules

• Set theme fonts explicitly. Do not rely on PowerPoint defaults if typography matters.
• Use autoFontSize, calcTextBox, and related helpers to size text boxes; do not use PptxGenJS fit or autoFit.
• Use bullet options, not literal • characters.
• Use imageSizingCrop or imageSizingContain instead of PptxGenJS built-in image sizing.
• Use latexToSvgDataUri() for equations and codeToRuns() for syntax-highlighted code blocks.
• Prefer native PowerPoint charts for simple bar/line/pie/histogram style visuals so reviewers can edit them later.
• For charts or diagrams that PptxGenJS cannot express well, render SVG externally and place the SVG in the slide.
• Include both warnIfSlideHasOverlaps(slide, pptx) and warnIfSlideElementsOutOfBounds(slide, pptx) in the submitted JavaScript whenever you generate or substantially edit slides.
• Fix all unintentional overlap and out-of-bounds warnings before delivering. If an overlap is intentional, leave a short code comment near the relevant element.

Recreate Or Edit Existing Slides

• Render the source deck or reference PDF first so you can compare slide geometry visually.
• Match the original aspect ratio before rebuilding layout.
• Preserve editability where possible: text should stay text, and simple charts should stay native charts.
• If a reference slide uses raster artwork, use ensure_raster_image.py to generate debug PNGs from vector or odd image formats before placing them.

Validation Commands

Examples below assume you copied the needed scripts into the working directory. If not, invoke the same script paths relative to this skill folder.

# Render slides to PNGs for review
python3 scripts/render_slides.py deck.pptx --output_dir rendered

# Build a montage for quick scanning
python3 scripts/create_montage.py --input_dir rendered --output_file montage.png

# Check for overflow beyond the original slide canvas
python3 scripts/slides_test.py deck.pptx

# Detect missing or substituted fonts
python3 scripts/detect_font.py deck.pptx --json

Load references/pptxgenjs-helpers.md if you need the helper API summary or dependency details.