@nexpress/theme-docs 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Nexpress
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/components/error.d.ts

@@ -0,0 +1,25 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+
+/**
+ * Docs theme's public-site error boundary fallback.
+ *
+ * Same delegation pattern as `./members-error.tsx`: Next requires
+ * `(site)/error.tsx` to be a client component, so theme error UI
+ * ships as a separate client subpath that the host's error.tsx
+ * lazy-imports based on the active theme.
+ *
+ * Imported as `@nexpress/theme-docs/components/error` by
+ * `apps/web/src/app/(site)/error.tsx`'s registry.
+ *
+ * Tone matches the docs aesthetic — monospace eyebrow ("500 ·
+ * docs"), neutral palette, technical voice.
+ */
+interface DocsErrorProps {
+    error: Error & {
+        digest?: string;
+    };
+    reset: () => void;
+}
+declare function DocsError({ error, reset }: DocsErrorProps): react_jsx_runtime.JSX.Element;
+
+export { DocsError as default };

package/dist/components/error.js

@@ -0,0 +1,115 @@
+"use client";
+"use client";
+
+// src/components/error.tsx
+import { jsx, jsxs } from "react/jsx-runtime";
+function DocsError({ error, reset }) {
+  return /* @__PURE__ */ jsxs(
+    "main",
+    {
+      className: "np-docs np-docs-error",
+      style: {
+        maxWidth: 560,
+        margin: "5rem auto",
+        padding: "0 1.5rem"
+      },
+      children: [
+        /* @__PURE__ */ jsx(
+          "p",
+          {
+            style: {
+              margin: 0,
+              fontSize: "0.75rem",
+              textTransform: "uppercase",
+              letterSpacing: "0.12em",
+              color: "var(--np-color-muted-foreground, #64748b)",
+              fontFamily: "var(--np-font-mono, ui-monospace, monospace)"
+            },
+            children: "500 \xB7 docs"
+          }
+        ),
+        /* @__PURE__ */ jsx(
+          "h1",
+          {
+            style: {
+              margin: "0.75rem 0 0",
+              fontSize: "1.875rem",
+              fontFamily: "var(--np-font-heading)",
+              fontWeight: 600,
+              lineHeight: 1.2
+            },
+            children: "The page failed to render."
+          }
+        ),
+        /* @__PURE__ */ jsx(
+          "p",
+          {
+            style: {
+              margin: "1.25rem 0 0",
+              color: "var(--np-color-muted-foreground, #64748b)",
+              fontSize: "0.9375rem",
+              lineHeight: 1.6
+            },
+            children: process.env.NODE_ENV === "production" ? "Refreshing usually clears it. If the problem persists, the page may be temporarily broken \u2014 check back shortly." : error.message
+          }
+        ),
+        /* @__PURE__ */ jsxs(
+          "div",
+          {
+            style: {
+              marginTop: "1.75rem",
+              display: "flex",
+              gap: "0.75rem",
+              flexWrap: "wrap"
+            },
+            children: [
+              /* @__PURE__ */ jsx(
+                "button",
+                {
+                  type: "button",
+                  onClick: reset,
+                  style: {
+                    padding: "0.5rem 1.25rem",
+                    fontFamily: "inherit",
+                    fontSize: "0.875rem",
+                    fontWeight: 500,
+                    background: "var(--np-color-primary, #0f172a)",
+                    color: "var(--np-color-primary-foreground, #fff)",
+                    border: "none",
+                    borderRadius: "0.375rem",
+                    cursor: "pointer"
+                  },
+                  children: "Try again"
+                }
+              ),
+              /* @__PURE__ */ jsx(
+                "a",
+                {
+                  href: "/",
+                  style: {
+                    padding: "0.5rem 1.25rem",
+                    fontFamily: "inherit",
+                    fontSize: "0.875rem",
+                    fontWeight: 500,
+                    background: "transparent",
+                    color: "var(--np-color-foreground)",
+                    border: "1px solid var(--np-color-border, #e2e8f0)",
+                    borderRadius: "0.375rem",
+                    textDecoration: "none",
+                    display: "inline-flex",
+                    alignItems: "center"
+                  },
+                  children: "Back home"
+                }
+              )
+            ]
+          }
+        )
+      ]
+    }
+  );
+}
+export {
+  DocsError as default
+};
+//# sourceMappingURL=error.js.map

