KON-685 Add missing declaration in KoDeclarationCastProvider for combined types

[nataliapeterwas]

This PR introduces a comprehensive set of functionalities to enhance type handling within KoDeclarationCastProvider, focusing on combined types like classes, interfaces, and objects. The changes aim to improve the clarity, usability, and flexibility of declarations, making it easier to work with complex type combinations in Kotlin.

Summary of Changes:

1. New Properties:
   Added Boolean properties such as isClassOrObject, isClassOrInterface, and similar, to allow quick identification of declarations that belong to combined type categories (e.g., whether a declaration is either a class or an object).

2. New Methods for Casting:
   Introduced methods like asClassOrObjectDeclaration() or asClassOrInterfaceDeclaration() that enable safe casting to specific combined types. This ensures clear and consistent handling of declarations based on their type composition.

3. Type Predicate Methods:
   Added methods like hasClassOrObjectDeclaration(predicate) to verify specific conditions on combined types. These allow for flexible filtering and validation based on predicates.

4. Extensions for Lists:
   Introduced extension functions for lists of KoDeclarationCastProvider to support filtering and mapping based on the newly added properties and methods. Examples include:

   • classAndObjectDeclarations() for extracting all class or object declarations.
   • withClassOrInterfaceDeclaration(predicate) to filter elements matching specific criteria for combined types.
   • withoutInterfaceOrObjectDeclarationOf() to exclude declarations of certain types.

Purpose:

This update fills a gap in the KoDeclarationCastProvider API by adding essential support for combined type operations. It enables developers to seamlessly:

• Distinguish between classes, objects, and interfaces in various combinations.
• Cast or transform declarations to desired combined types.
• Filter or map lists of declarations using intuitive, high-level abstractions.

Use Case:

For example, a developer working with a mixed collection of declarations can now easily retrieve all class-and-interface declarations that match a specific condition, avoiding manual type checks and improving code readability.

[jira-ticket-bot]

https://lemonappdev.atlassian.net/browse/KON-685