@uptrademedia/site-kit 1.0.4 → 1.0.7

package/README.md

@@ -158,43 +158,114 @@ export default function CustomContactPage() {
 
 ### Blog (`@uptrade/site-kit/blog`)
 
-Blog components with built-in SEO and related post suggestions.
+Complete Portal-managed blog system with beautiful layouts, dynamic routing, categories, and SEO.
+
+**Create posts in Portal → Automatically appear on your site.**
 
 ```tsx
-import { BlogPost, BlogList, RelatedPosts, TableOfContents, AuthorCard } from '@uptrade/site-kit/blog'
+// app/blog/page.tsx - Blog Index
+import { BlogList, BlogLayout } from '@uptrade/site-kit/blog'
+import { generateBlogIndexMetadata } from '@uptrade/site-kit/blog/server'
+
+export const metadata = generateBlogIndexMetadata({
+  title: 'Blog',
+  siteName: 'My Company',
+  siteUrl: 'https://example.com',
+})
 
-// Blog listing page
-export default function BlogPage() {
+export default function BlogPage({ searchParams }) {
   return (
-    <BlogList 
-      projectId="..."
-      options={{ 
-        limit: 10, 
-        category: 'news',
-        orderBy: 'published_at',
-        order: 'desc'
-      }}
-    />
+    <BlogLayout
+      hero={{ title: 'Blog', subtitle: 'Latest insights and articles' }}
+      layout="sidebar-right"
+    >
+      <BlogList
+        category={searchParams.category}
+        page={parseInt(searchParams.page || '1')}
+        showCategoryFilter
+        showPagination
+      />
+    </BlogLayout>
   )
 }
+```
+
+```tsx
+// app/blog/[slug]/page.tsx - Individual Post
+import { BlogPost } from '@uptrade/site-kit/blog'
+import { 
+  generateBlogPostMetadata, 
+  generateBlogStaticParams,
+  getBlogPost,
+  generateBlogPostSchema 
+} from '@uptrade/site-kit/blog/server'
+
+// Pre-generate all post pages at build time
+export const generateStaticParams = generateBlogStaticParams
+
+// Dynamic metadata for SEO
+export async function generateMetadata({ params }) {
+  return generateBlogPostMetadata(params.slug, {
+    siteName: 'My Company',
+    siteUrl: 'https://example.com',
+  })
+}
 
-// Blog post page
-export default function BlogPostPage({ params }) {
+export default async function PostPage({ params }) {
+  const post = await getBlogPost(params.slug)
+  
   return (
-    <div className="flex">
-      <aside className="w-64">
-        <TableOfContents content={post.content_html} />
-      </aside>
-      <main>
-        <BlogPost projectId="..." slug={params.slug} />
-        <AuthorCard author={post.author} />
-        <RelatedPosts projectId="..." currentPostId={post.id} limit={3} />
-      </main>
-    </div>
+    <>
+      {/* JSON-LD Schema */}
+      <script
+        type="application/ld+json"
+        dangerouslySetInnerHTML={{
+          __html: JSON.stringify(generateBlogPostSchema(post, {
+            siteUrl: 'https://example.com',
+            siteName: 'My Company',
+          })),
+        }}
+      />
+      
+      {/* Blog Post with TOC and Related Posts */}
+      <BlogPost 
+        slug={params.slug} 
+        showToc 
+        showRelated 
+        showAuthor 
+      />
+    </>
   )
 }
 ```
 
+#### Available Components
+
+| Component | Purpose |
+|-----------|---------|
+| `BlogList` | Grid of posts with pagination & category filter |
+| `BlogPost` | Full post with TOC, author, related posts |
+| `BlogLayout` | Complete layout with sidebar |
+| `BlogSidebar` | Categories, recent posts, tags, search |
+| `TableOfContents` | Sticky TOC from headings |
+| `AuthorCard` | Author info with social links |
+| `RelatedPosts` | Related posts by category |
+
+#### Server Functions
+
+```tsx
+import {
+  getBlogPost,           // Fetch single post
+  getAllBlogSlugs,       // For generateStaticParams
+  getBlogCategories,     // All categories
+  generateBlogPostMetadata,    // Post page metadata
+  generateBlogIndexMetadata,   // Index page metadata
+  generateBlogStaticParams,    // SSG params
+  generateBlogSitemap,         // Sitemap entries
+  generateBlogPostSchema,      // JSON-LD
+} from '@uptrade/site-kit/blog/server'
+```
+
 ## Configuration
 
 ### Full Provider Options

package/dist/analytics/index.js

@@ -1,12 +1,12 @@
 'use strict';
 
-var chunkV3F5J6CV_js = require('../chunk-V3F5J6CV.js');
-require('../chunk-EQCVQC35.js');
+var chunkJUEVN4Q4_js = require('../chunk-JUEVN4Q4.js');
+require('../chunk-ZSMWDLMK.js');
 var react = require('react');
 
 function useContactTracking(options = {}) {
   const { autoTrack = true, debug = false } = options;
-  const { trackConversion } = chunkV3F5J6CV_js.useAnalytics();
+  const { trackConversion } = chunkJUEVN4Q4_js.useAnalytics();
   const trackPhoneClick = react.useCallback((phoneNumber, metadata) => {
     if (debug) console.log("[Analytics] Phone click:", phoneNumber);
     trackConversion({
@@ -68,19 +68,19 @@ function ContactTracking({ debug = false }) {
 
 Object.defineProperty(exports, "AnalyticsProvider", {
   enumerable: true,
-  get: function () { return chunkV3F5J6CV_js.AnalyticsProvider; }
+  get: function () { return chunkJUEVN4Q4_js.AnalyticsProvider; }
 });
 Object.defineProperty(exports, "WebVitals", {
   enumerable: true,
-  get: function () { return chunkV3F5J6CV_js.WebVitals; }
+  get: function () { return chunkJUEVN4Q4_js.WebVitals; }
 });
 Object.defineProperty(exports, "useAnalytics", {
   enumerable: true,
-  get: function () { return chunkV3F5J6CV_js.useAnalytics; }
+  get: function () { return chunkJUEVN4Q4_js.useAnalytics; }
 });
 Object.defineProperty(exports, "useTrackEvent", {
   enumerable: true,
-  get: function () { return chunkV3F5J6CV_js.useTrackEvent; }
+  get: function () { return chunkJUEVN4Q4_js.useTrackEvent; }
 });
 exports.ContactTracking = ContactTracking;
 exports.useContactTracking = useContactTracking;

package/dist/analytics/index.mjs

@@ -1,6 +1,6 @@
-import { useAnalytics } from '../chunk-FKVJOT2F.mjs';
-export { AnalyticsProvider, WebVitals, useAnalytics, useTrackEvent } from '../chunk-FKVJOT2F.mjs';
-import '../chunk-NYKRE2FL.mjs';
+import { useAnalytics } from '../chunk-42EXHJTC.mjs';
+export { AnalyticsProvider, WebVitals, useAnalytics, useTrackEvent } from '../chunk-42EXHJTC.mjs';
+import '../chunk-4XPGGLVP.mjs';
 import { useCallback, useEffect } from 'react';
 
 function useContactTracking(options = {}) {

package/dist/api-QUIPJJCX.js

@@ -0,0 +1,77 @@
+'use strict';
+
+var chunkVDI7KYME_js = require('./chunk-VDI7KYME.js');
+require('./chunk-ZSMWDLMK.js');
+
+
+
+Object.defineProperty(exports, "getABTest", {
+  enumerable: true,
+  get: function () { return chunkVDI7KYME_js.getABTest; }
+});
+Object.defineProperty(exports, "getContentBlock", {
+  enumerable: true,
+  get: function () { return chunkVDI7KYME_js.getContentBlock; }
+});
+Object.defineProperty(exports, "getEntities", {
+  enumerable: true,
+  get: function () { return chunkVDI7KYME_js.getEntities; }
+});
+Object.defineProperty(exports, "getEntityEnhancedSchema", {
+  enumerable: true,
+  get: function () { return chunkVDI7KYME_js.getEntityEnhancedSchema; }
+});
+Object.defineProperty(exports, "getFAQData", {
+  enumerable: true,
+  get: function () { return chunkVDI7KYME_js.getFAQData; }
+});
+Object.defineProperty(exports, "getInternalLinks", {
+  enumerable: true,
+  get: function () { return chunkVDI7KYME_js.getInternalLinks; }
+});
+Object.defineProperty(exports, "getManagedScripts", {
+  enumerable: true,
+  get: function () { return chunkVDI7KYME_js.getManagedScripts; }
+});
+Object.defineProperty(exports, "getPrimaryEntity", {
+  enumerable: true,
+  get: function () { return chunkVDI7KYME_js.getPrimaryEntity; }
+});
+Object.defineProperty(exports, "getRedirectData", {
+  enumerable: true,
+  get: function () { return chunkVDI7KYME_js.getRedirectData; }
+});
+Object.defineProperty(exports, "getRobotsData", {
+  enumerable: true,
+  get: function () { return chunkVDI7KYME_js.getRobotsData; }
+});
+Object.defineProperty(exports, "getSEOPageData", {
+  enumerable: true,
+  get: function () { return chunkVDI7KYME_js.getSEOPageData; }
+});
+Object.defineProperty(exports, "getSchemaMarkups", {
+  enumerable: true,
+  get: function () { return chunkVDI7KYME_js.getSchemaMarkups; }
+});
+Object.defineProperty(exports, "getSitemapEntries", {
+  enumerable: true,
+  get: function () { return chunkVDI7KYME_js.getSitemapEntries; }
+});
+Object.defineProperty(exports, "getVisibilityScore", {
+  enumerable: true,
+  get: function () { return chunkVDI7KYME_js.getVisibilityScore; }
+});
+Object.defineProperty(exports, "getVisibilitySummary", {
+  enumerable: true,
+  get: function () { return chunkVDI7KYME_js.getVisibilitySummary; }
+});
+Object.defineProperty(exports, "recordABImpression", {
+  enumerable: true,
+  get: function () { return chunkVDI7KYME_js.recordABImpression; }
+});
+Object.defineProperty(exports, "registerSitemap", {
+  enumerable: true,
+  get: function () { return chunkVDI7KYME_js.registerSitemap; }
+});
+//# sourceMappingURL=api-QUIPJJCX.js.map
+//# sourceMappingURL=api-QUIPJJCX.js.map

package/dist/api-QUIPJJCX.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"api-QUIPJJCX.js"}

package/dist/api-V3BA5PMX.mjs

@@ -0,0 +1,4 @@
+export { getABTest, getContentBlock, getEntities, getEntityEnhancedSchema, getFAQData, getInternalLinks, getManagedScripts, getPrimaryEntity, getRedirectData, getRobotsData, getSEOPageData, getSchemaMarkups, getSitemapEntries, getVisibilityScore, getVisibilitySummary, recordABImpression, registerSitemap } from './chunk-FQVGK746.mjs';
+import './chunk-4XPGGLVP.mjs';
+//# sourceMappingURL=api-V3BA5PMX.mjs.map
+//# sourceMappingURL=api-V3BA5PMX.mjs.map

package/dist/api-V3BA5PMX.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"api-V3BA5PMX.mjs"}

package/dist/blog/index.d.mts

@@ -1,11 +1,166 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { B as BlogPostProps, a as BlogListProps, A as AuthorCardProps, b as BlogPost$1, T as TableOfContentsProps } from '../types-BDojCvvL.mjs';
-export { k as BlogAnalytics, c as BlogAuthor, d as BlogCategory, f as BlogListOptions, i as BlogListRenderProps, g as BlogListResult, h as BlogPostRenderProps, e as BlogTag, R as RelatedPostsProps, j as TocItem } from '../types-BDojCvvL.mjs';
 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-DI0jnhjJ.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-DI0jnhjJ.mjs';
 
-declare function BlogPost({ projectId, slug, children }: BlogPostProps): Promise<react_jsx_runtime.JSX.Element>;
+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 */
+    className?: string;
+    /** 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, children, }: BlogPostServerProps): Promise<string | number | bigint | boolean | Iterable<React__default.ReactNode> | react_jsx_runtime.JSX.Element | null | undefined>;
+
+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 */
+    className?: string;
+    /** Base URL for post links */
+    basePath?: string;
+    /** 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, 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;
 
-declare function BlogList({ projectId, options, children }: BlogListProps): Promise<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;
 
@@ -21,4 +176,4 @@ declare function RelatedPosts({ apiUrl, apiKey, currentPostId, limit, className,
 
 declare function TableOfContents({ content, className, maxDepth, }: TableOfContentsProps): react_jsx_runtime.JSX.Element | null;
 
-export { AuthorCard, AuthorCardProps, BlogList, BlogListProps, BlogPost, BlogPostProps, RelatedPosts, TableOfContents, TableOfContentsProps };
+export { AuthorCard, AuthorCardProps, BlogCategory, BlogLayout, type BlogLayoutProps, BlogList, BlogListResult, type BlogListServerProps, BlogPage, type BlogPageProps, BlogPost, BlogPostPage, type BlogPostPageProps, type BlogPostServerProps, BlogSidebar, type BlogSidebarProps, CategoryPage, type CategoryPageProps, NewsletterWidget, type NewsletterWidgetProps, RelatedPosts, TableOfContents, TableOfContentsProps, TocItem };

package/dist/blog/index.d.ts

@@ -1,11 +1,166 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { B as BlogPostProps, a as BlogListProps, A as AuthorCardProps, b as BlogPost$1, T as TableOfContentsProps } from '../types-BDojCvvL.js';
-export { k as BlogAnalytics, c as BlogAuthor, d as BlogCategory, f as BlogListOptions, i as BlogListRenderProps, g as BlogListResult, h as BlogPostRenderProps, e as BlogTag, R as RelatedPostsProps, j as TocItem } from '../types-BDojCvvL.js';
 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-DI0jnhjJ.js';
+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-DI0jnhjJ.js';
 
-declare function BlogPost({ projectId, slug, children }: BlogPostProps): Promise<react_jsx_runtime.JSX.Element>;
+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 */
+    className?: string;
+    /** 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, children, }: BlogPostServerProps): Promise<string | number | bigint | boolean | Iterable<React__default.ReactNode> | react_jsx_runtime.JSX.Element | null | undefined>;
+
+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 */
+    className?: string;
+    /** Base URL for post links */
+    basePath?: string;
+    /** 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, 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;
 
-declare function BlogList({ projectId, options, children }: BlogListProps): Promise<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;
 
@@ -21,4 +176,4 @@ declare function RelatedPosts({ apiUrl, apiKey, currentPostId, limit, className,
 
 declare function TableOfContents({ content, className, maxDepth, }: TableOfContentsProps): react_jsx_runtime.JSX.Element | null;
 
-export { AuthorCard, AuthorCardProps, BlogList, BlogListProps, BlogPost, BlogPostProps, RelatedPosts, TableOfContents, TableOfContentsProps };
+export { AuthorCard, AuthorCardProps, BlogCategory, BlogLayout, type BlogLayoutProps, BlogList, BlogListResult, type BlogListServerProps, BlogPage, type BlogPageProps, BlogPost, BlogPostPage, type BlogPostPageProps, type BlogPostServerProps, BlogSidebar, type BlogSidebarProps, CategoryPage, type CategoryPageProps, NewsletterWidget, type NewsletterWidgetProps, RelatedPosts, TableOfContents, TableOfContentsProps, TocItem };