/**
 * @silverassist/performance-toolkit
 *
 * Project context and framework detection type definitions.
 *
 * @module types/context
 * @author Miguel Colmenares <me@miguelcolmenares.com>
 * @license PolyForm-Noncommercial-1.0.0
 */
/**
 * Detected framework information
 */
interface FrameworkInfo {
    /** Framework name */
    name: "next" | "react" | "vue" | "nuxt" | "angular" | "svelte" | "astro" | "remix" | "gatsby" | "unknown";
    /** Framework version */
    version: string;
    /** Router type (for frameworks with multiple options) */
    routerType?: "app" | "pages" | "file-based" | "config-based";
    /** SSR/SSG capabilities */
    renderingMode?: "ssr" | "ssg" | "spa" | "hybrid" | "isr";
    /**
     * Framework-specific features detected
     *
     * For Next.js 16+:
     * - "cache-components": Using "use cache" directive
     * - "turbopack": Turbopack bundler (default in 16+)
     * - "react-compiler": Automatic memoization
     * - "view-transitions": React 19.2 View Transitions
     *
     * Common features:
     * - "auth": Authentication integration
     * - "font-optimization": Font optimization
     * - "i18n": Internationalization
     * - "mdx": MDX support
     */
    features?: string[];
}
/**
 * Detected project technology stack
 */
interface ProjectContext {
    /** Project name from package.json */
    name?: string;
    /** Framework detected */
    framework: FrameworkInfo | null;
    /** Package manager detected */
    packageManager: "npm" | "yarn" | "pnpm" | "bun" | null;
    /** Build tool detected */
    buildTool: "webpack" | "vite" | "turbopack" | "esbuild" | "rollup" | null;
    /** UI library detected */
    uiLibrary?: string;
    /** CSS solution detected */
    cssSolution?: "tailwind" | "css-modules" | "styled-components" | "emotion" | "sass" | "vanilla" | null;
    /** TypeScript enabled */
    isTypeScript: boolean;
    /** Image optimization library */
    imageOptimization?: "next/image" | "sharp" | "imagemin" | "cloudinary" | null;
    /** Analytics/tracking libraries */
    analytics: string[];
    /** Third-party integrations detected */
    thirdPartyIntegrations: string[];
    /** Dependencies summary */
    dependencies: {
        production: string[];
        development: string[];
        total: number;
    };
}
/**
 * Framework-specific implementation note
 */
interface FrameworkSpecificNote {
    /** Framework name */
    framework: string;
    /** Note content */
    note: string;
    /** Code example */
    codeExample?: string;
    /** Documentation link */
    docLink?: string;
}

export type { FrameworkInfo as F, ProjectContext as P, FrameworkSpecificNote as a };