@fullstackdatasolutions/articles 0.9.0 → 0.11.0

package/dist/server.d.ts

@@ -1,3 +1,4 @@
+import { ComponentType } from 'react';
 import { Metadata, MetadataRoute } from 'next';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 
@@ -21,6 +22,7 @@ interface Article {
     date?: string;
     lastmod?: string;
     author: string;
+    authors?: string[];
     category: string;
     categories: string[];
     readTime: string;
@@ -45,6 +47,35 @@ interface CategoryInfo {
     count: number;
     featuredImage: string;
 }
+interface AuthorSocial {
+    website?: string;
+    facebook?: string;
+    twitter?: string;
+    x?: string;
+    linkedin?: string;
+    instagram?: string;
+    youtube?: string;
+    tiktok?: string;
+    github?: string;
+    bluesky?: string;
+    threads?: string;
+    mastodon?: string;
+    medium?: string;
+    newsletter?: string;
+    other?: Record<string, string>;
+}
+interface AuthorProfile {
+    name: string;
+    slug: string;
+    bio: string;
+    avatar?: string;
+    url?: string;
+    social?: AuthorSocial;
+}
+interface BreadcrumbItem {
+    name: string;
+    url?: string;
+}
 
 /** Keys for each renderable section of the articles listing page. */
 type ArticlesSection = 'hero' | 'search' | 'featured' | 'latest' | 'categories' | 'newsletter';
@@ -106,6 +137,41 @@ interface HeroConfig {
 }
 /** Controls how article body links set target/rel attributes. */
 type LinkTargetStrategy = 'external-new-tab' | 'all-new-tab' | 'same-tab';
+/** React components that article MDX bodies can reference by JSX tag name. */
+type MdxComponents = Record<string, ComponentType<never>>;
+type ArticleBreadcrumbToken = 'home' | 'articles' | 'primaryCategory' | 'folderPath' | 'articleTitle';
+type CategoryBreadcrumbToken = 'home' | 'articles' | 'category';
+type AuthorBreadcrumbToken = 'home' | 'articles' | 'authors' | 'authorName';
+interface CustomBreadcrumbItem {
+    /** Label displayed in the breadcrumb trail. */
+    name: string;
+    /** Custom URL. Relative paths are resolved against `siteUrl` by server builders. */
+    url: string;
+}
+type ArticleBreadcrumbEntry = ArticleBreadcrumbToken | CustomBreadcrumbItem;
+type CategoryBreadcrumbEntry = CategoryBreadcrumbToken | CustomBreadcrumbItem;
+type AuthorBreadcrumbEntry = AuthorBreadcrumbToken | CustomBreadcrumbItem;
+interface BreadcrumbLabels {
+    home?: string;
+    articles?: string;
+    authors?: string;
+}
+interface BreadcrumbsConfig {
+    /** Set to false to hide visible breadcrumbs and breadcrumb JSON-LD generated by the helper builders. */
+    show?: boolean;
+    /** Separator used by the visible Breadcrumb component. Default: '>'. */
+    separator?: string;
+    /** Set to false to render visible breadcrumbs without JSON-LD. Default: true. */
+    showSchema?: boolean;
+    /** Article breadcrumb trail. Example: ['primaryCategory', { name: 'Guides', url: '/guides' }, 'articleTitle']. */
+    article?: ArticleBreadcrumbEntry[];
+    /** Category breadcrumb trail. Default: ['home', 'articles', 'category']. */
+    category?: CategoryBreadcrumbEntry[];
+    /** Author breadcrumb trail. Default: ['home', 'articles', 'authors', 'authorName']. */
+    author?: AuthorBreadcrumbEntry[];
+    /** Optional label overrides for built-in breadcrumb items. */
+    labels?: BreadcrumbLabels;
+}
 /** Top-level configuration object. Pass one instance to every library component. */
 interface ArticlesConfig {
     /** Canonical base URL of the site, used in metadata and JSON-LD. Example: `'https://yoursite.com'` */
@@ -141,14 +207,28 @@ interface ArticlesConfig {
     showBackToArticles?: boolean;
     /** Set to false to hide author names from UI and metadata. Default: true. */
     showAuthor?: boolean;
+    /** Author profiles keyed by slug. Omit to keep plain string author display. */
+    authors?: Record<string, AuthorProfile>;
+    /** Author slug used when article frontmatter omits author fields. */
+    defaultAuthor?: string;
+    /** Set to false to disable copied author page routes in consuming apps. Default: true. */
+    showAuthorPage?: boolean;
+    /** Set to false to disable breadcrumbs, or pass a config object to customize breadcrumb trails. */
+    breadcrumbs?: false | BreadcrumbsConfig;
     /** Article body link target behavior. Default: `'external-new-tab'`. */
     linkTargetStrategy?: LinkTargetStrategy;
+    /** Extra components exposed to article MDX bodies by JSX tag name. */
+    mdxComponents?: MdxComponents;
 }
+declare function getBreadcrumbsConfig(config: ArticlesConfig): BreadcrumbsConfig;
 
 declare function sanitizeImagePath(rawPath: string, articleSlug: string): string | null;
 declare function getAvailableArticleSlugs(): string[];
+declare function getAuthorBySlug(slug: string, config: ArticlesConfig): AuthorProfile | null;
+declare function getArticleAuthors(article: Article, config: ArticlesConfig): AuthorProfile[];
+declare function getAllAuthors(config: ArticlesConfig): AuthorProfile[];
 declare const getArticleMetadata: (slug: string, config?: ArticlesConfig) => Promise<Article | null>;
-declare const getAllArticles: () => Promise<Article[]>;
+declare const getAllArticles: (config?: ArticlesConfig) => Promise<Article[]>;
 declare function getAdjacentArticles(currentSlug: string): Promise<{
     previous: Article | null;
     next: Article | null;
@@ -161,7 +241,8 @@ declare function getAiRobotsTxtRules(): Promise<string>;
 declare function searchArticles(query: string, config?: ArticlesConfig): Promise<Article[]>;
 declare function categoryToSlug(category: string): string;
 declare function getAllCategories(): Promise<CategoryInfo[]>;
-declare function getArticlesByCategory(categorySlug: string): Promise<Article[]>;
+declare function getArticlesByCategory(categorySlug: string, config?: ArticlesConfig): Promise<Article[]>;
+declare function getArticlesByAuthor(authorSlug: string, config: ArticlesConfig): Promise<Article[]>;
 
 declare function generateRssFeed(articles: Article[], config: ArticlesConfig): string;
 declare function generateArticleStaticParams(): {
@@ -170,9 +251,17 @@ declare function generateArticleStaticParams(): {
 declare function generateCategoryStaticParams(): Promise<{
     category: string;
 }[]>;
+declare function generateAuthorStaticParams(config: ArticlesConfig): {
+    author: string;
+}[];
 declare function generateArticleMetadata(slug: string, config: ArticlesConfig): Promise<Metadata>;
 declare function generateArticlesIndexMetadata(config: ArticlesConfig): Metadata;
 declare function generateCategoryMetadata(categorySlug: string, config: ArticlesConfig): Promise<Metadata>;
+declare function generateAuthorMetadata(authorSlug: string, config: ArticlesConfig): Promise<Metadata>;
+declare function buildArticleBreadcrumbs(article: Pick<Article, 'slug' | 'title' | 'category'>, config: ArticlesConfig): BreadcrumbItem[];
+declare function buildCategoryBreadcrumbs(category: string, config: ArticlesConfig, categoryName?: string): BreadcrumbItem[];
+declare function buildAuthorBreadcrumbs(author: AuthorProfile, config: ArticlesConfig): BreadcrumbItem[];
+declare function resolveAuthorAvatar(author: AuthorProfile, config: ArticlesConfig): string;
 declare function getArticleSitemapEntries(baseUrlOrConfig: string | ArticlesConfig): Promise<MetadataRoute.Sitemap>;
 
 declare function markdownToHtml(markdown: string, articleSlug?: string, config?: ArticlesConfig): Promise<string>;
@@ -202,4 +291,4 @@ type ArticleTOCProps = Readonly<{
 }>;
 declare function ArticleTOC({ toc, className }: ArticleTOCProps): react_jsx_runtime.JSX.Element | null;
 
-export { type Article, ArticleContent, ArticleTOC, type ArticlesConfig, type ArticlesErrorCode, type ArticlesErrorContext, type ArticlesErrorHandler, type ArticlesErrorReport, type CategoryInfo, type LinkTargetStrategy, type TocItem, categoryToSlug, extractToc, generateArticleMetadata, generateArticleStaticParams, generateArticlesIndexMetadata, generateCategoryMetadata, generateCategoryStaticParams, generateRssFeed, getAdjacentArticles, getAiRobotsTxtRules, getAllArticles, getAllCategories, getArticleAiHeaders, getArticleMarkdown, getArticleMarkdownResponse, getArticleMarkdownUrl, getArticleMetadata, getArticleSitemapEntries, getArticlesByCategory, getAvailableArticleSlugs, markdownToHtml, sanitizeImagePath, searchArticles, setArticlesErrorHandler };
+export { type Article, ArticleContent, ArticleTOC, type ArticlesConfig, type ArticlesErrorCode, type ArticlesErrorContext, type ArticlesErrorHandler, type ArticlesErrorReport, type AuthorProfile, type AuthorSocial, type BreadcrumbItem, type CategoryInfo, type LinkTargetStrategy, type TocItem, buildArticleBreadcrumbs, buildAuthorBreadcrumbs, buildCategoryBreadcrumbs, categoryToSlug, extractToc, generateArticleMetadata, generateArticleStaticParams, generateArticlesIndexMetadata, generateAuthorMetadata, generateAuthorStaticParams, generateCategoryMetadata, generateCategoryStaticParams, generateRssFeed, getAdjacentArticles, getAiRobotsTxtRules, getAllArticles, getAllAuthors, getAllCategories, getArticleAiHeaders, getArticleAuthors, getArticleMarkdown, getArticleMarkdownResponse, getArticleMarkdownUrl, getArticleMetadata, getArticleSitemapEntries, getArticlesByAuthor, getArticlesByCategory, getAuthorBySlug, getAvailableArticleSlugs, getBreadcrumbsConfig, markdownToHtml, resolveAuthorAvatar, sanitizeImagePath, searchArticles, setArticlesErrorHandler };

package/dist/server.js

@@ -520,7 +520,67 @@ function parseHowToSteps(raw) {
   );
   return steps.length ? steps : void 0;
 }
-function getArticleSummary(slug) {
+function parseAuthors(raw) {
+  if (!Array.isArray(raw)) return void 0;
+  const authors = raw.filter(
+    (author) => typeof author === "string" && author.trim().length > 0
+  );
+  return authors;
+}
+function getAuthorBySlug(slug, config) {
+  var _a, _b;
+  const profile = (_a = config.authors) == null ? void 0 : _a[slug];
+  if (!profile) return null;
+  return __spreadProps(__spreadValues({}, profile), {
+    url: (_b = profile.url) != null ? _b : `${config.siteUrl.replace(/\/$/, "")}/articles/authors/${profile.slug}`
+  });
+}
+function getConfiguredAuthorByName(name, config) {
+  var _a;
+  const normalizedName = name.trim().toLowerCase();
+  const profile = Object.values((_a = config.authors) != null ? _a : {}).find(
+    (author) => author.name.toLowerCase() === normalizedName
+  );
+  return profile ? getAuthorBySlug(profile.slug, config) : null;
+}
+function resolveArticleAuthorName(rawAuthor, rawAuthors, config) {
+  var _a, _b, _c, _d;
+  const authorArray = parseAuthors(rawAuthors);
+  const firstAuthor = authorArray == null ? void 0 : authorArray[0];
+  const rawAuthorValue = typeof rawAuthor === "string" && rawAuthor.trim() ? rawAuthor : void 0;
+  const author = firstAuthor != null ? firstAuthor : rawAuthorValue;
+  const resolved = author != null ? author : config == null ? void 0 : config.defaultAuthor;
+  if (!resolved) return "";
+  if (!config) return resolved;
+  return (_d = (_c = (_a = getAuthorBySlug(resolved, config)) == null ? void 0 : _a.name) != null ? _c : (_b = getConfiguredAuthorByName(resolved, config)) == null ? void 0 : _b.name) != null ? _d : resolved;
+}
+function getArticleAuthors(article, config) {
+  var _a;
+  const fallbackAuthors = Array.from(
+    new Set(
+      [article.author, config.defaultAuthor].filter(
+        (author) => typeof author === "string" && author.trim().length > 0
+      )
+    )
+  );
+  const authorValues = (_a = article.authors) != null ? _a : fallbackAuthors;
+  if (authorValues.length === 0) return [];
+  const resolvedAuthors = authorValues.map((author) => {
+    var _a2;
+    return (_a2 = getAuthorBySlug(author, config)) != null ? _a2 : getConfiguredAuthorByName(author, config);
+  }).filter((author) => author !== null).filter((author, index, all) => all.findIndex((a) => a.slug === author.slug) === index);
+  if (resolvedAuthors.length > 0) return resolvedAuthors;
+  return authorValues.map((fallbackName) => ({
+    name: fallbackName,
+    slug: categoryToSlug(fallbackName),
+    bio: ""
+  }));
+}
+function getAllAuthors(config) {
+  var _a;
+  return Object.keys((_a = config.authors) != null ? _a : {}).map((slug) => getAuthorBySlug(slug, config)).filter((author) => author !== null);
+}
+function getArticleSummary(slug, config) {
   return __async(this, null, function* () {
     try {
       const found = findArticleFile(slug);
@@ -536,7 +596,8 @@ function getArticleSummary(slug) {
         excerpt: data.excerpt || "",
         date: parseDateField(data.date),
         lastmod: parseDateField(data.lastmod),
-        author: data.author || "Andrew Blase",
+        author: resolveArticleAuthorName(data.author, data.authors, config),
+        authors: parseAuthors(data.authors),
         category: categories[0],
         categories,
         readTime,
@@ -565,7 +626,7 @@ function getArticleSummary(slug) {
 var getArticleMetadata = cache(
   (slug, config) => __async(void 0, null, function* () {
     try {
-      const summary = yield getArticleSummary(slug);
+      const summary = yield getArticleSummary(slug, config);
       if (!summary) return null;
       const found = findArticleFile(slug);
       if (!found) return null;
@@ -591,9 +652,9 @@ var getArticleMetadata = cache(
     }
   })
 );
-var getAllArticles = cache(() => __async(void 0, null, function* () {
+var getAllArticles = cache((config) => __async(void 0, null, function* () {
   const slugs = getAvailableArticleSlugs();
-  const articles = yield Promise.all(slugs.map((slug) => getArticleSummary(slug)));
+  const articles = yield Promise.all(slugs.map((slug) => getArticleSummary(slug, config)));
   const currentDate = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
   return articles.filter((article) => article !== null).filter((article) => !article.date || article.date <= currentDate).filter((article) => !(article.draft && process.env.NODE_ENV === "production")).sort((a, b) => {
     if (!a.date && !b.date) return 0;
@@ -683,8 +744,8 @@ function getAiRobotsTxtRules() {
 }
 function searchArticles(query, config) {
   return __async(this, null, function* () {
-    if (!(query == null ? void 0 : query.trim())) return getAllArticles();
-    const articles = yield getAllArticles();
+    if (!(query == null ? void 0 : query.trim())) return getAllArticles(config);
+    const articles = yield getAllArticles(config);
     const searchTerm = query.toLowerCase().trim();
     const includeAuthor = (config == null ? void 0 : config.showAuthor) !== false;
     return articles.filter((article) => {
@@ -721,14 +782,33 @@ function getAllCategories() {
     })).sort((a, b) => b.count - a.count);
   });
 }
-function getArticlesByCategory(categorySlug) {
+function getArticlesByCategory(categorySlug, config) {
   return __async(this, null, function* () {
-    const articles = yield getAllArticles();
+    const articles = yield getAllArticles(config);
     return articles.filter(
       (article) => article.categories.some((cat) => categoryToSlug(cat) === categorySlug)
     );
   });
 }
+function getArticlesByAuthor(authorSlug, config) {
+  return __async(this, null, function* () {
+    const articles = yield getAllArticles(config);
+    return articles.filter(
+      (article) => getArticleAuthors(article, config).some((author) => author.slug === authorSlug)
+    );
+  });
+}
+
+// src/articlesConfig.ts
+function breadcrumbsAreEnabled(config) {
+  var _a;
+  return config.breadcrumbs !== false && ((_a = config.breadcrumbs) == null ? void 0 : _a.show) !== false;
+}
+function getBreadcrumbsConfig(config) {
+  var _a;
+  if (config.breadcrumbs === false) return {};
+  return (_a = config.breadcrumbs) != null ? _a : {};
+}
 
 // src/seoUtils.ts
 function escapeXml(str) {
@@ -777,6 +857,10 @@ function generateCategoryStaticParams() {
     return categories.map((cat) => ({ category: cat.slug }));
   });
 }
+function generateAuthorStaticParams(config) {
+  if (config.showAuthorPage === false) return [];
+  return getAllAuthors(config).map((author) => ({ author: author.slug }));
+}
 function resolveImageUrl(featuredImage, siteUrl) {
   const base = siteUrl.replace(/\/$/, "");
   if (featuredImage.startsWith("http://") || featuredImage.startsWith("https://")) {
@@ -787,7 +871,7 @@ function resolveImageUrl(featuredImage, siteUrl) {
 function generateArticleMetadata(slug, config) {
   return __async(this, null, function* () {
     var _a, _b, _c, _d, _e, _f, _g;
-    const article = yield getArticleMetadata(slug);
+    const article = yield getArticleMetadata(slug, config);
     if (!article) {
       return {
         title: "Article Not Found",
@@ -801,6 +885,7 @@ function generateArticleMetadata(slug, config) {
     const description = (_b = article.excerpt) != null ? _b : `Read ${article.title} on ${config.siteName}.`;
     const showAuthor = config.showAuthor !== false;
     const markdownUrl = getArticleMarkdownUrl(article, config);
+    const authorNames = getArticleAuthors(article, config).map((author) => author.name);
     return {
       title: `${article.title} | ${config.siteName}`,
       description,
@@ -813,7 +898,7 @@ function generateArticleMetadata(slug, config) {
         images: [{ url: imageUrl, width: 1200, height: 630, alt: article.title }],
         locale: "en_US",
         type: "article"
-      }, article.date && { publishedTime: article.date }), article.lastmod && { modifiedTime: new Date(article.lastmod).toISOString() }), showAuthor && { authors: [article.author] }), {
+      }, article.date && { publishedTime: article.date }), article.lastmod && { modifiedTime: new Date(article.lastmod).toISOString() }), showAuthor && authorNames.length > 0 && { authors: authorNames }), {
         tags: (_d = article.tags) != null ? _d : []
       }),
       twitter: {
@@ -840,7 +925,7 @@ function generateArticleMetadata(slug, config) {
           "max-snippet": -1
         }
       },
-      other: __spreadProps(__spreadValues(__spreadValues(__spreadValues({}, showAuthor && { "article:author": article.author }), article.date && {
+      other: __spreadProps(__spreadValues(__spreadValues(__spreadValues({}, showAuthor && authorNames.length > 0 && { "article:author": authorNames.join(", ") }), article.date && {
         "article:published_time": new Date(article.date).toISOString()
       }), article.lastmod && {
         "article:modified_time": new Date(article.lastmod).toISOString()
@@ -939,11 +1024,162 @@ function generateCategoryMetadata(categorySlug, config) {
     };
   });
 }
+function generateAuthorMetadata(authorSlug, config) {
+  return __async(this, null, function* () {
+    var _a;
+    const author = getAuthorBySlug(authorSlug, config);
+    if (!author || config.showAuthorPage === false) return { title: "Author Not Found" };
+    const siteUrl = config.siteUrl.replace(/\/$/, "");
+    const authorUrl = (_a = author.url) != null ? _a : `${siteUrl}/articles/authors/${author.slug}`;
+    const title = `${author.name} Articles | ${config.siteName}`;
+    return {
+      title,
+      description: author.bio,
+      openGraph: __spreadValues({
+        title,
+        description: author.bio,
+        url: authorUrl,
+        siteName: config.siteName,
+        type: "profile",
+        locale: "en_US"
+      }, author.avatar && { images: [{ url: resolveAuthorAvatar(author, config) }] }),
+      twitter: __spreadValues({
+        card: "summary_large_image",
+        title,
+        description: author.bio
+      }, author.avatar && { images: [resolveAuthorAvatar(author, config)] }),
+      alternates: {
+        canonical: authorUrl
+      },
+      robots: {
+        index: true,
+        follow: true
+      }
+    };
+  });
+}
+function formatCategoryName(category) {
+  return category.split("-").filter(Boolean).map((part) => part.charAt(0).toUpperCase() + part.slice(1)).join(" ");
+}
+function buildArticleBreadcrumbs(article, config) {
+  var _a, _b;
+  if (!breadcrumbsAreEnabled(config)) return [];
+  const siteUrl = config.siteUrl.replace(/\/$/, "");
+  const breadcrumbConfig = getBreadcrumbsConfig(config);
+  const labels = (_a = breadcrumbConfig.labels) != null ? _a : {};
+  const categorySlug = categoryToSlug(article.category);
+  const trail = (_b = breadcrumbConfig.article) != null ? _b : ["home", "articles", "primaryCategory", "articleTitle"];
+  const folderSegments = article.slug.split("/").filter(Boolean).slice(0, -1);
+  return trail.flatMap(
+    (token) => buildArticleBreadcrumbToken(token, {
+      article,
+      siteUrl,
+      categorySlug,
+      folderSegments,
+      labels
+    })
+  );
+}
+function buildCategoryBreadcrumbs(category, config, categoryName = formatCategoryName(category)) {
+  var _a, _b;
+  if (!breadcrumbsAreEnabled(config)) return [];
+  const siteUrl = config.siteUrl.replace(/\/$/, "");
+  const breadcrumbConfig = getBreadcrumbsConfig(config);
+  const labels = (_a = breadcrumbConfig.labels) != null ? _a : {};
+  const trail = (_b = breadcrumbConfig.category) != null ? _b : ["home", "articles", "category"];
+  return trail.flatMap(
+    (entry) => buildCategoryBreadcrumbEntry(entry, { categoryName, siteUrl, labels })
+  );
+}
+function buildAuthorBreadcrumbs(author, config) {
+  var _a, _b;
+  if (!breadcrumbsAreEnabled(config)) return [];
+  const siteUrl = config.siteUrl.replace(/\/$/, "");
+  const breadcrumbConfig = getBreadcrumbsConfig(config);
+  const labels = (_a = breadcrumbConfig.labels) != null ? _a : {};
+  const trail = (_b = breadcrumbConfig.author) != null ? _b : ["home", "articles", "authors", "authorName"];
+  return trail.flatMap(
+    (entry) => buildAuthorBreadcrumbEntry(entry, { author, siteUrl, labels })
+  );
+}
+function isCustomBreadcrumbItem(entry) {
+  return typeof entry === "object" && entry !== null && "name" in entry && "url" in entry;
+}
+function resolveCustomBreadcrumbItem(item, siteUrl) {
+  if (item.url.startsWith("/")) return { name: item.name, url: `${siteUrl}${item.url}` };
+  return { name: item.name, url: item.url };
+}
+function buildArticleBreadcrumbToken(entry, context) {
+  var _a, _b;
+  if (isCustomBreadcrumbItem(entry)) {
+    return [resolveCustomBreadcrumbItem(entry, context.siteUrl)];
+  }
+  if (entry === "home") return [{ name: (_a = context.labels.home) != null ? _a : "Home", url: context.siteUrl }];
+  if (entry === "articles") {
+    return [{ name: (_b = context.labels.articles) != null ? _b : "Articles", url: `${context.siteUrl}/articles` }];
+  }
+  if (entry === "primaryCategory") {
+    return [
+      {
+        name: context.article.category,
+        url: `${context.siteUrl}/articles/category/${context.categorySlug}`
+      }
+    ];
+  }
+  if (entry === "folderPath") {
+    return context.folderSegments.map((segment, index) => ({
+      name: formatCategoryName(segment),
+      url: `${context.siteUrl}/articles/${context.folderSegments.slice(0, index + 1).join("/")}`
+    }));
+  }
+  return [{ name: context.article.title }];
+}
+function buildCategoryBreadcrumbEntry(entry, context) {
+  var _a, _b;
+  if (isCustomBreadcrumbItem(entry)) {
+    return [resolveCustomBreadcrumbItem(entry, context.siteUrl)];
+  }
+  if (entry === "home") return [{ name: (_a = context.labels.home) != null ? _a : "Home", url: context.siteUrl }];
+  if (entry === "articles") {
+    return [{ name: (_b = context.labels.articles) != null ? _b : "Articles", url: `${context.siteUrl}/articles` }];
+  }
+  return [{ name: context.categoryName }];
+}
+function buildAuthorBreadcrumbEntry(entry, context) {
+  var _a, _b, _c;
+  if (isCustomBreadcrumbItem(entry)) {
+    return [resolveCustomBreadcrumbItem(entry, context.siteUrl)];
+  }
+  if (entry === "home") return [{ name: (_a = context.labels.home) != null ? _a : "Home", url: context.siteUrl }];
+  if (entry === "articles") {
+    return [{ name: (_b = context.labels.articles) != null ? _b : "Articles", url: `${context.siteUrl}/articles` }];
+  }
+  if (entry === "authors") {
+    return [
+      {
+        name: (_c = context.labels.authors) != null ? _c : "Authors",
+        url: `${context.siteUrl}/articles/authors`
+      }
+    ];
+  }
+  return [{ name: context.author.name }];
+}
+function resolveAuthorAvatar(author, config) {
+  if (!author.avatar) return "";
+  if (author.avatar.startsWith("http://") || author.avatar.startsWith("https://")) {
+    return author.avatar;
+  }
+  const siteUrl = config.siteUrl.replace(/\/$/, "");
+  return `${siteUrl}/articles/authors/${author.slug}/${author.avatar.replace(/^\/+/, "")}`;
+}
 function getArticleSitemapEntries(baseUrlOrConfig) {
   return __async(this, null, function* () {
     const baseUrl = (typeof baseUrlOrConfig === "string" ? baseUrlOrConfig : baseUrlOrConfig.siteUrl).replace(/\/$/, "");
     try {
-      const [articles, categories] = yield Promise.all([getAllArticles(), getAllCategories()]);
+      const [articles, categories] = yield Promise.all([
+        getAllArticles(typeof baseUrlOrConfig === "string" ? void 0 : baseUrlOrConfig),
+        getAllCategories()
+      ]);
       const articleEntries = articles.map((article) => {
         var _a;
         const dateStr = (_a = article.lastmod) != null ? _a : article.date;
@@ -961,7 +1197,12 @@ function getArticleSitemapEntries(baseUrlOrConfig) {
         changeFrequency: "weekly",
         priority: 0.7
       }));
-      return [...articleEntries, ...categoryEntries];
+      const authorEntries = typeof baseUrlOrConfig === "string" || baseUrlOrConfig.showAuthorPage === false ? [] : getAllAuthors(baseUrlOrConfig).map((author) => ({
+        url: `${baseUrl}/articles/authors/${author.slug}`,
+        changeFrequency: "monthly",
+        priority: 0.6
+      }));
+      return [...articleEntries, ...categoryEntries, ...authorEntries];
     } catch (e) {
       return [];
     }
@@ -981,7 +1222,7 @@ import { jsx } from "react/jsx-runtime";
 function makeImgComponent(basePath) {
   return function MdxImage(_a) {
     var _b = _a, { src, alt } = _b, props = __objRest(_b, ["src", "alt"]);
-    const resolvedSrc = src && !src.startsWith("http") && !src.startsWith("/") ? `${basePath}/${src}` : src;
+    const resolvedSrc = typeof src === "string" && !src.startsWith("http") && !src.startsWith("/") ? `${basePath}/${src}` : src;
     return React.createElement("img", __spreadValues({ src: resolvedSrc, alt }, props));
   };
 }
@@ -999,7 +1240,8 @@ function renderMdxSource(source, basePath, config) {
       ]
     }));
     const Content = mdxModule.default;
-    const components = basePath ? { img: makeImgComponent(basePath) } : void 0;
+    const internalComponents = basePath ? { img: makeImgComponent(basePath) } : void 0;
+    const components = internalComponents || (config == null ? void 0 : config.mdxComponents) ? __spreadValues(__spreadValues({}, internalComponents), config == null ? void 0 : config.mdxComponents) : void 0;
     return /* @__PURE__ */ jsx(Content, { components });
   });
 }
@@ -1042,27 +1284,38 @@ function ArticleTOC({ toc, className }) {
 export {
   ArticleContent,
   ArticleTOC,
+  buildArticleBreadcrumbs,
+  buildAuthorBreadcrumbs,
+  buildCategoryBreadcrumbs,
   categoryToSlug,
   extractToc,
   generateArticleMetadata,
   generateArticleStaticParams,
   generateArticlesIndexMetadata,
+  generateAuthorMetadata,
+  generateAuthorStaticParams,
   generateCategoryMetadata,
   generateCategoryStaticParams,
   generateRssFeed,
   getAdjacentArticles,
   getAiRobotsTxtRules,
   getAllArticles,
+  getAllAuthors,
   getAllCategories,
   getArticleAiHeaders,
+  getArticleAuthors,
   getArticleMarkdown,
   getArticleMarkdownResponse,
   getArticleMarkdownUrl,
   getArticleMetadata,
   getArticleSitemapEntries,
+  getArticlesByAuthor,
   getArticlesByCategory,
+  getAuthorBySlug,
   getAvailableArticleSlugs,
+  getBreadcrumbsConfig,
   markdownToHtml,
+  resolveAuthorAvatar,
   sanitizeImagePath2 as sanitizeImagePath,
   searchArticles,
   setArticlesErrorHandler