package/dist/components/error.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/components/error.tsx"],"sourcesContent":["\"use client\";\n\n/**\n * Docs theme's public-site error boundary fallback.\n *\n * Same delegation pattern as `./members-error.tsx`: Next requires\n * `(site)/error.tsx` to be a client component, so theme error UI\n * ships as a separate client subpath that the host's error.tsx\n * lazy-imports based on the active theme.\n *\n * Imported as `@nexpress/theme-docs/components/error` by\n * `apps/web/src/app/(site)/error.tsx`'s registry.\n *\n * Tone matches the docs aesthetic — monospace eyebrow (\"500 ·\n * docs\"), neutral palette, technical voice.\n */\n\ninterface DocsErrorProps {\n  error: Error & { digest?: string };\n  reset: () => void;\n}\n\nexport default function DocsError({ error, reset }: DocsErrorProps) {\n  // Renders `<main>` because the host's (site)/error.tsx no\n  // longer relies on the layout for the `<main>` landmark (v0.2\n  // shell-wrap refactor moved that into pages). Theme error\n  // subpaths render *in place of* DefaultError, so we mirror\n  // its `<main>` — one per page either way.\n  return (\n    <main\n      className=\"np-docs np-docs-error\"\n      style={{\n        maxWidth: 560,\n        margin: \"5rem auto\",\n        padding: \"0 1.5rem\",\n      }}\n    >\n      <p\n        style={{\n          margin: 0,\n          fontSize: \"0.75rem\",\n          textTransform: \"uppercase\",\n          letterSpacing: \"0.12em\",\n          color: \"var(--np-color-muted-foreground, #64748b)\",\n          fontFamily: \"var(--np-font-mono, ui-monospace, monospace)\",\n        }}\n      >\n        500 · docs\n      </p>\n      <h1\n        style={{\n          margin: \"0.75rem 0 0\",\n          fontSize: \"1.875rem\",\n          fontFamily: \"var(--np-font-heading)\",\n          fontWeight: 600,\n          lineHeight: 1.2,\n        }}\n      >\n        The page failed to render.\n      </h1>\n      <p\n        style={{\n          margin: \"1.25rem 0 0\",\n          color: \"var(--np-color-muted-foreground, #64748b)\",\n          fontSize: \"0.9375rem\",\n          lineHeight: 1.6,\n        }}\n      >\n        {process.env.NODE_ENV === \"production\"\n          ? \"Refreshing usually clears it. If the problem persists, the page may be temporarily broken — check back shortly.\"\n          : error.message}\n      </p>\n      <div\n        style={{\n          marginTop: \"1.75rem\",\n          display: \"flex\",\n          gap: \"0.75rem\",\n          flexWrap: \"wrap\",\n        }}\n      >\n        <button\n          type=\"button\"\n          onClick={reset}\n          style={{\n            padding: \"0.5rem 1.25rem\",\n            fontFamily: \"inherit\",\n            fontSize: \"0.875rem\",\n            fontWeight: 500,\n            background: \"var(--np-color-primary, #0f172a)\",\n            color: \"var(--np-color-primary-foreground, #fff)\",\n            border: \"none\",\n            borderRadius: \"0.375rem\",\n            cursor: \"pointer\",\n          }}\n        >\n          Try again\n        </button>\n        <a\n          href=\"/\"\n          style={{\n            padding: \"0.5rem 1.25rem\",\n            fontFamily: \"inherit\",\n            fontSize: \"0.875rem\",\n            fontWeight: 500,\n            background: \"transparent\",\n            color: \"var(--np-color-foreground)\",\n            border: \"1px solid var(--np-color-border, #e2e8f0)\",\n            borderRadius: \"0.375rem\",\n            textDecoration: \"none\",\n            display: \"inline-flex\",\n            alignItems: \"center\",\n          }}\n        >\n          Back home\n        </a>\n      </div>\n    </main>\n  );\n}\n"],"mappings":";;;;AAqCM,cAmCA,YAnCA;AAfS,SAAR,UAA2B,EAAE,OAAO,MAAM,GAAmB;AAMlE,SACE;AAAA,IAAC;AAAA;AAAA,MACC,WAAU;AAAA,MACV,OAAO;AAAA,QACL,UAAU;AAAA,QACV,QAAQ;AAAA,QACR,SAAS;AAAA,MACX;AAAA,MAEA;AAAA;AAAA,UAAC;AAAA;AAAA,YACC,OAAO;AAAA,cACL,QAAQ;AAAA,cACR,UAAU;AAAA,cACV,eAAe;AAAA,cACf,eAAe;AAAA,cACf,OAAO;AAAA,cACP,YAAY;AAAA,YACd;AAAA,YACD;AAAA;AAAA,QAED;AAAA,QACA;AAAA,UAAC;AAAA;AAAA,YACC,OAAO;AAAA,cACL,QAAQ;AAAA,cACR,UAAU;AAAA,cACV,YAAY;AAAA,cACZ,YAAY;AAAA,cACZ,YAAY;AAAA,YACd;AAAA,YACD;AAAA;AAAA,QAED;AAAA,QACA;AAAA,UAAC;AAAA;AAAA,YACC,OAAO;AAAA,cACL,QAAQ;AAAA,cACR,OAAO;AAAA,cACP,UAAU;AAAA,cACV,YAAY;AAAA,YACd;AAAA,YAEC,kBAAQ,IAAI,aAAa,eACtB,yHACA,MAAM;AAAA;AAAA,QACZ;AAAA,QACA;AAAA,UAAC;AAAA;AAAA,YACC,OAAO;AAAA,cACL,WAAW;AAAA,cACX,SAAS;AAAA,cACT,KAAK;AAAA,cACL,UAAU;AAAA,YACZ;AAAA,YAEA;AAAA;AAAA,gBAAC;AAAA;AAAA,kBACC,MAAK;AAAA,kBACL,SAAS;AAAA,kBACT,OAAO;AAAA,oBACL,SAAS;AAAA,oBACT,YAAY;AAAA,oBACZ,UAAU;AAAA,oBACV,YAAY;AAAA,oBACZ,YAAY;AAAA,oBACZ,OAAO;AAAA,oBACP,QAAQ;AAAA,oBACR,cAAc;AAAA,oBACd,QAAQ;AAAA,kBACV;AAAA,kBACD;AAAA;AAAA,cAED;AAAA,cACA;AAAA,gBAAC;AAAA;AAAA,kBACC,MAAK;AAAA,kBACL,OAAO;AAAA,oBACL,SAAS;AAAA,oBACT,YAAY;AAAA,oBACZ,UAAU;AAAA,oBACV,YAAY;AAAA,oBACZ,YAAY;AAAA,oBACZ,OAAO;AAAA,oBACP,QAAQ;AAAA,oBACR,cAAc;AAAA,oBACd,gBAAgB;AAAA,oBAChB,SAAS;AAAA,oBACT,YAAY;AAAA,kBACd;AAAA,kBACD;AAAA;AAAA,cAED;AAAA;AAAA;AAAA,QACF;AAAA;AAAA;AAAA,EACF;AAEJ;","names":[]}

