bunki 0.18.0 → 0.18.5

package/dist/types.d.ts

@@ -64,6 +64,10 @@ export interface Post {
     business?: Business;
     /** Optional image URL (first image from post content, used for thumbnails and social sharing) */
     image?: string;
+    /** Word count calculated from content (used for reading time and schema.org) */
+    wordCount?: number;
+    /** Cached JSON-LD structured data (pre-generated during initialization) */
+    jsonLd?: string;
 }
 /**
  * Configuration for CSS processing
@@ -90,6 +94,8 @@ export interface CDNConfig {
     pathPattern: string;
     /** Whether CDN transformation is enabled */
     enabled: boolean;
+    /** Optional post year for year-based asset paths (e.g., "2025") */
+    postYear?: string;
 }
 /**
  * Configuration for the site
@@ -127,6 +133,11 @@ export interface SiteConfig {
     copyright?: string;
     /** Strict mode: fail build on parsing errors (default: false) */
     strictMode?: boolean;
+    /**
+     * Configuration for content assets stored alongside markdown in content/{year}/{assetsDir}/.
+     * When set, `bunki images:push --content-assets` uses this config for uploads.
+     */
+    contentAssets?: ContentAssetsConfig;
     /** Additional custom configuration options */
     [key: string]: any;
 }
@@ -208,9 +219,10 @@ export interface ImageUploader {
      * Upload all images from a directory
      * @param imagesDir Directory containing images to upload
      * @param minYear Optional minimum year to filter (e.g., 2023 uploads 2023, 2024, etc.)
-     * @returns Record of image filenames to their public URLs
+     * @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): Promise<Record<string, string>>;
+    uploadImages(imagesDir: string, minYear?: number, keyTransform?: (relativePath: string) => string): Promise<Record<string, string>>;
 }
 /**
  * S3 configuration type
@@ -224,6 +236,24 @@ export interface S3Config {
     endpoint?: string;
     region?: string;
 }
+/**
+ * Configuration for content assets stored alongside markdown files.
+ * Assets live in content/{year}/{assetsDir}/ and are uploaded to R2/S3
+ * with the key {year}/{filename} (the assetsDir is stripped from the path).
+ */
+export interface ContentAssetsConfig {
+    /**
+     * Directory name within content/{year}/ that contains co-located assets.
+     * Defaults to "_assets". Can be set to "_images" or any other name.
+     */
+    assetsDir?: string;
+    /**
+     * Override S3/R2 config for content assets uploads.
+     * When set, uses this config instead of the site's top-level s3 config.
+     * Useful if you store blog images in a separate bucket from site assets.
+     */
+    s3?: S3Config;
+}
 /**
  * Options for image upload
  */
@@ -232,4 +262,11 @@ export interface ImageUploadOptions {
     images?: string;
     outputJson?: string;
     minYear?: number;
+    /** Scan content/{year}/{assetsDir}/ and upload as {year}/{filename} */
+    contentAssets?: boolean;
+    /**
+     * Override the assets directory name used in content-assets mode.
+     * Defaults to "_assets" (or contentAssets.assetsDir from config).
+     */
+    contentAssetsDir?: string;
 }

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

