@binarynoir/vitepress-blog 0.1.1 → 0.3.0

package/dist/vitepress.cjs

@@ -30,6 +30,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/vitepress.ts
 var vitepress_exports = {};
 __export(vitepress_exports, {
+  attachAnnouncements: () => attachAnnouncements,
   blogHead: () => blogHead,
   blogMarkdown: () => blogMarkdown,
   blogPageData: () => blogPageData,
@@ -113,10 +114,213 @@ function findBlogsListing(pages, post) {
     (index) => listBlogPosts(pages, index, { drafts: false, stickyFirst: false, applyLimit: false }).includes(post)
   );
 }
+function listAnnouncements(pages, drafts) {
+  return pages.filter(isPost).filter((post) => post.post.announcement && (drafts || !post.post.draft)).sort(compareByDate);
+}
+function findAnnouncementBlog(pages, announcements, drafts) {
+  if (announcements.length === 0) return null;
+  const listingAll = pages.filter(isIndex).filter((index) => {
+    const listed = listBlogPosts(pages, index, { drafts, stickyFirst: false, applyLimit: false });
+    return announcements.every((post) => listed.includes(post));
+  });
+  return listingAll.find((index) => index.index.scope === "site") ?? listingAll[0] ?? findHomeBlog(pages, announcements[0], drafts);
+}
+
+// src/types.ts
+var DEFAULT_LABELS = {
+  by: "By",
+  published: "Published",
+  updated: "Updated",
+  dateTime: "{date} at {time}",
+  readingTime: "{n} min read",
+  newer: "Newer post",
+  older: "Older post",
+  allPosts: "All posts in {blog}",
+  draft: "Draft",
+  sticky: "Pinned",
+  announcement: "Announcement",
+  announcements: "Announcements",
+  noAnnouncements: "No announcements.",
+  announcementCount: "{n} announcements",
+  dismiss: "Dismiss",
+  noPosts: "No posts yet.",
+  undated: "Undated",
+  tags: "Keywords",
+  tagged: "Posts tagged {tag}",
+  showAll: "Show all posts",
+  noTagged: "No posts tagged {tag}.",
+  previous: "Previous",
+  next: "Next",
+  pages: "Pages",
+  subscribe: "Subscribe",
+  rssFeed: "RSS feed for {blog}"
+};
+
+// src/util.ts
+var HTML_ESCAPES = {
+  "&": "&",
+  "<": "&lt;",
+  ">": "&gt;",
+  '"': "&quot;",
+  "'": "&#39;"
+};
+function escapeHtml(value) {
+  return value.replace(/[&<>"']/g, (character) => HTML_ESCAPES[character]);
+}
+function escapeMarkdown(text) {
+  const escaped = text.replace(/[\\`*_[\]#|~]/g, "\\$&").replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+  return /[{}]/.test(escaped) ? `<span v-pre>${escaped}</span>` : escaped;
+}
+function escapeTemplateText(text) {
+  const escaped = escapeHtml(text);
+  return /[{}]/.test(escaped) ? `<span v-pre>${escaped}</span>` : escaped;
+}
+function isExternalUrl(url) {
+  return /^(?:[a-z][a-z\d+.-]*:|\/\/)/i.test(url);
+}
+function toMarkdownUrl(url) {
+  return encodeURI(url).replace(/[()]/g, (character) => character === "(" ? "%28" : "%29");
+}
+function toPageLink(text, routePath) {
+  return `[${escapeMarkdown(text)}](${toMarkdownUrl(`/${routePath}`)})`;
+}
+function toUrlPath(routePath, cleanUrls) {
+  return `/${routePath.replace(/(^|\/)index\.md$/, "$1").replace(/\.md$/, cleanUrls ? "" : ".html")}`;
+}
+function joinUrl(base, urlPath) {
+  return `${base.replace(/\/+$/, "")}/${urlPath.replace(/^\/+/, "")}`;
+}
+var ANNOUNCEMENTS_KEY = "blogAnnouncements";
+var DISMISSED_STORAGE_KEY = "vp-blog-announcements-dismissed";
+var DISMISSED_CLASS = "vp-blog-announcement-dismissed";
+
+// src/announcements.ts
+function resolveAnnouncements(pages, options, cleanUrls) {
+  const drafts = options.drafts ?? false;
+  const announcements = listAnnouncements(pages, drafts);
+  if (announcements.length === 0) return null;
+  const blog = findAnnouncementBlog(pages, announcements, drafts);
+  const labels = { ...DEFAULT_LABELS, ...options.labels };
+  return {
+    items: announcements.map((post) => ({
+      id: `${post.routePath}@${post.post.date?.toISOString() ?? ""}`,
+      text: post.post.announcementText || post.post.title,
+      link: toUrlPath(post.routePath, cleanUrls)
+    })),
+    listLink: blog ? `${toUrlPath(blog.routePath, cleanUrls)}?announcements` : "",
+    labels: {
+      announcement: labels.announcement,
+      announcementCount: labels.announcementCount,
+      dismiss: labels.dismiss
+    }
+  };
+}
+function renderDismissedScript(data) {
+  const id = JSON.stringify(data.items[0].id).replace(/</g, "\\u003c");
+  return `try{var d=JSON.parse(localStorage.getItem(${JSON.stringify(DISMISSED_STORAGE_KEY)})||'[]');if(Array.isArray(d)&&d.indexOf(${id})>-1)document.documentElement.classList.add(${JSON.stringify(DISMISSED_CLASS)})}catch(e){}`;
+}
 
 // src/frontmatter.ts
 var import_node_path = __toESM(require("path"), 1);
 var import_yaml = require("yaml");
+
+// src/dates.ts
+var DATE_TIME = /^(\d{4})-(\d{2})-(\d{2})(?:[T ](\d{2}):(\d{2})(?::(\d{2})(?:\.(\d{1,3})\d*)?)?)?\s*(Z|[+-]\d{2}:?\d{2})?$/i;
+function isTimeZone(timeZone) {
+  try {
+    new Intl.DateTimeFormat("en-US", { timeZone });
+    return true;
+  } catch {
+    return false;
+  }
+}
+var warnedZones = /* @__PURE__ */ new Set();
+function resolveTimeZone(timeZone) {
+  if (!timeZone) return "UTC";
+  if (isTimeZone(timeZone)) return timeZone;
+  if (!warnedZones.has(timeZone)) {
+    warnedZones.add(timeZone);
+    console.warn(
+      `[vitepress-blog] "${timeZone}" is not a time zone; using UTC. Use an IANA name such as "America/New_York".`
+    );
+  }
+  return "UTC";
+}
+var offsetFormats = /* @__PURE__ */ new Map();
+function zoneOffset(instant, timeZone) {
+  let format = offsetFormats.get(timeZone);
+  if (!format) {
+    format = new Intl.DateTimeFormat("en-US", {
+      timeZone,
+      hourCycle: "h23",
+      year: "numeric",
+      month: "2-digit",
+      day: "2-digit",
+      hour: "2-digit",
+      minute: "2-digit",
+      second: "2-digit"
+    });
+    offsetFormats.set(timeZone, format);
+  }
+  const parts = Object.fromEntries(format.formatToParts(instant).map(({ type, value }) => [type, Number(value)]));
+  const wall = Date.UTC(parts.year, parts.month - 1, parts.day, parts.hour, parts.minute, parts.second);
+  return wall - Math.floor(instant / 1e3) * 1e3;
+}
+function fromZonedTime(wall, timeZone) {
+  const first = wall - zoneOffset(wall, timeZone);
+  const second = wall - zoneOffset(first, timeZone);
+  return second;
+}
+function parsePostDate(value, timeZone = "UTC") {
+  if (value instanceof Date) {
+    if (Number.isNaN(value.getTime())) return null;
+    const midnight = value.getUTCHours() === 0 && value.getUTCMinutes() === 0 && value.getUTCSeconds() === 0;
+    return { date: value, hasTime: !midnight };
+  }
+  if (typeof value !== "string") return null;
+  const match = DATE_TIME.exec(value.trim());
+  if (!match) return null;
+  const [, year, month, day, hour, minute, second = "0", millisecond = "0", offset] = match;
+  const hasTime = hour !== void 0;
+  const wall = Date.UTC(
+    Number(year),
+    Number(month) - 1,
+    Number(day),
+    hasTime ? Number(hour) : 0,
+    hasTime ? Number(minute) : 0,
+    Number(second),
+    Number(millisecond.padEnd(3, "0"))
+  );
+  const check = new Date(wall);
+  if (check.getUTCMonth() !== Number(month) - 1 || check.getUTCDate() !== Number(day)) return null;
+  if (!offset) return { date: new Date(fromZonedTime(wall, timeZone)), hasTime };
+  if (offset.toUpperCase() === "Z") return { date: new Date(wall), hasTime };
+  const sign = offset.startsWith("-") ? -1 : 1;
+  const digits = offset.slice(1).replace(":", "");
+  const minutes = Number(digits.slice(0, 2)) * 60 + Number(digits.slice(2));
+  return { date: new Date(wall - sign * minutes * 6e4), hasTime };
+}
+function formatPostDate({ date, hasTime }, display) {
+  const { locale, timeZone } = display;
+  const day = new Intl.DateTimeFormat(locale, { timeZone, ...display.dateFormat }).format(date);
+  if (!hasTime) return day;
+  const time = new Intl.DateTimeFormat(locale, { timeZone, ...display.timeFormat }).format(date);
+  return display.dateTime.replace("{date}", day).replace("{time}", time);
+}
+function toZonedIsoDate(date, timeZone) {
+  const parts = Object.fromEntries(
+    new Intl.DateTimeFormat("en-US", { timeZone, year: "numeric", month: "2-digit", day: "2-digit" }).formatToParts(date).map(({ type, value }) => [type, value])
+  );
+  return `${parts.year}-${parts.month}-${parts.day}`;
+}
+function toDateTimeAttribute({ date, hasTime }, timeZone) {
+  return hasTime ? date.toISOString() : toZonedIsoDate(date, timeZone);
+}
+function yearIn(date, timeZone) {
+  return Number(toZonedIsoDate(date, timeZone).slice(0, 4));
+}
+
+// src/frontmatter.ts
 var POST_FRONTMATTER_KEY = "blog";
 var INDEX_FRONTMATTER_KEY = "blog-index";
 var FRONTMATTER = /^---[ \t]*\r?\n(?:([\s\S]*?)\r?\n)?---[ \t]*(?:\r?\n|$)/;
@@ -155,12 +359,6 @@ function toStringList(value) {
   const values = Array.isArray(value) ? value : typeof value === "string" ? value.split(",") : [];
   return values.map(toText).filter(Boolean);
 }
-function toDate(value) {
-  if (value instanceof Date) return Number.isNaN(value.getTime()) ? null : value;
-  if (typeof value !== "string" && typeof value !== "number") return null;
-  const date = new Date(value);
-  return Number.isNaN(date.getTime()) ? null : date;
-}
 function toAuthor(value, options) {
   if (typeof value === "string") {
     const name2 = value.trim();
@@ -225,11 +423,17 @@ function resolvePostData(data, content, fallbackTitle, options = {}) {
   const stripTags = options.stripTags ?? true;
   const clean = (text) => stripTags ? stripTagSyntax(text) : text;
   const image = toRecord(pick("image"));
+  const timeZone = resolveTimeZone(options.timeZone);
+  const date = parsePostDate(pick("date"), timeZone);
+  const updated = parsePostDate(pick("updated"), timeZone);
+  const announcementText = typeof post.announcement === "string" ? clean(post.announcement.trim()) : "";
   return {
     title: clean(toText(post.title) || toText(data.title) || readHeading(content)) || fallbackTitle,
     summary: clean(toText(post.summary) || toText(data.description) || readExcerpt(content)),
-    date: toDate(pick("date")),
-    updated: toDate(pick("updated")),
+    date: date?.date ?? null,
+    dateHasTime: date?.hasTime ?? false,
+    updated: updated?.date ?? null,
+    updatedHasTime: updated?.hasTime ?? false,
     image: toText(image.src) || toText(pick("image")),
     imageAlt: toText(image.alt) || toText(post.imageAlt) || toText(data.imageAlt),
     imageFit: (toText(image.fit) || toText(post.imageFit)) === "contain" ? "contain" : "cover",
@@ -240,6 +444,8 @@ function resolvePostData(data, content, fallbackTitle, options = {}) {
     scope: toScope(post.scope),
     sticky: post.sticky === true,
     draft: post.draft === true,
+    announcement: post.announcement === true || !!announcementText,
+    announcementText,
     byline: toBoolean(post.byline),
     cover: toBoolean(post.cover),
     postNav: toBoolean(post.postNav),
@@ -298,49 +504,6 @@ function resolveIndexConfig(data, relativePath, defaults = {}) {
 var import_node_crypto = require("crypto");
 var import_node_fs = require("fs");
 var import_node_path2 = __toESM(require("path"), 1);
-
-// src/util.ts
-var HTML_ESCAPES = {
-  "&": "&amp;",
-  "<": "&lt;",
-  ">": "&gt;",
-  '"': "&quot;",
-  "'": "&#39;"
-};
-function escapeHtml(value) {
-  return value.replace(/[&<>"']/g, (character) => HTML_ESCAPES[character]);
-}
-function escapeMarkdown(text) {
-  const escaped = text.replace(/[\\`*_[\]#|~]/g, "\\$&").replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
-  return /[{}]/.test(escaped) ? `<span v-pre>${escaped}</span>` : escaped;
-}
-function escapeTemplateText(text) {
-  const escaped = escapeHtml(text);
-  return /[{}]/.test(escaped) ? `<span v-pre>${escaped}</span>` : escaped;
-}
-function isExternalUrl(url) {
-  return /^(?:[a-z][a-z\d+.-]*:|\/\/)/i.test(url);
-}
-function toMarkdownUrl(url) {
-  return encodeURI(url).replace(/[()]/g, (character) => character === "(" ? "%28" : "%29");
-}
-function toPageLink(text, routePath) {
-  return `[${escapeMarkdown(text)}](${toMarkdownUrl(`/${routePath}`)})`;
-}
-function toUrlPath(routePath, cleanUrls) {
-  return `/${routePath.replace(/(^|\/)index\.md$/, "$1").replace(/\.md$/, cleanUrls ? "" : ".html")}`;
-}
-function joinUrl(base, urlPath) {
-  return `${base.replace(/\/+$/, "")}/${urlPath.replace(/^\/+/, "")}`;
-}
-function toIsoDate(date) {
-  return date.toISOString().slice(0, 10);
-}
-function formatDate(date, locale, format) {
-  return new Intl.DateTimeFormat(locale, { timeZone: "UTC", ...format }).format(date);
-}
-
-// src/feed.ts
 function toAbsoluteUrl(urlPath, site) {
   return joinUrl(site.siteUrl, joinUrl(site.base, urlPath));
 }
@@ -436,37 +599,20 @@ var import_node_path6 = __toESM(require("path"), 1);
 
 // src/render.ts
 var import_node_path3 = __toESM(require("path"), 1);
-
-// src/types.ts
-var DEFAULT_LABELS = {
-  by: "By",
-  updated: "Updated",
-  readingTime: "{n} min read",
-  newer: "Newer post",
-  older: "Older post",
-  allPosts: "All posts in {blog}",
-  draft: "Draft",
-  sticky: "Pinned",
-  noPosts: "No posts yet.",
-  undated: "Undated",
-  tags: "Keywords",
-  tagged: "Posts tagged {tag}",
-  showAll: "Show all posts",
-  noTagged: "No posts tagged {tag}.",
-  previous: "Previous",
-  next: "Next",
-  pages: "Pages",
-  subscribe: "Subscribe",
-  rssFeed: "RSS feed for {blog}"
-};
-
-// src/render.ts
 var BLOG_POSTS_PLACEHOLDER = "<!-- blog-posts -->";
 function createRenderContext(options, pageDirectory, feeds = !!options.siteUrl) {
+  const locale = options.locale ?? "en-US";
+  const labels = { ...DEFAULT_LABELS, ...options.labels };
   return {
-    locale: options.locale ?? "en-US",
-    dateFormat: options.dateFormat ?? { dateStyle: "long" },
-    labels: { ...DEFAULT_LABELS, ...options.labels },
+    locale,
+    dates: {
+      locale,
+      timeZone: resolveTimeZone(options.timeZone),
+      dateFormat: options.dateFormat ?? { dateStyle: "long" },
+      timeFormat: options.timeFormat ?? { hour: "numeric", minute: "2-digit", timeZoneName: "short" },
+      dateTime: labels.dateTime
+    },
+    labels,
     pageDirectory,
     feeds
   };
@@ -488,8 +634,10 @@ function toImageSource(post, pageDirectory) {
   const relative = import_node_path3.default.relative(pageDirectory, absolute).split(import_node_path3.default.sep).join("/");
   return relative.startsWith(".") ? relative : `./${relative}`;
 }
-function renderTime(date, context) {
-  return `<time datetime="${toIsoDate(date)}">${escapeTemplateText(formatDate(date, context.locale, context.dateFormat))}</time>`;
+function renderTime(date, hasTime, context) {
+  const value = { date, hasTime };
+  const attribute = toDateTimeAttribute(value, context.dates.timeZone);
+  return `<time datetime="${attribute}">${escapeTemplateText(formatPostDate(value, context.dates))}</time>`;
 }
 function renderAuthor(author) {
   return author.url ? `[${escapeMarkdown(author.name)}](${toMarkdownUrl(author.url)})` : escapeMarkdown(author.name);
@@ -517,17 +665,30 @@ function renderTags(tags, blogRoutePath) {
 function toTagsAttribute(post) {
   return escapeHtml(post.post.tags.map((tag) => tag.toLowerCase()).join("|"));
 }
+function toItemAttributes(post) {
+  return `data-vp-blog-item data-tags="${toTagsAttribute(post)}"${post.post.announcement ? " data-announcement" : ""}`;
+}
+function renderBadges(post, context) {
+  const { draft, sticky, announcement } = post.post;
+  return [
+    draft && renderBadge("draft", context),
+    sticky && renderBadge("sticky", context),
+    announcement && renderBadge("announcement", context)
+  ].filter(Boolean).join(" ");
+}
 function renderMeta(post, context, include) {
-  const { date, updated, readingMinutes, authors, draft, sticky } = post.post;
+  const { date, dateHasTime, updated, updatedHasTime, readingMinutes, authors } = post.post;
   const parts = [];
   if (include.badges) {
-    const badges = [draft && renderBadge("draft", context), sticky && renderBadge("sticky", context)];
-    const shown = badges.filter(Boolean).join(" ");
+    const shown = renderBadges(post, context);
     if (shown) parts.push(shown);
   }
-  if (date) parts.push(renderTime(date, context));
+  if (date) {
+    const time = renderTime(date, dateHasTime, context);
+    parts.push(include.updated ? `${escapeMarkdown(context.labels.published)} ${time}` : time);
+  }
   if (include.updated && updated && (!date || updated.getTime() !== date.getTime())) {
-    parts.push(`${escapeMarkdown(context.labels.updated)} ${renderTime(updated, context)}`);
+    parts.push(`${escapeMarkdown(context.labels.updated)} ${renderTime(updated, updatedHasTime, context)}`);
   }
   if (readingMinutes) parts.push(escapeMarkdown(fill(context.labels.readingTime, { n: String(readingMinutes) })));
   if (include.authors) {
@@ -548,12 +709,13 @@ function renderCard(post, context, index) {
   const modifiers = [
     post.post.sticky && "sticky",
     post.post.draft && "draft",
+    post.post.announcement && "announcement",
     image && "with-image",
     image && post.post.imageFit === "contain" && "contain"
   ].filter(Boolean).map((modifier) => ` vp-blog-card--${modifier}`).join("");
   const alt = escapeMarkdown(post.post.imageAlt);
   return [
-    `<article class="vp-blog-card${modifiers}"${imageStyle(post)} data-vp-blog-item data-tags="${toTagsAttribute(post)}">`,
+    `<article class="vp-blog-card${modifiers}"${imageStyle(post)} ${toItemAttributes(post)}>`,
     ...image ? block("vp-blog-card__image", `[![${alt}](${toMarkdownUrl(image)})](${toMarkdownUrl(link)})`) : [],
     '<div class="vp-blog-card__body">',
     ...block("vp-blog-card__title", toPageLink(post.post.title, post.routePath)),
@@ -565,9 +727,9 @@ function renderCard(post, context, index) {
   ];
 }
 function renderCompactItem(post, context) {
-  const date = post.post.date ? `${renderTime(post.post.date, context)} ` : "";
-  const badges = [post.post.draft && renderBadge("draft", context), post.post.sticky && renderBadge("sticky", context)].filter(Boolean).join(" ");
-  const marker = `<span hidden data-vp-blog-item data-tags="${toTagsAttribute(post)}"></span>`;
+  const date = post.post.date ? `${renderTime(post.post.date, post.post.dateHasTime, context)} ` : "";
+  const badges = renderBadges(post, context);
+  const marker = `<span hidden ${toItemAttributes(post)}></span>`;
   return `- ${marker}${date}${toPageLink(post.post.title, post.routePath)}${badges ? ` ${badges}` : ""}`;
 }
 function renderGroup(posts, index, context) {
@@ -590,7 +752,7 @@ function renderGroup(posts, index, context) {
 function renderYears(posts, index, context) {
   const years = /* @__PURE__ */ new Map();
   for (const post of posts) {
-    const year = post.post.date ? String(post.post.date.getUTCFullYear()) : context.labels.undated;
+    const year = post.post.date ? String(yearIn(post.post.date, context.dates.timeZone)) : context.labels.undated;
     years.set(year, [...years.get(year) ?? [], post]);
   }
   const lines = [];
@@ -642,7 +804,9 @@ function renderClientAttributes(index, context) {
     "data-label-no-tagged": labels.noTagged,
     "data-label-previous": labels.previous,
     "data-label-next": labels.next,
-    "data-label-pages": labels.pages
+    "data-label-pages": labels.pages,
+    "data-label-announcements": labels.announcements,
+    "data-label-no-announcements": labels.noAnnouncements
   };
   return Object.entries(attributes).map(([name, value]) => `${name}="${escapeHtml(value)}"`).join(" ");
 }
@@ -765,7 +929,8 @@ function toOptionsKey(options) {
     options.stripTags,
     options.pageSize,
     options.stickyLimit,
-    options.rssLink
+    options.rssLink,
+    options.timeZone
   ]);
 }
 function indexBlogSource(sourceDirectory, options = {}, rewrites = {}) {
@@ -1028,6 +1193,9 @@ function blogMarkdown(md, options = {}) {
 
 // src/vitepress.ts
 var DEFAULT_FEED_LIMIT = 20;
+var PACKAGE_NAME = "@binarynoir/vitepress-blog";
+var SITE_DATA_MODULE = "/@siteData";
+var SCRIPT_MARKER = "data-vp-blog-announcement";
 function resolveSiteLocation(siteConfig, options) {
   const siteUrl = options.siteUrl ?? siteConfig.userConfig?.sitemap?.hostname ?? siteConfig.sitemap?.hostname;
   if (!siteUrl) return null;
@@ -1042,6 +1210,16 @@ function resolveSiteLocation(siteConfig, options) {
 function loadPages(siteConfig, options) {
   return loadBlogPages(siteConfig.srcDir, options, siteConfig);
 }
+function attachAnnouncements(siteConfig, options = {}) {
+  const site = siteConfig.site;
+  const data = resolveAnnouncements(loadPages(siteConfig, options), options, !!siteConfig.cleanUrls);
+  const changed = JSON.stringify(site[ANNOUNCEMENTS_KEY] ?? null) !== JSON.stringify(data);
+  if (data) site[ANNOUNCEMENTS_KEY] = data;
+  else delete site[ANNOUNCEMENTS_KEY];
+  site.head = (site.head ?? []).filter(([, attributes]) => !(SCRIPT_MARKER in (attributes ?? {})));
+  if (data) site.head.push(["script", { [SCRIPT_MARKER]: "" }, renderDismissedScript(data)]);
+  return changed;
+}
 function listFeedPosts(pages, index, options) {
   const limit = index.index.feed?.limit ?? options.feedLimit ?? DEFAULT_FEED_LIMIT;
   return listBlogPosts(pages, index, { drafts: false, stickyFirst: false, applyLimit: false }).slice(0, limit);
@@ -1146,11 +1324,26 @@ function blogVitePlugin(options = {}) {
   let siteConfig;
   const currentPages = () => siteConfig ? loadPages(siteConfig, options) : [];
   const dependentFiles = () => [...currentPages().map((page) => page.absolutePath), ...widgetPages];
+  const invalidate = (server, files) => {
+    for (const file of files) {
+      for (const module2 of server.moduleGraph.getModulesByFile(file) ?? []) server.moduleGraph.invalidateModule(module2);
+    }
+  };
+  const refreshAnnouncements = (server) => {
+    if (!siteConfig || !attachAnnouncements(siteConfig, options)) return false;
+    const module2 = server.moduleGraph.getModuleById(SITE_DATA_MODULE);
+    if (module2) server.moduleGraph.invalidateModule(module2);
+    return true;
+  };
   return {
     name: "vitepress-blog",
     enforce: "pre",
+    config() {
+      return { ssr: { noExternal: [PACKAGE_NAME] } };
+    },
     configResolved(config) {
       siteConfig = config.vitepress;
+      if (siteConfig) attachAnnouncements(siteConfig, options);
     },
     transform(code, id) {
       if (!siteConfig || !id.endsWith(".md") || !(mayHaveBlogFrontmatter(code) || hasWidget(code))) return null;
@@ -1161,11 +1354,8 @@ function blogVitePlugin(options = {}) {
     configureServer(server) {
       const refresh = (file) => {
         if (!siteConfig || !file.endsWith(".md")) return;
-        for (const dependent of dependentFiles()) {
-          for (const module2 of server.moduleGraph.getModulesByFile(dependent) ?? []) {
-            server.moduleGraph.invalidateModule(module2);
-          }
-        }
+        invalidate(server, dependentFiles());
+        refreshAnnouncements(server);
         server.ws.send({ type: "full-reload" });
       };
       server.watcher.on("add", refresh).on("unlink", refresh);
@@ -1196,6 +1386,11 @@ function blogVitePlugin(options = {}) {
     },
     handleHotUpdate({ file, modules, server }) {
       if (!siteConfig || !file.endsWith(".md")) return;
+      if (refreshAnnouncements(server)) {
+        invalidate(server, dependentFiles());
+        server.ws.send({ type: "full-reload" });
+        return [];
+      }
       const pages = currentPages();
       if (!pages.some((page) => page.absolutePath === file)) return;
       const affected = dependentFiles().filter((dependent) => dependent !== file).flatMap((dependent) => [...server.moduleGraph.getModulesByFile(dependent) ?? []]);
@@ -1232,6 +1427,7 @@ function withBlog(config, options = {}) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  attachAnnouncements,
   blogHead,
   blogMarkdown,
   blogPageData,