@zeropress/build-pages 0.6.2 → 0.6.4

package/dist/prebuild.js

@@ -3519,28 +3519,32 @@ var require_gray_matter = __commonJS({
 // src/prebuild.js
 var import_gray_matter = __toESM(require_gray_matter(), 1);
 import fs from "node:fs/promises";
+import { execFile } from "node:child_process";
 import path from "node:path";
+import { promisify } from "node:util";
 import { fileURLToPath } from "node:url";
 var __dirname = path.dirname(fileURLToPath(import.meta.url));
+var execFileAsync = promisify(execFile);
 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");
+var outDir = path.join(rootDir, ".zeropress-build-page");
 var buildPagesConfigPath = path.join(outDir, "build-pages-config.json");
 var previewDataPath = path.join(outDir, "preview-data.json");
 var buildReportPath = path.join(outDir, "build-report.json");
 var skipUntitledMarkdown = readBooleanEnv("ZEROPRESS_SKIP_UNTITLED_MARKDOWN");
 var copyMarkdownSource = readBooleanEnv("ZEROPRESS_COPY_MARKDOWN_SOURCE", true);
 var FRONT_PAGE_TYPES = /* @__PURE__ */ new Set(["theme_index", "markdown", "html"]);
-var BUILD_PAGES_CONFIG_SCHEMA_URL = "https://zeropress.dev/schemas/zeropress-build-pages.config.v0.1.schema.json";
-var PREVIEW_DATA_SCHEMA_URL = "https://zeropress.dev/schemas/preview-data.v0.6.schema.json";
+var BUILD_PAGES_CONFIG_SCHEMA_URL = "https://schemas.zeropress.dev/build-pages-config/v0.1/schema.json";
+var PREVIEW_DATA_SCHEMA_URL = "https://schemas.zeropress.dev/preview-data/v0.6/schema.json";
 var FRONT_MATTER_DATA_KEY_PATTERN = /^[a-zA-Z_][a-zA-Z0-9_]*(?:-[a-zA-Z0-9_]+)*$/;
 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 MARKDOWN_LAST_UPDATED_VALUES = /* @__PURE__ */ new Set(["none", "git"]);
 var markdownDiscoverExcludeRoots = buildMarkdownDiscoverExcludeRoots();
 var PrebuildMarkdownError = class extends Error {
   constructor(sourcePath, reason, expected = "", code = "invalid_markdown") {
@@ -3569,10 +3573,12 @@ async function main() {
   );
   const menus = normalizeMenus(config.menus);
   const customHtmlConfig = normalizeCustomHtmlConfig(config.custom_html);
+  const markdownConfig = normalizeMarkdownConfig(config.markdown);
   const resolvedConfig = buildResolvedConfig(config, {
     frontPageConfig,
     menus,
-    customHtmlConfig
+    customHtmlConfig,
+    markdownConfig
   });
   const sourceFiles = await listMarkdownFiles(sourceDir);
   const skippedMarkdown = [];
@@ -3607,21 +3613,29 @@ async function main() {
   const routeBySourcePath = new Map(
     pageInputs.map(({ sourcePath, route }) => [sourcePath, route])
   );
-  const pages = pageInputs.map(({ sourcePath, bodyMarkdown, frontMatter, title, route }) => ({
-    title,
-    slug: route.slug,
-    path: route.path,
-    meta: {
-      ...frontMatter.meta,
-      ...copyMarkdownSource ? { source_markdown_url: buildSourceMarkdownUrl(sourcePath) } : {}
-    },
-    ...frontMatter.data !== void 0 ? { data: frontMatter.data } : {},
-    ...frontMatter.discoverability !== "default" ? { discoverability: frontMatter.discoverability } : {},
-    content: rewriteMarkdownLinks(bodyMarkdown, sourcePath, routeBySourcePath),
-    document_type: "markdown",
-    excerpt: frontMatter.description || extractExcerpt(bodyMarkdown, title),
-    status: "published"
-  }));
+  const collections = normalizeCollections(config.collections, pageInputs, skippedMarkdown);
+  if (Object.keys(collections).length > 0) {
+    resolvedConfig.collections = collections;
+  }
+  const pages = [];
+  for (const { sourcePath, bodyMarkdown, frontMatter, title, route } of pageInputs) {
+    const meta = await buildPageMeta(sourcePath, frontMatter, markdownConfig);
+    pages.push({
+      title,
+      slug: route.slug,
+      path: route.path,
+      meta: {
+        ...meta,
+        ...copyMarkdownSource ? { source_markdown_url: buildSourceMarkdownUrl(sourcePath) } : {}
+      },
+      ...frontMatter.data !== void 0 ? { data: frontMatter.data } : {},
+      ...frontMatter.discoverability !== "default" ? { discoverability: frontMatter.discoverability } : {},
+      content: rewriteMarkdownLinks(bodyMarkdown, sourcePath, routeBySourcePath),
+      document_type: "markdown",
+      excerpt: frontMatter.description || extractExcerpt(bodyMarkdown, title),
+      status: "published"
+    });
+  }
   const frontPageResult = await buildFrontPageData(frontPageConfig, pageInputs, resolvedConfig);
   if (frontPageResult.page) {
     pages.push(frontPageResult.page);
@@ -3644,6 +3658,9 @@ async function main() {
     menus,
     widgets: {}
   };
+  if (Object.keys(collections).length > 0) {
+    previewData.collections = collections;
+  }
   if (customHtml) {
     previewData.custom_html = customHtml;
   }
@@ -3729,7 +3746,7 @@ function buildSiteData(config, frontPage) {
     description: configuredSite.description,
     url: configuredSite.url,
     media_base_url: "",
-    locale: "en-US",
+    locale: configuredSite.locale,
     posts_per_page: 10,
     datetime_display: "static",
     date_style: "medium",
@@ -3745,16 +3762,23 @@ function buildSiteData(config, frontPage) {
     search: configuredSite.search !== false,
     indexing: configuredSite.indexing !== false
   };
+  if (configuredSite.logo) {
+    site.logo = configuredSite.logo;
+  }
+  if (configuredSite.meta !== void 0) {
+    site.meta = configuredSite.meta;
+  }
   if (configuredSite.footer) {
     site.footer = configuredSite.footer;
   }
   return site;
 }
-function buildResolvedConfig(config, { frontPageConfig, menus, customHtmlConfig }) {
+function buildResolvedConfig(config, { frontPageConfig, menus, customHtmlConfig, markdownConfig }) {
   const resolvedConfig = {
     $schema: BUILD_PAGES_CONFIG_SCHEMA_URL,
     version: "0.1",
     site: normalizeSiteConfig(config.site),
+    markdown: markdownConfig,
     front_page: frontPageConfig,
     menus
   };
@@ -3763,6 +3787,23 @@ function buildResolvedConfig(config, { frontPageConfig, menus, customHtmlConfig
   }
   return resolvedConfig;
 }
+function normalizeMarkdownConfig(value) {
+  if (value === void 0) {
+    return {
+      last_updated: "none"
+    };
+  }
+  if (!isPlainObject(value)) {
+    throw new PrebuildConfigError(
+      "markdown must be an object.",
+      '  "markdown": { "last_updated": "git" }'
+    );
+  }
+  assertKnownConfigKeys(value, ["last_updated"], "markdown");
+  return {
+    last_updated: normalizeLastUpdatedPolicy(value.last_updated, "markdown.last_updated", PrebuildConfigError)
+  };
+}
 function normalizeSiteConfig(value) {
   if (value !== void 0 && !isPlainObject(value)) {
     throw new PrebuildConfigError(
@@ -3771,21 +3812,83 @@ function normalizeSiteConfig(value) {
     );
   }
   const configuredSite = isPlainObject(value) ? value : {};
-  assertKnownConfigKeys(configuredSite, ["title", "description", "url", "expose_generator", "search", "indexing", "footer"], "site");
+  assertKnownConfigKeys(configuredSite, ["title", "description", "url", "logo", "locale", "expose_generator", "search", "indexing", "footer", "meta"], "site");
   const site = {
     title: readConfigString(configuredSite.title, "Documentation"),
     description: readConfigString(configuredSite.description, "A documentation site."),
     url: readEnv("ZEROPRESS_SITE_URL", readConfigString(configuredSite.url, "")),
+    locale: normalizeSiteLocale(configuredSite.locale),
     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 logo = normalizeSiteLogo(configuredSite.logo);
+  if (logo) {
+    site.logo = logo;
+  }
   const footer = normalizeFooter(configuredSite.footer);
   if (footer) {
     site.footer = footer;
   }
+  if (configuredSite.meta !== void 0) {
+    site.meta = normalizeSiteMeta(configuredSite.meta, "site.meta");
+  }
   return site;
 }
+function normalizeSiteLocale(value) {
+  if (value === void 0) {
+    return "en-US";
+  }
+  if (typeof value !== "string") {
+    throw new PrebuildConfigError("site.locale must be a string when provided.");
+  }
+  const locale = value.trim();
+  if (locale.length < 2) {
+    throw new PrebuildConfigError('site.locale must be a non-empty locale string such as "en-US" or "ko-KR".');
+  }
+  return locale;
+}
+function normalizeSiteLogo(value) {
+  if (value === void 0) {
+    return void 0;
+  }
+  if (!isPlainObject(value)) {
+    throw new PrebuildConfigError("site.logo must be an object when provided.");
+  }
+  assertKnownConfigKeys(value, ["src", "alt"], "site.logo");
+  const src = readConfigString(value.src, "");
+  if (!src) {
+    throw new PrebuildConfigError(
+      "site.logo.src must be a non-empty URL-like string.",
+      '  "logo": { "src": "/logo.svg", "alt": "My Site" }'
+    );
+  }
+  validateUrlLikeString(src, "site.logo.src");
+  const logo = { src };
+  if (value.alt !== void 0) {
+    if (typeof value.alt !== "string") {
+      throw new PrebuildConfigError("site.logo.alt must be a string when provided.");
+    }
+    const alt = value.alt.trim();
+    if (alt) {
+      logo.alt = alt;
+    }
+  }
+  return logo;
+}
+function normalizeSiteMeta(value, pathLabel) {
+  if (!isPlainObject(value)) {
+    throw new PrebuildConfigError(`${pathLabel} must be an object when provided.`);
+  }
+  const meta = {};
+  for (const [key, metaValue] of Object.entries(value)) {
+    if (!isPreviewMetaValue(metaValue)) {
+      throw new PrebuildConfigError(`${pathLabel}.${key} must be a string, number, boolean, or null.`);
+    }
+    meta[key] = metaValue;
+  }
+  return meta;
+}
 function normalizeFooter(value) {
   if (value === void 0) {
     return void 0;
@@ -3807,6 +3910,22 @@ function normalizeFooter(value) {
   }
   return Object.keys(footer).length ? footer : void 0;
 }
+function validateUrlLikeString(value, pathLabel) {
+  if (value.startsWith("//")) {
+    throw new PrebuildConfigError(`${pathLabel} must be an absolute URL or a safe relative path.`);
+  }
+  if (value.startsWith("/") || value.startsWith("./") || value.startsWith("../")) {
+    return;
+  }
+  try {
+    const url = new URL(value);
+    if (!url.protocol || !url.hostname) {
+      throw new Error("missing host");
+    }
+  } catch {
+    throw new PrebuildConfigError(`${pathLabel} must be an absolute URL or a safe relative path.`);
+  }
+}
 function readConfigBoolean(value, fallback, pathName) {
   if (value === void 0) {
     return fallback;
@@ -4176,6 +4295,69 @@ function defaultMenus() {
     }
   };
 }
+function normalizeCollections(value, pageInputs, skippedMarkdown) {
+  if (value === void 0) {
+    return {};
+  }
+  if (!isPlainObject(value)) {
+    throw new PrebuildConfigError("collections must be an object keyed by collection id.");
+  }
+  const pageBySourcePath = new Map(pageInputs.map((pageInput) => [pageInput.sourcePath, pageInput]));
+  const skippedByFile = new Map(
+    skippedMarkdown.map((entry) => [path.resolve(rootDir, entry.file), entry.reason])
+  );
+  const collections = {};
+  for (const [collectionId, collection] of Object.entries(value)) {
+    validateConfigId(collectionId, `collections.${collectionId}`);
+    if (!isPlainObject(collection)) {
+      throw new PrebuildConfigError(`collections.${collectionId} must be an object.`);
+    }
+    assertKnownConfigKeys(collection, ["title", "description", "items"], `collections.${collectionId}`);
+    if (!Array.isArray(collection.items)) {
+      throw new PrebuildConfigError(`collections.${collectionId}.items must be an array of Markdown source paths.`);
+    }
+    const seenSourcePaths = /* @__PURE__ */ new Set();
+    const items = collection.items.map((item, index) => {
+      const pathLabel = `collections.${collectionId}.items[${index}]`;
+      const normalizedPath = resolveCollectionSourcePath(item, pathLabel);
+      const sourcePath = path.resolve(sourceDir, normalizedPath);
+      if (seenSourcePaths.has(sourcePath)) {
+        throw new PrebuildConfigError(`${pathLabel} duplicates ${normalizedPath} in collections.${collectionId}.`);
+      }
+      seenSourcePaths.add(sourcePath);
+      const pageInput = pageBySourcePath.get(sourcePath);
+      if (!pageInput) {
+        const skippedReason = skippedByFile.get(sourcePath);
+        if (skippedReason) {
+          throw new PrebuildConfigError(`${pathLabel} references skipped Markdown ${normalizedPath}: ${skippedReason}`);
+        }
+        throw new PrebuildConfigError(`${pathLabel} was not discovered as a Markdown page: ${normalizedPath}`);
+      }
+      return {
+        type: "page",
+        slug: pageInput.route.slug
+      };
+    });
+    collections[collectionId] = {
+      title: readConfigString(collection.title, collectionId),
+      ...collection.description !== void 0 ? { description: readConfigString(collection.description, "") } : {},
+      items
+    };
+  }
+  return collections;
+}
+function resolveCollectionSourcePath(value, pathLabel) {
+  const normalizedPath = normalizeSourceFilePath(value, pathLabel);
+  if (!normalizedPath.toLowerCase().endsWith(".md")) {
+    throw new PrebuildConfigError(`${pathLabel} must be a Markdown source path ending in .md.`);
+  }
+  return normalizedPath;
+}
+function validateConfigId(value, pathLabel) {
+  if (!/^[a-z][a-z0-9_-]{0,63}$/.test(value)) {
+    throw new PrebuildConfigError(`${pathLabel} must use a lowercase config id such as "docs" or "reference-guides".`);
+  }
+}
 function buildPrebuildReport({
   sourceFiles,
   pageInputs,
@@ -4284,11 +4466,37 @@ function normalizePublishedFrontMatter(frontMatter, sourcePath) {
     title: normalizeFrontMatterTitle(frontMatter.title, sourcePath),
     description: normalizeFrontMatterDescription(frontMatter.description, sourcePath),
     path: normalizeFrontMatterRoutePath(frontMatter.path, sourcePath),
+    last_updated: normalizeFrontMatterLastUpdated(frontMatter.last_updated, sourcePath),
     discoverability: normalizeFrontMatterDiscoverability(frontMatter.discoverability, sourcePath),
     meta: normalizeFrontMatterMeta(frontMatter.meta, sourcePath),
     data: normalizeFrontMatterData(frontMatter.data, sourcePath)
   };
 }
+function normalizeLastUpdatedPolicy(value, pathLabel, ErrorClass, sourcePath = null) {
+  if (value === void 0) {
+    return "none";
+  }
+  if (typeof value === "string" && MARKDOWN_LAST_UPDATED_VALUES.has(value)) {
+    return value;
+  }
+  if (ErrorClass === PrebuildMarkdownError) {
+    throw new ErrorClass(
+      sourcePath,
+      `${pathLabel} must be one of: ${Array.from(MARKDOWN_LAST_UPDATED_VALUES).join(", ")}.`,
+      "  last_updated: none\n  last_updated: git"
+    );
+  }
+  throw new ErrorClass(
+    `${pathLabel} must be one of: ${Array.from(MARKDOWN_LAST_UPDATED_VALUES).join(", ")}.`,
+    '  "markdown": { "last_updated": "none" }\n  "markdown": { "last_updated": "git" }'
+  );
+}
+function normalizeFrontMatterLastUpdated(value, sourcePath) {
+  if (value === void 0) {
+    return void 0;
+  }
+  return normalizeLastUpdatedPolicy(value, "front matter last_updated", PrebuildMarkdownError, sourcePath);
+}
 function normalizeFrontMatterTitle(value, sourcePath) {
   if (value === void 0) {
     return "";
@@ -4372,6 +4580,74 @@ function normalizeFrontMatterMeta(value, sourcePath) {
   }
   return meta;
 }
+async function buildPageMeta(sourcePath, frontMatter, markdownConfig) {
+  const meta = {
+    ...frontMatter.meta
+  };
+  if (hasManualLastUpdatedMeta(meta)) {
+    return meta;
+  }
+  const lastUpdatedPolicy = frontMatter.last_updated || markdownConfig.last_updated;
+  if (lastUpdatedPolicy !== "git") {
+    return meta;
+  }
+  const lastUpdatedIso = await readGitLastUpdatedIso(sourcePath);
+  if (!lastUpdatedIso) {
+    return meta;
+  }
+  return {
+    ...meta,
+    last_updated_iso: lastUpdatedIso,
+    last_updated: lastUpdatedIso.slice(0, 10)
+  };
+}
+function hasManualLastUpdatedMeta(meta) {
+  return Object.hasOwn(meta, "last_updated") || Object.hasOwn(meta, "last_updated_iso");
+}
+async function readGitLastUpdatedIso(sourcePath) {
+  const realSourcePath = await resolveRealPath(sourcePath);
+  const realRootDir = await resolveRealPath(rootDir);
+  const gitPath = path.relative(realRootDir, realSourcePath);
+  try {
+    const { stdout } = await execFileAsync("git", [
+      "-C",
+      realRootDir,
+      "log",
+      "-1",
+      "--format=%cI",
+      "--",
+      gitPath
+    ], {
+      encoding: "utf8"
+    });
+    const value = stdout.trim();
+    if (!value) {
+      warnGitLastUpdated(sourcePath, "no commit date was found for this file.");
+      return "";
+    }
+    if (!/^\d{4}-\d{2}-\d{2}T/.test(value)) {
+      warnGitLastUpdated(sourcePath, `unexpected git date output: ${value}`);
+      return "";
+    }
+    return value;
+  } catch (error) {
+    warnGitLastUpdated(sourcePath, error instanceof Error ? error.message : String(error));
+    return "";
+  }
+}
+async function resolveRealPath(value) {
+  try {
+    return await fs.realpath(value);
+  } catch {
+    return value;
+  }
+}
+function warnGitLastUpdated(sourcePath, reason) {
+  console.warn([
+    `[zeropress-build-pages] Warning: could not read git last_updated for ${formatSourcePath(sourcePath)}.`,
+    `Reason: ${reason}`
+  ].join("\n"));
+}
 function isPreviewMetaValue(value) {
   return value === null || typeof value === "string" || typeof value === "number" && Number.isFinite(value) || typeof value === "boolean";
 }
@@ -4589,9 +4865,11 @@ function buildRoutePath(relativeSourcePath, sourcePath, options2 = {}) {
   return routePath;
 }
 function buildSlug(routePath) {
-  const segments = routePath.split("/");
-  const rawSlug = segments.at(-1) === "index" && segments.length > 1 ? segments.at(-2) : segments.at(-1);
-  return sanitizePathSegment(rawSlug || "");
+  const segments = routePath.split("/").filter(Boolean);
+  if (segments.length > 1 && segments.at(-1) === "index") {
+    segments.pop();
+  }
+  return sanitizePathSegment(segments.join("-") || "index");
 }
 function sanitizePathSegment(segment) {
   return segment.replace(/[^a-z0-9.-]+/g, "-").replace(/^-+|-+$/g, "").replace(/-{2,}/g, "-");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zeropress/build-pages",
-  "version": "0.6.2",
+  "version": "0.6.4",
   "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.2",
+    "@zeropress/build": "0.6.4",
     "gray-matter": "4.0.3"
   },
   "devDependencies": {

package/schemas/zeropress-build-pages.config.v0.1.schema.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://zeropress.dev/schemas/zeropress-build-pages.config.v0.1.schema.json",
+  "$id": "https://schemas.zeropress.dev/build-pages-config/v0.1/schema.json",
   "title": "ZeroPress Build Pages Config v0.1",
   "description": "Optional source-directory configuration for @zeropress/build-pages workflows.",
   "markdownDescription": "Optional source-directory configuration for `@zeropress/build-pages` workflows.",
@@ -21,6 +21,9 @@
     "site": {
       "$ref": "#/$defs/site"
     },
+    "markdown": {
+      "$ref": "#/$defs/markdown"
+    },
     "front_page": {
       "$ref": "#/$defs/frontPage"
     },
@@ -29,6 +32,9 @@
     },
     "menus": {
       "$ref": "#/$defs/menus"
+    },
+    "collections": {
+      "$ref": "#/$defs/collections"
     }
   },
   "$defs": {
@@ -50,6 +56,15 @@
           "description": "Canonical site URL. Use an empty string or omit this field for local builds without canonical output.",
           "markdownDescription": "Canonical site URL. Use an empty string or omit this field for local builds without canonical output."
         },
+        "logo": {
+          "$ref": "#/$defs/siteLogo"
+        },
+        "locale": {
+          "type": "string",
+          "minLength": 2,
+          "description": "Site locale used for generated preview-data language metadata, such as html lang and feed language.",
+          "markdownDescription": "Site locale used for generated preview-data language metadata, such as HTML `lang` and feed language."
+        },
         "expose_generator": {
           "type": "boolean",
           "default": true,
@@ -70,6 +85,29 @@
         },
         "footer": {
           "$ref": "#/$defs/siteFooter"
+        },
+        "meta": {
+          "$ref": "#/$defs/previewMeta"
+        }
+      }
+    },
+    "siteLogo": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["src"],
+      "description": "Optional site logo data copied into generated preview-data.",
+      "markdownDescription": "Optional site logo data copied into generated preview-data.",
+      "properties": {
+        "src": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Logo URL or safe relative path.",
+          "markdownDescription": "Logo URL or safe relative path."
+        },
+        "alt": {
+          "type": "string",
+          "description": "Optional logo alternative text. Themes may fall back to site.title when omitted.",
+          "markdownDescription": "Optional logo alternative text. Themes may fall back to `site.title` when omitted."
         }
       }
     },
@@ -92,6 +130,21 @@
         }
       }
     },
+    "markdown": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "Markdown source processing options.",
+      "markdownDescription": "Markdown source processing options.",
+      "properties": {
+        "last_updated": {
+          "type": "string",
+          "enum": ["none", "git"],
+          "default": "none",
+          "description": "Optional page meta enrichment. none does not generate last_updated values; git reads the latest commit date for each Markdown file.",
+          "markdownDescription": "Optional page meta enrichment. `none` does not generate `last_updated` values; `git` reads the latest commit date for each Markdown file."
+        }
+      }
+    },
     "frontPage": {
       "type": "object",
       "additionalProperties": false,
@@ -287,23 +340,68 @@
           "default": []
         }
       }
+    },
+    "collections": {
+      "type": "object",
+      "description": "Reading-order collections generated from Markdown source paths.",
+      "markdownDescription": "Reading-order collections generated from Markdown source paths.",
+      "propertyNames": {
+        "type": "string",
+        "pattern": "^[a-z][a-z0-9_-]{0,63}$"
+      },
+      "additionalProperties": {
+        "$ref": "#/$defs/collection"
+      }
+    },
+    "collection": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["items"],
+      "properties": {
+        "title": {
+          "type": "string",
+          "minLength": 1
+        },
+        "description": {
+          "type": "string"
+        },
+        "items": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1,
+            "pattern": "^[^\\\\?#]+\\.md$"
+          }
+        }
+      }
     }
   },
   "examples": [
     {
-      "$schema": "https://zeropress.dev/schemas/zeropress-build-pages.config.v0.1.schema.json",
+      "$schema": "https://schemas.zeropress.dev/build-pages-config/v0.1/schema.json",
       "version": "0.1",
       "site": {
         "title": "ZeroPress Public Docs",
         "description": "Public documentation.",
         "url": "https://zeropress.dev",
+        "logo": {
+          "src": "/logo.svg",
+          "alt": "ZeroPress Public Docs"
+        },
+        "locale": "en-US",
         "expose_generator": true,
         "search": true,
-        "indexing": true
+        "indexing": true,
+        "meta": {
+          "issue": "Spring 2026"
+        }
       },
       "front_page": {
         "type": "markdown"
       },
+      "markdown": {
+        "last_updated": "git"
+      },
       "custom_html": {
         "head_end": {
           "file": ".zeropress/head-end.html"
@@ -327,6 +425,15 @@
             }
           ]
         }
+      },
+      "collections": {
+        "guides": {
+          "title": "Guides",
+          "items": [
+            "getting-started/index.md",
+            "deployment/index.md"
+          ]
+        }
       }
     }
   ]