@fullstackdatasolutions/articles 1.0.0 → 1.2.0

package/CHANGELOG.md

@@ -5,6 +5,26 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.2.0] - 2026-08-12
+
+### Added
+
+- **`Breadcrumb` accepts `containerClassName`.** New optional prop, default `'max-w-7xl'` (unchanged from before), applied to the breadcrumb `<ol>` in place of the previously hardcoded value. Lets a consuming site align the breadcrumb bar's content width to its own reading column instead of the package's fixed default. Found on theroleplayersguild.com, where the breadcrumb's `max-w-7xl` sat visibly wider than the article body's `max-w-3xl` column beneath it.
+
+### Fixed
+
+- **`ArticleDetailHero` byline never rendered the configured author avatar.** It always showed a generic user icon even when a single `authors[]` entry had a real `avatar` set (and even though `RelatedArticlesSection`/`ArticleCard` byline avatars worked correctly from the same data). Now resolves and renders the avatar image for the single-author case, matching the existing `ArticleCard` pattern; falls back to the icon when no avatar is set or multiple authors are configured, so existing output is unchanged unless a consumer already had `authors[].avatar` configured.
+
+## [1.1.0] - 2026-08-09
+
+### Added
+
+- **Configurable heading font family.** New `ArticlesTheme.headerFontFamily`, optional and falling back to inherit/nothing when unset - existing consumers who don't set it see byte-identical output. Threaded through `ArticleDetailHero` (new optional `config` prop), `RelatedArticlesSection`, and `ArticleCard` (both already accepted `config`) via inline `style={{ fontFamily: config?.theme?.headerFontFamily }}`, and into `ArticlesPage`'s `buildThemeVars` as `--articles-header-font-family`, consistent with the package's existing CSS-var theming pattern. Lets a site use a distinct display face for headings (e.g. a serif) separate from its body `fontFamily`, without hardcoding either into the package. Found auditing theroleplayersguild.com's article pages, which use a serif heading treatment the package couldn't previously express.
+
+### Fixed
+
+- **`ArticleCard` hardcoded an indigo hover color.** The title link's `hover:text-indigo-600` was a stray leftover unrelated to any theme token and would visibly clash with any site not using an indigo-ish primary color. Replaced with `hover:text-primary`, matching the token already used elsewhere in the same component.
+
 ## [1.0.0] - 2026-08-05
 
 ### Breaking

package/README.md

