@tenphi/renderer 0.19.0

package/dist/page-metadata.js

@@ -0,0 +1,109 @@
+import { routeLocale } from "./localization.js";
+import { pagePublishing, routeUrl } from "@tenphi/docs";
+import { createHash } from "node:crypto";
+//#region src/page-metadata.ts
+function pageMetadata(entry, content, existing) {
+	const localeConfig = content.locales ? { locales: content.locales } : {};
+	const publishing = pagePublishing(entry, {
+		site: content.site,
+		...content.locales ? { locales: content.locales } : {},
+		build: { base: content.base }
+	});
+	const { canonical, title, image, index } = publishing;
+	const owned = /* @__PURE__ */ new Set([
+		"og:title",
+		"og:url",
+		"og:image",
+		"og:image:alt",
+		"og:image:width",
+		"og:image:height",
+		"twitter:card",
+		"twitter:title",
+		"twitter:image",
+		"twitter:image:alt",
+		"robots"
+	]);
+	const head = existing.filter((tag) => tag.tag !== "title" && !(tag.tag === "link" && tag.attrs?.rel === "canonical") && !(tag.tag === "meta" && owned.has(String(tag.attrs?.name ?? tag.attrs?.property).toLowerCase())));
+	const meta = (name, value, property = false) => head.push({
+		tag: "meta",
+		attrs: {
+			[property ? "property" : "name"]: name,
+			content: value
+		}
+	});
+	head.push({
+		tag: "title",
+		content: escapeHtml(title)
+	});
+	if (/^https?:/.test(canonical)) {
+		head.push({
+			tag: "link",
+			attrs: {
+				rel: "canonical",
+				href: canonical
+			}
+		});
+		meta("og:url", canonical, true);
+	}
+	meta("og:title", title, true);
+	meta("twitter:title", title);
+	meta("twitter:card", image ? "summary_large_image" : "summary");
+	if (!index) meta("robots", "noindex, follow");
+	if (image) {
+		const path = image.src.startsWith("/") ? `${content.base.replace(/\/$/, "")}${image.src}` : image.src;
+		const url = content.site.url ? new URL(path, content.site.url).href : path;
+		meta("og:image", url, true);
+		meta("og:image:alt", image.alt, true);
+		meta("twitter:image", url);
+		meta("twitter:image:alt", image.alt);
+		if (image.width && image.height) {
+			meta("og:image:width", String(image.width), true);
+			meta("og:image:height", String(image.height), true);
+		}
+	}
+	meta("cookbook:source", entry.sourcePath);
+	if (publishing.version?.label ?? content.site.version) meta("cookbook:version", publishing.version?.label ?? content.site.version);
+	if (content.site.seo?.copyPage !== false && !entry.frontmatter.draft) head.push({
+		tag: "link",
+		attrs: {
+			rel: "alternate",
+			type: "text/markdown",
+			title: "Markdown",
+			href: agentPagePath(entry.route, content.base)
+		}
+	});
+	const configured = entry.frontmatter.seo?.breadcrumbs;
+	if (configured !== false && (configured || content.site.seo?.breadcrumbs) && /^https?:/.test(canonical)) {
+		const crumbs = configured ?? content.routes.filter((route) => (route.discoverable !== false || route.route === entry.route) && routeLocale(route.route, localeConfig) === routeLocale(entry.route, localeConfig) && (route.route === "/" || route.route === entry.route || entry.route.startsWith(`${route.route}/`))).sort((a, b) => a.route.length - b.route.length).map((route) => ({
+			name: route.title,
+			url: route.route === entry.route ? canonical : routeUrl(route.route, content.base, content.site.url)
+		}));
+		if (configured && crumbs.at(-1)?.url !== canonical) throw new Error(`seo.breadcrumbs in ${entry.sourcePath} must end with the page's canonical URL (${canonical}).`);
+		if (crumbs.length >= 2) head.push({
+			tag: "script",
+			attrs: { type: "application/ld+json" },
+			content: JSON.stringify({
+				"@context": "https://schema.org",
+				"@type": "BreadcrumbList",
+				itemListElement: crumbs.map((crumb, index) => ({
+					"@type": "ListItem",
+					position: index + 1,
+					name: crumb.name,
+					item: crumb.url
+				}))
+			}).replaceAll("<", "\\u003c")
+		});
+	}
+	return head;
+}
+/** Stable short asset names also support deeply nested and non-ASCII routes. */
+function agentPagePath(route, base = "/") {
+	return `${base.replace(/\/$/, "")}/_cookbook/pages/${createHash("sha256").update(route).digest("hex").slice(0, 32)}.md`;
+}
+function escapeHtml(value) {
+	return value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll("\"", "&quot;");
+}
+//#endregion
+export { agentPagePath, pageMetadata };
+
+//# sourceMappingURL=page-metadata.js.map

