bunki 0.19.6 → 0.21.1

package/dist/config.d.ts

@@ -1,4 +1,4 @@
-import { SiteConfig } from "./types";
+import type { SiteConfig } from "./types";
 export declare const DEFAULT_CONTENT_DIR: string;
 export declare const DEFAULT_OUTPUT_DIR: string;
 export declare const DEFAULT_TEMPLATES_DIR: string;

package/dist/constants.d.ts

@@ -30,6 +30,8 @@ export declare const FILES: {
 export declare const SEO: {
     /** Add noindex meta tag to pagination pages beyond this number */
     readonly NOINDEX_AFTER_PAGE: 2;
+    /** Tag pages with this many posts or fewer are noindexed (see tag.njk) and excluded from the sitemap */
+    readonly THIN_TAG_MAX_POSTS: 2;
 };
 /**
  * Cache and time-based constants

package/dist/generators/feeds.d.ts

@@ -17,7 +17,7 @@ export declare function generateRSSFeed(site: Site, config: SiteConfig): string;
  * @param pageSize - Items per page for pagination
  * @returns Sitemap XML content
  */
-export declare function generateSitemap(site: Site, config: SiteConfig, pageSize?: number): string;
+export declare function generateSitemap(site: Site, config: SiteConfig, _pageSize?: number): string;
 /**
  * Generate sitemap index XML (for large sites)
  * @param config - Site configuration

package/dist/index.d.ts

@@ -1,12 +1,12 @@
-export * from "./types";
-export { PAGINATION, FILES, SEO, CACHE, DATE } from "./constants";
+export { configExists, createDefaultConfig, DEFAULT_CONFIG_FILE, DEFAULT_CONTENT_DIR, DEFAULT_OUTPUT_DIR, DEFAULT_TEMPLATES_DIR, loadConfig, saveConfig, } from "./config";
+export { CACHE, DATE, FILES, PAGINATION, SEO } from "./constants";
 export { parseMarkdownDirectory } from "./parser";
 export { startServer } from "./server";
 export { SiteGenerator } from "./site-generator";
-export { configExists, createDefaultConfig, DEFAULT_CONFIG_FILE, DEFAULT_CONTENT_DIR, DEFAULT_OUTPUT_DIR, DEFAULT_TEMPLATES_DIR, loadConfig, saveConfig, } from "./config";
+export * from "./types";
 export { copyFile, ensureDir, fileExists, findFilesByPattern, getBaseFilename, readFileAsText, } from "./utils/file-utils";
-export { convertMarkdownToHtml, extractExcerpt, parseMarkdownFile, } from "./utils/markdown-utils";
-export { createTemplateEngine } from "./utils/template-engine";
-export { generateCollectionSchemas, generateHomeBreadcrumbs, } from "./utils/schema-factory";
 export { DEFAULT_IMAGES_DIR, uploadImages } from "./utils/image-uploader";
+export { convertMarkdownToHtml, extractExcerpt, parseMarkdownFile, } from "./utils/markdown-utils";
 export { createUploader } from "./utils/s3-uploader";
+export { generateCollectionSchemas, generateHomeBreadcrumbs, } from "./utils/schema-factory";
+export { createTemplateEngine } from "./utils/template-engine";

package/dist/parser.d.ts

@@ -1,5 +1,9 @@
-import { Post, CDNConfig } from "./types";
+import type { CDNConfig, Post } from "./types";
 import { type ParseError } from "./utils/markdown-utils";
+interface ParsedMarkdownFile {
+    post: Post;
+    filePath: string;
+}
 export interface ParseResult {
     posts: Post[];
     errors: ParseError[];
@@ -8,8 +12,6 @@ export interface ParseResult {
  * Parse specific markdown files (for incremental builds)
  * Returns both posts and their file paths for cache updates
  */
-export declare function parseMarkdownFiles(filePaths: string[], cdnConfig?: CDNConfig): Promise<Array<{
-    post: Post;
-    filePath: string;
-}>>;
+export declare function parseMarkdownFiles(filePaths: string[], cdnConfig?: CDNConfig): Promise<ParsedMarkdownFile[]>;
 export declare function parseMarkdownDirectory(contentDir: string, strictMode?: boolean, cdnConfig?: CDNConfig): Promise<Post[]>;
+export {};

package/dist/types.d.ts

@@ -1,6 +1,48 @@
 /**
  * Post object representing a single markdown file
  */
+export type JsonPrimitive = string | number | boolean | null;
+export type JsonValue = JsonPrimitive | JsonObject | JsonValue[];
+export interface JsonObject {
+    [key: string]: JsonValue;
+}
+export type TemplateValue = JsonValue | object | undefined;
+export interface TemplateObject {
+    [key: string]: TemplateValue;
+}
+export interface FrontmatterLocation {
+    name?: string;
+    address?: string;
+    latitude?: number;
+    longitude?: number;
+    lat?: number;
+    lng?: number;
+}
+export interface FrontmatterBusiness {
+    type: string;
+    name: string;
+    address: string;
+    latitude?: number;
+    longitude?: number;
+    lat: number;
+    lng: number;
+    cuisine?: string;
+    priceRange?: string;
+    telephone?: string;
+    url?: string;
+    openingHours?: string;
+}
+export type FrontmatterBusinessInput = FrontmatterBusiness | FrontmatterBusiness[];
+export interface Frontmatter {
+    title?: string;
+    date?: string;
+    excerpt?: string;
+    tags?: string[];
+    seoTitle?: string;
+    category?: string;
+    location?: FrontmatterLocation;
+    business?: FrontmatterBusinessInput;
+}
 export interface Location {
     /** Name of the location */
     name: string;
@@ -111,6 +153,12 @@ export interface SiteConfig {
     baseUrl: string;
     /** Site identifier (used for metadata) */
     domain: string;
+    /** Optional author name used by config templates and feeds */
+    author?: string;
+    /** Optional content directory override */
+    contentDir?: string;
+    /** Optional templates directory override */
+    templatesDir?: string;
     /** Optional public URL for the bucket */
     publicUrl?: string;
     /** Optional S3 client configuration (accessKeyId, secretAccessKey, bucket, etc.) */
@@ -142,8 +190,13 @@ export interface SiteConfig {
      * When set, `bunki images:push --content-assets` uses this config for uploads.
      */
     contentAssets?: ContentAssetsConfig;
-    /** Additional custom configuration options */
-    [key: string]: any;
+    /** Resolved site metadata used by loaders and generators */
+    site?: {
+        title: string;
+        description: string;
+        url: string;
+        author: string;
+    };
 }
 /**
  * Options for initializing the site generator

package/dist/utils/change-detector.d.ts

@@ -2,8 +2,8 @@
  * Change detection for incremental builds
  * Determines which files have changed and what needs to be rebuilt
  */
-import type { BuildCache } from "./build-cache";
 import type { Post } from "../types";
+import type { BuildCache } from "./build-cache";
 export interface ChangeSet {
     /** Posts that were added or modified */
     changedPosts: string[];
@@ -29,7 +29,7 @@ export declare function detectChanges(currentFiles: string[], cache: BuildCache,
 /**
  * Determine affected tags from changed posts
  */
-export declare function getAffectedTags(changedPosts: Post[], allPosts: Post[]): Set<string>;
+export declare function getAffectedTags(changedPosts: Post[], _allPosts: Post[]): Set<string>;
 /**
  * Check if index pages need regeneration
  */

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

@@ -1,4 +1,4 @@
-import { CSSConfig } from "../types";
+import type { CSSConfig } from "../types";
 export interface CSSProcessorOptions {
     /** CSS configuration */
     css: CSSConfig;

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

@@ -55,9 +55,9 @@ export declare function writeFile(filePath: string, content: string): Promise<vo
  */
 export declare function writeFileBuffer(filePath: string, data: Uint8Array | ArrayBuffer): Promise<void>;
 /**
- * Get base filename without extension, handling both patterns:
- * - content/2025/georgia-aquarium-atlanta.md → georgia-aquarium-atlanta
- * - content/2025/georgia-aquarium-atlanta/README.md → georgia-aquarium-atlanta
+ * Get base filename without extension, handling both post file patterns:
+ * - content/georgia-aquarium-atlanta.md → georgia-aquarium-atlanta
+ * - content/georgia-aquarium-atlanta/README.md → georgia-aquarium-atlanta
  * @param filePath - Path to file
  * @param extension - Extension to remove (default: ".md")
  * @returns Base filename (slug)

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

@@ -1,4 +1,4 @@
-import { ImageUploadOptions } from "../types";
+import type { ImageUploadOptions } from "../types";
 export declare const DEFAULT_IMAGES_DIR: string;
 export declare const DEFAULT_CONTENT_DIR: string;
 export declare function uploadImages(options?: ImageUploadOptions): Promise<Record<string, string>>;

package/dist/utils/json-ld.d.ts

@@ -15,15 +15,14 @@
  * @see https://schema.org/
  * @see https://developers.google.com/search/docs/appearance/structured-data/intro-structured-data
  */
-import type { Post, SiteConfig } from "../types.js";
+import type { JsonObject, Post, SiteConfig } from "../types.js";
 /**
  * Base Schema.org Thing type
  */
-interface SchemaOrgThing {
+type SchemaOrgThing = JsonObject & {
     "@context": "https://schema.org";
     "@type": string;
-    [key: string]: any;
-}
+};
 /**
  * Options for generating BlogPosting JSON-LD
  */

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

@@ -12,9 +12,9 @@ export declare const YOUTUBE_EMBED_REGEX: RegExp;
 export declare const EXTERNAL_LINK_REGEX: RegExp;
 export declare const SCHEMA_ORG_PLACE_TYPES: Set<string>;
 export declare const ALERT_ICONS: {
-    readonly note: "<svg xmlns=\"http://www.w3.org/2000/svg\" width=\"20\" height=\"20\" viewBox=\"0 0 20 20\" fill=\"currentColor\" aria-hidden=\"true\"><path fill-rule=\"evenodd\" d=\"M18 10a8 8 0 1 1-16 0 8 8 0 0 1 16 0Zm-7-4a1 1 0 1 1-2 0 1 1 0 0 1 2 0ZM9 9a.75.75 0 0 0 0 1.5h.253a.25.25 0 0 1 .244.304l-.459 2.066A1.75 1.75 0 0 0 10.747 15H11a.75.75 0 0 0 0-1.5h-.253a.25.25 0 0 1-.244-.304l.459-2.066A1.75 1.75 0 0 0 9.253 9H9Z\" clip-rule=\"evenodd\" /></svg>";
-    readonly tip: "<svg xmlns=\"http://www.w3.org/2000/svg\" width=\"20\" height=\"20\" viewBox=\"0 0 20 20\" fill=\"currentColor\" aria-hidden=\"true\"><path d=\"M10 1a6 6 0 0 0-3.815 10.631C7.237 12.5 8 13.443 8 14.456v.644a.75.75 0 0 0 .75.75h2.5a.75.75 0 0 0 .75-.75v-.644c0-1.013.762-1.957 1.815-2.825A6 6 0 0 0 10 1ZM8.863 17.414a.75.75 0 0 0-.226 1.483 9.066 9.066 0 0 0 2.726 0 .75.75 0 0 0-.226-1.483 7.553 7.553 0 0 1-2.274 0Z\" /></svg>";
-    readonly important: "<svg xmlns=\"http://www.w3.org/2000/svg\" width=\"20\" height=\"20\" viewBox=\"0 0 20 20\" fill=\"currentColor\" aria-hidden=\"true\"><path fill-rule=\"evenodd\" d=\"M18 10a8 8 0 1 1-16 0 8 8 0 0 1 16 0Zm-8-5a.75.75 0 0 1 .75.75v4.5a.75.75 0 0 1-1.5 0v-4.5A.75.75 0 0 1 10 5Zm0 10a1 1 0 1 0 0-2 1 1 0 0 0 0 2Z\" clip-rule=\"evenodd\" /></svg>";
-    readonly warning: "<svg xmlns=\"http://www.w3.org/2000/svg\" width=\"20\" height=\"20\" viewBox=\"0 0 20 20\" fill=\"currentColor\" aria-hidden=\"true\"><path fill-rule=\"evenodd\" d=\"M8.485 2.495c.673-1.167 2.357-1.167 3.03 0l6.28 10.875c.673 1.167-.17 2.625-1.516 2.625H3.72c-1.347 0-2.189-1.458-1.515-2.625L8.485 2.495ZM10 5a.75.75 0 0 1 .75.75v3.5a.75.75 0 0 1-1.5 0v-3.5A.75.75 0 0 1 10 5Zm0 9a1 1 0 1 0 0-2 1 1 0 0 0 0 2Z\" clip-rule=\"evenodd\" /></svg>";
-    readonly caution: "<svg xmlns=\"http://www.w3.org/2000/svg\" width=\"20\" height=\"20\" viewBox=\"0 0 20 20\" fill=\"currentColor\" aria-hidden=\"true\"><path fill-rule=\"evenodd\" d=\"M18 10a8 8 0 1 1-16 0 8 8 0 0 1 16 0ZM8.28 7.22a.75.75 0 0 0-1.06 1.06L8.94 10l-1.72 1.72a.75.75 0 1 0 1.06 1.06L10 11.06l1.72 1.72a.75.75 0 1 0 1.06-1.06L11.06 10l1.72-1.72a.75.75 0 0 0-1.06-1.06L10 8.94 8.28 7.22Z\" clip-rule=\"evenodd\" /></svg>";
+    readonly note: '<svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 20 20" fill="currentColor" aria-hidden="true"><path fill-rule="evenodd" d="M18 10a8 8 0 1 1-16 0 8 8 0 0 1 16 0Zm-7-4a1 1 0 1 1-2 0 1 1 0 0 1 2 0ZM9 9a.75.75 0 0 0 0 1.5h.253a.25.25 0 0 1 .244.304l-.459 2.066A1.75 1.75 0 0 0 10.747 15H11a.75.75 0 0 0 0-1.5h-.253a.25.25 0 0 1-.244-.304l.459-2.066A1.75 1.75 0 0 0 9.253 9H9Z" clip-rule="evenodd" /></svg>';
+    readonly tip: '<svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 20 20" fill="currentColor" aria-hidden="true"><path d="M10 1a6 6 0 0 0-3.815 10.631C7.237 12.5 8 13.443 8 14.456v.644a.75.75 0 0 0 .75.75h2.5a.75.75 0 0 0 .75-.75v-.644c0-1.013.762-1.957 1.815-2.825A6 6 0 0 0 10 1ZM8.863 17.414a.75.75 0 0 0-.226 1.483 9.066 9.066 0 0 0 2.726 0 .75.75 0 0 0-.226-1.483 7.553 7.553 0 0 1-2.274 0Z" /></svg>';
+    readonly important: '<svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 20 20" fill="currentColor" aria-hidden="true"><path fill-rule="evenodd" d="M18 10a8 8 0 1 1-16 0 8 8 0 0 1 16 0Zm-8-5a.75.75 0 0 1 .75.75v4.5a.75.75 0 0 1-1.5 0v-4.5A.75.75 0 0 1 10 5Zm0 10a1 1 0 1 0 0-2 1 1 0 0 0 0 2Z" clip-rule="evenodd" /></svg>';
+    readonly warning: '<svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 20 20" fill="currentColor" aria-hidden="true"><path fill-rule="evenodd" d="M8.485 2.495c.673-1.167 2.357-1.167 3.03 0l6.28 10.875c.673 1.167-.17 2.625-1.516 2.625H3.72c-1.347 0-2.189-1.458-1.515-2.625L8.485 2.495ZM10 5a.75.75 0 0 1 .75.75v3.5a.75.75 0 0 1-1.5 0v-3.5A.75.75 0 0 1 10 5Zm0 9a1 1 0 1 0 0-2 1 1 0 0 0 0 2Z" clip-rule="evenodd" /></svg>';
+    readonly caution: '<svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 20 20" fill="currentColor" aria-hidden="true"><path fill-rule="evenodd" d="M18 10a8 8 0 1 1-16 0 8 8 0 0 1 16 0ZM8.28 7.22a.75.75 0 0 0-1.06 1.06L8.94 10l-1.72 1.72a.75.75 0 1 0 1.06 1.06L10 11.06l1.72 1.72a.75.75 0 1 0 1.06-1.06L11.06 10l1.72-1.72a.75.75 0 0 0-1.06-1.06L10 8.94 8.28 7.22Z" clip-rule="evenodd" /></svg>';
 };

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

@@ -1,6 +1,7 @@
 /**
  * Frontmatter and business location validators
  */
+import type { Frontmatter, FrontmatterBusinessInput } from "../../types";
 export interface ValidationError {
     file: string;
     type: "yaml" | "missing_field" | "file_not_found" | "unknown" | "validation";
@@ -14,18 +15,18 @@ export interface ValidationError {
  * @param filePath - File path for error reporting
  * @returns ValidationError if invalid, null if valid
  */
-export declare function validateBusinessLocation(business: unknown, filePath: string): ValidationError | null;
+export declare function validateBusinessLocation(business: FrontmatterBusinessInput | null | undefined, filePath: string): ValidationError | null;
 /**
  * Validate that tags don't contain spaces (must use hyphens)
  * @param tags - Array of tag strings
  * @param filePath - File path for error reporting
  * @returns ValidationError if invalid, null if valid
  */
-export declare function validateTags(tags: string[], filePath: string): ValidationError | null;
+export declare function validateTags(tags: Frontmatter["tags"] | null | undefined, filePath: string): ValidationError | null;
 /**
  * Check for deprecated 'location' field (should use 'business' instead)
  * @param data - Frontmatter data
  * @param filePath - File path for error reporting
  * @returns ValidationError if found, null otherwise
  */
-export declare function checkDeprecatedLocationField(data: Record<string, unknown>, filePath: string): ValidationError | null;
+export declare function checkDeprecatedLocationField(data: Frontmatter | null | undefined, filePath: string): ValidationError | null;

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

@@ -2,11 +2,11 @@
  * Markdown utilities - Main export file
  * Re-exports from modular components for backward compatibility
  */
-import type { Post, CDNConfig } from "../types";
+import type { CDNConfig, Post } from "../types";
 import { convertMarkdownToHtml, extractExcerpt, setNoFollowExceptions } from "./markdown/parser";
 import type { ValidationError } from "./markdown/validators";
-export { setNoFollowExceptions, extractExcerpt, convertMarkdownToHtml };
 export type { ValidationError as ParseError };
+export { convertMarkdownToHtml, extractExcerpt, setNoFollowExceptions };
 export interface ParseMarkdownResult {
     post: Post | null;
     error: ValidationError | null;

package/dist/utils/pagination.d.ts

@@ -1,17 +1,7 @@
 /**
  * Pagination utilities
  */
-export interface PaginationData {
-    currentPage: number;
-    totalPages: number;
-    hasNextPage: boolean;
-    hasPrevPage: boolean;
-    nextPage: number | null;
-    prevPage: number | null;
-    pageSize: number;
-    totalItems: number;
-    pagePath: string;
-}
+import type { PaginationData } from "../types";
 /**
  * Create pagination data for a list of items
  * @param items - Array of items to paginate
@@ -20,7 +10,7 @@ export interface PaginationData {
  * @param pagePath - Base path for pagination (e.g., "/", "/tags/tech/")
  * @returns Pagination data object
  */
-export declare function createPagination(items: readonly unknown[], currentPage: number, pageSize: number, pagePath: string): PaginationData;
+export declare function createPagination<T>(items: readonly T[], currentPage: number, pageSize: number, pagePath: string): PaginationData;
 /**
  * Get paginated slice of items for a specific page
  * @param items - Array of items to paginate
@@ -28,7 +18,7 @@ export declare function createPagination(items: readonly unknown[], currentPage:
  * @param pageSize - Number of items per page
  * @returns Slice of items for the requested page
  */
-export declare function getPaginatedItems<T>(items: T[], page: number, pageSize: number): T[];
+export declare function getPaginatedItems<T>(items: readonly T[], page: number, pageSize: number): T[];
 /**
  * Calculate total number of pages needed for items
  * @param totalItems - Total number of items

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

@@ -1,4 +1,4 @@
-import { ImageUploader, S3Config, SiteConfig, Uploader } from "../types";
+import type { ImageUploader, S3Config, SiteConfig, Uploader } from "../types";
 /**
  * Bun-native S3 uploader implementation
  */

package/dist/utils/schema-factory.d.ts

@@ -2,7 +2,7 @@
  * Schema generation factory
  * Simplifies creation of JSON-LD structured data for common page types
  */
-import type { SiteConfig, Post } from "../types";
+import type { Post, SiteConfig } from "../types";
 /**
  * Options for generating collection page schemas (tag pages, year archives, etc.)
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bunki",
-  "version": "0.19.6",
+  "version": "0.21.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",
@@ -12,10 +12,11 @@
     "test": "bun test",
     "test:coverage": "bun test --coverage --coverage-reporter=lcov",
     "test:watch": "bun test --watch",
-    "format": "prettier --write .",
-    "format:check": "prettier --check .",
+    "format": "biome format --write .",
+    "format:check": "biome format .",
+    "lint": "biome check .",
+    "lint:fix": "biome check --write .",
     "prepare": "husky",
-    "lint-staged": "lint-staged",
     "typecheck": "bun tsc --noEmit",
     "clean": "rm -rf dist coverage",
     "prepack": "bun run clean && bun run build",
@@ -47,29 +48,28 @@
   },
   "homepage": "https://github.com/kahwee/bunki#readme",
   "dependencies": {
-    "commander": "^14.0.3",
+    "commander": "^15.0.0",
     "gray-matter": "^4.0.3",
     "highlight.js": "^11.11.1",
-    "marked": "17.0.5",
+    "marked": "^18.0.7",
     "marked-alert": "^2.1.2",
-    "marked-highlight": "^2.2.3",
+    "marked-highlight": "^2.2.4",
     "nunjucks": "^3.2.4",
-    "postcss": "^8.5.8",
+    "postcss": "^8.5.22",
     "postcss-cli": "^11.0.1",
-    "sanitize-html": "2.17.2",
-    "slugify": "^1.6.8"
+    "sanitize-html": "^2.17.6",
+    "slugify": "^1.6.9"
   },
   "devDependencies": {
-    "@tailwindcss/postcss": "^4.2.2",
+    "@biomejs/biome": "^2.5.5",
+    "@tailwindcss/postcss": "^4.3.3",
     "@types/nunjucks": "^3.2.6",
     "@types/sanitize-html": "^2.16.1",
-    "autoprefixer": "^10.4.27",
-    "bun-types": "^1.3.11",
+    "autoprefixer": "^10.5.4",
+    "bun-types": "^1.3.14",
     "husky": "^9.1.7",
-    "lint-staged": "^16.4.0",
-    "prettier": "^3.8.1",
-    "tailwindcss": "^4.2.2",
-    "typescript": "^6.0.2"
+    "tailwindcss": "^4.3.3",
+    "typescript": "^7.0.2"
   },
   "peerDependencies": {
     "postcss": "^8.0.0"
@@ -85,8 +85,7 @@
     "README.md"
   ],
   "engines": {
-    "bun": ">=1.3.9",
-    "node": ">=24.0.0"
+    "bun": ">=1.3.14"
   },
   "engineStrict": true,
   "publishConfig": {
@@ -96,9 +95,6 @@
     "type": "github",
     "url": "https://github.com/sponsors/kahwee"
   },
-  "lint-staged": {
-    "**/*": "prettier --write --ignore-unknown"
-  },
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",