panel_setup_rules.cpp

Go to the documentation of this file.

/*
 * This program source code file is part of KiCad, a free EDA CAD application.
 *
 * 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 <bitmaps.h>
#include <common.h>
#include <confirm.h>
#include <kiplatform/io.h>
#include <widgets/std_bitmap_button.h>
#include <widgets/paged_dialog.h>
#include <pcb_edit_frame.h>
#include <pcbexpr_evaluator.h>
#include <board.h>
#include <board_design_settings.h>
#include <drc/drc_engine.h>
#include <project/net_settings.h>
#include <settings/common_settings.h>
#include <project.h>
#include <string_utils.h>
#include <tool/tool_manager.h>
#include <panel_setup_rules.h>
#include <widgets/wx_html_report_box.h>
#include <dialogs/html_message_box.h>
#include <scintilla_tricks.h>
#include <drc/drc_rule.h>
#include <drc/drc_rule_condition.h>
#include <drc/drc_rule_parser.h>
#include <tools/drc_tool.h>
#include <pgm_base.h>
#include <wildcards_and_files_ext.h>
#include <regex>
#include <unordered_map>
#include <properties/property.h>
#include <properties/property_mgr.h>
 
PANEL_SETUP_RULES::PANEL_SETUP_RULES( wxWindow* aParentWindow, PCB_EDIT_FRAME* aFrame ) :
        PANEL_SETUP_RULES_BASE( aParentWindow ),
        m_frame( aFrame ),
        m_scintillaTricks( nullptr ),
        m_helpWindow( nullptr )
{
    m_scintillaTricks = new SCINTILLA_TRICKS( m_textEditor, wxT( "()" ), false,
            // onAcceptFn
            [this]( wxKeyEvent& aEvent )
            {
                wxPostEvent( PAGED_DIALOG::GetDialog( this ),
                             wxCommandEvent( wxEVT_COMMAND_BUTTON_CLICKED, wxID_OK ) );
            },
            // onCharFn
            [this]( wxStyledTextEvent& aEvent )
            {
                onScintillaCharAdded( aEvent );
            } );
 
    m_textEditor->AutoCompSetSeparator( '|' );
 
    m_netClassRegex.Compile( "^NetClass\\s*[!=]=\\s*$", wxRE_ADVANCED );
    m_netNameRegex.Compile( "^NetName\\s*[!=]=\\s*$", wxRE_ADVANCED );
    m_typeRegex.Compile( "^Type\\s*[!=]=\\s*$", wxRE_ADVANCED );
    m_viaTypeRegex.Compile( "^Via_Type\\s*[!=]=\\s*$", wxRE_ADVANCED );
    m_padTypeRegex.Compile( "^Pad_Type\\s*[!=]=\\s*$", wxRE_ADVANCED );
    m_pinTypeRegex.Compile( "^Pin_Type\\s*[!=]=\\s*$", wxRE_ADVANCED );
    m_fabPropRegex.Compile( "^Fabrication_Property\\s*[!=]=\\s*$", wxRE_ADVANCED );
    m_shapeRegex.Compile( "^Shape\\s*[!=]=\\s*$", wxRE_ADVANCED );
    m_padShapeRegex.Compile( "^Pad_Shape\\s*[!=]=\\s*$", wxRE_ADVANCED );
    m_padConnectionsRegex.Compile( "^Pad_Connections\\s*[!=]=\\s*$", wxRE_ADVANCED );
    m_zoneConnStyleRegex.Compile( "^Zone_Connection_Style\\s*[!=]=\\s*$", wxRE_ADVANCED );
    m_lineStyleRegex.Compile( "^Line_Style\\s*[!=]=\\s*$", wxRE_ADVANCED );
    m_hJustRegex.Compile( "^Horizontal_Justification\\s*[!=]=\\s*$", wxRE_ADVANCED );
    m_vJustRegex.Compile( "^Vertical_Justification\\s*[!=]=\\s*$", wxRE_ADVANCED );
 
    m_compileButton->SetBitmap( KiBitmapBundle( BITMAPS::drc ) );
 
    m_textEditor->SetZoom( Pgm().GetCommonSettings()->m_Appearance.text_editor_zoom );
 
    m_textEditor->UsePopUp( 0 );
    m_textEditor->Bind( wxEVT_CHAR_HOOK, &PANEL_SETUP_RULES::onCharHook, this );
}
 
 
PANEL_SETUP_RULES::~PANEL_SETUP_RULES( )
{
    m_textEditor->Unbind( wxEVT_CHAR_HOOK, &PANEL_SETUP_RULES::onCharHook, this );
    Pgm().GetCommonSettings()->m_Appearance.text_editor_zoom = m_textEditor->GetZoom();
 
    delete m_scintillaTricks;
    m_scintillaTricks = nullptr;
 
    if( m_helpWindow )
        m_helpWindow->Destroy();
};
 
 
void PANEL_SETUP_RULES::onCharHook( wxKeyEvent& aEvent )
{
    if( aEvent.GetKeyCode() == WXK_ESCAPE && !m_textEditor->AutoCompActive() )
    {
        if( m_originalText != m_textEditor->GetText() )
        {
            if( IsOK( wxGetTopLevelParent( this ), _( "Cancel Changes?" ) ) )
            {
                m_textEditor->SetText( m_originalText );
                m_textEditor->SelectAll();
            }
 
            return;
        }
    }
 
    aEvent.Skip();
}
 
 
void PANEL_SETUP_RULES::OnContextMenu(wxMouseEvent &event)
{
    wxMenu   menu;
 
    menu.Append( wxID_UNDO, _( "Undo" ) );
    menu.Append( wxID_REDO, _( "Redo" ) );
 
    menu.AppendSeparator();
 
    menu.Append( 1, _( "Cut" ) );       // Don't use wxID_CUT, wxID_COPY, etc.  On Mac (at least),
    menu.Append( 2, _( "Copy" ) );      // wxWidgets never delivers them to us.
    menu.Append( 3, _( "Paste" ) );
    menu.Append( 4, _( "Delete" ) );
 
    menu.AppendSeparator();
 
    menu.Append( 5, _( "Select All" ) );
 
    menu.AppendSeparator();
 
    menu.Append( wxID_ZOOM_IN, _( "Zoom In" ) );
    menu.Append( wxID_ZOOM_OUT, _( "Zoom Out" ) );
 
    menu.AppendSeparator();
 
    menu.Append( 6, _( "Show Matching Items" ) );
 
    switch( GetPopupMenuSelectionFromUser( menu ) )
    {
    case wxID_UNDO:
        m_textEditor->Undo();
        break;
    case wxID_REDO:
        m_textEditor->Redo();
        break;
 
    case 1:
        m_textEditor->Cut();
        break;
    case 2:
        m_textEditor->Copy();
        break;
    case 3:
        m_textEditor->Paste();
        break;
    case 4:
    {
        long from, to;
        m_textEditor->GetSelection( &from, &to );
 
        if( to > from )
            m_textEditor->DeleteRange( from, to );
 
        break;
    }
 
    case 5:
        m_textEditor->SelectAll();
        break;
 
    case wxID_ZOOM_IN:
        m_textEditor->ZoomIn();
        break;
    case wxID_ZOOM_OUT:
        m_textEditor->ZoomOut();
        break;
 
    case 6: OnShowMatching(); break;
    }
}
 
 
void PANEL_SETUP_RULES::OnShowMatching()
{
    m_errorsReport->Clear();
 
    if( m_frame->Prj().IsNullProject() )
    {
        m_errorsReport->Report( _( "Cannot show matching items without an open project." ), RPT_SEVERITY_ERROR );
        m_errorsReport->Flush();
        return;
    }
 
    const wxString text = m_textEditor->GetText();
    const int      cursorPos = m_textEditor->GetCurrentPos();
    const int      cursorLine = m_textEditor->LineFromPosition( cursorPos ) + 1;
    const int      cursorCol = cursorPos - m_textEditor->PositionFromLine( cursorLine - 1 ) + 1;
 
    std::vector<std::shared_ptr<DRC_RULE>> rules;
 
    try
    {
        std::function<bool( wxString* )> resolver =
                [&]( wxString* token ) -> bool
                {
                    if( IsComponentClassSelector( *token ) )
                        return false;
 
                    return m_frame->GetBoard()->ResolveTextVar( token, 0 );
                };
 
        wxString rulesText = m_frame->GetBoard()->ConvertCrossReferencesToKIIDs( text );
        rulesText = ExpandTextVars( rulesText, &resolver );
 
        DRC_RULES_PARSER parser( rulesText, _( "DRC rules" ) );
        parser.Parse( rules, m_errorsReport );
    }
    catch( PARSE_ERROR& pe )
    {
        m_errorsReport->Report( wxString::Format( wxT( "%s <a href='%d:%d'>%s</a>%s" ), _( "ERROR:" ), pe.lineNumber,
                                                  pe.byteIndex, pe.ParseProblem(), wxEmptyString ),
                                RPT_SEVERITY_ERROR );
        m_errorsReport->Flush();
        return;
    }
 
    wxString targetRuleName;
    bool     foundRule = false;
 
    try
    {
        std::string     utf8( text.mb_str( wxConvUTF8 ) );
        DRC_RULES_LEXER lex( utf8, _( "DRC rules" ) );
 
        struct RuleFrame
        {
            int      depth;
            int      startLine;
            int      startCol;
            wxString name;
        };
 
        std::vector<RuleFrame> ruleStack;
        int                    depth = 0;
 
        for( ;; )
        {
            int tok = lex.NextTok();
 
            if( tok == DSN_EOF )
                break;
 
            if( tok == DSN_LEFT )
            {
                int leftLine = lex.CurLineNumber();
                int leftCol = lex.CurOffset();
 
                depth++;
 
                int sub = lex.NextTok();
 
                if( sub == DRCRULE_T::T_rule )
                {
                    wxString name;
                    int      nameTok = lex.NextTok();
 
                    if( DSNLEXER::IsSymbol( nameTok ) )
                        name = wxString::FromUTF8( lex.CurText() );
 
                    ruleStack.push_back( { depth, leftLine, leftCol, name } );
                }
                else if( sub == DSN_LEFT )
                {
                    depth++;
                }
                else if( sub == DSN_RIGHT )
                {
                    depth--;
                }
                else if( sub == DSN_EOF )
                {
                    break;
                }
            }
            else if( tok == DSN_RIGHT )
            {
                if( !ruleStack.empty() && ruleStack.back().depth == depth )
                {
                    RuleFrame opened = ruleStack.back();
                    ruleStack.pop_back();
 
                    int endLine = lex.CurLineNumber();
                    int endCol = lex.CurOffset();
 
                    bool afterStart = cursorLine > opened.startLine
                                      || ( cursorLine == opened.startLine && cursorCol >= opened.startCol );
                    bool beforeEnd = cursorLine < endLine || ( cursorLine == endLine && cursorCol <= endCol );
 
                    if( afterStart && beforeEnd )
                    {
                        targetRuleName = opened.name;
                        foundRule = true;
                        break;
                    }
                }
 
                depth--;
            }
        }
    }
    catch( IO_ERROR& e )
    {
        m_errorsReport->Report( wxString::Format( _( "Could not scan rules text: %s" ), e.What() ),
                                RPT_SEVERITY_ERROR );
        m_errorsReport->Flush();
        return;
    }
 
    if( !foundRule )
    {
        m_errorsReport->Report( _( "Place the cursor inside a (rule ...) block to show matching "
                                   "items." ),
                                RPT_SEVERITY_ACTION );
        m_errorsReport->Flush();
        return;
    }
 
    if( targetRuleName.IsEmpty() )
    {
        m_errorsReport->Report( _( "The rule under the cursor has no name; add a name to identify "
                                   "it." ),
                                RPT_SEVERITY_ERROR );
        m_errorsReport->Flush();
        return;
    }
 
    std::shared_ptr<DRC_RULE> targetRule;
 
    for( const auto& rule : rules )
    {
        if( rule->m_Name == targetRuleName )
        {
            targetRule = rule;
            break;
        }
    }
 
    if( !targetRule )
    {
        m_errorsReport->Report( wxString::Format( _( "Rule '%s' could not be located after "
                                                     "parsing." ),
                                                  targetRuleName ),
                                RPT_SEVERITY_ERROR );
        m_errorsReport->Flush();
        return;
    }
 
    if( targetRule->m_Condition && !targetRule->m_Condition->GetExpression().IsEmpty()
        && !targetRule->m_Condition->Compile( m_errorsReport ) )
    {
        m_errorsReport->Flush();
        return;
    }
 
    std::shared_ptr<DRC_ENGINE> engine = m_frame->GetBoard()->GetDesignSettings().m_DRCEngine;
 
    if( !engine )
    {
        m_errorsReport->Report( _( "DRC engine not available." ), RPT_SEVERITY_ERROR );
        m_errorsReport->Flush();
        return;
    }
 
    std::vector<BOARD_ITEM*> allMatches = engine->GetItemsMatchingRule( targetRule, m_errorsReport );
 
    std::vector<BOARD_ITEM*> matches;
 
    for( BOARD_ITEM* item : allMatches )
    {
        switch( item->Type() )
        {
        case PCB_NETINFO_T:
        case PCB_GENERATOR_T:
        case PCB_GROUP_T: continue;
        default: matches.push_back( item ); break;
        }
    }
 
    m_frame->FocusOnItems( matches );
 
    m_errorsReport->Report(
            wxString::Format( _( "Rule '%s': %zu matching item(s)." ), targetRule->m_Name, matches.size() ),
            RPT_SEVERITY_INFO );
    m_errorsReport->Flush();
}
 
 
void PANEL_SETUP_RULES::onScintillaCharAdded( wxStyledTextEvent &aEvent )
{
    if( aEvent.GetModifiers() == wxMOD_CONTROL && aEvent.GetKey() == ' ' )
    {
        // This is just a short-cut for do-auto-complete
    }
    else
    {
        PAGED_DIALOG::GetDialog( this )->SetModified();
    }
 
    m_textEditor->SearchAnchor();
 
    int currentPos = m_textEditor->GetCurrentPos();
    int startPos = 0;
 
    for( int line = m_textEditor->LineFromPosition( currentPos ); line > 0; line-- )
    {
        int      lineStart = m_textEditor->PositionFromLine( line );
        wxString beginning = m_textEditor->GetTextRange( lineStart, lineStart + 10 );
 
        if( beginning.StartsWith( wxT( "(rule " ) ) )
        {
            startPos = lineStart;
            break;
        }
    }
 
    enum
    {
        NO_CONTEXT,
        STRING,
        SEXPR_OPEN,
        SEXPR_TOKEN,
        SEXPR_STRING,
        STRUCT_REF
    };
 
    auto isDisallowToken =
            []( const wxString& token ) -> bool
            {
                return token == wxT( "blind_via" )
                    || token == wxT( "buried_via" )
                    || token == wxT( "graphic" )
                    || token == wxT( "hole" )
                    || token == wxT( "micro_via" )
                    || token == wxT( "pad" )
                    || token == wxT( "text" )
                    || token == wxT( "through_via" )
                    || token == wxT( "track" )
                    || token == wxT( "via" )
                    || token == wxT( "zone" );
            };
 
    auto isConstraintTypeToken =
            []( const wxString& token ) -> bool
            {
                return token == wxT( "annular_width" )
                    || token == wxT( "assertion" )
                    || token == wxT( "clearance" )
                    || token == wxT( "connection_width" )
                    || token == wxT( "courtyard_clearance" )
                    || token == wxT( "diff_pair_gap" )
                    || token == wxT( "diff_pair_uncoupled" )
                    || token == wxT( "disallow" )
                    || token == wxT( "edge_clearance" )
                    || token == wxT( "length" )
                    || token == wxT( "hole_clearance" )
                    || token == wxT( "hole_size" )
                    || token == wxT( "hole_to_hole" )
                    || token == wxT( "min_resolved_spokes" )
                    || token == wxT( "physical_clearance" )
                    || token == wxT( "physical_hole_clearance" )
                    || token == wxT( "silk_clearance" )
                    || token == wxT( "skew" )
                    || token == wxT( "solder_mask_expansion" )
                    || token == wxT( "solder_paste_abs_margin" )
                    || token == wxT( "solder_paste_rel_margin" )
                    || token == wxT( "text_height" )
                    || token == wxT( "text_thickness" )
                    || token == wxT( "thermal_relief_gap" )
                    || token == wxT( "thermal_spoke_width" )
                    || token == wxT( "track_width" )
                    || token == wxT( "track_angle" )
                    || token == wxT( "track_segment_length" )
                    || token == wxT( "via_count" )
                    || token == wxT( "via_diameter" )
                    || token == wxT( "zone_connection" );
            };
 
    std::stack<wxString> sexprs;
    wxString             partial;
    wxString             last;
    wxString             constraintType;
    int                  context = NO_CONTEXT;
    int                  expr_context = NO_CONTEXT;
 
    for( int i = startPos; i < currentPos; ++i )
    {
        wxChar c = m_textEditor->GetCharAt( i );
 
        if( c == '\\' )
        {
            i++;  // skip escaped char
        }
        else if( context == STRING )
        {
            if( c == '"' )
            {
                context = NO_CONTEXT;
            }
            else
            {
                if( expr_context == STRING )
                {
                    if( c == '\'' )
                        expr_context = NO_CONTEXT;
                    else
                        partial += c;
                }
                else if( c == '\'' )
                {
                    last = partial;
                    partial = wxEmptyString;
                    expr_context = STRING;
                }
                else if( c == '.' )
                {
                    partial = wxEmptyString;
                    expr_context = STRUCT_REF;
                }
                else
                {
                    partial += c;
                }
            }
        }
        else if( c == '"' )
        {
            last = partial;
            partial = wxEmptyString;
            context = STRING;
        }
        else if( c == '(' )
        {
            if( context == SEXPR_OPEN && !partial.IsEmpty() )
            {
                m_textEditor->AutoCompCancel();
                sexprs.push( partial );
            }
 
            partial = wxEmptyString;
            context = SEXPR_OPEN;
        }
        else if( c == ')' )
        {
            while( !sexprs.empty() && ( sexprs.top() == wxT( "assertion" )
                                     || sexprs.top() == wxT( "disallow" )
                                     || isDisallowToken( sexprs.top() )
                                     || sexprs.top() == wxT( "min_resolved_spokes" )
                                     || sexprs.top() == wxT( "zone_connection" ) ) )
            {
                sexprs.pop();
            }
 
            if( !sexprs.empty() )
            {
                // Ignore argument-less tokens
                if( partial == wxT( "within_diff_pairs" ) )
                {
                    partial = wxEmptyString;
                }
                else
                {
                    if( sexprs.top() == wxT( "constraint" ) )
                    {
                        constraintType = wxEmptyString;
                    }
 
                    sexprs.pop();
                }
            }
 
            context = NO_CONTEXT;
        }
        else if( c == ' ' )
        {
            if( context == SEXPR_OPEN && !partial.IsEmpty() )
            {
                m_textEditor->AutoCompCancel();
                sexprs.push( partial );
 
                if(    partial == wxT( "constraint" )
                    || partial == wxT( "layer" )
                    || partial == wxT( "severity" ) )
                {
                    context = SEXPR_TOKEN;
                }
                else if( partial == wxT( "rule" )
                      || partial == wxT( "condition" ) )
                {
                    context = SEXPR_STRING;
                }
                else
                {
                    context = NO_CONTEXT;
                }
 
                partial = wxEmptyString;
                continue;
            }
            else if( partial == wxT( "disallow" )
                  || isDisallowToken( partial )
                  || partial == wxT( "min_resolved_spokes" )
                  || partial == wxT( "zone_connection" ) )
            {
                m_textEditor->AutoCompCancel();
                sexprs.push( partial );
 
                partial = wxEmptyString;
                context = SEXPR_TOKEN;
                continue;
            }
            else if( partial == wxT( "assertion" ) )
            {
                m_textEditor->AutoCompCancel();
                sexprs.push( partial );
 
                partial = wxEmptyString;
                context = SEXPR_STRING;
                continue;
            }
            else if( isConstraintTypeToken( partial ) )
            {
                constraintType = partial;
            }
 
            context = NO_CONTEXT;
        }
        else
        {
            partial += c;
        }
    }
 
    wxString tokens;
 
    if( context == SEXPR_OPEN )
    {
        if( sexprs.empty() )
        {
            tokens = wxT( "rule|"
                          "version" );
        }
        else if( sexprs.top() == wxT( "rule" ) )
        {
            tokens = wxT( "condition|"
                          "constraint|"
                          "layer|"
                          "severity" );
        }
        else if( sexprs.top() == wxT( "constraint" ) )
        {
            if( constraintType == wxT( "skew" ) )
                tokens = wxT( "max|min|opt|within_diff_pairs" );
            else
                tokens = wxT( "max|min|opt" );
        }
    }
    else if( context == SEXPR_TOKEN )
    {
        if( sexprs.empty() )
        {
            /* badly formed grammar */
        }
        else if( sexprs.top() == wxT( "constraint" ) )
        {
            tokens = wxT( "annular_width|"
                          "assertion|"
                          "bridged_mask|"
                          "clearance|"
                          "connection_width|"
                          "courtyard_clearance|"
                          "creepage|"
                          "diff_pair_gap|"
                          "diff_pair_uncoupled|"
                          "disallow|"
                          "edge_clearance|"
                          "length|"
                          "hole_clearance|"
                          "hole_size|"
                          "hole_to_hole|"
                          "min_resolved_spokes|"
                          "physical_clearance|"
                          "physical_hole_clearance|"
                          "silk_clearance|"
                          "skew|"
                          "solder_mask_expansion|"
                          "solder_paste_abs_margin|"
                          "solder_paste_rel_margin|"
                          "text_height|"
                          "text_thickness|"
                          "thermal_relief_gap|"
                          "thermal_spoke_width|"
                          "track_width|"
                          "track_angle|"
                          "track_segment_length|"
                          "via_count|"
                          "via_diameter|"
                          "zone_connection" );
        }
        else if( sexprs.top() == wxT( "disallow" ) || isDisallowToken( sexprs.top() ) )
        {
            tokens = wxT( "blind_via|"
                          "buried_via|"
                          "footprint|"
                          "graphic|"
                          "hole|"
                          "micro_via|"
                          "pad|"
                          "text|"
                          "through_via|"
                          "track|"
                          "via|"
                          "zone" );
        }
        else if( sexprs.top() == wxT( "zone_connection" ) )
        {
            tokens = wxT( "none|solid|thermal_reliefs" );
        }
        else if( sexprs.top() == wxT( "min_resolved_spokes" ) )
        {
            tokens = wxT( "0|1|2|3|4" );
        }
        else if( sexprs.top() == wxT( "layer" ) )
        {
            tokens = wxT( "inner|outer|\"x\"" );
        }
        else if( sexprs.top() == wxT( "severity" ) )
        {
            tokens = wxT( "warning|error|ignore|exclusion" );
        }
    }
    else if( context == SEXPR_STRING && !sexprs.empty()
            && ( sexprs.top() == wxT( "condition" ) || sexprs.top() == wxT( "assertion" ) ) )
    {
        m_textEditor->AddText( wxT( "\"" ) );
    }
    else if( context == STRING && !sexprs.empty()
            && ( sexprs.top() == wxT( "condition" ) || sexprs.top() == wxT( "assertion" ) ) )
    {
        if( expr_context == STRUCT_REF )
        {
            PROPERTY_MANAGER&  propMgr = PROPERTY_MANAGER::Instance();
            std::set<wxString> propNames;
 
            for( const PROPERTY_MANAGER::CLASS_INFO& cls : propMgr.GetAllClasses() )
            {
                const std::vector<PROPERTY_BASE*>& props = propMgr.GetProperties( cls.type );
 
                for( PROPERTY_BASE* prop : props )
                {
                    // TODO: It would be nice to replace IsHiddenFromRulesEditor with a nickname
                    // system, so that two different properies don't need to be created.  This is
                    // a bigger change than I want to make right now, though.
                    if( prop->IsHiddenFromRulesEditor() )
                        continue;
 
                    wxString ref( prop->Name() );
                    ref.Replace( wxT( " " ), wxT( "_" ) );
                    propNames.insert( ref );
                }
            }
 
            for( const wxString& propName : propNames )
                tokens += wxT( "|" ) + propName;
 
            PCBEXPR_BUILTIN_FUNCTIONS& functions = PCBEXPR_BUILTIN_FUNCTIONS::Instance();
 
            for( const wxString& funcSig : functions.GetSignatures() )
            {
                if( !funcSig.Contains( "DEPRECATED" ) )
                    tokens += wxT( "|" ) + funcSig;
            }
        }
        else if( expr_context == STRING )
        {
            if( m_netClassRegex.Matches( last ) )
            {
                BOARD_DESIGN_SETTINGS&         bds = m_frame->GetBoard()->GetDesignSettings();
                std::shared_ptr<NET_SETTINGS>& netSettings = bds.m_NetSettings;
 
                for( const auto& [name, netclass] : netSettings->GetNetclasses() )
                    tokens += wxT( "|" ) + name;
            }
            else if( m_netNameRegex.Matches( last ) )
            {
                BOARD* board = m_frame->GetBoard();
 
                for( const wxString& netnameCandidate : board->GetNetClassAssignmentCandidates() )
                    tokens += wxT( "|" ) + netnameCandidate;
            }
            else if( m_typeRegex.Matches( last ) )
            {
                tokens = wxT( "Bitmap|"
                              "Dimension|"
                              "Footprint|"
                              "Graphic|"
                              "Group|"
                              "Leader|"
                              "Pad|"
                              "Target|"
                              "Text|"
                              "Text Box|"
                              "Track|"
                              "Via|"
                              "Zone" );
            }
            else if( m_viaTypeRegex.Matches( last ) )
            {
                tokens = wxT( "Through|"
                              "Blind|"
                              "Buried|"
                              "Micro" );
            }
            else if( m_padTypeRegex.Matches( last ) )
            {
                tokens = wxT( "Through-hole|"
                              "SMD|"
                              "Edge connector|"
                              "NPTH, mechanical" );
            }
            else if( m_pinTypeRegex.Matches( last ) )
            {
                tokens = wxT( "Input|"
                              "Output|"
                              "Bidirectional|"
                              "Tri-state|"
                              "Passive|"
                              "Free|"
                              "Unspecified|"
                              "Power input|"
                              "Power output|"
                              "Open collector|"
                              "Open emitter|"
                              "Unconnected" );
            }
            else if( m_fabPropRegex.Matches( last ) )
            {
                tokens = wxT( "None|"
                              "BGA pad|"
                              "Fiducial, global to board|"
                              "Fiducial, local to footprint|"
                              "Test point pad|"
                              "Heatsink pad|"
                              "Castellated pad" );
            }
            else if( m_shapeRegex.Matches( last ) )
            {
                tokens = wxT( "Segment|"
                              "Rectangle|"
                              "Arc|"
                              "Circle|"
                              "Polygon|"
                              "Bezier" );
            }
            else if( m_padShapeRegex.Matches( last ) )
            {
                tokens = wxT( "Circle|"
                              "Rectangle|"
                              "Oval|"
                              "Trapezoid|"
                              "Rounded rectangle|"
                              "Chamfered rectangle|"
                              "Custom" );
            }
            else if( m_padConnectionsRegex.Matches( last ) )
            {
                tokens = wxT( "Inherited|"
                              "None|"
                              "Solid|"
                              "Thermal reliefs|"
                              "Thermal reliefs for PTH" );
            }
            else if( m_zoneConnStyleRegex.Matches( last ) )
            {
                tokens = wxT( "Inherited|"
                              "None|"
                              "Solid|"
                              "Thermal reliefs" );
            }
            else if( m_lineStyleRegex.Matches( last ) )
            {
                tokens = wxT( "Default|"
                              "Solid|"
                              "Dashed|"
                              "Dotted|"
                              "Dash-Dot|"
                              "Dash-Dot-Dot" );
            }
            else if( m_hJustRegex.Matches( last ) )
            {
                tokens = wxT( "Left|"
                              "Center|"
                              "Right" );
            }
            else if( m_vJustRegex.Matches( last ) )
            {
                tokens = wxT( "Top|"
                              "Center|"
                              "Bottom" );
            }
        }
    }
 
    if( !tokens.IsEmpty() )
        m_scintillaTricks->DoAutocomplete( partial, wxSplit( tokens, '|' ) );
}
 
 
void PANEL_SETUP_RULES::OnCompile( wxCommandEvent& event )
{
    m_errorsReport->Clear();
 
    try
    {
        std::vector<std::shared_ptr<DRC_RULE>> dummyRules;
 
        std::function<bool( wxString* )> resolver =
                [&]( wxString* token ) -> bool
                {
                    if( IsComponentClassSelector( *token ) )
                        return false;
 
                    return m_frame->GetBoard()->ResolveTextVar( token, 0 );
                };
 
        wxString rulesText = m_textEditor->GetText();
        rulesText = m_frame->GetBoard()->ConvertCrossReferencesToKIIDs( rulesText );
        rulesText = ExpandTextVars( rulesText, &resolver );
 
        DRC_RULES_PARSER parser( rulesText, _( "DRC rules" ) );
 
        parser.Parse( dummyRules, m_errorsReport );
        checkPlausibility( dummyRules );
    }
    catch( PARSE_ERROR& pe )
    {
        m_errorsReport->Report( wxString::Format( wxT( "%s <a href='%d:%d'>%s</a>%s" ),
                                                  _( "ERROR:" ),
                                                  pe.lineNumber,
                                                  pe.byteIndex,
                                                  pe.ParseProblem(),
                                                  wxEmptyString ),
                                RPT_SEVERITY_ERROR );
    }
 
    m_errorsReport->Flush();
}
 
 
void PANEL_SETUP_RULES::checkPlausibility( const std::vector<std::shared_ptr<DRC_RULE>>& aRules )
{
    BOARD*                 board = m_frame->GetBoard();
    BOARD_DESIGN_SETTINGS& bds = board->GetDesignSettings();
    LSET                   enabledLayers = board->GetEnabledLayers();
 
    // Key by (condition, layerSource) so rules with different layer scopes are considered distinct
    std::map<std::pair<wxString, wxString>, wxString> seenConditions;
    std::regex netclassPattern( "NetClass\\s*[!=]=\\s*'\"?([^\"\\s]+)'\"?" );
 
    for( const auto& rule : aRules )
    {
        wxString condition;
 
        if( rule->m_Condition )
            condition = rule->m_Condition->GetExpression();
 
        condition.Trim( true ).Trim( false );
 
        auto key = std::make_pair( condition, rule->m_LayerSource );
 
        if( seenConditions.count( key ) )
        {
            m_errorsReport->Report( wxString::Format( _( "Rules '%s' and '%s' share the same condition." ),
                                                      rule->m_Name,
                                                      seenConditions[key] ),
                                    RPT_SEVERITY_WARNING );
        }
        else
        {
            seenConditions[key] = rule->m_Name;
        }
 
        std::string          condUtf8 = condition.ToStdString();
        std::sregex_iterator it( condUtf8.begin(), condUtf8.end(), netclassPattern );
        std::sregex_iterator end;
 
        for( ; it != end; ++it )
        {
            wxString ncName = wxString::FromUTF8( ( *it )[1].str() );
 
            if( !bds.m_NetSettings->HasNetclass( ncName ) )
            {
                m_errorsReport->Report( wxString::Format( _( "Rule '%s' references undefined netclass '%s'." ),
                                                          rule->m_Name,
                                                          ncName ),
                                        RPT_SEVERITY_WARNING );
            }
        }
 
        const bool isInner = rule->m_LayerSource.IsSameAs( wxT( "'inner'" ), false );
        const bool isOuter = rule->m_LayerSource.IsSameAs( wxT( "'outer'" ), false );
 
        if( !rule->m_LayerSource.IsEmpty() && !isInner && !isOuter )
        {
            LSET invalid = rule->m_LayerCondition & ~enabledLayers;
 
            if( invalid.any() )
            {
                wxString badLayers;
 
                for( PCB_LAYER_ID layer : invalid.Seq() )
                {
                    if( !badLayers.IsEmpty() )
                        badLayers += ", ";
 
                    badLayers += board->GetLayerName( layer );
                }
 
                m_errorsReport->Report( wxString::Format( _( "Rule '%s' references undefined layer(s): %s." ),
                                                          rule->m_Name,
                                                          badLayers ),
                                        RPT_SEVERITY_WARNING );
            }
        }
    }
}
 
 
void PANEL_SETUP_RULES::OnErrorLinkClicked( wxHtmlLinkEvent& event )
{
    wxString      link = event.GetLinkInfo().GetHref();
    wxArrayString parts;
    long          line = 0, offset = 0;
 
    wxStringSplit( link, parts, ':' );
 
    if( parts.size() > 1 )
    {
        parts[0].ToLong( &line );
        parts[1].ToLong( &offset );
    }
 
    int pos = m_textEditor->PositionFromLine( line - 1 ) + ( offset - 1 );
 
    m_textEditor->GotoPos( pos );
 
    m_textEditor->SetFocus();
}
 
 
bool PANEL_SETUP_RULES::TransferDataToWindow()
{
    if( !m_frame->GetBoard() )
        return true;
 
    wxFileName rulesFile( m_frame->GetBoard()->GetDesignRulesPath() );
 
    if( rulesFile.FileExists() )
    {
        wxTextFile file( rulesFile.GetFullPath() );
 
        if( file.Open() )
        {
            for ( wxString str = file.GetFirstLine(); !file.Eof(); str = file.GetNextLine() )
            {
                ConvertSmartQuotesAndDashes( &str );
                m_textEditor->AddText( str << '\n' );
            }
 
            m_textEditor->EmptyUndoBuffer();
 
            wxCommandEvent dummy;
            OnCompile( dummy );
        }
    }
    else
    {
        m_textEditor->AddText( wxT( "(version 2)\n" ) );
    }
 
    m_originalText = m_textEditor->GetText();
 
    if( m_frame->Prj().IsNullProject() )
    {
        m_textEditor->ClearAll();
        m_textEditor->AddText( _( "Design rules cannot be added without a project" ) );
        m_textEditor->Disable();
    }
 
    return true;
}
 
 
bool PANEL_SETUP_RULES::TransferDataFromWindow()
{
    if( m_originalText == m_textEditor->GetText() )
        return true;
 
    if( m_frame->Prj().IsNullProject() )
        return true;
 
    if( !m_frame->GetBoard() )
        return true;
 
    wxString rulesFilepath = m_frame->GetBoard()->GetDesignRulesPath();
 
    wxString    content = m_textEditor->GetText();
    std::string utf8 = std::string( content.mb_str( wxConvUTF8 ) );
    wxString    writeError;
 
    if( !KIPLATFORM::IO::AtomicWriteFile( rulesFilepath, utf8.data(), utf8.size(), &writeError ) )
    {
        wxLogError( _( "Cannot save design rules to '%s': %s" ), rulesFilepath, writeError );
        return false;
    }
 
    try
    {
        m_frame->GetBoard()->GetDesignSettings().m_DRCEngine->InitEngine( rulesFilepath );
        return true;
    }
    catch( PARSE_ERROR& )
    {
        // Don't lock them in to the Setup dialog if they have bad rules.  They've already
        // saved them so we can allow an exit.
        return true;
    }
}
 
 
void PANEL_SETUP_RULES::OnSyntaxHelp( wxHyperlinkEvent& aEvent )
{
    if( m_helpWindow )
    {
        m_helpWindow->ShowModeless();
        return;
    }
    std::vector<wxString> msg;
    msg.clear();
 
    wxString t =
#include "dialogs/panel_setup_rules_help_1clauses.h"
            ;
    msg.emplace_back( t );
    t =
#include "dialogs/panel_setup_rules_help_2constraints.h"
            ;
    msg.emplace_back( t );
    t =
#include "dialogs/panel_setup_rules_help_3items.h"
            ;
    msg.emplace_back( t );
    t =
#include "dialogs/panel_setup_rules_help_4severity_names.h"
            ;
    msg.emplace_back( t );
    t =
#include "dialogs/panel_setup_rules_help_5examples.h"
            ;
    msg.emplace_back( t );
    t =
#include "dialogs/panel_setup_rules_help_6notes.h"
            ;
    msg.emplace_back( t );
    t =
#include "dialogs/panel_setup_rules_help_7properties.h"
            ;
    msg.emplace_back( t );
    t =
#include "dialogs/panel_setup_rules_help_8expression_functions.h"
            ;
    msg.emplace_back( t );
    t =
#include "dialogs/panel_setup_rules_help_9more_examples.h"
            ;
    msg.emplace_back( t );
    t =
#include "dialogs/panel_setup_rules_help_10documentation.h"
            ;
    msg.emplace_back( t );
 
    wxString msg_txt = wxEmptyString;
 
    for( wxString i : msg )
        msg_txt << wxGetTranslation( i );
 
#ifdef __WXMAC__
    msg_txt.Replace( wxT( "Ctrl+" ), wxT( "Cmd+" ) );
#endif
    const wxString& msGg_txt = msg_txt;
 
    m_helpWindow = new HTML_MESSAGE_BOX( nullptr, _( "Syntax Help" ) );
    m_helpWindow->SetDialogSizeInDU( 420, 320 );
 
    wxString html_txt = wxEmptyString;
    ConvertMarkdown2Html( msGg_txt, html_txt );
 
    html_txt.Replace( wxS( "<td" ), wxS( "<td valign=top" ) );
    m_helpWindow->AddHTML_Text( html_txt );
 
    m_helpWindow->ShowModeless();
}
 
 
void PANEL_SETUP_RULES::ImportSettingsFrom( BOARD* aBoard )
{
    if( !m_frame->Prj().IsNullProject() )
    {
        wxFileName relFile = aBoard->GetFileName();
        relFile.SetExt( FILEEXT::DesignRulesFileExtension );
 
        wxFileName absFile( aBoard->GetProject()->AbsolutePath( relFile.GetFullName() ) );
 
        if( absFile.FileExists() )
        {
            wxTextFile file( absFile.GetFullPath() );
 
            if( file.Open() )
            {
                m_textEditor->ClearAll();
 
                for ( wxString str = file.GetFirstLine(); !file.Eof(); str = file.GetNextLine() )
                {
                    ConvertSmartQuotesAndDashes( &str );
                    m_textEditor->AddText( str << '\n' );
                }
 
                m_textEditor->EmptyUndoBuffer();
 
                wxCommandEvent dummy;
                OnCompile( dummy );
            }
        }
    }
}