import type { categories } from '@wix/blog';
import { AsChildChildren } from '@wix/headless-utils/react';
import React from 'react';
import { type BlogCategoriesServiceConfig, type EnhancedCategory } from '../services/blog-categories-service.js';
import type { createCustomCategory } from '../services/helpers.js';
export interface BlogCategoriesRootProps {
    asChild?: boolean;
    className?: string;
    children: AsChildChildren<{
        hasCategories: boolean;
    }> | React.ReactNode;
    /** Loaded result of `loadBlogCategoriesServiceConfig` */
    blogCategoriesServiceConfig?: BlogCategoriesServiceConfig;
    /** Categories to use instead of loading from the service */
    categories?: categories.Category[];
    /** Custom categories to prepend to the real categories (e.g., "All posts"). @see {@link createCustomCategory} */
    customCategoriesToPrepend?: ReturnType<typeof createCustomCategory>[];
    /** Fallback image url to use when the category image is not available */
    fallbackImageUrl?: string;
}
/**
 * Root container for blog categories that provides categories context to all child components.
 * Supports both real categories from the service and custom categories.
 * Follows Container Level pattern from architecture rules.
 *
 * @component
 * @example
 * ```tsx
 * import { Blog } from '@wix/blog/components';
 *
 * function CategoryNavigation() {
 *   return (
 *     <Blog.Categories.Root customCategories={[createCustomCategory('All', '/')]}>
 *       <Blog.Categories.CategoryItems emptyState={<div>No categories found</div>}>
 *         <Blog.Categories.CategoryItemRepeater>
 *           <Blog.Category.Link baseUrl="/category/">
 *             <Blog.Category.Label />
 *           </Blog.Category.Link>
 *         </Blog.Categories.CategoryItemRepeater>
 *       </Blog.Categories.CategoryItems>
 *     </Blog.Categories.Root>
 *   );
 * }
 * ```
 */
export declare const Root: React.ForwardRefExoticComponent<BlogCategoriesRootProps & React.RefAttributes<HTMLElement>>;
export interface CategoryItemsProps {
    children: React.ReactNode;
    emptyState?: React.ReactNode;
}
/**
 * Container for the categories list with empty state support.
 * Follows List Container Level pattern from architecture rules.
 *
 * @component
 * @example
 * ```tsx
 * <Blog.Categories.CategoryItems emptyState={<div>No categories found</div>}>
 *   <Blog.Categories.CategoryItemRepeater>
 *     <Blog.Category.Label />
 *   </Blog.Categories.CategoryItemRepeater>
 * </Blog.Categories.CategoryItems>
 * ```
 */
export declare const CategoryItems: React.ForwardRefExoticComponent<CategoryItemsProps & React.RefAttributes<HTMLElement>>;
export interface CategoryItemRepeaterProps {
    children: React.ReactNode;
    offset?: number;
    limit?: number;
}
/**
 * Repeater component that renders Category for each category.
 * Follows Repeater Level pattern from architecture rules.
 * Note: Repeater components do NOT support asChild as per architecture rules.
 *
 * @component
 * @example
 * ```tsx
 * <Blog.Categories.CategoryItems>
 *   <Blog.Categories.CategoryItemRepeater>
 *     <Blog.Categories.Link baseUrl="/category/">
 *       <Blog.Categories.Label />
 *     </Blog.Categories.Link>
 *   </Blog.Categories.CategoryItemRepeater>
 * </Blog.Categories.CategoryItems>
 * ```
 */
export declare const CategoryItemRepeater: React.ForwardRefExoticComponent<CategoryItemRepeaterProps & React.RefAttributes<HTMLElement>>;
interface CategoryItemRepeaterContextValue {
    category: EnhancedCategory;
    imageUrl?: string;
}
export declare function useCategoryItemRepeaterContext(): CategoryItemRepeaterContextValue;
export interface ActiveCategoryProps {
    asChild?: boolean;
    className?: string;
    /** The pathname of the current page */
    pathname: string;
    baseUrl?: string;
    children: AsChildChildren<{
        category: EnhancedCategory;
    }> | React.ReactNode;
}
/**
 * Component that finds and displays the currently active category.
 * Provides the active category through CategoryContext to its children.
 *
 * @component
 * @example
 * ```tsx
 * <Blog.Categories.ActiveCategory pathname={location.pathname} baseUrl="/category/">
 *   {({ category }) => (
 *     <div className="hero-section">
 *       <Blog.Categories.Image />
 *       <div className="overlay">
 *         <Blog.Categories.Label className="text-white text-3xl" />
 *         <Blog.Categories.Description className="text-white/90" />
 *       </div>
 *     </div>
 *   )}
 * </Blog.Categories.ActiveCategory>
 * ```
 */
export declare const ActiveCategory: React.ForwardRefExoticComponent<ActiveCategoryProps & React.RefAttributes<HTMLElement>>;
export {};