Private/Docs/Get-AvmBicepDocsCompiledParameter.ps1

function Get-AvmBicepDocsCompiledParameter {
    [CmdletBinding()]
    [OutputType([System.Collections.Generic.Dictionary[string, object]])]
    param(
        [Parameter(Mandatory)]
        [System.Collections.IDictionary] $Template,

        [Parameter(Mandatory)]
        [string] $SourcePath
    )

    Set-StrictMode -Version 3.0
    $details = [System.Collections.Generic.Dictionary[string, object]]::new(
        [System.StringComparer]::Ordinal)
    $parameters = $Template['parameters']
    if ($parameters -isnot [System.Collections.IDictionary]) {
        return $details
    }
    $definitions = $Template['definitions']
    $pending = [System.Collections.Generic.Stack[object]]::new()
    foreach ($name in $parameters.psbase.Keys) {
        $pending.Push([pscustomobject]@{
                Path           = [string]$name
                Schema         = $parameters[$name]
                References     = [string[]]@()
                ReferenceDepth = 0
                FromArrayItem  = $false
            })
    }

    while ($pending.Count -gt 0) {
        $entry = $pending.Pop()
        $schema = $entry.Schema
        if ($schema -isnot [System.Collections.IDictionary]) {
            throw [AvmConfigurationException]::new(
                "Compiled Bicep parameter '$($entry.Path)' must be a JSON object in '$SourcePath'.")
        }
        if (-not $details.ContainsKey($entry.Path)) {
            $required = -not $schema.Contains('defaultValue') -and $schema['nullable'] -ne $true
            $details[$entry.Path] = [pscustomobject]@{
                Type                       = $null
                LegacyType                 = $null
                DocumentChildren           = $true
                Required                   = $required
                AllowedValues              = @()
                AllowedValuesFromReference = $false
                MinValue                   = $null
                MaxValue                   = $null
                Description                = $null
                Example                    = $null
                IsResourceDerived          = $false
                HasDiscriminator           = $false
                VariantOrder               = @()
            }
        }
        $current = $details[$entry.Path]
        if ($null -eq $current.Type) {
            if ($schema.Contains('type')) {
                $current.Type = [string]$schema['type']
            }
            elseif (-not $schema.Contains('$ref')) {
                $current.Type = ''
            }
        }
        if ($schema.Contains('minValue') -and $null -eq $current.MinValue) {
            $current.MinValue = $schema['minValue']
        }
        if ($schema.Contains('maxValue') -and $null -eq $current.MaxValue) {
            $current.MaxValue = $schema['maxValue']
        }
        if ($schema['type'] -eq 'secureObject' -and $entry.ReferenceDepth -eq 0) {
            $current.DocumentChildren = $false
        }
        if ((-not $entry.FromArrayItem -or $entry.ReferenceDepth -gt 0) -and
            $schema['allowedValues'] -is [array] -and
            $schema['allowedValues'].Count -gt 0 -and
            $current.AllowedValues.Count -eq 0) {
            $values = @($schema['allowedValues'])
            $scalar = @($values | Where-Object {
                    $_ -is [string] -or $_ -is [System.ValueType]
                }).Count -eq $values.Count
            if ($scalar) {
                $current.AllowedValues = [object[]]@($values | Sort-Object -Culture 'en-US')
            }
            else {
                $current.AllowedValues = [object[]]$values
            }
            $current.AllowedValuesFromReference = $entry.ReferenceDepth -gt 0
        }
        if ($schema['metadata'] -is [System.Collections.IDictionary]) {
            $metadata = $schema['metadata']
            if ($metadata.Contains('__bicep_resource_derived_type!')) {
                $current.IsResourceDerived = $true
            }
            if ($null -eq $current.Description -and $metadata['description'] -is [string]) {
                $current.Description = $metadata['description']
            }
            if ($null -eq $current.Example -and $metadata.Contains('example')) {
                $example = $metadata['example']
                $normalizedExample = $null
                if ($example -is [string]) {
                    $normalizedExample = $example
                }
                elseif ($example -is [array] -and
                    @($example | Where-Object { $_ -isnot [string] }).Count -eq 0) {
                    $normalizedExample = [string[]]$example
                }
                elseif ($example -is [System.Collections.IDictionary]) {
                    $normalizedExample = $example
                }
                else {
                    throw [AvmConfigurationException]::new(
                        "Compiled Bicep example for '$($entry.Path)' must be a string, an object, or an array of strings in '$SourcePath'.")
                }
                if (-not $entry.FromArrayItem) {
                    $current.Example = $normalizedExample
                }
            }
        }
        if ($schema['type'] -eq 'array' -and $schema['prefixItems'] -is [array] -and
            $schema['items'] -is [bool] -and -not $schema['items']) {
            $current.DocumentChildren = $false
        }
        if ($current.IsResourceDerived -and -not $schema.Contains('$ref') -and
            $schema['properties'] -isnot [System.Collections.IDictionary] -and
            $schema['additionalProperties'] -isnot [System.Collections.IDictionary] -and
            $schema['items'] -isnot [System.Collections.IDictionary] -and
            $schema['discriminator'] -isnot [System.Collections.IDictionary]) {
            $current.DocumentChildren = $false
        }

        if ($schema.Contains('$ref')) {
            $reference = [string]$schema['$ref']
            if ($reference -cnotmatch '^#/definitions/(.+)$') {
                throw [AvmConfigurationException]::new(
                    "Compiled Bicep parameter '$($entry.Path)' has an invalid definition reference '$reference' in '$SourcePath'.")
            }
            $definitionName = $matches[1].Replace('~1', '/').Replace('~0', '~')
            if ($entry.References -ccontains $definitionName) {
                continue
            }
            if ($definitions -isnot [System.Collections.IDictionary] -or
                -not $definitions.Contains($definitionName) -or
                $definitions[$definitionName] -isnot [System.Collections.IDictionary]) {
                throw [AvmConfigurationException]::new(
                    "Compiled Bicep parameter '$($entry.Path)' references missing definition '$definitionName' in '$SourcePath'.")
            }
            if ($entry.ReferenceDepth -eq 0 -and
                $definitions[$definitionName].Contains('$ref') -and
                -not $definitions[$definitionName].Contains('type')) {
                $current.DocumentChildren = $false
                if ($null -eq $current.Type) {
                    $current.LegacyType = ''
                }
            }
            $pending.Push([pscustomobject]@{
                    Path           = $entry.Path
                    Schema         = $definitions[$definitionName]
                    References     = [string[]]@($entry.References + $definitionName)
                    ReferenceDepth = $entry.ReferenceDepth + 1
                    FromArrayItem  = $entry.FromArrayItem
                })
            continue
        }

        $discriminator = $schema['discriminator']
        if ($discriminator -is [System.Collections.IDictionary]) {
            $current.HasDiscriminator = $true
            $propertyName = [string]$discriminator['propertyName']
            $mapping = $discriminator['mapping']
            if ([string]::IsNullOrWhiteSpace($propertyName) -or
                $mapping -isnot [System.Collections.IDictionary]) {
                throw [AvmConfigurationException]::new(
                    "Compiled Bicep discriminator for '$($entry.Path)' is invalid in '$SourcePath'.")
            }
            $current.VariantOrder = [string[]]@($mapping.psbase.Keys)
            foreach ($value in $mapping.psbase.Keys) {
                $caseSchema = $mapping[$value]
                if ($caseSchema -is [string]) {
                    $caseSchema = @{ '$ref' = $caseSchema }
                }
                if ($caseSchema -isnot [System.Collections.IDictionary]) {
                    throw [AvmConfigurationException]::new(
                        "Compiled Bicep discriminator case '$value' for '$($entry.Path)' is invalid in '$SourcePath'.")
                }
                $pending.Push([pscustomobject]@{
                        Path           = "$($entry.Path).$propertyName-$value"
                        Schema         = $caseSchema
                        References     = $entry.References
                        ReferenceDepth = 0
                        FromArrayItem  = $false
                    })
            }
        }

        $properties = $schema['properties']
        if ($properties -is [System.Collections.IDictionary]) {
            foreach ($name in $properties.psbase.Keys) {
                $pending.Push([pscustomobject]@{
                        Path           = "$($entry.Path).$name"
                        Schema         = $properties[$name]
                        References     = $entry.References
                        ReferenceDepth = 0
                        FromArrayItem  = $false
                    })
            }
        }
        if ($schema['additionalProperties'] -is [System.Collections.IDictionary]) {
            $pending.Push([pscustomobject]@{
                    Path           = "$($entry.Path).>Any_other_property<"
                    Schema         = $schema['additionalProperties']
                    References     = $entry.References
                    ReferenceDepth = 0
                    FromArrayItem  = $false
                })
        }
        if ($schema['items'] -is [System.Collections.IDictionary]) {
            $pending.Push([pscustomobject]@{
                    Path           = $entry.Path
                    Schema         = $schema['items']
                    References     = $entry.References
                    ReferenceDepth = $entry.ReferenceDepth
                    FromArrayItem  = $true
                })
        }
    }

    return $details
}

