bunki 0.21.1 → 0.22.0

package/dist/parser.d.ts

@@ -14,4 +14,6 @@ export interface ParseResult {
  */
 export declare function parseMarkdownFiles(filePaths: string[], cdnConfig?: CDNConfig): Promise<ParsedMarkdownFile[]>;
 export declare function parseMarkdownDirectory(contentDir: string, strictMode?: boolean, cdnConfig?: CDNConfig): Promise<Post[]>;
+/** Validate the whole collection while parsing only files without reusable posts. */
+export declare function parseMarkdownCollection(markdownFiles: string[], strictMode?: boolean, cdnConfig?: CDNConfig, cachedPosts?: ReadonlyMap<string, Post>): Promise<ParsedMarkdownFile[]>;
 export {};

package/dist/site-generator.d.ts

@@ -9,6 +9,8 @@ export declare class SiteGenerator {
     private metrics;
     private cache;
     private incrementalMode;
+    private stylesheetInvalidated;
+    private readonly templateEngine;
     constructor(options: GeneratorOptions);
     /**
      * Enable incremental builds
@@ -30,12 +32,6 @@ export declare class SiteGenerator {
      * Parse content (full or incremental)
      */
     private parseContent;
-    /**
-     * Group posts by year (Pacific timezone)
-     * @param posts - Array of posts
-     * @returns Posts grouped by year
-     */
-    private groupPostsByYear;
     /**
      * Calculate output statistics (file count and total size)
      */

package/dist/site-model.d.ts

@@ -0,0 +1,3 @@
+import type { Post, Site, SiteConfig } from "./types";
+export declare function createSiteModel(posts: readonly Post[], config: SiteConfig, tagDescriptions?: Readonly<Record<string, string>>): Site;
+export declare function groupPostsByYear(posts: readonly Post[]): Record<string, Post[]>;

package/dist/types.d.ts

@@ -121,7 +121,9 @@ export interface CSSConfig {
     input: string;
     /** Output CSS file path (relative to output directory) */
     output: string;
-    /** PostCSS config file path (relative to project root) */
+    /** CSS engine; defaults to Bun unless a PostCSS config is supplied or detected. */
+    processor?: "bun" | "postcss";
+    /** PostCSS config file path (relative to project root); selects PostCSS in auto mode. */
     postcssConfig?: string;
     /** Whether to enable CSS processing */
     enabled: boolean;
@@ -155,7 +157,7 @@ export interface SiteConfig {
     domain: string;
     /** Optional author name used by config templates and feeds */
     author?: string;
-    /** Optional content directory override */
+    /** Content directory used by validate; generate uses its --content option */
     contentDir?: string;
     /** Optional templates directory override */
     templatesDir?: string;
@@ -169,7 +171,7 @@ export interface SiteConfig {
     cdn?: CDNConfig;
     /** Optional number of tags to display on homepage (sorted by count). If not set, all tags are shown */
     maxTagsOnHomepage?: number;
-    /** Optional list of domains to exclude from nofollow attribute. Links to these domains will have follow attribute. */
+    /** Domains whose links should omit nofollow; no explicit follow attribute is added */
     noFollowExceptions?: string[];
     /** RSS feed language code (default: en-US) */
     rssLanguage?: string;
@@ -202,6 +204,10 @@ export interface SiteConfig {
  * Options for initializing the site generator
  */
 export interface GeneratorOptions {
+    /** Config file used by the caller, for incremental cache invalidation */
+    configFile?: string;
+    /** Project root used for config, cache, and project-relative assets */
+    rootDir?: string;
     /** Directory containing markdown content */
     contentDir: string;
     /** Directory where generated files will be output */
@@ -279,7 +285,7 @@ export interface ImageUploader {
      * @param keyTransform Optional function to transform relative file path into S3 key
      * @returns Record of S3 keys to their public URLs
      */
-    uploadImages(imagesDir: string, minYear?: number, keyTransform?: (relativePath: string) => string, maxYear?: number): Promise<Record<string, string>>;
+    uploadImages(imagesDir: string, minYear?: number, keyTransform?: (relativePath: string) => string, maxYear?: number, includeFile?: (relativePath: string) => boolean): Promise<Record<string, string>>;
 }
 /**
  * S3 configuration type

package/dist/utils/build-cache.d.ts

@@ -20,6 +20,8 @@ export interface BuildCache {
     files: Record<string, CacheEntry>;
     /** Config file hash */
     configHash?: string;
+    /** Resolved configuration, including environment-derived and programmatic values */
+    optionsHash?: string;
     /** Last full build timestamp */
     lastFullBuild?: number;
 }

package/dist/utils/concurrency.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Map async work with bounded concurrency, preserving input order.
+ * On failure, stop scheduling and drain active work before rejecting.
+ */
+export declare function mapConcurrent<T, R>(items: readonly T[], transform: (item: T, index: number) => Promise<R>, concurrency?: number): Promise<R[]>;

package/dist/utils/css-processor.d.ts

@@ -1,4 +1,7 @@
 import type { CSSConfig } from "../types";
+export declare class PostCSSProcessingError extends Error {
+    constructor(cause: unknown);
+}
 export interface CSSProcessorOptions {
     /** CSS configuration */
     css: CSSConfig;
@@ -18,7 +21,7 @@ export interface CSSProcessResult {
     hash?: string;
 }
 /**
- * Process CSS using PostCSS directly
+ * Process CSS with Bun, or PostCSS for projects with a plugin configuration
  * Throws on error - no fallback
  * Returns output path (with hash if hashing enabled)
  */

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

@@ -6,7 +6,7 @@
  * 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
+ * @returns Date whose local fields represent Pacific wall-clock time, not the original instant
  */
 export declare function toPacificTime(date: string | Date): Date;
 /**

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

@@ -74,10 +74,8 @@ export declare function createDir(dirPath: string): Promise<void>;
  */
 export declare function ensureDir(dirPath: string): Promise<void>;
 /**
- * Copy a file from source to target using Bun's zero-copy file-to-file operation
- *
- * This uses Bun.write(target, BunFile) which performs a zero-copy operation at the kernel level.
- * Similar to `cat source > target` but much faster than reading into memory and writing back.
+ * Copy a file with Bun.write without reading its contents into a JavaScript string.
+ * Bun selects the underlying copy mechanism for the platform and file types.
  *
  * @param sourcePath - Source file path
  * @param targetPath - Target file path
@@ -113,7 +111,7 @@ export declare function listDir(dirPath: string, recursive?: boolean): Promise<s
  * Useful for streaming writes or building large files incrementally without loading
  * everything into memory. Uses a buffered sink with configurable watermark.
  *
- * Zero-copy streaming to disk with backpressure handling.
+ * Call flush() or end() to finish writing buffered data.
  *
  * @param filePath - Path to file
  * @param highWaterMark - Buffer size in bytes (default: 1MB)
@@ -131,10 +129,7 @@ export declare function listDir(dirPath: string, recursive?: boolean): Promise<s
  */
 export declare function createFileWriter(filePath: string, highWaterMark?: number): Bun.FileSink;
 /**
- * Write a file to stdout using zero-copy streaming
- *
- * Similar to `cat file.txt` command. Uses Bun's zero-copy mechanism to stream
- * the file content directly to stdout without loading into memory.
+ * Write a BunFile directly to stdout without creating a JavaScript string.
  *
  * @param filePath - Path to file to output
  * @returns Promise that resolves when file is written to stdout

package/dist/utils/s3-uploader.d.ts

@@ -13,13 +13,7 @@ export declare class S3Uploader implements Uploader, ImageUploader {
      * @returns The public URL for the file
      */
     private getPublicUrl;
-    /**
-     * Execute async tasks with concurrency limit
-     * @param tasks Array of task functions that return promises
-     * @param concurrency Maximum number of concurrent tasks
-     */
-    private executeWithConcurrency;
-    uploadImages(imagesDir: string, minYear?: number, keyTransform?: (relativePath: string) => string, maxYear?: number): Promise<Record<string, string>>;
+    uploadImages(imagesDir: string, minYear?: number, keyTransform?: (relativePath: string) => string, maxYear?: number, includeFile?: (relativePath: string) => boolean): Promise<Record<string, string>>;
 }
 /**
  * Create an S3 uploader

package/dist/utils/template-engine.d.ts

@@ -13,7 +13,7 @@ import nunjucks from "nunjucks";
  * @example
  * ```typescript
  * const env = createTemplateEngine("./templates");
- * const html = nunjucks.render("index.njk", { site, posts });
+ * const html = env.render("index.njk", { site, posts });
  * ```
  */
 export declare function createTemplateEngine(templatesDir: string, watch?: boolean): nunjucks.Environment;

package/dist/utils/xml-builder.d.ts

@@ -7,6 +7,7 @@
  * @returns Escaped XML text
  */
 export declare function escapeXml(text: string): string;
+export declare function cdata(text: string): string;
 /**
  * Build XML sitemap URL entry
  * @param loc - URL location

package/docs/assets/bunki-banner.svg

@@ -0,0 +1,17 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1200" height="320" viewBox="0 0 1200 320" role="img" aria-labelledby="title description">
+  <title id="title">Bunki</title>
+  <desc id="description">An open book beside the Bunki wordmark on warm cream. Your words, on your own site.</desc>
+  <rect width="1200" height="320" rx="24" fill="#F6F1E7"/>
+  <path d="M68 250H1132" stroke="#D8CFC0"/>
+  <g transform="translate(72 66)">
+    <rect width="144" height="144" rx="32" fill="#293E36"/>
+    <path d="M30 40Q51 35 72 48Q93 35 114 40V104Q93 99 72 112Q51 99 30 104Z" fill="#F6F1E7"/>
+    <path d="M72 49V111" stroke="#293E36" stroke-width="4"/>
+    <path d="M42 58L59 62M42 72L59 76M85 62L102 58M85 76L102 72" stroke="#A9B9A7" stroke-width="4" stroke-linecap="round"/>
+    <circle cx="116" cy="28" r="12" fill="#D7794E"/>
+  </g>
+  <text x="252" y="153" fill="#293E36" font-family="Georgia, 'Times New Roman', serif" font-size="100" font-weight="bold" letter-spacing="-5">bunki</text>
+  <text x="258" y="200" fill="#42574C" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif" font-size="27">Your words, on your own site.</text>
+  <text x="74" y="286" fill="#526357" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif" font-size="16" letter-spacing="2">MARKDOWN · BUN · STATIC HTML</text>
+  <path d="M956 80H1108M996 108H1108M1036 136H1108" fill="none" stroke="#D8CFC0" stroke-width="3" stroke-linecap="round"/>
+</svg>

package/docs/migration.md

@@ -0,0 +1,9 @@
+# Migrating to 0.22.0 (release candidate)
+
+Compared with npm 0.21.1, Bunki now requires Bun 1.4.4 or newer (previously 1.3.14). Upgrade Bun before installing.
+
+Plain CSS now defaults to Bun’s native bundler. Review generated CSS and asset URLs after upgrading: local imports are bundled and assets may be embedded. To retain the PostCSS engine, set `css.processor: "postcss"` in your configuration. Existing PostCSS plugin configurations remain supported and are detected automatically; see the [CSS reference](https://github.com/kahwee/bunki/blob/main/docs/reference.md#css-configuration).
+
+The root import now maps to the shipped `dist/index.js`. The 0.21.1 npm manifest mapped imports to `dist/index.mjs`, but that file was absent from its archive. Public API additions are additive.
+
+This is a candidate, not a published release.

package/package.json

@@ -1,26 +1,28 @@
 {
   "name": "bunki",
-  "version": "0.21.1",
-  "description": "An opinionated static site generator built with Bun featuring PostCSS integration and modern web development workflows",
+  "version": "0.22.0",
+  "packageManager": "bun@1.4.4",
+  "description": "Your words, on your own site. A Bun-powered static site generator for Markdown blogs, notes, and documentation.",
   "main": "dist/index.js",
-  "module": "dist/index.mjs",
   "types": "dist/index.d.ts",
   "type": "module",
   "scripts": {
-    "build": "bun build.js",
+    "build": "bun run typecheck && bun run build:artifacts",
     "dev": "bun run --watch src/index.ts",
     "test": "bun test",
     "test:coverage": "bun test --coverage --coverage-reporter=lcov",
     "test:watch": "bun test --watch",
-    "format": "biome format --write .",
-    "format:check": "biome format .",
-    "lint": "biome check .",
-    "lint:fix": "biome check --write .",
+    "benchmark": "bun scripts/benchmark-build.ts",
+    "format": "bun fmt .",
+    "format:check": "bun fmt --check .",
     "prepare": "husky",
-    "typecheck": "bun tsc --noEmit",
+    "typecheck": "bun --check --tsconfig-override=tsconfig.json",
     "clean": "rm -rf dist coverage",
     "prepack": "bun run clean && bun run build",
-    "prepublishOnly": "bun run clean && bun run build && bun run test && bun run typecheck"
+    "prepublishOnly": "bun run clean && bun run check",
+    "check:source": "bun run --parallel format:check typecheck test",
+    "build:artifacts": "bun --bun build.ts",
+    "check": "bun run check:source && bun run build:artifacts"
   },
   "bin": {
     "bunki": "dist/cli.js"
@@ -50,42 +52,34 @@
   "dependencies": {
     "commander": "^15.0.0",
     "gray-matter": "^4.0.3",
-    "highlight.js": "^11.11.1",
-    "marked": "^18.0.7",
+    "highlight.js": "^11.12.0",
+    "marked": "^18.1.3",
     "marked-alert": "^2.1.2",
     "marked-highlight": "^2.2.4",
     "nunjucks": "^3.2.4",
-    "postcss": "^8.5.22",
-    "postcss-cli": "^11.0.1",
-    "sanitize-html": "^2.17.6",
+    "postcss": "^8.5.32",
+    "postcss-cli": "^12.0.0",
+    "sanitize-html": "^2.18.1",
+    "serialize-javascript": "7.1.4",
     "slugify": "^1.6.9"
   },
   "devDependencies": {
-    "@biomejs/biome": "^2.5.5",
-    "@tailwindcss/postcss": "^4.3.3",
     "@types/nunjucks": "^3.2.6",
-    "@types/sanitize-html": "^2.16.1",
-    "autoprefixer": "^10.5.4",
-    "bun-types": "^1.3.14",
+    "@types/sanitize-html": "^2.16.2",
+    "@types/serialize-javascript": "5.0.4",
+    "bun-types": "^1.4.4",
     "husky": "^9.1.7",
-    "tailwindcss": "^4.3.3",
-    "typescript": "^7.0.2"
-  },
-  "peerDependencies": {
-    "postcss": "^8.0.0"
-  },
-  "peerDependenciesMeta": {
-    "postcss": {
-      "optional": true
-    }
+    "typescript": "7.0.2"
   },
   "files": [
     "dist",
+    "docs/assets",
+    "docs/migration.md",
     "LICENSE",
     "README.md"
   ],
   "engines": {
-    "bun": ">=1.3.14"
+    "bun": ">=1.4.4"
   },
   "engineStrict": true,
   "publishConfig": {
@@ -98,10 +92,15 @@
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
-      "import": "./dist/index.mjs",
+      "import": "./dist/index.js",
       "default": "./dist/index.js"
     },
     "./cli": "./dist/cli.js"
   },
-  "sideEffects": false
+  "sideEffects": false,
+  "overrides": {
+    "yaml": "^2.8.3",
+    "picomatch": "^2.3.2",
+    "js-yaml": "^3.14.2"
+  }
 }