package/dist/page-metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-metadata.js","names":[],"sources":["../src/page-metadata.ts"],"sourcesContent":["import { createHash } from \"node:crypto\";\nimport { routeLocale } from \"./localization.js\";\nimport {\n  pagePublishing,\n  routeUrl,\n  type DocsEntry,\n  type DocsRoute,\n  type HeadConfig,\n  type SiteConfig,\n  type DocsConfig,\n} from \"@tenphi/docs\";\n\nexport function pageMetadata(\n  entry: DocsEntry,\n  content: {\n    site: SiteConfig;\n    base: string;\n    routes: DocsRoute[];\n    locales?: DocsConfig[\"locales\"];\n  },\n  existing: HeadConfig[],\n): HeadConfig[] {\n  const localeConfig = content.locales ? { locales: content.locales } : {};\n  const publishing = pagePublishing(entry, {\n    site: content.site,\n    ...(content.locales ? { locales: content.locales } : {}),\n    build: { base: content.base },\n  });\n  const { canonical, title, image, index } = publishing;\n  const owned = new Set([\n    \"og:title\",\n    \"og:url\",\n    \"og:image\",\n    \"og:image:alt\",\n    \"og:image:width\",\n    \"og:image:height\",\n    \"twitter:card\",\n    \"twitter:title\",\n    \"twitter:image\",\n    \"twitter:image:alt\",\n    \"robots\",\n  ]);\n  const head = existing.filter(\n    (tag) =>\n      tag.tag !== \"title\" &&\n      !(tag.tag === \"link\" && tag.attrs?.rel === \"canonical\") &&\n      !(\n        tag.tag === \"meta\" &&\n        owned.has(String(tag.attrs?.name ?? tag.attrs?.property).toLowerCase())\n      ),\n  );\n  const meta = (name: string, value: string, property = false) =>\n    head.push({\n      tag: \"meta\",\n      attrs: { [property ? \"property\" : \"name\"]: name, content: value },\n    });\n  head.push({ tag: \"title\", content: escapeHtml(title) });\n  if (/^https?:/.test(canonical)) {\n    head.push({ tag: \"link\", attrs: { rel: \"canonical\", href: canonical } });\n    meta(\"og:url\", canonical, true);\n  }\n  meta(\"og:title\", title, true);\n  meta(\"twitter:title\", title);\n  meta(\"twitter:card\", image ? \"summary_large_image\" : \"summary\");\n  if (!index) meta(\"robots\", \"noindex, follow\");\n  if (image) {\n    const path = image.src.startsWith(\"/\")\n      ? `${content.base.replace(/\\/$/, \"\")}${image.src}`\n      : image.src;\n    const url = content.site.url ? new URL(path, content.site.url).href : path;\n    meta(\"og:image\", url, true);\n    meta(\"og:image:alt\", image.alt, true);\n    meta(\"twitter:image\", url);\n    meta(\"twitter:image:alt\", image.alt);\n    if (image.width && image.height) {\n      meta(\"og:image:width\", String(image.width), true);\n      meta(\"og:image:height\", String(image.height), true);\n    }\n  }\n  meta(\"cookbook:source\", entry.sourcePath);\n  if (publishing.version?.label ?? content.site.version)\n    meta(\n      \"cookbook:version\",\n      publishing.version?.label ?? content.site.version!,\n    );\n  if (content.site.seo?.copyPage !== false && !entry.frontmatter.draft)\n    head.push({\n      tag: \"link\",\n      attrs: {\n        rel: \"alternate\",\n        type: \"text/markdown\",\n        title: \"Markdown\",\n        href: agentPagePath(entry.route, content.base),\n      },\n    });\n  const configured = entry.frontmatter.seo?.breadcrumbs;\n  if (\n    configured !== false &&\n    (configured || content.site.seo?.breadcrumbs) &&\n    /^https?:/.test(canonical)\n  ) {\n    const crumbs =\n      configured ??\n      content.routes\n        .filter(\n          (route) =>\n            (route.discoverable !== false || route.route === entry.route) &&\n            routeLocale(route.route, localeConfig) ===\n              routeLocale(entry.route, localeConfig) &&\n            (route.route === \"/\" ||\n              route.route === entry.route ||\n              entry.route.startsWith(`${route.route}/`)),\n        )\n        .sort((a, b) => a.route.length - b.route.length)\n        .map((route) => ({\n          name: route.title,\n          url:\n            route.route === entry.route\n              ? canonical\n              : routeUrl(route.route, content.base, content.site.url),\n        }));\n    if (configured && crumbs.at(-1)?.url !== canonical)\n      throw new Error(\n        `seo.breadcrumbs in ${entry.sourcePath} must end with the page's canonical URL (${canonical}).`,\n      );\n    if (crumbs.length >= 2)\n      head.push({\n        tag: \"script\",\n        attrs: { type: \"application/ld+json\" },\n        content: JSON.stringify({\n          \"@context\": \"https://schema.org\",\n          \"@type\": \"BreadcrumbList\",\n          itemListElement: crumbs.map((crumb, index) => ({\n            \"@type\": \"ListItem\",\n            position: index + 1,\n            name: crumb.name,\n            item: crumb.url,\n          })),\n        }).replaceAll(\"<\", \"\\\\u003c\"),\n      });\n  }\n  return head;\n}\n\n/** Stable short asset names also support deeply nested and non-ASCII routes. */\nexport function agentPagePath(route: string, base = \"/\"): string {\n  return `${base.replace(/\\/$/, \"\")}/_cookbook/pages/${createHash(\"sha256\").update(route).digest(\"hex\").slice(0, 32)}.md`;\n}\n\nfunction escapeHtml(value: string): string {\n  return value\n    .replaceAll(\"&\", \"&amp;\")\n    .replaceAll(\"<\", \"&lt;\")\n    .replaceAll(\">\", \"&gt;\")\n    .replaceAll('\"', \"&quot;\");\n}\n"],"mappings":"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"}

