@binarynoir/vitepress-blog 0.0.0-stage → 0.1.1

package/dist/vitepress.js

@@ -0,0 +1,234 @@
+import {
+  blogMarkdown,
+  findBlogsListing,
+  fingerprintBlogSource,
+  hasWidget,
+  isIndex,
+  isPost,
+  joinUrl,
+  listBlogPosts,
+  loadBlogPages,
+  mayHaveBlogFrontmatter,
+  renderFeed,
+  resolvePostImage,
+  toFeedPath,
+  toPageUrl,
+  widgetPages
+} from "./chunk-DICBXOTS.js";
+
+// src/vitepress.ts
+import { copyFileSync, mkdirSync, readFileSync, writeFileSync } from "fs";
+import path from "path";
+var DEFAULT_FEED_LIMIT = 20;
+function resolveSiteLocation(siteConfig, options) {
+  const siteUrl = options.siteUrl ?? siteConfig.userConfig?.sitemap?.hostname ?? siteConfig.sitemap?.hostname;
+  if (!siteUrl) return null;
+  return {
+    siteUrl: siteUrl.replace(/\/+$/, ""),
+    base: siteConfig.site?.base ?? "/",
+    cleanUrls: !!siteConfig.cleanUrls,
+    publicDir: siteConfig.publicDir ?? path.join(siteConfig.srcDir, "public"),
+    imagesDir: (options.imagesDir ?? "blog-images").replace(/^\/+|\/+$/g, "")
+  };
+}
+function loadPages(siteConfig, options) {
+  return loadBlogPages(siteConfig.srcDir, options, siteConfig);
+}
+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);
+}
+function renderIndexFeed(pages, index, site, siteConfig, options) {
+  return renderFeed({
+    index,
+    posts: listFeedPosts(pages, index, options),
+    site,
+    language: siteConfig.site?.lang,
+    siteDescription: siteConfig.site?.description
+  });
+}
+function feedLink(index, base) {
+  const href = joinUrl(base, toFeedPath(index));
+  return [
+    "link",
+    { rel: "alternate", type: "application/rss+xml", title: index.index.feed?.title ?? index.title, href }
+  ];
+}
+function blogHead(context, options = {}) {
+  const { pageData, siteConfig } = context;
+  const frontmatter = pageData.frontmatter ?? {};
+  if (!pageData.filePath || !frontmatter.blog && !frontmatter["blog-index"]) return [];
+  const pages = loadPages(siteConfig, options);
+  const page = pages.find((candidate) => candidate.relativePath === pageData.filePath);
+  if (!page) return [];
+  const site = resolveSiteLocation(siteConfig, options);
+  const base = siteConfig.site?.base ?? "/";
+  const head = [];
+  if (isIndex(page)) {
+    if (page.index.feed) head.push(feedLink(page, base));
+    if (site) head.push(["meta", { property: "og:url", content: toPageUrl(page.routePath, site) }]);
+    return head;
+  }
+  if (!isPost(page)) return head;
+  const { post } = page;
+  head.push(
+    ["meta", { property: "og:type", content: "article" }],
+    ["meta", { property: "og:title", content: post.title }]
+  );
+  if (post.summary) head.push(["meta", { property: "og:description", content: post.summary }]);
+  if (site) head.push(["meta", { property: "og:url", content: toPageUrl(page.routePath, site) }]);
+  const image = site ? resolvePostImage(page, site) : null;
+  if (image) {
+    head.push(["meta", { property: "og:image", content: image.url }]);
+    if (post.imageAlt) head.push(["meta", { property: "og:image:alt", content: post.imageAlt }]);
+  }
+  head.push(["meta", { name: "twitter:card", content: image ? "summary_large_image" : "summary" }]);
+  if (post.date) head.push(["meta", { property: "article:published_time", content: post.date.toISOString() }]);
+  if (post.updated) head.push(["meta", { property: "article:modified_time", content: post.updated.toISOString() }]);
+  if (post.authors.length) {
+    head.push(["meta", { property: "article:author", content: post.authors.map((author) => author.name).join(", ") }]);
+  }
+  if (post.category) head.push(["meta", { property: "article:section", content: post.category }]);
+  if (!post.draft) {
+    for (const blog of findBlogsListing(pages, page)) if (blog.index.feed) head.push(feedLink(blog, base));
+  }
+  return head;
+}
+function blogPageData(pageData, context, options = {}) {
+  if (!pageData.frontmatter?.blog || pageData.description || !pageData.filePath) return;
+  const page = loadPages(context.siteConfig, options).find((candidate) => candidate.relativePath === pageData.filePath);
+  if (page?.post?.summary) pageData.description = page.post.summary;
+}
+function writeBlogFeeds(siteConfig, options = {}) {
+  const pages = loadPages(siteConfig, options);
+  const indexes = pages.filter(isIndex).filter((index) => index.index.feed);
+  const site = resolveSiteLocation(siteConfig, options);
+  if (!site) {
+    if (indexes.length) {
+      siteConfig.logger?.warn(
+        "[vitepress-blog] no feeds written: set the siteUrl option or sitemap.hostname so feeds can use absolute links."
+      );
+    }
+    return;
+  }
+  const written = /* @__PURE__ */ new Map();
+  for (const index of indexes) {
+    const feedPath = toFeedPath(index);
+    if (written.has(feedPath)) {
+      siteConfig.logger?.warn(
+        `[vitepress-blog] ${index.relativePath} and ${written.get(feedPath)} both write ${feedPath}; set feed.path on one of them.`
+      );
+      continue;
+    }
+    written.set(feedPath, index.relativePath);
+    const file = path.join(siteConfig.outDir, feedPath);
+    mkdirSync(path.dirname(file), { recursive: true });
+    writeFileSync(file, renderIndexFeed(pages, index, site, siteConfig, options));
+  }
+  for (const post of pages.filter(isPost)) {
+    if (post.post.draft) continue;
+    const image = resolvePostImage(post, site);
+    if (!image?.file || !image.outputPath) continue;
+    const target = path.join(siteConfig.outDir, image.outputPath);
+    mkdirSync(path.dirname(target), { recursive: true });
+    copyFileSync(image.file, target);
+  }
+}
+function blogVitePlugin(options = {}) {
+  let siteConfig;
+  const currentPages = () => siteConfig ? loadPages(siteConfig, options) : [];
+  const dependentFiles = () => [...currentPages().map((page) => page.absolutePath), ...widgetPages];
+  return {
+    name: "vitepress-blog",
+    enforce: "pre",
+    configResolved(config) {
+      siteConfig = config.vitepress;
+    },
+    transform(code, id) {
+      if (!siteConfig || !id.endsWith(".md") || !(mayHaveBlogFrontmatter(code) || hasWidget(code))) return null;
+      return { code: `${code}
+<!-- vitepress-blog:${fingerprintBlogSource(currentPages())} -->
+`, map: null };
+    },
+    configureServer(server) {
+      const refresh = (file) => {
+        if (!siteConfig || !file.endsWith(".md")) return;
+        for (const dependent of dependentFiles()) {
+          for (const module of server.moduleGraph.getModulesByFile(dependent) ?? []) {
+            server.moduleGraph.invalidateModule(module);
+          }
+        }
+        server.ws.send({ type: "full-reload" });
+      };
+      server.watcher.on("add", refresh).on("unlink", refresh);
+      server.middlewares.use((request, response, next) => {
+        if (!siteConfig || !request.url) return next();
+        const base = siteConfig.site?.base ?? "/";
+        const pathname = decodeURIComponent(request.url.split("?")[0]);
+        if (!pathname.startsWith(base)) return next();
+        const relative = pathname.slice(base.length);
+        const pages = currentPages();
+        const site = resolveSiteLocation(siteConfig, options) ?? resolveSiteLocation(siteConfig, { ...options, siteUrl: `http://${request.headers.host ?? "localhost"}` });
+        const index = pages.filter(isIndex).find((page) => page.index.feed && toFeedPath(page) === relative);
+        if (index) {
+          response.setHeader("Content-Type", "application/rss+xml; charset=utf-8");
+          response.end(renderIndexFeed(pages, index, site, siteConfig, options));
+          return;
+        }
+        for (const post of pages.filter(isPost)) {
+          const image = resolvePostImage(post, site);
+          if (image?.outputPath === relative && image.file) {
+            if (image.type) response.setHeader("Content-Type", image.type);
+            response.end(readFileSync(image.file));
+            return;
+          }
+        }
+        next();
+      });
+    },
+    handleHotUpdate({ file, modules, server }) {
+      if (!siteConfig || !file.endsWith(".md")) 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) ?? []]);
+      return affected.length ? [...modules, ...affected] : void 0;
+    }
+  };
+}
+function withBlog(config, options = {}) {
+  config.markdown ??= {};
+  const existingMarkdownConfig = config.markdown.config ?? (() => {
+  });
+  config.markdown.config = (md) => {
+    blogMarkdown(md, options);
+    existingMarkdownConfig(md);
+  };
+  config.vite ??= {};
+  config.vite.plugins = [...config.vite.plugins ?? [], blogVitePlugin(options)];
+  const existingTransformHead = config.transformHead;
+  config.transformHead = async (context) => [
+    ...blogHead(context, options),
+    ...await existingTransformHead?.(context) ?? []
+  ];
+  const existingTransformPageData = config.transformPageData;
+  config.transformPageData = (pageData, context) => {
+    blogPageData(pageData, context, options);
+    return existingTransformPageData?.(pageData, context);
+  };
+  const existingBuildEnd = config.buildEnd;
+  config.buildEnd = async (siteConfig) => {
+    writeBlogFeeds(siteConfig, options);
+    await existingBuildEnd?.(siteConfig);
+  };
+  return config;
+}
+export {
+  blogHead,
+  blogMarkdown,
+  blogPageData,
+  blogVitePlugin,
+  resolveSiteLocation,
+  withBlog,
+  writeBlogFeeds
+};
+//# sourceMappingURL=vitepress.js.map

