✨ [feat] Enhances module with new scripts and features

Adds new color scripts and enhances module functionalities.

- 🎨 Adds 27 new color scripts, expanding the collection and artistic diversity.
 - The scripts cover a range of themes like cosmic mandalas, crystal lattices, and psychedelic vortexes.
- ⚡ Improves performance by optimizing the caching system.
 - The module now includes 222 colorscripts, up from 195.
- 📝 Updates documentation to reflect the increased number of color scripts and new features.
- 👷 Modifies the publish workflow to consolidate validation and publishing into a single job.
 - This change simplifies the release process and reduces redundancy.
 - ➕ Adds a `ReturnText` parameter to `Show-ColorScript`, allowing the rendered output to be captured as text.

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

Author: Nick2bad4u

.github/workflows/publish.yml

@@ -40,11 +40,16 @@ permissions:
   contents: write
 
 jobs:
-  validate:
-    name: Validate module
+  validate-and-publish:
+    name: Validate and Publish
     runs-on: windows-latest
-    outputs:
-      version: ${{ steps.manifest.outputs.version }}
+    env:
+      PSGALLERYAPIKEY: ${{ secrets.PSGALLERYAPIKEY }}
+      NUGETAPIKEY: ${{ secrets.NUGETAPIKEY }}
+      PACKAGES_TOKEN: ${{ secrets.PACKAGES_TOKEN }}
+      PUBLISH_TO_NUGET_INPUT: ${{ github.event.inputs.publishToNuGet }}
+      PUBLISH_TO_GITHUB_INPUT: ${{ github.event.inputs.publishToGitHub }}
+      CREATE_RELEASE_INPUT: ${{ github.event.inputs.createRelease }}
     steps:
       - name: Harden the runner (Audit all outbound calls)
         uses: step-security/harden-runner@f4a75cfd619ee5ce8d5b864b0d183aff3c69b55a # v2.13.1
@@ -145,57 +150,17 @@ jobs:
               }
           }
 
-      - name: Upload module artifact
-        uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4.6.2
-        with:
-          name: module-source
-          path: ColorScripts-Enhanced/
-
-  create-release:
-    name: Create GitHub Release
-    needs: validate
-    runs-on: ubuntu-latest
-    steps:
-      - name: Harden the runner (Audit all outbound calls)
-        uses: step-security/harden-runner@f4a75cfd619ee5ce8d5b864b0d183aff3c69b55a # v2.13.1
-        with:
-          egress-policy: audit
-
-      - name: Checkout
-        uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
-
-      - name: Create Release
+      - name: Create GitHub Release
+        if: ${{ github.event_name != 'workflow_dispatch' || env.CREATE_RELEASE_INPUT != 'false' }}
         uses: ncipollo/release-action@2c591bcc8ecdcd2db72b97d6147f871fcd833ba5 # v1.14.0
         with:
-          tag: v${{ needs.validate.outputs.version }}
-          name: Release v${{ needs.validate.outputs.version }}
+          tag: v${{ steps.manifest.outputs.version }}
+          name: Release v${{ steps.manifest.outputs.version }}
           draft: false
           prerelease: false
           generateReleaseNotes: true
           skipIfReleaseExists: true
 
-  publish:
-    name: Publish
-    needs:
-      - validate
-      - create-release
-    runs-on: windows-latest
-    env:
-      PSGALLERYAPIKEY: ${{ secrets.PSGALLERYAPIKEY }}
-      NUGETAPIKEY: ${{ secrets.NUGETAPIKEY }}
-      PACKAGES_TOKEN: ${{ secrets.PACKAGES_TOKEN }}
-      PUBLISH_TO_NUGET_INPUT: ${{ github.event.inputs.publishToNuGet }}
-      PUBLISH_TO_GITHUB_INPUT: ${{ github.event.inputs.publishToGitHub }}
-      MODULE_VERSION: ${{ needs.validate.outputs.version }}
-    steps:
-      - name: Harden the runner (Audit all outbound calls)
-        uses: step-security/harden-runner@f4a75cfd619ee5ce8d5b864b0d183aff3c69b55a # v2.13.1
-        with:
-          egress-policy: audit
-
-      - name: Checkout
-        uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
-
       - name: Package module
         id: package
         run: |