package/dist/route-context.d.ts

@@ -0,0 +1,85 @@
+import { ResolvedNavigationLayout } from "./navigation.js";
+import { DocsConfig, DocsHeading, DocsRoute, HeadConfig } from "@tenphi/docs";
+//#region src/route-context.d.ts
+type SidebarEntry = {
+  type: "link";
+  label: string;
+  href: string;
+  isCurrent: boolean;
+  attrs: Record<string, string>;
+  badge?: {
+    text: string;
+    variant?: string;
+    class?: string;
+  };
+} | {
+  type: "group";
+  label: string;
+  entries: SidebarEntry[];
+  badge?: {
+    text: string;
+    variant?: string;
+    class?: string;
+  };
+};
+interface TocItem {
+  slug: string;
+  text: string;
+  children: TocItem[];
+}
+interface CookbookRoute {
+  id: string;
+  lang: string;
+  dir: "ltr" | "rtl";
+  hasSidebar: boolean;
+  siteTitle: string;
+  siteTitleHref: string;
+  entry: {
+    data: Record<string, any>;
+  };
+  entryMeta: {
+    lang: string;
+    dir: "ltr" | "rtl";
+    locale: string;
+  };
+  sidebar: SidebarEntry[];
+  pagination: {
+    prev?: {
+      href: string;
+      label: string;
+    };
+    next?: {
+      href: string;
+      label: string;
+    };
+  };
+  toc?: {
+    items: TocItem[];
+  };
+  head: HeadConfig[];
+  editUrl?: string;
+  lastUpdated?: Date;
+}
+type Content = {
+  routes: DocsRoute[];
+  base: string;
+  site: {
+    title?: string;
+    description?: string;
+  };
+  locales?: DocsConfig["locales"];
+  defaultLocale?: string;
+  translations?: DocsConfig["translations"];
+  tableOfContents?: DocsConfig["tableOfContents"];
+  head?: HeadConfig[];
+};
+declare function createRouteContext(input: {
+  pathname: string;
+  frontmatter: Record<string, any>;
+  headings: DocsHeading[];
+  layout: ResolvedNavigationLayout;
+  content: Content;
+}): CookbookRoute;
+//#endregion
+export { CookbookRoute, SidebarEntry, TocItem, createRouteContext };
+//# sourceMappingURL=route-context.d.ts.map

package/dist/route-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-context.d.ts","names":[],"sources":["../src/route-context.ts"],"mappings":";;;KAoBY;EAEN;EACA;EACA;EACA;EACA,OAAO;EACP;IAAU;IAAc;IAAkB;;;EAG1C;EACA;EACA,SAAS;EACT;IAAU;IAAc;IAAkB;;;UAG/B;EACf;EACA;EACA,UAAU;;UAGK;EACf;EACA;EACA;EACA;EACA;EACA;EACA;IAAS,MAAM;;EACf;IAAa;IAAc;IAAoB;;EAC/C,SAAS;EACT;IACE;MAAS;MAAc;;IACvB;MAAS;MAAc;;;EAEzB;IAAQ,OAAO;;EACf,MAAM;EACN;EACA,cAAc;;KAGX;EACH,QAAQ;EACR;EACA;IAAQ;IAAgB;;EACxB,UAAU;EACV;EACA,eAAe;EACf,kBAAkB;EAClB,OAAO;;iBAGO,mBAAmB;EACjC;EACA,aAAa;EACb,UAAU;EACV,QAAQ;EACR,SAAS;IACP"}

package/dist/route-context.js

