…hrowable (#5713)

## Summary

- Adds `ThrowableMatcherResult` to `Matcher.kt` alongside
`SimpleMatcherResult` and `DiffableMatcherResult`. It carries a
pre-built `Throwable` that should be rethrown as-is when an assertion
fails.
- Adds a `withError(error: Throwable)` builder method to
`MatcherResultBuilder`. When called, `build()` returns a
`ThrowableMatcherResult` instead of a `SimpleMatcherResult` or
`DiffableMatcherResult`.
- Updates `invokeMatcher` to handle `ThrowableMatcherResult` before the
`AssertionErrorBuilder` path: the supplied error is passed directly to
`errorCollector.collectOrThrow`, preserving its original type and
message.
- 
Closes #5592

🤖 Generated with [Claude Code](https://claude.com/claude-code)

---------

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>

This PR contains the following updates:

| Package | Change |
[Age](https://docs.renovatebot.com/merge-confidence/) |
[Confidence](https://docs.renovatebot.com/merge-confidence/) |
|---|---|---|---|
| io.qameta.allure | `3.0.1` → `3.0.2` |
![age](https://developer.mend.io/api/mc/badges/age/maven/io.qameta.allure:io.qameta.allure.gradle.plugin/3.0.2?slim=true)
|
![confidence](https://developer.mend.io/api/mc/badges/confidence/maven/io.qameta.allure:io.qameta.allure.gradle.plugin/3.0.1/3.0.2?slim=true)
|

---

### Configuration

📅 **Schedule**: Branch creation - "before 3am on the first day of the
month" (UTC), Automerge - At any time (no schedule defined).

🚦 **Automerge**: Enabled.

♻ **Rebasing**: Whenever PR is behind base branch, or you tick the
rebase/retry checkbox.

🔕 **Ignore**: Close this PR and you won't be reminded about this update
again.

---

- [ ] <!-- rebase-check -->If you want to rebase/retry this PR, check
this box

---

This PR was generated by [Mend Renovate](https://mend.io/renovate/).
View the [repository job
log](https://developer.mend.io/github/kotest/kotest).

<!--renovate-debug:eyJjcmVhdGVkSW5WZXIiOiI0My40My4yIiwidXBkYXRlZEluVmVyIjoiNDMuNDMuMiIsInRhcmdldEJyYW5jaCI6Im1hc3RlciIsImxhYmVscyI6W119-->

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

This PR contains the following updates:

| Package | Change |
[Age](https://docs.renovatebot.com/merge-confidence/) |
[Confidence](https://docs.renovatebot.com/merge-confidence/) |
|---|---|---|---|
| io.kotest:io.kotest.gradle.plugin | `6.1.3` → `6.1.4` |
![age](https://developer.mend.io/api/mc/badges/age/maven/io.kotest:io.kotest.gradle.plugin/6.1.4?slim=true)
|
![confidence](https://developer.mend.io/api/mc/badges/confidence/maven/io.kotest:io.kotest.gradle.plugin/6.1.3/6.1.4?slim=true)
|

---

### Configuration

📅 **Schedule**: Branch creation - "before 3am on the first day of the
month" (UTC), Automerge - At any time (no schedule defined).

🚦 **Automerge**: Enabled.

♻ **Rebasing**: Whenever PR is behind base branch, or you tick the
rebase/retry checkbox.

🔕 **Ignore**: Close this PR and you won't be reminded about this update
again.

---

- [ ] <!-- rebase-check -->If you want to rebase/retry this PR, check
this box

---

This PR was generated by [Mend Renovate](https://mend.io/renovate/).
View the [repository job
log](https://developer.mend.io/github/kotest/kotest).

<!--renovate-debug:eyJjcmVhdGVkSW5WZXIiOiI0My40My4yIiwidXBkYXRlZEluVmVyIjoiNDMuNDMuMiIsInRhcmdldEJyYW5jaCI6Im1hc3RlciIsImxhYmVscyI6W119-->

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

The previous docs incorrectly stated that custom generators have no
shrinker and that the arbitrary {} DSL is equivalent to flatMap and
bind. In reality the three construction approaches differ significantly:

- Arb.bind: full shrinking — all component shrinkers combined (best)
- flatMap: partial shrinking — only the outermost shrinker applies
- arbitrary {} DSL: no automatic shrinking without a custom Shrinker

Changes:
- customgens.md: remove the false equivalence claim; add Arb.bind as the
recommended approach for data classes; add a comparison table of all
three approaches and their shrinking behaviour
- shrinking.md: replace the blanket "custom generators have no shrinker"
statement with a structured breakdown of Arb.bind, flatMap, and the
arbitrary builder, with code examples for each

Closes #5084

---------

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>

<!-- 
If this PR updates documentation, please update all relevant versions of
the docs, see:
https://github.com/kotest/kotest/tree/master/documentation/versioned_docs
The documentation at
https://github.com/kotest/kotest/tree/master/documentation/docs is the
documentation for the next minor or major version _TO BE RELEASED_
-->

….3 (#5736)

<!-- 
If this PR updates documentation, please update all relevant versions of
the docs, see:
https://github.com/kotest/kotest/tree/master/documentation/versioned_docs
The documentation at
https://github.com/kotest/kotest/tree/master/documentation/docs is the
documentation for the next minor or major version _TO BE RELEASED_
-->

<!-- 
If this PR updates documentation, please update all relevant versions of
the docs, see:
https://github.com/kotest/kotest/tree/master/documentation/versioned_docs
The documentation at
https://github.com/kotest/kotest/tree/master/documentation/docs is the
documentation for the next minor or major version _TO BE RELEASED_
-->
add new modules to kotest examples pipeline

Fixes #5733

move powerSetIndexes to common: we shall need it in assertions

…st-maven too (#5742)

<!-- 
If this PR updates documentation, please update all relevant versions of
the docs, see:
https://github.com/kotest/kotest/tree/master/documentation/versioned_docs
The documentation at
https://github.com/kotest/kotest/tree/master/documentation/docs is the
documentation for the next minor or major version _TO BE RELEASED_
-->
Allow running daily tests with latest kotest version for project
`kotest-maven` too
Run showing it works:
https://github.com/kotest/kotest/actions/runs/22797389590/job/66134481289?pr=5742

<!-- 
If this PR updates documentation, please update all relevant versions of
the docs, see:
https://github.com/kotest/kotest/tree/master/documentation/versioned_docs
The documentation at
https://github.com/kotest/kotest/tree/master/documentation/docs is the
documentation for the next minor or major version _TO BE RELEASED_
-->
fixes #5676
Re-enables locationHint in TeamCity - this is not needed by the `gradle`
producers, but still needed by the `idea`'s ones