@nexpress/theme-docs 0.3.6 → 0.3.8

package/dist/index.js

@@ -1,7 +1,5 @@
 // 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";
@@ -411,7 +409,7 @@ async function DocsHeader() {
   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", { children: siteName }),
       /* @__PURE__ */ jsx2("span", { className: "np-docs-brand-version", children: settings.version })
     ] }),
     /* @__PURE__ */ jsxs2(
@@ -454,33 +452,7 @@ async function DocsHeader() {
       }
     ),
     /* @__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,
-          className: "np-docs-github",
-          target: "_blank",
-          rel: "noreferrer",
-          "aria-label": "GitHub repository",
-          children: [
-            /* @__PURE__ */ jsx2(
-              "svg",
-              {
-                width: "14",
-                height: "14",
-                viewBox: "0 0 24 24",
-                fill: "currentColor",
-                "aria-hidden": "true",
-                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"
-          ]
-        }
-      ) : null
-    ] })
+    /* @__PURE__ */ jsx2("nav", { className: "np-docs-nav", "aria-label": "Primary", children: /* @__PURE__ */ jsx2(NavMenu, { location: "header", className: "np-docs-primary-nav" }) })
   ] }) });
 }
 
@@ -1096,6 +1068,140 @@ var docsCss = `
   font-family: var(--np-font-mono, "Geist Mono", ui-monospace, SFMono-Regular, Menlo, monospace);
 }
 
+.np-docs-api,
+.np-docs-changelog-page {
+  max-width: 980px;
+  margin: 0 auto;
+  padding: 3rem 1rem 5rem;
+}
+.np-docs-api-hero,
+.np-docs-changelog-hero {
+  padding: 3rem 0 2rem;
+}
+.np-docs-api-eyebrow,
+.np-docs-changelog-hero p {
+  margin: 0 0 0.8rem;
+  font-family: var(--np-font-mono);
+  color: var(--np-color-primary);
+  font-size: 0.78rem;
+  letter-spacing: 0.08em;
+  text-transform: uppercase;
+}
+.np-docs-api-hero h1,
+.np-docs-changelog-hero h1 {
+  margin: 0;
+  font-size: clamp(2.4rem, 5vw, 4.4rem);
+  line-height: 1;
+  letter-spacing: -0.04em;
+}
+.np-docs-api-hero p,
+.np-docs-changelog-hero span {
+  display: block;
+  max-width: 44rem;
+  margin-top: 1rem;
+  color: var(--np-color-muted-foreground);
+  font-size: 1.05rem;
+}
+.np-docs-api-signature {
+  overflow: hidden;
+  border: 1px solid var(--np-color-border);
+  border-radius: 14px;
+  background: #0b1220;
+  color: #e6edf6;
+}
+.np-docs-api-signature-head {
+  display: flex;
+  justify-content: space-between;
+  gap: 1rem;
+  padding: 0.8rem 1rem;
+  color: #93c5fd;
+  border-bottom: 1px solid rgba(255,255,255,0.12);
+  font-family: var(--np-font-mono);
+  font-size: 0.78rem;
+}
+.np-docs-api-signature pre {
+  margin: 0;
+  padding: 1.2rem;
+  overflow-x: auto;
+  font-size: 0.85rem;
+  line-height: 1.65;
+}
+.np-docs-api-section { padding-top: 2.5rem; }
+.np-docs-api-section h2 {
+  margin: 0 0 1rem;
+  font-size: 1.35rem;
+}
+.np-docs-api-table {
+  border: 1px solid var(--np-color-border);
+  border-radius: 14px;
+  overflow: hidden;
+  background: var(--np-color-card);
+}
+.np-docs-api-row {
+  display: grid;
+  grid-template-columns: 10rem 7rem minmax(0, 1fr);
+  gap: 1rem;
+  padding: 1rem;
+  border-bottom: 1px solid var(--np-color-border);
+}
+.np-docs-api-row:last-child { border-bottom: 0; }
+.np-docs-api-row span {
+  color: var(--np-color-primary);
+  font-family: var(--np-font-mono);
+  font-size: 0.76rem;
+}
+.np-docs-api-row p { margin: 0; color: var(--np-color-muted-foreground); }
+.np-docs-changelog-timeline {
+  list-style: none;
+  margin: 2rem 0 0;
+  padding: 0;
+  border-top: 1px solid var(--np-color-border);
+}
+.np-docs-changelog-release {
+  display: grid;
+  grid-template-columns: 13rem minmax(0, 1fr);
+  gap: 2rem;
+  padding: 1.6rem 0;
+  border-bottom: 1px solid var(--np-color-border);
+}
+.np-docs-changelog-release aside {
+  display: grid;
+  gap: 0.3rem;
+  align-content: start;
+}
+.np-docs-changelog-release aside strong {
+  font-size: 1.25rem;
+  letter-spacing: -0.02em;
+}
+.np-docs-changelog-release aside span,
+.np-docs-changelog-release aside i {
+  color: var(--np-color-muted-foreground);
+  font-style: normal;
+  font-size: 0.82rem;
+}
+.np-docs-changelog-release p {
+  display: grid;
+  grid-template-columns: 6.5rem minmax(0, 1fr);
+  gap: 1rem;
+  margin: 0 0 0.85rem;
+}
+.np-docs-changelog-release p span {
+  justify-self: start;
+  padding: 0.12rem 0.45rem;
+  border-radius: 999px;
+  border: 1px solid var(--np-color-border);
+  font-family: var(--np-font-mono);
+  font-size: 0.7rem;
+  color: var(--np-color-primary);
+}
+@media (max-width: 760px) {
+  .np-docs-api-row,
+  .np-docs-changelog-release,
+  .np-docs-changelog-release p {
+    grid-template-columns: 1fr;
+  }
+}
+
 /* ============================================================
  * Header \u2014 sticky bar with brand + version pill, \u2318K search in
  * the center, primary nav + GitHub link on the right. Grid
@@ -1115,7 +1221,7 @@ var docsCss = `
   margin: 0 auto;
   padding: 0.7rem 1.5rem;
   display: grid;