@@ -0,0 +1,116 @@
+import { navigationPath, normalizeNavigationPath, pageSidebar } from "./navigation.js";
+import { localeHref, localizedNavigation, requestLanguage, routeLocale } from "./localization.js";
+//#region src/route-context.ts
+function createRouteContext(input) {
+	const { pathname, frontmatter, headings, layout, content } = input;
+	const currentPath = navigationPath(pathname, content.base);
+	const locale = routeLocale(currentPath, content);
+	const lang = requestLanguage(pathname, content.base, content);
+	const dir = content.locales?.[locale]?.dir ?? "ltr";
+	const localized = localizedNavigation(layout, content.routes, currentPath, content);
+	const sidebar = resolveSidebar(pageSidebar(localized.layout, localized.routes), currentPath, content);
+	const links = flattenLinks(sidebar);
+	const currentIndex = links.findIndex((link) => link.isCurrent);
+	const previous = resolvePaginationLink(frontmatter.prev, currentIndex >= 0 ? links[currentIndex - 1] : void 0, content, currentPath);
+	const next = resolvePaginationLink(frontmatter.next, currentIndex >= 0 ? links[currentIndex + 1] : void 0, content, currentPath);
+	const pagination = {
+		...previous ? { prev: previous } : {},
+		...next ? { next } : {}
+	};
+	const toc = resolveToc(headings, frontmatter, content);
+	const head = [
+		...content.head ?? [],
+		...frontmatter.head ?? [],
+		...frontmatter.description || content.site.description ? [{
+			tag: "meta",
+			attrs: {
+				name: "description",
+				content: frontmatter.description ?? content.site.description
+			}
+		}] : []
+	];
+	return {
+		id: currentPath,
+		lang,
+		dir,
+		hasSidebar: frontmatter.template !== "splash",
+		siteTitle: content.site.title ?? "Documentation",
+		siteTitleHref: content.base,
+		entry: { data: frontmatter },
+		entryMeta: {
+			lang,
+			dir,
+			locale
+		},
+		sidebar,
+		pagination,
+		...toc ? { toc } : {},
+		head,
+		...typeof frontmatter.editUrl === "string" ? { editUrl: frontmatter.editUrl } : {},
+		...frontmatter.lastUpdated instanceof Date ? { lastUpdated: frontmatter.lastUpdated } : {}
+	};
+}
+function resolveSidebar(items, currentPath, content) {
+	return items.map((item) => {
+		if ("link" in item) {
+			const href = localeHref(item.link, currentPath, content.routes, content, content.base);
+			return {
+				type: "link",
+				label: item.label,
+				href,
+				isCurrent: href.startsWith("/") && !href.startsWith("//") && navigationPath(new URL(href, "https://cookbook.invalid").pathname, content.base) === currentPath,
+				attrs: item.attrs ?? {}
+			};
+		}
+		return {
+			type: "group",
+			label: item.label,
+			entries: resolveSidebar(item.items, currentPath, content)
+		};
+	});
+}
+function flattenLinks(items) {
+	return items.flatMap((item) => item.type === "link" ? [item] : flattenLinks(item.entries));
+}
+function resolvePaginationLink(configured, automatic, content, currentPath) {
+	if (configured === false) return void 0;
+	if (configured === void 0) return automatic && {
+		href: automatic.href,
+		label: automatic.label
+	};
+	const link = typeof configured === "string" ? configured : configured && typeof configured === "object" && "link" in configured && typeof configured.link === "string" ? configured.link : automatic?.href;
+	if (!link) return void 0;
+	const label = configured && typeof configured === "object" && "label" in configured && typeof configured.label === "string" ? configured.label : content.routes.find((route) => normalizeNavigationPath(route.route) === normalizeNavigationPath(link))?.title ?? automatic?.label ?? link;
+	return {
+		href: localeHref(link, currentPath, content.routes, content, content.base),
+		label
+	};
+}
+function resolveToc(headings, frontmatter, content) {
+	const option = frontmatter.tableOfContents ?? content.tableOfContents;
+	if (option === false) return void 0;
+	const min = typeof option === "object" ? option.minHeadingLevel ?? 2 : 2;
+	const max = typeof option === "object" ? option.maxHeadingLevel ?? 3 : 3;
+	const roots = [];
+	const stack = [];
+	for (const heading of headings) {
+		if (heading.depth < min || heading.depth > max) continue;
+		const item = {
+			slug: heading.slug,
+			text: heading.text,
+			children: []
+		};
+		while (stack.length && stack[stack.length - 1].depth >= heading.depth) stack.pop();
+		if (stack.length) stack[stack.length - 1].item.children.push(item);
+		else roots.push(item);
+		stack.push({
+			depth: heading.depth,
+			item
+		});
+	}
+	return roots.length ? { items: roots } : void 0;
+}
+//#endregion
+export { createRouteContext };
+
+//# sourceMappingURL=route-context.js.map

