zudoku 0.0.0-eff6f9b → 0.0.0-f3858d6

package/lib/zudoku.plugin-api-keys.js

@@ -1,13 +1,13 @@
 import { j as e } from "./jsx-runtime-B6kdoens.js";
-import { S as x, R as f } from "./SlotletProvider-DJMaOUDs.js";
-import { u as g, a as d, I as j, S as v, b as w, c as b, d as k, e as K, f as m } from "./Input-B1kkVL1R.js";
-import { a as N, L as u, O as I } from "./index-BG0g4WW0.js";
-import { u as h, a as E, b as S } from "./ZudokuContext-em1gHkIY.js";
-import { B as l, m as A } from "./index-BoXX7LeD.js";
-import { D as C } from "./DeveloperHint-FBb2uXJe.js";
+import { S as x, R as f } from "./SlotletProvider-BGEs7yyu.js";
+import { u as g, a as d, I as j, S as v, b as w, c as b, d as k, e as K, f as m } from "./Input-x-t53FyR.js";
+import { a as N, L as u, O as I } from "./index-SrtqdZ3j.js";
+import { b as h, c as E, d as S } from "./ZudokuContext-DSipF8sq.js";
+import { B as l, n as A } from "./index-Dssw7Gff.js";
+import { D as C } from "./DeveloperHint-CNyuFROc.js";
 import { RotateCwIcon as P, TrashIcon as D, EyeOffIcon as R, EyeIcon as q, CheckIcon as O, CopyIcon as z } from "lucide-react";
 import { useState as p } from "react";
