cmp-standards 3.3.1 → 3.4.1

package/dist/schema/docs-types.d.ts

@@ -0,0 +1,1253 @@
+/**
+ * @file Documentation Types Schema - cmp-standards v3.4
+ * @description Type definitions for automated project documentation generation
+ *
+ * This module provides schemas for:
+ * - Project documentation (auto-generated from CodeWiki)
+ * - Feature detection
+ * - Architecture diagrams
+ * - Stats aggregation
+ */
+import { z } from 'zod';
+import type { DevSystem } from '../types/index.js';
+/**
+ * Categories for auto-detected features
+ */
+export declare const FeatureCategorySchema: z.ZodEnum<["core", "integration", "storage", "ai", "developer", "security"]>;
+export type FeatureCategory = z.infer<typeof FeatureCategorySchema>;
+/**
+ * Auto-detected feature from code patterns
+ */
+export declare const AutoDetectedFeatureSchema: z.ZodObject<{
+    /** Unique feature ID */
+    id: z.ZodString;
+    /** Feature name */
+    name: z.ZodString;
+    /** Human-readable description */
+    description: z.ZodString;
+    /** Feature category */
+    category: z.ZodEnum<["core", "integration", "storage", "ai", "developer", "security"]>;
+    /** Icon identifier for UI (e.g., 'database', 'cloud', 'brain') */
+    icon: z.ZodOptional<z.ZodString>;
+    /** Pattern that detected this feature */
+    detectedFrom: z.ZodString;
+    /** Files where this feature is implemented */
+    files: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    /** Confidence score (0-1) */
+    confidence: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    description: string;
+    files: string[];
+    id: string;
+    category: "security" | "ai" | "core" | "integration" | "storage" | "developer";
+    name: string;
+    confidence: number;
+    detectedFrom: string;
+    icon?: string | undefined;
+}, {
+    description: string;
+    id: string;
+    category: "security" | "ai" | "core" | "integration" | "storage" | "developer";
+    name: string;
+    detectedFrom: string;
+    files?: string[] | undefined;
+    confidence?: number | undefined;
+    icon?: string | undefined;
+}>;
+export type AutoDetectedFeature = z.infer<typeof AutoDetectedFeatureSchema>;
+/**
+ * Detected architecture layer
+ */
+export declare const ArchitectureLayerSchema: z.ZodObject<{
+    /** Layer name (e.g., 'hooks', 'services', 'db') */
+    name: z.ZodString;
+    /** Layer description */
+    description: z.ZodString;
+    /** Directory path pattern */
+    path: z.ZodString;
+    /** Number of files in this layer */
+    fileCount: z.ZodNumber;
+    /** Key files in this layer */
+    keyFiles: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    description: string;
+    name: string;
+    fileCount: number;
+    keyFiles: string[];
+}, {
+    path: string;
+    description: string;
+    name: string;
+    fileCount: number;
+    keyFiles?: string[] | undefined;
+}>;
+export type ArchitectureLayer = z.infer<typeof ArchitectureLayerSchema>;
+/**
+ * Project architecture info
+ */
+export declare const ProjectArchitectureSchema: z.ZodObject<{
+    /** Detected layers */
+    layers: z.ZodArray<z.ZodObject<{
+        /** Layer name (e.g., 'hooks', 'services', 'db') */
+        name: z.ZodString;
+        /** Layer description */
+        description: z.ZodString;
+        /** Directory path pattern */
+        path: z.ZodString;
+        /** Number of files in this layer */
+        fileCount: z.ZodNumber;
+        /** Key files in this layer */
+        keyFiles: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        description: string;
+        name: string;
+        fileCount: number;
+        keyFiles: string[];
+    }, {
+        path: string;
+        description: string;
+        name: string;
+        fileCount: number;
+        keyFiles?: string[] | undefined;
+    }>, "many">;
+    /** Entry points (main files) */
+    entryPoints: z.ZodArray<z.ZodString, "many">;
+    /** Mermaid diagram source */
+    diagram: z.ZodString;
+    /** Simplified diagram for beginners */
+    simpleDiagram: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    layers: {
+        path: string;
+        description: string;
+        name: string;
+        fileCount: number;
+        keyFiles: string[];
+    }[];
+    entryPoints: string[];
+    diagram: string;
+    simpleDiagram?: string | undefined;
+}, {
+    layers: {
+        path: string;
+        description: string;
+        name: string;
+        fileCount: number;
+        keyFiles?: string[] | undefined;
+    }[];
+    entryPoints: string[];
+    diagram: string;
+    simpleDiagram?: string | undefined;
+}>;
+export type ProjectArchitecture = z.infer<typeof ProjectArchitectureSchema>;
+/**
+ * Aggregated project statistics from CodeWiki
+ */
+export declare const ProjectStatsSchema: z.ZodObject<{
+    /** Total number of indexed files */
+    totalFiles: z.ZodNumber;
+    /** Total lines of code */
+    totalLOC: z.ZodNumber;
+    /** Lines of code by language */
+    languages: z.ZodRecord<z.ZodString, z.ZodNumber>;
+    /** Detected frameworks */
+    frameworks: z.ZodArray<z.ZodString, "many">;
+    /** Total exported symbols */
+    totalSymbols: z.ZodNumber;
+    /** Number of components (React) */
+    components: z.ZodNumber;
+    /** Number of tests */
+    tests: z.ZodNumber;
+    /** Dependency counts */
+    dependencies: z.ZodObject<{
+        internal: z.ZodNumber;
+        external: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        internal: number;
+        external: number;
+    }, {
+        internal: number;
+        external: number;
+    }>;
+    /** Top external packages used */
+    topPackages: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        usageCount: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        usageCount: number;
+    }, {
+        name: string;
+        usageCount: number;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    components: number;
+    dependencies: {
+        internal: number;
+        external: number;
+    };
+    totalFiles: number;
+    totalLOC: number;
+    languages: Record<string, number>;
+    frameworks: string[];
+    totalSymbols: number;
+    tests: number;
+    topPackages: {
+        name: string;
+        usageCount: number;
+    }[];
+}, {
+    components: number;
+    dependencies: {
+        internal: number;
+        external: number;
+    };
+    totalFiles: number;
+    totalLOC: number;
+    languages: Record<string, number>;
+    frameworks: string[];
+    totalSymbols: number;
+    tests: number;
+    topPackages?: {
+        name: string;
+        usageCount: number;
+    }[] | undefined;
+}>;
+export type ProjectStats = z.infer<typeof ProjectStatsSchema>;
+/**
+ * Main project documentation content (stored as item type 'project_doc')
+ */
+export declare const ProjectDocContentSchema: z.ZodObject<{
+    /** Project system ID */
+    projectId: z.ZodString;
+    /** Human-readable project name */
+    name: z.ZodString;
+    /** URL-friendly slug */
+    slug: z.ZodString;
+    /** Current version (from package.json if available) */
+    version: z.ZodString;
+    /** Short description */
+    description: z.ZodString;
+    /** Long description (for detail page) */
+    longDescription: z.ZodOptional<z.ZodString>;
+    /** Project status */
+    status: z.ZodEnum<["active", "beta", "stable", "deprecated", "internal"]>;
+    /** Project category */
+    category: z.ZodEnum<["npm_package", "saas", "internal", "library", "website"]>;
+    /** Aggregated stats */
+    stats: z.ZodObject<{
+        /** Total number of indexed files */
+        totalFiles: z.ZodNumber;
+        /** Total lines of code */
+        totalLOC: z.ZodNumber;
+        /** Lines of code by language */
+        languages: z.ZodRecord<z.ZodString, z.ZodNumber>;
+        /** Detected frameworks */
+        frameworks: z.ZodArray<z.ZodString, "many">;
+        /** Total exported symbols */
+        totalSymbols: z.ZodNumber;
+        /** Number of components (React) */
+        components: z.ZodNumber;
+        /** Number of tests */
+        tests: z.ZodNumber;
+        /** Dependency counts */
+        dependencies: z.ZodObject<{
+            internal: z.ZodNumber;
+            external: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            internal: number;
+            external: number;
+        }, {
+            internal: number;
+            external: number;
+        }>;
+        /** Top external packages used */
+        topPackages: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            usageCount: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            usageCount: number;
+        }, {
+            name: string;
+            usageCount: number;
+        }>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        components: number;
+        dependencies: {
+            internal: number;
+            external: number;
+        };
+        totalFiles: number;
+        totalLOC: number;
+        languages: Record<string, number>;
+        frameworks: string[];
+        totalSymbols: number;
+        tests: number;
+        topPackages: {
+            name: string;
+            usageCount: number;
+        }[];
+    }, {
+        components: number;
+        dependencies: {
+            internal: number;
+            external: number;
+        };
+        totalFiles: number;
+        totalLOC: number;
+        languages: Record<string, number>;
+        frameworks: string[];
+        totalSymbols: number;
+        tests: number;
+        topPackages?: {
+            name: string;
+            usageCount: number;
+        }[] | undefined;
+    }>;
+    /** Auto-detected features */
+    features: z.ZodArray<z.ZodObject<{
+        /** Unique feature ID */
+        id: z.ZodString;
+        /** Feature name */
+        name: z.ZodString;
+        /** Human-readable description */
+        description: z.ZodString;
+        /** Feature category */
+        category: z.ZodEnum<["core", "integration", "storage", "ai", "developer", "security"]>;
+        /** Icon identifier for UI (e.g., 'database', 'cloud', 'brain') */
+        icon: z.ZodOptional<z.ZodString>;
+        /** Pattern that detected this feature */
+        detectedFrom: z.ZodString;
+        /** Files where this feature is implemented */
+        files: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        /** Confidence score (0-1) */
+        confidence: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        description: string;
+        files: string[];
+        id: string;
+        category: "security" | "ai" | "core" | "integration" | "storage" | "developer";
+        name: string;
+        confidence: number;
+        detectedFrom: string;
+        icon?: string | undefined;
+    }, {
+        description: string;
+        id: string;
+        category: "security" | "ai" | "core" | "integration" | "storage" | "developer";
+        name: string;
+        detectedFrom: string;
+        files?: string[] | undefined;
+        confidence?: number | undefined;
+        icon?: string | undefined;
+    }>, "many">;
+    /** Architecture info */
+    architecture: z.ZodObject<{
+        /** Detected layers */
+        layers: z.ZodArray<z.ZodObject<{
+            /** Layer name (e.g., 'hooks', 'services', 'db') */
+            name: z.ZodString;
+            /** Layer description */
+            description: z.ZodString;
+            /** Directory path pattern */
+            path: z.ZodString;
+            /** Number of files in this layer */
+            fileCount: z.ZodNumber;
+            /** Key files in this layer */
+            keyFiles: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            path: string;
+            description: string;
+            name: string;
+            fileCount: number;
+            keyFiles: string[];
+        }, {
+            path: string;
+            description: string;
+            name: string;
+            fileCount: number;
+            keyFiles?: string[] | undefined;
+        }>, "many">;
+        /** Entry points (main files) */
+        entryPoints: z.ZodArray<z.ZodString, "many">;
+        /** Mermaid diagram source */
+        diagram: z.ZodString;
+        /** Simplified diagram for beginners */
+        simpleDiagram: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        layers: {
+            path: string;
+            description: string;
+            name: string;
+            fileCount: number;
+            keyFiles: string[];
+        }[];
+        entryPoints: string[];
+        diagram: string;
+        simpleDiagram?: string | undefined;
+    }, {
+        layers: {
+            path: string;
+            description: string;
+            name: string;
+            fileCount: number;
+            keyFiles?: string[] | undefined;
+        }[];
+        entryPoints: string[];
+        diagram: string;
+        simpleDiagram?: string | undefined;
+    }>;
+    /** Package.json info */
+    packageInfo: z.ZodOptional<z.ZodObject<{
+        version: z.ZodString;
+        dependencies: z.ZodRecord<z.ZodString, z.ZodString>;
+        devDependencies: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        scripts: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        version: string;
+        dependencies: Record<string, string>;
+        devDependencies?: Record<string, string> | undefined;
+        scripts?: Record<string, string> | undefined;
+    }, {
+        version: string;
+        dependencies: Record<string, string>;
+        devDependencies?: Record<string, string> | undefined;
+        scripts?: Record<string, string> | undefined;
+    }>>;
+    /** External links */
+    links: z.ZodOptional<z.ZodObject<{
+        github: z.ZodOptional<z.ZodString>;
+        npm: z.ZodOptional<z.ZodString>;
+        docs: z.ZodOptional<z.ZodString>;
+        website: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        website?: string | undefined;
+        github?: string | undefined;
+        npm?: string | undefined;
+        docs?: string | undefined;
+    }, {
+        website?: string | undefined;
+        github?: string | undefined;
+        npm?: string | undefined;
+        docs?: string | undefined;
+    }>>;
+    /** Simple explanation for beginners */
+    simpleExplanation: z.ZodOptional<z.ZodObject<{
+        /** One-sentence explanation */
+        oneLiner: z.ZodString;
+        /** Analogy for non-technical people */
+        analogy: z.ZodString;
+        /** Key benefits (3-5 points) */
+        benefits: z.ZodArray<z.ZodString, "many">;
+        /** Before/after comparison */
+        beforeAfter: z.ZodOptional<z.ZodObject<{
+            before: z.ZodString;
+            after: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            before: string;
+            after: string;
+        }, {
+            before: string;
+            after: string;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        oneLiner: string;
+        analogy: string;
+        benefits: string[];
+        beforeAfter?: {
+            before: string;
+            after: string;
+        } | undefined;
+    }, {
+        oneLiner: string;
+        analogy: string;
+        benefits: string[];
+        beforeAfter?: {
+            before: string;
+            after: string;
+        } | undefined;
+    }>>;
+    /** First generation timestamp */
+    generatedAt: z.ZodString;
+    /** Last update timestamp */
+    lastUpdatedAt: z.ZodString;
+    /** Source files used for generation */
+    sourceFileCount: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    architecture: {
+        layers: {
+            path: string;
+            description: string;
+            name: string;
+            fileCount: number;
+            keyFiles: string[];
+        }[];
+        entryPoints: string[];
+        diagram: string;
+        simpleDiagram?: string | undefined;
+    };
+    status: "active" | "internal" | "beta" | "stable" | "deprecated";
+    description: string;
+    category: "internal" | "npm_package" | "saas" | "library" | "website";
+    name: string;
+    version: string;
+    stats: {
+        components: number;
+        dependencies: {
+            internal: number;
+            external: number;
+        };
+        totalFiles: number;
+        totalLOC: number;
+        languages: Record<string, number>;
+        frameworks: string[];
+        totalSymbols: number;
+        tests: number;
+        topPackages: {
+            name: string;
+            usageCount: number;
+        }[];
+    };
+    projectId: string;
+    slug: string;
+    features: {
+        description: string;
+        files: string[];
+        id: string;
+        category: "security" | "ai" | "core" | "integration" | "storage" | "developer";
+        name: string;
+        confidence: number;
+        detectedFrom: string;
+        icon?: string | undefined;
+    }[];
+    generatedAt: string;
+    lastUpdatedAt: string;
+    sourceFileCount: number;
+    longDescription?: string | undefined;
+    packageInfo?: {
+        version: string;
+        dependencies: Record<string, string>;
+        devDependencies?: Record<string, string> | undefined;
+        scripts?: Record<string, string> | undefined;
+    } | undefined;
+    links?: {
+        website?: string | undefined;
+        github?: string | undefined;
+        npm?: string | undefined;
+        docs?: string | undefined;
+    } | undefined;
+    simpleExplanation?: {
+        oneLiner: string;
+        analogy: string;
+        benefits: string[];
+        beforeAfter?: {
+            before: string;
+            after: string;
+        } | undefined;
+    } | undefined;
+}, {
+    architecture: {
+        layers: {
+            path: string;
+            description: string;
+            name: string;
+            fileCount: number;
+            keyFiles?: string[] | undefined;
+        }[];
+        entryPoints: string[];
+        diagram: string;
+        simpleDiagram?: string | undefined;
+    };
+    status: "active" | "internal" | "beta" | "stable" | "deprecated";
+    description: string;
+    category: "internal" | "npm_package" | "saas" | "library" | "website";
+    name: string;
+    version: string;
+    stats: {
+        components: number;
+        dependencies: {
+            internal: number;
+            external: number;
+        };
+        totalFiles: number;
+        totalLOC: number;
+        languages: Record<string, number>;
+        frameworks: string[];
+        totalSymbols: number;
+        tests: number;
+        topPackages?: {
+            name: string;
+            usageCount: number;
+        }[] | undefined;
+    };
+    projectId: string;
+    slug: string;
+    features: {
+        description: string;
+        id: string;
+        category: "security" | "ai" | "core" | "integration" | "storage" | "developer";
+        name: string;
+        detectedFrom: string;
+        files?: string[] | undefined;
+        confidence?: number | undefined;
+        icon?: string | undefined;
+    }[];
+    generatedAt: string;
+    lastUpdatedAt: string;
+    sourceFileCount: number;
+    longDescription?: string | undefined;
+    packageInfo?: {
+        version: string;
+        dependencies: Record<string, string>;
+        devDependencies?: Record<string, string> | undefined;
+        scripts?: Record<string, string> | undefined;
+    } | undefined;
+    links?: {
+        website?: string | undefined;
+        github?: string | undefined;
+        npm?: string | undefined;
+        docs?: string | undefined;
+    } | undefined;
+    simpleExplanation?: {
+        oneLiner: string;
+        analogy: string;
+        benefits: string[];
+        beforeAfter?: {
+            before: string;
+            after: string;
+        } | undefined;
+    } | undefined;
+}>;
+export type ProjectDocContent = z.infer<typeof ProjectDocContentSchema>;
+/**
+ * Pattern for detecting features in code
+ */
+export interface FeaturePattern {
+    id: string;
+    name: string;
+    description: string;
+    category: FeatureCategory;
+    icon?: string;
+    /** File path patterns (glob) */
+    filePatterns?: string[];
+    /** Import patterns (regex) */
+    importPatterns?: string[];
+    /** Code patterns (regex) */
+    codePatterns?: string[];
+    /** Minimum occurrences to detect */
+    minOccurrences?: number;
+}
+/**
+ * Default feature detection patterns
+ */
+export declare const DEFAULT_FEATURE_PATTERNS: FeaturePattern[];
+/**
+ * Create empty project stats
+ */
+export declare function createEmptyStats(): ProjectStats;
+/**
+ * Create empty architecture
+ */
+export declare function createEmptyArchitecture(): ProjectArchitecture;
+/**
+ * Create project doc content
+ */
+export declare function createProjectDoc(projectId: DevSystem, name: string, options?: Partial<Omit<ProjectDocContent, 'projectId' | 'name' | 'generatedAt' | 'lastUpdatedAt'>>): ProjectDocContent;
+/**
+ * Configuration for each project in the ecosystem
+ */
+export interface ProjectConfig {
+    projectId: DevSystem;
+    name: string;
+    slug: string;
+    description: string;
+    category: ProjectDocContent['category'];
+    status: ProjectDocContent['status'];
+    /** Root path to scan (relative to project root) */
+    scanPath: string;
+    /** Package.json path (if npm package) */
+    packageJsonPath?: string;
+    /** Links */
+    links?: ProjectDocContent['links'];
+    /** Custom simple explanation */
+    simpleExplanation?: ProjectDocContent['simpleExplanation'];
+}
+/**
+ * Default project configurations
+ */
+export declare const PROJECT_CONFIGS: Record<string, ProjectConfig>;
+declare const _default: {
+    AutoDetectedFeatureSchema: z.ZodObject<{
+        /** Unique feature ID */
+        id: z.ZodString;
+        /** Feature name */
+        name: z.ZodString;
+        /** Human-readable description */
+        description: z.ZodString;
+        /** Feature category */
+        category: z.ZodEnum<["core", "integration", "storage", "ai", "developer", "security"]>;
+        /** Icon identifier for UI (e.g., 'database', 'cloud', 'brain') */
+        icon: z.ZodOptional<z.ZodString>;
+        /** Pattern that detected this feature */
+        detectedFrom: z.ZodString;
+        /** Files where this feature is implemented */
+        files: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        /** Confidence score (0-1) */
+        confidence: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        description: string;
+        files: string[];
+        id: string;
+        category: "security" | "ai" | "core" | "integration" | "storage" | "developer";
+        name: string;
+        confidence: number;
+        detectedFrom: string;
+        icon?: string | undefined;
+    }, {
+        description: string;
+        id: string;
+        category: "security" | "ai" | "core" | "integration" | "storage" | "developer";
+        name: string;
+        detectedFrom: string;
+        files?: string[] | undefined;
+        confidence?: number | undefined;
+        icon?: string | undefined;
+    }>;
+    ProjectArchitectureSchema: z.ZodObject<{
+        /** Detected layers */
+        layers: z.ZodArray<z.ZodObject<{
+            /** Layer name (e.g., 'hooks', 'services', 'db') */
+            name: z.ZodString;
+            /** Layer description */
+            description: z.ZodString;
+            /** Directory path pattern */
+            path: z.ZodString;
+            /** Number of files in this layer */
+            fileCount: z.ZodNumber;
+            /** Key files in this layer */
+            keyFiles: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            path: string;
+            description: string;
+            name: string;
+            fileCount: number;
+            keyFiles: string[];
+        }, {
+            path: string;
+            description: string;
+            name: string;
+            fileCount: number;
+            keyFiles?: string[] | undefined;
+        }>, "many">;
+        /** Entry points (main files) */
+        entryPoints: z.ZodArray<z.ZodString, "many">;
+        /** Mermaid diagram source */
+        diagram: z.ZodString;
+        /** Simplified diagram for beginners */
+        simpleDiagram: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        layers: {
+            path: string;
+            description: string;
+            name: string;
+            fileCount: number;
+            keyFiles: string[];
+        }[];
+        entryPoints: string[];
+        diagram: string;
+        simpleDiagram?: string | undefined;
+    }, {
+        layers: {
+            path: string;
+            description: string;
+            name: string;
+            fileCount: number;
+            keyFiles?: string[] | undefined;
+        }[];
+        entryPoints: string[];
+        diagram: string;
+        simpleDiagram?: string | undefined;
+    }>;
+    ProjectStatsSchema: z.ZodObject<{
+        /** Total number of indexed files */
+        totalFiles: z.ZodNumber;
+        /** Total lines of code */
+        totalLOC: z.ZodNumber;
+        /** Lines of code by language */
+        languages: z.ZodRecord<z.ZodString, z.ZodNumber>;
+        /** Detected frameworks */
+        frameworks: z.ZodArray<z.ZodString, "many">;
+        /** Total exported symbols */
+        totalSymbols: z.ZodNumber;
+        /** Number of components (React) */
+        components: z.ZodNumber;
+        /** Number of tests */
+        tests: z.ZodNumber;
+        /** Dependency counts */
+        dependencies: z.ZodObject<{
+            internal: z.ZodNumber;
+            external: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            internal: number;
+            external: number;
+        }, {
+            internal: number;
+            external: number;
+        }>;
+        /** Top external packages used */
+        topPackages: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            usageCount: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            usageCount: number;
+        }, {
+            name: string;
+            usageCount: number;
+        }>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        components: number;
+        dependencies: {
+            internal: number;
+            external: number;
+        };
+        totalFiles: number;
+        totalLOC: number;
+        languages: Record<string, number>;
+        frameworks: string[];
+        totalSymbols: number;
+        tests: number;
+        topPackages: {
+            name: string;
+            usageCount: number;
+        }[];
+    }, {
+        components: number;
+        dependencies: {
+            internal: number;
+            external: number;
+        };
+        totalFiles: number;
+        totalLOC: number;
+        languages: Record<string, number>;
+        frameworks: string[];
+        totalSymbols: number;
+        tests: number;
+        topPackages?: {
+            name: string;
+            usageCount: number;
+        }[] | undefined;
+    }>;
+    ProjectDocContentSchema: z.ZodObject<{
+        /** Project system ID */
+        projectId: z.ZodString;
+        /** Human-readable project name */
+        name: z.ZodString;
+        /** URL-friendly slug */
+        slug: z.ZodString;
+        /** Current version (from package.json if available) */
+        version: z.ZodString;
+        /** Short description */
+        description: z.ZodString;
+        /** Long description (for detail page) */
+        longDescription: z.ZodOptional<z.ZodString>;
+        /** Project status */
+        status: z.ZodEnum<["active", "beta", "stable", "deprecated", "internal"]>;
+        /** Project category */
+        category: z.ZodEnum<["npm_package", "saas", "internal", "library", "website"]>;
+        /** Aggregated stats */
+        stats: z.ZodObject<{
+            /** Total number of indexed files */
+            totalFiles: z.ZodNumber;
+            /** Total lines of code */
+            totalLOC: z.ZodNumber;
+            /** Lines of code by language */
+            languages: z.ZodRecord<z.ZodString, z.ZodNumber>;
+            /** Detected frameworks */
+            frameworks: z.ZodArray<z.ZodString, "many">;
+            /** Total exported symbols */
+            totalSymbols: z.ZodNumber;
+            /** Number of components (React) */
+            components: z.ZodNumber;
+            /** Number of tests */
+            tests: z.ZodNumber;
+            /** Dependency counts */
+            dependencies: z.ZodObject<{
+                internal: z.ZodNumber;
+                external: z.ZodNumber;
+            }, "strip", z.ZodTypeAny, {
+                internal: number;
+                external: number;
+            }, {
+                internal: number;
+                external: number;
+            }>;
+            /** Top external packages used */
+            topPackages: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                usageCount: z.ZodNumber;
+            }, "strip", z.ZodTypeAny, {
+                name: string;
+                usageCount: number;
+            }, {
+                name: string;
+                usageCount: number;
+            }>, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            components: number;
+            dependencies: {
+                internal: number;
+                external: number;
+            };
+            totalFiles: number;
+            totalLOC: number;
+            languages: Record<string, number>;
+            frameworks: string[];
+            totalSymbols: number;
+            tests: number;
+            topPackages: {
+                name: string;
+                usageCount: number;
+            }[];
+        }, {
+            components: number;
+            dependencies: {
+                internal: number;
+                external: number;
+            };
+            totalFiles: number;
+            totalLOC: number;
+            languages: Record<string, number>;
+            frameworks: string[];
+            totalSymbols: number;
+            tests: number;
+            topPackages?: {
+                name: string;
+                usageCount: number;
+            }[] | undefined;
+        }>;
+        /** Auto-detected features */
+        features: z.ZodArray<z.ZodObject<{
+            /** Unique feature ID */
+            id: z.ZodString;
+            /** Feature name */
+            name: z.ZodString;
+            /** Human-readable description */
+            description: z.ZodString;
+            /** Feature category */
+            category: z.ZodEnum<["core", "integration", "storage", "ai", "developer", "security"]>;
+            /** Icon identifier for UI (e.g., 'database', 'cloud', 'brain') */
+            icon: z.ZodOptional<z.ZodString>;
+            /** Pattern that detected this feature */
+            detectedFrom: z.ZodString;
+            /** Files where this feature is implemented */
+            files: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+            /** Confidence score (0-1) */
+            confidence: z.ZodDefault<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            description: string;
+            files: string[];
+            id: string;
+            category: "security" | "ai" | "core" | "integration" | "storage" | "developer";
+            name: string;
+            confidence: number;
+            detectedFrom: string;
+            icon?: string | undefined;
+        }, {
+            description: string;
+            id: string;
+            category: "security" | "ai" | "core" | "integration" | "storage" | "developer";
+            name: string;
+            detectedFrom: string;
+            files?: string[] | undefined;
+            confidence?: number | undefined;
+            icon?: string | undefined;
+        }>, "many">;
+        /** Architecture info */
+        architecture: z.ZodObject<{
+            /** Detected layers */
+            layers: z.ZodArray<z.ZodObject<{
+                /** Layer name (e.g., 'hooks', 'services', 'db') */
+                name: z.ZodString;
+                /** Layer description */
+                description: z.ZodString;
+                /** Directory path pattern */
+                path: z.ZodString;
+                /** Number of files in this layer */
+                fileCount: z.ZodNumber;
+                /** Key files in this layer */
+                keyFiles: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+            }, "strip", z.ZodTypeAny, {
+                path: string;
+                description: string;
+                name: string;
+                fileCount: number;
+                keyFiles: string[];
+            }, {
+                path: string;
+                description: string;
+                name: string;
+                fileCount: number;
+                keyFiles?: string[] | undefined;
+            }>, "many">;
+            /** Entry points (main files) */
+            entryPoints: z.ZodArray<z.ZodString, "many">;
+            /** Mermaid diagram source */
+            diagram: z.ZodString;
+            /** Simplified diagram for beginners */
+            simpleDiagram: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            layers: {
+                path: string;
+                description: string;
+                name: string;
+                fileCount: number;
+                keyFiles: string[];
+            }[];
+            entryPoints: string[];
+            diagram: string;
+            simpleDiagram?: string | undefined;
+        }, {
+            layers: {
+                path: string;
+                description: string;
+                name: string;
+                fileCount: number;
+                keyFiles?: string[] | undefined;
+            }[];
+            entryPoints: string[];
+            diagram: string;
+            simpleDiagram?: string | undefined;
+        }>;
+        /** Package.json info */
+        packageInfo: z.ZodOptional<z.ZodObject<{
+            version: z.ZodString;
+            dependencies: z.ZodRecord<z.ZodString, z.ZodString>;
+            devDependencies: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            scripts: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        }, "strip", z.ZodTypeAny, {
+            version: string;
+            dependencies: Record<string, string>;
+            devDependencies?: Record<string, string> | undefined;
+            scripts?: Record<string, string> | undefined;
+        }, {
+            version: string;
+            dependencies: Record<string, string>;
+            devDependencies?: Record<string, string> | undefined;
+            scripts?: Record<string, string> | undefined;
+        }>>;
+        /** External links */
+        links: z.ZodOptional<z.ZodObject<{
+            github: z.ZodOptional<z.ZodString>;
+            npm: z.ZodOptional<z.ZodString>;
+            docs: z.ZodOptional<z.ZodString>;
+            website: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            website?: string | undefined;
+            github?: string | undefined;
+            npm?: string | undefined;
+            docs?: string | undefined;
+        }, {
+            website?: string | undefined;
+            github?: string | undefined;
+            npm?: string | undefined;
+            docs?: string | undefined;
+        }>>;
+        /** Simple explanation for beginners */
+        simpleExplanation: z.ZodOptional<z.ZodObject<{
+            /** One-sentence explanation */
+            oneLiner: z.ZodString;
+            /** Analogy for non-technical people */
+            analogy: z.ZodString;
+            /** Key benefits (3-5 points) */
+            benefits: z.ZodArray<z.ZodString, "many">;
+            /** Before/after comparison */
+            beforeAfter: z.ZodOptional<z.ZodObject<{
+                before: z.ZodString;
+                after: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                before: string;
+                after: string;
+            }, {
+                before: string;
+                after: string;
+            }>>;
+        }, "strip", z.ZodTypeAny, {
+            oneLiner: string;
+            analogy: string;
+            benefits: string[];
+            beforeAfter?: {
+                before: string;
+                after: string;
+            } | undefined;
+        }, {
+            oneLiner: string;
+            analogy: string;
+            benefits: string[];
+            beforeAfter?: {
+                before: string;
+                after: string;
+            } | undefined;
+        }>>;
+        /** First generation timestamp */
+        generatedAt: z.ZodString;
+        /** Last update timestamp */
+        lastUpdatedAt: z.ZodString;
+        /** Source files used for generation */
+        sourceFileCount: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        architecture: {
+            layers: {
+                path: string;
+                description: string;
+                name: string;
+                fileCount: number;
+                keyFiles: string[];
+            }[];
+            entryPoints: string[];
+            diagram: string;
+            simpleDiagram?: string | undefined;
+        };
+        status: "active" | "internal" | "beta" | "stable" | "deprecated";
+        description: string;
+        category: "internal" | "npm_package" | "saas" | "library" | "website";
+        name: string;
+        version: string;
+        stats: {
+            components: number;
+            dependencies: {
+                internal: number;
+                external: number;
+            };
+            totalFiles: number;
+            totalLOC: number;
+            languages: Record<string, number>;
+            frameworks: string[];
+            totalSymbols: number;
+            tests: number;
+            topPackages: {
+                name: string;
+                usageCount: number;
+            }[];
+        };
+        projectId: string;
+        slug: string;
+        features: {
+            description: string;
+            files: string[];
+            id: string;
+            category: "security" | "ai" | "core" | "integration" | "storage" | "developer";
+            name: string;
+            confidence: number;
+            detectedFrom: string;
+            icon?: string | undefined;
+        }[];
+        generatedAt: string;
+        lastUpdatedAt: string;
+        sourceFileCount: number;
+        longDescription?: string | undefined;
+        packageInfo?: {
+            version: string;
+            dependencies: Record<string, string>;
+            devDependencies?: Record<string, string> | undefined;
+            scripts?: Record<string, string> | undefined;
+        } | undefined;
+        links?: {
+            website?: string | undefined;
+            github?: string | undefined;
+            npm?: string | undefined;
+            docs?: string | undefined;
+        } | undefined;
+        simpleExplanation?: {
+            oneLiner: string;
+            analogy: string;
+            benefits: string[];
+            beforeAfter?: {
+                before: string;
+                after: string;
+            } | undefined;
+        } | undefined;
+    }, {
+        architecture: {
+            layers: {
+                path: string;
+                description: string;
+                name: string;
+                fileCount: number;
+                keyFiles?: string[] | undefined;
+            }[];
+            entryPoints: string[];
+            diagram: string;
+            simpleDiagram?: string | undefined;
+        };
+        status: "active" | "internal" | "beta" | "stable" | "deprecated";
+        description: string;
+        category: "internal" | "npm_package" | "saas" | "library" | "website";
+        name: string;
+        version: string;
+        stats: {
+            components: number;
+            dependencies: {
+                internal: number;
+                external: number;
+            };
+            totalFiles: number;
+            totalLOC: number;
+            languages: Record<string, number>;
+            frameworks: string[];
+            totalSymbols: number;
+            tests: number;
+            topPackages?: {
+                name: string;
+                usageCount: number;
+            }[] | undefined;
+        };
+        projectId: string;
+        slug: string;
+        features: {
+            description: string;
+            id: string;
+            category: "security" | "ai" | "core" | "integration" | "storage" | "developer";
+            name: string;
+            detectedFrom: string;
+            files?: string[] | undefined;
+            confidence?: number | undefined;
+            icon?: string | undefined;
+        }[];
+        generatedAt: string;
+        lastUpdatedAt: string;
+        sourceFileCount: number;
+        longDescription?: string | undefined;
+        packageInfo?: {
+            version: string;
+            dependencies: Record<string, string>;
+            devDependencies?: Record<string, string> | undefined;
+            scripts?: Record<string, string> | undefined;
+        } | undefined;
+        links?: {
+            website?: string | undefined;
+            github?: string | undefined;
+            npm?: string | undefined;
+            docs?: string | undefined;
+        } | undefined;
+        simpleExplanation?: {
+            oneLiner: string;
+            analogy: string;
+            benefits: string[];
+            beforeAfter?: {
+                before: string;
+                after: string;
+            } | undefined;
+        } | undefined;
+    }>;
+    createEmptyStats: typeof createEmptyStats;
+    createEmptyArchitecture: typeof createEmptyArchitecture;
+    createProjectDoc: typeof createProjectDoc;
+    DEFAULT_FEATURE_PATTERNS: FeaturePattern[];
+    PROJECT_CONFIGS: Record<string, ProjectConfig>;
+};
+export default _default;
+//# sourceMappingURL=docs-types.d.ts.map