bunki 0.18.6 → 0.19.0

package/dist/cli.js

@@ -5,15 +5,29 @@ var __getProtoOf = Object.getPrototypeOf;
 var __defProp = Object.defineProperty;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
+function __accessProp(key) {
+  return this[key];
+}
+var __toESMCache_node;
+var __toESMCache_esm;
 var __toESM = (mod, isNodeMode, target) => {
+  var canCache = mod != null && typeof mod === "object";
+  if (canCache) {
+    var cache = isNodeMode ? __toESMCache_node ??= new WeakMap : __toESMCache_esm ??= new WeakMap;
+    var cached = cache.get(mod);
+    if (cached)
+      return cached;
+  }
   target = mod != null ? __create(__getProtoOf(mod)) : {};
   const to = isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target;
   for (let key of __getOwnPropNames(mod))
     if (!__hasOwnProp.call(to, key))
       __defProp(to, key, {
-        get: () => mod[key],
+        get: __accessProp.bind(mod, key),
         enumerable: true
       });
+  if (canCache)
+    cache.set(mod, to);
   return to;
 };
 var __commonJS = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
@@ -28555,11 +28569,11 @@ function registerCssCommand(program2) {
 }
 
 // src/cli/commands/generate.ts
-import path10 from "path";
+import path11 from "path";
 
 // src/site-generator.ts
 var import_slugify = __toESM(require_slugify(), 1);
-import path9 from "path";
+import path10 from "path";
 
 // src/parser.ts
 import path5 from "path";
