@nexpress/theme-docs 0.1.0

package/dist/index.js

@@ -0,0 +1,813 @@
+// src/index.ts
+import { defineTheme } from "@nexpress/theme";
+
+// src/header.tsx
+import { NavMenu } from "@nexpress/next";
+
+// src/settings-helpers.ts
+import { getCachedThemeSettings } from "@nexpress/next";
+
+// src/settings.ts
+import { z } from "zod";
+var docsSettingsSchema = z.object({
+  version: z.string().default("v1").describe(
+    "Currently-displayed version label, shown in the masthead. Update on each release."
+  ),
+  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."
+  ),
+  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.")
+});
+
+// src/settings-helpers.ts
+async function resolveDocsSettings() {
+  const raw = await getCachedThemeSettings("docs");
+  const parsed = docsSettingsSchema.safeParse(raw);
+  if (parsed.success) return parsed.data;
+  return docsSettingsSchema.parse({});
+}
+
+// src/header.tsx
+import { jsx, jsxs } from "react/jsx-runtime";
+async function DocsHeader() {
+  const settings = await resolveDocsSettings();
+  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-name", children: "Docs" }),
+      /* @__PURE__ */ jsx("span", { className: "np-docs-brand-version", children: settings.version })
+    ] }),
+    /* @__PURE__ */ jsx(
+      "form",
+      {
+        action: "/docs/search",
+        method: "get",
+        className: "np-docs-search-form",
+        role: "search",
+        children: /* @__PURE__ */ jsx(
+          "input",
+          {
+            type: "search",
+            name: "q",
+            placeholder: settings.searchPlaceholder,
+            className: "np-docs-search-input",
+            "aria-label": "Search the docs"
+          }
+        )
+      }
+    ),
+    /* @__PURE__ */ jsxs("nav", { className: "np-docs-nav", "aria-label": "Primary", children: [
+      /* @__PURE__ */ jsx(NavMenu, { location: "primary", className: "np-docs-primary-nav" }),
+      settings.githubRepo ? /* @__PURE__ */ jsx(
+        "a",
+        {
+          href: settings.githubRepo,
+          className: "np-docs-github-link",
+          target: "_blank",
+          rel: "noreferrer",
+          children: "GitHub"
+        }
+      ) : null
+    ] })
+  ] }) });
+}
+
+// src/members-not-found.tsx
+import { jsx as jsx2, jsxs as jsxs2 } from "react/jsx-runtime";
+function DocsMembersNotFound() {
+  return /* @__PURE__ */ jsxs2(
+    "div",
+    {
+      className: "np-docs-members-not-found",
+      style: {
+        maxWidth: 520,
+        margin: "5rem auto",
+        padding: "0 1.5rem"
+      },
+      children: [
+        /* @__PURE__ */ jsx2(
+          "p",
+          {
+            style: {
+              margin: 0,
+              fontSize: "0.75rem",
+              textTransform: "uppercase",
+              letterSpacing: "0.12em",
+              color: "var(--np-color-muted-foreground)",
+              fontFamily: "var(--np-font-mono, ui-monospace, monospace)"
+            },
+            children: "404 \xB7 account"
+          }
+        ),
+        /* @__PURE__ */ jsx2(
+          "h1",
+          {
+            style: {
+              margin: "0.75rem 0 0",
+              fontSize: "1.875rem",
+              fontFamily: "var(--np-font-heading)",
+              fontWeight: 600,
+              lineHeight: 1.2
+            },
+            children: "That account link is no longer valid."
+          }
+        ),
+        /* @__PURE__ */ jsx2(
+          "p",
+          {
+            style: {
+              margin: "1.25rem 0 0",
+              color: "var(--np-color-muted-foreground)",
+              fontSize: "0.9375rem",
+              lineHeight: 1.6
+            },
+            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(
+          "a",
+          {
+            href: "/members/login",
+            style: {
+              display: "inline-block",
+              padding: "0.5rem 1.25rem",
+              borderRadius: "0.375rem",
+              background: "var(--np-color-primary)",
+              color: "var(--np-color-primary-foreground)",
+              textDecoration: "none",
+              fontSize: "0.875rem",
+              fontWeight: 500
+            },
+            children: "Go to sign in"
+          }
+        ) })
+      ]
+    }
+  );
+}
+
+// src/members-shell.tsx
+import { jsx as jsx3, jsxs as jsxs3 } 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 }) })
+  ] });
+}
+
+// src/not-found.tsx
+import { jsx as jsx4, jsxs as jsxs4 } from "react/jsx-runtime";
+function DocsNotFound() {
+  return /* @__PURE__ */ jsxs4(
+    "div",
+    {
+      className: "np-docs-not-found",
+      style: {
+        maxWidth: 560,
+        margin: "5rem auto",
+        padding: "0 1.5rem"
+      },
+      children: [
+        /* @__PURE__ */ jsx4(
+          "p",
+          {
+            style: {
+              margin: 0,
+              fontSize: "0.75rem",
+              textTransform: "uppercase",
+              letterSpacing: "0.08em",
+              color: "var(--np-color-muted-foreground)"
+            },
+            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(
+          "p",
+          {
+            style: {
+              margin: "0.75rem 0 1.5rem",
+              color: "var(--np-color-muted-foreground)"
+            },
+            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(
+          "a",
+          {
+            href: "/",
+            style: {
+              display: "inline-block",
+              padding: "0.4rem 1rem",
+              borderRadius: "0.375rem",
+              background: "var(--np-color-primary)",
+              color: "var(--np-color-primary-foreground)",
+              textDecoration: "none",
+              fontWeight: 500
+            },
+            children: "Homepage"
+          }
+        )
+      ]
+    }
+  );
+}
+
+// src/routes/doc-detail.tsx
+import { findDocuments as findDocuments2 } from "@nexpress/core";
+import { notFound } from "next/navigation";
+
+// src/templates/doc-page.tsx
+import { findDocuments } from "@nexpress/core";
+import { jsx as jsx5, jsxs as jsxs5 } from "react/jsx-runtime";
+async function DocPageTemplate({
+  doc: rawDoc
+}) {
+  const doc = rawDoc;
+  const settings = await resolveDocsSettings();
+  const navInfo = await loadPrevNext(doc);
+  return /* @__PURE__ */ jsxs5("article", { className: "np-docs-page", children: [
+    /* @__PURE__ */ jsx5("header", { children: /* @__PURE__ */ jsx5("h1", { children: doc.title }) }),
+    /* @__PURE__ */ jsx5("div", { className: "np-docs-body", children: /* @__PURE__ */ jsx5("pre", { style: { whiteSpace: "pre-wrap", fontFamily: "inherit" }, children: typeof doc.body === "string" ? doc.body : "Doc body unavailable." }) }),
+    settings.githubRepo ? /* @__PURE__ */ jsx5("p", { style: { marginTop: "2rem" }, children: /* @__PURE__ */ jsx5(
+      "a",
+      {
+        href: `${settings.githubRepo}/edit/main/docs/${doc.slug}.md`,
+        target: "_blank",
+        rel: "noreferrer",
+        style: {
+          fontSize: "0.875rem",
+          color: "var(--np-color-muted-foreground)"
+        },
+        children: "\u270F\uFE0F Edit on GitHub"
+      }
+    ) }) : null,
+    /* @__PURE__ */ jsxs5("nav", { className: "np-docs-prev-next", "aria-label": "Pagination", children: [
+      navInfo.prev ? /* @__PURE__ */ jsxs5("a", { href: `/docs/${navInfo.prev.slug}`, children: [
+        /* @__PURE__ */ jsx5("span", { className: "np-docs-prev-next-label", children: "\u2190 Previous" }),
+        navInfo.prev.title
+      ] }) : /* @__PURE__ */ jsx5("span", {}),
+      navInfo.next ? /* @__PURE__ */ jsxs5(
+        "a",
+        {
+          href: `/docs/${navInfo.next.slug}`,
+          style: { textAlign: "right" },
+          children: [
+            /* @__PURE__ */ jsx5("span", { className: "np-docs-prev-next-label", children: "Next \u2192" }),
+            navInfo.next.title
+          ]
+        }
+      ) : /* @__PURE__ */ jsx5("span", {})
+    ] })
+  ] });
+}
+async function loadPrevNext(current) {
+  const result = await findDocuments("docs", {
+    where: { status: "published" },
+    sort: "order",
+    limit: 500
+  });
+  const docs = result.docs;
+  const idx = docs.findIndex((d) => d.id === current.id);
+  if (idx < 0) return { prev: null, next: null };
+  return {
+    prev: idx > 0 ? docs[idx - 1] ?? null : null,
+    next: idx < docs.length - 1 ? docs[idx + 1] ?? null : null
+  };
+}
+
+// src/routes/doc-detail.tsx
+import { jsx as jsx6 } from "react/jsx-runtime";
+async function DocsDetailRoute({
+  params,
+  blockCtx
+}) {
+  const slug = typeof params.slug === "string" ? params.slug : "";
+  if (!slug) notFound();
+  const result = await findDocuments2("docs", {
+    where: { slug, status: "published" },
+    limit: 1
+  });
+  const doc = result.docs[0];
+  if (!doc) notFound();
+  const templateProps = {
+    doc,
+    blockCtx
+  };
+  return /* @__PURE__ */ jsx6(DocPageTemplate, { ...templateProps });
+}
+
+// src/search.tsx
+import { getCollectionConfig, searchCollections } from "@nexpress/core";
+import { jsx as jsx7, jsxs as jsxs6 } from "react/jsx-runtime";
+function resolveResultUrl(collection, doc) {
+  try {
+    const config = getCollectionConfig(collection);
+    const urlPath = config.seo?.urlPath;
+    if (typeof urlPath === "function") {
+      const result = urlPath(doc);
+      if (typeof result === "string" && result.length > 0) return result;
+    }
+  } catch {
+  }
+  const slug = typeof doc.slug === "string" ? doc.slug : "";
+  return slug ? `/${collection}/${slug}` : "#";
+}
+async function DocsSearch({
+  searchParams
+}) {
+  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." })
+    ] });
+  }
+  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",
+      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) => {
+      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(
+        "li",
+        {
+          style: {
+            padding: "1rem 0",
+            borderBottom: "1px solid var(--np-color-border)"
+          },
+          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
+          ]
+        },
+        `${item.collection}:${doc.id ?? i}`
+      );
+    }) })
+  ] });
+}
+
+// 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 }) });
+}
+
+// src/sidebar.tsx
+import { findDocuments as findDocuments3 } from "@nexpress/core";
+import { jsx as jsx9, jsxs as jsxs7 } from "react/jsx-runtime";
+async function DocsSidebar() {
+  const settings = await resolveDocsSettings();
+  const result = await findDocuments3("docs", {
+    where: { status: "published" },
+    sort: "order",
+    limit: 500
+  });
+  const tree = buildTree(result.docs);
+  return /* @__PURE__ */ jsxs7("aside", { className: "np-docs-sidebar", "aria-label": "Docs navigation", children: [
+    /* @__PURE__ */ jsx9("h2", { children: settings.sidebarHeading }),
+    /* @__PURE__ */ jsx9(NavTree, { nodes: tree })
+  ] });
+}
+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, {
+      id: d.id,
+      slug: d.slug,
+      title: typeof d.title === "string" ? d.title : d.slug,
+      parent: typeof d.parent === "string" ? d.parent : null,
+      order: typeof d.order === "number" ? d.order : 0,
+      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 }) {
+  return /* @__PURE__ */ jsx9("ul", { children: nodes.map((n) => /* @__PURE__ */ jsxs7("li", { children: [
+    /* @__PURE__ */ jsx9("a", { href: `/docs/${n.slug}`, children: n.title }),
+    n.children.length > 0 ? /* @__PURE__ */ jsx9(NavTree, { nodes: n.children }) : null
+  ] }, n.id)) });
+}
+
+// src/styles.ts
+var docsCss = `
+.np-docs-shell {
+  display: flex;
+  flex-direction: column;
+  min-height: 100vh;
+  background: var(--np-color-background);
+  color: var(--np-color-foreground);
+  font-family: var(--np-font-body, system-ui, sans-serif);
+}
+
+.np-docs-header {
+  position: sticky;
+  top: 0;
+  z-index: 50;
+  background: var(--np-color-background);
+  border-bottom: 1px solid var(--np-color-border);
+  backdrop-filter: blur(8px);
+}
+
+.np-docs-header-inner {
+  max-width: 1200px;
+  margin: 0 auto;
+  padding: 0.75rem 1.5rem;
+  display: grid;
+  grid-template-columns: auto 1fr auto;
+  gap: 1.5rem;
+  align-items: center;
+}
+
+.np-docs-brand {
+  display: flex;
+  align-items: baseline;
+  gap: 0.5rem;
+  font-weight: 600;
+  text-decoration: none;
+  color: var(--np-color-foreground);
+}
+
+.np-docs-brand-version {
+  font-size: 0.75rem;
+  font-family: ui-monospace, "SF Mono", Menlo, monospace;
+  color: var(--np-color-muted-foreground);
+  background: var(--np-color-muted);
+  padding: 0.125rem 0.375rem;
+  border-radius: 0.25rem;
+}
+
+.np-docs-search-form {
+  flex: 1;
+}
+
+.np-docs-search-input {
+  width: 100%;
+  padding: 0.4rem 0.75rem;
+  border: 1px solid var(--np-color-border);
+  border-radius: 0.375rem;
+  background: var(--np-color-card);
+  color: var(--np-color-foreground);
+  font-size: 0.875rem;
+}
+
+.np-docs-search-input:focus {
+  outline: 2px solid var(--np-color-primary);
+  outline-offset: -2px;
+  border-color: transparent;
+}
+
+.np-docs-nav {
+  display: flex;
+  align-items: center;
+  gap: 1rem;
+}
+
+.np-docs-primary-nav {
+  display: flex;
+  list-style: none;
+  margin: 0;
+  padding: 0;
+  gap: 1rem;
+}
+
+.np-docs-primary-nav a {
+  color: var(--np-color-muted-foreground);
+  text-decoration: none;
+  font-size: 0.875rem;
+}
+
+.np-docs-primary-nav a:hover {
+  color: var(--np-color-foreground);
+}
+
+.np-docs-github-link {
+  font-size: 0.875rem;
+  color: var(--np-color-muted-foreground);
+  text-decoration: none;
+}
+
+.np-docs-grid {
+  flex: 1;
+  display: grid;
+  grid-template-columns: 240px minmax(0, 1fr);
+  max-width: 1200px;
+  margin: 0 auto;
+  width: 100%;
+  gap: 2.5rem;
+  padding: 2rem 1.5rem;
+}
+
+@media (max-width: 768px) {
+  .np-docs-grid {
+    grid-template-columns: 1fr;
+  }
+  .np-docs-sidebar {
+    display: none;
+  }
+}
+
+.np-docs-sidebar {
+  position: sticky;
+  top: 4rem;
+  align-self: start;
+  max-height: calc(100vh - 5rem);
+  overflow-y: auto;
+}
+
+.np-docs-sidebar h2 {
+  font-size: 0.75rem;
+  text-transform: uppercase;
+  letter-spacing: 0.08em;
+  color: var(--np-color-muted-foreground);
+  margin: 0 0 0.75rem;
+}
+
+.np-docs-sidebar ul {
+  list-style: none;
+  padding: 0;
+  margin: 0;
+}
+
+.np-docs-sidebar li {
+  margin: 0.125rem 0;
+}
+
+.np-docs-sidebar a {
+  display: block;
+  padding: 0.25rem 0.5rem;
+  border-radius: 0.25rem;
+  color: var(--np-color-muted-foreground);
+  text-decoration: none;
+  font-size: 0.875rem;
+}
+
+.np-docs-sidebar a:hover {
+  background: var(--np-color-muted);
+  color: var(--np-color-foreground);
+}
+
+.np-docs-sidebar a[data-current="true"] {
+  background: color-mix(in oklch, var(--np-color-primary) 12%, transparent);
+  color: var(--np-color-primary);
+  font-weight: 500;
+}
+
+.np-docs-sidebar ul ul {
+  margin-left: 0.75rem;
+  border-left: 1px solid var(--np-color-border);
+  padding-left: 0.5rem;
+}
+
+.np-docs-page {
+  max-width: 720px;
+}
+
+.np-docs-page h1 {
+  font-size: 2rem;
+  margin: 0 0 0.5rem;
+}
+
+.np-docs-prev-next {
+  display: grid;
+  grid-template-columns: 1fr 1fr;
+  gap: 1rem;
+  margin-top: 3rem;
+  padding-top: 1.5rem;
+  border-top: 1px solid var(--np-color-border);
+}
+
+.np-docs-prev-next a {
+  display: block;
+  padding: 0.75rem 1rem;
+  border: 1px solid var(--np-color-border);
+  border-radius: 0.5rem;
+  color: var(--np-color-foreground);
+  text-decoration: none;
+}
+
+.np-docs-prev-next a:hover {
+  border-color: var(--np-color-primary);
+}
+
+.np-docs-prev-next-label {
+  display: block;
+  font-size: 0.75rem;
+  color: var(--np-color-muted-foreground);
+  margin-bottom: 0.25rem;
+}
+
+/* M.* member surface \u2014 narrow auth-form column under the
+   masthead, no sidebar (the docs sidebar is hierarchical
+   doc nav, useless on auth forms). */
+.np-docs-members {
+  display: flex;
+  justify-content: center;
+  min-height: 60vh;
+  padding: 3rem 1.5rem;
+}
+.np-docs-members-column {
+  width: 100%;
+  max-width: 440px;
+}
+
+/* Member form token overrides \u2014 docs aesthetic: slightly
+   rounded corners, neutral palette, monospace label accent. */
+.np-docs .np-members-form {
+  --np-member-form-input-bg: var(--np-color-background);
+  --np-member-form-input-border: var(--np-color-border);
+  --np-member-form-input-border-focus: var(--np-color-primary);
+  --np-member-form-input-radius: 0.375rem;
+  --np-member-form-button-radius: 0.375rem;
+}
+.np-docs .np-members-form .np-form-label {
+  font-family: var(--np-font-mono, ui-monospace, monospace);
+  font-size: 0.8125rem;
+}
+`;
+
+// src/index.ts
+var docsTheme = defineTheme({
+  manifest: {
+    id: "docs",
+    name: "Docs",
+    version: "0.1.0",
+    description: "Documentation theme \u2014 hierarchical sidebar, prev/next nav, search masthead. Pairs with a `docs` collection that has parent/order fields.",
+    author: { name: "NexPress" },
+    nexpress: { minVersion: "0.1.0" },
+    requires: {
+      collections: {
+        docs: {
+          createIfAbsent: true,
+          fields: {
+            title: { type: "text", required: true },
+            body: { type: "richText" },
+            parent: {
+              type: "relationship",
+              relationTo: "docs",
+              hard: false
+            },
+            order: { type: "number" }
+          }
+        }
+      }
+    },
+    settingsSchema: docsSettingsSchema
+  },
+  impl: {
+    shell: DocsShell,
+    slots: {
+      header: DocsHeader,
+      sidebar: DocsSidebar
+    },
+    css: docsCss,
+    tokens: {
+      // Docs lean cool/neutral with a sharp accent — distinct
+      // from magazine's warm cream so a side-by-side preview
+      // makes the swap obvious.
+      colors: {
+        primary: "oklch(0.55 0.18 260)",
+        primaryForeground: "oklch(0.985 0.005 260)",
+        background: "oklch(0.99 0.005 260)",
+        foreground: "oklch(0.18 0.025 260)",
+        muted: "oklch(0.95 0.012 260)",
+        mutedForeground: "oklch(0.5 0.025 260)",
+        border: "oklch(0.9 0.012 260)",
+        card: "oklch(0.985 0.008 260)",
+        cardForeground: "oklch(0.18 0.025 260)",
+        accent: "oklch(0.92 0.05 260)",
+        accentForeground: "oklch(0.18 0.025 260)"
+      }
+    },
+    templates: {
+      docs: {
+        default: {
+          label: "Doc page",
+          description: "Hierarchical sidebar + body + prev/next nav. Optional 'Edit on GitHub' link when settings.githubRepo is set.",
+          component: DocPageTemplate
+        }
+      }
+    },
+    routes: [
+      // F.2 — docs theme's scoped search route. Lives at
+      // `/docs/search` rather than `/search` (#609): the host's
+      // reference app has an app-explicit `/search` page route
+      // that takes precedence over theme routes per the locked
+      // dispatch order (app file > page > theme > plugin). The
+      // theme can't override the universal search page, so it
+      // scopes its own search to a `/docs/*` namespace and the
+      // operator gets both routes: framework `/search` + docs
+      // theme `/docs/search`.
+      //
+      // Order matters: search comes first so `/docs/search` is
+      // matched as a literal rather than `{ slug: "search" }`
+      // by the parametric detail route below (dispatcher is
+      // first-match-wins).
+      { pattern: "/docs/search", component: DocsSearch },
+      // Doc detail dispatch (#614). The sidebar + template emit
+      // `/docs/<slug>` links; without this route those 404 in
+      // the reference app — the catch-all only resolves `pages`
+      // rows, not arbitrary `docs` collection rows. The
+      // component looks up the docs row by slug and renders
+      // through `templates.docs.default` (DocPageTemplate).
+      { pattern: "/docs/:slug", component: DocsDetailRoute }
+    ],
+    navLocations: {
+      primary: {
+        label: "Primary header nav",
+        description: "Inline links beside the masthead search box.",
+        maxItems: 5
+      }
+    },
+    notFound: DocsNotFound,
+    // M.* adoption (2026-05-11). Docs gains purpose-built member
+    // chrome: drops the docs sidebar (hierarchical doc nav is
+    // useless on auth forms), keeps the masthead, narrows the
+    // content column. Without this, the fallback chain would
+    // walk back to `impl.shell` (the 3-column grid) and the
+    // sidebar slot would surface alongside an auth form.
+    // - `shell`: DocsMembersShell (header + narrow column, no
+    //   sidebar).
+    // - `notFound`: DocsMembersNotFound (stale-auth-link framing
+    //   with /members/login CTA, monospace accent matching the
+    //   theme).
+    // - `error`: forward-compat type marker; the actual render
+    //   goes through `./components/members-error`'s client
+    //   subpath, lazy-imported by
+    //   `apps/web/src/app/(member)/error.tsx`'s registry
+    //   (F.7.1 delegation — Next mandates `error.tsx` is "use
+    //   client").
+    members: {
+      shell: DocsMembersShell,
+      notFound: DocsMembersNotFound
+    }
+  }
+});
+export {
+  DocPageTemplate,
+  DocsHeader,
+  DocsMembersNotFound,
+  DocsMembersShell,
+  DocsNotFound,
+  DocsSearch,
+  DocsShell,
+  DocsSidebar,
+  docsCss,
+  docsSettingsSchema,
+  docsTheme
+};
+//# sourceMappingURL=index.js.map