bunki 0.9.0 → 0.10.0

package/dist/cli/commands/validate.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Validate markdown files for parsing errors
+ */
+import { Command } from "commander";
+export declare function registerValidateCommand(program: Command): void;

package/dist/cli.js

@@ -32764,6 +32764,18 @@ function escape(html, encode) {
 
 // src/utils/markdown-utils.ts
 var import_sanitize_html = __toESM(require_sanitize_html(), 1);
+
+// src/utils/date-utils.ts
+function toPacificTime(date) {
+  return new Date(new Date(date).toLocaleString("en-US", {
+    timeZone: "America/Los_Angeles"
+  }));
+}
+function getPacificYear(date) {
+  return toPacificTime(date).getFullYear();
+}
+
+// src/utils/markdown-utils.ts
 core_default.registerLanguage("javascript", javascript);
 core_default.registerLanguage("typescript", typescript);
 core_default.registerLanguage("markdown", markdown);
@@ -32890,20 +32902,36 @@ async function parseMarkdownFile(filePath) {
   try {
     const fileContent = await readFileAsText(filePath);
     if (fileContent === null) {
-      console.warn(`File not found or couldn't be read: ${filePath}`);
-      return null;
+      return {
+        post: null,
+        error: {
+          file: filePath,
+          type: "file_not_found",
+          message: "File not found or couldn't be read"
+        }
+      };
     }
     const { data, content } = import_gray_matter.default(fileContent);
     if (!data.title || !data.date) {
-      console.warn(`Skipping ${filePath}: missing required frontmatter (title or date)`);
-      return null;
+      const missingFields = [];
+      if (!data.title)
+        missingFields.push("title");
+      if (!data.date)
+        missingFields.push("date");
+      return {
+        post: null,
+        error: {
+          file: filePath,
+          type: "missing_field",
+          message: `Missing required fields: ${missingFields.join(", ")}`,
+          suggestion: "Add required frontmatter fields (title and date)"
+        }
+      };
     }
     let slug = data.slug || getBaseFilename(filePath);
     const sanitizedHtml = convertMarkdownToHtml(content);
-    const pacificDate = new Date(new Date(data.date).toLocaleString("en-US", {
-      timeZone: "America/Los_Angeles"
-    }));
-    const postYear = pacificDate.getFullYear();
+    const pacificDate = toPacificTime(data.date);
+    const postYear = getPacificYear(data.date);
     const post = {
       title: data.title,
       date: pacificDate.toISOString(),
@@ -32915,24 +32943,98 @@ async function parseMarkdownFile(filePath) {
       excerpt: data.excerpt || extractExcerpt(content),
       html: sanitizedHtml
     };
-    return post;
+    return { post, error: null };
   } catch (error) {
-    console.error(`Error parsing markdown file ${filePath}:`, error);
-    return null;
+    const isYamlError = error?.name === "YAMLException" || error?.message?.includes("YAML") || error?.message?.includes("mapping pair");
+    let suggestion;
+    if (isYamlError) {
+      if (error?.message?.includes("mapping pair") || error?.message?.includes("colon")) {
+        suggestion = 'Quote titles/descriptions containing colons (e.g., title: "My Post: A Guide")';
+      } else if (error?.message?.includes("multiline key")) {
+        suggestion = "Remove nested quotes or use single quotes inside double quotes";
+      }
+    }
+    return {
+      post: null,
+      error: {
+        file: filePath,
+        type: isYamlError ? "yaml" : "unknown",
+        message: error?.message || String(error),
+        suggestion
+      }
+    };
   }
 }
 
 // src/parser.ts
-async function parseMarkdownDirectory(contentDir) {
+async function parseMarkdownDirectory(contentDir, strictMode = false) {
   try {
     const markdownFiles = await findFilesByPattern("**/*.md", contentDir, true);
     console.log(`Found ${markdownFiles.length} markdown files`);
-    const postsPromises = markdownFiles.map((filePath) => parseMarkdownFile(filePath));
-    const posts = await Promise.all(postsPromises);
-    return posts.filter((post) => post !== null).sort((a, b2) => new Date(b2.date).getTime() - new Date(a.date).getTime());
+    const resultsPromises = markdownFiles.map((filePath) => parseMarkdownFile(filePath));
+    const results = await Promise.all(resultsPromises);
+    const posts = [];
+    const errors = [];
+    for (const result of results) {
+      if (result.post) {
+        posts.push(result.post);
+      } else if (result.error) {
+        errors.push(result.error);
+      }
+    }
+    if (errors.length > 0) {
+      console.error(`
+\u26A0\uFE0F  Found ${errors.length} parsing error(s):
+`);
+      const yamlErrors = errors.filter((e) => e.type === "yaml");
+      const missingFieldErrors = errors.filter((e) => e.type === "missing_field");
+      const otherErrors = errors.filter((e) => e.type !== "yaml" && e.type !== "missing_field");
+      if (yamlErrors.length > 0) {
+        console.error(`  YAML Parsing Errors (${yamlErrors.length}):`);
+        yamlErrors.slice(0, 5).forEach((e) => {
+          console.error(`    \u274C ${e.file}`);
+          if (e.suggestion) {
+            console.error(`       \uD83D\uDCA1 ${e.suggestion}`);
+          }
+        });
+        if (yamlErrors.length > 5) {
+          console.error(`    ... and ${yamlErrors.length - 5} more`);
+        }
+        console.error("");
+      }
+      if (missingFieldErrors.length > 0) {
+        console.error(`  Missing Required Fields (${missingFieldErrors.length}):`);
+        missingFieldErrors.slice(0, 5).forEach((e) => {
+          console.error(`    \u26A0\uFE0F  ${e.file}: ${e.message}`);
+        });
+        if (missingFieldErrors.length > 5) {
+          console.error(`    ... and ${missingFieldErrors.length - 5} more`);
+        }
+        console.error("");
+      }
+      if (otherErrors.length > 0) {
+        console.error(`  Other Errors (${otherErrors.length}):`);
+        otherErrors.slice(0, 3).forEach((e) => {
+          console.error(`    \u274C ${e.file}: ${e.message}`);
+        });
+        if (otherErrors.length > 3) {
+          console.error(`    ... and ${otherErrors.length - 3} more`);
+        }
+        console.error("");
+      }
+      console.error(`\uD83D\uDCDD Tip: Fix YAML errors by quoting titles/descriptions with colons`);
+      console.error(`   Example: title: "My Post: A Guide"  (quotes required for colons)
+`);
+      if (strictMode) {
+        throw new Error(`Build failed: ${errors.length} parsing error(s) found (strictMode enabled)`);
+      }
+    }
+    const sortedPosts = posts.sort((a, b2) => new Date(b2.date).getTime() - new Date(a.date).getTime());
+    console.log(`Parsed ${sortedPosts.length} posts`);
+    return sortedPosts;
   } catch (error) {
     console.error(`Error parsing markdown directory:`, error);
-    return [];
+    throw error;
   }
 }
 
@@ -33087,15 +33189,18 @@ class SiteGenerator {
   options;
   site;
   formatRSSDate(date) {
-    const pacificDate = new Date(new Date(date).toLocaleString("en-US", {
-      timeZone: "America/Los_Angeles"
-    }));
-    return pacificDate.toUTCString();
+    return toPacificTime(date).toUTCString();
   }
-  getPacificDate(date) {
-    return new Date(new Date(date).toLocaleString("en-US", {
-      timeZone: "America/Los_Angeles"
-    }));
+  groupPostsByYear(posts) {
+    const postsByYear = {};
+    for (const post of posts) {
+      const year = getPacificYear(post.date).toString();
+      if (!postsByYear[year]) {
+        postsByYear[year] = [];
+      }
+      postsByYear[year].push(post);
+    }
+    return postsByYear;
   }
   getSortedTags(limit) {
     const sorted = Object.values(this.site.tags).sort((a, b2) => b2.count - a.count);
@@ -33121,17 +33226,15 @@ class SiteGenerator {
     this.site = {
       name: options2.config.domain,
       posts: [],
-      tags: {}
+      tags: {},
+      postsByYear: {}
     };
     const env = import_nunjucks.default.configure(this.options.templatesDir, {
       autoescape: true,
       watch: false
     });
     env.addFilter("date", function(date, format) {
-      const pstDate = new Date(date).toLocaleString("en-US", {
-        timeZone: "America/Los_Angeles"
-      });
-      const d2 = new Date(pstDate);
+      const d2 = toPacificTime(date);
       const months = [
         "January",
         "February",
@@ -33178,8 +33281,8 @@ class SiteGenerator {
         console.warn("Error loading tag descriptions:", error);
       }
     }
-    const posts = await parseMarkdownDirectory(this.options.contentDir);
-    console.log(`Parsed ${posts.length} posts`);
+    const strictMode = this.options.config.strictMode ?? false;
+    const posts = await parseMarkdownDirectory(this.options.contentDir, strictMode);
     const tags = {};
     posts.forEach((post) => {
       post.tagSlugs = {};
@@ -33205,34 +33308,28 @@ class SiteGenerator {
     this.site = {
       name: this.options.config.domain,
       posts,
-      tags
+      tags,
+      postsByYear: this.groupPostsByYear(posts)
     };
   }
   async generate() {
     console.log("Generating static site...");
     await ensureDir(this.options.outputDir);
     await this.generateStylesheet();
-    await this.generateIndexPage();
-    await this.generatePostPages();
-    await this.generateTagPages();
-    await this.generateYearArchives();
-    await this.generateRSSFeed();
-    await this.generateSitemap();
-    await this.generateRobotsTxt();
-    await this.copyStaticAssets();
+    await Promise.all([
+      this.generateIndexPage(),
+      this.generatePostPages(),
+      this.generateTagPages(),
+      this.generateYearArchives(),
+      this.generateRSSFeed(),
+      this.generateSitemap(),
+      this.generateRobotsTxt(),
+      this.copyStaticAssets()
+    ]);
     console.log("Site generation complete!");
   }
   async generateYearArchives() {
-    const postsByYear = {};
-    for (const post of this.site.posts) {
-      const postDate = new Date(post.date);
-      const year = postDate.getFullYear().toString();
-      if (!postsByYear[year]) {
-        postsByYear[year] = [];
-      }
-      postsByYear[year].push(post);
-    }
-    for (const [year, yearPosts] of Object.entries(postsByYear)) {
+    for (const [year, yearPosts] of Object.entries(this.site.postsByYear)) {
       const yearDir = path5.join(this.options.outputDir, year);
       await ensureDir(yearDir);
       const pageSize = 10;
@@ -33453,7 +33550,7 @@ class SiteGenerator {
   async generateRSSFeed() {
     const posts = this.site.posts.slice(0, 15);
     const config = this.options.config;
-    const now = this.getPacificDate(new Date);
+    const now = toPacificTime(new Date);
     const latestPostDate = posts.length > 0 ? posts[0].date : now.toISOString();
     const lastBuildDate = this.formatRSSDate(latestPostDate);
     const rssItems = posts.map((post) => {
@@ -33527,10 +33624,10 @@ ${rssItems}
     await Bun.write(path5.join(this.options.outputDir, "feed.xml"), rssContent);
   }
   async generateSitemap() {
-    const currentDate = this.getPacificDate(new Date).toISOString();
+    const currentDate = toPacificTime(new Date).toISOString();
     const pageSize = 10;
     const config = this.options.config;
-    const now = this.getPacificDate(new Date).getTime();
+    const now = toPacificTime(new Date).getTime();
     const ONE_DAY = 24 * 60 * 60 * 1000;
     const ONE_WEEK = 7 * ONE_DAY;
     const ONE_MONTH = 30 * ONE_DAY;
@@ -33611,16 +33708,7 @@ ${rssItems}
         }
       }
     }
-    const postsByYear = {};
-    for (const post of this.site.posts) {
-      const postDate = new Date(post.date);
-      const year = postDate.getFullYear().toString();
-      if (!postsByYear[year]) {
-        postsByYear[year] = [];
-      }
-      postsByYear[year].push(post);
-    }
-    for (const [year, yearPosts] of Object.entries(postsByYear)) {
+    for (const [year, yearPosts] of Object.entries(this.site.postsByYear)) {
       const currentYear = new Date().getFullYear();
       const isCurrentYear = parseInt(year) === currentYear;
       const yearPriority = isCurrentYear ? 0.7 : 0.5;
@@ -33654,7 +33742,7 @@ ${rssItems}
     }
   }
   async generateSitemapIndex() {
-    const currentDate = this.getPacificDate(new Date).toISOString();
+    const currentDate = toPacificTime(new Date).toISOString();
     const config = this.options.config;
     let sitemapIndexContent = `<?xml version="1.0" encoding="UTF-8"?>
 <sitemapindex xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
@@ -34690,6 +34778,32 @@ function registerServeCommand(program2) {
   });
 }
 
+// src/cli/commands/validate.ts
+function registerValidateCommand(program2) {
+  program2.command("validate").description("Validate markdown files for parsing errors").option("-c, --config <path>", "Path to config file", "bunki.config.ts").action(async (options2) => {
+    try {
+      const config = await loadConfig(options2.config);
+      console.log(`\uD83D\uDD0D Validating markdown files...
+`);
+      const contentDir = "./content";
+      try {
+        await parseMarkdownDirectory(contentDir, true);
+        console.log(`
+\u2705 All markdown files are valid!`);
+        process.exit(0);
+      } catch (error) {
+        console.error(`
+\u274C Validation failed
+`);
+        process.exit(1);
+      }
+    } catch (error) {
+      console.error("Error during validation:", error.message);
+      process.exit(1);
+    }
+  });
+}
+
 // src/cli.ts
 var program2 = new Command;
 registerInitCommand(program2);
@@ -34698,7 +34812,8 @@ registerGenerateCommand(program2);
 registerServeCommand(program2);
 registerCssCommand(program2);
 registerImagesPushCommand(program2);
-program2.name("bunki").description("An opinionated static site generator built with Bun").version("0.5.3");
+registerValidateCommand(program2);
+program2.name("bunki").description("An opinionated static site generator built with Bun").version("0.10.0");
 var currentFile = import.meta.url.replace("file://", "");
 var mainFile = Bun.main;
 if (currentFile === mainFile || currentFile.endsWith(mainFile)) {

package/dist/index.js

@@ -30382,6 +30382,18 @@ function escape(html, encode) {
 
 // src/utils/markdown-utils.ts
 var import_sanitize_html = __toESM(require_sanitize_html(), 1);
+
+// src/utils/date-utils.ts
+function toPacificTime(date) {
+  return new Date(new Date(date).toLocaleString("en-US", {
+    timeZone: "America/Los_Angeles"
+  }));
+}
+function getPacificYear(date) {
+  return toPacificTime(date).getFullYear();
+}
+
+// src/utils/markdown-utils.ts
 core_default.registerLanguage("javascript", javascript);
 core_default.registerLanguage("typescript", typescript);
 core_default.registerLanguage("markdown", markdown);
@@ -30508,20 +30520,36 @@ async function parseMarkdownFile(filePath) {
   try {
     const fileContent = await readFileAsText(filePath);
     if (fileContent === null) {
-      console.warn(`File not found or couldn't be read: ${filePath}`);
-      return null;
+      return {
+        post: null,
+        error: {
+          file: filePath,
+          type: "file_not_found",
+          message: "File not found or couldn't be read"
+        }
+      };
     }
     const { data, content } = import_gray_matter.default(fileContent);
     if (!data.title || !data.date) {
-      console.warn(`Skipping ${filePath}: missing required frontmatter (title or date)`);
-      return null;
+      const missingFields = [];
+      if (!data.title)
+        missingFields.push("title");
+      if (!data.date)
+        missingFields.push("date");
+      return {
+        post: null,
+        error: {
+          file: filePath,
+          type: "missing_field",
+          message: `Missing required fields: ${missingFields.join(", ")}`,
+          suggestion: "Add required frontmatter fields (title and date)"
+        }
+      };
     }
     let slug = data.slug || getBaseFilename(filePath);
     const sanitizedHtml = convertMarkdownToHtml(content);
-    const pacificDate = new Date(new Date(data.date).toLocaleString("en-US", {
-      timeZone: "America/Los_Angeles"
-    }));
-    const postYear = pacificDate.getFullYear();
+    const pacificDate = toPacificTime(data.date);
+    const postYear = getPacificYear(data.date);
     const post = {
       title: data.title,
       date: pacificDate.toISOString(),
@@ -30533,24 +30561,98 @@ async function parseMarkdownFile(filePath) {
       excerpt: data.excerpt || extractExcerpt(content),
       html: sanitizedHtml
     };
-    return post;
+    return { post, error: null };
   } catch (error) {
-    console.error(`Error parsing markdown file ${filePath}:`, error);
-    return null;
+    const isYamlError = error?.name === "YAMLException" || error?.message?.includes("YAML") || error?.message?.includes("mapping pair");
+    let suggestion;
+    if (isYamlError) {
+      if (error?.message?.includes("mapping pair") || error?.message?.includes("colon")) {
+        suggestion = 'Quote titles/descriptions containing colons (e.g., title: "My Post: A Guide")';
+      } else if (error?.message?.includes("multiline key")) {
+        suggestion = "Remove nested quotes or use single quotes inside double quotes";
+      }
+    }
+    return {
+      post: null,
+      error: {
+        file: filePath,
+        type: isYamlError ? "yaml" : "unknown",
+        message: error?.message || String(error),
+        suggestion
+      }
+    };
   }
 }
 
 // src/parser.ts
-async function parseMarkdownDirectory(contentDir) {
+async function parseMarkdownDirectory(contentDir, strictMode = false) {
   try {
     const markdownFiles = await findFilesByPattern("**/*.md", contentDir, true);
     console.log(`Found ${markdownFiles.length} markdown files`);
-    const postsPromises = markdownFiles.map((filePath) => parseMarkdownFile(filePath));
-    const posts = await Promise.all(postsPromises);
-    return posts.filter((post) => post !== null).sort((a, b2) => new Date(b2.date).getTime() - new Date(a.date).getTime());
+    const resultsPromises = markdownFiles.map((filePath) => parseMarkdownFile(filePath));
+    const results = await Promise.all(resultsPromises);
+    const posts = [];
+    const errors = [];
+    for (const result of results) {
+      if (result.post) {
+        posts.push(result.post);
+      } else if (result.error) {
+        errors.push(result.error);
+      }
+    }
+    if (errors.length > 0) {
+      console.error(`
+\u26A0\uFE0F  Found ${errors.length} parsing error(s):
+`);
+      const yamlErrors = errors.filter((e) => e.type === "yaml");
+      const missingFieldErrors = errors.filter((e) => e.type === "missing_field");
+      const otherErrors = errors.filter((e) => e.type !== "yaml" && e.type !== "missing_field");
+      if (yamlErrors.length > 0) {
+        console.error(`  YAML Parsing Errors (${yamlErrors.length}):`);
+        yamlErrors.slice(0, 5).forEach((e) => {
+          console.error(`    \u274C ${e.file}`);
+          if (e.suggestion) {
+            console.error(`       \uD83D\uDCA1 ${e.suggestion}`);
+          }
+        });
+        if (yamlErrors.length > 5) {
+          console.error(`    ... and ${yamlErrors.length - 5} more`);
+        }
+        console.error("");
+      }
+      if (missingFieldErrors.length > 0) {
+        console.error(`  Missing Required Fields (${missingFieldErrors.length}):`);
+        missingFieldErrors.slice(0, 5).forEach((e) => {
+          console.error(`    \u26A0\uFE0F  ${e.file}: ${e.message}`);
+        });
+        if (missingFieldErrors.length > 5) {
+          console.error(`    ... and ${missingFieldErrors.length - 5} more`);
+        }
+        console.error("");
+      }
+      if (otherErrors.length > 0) {
+        console.error(`  Other Errors (${otherErrors.length}):`);
+        otherErrors.slice(0, 3).forEach((e) => {
+          console.error(`    \u274C ${e.file}: ${e.message}`);
+        });
+        if (otherErrors.length > 3) {
+          console.error(`    ... and ${otherErrors.length - 3} more`);
+        }
+        console.error("");
+      }
+      console.error(`\uD83D\uDCDD Tip: Fix YAML errors by quoting titles/descriptions with colons`);
+      console.error(`   Example: title: "My Post: A Guide"  (quotes required for colons)
+`);
+      if (strictMode) {
+        throw new Error(`Build failed: ${errors.length} parsing error(s) found (strictMode enabled)`);
+      }
+    }
+    const sortedPosts = posts.sort((a, b2) => new Date(b2.date).getTime() - new Date(a.date).getTime());
+    console.log(`Parsed ${sortedPosts.length} posts`);
+    return sortedPosts;
   } catch (error) {
     console.error(`Error parsing markdown directory:`, error);
-    return [];
+    throw error;
   }
 }
 // src/server.ts
@@ -31034,15 +31136,18 @@ class SiteGenerator {
   options;
   site;
   formatRSSDate(date) {
-    const pacificDate = new Date(new Date(date).toLocaleString("en-US", {
-      timeZone: "America/Los_Angeles"
-    }));
-    return pacificDate.toUTCString();
+    return toPacificTime(date).toUTCString();
   }
-  getPacificDate(date) {
-    return new Date(new Date(date).toLocaleString("en-US", {
-      timeZone: "America/Los_Angeles"
-    }));
+  groupPostsByYear(posts) {
+    const postsByYear = {};
+    for (const post of posts) {
+      const year = getPacificYear(post.date).toString();
+      if (!postsByYear[year]) {
+        postsByYear[year] = [];
+      }
+      postsByYear[year].push(post);
+    }
+    return postsByYear;
   }
   getSortedTags(limit) {
     const sorted = Object.values(this.site.tags).sort((a, b2) => b2.count - a.count);
@@ -31068,17 +31173,15 @@ class SiteGenerator {
     this.site = {
       name: options2.config.domain,
       posts: [],
-      tags: {}
+      tags: {},
+      postsByYear: {}
     };
     const env = import_nunjucks.default.configure(this.options.templatesDir, {
       autoescape: true,
       watch: false
     });
     env.addFilter("date", function(date, format) {
-      const pstDate = new Date(date).toLocaleString("en-US", {
-        timeZone: "America/Los_Angeles"
-      });
-      const d2 = new Date(pstDate);
+      const d2 = toPacificTime(date);
       const months = [
         "January",
         "February",
@@ -31125,8 +31228,8 @@ class SiteGenerator {
         console.warn("Error loading tag descriptions:", error);
       }
     }
-    const posts = await parseMarkdownDirectory(this.options.contentDir);
-    console.log(`Parsed ${posts.length} posts`);
+    const strictMode = this.options.config.strictMode ?? false;
+    const posts = await parseMarkdownDirectory(this.options.contentDir, strictMode);
     const tags = {};
     posts.forEach((post) => {
       post.tagSlugs = {};
@@ -31152,34 +31255,28 @@ class SiteGenerator {
     this.site = {
       name: this.options.config.domain,
       posts,
-      tags
+      tags,
+      postsByYear: this.groupPostsByYear(posts)
     };
   }
   async generate() {
     console.log("Generating static site...");
     await ensureDir(this.options.outputDir);
     await this.generateStylesheet();
-    await this.generateIndexPage();
-    await this.generatePostPages();
-    await this.generateTagPages();
-    await this.generateYearArchives();
-    await this.generateRSSFeed();
-    await this.generateSitemap();
-    await this.generateRobotsTxt();
-    await this.copyStaticAssets();
+    await Promise.all([
+      this.generateIndexPage(),
+      this.generatePostPages(),
+      this.generateTagPages(),
+      this.generateYearArchives(),
+      this.generateRSSFeed(),
+      this.generateSitemap(),
+      this.generateRobotsTxt(),
+      this.copyStaticAssets()
+    ]);
     console.log("Site generation complete!");
   }
   async generateYearArchives() {
-    const postsByYear = {};
-    for (const post of this.site.posts) {
-      const postDate = new Date(post.date);
-      const year = postDate.getFullYear().toString();
-      if (!postsByYear[year]) {
-        postsByYear[year] = [];
-      }
-      postsByYear[year].push(post);
-    }
-    for (const [year, yearPosts] of Object.entries(postsByYear)) {
+    for (const [year, yearPosts] of Object.entries(this.site.postsByYear)) {
       const yearDir = path5.join(this.options.outputDir, year);
       await ensureDir(yearDir);
       const pageSize = 10;
@@ -31400,7 +31497,7 @@ class SiteGenerator {
   async generateRSSFeed() {
     const posts = this.site.posts.slice(0, 15);
     const config = this.options.config;
-    const now = this.getPacificDate(new Date);
+    const now = toPacificTime(new Date);
     const latestPostDate = posts.length > 0 ? posts[0].date : now.toISOString();
     const lastBuildDate = this.formatRSSDate(latestPostDate);
     const rssItems = posts.map((post) => {
@@ -31474,10 +31571,10 @@ ${rssItems}
     await Bun.write(path5.join(this.options.outputDir, "feed.xml"), rssContent);
   }
   async generateSitemap() {
-    const currentDate = this.getPacificDate(new Date).toISOString();
+    const currentDate = toPacificTime(new Date).toISOString();
     const pageSize = 10;
     const config = this.options.config;
-    const now = this.getPacificDate(new Date).getTime();
+    const now = toPacificTime(new Date).getTime();
     const ONE_DAY = 24 * 60 * 60 * 1000;
     const ONE_WEEK = 7 * ONE_DAY;
     const ONE_MONTH = 30 * ONE_DAY;
@@ -31558,16 +31655,7 @@ ${rssItems}
         }
       }
     }
-    const postsByYear = {};
-    for (const post of this.site.posts) {
-      const postDate = new Date(post.date);
-      const year = postDate.getFullYear().toString();
-      if (!postsByYear[year]) {
-        postsByYear[year] = [];
-      }
-      postsByYear[year].push(post);
-    }
-    for (const [year, yearPosts] of Object.entries(postsByYear)) {
+    for (const [year, yearPosts] of Object.entries(this.site.postsByYear)) {
       const currentYear = new Date().getFullYear();
       const isCurrentYear = parseInt(year) === currentYear;
       const yearPriority = isCurrentYear ? 0.7 : 0.5;
@@ -31601,7 +31689,7 @@ ${rssItems}
     }
   }
   async generateSitemapIndex() {
-    const currentDate = this.getPacificDate(new Date).toISOString();
+    const currentDate = toPacificTime(new Date).toISOString();
     const config = this.options.config;
     let sitemapIndexContent = `<?xml version="1.0" encoding="UTF-8"?>
 <sitemapindex xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">

package/dist/parser.d.ts

@@ -1,2 +1,7 @@
 import { Post } from "./types";
-export declare function parseMarkdownDirectory(contentDir: string): Promise<Post[]>;
+import { type ParseError } from "./utils/markdown-utils";
+export interface ParseResult {
+    posts: Post[];
+    errors: ParseError[];
+}
+export declare function parseMarkdownDirectory(contentDir: string, strictMode?: boolean): Promise<Post[]>;

package/dist/site-generator.d.ts

@@ -3,7 +3,7 @@ export declare class SiteGenerator {
     private options;
     private site;
     private formatRSSDate;
-    private getPacificDate;
+    private groupPostsByYear;
     private getSortedTags;
     private createPagination;
     constructor(options: GeneratorOptions);

package/dist/types.d.ts

@@ -68,6 +68,8 @@ export interface SiteConfig {
     webMaster?: string;
     /** Copyright statement for RSS feed (e.g., "Copyright © 2025 Your Site Name") */
     copyright?: string;
+    /** Strict mode: fail build on parsing errors (default: false) */
+    strictMode?: boolean;
     /** Additional custom configuration options */
     [key: string]: any;
 }
@@ -132,6 +134,8 @@ export interface Site {
     posts: Post[];
     /** Map of tag names to tag data */
     tags: Record<string, TagData>;
+    /** Posts grouped by year for efficient year archive generation */
+    postsByYear: Record<string, Post[]>;
 }
 /**
  * Interface for uploaders (different services can implement this)

package/dist/utils/date-utils.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Date utility functions for bunki
+ */
+/**
+ * Converts a date to Pacific Time (America/Los_Angeles timezone)
+ * This is used consistently across the codebase for date handling
+ *
+ * @param date - Date string or Date object to convert
+ * @returns Date object in Pacific timezone
+ */
+export declare function toPacificTime(date: string | Date): Date;
+/**
+ * Gets the year from a date in Pacific timezone
+ *
+ * @param date - Date string or Date object
+ * @returns Year as number
+ */
+export declare function getPacificYear(date: string | Date): number;

package/dist/utils/markdown-utils.d.ts

@@ -2,4 +2,14 @@ import { Post } from "../types";
 export declare function setNoFollowExceptions(exceptions: string[]): void;
 export declare function extractExcerpt(content: string, maxLength?: number): string;
 export declare function convertMarkdownToHtml(markdownContent: string): string;
-export declare function parseMarkdownFile(filePath: string): Promise<Post | null>;
+export interface ParseError {
+    file: string;
+    type: "yaml" | "missing_field" | "file_not_found" | "unknown";
+    message: string;
+    suggestion?: string;
+}
+export interface ParseMarkdownResult {
+    post: Post | null;
+    error: ParseError | null;
+}
+export declare function parseMarkdownFile(filePath: string): Promise<ParseMarkdownResult>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bunki",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "description": "An opinionated static site generator built with Bun featuring PostCSS integration and modern web development workflows",
   "main": "dist/index.js",
   "module": "dist/index.mjs",