bunki 0.16.2 → 0.17.0

package/dist/site-generator.d.ts

@@ -1,33 +1,33 @@
-import { GeneratorOptions } from "./types";
+/**
+ * Site generator orchestrator
+ * Coordinates all generation tasks using modular generators
+ */
+import type { GeneratorOptions } from "./types";
 export declare class SiteGenerator {
     private options;
     private site;
-    private formatRSSDate;
-    private groupPostsByYear;
-    private getSortedTags;
-    private createPagination;
+    private metrics;
     constructor(options: GeneratorOptions);
+    /**
+     * Initialize site data - parse markdown and prepare site structure
+     */
     initialize(): Promise<void>;
+    /**
+     * Generate all static site content
+     */
     generate(): Promise<void>;
-    private generate404Page;
-    private generateYearArchives;
-    private generateIndexPage;
-    private generatePostPages;
-    private generateTagPages;
-    private generateMapPage;
-    private generateStylesheet;
-    private fallbackCSSGeneration;
-    private copyStaticAssets;
     /**
-     * Extract the first image URL from HTML content
+     * Generate all feed files (RSS, sitemap, robots.txt)
+     */
+    private generateFeeds;
+    /**
+     * Group posts by year (Pacific timezone)
+     * @param posts - Array of posts
+     * @returns Posts grouped by year
      */
-    private extractFirstImageUrl;
+    private groupPostsByYear;
     /**
-     * Escape special characters in XML text to prevent CDATA issues
+     * Calculate output statistics (file count and total size)
      */
-    private escapeXml;
-    private generateRSSFeed;
-    private generateSitemap;
-    private generateSitemapIndex;
-    private generateRobotsTxt;
+    private calculateOutputStats;
 }

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

@@ -0,0 +1,52 @@
+/**
+ * Build performance metrics and tracking
+ */
+export interface BuildMetrics {
+    totalTime: number;
+    stages: {
+        initialization: number;
+        cssProcessing: number;
+        pageGeneration: number;
+        feedGeneration: number;
+        assetCopying: number;
+    };
+    outputs: {
+        posts: number;
+        pages: number;
+        totalSize: number;
+    };
+}
+export interface BuildStage {
+    name: keyof BuildMetrics["stages"];
+    startTime: number;
+}
+export declare class MetricsCollector {
+    private startTime;
+    private stageTimings;
+    private currentStage;
+    constructor();
+    /**
+     * Start tracking a build stage
+     */
+    startStage(name: keyof BuildMetrics["stages"]): void;
+    /**
+     * End the current build stage
+     */
+    endStage(): void;
+    /**
+     * Get final build metrics
+     */
+    getMetrics(outputs: {
+        posts: number;
+        pages: number;
+        totalSize: number;
+    }): BuildMetrics;
+}
+/**
+ * Format bytes to human-readable string
+ */
+export declare function formatBytes(bytes: number): string;
+/**
+ * Display build metrics in the console
+ */
+export declare function displayMetrics(metrics: BuildMetrics): void;

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

@@ -8,12 +8,21 @@ export interface CSSProcessorOptions {
     outputDir: string;
     /** Whether to run in verbose mode */
     verbose?: boolean;
+    /** Enable content-based cache busting with hash */
+    enableHashing?: boolean;
+}
+export interface CSSProcessResult {
+    /** Output file path (may include hash if hashing enabled) */
+    outputPath: string;
+    /** Content hash (8-char base36) if hashing enabled */
+    hash?: string;
 }
 /**
  * Process CSS using PostCSS directly
  * Throws on error - no fallback
+ * Returns output path (with hash if hashing enabled)
  */
-export declare function processCSS(options: CSSProcessorOptions): Promise<void>;
+export declare function processCSS(options: CSSProcessorOptions): Promise<CSSProcessResult>;
 /**
  * Watch CSS files for changes and reprocess
  */

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

@@ -0,0 +1,16 @@
+/**
+ * Constants for markdown processing
+ * Extracted for better code organization and performance
+ */
+export declare const RELATIVE_LINK_REGEX: RegExp;
+export declare const IMAGE_PATH_REGEX: RegExp;
+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>";
+};

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

@@ -0,0 +1,32 @@
+/**
+ * Core markdown parsing and transformation logic
+ */
+import { Marked } from "marked";
+import type { CDNConfig } from "../../types";
+/**
+ * Set domains that should not have nofollow attribute
+ * @param exceptions - Array of domain names (e.g., ["example.com", "trusted-site.org"])
+ */
+export declare function setNoFollowExceptions(exceptions: string[]): void;
+/**
+ * Creates an isolated Marked instance with custom configuration.
+ * V17 best practice: Use instance-scoped configuration to avoid global mutations.
+ * @param cdnConfig - Optional CDN configuration for image URL transformation
+ * @returns Configured Marked instance
+ */
+export declare function createMarked(cdnConfig?: CDNConfig): Marked;
+/**
+ * Convert markdown to sanitized HTML
+ * @param markdownContent - Raw markdown string
+ * @param cdnConfig - Optional CDN configuration
+ * @returns Sanitized HTML string
+ */
+export declare function convertMarkdownToHtml(markdownContent: string, cdnConfig?: CDNConfig): string;
+/**
+ * Extract excerpt from markdown content
+ * Removes headings, code blocks, and formatting to create plain text excerpt
+ * @param content - Raw markdown content
+ * @param maxLength - Maximum length of excerpt (default: 200)
+ * @returns Plain text excerpt
+ */
+export declare function extractExcerpt(content: string, maxLength?: number): string;

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

