@nexpress/theme-docs 0.3.1 → 0.3.3

package/dist/index.js

@@ -1,5 +1,365 @@
 // src/index.ts
-import { defineTheme } from "@nexpress/theme";
+import {
+  defineTheme
+} from "@nexpress/theme";
+
+// src/copy-button-bridge.ts
+import { CopyButton } from "./components/copy-button.js";
+
+// src/blocks/index.tsx
+import { jsx, jsxs } from "react/jsx-runtime";
+var readString = (value, fallback) => typeof value === "string" && value.trim().length > 0 ? value : fallback;
+var isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+var CALLOUT_VARIANTS = ["default", "note", "warn", "danger"];
+function readCalloutVariant(value) {
+  if (typeof value === "string") {
+    for (const candidate of CALLOUT_VARIANTS) {
+      if (candidate === value) return candidate;
+    }
+  }
+  return "default";
+}
+function CalloutIcon({ variant }) {
+  if (variant === "warn") {
+    return /* @__PURE__ */ jsxs(
+      "svg",
+      {
+        width: "18",
+        height: "18",
+        viewBox: "0 0 24 24",
+        fill: "none",
+        stroke: "currentColor",
+        strokeWidth: "2",
+        strokeLinecap: "round",
+        strokeLinejoin: "round",
+        "aria-hidden": "true",
+        children: [
+          /* @__PURE__ */ jsx("path", { d: "M10.29 3.86 1.82 18a2 2 0 0 0 1.71 3h16.94a2 2 0 0 0 1.71-3L13.71 3.86a2 2 0 0 0-3.42 0Z" }),
+          /* @__PURE__ */ jsx("line", { x1: "12", y1: "9", x2: "12", y2: "13" }),
+          /* @__PURE__ */ jsx("line", { x1: "12", y1: "17", x2: "12.01", y2: "17" })
+        ]
+      }
+    );
+  }
+  if (variant === "danger") {
+    return /* @__PURE__ */ jsxs(
+      "svg",
+      {
+        width: "18",
+        height: "18",
+        viewBox: "0 0 24 24",
+        fill: "none",
+        stroke: "currentColor",
+        strokeWidth: "2",
+        strokeLinecap: "round",
+        strokeLinejoin: "round",
+        "aria-hidden": "true",
+        children: [
+          /* @__PURE__ */ jsx("polygon", { points: "7.86 2 16.14 2 22 7.86 22 16.14 16.14 22 7.86 22 2 16.14 2 7.86 7.86 2" }),
+          /* @__PURE__ */ jsx("line", { x1: "15", y1: "9", x2: "9", y2: "15" }),
+          /* @__PURE__ */ jsx("line", { x1: "9", y1: "9", x2: "15", y2: "15" })
+        ]
+      }
+    );
+  }
+  return /* @__PURE__ */ jsxs(
+    "svg",
+    {
+      width: "18",
+      height: "18",
+      viewBox: "0 0 24 24",
+      fill: "none",
+      stroke: "currentColor",
+      strokeWidth: "2",
+      strokeLinecap: "round",
+      strokeLinejoin: "round",
+      "aria-hidden": "true",
+      children: [
+        /* @__PURE__ */ jsx("circle", { cx: "12", cy: "12", r: "10" }),
+        /* @__PURE__ */ jsx("line", { x1: "12", y1: "16", x2: "12", y2: "12" }),
+        /* @__PURE__ */ jsx("line", { x1: "12", y1: "8", x2: "12.01", y2: "8" })
+      ]
+    }
+  );
+}
+var docsCalloutBlock = {
+  type: "docsCallout",
+  label: "Callout",
+  description: "Highlighted note / warning / danger panel with a leading icon.",
+  icon: "Info",
+  iconKind: "lucide",
+  summaryFields: ["title"],
+  category: "Content",
+  source: "theme",
+  keywords: ["note", "warning", "danger", "admonition", "info"],
+  defaultProps: {
+    variant: "default",
+    title: "Heads up",
+    body: "Add context that an operator should not miss when scanning the page."
+  },
+  propsSchema: [
+    {
+      name: "variant",
+      label: "Variant",
+      type: "select",
+      defaultValue: "default",
+      options: [
+        { label: "Default", value: "default" },
+        { label: "Note", value: "note" },
+        { label: "Warning", value: "warn" },
+        { label: "Danger", value: "danger" }
+      ]
+    },
+    { name: "title", label: "Title", type: "text", defaultValue: "Heads up" },
+    {
+      name: "body",
+      label: "Body",
+      type: "textarea",
+      defaultValue: "Add context that an operator should not miss when scanning the page."
+    }
+  ],
+  render: (props) => {
+    const variant = readCalloutVariant(props.variant);
+    const title = readString(props.title, "Heads up");
+    const body = readString(props.body, "");
+    return /* @__PURE__ */ jsxs("aside", { className: `np-docs-callout np-docs-callout--${variant}`, children: [
+      /* @__PURE__ */ jsx(CalloutIcon, { variant }),
+      /* @__PURE__ */ jsxs("div", { children: [
+        /* @__PURE__ */ jsx("div", { className: "np-docs-callout-title", children: title }),
+        body ? /* @__PURE__ */ jsx("p", { children: body }) : null
+      ] })
+    ] });
+  }
+};
+var docsCodePanelBlock = {
+  type: "docsCodePanel",
+  label: "Code panel",
+  description: "Dark code surface with filename, language pill, and copy button.",
+  icon: "Code2",
+  iconKind: "lucide",
+  summaryFields: ["filename", "language"],
+  category: "Content",
+  source: "theme",
+  keywords: ["code", "snippet", "syntax", "block"],
+  defaultProps: {
+    filename: "example.ts",
+    language: "ts",
+    source: 'export const greeting = "hello";'
+  },
+  propsSchema: [
+    {
+      name: "filename",
+      label: "Filename",
+      type: "text",
+      defaultValue: "example.ts"
+    },
+    {
+      name: "language",
+      label: "Language",
+      type: "text",
+      defaultValue: "ts"
+    },
+    {
+      name: "source",
+      label: "Source",
+      type: "textarea",
+      rows: 10,
+      defaultValue: 'export const greeting = "hello";'
+    }
+  ],
+  render: (props) => {
+    const filename = readString(props.filename, "");
+    const language = readString(props.language, "");
+    const source = readString(props.source, "");
+    return /* @__PURE__ */ jsxs("div", { className: "np-docs-code", children: [
+      /* @__PURE__ */ jsxs("div", { className: "np-docs-code-head", children: [
+        /* @__PURE__ */ jsxs("span", { className: "np-docs-code-file", children: [
+          filename ? /* @__PURE__ */ jsx("span", { children: filename }) : null,
+          language ? /* @__PURE__ */ jsx("span", { className: "np-docs-brand-version", children: language }) : null
+        ] }),
+        /* @__PURE__ */ jsx(CopyButton, { text: source })
+      ] }),
+      /* @__PURE__ */ jsx("pre", { children: /* @__PURE__ */ jsx("code", { children: source }) })
+    ] });
+  }
+};
+var docsShellCommandBlock = {
+  type: "docsShellCommand",
+  label: "Shell command",
+  description: "Inline terminal-style command snippet with a copy button.",
+  icon: "Terminal",
+  iconKind: "lucide",
+  summaryFields: ["command"],
+  category: "Content",
+  source: "theme",
+  keywords: ["terminal", "shell", "bash", "command", "cli"],
+  defaultProps: {
+    prompt: "$",
+    command: "pnpm install"
+  },
+  propsSchema: [
+    { name: "prompt", label: "Prompt", type: "text", defaultValue: "$" },
+    {
+      name: "command",
+      label: "Command",
+      type: "text",
+      defaultValue: "pnpm install"
+    }
+  ],
+  render: (props) => {
+    const prompt = readString(props.prompt, "$");
+    const command = readString(props.command, "");
+    return /* @__PURE__ */ jsxs("div", { className: "np-docs-cmdline", children: [
+      /* @__PURE__ */ jsx("span", { className: "np-docs-cmdline-prompt", children: prompt }),
+      /* @__PURE__ */ jsx("code", { className: "np-docs-cmdline-cmd", children: command }),
+      /* @__PURE__ */ jsx(CopyButton, { text: command, className: "np-docs-cmdline-copy" })
+    ] });
+  }
+};
+function readSteps(value) {
+  if (!Array.isArray(value)) return [];
+  return value.filter(isRecord).map((item) => ({
+    title: readString(item.title, "Step"),
+    body: readString(item.body, "")
+  }));
+}
+var docsStepsBlock = {
+  type: "docsSteps",
+  label: "Steps",
+  description: "Numbered checklist of ordered steps.",
+  icon: "ListOrdered",
+  iconKind: "lucide",
+  category: "Content",
+  source: "theme",
+  keywords: ["steps", "checklist", "ordered", "numbered", "tutorial"],
+  defaultProps: {
+    items: [
+      { title: "Install", body: "Add the package to your workspace." },
+      { title: "Configure", body: "Wire it into the bootstrap." },
+      { title: "Run", body: "Boot the dev server and verify." }
+    ]
+  },
+  propsSchema: [
+    {
+      name: "items",
+      label: "Steps",
+      type: "array",
+      defaultValue: [
+        { title: "Install", body: "Add the package to your workspace." },
+        { title: "Configure", body: "Wire it into the bootstrap." },
+        { title: "Run", body: "Boot the dev server and verify." }
+      ],
+      itemDefault: { title: "New step", body: "" },
+      itemSchema: [
+        { name: "title", label: "Title", type: "text", defaultValue: "New step" },
+        { name: "body", label: "Body", type: "textarea", defaultValue: "" }
+      ]
+    }
+  ],
+  render: (props) => {
+    const items = readSteps(props.items);
+    if (items.length === 0) return /* @__PURE__ */ jsx("ol", { className: "np-docs-steps" });
+    return /* @__PURE__ */ jsx("ol", { className: "np-docs-steps", children: items.map((step, index) => /* @__PURE__ */ jsxs("li", { children: [
+      /* @__PURE__ */ jsx("div", { className: "np-docs-step-title", children: step.title }),
+      step.body ? /* @__PURE__ */ jsx("p", { className: "np-docs-step-body", children: step.body }) : null
+    ] }, `step-${index.toString()}`)) });
+  }
+};
+var docsApiTableBlock = {
+  type: "docsApiTable",
+  label: "API table",
+  description: "Reference table with uppercase mono headers and a required pill.",
+  icon: "Table",
+  iconKind: "lucide",
+  category: "Content",
+  source: "theme",
+  keywords: ["api", "reference", "table", "schema", "props"],
+  defaultProps: {
+    columns: ["Name", "Type", "Description"],
+    rows: [
+      { cells: ["slug", "string", "Unique URL fragment."], required: true },
+      { cells: ["title", "string", "Document title."], required: true },
+      { cells: ["body", "RichText", "Lexical body content."], required: false }
+    ]
+  },
+  propsSchema: [
+    {
+      name: "columns",
+      label: "Columns",
+      type: "array",
+      defaultValue: ["Name", "Type", "Description"],
+      itemDefault: { value: "Column" },
+      itemSchema: [
+        { name: "value", label: "Header", type: "text", defaultValue: "Column" }
+      ]
+    },
+    {
+      name: "rows",
+      label: "Rows",
+      type: "array",
+      defaultValue: [
+        { cells: ["slug", "string", "Unique URL fragment."], required: true }
+      ],
+      itemDefault: { cells: [], required: false },
+      itemSchema: [
+        {
+          name: "cells",
+          label: "Cells",
+          type: "array",
+          defaultValue: [],
+          itemDefault: { value: "" },
+          itemSchema: [
+            { name: "value", label: "Cell", type: "text", defaultValue: "" }
+          ]
+        },
+        {
+          name: "required",
+          label: "Required",
+          type: "boolean",
+          defaultValue: false
+        }
+      ]
+    }
+  ],
+  render: (props) => {
+    const rawColumns = props.columns;
+    const columns = Array.isArray(rawColumns) ? rawColumns.map((entry) => {
+      if (typeof entry === "string") return entry;
+      if (isRecord(entry) && typeof entry.value === "string") return entry.value;
+      return "";
+    }) : [];
+    const rawRows = Array.isArray(props.rows) ? props.rows : [];
+    const rows = rawRows.filter(isRecord).map((row) => {
+      const cellsRaw = row.cells;
+      const cells = Array.isArray(cellsRaw) ? cellsRaw.map((entry) => {
+        if (typeof entry === "string") return entry;
+        if (isRecord(entry) && typeof entry.value === "string") return entry.value;
+        return "";
+      }) : [];
+      return { cells, required: row.required === true };
+    });
+    if (columns.length === 0 && rows.length === 0) {
+      return /* @__PURE__ */ jsx("table", { className: "np-docs-table" });
+    }
+    return /* @__PURE__ */ jsxs("table", { className: "np-docs-table", children: [
+      /* @__PURE__ */ jsx("thead", { children: /* @__PURE__ */ jsx("tr", { children: columns.map((col, i) => /* @__PURE__ */ jsx("th", { children: col }, `col-${i.toString()}`)) }) }),
+      /* @__PURE__ */ jsx("tbody", { children: rows.map((row, i) => /* @__PURE__ */ jsx("tr", { children: row.cells.map((cell, j) => {
+        const isFirst = j === 0;
+        return /* @__PURE__ */ jsxs("td", { children: [
+          isFirst ? /* @__PURE__ */ jsx("code", { children: cell }) : cell,
+          isFirst && row.required ? /* @__PURE__ */ jsx("span", { className: "np-docs-table-required", children: "required" }) : null
+        ] }, `cell-${i.toString()}-${j.toString()}`);
+      }) }, `row-${i.toString()}`)) })
+    ] });
+  }
+};
+var docsBlocks = [
+  docsCalloutBlock,
+  docsCodePanelBlock,
+  docsShellCommandBlock,
+  docsStepsBlock,
+  docsApiTableBlock
+];
 
 // src/header.tsx
 import { NavMenu, getCachedSite } from "@nexpress/next";