@@ -28,7 +28,8 @@ export interface BuildCache {
  */
 export declare function hashFile(filePath: string): Promise<string>;
 /**
- * Get file modification time
+ * Get file modification time (returns 0 if file doesn't exist)
+ * Wrapper around file-utils getFileMtime for backward compatibility
  */
 export declare function getFileMtime(filePath: string): Promise<number>;
 /**

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

@@ -1,3 +1,4 @@
 import { 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

@@ -187,6 +187,12 @@ export declare function generateCollectionPageSchema(options: CollectionPageOpti
  * // Returns: '<script type="application/ld+json">{"@context":"https://schema.org",...}</script>'
  */
 export declare function toScriptTag(jsonLd: SchemaOrgThing): string;
+/**
+ * Convert multiple JSON-LD schemas to HTML script tags
+ * @param schemas - Array of schema objects
+ * @returns HTML string with script tags joined by newlines
+ */
+export declare function schemasToHtml(schemas: SchemaOrgThing[]): string;
 /**
  * Extracts the first image URL from HTML content
  *

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

@@ -4,6 +4,8 @@
  */
 export declare const RELATIVE_LINK_REGEX: RegExp;
 export declare const IMAGE_PATH_REGEX: RegExp;
+export declare const IMAGE_PATH_ASSETS_DIR: RegExp;
+export declare const IMAGE_PATH_ASSETS_SAME_DIR: RegExp;
 export declare const YOUTUBE_EMBED_REGEX: RegExp;
 export declare const EXTERNAL_LINK_REGEX: RegExp;
 export declare const SCHEMA_ORG_PLACE_TYPES: Set<string>;

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

@@ -19,7 +19,7 @@ export declare class S3Uploader implements Uploader, ImageUploader {
      * @param concurrency Maximum number of concurrent tasks
      */
     private executeWithConcurrency;
-    uploadImages(imagesDir: string, minYear?: number): Promise<Record<string, string>>;
+    uploadImages(imagesDir: string, minYear?: number, keyTransform?: (relativePath: string) => string): Promise<Record<string, string>>;
 }
 /**
  * Create an S3 uploader

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

@@ -0,0 +1,58 @@
+/**
+ * Schema generation factory
+ * Simplifies creation of JSON-LD structured data for common page types
+ */
+import type { SiteConfig, Post } from "../types";
+/**
+ * Options for generating collection page schemas (tag pages, year archives, etc.)
+ */
+export interface CollectionSchemaOptions {
+    /** Page title */
+    title: string;
+    /** Page description */
+    description: string;
+    /** Canonical URL for the page */
+    url: string;
+    /** Posts included in the collection */
+    posts: Post[];
+    /** Breadcrumb navigation items */
+    breadcrumbs: Array<{
+        name: string;
+        url: string;
+    }>;
+}
+/**
+ * Generate JSON-LD schemas for collection pages (tag pages, year archives, etc.)
+ *
+ * This factory function eliminates duplication when creating schemas for
+ * pages that display a collection of posts with breadcrumb navigation.
+ *
+ * Generates both CollectionPage and BreadcrumbList schemas.
+ *
+ * @param config - Site configuration
+ * @param options - Collection page options
+ * @returns HTML-encoded JSON-LD script tags ready for insertion
+ *
+ * @example
+ * ```typescript
+ * // Tag page schemas
+ * const jsonLd = generateCollectionSchemas(config, {
+ *   title: "JavaScript",
+ *   description: "Articles about JavaScript",
+ *   url: "https://example.com/tags/javascript/",
+ *   posts: tagPosts,
+ *   breadcrumbs: [
+ *     { name: "Home", url: "https://example.com/" },
+ *     { name: "JavaScript", url: "https://example.com/tags/javascript/" }
+ *   ],
+ * });
+ * ```
+ */
+export declare function generateCollectionSchemas(config: SiteConfig, options: CollectionSchemaOptions): string;
+/**
+ * Generate breadcrumb schema for homepage
+ *
+ * @param config - Site configuration
+ * @returns HTML-encoded JSON-LD script tag
+ */
+export declare function generateHomeBreadcrumbs(config: SiteConfig): string;

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

@@ -0,0 +1,19 @@
+/**
+ * Template engine configuration and setup
+ * Centralizes Nunjucks configuration and custom filters
+ */
+import nunjucks from "nunjucks";
+/**
+ * Create and configure Nunjucks template engine with custom filters
+ *
+ * @param templatesDir - Directory containing template files
+ * @param watch - Enable template watching for development (default: false)
+ * @returns Configured Nunjucks environment
+ *
+ * @example
+ * ```typescript
+ * const env = createTemplateEngine("./templates");
+ * const html = nunjucks.render("index.njk", { site, posts });
+ * ```
+ */
+export declare function createTemplateEngine(templatesDir: string, watch?: boolean): nunjucks.Environment;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bunki",
-  "version": "0.18.0",
+  "version": "0.18.5",
   "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",
@@ -50,13 +50,13 @@
     "commander": "^14.0.3",
     "gray-matter": "^4.0.3",
     "highlight.js": "^11.11.1",
-    "marked": "^17.0.2",
+    "marked": "17.0.3",
     "marked-alert": "^2.1.2",
     "marked-highlight": "^2.2.3",
     "nunjucks": "^3.2.4",
     "postcss": "^8.5.6",
     "postcss-cli": "^11.0.1",
-    "sanitize-html": "2.17.0",
+    "sanitize-html": "2.17.1",
     "slugify": "^1.6.6"
   },
   "devDependencies": {
@@ -86,7 +86,7 @@
   ],
   "engines": {
     "bun": ">=1.3.9",
-    "node": ">=18.0.0"
+    "node": ">=24.0.0"
   },
   "engineStrict": true,
   "publishConfig": {