@tenphi/starlight 0.1.0 → 0.5.0

package/dist/navigation-CC0dlAL8.js

@@ -0,0 +1,78 @@
+//#region src/navigation.ts
+function resolveNavigationLayout(navigation) {
+	const items = Array.isArray(navigation) ? navigation : navigation?.items;
+	const configuredTabs = Array.isArray(navigation) ? [] : navigation?.tabs ?? [];
+	const fallbackSidebarGroup = items !== void 0 ? 0 : void 0;
+	let sidebarGroup = fallbackSidebarGroup === void 0 ? 0 : 1;
+	const tabs = configuredTabs.map((tab) => ({
+		...tab,
+		...tab.items !== void 0 ? { sidebarGroup: sidebarGroup++ } : {}
+	}));
+	return {
+		...fallbackSidebarGroup !== void 0 ? { fallbackSidebarGroup } : {},
+		...items !== void 0 ? { items } : {},
+		tabs,
+		sectioned: tabs.some((tab) => tab.sidebarGroup !== void 0)
+	};
+}
+function navigationItemsForPath(layout, pathname) {
+	const active = activeNavigationTab(layout.tabs, pathname);
+	return active >= 0 && layout.tabs[active]?.items !== void 0 ? layout.tabs[active].items : layout.items;
+}
+/** Pick one tab, preferring its own URL before routes owned by its sidebar. */
+function activeNavigationTab(tabs, pathname) {
+	const current = normalizeNavigationPath(pathname);
+	let winner = -1;
+	let winningScore = -1;
+	for (const [index, tab] of tabs.entries()) {
+		const score = Math.max(linkMatchScore(tab.link, current, 3e4), navigationMatchScore(tab.items ?? [], current));
+		if (score > winningScore) {
+			winner = index;
+			winningScore = score;
+		}
+	}
+	return winningScore >= 0 ? winner : -1;
+}
+function navigationPath(pathname, base = "/") {
+	const normalizedBase = normalizeNavigationPath(base);
+	return normalizeNavigationPath(normalizedBase !== "/" && (pathname === normalizedBase || pathname.startsWith(`${normalizedBase}/`)) ? pathname.slice(normalizedBase.length) || "/" : pathname);
+}
+function normalizeNavigationPath(path) {
+	const normalized = `/${(path.split(/[?#]/, 1)[0]?.replace(/\\/g, "/") ?? "/").replace(/^\/+|\/+$/g, "")}`;
+	return normalized === "/" ? normalized : normalized.replace(/\/$/, "");
+}
+function navigationMatchScore(items, current) {
+	let score = -1;
+	for (const item of items) {
+		if (typeof item === "string") {
+			if (normalizeNavigationPath(item) === current) score = Math.max(score, 2e4);
+			continue;
+		}
+		if ("items" in item) {
+			score = Math.max(score, navigationMatchScore(item.items, current));
+			continue;
+		}
+		if ("autogenerate" in item) {
+			score = Math.max(score, directoryMatchScore(item.autogenerate.directory, current));
+			continue;
+		}
+		score = Math.max(score, linkMatchScore(item.link, current, 2e4));
+	}
+	return score;
+}
+function linkMatchScore(link, current, base) {
+	if (!link.startsWith("/")) return -1;
+	const target = normalizeNavigationPath(link);
+	if (target === current) return base + 1e3 + target.length;
+	if (target !== "/" && current.startsWith(`${target}/`)) return base + target.length;
+	return -1;
+}
+function directoryMatchScore(directory, current) {
+	const target = normalizeNavigationPath(directory);
+	if (target === "/") return 1e4;
+	return current === target || current.startsWith(`${target}/`) ? 1e4 + target.length : -1;
+}
+//#endregion
+export { resolveNavigationLayout as a, normalizeNavigationPath as i, navigationItemsForPath as n, navigationPath as r, activeNavigationTab as t };
+
+//# sourceMappingURL=navigation-CC0dlAL8.js.map

