@docubook/flame 2.0.3 → 2.1.0

package/.docu/lib/{html.shared-CsEFmy_Y.js → html.shared-RPCM1y5Q.js}

@@ -1,5 +1,5 @@
-import { a as DOCS_DIR, d as cleanOldBundles, f as loadDocuConfig, l as PROJECT_ROOT, o as FRAMEWORK_ROOT, p as resolveProjectFile, s as LIB_DIR, t as ASSETS_DIR, u as STYLES_DIR } from "./paths-Cbz-dj4s.js";
-import { c as scanMdxFiles, f as cspMeta, i as formatDate2, n as cn, o as isExternalUrl, r as docsHtmlHref, v as normalizeImporterPath } from "./utils-B_CoyKie.js";
+import { C as isDocsPath, D as resolveDeployPath, E as resolveBasePath, T as rebaseContentPath, _ as loadDocuConfig, a as DOCS_DIR, b as servedDeployPath, c as LIB_DIR, d as STYLES_DIR, g as deployPath$1, m as cleanOldBundles, p as basePath$3, s as FRAMEWORK_ROOT, t as ASSETS_DIR, u as PROJECT_ROOT, v as resolveProjectFile, x as DEFAULT_BASE_PATH, y as servedBasePath } from "./paths-CHXABfXa.js";
+import { f as normalizeImporterPath, o as cspMeta, r as scanMdxFiles } from "./server-utils-BYWB7A6T.js";
 import { builtinModules, createRequire } from "node:module";
 import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
 import { dirname, extname, join, relative, resolve, sep } from "node:path";
@@ -11,7 +11,7 @@ import { createHash } from "node:crypto";
 import { generateThemeCss, presetRegistry, resolveTheme } from "@docubook/themes-colors";
 import React, { createContext, useCallback, useContext, useEffect, useRef, useState } from "react";
 import { z } from "zod";
-import { MDXRemote, createDefaultRehypePlugins, createDefaultRemarkPlugins, extractFrontmatter, extractFrontmatterWithContent, rehypeCollectTocs, serialize } from "@docubook/core";
+import { MDXRemote, cn, createDefaultRehypePlugins, createDefaultRemarkPlugins, extractFrontmatter, extractFrontmatterWithContent, formatDate2, rehypeCollectTocs, serialize } from "@docubook/core";
 import { createMdxComponents } from "@docubook/markdown";
 import * as LucideIcons from "lucide-react";
 import { ArrowUpIcon, ArrowUpRight, ChevronDown, ChevronLeft, ChevronRight, ListIcon, Moon, SquarePen, Sun } from "lucide-react";
@@ -470,7 +470,31 @@ var BuildPluginBuilder = class {
 		else console.warn(`[plugin] ${hookName} callback returned unexpected type (got ${typeof result}), expected string or string[], skipping`);
 	}
 };
