@binarynoir/vitepress-blog 0.2.0 → 0.3.0

package/dist/index.js

@@ -5,7 +5,8 @@ import {
   POST_FRONTMATTER_KEY,
   WIDGET_NAME,
   blogMarkdown
-} from "./chunk-PWNWSYI4.js";
+} from "./chunk-LYTJBMVK.js";
+import "./chunk-42Z6H7IN.js";
 export {
   BLOG_POSTS_PLACEHOLDER,
   DEFAULT_LABELS,

package/dist/{plugin-BlfpqyX4.d.cts → plugin-Bb4rRwO8.d.cts}

@@ -96,6 +96,16 @@ interface BlogLabels {
     draft: string;
     /** Badge on a sticky post. */
     sticky: string;
+    /** Badge on an announcement, and the accessible name of the announcement banner. */
+    announcement: string;
+    /** Above a blog page filtered to announcements (`?announcements`). */
+    announcements: string;
+    /** When the blog page has no announcements to show. */
+    noAnnouncements: string;
+    /** Tooltip of the banner's count badge: "{n} announcements". */
+    announcementCount: string;
+    /** Accessible name of the banner's close button. */
+    dismiss: string;
     noPosts: string;
     /** Year heading for posts without a date, when a blog groups by year. */
     undated: string;
@@ -176,12 +186,32 @@ interface BlogPostData {
     scope: BlogScope;
     sticky: boolean;
     draft: boolean;
+    /** Shown in the announcement banner above the nav bar. */
+    announcement: boolean;
+    /** The banner's text, from `announcement: "…"`. `''` uses the title. */
+    announcementText: string;
     /** Per-post overrides of the `byline`, `cover` and `postNav` options. */
     byline?: boolean;
     cover?: boolean;
     postNav?: boolean;
     readingMinutes: number;
 }
+/** One announcement, as the banner shows it. */
+interface BlogAnnouncementItem {
+    /** The post's path and date: what a dismissal remembers, so re-dating a post announces it again. */
+    id: string;
+    text: string;
+    /** The post's URL path, without the site's base. */
+    link: string;
+}
+/** What the announcement banner reads from VitePress's site data. */
+interface BlogAnnouncementData {
+    /** Newest first: the banner shows the first one that hasn't been dismissed. */
+    items: BlogAnnouncementItem[];
+    /** The blog page filtered to announcements (`/blog/?announcements`), without the base, or `''` when no blog lists them. */
+    listLink: string;
+    labels: Pick<BlogLabels, 'announcement' | 'announcementCount' | 'dismiss'>;
+}
 
 /**
  * A markdown-it plugin that turns pages into a blog.
@@ -210,4 +240,4 @@ interface BlogPostData {
  */
 declare function blogMarkdown(md: MarkdownIt, options?: BlogOptions): void;
 
-export { type BlogAuthor as B, DEFAULT_LABELS as D, type BlogFeedConfig as a, type BlogIndexConfig as b, type BlogLabels as c, type BlogLayout as d, type BlogOptions as e, type BlogPostData as f, type BlogScope as g, blogMarkdown as h };
+export { type BlogAnnouncementData as B, DEFAULT_LABELS as D, type BlogAnnouncementItem as a, type BlogAuthor as b, type BlogFeedConfig as c, type BlogIndexConfig as d, type BlogLabels as e, type BlogLayout as f, type BlogOptions as g, type BlogPostData as h, type BlogScope as i, blogMarkdown as j };

package/dist/{plugin-BlfpqyX4.d.ts → plugin-Bb4rRwO8.d.ts}

@@ -96,6 +96,16 @@ interface BlogLabels {
     draft: string;
     /** Badge on a sticky post. */
     sticky: string;
+    /** Badge on an announcement, and the accessible name of the announcement banner. */
+    announcement: string;
+    /** Above a blog page filtered to announcements (`?announcements`). */
+    announcements: string;
+    /** When the blog page has no announcements to show. */
+    noAnnouncements: string;
+    /** Tooltip of the banner's count badge: "{n} announcements". */
+    announcementCount: string;
+    /** Accessible name of the banner's close button. */
+    dismiss: string;
     noPosts: string;
     /** Year heading for posts without a date, when a blog groups by year. */
     undated: string;
@@ -176,12 +186,32 @@ interface BlogPostData {
     scope: BlogScope;
     sticky: boolean;
     draft: boolean;
+    /** Shown in the announcement banner above the nav bar. */
+    announcement: boolean;
+    /** The banner's text, from `announcement: "…"`. `''` uses the title. */
+    announcementText: string;
     /** Per-post overrides of the `byline`, `cover` and `postNav` options. */
     byline?: boolean;
     cover?: boolean;
     postNav?: boolean;
     readingMinutes: number;
 }
+/** One announcement, as the banner shows it. */
+interface BlogAnnouncementItem {
+    /** The post's path and date: what a dismissal remembers, so re-dating a post announces it again. */
+    id: string;
+    text: string;
+    /** The post's URL path, without the site's base. */
+    link: string;
+}
+/** What the announcement banner reads from VitePress's site data. */
+interface BlogAnnouncementData {
+    /** Newest first: the banner shows the first one that hasn't been dismissed. */
+    items: BlogAnnouncementItem[];
+    /** The blog page filtered to announcements (`/blog/?announcements`), without the base, or `''` when no blog lists them. */
+    listLink: string;
+    labels: Pick<BlogLabels, 'announcement' | 'announcementCount' | 'dismiss'>;
+}
 
 /**
  * A markdown-it plugin that turns pages into a blog.
@@ -210,4 +240,4 @@ interface BlogPostData {
  */
 declare function blogMarkdown(md: MarkdownIt, options?: BlogOptions): void;
 
-export { type BlogAuthor as B, DEFAULT_LABELS as D, type BlogFeedConfig as a, type BlogIndexConfig as b, type BlogLabels as c, type BlogLayout as d, type BlogOptions as e, type BlogPostData as f, type BlogScope as g, blogMarkdown as h };
+export { type BlogAnnouncementData as B, DEFAULT_LABELS as D, type BlogAnnouncementItem as a, type BlogAuthor as b, type BlogFeedConfig as c, type BlogIndexConfig as d, type BlogLabels as e, type BlogLayout as f, type BlogOptions as g, type BlogPostData as h, type BlogScope as i, blogMarkdown as j };

package/dist/style.css

@@ -10,6 +10,9 @@
   --vp-blog-tag-bg: var(--vp-c-default-soft);
   --vp-blog-tag-color: var(--vp-c-text-2);
   --vp-blog-accent: var(--vp-c-brand-1);
+  --vp-blog-announcement-height: 40px;
+  --vp-blog-announcement-bg: var(--vp-button-brand-bg);
+  --vp-blog-announcement-color: var(--vp-button-brand-text);
 }
 
 /* Markdown inside the generated blocks is wrapped in <p>; its margins are handled here instead. */
@@ -201,6 +204,11 @@
   color: var(--vp-c-brand-1);
 }
 
+.vp-blog-badge--announcement {
+  background: var(--vp-c-tip-soft);
+  color: var(--vp-c-tip-1);
+}
+
 .vp-blog-badge--draft {
   background: var(--vp-c-warning-soft);
   color: var(--vp-c-warning-1);
@@ -416,3 +424,108 @@
   /* The RSS orange, as feed readers expect. */
   color: #f26522;
 }
+
+/*
+ * The announcement banner, in the theme's `layout-top` slot: fixed across the
+ * top of the window, one line high. While it shows, VitePress's
+ * --vp-layout-top-height moves the nav bar, sidebar and content down by its
+ * height. The class on <html> hides it before hydration once dismissed.
+ */
+:root:not(.vp-blog-announcement-dismissed):has(.vp-blog-announcement) {
+  --vp-layout-top-height: var(--vp-blog-announcement-height);
+}
+
+.vp-blog-announcement-dismissed .vp-blog-announcement {
+  display: none;
+}
+
+.vp-blog-announcement {
+  position: fixed;
+  top: 0;
+  right: 0;
+  left: 0;
+  z-index: var(--vp-z-index-layout-top);
+  display: flex;
+  gap: 8px;
+  align-items: center;
+  justify-content: center;
+  box-sizing: border-box;
+  height: var(--vp-blog-announcement-height);
+  padding: 0 48px;
+  background: var(--vp-blog-announcement-bg);
+  color: var(--vp-blog-announcement-color);
+  font-size: 14px;
+  font-weight: 500;
+  line-height: var(--vp-blog-announcement-height);
+}
+
+.vp-blog-announcement__content {
+  display: flex;
+  gap: 10px;
+  align-items: center;
+  min-width: 0;
+}
+
+.vp-blog-announcement__text {
+  overflow: hidden;
+  color: inherit;
+  text-decoration: none;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
+.vp-blog-announcement__text:hover {
+  text-decoration: underline;
+  text-underline-offset: 3px;
+}
+
+/* How many announcements there are: a counter pill that opens the list of them. */
+.vp-blog-announcement__count {
+  flex: none;
+  min-width: 22px;
+  padding: 0 7px;
+  border-radius: 999px;
+  background: var(--vp-blog-announcement-color);
+  color: var(--vp-blog-announcement-bg);
+  font-size: 12px;
+  font-weight: 700;
+  font-variant-numeric: tabular-nums;
+  line-height: 20px;
+  text-align: center;
+  text-decoration: none;
+  transition: opacity 0.25s;
+}
+
+a.vp-blog-announcement__count:hover {
+  opacity: 0.85;
+}
+
+.vp-blog-announcement__dismiss {
+  position: absolute;
+  top: 50%;
+  right: 12px;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  width: 28px;
+  height: 28px;
+  border-radius: 6px;
+  color: inherit;
+  opacity: 0.8;
+  transform: translateY(-50%);
+  transition:
+    background-color 0.25s,
+    opacity 0.25s;
+}
+
+.vp-blog-announcement__dismiss:hover {
+  background: rgba(255, 255, 255, 0.16);
+  opacity: 1;
+}
+
+@media (max-width: 639px) {
+  .vp-blog-announcement {
+    justify-content: flex-start;
+    padding: 0 48px 0 16px;
+  }
+}

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,6 +114,111 @@ 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);
@@ -320,6 +426,7 @@ function resolvePostData(data, content, fallbackTitle, options = {}) {
   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)),
@@ -337,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),
@@ -395,43 +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(/^\/+/, "")}`;
-}
-
-// src/feed.ts
 function toAbsoluteUrl(urlPath, site) {
   return joinUrl(site.siteUrl, joinUrl(site.base, urlPath));
 }
@@ -527,33 +599,6 @@ 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",
-  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",
-  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";
@@ -620,12 +665,22 @@ 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, dateHasTime, updated, updatedHasTime, 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) {
@@ -654,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)),
@@ -672,8 +728,8 @@ function renderCard(post, context, index) {
 }
 function renderCompactItem(post, context) {
   const date = post.post.date ? `${renderTime(post.post.date, post.post.dateHasTime, 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 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) {
@@ -748,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(" ");
 }
@@ -1135,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;
@@ -1149,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);
@@ -1253,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;
@@ -1268,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);
@@ -1303,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) ?? []]);
@@ -1339,6 +1427,7 @@ function withBlog(config, options = {}) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  attachAnnouncements,
   blogHead,
   blogMarkdown,
   blogPageData,