@fullstackdatasolutions/articles 0.8.2 → 0.10.0

package/dist/server.cjs

@@ -81,26 +81,38 @@ var server_exports = {};
 __export(server_exports, {
   ArticleContent: () => ArticleContent,
   ArticleTOC: () => ArticleTOC,
+  buildArticleBreadcrumbs: () => buildArticleBreadcrumbs,
+  buildAuthorBreadcrumbs: () => buildAuthorBreadcrumbs,
+  buildCategoryBreadcrumbs: () => buildCategoryBreadcrumbs,
   categoryToSlug: () => categoryToSlug,
   extractToc: () => extractToc,
   generateArticleMetadata: () => generateArticleMetadata,
   generateArticleStaticParams: () => generateArticleStaticParams,
   generateArticlesIndexMetadata: () => generateArticlesIndexMetadata,
+  generateAuthorMetadata: () => generateAuthorMetadata,
+  generateAuthorStaticParams: () => generateAuthorStaticParams,
   generateCategoryMetadata: () => generateCategoryMetadata,
   generateCategoryStaticParams: () => generateCategoryStaticParams,
+  generateRssFeed: () => generateRssFeed,
   getAdjacentArticles: () => getAdjacentArticles,
   getAiRobotsTxtRules: () => getAiRobotsTxtRules,
   getAllArticles: () => getAllArticles,
+  getAllAuthors: () => getAllAuthors,
   getAllCategories: () => getAllCategories,
   getArticleAiHeaders: () => getArticleAiHeaders,
+  getArticleAuthors: () => getArticleAuthors,
   getArticleMarkdown: () => getArticleMarkdown,
   getArticleMarkdownResponse: () => getArticleMarkdownResponse,
   getArticleMarkdownUrl: () => getArticleMarkdownUrl,
   getArticleMetadata: () => getArticleMetadata,
   getArticleSitemapEntries: () => getArticleSitemapEntries,
+  getArticlesByAuthor: () => getArticlesByAuthor,
   getArticlesByCategory: () => getArticlesByCategory,
+  getAuthorBySlug: () => getAuthorBySlug,
   getAvailableArticleSlugs: () => getAvailableArticleSlugs,
+  getBreadcrumbsConfig: () => getBreadcrumbsConfig,
   markdownToHtml: () => markdownToHtml,
+  resolveAuthorAvatar: () => resolveAuthorAvatar,
   sanitizeImagePath: () => sanitizeImagePath2,
   searchArticles: () => searchArticles,
   setArticlesErrorHandler: () => setArticlesErrorHandler
@@ -142,6 +154,48 @@ function reportArticlesError(report) {
 }
 
 // src/markdown.ts
+var DEFAULT_LINK_TARGET_STRATEGY = "external-new-tab";
+function isNonBrowserNavigationLink(href) {
+  return /^[a-zA-Z][a-zA-Z\d+.-]*:/.test(href) && !href.startsWith("http://") && !href.startsWith("https://");
+}
+function getOrigin(url) {
+  if (!url) return null;
+  try {
+    return new URL(url).origin;
+  } catch (e) {
+    return null;
+  }
+}
+function isExternalHttpLink(href, siteUrl) {
+  if (!href.startsWith("http://") && !href.startsWith("https://")) return false;
+  const siteOrigin = getOrigin(siteUrl);
+  if (!siteOrigin) return true;
+  return getOrigin(href) !== siteOrigin;
+}
+function shouldOpenInNewTab(href, options = {}) {
+  var _a;
+  if (!href || href.startsWith("#") || isNonBrowserNavigationLink(href)) return false;
+  const strategy = (_a = options.strategy) != null ? _a : DEFAULT_LINK_TARGET_STRATEGY;
+  if (strategy === "same-tab") return false;
+  if (strategy === "all-new-tab") return true;
+  return isExternalHttpLink(href, options.siteUrl);
+}
+function applyLinkTarget(props, options) {
+  const href = typeof props.href === "string" ? props.href : "";
+  if (shouldOpenInNewTab(href, options)) {
+    props.target = "_blank";
+    props.rel = "noopener noreferrer";
+    return;
+  }
+  delete props.target;
+  delete props.rel;
+}
+function getLinkTargetOptions(config) {
+  return {
+    strategy: config == null ? void 0 : config.linkTargetStrategy,
+    siteUrl: config == null ? void 0 : config.siteUrl
+  };
+}
 function sanitizeImagePath(rawPath, articleSlug) {
   if (!rawPath || typeof rawPath !== "string") {
     return null;
@@ -263,7 +317,7 @@ function processFootnotesSection(node) {
   node.children = [hr, h3, ol];
   if (node.properties) node.properties.className = void 0;
 }
-var customRenderer = () => {
+var customRenderer = (linkTargetOptions = {}) => {
   return (tree) => {
     (0, import_unist_util_visit.visit)(tree, "element", (node) => {
       if (node.tagName) {
@@ -286,11 +340,7 @@ var customRenderer = () => {
             break;
           case "a": {
             props.className = "text-primary hover:underline transition-colors duration-200";
-            const href = typeof props.href === "string" ? props.href : "";
-            if (!href.startsWith("#")) {
-              props.target = "_blank";
-              props.rel = "noopener noreferrer";
-            }
+            applyLinkTarget(props, linkTargetOptions);
             break;
           }
           case "ul":
@@ -360,10 +410,10 @@ var rehypeProcessImages = (options = {}) => {
     });
   };
 };
-function markdownToHtml(markdown, articleSlug) {
+function markdownToHtml(markdown, articleSlug, config) {
   return __async(this, null, function* () {
     try {
-      let processor = (0, import_remark.remark)().use(import_remark_parse.default).use(import_remark_gfm.default).use(import_remark_github_blockquote_alert.default).use(import_remark_rehype.default).use(customRenderer).use(import_rehype_slug.default).use(import_rehype_prism_plus.default).use(import_rehype_sanitize.default, {
+      let processor = (0, import_remark.remark)().use(import_remark_parse.default).use(import_remark_gfm.default).use(import_remark_github_blockquote_alert.default).use(import_remark_rehype.default).use(customRenderer, getLinkTargetOptions(config)).use(import_rehype_slug.default).use(import_rehype_prism_plus.default).use(import_rehype_sanitize.default, {
         attributes: {
           "*": ["className", "class", "id"],
           a: ["href", "target", "rel", "id"],
@@ -539,7 +589,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);
@@ -555,7 +665,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,
@@ -581,36 +692,38 @@ function getArticleSummary(slug) {
     }
   });
 }
-var getArticleMetadata = (0, import_react.cache)((slug) => __async(void 0, null, function* () {
-  try {
-    const summary = yield getArticleSummary(slug);
-    if (!summary) return null;
-    const found = findArticleFile(slug);
-    if (!found) return null;
-    const fileContent = import_node_fs.default.readFileSync(found.filePath, "utf8");
-    const { content: markdownContent } = (0, import_gray_matter.default)(fileContent);
-    const toc = yield extractToc(markdownContent);
-    let htmlContent;
-    let mdxSource;
-    if (found.contentType === "mdx") {
-      mdxSource = markdownContent;
-    } else {
-      htmlContent = yield markdownToHtml(markdownContent, slug);
+var getArticleMetadata = (0, import_react.cache)(
+  (slug, config) => __async(void 0, null, function* () {
+    try {
+      const summary = yield getArticleSummary(slug, config);
+      if (!summary) return null;
+      const found = findArticleFile(slug);
+      if (!found) return null;
+      const fileContent = import_node_fs.default.readFileSync(found.filePath, "utf8");
+      const { content: markdownContent } = (0, import_gray_matter.default)(fileContent);
+      const toc = yield extractToc(markdownContent);
+      let htmlContent;
+      let mdxSource;
+      if (found.contentType === "mdx") {
+        mdxSource = markdownContent;
+      } else {
+        htmlContent = yield markdownToHtml(markdownContent, slug, config);
+      }
+      return __spreadProps(__spreadValues({}, summary), { content: markdownContent, htmlContent, mdxSource, toc });
+    } catch (error) {
+      reportArticlesError({
+        code: "article-load-failed",
+        message: "Unable to load article metadata.",
+        error,
+        context: { slug }
+      });
+      return null;
     }
-    return __spreadProps(__spreadValues({}, summary), { content: markdownContent, htmlContent, mdxSource, toc });
-  } catch (error) {
-    reportArticlesError({
-      code: "article-load-failed",
-      message: "Unable to load article metadata.",
-      error,
-      context: { slug }
-    });
-    return null;
-  }
-}));
-var getAllArticles = (0, import_react.cache)(() => __async(void 0, null, function* () {
+  })
+);
+var getAllArticles = (0, import_react.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;
@@ -700,8 +813,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) => {
@@ -738,16 +851,72 @@ 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) {
+  return str.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&apos;");
+}
+function generateRssFeed(articles, config) {
+  var _a;
+  const siteUrl = config.siteUrl.replace(/\/$/, "");
+  const showAuthor = config.showAuthor !== false;
+  const items = articles.map((article) => {
+    const url = `${siteUrl}/articles/${article.slug}`;
+    const pubDate = article.date ? new Date(article.date).toUTCString() : "";
+    const imageUrl = article.featuredImage ? resolveImageUrl(article.featuredImage, siteUrl) : "";
+    return [
+      "    <item>",
+      `      <title><![CDATA[${article.title}]]></title>`,
+      `      <link>${url}</link>`,
+      `      <guid isPermaLink="true">${url}</guid>`,
+      pubDate ? `      <pubDate>${pubDate}</pubDate>` : "",
+      article.excerpt ? `      <description><![CDATA[${article.excerpt}]]></description>` : "",
+      showAuthor && article.author ? `      <author>${escapeXml(article.author)}</author>` : "",
+      article.category ? `      <category><![CDATA[${article.category}]]></category>` : "",
+      imageUrl ? `      <media:content url="${imageUrl}" medium="image" width="1200" height="630"/>` : "",
+      "    </item>"
+    ].filter(Boolean).join("\n");
+  }).join("\n");
+  const description = (_a = config.description) != null ? _a : `${config.siteName} articles`;
+  return `<?xml version="1.0" encoding="UTF-8" ?>
+<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:media="http://search.yahoo.com/mrss/">
+  <channel>
+    <title><![CDATA[${config.siteName}]]></title>
+    <link>${siteUrl}/articles</link>
+    <description><![CDATA[${description}]]></description>
+    <language>en</language>
+    <atom:link href="${siteUrl}/articles/feed.xml" rel="self" type="application/rss+xml" />
+${items}
+  </channel>
+</rss>`;
+}
 function generateArticleStaticParams() {
   return getAvailableArticleSlugs().map((slug) => ({ slug }));
 }
@@ -757,6 +926,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://")) {
@@ -767,7 +940,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",
@@ -781,6 +954,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,
@@ -793,7 +967,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: {
@@ -820,7 +994,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()
@@ -919,11 +1093,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;
@@ -941,7 +1266,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 [];
     }
@@ -961,18 +1291,18 @@ var import_jsx_runtime = require("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 import_react2.default.createElement("img", __spreadValues({ src: resolvedSrc, alt }, props));
   };
 }
-function renderMdxSource(source, basePath) {
+function renderMdxSource(source, basePath, config) {
   return __async(this, null, function* () {
     const isDevelopment = process.env.NODE_ENV === "development";
     const mdxModule = yield (0, import_mdx.evaluate)(source, __spreadProps(__spreadValues({}, isDevelopment ? devRuntime : runtime), {
       development: isDevelopment,
       remarkPlugins: [import_remark_gfm2.default, import_remark_github_blockquote_alert2.default],
       rehypePlugins: [
-        customRenderer,
+        [customRenderer, { strategy: config == null ? void 0 : config.linkTargetStrategy, siteUrl: config == null ? void 0 : config.siteUrl }],
         import_rehype_slug2.default,
         // @ts-ignore
         import_rehype_prism_plus2.default
@@ -987,9 +1317,9 @@ function renderMdxSource(source, basePath) {
 // src/ArticleContent.tsx
 var import_jsx_runtime2 = require("react/jsx-runtime");
 function ArticleContent(_0) {
-  return __async(this, arguments, function* ({ article, className }) {
+  return __async(this, arguments, function* ({ article, className, config }) {
     if (article.contentType === "mdx" && article.mdxSource) {
-      const content = yield renderMdxSource(article.mdxSource, `/articles/${article.slug}`);
+      const content = yield renderMdxSource(article.mdxSource, `/articles/${article.slug}`, config);
       return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("div", { className, children: content });
     }
     return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("div", { className, dangerouslySetInnerHTML: { __html: article.htmlContent || "" } });
@@ -1023,26 +1353,38 @@ function ArticleTOC({ toc, className }) {
 0 && (module.exports = {
   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,
   sanitizeImagePath,
   searchArticles,
   setArticlesErrorHandler