@spec block_docs() :: [Keyword.t()]

Returns all block documentation defined in this module.

Each block doc entry is a keyword list with keys like :type, :description, :config, etc., plus a :category key added from @block_category.