@sonordev/site-kit 8.1.0 → 8.3.0

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 {};

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

@@ -0,0 +1,56 @@
+/**
+ * @sonordev/press-kit/articles - Service Callout / CTA Component
+ *
+ * Renders a promotional call-to-action section within articles.
+ * Automatically generated by Signal AI during article creation, linking
+ * article content to the business's relevant services.
+ *
+ * Two variants:
+ * - 'featured' (default): Full-width gradient banner with button
+ * - 'inline': Compact card with icon accent
+ *
+ * Uses site-kit brand tokens (--sk-primary, --sk-bg, etc.) for theming.
+ * Supports full Tailwind override via `styles` prop.
+ *
+ * @example
+ * ```tsx
+ * <ServiceCallout
+ *   title="Ready to build your MVP?"
+ *   description="Our team specializes in lean SaaS builds."
+ *   cta="Get Started"
+ *   url="/services/application-development"
+ * />
+ * ```
+ */
+import React from 'react';
+export interface ServiceCalloutProps {
+    title: string;
+    description?: string;
+    cta?: string;
+    url: string;
+    variant?: 'featured' | 'inline';
+    /** Override default styles with Tailwind classes */
+    styles?: {
+        wrapper?: string;
+        title?: string;
+        description?: string;
+        button?: string;
+    };
+    /** Strip all default styles (BYO Tailwind) */
+    unstyled?: boolean;
+}
+export declare function ServiceCallout({ title, description, cta, url, variant, styles, unstyled, }: ServiceCalloutProps): React.JSX.Element;
+/**
+ * Renders all service callouts for an article.
+ * First callout uses 'featured' variant, subsequent use 'inline'.
+ */
+export declare function ServiceCallouts({ callouts, styles, unstyled, }: {
+    callouts: Array<{
+        title: string;
+        description?: string;
+        cta?: string;
+        url: string;
+    }>;
+    styles?: ServiceCalloutProps['styles'];
+    unstyled?: boolean;
+}): React.JSX.Element | null;

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

@@ -0,0 +1,6 @@
+/**
+ * @sonordev/press-kit/articles - Table of Contents Component
+ */
+import React from 'react';
+import type { TableOfContentsProps } from './types';
+export declare function TableOfContents({ content, className, maxDepth, }: TableOfContentsProps): React.JSX.Element | null;

package/dist/press-kit/articles/article-photos.d.ts

@@ -0,0 +1,9 @@
+import type { ArticleEditorialPhoto } from './types';
+/**
+ * Inserts approved public photo snapshots at explicitly authored placements.
+ * Missing/duplicate headings, unmatched sections and photos already in the body
+ * are skipped. Never changes the author's paragraphs, headings or other markup.
+ * This is a layout transform, not a sanitizer for the original article HTML.
+ */
+export declare function insertArticlePhotos(html: string, photos?: ArticleEditorialPhoto[] | null): string;
+export declare const articlePhotoCss = "\n.sk-article-photo { margin: 2em 0; max-width: 100%; }\n.sk-article-photo img { display: block; width: 100%; max-width: 100%; height: auto; border-radius: var(--sk-radius, 0.75rem); }\n.sk-article-photo figcaption { margin-top: 0.65em; color: var(--sk-text-secondary, inherit); font-size: 0.875em; line-height: 1.5; overflow-wrap: anywhere; }\n";

package/dist/press-kit/articles/article-styles.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Scoped CSS for Article and ArticleList default rendering.
+ *
+ * Injected via `<style>` in the server component output so consumers
+ * get a polished article with zero configuration.
+ *
+ * All colours use `--sk-*` CSS custom properties with `color-mix()` fallbacks
+ * that adapt to both light and dark host sites. The host can set:
+ *
+ *   --sk-primary          Brand accent (links, highlights)
+ *   --sk-bg               Page background
+ *   --sk-bg-elevated      Card / elevated surface background
+ *   --sk-text-primary     Main text
+ *   --sk-text-secondary   Subdued text
+ *   --sk-text-tertiary    Faint text / meta
+ *   --sk-surface-border   Subtle border color
+ *
+ * If none are set the defaults produce a clean neutral light-mode look.
+ */
+export declare const articleCss: string;
+export declare const articleListCss: string;

package/dist/press-kit/articles/article-tables.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Server-rendered table scrolling. Keep the author's table markup intact so
+ * captions, header associations, links and table semantics survive unchanged.
+ */
+/**
+ * Single source of truth for default article table wrappers. Safe to call twice;
+ * already wrapped tables and HTML examples are left alone. This is a layout
+ * transform, not an HTML sanitizer: content still follows the host's trust policy.
+ */
+export declare function wrapArticleTables(html: string): string;
+/** Native overflow only when content needs it; small tables retain their layout. */
+export declare const articleTableCss: string;

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

@@ -0,0 +1,13 @@
+import type { CSSProperties } from 'react';
+import type { Article } from './types';
+export interface ArticleArtwork {
+    src: string | undefined;
+    alt: string;
+    composed: boolean;
+}
+type ArtworkSource = Pick<Article, 'title' | 'featured_image' | 'featured_image_alt' | 'editorial_image' | 'editorial_image_alt'>;
+/** Single source of truth for article artwork versus complete promotional cards. */
+export declare function resolveArticleArtwork(post: ArtworkSource, placement?: 'article' | 'card'): ArticleArtwork;
+/** Preserve generated text and graphics across every stock card surface. */
+export declare function articleArtworkImageStyle(artwork: ArticleArtwork): CSSProperties | undefined;
+export {};