@lukoweb/apitogo 0.1.17 → 0.1.19

package/dist/cli/cli.js

@@ -131,7 +131,7 @@ import { stat } from "node:fs/promises";
 var fileExists;
 var init_file_exists = __esm({
   "src/config/file-exists.ts"() {
-    fileExists = (path33) => stat(path33).then(() => true).catch(() => false);
+    fileExists = (path35) => stat(path35).then(() => true).catch(() => false);
   }
 });
 
@@ -208,7 +208,7 @@ var init_shiki = __esm({
       warnedLanguages.add(lang);
       console.warn(
         `Language "${lang}" is not loaded for syntax highlighting. Add it to \`syntaxHighlighting.languages\` in your config. Falling back to plain text.
-See https://zudoku.dev/docs/markdown/code-blocks#configuration`
+See https://docs.apitogo.com/docs/markdown/code-blocks#configuration`
       );
     };
     parseMetaString = (str) => {
@@ -3590,7 +3590,7 @@ __export(llms_exports, {
   generateLlmsTxtFiles: () => generateLlmsTxtFiles
 });
 import { writeFile as writeFile4 } from "node:fs/promises";
-import path20 from "node:path";
+import path22 from "node:path";
 import colors6 from "picocolors";
 async function generateLlmsTxtFiles({
   markdownFileInfos,
@@ -3625,7 +3625,7 @@ async function generateLlmsTxtFiles({
       }
     }
     const llmsTxt2 = llmsTxtParts.join("\n");
-    await writeFile4(path20.join(baseOutputDir, "llms.txt"), llmsTxt2, "utf-8");
+    await writeFile4(path22.join(baseOutputDir, "llms.txt"), llmsTxt2, "utf-8");
     if (process.env.APITOGO_JSON_ONLY !== "1") {
       console.log(colors6.blue("\u2713 generated llms.txt"));
     }
@@ -3653,7 +3653,7 @@ ${info.content}
     }
     const llmsFull = llmsFullParts.join("\n");
     await writeFile4(
-      path20.join(baseOutputDir, "llms-full.txt"),
+      path22.join(baseOutputDir, "llms-full.txt"),
       llmsFull,
       "utf-8"
     );
@@ -3674,11 +3674,11 @@ import { hideBin } from "yargs/helpers";
 import yargs from "yargs/yargs";
 
 // src/cli/build/handler.ts
-import path24 from "node:path";
+import path26 from "node:path";
 
 // src/vite/build.ts
 import { mkdir as mkdir5, readFile as readFile3, rename, rm as rm2, writeFile as writeFile5 } from "node:fs/promises";
-import path22 from "node:path";
+import path24 from "node:path";
 import { build as esbuild } from "esbuild";
 import { build as viteBuild, mergeConfig as mergeConfig3 } from "vite";
 
@@ -3811,7 +3811,7 @@ init_invariant();
 init_joinUrl();
 
 // src/vite/config.ts
-import path17 from "node:path";
+import path19 from "node:path";
 import dotenv from "dotenv";
 import colors4 from "picocolors";
 import {
@@ -3822,7 +3822,7 @@ import {
 // package.json
 var package_default = {
   name: "@lukoweb/apitogo",
-  version: "0.1.17",
+  version: "0.1.19",
   type: "module",
   sideEffects: [
     "**/*.css",
@@ -4533,14 +4533,14 @@ var flattenAllOf = (schema2) => {
 };
 
 // src/lib/util/traverse.ts
-var traverse = (specification, transform, path33 = []) => {
-  const transformed = transform(specification, path33);
+var traverse = (specification, transform, path35 = []) => {
+  const transformed = transform(specification, path35);
   if (typeof transformed !== "object" || transformed === null) {
     return transformed;
   }
   const result = Array.isArray(transformed) ? [] : {};
   for (const [key, value] of Object.entries(transformed)) {
-    const currentPath = [...path33, key];
+    const currentPath = [...path35, key];
     if (Array.isArray(value)) {
       result[key] = value.map(
         (item, index) => typeof item === "object" && item != null ? traverse(item, transform, [...currentPath, index.toString()]) : item
@@ -4568,9 +4568,9 @@ var resolveLocalRef = (schema2, ref) => {
   if (schemaCache?.has(ref)) {
     return schemaCache.get(ref);
   }
-  const path33 = ref.split("/").slice(1);
+  const path35 = ref.split("/").slice(1);
   let current = schema2;
-  for (const segment of path33) {
+  for (const segment of path35) {
     if (!current || typeof current !== "object") {
       current = null;
     }
@@ -4589,7 +4589,7 @@ var dereference = async (schema2, resolvers = []) => {
   }
   const cloned = structuredClone(schema2);
   const visited = /* @__PURE__ */ new Set();
-  const resolve = async (current, path33) => {
+  const resolve = async (current, path35) => {
     if (isIndexableObject(current)) {
       if (visited.has(current)) {
         return CIRCULAR_REF;
@@ -4597,7 +4597,7 @@ var dereference = async (schema2, resolvers = []) => {
       visited.add(current);
       if (Array.isArray(current)) {
         for (let index = 0; index < current.length; index++) {
-          current[index] = await resolve(current[index], `${path33}/${index}`);
+          current[index] = await resolve(current[index], `${path35}/${index}`);
         }
       } else {
         if ("$ref" in current && typeof current.$ref === "string") {
@@ -4608,13 +4608,13 @@ var dereference = async (schema2, resolvers = []) => {
           for (const resolver of resolvers) {
             const resolved = await resolver($ref);
             if (resolved) {
-              result2 = await resolve(resolved, path33);
+              result2 = await resolve(resolved, path35);
               break;
             }
           }
           if (result2 === void 0) {
             const resolved = await resolveLocalRef(cloned, $ref);
-            result2 = await resolve(resolved, path33);
+            result2 = await resolve(resolved, path35);
           }
           if (hasSiblings) {
             if (result2 === CIRCULAR_REF) {
@@ -4627,7 +4627,7 @@ var dereference = async (schema2, resolvers = []) => {
           return result2;
         }
         for (const key in current) {
-          current[key] = await resolve(current[key], `${path33}/${key}`);
+          current[key] = await resolve(current[key], `${path35}/${key}`);
         }
       }
       visited.delete(current);
@@ -4666,9 +4666,9 @@ var upgradeSchema = (schema2) => {
     }
     return sub;
   });
-  schema2 = traverse(schema2, (sub, path33) => {
+  schema2 = traverse(schema2, (sub, path35) => {
     if (sub.example !== void 0) {
-      if (isSchemaPath(path33 ?? [])) {
+      if (isSchemaPath(path35 ?? [])) {
         sub.examples = [sub.example];
       } else {
         sub.examples = {
@@ -4681,11 +4681,11 @@ var upgradeSchema = (schema2) => {
     }
     return sub;
   });
-  schema2 = traverse(schema2, (schema3, path33) => {
+  schema2 = traverse(schema2, (schema3, path35) => {
     if (schema3.type === "object" && schema3.properties !== void 0) {
-      const parentPath = path33?.slice(0, -1);
+      const parentPath = path35?.slice(0, -1);
       const isMultipart = parentPath?.some((segment, index) => {
-        return segment === "content" && path33?.[index + 1] === "multipart/form-data";
+        return segment === "content" && path35?.[index + 1] === "multipart/form-data";
       });
       if (isMultipart) {
         const entries = Object.entries(schema3.properties);
@@ -4699,8 +4699,8 @@ var upgradeSchema = (schema2) => {
     }
     return schema3;
   });
-  schema2 = traverse(schema2, (schema3, path33) => {
-    if (path33?.includes("content") && path33.includes("application/octet-stream")) {
+  schema2 = traverse(schema2, (schema3, path35) => {
+    if (path35?.includes("content") && path35.includes("application/octet-stream")) {
       return {};
     }
     if (schema3.type === "string" && schema3.format === "binary") {
@@ -4726,11 +4726,11 @@ var upgradeSchema = (schema2) => {
     }
     return sub;
   });
-  schema2 = traverse(schema2, (schema3, path33) => {
+  schema2 = traverse(schema2, (schema3, path35) => {
     if (schema3.type === "string" && schema3.format === "byte") {
-      const parentPath = path33?.slice(0, -1);
+      const parentPath = path35?.slice(0, -1);
       const contentMediaType = parentPath?.find(
-        (_, index) => path33?.[index - 1] === "content"
+        (_, index) => path35?.[index - 1] === "content"
       );
       return {
         type: "string",
@@ -4742,7 +4742,7 @@ var upgradeSchema = (schema2) => {
   });
   return schema2;
 };
-function isSchemaPath(path33) {
+function isSchemaPath(path35) {
   const schemaLocations = [
     ["components", "schemas"],
     "properties",
@@ -4755,10 +4755,10 @@ function isSchemaPath(path33) {
   ];
   return schemaLocations.some((location) => {
     if (Array.isArray(location)) {
-      return location.every((segment, index) => path33[index] === segment);
+      return location.every((segment, index) => path35[index] === segment);
     }
-    return path33.includes(location);
-  }) || path33.includes("schema") || path33.some((segment) => segment.endsWith("Schema"));
+    return path35.includes(location);
+  }) || path35.includes("schema") || path35.some((segment) => segment.endsWith("Schema"));
 }
 
 // src/lib/oas/parser/index.ts
@@ -4840,13 +4840,13 @@ var OPENAPI_PROPS = /* @__PURE__ */ new Set([
   "anyOf",
   "oneOf"
 ]);
-var handleCircularRefs = (obj, currentPath = /* @__PURE__ */ new WeakSet(), refs = /* @__PURE__ */ new WeakMap(), path33 = [], currentRefPaths = /* @__PURE__ */ new Set()) => {
+var handleCircularRefs = (obj, currentPath = /* @__PURE__ */ new WeakSet(), refs = /* @__PURE__ */ new WeakMap(), path35 = [], currentRefPaths = /* @__PURE__ */ new Set()) => {
   if (obj === null || typeof obj !== "object") return obj;
   const refPath = obj.__$ref;
   const isCircular = currentPath.has(obj) || typeof refPath === "string" && currentRefPaths.has(refPath);
   if (isCircular) {
     if (typeof refPath === "string") return SCHEMA_REF_PREFIX + refPath;
-    const circularProp = path33.find((p) => !OPENAPI_PROPS.has(p)) || path33[0];
+    const circularProp = path35.find((p) => !OPENAPI_PROPS.has(p)) || path35[0];
     return [CIRCULAR_REF, circularProp].filter(Boolean).join(":");
   }
   if (refs.has(obj)) return refs.get(obj);
@@ -4856,7 +4856,7 @@ var handleCircularRefs = (obj, currentPath = /* @__PURE__ */ new WeakSet(), refs
     value,
     currentPath,
     refs,
-    [...path33, key],
+    [...path35, key],
     currentRefPaths
   );
   const result = Array.isArray(obj) ? obj.map((item, i) => recurse(item, i.toString())) : Object.fromEntries(
@@ -4891,7 +4891,7 @@ var resolveExtensions = (obj) => Object.fromEntries(
 var getAllTags = (schema2) => {
   const rootTags = schema2.tags ?? [];
   const operations = Object.values(schema2.paths ?? {}).flatMap(
-    (path33) => HttpMethods.map((k) => path33?.[k]).filter((op) => op != null)
+    (path35) => HttpMethods.map((k) => path35?.[k]).filter((op) => op != null)
   );
   const operationTags = new Set(operations.flatMap((op) => op.tags ?? []));
   const hasUntaggedOperations = operations.some(
@@ -4946,7 +4946,7 @@ var getAllSlugs = (ops, schemaTags = []) => {
 var getOperationSlugKey = (op) => [op.path, op.method, op.operationId, op.summary].filter(Boolean).join("-");
 var getAllOperations = (paths) => {
   const operations = Object.entries(paths ?? {}).flatMap(
-    ([path33, value]) => HttpMethods.flatMap((method) => {
+    ([path35, value]) => HttpMethods.flatMap((method) => {
       if (!value?.[method]) return [];
       const operation = value[method];
       const pathParameters = value.parameters ?? [];
@@ -4966,7 +4966,7 @@ var getAllOperations = (paths) => {
       return {
         ...operation,
         method,
-        path: path33,
+        path: path35,
         parameters,
         servers,
         tags: operation.tags ?? []
@@ -5324,8 +5324,8 @@ var Schema = builder.objectRef("Schema").implement({
     }),
     paths: t.field({
       type: [PathItem],
-      resolve: (root) => Object.entries(root.paths ?? {}).map(([path33, value]) => ({
-        path: path33,
+      resolve: (root) => Object.entries(root.paths ?? {}).map(([path35, value]) => ({
+        path: path35,
         // biome-ignore lint/style/noNonNullAssertion: value is guaranteed to be defined
         methods: Object.keys(value)
       }))
@@ -5472,7 +5472,7 @@ init_joinUrl();
 
 // src/vite/api/schema-codegen.ts
 var unescapeJsonPointer = (uri) => decodeURIComponent(uri.replace(/~1/g, "/").replace(/~0/g, "~"));
-var getSegmentsFromPath = (path33) => path33.split("/").slice(1).map(unescapeJsonPointer);
+var getSegmentsFromPath = (path35) => path35.split("/").slice(1).map(unescapeJsonPointer);
 var createLocalRefMap = (obj) => {
   const refMap = /* @__PURE__ */ new Map();
   const siblingsMap = /* @__PURE__ */ new Map();
@@ -5503,16 +5503,16 @@ var replaceMarkers = (code, mergedRefs) => code.replace(/"__refMap:(.*?)"/g, '__
   /"__refMap\+Siblings:(.*?)"/g,
   (_, key) => mergedRefs.get(key) ?? `__refMap["${key}"]`
 );
-var lookup = (schema2, path33, filePath) => {
-  const parts = getSegmentsFromPath(path33);
+var lookup = (schema2, path35, filePath) => {
+  const parts = getSegmentsFromPath(path35);
   let val = schema2;
   for (const part of parts) {
     while (val.$ref?.startsWith("#/")) {
-      val = val.$ref === path33 ? val : lookup(schema2, val.$ref, filePath);
+      val = val.$ref === path35 ? val : lookup(schema2, val.$ref, filePath);
     }
     if (val[part] === void 0) {
       throw new Error(
-        `Error in ${filePath ?? "code generation"}: Could not find path segment ${part} in path: ${path33}`
+        `Error in ${filePath ?? "code generation"}: Could not find path segment ${part} in path: ${path35}`
       );
     }
     val = val[part];
@@ -5757,8 +5757,8 @@ var SchemaManager = class {
       }
     }
   };
-  getLatestSchema = (path33) => this.processedSchemas[path33]?.at(0);
-  getSchemasForPath = (path33) => this.processedSchemas[path33];
+  getLatestSchema = (path35) => this.processedSchemas[path35]?.at(0);
+  getSchemasForPath = (path35) => this.processedSchemas[path35];
   getSchemaImports = () => Object.values(this.processedSchemas).flat().filter((s) => s.importKey);
   getUrlToFilePathMap = () => {
     const map = /* @__PURE__ */ new Map();
@@ -5911,7 +5911,7 @@ var NavigationResolver = class {
     );
     if (!foundMatches) {
       throw new Error(
-        `File not found for document '${filePath}'. Navigation items of type 'doc' must point to a valid .md or .mdx file. Do you mean 'link' or 'custom-page'? Check navigation configuration documentation for more information: https://zudoku.dev/docs/configuration/navigation`
+        `File not found for document '${filePath}'. Navigation items of type 'doc' must point to a valid .md or .mdx file. Do you mean 'link' or 'custom-page'? Check navigation configuration documentation for more information: https://docs.apitogo.com/docs/configuration/navigation`
       );
     }
     const { data, content } = await readFrontmatter(foundMatches);
@@ -7322,15 +7322,41 @@ var plugin_mdx_default = viteMdxPlugin;
 
 // src/vite/plugin-search.ts
 init_loader();
+import path18 from "node:path";
+
+// src/vite/pagefind-dev-stub.ts
+import fs3 from "node:fs/promises";
+import path17 from "node:path";
+var NOT_BUILT_YET = 'throw new Error("NOT_BUILT_YET");';
+async function ensurePagefindDevStub(publicDir) {
+  const pagefindPath = path17.join(publicDir, "pagefind/pagefind.js");
+  const exists = await fs3.stat(pagefindPath).catch(() => false);
+  if (!exists) {
+    await fs3.mkdir(path17.dirname(pagefindPath), { recursive: true });
+    await fs3.writeFile(pagefindPath, NOT_BUILT_YET);
+  }
+}
+
+// src/vite/plugin-search.ts
 var viteSearchPlugin = () => {
   const virtualModuleId4 = "virtual:zudoku-search-plugin";
   const resolvedVirtualModuleId4 = `\0${virtualModuleId4}`;
+  let resolvedViteConfig;
   return {
     name: "zudoku-search-plugin",
+    async configResolved(config2) {
+      resolvedViteConfig = config2;
+      if (config2.publicDir && getCurrentConfig()?.search?.type === "pagefind") {
+        await ensurePagefindDevStub(config2.publicDir);
+      }
+    },
     resolveId(id) {
       if (id === virtualModuleId4) {
         return resolvedVirtualModuleId4;
       }
+      if (id === "/pagefind/pagefind.js" && resolvedViteConfig?.publicDir) {
+        return path18.join(resolvedViteConfig.publicDir, "pagefind/pagefind.js");
+      }
     },
     async load(id) {
       if (id !== resolvedVirtualModuleId4) return;
@@ -7466,8 +7492,8 @@ function vitePlugin() {
 }
 
 // src/vite/config.ts
-var getAppClientEntryPath = () => path17.posix.join(getZudokuRootDir(), "src/app/entry.client.tsx");
-var getAppServerEntryPath = () => path17.posix.join(getZudokuRootDir(), "src/app/entry.server.tsx");
+var getAppClientEntryPath = () => path19.posix.join(getZudokuRootDir(), "src/app/entry.client.tsx");
+var getAppServerEntryPath = () => path19.posix.join(getZudokuRootDir(), "src/app/entry.server.tsx");
 var hasLoggedCdnInfo = false;
 var MEDIA_REGEX = /\.(a?png|jpe?g|gif|bmp|svg|webp|tiff|ico|webm|ogg|mp3|wav|m4a|avif|mp4)/i;
 var defineEnvVars = (vars) => Object.fromEntries(
@@ -7497,7 +7523,7 @@ async function getViteConfig(dir, configEnv) {
   );
   if (ZuploEnv.isZuplo) {
     dotenv.config({
-      path: path17.resolve(config2.__meta.rootDir, "../.env.zuplo"),
+      path: path19.resolve(config2.__meta.rootDir, "../.env.zuplo"),
       quiet: true
     });
   }
@@ -7554,8 +7580,8 @@ async function getViteConfig(dir, configEnv) {
       ssr: configEnv.isSsrBuild,
       sourcemap: true,
       target: "es2022",
-      outDir: path17.resolve(
-        path17.join(
+      outDir: path19.resolve(
+        path19.join(
           dir,
           "dist",
           config2.basePath ?? "",
@@ -7574,7 +7600,7 @@ async function getViteConfig(dir, configEnv) {
     },
     experimental: {
       renderBuiltUrl(filename) {
-        if (cdnUrl?.base && [".js", ".css"].includes(path17.extname(filename))) {
+        if (cdnUrl?.base && [".js", ".css"].includes(path19.extname(filename))) {
           return joinUrl(cdnUrl.base, filename);
         }
         if (cdnUrl?.media && MEDIA_REGEX.test(filename)) {
@@ -7587,7 +7613,7 @@ async function getViteConfig(dir, configEnv) {
       esbuildOptions: {
         target: "es2022"
       },
-      entries: [path17.posix.join(getZudokuRootDir(), "src/{app,lib}/**")],
+      entries: [path19.posix.join(getZudokuRootDir(), "src/{app,lib}/**")],
       exclude: ["@lukoweb/apitogo"],
       include: [
         "react-dom/client",
@@ -7686,7 +7712,7 @@ init_package_json();
 init_joinUrl();
 import assert from "node:assert";
 import { cp, mkdir as mkdir3, writeFile as writeFile3 } from "node:fs/promises";
-import path18 from "node:path";
+import path20 from "node:path";
 var pkgJson = getZudokuPackageJson();
 function generateOutput({
   config: config2,
@@ -7743,9 +7769,9 @@ async function writeOutput(dir, {
   rewrites
 }) {
   const output = generateOutput({ config: config2, redirects, rewrites });
-  const outputDir = process.env.VERCEL ? path18.join(dir, ".vercel/output") : path18.join(dir, "dist/.output");
+  const outputDir = process.env.VERCEL ? path20.join(dir, ".vercel/output") : path20.join(dir, "dist/.output");
   await mkdir3(outputDir, { recursive: true });
-  const outputFile = path18.join(outputDir, "config.json");
+  const outputFile = path20.join(outputDir, "config.json");
   await writeFile3(outputFile, JSON.stringify(output, null, 2), "utf-8");
   if (process.env.VERCEL) {
     console.log("Wrote Vercel output to", outputDir);
@@ -7757,7 +7783,7 @@ init_logger();
 init_file_exists();
 import { readFile as readFile2, rm } from "node:fs/promises";
 import os from "node:os";
-import path21 from "node:path";
+import path23 from "node:path";
 import { pathToFileURL } from "node:url";
 import { createIndex } from "pagefind";
 import colors7 from "picocolors";
@@ -7799,7 +7825,7 @@ function throttle(fn) {
 init_joinUrl();
 import { createWriteStream, existsSync } from "node:fs";
 import { mkdir as mkdir4 } from "node:fs/promises";
-import path19 from "node:path";
+import path21 from "node:path";
 import colors5 from "picocolors";
 import { SitemapStream } from "sitemap";
 async function generateSitemap({
@@ -7813,11 +7839,11 @@ async function generateSitemap({
     return;
   }
   const sitemap = new SitemapStream({ hostname: config2.siteUrl });
-  const outputDir = path19.resolve(baseOutputDir, config2.outDir ?? "");
+  const outputDir = path21.resolve(baseOutputDir, config2.outDir ?? "");
   if (!existsSync(outputDir)) {
     await mkdir4(outputDir, { recursive: true });
   }
-  const sitemapOutputPath = path19.join(outputDir, "sitemap.xml");
+  const sitemapOutputPath = path21.join(outputDir, "sitemap.xml");
   const writeStream = createWriteStream(sitemapOutputPath);
   sitemap.pipe(writeStream);
   let lastmod;
@@ -7847,14 +7873,14 @@ async function generateSitemap({
 
 // src/vite/prerender/utils.ts
 init_joinUrl();
-var resolveRoutePath = (path33) => {
-  const segments = path33.split("/");
+var resolveRoutePath = (path35) => {
+  const segments = path35.split("/");
   if (segments.some((s) => s.startsWith(":") && !s.endsWith("?"))) {
     return void 0;
   }
   return segments.filter((s) => !s.startsWith(":")).join("/") || void 0;
 };
-var isSkipped = (path33) => path33.includes("*") || /^\d+$/.test(path33);
+var isSkipped = (path35) => path35.includes("*") || /^\d+$/.test(path35);
 var resolveRoutes = (routes, parentPath = "") => routes.flatMap((route) => {
   if (route.path && isSkipped(route.path)) return [];
   const routePath = route.path ? resolveRoutePath(route.path) : void 0;
@@ -7903,12 +7929,12 @@ var prerender = async ({
   serverConfigFilename,
   writeRedirects = true
 }) => {
-  const distDir = path21.join(dir, "dist", basePath);
+  const distDir = path23.join(dir, "dist", basePath);
   const serverConfigPath = pathToFileURL(
-    path21.join(distDir, "server", serverConfigFilename)
+    path23.join(distDir, "server", serverConfigFilename)
   ).href;
   const entryServerPath = pathToFileURL(
-    path21.join(distDir, "server/entry.server.js")
+    path23.join(distDir, "server/entry.server.js")
   ).href;
   const rawConfig = await import(serverConfigPath).then(
     (m) => m.default
@@ -7993,7 +8019,7 @@ var prerender = async ({
     })
   );
   const pagefindWriteResult = await pagefindIndex?.writeFiles({
-    outputPath: path21.join(distDir, "pagefind")
+    outputPath: path23.join(distDir, "pagefind")
   });
   const seconds = ((performance.now() - start) / 1e3).toFixed(1);
   const message = `\u2713 finished prerendering ${paths.length} routes in ${seconds} seconds using ${maxThreads} workers`;
@@ -8025,7 +8051,7 @@ var prerender = async ({
     const { generateLlmsTxtFiles: generateLlmsTxtFiles2 } = await Promise.resolve().then(() => (init_llms(), llms_exports));
     const docsConfig = DocsConfigSchema2.parse(config2.docs);
     const llmsConfig = docsConfig.llms ?? {};
-    const markdownInfoPath = path21.join(
+    const markdownInfoPath = path23.join(
       dir,
       "node_modules/.apitogo/markdown-info.json"
     );
@@ -8116,7 +8142,7 @@ async function runBuild(options) {
       html,
       basePath: config2.basePath
     });
-    await rm2(path22.join(clientOutDir, "index.html"), { force: true });
+    await rm2(path24.join(clientOutDir, "index.html"), { force: true });
   } else {
     await runPrerender({
       dir,
@@ -8140,7 +8166,7 @@ var runPrerender = async (options) => {
       serverConfigFilename,
       writeRedirects: process.env.VERCEL === void 0
     });
-    const indexHtml = path22.join(clientOutDir, "index.html");
+    const indexHtml = path24.join(clientOutDir, "index.html");
     if (!workerResults.find((r) => r.outputPath === indexHtml)) {
       await writeFile5(indexHtml, html, "utf-8");
     }
@@ -8150,15 +8176,15 @@ var runPrerender = async (options) => {
     for (const statusPage of statusPages) {
       await rename(
         statusPage,
-        path22.join(dir, DIST_DIR, path22.basename(statusPage))
+        path24.join(dir, DIST_DIR, path24.basename(statusPage))
       );
     }
     await rm2(serverOutDir, { recursive: true, force: true });
     if (process.env.VERCEL) {
-      await mkdir5(path22.join(dir, ".vercel/output/static"), { recursive: true });
+      await mkdir5(path24.join(dir, ".vercel/output/static"), { recursive: true });
       await rename(
-        path22.join(dir, DIST_DIR),
-        path22.join(dir, ".vercel/output/static")
+        path24.join(dir, DIST_DIR),
+        path24.join(dir, ".vercel/output/static")
       );
     }
     await writeOutput(dir, {
@@ -8168,7 +8194,7 @@ var runPrerender = async (options) => {
     });
     if (ZuploEnv.isZuplo && issuer) {
       await writeFile5(
-        path22.join(dir, DIST_DIR, ".output/zuplo.json"),
+        path24.join(dir, DIST_DIR, ".output/zuplo.json"),
         JSON.stringify({ issuer }, null, 2),
         "utf-8"
       );
@@ -8180,10 +8206,10 @@ var runPrerender = async (options) => {
 };
 var bundleSSREntry = async (options) => {
   const { dir, adapter, serverOutDir, serverConfigFilename, html, basePath } = options;
-  const tempEntryPath = path22.join(dir, "__ssr-entry.ts");
+  const tempEntryPath = path24.join(dir, "__ssr-entry.ts");
   const packageRoot = getZudokuRootDir();
   const templateContent = await readFile3(
-    path22.join(packageRoot, "src/vite/ssr-templates", `${adapter}.ts`),
+    path24.join(packageRoot, "src/vite/ssr-templates", `${adapter}.ts`),
     "utf-8"
   );
   const entryContent = templateContent.replace('"__TEMPLATE__"', JSON.stringify(html)).replace('"__CONFIG_FILE__"', JSON.stringify(`./${serverConfigFilename}`)).replace(
@@ -8198,9 +8224,9 @@ var bundleSSREntry = async (options) => {
       platform: adapter === "node" ? "node" : "neutral",
       target: "es2022",
       format: "esm",
-      outfile: path22.join(serverOutDir, "entry.js"),
+      outfile: path24.join(serverOutDir, "entry.js"),
       external: ["./entry.server.js", `./${serverConfigFilename}`],
-      nodePaths: [path22.join(packageRoot, "node_modules")],
+      nodePaths: [path24.join(packageRoot, "node_modules")],
       banner: { js: "// Bundled SSR entry" }
     });
   } finally {
@@ -8254,11 +8280,11 @@ function textOrJson(text) {
 init_package_json();
 
 // src/cli/preview/handler.ts
-import path23 from "node:path";
+import path25 from "node:path";
 import { preview as vitePreview } from "vite";
 var DEFAULT_PREVIEW_PORT = 4e3;
 async function preview(argv) {
-  const dir = path23.resolve(process.cwd(), argv.dir);
+  const dir = path25.resolve(process.cwd(), argv.dir);
   const viteConfig = await getViteConfig(dir, {
     command: "serve",
     mode: "production",
@@ -8299,7 +8325,7 @@ async function build(argv) {
     printDiagnosticsToConsole("");
     printDiagnosticsToConsole("");
   }
-  const dir = path24.resolve(process.cwd(), argv.dir);
+  const dir = path26.resolve(process.cwd(), argv.dir);
   try {
     await runBuild({
       dir,
@@ -8459,7 +8485,7 @@ var build_default = {
 // src/cli/configure-github-workflow/handler.ts
 import { constants } from "node:fs";
 import { access, mkdir as mkdir6, writeFile as writeFile6 } from "node:fs/promises";
-import path25 from "node:path";
+import path27 from "node:path";
 var APITOGO_DEPLOY_WORKFLOW_YAML = `name: Build and Deploy
 
 on:
@@ -8552,9 +8578,9 @@ jobs:
         run: apitogo deploy --deployment-token="$APITOGO_TOKEN" --json-only
 `;
 async function configureGithubWorkflow(argv) {
-  const dir = path25.resolve(process.cwd(), argv.dir);
-  const workflowDir = path25.join(dir, ".github", "workflows");
-  const workflowPath = path25.join(workflowDir, "apitogo-deploy.yml");
+  const dir = path27.resolve(process.cwd(), argv.dir);
+  const workflowDir = path27.join(dir, ".github", "workflows");
+  const workflowPath = path27.join(workflowDir, "apitogo-deploy.yml");
   try {
     try {
       await access(workflowPath, constants.F_OK);
@@ -8620,15 +8646,15 @@ function applyJsonOnlyDeployQuietMode() {
 
 // src/cli/deploy/handler.ts
 import { access as access2, readFile as readFile4 } from "node:fs/promises";
-import path26 from "node:path";
+import path28 from "node:path";
 import { create as createTar } from "tar";
 var DEPLOY_ENDPOINT = "https://deployserver.apitogo.com/deploy";
 var DEPLOY_API_KEY = "qRVLTP22TFStdN6";
 var ARCHIVE_NAME = "dist.tgz";
 var createDeploymentArchive = async (dir) => {
-  const distDir = path26.join(dir, "dist");
+  const distDir = path28.join(dir, "dist");
   await access2(distDir);
-  const archivePath = path26.join(dir, ARCHIVE_NAME);
+  const archivePath = path28.join(dir, ARCHIVE_NAME);
   await createTar(
     {
       cwd: dir,
@@ -8642,7 +8668,7 @@ var createDeploymentArchive = async (dir) => {
 };
 async function deploy(argv) {
   await build({ ...argv, preview: void 0 });
-  const dir = path26.resolve(process.cwd(), argv.dir);
+  const dir = path28.resolve(process.cwd(), argv.dir);
   const deploymentToken = argv.deploymentToken?.trim() || process.env.npm_config_deployment_token?.trim();
   const env = argv.env?.trim() || process.env.npm_config_env?.trim() || "production";
   try {
@@ -8655,7 +8681,7 @@ async function deploy(argv) {
     const archivePath = await createDeploymentArchive(dir);
     if (!isJsonOnlyDeployEnv()) {
       printDiagnosticsToConsole(
-        `Uploading ${path26.basename(archivePath)} to ${env}...`
+        `Uploading ${path28.basename(archivePath)} to ${env}...`
       );
     }
     const archiveBuffer = await readFile4(archivePath);
@@ -8663,7 +8689,7 @@ async function deploy(argv) {
     formData.append(
       "file",
       new Blob([archiveBuffer], { type: "application/gzip" }),
-      path26.basename(archivePath)
+      path28.basename(archivePath)
     );
     formData.append("deploymentToken", deploymentToken);
     formData.append("env", env);
@@ -8748,14 +8774,14 @@ var deploy_default = {
 
 // src/cli/dev/handler.ts
 init_joinUrl();
-import path29 from "node:path";
+import path31 from "node:path";
 
 // src/vite/dev-server.ts
 init_logger();
-import fs3 from "node:fs/promises";
+import fs4 from "node:fs/promises";
 import http from "node:http";
 import https from "node:https";
-import path28 from "node:path";
+import path30 from "node:path";
 import { createHttpTerminator } from "http-terminator";
 import {
   createServer as createViteServer,
@@ -8788,7 +8814,7 @@ init_loader();
 // src/vite/pagefind-dev-index.ts
 init_invariant();
 init_joinUrl();
-import path27 from "node:path";
+import path29 from "node:path";
 import { createIndex as createIndex2 } from "pagefind";
 import { isRunnableDevEnvironment } from "vite";
 async function* buildPagefindDevIndex(vite, config2) {
@@ -8841,7 +8867,7 @@ async function* buildPagefindDevIndex(vite, config2) {
       path: urlPath
     };
   }
-  const outputPath = path27.join(vite.config.publicDir, "pagefind");
+  const outputPath = path29.join(vite.config.publicDir, "pagefind");
   await pagefindIndex.writeFiles({ outputPath });
   yield { type: "complete", success: true, indexed };
 }
@@ -8860,9 +8886,9 @@ var DevServer = class {
     this.protocol = "https";
     const { dir } = this.options;
     const [key, cert, ca] = await Promise.all([
-      fs3.readFile(path28.resolve(dir, config2.https.key)),
-      fs3.readFile(path28.resolve(dir, config2.https.cert)),
-      config2.https.ca ? fs3.readFile(path28.resolve(dir, config2.https.ca)) : void 0
+      fs4.readFile(path30.resolve(dir, config2.https.key)),
+      fs4.readFile(path30.resolve(dir, config2.https.cert)),
+      config2.https.ca ? fs4.readFile(path30.resolve(dir, config2.https.ca)) : void 0
     ]);
     return https.createServer({ key, cert, ca });
   }
@@ -8878,6 +8904,13 @@ var DevServer = class {
       this.options.argPort ?? config2.port ?? DEFAULT_DEV_PORT
     );
     const server = await this.createNodeServer(config2);
+    if (config2.search?.type === "pagefind" && viteConfig.publicDir !== false) {
+      const publicRoot = path30.resolve(
+        this.options.dir,
+        typeof viteConfig.publicDir === "string" ? viteConfig.publicDir : "public"
+      );
+      await ensurePagefindDevStub(publicRoot);
+    }
     const mergedViteConfig = mergeConfig4(viteConfig, {
       server: {
         hmr: { server }
@@ -8889,7 +8922,7 @@ var DevServer = class {
           // built-in transform middleware which would treat the path as a static asset.
           name: "apitogo:entry-client",
           configureServer(server2) {
-            const entryPath = path28.posix.join(
+            const entryPath = path30.posix.join(
               server2.config.base,
               "/__z/entry.client.tsx"
             );
@@ -8961,16 +8994,8 @@ var DevServer = class {
     printDiagnosticsToConsole(
       `Server-side rendering ${this.options.ssr ? "enabled" : "disabled"}`
     );
-    if (config2.search?.type === "pagefind") {
-      const pagefindPath = path28.join(
-        vite.config.publicDir,
-        "pagefind/pagefind.js"
-      );
-      const exists = await fs3.stat(pagefindPath).catch(() => false);
-      if (!exists) {
-        await fs3.mkdir(path28.dirname(pagefindPath), { recursive: true });
-        await fs3.writeFile(pagefindPath, 'throw new Error("NOT_BUILT_YET");');
-      }
+    if (config2.search?.type === "pagefind" && vite.config.publicDir) {
+      await ensurePagefindDevStub(vite.config.publicDir);
     }
     vite.middlewares.use(async (req, res) => {
       const url = req.originalUrl ?? req.url ?? "/";
@@ -9062,7 +9087,7 @@ init_package_json();
 async function dev(argv) {
   const packageJson2 = getZudokuPackageJson();
   process.env.NODE_ENV = "development";
-  const dir = path29.resolve(process.cwd(), argv.dir);
+  const dir = path31.resolve(process.cwd(), argv.dir);
   const server = new DevServer({
     dir,
     argPort: argv.port,
@@ -9146,14 +9171,14 @@ var dev_default = {
 
 // src/cli/make-config/handler.ts
 import { readFile as readFile6, writeFile as writeFile8 } from "node:fs/promises";
-import path31 from "node:path";
+import path33 from "node:path";
 import { glob as glob5 } from "glob";
 
 // src/cli/make-config/scaffold-project.ts
 init_package_json();
 import { access as access3, readFile as readFile5, writeFile as writeFile7 } from "node:fs/promises";
 import { constants as constants2 } from "node:fs";
-import path30 from "node:path";
+import path32 from "node:path";
 import { glob as glob4 } from "glob";
 var OPENAPI_GLOBS = [
   "apis/openapi.json",
@@ -9213,9 +9238,9 @@ var findMatchingCurly = (source, startIndex) => {
   }
   throw new Error("Could not find matching closing brace for object.");
 };
-var toPosix = (p) => p.split(path30.sep).join("/");
+var toPosix = (p) => p.split(path32.sep).join("/");
 var sanitizePackageName = (dir) => {
-  const base = path30.basename(path30.resolve(dir));
+  const base = path32.basename(path32.resolve(dir));
   const s = base.toLowerCase().replace(/[^a-z0-9-_.]/g, "-").replace(/^-+|-+$/g, "");
   return s || "apitogo-site";
 };
@@ -9225,7 +9250,7 @@ var apitogoVersionRange = () => {
 };
 async function findOpenApiSpecPath(dir) {
   for (const rel of OPENAPI_GLOBS) {
-    const full = path30.join(dir, rel);
+    const full = path32.join(dir, rel);
     try {
       await access3(full, constants2.R_OK);
       return toPosix(rel);
@@ -9240,7 +9265,7 @@ async function findOpenApiSpecPath(dir) {
   return extra[0] ? toPosix(extra[0]) : null;
 }
 async function ensurePackageJson(dir) {
-  const pkgPath = path30.join(dir, "package.json");
+  const pkgPath = path32.join(dir, "package.json");
   const apitogoVer = apitogoVersionRange();
   const baseDeps = {
     react: ">=19.0.0",
@@ -9301,7 +9326,7 @@ async function ensurePackageJson(dir) {
   return false;
 }
 async function ensureTsconfigJson(dir) {
-  const tsPath = path30.join(dir, "tsconfig.json");
+  const tsPath = path32.join(dir, "tsconfig.json");
   try {
     await access3(tsPath, constants2.R_OK);
     return false;
@@ -9383,7 +9408,7 @@ var CONFIG_FILENAMES = [
 ];
 var DEFAULT_NEW_CONFIG_FILENAME = "apitogo.config.tsx";
 var createTreeNode = () => ({ docs: [], children: /* @__PURE__ */ new Map() });
-var toPosixPath2 = (value) => value.split(path31.sep).join(path31.posix.sep);
+var toPosixPath2 = (value) => value.split(path33.sep).join(path33.posix.sep);
 var toRoutePath = (relativeFile, pagesDir) => {
   const relativeNoExt = relativeFile.replace(/\.mdx?$/, "");
   const withoutPagesPrefix = relativeNoExt.replace(
@@ -9628,7 +9653,7 @@ export default config;
 };
 var findExistingConfigPath = async (dir) => {
   for (const filename of CONFIG_FILENAMES) {
-    const fullPath = path31.join(dir, filename);
+    const fullPath = path33.join(dir, filename);
     try {
       await readFile6(fullPath, "utf8");
       return fullPath;
@@ -9638,7 +9663,7 @@ var findExistingConfigPath = async (dir) => {
   return null;
 };
 async function makeConfig(argv) {
-  const dir = path31.resolve(process.cwd(), argv.dir);
+  const dir = path33.resolve(process.cwd(), argv.dir);
   const pagesDir = toPosixPath2(
     argv.pagesDir.replace(/^[./]+/, "").replace(/\/+$/, "")
   );
@@ -9655,7 +9680,7 @@ async function makeConfig(argv) {
     let configPath = await findExistingConfigPath(dir);
     let createdNew = false;
     if (!configPath) {
-      configPath = path31.join(dir, DEFAULT_NEW_CONFIG_FILENAME);
+      configPath = path33.join(dir, DEFAULT_NEW_CONFIG_FILENAME);
       await writeFile8(
         configPath,
         buildNewConfigContents(pagesDir, openApiSpecPath),
@@ -9696,7 +9721,7 @@ async function makeConfig(argv) {
     await writeFile8(configPath, withRedirects, "utf8");
     const action = createdNew ? "Initialized" : "Updated";
     printResultToConsole(
-      `${action} ${path31.basename(configPath)} from ${pagesDir}/ (navigation and redirects; other top-level settings preserved unless newly scaffolded).`
+      `${action} ${path33.basename(configPath)} from ${pagesDir}/ (navigation and redirects; other top-level settings preserved unless newly scaffolded).`
     );
     if (createdPackageJson) {
       printDiagnosticsToConsole(
@@ -9805,12 +9830,12 @@ function box(message, {
 
 // src/cli/common/xdg/lib.ts
 import { homedir } from "node:os";
-import path32 from "node:path";
+import path34 from "node:path";
 function defineDirectoryWithFallback(xdgName, fallback) {
   if (process.env[xdgName]) {
     return process.env[xdgName];
   } else {
-    return path32.join(homedir(), fallback);
+    return path34.join(homedir(), fallback);
   }
 }
 var XDG_CONFIG_HOME = defineDirectoryWithFallback(
@@ -9825,15 +9850,15 @@ var XDG_STATE_HOME = defineDirectoryWithFallback(
   "XDG_DATA_HOME",
   ".local/state"
 );
-var ZUDOKU_XDG_CONFIG_HOME = path32.join(
+var ZUDOKU_XDG_CONFIG_HOME = path34.join(
   XDG_CONFIG_HOME,
   CLI_XDG_FOLDER_NAME
 );
-var ZUDOKU_XDG_DATA_HOME = path32.join(
+var ZUDOKU_XDG_DATA_HOME = path34.join(
   XDG_DATA_HOME,
   CLI_XDG_FOLDER_NAME
 );
-var ZUDOKU_XDG_STATE_HOME = path32.join(
+var ZUDOKU_XDG_STATE_HOME = path34.join(
   XDG_STATE_HOME,
   CLI_XDG_FOLDER_NAME
 );

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lukoweb/apitogo",
-  "version": "0.1.17",
+  "version": "0.1.19",
   "type": "module",
   "sideEffects": [
     "**/*.css",

package/src/config/validators/NavigationSchema.ts

@@ -221,7 +221,7 @@ export class NavigationResolver {
 
     if (!foundMatches) {
       throw new Error(
-        `File not found for document '${filePath}'. Navigation items of type 'doc' must point to a valid .md or .mdx file. Do you mean 'link' or 'custom-page'? Check navigation configuration documentation for more information: https://zudoku.dev/docs/configuration/navigation`,
+        `File not found for document '${filePath}'. Navigation items of type 'doc' must point to a valid .md or .mdx file. Do you mean 'link' or 'custom-page'? Check navigation configuration documentation for more information: https://docs.apitogo.com/docs/configuration/navigation`,
       );
     }
 

package/src/lib/shiki.ts

@@ -57,7 +57,7 @@ const warnUnloadedLanguage = (lang: string, highlighter: HighlighterCore) => {
   console.warn(
     `Language "${lang}" is not loaded for syntax highlighting. ` +
       `Add it to \`syntaxHighlighting.languages\` in your config. Falling back to plain text.\n` +
-      `See https://zudoku.dev/docs/markdown/code-blocks#configuration`,
+      `See https://docs.apitogo.com/docs/markdown/code-blocks#configuration`,
   );
 };
 

package/src/vite/dev-server.ts

@@ -24,6 +24,7 @@ import {
 } from "./config.js";
 import { getDevHtml } from "./html.js";
 import { buildPagefindDevIndex } from "./pagefind-dev-index.js";
+import { ensurePagefindDevStub } from "./pagefind-dev-stub.js";
 
 const DEFAULT_DEV_PORT = 3000;
 
@@ -75,6 +76,16 @@ export class DevServer {
 
     const server = await this.createNodeServer(config);
 
+    if (config.search?.type === "pagefind" && viteConfig.publicDir !== false) {
+      const publicRoot = path.resolve(
+        this.options.dir,
+        typeof viteConfig.publicDir === "string"
+          ? viteConfig.publicDir
+          : "public",
+      );
+      await ensurePagefindDevStub(publicRoot);
+    }
+
     const mergedViteConfig = mergeConfig(viteConfig, {
       server: {
         hmr: { server },
@@ -179,16 +190,8 @@ export class DevServer {
       `Server-side rendering ${this.options.ssr ? "enabled" : "disabled"}`,
     );
 
-    if (config.search?.type === "pagefind") {
-      const pagefindPath = path.join(
-        vite.config.publicDir,
-        "pagefind/pagefind.js",
-      );
-      const exists = await fs.stat(pagefindPath).catch(() => false);
-      if (!exists) {
-        await fs.mkdir(path.dirname(pagefindPath), { recursive: true });
-        await fs.writeFile(pagefindPath, 'throw new Error("NOT_BUILT_YET");');
-      }
+    if (config.search?.type === "pagefind" && vite.config.publicDir) {
+      await ensurePagefindDevStub(vite.config.publicDir);
     }
 
     vite.middlewares.use(async (req, res) => {

package/src/vite/pagefind-dev-stub.ts

@@ -0,0 +1,17 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+
+const NOT_BUILT_YET = 'throw new Error("NOT_BUILT_YET");';
+
+/**
+ * Writes a minimal `pagefind.js` under the Vite public dir so dev-time
+ * `import("/pagefind/pagefind.js")` resolves and the real index can be built later.
+ */
+export async function ensurePagefindDevStub(publicDir: string): Promise<void> {
+  const pagefindPath = path.join(publicDir, "pagefind/pagefind.js");
+  const exists = await fs.stat(pagefindPath).catch(() => false);
+  if (!exists) {
+    await fs.mkdir(path.dirname(pagefindPath), { recursive: true });
+    await fs.writeFile(pagefindPath, NOT_BUILT_YET);
+  }
+}

package/src/vite/plugin-search.ts

@@ -1,16 +1,34 @@
-import type { Plugin } from "vite";
+import path from "node:path";
+import type { Plugin, ResolvedConfig } from "vite";
 import { getCurrentConfig } from "../config/loader.js";
+import { ensurePagefindDevStub } from "./pagefind-dev-stub.js";
 
 export const viteSearchPlugin = (): Plugin => {
   const virtualModuleId = "virtual:zudoku-search-plugin";
   const resolvedVirtualModuleId = `\0${virtualModuleId}`;
+  let resolvedViteConfig: ResolvedConfig | undefined;
 
   return {
     name: "zudoku-search-plugin",
+    async configResolved(config) {
+      resolvedViteConfig = config;
+      if (
+        config.publicDir &&
+        getCurrentConfig()?.search?.type === "pagefind"
+      ) {
+        await ensurePagefindDevStub(config.publicDir);
+      }
+    },
     resolveId(id) {
       if (id === virtualModuleId) {
         return resolvedVirtualModuleId;
       }
+      if (
+        id === "/pagefind/pagefind.js" &&
+        resolvedViteConfig?.publicDir
+      ) {
+        return path.join(resolvedViteConfig.publicDir, "pagefind/pagefind.js");
+      }
     },
     async load(id) {
       if (id !== resolvedVirtualModuleId) return;