pcb_io_kicad_sexpr_parser.cpp

Go to the documentation of this file.

/*
 * This program source code file is part of KiCad, a free EDA CAD application.
 *
 * Copyright (C) 2012 CERN
 * Copyright The KiCad Developers, see AUTHORS.txt for contributors.
 *
 * This program is free software; you can redistribute it and/or
 * modify it under the terms of the GNU General Public License
 * as published by the Free Software Foundation; either version 2
 * of the License, or (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program.  If not, see <https://www.gnu.org/licenses/>.
 */

 
#include "layer_ids.h"
#include <cerrno>
#include <charconv>
#include <cmath>
#include <confirm.h>
#include <macros.h>
#include <fmt/format.h>
#include <title_block.h>
#include <trigo.h>
 
#include <board.h>
#include <board_design_settings.h>
#include <board_design_settings_defaults.h>
#include <component_classes/component_class_manager.h>
#include <project/net_settings.h>
#include <embedded_files_parser.h>
#include <font/fontconfig.h>
#include <magic_enum.hpp>
#include <pcb_dimension.h>
#include <pcb_shape.h>
#include <pcb_reference_image.h>
#include <pcb_barcode.h>
#include <pcb_group.h>
#include <pcb_generator.h>
#include <pcb_point.h>
#include <pcb_target.h>
#include <pcb_grid_item.h>
#include <pcb_track.h>
#include <pcb_textbox.h>
#include <pcb_drill_chart.h>
#include <pcb_drill_map.h>
#include <pcb_table.h>
#include <pad.h>
#include <generators_mgr.h>
#include <zone.h>
#include <footprint.h>
#include <pcb_3d_body.h>
#include <geometry/shape_line_chain.h>
#include <font/font.h>
#include <core/ignore.h>
#include <netclass.h>
#include <netinfo.h>
#include <pcb_io/kicad_sexpr/pcb_io_kicad_sexpr.h>
#include <pcb_plot_params_parser.h>
#include <pcb_plot_params.h>
#include <zones.h>
#include <pcb_io/kicad_sexpr/pcb_io_kicad_sexpr_parser.h>
#include <convert_basic_shapes_to_polygon.h>    // for RECT_CHAMFER_POSITIONS definition
#include <math/util.h>                           // KiROUND, Clamp
#include <string_utils.h>
#include <stroke_params_parser.h>
#include <wx/log.h>
#include <progress_reporter.h>
#include <board_stackup_manager/stackup_predefined_prms.h>
#include <pgm_base.h>
#include <trace_helpers.h>
 
// For some reason wxWidgets is built with wxUSE_BASE64 unset so expose the wxWidgets
// base64 code. Needed for PCB_REFERENCE_IMAGE
#define wxUSE_BASE64 1
#include <wx/base64.h>
#include <wx/log.h>
#include <wx/mstream.h>
 
// We currently represent board units as integers.  Any values that are
// larger or smaller than those board units represent undefined behavior for
// the system.  We limit values to the largest usable
// i.e. std::numeric_limits<int>::max().
// However to avoid issues in comparisons, use a slightly smaller value
// Note also the usable limits are much smaller to avoid overflows in intermediate
// calculations.
constexpr double INT_LIMIT = std::numeric_limits<int>::max() - 10;
 
using namespace PCB_KEYS_T;
 
 
void PCB_IO_KICAD_SEXPR_PARSER::init()
{
    m_showLegacySegmentZoneWarning = true;
    m_showLegacy5ZoneWarning = true;
    m_tooRecent = false;
    m_requiredVersion = 0;
    m_layerIndices.clear();
    m_layerMasks.clear();
    m_resetKIIDMap.clear();
    m_linkedZones.clear();
 
    // Add untranslated default (i.e. English) layernames.
    // Some may be overridden later if parsing a board rather than a footprint.
    // The English name will survive if parsing only a footprint.
    for( int layer = 0;  layer < PCB_LAYER_ID_COUNT;  ++layer )
    {
        std::string untranslated = TO_UTF8( LSET::Name( PCB_LAYER_ID( layer ) ) );
 
        m_layerIndices[untranslated] = PCB_LAYER_ID( layer );
        m_layerMasks[untranslated] = LSET( { PCB_LAYER_ID( layer ) } );
    }
 
    m_layerMasks[ "*.Cu" ]      = LSET::AllCuMask();
    m_layerMasks[ "*In.Cu" ]    = LSET::InternalCuMask();
    m_layerMasks[ "F&B.Cu" ]    = LSET( { F_Cu, B_Cu } );
    m_layerMasks[ "*.Adhes" ]   = LSET( { B_Adhes, F_Adhes } );
    m_layerMasks[ "*.Paste" ]   = LSET( { B_Paste, F_Paste } );
    m_layerMasks[ "*.Mask" ]    = LSET( { B_Mask,  F_Mask } );
    m_layerMasks[ "*.SilkS" ]   = LSET( { B_SilkS, F_SilkS } );
    m_layerMasks[ "*.Fab" ]     = LSET( { B_Fab,   F_Fab } );
    m_layerMasks[ "*.CrtYd" ]   = LSET( { B_CrtYd, F_CrtYd } );
 
    // This is for the first pretty & *.kicad_pcb formats, which had
    // Inner1_Cu - Inner14_Cu with the numbering sequence
    // reversed from the subsequent format's In1_Cu - In30_Cu numbering scheme.
    // The newer format brought in an additional 16 Cu layers and flipped the cu stack but
    // kept the gap between one of the outside layers and the last cu internal.
 
    for( int i=1; i<=14; ++i )
    {
        std::string key = fmt::format( "Inner{}.Cu", i );
 
        m_layerMasks[key] = LSET( { PCB_LAYER_ID( In15_Cu - 2 * i ) } );
    }
}
 
 
void PCB_IO_KICAD_SEXPR_PARSER::checkpoint()
{
    if( m_progressReporter )
    {
        TIME_PT curTime = CLOCK::now();
        unsigned curLine = reader->LineNumber();
        auto delta = std::chrono::duration_cast<TIMEOUT>( curTime - m_lastProgressTime );
 
        if( delta > std::chrono::milliseconds( 250 ) )
        {
            m_progressReporter->SetCurrentProgress( ( (double) curLine )
                                                            / std::max( 1U, m_lineCount ) );
 
            if( !m_progressReporter->KeepRefreshing() )
                THROW_IO_CANCELLED();
 
            m_lastProgressTime = curTime;
        }
    }
}
 
 
void PCB_IO_KICAD_SEXPR_PARSER::skipCurrent()
{
    int curr_level = 0;
    T token;
 
    while( ( token = NextTok() ) != T_EOF )
    {
        if( token == T_LEFT )
            curr_level--;
 
        if( token == T_RIGHT )
        {
            curr_level++;
 
            if( curr_level > 0 )
                return;
        }
    }
}
 
 
void PCB_IO_KICAD_SEXPR_PARSER::pushValueIntoMap( int aIndex, int aValue )
{
    // Add aValue in netcode mapping (m_netCodes) at index aNetCode
    // ensure there is room in m_netCodes for that, and add room if needed.
 
    if( (int)m_netCodes.size() <= aIndex )
        m_netCodes.resize( static_cast<std::size_t>( aIndex ) + 1 );
 
    m_netCodes[aIndex] = aValue;
}
 
 
int PCB_IO_KICAD_SEXPR_PARSER::parseBoardUnits()
{
    // There should be no major rounding issues here, since the values in
    // the file are in mm and get converted to nano-meters.
    // See test program tools/test-nm-biu-to-ascii-mm-round-tripping.cpp
    // to confirm or experiment.  Use a similar strategy in both places, here
    // and in the test program. Make that program with:
    // $ make test-nm-biu-to-ascii-mm-round-tripping
    auto retval = parseDouble() * pcbIUScale.IU_PER_MM;
 
    // N.B. we currently represent board units as integers.  Any values that are
    // larger or smaller than those board units represent undefined behavior for
    // the system.  We limit values to the largest that is visible on the screen
    return KiROUND( std::clamp( retval, -INT_LIMIT, INT_LIMIT ) );
}
 
 
int PCB_IO_KICAD_SEXPR_PARSER::parseBoardUnits( const char*         aExpected,
                                                const EDA_DATA_TYPE aDataType = EDA_DATA_TYPE::DISTANCE )
{
    const double scale = EDA_UNIT_UTILS::GetScaleForInternalUnitType( pcbIUScale, aDataType );
    auto         retval = parseDouble( aExpected ) * scale;
 
    // N.B. we currently represent board units as integers.  Any values that are
    // larger or smaller than those board units represent undefined behavior for
    // the system.  We limit values to the largest that is visible on the screen
    return KiROUND( std::clamp( retval, -INT_LIMIT, INT_LIMIT ) );
}
 
 
bool PCB_IO_KICAD_SEXPR_PARSER::parseBool()
{
    T token = NextTok();
 
    if( token == T_yes )
        return true;
    else if( token == T_no )
        return false;
    else
        Expecting( "yes or no" );
 
    return false;
}
 
 
std::optional<bool> PCB_IO_KICAD_SEXPR_PARSER::parseOptBool()
{
    T token = NextTok();
 
    if( token == T_yes )
        return true;
    else if( token == T_no )
        return false;
    else if( token == T_none )
        return std::nullopt;
    else
        Expecting( "yes, no or none" );
 
    return false;
}
 
 
/*
 * e.g. "hide", "hide)", "(hide yes)"
 */