@@ -17,6 +377,15 @@ var docsSettingsSchema = z.object({
   githubRepo: z.string().url().optional().describe(
     "Optional repository URL \u2014 when set, page templates render an 'Edit on GitHub' link in the prev/next bar."
   ),
+  githubBranch: z.string().default("main").describe(
+    "Branch the 'Edit on GitHub' link points at. Default 'main' \u2014 change to 'master' / 'docs' / whatever the repo uses."
+  ),
+  githubDocsPath: z.string().default("docs").describe(
+    "Path under the repo where doc source files live. Joined with the doc slug to build the edit link target."
+  ),
+  githubExtension: z.string().default(".md").describe(
+    "File extension appended to the slug when building the edit link (e.g. '.md', '.mdx'). Include the leading dot."
+  ),
   sidebarHeading: z.string().default("Documentation").describe("Heading shown above the hierarchical sidebar nav."),
   showTableOfContents: z.boolean().default(true).describe("Render the in-page TOC sidebar on doc pages."),
   searchPlaceholder: z.string().default("Search the docs\u2026").describe("Placeholder text for the search input in the masthead.")
@@ -31,7 +400,7 @@ async function resolveDocsSettings() {
 }
 
 // src/header.tsx
-import { jsx, jsxs } from "react/jsx-runtime";
+import { jsx as jsx2, jsxs as jsxs2 } from "react/jsx-runtime";
 var FALLBACK_SITE_NAME = "NexPress";
 async function DocsHeader() {
   const [settings, site] = await Promise.all([
@@ -39,13 +408,13 @@ async function DocsHeader() {
     getCachedSite()
   ]);
   const siteName = site?.name?.trim() || FALLBACK_SITE_NAME;
-  return /* @__PURE__ */ jsx("header", { className: "np-docs-header", children: /* @__PURE__ */ jsxs("div", { className: "np-docs-header-inner", children: [
-    /* @__PURE__ */ jsxs("a", { href: "/", className: "np-docs-brand", children: [
-      /* @__PURE__ */ jsx("span", { className: "np-docs-brand-mark", "aria-hidden": "true" }),
-      /* @__PURE__ */ jsx("span", { className: "np-docs-brand-name", children: siteName }),
-      /* @__PURE__ */ jsx("span", { className: "np-docs-brand-version", children: settings.version })
+  return /* @__PURE__ */ jsx2("header", { className: "np-docs-header", children: /* @__PURE__ */ jsxs2("div", { className: "np-docs-header-inner", children: [
+    /* @__PURE__ */ jsxs2("a", { href: "/", className: "np-docs-brand", children: [
+      /* @__PURE__ */ jsx2("span", { className: "np-docs-brand-mark", "aria-hidden": "true" }),
+      /* @__PURE__ */ jsx2("span", { className: "np-docs-brand-name", children: siteName }),
+      /* @__PURE__ */ jsx2("span", { className: "np-docs-brand-version", children: settings.version })
     ] }),
-    /* @__PURE__ */ jsxs(
+    /* @__PURE__ */ jsxs2(
       "form",
       {
         action: "/docs/search",
@@ -53,7 +422,7 @@ async function DocsHeader() {
         className: "np-docs-search-form",
         role: "search",
         children: [
-          /* @__PURE__ */ jsxs(
+          /* @__PURE__ */ jsxs2(
             "svg",
             {
               width: "14",
@@ -64,13 +433,13 @@ async function DocsHeader() {
               strokeWidth: "2",
               "aria-hidden": "true",
               children: [
-                /* @__PURE__ */ jsx("circle", { cx: "11", cy: "11", r: "7" }),
-                /* @__PURE__ */ jsx("path", { d: "m21 21-4.3-4.3" })
+                /* @__PURE__ */ jsx2("circle", { cx: "11", cy: "11", r: "7" }),
+                /* @__PURE__ */ jsx2("path", { d: "m21 21-4.3-4.3" })
               ]
             }
           ),
-          /* @__PURE__ */ jsx("label", { className: "sr-only", htmlFor: "np-docs-search-input", children: "Search the docs" }),
-          /* @__PURE__ */ jsx(
+          /* @__PURE__ */ jsx2("label", { className: "sr-only", htmlFor: "np-docs-search-input", children: "Search the docs" }),
+          /* @__PURE__ */ jsx2(
             "input",
             {
               id: "np-docs-search-input",
@@ -80,14 +449,14 @@ async function DocsHeader() {
               className: "np-docs-search-input"
             }
           ),
-          /* @__PURE__ */ jsx("kbd", { className: "np-docs-search-kbd", children: "\u2318K" })
+          /* @__PURE__ */ jsx2("kbd", { className: "np-docs-search-kbd", children: "\u2318K" })
         ]
       }
     ),
-    /* @__PURE__ */ jsx(SearchKeyboardShortcut, { targetId: "np-docs-search-input" }),
-    /* @__PURE__ */ jsxs("nav", { className: "np-docs-nav", "aria-label": "Primary", children: [
-      /* @__PURE__ */ jsx(NavMenu, { location: "primary", className: "np-docs-primary-nav" }),
-      settings.githubRepo ? /* @__PURE__ */ jsxs(
+    /* @__PURE__ */ jsx2(SearchKeyboardShortcut, { targetId: "np-docs-search-input" }),
+    /* @__PURE__ */ jsxs2("nav", { className: "np-docs-nav", "aria-label": "Primary", children: [
+      /* @__PURE__ */ jsx2(NavMenu, { location: "header", className: "np-docs-primary-nav" }),
+      settings.githubRepo ? /* @__PURE__ */ jsxs2(
         "a",
         {
           href: settings.githubRepo,
@@ -96,7 +465,7 @@ async function DocsHeader() {
           rel: "noreferrer",
           "aria-label": "GitHub repository",
           children: [
-            /* @__PURE__ */ jsx(
+            /* @__PURE__ */ jsx2(
               "svg",
               {
                 width: "14",
@@ -104,7 +473,7 @@ async function DocsHeader() {
                 viewBox: "0 0 24 24",
                 fill: "currentColor",
                 "aria-hidden": "true",
-                children: /* @__PURE__ */ jsx("path", { d: "M12 .5a12 12 0 0 0-3.8 23.39c.6.11.82-.26.82-.58v-2c-3.34.73-4.04-1.61-4.04-1.61-.55-1.39-1.34-1.76-1.34-1.76-1.1-.75.08-.74.08-.74 1.21.09 1.85 1.24 1.85 1.24 1.07 1.84 2.81 1.31 3.5 1 .11-.78.42-1.31.76-1.61-2.66-.3-5.47-1.33-5.47-5.93 0-1.31.47-2.38 1.24-3.22-.12-.3-.54-1.52.12-3.17 0 0 1-.32 3.3 1.23a11.5 11.5 0 0 1 6 0c2.28-1.55 3.29-1.23 3.29-1.23.66 1.65.25 2.87.12 3.17.77.84 1.24 1.91 1.24 3.22 0 4.61-2.81 5.62-5.49 5.92.43.37.81 1.1.81 2.22v3.29c0 .32.22.7.83.58A12 12 0 0 0 12 .5Z" })
+                children: /* @__PURE__ */ jsx2("path", { d: "M12 .5a12 12 0 0 0-3.8 23.39c.6.11.82-.26.82-.58v-2c-3.34.73-4.04-1.61-4.04-1.61-.55-1.39-1.34-1.76-1.34-1.76-1.1-.75.08-.74.08-.74 1.21.09 1.85 1.24 1.85 1.24 1.07 1.84 2.81 1.31 3.5 1 .11-.78.42-1.31.76-1.61-2.66-.3-5.47-1.33-5.47-5.93 0-1.31.47-2.38 1.24-3.22-.12-.3-.54-1.52.12-3.17 0 0 1-.32 3.3 1.23a11.5 11.5 0 0 1 6 0c2.28-1.55 3.29-1.23 3.29-1.23.66 1.65.25 2.87.12 3.17.77.84 1.24 1.91 1.24 3.22 0 4.61-2.81 5.62-5.49 5.92.43.37.81 1.1.81 2.22v3.29c0 .32.22.7.83.58A12 12 0 0 0 12 .5Z" })
               }
             ),
             "GitHub"
@@ -116,9 +485,9 @@ async function DocsHeader() {
 }
 
 // src/members-not-found.tsx
-import { jsx as jsx2, jsxs as jsxs2 } from "react/jsx-runtime";
+import { jsx as jsx3, jsxs as jsxs3 } from "react/jsx-runtime";
 function DocsMembersNotFound() {
-  return /* @__PURE__ */ jsxs2(
+  return /* @__PURE__ */ jsxs3(
     "div",
     {
       className: "np-docs-members-not-found",
@@ -128,7 +497,7 @@ function DocsMembersNotFound() {
         padding: "0 1.5rem"
       },
       children: [
-        /* @__PURE__ */ jsx2(
+        /* @__PURE__ */ jsx3(
           "p",
           {
             style: {
@@ -142,7 +511,7 @@ function DocsMembersNotFound() {
             children: "404 \xB7 account"
           }
         ),
-        /* @__PURE__ */ jsx2(
+        /* @__PURE__ */ jsx3(
           "h1",
           {
             style: {
@@ -155,7 +524,7 @@ function DocsMembersNotFound() {
             children: "That account link is no longer valid."
           }
         ),
-        /* @__PURE__ */ jsx2(
+        /* @__PURE__ */ jsx3(
           "p",
           {
             style: {
@@ -167,7 +536,7 @@ function DocsMembersNotFound() {
             children: "Verification and password-reset links are single-use and expire after a short window. Open the sign-in page and request a fresh one."
           }
         ),
-        /* @__PURE__ */ jsx2("p", { style: { margin: "1.75rem 0 0" }, children: /* @__PURE__ */ jsx2(
+        /* @__PURE__ */ jsx3("p", { style: { margin: "1.75rem 0 0" }, children: /* @__PURE__ */ jsx3(
           "a",
           {
             href: "/members/login",
@@ -190,18 +559,18 @@ function DocsMembersNotFound() {
 }
 
 // src/members-shell.tsx
-import { jsx as jsx3, jsxs as jsxs3 } from "react/jsx-runtime";
+import { jsx as jsx4, jsxs as jsxs4 } from "react/jsx-runtime";
 function DocsMembersShell({ children }) {
-  return /* @__PURE__ */ jsxs3("div", { className: "np-docs np-docs-shell", children: [
-    /* @__PURE__ */ jsx3(DocsHeader, {}),
-    /* @__PURE__ */ jsx3("div", { className: "np-docs-members", children: /* @__PURE__ */ jsx3("div", { className: "np-docs-members-column", children }) })
+  return /* @__PURE__ */ jsxs4("div", { className: "np-docs np-docs-shell", children: [
+    /* @__PURE__ */ jsx4(DocsHeader, {}),
+    /* @__PURE__ */ jsx4("div", { className: "np-docs-members", children: /* @__PURE__ */ jsx4("div", { className: "np-docs-members-column", children }) })
   ] });
 }
 
 // src/not-found.tsx
-import { jsx as jsx4, jsxs as jsxs4 } from "react/jsx-runtime";
+import { jsx as jsx5, jsxs as jsxs5 } from "react/jsx-runtime";
 function DocsNotFound() {
-  return /* @__PURE__ */ jsxs4(
+  return /* @__PURE__ */ jsxs5(
     "div",
     {
       className: "np-docs-not-found",
@@ -211,7 +580,7 @@ function DocsNotFound() {
         padding: "0 1.5rem"
       },
       children: [
-        /* @__PURE__ */ jsx4(
+        /* @__PURE__ */ jsx5(
           "p",
           {
             style: {
@@ -224,8 +593,8 @@ function DocsNotFound() {
             children: "404 \u2014 Not found"
           }
         ),
-        /* @__PURE__ */ jsx4("h1", { style: { margin: "0.75rem 0 0.5rem", fontSize: "1.75rem" }, children: "That page isn't in the docs." }),
-        /* @__PURE__ */ jsx4(
+        /* @__PURE__ */ jsx5("h1", { style: { margin: "0.75rem 0 0.5rem", fontSize: "1.75rem" }, children: "That page isn't in the docs." }),
+        /* @__PURE__ */ jsx5(
           "p",
           {
             style: {
@@ -235,7 +604,7 @@ function DocsNotFound() {
             children: "It may have been renamed or merged into another section. Try the search bar in the header, or head to the homepage."
           }
         ),
-        /* @__PURE__ */ jsx4(
+        /* @__PURE__ */ jsx5(
           "a",
           {
             href: "/",
@@ -269,7 +638,7 @@ import { extractHeadingToc, renderRichText } from "@nexpress/editor/server";
 import { TocScrollspy } from "./components/toc-scrollspy.js";
 
 // src/templates/doc-page.tsx
-import { Fragment as Fragment2, jsx as jsx5, jsxs as jsxs5 } from "react/jsx-runtime";
+import { Fragment as Fragment2, jsx as jsx6, jsxs as jsxs6 } from "react/jsx-runtime";
 async function DocPageTemplate({
   doc: rawDoc
 }) {
@@ -279,92 +648,103 @@ async function DocPageTemplate({
   const navInfo = await loadPrevNext(doc);
   const updatedLabel = formatUpdated(doc.updatedAt ?? doc.publishedAt);
   const readingLabel = readingMinutesLabel(doc.readingTime);
-  const editHref = settings.githubRepo ? `${settings.githubRepo}/edit/main/docs/${doc.slug}.md` : null;
+  const editHref = settings.githubRepo ? `${settings.githubRepo}/edit/${settings.githubBranch}/${settings.githubDocsPath}/${doc.slug}${settings.githubExtension}` : null;
   const toc = extractHeadingToc(doc.body);
   const reportIssueHref = settings.githubRepo ? `${settings.githubRepo}/issues/new` : null;
-  return /* @__PURE__ */ jsxs5(Fragment2, { children: [
-    /* @__PURE__ */ jsxs5("article", { className: "np-docs-page", children: [
-      /* @__PURE__ */ jsx5("nav", { className: "np-docs-breadcrumbs", "aria-label": "Breadcrumb", children: breadcrumbs.map((crumb, index) => {
+  return /* @__PURE__ */ jsxs6(Fragment2, { children: [
+    /* @__PURE__ */ jsxs6("article", { className: "np-docs-page", children: [
+      /* @__PURE__ */ jsx6("nav", { className: "np-docs-breadcrumbs", "aria-label": "Breadcrumb", children: breadcrumbs.map((crumb, index) => {
         const isLast = index === breadcrumbs.length - 1;
-        return /* @__PURE__ */ jsxs5(React.Fragment, { children: [
-          index > 0 ? /* @__PURE__ */ jsx5("span", { className: "np-docs-breadcrumbs-sep", "aria-hidden": "true", children: "/" }) : null,
-          isLast || !crumb.slug ? /* @__PURE__ */ jsx5("span", { children: crumb.title }) : /* @__PURE__ */ jsx5("a", { href: `/docs/${crumb.slug}`, children: crumb.title })
+        return /* @__PURE__ */ jsxs6(React.Fragment, { children: [
+          index > 0 ? /* @__PURE__ */ jsx6("span", { className: "np-docs-breadcrumbs-sep", "aria-hidden": "true", children: "/" }) : null,
+          isLast || !crumb.slug ? /* @__PURE__ */ jsx6("span", { children: crumb.title }) : /* @__PURE__ */ jsx6("a", { href: `/docs/${crumb.slug}`, children: crumb.title })
         ] }, `crumb-${index.toString()}-${crumb.slug ?? "root"}`);
       }) }),
-      /* @__PURE__ */ jsx5("h1", { children: doc.title }),
-      doc.lede ? /* @__PURE__ */ jsx5("p", { className: "np-docs-page-lede", children: doc.lede }) : null,
-      doc.stableSince || readingLabel || updatedLabel || editHref ? /* @__PURE__ */ jsxs5("div", { className: "np-docs-page-meta", children: [
-        doc.stableSince ? /* @__PURE__ */ jsxs5("span", { className: "np-docs-page-meta-pill status", children: [
+      /* @__PURE__ */ jsx6("h1", { children: doc.title }),
+      doc.lede ? /* @__PURE__ */ jsx6("p", { className: "np-docs-page-lede", children: doc.lede }) : null,
+      doc.stableSince || readingLabel || updatedLabel || editHref ? /* @__PURE__ */ jsxs6("div", { className: "np-docs-page-meta", children: [
+        doc.stableSince ? /* @__PURE__ */ jsxs6("span", { className: "np-docs-page-meta-pill status", children: [
           "Stable since ",
           doc.stableSince
         ] }) : null,
-        readingLabel ? /* @__PURE__ */ jsx5("span", { className: "np-docs-page-meta-pill", children: readingLabel }) : null,
-        updatedLabel ? /* @__PURE__ */ jsxs5(Fragment2, { children: [
-          /* @__PURE__ */ jsx5("span", { className: "np-docs-page-meta-sep", "aria-hidden": "true", children: "\xB7" }),
-          /* @__PURE__ */ jsxs5("span", { children: [
+        readingLabel ? /* @__PURE__ */ jsx6("span", { className: "np-docs-page-meta-pill", children: readingLabel }) : null,
+        updatedLabel ? /* @__PURE__ */ jsxs6(Fragment2, { children: [
+          /* @__PURE__ */ jsx6("span", { className: "np-docs-page-meta-sep", "aria-hidden": "true", children: "\xB7" }),
+          /* @__PURE__ */ jsxs6("span", { children: [
             "Updated ",
             updatedLabel
           ] })
         ] }) : null,
-        editHref ? /* @__PURE__ */ jsx5("a", { href: editHref, target: "_blank", rel: "noreferrer", children: "Edit this page \u2192" }) : null
+        editHref ? /* @__PURE__ */ jsx6("a", { href: editHref, target: "_blank", rel: "noreferrer", children: "Edit this page \u2192" }) : null
       ] }) : null,
-      /* @__PURE__ */ jsx5("div", { className: "np-docs-page-body", children: doc.body ? (
+      /* @__PURE__ */ jsx6("div", { className: "np-docs-page-body", children: doc.body ? (
         // Core types `NpRichTextContent` as the opaque
         // `Record<string, unknown>`; the editor's renderer
         // refines it to `{ root: ... }`. Structural cast at
         // the boundary — both sides go through the same
         // Lexical serializer.
-        renderRichText(doc.body)
-      ) : /* @__PURE__ */ jsx5("p", { style: { color: "var(--np-color-muted-foreground)" }, children: "No body content yet." }) }),
-      /* @__PURE__ */ jsxs5("div", { className: "np-docs-feedback", children: [
-        /* @__PURE__ */ jsxs5("div", { children: [
-          /* @__PURE__ */ jsx5("div", { className: "np-docs-feedback-title", children: "Was this page helpful?" }),
-          /* @__PURE__ */ jsx5("div", { className: "np-docs-feedback-helper", children: "Operators wire the feedback endpoint via a plugin or a custom client island \u2014 the form is intentionally inert in v0.1." })
+        renderRichText(
+          doc.body,
+          { headingAnchors: true }
+        )
+      ) : /* @__PURE__ */ jsx6("p", { style: { color: "var(--np-color-muted-foreground)" }, children: "No body content yet." }) }),
+      /* @__PURE__ */ jsxs6("div", { className: "np-docs-feedback", children: [
+        /* @__PURE__ */ jsxs6("div", { children: [
+          /* @__PURE__ */ jsx6("div", { className: "np-docs-feedback-title", children: "Was this page helpful?" }),
+          /* @__PURE__ */ jsx6("div", { className: "np-docs-feedback-helper", children: "Operators wire the feedback endpoint via a plugin or a custom client island \u2014 the form is intentionally inert in v0.1." })
         ] }),
-        /* @__PURE__ */ jsxs5("div", { className: "np-docs-feedback-buttons", children: [
-          /* @__PURE__ */ jsx5("button", { type: "button", children: "Yes" }),
-          /* @__PURE__ */ jsx5("button", { type: "button", children: "Could be better" })
+        /* @__PURE__ */ jsxs6("div", { className: "np-docs-feedback-buttons", children: [
+          /* @__PURE__ */ jsx6("button", { type: "button", children: "Yes" }),
+          /* @__PURE__ */ jsx6("button", { type: "button", children: "Could be better" })
         ] })
       ] }),
-      /* @__PURE__ */ jsxs5("nav", { className: "np-docs-prev-next", "aria-label": "Pagination", children: [
-        navInfo.prev ? /* @__PURE__ */ jsxs5(
-          "a",
-          {
-            href: `/docs/${navInfo.prev.slug}`,
-            className: "np-docs-prev-next-prev",
-            children: [
-              /* @__PURE__ */ jsx5("div", { className: "np-docs-prev-next-dir", children: "\u2190 Previous" }),
-              /* @__PURE__ */ jsx5("div", { className: "np-docs-prev-next-title", children: navInfo.prev.title })
-            ]
-          }
-        ) : /* @__PURE__ */ jsx5("span", {}),
-        navInfo.next ? /* @__PURE__ */ jsxs5(
-          "a",
-          {
-            href: `/docs/${navInfo.next.slug}`,
-            className: "np-docs-prev-next-next",
-            children: [
-              /* @__PURE__ */ jsx5("div", { className: "np-docs-prev-next-dir", children: "Next \u2192" }),
-              /* @__PURE__ */ jsx5("div", { className: "np-docs-prev-next-title", children: navInfo.next.title })
-            ]
-          }
-        ) : /* @__PURE__ */ jsx5("span", {})
-      ] })
+      navInfo.prev || navInfo.next ? /* @__PURE__ */ jsxs6(
+        "nav",
+        {
+          className: "np-docs-prev-next",
+          "aria-label": "Pagination",
+          "data-single": navInfo.prev && !navInfo.next ? "prev" : navInfo.next && !navInfo.prev ? "next" : void 0,
+          children: [
+            navInfo.prev ? /* @__PURE__ */ jsxs6(
+              "a",
+              {
+                href: `/docs/${navInfo.prev.slug}`,
+                className: "np-docs-prev-next-prev",
+                children: [
+                  /* @__PURE__ */ jsx6("div", { className: "np-docs-prev-next-dir", children: "\u2190 Previous" }),
+                  /* @__PURE__ */ jsx6("div", { className: "np-docs-prev-next-title", children: navInfo.prev.title })
+                ]
+              }
+            ) : null,
+            navInfo.next ? /* @__PURE__ */ jsxs6(
+              "a",
+              {
+                href: `/docs/${navInfo.next.slug}`,
+                className: "np-docs-prev-next-next",
+                children: [
+                  /* @__PURE__ */ jsx6("div", { className: "np-docs-prev-next-dir", children: "Next \u2192" }),
+                  /* @__PURE__ */ jsx6("div", { className: "np-docs-prev-next-title", children: navInfo.next.title })
+                ]
+              }
+            ) : null
+          ]
+        }
+      ) : null
     ] }),
-    toc.length > 0 ? /* @__PURE__ */ jsxs5("aside", { className: "np-docs-toc", "aria-label": "On this page", children: [
-      /* @__PURE__ */ jsx5("p", { className: "np-docs-toc-eyebrow", children: "On this page" }),
-      /* @__PURE__ */ jsx5("ul", { children: toc.map((entry) => /* @__PURE__ */ jsx5(
+    toc.length > 0 ? /* @__PURE__ */ jsxs6("aside", { className: "np-docs-toc", "aria-label": "On this page", children: [
+      /* @__PURE__ */ jsx6("p", { className: "np-docs-toc-eyebrow", children: "On this page" }),
+      /* @__PURE__ */ jsx6("ul", { children: toc.map((entry) => /* @__PURE__ */ jsx6(
         "li",
         {
-          style: entry.level === 3 ? { marginLeft: "0.85rem" } : void 0,
-          children: /* @__PURE__ */ jsx5("a", { href: `#${entry.id}`, children: entry.text })
+          className: entry.level === 3 ? "np-docs-toc-l3" : void 0,
+          children: /* @__PURE__ */ jsx6("a", { href: `#${entry.id}`, children: entry.text })
         },
         `toc-${entry.id}`
       )) }),
-      /* @__PURE__ */ jsx5(TocScrollspy, { ids: toc.map((entry) => entry.id) }),
-      editHref || reportIssueHref ? /* @__PURE__ */ jsxs5("div", { className: "np-docs-toc-secondary", children: [
-        editHref ? /* @__PURE__ */ jsxs5("a", { href: editHref, target: "_blank", rel: "noreferrer", children: [
-          /* @__PURE__ */ jsxs5(
+      /* @__PURE__ */ jsx6(TocScrollspy, { ids: toc.map((entry) => entry.id) }),
+      editHref || reportIssueHref ? /* @__PURE__ */ jsxs6("div", { className: "np-docs-toc-secondary", children: [
+        editHref ? /* @__PURE__ */ jsxs6("a", { href: editHref, target: "_blank", rel: "noreferrer", children: [
+          /* @__PURE__ */ jsxs6(
             "svg",
             {
               width: "12",
@@ -375,15 +755,15 @@ async function DocPageTemplate({
               strokeWidth: "2",
               "aria-hidden": "true",
               children: [
-                /* @__PURE__ */ jsx5("path", { d: "M11 4H4a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h14a2 2 0 0 0 2-2v-7" }),
-                /* @__PURE__ */ jsx5("path", { d: "m18.5 2.5 3 3L12 15l-4 1 1-4 9.5-9.5z" })
+                /* @__PURE__ */ jsx6("path", { d: "M11 4H4a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h14a2 2 0 0 0 2-2v-7" }),
+                /* @__PURE__ */ jsx6("path", { d: "m18.5 2.5 3 3L12 15l-4 1 1-4 9.5-9.5z" })
               ]
             }
           ),
           "Edit on GitHub"
         ] }) : null,
-        reportIssueHref ? /* @__PURE__ */ jsxs5("a", { href: reportIssueHref, target: "_blank", rel: "noreferrer", children: [
-          /* @__PURE__ */ jsxs5(
+        reportIssueHref ? /* @__PURE__ */ jsxs6("a", { href: reportIssueHref, target: "_blank", rel: "noreferrer", children: [
+          /* @__PURE__ */ jsxs6(
             "svg",
             {
               width: "12",
@@ -394,9 +774,9 @@ async function DocPageTemplate({
               strokeWidth: "2",
               "aria-hidden": "true",
               children: [
-                /* @__PURE__ */ jsx5("circle", { cx: "12", cy: "12", r: "10" }),
-                /* @__PURE__ */ jsx5("path", { d: "M9.09 9a3 3 0 0 1 5.83 1c0 2-3 3-3 3" }),
-                /* @__PURE__ */ jsx5("line", { x1: "12", y1: "17", x2: "12.01", y2: "17" })
+                /* @__PURE__ */ jsx6("circle", { cx: "12", cy: "12", r: "10" }),
+                /* @__PURE__ */ jsx6("path", { d: "M9.09 9a3 3 0 0 1 5.83 1c0 2-3 3-3 3" }),
+                /* @__PURE__ */ jsx6("line", { x1: "12", y1: "17", x2: "12.01", y2: "17" })
               ]
             }
           ),
@@ -466,7 +846,7 @@ function readingMinutesLabel(value) {
 }
 
 // src/routes/doc-detail.tsx
-import { jsx as jsx6 } from "react/jsx-runtime";
+import { jsx as jsx7 } from "react/jsx-runtime";
 async function DocsDetailRoute({
   params,
   blockCtx
@@ -483,12 +863,12 @@ async function DocsDetailRoute({
     doc,
     blockCtx
   };
-  return /* @__PURE__ */ jsx6(DocPageTemplate, { ...templateProps });
+  return /* @__PURE__ */ jsx7(DocPageTemplate, { ...templateProps });
 }
 
 // src/search.tsx
 import { getCollectionConfig, searchCollections } from "@nexpress/core";
-import { jsx as jsx7, jsxs as jsxs6 } from "react/jsx-runtime";
+import { jsx as jsx8, jsxs as jsxs7 } from "react/jsx-runtime";
 function resolveResultUrl(collection, doc) {
   try {
     const config = getCollectionConfig(collection);
@@ -508,62 +888,33 @@ async function DocsSearch({
   const raw = searchParams.q;
   const query = typeof raw === "string" ? raw.trim() : "";
   if (query.length === 0) {
-    return /* @__PURE__ */ jsxs6("div", { className: "np-docs-search", children: [
-      /* @__PURE__ */ jsx7("h1", { children: "Search" }),
-      /* @__PURE__ */ jsx7("p", { style: { color: "var(--np-color-muted-foreground)" }, children: "Enter a query in the masthead search box to find pages." })
+    return /* @__PURE__ */ jsxs7("div", { className: "np-docs-search", children: [
+      /* @__PURE__ */ jsx8("p", { className: "np-docs-search-heading", children: "Search" }),
+      /* @__PURE__ */ jsx8("h1", { children: "Search the docs" }),
+      /* @__PURE__ */ jsx8("p", { className: "np-docs-search-empty", children: "Enter a query in the masthead search box to find pages." })
     ] });
   }
   const result = await searchCollections({ q: query, limit: 20 });
-  return /* @__PURE__ */ jsxs6("div", { className: "np-docs-search", children: [
-    /* @__PURE__ */ jsxs6("h1", { children: [
-      "Search results for \u201C",
+  return /* @__PURE__ */ jsxs7("div", { className: "np-docs-search", children: [
+    /* @__PURE__ */ jsx8("p", { className: "np-docs-search-heading", children: "Search results for" }),
+    /* @__PURE__ */ jsxs7("h1", { children: [
+      "\u201C",
       query,
       "\u201D"
     ] }),
-    result.results.length === 0 ? /* @__PURE__ */ jsx7("p", { style: { color: "var(--np-color-muted-foreground)" }, children: "No matches." }) : /* @__PURE__ */ jsx7("ul", { style: { listStyle: "none", padding: 0, margin: "1.5rem 0 0" }, children: result.results.map((item, i) => {
+    result.results.length === 0 ? /* @__PURE__ */ jsx8("p", { className: "np-docs-search-empty", children: "No matches." }) : /* @__PURE__ */ jsx8("ul", { className: "np-docs-search-results", children: result.results.map((item, i) => {
       const doc = item.doc;
       const slug = typeof doc.slug === "string" ? doc.slug : null;
       const title = typeof doc.title === "string" ? doc.title : slug ?? "Untitled";
       const url = resolveResultUrl(item.collection, doc);
-      return /* @__PURE__ */ jsxs6(
+      return /* @__PURE__ */ jsxs7(
         "li",
         {
-          style: {
-            padding: "1rem 0",
-            borderBottom: "1px solid var(--np-color-border)"
-          },
+          className: "np-docs-search-result",
           children: [
-            /* @__PURE__ */ jsx7(
-              "p",
-              {
-                style: {
-                  margin: 0,
-                  fontSize: "0.75rem",
-                  textTransform: "uppercase",
-                  letterSpacing: "0.08em",
-                  color: "var(--np-color-muted-foreground)"
-                },
-                children: item.collection
-              }
-            ),
-            /* @__PURE__ */ jsx7("h2", { style: { margin: "0.25rem 0 0.5rem", fontSize: "1.125rem" }, children: /* @__PURE__ */ jsx7(
-              "a",
-              {
-                href: url,
-                style: { color: "inherit", textDecoration: "none" },
-                children: title
-              }
-            ) }),
-            typeof doc.excerpt === "string" ? /* @__PURE__ */ jsx7(
-              "p",
-              {
-                style: {
-                  margin: 0,
-                  color: "var(--np-color-muted-foreground)"
-                },
-                children: doc.excerpt
-              }
-            ) : null
+            /* @__PURE__ */ jsx8("p", { className: "np-docs-search-result-eyebrow", children: item.collection }),
+            /* @__PURE__ */ jsx8("h2", { children: /* @__PURE__ */ jsx8("a", { href: url, children: title }) }),
+            typeof doc.excerpt === "string" ? /* @__PURE__ */ jsx8("p", { className: "np-docs-search-result-excerpt", children: doc.excerpt }) : null
           ]
         },
         `${item.collection}:${doc.id ?? i}`
@@ -573,14 +924,52 @@ async function DocsSearch({
 }
 
 // src/shell.tsx
-import { jsx as jsx8 } from "react/jsx-runtime";
-function DocsShell({ children }) {
-  return /* @__PURE__ */ jsx8("div", { className: "np-docs-shell", children: /* @__PURE__ */ jsx8("div", { className: "np-docs-grid", children }) });
+import { jsx as jsx9, jsxs as jsxs8 } from "react/jsx-runtime";
+var TOKEN_CSS = `:root{--np-color-success:#047857;--np-color-warning:#b45309;--np-color-danger:#b91c1c;--np-color-success-soft:#ecfdf5;--np-color-warning-soft:#fffbeb;--np-color-danger-soft:#fef2f2;--np-color-code-bg:#0b1220;--np-color-code-fg:#e6edf6;--np-color-code-head:#1e2939;--np-color-code-border:#0f1a2b;}`;
+async function DocsShell({
+  children
+}) {
+  let layout = "docs";
+  try {
+    const { headers } = await import("next/headers");
+    const pathname = (await headers()).get("x-np-pathname") ?? "";
+    if (!pathname.startsWith("/docs")) layout = "page";
+  } catch {
+  }
+  return /* @__PURE__ */ jsxs8("div", { className: "np-docs-shell", "data-layout": layout, children: [
+    /* @__PURE__ */ jsx9("style", { dangerouslySetInnerHTML: { __html: TOKEN_CSS } }),
+    /* @__PURE__ */ jsx9("div", { className: "np-docs-grid", children })
+  ] });
 }
 
 // src/sidebar.tsx
 import { findDocuments as findDocuments3 } from "@nexpress/core";
-import { jsx as jsx9, jsxs as jsxs7 } from "react/jsx-runtime";
+
+// src/lib/doc-tree.ts
+function buildDocTree(rows, toNode) {
+  const byId = /* @__PURE__ */ new Map();
+  for (const row of rows) {
+    const node = toNode(row);
+    if (node) byId.set(node.id, node);
+  }
+  const roots = [];
+  for (const node of byId.values()) {
+    if (node.parent && byId.has(node.parent)) {
+      byId.get(node.parent).children.push(node);
+    } else {
+      roots.push(node);
+    }
+  }
+  const sortLevel = (list) => {
+    list.sort((a, b) => a.order - b.order);
+    for (const n of list) sortLevel(n.children);
+  };
+  sortLevel(roots);
+  return roots;
+}
+
+// src/sidebar.tsx
+import { jsx as jsx10, jsxs as jsxs9 } from "react/jsx-runtime";
 async function DocsSidebar() {
   const settings = await resolveDocsSettings();
   const currentSlug = await currentPathSlug();
@@ -591,12 +980,12 @@ async function DocsSidebar() {
   });
   const tree = buildTree(result.docs);
   if (tree.length === 0) {
-    return /* @__PURE__ */ jsx9("aside", { className: "np-docs-sidebar", "aria-label": "Docs navigation", children: /* @__PURE__ */ jsxs7("div", { className: "np-docs-sidebar-group", children: [
-      /* @__PURE__ */ jsxs7("h2", { className: "np-docs-sidebar-eyebrow", children: [
-        /* @__PURE__ */ jsx9("span", { className: "np-docs-sidebar-eyebrow-dot", "aria-hidden": "true" }),
+    return /* @__PURE__ */ jsx10("aside", { className: "np-docs-sidebar", "aria-label": "Docs navigation", children: /* @__PURE__ */ jsxs9("div", { className: "np-docs-sidebar-group", children: [
+      /* @__PURE__ */ jsxs9("h2", { className: "np-docs-sidebar-eyebrow", children: [
+        /* @__PURE__ */ jsx10("span", { className: "np-docs-sidebar-eyebrow-dot", "aria-hidden": "true" }),
         settings.sidebarHeading
       ] }),
-      /* @__PURE__ */ jsx9(
+      /* @__PURE__ */ jsx10(
         "p",
         {
           style: {
@@ -610,13 +999,26 @@ async function DocsSidebar() {
       )
     ] }) });
   }
-  return /* @__PURE__ */ jsx9("aside", { className: "np-docs-sidebar", "aria-label": "Docs navigation", children: tree.map((group) => /* @__PURE__ */ jsxs7("div", { className: "np-docs-sidebar-group", children: [
-    /* @__PURE__ */ jsxs7("h2", { className: "np-docs-sidebar-eyebrow", children: [
-      /* @__PURE__ */ jsx9("span", { className: "np-docs-sidebar-eyebrow-dot", "aria-hidden": "true" }),
-      group.title
-    ] }),
-    group.children.length > 0 ? /* @__PURE__ */ jsx9(NavTree, { nodes: group.children, currentSlug }) : /* @__PURE__ */ jsx9("ul", { children: /* @__PURE__ */ jsx9(SidebarLink, { node: group, currentSlug }) })
-  ] }, group.id)) });
+  return /* @__PURE__ */ jsx10("aside", { className: "np-docs-sidebar", "aria-label": "Docs navigation", children: tree.map((group) => {
+    const isLeaf = group.children.length === 0;
+    const isLeafCurrent = isLeaf && currentSlug === group.slug;
+    return /* @__PURE__ */ jsxs9("div", { className: "np-docs-sidebar-group", children: [
+      /* @__PURE__ */ jsxs9("h2", { className: "np-docs-sidebar-eyebrow", children: [
+        /* @__PURE__ */ jsx10("span", { className: "np-docs-sidebar-eyebrow-dot", "aria-hidden": "true" }),
+        isLeaf ? /* @__PURE__ */ jsx10(
+          "a",
+          {
+            className: "np-docs-sidebar-eyebrow-link",
+            href: `/docs/${group.slug}`,
+            "data-current": isLeafCurrent ? "true" : void 0,
+            "aria-current": isLeafCurrent ? "page" : void 0,
+            children: group.title
+          }
+        ) : group.title
+      ] }),
+      isLeaf ? null : /* @__PURE__ */ jsx10(NavTree, { nodes: group.children, currentSlug })
+    ] }, group.id);
+  }) });
 }
 async function currentPathSlug() {
   try {
@@ -632,11 +1034,10 @@ async function currentPathSlug() {
 }
 function buildTree(rawDocs) {
   const docs = rawDocs;
-  const byId = /* @__PURE__ */ new Map();
-  for (const d of docs) {
-    if (typeof d.id !== "string") continue;
-    if (typeof d.slug !== "string") continue;
-    byId.set(d.id, {
+  return buildDocTree(docs, (d) => {
+    if (typeof d.id !== "string") return null;
+    if (typeof d.slug !== "string") return null;
+    return {
       id: d.id,
       slug: d.slug,
       title: typeof d.title === "string" ? d.title : d.slug,
@@ -644,30 +1045,16 @@ function buildTree(rawDocs) {
       order: typeof d.order === "number" ? d.order : 0,
       badge: typeof d.badge === "string" ? d.badge : null,
       children: []
-    });
-  }
-  const roots = [];
-  for (const node of byId.values()) {
-    if (node.parent && byId.has(node.parent)) {
-      byId.get(node.parent).children.push(node);
-    } else {
-      roots.push(node);
-    }
-  }
-  const sortRec = (list) => {
-    list.sort((a, b) => a.order - b.order);
-    for (const n of list) sortRec(n.children);
-  };
-  sortRec(roots);
-  return roots;
+    };
+  });
 }
 function NavTree({
   nodes,
   currentSlug
 }) {
-  return /* @__PURE__ */ jsx9("ul", { children: nodes.map((n) => /* @__PURE__ */ jsxs7("li", { children: [
-    /* @__PURE__ */ jsx9(SidebarLink, { node: n, currentSlug }),
-    n.children.length > 0 ? /* @__PURE__ */ jsx9(NavTree, { nodes: n.children, currentSlug }) : null
+  return /* @__PURE__ */ jsx10("ul", { children: nodes.map((n) => /* @__PURE__ */ jsxs9("li", { children: [
+    /* @__PURE__ */ jsx10(SidebarLink, { node: n, currentSlug }),
+    n.children.length > 0 ? /* @__PURE__ */ jsx10(NavTree, { nodes: n.children, currentSlug }) : null
   ] }, n.id)) });
 }
 function SidebarLink({
@@ -676,7 +1063,7 @@ function SidebarLink({
 }) {
   const isCurrent = currentSlug !== null && currentSlug === node.slug;
   const badgeClass = node.badge ? `np-docs-sidebar-badge ${node.badge.toLowerCase()}` : null;
-  return /* @__PURE__ */ jsxs7(
+  return /* @__PURE__ */ jsxs9(
     "a",
     {
       href: `/docs/${node.slug}`,
@@ -684,7 +1071,7 @@ function SidebarLink({
       "aria-current": isCurrent ? "page" : void 0,
       children: [
         node.title,
-        badgeClass ? /* @__PURE__ */ jsx9("span", { className: badgeClass, children: node.badge.toUpperCase() }) : null
+        badgeClass ? /* @__PURE__ */ jsx10("span", { className: badgeClass, children: node.badge.toUpperCase() }) : null
       ]
     }
   );
@@ -889,6 +1276,29 @@ var docsCss = `
   .np-docs-sidebar { display: none; }
 }
 
+/* Non-docs routes (home / about / pricing / contact / member pages):
+ * collapse the 3-col grid to a single wide column and hide the
+ * doc-only chrome (sidebar + TOC) so a generic pages doc has full
+ * canvas width instead of being squeezed into the 800-ish px
+ * article column reserved for the /docs reading lane. */
+.np-docs-shell[data-layout="page"] .np-docs-grid {
+  grid-template-columns: minmax(0, 1fr);
+}
+.np-docs-shell[data-layout="page"] .np-docs-sidebar,
+.np-docs-shell[data-layout="page"] .np-docs-toc {
+  display: none;
+}
+/* Framework's globals.css caps .np-page at 48rem (~768px) so a
+ * regular pages doc rendered through the catch-all's fallback
+ * wrapper stays squeezed even after the grid collapse above.
+ * Lift the cap inside the page-layout so block-level content
+ * (hero, features, stats) can stretch to the docs container. */
+.np-docs-shell[data-layout="page"] .np-page {
+  max-width: none;
+  margin: 0;
+  padding: 0;
+}
+
 /* ============================================================
  * Sidebar \u2014 grouped link list with bullet eyebrow + badges.
  * ============================================================ */
@@ -919,6 +1329,24 @@ var docsCss = `
   border-radius: 50%;
   background: var(--np-color-primary);
 }
+/* Leaf top-level doc rendered as a clickable eyebrow \u2014 inherits
+ * the eyebrow typography (mono / uppercase / 0.7rem) so it sits
+ * in the same visual row as sibling group eyebrows; primary
+ * accent on current, foreground on hover. */
+.np-docs-sidebar-eyebrow-link {
+  color: inherit;
+  text-decoration: none;
+  font: inherit;
+  letter-spacing: inherit;
+  text-transform: inherit;
+}
+.np-docs-sidebar-eyebrow-link:hover {
+  color: var(--np-color-foreground);
+}
+.np-docs-sidebar-eyebrow-link[data-current="true"],
+.np-docs-sidebar-eyebrow-link[aria-current="page"] {
+  color: var(--np-color-primary);
+}
 .np-docs-sidebar ul {
   list-style: none;
   padding: 0;
@@ -1031,16 +1459,16 @@ var docsCss = `
   background: var(--np-color-card);
 }
 .np-docs-page-meta-pill.status {
-  color: #047857;
+  color: var(--np-color-success, #047857);
   border-color: #bbf7d0;
-  background: #f0fdf4;
+  background: var(--np-color-success-soft, #f0fdf4);
 }
 .np-docs-page-meta-pill.status::before {
   content: "";
   width: 0.4rem;
   height: 0.4rem;
   border-radius: 50%;
-  background: #047857;
+  background: var(--np-color-success, #047857);
 }
 .np-docs-page-meta-sep { opacity: 0.4; }
 .np-docs-page-meta a {
@@ -1141,12 +1569,12 @@ var docsCss = `
   color: var(--np-color-foreground);
 }
 .np-docs-callout--warn {
-  border-left-color: #b45309;
-  background: #fffbeb;
+  border-left-color: var(--np-color-warning, #b45309);
+  background: var(--np-color-warning-soft, #fffbeb);
   border-color: #fde68a;
 }
 .np-docs-callout--warn .np-docs-callout-icon,
-.np-docs-callout--warn > svg { color: #b45309; }
+.np-docs-callout--warn > svg { color: var(--np-color-warning, #b45309); }
 .np-docs-callout--note {
   border-left-color: #6366f1;
   background: #eef2ff;
@@ -1155,12 +1583,12 @@ var docsCss = `
 .np-docs-callout--note .np-docs-callout-icon,
 .np-docs-callout--note > svg { color: #4338ca; }
 .np-docs-callout--danger {
-  border-left-color: #b91c1c;
-  background: #fef2f2;
+  border-left-color: var(--np-color-danger, #b91c1c);
+  background: var(--np-color-danger-soft, #fef2f2);
   border-color: #fecaca;
 }
 .np-docs-callout--danger .np-docs-callout-icon,
-.np-docs-callout--danger > svg { color: #b91c1c; }
+.np-docs-callout--danger > svg { color: var(--np-color-danger, #b91c1c); }
 
 /* ============================================================
  * Code blocks \u2014 dark surface with a file-named header and a
@@ -1172,17 +1600,17 @@ var docsCss = `
 .np-docs-code {
   margin: 1.25rem 0;
   border-radius: 10px;
-  background: #0b1220;
-  color: #e6edf6;
+  background: var(--np-color-code-bg, #0b1220);
+  color: var(--np-color-code-fg, #e6edf6);
   overflow: hidden;
-  border: 1px solid #1e2939;
+  border: 1px solid var(--np-color-code-head, #1e2939);
 }
 .np-docs-code-head {
   display: flex;
   align-items: center;
   justify-content: space-between;
   padding: 0.55rem 0.85rem;
-  background: #0f1a2b;
+  background: var(--np-color-code-border, #0f1a2b);
   border-bottom: 1px solid #1e293b;
 }
 .np-docs-code-file {
@@ -1244,8 +1672,8 @@ var docsCss = `
   align-items: center;
   padding: 0.75rem 1rem;
   margin: 1.25rem 0;
-  background: #0b1220;
-  color: #e6edf6;
+  background: var(--np-color-code-bg, #0b1220);
+  color: var(--np-color-code-fg, #e6edf6);
   border-radius: 9px;
   font-family: var(--np-font-mono);
   font-size: 0.875rem;
@@ -1384,6 +1812,11 @@ var docsCss = `
 }
 .np-docs-prev-next a.np-docs-prev-next-next,
 .np-docs-prev-next a:last-child { text-align: right; }
+.np-docs-prev-next[data-single="prev"],
+.np-docs-prev-next[data-single="next"] { grid-template-columns: 1fr; }
+.np-docs-prev-next[data-single="prev"] a.np-docs-prev-next-prev,
+.np-docs-prev-next[data-single="next"] a.np-docs-prev-next-next { width: 100%; }
+.np-docs-prev-next[data-single="prev"] a.np-docs-prev-next-prev { text-align: left; }
 
 /* ============================================================
  * Feedback row \u2014 Yes / Could be better buttons under each page.
@@ -1473,6 +1906,7 @@ var docsCss = `
   );
 }
 .np-docs-toc ul ul { margin-left: 0.85rem; }
+.np-docs-toc-l3 { margin-left: 0.85rem; }
 .np-docs-toc-secondary {
   margin-top: 1.5rem;
   padding-top: 1rem;
@@ -1500,8 +1934,453 @@ var docsCss = `
   margin: 0 0 0.5rem;
   color: var(--np-color-foreground);
 }
+
+/* ============================================================
+ * Search route \u2014 wraps DocsSearch's output. Eyebrow + result
+ * cards reuse the docs chrome (mono small caps, hairline rules,
+ * bordered card with hover lift).
+ * ============================================================ */
+.np-docs-search {
+  max-width: 800px;
+  margin: 0 auto;
+  padding-top: 2.25rem;
+}
+.np-docs-search-heading {
+  font-family: var(--np-font-mono);
+  font-size: 0.72rem;
+  text-transform: uppercase;
+  letter-spacing: 0.08em;
+  color: var(--np-color-muted-foreground);
+  font-weight: 600;
+  margin: 0 0 0.5rem;
+}
+.np-docs-search h1 {
+  font-size: 1.75rem;
+  font-weight: 700;
+  letter-spacing: -0.02em;
+  margin: 0 0 1.5rem;
+  text-wrap: balance;
+}
+.np-docs-search-empty {
+  color: var(--np-color-muted-foreground);
+  padding: 1.5rem 0;
+  font-size: 0.95rem;
+}
+.np-docs-search-results {
+  list-style: none;
+  padding: 0;
+  margin: 1.5rem 0 0;
+  display: grid;
+  gap: 1rem;
+}
+.np-docs-search-result {
+  padding: 1rem 1.15rem;
+  border: 1px solid var(--np-color-border);
+  border-radius: 10px;
+  background: var(--np-color-card);
+  transition: border-color 0.15s ease, transform 0.2s ease;
+}
+.np-docs-search-result:hover {
+  border-color: var(--np-color-primary);
+  transform: translateY(-1px);
+}
+.np-docs-search-result-eyebrow {
+  font-family: var(--np-font-mono);
+  font-size: 0.68rem;
+  text-transform: uppercase;
+  letter-spacing: 0.08em;
+  color: var(--np-color-muted-foreground);
+  margin: 0 0 0.35rem;
+}
+.np-docs-search-result h2 {
+  font-size: 1.05rem;
+  font-weight: 600;
+  margin: 0 0 0.4rem;
+}
+.np-docs-search-result h2 a {
+  color: var(--np-color-foreground);
+  text-decoration: none;
+}
+.np-docs-search-result h2 a:hover { color: var(--np-color-primary); }
+.np-docs-search-result-excerpt {
+  margin: 0;
+  font-size: 0.875rem;
+  color: var(--np-color-muted-foreground);
+  line-height: 1.55;
+}
+
+/* ============================================================
+ * Front-page landing \u2014 eyebrow + display heading + lede +
+ * primary CTA + 2x2 group cards + recently-updated row.
+ * Renders inside the single-column page layout
+ * (data-layout="page" on the shell collapses the 3-col grid).
+ * ============================================================ */
+.np-docs-front {
+  max-width: 880px;
+  margin: 0 auto;
+  padding: 2.5rem 0 4rem;
+  display: grid;
+  gap: 3rem;
+}
+.np-docs-front-hero {
+  display: grid;
+  gap: 1rem;
+}
+.np-docs-front-eyebrow {
+  display: inline-flex;
+  align-items: center;
+  gap: 0.5rem;
+  font-family: var(--np-font-mono, ui-monospace, monospace);
+  font-size: 0.72rem;
+  letter-spacing: 0.16em;
+  text-transform: uppercase;
+  color: var(--np-color-primary);
+  background: var(--np-color-primary-soft, color-mix(in oklab, var(--np-color-primary) 10%, transparent));
+  padding: 0.32rem 0.6rem;
+  border-radius: 999px;
+  align-self: start;
+  justify-self: start;
+}
+.np-docs-front-eyebrow-dot {
+  width: 6px;
+  height: 6px;
+  border-radius: 999px;
+  background: var(--np-color-success, currentColor);
+  display: inline-block;
+}
+.np-docs-front h1 {
+  font-size: clamp(2.4rem, 4.2vw, 3rem);
+  font-weight: 700;
+  letter-spacing: -0.03em;
+  line-height: 1.05;
+  margin: 0;
+  text-wrap: balance;
+}
+.np-docs-front-lede {
+  font-size: 1.125rem;
+  line-height: 1.55;
+  color: var(--np-color-muted-foreground);
+  max-width: 60ch;
+  margin: 0;
+}
+.np-docs-front-cta {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 0.65rem;
+  margin-top: 0.5rem;
+}
+.np-docs-front-cta-primary {
+  display: inline-flex;
+  align-items: center;
+  gap: 0.4rem;
+  font-size: 0.92rem;
+  font-weight: 500;
+  padding: 0.55rem 1.05rem;
+  border-radius: 999px;
+  background: var(--np-color-foreground);
+  color: var(--np-color-background);
+  text-decoration: none;
+}
+.np-docs-front-cta-primary:hover {
+  background: color-mix(in oklab, var(--np-color-foreground) 85%, transparent);
+}
+.np-docs-front-cta-secondary {
+  display: inline-flex;
+  align-items: center;
+  font-size: 0.92rem;
+  padding: 0.55rem 1.05rem;
+  border-radius: 999px;
+  color: var(--np-color-foreground);
+  text-decoration: none;
+  border: 1px solid var(--np-color-border);
+}
+.np-docs-front-cta-secondary:hover {
+  background: var(--np-color-muted);
+}
+
+.np-docs-front-groups {
+  display: grid;
+  grid-template-columns: repeat(2, 1fr);
+  gap: 1rem;
+}
+@media (max-width: 720px) {
+  .np-docs-front-groups { grid-template-columns: 1fr; }
+}
+.np-docs-front-group {
+  display: grid;
+  gap: 0.5rem;
+  padding: 1.4rem 1.4rem 1.6rem;
+  border-radius: var(--np-radius-lg, 10px);
+  border: 1px solid var(--np-color-border);
+  background: var(--np-color-card);
+  text-decoration: none;
+  color: inherit;
+  transition: border-color 120ms ease, transform 120ms ease;
+}
+.np-docs-front-group:hover {
+  border-color: var(--np-color-primary);
+  transform: translateY(-1px);
+}
+.np-docs-front-group-title {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  font-size: 1.05rem;
+  font-weight: 600;
+  margin: 0;
+}
+.np-docs-front-group-count {
+  font-family: var(--np-font-mono, ui-monospace, monospace);
+  font-size: 0.7rem;
+  letter-spacing: 0.04em;
+  color: var(--np-color-muted-foreground);
+  font-weight: 400;
+}
+.np-docs-front-group-lede {
+  margin: 0;
+  font-size: 0.9rem;
+  line-height: 1.5;
+  color: var(--np-color-muted-foreground);
+}
+.np-docs-front-group-children {
+  list-style: none;
+  margin: 0.4rem 0 0;
+  padding: 0;
+  display: grid;
+  gap: 0.25rem;
+}
+.np-docs-front-group-children li {
+  font-size: 0.86rem;
+  color: var(--np-color-muted-foreground);
+  display: inline-flex;
+  align-items: center;
+  gap: 0.4rem;
+}
+
+.np-docs-front-recent {
+  display: grid;
+  gap: 0.75rem;
+}
+.np-docs-front-recent-eyebrow {
+  font-family: var(--np-font-mono, ui-monospace, monospace);
+  font-size: 0.7rem;
+  letter-spacing: 0.18em;
+  text-transform: uppercase;
+  color: var(--np-color-muted-foreground);
+  margin: 0;
+}
+.np-docs-front-recent-list {
+  list-style: none;
+  margin: 0;
+  padding: 0;
+  display: grid;
+  gap: 0.5rem;
+}
+.np-docs-front-recent-list a {
+  display: flex;
+  align-items: baseline;
+  justify-content: space-between;
+  gap: 1rem;
+  padding: 0.5rem 0;
+  border-bottom: 1px solid var(--np-color-border);
+  text-decoration: none;
+  color: inherit;
+}
+.np-docs-front-recent-list li:last-child a {
+  border-bottom: 0;
+}
+.np-docs-front-recent-list a:hover {
+  color: var(--np-color-primary);
+}
+.np-docs-front-recent-title {
+  font-size: 0.95rem;
+}
+.np-docs-front-recent-time {
+  font-family: var(--np-font-mono, ui-monospace, monospace);
+  font-size: 0.75rem;
+  color: var(--np-color-muted-foreground);
+  flex-shrink: 0;
+}
+
+/* \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+ * Members shell (DocsMembersShell \u2014 /members/* routes)
+ *
+ * Drops the docs sidebar \u2014 hierarchical navigation is useless
+ * on auth forms. Reuses DocsHeader directly. Body becomes a
+ * narrow centered column for the form / status content.
+ * \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500 */
+.np-docs-members {
+  padding: 4rem 1.5rem;
+  min-height: 60vh;
+}
+.np-docs-members-column {
+  max-width: 32rem;
+  margin: 0 auto;
+  display: flex;
+  flex-direction: column;
+  gap: 1.5rem;
+}
 `;
 
+// src/templates/page-front.tsx
+import { findDocuments as findDocuments4 } from "@nexpress/core";
+import { jsx as jsx11, jsxs as jsxs10 } from "react/jsx-runtime";
+async function PageFrontTemplate(_props) {
+  const settings = await resolveDocsSettings();
+  const result = await findDocuments4("posts", {
+    where: { status: "published", kind: "doc" },
+    sort: "order",
+    limit: 200
+  });
+  const tree = buildTree2(result.docs);
+  const recent = recentlyUpdated(result.docs, 4);
+  const pluginsRoot = tree.find((node) => node.slug === "plugins");
+  const quickstartChild = pluginsRoot?.children.find(
+    (c) => c.slug === "author-quickstart"
+  );
+  const quickstartTarget = quickstartChild ?? tree[0]?.children[0] ?? tree[0] ?? null;
+  return /* @__PURE__ */ jsxs10("article", { className: "np-docs-front", children: [
+    /* @__PURE__ */ jsxs10("header", { className: "np-docs-front-hero", children: [
+      /* @__PURE__ */ jsxs10("span", { className: "np-docs-front-eyebrow", children: [
+        /* @__PURE__ */ jsx11("span", { className: "np-docs-front-eyebrow-dot", "aria-hidden": "true" }),
+        settings.version,
+        /* @__PURE__ */ jsx11("span", { "aria-hidden": "true", children: " \xB7 Stable" })
+      ] }),
+      /* @__PURE__ */ jsx11("h1", { children: "Documentation" }),
+      /* @__PURE__ */ jsx11("p", { className: "np-docs-front-lede", children: "Everything you need to install, configure, extend, and ship a NexPress site \u2014 from a first install to the API reference. Browse by section, or jump straight into the plugin author quickstart." }),
+      quickstartTarget ? /* @__PURE__ */ jsxs10("div", { className: "np-docs-front-cta", children: [
+        /* @__PURE__ */ jsxs10("a", { className: "np-docs-front-cta-primary", href: `/docs/${quickstartTarget.slug}`, children: [
+          "Open ",
+          quickstartTarget.title,
+          " \u2192"
+        ] }),
+        settings.githubRepo ? /* @__PURE__ */ jsx11(
+          "a",
+          {
+            className: "np-docs-front-cta-secondary",
+            href: settings.githubRepo,
+            target: "_blank",
+            rel: "noreferrer",
+            children: "Browse the repository"
+          }
+        ) : null
+      ] }) : null
+    ] }),
+    tree.length > 0 ? /* @__PURE__ */ jsx11("section", { className: "np-docs-front-groups", "aria-label": "Documentation sections", children: tree.map((group) => /* @__PURE__ */ jsxs10(
+      "a",
+      {
+        className: "np-docs-front-group",
+        href: `/docs/${group.slug}`,
+        children: [
+          /* @__PURE__ */ jsxs10("h2", { className: "np-docs-front-group-title", children: [
+            group.title,
+            /* @__PURE__ */ jsxs10("span", { className: "np-docs-front-group-count", children: [
+              group.children.length.toString(),
+              " page",
+              group.children.length === 1 ? "" : "s"
+            ] })
+          ] }),
+          group.lede ? /* @__PURE__ */ jsx11("p", { className: "np-docs-front-group-lede", children: group.lede }) : null,
+          group.children.length > 0 ? /* @__PURE__ */ jsx11("ul", { className: "np-docs-front-group-children", children: group.children.slice(0, 4).map((child) => /* @__PURE__ */ jsxs10("li", { children: [
+            child.title,
+            child.badge ? /* @__PURE__ */ jsx11(
+              "span",
+              {
+                className: `np-docs-sidebar-badge ${child.badge.toLowerCase()}`,
+                children: child.badge.toUpperCase()
+              }
+            ) : null
+          ] }, child.id)) }) : null
+        ]
+      },
+      group.id
+    )) }) : null,
+    recent.length > 0 ? /* @__PURE__ */ jsxs10(
+      "section",
+      {
+        className: "np-docs-front-recent",
+        "aria-label": "Recently updated docs",
+        children: [
+          /* @__PURE__ */ jsx11("h2", { className: "np-docs-front-recent-eyebrow", children: "Recently updated" }),
+          /* @__PURE__ */ jsx11("ul", { className: "np-docs-front-recent-list", children: recent.map((node) => /* @__PURE__ */ jsx11("li", { children: /* @__PURE__ */ jsxs10("a", { href: `/docs/${node.slug}`, children: [
+            /* @__PURE__ */ jsx11("span", { className: "np-docs-front-recent-title", children: node.title }),
+            node.updatedAt ? /* @__PURE__ */ jsx11(
+              "time",
+              {
+                className: "np-docs-front-recent-time",
+                dateTime: node.updatedAt,
+                children: formatRelative(node.updatedAt)
+              }
+            ) : null
+          ] }) }, node.id)) })
+        ]
+      }
+    ) : null
+  ] });
+}
+function buildTree2(rows) {
+  return buildDocTree(rows, (r) => {
+    if (typeof r.id !== "string") return null;
+    if (typeof r.slug !== "string") return null;
+    return {
+      id: r.id,
+      slug: r.slug,
+      title: typeof r.title === "string" ? r.title : r.slug,
+      lede: typeof r.lede === "string" ? r.lede : null,
+      parent: typeof r.parent === "string" ? r.parent : null,
+      order: typeof r.order === "number" ? r.order : 0,
+      badge: typeof r.badge === "string" ? r.badge : null,
+      publishedAt: typeof r.publishedAt === "string" ? r.publishedAt : null,
+      updatedAt: typeof r.updatedAt === "string" ? r.updatedAt : null,
+      children: []
+    };
+  });
+}
+function recentlyUpdated(rows, limit) {
+  const all = [];
+  for (const r of rows) {
+    if (typeof r.id !== "string" || typeof r.slug !== "string") continue;
+    if (typeof r.parent !== "string") continue;
+    all.push({
+      id: r.id,
+      slug: r.slug,
+      title: typeof r.title === "string" ? r.title : r.slug,
+      lede: null,
+      parent: typeof r.parent === "string" ? r.parent : null,
+      order: 0,
+      badge: typeof r.badge === "string" ? r.badge : null,
+      publishedAt: typeof r.publishedAt === "string" ? r.publishedAt : null,
+      updatedAt: typeof r.updatedAt === "string" ? r.updatedAt : null,
+      children: []
+    });
+  }
+  return all.filter((n) => n.updatedAt !== null).sort((a, b) => {
+    const at = a.updatedAt ?? "";
+    const bt = b.updatedAt ?? "";
+    return bt.localeCompare(at);
+  }).slice(0, limit);
+}
+function formatRelative(iso) {
+  try {
+    const then = new Date(iso).getTime();
+    const now = Date.now();
+    const ms = Math.max(now - then, 0);
+    const minute = 60 * 1e3;
+    const hour = 60 * minute;
+    const day = 24 * hour;
+    if (ms < hour) return `${Math.max(1, Math.round(ms / minute)).toString()} min ago`;
+    if (ms < day) return `${Math.round(ms / hour).toString()} h ago`;
+    if (ms < 7 * day) return `${Math.round(ms / day).toString()} d ago`;
+    return new Date(iso).toLocaleDateString(void 0, {
+      month: "short",
+      day: "numeric",
+      year: "numeric"
+    });
+  } catch {
+    return "";
+  }
+}
+
 // src/index.ts
 var SEED_NAV = {
   header: [
@@ -1516,6 +2395,282 @@ var SEED_NAV = {
     { id: "nav-docs-footer-github", label: "GitHub", type: "link", url: "https://github.com" }
   ]
 };
+function paragraph(text) {
+  return {
+    type: "paragraph",
+    version: 1,
+    direction: null,
+    format: "",
+    indent: 0,
+    children: [{
+      type: "text",
+      version: 1,
+      detail: 0,
+      format: 0,
+      mode: "normal",
+      style: "",
+      text
+    }]
+  };
+}
+function heading(tag, text) {
+  return {
+    type: "heading",
+    tag,
+    version: 1,
+    direction: null,
+    format: "",
+    indent: 0,
+    children: [{
+      type: "text",
+      version: 1,
+      detail: 0,
+      format: 0,
+      mode: "normal",
+      style: "",
+      text
+    }]
+  };
+}
+function codeBlock(text, language) {
+  return {
+    type: "code",
+    language: language ?? null,
+    version: 1,
+    direction: null,
+    format: "",
+    indent: 0,
+    children: [{
+      type: "text",
+      version: 1,
+      detail: 0,
+      format: 0,
+      mode: "normal",
+      style: "",
+      text
+    }]
+  };
+}
+function listItem(text) {
+  return {
+    type: "listitem",
+    value: 1,
+    version: 1,
+    direction: null,
+    format: "",
+    indent: 0,
+    children: [{
+      type: "text",
+      version: 1,
+      detail: 0,
+      format: 0,
+      mode: "normal",
+      style: "",
+      text
+    }]
+  };
+}
+function bulletList(items) {
+  return {
+    type: "list",
+    listType: "bullet",
+    start: 1,
+    tag: "ul",
+    version: 1,
+    direction: null,
+    format: "",
+    indent: 0,
+    children: items.map((t) => listItem(t))
+  };
+}
+function lexicalDoc(blocks) {
+  return {
+    root: {
+      type: "root",
+      version: 1,
+      direction: null,
+      format: "",
+      indent: 0,
+      children: blocks
+    }
+  };
+}
+var DOCS_NOW = "2026-05-02T12:00:00.000Z";
+function stubDoc(opts) {
+  return {
+    title: opts.title,
+    excerpt: opts.lede ?? `${opts.title} reference page.`,
+    content: lexicalDoc([
+      paragraph(`Placeholder body for ${opts.title}. Operators replace this once they're set up \u2014 every doc-kind post renders through the three-column docs template.`)
+    ]),
+    publishedAt: DOCS_NOW,
+    kind: "doc",
+    ...opts.parentSlug ? { parentSlug: opts.parentSlug } : {},
+    ...typeof opts.order === "number" ? { order: opts.order } : {},
+    data: {
+      ...opts.badge ? { badge: opts.badge } : {},
+      ...opts.lede ? { lede: opts.lede } : {},
+      ...opts.stableSince ? { stableSince: opts.stableSince } : {}
+    }
+  };
+}
+var QUICKSTART_BODY = lexicalDoc([
+  paragraph(
+    "A NexPress plugin is a single function that returns a manifest. The framework loads it during boot, validates its declared shape, and wires the hooks and routes into the request pipeline. There's no plugin loader to learn \u2014 if you can write a TypeScript module, you can write a plugin."
+  ),
+  paragraph(
+    "Prerequisites: a running NexPress site (see Install & bootstrap) and Node 20+. The plugin lives inside your app \u2014 no separate workspace required to start."
+  ),
+  heading("h2", "Scaffold the plugin"),
+  paragraph(
+    "The CLI ships a scaffold command that drops a typed plugin module into plugins/. The generated file imports definePlugin from the SDK and exports a single function."
+  ),
+  codeBlock("pnpm nexpress plugin:new hello-world", "bash"),
+  paragraph(
+    "The generated module is ~20 lines, ready to run. Open it in your editor before continuing."
+  ),
+  codeBlock(
+    [
+      'import { definePlugin } from "@nexpress/plugin-sdk";',
+      "",
+      "export default definePlugin({",
+      "  manifest: {",
+      '    id: "hello-world",',
+      '    name: "Hello, world",',
+      '    version: "0.1.0",',
+      '    nexpress: { minVersion: "0.1.0" },',
+      "  },",
+      "  hooks: {",
+      "    onDocumentPublished: async ({ doc, collection }) => {",
+      '      if (collection !== "posts") return;',
+      "      console.log(`Published: ${doc.title}`);",
+      "    },",
+      "  },",
+      "});"
+    ].join("\n"),
+    "typescript"
+  ),
+  heading("h2", "Register it with your site"),
+  paragraph(
+    "NexPress loads plugins from nexpress.config.ts. Import your module and add it to the plugins array \u2014 order matters, hooks run in the order they're registered."
+  ),
+  codeBlock(
+    [
+      'import { defineConfig } from "@nexpress/core";',
+      'import helloWorld from "./plugins/hello-world";',
+      "",
+      "export default defineConfig({",
+      "  plugins: [helloWorld()],",
+      "});"
+    ].join("\n"),
+    "typescript"
+  ),
+  paragraph(
+    "Hot reload: the dev server picks up new plugin files without a restart. Config changes do require one \u2014 that's a Next.js constraint, not ours."
+  ),
+  heading("h2", "Lifecycle hooks at a glance"),
+  paragraph(
+    "Hooks are typed callbacks NexPress invokes at well-known points. Each receives a context object scoped to that event. The most commonly used hooks:"
+  ),
+  bulletList([
+    "onBoot \u2014 after config load, before request handling. Context: { config, env }.",
+    "onDocumentPublished (async) \u2014 a document's status transitions to published. Context: { doc, collection, by }.",
+    "onDocumentUnpublished \u2014 status leaves published. Context: { doc, collection, by }.",
+    "onRequest \u2014 every request, after routing, before render. Context: { req, route, user }.",
+    "onSchedule \u2014 cron-like; declare cadence in the manifest. Context: { now, schedule }."
+  ]),
+  paragraph(
+    "The full list \u2014 including admin-surface and search hooks \u2014 lives in the lifecycle hooks reference."
+  ),
+  heading("h2", "Run and verify"),
+  bulletList([
+    "Start the dev server. pnpm dev from the repo root. Codegen runs alongside Next's watcher, so plugin types are picked up as you save.",
+    "Publish a post from the admin. Open /admin, create a draft in the posts collection, and click Publish. The hook fires inside the same request.",
+    "Check the dev server log. You should see Published: <title> in the terminal. That's it \u2014 the plugin is live."
+  ]),
+  paragraph(
+    "Hooks block the response: onDocumentPublished runs inside the publish request. Long-running work \u2014 sending emails, regenerating sitemaps \u2014 belongs in onSchedule or a queued job. Otherwise the editor will wait on it."
+  ),
+  heading("h2", "Next steps"),
+  paragraph(
+    "You have a plugin that runs. Two natural directions from here:"
+  ),
+  bulletList([
+    "Add a route. Declare a routes entry in the manifest to expose a public URL \u2014 for webhooks, OAuth callbacks, or a custom admin screen.",
+    "Add collections. Plugins can declare their own collections, which the admin surfaces alongside the operator's. See the Plugin manifest reference."
+  ])
+]);
+var SEED_PAGES = [
+  {
+    title: "Documentation",
+    slug: "/",
+    seoDescription: "Install NexPress, learn the core concepts, write plugins, and look up the API.",
+    blocks: [],
+    template: "front"
+  }
+];
+var SEED_DOCS = [
+  stubDoc({
+    title: "Get started",
+    order: 0,
+    lede: "Install NexPress, scaffold a site, and ship a first deploy."
+  }),
+  stubDoc({
+    title: "Introduction",
+    parentSlug: "get-started",
+    order: 0,
+    lede: "What NexPress is, what it isn't, and who it's for.",
+    stableSince: "Stable since 0.1"
+  }),
+  stubDoc({ title: "Install & bootstrap", parentSlug: "get-started", order: 1, stableSince: "Stable since 0.1" }),
+  stubDoc({ title: "Project structure", parentSlug: "get-started", order: 2 }),
+  stubDoc({ title: "Configuration", parentSlug: "get-started", order: 3 }),
+  stubDoc({ title: "Deployment", parentSlug: "get-started", order: 4 }),
+  stubDoc({
+    title: "Core concepts",
+    order: 1,
+    lede: "The model behind collections, themes, plugins, and blocks."
+  }),
+  stubDoc({ title: "Collections", parentSlug: "core-concepts", order: 0, stableSince: "Stable since 0.1" }),
+  stubDoc({ title: "Pages & routing", parentSlug: "core-concepts", order: 1 }),
+  stubDoc({ title: "Themes", parentSlug: "core-concepts", order: 2 }),
+  stubDoc({ title: "Blocks", parentSlug: "core-concepts", order: 3 }),
+  stubDoc({ title: "Hooks & access", parentSlug: "core-concepts", order: 4 }),
+  stubDoc({ title: "Internationalization", parentSlug: "core-concepts", order: 5 }),
+  stubDoc({
+    title: "Plugins",
+    order: 2,
+    lede: "Extend NexPress with hooks, routes, blocks, and scheduled jobs."
+  }),
+  stubDoc({ title: "Plugin overview", parentSlug: "plugins", order: 0 }),
+  {
+    title: "Author quickstart",
+    excerpt: 'From "I want to add behavior to NexPress" to a running plugin in about ten minutes. Walks through the manifest, a lifecycle hook, and shipping the result to your own site.',
+    content: QUICKSTART_BODY,
+    publishedAt: DOCS_NOW,
+    kind: "doc",
+    parentSlug: "plugins",
+    order: 1,
+    data: {
+      badge: "NEW",
+      lede: 'From "I want to add behavior to NexPress" to a running plugin in about ten minutes. Walks through the manifest, a lifecycle hook, and shipping the result to your own site.',
+      stableSince: "Stable since 0.1"
+    }
+  },
+  stubDoc({ title: "Manifest reference", parentSlug: "plugins", order: 2 }),
+  stubDoc({ title: "Lifecycle hooks", parentSlug: "plugins", order: 3 }),
+  stubDoc({ title: "Publishing", parentSlug: "plugins", order: 4 }),
+  stubDoc({
+    title: "Reference",
+    order: 3,
+    lede: "API surface \u2014 CLI, define* helpers, server functions."
+  }),
+  stubDoc({ title: "CLI", parentSlug: "reference", order: 0 }),
+  stubDoc({ title: "defineCollection", parentSlug: "reference", order: 1, badge: "API" }),
+  stubDoc({ title: "defineTheme", parentSlug: "reference", order: 2 }),
+  stubDoc({ title: "definePlugin", parentSlug: "reference", order: 3 }),
+  stubDoc({ title: "Server functions", parentSlug: "reference", order: 4, badge: "BETA" })
+];
 var docsTheme = defineTheme({
   manifest: {
     id: "docs",
@@ -1605,6 +2760,10 @@ var docsTheme = defineTheme({
       colors: {
         primary: "#2563eb",
         primaryForeground: "#ffffff",
+        // 10% tint of primary — equivalent to the color-mix
+        // fallback in styles.ts, but materialised so the
+        // generated theme CSS picks it up explicitly.
+        primarySoft: "rgba(37, 99, 235, 0.1)",
         background: "#fbfcfe",
         foreground: "#0c1320",
         muted: "#f1f4f9",
@@ -1624,9 +2783,18 @@ var docsTheme = defineTheme({
       }
     },
     seedContent: {
-      navigation: SEED_NAV
+      navigation: SEED_NAV,
+      pages: SEED_PAGES,
+      posts: SEED_DOCS
     },
     templates: {
+      pages: {
+        front: {
+          label: "Front page",
+          description: 'Docs landing \u2014 hero + 2x2 group cards walking the kind="doc" tree + recently-updated row. The seeded home page (slug "/") ships with this template.',
+          component: PageFrontTemplate
+        }
+      },
       // Universal-content-model #748 — docs are posts with
       // `kind: "doc"`. The template key matches the kind value so
       // the per-kind template lookup picks this up automatically.
@@ -1665,7 +2833,7 @@ var docsTheme = defineTheme({
       { pattern: "/docs/:slug", component: DocsDetailRoute }
     ],
     navLocations: {
-      primary: {
+      header: {
         label: "Primary header nav",
         description: "Inline links beside the masthead search box.",
         maxItems: 5
@@ -1692,10 +2860,12 @@ var docsTheme = defineTheme({
     members: {
       shell: DocsMembersShell,
       notFound: DocsMembersNotFound
-    }
+    },
+    blocks: docsBlocks
   }
 });
 export {
+  CopyButton,
   DocPageTemplate,
   DocsHeader,
   DocsMembersNotFound,
@@ -1704,6 +2874,7 @@ export {
   DocsSearch,
   DocsShell,
   DocsSidebar,
+  docsBlocks,
   docsCss,
   docsSettingsSchema,
   docsTheme