@zeropress/build-pages 0.6.2 → 0.6.3

package/dist/prebuild.js

@@ -3534,8 +3534,8 @@ 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;
@@ -3729,7 +3729,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,6 +3745,12 @@ 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;
   }
@@ -3771,21 +3777,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 +3875,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;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zeropress/build-pages",
-  "version": "0.6.2",
+  "version": "0.6.3",
   "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.3",
     "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.",
@@ -50,6 +50,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 +79,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."
         }
       }
     },
@@ -291,15 +323,23 @@
   },
   "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"

package/src/prebuild.js

@@ -16,8 +16,8 @@ const buildReportPath = path.join(outDir, 'build-report.json');
 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.6.schema.json';
+const BUILD_PAGES_CONFIG_SCHEMA_URL = 'https://schemas.zeropress.dev/build-pages-config/v0.1/schema.json';
+const PREVIEW_DATA_SCHEMA_URL = 'https://schemas.zeropress.dev/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;
@@ -232,7 +232,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',
@@ -249,6 +249,14 @@ function buildSiteData(config, frontPage) {
     indexing: configuredSite.indexing !== false,
   };
 
+  if (configuredSite.logo) {
+    site.logo = configuredSite.logo;
+  }
+
+  if (configuredSite.meta !== undefined) {
+    site.meta = configuredSite.meta;
+  }
+
   if (configuredSite.footer) {
     site.footer = configuredSite.footer;
   }
@@ -281,24 +289,98 @@ 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 !== undefined) {
+    site.meta = normalizeSiteMeta(configuredSite.meta, 'site.meta');
+  }
+
   return site;
 }
 
+function normalizeSiteLocale(value) {
+  if (value === undefined) {
+    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 === undefined) {
+    return undefined;
+  }
+  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 !== undefined) {
+    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 === undefined) {
     return undefined;
@@ -324,6 +406,25 @@ function normalizeFooter(value) {
   return Object.keys(footer).length ? footer : undefined;
 }
 
+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 === undefined) {
     return fallback;

package/themes/docs/404.html

@@ -1,6 +1,17 @@
 <section class="shell not-found">
-  <p class="eyebrow">404</p>
+  <p class="eyebrow eyebrow--error">
+    <span class="eyebrow__dot" aria-hidden="true"></span>
+    404
+  </p>
   <h1>Page not found</h1>
   <p class="lede">The page you are looking for is not part of the current documentation build.</p>
-  <a class="button-link" href="/">Return home</a>
+  <div class="hero__actions">
+    <a class="button-link" href="/">
+      Return home
+      <svg viewBox="0 0 24 24" width="16" height="16" fill="none" stroke="currentColor" stroke-width="2.2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true">
+        <line x1="5" y1="12" x2="19" y2="12"></line>
+        <polyline points="12 5 19 12 12 19"></polyline>
+      </svg>
+    </a>
+  </div>
 </section>