@@ -0,0 +1,31 @@
+/**
+ * Frontmatter and business location validators
+ */
+export interface ValidationError {
+    file: string;
+    type: "yaml" | "missing_field" | "file_not_found" | "unknown" | "validation";
+    message: string;
+    suggestion?: string;
+}
+/**
+ * Validate business location format
+ * Required fields: type, name, address, lat/lng (NOT latitude/longitude)
+ * @param business - Business location data (can be array or single object)
+ * @param filePath - File path for error reporting
+ * @returns ValidationError if invalid, null if valid
+ */
+export declare function validateBusinessLocation(business: any, 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;
+/**
+ * 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: any, filePath: string): ValidationError | null;

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

@@ -1,15 +1,20 @@
-import { Post, CDNConfig } from "../types";
-export declare function setNoFollowExceptions(exceptions: string[]): void;
-export declare function extractExcerpt(content: string, maxLength?: number): string;
-export declare function convertMarkdownToHtml(markdownContent: string, cdnConfig?: CDNConfig): string;
-export interface ParseError {
-    file: string;
-    type: "yaml" | "missing_field" | "file_not_found" | "unknown" | "validation";
-    message: string;
-    suggestion?: string;
-}
+/**
+ * Markdown utilities - Main export file
+ * Re-exports from modular components for backward compatibility
+ */
+import type { Post, CDNConfig } 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 interface ParseMarkdownResult {
     post: Post | null;
-    error: ParseError | null;
+    error: ValidationError | null;
 }
+/**
+ * Parse a markdown file with frontmatter validation
+ * @param filePath - Path to markdown file
+ * @param cdnConfig - Optional CDN configuration
+ * @returns ParseMarkdownResult with post data or error
+ */
 export declare function parseMarkdownFile(filePath: string, cdnConfig?: CDNConfig): Promise<ParseMarkdownResult>;

package/dist/utils/pagination.d.ts

@@ -0,0 +1,38 @@
+/**
+ * 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;
+}
+/**
+ * Create pagination data for a list of items
+ * @param items - Array of items to paginate
+ * @param currentPage - Current page number (1-indexed)
+ * @param pageSize - Number of items per page
+ * @param pagePath - Base path for pagination (e.g., "/", "/tags/tech/")
+ * @returns Pagination data object
+ */
+export declare function createPagination<T>(items: T[], currentPage: number, pageSize: number, pagePath: string): PaginationData;
+/**
+ * Get paginated slice of items for a specific page
+ * @param items - Array of items to paginate
+ * @param page - Page number (1-indexed)
+ * @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[];
+/**
+ * Calculate total number of pages needed for items
+ * @param totalItems - Total number of items
+ * @param pageSize - Number of items per page
+ * @returns Total number of pages
+ */
+export declare function getTotalPages(totalItems: number, pageSize: number): number;

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

@@ -0,0 +1,42 @@
+/**
+ * XML building utilities for RSS and Sitemap generation
+ */
+/**
+ * Escape special characters in XML text to prevent CDATA issues
+ * @param text - Text to escape
+ * @returns Escaped XML text
+ */
+export declare function escapeXml(text: string): string;
+/**
+ * Build XML sitemap URL entry
+ * @param loc - URL location
+ * @param lastmod - Last modification date (ISO string)
+ * @param changefreq - Change frequency
+ * @param priority - Priority (0.0 to 1.0)
+ * @returns XML string for sitemap URL entry
+ */
+export declare function buildSitemapUrl(loc: string, lastmod: string, changefreq: string, priority: number): string;
+/**
+ * Calculate priority based on content freshness
+ * @param date - Content date (ISO string)
+ * @param basePriority - Base priority value
+ * @param now - Current time (default: Date.now())
+ * @returns Adjusted priority value (0.0 to 1.0)
+ */
+export declare function calculateFreshnessPriority(date: string, basePriority: number, now?: number): number;
+/**
+ * Build RSS item with all metadata
+ * @param params - RSS item parameters
+ * @returns RSS item XML string
+ */
+export interface RSSItemParams {
+    title: string;
+    link: string;
+    pubDate: string;
+    description: string;
+    content: string;
+    tags?: string[];
+    author?: string;
+    image?: string | null;
+}
+export declare function buildRSSItem(params: RSSItemParams): string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bunki",
-  "version": "0.16.2",
+  "version": "0.17.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",