Private/Show-SectionSlide.ps1
|
function Show-SectionSlide { <# .SYNOPSIS Renders a section slide with medium figlet text. .DESCRIPTION Displays a full-screen section slide containing a ## heading rendered as medium figlet text. Section slides are centered and use the configured sectionFont setting. .PARAMETER Slide The slide object containing the content to render. .PARAMETER Settings The presentation settings hashtable containing colors, fonts, and styling options. .EXAMPLE Show-SectionSlide -Slide $slideObject -Settings $settings .NOTES Section slides should contain only a single ## heading with no other content. #> [CmdletBinding()] param( [Parameter(Mandatory = $true)] [PSCustomObject]$Slide, [Parameter(Mandatory = $true)] [hashtable]$Settings ) begin { Write-Verbose "Rendering section slide #$($Slide.Number)" } process { try { # Extract the ## heading text if ($Slide.Content -match '^##\s+(.+)$') { $sectionText = $Matches[1].Trim() Write-Verbose " Section: $sectionText" } else { throw "Section slide does not contain a valid ## heading" } # Clear the screen Clear-Host # Convert colors to Spectre.Console.Color $figletColor = $null if ($Settings.foreground) { $colorName = (Get-Culture).TextInfo.ToTitleCase($Settings.foreground.ToLower()) Write-Verbose " Figlet color: $colorName" try { $figletColor = [Spectre.Console.Color]::$colorName } catch { Write-Warning "Invalid color '$($Settings.foreground)', using default" } } $borderColor = $null if ($Settings.border) { $borderColorName = (Get-Culture).TextInfo.ToTitleCase($Settings.border.ToLower()) Write-Verbose " Border color: $borderColorName" try { $borderColor = [Spectre.Console.Color]::$borderColorName } catch { Write-Warning "Invalid border color '$($Settings.border)', using default" } } # Determine border style $borderStyle = 'Rounded' if ($Settings.borderStyle) { $borderStyle = (Get-Culture).TextInfo.ToTitleCase($Settings.borderStyle.ToLower()) Write-Verbose " Border style: $borderStyle" } # Create figlet text object with small font if available $smallFontPath = Join-Path $PSScriptRoot '../Fonts/small.flf' if (Test-Path $smallFontPath) { $figlet = [Spectre.Console.FigletText]::new([Spectre.Console.FigletFont]::Load($smallFontPath), $sectionText) } else { $figlet = [Spectre.Console.FigletText]::new($sectionText) } $figlet.Justification = [Spectre.Console.Justify]::Center if ($figletColor) { $figlet.Color = $figletColor } # Create panel with internal padding calculated to fill terminal height # Account for rendering behavior to prevent scrolling $windowHeight = $Host.UI.RawUI.WindowSize.Height - 1 $windowWidth = $Host.UI.RawUI.WindowSize.Width # Set panel to expand and measure what we need to fill $panel = [Spectre.Console.Panel]::new($figlet) $panel.Expand = $true # Add border style first if ($borderStyle) { $panel.Border = [Spectre.Console.BoxBorder]::$borderStyle } # Measure figlet with horizontal padding already applied # Horizontal padding is 4 on each side = 8 total $contentWidth = $windowWidth - 8 $figletSize = Get-SpectreRenderableSize -Renderable $figlet -ContainerWidth $contentWidth $actualFigletHeight = $figletSize.Height # Calculate vertical padding needed # Total height = border (2) + top padding + content + bottom padding $borderHeight = 2 $remainingSpace = $windowHeight - $actualFigletHeight - $borderHeight $topPadding = [math]::Max(0, [math]::Ceiling($remainingSpace / 2.0)) $bottomPadding = [math]::Max(0, $remainingSpace - $topPadding) $panel.Padding = [Spectre.Console.Padding]::new(4, $topPadding, 4, $bottomPadding) # Border style already added above if ($borderStyle) { $panel.Border = [Spectre.Console.BoxBorder]::$borderStyle } # Add border color if ($borderColor) { $panel.BorderStyle = [Spectre.Console.Style]::new($borderColor) } # Render panel Out-SpectreHost $panel } catch { $errorRecord = [System.Management.Automation.ErrorRecord]::new( $_.Exception, 'SectionSlideRenderFailed', [System.Management.Automation.ErrorCategory]::InvalidOperation, $Slide ) $PSCmdlet.ThrowTerminatingError($errorRecord) } } end { Write-Verbose "Section slide rendered" } } |