@sonordev/site-kit 1.2.7

package/dist/analytics/index.mjs

@@ -0,0 +1,71 @@
+'use client';
+import { useAnalytics } from '../chunk-M2T6R7BA.mjs';
+export { AnalyticsProvider, WebVitals, useAnalytics, useTrackEvent } from '../chunk-M2T6R7BA.mjs';
+import '../chunk-4XPGGLVP.mjs';
+import { useCallback, useEffect } from 'react';
+
+function useContactTracking(options = {}) {
+  const { autoTrack = true, debug = false } = options;
+  const { trackConversion } = useAnalytics();
+  const trackPhoneClick = useCallback((phoneNumber, metadata) => {
+    if (debug) console.log("[Analytics] Phone click:", phoneNumber);
+    trackConversion({
+      type: "phone_call",
+      metadata: {
+        phoneNumber: phoneNumber.replace(/\D/g, ""),
+        // Normalize to digits
+        rawNumber: phoneNumber,
+        ...metadata
+      }
+    });
+  }, [trackConversion, debug]);
+  const trackEmailClick = useCallback((email, metadata) => {
+    if (debug) console.log("[Analytics] Email click:", email);
+    trackConversion({
+      type: "email_click",
+      metadata: {
+        email,
+        ...metadata
+      }
+    });
+  }, [trackConversion, debug]);
+  useEffect(() => {
+    if (!autoTrack || typeof document === "undefined") return;
+    const handleClick = (e) => {
+      const target = e.target;
+      const anchor = target.closest("a");
+      if (!anchor) return;
+      const href = anchor.getAttribute("href");
+      if (!href) return;
+      if (href.startsWith("tel:")) {
+        const phone = href.replace("tel:", "").trim();
+        trackPhoneClick(phone, {
+          linkText: anchor.textContent?.trim(),
+          source: "auto"
+        });
+      } else if (href.startsWith("mailto:")) {
+        const email = href.replace("mailto:", "").split("?")[0].trim();
+        trackEmailClick(email, {
+          linkText: anchor.textContent?.trim(),
+          source: "auto"
+        });
+      }
+    };
+    document.addEventListener("click", handleClick, { capture: true });
+    return () => {
+      document.removeEventListener("click", handleClick, { capture: true });
+    };
+  }, [autoTrack, trackPhoneClick, trackEmailClick]);
+  return {
+    trackPhoneClick,
+    trackEmailClick
+  };
+}
+function ContactTracking({ debug = false }) {
+  useContactTracking({ autoTrack: true, debug });
+  return null;
+}
+
+export { ContactTracking, useContactTracking };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/analytics/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/analytics/useContactTracking.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["/**\n * @sonordev/site-kit/analytics - Contact Tracking Hook\n * \n * Tracks phone calls and email clicks as conversions.\n * Use this hook to automatically track tel: and mailto: links,\n * or manually track contact interactions.\n */\n\n'use client'\n\nimport { useCallback, useEffect } from 'react'\nimport { useAnalytics } from './AnalyticsProvider'\n\nexport interface UseContactTrackingOptions {\n  /** Automatically track all tel: and mailto: links (default: true) */\n  autoTrack?: boolean\n  /** Debug mode - logs events to console */\n  debug?: boolean\n}\n\nexport interface ContactTrackingReturn {\n  /** Manually track a phone call click */\n  trackPhoneClick: (phoneNumber: string, metadata?: Record<string, unknown>) => void\n  /** Manually track an email click */\n  trackEmailClick: (email: string, metadata?: Record<string, unknown>) => void\n}\n\n/**\n * Hook for tracking phone and email contact interactions as conversions.\n * \n * @example\n * ```tsx\n * // Auto-track all tel: and mailto: links\n * useContactTracking()\n * \n * // Manual tracking\n * const { trackPhoneClick, trackEmailClick } = useContactTracking()\n * trackPhoneClick('513-555-1234')\n * trackEmailClick('hello@example.com')\n * ```\n */\nexport function useContactTracking(options: UseContactTrackingOptions = {}): ContactTrackingReturn {\n  const { autoTrack = true, debug = false } = options\n  const { trackConversion } = useAnalytics()\n  \n  const trackPhoneClick = useCallback((phoneNumber: string, metadata?: Record<string, unknown>) => {\n    if (debug) console.log('[Analytics] Phone click:', phoneNumber)\n    \n    trackConversion({\n      type: 'phone_call',\n      metadata: {\n        phoneNumber: phoneNumber.replace(/\\D/g, ''), // Normalize to digits\n        rawNumber: phoneNumber,\n        ...metadata,\n      },\n    })\n  }, [trackConversion, debug])\n  \n  const trackEmailClick = useCallback((email: string, metadata?: Record<string, unknown>) => {\n    if (debug) console.log('[Analytics] Email click:', email)\n    \n    trackConversion({\n      type: 'email_click',\n      metadata: {\n        email,\n        ...metadata,\n      },\n    })\n  }, [trackConversion, debug])\n  \n  // Auto-track tel: and mailto: links\n  useEffect(() => {\n    if (!autoTrack || typeof document === 'undefined') return\n    \n    const handleClick = (e: MouseEvent) => {\n      const target = e.target as HTMLElement\n      const anchor = target.closest('a')\n      if (!anchor) return\n      \n      const href = anchor.getAttribute('href')\n      if (!href) return\n      \n      if (href.startsWith('tel:')) {\n        const phone = href.replace('tel:', '').trim()\n        trackPhoneClick(phone, {\n          linkText: anchor.textContent?.trim(),\n          source: 'auto',\n        })\n      } else if (href.startsWith('mailto:')) {\n        const email = href.replace('mailto:', '').split('?')[0].trim()\n        trackEmailClick(email, {\n          linkText: anchor.textContent?.trim(),\n          source: 'auto',\n        })\n      }\n    }\n    \n    document.addEventListener('click', handleClick, { capture: true })\n    \n    return () => {\n      document.removeEventListener('click', handleClick, { capture: true })\n    }\n  }, [autoTrack, trackPhoneClick, trackEmailClick])\n  \n  return {\n    trackPhoneClick,\n    trackEmailClick,\n  }\n}\n\n/**\n * Component wrapper for contact tracking\n * Simply include this component to auto-track all tel: and mailto: links\n * \n * @example\n * ```tsx\n * <ContactTracking />\n * ```\n */\nexport function ContactTracking({ debug = false }: { debug?: boolean }) {\n  useContactTracking({ autoTrack: true, debug })\n  return null\n}\n"]}