package/dist/route-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-context.js","names":[],"sources":["../src/route-context.ts"],"sourcesContent":["import type {\n  DocsConfig,\n  DocsHeading,\n  DocsRoute,\n  HeadConfig,\n} from \"@tenphi/docs\";\nimport {\n  localeHref,\n  localizedNavigation,\n  requestLanguage,\n  routeLocale,\n} from \"./localization.js\";\nimport {\n  navigationPath,\n  normalizeNavigationPath,\n  pageSidebar,\n  type ResolvedNavigationLayout,\n  type PageSidebarItem,\n} from \"./navigation.js\";\n\nexport type SidebarEntry =\n  | {\n      type: \"link\";\n      label: string;\n      href: string;\n      isCurrent: boolean;\n      attrs: Record<string, string>;\n      badge?: { text: string; variant?: string; class?: string };\n    }\n  | {\n      type: \"group\";\n      label: string;\n      entries: SidebarEntry[];\n      badge?: { text: string; variant?: string; class?: string };\n    };\n\nexport interface TocItem {\n  slug: string;\n  text: string;\n  children: TocItem[];\n}\n\nexport interface CookbookRoute {\n  id: string;\n  lang: string;\n  dir: \"ltr\" | \"rtl\";\n  hasSidebar: boolean;\n  siteTitle: string;\n  siteTitleHref: string;\n  entry: { data: Record<string, any> };\n  entryMeta: { lang: string; dir: \"ltr\" | \"rtl\"; locale: string };\n  sidebar: SidebarEntry[];\n  pagination: {\n    prev?: { href: string; label: string };\n    next?: { href: string; label: string };\n  };\n  toc?: { items: TocItem[] };\n  head: HeadConfig[];\n  editUrl?: string;\n  lastUpdated?: Date;\n}\n\ntype Content = {\n  routes: DocsRoute[];\n  base: string;\n  site: { title?: string; description?: string };\n  locales?: DocsConfig[\"locales\"];\n  defaultLocale?: string;\n  translations?: DocsConfig[\"translations\"];\n  tableOfContents?: DocsConfig[\"tableOfContents\"];\n  head?: HeadConfig[];\n};\n\nexport function createRouteContext(input: {\n  pathname: string;\n  frontmatter: Record<string, any>;\n  headings: DocsHeading[];\n  layout: ResolvedNavigationLayout;\n  content: Content;\n}): CookbookRoute {\n  const { pathname, frontmatter, headings, layout, content } = input;\n  const currentPath = navigationPath(pathname, content.base);\n  const locale = routeLocale(currentPath, content);\n  const lang = requestLanguage(pathname, content.base, content);\n  const dir = content.locales?.[locale]?.dir ?? \"ltr\";\n  const localized = localizedNavigation(\n    layout,\n    content.routes,\n    currentPath,\n    content,\n  );\n  const sidebar = resolveSidebar(\n    pageSidebar(localized.layout, localized.routes),\n    currentPath,\n    content,\n  );\n  const links = flattenLinks(sidebar);\n  const currentIndex = links.findIndex((link) => link.isCurrent);\n  const previous = resolvePaginationLink(\n    frontmatter.prev,\n    currentIndex >= 0 ? links[currentIndex - 1] : undefined,\n    content,\n    currentPath,\n  );\n  const next = resolvePaginationLink(\n    frontmatter.next,\n    currentIndex >= 0 ? links[currentIndex + 1] : undefined,\n    content,\n    currentPath,\n  );\n  const pagination = {\n    ...(previous ? { prev: previous } : {}),\n    ...(next ? { next } : {}),\n  };\n  const toc = resolveToc(headings, frontmatter, content);\n  const head: HeadConfig[] = [\n    ...(content.head ?? []),\n    ...(frontmatter.head ?? []),\n    ...(frontmatter.description || content.site.description\n      ? [\n          {\n            tag: \"meta\",\n            attrs: {\n              name: \"description\",\n              content: frontmatter.description ?? content.site.description,\n            },\n          },\n        ]\n      : []),\n  ];\n  return {\n    id: currentPath,\n    lang,\n    dir,\n    hasSidebar: frontmatter.template !== \"splash\",\n    siteTitle: content.site.title ?? \"Documentation\",\n    siteTitleHref: content.base,\n    entry: { data: frontmatter },\n    entryMeta: { lang, dir, locale },\n    sidebar,\n    pagination,\n    ...(toc ? { toc } : {}),\n    head,\n    ...(typeof frontmatter.editUrl === \"string\"\n      ? { editUrl: frontmatter.editUrl }\n      : {}),\n    ...(frontmatter.lastUpdated instanceof Date\n      ? { lastUpdated: frontmatter.lastUpdated }\n      : {}),\n  };\n}\n\nfunction resolveSidebar(\n  items: PageSidebarItem[],\n  currentPath: string,\n  content: Content,\n): SidebarEntry[] {\n  return items.map((item): SidebarEntry => {\n    if (\"link\" in item) {\n      const href = localeHref(\n        item.link,\n        currentPath,\n        content.routes,\n        content,\n        content.base,\n      );\n      return {\n        type: \"link\",\n        label: item.label,\n        href,\n        isCurrent:\n          href.startsWith(\"/\") &&\n          !href.startsWith(\"//\") &&\n          navigationPath(\n            new URL(href, \"https://cookbook.invalid\").pathname,\n            content.base,\n          ) === currentPath,\n        attrs: item.attrs ?? {},\n      };\n    }\n    return {\n      type: \"group\",\n      label: item.label,\n      entries: resolveSidebar(item.items, currentPath, content),\n    };\n  });\n}\n\nfunction flattenLinks(\n  items: SidebarEntry[],\n): Extract<SidebarEntry, { type: \"link\" }>[] {\n  return items.flatMap((item) =>\n    item.type === \"link\" ? [item] : flattenLinks(item.entries),\n  );\n}\n\nfunction resolvePaginationLink(\n  configured: unknown,\n  automatic: Extract<SidebarEntry, { type: \"link\" }> | undefined,\n  content: Content,\n  currentPath: string,\n): { href: string; label: string } | undefined {\n  if (configured === false) return undefined;\n  if (configured === undefined)\n    return automatic && { href: automatic.href, label: automatic.label };\n  const link =\n    typeof configured === \"string\"\n      ? configured\n      : configured &&\n          typeof configured === \"object\" &&\n          \"link\" in configured &&\n          typeof configured.link === \"string\"\n        ? configured.link\n        : automatic?.href;\n  if (!link) return undefined;\n  const label =\n    configured &&\n    typeof configured === \"object\" &&\n    \"label\" in configured &&\n    typeof configured.label === \"string\"\n      ? configured.label\n      : (content.routes.find(\n          (route) =>\n            normalizeNavigationPath(route.route) ===\n            normalizeNavigationPath(link),\n        )?.title ??\n        automatic?.label ??\n        link);\n  return {\n    href: localeHref(link, currentPath, content.routes, content, content.base),\n    label,\n  };\n}\n\nfunction resolveToc(\n  headings: DocsHeading[],\n  frontmatter: Record<string, any>,\n  content: Content,\n): { items: TocItem[] } | undefined {\n  const option = frontmatter.tableOfContents ?? content.tableOfContents;\n  if (option === false) return undefined;\n  const min = typeof option === \"object\" ? (option.minHeadingLevel ?? 2) : 2;\n  const max = typeof option === \"object\" ? (option.maxHeadingLevel ?? 3) : 3;\n  const roots: TocItem[] = [];\n  const stack: Array<{ depth: number; item: TocItem }> = [];\n  for (const heading of headings) {\n    if (heading.depth < min || heading.depth > max) continue;\n    const item: TocItem = {\n      slug: heading.slug,\n      text: heading.text,\n      children: [],\n    };\n    while (stack.length && stack[stack.length - 1]!.depth >= heading.depth)\n      stack.pop();\n    if (stack.length) stack[stack.length - 1]!.item.children.push(item);\n    else roots.push(item);\n    stack.push({ depth: heading.depth, item });\n  }\n  return roots.length ? { items: roots } : undefined;\n}\n"],"mappings":"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"}

