@sonordev/site-kit 2.2.9 → 2.5.0

package/dist/blog/index.d.mts

@@ -1,8 +1,8 @@
 export { BlogList, BlogListServerProps, BlogListStyles, BlogPost, BlogPostServerProps, BlogPostStyles } 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, T as TableOfContentsProps } from '../types-DWMpAtGy.mjs';
-export { l as BlogAnalytics, a as BlogAuthor, b as BlogCategory, e as BlogListOptions, i as BlogListProps, j as BlogListRenderProps, f as BlogListResult, g as BlogPostProps, h as BlogPostRenderProps, d as BlogTag, R as RelatedPostsProps, k as TocItem } from '../types-DWMpAtGy.mjs';
+import { A as AuthorCardProps, c as AuthorPageProps, B as BlogPost, d as TableOfContentsProps, C as ClusterNavigation$1, T as TopicCluster } 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 } from '../types-5P5B9RgV.mjs';
 
 interface BlogSidebarProps {
     /** Portal API URL */
@@ -206,6 +206,34 @@ interface BlogFAQProps {
 }
 declare function BlogFAQ({ items, title, allowMultiple, styles, unstyled, }: BlogFAQProps): react_jsx_runtime.JSX.Element | null;
 
+interface ClusterNavigationProps {
+    /** Cluster navigation data (from getClusterNavigation) */
+    navigation: ClusterNavigation$1;
+    /** Base path for blog URLs (default: /blog) */
+    basePath?: string;
+    /** Disable default styles */
+    unstyled?: boolean;
+    /** Custom class name */
+    className?: string;
+}
+declare function ClusterNavigation({ navigation, basePath, 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;
+    /** Disable default styles */
+    unstyled?: boolean;
+    /** Custom class name */
+    className?: string;
+    /** Render prop for full data access */
+    children?: (props: {
+        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>;
+
 /**
  * Post-process Portal/blog HTML for safe, consistent link behavior.
  * Server-safe string transforms only (no DOM).
@@ -224,4 +252,4 @@ declare function resolveBlogSiteUrl(explicit?: string): string;
  */
 declare function addExternalLinkTargets(html: string, siteUrl: string): string;
 
-export { AuthorCard, AuthorCardProps, AuthorPage, AuthorPageProps, BlogFAQ, type BlogFAQProps, BlogLayout, type BlogLayoutProps, BlogPage, type BlogPageProps, BlogPostPage, type BlogPostPageProps, BlogSidebar, type BlogSidebarProps, CategoryPage, type CategoryPageProps, type FaqItem, NewsletterWidget, type NewsletterWidgetProps, RelatedPosts, ServiceCallout, type ServiceCalloutProps, ServiceCallouts, TableOfContents, TableOfContentsProps, addExternalLinkTargets, normalizeSiteHost, resolveBlogSiteUrl };
+export { AuthorCard, AuthorCardProps, AuthorPage, AuthorPageProps, BlogFAQ, type BlogFAQProps, BlogLayout, type BlogLayoutProps, BlogPage, type BlogPageProps, BlogPostPage, type BlogPostPageProps, BlogSidebar, type BlogSidebarProps, CategoryPage, type CategoryPageProps, ClusterLandingPage, type ClusterLandingPageProps, ClusterNavigation, type ClusterNavigationProps, type FaqItem, NewsletterWidget, type NewsletterWidgetProps, RelatedPosts, ServiceCallout, type ServiceCalloutProps, ServiceCallouts, TableOfContents, TableOfContentsProps, TopicCluster, addExternalLinkTargets, normalizeSiteHost, resolveBlogSiteUrl };

package/dist/blog/index.d.ts

@@ -1,8 +1,8 @@
 export { BlogList, BlogListServerProps, BlogListStyles, BlogPost, BlogPostServerProps, BlogPostStyles } 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, T as TableOfContentsProps } from '../types-DWMpAtGy.js';
-export { l as BlogAnalytics, a as BlogAuthor, b as BlogCategory, e as BlogListOptions, i as BlogListProps, j as BlogListRenderProps, f as BlogListResult, g as BlogPostProps, h as BlogPostRenderProps, d as BlogTag, R as RelatedPostsProps, k as TocItem } from '../types-DWMpAtGy.js';
+import { A as AuthorCardProps, c as AuthorPageProps, B as BlogPost, d as TableOfContentsProps, C as ClusterNavigation$1, T as TopicCluster } 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 } from '../types-5P5B9RgV.js';
 
 interface BlogSidebarProps {
     /** Portal API URL */
@@ -206,6 +206,34 @@ interface BlogFAQProps {
 }
 declare function BlogFAQ({ items, title, allowMultiple, styles, unstyled, }: BlogFAQProps): react_jsx_runtime.JSX.Element | null;
 
+interface ClusterNavigationProps {
+    /** Cluster navigation data (from getClusterNavigation) */
+    navigation: ClusterNavigation$1;
+    /** Base path for blog URLs (default: /blog) */
+    basePath?: string;
+    /** Disable default styles */
+    unstyled?: boolean;
+    /** Custom class name */
+    className?: string;
+}
+declare function ClusterNavigation({ navigation, basePath, 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;
+    /** Disable default styles */
+    unstyled?: boolean;
+    /** Custom class name */
+    className?: string;
+    /** Render prop for full data access */
+    children?: (props: {
+        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>;
+
 /**
  * Post-process Portal/blog HTML for safe, consistent link behavior.
  * Server-safe string transforms only (no DOM).
@@ -224,4 +252,4 @@ declare function resolveBlogSiteUrl(explicit?: string): string;
  */
 declare function addExternalLinkTargets(html: string, siteUrl: string): string;
 
-export { AuthorCard, AuthorCardProps, AuthorPage, AuthorPageProps, BlogFAQ, type BlogFAQProps, BlogLayout, type BlogLayoutProps, BlogPage, type BlogPageProps, BlogPostPage, type BlogPostPageProps, BlogSidebar, type BlogSidebarProps, CategoryPage, type CategoryPageProps, type FaqItem, NewsletterWidget, type NewsletterWidgetProps, RelatedPosts, ServiceCallout, type ServiceCalloutProps, ServiceCallouts, TableOfContents, TableOfContentsProps, addExternalLinkTargets, normalizeSiteHost, resolveBlogSiteUrl };
+export { AuthorCard, AuthorCardProps, AuthorPage, AuthorPageProps, BlogFAQ, type BlogFAQProps, BlogLayout, type BlogLayoutProps, BlogPage, type BlogPageProps, BlogPostPage, type BlogPostPageProps, BlogSidebar, type BlogSidebarProps, CategoryPage, type CategoryPageProps, ClusterLandingPage, type ClusterLandingPageProps, ClusterNavigation, type ClusterNavigationProps, type FaqItem, NewsletterWidget, type NewsletterWidgetProps, RelatedPosts, ServiceCallout, type ServiceCalloutProps, ServiceCallouts, TableOfContents, TableOfContentsProps, TopicCluster, addExternalLinkTargets, normalizeSiteHost, resolveBlogSiteUrl };

package/dist/blog/index.js

@@ -2,8 +2,8 @@
 'use strict';
 
 var chunkUJQYSVYV_js = require('../chunk-UJQYSVYV.js');
-var chunkGQKBGL2W_js = require('../chunk-GQKBGL2W.js');
-var chunkLNMI6OMN_js = require('../chunk-LNMI6OMN.js');
+var chunkDZKX3GHL_js = require('../chunk-DZKX3GHL.js');
+var chunkF54HGPDM_js = require('../chunk-F54HGPDM.js');
 require('../chunk-ZSMWDLMK.js');
 var jsxRuntime = require('react/jsx-runtime');
 var react = require('react');
@@ -698,7 +698,7 @@ function PostCard({ post, basePath }) {
   );
 }
 function AuthorPage({ author, posts, basePath = "/blog" }) {
-  const schema = chunkGQKBGL2W_js.generateAuthorSchema(author);
+  const schema = chunkDZKX3GHL_js.generateAuthorSchema(author);
   return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "sk-author-page", children: [
     /* @__PURE__ */ jsxRuntime.jsx(
       "script",
@@ -876,6 +876,185 @@ function TableOfContents({
     )) })
   ] });
 }
+var clusterLandingCss = `
+.sk-cluster-landing { max-width: 72rem; margin: 0 auto; padding: 2rem 1rem; }
+
+.sk-cluster-hero { margin-bottom: 3rem; text-align: center; }
+.sk-cluster-hero-label {
+  display: inline-flex; align-items: center; gap: 0.375rem;
+  font-size: 0.75rem; font-weight: 600; text-transform: uppercase;
+  letter-spacing: 0.05em; color: #6366f1; margin-bottom: 0.75rem;
+}
+.sk-cluster-hero-title {
+  font-size: 2.25rem; font-weight: 800; color: #111827;
+  line-height: 1.2; margin: 0 0 0.75rem 0;
+}
+.sk-cluster-hero-desc {
+  font-size: 1.125rem; color: #6b7280; max-width: 40rem;
+  margin: 0 auto; line-height: 1.6;
+}
+.sk-cluster-hero-meta {
+  display: flex; justify-content: center; gap: 1.5rem;
+  margin-top: 1rem; font-size: 0.875rem; color: #9ca3af;
+}
+
+.sk-cluster-pillar-card {
+  display: block; text-decoration: none; color: inherit;
+  padding: 2rem; border-radius: 0.75rem;
+  background: linear-gradient(135deg, rgba(99,102,241,0.04), rgba(99,102,241,0.01));
+  border: 2px solid rgba(99,102,241,0.2);
+  margin-bottom: 3rem; transition: border-color 0.2s, box-shadow 0.2s;
+}
+.sk-cluster-pillar-card:hover {
+  border-color: rgba(99,102,241,0.4);
+  box-shadow: 0 4px 24px rgba(99,102,241,0.08);
+}
+.sk-cluster-pillar-label {
+  display: inline-flex; align-items: center; gap: 0.375rem;
+  font-size: 0.6875rem; font-weight: 700; text-transform: uppercase;
+  letter-spacing: 0.05em; color: #6366f1; margin-bottom: 0.75rem;
+  padding: 0.25rem 0.5rem; border-radius: 9999px;
+  background: rgba(99,102,241,0.08);
+}
+.sk-cluster-pillar-title {
+  font-size: 1.5rem; font-weight: 700; color: #111827;
+  margin: 0 0 0.5rem 0; line-height: 1.3;
+}
+.sk-cluster-pillar-excerpt {
+  font-size: 1rem; color: #6b7280; line-height: 1.6;
+  margin: 0 0 1rem 0;
+}
+.sk-cluster-pillar-meta {
+  display: flex; gap: 1rem; font-size: 0.8125rem; color: #9ca3af;
+}
+
+.sk-cluster-supports-section { margin-bottom: 2rem; }
+.sk-cluster-supports-title {
+  font-size: 1.25rem; font-weight: 700; color: #111827;
+  margin: 0 0 1.25rem 0;
+}
+.sk-cluster-supports-grid {
+  display: grid; gap: 1.25rem;
+  grid-template-columns: repeat(auto-fill, minmax(20rem, 1fr));
+}
+.sk-cluster-support-card {
+  display: block; text-decoration: none; color: inherit;
+  padding: 1.25rem; border-radius: 0.5rem;
+  border: 1px solid #e5e7eb; background: #fff;
+  transition: border-color 0.2s, box-shadow 0.2s;
+}
+.sk-cluster-support-card:hover {
+  border-color: #c7d2fe;
+  box-shadow: 0 2px 12px rgba(0,0,0,0.04);
+}
+.sk-cluster-support-card-header {
+  display: flex; align-items: center; gap: 0.5rem;
+  margin-bottom: 0.5rem;
+}
+.sk-cluster-support-type {
+  display: inline-flex; align-items: center;
+  padding: 0.125rem 0.375rem; border-radius: 9999px;
+  font-size: 0.6875rem; font-weight: 500;
+  background: rgba(99,102,241,0.06); color: #6366f1;
+  border: 1px solid rgba(99,102,241,0.12);
+  text-transform: capitalize;
+}
+.sk-cluster-support-intent {
+  font-size: 0.6875rem; color: #9ca3af;
+  text-transform: capitalize;
+}
+.sk-cluster-support-title {
+  font-size: 1rem; font-weight: 600; color: #111827;
+  margin: 0 0 0.375rem 0; line-height: 1.4;
+}
+.sk-cluster-support-excerpt {
+  font-size: 0.875rem; color: #6b7280; line-height: 1.5;
+  margin: 0; display: -webkit-box; -webkit-line-clamp: 2;
+  -webkit-box-orient: vertical; overflow: hidden;
+}
+.sk-cluster-support-meta {
+  display: flex; gap: 0.75rem; margin-top: 0.75rem;
+  font-size: 0.75rem; color: #9ca3af;
+}
+`;
+async function ClusterLandingPage({
+  slug,
+  basePath = "/blog",
+  unstyled = false,
+  className,
+  children
+}) {
+  const cluster = await chunkDZKX3GHL_js.getTopicCluster(slug);
+  if (!cluster) {
+    return /* @__PURE__ */ jsxRuntime.jsx("div", { style: { padding: "4rem 1rem", textAlign: "center", color: "#6b7280" }, children: /* @__PURE__ */ jsxRuntime.jsx("p", { children: "Topic cluster not found." }) });
+  }
+  if (children) {
+    return children({ cluster });
+  }
+  const pillar = cluster.pillar;
+  const supports = cluster.supports || [];
+  return /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
+    !unstyled && /* @__PURE__ */ jsxRuntime.jsx("style", { dangerouslySetInnerHTML: { __html: clusterLandingCss } }),
+    /* @__PURE__ */ jsxRuntime.jsxs("div", { className: `${unstyled ? "" : "sk-cluster-landing"} ${className || ""}`, children: [
+      /* @__PURE__ */ jsxRuntime.jsxs("header", { className: unstyled ? "" : "sk-cluster-hero", children: [
+        /* @__PURE__ */ jsxRuntime.jsx("p", { className: unstyled ? "" : "sk-cluster-hero-label", children: "Topic Cluster" }),
+        /* @__PURE__ */ jsxRuntime.jsx("h1", { className: unstyled ? "" : "sk-cluster-hero-title", children: cluster.cluster_name }),
+        /* @__PURE__ */ jsxRuntime.jsxs("p", { className: unstyled ? "" : "sk-cluster-hero-desc", children: [
+          cluster.core_topic,
+          cluster.geo_target ? ` in ${cluster.geo_target}` : ""
+        ] }),
+        /* @__PURE__ */ jsxRuntime.jsxs("div", { className: unstyled ? "" : "sk-cluster-hero-meta", children: [
+          /* @__PURE__ */ jsxRuntime.jsxs("span", { children: [
+            cluster.article_count,
+            " articles"
+          ] }),
+          cluster.geo_target && /* @__PURE__ */ jsxRuntime.jsx("span", { children: cluster.geo_target })
+        ] })
+      ] }),
+      pillar && /* @__PURE__ */ jsxRuntime.jsxs("a", { href: `${basePath}/${pillar.slug}`, className: unstyled ? "" : "sk-cluster-pillar-card", children: [
+        /* @__PURE__ */ jsxRuntime.jsx("span", { className: unstyled ? "" : "sk-cluster-pillar-label", children: "Pillar Guide" }),
+        /* @__PURE__ */ jsxRuntime.jsx("h2", { className: unstyled ? "" : "sk-cluster-pillar-title", children: pillar.title }),
+        pillar.excerpt && /* @__PURE__ */ jsxRuntime.jsx("p", { className: unstyled ? "" : "sk-cluster-pillar-excerpt", children: pillar.excerpt }),
+        /* @__PURE__ */ jsxRuntime.jsxs("div", { className: unstyled ? "" : "sk-cluster-pillar-meta", children: [
+          pillar.reading_time_minutes && /* @__PURE__ */ jsxRuntime.jsxs("span", { children: [
+            pillar.reading_time_minutes,
+            " min read"
+          ] }),
+          pillar.word_count && /* @__PURE__ */ jsxRuntime.jsxs("span", { children: [
+            pillar.word_count.toLocaleString(),
+            " words"
+          ] })
+        ] })
+      ] }),
+      supports.length > 0 && /* @__PURE__ */ jsxRuntime.jsxs("section", { className: unstyled ? "" : "sk-cluster-supports-section", children: [
+        /* @__PURE__ */ jsxRuntime.jsx("h2", { className: unstyled ? "" : "sk-cluster-supports-title", children: "Deep Dives" }),
+        /* @__PURE__ */ jsxRuntime.jsx("div", { className: unstyled ? "" : "sk-cluster-supports-grid", children: supports.map((post) => /* @__PURE__ */ jsxRuntime.jsxs(
+          "a",
+          {
+            href: `${basePath}/${post.slug}`,
+            className: unstyled ? "" : "sk-cluster-support-card",
+            children: [
+              /* @__PURE__ */ jsxRuntime.jsxs("div", { className: unstyled ? "" : "sk-cluster-support-card-header", children: [
+                post.article_type && /* @__PURE__ */ jsxRuntime.jsx("span", { className: unstyled ? "" : "sk-cluster-support-type", children: post.article_type }),
+                post.search_intent && /* @__PURE__ */ jsxRuntime.jsx("span", { className: unstyled ? "" : "sk-cluster-support-intent", children: post.search_intent })
+              ] }),
+              /* @__PURE__ */ jsxRuntime.jsx("h3", { className: unstyled ? "" : "sk-cluster-support-title", children: post.title }),
+              post.excerpt && /* @__PURE__ */ jsxRuntime.jsx("p", { className: unstyled ? "" : "sk-cluster-support-excerpt", children: post.excerpt }),
+              /* @__PURE__ */ jsxRuntime.jsxs("div", { className: unstyled ? "" : "sk-cluster-support-meta", children: [
+                post.reading_time_minutes && /* @__PURE__ */ jsxRuntime.jsxs("span", { children: [
+                  post.reading_time_minutes,
+                  " min read"
+                ] }),
+                post.relationship_to_pillar && /* @__PURE__ */ jsxRuntime.jsx("span", { children: post.relationship_to_pillar })
+              ] })
+            ]
+          },
+          post.id || post.slug
+        )) })
+      ] })
+    ] })
+  ] });
+}
 
 Object.defineProperty(exports, "BlogFAQ", {
   enumerable: true,
@@ -883,31 +1062,35 @@ Object.defineProperty(exports, "BlogFAQ", {
 });
 Object.defineProperty(exports, "BlogList", {
   enumerable: true,
-  get: function () { return chunkLNMI6OMN_js.BlogList; }
+  get: function () { return chunkF54HGPDM_js.BlogList; }
 });
 Object.defineProperty(exports, "BlogPost", {
   enumerable: true,
-  get: function () { return chunkLNMI6OMN_js.BlogPost; }
+  get: function () { return chunkF54HGPDM_js.BlogPost; }
+});
+Object.defineProperty(exports, "ClusterNavigation", {
+  enumerable: true,
+  get: function () { return chunkF54HGPDM_js.ClusterNavigation; }
 });
 Object.defineProperty(exports, "ServiceCallout", {
   enumerable: true,
-  get: function () { return chunkLNMI6OMN_js.ServiceCallout; }
+  get: function () { return chunkF54HGPDM_js.ServiceCallout; }
 });
 Object.defineProperty(exports, "ServiceCallouts", {
   enumerable: true,
-  get: function () { return chunkLNMI6OMN_js.ServiceCallouts; }
+  get: function () { return chunkF54HGPDM_js.ServiceCallouts; }
 });
 Object.defineProperty(exports, "addExternalLinkTargets", {
   enumerable: true,
-  get: function () { return chunkLNMI6OMN_js.addExternalLinkTargets; }
+  get: function () { return chunkF54HGPDM_js.addExternalLinkTargets; }
 });
 Object.defineProperty(exports, "normalizeSiteHost", {
   enumerable: true,
-  get: function () { return chunkLNMI6OMN_js.normalizeSiteHost; }
+  get: function () { return chunkF54HGPDM_js.normalizeSiteHost; }
 });
 Object.defineProperty(exports, "resolveBlogSiteUrl", {
   enumerable: true,
-  get: function () { return chunkLNMI6OMN_js.resolveBlogSiteUrl; }
+  get: function () { return chunkF54HGPDM_js.resolveBlogSiteUrl; }
 });
 exports.AuthorCard = AuthorCard;
 exports.AuthorPage = AuthorPage;
@@ -916,6 +1099,7 @@ exports.BlogPage = BlogPage;
 exports.BlogPostPage = BlogPostPage;
 exports.BlogSidebar = BlogSidebar;
 exports.CategoryPage = CategoryPage;
+exports.ClusterLandingPage = ClusterLandingPage;
 exports.NewsletterWidget = NewsletterWidget;
 exports.RelatedPosts = RelatedPosts;
 exports.TableOfContents = TableOfContents;