@@ -267,6 +232,7 @@ jobs:
         shell: pwsh
 
       - name: Publish to GitHub Packages
+        if: ${{ env.PACKAGES_TOKEN != '' && (github.event_name != 'workflow_dispatch' || env.PUBLISH_TO_GITHUB_INPUT != 'false') }}
         run: |
           $packagePath = '${{ steps.package.outputs.packagePath }}'
           if (-not (Test-Path $packagePath)) {

ColorScripts-Enhanced/ColorScripts-Enhanced.psd1

@@ -11,7 +11,7 @@
     RootModule = 'ColorScripts-Enhanced.psm1'
 
     # Version number of this module.
-    ModuleVersion = '2025.10.11.1624'
+    ModuleVersion = '2025.10.11.2020'
 
     # Supported PSEditions
     CompatiblePSEditions = @('Desktop', 'Core')
@@ -107,10 +107,22 @@
                 'Performance'
                 'PowerShell'
                 'Startup'
-                'Terminal Startup'
-                'ANSI Art'
-                'Colorful Terminal'
-                'PowerShell Art'
+                'Terminal-Startup'
+                'ANSI-Art'
+                'Colorful-Terminal'
+                'PowerShell-Art'
+                'Fancy-Terminal'
+                'Terminal-Enhancement'
+                'Beautiful-Terminal'
+                'Terminal-Colors'
+                'PowerShell-Scripts'
+                'Terminal-Art'
+                'Colorful-Scripts'
+                'Enhanced-Terminal'
+                'Terminal-Visuals'
+                'PowerShell-Module'
+                'Colorful-Output'
+                'Terminal-Themes'
             )
 
             # A URL to the license for this module.
@@ -124,12 +136,12 @@
 
             # ReleaseNotes of this module
             ReleaseNotes = @'
-Version 2025.10.11.1624:
+Version 2025.10.11.2020:
 - Enhanced caching system with OS-wide cache in AppData
 - 6-19x performance improvement
 - Cache stored in centralized location
 - Works from any directory
- - 195+ beautiful colorscripts included
+ - 222+ beautiful colorscripts included
 - Full comment-based help documentation
 - Scripts optimized for performance and visual quality
 '@

ColorScripts-Enhanced/README.md

@@ -12,7 +12,7 @@ A high-performance PowerShell module for displaying beautiful ANSI colorscripts
 
 ## Features
 
-✨ **195+ Beautiful Colorscripts** - Extensive collection of ANSI art
+✨ **222+ Beautiful Colorscripts** - Extensive collection of ANSI art
 
 ⚡ **Intelligent Caching** - 6-19x performance improvement (5-20ms load times)
 
@@ -387,7 +387,7 @@ $env:APPDATA\ColorScripts-Enhanced\cache
 - One `.cache` file per colorscript
 - Contains pre-rendered ANSI output
 - Average size: ~20KB per file
-- Total size: ~3.9MB for all 195 scripts
+- Total size: ~3.9MB for all 222 scripts
 
 ## Examples
 
@@ -421,7 +421,7 @@ Build-ColorScriptCache
 
 ## Available Colorscripts
 
-The module includes 195 colorscripts including:
+The module includes 222 colorscripts including:
 
 - **Fractals**: mandelbrot-zoom, julia-morphing, barnsley-fern, koch-snowflake
 - **Patterns**: kaleidoscope, wave-pattern, rainbow-waves, gradient-bars
@@ -518,7 +518,7 @@ ColorScripts-Enhanced/
 └── cache/                         # Cache files
     ├── bars.cache
     ├── hearts.cache
-   └── ... (195 total)
+   └── ... (222 total)
 ```
 
 ## Contributing