Public/Add-FlowchartNode.ps1

function Add-FlowchartNode {

    <#
 
    .SYNOPSIS
    Adds a new node to a flowchart.
 
    .DESCRIPTION
    Create and add a note explicitly to the diagram. You can specify the style via class or geometry.
 
    .LINK
    https://mermaid.js.org/syntax/flowchart.html#node-shapes
 
    #>


    [CmdletBinding()]
    param (
        # The diagram, that the relation is added to.
        [Parameter(ValueFromPipeline)]
        [ValidateNotNull()]
        $Diagram,

        # The identifier of the node.
        [Parameter(Mandatory, Position = 0)]
        [ValidateNotNullOrEmpty()]
        [string] $Key,

        # The node text.
        [Parameter(Position = 1)]
        [Alias('Name')]
        [string] $Text,

        # The node shape.
        [Parameter(Position = 2)]
        [ValidateSet(
            'rectangle',
            'round-edges',
            'stadium',
            'subroutine',
            'cylindrical',
            'circle',
            'asymmetric',
            'rhombus',
            'hexagon',
            'parallelogram',
            'parallelogram-alt',
            'trapezoid',
            'trapezoid-alt',
            'double-circle'
        )]
        [string] $Shape,

        # The class of the node.
        [Parameter()]
        [string] $Class
    )

    process {
        $node = [PSCustomObject]@{
            Key   = $Key
        }

        if ( $Text ) {
            $node | Add-Member Text $Text
        }

        if ( $Shape ) {
            $node | Add-Member Shape $Shape
        }

        if ( $Class ) {
            $node | Add-Member Class $Class
        }

        $Diagram.Nodes += $node
    }

}