bool PCB_IO_KICAD_SEXPR_PARSER::parseMaybeAbsentBool( bool aDefaultValue )
{
    bool ret = aDefaultValue;
 
    if( PrevTok() == T_LEFT )
    {
        T token = NextTok();
 
        // "hide)"
        if( static_cast<int>( token ) == DSN_RIGHT )
            return aDefaultValue;
 
        if( token == T_yes || token == T_true )
            ret = true;
        else if( token == T_no || token == T_false )
            ret = false;
        else
            Expecting( "yes or no" );
 
        NeedRIGHT();
    }
    else
    {
        // "hide"
        return aDefaultValue;
    }
 
    return ret;
}
 
 
void PCB_IO_KICAD_SEXPR_PARSER::parseNet( BOARD_CONNECTED_ITEM* aItem )
{
    int token = NextTok();
 
    // Legacy files (pre-10.0) will have a netcode instead of a netname.  This netcode
    // is authoratative (though may be mapped by getNetCode() to prevent collisions).
    if( IsNumber( token ) )
    {
        if( !aItem->SetNetCode( std::max( 0, getNetCode( parseInt() ) ), /* aNoAssert */ true ) )
        {
            wxLogTrace( traceKicadPcbPlugin,
                        _( "Invalid net ID in\nfile: %s;\nline: %d\noffset: %d." ),
                        CurSource(), CurLineNumber(), CurOffset() );
        }
 
        NeedRIGHT();
        return;
    }
 
    if( !IsSymbol( token ) )
    {
        Expecting( "net name" );
        return;
    }
 
    if( m_board )
    {
        wxString netName( FromUTF8() );
 
        // Convert overbar syntax from `~...~` to `~{...}`.  These were left out of the
        // first merge so the version is a bit later.
        if( m_requiredVersion < 20210606 )
            netName = ConvertToNewOverbarNotation( netName );
 
        NETINFO_ITEM* netinfo = m_board->FindNet( netName );
 
        if( !netinfo )
        {
            netinfo = new NETINFO_ITEM( m_board, netName );
            m_board->Add( netinfo, ADD_MODE::INSERT, true );
        }
 
        aItem->SetNet( netinfo );
    }
 
    NeedRIGHT();
}
 
 
wxString PCB_IO_KICAD_SEXPR_PARSER::GetRequiredVersion()
{
    int year, month, day;
 
    year = m_requiredVersion / 10000;
    month = ( m_requiredVersion / 100 ) - ( year * 100 );
    day = m_requiredVersion - ( year * 10000 ) - ( month * 100 );
 
    // wx throws an assertion, not a catchable exception, when the date is invalid.
    // User input shouldn't give wx asserts, so check manually and throw a proper
    // error instead
    if( day <= 0 || month <= 0 || month > 12 ||
            day > wxDateTime::GetNumberOfDays( (wxDateTime::Month)( month - 1 ), year ) )
    {
        wxString err;
        err.Printf( _( "Cannot interpret date code %d" ), m_requiredVersion );
        THROW_PARSE_ERROR( err, CurSource(), CurLine(), CurLineNumber(), CurOffset() );
    }
 
    wxDateTime date( day, (wxDateTime::Month)( month - 1 ), year, 0, 0, 0, 0 );
    return date.FormatDate();
}
 
 
VECTOR2I PCB_IO_KICAD_SEXPR_PARSER::parseXY()
{
    if( CurTok() != T_LEFT )
        NeedLEFT();
 
    VECTOR2I pt;
    T token = NextTok();
 
    if( token != T_xy )
        Expecting( T_xy );
 
    pt.x = parseBoardUnits( "X coordinate" );
    pt.y = parseBoardUnits( "Y coordinate" );
 
    NeedRIGHT();
 
    return pt;
}
 
 
void PCB_IO_KICAD_SEXPR_PARSER::parseOutlinePoints( SHAPE_LINE_CHAIN& aPoly )
{
    if( CurTok() != T_LEFT )
        NeedLEFT();
 
    T token = NextTok();
 
    switch( token )
    {
    case T_xy:
    {
        int x = parseBoardUnits( "X coordinate" );
        int y = parseBoardUnits( "Y coordinate" );
 
        NeedRIGHT();
 
        aPoly.Append( x, y );
        break;
    }
    case T_arc:
    {
        bool has_start = false;
        bool has_mid   = false;
        bool has_end   = false;
 
        VECTOR2I arc_start, arc_mid, arc_end;
 
        for( token = NextTok(); token != T_RIGHT; token = NextTok() )
        {
            if( token != T_LEFT )
                Expecting( T_LEFT );
 
            token = NextTok();
 
            switch( token )
            {
            case T_start:
                arc_start.x = parseBoardUnits( "start x" );
                arc_start.y = parseBoardUnits( "start y" );
                has_start = true;
                break;
 
            case T_mid:
                arc_mid.x = parseBoardUnits( "mid x" );
                arc_mid.y = parseBoardUnits( "mid y" );
                has_mid = true;
                break;
 
            case T_end:
                arc_end.x = parseBoardUnits( "end x" );
                arc_end.y = parseBoardUnits( "end y" );
                has_end = true;
                break;
 
            default:
                Expecting( "start, mid or end" );
            }
 
            NeedRIGHT();
        }
 
        if( !has_start )
            Expecting( "start" );
 
        if( !has_mid )
            Expecting( "mid" );
 
        if( !has_end )
            Expecting( "end" );
 
        SHAPE_ARC arc( arc_start, arc_mid, arc_end, 0 );
 
        aPoly.Append( arc );
 
        if( token != T_RIGHT )
            Expecting( T_RIGHT );
 
        break;
    }
    default:
        Expecting( "xy or arc" );
    }
}
 
 
void PCB_IO_KICAD_SEXPR_PARSER::parseXY( int* aX, int* aY )
{
    VECTOR2I pt = parseXY();
 
    if( aX )
        *aX = pt.x;
 
    if( aY )
        *aY = pt.y;
}
 
 
void PCB_IO_KICAD_SEXPR_PARSER::parseMargins( int& aLeft, int& aTop, int& aRight, int& aBottom )
{
    aLeft = parseBoardUnits( "left margin" );
    aTop = parseBoardUnits( "top margin" );
    aRight = parseBoardUnits( "right margin" );
    aBottom = parseBoardUnits( "bottom margin" );
}
 
 
std::pair<wxString, wxString> PCB_IO_KICAD_SEXPR_PARSER::parseBoardProperty()
{
    wxString pName;
    wxString pValue;
 
    NeedSYMBOL();
    pName = FromUTF8();
    NeedSYMBOL();
    pValue = FromUTF8();
    NeedRIGHT();
 
    return { pName, pValue };
}
 
 
void PCB_IO_KICAD_SEXPR_PARSER::parseCustomProperty( EDA_ITEM* aItem )
{
    NeedSYMBOL();
    wxString key = FromUTF8();
    NeedSYMBOL();
    wxString value = FromUTF8();
    aItem->SetCustomProperty( key, value );
    NeedRIGHT();
}
 
 
void PCB_IO_KICAD_SEXPR_PARSER::parseCustomProperty( std::map<wxString, wxString>& aProps )
{
    NeedSYMBOL();
    wxString key = FromUTF8();
    NeedSYMBOL();
    wxString value = FromUTF8();
    aProps[key] = value;
    NeedRIGHT();
}
 
 
void PCB_IO_KICAD_SEXPR_PARSER::parseVariants()
{
    // (variants
    //   (variant (name "VariantA") (description "Description A"))
    //   (variant (name "VariantB") (description "Description B"))
    // )
    for( T token = NextTok(); token != T_RIGHT; token = NextTok() )
    {
        if( token == T_LEFT )
            token = NextTok();
 
        if( token == T_variant )
        {
            wxString variantName;
            wxString description;
 
            for( token = NextTok(); token != T_RIGHT; token = NextTok() )
            {
                if( token == T_LEFT )
                    token = NextTok();
 
                switch( token )
                {
                case T_name:
                    NeedSYMBOL();
                    variantName = FromUTF8();
                    NeedRIGHT();
                    break;
 
                case T_description:
                    NeedSYMBOL();
                    description = FromUTF8();
                    NeedRIGHT();
                    break;
 
                default:
                    Expecting( "name or description" );
                }
            }
 
            if( !variantName.IsEmpty() )
            {
                m_board->AddVariant( variantName );
 
                if( !description.IsEmpty() )
                    m_board->SetVariantDescription( variantName, description );
            }
        }
        else
        {
            Expecting( T_variant );
        }
    }
}
 
 
void PCB_IO_KICAD_SEXPR_PARSER::parseFootprintVariant( FOOTPRINT* aFootprint )
{
    // (variant (name "VariantA") (dnp yes) (exclude_from_bom yes) (exclude_from_sim yes)
    //   (exclude_from_pos_files yes)
    //   (field (name "Value") (value "100nF")))
    wxString variantName;
    bool     hasDnp = false;
    bool     dnp = false;
    bool     hasExcludeFromBOM = false;
    bool     excludeFromBOM = false;
    bool     hasExcludeFromSim = false;
    bool     excludeFromSim = false;
    bool     hasExcludeFromPosFiles = false;
    bool     excludeFromPosFiles = false;
    std::vector<std::pair<wxString, wxString>> fields;
 
    for( T token = NextTok(); token != T_RIGHT; token = NextTok() )
    {
        if( token == T_LEFT )
            token = NextTok();
 
        switch( token )
        {
        case T_name:
            NeedSYMBOL();
            variantName = FromUTF8();
            NeedRIGHT();
            break;
 
        case T_dnp:
            dnp = parseMaybeAbsentBool( true );
            hasDnp = true;
            break;
 
        case T_exclude_from_bom:
            excludeFromBOM = parseMaybeAbsentBool( true );
            hasExcludeFromBOM = true;
            break;
 
        case T_exclude_from_sim:
            excludeFromSim = parseMaybeAbsentBool( true );
            hasExcludeFromSim = true;
            break;
 
        case T_exclude_from_pos_files:
            excludeFromPosFiles = parseMaybeAbsentBool( true );
            hasExcludeFromPosFiles = true;
            break;
 
        case T_field:
        {
            wxString fieldName;
            wxString fieldValue;
 
            for( token = NextTok(); token != T_RIGHT; token = NextTok() )
            {
                if( token == T_LEFT )
                    token = NextTok();
 
                if( token == T_name )
                {
                    NeedSYMBOL();
                    fieldName = FromUTF8();
                    NeedRIGHT();
                }
                else if( token == T_value )
                {
                    NeedSYMBOL();
                    fieldValue = FromUTF8();
                    NeedRIGHT();
                }
                else
                {
                    Expecting( "name or value" );
                }
            }
 
            if( !fieldName.IsEmpty() )
                fields.emplace_back( fieldName, fieldValue );
 
            break;
        }
 
        default:
            Expecting( "name, dnp, exclude_from_bom, exclude_from_sim, exclude_from_pos_files, or field" );
        }
    }
 
    if( variantName.IsEmpty() )
        return;
 
    FOOTPRINT_VARIANT* variant = aFootprint->AddVariant( variantName );
 
    if( !variant )
        return;
 
    if( hasDnp )
        variant->SetDNP( dnp );
 
    if( hasExcludeFromBOM )
        variant->SetExcludedFromBOM( excludeFromBOM );
 
    if( hasExcludeFromSim )
        variant->SetExcludedFromSim( excludeFromSim );
 
    if( hasExcludeFromPosFiles )
        variant->SetExcludedFromPosFiles( excludeFromPosFiles );
 
    for( const auto& [fieldName, fieldValue] : fields )
        variant->SetFieldValue( fieldName, fieldValue );
}
 
 
void PCB_IO_KICAD_SEXPR_PARSER::parseTEARDROP_PARAMETERS( TEARDROP_PARAMETERS* tdParams )
{
    tdParams->m_Enabled = false;
    tdParams->m_AllowUseTwoTracks = false;
    tdParams->m_TdOnPadsInZones = true;
 
    for( T token = NextTok();  token != T_RIGHT;  token = NextTok() )
    {
        if( token == T_LEFT )
            token = NextTok();
 
        switch( token )
        {
        case T_enabled:
            tdParams->m_Enabled = parseMaybeAbsentBool( true );
            break;
 
        case T_allow_two_segments:
            tdParams->m_AllowUseTwoTracks = parseMaybeAbsentBool( true );
            break;
 
        case T_prefer_zone_connections:
            tdParams->m_TdOnPadsInZones = !parseMaybeAbsentBool( false );
            break;
 
        case T_best_length_ratio:
            tdParams->m_BestLengthRatio = parseDouble( "teardrop best length ratio" );
            NeedRIGHT();
            break;
 
        case T_max_length:
            tdParams->m_TdMaxLen = parseBoardUnits( "teardrop max length" );
            NeedRIGHT();
            break;
 
        case T_best_width_ratio:
            tdParams->m_BestWidthRatio = parseDouble( "teardrop best width ratio" );
            NeedRIGHT();
            break;
 
        case T_max_width:
            tdParams->m_TdMaxWidth = parseBoardUnits( "teardrop max width" );
            NeedRIGHT();
            break;
 
        // Legacy token
        case T_curve_points:
            tdParams->m_CurvedEdges = parseInt( "teardrop curve points count" ) > 0;
            NeedRIGHT();
            break;
 
        case T_curved_edges:
            tdParams->m_CurvedEdges = parseMaybeAbsentBool( true );
            break;
 
        case T_filter_ratio:
            tdParams->m_WidthtoSizeFilterRatio = parseDouble( "teardrop filter ratio" );
            NeedRIGHT();
            break;
 
        default:
            Expecting( "enabled, allow_two_segments, prefer_zone_connections, best_length_ratio, "
                       "max_length, best_width_ratio, max_width, curve_points or filter_ratio" );
        }
    }
}
 
 
void PCB_IO_KICAD_SEXPR_PARSER::parseEDA_TEXT( EDA_TEXT* aText )
{
    wxCHECK_RET( CurTok() == T_effects,
                 wxT( "Cannot parse " ) + GetTokenString( CurTok() ) + wxT( " as EDA_TEXT." ) );
 
    // These are not written out if center/center and/or no mirror,
    // so we have to make sure we start that way.
    // (these parameters will be set in T_justify section, when existing)
    aText->SetHorizJustify( GR_TEXT_H_ALIGN_CENTER );
    aText->SetVertJustify( GR_TEXT_V_ALIGN_CENTER );
    aText->SetMirrored( false );
 
    // In version 20210606 the notation for overbars was changed from `~...~` to `~{...}`.
    // We need to convert the old syntax to the new one.
    if( m_requiredVersion < 20210606 )
        aText->SetText( ConvertToNewOverbarNotation( aText->GetText() ) );
 
    T token;
 
    // Prior to v5.0 text size was omitted from file format if equal to 60mils
    // Now, it is always explicitly written to file
    bool foundTextSize = false;
 
    for( token = NextTok();  token != T_RIGHT;  token = NextTok() )
    {
        if( token == T_LEFT )
            token = NextTok();
 
        switch( token )
        {
        case T_font:
            for( token = NextTok();  token != T_RIGHT;  token = NextTok() )
            {
                if( token == T_LEFT )
                    continue;
 
                switch( token )
                {
                case T_face:
                    NeedSYMBOL();
                    aText->SetUnresolvedFontName( FromUTF8() );
                    NeedRIGHT();
                    break;
 
                case T_size:
                {
                    VECTOR2I sz;
                    sz.y = parseBoardUnits( "text height" );
                    sz.x = parseBoardUnits( "text width" );
                    aText->SetTextSize( sz );
                    NeedRIGHT();
 
                    foundTextSize = true;
                    break;
                }
 
                case T_line_spacing:
                    aText->SetLineSpacing( parseDouble( "line spacing" ) );
                    NeedRIGHT();
                    break;
 
                case T_thickness:
                    aText->SetTextThickness( parseBoardUnits( "text thickness" ) );
                    NeedRIGHT();
                    break;
 
                case T_bold:
                    aText->SetBoldFlag( parseMaybeAbsentBool( true ) );
                    break;
 
                case T_italic:
                    aText->SetItalicFlag( parseMaybeAbsentBool( true ) );
                    break;
 
                default:
                    Expecting( "face, size, line_spacing, thickness, bold, or italic" );
                }
            }
 
            break;
 
        case T_justify:
            for( token = NextTok();  token != T_RIGHT;  token = NextTok() )
            {
                if( token == T_LEFT )
                    continue;
 
                switch( token )
                {
                case T_left:   aText->SetHorizJustify( GR_TEXT_H_ALIGN_LEFT );     break;
                case T_right:  aText->SetHorizJustify( GR_TEXT_H_ALIGN_RIGHT );    break;
                case T_top:    aText->SetVertJustify( GR_TEXT_V_ALIGN_TOP );       break;
                case T_bottom: aText->SetVertJustify( GR_TEXT_V_ALIGN_BOTTOM );    break;
                case T_mirror: aText->SetMirrored( true );                         break;
                default:       Expecting( "left, right, top, bottom, or mirror" );
                }
 
            }
 
            break;
 
        case T_hide:
        {
            // In older files, the hide token appears bare, and indicates hide==true.
            // In newer files, it will be an explicit bool in a list like (hide yes)
            bool hide = parseMaybeAbsentBool( true );
            aText->SetVisible( !hide );
            break;
        }
 
        default:
            Expecting( "font, justify, or hide" );
        }
    }
 
    // Text size was not specified in file, force legacy default units
    // 60mils is 1.524mm
    if( !foundTextSize )
    {
        const double defaultTextSize = 1.524 * pcbIUScale.IU_PER_MM;
 
        aText->SetTextSize( VECTOR2I( defaultTextSize, defaultTextSize ) );
    }
 
    if( m_requiredVersion < 20260826 )
        aText->MigrateLegacyBoldStrokeWidth();
}
 
 
void PCB_IO_KICAD_SEXPR_PARSER::parseRenderCache( EDA_TEXT* text )
{
    T token;
 
    NeedSYMBOLorNUMBER();
    wxString  cacheText = From_UTF8( CurText() );
    EDA_ANGLE cacheAngle( parseDouble( "render cache angle" ), DEGREES_T );
 
    text->SetupRenderCache( cacheText, text->GetFont(), cacheAngle, { 0, 0 } );
 
    for( token = NextTok(); token != T_RIGHT; token = NextTok() )
    {
        if( token != T_LEFT )
            Expecting( T_LEFT );
 
        token = NextTok();
 
        if( token != T_polygon )
            Expecting( T_polygon );
 
        SHAPE_POLY_SET poly;
 
        for( token = NextTok(); token != T_RIGHT; token = NextTok() )
        {
            if( token != T_LEFT )
                Expecting( T_LEFT );
 
            token = NextTok();
 
            if( token != T_pts )
                Expecting( T_pts );
 
            SHAPE_LINE_CHAIN lineChain;
 
            while( (token = NextTok() ) != T_RIGHT )
                parseOutlinePoints( lineChain );
 
            lineChain.SetClosed( true );
 
            if( poly.OutlineCount() == 0 )
                poly.AddOutline( lineChain );
            else
                poly.AddHole( lineChain );
        }
 
        text->AddRenderCacheGlyph( poly );
    }
}
 
 
FP_3DMODEL* PCB_IO_KICAD_SEXPR_PARSER::parse3DModel( bool aFileNameAlreadyParsed )
{
    if( !aFileNameAlreadyParsed )
    {
        wxCHECK_MSG( CurTok() == T_model, nullptr,
                     wxT( "Cannot parse " ) + GetTokenString( CurTok() ) + wxT( " as FP_3DMODEL." ) );
 
        NeedSYMBOLorNUMBER();
    }
 
    T token;
 
    FP_3DMODEL* n3D = new FP_3DMODEL;
    n3D->m_Filename = FromUTF8();
 
    for( token = NextTok();  token != T_RIGHT;  token = NextTok() )
    {
        if( token == T_LEFT )
            token = NextTok();
 
        switch( token )
        {
        case T_at:
            NeedLEFT();
            token = NextTok();
 
            if( token != T_xyz )
                Expecting( T_xyz );
 
            /* Note:
             * Prior to KiCad v5, model offset was designated by "at",
             * and the units were in inches.
             * Now we use mm, but support reading of legacy files
             */
 
            n3D->m_Offset.x = parseDouble( "x value" ) * 25.4f;
            n3D->m_Offset.y = parseDouble( "y value" ) * 25.4f;
            n3D->m_Offset.z = parseDouble( "z value" ) * 25.4f;
 
            NeedRIGHT();    // xyz
            NeedRIGHT();    // at
            break;
 
        case T_hide:
        {
            // In older files, the hide token appears bare, and indicates hide==true.
            // In newer files, it will be an explicit bool in a list like (hide yes)
            bool hide = parseMaybeAbsentBool( true );
            n3D->m_Show = !hide;
            break;
        }
 
        case T_opacity:
            n3D->m_Opacity = parseDouble( "opacity value" );
            NeedRIGHT();
            break;
 
        case T_offset:
            NeedLEFT();
            token = NextTok();
 
            if( token != T_xyz )
                Expecting( T_xyz );
 
            /*
             * 3D model offset is in mm
             */
            n3D->m_Offset.x = parseDouble( "x value" );
            n3D->m_Offset.y = parseDouble( "y value" );
            n3D->m_Offset.z = parseDouble( "z value" );
 
            NeedRIGHT();    // xyz
            NeedRIGHT();    // offset
            break;
 
        case T_scale:
            NeedLEFT();
            token = NextTok();
 
            if( token != T_xyz )
                Expecting( T_xyz );
 
            n3D->m_Scale.x = parseDouble( "x value" );
            n3D->m_Scale.y = parseDouble( "y value" );
            n3D->m_Scale.z = parseDouble( "z value" );
 
            NeedRIGHT();    // xyz
            NeedRIGHT();    // scale
            break;
 
        case T_rotate:
            NeedLEFT();
            token = NextTok();
 
            if( token != T_xyz )
                Expecting( T_xyz );
 
            n3D->m_Rotation.x = parseDouble( "x value" );
            n3D->m_Rotation.y = parseDouble( "y value" );
            n3D->m_Rotation.z = parseDouble( "z value" );
 
            NeedRIGHT();    // xyz
            NeedRIGHT();    // rotate
            break;
 
        default:
            Expecting( "at, hide, opacity, offset, scale, or rotate" );
        }
 
    }
 
    return n3D;
}
 
 
bool PCB_IO_KICAD_SEXPR_PARSER::IsValidBoardHeader()
{
    m_groupInfos.clear();
    m_constraintInfos.clear();
 
    // See Parse() - FOOTPRINTS can be prefixed with an initial block of single line comments,
    // eventually BOARD might be the same
    ReadCommentLines();
 
    if( CurTok() != T_LEFT  )
        return false;
 
    if( NextTok() != T_kicad_pcb)
        return false;
 
    return true;
}
 
 
BOARD_ITEM* PCB_IO_KICAD_SEXPR_PARSER::Parse()
{
    T               token;
    BOARD_ITEM*     item;
 
    m_groupInfos.clear();
    m_constraintInfos.clear();
 
    // FOOTPRINTS can be prefixed with an initial block of single line comments and these are
    // kept for Format() so they round trip in s-expression form.  BOARDs might  eventually do
    // the same, but currently do not.
    std::unique_ptr<wxArrayString> initial_comments( ReadCommentLines() );
 
    token = CurTok();
 
    if( token == -1 )   // EOF
        Unexpected( token );
 
    if( token != T_LEFT )
        Expecting( T_LEFT );
 
    switch( NextTok() )
    {
    case T_kicad_pcb:
        if( m_board == nullptr )
            m_board = new BOARD();
 
        item = parseBOARD();
        break;
 
    case T_module:      // legacy token
    case T_footprint:
        item = parseFOOTPRINT( initial_comments.release() );
 
        // Locking a footprint has no meaning outside of a board.
        item->SetLocked( false );
        break;
 
    default:
        wxString err;
        err.Printf( _( "Unknown token '%s'" ), FromUTF8() );
        THROW_PARSE_ERROR( err, CurSource(), CurLine(), CurLineNumber(), CurOffset() );
    }
 
    const std::vector<wxString>* embeddedFonts = item->GetEmbeddedFiles()->UpdateFontFiles();
 
    item->RunOnChildren(
            [&]( BOARD_ITEM* aChild )
            {
                if( EDA_TEXT* textItem = dynamic_cast<EDA_TEXT*>( aChild ) )
                    textItem->ResolveFont( embeddedFonts );
            },
            RECURSE_MODE::RECURSE );
 
    resolveGroups( item );
    resolveConstraints( item );
 
    return item;
}
 
 
BOARD* PCB_IO_KICAD_SEXPR_PARSER::parseBOARD()
{
    try
    {
        return parseBOARD_unchecked();
    }
    catch( const PARSE_ERROR& parse_error )
    {
        if( m_tooRecent )
            throw FUTURE_FORMAT_ERROR( parse_error, GetRequiredVersion() );
        else
            throw;
    }
}
 
 
BOARD* PCB_IO_KICAD_SEXPR_PARSER::parseBOARD_unchecked()
{
    T token;
    std::map<wxString, wxString> properties;
 
    parseHeader();
 
    auto checkVersion =
            [&]()
            {
                if( m_requiredVersion > SEXPR_BOARD_FILE_VERSION )
                {
                    throw FUTURE_FORMAT_ERROR( fmt::format( "{}", m_requiredVersion ),
                                               m_generatorVersion );
                }
            };
 
    std::vector<BOARD_ITEM*> bulkAddedItems;
    BOARD_ITEM* item = nullptr;
 
    for( token = NextTok();  token != T_RIGHT;  token = NextTok() )
    {
        checkpoint();
 
        if( token != T_LEFT )
            Expecting( T_LEFT );
 
        token = NextTok();
 
        if( token == T_page && m_requiredVersion <= 20200119 )
            token = T_paper;
 
        switch( token )
        {
        case T_host:            // legacy token
            NeedSYMBOL();
            m_board->SetGenerator( FromUTF8() );
 
            // Older formats included build data
            if( m_requiredVersion < BOARD_FILE_HOST_VERSION )
                NeedSYMBOL();
 
            NeedRIGHT();
            break;
 
        case T_generator:
            NeedSYMBOL();
            m_board->SetGenerator( FromUTF8() );
            NeedRIGHT();
            break;
 
        case T_generator_version:
        {
            NeedSYMBOL();
            m_generatorVersion = FromUTF8();
            NeedRIGHT();
 
            // If the format includes a generator version, by this point we have enough info to
            // do the version check here
            checkVersion();
 
            break;
        }
 
        case T_general:
            // Do another version check here, for older files that do not include generator_version
            checkVersion();
 
            parseGeneralSection();
            break;
 
        case T_paper:
            parsePAGE_INFO();
            break;
 
        case T_title_block:
            parseTITLE_BLOCK();
            break;
 
        case T_layers:
            parseLayers();
            break;
 
        case T_setup:
            parseSetup();
            break;
 
        case T_property:
            properties.insert( parseBoardProperty() );
            break;
 
        case T_variants:
            parseVariants();
            break;
 
        case T_net:
            parseNETINFO_ITEM();
            break;
 
        case T_net_chains:
            parseNET_CHAINS_SECTION();
            break;
 
        case T_net_class:
            parseNETCLASS();
            m_board->m_LegacyNetclassesLoaded = true;
            break;
 
        case T_gr_arc:
        case T_gr_curve:
        case T_gr_line:
        case T_gr_poly:
        case T_gr_circle:
        case T_gr_rect:
        case T_gr_ellipse:
        case T_gr_ellipse_arc:
            item = parsePCB_SHAPE( m_board );
            m_board->Add( item, ADD_MODE::BULK_APPEND, true );
            bulkAddedItems.push_back( item );
            break;
 
        case T_image:
            item = parsePCB_REFERENCE_IMAGE( m_board );
            m_board->Add( item, ADD_MODE::BULK_APPEND, true );
            bulkAddedItems.push_back( item );
            break;
 
        case T_barcode:
            item = parsePCB_BARCODE( m_board );
            m_board->Add( item, ADD_MODE::BULK_APPEND, true );
            bulkAddedItems.push_back( item );
            break;
 
        case T_gr_text:
            item = parsePCB_TEXT( m_board );
            m_board->Add( item, ADD_MODE::BULK_APPEND, true );
            bulkAddedItems.push_back( item );
            break;
 
        case T_gr_text_box:
            item = parsePCB_TEXTBOX( m_board );
            m_board->Add( item, ADD_MODE::BULK_APPEND, true );
            bulkAddedItems.push_back( item );
            break;
 
        case T_drill_chart:
            item = parseGeneratedTable( std::make_unique<PCB_DRILL_CHART>( m_board ) );
            m_board->Add( item, ADD_MODE::BULK_APPEND, true );
            bulkAddedItems.push_back( item );
            break;
 
        case T_drill_map:
            item = parsePCB_DRILL_MAP( m_board );
            m_board->Add( item, ADD_MODE::BULK_APPEND, true );
            bulkAddedItems.push_back( item );
            break;
 
        case T_table:
            item = parsePCB_TABLE( m_board );
            m_board->Add( item, ADD_MODE::BULK_APPEND, true );
            bulkAddedItems.push_back( item );
            break;
 
        case T_dimension:
            item = parseDIMENSION( m_board );
            m_board->Add( item, ADD_MODE::BULK_APPEND, true );
            bulkAddedItems.push_back( item );
            break;
 
        case T_module:      // legacy token
        case T_footprint:
            item = parseFOOTPRINT();
            m_board->Add( item, ADD_MODE::BULK_APPEND, true );
            bulkAddedItems.push_back( item );
            break;
 
        case T_segment:
            if( PCB_TRACK* track = parsePCB_TRACK() )
            {
                m_board->Add( track, ADD_MODE::BULK_APPEND, true );
                bulkAddedItems.push_back( track );
            }
 
            break;
 
        case T_arc:
            if( PCB_TRACK* arc = parseARC() )
            {
                m_board->Add( arc, ADD_MODE::BULK_APPEND, true );
                bulkAddedItems.push_back( arc );
            }
 
            break;
 
        case T_group:
            parseGROUP( m_board );
            break;
 
        case T_constraint:
            parseCONSTRAINT( m_board );
            break;
 
        case T_generated:
            parseGENERATOR( m_board );
            break;
 
        case T_via:
            item = parsePCB_VIA();
            m_board->Add( item, ADD_MODE::BULK_APPEND, true );
            bulkAddedItems.push_back( item );
            break;
 
        case T_zone:
        {
            ZONE* zone = parseZONE( m_board );
 
            if( zone->GetNumCorners() == 0 )
            {
                // Zones with no outline vertices are degenerate and can cause crashes
                // elsewhere. Silently discard them.
                delete zone;
                break;
            }
 
            item = zone;
            m_board->Add( item, ADD_MODE::BULK_APPEND, true );
            bulkAddedItems.push_back( item );
            break;
        }
 
        case T_target:
            item = parsePCB_TARGET();
            m_board->Add( item, ADD_MODE::BULK_APPEND, true );
            bulkAddedItems.push_back( item );
            break;
 
        case T_point:
            item = parsePCB_POINT();
            m_board->Add( item, ADD_MODE::BULK_APPEND, true );
            bulkAddedItems.push_back( item );
            break;
 
        case T_grid_item:
            item = parsePCB_GRID_ITEM();
            m_board->Add( item, ADD_MODE::BULK_APPEND, true );
            bulkAddedItems.push_back( item );
            break;
 
        case T_embedded_fonts:
        {
            bool embedFonts = parseBool();
 
            // An append must not clear the destination's flag; saving with it off deletes the
            // fonts the destination already embedded
            if( m_appendToExisting )
                embedFonts = embedFonts || m_board->GetEmbeddedFiles()->GetAreFontsEmbedded();
 
            m_board->GetEmbeddedFiles()->SetAreFontsEmbedded( embedFonts );
            NeedRIGHT();
            break;
        }
 
        case T_embedded_files:
        {
            EMBEDDED_FILES_PARSER embeddedFilesParser( reader );
            embeddedFilesParser.SyncLineReaderWith( *this );
 
            try
            {
                embeddedFilesParser.ParseEmbedded( m_board->GetEmbeddedFiles() );
            }
            catch( const PARSE_ERROR& e )
            {
                m_parseWarnings.push_back( e.What() );
 
                // ParseEmbedded may have stopped mid-section. Skip remaining
                // tokens so the board parser doesn't see them at the top level.
                int depth = 0;
 
                for( int tok = embeddedFilesParser.NextTok();
                     tok != DSN_EOF;
                     tok = embeddedFilesParser.NextTok() )
                {
                    if( tok == DSN_LEFT )
                        depth++;
                    else if( tok == DSN_RIGHT && --depth < 0 )
                        break;
                }
            }
 
            SyncLineReaderWith( embeddedFilesParser );
            break;
        }
 
        default:
            wxString err;
            err.Printf( _( "Unknown token '%s'" ), FromUTF8() );
            THROW_PARSE_ERROR( err, CurSource(), CurLine(), CurLineNumber(), CurOffset() );
        }
    }
 
    if( bulkAddedItems.size() > 0 )
        m_board->FinalizeBulkAdd( bulkAddedItems );
 
    m_board->SetProperties( properties );
 
    // Re-assemble any barcodes now that board properties (text variables) are available.
    // When barcodes are parsed, AssembleBarcode() is called before board properties are set,
    // so text variables in human-readable text remain unexpanded. Re-assembling now ensures
    // variables like ${PART_NUMBER} are properly expanded in the displayed text.
    for( BOARD_ITEM* bc_item : m_board->Drawings() )
    {
        if( bc_item->Type() == PCB_BARCODE_T )
            static_cast<PCB_BARCODE*>( bc_item )->AssembleBarcode();
    }
 
    for( FOOTPRINT* fp : m_board->Footprints() )
    {
        for( BOARD_ITEM* bc_item : fp->GraphicalItems() )
        {
            if( bc_item->Type() == PCB_BARCODE_T )
                static_cast<PCB_BARCODE*>( bc_item )->AssembleBarcode();
        }
    }
 
    if( m_undefinedLayers.size() > 0 )
    {
        PCB_LAYER_ID destLayer = Cmts_User;
        wxString msg, undefinedLayerNames, destLayerName;
 
        for( const wxString& layerName : m_undefinedLayers )
        {
            if( !undefinedLayerNames.IsEmpty() )
                undefinedLayerNames += wxT( ", " );
 
            undefinedLayerNames += layerName;
        }
 
        destLayerName = m_board->GetLayerName( destLayer );
 
        if( Pgm().IsGUI() && m_queryUserCallback )
        {
            msg.Printf( _( "Items found on undefined layers (%s).\n"
                           "Do you wish to rescue them to the %s layer?\n"
                           "\n"
                           "Zones will need to be refilled." ),
                        undefinedLayerNames, destLayerName );
 
            if( !m_queryUserCallback( _( "Undefined Layers Warning" ), wxICON_WARNING, msg,
                                      _( "Rescue" ) ) )
            {
                THROW_IO_CANCELLED();
            }
 
            // Make sure the destination layer is enabled, even if not in the file
            m_board->SetEnabledLayers( LSET( m_board->GetEnabledLayers() ).set( destLayer ) );
 
            const auto visitItem = [&]( BOARD_ITEM& curr_item )
            {
                LSET layers = curr_item.GetLayerSet();
 
                if( !layers.test( Rescue ) )
                    return;
 
                layers.set( destLayer );
                layers.reset( Rescue );
 
                // Single-layer items (shapes, text) ignore non-copper layers in SetLayerSet, so
                // move them with SetLayer. Multi-layer items keep their full set.
                if( layers.count() == 1 )
                    curr_item.SetLayer( destLayer );
                else
                    curr_item.SetLayerSet( layers );
            };
 
            for( PCB_TRACK* track : m_board->Tracks() )
            {
                if( track->Type() == PCB_VIA_T )
                {
                    PCB_VIA*     via = static_cast<PCB_VIA*>( track );
                    PCB_LAYER_ID top_layer, bottom_layer;
 
                    if( via->GetViaType() == VIATYPE::THROUGH )
                        continue;
 
                    via->LayerPair( &top_layer, &bottom_layer );
 
                    if( top_layer == Rescue || bottom_layer == Rescue )
                    {
                        if( top_layer == Rescue )
                            top_layer = F_Cu;
 
                        if( bottom_layer == Rescue )
                            bottom_layer = B_Cu;
 
                        via->SetLayerPair( top_layer, bottom_layer );
                    }
                }
                else
                {
                    visitItem( *track );
                }
            }
 
            for( BOARD_ITEM* zone : m_board->Zones() )
                visitItem( *zone );
 
            for( BOARD_ITEM* drawing : m_board->Drawings() )
                visitItem( *drawing );
 
            for( FOOTPRINT* fp : m_board->Footprints() )
            {
                for( BOARD_ITEM* drawing : fp->GraphicalItems() )
                    visitItem( *drawing );
 
                for( BOARD_ITEM* zone : fp->Zones() )
                    visitItem( *zone );
 
                for( PCB_FIELD* field : fp->GetFields() )
                    visitItem( *field );
            }
 
            m_undefinedLayers.clear();
 
            // Rescued items make the board differ from disk. Mark modified so it gets re-saved.
            m_board->SetModified();
        }
        else
        {
            THROW_IO_ERRORF( _( "One or more items were found on undefined layers (%s). Open the board in the "
                                "PCB Editor to resolve." ),
                             undefinedLayerNames );
        }
    }
 
    // Clear unused zone data
    {
        LSET layers = m_board->GetEnabledLayers();
 
        for( BOARD_ITEM* zone : m_board->Zones() )
        {
            ZONE* z = static_cast<ZONE*>( zone );
 
            z->SetLayerSetAndRemoveUnusedFills( z->GetLayerSet() & layers );
        }
    }
 
    // Appended items get fresh UUIDs, so remap the links read in this parse and leave existing zones alone
    // A link set is no item, so appended copies of one set get a set of their own
    std::map<KIID, KIID> appendedSets;
 
    for( ZONE* z : m_board->Zones() )
    {
        if( !m_linkedZones.contains( z->m_Uuid ) )
            continue;
 
        if( m_appendToExisting && z->GetLinkSet() != niluuid )
            z->SetLinkSet( appendedSets.try_emplace( z->GetLinkSet(), KIID() ).first->second );
 
        REPEAT_LAYOUT_OPTIONS opts = z->GetRepeatOptions();
 
        if( auto it = m_resetKIIDMap.find( opts.m_anchor.AsString() ); it != m_resetKIIDMap.end() )
        {
            opts.m_anchor = it->second;
            z->SetRepeatOptions( opts );
        }
    }
 
    // Ensure all footprints have their embedded data from the board
    m_board->FixupEmbeddedData();
 
    for( NETINFO_ITEM* net : m_board->GetNetInfo() )
    {
        // Remap terminal pad UUIDs through reset map if needed before resolving
        for( int i = 0; i < 2; ++i )
        {
            const KIID& original = net->GetTerminalPadUuid( i );
            if( original != niluuid )
            {
                auto it = m_resetKIIDMap.find( original.AsString() );
                if( it != m_resetKIIDMap.end() )
                {
                    // Replace with canonical UUID after reset
                    net->SetTerminalPadUuid( i, it->second );
                }
            }
        }
 
        net->ResolveTerminalPads( m_board );
    }
 
    // Pads and vias read this from ViewGetLayers(), so a loaded map draws nothing until it
    // is populated
    m_board->RefreshDrillSymbolLayers();
 
    return m_board;
}
 
 
void PCB_IO_KICAD_SEXPR_PARSER::resolveGroups( BOARD_ITEM* aParent )
{
    BOARD*     board = dynamic_cast<BOARD*>( aParent );
    FOOTPRINT* footprint = board ? nullptr : dynamic_cast<FOOTPRINT*>( aParent );
 
    // For footprint parents, build a one-time lookup map instead of scanning children
    // on every call.  For board parents, resolve using BOARD::ResolveItem(), which
    // goes to the board's item index cache and re-binds stale entries.
    std::unordered_map<KIID, BOARD_ITEM*> fpItemMap;
 
    if( footprint )
    {
        footprint->RunOnChildren(
                [&]( BOARD_ITEM* child )
                {
                    fpItemMap.insert( { child->m_Uuid, child } );
                },
                RECURSE_MODE::NO_RECURSE );
    }
 
    auto getItem =
            [&]( const KIID& aId ) -> BOARD_ITEM*
            {
                if( board )
                {
                    return board->ResolveItem( aId, true );
                }
                else if( footprint )
                {
                    auto it = fpItemMap.find( aId );
 
                    return it != fpItemMap.end() ? it->second : nullptr;
                }
 
                return nullptr;
            };
 
    // Now that we've parsed the other Uuids in the file we can resolve the uuids referred
    // to in the group declarations we saw.
    //
    // First add all group objects so subsequent getItem() calls for nested groups work.
 
    std::vector<GROUP_INFO*> groupTypeObjects;
 
    for( GROUP_INFO& groupInfo : m_groupInfos )
        groupTypeObjects.emplace_back( &groupInfo );
 
    for( GENERATOR_INFO& genInfo : m_generatorInfos )
        groupTypeObjects.emplace_back( &genInfo );
 
    for( GROUP_INFO* groupInfo : groupTypeObjects )
    {
        PCB_GROUP* group = nullptr;
 
        if( GENERATOR_INFO* genInfo = dynamic_cast<GENERATOR_INFO*>( groupInfo ) )
        {
            GENERATORS_MGR& mgr = GENERATORS_MGR::Instance();
 
            PCB_GENERATOR* gen;
            group = gen = mgr.CreateFromType( genInfo->genType );
 
            if( !gen )
                THROW_IO_ERRORF( _( "Cannot create generated object of type '%s'" ), genInfo->genType );
 
            gen->SetLayer( genInfo->layer );
            gen->SetProperties( genInfo->properties );
 
            for( auto& [name, item] : genInfo->templates )
                gen->SetTemplateItem( name, std::move( item ) );
        }
        else
        {
            group = new PCB_GROUP( groupInfo->parent );
            group->SetName( groupInfo->name );
        }
 
        group->SetUuidDirect( groupInfo->uuid );
        group->SetCustomProperties( groupInfo->customProperties );
 
        if( groupInfo->libId.IsValid() )
            group->SetDesignBlockLibId( groupInfo->libId );
 
        if( groupInfo->locked )
            group->SetLocked( true );
 
        if( groupInfo->parent->Type() == PCB_FOOTPRINT_T )
        {
            static_cast<FOOTPRINT*>( groupInfo->parent )->Add( group, ADD_MODE::INSERT, true );
 
            // Keep the footprint lookup map in sync with newly added groups
            if( footprint )
                fpItemMap.insert( { group->m_Uuid, group } );
        }
        else
        {
            static_cast<BOARD*>( groupInfo->parent )->Add( group, ADD_MODE::INSERT, true );
        }
    }
 
    for( GROUP_INFO* groupInfo : groupTypeObjects )
    {
        if( PCB_GROUP* group = dynamic_cast<PCB_GROUP*>( getItem( groupInfo->uuid ) ) )
        {
            for( const KIID& aUuid : groupInfo->memberUuids )
            {
                BOARD_ITEM* item = nullptr;
 
                if( m_appendToExisting )
                    item = getItem( m_resetKIIDMap[ aUuid.AsString() ] );
                else
                    item = getItem( aUuid );
 
                // We used to allow fp items in non-footprint groups.  It was a mistake.  Check
                // to make sure they the item and group are owned by the same parent (will both
                // be nullptr in the board case).
                if( item && item->GetParentFootprint() == group->GetParentFootprint() )
                    group->AddItem( item );
            }
 
            // For generators, set the layer to match the layer of the contained tracks.
            // GetBoardItems() is unordered, so this may only be done for a generator whose
            // members all share one layer; one that spans layers keeps its own.
            if( PCB_GENERATOR* gen = dynamic_cast<PCB_GENERATOR*>( group ); gen && gen->LayerFollowsMembers() )
            {
                for( BOARD_ITEM* item : gen->GetBoardItems() )
                {
                    if( PCB_TRACK* track = dynamic_cast<PCB_TRACK*>( item ) )
                    {
                        gen->SetLayer( track->GetLayer() );
                        break;
                    }
                }
            }
        }
    }
 
    // Don't allow group cycles
    if( m_board )
        m_board->GroupsSanityCheck( true );
}
 
 
void PCB_IO_KICAD_SEXPR_PARSER::parseHeader()
{
    wxCHECK_RET( CurTok() == T_kicad_pcb,
                 wxT( "Cannot parse " ) + GetTokenString( CurTok() ) + wxT( " as a header." ) );
 
    NeedLEFT();
 
    T tok = NextTok();
 
    if( tok == T_version )
    {
        m_requiredVersion = parseInt( FromUTF8().mb_str( wxConvUTF8 ) );
        NeedRIGHT();
    }
    else
    {
        m_requiredVersion = 20201115;   // Last version before we started writing version #s
                                        // in footprint files as well as board files.
    }
 
    m_tooRecent = ( m_requiredVersion > SEXPR_BOARD_FILE_VERSION );
 
    // Prior to this, bar was a valid string char for unquoted strings.
    SetKnowsBar( m_requiredVersion >= 20240706 );
 
    m_board->SetFileFormatVersionAtLoad( m_requiredVersion );
}
 
 
void PCB_IO_KICAD_SEXPR_PARSER::parseGeneralSection()
{
    wxCHECK_RET( CurTok() == T_general,
                 wxT( "Cannot parse " ) + GetTokenString( CurTok() ) + wxT( " as a general section." ) );
 
    T token;
 
    for( token = NextTok();  token != T_RIGHT;  token = NextTok() )
    {
        if( token != T_LEFT )
            Expecting( T_LEFT );
 
        token = NextTok();
 
        switch( token )
        {
        case T_thickness:
            m_board->GetDesignSettings().SetBoardThickness( parseBoardUnits( T_thickness ) );
            NeedRIGHT();
            break;
 
        case T_legacy_teardrops:
            m_board->SetLegacyTeardrops( parseMaybeAbsentBool( true ) );
            break;
 
        default:              // Skip everything else.
            while( ( token = NextTok() ) != T_RIGHT )
            {
                if( !IsSymbol( token ) && token != T_NUMBER )
                    Expecting( "symbol or number" );
            }
        }
    }
}
 
 
void PCB_IO_KICAD_SEXPR_PARSER::parsePAGE_INFO()
{
    wxCHECK_RET( ( CurTok() == T_page && m_requiredVersion <= 20200119 ) || CurTok() == T_paper,
                 wxT( "Cannot parse " ) + GetTokenString( CurTok() ) + wxT( " as a PAGE_INFO." ) );
 
    T token;
    PAGE_INFO pageInfo;
 
    NeedSYMBOL();
 
    wxString pageType = FromUTF8();
 
    if( !pageInfo.SetType( pageType ) )
    {
        wxString err;
        err.Printf( _( "Page type '%s' is not valid." ), FromUTF8() );
        THROW_PARSE_ERROR( err, CurSource(), CurLine(), CurLineNumber(), CurOffset() );
    }
 
    if( pageInfo.GetType() == PAGE_SIZE_TYPE::User )
    {
        double width = parseDouble( "width" );      // width in mm
 
        // Perform some controls to avoid crashes if the size is edited by hands
        if( width < MIN_PAGE_SIZE_MM )
            width = MIN_PAGE_SIZE_MM;
        else if( width > MAX_PAGE_SIZE_PCBNEW_MM )
            width = MAX_PAGE_SIZE_PCBNEW_MM;
 
        double height = parseDouble( "height" );    // height in mm
 
        if( height < MIN_PAGE_SIZE_MM )
            height = MIN_PAGE_SIZE_MM;
        else if( height > MAX_PAGE_SIZE_PCBNEW_MM )
            height = MAX_PAGE_SIZE_PCBNEW_MM;
 
        pageInfo.SetWidthMM( width );
        pageInfo.SetHeightMM( height );
    }
 
    token = NextTok();
 
    if( token == T_portrait )
    {
        pageInfo.SetPortrait( true );
        NeedRIGHT();
    }
    else if( token != T_RIGHT )
    {
        Expecting( "portrait|)" );
    }
 
    m_board->SetPageSettings( pageInfo );
}
 
 
void PCB_IO_KICAD_SEXPR_PARSER::parseTITLE_BLOCK()
{
    wxCHECK_RET( CurTok() == T_title_block,
                 wxT( "Cannot parse " ) + GetTokenString( CurTok() ) + wxT( " as TITLE_BLOCK." ) );
 
    T token;
    TITLE_BLOCK titleBlock;
 
    for( token = NextTok();  token != T_RIGHT;  token = NextTok() )
    {
        if( token != T_LEFT )
            Expecting( T_LEFT );
 
        token = NextTok();
 
        switch( token )
        {
        case T_title:
            NextTok();
            titleBlock.SetTitle( FromUTF8() );
            break;
 
        case T_date:
            NextTok();
            titleBlock.SetDate( FromUTF8() );
            break;
 
        case T_rev:
            NextTok();
            titleBlock.SetRevision( FromUTF8() );
            break;
 
        case T_company:
            NextTok();
            titleBlock.SetCompany( FromUTF8() );
            break;
 
        case T_comment:
        {
            int commentNumber = parseInt( "comment" );
 
            switch( commentNumber )
            {
            case 1:
                NextTok();
                titleBlock.SetComment( 0, FromUTF8() );
                break;
 
            case 2:
                NextTok();
                titleBlock.SetComment( 1, FromUTF8() );
                break;
 
            case 3:
                NextTok();
                titleBlock.SetComment( 2, FromUTF8() );
                break;
 
            case 4:
                NextTok();
                titleBlock.SetComment( 3, FromUTF8() );
                break;
 
            case 5:
                NextTok();
                titleBlock.SetComment( 4, FromUTF8() );
                break;
 
            case 6:
                NextTok();
                titleBlock.SetComment( 5, FromUTF8() );
                break;
 
            case 7:
                NextTok();
                titleBlock.SetComment( 6, FromUTF8() );
                break;
 
            case 8:
                NextTok();
                titleBlock.SetComment( 7, FromUTF8() );
                break;
 
            case 9:
                NextTok();
                titleBlock.SetComment( 8, FromUTF8() );
                break;
 
            default:
                wxString err;
                err.Printf( wxT( "%d is not a valid title block comment number" ), commentNumber );
                THROW_PARSE_ERROR( err, CurSource(), CurLine(), CurLineNumber(), CurOffset() );
            }
 
            break;
        }
 
        default:
            Expecting( "title, date, rev, company, or comment" );
        }
 
        NeedRIGHT();
    }
 
    m_board->SetTitleBlock( titleBlock );
}
 
 
void PCB_IO_KICAD_SEXPR_PARSER::parseLayer( LAYER* aLayer )
{
    T           token;
 
    std::string name;
    std::string userName;
    std::string type;
    bool        isVisible = true;
 
    aLayer->clear();
 
    if( CurTok() != T_LEFT )
        Expecting( T_LEFT );
 
    // this layer_num is not used, we DO depend on LAYER_T however.
    int layer_num = parseInt( "layer index" );
 
    NeedSYMBOLorNUMBER();
    name = CurText();
 
    NeedSYMBOL();
    type = CurText();
 
    token = NextTok();
 
    // @todo Figure out why we are looking for a hide token in the layer definition.
    if( token == T_hide )
    {
        isVisible = false;
        NeedRIGHT();
    }
    else if( token == T_STRING )
    {
        userName = CurText();
        NeedRIGHT();
    }
    else if( token != T_RIGHT )
    {
        Expecting( "hide, user defined name, or )" );
    }
 
    aLayer->m_type    = LAYER::ParseType( type.c_str() );
    aLayer->m_number  = layer_num;
    aLayer->m_visible = isVisible;
 
    if( m_requiredVersion >= 20200922 )
    {
        aLayer->m_userName = From_UTF8( userName.c_str() );
        aLayer->m_name = From_UTF8( name.c_str() );
    }
    else // Older versions didn't have a dedicated user name field
    {
        aLayer->m_name = aLayer->m_userName = From_UTF8( name.c_str() );
    }
}
 
 
void PCB_IO_KICAD_SEXPR_PARSER::parseBoardStackup()
{
    T token;
    wxString name;
    int dielectric_idx = 1;     // the index of dielectric layers
    BOARD_STACKUP& stackup = m_board->GetDesignSettings().GetStackupDescriptor();
 
    // Remove existing stack or we end up just appending to the existing stackup
    stackup.RemoveAll();
 
    // Board appends in older versions could duplicate the whole stackup.  Stop adding items once
    // a board layer id repeats; still parse the duplicates to keep the token stream consistent.
    std::set<PCB_LAYER_ID> seenBrdLayers;
    bool                   duplicatedStackup = false;
 
    for( token = NextTok(); token != T_RIGHT; token = NextTok() )
    {
        if( CurTok() != T_LEFT )
            Expecting( T_LEFT );
 
        token = NextTok();
 
        if( token != T_layer )
        {
            switch( token )
            {
            case T_copper_finish:
                NeedSYMBOL();
                stackup.m_FinishType = FromUTF8();
                NeedRIGHT();
                break;
 
            case T_edge_plating:
                token = NextTok();
                stackup.m_EdgePlating = token == T_yes;
                NeedRIGHT();
                break;
 
            case T_dielectric_constraints:
                token = NextTok();
                stackup.m_HasDielectricConstrains = token == T_yes;
                NeedRIGHT();
                break;
 
            case T_edge_connector:
                token = NextTok();
                stackup.m_EdgeConnectorConstraints = BS_EDGE_CONNECTOR_NONE;
 
                if( token == T_yes )
                    stackup.m_EdgeConnectorConstraints = BS_EDGE_CONNECTOR_IN_USE;
                else if( token == T_bevelled )
                    stackup.m_EdgeConnectorConstraints = BS_EDGE_CONNECTOR_BEVELLED;
 
                NeedRIGHT();
                break;
 
            case T_castellated_pads:    // Legacy compatibility. just skip it
                token = NextTok();
                NeedRIGHT();
                break;
 
            default:
                // Currently, skip this item if not defined, because the stackup def
                // is a moving target
                //Expecting( "copper_finish, edge_plating, dielectric_constrains,
                // edge_connector, castellated_pads" );
                skipCurrent();
                break;
            }
 
            continue;
        }
 
        NeedSYMBOL();
        name = FromUTF8();
 
        // Match the canonical names that we write, not GetLayerID() because the user-name matching
        // could end up being the same as a canonical name and corrupt the stack.
        PCB_LAYER_ID layerId = UNDEFINED_LAYER;
 
        for( PCB_LAYER_ID candidate : LSET::AllLayersMask() )
        {
            if( LSET::Name( candidate ) == name )
            {
                layerId = candidate;
                break;
            }
        }
 
        // Init the type
        BOARD_STACKUP_ITEM_TYPE type = BS_ITEM_TYPE_UNDEFINED;
 
        if( layerId == F_SilkS || layerId == B_SilkS )
            type = BS_ITEM_TYPE_SILKSCREEN;
        else if( layerId == F_Mask || layerId == B_Mask )
            type = BS_ITEM_TYPE_SOLDERMASK;
        else if( layerId == F_Paste || layerId == B_Paste )
            type = BS_ITEM_TYPE_SOLDERPASTE;
        else if( layerId == UNDEFINED_LAYER )
            type = BS_ITEM_TYPE_DIELECTRIC;
        else if( !( layerId & 1 ) )
            type = BS_ITEM_TYPE_COPPER;
 
        std::unique_ptr<BOARD_STACKUP_ITEM> itemOwner;
        BOARD_STACKUP_ITEM*                 item = nullptr;
 
        if( layerId != UNDEFINED_LAYER && !seenBrdLayers.insert( layerId ).second )
            duplicatedStackup = true;
 
        if( type != BS_ITEM_TYPE_UNDEFINED )
        {
            // A 32-copper-layer board has at most 69 stackup items (32 copper +
            // 31 dielectric + 6 mask/paste/silk).  Anything far beyond that
            // indicates a corrupted file.  Parse the item so tokens are consumed
            // correctly, but don't keep it.
            static constexpr int MAX_STACKUP_ITEMS = 128;
 
            itemOwner = std::make_unique<BOARD_STACKUP_ITEM>( type );
            item = itemOwner.get();
            item->SetBrdLayerId( layerId );
 
            if( type == BS_ITEM_TYPE_DIELECTRIC )
                item->SetDielectricLayerId( dielectric_idx++ );
 
            if( !duplicatedStackup && stackup.GetCount() < MAX_STACKUP_ITEMS )
                stackup.Add( itemOwner.release() );
        }
        else
        {
            Expecting( "layer_name" );
        }
 
        bool has_next_sublayer = true;
        int sublayer_idx = 0;       // the index of dielectric sub layers
                                    // sublayer 0 is always existing (main sublayer)
        wxString specFreqUnits;
        wxString dielectricModel;
 
        while( has_next_sublayer )
        {
            has_next_sublayer = false;
 
            for( token = NextTok(); token != T_RIGHT; token = NextTok() )
            {
                if( token == T_addsublayer )
                {
                    has_next_sublayer = true;
                    break;
                }
 
                if( token == T_LEFT )
                {
                    token = NextTok();
 
                    switch( token )
                    {
                    case T_type:
                        NeedSYMBOL();
                        item->SetTypeName( FromUTF8() );
                        NeedRIGHT();
                        break;
 
                    case T_thickness:
                        item->SetThickness( parseBoardUnits( T_thickness ), sublayer_idx );
                        token = NextTok();
 
                        if( token == T_LEFT )
                            break;
 
                        if( token == T_locked )
                        {
                            // Dielectric thickness can be locked (for impedance controlled layers)
                            if( type == BS_ITEM_TYPE_DIELECTRIC )
                                item->SetThicknessLocked( true, sublayer_idx );
 
                            NeedRIGHT();
                        }
 
                        break;
 
                    case T_material:
                        NeedSYMBOL();
                        item->SetMaterial( FromUTF8(), sublayer_idx );
                        NeedRIGHT();
                        break;
 
                    case T_epsilon_r:
                        NextTok();
                        item->SetEpsilonR( parseDouble(), sublayer_idx );
                        NeedRIGHT();
                        break;
 
                    case T_loss_tangent:
                        NextTok();
                        item->SetLossTangent( parseDouble(), sublayer_idx );
                        NeedRIGHT();
                        break;
 
                    case T_spec_frequency:
                        NextTok();
                        item->SetSpecFreq( parseDouble(), sublayer_idx );
                        NeedRIGHT();
                        break;
 
                    case T_dielectric_model:
                        token = NextTok();
 
                        switch( token )
                        {
                        case T_constant:
                            item->SetDielectricModel( DIELECTRIC_MODEL::CONSTANT, sublayer_idx );
                            break;
 
                        case T_djordjevic_sarkar:
                            item->SetDielectricModel( DIELECTRIC_MODEL::DJORDJEVIC_SARKAR, sublayer_idx );
                            break;
 
                        default:
                            Expecting( "constant or djordjevic_sarkar" );
                            break;
                        }
 
                        NeedRIGHT();
                        break;
 
                    case T_color:
                        NeedSYMBOL();
                        name = FromUTF8();
 
                        // Older versions didn't store opacity with custom colors
                        if( name.StartsWith( wxT( "#" ) ) && m_requiredVersion < 20210824 )
                        {
                            KIGFX::COLOR4D color( name );
 
                            if( item->GetType() == BS_ITEM_TYPE_SOLDERMASK )
                                color = color.WithAlpha( DEFAULT_SOLDERMASK_OPACITY );
                            else
                                color = color.WithAlpha( 1.0 );
 
                            wxColour wx_color = color.ToColour();
 
                            // Open-code wxColour::GetAsString() because 3.0 doesn't handle rgba
                            name.Printf( wxT("#%02X%02X%02X%02X" ),
                                         wx_color.Red(),
                                         wx_color.Green(),
                                         wx_color.Blue(),
                                         wx_color.Alpha() );
                        }
 
                        item->SetColor( name, sublayer_idx );
                        NeedRIGHT();
                        break;
 
                    default:
                        // Currently, skip this item if not defined, because the stackup def
                        // is a moving target
                        //Expecting( "type, thickness, material, epsilon_r, loss_tangent, color" );
                        skipCurrent();
                    }
                }
            }
 
            if( has_next_sublayer )     // Prepare reading the next sublayer description
            {
                sublayer_idx++;
                item->AddDielectricPrms( sublayer_idx );
            }
        }
 
    }
 
    if( token != T_RIGHT )
    {
        Expecting( ")" );
    }
 
    // Success:
    m_board->GetDesignSettings().m_HasStackup = true;
}
 
 
void PCB_IO_KICAD_SEXPR_PARSER::createOldLayerMapping( std::unordered_map< std::string, std::string >& aMap )
{
    // N.B. This mapping only includes Italian, Polish and French as they were the only languages
    // that mapped the layer names as of cc2022b1ac739aa673d2a0b7a2047638aa7a47b3 (kicad-i18n)
    // when the bug was fixed in KiCad source.
 
    // Italian
    aMap["Adesivo.Retro"] = "B.Adhes";
    aMap["Adesivo.Fronte"] = "F.Adhes";
    aMap["Pasta.Retro"] = "B.Paste";
    aMap["Pasta.Fronte"] = "F.Paste";
    aMap["Serigrafia.Retro"] = "B.SilkS";
    aMap["Serigrafia.Fronte"] = "F.SilkS";
    aMap["Maschera.Retro"] = "B.Mask";
    aMap["Maschera.Fronte"] = "F.Mask";
    aMap["Grafica"] = "Dwgs.User";
    aMap["Commenti"] = "Cmts.User";
    aMap["Eco1"] = "Eco1.User";
    aMap["Eco2"] = "Eco2.User";
    aMap["Contorno.scheda"] = "Edge.Cuts";
 
    // Polish
    aMap["Kleju_Dolna"] = "B.Adhes";
    aMap["Kleju_Gorna"] = "F.Adhes";
    aMap["Pasty_Dolna"] = "B.Paste";
    aMap["Pasty_Gorna"] = "F.Paste";
    aMap["Opisowa_Dolna"] = "B.SilkS";
    aMap["Opisowa_Gorna"] = "F.SilkS";
    aMap["Maski_Dolna"] = "B.Mask";
    aMap["Maski_Gorna"] = "F.Mask";
    aMap["Rysunkowa"] = "Dwgs.User";
    aMap["Komentarzy"] = "Cmts.User";
    aMap["ECO1"] = "Eco1.User";
    aMap["ECO2"] = "Eco2.User";
    aMap["Krawedziowa"] = "Edge.Cuts";
 
    // French
    aMap["Dessous.Adhes"] = "B.Adhes";
    aMap["Dessus.Adhes"] = "F.Adhes";
    aMap["Dessous.Pate"] = "B.Paste";
    aMap["Dessus.Pate"] = "F.Paste";
    aMap["Dessous.SilkS"] = "B.SilkS";
    aMap["Dessus.SilkS"] = "F.SilkS";
    aMap["Dessous.Masque"] = "B.Mask";
    aMap["Dessus.Masque"] = "F.Mask";
    aMap["Dessin.User"] = "Dwgs.User";
    aMap["Contours.Ci"] = "Edge.Cuts";
}
 
 
void PCB_IO_KICAD_SEXPR_PARSER::parseLayers()
{
    wxCHECK_RET( CurTok() == T_layers,
                 wxT( "Cannot parse " ) + GetTokenString( CurTok() ) + wxT( " as layers." ) );
 
    T       token;
    LSET    visibleLayers;
    LSET    enabledLayers;
    int     copperLayerCount = 0;
    LAYER   layer;
    bool    anyHidden = false;
 
    std::unordered_map< std::string, std::string > v3_layer_names;
    std::vector<LAYER>  cu;
 
    // Destination layers before the appended board is applied, used to detect a remap need
    const LSET         destInitialEnabled = m_appendToExisting ? m_board->GetEnabledLayers() : LSET();
    const int          destInitialCopperCount = m_appendToExisting ? m_board->GetCopperLayerCount() : 0;
    std::vector<LAYER> appendedLayers;
 
    createOldLayerMapping( v3_layer_names );
 
    for( token = NextTok();  token != T_RIGHT;  token = NextTok() )
    {
        parseLayer( &layer );
 
        if( layer.m_type == LT_UNDEFINED )     // it's a non-copper layer
            break;
 
        cu.push_back( layer );      // it's copper
    }
 
    // All Cu layers are parsed, but not the non-cu layers here.
 
    // The original *.kicad_pcb file format and the inverted
    // Cu stack format both have all the Cu layers first, so use this
    // trick to handle either. The layer number in the (layers ..)
    // s-expression element are ignored.
    if( cu.size() )
    {
        // Rework the layer numbers, which changed when the Cu stack
        // was flipped.  So we instead use position in the list.
        for( size_t i = 1; i < cu.size() - 1; i++ )
        {
            int tmpLayer = LSET::NameToLayer( cu[i].m_name );
 
            if( tmpLayer < 0 )
                tmpLayer = ( i + 1 ) * 2;
 
            cu[i].m_number = tmpLayer;
        }
 
        cu[0].m_number = F_Cu;
        cu[cu.size()-1].m_number = B_Cu;
 
        for( auto& cu_layer : cu )
        {
            enabledLayers.set( cu_layer.m_number );
 
            if( cu_layer.m_visible )
                visibleLayers.set( cu_layer.m_number );
            else
                anyHidden = true;
 
            if( !m_preserveDestinationStackup || !m_board->IsLayerEnabled( PCB_LAYER_ID( cu_layer.m_number ) ) )
            {
                m_board->SetLayerDescr( PCB_LAYER_ID( cu_layer.m_number ), cu_layer );
            }
 
            UTF8 name = cu_layer.m_name;
 
            m_layerIndices[ name ] = PCB_LAYER_ID( cu_layer.m_number );
            m_layerMasks[ name ] = LSET( { PCB_LAYER_ID( cu_layer.m_number ) } );
 
            appendedLayers.push_back( cu_layer );
        }
 
        copperLayerCount = cu.size();
    }
 
    // process non-copper layers
    while( token != T_RIGHT )
    {
        LAYER_ID_MAP::const_iterator it = m_layerIndices.find( UTF8( layer.m_name ) );
 
        if( it == m_layerIndices.end() )
        {
            auto new_layer_it = v3_layer_names.find( layer.m_name.ToStdString() );
 
            if( new_layer_it != v3_layer_names.end() )
                it = m_layerIndices.find( new_layer_it->second );
 
            if( it == m_layerIndices.end() )
            {
                THROW_IO_ERRORF( _( "Layer '%s' in file '%s' at line %d is not in fixed layer hash." ),
                                 layer.m_name, CurSource(), CurLineNumber(), CurOffset() );
            }
 
            // If we are here, then we have found a translated layer name.  Put it in the maps
            // so that items on this layer get the appropriate layer ID number.
            m_layerIndices[ UTF8( layer.m_name ) ] = it->second;
            m_layerMasks[   UTF8( layer.m_name ) ] = LSET( { it->second } );
            layer.m_name = it->first;
        }
 
        layer.m_number = it->second;
        enabledLayers.set( layer.m_number );
 
        if( layer.m_visible )
            visibleLayers.set( layer.m_number );
        else
            anyHidden = true;
 
        if( !m_preserveDestinationStackup || !m_board->IsLayerEnabled( it->second ) )
            m_board->SetLayerDescr( it->second, layer );
 
        appendedLayers.push_back( layer );
 
        token = NextTok();
 
        if( token != T_LEFT )
            break;
 
        parseLayer( &layer );
    }
 
    // We need at least 2 copper layers and there must be an even number of them.
    if( copperLayerCount < 2 || (copperLayerCount % 2) != 0 )
    {
        wxString err = wxString::Format( _( "%d is not a valid layer count" ), copperLayerCount );
 
        THROW_PARSE_ERROR( err, CurSource(), CurLine(), CurLineNumber(), CurOffset() );
    }
 
    if( m_preserveDestinationStackup )
    {
        m_board->SetCopperLayerCount( std::max( copperLayerCount, m_board->GetCopperLayerCount() ) );
        m_board->SetEnabledLayers( enabledLayers | m_board->GetEnabledLayers() );
    }
    else
    {
        m_board->SetCopperLayerCount( copperLayerCount );
        m_board->SetEnabledLayers( enabledLayers );
 
        // Only set this if any layers were explicitly marked as hidden.  Otherwise, we want to leave
        // this alone; default visibility will show everything
        if( anyHidden )
            m_board->m_LegacyVisibleLayers = visibleLayers;
    }
 
    if( m_appendToExisting && m_layerMappingHandler )
        remapAppendedLayers( appendedLayers, destInitialEnabled, destInitialCopperCount );
}
 
 
void PCB_IO_KICAD_SEXPR_PARSER::remapAppendedLayers( const std::vector<LAYER>& aSourceLayers,
                                                     const LSET& aDestInitialEnabled, int aDestInitialCopperCount )
{
    // Only prompt when an appended layer is new to the destination or a named appended layer would
    // land on a differently-named destination layer
    int  srcCopperCount = 0;
    bool mismatch = false;
 
    for( const LAYER& src : aSourceLayers )
    {
        PCB_LAYER_ID id = PCB_LAYER_ID( src.m_number );
 
        if( IsCopperLayer( src.m_number ) )
            srcCopperCount++;
 
        if( !aDestInitialEnabled.Contains( id ) )
            mismatch = true;
        else if( !src.m_userName.IsEmpty() && src.m_userName != m_board->GetLayerName( id ) )
            mismatch = true;
    }
 
    if( !mismatch )
        return;
 
    std::vector<INPUT_LAYER_DESC> descs;
 
    for( const LAYER& src : aSourceLayers )
    {
        INPUT_LAYER_DESC desc;
        desc.Name = src.m_userName.IsEmpty() ? src.m_name : src.m_userName;
        desc.AutoMapLayer = PCB_LAYER_ID( src.m_number );
        desc.Required = false;
 
        if( IsCopperLayer( src.m_number ) )
            desc.PermittedLayers = LSET::AllCuMask( std::max( srcCopperCount, aDestInitialCopperCount ) );
        else
            desc.PermittedLayers = LSET( { PCB_LAYER_ID( src.m_number ) } );
 
        // Prefer a destination layer with the same name as the auto-map suggestion
        for( PCB_LAYER_ID hid : aDestInitialEnabled.Seq() )
        {
            if( m_board->GetLayerName( hid ) == desc.Name )
            {
                desc.AutoMapLayer = hid;
                break;
            }
        }
 
        descs.push_back( desc );
    }
 
    // Hide the load progress reporter while the (modal) mapping dialog is up
    wxWindow* progressWindow = dynamic_cast<wxWindow*>( m_progressReporter );
 
    if( progressWindow )
        progressWindow->Hide();
 
    std::map<wxString, PCB_LAYER_ID> remap = m_layerMappingHandler( descs );
 
    if( progressWindow )
        progressWindow->Show();
 
    LSET enabled = m_board->GetEnabledLayers();
 
    for( const LAYER& src : aSourceLayers )
    {
        wxString     key = src.m_userName.IsEmpty() ? src.m_name : src.m_userName;
        auto         it = remap.find( key );
        PCB_LAYER_ID target = ( it != remap.end() ) ? it->second : PCB_LAYER_ID( src.m_number );
 
        UTF8 name = src.m_name;
 
        if( target == UNDEFINED_LAYER )
        {
            // Not imported, items on it fall through to Rescue
            m_layerIndices.erase( name );
            m_layerMasks.erase( name );
            continue;
        }
 
        m_layerIndices[name] = target;
        m_layerMasks[name] = LSET( { target } );
 
        // New layer on the destination keeps the appended descriptor
        if( !aDestInitialEnabled.Contains( target ) )
        {
            LAYER descr = src;
            descr.m_number = target;
            m_board->SetLayerDescr( target, descr );
        }
 
        enabled.set( target );
    }
 
    m_board->SetEnabledLayers( enabled );
}
 
 
LSET PCB_IO_KICAD_SEXPR_PARSER::lookUpLayerSet( const LSET_MAP& aMap )
{
    LSET_MAP::const_iterator it = aMap.find( curText );
 
    if( it == aMap.end() )
        return LSET( { Rescue } );
 
    return it->second;
}
 
 
PCB_LAYER_ID PCB_IO_KICAD_SEXPR_PARSER::lookUpLayer( const LAYER_ID_MAP& aMap )
{
    // avoid constructing another std::string, use lexer's directly
    LAYER_ID_MAP::const_iterator it = aMap.find( curText );
 
    if( it == aMap.end() )
    {
        m_undefinedLayers.insert( curText );
        return Rescue;
    }
 
    // Some files may have saved items to the Rescue Layer due to an issue in v5
    if( it->second == Rescue )
        m_undefinedLayers.insert( curText );
 
    return it->second;
}
 
 
PCB_LAYER_ID PCB_IO_KICAD_SEXPR_PARSER::parseBoardItemLayer()
{
    wxCHECK_MSG( CurTok() == T_layer, UNDEFINED_LAYER,
                 wxT( "Cannot parse " ) + GetTokenString( CurTok() ) + wxT( " as layer." ) );
 
    NextTok();
 
    PCB_LAYER_ID layerIndex = lookUpLayer( m_layerIndices );
 
    // Handle closing ) in object parser.
 
    return layerIndex;
}
 
 
LSET PCB_IO_KICAD_SEXPR_PARSER::parseBoardItemLayersAsMask()
{
    wxCHECK_MSG( CurTok() == T_layers, LSET(),
                 wxT( "Cannot parse " ) + GetTokenString( CurTok() ) + wxT( " as item layers." ) );
 
    LSET layerMask;
 
    for( T token = NextTok();  token != T_RIGHT;  token = NextTok() )
    {
        layerMask |= lookUpLayerSet( m_layerMasks );
    }
 
    return layerMask;
}
 
 
LSET PCB_IO_KICAD_SEXPR_PARSER::parseLayersForCuItemWithSoldermask()
{
    LSET layerMask = parseBoardItemLayersAsMask();
 
    if( ( layerMask & LSET::AllCuMask() ).count() != 1 )
          Expecting( "single copper layer" );
 
    if( ( layerMask & LSET( { F_Mask, B_Mask } ) ).count() > 1 )
          Expecting( "max one soldermask layer" );
 
    if( ( ( layerMask & LSET::InternalCuMask() ).any()
              && ( layerMask & LSET( { F_Mask, B_Mask } ) ).any() ) )
    {
        Expecting( "no mask layer when track is on internal layer" );
    }
 
    if( ( layerMask & LSET( { F_Cu, B_Mask } ) ).count() > 1 )
          Expecting( "copper and mask on the same side" );
 
    if( ( layerMask & LSET( { B_Cu, F_Mask } ) ).count() > 1 )
          Expecting( "copper and mask on the same side" );
 
    return layerMask;
}
 
 
void PCB_IO_KICAD_SEXPR_PARSER::parseDrillSymbolProfile()
{
    wxCHECK_RET( CurTok() == T_drill_symbol_profile,
                 wxT( "Cannot parse " ) + GetTokenString( CurTok() ) + wxT( " as a drill symbol profile." ) );
 
    DRILL_SYMBOL_PROFILE&  profile = m_board->GetDesignSettings().GetDrillSymbolProfile();
 
    for( DRILL_GROUP_KEY key : { DRILL_GROUP_KEY::SIZE_GRP, DRILL_GROUP_KEY::SLOT,
                                 DRILL_GROUP_KEY::PLATING, DRILL_GROUP_KEY::SPAN,
                                 DRILL_GROUP_KEY::OPERATION, DRILL_GROUP_KEY::HOLE_FUNCTION,
                                 DRILL_GROUP_KEY::PROTECTION,
                                 DRILL_GROUP_KEY::POST_MACHINING } )
    {
        profile.SetGroupedBy( key, false );
    }
 
    for( T token = NextTok(); token != T_RIGHT; token = NextTok() )
    {
        if( token != T_LEFT )
            Expecting( T_LEFT );
 
        token = NextTok();
 
        switch( token )
        {
        case T_name:
            NeedSYMBOLorNUMBER();
            profile.SetName( FromUTF8() );
            NeedRIGHT();
            break;
 
        case T_group_by:
            for( token = NextTok(); token != T_RIGHT; token = NextTok() )
            {
                DRILL_GROUP_KEY key;
 
                if( DrillGroupKeyFromToken( FromUTF8(), key ) )
                    profile.SetGroupedBy( key, true );
            }
 
            break;
 
        case T_default_marks:
        {
            NeedSYMBOLorNUMBER();
            DRILL_MARK_POLICY policy;
 
            if( DrillMarkPolicyFromToken( FromUTF8(), policy ) )
                profile.SetMarkPolicy( policy );
 
            NeedRIGHT();
            break;
        }
 
        case T_size:
            profile.SetSymbolSize( parseBoardUnits( "drill symbol size" ) );
            NeedRIGHT();
            break;
 
        case T_width:
            profile.SetSymbolWidth( parseBoardUnits( "drill symbol line width" ) );
            NeedRIGHT();
            break;
 
        case T_freeze_assignments:
            profile.SetFreezeAssignments( parseBool() );
            NeedRIGHT();
            break;
 
        case T_assignment:
        {
            std::string             key;
            DRILL_SYMBOL_ASSIGNMENT assignment;
 
            for( token = NextTok(); token != T_RIGHT; token = NextTok() )
            {
                if( token != T_LEFT )
                    Expecting( T_LEFT );
 
                token = NextTok();
 
                switch( token )
                {
                case T_key:
                    NeedSYMBOLorNUMBER();
                    key = CurStr();
                    NeedRIGHT();
                    break;
 
                case T_mark:
                {
                    NeedSYMBOLorNUMBER();
                    DrillMarkModeFromToken( FromUTF8(), assignment.m_MarkMode );
 
                    if( assignment.m_MarkMode == DRILL_MARK_MODE::SHAPE )
                    {
                        assignment.m_ShapeIndex = parseInt( "drill symbol shape" );
                    }
                    else if( assignment.m_MarkMode == DRILL_MARK_MODE::LETTER )
                    {
                        NeedSYMBOLorNUMBER();
                        assignment.m_Letter = FromUTF8();
                    }
 
                    NeedRIGHT();
                    break;
                }
 
                case T_descr:
                    NeedSYMBOLorNUMBER();
                    assignment.m_Description = FromUTF8();
                    NeedRIGHT();
                    break;
 
                default:
                    skipCurrent();
                    break;
                }
            }
 
            if( !key.empty() )
                profile.SetAssignment( key, assignment );
 
            break;
        }
 
        default:
            skipCurrent();
            break;
        }
    }
}
 
 
void PCB_IO_KICAD_SEXPR_PARSER::parseSetup()
{
    wxCHECK_RET( CurTok() == T_setup,
                 wxT( "Cannot parse " ) + GetTokenString( CurTok() ) + wxT( " as setup." ) );
 
    BOARD_DESIGN_SETTINGS&           bds = m_board->GetDesignSettings();
    const std::shared_ptr<NETCLASS>& defaultNetClass = bds.m_NetSettings->GetDefaultNetclass();
    ZONE_SETTINGS&                   zoneSettings = bds.GetDefaultZoneSettings();
 
    // Missing soldermask min width value means that the user has set the value to 0 and
    // not the default value (0.25mm)
    bds.m_SolderMaskMinWidth = 0;
 
    for( T token = NextTok();  token != T_RIGHT;  token = NextTok() )
    {
        if( token != T_LEFT )
            Expecting( T_LEFT );
 
        token = NextTok();
 
        switch( token )
        {
        case T_drill_symbol_profile:
            parseDrillSymbolProfile();
            break;
 
        case T_stackup:
            if( m_preserveDestinationStackup )
                skipCurrent();
            else
                parseBoardStackup();
            break;
 
        case T_last_trace_width:    // not used now
            /* lastTraceWidth =*/ parseBoardUnits( T_last_trace_width );
            NeedRIGHT();
            break;
 
        case T_user_trace_width:
        {
            // Make room for the netclass value
            if( bds.m_TrackWidthList.empty() )
                bds.m_TrackWidthList.emplace_back( 0 );
 
            int trackWidth = parseBoardUnits( T_user_trace_width );
 
            if( !m_appendToExisting || !alg::contains( bds.m_TrackWidthList, trackWidth ) )
                bds.m_TrackWidthList.push_back( trackWidth );
 
            m_board->m_LegacyDesignSettingsLoaded = true;
            NeedRIGHT();
            break;
        }
 
        case T_trace_clearance:
            defaultNetClass->SetClearance( parseBoardUnits( T_trace_clearance ) );
            m_board->m_LegacyDesignSettingsLoaded = true;
            NeedRIGHT();
            break;
 
        case T_zone_clearance:
            zoneSettings.m_ZoneClearance = parseBoardUnits( T_zone_clearance );
            m_board->m_LegacyDesignSettingsLoaded = true;
            NeedRIGHT();
            break;
 
        case T_zone_45_only:    // legacy setting
            /* zoneSettings.m_Zone_45_Only = */ parseBool();
            m_board->m_LegacyDesignSettingsLoaded = true;
            NeedRIGHT();
            break;
 
        case T_clearance_min:
            bds.m_MinClearance = parseBoardUnits( T_clearance_min );
            m_board->m_LegacyDesignSettingsLoaded = true;
            NeedRIGHT();
            break;
 
        case T_trace_min:
            bds.m_TrackMinWidth = parseBoardUnits( T_trace_min );
            m_board->m_LegacyDesignSettingsLoaded = true;
            NeedRIGHT();
            break;
 
        case T_via_size:
            defaultNetClass->SetViaDiameter( parseBoardUnits( T_via_size ) );
            m_board->m_LegacyDesignSettingsLoaded = true;
            NeedRIGHT();
            break;
 
        case T_via_drill:
            defaultNetClass->SetViaDrill( parseBoardUnits( T_via_drill ) );
            m_board->m_LegacyDesignSettingsLoaded = true;
            NeedRIGHT();
            break;
 
        case T_via_min_annulus:
            bds.m_ViasMinAnnularWidth = parseBoardUnits( T_via_min_annulus );
            m_board->m_LegacyDesignSettingsLoaded = true;
            NeedRIGHT();
            break;
 
        case T_via_min_size:
            bds.m_ViasMinSize = parseBoardUnits( T_via_min_size );
            m_board->m_LegacyDesignSettingsLoaded = true;
            NeedRIGHT();
            break;
 
        case T_through_hole_min:
            bds.m_MinThroughDrill = parseBoardUnits( T_through_hole_min );
            m_board->m_LegacyDesignSettingsLoaded = true;
            NeedRIGHT();
            break;
 
        // Legacy token for T_through_hole_min
        case T_via_min_drill:
            bds.m_MinThroughDrill = parseBoardUnits( T_via_min_drill );
            m_board->m_LegacyDesignSettingsLoaded = true;
            NeedRIGHT();
            break;
 
        case T_hole_to_hole_min:
            bds.m_HoleToHoleMin = parseBoardUnits( T_hole_to_hole_min );
            m_board->m_LegacyDesignSettingsLoaded = true;
            NeedRIGHT();
            break;
 
        case T_user_via:
        {
            int           viaSize = parseBoardUnits( "user via size" );
            int           viaDrill = parseBoardUnits( "user via drill" );
            VIA_DIMENSION via( viaSize, viaDrill );
 
            // Make room for the netclass value
            if( bds.m_ViasDimensionsList.empty() )
                bds.m_ViasDimensionsList.emplace_back( VIA_DIMENSION( 0, 0 ) );
 
            if( !m_appendToExisting || !alg::contains( bds.m_ViasDimensionsList, via ) )
                bds.m_ViasDimensionsList.emplace_back( via );
 
            m_board->m_LegacyDesignSettingsLoaded = true;
            NeedRIGHT();
            break;
        }
 
        case T_uvia_size:
            defaultNetClass->SetuViaDiameter( parseBoardUnits( T_uvia_size ) );
            m_board->m_LegacyDesignSettingsLoaded = true;
            NeedRIGHT();
            break;
 
        case T_uvia_drill:
            defaultNetClass->SetuViaDrill( parseBoardUnits( T_uvia_drill ) );
            m_board->m_LegacyDesignSettingsLoaded = true;
            NeedRIGHT();
            break;
 
        case T_uvias_allowed:
            parseBool();
            m_board->m_LegacyDesignSettingsLoaded = true;
            NeedRIGHT();
            break;
 
        case T_blind_buried_vias_allowed:
            parseBool();
            m_board->m_LegacyDesignSettingsLoaded = true;
            NeedRIGHT();
            break;
 
        case T_uvia_min_size:
            bds.m_MicroViasMinSize = parseBoardUnits( T_uvia_min_size );
            m_board->m_LegacyDesignSettingsLoaded = true;
            NeedRIGHT();
            break;
 
        case T_uvia_min_drill:
            bds.m_MicroViasMinDrill = parseBoardUnits( T_uvia_min_drill );
            m_board->m_LegacyDesignSettingsLoaded = true;
            NeedRIGHT();
            break;
 
        case T_user_diff_pair:
        {
            int                 width = parseBoardUnits( "user diff-pair width" );
            int                 gap = parseBoardUnits( "user diff-pair gap" );
            int                 viaGap = parseBoardUnits( "user diff-pair via gap" );
            DIFF_PAIR_DIMENSION diffPair( width, gap, viaGap );
 
            if( !m_appendToExisting || !alg::contains( bds.m_DiffPairDimensionsList, diffPair ) )
                bds.m_DiffPairDimensionsList.emplace_back( diffPair );
 
            m_board->m_LegacyDesignSettingsLoaded = true;
            NeedRIGHT();
            break;
        }
 
        case T_segment_width:   // note: legacy (pre-6.0) token
            bds.m_LineThickness[ LAYER_CLASS_COPPER ] = parseBoardUnits( T_segment_width );
            m_board->m_LegacyDesignSettingsLoaded = true;
            NeedRIGHT();
            break;
 
        case T_edge_width:      // note: legacy (pre-6.0) token
            bds.m_LineThickness[ LAYER_CLASS_EDGES ] = parseBoardUnits( T_edge_width );
            m_board->m_LegacyDesignSettingsLoaded = true;
            NeedRIGHT();
            break;
 
        case T_mod_edge_width:  // note: legacy (pre-6.0) token
            bds.m_LineThickness[ LAYER_CLASS_SILK ] = parseBoardUnits( T_mod_edge_width );
            m_board->m_LegacyDesignSettingsLoaded = true;
            NeedRIGHT();
            break;
 
        case T_pcb_text_width:  // note: legacy (pre-6.0) token
            bds.m_TextThickness[ LAYER_CLASS_COPPER ] = parseBoardUnits( T_pcb_text_width );
            m_board->m_LegacyDesignSettingsLoaded = true;
            NeedRIGHT();
            break;
 
        case T_mod_text_width:  // note: legacy (pre-6.0) token
            bds.m_TextThickness[ LAYER_CLASS_SILK ] = parseBoardUnits( T_mod_text_width );
            m_board->m_LegacyDesignSettingsLoaded = true;
            NeedRIGHT();
            break;
 
        case T_pcb_text_size:   // note: legacy (pre-6.0) token
            bds.m_TextSize[ LAYER_CLASS_COPPER ].x = parseBoardUnits( "pcb text width" );
            bds.m_TextSize[ LAYER_CLASS_COPPER ].y = parseBoardUnits( "pcb text height" );
            m_board->m_LegacyDesignSettingsLoaded = true;
            NeedRIGHT();
            break;
 
        case T_mod_text_size:   // note: legacy (pre-6.0) token
            bds.m_TextSize[ LAYER_CLASS_SILK ].x = parseBoardUnits( "footprint text width" );
            bds.m_TextSize[ LAYER_CLASS_SILK ].y = parseBoardUnits( "footprint text height" );
            m_board->m_LegacyDesignSettingsLoaded = true;
            NeedRIGHT();
            break;
 
        case T_defaults:
            parseDefaults( bds );
            m_board->m_LegacyDesignSettingsLoaded = true;
            break;
 
        case T_pad_size:
        {
            // master pad size no longer read
            parseBoardUnits( "master pad width" );  // x
            parseBoardUnits( "master pad height" ); // y
            m_board->m_LegacyDesignSettingsLoaded = true;
            NeedRIGHT();
            break;
        }
 
        case T_pad_drill:
        {
            // master pad drill size no longer read
            parseBoardUnits( T_pad_drill ); // drill size
            m_board->m_LegacyDesignSettingsLoaded = true;
            NeedRIGHT();
            break;
        }
 
        case T_pad_to_mask_clearance:
            bds.m_SolderMaskExpansion = parseBoardUnits( T_pad_to_mask_clearance );
            NeedRIGHT();
            break;
 
        case T_solder_mask_min_width:
            bds.m_SolderMaskMinWidth = parseBoardUnits( T_solder_mask_min_width );
            NeedRIGHT();
            break;
 
        case T_pad_to_paste_clearance:
            bds.m_SolderPasteMargin = parseBoardUnits( T_pad_to_paste_clearance );
            NeedRIGHT();
            break;
 
        case T_pad_to_paste_clearance_ratio:
            bds.m_SolderPasteMarginRatio = parseDouble( T_pad_to_paste_clearance_ratio );
            NeedRIGHT();
            break;
 
        case T_allow_soldermask_bridges_in_footprints:
            bds.m_AllowSoldermaskBridgesInFPs = parseBool();
            NeedRIGHT();
            break;
 
        case T_tenting:
        {
            auto [front, back] = parseFrontBackOptBool( true );
            bds.m_TentViasFront = front.value_or( false );
            bds.m_TentViasBack = back.value_or( false );
            break;
        }
 
        case T_covering:
        {
            auto [front, back] = parseFrontBackOptBool();
            bds.m_CoverViasFront = front.value_or( false );
            bds.m_CoverViasBack = back.value_or( false );
            break;
        }
 
        case T_plugging:
        {
            auto [front, back] = parseFrontBackOptBool();
            bds.m_PlugViasFront = front.value_or( false );
            bds.m_PlugViasBack = back.value_or( false );
            break;
        }
 
        case T_capping:
        {
            bds.m_CapVias = parseBool();
            NeedRIGHT();
            break;
        }
 
        case T_filling:
        {
            bds.m_FillVias = parseBool();
            NeedRIGHT();
            break;
        }
 
        case T_aux_axis_origin:
        {
            int x = parseBoardUnits( "auxiliary origin X" );
            int y = parseBoardUnits( "auxiliary origin Y" );
            bds.SetAuxOrigin( VECTOR2I( x, y ) );
 
            // Aux origin still stored in board for the moment
            //m_board->m_LegacyDesignSettingsLoaded = true;
            NeedRIGHT();
            break;
        }
 
        case T_grid_origin:
        {
            int x = parseBoardUnits( "grid origin X" );
            int y = parseBoardUnits( "grid origin Y" );
            bds.SetGridOrigin( VECTOR2I( x, y ) );
            // Grid origin still stored in board for the moment
            //m_board->m_LegacyDesignSettingsLoaded = true;
            NeedRIGHT();
            break;
        }
 
        // Stored in board prior to 6.0
        case T_visible_elements:
        {
            // Make sure to start with DefaultVisible so all new layers are set
            m_board->m_LegacyVisibleItems = GAL_SET::DefaultVisible();
 
            int visible = parseHex() | MIN_VISIBILITY_MASK;
 
            for( size_t i = 0; i < sizeof( int ) * CHAR_BIT; i++ )
                m_board->m_LegacyVisibleItems.set( i, visible & ( 1u << i ) );
 
            NeedRIGHT();
            break;
        }
 
        case T_max_error:
            bds.m_MaxError = parseBoardUnits( T_max_error );
            m_board->m_LegacyDesignSettingsLoaded = true;
            NeedRIGHT();
            break;
 
        case T_filled_areas_thickness:
            // Ignore this value, it is not used anymore
            parseBool();
            NeedRIGHT();
            break;
 
        case T_pcbplotparams:
        {
            PCB_PLOT_PARAMS        plotParams;
            PCB_PLOT_PARAMS_PARSER parser( reader, m_requiredVersion );
            // parser must share the same current line as our current PCB parser
            // synchronize it.
            parser.SyncLineReaderWith( *this );
 
            plotParams.Parse( &parser );
            SyncLineReaderWith( parser );
 
            m_board->SetPlotOptions( plotParams );
 
            if( plotParams.GetLegacyPlotViaOnMaskLayer().has_value() )
            {
                bool tent = !( *plotParams.GetLegacyPlotViaOnMaskLayer() );
                bds.m_TentViasFront = tent;
                bds.m_TentViasBack = tent;
            }
 
            break;
        }
        case T_zone_defaults: parseZoneDefaults( bds.m_ZoneLayerProperties ); break;
 
        default:
            Unexpected( CurText() );
        }
    }
 
    // Set up a default stackup in case the file doesn't define one, and now we know
    // the enabled layers
    if( !m_preserveDestinationStackup && !bds.m_HasStackup )
    {
        BOARD_STACKUP& stackup = bds.GetStackupDescriptor();
        stackup.RemoveAll();
        stackup.BuildDefaultStackupList( &bds, m_board->GetCopperLayerCount() );
    }
}
 
 
void PCB_IO_KICAD_SEXPR_PARSER::parseZoneDefaults( std::map<PCB_LAYER_ID, ZONE_LAYER_PROPERTIES>& aProperties )
{
    for( T token = NextTok(); token != T_RIGHT; token = NextTok() )
    {
        if( token != T_LEFT )
            Expecting( T_LEFT );
 
        token = NextTok();
 
        switch( token )
        {
        case T_property: parseZoneLayerProperty( aProperties ); break;
        default:
            Unexpected( CurText() );
        }
    }
}
 
 
void PCB_IO_KICAD_SEXPR_PARSER::parseZoneLayerProperty(
        std::map<PCB_LAYER_ID, ZONE_LAYER_PROPERTIES>& aProperties )
{
    PCB_LAYER_ID          layer = UNDEFINED_LAYER;
    ZONE_LAYER_PROPERTIES properties;
 
    for( T token = NextTok(); token != T_RIGHT; token = NextTok() )
    {
        if( token != T_LEFT )
            Expecting( T_LEFT );
 
        token = NextTok();
 
        switch( token )
        {
        case T_layer:
            layer = parseBoardItemLayer();
            NeedRIGHT();
            break;
        case T_hatch_position:
        {
            properties.hatching_offset = parseXY();
            NeedRIGHT();
            break;
        }
        default:
            Unexpected( CurText() );
            break;
        }
    }
 
    aProperties.emplace( layer, properties );
}
 
 
void PCB_IO_KICAD_SEXPR_PARSER::parseDefaults( BOARD_DESIGN_SETTINGS& aSettings )
{
    for( T token = NextTok();  token != T_RIGHT;  token = NextTok() )
    {
        if( token != T_LEFT )
            Expecting( T_LEFT );
 
        token = NextTok();
 
        switch( token )
        {
        case T_edge_clearance:
            aSettings.m_CopperEdgeClearance = parseBoardUnits( T_edge_clearance );
            m_board->m_LegacyCopperEdgeClearanceLoaded = true;
            NeedRIGHT();
            break;
 
        case T_copper_line_width:
            aSettings.m_LineThickness[ LAYER_CLASS_COPPER ] = parseBoardUnits( token );
            NeedRIGHT();
            break;
 
        case T_copper_text_dims:
            parseDefaultTextDims( aSettings, LAYER_CLASS_COPPER );
            break;
 
        case T_courtyard_line_width:
            aSettings.m_LineThickness[ LAYER_CLASS_COURTYARD ] = parseBoardUnits( token );
            NeedRIGHT();
            break;
 
        case T_edge_cuts_line_width:
            aSettings.m_LineThickness[ LAYER_CLASS_EDGES ] = parseBoardUnits( token );
            NeedRIGHT();
            break;
 
        case T_silk_line_width:
            aSettings.m_LineThickness[ LAYER_CLASS_SILK ] = parseBoardUnits( token );
            NeedRIGHT();
            break;
 
        case T_silk_text_dims:
            parseDefaultTextDims( aSettings, LAYER_CLASS_SILK );
            break;
 
        case T_fab_layers_line_width:
            aSettings.m_LineThickness[ LAYER_CLASS_FAB ] = parseBoardUnits( token );
            NeedRIGHT();
            break;
 
        case T_fab_layers_text_dims:
            parseDefaultTextDims( aSettings, LAYER_CLASS_FAB );
            break;
 
        case T_other_layers_line_width:
            aSettings.m_LineThickness[ LAYER_CLASS_OTHERS ] = parseBoardUnits( token );
            NeedRIGHT();
            break;
 
        case T_other_layers_text_dims:
            parseDefaultTextDims( aSettings, LAYER_CLASS_OTHERS );
            break;
 
        case T_dimension_units:
            aSettings.m_DimensionUnitsMode = static_cast<DIM_UNITS_MODE>( parseInt( "dimension units" ) );
            NeedRIGHT();
            break;
 
        case T_dimension_precision:
            aSettings.m_DimensionPrecision = static_cast<DIM_PRECISION>( parseInt( "dimension precision" ) );
            NeedRIGHT();
            break;
 
        default:
            Unexpected( CurText() );
        }
    }
}
 
 
void PCB_IO_KICAD_SEXPR_PARSER::parseDefaultTextDims( BOARD_DESIGN_SETTINGS& aSettings, int aLayer )
{
    for( T token = NextTok();  token != T_RIGHT;  token = NextTok() )
    {
        if( token == T_LEFT )
            token = NextTok();
 
        switch( token )
        {
        case T_size:
            aSettings.m_TextSize[ aLayer ].x = parseBoardUnits( "default text size X" );
            aSettings.m_TextSize[ aLayer ].y = parseBoardUnits( "default text size Y" );
            NeedRIGHT();
            break;
 
        case T_thickness:
            aSettings.m_TextThickness[ aLayer ] = parseBoardUnits( "default text width" );
            NeedRIGHT();
            break;
 
        case T_italic:
            aSettings.m_TextItalic[ aLayer ] = true;
            break;
 
        case T_keep_upright:
            aSettings.m_TextUpright[ aLayer ] = true;
            break;
 
        default:
            Expecting( "size, thickness, italic or keep_upright" );
        }
    }
}
 
 
void PCB_IO_KICAD_SEXPR_PARSER::parseNETINFO_ITEM()
{
    wxCHECK_RET( CurTok() == T_net, wxT( "Cannot parse " ) + GetTokenString( CurTok() ) + wxT( " as net." ) );
 
    int netCode = parseInt( "net number" );
 
    NeedSYMBOLorNUMBER();
    wxString name = FromUTF8();
 
    // Convert overbar syntax from `~...~` to `~{...}`.  These were left out of the first merge
    // so the version is a bit later.
    if( m_requiredVersion < 20210606 )
        name = ConvertToNewOverbarNotation( name );
 
    NeedRIGHT();
 
    // net 0 should be already in list, so store this net
    // if it is not the net 0, or if the net 0 does not exists.
    // (TODO: a better test.)
    if( netCode > NETINFO_LIST::UNCONNECTED || !m_board->FindNet( NETINFO_LIST::UNCONNECTED ) )
    {
        NETINFO_ITEM* net = new NETINFO_ITEM( m_board, name, netCode );
        m_board->Add( net, ADD_MODE::INSERT, true );
 
        // Store the new code mapping
        pushValueIntoMap( netCode, net->GetNetCode() );
    }
}
 
