@zeropress/build-core 0.7.5 → 0.7.6

package/README.md

@@ -118,7 +118,8 @@ Returns:
       size: 1234,
       sha256: '...'
     }
-  ]
+  ],
+  warnings: []
 }
 ```
 
@@ -145,6 +146,20 @@ This is useful for local tooling that wants filesystem theme loading but still u
 Theme validation failures from either build entry point carry `error.code === 'THEME_VALIDATION_FAILED'`.
 Their messages preserve report and hint line breaks while escaping terminal control characters in diagnostic values such as paths, messages, and source snippets. CLI consumers can preserve the layout of these reports while escaping arbitrary errors as single-line text.
 
+## Menu depth
+
+`theme.json.menu_slots.<menu_id>.max_depth` optionally limits rendered depth
+(top-level items are depth 1). Omission leaves that menu unchanged. Items at the
+limit remain, with empty `children`; deeper descendants are excluded, without
+changing Preview Data. Direct `menus.<id>.items` loops and `{{menu:<id>}}` use
+the same tree.
+
+Both build APIs always return `warnings`. A depth overrun produces one
+`MENU_MAX_DEPTH_EXCEEDED` warning per menu per build, containing `message`,
+`menuId`, `maxDepth`, `actualDepth`, and `omittedItems` (all excluded
+descendants). It does not fail the build. The library does not print warnings;
+callers decide how to display them.
+
 ## Writers
 
 ### `MemoryWriter`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zeropress/build-core",
-  "version": "0.7.5",
+  "version": "0.7.6",
   "description": "Shared ZeroPress build core",
   "type": "module",
   "license": "MIT",
@@ -39,7 +39,7 @@
   "dependencies": {
     "@zeropress/slug-policy": "0.2.2",
     "@zeropress/preview-data-validator": "0.7.4",
-    "@zeropress/theme-validator": "0.7.3",
+    "@zeropress/theme-validator": "0.7.4",
     "highlight.js": "11.12.0",
     "htmlparser2": "12.0.0",
     "markdown-it": "15.0.2",

package/src/api/build-site.js

@@ -7,6 +7,7 @@ import { renderDocument, renderDocumentContent } from '../render/content-rendere
 import { extractHtmlText } from '../render/html-text.js';
 import { createThemeValidationError } from '../theme/format-theme-validation.js';
 import { ZeroPressEngine } from '../render/zeropress-engine.js';
+import { prepareRenderMenus } from '../render/menus.js';
 
 const DEFAULT_OPTIONS = {
   assetHashing: true,
@@ -136,6 +137,7 @@ export async function buildSite(input) {
 
   return {
     files: state.summaries,
+    warnings: state.warnings,
   };
 }
 
@@ -151,6 +153,7 @@ async function createBuildState(input, options) {
   const assetProcessor = new AssetProcessor();
   const summaries = [];
   const previewData = normalizePreviewData(input.previewData, options);
+  const { menus, warnings } = prepareRenderMenus(previewData.menus, themePackage.metadata.menu_slots);
   const renderData = createRenderData(previewData, themePackage, options);
 
   engine.initialize(themePackage);
@@ -167,6 +170,8 @@ async function createBuildState(input, options) {
   return {
     writer: input.writer,
     previewData,
+    menus,
+    warnings,
     renderData,
     widgets: resolveWidgetAreas(previewData, renderData),
     engine,
@@ -214,7 +219,7 @@ async function renderRoute(state, templateName, route) {
   let html = await state.engine.render(
     templateName,
     {
-      menus: state.previewData.menus,
+      menus: state.menus,
       widgets: state.widgets,
       collections: state.renderData.collections,
       taxonomies: state.renderData.taxonomies,
@@ -267,7 +272,7 @@ async function renderFrontPage(state, route) {
     let html = await state.engine.render(
       'page',
       {
-        menus: state.previewData.menus,
+        menus: state.menus,
         widgets: state.widgets,
         collections: state.renderData.collections,
         taxonomies: state.renderData.taxonomies,
@@ -308,7 +313,7 @@ async function renderFrontPage(state, route) {
   let html = await state.engine.render(
     'index',
     {
-      menus: state.previewData.menus,
+      menus: state.menus,
       widgets: state.widgets,
       collections: state.renderData.collections,
       taxonomies: state.renderData.taxonomies,
@@ -343,7 +348,7 @@ async function renderPost(state, post) {
   let html = await state.engine.render(
     'post',
     {
-      menus: state.previewData.menus,
+      menus: state.menus,
       widgets: state.widgets,
       collections: state.renderData.collections,
       taxonomies: state.renderData.taxonomies,
@@ -391,7 +396,7 @@ async function renderPage(state, page) {
   let html = await state.engine.render(
     'page',
     {
-      menus: state.previewData.menus,
+      menus: state.menus,
       widgets: state.widgets,
       collections: state.renderData.collections,
       taxonomies: state.renderData.taxonomies,
@@ -437,7 +442,7 @@ async function maybeRenderNotFoundPage(state) {
   let html = await state.engine.render(
     '404',
     {
-      menus: state.previewData.menus,
+      menus: state.menus,
       widgets: state.widgets,
       collections: state.renderData.collections,
       taxonomies: state.renderData.taxonomies,

package/src/index.d.ts

@@ -80,8 +80,18 @@ export interface BuildSummaryFile {
   sha256: string;
 }
 
+export interface BuildWarning {
+  code: 'MENU_MAX_DEPTH_EXCEEDED';
+  message: string;
+  menuId: string;
+  maxDepth: number;
+  actualDepth: number;
+  omittedItems: number;
+}
+
 export interface BuildSiteResult {
   files: BuildSummaryFile[];
+  warnings: BuildWarning[];
 }
 
 export function buildSite(input: {

package/src/render/menus.js

@@ -0,0 +1,44 @@
+// Work on rendering copies only; validation and exported Preview Data keep the full tree.
+export function prepareRenderMenus(menus, slots = {}) {
+  const rendered = { ...menus };
+  const warnings = [];
+
+  for (const [menuId, slot] of Object.entries(slots)) {
+    if (slot.max_depth === undefined || !Object.hasOwn(menus, menuId)) continue;
+    const maxDepth = slot.max_depth;
+    const items = [];
+    const stack = [{ source: menus[menuId].items, output: items, depth: 1 }];
+    let actualDepth = 0;
+    let omittedItems = 0;
+
+    while (stack.length) {
+      const { source, output, depth } = stack.pop();
+      for (const item of source) {
+        actualDepth = Math.max(actualDepth, depth);
+        const children = [];
+        if (depth <= maxDepth) {
+          output.push({ ...item, children });
+        } else {
+          omittedItems += 1;
+        }
+        if (item.children.length) {
+          stack.push({ source: item.children, output: children, depth: depth + 1 });
+        }
+      }
+    }
+
+    rendered[menuId] = { ...menus[menuId], items };
+    if (omittedItems > 0) {
+      warnings.push({
+        code: 'MENU_MAX_DEPTH_EXCEEDED',
+        message: `Menu "${menuId}" reaches depth ${actualDepth}; the theme supports ${maxDepth}. ${omittedItems} deeper item(s) were omitted from rendering.`,
+        menuId,
+        maxDepth,
+        actualDepth,
+        omittedItems,
+      });
+    }
+  }
+
+  return { menus: rendered, warnings };
+}