v0.5.0

Compare Source

2025-07-14

• New: Experimental support for "binding containers" via @BindingContainer. See their docs for more details.
• New: Add keys-scopedProviderFields-*.txt and keys-providerFields-*.txt reports to see generated field reports for graphs.
• Enhancement: Remove Any constraint from binding<T>(), allowing bindings to satisfy nullable variants.
• Enhancement: Add diagnostic to check for scoped @Binds declarations. These are simple pipes and should not have scope annotations.
• Enhancement: Move graph dependency cycle checks to earlier in validation.
• Enhancement: When using Dagger interop, default allowEmpty to true when using Dagger's @Multibinds annotation.
• Enhancement: Make Dagger interop providers/lazy instances a dagger.internal.Provider internally for better compatibility with Dagger internals. Some dagger-generated code assumes this type at runtime.
• Enhancement: Support javax/jakarta Provider types as multibinding Map value types when Dagger interop is enabled.
• Enhancement: Completely skip processing local and enum classes as they're irrelevant to Metro's compiler.
• Enhancement: When reporting @Binds declarations in binding stacks, report the original declaration rather than inherited fake overrides.
• Enhancement: Add interop support for kotlin-inject's @AssistedFactory annotations.
• Enhancement: Add diagnostic to check for graph classes directly extending other graph classes. You should use @Extends.
• Enhancement: Add diagnostic to check for @Assisted parameters in provides functions.
• Enhancement: Add diagnostic to check duplicate @Provides declaration names in the same class.
• Fix: Within (valid) cycles, topographically sort bindings within the cycle. Previously these would fall back to a deterministic-but-wrong alphabetical sort.
• Fix: Handle enum entry arguments to qualifier, scope, and map key annotations.
• Fix: Report the original location of declarations in fake overrides in error reporting.
• Fix: Handle default values on provides parameters with absent bindings during graph population.
• Fix: Don't try to read private accessors of @Includes parameters.
• Fix: Don't quietly stub accessors for missing Binding.Provided bindings.
• Fix: Check constructor-annotated injections when discovering scoped classes in parent graphs.
• Fix: Fix BaseDoubleCheck.isInitialized().
• Fix: Gracefully fall back to MessageCollector for graph seal and contributed graph errors on sourceless declarations.
• Fix: Fix supporting overloads of binds functions from parent graphs or external supertypes.
• Fix: Fix generating binding functions with names that contain dashes.
• Fix: Treat interop'd Dagger/Anvil/KI components as implicitly extendable.
• Fix: Record lookups of @Binds declarations for IC.
• Fix: Record lookups of generated class factories and their constructor signatures for IC.

Special thanks to @​kevinguitar, @​gabrielittner, @​chrisbanes, @​yschimke, and @​ajarl for contributing to this release!