Added

• A new event fxevent.BeforeRun is now emitted before Fx runs a constructor,
  decorator, or supply/replace stub.

Changed

• Clearer error messages are now used when annotation building fails.

Thanks to @Groxx, @abhinav, @90Byte, @Giatroo, and @jkanywhere for their contributions to this release.

Added

• Added Runtime to fxevent.Run event, which stores the runtime of
  a constructor or a decorator that's run, including functions created
  by fx.Supply and fx.Replace.

Changed

• Overhauled the documentation website. (https://uber-go.github.io/fx/)

Fixed

• A deadlock with the relayer in signal receivers.

Changed

• Upgrade Dig dependency to v1.18.0

Fixed

• Fx apps will only listen to signals when .Run(), .Wait(), or .Done()
  are called, fixing a regression introduced in v1.19.0.

Thank you @MarcoPolo for your contribution to the release.

Added

• Add fx.Self which can be passed to the fx.As annotation to signify
  that a type should be provided as itself.
• Add fxtest.EnforceTimeout that can be passed to fxtest.NewLifecycle
  to force Start and Stop to return context errors when hook context expires.

Changed

• fx.Private can now be used with fx.Supply.

Fixed

• Fx apps will no longer listen to OS signals when they are stopped,
  solving blocking issues in programs that depended on OS signals
  after an Fx app stops.

Thank you @MarcoPolo for your contribution to the release.

Changed

• Register Fx provides (e.g. fx.Lifecycle, fx.Shutdowner, fx.DotGraph) before
  user provides, to increase likelihood of successful custom logger creation.

Added

• fxtest: Add WithTestLogger option that uses a testing.TB as the
  Fx event logger.
• An fxevent logger that can log events using a slog logger has been added.

Changed

• Upgrade Dig dependency to v1.17.1

Thanks to @robbert229 for their contribution to the release.

Added

• Provided, Decorated, Supplied, and Replaced events now include a trace
  of module locations through which the option was given to the App.
• wasi support.

Added

• A new event fxevent.Run is now emitted when Fx runs a constructor, decorator,
  or supply/replace stub.

Changed

• fx.Populate now works with fx.Annotate.
• Upgrade Dig dependency to v1.17.0.

Changed

• Fixed several typos in docs.
• WASM build support.
• Annotating In and Out structs with From/As annotations generated invalid results.
  The annotation check now blocks this.
• Shutdown: Support calling from Invoke.

Deprecated

• Deprecate ShutdownTimeout option.

Fixed

• Respect Shutdowner ExitCode from calling Run.