feat: add --api OpenAPI build mode with docs/api scheme and lib-prefixed nav

mkdocs.yml

@@ -21,6 +21,31 @@ theme:
   - search.highlight
   - search.share
   - search.suggest
+  icon:
+    logo: material/file-document-multiple
+    repo: fontawesome/brands/github
+markdown_extensions:
+- pymdownx.superfences
+- pymdownx.inlinehilite
+- pymdownx.snippets
+- admonition
+- pymdownx.details
+- pymdownx.highlight:
+    linenums: true
+    anchor_linenums: true
+    line_spans: __span
+    pygments_lang_class: true
+- pymdownx.tabbed:
+    alternate_style: true
+- pymdownx.tasklist:
+    custom_checkbox: true
+- tables
+- footnotes
+- pymdownx.caret
+- pymdownx.tilde
+- pymdownx.mark
+extra_css:
+- https://unpkg.com/dracula-prism/dist/css/dracula-prism.css
 plugins:
 - search
 - mkdocstrings:
@@ -41,52 +66,32 @@ plugins:
           show_category_heading: true
           show_object_full_path: false
           show_symbol_type_heading: true
-markdown_extensions:
-- pymdownx.superfences
-- pymdownx.inlinehilite
-- pymdownx.snippets
-- admonition
-- pymdownx.details
-- pymdownx.superfences
-- pymdownx.highlight:
-    linenums: true
-    anchor_linenums: true
-    line_spans: __span
-    pygments_lang_class: true
-- pymdownx.tabbed:
-    alternate_style: true
-- pymdownx.tasklist:
-    custom_checkbox: true
-- tables
-- footnotes
-- pymdownx.caret
-- pymdownx.tilde
-- pymdownx.mark
 site_name: docforge
-docs_dir: docs/lib
+docs_dir: docs
 nav:
-- Home: index.md
+- Home: lib/index.md
 - Loaders:
-  - loaders/index.md
-  - loaders/griffe_loader.md
+  - lib/loaders/index.md
+  - lib/loaders/griffe_loader.md
 - Models:
-  - models/index.md
-  - models/module.md
-  - models/object.md
-  - models/project.md
+  - lib/models/index.md
+  - lib/models/module.md
+  - lib/models/object.md
+  - lib/models/project.md
 - Navigation:
-  - nav/index.md
-  - nav/spec.md
-  - nav/resolver.md
-  - nav/mkdocs.md
+  - lib/nav/index.md
+  - lib/nav/spec.md
+  - lib/nav/resolver.md
+  - lib/nav/mkdocs.md
 - Renderers:
-  - renderers/index.md
-  - renderers/base.md
-  - renderers/mkdocs_renderer.md
-  - renderers/mcp_renderer.md
+  - lib/renderers/index.md
+  - lib/renderers/base.md
+  - lib/renderers/mkdocs_renderer.md
+  - lib/renderers/mcp_renderer.md
 - CLI:
-  - cli/index.md
-  - cli/main.md
-  - cli/commands.md
-  - cli/mcp_utils.md
-  - cli/mkdocs_utils.md
+  - lib/cli/index.md
+  - lib/cli/main.md
+  - lib/cli/commands.md
+  - lib/cli/api_utils.md
+  - lib/cli/mcp_utils.md
+  - lib/cli/mkdocs_utils.md