bunki 0.12.0 → 0.13.0

package/dist/cli.js

@@ -33206,7 +33206,7 @@ function generateOrganizationSchema(site) {
     "@context": "https://schema.org",
     "@type": "Organization",
     name: site.title,
-    url: site.baseUrl
+    url: `${site.baseUrl}/`
   };
   if (site.description) {
     organization.description = site.description;
@@ -33239,7 +33239,7 @@ function generateBlogPostingSchema(options2) {
   blogPosting.publisher = {
     "@type": "Organization",
     name: site.title,
-    url: site.baseUrl
+    url: `${site.baseUrl}/`
   };
   if (imageUrl) {
     blogPosting.image = imageUrl;
@@ -33263,7 +33263,7 @@ function generateWebSiteSchema(options2) {
     "@context": "https://schema.org",
     "@type": "WebSite",
     name: site.title,
-    url: site.baseUrl
+    url: `${site.baseUrl}/`
   };
   if (site.description) {
     webSite.description = site.description;
@@ -33298,7 +33298,7 @@ function generateBreadcrumbListSchema(options2) {
     "@type": "ListItem",
     position: 1,
     name: "Home",
-    item: site.baseUrl
+    item: `${site.baseUrl}/`
   };
   breadcrumbs.itemListElement.push(homeItem);
   if (post) {
@@ -33311,6 +33311,24 @@ function generateBreadcrumbListSchema(options2) {
   }
   return breadcrumbs;
 }
+function generateCollectionPageSchema(options2) {
+  const { title, description, url, posts, site } = options2;
+  return {
+    "@context": "https://schema.org",
+    "@type": "CollectionPage",
+    name: title,
+    description,
+    url,
+    mainEntity: {
+      "@type": "ItemList",
+      itemListElement: posts.slice(0, 10).map((post, index) => ({
+        "@type": "ListItem",
+        position: index + 1,
+        url: `${site.baseUrl}${post.url}`
+      }))
+    }
+  };
+}
 function toScriptTag(jsonLd) {
   const json2 = JSON.stringify(jsonLd, null, 2);
   return `<script type="application/ld+json">
@@ -33482,6 +33500,7 @@ class SiteGenerator {
       this.generateIndexPage(),
       this.generatePostPages(),
       this.generateTagPages(),
+      this.generateMapPage(),
       this.generateYearArchives(),
       this.generateRSSFeed(),
       this.generateSitemap(),
@@ -33517,12 +33536,25 @@ class SiteGenerator {
         const endIndex = startIndex + pageSize;
         const paginatedPosts = yearPosts.slice(startIndex, endIndex);
         const pagination = this.createPagination(yearPosts, page, pageSize, `/${year}/`);
+        let jsonLd = "";
+        if (page === 1) {
+          const schema = generateCollectionPageSchema({
+            title: `Posts from ${year}`,
+            description: `Articles published in ${year}`,
+            url: `${this.options.config.baseUrl}/${year}/`,
+            posts: yearPosts,
+            site: this.options.config
+          });
+          jsonLd = toScriptTag(schema);
+        }
         const yearPageHtml = import_nunjucks.default.render("archive.njk", {
           site: this.options.config,
           posts: paginatedPosts,
           tags: this.getSortedTags(this.options.config.maxTagsOnHomepage),
           year,
-          pagination
+          pagination,
+          noindex: page > 2,
+          jsonLd
         });
         if (page === 1) {
           await Bun.write(path5.join(yearDir, "index.html"), yearPageHtml);
@@ -33555,7 +33587,8 @@ class SiteGenerator {
         posts: paginatedPosts,
         tags: this.getSortedTags(this.options.config.maxTagsOnHomepage),
         pagination,
-        jsonLd
+        jsonLd,
+        noindex: page > 2
       });
       if (page === 1) {
         await Bun.write(path5.join(this.options.outputDir, "index.html"), pageHtml);
@@ -33609,11 +33642,25 @@ class SiteGenerator {
           posts: paginatedPosts
         };
         const pagination = this.createPagination(tagData.posts, page, pageSize, `/tags/${tagData.slug}/`);
+        let jsonLd = "";
+        if (page === 1) {
+          const description = tagData.description || `Articles tagged with ${tagName}`;
+          const schema = generateCollectionPageSchema({
+            title: `${tagName}`,
+            description,
+            url: `${this.options.config.baseUrl}/tags/${tagData.slug}/`,
+            posts: tagData.posts,
+            site: this.options.config
+          });
+          jsonLd = toScriptTag(schema);
+        }
         const tagPageHtml = import_nunjucks.default.render("tag.njk", {
           site: this.options.config,
           tag: paginatedTagData,
           tags: Object.values(this.site.tags),
-          pagination
+          pagination,
+          noindex: page > 2,
+          jsonLd
         });
         if (page === 1) {
           await Bun.write(path5.join(tagDir, "index.html"), tagPageHtml);
@@ -33625,6 +33672,24 @@ class SiteGenerator {
       }
     }
   }
+  async generateMapPage() {
+    try {
+      const mapDir = path5.join(this.options.outputDir, "map");
+      await ensureDir(mapDir);
+      const mapHtml = import_nunjucks.default.render("map.njk", {
+        site: this.options.config,
+        posts: this.site.posts
+      });
+      await Bun.write(path5.join(mapDir, "index.html"), mapHtml);
+      console.log("Generated map page");
+    } catch (error) {
+      if (error instanceof Error && error.message.includes("map.njk")) {
+        console.log("No map.njk template found, skipping map page generation");
+      } else {
+        console.warn("Error generating map page:", error);
+      }
+    }
+  }
   async generateStylesheet() {
     const cssConfig = this.options.config.css || getDefaultCSSConfig();
     if (!cssConfig.enabled) {
@@ -33749,8 +33814,13 @@ class SiteGenerator {
         itemXml += `
       <author>${config.authorEmail}</author>`;
       }
+      let description = post.excerpt;
+      if (featuredImage) {
+        const absoluteImageUrl = featuredImage.startsWith("http") ? featuredImage : `${config.baseUrl}${featuredImage}`;
+        description = `<img src="${this.escapeXml(absoluteImageUrl)}" alt="" style="max-width:100%; height:auto;" /><br/><br/>${post.excerpt}`;
+      }
       itemXml += `
-      <description><![CDATA[${post.excerpt}]]></description>`;
+      <description><![CDATA[${description}]]></description>`;
       if (post.tags.length > 0) {
         itemXml += `
 ${categoryTags}`;
@@ -33761,6 +33831,8 @@ ${categoryTags}`;
         const absoluteImageUrl = featuredImage.startsWith("http") ? featuredImage : `${config.baseUrl}${featuredImage}`;
         itemXml += `
       <media:thumbnail url="${this.escapeXml(absoluteImageUrl)}" />`;
+        itemXml += `
+      <enclosure url="${this.escapeXml(absoluteImageUrl)}" type="image/jpeg" length="0" />`;
       }
       itemXml += `
     </item>`;
@@ -33769,7 +33841,7 @@ ${categoryTags}`;
 `);
     let channelXml = `  <channel>
     <title><![CDATA[${config.title}]]></title>
-    <link>${config.baseUrl}</link>
+    <link>${config.baseUrl}/</link>
     <description><![CDATA[${config.description}]]></description>`;
     const language = config.rssLanguage || "en-US";
     channelXml += `
@@ -33861,6 +33933,13 @@ ${rssItems}
     <changefreq>weekly</changefreq>
     <priority>0.5</priority>
   </url>
+`;
+    sitemapContent += `  <url>
+    <loc>${config.baseUrl}/map/</loc>
+    <lastmod>${currentDate}</lastmod>
+    <changefreq>weekly</changefreq>
+    <priority>0.6</priority>
+  </url>
 `;
     for (const [, tagData] of Object.entries(this.site.tags)) {
       const tagUrl = `${config.baseUrl}/tags/${tagData.slug}/`;

package/dist/index.js

@@ -31153,7 +31153,7 @@ function generateOrganizationSchema(site) {
     "@context": "https://schema.org",
     "@type": "Organization",
     name: site.title,
-    url: site.baseUrl
+    url: `${site.baseUrl}/`
   };
   if (site.description) {
     organization.description = site.description;
@@ -31186,7 +31186,7 @@ function generateBlogPostingSchema(options2) {
   blogPosting.publisher = {
     "@type": "Organization",
     name: site.title,
-    url: site.baseUrl
+    url: `${site.baseUrl}/`
   };
   if (imageUrl) {
     blogPosting.image = imageUrl;
@@ -31210,7 +31210,7 @@ function generateWebSiteSchema(options2) {
     "@context": "https://schema.org",
     "@type": "WebSite",
     name: site.title,
-    url: site.baseUrl
+    url: `${site.baseUrl}/`
   };
   if (site.description) {
     webSite.description = site.description;
@@ -31245,7 +31245,7 @@ function generateBreadcrumbListSchema(options2) {
     "@type": "ListItem",
     position: 1,
     name: "Home",
-    item: site.baseUrl
+    item: `${site.baseUrl}/`
   };
   breadcrumbs.itemListElement.push(homeItem);
   if (post) {
@@ -31258,6 +31258,24 @@ function generateBreadcrumbListSchema(options2) {
   }
   return breadcrumbs;
 }
+function generateCollectionPageSchema(options2) {
+  const { title, description, url, posts, site } = options2;
+  return {
+    "@context": "https://schema.org",
+    "@type": "CollectionPage",
+    name: title,
+    description,
+    url,
+    mainEntity: {
+      "@type": "ItemList",
+      itemListElement: posts.slice(0, 10).map((post, index) => ({
+        "@type": "ListItem",
+        position: index + 1,
+        url: `${site.baseUrl}${post.url}`
+      }))
+    }
+  };
+}
 function toScriptTag(jsonLd) {
   const json2 = JSON.stringify(jsonLd, null, 2);
   return `<script type="application/ld+json">
@@ -31429,6 +31447,7 @@ class SiteGenerator {
       this.generateIndexPage(),
       this.generatePostPages(),
       this.generateTagPages(),
+      this.generateMapPage(),
       this.generateYearArchives(),
       this.generateRSSFeed(),
       this.generateSitemap(),
@@ -31464,12 +31483,25 @@ class SiteGenerator {
         const endIndex = startIndex + pageSize;
         const paginatedPosts = yearPosts.slice(startIndex, endIndex);
         const pagination = this.createPagination(yearPosts, page, pageSize, `/${year}/`);
+        let jsonLd = "";
+        if (page === 1) {
+          const schema = generateCollectionPageSchema({
+            title: `Posts from ${year}`,
+            description: `Articles published in ${year}`,
+            url: `${this.options.config.baseUrl}/${year}/`,
+            posts: yearPosts,
+            site: this.options.config
+          });
+          jsonLd = toScriptTag(schema);
+        }
         const yearPageHtml = import_nunjucks.default.render("archive.njk", {
           site: this.options.config,
           posts: paginatedPosts,
           tags: this.getSortedTags(this.options.config.maxTagsOnHomepage),
           year,
-          pagination
+          pagination,
+          noindex: page > 2,
+          jsonLd
         });
         if (page === 1) {
           await Bun.write(path5.join(yearDir, "index.html"), yearPageHtml);
@@ -31502,7 +31534,8 @@ class SiteGenerator {
         posts: paginatedPosts,
         tags: this.getSortedTags(this.options.config.maxTagsOnHomepage),
         pagination,
-        jsonLd
+        jsonLd,
+        noindex: page > 2
       });
       if (page === 1) {
         await Bun.write(path5.join(this.options.outputDir, "index.html"), pageHtml);
@@ -31556,11 +31589,25 @@ class SiteGenerator {
           posts: paginatedPosts
         };
         const pagination = this.createPagination(tagData.posts, page, pageSize, `/tags/${tagData.slug}/`);
+        let jsonLd = "";
+        if (page === 1) {
+          const description = tagData.description || `Articles tagged with ${tagName}`;
+          const schema = generateCollectionPageSchema({
+            title: `${tagName}`,
+            description,
+            url: `${this.options.config.baseUrl}/tags/${tagData.slug}/`,
+            posts: tagData.posts,
+            site: this.options.config
+          });
+          jsonLd = toScriptTag(schema);
+        }
         const tagPageHtml = import_nunjucks.default.render("tag.njk", {
           site: this.options.config,
           tag: paginatedTagData,
           tags: Object.values(this.site.tags),
-          pagination
+          pagination,
+          noindex: page > 2,
+          jsonLd
         });
         if (page === 1) {
           await Bun.write(path5.join(tagDir, "index.html"), tagPageHtml);
@@ -31572,6 +31619,24 @@ class SiteGenerator {
       }
     }
   }
+  async generateMapPage() {
+    try {
+      const mapDir = path5.join(this.options.outputDir, "map");
+      await ensureDir(mapDir);
+      const mapHtml = import_nunjucks.default.render("map.njk", {
+        site: this.options.config,
+        posts: this.site.posts
+      });
+      await Bun.write(path5.join(mapDir, "index.html"), mapHtml);
+      console.log("Generated map page");
+    } catch (error) {
+      if (error instanceof Error && error.message.includes("map.njk")) {
+        console.log("No map.njk template found, skipping map page generation");
+      } else {
+        console.warn("Error generating map page:", error);
+      }
+    }
+  }
   async generateStylesheet() {
     const cssConfig = this.options.config.css || getDefaultCSSConfig();
     if (!cssConfig.enabled) {
@@ -31696,8 +31761,13 @@ class SiteGenerator {
         itemXml += `
       <author>${config.authorEmail}</author>`;
       }
+      let description = post.excerpt;
+      if (featuredImage) {
+        const absoluteImageUrl = featuredImage.startsWith("http") ? featuredImage : `${config.baseUrl}${featuredImage}`;
+        description = `<img src="${this.escapeXml(absoluteImageUrl)}" alt="" style="max-width:100%; height:auto;" /><br/><br/>${post.excerpt}`;
+      }
       itemXml += `
-      <description><![CDATA[${post.excerpt}]]></description>`;
+      <description><![CDATA[${description}]]></description>`;
       if (post.tags.length > 0) {
         itemXml += `
 ${categoryTags}`;
@@ -31708,6 +31778,8 @@ ${categoryTags}`;
         const absoluteImageUrl = featuredImage.startsWith("http") ? featuredImage : `${config.baseUrl}${featuredImage}`;
         itemXml += `
       <media:thumbnail url="${this.escapeXml(absoluteImageUrl)}" />`;
+        itemXml += `
+      <enclosure url="${this.escapeXml(absoluteImageUrl)}" type="image/jpeg" length="0" />`;
       }
       itemXml += `
     </item>`;
@@ -31716,7 +31788,7 @@ ${categoryTags}`;
 `);
     let channelXml = `  <channel>
     <title><![CDATA[${config.title}]]></title>
-    <link>${config.baseUrl}</link>
+    <link>${config.baseUrl}/</link>
     <description><![CDATA[${config.description}]]></description>`;
     const language = config.rssLanguage || "en-US";
     channelXml += `
@@ -31808,6 +31880,13 @@ ${rssItems}
     <changefreq>weekly</changefreq>
     <priority>0.5</priority>
   </url>
+`;
+    sitemapContent += `  <url>
+    <loc>${config.baseUrl}/map/</loc>
+    <lastmod>${currentDate}</lastmod>
+    <changefreq>weekly</changefreq>
+    <priority>0.6</priority>
+  </url>
 `;
     for (const [, tagData] of Object.entries(this.site.tags)) {
       const tagUrl = `${config.baseUrl}/tags/${tagData.slug}/`;

package/dist/site-generator.d.ts

@@ -14,6 +14,7 @@ export declare class SiteGenerator {
     private generateIndexPage;
     private generatePostPages;
     private generateTagPages;
+    private generateMapPage;
     private generateStylesheet;
     private fallbackCSSGeneration;
     private copyStaticAssets;

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

@@ -58,6 +58,21 @@ export interface BreadcrumbListOptions {
         url: string;
     }>;
 }
+/**
+ * Options for generating CollectionPage JSON-LD
+ */
+export interface CollectionPageOptions {
+    /** Page title */
+    title: string;
+    /** Page description */
+    description: string;
+    /** Page URL */
+    url: string;
+    /** Posts to include in the collection */
+    posts: Post[];
+    /** Site configuration */
+    site: SiteConfig;
+}
 /**
  * Generates a Person schema for author information
  *
@@ -136,6 +151,27 @@ export declare function generateWebSiteSchema(options: WebSiteOptions): SchemaOr
  * @see https://schema.org/BreadcrumbList
  */
 export declare function generateBreadcrumbListSchema(options: BreadcrumbListOptions): SchemaOrgThing;
+/**
+ * Generates CollectionPage structured data for archive and tag pages
+ *
+ * This schema helps search engines understand that a page contains a collection
+ * of blog posts, improving indexing of archive, tag, and category pages.
+ *
+ * @param options - CollectionPage generation options
+ * @returns CollectionPage schema as JSON-LD object
+ *
+ * @example
+ * const jsonLd = generateCollectionPageSchema({
+ *   title: "Posts from 2025",
+ *   description: "All articles published in 2025",
+ *   url: "https://example.com/2025/",
+ *   posts: [...],
+ *   site: { title: "My Blog", baseUrl: "https://example.com" }
+ * });
+ *
+ * @see https://schema.org/CollectionPage
+ */
+export declare function generateCollectionPageSchema(options: CollectionPageOptions): SchemaOrgThing;
 /**
  * Converts a JSON-LD object to an HTML script tag string
  *

package/package.json

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