-/** Toolchain fingerprint: Bun version on Bun, Deno version on Deno, Node elsewhere. */
+/**
+* Resolved docs URL prefix and deployment path, part of every cache key.
+*
+* The page cache is keyed by relative MDX path and the bundle/asset slots are
+* hashed from MDX source alone — neither changes when only `meta.basePath` or
+* `meta.baseURL`'s path changes. Without this stamp, editing either would leave
+* every key untouched and the build would skip every page, emitting HTML that
+* still points at the old prefix.
+*/
+function basePathStamp() {
+	return prefixStamp(basePath$3(), deployPath$1());
+}
+/**
+* Compose the cache stamp from both prefixes that shape generated URLs: the
+* docs prefix and the host's deployment path (from `meta.baseURL`). Either one
+* changing has to invalidate the cache, or a warm cache keeps serving HTML that
+* points at the old location.
+*/
+function prefixStamp(resolvedBasePath, deploymentPath) {
+	if (deploymentPath.length === 0) return resolvedBasePath;
+	return `${resolvedBasePath || "/"}@${deploymentPath}`;
+}
+/**
+* Toolchain fingerprint: Bun version on Bun, Deno version on Deno, Node elsewhere.
+*/
 function runtimeStamp() {
 	const g = globalThis;
 	const bun = g.Bun;
@@ -482,6 +506,54 @@ function runtimeStamp() {
 	return "node-unknown";
 }
 /**
+* Framework source files that shape rendered HTML.
+*
+* Page cache entries are keyed by MDX source alone, so editing the renderer
+* (a template tweak, a new meta tag, base-path plumbing) would otherwise leave
+* every page a cache hit and keep serving HTML built by the old code. Hashing
+* these sources makes a framework edit invalidate the pages it affects.
+*/
+var RENDER_SOURCE_FILES = [
+	".docu/node/html.ts",
+	".docu/node/html.shared.ts",
+	".docu/node/seo.ts",
+	".docu/node/utils.ts",
+	".docu/node/paths.ts",
+	".docu/node/base-path.ts",
+	".docu/node/mdx.ts",
+	".docu/node/search-indexer.ts",
+	".docu/node/build.ts",
+	".docu/node/build.impl.ts",
+	".docu/node/server-routes.ts",
+	".docu/components/DocsLayout.tsx",
+	".docu/components/Navbar.tsx",
+	".docu/pages/index.tsx",
+	".docu/pages/404.tsx",
+	".docu/pages/docs/[[...slug]].tsx"
+];
+var renderStampCache = null;
+/**
+* Fingerprint of the framework's rendering sources.
+*
+* Memoized per process — the files cannot change mid-build, and hashing them
+* on every page would dominate build time. A missing file contributes nothing
+* so a partial install still yields a stable (if weaker) stamp.
+*/
+function renderToolchainStamp() {
+	if (renderStampCache !== null) return renderStampCache;
+	const h = createHash("sha256");
+	h.update(`v6`);
+	for (const rel of RENDER_SOURCE_FILES) {
+		const file = join(FRAMEWORK_ROOT, rel);
+		try {
+			if (!existsSync(file)) continue;
+			h.update(rel).update("\0").update(readFileSync(file, "utf-8"));
+		} catch {}
+	}
+	renderStampCache = h.digest("hex").slice(0, 16);
+	return renderStampCache;
+}
+/**
 * True when a CSS file can change Tailwind v4 output.
 * v4 is CSS-first: `@theme`, `@source`, `@plugin`, `@custom-variant`,
 * `@utility`, `@config`, `@apply`/`@variant`, and `@import "tailwindcss"`
@@ -639,7 +711,9 @@ function computeTailwindCacheKey(globals, themeSuffix, projectRoot = resolveProj
 	h.update("\0");
 	h.update(runtimeStamp());
 	h.update("\0");
-	h.update(`v5`);
+	h.update(basePathStamp());
+	h.update("\0");
+	h.update(`v6`);
 	return h.digest("hex").slice(0, 16);
 }
 /** Read a Tailwind entry plus relative imports for cache invalidation. */
@@ -684,7 +758,7 @@ function hookMemoryPressure(clear) {
 function hashMdxSources(mdxSources) {
 	const h = createHash("sha256");
 	const slugs = Object.keys(mdxSources).sort();
-	h.update(`v5:${runtimeStamp()}:`);
+	h.update(`v6:${runtimeStamp()}:${basePathStamp()}:${renderToolchainStamp()}:`);
 	for (const slug of slugs) {
 		h.update(slug);
 		h.update("\0");
@@ -1027,7 +1101,9 @@ async function buildClientBundle(mdxSources = {}) {
 					return [
 						`const docuConfig = ${JSON.stringify(resolved)};`,
 						`export const routes = docuConfig.routes || [];`,
-						`export const config = docuConfig;`
+						`export const config = docuConfig;`,
+						`export const basePath = ${JSON.stringify(resolveBasePath(config))};`,
+						`export const deployPath = ${JSON.stringify(servedDeployPath())};`
 					].join("\n");
 				}
 			},
@@ -1179,35 +1255,92 @@ async function getGitLastModifiedBatch(filePaths) {
 //#endregion
 //#region .docu/node/mdx.ts
 /**
-* Return the value with `.html` appended, or null if the value should be left
-* unchanged.  Rules:
-*  - Must be a string
-*  - Must start with /docs/  (the /docs root index needs no suffix)
-*  - Must not be an external URL, contain a fragment, or already end in .html
+* Does an author-written absolute path belong to the docs site?
+*
+* At a root deployment the docs own `/`, so every in-site path is a candidate
+* (the historical rule for authored content); otherwise the shared
+* {@link isDocsPath} gate applies and sibling app routes stay untouched.
 */
-function appendHtml(value) {
-	if (typeof value !== "string") return null;
-	if (/^https?:\/\//.test(value)) return null;
-	if (!value.startsWith("/docs/")) return null;
-	if (value.includes("#")) return null;
-	if (value.endsWith(".html")) return null;
-	return `${value}.html`;
+function isContentPath(pathname, resolvedBasePath) {
+	return resolvedBasePath.length === 0 || isDocsPath(pathname, resolvedBasePath);
+}
+/** Split an authored value into its pathname and any `?query`/`#fragment`. */
+function splitContentPath(value) {
+	const cut = value.search(/[?#]/);
+	if (cut === -1) return {
+		pathname: value.replace(/\/+$/, "") || "/",
+		suffix: ""
+	};
+	return {
+		pathname: value.slice(0, cut).replace(/\/+$/, "") || "/",
+		suffix: value.slice(cut)
+	};
 }
 /**
-* Rehype plugin: append `.html` to internal `/docs/` hrefs on HTML `<a>` nodes.
+* Resolve an author-written content **link** for the deployment.
 *
-* This covers standard markdown links: `[text](/docs/page)` → `<a href="…">`.
-* It runs in the HAST (HTML AST) phase, where `<a>` elements are real nodes.
+* Authors link to sibling pages the way they sit on disk (`/docs/guide/y`). The
+* static build serves those pages as flat `.html` files, and a non-default
+* `meta.basePath` — or a host that publishes the dist under a path (a GitHub
+* Pages project site) — moves the authored segment. Re-base it onto the
+* configured prefix, add the deployment path, and keep the `.html` suffix on
+* page links. Returns null when nothing moves, so the default `/docs`
+* deployment keeps emitting the same HTML.
+*/
+function resolveContentHref(value, resolvedBasePath = basePath$3(), deploymentPath = servedDeployPath()) {
+	if (typeof value !== "string") return null;
+	if (/^[a-z][a-z\d+.-]*:|^\/\//i.test(value)) return null;
+	if (!value.startsWith("/") || value === "/") return null;
+	const { pathname, suffix } = splitContentPath(value);
+	if (!isContentPath(pathname, resolvedBasePath)) return null;
+	const rebased = rebaseContentPath(pathname, resolvedBasePath);
+	const resolved = `${deploymentPath}${rebased === "/" || rebased === resolvedBasePath || /\.[a-z0-9]+$/i.test(rebased) || suffix.includes("#") ? rebased : `${rebased}.html`}${suffix}`;
+	return resolved === value ? null : resolved;
+}
+/**
+* Resolve an author-written content **asset** path (`![alt](/docs/assets/x.png)`)
+* for the deployment. Same re-basing rules as {@link resolveContentHref}, minus
+* the `.html` suffix — assets are files, not routes.
+*/
+function resolveContentSrc(value, resolvedBasePath = basePath$3(), deploymentPath = servedDeployPath()) {
+	if (typeof value !== "string") return null;
+	if (/^[a-z][a-z\d+.-]*:|^\/\//i.test(value)) return null;
+	if (!value.startsWith("/") || value === "/") return null;
+	const { pathname, suffix } = splitContentPath(value);
+	if (!isContentPath(pathname, resolvedBasePath)) return null;
+	const resolved = `${deploymentPath}${rebaseContentPath(pathname, resolvedBasePath)}${suffix}`;
+	return resolved === value ? null : resolved;
+}
+/** Element → attribute pairs whose author-written values are content assets. */
+var CONTENT_ASSET_ATTRS = {
+	img: "src",
+	source: "src",
+	video: "src",
+	audio: "src"
+};
+/**
+* Rehype plugin: point author-written hrefs at the deployed docs paths, and
+* author-written asset paths at the deployed asset tree.
 *
-* Skips: external URLs, anchor-only links, paths that already end in `.html`,
-* and the `/docs` root index (no trailing slash segment).
+* Links cover both shapes — plain markdown `[text](/docs/page)` and images and
+* media (`![alt](/docs/assets/x.png)` → `<img src>`) — which only exist in the
+* HAST phase. Skips: external URLs, anchors, the root index, and anything the
+* resolver leaves unchanged.
 */
 function rehypeDocsHtmlLinks() {
 	return (tree) => {
 		function walk(node) {
-			if (node.type === "element" && node.tagName === "a") {
-				const fixed = appendHtml(node.properties?.href);
-				if (fixed) node.properties.href = fixed;
+			if (node.type === "element" && node.properties) {
+				if (node.tagName === "a") {
+					const fixed = resolveContentHref(node.properties.href);
+					if (fixed) node.properties.href = fixed;
+				} else {
+					const attr = node.tagName ? CONTENT_ASSET_ATTRS[node.tagName] : void 0;
+					if (attr) {
+						const fixed = resolveContentSrc(node.properties[attr]);
+						if (fixed) node.properties[attr] = fixed;
+					}
+				}
 			}
 			if (node.children) for (const child of node.children) walk(child);
 		}
@@ -1216,7 +1349,7 @@ function rehypeDocsHtmlLinks() {
 	};
 }
 /**
-* Remark plugin: append `.html` to internal `/docs/` hrefs on MDX JSX nodes.
+* Remark plugin: append `.html` to internal docs hrefs on MDX JSX nodes.
 *
 * MDX JSX elements (`<Card href="…">`, `<LinkCard href="…">`, etc.) live in
 * the MDAST as `mdxJsxFlowElement` / `mdxJsxTextElement` nodes.  They are
@@ -1225,14 +1358,15 @@ function rehypeDocsHtmlLinks() {
 * intercepts them at the MDAST phase where their `attributes` array is still
 * accessible and mutable.
 *
-* Skips: same rules as `appendHtml` (external URLs, anchors, already `.html`).
+* Skips: same rules as `resolveContentHref` (external URLs, anchors, already
+* resolved paths).
 */
 function remarkMdxJsxDocsHtmlLinks() {
 	return (tree) => {
 		function walk(node) {
 			if ((node.type === "mdxJsxFlowElement" || node.type === "mdxJsxTextElement") && node.attributes) {
 				for (const attr of node.attributes) if (attr.type === "mdxJsxAttribute" && attr.name === "href") {
-					const fixed = appendHtml(attr.value);
+					const fixed = resolveContentHref(attr.value);
 					if (fixed) attr.value = fixed;
 				}
 			}
@@ -1399,6 +1533,43 @@ async function compileMdxModule(rawMdx, remarkPlugins, rehypePlugins, href) {
 	return serialized.compiledSource;
 }
 //#endregion
+//#region .docu/node/utils.ts
+/**
+* Client-safe utilities shared by SSR and the browser bundle.
+*
+* This module MUST NOT import Node built-ins (`node:fs`, `node:path`, ...):
+* Bun's bundler injects a `node:path` polyfill into browser builds for any
+* bundled module that imports it. Filesystem/git helpers live in
+* `./server-utils` (server-only).
+*/
+function isExternalUrl(url) {
+	return /^(https?:\/\/|\/\/)/.test(url);
+}
+/** Suffix an internal docs link with `.html` to match the flat static build output. */
+function docsHtmlHref(path) {
+	return `${path}.html`;
+}
+/**
+* Resolve an authored nav/menu link for the current deployment.
+*
+* Docs pages ship as flat `.html` files, so `/docs/guide/routing` has to request
+* `/docs/guide/routing.html`, while the docs root itself stays a directory index
+* and keeps no suffix. Authored `/docs/...` paths are re-based onto the
+* configured prefix, so one `docu.json` keeps working at a custom subpath
+* (`/repo`) or at a root deployment (`""`). External URLs, hash targets and
+* paths that already name a file pass through untouched.
+*/
+function docsNavHref(link, resolvedBasePath = DEFAULT_BASE_PATH) {
+	if (isExternalUrl(link) || !link.startsWith("/")) return link;
+	const cut = link.search(/[?#]/);
+	const suffix = cut === -1 ? "" : link.slice(cut);
+	const pathname = (cut === -1 ? link : link.slice(0, cut)).replace(/\/+$/, "") || "/";
+	if (!isDocsPath(pathname, resolvedBasePath)) return link;
+	const rebased = rebaseContentPath(pathname, resolvedBasePath);
+	if (rebased === "/" || rebased === resolvedBasePath || /\.[a-z0-9]+$/i.test(rebased)) return `${rebased}${suffix}`;
+	return `${rebased}.html${suffix}`;
+}
+//#endregion
 //#region .docu/node/search-indexer.ts
 /**
 * Search Index Generator
@@ -1433,10 +1604,21 @@ function stripJsx(content) {
 	}
 	return result;
 }
+/**
+* Absolute URL for a search record.
+*
+* Records are clicked straight from the search modal, so they must carry both
+* prefixes: the docs prefix inside the dist and the host's deployment path
+* (e.g. `/repo` on a GitHub Pages project site), which no relative depth can
+* express.
+*/
+function searchRecordUrl(filePath, resolvedBasePath = basePath$3(), deploymentPath = deployPath$1()) {
+	return docsHtmlHref(`${deploymentPath}${resolvedBasePath}/${filePath}`);
+}
 function extractRecords(filePath, raw) {
 	const { frontmatter, strippedContent: content } = extractFrontmatterWithContent(raw);
 	const records = [];
-	const url = docsHtmlHref(`/docs/${filePath}`);
+	const url = searchRecordUrl(filePath);
 	const lvl0 = getSectionTitle(filePath);
 	const lvl1 = frontmatterField(frontmatter, "title") || null;
 	const hierarchy = {
@@ -1663,18 +1845,30 @@ function getPreviousNext(pathname) {
 	};
 }
 //#endregion
+//#region .docu/node/client-routes.ts
+var docuConfig$3 = loadDocuConfig();
+resolveRoutes(docuConfig$3.routes || []);
+var config = docuConfig$3;
+/**
+* URL prefix the site is served under (`""` at the domain root, else `/prefix`).
+* Components use this instead of assuming `/docs`, so a subpath deployment does
+* not request assets from the domain root.
+*/
+var basePath$2 = resolveBasePath(docuConfig$3);
+resolveDeployPath(docuConfig$3);
+//#endregion
 //#region .docu/components/Pagination.tsx
 function Pagination({ pathname, className, prevIcon, nextIcon, linkClassName }) {
 	const { prev, next } = getPreviousNext(pathname);
 	if (!prev && !next) return null;
 	return /* @__PURE__ */ jsx(PaginationDocs, {
 		prev: prev ? {
-			href: docsHtmlHref(`/docs${prev.href}`),
+			href: docsHtmlHref(`${basePath$2}${prev.href}`),
 			title: prev.title,
 			description: prev.description
 		} : void 0,
 		next: next ? {
-			href: docsHtmlHref(`/docs${next.href}`),
+			href: docsHtmlHref(`${basePath$2}${next.href}`),
 			title: next.title,
 			description: next.description
 		} : void 0,
@@ -1694,9 +1888,9 @@ function Typography({ children }) {
 }
 //#endregion
 //#region .docu/node/helpers.ts
-var docuConfig$3 = loadDocuConfig();
+var docuConfig$2 = loadDocuConfig();
 function getEditLink(url, filePath) {
-	const configPath = docuConfig$3?.repo?.path || detectPlatformPath(url);
+	const configPath = docuConfig$2?.repo?.path || detectPlatformPath(url);
 	const encodedPath = filePath.replace(/^\//, "").split("/").map(encodeURIComponent).join("/");
 	return `${url}/${configPath}`.replace("{filePath}", encodedPath);
 }
@@ -1720,13 +1914,13 @@ function detectPlatformPath(url) {
 	}
 }
 function isEditEnabled() {
-	return docuConfig$3?.repo?.edit ?? false;
+	return docuConfig$2?.repo?.edit ?? false;
 }
 function getRepoUrl() {
-	return docuConfig$3?.repo?.url || "";
+	return docuConfig$2?.repo?.url || "";
 }
 function getSocialLinks() {
-	return docuConfig$3?.footer?.social || [];
+	return docuConfig$2?.footer?.social || [];
 }
 //#endregion
 //#region .docu/components/EditWith.tsx
@@ -2252,7 +2446,7 @@ function NotFoundPage() {
 			description: "Page not found",
 			actions: [{
 				text: "Go to Docs",
-				link: "/docs/"
+				link: `${servedBasePath()}/`
 			}]
 		} })]
 	});
@@ -2294,29 +2488,25 @@ function ThemeToggle({ className }) {
 }
 //#endregion
 //#region .docu/pages/index.tsx
-var docuConfig$2 = loadDocuConfig();
+var docuConfig$1 = loadDocuConfig();
+var basePath$1 = resolveBasePath(docuConfig$1);
 function IndexPage() {
-	const { meta, home } = docuConfig$2;
-	const routes = docuConfig$2.routes || [];
-	const linkWithHtml = (link) => {
-		if (isExternalUrl(link)) return link;
-		if (link.startsWith("/docs/")) return `${link}.html`;
-		return link;
-	};
+	const { meta, home } = docuConfig$1;
+	const routes = docuConfig$1.routes || [];
 	const features = home?.features?.map((f) => ({
 		...f,
-		link: f.link ? linkWithHtml(f.link) : void 0
+		link: f.link ? docsNavHref(f.link, basePath$1) : void 0
 	})) || routes.filter((r) => r.context).map((route) => ({
 		icon: route.context?.icon,
 		title: route.context?.title || route.title,
 		description: route.context?.description || "",
-		link: docsHtmlHref(`/docs${route.href}${route.items?.[0]?.href || ""}`)
+		link: docsNavHref(`/docs${route.href}${route.items?.[0]?.href || ""}`, basePath$1)
 	}));
 	const hero = home?.hero ? {
 		...home.hero,
 		actions: home.hero.actions?.map((a) => ({
 			...a,
-			link: linkWithHtml(a.link)
+			link: docsNavHref(a.link, basePath$1)
 		}))
 	} : {
 		headline: meta.title,
@@ -2371,11 +2561,6 @@ function Anchor({ href = "", className = "", activeClassName = "", activeWhen, d
 	});
 }
 //#endregion
-//#region .docu/node/client-routes.ts
-var docuConfig$1 = loadDocuConfig();
-resolveRoutes(docuConfig$1.routes || []);
-var config = docuConfig$1;
-//#endregion
 //#region .docu/components/Sublink.tsx
 /** Exclusive accordion for level >= 2 sidebar groups — opening one group
 * closes the previously open one. All level >= 2 groups default to closed
@@ -2400,8 +2585,8 @@ function GroupAccordionProvider({ children }) {
 	});
 }
 function Sublink({ title, href, items, noLink, level, onNavigate, parentHref = "", pathname: pathnameProp }) {
-	const fullHref = parentHref ? `${parentHref}${href}` : `/docs${href}`;
-	const currentPathname = pathnameProp || (typeof window !== "undefined" ? window.location.pathname : "/docs");
+	const fullHref = parentHref ? `${parentHref}${href}` : `${basePath$2}${href}`;
+	const currentPathname = pathnameProp || (typeof window !== "undefined" ? window.location.pathname : basePath$2);
 	const isSeparator = config.sidebar?.context === "separator";
 	const { openId, open, toggle } = useContext(GroupAccordionContext);
 	const isAccordionGroup = Boolean(items) && (isSeparator || level >= 1);
@@ -2515,8 +2700,8 @@ function SidebarGroupHeader({ icon, title }) {
 //#endregion
 //#region .docu/components/Menu.tsx
 function getCurrentContext(path) {
-	if (!path.startsWith("/docs")) return void 0;
-	const match = path.match(/^\/docs\/([^/]+)/);
+	if (!path.startsWith(basePath$2)) return void 0;
+	const match = path.match(new RegExp(`^${basePath$2}/([^/]+)`));
 	return match ? match[1] : void 0;
 }
 function getContextRoute(contextPath, routeList) {
@@ -2526,15 +2711,15 @@ function getContextRoute(contextPath, routeList) {
 }
 function Menu({ onNavigate, className = "", pathname, routes = [] }) {
 	const menuRoutes = routes;
-	const [currentPath] = useState(() => pathname || (typeof window !== "undefined" ? window.location.pathname : "/docs"));
-	if (!currentPath.startsWith("/docs")) return null;
+	const [currentPath] = useState(() => pathname || (typeof window !== "undefined" ? window.location.pathname : basePath$2));
+	if (basePath$2.length > 0 && !currentPath.startsWith(basePath$2)) return null;
 	const mode = config.sidebar?.context || "dropdown";
 	const navProps = {
 		"aria-label": "Documentation navigation",
 		className: cn("transition-all duration-200", className)
 	};
 	const renderBorderItem = (item, parentRouteHref, key) => {
-		const fullHref = `/docs${parentRouteHref}${item.href}`;
+		const fullHref = `${basePath$2}${parentRouteHref}${item.href}`;
 		const isActive = currentPath === fullHref || currentPath === `${fullHref}.html`;
 		return /* @__PURE__ */ jsx("li", { children: /* @__PURE__ */ jsx("div", {
 			className: cn("-ml-[14px] border-l-2", isActive ? "border-primary" : "border-transparent"),
@@ -2545,7 +2730,7 @@ function Menu({ onNavigate, className = "", pathname, routes = [] }) {
 					href: item.href,
 					level: 0,
 					onNavigate,
-					parentHref: `/docs${parentRouteHref}`
+					parentHref: `${basePath$2}${parentRouteHref}`
 				})
 			})
 		}) }, key);
@@ -2574,7 +2759,7 @@ function Menu({ onNavigate, className = "", pathname, routes = [] }) {
 			}, route.href))
 		}) });
 	}
-	const isDocsRoot = currentPath === "/docs" || currentPath === "/docs/";
+	const isDocsRoot = currentPath === basePath$2 || currentPath === `${basePath$2}/`;
 	const currentContext = isDocsRoot ? menuRoutes[0]?.href.replace(/^\/+|\/+$/, "") : getCurrentContext(currentPath);
 	const contextRoute = isDocsRoot && menuRoutes[0] ? currentContext ? getContextRoute(currentContext, menuRoutes) : menuRoutes[0] : currentContext ? getContextRoute(currentContext, menuRoutes) : void 0;
 	if (!contextRoute) return null;
@@ -2587,7 +2772,7 @@ function Menu({ onNavigate, className = "", pathname, routes = [] }) {
 				href: contextRoute.href,
 				level: 0,
 				onNavigate,
-				parentHref: "/docs"
+				parentHref: basePath$2
 			}) }, contextRoute.title)
 		})
 	}) });
