@sonordev/site-kit 8.2.0 → 8.4.0

package/dist/articles/server-ui.js

@@ -1,23 +1,32 @@
-import { readingTimeMinutes, ServiceCallouts, ClusterNavigation, getAuthorSocialLinks } from '../chunk-FV2VD7WM.js';
-export { ClusterNavigation } from '../chunk-FV2VD7WM.js';
-import { widgetStyle, widgetTitleStyle } from '../chunk-GYF2ULVO.js';
-import { resolvePublicationSiteUrl, addExternalLinkTargets } from '../chunk-L5UOHS6E.js';
-import { fetchArticleBySlug, fetchRelatedArticles, fetchArticleCategories, getTopicCluster } from '../chunk-FQUGGPBM.js';
-import { insertArticlePhotos } from '../chunk-HUBMKTPW.js';
-export { articlePhotoCss, insertArticlePhotos } from '../chunk-HUBMKTPW.js';
-export { articleTableCss, wrapArticleTables } from '../chunk-Y3INC4QJ.js';
-import { resolveArticleArtwork, articleArtworkImageStyle } from '../chunk-QXMIKDOL.js';
-export { resolveArticleArtwork } from '../chunk-QXMIKDOL.js';
-import { createPublicationRoutes, articleCategorySlug } from '../chunk-WMVK77ND.js';
-export { articleCategorySlug, createPublicationRoutes, resolveArticleUrl, resolvePublicationUrl } from '../chunk-WMVK77ND.js';
+import { readingTimeMinutes, ServiceCallouts, ClusterNavigation, getAuthorSocialLinks } from '../chunk-BC7JMY4Z.js';
+export { ClusterNavigation } from '../chunk-BC7JMY4Z.js';
+import { widgetStyle, widgetTitleStyle } from '../chunk-DJAYFHVF.js';
+import { resolvePublicationSiteUrl, addExternalLinkTargets } from '../chunk-5D7ZISUP.js';
+import { fetchArticleBySlug, fetchRelatedArticles, fetchArticleCategories, getTopicCluster, ArticleUnavailableError } from '../chunk-TY6WNQO3.js';
+import { insertArticlePhotos } from '../chunk-M5SF7NCC.js';
+export { articlePhotoCss, insertArticlePhotos } from '../chunk-M5SF7NCC.js';
+export { articleTableCss, wrapArticleTables } from '../chunk-E4PTMORJ.js';
+import { resolveArticleArtwork, articleArtworkImageStyle } from '../chunk-UVYUTBT4.js';
+export { resolveArticleArtwork } from '../chunk-UVYUTBT4.js';
+import '../chunk-H72ZFO3F.js';
+import { createPublicationRoutes, articleCategorySlug } from '../chunk-4K735O3J.js';
+export { articleCategorySlug, createPublicationRoutes, resolveArticleUrl, resolvePublicationUrl } from '../chunk-4K735O3J.js';
+import '../chunk-34ZYJTQR.js';
+import '../chunk-LPVEBQVL.js';
+import '../chunk-UAYAJPEP.js';
 import '../chunk-VWWITFWM.js';
+import '../chunk-4KZ6W3ZH.js';
 import { withSiteParam } from '../chunk-MJP63SSS.js';
+import '../chunk-6KU7STM3.js';
 import '../chunk-C7TLGL3R.js';
 import '../chunk-MH2DSGC6.js';
 import '../chunk-YVKRYQRG.js';
 import '../chunk-FESKKJAS.js';
 import '../chunk-A4CC4ZG3.js';
+import '../chunk-W7OPEMGJ.js';
+import '../chunk-5S7YTOCB.js';
 import '../chunk-PKBMQBKP.js';
+import 'server-only';
 import { marked } from 'marked';
 import { notFound } from 'next/navigation';
 import { jsxs, Fragment, jsx } from 'react/jsx-runtime';