// Parse the (net_chains ...) aggregation block providing chain names, member nets and optional terminal pads.
void PCB_IO_KICAD_SEXPR_PARSER::parseNET_CHAINS_SECTION()
{
    // Tokens inside section: (net_chain (name <str>) (members (member (net <code>))...) (terminal_pad <uuid>) (terminal_pad <uuid>))
    for( T token = NextTok(); token != T_EOF; token = NextTok() )
    {
        if( token == T_RIGHT )
            break; // end of (net_chains ...)
        else if( token == T_LEFT )
            token = NextTok();
 
        if( token != T_net_chain )
        {
            skipCurrent();
            continue;
        }
 
        wxString name;
        std::vector<int> netCodes;
        std::vector<wxString> netNames;
        KIID padUuids[2];
        int padCount = 0;
 
        for( T t = NextTok(); t != T_EOF; t = NextTok() )
        {
            if( t == T_RIGHT )
                break; // end chain
            else if( t == T_LEFT )
                t = NextTok();
 
            switch( t )
            {
            case T_name:
                NeedSYMBOLorNUMBER();
                name = FromUTF8();
                NeedRIGHT();
                break;
 
            case T_members:
            {
                for( T mt = NextTok(); mt != T_RIGHT; mt = NextTok() )
                {
                    if( mt == T_LEFT )
                        mt = NextTok();
 
                    if( mt == T_net )
                    {
                        // Accept either a net code (legacy) or a net name (current).
                        T tok = NextTok();
 
                        if( tok == T_NUMBER )
                            netCodes.push_back( (int) strtol( CurText(), nullptr, 10 ) );
                        else
                            netNames.push_back( FromUTF8() );
 
                        NeedRIGHT();
                    }
                    else if( mt == T_member )
                    {
                        // legacy style (member (net <code>)) wrapper
                        T inner = NextTok();
 
                        if( inner == T_LEFT )
                            inner = NextTok();
 
                        if( inner == T_net )
                        {
                            T tok2 = NextTok();
 
                            if( tok2 == T_NUMBER )
                                netCodes.push_back( (int) strtol( CurText(), nullptr, 10 ) );
                            else
                                netNames.push_back( FromUTF8() );
 
                            NeedRIGHT();
                        }
 
                        NeedRIGHT();
                    }
                    else
                    {
                        skipCurrent();
                    }
                }
                break;
            }
 
            case T_terminal_pad:
                if( padCount < 2 )
                {
                    NeedSYMBOLorNUMBER();
                    padUuids[padCount++] = KIID( FromUTF8() );
                    NeedRIGHT();
                }
                else
                {
                    skipCurrent();
                }
                break;
 
            default:
                skipCurrent();
                break;
            }
        }
 
        std::vector<NETINFO_ITEM*> resolvedNets;
 
        for( int code : netCodes )
        {
            int internalCode = code;
 
            if( code >= 0 && code < (int) m_netCodes.size() && m_netCodes[code] != 0 )
                internalCode = m_netCodes[code];
 
            if( NETINFO_ITEM* net = m_board->FindNet( internalCode ) )
                resolvedNets.push_back( net );
        }
 
        for( const wxString& netName : netNames )
        {
            if( NETINFO_ITEM* net = m_board->FindNet( netName ) )
                resolvedNets.push_back( net );
        }
 
        for( NETINFO_ITEM* net : resolvedNets )
        {
            net->SetNetChain( name );
 
            for( int i = 0; i < padCount && i < 2; ++i )
            {
                net->SetTerminalPadUuid( i, padUuids[i] );
 
                if( PAD* pad = m_board->FindPadByUuid( padUuids[i] ) )
                    net->SetTerminalPad( i, pad );
            }
        }
    }
}
 
 
void PCB_IO_KICAD_SEXPR_PARSER::parseNETCLASS()
{
    wxCHECK_RET( CurTok() == T_net_class,
                 wxT( "Cannot parse " ) + GetTokenString( CurTok() ) + wxT( " as net class." ) );
 
    std::shared_ptr<NETCLASS> nc = std::make_shared<NETCLASS>( wxEmptyString );
 
    // Read netclass name (can be a name or just a number like track width)
    NeedSYMBOLorNUMBER();
    nc->SetName( FromUTF8() );
    NeedSYMBOL();
    nc->SetDescription( FromUTF8() );
 
    for( T token = NextTok();  token != T_RIGHT;  token = NextTok() )
    {
        if( token != T_LEFT )
            Expecting( T_LEFT );
 
        token = NextTok();
 
        switch( token )
        {
        case T_clearance:
            nc->SetClearance( parseBoardUnits( T_clearance ) );
            break;
 
        case T_trace_width:
            nc->SetTrackWidth( parseBoardUnits( T_trace_width ) );
            break;
 
        case T_via_dia:
            nc->SetViaDiameter( parseBoardUnits( T_via_dia ) );
            break;
 
        case T_via_drill:
            nc->SetViaDrill( parseBoardUnits( T_via_drill ) );
            break;
 
        case T_uvia_dia:
            nc->SetuViaDiameter( parseBoardUnits( T_uvia_dia ) );
            break;
 
        case T_uvia_drill:
            nc->SetuViaDrill( parseBoardUnits( T_uvia_drill ) );
            break;
 
        case T_diff_pair_width:
            nc->SetDiffPairWidth( parseBoardUnits( T_diff_pair_width ) );
            break;
 
        case T_diff_pair_gap:
            nc->SetDiffPairGap( parseBoardUnits( T_diff_pair_gap ) );
            break;
 
        case T_add_net:
        {
            NeedSYMBOLorNUMBER();
 
            wxString netName = FromUTF8();
 
            // Convert overbar syntax from `~...~` to `~{...}`.  These were left out of the
            // first merge so the version is a bit later.
            if( m_requiredVersion < 20210606 )
                netName = ConvertToNewOverbarNotation( FromUTF8() );
 
            m_board->GetDesignSettings().m_NetSettings->SetNetclassPatternAssignment( netName, nc->GetName() );
 
            break;
        }
 
        default:
            Expecting( "clearance, trace_width, via_dia, via_drill, uvia_dia, uvia_drill, "
                       "diff_pair_width, diff_pair_gap or add_net" );
        }
 
        NeedRIGHT();
    }
 
    std::shared_ptr<NET_SETTINGS>& netSettings = m_board->GetDesignSettings().m_NetSettings;
 
    if( netSettings->HasNetclass( nc->GetName() ) )
    {
        // Must have been a name conflict, this is a bad board file.
        // User may have done a hand edit to the file.
        THROW_IO_ERRORF( _( "Duplicate NETCLASS name '%s' in file '%s' at line %d, offset %d." ),
                         nc->GetName().GetData(), CurSource().GetData(), CurLineNumber(), CurOffset() );
    }
    else if( nc->GetName() == netSettings->GetDefaultNetclass()->GetName() )
    {
        netSettings->SetDefaultNetclass( nc );
    }
    else
    {
        netSettings->SetNetclass( nc->GetName(), nc );
    }
}
 
 
void PCB_IO_KICAD_SEXPR_PARSER::parseLineEnding( LINE_ENDING& aEnding )
{
    // Current token is T_start_shape or T_end_shape. Next token is the style.
    T token = NextTok();
 
    switch( token )
    {
    case T_arrow: aEnding.SetStyle( LINE_ENDING_STYLE::ARROW ); break;
    case T_circle: aEnding.SetStyle( LINE_ENDING_STYLE::CIRCLE ); break;
    case T_square: aEnding.SetStyle( LINE_ENDING_STYLE::SQUARE ); break;
    case T_arrow_open: aEnding.SetStyle( LINE_ENDING_STYLE::ARROW_OPEN ); break;
    case T_none: aEnding.SetStyle( LINE_ENDING_STYLE::NONE ); break;
    default: Expecting( "arrow, circle, square, arrow_open, or none" );
    }
 
    // Parse optional sub-tokens
    for( token = NextTok(); token != T_RIGHT; token = NextTok() )
    {
        if( token != T_LEFT )
            Expecting( T_LEFT );
 
        token = NextTok();
 
        switch( token )
        {
        case T_length:
            aEnding.SetLength( parseBoardUnits( "length" ) );
            NeedRIGHT();
            break;
 
        case T_width:
            aEnding.SetWidth( parseBoardUnits( "width" ) );
            NeedRIGHT();
            break;
 
        case T_stroke:
        {
            STROKE_PARAMS        stroke;
            STROKE_PARAMS_PARSER strokeParser( reader, pcbIUScale.IU_PER_MM );
            strokeParser.SyncLineReaderWith( *this );
 
            strokeParser.ParseStroke( stroke );
            SyncLineReaderWith( strokeParser );
 
            aEnding.SetStroke( stroke );
            break;
        }
 
        default: Expecting( "length, width, or stroke" );
        }
    }
}
 
 
PCB_SHAPE* PCB_IO_KICAD_SEXPR_PARSER::parsePCB_SHAPE( BOARD_ITEM* aParent )
{
    wxCHECK_MSG( CurTok() == T_fp_arc || CurTok() == T_fp_circle || CurTok() == T_fp_curve || CurTok() == T_fp_rect
                         || CurTok() == T_fp_line || CurTok() == T_fp_poly || CurTok() == T_fp_ellipse
                         || CurTok() == T_fp_ellipse_arc || CurTok() == T_gr_arc || CurTok() == T_gr_circle
                         || CurTok() == T_gr_curve || CurTok() == T_gr_rect || CurTok() == T_gr_bbox
                         || CurTok() == T_gr_line || CurTok() == T_gr_poly || CurTok() == T_gr_vector
                         || CurTok() == T_gr_ellipse || CurTok() == T_gr_ellipse_arc,
                 nullptr, wxT( "Cannot parse " ) + GetTokenString( CurTok() ) + wxT( " as PCB_SHAPE." ) );
 
    T                          token;
    VECTOR2I                   pt;
    STROKE_PARAMS              stroke( 0, LINE_STYLE::SOLID );
    std::unique_ptr<PCB_SHAPE> shape = std::make_unique<PCB_SHAPE>( aParent );
 
    VECTOR2I  ellipseCenter( 0, 0 );
    int       ellipseMajor = 0;
    int       ellipseMinor = 0;
    EDA_ANGLE ellipseRotation = ANGLE_0;
    EDA_ANGLE ellipseStart = ANGLE_0;
    EDA_ANGLE ellipseEnd = ANGLE_0;
 
    switch( CurTok() )
    {
    case T_gr_arc:
    case T_fp_arc:
        shape->SetShape( SHAPE_T::ARC );
        token = NextTok();
 
        if( token == T_locked )
        {
            shape->SetLocked( true );
            token = NextTok();
        }
 
        if( token != T_LEFT )
            Expecting( T_LEFT );
 
        token = NextTok();
 
        if( m_requiredVersion <= LEGACY_ARC_FORMATTING )
        {
            // In legacy files the start keyword actually gives the arc center...
            if( token != T_start )
                Expecting( T_start );
 
            pt.x = parseBoardUnits( "X coordinate" );
            pt.y = parseBoardUnits( "Y coordinate" );
            shape->SetCenter( pt );
            NeedRIGHT();
            NeedLEFT();
            token = NextTok();
 
            // ... and the end keyword gives the start point of the arc
            if( token != T_end )
                Expecting( T_end );
 
            pt.x = parseBoardUnits( "X coordinate" );
            pt.y = parseBoardUnits( "Y coordinate" );
            shape->SetStart( pt );
            NeedRIGHT();
            NeedLEFT();
            token = NextTok();
 
            if( token != T_angle )
                Expecting( T_angle );
 
            shape->SetArcAngleAndEnd( EDA_ANGLE( parseDouble( "arc angle" ), DEGREES_T ), true );
            NeedRIGHT();
        }
        else
        {
            VECTOR2I arc_start, arc_mid, arc_end;
 
            if( token != T_start )
                Expecting( T_start );
 
            arc_start.x = parseBoardUnits( "X coordinate" );
            arc_start.y = parseBoardUnits( "Y coordinate" );
            NeedRIGHT();
            NeedLEFT();
            token = NextTok();
 
            if( token != T_mid )
                Expecting( T_mid );
 
            arc_mid.x = parseBoardUnits( "X coordinate" );
            arc_mid.y = parseBoardUnits( "Y coordinate" );
            NeedRIGHT();
            NeedLEFT();
            token = NextTok();
 
            if( token != T_end )
                Expecting( T_end );
 
            arc_end.x = parseBoardUnits( "X coordinate" );
            arc_end.y = parseBoardUnits( "Y coordinate" );
            NeedRIGHT();
 
            shape->SetArcOrSegment( arc_start, arc_mid, arc_end );
        }
 
        break;
 
    case T_gr_circle:
    case T_fp_circle:
        shape->SetShape( SHAPE_T::CIRCLE );
        token = NextTok();
 
        if( token == T_locked )
        {
            shape->SetLocked( true );
            token = NextTok();
        }
 
        if( token != T_LEFT )
            Expecting( T_LEFT );
 
        token = NextTok();
 
        if( token != T_center )
            Expecting( T_center );
 
        pt.x = parseBoardUnits( "X coordinate" );
        pt.y = parseBoardUnits( "Y coordinate" );
        shape->SetStart( pt );
        NeedRIGHT();
        NeedLEFT();
 
        token = NextTok();
 
        if( token != T_end )
            Expecting( T_end );
 
        pt.x = parseBoardUnits( "X coordinate" );
        pt.y = parseBoardUnits( "Y coordinate" );
        shape->SetEnd( pt );
        NeedRIGHT();
        break;
 
    case T_gr_curve:
    case T_fp_curve:
        shape->SetShape( SHAPE_T::BEZIER );
        token = NextTok();
 
        if( token == T_locked )
        {
            shape->SetLocked( true );
            token = NextTok();
        }
 
        if( token != T_LEFT )
            Expecting( T_LEFT );
 
        token = NextTok();
 
        if( token != T_pts )
            Expecting( T_pts );
 
        shape->SetStart( parseXY() );
        shape->SetBezierC1( parseXY());
        shape->SetBezierC2( parseXY());
        shape->SetEnd( parseXY() );
 
        if( m_board )
            shape->RebuildBezierToSegmentsPointsList( m_board->GetDesignSettings().m_MaxError );
        else
            shape->RebuildBezierToSegmentsPointsList( ARC_HIGH_DEF );
 
        NeedRIGHT();
        break;
 
    case T_gr_bbox:
    case T_gr_rect:
    case T_fp_rect:
        shape->SetShape( SHAPE_T::RECTANGLE );
        token = NextTok();
 
        if( token == T_locked )
        {
            shape->SetLocked( true );
            token = NextTok();
        }
 
        if( token != T_LEFT )
            Expecting( T_LEFT );
 
        token = NextTok();
 
        if( token != T_start )
            Expecting( T_start );
 
        pt.x = parseBoardUnits( "X coordinate" );
        pt.y = parseBoardUnits( "Y coordinate" );
        shape->SetStart( pt );
        NeedRIGHT();
        NeedLEFT();
        token = NextTok();
 
        if( token != T_end )
            Expecting( T_end );
 
        pt.x = parseBoardUnits( "X coordinate" );
        pt.y = parseBoardUnits( "Y coordinate" );
        shape->SetEnd( pt );
 
        if( aParent && aParent->Type() == PCB_FOOTPRINT_T )
        {
            // Footprint shapes are stored in board-relative coordinates, but we want the
            // normalization to remain in footprint-relative coordinates.
        }
        else
        {
            shape->Normalize();
        }
 
        NeedRIGHT();
        break;
 
    case T_gr_vector:
    case T_gr_line:
    case T_fp_line:
        shape->SetShape( SHAPE_T::SEGMENT );
        token = NextTok();
 
        if( token == T_locked )
        {
            shape->SetLocked( true );
            token = NextTok();
        }
 
        if( token != T_LEFT )
            Expecting( T_LEFT );
 
        token = NextTok();
 
        if( token != T_start )
            Expecting( T_start );
 
        pt.x = parseBoardUnits( "X coordinate" );
        pt.y = parseBoardUnits( "Y coordinate" );
        shape->SetStart( pt );
        NeedRIGHT();
        NeedLEFT();
        token = NextTok();
 
        if( token != T_end )
            Expecting( T_end );
 
        pt.x = parseBoardUnits( "X coordinate" );
        pt.y = parseBoardUnits( "Y coordinate" );
        shape->SetEnd( pt );
        NeedRIGHT();
        break;
 
    case T_gr_poly:
    case T_fp_poly:
    {
        shape->SetShape( SHAPE_T::POLY );
        shape->SetPolyPoints( {} );
 
        SHAPE_LINE_CHAIN& outline = shape->GetPolyShape().Outline( 0 );
 
        token = NextTok();
 
        if( token == T_locked )
        {
            shape->SetLocked( true );
            token = NextTok();
        }
 
        if( token != T_LEFT )
            Expecting( T_LEFT );
 
        token = NextTok();
 
        if( token != T_pts )
            Expecting( T_pts );
 
        while( (token = NextTok() ) != T_RIGHT )
            parseOutlinePoints( outline );
 
        break;
    }
 
    case T_gr_ellipse:
    case T_fp_ellipse: shape->SetShape( SHAPE_T::ELLIPSE ); break;
 
    case T_gr_ellipse_arc:
    case T_fp_ellipse_arc: shape->SetShape( SHAPE_T::ELLIPSE_ARC ); break;
 
    default:
        if( aParent && aParent->Type() == PCB_FOOTPRINT_T )
        {
            Expecting( "fp_arc, fp_circle, fp_curve, fp_ellipse, fp_ellipse_arc, "
                       "fp_line, fp_poly or fp_rect" );
        }
        else
        {
            Expecting( "gr_arc, gr_circle, gr_curve, gr_ellipse, gr_ellipse_arc, "
                       "gr_vector, gr_line, gr_poly, gr_rect or gr_bbox" );
        }
    }
 
    bool foundFill = false;
 
    for( token = NextTok();  token != T_RIGHT;  token = NextTok() )
    {
        if( token != T_LEFT )
            Expecting( T_LEFT );
 
        token = NextTok();
 
        switch( token )
        {
        case T_angle:       // legacy token; ignore value
            parseDouble( "arc angle" );
            NeedRIGHT();
            break;
 
        case T_layer:
            shape->SetLayer( parseBoardItemLayer() );
            NeedRIGHT();
            break;
 
        case T_layers:
            shape->SetLayerSet( parseBoardItemLayersAsMask() );
            break;
 
        case T_solder_mask_margin:
            shape->SetLocalSolderMaskMargin( parseBoardUnits( "local solder mask margin value" ) );
            NeedRIGHT();
            break;
 
        case T_width:       // legacy token
            stroke.SetWidth( parseBoardUnits( T_width ) );
            NeedRIGHT();
            break;
 
        case T_radius:
            shape->SetCornerRadius( parseBoardUnits( "corner radius" ) );
            NeedRIGHT();
            break;
 
        case T_stroke:
        {
            STROKE_PARAMS_PARSER strokeParser( reader, pcbIUScale.IU_PER_MM );
            strokeParser.SyncLineReaderWith( *this );
 
            strokeParser.ParseStroke( stroke );
            SyncLineReaderWith( strokeParser );
            break;
        }
 
        case T_tstamp:
        case T_uuid:
            NextTok();
            shape->SetUuidDirect( CurStrToKIID() );
            NeedRIGHT();
            break;
 
        case T_fill:
            foundFill = true;
 
            for( token = NextTok();  token != T_RIGHT;  token = NextTok() )
            {
                if( token == T_LEFT )
                    token = NextTok();
 
                switch( token )
                {
                // T_yes was used to indicate filling when first introduced, so treat it like a
                // solid fill since that was the only fill available at the time.
                case T_yes:
                case T_solid:         shape->SetFillMode( FILL_T::FILLED_SHAPE );  break;
 
                case T_none:
                case T_no:            shape->SetFillMode( FILL_T::NO_FILL );       break;
 
                case T_hatch:         shape->SetFillMode( FILL_T::HATCH );         break;
                case T_reverse_hatch: shape->SetFillMode( FILL_T::REVERSE_HATCH ); break;
                case T_cross_hatch:   shape->SetFillMode( FILL_T::CROSS_HATCH );   break;
 
                default: Expecting( "yes, no, solid, none, hatch, reverse_hatch or cross_hatch" );
                }
            }
 
            break;
 
        case T_status:      // legacy token; ignore value
            parseHex();
            NeedRIGHT();
            break;
 
        // Handle "(locked)" from 5.99 development, and "(locked yes)" from modern times
        case T_locked:
            shape->SetLocked( parseMaybeAbsentBool( true ) );
            break;
 
        case T_net:
            parseNet( shape.get() );
            break;
 
        case T_center:
            ellipseCenter.x = parseBoardUnits( "X coordinate" );
            ellipseCenter.y = parseBoardUnits( "Y coordinate" );
            NeedRIGHT();
            break;
 
        case T_major_radius:
            ellipseMajor = parseBoardUnits( "major radius" );
            NeedRIGHT();
            break;
 
        case T_minor_radius:
            ellipseMinor = parseBoardUnits( "minor radius" );
            NeedRIGHT();
            break;
 
        case T_rotation_angle:
            ellipseRotation = EDA_ANGLE( parseDouble( "rotation angle" ), DEGREES_T );
            NeedRIGHT();
            break;
 
        case T_start_angle:
            ellipseStart = EDA_ANGLE( parseDouble( "start angle" ), DEGREES_T );
            NeedRIGHT();
            break;
 
        case T_end_angle:
            ellipseEnd = EDA_ANGLE( parseDouble( "end angle" ), DEGREES_T );
            NeedRIGHT();
            break;
 
        case T_start_shape:
        {
            LINE_ENDING ending;
            parseLineEnding( ending );
            shape->SetStartEnding( ending );
            break;
        }
 
        case T_end_shape:
        {
            LINE_ENDING ending;
            parseLineEnding( ending );
            shape->SetEndEnding( ending );
            break;
        }
 
        case T_custom_property:
            parseCustomProperty( shape.get() );
            break;
 
        default:
            Expecting( "layer, width, fill, tstamp, uuid, locked, net, status, solder_mask_margin, center, "
                       "major_radius, minor_radius, rotation_angle, start_angle, end_angle, start_shape, "
                       "end_shape, or custom_property" );
        }
    }
 
    if( !foundFill )
    {
        // Legacy versions didn't have a filled flag but allowed some shapes to indicate they
        // should be filled by specifying a 0 stroke-width.
        if( stroke.GetWidth() == 0
            && ( shape->GetShape() == SHAPE_T::RECTANGLE || shape->GetShape() == SHAPE_T::CIRCLE ) )
        {
            shape->SetFilled( true );
        }
        else if( shape->GetShape() == SHAPE_T::POLY && shape->GetLayer() != Edge_Cuts )
        {
            // Polygons on non-Edge_Cuts layers were always filled.
            shape->SetFilled( true );
        }
    }
 
    // Only filled shapes may have a zero line-width.  This is not permitted in KiCad but some
    // external tools can generate invalid files.
    if( stroke.GetWidth() <= 0 && !shape->IsAnyFill() )
        stroke.SetWidth( pcbIUScale.mmToIU( DEFAULT_LINE_WIDTH ) );
 
    shape->SetStroke( stroke );
 
    if( shape->GetParentFootprint() )
        shape->SetLibStrokeWidth( stroke.GetWidth() );
 
    if( shape->GetShape() == SHAPE_T::ELLIPSE || shape->GetShape() == SHAPE_T::ELLIPSE_ARC )
    {
        shape->SetLibraryEllipse( ellipseCenter, ellipseMajor, ellipseMinor, ellipseRotation, ellipseStart,
                                  ellipseEnd );
 
        if( shape->GetParentFootprint() )
            shape->RebakeFromLib();
    }
    else if( shape->GetParentFootprint() )
    {
        const VECTOR2I libStart = shape->GetStart();
        const VECTOR2I libEnd = shape->GetEnd();
        const VECTOR2I libArcMid = shape->GetShape() == SHAPE_T::ARC ? shape->GetArcMid() : VECTOR2I( 0, 0 );
 
        shape->OverrideLibCoords( libStart, libEnd, libArcMid );
 
        if( shape->GetShape() == SHAPE_T::RECTANGLE )
            shape->OverrideLibCornerRadius( shape->GetCornerRadius() );
 
        if( shape->GetShape() == SHAPE_T::BEZIER )
            shape->OverrideLibBezier( shape->GetBezierC1(), shape->GetBezierC2() );
 
        if( shape->GetShape() == SHAPE_T::POLY )
            shape->OverrideLibPoly( shape->GetPolyShape() );
 
        shape->RebakeFromLib();
    }
 
    return shape.release();
}
 
 
PCB_REFERENCE_IMAGE* PCB_IO_KICAD_SEXPR_PARSER::parsePCB_REFERENCE_IMAGE( BOARD_ITEM* aParent )
{
    wxCHECK_MSG( CurTok() == T_image, nullptr,
                 wxT( "Cannot parse " ) + GetTokenString( CurTok() ) + wxT( " as a reference image." ) );
 
    std::unique_ptr<PCB_REFERENCE_IMAGE> bitmap = std::make_unique<PCB_REFERENCE_IMAGE>( aParent );
 
    for( T token = NextTok(); token != T_RIGHT; token = NextTok() )
    {
        if( token != T_LEFT )
            Expecting( T_LEFT );
 
        token = NextTok();
 
        switch( token )
        {
        case T_at:
        {
            VECTOR2I pos;
            pos.x = parseBoardUnits( "X coordinate" );
            pos.y = parseBoardUnits( "Y coordinate" );
            bitmap->SetPosition( pos );
            NeedRIGHT();
            break;
        }
 
        case T_layer:
            bitmap->SetLayer( parseBoardItemLayer() );
            NeedRIGHT();
            break;
 
        case T_rotate:
        {
            REFERENCE_IMAGE& refImage = bitmap->GetReferenceImage();
            refImage.SetOrientation( EDA_ANGLE( parseDouble( "image rotation" ), DEGREES_T ) );
            NeedRIGHT();
            break;
        }
 
        case T_opacity:
        {
            REFERENCE_IMAGE& refImage = bitmap->GetReferenceImage();
            refImage.SetOpacity( parseDouble( "image opacity" ) );
            NeedRIGHT();
            break;
        }
 
        case T_scale:
        {
            REFERENCE_IMAGE& refImage = bitmap->GetReferenceImage();
            refImage.SetImageScale( parseDouble( "image scale factor" ) );
 
            if( !std::isnormal( refImage.GetImageScale() ) )
                refImage.SetImageScale( 1.0 );
 
            NeedRIGHT();
            break;
        }
        case T_data:
        {
            token = NextTok();
 
            wxString data;
 
            // Reserve 512K because most image files are going to be larger than the default
            // 1K that wxString reserves.
            data.reserve( 1 << 19 );
 
            while( token != T_RIGHT )
            {
                if( !IsSymbol( token ) )
                    Expecting( "base64 image data" );
 
                data += FromUTF8();
                token = NextTok();
            }
 
            wxMemoryBuffer buffer = wxBase64Decode( data );
 
            REFERENCE_IMAGE& refImage = bitmap->GetReferenceImage();
 
            if( !refImage.ReadImageFile( buffer ) )
                THROW_IO_ERROR( _( "Failed to read image data." ) );
 
            break;
        }
 
        case T_locked:
        {
            // This has only ever been (locked yes) format
            const bool locked = parseBool();
            bitmap->SetLocked( locked );
 
            NeedRIGHT();
            break;
        }
 
        case T_uuid:
            NextTok();
            bitmap->SetUuidDirect( CurStrToKIID() );
            NeedRIGHT();
            break;
 
        case T_custom_property:
            parseCustomProperty( bitmap.get() );
            break;
 
        default: Expecting( "at, layer, rotate, opacity, scale, data, locked, uuid, or custom_property" );
        }
    }
 
    // Before 20260623 the PPI was computed from the embedded resolution but pixels/cm was
    // truncated to an integer, so the stored scale compensated for the wrong PPI.  Re-scale
    // to the corrected PPI to preserve the rendered size of existing boards.
    if( m_requiredVersion < 20260623 )
    {
        REFERENCE_IMAGE&   refImage = bitmap->GetReferenceImage();
        const BITMAP_BASE& image = refImage.GetImage();
        int                legacyPPI = image.GetLegacyPPI();
 
        if( legacyPPI > 0 && image.GetPPI() != legacyPPI )
            refImage.SetImageScale( refImage.GetImageScale() * image.GetPPI() / legacyPPI );
    }
 
    return bitmap.release();
}
 
 
PCB_TEXT* PCB_IO_KICAD_SEXPR_PARSER::parsePCB_TEXT( BOARD_ITEM* aParent, PCB_TEXT* aBaseText )
{
    std::unique_ptr<PCB_TEXT> text( aBaseText );
 
    wxCHECK_MSG( CurTok() == T_gr_text || CurTok() == T_fp_text, nullptr,
                 wxT( "Cannot parse " ) + GetTokenString( CurTok() ) + wxT( " as PCB_TEXT." ) );
 
    FOOTPRINT* parentFP = dynamic_cast<FOOTPRINT*>( aParent );
 
    T token = NextTok();
 
    if( !text && parentFP )
    {
        switch( token )
        {
        case T_reference:
            text = std::make_unique<PCB_FIELD>( parentFP, FIELD_T::REFERENCE );
            break;
 
        case T_value:
            text = std::make_unique<PCB_FIELD>( parentFP, FIELD_T::VALUE );
            break;
 
        case T_user:
            text = std::make_unique<PCB_TEXT>( parentFP );
            break;
 
        default:
            THROW_IO_ERRORF( _( "Cannot handle footprint text type %s" ), FromUTF8() );
        }
 
        token = NextTok();
    }
    else if( !text )
    {
        text = std::make_unique<PCB_TEXT>( aParent );
    }
 
    // Legacy bare locked token
    if( token == T_locked )
    {
        text->SetLocked( true );
        token = NextTok();
    }
 
    if( !IsSymbol( token ) && (int) token != DSN_NUMBER )
        Expecting( "text value" );
 
    wxString value = FromUTF8();
    value.Replace( wxT( "%V" ), wxT( "${VALUE}" ) );
    value.Replace( wxT( "%R" ), wxT( "${REFERENCE}" ) );
    text->SetText( value );
 
    NeedLEFT();
 
    parsePCB_TEXT_effects( text.get(), aBaseText );
 
    if( parentFP )
    {
        // Convert hidden footprint text (which is no longer supported) into a hidden field
        if( !text->IsVisible() && text->Type() == PCB_TEXT_T )
        {
            wxString fieldName = GetUserFieldName( parentFP->GetFields().size(), UNTRANSLATED );
            return new PCB_FIELD( *text.get(), FIELD_T::USER, fieldName );
        }
    }
    else
    {
        // Hidden PCB text is no longer supported
        text->SetVisible( true );
    }
 
    return text.release();
}
 
 
void PCB_IO_KICAD_SEXPR_PARSER::parsePCB_TEXT_effects( PCB_TEXT* aText, PCB_TEXT* aBaseText )
{
    FOOTPRINT* parentFP = dynamic_cast<FOOTPRINT*>( aText->GetParent() );
    bool hasAngle       = false;    // Old files do not have a angle specified.
                                    // in this case it is 0 expected to be 0
    bool hasPos         = false;
 
    // By default, texts in footprints have a locked rotation (i.e. rot = -90 ... 90 deg)
    if( parentFP )
        aText->SetKeepUpright( true );
 
    for( T token = NextTok(); token != T_RIGHT; token = NextTok() )
    {
        if( token == T_LEFT )
            token = NextTok();
 
        switch( token )
        {
        case T_at:
        {
            VECTOR2I pt;
 
            hasPos = true;
            pt.x = parseBoardUnits( "X coordinate" );
            pt.y = parseBoardUnits( "Y coordinate" );
 
            if( parentFP && m_requiredVersion >= FIRST_FP_AFFINE_TRANSFORM )
                aText->SetLibTextPos( pt );
            else
                aText->SetTextPos( pt );
            token = NextTok();
 
            if( CurTok() == T_NUMBER )
            {
                aText->SetTextAngle( EDA_ANGLE( parseDouble(), DEGREES_T ) );
                hasAngle = true;
                token = NextTok();
            }
 
            // Legacy location of this token; presence implies true
            if( parentFP && CurTok() == T_unlocked )
            {
                aText->SetKeepUpright( false );
                token = NextTok();
            }
 
            if( (int) token != DSN_RIGHT )
                Expecting( DSN_RIGHT );
 
            break;
        }
 
        case T_layer:
            aText->SetLayer( parseBoardItemLayer() );
 
            token = NextTok();
 
            if( token == T_knockout )
            {
                aText->SetIsKnockout( true );
                token = NextTok();
            }
 
            if( (int) token != DSN_RIGHT )
                Expecting( DSN_RIGHT );
 
            break;
 
        case T_tstamp:
        case T_uuid:
            NextTok();
            aText->SetUuidDirect( CurStrToKIID() );
            NeedRIGHT();
            break;
 
        case T_hide:
        {
            // In older files, the hide token appears bare, and indicates hide==true.
            // In newer files, it will be an explicit bool in a list like (hide yes)
            bool hide = parseMaybeAbsentBool( true );
 
            if( parentFP )
                aText->SetVisible( !hide );
            else
                Expecting( "layer, effects, locked, render_cache, uuid or tstamp" );
 
            break;
        }
 
        case T_locked:
            // Newer list-enclosed locked
            aText->SetLocked( parseBool() );
            NeedRIGHT();
            break;
 
        // Confusingly, "unlocked" is not the opposite of "locked", but refers to "keep upright"
        case T_unlocked:
            if( parentFP )
                aText->SetKeepUpright( !parseBool() );
            else
                Expecting( "layer, effects, locked, render_cache or tstamp" );
 
            NeedRIGHT();
            break;
 
        case T_effects:
            parseEDA_TEXT( static_cast<EDA_TEXT*>( aText ) );
            break;
 
        case T_render_cache:
            parseRenderCache( static_cast<EDA_TEXT*>( aText ) );
            break;
 
        case T_custom_property:
            parseCustomProperty( aText );
            break;
 
        default:
            if( parentFP )
                Expecting( "layer, hide, effects, locked, render_cache, tstamp, uuid, or custom_property" );
            else
                Expecting( "layer, effects, locked, render_cache, tstamp, uuid, or custom_property" );
        }
    }
 
    // If there is no orientation defined, then it is the default value of 0 degrees.
    if( !hasAngle )
        aText->SetTextAngle( ANGLE_0 );
 
    if( parentFP && !dynamic_cast<PCB_DIMENSION_BASE*>( aBaseText ) && m_requiredVersion < FIRST_FP_AFFINE_TRANSFORM )
    {
        // Legacy files stored an absolute board-frame angle and an FP-relative
        // position with the parent FP transform un-applied. Rotate and move
        // the text into board coordinates.
        aText->SetTextAngle( aText->GetTextAngle() - parentFP->GetOrientation() );
        aText->Rotate( { 0, 0 }, parentFP->GetOrientation() );
 
        // Only move offset from parent position if we read a position from the file.
        // These positions are relative to the parent footprint. If we don't have a position
        // then the text defaults to the parent position and moving again will double it.
        if( hasPos )
            aText->Move( parentFP->GetPosition() );
    }
 
    if( parentFP && !dynamic_cast<PCB_DIMENSION_BASE*>( aBaseText ) && m_requiredVersion >= FIRST_FP_AFFINE_TRANSFORM )
    {
        aText->SetLibTextSize( aText->GetTextSize() );
 
        if( !aText->GetAutoThickness() )
            aText->SetLibTextThickness( aText->GetTextThickness() );
    }
}
 
 
PCB_BARCODE* PCB_IO_KICAD_SEXPR_PARSER::parsePCB_BARCODE( BOARD_ITEM* aParent )
{
    wxCHECK_MSG( CurTok() == T_barcode, nullptr,
                 wxT( "Cannot parse " ) + GetTokenString( CurTok() ) + wxT( " as PCB_BARCODE." ) );
 
    std::unique_ptr<PCB_BARCODE> barcode = std::make_unique<PCB_BARCODE>( aParent );
 
    for( T token = NextTok(); token != T_RIGHT; token = NextTok() )
    {
        if( token != T_LEFT )
            Expecting( T_LEFT );
 
        token = NextTok();
 
        switch( token )
        {
        case T_at:
        {
            VECTOR2I pos;
            pos.x = parseBoardUnits( "X coordinate" );
            pos.y = parseBoardUnits( "Y coordinate" );
            barcode->SetPosition( pos );
            token = NextTok();
 
            if( CurTok() == T_NUMBER )
                barcode->SetOrientation( parseDouble() );
 
            NeedRIGHT();
            break;
        }
 
        case T_layer:
            barcode->SetLayer( parseBoardItemLayer() );
            NeedRIGHT();
            break;
 
        case T_size:
        {
            int w = parseBoardUnits( "barcode width" );
            int h = parseBoardUnits( "barcode height" );
            barcode->SetWidth( w );
            barcode->SetHeight( h );
            NeedRIGHT();
            break;
        }
 
        case T_text:
            if( NextTok() != T_STRING )
                Expecting( T_STRING );
 
            barcode->SetText( FromUTF8() );
            NeedRIGHT();
            break;
 
        case T_text_height:
        {
            int h = parseBoardUnits( "barcode text height" );
            barcode->SetTextSize( h );
            NeedRIGHT();
            break;
        }
 
        case T_type:
            NeedSYMBOL();
            {
                std::string kind = CurText();
                if( kind == "code39" )
                    barcode->SetKind( BARCODE_T::CODE_39 );
                else if( kind == "code128" )
                    barcode->SetKind( BARCODE_T::CODE_128 );
                else if( kind == "datamatrix" || kind == "data_matrix" )
                    barcode->SetKind( BARCODE_T::DATA_MATRIX );
                else if( kind == "qr" || kind == "qrcode" )
                    barcode->SetKind( BARCODE_T::QR_CODE );
                else if( kind == "microqr" || kind == "micro_qr" )
                    barcode->SetKind( BARCODE_T::MICRO_QR_CODE );
                else
                    Expecting( "barcode type" );
            }
            NeedRIGHT();
            break;
 
        case T_ecc_level:
            NeedSYMBOL();
            {
                std::string ecc = CurText();
                if( ecc == "L" || ecc == "l" )
                    barcode->SetErrorCorrection( BARCODE_ECC_T::L );
                else if( ecc == "M" || ecc == "m" )
                    barcode->SetErrorCorrection( BARCODE_ECC_T::M );
                else if( ecc == "Q" || ecc == "q" )
                    barcode->SetErrorCorrection( BARCODE_ECC_T::Q );
                else if( ecc == "H" || ecc == "h" )
                    barcode->SetErrorCorrection( BARCODE_ECC_T::H );
                else
                    Expecting( "ecc level" );
            }
            NeedRIGHT();
            break;
 
 
        case T_locked:
            barcode->SetLocked( parseMaybeAbsentBool( true ) );
            break;
 
        case T_tstamp:
        case T_uuid:
            NextTok();
            barcode->SetUuidDirect( CurStrToKIID() );
            NeedRIGHT();
            break;
 
        case T_hide:
            barcode->SetShowText( !parseBool() );
            NeedRIGHT();
            break;
 
        case T_knockout:
            barcode->SetIsKnockout( parseBool() );
            NeedRIGHT();
            break;
 
        case T_margins:
        {
            int marginX = parseBoardUnits( "margin X" );
            int marginY = parseBoardUnits( "margin Y" );
            barcode->SetMargin( VECTOR2I( marginX, marginY ) );
            NeedRIGHT();
            break;
        }
 
        case T_custom_property:
            parseCustomProperty( barcode.get() );
            break;
 
        default:
            Expecting( "at, layer, size, text, text_height, type, ecc_level, locked, hide, knockout, margins, "
                       "uuid, or custom_property" );
        }
    }
 
    barcode->AssembleBarcode();
 
    return barcode.release();
}
 

