✨ [feat] Enhances ANSI art and updates module

Updates module version and improves ANSI art rendering in welcome scripts.

- 🎨 Enhances ANSI art rendering in `welcome-Bears2.ps1`:
  - Reduces `$repeatCount` from 6 to 3, likely optimizing the visual layout.
  - Introduces a second row of bears with a shifted color palette (`($repeat + 3) % $colors.Count`), adding visual variety. 🐻🌈
- 🎨 Improves ANSI art generation in `welcome-cats.ps1`:
  - Introduces a loop to generate two rows of cats. 🐱
  - Modifies color selection to create a different color pattern for each row.
  - Uses `$boldon` to make the cats bold.
- 🧹 Updates module manifest:
  - Bumps `ModuleVersion` from `'2025.10.13.1043'` to `'2025.10.13.1447'`, reflecting code changes 🔢
  - Updates the corresponding `ReleaseNotes` in the module manifest.
- 📝 Adds new scripts and updates documentation:
  - Introduces `Format-ColorScripts.ps1` to format PowerShell scripts using `Invoke-Formatter`, improving code consistency. ✍️
  - Updates `package.json` to include a command for formatting scripts: `"scripts:format": "pwsh -NoProfile -File ./scripts/Format-ColorScripts.ps1"`. ⚙️
  - Updates `Development.md` with documentation for the new script conversion options and the format script. 📖
- 👷 Updates dependencies:
  - Upgrades `markdown-link-check` from `3.12.2` to `3.14.1` in `package.json` and `package-lock.json`, likely to address bugs or improve link checking functionality. 🔗

Signed-off-by: Nick2bad4u <20943337+Nick2bad4u@users.noreply.github.com>

Author: Nick2bad4u

ColorScripts-Enhanced/ColorScripts-Enhanced.psd1

@@ -11,7 +11,7 @@
     RootModule = 'ColorScripts-Enhanced.psm1'
 
     # Version number of this module.
-    ModuleVersion = '2025.10.13.1043'
+    ModuleVersion = '2025.10.13.1447'
 
     # Supported PSEditions
     CompatiblePSEditions = @('Desktop', 'Core')
@@ -155,7 +155,7 @@
 
             # ReleaseNotes of this module
             ReleaseNotes = @'
-Version 2025.10.13.1043:
+Version 2025.10.13.1447:
 - Enhanced caching system with OS-wide cache in AppData
 - 6-19x performance improvement
 - Cache stored in centralized location

ColorScripts-Enhanced/Scripts/welcome-Bears2.ps1

