[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.

Commencez par le point d’entrée Directive de docutils, en vous concentrant sur la relation entre l’annotation de options et option_spec. Étudiez comment un paramètre générique de mappage d’options pourrait conserver par défaut le mappage incomplet actuel tout en permettant aux sous-classes d’utiliser TypedDict ; le travail est considéré comme terminé lorsque le code en aval peut obtenir des types d’options convertis et spécialisés sans Any, casts ni suppressions.