Fix PSScriptAnalyzer violations: add comment help and OutputType declarations

- Add [PSProvideCommentHelp] comment blocks to 8 private helper functions:
  ConvertFrom-YamlMapping, ConvertFrom-YamlSequence, Test-YamlMappingType,
  Test-YamlSequenceType, ConvertTo-YamlMapping, ConvertTo-YamlSequence,
  Format-YamlDoubleQuoted, Format-YamlKey
- Add [OutputType] to ConvertFrom-YamlMapping, ConvertFrom-YamlSequence,
  ConvertFrom-YamlScalar
- Suppress PSUseOutputTypeCorrectly on 4 functions that use comma-unary
  operator to prevent collection unwrapping (ConvertFrom-YamlLineStream,
  ConvertFrom-YamlSequence, Get-YamlMappingPair, ConvertFrom-Yaml)

Author: MariusStorhaug

src/functions/private/ConvertFrom-YamlLineStream.ps1

@@ -10,6 +10,8 @@
         - Inline comments (` #...` outside quotes) are stripped from the content.
         - Tabs in indentation are not allowed (YAML spec); they are treated as one space here.
     #>
+    [Diagnostics.CodeAnalysis.SuppressMessageAttribute('PSUseOutputTypeCorrectly', '',
+        Justification = 'Comma-unary operator preserves List type; PSScriptAnalyzer misdetects as Object[].')]
     [CmdletBinding()]
     [OutputType([System.Collections.Generic.List[pscustomobject]])]
     param(

src/functions/private/ConvertFrom-YamlNode.ps1

@@ -40,7 +40,12 @@
 }
 
 function ConvertFrom-YamlMapping {
+    <#
+        .SYNOPSIS
+        Parses a YAML block-style mapping into a PSCustomObject or OrderedDictionary.
+    #>
     [CmdletBinding()]
+    [OutputType([System.Collections.Specialized.OrderedDictionary], [pscustomobject])]
     param(
         [Parameter(Mandatory)] [pscustomobject] $Context,
         [Parameter(Mandatory)] [int] $Indent,
@@ -107,7 +112,14 @@ function ConvertFrom-YamlMapping {
 }
 
 function ConvertFrom-YamlSequence {
+    <#
+        .SYNOPSIS
+        Parses a YAML block-style sequence into a PowerShell array.
+    #>
+    [Diagnostics.CodeAnalysis.SuppressMessageAttribute('PSUseOutputTypeCorrectly', '',
+        Justification = 'Comma-unary operator preserves array type; PSScriptAnalyzer misdetects as Object[].')]
     [CmdletBinding()]
+    [OutputType([object[]])]
     param(
         [Parameter(Mandatory)] [pscustomobject] $Context,
         [Parameter(Mandatory)] [int] $Indent,
@@ -212,6 +224,7 @@ function ConvertFrom-YamlScalar {
         Converts a raw YAML scalar token into the appropriate PowerShell type.
     #>
     [CmdletBinding()]
+    [OutputType([string], [bool], [int], [long], [double])]
     param(
         [Parameter(Mandatory)]
         [AllowEmptyString()]

src/functions/private/ConvertTo-YamlNode.ps1

@@ -56,6 +56,10 @@
 }
 
 function Test-YamlMappingType {
+    <#
+        .SYNOPSIS
+        Returns true when a value should be serialized as a YAML mapping.
+    #>
     [CmdletBinding()]
     [OutputType([bool])]
     param([Parameter()] [AllowNull()] [object] $Value)
@@ -70,6 +74,10 @@ function Test-YamlMappingType {
 }
 
 function Test-YamlSequenceType {
+    <#
+        .SYNOPSIS
+        Returns true when a value should be serialized as a YAML sequence.
+    #>
     [CmdletBinding()]
     [OutputType([bool])]
     param([Parameter()] [AllowNull()] [object] $Value)
@@ -82,6 +90,10 @@ function Test-YamlSequenceType {
 }
 
 function ConvertTo-YamlMapping {
+    <#
+        .SYNOPSIS
+        Writes a mapping value as a YAML block-style mapping into the StringBuilder.
+    #>
     [CmdletBinding()]
     param(
         [Parameter(Mandatory)] [object] $Value,
@@ -142,6 +154,10 @@ function ConvertTo-YamlMapping {
 }
 
 function ConvertTo-YamlSequence {
+    <#
+        .SYNOPSIS
+        Writes a sequence value as a YAML block-style sequence into the StringBuilder.
+    #>
     [CmdletBinding()]
     param(
         [Parameter(Mandatory)] [object] $Value,
@@ -230,6 +246,8 @@ function Get-YamlMappingPair {
         .SYNOPSIS
         Returns a list of [pscustomobject]@{ Key; Value } for a dictionary or PSObject.
     #>
+    [Diagnostics.CodeAnalysis.SuppressMessageAttribute('PSUseOutputTypeCorrectly', '',
+        Justification = 'Comma-unary operator preserves List type; PSScriptAnalyzer misdetects as Object[].')]
     [CmdletBinding()]
     [OutputType([System.Collections.Generic.List[pscustomobject]])]
     param(
@@ -343,6 +361,10 @@ function Format-YamlString {
 }
 
 function Format-YamlDoubleQuoted {
+    <#
+        .SYNOPSIS
+        Wraps a string in double quotes, escaping special characters per YAML rules.
+    #>
     [CmdletBinding()]
     [OutputType([string])]
     param(
@@ -371,6 +393,10 @@ function Format-YamlDoubleQuoted {
 }
 
 function Format-YamlKey {
+    <#
+        .SYNOPSIS
+        Renders a mapping key as a YAML scalar, quoting when necessary.
+    #>
     [CmdletBinding()]
     [OutputType([string])]
     param(

src/functions/public/ConvertFrom-Yaml.ps1

@@ -51,6 +51,8 @@
         System.Collections.Specialized.OrderedDictionary
     #>
     [Alias('ConvertFrom-Yml')]
+    [Diagnostics.CodeAnalysis.SuppressMessageAttribute('PSUseOutputTypeCorrectly', '',
+        Justification = 'Comma-unary operator for -NoEnumerate returns array wrapper; PSScriptAnalyzer misdetects as Object[].')]
     [CmdletBinding()]
     [OutputType([PSCustomObject], [System.Collections.Specialized.OrderedDictionary])]
     param(