package/dist/routes/DocsPage.astro

@@ -0,0 +1,91 @@
+---
+import Page from "./Page.astro";
+import { content, mdxLoaders } from "virtual:cookbook/config";
+
+export const prerender = true;
+
+export function getStaticPaths() {
+  const entries = content.entries;
+  return [
+    ...entries.map((entry) => ({
+      params: { route: entry.route === "/" ? undefined : entry.route.slice(1) },
+      props: { entry, routes: content.routes },
+    })),
+    ...Object.entries(content.redirects).flatMap(([alias, target]) => {
+      const entry = entries.find((entry) => entry.route === target);
+      return entry
+        ? [
+            {
+              params: { route: alias === "/" ? undefined : alias.slice(1) },
+              props: { entry, routes: content.routes, redirect: target },
+            },
+          ]
+        : [];
+    }),
+  ];
+}
+
+const { entry, routes, redirect } = Astro.props;
+if (redirect)
+  return Astro.redirect(`${content.base.replace(/\/$/, "")}${redirect}`, 301);
+const loadMdx = mdxLoaders[entry.route];
+if (!entry.rendered && !loadMdx) {
+  throw new Error(`Cookbook did not render ${entry.sourcePath}.`);
+}
+const mdx = loadMdx ? await loadMdx() : undefined;
+const MdxContent = mdx?.default;
+const headings = mdx?.getHeadings
+  ? await mdx.getHeadings()
+  : (entry.rendered?.headings ?? []);
+const lastUpdated =
+  typeof entry.frontmatter.lastUpdated === "string"
+    ? new Date(entry.frontmatter.lastUpdated)
+    : entry.frontmatter.lastUpdated;
+const hero = entry.hero;
+const frontmatter = {
+  ...entry.metadata,
+  ...entry.frontmatter,
+  title: entry.title,
+  ...(entry.description ? { description: entry.description } : {}),
+  ...(entry.frontmatter.tableOfContents !== undefined
+    ? { tableOfContents: entry.frontmatter.tableOfContents }
+    : {}),
+  ...(entry.frontmatter.editUrl !== undefined
+    ? { editUrl: entry.frontmatter.editUrl }
+    : {}),
+  ...(entry.frontmatter.template !== undefined
+    ? { template: entry.frontmatter.template }
+    : {}),
+  ...(hero !== undefined ? { hero } : {}),
+  ...(lastUpdated !== undefined ? { lastUpdated } : {}),
+  ...(entry.frontmatter.prev !== undefined
+    ? { prev: entry.frontmatter.prev }
+    : {}),
+  ...(entry.frontmatter.next !== undefined
+    ? { next: entry.frontmatter.next }
+    : {}),
+  ...(entry.frontmatter.banner !== undefined
+    ? { banner: entry.frontmatter.banner }
+    : {}),
+  ...(entry.frontmatter.pagefind !== undefined
+    ? { pagefind: entry.frontmatter.pagefind }
+    : {}),
+  head: [
+    ...(entry.frontmatter.head ?? []).filter(
+      (tag) =>
+        !entry.frontmatter.draft ||
+        tag.tag !== "meta" ||
+        tag.attrs?.name !== "robots",
+    ),
+    ...(entry.frontmatter.draft
+      ? [{ tag: "meta", attrs: { name: "robots", content: "noindex, follow" } }]
+      : []),
+  ],
+  ...(entry.frontmatter.draft ? { pagefind: false } : {}),
+  ...(entry.frontmatter.draft ? { draft: true } : {}),
+};
+---
+
+<Page frontmatter={frontmatter} headings={headings}>
+  {MdxContent ? <MdxContent /> : <div set:html={entry.rendered?.html ?? ""} />}
+</Page>

package/dist/routes/NotFound.astro

@@ -0,0 +1,12 @@
+---
+import Page from "./Page.astro";
+import { content } from "virtual:cookbook/config";
+import { messages } from "../localization.js";
+
+export const prerender = true;
+const ui = messages(content.locales?.root?.lang ?? "en", content);
+---
+
+<Page frontmatter={{ title: ui.notFound, pagefind: false }} headings={[]}>
+  <p>{ui.notFoundDescription}</p>
+</Page>

package/dist/routes/Page.astro

