Optimize api for large datasets

**Description**
Currently lib lacks proper search support.

**Proposed solution**
Add configurable search with sensible defaults.

**Priority**: Low/Medium

Start by inspecting the lib directory and identifying the API entry point responsible for search or large-dataset handling. Review how existing configuration and defaults are represented, then define completion as configurable search behavior with sensible defaults and improved handling for large datasets; no tests or specific files are named in the issue.

Written by the indexing model from the issue text.