import { FeatureRegistryEntry } from './types';
/**
 * Feature module shape expected by auto-registration
 */
export interface FeatureModule {
    default?: FeatureRegistryEntry;
    [key: string]: unknown;
}
/**
 * Feature discovery result
 */
export interface FeatureDiscoveryResult {
    registered: string[];
    failed: Array<{
        path: string;
        error: string;
    }>;
    skipped: string[];
    duration: number;
}
/**
 * Auto-register all features from the features directory
 * Uses Vite's import.meta.glob for build-time discovery
 */
export declare function autoRegisterFeatures(): Promise<FeatureDiscoveryResult>;
/**
 * Synchronous feature registration from explicit imports
 * Use when you need deterministic registration order
 */
export declare function registerFeaturesSync(features: FeatureRegistryEntry[]): FeatureDiscoveryResult;
/**
 * Get feature registry as a plain object (for serialization/debugging)
 */
export declare function getFeatureRegistrySnapshot(): Record<string, {
    id: string;
    name: string;
    description?: string;
    category?: string;
    order?: number;
    featureFlag?: string;
}>;
/**
 * Get features grouped by category
 */
export declare function getFeaturesByCategory(): Record<string, FeatureRegistryEntry[]>;
/**
 * Feature registry initialization hook
 * Safe to call multiple times - only initializes once
 */
export declare function initializeFeatureRegistry(): Promise<FeatureDiscoveryResult>;
/**
 * Check if the feature registry has been initialized
 */
export declare function isFeatureRegistryInitialized(): boolean;
/**
 * Reset the feature registry (useful for testing)
 */
export declare function resetFeatureRegistry(): void;
/**
 * Wait for feature registry to be ready
 * Useful when you need to ensure features are loaded before rendering
 */
export declare function waitForFeatureRegistry(): Promise<void>;