package/dist/navigation-CC0dlAL8.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation-CC0dlAL8.js","names":[],"sources":["../src/navigation.ts"],"sourcesContent":["import type { DocsConfig, NavigationItem, NavigationTab } from \"@tenphi/docs\";\n\nexport interface ResolvedNavigationTab extends NavigationTab {\n  /** Index of the tab's resolved Starlight sidebar group. */\n  sidebarGroup?: number;\n}\n\nexport interface ResolvedNavigationLayout {\n  fallbackSidebarGroup?: number;\n  items?: NavigationItem[];\n  tabs: ResolvedNavigationTab[];\n  sectioned: boolean;\n}\n\nexport function resolveNavigationLayout(\n  navigation: DocsConfig[\"navigation\"],\n): ResolvedNavigationLayout {\n  const items = Array.isArray(navigation) ? navigation : navigation?.items;\n  const configuredTabs = Array.isArray(navigation)\n    ? []\n    : (navigation?.tabs ?? []);\n  const fallbackSidebarGroup = items !== undefined ? 0 : undefined;\n  let sidebarGroup = fallbackSidebarGroup === undefined ? 0 : 1;\n  const tabs = configuredTabs.map((tab) => ({\n    ...tab,\n    ...(tab.items !== undefined ? { sidebarGroup: sidebarGroup++ } : {}),\n  }));\n\n  return {\n    ...(fallbackSidebarGroup !== undefined ? { fallbackSidebarGroup } : {}),\n    ...(items !== undefined ? { items } : {}),\n    tabs,\n    sectioned: tabs.some((tab) => tab.sidebarGroup !== undefined),\n  };\n}\n\nexport function navigationItemsForPath(\n  layout: ResolvedNavigationLayout,\n  pathname: string,\n): NavigationItem[] | undefined {\n  const active = activeNavigationTab(layout.tabs, pathname);\n  return active >= 0 && layout.tabs[active]?.items !== undefined\n    ? layout.tabs[active].items\n    : layout.items;\n}\n\n/** Pick one tab, preferring its own URL before routes owned by its sidebar. */\nexport function activeNavigationTab(\n  tabs: NavigationTab[],\n  pathname: string,\n): number {\n  const current = normalizeNavigationPath(pathname);\n  let winner = -1;\n  let winningScore = -1;\n\n  for (const [index, tab] of tabs.entries()) {\n    const score = Math.max(\n      linkMatchScore(tab.link, current, 30_000),\n      navigationMatchScore(tab.items ?? [], current),\n    );\n    if (score > winningScore) {\n      winner = index;\n      winningScore = score;\n    }\n  }\n\n  return winningScore >= 0 ? winner : -1;\n}\n\nexport function navigationPath(pathname: string, base = \"/\"): string {\n  const normalizedBase = normalizeNavigationPath(base);\n  const withoutBase =\n    normalizedBase !== \"/\" &&\n    (pathname === normalizedBase || pathname.startsWith(`${normalizedBase}/`))\n      ? pathname.slice(normalizedBase.length) || \"/\"\n      : pathname;\n  return normalizeNavigationPath(withoutBase);\n}\n\nexport function normalizeNavigationPath(path: string): string {\n  const clean = path.split(/[?#]/, 1)[0]?.replace(/\\\\/g, \"/\") ?? \"/\";\n  const normalized = `/${clean.replace(/^\\/+|\\/+$/g, \"\")}`;\n  return normalized === \"/\" ? normalized : normalized.replace(/\\/$/, \"\");\n}\n\nfunction navigationMatchScore(\n  items: NavigationItem[],\n  current: string,\n): number {\n  let score = -1;\n  for (const item of items) {\n    if (typeof item === \"string\") {\n      if (normalizeNavigationPath(item) === current)\n        score = Math.max(score, 20_000);\n      continue;\n    }\n    if (\"items\" in item) {\n      score = Math.max(score, navigationMatchScore(item.items, current));\n      continue;\n    }\n    if (\"autogenerate\" in item) {\n      score = Math.max(\n        score,\n        directoryMatchScore(item.autogenerate.directory, current),\n      );\n      continue;\n    }\n    score = Math.max(score, linkMatchScore(item.link, current, 20_000));\n  }\n  return score;\n}\n\nfunction linkMatchScore(link: string, current: string, base: number): number {\n  if (!link.startsWith(\"/\")) return -1;\n  const target = normalizeNavigationPath(link);\n  if (target === current) return base + 1_000 + target.length;\n  if (target !== \"/\" && current.startsWith(`${target}/`)) {\n    return base + target.length;\n  }\n  return -1;\n}\n\nfunction directoryMatchScore(directory: string, current: string): number {\n  const target = normalizeNavigationPath(directory);\n  if (target === \"/\") return 10_000;\n  return current === target || current.startsWith(`${target}/`)\n    ? 10_000 + target.length\n    : -1;\n}\n"],"mappings":"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"}

