@zeropress/build-pages 0.6.1 → 0.6.2

package/README.md

@@ -5,7 +5,7 @@
 
 Build ZeroPress static output for modern hosting platforms.
 
-`@zeropress/build-pages` turns a directory of Markdown files and public assets into a static ZeroPress site. It discovers Markdown pages, prepares the site data, stages public files, and runs [`@zeropress/build`](https://github.com/zeropress-app/zeropress-build).
+`@zeropress/build-pages` turns Markdown files and public assets into a static ZeroPress site. It discovers Markdown pages, prepares the site data, stages public files, and runs [`@zeropress/build`](https://github.com/zeropress-app/zeropress-build).
 
 The generated output is plain static files that can be deployed to GitHub Pages, Cloudflare Pages, Netlify, Vercel, or any static hosting provider.
 
@@ -13,7 +13,9 @@ The generated output is plain static files that can be deployed to GitHub Pages,
 
 ```txt
 source directory
-  Markdown pages + .zeropress/config.json + public files
+  Markdown pages + .zeropress/config.json
+public directory
+  public files (defaults to source)
         |
         v
 @zeropress/build-pages
@@ -32,7 +34,7 @@ static output directory
 flowchart TD
   source["Source directory"] --> markdown["Markdown pages (*.md)"]
   source --> config[".zeropress/config.json"]
-  source --> publicFiles["Public files<br/>images, CSS, JS, PDF, JSON, Markdown"]
+  publicRoot["Public directory<br/>defaults to source"] --> publicFiles["Public files<br/>images, CSS, JS, PDF, JSON, Markdown"]
 
   markdown --> buildPages["@zeropress/build-pages"]
   config --> buildPages
@@ -83,6 +85,7 @@ jobs:
         uses: zeropress-app/zeropress-build-pages@v0
         with:
           source: ./docs
+          public-dir: ./public
           destination: ./_site
       - name: Upload artifact
         uses: actions/upload-pages-artifact@v5
@@ -114,6 +117,7 @@ That is equivalent to:
   uses: zeropress-app/zeropress-build-pages@v0
   with:
     source: ./docs
+    public-dir: ./docs
     destination: ./_site
     theme: docs
     skip-untitled-markdown: false
@@ -128,6 +132,7 @@ Custom input example:
   uses: zeropress-app/zeropress-build-pages@v0
   with:
     source: ./documents
+    public-dir: ./public
     destination: ./_site
     theme-path: ./theme-docs
     config: ./documents/.zeropress/config.json
@@ -137,7 +142,8 @@ Custom input example:
 
 In the action inputs:
 
-- `source` is the directory that contains your Markdown pages, public files, and optional `.zeropress/config.json`. The default is `./docs`.
+- `source` is the directory that contains your Markdown pages and optional `.zeropress/config.json`. The default is `./docs`.
+- `public-dir` is the directory copied as public passthrough files. The default is `source`.
 - `destination` is the directory where the generated static site is written. The default is `./_site`.
 - `theme` is the bundled theme name. The default is `docs`.
 - `theme-path` is a custom local ZeroPress theme directory. It takes precedence over `theme`.
@@ -158,6 +164,7 @@ npx @zeropress/create-theme --name my-docs-theme --template docs
 ```yaml
 with:
   source: ./docs
+  public-dir: ./public
   destination: ./_site
   theme-path: ./my-docs-theme/theme
 ```
@@ -196,7 +203,8 @@ The CLI requires explicit input and output paths. The GitHub Action keeps safe d
 
 | Option | Default | Purpose |
 | --- | --- | --- |
-| `--source <dir>` | required | Dedicated source directory containing Markdown and public files |
+| `--source <dir>` | required | Dedicated source directory containing Markdown and optional config |
+| `--public-dir <dir>` | source | Public passthrough directory |
 | `--destination <dir>` | required | Output directory |
 | `--theme docs` | `docs` | Bundled docs theme |
 | `--theme-path <dir>` | none | Custom ZeroPress theme directory |
@@ -208,7 +216,7 @@ The CLI requires explicit input and output paths. The GitHub Action keeps safe d
 
 ## Source Tree
 
-The source directory is the folder that Build Pages reads. It is both the Markdown source root and the public passthrough root. GitHub Action usage defaults to `./docs`; CLI usage requires `--source`.
+The source directory is the folder that Build Pages reads for Markdown pages and optional `.zeropress/config.json`. By default, the source directory is also the public passthrough root. Use `public-dir` when you want to keep Markdown source and public assets separate.
 
 Use a dedicated content directory such as `docs/` or `documents/`. Repository root source (`--source ./`) is not supported.
 
@@ -217,20 +225,25 @@ my-site/
   docs/                 # source
     index.md
     guide.md
-    assets/
-      logo.png
     .zeropress/
       config.json
+  public/               # public-dir, optional
+    assets/
+      logo.png
+    favicon.svg
+    robots.txt
   _site/                # destination, generated
 ```
 
-Build Pages stages the source tree before calling [`@zeropress/build`](https://github.com/zeropress-app/zeropress-build). Generated ZeroPress output wins over staged public files.
+Build Pages stages the public directory before calling [`@zeropress/build`](https://github.com/zeropress-app/zeropress-build). Generated ZeroPress output wins over staged public files.
+
+Root-level public files named `favicon.ico`, `favicon.svg`, `favicon.png`, and `apple-touch-icon.png` are copied to the destination and auto-injected into generated HTML `<head>` output.
 
-Root-level source favicon files named `favicon.ico`, `favicon.svg`, `favicon.png`, and `apple-touch-icon.png` are copied to the destination and auto-injected into generated HTML `<head>` output.
+A root-level public `sitemap.xsl` is copied to the destination. When ZeroPress generates `sitemap.xml`, it auto-discovers that file and adds an XML stylesheet processing instruction for `/sitemap.xsl`.
 
-A root-level source `sitemap.xsl` is copied to the destination. When ZeroPress generates `sitemap.xml`, it auto-discovers that file and adds an XML stylesheet processing instruction for `/sitemap.xsl`.
+The source directory must not overlap the destination directory, the selected theme directory, or the internal `.zeropress/` working directory. An explicit public directory must be an existing dedicated directory and must not be a file, symlink, repository root, destination directory, selected theme directory, or internal `.zeropress/` working directory.
 
-The source directory must not overlap the destination directory, the selected theme directory, or the internal `.zeropress/` working directory.
+If `public-dir` is inside `source`, Build Pages excludes that public subtree from Markdown page discovery.
 
 Ignored while staging and Markdown discovery:
 
@@ -334,6 +347,7 @@ See the public config reference at [zeropress.dev/build-pages-config](https://ze
     "description": "Project documentation",
     "url": "https://example.github.io/project",
     "expose_generator": true,
+    "search": true,
     "indexing": true,
     "footer": {
       "copyright_text": "Copyright 2026 Example Corp.",
@@ -383,7 +397,20 @@ The bundled docs theme shows `Published with ZeroPress.` by default. Set `site.f
 
 `site.expose_generator` controls the HTML generator meta tag. Missing or `true` emits `<meta name="generator" content="ZeroPress">`; set it to `false` for white-label sites.
 
-`site.indexing` controls only the generated fallback `robots.txt`. Missing or `true` allows indexing; `false` writes `User-agent: *` / `Disallow: /`. If the source directory contains `robots.txt`, that file is copied as-is and takes priority over `site.indexing`. ZeroPress does not append a `Sitemap` directive to a source-provided `robots.txt`; add `Sitemap: https://example.com/sitemap.xml` manually when needed.
+`site.search` controls native ZeroPress search when the selected theme supports search UI. Missing or `true` enables native search for the bundled docs theme; `false` omits `/_zeropress/search.json`, `/_zeropress/search.js`, and `/_zeropress/search_pagefind.js` and hides the bundled search form.
+
+The bundled docs theme marks post/page body content with `data-pagefind-body`. If you run Pagefind after the ZeroPress build, keep the theme UI pointed at `/_zeropress/search.js` and replace the native adapter:
+
+```bash
+npx pagefind@latest \
+  --site ./_site \
+  --output-subdir _zeropress/pagefind
+
+cp ./_site/_zeropress/search_pagefind.js ./_site/_zeropress/search.js
+rm ./_site/_zeropress/search.json
+```
+
+`site.indexing` controls only the generated fallback `robots.txt`. Missing or `true` allows indexing; `false` writes `User-agent: *` / `Disallow: /`. If the public directory contains `robots.txt`, that file is copied as-is and takes priority over `site.indexing`. ZeroPress does not append a `Sitemap` directive to a public `robots.txt`; add `Sitemap: https://example.com/sitemap.xml` manually when needed.
 
 Schemas:
 
@@ -405,13 +432,13 @@ Build Pages reads optional site config from `<source>/.zeropress/config.json`. S
 
 `preview-data.json` is an internal generated build input for the ZeroPress renderer. Most users do not need to edit or understand this file.
 
-`build-report.json` records discovered Markdown counts, skipped Markdown files, front page resolution, source Markdown copy policy, and custom HTML slots.
+`build-report.json` records source/public roots, discovered Markdown counts, skipped Markdown files, front page resolution, source Markdown copy policy, and custom HTML slots.
 
 `public-assets/` is a temporary staged public root used before the final ZeroPress render.
 
 ## Destination Output
 
-The `destination` directory contains the deployable static site. It includes generated ZeroPress HTML, copied public files, and original Markdown files unless Markdown source copy is disabled or files are excluded by the public passthrough rules. A source `robots.txt` is copied as a site-owned policy file; otherwise ZeroPress writes a fallback `robots.txt` with a sitemap directive when `site.url` is available. Root-level source favicon files are copied and represented as generated HTML head links. A root-level source `sitemap.xsl` is copied and linked from generated `sitemap.xml`.
+The `destination` directory contains the deployable static site. It includes generated ZeroPress HTML, copied public files, and original Markdown files unless Markdown source copy is disabled or files are excluded by the public passthrough rules. A public `robots.txt` is copied as a site-owned policy file; otherwise ZeroPress writes a fallback `robots.txt` with a sitemap directive when `site.url` is available. Root-level public favicon files are copied and represented as generated HTML head links. A root-level public `sitemap.xsl` is copied and linked from generated `sitemap.xml`.
 
 ## Demo
 

package/action.yml

@@ -9,6 +9,9 @@ inputs:
     description: Dedicated source directory containing Markdown files and optional .zeropress/config.json. Repository root source is not supported.
     required: false
     default: ./docs
+  public-dir:
+    description: Public passthrough directory for site-owned assets. Defaults to source.
+    required: false
   destination:
     description: Output directory for the generated static site.
     required: false

package/dist/action.js

@@ -52318,6 +52318,7 @@ function validateSite(site, path4, errors) {
     "media_delivery_mode",
     "favicon",
     "expose_generator",
+    "search",
     "locale",
     "posts_per_page",
     "datetime_display",
@@ -52348,6 +52349,9 @@ function validateSite(site, path4, errors) {
   if (site.expose_generator !== void 0) {
     validateBoolean(site.expose_generator, `${path4}.expose_generator`, "INVALID_SITE_EXPOSE_GENERATOR", errors);
   }
+  if (site.search !== void 0) {
+    validateBoolean(site.search, `${path4}.search`, "INVALID_SITE_SEARCH", errors);
+  }
   validateNonEmptyString(site.locale, `${path4}.locale`, "INVALID_SITE_LOCALE", errors);
   validateInteger(site.posts_per_page, `${path4}.posts_per_page`, "INVALID_SITE_POSTS_PER_PAGE", errors, { minimum: 1 });
   validateEnum(site.datetime_display, `${path4}.datetime_display`, "INVALID_SITE_DATETIME_DISPLAY", errors, PREVIEW_DATETIME_DISPLAY_MODES);
@@ -53010,7 +53014,7 @@ function isOptionalKey(path4, key) {
     return key === "head_end" || key === "body_end";
   }
   if (path4 === "site") {
-    return key === "media_delivery_mode" || key === "favicon" || key === "expose_generator" || key === "indexing" || key === "permalinks" || key === "front_page" || key === "post_index" || key === "footer" || key === "meta";
+    return key === "media_delivery_mode" || key === "favicon" || key === "expose_generator" || key === "search" || key === "indexing" || key === "permalinks" || key === "front_page" || key === "post_index" || key === "footer" || key === "meta";
   }
   if (path4 === "site.favicon") {
     return key === "icon" || key === "svg" || key === "png" || key === "apple_touch_icon";
@@ -53272,7 +53276,7 @@ var MENU_SLOT_ID_MAX_LENGTH = 32;
 var MENU_SLOT_COUNT_MAX = 12;
 var MENU_SLOT_TITLE_MAX_LENGTH = 80;
 var MENU_SLOT_DESCRIPTION_MAX_LENGTH = 160;
-var SUPPORTED_THEME_FEATURES = /* @__PURE__ */ new Set(["comments", "newsletter", "post_index"]);
+var SUPPORTED_THEME_FEATURES = /* @__PURE__ */ new Set(["comments", "newsletter", "post_index", "search"]);
 var THEME_MANIFEST_KEYS = /* @__PURE__ */ new Set([
   "$schema",
   "name",
@@ -60907,6 +60911,7 @@ var PERMALINK_OUTPUT_STYLES = /* @__PURE__ */ new Set(["directory", "html-extens
 var COMMENT_POLICY_OUTPUT_PATH = "_zeropress/comment-policy.json";
 var SEARCH_INDEX_OUTPUT_PATH = "_zeropress/search.json";
 var SEARCH_ADAPTER_OUTPUT_PATH = "_zeropress/search.js";
+var SEARCH_PAGEFIND_ADAPTER_OUTPUT_PATH = "_zeropress/search_pagefind.js";
 var OUTPUT_PATH_CONTROL_CHAR_PATTERN = /[\u0000-\u001F\u007F]/;
 var SAFE_MEDIA_PROTOCOLS = /* @__PURE__ */ new Set(["http:", "https:"]);
 var SAFE_LINK_PROTOCOLS = /* @__PURE__ */ new Set(["http:", "https:", "mailto:", "tel:"]);
@@ -60964,9 +60969,12 @@ async function buildSite(input2) {
     state.commentPolicyContent,
     "application/json"
   );
-  if (options2.generateSpecialFiles) {
+  if (shouldGenerateSearchArtifacts(state, options2)) {
     await writeOutput(state.writer, state.summaries, SEARCH_INDEX_OUTPUT_PATH, buildSearchIndexJson(state), "application/json");
     await writeOutput(state.writer, state.summaries, SEARCH_ADAPTER_OUTPUT_PATH, buildSearchAdapterJs(), "application/javascript");
+    await writeOutput(state.writer, state.summaries, SEARCH_PAGEFIND_ADAPTER_OUTPUT_PATH, buildSearchPagefindAdapterJs(), "application/javascript");
+  }
+  if (options2.generateSpecialFiles) {
     await maybeRenderNotFoundPage(state);
     if (hasCanonicalSiteUrl(state.previewData.site.url)) {
       await writeOutput(
@@ -61286,6 +61294,7 @@ function normalizePreviewData(previewData, options2 = {}) {
     locale: normalizeLocale(previewData.site.locale || DEFAULT_LOCALE),
     disallow_comments: previewData.site.disallow_comments === true,
     expose_generator: previewData.site.expose_generator !== false,
+    search: previewData.site.search !== false,
     indexing: previewData.site.indexing !== false,
     permalinks: normalizePermalinks(previewData.site.permalinks),
     front_page: normalizeFrontPage(previewData.site.front_page),
@@ -61567,6 +61576,8 @@ function normalizePostIndex(post_index) {
 function createRenderData(previewData, themeMetadata = {}) {
   const themeSupportsComments = themeMetadata?.features?.comments === true;
   const themeSupportsPostIndex = themeMetadata?.features?.post_index !== false;
+  const themeSupportsSearch = themeMetadata?.features?.search === true;
+  previewData.site.search = previewData.site.search !== false && themeSupportsSearch;
   const authorsById = new Map(previewData.content.authors.map((author) => [author.id, author]));
   const categoriesBySlug = new Map(previewData.content.categories.map((category) => [category.slug, category]));
   const tagsBySlug = new Map(previewData.content.tags.map((tag) => [tag.slug, tag]));
@@ -62922,8 +62933,10 @@ function assertPlannedOutputPathsSafe(state) {
     ...state.assetOutputs.map((assetOutput) => assetOutput.path),
     COMMENT_POLICY_OUTPUT_PATH
   ];
+  if (shouldGenerateSearchArtifacts(state, state.options)) {
+    plannedPaths.push(SEARCH_INDEX_OUTPUT_PATH, SEARCH_ADAPTER_OUTPUT_PATH, SEARCH_PAGEFIND_ADAPTER_OUTPUT_PATH);
+  }
   if (state.options.generateSpecialFiles) {
-    plannedPaths.push(SEARCH_INDEX_OUTPUT_PATH, SEARCH_ADAPTER_OUTPUT_PATH);
     plannedPaths.push("404.html");
     if (shouldGenerateRobotsTxt(state.options)) {
       plannedPaths.push("robots.txt");
@@ -63436,6 +63449,87 @@ function normalizeLimit(value) {
 }
 `;
 }
+function buildSearchPagefindAdapterJs() {
+  return `let pagefindPromise;
+
+export async function preload() {
+  if (!pagefindPromise) {
+    pagefindPromise = import(new URL('./pagefind/pagefind.js', import.meta.url).href).then(async (pagefind) => {
+      if (typeof pagefind.options === 'function') {
+        await pagefind.options({ baseUrl: '/' });
+      }
+      return pagefind;
+    });
+  }
+
+  return pagefindPromise;
+}
+
+export async function search(query, options = {}) {
+  const pagefind = await preload();
+  const result = await pagefind.search(query, options);
+  const limit = normalizeLimit(options.limit);
+  if (!Array.isArray(result?.results)) {
+    return result;
+  }
+
+  const results = result.results.map(normalizeResult);
+  return {
+    ...result,
+    results: limit ? results.slice(0, limit) : results,
+  };
+}
+
+function normalizeResult(result) {
+  if (!result || typeof result.data !== 'function') {
+    return result;
+  }
+
+  return {
+    ...result,
+    data: async () => normalizeResultData(await result.data()),
+  };
+}
+
+function normalizeResultData(data) {
+  if (!data || typeof data !== 'object') {
+    return data;
+  }
+
+  return {
+    ...data,
+    url: normalizeUrl(data.url),
+    sub_results: Array.isArray(data.sub_results)
+      ? data.sub_results.map((item) => ({ ...item, url: normalizeUrl(item.url) }))
+      : data.sub_results,
+  };
+}
+
+function normalizeUrl(value) {
+  const url = String(value || '');
+  if (url.startsWith('/_zeropress/') && !url.startsWith('/_zeropress/pagefind/')) {
+    return url.replace(/^\\/_zeropress/, '') || '/';
+  }
+  if (url.startsWith('_zeropress/') && !url.startsWith('_zeropress/pagefind/')) {
+    return url.replace(/^_zeropress/, '') || '/';
+  }
+  return url;
+}
+
+function normalizeLimit(value) {
+  if (value === undefined || value === null) {
+    return null;
+  }
+
+  const limit = Number(value);
+  if (!Number.isFinite(limit) || limit <= 0) {
+    return null;
+  }
+
+  return Math.floor(limit);
+}
+`;
+}
 function buildSitemapXml(site, emitted, generatedAt, stylesheetHref = "") {
   const entries = [
     ...emitted.frontPage && emitted.frontPage.includeInSitemap !== false ? [{
@@ -63521,6 +63615,9 @@ function buildRobotsTxt(site) {
 function shouldGenerateRobotsTxt(options2) {
   return options2.generateSpecialFiles && options2.generateRobotsTxt !== false;
 }
+function shouldGenerateSearchArtifacts(state, options2) {
+  return options2.generateSpecialFiles && state.previewData.site.search === true;
+}
 function getContentType(assetPath) {
   const ext = assetPath.split(".").pop()?.toLowerCase();
   const contentTypes = {
@@ -64017,6 +64114,8 @@ async function runBuildPages(options2) {
   const cwd = path3.resolve(options2.cwd || process.cwd());
   const copyMarkdownSource = options2.copyMarkdownSource !== false;
   const sourceDir = path3.resolve(cwd, options2.source);
+  const publicDirExplicit = hasExplicitPublicDir(options2);
+  const publicDir = publicDirExplicit ? path3.resolve(cwd, options2.publicDir) : sourceDir;
   const destinationDir = path3.resolve(cwd, options2.destination);
   const generatedDir = path3.join(cwd, ".zeropress");
   const stagingDir = path3.join(cwd, STAGING_DIR);
@@ -64025,17 +64124,22 @@ async function runBuildPages(options2) {
   assertBuildPagesPathLayout({
     cwd,
     sourceDir,
+    publicDir,
+    publicDirExplicit,
     destinationDir,
     themeDir,
     generatedDir
   });
   await assertDirectory(sourceDir, "Source directory");
+  await assertPublicDirectory(publicDir, publicDirExplicit);
+  await assertDestinationPath(destinationDir);
   await fs3.rm(generatedDir, { recursive: true, force: true });
   await fs3.mkdir(generatedDir, { recursive: true });
   const env = {
     ...process.env,
     ZEROPRESS_BUILD_PAGES_SOURCE: sourceDir,
-    ZEROPRESS_PUBLIC_DIR: sourceDir,
+    ZEROPRESS_BUILD_PAGES_PUBLIC_DIR: publicDir,
+    ZEROPRESS_PUBLIC_DIR: publicDir,
     ZEROPRESS_SKIP_UNTITLED_MARKDOWN: String(Boolean(options2.skipUntitledMarkdown)),
     ZEROPRESS_COPY_MARKDOWN_SOURCE: String(copyMarkdownSource)
   };
@@ -64059,10 +64163,13 @@ async function runBuildPages(options2) {
   await fs3.rm(destinationDir, { recursive: true, force: true });
   await fs3.rm(stagingDir, { recursive: true, force: true });
   await fs3.mkdir(stagingDir, { recursive: true });
-  await copyPublicStaging(sourceDir, stagingDir, {
+  await copyPublicStaging(publicDir, stagingDir, {
     excludePaths: [destinationDir, themeDir, generatedDir],
     copyMarkdownSource
   });
+  if (copyMarkdownSource) {
+    await copySourceMarkdownFiles(sourceDir, stagingDir, previewData);
+  }
   const previousPublicDir = process.env.ZEROPRESS_PUBLIC_DIR;
   process.env.ZEROPRESS_PUBLIC_DIR = stagingDir;
   try {
@@ -64097,6 +64204,9 @@ function resolveThemeDir(cwd, options2) {
   }
   throw new Error(`Unknown bundled theme: ${options2.theme}`);
 }
+function hasExplicitPublicDir(options2) {
+  return typeof options2.publicDir === "string" && Boolean(options2.publicDir.trim());
+}
 async function assertDirectory(dir, label) {
   let stat;
   try {
@@ -64111,17 +64221,78 @@ async function assertDirectory(dir, label) {
     throw new Error(`${label} is not a directory: ${dir}`);
   }
 }
-function assertBuildPagesPathLayout({ cwd, sourceDir, destinationDir, themeDir, generatedDir }) {
+async function assertPublicDirectory(publicDir, explicit) {
+  if (!explicit) {
+    return;
+  }
+  let stat;
+  try {
+    stat = await fs3.lstat(publicDir);
+  } catch (error) {
+    if (error?.code === "ENOENT") {
+      throw new Error(`Public directory not found: ${publicDir}`);
+    }
+    throw error;
+  }
+  if (stat.isSymbolicLink()) {
+    throw new Error(`Public directory must not be a symbolic link: ${publicDir}`);
+  }
+  if (!stat.isDirectory()) {
+    throw new Error(`Public path is not a directory: ${publicDir}`);
+  }
+}
+async function assertDestinationPath(destinationDir) {
+  let stat;
+  try {
+    stat = await fs3.lstat(destinationDir);
+  } catch (error) {
+    if (error?.code === "ENOENT") {
+      return;
+    }
+    throw error;
+  }
+  if (!stat.isDirectory()) {
+    throw new Error(`Destination path is not a directory: ${destinationDir}`);
+  }
+}
+function assertBuildPagesPathLayout({
+  cwd,
+  sourceDir,
+  publicDir,
+  publicDirExplicit,
+  destinationDir,
+  themeDir,
+  generatedDir
+}) {
   if (samePath(sourceDir, cwd)) {
     throw new Error(
       `Source directory must be a dedicated content directory, not the current working directory. Received: ${formatPath(cwd, sourceDir)}`
     );
   }
+  if (publicDirExplicit && samePath(publicDir, cwd)) {
+    throw new Error(
+      `Public directory must be a dedicated asset directory, not the current working directory. Received: ${formatPath(cwd, publicDir)}`
+    );
+  }
   assertNoPathOverlap(cwd, "Source directory", sourceDir, "internal .zeropress working directory", generatedDir);
   assertNoPathOverlap(cwd, "Destination directory", destinationDir, "internal .zeropress working directory", generatedDir);
   assertNoPathOverlap(cwd, "Theme directory", themeDir, "internal .zeropress working directory", generatedDir);
+  if (!samePath(publicDir, sourceDir)) {
+    assertNoPathOverlap(cwd, "Public directory", publicDir, "internal .zeropress working directory", generatedDir);
+    assertNoPathOverlap(cwd, "Public directory", publicDir, "destination directory", destinationDir);
+    assertNoPathOverlap(cwd, "Public directory", publicDir, "theme directory", themeDir);
+  }
   assertNoPathOverlap(cwd, "Source directory", sourceDir, "destination directory", destinationDir);
   assertNoPathOverlap(cwd, "Source directory", sourceDir, "theme directory", themeDir);
+  assertSourceIsNotInsidePublicDirectory(cwd, sourceDir, publicDir);
+}
+function assertSourceIsNotInsidePublicDirectory(cwd, sourceDir, publicDir) {
+  if (samePath(sourceDir, publicDir) || !isPathInside2(publicDir, sourceDir)) {
+    return;
+  }
+  throw new Error(
+    `Source directory must not be inside the public directory. Source directory: ${formatPath(cwd, sourceDir)}; Public directory: ${formatPath(cwd, publicDir)}`
+  );
 }
 function assertNoPathOverlap(cwd, firstLabel, firstPath, secondLabel, secondPath) {
   if (!pathsOverlap2(firstPath, secondPath)) {
@@ -64157,6 +64328,52 @@ async function copyPublicStaging(sourceDir, targetDir, options2) {
     await fs3.copyFile(sourcePath, targetPath);
   }
 }
+async function copySourceMarkdownFiles(sourceDir, targetDir, previewData) {
+  const markdownUrls = /* @__PURE__ */ new Set();
+  for (const page of previewData?.content?.pages || []) {
+    const sourceMarkdownUrl = page?.meta?.source_markdown_url;
+    if (typeof sourceMarkdownUrl === "string" && sourceMarkdownUrl) {
+      markdownUrls.add(sourceMarkdownUrl);
+    }
+  }
+  for (const sourceMarkdownUrl of markdownUrls) {
+    const relativePath = sourceMarkdownUrlToRelativePath(sourceMarkdownUrl);
+    if (!relativePath) {
+      continue;
+    }
+    const sourcePath = path3.join(sourceDir, relativePath);
+    if (!isPathInside2(sourceDir, sourcePath)) {
+      continue;
+    }
+    const targetPath = path3.join(targetDir, relativePath);
+    await fs3.mkdir(path3.dirname(targetPath), { recursive: true });
+    await fs3.copyFile(sourcePath, targetPath);
+  }
+}
+function sourceMarkdownUrlToRelativePath(sourceMarkdownUrl) {
+  if (!sourceMarkdownUrl.startsWith("/") || sourceMarkdownUrl.includes("?") || sourceMarkdownUrl.includes("#")) {
+    return "";
+  }
+  const rawSegments = sourceMarkdownUrl.slice(1).split("/");
+  const segments = [];
+  for (const rawSegment of rawSegments) {
+    if (!rawSegment) {
+      return "";
+    }
+    let segment;
+    try {
+      segment = decodeURIComponent(rawSegment);
+    } catch {
+      return "";
+    }
+    if (!segment || segment === "." || segment === ".." || segment.includes("/") || segment.includes("\\")) {
+      return "";
+    }
+    segments.push(segment);
+  }
+  const relativePath = segments.join("/");
+  return relativePath.toLowerCase().endsWith(".md") ? relativePath : "";
+}
 function shouldIgnorePublicEntry2(name) {
   const basename = String(name || "");
   const lowerName = basename.toLowerCase();
@@ -64185,6 +64402,7 @@ function formatPath(cwd, targetPath) {
 // src/action.js
 var options = {
   source: input("source") || "./docs",
+  publicDir: input("public-dir"),
   destination: input("destination") || "./_site",
   theme: input("theme") || "docs",
   themePath: input("theme-path"),

package/dist/prebuild.js

@@ -3524,6 +3524,7 @@ import { fileURLToPath } from "node:url";
 var __dirname = path.dirname(fileURLToPath(import.meta.url));
 var rootDir = process.cwd();
 var sourceDir = resolveEnvPath(["ZEROPRESS_BUILD_PAGES_SOURCE"], "docs");
+var publicDir = resolveEnvPath(["ZEROPRESS_BUILD_PAGES_PUBLIC_DIR"], sourceDir);
 var defaultConfigPath = path.join(sourceDir, ".zeropress", "config.json");
 var configPath = resolveOptionalEnvPath(["ZEROPRESS_BUILD_PAGES_CONFIG"], defaultConfigPath);
 var outDir = path.join(rootDir, ".zeropress");
@@ -3540,6 +3541,7 @@ var FRONT_MATTER_DATA_MAX_DEPTH = 4;
 var FRONT_MATTER_DATA_MAX_KEYS = 64;
 var FRONT_MATTER_DATA_MAX_ARRAY_LENGTH = 256;
 var FRONT_MATTER_DISCOVERABILITY_VALUES = /* @__PURE__ */ new Set(["default", "noindex", "delist"]);
+var markdownDiscoverExcludeRoots = buildMarkdownDiscoverExcludeRoots();
 var PrebuildMarkdownError = class extends Error {
   constructor(sourcePath, reason, expected = "", code = "invalid_markdown") {
     super(reason);
@@ -3740,6 +3742,7 @@ function buildSiteData(config, frontPage) {
     },
     disallow_comments: true,
     expose_generator: configuredSite.expose_generator !== false,
+    search: configuredSite.search !== false,
     indexing: configuredSite.indexing !== false
   };
   if (configuredSite.footer) {
@@ -3768,12 +3771,13 @@ function normalizeSiteConfig(value) {
     );
   }
   const configuredSite = isPlainObject(value) ? value : {};
-  assertKnownConfigKeys(configuredSite, ["title", "description", "url", "expose_generator", "indexing", "footer"], "site");
+  assertKnownConfigKeys(configuredSite, ["title", "description", "url", "expose_generator", "search", "indexing", "footer"], "site");
   const site = {
     title: readConfigString(configuredSite.title, "Documentation"),
     description: readConfigString(configuredSite.description, "A documentation site."),
     url: readEnv("ZEROPRESS_SITE_URL", readConfigString(configuredSite.url, "")),
     expose_generator: readConfigBoolean(configuredSite.expose_generator, true, "site.expose_generator"),
+    search: readConfigBoolean(configuredSite.search, true, "site.search"),
     indexing: readConfigBoolean(configuredSite.indexing, true, "site.indexing")
   };
   const footer = normalizeFooter(configuredSite.footer);
@@ -4184,6 +4188,7 @@ function buildPrebuildReport({
   return {
     generated_at: (/* @__PURE__ */ new Date()).toISOString(),
     source_dir: formatSourcePath(sourceDir),
+    public_dir: formatSourcePath(publicDir),
     config_path: formatSourcePath(configPath),
     build_pages_config_path: formatSourcePath(buildPagesConfigPath),
     preview_data_path: formatSourcePath(previewDataPath),
@@ -4209,7 +4214,8 @@ function buildPrebuildReport({
 function printPrebuildSummary(report) {
   const lines = [
     "ZeroPress build report",
-    `- Public root: ${report.source_dir}`,
+    `- Source root: ${report.source_dir}`,
+    `- Public root: ${report.public_dir}`,
     `- Markdown discovered: ${report.markdown.discovered}`,
     `- Markdown pages generated: ${report.markdown.generated_pages}`,
     `- Markdown skipped: ${report.markdown.skipped}`,
@@ -4497,6 +4503,9 @@ async function listMarkdownFiles(dir) {
       continue;
     }
     const entryPath = path.join(dir, entry.name);
+    if (isMarkdownDiscoverExcluded(entryPath)) {
+      continue;
+    }
     if (entry.isDirectory()) {
       files.push(...await listMarkdownFiles(entryPath));
       continue;
@@ -4507,6 +4516,18 @@ async function listMarkdownFiles(dir) {
   }
   return files.sort((left, right) => left.localeCompare(right));
 }
+function buildMarkdownDiscoverExcludeRoots() {
+  if (samePath(sourceDir, publicDir) || !isPathInside(sourceDir, publicDir)) {
+    return [];
+  }
+  return [publicDir];
+}
+function isMarkdownDiscoverExcluded(entryPath) {
+  return markdownDiscoverExcludeRoots.some((excludeRoot) => samePath(entryPath, excludeRoot) || isPathInside(excludeRoot, entryPath));
+}
+function samePath(firstPath, secondPath) {
+  return path.resolve(firstPath) === path.resolve(secondPath);
+}
 function shouldIgnoreMarkdownDiscoverEntry(name) {
   const basename = String(name || "");
   const lowerName = basename.toLowerCase();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zeropress/build-pages",
-  "version": "0.6.1",
+  "version": "0.6.2",
   "description": "ZeroPress Markdown build action and CLI for static hosting",
   "type": "module",
   "license": "MIT",
@@ -40,7 +40,7 @@
     "node": ">=18.18.0"
   },
   "dependencies": {
-    "@zeropress/build": "0.6.1",
+    "@zeropress/build": "0.6.2",
     "gray-matter": "4.0.3"
   },
   "devDependencies": {