Hikari-lightbulb

Features

- `Menu.attach` now returns an instance of `MenuHandle` instead of a generic awaitable - allowing the menu to be stopped without using a `MenuContext` or timeout.

Bugfixes

- Changed logging level for exceptions happening in tasks from `WARNING` to `ERROR`. ([486](https://github.com/tandemdude/hikari-lightbulb/issues/486))
- Fix sporadic attribute error when using `self.previous_row()` within a component menu class.

Bugfixes

- Fixed lightbulb.attachment option, which previously compiled to hikari.OptionType.MENTIONABLE ([472](https://github.com/tandemdude/hikari-lightbulb/issues/472))

Miscellaneous

- Add support for Python 3.13

Features

- - Implement injection for union dependencies using `Foo | Bar`. If any of the requested dependencies are not registered, it will fall back to the next in the union.
- Implement injection for optional dependencies using `Foo | None`. If all the requested dependencies are not registered, it will fall back to `None`.
- Implement injection 'meta annotations' (`Try[]` and `If[]`) allowing modifying of the fall-back behaviour.

([454](https://github.com/tandemdude/hikari-lightbulb/issues/454))
- Add `name` argument to the `hook()` decorator and `name` attribute to `ExecutionHook`.
- Prefab cooldown hooks now register an instance of `CommandCooldown` as a dependency when they are executed.

Bugfixes

- Fix `KeyError` preventing error handlers being loaded from extensions.
- Fix menu task exceptions being logged even if they were raised previously.

Breaking Changes

- `Menu.attach` now has the `wait` parameter set to `True` by default, and the `timeout` parameter set to `30s` by default.

Bugfixes

- Fix DI creating a new default container every time instead of reusing the existing one.
- Fixed DI failing when trying to create dependencies with more complex dependency trees.

Bugfixes

- - Improved container hierarchical dependency resolution process.
- Add significantly more `DEBUG` logging throughout the DI pipeline.
- `DependencyInjectionManager.enter_context` now needs to be called for every context you wish to enter; it will no longer enter the default context automatically.
- `DependencyInjectionManager.enter_context` now searches the existing container hierarchy to find an existing container for the passed context before trying to create a new one.
- `DependencyInjectionManager.enter_context` now returns a no-op container implementation instead of `None` if DI is disabled globally.

([449](https://github.com/tandemdude/hikari-lightbulb/issues/449))
- Fix default injection container being closed when explicitly entering the `DEFAULT` DI context.

Features

- Add `has_roles` check to the `prefab` subpackage. ([447](https://github.com/tandemdude/hikari-lightbulb/issues/447))
- Add `set_timeout` method to `MenuContext`. ([448](https://github.com/tandemdude/hikari-lightbulb/issues/448))
- Add `client` attribute to `ModalContext` and `MenuContext`.
- Add `enable_all_components` and `disable_all_components` methods to `Menu`.
- Add `registered_commands` and `invokable_commands` properties to `Client`.

Documentation

- Update code examples for version 3 from version 2. ([436](https://github.com/tandemdude/hikari-lightbulb/issues/436))

Features

- Add a component and modal handler implementation. You can use these to more easily handle the creation and execution of message components, as well as submitted modal forms. ([438](https://github.com/tandemdude/hikari-lightbulb/issues/438))

Deprecations and Removals

- The `ephemeral` argument for `Context.defer()` is now keyword-only.