Documentation

Description of constructors and fields of some datatype.

This type is just two nested maps represented as associative lists. It is supposed to be interpreted like this:

[(Constructor name, (Maybe constructor description, [(Field name, Field description)]))]

Example with a concrete data type:

data Foo
  = Foo
      { fFoo :: Int
      }
  | Bar
      { fBar :: Text
      }
  deriving (Generic)

type FooDescriptions =
  '[ '( "Foo", '( 'Just "foo constructor",
      , '[ '("fFoo", "some number")
         ])
      )
   , '( "Bar", '( 'Nothing,
      , '[ '("fBar", "some string")
         ])
      )
   ]

Value-level counterpart to FieldDescriptions.

This type family checks that field descriptions mention only existing constructors and fields.

When descr is empty this family does nothing, to avoid breaking for built-in, non-ADT types.

When descr is not empty, this family will demand Generic instance for typ and fail with a TypeError if there none.