@sonordev/site-kit 1.2.7

package/dist/blog/index.d.ts

@@ -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.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-D08004rU.js';
+
+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 };