@binarynoir/vitepress-blog 0.3.0 → 0.5.0

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-export { B as BlogAnnouncementData, a as BlogAnnouncementItem, b as BlogAuthor, c as BlogFeedConfig, d as BlogIndexConfig, e as BlogLabels, f as BlogLayout, g as BlogOptions, h as BlogPostData, i as BlogScope, D as DEFAULT_LABELS, j as blogMarkdown } from './plugin-Bb4rRwO8.cjs';
+export { B as BlogAnnouncementData, a as BlogAnnouncementItem, b as BlogAuthor, c as BlogFeedConfig, d as BlogGroupBy, e as BlogIndexConfig, f as BlogLabels, g as BlogLayout, h as BlogOptions, i as BlogPostData, j as BlogScope, D as DEFAULT_LABELS, k as blogMarkdown } from './plugin-kzO68Abz.cjs';
 import 'markdown-it';
 
 /** Marker a blog page can use to say where its list of posts goes. Without it the list is appended. */

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export { B as BlogAnnouncementData, a as BlogAnnouncementItem, b as BlogAuthor, c as BlogFeedConfig, d as BlogIndexConfig, e as BlogLabels, f as BlogLayout, g as BlogOptions, h as BlogPostData, i as BlogScope, D as DEFAULT_LABELS, j as blogMarkdown } from './plugin-Bb4rRwO8.js';
+export { B as BlogAnnouncementData, a as BlogAnnouncementItem, b as BlogAuthor, c as BlogFeedConfig, d as BlogGroupBy, e as BlogIndexConfig, f as BlogLabels, g as BlogLayout, h as BlogOptions, i as BlogPostData, j as BlogScope, D as DEFAULT_LABELS, k as blogMarkdown } from './plugin-kzO68Abz.js';
 import 'markdown-it';
 
 /** Marker a blog page can use to say where its list of posts goes. Without it the list is appended. */

package/dist/index.js

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

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