@@ -33136,6 +33150,12 @@ function createMarked(cdnConfig) {
         return markdown2;
       },
       postprocess(html) {
+        if (cdnConfig?.enabled && cdnConfig.postYear) {
+          const year = cdnConfig.postYear;
+          const base = cdnConfig.baseUrl;
+          html = html.replace(/src=(["'])\.\/\_assets\/([^\s"']+)\1/g, (_m, q2, filename) => `src=${q2}${base}/${year}/${filename}${q2}`);
+          html = html.replace(/!\[([^\]]*)\]\(\.\/\_assets\/([^\s)]+)\)/g, (_m, alt, filename) => `<img src="${base}/${year}/${filename}" alt="${alt}" loading="lazy">`);
+        }
         html = html.replace(YOUTUBE_EMBED_REGEX, '<div class="video-container"><iframe src="https://www.youtube.com/embed/$4" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen loading="lazy"></iframe></div>');
         html = html.replace(/<img /g, '<img loading="lazy" ');
         return html.replace(EXTERNAL_LINK_REGEX, (match, protocol, rest) => {
@@ -33374,7 +33394,9 @@ async function parseMarkdownFile(filePath, cdnConfig) {
     const slug = getBaseFilename(filePath);
     const pacificDate = toPacificTime(data.date);
     const postYear = getPacificYear(data.date);
-    const cdnConfigWithYear = cdnConfig ? { ...cdnConfig, postYear: String(postYear) } : undefined;
+    const yearFromPath = filePath.match(/\/(\d{4})\//)?.[1];
+    const resolvedYear = String(postYear) !== "NaN" ? String(postYear) : yearFromPath;
+    const cdnConfigWithYear = cdnConfig && resolvedYear ? { ...cdnConfig, postYear: resolvedYear } : undefined;
     const sanitizedHtml = convertMarkdownToHtml(content, cdnConfigWithYear);
     const post = {
       title: data.title,
@@ -34432,8 +34454,13 @@ function displayMetrics(metrics) {
 
 // src/utils/template-engine.ts
 var import_nunjucks2 = __toESM(require_nunjucks(), 1);
+import path9 from "path";
+import { existsSync } from "fs";
+var _distFragments = path9.join(import.meta.dir, "fragments");
+var _srcFragments = path9.join(import.meta.dir, "../fragments");
+var BUNKI_FRAGMENTS_DIR = existsSync(_distFragments) ? _distFragments : _srcFragments;
 function createTemplateEngine(templatesDir, watch = false) {
-  const env = import_nunjucks2.default.configure(templatesDir, {
+  const env = import_nunjucks2.default.configure([templatesDir, BUNKI_FRAGMENTS_DIR], {
     autoescape: true,
     watch
   });
@@ -34484,12 +34511,24 @@ class SiteGenerator {
   async initialize() {
     this.metrics.startStage("initialization");
     console.log("Initializing site generator...");
+    const flatAssetsDir = path10.join(process.cwd(), "content", "_assets");
+    try {
+      const stat = await import("fs/promises").then((m3) => m3.stat(flatAssetsDir));
+      if (stat.isDirectory()) {
+        throw new Error(`Build error: content/_assets/ must not exist.
+Images must be placed in content/{year}/_assets/ (e.g. content/2025/_assets/).
+Move any files from content/_assets/ into the correct year folder and retry.`);
+      }
+    } catch (err) {
+      if (err.code !== "ENOENT")
+        throw err;
+    }
     await ensureDir(this.options.outputDir);
     if (this.options.config.noFollowExceptions) {
       setNoFollowExceptions(this.options.config.noFollowExceptions);
     }
     let tagDescriptions = {};
-    const tagsTomlPath = path9.join(process.cwd(), "src", "tags.toml");
+    const tagsTomlPath = path10.join(process.cwd(), "src", "tags.toml");
     const tagsTomlFile = Bun.file(tagsTomlPath);
     if (await tagsTomlFile.exists()) {
       try {
@@ -34551,8 +34590,8 @@ class SiteGenerator {
     this.metrics.startStage("cssProcessing");
     let cssChanged = true;
     if (this.cache && this.incrementalMode && this.options.config.css) {
-      const cssInputPath = path9.resolve(process.cwd(), this.options.config.css.input);
-      const cssOutputPath = path9.join(this.options.outputDir, this.options.config.css.output);
+      const cssInputPath = path10.resolve(process.cwd(), this.options.config.css.input);
+      const cssOutputPath = path10.join(this.options.outputDir, this.options.config.css.output);
       const cssOutputExists = await Bun.file(cssOutputPath).exists();
       cssChanged = await hasFileChanged(cssInputPath, this.cache);
       if (!cssChanged && cssOutputExists) {
@@ -34586,19 +34625,19 @@ class SiteGenerator {
   }
   async generateFeeds() {
     const rssContent = generateRSSFeed(this.site, this.options.config);
-    await Bun.write(path9.join(this.options.outputDir, "feed.xml"), rssContent);
+    await Bun.write(path10.join(this.options.outputDir, "feed.xml"), rssContent);
     const sitemapContent = generateSitemap(this.site, this.options.config, PAGINATION.DEFAULT_PAGE_SIZE);
-    await Bun.write(path9.join(this.options.outputDir, "sitemap.xml"), sitemapContent);
+    await Bun.write(path10.join(this.options.outputDir, "sitemap.xml"), sitemapContent);
     console.log("Generated sitemap.xml");
     const urlCount = this.site.posts.length + Object.keys(this.site.tags).length + 10;
     const sitemapSize = sitemapContent.length;
     if (urlCount > FILES.MAX_SITEMAP_URLS || sitemapSize > FILES.MAX_SITEMAP_SIZE) {
       const sitemapIndexContent = generateSitemapIndex(this.options.config);
-      await Bun.write(path9.join(this.options.outputDir, "sitemap_index.xml"), sitemapIndexContent);
+      await Bun.write(path10.join(this.options.outputDir, "sitemap_index.xml"), sitemapIndexContent);
       console.log("Generated sitemap_index.xml");
     }
     const robotsTxtContent = generateRobotsTxt(this.options.config);
-    await Bun.write(path9.join(this.options.outputDir, "robots.txt"), robotsTxtContent);
+    await Bun.write(path10.join(this.options.outputDir, "robots.txt"), robotsTxtContent);
     console.log("Generated robots.txt");
   }
   async parseContent() {
@@ -34615,7 +34654,7 @@ class SiteGenerator {
       return posts;
     }
     const allFiles = await findFilesByPattern("**/*.md", this.options.contentDir, true);
-    const configPath = path9.join(process.cwd(), "bunki.config.ts");
+    const configPath = path10.join(process.cwd(), "bunki.config.ts");
     const configChanged = await hasConfigChanged(configPath, this.cache);
     if (configChanged) {
       console.log("Config changed, full rebuild required");
@@ -34694,10 +34733,10 @@ var defaultDeps2 = {
 };
 async function handleGenerateCommand(options2, deps = defaultDeps2) {
   try {
-    const configPath = path10.resolve(options2.config);
-    const contentDir = path10.resolve(options2.content);
-    const outputDir = path10.resolve(options2.output);
-    const templatesDir = path10.resolve(options2.templates);
+    const configPath = path11.resolve(options2.config);
+    const contentDir = path11.resolve(options2.content);
+    const outputDir = path11.resolve(options2.output);
+    const templatesDir = path11.resolve(options2.templates);
     deps.logger.log("Generating site with:");
     deps.logger.log(`- Config file: ${configPath}`);
     deps.logger.log(`- Content directory: ${contentDir}`);
@@ -34731,11 +34770,11 @@ function registerGenerateCommand(program2) {
 }
 
 // src/utils/image-uploader.ts
-import path12 from "path";
+import path13 from "path";
 
 // src/utils/s3-uploader.ts
 var {S3Client } = globalThis.Bun;
-import path11 from "path";
+import path12 from "path";
 
 class S3Uploader {
   s3Config;
@@ -34858,7 +34897,7 @@ class S3Uploader {
       let failedCount = 0;
       const uploadTasks = imageFiles.map((imageFile) => async () => {
         try {
-          const imagePath = path11.join(imagesDir, imageFile);
+          const imagePath = path12.join(imagesDir, imageFile);
           const s3Key = keyTransform ? keyTransform(imageFile) : imageFile;
           const file = Bun.file(imagePath);
           if (process.env.BUNKI_DRY_RUN === "true") {} else {
@@ -34892,13 +34931,13 @@ function createUploader(config) {
 }
 
 // src/utils/image-uploader.ts
-var DEFAULT_IMAGES_DIR = path12.join(process.cwd(), "assets");
-var DEFAULT_CONTENT_DIR2 = path12.join(process.cwd(), "content");
+var DEFAULT_IMAGES_DIR = path13.join(process.cwd(), "assets");
+var DEFAULT_CONTENT_DIR2 = path13.join(process.cwd(), "content");
 async function uploadImages(options2 = {}) {
   try {
     const contentAssetsMode = options2.contentAssets === true;
     const defaultDir = contentAssetsMode ? DEFAULT_CONTENT_DIR2 : DEFAULT_IMAGES_DIR;
-    const imagesDir = path12.resolve(options2.images || defaultDir);
+    const imagesDir = path13.resolve(options2.images || defaultDir);
     if (!await fileExists(imagesDir)) {
       console.log(`Creating images directory at ${imagesDir}...`);
       await ensureDir(imagesDir);
@@ -34950,7 +34989,7 @@ async function uploadImages(options2 = {}) {
     const uploader = createUploader(s3Config);
     const imageUrlMap = await uploader.uploadImages(imagesDir, options2.minYear, keyTransform);
     if (options2.outputJson) {
-      const outputFile = path12.resolve(options2.outputJson);
+      const outputFile = path13.resolve(options2.outputJson);
       await Bun.write(outputFile, JSON.stringify(imageUrlMap, null, 2));
       console.log(`Image URL mapping saved to ${outputFile}`);
     }
@@ -34998,7 +35037,7 @@ function registerImagesPushCommand(program2) {
 }
 
 // src/cli/commands/init.ts
-import path13 from "path";
+import path14 from "path";
 var defaultDependencies = {
   createDefaultConfig,
   ensureDir,
@@ -35008,7 +35047,7 @@ var defaultDependencies = {
 };
 async function handleInitCommand(options2, deps = defaultDependencies) {
   try {
-    const configPath = path13.resolve(options2.config);
+    const configPath = path14.resolve(options2.config);
     const configCreated = await deps.createDefaultConfig(configPath);
     if (!configCreated) {
       deps.logger.log(`
@@ -35017,19 +35056,19 @@ Skipped initialization because the config file already exists`);
     }
     deps.logger.log("Creating directory structure...");
     const baseDir = process.cwd();
-    const contentDir = path13.join(baseDir, "content");
-    const templatesDir = path13.join(baseDir, "templates");
-    const stylesDir = path13.join(templatesDir, "styles");
-    const publicDir = path13.join(baseDir, "public");
+    const contentDir = path14.join(baseDir, "content");
+    const templatesDir = path14.join(baseDir, "templates");
+    const stylesDir = path14.join(templatesDir, "styles");
+    const publicDir = path14.join(baseDir, "public");
     await deps.ensureDir(contentDir);
     await deps.ensureDir(templatesDir);
     await deps.ensureDir(stylesDir);
     await deps.ensureDir(publicDir);
     for (const [filename, content] of Object.entries(getDefaultTemplates())) {
-      await deps.writeFile(path13.join(templatesDir, filename), content);
+      await deps.writeFile(path14.join(templatesDir, filename), content);
     }
-    await deps.writeFile(path13.join(stylesDir, "main.css"), getDefaultCss());
-    await deps.writeFile(path13.join(contentDir, "welcome.md"), getSamplePost());
+    await deps.writeFile(path14.join(stylesDir, "main.css"), getDefaultCss());
+    await deps.writeFile(path14.join(contentDir, "welcome.md"), getSamplePost());
     deps.logger.log(`
 Initialization complete! Here are the next steps:`);
     deps.logger.log("1. Edit bunki.config.ts to configure your site");
@@ -35049,221 +35088,302 @@ function registerInitCommand(program2, deps = defaultDependencies) {
 function getDefaultTemplates() {
   return {
     "base.njk": String.raw`<!DOCTYPE html>
-  <html lang="en">
-  <head>
-    <meta charset="UTF-8">
-    <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <title>{% block title %}{{ site.title }}{% endblock %}</title>
-    <meta name="description" content="{% block description %}{{ site.description }}{% endblock %}">
-    <link rel="stylesheet" href="/css/style.css">
-    {% block head %}{% endblock %}
-  </head>
-  <body>
-    <header>
-      <div class="container">
-        <h1><a href="/">{{ site.title }}</a></h1>
-        <nav>
-          <ul>
-            <li><a href="/">Home</a></li>
-            <li><a href="/tags/">Tags</a></li>
-          </ul>
-        </nav>
-      </div>
-    </header>
-
-    <main class="container">
-      {% block content %}{% endblock %}
-    </main>
-
-    <footer>
-      <div class="container">
-        <p>&copy; {{ "now" | date("YYYY") }} {{ site.title }}</p>
-      </div>
-    </footer>
-  </body>
-  </html>`,
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>{% block title %}{{ site.title }}{% endblock %}</title>
+  <meta name="description" content="{% block description %}{{ site.description }}{% endblock %}">
+
+  {# Canonical URL #}
+  <link rel="canonical" href="{% block canonical %}{{ site.baseUrl }}/{% endblock %}">
+
+  {# Open Graph meta tags #}
+  <meta property="og:type" content="{% block og_type %}website{% endblock %}">
+  <meta property="og:title" content="{% block og_title %}{{ site.title }}{% endblock %}">
+  <meta property="og:description" content="{% block og_description %}{{ site.description }}{% endblock %}">
+  <meta property="og:url" content="{% block og_url %}{{ site.baseUrl }}/{% endblock %}">
+  <meta property="og:site_name" content="{{ site.title }}">
+  {% block og_image %}{% endblock %}
+
+  {# Twitter Card meta tags #}
+  <meta name="twitter:card" content="{% block twitter_card %}summary{% endblock %}">
+  <meta name="twitter:title" content="{% block twitter_title %}{{ site.title }}{% endblock %}">
+  <meta name="twitter:description" content="{% block twitter_description %}{{ site.description }}{% endblock %}">
+  {% block twitter_image %}{% endblock %}
+
+  <link rel="stylesheet" href="/css/style.css">
+  <link rel="alternate" type="application/rss+xml" title="{{ site.title }} RSS Feed" href="{{ site.baseUrl }}/feed.xml">
+  {% block head %}{% endblock %}
+</head>
+<body>
+  <header>
+    <div class="container">
+      <h1><a href="/">{{ site.title }}</a></h1>
+      <nav>
+        <ul>
+          <li><a href="/">Home</a></li>
+          <li><a href="/tags/">Tags</a></li>
+        </ul>
+      </nav>
+    </div>
+  </header>
+
+  <main class="container">
+    {% block content %}{% endblock %}
+  </main>
+
+  <footer>
+    <div class="container">
+      <p>&copy; {{ "now" | date("YYYY") }} {{ site.title }} - Powered by <a href="https://github.com/kahwee/bunki">Bunki</a></p>
+    </div>
+  </footer>
+</body>
+</html>`,
     "index.njk": String.raw`{% extends "base.njk" %}
 
-  {% block content %}
-    <h1>Latest Posts</h1>
-
-    {% if posts.length > 0 %}
-      <div class="posts">
-        {% for post in posts %}
-          <article class="post-card">
-            <h2><a href="{{ post.url }}">{{ post.title }}</a></h2>
-            <div class="post-meta">
-              <time datetime="{{ post.date }}">{{ post.date | date("MMMM D, YYYY") }}</time>
-              {% if post.tags.length > 0 %}
-                <span class="tags">
-                  {% for tag in post.tags %}
-                    <a href="/tags/{{ post.tagSlugs[tag] }}/">{{ tag }}</a>{% if not loop.last %}, {% endif %}
-                  {% endfor %}
-                </span>
-              {% endif %}
-            </div>
-            <div class="post-excerpt">{{ post.excerpt }}</div>
-            <a href="{{ post.url }}" class="read-more">Read more \u2192</a>
-          </article>
-        {% endfor %}
-      </div>
-
-      {% if pagination.totalPages > 1 %}
-        <nav class="pagination">
-          {% if pagination.hasPrevPage %}
-            <a href="{{ pagination.pagePath }}{% if pagination.prevPage > 1 %}page/{{ pagination.prevPage }}/{% endif %}" class="prev">\u2190 Previous</a>
-          {% endif %}
-
-          {% if pagination.hasNextPage %}
-            <a href="{{ pagination.pagePath }}page/{{ pagination.nextPage }}/" class="next">Next \u2192</a>
-          {% endif %}
-
-          <span class="page-info">Page {{ pagination.currentPage }} of {{ pagination.totalPages }}</span>
-        </nav>
-      {% endif %}
-    {% else %}
-      <p>No posts yet!</p>
+{% block canonical %}{{ site.baseUrl }}/{% if pagination.currentPage > 1 %}page/{{ pagination.currentPage }}/{% endif %}{% endblock %}
+{% block og_url %}{{ site.baseUrl }}/{% if pagination.currentPage > 1 %}page/{{ pagination.currentPage }}/{% endif %}{% endblock %}
+
+{% block content %}
+  <h1>Latest Posts</h1>
+
+  {% if posts.length > 0 %}
+    <div class="posts">
+      {% for post in posts %}
+        <article class="post-card">
+          <h2><a href="{{ post.url }}">{{ post.title }}</a></h2>
+          <div class="post-meta">
+            <time datetime="{{ post.date }}">{{ post.date | date("MMMM D, YYYY") }}</time>
+            {% if post.tags.length > 0 %}
+              <span class="tags">
+                {% for tag in post.tags %}
+                  <a href="/tags/{{ post.tagSlugs[tag] }}/">{{ tag }}</a>{% if not loop.last %}, {% endif %}
+                {% endfor %}
+              </span>
+            {% endif %}
+          </div>
+          <div class="post-excerpt">{{ post.excerpt }}</div>
+          <a href="{{ post.url }}" class="read-more">Read more \u2192</a>
+        </article>
+      {% endfor %}
+    </div>
+
+    {% if pagination.totalPages > 1 %}
+      <nav class="pagination">
+        {% if pagination.hasPrevPage %}
+          <a href="{{ pagination.pagePath }}{% if pagination.prevPage > 1 %}page/{{ pagination.prevPage }}/{% endif %}" class="prev">\u2190 Previous</a>
+        {% endif %}
+        {% if pagination.hasNextPage %}
+          <a href="{{ pagination.pagePath }}page/{{ pagination.nextPage }}/" class="next">Next \u2192</a>
+        {% endif %}
+        <span class="page-info">Page {{ pagination.currentPage }} of {{ pagination.totalPages }}</span>
+      </nav>
     {% endif %}
-  {% endblock %}`,
+  {% else %}
+    <p>No posts yet.</p>
+  {% endif %}
+{% endblock %}`,
     "post.njk": String.raw`{% extends "base.njk" %}
 
-  {% block title %}{{ post.title }} | {{ site.title }}{% endblock %}
-  {% block description %}{{ post.excerpt }}{% endblock %}
-
-  {% block content %}
-    <article class="post">
-      <header class="post-header">
-        <h1>{{ post.title }}</h1>
-        <div class="post-meta">
-          <time datetime="{{ post.date }}">{{ post.date | date("MMMM D, YYYY") }}</time>
-          {% if post.tags.length > 0 %}
-            <span class="tags">
-              {% for tag in post.tags %}
-                <a href="/tags/{{ post.tagSlugs[tag] }}/">{{ tag }}</a>{% if not loop.last %}, {% endif %}
-              {% endfor %}
-            </span>
-          {% endif %}
-        </div>
-      </header>
-
-      <div class="post-content">
-        {{ post.html | safe }}
+{% from "og-image.njk" import og_image, twitter_image %}
+{% from "json-ld.njk" import blog_posting_schema %}
+
+{% block title %}{{ post.title }} | {{ site.title }}{% endblock %}
+{% block description %}{{ post.excerpt }}{% endblock %}
+
+{% block canonical %}{{ site.baseUrl }}{{ post.url }}{% endblock %}
+
+{% block og_type %}article{% endblock %}
+{% block og_title %}{{ post.title }}{% endblock %}
+{% block og_description %}{{ post.excerpt }}{% endblock %}
+{% block og_url %}{{ site.baseUrl }}{{ post.url }}{% endblock %}
+{% block og_image %}{{ og_image(post, site) }}{% endblock %}
+
+{% block twitter_card %}summary_large_image{% endblock %}
+{% block twitter_title %}{{ post.title }}{% endblock %}
+{% block twitter_description %}{{ post.excerpt }}{% endblock %}
+{% block twitter_image %}{{ twitter_image(post, site) }}{% endblock %}
+
+{% block head %}
+  {{ blog_posting_schema(post, site) }}
+{% endblock %}
+
+{% block content %}
+  <article class="post">
+    <header class="post-header">
+      <h1>{{ post.title }}</h1>
+      <div class="post-meta">
+        <time datetime="{{ post.date }}">{{ post.date | date("MMMM D, YYYY") }}</time>
+        {% if post.tags.length > 0 %}
+          <span class="tags">
+            {% for tag in post.tags %}
+              <a href="/tags/{{ post.tagSlugs[tag] }}/">{{ tag }}</a>{% if not loop.last %}, {% endif %}
+            {% endfor %}
+          </span>
+        {% endif %}
       </div>
-    </article>
-  {% endblock %}`,
-    "tag.njk": String.raw`{% extends "base.njk" %}
-
-  {% block title %}{{ tag.name }} | {{ site.title }}{% endblock %}
-  {% block description %}Posts tagged with {{ tag.name }} on {{ site.title }}{% endblock %}
-
-  {% block content %}
-    <h1>Posts tagged "{{ tag.name }}"</h1>
-
-    {% if tag.description %}
-      <div class="tag-description">{{ tag.description }}</div>
-    {% endif %}
+    </header>
 
-    {% if tag.posts.length > 0 %}
-      <div class="posts">
-        {% for post in tag.posts %}
-          <article class="post-card">
-            <h2><a href="{{ post.url }}">{{ post.title }}</a></h2>
-            <div class="post-meta">
-              <time datetime="{{ post.date }}">{{ post.date | date("MMMM D, YYYY") }}</time>
-            </div>
-            <div class="post-excerpt">{{ post.excerpt }}</div>
-            <a href="{{ post.url }}" class="read-more">Read more \u2192</a>
-          </article>
-        {% endfor %}
+    <div class="post-content">
+      {{ post.html | safe }}
+    </div>
+
+    <footer class="post-footer">
+      <div class="share-buttons">
+        <span class="share-label">Share:</span>
+        <a href="https://twitter.com/intent/tweet?text={{ post.title | urlencode }}&url={{ site.baseUrl }}{{ post.url }}" target="_blank" rel="noopener noreferrer" class="share-button x" aria-label="Share on X">
+          <svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="currentColor"><path d="M18.244 2.25h3.308l-7.227 8.26 8.502 11.24H16.17l-5.214-6.817L4.99 21.75H1.68l7.73-8.835L1.254 2.25H8.08l4.713 6.231zm-1.161 17.52h1.833L7.084 4.126H5.117z"/></svg>
+        </a>
+        <a href="https://www.facebook.com/sharer/sharer.php?u={{ site.baseUrl }}{{ post.url }}" target="_blank" rel="noopener noreferrer" class="share-button facebook" aria-label="Share on Facebook">
+          <svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="currentColor"><path d="M9.101 23.691v-7.98H6.627v-3.667h2.474v-1.58c0-4.085 1.848-5.978 5.858-5.978.401 0 .955.042 1.468.103a8.68 8.68 0 0 1 1.141.195v3.325a8.623 8.623 0 0 0-.653-.036 26.805 26.805 0 0 0-.733-.009c-.707 0-1.259.096-1.675.309a1.686 1.686 0 0 0-.679.622c-.258.42-.374.995-.374 1.752v1.297h3.919l-.386 3.667h-3.533v7.98H9.101z"/></svg>
+        </a>
+        <a href="https://www.linkedin.com/sharing/share-offsite/?url={{ site.baseUrl }}{{ post.url }}" target="_blank" rel="noopener noreferrer" class="share-button linkedin" aria-label="Share on LinkedIn">
+          <svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="currentColor"><path d="M6.5 21.5h-5v-13h5v13zM4 6.5C2.5 6.5 1.5 5.3 1.5 4s1-2.4 2.5-2.4c1.6 0 2.5 1 2.6 2.5 0 1.4-1 2.5-2.6 2.5zm11.5 6c-1 0-2 1-2 2v7h-5v-13h5V10s1.6-1.5 4-1.5c3 0 5 2.2 5 6.3v6.7h-5v-7c0-1-1-2-2-2z"/></svg>
+        </a>
+        <a href="mailto:?subject={{ post.title | urlencode }}&body=Check%20out%20this%20article%3A%20{{ site.baseUrl }}{{ post.url }}" class="share-button email" aria-label="Share via Email">
+          <svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M4 4h16c1.1 0 2 .9 2 2v12c0 1.1-.9 2-2 2H4c-1.1 0-2-.9-2-2V6c0-1.1.9-2 2-2z"></path><polyline points="22,6 12,13 2,6"></polyline></svg>
+        </a>
       </div>
+    </footer>
+  </article>
+{% endblock %}`,
+    "tag.njk": String.raw`{% extends "base.njk" %}
 
-      {% if pagination.totalPages > 1 %}
-        <nav class="pagination">
-          {% if pagination.hasPrevPage %}
-            <a href="{{ pagination.pagePath }}{% if pagination.prevPage > 1 %}page/{{ pagination.prevPage }}/{% endif %}" class="prev">\u2190 Previous</a>
-          {% endif %}
-
-          {% if pagination.hasNextPage %}
-            <a href="{{ pagination.pagePath }}page/{{ pagination.nextPage }}/" class="next">Next \u2192</a>
-          {% endif %}
-
-          <span class="page-info">Page {{ pagination.currentPage }} of {{ pagination.totalPages }}</span>
-        </nav>
-      {% endif %}
-    {% else %}
-      <p>No posts with this tag yet!</p>
+{% block title %}{{ tag.name }} | {{ site.title }}{% endblock %}
+{% block description %}Posts tagged with {{ tag.name }} on {{ site.title }}{% endblock %}
+
+{% block canonical %}{{ site.baseUrl }}/tags/{{ tag.slug }}/{% if pagination.currentPage > 1 %}page/{{ pagination.currentPage }}/{% endif %}{% endblock %}
+
+{% block og_title %}{{ tag.name }} | {{ site.title }}{% endblock %}
+{% block og_description %}Posts tagged with {{ tag.name }} on {{ site.title }}{% endblock %}
+{% block og_url %}{{ site.baseUrl }}/tags/{{ tag.slug }}/{% if pagination.currentPage > 1 %}page/{{ pagination.currentPage }}/{% endif %}{% endblock %}
+
+{% block twitter_title %}{{ tag.name }} | {{ site.title }}{% endblock %}
+{% block twitter_description %}Posts tagged with {{ tag.name }} on {{ site.title }}{% endblock %}
+
+{% block content %}
+  <h1>Posts tagged "{{ tag.name }}"</h1>
+
+  {% if tag.description %}
+    <div class="tag-description">{{ tag.description }}</div>
+  {% endif %}
+
+  {% if tag.posts.length > 0 %}
+    <div class="posts">
+      {% for post in tag.posts %}
+        <article class="post-card">
+          <h2><a href="{{ post.url }}">{{ post.title }}</a></h2>
+          <div class="post-meta">
+            <time datetime="{{ post.date }}">{{ post.date | date("MMMM D, YYYY") }}</time>
+          </div>
+          <div class="post-excerpt">{{ post.excerpt }}</div>
+          <a href="{{ post.url }}" class="read-more">Read more \u2192</a>
+        </article>
+      {% endfor %}
+    </div>
+
+    {% if pagination.totalPages > 1 %}
+      <nav class="pagination">
+        {% if pagination.hasPrevPage %}
+          <a href="{{ pagination.pagePath }}{% if pagination.prevPage > 1 %}page/{{ pagination.prevPage }}/{% endif %}" class="prev">\u2190 Previous</a>
+        {% endif %}
+        {% if pagination.hasNextPage %}
+          <a href="{{ pagination.pagePath }}page/{{ pagination.nextPage }}/" class="next">Next \u2192</a>
+        {% endif %}
+        <span class="page-info">Page {{ pagination.currentPage }} of {{ pagination.totalPages }}</span>
+      </nav>
     {% endif %}
-  {% endblock %}`,
+  {% else %}
+    <p>No posts with this tag yet.</p>
+  {% endif %}
+{% endblock %}`,
     "tags.njk": String.raw`{% extends "base.njk" %}
 
-  {% block title %}Tags | {{ site.title }}{% endblock %}
-  {% block description %}Browse all tags on {{ site.title }}{% endblock %}
+{% block title %}Tags | {{ site.title }}{% endblock %}
+{% block description %}Browse all tags on {{ site.title }}{% endblock %}
 
-  {% block content %}
-    <h1>All Tags</h1>
+{% block canonical %}{{ site.baseUrl }}/tags/{% endblock %}
 
-    {% if tags.length > 0 %}
-      <ul class="tags-list">
-        {% for tag in tags %}
-          <li>
-            <a href="/tags/{{ tag.slug }}/">{{ tag.name }}</a>
-            <span class="count">({{ tag.count }})</span>
-            {% if tag.description %}
-              <p class="description">{{ tag.description }}</p>
-            {% endif %}
-          </li>
-        {% endfor %}
-      </ul>
-    {% else %}
-      <p>No tags found!</p>
-    {% endif %}
-  {% endblock %}`,
-    "archive.njk": String.raw`{% extends "base.njk" %}
+{% block og_title %}Tags | {{ site.title }}{% endblock %}
+{% block og_description %}Browse all tags on {{ site.title }}{% endblock %}
+{% block og_url %}{{ site.baseUrl }}/tags/{% endblock %}
 
-  {% block title %}Archive {{ year }} | {{ site.title }}{% endblock %}
-  {% block description %}Posts from {{ year }} on {{ site.title }}{% endblock %}
-
-  {% block content %}
-    <h1>Posts from {{ year }}</h1>
-
-    {% if posts.length > 0 %}
-      <div class="posts">
-        {% for post in posts %}
-          <article class="post-card">
-            <h2><a href="{{ post.url }}">{{ post.title }}</a></h2>
-            <div class="post-meta">
-              <time datetime="{{ post.date }}">{{ post.date | date("MMMM D, YYYY") }}</time>
-              {% if post.tags.length > 0 %}
-                <span class="tags">
-                  {% for tag in post.tags %}
-                    <a href="/tags/{{ post.tagSlugs[tag] }}/">{{ tag }}</a>{% if not loop.last %}, {% endif %}
-                  {% endfor %}
-                </span>
-              {% endif %}
-            </div>
-            <div class="post-excerpt">{{ post.excerpt }}</div>
-            <a href="{{ post.url }}" class="read-more">Read more \u2192</a>
-          </article>
-        {% endfor %}
-      </div>
+{% block twitter_title %}Tags | {{ site.title }}{% endblock %}
+{% block twitter_description %}Browse all tags on {{ site.title }}{% endblock %}
 
-      {% if pagination.totalPages > 1 %}
-        <nav class="pagination">
-          {% if pagination.hasPrevPage %}
-            <a href="/{{ year }}/{% if pagination.prevPage > 1 %}page/{{ pagination.prevPage }}/{% endif %}" class="prev">\u2190 Previous</a>
-          {% endif %}
+{% block content %}
+  <h1>All Tags</h1>
 
-          {% if pagination.hasNextPage %}
-            <a href="/{{ year }}/page/{{ pagination.nextPage }}/" class="next">Next \u2192</a>
+  {% if tags.length > 0 %}
+    <ul class="tags-list">
+      {% for tag in tags %}
+        <li>
+          <a href="/tags/{{ tag.slug }}/">{{ tag.name }}</a>
+          <span class="count">({{ tag.count }})</span>
+          {% if tag.description %}
+            <p class="description">{{ tag.description }}</p>
           {% endif %}
+        </li>
+      {% endfor %}
+    </ul>
+  {% else %}
+    <p>No tags yet.</p>
+  {% endif %}
+{% endblock %}`,
+    "archive.njk": String.raw`{% extends "base.njk" %}
 
-          <span class="page-info">Page {{ pagination.currentPage }} of {{ pagination.totalPages }}</span>
-        </nav>
-      {% endif %}
-    {% else %}
-      <p>No posts from {{ year }}!</p>
+{% block title %}Archive {{ year }} | {{ site.title }}{% endblock %}
+{% block description %}Posts from {{ year }} on {{ site.title }}{% endblock %}
+
+{% block canonical %}{{ site.baseUrl }}/{{ year }}/{% if pagination.currentPage > 1 %}page/{{ pagination.currentPage }}/{% endif %}{% endblock %}
+
+{% block og_title %}Archive {{ year }} | {{ site.title }}{% endblock %}
+{% block og_description %}Posts from {{ year }} on {{ site.title }}{% endblock %}
+{% block og_url %}{{ site.baseUrl }}/{{ year }}/{% if pagination.currentPage > 1 %}page/{{ pagination.currentPage }}/{% endif %}{% endblock %}
+
+{% block twitter_title %}Archive {{ year }} | {{ site.title }}{% endblock %}
+{% block twitter_description %}Posts from {{ year }} on {{ site.title }}{% endblock %}
+
+{% block content %}
+  <h1>Posts from {{ year }}</h1>
+
+  {% if posts.length > 0 %}
+    <div class="posts">
+      {% for post in posts %}
+        <article class="post-card">
+          <h2><a href="{{ post.url }}">{{ post.title }}</a></h2>
+          <div class="post-meta">
+            <time datetime="{{ post.date }}">{{ post.date | date("MMMM D, YYYY") }}</time>
+            {% if post.tags.length > 0 %}
+              <span class="tags">
+                {% for tag in post.tags %}
+                  <a href="/tags/{{ post.tagSlugs[tag] }}/">{{ tag }}</a>{% if not loop.last %}, {% endif %}
+                {% endfor %}
+              </span>
+            {% endif %}
+          </div>
+          <div class="post-excerpt">{{ post.excerpt }}</div>
+          <a href="{{ post.url }}" class="read-more">Read more \u2192</a>
+        </article>
+      {% endfor %}
+    </div>
+
+    {% if pagination.totalPages > 1 %}
+      <nav class="pagination">
+        {% if pagination.hasPrevPage %}
+          <a href="/{{ year }}/{% if pagination.prevPage > 1 %}page/{{ pagination.prevPage }}/{% endif %}" class="prev">\u2190 Previous</a>
+        {% endif %}
+        {% if pagination.hasNextPage %}
+          <a href="/{{ year }}/page/{{ pagination.nextPage }}/" class="next">Next \u2192</a>
+        {% endif %}
+        <span class="page-info">Page {{ pagination.currentPage }} of {{ pagination.totalPages }}</span>
+      </nav>
     {% endif %}
-  {% endblock %}`
+  {% else %}
+    <p>No posts from {{ year }} yet.</p>
+  {% endif %}
+{% endblock %}`
   };
 }
 function getDefaultCss() {
@@ -35458,6 +35578,43 @@ function getDefaultCss() {
     font-size: 0.9rem;
   }
 
+  /* Share buttons */
+  .post-footer {
+    margin-top: 2rem;
+    padding-top: 1.5rem;
+    border-top: 1px solid #eee;
+  }
+
+  .share-buttons {
+    display: flex;
+    align-items: center;
+    gap: 0.75rem;
+  }
+
+  .share-label {
+    font-size: 0.9rem;
+    font-weight: 500;
+    color: #6c757d;
+  }
+
+  .share-button {
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    width: 2.25rem;
+    height: 2.25rem;
+    border-radius: 50%;
+    background-color: #f5f5f5;
+    color: #555;
+    transition: background-color 0.2s, color 0.2s;
+  }
+
+  .share-button:hover { text-decoration: none; }
+  .share-button.x:hover { background-color: #000; color: #fff; }
+  .share-button.facebook:hover { background-color: #1877f2; color: #fff; }
+  .share-button.linkedin:hover { background-color: #0077b5; color: #fff; }
+  .share-button.email:hover { background-color: #6c757d; color: #fff; }
+
   /* Footer */
   footer {
     text-align: center;
@@ -35521,7 +35678,7 @@ function hello() {
 }
 
 // src/cli/commands/new-post.ts
-import path14 from "path";
+import path15 from "path";
 var defaultDeps4 = {
   writeFile: (filePath, data) => Bun.write(filePath, data),
   now: () => new Date,
@@ -35545,7 +35702,7 @@ async function handleNewCommand(title, options2, deps = defaultDeps4) {
 ` + `# ${title}
 
 `;
-    const filePath = path14.join(DEFAULT_CONTENT_DIR, `${slug}.md`);
+    const filePath = path15.join(DEFAULT_CONTENT_DIR, `${slug}.md`);
     await deps.writeFile(filePath, frontmatter);
     deps.logger.log(`Created new post: ${filePath}`);
     return filePath;
@@ -35562,11 +35719,11 @@ function registerNewCommand(program2) {
 }
 
 // src/cli/commands/serve.ts
-import path16 from "path";
+import path17 from "path";
 
 // src/server.ts
 import fs2 from "fs";
-import path15 from "path";
+import path16 from "path";
 async function startServer(outputDir = DEFAULT_OUTPUT_DIR, port = 3000) {
   try {
     const stats = await fs2.promises.stat(outputDir);
@@ -35601,18 +35758,18 @@ async function startServer(outputDir = DEFAULT_OUTPUT_DIR, port = 3000) {
         let filePath = "";
         if (homePaginationMatch) {
           const pageNumber = homePaginationMatch[1];
-          filePath = path15.join(outputDir, "page", pageNumber, "index.html");
+          filePath = path16.join(outputDir, "page", pageNumber, "index.html");
         } else if (tagPaginationMatch) {
           const tagSlug = tagPaginationMatch[1];
           const pageNumber = tagPaginationMatch[2];
-          filePath = path15.join(outputDir, "tags", tagSlug, "page", pageNumber, "index.html");
+          filePath = path16.join(outputDir, "tags", tagSlug, "page", pageNumber, "index.html");
         } else if (yearPaginationMatch) {
           const year = yearPaginationMatch[1];
           const pageNumber = yearPaginationMatch[2];
-          filePath = path15.join(outputDir, year, "page", pageNumber, "index.html");
+          filePath = path16.join(outputDir, year, "page", pageNumber, "index.html");
         } else {
-          const directPath = path15.join(outputDir, pathname);
-          const withoutSlash = path15.join(outputDir, pathname + ".html");
+          const directPath = path16.join(outputDir, pathname);
+          const withoutSlash = path16.join(outputDir, pathname + ".html");
           const withHtml = pathname.endsWith(".html") ? directPath : withoutSlash;
           const bunFileDirect = Bun.file(directPath);
           const bunFileHtml = Bun.file(withHtml);
@@ -35621,7 +35778,7 @@ async function startServer(outputDir = DEFAULT_OUTPUT_DIR, port = 3000) {
           } else if (await bunFileHtml.exists()) {
             filePath = withHtml;
           } else {
-            const indexPath = path15.join(outputDir, pathname, "index.html");
+            const indexPath = path16.join(outputDir, pathname, "index.html");
             const bunFileIndex = Bun.file(indexPath);
             if (await bunFileIndex.exists()) {
               filePath = indexPath;
@@ -35635,7 +35792,7 @@ async function startServer(outputDir = DEFAULT_OUTPUT_DIR, port = 3000) {
           }
         }
         console.log(`Serving file: ${filePath}`);
-        const extname = path15.extname(filePath);
+        const extname = path16.extname(filePath);
         let contentType = "text/html";
         switch (extname) {
           case ".js":
@@ -35694,7 +35851,7 @@ var defaultDeps5 = {
 };
 async function handleServeCommand(options2, deps = defaultDeps5) {
   try {
-    const outputDir = path16.resolve(options2.output);
+    const outputDir = path17.resolve(options2.output);
     const port = parseInt(options2.port, 10);
     await deps.startServer(outputDir, port);
   } catch (error) {
@@ -35737,7 +35894,7 @@ function registerValidateCommand(program2) {
 }
 
 // src/cli/commands/validate-media.ts
-import { readdirSync, readFileSync, existsSync, statSync } from "fs";
+import { readdirSync, readFileSync, existsSync as existsSync2, statSync } from "fs";
 import { join, dirname, resolve, basename } from "path";
 var imageExtensions = [".jpg", ".jpeg", ".png", ".webp", ".gif"];
 var videoExtensions = [".mp4", ".webm", ".mov"];
@@ -35745,7 +35902,7 @@ var mediaExtensions = [...imageExtensions, ...videoExtensions];
 async function handleValidateMediaCommand(options2, deps = { logger: console, exit: (code) => process.exit(code) }) {
   const contentDir = options2.contentDir || join(process.cwd(), "content");
   const assetsDir = join(process.cwd(), "assets");
-  if (!existsSync(contentDir)) {
+  if (!existsSync2(contentDir)) {
     deps.logger.error(`Content directory not found: ${contentDir}`);
     deps.exit(1);
   }
@@ -35867,7 +36024,7 @@ function validateMedia(contentDir, assetsDir) {
 }
 function getAllMediaFromContentAssets(contentDir) {
   const mediaFiles = [];
-  if (!existsSync(contentDir))
+  if (!existsSync2(contentDir))
     return [];
   const years = readdirSync(contentDir).filter((f) => {
     const fullPath = join(contentDir, f);
@@ -35875,7 +36032,7 @@ function getAllMediaFromContentAssets(contentDir) {
   });
   for (const year of years) {
     const assetsDir = join(contentDir, year, "_assets");
-    if (!existsSync(assetsDir))
+    if (!existsSync2(assetsDir))
       continue;
     const files = readdirSync(assetsDir);
     for (const file of files) {
@@ -35897,7 +36054,7 @@ function getAllMediaFromContentAssets(contentDir) {
 }
 function getAllMediaFromAssets(assetsDir) {
   const mediaFiles = [];
-  if (!existsSync(assetsDir))
+  if (!existsSync2(assetsDir))
     return [];
   const years = readdirSync(assetsDir).filter((f) => {
     const fullPath = join(assetsDir, f);
@@ -35929,7 +36086,7 @@ function getAllMediaFromAssets(assetsDir) {
 function checkMediaReference(markdownFile, lineNumber, mediaPath, type, missingReferences) {
   const markdownDir = dirname(markdownFile);
   const resolvedPath = resolve(markdownDir, mediaPath);
-  if (!existsSync(resolvedPath)) {
+  if (!existsSync2(resolvedPath)) {
     missingReferences.push({
       file: markdownFile.replace(process.cwd() + "/", ""),
       line: lineNumber,