@sonordev/site-kit 8.2.0 → 8.3.0

package/dist/mcp/sonor.js

@@ -1,9 +1,9 @@
-import { fetchReviews, fetchReviewStats } from '../chunk-NFRJTOTB.js';
+import { fetchReviews, fetchReviewStats } from '../chunk-BSQP6PRA.js';
 import { toolErrorResult } from '../chunk-FYAB6CXS.js';
-import { fetchBookingTypes, fetchAvailability } from '../chunk-XWIRU6UT.js';
-import { getLLMsData, getServices, getFAQItems, getPageSummaries } from '../chunk-JIH32RH2.js';
-import { getFormConfig } from '../chunk-BQZPHICL.js';
-import '../chunk-SMYX3AAO.js';
+import { fetchBookingTypes, fetchAvailability } from '../chunk-WBUG7XRL.js';
+import { getLLMsData, getServices, getFAQItems, getPageSummaries } from '../chunk-XA7Q2VQA.js';
+import { getFormConfig } from '../chunk-NA4Z4CQG.js';
+import '../chunk-5RYSTKVU.js';
 import '../chunk-C2FZBUSS.js';
 import '../chunk-YC7ELZS3.js';
 import '../chunk-LNSF6BJC.js';
@@ -12,23 +12,17 @@ import '../chunk-TYAVHRWH.js';
 import '../chunk-5SQK3D53.js';
 import '../chunk-HW7B43E5.js';
 import '../chunk-NJCTQH2P.js';
-import { getAllArticles, getArticle } from '../chunk-FQUGGPBM.js';
-import '../chunk-HUBMKTPW.js';
-import '../chunk-Y3INC4QJ.js';
-import '../chunk-QXMIKDOL.js';
-import '../chunk-WMVK77ND.js';
 import { resolveFetch } from '../chunk-UAYAJPEP.js';
 import '../chunk-NZ4RXN3G.js';
-import '../chunk-VWWITFWM.js';
 import '../chunk-MJP63SSS.js';
 import { resolveServerApiConfig } from '../chunk-C7TLGL3R.js';
 import '../chunk-MH2DSGC6.js';
 import { resolveSiteHost } from '../chunk-FESKKJAS.js';
 import '../chunk-A4CC4ZG3.js';
-import '../chunk-3G7YABRA.js';
-import '../chunk-727R7C5R.js';
-import '../chunk-3EU6S5YC.js';
-import { SITE_KIT_VERSION } from '../chunk-Q72M5KBS.js';
+import '../chunk-OIWFXUVD.js';
+import '../chunk-C4AFNZT2.js';
+import '../chunk-W7OPEMGJ.js';
+import { SITE_KIT_VERSION } from '../chunk-C2UROFGZ.js';
 import '../chunk-PKBMQBKP.js';
 import 'server-only';
 import { after } from 'next/server.js';
@@ -74,6 +68,10 @@ function reportToolCallsToSonor(options = {}) {
 }
 
 // src/mcp/sonor.ts
+var legacyArticleReaders = {
+  readMany: async (options) => (await import('../articles/server.js')).getAllArticles(options),
+  readOne: async (slug, options) => (await import('../articles/server.js')).getArticle(slug, options)
+};
 var SEARCH_LIMIT_MAX = 20;
 var ARTICLE_CONTENT_MAX = 12e3;
 var REPORTED_BY = "from the business\u2019s Sonor workspace";
@@ -199,7 +197,7 @@ function findPages(ctx) {
     }
   };
 }
