Macro for packaging and registering collections of Drafter widgets.

Use this module when authoring a widget library that other developers will pull in as a dependency. It handles runtime registration of your widgets with Drafter's component renderer and provides a clean API for both all-at-once and selective adoption.

Quick start

defmodule AcmeWidgets do
  use Drafter.WidgetLibrary,
    widgets: [
      AcmeWidgets.Heatmap,
      AcmeWidgets.Sparkbar,
      AcmeWidgets.Timeline
    ]

  def heatmap(opts \\ []),   do: {AcmeWidgets.Heatmap,   Map.new(opts)}
  def sparkbar(opts \\ []),  do: {AcmeWidgets.Sparkbar,  Map.new(opts)}
  def timeline(opts \\ []),  do: {AcmeWidgets.Timeline,  Map.new(opts)}
end

In the user's application

# All widgets at once
Drafter.run(MyApp, widget_libraries: [AcmeWidgets])

# Or cherry-pick individual widget modules
Drafter.run(MyApp, widget_libraries: [AcmeWidgets.Heatmap])

# Mix libraries freely
Drafter.run(MyApp, widget_libraries: [AcmeWidgets, OtherLib.Canvas])

Constructor functions are imported in render/1 via a normal import:

defmodule MyApp do
  use Drafter.App
  import AcmeWidgets

  def render(state) do
    vertical([
      heatmap(data: state.matrix),
      sparkbar(values: state.series)
    ])
  end
end

See the guides/writing_widgets.md guide for a full walkthrough.