@@ -109,8 +118,8 @@ async function Article({
   }
   const [post, { articleCss }, { wrapArticleTables: wrapArticleTables2 }] = await Promise.all([
     fetchArticleBySlug({ apiUrl, apiKey, site }, slug),
-    unstyled ? Promise.resolve({ articleCss: "" }) : import('../article-styles-GFXJJDLE.js'),
-    import('../article-tables-AXSZOGNW.js')
+    unstyled ? Promise.resolve({ articleCss: "" }) : import('../article-styles-AOOVVKXH.js'),
+    import('../article-tables-6XHVULPU.js')
   ]);
   if (!post) {
     if (notFound$1) notFound();
@@ -135,14 +144,14 @@ async function Article({
     ...item,
     answer: addExternalLinkTargets(item.answer || "", siteUrlResolved)
   })) ?? faqRaw;
-  const { ArticleViewTracker } = await import('../ArticleViewTracker-H4N7YCLC.js');
+  const { ArticleViewTracker } = await import('../ArticleViewTracker-YZ76HM64.js');
   if (children) {
     return /* @__PURE__ */ jsxs(Fragment, { children: [
       /* @__PURE__ */ jsx(ArticleViewTracker, { slug: post.slug, site }),
       children({ post, tableOfContents, relatedPosts })
     ] });
   }
-  const { ArticleFaqSection } = await import('../ArticleFaqSection-3Q26DP7P.js');
+  const { ArticleFaqSection } = await import('../ArticleFaqSection-DEWE5B4Q.js');
   const date = post.published_at ? new Date(post.published_at).toLocaleDateString("en-US", { month: "long", day: "numeric", year: "numeric" }) : null;
   const hasToc = showToc && tableOfContents.length > 0;
   return /* @__PURE__ */ jsxs(Fragment, { children: [
@@ -210,6 +219,14 @@ async function Article({
           )) })
         ] })
       ] }),
