feat!: close part of the stack, not only all of it

[arekkubaczkowski]

closeAll() could only empty a group. A sheet deep in a stack had no way to say close what is above me, or close three — even though the store already knew enough to do both: stackOrderByGroup is ordered, and a sheet knows its own id. This was an API gap, not a missing capability.

API

const { closeAll, closeTo, closeDepth } = useBottomSheetManager();
const { closeAbove } = useBottomSheetContext();

closeAbove()        // from inside a sheet — everything above me, no id needed
closeTo(id)         // down to a sheet, leaving it open
closeDepth(3)       // three from the top

All three route through closeAllAnimated with a resolved range, so stagger, onBeforeClose interception and stoppedAt reporting behave exactly as before.

Two decisions worth reviewing

Both bounds together take the narrower one, so neither can widen the other.

An until naming a sheet outside the group closes nothing. For a bounded call, silently emptying the stack is the worst available fallback — it is the opposite of what was asked. A __DEV__ warning says which id was not found.

Breaking

• CloseAllResult.closedAll → .completed. Bounded by until/depth it means closed the requested range, which the old name contradicted.
• CloseAllOptions → CascadeOptions, now exported from the store.

Verification

11 new tests (93 total) cover the boundaries: depth 0 and negative, depth past the stack, an until that is the top sheet, an until that is absent, both bounds fighting in either direction, and an interceptor stopping a bounded cascade.

Checked on device via the new Partial Close demo — closeDepth(1) closed exactly one, closeTo(level 1) closed two and left level 1 open, closeDepth(0) and an unknown until both closed nothing. The unknown-until case was confirmed through the debugger rather than the screen: it renders the same result as closeDepth(0), so the warning is the only thing that distinguishes them.

Not included

Docs still reference closedAll and CloseAllOptions (docs/docs/api/hooks.md, types.md).