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

Bắt đầu từ điểm vào Directive của docutils, tập trung vào mối quan hệ giữa chú thích của options và option_spec. Tìm hiểu cách một tham số ánh xạ tùy chọn generic có thể giữ nguyên ánh xạ chưa hoàn chỉnh hiện tại theo mặc định, đồng thời cho phép các lớp con sử dụng TypedDict; được xem là hoàn thành khi mã downstream có thể lấy được các kiểu tùy chọn đã chuyển đổi và được chuyên biệt hóa mà không cần Any, casts hoặc suppressions.