@sonordev/site-kit 3.0.2 → 3.0.3

package/dist/blog/index.d.mts

@@ -1,8 +1,8 @@
 export { BlogList, BlogListServerProps, BlogListStyles, BlogPost, BlogPostServerProps, BlogPostStyles, ClusterLandingPage, ClusterLandingPageProps, ClusterNavigation, ClusterNavigationProps } from './server-ui.mjs';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import React__default from 'react';
-import { A as AuthorCardProps, c as AuthorPageProps, B as BlogPost, d as TableOfContentsProps } from '../types-5P5B9RgV.mjs';
-export { m as BlogAnalytics, a as BlogAuthor, b as BlogCategory, f as BlogListOptions, j as BlogListProps, k as BlogListRenderProps, g as BlogListResult, h as BlogPostProps, i as BlogPostRenderProps, e as BlogTag, R as RelatedPostsProps, l as TocItem, T as TopicCluster } from '../types-5P5B9RgV.mjs';
+import { A as AuthorCardProps, c as AuthorPageProps, B as BlogPost, d as TableOfContentsProps } from '../types-DYOumpUT.mjs';
+export { m as BlogAnalytics, a as BlogAuthor, b as BlogCategory, f as BlogListOptions, j as BlogListProps, k as BlogListRenderProps, g as BlogListResult, h as BlogPostProps, i as BlogPostRenderProps, e as BlogTag, R as RelatedPostsProps, l as TocItem, T as TopicCluster } from '../types-DYOumpUT.mjs';
 
 interface BlogSidebarProps {
     /** Portal API URL */

package/dist/blog/index.d.ts

@@ -1,8 +1,8 @@
 export { BlogList, BlogListServerProps, BlogListStyles, BlogPost, BlogPostServerProps, BlogPostStyles, ClusterLandingPage, ClusterLandingPageProps, ClusterNavigation, ClusterNavigationProps } from './server-ui.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import React__default from 'react';
-import { A as AuthorCardProps, c as AuthorPageProps, B as BlogPost, d as TableOfContentsProps } from '../types-5P5B9RgV.js';
-export { m as BlogAnalytics, a as BlogAuthor, b as BlogCategory, f as BlogListOptions, j as BlogListProps, k as BlogListRenderProps, g as BlogListResult, h as BlogPostProps, i as BlogPostRenderProps, e as BlogTag, R as RelatedPostsProps, l as TocItem, T as TopicCluster } from '../types-5P5B9RgV.js';
+import { A as AuthorCardProps, c as AuthorPageProps, B as BlogPost, d as TableOfContentsProps } from '../types-DYOumpUT.js';
+export { m as BlogAnalytics, a as BlogAuthor, b as BlogCategory, f as BlogListOptions, j as BlogListProps, k as BlogListRenderProps, g as BlogListResult, h as BlogPostProps, i as BlogPostRenderProps, e as BlogTag, R as RelatedPostsProps, l as TocItem, T as TopicCluster } from '../types-DYOumpUT.js';
 
 interface BlogSidebarProps {
     /** Portal API URL */

package/dist/blog/index.js

@@ -2,7 +2,7 @@
 'use strict';
 
 var chunkUJQYSVYV_js = require('../chunk-UJQYSVYV.js');
-var chunkPBF2H23N_js = require('../chunk-PBF2H23N.js');
+var chunkI5TJIESQ_js = require('../chunk-I5TJIESQ.js');
 var chunkIB4FRJDV_js = require('../chunk-IB4FRJDV.js');
 var chunkJ7QI3GDX_js = require('../chunk-J7QI3GDX.js');
 require('../chunk-ZSMWDLMK.js');
@@ -884,39 +884,39 @@ Object.defineProperty(exports, "BlogFAQ", {
 });
 Object.defineProperty(exports, "BlogList", {
   enumerable: true,
-  get: function () { return chunkPBF2H23N_js.BlogList; }
+  get: function () { return chunkI5TJIESQ_js.BlogList; }
 });
 Object.defineProperty(exports, "BlogPost", {
   enumerable: true,
-  get: function () { return chunkPBF2H23N_js.BlogPost; }
+  get: function () { return chunkI5TJIESQ_js.BlogPost; }
 });
 Object.defineProperty(exports, "ClusterLandingPage", {
   enumerable: true,
-  get: function () { return chunkPBF2H23N_js.ClusterLandingPage; }
+  get: function () { return chunkI5TJIESQ_js.ClusterLandingPage; }
 });
 Object.defineProperty(exports, "ClusterNavigation", {
   enumerable: true,
-  get: function () { return chunkPBF2H23N_js.ClusterNavigation; }
+  get: function () { return chunkI5TJIESQ_js.ClusterNavigation; }
 });
 Object.defineProperty(exports, "ServiceCallout", {
   enumerable: true,
-  get: function () { return chunkPBF2H23N_js.ServiceCallout; }
+  get: function () { return chunkI5TJIESQ_js.ServiceCallout; }
 });
 Object.defineProperty(exports, "ServiceCallouts", {
   enumerable: true,
-  get: function () { return chunkPBF2H23N_js.ServiceCallouts; }
+  get: function () { return chunkI5TJIESQ_js.ServiceCallouts; }
 });
 Object.defineProperty(exports, "addExternalLinkTargets", {
   enumerable: true,
-  get: function () { return chunkPBF2H23N_js.addExternalLinkTargets; }
+  get: function () { return chunkI5TJIESQ_js.addExternalLinkTargets; }
 });
 Object.defineProperty(exports, "normalizeSiteHost", {
   enumerable: true,
-  get: function () { return chunkPBF2H23N_js.normalizeSiteHost; }
+  get: function () { return chunkI5TJIESQ_js.normalizeSiteHost; }
 });
 Object.defineProperty(exports, "resolveBlogSiteUrl", {
   enumerable: true,
-  get: function () { return chunkPBF2H23N_js.resolveBlogSiteUrl; }
+  get: function () { return chunkI5TJIESQ_js.resolveBlogSiteUrl; }
 });
 exports.AuthorCard = AuthorCard;
 exports.AuthorPage = AuthorPage;

package/dist/blog/index.mjs

@@ -1,6 +1,6 @@
 'use client';
 export { BlogFAQ } from '../chunk-PST3NOEM.mjs';
-export { BlogList, BlogPost, ClusterLandingPage, ClusterNavigation, ServiceCallout, ServiceCallouts, addExternalLinkTargets, normalizeSiteHost, resolveBlogSiteUrl } from '../chunk-EKJOYPPV.mjs';
+export { BlogList, BlogPost, ClusterLandingPage, ClusterNavigation, ServiceCallout, ServiceCallouts, addExternalLinkTargets, normalizeSiteHost, resolveBlogSiteUrl } from '../chunk-FT5JNCD4.mjs';
 import { generateAuthorSchema } from '../chunk-SH4VZDVX.mjs';
 import { safeJsonLd } from '../chunk-662YHKWW.mjs';
 import '../chunk-4XPGGLVP.mjs';

package/dist/blog/server-ui.d.mts

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import React__default from 'react';
-import { B as BlogPost$1, l as TocItem, g as BlogListResult, b as BlogCategory, C as ClusterNavigation$1, T as TopicCluster } from '../types-5P5B9RgV.mjs';
+import { B as BlogPost$1, l as TocItem, g as BlogListResult, b as BlogCategory, C as ClusterNavigation$1, T as TopicCluster } from '../types-DYOumpUT.mjs';
 
 interface BlogPostStyles {
     article?: string;
@@ -113,20 +113,34 @@ interface ClusterNavigationProps {
     navigation: ClusterNavigation$1;
     /** Base path for blog URLs (default: /blog) */
     basePath?: string;
-    /** Category slug for URL building (optional) */
+    /**
+     * Fallback category slug for URL building (optional). Each linked article's
+     * OWN category takes precedence when present — applying one category to
+     * every sibling produced wrong-category URLs (duplicate content / redirect
+     * chains) on category-segmented sites whenever a cluster spans categories.
+     */
     category?: string;
+    /** Append a trailing slash to article URLs (only for trailingSlash sites) */
+    trailingSlash?: boolean;
     /** Disable default styles */
     unstyled?: boolean;
     /** Custom class name */
     className?: string;
 }
-declare function ClusterNavigation({ navigation, basePath, category, unstyled, className, }: ClusterNavigationProps): react_jsx_runtime.JSX.Element | null;
+declare function ClusterNavigation({ navigation, basePath, category, trailingSlash, unstyled, className, }: ClusterNavigationProps): react_jsx_runtime.JSX.Element | null;
 
 interface ClusterLandingPageProps {
     /** Cluster slug to fetch */
     slug: string;
     /** Base path for blog URLs (default: /blog) */
     basePath?: string;
+    /**
+     * Include each article's own category segment in its URL:
+     * {basePath}/{category}/{slug}. Enable on sites whose blog routes are
+     * category-segmented (e.g. upforge.io /insights/{category}/{slug}) —
+     * without it, links point at {basePath}/{slug} and 404 on such sites.
+     */
+    categoryInPath?: boolean;
     /** Disable default styles */
     unstyled?: boolean;
     /** Custom class name */
@@ -136,6 +150,6 @@ interface ClusterLandingPageProps {
         cluster: TopicCluster;
     }) => React__default.ReactNode;
 }
-declare function ClusterLandingPage({ slug, basePath, unstyled, className, children, }: ClusterLandingPageProps): Promise<string | number | bigint | boolean | Iterable<React__default.ReactNode> | react_jsx_runtime.JSX.Element | null | undefined>;
+declare function ClusterLandingPage({ slug, basePath, categoryInPath, unstyled, className, children, }: ClusterLandingPageProps): Promise<string | number | bigint | boolean | Iterable<React__default.ReactNode> | react_jsx_runtime.JSX.Element | null | undefined>;
 
 export { BlogList, type BlogListServerProps, type BlogListStyles, BlogPost, type BlogPostServerProps, type BlogPostStyles, ClusterLandingPage, type ClusterLandingPageProps, ClusterNavigation, type ClusterNavigationProps };

package/dist/blog/server-ui.d.ts

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import React__default from 'react';
-import { B as BlogPost$1, l as TocItem, g as BlogListResult, b as BlogCategory, C as ClusterNavigation$1, T as TopicCluster } from '../types-5P5B9RgV.js';
+import { B as BlogPost$1, l as TocItem, g as BlogListResult, b as BlogCategory, C as ClusterNavigation$1, T as TopicCluster } from '../types-DYOumpUT.js';
 
 interface BlogPostStyles {
     article?: string;
@@ -113,20 +113,34 @@ interface ClusterNavigationProps {
     navigation: ClusterNavigation$1;
     /** Base path for blog URLs (default: /blog) */
     basePath?: string;
-    /** Category slug for URL building (optional) */
+    /**
+     * Fallback category slug for URL building (optional). Each linked article's
+     * OWN category takes precedence when present — applying one category to
+     * every sibling produced wrong-category URLs (duplicate content / redirect
+     * chains) on category-segmented sites whenever a cluster spans categories.
+     */
     category?: string;
+    /** Append a trailing slash to article URLs (only for trailingSlash sites) */
+    trailingSlash?: boolean;
     /** Disable default styles */
     unstyled?: boolean;
     /** Custom class name */
     className?: string;
 }
-declare function ClusterNavigation({ navigation, basePath, category, unstyled, className, }: ClusterNavigationProps): react_jsx_runtime.JSX.Element | null;
+declare function ClusterNavigation({ navigation, basePath, category, trailingSlash, unstyled, className, }: ClusterNavigationProps): react_jsx_runtime.JSX.Element | null;
 
 interface ClusterLandingPageProps {
     /** Cluster slug to fetch */
     slug: string;
     /** Base path for blog URLs (default: /blog) */
     basePath?: string;
+    /**
+     * Include each article's own category segment in its URL:
+     * {basePath}/{category}/{slug}. Enable on sites whose blog routes are
+     * category-segmented (e.g. upforge.io /insights/{category}/{slug}) —
+     * without it, links point at {basePath}/{slug} and 404 on such sites.
+     */
+    categoryInPath?: boolean;
     /** Disable default styles */
     unstyled?: boolean;
     /** Custom class name */
@@ -136,6 +150,6 @@ interface ClusterLandingPageProps {
         cluster: TopicCluster;
     }) => React__default.ReactNode;
 }
-declare function ClusterLandingPage({ slug, basePath, unstyled, className, children, }: ClusterLandingPageProps): Promise<string | number | bigint | boolean | Iterable<React__default.ReactNode> | react_jsx_runtime.JSX.Element | null | undefined>;
+declare function ClusterLandingPage({ slug, basePath, categoryInPath, unstyled, className, children, }: ClusterLandingPageProps): Promise<string | number | bigint | boolean | Iterable<React__default.ReactNode> | react_jsx_runtime.JSX.Element | null | undefined>;
 
 export { BlogList, type BlogListServerProps, type BlogListStyles, BlogPost, type BlogPostServerProps, type BlogPostStyles, ClusterLandingPage, type ClusterLandingPageProps, ClusterNavigation, type ClusterNavigationProps };

package/dist/blog/server-ui.js

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkPBF2H23N_js = require('../chunk-PBF2H23N.js');
+var chunkI5TJIESQ_js = require('../chunk-I5TJIESQ.js');
 require('../chunk-IB4FRJDV.js');
 require('../chunk-ZSMWDLMK.js');
 
@@ -8,19 +8,19 @@ require('../chunk-ZSMWDLMK.js');
 
 Object.defineProperty(exports, "BlogList", {
   enumerable: true,
-  get: function () { return chunkPBF2H23N_js.BlogList; }
+  get: function () { return chunkI5TJIESQ_js.BlogList; }
 });
 Object.defineProperty(exports, "BlogPost", {
   enumerable: true,
-  get: function () { return chunkPBF2H23N_js.BlogPost; }
+  get: function () { return chunkI5TJIESQ_js.BlogPost; }
 });
 Object.defineProperty(exports, "ClusterLandingPage", {
   enumerable: true,
-  get: function () { return chunkPBF2H23N_js.ClusterLandingPage; }
+  get: function () { return chunkI5TJIESQ_js.ClusterLandingPage; }
 });
 Object.defineProperty(exports, "ClusterNavigation", {
   enumerable: true,
-  get: function () { return chunkPBF2H23N_js.ClusterNavigation; }
+  get: function () { return chunkI5TJIESQ_js.ClusterNavigation; }
 });
 //# sourceMappingURL=server-ui.js.map
 //# sourceMappingURL=server-ui.js.map

package/dist/blog/server-ui.mjs

@@ -1,4 +1,4 @@
-export { BlogList, BlogPost, ClusterLandingPage, ClusterNavigation } from '../chunk-EKJOYPPV.mjs';
+export { BlogList, BlogPost, ClusterLandingPage, ClusterNavigation } from '../chunk-FT5JNCD4.mjs';
 import '../chunk-SH4VZDVX.mjs';
 import '../chunk-4XPGGLVP.mjs';
 //# sourceMappingURL=server-ui.mjs.map

package/dist/blog/server.d.mts

@@ -1,5 +1,5 @@
 import { Metadata } from 'next';
-import { B as BlogPost, T as TopicCluster, C as ClusterNavigation, a as BlogAuthor } from '../types-5P5B9RgV.mjs';
+import { B as BlogPost, T as TopicCluster, C as ClusterNavigation, a as BlogAuthor } from '../types-DYOumpUT.mjs';
 
 /**
  * @sonordev/site-kit/blog/server

package/dist/blog/server.d.ts

@@ -1,5 +1,5 @@
 import { Metadata } from 'next';
-import { B as BlogPost, T as TopicCluster, C as ClusterNavigation, a as BlogAuthor } from '../types-5P5B9RgV.js';
+import { B as BlogPost, T as TopicCluster, C as ClusterNavigation, a as BlogAuthor } from '../types-DYOumpUT.js';
 
 /**
  * @sonordev/site-kit/blog/server

package/dist/{chunk-EKJOYPPV.mjs → chunk-FT5JNCD4.mjs}

@@ -289,6 +289,7 @@ function ClusterNavigation({
   navigation,
   basePath = "/blog",
   category,
+  trailingSlash = false,
   unstyled = false,
   className
 }) {
@@ -299,19 +300,23 @@ function ClusterNavigation({
   const hasPillarLink = !navigation.is_pillar && navigation.pillar;
   const hasSiblings = siblings.length > 0;
   if (!hasPillarLink && !hasSiblings) return null;
-  const articleUrl = (slug) => category ? `${basePath}/${category}/${slug}/` : `${basePath}/${slug}/`;
+  const articleUrl = (article) => {
+    const cat = article.category || category;
+    const path = cat ? `${basePath}/${cat}/${article.slug}` : `${basePath}/${article.slug}`;
+    return trailingSlash ? `${path}/` : path;
+  };
   return /* @__PURE__ */ jsxs(Fragment, { children: [
     !unstyled && /* @__PURE__ */ jsx("style", { dangerouslySetInnerHTML: { __html: clusterNavCss } }),
     /* @__PURE__ */ jsxs("nav", { className: `${unstyled ? "" : "sk-cluster-nav"} ${className || ""}`, children: [
       hasPillarLink && navigation.pillar && /* @__PURE__ */ jsxs("div", { className: unstyled ? "" : "sk-cluster-pillar-link", children: [
         /* @__PURE__ */ jsx("p", { className: unstyled ? "" : "sk-cluster-pillar-link-label", children: "Full Guide" }),
-        /* @__PURE__ */ jsx("a", { href: articleUrl(navigation.pillar.slug), children: navigation.pillar.title })
+        /* @__PURE__ */ jsx("a", { href: articleUrl(navigation.pillar), children: navigation.pillar.title })
       ] }),
       hasSiblings && /* @__PURE__ */ jsxs("div", { children: [
         /* @__PURE__ */ jsx("p", { className: unstyled ? "" : "sk-cluster-siblings-title", children: navigation.is_pillar ? "Deep Dives" : "More in This Series" }),
         /* @__PURE__ */ jsx("ul", { className: unstyled ? "" : "sk-cluster-siblings-list", children: siblings.map((sibling) => /* @__PURE__ */ jsxs("li", { className: unstyled ? "" : "sk-cluster-siblings-item", children: [
           /* @__PURE__ */ jsx("span", { className: unstyled ? "" : "sk-cluster-type-badge", children: sibling.article_type }),
-          /* @__PURE__ */ jsx("a", { href: articleUrl(sibling.slug), children: sibling.title })
+          /* @__PURE__ */ jsx("a", { href: articleUrl(sibling), children: sibling.title })
         ] }, sibling.slug)) })
       ] })
     ] })
@@ -1538,9 +1543,16 @@ var clusterLandingCss = `
   font-size: 0.75rem; color: #9ca3af;
 }
 `;
+function categorySlugOf(post) {
+  const c = post?.category;
+  if (!c) return null;
+  if (typeof c === "string") return c;
+  return c.slug || null;
+}
 async function ClusterLandingPage({
   slug,
   basePath = "/blog",
+  categoryInPath = false,
   unstyled = false,
   className,
   children
@@ -1554,6 +1566,10 @@ async function ClusterLandingPage({
   }
   const pillar = cluster.pillar;
   const supports = cluster.supports || [];
+  const articleUrl = (post) => {
+    const cat = categoryInPath ? categorySlugOf(post) : null;
+    return cat ? `${basePath}/${cat}/${post.slug}` : `${basePath}/${post.slug}`;
+  };
   return /* @__PURE__ */ jsxs(Fragment, { children: [
     !unstyled && /* @__PURE__ */ jsx("style", { dangerouslySetInnerHTML: { __html: clusterLandingCss } }),
     /* @__PURE__ */ jsxs("div", { className: `${unstyled ? "" : "sk-cluster-landing"} ${className || ""}`, children: [
@@ -1572,7 +1588,7 @@ async function ClusterLandingPage({
           cluster.geo_target && /* @__PURE__ */ jsx("span", { children: cluster.geo_target })
         ] })
       ] }),
-      pillar && /* @__PURE__ */ jsxs("a", { href: `${basePath}/${pillar.slug}`, className: unstyled ? "" : "sk-cluster-pillar-card", children: [
+      pillar && /* @__PURE__ */ jsxs("a", { href: articleUrl(pillar), className: unstyled ? "" : "sk-cluster-pillar-card", children: [
         /* @__PURE__ */ jsx("span", { className: unstyled ? "" : "sk-cluster-pillar-label", children: "Pillar Guide" }),
         /* @__PURE__ */ jsx("h2", { className: unstyled ? "" : "sk-cluster-pillar-title", children: pillar.title }),
         pillar.excerpt && /* @__PURE__ */ jsx("p", { className: unstyled ? "" : "sk-cluster-pillar-excerpt", children: pillar.excerpt }),
@@ -1592,7 +1608,7 @@ async function ClusterLandingPage({
         /* @__PURE__ */ jsx("div", { className: unstyled ? "" : "sk-cluster-supports-grid", children: supports.map((post) => /* @__PURE__ */ jsxs(
           "a",
           {
-            href: `${basePath}/${post.slug}`,
+            href: articleUrl(post),
             className: unstyled ? "" : "sk-cluster-support-card",
             children: [
               /* @__PURE__ */ jsxs("div", { className: unstyled ? "" : "sk-cluster-support-card-header", children: [
@@ -1618,5 +1634,5 @@ async function ClusterLandingPage({
 }
 
 export { BlogList, BlogPost, ClusterLandingPage, ClusterNavigation, ServiceCallout, ServiceCallouts, addExternalLinkTargets, normalizeSiteHost, resolveBlogSiteUrl };
-//# sourceMappingURL=chunk-EKJOYPPV.mjs.map
-//# sourceMappingURL=chunk-EKJOYPPV.mjs.map
+//# sourceMappingURL=chunk-FT5JNCD4.mjs.map
+//# sourceMappingURL=chunk-FT5JNCD4.mjs.map