phwriter.psd1

@{
    ModuleVersion     = '0.4.2'
    GUID              = 'b40e340a-9d6c-4f7f-8c3b-2a7f8e0d9c1a'
    Author            = 'Garvey K. Snow'
    CompanyName       = 'Phallems'
    Copyright         = '(c) 2025 Phallems. All rights reserved.'
    Description       = 'A PowerShell module for generating custom, colored help text with a man-page-like layout.'
    RootModule        = 'phwriter.psm1'
    FunctionsToExport = @('New-PHWriter', 'Write-PHAsciiLogo')
    CmdletsToExport   = @()
    VariablesToExport = @()
    AliasesToExport   = @()
    PrivateData       = @{
        PSData = @{
            Tags         = @('Help', 'Formatting', 'CLI', 'PowerShell', 'Documentation')
            ReleaseNotes = @()
            RequireLicenseAcceptance = $false
            LicenseUri               = 'https://choosealicense.com/licenses/mit'
            ProjectUri               = 'https://gitlab.com/phellams/zypline.git'
            IconUri                  = 'https://raw.githubusercontent.com/phellams/phellams-general-resources/main/logos/zypline/dist/png/zypline-logo-128x128.png'
            # CHOCOLATE ---------------------
            LicenseUrl               = 'https://choosealicense.com/licenses/mit'
            ProjectUrl               = 'https://github.com/phellams/zypline'
            IconUrl                  = 'https://raw.githubusercontent.com/phellams/phellams-general-resources/main/logos/zypline/zypline-logo-128x128.png'
            Docsurl                  = 'https://pages.gitlab.io/sgkens/ptoml'
            MailingListUrl           = 'https://github.com/phellams/zypline/issues'
            projectSourceUrl         = 'https://github.com/phellams/zypline'
            bugTrackerUrl            = 'https://github.com/phellams/zypline/issues'
            Summary                  = 'A PowerShell module for advanced file and folder searching with configuration management.'
            chocoDescription         = @"
## Overview

PHWriter(_**Powershell Help Writer**_) is a PowerShell module designed to generate beautifully formatted, colored help text for your PowerShell cmdlets, mimicking the style and readability of Linux man pages. It allows you to define your cmdlet's parameters and their descriptions in a structured way, providing a consistent and professional look for your command-line help.
Features

 - **Customizable Layout**: Control indentation and spacing between parameter elements.
 - Colored Output: Enhance readability with distinct colors for different help sections and parameter components.
 - **ASCII Art Logo**: Includes a simple, elegant ASCII art banner for visual appeal, or you can provide your own ascii art.
 - **Inline/Newline Descriptions**: Choose whether parameter descriptions appear on the same line or a new line.
 - **Automatic Alignment**: Dynamically calculates padding to ensure perfect alignment of parameter types and descriptions.
 - **Production Ready**: Comes with a module manifest (.psd1) for proper PowerShell module management.
"@

            # CHOCOLATE ---------------------
            Prerelease               = 'prerelease'
        }
    }
}