package/dist/navigation.d.ts

@@ -0,0 +1,21 @@
+import { DocsConfig, NavigationItem, NavigationTab } from "@tenphi/docs";
+//#region src/navigation.d.ts
+interface ResolvedNavigationTab extends NavigationTab {
+  /** Index of the tab's resolved Starlight sidebar group. */
+  sidebarGroup?: number;
+}
+interface ResolvedNavigationLayout {
+  fallbackSidebarGroup?: number;
+  items?: NavigationItem[];
+  tabs: ResolvedNavigationTab[];
+  sectioned: boolean;
+}
+declare function resolveNavigationLayout(navigation: DocsConfig["navigation"]): ResolvedNavigationLayout;
+declare function navigationItemsForPath(layout: ResolvedNavigationLayout, pathname: string): NavigationItem[] | undefined;
+/** Pick one tab, preferring its own URL before routes owned by its sidebar. */
+declare function activeNavigationTab(tabs: NavigationTab[], pathname: string): number;
+declare function navigationPath(pathname: string, base?: string): string;
+declare function normalizeNavigationPath(path: string): string;
+//#endregion
+export { ResolvedNavigationLayout, ResolvedNavigationTab, activeNavigationTab, navigationItemsForPath, navigationPath, normalizeNavigationPath, resolveNavigationLayout };
+//# sourceMappingURL=navigation.d.ts.map

package/dist/navigation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation.d.ts","names":[],"sources":["../src/navigation.ts"],"mappings":";;UAEiB,8BAA8B;;EAE7C;;UAGe;EACf;EACA,QAAQ;EACR,MAAM;EACN;;iBAGc,wBACd,YAAY,2BACX;iBAoBa,uBACd,QAAQ,0BACR,mBACC;;iBAQa,oBACd,MAAM,iBACN;iBAoBc,eAAe,kBAAkB;iBAUjC,wBAAwB"}

package/dist/navigation.js

@@ -0,0 +1,2 @@
+import { a as resolveNavigationLayout, i as normalizeNavigationPath, n as navigationItemsForPath, r as navigationPath, t as activeNavigationTab } from "./navigation-CC0dlAL8.js";
+export { activeNavigationTab, navigationItemsForPath, navigationPath, normalizeNavigationPath, resolveNavigationLayout };

package/dist/overrides/Header.astro

