Doc comment for TypeInterface.interfaces is misleading #27947
Description
The doc comment states that all interfaces implemented are returned. I think it should be updated to read that declared interfaces are returned with an expanded description of what this means. As it reads today I would expect it to match the behavior of an is check, but it does not.
In the latest dev sdk the interfaces for List went from [Iterable, EfficientLength] to [EfficientLengthIterable] and this was a breaking change for us because we were depending on this call to return a list containing Iterable. We need to do extra work to verify that Iterable is in the transitive set of interfaces.