@@ -17,10 +17,12 @@ $bearLines = @(
 $colors = @(31, 33, 32, 34, 35, 37)  # Red, Yellow, Green, Blue, Magenta, White
 
 # Number of repeats
-$repeatCount = 6
+$repeatCount = 3
 
 # Build the output
 $output = ""
+
+# First row (3 bears)
 for ($lineIdx = 0; $lineIdx -lt $bearLines.Count; $lineIdx++) {
     $line = ""
     for ($repeat = 0; $repeat -lt $repeatCount; $repeat++) {
@@ -30,4 +32,14 @@ for ($lineIdx = 0; $lineIdx -lt $bearLines.Count; $lineIdx++) {
     $output += "$line`n"
 }
 
+# Second row (3 bears)
+for ($lineIdx = 0; $lineIdx -lt $bearLines.Count; $lineIdx++) {
+    $line = ""
+    for ($repeat = 0; $repeat -lt $repeatCount; $repeat++) {
+        $color = $colors[($repeat + 3) % $colors.Count]
+        $line += "$esc[${color}m$boldon$($bearLines[$lineIdx])$reset"
+    }
+    $output += "$line`n"
+}
+
 Write-Host "$reset$output"

ColorScripts-Enhanced/Scripts/welcome-cats.ps1

@@ -17,13 +17,16 @@ $colors = @(31, 33, 32, 34, 35, 36)  # Red, Yellow, Green, Blue, Magenta, Cyan
 
 # Build the output
 $output = ""
-foreach ($line in $catLines) {
-    $coloredLine = ""
-    for ($i = 0; $i -lt 6; $i++) {
-        $color = $colors[$i]
-        $coloredLine += "$esc[${color}m$line$reset"
+for ($row = 0; $row -lt 2; $row++) {
+    foreach ($line in $catLines) {
+        $coloredLine = ""
+        for ($i = 0; $i -lt 3; $i++) {
+            $colorIdx = ($row * 3 + $i) % $colors.Count
+            $color = $colors[$colorIdx]
+            $coloredLine += "$esc[${color}m$boldon$line$reset"
+        }
+        $output += "$coloredLine`n"
     }
-    $output += "$coloredLine`n"
 }
 
-Write-Host "$reset$boldon$output"
+Write-Host "$reset$output"

docs/Development.md

@@ -38,8 +38,11 @@ We publish a set of convenience commands in `package.json` so you can run common
 | `npm run docs:update-counts`                        | Call `Update-DocumentationCounts.ps1` to sync README markers.                      |
 | `npm run package:metadata -- --PackagePath <nupkg>` | Run `Update-NuGetPackageMetadata.ps1` to embed README/license/icon before pushing. |
 | `npm run scripts:convert -- <ansi-file>`            | Convert ANSI artwork via the Node-based converter.                                 |
+| `npm run scripts:convert:ps -- <ansi-file>`         | Convert ANSI artwork using the PowerShell helper script.                           |
+| `npm run scripts:convert:advanced`                  | Launch the advanced ANSI conversion workflow in PowerShell.                        |
 | `npm run scripts:split -- <file> [options]`         | Split tall ANSI or PowerShell scripts into manageable slices.                      |
 | `npm run scripts:test-all`                          | Run `Test-AllColorScripts.ps1` across the entire library.                          |
+| `npm run scripts:format`                            | Run Invoke-Formatter across every colorscript in `ColorScripts-Enhanced/Scripts`.  |
 | `npm run release:notes`                             | Generate unreleased release notes using git-cliff (PowerShell Gallery snippet).    |
 | `npm run release:notes:latest`                      | Generate release notes for the most recent tag.                                    |
 | `npm run release:verify`                            | Ensure CHANGELOG.md aligns with the manifest version and git-cliff output.         |

package-lock.json

@@ -27,6 +27,7 @@
     "scripts:convert:ps": "pwsh -NoProfile -File ./Convert-AnsiToColorScript.ps1",
     "scripts:convert:advanced": "pwsh -NoProfile -File ./Convert-AnsiToColorScript-Advanced.ps1",
     "scripts:split": "node ./scripts/Split-AnsiFile.js",
+    "scripts:format": "pwsh -NoProfile -File ./scripts/Format-ColorScripts.ps1",
     "scripts:count": "pwsh -NoProfile -File ./Get-ColorScriptCount.ps1",
     "scripts:test-all": "pwsh -NoProfile -File ./ColorScripts-Enhanced/Test-AllColorScripts.ps1",
     "release:notes": "pwsh -NoProfile -File ./scripts/Generate-ReleaseNotes.ps1 -Unreleased -OutputPath ./dist/PowerShellGalleryReleaseNotes.md -StripHeader",
@@ -64,6 +65,6 @@
     "node-ansiparser": "^2.2.1"
   },
   "devDependencies": {
-    "markdown-link-check": "^3.12.2"
+    "markdown-link-check": "^3.14.1"
   }
 }

package.json

@@ -0,0 +1,43 @@
+#Requires -Version 5.1
+
+[CmdletBinding(SupportsShouldProcess = $true)]
+param(
+    [Parameter()]
+    [string]$Path = (Join-Path -Path (Split-Path -Parent $PSScriptRoot) -ChildPath 'ColorScripts-Enhanced\Scripts')
+)
+
+Set-StrictMode -Version Latest
+$ErrorActionPreference = 'Stop'
+
+$resolvedPath = Resolve-Path -LiteralPath $Path -ErrorAction Stop
+$files = Get-ChildItem -Path $resolvedPath -Filter '*.ps1' -File -Recurse | Sort-Object FullName
+
+if (-not $files) {
+    Write-Host "No PowerShell scripts found under $resolvedPath." -ForegroundColor Yellow
+    return
+}
+
+$utf8NoBom = New-Object System.Text.UTF8Encoding($false)
+$formattedCount = 0
+$skippedCount = 0
+
+foreach ($file in $files) {
+    $original = Get-Content -LiteralPath $file.FullName -Raw
+    if ([string]::IsNullOrWhiteSpace($original)) {
+        $skippedCount++
+        continue
+    }
+    $formatted = Invoke-Formatter -ScriptDefinition $original
+
+    if ($formatted -ne $original) {
+        if ($PSCmdlet.ShouldProcess($file.FullName, 'Apply Invoke-Formatter output')) {
+            [System.IO.File]::WriteAllText($file.FullName, $formatted, $utf8NoBom)
+            $formattedCount++
+        }
+    }
+    else {
+        $skippedCount++
+    }
+}
+
+Write-Host "Formatted $formattedCount file(s); $skippedCount already compliant." -ForegroundColor Green