-function listArticles(ctx, basePath) {
+function listArticles(ctx, basePath, readers) {
   return {
     name: "list_articles",
     title: "List articles",
@@ -207,7 +205,7 @@ function listArticles(ctx, basePath) {
     inputSchema: { type: "object", properties: { query: QUERY, limit: LIMIT }, additionalProperties: false },
     annotations: READ,
     handler: async (args) => {
-      const posts = await getAllArticles({ maxPosts: 100, site: ctx.site });
+      const posts = await readers.readMany({ maxPosts: 100, site: ctx.site });
       const picked = rankByQuery(posts, text(args.query, 200), (p) => [p.title, [p.excerpt, nameOf(p.category)].filter(Boolean).join(" ")], limitOf(args.limit, 5));
       return {
         articles: picked.map((p) => ({
@@ -222,7 +220,7 @@ function listArticles(ctx, basePath) {
     }
   };
 }
-function getArticleTool(ctx, basePath) {
+function getArticleTool(ctx, basePath, readers) {
   return {
     name: "get_article",
     title: "Read an article",
@@ -236,7 +234,7 @@ function getArticleTool(ctx, basePath) {
     annotations: READ,
     handler: async (args) => {
       const slug = text(args.slug, 200).replace(/^\/+|\/+$/g, "").split("/").pop() ?? "";
-      const post = slug ? await getArticle(slug, { site: ctx.site }) : null;
+      const post = slug ? await readers.readOne(slug, { site: ctx.site }) : null;
       if (!post) return { found: false, note: `No published article with the slug "${slug}". Call list_articles for the slugs that exist.` };
       const content = post.content ?? "";
       return {
@@ -445,6 +443,13 @@ function sendInquiry(ctx, form, purpose) {
     }
   };
 }
+function articleReaders(articles) {
+  if (!articles || articles.readMany === void 0 && articles.readOne === void 0) return legacyArticleReaders;
+  if (typeof articles.readMany !== "function" || typeof articles.readOne !== "function") {
+    throw new Error("sonorMcpServer: pass both articles.readMany and articles.readOne: getAllArticles and getArticle from '@sonordev/press-kit/articles/server'.");
+  }
+  return { readMany: articles.readMany, readOne: articles.readOne };
+}
 function offeringsReader(offerings) {
   if (typeof offerings.read !== "function") {
     throw new Error(
@@ -462,7 +467,7 @@ function sonorMcpTools(options) {
     listServices(ctx),
     searchFaq(ctx),
     findPages(ctx),
-    ...articlesPath !== null ? [listArticles(ctx, articlesPath), getArticleTool(ctx, articlesPath)] : [],
+    ...articlesPath !== null ? [listArticles(ctx, articlesPath, articleReaders(options.articles || void 0)), getArticleTool(ctx, articlesPath, articleReaders(options.articles || void 0))] : [],
     ...options.reviews === false ? [] : [getReviews(ctx)],
     ...options.offerings ? [listOfferings(ctx, (options.offerings.path ?? "/shop").replace(/\/+$/, ""), offeringsReader(options.offerings))] : [],
     ...options.booking ? [checkAvailability(ctx, options.booking.path)] : [],

package/dist/mcp/transport.d.ts

@@ -126,7 +126,7 @@ export declare function protectMcpHandlers(handlers: McpRouteHandlerSet, options
  * @example
  * ```ts
  * // app/api/mcp-internal/route.ts
- * import * as mcp from '../mcp/route'
+ * import * as mcp from './route'
  * export const { POST, GET, DELETE, OPTIONS } = createMcpInternalRoute(mcp)
  * ```
  */

package/dist/press-kit/articles/Article.d.ts

@@ -0,0 +1,89 @@
+/**
+ * @sonordev/press-kit/articles - Article Component
+ *
+ * Fetches and displays a single article with full content, table of contents,
+ * author info, related posts, and SEO metadata support.
+ *
+ * Ships with world-class default styling via scoped `.sk-article-*` classes.
+ * No configuration needed — just `<Article slug={slug} />`.
+ *
+ * Override with `styles` prop (per-element class names) or `unstyled` for
+ * complete control. The `children` render prop gives full data access.
+ */
+import React from 'react';
+import type { Article as ArticleType, TocItem } from './types';
+import { type PublicationRoutingOptions } from './routes';
+export interface ArticleStyles {
+    article?: string;
+    header?: string;
+    breadcrumb?: string;
+    breadcrumbLink?: string;
+    title?: string;
+    subtitle?: string;
+    meta?: string;
+    metaItem?: string;
+    featuredImageWrapper?: string;
+    featuredImage?: string;
+    contentLayout?: string;
+    content?: string;
+    tocSidebar?: string;
+    tocTitle?: string;
+    tocList?: string;
+    tocItem?: string;
+    tocLink?: string;
+    tags?: string;
+    tag?: string;
+    faqSection?: string;
+    faqTitle?: string;
+    faqItem?: string;
+    faqQuestion?: string;
+    faqAnswer?: string;
+    authorCard?: string;
+    relatedSection?: string;
+    relatedTitle?: string;
+    relatedGrid?: string;
+    relatedCard?: string;
+    notFound?: string;
+}
+export interface ArticleServerProps {
+    apiUrl?: string;
+    apiKey?: string;
+    slug: string;
+    showToc?: boolean;
+    showRelated?: boolean;
+    relatedCount?: number;
+    showAuthor?: boolean;
+    basePath?: string;
+    routing?: PublicationRoutingOptions;
+    /** The publication's name in the breadcrumb (e.g. "The Forge"). Default "Articles". */
+    publicationName?: string;
+    className?: string;
+    styles?: ArticleStyles;
+    unstyled?: boolean;
+    siteUrl?: string;
+    /**
+     * Sub-site host for multi-site projects (e.g. `charlotte.example.com`). Scopes
+     * the post, related-posts and view-count calls to that host. Omit to resolve
+     * from NEXT_PUBLIC_SITE_URL. Separate from `siteUrl`, which only decides
+     * which links in the body open in a new tab.
+     */
+    site?: string;
+    /**
+     * What to render when the post doesn't exist. Default true: call Next's
+     * `notFound()`, so the route answers 404 with `noindex` instead of a
+     * "Post Not Found" message on a 200 (a soft 404). False renders that
+     * message, for a page that wants its own missing-post state.
+     *
+     * For a guaranteed 404 status, also call `requireArticle(slug)` from
+     * `@sonordev/press-kit/articles/server` in `generateMetadata`: metadata resolves
+     * before anything streams. Thrown from inside a Suspense boundary that has
+     * already streamed, `notFound()` can only add `noindex` to a 200.
+     */
+    notFound?: boolean;
+    children?: (props: {
+        post: ArticleType;
+        tableOfContents: TocItem[];
+        relatedPosts: ArticleType[];
+    }) => React.ReactNode;
+}
+export declare function Article({ apiUrl, apiKey, slug, showToc, showRelated, relatedCount, showAuthor, basePath, publicationName, routing, className, styles, unstyled, siteUrl, site, notFound, children, }: ArticleServerProps): Promise<React.JSX.Element | null>;

package/dist/press-kit/articles/ArticleFAQ.d.ts

@@ -0,0 +1,41 @@
+/**
+ * @sonordev/press-kit/articles - Article FAQ Component
+ *
+ * Renders FAQ items with collapsible accordion behavior.
+ * Content is always in the DOM (not display:none) for SEO crawlability.
+ * Uses CSS max-height transitions — no JS animation library required.
+ *
+ * Pairs with FAQPage schema (generated by Signal AI in the publication pipeline)
+ * for Google's "People Also Ask" featured snippets.
+ *
+ * @example
+ * ```tsx
+ * <ArticleFAQ items={post.faqItems} />
+ * ```
+ */
+import React from 'react';
+export interface FaqItem {
+    question: string;
+    answer: string;
+}
+export interface ArticleFAQProps {
+    items: FaqItem[];
+    /** Section title */
+    title?: string;
+    /** Allow multiple items open simultaneously */
+    allowMultiple?: boolean;
+    /** Override styles with Tailwind classes */
+    styles?: {
+        section?: string;
+        title?: string;
+        list?: string;
+        item?: string;
+        question?: string;
+        questionText?: string;
+        icon?: string;
+        answer?: string;
+        answerInner?: string;
+    };
+    unstyled?: boolean;
+}
+export declare function ArticleFAQ({ items, title, allowMultiple, styles, unstyled, }: ArticleFAQProps): React.JSX.Element | null;

package/dist/press-kit/articles/ArticleFaqSection.d.ts

@@ -0,0 +1,2 @@
+import type { ArticleFAQProps } from './ArticleFAQ';
+export declare function ArticleFaqSection(props: ArticleFAQProps): import("react").JSX.Element;

package/dist/press-kit/articles/ArticleList.d.ts

@@ -0,0 +1,79 @@
+/**
+ * @sonordev/press-kit/articles - Article List Component
+ *
+ * Fetches and displays a list of articles with pagination, filtering, and sorting.
+ *
+ * Ships with world-class default styling via scoped `.sk-article-list-*` classes.
+ * No configuration needed — just `<ArticleList basePath="/article" />`.
+ *
+ * Override with `styles` prop (per-element class names) or `unstyled` for
+ * complete control. The `children` render prop gives full data access.
+ */
+import React from 'react';
+import type { ArticleListResult, Article, ArticleCategory } from './types';
+import { type PublicationRoutingOptions } from './routes';
+export interface ArticleListStyles {
+    container?: string;
+    categoryNav?: string;
+    categoryLink?: string;
+    categoryLinkActive?: string;
+    categoryLinkInactive?: string;
+    grid?: string;
+    card?: string;
+    cardImageWrapper?: string;
+    cardImage?: string;
+    cardBody?: string;
+    cardMeta?: string;
+    cardCategory?: string;
+    cardDate?: string;
+    cardTitle?: string;
+    cardTitleLink?: string;
+    cardExcerpt?: string;
+    cardFooter?: string;
+    cardAuthor?: string;
+    cardReadingTime?: string;
+    cardReadMore?: string;
+    pagination?: string;
+    paginationLink?: string;
+    paginationInfo?: string;
+    emptyState?: string;
+}
+export interface ArticleListServerProps {
+    apiUrl?: string;
+    apiKey?: string;
+    category?: string;
+    tag?: string;
+    /** Author slug (preferred) or display name; slug filtering requires the current Sonor API */
+    author?: string;
+    featured?: boolean;
+    search?: string;
+    /**
+     * Topic cluster slug — pairs with getTopicCluster. Note: an unknown slug
+     * yields an UNfiltered list (pre-existing API behavior).
+     */
+    cluster?: string;
+    page?: number;
+    perPage?: number;
+    orderBy?: 'published_at' | 'title' | 'view_count';
+    order?: 'asc' | 'desc';
+    /**
+     * Sub-site host for multi-site projects (e.g. `charlotte.example.com`): the list
+     * shows that host's posts plus project-wide ones. Omit to resolve from
+     * NEXT_PUBLIC_SITE_URL.
+     */
+    site?: string;
+    showCategoryFilter?: boolean;
+    showPagination?: boolean;
+    className?: string;
+    basePath?: string;
+    routing?: PublicationRoutingOptions;
+    styles?: ArticleListStyles;
+    unstyled?: boolean;
+    renderPost?: (post: Article) => React.ReactNode;
+    children?: (props: {
+        posts: Article[];
+        pagination: ArticleListResult['pagination'];
+        categories: ArticleCategory[];
+    }) => React.ReactNode;
+}
+export declare function ArticleList({ apiUrl, apiKey, category, tag, author, featured, search, cluster, page, perPage, orderBy, order, site, showCategoryFilter, showPagination, className, basePath, routing, styles, unstyled, renderPost, children, }: ArticleListServerProps): Promise<string | number | bigint | boolean | React.JSX.Element | Iterable<React.ReactNode> | null | undefined>;

package/dist/press-kit/articles/ArticleViewTracker.d.ts

@@ -0,0 +1,15 @@
+export interface ArticleViewTrackerProps {
+    slug: string;
+    /**
+     * Sub-site host the view counts toward. Omit to use the host SiteKitLayout
+     * published (`__SITE_KIT_SITE__`, the same one analytics tags page views
+     * with), then NEXT_PUBLIC_SITE_URL, then `window.location.host`.
+     */
+    site?: string;
+}
+/**
+ * The effect body, exported for tests (the package's vitest runs in node, so
+ * the component's mount path can't be exercised directly).
+ */
+export declare function trackArticleView(slug: string, site?: string): void;
+export declare function ArticleViewTracker({ slug, site }: ArticleViewTrackerProps): null;

package/dist/press-kit/articles/AuthorCard.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @sonordev/press-kit/articles - Author Card Component
+ */
+import React from 'react';
+import type { AuthorCardProps, ArticleAuthor } from './types';
+declare function TrustBlock({ author }: {
+    author: ArticleAuthor;
+}): React.JSX.Element | null;
+export declare function AuthorCard({ author, showBio, showSocial, showTrustBlock, className }: AuthorCardProps): React.JSX.Element;
+export { TrustBlock };

package/dist/press-kit/articles/AuthorPage.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @sonordev/press-kit/articles - Author Page Component (Server Component)
+ *
+ * Full author profile page with hero, trust block, social links, and articles grid.
+ */
+import React from 'react';
+import type { AuthorPageProps } from './types';
+export declare function AuthorPage({ author, posts, basePath, routing, siteUrl, siteName, jsonLd }: AuthorPageProps): React.JSX.Element;

package/dist/press-kit/articles/ClusterLandingPage.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @sonordev/press-kit/articles - Cluster Landing Page Component
+ *
+ * Pre-built page component for `/article/cluster/[slug]` routes.
+ * Renders a topic cluster overview with:
+ * - Cluster hero (name, topic, description)
+ * - Pillar article (featured, large card)
+ * - Support articles (grid, categorized by article_type or funnel_stage)
+ *
+ * Server component — fetches cluster data from Sonor API.
+ * Ships with `.sk-cluster-landing-*` scoped styles.
+ */
+import React from 'react';
+import { type PublicationRoutingOptions } from './routes';
+import type { TopicCluster } from './types';
+export interface ClusterLandingPageProps {
+    /** Cluster slug to fetch */
+    slug: string;
+    /** Sub-site host for multi-site projects. Omit to resolve from NEXT_PUBLIC_SITE_URL. */
+    site?: string;
+    /** Base path for article URLs (default: /article) */
+    basePath?: string;
+    routing?: PublicationRoutingOptions;
+    /**
+     * Include each article's own category segment in its URL:
+     * {basePath}/{category}/{slug}. Enable on sites whose article routes are
+     * category-segmented (e.g. /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 */
+    className?: string;
+    /** Render prop for full data access */
+    children?: (props: {
+        cluster: TopicCluster;
+    }) => React.ReactNode;
+}
+export declare function ClusterLandingPage({ slug, site, basePath, routing, categoryInPath, unstyled, className, children, }: ClusterLandingPageProps): Promise<string | number | bigint | boolean | React.JSX.Element | Iterable<React.ReactNode> | null | undefined>;

package/dist/press-kit/articles/ClusterNavigation.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @sonordev/press-kit/articles - Cluster Navigation Component
+ *
+ * Renders cluster context on article pages:
+ * - "Full Guide" pillar backlink (on support articles only)
+ * - Sibling article list with article_type badges
+ *
+ * Adapts to light/dark themes automatically using the same --sk-* variables
+ * as the rest of site-kit, with currentColor-based fallbacks.
+ */
+import React from 'react';
+import type { ClusterNavigation as ClusterNavigationType } from './types';
+import { type PublicationRoutingOptions } from './routes';
+export interface ClusterNavigationProps {
+    /** Cluster navigation data */
+    navigation: ClusterNavigationType;
+    /** Base path for article URLs (default: /article) */
+    basePath?: string;
+    routing?: PublicationRoutingOptions;
+    /**
+     * 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. Defaults to the site's
+     * next.config `trailingSlash`, so it rarely needs setting.
+     */
+    trailingSlash?: boolean;
+    /** Disable default styles */
+    unstyled?: boolean;
+    /** Custom class name */
+    className?: string;
+}
+export declare function ClusterNavigation({ navigation, basePath, routing, category, trailingSlash: trailingSlashProp, unstyled, className, }: ClusterNavigationProps): React.JSX.Element | null;

package/dist/press-kit/articles/ManagedNewsletterForm.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Managed-forms mode of NewsletterWidget — its own module, loaded via
+ * React.lazy, so the useForm graph (forms engine, sonorFetch, site token)
+ * stays out of the publication entry's eager bundle. Article consumers only pay for
+ * it when a formSlug newsletter actually mounts (enforced by the
+ * integration harness's bundle budget, which measures the eager
+ * static-import graph).
+ */
+import React from 'react';
+import { type NewsletterShellProps } from './NewsletterShell';
+import type { NewsletterWidgetProps } from './NewsletterWidget';
+export default function ManagedNewsletterForm({ formSlug, title, description, buttonText, successMessage, }: Required<Pick<NewsletterWidgetProps, 'formSlug'>> & Pick<NewsletterShellProps, 'title' | 'description' | 'buttonText' | 'successMessage'>): React.JSX.Element | null;

package/dist/press-kit/articles/NewsletterShell.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Presentational shell shared by NewsletterWidget's two modes. No data
+ * imports — keep it that way, it renders in the eager article bundle.
+ */
+import React from 'react';
+export interface NewsletterShellProps {
+    title: string;
+    description: string;
+    buttonText: string;
+    email: string;
+    onEmailChange: (value: string) => void;
+    onFormSubmit: (e: React.FormEvent) => void;
+    status: 'idle' | 'submitting' | 'success' | 'error';
+    successMessage: string;
+    errorMessage?: string | null;
+}
+export declare function NewsletterShell({ title, description, buttonText, email, onEmailChange, onFormSubmit, status, successMessage, errorMessage, }: NewsletterShellProps): React.JSX.Element;

package/dist/press-kit/articles/NewsletterWidget.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @sonordev/site-kit article — newsletter signup widget
+ *
+ * Two working modes (the old version rendered a form whose submit handler
+ * discarded the email):
+ *
+ * - `onSubmit`: the site owns delivery — we await the callback.
+ * - `formSlug`: the widget drives the managed-forms rail (useForm), so
+ *   submissions inherit Sonor's newsletter routing (email_subscribers),
+ *   honeypot, reCAPTCHA, and attribution for free.
+ *
+ * `onSubmit` wins when both are set. With neither, the widget renders
+ * nothing and warns — a dead form that swallows emails must not resurrect.
+ *
+ * Lives in its own module (not PublicationSidebar.tsx) on purpose: it needs hooks,
+ * and PublicationSidebar is also bundled into the un-stamped server entry
+ * articles/server-ui, where hooks would enter the react-server graph.
+ */
+import React from 'react';
+export interface NewsletterWidgetProps {
+    title?: string;
+    description?: string;
+    buttonText?: string;
+    /** Site-owned delivery. Wins over formSlug when both are set. */
+    onSubmit?: (email: string) => Promise<void>;
+    /** Slug of a managed Sonor form (newsletter routing) to submit through. */
+    formSlug?: string;
+    successMessage?: string;
+}
+export declare function NewsletterWidget({ title, description, buttonText, onSubmit, formSlug, successMessage, }: NewsletterWidgetProps): React.JSX.Element | null;

package/dist/press-kit/articles/PublicationLayout.d.ts

@@ -0,0 +1,67 @@
+/**
+ * @sonordev/press-kit/articles - Article Layout Component
+ *
+ * A complete article layout with sidebar, responsive design, and optional hero.
+ * Use this to wrap your article pages for consistent styling.
+ */
+import React from 'react';
+import { PublicationSidebarProps } from './PublicationSidebar';
+import type { PublicationRoutingOptions } from './routes';
+export interface PublicationLayoutProps {
+    /** Sonor API URL */
+    apiUrl?: string;
+    /** Project API key */
+    apiKey?: string;
+    /** Sub-site host for multi-site projects, passed to the sidebar. Omit to resolve from NEXT_PUBLIC_SITE_URL. */
+    site?: string;
+    /** Layout style: 'sidebar-right', 'sidebar-left', 'full-width' */
+    layout?: 'sidebar-right' | 'sidebar-left' | 'full-width';
+    /** Show sidebar */
+    showSidebar?: boolean;
+    /** Sidebar props */
+    sidebarProps?: Partial<PublicationSidebarProps>;
+    /** Hero section config */
+    hero?: {
+        title?: string;
+        subtitle?: string;
+        backgroundImage?: string;
+        backgroundColor?: string;
+    };
+    /** Max width for content */
+    maxWidth?: number;
+    /** Base URL for article links */
+    basePath?: string;
+    routing?: PublicationRoutingOptions;
+    /** Custom class name */
+    className?: string;
+    /** Current category (for sidebar highlighting) */
+    currentCategory?: string;
+    /** Main content */
+    children: React.ReactNode;
+}
+export declare function PublicationLayout({ apiUrl, apiKey, site, layout, showSidebar, sidebarProps, hero, maxWidth, basePath, routing, className, currentCategory, children, }: PublicationLayoutProps): Promise<React.JSX.Element>;
+/**
+ * Convenience wrapper for a complete publication index page
+ */
+export interface PublicationPageProps extends Omit<PublicationLayoutProps, 'children'> {
+    /** List component to render */
+    listComponent: React.ReactNode;
+}
+export declare function PublicationPage({ listComponent, ...layoutProps }: PublicationPageProps): Promise<React.JSX.Element>;
+/**
+ * Convenience wrapper for a single article page
+ */
+export interface ArticlePageProps extends Omit<PublicationLayoutProps, 'children'> {
+    /** Post component to render */
+    postComponent: React.ReactNode;
+}
+export declare function ArticlePage({ postComponent, ...layoutProps }: ArticlePageProps): Promise<React.JSX.Element>;
+export interface CategoryPageProps extends PublicationLayoutProps {
+    /** Category slug being viewed */
+    category: string;
+    /** Category display name */
+    categoryName?: string;
+    /** List component */
+    listComponent: React.ReactNode;
+}
+export declare function CategoryPage({ category, categoryName, listComponent, hero, ...layoutProps }: CategoryPageProps): Promise<React.JSX.Element>;

package/dist/press-kit/articles/PublicationSidebar.d.ts

@@ -0,0 +1,36 @@
+/**
+ * @sonordev/press-kit/articles - Article Sidebar Component
+ *
+ * A reusable sidebar for article pages with categories, recent posts,
+ * tags, newsletter signup, and custom widgets.
+ */
+import React from 'react';
+import { type PublicationRoutingOptions } from './routes';
+export interface PublicationSidebarProps {
+    /** Sonor API URL */
+    apiUrl?: string;
+    /** Project API key */
+    apiKey?: string;
+    /** Sub-site host for multi-site projects. Omit to resolve from NEXT_PUBLIC_SITE_URL. */
+    site?: string;
+    /** Show categories widget */
+    showCategories?: boolean;
+    /** Show recent posts widget */
+    showRecentPosts?: boolean;
+    /** Number of recent posts to show */
+    recentPostsCount?: number;
+    /** Show tags widget */
+    showTags?: boolean;
+    /** Show search widget */
+    showSearch?: boolean;
+    /** Base URL for article links */
+    basePath?: string;
+    routing?: PublicationRoutingOptions;
+    /** Custom class name */
+    className?: string;
+    /** Current category filter (for highlighting) */
+    currentCategory?: string;
+    /** Additional widgets to render */
+    children?: React.ReactNode;
+}
+export declare function PublicationSidebar({ apiUrl, apiKey, site, showCategories, showRecentPosts, recentPostsCount, showTags, showSearch, basePath, routing, className, currentCategory, children, }: PublicationSidebarProps): Promise<React.JSX.Element | null>;

package/dist/press-kit/articles/RelatedPosts.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @sonordev/press-kit/articles - Related articles component
+ *
+ * Fetches and displays related articles via Sonor API
+ */
+import React from 'react';
+import type { Article } from './types';
+import { type PublicationRoutingOptions } from './routes';
+interface RelatedPostsServerProps {
+    apiUrl?: string;
+    apiKey?: string;
+    currentPostId: string;
+    limit?: number;
+    /** Sub-site host for multi-site projects. Omit to resolve from NEXT_PUBLIC_SITE_URL. */
+    site?: string;
+    className?: string;
+    basePath?: string;
+    routing?: PublicationRoutingOptions;
+    renderItem?: (post: Article) => React.ReactNode;
+}
+export declare function RelatedPosts({ apiUrl, apiKey, currentPostId, limit, site, className, basePath, routing, renderItem, }: RelatedPostsServerProps): Promise<React.JSX.Element | null>;
+export {};