@@ -0,0 +1,120 @@
+---
+import type { DocsHeading } from "@tenphi/docs";
+import { content } from "virtual:cookbook/config";
+import { layout } from "virtual:cookbook/layout";
+import { createRouteContext } from "../route-context.js";
+import { uiTranslations } from "../ui.js";
+import Head from "virtual:cookbook/components/Head";
+import Header from "virtual:cookbook/components/Header";
+import Sidebar from "virtual:cookbook/components/Sidebar";
+import PageFrame from "virtual:cookbook/components/PageFrame";
+import Footer from "virtual:cookbook/components/Footer";
+import Hero from "virtual:cookbook/components/Hero";
+import MarkdownContent from "virtual:cookbook/components/MarkdownContent";
+import MobileTableOfContents from "virtual:cookbook/components/MobileTableOfContents";
+import DraftContentNotice from "virtual:cookbook/components/DraftContentNotice";
+import TableOfContents from "virtual:cookbook/components/TableOfContents";
+
+interface Props {
+  frontmatter: Record<string, any>;
+  headings: DocsHeading[];
+}
+const route = createRouteContext({
+  pathname: Astro.url.pathname,
+  frontmatter: Astro.props.frontmatter,
+  headings: Astro.props.headings,
+  layout,
+  content,
+});
+Astro.locals.cookbookRoute = route;
+const translations = uiTranslations(route.lang, content);
+Astro.locals.t = (key: string) => translations[key] ?? key;
+const { data } = route.entry;
+const indexed = route.id !== "/404" && data.pagefind !== false && !data.draft;
+---
+
+<html
+  lang={route.lang}
+  dir={route.dir}
+  data-theme="dark"
+  data-has-sidebar={route.hasSidebar ? "" : undefined}
+  data-has-toc={route.toc ? "" : undefined}
+  data-has-hero={data.hero ? "" : undefined}
+>
+  <head>
+    <meta charset="utf-8" />
+    <Head />
+  </head>
+  <body>
+    <a class="cookbook-skip-link" href="#main-content"
+      >{Astro.locals.t("page.skipToContent")}</a
+    >
+    <PageFrame>
+      <Header slot="header" />
+      {route.hasSidebar && <Sidebar slot="sidebar" />}
+      <div>
+        {
+          route.toc && (
+            <aside class="right-sidebar-container cookbook-print-hidden">
+              <div class="right-sidebar">
+                <MobileTableOfContents />
+                <div class="right-sidebar-panel">
+                  <h2>{Astro.locals.t("tableOfContents.onThisPage")}</h2>
+                  <nav
+                    aria-label={Astro.locals.t("tableOfContents.onThisPage")}
+                  >
+                    <TableOfContents items={route.toc.items} />
+                  </nav>
+                </div>
+              </div>
+            </aside>
+          )
+        }
+        <div class="main-pane">
+          <main
+            id="main-content"
+            data-pagefind-body={indexed ? "" : undefined}
+            lang={route.entryMeta.lang}
+            dir={route.entryMeta.dir}
+          >
+            {
+              data.banner && (
+                <div class="cookbook-banner" set:html={data.banner.content} />
+              )
+            }
+            {
+              data.hero ? (
+                <div class="content-panel">
+                  <div class="cookbook-container">
+                    <Hero />
+                    <MarkdownContent>
+                      <slot />
+                    </MarkdownContent>
+                    <Footer />
+                  </div>
+                </div>
+              ) : (
+                <>
+                  <div class="content-panel">
+                    <div class="cookbook-container">
+                      <h1 id="_top" data-page-title set:html={data.title} />
+                      {data.draft && <DraftContentNotice />}
+                    </div>
+                  </div>
+                  <div class="content-panel">
+                    <div class="cookbook-container">
+                      <MarkdownContent>
+                        <slot />
+                      </MarkdownContent>
+                      <Footer />
+                    </div>
+                  </div>
+                </>
+              )
+            }
+          </main>
+        </div>
+      </div>
+    </PageFrame>
+  </body>
+</html>

package/dist/styling.d.ts

@@ -0,0 +1,17 @@
+import { Styles as Styles$1 } from "@tenphi/tasty/core";
+import { ElementsDefinition, ModPropsInput, Styles, StylesInterface, SubElementProps, TastyElementOptions, TastyPolymorphicComponent, TokenPropsInput, VariantMap, mergeStyles, tasty, useGlobalStyles } from "@tenphi/tasty";
+import { ElementType, ForwardRefExoticComponent, JSX, PropsWithoutRef, RefAttributes } from "react";
+//#region src/define-component.d.ts
+type SubElementTag<Definition extends ElementsDefinition[string]> = Definition extends string ? Definition : Definition extends {
+  as?: infer Tag;
+} ? Tag extends keyof JSX.IntrinsicElements ? Tag : "div" : "div";
+type SubElements<E extends ElementsDefinition> = { [Name in keyof E]: ForwardRefExoticComponent<PropsWithoutRef<SubElementProps<SubElementTag<E[Name]>>> & RefAttributes<SubElementTag<E[Name]> extends keyof HTMLElementTagNameMap ? HTMLElementTagNameMap[SubElementTag<E[Name]>] : unknown>>; };
+/** Create a named Tasty component with theme.styles[name] merged into its defaults. */
+declare function defineComponent<K extends readonly (keyof StylesInterface)[], V extends VariantMap, E extends ElementsDefinition = Record<string, never>, AsType extends ElementType = "div", M extends ModPropsInput = readonly never[], TP extends TokenPropsInput = readonly never[]>(name: string, options: TastyElementOptions<K, V, E, AsType, M, TP>): TastyPolymorphicComponent<AsType, K, V, M, TP> & SubElements<E>;
+//#endregion
+//#region src/components/component-styles.d.ts
+/** Merge a partial theme override into a built-in or consumer style tree. */
+declare function resolveComponentStyles(name: string, baseStyles: Styles$1): Styles$1;
+//#endregion
+export { type Styles, defineComponent, mergeStyles, resolveComponentStyles, tasty, useGlobalStyles };
+//# sourceMappingURL=styling.d.ts.map

