Function unexpected_token

libs/@local/hashql/syntax-jexpr/src/lexer/error.rs:150–194

(
    span: SpanId,
    found: SyntaxKind,
    expected: SyntaxKindSet,
)

}

pub(crate) fn unexpected_token(
    span: SpanId,
    found: SyntaxKind,
    expected: SyntaxKindSet,
) -> LexerDiagnostic {
    // Create a specific label based on what was found vs what was expected
    let label = if expected.is_empty() {
        format!("Unexpected token {found}")
    } else if expected.is_complete() {
        format!("Invalid syntax found {found}")
    } else {
        format!(
            "Unexpected {}, expected {}",
            found,
            expected.display(Some(Conjunction::Or))
        )
    };

    let mut diagnostic = Diagnostic::new(LexerDiagnosticCategory::UnexpectedToken, Critical::ERROR)
        .primary(Label::new(span, label));

    // Provide specific help based on common syntax errors
    let help = if expected.contains_closing_delimiter()
        && SyntaxKindSet::CLOSING_DELIMITER.contains(found)
    {
        "Mismatched closing brackets. Ensure opening and closing brackets match correctly."
    } else if expected.contains_closing_delimiter() {
        "Missing closing bracket. Make sure all opening brackets have matching closing brackets."
    } else if expected.contains_separator() && SyntaxKindSet::CLOSING_DELIMITER.contains(found) {
        "You might be missing a comma between items or have an extra trailing comma."
    } else if expected.contains_value() && SyntaxKindSet::SEPARATORS.contains(found) {
        "Expected a value (string, number, object, array, true, false, or null) here."
    } else if found == SyntaxKind::Colon && !expected.contains(SyntaxKind::Colon) {
        "Colons are only used in objects to separate keys from values."
    } else if found == SyntaxKind::Comma && !expected.contains(SyntaxKind::Comma) {
        "Commas are only used to separate items in arrays and objects."
    } else {
        "Check your JSON syntax. Make sure brackets are balanced and all required punctuation is \
         present."
    };

    diagnostic.add_message(Message::help(Cow::Borrowed(help)));

    diagnostic
}

const INVALID_NUMBER_HELP: &str = "JSON numbers must contain digits and follow the format: \
                                   `[-]digits[.digits][(e|E)[+|-]digits]`";