@@ -0,0 +1,49 @@
+---
+import config from "virtual:starlight/user-config";
+import LanguageSelect from "virtual:starlight/components/LanguageSelect";
+import Search from "virtual:starlight/components/Search";
+import SiteTitle from "virtual:starlight/components/SiteTitle";
+import SocialIcons from "virtual:starlight/components/SocialIcons";
+import ThemeSelect from "virtual:starlight/components/ThemeSelect";
+import { layout } from "virtual:cookbook/layout";
+import { activeNavigationTab, navigationPath } from "../navigation.js";
+
+const shouldRenderSearch =
+  config.pagefind ||
+  config.components.Search !== "@astrojs/starlight/components/Search.astro";
+const base = import.meta.env.BASE_URL.replace(/\/$/, "");
+const currentPath = navigationPath(Astro.url.pathname, base || "/");
+const activeTab = activeNavigationTab(layout.tabs, currentPath);
+
+function tabHref(link: string): string {
+  return link.startsWith("/") ? `${base}${link}` || "/" : link;
+}
+---
+
+<div class:list={["td-header", { "td-header--with-tabs": layout.tabs.length }]}>
+  <div class="td-header__primary">
+    <div class="td-header__title"><SiteTitle /></div>
+    <div class="td-header__search print:hidden">
+      {shouldRenderSearch && <Search />}
+    </div>
+    <div class="td-header__tools sl-hidden md:sl-flex print:hidden">
+      <div class="td-header__social"><SocialIcons /></div>
+      <ThemeSelect />
+      <LanguageSelect />
+    </div>
+  </div>
+  {
+    layout.tabs.length > 0 && (
+      <nav class="td-top-tabs print:hidden" aria-label="Primary">
+        {layout.tabs.map((tab, index) => (
+          <a
+            href={tabHref(tab.link)}
+            aria-current={index === activeTab ? "page" : undefined}
+          >
+            {tab.label}
+          </a>
+        ))}
+      </nav>
+    )
+  }
+</div>

package/dist/overrides/Sidebar.astro

@@ -0,0 +1,42 @@
+---
+import MobileMenuFooter from "virtual:starlight/components/MobileMenuFooter";
+import { layout } from "virtual:cookbook/layout";
+import SidebarPersister from "@astrojs/starlight/components/SidebarPersister.astro";
+import SidebarSublist from "@astrojs/starlight/components/SidebarSublist.astro";
+import MobileNavigationTabs from "../components/MobileNavigationTabs.astro";
+import { activeNavigationTab, navigationPath } from "../navigation.js";
+
+const fullSidebar = Astro.locals.starlightRoute.sidebar;
+const currentPath = navigationPath(
+  Astro.url.pathname,
+  import.meta.env.BASE_URL,
+);
+const activeTab = activeNavigationTab(layout.tabs, currentPath);
+const groupIndex =
+  (activeTab >= 0 ? layout.tabs[activeTab]?.sidebarGroup : undefined) ??
+  layout.fallbackSidebarGroup;
+const selectedGroup = layout.sectioned
+  ? groupIndex === undefined
+    ? undefined
+    : fullSidebar[groupIndex]
+  : undefined;
+const sidebar =
+  selectedGroup?.type === "group"
+    ? selectedGroup.entries
+    : layout.sectioned
+      ? []
+      : fullSidebar;
+---
+
+<MobileNavigationTabs
+  base={import.meta.env.BASE_URL}
+  currentPath={Astro.url.pathname}
+/>
+
+<SidebarPersister>
+  <SidebarSublist sublist={sidebar} />
+</SidebarPersister>
+
+<div class="md:sl-hidden">
+  <MobileMenuFooter />
+</div>

package/dist/routes/DocsPage.astro

@@ -1,7 +1,11 @@
 ---
 import { createMarkdownProcessor } from "@astrojs/markdown-remark";
-import { content } from "virtual:tasty-docs/config";
-import "virtual:tasty-docs/theme.css";
+import { content } from "virtual:cookbook/config";
+import { layout } from "virtual:cookbook/layout";
+import MobileNavigationTabs from "../components/MobileNavigationTabs.astro";
+import NavigationTree from "../components/NavigationTree.astro";
+import { activeNavigationTab, navigationItemsForPath } from "../navigation.js";
+import "virtual:cookbook/theme.css";
 import "../styles.css";
 
 export const prerender = true;
