chore: ✏️ update CHANGELOG and module version to 0.3.0

* Documented the ability to scroll the preview pane and added a warning for rendering issues.
* Updated module version in `PesterExplorer.psd1` to 0.3.0.
* Adjusted `Get-PreviewPanel` function to improve height calculations and scrolling behavior.
* Modified markdown linting configuration for better documentation formatting.

Author: HeyItsGilbert

CHANGELOG.md

@@ -5,7 +5,18 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](http://keepachangelog.com/)
 and this project adheres to [Semantic Versioning](http://semver.org/).
 
-## Unreleased
+## [0.3.0] 2025-05-29
+
+### Added
+
+- Added the ability to scroll the preview pane on the right.
+  - A "... more" line will show if you need to scroll.
+  - This will give a warning if a panel can't completely rendered.
+  - There is a known issue that you can "scroll past" the last item, but the
+    last item will still render. You will need to scroll back up an equivalent
+    number of times. This will be future Gilbert's problem.
+
+### Changed
 
 - Move test result breakdown chart to Preview pane.
 

PesterExplorer/PesterExplorer.psd1

@@ -12,25 +12,25 @@
     RootModule = 'PesterExplorer.psm1'
 
     # Version number of this module.
-    ModuleVersion     = '0.2.0'
+    ModuleVersion = '0.3.0'
 
     # Supported PSEditions
     # CompatiblePSEditions = @()
 
     # ID used to uniquely identify this module
-    GUID              = '1b8311c2-23fd-4a4c-90de-e17cfc306b04'
+    GUID = '1b8311c2-23fd-4a4c-90de-e17cfc306b04'
 
     # Author of this module
-    Author            = 'Gilbert Sanchez'
+    Author = 'Gilbert Sanchez'
 
     # Company or vendor of this module
-    CompanyName       = 'HeyItsGilbert'
+    CompanyName = 'HeyItsGilbert'
 
     # Copyright statement for this module
-    Copyright         = '(c) Gilbert Sanchez. All rights reserved.'
+    Copyright = '(c) Gilbert Sanchez. All rights reserved.'
 
     # Description of the functionality provided by this module
-    Description       = 'A TUI to explore Pester results.'
+    Description = 'A TUI to explore Pester results.'
 
     # Minimum version of the PowerShell engine required by this module
     PowerShellVersion = '7.0'
@@ -51,13 +51,13 @@
     # ProcessorArchitecture = ''
 
     # Modules that must be imported into the global environment prior to importing this module
-    RequiredModules   = @(
+    RequiredModules = @(
         @{
-            ModuleName    = 'Pester'
+            ModuleName = 'Pester'
             ModuleVersion = '5.0.0'
         },
         @{
-            ModuleName    = 'PwshSpectreConsole'
+            ModuleName = 'PwshSpectreConsole'
             ModuleVersion = '2.3.0'
         }
     )
@@ -81,13 +81,13 @@
     FunctionsToExport = '*'
 
     # Cmdlets to export from this module, for best performance, do not use wildcards and do not delete the entry, use an empty array if there are no cmdlets to export.
-    CmdletsToExport   = '*'
+    CmdletsToExport = '*'
 
     # Variables to export from this module
     VariablesToExport = '*'
 
     # Aliases to export from this module, for best performance, do not use wildcards and do not delete the entry, use an empty array if there are no aliases to export.
-    AliasesToExport   = '*'
+    AliasesToExport = '*'
 
     # DSC resources to export from this module
     # DscResourcesToExport = @()
@@ -99,12 +99,12 @@
     # FileList = @()
 
     # Private data to pass to the module specified in RootModule/ModuleToProcess. This may also contain a PSData hashtable with additional module metadata used by PowerShell.
-    PrivateData       = @{
+    PrivateData = @{
 
         PSData = @{
 
             # Tags applied to this module. These help with module discovery in online galleries.
-            Tags                     = @(
+            Tags = @(
                 'Windows',
                 'Linux',
                 'macOS',
@@ -116,13 +116,13 @@
             )
 
             # A URL to the license for this module.
-            LicenseUri               = 'https://github.com/HeyItsGilbert/PesterExplorer/blob/main/LICENSE'
+            LicenseUri = 'https://github.com/HeyItsGilbert/PesterExplorer/blob/main/LICENSE'
 
             # A URL to the main website for this project.
-            ProjectUri               = 'https://github.com/HeyItsGilbert/PesterExplorer'
+            ProjectUri = 'https://github.com/HeyItsGilbert/PesterExplorer'
 
             # A URL to an icon representing this module.
-            IconUri                  = 'https://raw.githubusercontent.com/HeyItsGilbert/PesterExplorer/main/images/icon.png'
+            IconUri = 'https://raw.githubusercontent.com/HeyItsGilbert/PesterExplorer/main/images/icon.png'
 
             # ReleaseNotes of this module
             ReleaseNotes = 'https://github.com/HeyItsGilbert/PesterExplorer/blob/main/CHANGELOG.md'

PesterExplorer/PesterExplorer.psm1

@@ -1,9 +1,8 @@
 #require -Module PwshSpectreConsole
 # Dot source public/private functions
-$classes = @(Get-ChildItem -Path (Join-Path -Path $PSScriptRoot -ChildPath 'Classes/*.ps1') -Recurse -ErrorAction Stop)
 $public = @(Get-ChildItem -Path (Join-Path -Path $PSScriptRoot -ChildPath 'Public/*.ps1')  -Recurse -ErrorAction Stop)
 $private = @(Get-ChildItem -Path (Join-Path -Path $PSScriptRoot -ChildPath 'Private/*.ps1') -Recurse -ErrorAction Stop)
-foreach ($import in @($classes + $public + $private)) {
+foreach ($import in @($public + $private)) {
     try {
         . $import.FullName
     } catch {

PesterExplorer/Private/Get-PreviewPanel.ps1

@@ -1,3 +1,4 @@
+# spell-checker:ignore Renderable
 function Get-PreviewPanel {
     <#
     .SYNOPSIS
@@ -193,7 +194,7 @@ function Get-PreviewPanel {
         Write-Debug "Reducing Preview List: $($results.Count), ScrollPosition: $scrollPosition"
 
         # Determine the height of each item in the results
-        $totalHeight = 0
+        $totalHeight = 3
         $reducedList = @()
         if($ScrollPosition -ne 0) {
             # If the scroll position is not zero, add a "back" item
@@ -203,9 +204,17 @@ function Get-PreviewPanel {
             $itemHeight = Get-SpectreRenderableSize $results[$i]
             $totalHeight += $itemHeight.Height
             if ($totalHeight -gt $PreviewHeight) {
+                if($i -eq $scrollPosition) {
+                    # If the first item already exceeds the height, stop here
+                    Write-Debug "First item exceeds preview height. Stopping."
+                    $reducedList += ":police_car_light:The next item is too large to display! Please resize your terminal.:police_car_light:" |
+                        Format-SpectreAligned -HorizontalAlignment Center -VerticalAlignment Middle |
+                        Format-SpectrePanel -Header ":police_car_light: [red]Warning[/]" -Color 'red' -Border Double
+                    break
+                }
                 # If the total height exceeds the preview height, stop adding items
                 Write-Debug "Total height exceeded preview height. Stopping at item $i."
-                $reducedList += "[blue]...more. Switch to Panel and scroll with keys.[/]"
+                $reducedList += "[blue]...more.[/] [grey]Switch to Panel and scroll with keys.[/]"
                 break
             }
             $reducedList += $results[$i]

PesterExplorer/Public/Get-PesterTestView.ps1

@@ -1,4 +1,6 @@
 {
     // These docs are autogenerated and this is the expected format.
-    "MD025": false
+    "MD025": false,
+    "MD022": false,
+    "MD040": false
 }

docs/.markdownlint.jsonc

@@ -17,10 +17,10 @@ Show-PesterResultTree [[-PesterResult] <Run>] [-ProgressAction <ActionPreference
 ```
 
 ## DESCRIPTION
-This function takes a Pester result object and formats it into a tree structure
-using Spectre.Console.
-It is useful for visualizing the structure of Pester results
-such as runs, containers, blocks, and tests.
+This function takes a Pester result object and formats it into a tree
+structure using Spectre.Console.
+It is useful for visualizing the structure
+of Pester results such as runs, containers, blocks, and tests.
 
 ## EXAMPLES