@zeropress/build-core 0.1.8 → 0.1.9

package/README.md

@@ -9,7 +9,7 @@ Shared build and partial-render core for ZeroPress.
 This package is the deterministic rendering engine used by:
 
 - `zeropress-admin-api-v2`
-- future `@zeropress/build` CLI flows
+- [`@zeropress/build`](https://www.npmjs.com/package/@zeropress/build) package
 
 It accepts canonical preview-data plus a validated theme package and produces static HTML artifacts through a writer interface.
 
@@ -59,7 +59,12 @@ import {
   - `meta.json`
 - writing outputs through a pluggable writer
 
-It does not talk to databases, queues, KV, Durable Objects, R2, or deployment infrastructure directly.
+It does not:
+
+- fetch content from databases or APIs
+- package or validate theme directories on its own unless the caller uses `buildSiteFromThemeDir`
+- watch files, run a dev server, or perform deployment
+- talk to queues, KV, Durable Objects, R2, GitHub, or other infrastructure directly
 
 ---
 
@@ -97,7 +102,7 @@ Returns:
     }
   ],
   manifest: {
-    generatedAt: '2026-04-02T00:00:00.000Z',
+    generatedAt: '2026-04-02T00:00:00Z',
     files: [
       {
         path: 'index.html',
@@ -110,11 +115,29 @@ Returns:
 }
 ```
 
+Notes:
+
+- `writer` is required
+- `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` and `meta.json` are still emitted when `generateSpecialFiles` is enabled
+
 ### `buildSelectedRoutes(input)`
 
 Renders only selected post and list routes while preserving full-build parity for those outputs.
 
-This is intended for selective publish and other partial-render workflows.
+This is intended for targeted rebuilds, output parity checks, and other partial-render workflows.
+
+Current selection scope is limited to:
+
+- post detail routes
+- index pagination routes
+- archive routes
+- category routes
+- tag routes
+
+It does not currently support selecting individual page routes.
 
 Optional route templates are respected during both full and partial renders:
 
@@ -145,7 +168,7 @@ await buildSelectedRoutes({
 
 Loads a theme directory from disk and renders it using the same core pipeline.
 
-This is useful for local tooling and CLI flows.
+This is useful for local tooling that wants filesystem theme loading but still uses the same deterministic core renderer.
 
 ---
 
@@ -193,6 +216,8 @@ Theme validation is enforced through:
 
 - [`@zeropress/theme-validator`](https://www.npmjs.com/package/@zeropress/theme-validator)
 
+`buildSiteFromThemeDir()` is the convenience entry point that loads a theme directory and converts it into the required in-memory `themePackage`.
+
 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:
@@ -238,6 +263,13 @@ Supported options:
 
 These options apply to both full builds and partial renders where relevant.
 
+Defaults:
+
+- `assetHashing: true`
+- `generateSpecialFiles: true`
+- `injectHtmx: true`
+- `writeManifest: false`
+
 ---
 
 ## Requirements
@@ -251,7 +283,7 @@ These options apply to both full builds and partial renders where relevant.
 
 - [@zeropress/preview-data-validator](https://www.npmjs.com/package/@zeropress/preview-data-validator)
 - [@zeropress/theme-validator](https://www.npmjs.com/package/@zeropress/theme-validator)
-- [zeropress-theme](https://www.npmjs.com/package/zeropress-theme)
+- [@zeropress/theme](https://www.npmjs.com/package/@zeropress/theme)
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zeropress/build-core",
-  "version": "0.1.8",
+  "version": "0.1.9",
   "description": "Shared ZeroPress build and partial-render core",
   "type": "module",
   "license": "MIT",

package/src/api/build-site.js

@@ -170,7 +170,7 @@ async function finalizeBuildResult(writer, summaries, options) {
   let manifest;
   if (options.writeManifest) {
     manifest = {
-      generatedAt: new Date().toISOString(),
+      generatedAt: formatUtcIsoSeconds(new Date()),
       files: summaries.map((file) => ({ ...file })),
     };
     await writeOutput(
@@ -327,6 +327,8 @@ function normalizePreviewData(previewData) {
       posts: previewData.content.posts
         .map((post) => ({
           ...post,
+          published_at_iso: normalizeIsoTimestamp(post.published_at_iso),
+          updated_at_iso: normalizeIsoTimestamp(post.updated_at_iso),
           author_avatar: normalizeMediaField(post.author_avatar, normalizedSite.mediaBaseUrl),
           featured_image: normalizeMediaField(post.featured_image, normalizedSite.mediaBaseUrl),
         }))
@@ -1066,7 +1068,7 @@ function buildSitemapXml(site, emitted, generatedAt) {
   const body = entries.map((entry) => {
     const loc = escapeXml(resolveSiteUrl(site.url, entry.url));
     const lastmod = entry.lastmod
-      ? `\n    <lastmod>${entry.lastmod.toISOString()}</lastmod>`
+      ? `\n    <lastmod>${formatUtcIsoSeconds(entry.lastmod)}</lastmod>`
       : '';
     return `  <url>\n    <loc>${loc}</loc>${lastmod}\n    <changefreq>${entry.changefreq}</changefreq>\n    <priority>${entry.priority.toFixed(1)}</priority>\n  </url>`;
   }).join('\n');
@@ -1118,7 +1120,7 @@ function buildMetaJson(site, emitted, generatedAt) {
   ];
 
   return JSON.stringify({
-    generated: generatedAt.toISOString(),
+    generated: formatUtcIsoSeconds(generatedAt),
     site: {
       title: site.title,
       description: site.description,
@@ -1199,6 +1201,14 @@ function toDate(value) {
   return value ? new Date(value) : new Date();
 }
 
+function formatUtcIsoSeconds(value) {
+  return toDate(value).toISOString().replace(/\.\d{3}Z$/, 'Z');
+}
+
+function normalizeIsoTimestamp(value) {
+  return value ? formatUtcIsoSeconds(value) : '';
+}
+
 function escapeXml(str) {
   return String(str || '')
     .replace(/&/g, '&amp;')