correct usage of SearchResult and SearchMatches needs clarification

I am trying to build a plugin that performs a search on the user's vault and returns search results. I want to use native obsidian components for this as much as possible, and I see that there are typescript componts that seem to be designed for this. However after spending many hours in the docs it is not clear to me how to use the Search related typescript API classes and interfaces properly.

The documentation should be improved to clarify the capabilities and usage of Search related components and functions. Without this, the only practical option is to recreate the functionality from scratch in Svelte or React or plain javascript.

Related docs pages:
https://docs.obsidian.md/Reference/TypeScript+API/SearchResult
https://docs.obsidian.md/Reference/TypeScript+API/SearchMatches
https://docs.obsidian.md/Reference/TypeScript+API/renderResults

Start with the SearchResult, SearchMatches, and renderResults documentation pages linked in the issue, and trace how their capabilities and usage should be explained for a vault-search plugin. Done means the pages clearly show how to use the native search components to return and render results without recreating the functionality.