# SIG # Begin signature block
# MIInTgYJKoZIhvcNAQcCoIInPzCCJzsCAQExDzANBglghkgBZQMEAgEFADB5Bgor
# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG
# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCDjtABiibShcNtx
# QCaxnLVbd2ONEjtokDu1qnK0D0NiCaCCDMkwggYEMIID7KADAgECAhMzAAACHPrN
# xZvoL37EAAAAAAIcMA0GCSqGSIb3DQEBCwUAMFcxCzAJBgNVBAYTAlVTMR4wHAYD
# VQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBD
# b2RlIFNpZ25pbmcgUENBIDIwMjQwHhcNMjYwNDE2MTg1OTQxWhcNMjcwNDE1MTg1
# OTQxWjB0MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UE
# BxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMR4wHAYD
# VQQDExVNaWNyb3NvZnQgQ29ycG9yYXRpb24wggEiMA0GCSqGSIb3DQEBAQUAA4IB
# DwAwggEKAoIBAQDVsZfgOKmM31HPfoWOoNEiw0SlCiIxUMC0I9NMWbucKOw/e9lP
# oAoehQVu6SG65V4EPzrYsnBnFPNoi4/HoOdjhz1qkrEt4I6tEcxXU6oOeY9zGveC
# /3iBeuhLYxM3M/PkcUoebF+Nednm8OkdSPoDu8imViHPQq/8CQUu0WRR4rE+dMRf
# rpVqfmNi2qWCX94T4MsepijGVkwE//tJg0ryAiYdHT34LSnlG/RSBZmQRGWZ5g8j
# qnKjRParSqMft1gvjuUTVgtWNZfgcLFSK5Wa0myrq8OPcgTGGsRgun+tnSS+IxDT
# xVsAPH1OzvPjwomguByhUe/OcvUN0D5Wmp7xAgMBAAGjggGqMIIBpjAOBgNVHQ8B
# Af8EBAMCB4AwHwYDVR0lBBgwFgYKKwYBBAGCN0wIAQYIKwYBBQUHAwMwHQYDVR0O
# BBYEFNoH7a2YDjOSwpkp6DHcmUS7J+0yMFQGA1UdEQRNMEukSTBHMS0wKwYDVQQL
# EyRNaWNyb3NvZnQgSXJlbGFuZCBPcGVyYXRpb25zIExpbWl0ZWQxFjAUBgNVBAUT
# DTIzMDAxMis1MDc1NjkwHwYDVR0jBBgwFoAUf1k/VCHarU/vBeXmo9ctBpQSCDEw
# YAYDVR0fBFkwVzBVoFOgUYZPaHR0cDovL3d3dy5taWNyb3NvZnQuY29tL3BraW9w
# cy9jcmwvTWljcm9zb2Z0JTIwQ29kZSUyMFNpZ25pbmclMjBQQ0ElMjAyMDI0LmNy
# bDBtBggrBgEFBQcBAQRhMF8wXQYIKwYBBQUHMAKGUWh0dHA6Ly93d3cubWljcm9z
# b2Z0LmNvbS9wa2lvcHMvY2VydHMvTWljcm9zb2Z0JTIwQ29kZSUyMFNpZ25pbmcl
# MjBQQ0ElMjAyMDI0LmNydDAMBgNVHRMBAf8EAjAAMA0GCSqGSIb3DQEBCwUAA4IC
# AQAUnEqhaRXe0T3hIJjvdQErEkrA/7bByjn6t5IArODkkRjzkYwtKMc2yYj2quaN
# rLutWw2YZcngKPy1b71YyDJQTy4NDRwaSh9Tw5thrk3NmcPrAHia5vtcBJ1CgtKK
# 7mQbIcQ22d/N3813ayCDDFewu1+jsZmX+r/aTEqaOM4TVxVtRSkuCy8nAXKuChOK
# Li/zA4XuH8iEYqIsj2YoNaeSxVmeGiERXpKdo3dDmYi0kO5w2D8VS4c3+9h6gElY
# BaAAg/dYErBg27qT3vv0zRDJhJufvCNylA8S7/+8H5E/PV5cng6na9VV/w9OV3qu
# uND6zdGa2EX38Glp50F9AIQk3p2xXmcvorDeM4XJ7UlWYBi6g80J1SSOQnInCYFE
# msfUNn3+1AaTJKSJL83quKArTac2pKhu0Yzzzrzo6HrsRiQKzpnRBb1/dMa6P3hz
# 75XbMRBctNsFhZC07WCmjExdLg2eHW5uV0TY8D5+6wozJf7vF3+WHkYPO85Z+BC6
# U4FkNbYNycZ9cE4j1tXRdyDCfml6c0HWPHjNVDObrv9lKt3qUqFpX38VCqVCyNOO
# 1UcXfQiVjJw32U2WUKZjt/neJKHEBsm9kFsLuWzkQ53+qcaSaytmsCnk2gOglrlD
# 5d3kKyvvAw+rzm0lT8K38P6PLxfZQHhu4W8dV7Av8N2ZmDCCBr0wggSloAMCAQIC
# EzMAAAA5O7Y3Gb8GHWcAAAAAADkwDQYJKoZIhvcNAQEMBQAwgYgxCzAJBgNVBAYT
# AlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYD
# VQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xMjAwBgNVBAMTKU1pY3Jvc29mdCBS
# b290IENlcnRpZmljYXRlIEF1dGhvcml0eSAyMDExMB4XDTI0MDgwODIwNTQxOFoX
# DTM2MDMyMjIyMTMwNFowVzELMAkGA1UEBhMCVVMxHjAcBgNVBAoTFU1pY3Jvc29m
# dCBDb3Jwb3JhdGlvbjEoMCYGA1UEAxMfTWljcm9zb2Z0IENvZGUgU2lnbmluZyBQ
# Q0EgMjAyNDCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBANgBnB7jOMeq
# lRYHNa265v4IY9fH8TKhemHfPINe1gpLaV3dhg324WwH06LcHbpnsBukCDNitryo
# 0dtS/EW6I/yEL/bLSY8hKpbfQuWusBPr9qazYcDxCW/qnjb5JsI1s8bNOg3bVATv
# QVL4tcf03aTycsz8QeCdM0l/yHRObJ9QqazM1r6VPEOJ7LL+uEEb73w6QCuhs89a
# 1uv1zerOYMnsneRRwCbpyW11IcggU0cRKDDq1pjVJzIbIF6+oiXXbReOsgeI8zu1
# FyQfK0fVkaya8SmVHQ/tOf23mZ4W9k0Ri22QW9p3UgSC5OUDktKxxcCmGL6tXLfO
# GSWHIIV4YrTJTT6PNty5REojHJuZHArkF9VnHTERWoTjAzfI3kP+5b4alUdhgAZ7
# ttOu1bVnXfHaqPYl2rPs20ji03LOVWsh/radgE17es5hL+t6lV0eVHrVhsssROWJ
# uz2MXMCt7iw7lFPG9LXKGjsmonn2gotGdHIuEg5JnJMJVmixd5LRlkmgYRZKzhxS
# CwyoGIq0PhaA7Y+VPct5pCHkijcIIDm0nlkK+0KyepolcqGm0T/GYQRMhHJlGOOm
# VQop36wUVUYklUy++vDWeEgEo4s7hxN6mIbf2MSIQ/iIfMZgJxC69oukMUXCrOC3
# SkE/xIkgpfl22MM1itkZ35nNXkMolU1lAgMBAAGjggFOMIIBSjAOBgNVHQ8BAf8E
# BAMCAYYwEAYJKwYBBAGCNxUBBAMCAQAwHQYDVR0OBBYEFH9ZP1Qh2q1P7wXl5qPX
# LQaUEggxMBkGCSsGAQQBgjcUAgQMHgoAUwB1AGIAQwBBMA8GA1UdEwEB/wQFMAMB
# Af8wHwYDVR0jBBgwFoAUci06AjGQQ7kUBU7h6qfHMdEjiTQwWgYDVR0fBFMwUTBP
# oE2gS4ZJaHR0cDovL2NybC5taWNyb3NvZnQuY29tL3BraS9jcmwvcHJvZHVjdHMv
# TWljUm9vQ2VyQXV0MjAxMV8yMDExXzAzXzIyLmNybDBeBggrBgEFBQcBAQRSMFAw
# TgYIKwYBBQUHMAKGQmh0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2kvY2VydHMv
# TWljUm9vQ2VyQXV0MjAxMV8yMDExXzAzXzIyLmNydDANBgkqhkiG9w0BAQwFAAOC
# AgEAFJQfOChP7onn6fLIMKrSlN1WYKwDFgAddymOUO3FrM8d7B/W/iQ6DxXsDn7D
# 5W4wMwYeLystcEqfkjz4NURRgazyMu5yRzQh4LqjA4tStTcJh1opExo7nn5PuPBY
# nbu0+THSuVHTe0VTTPVhily/piFrDo3axQ9P4C+Ol5yet+2gTfekICS5xS+cYfSI
# vgn0JksVBVMYVI5QFu/qhnLhsEFEUzG8fvv0hjgkO+lkpV9ty6GkN4vdnd7ya6Q6
# aR9y34aiM1qmxaxBi6OUnyNl6fkuun/diTFnYDLTppOkr/mg5WSfCiDVMNCxtj4w
# PKC5OmHm1DQIt/MNokbbH3UGsFP1QbzsLocuSqLCvH09Io3fDPTmscR9Y75G4qX7
# RTX8AdBPo0I6OEojf39zuFZt0qOHm65YWQE69cZM2ueE1MB05dNNgHK9gTE7zKvK
# /fg8B2qjW88MT/WF5V5uvZGtqa9FSL2RazArA+rDPuf6JGYz4HpgMZHB4S6szWSK
# YBv0VisCzfxgeU+dquXW9bd0auYlOB58DPcOYKdc3Se94g+xL4pcEhbB54JOgAkw
# YTu/9dLeH2pDqeJZAABVDWRQCaXfO5LgyKwKCLYXpigrZYCjUSBcr+Ve8PFWMhVT
# Ql0v4q8J/AUmQN5W4n101cY2L4A7GTQG1h32HHAvfQESWP0xghnbMIIZ1wIBATBu
# MFcxCzAJBgNVBAYTAlVTMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24x
# KDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNpZ25pbmcgUENBIDIwMjQCEzMAAAIc
# +s3Fm+gvfsQAAAAAAhwwDQYJYIZIAWUDBAIBBQCggZAwGQYJKoZIhvcNAQkDMQwG
# CisGAQQBgjcCAQQwLwYJKoZIhvcNAQkEMSIEINKW8beNiV+8xpy8VUp69+XKrgjL
# 4j96q/nygYXz9QUmMEIGCisGAQQBgjcCAQwxNDAyoBSAEgBNAGkAYwByAG8AcwBv
# AGYAdKEagBhodHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20wDQYJKoZIhvcNAQEBBQAE
# ggEAlaLK2xaYxJJmoaeXVzf/xPIUJeF9UYzsfE0Z8M9m3WDsg9KOLf/SwWChrQfn
# VBg/Js+0mS21PdSJeEZMd3fbbhg7h0mHJZtiTlPNi49OqC/fSft5IyjsLOhuEfsc
# RVieU/go9qh+RWFR5XcbT6LrcH6YT7qW9ork8BQd4VuamUesyiqwqWXfVJ5MAbhb
# KqGRCcI9WPTSEcHvpVpxeu49JPfiItS/ZuinayFl7fw181YmkImndt4cy6zrEzls
# jgqApZ+nyy5RyvIbxDqn/7/AZ8QTrjXxyHGvmsio9POWMEVMhl94CIjjFlpNzQzu
# 78fkBoP0dC7zGyGRCzN4i+AZrqGCF6swghenBgorBgEEAYI3AwMBMYIXlzCCF5MG
# CSqGSIb3DQEHAqCCF4QwgheAAgEDMQ8wDQYJYIZIAWUDBAIBBQAwggFYBgsqhkiG
# 9w0BCRABBKCCAUcEggFDMIIBPwIBAQYKKwYBBAGEWQoDATAxMA0GCWCGSAFlAwQC
# AQUABCBc4U6LHHbESy50JyLPXDA2URTazCuLYIFs8hv8oOMyeQIGavNMltvUGBEy
# MDI2MTExODE0MDQ0MS42WjAEgAIB9KCB2aSB1jCB0zELMAkGA1UEBhMCVVMxEzAR
# BgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1p
# Y3Jvc29mdCBDb3Jwb3JhdGlvbjEtMCsGA1UECxMkTWljcm9zb2Z0IElyZWxhbmQg
# T3BlcmF0aW9ucyBMaW1pdGVkMScwJQYDVQQLEx5uU2hpZWxkIFRTUyBFU046NDAx
# QS0wNUUwLUQ5NDcxJTAjBgNVBAMTHE1pY3Jvc29mdCBUaW1lLVN0YW1wIFNlcnZp
# Y2WgghH7MIIHKDCCBRCgAwIBAgITMwAAAi2Bv2vi4wRaCQABAAACLTANBgkqhkiG
# 9w0BAQsFADB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4G
# A1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYw
# JAYDVQQDEx1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMDAeFw0yNjEwMTUx
# ODM3MzFaFw0yODAxMTExODM3MzFaMIHTMQswCQYDVQQGEwJVUzETMBEGA1UECBMK
# V2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0
# IENvcnBvcmF0aW9uMS0wKwYDVQQLEyRNaWNyb3NvZnQgSXJlbGFuZCBPcGVyYXRp
# b25zIExpbWl0ZWQxJzAlBgNVBAsTHm5TaGllbGQgVFNTIEVTTjo0MDFBLTA1RTAt
# RDk0NzElMCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUtU3RhbXAgU2VydmljZTCCAiIw
# DQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAN44aKMQ9bIn83byc2uUHSdXGKZu
# IADOWVuqvzOLuBpZplBH97uBtXmIxGP6vokuOybq+lr5RexYgIXNZRwMJr12z0rD
# t8SqjyimPDeP6qa96+0o7bri274lP+x6NuNdt4IWZugHDP+/m1wRsn6eYVHT+z5U
# tFyGOO3pggasaPuCuF/EexO5UXyGlD5A3F3V4/gZkiFnJfy85CEvW6ZZwtiStGmT
# 3WH1I6A2iv12uhkPMElPdWzAeeQj8Lc4wxvlJiP70z7KwbU4rQwdhMMvx8bxOwWm
# omYRs7suOrvObiFjCvWxklkS73zGKrsWwcQ8pKrsNNioNI9sLl62CsqNK3eIeJhg
# QDYbptYIjVWFRTmgL+rjjmKILHsTx5/tCz7xJCsCrqDej6xHNV9t4VC1gr/hXSfw
# 4sxewX5i/dR89qhzphhxNzYGGGiKefuNXSj7uHPSd3FWaTN9pg0eCzszKdzC+l2D
# fAY5TbV0Igo3y1/mfzWY2tnOKXNkSaC9K2Gcxb8mjNRCDxCt/2EC5zYz+KhettQA
# TnOfEyVaSFM6v7Jm+O5uaYidgiP4Z4/DjKLHX6HPZzA3T4jFRsyyglrA0nS/LvV5
# ZVYThlZc4n9f4WxX9fFrnlT7A18DOCLf5aSMJzdMrDmk7FmqrDOlvVHgKylQpu7Q
# 4lNalvGdiNJ5fyNlAgMBAAGjggFJMIIBRTAdBgNVHQ4EFgQUX0d9fFLoWZWO+oeI
# uugkuX+y5hQwHwYDVR0jBBgwFoAUn6cVXQBeYl2D9OXSZacbUzUZ6XIwXwYDVR0f
# BFgwVjBUoFKgUIZOaHR0cDovL3d3dy5taWNyb3NvZnQuY29tL3BraW9wcy9jcmwv
# TWljcm9zb2Z0JTIwVGltZS1TdGFtcCUyMFBDQSUyMDIwMTAoMSkuY3JsMGwGCCsG
# AQUFBwEBBGAwXjBcBggrBgEFBQcwAoZQaHR0cDovL3d3dy5taWNyb3NvZnQuY29t
# L3BraW9wcy9jZXJ0cy9NaWNyb3NvZnQlMjBUaW1lLVN0YW1wJTIwUENBJTIwMjAx
# MCgxKS5jcnQwDAYDVR0TAQH/BAIwADAWBgNVHSUBAf8EDDAKBggrBgEFBQcDCDAO
# BgNVHQ8BAf8EBAMCB4AwDQYJKoZIhvcNAQELBQADggIBAI7H+5s16OtqYq/pcKx9
# jwSLRjB3YAIlzQo0l0fzorrMIMWVEEwA8Nak4HENpTaFCjtl4QNiRWtf3Sj6E84y
# pUuAucvTMdTPMLiQukA5TkSKhJoi6bhnzvXwpLYrVWne5czj+sfH9zVXnrUZ3dLU
# Iu2I2bWthiiqgK+0lJwX2rn9RSbmkerXYaHUMbRI/W40RszV/IGa+4AQ4UA9cUMk
# fDibhrmRsPALRfUjo/t8wzV06794QNDUGqpoQcLDXo4fkiQU7Gs/SHWjpCTeqlfM
# hJVt1BiS7C819j2ZYcTJH6On2dHuwvPygu9nLcRxGtmPSKKD/brqR3kDn9Rdu/+/
# 8Kk5tmmNNHpvv1WIPtygDcNN/sDNGxbx0bsBx48+TdcO3EpKNhSfwYdRmlcqgLws
# CEfyZmMldpDBPCcEUjOqPud5NFE8lE9KYVRfe+QgFEA4ADStIU/ZOcp+RnEzYj1O
# 0LVlGde/8gotFIPBbJsCax9psVQZF2jcuM0oRXtZgaFgBv4/2C/HaH7leIfgvar1
# N3H/xgFQHfjS6mDeLTaHgW7r31s0P2q/46ptsJEdGqlgqgEnyKgZVA5o6Bl384fg
# q9LdDCiuMFGMg5knFhEJeWTYx9xZO5N77QxSZK91OcTllZZTLJ5MVZRXSVfyzXPa
# UX7IFYdKN4b4qjgl/Qh5Sc3GMIIHcTCCBVmgAwIBAgITMwAAABXF52ueAptJmQAA
# AAAAFTANBgkqhkiG9w0BAQsFADCBiDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldh
# c2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBD
# b3Jwb3JhdGlvbjEyMDAGA1UEAxMpTWljcm9zb2Z0IFJvb3QgQ2VydGlmaWNhdGUg
# QXV0aG9yaXR5IDIwMTAwHhcNMjEwOTMwMTgyMjI1WhcNMzAwOTMwMTgzMjI1WjB8
# MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVk
# bW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQDEx1N
# aWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMDCCAiIwDQYJKoZIhvcNAQEBBQAD
# ggIPADCCAgoCggIBAOThpkzntHIhC3miy9ckeb0O1YLT/e6cBwfSqWxOdcjKNVf2
# AX9sSuDivbk+F2Az/1xPx2b3lVNxWuJ+Slr+uDZnhUYjDLWNE893MsAQGOhgfWpS
# g0S3po5GawcU88V29YZQ3MFEyHFcUTE3oAo4bo3t1w/YJlN8OWECesSq/XJprx2r
# rPY2vjUmZNqYO7oaezOtgFt+jBAcnVL+tuhiJdxqD89d9P6OU8/W7IVWTe/dvI2k
# 45GPsjksUZzpcGkNyjYtcI4xyDUoveO0hyTD4MmPfrVUj9z6BVWYbWg7mka97aSu
# eik3rMvrg0XnRm7KMtXAhjBcTyziYrLNueKNiOSWrAFKu75xqRdbZ2De+JKRHh09
# /SDPc31BmkZ1zcRfNN0Sidb9pSB9fvzZnkXftnIv231fgLrbqn427DZM9ituqBJR
# 6L8FA6PRc6ZNN3SUHDSCD/AQ8rdHGO2n6Jl8P0zbr17C89XYcz1DTsEzOUyOArxC
# aC4Q6oRRRuLRvWoYWmEBc8pnol7XKHYC4jMYctenIPDC+hIK12NvDMk2ZItboKaD
# IV1fMHSRlJTYuVD5C4lh8zYGNRiER9vcG9H9stQcxWv2XFJRXRLbJbqvUAV6bMUR
# HXLvjflSxIUXk8A8FdsaN8cIFRg/eKtFtvUeh17aj54WcmnGrnu3tz5q4i6tAgMB
# AAGjggHdMIIB2TASBgkrBgEEAYI3FQEEBQIDAQABMCMGCSsGAQQBgjcVAgQWBBQq
# p1L+ZMSavoKRPEY1Kc8Q/y8E7jAdBgNVHQ4EFgQUn6cVXQBeYl2D9OXSZacbUzUZ
# 6XIwXAYDVR0gBFUwUzBRBgwrBgEEAYI3TIN9AQEwQTA/BggrBgEFBQcCARYzaHR0
# cDovL3d3dy5taWNyb3NvZnQuY29tL3BraW9wcy9Eb2NzL1JlcG9zaXRvcnkuaHRt
# MBMGA1UdJQQMMAoGCCsGAQUFBwMIMBkGCSsGAQQBgjcUAgQMHgoAUwB1AGIAQwBB
# MAsGA1UdDwQEAwIBhjAPBgNVHRMBAf8EBTADAQH/MB8GA1UdIwQYMBaAFNX2VsuP
# 6KJcYmjRPZSQW9fOmhjEMFYGA1UdHwRPME0wS6BJoEeGRWh0dHA6Ly9jcmwubWlj
# cm9zb2Z0LmNvbS9wa2kvY3JsL3Byb2R1Y3RzL01pY1Jvb0NlckF1dF8yMDEwLTA2
# LTIzLmNybDBaBggrBgEFBQcBAQROMEwwSgYIKwYBBQUHMAKGPmh0dHA6Ly93d3cu
# bWljcm9zb2Z0LmNvbS9wa2kvY2VydHMvTWljUm9vQ2VyQXV0XzIwMTAtMDYtMjMu
# Y3J0MA0GCSqGSIb3DQEBCwUAA4ICAQCdVX38Kq3hLB9nATEkW+Geckv8qW/qXBS2
# Pk5HZHixBpOXPTEztTnXwnE2P9pkbHzQdTltuw8x5MKP+2zRoZQYIu7pZmc6U03d
# mLq2HnjYNi6cqYJWAAOwBb6J6Gngugnue99qb74py27YP0h1AdkY3m2CDPVtI1Tk
# eFN1JFe53Z/zjj3G82jfZfakVqr3lbYoVSfQJL1AoL8ZthISEV09J+BAljis9/kp
# icO8F7BUhUKz/AyeixmJ5/ALaoHCgRlCGVJ1ijbCHcNhcy4sa3tuPywJeBTpkbKp
# W99Jo3QMvOyRgNI95ko+ZjtPu4b6MhrZlvSP9pEB9s7GdP32THJvEKt1MMU0sHrY
# UP4KWN1APMdUbZ1jdEgssU5HLcEUBHG/ZPkkvnNtyo4JvbMBV0lUZNlz138eW0QB
# jloZkWsNn6Qo3GcZKCS6OEuabvshVGtqRRFHqfG3rsjoiV5PndLQTHa1V1QJsWkB
# RH58oWFsc/4Ku+xBZj1p/cvBQUl+fpO+y/g75LcVv7TOPqUxUYS8vwLBgqJ7Fx0V
# iY1w/ue10CgaiQuPNtq6TPmb/wrpNPgkNWcr4A245oyZ1uEi6vAnQj0llOZ0dFtq
# 0Z4+7X6gMTN9vMvpe784cETRkPHIqzqKOghif9lwY1NNje6CbaUFEMFxBmoQtB1V
# M1izoXBm8qGCA1YwggI+AgEBMIIBAaGB2aSB1jCB0zELMAkGA1UEBhMCVVMxEzAR
# BgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1p
# Y3Jvc29mdCBDb3Jwb3JhdGlvbjEtMCsGA1UECxMkTWljcm9zb2Z0IElyZWxhbmQg
# T3BlcmF0aW9ucyBMaW1pdGVkMScwJQYDVQQLEx5uU2hpZWxkIFRTUyBFU046NDAx
# QS0wNUUwLUQ5NDcxJTAjBgNVBAMTHE1pY3Jvc29mdCBUaW1lLVN0YW1wIFNlcnZp
# Y2WiIwoBATAHBgUrDgMCGgMVAM665zbpa7LGGVI/PlfTq7gXurcxoIGDMIGApH4w
# fDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1Jl
# ZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UEAxMd
# TWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIwMTAwDQYJKoZIhvcNAQELBQACBQDu
# p61NMCIYDzIwMjYxMTE4MDQ1MTI1WhgPMjAyNjExMTkwNDUxMjVaMHQwOgYKKwYB
# BAGEWQoEATEsMCowCgIFAO6nrU0CAQAwBwIBAAICGmEwBwIBAAICEnAwCgIFAO6o
# /s0CAQAwNgYKKwYBBAGEWQoEAjEoMCYwDAYKKwYBBAGEWQoDAqAKMAgCAQACAweh
# IKEKMAgCAQACAwGGoDANBgkqhkiG9w0BAQsFAAOCAQEAOho2kQWPFuQCr+QVKKUF
# BSh+IJUsrSeiyxQxcA5MO+IQiqxPiddat8cEVBFHgSie5qXJdtFrYXOI4rmr5aXb
# m6LYGuX1OwfeRLAFMlXeD32wCcx4lMuZVvScDUU/CJNCwwu/iPGIeZzcpVFfypfT
# 0hCgYhlolv+xPqaup0AabevQLGlud4l6GfMP69kAo7dzPOdef0JErCJsjkek7ss4
# Lt1FLlhPRAHODOKjoyD7CP5W92ijiEpdL4ydElBNH3JvnuOO6W7hSMz8SIWxyVW5
# Qh12vNyR7HaWL7JM83rBX1QbUsKQvboDHg/kpqinmPWLQpz0PW0porKTGzvKzCzD
# TzGCBA0wggQJAgEBMIGTMHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5n
# dG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9y
# YXRpb24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwAhMz
# AAACLYG/a+LjBFoJAAEAAAItMA0GCWCGSAFlAwQCAQUAoIIBSjAaBgkqhkiG9w0B
# CQMxDQYLKoZIhvcNAQkQAQQwLwYJKoZIhvcNAQkEMSIEIPP4sTwv+/nY2TwZoZie
# OdourKFUcxMV/5pJb4DNRHYrMIH6BgsqhkiG9w0BCRACLzGB6jCB5zCB5DCBvQQg
# cL4xuiay1FQnAPSVpwInhsNSu1NDWRdHkp+d6R//0UQwgZgwgYCkfjB8MQswCQYD
# VQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEe
# MBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQDEx1NaWNyb3Nv
# ZnQgVGltZS1TdGFtcCBQQ0EgMjAxMAITMwAAAi2Bv2vi4wRaCQABAAACLTAiBCB8
# 2jhBTUpZMeY5TmQFdnLRvPYfc03wssFgZRDVPqm4xDANBgkqhkiG9w0BAQsFAASC
# AgBGkhIRgnhVVZsenHjIfuVUyIeaLMNR9s1i5ElhHgJJhOHlqTBozB8UUgki+lI/
# R6/19Taaxk7PfWNZBlwmt4R4H+v/1Kisn9x0ZYwK76D+1JCZd/eavorLikG83A2F
# R1tb7AtKb+idc9Wz+c49zMHEE1+cV3ULoJgub437CrCb6MAnn1SZ7GnB5F4PV7fJ
# QzU68kAz7ca7xRtw44AbDR+4l4Ph+QJ4gDOThMP2Qjrzos/FC60dx/FyA1qQJCS9
# O9KOVWCbLBWKh5aVtciaPl0QHd15QhGN+m6dcccLOc6XM9z7bQ5GSzqw6LYg/bA3
# 7ipESY0BKQAzVcwiWoimVNFjfI+unyI/SDEgWiZ2fd9d2tSXaUu9M9BSZtzFROC3
# ssG6eyckpHGRh2aXHJlDADu5I2zr8xe+A3/lDCR6W57T9joh0k28wz5Gmg/eGcAy
# LRAoLdJ77sYIaddqeyRhGGcryB4nK/Fd66jALuK/RC3znmTalR1AagWZ2akS94ve
# LiNDIOxaMVaArBsjNKNDOZ7vApFtehTsAua8kBOX8WLeNQU5NtuqXEiotMuW9jtZ
# KE6sHc0dbbHCx/Du/gcFWD2y5VAJxhQMQib/k5x3E8d2jJlmV7/QkBoP8exRvkY+
# vDVbun5z1yDagVCouI9yTA5yNQ+PHKYb2AGFalB9tSun3w==
# SIG # End signature block