package/dist/components/members-error.d.ts

@@ -0,0 +1,27 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+
+/**
+ * Docs theme's member-tree error boundary fallback.
+ *
+ * Same delegation pattern as magazine's: Next requires
+ * `(member)/error.tsx` to be a client component, so theme error
+ * UI ships as a separate client subpath that the host's
+ * error.tsx lazy-imports based on the active theme. The theme's
+ * `impl.members.error` slot stays as a forward-compat type
+ * marker; the actual rendering goes through this client entry.
+ *
+ * Imported as `@nexpress/theme-docs/components/members-error`
+ * by `apps/web/src/app/(member)/error.tsx`.
+ *
+ * Tone matches the docs aesthetic — technical, monospace
+ * accent, with "Back to sign in" as the secondary CTA.
+ */
+interface DocsMembersErrorProps {
+    error: Error & {
+        digest?: string;
+    };
+    reset: () => void;
+}
+declare function DocsMembersError({ error, reset, }: DocsMembersErrorProps): react_jsx_runtime.JSX.Element;
+
+export { DocsMembersError as default };

package/dist/components/members-error.js

@@ -0,0 +1,118 @@
+"use client";
+"use client";
+
+// src/components/members-error.tsx
+import { jsx, jsxs } from "react/jsx-runtime";
+function DocsMembersError({
+  error,
+  reset
+}) {
+  return /* @__PURE__ */ jsxs(
+    "main",
+    {
+      className: "np-docs np-docs-members-error",
+      style: {
+        maxWidth: 520,
+        margin: "5rem auto",
+        padding: "0 1.5rem"
+      },
+      children: [
+        /* @__PURE__ */ jsx(
+          "p",
+          {
+            style: {
+              margin: 0,
+              fontSize: "0.75rem",
+              textTransform: "uppercase",
+              letterSpacing: "0.12em",
+              color: "var(--np-color-muted-foreground, #64748b)",
+              fontFamily: "var(--np-font-mono, ui-monospace, monospace)"
+            },
+            children: "500 \xB7 account"
+          }
+        ),
+        /* @__PURE__ */ jsx(
+          "h1",
+          {
+            style: {
+              margin: "0.75rem 0 0",
+              fontSize: "1.875rem",
+              fontFamily: "var(--np-font-heading)",
+              fontWeight: 600,
+              lineHeight: 1.2
+            },
+            children: "Something interrupted your session."
+          }
+        ),
+        /* @__PURE__ */ jsx(
+          "p",
+          {
+            style: {
+              margin: "1.25rem 0 0",
+              color: "var(--np-color-muted-foreground, #64748b)",
+              fontSize: "0.9375rem",
+              lineHeight: 1.6
+            },
+            children: process.env.NODE_ENV === "production" ? "A fresh sign-in usually clears this. Try again, or sign back in to start fresh." : error.message
+          }
+        ),
+        /* @__PURE__ */ jsxs(
+          "div",
+          {
+            style: {
+              marginTop: "1.75rem",
+              display: "flex",
+              gap: "0.75rem",
+              flexWrap: "wrap"
+            },
+            children: [
+              /* @__PURE__ */ jsx(
+                "button",
+                {
+                  type: "button",
+                  onClick: reset,
+                  style: {
+                    padding: "0.5rem 1.25rem",
+                    fontFamily: "inherit",
+                    fontSize: "0.875rem",
+                    fontWeight: 500,
+                    background: "var(--np-color-primary, #0f172a)",
+                    color: "var(--np-color-primary-foreground, #fff)",
+                    border: "none",
+                    borderRadius: "0.375rem",
+                    cursor: "pointer"
+                  },
+                  children: "Try again"
+                }
+              ),
+              /* @__PURE__ */ jsx(
+                "a",
+                {
+                  href: "/members/login",
+                  style: {
+                    padding: "0.5rem 1.25rem",
+                    fontFamily: "inherit",
+                    fontSize: "0.875rem",
+                    fontWeight: 500,
+                    background: "transparent",
+                    color: "var(--np-color-foreground)",
+                    border: "1px solid var(--np-color-border, #e2e8f0)",
+                    borderRadius: "0.375rem",
+                    textDecoration: "none",
+                    display: "inline-flex",
+                    alignItems: "center"
+                  },
+                  children: "Back to sign in"
+                }
+              )
+            ]
+          }
+        )
+      ]
+    }
+  );
+}
+export {
+  DocsMembersError as default
+};
+//# sourceMappingURL=members-error.js.map