void PCB_IO_KICAD_SEXPR_PARSER::bakeTextBoxLib( PCB_TEXTBOX* aTextBox )
{
    aTextBox->SetLibTextAngle( aTextBox->EDA_TEXT::GetTextAngle() );
 
    if( aTextBox->GetShape() == SHAPE_T::RECTANGLE )
        aTextBox->OverrideLibCoords( aTextBox->GetStart(), aTextBox->GetEnd() );
    else if( aTextBox->GetShape() == SHAPE_T::POLY )
        aTextBox->OverrideLibPoly( aTextBox->GetPolyShape() );
 
    if( aTextBox->GetParentFootprint() )
        aTextBox->OnFootprintTransformed();
 
    // Sync the EDA_TEXT angle cache to the absolute board angle.
    aTextBox->EDA_TEXT::SetTextAngle( aTextBox->GetTextAngle() );
}
 
 
PCB_TEXTBOX* PCB_IO_KICAD_SEXPR_PARSER::parsePCB_TEXTBOX( BOARD_ITEM* aParent )
{
    wxCHECK_MSG( CurTok() == T_gr_text_box || CurTok() == T_fp_text_box, nullptr,
                 wxT( "Cannot parse " ) + GetTokenString( CurTok() ) + wxT( " as PCB_TEXTBOX." ) );
 
    std::unique_ptr<PCB_TEXTBOX> textbox = std::make_unique<PCB_TEXTBOX>( aParent );
 
    parseTextBoxContent( textbox.get() );
    bakeTextBoxLib( textbox.get() );
 
    return textbox.release();
}
 
 
PCB_TABLECELL* PCB_IO_KICAD_SEXPR_PARSER::parsePCB_TABLECELL( BOARD_ITEM* aParent )
{
    wxCHECK_MSG( CurTok() == T_table_cell, nullptr,
                 wxT( "Cannot parse " ) + GetTokenString( CurTok() ) + wxT( " as a table cell." ) );
 
    std::unique_ptr<PCB_TABLECELL> cell = std::make_unique<PCB_TABLECELL>( aParent );
 
    parseTextBoxContent( cell.get() );
    bakeTextBoxLib( cell.get() );
 
    return cell.release();
}
 
 
void PCB_IO_KICAD_SEXPR_PARSER::parseTextBoxContent( PCB_TEXTBOX* aTextBox )
{
    int           left;
    int           top;
    int           right;
    int           bottom;
    STROKE_PARAMS stroke( -1, LINE_STYLE::SOLID );
    bool          foundMargins = false;
 
    T token = NextTok();
 
    // Legacy locked
    if( token == T_locked )
    {
        aTextBox->SetLocked( true );
        token = NextTok();
    }
 
    if( !IsSymbol( token ) && (int) token != DSN_NUMBER )
        Expecting( "text value" );
 
    aTextBox->SetText( FromUTF8() );
 
    for( token = NextTok(); token != T_RIGHT; token = NextTok() )
    {
        if( token != T_LEFT )
            Expecting( T_LEFT );
 
        token = NextTok();
 
        switch( token )
        {
        case T_locked:
            aTextBox->SetLocked( parseMaybeAbsentBool( true ) );
            break;
 
        case T_start:
        {
            int x = parseBoardUnits( "X coordinate" );
            int y = parseBoardUnits( "Y coordinate" );
            aTextBox->SetStart( VECTOR2I( x, y ) );
            NeedRIGHT();
 
            NeedLEFT();
            token = NextTok();
 
            if( token != T_end )
                Expecting( T_end );
 
            x = parseBoardUnits( "X coordinate" );
            y = parseBoardUnits( "Y coordinate" );
            aTextBox->SetEnd( VECTOR2I( x, y ) );
            NeedRIGHT();
            break;
        }
 
        case T_pts:
            aTextBox->SetShape( SHAPE_T::POLY );
            aTextBox->GetPolyShape().RemoveAllContours();
            aTextBox->GetPolyShape().NewOutline();
 
            while( (token = NextTok() ) != T_RIGHT )
                parseOutlinePoints( aTextBox->GetPolyShape().Outline( 0 ) );
 
            break;
 
        case T_angle:
            // Set the angle of the text only, the coordinates of the box (a polygon) are
            // already at the right position, and must not be rotated
            aTextBox->EDA_TEXT::SetTextAngle( EDA_ANGLE( parseDouble( "text box angle" ), DEGREES_T ) );
            NeedRIGHT();
            break;
 
        case T_stroke:
        {
            STROKE_PARAMS_PARSER strokeParser( reader, pcbIUScale.IU_PER_MM );
            strokeParser.SyncLineReaderWith( *this );
 
            strokeParser.ParseStroke( stroke );
            SyncLineReaderWith( strokeParser );
            break;
        }
 
        case T_border:
            aTextBox->SetBorderEnabled( parseBool() );
            NeedRIGHT();
            break;
 
        case T_margins:
            parseMargins( left, top, right, bottom );
            aTextBox->SetMarginLeft( left );
            aTextBox->SetMarginTop( top );
            aTextBox->SetMarginRight( right );
            aTextBox->SetMarginBottom( bottom );
            foundMargins = true;
            NeedRIGHT();
            break;
 
        case T_layer:
            aTextBox->SetLayer( parseBoardItemLayer() );
            NeedRIGHT();
            break;
 
        case T_knockout:
            aTextBox->SetIsKnockout( parseBool() );
            NeedRIGHT();
            break;
 
        case T_span:
            if( PCB_TABLECELL* cell = dynamic_cast<PCB_TABLECELL*>( aTextBox ) )
            {
                cell->SetColSpan( parseInt( "column span" ) );
                cell->SetRowSpan( parseInt( "row span" ) );
            }
            else
            {
                Expecting( "locked, start, pts, angle, width, stroke, border, margins, knockout, "
                           "layer, effects, render_cache, uuid or tstamp" );
            }
 
            NeedRIGHT();
            break;
 
        case T_tstamp:
        case T_uuid:
            NextTok();
            aTextBox->SetUuidDirect( CurStrToKIID() );
            NeedRIGHT();
            break;
 
        case T_effects:
            parseEDA_TEXT( static_cast<EDA_TEXT*>( aTextBox ) );
            break;
 
        case T_render_cache:
            parseRenderCache( static_cast<EDA_TEXT*>( aTextBox ) );
            break;
 
        case T_custom_property:
            parseCustomProperty( aTextBox );
            break;
 
        default:
            if( dynamic_cast<PCB_TABLECELL*>( aTextBox ) != nullptr )
            {
                Expecting( "locked, start, pts, angle, width, margins, knockout, layer, effects, "
                           "span, render_cache, uuid, tstamp, or custom_property" );
            }
            else
            {
                Expecting( "locked, start, pts, angle, width, stroke, border, margins, knockout,"
                           "layer, effects, render_cache, uuid, tstamp, or custom_property" );
            }
        }
    }
 
    aTextBox->SetStroke( stroke );
 
    if( m_requiredVersion < 20230825 ) // compat, we move to an explicit flag
        aTextBox->SetBorderEnabled( stroke.GetWidth() >= 0 );
 
    if( !foundMargins )
    {
        int margin = aTextBox->GetLegacyTextMargin();
        aTextBox->SetMarginLeft( margin );
        aTextBox->SetMarginTop( margin );
        aTextBox->SetMarginRight( margin );
        aTextBox->SetMarginBottom( margin );
    }
}
 
 
// A drill chart offers its own tokens first and shares the rest, so identity is accepted
// only for the plain table form
bool PCB_IO_KICAD_SEXPR_PARSER::parseTableBodyToken( PCB_TABLE* aTable, T aToken, bool aAllowIdentity )
{
    PCB_TABLE* table = aTable;
    T          token = aToken;
 
    switch( aToken )
    {
        case T_column_count:
            table->SetColCount( parseInt( "column count" ) );
            NeedRIGHT();
            return true;
 
        case T_uuid:
            if( !aAllowIdentity )
                Expecting( "table geometry without identity" );
 
            NextTok();
            table->SetUuidDirect( CurStrToKIID() );
            NeedRIGHT();
            return true;
 
        case T_locked:
            if( !aAllowIdentity )
                Expecting( "table geometry without identity" );
 
            table->SetLocked( parseBool() );
            NeedRIGHT();
            return true;
 
        case T_angle:   // legacy token no longer used
            NeedRIGHT();
            return true;
 
        case T_layer:
            if( !aAllowIdentity )
                Expecting( "table geometry without identity" );
 
            table->SetLayer( parseBoardItemLayer() );
            NeedRIGHT();
            return true;
 
        case T_column_widths:
        {
            int col = 0;
 
            while( ( token = NextTok() ) != T_RIGHT )
                table->SetColWidth( col++, parseBoardUnits() );
 
            return true;
        }
 
        case T_row_heights:
        {
            int row = 0;
 
            while( ( token = NextTok() ) != T_RIGHT )
                table->SetRowHeight( row++, parseBoardUnits() );
 
            return true;
        }
 
        case T_cells:
            for( token = NextTok(); token != T_RIGHT; token = NextTok() )
            {
                if( token != T_LEFT )
                    Expecting( T_LEFT );
 
                token = NextTok();
 
                if( token != T_table_cell )
                    Expecting( "table_cell" );
 
                table->AddCell( parsePCB_TABLECELL( table ) );
            }
 
            return true;
 
        case T_border:
            for( token = NextTok(); token != T_RIGHT; token = NextTok() )
            {
                if( token != T_LEFT )
                    Expecting( T_LEFT );
 
                token = NextTok();
 
                switch( token )
                {
                case T_external:
                    table->SetStrokeExternal( parseBool() );
                    NeedRIGHT();
                    break;
 
                case T_header:
                    table->SetStrokeHeaderSeparator( parseBool() );
                    NeedRIGHT();
                    break;
 
                case T_stroke:
                {
                    STROKE_PARAMS_PARSER strokeParser( reader, pcbIUScale.IU_PER_MM );
                    strokeParser.SyncLineReaderWith( *this );
 
                    STROKE_PARAMS borderStroke( -1, LINE_STYLE::SOLID );
                    strokeParser.ParseStroke( borderStroke );
                    SyncLineReaderWith( strokeParser );
 
                    table->SetBorderStroke( borderStroke );
                    break;
                }
 
                default:
                    Expecting( "external, header or stroke" );
                    break;
                }
            }
 
            return true;
 
        case T_separators:
            for( token = NextTok(); token != T_RIGHT; token = NextTok() )
            {
                if( token != T_LEFT )
                    Expecting( T_LEFT );
 
                token = NextTok();
 
                switch( token )
                {
                case T_rows:
                    table->SetStrokeRows( parseBool() );
                    NeedRIGHT();
                    break;
 
                case T_cols:
                    table->SetStrokeColumns( parseBool() );
                    NeedRIGHT();
                    break;
 
                case T_stroke:
                {
                    STROKE_PARAMS_PARSER strokeParser( reader, pcbIUScale.IU_PER_MM );
                    strokeParser.SyncLineReaderWith( *this );
 
                    STROKE_PARAMS separatorsStroke( -1, LINE_STYLE::SOLID );
                    strokeParser.ParseStroke( separatorsStroke );
                    SyncLineReaderWith( strokeParser );
 
                    table->SetSeparatorsStroke( separatorsStroke );
                    break;
                }
 
                default:
                    Expecting( "rows, cols, or stroke" );
                    break;
                }
            }
 
            return true;
 
        case T_custom_property:
            parseCustomProperty( table );
            return true;
 
    default:
        return false;
    }
}
 
 
void PCB_IO_KICAD_SEXPR_PARSER::parseTableBody( PCB_TABLE* aTable, bool aAllowIdentity )
{
    for( T token = NextTok(); token != T_RIGHT; token = NextTok() )
    {
        if( token != T_LEFT )
            Expecting( T_LEFT );
 
        token = NextTok();
 
        if( !parseTableBodyToken( aTable, token, aAllowIdentity ) )
            Expecting( "columns, layer, col_widths, row_heights, border, separators, header or cells" );
    }
}
 
 
DRILL_SPAN PCB_IO_KICAD_SEXPR_PARSER::parseDrillSpanBody()
{
    wxString           name = FromUTF8();
    const PCB_LAYER_ID startLayer = static_cast<PCB_LAYER_ID>( LSET::NameToLayer( name ) );
 
    NeedSYMBOLorNUMBER();
    name = FromUTF8();
    const PCB_LAYER_ID endLayer = static_cast<PCB_LAYER_ID>( LSET::NameToLayer( name ) );
 
    bool backdrill = false;
    bool nonPlated = false;
 
    // The flags are what tell a backdrill span apart from the primary span sharing its layer
    // pair, so a map without them comes back pointing at the wrong holes
    for( T token = NextTok(); token != T_RIGHT; token = NextTok() )
    {
        if( token == T_backdrill )
            backdrill = true;
        else if( token == T_npth )
            nonPlated = true;
    }
 
    return DRILL_SPAN( startLayer, endLayer, backdrill, nonPlated );
}
 
 
PCB_DRILL_MAP* PCB_IO_KICAD_SEXPR_PARSER::parsePCB_DRILL_MAP( BOARD_ITEM* aParent )
{
    wxCHECK_MSG( CurTok() == T_drill_map, nullptr,
                 wxT( "Cannot parse " ) + GetTokenString( CurTok() ) + wxT( " as a drill map." ) );
 
    std::unique_ptr<PCB_DRILL_MAP> map = std::make_unique<PCB_DRILL_MAP>( aParent );
 
    for( T token = NextTok(); token != T_RIGHT; token = NextTok() )
    {
        if( token != T_LEFT )
            Expecting( T_LEFT );
 
        token = NextTok();
 
        switch( token )
        {
        case T_uuid:
            NextTok();
            map->SetUuidDirect( CurStrToKIID() );
            NeedRIGHT();
            break;
 
        case T_locked:
            map->SetLocked( parseBool() );
            NeedRIGHT();
            break;
 
        case T_layer:
            map->SetLayer( parseBoardItemLayer() );
            NeedRIGHT();
            break;
 
        case T_offset:
        {
            VECTOR2I offset;
            offset.x = parseBoardUnits( "drill map x offset" );
            offset.y = parseBoardUnits( "drill map y offset" );
            map->SetOffset( offset );
            NeedRIGHT();
            break;
        }
 
        case T_size:
            map->SetSymbolSize( parseBoardUnits( "drill map symbol size" ) );
            NeedRIGHT();
            break;
 
        case T_span:
        {
            NextTok();
 
            if( CurTok() == T_all )
            {
                map->SetAllSpans( true );
                NeedRIGHT();
            }
            else
            {
                map->SetAllSpans( false );
                map->SetSpan( parseDrillSpanBody() );
            }
 
            break;
        }
 
        case T_outline_slots:
            map->SetOutlineSlots( parseBool() );
            NeedRIGHT();
            break;
 
        case T_guide_cross:
            map->SetGuideCross( parseBool() );
            NeedRIGHT();
            break;
 
        case T_custom_property:
            parseCustomProperty( map.get() );
            break;
 
        default:
            skipCurrent();
            break;
        }
    }
 
    if( !DocumentationLayers().Contains( map->GetLayer() ) )
    {
        THROW_IO_ERROR( _( "Invalid drill map: not on a documentation layer" ) );
    }
 
    return map.release();
}
 
 
PCB_GENERATED_TABLE* PCB_IO_KICAD_SEXPR_PARSER::parseGeneratedTable( std::unique_ptr<PCB_GENERATED_TABLE> aTable )
{
    const GENERATED_TABLE_SCHEMA& schema = aTable->Schema();
 
    // The file's columns replace the defaults a new table starts with rather than adding to them
    aTable->Columns().clear();
 
    // The writer omits units and precision equal to these, whatever the constructor chose
    aTable->SetUnits( schema.DefaultUnits() );
    aTable->SetPrecision( schema.DefaultPrecision() );
 
    for( T token = NextTok(); token != T_RIGHT; token = NextTok() )
    {
        if( token != T_LEFT )
            Expecting( T_LEFT );
 
        token = NextTok();
 
        switch( token )
        {
        case T_uuid:
            NextTok();
            aTable->SetUuidDirect( CurStrToKIID() );
            NeedRIGHT();
            break;
 
        case T_locked:
            aTable->SetLocked( parseBool() );
            NeedRIGHT();
            break;
 
        case T_layer:
            aTable->SetLayer( parseBoardItemLayer() );
            NeedRIGHT();
            break;
 
        case T_units:
        {
            NeedSYMBOLorNUMBER();
            GENERATED_TABLE_UNITS units;
 
            if( GeneratedTableUnitsFromToken( FromUTF8(), units ) )
                aTable->SetUnits( units );
 
            NeedRIGHT();
            break;
        }
 
        case T_precision:
            aTable->SetPrecision( parseInt( "generated table precision" ) );
            NeedRIGHT();
            break;
 
        case T_column:
        {
            GENERATED_TABLE_COLUMN col;
 
            // Not GENERATED_TABLE_COLUMN's default 0 (a schema's first id), or an unrecognized
            // id token that never sets it would silently become a real column instead of being
            // dropped by Validate() below as the unknown id it actually is
            col.m_Id = -1;
 
            for( token = NextTok(); token != T_RIGHT; token = NextTok() )
            {
                if( token != T_LEFT )
                    Expecting( T_LEFT );
 
                token = NextTok();
 
                switch( token )
                {
                case T_id:
                    NeedSYMBOLorNUMBER();
 
                    if( const GENERATED_TABLE_COLUMN_DEF* def = schema.FindToken( FromUTF8() ) )
                    {
                        // The writer's own default is this literal, never DefaultColumn()'s
                        // translated text, so a heading it left out reads back the same
                        // regardless of which locale is active now
                        col.m_Id = def->m_Id;
                        col.m_Heading = wxString( def->m_Heading );
                        col.m_Align = def->m_Align;
                    }
 
                    NeedRIGHT();
                    break;
 
                case T_name:
                    NeedSYMBOLorNUMBER();
                    col.m_Heading = FromUTF8();
                    NeedRIGHT();
                    break;
 
                case T_justify:
                    NeedSYMBOLorNUMBER();
                    GeneratedTableAlignFromToken( FromUTF8(), col.m_Align );
                    NeedRIGHT();
                    break;
 
                case T_width:
                    col.m_Width = parseBoardUnits( "generated table column width" );
                    NeedRIGHT();
                    break;
 
                default:
                    skipCurrent();
                    break;
                }
            }
 
            aTable->Columns().push_back( col );
            break;
        }
 
        case T_row_keys:
            for( token = NextTok(); token != T_RIGHT; token = NextTok() )
            {
                if( token != T_LEFT )
                    Expecting( T_LEFT );
 
                token = NextTok();
 
                if( token == T_key )
                {
                    const int row = parseInt( "row key row" );
 
                    NeedSYMBOLorNUMBER();
                    aTable->RowKeys()[row] = curText;
                }
 
                NeedRIGHT();
            }
 
            break;
 
        default:
            if( parseGeneratedTableExtra( aTable.get(), token ) )
                break;
 
            // A generated table is a table, so whatever is left is the geometry and cells it
            // shares with one rather than something to skip
            if( !parseTableBodyToken( aTable.get(), token, false ) )
                skipCurrent();
 
            break;
        }
    }
 
    if( aTable->Columns().empty() )
        aTable->Columns() = schema.Defaults();
 
    // No columns leaves every later consumer dividing by the column count. Repeats and
    // implausible widths reach table geometry
    if( aTable->GetColCount() < 1 || !schema.Validate( aTable->Columns() ) )
    {
        THROW_IO_ERROR( wxString::Format( _( "Invalid %s: bad column set" ), aTable->GetFriendlyName() ) );
    }
 
    // Copper, silkscreen, mask, paste, adhesive, Edge.Cuts, Margin and courtyard are all
    // manufacturing inputs that table artwork would corrupt rather than document
    if( !DocumentationLayers().Contains( aTable->GetLayer() ) )
    {
        THROW_IO_ERROR( wxString::Format( _( "Invalid %s: not on a documentation layer" ),
                                          aTable->GetFriendlyName() ) );
    }
 
    return aTable.release();
}
 
 
bool PCB_IO_KICAD_SEXPR_PARSER::parseGeneratedTableExtra( PCB_GENERATED_TABLE* aTable, T aToken )
{
    switch( aTable->Type() )
    {
    case PCB_DRILL_CHART_T:
    {
        PCB_DRILL_CHART* chart = static_cast<PCB_DRILL_CHART*>( aTable );
 
        switch( aToken )
        {
        case T_filter:
            for( T token = NextTok(); token != T_RIGHT; token = NextTok() )
            {
                if( token != T_LEFT )
                    Expecting( T_LEFT );
 
                token = NextTok();
 
                switch( token )
                {
                case T_plated:      chart->Filter().m_Plated = parseBool(); NeedRIGHT(); break;
                case T_npth:        chart->Filter().m_NonPlated = parseBool(); NeedRIGHT(); break;
                case T_vias:        chart->Filter().m_Vias = parseBool(); NeedRIGHT(); break;
                case T_slots:       chart->Filter().m_Slots = parseBool(); NeedRIGHT(); break;
                case T_backdrill:   chart->Filter().m_Backdrills = parseBool(); NeedRIGHT(); break;
                case T_castellated: chart->Filter().m_Castellated = parseBool(); NeedRIGHT(); break;
                default:            skipCurrent(); break;
                }
            }
 
            return true;
 
        case T_totals:
            chart->SetShowTotals( parseBool() );
            NeedRIGHT();
            return true;
 
        case T_row_shapes:
            for( T token = NextTok(); token != T_RIGHT; token = NextTok() )
            {
                if( token != T_LEFT )
                    Expecting( T_LEFT );
 
                token = NextTok();
 
                if( token == T_column )
                {
                    chart->SetSymbolColumn( parseInt( "symbol column" ) );
                }
                else if( token == T_shape )
                {
                    const int row = parseInt( "row shape row" );
                    chart->RowShapes()[row] = parseInt( "row shape index" );
                }
 
                NeedRIGHT();
            }
 
            return true;
 
        default:
            return false;
        }
    }
 
    default:
        return false;
    }
}
 
 
PCB_TABLE* PCB_IO_KICAD_SEXPR_PARSER::parsePCB_TABLE( BOARD_ITEM* aParent )
{
    wxCHECK_MSG( CurTok() == T_table, nullptr,
                 wxT( "Cannot parse " ) + GetTokenString( CurTok() ) + wxT( " as a table." ) );
 
    std::unique_ptr<PCB_TABLE> table = std::make_unique<PCB_TABLE>( aParent, -1 );
 
    parseTableBody( table.get(), true );
 
    return table.release();
}
 
 
PCB_DIMENSION_BASE* PCB_IO_KICAD_SEXPR_PARSER::parseDIMENSION( BOARD_ITEM* aParent )
{
    wxCHECK_MSG( CurTok() == T_dimension, nullptr,
                 wxT( "Cannot parse " ) + GetTokenString( CurTok() ) + wxT( " as DIMENSION." ) );
 
    T token;
    bool locked = false;
    std::unique_ptr<PCB_DIMENSION_BASE> dim;
 
    token = NextTok();
 
    // Free 'locked' token from 6.0/7.0 formats
    if( token == T_locked )
    {
        locked = true;
        token = NextTok();
    }
 
    // skip value that used to be saved
    if( token != T_LEFT )
        NeedLEFT();
 
    token = NextTok();
 
    bool isLegacyDimension = false;
    bool isStyleKnown = false;
 
    // Old format
    if( token == T_width )
    {
        isLegacyDimension = true;
        dim = std::make_unique<PCB_DIM_ALIGNED>( aParent );
        dim->SetLineThickness( parseBoardUnits( "dimension width value" ) );
        NeedRIGHT();
    }
    else
    {
        if( token != T_type )
            Expecting( T_type );
 
        switch( NextTok() )
        {
        case T_aligned:    dim = std::make_unique<PCB_DIM_ALIGNED>( aParent );    break;
        case T_orthogonal: dim = std::make_unique<PCB_DIM_ORTHOGONAL>( aParent ); break;
        case T_leader:     dim = std::make_unique<PCB_DIM_LEADER>( aParent );     break;
        case T_center:     dim = std::make_unique<PCB_DIM_CENTER>( aParent );     break;
        case T_radial:     dim = std::make_unique<PCB_DIM_RADIAL>( aParent );     break;
        default:           wxFAIL_MSG( wxT( "Cannot parse unknown dimension type " ) + GetTokenString( CurTok() ) );
        }
 
        NeedRIGHT();
 
        // Before parsing further, set default properites for old KiCad file
        // versions that didnt have these properties:
        dim->SetArrowDirection( DIM_ARROW_DIRECTION::OUTWARD );
    }
 
    for( token = NextTok();  token != T_RIGHT;  token = NextTok() )
    {
        if( token != T_LEFT )
            Expecting( T_LEFT );
 
        token = NextTok();
 
        switch( token )
        {
        case T_layer:
            dim->SetLayer( parseBoardItemLayer() );
            NeedRIGHT();
            break;
 
        case T_tstamp:
        case T_uuid:
            NextTok();
            dim->SetUuidDirect( CurStrToKIID() );
            NeedRIGHT();
            break;
 
        case T_gr_text:
        {
            // In old pcb files, when parsing the text we do not yet know
            // if the text is kept aligned or not, and its DIM_TEXT_POSITION option.
            // Leave the text not aligned for now to read the text angle, and no
            // constraint for DIM_TEXT_POSITION in this case.
            // It will be set aligned (or not) later
            bool is_aligned = dim->GetKeepTextAligned();
            DIM_TEXT_POSITION t_dim_pos = dim->GetTextPositionMode();
 
            if( !isStyleKnown )
            {
                dim->SetTextPositionMode( DIM_TEXT_POSITION::MANUAL );
                dim->SetKeepTextAligned( false );
            }
 
            dim.reset( static_cast<PCB_DIMENSION_BASE*>( parsePCB_TEXT( m_board, dim.release() ) ) );
 
            if( isLegacyDimension )
            {
                EDA_UNITS units = EDA_UNITS::MM;
 
                if( !EDA_UNIT_UTILS::FetchUnitsFromString( dim->GetText(), units ) )
                    dim->SetAutoUnits( true ); //Not determined => use automatic units
 
                dim->SetUnits( units );
            }
 
            if( !isStyleKnown )
            {
                dim->SetKeepTextAligned( is_aligned );
                dim->SetTextPositionMode( t_dim_pos );
            }
            break;
        }
 
        // New format: feature points
        case T_pts:
        {
            VECTOR2I point;
 
            parseXY( &point.x, &point.y );
            dim->SetStart( point );
            parseXY( &point.x, &point.y );
            dim->SetEnd( point );
 
            NeedRIGHT();
            break;
        }
 
        case T_height:
        {
            int height = parseBoardUnits( "dimension height value" );
            NeedRIGHT();
 
            if( dim->Type() == PCB_DIM_ORTHOGONAL_T || dim->Type() == PCB_DIM_ALIGNED_T )
            {
                PCB_DIM_ALIGNED* aligned = static_cast<PCB_DIM_ALIGNED*>( dim.get() );
                aligned->SetHeight( height );
            }
 
            break;
        }
 
        case T_leader_length:
        {
            int length = parseBoardUnits( "leader length value" );
            NeedRIGHT();
 
            if( dim->Type() == PCB_DIM_RADIAL_T )
            {
                PCB_DIM_RADIAL* radial = static_cast<PCB_DIM_RADIAL*>( dim.get() );
                radial->SetLeaderLength( length );
            }
 
            break;
        }
 
        case T_orientation:
        {
            int orientation = parseInt( "orthogonal dimension orientation" );
            NeedRIGHT();
 
            if( dim->Type() == PCB_DIM_ORTHOGONAL_T )
            {
                PCB_DIM_ORTHOGONAL* ortho = static_cast<PCB_DIM_ORTHOGONAL*>( dim.get() );
                orientation = std::clamp( orientation, 0, 1 );
                ortho->SetOrientation( static_cast<PCB_DIM_ORTHOGONAL::DIR>( orientation ) );
            }
 
            break;
        }
 
        case T_format:
        {
            for( token = NextTok(); token != T_RIGHT; token = NextTok() )
            {
                switch( token )
                {
                case T_LEFT:
                    continue;
 
                case T_prefix:
                    NeedSYMBOLorNUMBER();
                    dim->SetPrefix( FromUTF8() );
                    NeedRIGHT();
                    break;
 
                case T_suffix:
                    NeedSYMBOLorNUMBER();
                    dim->SetSuffix( FromUTF8() );
                    NeedRIGHT();
                    break;
 
                case T_units:
                {
                    int mode = parseInt( "dimension units mode" );
                    mode = std::max( 0, std::min( 4, mode ) );
                    dim->SetUnitsMode( static_cast<DIM_UNITS_MODE>( mode ) );
                    NeedRIGHT();
                    break;
                }
 
                case T_units_format:
                {
                    int format = parseInt( "dimension units format" );
                    format = std::clamp( format, 0, 3 );
                    dim->SetUnitsFormat( static_cast<DIM_UNITS_FORMAT>( format ) );
                    NeedRIGHT();
                    break;
                }
 
                case T_precision:
                    dim->SetPrecision( static_cast<DIM_PRECISION>( parseInt( "dimension precision" ) ) );
                    NeedRIGHT();
                    break;
 
                case T_override_value:
                    NeedSYMBOLorNUMBER();
                    dim->SetOverrideTextEnabled( true );
                    dim->SetOverrideText( FromUTF8() );
                    NeedRIGHT();
                    break;
 
                case T_suppress_zeroes:
                    dim->SetSuppressZeroes( parseMaybeAbsentBool( true ) );
                    break;
 
                default:
                    std::cerr << "Unknown format token: " << GetTokenString( token ) << std::endl;
                    Expecting( "prefix, suffix, units, units_format, precision, override_value, suppress_zeroes" );
                }
            }
            break;
        }
 
        case T_style:
        {
            isStyleKnown = true;
 
            // new format: default to keep text aligned off unless token is present
            dim->SetKeepTextAligned( false );
 
            for( token = NextTok(); token != T_RIGHT; token = NextTok() )
            {
                switch( token )
                {
                case T_LEFT:
                    continue;
 
                case T_thickness:
                    dim->SetLineThickness( parseBoardUnits( "extension line thickness value" ) );
                    NeedRIGHT();
                    break;
 
                case T_arrow_direction:
                    token = NextTok();
 
                    if( token == T_inward )
                        dim->ChangeArrowDirection( DIM_ARROW_DIRECTION::INWARD );
                    else if( token == T_outward )
                        dim->ChangeArrowDirection( DIM_ARROW_DIRECTION::OUTWARD );
                    else
                        Expecting( "inward or outward" );
 
                    NeedRIGHT();
                    break;
 
                case T_arrow_length:
 
                    dim->SetArrowLength( parseBoardUnits( "arrow length value" ) );
                    NeedRIGHT();
                    break;
 
                case T_text_position_mode:
                {
                    int mode = parseInt( "text position mode" );
                    mode = std::max( 0, std::min( 3, mode ) );
                    dim->SetTextPositionMode( static_cast<DIM_TEXT_POSITION>( mode ) );
                    NeedRIGHT();
                    break;
                }
 
                case T_extension_height:
                {
                    PCB_DIM_ALIGNED* aligned = dynamic_cast<PCB_DIM_ALIGNED*>( dim.get() );
                    wxCHECK_MSG( aligned, nullptr, wxT( "Invalid extension_height token" ) );
                    aligned->SetExtensionHeight( parseBoardUnits( "extension height value" ) );
                    NeedRIGHT();
                    break;
                }
 
                case T_extension_offset:
                    dim->SetExtensionOffset( parseBoardUnits( "extension offset value" ) );
                    NeedRIGHT();
                    break;
 
                case T_keep_text_aligned:
                    dim->SetKeepTextAligned( parseMaybeAbsentBool( true ) );
                    break;
 
                case T_text_frame:
                {
                    wxCHECK_MSG( dim->Type() == PCB_DIM_LEADER_T, nullptr, wxT( "Invalid text_frame token" ) );
 
                    PCB_DIM_LEADER* leader = static_cast<PCB_DIM_LEADER*>( dim.get() );
 
                    int textFrame = parseInt( "text frame mode" );
                    textFrame = std::clamp( textFrame, 0, 3 );
                    leader->SetTextBorder( static_cast<DIM_TEXT_BORDER>( textFrame ));
                    NeedRIGHT();
                    break;
                }
 
                default:
                    Expecting( "thickness, arrow_length, arrow_direction, text_position_mode, "
                               "extension_height, extension_offset" );
                }
            }
 
            break;
        }
 
        // Old format: feature1 stores a feature line.  We only care about the origin.
        case T_feature1:
        {
            NeedLEFT();
            token = NextTok();
 
            if( token != T_pts )
                Expecting( T_pts );
 
            VECTOR2I point;
 
            parseXY( &point.x, &point.y );
            dim->SetStart( point );
 
            parseXY( nullptr, nullptr ); // Ignore second point
            NeedRIGHT();
            NeedRIGHT();
            break;
        }
 
        // Old format: feature2 stores a feature line.  We only care about the end point.
        case T_feature2:
        {
            NeedLEFT();
            token = NextTok();
 
            if( token != T_pts )
                Expecting( T_pts );
 
            VECTOR2I point;
 
            parseXY( &point.x, &point.y );
            dim->SetEnd( point );
 
            parseXY( nullptr, nullptr ); // Ignore second point
 
            NeedRIGHT();
            NeedRIGHT();
            break;
        }
 
        case T_crossbar:
        {
            NeedLEFT();
            token = NextTok();
 
            if( token == T_pts )
            {
                // If we have a crossbar, we know we're an old aligned dim
                PCB_DIM_ALIGNED* aligned = static_cast<PCB_DIM_ALIGNED*>( dim.get() );
 
                // Old style: calculate height from crossbar
                VECTOR2I point1, point2;
                parseXY( &point1.x, &point1.y );
                parseXY( &point2.x, &point2.y );
                aligned->UpdateHeight( point2, point1 ); // Yes, backwards intentionally
                NeedRIGHT();
            }
 
            NeedRIGHT();
            break;
        }
 
        // Arrow: no longer saved; no-op
        case T_arrow1a:
            NeedLEFT();
            token = NextTok();
 
            if( token != T_pts )
                Expecting( T_pts );
 
            parseXY( nullptr, nullptr );
            parseXY( nullptr, nullptr );
            NeedRIGHT();
            NeedRIGHT();
            break;
 
        // Arrow: no longer saved; no-op
        case T_arrow1b:
            NeedLEFT();
            token = NextTok();
 
            if( token != T_pts )
                Expecting( T_pts );
 
            parseXY( nullptr, nullptr );
            parseXY( nullptr, nullptr );
            NeedRIGHT();
            NeedRIGHT();
            break;
 
        // Arrow: no longer saved; no-op
        case T_arrow2a:
            NeedLEFT();
            token = NextTok();
 
            if( token != T_pts )
                Expecting( T_pts );
 
            parseXY( nullptr, nullptr );
            parseXY( nullptr, nullptr );
            NeedRIGHT();
            NeedRIGHT();
            break;
 
        // Arrow: no longer saved; no-op
        case T_arrow2b:
            NeedLEFT();
            token = NextTok();
 
            if( token != T_pts )
                Expecting( T_pts );
 
            parseXY( nullptr, nullptr );
            parseXY( nullptr, nullptr );
            NeedRIGHT();
            NeedRIGHT();
            break;
 
        // Handle (locked yes) from modern times
        case T_locked:
        {
            // Unsure if we ever wrote out (locked) for dimensions, so use maybeAbsent just in case
            bool isLocked = parseMaybeAbsentBool( true );
            dim->SetLocked( isLocked );
            break;
        }
 
        case T_custom_property:
            parseCustomProperty( dim.get() );
            break;
 
        default:
            Expecting( "layer, tstamp, uuid, gr_text, feature1, feature2, crossbar, arrow1a, "
                       "arrow1b, arrow2a, arrow2b, locked, or custom_property" );
        }
    }
 
    if( locked )
        dim->SetLocked( true );
 
    dim->Update();
 
    return dim.release();
}
 
 
FOOTPRINT* PCB_IO_KICAD_SEXPR_PARSER::parseFOOTPRINT( wxArrayString* aInitialComments )
{
    try
    {
        return parseFOOTPRINT_unchecked( aInitialComments );
    }
    catch( const PARSE_ERROR& parse_error )
    {
        if( m_tooRecent )
            throw FUTURE_FORMAT_ERROR( parse_error, GetRequiredVersion() );
        else
            throw;
    }
}
 
 
FOOTPRINT* PCB_IO_KICAD_SEXPR_PARSER::parseFOOTPRINT_unchecked( wxArrayString* aInitialComments )
{
    wxCHECK_MSG( CurTok() == T_module || CurTok() == T_footprint, nullptr,
                 wxT( "Cannot parse " ) + GetTokenString( CurTok() ) + wxT( " as FOOTPRINT." ) );
 
    wxString name;
    VECTOR2I pt;
    T        token;
    LIB_ID   fpid;
    int      attributes = 0;
    double   parsedScaleX = 1.0;
    double   parsedScaleY = 1.0;
 
    std::unique_ptr<FOOTPRINT> footprint = std::make_unique<FOOTPRINT>( m_board );
 
    footprint->SetInitialComments( aInitialComments );
 
    if( m_board )
        footprint->SetStaticComponentClass( m_board->GetComponentClassManager().GetNoneComponentClass() );
 
    token = NextTok();
 
    if( !IsSymbol( token ) && token != T_NUMBER )
        Expecting( "symbol|number" );
 
    name = FromUTF8();
 
    if( !name.IsEmpty() && fpid.Parse( name, true ) >= 0 )
    {
        THROW_IO_ERRORF( _( "Invalid footprint ID in\nfile: %s\nline: %d\noffset: %d." ),
                         CurSource(), CurLineNumber(), CurOffset() );
    }
 
    auto checkVersion =
            [&]()
            {
                if( m_requiredVersion > SEXPR_BOARD_FILE_VERSION )
                    throw FUTURE_FORMAT_ERROR( fmt::format( "{}", m_requiredVersion ), m_generatorVersion );
            };
 
    for( token = NextTok(); token != T_RIGHT; token = NextTok() )
    {
        if( token == T_LEFT )
            token = NextTok();
 
        switch( token )
        {
        case T_version:
        {
            // Theoretically a footprint nested in a PCB could declare its own version, though
            // as of writing this comment we don't do that. Just in case, take the greater
            // version.
            int this_version = parseInt( FromUTF8().mb_str( wxConvUTF8 ) );
            NeedRIGHT();
            m_requiredVersion = std::max( m_requiredVersion, this_version );
            m_tooRecent       = ( m_requiredVersion > SEXPR_BOARD_FILE_VERSION );
            SetKnowsBar( m_requiredVersion >= 20240706 ); // Bar token is known from this version
            footprint->SetFileFormatVersionAtLoad( this_version );
            break;
        }
 
        case T_generator:
            // We currently ignore the generator when parsing. It is included in the file for manual
            // indication of where the footprint came from.
            NeedSYMBOL();
            NeedRIGHT();
            break;
 
        case T_generator_version:
            NeedSYMBOL();
            m_generatorVersion = FromUTF8();
            NeedRIGHT();
 
            // If the format includes a generator version, by this point we have enough info to
            // do the version check here
            checkVersion();
 
            break;
 
        case T_locked:
            footprint->SetLocked( parseMaybeAbsentBool( true ) );
            break;
 
        case T_placed:
            footprint->SetIsPlaced( parseMaybeAbsentBool( true ) );
            break;
 
        case T_layer:
        {
            // Footprints can be only on the front side or the back side.
            // but because we can find some stupid layer in file, ensure a
            // acceptable layer is set for the footprint
            PCB_LAYER_ID layer = parseBoardItemLayer();
            footprint->SetLayer( layer == B_Cu ? B_Cu : F_Cu );
            NeedRIGHT();
            break;
        }
 
        case T_stackup:
            parseFootprintStackup( *footprint );
            break;
 
        case T_tedit:
            parseHex();
            NeedRIGHT();
            break;
 
        case T_tstamp:
        case T_uuid:
            NextTok();
            footprint->SetUuidDirect( CurStrToKIID() );
            NeedRIGHT();
            break;
 
        case T_at:
            pt.x = parseBoardUnits( "X coordinate" );
            pt.y = parseBoardUnits( "Y coordinate" );
            footprint->SetPosition( pt );
            token = NextTok();
 
            if( token == T_NUMBER )
            {
                footprint->SetOrientation( EDA_ANGLE( parseDouble(), DEGREES_T ) );
                NeedRIGHT();
            }
            else if( token != T_RIGHT )
            {
                Expecting( T_RIGHT );
            }
 
            break;
 
        case T_transform:
        {
            VECTOR2I  trsTranslate( 0, 0 );
            EDA_ANGLE trsRotate = ANGLE_0;
 
            for( token = NextTok(); token != T_RIGHT; token = NextTok() )
            {
                if( token != T_LEFT )
                    Expecting( T_LEFT );
 
                token = NextTok();
 
                switch( token )
                {
                case T_translate:
                    trsTranslate.x = parseBoardUnits( "translate X" );
                    trsTranslate.y = parseBoardUnits( "translate Y" );
                    NeedRIGHT();
                    break;
 
                case T_rotate:
                    trsRotate = EDA_ANGLE( parseDouble( "rotate angle" ), DEGREES_T );
                    NeedRIGHT();
                    break;
 
                case T_scale:
                    parsedScaleX = parseDouble( "scale X" );
                    parsedScaleY = parseDouble( "scale Y" );
 
                    // Guard against corrupt files: a zero, negative, or non-finite
                    // scale would make the footprint transform degenerate.
                    if( !std::isfinite( parsedScaleX ) || parsedScaleX <= 0.0 )
                        parsedScaleX = 1.0;
 
                    if( !std::isfinite( parsedScaleY ) || parsedScaleY <= 0.0 )
                        parsedScaleY = 1.0;
 
                    NeedRIGHT();
                    break;
 
                default:
                    Expecting( "translate, rotate, or scale" );
                }
            }
 
            footprint->SetPosition( trsTranslate );
            footprint->SetOrientation( trsRotate );
            footprint->SetTransformScale( parsedScaleX, parsedScaleY );
            break;
        }
 
        case T_descr:
            NeedSYMBOLorNUMBER(); // some symbols can be 0508, so a number is also a symbol here
            footprint->SetLibDescription( FromUTF8() );
            NeedRIGHT();
            break;
 
        case T_tags:
            NeedSYMBOLorNUMBER(); // some symbols can be 0508, so a number is also a symbol here
            footprint->SetKeywords( FromUTF8() );
            NeedRIGHT();
            break;
 
        case T_height:
            footprint->SetHeight( parseBoardUnits( "footprint height" ) );
            NeedRIGHT();
            break;
 
        case T_property:
        {
            NeedSYMBOL();
            wxString pName = FromUTF8();
            NeedSYMBOL();
            wxString pValue = FromUTF8();
 
            // Prior to PCB fields, we used to use properties for special values instead of
            // using (keyword_example "value")
            if( m_requiredVersion < 20230620 )
            {
                // Skip legacy non-field properties sent from symbols that should not be kept
                // in footprints.
                if( pName == "ki_keywords" || pName == "ki_locked" )
                {
                    NeedRIGHT();
                    break;
                }
 
                // Description from symbol (not the fooprint library description stored in (descr) )
                // used to be stored as a reserved key value
                if( pName == "ki_description" )
                {
                    footprint->GetField( FIELD_T::DESCRIPTION )->SetText( pValue );
                    NeedRIGHT();
                    break;
                }
 
                // Sheet file and name used to be stored as properties invisible to the user
                if( pName == "Sheetfile" || pName == "Sheet file" )
                {
                    footprint->SetSheetfile( pValue );
                    NeedRIGHT();
                    break;
                }
 
                if( pName == "Sheetname" || pName == "Sheet name" )
                {
                    footprint->SetSheetname( pValue );
                    NeedRIGHT();
                    break;
                }
            }
 
            PCB_FIELD* field = nullptr;
            std::unique_ptr<PCB_FIELD> unusedField;
 
            // 8.0.0rc3 had a bug where these properties were mistakenly added to the footprint as
            // fields, this will remove them as fields but still correctly set the footprint filters
            if( pName == "ki_fp_filters" )
            {
                footprint->SetFilters( pValue );
 
                // Use the text effect parsing function because it will handle ki_fp_filters as a
                // property with no text effects, but will also handle parsing the text effects.
                // We just drop the effects if they're present.
                unusedField = std::make_unique<PCB_FIELD>( footprint.get(), FIELD_T::USER );
                field = unusedField.get();
            }
            else if( pName == "Footprint" )
            {
                // Until V9, footprints had a Footprint field that usually (but not always)
                // duplicated the footprint's LIB_ID.  In V9 this was removed.  Parse it
                // like any other, but don't add it to anything.
                unusedField = std::make_unique<PCB_FIELD>( footprint.get(), FIELD_T::FOOTPRINT );
                field = unusedField.get();
            }
            else if( footprint->HasField( pName ) )
            {
                field = footprint->GetField( pName );
                field->SetText( pValue );
            }
            else
            {
                field = new PCB_FIELD( footprint.get(), FIELD_T::USER, pName );
                footprint->Add( field );
 
                field->SetText( pValue );
                field->SetLayer( footprint->GetLayer() == F_Cu ? F_Fab : B_Fab );
 
                if( m_board )   // can be null when reading a lib
                    field->StyleFromSettings( m_board->GetDesignSettings(), true );
            }
 
            // Hide the field by default if it is a legacy field that did not have
            // text effects applied, since hide is a negative effect
            if( m_requiredVersion < 20230620 )
                field->SetVisible( false );
            else
                field->SetVisible( true );
 
            parsePCB_TEXT_effects( field );
        }
            break;
 
        case T_path:
            NeedSYMBOLorNUMBER(); // Paths can be numerical so a number is also a symbol here
            footprint->SetPath( KIID_PATH( FromUTF8() ) );
            NeedRIGHT();
            break;
 
        case T_sheetname:
            NeedSYMBOL();
            footprint->SetSheetname( FromUTF8() );
            NeedRIGHT();
            break;
 
        case T_sheetfile:
            NeedSYMBOL();
            footprint->SetSheetfile( FromUTF8() );
            NeedRIGHT();
            break;
 
        case T_units:
        {
            std::vector<FOOTPRINT::FP_UNIT_INFO> unitInfos;
 
            // (units (unit (name "A") (pins "1" "2" ...)) ...)
            for( token = NextTok(); token != T_RIGHT; token = NextTok() )
            {
                if( token == T_LEFT )
                    token = NextTok();
 
                if( token == T_unit )
                {
                    FOOTPRINT::FP_UNIT_INFO info;
 
                    for( token = NextTok(); token != T_RIGHT; token = NextTok() )
                    {
                        if( token == T_LEFT )
                            token = NextTok();
 
                        if( token == T_name )
                        {
                            NeedSYMBOLorNUMBER();
                            info.m_unitName = FromUTF8();
                            NeedRIGHT();
                        }
                        else if( token == T_pins )
                        {
                            // Parse a flat list of quoted numbers or symbols until ')'
                            for( token = NextTok(); token != T_RIGHT; token = NextTok() )
                            {
                                if( token == T_STRING || token == T_NUMBER )
                                {
                                    info.m_pins.emplace_back( FromUTF8() );
                                }
                                else
                                {
                                    Expecting( "pin number" );
                                }
                            }
                        }
                        else
                        {
                            // Unknown sub-token inside unit; skip its list if any
                            skipCurrent();
                        }
                    }
 
                    unitInfos.push_back( info );
                }
                else
                {
                    // Unknown entry under units; skip
                    skipCurrent();
                }
            }
 
            if( !unitInfos.empty() )
                footprint->SetUnitInfo( unitInfos );
 
            break;
        }
 
        case T_autoplace_cost90:
        case T_autoplace_cost180:
            parseInt( "legacy auto-place cost" );
            NeedRIGHT();
            break;
 
        case T_private_layers:
        {
            LSET privateLayers;
 
            for( token = NextTok(); token != T_RIGHT; token = NextTok() )
            {
                auto it = m_layerIndices.find( CurStr() );
 
                if( it != m_layerIndices.end() )
                    privateLayers.set( it->second );
                else
                    Expecting( "layer name" );
            }
 
            if( m_requiredVersion < 20220427 )
            {
                privateLayers.set( Edge_Cuts, false );
                privateLayers.set( Margin, false );
            }
 
            footprint->SetPrivateLayers( privateLayers );
            break;
        }
 
        case T_net_tie_pad_groups:
            for( token = NextTok(); token != T_RIGHT; token = NextTok() )
                footprint->AddNetTiePadGroup( CurStr() );
 
            break;
 
        case T_duplicate_pad_numbers_are_jumpers:
            footprint->SetDuplicatePadNumbersAreJumpers( parseBool() );
            NeedRIGHT();
            break;
 
        case T_jumper_pad_groups:
        {
            JUMPER_GROUP_SET&  groups = footprint->JumperPadGroups();
            std::set<wxString> names;
            bool               inGroup = false;
 
            for( token = NextTok(); inGroup || token != T_RIGHT; token = NextTok() )
            {
                switch( static_cast<int>( token ) )
                {
                case T_LEFT:
                    if( inGroup )
                        Expecting( "list of pad names" );
 
                    inGroup = true;
                    break;
 
                case DSN_STRING:
                    if( !inGroup )
                        Expecting( "list of pad names" );
 
                    names.insert( FromUTF8() );
                    break;
 
                case T_RIGHT:
                    if( std::optional<JUMPER_GROUP> group = JUMPER_GROUP::Make( std::move( names ) ) )
                        groups.Add( std::move( *group ) );
 
                    names.clear();
                    inGroup = false;
                    break;
 
                default:
                    Expecting( "list of pad names" );
                }
            }
 
            break;
        }
 
        case T_solder_mask_margin:
            footprint->SetLocalSolderMaskMargin( parseBoardUnits( "local solder mask margin value" ) );
            NeedRIGHT();
 
            // In pre-9.0 files "0" meant inherit.
            if( m_requiredVersion <= 20240201 && footprint->GetLocalSolderMaskMargin() == 0 )
                footprint->SetLocalSolderMaskMargin( {} );
 
            break;
 
        case T_solder_paste_margin:
            footprint->SetLocalSolderPasteMargin( parseBoardUnits( "local solder paste margin value" ) );
            NeedRIGHT();
 
            // In pre-9.0 files "0" meant inherit.
            if( m_requiredVersion <= 20240201 && footprint->GetLocalSolderPasteMargin() == 0 )
                footprint->SetLocalSolderPasteMargin( {} );
 
            break;
 
        case T_solder_paste_ratio:          // legacy token
        case T_solder_paste_margin_ratio:
            footprint->SetLocalSolderPasteMarginRatio( parseDouble( "local solder paste margin ratio value" ) );
            NeedRIGHT();
 
            // In pre-9.0 files "0" meant inherit.
            if( m_requiredVersion <= 20240201 && footprint->GetLocalSolderPasteMarginRatio() == 0 )
                footprint->SetLocalSolderPasteMarginRatio( {} );
 
            break;
 
        case T_clearance:
            footprint->SetLocalClearance( parseBoardUnits( "local clearance value" ) );
            NeedRIGHT();
 
            // In pre-9.0 files "0" meant inherit.
            if( m_requiredVersion <= 20240201 && footprint->GetLocalClearance() == 0 )
                footprint->SetLocalClearance( {} );
 
            break;
 
        case T_zone_connect:
            footprint->SetLocalZoneConnection((ZONE_CONNECTION) parseInt( "zone connection value" ) );
            NeedRIGHT();
            break;
 
        case T_thermal_width:
        case T_thermal_gap:
            // Interestingly, these have never been exposed in the GUI
            parseBoardUnits( token );
            NeedRIGHT();
            break;
 
        case T_attr:
            for( token = NextTok(); token != T_RIGHT; token = NextTok() )
            {
                switch( token )
                {
                case T_virtual:     // legacy token prior to version 20200826
                    attributes |= FP_EXCLUDE_FROM_POS_FILES | FP_EXCLUDE_FROM_BOM;
                    break;
 
                case T_through_hole:
                    attributes |= FP_THROUGH_HOLE;
                    break;
 
                case T_smd:
                    attributes |= FP_SMD;
                    break;
 
                case T_board_only:
                    attributes |= FP_BOARD_ONLY;
                    break;
 
                case T_exclude_from_pos_files:
                    attributes |= FP_EXCLUDE_FROM_POS_FILES;
                    break;
 
                case T_exclude_from_bom:
                    attributes |= FP_EXCLUDE_FROM_BOM;
                    break;
 
                case T_exclude_from_sim:
                    attributes |= FP_EXCLUDE_FROM_SIM;
                    break;
 
                case T_allow_missing_courtyard:
                    footprint->SetAllowMissingCourtyard( true );
                    break;
 
                case T_dnp:
                    attributes |= FP_DNP;
                    break;
 
                case T_allow_soldermask_bridges:
                    footprint->SetAllowSolderMaskBridges( true );
                    break;
 
                default:
                    Expecting( "through_hole, smd, virtual, board_only, exclude_from_pos_files, "
                               "exclude_from_bom, exclude_from_sim or allow_solder_mask_bridges" );
                }
            }
            footprint->SetAttributes( attributes );
            break;
 
        case T_fp_text:
        {
            PCB_TEXT* text = parsePCB_TEXT( footprint.get() );
 
            if( PCB_FIELD* field = dynamic_cast<PCB_FIELD*>( text ) )
            {
                switch( field->GetId() )
                {
                case FIELD_T::REFERENCE:
                    footprint->Reference() = PCB_FIELD( *text, FIELD_T::REFERENCE );
                    footprint->Reference().SetUuidDirect( text->m_Uuid );
                    delete text;
                    break;
 
                case FIELD_T::VALUE:
                    footprint->Value() = PCB_FIELD( *text, FIELD_T::VALUE );
                    footprint->Value().SetUuidDirect( text->m_Uuid );
                    delete text;
                    break;
 
                default:
                    // Fields other than reference and value aren't treated specially,
                    // and can be created if the fp_text was hidden on the board,
                    // so just add those to the footprint as normal.
                    footprint->Add(text, ADD_MODE::APPEND, true );
                    break;
                }
            }
            else
            {
                footprint->Add( text, ADD_MODE::APPEND, true );
            }
 
            break;
        }
 
        case T_fp_text_box:
        {
            PCB_TEXTBOX* textbox = parsePCB_TEXTBOX( footprint.get() );
            footprint->Add( textbox, ADD_MODE::APPEND, true );
            break;
        }
 
        case T_table:
        {
            PCB_TABLE* table = parsePCB_TABLE( footprint.get() );
            footprint->Add( table, ADD_MODE::APPEND, true );
            break;
        }
 
        case T_fp_arc:
        case T_fp_circle:
        case T_fp_curve:
        case T_fp_rect:
        case T_fp_line:
        case T_fp_poly:
        case T_fp_ellipse:
        case T_fp_ellipse_arc:
        {
            PCB_SHAPE* shape = parsePCB_SHAPE( footprint.get() );
            footprint->Add( shape, ADD_MODE::APPEND, true );
            break;
        }
 
        case T_image:
        {
            PCB_REFERENCE_IMAGE* image = parsePCB_REFERENCE_IMAGE( footprint.get() );
            footprint->Add( image, ADD_MODE::APPEND, true );
            break;
        }
 
        case T_barcode:
        {
            PCB_BARCODE* barcode = parsePCB_BARCODE( footprint.get() );
            footprint->Add( barcode, ADD_MODE::APPEND, true );
            break;
        }
 
        case T_dimension:
        {
            PCB_DIMENSION_BASE* dimension = parseDIMENSION( footprint.get() );
            footprint->Add( dimension, ADD_MODE::APPEND, true );
            break;
        }
 
        case T_pad:
        {
            PAD* pad = parsePAD( footprint.get() );
            footprint->Add( pad, ADD_MODE::APPEND, true );
            break;
        }
 
        case T_model:
            token = NextTok();
 
            if( token == T_LEFT )
            {
                // Typed model (model (type extruded) ...)
                token = NextTok();
 
                if( token != T_type )
                    Expecting( T_type );
 
                NeedSYMBOL();
 
                if( CurTok() == T_extruded )
                {
                    NeedRIGHT(); // close (type extruded)
 
                    PCB_3D_BODY* bodyItem = footprint->GetBody();
 
                    if( !bodyItem )
                        bodyItem = &footprint->EnsureBody();
 
                    EXTRUDED_3D_BODY& body = *bodyItem->MutableExtruded();
 
                    for( token = NextTok(); token != T_RIGHT; token = NextTok() )
                    {
                        if( token != T_LEFT )
                            Expecting( T_LEFT );
 
                        token = NextTok();
 
                        switch( token )
                        {
                        case T_hide:
                        {
                            bool hide = parseMaybeAbsentBool( true );
                            body.m_show = !hide;
                            break;
                        }
 
                        case T_uuid:
                            NextTok();
                            bodyItem->SetUuidDirect( CurStrToKIID() );
                            NeedRIGHT();
                            break;
 
                        case T_overall_height:
                            body.m_height = parseBoardUnits( "overall height" );
                            NeedRIGHT();
                            break;
 
                        case T_body_pcb_gap:
                            body.m_standoff = parseBoardUnits( "body pcb gap" );
                            NeedRIGHT();
                            break;
 
                        case T_layer:
                        {
                            NeedSYMBOL();
                            wxString layerName = From_UTF8( CurText() );
 
                            if( layerName == wxT( "auto" ) )
                            {
                                body.m_layer = UNDEFINED_LAYER;
                            }
                            else if( layerName == wxT( "pad_bbox" ) )
                            {
                                body.m_layer = UNSELECTED_LAYER;
                            }
                            else
                            {
                                int layer = LSET::NameToLayer( layerName );
 
                                if( layer >= 0 )
                                    body.m_layer = static_cast<PCB_LAYER_ID>( layer );
                            }
 
                            NeedRIGHT();
                            break;
                        }
 
                        case T_material:
                        {
                            NeedSYMBOL();
                            wxString matName = From_UTF8( CurText() );
 
                            if( matName == wxT( "matte" ) )
                                body.m_material = EXTRUSION_MATERIAL::MATTE;
                            else if( matName == wxT( "metal" ) )
                                body.m_material = EXTRUSION_MATERIAL::METAL;
                            else if( matName == wxT( "copper" ) )
                                body.m_material = EXTRUSION_MATERIAL::COPPER;
                            else
                                body.m_material = EXTRUSION_MATERIAL::PLASTIC;
 
                            NeedRIGHT();
                            break;
                        }
 
                        case T_color:
                        {
                            NeedSYMBOLorNUMBER();
                            wxString first = From_UTF8( CurText() );
 
                            if( first == wxT( "unspecified" ) )
                            {
                                body.m_color = KIGFX::COLOR4D::UNSPECIFIED;
                            }
                            else
                            {
                                body.m_color.r = parseDouble();
                                body.m_color.g = parseDouble( "green" );
                                body.m_color.b = parseDouble( "blue" );
                                body.m_color.a = parseDouble( "alpha" );
                            }
 
                            NeedRIGHT();
                            break;
                        }
 
                        case T_offset:
                            NeedLEFT();
                            token = NextTok();
 
                            if( token != T_xyz )
                                Expecting( T_xyz );
 
                            body.m_offset.x = parseDouble( "x value" );
                            body.m_offset.y = parseDouble( "y value" );
                            body.m_offset.z = parseDouble( "z value" );
                            NeedRIGHT();
                            NeedRIGHT();
                            break;
 
                        case T_scale:
                            NeedLEFT();
                            token = NextTok();
 
                            if( token != T_xyz )
                                Expecting( T_xyz );
 
                            body.m_scale.x = parseDouble( "x value" );
                            body.m_scale.y = parseDouble( "y value" );
                            body.m_scale.z = parseDouble( "z value" );
                            NeedRIGHT();
                            NeedRIGHT();
                            break;
 
                        case T_rotate:
                            NeedLEFT();
                            token = NextTok();
 
                            if( token != T_xyz )
                                Expecting( T_xyz );
 
                            body.m_rotation.x = parseDouble( "x value" );
                            body.m_rotation.y = parseDouble( "y value" );
                            body.m_rotation.z = parseDouble( "z value" );
                            NeedRIGHT();
                            NeedRIGHT();
                            break;
 
                        default:
                            Expecting( "hide, uuid, overall_height, body_pcb_gap, layer, material, "
                                       "color, offset, scale, or rotate" );
                        }
                    }
                }
                else
                {
                    Expecting( "extruded" );
                }
            }
            else
            {
                // Reference model (model "filename" ...)
                FP_3DMODEL* model = parse3DModel( true );
                footprint->Add3DModel( model );
                delete model;
            }
 
            break;
 
        case T_zone:
        {
            ZONE* zone = parseZONE( footprint.get() );
 
            if( zone->GetNumCorners() == 0 )
            {
                delete zone;
                break;
            }
 
            // Legacy footprint zone outlines were in board frame. Convert to lib.
            if( m_requiredVersion < FIRST_FP_AFFINE_TRANSFORM && zone->Outline() )
            {
                const TRANSFORM_TRS& xform = footprint->GetTransform();
                SHAPE_POLY_SET&      poly = *zone->Outline();
 
                for( auto it = poly.IterateWithHoles(); it; it++ )
                    poly.SetVertex( it.GetIndex(), xform.InverseApply( *it ) );
 
                // Hatch lines were cached in board frame; rebuild in lib frame so the
                // footprint transform is not applied to them twice on render.
                zone->HatchBorder();
            }
 
            footprint->Add( zone, ADD_MODE::APPEND, true );
            break;
        }
 
        case T_group:
            parseGROUP( footprint.get() );
            break;
 
        case T_constraint:
            parseCONSTRAINT( footprint.get() );
            break;
 
        case T_point:
        {
            PCB_POINT*     point = parsePCB_POINT();
            const VECTOR2I filePos = point->GetPosition();
 
            footprint->Add( point, ADD_MODE::APPEND, true );
 
            // Legacy files stored footprint points in board frame
            if( m_requiredVersion < FIRST_FP_AFFINE_TRANSFORM )
                point->SetPosition( filePos );
 
            break;
        }
 
        case T_embedded_fonts:
        {
            footprint->GetEmbeddedFiles()->SetAreFontsEmbedded( parseBool() );
            NeedRIGHT();
            break;
        }
 
        case T_embedded_files:
        {
            EMBEDDED_FILES_PARSER embeddedFilesParser( reader );
            embeddedFilesParser.SyncLineReaderWith( *this );
 
            try
            {
                embeddedFilesParser.ParseEmbedded( footprint->GetEmbeddedFiles() );
            }
            catch( const PARSE_ERROR& e )
            {
                m_parseWarnings.push_back( e.What() );
 
                int depth = 0;
 
                for( int tok = embeddedFilesParser.NextTok(); tok != DSN_EOF; tok = embeddedFilesParser.NextTok() )
                {
                    if( tok == DSN_LEFT )
                        depth++;
                    else if( tok == DSN_RIGHT && --depth < 0 )
                        break;
                }
            }
 
            SyncLineReaderWith( embeddedFilesParser );
            break;
        }
 
        case T_component_classes:
        {
            std::unordered_set<wxString> componentClassNames;
 
            while( ( token = NextTok() ) != T_RIGHT )
            {
                if( token != T_LEFT )
                    Expecting( T_LEFT );
 
                if( ( token = NextTok() ) != T_class )
                    Expecting( T_class );
 
                NeedSYMBOLorNUMBER();
                componentClassNames.insert( From_UTF8( CurText() ) );
                NeedRIGHT();
            }
 
            footprint->SetTransientComponentClassNames( componentClassNames );
 
            if( m_board )
                footprint->ResolveComponentClassNames( m_board, componentClassNames );
 
            break;
        }
 
        case T_variant:
            parseFootprintVariant( footprint.get() );
            break;
 
        case T_custom_property:
            parseCustomProperty( footprint.get() );
            break;
 
        default:
            Expecting( "at, descr, locked, placed, tedit, tstamp, uuid, variant, autoplace_cost90, "
                       "autoplace_cost180, attr, clearance, embedded_files, fp_arc, fp_circle, fp_curve, "
                       "fp_line, fp_poly, fp_rect, fp_text, pad, group, generator, model, path, "
                       "solder_mask_margin, solder_paste_margin, solder_paste_margin_ratio, tags, "
                       "thermal_gap, version, zone, zone_connect, component_classes, or custom_property" );
        }
    }
 
    footprint->FixUpPadsForBoard( m_board );
 
    // In legacy files the lack of attributes indicated a through-hole component which was by
    // default excluded from pos files.  However there was a hack to look for SMD pads and
    // consider those "mislabeled through-hole components" and therefore include them in place
    // files.  We probably don't want to get into that game so we'll just include them by
    // default and let the user change it if required.
    if( m_requiredVersion < 20200826 && attributes == 0 )
        attributes |= FP_THROUGH_HOLE;
 
    if( m_requiredVersion <= LEGACY_NET_TIES )
    {
        if( footprint->GetKeywords().StartsWith( wxT( "net tie" ) ) )
        {
            wxString padGroup;
 
            for( PAD* pad : footprint->Pads() )
            {
                if( !padGroup.IsEmpty() )
                    padGroup += wxS( ", " );
 
                padGroup += pad->GetNumber();
            }
 
            if( !padGroup.IsEmpty() )
                footprint->AddNetTiePadGroup( padGroup );
        }
    }
 
    footprint->SetAttributes( attributes );
 
    footprint->SetFPID( fpid );
 
    return footprint.release();
}
 
 
void PCB_IO_KICAD_SEXPR_PARSER::parseFootprintStackup( FOOTPRINT& aFootprint )
{
    wxCHECK_RET( CurTok() == T_stackup, "Expected stackup token" );
 
    // If we have a stackup list at all, we must be in custom layer mode
    FOOTPRINT_STACKUP stackupMode = FOOTPRINT_STACKUP::CUSTOM_LAYERS;
    LSET              layers = LSET{};
 
    for( T token = NextTok(); token != T_RIGHT; token = NextTok() )
    {
        if( CurTok() != T_LEFT )
            Expecting( T_LEFT );
 
        token = NextTok();
 
        switch( token )
        {
        case T_layer:
        {
            NeedSYMBOLorNUMBER();
 
            const auto it = m_layerIndices.find( CurStr() );
 
            if( it == m_layerIndices.end() )
                Expecting( "layer name" );
            else
                layers.set( it->second );
 
            NeedRIGHT();
            break;
        }
        default:
            Expecting( "layer" );
        }
    }
 
    // Check that the copper layers are sensible and contiguous
    const LSET gotCuLayers = layers & LSET::AllCuMask();
 
    // Remove this check when we support odd copper layer stackups
    if( gotCuLayers.count() % 2 != 0 )
    {
        THROW_IO_ERRORF( _( "Invalid stackup in footprint: odd number of copper layers (%d)." ),
                         gotCuLayers.count() );
    }
 
    const LSET expectedCuLayers = LSET::AllCuMask( gotCuLayers.count() );
    if( gotCuLayers != expectedCuLayers )
    {
        THROW_IO_ERROR( _( "Invalid stackup in footprint: copper layers are not contiguous." ) );
    }
 
    if( ( layers & LSET::AllTechMask() ).count() > 0 )
    {
        THROW_IO_ERROR( _( "Invalid stackup in footprint: technology layers are implicit in footprints and "
                           "should not be specified in the stackup." ) );
    }
 
    // Set the mode first, so that the layer count is unlocked if needed
    aFootprint.SetStackupMode( stackupMode );
    aFootprint.SetStackupLayers( std::move( layers ) );
}
 
 
PAD* PCB_IO_KICAD_SEXPR_PARSER::parsePAD( FOOTPRINT* aParent )
{
    wxCHECK_MSG( CurTok() == T_pad, nullptr, wxT( "Cannot parse " ) + GetTokenString( CurTok() ) + wxT( " as PAD." ) );
 
    VECTOR2I sz;
    VECTOR2I pt;
    bool     foundNet = false;
    bool     foundNetcode = false;
 
    std::unique_ptr<PAD> pad = std::make_unique<PAD>( aParent );
 
    NeedSYMBOLorNUMBER();
    pad->SetNumber( FromUTF8() );
 
    T token = NextTok();
 
    // NB: all pre-padstack tokens are stored into the F_Cu layer.  For PADSTACK::MODE::NORMAL
    // this will be all there is.  For complex padstacks, the other values will get loaded from the
    // T_padstack record.
 
    switch( token )
    {
    case T_thru_hole:
        pad->SetAttribute( PAD_ATTRIB::PTH );
 
        // The drill token is usually missing if 0 drill size is specified.
        // Emulate it using 1 nm drill size to avoid errors.
        // Drill size cannot be set to 0 in newer versions.
        pad->SetDrillSize( VECTOR2I( 1, 1 ) );
        break;
 
    case T_smd:
        pad->SetAttribute( PAD_ATTRIB::SMD );
        break;
 
    case T_connect:
        pad->SetAttribute( PAD_ATTRIB::CONN );
        break;
 
    case T_np_thru_hole:
        pad->SetAttribute( PAD_ATTRIB::NPTH );
        break;
 
    default:
        Expecting( "thru_hole, smd, connect, or np_thru_hole" );
    }
 
    token = NextTok();
 
    switch( token )
    {
    case T_circle:
        pad->SetShape( F_Cu, PAD_SHAPE::CIRCLE );
        break;
 
    case T_rect:
        pad->SetShape( F_Cu, PAD_SHAPE::RECTANGLE );
        break;
 
    case T_oval:
        pad->SetShape( F_Cu, PAD_SHAPE::OVAL );
        break;
 
    case T_trapezoid:
        pad->SetShape( F_Cu, PAD_SHAPE::TRAPEZOID );
        break;
 
    case T_roundrect:
        // Note: the shape can be PAD_SHAPE::ROUNDRECT or PAD_SHAPE::CHAMFERED_RECT
        // (if chamfer parameters are found later in pad descr.)
        pad->SetShape( F_Cu, PAD_SHAPE::ROUNDRECT );
        break;
 
    case T_custom:
        pad->SetShape( F_Cu, PAD_SHAPE::CUSTOM );
        break;
 
    default:
        Expecting( "circle, rectangle, roundrect, oval, trapezoid or custom" );
    }
 
    std::optional<EDA_ANGLE> thermalBrAngleOverride;
 
    for( token = NextTok();  token != T_RIGHT;  token = NextTok() )
    {
        if( token == T_locked )
        {
            // Pad locking is now a session preference
            token = NextTok();
        }
 
        if( token != T_LEFT )
            Expecting( T_LEFT );
 
        token = NextTok();
 
        switch( token )
        {
        case T_size:
            sz.x = parseBoardUnits( "width value" );
            sz.y = parseBoardUnits( "height value" );
            pad->SetLibSize( F_Cu, sz );
            NeedRIGHT();
            break;
 
        case T_at:
            pt.x = parseBoardUnits( "X coordinate" );
            pt.y = parseBoardUnits( "Y coordinate" );
            pad->SetFPRelativePosition( pt );
            token = NextTok();
 
            // The pad angle in the file is a board frame absolute value. If it is
            // missing, the pad is axis aligned regardless of the parent footprint
            // orientation, matching the pre affine transform behavior.
            if( token == T_NUMBER )
            {
                pad->SetOrientation( EDA_ANGLE( parseDouble(), DEGREES_T ) );
                NeedRIGHT();
            }
            else if( token == T_RIGHT )
            {
                pad->SetOrientation( ANGLE_0 );
            }
            else
            {
                Expecting( ") or angle value" );
            }
 
            break;
 
        case T_rect_delta:
        {
            VECTOR2I delta;
            delta.x = parseBoardUnits( "rectangle delta width" );
            delta.y = parseBoardUnits( "rectangle delta height" );
            pad->SetDelta( F_Cu, delta );
            NeedRIGHT();
            break;
        }
 
        case T_drill:
        {
            bool     haveWidth = false;
            VECTOR2I drillSize = pad->GetDrillSize();
 
            for( token = NextTok(); token != T_RIGHT; token = NextTok() )
            {
                if( token == T_LEFT )
                    token = NextTok();
 
                switch( token )
                {
                case T_oval: pad->SetDrillShape( PAD_DRILL_SHAPE::OBLONG ); break;
 
                case T_NUMBER:
                {
                    if( !haveWidth )
                    {
                        drillSize.x = parseBoardUnits();
 
                        // If height is not defined the width and height are the same.
                        drillSize.y = drillSize.x;
                        haveWidth = true;
                    }
                    else
                    {
                        drillSize.y = parseBoardUnits();
                    }
                }
 
                break;
 
                case T_offset:
                    pt.x = parseBoardUnits( "drill offset x" );
                    pt.y = parseBoardUnits( "drill offset y" );
                    pad->SetLibOffset( F_Cu, pt );
                    NeedRIGHT();
                    break;
 
                default:
                    Expecting( "oval, size, or offset" );
                }
            }
 
            // This fixes a bug caused by setting the default PAD drill size to a value other
            // than 0 used to fix a bunch of debug assertions even though it is defined as a
            // through hole pad.  Wouldn't a though hole pad with no drill be a surface mount
            // pad (or a conn pad which is a smd pad with no solder paste)?
            if( pad->GetAttribute() != PAD_ATTRIB::SMD && pad->GetAttribute() != PAD_ATTRIB::CONN )
                pad->SetLibDrillSize( drillSize );
            else
                pad->SetLibDrillSize( VECTOR2I( 0, 0 ) );
 
            break;
        }
 
        case T_backdrill:
        {
            // Parse: (backdrill (size ...) (layers start end))
            PADSTACK::DRILL_PROPS& secondary = pad->Padstack().SecondaryDrill();
 
            for( token = NextTok(); token != T_RIGHT; token = NextTok() )
            {
                if( token != T_LEFT )
                    Expecting( T_LEFT );
 
                token = NextTok();
 
                switch( token )
                {
                case T_size:
                {
                    int size = parseBoardUnits( "backdrill size" );
                    secondary.size = VECTOR2I( size, size );
                    NeedRIGHT();
                    break;
                }
 
                case T_layers:
                {
                    NextTok();
                    secondary.start = lookUpLayer( m_layerIndices );
                    NextTok();
                    secondary.end = lookUpLayer( m_layerIndices );
                    NeedRIGHT();
                    break;
                }
 
                default:
                    Expecting( "size or layers" );
                }
            }
 
            break;
        }
 
        case T_tertiary_drill:
        {
            // Parse: (tertiary_drill (size ...) (layers start end))
            PADSTACK::DRILL_PROPS& tertiary = pad->Padstack().TertiaryDrill();
 
            for( token = NextTok(); token != T_RIGHT; token = NextTok() )
            {
                if( token != T_LEFT )
                    Expecting( T_LEFT );
 
                token = NextTok();
 
                switch( token )
                {
                case T_size:
                {
                    int size = parseBoardUnits( "tertiary drill size" );
                    tertiary.size = VECTOR2I( size, size );
                    NeedRIGHT();
                    break;
                }
 
                case T_layers:
                {
                    NextTok();
                    tertiary.start = lookUpLayer( m_layerIndices );
                    NextTok();
                    tertiary.end = lookUpLayer( m_layerIndices );
                    NeedRIGHT();
                    break;
                }
 
                default:
                    Expecting( "size or layers" );
                }
            }
 
            break;
        }
 
        case T_layers:
        {
            LSET layerMask = parseBoardItemLayersAsMask();
 
            pad->SetLayerSet( layerMask );
            break;
        }
 
        case T_net:
            foundNet = true;
 
            token = NextTok();
 
            // Legacy files (pre-10.0) will have a netcode written before the netname.  This netcode
            // is authoratative (though may be mapped by getNetCode() to prevent collisions).
            if( IsNumber( token ) )
            {
                if( !pad->SetNetCode( getNetCode( parseInt() ), /* aNoAssert */ true ) )
                {
                    wxLogTrace( traceKicadPcbPlugin, _( "Invalid net ID in\nfile: %s\nline: %d offset: %d" ),
                                CurSource(), CurLineNumber(), CurOffset() );
                }
                else
                {
                    foundNetcode = true;
                }
 
                token = NextTok();
            }
 
            if( !IsSymbol( token ) )
            {
                Expecting( "net name" );
                break;
            }
 
            if( m_board )
            {
                wxString netName( FromUTF8() );
 
                // Convert overbar syntax from `~...~` to `~{...}`.  These were left out of the
                // first merge so the version is a bit later.
                if( m_requiredVersion < 20210606 )
                    netName = ConvertToNewOverbarNotation( netName );
 
                if( foundNetcode )
                {
                    if( netName != m_board->FindNet( pad->GetNetCode() )->GetNetname() )
                    {
                        pad->SetNetCode( NETINFO_LIST::ORPHANED, /* aNoAssert */ true );
                        wxLogTrace( traceKicadPcbPlugin,
                                    _( "Net name doesn't match ID in\nfile: %s\nline: %d offset: %d" ),
                                    CurSource(), CurLineNumber(), CurOffset() );
                    }
                }
                else
                {
                    NETINFO_ITEM* netinfo = m_board->FindNet( netName );
 
                    if( !netinfo )
                    {
                        netinfo = new NETINFO_ITEM( m_board, netName );
                        m_board->Add( netinfo, ADD_MODE::INSERT, true );
                    }
 
                    pad->SetNet( netinfo );
                }
            }
 
            NeedRIGHT();
            break;
 
        case T_pinfunction:
            NeedSYMBOLorNUMBER();
            pad->SetPinFunction( FromUTF8() );
            NeedRIGHT();
            break;
 
        case T_pintype:
            NeedSYMBOLorNUMBER();
            pad->SetPinType( FromUTF8() );
            NeedRIGHT();
            break;
 
        case T_sim_electrical_type:
        {
            token = NextTok();
 
            switch( token )
            {
            case T_source: pad->SetSimElectricalType( PAD_SIM_ELECTRICAL_TYPE::SOURCE ); break;
            case T_sink:   pad->SetSimElectricalType( PAD_SIM_ELECTRICAL_TYPE::SINK ); break;
            default:       Expecting( "sink or source" );
            }
 
            NeedRIGHT();
            break;
        }
 
        case T_die_length:
            pad->SetPadToDieLength( parseBoardUnits( T_die_length ) );
            NeedRIGHT();
            break;
 
        case T_die_delay:
            if( m_requiredVersion <= 20250926 )
                pad->SetPadToDieDelay( parseBoardUnits( T_die_delay ) );
            else
                pad->SetPadToDieDelay( parseBoardUnits( T_die_delay, EDA_DATA_TYPE::TIME ) );
 
            NeedRIGHT();
            break;
 
        case T_solder_mask_margin:
            pad->SetLocalSolderMaskMargin( parseBoardUnits( "local solder mask margin value" ) );
            NeedRIGHT();
 
            // In pre-9.0 files "0" meant inherit.
            if( m_requiredVersion <= 20240201 && pad->GetLocalSolderMaskMargin() == 0 )
                pad->SetLocalSolderMaskMargin( {} );
 
            break;
 
        case T_solder_paste_margin:
            pad->SetLocalSolderPasteMargin( parseBoardUnits( "local solder paste margin value" ) );
            NeedRIGHT();
 
            // In pre-9.0 files "0" meant inherit.
            if( m_requiredVersion <= 20240201 && pad->GetLocalSolderPasteMargin() == 0 )
                pad->SetLocalSolderPasteMargin( {} );
 
            break;
 
        case T_solder_paste_margin_ratio:
            pad->SetLocalSolderPasteMarginRatio( parseDouble( "local solder paste margin ratio value" ) );
            NeedRIGHT();
 
            // In pre-9.0 files "0" meant inherit.
            if( m_requiredVersion <= 20240201 && pad->GetLocalSolderPasteMarginRatio() == 0 )
                pad->SetLocalSolderPasteMarginRatio( {} );
 
            break;
 
        case T_clearance:
            pad->SetLocalClearance( parseBoardUnits( "local clearance value" ) );
            NeedRIGHT();
 
            // In pre-9.0 files "0" meant inherit.
            if( m_requiredVersion <= 20240201 && pad->GetLocalClearance() == 0 )
                pad->SetLocalClearance( {} );
 
            break;
 
        case T_teardrops:
            parseTEARDROP_PARAMETERS( &pad->GetTeardropParams() );
            break;
 
        case T_zone_connect:
            pad->SetLocalZoneConnection( (ZONE_CONNECTION) parseInt( "zone connection value" ) );
            NeedRIGHT();
            break;
 
        case T_thermal_width:       // legacy token
        case T_thermal_bridge_width:
            pad->SetLocalThermalSpokeWidthOverride( parseBoardUnits( token ) );
            NeedRIGHT();
            break;
 
        case T_thermal_bridge_angle:
            thermalBrAngleOverride = EDA_ANGLE( parseDouble( "thermal spoke angle" ), DEGREES_T );
            NeedRIGHT();
            break;
 
 
        case T_thermal_gap:
            pad->SetThermalGap( parseBoardUnits( "thermal relief gap value" ) );
            NeedRIGHT();
            break;
 
        case T_roundrect_rratio:
            pad->SetRoundRectRadiusRatio( F_Cu, parseDouble( "roundrect radius ratio" ) );
            NeedRIGHT();
            break;
 
        case T_chamfer_ratio:
            pad->SetChamferRectRatio( F_Cu, parseDouble( "chamfer ratio" ) );
 
            if( pad->GetChamferRectRatio( F_Cu ) > 0 )
                pad->SetShape( F_Cu, PAD_SHAPE::CHAMFERED_RECT );
 
            NeedRIGHT();
            break;
 
        case T_chamfer:
        {
            int  chamfers = 0;
            bool end_list = false;
 
            while( !end_list )
            {
                token = NextTok();
 
                switch( token )
                {
                case T_top_left:
                    chamfers |= RECT_CHAMFER_TOP_LEFT;
                    break;
 
                case T_top_right:
                    chamfers |= RECT_CHAMFER_TOP_RIGHT;
                    break;
 
                case T_bottom_left:
                    chamfers |= RECT_CHAMFER_BOTTOM_LEFT;
                    break;
 
                case T_bottom_right:
                    chamfers |= RECT_CHAMFER_BOTTOM_RIGHT;
                    break;
 
                case T_RIGHT:
                    pad->SetChamferPositions( F_Cu, chamfers );
                    end_list = true;
                    break;
 
                default:
                    Expecting( "chamfer_top_left chamfer_top_right chamfer_bottom_left or chamfer_bottom_right" );
                }
            }
 
            if( pad->GetChamferPositions( F_Cu ) != RECT_NO_CHAMFER )
                pad->SetShape( F_Cu, PAD_SHAPE::CHAMFERED_RECT );
 
            break;
        }
 
        case T_property:
            while( token != T_RIGHT )
            {
                token = NextTok();
 
                switch( token )
                {
                case T_pad_prop_bga:           pad->SetProperty( PAD_PROP::BGA );            break;
                case T_pad_prop_fiducial_glob: pad->SetProperty( PAD_PROP::FIDUCIAL_GLBL );  break;
                case T_pad_prop_fiducial_loc:  pad->SetProperty( PAD_PROP::FIDUCIAL_LOCAL ); break;
                case T_pad_prop_testpoint:     pad->SetProperty( PAD_PROP::TESTPOINT );      break;
                case T_pad_prop_castellated:   pad->SetProperty( PAD_PROP::CASTELLATED );    break;
                case T_pad_prop_heatsink:      pad->SetProperty( PAD_PROP::HEATSINK );       break;
                case T_pad_prop_mechanical:    pad->SetProperty( PAD_PROP::MECHANICAL );     break;
                case T_pad_prop_pressfit:      pad->SetProperty( PAD_PROP::PRESSFIT );       break;
                case T_none:                   pad->SetProperty( PAD_PROP::NONE );           break;
                case T_RIGHT:                                                                break;
 
                default:
#if 0   // Currently: skip unknown property
                    Expecting( "pad_prop_bga pad_prop_fiducial_glob pad_prop_fiducial_loc"
                               " pad_prop_heatsink or pad_prop_castellated" );
#endif
                    break;
                }
            }
 
            break;
 
        case T_options:
            parsePAD_option( pad.get(), F_Cu );
            break;
 
        case T_padstack:
            parsePadstack( pad.get() );
            break;
 
        case T_primitives:
            // Primitives at the top level are put in the padstack's F_Cu; other layers will be parsed
            // in parsePadstack().
            parsePAD_primitives( pad.get(), F_Cu );
            break;
 
        case T_remove_unused_layers:
        {
            bool remove = parseMaybeAbsentBool( true );
            pad->SetRemoveUnconnected( remove );
            break;
        }
 
        case T_keep_end_layers:
        {
            bool keep = parseMaybeAbsentBool( true );
            pad->SetKeepTopBottom( keep );
            break;
        }
 
        case T_tenting:
        {
            auto [front, back] = parseFrontBackOptBool( true );
            pad->Padstack().FrontOuterLayers().has_solder_mask = front;
            pad->Padstack().BackOuterLayers().has_solder_mask = back;
            break;
        }
 
        case T_zone_layer_connections:
        {
            LSET cuLayers = pad->GetLayerSet() & LSET::AllCuMask();
 
            for( PCB_LAYER_ID layer : cuLayers )
                pad->SetZoneLayerOverride( layer, ZLO_FORCE_NO_ZONE_CONNECTION );
 
            for( token = NextTok(); token != T_RIGHT; token = NextTok() )
            {
                PCB_LAYER_ID layer = lookUpLayer( m_layerIndices );
 
                if( !IsCopperLayer( layer ) )
                    Expecting( "copper layer name" );
 
                pad->SetZoneLayerOverride( layer, ZLO_FORCE_FLASHED );
            }
 
            break;
        }
 
        // Continue to process "(locked)" format which was output during 5.99 development
        case T_locked:
            // Pad locking is now a session preference
            parseMaybeAbsentBool( true );
            break;
 
        case T_tstamp:
        case T_uuid:
            NextTok();
            pad->SetUuidDirect( CurStrToKIID() );
            NeedRIGHT();
            break;
 
        case T_front_post_machining:
            parsePostMachining( pad->Padstack().FrontPostMachining() );
            break;
 
        case T_back_post_machining:
            parsePostMachining( pad->Padstack().BackPostMachining() );
            break;
 
        case T_custom_property:
            parseCustomProperty( pad.get() );
            break;
 
        default:
            Expecting( "at, locked, drill, layers, net, die_length, roundrect_rratio, "
                       "solder_mask_margin, solder_paste_margin, solder_paste_margin_ratio, uuid, "
                       "clearance, tstamp, primitives, remove_unused_layers, keep_end_layers, "
                       "pinfunction, pintype, zone_connect, thermal_width, thermal_gap, padstack, "
                       "teardrops, front_post_machining, back_post_machining, or custom_property" );
        }
    }
 
    if( !foundNet )
    {
        // Make sure default netclass is correctly assigned to pads that don't define a net.
        pad->SetNetCode( 0, /* aNoAssert */ true );
    }
 
    if( thermalBrAngleOverride )
    {
        pad->SetThermalSpokeAngle( *thermalBrAngleOverride );
    }
    else
    {
        // This is here because custom pad anchor shape isn't known before reading (options
        if( pad->GetShape( F_Cu ) == PAD_SHAPE::CIRCLE )
        {
            pad->SetThermalSpokeAngle( ANGLE_45 );
        }
        else if( pad->GetShape( F_Cu ) == PAD_SHAPE::CUSTOM && pad->GetAnchorPadShape( F_Cu ) == PAD_SHAPE::CIRCLE )
        {
            if( m_requiredVersion <= 20211014 ) // 6.0
                pad->SetThermalSpokeAngle( ANGLE_90 );
            else
                pad->SetThermalSpokeAngle( ANGLE_45 );
        }
        else
        {
            pad->SetThermalSpokeAngle( ANGLE_90 );
        }
    }
 
    if( !pad->CanHaveNumber() )
    {
        // At some point it was possible to assign a number to aperture pads so we need to clean
        // those out here.
        pad->SetNumber( wxEmptyString );
    }
 
    // Zero-sized pads are likely algorithmically unsafe.
    pad->Padstack().ForEachUniqueLayer(
            [&]( PCB_LAYER_ID aLayer )
            {
                VECTOR2I padSize = pad->GetSize( aLayer );
 
                if( padSize.x <= 0 || padSize.y <= 0 )
                {
                    pad->SetSize( aLayer, VECTOR2I( pcbIUScale.mmToIU( 0.001 ), pcbIUScale.mmToIU( 0.001 ) ) );
 
                    m_parseWarnings.push_back( wxString::Format( _( "Invalid zero-sized pad pinned to %s in\n"
                                                                    "file: %s\n"
                                                                    "line: %d\n"
                                                                    "offset: %d" ),
                                                                 wxT( "1µm" ),
                                                                 CurSource(), CurLineNumber(), CurOffset() ) );
                }
            } );
 
    return pad.release();
}
 
 
void PCB_IO_KICAD_SEXPR_PARSER::parsePAD_primitives( PAD* aPad, PCB_LAYER_ID aLayer )
{
    for( T token = NextTok(); token != T_RIGHT; token = NextTok() )
    {
        if( token == T_LEFT )
            token = NextTok();
 
        switch( token )
        {
        case T_gr_arc:
        case T_gr_line:
        case T_gr_circle:
        case T_gr_rect:
        case T_gr_poly:
        case T_gr_curve:
            aPad->AddPrimitive( aLayer, parsePCB_SHAPE( nullptr ) );
            break;
 
        case T_gr_bbox:
            {
                PCB_SHAPE* numberBox = parsePCB_SHAPE( nullptr );
                numberBox->SetIsProxyItem();
                aPad->AddPrimitive( aLayer, numberBox );
                break;
            }
 
        case T_gr_vector:
            {
                PCB_SHAPE* spokeTemplate = parsePCB_SHAPE( nullptr );
                spokeTemplate->SetIsProxyItem();
                aPad->AddPrimitive( aLayer, spokeTemplate );
                break;
            }
 
        default:
            Expecting( "gr_line, gr_arc, gr_circle, gr_curve, gr_rect, gr_bbox or gr_poly" );
            break;
        }
    }
}
 
 
void PCB_IO_KICAD_SEXPR_PARSER::parsePAD_option( PAD* aPad, PCB_LAYER_ID aLayer )
{
    // Parse only the (option ...) inside a pad description
    for( T token = NextTok(); token != T_RIGHT; token = NextTok() )
    {
        if( token != T_LEFT )
            Expecting( T_LEFT );
 
        token = NextTok();
 
        switch( token )
        {
        case T_anchor:
            token = NextTok();
 
            // Custom shaped pads have a "anchor pad", which is the reference for connection calculations.
            // Because this is an anchor, only the 2 very basic shapes are managed: circle and rect.
            switch( token )
            {
                case T_circle: aPad->SetAnchorPadShape( aLayer, PAD_SHAPE::CIRCLE );    break;
                case T_rect:   aPad->SetAnchorPadShape( aLayer, PAD_SHAPE::RECTANGLE ); break;
                default:       Expecting( "circle or rect" );
            }
 
            NeedRIGHT();
            break;
 
        case T_clearance:
            token = NextTok();
 
            // TODO: m_customShapeInZoneMode is not per-layer at the moment
            if( aLayer == F_Cu )
            {
                // Custom shaped pads have a clearance area that is the pad shape (like usual pads) or the
                // convex hull of the pad shape.
                switch( token )
                {
                case T_outline:    aPad->SetCustomShapeInZoneOpt( CUSTOM_SHAPE_ZONE_MODE::OUTLINE );    break;
                case T_convexhull: aPad->SetCustomShapeInZoneOpt( CUSTOM_SHAPE_ZONE_MODE::CONVEXHULL ); break;
                default:           Expecting( "outline or convexhull" );
                }
            }
 
            NeedRIGHT();
            break;
 
        default:
            Expecting( "anchor or clearance" );
            break;
        }
    }
}
 
 
void PCB_IO_KICAD_SEXPR_PARSER::parsePostMachining( PADSTACK::POST_MACHINING_PROPS& aProps )
{
    // Parse: (front_post_machining counterbore (size ...) (depth ...) (angle ...))
    // or:    (back_post_machining countersink (size ...) (depth ...) (angle ...))
    // The mode token (counterbore/countersink) comes first
    T token = NextTok();
 
    switch( token )
    {
    case T_counterbore: aProps.mode = PAD_DRILL_POST_MACHINING_MODE::COUNTERBORE; break;
    case T_countersink: aProps.mode = PAD_DRILL_POST_MACHINING_MODE::COUNTERSINK; break;
    default:            Expecting( "counterbore or countersink" );
    }
 
    // Parse optional properties
    for( token = NextTok(); token != T_RIGHT; token = NextTok() )
    {
        if( token != T_LEFT )
            Expecting( T_LEFT );
 
        token = NextTok();
 
        switch( token )
        {
        case T_size:
            aProps.size = parseBoardUnits( "post machining size" );
            NeedRIGHT();
            break;
 
        case T_depth:
            aProps.depth = parseBoardUnits( "post machining depth" );
            NeedRIGHT();
            break;
 
        case T_angle:
            aProps.angle = KiROUND( parseDouble( "post machining angle" ) * 10.0 );
            NeedRIGHT();
            break;
 
        default:
            Expecting( "size, depth, or angle" );
        }
    }
}
 
 
void PCB_IO_KICAD_SEXPR_PARSER::parsePadstack( PAD* aPad )
{
    PADSTACK& padstack = aPad->Padstack();
 
    for( T token = NextTok(); token != T_RIGHT; token = NextTok() )
    {
        if( token != T_LEFT )
            Expecting( T_LEFT );
 
        token = NextTok();
 
        switch( token )
        {
        case T_mode:
            token = NextTok();
 
            switch( token )
            {
            case T_front_inner_back:
                padstack.SetMode( PADSTACK::MODE::FRONT_INNER_BACK );
                break;
 
            case T_custom:
                padstack.SetMode( PADSTACK::MODE::CUSTOM );
                break;
 
            default:
                Expecting( "front_inner_back or custom" );
            }
 
            NeedRIGHT();
            break;
 
        case T_layer:
        {
            NextTok();
            PCB_LAYER_ID curLayer = UNDEFINED_LAYER;
 
            if( curText == "Inner" )
            {
                if( padstack.Mode() != PADSTACK::MODE::FRONT_INNER_BACK )
                {
                    THROW_IO_ERRORF( _( "Invalid padstack layer in\nfile: %s\nline: %d\noffset: %d." ),
                                     CurSource(), CurLineNumber(), CurOffset() );
                }
 
                curLayer = PADSTACK::INNER_LAYERS;
            }
            else
            {
                curLayer = lookUpLayer( m_layerIndices );
            }
 
            if( !IsCopperLayer( curLayer ) )
            {
                THROW_IO_ERRORF( _( "Invalid padstack layer '%s' in file '%s' at line %d, offset %d." ),
                                 curText, CurSource().GetData(), CurLineNumber(), CurOffset() );
            }
 
            // Reset layer properties to default that are omitted when default in the formatter
            aPad->SetLibOffset( curLayer, VECTOR2I( 0, 0 ) );
            aPad->SetDelta( curLayer, VECTOR2I( 0, 0 ) );
 
            for( token = NextTok(); token != T_RIGHT; token = NextTok() )
            {
                if( token != T_LEFT )
                    Expecting( T_LEFT );
 
                token = NextTok();
 
                switch( token )
                {
                case T_shape:
                    token = NextTok();
 
                    switch( token )
                    {
                    case T_circle:
                        aPad->SetShape( curLayer, PAD_SHAPE::CIRCLE );
                        break;
 
                    case T_rect:
                        aPad->SetShape( curLayer, PAD_SHAPE::RECTANGLE );
                        break;
 
                    case T_oval:
                        aPad->SetShape( curLayer, PAD_SHAPE::OVAL );
                        break;
 
                    case T_trapezoid:
                        aPad->SetShape( curLayer, PAD_SHAPE::TRAPEZOID );
                        break;
 
                    case T_roundrect:
                        // Note: the shape can be PAD_SHAPE::ROUNDRECT or PAD_SHAPE::CHAMFERED_RECT
                        // (if chamfer parameters are found later in pad descr.)
                        aPad->SetShape( curLayer, PAD_SHAPE::ROUNDRECT );
                        break;
 
                    case T_custom:
                        aPad->SetShape( curLayer, PAD_SHAPE::CUSTOM );
                        break;
 
                    default:
                        Expecting( "circle, rectangle, roundrect, oval, trapezoid or custom" );
                    }
 
                    NeedRIGHT();
                    break;
 
                case T_size:
                {
                    VECTOR2I sz;
                    sz.x = parseBoardUnits( "width value" );
                    sz.y = parseBoardUnits( "height value" );
                    aPad->SetLibSize( curLayer, sz );
                    NeedRIGHT();
                    break;
                }
 
                case T_offset:
                {
                    VECTOR2I pt;
                    pt.x = parseBoardUnits( "drill offset x" );
                    pt.y = parseBoardUnits( "drill offset y" );
                    aPad->SetLibOffset( curLayer, pt );
                    NeedRIGHT();
                    break;
                }
 
                case T_rect_delta:
                {
                    VECTOR2I delta;
                    delta.x = parseBoardUnits( "rectangle delta width" );
                    delta.y = parseBoardUnits( "rectangle delta height" );
                    aPad->SetDelta( curLayer, delta );
                    NeedRIGHT();
                    break;
                }
 
                case T_roundrect_rratio:
                    aPad->SetRoundRectRadiusRatio( curLayer, parseDouble( "roundrect radius ratio" ) );
                    NeedRIGHT();
                    break;
 
                case T_chamfer_ratio:
                {
                    double ratio = parseDouble( "chamfer ratio" );
                    aPad->SetChamferRectRatio( curLayer, ratio );
 
                    if( ratio > 0 )
                        aPad->SetShape( curLayer, PAD_SHAPE::CHAMFERED_RECT );
 
                    NeedRIGHT();
                    break;
                }
 
                case T_chamfer:
                {
                    int  chamfers = 0;
                    bool end_list = false;
 
                    while( !end_list )
                    {
                        token = NextTok();
 
                        switch( token )
                        {
                        case T_top_left:
                            chamfers |= RECT_CHAMFER_TOP_LEFT;
                            break;
 
                        case T_top_right:
                            chamfers |= RECT_CHAMFER_TOP_RIGHT;
                            break;
 
                        case T_bottom_left:
                            chamfers |= RECT_CHAMFER_BOTTOM_LEFT;
                            break;
 
                        case T_bottom_right:
                            chamfers |= RECT_CHAMFER_BOTTOM_RIGHT;
                            break;
 
                        case T_RIGHT:
                            aPad->SetChamferPositions( curLayer, chamfers );
                            end_list = true;
                            break;
 
                        default:
                            Expecting( "chamfer_top_left chamfer_top_right chamfer_bottom_left or "
                                       "chamfer_bottom_right" );
                        }
                    }
 
                    if( end_list && chamfers != RECT_NO_CHAMFER )
                        aPad->SetShape( curLayer, PAD_SHAPE::CHAMFERED_RECT );
 
                    break;
                }
 
                case T_thermal_bridge_width:
                    padstack.ThermalSpokeWidth( curLayer ) = parseBoardUnits( "thermal relief spoke width" );
                    NeedRIGHT();
                    break;
 
                case T_thermal_gap:
                    padstack.ThermalGap( curLayer ) = parseBoardUnits( "thermal relief gap value" );
                    NeedRIGHT();
                    break;
 
                case T_thermal_bridge_angle:
                    padstack.SetThermalSpokeAngle( EDA_ANGLE( parseDouble( "thermal spoke angle" ), DEGREES_T ) );
                    NeedRIGHT();
                    break;
 
                case T_zone_connect:
                    padstack.ZoneConnection( curLayer ) =
                            magic_enum::enum_cast<ZONE_CONNECTION>( parseInt( "zone connection value" ) );
                    NeedRIGHT();
                    break;
 
                case T_clearance:
                    padstack.Clearance( curLayer ) = parseBoardUnits( "local clearance value" );
                    NeedRIGHT();
                    break;
 
                case T_tenting:
                {
                    auto [front, back] = parseFrontBackOptBool( true );
                    padstack.FrontOuterLayers().has_solder_mask = front;
                    padstack.BackOuterLayers().has_solder_mask = back;
                    break;
                }
 
                case T_options:
                    parsePAD_option( aPad, curLayer );
                    break;
 
                case T_primitives:
                    // the file lists every primitive of the layer, so none inherited from another layer stay
                    aPad->DeletePrimitivesList( curLayer );
                    parsePAD_primitives( aPad, curLayer );
                    break;
 
                default:
                    // Not strict-parsing padstack layers yet
                    continue;
                }
            }
 
            break;
        }
 
        default:
            Expecting( "mode or layer" );
            break;
        }
    }
}
 
 
void PCB_IO_KICAD_SEXPR_PARSER::parseGROUP_members( GROUP_INFO& aGroupInfo )
{
    while( NextTok() != T_RIGHT )
    {
        // This token is the Uuid of the item in the group.
        // Since groups are serialized at the end of the file/footprint, the Uuid should already
        // have been seen and exist in the board.
        KIID uuid( CurStr() );
        aGroupInfo.memberUuids.push_back( uuid );
    }
}
 
 
void PCB_IO_KICAD_SEXPR_PARSER::parseGENERATOR_templates( GENERATOR_INFO& aGenInfo )
{
    for( T tok = NextTok(); tok != T_RIGHT; tok = NextTok() )
    {
        if( tok != T_LEFT )
            Expecting( T_LEFT );
 
        if( NextTok() != T_template )
            Expecting( T_template );
 
        wxString                    templateName;
        std::unique_ptr<BOARD_ITEM> parsed;
 
        // Parse (template ...
        for( T innerTok = NextTok(); innerTok != T_RIGHT; innerTok = NextTok() )
        {
            if( innerTok != T_LEFT )
                Expecting( T_LEFT );
 
            T inner = NextTok();
 
            switch( inner )
            {
            case T_name:
                NeedSYMBOLorNUMBER();
                templateName = FromUTF8();
                NeedRIGHT();
                break;
 
            case T_via:
                // A duplicate item in the same (template …) block replaces the previous one.
                parsed.reset( parsePCB_VIA() );
                // parsePCB_VIA consumes the closing T_RIGHT itself.
                break;
 
            default: Expecting( "name or via" );
            }
        }
 
        if( parsed )
            aGenInfo.templates.emplace_back( templateName, std::move( parsed ) );
    }
}
 
 
void PCB_IO_KICAD_SEXPR_PARSER::parseGROUP( BOARD_ITEM* aParent )
{
    wxCHECK_RET( CurTok() == T_group, wxT( "Cannot parse " ) + GetTokenString( CurTok() ) + wxT( " as PCB_GROUP." ) );
 
    T token;
 
    m_groupInfos.push_back( GROUP_INFO() );
    GROUP_INFO& groupInfo = m_groupInfos.back();
    groupInfo.parent = aParent;
 
    while( ( token = NextTok() ) != T_LEFT )
    {
        if( token == T_STRING )
            groupInfo.name = FromUTF8();
        else if( token == T_locked )
            groupInfo.locked = true;
        else
            Expecting( "group name or locked" );
    }
 
    for( ; token != T_RIGHT; token = NextTok() )
    {
        if( token != T_LEFT )
            Expecting( T_LEFT );
 
        token = NextTok();
 
        switch( token )
        {
         // From formats [20200811, 20231215), 'id' was used instead of 'uuid'
        case T_id:
        case T_uuid:
            NextTok();
            groupInfo.uuid = CurStrToKIID();
            NeedRIGHT();
            break;
 
        case T_lib_id:
        {
            token = NextTok();
 
            if( !IsSymbol( token ) && token != T_NUMBER )
                Expecting( "symbol|number" );
 
            wxString name = FromUTF8();
            // Some symbol LIB_IDs have the '/' character escaped which can break
            // symbol links.  The '/' character is no longer an illegal LIB_ID character so
            // it doesn't need to be escaped.
            name.Replace( "{slash}", "/" );
 
            int bad_pos = groupInfo.libId.Parse( name );
 
            if( bad_pos >= 0 )
            {
                if( static_cast<int>( name.size() ) > bad_pos )
                {
                    wxString msg = wxString::Format( _( "Group library link %s contains invalid character '%c'" ),
                                                     name,
                                                     name[bad_pos] );
 
                    THROW_PARSE_ERROR( msg, CurSource(), CurLine(), CurLineNumber(), CurOffset() );
                }
 
                THROW_PARSE_ERROR( _( "Invalid library ID" ), CurSource(), CurLine(), CurLineNumber(), CurOffset() );
            }
 
            NeedRIGHT();
            break;
        }
 
        case T_locked:
            groupInfo.locked = parseBool();
            NeedRIGHT();
            break;
 
        case T_members:
            parseGROUP_members( groupInfo );
            break;
 
        case T_custom_property:
            parseCustomProperty( groupInfo.customProperties );
            break;
 
        default:
            Expecting( "uuid, locked, lib_id, or members" );
        }
    }
}
 
 
void PCB_IO_KICAD_SEXPR_PARSER::parseCONSTRAINT( BOARD_ITEM* aParent )
{
    wxCHECK_RET( CurTok() == T_constraint,
                 wxT( "Cannot parse " ) + GetTokenString( CurTok() ) + wxT( " as PCB_CONSTRAINT." ) );
 
    m_constraintInfos.push_back( CONSTRAINT_INFO() );
    CONSTRAINT_INFO& info = m_constraintInfos.back();
    info.parent = aParent;
 
    for( T token = NextTok(); token != T_RIGHT; token = NextTok() )
    {
        if( token != T_LEFT )
            Expecting( T_LEFT );
 
        token = NextTok();
 
        switch( token )
        {
        case T_type:
            NextTok();
            info.type = ConstraintTypeFromToken( FromUTF8() );
            NeedRIGHT();
            break;
 
        case T_uuid:
            NextTok();
            info.uuid = CurStrToKIID();
            NeedRIGHT();
            break;
 
        case T_members:
            for( token = NextTok(); token != T_RIGHT; token = NextTok() )
            {
                if( token != T_LEFT )
                    Expecting( T_LEFT );
 
                if( NextTok() != T_member )
                    Expecting( "member" );
 
                NextTok();   // member uuid; resolved (and remapped on append) in resolveConstraints
                KIID memberId( CurStr() );
 
                NextTok();   // anchor token
                CONSTRAINT_ANCHOR anchor = ConstraintAnchorFromToken( FromUTF8() );
 
                // Only VERTEX may carry an ordinal and even then optional
                // writer never emits one elsewhere so accepting one there breaks round-trip
                int index = -1;
 
                if( anchor == CONSTRAINT_ANCHOR::VERTEX )
                {
                    token = NextTok();
 
                    if( token != T_RIGHT )
                    {
                        if( token != T_NUMBER )
                            Expecting( "vertex index" );
 
                        index = parseInt();
                        NeedRIGHT();
                    }
                }
                else
                {
                    NeedRIGHT();
                }
 
                info.members.emplace_back( memberId, anchor, index );
            }
 
            break;
 
        case T_value:
            NextTok();
            info.value = parseDouble();
            NeedRIGHT();
            break;
 
        case T_driving:
            info.driving = parseBool();
            NeedRIGHT();
            break;
 
        case T_custom_property:
            parseCustomProperty( info.customProperties );
            break;
 
        default:
            Expecting( "type, uuid, members, value, or driving" );
        }
    }
 
    // The value is written in mm for length/radius types; convert back to IU now that the type is
    // known (independent of token order within the block).
    if( info.value.has_value() && ConstraintValueIsLength( info.type ) )
        info.value = *info.value * pcbIUScale.IU_PER_MM;
}
 
 
void PCB_IO_KICAD_SEXPR_PARSER::resolveConstraints( BOARD_ITEM* aParent )
{
    // Mirror resolveGroups: resolve every deferred constraint against the parsed items, adding
    // each to its own recorded parent (a board parse also sees footprint-scoped constraints, so
    // the resolution must not assume aParent owns them).
    BOARD*     board = dynamic_cast<BOARD*>( aParent );
    FOOTPRINT* footprint = board ? nullptr : dynamic_cast<FOOTPRINT*>( aParent );
 
    std::unordered_map<KIID, BOARD_ITEM*> fpItemMap;
 
    if( footprint )
    {
        footprint->RunOnChildren(
                [&]( BOARD_ITEM* child )
                {
                    fpItemMap.insert( { child->m_Uuid, child } );
                },
                RECURSE_MODE::NO_RECURSE );
    }
 
    auto getItem =
            [&]( const KIID& aId ) -> BOARD_ITEM*
            {
                if( board )
                {
                    return board->ResolveItem( aId, true );
                }
                else if( footprint )
                {
                    auto it = fpItemMap.find( aId );
 
                    return it != fpItemMap.end() ? it->second : nullptr;
                }
 
                return nullptr;
            };
 
    for( const CONSTRAINT_INFO& info : m_constraintInfos )
    {
        std::unique_ptr<PCB_CONSTRAINT> constraint = std::make_unique<PCB_CONSTRAINT>( info.parent, info.type );
 
        constraint->SetUuidDirect( info.uuid );
        constraint->SetValue( info.value );
        constraint->SetDriving( info.driving );
        constraint->SetCustomProperties( info.customProperties );
 
        for( const CONSTRAINT_MEMBER& member : info.members )
        {
            KIID resolvedId = member.m_item;
 
            if( m_appendToExisting )
            {
                // Use the remapped uuid if this member's item was part of the appended content;
                // otherwise keep the original (it will dangle as an error state).  find(), not
                // operator[], so a miss does not pollute the remap with a nil entry.
                auto remap = m_resetKIIDMap.find( member.m_item.AsString() );
 
                if( remap != m_resetKIIDMap.end() )
                    resolvedId = remap->second;
            }
 
            BOARD_ITEM* item = getItem( resolvedId );
 
            // A member that resolves to an item in a different footprint scope is genuinely
            // invalid and dropped.  A member that does not resolve at all (its item was deleted)
            // is kept as a dangling reference: the constraint persists in an error state for the
            // user to repair, rather than silently losing it (Zulip "Geometry Constraint Solver",
            // 2026-06-18; supersedes the plan's drop-on-missing rule).
            if( item )
            {
                if( item->GetParentFootprint() == constraint->GetParentFootprint() )
                    constraint->AddMember( item->m_Uuid, member.m_anchor, member.m_index );
            }
            else
            {
                constraint->AddMember( resolvedId, member.m_anchor, member.m_index );
            }
        }
 
        if( info.parent->Type() == PCB_FOOTPRINT_T )
            static_cast<FOOTPRINT*>( info.parent )->Add( constraint.release(), ADD_MODE::INSERT, true );
        else
            static_cast<BOARD*>( info.parent )->Add( constraint.release(), ADD_MODE::INSERT, true );
    }
}
 
 
void PCB_IO_KICAD_SEXPR_PARSER::parseGENERATOR( BOARD_ITEM* aParent )
{
    wxCHECK_RET( CurTok() == T_generated,
                 wxT( "Cannot parse " ) + GetTokenString( CurTok() ) + wxT( " as PCB_GENERATOR." ) );
 
    T token;
 
    m_generatorInfos.push_back( GENERATOR_INFO() );
    GENERATOR_INFO& genInfo = m_generatorInfos.back();
 
    genInfo.layer = F_Cu;
    genInfo.parent = aParent;
    genInfo.properties = STRING_ANY_MAP( pcbIUScale.IU_PER_MM );
 
    NeedLEFT();
    token = NextTok();
 
    // For formats [20231007, 20231215), 'id' was used instead of 'uuid'
    if( token != T_uuid && token != T_id )
        Expecting( T_uuid );
 
    NextTok();
    genInfo.uuid = CurStrToKIID();
    NeedRIGHT();
 
    for( token = NextTok(); token != T_RIGHT; token = NextTok() )
    {
        if( token != T_LEFT )
            Expecting( T_LEFT );
 
        token = NextTok();
 
        switch( token )
        {
        case T_type:
            NeedSYMBOL();
            genInfo.genType = FromUTF8();
            NeedRIGHT();
            break;
 
        case T_name:
            NeedSYMBOL();
            genInfo.name = FromUTF8();
            NeedRIGHT();
            break;
 
        case T_locked:
            token = NextTok();
            genInfo.locked = token == T_yes;
            NeedRIGHT();
            break;
 
        case T_layer:
            genInfo.layer = parseBoardItemLayer();
            NeedRIGHT();
            break;
 
        case T_members:
            parseGROUP_members( genInfo );
            break;
 
        case T_templates:
            parseGENERATOR_templates( genInfo );
            break;
 
        case T_custom_property:
            parseCustomProperty( genInfo.customProperties );
            break;
 
        default:
        {
            wxString pName = FromUTF8();
            T        tok1 = NextTok();
 
            switch( tok1 )
            {
            case T_yes:
                genInfo.properties.emplace( pName, wxAny( true ) );
                NeedRIGHT();
                break;
 
            case T_no:
                genInfo.properties.emplace( pName, wxAny( false ) );
                NeedRIGHT();
                break;
 
            case T_NUMBER:
            {
                double pValue = parseDouble();
                genInfo.properties.emplace( pName, wxAny( pValue ) );
                NeedRIGHT();
                break;
            }
 
            case T_STRING: // Quoted string
            {
                wxString pValue = FromUTF8();
                genInfo.properties.emplace( pName, pValue );
                NeedRIGHT();
                break;
            }
 
            case T_LEFT:
            {
                NeedSYMBOL();
                T tok2 = CurTok();
 
                switch( tok2 )
                {
                case T_xy:
                {
                    VECTOR2I pt;
 
                    pt.x = parseBoardUnits( "X coordinate" );
                    pt.y = parseBoardUnits( "Y coordinate" );
 
                    genInfo.properties.emplace( pName, wxAny( pt ) );
                    NeedRIGHT();
                    NeedRIGHT();
                    break;
                }
 
                case T_pts:
                {
                    SHAPE_LINE_CHAIN chain;
 
                    for( token = NextTok(); token != T_RIGHT; token = NextTok() )
                        parseOutlinePoints( chain );
 
                    NeedRIGHT();
                    genInfo.properties.emplace( pName, wxAny( chain ) );
                    break;
                }
 
                case T_cells:
                {
                    std::vector<VECTOR2I> cells;
 
                    for( token = NextTok(); token != T_RIGHT; token = NextTok() )
                    {
                        if( token != T_LEFT )
                            Expecting( T_LEFT );
 
                        if( NextTok() != T_ij )
                            Expecting( T_ij );
 
                        VECTOR2I cell;
 
                        cell.x = parseInt( "column index" );
                        cell.y = parseInt( "row index" );
 
                        NeedRIGHT();
                        cells.push_back( cell );
                    }
 
                    NeedRIGHT();
                    genInfo.properties.emplace( pName, wxAny( cells ) );
                    break;
                }
 
                default:
                    Expecting( "xy, pts or cells" );
                }
 
                break;
            }
 
            default:
                Expecting( "a number, symbol, string or (" );
            }
 
            break;
        }
        }
    }
 
    // Previous versions had bugs which could save ghost tuning patterns. Ignore them, and
    // ignore member-less microvia stacks already sitting in files for the same reason.
    if( genInfo.memberUuids.empty()
        && ( genInfo.genType == wxT( "tuning_pattern" ) || genInfo.genType == wxT( "via_stack" ) ) )
    {
        m_generatorInfos.pop_back();
    }
}
 
 
PCB_TRACK* PCB_IO_KICAD_SEXPR_PARSER::parseARC()
{
    wxCHECK_MSG( CurTok() == T_arc, nullptr, wxT( "Cannot parse " ) + GetTokenString( CurTok() ) + wxT( " as ARC." ) );
 
    VECTOR2I                 pt;
    std::unique_ptr<PCB_ARC> arc = std::make_unique<PCB_ARC>( m_board );
 
    for( T token = NextTok(); token != T_RIGHT; token = NextTok() )
    {
        // Legacy locked
        if( token == T_locked )
        {
            arc->SetLocked( true );
            token = NextTok();
        }
 
        if( token != T_LEFT )
            Expecting( T_LEFT );
 
        token = NextTok();
 
        switch( token )
        {
        case T_start:
            pt.x = parseBoardUnits( "start x" );
            pt.y = parseBoardUnits( "start y" );
            arc->SetStart( pt );
            NeedRIGHT();
            break;
 
        case T_mid:
            pt.x = parseBoardUnits( "mid x" );
            pt.y = parseBoardUnits( "mid y" );
            arc->SetMid( pt );
            NeedRIGHT();
            break;
 
        case T_end:
            pt.x = parseBoardUnits( "end x" );
            pt.y = parseBoardUnits( "end y" );
            arc->SetEnd( pt );
            NeedRIGHT();
            break;
 
        case T_width:
            arc->SetWidth( parseBoardUnits( "width" ) );
            NeedRIGHT();
            break;
 
        case T_layer:
            arc->SetLayer( parseBoardItemLayer() );
            NeedRIGHT();
            break;
 
        case T_layers:
            arc->SetLayerSet( parseLayersForCuItemWithSoldermask() );
            break;
 
        case T_solder_mask_margin:
            arc->SetLocalSolderMaskMargin( parseBoardUnits( "local solder mask margin value" ) );
            NeedRIGHT();
            break;
 
        case T_net:
            parseNet( arc.get() );
            break;
 
        case T_tstamp:
        case T_uuid:
            NextTok();
            arc->SetUuidDirect( CurStrToKIID() );
            NeedRIGHT();
            break;
 
        // We continue to parse the status field but it is no longer written
        case T_status:
            parseHex();
            NeedRIGHT();
            break;
 
        case T_locked:
            arc->SetLocked( parseMaybeAbsentBool( true ) );
            break;
 
        case T_custom_property:
            parseCustomProperty( arc.get() );
            break;
 
        default:
            Expecting( "start, mid, end, width, layer, solder_mask_margin, net, tstamp, uuid or status" );
        }
    }
 
    if( !IsCopperLayer( arc->GetLayer() ) )
    {
        // No point in asserting; these usually come from hand-edited boards
        return nullptr;
    }
 
    // Collinear points have no arc center, so load them as the straight track they describe
    if( IsStraightArc( arc->GetStart(), arc->GetMid(), arc->GetEnd() ) )
    {
        std::unique_ptr<PCB_TRACK> track = std::make_unique<PCB_TRACK>( m_board );
 
        // Base assignment copies every track property except the item type and UUID
        static_cast<PCB_TRACK&>( *track ) = *arc;
        track->SetUuidDirect( arc->m_Uuid );
        return track.release();
    }
 
    return arc.release();
}
 
 
PCB_TRACK* PCB_IO_KICAD_SEXPR_PARSER::parsePCB_TRACK()
{
    wxCHECK_MSG( CurTok() == T_segment, nullptr,
                 wxT( "Cannot parse " ) + GetTokenString( CurTok() ) + wxT( " as PCB_TRACK." ) );
 
    VECTOR2I                   pt;
    std::unique_ptr<PCB_TRACK> track = std::make_unique<PCB_TRACK>( m_board );
 
    for( T token = NextTok();  token != T_RIGHT;  token = NextTok() )
    {
        // Legacy locked flag
        if( token == T_locked )
        {
            track->SetLocked( true );
            token = NextTok();
        }
 
        if( token != T_LEFT )
            Expecting( T_LEFT );
 
        token = NextTok();
 
        switch( token )
        {
        case T_start:
            pt.x = parseBoardUnits( "start x" );
            pt.y = parseBoardUnits( "start y" );
            track->SetStart( pt );
            NeedRIGHT();
            break;
 
        case T_end:
            pt.x = parseBoardUnits( "end x" );
            pt.y = parseBoardUnits( "end y" );
            track->SetEnd( pt );
            NeedRIGHT();
            break;
 
        case T_width:
            track->SetWidth( parseBoardUnits( "width" ) );
            NeedRIGHT();
            break;
 
        case T_layer:
            track->SetLayer( parseBoardItemLayer() );
            NeedRIGHT();
            break;
 
        case T_layers:
            track->SetLayerSet( parseLayersForCuItemWithSoldermask() );
            break;
 
        case T_solder_mask_margin:
            track->SetLocalSolderMaskMargin( parseBoardUnits( "local solder mask margin value" ) );
            NeedRIGHT();
            break;
 
        case T_net:
            parseNet( track.get() );
            break;
 
        case T_tstamp:
        case T_uuid:
            NextTok();
            track->SetUuidDirect( CurStrToKIID() );
            NeedRIGHT();
            break;
 
        // We continue to parse the status field but it is no longer written
        case T_status:
            parseHex();
            NeedRIGHT();
            break;
 
        case T_locked:
            track->SetLocked( parseMaybeAbsentBool( true ) );
            break;
 
        case T_custom_property:
            parseCustomProperty( track.get() );
            break;
 
        default:
            Expecting( "start, end, width, layer, solder_mask_margin, net, tstamp, uuid or locked" );
        }
    }
 
    if( !IsCopperLayer( track->GetLayer() ) )
    {
        // No point in asserting; these usually come from hand-edited boards
        return nullptr;
    }
 
    return track.release();
}
 
 
PCB_VIA* PCB_IO_KICAD_SEXPR_PARSER::parsePCB_VIA()
{
    wxCHECK_MSG( CurTok() == T_via, nullptr,
                 wxT( "Cannot parse " ) + GetTokenString( CurTok() ) + wxT( " as PCB_VIA." ) );
 
    VECTOR2I                 pt;
    std::unique_ptr<PCB_VIA> via = std::make_unique<PCB_VIA>( m_board );
 
    // NB: all pre-padstack tokens are stored into the F_Cu layer.  For PADSTACK::MODE::NORMAL
    // this will be all there is.  For complex padstacks, the other values will get loaded from the
    // T_padstack record.
 
    // File format default is no-token == no-feature.
    via->Padstack().SetUnconnectedLayerMode( UNCONNECTED_LAYER_MODE::KEEP_ALL );
 
    // Versions before 10.0 had no protection features other than tenting, so those features must
    // be interpreted as OFF in legacy boards, not as unspecified (aka: inherit from board stackup)
    if( m_requiredVersion < 20250228 )
    {
        via->Padstack().FrontOuterLayers().has_covering = false;
        via->Padstack().BackOuterLayers().has_covering = false;
        via->Padstack().FrontOuterLayers().has_plugging = false;
        via->Padstack().BackOuterLayers().has_plugging = false;
        via->Padstack().Drill().is_filled = false;
        via->Padstack().Drill().is_capped = false;
    }
 
    for( T token = NextTok();  token != T_RIGHT;  token = NextTok() )
    {
        // Legacy locked
        if( token == T_locked )
        {
            via->SetLocked( true );
            token = NextTok();
        }
 
        if( token == T_LEFT )
            token = NextTok();
 
        switch( token )
        {
        case T_blind:
            via->SetViaType( VIATYPE::BLIND );
            break;
 
        case T_buried:
            via->SetViaType( VIATYPE::BURIED );
            break;
 
        case T_micro:
            via->SetViaType( VIATYPE::MICROVIA );
            break;
 
        case T_at:
            pt.x = parseBoardUnits( "start x" );
            pt.y = parseBoardUnits( "start y" );
            via->SetStart( pt );
            via->SetEnd( pt );
            NeedRIGHT();
            break;
 
        case T_size:
            via->SetWidth( F_Cu, parseBoardUnits( "via width" ) );
            NeedRIGHT();
            break;
 
        case T_drill:
            via->SetDrill( parseBoardUnits( "drill diameter" ) );
            NeedRIGHT();
            break;
 
        case T_layers:
        {
            PCB_LAYER_ID layer1, layer2;
            NextTok();
            layer1 = lookUpLayer( m_layerIndices );
            NextTok();
            layer2 = lookUpLayer( m_layerIndices );
            via->SetLayerPair( layer1, layer2 );
 
            if( layer1 == UNDEFINED_LAYER || layer2 == UNDEFINED_LAYER )
                Expecting( "layer name" );
 
            NeedRIGHT();
            break;
        }
 
        case T_net:
            parseNet( via.get() );
            break;
 
        case T_remove_unused_layers:
            if( parseMaybeAbsentBool( true ) )
                via->SetRemoveUnconnected( true );
 
            break;
 
        case T_keep_end_layers:
            if( parseMaybeAbsentBool( true ) )
                via->SetKeepStartEnd( true );
 
            break;
 
        case T_start_end_only:
            if( parseMaybeAbsentBool( true ) )
                via->Padstack().SetUnconnectedLayerMode( UNCONNECTED_LAYER_MODE::START_END_ONLY );
 
            break;
 
        case T_zone_layer_connections:
        {
            // Ensure only copper layers are stored int ZoneLayerOverride array
            LSET cuLayers = via->GetLayerSet() & LSET::AllCuMask();
 
            for( PCB_LAYER_ID layer : cuLayers )
                via->SetZoneLayerOverride( layer, ZLO_FORCE_NO_ZONE_CONNECTION );
 
            for( token = NextTok();  token != T_RIGHT;  token = NextTok() )
            {
                PCB_LAYER_ID layer = lookUpLayer( m_layerIndices );
 
                if( !IsCopperLayer( layer ) )
                    Expecting( "copper layer name" );
 
                via->SetZoneLayerOverride( layer, ZLO_FORCE_FLASHED );
            }
 
            break;
        }
 
        case T_padstack:
            parseViastack( via.get() );
            break;
 
        case T_teardrops:
            parseTEARDROP_PARAMETERS( &via->GetTeardropParams() );
            break;
 
        case T_tenting:
        {
            auto [front, back] = parseFrontBackOptBool( true );
            via->Padstack().FrontOuterLayers().has_solder_mask = front;
            via->Padstack().BackOuterLayers().has_solder_mask = back;
            break;
        }
 
        case T_covering:
        {
            auto [front, back] = parseFrontBackOptBool();
            via->Padstack().FrontOuterLayers().has_covering = front;
            via->Padstack().BackOuterLayers().has_covering = back;
            break;
        }
 
        case T_plugging:
        {
            auto [front, back] = parseFrontBackOptBool();
            via->Padstack().FrontOuterLayers().has_plugging = front;
            via->Padstack().BackOuterLayers().has_plugging = back;
            break;
        }
 
        case T_filling:
            via->Padstack().Drill().is_filled = parseOptBool();
            NeedRIGHT();
            break;
 
        case T_capping:
            via->Padstack().Drill().is_capped = parseOptBool();
            NeedRIGHT();
            break;
 
        case T_tstamp:
        case T_uuid:
            NextTok();
            via->SetUuidDirect( CurStrToKIID() );
            NeedRIGHT();
            break;
 
        // We continue to parse the status field but it is no longer written
        case T_status:
            parseHex();
            NeedRIGHT();
            break;
 
        case T_locked:
            via->SetLocked( parseMaybeAbsentBool( true ) );
            break;
 
        case T_free:
            via->SetIsFree( parseMaybeAbsentBool( true ) );
            break;
 
        case T_backdrill:
        {
            // Parse: (backdrill (size ...) (layers start end))
            PADSTACK::DRILL_PROPS& secondary = via->Padstack().SecondaryDrill();
 
            for( token = NextTok(); token != T_RIGHT; token = NextTok() )
            {
                if( token != T_LEFT )
                    Expecting( T_LEFT );
 
                token = NextTok();
 
                switch( token )
                {
                case T_size:
                {
                    int size = parseBoardUnits( "backdrill size" );
                    secondary.size = VECTOR2I( size, size );
                    NeedRIGHT();
                    break;
                }
 
                case T_layers:
                {
                    NextTok();
                    secondary.start = lookUpLayer( m_layerIndices );
                    NextTok();
                    secondary.end = lookUpLayer( m_layerIndices );
                    NeedRIGHT();
                    break;
                }
 
                default:
                    Expecting( "size or layers" );
                }
            }
 
            break;
        }
 
        case T_tertiary_drill:
        {
            // Parse: (tertiary_drill (size ...) (layers start end))
            PADSTACK::DRILL_PROPS& tertiary = via->Padstack().TertiaryDrill();
 
            for( token = NextTok(); token != T_RIGHT; token = NextTok() )
            {
                if( token != T_LEFT )
                    Expecting( T_LEFT );
 
                token = NextTok();
 
                switch( token )
                {
                case T_size:
                {
                    int size = parseBoardUnits( "tertiary drill size" );
                    tertiary.size = VECTOR2I( size, size );
                    NeedRIGHT();
                    break;
                }
 
                case T_layers:
                {
                    NextTok();
                    tertiary.start = lookUpLayer( m_layerIndices );
                    NextTok();
                    tertiary.end = lookUpLayer( m_layerIndices );
                    NeedRIGHT();
                    break;
                }
 
                default:
                    Expecting( "size or layers" );
                }
            }
 
            break;
        }
 
        case T_front_post_machining:
            parsePostMachining( via->Padstack().FrontPostMachining() );
            break;
 
        case T_back_post_machining:
            parsePostMachining( via->Padstack().BackPostMachining() );
            break;
 
        case T_custom_property:
            parseCustomProperty( via.get() );
            break;
 
        default:
            Expecting( "blind, micro, at, size, drill, layers, net, free, tstamp, uuid, status, "
                       "teardrops, backdrill, tertiary_drill, front_post_machining, or back_post_machining" );
        }
    }
 
    return via.release();
}
 
 
std::pair<std::optional<bool>, std::optional<bool>>
PCB_IO_KICAD_SEXPR_PARSER::parseFrontBackOptBool( bool aAllowLegacyFormat )
{
    T token = NextTok();
 
    std::pair<std::optional<bool>, std::optional<bool>> result;
    auto& [front, back] = result;
 
    if( token != T_LEFT && aAllowLegacyFormat )
    {
        // legacy format for tenting.
        while( token != T_RIGHT )
        {
            if( token == T_front )
            {
                front = true;
            }
            else if( token == T_back )
            {
                back = true;
            }
            else if( token == T_none )
            {
                front.reset();
                back.reset();
            }
            else
            {
                Expecting( "front, back or none" );
            }
 
            token = NextTok();
        }
 
        return result;
    }
 
    while( token != T_RIGHT )
    {
        if( token != T_LEFT )
            Expecting( "(" );
 
        token = NextTok();
 
        if( token == T_front )
            front = parseOptBool();
        else if( token == T_back )
            back = parseOptBool();
        else
            Expecting( "front or back" );
 
        NeedRIGHT();
 
        token = NextTok();
    }
 
    return result;
}
 
 
void PCB_IO_KICAD_SEXPR_PARSER::parseViastack( PCB_VIA* aVia )
{
    PADSTACK& padstack = aVia->Padstack();
 
    for( T token = NextTok(); token != T_RIGHT; token = NextTok() )
    {
        if( token != T_LEFT )
            Expecting( T_LEFT );
 
        token = NextTok();
 
        switch( token )
        {
        case T_mode:
            token = NextTok();
 
            switch( token )
            {
            case T_front_inner_back: padstack.SetMode( PADSTACK::MODE::FRONT_INNER_BACK ); break;
            case T_custom:           padstack.SetMode( PADSTACK::MODE::CUSTOM );           break;
            default:                 Expecting( "front_inner_back or custom" );
            }
 
            NeedRIGHT();
            break;
 
        case T_layer:
        {
            NextTok();
            PCB_LAYER_ID curLayer = UNDEFINED_LAYER;
 
            if( curText == "Inner" )
            {
                if( padstack.Mode() != PADSTACK::MODE::FRONT_INNER_BACK )
                {
                    THROW_IO_ERRORF( _( "Invalid padstack layer in\nfile: %s\nline: %d\noffset: %d." ),
                                     CurSource(), CurLineNumber(), CurOffset() );
                }
 
                curLayer = PADSTACK::INNER_LAYERS;
            }
            else
            {
                curLayer = lookUpLayer( m_layerIndices );
            }
 
            if( !IsCopperLayer( curLayer ) )
            {
                THROW_IO_ERRORF( _( "Invalid padstack layer '%s' in file '%s' at line %d, offset %d." ),
                                 curText, CurSource().GetData(), CurLineNumber(), CurOffset() );
            }
 
            for( token = NextTok(); token != T_RIGHT; token = NextTok() )
            {
                if( token != T_LEFT )
                    Expecting( T_LEFT );
 
                token = NextTok();
 
                switch( token )
                {
 
                case T_size:
                {
                    int diameter = parseBoardUnits( "via width" );
                    padstack.SetSize( { diameter, diameter }, curLayer );
                    NeedRIGHT();
                    break;
                }
 
                default:
                    // Currently only supporting custom via diameter per layer, not other properties
                    Expecting( "size" );
                }
            }
 
            break;
        }
 
        default:
            Expecting( "mode or layer" );
            break;
        }
    }
}
 
 
ZONE* PCB_IO_KICAD_SEXPR_PARSER::parseZONE( BOARD_ITEM_CONTAINER* aParent )
{
    wxCHECK_MSG( CurTok() == T_zone, nullptr,
                 wxT( "Cannot parse " ) + GetTokenString( CurTok() ) + wxT( " as ZONE." ) );
 
    ZONE_BORDER_DISPLAY_STYLE hatchStyle = ZONE_BORDER_DISPLAY_STYLE::NO_HATCH;
 
    int      hatchPitch = ZONE::GetDefaultHatchPitch();
    int      tmp;
    wxString legacyNetnameFromFile;    // the (non-authoratative) zone net name found in a legacy file
 
    // bigger scope since each filled_polygon is concatenated in here
    std::map<PCB_LAYER_ID, SHAPE_POLY_SET> pts;
    std::map<PCB_LAYER_ID, std::vector<SEG>> legacySegs;
    PCB_LAYER_ID filledLayer;
    bool         addedFilledPolygons = false;
 
    // This hasn't been supported since V6 or so, but we only stopped writing out the token
    // in V10.
    bool isStrokedFill = m_requiredVersion < 20250210;
 
    std::unique_ptr<ZONE> zone = std::make_unique<ZONE>( aParent );
 
    zone->SetAssignedPriority( 0 );
 
    // This is the default for board files:
    zone->SetIslandRemovalMode( ISLAND_REMOVAL_MODE::ALWAYS );
 
    // The ZONE ctor copies the board's default zone settings, but these tokens are
    // omitted from the file when at their defaults. Reset them so appending into a
    // live board (design block, paste) doesn't pick up its session defaults.
    zone->SetPadConnection( ZONE_CONNECTION::THERMAL );
    zone->SetFillMode( ZONE_FILL_MODE::POLYGONS );
    zone->SetCornerSmoothingType( ZONE_SETTINGS::CORNER_SMOOTHING::NO_SMOOTHING );
    zone->SetCornerRadius( 0 );
    zone->SetHatchSmoothingLevel( 0 );
    zone->SetLocked( false );
 
    for( T token = NextTok();  token != T_RIGHT;  token = NextTok() )
    {
        // legacy locked
        if( token == T_locked )
        {
            zone->SetLocked( true );
            token = NextTok();
        }
 
        if( token == T_LEFT )
            token = NextTok();
 
        switch( token )
        {
        case T_net:
            parseNet( zone.get() );
            break;
 
        case T_net_name:
            NeedSYMBOLorNUMBER();
            legacyNetnameFromFile = FromUTF8();
            NeedRIGHT();
            break;
 
        case T_layer:   // keyword for zones that are on only one layer
            zone->SetLayer( parseBoardItemLayer() );
            NeedRIGHT();
            break;
 
        case T_layers:  // keyword for zones that can live on a set of layers
            zone->SetLayerSet( parseBoardItemLayersAsMask() );
            break;
 
        case T_property:
            parseZoneLayerProperty( zone->LayerProperties() );
            break;
 
        case T_tstamp:
        case T_uuid:
            NextTok();
            zone->SetUuidDirect( CurStrToKIID() );
            NeedRIGHT();
            break;
 
        case T_hatch:
            token = NextTok();
 
            if( token != T_none && token != T_edge && token != T_full )
                Expecting( "none, edge, or full" );
 
            switch( token )
            {
            default:
            case T_none: hatchStyle = ZONE_BORDER_DISPLAY_STYLE::NO_HATCH;      break;
            case T_edge: hatchStyle = ZONE_BORDER_DISPLAY_STYLE::DIAGONAL_EDGE; break;
            case T_full: hatchStyle = ZONE_BORDER_DISPLAY_STYLE::DIAGONAL_FULL; break;
            }
 
            hatchPitch = parseBoardUnits( "hatch pitch" );
            NeedRIGHT();
            break;
 
        case T_priority:
            zone->SetAssignedPriority( parseInt( "zone priority" ) );
            NeedRIGHT();
            break;
 
        case T_connect_pads:
            for( token = NextTok();  token != T_RIGHT;  token = NextTok() )
            {
                if( token == T_LEFT )
                    token = NextTok();
 
                switch( token )
                {
                case T_yes:
                    zone->SetPadConnection( ZONE_CONNECTION::FULL );
                    break;
 
                case T_no:
                    zone->SetPadConnection( ZONE_CONNECTION::NONE );
                    break;
 
                case T_thru_hole_only:
                    zone->SetPadConnection( ZONE_CONNECTION::THT_THERMAL );
                    break;
 
                case T_clearance:
                    zone->SetLocalClearance( parseBoardUnits( "zone clearance" ) );
                    NeedRIGHT();
                    break;
 
                default:
                    Expecting( "yes, no, or clearance" );
                }
            }
 
            break;
 
        case T_min_thickness:
            zone->SetMinThickness( parseBoardUnits( T_min_thickness ) );
            NeedRIGHT();
            break;
 
        case T_filled_areas_thickness:
            // A new zone fill strategy was added in v6, so we need to know if we're parsing
            // a zone that was filled before that. Note that the change was implemented as
            // a new parameter, so we need to check for the  presence of filled_areas_thickness
            // instead of just its value.
 
            if( !parseBool() )
                isStrokedFill = false;
 
            NeedRIGHT();
            break;
 
        case T_fill:
            for( token = NextTok();  token != T_RIGHT;  token = NextTok() )
            {
                if( token == T_LEFT )
                    token = NextTok();
 
                switch( token )
                {
                case T_yes:
                    zone->SetIsFilled( true );
                    break;
 
                case T_mode:
                    token = NextTok();
 
                    if( token != T_segment && token != T_hatch && token != T_polygon
                            && token != T_thieving )
                    {
                        Expecting( "segment, hatch, polygon or thieving" );
                    }
 
                    switch( token )
                    {
                    case T_hatch:
                        zone->SetFillMode( ZONE_FILL_MODE::HATCH_PATTERN );
                        break;
 
                    case T_thieving:
                        if( m_requiredVersion < 20260513 )
                        {
                            Expecting( "segment, hatch or polygon "
                                       "(thieving requires file version >= 20260513)" );
                        }
 
                        zone->SetFillMode( ZONE_FILL_MODE::COPPER_THIEVING );
                        break;
 
                    case T_segment: // deprecated, convert to polygons
                    case T_polygon:
                    default:
                        zone->SetFillMode( ZONE_FILL_MODE::POLYGONS );
                        break;
                    }
 
                    NeedRIGHT();
                    break;
 
                case T_hatch_thickness:
                    zone->SetHatchThickness( parseBoardUnits( T_hatch_thickness ) );
                    NeedRIGHT();
                    break;
 
                case T_hatch_gap:
                    zone->SetHatchGap( parseBoardUnits( T_hatch_gap ) );
                    NeedRIGHT();
                    break;
 
                case T_hatch_orientation:
                {
                    EDA_ANGLE orientation( parseDouble( T_hatch_orientation ), DEGREES_T );
                    zone->SetHatchOrientation( orientation );
                    NeedRIGHT();
                    break;
                }
 
                case T_hatch_smoothing_level:
                    zone->SetHatchSmoothingLevel( parseDouble( T_hatch_smoothing_level ) );
                    NeedRIGHT();
                    break;
 
                case T_hatch_smoothing_value:
                    zone->SetHatchSmoothingValue( parseDouble( T_hatch_smoothing_value ) );
                    NeedRIGHT();
                    break;
 
                case T_hatch_border_algorithm:
                    token = NextTok();
 
                    if( token != T_hatch_thickness && token != T_min_thickness )
                        Expecting( "hatch_thickness or min_thickness" );
 
                    zone->SetHatchBorderAlgorithm( token == T_hatch_thickness ? 1 : 0 );
                    NeedRIGHT();
                    break;
 
                case T_hatch_min_hole_area:
                    zone->SetHatchHoleMinArea( parseDouble( T_hatch_min_hole_area ) );
                    NeedRIGHT();
                    break;
 
                case T_thieving:
                {
                    if( m_requiredVersion < 20260513 )
                    {
                        Expecting( "thieving requires file version >= 20260513" );
                    }
 
                    THIEVING_SETTINGS thieving = zone->GetThievingSettings();
 
                    for( token = NextTok(); token != T_RIGHT; token = NextTok() )
                    {
                        if( token == T_LEFT )
                            token = NextTok();
 
                        switch( token )
                        {
                        case T_type:
                            token = NextTok();
 
                            switch( token )
                            {
                            case T_dots:    thieving.pattern = THIEVING_PATTERN::DOTS;    break;
                            case T_squares: thieving.pattern = THIEVING_PATTERN::SQUARES; break;
                            case T_hatch:   thieving.pattern = THIEVING_PATTERN::HATCH;   break;
                            default:        Expecting( "dots, squares or hatch" );
                            }
 
                            NeedRIGHT();
                            break;
 
                        // Reject non-positive geometry inline.  Zero size would emit
                        // zero-area stamps and zero gap would deadlock the filler grid
                        // loop.  The zone's existing setting (constructor defaults)
                        // stays in place for any malformed field.
                        case T_size:
                        {
                            int val = parseBoardUnits( T_size );
 
                            if( val > 0 )
                                thieving.element_size = val;
 
                            NeedRIGHT();
                            break;
                        }
 
                        case T_gap:
                        {
                            int val = parseBoardUnits( T_gap );
 
                            if( val > 0 )
                                thieving.gap = val;
 
                            NeedRIGHT();
                            break;
                        }
 
                        case T_width:
                        {
                            int val = parseBoardUnits( T_width );
 
                            if( val > 0 )
                                thieving.line_width = val;
 
                            NeedRIGHT();
                            break;
                        }
 
                        case T_stagger:
                            thieving.stagger = parseBool();
                            NeedRIGHT();
                            break;
 
                        case T_orientation:
                            thieving.orientation = EDA_ANGLE( parseDouble( T_orientation ),
                                                              DEGREES_T );
                            NeedRIGHT();
                            break;
 
                        default:
                            Expecting( "type, size, gap, width, stagger or orientation" );
                        }
                    }
 
                    zone->SetThievingSettings( thieving );
                    break;
                }
 
                case T_arc_segments:
                    ignore_unused( parseInt( "arc segment count" ) );
                    NeedRIGHT();
                    break;
 
                case T_thermal_gap:
                    zone->SetThermalReliefGap( parseBoardUnits( T_thermal_gap ) );
                    NeedRIGHT();
                    break;
 
                case T_thermal_bridge_width:
                    zone->SetThermalReliefSpokeWidth( parseBoardUnits( T_thermal_bridge_width ) );
                    NeedRIGHT();
                    break;
 
                case T_smoothing:
                    switch( NextTok() )
                    {
                    case T_none:
                        zone->SetCornerSmoothingType( ZONE_SETTINGS::CORNER_SMOOTHING::NO_SMOOTHING );
                        break;
 
                    case T_chamfer:
                        if( !zone->GetIsRuleArea() ) // smoothing has meaning only for filled zones
                            zone->SetCornerSmoothingType( ZONE_SETTINGS::CORNER_SMOOTHING::CHAMFER );
 
                        break;
 
                    case T_fillet:
                        if( !zone->GetIsRuleArea() ) // smoothing has meaning only for filled zones
                            zone->SetCornerSmoothingType( ZONE_SETTINGS::CORNER_SMOOTHING::FILLET );
 
                        break;
 
                    default:
                        Expecting( "none, chamfer, or fillet" );
                    }
 
                    NeedRIGHT();
                    break;
 
                case T_radius:
                    tmp = parseBoardUnits( "corner radius" );
 
                    if( !zone->GetIsRuleArea() ) // smoothing has meaning only for filled zones
                       zone->SetCornerRadius( tmp );
 
                    NeedRIGHT();
                    break;
 
                case T_island_removal_mode:
                    tmp = parseInt( "island_removal_mode" );
 
                    if( tmp >= 0 && tmp <= 2 )
                        zone->SetIslandRemovalMode( static_cast<ISLAND_REMOVAL_MODE>( tmp ) );
 
                    NeedRIGHT();
                    break;
 
                case T_island_area_min:
                {
                    int area = parseBoardUnits( T_island_area_min );
                    zone->SetMinIslandArea( area * pcbIUScale.IU_PER_MM );
                    NeedRIGHT();
                    break;
                }
 
                default:
                    Expecting( "mode, arc_segments, thermal_gap, thermal_bridge_width, "
                               "hatch_thickness, hatch_gap, hatch_orientation, "
                               "hatch_smoothing_level, hatch_smoothing_value, "
                               "hatch_border_algorithm, hatch_min_hole_area, thieving, "
                               "smoothing, radius, island_removal_mode, or island_area_min" );
                }
            }
 
            break;
 
        case T_placement:
            zone->SetIsRuleArea( true );
 
            for( token = NextTok();  token != T_RIGHT;  token = NextTok() )
            {
                if( token == T_LEFT )
                    token = NextTok();
 
                switch( token )
                {
                case T_sheetname:
                {
                    zone->SetPlacementAreaSourceType( PLACEMENT_SOURCE_T::SHEETNAME );
                    NeedSYMBOL();
                    zone->SetPlacementAreaSource( FromUTF8() );
                    break;
                }
                case T_component_class:
                {
                    zone->SetPlacementAreaSourceType( PLACEMENT_SOURCE_T::COMPONENT_CLASS );
                    NeedSYMBOL();
                    zone->SetPlacementAreaSource( FromUTF8() );
                    break;
                }
                case T_group:
                {
                    zone->SetPlacementAreaSourceType( PLACEMENT_SOURCE_T::GROUP_PLACEMENT );
                    NeedSYMBOL();
                    zone->SetPlacementAreaSource( FromUTF8() );
                    break;
                }
                case T_enabled:
                {
                    token = NextTok();
 
                    if( token == T_yes )
                        zone->SetPlacementAreaEnabled( true );
                    else if( token == T_no )
                        zone->SetPlacementAreaEnabled( false );
                    else
                        Expecting( "yes or no" );
 
                    break;
                }
                case T_link:
                {
                    REPEAT_LAYOUT_OPTIONS opts;
 
                    NeedSYMBOL();
                    zone->SetLinkSet( KIID( CurStr() ) );
 
                    for( token = NextTok(); token != T_RIGHT; token = NextTok() )
                    {
                        if( token == T_LEFT )
                            token = NextTok();
 
                        switch( token )
                        {
                        case T_placement: opts.m_copyPlacement = parseBool(); break;
                        case T_routing: opts.m_copyRouting = parseBool(); break;
                        case T_connected_routing: opts.m_connectedRoutingOnly = parseBool(); break;
                        case T_other_items: opts.m_copyOtherItems = parseBool(); break;
                        case T_group_items: opts.m_groupItems = parseBool(); break;
                        case T_locked_items: opts.m_includeLockedItems = parseBool(); break;
                        case T_anchor:
                            NeedSYMBOL();
                            opts.m_anchor = KIID( CurStr() );
                            break;
                        default:
                            Expecting( "placement, routing, connected_routing, other_items, group_items, "
                                       "locked_items or anchor" );
                        }
 
                        NeedRIGHT();
                    }
 
                    zone->SetRepeatOptions( opts );
 
                    // The loop already consumed the closing paren
                    continue;
                }
                default:
                {
                    Expecting( "enabled, sheetname, component_class, group or link" );
                    break;
                }
                }
 
                NeedRIGHT();
            }
 
            break;
 
        case T_keepout:
            // "keepout" now means rule area, but the file token stays the same
            zone->SetIsRuleArea( true );
 
            // Initialize these two because their tokens won't appear in older files:
            zone->SetDoNotAllowPads( false );
            zone->SetDoNotAllowFootprints( false );
 
            for( token = NextTok();  token != T_RIGHT;  token = NextTok() )
            {
                if( token == T_LEFT )
                    token = NextTok();
 
                switch( token )
                {
                case T_tracks:
                    token = NextTok();
 
                    if( token != T_allowed && token != T_not_allowed )
                        Expecting( "allowed or not_allowed" );
 
                    zone->SetDoNotAllowTracks( token == T_not_allowed );
                    break;
 
                case T_vias:
                    token = NextTok();
 
                    if( token != T_allowed && token != T_not_allowed )
                        Expecting( "allowed or not_allowed" );
 
                    zone->SetDoNotAllowVias( token == T_not_allowed );
                    break;
 
                case T_copperpour:
                    token = NextTok();
 
                    if( token != T_allowed && token != T_not_allowed )
                        Expecting( "allowed or not_allowed" );
 
                    zone->SetDoNotAllowZoneFills( token == T_not_allowed );
                    break;
 
                case T_pads:
                    token = NextTok();
 
                    if( token != T_allowed && token != T_not_allowed )
                        Expecting( "allowed or not_allowed" );
 
                    zone->SetDoNotAllowPads( token == T_not_allowed );
                    break;
 
                case T_footprints:
                    token = NextTok();
 
                    if( token != T_allowed && token != T_not_allowed )
                        Expecting( "allowed or not_allowed" );
 
                    zone->SetDoNotAllowFootprints( token == T_not_allowed );
                    break;
 
                default:
                    Expecting( "tracks, vias or copperpour" );
                }
 
                NeedRIGHT();
            }
 
            break;
 
        case T_polygon:
        {
            SHAPE_LINE_CHAIN outline;
 
            NeedLEFT();
            token = NextTok();
 
            if( token != T_pts )
                Expecting( T_pts );
 
            for( token = NextTok(); token != T_RIGHT; token = NextTok() )
                parseOutlinePoints( outline );
 
            NeedRIGHT();
 
            outline.SetClosed( true );
 
            if( outline.PointCount() == 0 )
                break;
 
            // Remark: The first polygon is the main outline.
            // Others are holes inside the main outline.
            zone->AddPolygon( outline );
            break;
        }
 
        case T_filled_polygon:
            {
                // "(filled_polygon (pts"
                NeedLEFT();
                token = NextTok();
 
                if( token == T_layer )
                {
                    filledLayer = parseBoardItemLayer();
                    NeedRIGHT();
                    token = NextTok();
 
                    if( token != T_LEFT )
                        Expecting( T_LEFT );
 
                    token = NextTok();
                }
                else
                {
                    // for legacy, single-layer zones
                    filledLayer = zone->GetFirstLayer();
                }
 
                bool island = false;
 
                if( token == T_island )
                {
                    island = parseMaybeAbsentBool( true );
                    NeedLEFT();
                    token = NextTok();
                }
 
                if( token != T_pts )
                    Expecting( T_pts );
 
                if( !pts.count( filledLayer ) )
                    pts[filledLayer] = SHAPE_POLY_SET();
 
                SHAPE_POLY_SET& poly = pts.at( filledLayer );
 
                int idx = poly.NewOutline();
                SHAPE_LINE_CHAIN& chain = poly.Outline( idx );
 
                if( island )
                    zone->SetIsIsland( filledLayer, idx );
 
                for( token = NextTok();  token != T_RIGHT;  token = NextTok() )
                    parseOutlinePoints( chain );
 
                NeedRIGHT();
 
                addedFilledPolygons |= !poly.IsEmpty();
            }
 
            break;
 
        case T_fill_segments:
        {
            // Legacy segment fill
 
            for( token = NextTok(); token != T_RIGHT; token = NextTok() )
            {
                if( token != T_LEFT )
                    Expecting( T_LEFT );
 
                token = NextTok();
 
                if( token != T_pts )
                    Expecting( T_pts );
 
                // Legacy zones only had one layer
                filledLayer = zone->GetFirstLayer();
 
                SEG fillSegment;
 
                fillSegment.A = parseXY();
                fillSegment.B = parseXY();
 
                legacySegs[filledLayer].push_back( fillSegment );
 
                NeedRIGHT();
            }
 
            break;
        }
 
        case T_name:
            NextTok();
            zone->SetZoneName( FromUTF8() );
            NeedRIGHT();
            break;
 
        case T_attr:
            for( token = NextTok();  token != T_RIGHT;  token = NextTok() )
            {
                if( token == T_LEFT )
                    token = NextTok();
 
                switch( token )
                {
                case T_teardrop:
                    for( token = NextTok(); token != T_RIGHT; token = NextTok() )
                    {
                        if( token == T_LEFT )
                            token = NextTok();
 
                        switch( token )
                        {
                        case T_type:
                            token = NextTok();
 
                            if( token == T_padvia )
                                zone->SetTeardropAreaType( TEARDROP_TYPE::TD_VIAPAD );
                            else if( token == T_track_end )
                                zone->SetTeardropAreaType( TEARDROP_TYPE::TD_TRACKEND );
                            else
                                Expecting( "padvia or track_end" );
 
                            NeedRIGHT();
                            break;
 
                        default:
                            Expecting( "type" );
                        }
                    }
 
                    break;
 
                default:
                    Expecting( "teardrop" );
                }
            }
            break;
 
        case T_locked:
            zone->SetLocked( parseBool() );
            NeedRIGHT();
            break;
 
        case T_custom_property:
            parseCustomProperty( zone.get() );
            break;
 
        default:
            Expecting( "net, layer/layers, tstamp, hatch, priority, connect_pads, min_thickness, "
                       "fill, polygon, filled_polygon, fill_segments, attr, locked, uuid, or name" );
        }
    }
 
    if( zone->GetNumCorners() > 2 )
    {
        if( !zone->IsOnCopperLayer() )
        {
            //zone->SetFillMode( ZONE_FILL_MODE::POLYGONS );
            zone->SetNetCode( NETINFO_LIST::UNCONNECTED );
        }
 
        // Set hatch here, after outlines corners are read
        zone->SetBorderDisplayStyle( hatchStyle, hatchPitch, true );
    }
 
    if( addedFilledPolygons )
    {
        if( isStrokedFill && !zone->GetIsRuleArea() )
        {
            if( m_showLegacy5ZoneWarning )
            {
                m_parseWarnings.push_back( _( "Legacy zone fill strategy is not supported anymore.\n"
                                              "Zone fills will be converted on best-effort basis." ) );
 
                m_showLegacy5ZoneWarning = false;
            }
 
            if( zone->GetMinThickness() > 0 )
            {
                for( auto& [layer, polyset] : pts )
                {
                    polyset.InflateWithLinkedHoles( zone->GetMinThickness() / 2,
                                                    CORNER_STRATEGY::ROUND_ALL_CORNERS,
                                                    ARC_HIGH_DEF / 2 );
                }
            }
        }
 
        for( auto& [layer, polyset] : pts )
            zone->SetFilledPolysList( layer, polyset );
 
        zone->CalculateFilledArea();
    }
    else if( legacySegs.size() > 0 )
    {
        // No polygons, just segment fill?
        // Note RFB: This code might be removed if turns out this never existed for sexpr file
        // format or otherwise we should add a test case to the qa folder
 
        if( m_showLegacySegmentZoneWarning )
        {
            m_parseWarnings.push_back( _( "The legacy segment zone fill mode is no longer supported.\n"
                                          "Zone fills will be converted on a best-effort basis." ) );
 
            m_showLegacySegmentZoneWarning = false;
        }
 
 
        for( const auto& [layer, segments] : legacySegs )
        {
            SHAPE_POLY_SET layerFill;
 
            if( zone->HasFilledPolysForLayer( layer ) )
                layerFill = SHAPE_POLY_SET( *zone->GetFill( layer ) );
 
            for( const auto& seg : segments )
            {
                SHAPE_POLY_SET segPolygon;
 
                TransformOvalToPolygon( segPolygon, seg.A, seg.B, zone->GetMinThickness(),
                                        ARC_HIGH_DEF, ERROR_OUTSIDE );
 
                layerFill.BooleanAdd( segPolygon );
            }
 
 
            zone->SetFilledPolysList( layer, layerFill );
            zone->CalculateFilledArea();
        }
    }
 
 
    // Ensure keepout and non copper zones do not have a net
    // (which have no sense for these zones)
    // the netcode 0 is used for these zones
    bool zone_has_net = zone->IsOnCopperLayer() && !zone->GetIsRuleArea();
 
    if( !zone_has_net )
        zone->SetNetCode( NETINFO_LIST::UNCONNECTED );
 
    // In legacy files, ensure the zone net name is valid, and matches the net code
    if( m_board && !legacyNetnameFromFile.IsEmpty() && zone->GetNetname() != legacyNetnameFromFile )
    {
        // Can happens which old boards, with nonexistent nets ...
        // or after being edited by hand
        // We try to fix the mismatch.
        NETINFO_ITEM* net = m_board->FindNet( legacyNetnameFromFile );
 
        if( net )   // An existing net has the same net name. use it for the zone
        {
            zone->SetNetCode( net->GetNetCode() );
        }
        else    // Not existing net: add a new net to keep track of the zone netname
        {
            int newnetcode = m_board->GetNetCount();
            net = new NETINFO_ITEM( m_board, legacyNetnameFromFile, newnetcode );
            m_board->Add( net, ADD_MODE::INSERT, true );
 
            // Store the new code mapping
            pushValueIntoMap( newnetcode, net->GetNetCode() );
 
            // and update the zone netcode
            zone->SetNetCode( net->GetNetCode() );
        }
    }
 
    if( m_board && zone->IsTeardropArea() && m_requiredVersion < 20230517 )
        m_board->SetLegacyTeardrops( true );
 
    // Clear flags used in zone edition:
    zone->SetNeedRefill( false );
 
    // By UUID, since the caller may still discard the zone
    if( zone->GetLinkSet() != niluuid || zone->GetRepeatOptions().m_anchor != niluuid )
        m_linkedZones.insert( zone->m_Uuid );
 
    return zone.release();
}
 
 
PCB_POINT* PCB_IO_KICAD_SEXPR_PARSER::parsePCB_POINT()
{
    wxCHECK_MSG( CurTok() == T_point, nullptr,
                 wxT( "Cannot parse " ) + GetTokenString( CurTok() ) + wxT( " as PCB_POINT." ) );
 
    std::unique_ptr<PCB_POINT> point = std::make_unique<PCB_POINT>( nullptr );
 
    for( T token = NextTok(); token != T_RIGHT; token = NextTok() )
    {
        if( token == T_LEFT )
            token = NextTok();
 
        switch( token )
        {
        case T_at:
        {
            VECTOR2I pt;
            pt.x = parseBoardUnits( "point x position" );
            pt.y = parseBoardUnits( "point y position" );
            point->SetPosition( pt );
            NeedRIGHT();
            break;
        }
        case T_size:
        {
            point->SetSize( parseBoardUnits( "point size" ) );
            NeedRIGHT();
            break;
        }
        case T_layer:
        {
            point->SetLayer( parseBoardItemLayer() );
            NeedRIGHT();
            break;
        }
        case T_uuid:
        {
            NextTok();
            point->SetUuidDirect( CurStrToKIID() );
            NeedRIGHT();
            break;
        }
        case T_custom_property:
            parseCustomProperty( point.get() );
            break;
        default: Expecting( "at, size, layer or uuid" );
        }
    }
 
    return point.release();
}
 
 
PCB_TARGET* PCB_IO_KICAD_SEXPR_PARSER::parsePCB_TARGET()
{
    wxCHECK_MSG( CurTok() == T_target, nullptr,
                 wxT( "Cannot parse " ) + GetTokenString( CurTok() ) + wxT( " as PCB_TARGET." ) );
 
    VECTOR2I pt;
    T        token;
 
    std::unique_ptr<PCB_TARGET> target = std::make_unique<PCB_TARGET>( nullptr );
 
    for( token = NextTok();  token != T_RIGHT;  token = NextTok() )
    {
        if( token == T_LEFT )
            token = NextTok();
 
        switch( token )
        {
        case T_x:
            target->SetShape( 1 );
            break;
 
        case T_plus:
            target->SetShape( 0 );
            break;
 
        case T_at:
            pt.x = parseBoardUnits( "target x position" );
            pt.y = parseBoardUnits( "target y position" );
            target->SetPosition( pt );
            NeedRIGHT();
            break;
 
        case T_size:
            target->SetSize( parseBoardUnits( "target size" ) );
            NeedRIGHT();
            break;
 
        case T_width:
            target->SetWidth( parseBoardUnits( "target thickness" ) );
            NeedRIGHT();
            break;
 
        case T_layer:
            target->SetLayer( parseBoardItemLayer() );
            NeedRIGHT();
            break;
 
        case T_tstamp:
        case T_uuid:
            NextTok();
            target->SetUuidDirect( CurStrToKIID() );
            NeedRIGHT();
            break;
 
        case T_custom_property:
            parseCustomProperty( target.get() );
            break;
 
        default:
            Expecting( "x, plus, at, size, width, layer, uuid, or tstamp" );
        }
    }
 
    return target.release();
}
 
 
PCB_GRID_ITEM* PCB_IO_KICAD_SEXPR_PARSER::parsePCB_GRID_ITEM()
{
    wxCHECK_MSG( CurTok() == T_grid_item, nullptr,
                 wxT( "Cannot parse " ) + GetTokenString( CurTok() ) + wxT( " as PCB_GRID_ITEM." ) );
 
    VECTOR2I pt;
    T        token;
 
    std::unique_ptr<PCB_GRID_ITEM> griditem = std::make_unique<PCB_GRID_ITEM>( nullptr );
 
    for( token = NextTok(); token != T_RIGHT; token = NextTok() )
    {
        if( token == T_LEFT )
            token = NextTok();
 
        switch( token )
        {
        case T_xy:
            griditem->SetGridItemType( PCB_GRID_TYPE::CARTESIAN );
            break;
 
        case T_polar:
            griditem->SetGridItemType( PCB_GRID_TYPE::POLAR );
            break;
 
        case T_at:
            pt.x = parseBoardUnits( "grid_item x position" );
            pt.y = parseBoardUnits( "grid_item y position" );
            griditem->SetPosition( pt );
            NeedRIGHT();
            break;
 
        case T_spacing:
            // Writer emits the grid type before extent/spacing, so the type is set here.
            // Polar y is an angle; cartesian y is a length.
            if( griditem->GetGridItemType() == PCB_GRID_TYPE::POLAR )
            {
                griditem->SetRadiusSpacing( parseBoardUnits( "grid_item radius spacing" ) );
                griditem->SetPhiSpacingDegrees( parseDouble( "grid_item phi spacing" ) );
            }
            else
            {
                pt.x = parseBoardUnits( "grid_item x spacing" );
                pt.y = parseBoardUnits( "grid_item y spacing" );
                griditem->SetSpacing( pt );
            }
            NeedRIGHT();
            break;
 
        case T_extent:
            if( griditem->GetGridItemType() == PCB_GRID_TYPE::POLAR )
            {
                griditem->SetRadiusExtent( parseBoardUnits( "grid_item radius extent" ) );
                griditem->SetPhiExtentDegrees( parseDouble( "grid_item phi extent" ) );
            }
            else
            {
                pt.x = parseBoardUnits( "grid_item x extent" );
                pt.y = parseBoardUnits( "grid_item y extent" );
                griditem->SetExtent( pt );
            }
            NeedRIGHT();
            break;
 
        case T_angle:
            griditem->SetOrientationDegrees( parseDouble( "grid_item orientation" ) );
            NeedRIGHT();
            break;
 
        case T_priority:
            griditem->SetAssignedPriority( static_cast<unsigned>( parseInt( "grid_item priority" ) ) );
            NeedRIGHT();
            break;
 
        case T_tick_interval:
            griditem->SetTickInterval( static_cast<unsigned>( parseInt( "grid_item tick_interval" ) ) );
            NeedRIGHT();
            break;
 
        case T_affects:
        {
            // (affects (cursor yes|no) (routing yes|no) (placement yes|no))
            PCB_GRID_AFFECTS aff;
            aff.SetAll( false );
 
            for( token = NextTok(); token != T_RIGHT; token = NextTok() )
            {
                if( token != T_LEFT )
                    Expecting( "cursor, routing or placement" );
 
                token = NextTok();
                bool* target = nullptr;
 
                switch( token )
                {
                case T_cursor: target = &aff.cursor; break;
                case T_routing: target = &aff.routing; break;
                case T_placement: target = &aff.placement; break;
                default: Expecting( "cursor, routing or placement" );
                }
 
                *target = parseBool();
                NeedRIGHT();
            }
 
            griditem->Affects() = aff;
            break;
        }
 
        case T_locked:
            griditem->SetLocked( parseBool() );
            NeedRIGHT();
            break;
 
        case T_uuid:
            NextTok();
            const_cast<KIID&>( griditem->m_Uuid ) = CurStrToKIID();
            NeedRIGHT();
            break;
 
        case T_custom_property:
            parseCustomProperty( griditem.get() );
            break;
 
        default:
            Expecting( "xy, polar, at, spacing, extent, angle, priority, tick_interval, "
                       "affects, locked or uuid" );
        }
    }
 
    return griditem.release();
}
 
 
KIID PCB_IO_KICAD_SEXPR_PARSER::CurStrToKIID()
{
    KIID aId;
    std::string idStr( CurStr() );
 
    // Older files did not quote UUIDs
    if( *idStr.begin() == '"' && *idStr.rbegin() == '"' )
        idStr = idStr.substr( 1, idStr.length() - 1 );
 
    if( m_appendToExisting )
    {
        aId = KIID();
        m_resetKIIDMap.insert( std::make_pair( idStr, aId ) );
    }
    else
    {
        aId = KIID( idStr );
    }
 
    return aId;
}