+      post.editorial_verification?.note && /* @__PURE__ */ jsxs("aside", { className: "sk-article-verification", "aria-label": "Editorial verification", children: [
+        /* @__PURE__ */ jsx("h2", { children: "Editorial verification" }),
+        /* @__PURE__ */ jsx("p", { children: post.editorial_verification.note }),
+        post.editorial_verification.reviewedAt && /* @__PURE__ */ jsxs("p", { children: [
+          "Reviewed ",
+          /* @__PURE__ */ jsx("time", { dateTime: post.editorial_verification.reviewedAt, children: new Date(post.editorial_verification.reviewedAt).toLocaleDateString("en-US", { timeZone: "UTC" }) })
+        ] })
+      ] }),
       post.tags && post.tags.length > 0 && /* @__PURE__ */ jsx("div", { className: cls(unstyled, styles, "tags", "sk-article-tags"), children: post.tags.map((tag, index) => {
         const tagName = typeof tag === "string" ? tag : tag?.name || "";
         return /* @__PURE__ */ jsxs("a", { href: `${routes.index}?tag=${encodeURIComponent(tagName)}`, className: cls(unstyled, styles, "tag", "sk-article-tag"), children: [
@@ -217,6 +234,10 @@ async function Article({
           tagName
         ] }, `${tagName}-${index}`);
       }) }),
+      post.publication_cta?.label && post.publication_cta.goal && /^(?:https?:\/\/|\/(?!\/))/.test(post.publication_cta.url) && /* @__PURE__ */ jsx("aside", { className: "sk-article-publication-cta", "aria-label": "Next step", children: /* @__PURE__ */ jsxs("a", { href: post.publication_cta.url, "data-sk-article-id": post.id, "data-sk-article-goal": post.publication_cta.goal, style: { display: "inline-flex", alignItems: "center", minHeight: 44, padding: "12px 20px", color: "var(--sk-primary)", border: "1px solid currentColor", borderRadius: 8 }, children: [
+        post.publication_cta.label,
+        " \u2192"
+      ] }) }),
       /* @__PURE__ */ jsx(
         ServiceCallouts,
         {
@@ -349,12 +370,12 @@ async function fetchArticleList(params) {
       next: { revalidate: 60 }
     });
     if (!response.ok) {
-      console.error("[Articles] Failed to fetch posts:", response.statusText);
-      return emptyResult();
+      throw new ArticleUnavailableError(response.status);
     }
     const data = await response.json();
+    if (!Array.isArray(data.posts)) throw new ArticleUnavailableError();
     return {
-      posts: data.posts || [],
+      posts: data.posts,
       pagination: {
         page: data.pagination?.page || 1,
         perPage: data.pagination?.per_page || 12,
@@ -365,13 +386,9 @@ async function fetchArticleList(params) {
       }
     };
   } catch (error) {
-    console.error("[Articles] Error fetching posts:", error);
-    return emptyResult();
+    throw error instanceof ArticleUnavailableError ? error : new ArticleUnavailableError();
   }
 }
-function emptyResult() {
-  return { posts: [], pagination: { page: 1, perPage: 12, total: 0, totalPages: 0, hasNext: false, hasPrev: false } };
-}
 function cls2(unstyled, styles, key, defaultClass, extra) {
   if (unstyled) return styles[key] || void 0;
   const base = styles[key] || defaultClass;
@@ -409,7 +426,7 @@ async function ArticleList({
   const [articleData, categories, { articleListCss }] = await Promise.all([
     fetchArticleList({ apiUrl, apiKey, category, tag, author, featured, search, cluster, page, perPage, orderBy, order, site }),
     showCategoryFilter ? fetchArticleCategories({ apiUrl, apiKey, site }) : Promise.resolve([]),
-    unstyled || children ? Promise.resolve({ articleListCss: "" }) : import('../article-styles-GFXJJDLE.js')
+    unstyled || children ? Promise.resolve({ articleListCss: "" }) : import('../article-styles-AOOVVKXH.js')
   ]);
   if (children) {
     return children({ posts: articleData.posts, pagination: articleData.pagination, categories });
@@ -943,6 +960,9 @@ async function PublicationLayout({
 }) {
   const hasSidebar = showSidebar && layout !== "full-width";
   return /* @__PURE__ */ jsxs("div", { className, children: [
+    /* @__PURE__ */ jsx("style", { children: `.sk-publication-columns { display:grid; gap:48px; grid-template-columns:minmax(0,1fr) 300px; }
+.sk-publication-columns--left { grid-template-columns:300px minmax(0,1fr); }
+@media(max-width:800px) { .sk-publication-columns, .sk-publication-columns--left { grid-template-columns:minmax(0,1fr); gap:32px; } .sk-publication-columns--left > main { grid-row:1; } }` }),
     hero && /* @__PURE__ */ jsx(
       "section",
       {
@@ -990,43 +1010,33 @@ async function PublicationLayout({
           margin: "0 auto",
           padding: "40px 20px"
         },
-        children: /* @__PURE__ */ jsxs(
-          "div",
-          {
-            style: {
-              display: hasSidebar ? "grid" : "block",
-              gridTemplateColumns: hasSidebar ? layout === "sidebar-left" ? "300px 1fr" : "1fr 300px" : void 0,
-              gap: 48
-            },
-            children: [
-              hasSidebar && layout === "sidebar-left" && /* @__PURE__ */ jsx(
-                PublicationSidebar,
-                {
-                  apiUrl,
-                  apiKey,
-                  site,
-                  basePath,
-                  routing,
-                  currentCategory,
-                  ...sidebarProps
-                }
-              ),
-              /* @__PURE__ */ jsx("main", { style: { minWidth: 0 }, children }),
-              hasSidebar && layout === "sidebar-right" && /* @__PURE__ */ jsx(
-                PublicationSidebar,
-                {
-                  apiUrl,
-                  apiKey,
-                  site,
-                  basePath,
-                  routing,
-                  currentCategory,
-                  ...sidebarProps
-                }
-              )
-            ]
-          }
-        )
+        children: /* @__PURE__ */ jsxs("div", { className: hasSidebar ? `sk-publication-columns${layout === "sidebar-left" ? " sk-publication-columns--left" : ""}` : void 0, children: [
+          hasSidebar && layout === "sidebar-left" && /* @__PURE__ */ jsx(
+            PublicationSidebar,
+            {
+              apiUrl,
+              apiKey,
+              site,
+              basePath,
+              routing,
+              currentCategory,
+              ...sidebarProps
+            }
+          ),
+          /* @__PURE__ */ jsx("main", { style: { minWidth: 0 }, children }),
+          hasSidebar && layout === "sidebar-right" && /* @__PURE__ */ jsx(
+            PublicationSidebar,
+            {
+              apiUrl,
+              apiKey,
+              site,
+              basePath,
+              routing,
+              currentCategory,
+              ...sidebarProps
+            }
+          )
+        ] })
       }
     )
   ] });

package/dist/articles/server.d.ts

@@ -1,461 +1,2 @@
-/**
- * @sonordev/site-kit/articles/server
- *
- * Data and metadata helpers only (no React components). For `Article` / `ArticleList`
- * in the App Router, import from `@sonordev/site-kit/articles/server-ui` so Next never
- * treats `getAllArticleSlugs` / `generateArticleStaticParams` as client code.
- */
-import type { Metadata } from 'next';
-import type { Article as ArticleRecord, ArticleAuthor, TopicCluster, ClusterNavigation } from './types';
-import { sanitizeExcerpt } from './excerpt';
-import { type PublicationRoutingOptions } from './routes';
-import { type NewsSitemapOptions } from './news-sitemap';
-export { sanitizeExcerpt };
-export declare const SEO_LIMITS: {
-    readonly title: {
-        readonly min: 30;
-        readonly max: 60;
-        readonly recommended: 55;
-    };
-    readonly metaDescription: {
-        readonly min: 120;
-        readonly max: 160;
-        readonly recommended: 155;
-    };
-    readonly excerpt: {
-        readonly min: 100;
-        readonly max: 300;
-        readonly recommended: 200;
-    };
-    readonly slug: {
-        readonly max: 75;
-    };
-    readonly focusKeyphrase: {
-        readonly min: 2;
-        readonly max: 4;
-        readonly words: true;
-    };
-};
-export interface SeoValidationResult {
-    field: string;
-    value: string;
-    length: number;
-    limit: {
-        min?: number;
-        max: number;
-        recommended?: number;
-    };
-    status: 'good' | 'warning' | 'error';
-    message: string;
-}
-/**
- * Validate SEO title (60 chars max, keyword-first recommended)
- */
-export declare function validateSeoTitle(title: string, focusKeyphrase?: string): SeoValidationResult;
-/**
- * Validate meta description (150-160 chars, benefit-driven)
- */
-export declare function validateMetaDescription(description: string, focusKeyphrase?: string): SeoValidationResult;
-/**
- * Full SEO validation for an article
- */
-export declare function validateArticleSeo(post: Partial<ArticleRecord>): SeoValidationResult[];
-/**
- * Fetch an article by slug (server-side)
- *
- * @param options.site - Sub-site host override. Omit to resolve from
- *   NEXT_PUBLIC_SITE_URL.
- */
-export declare function getArticle(slug: string, options?: {
-    site?: string;
-}): Promise<ArticleRecord | null>;
-/**
- * Fetch an article by slug, or answer 404 when there isn't one.
- *
- * `getArticle` returns null for a mistyped or deleted slug, and the page
- * used to carry on rendering a "not found" message with HTTP 200 and an
- * indexable title: a soft 404 on every bad post URL. This calls Next's
- * `notFound()` instead, so the
- * route answers 404 with `noindex`.
- *
- * Call it from `generateMetadata` (or the page) before rendering `Article`:
- * metadata resolves before anything streams, so the status is a real 404.
- * The fetch is the same one `Article` and `generateArticleMetadata` make,
- * and Next dedupes it within the render.
- *
- * @example
- * ```tsx
- * export async function generateMetadata({ params }) {
- *   const { slug } = await params
- *   await requireArticle(slug)
- *   return generateArticleMetadata(slug, { siteName: 'Acme' })
- * }
- * ```
- */
-export declare function requireArticle(slug: string, options?: {
-    site?: string;
-}): Promise<ArticleRecord>;
-/**
- * Fetch all article slugs for static generation
- */
-export declare function getAllArticleSlugs(): Promise<{
-    slug: string;
-    id?: string;
-    last_modified?: string;
-    article_type?: string;
-}[]>;
-/**
- * Fetch article categories
- */
-export declare function getArticleCategories(options?: {
-    site?: string;
-}): Promise<{
-    name: string;
-    slug: string;
-    post_count: number;
-}[]>;
-export interface PublicationMetadataOptions extends PublicationRoutingOptions {
-    /** Site name for og:site_name */
-    siteName?: string;
-    /** Base URL of the site */
-    siteUrl?: string;
-    /** URL path prefix for publication index and posts (default `/article`, e.g. `/insights`) */
-    /** Default OG image */
-    defaultImage?: string;
-    /** Twitter handle */
-    twitterHandle?: string;
-}
-export interface ArticleMetadataOptions extends PublicationMetadataOptions {
-    /**
-     * Declare the featured image (or `defaultImage`) as `openGraph.images` and
-     * `twitter.images`. Default true.
-     *
-     * Pass false when the post route has its own card, an
-     * `opengraph-image.tsx` beside the page. Next lets declared images beat
-     * that file, so leaving them in silently swaps the post's card for the raw
-     * photo. With false the `images` keys are left out entirely, not set to
-     * undefined: Next checks `hasOwnProperty('images')`, so even an undefined
-     * value hides the card.
-     */
-    images?: boolean;
-    /**
-     * What to do when the post doesn't exist. Default true: call Next's
-     * `notFound()`, so the route answers 404. False returns placeholder
-     * metadata marked `noindex` instead, for a page that renders its own
-     * missing-post state.
-     */
-    notFound?: boolean;
-}
-/**
- * Generate metadata for an article page
- */
-export declare function generateArticleMetadata(slug: string, options?: ArticleMetadataOptions): Promise<Metadata>;
-/**
- * Generate metadata for the publication index page
- */
-export declare function generatePublicationMetadata(options: PublicationMetadataOptions & {
-    title?: string;
-    description?: string;
-}): Metadata;
-/**
- * Generate metadata for a category page
- */
-export declare function generateArticleCategoryMetadata(categoryName: string, options?: PublicationMetadataOptions & {
-    categorySlug?: string;
-}): Metadata;
-/**
- * What Next passes to a route's `generateStaticParams`: the parent segments'
- * params. The publication helpers ignore it; it's typed so they can be exported
- * directly as `generateStaticParams`.
- */
-export interface NextStaticParamsProps {
-    params: unknown;
-}
-/**
- * Generate static params for article pages.
- *
- * Export it directly for the default `/article/[slug]` routes:
- *
- *   export const generateStaticParams = generateArticleStaticParams
- *
- * With routing options, wrap it:
- *
- *   export function generateStaticParams() {
- *     return generateArticleStaticParams(routing)
- *   }
- */
-export declare function generateArticleStaticParams(options?: PublicationRoutingOptions): Promise<{
-    slug: string;
-    category?: string;
-}[]>;
-export declare function generateArticleStaticParams(props: NextStaticParamsProps): Promise<{
-    slug: string;
-    category?: string;
-}[]>;
-/**
- * Generate static params for category pages. Takes no arguments, so it can be
- * exported directly:
- *
- *   export const generateStaticParams = generateCategoryStaticParams
- */
-export declare function generateCategoryStaticParams(): Promise<{
-    category: string;
-}[]>;
-interface SitemapEntry {
-    url: string;
-    lastModified?: Date;
-    changeFrequency?: 'always' | 'hourly' | 'daily' | 'weekly' | 'monthly' | 'yearly' | 'never';
-    priority?: number;
-    /** Image sitemap entries; Next's MetadataRoute.Sitemap renders them as <image:image>. */
-    images?: string[];
-}
-/**
- * Generate sitemap entries for articles
- */
-export interface ArticleSitemapOptions extends PublicationRoutingOptions {
-    includeCategories?: boolean;
-    includeClusters?: boolean;
-}
-export declare function generateArticleSitemap(siteUrl: string, options?: ArticleSitemapOptions): Promise<SitemapEntry[]>;
-/**
- * Google News sitemap XML for posts published in the last two days. Serve it
- * from a route (app/news-sitemap.xml/route.ts) and list it in robots.txt.
- */
-export declare function generateNewsSitemap(options: NewsSitemapOptions & {
-    site?: string;
-}): Promise<string>;
-/**
- * Generate JSON-LD schema for an article
- */
-export declare function generateArticleSchema(post: ArticleRecord, options?: PublicationRoutingOptions & {
-    siteUrl?: string;
-    siteName?: string;
-    logoUrl?: string;
-}): object;
-/**
- * Generate JSON-LD schema for publication index/listing page
- */
-export declare function generateArticleListSchema(options?: PublicationRoutingOptions & {
-    siteUrl?: string;
-    siteName?: string;
-    description?: string;
-}): object;
-/**
- * Generate standalone FAQ schema (great for PAA inclusion)
- */
-export declare function generateFaqSchema(faqItems: {
-    question: string;
-    answer: string;
-}[]): object | null;
-export interface HowToStep {
-    name: string;
-    text: string;
-    image?: string;
-    url?: string;
-}
-/**
- * Generate HowTo schema for step-by-step posts
- */
-export declare function generateHowToSchema(post: ArticleRecord, steps: HowToStep[], options?: PublicationRoutingOptions & {
-    siteUrl?: string;
-}): object;
-export interface RssFeedOptions extends PublicationRoutingOptions {
-    siteUrl: string;
-    siteName: string;
-    description?: string;
-    language?: string;
-    copyright?: string;
-    managingEditor?: string;
-    webMaster?: string;
-    ttl?: number;
-    imageUrl?: string;
-    /** Most recent posts to include. Defaults to FEED_DEFAULT_ITEMS (20); older posts stay in the sitemap. */
-    maxItems?: number;
-}
-/**
- * Fetch all published articles for RSS feed.
- *
- * Paginates with `per_page`/`page` — the only pagination params the deployed
- * controller reads — accumulating up to FEED_MAX_POSTS. A mid-loop failure
- * returns what was accumulated so far: a partial feed beats an empty one.
- */
-export declare function getAllArticles(options?: {
-    maxPosts?: number; /** Sub-site host override (see getArticle). */
-    site?: string;
-}): Promise<ArticleRecord[]>;
-/**
- * Generate RSS 2.0 feed XML
- */
-export declare function generateRssFeed(options: RssFeedOptions): Promise<string>;
-/**
- * Generate Atom feed XML
- */
-export declare function generateAtomFeed(options: RssFeedOptions): Promise<string>;
-/**
- * Fetch all active topic clusters for the project.
- * Uses the real cluster data from Sonor API (not heuristic-based).
- */
-export declare function getTopicClusters(options?: {
-    site?: string;
-}): Promise<TopicCluster[]>;
-/**
- * Fetch a single topic cluster with its pillar and support articles.
- */
-export declare function getTopicCluster(slug: string, options?: {
-    site?: string;
-}): Promise<TopicCluster | null>;
-/**
- * Get cluster navigation context for an article.
- * Returns the cluster name, pillar link, and sibling articles.
- */
-export declare function getClusterNavigation(post: ArticleRecord): ClusterNavigation | null;
-/**
- * Fetch posts by category for topic cluster organization
- */
-export declare function getPostsByCategory(categorySlug: string, options?: {
-    site?: string;
-}): Promise<ArticleRecord[]>;
-/**
- * Generate ItemList schema for a cluster's pillar page.
- * Wraps supporting posts as a structured list Google can parse.
- */
-export declare function generateClusterItemListSchema(cluster: TopicCluster, options?: PublicationRoutingOptions & {
-    siteUrl?: string;
-}): object;
-/**
- * Generate Article schema with cluster relationship (isPartOf / hasPart).
- * - Support articles get `isPartOf` pointing to the pillar.
- * - Pillar articles get `hasPart` listing all supports.
- */
-export declare function generateClusterArticleSchema(post: ArticleRecord, cluster: TopicCluster, options?: PublicationRoutingOptions & {
-    siteUrl?: string;
-    siteName?: string;
-    logoUrl?: string;
-}): object;
-/**
- * Generate BreadcrumbList schema for a cluster-linked post.
- * Path: Home > Article > Cluster > Article
- */
-export declare function generateClusterBreadcrumbSchema(post: ArticleRecord, cluster: TopicCluster, options?: PublicationRoutingOptions & {
-    siteUrl?: string;
-    siteName?: string;
-}): object;
-/**
- * Generate CollectionPage schema for a cluster landing page.
- */
-export declare function generateClusterLandingSchema(cluster: TopicCluster, options?: PublicationRoutingOptions & {
-    siteUrl?: string;
-    siteName?: string;
-}): object;
-/**
- * Generate metadata for a cluster landing page (Next.js generateMetadata).
- */
-export declare function generateClusterPageMetadata(clusterSlug: string, options?: PublicationRoutingOptions & {
-    siteName?: string;
-    siteUrl?: string;
-}): Promise<{
-    title?: undefined;
-    description?: undefined;
-    openGraph?: undefined;
-} | {
-    title: string;
-    description: string;
-    openGraph: {
-        title: string;
-        description: string;
-        url: string;
-        type: string;
-    };
-}>;
-/**
- * Generate "Related Insights" section data
- */
-export declare function getRelatedInsights(currentSlug: string, options?: {
-    limit?: number;
-    category?: string; /** Sub-site host override (see getArticle). */
-    site?: string;
-}): Promise<ArticleRecord[]>;
-/**
- * Generate BreadcrumbList schema for article navigation
- */
-export declare function generateBreadcrumbSchema(post: ArticleRecord, options?: PublicationRoutingOptions & {
-    siteUrl?: string;
-    siteName?: string;
-}): object;
-/**
- * Generate all relevant schemas for an article in a single array
- * This is the recommended way to include multiple schemas.
- * When post has E-E-A-T schema (post.schema), use it instead of generating Article/FAQ.
- */
-export declare function generateAllArticleSchemas(post: ArticleRecord, options?: PublicationRoutingOptions & {
-    siteUrl?: string;
-    siteName?: string;
-    logoUrl?: string;
-}): object[];
-/**
- * Fetch a single author by slug
- */
-export declare function getAuthorBySlug(slug: string, options?: {
-    site?: string;
-}): Promise<ArticleAuthor | null>;
-/**
- * Fetch an author's posts by slug.
- *
- * `offset` pages through the controller's existing offset support. Older API
- * versions return a stripped `{name, slug}` author on this endpoint; when
- * that shape is detected the full author row is hydrated via getAuthorBySlug
- * (both fetches revalidate:60, so the extra hop is cached and disappears once
- * the API returns the full row itself).
- */
-export declare function getAuthorPosts(slug: string, limit?: number, offset?: number, options?: {
-    site?: string;
-}): Promise<{
-    author: ArticleAuthor | null;
-    posts: ArticleRecord[];
-    total: number;
-}>;
-/**
- * Fetch all author slugs for static generation
- */
-export declare function getAllAuthorSlugs(): Promise<{
-    slug: string;
-}[]>;
-/**
- * Generate static params for author pages. Takes no arguments, so it can be
- * exported directly:
- *
- *   export const generateStaticParams = generateAuthorStaticParams
- */
-export declare function generateAuthorStaticParams(): Promise<{
-    slug: string;
-}[]>;
-/**
- * Generate Next.js Metadata for an author page
- */
-export declare function generateAuthorPageMetadata(author: ArticleAuthor, options?: PublicationRoutingOptions & {
-    siteUrl?: string;
-    siteName?: string;
-}): Metadata;
-/**
- * Author JSON-LD: `generateAuthorSchema` (the author page's ProfilePage with
- * the Person as mainEntity), `generateAuthorPersonSchema` (the bare Person for
- * embedding), `generateArticleAuthorNode` (an article byline) and
- * `authorEntityId` (the Person @id rule).
- *
- * The implementation lives in `./author-schema` because it is pure, and
- * `AuthorPage` — which is exported from the client-stamped `articles` barrel —
- * needs it. Importing it from here instead would drag this entire server module
- * into the browser bundle. Re-exported so `@sonordev/site-kit/articles/server`
- * keeps its existing public API.
- */
-export { authorEntityId, generateArticleAuthorNode, generateAuthorPersonSchema, generateAuthorSchema, withArticleAuthorIdentity, type AuthorSchemaOptions, } from './author-schema';
-/** Sonor article document shape (alias of `Article` from `./types`) */
-export type { Article as ArticleRecord } from './types';
-export { articleCategorySlug, createPublicationRoutes, resolveArticleUrl, resolvePublicationUrl } from './routes';
-export type { ArticleRoutePost, PublicationRoutingOptions } from './routes';
-export { resolveArticleArtwork } from './artwork';
-export { wrapArticleTables, articleTableCss } from './article-tables';
-export { insertArticlePhotos, articlePhotoCss } from './article-photos';
-export type { ArticleEditorialPhoto } from './types';
-export { FEED_DEFAULT_ITEMS, NEWS_SITEMAP_MAX_URLS, NEWS_SITEMAP_WINDOW_MS, buildNewsSitemapXml, cdata, recentNewsPosts } from './news-sitemap';
-export type { NewsSitemapOptions, NewsSitemapPost } from './news-sitemap';
+/** @deprecated Import from @sonordev/press-kit instead. Compatibility build uses the same canonical source. */
+export * from '../press-kit/articles/server-core';