fix(docs): fix JS URL detection, root index links, and lint

- frame.html.jinja2: replace pathParts.indexOf("component_framework") with
  pathParts.indexOf("component-framework") (the repo name). The old approach
  returned -1 on component_framework.html (filename, not directory), wrongly
  treating all root package pages as local dev and breaking Home/Example nav
  links. New approach finds the repo segment → version is always pathParts[repoIdx+1].
- update_gh_pages.py: split single long Google Fonts <link> (139 chars) into
  two <link> tags to satisfy ruff E501 (100-char limit).
- update_gh_pages.py: change root version index hrefs from component_framework.html
  to index.html so clicking a version lands on the home page, not the raw API docs.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: fsecada01

docs/pdoc_templates/frame.html.jinja2

@@ -521,11 +521,16 @@ main#content { background: var(--cfx-bg); }
   "use strict";
 
   var pathParts      = window.location.pathname.split("/");
-  var pkgIdx         = pathParts.indexOf("component_framework");
-  var isLocal        = pkgIdx < 2;
-  var repoSegment    = isLocal ? "" : pathParts[1];
-  var currentVersion = isLocal ? "local" : pathParts[pkgIdx - 1];
-  var afterPkg       = pathParts.slice(pkgIdx).join("/");
+  var REPO           = "component-framework";
+  var repoIdx        = pathParts.indexOf(REPO);
+  var isLocal        = repoIdx < 0;
+  var repoSegment    = REPO;
+  var currentVersion = isLocal ? "local" : (pathParts[repoIdx + 1] || "main");
+  // Path within the version dir — used by version switcher to keep the same page.
+  // Falls back to component_framework.html (the package root) when at the version root.
+  var afterPkg       = isLocal
+    ? "component_framework.html"
+    : (pathParts.slice(repoIdx + 2).join("/") || "component_framework.html");
 
   /* ── Compute base URLs ─────────────────────────────────────────────────── */
   var baseUrl = isLocal

docs/update_gh_pages.py

@@ -88,7 +88,10 @@ def write_versions_json(
   <title>component-framework — Documentation</title>
   <link rel="preconnect" href="https://fonts.googleapis.com">
   <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-  <link href="https://fonts.googleapis.com/css2?family=IBM+Plex+Mono:wght@400;600&family=Inter:wght@400;500&display=swap" rel="stylesheet">
+  <link href="https://fonts.googleapis.com/css2?family=IBM+Plex+Mono:wght@400;600&display=swap"
+        rel="stylesheet">
+  <link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500&display=swap"
+        rel="stylesheet">
   <style>
     :root {{
       --bg:     #0c1117;
@@ -237,7 +240,7 @@ def write_root_index(
     if has_main:
         items.append(
             _LI_TEMPLATE.format(
-                href="main/component_framework.html",
+                href="main/index.html",
                 label="main",
                 tag_class="tag-dev",
                 tag_text="dev",
@@ -247,7 +250,7 @@ def write_root_index(
     if latest:
         items.append(
             _LI_TEMPLATE.format(
-                href="latest/component_framework.html",
+                href="latest/index.html",
                 label=f"latest  ({latest})",
                 tag_class="tag-latest",
                 tag_text="stable",
@@ -259,7 +262,7 @@ def write_root_index(
         tag_text = "latest" if version == latest else "release"
         items.append(
             _LI_TEMPLATE.format(
-                href=f"{version}/component_framework.html",
+                href=f"{version}/index.html",
                 label=version,
                 tag_class=tag_class,
                 tag_text=tag_text,