@@ -194,6 +194,7 @@ export default async function Page({ params }: ArticlePageProps) {
         article={article}
         authors={authors}
         categoryBasePath="/articles/category"
+        config={siteConfig}
       />
       <ArticleViewTracker article={article} config={siteConfig} />
       {siteConfig.showToc !== false && article.toc && article.toc.length > 0 && (
@@ -580,17 +581,18 @@ All theme values are applied as CSS custom properties on a wrapper `<div>`. Comp
 
 ```ts
 theme: {
-  fontFamily:      "'Inter', sans-serif",
-  headerColor:     '#111827',
-  textColor:       '#6b7280',
-  backgroundColor: '#ffffff',
-  linkColor:       '#4f46e5',
-  linkHoverColor:  '#4338ca',
-  borderRadius:    '0.5rem',
+  fontFamily:       "'Inter', sans-serif",
+  headerFontFamily: "'Cinzel', serif",
+  headerColor:      '#111827',
+  textColor:        '#6b7280',
+  backgroundColor:  '#ffffff',
+  linkColor:        '#4f46e5',
+  linkHoverColor:   '#4338ca',
+  borderRadius:     '0.5rem',
 }
 ```
 
-All fields are optional. Omitted fields fall back to your Tailwind theme tokens.
+All fields are optional. Omitted fields fall back to your Tailwind theme tokens. `headerFontFamily` styles article titles and card/section headings (`ArticleDetailHero`, `RelatedArticlesSection`, `ArticleCard`) separately from body text; omit it to let headings inherit `fontFamily` like everything else.
 
 ---
 

package/dist/index.cjs

@@ -265,6 +265,7 @@ function getDisplayItems(items) {
 function Breadcrumb({
   items,
   className = "",
+  containerClassName = "max-w-7xl",
   showSchema = true,
   separator = ">"
 }) {
@@ -276,7 +277,7 @@ function Breadcrumb({
       {
         "aria-label": "Breadcrumb",
         className: `border-b border-border bg-background/80 px-4 py-3 text-sm text-muted-foreground ${className}`,
-        children: /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("ol", { className: "mx-auto flex max-w-7xl items-center gap-2 overflow-hidden", children: displayItems.map((item, index) => {
+        children: /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("ol", { className: `mx-auto flex items-center gap-2 overflow-hidden ${containerClassName}`, children: displayItems.map((item, index) => {
           const isLast = index === displayItems.length - 1;
           const key = `${item.name}-${index}`;
           return /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("li", { className: "flex min-w-0 items-center gap-2", children: [
@@ -650,6 +651,7 @@ function emitArticleEvent(handler, event) {
 // src/ArticleCard.tsx
 var import_jsx_runtime8 = require("react/jsx-runtime");
 function ArticleCard({ article, config }) {
+  var _a;
   return /* @__PURE__ */ (0, import_jsx_runtime8.jsxs)("div", { className: "rounded-lg border border-border bg-card text-card-foreground shadow-sm hover:shadow-lg transition-shadow duration-300", children: [
     /* @__PURE__ */ (0, import_jsx_runtime8.jsx)("div", { className: "p-0", children: /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(
       import_image4.default,
@@ -663,14 +665,14 @@ function ArticleCard({ article, config }) {
     ) }),
     /* @__PURE__ */ (0, import_jsx_runtime8.jsxs)("div", { className: "p-6", children: [
       /* @__PURE__ */ (0, import_jsx_runtime8.jsx)("div", { className: "flex gap-2 mb-3", children: /* @__PURE__ */ (0, import_jsx_runtime8.jsx)("span", { className: "bg-primary/10 text-primary text-xs font-medium px-2 py-1 rounded", children: article.category }) }),
-      /* @__PURE__ */ (0, import_jsx_runtime8.jsx)("h3", { className: "text-lg font-semibold leading-none tracking-tight mb-2", children: /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(
-        import_link6.default,
+      /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(
+        "h3",
         {
-          href: `/articles/${article.slug}`,
-          className: "hover:text-indigo-600 transition-colors",
-          children: article.title
+          className: "text-lg font-semibold leading-none tracking-tight mb-2",
+          style: { fontFamily: (_a = config == null ? void 0 : config.theme) == null ? void 0 : _a.headerFontFamily },
+          children: /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(import_link6.default, { href: `/articles/${article.slug}`, className: "hover:text-primary transition-colors", children: article.title })
         }
-      ) }),
+      ),
       /* @__PURE__ */ (0, import_jsx_runtime8.jsx)("p", { className: "text-muted-foreground mb-4 line-clamp-3", children: article.excerpt }),
       article.authorSlug && /* @__PURE__ */ (0, import_jsx_runtime8.jsxs)(
         import_link6.default,
@@ -993,6 +995,7 @@ function buildThemeVars(theme) {
   if (!theme) return {};
   const vars = {};
   if (theme.fontFamily) vars["--articles-font-family"] = theme.fontFamily;
+  if (theme.headerFontFamily) vars["--articles-header-font-family"] = theme.headerFontFamily;
   if (theme.headerColor) vars["--articles-header-color"] = theme.headerColor;
   if (theme.textColor) vars["--articles-text-color"] = theme.textColor;
   if (theme.backgroundColor) vars["--articles-bg-color"] = theme.backgroundColor;
@@ -1153,13 +1156,24 @@ var import_jsx_runtime13 = require("react/jsx-runtime");
 function toSlug(cat) {
   return cat.toLowerCase().replaceAll(/\s+/g, "-").replaceAll(/[^a-z0-9-]/g, "");
 }
+function resolveAvatarUrl(author, config) {
+  if (!author.avatar) return null;
+  if (author.avatar.startsWith("http://") || author.avatar.startsWith("https://")) {
+    return author.avatar;
+  }
+  if (!(config == null ? void 0 : config.siteUrl)) return null;
+  const siteUrl = config.siteUrl.replace(/\/$/, "");
+  return `${siteUrl}/articles/authors/${author.slug}/${author.avatar.replace(/^\/+/, "")}`;
+}
 function ArticleDetailHero({
   article,
   categoryBasePath = "/articles/category",
   showDate = false,
   showAuthor = true,
-  authors = []
+  authors = [],
+  config
 }) {
+  var _a;
   const showConfiguredAuthors = showAuthor && authors.length > 0;
   const showLegacyAuthor = showAuthor && authors.length === 0 && article.author.trim().length > 0;
   return /* @__PURE__ */ (0, import_jsx_runtime13.jsxs)(
@@ -1240,7 +1254,14 @@ function ArticleDetailHero({
                   )
                 }
               ),
-              /* @__PURE__ */ (0, import_jsx_runtime13.jsx)("h1", { className: "text-4xl md:text-5xl font-bold mb-4", children: article.title }),
+              /* @__PURE__ */ (0, import_jsx_runtime13.jsx)(
+                "h1",
+                {
+                  className: "text-4xl md:text-5xl font-bold mb-4",
+                  style: { fontFamily: (_a = config == null ? void 0 : config.theme) == null ? void 0 : _a.headerFontFamily },
+                  children: article.title
+                }
+              ),
               /* @__PURE__ */ (0, import_jsx_runtime13.jsxs)(
                 "div",
                 {
@@ -1261,24 +1282,36 @@ function ArticleDetailHero({
                       /* @__PURE__ */ (0, import_jsx_runtime13.jsx)(import_lucide_react7.Clock, { className: "h-4 w-4" }),
                       /* @__PURE__ */ (0, import_jsx_runtime13.jsx)("span", { children: article.readTime })
                     ] }),
-                    showConfiguredAuthors && /* @__PURE__ */ (0, import_jsx_runtime13.jsxs)("div", { style: { display: "flex", alignItems: "center", gap: "0.5rem" }, children: [
-                      /* @__PURE__ */ (0, import_jsx_runtime13.jsx)(import_lucide_react7.User, { className: "h-4 w-4" }),
-                      /* @__PURE__ */ (0, import_jsx_runtime13.jsxs)("span", { children: [
-                        "By",
-                        " ",
-                        authors.map((author, index) => /* @__PURE__ */ (0, import_jsx_runtime13.jsxs)(import_react4.Fragment, { children: [
-                          index > 0 && ", ",
-                          /* @__PURE__ */ (0, import_jsx_runtime13.jsx)(
-                            import_link8.default,
-                            {
-                              href: `/articles/authors/${author.slug}`,
-                              className: "font-medium text-white underline-offset-4 hover:underline",
-                              children: author.name
-                            }
-                          )
-                        ] }, author.slug))
-                      ] })
-                    ] }),
+                    showConfiguredAuthors && (() => {
+                      const singleAvatarUrl = authors.length === 1 ? resolveAvatarUrl(authors[0], config) : null;
+                      return /* @__PURE__ */ (0, import_jsx_runtime13.jsxs)("div", { style: { display: "flex", alignItems: "center", gap: "0.5rem" }, children: [
+                        singleAvatarUrl ? /* @__PURE__ */ (0, import_jsx_runtime13.jsx)(
+                          import_image5.default,
+                          {
+                            src: singleAvatarUrl,
+                            alt: "",
+                            width: 20,
+                            height: 20,
+                            className: "h-5 w-5 rounded-full object-cover"
+                          }
+                        ) : /* @__PURE__ */ (0, import_jsx_runtime13.jsx)(import_lucide_react7.User, { className: "h-4 w-4" }),
+                        /* @__PURE__ */ (0, import_jsx_runtime13.jsxs)("span", { children: [
+                          "By",
+                          " ",
+                          authors.map((author, index) => /* @__PURE__ */ (0, import_jsx_runtime13.jsxs)(import_react4.Fragment, { children: [
+                            index > 0 && ", ",
+                            /* @__PURE__ */ (0, import_jsx_runtime13.jsx)(
+                              import_link8.default,
+                              {
+                                href: `/articles/authors/${author.slug}`,
+                                className: "font-medium text-white underline-offset-4 hover:underline",
+                                children: author.name
+                              }
+                            )
+                          ] }, author.slug))
+                        ] })
+                      ] });
+                    })(),
                     showLegacyAuthor && /* @__PURE__ */ (0, import_jsx_runtime13.jsxs)("div", { style: { display: "flex", alignItems: "center", gap: "0.5rem" }, children: [
                       /* @__PURE__ */ (0, import_jsx_runtime13.jsx)(import_lucide_react7.User, { className: "h-4 w-4" }),
                       /* @__PURE__ */ (0, import_jsx_runtime13.jsxs)("span", { children: [
@@ -2006,9 +2039,17 @@ function RelatedArticlesSection({
   fromSlug,
   source = "category"
 }) {
+  var _a;
   if (articles.length === 0) return null;
   return /* @__PURE__ */ (0, import_jsx_runtime21.jsxs)("section", { className: "mt-12 pt-8 border-t border-border", "aria-label": "Related articles", children: [
-    /* @__PURE__ */ (0, import_jsx_runtime21.jsx)("h2", { className: "text-xl font-semibold text-foreground mb-6", children: heading != null ? heading : `More in ${category}` }),
+    /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(
+      "h2",
+      {
+        className: "text-xl font-semibold text-foreground mb-6",
+        style: { fontFamily: (_a = config == null ? void 0 : config.theme) == null ? void 0 : _a.headerFontFamily },
+        children: heading != null ? heading : `More in ${category}`
+      }
+    ),
     /* @__PURE__ */ (0, import_jsx_runtime21.jsx)("div", { className: "grid gap-6 sm:grid-cols-2 lg:grid-cols-3", children: articles.map((article) => /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(
       "div",
       {