@@ -26,6 +30,10 @@ export async function getStaticPaths() {
 const { entry, routes, html, site, base, search } = Astro.props;
 const withBase = (route) =>
   `${base === "/" ? "" : `/${base.replace(/^\/+|\/+$/g, "")}`}${route}` || "/";
+const activeTab = activeNavigationTab(layout.tabs, entry.route);
+const navigationItems =
+  navigationItemsForPath(layout, entry.route) ??
+  routes.map((route) => route.route);
 ---
 
 <!doctype html>
@@ -47,32 +55,62 @@ const withBase = (route) =>
       data-tasty-anatomy="Header"
       data-docs-base={base}
     >
-      <a href={withBase("/")}>{site.title ?? "Documentation"}</a>
-      <div class="td-shell__actions">
-        <label>
-          <span class="td-visually-hidden">Color theme</span>
-          <select data-docs-theme aria-label="Color theme">
-            <option value="system">System theme</option>
-            <option value="light">Light theme</option>
-            <option value="dark">Dark theme</option>
-          </select>
-        </label>
-        <label>
-          <span class="td-visually-hidden">Contrast</span>
-          <select data-docs-contrast aria-label="Contrast">
-            <option value="system">System contrast</option>
-            <option value="normal">Normal contrast</option>
-            <option value="more">High contrast</option>
-          </select>
-        </label>
-        {
-          search && (
-            <button type="button" data-docs-search-open aria-haspopup="dialog">
-              Search
-            </button>
-          )
-        }
+      <div class="td-shell__header-primary">
+        <a href={withBase("/")}>{site.title ?? "Documentation"}</a>
+        <div class="td-shell__actions">
+          <label class="td-appearance-control" title="Color theme">
+            <span class="td-visually-hidden">Color theme</span>
+            <select data-docs-theme aria-label="Color theme">
+              <option value="system">System theme</option>
+              <option value="light">Light theme</option>
+              <option value="dark">Dark theme</option>
+            </select>
+          </label>
+          <label
+            class="td-appearance-control td-appearance-control--contrast"
+            title="Contrast"
+          >
+            <span class="td-visually-hidden">Contrast</span>
+            <select data-docs-contrast aria-label="Contrast">
+              <option value="system">System contrast</option>
+              <option value="normal">Normal contrast</option>
+              <option value="more">High contrast</option>
+            </select>
+          </label>
+          {
+            search && (
+              <button
+                type="button"
+                data-docs-search-open
+                aria-haspopup="dialog"
+                aria-keyshortcuts="Control+K"
+              >
+                <span>Search</span>
+                <kbd data-docs-search-shortcut>
+                  <>
+                    <kbd>Ctrl</kbd>
+                    <kbd>K</kbd>
+                  </>
+                </kbd>
+              </button>
+            )
+          }
+        </div>
       </div>
+      {
+        layout.tabs.length > 0 && (
+          <nav class="td-top-tabs" aria-label="Primary">
+            {layout.tabs.map((tab, index) => (
+              <a
+                href={tab.link.startsWith("/") ? withBase(tab.link) : tab.link}
+                aria-current={index === activeTab ? "page" : undefined}
+              >
+                {tab.label}
+              </a>
+            ))}
+          </nav>
+        )
+      }
     </header>
     <div class="td-shell__layout">
       <nav
@@ -80,22 +118,13 @@ const withBase = (route) =>
         aria-label="Documentation"
         data-tasty-anatomy="Sidebar"
       >
-        <ul>
-          {
-            routes.map((route) => (
-              <li>
-                <a
-                  href={withBase(route.route)}
-                  aria-current={
-                    route.route === entry.route ? "page" : undefined
-                  }
-                >
-                  {route.title}
-                </a>
-              </li>
-            ))
-          }
-        </ul>
+        <MobileNavigationTabs base={base} currentPath={entry.route} />
+        <NavigationTree
+          items={navigationItems}
+          routes={routes}
+          current={entry.route}
+          base={base}
+        />
       </nav>
       <main
         id="main-content"