package/dist/components/members-error.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/components/members-error.tsx"],"sourcesContent":["\"use client\";\n\n/**\n * Docs theme's member-tree error boundary fallback.\n *\n * Same delegation pattern as magazine's: Next requires\n * `(member)/error.tsx` to be a client component, so theme error\n * UI ships as a separate client subpath that the host's\n * error.tsx lazy-imports based on the active theme. The theme's\n * `impl.members.error` slot stays as a forward-compat type\n * marker; the actual rendering goes through this client entry.\n *\n * Imported as `@nexpress/theme-docs/components/members-error`\n * by `apps/web/src/app/(member)/error.tsx`.\n *\n * Tone matches the docs aesthetic — technical, monospace\n * accent, with \"Back to sign in\" as the secondary CTA.\n */\n\ninterface DocsMembersErrorProps {\n  error: Error & { digest?: string };\n  reset: () => void;\n}\n\nexport default function DocsMembersError({\n  error,\n  reset,\n}: DocsMembersErrorProps) {\n  // Renders `<main>` because the host's (member)/error.tsx no\n  // longer relies on the layout for the `<main>` landmark (v0.2\n  // shell-wrap refactor moved that into pages). Theme\n  // members-error subpaths render in place of DefaultMemberError,\n  // so we mirror its `<main>` — one per page either way.\n  return (\n    <main\n      className=\"np-docs np-docs-members-error\"\n      style={{\n        maxWidth: 520,\n        margin: \"5rem auto\",\n        padding: \"0 1.5rem\",\n      }}\n    >\n      <p\n        style={{\n          margin: 0,\n          fontSize: \"0.75rem\",\n          textTransform: \"uppercase\",\n          letterSpacing: \"0.12em\",\n          color: \"var(--np-color-muted-foreground, #64748b)\",\n          fontFamily: \"var(--np-font-mono, ui-monospace, monospace)\",\n        }}\n      >\n        500 · account\n      </p>\n      <h1\n        style={{\n          margin: \"0.75rem 0 0\",\n          fontSize: \"1.875rem\",\n          fontFamily: \"var(--np-font-heading)\",\n          fontWeight: 600,\n          lineHeight: 1.2,\n        }}\n      >\n        Something interrupted your session.\n      </h1>\n      <p\n        style={{\n          margin: \"1.25rem 0 0\",\n          color: \"var(--np-color-muted-foreground, #64748b)\",\n          fontSize: \"0.9375rem\",\n          lineHeight: 1.6,\n        }}\n      >\n        {process.env.NODE_ENV === \"production\"\n          ? \"A fresh sign-in usually clears this. Try again, or sign back in to start fresh.\"\n          : error.message}\n      </p>\n      <div\n        style={{\n          marginTop: \"1.75rem\",\n          display: \"flex\",\n          gap: \"0.75rem\",\n          flexWrap: \"wrap\",\n        }}\n      >\n        <button\n          type=\"button\"\n          onClick={reset}\n          style={{\n            padding: \"0.5rem 1.25rem\",\n            fontFamily: \"inherit\",\n            fontSize: \"0.875rem\",\n            fontWeight: 500,\n            background: \"var(--np-color-primary, #0f172a)\",\n            color: \"var(--np-color-primary-foreground, #fff)\",\n            border: \"none\",\n            borderRadius: \"0.375rem\",\n            cursor: \"pointer\",\n          }}\n        >\n          Try again\n        </button>\n        <a\n          href=\"/members/login\"\n          style={{\n            padding: \"0.5rem 1.25rem\",\n            fontFamily: \"inherit\",\n            fontSize: \"0.875rem\",\n            fontWeight: 500,\n            background: \"transparent\",\n            color: \"var(--np-color-foreground)\",\n            border: \"1px solid var(--np-color-border, #e2e8f0)\",\n            borderRadius: \"0.375rem\",\n            textDecoration: \"none\",\n            display: \"inline-flex\",\n            alignItems: \"center\",\n          }}\n        >\n          Back to sign in\n        </a>\n      </div>\n    </main>\n  );\n}\n"],"mappings":";;;;AA0CM,cAmCA,YAnCA;AAlBS,SAAR,iBAAkC;AAAA,EACvC;AAAA,EACA;AACF,GAA0B;AAMxB,SACE;AAAA,IAAC;AAAA;AAAA,MACC,WAAU;AAAA,MACV,OAAO;AAAA,QACL,UAAU;AAAA,QACV,QAAQ;AAAA,QACR,SAAS;AAAA,MACX;AAAA,MAEA;AAAA;AAAA,UAAC;AAAA;AAAA,YACC,OAAO;AAAA,cACL,QAAQ;AAAA,cACR,UAAU;AAAA,cACV,eAAe;AAAA,cACf,eAAe;AAAA,cACf,OAAO;AAAA,cACP,YAAY;AAAA,YACd;AAAA,YACD;AAAA;AAAA,QAED;AAAA,QACA;AAAA,UAAC;AAAA;AAAA,YACC,OAAO;AAAA,cACL,QAAQ;AAAA,cACR,UAAU;AAAA,cACV,YAAY;AAAA,cACZ,YAAY;AAAA,cACZ,YAAY;AAAA,YACd;AAAA,YACD;AAAA;AAAA,QAED;AAAA,QACA;AAAA,UAAC;AAAA;AAAA,YACC,OAAO;AAAA,cACL,QAAQ;AAAA,cACR,OAAO;AAAA,cACP,UAAU;AAAA,cACV,YAAY;AAAA,YACd;AAAA,YAEC,kBAAQ,IAAI,aAAa,eACtB,oFACA,MAAM;AAAA;AAAA,QACZ;AAAA,QACA;AAAA,UAAC;AAAA;AAAA,YACC,OAAO;AAAA,cACL,WAAW;AAAA,cACX,SAAS;AAAA,cACT,KAAK;AAAA,cACL,UAAU;AAAA,YACZ;AAAA,YAEA;AAAA;AAAA,gBAAC;AAAA;AAAA,kBACC,MAAK;AAAA,kBACL,SAAS;AAAA,kBACT,OAAO;AAAA,oBACL,SAAS;AAAA,oBACT,YAAY;AAAA,oBACZ,UAAU;AAAA,oBACV,YAAY;AAAA,oBACZ,YAAY;AAAA,oBACZ,OAAO;AAAA,oBACP,QAAQ;AAAA,oBACR,cAAc;AAAA,oBACd,QAAQ;AAAA,kBACV;AAAA,kBACD;AAAA;AAAA,cAED;AAAA,cACA;AAAA,gBAAC;AAAA;AAAA,kBACC,MAAK;AAAA,kBACL,OAAO;AAAA,oBACL,SAAS;AAAA,oBACT,YAAY;AAAA,oBACZ,UAAU;AAAA,oBACV,YAAY;AAAA,oBACZ,YAAY;AAAA,oBACZ,OAAO;AAAA,oBACP,QAAQ;AAAA,oBACR,cAAc;AAAA,oBACd,gBAAgB;AAAA,oBAChB,SAAS;AAAA,oBACT,YAAY;AAAA,kBACd;AAAA,kBACD;AAAA;AAAA,cAED;AAAA;AAAA;AAAA,QACF;AAAA;AAAA;AAAA,EACF;AAEJ;","names":[]}

