internal/functions/Get-DefinitionsFullPath.ps1

#Requires -PSEdition Core

function Get-DefinitionsFullPath {
    [CmdletBinding()]
    param (
        $folder,
        $rawSubFolder,
        $name,
        $displayName,
        $invalidChars,
        $maxLengthSubFolder,
        $maxLengthFileName,
        $fileExtension
    )

    $subFolder = Get-ScrubbedString -string $rawSubFolder -invalidChars $invalidChars -maxLength $maxLengthSubFolder -trimEnds -singleReplace
    if ($subFolder.Length -eq 0) {
        $subFolder = "Unknown"
    }

    $ObjectGuid = [System.Guid]::empty
    $isGuid = [System.Guid]::TryParse($name, [System.Management.Automation.PSReference]$ObjectGuid)
    $fileName = Get-ScrubbedString -string $name -invalidChars $invalidChars -replaceWith "" -replaceSpaces -replaceSpacesWith "-" -maxLength $maxLengthFileName -trimEnds -toLower -singleReplace
    if ($isGuid) {
        # try to avoid GUID file names
        $fileNameTemp = $displayName
        $fileNameTemp = Get-ScrubbedString -string $fileNameTemp -invalidChars $invalidChars -replaceWith "" -replaceSpaces -replaceSpacesWith "-" -maxLength $maxLengthFileName -trimEnds -toLower -singleReplace
        if ($fileNameTemp.Length -gt 0) {
            $fileName = $fileNameTemp
        }
    }
    $fullPath = "$folder/$subFolder/$($fileName).$fileExtension"

    return $fullPath
}