psake.ps1

# psake build script for PowerShellLocalization
# See https://psake.dev/ for syntax and usage
#requires -Version 7
# spell-checker:ignore Markdig
Properties {
  $script:extensionName = 'PowerShellLocalization'
  $script:vsixPattern = '*.vsix'
  $script:outDir = 'out'
  $script:scriptDir = $PSScriptRoot

  $script:PesterConfiguration = New-PesterConfiguration
  $script:PesterConfiguration.Output.CIFormat = 'Auto'
  $script:PesterConfiguration.Output.Verbosity = 'Detailed'
  $script:PesterConfiguration.Run.Path = ".\tests\"
  $script:PesterConfiguration.Run.PassThru = $true
}

FormatTaskName {
  param($taskName)
  Write-Host 'Task: ' -ForegroundColor Cyan -NoNewline
  Write-Host $taskName.ToUpper() -ForegroundColor Blue
}

Task Default -Depends Test
Task Test -Depends Lint, VscodeTest, Pester

Task Clean -Description "Clean the output directory" {
  Write-Host '🧹 Cleaning previous builds...'
  if (Test-Path $script:outDir) {
    Remove-Item -Recurse -Force $script:outDir
    Write-Host "✅ Cleaned '$script:outDir' directory"
  }
  $vsixFiles = Get-ChildItem -Path $script:scriptDir -Filter $script:vsixPattern -ErrorAction SilentlyContinue
  if ($vsixFiles) {
    $vsixFiles | Remove-Item -Force
    Write-Host '✅ Cleaned previous .vsix files'
  }
}

Task InstallDependencies -Description "Install project dependencies" {
  Write-Host '📥 Installing dependencies...'
  yarn install
  Write-Host '✅ Dependencies installed successfully'
}

Task Compile -Depends InstallDependencies -Description "Compile TypeScript files" {
  Write-Host '🔨 Compiling TypeScript...'
  yarn run compile
  Write-Host '✅ TypeScript compiled successfully'
}

Task Lint -Depends InstallDependencies -Description "Lint the source code" {
  Write-Host '🔍 Running linter...'
  try {
    yarn run lint
    Write-Host '✅ Linting passed'
  } catch {
    Write-Warning '⚠️  Linting issues found, but continuing with packaging...'
  }
}

Task VscodeTest -Depends InstallDependencies -Description "Run VS Code tests" {
  Write-Host '🔍 Running VS Code tests...'
  try {
    yarn run vscode:test
    Write-Host '✅ VS Code tests passed'
  } catch {
    Write-Error '❌ VS Code tests failed. Please fix the issues before packaging.'
    exit 1
  }
}

Task Pester -Description "Run Pester tests" {
  Write-Host '🧪 Running Pester tests...'
  try {
    $results = Invoke-Pester -Configuration $script:PesterConfiguration
    if ($results.FailedCount -gt 0) {
      Write-Error '❌ Pester tests failed. Please fix the issues before packaging.'
      exit 1
    }
    Write-Host '✅ Pester tests passed'
  } catch {
    Write-Error '❌ Pester tests failed. Please fix the issues before packaging.'
    $PSCmdlet.ThrowTerminatingError($_)
    exit 1
  }
}

Task Package -Depends Clean, Compile, Test -Description "Package the extension" {
  Write-Host '📦 Packaging extension...'
  yarn package
  $vsixFiles = Get-ChildItem -Path $script:outDir -Filter $script:vsixPattern | Sort-Object LastWriteTime -Descending
  if (-not $vsixFiles) {
    throw '❌ No .vsix file was generated'
  }
  $script:vsixFile = $vsixFiles[0].FullName
  Write-Host "✅ Extension packaged successfully: $($vsixFiles[0].Name)"
}

Task Install -Depends Package -Description "Install the extension in VS Code" {
  Write-Host '🚀 Installing extension in VS Code...'
  $command = @('code', '--install-extension', $script:vsixFile, '--force')
  & $command
  Write-Host '✅ Extension installed successfully!'
  Write-Host '🔄 Please reload VS Code to activate the extension.'
}

Task CI -Depends Package -Description "Run CI task for GitHub Actions" {
  Write-Host '🏗️ Running CI task for GitHub Actions...'
  if ($env:GITHUB_OUTPUT) {
    Write-Host 'GITHUB_OUTPUT environment variable is set. Writing output...'
    $outputFile = $env:GITHUB_OUTPUT
  } else {
    $outputFile = (New-TemporaryFile).FullName
    Write-Warning "GITHUB_OUTPUT environment variable is not set. Writing to temp file: $outputFile"
  }
  $vsixFiles = Get-ChildItem -Path $script:outDir -Filter $script:vsixPattern | Sort-Object LastWriteTime -Descending
  if (-not $vsixFiles) {
    throw '❌ No .vsix file was generated'
  }
  $vsixFile = $vsixFiles[0].FullName
  Add-Content -Path $outputFile -Value "vsix_path=$vsixFile"
  Add-Content -Path $outputFile -Value "vsix_name=$($vsixFiles[0].Name)"
  Write-Host "::notice::VSIX path: $vsixFile"
  Write-Host "::notice::VSIX name: $($vsixFiles[0].Name)"
  # Output the version
  $version = (Get-Content -Path "$PSScriptRoot/package.json" | ConvertFrom-Json).version
  Write-Host "::notice::VSIX version: $version"
  Add-Content -Path $outputFile -Value "vsix_version=$version"
  $ChangeLogPath = Join-Path -Path "$PSScriptRoot" -Child 'CHANGELOG.md'
  $md = ConvertFrom-Markdown $ChangeLogPath
  $content = Get-Content $ChangeLogPath
  # Get level 2 headers
  $headers = $md.Tokens | Where-Object { $_.GetType() -eq [Markdig.Syntax.HeadingBlock] -and $_.Level -eq 2 }
  # Grab the first header line
  $firstHeaderLine = $headers[0].Line

  # The header is made up of a few component. We have to loop and convert each to string and join them
  $title = $content[$firstHeaderLine].Trim("#")
  if ($headers.Count -eq 1) {
    # If there is only one header, then the content is from the first header to the end of the file
    $body = $content[$($firstHeaderLine + 1)..($content.Count - 1)] -join "`n"
  } else {
    $secondHeaderLine = $headers[1].Line
    # Content is the lines between the first and second header
    $body = $content[$($firstHeaderLine + 1)..$($secondHeaderLine - 1)] -join "`n"
  }
  Write-Host "::notice::Changelog title: $title"
  Write-Host "::notice::Changelog body: $body"
  Add-Content -Path $outputFile -Value "changelog_title=$title"
  # Multiline is tricky: https://docs.github.com/en/actions/reference/workflows-and-actions/workflow-commands#example-of-a-multiline-string
  $EOF = (New-Guid).Guid
  Add-Content -Path $outputFile -Value "changelog_body<<$EOF"
  Add-Content -Path $outputFile -Value "$body"
  Add-Content -Path $outputFile -Value "$EOF"
}