-  grid-template-columns: minmax(220px, 1fr) minmax(0, 2fr) auto;
+  grid-template-columns: auto 1fr auto;
   gap: 1.5rem;
   align-items: center;
 }
@@ -1145,7 +1251,6 @@ var docsCss = `
   opacity: 0.95;
   clip-path: polygon(0 0, 100% 0, 100% 100%, 60% 100%, 0 35%);
 }
-.np-docs-brand-name { font-weight: 700; }
 .np-docs-brand-version {
   font-family: var(--np-font-mono);
   font-size: 0.72rem;
@@ -1221,24 +1326,6 @@ var docsCss = `
 .np-docs-primary-nav a[aria-current="page"] {
   color: var(--np-color-foreground);
 }
-.np-docs-github,
-.np-docs-github-link {
-  display: inline-flex;
-  align-items: center;
-  gap: 0.45rem;
-  padding: 0.4rem 0.7rem;
-  font-size: 0.8125rem;
-  color: var(--np-color-muted-foreground);
-  background: var(--np-color-muted);
-  border: 1px solid var(--np-color-border);
-  border-radius: 7px;
-  text-decoration: none;
-}
-.np-docs-github:hover,
-.np-docs-github-link:hover {
-  color: var(--np-color-foreground);
-}
-
 @media (max-width: 800px) {
   .np-docs-header-inner {
     grid-template-columns: auto 1fr auto;
@@ -2222,9 +2309,121 @@ var docsCss = `
 }
 `;
 
+// src/templates/page-api-reference.tsx
+import { jsx as jsx11, jsxs as jsxs10 } from "react/jsx-runtime";
+function PageApiReferenceTemplate(_props) {
+  const params = [
+    ["manifest", "required", "Plugin metadata: id, name, version, and supported NexPress range."],
+    ["hooks", "optional", "Lifecycle hooks such as content:beforeSave and content:afterSave."],
+    ["actions", "optional", "Custom action handlers mounted under the plugin action endpoint."],
+    ["routes", "optional", "API-style route handlers registered by the plugin host."],
+    ["pageRoutes", "optional", "Public-site React routes rendered through the site shell."],
+    ["scheduled", "optional", "pg-boss scheduled tasks reconciled at boot."],
+    ["blocks", "optional", "Page-builder block definitions registered into the shared registry."]
+  ];
+  return /* @__PURE__ */ jsxs10("article", { className: "np-docs-api", children: [
+    /* @__PURE__ */ jsxs10("header", { className: "np-docs-api-hero", children: [
+      /* @__PURE__ */ jsx11("p", { className: "np-docs-api-eyebrow", children: "API reference" }),
+      /* @__PURE__ */ jsx11("h1", { children: /* @__PURE__ */ jsx11("code", { children: "definePlugin" }) }),
+      /* @__PURE__ */ jsx11("p", { children: "Declares a NexPress plugin. v1 plugins are npm package + rebuild: they run in-process, can register hooks, actions, API routes, public page routes, scheduled tasks, and page-builder blocks." })
+    ] }),
+    /* @__PURE__ */ jsxs10("section", { className: "np-docs-api-signature", "aria-label": "Signature", children: [
+      /* @__PURE__ */ jsxs10("div", { className: "np-docs-api-signature-head", children: [
+        /* @__PURE__ */ jsx11("span", { children: "Signature" }),
+        /* @__PURE__ */ jsx11("code", { children: "@nexpress/plugin-sdk" })
+      ] }),
+      /* @__PURE__ */ jsx11("pre", { children: `import { definePlugin } from "@nexpress/plugin-sdk";
+
+export default definePlugin({
+  manifest: {
+    id: "reading-time",
+    name: "Reading time",
+    version: "0.1.0",
+    nexpress: { minVersion: "0.1.0" },
+  },
+  hooks: {
+    "content:beforeSave": async (ctx) => ctx.data,
+  },
+  pageRoutes: [],
+  blocks: [],
+});` })
+    ] }),
+    /* @__PURE__ */ jsxs10("section", { className: "np-docs-api-section", children: [
+      /* @__PURE__ */ jsx11("h2", { children: "Parameters" }),
+      /* @__PURE__ */ jsx11("div", { className: "np-docs-api-table", children: params.map(([name, state, desc]) => /* @__PURE__ */ jsxs10("div", { className: "np-docs-api-row", children: [
+        /* @__PURE__ */ jsx11("code", { children: name }),
+        /* @__PURE__ */ jsx11("span", { children: state }),
+        /* @__PURE__ */ jsx11("p", { children: desc })
+      ] }, name)) })
+    ] }),
+    /* @__PURE__ */ jsxs10("section", { className: "np-docs-api-section", children: [
+      /* @__PURE__ */ jsx11("h2", { children: "Returns" }),
+      /* @__PURE__ */ jsx11("p", { children: "A plugin definition object consumed by the NexPress bootstrap. The host validates the manifest and registers every declared surface in a predictable order. Capability and route checks happen at the framework boundary." })
+    ] })
+  ] });
+}
+
+// src/templates/page-changelog.tsx
+import { jsx as jsx12, jsxs as jsxs11 } from "react/jsx-runtime";
+var RELEASES = [
+  {
+    version: "0.3.6",
+    date: "May 2026",
+    tag: "latest",
+    changes: [
+      ["Improved", "Theme seed content now owns first-boot pages and posts per active theme."],
+      ["Added", "Built-in theme docs, magazine, and portfolio front-page render coverage."],
+      ["Fixed", "Theme-contributed fields are gated by active theme in the admin editor."]
+    ]
+  },
+  {
+    version: "0.3.0",
+    date: "May 2026",
+    tag: "theme v0.2",
+    changes: [
+      ["Added", "Theme routes, archives, nav locations, settings schema, and patterns."],
+      ["Added", "Docs and portfolio kinds on the universal posts collection."],
+      ["Breaking", "Legacy nx prefix moved to np across framework-owned identifiers."]
+    ]
+  },
+  {
+    version: "0.2.0",
+    date: "April 2026",
+    tag: "pre-1.0",
+    changes: [
+      ["Added", "Plugin page routes and page-builder block contributions."],
+      ["Improved", "pg-boss worker lifecycle and admin jobs surface."],
+      ["Fixed", "CSRF and rate limiting now live in the app proxy boundary."]
+    ]
+  }
+];
+function PageChangelogTemplate(_props) {
+  return /* @__PURE__ */ jsxs11("article", { className: "np-docs-changelog-page", children: [
+    /* @__PURE__ */ jsxs11("header", { className: "np-docs-changelog-hero", children: [
+      /* @__PURE__ */ jsx12("p", { children: "Changelog" }),
+      /* @__PURE__ */ jsx12("h1", { children: "Every shipped change, in reverse." }),
+      /* @__PURE__ */ jsx12("span", { children: "Pre-1.0 packages use minor releases for breaking changes." })
+    ] }),
+    /* @__PURE__ */ jsx12("ol", { className: "np-docs-changelog-timeline", children: RELEASES.map((release) => /* @__PURE__ */ jsxs11("li", { className: "np-docs-changelog-release", children: [
+      /* @__PURE__ */ jsxs11("aside", { children: [
+        /* @__PURE__ */ jsxs11("strong", { children: [
+          "v",
+          release.version
+        ] }),
+        /* @__PURE__ */ jsx12("span", { children: release.date }),
+        /* @__PURE__ */ jsx12("i", { children: release.tag })
+      ] }),
+      /* @__PURE__ */ jsx12("div", { children: release.changes.map(([kind, text]) => /* @__PURE__ */ jsxs11("p", { children: [
+        /* @__PURE__ */ jsx12("span", { "data-kind": kind.toLowerCase(), children: kind }),
+        text
+      ] }, `${release.version}-${text}`)) })
+    ] }, release.version)) })
+  ] });
+}
+
 // src/templates/page-front.tsx
 import { findDocuments as findDocuments4 } from "@nexpress/core";
-import { jsx as jsx11, jsxs as jsxs10 } from "react/jsx-runtime";
+import { jsx as jsx13, jsxs as jsxs12 } from "react/jsx-runtime";
 async function PageFrontTemplate(_props) {
   const settings = await resolveDocsSettings();
   const result = await findDocuments4("posts", {
@@ -2239,22 +2438,22 @@ async function PageFrontTemplate(_props) {
     (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" }),
+  return /* @__PURE__ */ jsxs12("article", { className: "np-docs-front", children: [
+    /* @__PURE__ */ jsxs12("header", { className: "np-docs-front-hero", children: [
+      /* @__PURE__ */ jsxs12("span", { className: "np-docs-front-eyebrow", children: [
+        /* @__PURE__ */ jsx13("span", { className: "np-docs-front-eyebrow-dot", "aria-hidden": "true" }),
         settings.version,
-        /* @__PURE__ */ jsx11("span", { "aria-hidden": "true", children: " \xB7 Stable" })
+        /* @__PURE__ */ jsx13("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: [
+      /* @__PURE__ */ jsx13("h1", { children: "Documentation" }),
+      /* @__PURE__ */ jsx13("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__ */ jsxs12("div", { className: "np-docs-front-cta", children: [
+        /* @__PURE__ */ jsxs12("a", { className: "np-docs-front-cta-primary", href: `/docs/${quickstartTarget.slug}`, children: [
           "Open ",
           quickstartTarget.title,
           " \u2192"
         ] }),
-        settings.githubRepo ? /* @__PURE__ */ jsx11(
+        settings.githubRepo ? /* @__PURE__ */ jsx13(
           "a",
           {
             className: "np-docs-front-cta-secondary",
@@ -2266,24 +2465,24 @@ async function PageFrontTemplate(_props) {
         ) : null
       ] }) : null
     ] }),
-    tree.length > 0 ? /* @__PURE__ */ jsx11("section", { className: "np-docs-front-groups", "aria-label": "Documentation sections", children: tree.map((group) => /* @__PURE__ */ jsxs10(
+    tree.length > 0 ? /* @__PURE__ */ jsx13("section", { className: "np-docs-front-groups", "aria-label": "Documentation sections", children: tree.map((group) => /* @__PURE__ */ jsxs12(
       "a",
       {
         className: "np-docs-front-group",
         href: `/docs/${group.slug}`,
         children: [
-          /* @__PURE__ */ jsxs10("h2", { className: "np-docs-front-group-title", children: [
+          /* @__PURE__ */ jsxs12("h2", { className: "np-docs-front-group-title", children: [
             group.title,
-            /* @__PURE__ */ jsxs10("span", { className: "np-docs-front-group-count", children: [
+            /* @__PURE__ */ jsxs12("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: [
+          group.lede ? /* @__PURE__ */ jsx13("p", { className: "np-docs-front-group-lede", children: group.lede }) : null,
+          group.children.length > 0 ? /* @__PURE__ */ jsx13("ul", { className: "np-docs-front-group-children", children: group.children.slice(0, 4).map((child) => /* @__PURE__ */ jsxs12("li", { children: [
             child.title,
-            child.badge ? /* @__PURE__ */ jsx11(
+            child.badge ? /* @__PURE__ */ jsx13(
               "span",
               {
                 className: `np-docs-sidebar-badge ${child.badge.toLowerCase()}`,
@@ -2295,16 +2494,16 @@ async function PageFrontTemplate(_props) {
       },
       group.id
     )) }) : null,
-    recent.length > 0 ? /* @__PURE__ */ jsxs10(
+    recent.length > 0 ? /* @__PURE__ */ jsxs12(
       "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(
+          /* @__PURE__ */ jsx13("h2", { className: "np-docs-front-recent-eyebrow", children: "Recently updated" }),
+          /* @__PURE__ */ jsx13("ul", { className: "np-docs-front-recent-list", children: recent.map((node) => /* @__PURE__ */ jsx13("li", { children: /* @__PURE__ */ jsxs12("a", { href: `/docs/${node.slug}`, children: [
+            /* @__PURE__ */ jsx13("span", { className: "np-docs-front-recent-title", children: node.title }),
+            node.updatedAt ? /* @__PURE__ */ jsx13(
               "time",
               {
                 className: "np-docs-front-recent-time",
@@ -2384,15 +2583,30 @@ function formatRelative(iso) {
 // src/index.ts
 var SEED_NAV = {
   header: [
-    { id: "nav-docs-docs", label: "Docs", type: "link", url: "/docs" },
+    { id: "nav-docs-docs", label: "Docs", type: "link", url: "/" },
     { id: "nav-docs-reference", label: "Reference", type: "link", url: "/docs/reference" },
     { id: "nav-docs-blog", label: "Blog", type: "link", url: "/blog" }
   ],
   footer: [
-    { id: "nav-docs-footer-docs", label: "Documentation", type: "link", url: "/docs" },
-    { id: "nav-docs-footer-reference", label: "Reference", type: "link", url: "/docs/reference" },
-    { id: "nav-docs-footer-changelog", label: "Changelog", type: "link", url: "/changelog" },
-    { id: "nav-docs-footer-github", label: "GitHub", type: "link", url: "https://github.com" }
+    { id: "nav-docs-footer-docs", label: "Documentation", type: "link", url: "/" },
+    {
+      id: "nav-docs-footer-reference",
+      label: "Reference",
+      type: "link",
+      url: "/docs/reference"
+    },
+    {
+      id: "nav-docs-footer-changelog",
+      label: "Changelog",
+      type: "link",
+      url: "/changelog"
+    },
+    {
+      id: "nav-docs-footer-github",
+      label: "GitHub",
+      type: "link",
+      url: "https://github.com"
+    }
   ]
 };
 function paragraph(text) {
@@ -2402,15 +2616,17 @@ function paragraph(text) {
     direction: null,
     format: "",
     indent: 0,
-    children: [{
-      type: "text",
-      version: 1,
-      detail: 0,
-      format: 0,
-      mode: "normal",
-      style: "",
-      text
-    }]
+    children: [
+      {
+        type: "text",
+        version: 1,
+        detail: 0,
+        format: 0,
+        mode: "normal",
+        style: "",
+        text
+      }
+    ]
   };
 }
 function heading(tag, text) {
@@ -2421,15 +2637,17 @@ function heading(tag, text) {
     direction: null,
     format: "",
     indent: 0,
-    children: [{
-      type: "text",
-      version: 1,
-      detail: 0,
-      format: 0,
-      mode: "normal",
-      style: "",
-      text
-    }]
+    children: [
+      {
+        type: "text",
+        version: 1,
+        detail: 0,
+        format: 0,
+        mode: "normal",
+        style: "",
+        text
+      }
+    ]
   };
 }
 function codeBlock(text, language) {
@@ -2440,15 +2658,17 @@ function codeBlock(text, language) {
     direction: null,
     format: "",
     indent: 0,
-    children: [{
-      type: "text",
-      version: 1,
-      detail: 0,
-      format: 0,
-      mode: "normal",
-      style: "",
-      text
-    }]
+    children: [
+      {
+        type: "text",
+        version: 1,
+        detail: 0,
+        format: 0,
+        mode: "normal",
+        style: "",
+        text
+      }
+    ]
   };
 }
 function listItem(text) {
@@ -2459,15 +2679,17 @@ function listItem(text) {
     direction: null,
     format: "",
     indent: 0,
-    children: [{
-      type: "text",
-      version: 1,
-      detail: 0,
-      format: 0,
-      mode: "normal",
-      style: "",
-      text
-    }]
+    children: [
+      {
+        type: "text",
+        version: 1,
+        detail: 0,
+        format: 0,
+        mode: "normal",
+        style: "",
+        text
+      }
+    ]
   };
 }
 function bulletList(items) {
@@ -2501,7 +2723,9 @@ function stubDoc(opts) {
     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.`)
+      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",
@@ -2592,9 +2816,7 @@ var QUICKSTART_BODY = lexicalDoc([
     "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:"
-  ),
+  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."
@@ -2607,6 +2829,20 @@ var SEED_PAGES = [
     seoDescription: "Install NexPress, learn the core concepts, write plugins, and look up the API.",
     blocks: [],
     template: "front"
+  },
+  {
+    title: "definePlugin",
+    slug: "docs/reference/define-plugin",
+    seoDescription: "API reference for definePlugin from @nexpress/plugin-sdk.",
+    blocks: [],
+    template: "apiReference"
+  },
+  {
+    title: "Changelog",
+    slug: "changelog",
+    seoDescription: "Reverse-chronological changelog for NexPress pre-1.0 releases.",
+    blocks: [],
+    template: "changelog"
   }
 ];
 var SEED_DOCS = [
@@ -2622,7 +2858,12 @@ var SEED_DOCS = [
     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: "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 }),
@@ -2631,7 +2872,12 @@ var SEED_DOCS = [
     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: "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 }),
@@ -2793,6 +3039,16 @@ var docsTheme = defineTheme({
           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
+        },
+        apiReference: {
+          label: "API reference",
+          description: "Docs reference page with signature, parameter table, and return contract.",
+          component: PageApiReferenceTemplate
+        },
+        changelog: {
+          label: "Changelog",
+          description: "Reverse-chronological release timeline with typed change labels.",
+          component: PageChangelogTemplate
         }
       },
       // Universal-content-model #748 — docs are posts with
@@ -2874,6 +3130,8 @@ export {
   DocsSearch,
   DocsShell,
   DocsSidebar,
+  PageApiReferenceTemplate,
+  PageChangelogTemplate,
   docsBlocks,
   docsCss,
   docsSettingsSchema,