package/dist/vitepress.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/vitepress.ts"],"sourcesContent":["import { copyFileSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';\nimport path from 'node:path';\nimport type { MarkdownIt } from 'markdown-it';\nimport type { Plugin } from 'vite';\nimport type { HeadConfig, PageData, SiteConfig, TransformContext, TransformPageContext, UserConfig } from 'vitepress';\nimport { findBlogsListing, isIndex, isPost, listBlogPosts, type IndexPage, type PostPage } from './collect.js';\nimport { mayHaveBlogFrontmatter } from './frontmatter.js';\nimport { renderFeed, resolvePostImage, toFeedPath, toPageUrl, type SiteLocation } from './feed.js';\nimport { blogMarkdown } from './plugin.js';\nimport { hasWidget, widgetPages } from './widget.js';\nimport { fingerprintBlogSource, loadBlogPages, type BlogPage } from './scan.js';\nimport type { BlogOptions } from './types.js';\nimport { joinUrl } from './util.js';\n\nconst DEFAULT_FEED_LIMIT = 20;\n\n/** Where the site is published, or `null` without a site URL: feeds need absolute links. */\nexport function resolveSiteLocation(siteConfig: SiteConfig, options: BlogOptions): SiteLocation | null {\n  const siteUrl = options.siteUrl ?? siteConfig.userConfig?.sitemap?.hostname ?? siteConfig.sitemap?.hostname;\n  if (!siteUrl) return null;\n  return {\n    siteUrl: siteUrl.replace(/\\/+$/, ''),\n    base: siteConfig.site?.base ?? '/',\n    cleanUrls: !!siteConfig.cleanUrls,\n    publicDir: siteConfig.publicDir ?? path.join(siteConfig.srcDir, 'public'),\n    imagesDir: (options.imagesDir ?? 'blog-images').replace(/^\\/+|\\/+$/g, ''),\n  };\n}\n\nfunction loadPages(siteConfig: SiteConfig, options: BlogOptions): BlogPage[] {\n  return loadBlogPages(siteConfig.srcDir, options, siteConfig);\n}\n\n/** The posts in a blog's feed: no drafts, newest first, up to the feed's limit. */\nfunction listFeedPosts(pages: BlogPage[], index: IndexPage, options: BlogOptions): PostPage[] {\n  const limit = index.index.feed?.limit ?? options.feedLimit ?? DEFAULT_FEED_LIMIT;\n  return listBlogPosts(pages, index, { drafts: false, stickyFirst: false, applyLimit: false }).slice(0, limit);\n}\n\nfunction renderIndexFeed(\n  pages: BlogPage[],\n  index: IndexPage,\n  site: SiteLocation,\n  siteConfig: SiteConfig,\n  options: BlogOptions,\n) {\n  return renderFeed({\n    index,\n    posts: listFeedPosts(pages, index, options),\n    site,\n    language: siteConfig.site?.lang,\n    siteDescription: siteConfig.site?.description,\n  });\n}\n\nfunction feedLink(index: IndexPage, base: string): HeadConfig {\n  const href = joinUrl(base, toFeedPath(index));\n  return [\n    'link',\n    { rel: 'alternate', type: 'application/rss+xml', title: index.index.feed?.title ?? index.title, href },\n  ];\n}\n\n/**\n * `<head>` tags for blog pages: a feed link on each blog page, and on each\n * post Open Graph and Twitter card tags (title, summary, image, dates) plus\n * links to the feeds that carry it. Use it from VitePress's `transformHead`:\n *\n * ```ts\n * transformHead: (context) => blogHead(context, options),\n * ```\n *\n * Social tags need absolute URLs, so `og:url` and `og:image` are left out\n * without a site URL (the `siteUrl` option or `sitemap.hostname`).\n */\nexport function blogHead(context: TransformContext, options: BlogOptions = {}): HeadConfig[] {\n  const { pageData, siteConfig } = context;\n  const frontmatter = pageData.frontmatter ?? {};\n  if (!pageData.filePath || (!frontmatter.blog && !frontmatter['blog-index'])) return [];\n  const pages = loadPages(siteConfig, options);\n  const page = pages.find((candidate) => candidate.relativePath === pageData.filePath);\n  if (!page) return [];\n  const site = resolveSiteLocation(siteConfig, options);\n  const base = siteConfig.site?.base ?? '/';\n  const head: HeadConfig[] = [];\n\n  if (isIndex(page)) {\n    if (page.index.feed) head.push(feedLink(page, base));\n    if (site) head.push(['meta', { property: 'og:url', content: toPageUrl(page.routePath, site) }]);\n    return head;\n  }\n  if (!isPost(page)) return head;\n\n  const { post } = page;\n  head.push(\n    ['meta', { property: 'og:type', content: 'article' }],\n    ['meta', { property: 'og:title', content: post.title }],\n  );\n  if (post.summary) head.push(['meta', { property: 'og:description', content: post.summary }]);\n  if (site) head.push(['meta', { property: 'og:url', content: toPageUrl(page.routePath, site) }]);\n\n  const image = site ? resolvePostImage(page, site) : null;\n  if (image) {\n    head.push(['meta', { property: 'og:image', content: image.url }]);\n    if (post.imageAlt) head.push(['meta', { property: 'og:image:alt', content: post.imageAlt }]);\n  }\n  head.push(['meta', { name: 'twitter:card', content: image ? 'summary_large_image' : 'summary' }]);\n  if (post.date) head.push(['meta', { property: 'article:published_time', content: post.date.toISOString() }]);\n  if (post.updated) head.push(['meta', { property: 'article:modified_time', content: post.updated.toISOString() }]);\n  if (post.authors.length) {\n    head.push(['meta', { property: 'article:author', content: post.authors.map((author) => author.name).join(', ') }]);\n  }\n  if (post.category) head.push(['meta', { property: 'article:section', content: post.category }]);\n  if (!post.draft) {\n    for (const blog of findBlogsListing(pages, page)) if (blog.index.feed) head.push(feedLink(blog, base));\n  }\n  return head;\n}\n\n/**\n * Gives a post without a `description` its summary (or the first paragraph,\n * when it has no summary) as one, so VitePress writes it into the page's\n * `<meta name=\"description\">`. Use it from `transformPageData`:\n *\n * ```ts\n * transformPageData: (pageData, context) => blogPageData(pageData, context, options),\n * ```\n */\nexport function blogPageData(pageData: PageData, context: TransformPageContext, options: BlogOptions = {}): void {\n  if (!pageData.frontmatter?.blog || pageData.description || !pageData.filePath) return;\n  const page = loadPages(context.siteConfig, options).find((candidate) => candidate.relativePath === pageData.filePath);\n  if (page?.post?.summary) pageData.description = page.post.summary;\n}\n\n/**\n * Writes an RSS feed for every blog page whose feed isn't turned off, and\n * copies post images to `imagesDir` for the feeds and social cards to link.\n * Use it from VitePress's `buildEnd`.\n */\nexport function writeBlogFeeds(siteConfig: SiteConfig, options: BlogOptions = {}): void {\n  const pages = loadPages(siteConfig, options);\n  const indexes = pages.filter(isIndex).filter((index) => index.index.feed);\n  const site = resolveSiteLocation(siteConfig, options);\n  if (!site) {\n    if (indexes.length) {\n      siteConfig.logger?.warn(\n        '[vitepress-blog] no feeds written: set the siteUrl option or sitemap.hostname so feeds can use absolute links.',\n      );\n    }\n    return;\n  }\n\n  const written = new Map<string, string>();\n  for (const index of indexes) {\n    const feedPath = toFeedPath(index);\n    if (written.has(feedPath)) {\n      siteConfig.logger?.warn(\n        `[vitepress-blog] ${index.relativePath} and ${written.get(feedPath)} both write ${feedPath}; set feed.path on one of them.`,\n      );\n      continue;\n    }\n    written.set(feedPath, index.relativePath);\n    const file = path.join(siteConfig.outDir, feedPath);\n    mkdirSync(path.dirname(file), { recursive: true });\n    writeFileSync(file, renderIndexFeed(pages, index, site, siteConfig, options));\n  }\n\n  for (const post of pages.filter(isPost)) {\n    if (post.post.draft) continue;\n    const image = resolvePostImage(post, site);\n    if (!image?.file || !image.outputPath) continue;\n    const target = path.join(siteConfig.outDir, image.outputPath);\n    mkdirSync(path.dirname(target), { recursive: true });\n    copyFileSync(image.file, target);\n  }\n}\n\n/**\n * The Vite side of the blog, for `vitepress dev`:\n *\n * - VitePress caches a page's rendered output by its own source, so a new or\n *   edited post would leave blog lists and \"newer / older\" links stale. This\n *   adds a fingerprint of every post to blog pages and posts (busting the\n *   cache) and reloads them when any of them changes.\n * - Serves each blog's feed and the copied post images, which the build\n *   writes in `buildEnd`, so feed links work in development too.\n */\nexport function blogVitePlugin(options: BlogOptions = {}): Plugin {\n  let siteConfig: SiteConfig | undefined;\n  const currentPages = () => (siteConfig ? loadPages(siteConfig, options) : []);\n  // Every file whose output shows posts: blog pages, posts, and pages with a `::: blog-posts` block.\n  const dependentFiles = () => [...currentPages().map((page) => page.absolutePath), ...widgetPages];\n\n  return {\n    name: 'vitepress-blog',\n    enforce: 'pre',\n    configResolved(config) {\n      siteConfig = (config as { vitepress?: SiteConfig }).vitepress;\n    },\n    transform(code, id) {\n      if (!siteConfig || !id.endsWith('.md') || !(mayHaveBlogFrontmatter(code) || hasWidget(code))) return null;\n      return { code: `${code}\\n<!-- vitepress-blog:${fingerprintBlogSource(currentPages())} -->\\n`, map: null };\n    },\n    configureServer(server) {\n      // Vite only calls handleHotUpdate for edits; a post added or deleted changes the lists too.\n      const refresh = (file: string) => {\n        if (!siteConfig || !file.endsWith('.md')) return;\n        for (const dependent of dependentFiles()) {\n          for (const module of server.moduleGraph.getModulesByFile(dependent) ?? []) {\n            server.moduleGraph.invalidateModule(module);\n          }\n        }\n        server.ws.send({ type: 'full-reload' });\n      };\n      server.watcher.on('add', refresh).on('unlink', refresh);\n\n      server.middlewares.use((request, response, next) => {\n        if (!siteConfig || !request.url) return next();\n        const base = siteConfig.site?.base ?? '/';\n        const pathname = decodeURIComponent(request.url.split('?')[0]);\n        if (!pathname.startsWith(base)) return next();\n        const relative = pathname.slice(base.length);\n        const pages = currentPages();\n        // Feeds link to the live site, or to the dev server without a site URL.\n        const site =\n          resolveSiteLocation(siteConfig, options) ??\n          resolveSiteLocation(siteConfig, { ...options, siteUrl: `http://${request.headers.host ?? 'localhost'}` })!;\n\n        const index = pages.filter(isIndex).find((page) => page.index.feed && toFeedPath(page) === relative);\n        if (index) {\n          response.setHeader('Content-Type', 'application/rss+xml; charset=utf-8');\n          response.end(renderIndexFeed(pages, index, site, siteConfig, options));\n          return;\n        }\n        for (const post of pages.filter(isPost)) {\n          const image = resolvePostImage(post, site);\n          if (image?.outputPath === relative && image.file) {\n            if (image.type) response.setHeader('Content-Type', image.type);\n            response.end(readFileSync(image.file));\n            return;\n          }\n        }\n        next();\n      });\n    },\n    handleHotUpdate({ file, modules, server }) {\n      if (!siteConfig || !file.endsWith('.md')) return;\n      const pages = currentPages();\n      if (!pages.some((page) => page.absolutePath === file)) return;\n      const affected = dependentFiles()\n        .filter((dependent) => dependent !== file)\n        .flatMap((dependent) => [...(server.moduleGraph.getModulesByFile(dependent) ?? [])]);\n      return affected.length ? [...modules, ...affected] : undefined;\n    },\n  };\n}\n\n/**\n * Wraps a VitePress config with the whole blog: the Markdown plugin, the dev\n * server plugin, `<head>` tags, descriptions from summaries, and feeds at the\n * end of the build.\n *\n * ```ts\n * // .vitepress/config.mts\n * import { defineConfig } from 'vitepress';\n * import { withBlog } from '@binarynoir/vitepress-blog/vitepress';\n *\n * export default withBlog(defineConfig({ /* ...your config... *\\/ }), { siteUrl: 'https://example.com' });\n * ```\n *\n * Hooks you already have (`markdown.config`, `transformHead`,\n * `transformPageData`, `buildEnd`) are not replaced: the blog's runs and\n * then yours, so it composes with other `withX()` wrappers in any order.\n */\nexport function withBlog(config: UserConfig, options: BlogOptions = {}): UserConfig {\n  config.markdown ??= {};\n  const existingMarkdownConfig = config.markdown.config ?? (() => {});\n  config.markdown.config = (md) => {\n    // VitePress 2 types this callback against `markdown-it-async`'s MarkdownIt,\n    // a structural superset of plain markdown-it's; the cast bridges the two.\n    blogMarkdown(md as unknown as MarkdownIt, options);\n    existingMarkdownConfig(md);\n  };\n\n  config.vite ??= {};\n  config.vite.plugins = [...(config.vite.plugins ?? []), blogVitePlugin(options)];\n\n  const existingTransformHead = config.transformHead;\n  config.transformHead = async (context) => [\n    ...blogHead(context, options),\n    ...((await existingTransformHead?.(context)) ?? []),\n  ];\n\n  const existingTransformPageData = config.transformPageData;\n  config.transformPageData = (pageData, context) => {\n    blogPageData(pageData, context, options);\n    return existingTransformPageData?.(pageData, context);\n  };\n\n  const existingBuildEnd = config.buildEnd;\n  config.buildEnd = async (siteConfig) => {\n    writeBlogFeeds(siteConfig, options);\n    await existingBuildEnd?.(siteConfig);\n  };\n\n  return config;\n}\n\nexport { blogMarkdown };\nexport type { BlogOptions };\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,110 @@
 {
   "name": "@binarynoir/vitepress-blog",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.1",
+  "description": "Turn any VitePress 2 page into a blog post with frontmatter. A main blog, folder-scoped section blogs, sticky posts, pagination, keyword filters and an RSS feed for each.",
+  "keywords": [
+    "vitepress",
+    "vitepress-plugin",
+    "markdown-it",
+    "markdown-it-plugin",
+    "blog",
+    "rss",
+    "rss-feed",
+    "feed",
+    "pagination",
+    "tags",
+    "docs",
+    "documentation"
+  ],
+  "license": "MIT",
+  "author": "BinaryNoir",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/binarynoir/vitepress-blog.git"
+  },
+  "homepage": "https://github.com/binarynoir/vitepress-blog#readme",
+  "bugs": {
+    "url": "https://github.com/binarynoir/vitepress-blog/issues"
+  },
+  "type": "module",
+  "sideEffects": [
+    "./dist/style.css"
+  ],
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./vitepress": {
+      "types": "./dist/vitepress.d.ts",
+      "import": "./dist/vitepress.js",
+      "require": "./dist/vitepress.cjs"
+    },
+    "./client": {
+      "types": "./dist/client.d.ts",
+      "import": "./dist/client.js",
+      "require": "./dist/client.cjs"
+    },
+    "./style.css": "./dist/style.css",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint .",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "prepublishOnly": "npm run typecheck && npm run test && npm run build",
+    "release": "node scripts/release.js",
+    "release:patch": "node scripts/release.js patch",
+    "release:minor": "node scripts/release.js minor",
+    "release:major": "node scripts/release.js major"
+  },
+  "dependencies": {
+    "yaml": "^2.9.1"
+  },
+  "peerDependencies": {
+    "markdown-it": "^15.0.0",
+    "vitepress": "^1.0.0 || ^2.0.0-0",
+    "vue": "^3.4.0"
+  },
+  "peerDependenciesMeta": {
+    "vitepress": {
+      "optional": true
+    },
+    "vue": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^26.6.4",
+    "eslint": "^10.11.0",
+    "eslint-config-prettier": "^10.1.8",
+    "happy-dom": "^21.0.3",
+    "markdown-it": "^15.0.2",
+    "prettier": "^3.9.8",
+    "tsup": "^8.5.1",
+    "typescript": "^6.0.3",
+    "typescript-eslint": "^8.70.0",
+    "vite": "^8.3.0",
+    "vitepress": "2.0.0-alpha.20",
+    "vitest": "^5.0.1",
+    "vue": "^3.5.0"
+  }
+}