@zeropress/build-core 0.5.1 → 0.5.2

package/README.md

@@ -54,7 +54,7 @@ import {
 - generating special files such as:
   - `sitemap.xml`
   - `feed.xml`
-  - `robots.txt`
+  - fallback `robots.txt`
 - writing outputs through a pluggable writer
 
 It does not:
@@ -119,7 +119,9 @@ Notes:
 - `previewData` must already satisfy the canonical preview-data contract
 - `themePackage` must already be a validated in-memory theme package
 - `sitemap.xml` and `feed.xml` are emitted only when `site.url` is a non-empty canonical URL
-- `robots.txt` is still emitted when `generateSpecialFiles` is enabled
+- fallback `robots.txt` is emitted when `generateSpecialFiles` is enabled and `generateRobotsTxt` is not `false`
+- fallback `robots.txt` uses `site.indexing`; `false` emits `Disallow: /`, while missing or `true` emits `Allow: /`
+- callers that disable fallback robots because a public `robots.txt` exists should copy that file as-is; sitemap directives in custom robots files are caller/user responsibility
 
 ### `buildSiteFromThemeDir(input)`
 
@@ -175,6 +177,8 @@ Theme validation is enforced through:
 
 `buildSiteFromThemeDir()` is the convenience entry point that loads a theme directory and converts it into the required in-memory `themePackage`.
 
+JavaScript theme assets are emitted as provided. Build-core may hash output filenames, but it does not rewrite or minify JavaScript content.
+
 As of `preview-data v0.4`, the payload no longer carries `routes` arrays or raw HTML fragments such as `categories_html`.
 
 Build-core now derives:
@@ -219,6 +223,7 @@ Supported options:
 
 - `assetHashing`
 - `generateSpecialFiles`
+- `generateRobotsTxt`
 - `writeManifest`
 
 These options apply to both full builds and partial renders where relevant.
@@ -227,6 +232,7 @@ Defaults:
 
 - `assetHashing: true`
 - `generateSpecialFiles: true`
+- `generateRobotsTxt: true`
 - `writeManifest: false`
 
 ---

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zeropress/build-core",
-  "version": "0.5.1",
+  "version": "0.5.2",
   "description": "Shared ZeroPress build core",
   "type": "module",
   "license": "MIT",
@@ -33,9 +33,9 @@
     "node": ">=18.18.0"
   },
   "dependencies": {
-    "@zeropress/slug-policy": "^0.1.0",
-    "@zeropress/preview-data-validator": "0.5.1",
-    "@zeropress/theme-validator": "0.5.2",
+    "@zeropress/slug-policy": "0.1.0",
+    "@zeropress/preview-data-validator": "0.5.2",
+    "@zeropress/theme-validator": "0.5.3",
     "highlight.js": "^11.11.1",
     "markdown-it": "^14.1.0",
     "markdown-it-anchor": "^9.2.0"

package/src/api/build-site.js

@@ -9,6 +9,7 @@ import { ZeroPressEngine } from '../render/zeropress-engine.js';
 const DEFAULT_OPTIONS = {
   assetHashing: true,
   generateSpecialFiles: true,
+  generateRobotsTxt: true,
   writeManifest: false,
 };
 
@@ -37,6 +38,9 @@ const COMMENT_POLICY_OUTPUT_PATH = '_zeropress/comment-policy.json';
 const OUTPUT_PATH_CONTROL_CHAR_PATTERN = /[\u0000-\u001F\u007F]/;
 const SAFE_MEDIA_PROTOCOLS = new Set(['http:', 'https:']);
 const SAFE_LINK_PROTOCOLS = new Set(['http:', 'https:', 'mailto:', 'tel:']);
+const MEDIA_DELIVERY_MODES = new Set(['none', 'media_domain']);
+const RESPONSIVE_IMAGE_WIDTHS = [320, 480, 768, 1024, 1280, 1600, 1920];
+const RESPONSIVE_IMAGE_EXTENSIONS = new Set(['jpg', 'jpeg', 'png', 'webp', 'avif']);
 export async function buildSite(input) {
   const options = { ...DEFAULT_OPTIONS, ...(input.options || {}) };
   const state = await createBuildState(input, options);
@@ -94,7 +98,9 @@ export async function buildSite(input) {
       await writeOutput(state.writer, state.summaries, 'sitemap.xml', buildSitemapXml(state.previewData.site, state.emitted, state.generatedAt), 'application/xml');
       await writeOutput(state.writer, state.summaries, 'feed.xml', buildFeedXml(state.previewData.site, state.emitted, state.generatedAt), 'application/rss+xml');
     }
-    await writeOutput(state.writer, state.summaries, 'robots.txt', buildRobotsTxt(state.previewData.site), 'text/plain');
+    if (shouldGenerateRobotsTxt(options)) {
+      await writeOutput(state.writer, state.summaries, 'robots.txt', buildRobotsTxt(state.previewData.site), 'text/plain');
+    }
   }
 
   return finalizeBuildResult(state.writer, state.summaries, options);
@@ -111,7 +117,7 @@ async function createBuildState(input, options) {
   const engine = new ZeroPressEngine();
   const assetProcessor = new AssetProcessor();
   const summaries = [];
-  const previewData = normalizePreviewData(input.previewData);
+  const previewData = normalizePreviewData(input.previewData, options);
   const renderData = createRenderData(previewData, themePackage.metadata);
 
   engine.initialize(themePackage);
@@ -137,6 +143,7 @@ async function createBuildState(input, options) {
     assetMap,
     customCssHref: customCssAsset ? `/${customCssAsset.path}` : '',
     customHtml: previewData.custom_html,
+    favicon: previewData.site.favicon,
     commentPolicyContent: buildCommentPolicyManifest(renderData.posts),
     options,
     generatedAt: new Date(),
@@ -197,6 +204,7 @@ async function renderRoute(state, templateName, route) {
     {
       menus: state.previewData.menus,
       widgets: state.widgets,
+      collections: state.renderData.collections,
       taxonomies: state.renderData.taxonomies,
       ...route,
       route: routeContext,
@@ -243,6 +251,7 @@ async function renderFrontPage(state, route) {
       {
         menus: state.previewData.menus,
         widgets: state.widgets,
+        collections: state.renderData.collections,
         taxonomies: state.renderData.taxonomies,
         page,
         route: routeContext,
@@ -273,6 +282,7 @@ async function renderFrontPage(state, route) {
     {
       menus: state.previewData.menus,
       widgets: state.widgets,
+      collections: state.renderData.collections,
       taxonomies: state.renderData.taxonomies,
       ...route,
       route: routeContext,
@@ -303,6 +313,7 @@ async function renderPost(state, post) {
     {
       menus: state.previewData.menus,
       widgets: state.widgets,
+      collections: state.renderData.collections,
       taxonomies: state.renderData.taxonomies,
       post,
       route: buildRouteContext('post', currentUrl),
@@ -340,6 +351,7 @@ async function renderPage(state, page) {
     {
       menus: state.previewData.menus,
       widgets: state.widgets,
+      collections: state.renderData.collections,
       taxonomies: state.renderData.taxonomies,
       page,
       route: buildRouteContext('page', currentUrl),
@@ -376,6 +388,7 @@ async function maybeRenderNotFoundPage(state) {
     {
       menus: state.previewData.menus,
       widgets: state.widgets,
+      collections: state.renderData.collections,
       taxonomies: state.renderData.taxonomies,
       route: buildRouteContext('not_found', '/404.html'),
       meta: buildPageMeta(state.previewData.site, {
@@ -392,10 +405,14 @@ async function maybeRenderNotFoundPage(state) {
   await writeOutput(state.writer, state.summaries, '404.html', html, 'text/html');
 }
 
-function normalizePreviewData(previewData) {
+function normalizePreviewData(previewData, options = {}) {
   const normalizedSite = {
     ...previewData.site,
     mediaBaseUrl: normalizeOptionalString(previewData.site.mediaBaseUrl),
+    mediaDeliveryMode: MEDIA_DELIVERY_MODES.has(previewData.site.mediaDeliveryMode)
+      ? previewData.site.mediaDeliveryMode
+      : 'none',
+    favicon: normalizeSiteFavicon(previewData.site.favicon || options.favicon),
     postsPerPage: Number.isInteger(previewData.site.postsPerPage) && previewData.site.postsPerPage > 0
       ? previewData.site.postsPerPage
       : DEFAULT_POSTS_PER_PAGE,
@@ -404,42 +421,195 @@ function normalizePreviewData(previewData) {
     timezone: normalizeNonEmptyString(previewData.site.timezone, DEFAULT_TIMEZONE),
     locale: normalizeLocale(previewData.site.locale || DEFAULT_LOCALE),
     disallowComments: previewData.site.disallowComments === true,
+    indexing: previewData.site.indexing !== false,
     permalinks: normalizePermalinks(previewData.site.permalinks),
     front_page: normalizeFrontPage(previewData.site.front_page),
     post_index: normalizePostIndex(previewData.site.post_index),
     footer: normalizeSiteFooter(previewData.site.footer),
   };
+  const media = normalizeContentMedia(previewData.content.media, normalizedSite);
+  const mediaRegistry = buildMediaRegistry(media);
 
   return {
     ...previewData,
     site: normalizedSite,
+    menus: normalizeRecordMap(previewData.menus),
+    collections: normalizeCollections(previewData.collections),
     widgets: normalizeWidgetAreas(previewData.widgets, normalizedSite.mediaBaseUrl),
     custom_css: normalizeCustomCss(previewData.custom_css),
     custom_html: normalizeCustomHtml(previewData.custom_html),
     content: {
       ...previewData.content,
-      authors: previewData.content.authors.map((author) => ({
-        ...author,
-        avatar: normalizeMediaField(author.avatar, normalizedSite.mediaBaseUrl),
-      })),
+      authors: previewData.content.authors.map((author) => {
+        const avatar = normalizeMediaField(author.avatar, normalizedSite.mediaBaseUrl);
+        const avatarMedia = deriveManagedMedia(avatar, mediaRegistry, normalizedSite);
+        return {
+          ...author,
+          avatar,
+          ...(avatarMedia ? { avatar_media: avatarMedia } : {}),
+        };
+      }),
       posts: previewData.content.posts
-        .map((post) => ({
-          ...post,
-          published_at_iso: normalizeIsoTimestamp(post.published_at_iso),
-          updated_at_iso: normalizeIsoTimestamp(post.updated_at_iso),
-          featured_image: normalizeMediaField(post.featured_image, normalizedSite.mediaBaseUrl),
-        }))
+        .map((post) => {
+          const featuredImage = normalizeMediaField(post.featured_image, normalizedSite.mediaBaseUrl);
+          const featuredMedia = deriveManagedMedia(featuredImage, mediaRegistry, normalizedSite);
+          return {
+            ...post,
+            published_at_iso: normalizeIsoTimestamp(post.published_at_iso),
+            updated_at_iso: normalizeIsoTimestamp(post.updated_at_iso),
+            featured_image: featuredImage,
+            ...(featuredMedia ? { featured_media: featuredMedia } : {}),
+          };
+        })
         .sort((left, right) => toDate(right.published_at_iso).getTime() - toDate(left.published_at_iso).getTime()),
-      pages: previewData.content.pages.map((page) => ({
-        ...page,
-        featured_image: normalizeMediaField(page.featured_image, normalizedSite.mediaBaseUrl),
-      })),
+      pages: previewData.content.pages.map((page) => {
+        const featuredImage = normalizeMediaField(page.featured_image, normalizedSite.mediaBaseUrl);
+        const featuredMedia = deriveManagedMedia(featuredImage, mediaRegistry, normalizedSite);
+        return {
+          ...page,
+          featured_image: featuredImage,
+          ...(featuredMedia ? { featured_media: featuredMedia } : {}),
+        };
+      }),
       categories: [...previewData.content.categories],
       tags: [...previewData.content.tags],
+      media,
     },
   };
 }
 
+function normalizeRecordMap(value) {
+  if (!value || typeof value !== 'object' || Array.isArray(value)) {
+    return {};
+  }
+
+  return { ...value };
+}
+
+function normalizeContentMedia(mediaItems, site) {
+  if (!Array.isArray(mediaItems)) {
+    return [];
+  }
+
+  return mediaItems
+    .map((item) => {
+      if (!item || typeof item !== 'object') {
+        return null;
+      }
+      const src = normalizeMediaField(item.src, site.mediaBaseUrl);
+      const width = Number.isInteger(item.width) && item.width > 0 ? item.width : 0;
+      const height = Number.isInteger(item.height) && item.height > 0 ? item.height : 0;
+      if (!src || !width || !height) {
+        return null;
+      }
+      return {
+        src,
+        width,
+        height,
+        alt: typeof item.alt === 'string' ? item.alt : '',
+      };
+    })
+    .filter(Boolean);
+}
+
+function buildMediaRegistry(mediaItems) {
+  const registry = new Map();
+  for (const item of mediaItems) {
+    if (!registry.has(item.src)) {
+      registry.set(item.src, item);
+    }
+  }
+  return registry;
+}
+
+function deriveManagedMedia(src, mediaRegistry, site) {
+  const normalizedSrc = normalizeOptionalString(src);
+  if (!normalizedSrc) {
+    return null;
+  }
+  const media = mediaRegistry.get(normalizedSrc);
+  if (!media) {
+    return null;
+  }
+  return {
+    ...media,
+    srcset: buildResponsiveImageSrcset(media, site),
+  };
+}
+
+function buildResponsiveImageSrcset(media, site) {
+  if (site.mediaDeliveryMode !== 'media_domain') {
+    return '';
+  }
+
+  const mediaBaseUrl = normalizeOptionalString(site.mediaBaseUrl);
+  if (!mediaBaseUrl || !isUrlUnderMediaBase(media.src, mediaBaseUrl) || !isResponsiveRasterImage(media.src)) {
+    return '';
+  }
+
+  const widths = RESPONSIVE_IMAGE_WIDTHS.filter((width) => width <= media.width);
+  if (!widths.includes(media.width)) {
+    widths.push(media.width);
+  }
+
+  return widths
+    .filter((width, index, values) => width > 0 && values.indexOf(width) === index)
+    .map((width) => `${buildResponsiveImageVariantUrl(media.src, width)} ${width}w`)
+    .join(', ');
+}
+
+function buildResponsiveImageVariantUrl(src, width) {
+  try {
+    const url = new URL(src);
+    url.searchParams.set('w', String(width));
+    url.searchParams.set('fit', 'scale-down');
+    url.searchParams.set('format', 'auto');
+    return decodeURI(url.toString());
+  } catch {
+    return src;
+  }
+}
+
+function isUrlUnderMediaBase(src, mediaBaseUrl) {
+  try {
+    const sourceUrl = new URL(src);
+    const baseUrl = new URL(mediaBaseUrl);
+    const basePath = baseUrl.pathname.endsWith('/') ? baseUrl.pathname : `${baseUrl.pathname}/`;
+    return sourceUrl.origin === baseUrl.origin && sourceUrl.pathname.startsWith(basePath);
+  } catch {
+    return false;
+  }
+}
+
+function isResponsiveRasterImage(src) {
+  try {
+    const url = new URL(src);
+    const lastSegment = url.pathname.split('/').pop() || '';
+    const extension = lastSegment.includes('.') ? lastSegment.split('.').pop().toLowerCase() : '';
+    return RESPONSIVE_IMAGE_EXTENSIONS.has(extension);
+  } catch {
+    return false;
+  }
+}
+
+function normalizeCollections(collections) {
+  if (!collections || typeof collections !== 'object' || Array.isArray(collections)) {
+    return {};
+  }
+
+  return Object.fromEntries(
+    Object.entries(collections).map(([collectionId, collection]) => [
+      collectionId,
+      {
+        ...collection,
+        title: normalizeOptionalString(collection?.title),
+        description: normalizeOptionalString(collection?.description),
+        items: Array.isArray(collection?.items) ? collection.items.map((item) => ({ ...item })) : [],
+      },
+    ]),
+  );
+}
+
 function normalizeWidgetAreas(widgetAreas, mediaBaseUrl) {
   if (!widgetAreas || typeof widgetAreas !== 'object') {
     return {};
@@ -516,6 +686,22 @@ function normalizeCustomHtml(customHtml) {
   };
 }
 
+function normalizeSiteFavicon(favicon) {
+  if (!favicon || typeof favicon !== 'object') {
+    return undefined;
+  }
+
+  const normalized = {};
+  for (const key of ['icon', 'svg', 'png', 'apple_touch_icon']) {
+    const value = normalizeOptionalString(favicon[key]);
+    if (value) {
+      normalized[key] = value;
+    }
+  }
+
+  return Object.keys(normalized).length ? normalized : undefined;
+}
+
 function normalizePermalinks(permalinks) {
   const source = permalinks && typeof permalinks === 'object' ? permalinks : {};
   const outputStyle = typeof source.output_style === 'string' && PERMALINK_OUTPUT_STYLES.has(source.output_style)
@@ -590,6 +776,7 @@ function createRenderData(previewData, themeMetadata = {}) {
   }));
   const pages = previewData.content.pages.map((page) => preparePage(page, previewData.site));
   const postBySlug = new Map(posts.map((post) => [post.slug, post]));
+  const pageBySlug = new Map(pages.map((page) => [page.slug, page]));
   const frontPage = previewData.site.front_page;
   const postIndex = previewData.site.post_index;
   const effectivePostIndexEnabled = postIndex.enabled !== false && themeSupportsPostIndex;
@@ -610,6 +797,7 @@ function createRenderData(previewData, themeMetadata = {}) {
     posts,
     pages: preparedPages,
     postBySlug,
+    collections: resolveCollections(previewData.collections, postBySlug, pageBySlug, frontPage),
     taxonomies: buildGlobalTaxonomies(previewData, categoryCountBySlug, tagCountBySlug),
     frontPageRoute,
     indexRoutes: buildPostIndexRoutes({
@@ -668,6 +856,69 @@ function buildGlobalTaxonomies(previewData, categoryCountBySlug, tagCountBySlug)
   };
 }
 
+function resolveCollections(collections, postBySlug, pageBySlug, frontPage) {
+  if (!collections || typeof collections !== 'object') {
+    return {};
+  }
+
+  return Object.fromEntries(
+    Object.entries(collections).map(([collectionId, collection]) => [
+      collectionId,
+      {
+        id: collectionId,
+        title: normalizeOptionalString(collection?.title),
+        description: normalizeOptionalString(collection?.description),
+        items: resolveCollectionItems(collectionId, collection?.items, postBySlug, pageBySlug, frontPage),
+      },
+    ]),
+  );
+}
+
+function resolveCollectionItems(collectionId, items, postBySlug, pageBySlug, frontPage) {
+  if (!Array.isArray(items)) {
+    return [];
+  }
+
+  return items.map((item, index) => resolveCollectionItem(collectionId, item, index, postBySlug, pageBySlug, frontPage));
+}
+
+function resolveCollectionItem(collectionId, item, index, postBySlug, pageBySlug, frontPage) {
+  if (item?.type === 'post') {
+    const post = postBySlug.get(item.slug);
+    if (!post) {
+      throw new Error(`Invalid collection "${collectionId}": item ${index + 1} references missing post slug "${item.slug}".`);
+    }
+    return {
+      type: 'post',
+      meta: post.meta,
+      ...buildStructuredPostSummary(post),
+    };
+  }
+
+  if (item?.type === 'page') {
+    const page = pageBySlug.get(item.slug);
+    if (!page) {
+      throw new Error(`Invalid collection "${collectionId}": item ${index + 1} references missing page slug "${item.slug}".`);
+    }
+    return buildCollectionPageSummary(page, frontPage);
+  }
+
+  throw new Error(`Invalid collection "${collectionId}": item ${index + 1} has unsupported type "${item?.type}".`);
+}
+
+function buildCollectionPageSummary(page, frontPage) {
+  return {
+    type: 'page',
+    title: page.title,
+    slug: page.slug,
+    url: frontPage?.type === 'page' && frontPage.page_slug === page.slug ? '/' : page.url,
+    excerpt: page.excerpt || '',
+    featured_image: page.featured_image || '',
+    ...(page.featured_media ? { featured_media: { ...page.featured_media } } : {}),
+    meta: page.meta,
+  };
+}
+
 function buildFrontPageRoute(frontPage, pages, effectivePostIndexEnabled, postIndexBasePath) {
   if (frontPage.type === 'theme_index') {
     if (effectivePostIndexEnabled && postIndexBasePath === '/') {
@@ -1031,6 +1282,7 @@ function preparePost(post, site, authorsById, categoriesBySlug, tagsBySlug, them
     updated_at_iso: post.updated_at_iso,
     author_id: post.author_id,
     featured_image: post.featured_image,
+    ...(post.featured_media ? { featured_media: { ...post.featured_media } } : {}),
     meta: post.meta,
     status: post.status,
     allow_comments: post.allow_comments,
@@ -1040,6 +1292,7 @@ function preparePost(post, site, authorsById, categoriesBySlug, tagsBySlug, them
       id: post.author_id,
       display_name: normalizeNonEmptyString(author?.display_name, post.author_id),
       avatar: author?.avatar || '',
+      ...(author?.avatar_media ? { avatar_media: { ...author.avatar_media } } : {}),
     },
     categories,
     tags,
@@ -1281,9 +1534,11 @@ function buildStructuredPostSummary(post) {
     published_at_iso: post.published_at_iso,
     reading_time: post.reading_time,
     featured_image: post.featured_image,
+    ...(post.featured_media ? { featured_media: { ...post.featured_media } } : {}),
     author: {
       display_name: post.author?.display_name || '',
       avatar: post.author?.avatar || '',
+      ...(post.author?.avatar_media ? { avatar_media: { ...post.author.avatar_media } } : {}),
     },
     categories: Array.isArray(post.categories) ? post.categories.map((category) => ({ ...category })) : [],
     tags: Array.isArray(post.tags) ? post.tags.map((tag) => ({ ...tag })) : [],
@@ -1533,7 +1788,8 @@ async function normalizeAndValidateThemePackage(themePackage) {
     ...(themePackage.metadata.features ? { features: themePackage.metadata.features } : {}),
     ...(themePackage.metadata.menuSlots ? { menuSlots: themePackage.metadata.menuSlots } : {}),
     ...(themePackage.metadata.widgetAreas ? { widgetAreas: themePackage.metadata.widgetAreas } : {}),
-    settings: themePackage.metadata.settings || {},
+    ...(themePackage.metadata.siteMeta ? { siteMeta: themePackage.metadata.siteMeta } : {}),
+    ...(themePackage.metadata.collectionSlots ? { collectionSlots: themePackage.metadata.collectionSlots } : {}),
   }));
 
   for (const [templateName, templateContent] of themePackage.templates.entries()) {
@@ -1569,7 +1825,6 @@ function normalizeThemePackageMetadata(sourceMetadata, manifest) {
   return {
     ...manifest,
     ...(sourceMetadata?.thumbnail ? { thumbnail: sourceMetadata.thumbnail } : {}),
-    settings: sourceMetadata?.settings || {},
   };
 }
 
@@ -1743,7 +1998,7 @@ function normalizeMediaField(value, mediaBaseUrl) {
 
   const normalizedBaseUrl = normalizeOptionalString(mediaBaseUrl);
   if (!normalizedBaseUrl) {
-    return '';
+    return normalizedValue;
   }
 
   try {
@@ -1979,7 +2234,10 @@ function assertPlannedOutputPathsSafe(state) {
   ];
 
   if (state.options.generateSpecialFiles) {
-    plannedPaths.push('404.html', 'robots.txt');
+    plannedPaths.push('404.html');
+    if (shouldGenerateRobotsTxt(state.options)) {
+      plannedPaths.push('robots.txt');
+    }
     if (hasCanonicalSiteUrl(state.previewData.site.url)) {
       plannedPaths.push('sitemap.xml', 'feed.xml');
     }
@@ -2079,11 +2337,43 @@ function sha256(content) {
 }
 
 function injectSiteCustomizations(html, state) {
-  let next = injectCustomCssAssetLink(html, state.customCssHref);
+  let next = injectFaviconLinks(html, state.favicon);
+  next = injectCustomCssAssetLink(next, state.customCssHref);
   next = injectCustomHtml(next, state.customHtml);
   return next;
 }
 
+function injectFaviconLinks(html, favicon) {
+  const links = buildFaviconLinks(favicon);
+  if (!links) {
+    return html;
+  }
+
+  return html.replace('</head>', `${links}\n</head>`);
+}
+
+function buildFaviconLinks(favicon) {
+  if (!favicon || typeof favicon !== 'object') {
+    return '';
+  }
+
+  const lines = [];
+  if (normalizeOptionalString(favicon.icon)) {
+    lines.push(`  <link rel="icon" href="${escapeHtml(favicon.icon)}" sizes="any">`);
+  }
+  if (normalizeOptionalString(favicon.svg)) {
+    lines.push(`  <link rel="icon" href="${escapeHtml(favicon.svg)}" type="image/svg+xml">`);
+  }
+  if (normalizeOptionalString(favicon.png)) {
+    lines.push(`  <link rel="icon" href="${escapeHtml(favicon.png)}" type="image/png">`);
+  }
+  if (normalizeOptionalString(favicon.apple_touch_icon)) {
+    lines.push(`  <link rel="apple-touch-icon" href="${escapeHtml(favicon.apple_touch_icon)}">`);
+  }
+
+  return lines.join('\n');
+}
+
 function injectCustomCssAssetLink(html, href) {
   if (!normalizeOptionalString(href)) {
     return html;
@@ -2165,13 +2455,23 @@ function buildFeedXml(site, emitted, generatedAt) {
 }
 
 function buildRobotsTxt(site) {
-  const lines = ['User-agent: *', 'Allow: /'];
+  const lines = ['User-agent: *'];
+  if (site.indexing === false) {
+    lines.push('Disallow: /');
+    return `${lines.join('\n')}\n`;
+  }
+
+  lines.push('Allow: /');
   if (site.url) {
     lines.push('', `Sitemap: ${resolveSiteUrl(site.url, '/sitemap.xml')}`);
   }
   return `${lines.join('\n')}\n`;
 }
 
+function shouldGenerateRobotsTxt(options) {
+  return options.generateSpecialFiles && options.generateRobotsTxt !== false;
+}
+
 function getContentType(assetPath) {
   const ext = assetPath.split('.').pop()?.toLowerCase();
   const contentTypes = {

package/src/assets/asset-processor.js

@@ -11,12 +11,7 @@ export class AssetProcessor {
   }
 
   async processJavaScript(js) {
-    return js
-      .replace(/\/\/(?![^\r\n]*https?:)[^\r\n]*/g, '')
-      .replace(/\/\*[\s\S]*?\*\//g, '')
-      .replace(/\s+/g, ' ')
-      .replace(/\s*([{}();,=+\-*/<>!&|])\s*/g, '$1')
-      .trim();
+    return js;
   }
 
   generateAssetHash(content) {

package/src/index.d.ts

@@ -4,7 +4,6 @@ import type { ThemeManifest } from '@zeropress/theme-validator';
 export interface ThemePackage {
   metadata: ThemeManifest & {
     thumbnail?: string;
-    settings?: Record<string, unknown>;
   };
   templates: Map<string, string>;
   partials: Map<string, string>;
@@ -23,7 +22,14 @@ export interface BuildWriter {
 
 export interface BuildOptions {
   assetHashing?: boolean;
+  favicon?: {
+    icon?: string;
+    svg?: string;
+    png?: string;
+    apple_touch_icon?: string;
+  };
   generateSpecialFiles?: boolean;
+  generateRobotsTxt?: boolean;
   writeManifest?: boolean;
 }
 

package/src/theme/load-theme-dir.js

@@ -51,7 +51,6 @@ export async function loadThemePackageFromDir(themeDir) {
     metadata: {
       ...manifest,
       thumbnail: themeJson.thumbnail,
-      settings: themeJson.settings || {},
     },
     templates,
     partials,