@zeropress/build-pages 0.5.5 → 0.6.1

package/dist/prebuild.js

@@ -3534,7 +3534,12 @@ 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.5.schema.json";
+var PREVIEW_DATA_SCHEMA_URL = "https://zeropress.dev/schemas/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 PrebuildMarkdownError = class extends Error {
   constructor(sourcePath, reason, expected = "", code = "invalid_markdown") {
     super(reason);
@@ -3608,6 +3613,8 @@ async function main() {
       ...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),
@@ -3621,7 +3628,7 @@ async function main() {
   const customHtml = await buildCustomHtmlData(customHtmlConfig);
   const previewData = {
     $schema: PREVIEW_DATA_SCHEMA_URL,
-    version: "0.5",
+    version: "0.6",
     generator: "zeropress-build-pages",
     generated_at: (/* @__PURE__ */ new Date()).toISOString(),
     site,
@@ -3719,18 +3726,21 @@ function buildSiteData(config, frontPage) {
     title: configuredSite.title,
     description: configuredSite.description,
     url: configuredSite.url,
-    mediaBaseUrl: "",
+    media_base_url: "",
     locale: "en-US",
-    postsPerPage: 10,
-    dateFormat: "YYYY-MM-DD",
-    timeFormat: "HH:mm",
+    posts_per_page: 10,
+    datetime_display: "static",
+    date_style: "medium",
+    time_style: "none",
     timezone: "UTC",
     permalinks: defaultPermalinks(),
     front_page: frontPage,
     post_index: {
       enabled: false
     },
-    disallowComments: true
+    disallow_comments: true,
+    expose_generator: configuredSite.expose_generator !== false,
+    indexing: configuredSite.indexing !== false
   };
   if (configuredSite.footer) {
     site.footer = configuredSite.footer;
@@ -3758,11 +3768,13 @@ function normalizeSiteConfig(value) {
     );
   }
   const configuredSite = isPlainObject(value) ? value : {};
-  assertKnownConfigKeys(configuredSite, ["title", "description", "url", "footer"], "site");
+  assertKnownConfigKeys(configuredSite, ["title", "description", "url", "expose_generator", "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, ""))
+    url: readEnv("ZEROPRESS_SITE_URL", readConfigString(configuredSite.url, "")),
+    expose_generator: readConfigBoolean(configuredSite.expose_generator, true, "site.expose_generator"),
+    indexing: readConfigBoolean(configuredSite.indexing, true, "site.indexing")
   };
   const footer = normalizeFooter(configuredSite.footer);
   if (footer) {
@@ -3783,22 +3795,23 @@ function normalizeFooter(value) {
   if (copyrightText) {
     footer.copyright_text = copyrightText;
   }
-  if (value.attribution !== void 0 && !isPlainObject(value.attribution)) {
-    throw new PrebuildConfigError("site.footer.attribution must be an object.");
-  }
-  if (isPlainObject(value.attribution)) {
-    assertKnownConfigKeys(value.attribution, ["enabled"], "site.footer.attribution");
-    if (value.attribution.enabled !== void 0 && typeof value.attribution.enabled !== "boolean") {
-      throw new PrebuildConfigError("site.footer.attribution.enabled must be a boolean when provided.");
+  if (value.attribution !== void 0) {
+    if (typeof value.attribution !== "boolean") {
+      throw new PrebuildConfigError("site.footer.attribution must be a boolean when provided.");
     }
-  }
-  if (isPlainObject(value.attribution) && typeof value.attribution.enabled === "boolean") {
-    footer.attribution = {
-      enabled: value.attribution.enabled
-    };
+    footer.attribution = value.attribution;
   }
   return Object.keys(footer).length ? footer : void 0;
 }
+function readConfigBoolean(value, fallback, pathName) {
+  if (value === void 0) {
+    return fallback;
+  }
+  if (typeof value !== "boolean") {
+    throw new PrebuildConfigError(`${pathName} must be a boolean when provided.`);
+  }
+  return value;
+}
 async function buildFrontPageData(frontPageConfig, pageInputs, config) {
   if (frontPageConfig.type === "theme_index") {
     return {
@@ -4132,9 +4145,23 @@ function normalizeMenuItem(item, pathLabel) {
     url,
     type: readConfigString(item.type, "custom"),
     target: readConfigString(item.target, "_self"),
+    ...item.meta !== void 0 ? { meta: normalizeMenuItemMeta(item.meta, `${pathLabel}.meta`) } : {},
     children: Array.isArray(item.children) ? item.children.map((child, index) => normalizeMenuItem(child, `${pathLabel}.children[${index}]`)) : []
   };
 }
+function normalizeMenuItemMeta(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 defaultMenus() {
   return {
     primary: {
@@ -4251,7 +4278,9 @@ function normalizePublishedFrontMatter(frontMatter, sourcePath) {
     title: normalizeFrontMatterTitle(frontMatter.title, sourcePath),
     description: normalizeFrontMatterDescription(frontMatter.description, sourcePath),
     path: normalizeFrontMatterRoutePath(frontMatter.path, sourcePath),
-    meta: normalizeFrontMatterMeta(frontMatter.meta, sourcePath)
+    discoverability: normalizeFrontMatterDiscoverability(frontMatter.discoverability, sourcePath),
+    meta: normalizeFrontMatterMeta(frontMatter.meta, sourcePath),
+    data: normalizeFrontMatterData(frontMatter.data, sourcePath)
   };
 }
 function normalizeFrontMatterTitle(value, sourcePath) {
@@ -4294,11 +4323,24 @@ function normalizeFrontMatterRoutePath(value, sourcePath) {
     throw new PrebuildMarkdownError(
       sourcePath,
       "front matter path must be a safe generated route path.",
-      "  path: guides/install\n  path: spec/preview-data-v0.5"
+      "  path: guides/install\n  path: spec/preview-data-v0.6"
     );
   }
   return routePath;
 }
+function normalizeFrontMatterDiscoverability(value, sourcePath) {
+  if (value === void 0) {
+    return "default";
+  }
+  if (typeof value === "string" && FRONT_MATTER_DISCOVERABILITY_VALUES.has(value)) {
+    return value;
+  }
+  throw new PrebuildMarkdownError(
+    sourcePath,
+    `front matter discoverability must be one of: ${Array.from(FRONT_MATTER_DISCOVERABILITY_VALUES).join(", ")}.`,
+    "  discoverability: default\n  discoverability: noindex\n  discoverability: delist"
+  );
+}
 function isSafeRoutePathSegment(segment) {
   return /^[a-z0-9](?:[a-z0-9.-]*[a-z0-9])?$/.test(segment) && !segment.includes("..");
 }
@@ -4325,7 +4367,88 @@ function normalizeFrontMatterMeta(value, sourcePath) {
   return meta;
 }
 function isPreviewMetaValue(value) {
-  return value === null || typeof value === "string" || typeof value === "number" || typeof value === "boolean";
+  return value === null || typeof value === "string" || typeof value === "number" && Number.isFinite(value) || typeof value === "boolean";
+}
+function normalizeFrontMatterData(value, sourcePath) {
+  if (value === void 0) {
+    return void 0;
+  }
+  if (!isPlainObject(value)) {
+    throw new PrebuildMarkdownError(
+      sourcePath,
+      "front matter data must be an object when provided."
+    );
+  }
+  validateFrontMatterDataObject(value, sourcePath, "data", 0);
+  return value;
+}
+function validateFrontMatterDataValue(value, sourcePath, pathLabel, depth) {
+  if (value === null || typeof value === "string" || typeof value === "boolean") {
+    return;
+  }
+  if (typeof value === "number") {
+    if (!Number.isFinite(value)) {
+      throw new PrebuildMarkdownError(
+        sourcePath,
+        `front matter ${pathLabel} must be a finite number.`
+      );
+    }
+    return;
+  }
+  if (Array.isArray(value)) {
+    validateFrontMatterDataArray(value, sourcePath, pathLabel, depth);
+    return;
+  }
+  if (isPlainObject(value)) {
+    validateFrontMatterDataObject(value, sourcePath, pathLabel, depth);
+    return;
+  }
+  throw new PrebuildMarkdownError(
+    sourcePath,
+    `front matter ${pathLabel} must be JSON-safe structured data.`
+  );
+}
+function validateFrontMatterDataObject(object, sourcePath, pathLabel, depth) {
+  if (depth > FRONT_MATTER_DATA_MAX_DEPTH) {
+    throw new PrebuildMarkdownError(
+      sourcePath,
+      `front matter ${pathLabel} nesting must not exceed ${FRONT_MATTER_DATA_MAX_DEPTH} container levels.`
+    );
+  }
+  const entries = Object.entries(object);
+  if (entries.length > FRONT_MATTER_DATA_MAX_KEYS) {
+    throw new PrebuildMarkdownError(
+      sourcePath,
+      `front matter ${pathLabel} must not contain more than ${FRONT_MATTER_DATA_MAX_KEYS} keys.`
+    );
+  }
+  for (const [key, dataValue] of entries) {
+    const childLabel = `${pathLabel}.${key}`;
+    if (!FRONT_MATTER_DATA_KEY_PATTERN.test(key)) {
+      throw new PrebuildMarkdownError(
+        sourcePath,
+        `front matter ${childLabel} uses an invalid key.`
+      );
+    }
+    validateFrontMatterDataValue(dataValue, sourcePath, childLabel, depth + 1);
+  }
+}
+function validateFrontMatterDataArray(array, sourcePath, pathLabel, depth) {
+  if (depth > FRONT_MATTER_DATA_MAX_DEPTH) {
+    throw new PrebuildMarkdownError(
+      sourcePath,
+      `front matter ${pathLabel} nesting must not exceed ${FRONT_MATTER_DATA_MAX_DEPTH} container levels.`
+    );
+  }
+  if (array.length > FRONT_MATTER_DATA_MAX_ARRAY_LENGTH) {
+    throw new PrebuildMarkdownError(
+      sourcePath,
+      `front matter ${pathLabel} must not contain more than ${FRONT_MATTER_DATA_MAX_ARRAY_LENGTH} items.`
+    );
+  }
+  array.forEach((dataValue, index) => {
+    validateFrontMatterDataValue(dataValue, sourcePath, `${pathLabel}[${index}]`, depth + 1);
+  });
 }
 function formatFrontMatterValue(value) {
   if (typeof value === "string") {

package/package.json

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

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

@@ -50,6 +50,18 @@
           "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."
         },
+        "expose_generator": {
+          "type": "boolean",
+          "default": true,
+          "description": "Whether generated HTML should expose the ZeroPress generator meta tag. Set false for white-label sites.",
+          "markdownDescription": "Whether generated HTML should expose `<meta name=\"generator\" content=\"ZeroPress\">`. Set `false` for white-label sites."
+        },
+        "indexing": {
+          "type": "boolean",
+          "default": true,
+          "description": "Fallback robots.txt indexing policy. Missing or true allows indexing; false writes a fallback robots.txt that disallows all agents unless the source directory provides robots.txt.",
+          "markdownDescription": "Fallback `robots.txt` indexing policy. Missing or `true` allows indexing; `false` writes a fallback `robots.txt` that disallows all agents unless the source directory provides `robots.txt`."
+        },
         "footer": {
           "$ref": "#/$defs/siteFooter"
         }
@@ -68,17 +80,6 @@
           "markdownDescription": "Footer copyright or legal text. ZeroPress does not add a copyright symbol automatically."
         },
         "attribution": {
-          "$ref": "#/$defs/siteFooterAttribution"
-        }
-      }
-    },
-    "siteFooterAttribution": {
-      "type": "object",
-      "additionalProperties": false,
-      "description": "Optional ZeroPress attribution display policy for themes.",
-      "markdownDescription": "Optional ZeroPress attribution display policy for themes.",
-      "properties": {
-        "enabled": {
           "type": "boolean",
           "description": "When false, bundled themes hide the Published with ZeroPress attribution. Missing or true means attribution may be shown.",
           "markdownDescription": "When `false`, bundled themes hide the Published with ZeroPress attribution. Missing or `true` means attribution may be shown."
@@ -221,6 +222,12 @@
         "$ref": "#/$defs/menu"
       }
     },
+    "previewMeta": {
+      "type": "object",
+      "additionalProperties": {
+        "type": ["string", "number", "boolean", "null"]
+      }
+    },
     "menu": {
       "type": "object",
       "additionalProperties": false,
@@ -242,6 +249,8 @@
       "type": "object",
       "additionalProperties": false,
       "required": ["title", "url"],
+      "description": "Menu item copied into generated preview-data.",
+      "markdownDescription": "Menu item copied into generated preview-data.",
       "properties": {
         "title": {
           "type": "string",
@@ -261,6 +270,9 @@
           "enum": ["_self", "_blank"],
           "default": "_self"
         },
+        "meta": {
+          "$ref": "#/$defs/previewMeta"
+        },
         "children": {
           "type": "array",
           "items": {
@@ -273,12 +285,14 @@
   },
   "examples": [
     {
-      "$schema": "../schemas/zeropress-build-pages.config.v0.1.schema.json",
+      "$schema": "https://zeropress.dev/schemas/zeropress-build-pages.config.v0.1.schema.json",
       "version": "0.1",
       "site": {
         "title": "ZeroPress Public Docs",
         "description": "Public documentation.",
-        "url": "https://zeropress.dev"
+        "url": "https://zeropress.dev",
+        "expose_generator": true,
+        "indexing": true
       },
       "front_page": {
         "type": "markdown"
@@ -296,7 +310,14 @@
           "name": "Primary Menu",
           "items": [
             { "title": "Home", "url": "/" },
-            { "title": "Docs", "url": "/docs/" }
+            {
+              "title": "Docs",
+              "url": "/docs/",
+              "meta": {
+                "icon": "book-open",
+                "badge": "New"
+              }
+            }
           ]
         }
       }

package/src/action.js

@@ -21,7 +21,7 @@ try {
 }
 
 function input(name) {
-  return process.env[`INPUT_${name.toUpperCase().replace(/-/g, '_')}`]?.trim() || '';
+  return process.env[`INPUT_${name.toUpperCase()}`]?.trim() || '';
 }
 
 function booleanInput(name, fallback) {

package/src/prebuild.js

@@ -16,7 +16,12 @@ const skipUntitledMarkdown = readBooleanEnv('ZEROPRESS_SKIP_UNTITLED_MARKDOWN');
 const copyMarkdownSource = readBooleanEnv('ZEROPRESS_COPY_MARKDOWN_SOURCE', true);
 const FRONT_PAGE_TYPES = new Set(['theme_index', 'markdown', 'html']);
 const BUILD_PAGES_CONFIG_SCHEMA_URL = 'https://zeropress.dev/schemas/zeropress-build-pages.config.v0.1.schema.json';
-const PREVIEW_DATA_SCHEMA_URL = 'https://zeropress.dev/schemas/preview-data.v0.5.schema.json';
+const PREVIEW_DATA_SCHEMA_URL = 'https://zeropress.dev/schemas/preview-data.v0.6.schema.json';
+const FRONT_MATTER_DATA_KEY_PATTERN = /^[a-zA-Z_][a-zA-Z0-9_]*(?:-[a-zA-Z0-9_]+)*$/;
+const FRONT_MATTER_DATA_MAX_DEPTH = 4;
+const FRONT_MATTER_DATA_MAX_KEYS = 64;
+const FRONT_MATTER_DATA_MAX_ARRAY_LENGTH = 256;
+const FRONT_MATTER_DISCOVERABILITY_VALUES = new Set(['default', 'noindex', 'delist']);
 
 class PrebuildMarkdownError extends Error {
   constructor(sourcePath, reason, expected = '', code = 'invalid_markdown') {
@@ -99,6 +104,8 @@ async function main() {
       ...frontMatter.meta,
       ...(copyMarkdownSource ? { source_markdown_url: buildSourceMarkdownUrl(sourcePath) } : {}),
     },
+    ...(frontMatter.data !== undefined ? { data: frontMatter.data } : {}),
+    ...(frontMatter.discoverability !== 'default' ? { discoverability: frontMatter.discoverability } : {}),
     content: rewriteMarkdownLinks(bodyMarkdown, sourcePath, routeBySourcePath),
     document_type: 'markdown',
     excerpt: frontMatter.description || extractExcerpt(bodyMarkdown, title),
@@ -115,7 +122,7 @@ async function main() {
 
   const previewData = {
     $schema: PREVIEW_DATA_SCHEMA_URL,
-    version: '0.5',
+    version: '0.6',
     generator: 'zeropress-build-pages',
     generated_at: new Date().toISOString(),
     site,
@@ -222,18 +229,21 @@ function buildSiteData(config, frontPage) {
     title: configuredSite.title,
     description: configuredSite.description,
     url: configuredSite.url,
-    mediaBaseUrl: '',
+    media_base_url: '',
     locale: 'en-US',
-    postsPerPage: 10,
-    dateFormat: 'YYYY-MM-DD',
-    timeFormat: 'HH:mm',
+    posts_per_page: 10,
+    datetime_display: 'static',
+    date_style: 'medium',
+    time_style: 'none',
     timezone: 'UTC',
     permalinks: defaultPermalinks(),
     front_page: frontPage,
     post_index: {
       enabled: false,
     },
-    disallowComments: true,
+    disallow_comments: true,
+    expose_generator: configuredSite.expose_generator !== false,
+    indexing: configuredSite.indexing !== false,
   };
 
   if (configuredSite.footer) {
@@ -268,11 +278,13 @@ function normalizeSiteConfig(value) {
   }
 
   const configuredSite = isPlainObject(value) ? value : {};
-  assertKnownConfigKeys(configuredSite, ['title', 'description', 'url', 'footer'], 'site');
+  assertKnownConfigKeys(configuredSite, ['title', 'description', 'url', 'expose_generator', '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'),
+    indexing: readConfigBoolean(configuredSite.indexing, true, 'site.indexing'),
   };
 
   const footer = normalizeFooter(configuredSite.footer);
@@ -298,24 +310,26 @@ function normalizeFooter(value) {
     footer.copyright_text = copyrightText;
   }
 
-  if (value.attribution !== undefined && !isPlainObject(value.attribution)) {
-    throw new PrebuildConfigError('site.footer.attribution must be an object.');
-  }
-  if (isPlainObject(value.attribution)) {
-    assertKnownConfigKeys(value.attribution, ['enabled'], 'site.footer.attribution');
-    if (value.attribution.enabled !== undefined && typeof value.attribution.enabled !== 'boolean') {
-      throw new PrebuildConfigError('site.footer.attribution.enabled must be a boolean when provided.');
+  if (value.attribution !== undefined) {
+    if (typeof value.attribution !== 'boolean') {
+      throw new PrebuildConfigError('site.footer.attribution must be a boolean when provided.');
     }
-  }
-  if (isPlainObject(value.attribution) && typeof value.attribution.enabled === 'boolean') {
-    footer.attribution = {
-      enabled: value.attribution.enabled,
-    };
+    footer.attribution = value.attribution;
   }
 
   return Object.keys(footer).length ? footer : undefined;
 }
 
+function readConfigBoolean(value, fallback, pathName) {
+  if (value === undefined) {
+    return fallback;
+  }
+  if (typeof value !== 'boolean') {
+    throw new PrebuildConfigError(`${pathName} must be a boolean when provided.`);
+  }
+  return value;
+}
+
 async function buildFrontPageData(frontPageConfig, pageInputs, config) {
   if (frontPageConfig.type === 'theme_index') {
     return {
@@ -700,12 +714,29 @@ function normalizeMenuItem(item, pathLabel) {
     url,
     type: readConfigString(item.type, 'custom'),
     target: readConfigString(item.target, '_self'),
+    ...(item.meta !== undefined ? { meta: normalizeMenuItemMeta(item.meta, `${pathLabel}.meta`) } : {}),
     children: Array.isArray(item.children)
       ? item.children.map((child, index) => normalizeMenuItem(child, `${pathLabel}.children[${index}]`))
       : [],
   };
 }
 
+function normalizeMenuItemMeta(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 defaultMenus() {
   return {
     primary: {
@@ -832,7 +863,9 @@ function normalizePublishedFrontMatter(frontMatter, sourcePath) {
     title: normalizeFrontMatterTitle(frontMatter.title, sourcePath),
     description: normalizeFrontMatterDescription(frontMatter.description, sourcePath),
     path: normalizeFrontMatterRoutePath(frontMatter.path, sourcePath),
+    discoverability: normalizeFrontMatterDiscoverability(frontMatter.discoverability, sourcePath),
     meta: normalizeFrontMatterMeta(frontMatter.meta, sourcePath),
+    data: normalizeFrontMatterData(frontMatter.data, sourcePath),
   };
 }
 
@@ -888,13 +921,28 @@ function normalizeFrontMatterRoutePath(value, sourcePath) {
     throw new PrebuildMarkdownError(
       sourcePath,
       'front matter path must be a safe generated route path.',
-      '  path: guides/install\n  path: spec/preview-data-v0.5',
+      '  path: guides/install\n  path: spec/preview-data-v0.6',
     );
   }
 
   return routePath;
 }
 
+function normalizeFrontMatterDiscoverability(value, sourcePath) {
+  if (value === undefined) {
+    return 'default';
+  }
+  if (typeof value === 'string' && FRONT_MATTER_DISCOVERABILITY_VALUES.has(value)) {
+    return value;
+  }
+
+  throw new PrebuildMarkdownError(
+    sourcePath,
+    `front matter discoverability must be one of: ${Array.from(FRONT_MATTER_DISCOVERABILITY_VALUES).join(', ')}.`,
+    '  discoverability: default\n  discoverability: noindex\n  discoverability: delist',
+  );
+}
+
 function isSafeRoutePathSegment(segment) {
   return (
     /^[a-z0-9](?:[a-z0-9.-]*[a-z0-9])?$/.test(segment)
@@ -931,11 +979,102 @@ function isPreviewMetaValue(value) {
   return (
     value === null
     || typeof value === 'string'
-    || typeof value === 'number'
+    || (typeof value === 'number' && Number.isFinite(value))
     || typeof value === 'boolean'
   );
 }
 
+function normalizeFrontMatterData(value, sourcePath) {
+  if (value === undefined) {
+    return undefined;
+  }
+  if (!isPlainObject(value)) {
+    throw new PrebuildMarkdownError(
+      sourcePath,
+      'front matter data must be an object when provided.',
+    );
+  }
+
+  validateFrontMatterDataObject(value, sourcePath, 'data', 0);
+  return value;
+}
+
+function validateFrontMatterDataValue(value, sourcePath, pathLabel, depth) {
+  if (value === null || typeof value === 'string' || typeof value === 'boolean') {
+    return;
+  }
+  if (typeof value === 'number') {
+    if (!Number.isFinite(value)) {
+      throw new PrebuildMarkdownError(
+        sourcePath,
+        `front matter ${pathLabel} must be a finite number.`,
+      );
+    }
+    return;
+  }
+  if (Array.isArray(value)) {
+    validateFrontMatterDataArray(value, sourcePath, pathLabel, depth);
+    return;
+  }
+  if (isPlainObject(value)) {
+    validateFrontMatterDataObject(value, sourcePath, pathLabel, depth);
+    return;
+  }
+
+  throw new PrebuildMarkdownError(
+    sourcePath,
+    `front matter ${pathLabel} must be JSON-safe structured data.`,
+  );
+}
+
+function validateFrontMatterDataObject(object, sourcePath, pathLabel, depth) {
+  if (depth > FRONT_MATTER_DATA_MAX_DEPTH) {
+    throw new PrebuildMarkdownError(
+      sourcePath,
+      `front matter ${pathLabel} nesting must not exceed ${FRONT_MATTER_DATA_MAX_DEPTH} container levels.`,
+    );
+  }
+
+  const entries = Object.entries(object);
+  if (entries.length > FRONT_MATTER_DATA_MAX_KEYS) {
+    throw new PrebuildMarkdownError(
+      sourcePath,
+      `front matter ${pathLabel} must not contain more than ${FRONT_MATTER_DATA_MAX_KEYS} keys.`,
+    );
+  }
+
+  for (const [key, dataValue] of entries) {
+    const childLabel = `${pathLabel}.${key}`;
+    if (!FRONT_MATTER_DATA_KEY_PATTERN.test(key)) {
+      throw new PrebuildMarkdownError(
+        sourcePath,
+        `front matter ${childLabel} uses an invalid key.`,
+      );
+    }
+    validateFrontMatterDataValue(dataValue, sourcePath, childLabel, depth + 1);
+  }
+}
+
+function validateFrontMatterDataArray(array, sourcePath, pathLabel, depth) {
+  if (depth > FRONT_MATTER_DATA_MAX_DEPTH) {
+    throw new PrebuildMarkdownError(
+      sourcePath,
+      `front matter ${pathLabel} nesting must not exceed ${FRONT_MATTER_DATA_MAX_DEPTH} container levels.`,
+    );
+  }
+
+  if (array.length > FRONT_MATTER_DATA_MAX_ARRAY_LENGTH) {
+    throw new PrebuildMarkdownError(
+      sourcePath,
+      `front matter ${pathLabel} must not contain more than ${FRONT_MATTER_DATA_MAX_ARRAY_LENGTH} items.`,
+    );
+  }
+
+  array.forEach((dataValue, index) => {
+    validateFrontMatterDataValue(dataValue, sourcePath, `${pathLabel}[${index}]`, depth + 1);
+  });
+}
+
 function formatFrontMatterValue(value) {
   if (typeof value === 'string') {
     return `"${value}"`;

package/themes/docs/layout.html

@@ -28,7 +28,7 @@
         {{#else_if site.title}}
           <p>{{site.title}}</p>
         {{/if}}
-        {{#if site.footer.attribution.enabled}}
+        {{#if site.footer.attribution}}
           <p>Published with <a href="https://zeropress.app" target="_blank" rel="noreferrer noopener">ZeroPress</a>.</p>
         {{/if}}
       </div>