Deprecate min_occurrences and add limit to Metrics.text

[databyjp]

Addresss #1269, by adding limit parameter, and indicating min_occurrences as deprecated.

Further context: https://weaviate-org.slack.com/archives/C04LB3DLSSG/p1753182544533929

Example usage & deprecation indication:

[orca-security-eu]

Orca Security Scan Summary

Status	Check	Issues by priority
Passed	Infrastructure as Code	0   0   0   0	View in Orca
Passed	SAST	0   0   0   0	View in Orca
Passed	Secrets	0   0   0   0	View in Orca
Passed	Vulnerabilities	0   0   0   0	View in Orca

[codecov-commenter]

Codecov Report

Attention: Patch coverage is 90.47619% with 2 lines in your changes missing coverage. Please review.

Project coverage is 87.34%. Comparing base (4366849) to head (6863e9a).
Report is 3 commits behind head on main.

Files with missing lines	Patch %	Lines
weaviate/collections/classes/aggregate.py	81.81%	2 Missing ⚠️

Additional details and impacted files

@@           Coverage Diff           @@
##             main    #1756   +/-   ##
=======================================
  Coverage   87.34%   87.34%           
=======================================
  Files         269      269           
  Lines       18724    18738   +14     
=======================================
+ Hits        16354    16367   +13     
- Misses       2370     2371    +1     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.