standardize packaging, tooling, docs, CI, and licensing

docforge/nav/spec.pyi

@@ -1,6 +1,4 @@
 from pathlib import Path
-from typing import Dict, List, Optional
-
 
 class NavSpec:
     """
@@ -10,18 +8,16 @@ class NavSpec:
     of filesystem structure or MkDocs specifics.
     """
 
-    home: Optional[str]
-    groups: Dict[str, List[str]]
+    home: str | None
+    groups: dict[str, list[str]]
 
     def __init__(
         self,
-        home: Optional[str],
-        groups: Dict[str, List[str]],
-    ) -> None:
-        ...
-
+        home: str | None,
+        groups: dict[str, list[str]],
+    ) -> None: ...
     @classmethod
-    def load(cls, path: Path) -> "NavSpec":
+    def load(cls, path: Path) -> NavSpec:
         """
         Load and validate a nav specification from YAML.
 
@@ -31,12 +27,11 @@ class NavSpec:
         """
         ...
 
-    def all_patterns(self) -> List[str]:
+    def all_patterns(self) -> list[str]:
         """
         Return all path patterns referenced by the spec
         (including home and group entries).
         """
         ...
 
-
 def load_nav_spec(path: Path) -> NavSpec: ...