@nexpress/theme-docs 0.3.7 → 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";
@@ -1070,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
@@ -2177,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", {
@@ -2194,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",
@@ -2221,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()}`,
@@ -2250,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",
@@ -2339,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) {
@@ -2357,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) {
@@ -2376,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) {
@@ -2395,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) {
@@ -2414,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) {
@@ -2456,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",
@@ -2547,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."
@@ -2562,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 = [
@@ -2577,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 }),
@@ -2586,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 }),
@@ -2748,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
@@ -2829,6 +3130,8 @@ export {
   DocsSearch,
   DocsShell,
   DocsSidebar,
+  PageApiReferenceTemplate,
+  PageChangelogTemplate,
   docsBlocks,
   docsCss,
   docsSettingsSchema,