@@ -2595,7 +2780,8 @@ function Menu({ onNavigate, className = "", pathname, routes = [] }) {
 //#endregion
 //#region .docu/components/DocsLayout.tsx
 var docuConfig = loadDocuConfig();
-function DocsLayout({ children, repoUrl, pathname = "/docs" }) {
+var basePath = resolveBasePath(docuConfig);
+function DocsLayout({ children, repoUrl, pathname = basePath }) {
 	return React.createElement("div", { className: "docs-layout flex flex-col min-h-screen w-full" }, React.createElement("div", { className: "flex flex-1 items-start w-full" }, React.createElement("aside", {
 		id: "sidebar-island",
 		className: "sticky top-0 hidden h-screen w-[280px] shrink-0 flex-col lg:flex border-r border-base-200 bg-base-100",
@@ -2607,10 +2793,11 @@ function DocsLayout({ children, repoUrl, pathname = "/docs" }) {
 		routes: docuConfig.routes || []
 	}))), React.createElement("main", { className: "flex-1 min-w-0 min-h-screen flex flex-col" }, React.createElement("div", { className: "hidden lg:flex items-center justify-end gap-6 h-14 px-8" }, React.createElement("nav", { className: "flex items-center gap-6 text-sm font-medium text-base-content/80" }, ...(docuConfig.navbar?.menu || []).map((item) => {
 		const isExternal = /^https?:\/\//.test(item.href);
-		const isDocsActive = item.href === "/docs";
+		const href = isExternal ? item.href : docsNavHref(item.href, basePath);
+		const isDocsActive = href === basePath;
 		return React.createElement("a", {
 			key: item.title,
-			href: item.href,
+			href,
 			className: `flex items-center gap-1 hover:text-base-content transition-colors${isDocsActive ? " text-primary font-semibold" : ""}`,
 			...isExternal ? {
 				target: "_blank",
@@ -2657,15 +2844,19 @@ function escapeHtml(input) {
 * `html.ts` untouched.
 */
 function htmlShell(opts) {
-	const { title, description, body, favicon, css, js, nonce, csp, extraScripts, themeCss, depth = 0, headExtra, bodyExtra, absoluteAssets = false } = opts;
+	const { title, description, body, favicon, css, js, nonce, csp, extraScripts, themeCss, depth = 0, headExtra, bodyExtra, absoluteAssets = false, basePath = DEFAULT_BASE_PATH, deployPath = "" } = opts;
 	const nonceAttr = nonce ? ` nonce="${escapeHtml(nonce)}"` : "";
 	const themeStyle = themeCss ? `\n  <style${nonceAttr}>${escapeHtml(themeCss)}</style>` : "";
 	const headInjection = headExtra?.length ? `\n  ${headExtra.join("\n  ")}` : "";
 	const bodyInjection = bodyExtra?.length ? `\n  ${bodyExtra.join("\n  ")}` : "";
 	const depthPrefix = depth === 0 ? "" : "../".repeat(depth);
-	const assetPrefix = absoluteAssets ? "/assets/" : depthPrefix + "assets/";
+	const assetPrefix = absoluteAssets ? `${deployPath}/assets/` : depthPrefix + "assets/";
 	const clientScript = js ? `\n  <link rel="modulepreload" href="${escapeHtml(assetPrefix + js)}">\n  <script type="module"${nonceAttr} src="${escapeHtml(assetPrefix + js)}"><\/script>` : "";
-	const resolvePath = (path) => absoluteAssets ? path : path.startsWith("/") ? depthPrefix + path.slice(1) : path;
+	const resolvePath = (path) => {
+		if (!path.startsWith("/")) return path;
+		const rebased = rebaseContentPath(path, basePath);
+		return absoluteAssets ? `${deployPath}${rebased}` : depthPrefix + rebased.slice(1);
+	};
 	let seoTags = "";
 	if (opts.seo) {
 		const s = opts.seo;
@@ -2726,6 +2917,6 @@ function hmrScript(nonce) {
 <\/script>`;
 }
 //#endregion
-export { hashMdxSources as C, loadPlugins as D, BuildPluginBuilder as E, atomicWriteFile as S, runtimeStamp as T, getPageStripped as _, IndexPage as a, buildClientBundle as b, captureException as c, clearDerivedPageCaches as d, compileMdx as f, getPageFrontmatter as g, getPageContent as h, DocsLayout as i, initSentry as l, frontmatterField as m, hmrScript as n, NotFoundPage as o, compileMdxModule as p, htmlShell as r, DocsPage as s, errorHtml as t, generateSearchIndex as u, registerPageContent as v, hookMemoryPressure as w, computeInlineThemeCss as x, getGitLastModifiedBatch as y };
+export { hashMdxSources as C, BuildPluginBuilder as D, runtimeStamp as E, loadPlugins as O, atomicWriteFile as S, renderToolchainStamp as T, getPageStripped as _, IndexPage as a, buildClientBundle as b, captureException as c, clearDerivedPageCaches as d, compileMdx as f, getPageFrontmatter as g, getPageContent as h, DocsLayout as i, initSentry as l, frontmatterField as m, hmrScript as n, NotFoundPage as o, compileMdxModule as p, htmlShell as r, DocsPage as s, errorHtml as t, generateSearchIndex as u, registerPageContent as v, hookMemoryPressure as w, computeInlineThemeCss as x, getGitLastModifiedBatch as y };
 
-//# sourceMappingURL=html.shared-CsEFmy_Y.js.map
+//# sourceMappingURL=html.shared-RPCM1y5Q.js.map