package/dist/index.d.ts

@@ -0,0 +1,156 @@
+import * as _nexpress_theme from '@nexpress/theme';
+import { NpRouteRenderProps, NpThemeShellProps, NpTemplateRenderProps } from '@nexpress/theme';
+import * as React from 'react';
+import { ReactNode } from 'react';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { z } from 'zod';
+
+/**
+ * Phase F.9-B — docs theme masthead.
+ *
+ * Brand strap: site title (left), search input (center), nav
+ * + version label (right). Reads settings via
+ * `resolveDocsSettings()` so the version label and search
+ * placeholder match the operator's admin choices.
+ *
+ * The search input is a plain GET form to `/docs/search` —
+ * F.2's theme route handles the query (#609: the universal
+ * `/search` is the framework's own page, so the docs theme
+ * scopes its search to `/docs/search` to avoid being shadowed
+ * by the host's `app/(site)/search/page.tsx`). No client-side
+ * JS for the input itself; works without hydration.
+ */
+declare function DocsHeader(): Promise<React.ReactElement>;
+
+/**
+ * Docs theme's member-tree 404.
+ *
+ * Mirrors `DocsNotFound`'s technical voice but tuned for the
+ * member context — CTA points at `/members/login` rather than
+ * the docs index, and the copy acknowledges stale auth links
+ * (the dominant cause of 404s inside `/members/*`).
+ *
+ * Server component; rendered by `(member)/not-found.tsx` when
+ * the active theme is docs and `impl.members.notFound` is
+ * declared.
+ *
+ * Renders a `<div>`, not `<main>`, because the framework's
+ * `<ShellWrap surface="member">` already emits the page's
+ * `<main className="np-member-main">` landmark.
+ */
+declare function DocsMembersNotFound(): React.ReactElement;
+
+/**
+ * Docs theme's member-tree shell.
+ *
+ * Drops the docs sidebar (which is hierarchical-doc navigation —
+ * useless on auth forms) and renders a narrow column under the
+ * masthead. Reuses `DocsHeader` directly so a masthead bump
+ * cascades to member pages — single source of truth for chrome.
+ *
+ * Skips the public `DocsShell`'s 3-column grid because the
+ * `<ShellWrap surface="member">` fallback chain only invokes
+ * `impl.members.shell` (this component); the public shell never
+ * wraps the member tree.
+ */
+declare function DocsMembersShell({ children }: {
+    children: ReactNode;
+}): react_jsx_runtime.JSX.Element;
+
+/**
+ * Phase F.9-B — docs 404.
+ *
+ * Tighter / less editorial than magazine's; suggests search +
+ * homepage as next steps.
+ */
+declare function DocsNotFound(): React.ReactElement;
+
+/**
+ * Phase F.9-B — `/search` route component.
+ *
+ * Reads `?q=` from searchParams, runs `searchCollections` (the
+ * full-text search API), and renders the hits. Empty query →
+ * empty results pane with hint copy. Stresses F.2's route
+ * dispatch with a non-collection-walk shape (search is
+ * cross-collection by design).
+ */
+declare function DocsSearch({ searchParams, }: NpRouteRenderProps): Promise<React.ReactElement>;
+
+/**
+ * Phase F.9-B — docs theme shell.
+ *
+ * Body grid: header on top, then a 3-column row of sidebar +
+ * main + (optional) TOC. The sidebar slot reads the docs
+ * collection hierarchy; main is the page render; TOC is left
+ * to the page template (it knows which headings the doc has).
+ */
+declare function DocsShell({ children }: NpThemeShellProps): React.ReactElement;
+
+/**
+ * Phase F.9-B — hierarchical sidebar.
+ *
+ * Walks the `docs` collection (declared as required in the
+ * manifest), builds a parent/order tree, renders nested nav.
+ * The current doc is highlighted via `data-current="true"`.
+ *
+ * The function reads `currentSlug` from a query param (when
+ * called as a route component) or from doc context. For F.9-B
+ * we keep it simple: the slot component fetches the request's
+ * URL via `headers()` and matches on `pathname.startsWith`.
+ */
+declare function DocsSidebar(): Promise<React.ReactElement>;
+
+/**
+ * Phase F.9-B — docs theme CSS.
+ *
+ * Scoped under `.np-docs-*` so theme swaps don't leave
+ * residue. Uses `var(--np-color-*)` tokens so admin
+ * settings → tokens still apply on top.
+ */
+declare const docsCss = "\n.np-docs-shell {\n  display: flex;\n  flex-direction: column;\n  min-height: 100vh;\n  background: var(--np-color-background);\n  color: var(--np-color-foreground);\n  font-family: var(--np-font-body, system-ui, sans-serif);\n}\n\n.np-docs-header {\n  position: sticky;\n  top: 0;\n  z-index: 50;\n  background: var(--np-color-background);\n  border-bottom: 1px solid var(--np-color-border);\n  backdrop-filter: blur(8px);\n}\n\n.np-docs-header-inner {\n  max-width: 1200px;\n  margin: 0 auto;\n  padding: 0.75rem 1.5rem;\n  display: grid;\n  grid-template-columns: auto 1fr auto;\n  gap: 1.5rem;\n  align-items: center;\n}\n\n.np-docs-brand {\n  display: flex;\n  align-items: baseline;\n  gap: 0.5rem;\n  font-weight: 600;\n  text-decoration: none;\n  color: var(--np-color-foreground);\n}\n\n.np-docs-brand-version {\n  font-size: 0.75rem;\n  font-family: ui-monospace, \"SF Mono\", Menlo, monospace;\n  color: var(--np-color-muted-foreground);\n  background: var(--np-color-muted);\n  padding: 0.125rem 0.375rem;\n  border-radius: 0.25rem;\n}\n\n.np-docs-search-form {\n  flex: 1;\n}\n\n.np-docs-search-input {\n  width: 100%;\n  padding: 0.4rem 0.75rem;\n  border: 1px solid var(--np-color-border);\n  border-radius: 0.375rem;\n  background: var(--np-color-card);\n  color: var(--np-color-foreground);\n  font-size: 0.875rem;\n}\n\n.np-docs-search-input:focus {\n  outline: 2px solid var(--np-color-primary);\n  outline-offset: -2px;\n  border-color: transparent;\n}\n\n.np-docs-nav {\n  display: flex;\n  align-items: center;\n  gap: 1rem;\n}\n\n.np-docs-primary-nav {\n  display: flex;\n  list-style: none;\n  margin: 0;\n  padding: 0;\n  gap: 1rem;\n}\n\n.np-docs-primary-nav a {\n  color: var(--np-color-muted-foreground);\n  text-decoration: none;\n  font-size: 0.875rem;\n}\n\n.np-docs-primary-nav a:hover {\n  color: var(--np-color-foreground);\n}\n\n.np-docs-github-link {\n  font-size: 0.875rem;\n  color: var(--np-color-muted-foreground);\n  text-decoration: none;\n}\n\n.np-docs-grid {\n  flex: 1;\n  display: grid;\n  grid-template-columns: 240px minmax(0, 1fr);\n  max-width: 1200px;\n  margin: 0 auto;\n  width: 100%;\n  gap: 2.5rem;\n  padding: 2rem 1.5rem;\n}\n\n@media (max-width: 768px) {\n  .np-docs-grid {\n    grid-template-columns: 1fr;\n  }\n  .np-docs-sidebar {\n    display: none;\n  }\n}\n\n.np-docs-sidebar {\n  position: sticky;\n  top: 4rem;\n  align-self: start;\n  max-height: calc(100vh - 5rem);\n  overflow-y: auto;\n}\n\n.np-docs-sidebar h2 {\n  font-size: 0.75rem;\n  text-transform: uppercase;\n  letter-spacing: 0.08em;\n  color: var(--np-color-muted-foreground);\n  margin: 0 0 0.75rem;\n}\n\n.np-docs-sidebar ul {\n  list-style: none;\n  padding: 0;\n  margin: 0;\n}\n\n.np-docs-sidebar li {\n  margin: 0.125rem 0;\n}\n\n.np-docs-sidebar a {\n  display: block;\n  padding: 0.25rem 0.5rem;\n  border-radius: 0.25rem;\n  color: var(--np-color-muted-foreground);\n  text-decoration: none;\n  font-size: 0.875rem;\n}\n\n.np-docs-sidebar a:hover {\n  background: var(--np-color-muted);\n  color: var(--np-color-foreground);\n}\n\n.np-docs-sidebar a[data-current=\"true\"] {\n  background: color-mix(in oklch, var(--np-color-primary) 12%, transparent);\n  color: var(--np-color-primary);\n  font-weight: 500;\n}\n\n.np-docs-sidebar ul ul {\n  margin-left: 0.75rem;\n  border-left: 1px solid var(--np-color-border);\n  padding-left: 0.5rem;\n}\n\n.np-docs-page {\n  max-width: 720px;\n}\n\n.np-docs-page h1 {\n  font-size: 2rem;\n  margin: 0 0 0.5rem;\n}\n\n.np-docs-prev-next {\n  display: grid;\n  grid-template-columns: 1fr 1fr;\n  gap: 1rem;\n  margin-top: 3rem;\n  padding-top: 1.5rem;\n  border-top: 1px solid var(--np-color-border);\n}\n\n.np-docs-prev-next a {\n  display: block;\n  padding: 0.75rem 1rem;\n  border: 1px solid var(--np-color-border);\n  border-radius: 0.5rem;\n  color: var(--np-color-foreground);\n  text-decoration: none;\n}\n\n.np-docs-prev-next a:hover {\n  border-color: var(--np-color-primary);\n}\n\n.np-docs-prev-next-label {\n  display: block;\n  font-size: 0.75rem;\n  color: var(--np-color-muted-foreground);\n  margin-bottom: 0.25rem;\n}\n\n/* M.* member surface \u2014 narrow auth-form column under the\n   masthead, no sidebar (the docs sidebar is hierarchical\n   doc nav, useless on auth forms). */\n.np-docs-members {\n  display: flex;\n  justify-content: center;\n  min-height: 60vh;\n  padding: 3rem 1.5rem;\n}\n.np-docs-members-column {\n  width: 100%;\n  max-width: 440px;\n}\n\n/* Member form token overrides \u2014 docs aesthetic: slightly\n   rounded corners, neutral palette, monospace label accent. */\n.np-docs .np-members-form {\n  --np-member-form-input-bg: var(--np-color-background);\n  --np-member-form-input-border: var(--np-color-border);\n  --np-member-form-input-border-focus: var(--np-color-primary);\n  --np-member-form-input-radius: 0.375rem;\n  --np-member-form-button-radius: 0.375rem;\n}\n.np-docs .np-members-form .np-form-label {\n  font-family: var(--np-font-mono, ui-monospace, monospace);\n  font-size: 0.8125rem;\n}\n";
+
+/**
+ * Phase F.9-B — doc page template.
+ *
+ * Renders the doc's title + body, plus a prev/next bar at the
+ * bottom that walks the same parent-ordered hierarchy the
+ * sidebar uses. Optional "Edit on GitHub" link is added when
+ * the operator set `settings.githubRepo`.
+ *
+ * Body rendering: this template assumes `doc.body` is a
+ * Lexical / blocks payload. For a real F.9-B we'd thread
+ * through `renderBlocks(doc.body, { ctx: blockCtx })` for the
+ * actual content; the placeholder JSON keeps the contract
+ * shape-correct without binding to a specific body shape that
+ * may differ across operator setups.
+ */
+declare function DocPageTemplate({ doc: rawDoc, }: NpTemplateRenderProps): Promise<React.ReactElement>;
+
+/**
+ * Phase F.9-B — operator-tunable docs settings.
+ *
+ * Stresses F.3's settings auto-form on a different axis from
+ * magazine: more URL inputs, a select/enum for sidebar
+ * orientation, and a documentation-flavored field set.
+ */
+declare const docsSettingsSchema: z.ZodObject<{
+    version: z.ZodDefault<z.ZodString>;
+    githubRepo: z.ZodOptional<z.ZodString>;
+    sidebarHeading: z.ZodDefault<z.ZodString>;
+    showTableOfContents: z.ZodDefault<z.ZodBoolean>;
+    searchPlaceholder: z.ZodDefault<z.ZodString>;
+}, z.core.$strip>;
+type DocsSettings = z.infer<typeof docsSettingsSchema>;
+
+/**
+ * `@nexpress/theme-docs` — documentation theme for NexPress.
+ *
+ * Stresses F.2 (search route + sidebar slot consuming
+ * hierarchy) and F.3 (settings: version, githubRepo,
+ * sidebarHeading, TOC toggle). Different contract axis from
+ * F.9-A's magazine — sidebar-driven layout, hierarchical doc
+ * collection, prev/next navigation.
+ */
+declare const docsTheme: _nexpress_theme.NpTheme;
+
+export { DocPageTemplate, DocsHeader, DocsMembersNotFound, DocsMembersShell, DocsNotFound, DocsSearch, type DocsSettings, DocsShell, DocsSidebar, docsCss, docsSettingsSchema, docsTheme };