[docutils] Allow directive subclasses to type their options

Directive.options is annotated as dict[str, Incomplete]. Although each
directive subclass knows the keys and converted value types defined by its
option_spec, it cannot express that shape, forcing downstream code to
propagate Any or add casts and suppressions. One example is
https://github.com/adamtheturtle/sphinx-literalizer/pull/516.

Could Directive accept an option-mapping type parameter, defaulting to the
current incomplete mapping for compatibility? This would let subclasses use a
TypedDict for their converted options. Other designs that allow subclasses to
specialize options would also solve the problem.

Inizia dal punto di ingresso Directive di docutils, concentrandoti sulla relazione tra l’annotazione di options e option_spec. Esplora come un parametro generico per la mappatura delle opzioni potrebbe mantenere per impostazione predefinita la mappatura incompleta corrente, consentendo al contempo alle sottoclassi di usare TypedDict; il lavoro è completato quando il codice a valle può ottenere tipi di opzioni convertiti e specializzati senza Any, casts o suppressions.