Add Get-LineComment filter to extract inline comments from PowerShell…

… code lines

src/functions/public/Lines/Get-LineComment.ps1

@@ -0,0 +1,44 @@
+filter Get-LineComment {
+    <#
+        .SYNOPSIS
+        Extracts the inline comment from a single line of PowerShell code.
+
+        .DESCRIPTION
+        Parses a given line of PowerShell code and extracts any inline comment.
+        If an inline comment exists, the function returns the comment text; otherwise, it returns nothing.
+
+        .EXAMPLE
+        'Get-Process # This retrieves all processes' | Get-LineComment
+
+        Returns: '# This retrieves all processes'
+
+        .EXAMPLE
+        'Write-Host "Hello World"' | Get-LineComment
+
+        Returns: $null (no comment found)
+
+        .LINK
+        https://psmodule.io/AST/Functions/Lines/Get-LineComment/
+    #>
+    [Diagnostics.CodeAnalysis.SuppressMessageAttribute(
+        'PSUseShouldProcessForStateChangingFunctions', '',
+        Justification = 'Does not change state'
+    )]
+    [OutputType([string])]
+    [CmdletBinding()]
+    param (
+        # Input line of PowerShell code from which to extract the comment.
+        [Parameter(
+            Mandatory,
+            ValueFromPipeline
+        )]
+        [string] $Line
+    )
+
+    # Parse the line using the PowerShell parser to obtain its tokens.
+    $tokens = $null
+    $null = [System.Management.Automation.Language.Parser]::ParseInput($Line, [ref]$tokens, [ref]$null)
+
+    # Find comment token(s) in the line.
+    ($tokens | Where-Object { $_.Kind -eq 'Comment' }).Extent.Text
+}