package/dist/api-CWtoFJCO.d.mts

@@ -0,0 +1,137 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import React__default from 'react';
+
+interface ManagedImageData {
+    id: string;
+    slot_id: string;
+    page_path: string | null;
+    file_id: string | null;
+    external_url: string | null;
+    alt_text: string | null;
+    title: string | null;
+    caption: string | null;
+    focal_point_x: number;
+    focal_point_y: number;
+    aspect_ratio: string | null;
+    public_url?: string;
+    is_placeholder: boolean;
+}
+interface ImageFile {
+    id: string;
+    filename: string;
+    storage_path: string;
+    mime_type: string;
+    file_size: number;
+    folder_path: string | null;
+    public_url?: string;
+}
+interface ManagedImageProps {
+    /** API key for Portal API */
+    apiKey?: string;
+    /** API URL (defaults to https://api.uptrademedia.com) */
+    apiUrl?: string;
+    /** Unique slot identifier (e.g., 'hero-background', 'about-team-1') */
+    slotId: string;
+    /** Page path for page-specific slots (defaults to current path) */
+    pagePath?: string;
+    /** Fallback alt text if not set in Portal */
+    alt?: string;
+    /** CSS class names */
+    className?: string;
+    /** Image width */
+    width?: number | string;
+    /** Image height */
+    height?: number | string;
+    /** CSS object-fit property */
+    objectFit?: 'cover' | 'contain' | 'fill' | 'none' | 'scale-down';
+    /** Fallback image URL when no image assigned */
+    fallback?: string;
+    /** Custom placeholder component */
+    placeholder?: React__default.ReactNode;
+    /** Called when image loads */
+    onLoad?: () => void;
+    /** Called on error */
+    onError?: (error: Error) => void;
+    /** Priority loading (Next.js Image optimization) */
+    priority?: boolean;
+    /** Additional styles */
+    style?: React__default.CSSProperties;
+    /** Enable dev picker even outside dev mode */
+    forceDevMode?: boolean;
+}
+declare function ManagedImage({ apiKey, apiUrl, slotId, pagePath, alt, className, width, height, objectFit, fallback, placeholder, onLoad, onError, priority, style, forceDevMode, }: ManagedImageProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * Images API functions
+ *
+ * All functions use Portal API with API key authentication.
+ * Never makes direct Supabase calls.
+ */
+
+interface ImageApiConfig {
+    apiUrl: string;
+    apiKey: string;
+}
+/**
+ * Fetch a managed image for a specific slot
+ */
+declare function fetchManagedImage(config: ImageApiConfig, slotId: string, pagePath?: string): Promise<{
+    image: ManagedImageData | null;
+    is_placeholder: boolean;
+}>;
+/**
+ * Fetch all managed images for the project
+ */
+declare function fetchManagedImages(config: ImageApiConfig, options?: {
+    pagePath?: string;
+    category?: string;
+    includePlaceholders?: boolean;
+}): Promise<{
+    images: ManagedImageData[];
+}>;
+/**
+ * List available image files in the project
+ */
+declare function listImageFiles(config: ImageApiConfig, options?: {
+    folder?: string;
+    search?: string;
+}): Promise<{
+    files: ImageFile[];
+    folders: string[];
+}>;
+/**
+ * Upload a new image
+ */
+declare function uploadImage(config: ImageApiConfig, file: File, options?: {
+    slotId?: string;
+    pagePath?: string;
+    folder?: string;
+    altText?: string;
+}): Promise<{
+    file: ImageFile;
+    image?: ManagedImageData;
+}>;
+/**
+ * Assign an existing file to an image slot
+ */
+declare function assignImageToSlot(config: ImageApiConfig, slotId: string, options: {
+    fileId?: string;
+    externalUrl?: string;
+    pagePath?: string;
+    altText?: string;
+    title?: string;
+    caption?: string;
+    focalPointX?: number;
+    focalPointY?: number;
+    aspectRatio?: string;
+}): Promise<{
+    image: ManagedImageData;
+}>;
+/**
+ * Clear an image from a slot (keeps the file)
+ */
+declare function clearImageSlot(config: ImageApiConfig, slotId: string, pagePath?: string): Promise<{
+    success: boolean;
+}>;
+
+export { type ImageFile as I, ManagedImage as M, type ManagedImageProps as a, type ManagedImageData as b, fetchManagedImages as c, assignImageToSlot as d, clearImageSlot as e, fetchManagedImage as f, type ImageApiConfig as g, listImageFiles as l, uploadImage as u };

package/dist/api-CWtoFJCO.d.ts

@@ -0,0 +1,137 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import React__default from 'react';
+
+interface ManagedImageData {
+    id: string;
+    slot_id: string;
+    page_path: string | null;
+    file_id: string | null;
+    external_url: string | null;
+    alt_text: string | null;
+    title: string | null;
+    caption: string | null;
+    focal_point_x: number;
+    focal_point_y: number;
+    aspect_ratio: string | null;
+    public_url?: string;
+    is_placeholder: boolean;
+}
+interface ImageFile {
+    id: string;
+    filename: string;
+    storage_path: string;
+    mime_type: string;
+    file_size: number;
+    folder_path: string | null;
+    public_url?: string;
+}
+interface ManagedImageProps {
+    /** API key for Portal API */
+    apiKey?: string;
+    /** API URL (defaults to https://api.uptrademedia.com) */
+    apiUrl?: string;
+    /** Unique slot identifier (e.g., 'hero-background', 'about-team-1') */
+    slotId: string;
+    /** Page path for page-specific slots (defaults to current path) */
+    pagePath?: string;
+    /** Fallback alt text if not set in Portal */
+    alt?: string;
+    /** CSS class names */
+    className?: string;
+    /** Image width */
+    width?: number | string;
+    /** Image height */
+    height?: number | string;
+    /** CSS object-fit property */
+    objectFit?: 'cover' | 'contain' | 'fill' | 'none' | 'scale-down';
+    /** Fallback image URL when no image assigned */
+    fallback?: string;
+    /** Custom placeholder component */
+    placeholder?: React__default.ReactNode;
+    /** Called when image loads */
+    onLoad?: () => void;
+    /** Called on error */
+    onError?: (error: Error) => void;
+    /** Priority loading (Next.js Image optimization) */
+    priority?: boolean;
+    /** Additional styles */
+    style?: React__default.CSSProperties;
+    /** Enable dev picker even outside dev mode */
+    forceDevMode?: boolean;
+}
+declare function ManagedImage({ apiKey, apiUrl, slotId, pagePath, alt, className, width, height, objectFit, fallback, placeholder, onLoad, onError, priority, style, forceDevMode, }: ManagedImageProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * Images API functions
+ *
+ * All functions use Portal API with API key authentication.
+ * Never makes direct Supabase calls.
+ */
+
+interface ImageApiConfig {
+    apiUrl: string;
+    apiKey: string;
+}
+/**
+ * Fetch a managed image for a specific slot
+ */
+declare function fetchManagedImage(config: ImageApiConfig, slotId: string, pagePath?: string): Promise<{
+    image: ManagedImageData | null;
+    is_placeholder: boolean;
+}>;
+/**
+ * Fetch all managed images for the project
+ */
+declare function fetchManagedImages(config: ImageApiConfig, options?: {
+    pagePath?: string;
+    category?: string;
+    includePlaceholders?: boolean;
+}): Promise<{
+    images: ManagedImageData[];
+}>;
+/**
+ * List available image files in the project
+ */
+declare function listImageFiles(config: ImageApiConfig, options?: {
+    folder?: string;
+    search?: string;
+}): Promise<{
+    files: ImageFile[];
+    folders: string[];
+}>;
+/**
+ * Upload a new image
+ */
+declare function uploadImage(config: ImageApiConfig, file: File, options?: {
+    slotId?: string;
+    pagePath?: string;
+    folder?: string;
+    altText?: string;
+}): Promise<{
+    file: ImageFile;
+    image?: ManagedImageData;
+}>;
+/**
+ * Assign an existing file to an image slot
+ */
+declare function assignImageToSlot(config: ImageApiConfig, slotId: string, options: {
+    fileId?: string;
+    externalUrl?: string;
+    pagePath?: string;
+    altText?: string;
+    title?: string;
+    caption?: string;
+    focalPointX?: number;
+    focalPointY?: number;
+    aspectRatio?: string;
+}): Promise<{
+    image: ManagedImageData;
+}>;
+/**
+ * Clear an image from a slot (keeps the file)
+ */
+declare function clearImageSlot(config: ImageApiConfig, slotId: string, pagePath?: string): Promise<{
+    success: boolean;
+}>;
+
+export { type ImageFile as I, ManagedImage as M, type ManagedImageProps as a, type ManagedImageData as b, fetchManagedImages as c, assignImageToSlot as d, clearImageSlot as e, fetchManagedImage as f, type ImageApiConfig as g, listImageFiles as l, uploadImage as u };

package/dist/blog/index.d.mts

@@ -0,0 +1,305 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import React__default from 'react';
+import { B as BlogPost$1, T as TocItem, a as BlogListResult, b as BlogCategory, A as AuthorCardProps, c as TableOfContentsProps } from '../types-D08004rU.mjs';
+export { k as BlogAnalytics, d as BlogAuthor, f as BlogListOptions, i as BlogListProps, j as BlogListRenderProps, g as BlogPostProps, h as BlogPostRenderProps, e as BlogTag, R as RelatedPostsProps } from '../types-D08004rU.mjs';
+
+interface BlogPostStyles {
+    /** Article wrapper */
+    article?: string;
+    /** Header section */
+    header?: string;
+    /** Breadcrumb navigation */
+    breadcrumb?: string;
+    /** Breadcrumb link */
+    breadcrumbLink?: string;
+    /** Post title (h1) */
+    title?: string;
+    /** Post subtitle */
+    subtitle?: string;
+    /** Meta info row */
+    meta?: string;
+    /** Meta item */
+    metaItem?: string;
+    /** Featured image wrapper */
+    featuredImageWrapper?: string;
+    /** Featured image */
+    featuredImage?: string;
+    /** Content layout (grid with TOC) */
+    contentLayout?: string;
+    /** Main content wrapper */
+    content?: string;
+    /** Table of contents sidebar */
+    tocSidebar?: string;
+    /** TOC title */
+    tocTitle?: string;
+    /** TOC list */
+    tocList?: string;
+    /** TOC list item */
+    tocItem?: string;
+    /** TOC link */
+    tocLink?: string;
+    /** Tags container */
+    tags?: string;
+    /** Individual tag */
+    tag?: string;
+    /** FAQ section */
+    faqSection?: string;
+    /** FAQ title */
+    faqTitle?: string;
+    /** FAQ item container */
+    faqItem?: string;
+    /** FAQ question (summary) */
+    faqQuestion?: string;
+    /** FAQ answer */
+    faqAnswer?: string;
+    /** Author card section */
+    authorCard?: string;
+    /** Related posts section */
+    relatedSection?: string;
+    /** Related posts title */
+    relatedTitle?: string;
+    /** Related posts grid */
+    relatedGrid?: string;
+    /** Related post card */
+    relatedCard?: string;
+    /** Not found state */
+    notFound?: string;
+}
+interface BlogPostServerProps {
+    /** Portal API URL */
+    apiUrl?: string;
+    /** Project API key */
+    apiKey?: string;
+    /** Blog post slug */
+    slug: string;
+    /** Show table of contents sidebar */
+    showToc?: boolean;
+    /** Show related posts */
+    showRelated?: boolean;
+    /** Number of related posts */
+    relatedCount?: number;
+    /** Show author card */
+    showAuthor?: boolean;
+    /** Base URL for blog links */
+    basePath?: string;
+    /** Custom class name (applied to article) */
+    className?: string;
+    /**
+     * Custom Tailwind/CSS classes for each element.
+     * When provided, inline styles are disabled for that element.
+     */
+    styles?: BlogPostStyles;
+    /** Use CSS classes only (no inline styles) - set to true for Tailwind sites */
+    unstyled?: boolean;
+    /** Custom render function */
+    children?: (props: {
+        post: BlogPost$1;
+        tableOfContents: TocItem[];
+        relatedPosts: BlogPost$1[];
+    }) => React__default.ReactNode;
+}
+declare function BlogPost({ apiUrl, apiKey, slug, showToc, showRelated, relatedCount, showAuthor, basePath, className, styles, unstyled, children, }: BlogPostServerProps): Promise<string | number | bigint | boolean | Iterable<React__default.ReactNode> | react_jsx_runtime.JSX.Element | null | undefined>;
+
+interface BlogListStyles {
+    /** Container wrapper */
+    container?: string;
+    /** Category navigation wrapper */
+    categoryNav?: string;
+    /** Individual category link */
+    categoryLink?: string;
+    /** Active category link (combined with categoryLink) */
+    categoryLinkActive?: string;
+    /** Inactive category link (combined with categoryLink) */
+    categoryLinkInactive?: string;
+    /** Posts grid container */
+    grid?: string;
+    /** Individual post card */
+    card?: string;
+    /** Card image wrapper */
+    cardImageWrapper?: string;
+    /** Card image */
+    cardImage?: string;
+    /** Card body/content area */
+    cardBody?: string;
+    /** Card meta row (date, category) */
+    cardMeta?: string;
+    /** Card category badge */
+    cardCategory?: string;
+    /** Card date */
+    cardDate?: string;
+    /** Card title */
+    cardTitle?: string;
+    /** Card title link */
+    cardTitleLink?: string;
+    /** Card excerpt */
+    cardExcerpt?: string;
+    /** Card footer */
+    cardFooter?: string;
+    /** Card author */
+    cardAuthor?: string;
+    /** Card reading time */
+    cardReadingTime?: string;
+    /** Card read more link */
+    cardReadMore?: string;
+    /** Pagination container */
+    pagination?: string;
+    /** Pagination link */
+    paginationLink?: string;
+    /** Pagination info text */
+    paginationInfo?: string;
+    /** Empty state */
+    emptyState?: string;
+}
+interface BlogListServerProps {
+    /** Portal API URL */
+    apiUrl?: string;
+    /** Project API key */
+    apiKey?: string;
+    /** Filter by category slug */
+    category?: string;
+    /** Filter by tag */
+    tag?: string;
+    /** Filter by author */
+    author?: string;
+    /** Only featured posts */
+    featured?: boolean;
+    /** Search query */
+    search?: string;
+    /** Page number (1-indexed) */
+    page?: number;
+    /** Items per page */
+    perPage?: number;
+    /** Sort field */
+    orderBy?: 'published_at' | 'title' | 'view_count';
+    /** Sort direction */
+    order?: 'asc' | 'desc';
+    /** Show category filter UI */
+    showCategoryFilter?: boolean;
+    /** Show pagination */
+    showPagination?: boolean;
+    /** Custom class name (applied to container) */
+    className?: string;
+    /** Base URL for post links */
+    basePath?: string;
+    /**
+     * Custom Tailwind/CSS classes for each element.
+     * When provided, inline styles are disabled for that element.
+     */
+    styles?: BlogListStyles;
+    /** Use CSS classes only (no inline styles) - set to true for Tailwind sites */
+    unstyled?: boolean;
+    /** Custom render function for post card */
+    renderPost?: (post: BlogPost$1) => React__default.ReactNode;
+    /** Custom render function for entire grid */
+    children?: (props: {
+        posts: BlogPost$1[];
+        pagination: BlogListResult['pagination'];
+        categories: BlogCategory[];
+    }) => React__default.ReactNode;
+}
+declare function BlogList({ apiUrl, apiKey, category, tag, author, featured, search, page, perPage, orderBy, order, showCategoryFilter, showPagination, className, basePath, styles, unstyled, renderPost, children, }: BlogListServerProps): Promise<string | number | bigint | boolean | Iterable<React__default.ReactNode> | react_jsx_runtime.JSX.Element | null | undefined>;
+
+interface BlogSidebarProps {
+    /** Portal API URL */
+    apiUrl?: string;
+    /** Project API key */
+    apiKey?: 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 blog links */
+    basePath?: string;
+    /** Custom class name */
+    className?: string;
+    /** Current category filter (for highlighting) */
+    currentCategory?: string;
+    /** Additional widgets to render */
+    children?: React__default.ReactNode;
+}
+declare function BlogSidebar({ apiUrl, apiKey, showCategories, showRecentPosts, recentPostsCount, showTags, showSearch, basePath, className, currentCategory, children, }: BlogSidebarProps): Promise<react_jsx_runtime.JSX.Element | null>;
+interface NewsletterWidgetProps {
+    title?: string;
+    description?: string;
+    buttonText?: string;
+    onSubmit?: (email: string) => Promise<void>;
+}
+declare function NewsletterWidget({ title, description, buttonText, }: NewsletterWidgetProps): react_jsx_runtime.JSX.Element;
+
+interface BlogLayoutProps {
+    /** Portal API URL */
+    apiUrl?: string;
+    /** Project API key */
+    apiKey?: string;
+    /** Layout style: 'sidebar-right', 'sidebar-left', 'full-width' */
+    layout?: 'sidebar-right' | 'sidebar-left' | 'full-width';
+    /** Show sidebar */
+    showSidebar?: boolean;
+    /** Sidebar props */
+    sidebarProps?: Partial<BlogSidebarProps>;
+    /** Hero section config */
+    hero?: {
+        title?: string;
+        subtitle?: string;
+        backgroundImage?: string;
+        backgroundColor?: string;
+    };
+    /** Max width for content */
+    maxWidth?: number;
+    /** Base URL for blog links */
+    basePath?: string;
+    /** Custom class name */
+    className?: string;
+    /** Current category (for sidebar highlighting) */
+    currentCategory?: string;
+    /** Main content */
+    children: React__default.ReactNode;
+}
+declare function BlogLayout({ apiUrl, apiKey, layout, showSidebar, sidebarProps, hero, maxWidth, basePath, className, currentCategory, children, }: BlogLayoutProps): Promise<react_jsx_runtime.JSX.Element>;
+/**
+ * Convenience wrapper for a complete blog index page
+ */
+interface BlogPageProps extends Omit<BlogLayoutProps, 'children'> {
+    /** List component to render */
+    listComponent: React__default.ReactNode;
+}
+declare function BlogPage({ listComponent, ...layoutProps }: BlogPageProps): Promise<react_jsx_runtime.JSX.Element>;
+/**
+ * Convenience wrapper for a single blog post page
+ */
+interface BlogPostPageProps extends Omit<BlogLayoutProps, 'children'> {
+    /** Post component to render */
+    postComponent: React__default.ReactNode;
+}
+declare function BlogPostPage({ postComponent, ...layoutProps }: BlogPostPageProps): Promise<react_jsx_runtime.JSX.Element>;
+interface CategoryPageProps extends BlogLayoutProps {
+    /** Category slug being viewed */
+    category: string;
+    /** Category display name */
+    categoryName?: string;
+    /** List component */
+    listComponent: React__default.ReactNode;
+}
+declare function CategoryPage({ category, categoryName, listComponent, hero, ...layoutProps }: CategoryPageProps): Promise<react_jsx_runtime.JSX.Element>;
+
+declare function AuthorCard({ author, showBio, showSocial, className }: AuthorCardProps): react_jsx_runtime.JSX.Element;
+
+interface RelatedPostsServerProps {
+    apiUrl?: string;
+    apiKey?: string;
+    currentPostId: string;
+    limit?: number;
+    className?: string;
+    renderItem?: (post: BlogPost$1) => React__default.ReactNode;
+}
+declare function RelatedPosts({ apiUrl, apiKey, currentPostId, limit, className, renderItem, }: RelatedPostsServerProps): Promise<react_jsx_runtime.JSX.Element | null>;
+
+declare function TableOfContents({ content, className, maxDepth, }: TableOfContentsProps): react_jsx_runtime.JSX.Element | null;
+
+export { AuthorCard, AuthorCardProps, BlogCategory, BlogLayout, type BlogLayoutProps, BlogList, BlogListResult, type BlogListServerProps, type BlogListStyles, BlogPage, type BlogPageProps, BlogPost, BlogPostPage, type BlogPostPageProps, type BlogPostServerProps, type BlogPostStyles, BlogSidebar, type BlogSidebarProps, CategoryPage, type CategoryPageProps, NewsletterWidget, type NewsletterWidgetProps, RelatedPosts, TableOfContents, TableOfContentsProps, TocItem };