sourcey 3.5.0 → 3.5.1

package/dist/core/navigation.d.ts

@@ -1,6 +1,7 @@
 import type { NormalizedSpec } from "./types.js";
 import type { ResolvedTab } from "../config.js";
 import type { DocsPage } from "./markdown-loader.js";
+import { type PrettyUrls } from "../site-url.js";
 export interface SiteNavigation {
     tabs: SiteTab[];
     activeTabSlug: string;
@@ -33,12 +34,12 @@ export interface SiteNavItem {
  * Introduction + Authentication → tag groups with operations → Models.
  * All hrefs are #anchor links (single-page spec rendering).
  */
-export declare function buildNavFromSpec(spec: NormalizedSpec, tabSlug: string): SiteTab;
+export declare function buildNavFromSpec(spec: NormalizedSpec, tabSlug: string, prettyUrls?: PrettyUrls): SiteTab;
 /**
  * Build a navigation tab from markdown pages.
  * Groups come from the config; items come from loaded page data.
  */
-export declare function buildNavFromPages(tab: ResolvedTab, pagesByPath: Map<string, DocsPage>): SiteTab;
+export declare function buildNavFromPages(tab: ResolvedTab, pagesByPath: Map<string, DocsPage>, prettyUrls?: PrettyUrls): SiteTab;
 /**
  * Assemble a SiteNavigation from a list of tabs.
  * Defaults to the first tab and first page as active.

package/dist/core/navigation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"navigation.d.ts","sourceRoot":"","sources":["../../src/core/navigation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAGjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAOrD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,OAAO,EAAE,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACtB,MAAM,EAAE,YAAY,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,WAAW,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,EAAE,EAAE,MAAM,CAAC;IACX,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAMD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,cAAc,EACpB,OAAO,EAAE,MAAM,GACd,OAAO,CAiDT;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,WAAW,EAChB,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,GACjC,OAAO,CA6BT;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,cAAc,CASnE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,cAAc,EACnB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACf,cAAc,CAEhB"}
+{"version":3,"file":"navigation.d.ts","sourceRoot":"","sources":["../../src/core/navigation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAGjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAErD,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAgB/D,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,OAAO,EAAE,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACtB,MAAM,EAAE,YAAY,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,WAAW,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,EAAE,EAAE,MAAM,CAAC;IACX,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAMD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,cAAc,EACpB,OAAO,EAAE,MAAM,EACf,UAAU,GAAE,UAAkB,GAC7B,OAAO,CAiDT;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,WAAW,EAChB,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,EAClC,UAAU,GAAE,UAAkB,GAC7B,OAAO,CA6BT;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,cAAc,CASnE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,cAAc,EACnB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACf,cAAc,CAEhB"}

package/dist/core/navigation.js

@@ -1,6 +1,16 @@
 import { tagNavigationLabel } from "./tag-utils.js";
-import { tabPath } from "../config.js";
+import { pageOutputPath, tabPath } from "../config.js";
 import { htmlId } from "../utils/html-id.js";
+import { toPublicPath } from "../site-url.js";
+/**
+ * Convert a file output path (e.g. `concepts/index.html`) into the relative
+ * href the nav should emit, honouring the `prettyUrls` mode. The Sidebar
+ * prepends a `../` depth prefix at render time, so the value returned here
+ * must be root-relative *without* a leading slash.
+ */
+function navHref(outputPath, prettyUrls) {
+    return toPublicPath(outputPath, "", prettyUrls).replace(/^\//, "");
+}
 // ---------------------------------------------------------------------------
 // Builders
 // ---------------------------------------------------------------------------
@@ -10,8 +20,8 @@ import { htmlId } from "../utils/html-id.js";
  * Introduction + Authentication → tag groups with operations → Models.
  * All hrefs are #anchor links (single-page spec rendering).
  */
-export function buildNavFromSpec(spec, tabSlug) {
-    const basePath = tabPath(tabSlug, "index.html");
+export function buildNavFromSpec(spec, tabSlug, prettyUrls = false) {
+    const basePath = navHref(tabPath(tabSlug, "index.html"), prettyUrls);
     const groups = [];
     // Intro group
     const introItems = [
@@ -62,7 +72,7 @@ export function buildNavFromSpec(spec, tabSlug) {
  * Build a navigation tab from markdown pages.
  * Groups come from the config; items come from loaded page data.
  */
-export function buildNavFromPages(tab, pagesByPath) {
+export function buildNavFromPages(tab, pagesByPath, prettyUrls = false) {
     const groups = [];
     if (tab.groups) {
         for (const group of tab.groups) {
@@ -73,7 +83,7 @@ export function buildNavFromPages(tab, pagesByPath) {
                     continue;
                 items.push({
                     label: page.title,
-                    href: tabPath(tab.slug, `${page.slug}.html`),
+                    href: navHref(pageOutputPath(tab.slug, page.slug, prettyUrls), prettyUrls),
                     id: page.slug,
                 });
             }

package/dist/dev-server.js

@@ -199,7 +199,7 @@ export async function startDevServer(options) {
             }
             const tab = config.tabs.find((candidate) => candidate.slug === content.tabSlug);
             if (tab) {
-                const navTab = buildNavFromSpec(spec, tab.slug);
+                const navTab = buildNavFromSpec(spec, tab.slug, config.prettyUrls);
                 navTab.label = tab.label;
                 const idx = data.siteTabs.findIndex((candidate) => candidate.slug === content.tabSlug);
                 if (idx !== -1)
@@ -222,7 +222,7 @@ export async function startDevServer(options) {
             }
             const tab = config.tabs.find((candidate) => candidate.slug === content.tabSlug);
             if (tab) {
-                const navTab = buildNavFromSpec(spec, tab.slug);
+                const navTab = buildNavFromSpec(spec, tab.slug, config.prettyUrls);
                 navTab.label = tab.label;
                 const idx = data.siteTabs.findIndex((candidate) => candidate.slug === content.tabSlug);
                 if (idx !== -1)

package/dist/site-assembly.js

@@ -20,7 +20,7 @@ export async function assembleSite(config) {
     for (const tab of config.tabs) {
         if (tab.openapi || tab.mcp) {
             const spec = specsBySlug.get(tab.slug);
-            const navTab = buildNavFromSpec(spec, tab.slug);
+            const navTab = buildNavFromSpec(spec, tab.slug, config.prettyUrls);
             navTab.label = tab.label;
             siteTabs.push(navTab);
             pageMap.set(tabPath(tab.slug, "index.html"), {
@@ -79,7 +79,7 @@ export async function assembleSite(config) {
                 });
             }
         }
-        siteTabs.push(buildNavFromPages(tab, pagesByPath));
+        siteTabs.push(buildNavFromPages(tab, pagesByPath, config.prettyUrls));
     }
     if (config.changelog.permalinks) {
         addPermalinkPages(pageMap);
@@ -130,7 +130,7 @@ export function rebuildMarkdownTabNavigation(pageMap, siteTabs, tabs, tabSlug, p
             }
         }
     }
-    const navTab = buildNavFromPages(tab, pagesByPath);
+    const navTab = buildNavFromPages(tab, pagesByPath, prettyUrls);
     const idx = siteTabs.findIndex((candidate) => candidate.slug === tabSlug);
     if (idx !== -1)
         siteTabs[idx] = navTab;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sourcey",
-  "version": "3.5.0",
+  "version": "3.5.1",
   "description": "Precision documentation from OpenAPI, MCP, Doxygen, and Markdown. Static HTML you own.",
   "type": "module",
   "engines": {