bunki 0.9.0 → 0.9.1

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

@@ -32890,13 +32890,31 @@ 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);
@@ -32915,24 +32933,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;
   }
 }
 
@@ -33178,8 +33270,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 = {};
@@ -34690,6 +34782,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 +34816,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.9.1");
 var currentFile = import.meta.url.replace("file://", "");
 var mainFile = Bun.main;
 if (currentFile === mainFile || currentFile.endsWith(mainFile)) {

package/dist/index.js

@@ -30508,13 +30508,31 @@ 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);
@@ -30533,24 +30551,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
@@ -31125,8 +31217,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 = {};

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/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;
 }

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.9.1",
   "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",