package/dist/styling.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"styling.d.ts","names":[],"sources":["../src/define-component.ts","../src/components/component-styles.ts"],"mappings":";;;;KAoBK,cAAc,mBAAmB,8BACpC,4BACI,aACA;EAAqB,WAAW;IAC9B,kBAAkB,IAAI,oBACpB;KAKL,YAAY,UAAU,yBACxB,cAAc,IAAI,0BACjB,gBAAgB,gBAAgB,cAAc,EAAE,WAC9C,cACE,cAAc,EAAE,qBAAqB,wBACjC,sBAAsB,cAAc,EAAE;;iBAOlC,gBACd,0BAA0B,oBAC1B,UAAU,YACV,UAAU,qBAAqB,uBAC/B,eAAe,qBACf,UAAU,kCACV,WAAW,oCAEX,cACA,SAAS,oBAAoB,GAAG,GAAG,GAAG,QAAQ,GAAG,MAChD,0BAA0B,QAAQ,GAAG,GAAG,GAAG,MAAM,YAAY;;;;iBCjChD,uBACd,cACA,YAAY,WACX"}

package/dist/styling.js

@@ -0,0 +1,17 @@
+import { i as resolveComponentStyles, t as configureCookbookStates } from "./tasty-states-BDKIbfw2.js";
+import { mergeStyles, tasty, tasty as tasty$1, useGlobalStyles } from "@tenphi/tasty";
+//#region src/define-component.ts
+/** Create a named Tasty component with theme.styles[name] merged into its defaults. */
+function defineComponent(name, options) {
+	return tasty$1({
+		...options,
+		styles: resolveComponentStyles(name, options.styles ?? {})
+	});
+}
+//#endregion
+//#region src/styling.ts
+configureCookbookStates();
+//#endregion
+export { defineComponent, mergeStyles, resolveComponentStyles, tasty, useGlobalStyles };
+
+//# sourceMappingURL=styling.js.map

package/dist/styling.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"styling.js","names":["tasty"],"sources":["../src/define-component.ts","../src/styling.ts"],"sourcesContent":["import {\n  tasty,\n  type ElementsDefinition,\n  type ModPropsInput,\n  type StylesInterface,\n  type SubElementProps,\n  type TastyElementOptions,\n  type TastyPolymorphicComponent,\n  type TokenPropsInput,\n  type VariantMap,\n} from \"@tenphi/tasty\";\nimport type {\n  ElementType,\n  ForwardRefExoticComponent,\n  JSX,\n  PropsWithoutRef,\n  RefAttributes,\n} from \"react\";\nimport { resolveComponentStyles } from \"./components/component-styles.js\";\n\ntype SubElementTag<Definition extends ElementsDefinition[string]> =\n  Definition extends string\n    ? Definition\n    : Definition extends { as?: infer Tag }\n      ? Tag extends keyof JSX.IntrinsicElements\n        ? Tag\n        : \"div\"\n      : \"div\";\n\n// Use public Tasty types so declarations do not leak its private sub-element aliases.\ntype SubElements<E extends ElementsDefinition> = {\n  [Name in keyof E]: ForwardRefExoticComponent<\n    PropsWithoutRef<SubElementProps<SubElementTag<E[Name]>>> &\n      RefAttributes<\n        SubElementTag<E[Name]> extends keyof HTMLElementTagNameMap\n          ? HTMLElementTagNameMap[SubElementTag<E[Name]>]\n          : unknown\n      >\n  >;\n};\n\n/** Create a named Tasty component with theme.styles[name] merged into its defaults. */\nexport function defineComponent<\n  K extends readonly (keyof StylesInterface)[],\n  V extends VariantMap,\n  E extends ElementsDefinition = Record<string, never>,\n  AsType extends ElementType = \"div\",\n  M extends ModPropsInput = readonly never[],\n  TP extends TokenPropsInput = readonly never[],\n>(\n  name: string,\n  options: TastyElementOptions<K, V, E, AsType, M, TP>,\n): TastyPolymorphicComponent<AsType, K, V, M, TP> & SubElements<E> {\n  return tasty<K, V, E, AsType, M, TP>({\n    ...options,\n    styles: resolveComponentStyles(name, options.styles ?? {}),\n  }) as TastyPolymorphicComponent<AsType, K, V, M, TP> & SubElements<E>;\n}\n","import { configureCookbookStates } from \"./components/tasty-states.js\";\n\n// Consumer components can be evaluated before Cookbook's own components.\nconfigureCookbookStates();\n\nexport { tasty, useGlobalStyles, mergeStyles } from \"@tenphi/tasty\";\nexport type { Styles } from \"@tenphi/tasty\";\nexport { defineComponent } from \"./define-component.js\";\nexport { resolveComponentStyles } from \"./components/component-styles.js\";\n"],"mappings":";;;;AA0CA,SAAgB,gBAQd,MACA,SACiE;CACjE,OAAOA,QAA8B;EACnC,GAAG;EACH,QAAQ,uBAAuB,MAAM,QAAQ,UAAU,CAAC,CAAC;CAC3D,CAAC;AACH;;;ACtDA,wBAAwB"}