-import { a as T } from "./Markdown-B4aR03g6.js";
+import { a as T } from "./Markdown-C-0TaxoY.js";
 function c(t, s) {
   if (t)
     return;

package/lib/{zudoku.plugin-custom-page.js → zudoku.plugin-custom-pages.js}

@@ -1,5 +1,5 @@
 import { j as m } from "./jsx-runtime-B6kdoens.js";
-import { P as o } from "./Markdown-B4aR03g6.js";
+import { P as o } from "./Markdown-C-0TaxoY.js";
 const l = (s) => ({
   getRoutes: () => s.map(({ path: e, element: t }) => ({
     path: e,
@@ -8,6 +8,6 @@ const l = (s) => ({
   }))
 });
 export {
-  l as customPagePlugin
+  l as customPagesPlugin
 };
-//# sourceMappingURL=zudoku.plugin-custom-page.js.map
+//# sourceMappingURL=zudoku.plugin-custom-pages.js.map

package/lib/zudoku.plugin-custom-pages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zudoku.plugin-custom-pages.js","sources":["../src/lib/plugins/custom-pages/index.tsx"],"sourcesContent":["import type { ReactNode } from \"react\";\nimport type { RouteObject } from \"react-router-dom\";\nimport { ProseClasses } from \"../../components/Markdown.js\";\nimport type { DevPortalPlugin, NavigationPlugin } from \"../../core/plugins.js\";\n\ntype CustomPagesConfig = Array<{\n  path: string;\n  element: ReactNode;\n}>;\n\nexport const customPagesPlugin = (\n  config: CustomPagesConfig,\n): DevPortalPlugin & NavigationPlugin => {\n  return {\n    getRoutes: (): RouteObject[] =>\n      config.map(({ path, element }) => ({\n        path,\n        // TODO: we should componentize prose pages\n        element: <div className={ProseClasses + \" max-w-full\"}>{element}</div>,\n      })),\n  };\n};\n"],"names":["customPagesPlugin","config","path","element","jsx","ProseClasses"],"mappings":";;AAUa,MAAAA,IAAoB,CAC/BC,OAEO;AAAA,EACL,WAAW,MACTA,EAAO,IAAI,CAAC,EAAE,MAAAC,GAAM,SAAAC,SAAe;AAAA,IACjC,MAAAD;AAAA;AAAA,IAEA,SAAUE,gBAAAA,EAAAA,IAAA,OAAA,EAAI,WAAWC,IAAe,eAAgB,UAAQF,GAAA;AAAA,EAAA,EAChE;AAAA;"}

package/lib/zudoku.plugin-markdown.js

@@ -1,32 +1,98 @@
-import { j as u } from "./jsx-runtime-B6kdoens.js";
-const x = (t, e, n) => Object.entries(t).flatMap(([a, p]) => {
-  let o = e.split("**")[0];
-  o = o.replace("/**", "/");
-  const c = new RegExp(`^${o}(.*).mdx?`), r = a.match(c), s = r == null ? void 0 : r.at(1);
-  return s ? {
-    path: s,
-    lazy: async () => {
-      const { MdxPage: i } = await import("./MdxPage-BcftTg5g.js"), { default: m, ...l } = await p();
-      return {
-        element: /* @__PURE__ */ u.jsx(
-          i,
-          {
-            mdxComponent: m,
-            ...l,
-            defaultOptions: n
+var d = Object.defineProperty;
+var m = (n, t, o) => t in n ? d(n, t, { enumerable: !0, configurable: !0, writable: !0, value: o }) : n[t] = o;
+var f = (n, t, o) => m(n, typeof t != "symbol" ? t + "" : t, o);
+import { j as P } from "./jsx-runtime-B6kdoens.js";
+import { f as u } from "./__vite-browser-external-BYRIRx8p.js";
+const x = "/pages/**/*.{md,mdx}", D = [".md", ".mdx"];
+class c {
+  constructor(t) {
+    f(this, "fileMap", /* @__PURE__ */ new Map());
+    this.config = t;
+  }
+  /**
+   * Gets the default docs config from the zudoku config
+   */
+  getDocsConfigs() {
+    return this.config.docs ? Array.isArray(this.config.docs) ? this.config.docs : [this.config.docs] : [{ files: x }];
+  }
+  /**
+   * Resolves the first matching file system path for a given docId
+   * @param docId - The docId to resolve
+   * @returns
+   */
+  resolveFilePath(t) {
+    const o = this.getDocsConfigs();
+    let s;
+    return o.forEach(({ files: i }) => {
+      if (s)
+        return;
+      const e = c.getRootDir(i);
+      for (const a of D) {
+        if (s)
+          return;
+        const r = u.join(e, `${t}${a}`);
+        u.existsSync(r) && (s = r);
+      }
+    }), s;
+  }
+  /**
+   * Gets the root directory from a files glob
+   */
+  static getRootDir(t) {
+    let o = t.split("**")[0];
+    if (!o)
+      throw new Error("Invalid files glob. Must have '**' in the path.");
+    return o = o.replace("/**", "/"), o;
+  }
+  /**
+   * Resolves the route path for a given file system path
+   * @param options - The options to resolve the route path
+   * @returns The string route path
+   */
+  static resolveRoutePath({
+    filesGlob: t,
+    fsPath: o
+  }) {
+    const s = this.getRootDir(t), i = new RegExp(`^${s}(.*).mdx?`), e = o.match(i);
+    return e == null ? void 0 : e.at(1);
+  }
+}
+const C = (n) => ({
+  getRoutes: () => {
+    const t = /* @__PURE__ */ new Map();
+    return n.forEach(
+      ({ fileImports: o, files: s, defaultOptions: i }) => Object.entries(o).flatMap(([e, a]) => {
+        const r = c.resolveRoutePath({
+          filesGlob: s,
+          fsPath: e
+        });
+        if (!r) return [];
+        if (t.has(r))
+          return console.warn(
+            `Duplicate route path found for ${r}. Skipping file at '${e}'.`
+          ), [];
+        const h = {
+          path: r,
+          lazy: async () => {
+            const { MdxPage: l } = await import("./MdxPage-C5I9c7R1.js"), { default: p, ...g } = await a();
+            return {
+              element: /* @__PURE__ */ P.jsx(
+                l,
+                {
+                  mdxComponent: p,
+                  ...g,
+                  defaultOptions: i
+                }
+              )
+            };
           }
-        )
-      };
-    }
-  } : [];
-}), f = ({
-  markdownFiles: t,
-  defaultOptions: e,
-  filesPath: n
-}) => ({
-  getRoutes: () => x(t, n, e)
+        };
+        t.set(r, h);
+      })
+    ), [...t.values()];
+  }
 });
 export {
-  f as markdownPlugin
+  C as markdownPlugin
 };
 //# sourceMappingURL=zudoku.plugin-markdown.js.map

package/lib/zudoku.plugin-markdown.js.map

@@ -1 +1 @@
-{"version":3,"file":"zudoku.plugin-markdown.js","sources":["../src/lib/plugins/markdown/generateRoutes.tsx","../src/lib/plugins/markdown/index.tsx"],"sourcesContent":["import { type RouteObject } from \"react-router-dom\";\n\nimport {\n  MarkdownPluginDefaultOptions,\n  MarkdownPluginOptions,\n} from \"./index.js\";\n\nexport const generateRoutes = (\n  markdownFiles: MarkdownPluginOptions[\"markdownFiles\"],\n  filesPath: string,\n  defaultOptions?: MarkdownPluginDefaultOptions,\n): RouteObject[] =>\n  Object.entries(markdownFiles).flatMap(([file, importPromise]) => {\n    let rootDir = filesPath.split(\"**\")[0];\n    rootDir = rootDir.replace(\"/**\", \"/\");\n    const re = new RegExp(`^${rootDir}(.*).mdx?`);\n    const match = file.match(re);\n    const fsPath = match?.at(1);\n\n    if (!fsPath) return [];\n\n    return {\n      path: fsPath,\n      lazy: async () => {\n        const { MdxPage } = await import(\"./MdxPage.js\");\n        const { default: Component, ...props } = await importPromise();\n        return {\n          element: (\n            <MdxPage\n              mdxComponent={Component}\n              {...props}\n              defaultOptions={defaultOptions}\n            />\n          ),\n        };\n      },\n    } satisfies RouteObject;\n  });\n","import type { Toc } from \"@stefanprobst/rehype-extract-toc\";\nimport type { MDXProps } from \"mdx/types.js\";\nimport type { DevPortalPlugin } from \"../../core/plugins.js\";\nimport { generateRoutes } from \"./generateRoutes.js\";\n\nexport type MarkdownPluginOptions = {\n  markdownFiles: Record<string, () => Promise<MDXImport>>;\n  defaultOptions?: MarkdownPluginDefaultOptions;\n  filesPath: string;\n};\nexport type MarkdownPluginDefaultOptions = Pick<\n  Frontmatter,\n  \"toc\" | \"disablePager\"\n>;\n\nexport type Frontmatter = {\n  title?: string;\n  description?: string;\n  category?: string;\n  toc?: boolean;\n  disablePager?: boolean;\n};\n\nexport type MDXImport = {\n  tableOfContents: Toc;\n  frontmatter: Frontmatter;\n  default: (props: MDXProps) => JSX.Element;\n};\n\nexport const markdownPlugin = ({\n  markdownFiles,\n  defaultOptions,\n  filesPath,\n}: MarkdownPluginOptions): DevPortalPlugin => ({\n  getRoutes: () => generateRoutes(markdownFiles, filesPath, defaultOptions),\n});\n"],"names":["generateRoutes","markdownFiles","filesPath","defaultOptions","file","importPromise","rootDir","re","match","fsPath","MdxPage","Component","props","jsx","markdownPlugin"],"mappings":";AAOO,MAAMA,IAAiB,CAC5BC,GACAC,GACAC,MAEA,OAAO,QAAQF,CAAa,EAAE,QAAQ,CAAC,CAACG,GAAMC,CAAa,MAAM;AAC/D,MAAIC,IAAUJ,EAAU,MAAM,IAAI,EAAE,CAAC;AAC3B,EAAAI,IAAAA,EAAQ,QAAQ,OAAO,GAAG;AACpC,QAAMC,IAAK,IAAI,OAAO,IAAID,CAAO,WAAW,GACtCE,IAAQJ,EAAK,MAAMG,CAAE,GACrBE,IAASD,KAAA,gBAAAA,EAAO,GAAG;AAErB,SAACC,IAEE;AAAA,IACL,MAAMA;AAAA,IACN,MAAM,YAAY;AAChB,YAAM,EAAE,SAAAC,EAAA,IAAY,MAAM,OAAO,uBAAc,GACzC,EAAE,SAASC,GAAW,GAAGC,EAAM,IAAI,MAAMP;AACxC,aAAA;AAAA,QACL,SACEQ,gBAAAA,EAAA;AAAA,UAACH;AAAA,UAAA;AAAA,YACC,cAAcC;AAAA,YACb,GAAGC;AAAA,YACJ,gBAAAT;AAAA,UAAA;AAAA,QACF;AAAA,MAAA;AAAA,IAGN;AAAA,EAAA,IAhBkB;AAkBtB,CAAC,GCRUW,IAAiB,CAAC;AAAA,EAC7B,eAAAb;AAAA,EACA,gBAAAE;AAAA,EACA,WAAAD;AACF,OAA+C;AAAA,EAC7C,WAAW,MAAMF,EAAeC,GAAeC,GAAWC,CAAc;AAC1E;"}
+{"version":3,"file":"zudoku.plugin-markdown.js","sources":["../src/lib/plugins/markdown/resolver.ts","../src/lib/plugins/markdown/index.tsx"],"sourcesContent":["import fs from \"fs\";\nimport path from \"path\";\nimport {\n  ZudokuConfig,\n  ZudokuDocsConfig,\n} from \"../../../config/validators/validate.js\";\n\nconst DEFAULT_DOCS_FILES = \"/pages/**/*.{md,mdx}\";\n\n// TODO: This should be dynamic based on the glob selector\nconst SUPPORTED_EXTENSIONS = [\".md\", \".mdx\"];\n\n/**\n * Utilities for resolving markdown file paths and routes\n */\nexport class DocResolver {\n  constructor(private config: ZudokuConfig) {}\n\n  fileMap = new Map<string, string>();\n\n  /**\n   * Gets the default docs config from the zudoku config\n   */\n  getDocsConfigs() {\n    const docsConfigs: ZudokuDocsConfig[] = this.config.docs\n      ? Array.isArray(this.config.docs)\n        ? this.config.docs\n        : [this.config.docs]\n      : [{ files: DEFAULT_DOCS_FILES }];\n\n    return docsConfigs;\n  }\n\n  /**\n   * Resolves the first matching file system path for a given docId\n   * @param docId - The docId to resolve\n   * @returns\n   */\n  resolveFilePath(docId: string) {\n    const docsConfigs = this.getDocsConfigs();\n    let fsPath: string | undefined;\n\n    docsConfigs.forEach(({ files: fileGlob }) => {\n      if (fsPath) {\n        return;\n      }\n      const rootDir = DocResolver.getRootDir(fileGlob);\n      for (const ext of SUPPORTED_EXTENSIONS) {\n        if (fsPath) {\n          return;\n        }\n        const checkPath = path.join(rootDir, `${docId}${ext}`);\n        if (fs.existsSync(checkPath)) {\n          fsPath = checkPath;\n        }\n      }\n    });\n\n    return fsPath;\n  }\n\n  /**\n   * Gets the root directory from a files glob\n   */\n  private static getRootDir(filesGlob: string) {\n    let rootDir = filesGlob.split(\"**\")[0];\n    if (!rootDir) {\n      throw new Error(\"Invalid files glob. Must have '**' in the path.\");\n    }\n    rootDir = rootDir.replace(\"/**\", \"/\");\n    return rootDir;\n  }\n\n  /**\n   * Resolves the route path for a given file system path\n   * @param options - The options to resolve the route path\n   * @returns The string route path\n   */\n  static resolveRoutePath({\n    filesGlob,\n    fsPath,\n  }: {\n    filesGlob: string;\n    fsPath: string;\n  }) {\n    const rootDir = this.getRootDir(filesGlob);\n    const re = new RegExp(`^${rootDir}(.*).mdx?`);\n    const match = fsPath.match(re);\n    const routePath = match?.at(1);\n    return routePath;\n  }\n}\n","import type { Toc } from \"@stefanprobst/rehype-extract-toc\";\nimport type { MDXProps } from \"mdx/types.js\";\nimport { RouteObject } from \"react-router-dom\";\nimport { ZudokuDocsConfig } from \"../../../config/validators/validate.js\";\nimport type { DevPortalPlugin } from \"../../core/plugins.js\";\nimport { DocResolver } from \"./resolver.js\";\n\nexport interface MarkdownPluginOptions extends ZudokuDocsConfig {\n  fileImports: Record<string, () => Promise<MDXImport>>;\n}\nexport type MarkdownPluginDefaultOptions = Pick<\n  Frontmatter,\n  \"toc\" | \"disablePager\"\n>;\n\nexport type Frontmatter = {\n  title?: string;\n  description?: string;\n  category?: string;\n  toc?: boolean;\n  disablePager?: boolean;\n};\n\nexport type MDXImport = {\n  tableOfContents: Toc;\n  frontmatter: Frontmatter;\n  default: (props: MDXProps) => JSX.Element;\n};\n\nexport const markdownPlugin = (\n  options: MarkdownPluginOptions[],\n): DevPortalPlugin => ({\n  getRoutes: () => {\n    const routeMap = new Map<string, RouteObject>();\n    options.forEach(({ fileImports, files, defaultOptions }) =>\n      Object.entries(fileImports).flatMap(([file, importPromise]) => {\n        const routePath = DocResolver.resolveRoutePath({\n          filesGlob: files,\n          fsPath: file,\n        });\n\n        if (!routePath) return [];\n\n        if (routeMap.has(routePath)) {\n          // eslint-disable-next-line no-console\n          console.warn(\n            `Duplicate route path found for ${routePath}. Skipping file at '${file}'.`,\n          );\n          return [];\n        }\n\n        const route: RouteObject = {\n          path: routePath,\n          lazy: async () => {\n            const { MdxPage } = await import(\"./MdxPage.js\");\n            const { default: Component, ...props } = await importPromise();\n            return {\n              element: (\n                <MdxPage\n                  mdxComponent={Component}\n                  {...props}\n                  defaultOptions={defaultOptions}\n                />\n              ),\n            };\n          },\n        };\n        routeMap.set(routePath, route);\n      }),\n    );\n    return [...routeMap.values()];\n  },\n});\n"],"names":["DEFAULT_DOCS_FILES","SUPPORTED_EXTENSIONS","DocResolver","config","__publicField","docId","docsConfigs","fsPath","fileGlob","rootDir","ext","checkPath","path","fs","filesGlob","re","match","markdownPlugin","options","routeMap","fileImports","files","defaultOptions","file","importPromise","routePath","route","MdxPage","Component","props","jsx"],"mappings":";;;;;AAOA,MAAMA,IAAqB,wBAGrBC,IAAuB,CAAC,OAAO,MAAM;AAKpC,MAAMC,EAAY;AAAA,EACvB,YAAoBC,GAAsB;AAE1C,IAAAC,EAAA,qCAAc;AAFM,SAAA,SAAAD;AAAA,EAAuB;AAAA;AAAA;AAAA;AAAA,EAO3C,iBAAiB;AAOR,WANiC,KAAK,OAAO,OAChD,MAAM,QAAQ,KAAK,OAAO,IAAI,IAC5B,KAAK,OAAO,OACZ,CAAC,KAAK,OAAO,IAAI,IACnB,CAAC,EAAE,OAAOH,EAAA,CAAoB;AAAA,EAGpC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,gBAAgBK,GAAe;AACvB,UAAAC,IAAc,KAAK;AACrB,QAAAC;AAEJ,WAAAD,EAAY,QAAQ,CAAC,EAAE,OAAOE,QAAe;AAC3C,UAAID;AACF;AAEI,YAAAE,IAAUP,EAAY,WAAWM,CAAQ;AAC/C,iBAAWE,KAAOT,GAAsB;AACtC,YAAIM;AACF;AAEI,cAAAI,IAAYC,EAAK,KAAKH,GAAS,GAAGJ,CAAK,GAAGK,CAAG,EAAE;AACjD,QAAAG,EAAG,WAAWF,CAAS,MAChBJ,IAAAI;AAAA,MAEb;AAAA,IAAA,CACD,GAEMJ;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKA,OAAe,WAAWO,GAAmB;AAC3C,QAAIL,IAAUK,EAAU,MAAM,IAAI,EAAE,CAAC;AACrC,QAAI,CAACL;AACG,YAAA,IAAI,MAAM,iDAAiD;AAEzD,WAAAA,IAAAA,EAAQ,QAAQ,OAAO,GAAG,GAC7BA;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,OAAO,iBAAiB;AAAA,IACtB,WAAAK;AAAA,IACA,QAAAP;AAAA,EAAA,GAIC;AACK,UAAAE,IAAU,KAAK,WAAWK,CAAS,GACnCC,IAAK,IAAI,OAAO,IAAIN,CAAO,WAAW,GACtCO,IAAQT,EAAO,MAAMQ,CAAE;AAEtB,WADWC,KAAA,gBAAAA,EAAO,GAAG;AAAA,EAE9B;AACF;AC9Da,MAAAC,IAAiB,CAC5BC,OACqB;AAAA,EACrB,WAAW,MAAM;AACT,UAAAC,wBAAe;AACb,WAAAD,EAAA;AAAA,MAAQ,CAAC,EAAE,aAAAE,GAAa,OAAAC,GAAO,gBAAAC,QACrC,OAAO,QAAQF,CAAW,EAAE,QAAQ,CAAC,CAACG,GAAMC,CAAa,MAAM;AACvD,cAAAC,IAAYvB,EAAY,iBAAiB;AAAA,UAC7C,WAAWmB;AAAA,UACX,QAAQE;AAAA,QAAA,CACT;AAEG,YAAA,CAACE,EAAW,QAAO;AAEnB,YAAAN,EAAS,IAAIM,CAAS;AAEhB,yBAAA;AAAA,YACN,kCAAkCA,CAAS,uBAAuBF,CAAI;AAAA,UAAA,GAEjE;AAGT,cAAMG,IAAqB;AAAA,UACzB,MAAMD;AAAA,UACN,MAAM,YAAY;AAChB,kBAAM,EAAE,SAAAE,EAAA,IAAY,MAAM,OAAO,uBAAc,GACzC,EAAE,SAASC,GAAW,GAAGC,EAAM,IAAI,MAAML;AACxC,mBAAA;AAAA,cACL,SACEM,gBAAAA,EAAA;AAAA,gBAACH;AAAA,gBAAA;AAAA,kBACC,cAAcC;AAAA,kBACb,GAAGC;AAAA,kBACJ,gBAAAP;AAAA,gBAAA;AAAA,cACF;AAAA,YAAA;AAAA,UAGN;AAAA,QAAA;AAEO,QAAAH,EAAA,IAAIM,GAAWC,CAAK;AAAA,MAAA,CAC9B;AAAA,IAAA,GAEI,CAAC,GAAGP,EAAS,OAAA,CAAQ;AAAA,EAC9B;AACF;"}

package/lib/zudoku.plugin-openapi.js

@@ -1,14 +1,14 @@
 import "./jsx-runtime-B6kdoens.js";
-import { o as s } from "./index-DIkaYL-l.js";
-import "./urql-YhcsXYy8.js";
-import "./ZudokuContext-em1gHkIY.js";
+import { o as s } from "./index-BIl-R3aH.js";
+import "./ZudokuContext-DSipF8sq.js";
 import "lucide-react";
 import "zudoku/openapi-worker";
-import "./index-BoXX7LeD.js";
-import "./ErrorPage-knunPbKI.js";
-import "./Markdown-B4aR03g6.js";
-import "./router-D2p7Olpn.js";
-import "./index-BG0g4WW0.js";
+import "./index-Dssw7Gff.js";
+import "./ErrorPage-CUz-Zzmx.js";
+import "./Markdown-C-0TaxoY.js";
+import "./urql-core-KJnLL26g.js";
+import "./router-Oe6YmY6B.js";
+import "./index-SrtqdZ3j.js";
 export {
   s as openApiPlugin
 };

package/lib/zudoku.plugin-redirect.js

@@ -1,4 +1,4 @@
-import { r as o } from "./router-D2p7Olpn.js";
+import { r as o } from "./router-Oe6YmY6B.js";
 const a = (r) => ({
   getRoutes: () => r.redirects.map(({ from: e, to: t }) => ({
     path: e,

package/package.json

@@ -1,7 +1,16 @@
 {
   "name": "zudoku",
-  "version": "0.0.0-eff6f9b",
+  "version": "0.0.0-f3858d6",
   "type": "module",
+  "homepage": "https://zudoku.dev",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/zuplo/zudoku.git"
+  },
+  "bugs": {
+    "url": "https://github.com/zuplo/zudoku/issues"
+  },
+  "description": "Framework for building high quality, interactive API documentation.",
   "files": [
     "dist",
     "lib",
@@ -52,9 +61,9 @@
       "import": "./lib/zudoku.plugin-redirect.js",
       "types": "./dist/lib/plugins/redirect/index.d.ts"
     },
-    "./plugins/custom-page": {
-      "import": "./lib/zudoku.plugin-custom-page.js",
-      "types": "./dist/lib/plugins/custom-page/index.d.ts"
+    "./plugins/custom-pages": {
+      "import": "./lib/zudoku.plugin-custom-pages.js",
+      "types": "./dist/lib/plugins/custom-pages/index.d.ts"
     },
     "./plugins/search-inkeep": {
       "import": "./lib/zudoku.plugin-search-inkeep.js",
@@ -89,53 +98,58 @@
     }
   },
   "dependencies": {
-    "@envelop/core": "5.0.1",
+    "@envelop/core": "5.0.2",
     "@graphql-typed-document-node/core": "3.2.0",
     "@hiogawa/vite-plugin-ssr-css": "0.0.1",
     "@lekoarts/rehype-meta-as-attributes": "3.0.1",
     "@mdx-js/react": "3.0.1",
     "@mdx-js/rollup": "3.0.1",
-    "@monaco-editor/react": "^4.6.0",
     "@pothos/core": "3.41.0",
-    "@radix-ui/react-collapsible": "1.1.0",
-    "@radix-ui/react-dropdown-menu": "^2.1.1",
-    "@radix-ui/react-select": "2.1.1",
-    "@radix-ui/react-visually-hidden": "1.1.0",
-    "@sentry/node": "8.11.0",
+    "@radix-ui/react-collapsible": "1.1.1",
+    "@radix-ui/react-dialog": "1.1.2",
+    "@radix-ui/react-dropdown-menu": "2.1.2",
+    "@radix-ui/react-select": "2.1.2",
+    "@radix-ui/react-slot": "1.1.0",
+    "@radix-ui/react-tabs": "1.1.1",
+    "@radix-ui/react-visually-hidden": "1",
+    "@sentry/node": "8.34.0",
+    "@sindresorhus/slugify": "2.2.1",
     "@stefanprobst/rehype-extract-toc": "2.2.0",
-    "@tailwindcss/typography": "0.5.13",
-    "@tanstack/react-query": "5.50.1",
+    "@tailwindcss/typography": "0.5.15",
+    "@tanstack/react-query": "5.59.13",
+    "@types/react": "18.3.11",
+    "@types/react-dom": "18.3.1",
     "@vitejs/plugin-react": "4.3.1",
+    "@zudoku/httpsnippet": "10.0.9",
     "@zudoku/react-helmet-async": "2.0.4",
-    "autoprefixer": "10.4.19",
-    "chokidar": "^3.6.0",
+    "autoprefixer": "10.4.20",
+    "chokidar": "3.6.0",
     "class-variance-authority": "0.7.0",
+    "clsx": "2.1.1",
     "dotenv": "16.4.5",
-    "express": "4.19.2",
-    "glob": "^11.0.0",
+    "express": "4.21.1",
+    "glob": "11.0.0",
     "graphql": "16.9.0",
     "graphql-type-json": "0.3.2",
-    "graphql-yoga": "5.2.0",
-    "gray-matter": "^4.0.3",
-    "http-terminator": "^3.2.0",
-    "loglevel": "^1.9.1",
-    "lru-cache": "11.0.0",
-    "lucide-react": "0.438.0",
-    "mdx": "0.3.1",
+    "graphql-yoga": "5.7.0",
+    "gray-matter": "4.0.3",
+    "http-terminator": "3.2.0",
+    "loglevel": "1.9.2",
+    "lru-cache": "11.0.1",
+    "lucide-react": "0.452.0",
+    "oauth4webapi": "2.17.0",
     "object-hash": "3.0.0",
     "openapi-types": "12.1.3",
-    "picocolors": "^1.0.1",
-    "postcss": "8.4.39",
-    "posthog-node": "^4.1.1",
-    "prism-react-renderer": "2.3.1",
+    "picocolors": "1.1.0",
+    "postcss": "8.4.47",
+    "posthog-node": "4.2.1",
+    "prism-react-renderer": "2.4.0",
     "prismjs": "1.29.0",
-    "react": "18.3.1",
-    "react-dom": "18.3.1",
-    "react-error-boundary": "^4.0.13",
-    "react-hook-form": "^7.52.1",
+    "react-error-boundary": "4.0.13",
+    "react-hook-form": "7.53.0",
     "react-is": "18.3.1",
     "react-markdown": "9.0.1",
-    "react-router-dom": "6.25.1",
+    "react-router-dom": "6.27.0",
     "rehype-raw": "7.0.0",
     "rehype-slug": "6.0.0",
     "remark-comment": "1.0.0",
@@ -144,54 +158,42 @@
     "remark-frontmatter": "5.0.0",
     "remark-gfm": "4.0.0",
     "remark-mdx-frontmatter": "5.0.0",
-    "rollup": "^4.21.2",
-    "semver": "7.6.2",
-    "sitemap": "^8.0.0",
-    "slugify": "1.6.6",
+    "rollup": "4.24.0",
+    "semver": "7.6.3",
+    "sitemap": "8.0.0",
     "strip-ansi": "7.1.0",
-    "tailwind-merge": "2.5.2",
-    "tailwindcss": "3.4.4",
-    "tsx": "4.19.0",
-    "ulidx": "^2.3.0",
+    "tailwind-merge": "2.5.4",
+    "tailwindcss": "3.4.13",
+    "tsx": "4.19.1",
+    "ulidx": "2.4.1",
     "unist-util-visit": "5.0.0",
     "urql": "4.1.0",
-    "vaul": "0.9.2",
-    "vite": "5.3.6",
-    "yaml": "2.5.0",
+    "vaul": "1.1.0",
+    "vite": "5.4.9",
+    "yaml": "2.6.0",
     "yargs": "17.7.2",
     "zod": "3.23.8",
-    "zod-validation-error": "3.3.1",
-    "zustand": "4.5.5"
+    "zod-validation-error": "3.4.0",
+    "zustand": "5.0.0"
   },
   "devDependencies": {
-    "@radix-ui/react-dialog": "1.1.1",
-    "@radix-ui/react-slot": "1.1.0",
-    "@radix-ui/react-tabs": "1.1.0",
-    "@types/express": "^4.17.21",
-    "@types/har-format": "^1.2.15",
+    "@types/express": "4.17.21",
+    "@types/har-format": "1.2.15",
     "@types/json-schema": "7.0.15",
     "@types/mdx": "2.0.13",
-    "@types/node": "20.12.10",
-    "@types/object-hash": "^3.0.6",
-    "@types/react": "18.3.3",
-    "@types/react-dom": "18.3.0",
+    "@types/node": "20.16.11",
+    "@types/object-hash": "3.0.6",
     "@types/react-is": "18.3.0",
-    "@types/rollup": "^0.54.0",
-    "@types/semver": "^7.5.8",
-    "@types/yargs": "^17.0.32",
-    "@zudoku/httpsnippet": "10.0.9",
-    "clsx": "2.1.1",
-    "oauth4webapi": "2.11.1",
-    "prism-react-renderer": "2.3.1",
-    "prismjs": "1.29.0",
-    "react-markdown": "9.0.1",
-    "react-router-dom": "6.25.1",
-    "rollup-plugin-visualizer": "^5.12.0",
-    "typescript": "5.5.3"
+    "@types/semver": "7.5.8",
+    "@types/yargs": "17.0.33",
+    "rollup-plugin-visualizer": "5.12.0",
+    "react": "18.3.1",
+    "react-dom": "18.3.1",
+    "typescript": "5.6.3"
   },
   "peerDependencies": {
-    "react": ">18.0.0",
-    "react-dom": ">18.0.0"
+    "react": ">=18",
+    "react-dom": ">=18"
   },
   "optionalDependencies": {
     "@clerk/clerk-js": "5.11.0",

package/src/app/entry.client.tsx

@@ -20,8 +20,10 @@ if (root.childElementCount > 0) {
 }
 
 async function hydrateLazyRoutes(routes: RouteObject[]) {
-  const path = window.location.pathname.slice(config.basePath?.length ?? 0);
-  const lazyMatches = matchRoutes(routes, path)?.filter((m) => m.route.lazy);
+  const path = window.location.pathname;
+  const lazyMatches = matchRoutes(routes, path, config.basePath)?.filter(
+    (m) => m.route.lazy,
+  );
 
   if (lazyMatches?.length) {
     await Promise.all(

package/src/app/entry.server.tsx

@@ -96,6 +96,10 @@ export const render = async ({
 
         const [htmlStart, htmlEnd] = template.split("<!--app-html-->");
 
+        if (!htmlStart) {
+          throw new Error("No <!--app-html--> found in template");
+        }
+
         response.write(
           htmlStart.replace(
             "<!--app-helmet-->",

package/src/app/main.css

@@ -103,6 +103,10 @@
     @apply h-full overscroll-none;
   }
 
+  details summary {
+    @apply cursor-pointer;
+  }
+
   #root {
     @apply min-h-screen w-full;
   }

package/src/app/main.tsx

@@ -1,19 +1,17 @@
-import { redirect, type RouteObject } from "react-router-dom";
+import { type RouteObject } from "react-router-dom";
 import { configuredApiKeysPlugin } from "virtual:zudoku-api-keys-plugin";
 import { configuredApiPlugins } from "virtual:zudoku-api-plugins";
 import { configuredAuthProvider } from "virtual:zudoku-auth";
+import { configuredCustomPagesPlugin } from "virtual:zudoku-custom-pages-plugin";
 import { configuredDocsPlugins } from "virtual:zudoku-docs-plugins";
 import { configuredRedirectPlugin } from "virtual:zudoku-redirect-plugin";
 import { configuredSidebar } from "virtual:zudoku-sidebar";
 import "virtual:zudoku-theme.css";
 import { DevPortal, Layout, RouterError } from "zudoku/components";
 import { isNavigationPlugin } from "zudoku/internal";
-import { customPagePlugin } from "zudoku/plugins/custom-page";
 import { inkeepSearchPlugin } from "zudoku/plugins/search-inkeep";
 import type { ZudokuConfig } from "../config/config.js";
-import { traverseSidebar } from "../lib/components/navigation/utils.js";
 import type { ZudokuContextOptions } from "../lib/core/DevPortalContext.js";
-import { joinPath } from "../lib/util/joinPath.js";
 
 export const convertZudokuConfigToOptions = (
   config: ZudokuConfig,
@@ -42,7 +40,7 @@ export const convertZudokuConfigToOptions = (
         },
       },
     },
-    slotlets: config.slotlets,
+    slotlets: config.UNSAFE_slotlets,
     metadata: {
       favicon: "https://cdn.zudoku.dev/logos/favicon.svg",
       title: "%s - Zudoku",
@@ -60,7 +58,7 @@ export const convertZudokuConfigToOptions = (
       ...configuredApiPlugins,
       ...(configuredRedirectPlugin ? [configuredRedirectPlugin] : []),
       ...(configuredApiKeysPlugin ? [configuredApiKeysPlugin] : []),
-      ...(config.customPages ? [customPagePlugin(config.customPages)] : []),
+      ...(configuredCustomPagesPlugin ? [configuredCustomPagesPlugin] : []),
       ...(configuredAuthProvider?.getAuthenticationPlugin
         ? [configuredAuthProvider.getAuthenticationPlugin()]
         : []),
@@ -69,9 +67,7 @@ export const convertZudokuConfigToOptions = (
   };
 };
 
-export const getRoutesByConfig = (config: ZudokuConfig): RouteObject[] => {
-  const options = convertZudokuConfigToOptions(config);
-
+export const getRoutesByOptions = (options: ZudokuContextOptions) => {
   const allPlugins = [
     ...(options.plugins ? options.plugins : []),
     ...(options.authentication?.getAuthenticationPlugin
@@ -79,27 +75,8 @@ export const getRoutesByConfig = (config: ZudokuConfig): RouteObject[] => {
       : []),
   ];
 
-  const topNavRedirects =
-    options.topNavigation?.flatMap((topNavItem) => {
-      if (!options.sidebars?.[topNavItem.id]) return [];
-
-      const first =
-        topNavItem.default ??
-        traverseSidebar(options.sidebars[topNavItem.id], (item) => {
-          if (item.type === "doc") return joinPath(topNavItem.id, item.id);
-        });
-
-      if (!first) return [];
-
-      return {
-        path: topNavItem.id,
-        loader: () => redirect(joinPath(first)),
-      } satisfies RouteObject;
-    }) ?? [];
-
   const routes = allPlugins
     .flatMap((plugin) => (isNavigationPlugin(plugin) ? plugin.getRoutes() : []))
-    .concat(topNavRedirects)
     .concat({
       path: "*",
       loader: () => {
@@ -107,6 +84,13 @@ export const getRoutesByConfig = (config: ZudokuConfig): RouteObject[] => {
       },
     });
 
+  return routes;
+};
+
+export const getRoutesByConfig = (config: ZudokuConfig): RouteObject[] => {
+  const options = convertZudokuConfigToOptions(config);
+  const routes = getRoutesByOptions(options);
+
   return [
     {
       element: (

package/src/app/standalone.tsx

@@ -16,7 +16,7 @@ if (!root) {
 themeToggle();
 
 const apiUrl = root.getAttribute("data-api-url");
-const pageTitle = document.getElementsByTagName("title")[0].innerText;
+const pageTitle = document.getElementsByTagName("title")[0]!.innerText;
 const logoUrl = root.getAttribute("data-logo-url");
 
 // IMPORTANT: This component must not contain tailwind classes

package/src/lib/authentication/state.ts

@@ -1,4 +1,5 @@
 import { create } from "zustand";
+import { persist } from "zustand/middleware";
 
 export const useAuthState = create<AuthState>(() => ({
   isPending: false,
@@ -19,3 +20,19 @@ export interface UserProfile {
   pictureUrl: string | undefined;
   [key: string]: string | boolean | undefined;
 }
+
+interface SelectedServerState {
+  selectedServer?: string;
+  setSelectedServer: (newServer: string) => void;
+}
+
+export const useSelectedServerStore = create<SelectedServerState>()(
+  persist(
+    (set) => ({
+      selectedServer: undefined,
+      setSelectedServer: (newServer: string) =>
+        set({ selectedServer: newServer }),
+    }),
+    { name: "zudoku-selected-server" },
+  ),
+);

package/src/lib/components/Banner.tsx

@@ -9,7 +9,7 @@ const COLOR_MAP = {
   tip: "bg-green-600",
   caution: "bg-orange-500",
   danger: "bg-rose-500",
-};
+} as const;
 
 export const Banner = () => {
   const { page } = useZudoku();
@@ -19,12 +19,22 @@ export const Banner = () => {
     return <style>{`:root { --banner-height: 0px; }`}</style>;
   }
 
+  const mappedColor =
+    page.banner.color && page.banner.color in COLOR_MAP
+      ? COLOR_MAP[page.banner.color as keyof typeof COLOR_MAP]
+      : !page.banner.color
+        ? "bg-primary"
+        : undefined;
+
+  const style = !mappedColor ? { backgroundColor: page.banner.color } : {};
+
   return (
     <div
       className={cn(
         "relative text-primary-foreground text-sm font-medium px-4 py-2 flex gap-2 items-center",
-        page.banner.color ? COLOR_MAP[page.banner.color] : "bg-primary",
+        mappedColor,
       )}
+      style={style}
     >
       <div className="w-full">{page.banner.message}</div>
       {page.banner.dismissible && (

package/src/lib/components/ErrorPage.tsx

@@ -1,5 +1,4 @@
 import type { ReactNode } from "react";
-import { Link } from "react-router-dom";
 import { CategoryHeading } from "./CategoryHeading.js";
 import { Heading } from "./Heading.js";
 import { ProseClasses } from "./Markdown.js";
@@ -22,7 +21,6 @@ export const ErrorPage = ({
         </Heading>
       )}
       <p>{message}</p>
-      <Link to="/">Go back home</Link>
     </div>
   );
 };