action.yml

name: 'HTML Preview'
author: 'Pavitra Golchha | @pavi2410'
description: 'Upload preview artifacts for HTML files and generated sites'
inputs:
  upload:
    description: 'Upload behavior; auto uses a raw upload for a single discovered file and falls back to an archive for multi-file previews'
    required: false
    default: 'auto'
  html_file:
    description: 'The entry HTML file to preview, relative to site_root'
    required: true
    default: 'index.html'
  site_root:
    description: 'The root directory used for resolving the entry HTML file and related assets/pages'
    required: false
    default: '.'
  archive_name:
    description: 'Optional artifact name override for archived uploads; ignored for single-file raw uploads'
    required: false
  retention_days:
    description: 'Artifact retention in days, or 0 to use the repository default'
    required: false
    default: '0'
  job_summary:
    description: 'Prints a job summary with the link'
    required: false
    default: true
outputs:
  url:
    description: 'The primary preview URL for this action run'
  artifact_url:
    description: 'The uploaded artifact URL for this action run'
  artifact_id:
    description: 'The uploaded artifact ID for this action run'
  artifact_name:
    description: 'The uploaded artifact name for this action run'
  discovered_files_count:
    description: 'The number of files discovered for the preview payload'
  skipped_references_count:
    description: 'The number of references skipped during discovery'
  result_json:
    description: 'JSON object describing the preview artifact, upload resolution, and discovery counts'
  comment_body:
    description: 'Markdown text that can be forwarded to a PR comment action'
runs:
  using: 'node24'
  main: 'dist/index.mjs'
branding:
  color: 'orange'
  icon: 'eye'