@@ -64,10 +64,12 @@ interface BlogOptions {
      */
     pageSize?: number;
     /**
-     * Most sticky posts pinned to the top of a blog page, for those that don't
-     * set `stickyLimit`. Extra sticky posts take their place by date. `0` pins
-     * them all. Default: `0`.
+     * Most `pinned: true` posts kept at the top of a blog page, for those that
+     * don't set `pinLimit`. Extra pinned posts take their place by date. `0`
+     * pins them all. Default: `0`.
      */
+    pinLimit?: number;
+    /** @deprecated Renamed `pinLimit`; still read when `pinLimit` isn't set. */
     stickyLimit?: number;
     /**
      * Show a "Subscribe" RSS link on blog pages and `::: blog-posts` blocks,
@@ -75,7 +77,7 @@ interface BlogOptions {
      * on a site with a site URL (without one, no feeds are written). Default: `true`.
      */
     rssLink?: boolean;
-    /** Words the plugin writes on pages, for translating. `{n}`, `{blog}` and `{tag}` are filled in. */
+    /** Words the plugin writes on pages, for translating. `{n}`, `{blog}`, `{filter}` and `{row}` are filled in. */
     labels?: Partial<BlogLabels>;
 }
 interface BlogLabels {
@@ -94,29 +96,49 @@ interface BlogLabels {
     /** The link back to a post's blog: "All posts in {blog}". */
     allPosts: string;
     draft: string;
-    /** Badge on a sticky post. */
-    sticky: string;
+    /** Badge on a pinned post. */
+    pinned: string;
     /** Badge on an announcement, and the accessible name of the announcement banner. */
     announcement: string;
-    /** Above a blog page filtered to announcements (`?announcements`). */
+    /** A blog page's announcements filter (`?announcements`), in the active filters. */
     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. */
+    /** Group heading for posts without a date, when a blog groups by year or month. */
     undated: string;
-    /** Label of a blog page's keyword list. */
+    /** Accessible name of the browse panel above a blog page's posts. */
+    browse: string;
+    /** Label of the browse panel's category row. */
+    categories: string;
+    /** Label of the browse panel's keyword row. */
     tags: string;
-    /** Above a list filtered by keyword: "Posts tagged {tag}". */
-    tagged: string;
-    /** Link that clears the keyword filter. */
+    /** Label of the browse panel's year row. */
+    archive: string;
+    /** Names a category filter among the active filters: "Category". */
+    category: string;
+    /** Names a keyword filter among the active filters: "Keyword". */
+    tag: string;
+    /** How many posts the active filters match: "{n} posts". */
+    postCount: string;
+    /** The same, for one post: "{n} post". */
+    postCountOne: string;
+    /** When no post matches the active filters. */
+    noMatches: string;
+    /** Accessible name of an active filter's remove link: "Remove filter: {filter}". */
+    removeFilter: string;
+    /** Link that clears every filter. */
     showAll: string;
-    /** When no post has the keyword: "No posts tagged {tag}." */
-    noTagged: string;
+    /** Button that shows the rest of a browse row: "+{n} more". */
+    more: string;
+    /** Button that shows a browse row's first values again. */
+    less: string;
+    /** Accessible name of the field that narrows a long browse row: "Filter {row}". */
+    filter: string;
+    /** When nothing in a browse row matches the filter field. */
+    noFilterMatches: string;
     previous: string;
     next: string;
     /** Accessible name of the page links. */
@@ -129,6 +151,8 @@ interface BlogLabels {
 declare const DEFAULT_LABELS: BlogLabels;
 type BlogScope = 'site' | 'section';
 type BlogLayout = 'list' | 'grid' | 'compact';
+/** How a blog page groups its posts under headings: by year, by month, or not at all (`''`). */
+type BlogGroupBy = 'year' | 'month' | '';
 interface BlogFeedConfig {
     title?: string;
     description?: string;
@@ -144,19 +168,33 @@ interface BlogIndexConfig {
     folders: string[];
     /** Only list posts with at least one of these tags. */
     tags: string[];
+    /** Only list posts in one of these categories. */
+    categories: string[];
     /** Most posts to list. `0` lists them all. */
     limit: number;
     layout: BlogLayout;
-    /** Put a year heading above each year's posts. */
-    groupByYear: boolean;
+    /** Put a heading above each year's or month's posts. */
+    groupBy: BlogGroupBy;
     /** Show the post's tags on each card. */
     showTags: boolean;
+    /** Show the post's category above its title on each card. */
+    showCategory: boolean;
+    /** List every category above the posts, each one a filter. */
+    categoryList: boolean;
+    /** Categories shown before "+N more", most used first. `0` shows them all. */
+    categoryLimit: number;
     /** List every keyword above the posts, each one a filter. */
     tagList: boolean;
+    /** Keywords shown before "+N more", most used first. `0` shows them all. */
+    tagLimit: number;
+    /** Leave keywords used by fewer posts than this out of the browse panel. They still show on cards. */
+    tagMinCount: number;
+    /** List the years and months that have posts above the posts, each one a filter. */
+    archive: boolean;
     /** Posts per page. `0` shows them all on one page. */
     pageSize: number;
-    /** Most sticky posts pinned to the top. `0` pins them all. */
-    stickyLimit: number;
+    /** Most pinned posts kept at the top. `0` pins them all. */
+    pinLimit: number;
     /** Show a "Subscribe" link to the blog's feed. */
     rssLink: boolean;
     feed: BlogFeedConfig | null;
@@ -184,7 +222,7 @@ interface BlogPostData {
     tags: string[];
     category: string;
     scope: BlogScope;
-    sticky: boolean;
+    pinned: boolean;
     draft: boolean;
     /** Shown in the announcement banner above the nav bar. */
     announcement: boolean;
@@ -240,4 +278,4 @@ interface BlogAnnouncementData {
  */
 declare function blogMarkdown(md: MarkdownIt, options?: BlogOptions): void;
 
-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 };
+export { type BlogAnnouncementData as B, DEFAULT_LABELS as D, type BlogAnnouncementItem as a, type BlogAuthor as b, type BlogFeedConfig as c, type BlogGroupBy as d, type BlogIndexConfig as e, type BlogLabels as f, type BlogLayout as g, type BlogOptions as h, type BlogPostData as i, type BlogScope as j, blogMarkdown as k };

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

@@ -64,10 +64,12 @@ interface BlogOptions {
      */
     pageSize?: number;
     /**
-     * Most sticky posts pinned to the top of a blog page, for those that don't
-     * set `stickyLimit`. Extra sticky posts take their place by date. `0` pins
-     * them all. Default: `0`.
+     * Most `pinned: true` posts kept at the top of a blog page, for those that
+     * don't set `pinLimit`. Extra pinned posts take their place by date. `0`
+     * pins them all. Default: `0`.
      */
+    pinLimit?: number;
+    /** @deprecated Renamed `pinLimit`; still read when `pinLimit` isn't set. */
     stickyLimit?: number;
     /**
      * Show a "Subscribe" RSS link on blog pages and `::: blog-posts` blocks,
@@ -75,7 +77,7 @@ interface BlogOptions {
      * on a site with a site URL (without one, no feeds are written). Default: `true`.
      */
     rssLink?: boolean;
-    /** Words the plugin writes on pages, for translating. `{n}`, `{blog}` and `{tag}` are filled in. */
+    /** Words the plugin writes on pages, for translating. `{n}`, `{blog}`, `{filter}` and `{row}` are filled in. */
     labels?: Partial<BlogLabels>;
 }
 interface BlogLabels {
@@ -94,29 +96,49 @@ interface BlogLabels {
     /** The link back to a post's blog: "All posts in {blog}". */
     allPosts: string;
     draft: string;
-    /** Badge on a sticky post. */
-    sticky: string;
+    /** Badge on a pinned post. */
+    pinned: string;
     /** Badge on an announcement, and the accessible name of the announcement banner. */
     announcement: string;
-    /** Above a blog page filtered to announcements (`?announcements`). */
+    /** A blog page's announcements filter (`?announcements`), in the active filters. */
     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. */
+    /** Group heading for posts without a date, when a blog groups by year or month. */
     undated: string;
-    /** Label of a blog page's keyword list. */
+    /** Accessible name of the browse panel above a blog page's posts. */
+    browse: string;
+    /** Label of the browse panel's category row. */
+    categories: string;
+    /** Label of the browse panel's keyword row. */
     tags: string;
-    /** Above a list filtered by keyword: "Posts tagged {tag}". */
-    tagged: string;
-    /** Link that clears the keyword filter. */
+    /** Label of the browse panel's year row. */
+    archive: string;
+    /** Names a category filter among the active filters: "Category". */
+    category: string;
+    /** Names a keyword filter among the active filters: "Keyword". */
+    tag: string;
+    /** How many posts the active filters match: "{n} posts". */
+    postCount: string;
+    /** The same, for one post: "{n} post". */
+    postCountOne: string;
+    /** When no post matches the active filters. */
+    noMatches: string;
+    /** Accessible name of an active filter's remove link: "Remove filter: {filter}". */
+    removeFilter: string;
+    /** Link that clears every filter. */
     showAll: string;
-    /** When no post has the keyword: "No posts tagged {tag}." */
-    noTagged: string;
+    /** Button that shows the rest of a browse row: "+{n} more". */
+    more: string;
+    /** Button that shows a browse row's first values again. */
+    less: string;
+    /** Accessible name of the field that narrows a long browse row: "Filter {row}". */
+    filter: string;
+    /** When nothing in a browse row matches the filter field. */
+    noFilterMatches: string;
     previous: string;
     next: string;
     /** Accessible name of the page links. */
@@ -129,6 +151,8 @@ interface BlogLabels {
 declare const DEFAULT_LABELS: BlogLabels;
 type BlogScope = 'site' | 'section';
 type BlogLayout = 'list' | 'grid' | 'compact';
+/** How a blog page groups its posts under headings: by year, by month, or not at all (`''`). */
+type BlogGroupBy = 'year' | 'month' | '';
 interface BlogFeedConfig {
     title?: string;
     description?: string;
@@ -144,19 +168,33 @@ interface BlogIndexConfig {
     folders: string[];
     /** Only list posts with at least one of these tags. */
     tags: string[];
+    /** Only list posts in one of these categories. */
+    categories: string[];
     /** Most posts to list. `0` lists them all. */
     limit: number;
     layout: BlogLayout;
-    /** Put a year heading above each year's posts. */
-    groupByYear: boolean;
+    /** Put a heading above each year's or month's posts. */
+    groupBy: BlogGroupBy;
     /** Show the post's tags on each card. */
     showTags: boolean;
+    /** Show the post's category above its title on each card. */
+    showCategory: boolean;
+    /** List every category above the posts, each one a filter. */
+    categoryList: boolean;
+    /** Categories shown before "+N more", most used first. `0` shows them all. */
+    categoryLimit: number;
     /** List every keyword above the posts, each one a filter. */
     tagList: boolean;
+    /** Keywords shown before "+N more", most used first. `0` shows them all. */
+    tagLimit: number;
+    /** Leave keywords used by fewer posts than this out of the browse panel. They still show on cards. */
+    tagMinCount: number;
+    /** List the years and months that have posts above the posts, each one a filter. */
+    archive: boolean;
     /** Posts per page. `0` shows them all on one page. */
     pageSize: number;
-    /** Most sticky posts pinned to the top. `0` pins them all. */
-    stickyLimit: number;
+    /** Most pinned posts kept at the top. `0` pins them all. */
+    pinLimit: number;
     /** Show a "Subscribe" link to the blog's feed. */
     rssLink: boolean;
     feed: BlogFeedConfig | null;
@@ -184,7 +222,7 @@ interface BlogPostData {
     tags: string[];
     category: string;
     scope: BlogScope;
-    sticky: boolean;
+    pinned: boolean;
     draft: boolean;
     /** Shown in the announcement banner above the nav bar. */
     announcement: boolean;
@@ -240,4 +278,4 @@ interface BlogAnnouncementData {
  */
 declare function blogMarkdown(md: MarkdownIt, options?: BlogOptions): void;
 
-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 };
+export { type BlogAnnouncementData as B, DEFAULT_LABELS as D, type BlogAnnouncementItem as a, type BlogAuthor as b, type BlogFeedConfig as c, type BlogGroupBy as d, type BlogIndexConfig as e, type BlogLabels as f, type BlogLayout as g, type BlogOptions as h, type BlogPostData as i, type BlogScope as j, blogMarkdown as k };