@publish.os/nextjs 0.0.1-alpha.91 → 0.0.1-alpha.92

package/compiler-assets/nextjs/defaults/group/index.tsx

@@ -1,43 +1,48 @@
 import { Link } from "@components/ui/link";
 import type {
   IndexPageProps,
-  PageNode,
-  TreeNode,
+  NavigationNode,
+  NavigationPageNode,
 } from "@publish.os/nextjs/types";
 import { log } from "@source/_internal/logger";
 
-function pageNodes(nodes: TreeNode[]): PageNode[] {
+function pageNodes(nodes: NavigationNode[]): NavigationPageNode[] {
   return nodes.flatMap((node) => {
     if (node.type === "page") return [node];
-    if (node.type === "section" || node.type === "folder") {
+    if (
+      node.type === "section" ||
+      node.type === "folder" ||
+      node.type === "group"
+    ) {
       return pageNodes(node.children);
     }
+    if (node.type === "view") return pageNodes(node.items);
     return [];
   });
 }
 
 export default function GroupPage(props: IndexPageProps) {
   log.debug("[default:group-page]", props);
-  const { node, tree } = props;
-  const pages = pageNodes(tree);
+  const { node, navigation } = props;
+  const pages = pageNodes(navigation.items);
 
   return (
     <div className="flex min-h-[calc(100vh-var(--layout-global-nav-height))] min-w-0 items-start justify-center px-6 pb-16 pt-[clamp(5rem,18vh,10rem)] text-foreground-1 lg:px-10 supports-[height:100dvh]:min-h-[calc(100dvh-var(--layout-global-nav-height))] supports-[top:anchor-size(--global-navbar_height)]:min-h-[calc(100vh-anchor-size(--global-navbar_height,3.5rem))] supports-[top:anchor-size(--global-navbar_height)]:supports-[height:100dvh]:min-h-[calc(100dvh-anchor-size(--global-navbar_height,3.5rem))]">
       <div className="w-full max-w-md">
         <p className="mb-6 text-sm font-semibold text-foreground-1">
-          {node.title}
+          {node.label}
         </p>
         <h1 className="max-w-sm text-balance text-xl font-semibold leading-7 tracking-tight text-foreground-1">
           Browse the pages in this section.
         </h1>
 
         {pages.length > 0 ? (
-          <nav aria-label={`${node.title} pages`} className="mt-8">
+          <nav aria-label={`${node.label} pages`} className="mt-8">
             <ul className="flex flex-col gap-2 text-sm">
               {pages.map((page) => (
-                <li key={`${page.group}:${page.fileID}`}>
-                  <Link href={page.path} rightIcon="->" size="sm">
-                    {page.title}
+                <li key={page.id}>
+                  <Link href={page.href} rightIcon="->" size="sm">
+                    {page.label}
                   </Link>
                 </li>
               ))}

package/compiler-assets/nextjs/defaults/group/layout.tsx

@@ -3,13 +3,17 @@ import type { LayoutProps } from "@publish.os/nextjs/types";
 import { log } from "@source/_internal/logger";
 
 export default function GroupLayout(props: LayoutProps) {
-  const { children, currentPath, group, node, tree } = props;
+  const { children, currentPath, group, node, navigation } = props;
   log.debug("[default:group-layout]", { currentPath, group });
 
   return (
     <section className="mx-auto grid min-h-[calc(100vh-var(--layout-global-nav-height))] w-full max-w-(--layout-site-max-width) grid-cols-1 border-x border-stroke-3 bg-surface-1 md:grid-cols-[var(--layout-sidebar-width)_minmax(0,1fr)] xl:grid-cols-[var(--layout-sidebar-width)_minmax(0,1fr)_var(--layout-toc-width)] supports-[height:100dvh]:min-h-[calc(100dvh-var(--layout-global-nav-height))] supports-[top:anchor-size(--global-navbar_height)]:min-h-[calc(100vh-anchor-size(--global-navbar_height,3.5rem))] supports-[top:anchor-size(--global-navbar_height)]:supports-[height:100dvh]:min-h-[calc(100dvh-anchor-size(--global-navbar_height,3.5rem))]">
       <aside className="fixed top-(--layout-global-nav-height) z-content hidden h-[calc(100vh-var(--layout-global-nav-height))] min-h-0 border-l border-stroke-3 bg-surface-1 md:left-[max(0px,calc((100%-var(--layout-site-max-width))/2))] md:flex md:w-(--layout-sidebar-width) supports-[height:100dvh]:h-[calc(100dvh-var(--layout-global-nav-height))] supports-[top:anchor-size(--global-navbar_height)]:top-[anchor-size(--global-navbar_height,3.5rem)] supports-[top:anchor-size(--global-navbar_height)]:h-[calc(100vh-anchor-size(--global-navbar_height,3.5rem))] supports-[top:anchor-size(--global-navbar_height)]:supports-[height:100dvh]:h-[calc(100dvh-anchor-size(--global-navbar_height,3.5rem))]">
-        <Sidebar currentPath={currentPath} title={node.title} tree={tree} />
+        <Sidebar
+          currentPath={currentPath}
+          title={node.label}
+          navigation={navigation}
+        />
       </aside>
       <main
         className="flex min-h-0 min-w-0 flex-1 scroll-mt-[calc(var(--layout-global-nav-height)+1rem)] flex-col bg-surface-1 md:col-start-2"

package/compiler-assets/nextjs/defaults/group/page.tsx

@@ -8,10 +8,10 @@ import { log } from "@source/_internal/logger";
 export default async function ContentPage(props: PageProps) {
   log.debug("[default:content-page]", props);
   const sourceUrl =
-    typeof props.page.meta.sourceUrl === "string"
-      ? props.page.meta.sourceUrl
-      : typeof props.page.meta.githubUrl === "string"
-        ? props.page.meta.githubUrl
+    typeof props.page.frontmatter.sourceUrl === "string"
+      ? props.page.frontmatter.sourceUrl
+      : typeof props.page.frontmatter.githubUrl === "string"
+        ? props.page.frontmatter.githubUrl
         : undefined;
 
   return (
@@ -20,13 +20,14 @@ export default async function ContentPage(props: PageProps) {
         content={props.page.body}
         desktopClassName="xl:absolute xl:inset-y-0 xl:start-full xl:w-(--layout-toc-width) xl:px-3 xl:py-10"
         desktopListClassName="xl:sticky xl:top-[calc(var(--layout-global-nav-height)_+_1.5rem)] xl:max-h-[calc(100dvh-var(--layout-global-nav-height)-3rem)] xl:overflow-y-auto supports-[top:anchor-size(--global-navbar_height)]:xl:top-[calc(anchor-size(--global-navbar_height,3.5rem)_+_1.5rem)] supports-[top:anchor-size(--global-navbar_height)]:xl:max-h-[calc(100dvh-anchor-size(--global-navbar_height,3.5rem)-3rem)]"
+        mobileClassName="sticky top-(--layout-global-nav-height) z-nav supports-[top:anchor-size(--global-navbar_height)]:top-[anchor-size(--global-navbar_height,3.5rem)]"
         mobileQuery="(max-width: 1279px)"
       />
       <div className="flex min-w-0 flex-1 flex-col px-6 py-10 lg:px-10">
         <div className="mx-auto flex w-full max-w-(--layout-content-max-width) flex-1 flex-col">
           <article className="min-h-0 min-w-0 flex-1">
             <h1 className="text-3xl font-semibold tracking-tight text-foreground-1">
-              {props.page.title}
+              {props.page.frontmatter.title}
             </h1>
             <AgentActions
               className="mt-4"
@@ -42,7 +43,7 @@ export default async function ContentPage(props: PageProps) {
           <NextPrev
             className="mt-auto pt-12"
             currentPath={props.currentPath}
-            tree={props.tree}
+            navigation={props.navigation}
           />
         </div>
       </div>

package/compiler-assets/nextjs/defaults/project/next.config.mjs

@@ -11,12 +11,13 @@ const NEXT_IMAGE_OPTIMIZER_PATH = "__PUBLISHOS_NEXT_IMAGE_PATH__";
 
 /** @type {import("next").NextConfig} */
 export default {
+  env: { PUBLISHOS_SITE_BUILD_TIME: new Date().toISOString() },
   assetPrefix: INTERNAL_PREFIX,
   cacheComponents: true,
   // Preserve loopback origins so internal rewrites do not proxy back into this app.
   skipProxyUrlNormalize: true,
   experimental: { globalNotFound: true },
-  partialPrefetching: false,
+  partialPrefetching: true,
   // macOS native notifications can delay preview updates. Use Next's fallback.
   watchOptions:
     process.platform === "darwin" ? { pollIntervalMs: 1_000 } : undefined,

package/compiler-assets/nextjs/defaults/root/index.tsx

@@ -1,25 +1,30 @@
 import { Link } from "@components/ui/link";
 import type {
-  LinkNode,
+  NavigationGroupNode,
+  NavigationLinkNode,
   RootPageProps,
-  SectionNode,
-  TreeNode,
 } from "@publish.os/nextjs/types";
 import { log } from "@source/_internal/logger";
 
-type RootNavNode = LinkNode | (SectionNode & { path: string });
+type RootNavNode = NavigationLinkNode | NavigationGroupNode;
 
-function rootNavNodes(nodes: TreeNode[]): RootNavNode[] {
+function rootNavNodes(
+  nodes: RootPageProps["navigation"]["items"],
+): RootNavNode[] {
   return nodes.filter((node): node is RootNavNode => {
     if (node.type === "link") return true;
-    return node.type === "section" && typeof node.path === "string";
+    return (
+      node.type === "group" &&
+      node.presentation === "page" &&
+      Boolean(node.href)
+    );
   });
 }
 
 export default function HomePage(props: RootPageProps) {
   log.debug("[default:root-page]", props);
-  const { site, tree } = props;
-  const navNodes = rootNavNodes(tree);
+  const { site, navigation } = props;
+  const navNodes = rootNavNodes(navigation.items);
 
   return (
     <section className="mx-auto grid min-h-[calc(100vh-var(--layout-global-nav-height))] w-full max-w-(--layout-site-max-width) grid-cols-1 border-x border-stroke-3 bg-surface-1 md:grid-cols-[var(--layout-sidebar-width)_minmax(0,1fr)_var(--layout-toc-width)] supports-[height:100dvh]:min-h-[calc(100dvh-var(--layout-global-nav-height))] supports-[top:anchor-size(--global-navbar_height)]:min-h-[calc(100vh-anchor-size(--global-navbar_height,3.5rem))] supports-[top:anchor-size(--global-navbar_height)]:supports-[height:100dvh]:min-h-[calc(100dvh-anchor-size(--global-navbar_height,3.5rem))]">
@@ -45,11 +50,11 @@ export default function HomePage(props: RootPageProps) {
                   <li key={node.id}>
                     {node.type === "link" ? (
                       <Link href={node.href} rightIcon="->" size="sm">
-                        {node.title}
+                        {node.label}
                       </Link>
                     ) : (
-                      <Link href={node.path} rightIcon="->" size="sm">
-                        {node.title}
+                      <Link href={node.href} rightIcon="->" size="sm">
+                        {node.label}
                       </Link>
                     )}
                   </li>

package/compiler-assets/nextjs/defaults/root/layout.tsx

@@ -4,10 +4,10 @@ import { faviconsAndLogos } from "@source/.publishos/favicons-and-logos.generate
 import { log } from "@source/_internal/logger";
 
 export default function DefaultRootLayout(props: RootLayoutProps) {
-  const { children, site, tree } = props;
+  const { children, site, navigation } = props;
   log.debug("[default:root-layout]", {
     site: site.name,
-    treeItems: tree.length,
+    navigationItems: navigation.items.length,
   });
 
   return (
@@ -18,7 +18,11 @@ export default function DefaultRootLayout(props: RootLayoutProps) {
       >
         Skip to content
       </a>
-      <Navbar logo={faviconsAndLogos.logo} site={site} tree={tree} />
+      <Navbar
+        logo={faviconsAndLogos.logo}
+        site={site}
+        navigation={navigation}
+      />
       <div className="flex w-full flex-1 flex-col">{children}</div>
     </div>
   );

package/compiler-assets/nextjs/shims/agent-user-agents.ts

@@ -0,0 +1,65 @@
+// HTTP User-Agent product names that select Markdown when Accept leaves a tie.
+// Keep crawler names separate from general HTTP clients. A name is a hint, not
+// proof of identity. Check vendor documentation before adding a crawler.
+const AI_CRAWLERS = [
+  // https://developers.openai.com/api/docs/bots
+  "OAI-SearchBot",
+  "GPTBot",
+  "ChatGPT-User",
+  // https://support.claude.com/en/articles/8896518
+  "ClaudeBot",
+  "Claude-SearchBot",
+  "Claude-User",
+  // https://docs.perplexity.ai/docs/resources/perplexity-crawlers
+  "PerplexityBot",
+  "Perplexity-User",
+  // https://developers.google.com/crawling/docs/crawlers-fetchers/google-user-triggered-fetchers
+  "Google-Agent",
+  "Google-GeminiNotebook",
+  // https://developers.google.com/crawling/docs/crawlers-fetchers/google-common-crawlers
+  "Google-CloudVertexBot",
+];
+
+// General HTTP clients follow the existing Markdown tie-break policy.
+const HTTP_CLIENTS = [
+  "axios",
+  "got",
+  "node-fetch",
+  "undici",
+  "curl",
+  "wget",
+  "python-requests",
+  "httpx",
+  "aiohttp",
+];
+
+// Other client product names are not verified crawler identities.
+const CLIENT_PRODUCTS = [
+  "claude-code",
+  "claude",
+  "cursor",
+  "chatgpt",
+  "openai",
+  "perplexity",
+  "anthropic-ai",
+];
+
+const SUPPORTED_PRODUCTS = new Set(
+  [...AI_CRAWLERS, ...HTTP_CLIENTS, ...CLIENT_PRODUCTS].map((name) =>
+    name.toLowerCase(),
+  ),
+);
+
+export function isMarkdownClient(userAgent: string): boolean {
+  // Match whole product names, including those inside a compatible comment.
+  // A preceding slash is excluded so a URL in a comment is not a product.
+  const products = /(?:^|[\s(;])([A-Za-z0-9!#$%&'*+.^_`|~-]+)(?=\/|[\s;)]|$)/g;
+  for (
+    let product = products.exec(userAgent);
+    product;
+    product = products.exec(userAgent)
+  ) {
+    if (SUPPORTED_PRODUCTS.has(product[1].toLowerCase())) return true;
+  }
+  return false;
+}

package/compiler-assets/nextjs/shims/document.tsx

@@ -27,7 +27,15 @@ export default function SiteDocument({
         {beforeShell}
         <BodyWrapper>
           <Providers>
-            <RootLayout site={manifest.site} tree={manifest.tree}>
+            <RootLayout
+              site={manifest.site}
+              navigation={
+                manifest.groups.__root?.navigation ?? {
+                  rootGroup: "__root",
+                  items: [],
+                }
+              }
+            >
               {children}
             </RootLayout>
           </Providers>

package/compiler-assets/nextjs/shims/generated-leaf-page.tsx

@@ -5,6 +5,7 @@ import {
   createLeafPage,
   createLeafStaticParams,
 } from "@publish.os/nextjs/kernel/routes/pages/leaf";
+import { agentRouteConfig } from "@source/.publishos/agent-route-config.generated";
 import { markdownArtifactManifest } from "@source/.publishos/markdown-index.generated";
 import { ogManifest } from "@source/.publishos/og-manifest.generated";
 import { groupThemes } from "@source/.theme.generated";
@@ -15,6 +16,8 @@ const route = {
   group: __PUBLISHOS_GROUP_KEY__,
   manifest,
   markdownArtifactManifest,
+  markdownRoutesEnabled:
+    agentRouteConfig.enabled && agentRouteConfig.markdownRoutes,
   ogManifest,
   Leaf,
   PoweredByFooter,