@reftrixmcp/mcp-server 0.1.7

package/dist/services/vision-adapter/interface.d.ts

@@ -0,0 +1,1434 @@
+/**
+ * IVisionAnalyzer インターフェース定義
+ *
+ * ビジョン解析アダプタのプラガブルなインターフェースを定義します。
+ * LlamaVision、Claude Vision、Mock等の実装を切り替え可能にするための設計です。
+ *
+ * @module vision-adapter/interface
+ * @see docs/plans/webdesign/00-overview.md (ビジョン解析アダプタ セクション)
+ */
+import { z } from "zod";
+/**
+ * 抽出する特徴の種類
+ */
+export type VisionFeatureType = "layout_structure" | "color_palette" | "typography" | "visual_hierarchy" | "whitespace" | "density" | "rhythm" | "section_boundaries" | "motion_candidates" | "brand_tone" | "ai_cliches";
+/**
+ * VisionFeatureType の Zod スキーマ
+ */
+export declare const visionFeatureTypeSchema: z.ZodEnum<["layout_structure", "color_palette", "typography", "visual_hierarchy", "whitespace", "density", "rhythm", "section_boundaries", "motion_candidates", "brand_tone", "ai_cliches"]>;
+/**
+ * ビジョン解析の入力オプション
+ */
+export interface VisionAnalysisOptions {
+    /** 解析対象の画像バッファ */
+    imageBuffer: Buffer;
+    /** 画像のMIMEタイプ */
+    mimeType: "image/png" | "image/jpeg" | "image/webp";
+    /** 解析プロンプト（オプション） */
+    prompt?: string;
+    /** 抽出する特徴の種類 */
+    features?: VisionFeatureType[];
+    /** タイムアウト（ミリ秒） */
+    timeout?: number;
+}
+/**
+ * VisionAnalysisOptions の Zod スキーマ
+ */
+export declare const visionAnalysisOptionsSchema: z.ZodObject<{
+    imageBuffer: z.ZodType<Buffer<ArrayBufferLike>, z.ZodTypeDef, Buffer<ArrayBufferLike>>;
+    mimeType: z.ZodEnum<["image/png", "image/jpeg", "image/webp"]>;
+    prompt: z.ZodOptional<z.ZodString>;
+    features: z.ZodOptional<z.ZodArray<z.ZodEnum<["layout_structure", "color_palette", "typography", "visual_hierarchy", "whitespace", "density", "rhythm", "section_boundaries", "motion_candidates", "brand_tone", "ai_cliches"]>, "many">>;
+    timeout: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    mimeType: "image/png" | "image/jpeg" | "image/webp";
+    imageBuffer: Buffer<ArrayBufferLike>;
+    timeout?: number | undefined;
+    features?: ("typography" | "density" | "layout_structure" | "color_palette" | "visual_hierarchy" | "whitespace" | "rhythm" | "section_boundaries" | "motion_candidates" | "brand_tone" | "ai_cliches")[] | undefined;
+    prompt?: string | undefined;
+}, {
+    mimeType: "image/png" | "image/jpeg" | "image/webp";
+    imageBuffer: Buffer<ArrayBufferLike>;
+    timeout?: number | undefined;
+    features?: ("typography" | "density" | "layout_structure" | "color_palette" | "visual_hierarchy" | "whitespace" | "rhythm" | "section_boundaries" | "motion_candidates" | "brand_tone" | "ai_cliches")[] | undefined;
+    prompt?: string | undefined;
+}>;
+/**
+ * レイアウト構造データ
+ */
+export interface LayoutStructureData {
+    type: "layout_structure";
+    gridType: "single-column" | "two-column" | "three-column" | "grid" | "masonry" | "asymmetric";
+    mainAreas: string[];
+    description: string;
+}
+/**
+ * カラーパレットデータ
+ */
+export interface ColorPaletteData {
+    type: "color_palette";
+    dominantColors: string[];
+    mood: string;
+    contrast: "high" | "medium" | "low";
+}
+/**
+ * タイポグラフィデータ
+ */
+export interface TypographyData {
+    type: "typography";
+    headingStyle: string;
+    bodyStyle: string;
+    hierarchy: string[];
+}
+/**
+ * 視覚的階層データ
+ */
+export interface VisualHierarchyData {
+    type: "visual_hierarchy";
+    focalPoints: string[];
+    flowDirection: "top-to-bottom" | "left-to-right" | "z-pattern" | "f-pattern";
+    emphasisTechniques: string[];
+}
+/**
+ * 余白データ
+ */
+export interface WhitespaceData {
+    type: "whitespace";
+    amount: "minimal" | "moderate" | "generous" | "extreme";
+    distribution: "even" | "top-heavy" | "bottom-heavy" | "centered";
+}
+/**
+ * 情報密度データ
+ */
+export interface DensityData {
+    type: "density";
+    level: "sparse" | "balanced" | "dense" | "cluttered";
+    description: string;
+}
+/**
+ * 視覚的リズムデータ
+ */
+export interface RhythmData {
+    type: "rhythm";
+    pattern: "regular" | "irregular" | "progressive" | "alternating";
+    description: string;
+}
+/**
+ * セクション境界データ
+ */
+export interface SectionBoundariesData {
+    type: "section_boundaries";
+    sections: Array<{
+        type: string;
+        startY: number;
+        endY: number;
+        confidence: number;
+    }>;
+}
+/**
+ * アニメーション候補データ（Vision検出）
+ *
+ * スクリーンショットから推定されるアニメーション対象要素。
+ * CSS/JS静的解析の補完として使用。
+ */
+export interface MotionCandidatesData {
+    type: "motion_candidates";
+    /** 推定されるアニメーション */
+    likelyAnimations: Array<{
+        element: string;
+        animationType: "fade-in" | "slide" | "scale" | "rotate" | "hover-scale" | "hover-lift" | "parallax" | "other";
+        confidence: number;
+    }>;
+    /** インタラクティブ要素 */
+    interactiveElements: string[];
+    /** スクロールトリガー候補 */
+    scrollTriggers: string[];
+}
+/**
+ * ブランドトーンデータ
+ *
+ * デザインの視覚的トーンとブランドパーソナリティ分析結果。
+ */
+export interface BrandToneData {
+    type: "brand_tone";
+    /** プロフェッショナリズム */
+    professionalism: "minimal" | "moderate" | "bold";
+    /** 温かみ */
+    warmth: "cold" | "neutral" | "warm";
+    /** モダンさ */
+    modernity: "classic" | "contemporary" | "futuristic";
+    /** エネルギー */
+    energy: "calm" | "balanced" | "dynamic";
+    /** ターゲットオーディエンス */
+    targetAudience: "enterprise" | "startup" | "creative" | "consumer";
+    /** 視覚的指標 */
+    indicators: string[];
+}
+/**
+ * AIクリシェ検出データ
+ *
+ * AI生成デザインの典型的パターン検出結果。
+ * quality.evaluateのOriginality評価に活用。
+ */
+export interface AiClichesData {
+    type: "ai_cliches";
+    /** 検出されたクリシェ */
+    clichesDetected: Array<{
+        clicheType: "gradient_orbs" | "generic_isometric" | "meaningless_patterns" | "oversaturated_gradients" | "ai_generated_people" | "floating_ui" | "generic_hero" | "symmetrical_layout" | "other";
+        location: string;
+        severity: "low" | "medium" | "high";
+    }>;
+    /** オリジナリティスコア (0-100) */
+    originalityScore: number;
+    /** 評価 */
+    assessment: "highly-original" | "mostly-original" | "moderate-ai-influence" | "heavy-ai-influence";
+    /** 改善提案 */
+    suggestions: string[];
+}
+/**
+ * 特徴の詳細データ（種類別）
+ */
+export type VisionFeatureData = LayoutStructureData | ColorPaletteData | TypographyData | VisualHierarchyData | WhitespaceData | DensityData | RhythmData | SectionBoundariesData | MotionCandidatesData | BrandToneData | AiClichesData;
+/**
+ * 抽出された特徴
+ */
+export interface VisionFeature {
+    /** 特徴の種類 */
+    type: VisionFeatureType;
+    /** 信頼度 (0-1) */
+    confidence: number;
+    /** 特徴の詳細データ */
+    data: VisionFeatureData;
+}
+/**
+ * VisionFeature の Zod スキーマ
+ */
+export declare const visionFeatureSchema: z.ZodObject<{
+    type: z.ZodEnum<["layout_structure", "color_palette", "typography", "visual_hierarchy", "whitespace", "density", "rhythm", "section_boundaries", "motion_candidates", "brand_tone", "ai_cliches"]>;
+    confidence: z.ZodNumber;
+    data: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+        type: z.ZodLiteral<"layout_structure">;
+        gridType: z.ZodEnum<["single-column", "two-column", "three-column", "grid", "masonry", "asymmetric"]>;
+        mainAreas: z.ZodArray<z.ZodString, "many">;
+        description: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: "layout_structure";
+        description: string;
+        gridType: "asymmetric" | "grid" | "single-column" | "two-column" | "three-column" | "masonry";
+        mainAreas: string[];
+    }, {
+        type: "layout_structure";
+        description: string;
+        gridType: "asymmetric" | "grid" | "single-column" | "two-column" | "three-column" | "masonry";
+        mainAreas: string[];
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"color_palette">;
+        dominantColors: z.ZodArray<z.ZodString, "many">;
+        mood: z.ZodString;
+        contrast: z.ZodEnum<["high", "medium", "low"]>;
+    }, "strip", z.ZodTypeAny, {
+        type: "color_palette";
+        mood: string;
+        dominantColors: string[];
+        contrast: "high" | "medium" | "low";
+    }, {
+        type: "color_palette";
+        mood: string;
+        dominantColors: string[];
+        contrast: "high" | "medium" | "low";
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"typography">;
+        headingStyle: z.ZodString;
+        bodyStyle: z.ZodString;
+        hierarchy: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        type: "typography";
+        headingStyle: string;
+        bodyStyle: string;
+        hierarchy: string[];
+    }, {
+        type: "typography";
+        headingStyle: string;
+        bodyStyle: string;
+        hierarchy: string[];
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"visual_hierarchy">;
+        focalPoints: z.ZodArray<z.ZodString, "many">;
+        flowDirection: z.ZodEnum<["top-to-bottom", "left-to-right", "z-pattern", "f-pattern"]>;
+        emphasisTechniques: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        type: "visual_hierarchy";
+        focalPoints: string[];
+        flowDirection: "top-to-bottom" | "left-to-right" | "z-pattern" | "f-pattern";
+        emphasisTechniques: string[];
+    }, {
+        type: "visual_hierarchy";
+        focalPoints: string[];
+        flowDirection: "top-to-bottom" | "left-to-right" | "z-pattern" | "f-pattern";
+        emphasisTechniques: string[];
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"whitespace">;
+        amount: z.ZodEnum<["minimal", "moderate", "generous", "extreme"]>;
+        distribution: z.ZodEnum<["even", "top-heavy", "bottom-heavy", "centered"]>;
+    }, "strip", z.ZodTypeAny, {
+        type: "whitespace";
+        amount: "minimal" | "moderate" | "generous" | "extreme";
+        distribution: "even" | "top-heavy" | "bottom-heavy" | "centered";
+    }, {
+        type: "whitespace";
+        amount: "minimal" | "moderate" | "generous" | "extreme";
+        distribution: "even" | "top-heavy" | "bottom-heavy" | "centered";
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"density">;
+        level: z.ZodEnum<["sparse", "balanced", "dense", "cluttered"]>;
+        description: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: "density";
+        description: string;
+        level: "sparse" | "balanced" | "dense" | "cluttered";
+    }, {
+        type: "density";
+        description: string;
+        level: "sparse" | "balanced" | "dense" | "cluttered";
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"rhythm">;
+        pattern: z.ZodEnum<["regular", "irregular", "progressive", "alternating"]>;
+        description: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: "rhythm";
+        pattern: "progressive" | "irregular" | "regular" | "alternating";
+        description: string;
+    }, {
+        type: "rhythm";
+        pattern: "progressive" | "irregular" | "regular" | "alternating";
+        description: string;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"section_boundaries">;
+        sections: z.ZodArray<z.ZodObject<{
+            type: z.ZodString;
+            startY: z.ZodNumber;
+            endY: z.ZodNumber;
+            confidence: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            type: string;
+            confidence: number;
+            startY: number;
+            endY: number;
+        }, {
+            type: string;
+            confidence: number;
+            startY: number;
+            endY: number;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        sections: {
+            type: string;
+            confidence: number;
+            startY: number;
+            endY: number;
+        }[];
+        type: "section_boundaries";
+    }, {
+        sections: {
+            type: string;
+            confidence: number;
+            startY: number;
+            endY: number;
+        }[];
+        type: "section_boundaries";
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"motion_candidates">;
+        likelyAnimations: z.ZodArray<z.ZodObject<{
+            element: z.ZodString;
+            animationType: z.ZodEnum<["fade-in", "slide", "scale", "rotate", "hover-scale", "hover-lift", "parallax", "other"]>;
+            confidence: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            confidence: number;
+            element: string;
+            animationType: "other" | "parallax" | "scale" | "fade-in" | "slide" | "rotate" | "hover-scale" | "hover-lift";
+        }, {
+            confidence: number;
+            element: string;
+            animationType: "other" | "parallax" | "scale" | "fade-in" | "slide" | "rotate" | "hover-scale" | "hover-lift";
+        }>, "many">;
+        interactiveElements: z.ZodArray<z.ZodString, "many">;
+        scrollTriggers: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        type: "motion_candidates";
+        likelyAnimations: {
+            confidence: number;
+            element: string;
+            animationType: "other" | "parallax" | "scale" | "fade-in" | "slide" | "rotate" | "hover-scale" | "hover-lift";
+        }[];
+        interactiveElements: string[];
+        scrollTriggers: string[];
+    }, {
+        type: "motion_candidates";
+        likelyAnimations: {
+            confidence: number;
+            element: string;
+            animationType: "other" | "parallax" | "scale" | "fade-in" | "slide" | "rotate" | "hover-scale" | "hover-lift";
+        }[];
+        interactiveElements: string[];
+        scrollTriggers: string[];
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"brand_tone">;
+        professionalism: z.ZodEnum<["minimal", "moderate", "bold"]>;
+        warmth: z.ZodEnum<["cold", "neutral", "warm"]>;
+        modernity: z.ZodEnum<["classic", "contemporary", "futuristic"]>;
+        energy: z.ZodEnum<["calm", "balanced", "dynamic"]>;
+        targetAudience: z.ZodEnum<["enterprise", "startup", "creative", "consumer"]>;
+        indicators: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        type: "brand_tone";
+        targetAudience: "startup" | "creative" | "enterprise" | "consumer";
+        professionalism: "bold" | "minimal" | "moderate";
+        warmth: "neutral" | "cold" | "warm";
+        modernity: "classic" | "contemporary" | "futuristic";
+        energy: "calm" | "balanced" | "dynamic";
+        indicators: string[];
+    }, {
+        type: "brand_tone";
+        targetAudience: "startup" | "creative" | "enterprise" | "consumer";
+        professionalism: "bold" | "minimal" | "moderate";
+        warmth: "neutral" | "cold" | "warm";
+        modernity: "classic" | "contemporary" | "futuristic";
+        energy: "calm" | "balanced" | "dynamic";
+        indicators: string[];
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"ai_cliches">;
+        clichesDetected: z.ZodArray<z.ZodObject<{
+            clicheType: z.ZodEnum<["gradient_orbs", "generic_isometric", "meaningless_patterns", "oversaturated_gradients", "ai_generated_people", "floating_ui", "generic_hero", "symmetrical_layout", "other"]>;
+            location: z.ZodString;
+            severity: z.ZodEnum<["low", "medium", "high"]>;
+        }, "strip", z.ZodTypeAny, {
+            severity: "high" | "medium" | "low";
+            location: string;
+            clicheType: "other" | "gradient_orbs" | "generic_isometric" | "meaningless_patterns" | "oversaturated_gradients" | "ai_generated_people" | "floating_ui" | "generic_hero" | "symmetrical_layout";
+        }, {
+            severity: "high" | "medium" | "low";
+            location: string;
+            clicheType: "other" | "gradient_orbs" | "generic_isometric" | "meaningless_patterns" | "oversaturated_gradients" | "ai_generated_people" | "floating_ui" | "generic_hero" | "symmetrical_layout";
+        }>, "many">;
+        originalityScore: z.ZodNumber;
+        assessment: z.ZodEnum<["highly-original", "mostly-original", "moderate-ai-influence", "heavy-ai-influence"]>;
+        suggestions: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        type: "ai_cliches";
+        clichesDetected: {
+            severity: "high" | "medium" | "low";
+            location: string;
+            clicheType: "other" | "gradient_orbs" | "generic_isometric" | "meaningless_patterns" | "oversaturated_gradients" | "ai_generated_people" | "floating_ui" | "generic_hero" | "symmetrical_layout";
+        }[];
+        originalityScore: number;
+        assessment: "highly-original" | "mostly-original" | "moderate-ai-influence" | "heavy-ai-influence";
+        suggestions: string[];
+    }, {
+        type: "ai_cliches";
+        clichesDetected: {
+            severity: "high" | "medium" | "low";
+            location: string;
+            clicheType: "other" | "gradient_orbs" | "generic_isometric" | "meaningless_patterns" | "oversaturated_gradients" | "ai_generated_people" | "floating_ui" | "generic_hero" | "symmetrical_layout";
+        }[];
+        originalityScore: number;
+        assessment: "highly-original" | "mostly-original" | "moderate-ai-influence" | "heavy-ai-influence";
+        suggestions: string[];
+    }>]>;
+}, "strip", z.ZodTypeAny, {
+    data: {
+        type: "layout_structure";
+        description: string;
+        gridType: "asymmetric" | "grid" | "single-column" | "two-column" | "three-column" | "masonry";
+        mainAreas: string[];
+    } | {
+        type: "color_palette";
+        mood: string;
+        dominantColors: string[];
+        contrast: "high" | "medium" | "low";
+    } | {
+        type: "typography";
+        headingStyle: string;
+        bodyStyle: string;
+        hierarchy: string[];
+    } | {
+        type: "visual_hierarchy";
+        focalPoints: string[];
+        flowDirection: "top-to-bottom" | "left-to-right" | "z-pattern" | "f-pattern";
+        emphasisTechniques: string[];
+    } | {
+        type: "whitespace";
+        amount: "minimal" | "moderate" | "generous" | "extreme";
+        distribution: "even" | "top-heavy" | "bottom-heavy" | "centered";
+    } | {
+        type: "density";
+        description: string;
+        level: "sparse" | "balanced" | "dense" | "cluttered";
+    } | {
+        type: "rhythm";
+        pattern: "progressive" | "irregular" | "regular" | "alternating";
+        description: string;
+    } | {
+        sections: {
+            type: string;
+            confidence: number;
+            startY: number;
+            endY: number;
+        }[];
+        type: "section_boundaries";
+    } | {
+        type: "motion_candidates";
+        likelyAnimations: {
+            confidence: number;
+            element: string;
+            animationType: "other" | "parallax" | "scale" | "fade-in" | "slide" | "rotate" | "hover-scale" | "hover-lift";
+        }[];
+        interactiveElements: string[];
+        scrollTriggers: string[];
+    } | {
+        type: "brand_tone";
+        targetAudience: "startup" | "creative" | "enterprise" | "consumer";
+        professionalism: "bold" | "minimal" | "moderate";
+        warmth: "neutral" | "cold" | "warm";
+        modernity: "classic" | "contemporary" | "futuristic";
+        energy: "calm" | "balanced" | "dynamic";
+        indicators: string[];
+    } | {
+        type: "ai_cliches";
+        clichesDetected: {
+            severity: "high" | "medium" | "low";
+            location: string;
+            clicheType: "other" | "gradient_orbs" | "generic_isometric" | "meaningless_patterns" | "oversaturated_gradients" | "ai_generated_people" | "floating_ui" | "generic_hero" | "symmetrical_layout";
+        }[];
+        originalityScore: number;
+        assessment: "highly-original" | "mostly-original" | "moderate-ai-influence" | "heavy-ai-influence";
+        suggestions: string[];
+    };
+    type: "typography" | "density" | "layout_structure" | "color_palette" | "visual_hierarchy" | "whitespace" | "rhythm" | "section_boundaries" | "motion_candidates" | "brand_tone" | "ai_cliches";
+    confidence: number;
+}, {
+    data: {
+        type: "layout_structure";
+        description: string;
+        gridType: "asymmetric" | "grid" | "single-column" | "two-column" | "three-column" | "masonry";
+        mainAreas: string[];
+    } | {
+        type: "color_palette";
+        mood: string;
+        dominantColors: string[];
+        contrast: "high" | "medium" | "low";
+    } | {
+        type: "typography";
+        headingStyle: string;
+        bodyStyle: string;
+        hierarchy: string[];
+    } | {
+        type: "visual_hierarchy";
+        focalPoints: string[];
+        flowDirection: "top-to-bottom" | "left-to-right" | "z-pattern" | "f-pattern";
+        emphasisTechniques: string[];
+    } | {
+        type: "whitespace";
+        amount: "minimal" | "moderate" | "generous" | "extreme";
+        distribution: "even" | "top-heavy" | "bottom-heavy" | "centered";
+    } | {
+        type: "density";
+        description: string;
+        level: "sparse" | "balanced" | "dense" | "cluttered";
+    } | {
+        type: "rhythm";
+        pattern: "progressive" | "irregular" | "regular" | "alternating";
+        description: string;
+    } | {
+        sections: {
+            type: string;
+            confidence: number;
+            startY: number;
+            endY: number;
+        }[];
+        type: "section_boundaries";
+    } | {
+        type: "motion_candidates";
+        likelyAnimations: {
+            confidence: number;
+            element: string;
+            animationType: "other" | "parallax" | "scale" | "fade-in" | "slide" | "rotate" | "hover-scale" | "hover-lift";
+        }[];
+        interactiveElements: string[];
+        scrollTriggers: string[];
+    } | {
+        type: "brand_tone";
+        targetAudience: "startup" | "creative" | "enterprise" | "consumer";
+        professionalism: "bold" | "minimal" | "moderate";
+        warmth: "neutral" | "cold" | "warm";
+        modernity: "classic" | "contemporary" | "futuristic";
+        energy: "calm" | "balanced" | "dynamic";
+        indicators: string[];
+    } | {
+        type: "ai_cliches";
+        clichesDetected: {
+            severity: "high" | "medium" | "low";
+            location: string;
+            clicheType: "other" | "gradient_orbs" | "generic_isometric" | "meaningless_patterns" | "oversaturated_gradients" | "ai_generated_people" | "floating_ui" | "generic_hero" | "symmetrical_layout";
+        }[];
+        originalityScore: number;
+        assessment: "highly-original" | "mostly-original" | "moderate-ai-influence" | "heavy-ai-influence";
+        suggestions: string[];
+    };
+    type: "typography" | "density" | "layout_structure" | "color_palette" | "visual_hierarchy" | "whitespace" | "rhythm" | "section_boundaries" | "motion_candidates" | "brand_tone" | "ai_cliches";
+    confidence: number;
+}>;
+/**
+ * ビジョン解析の結果
+ */
+export interface VisionAnalysisResult {
+    /** 解析成功フラグ */
+    success: boolean;
+    /** 抽出された特徴 */
+    features: VisionFeature[];
+    /** 生のレスポンス（デバッグ用） */
+    rawResponse?: string;
+    /** エラーメッセージ */
+    error?: string;
+    /** 処理時間（ミリ秒） */
+    processingTimeMs: number;
+    /** 使用したモデル名 */
+    modelName: string;
+}
+/**
+ * VisionAnalysisResult の Zod スキーマ
+ */
+export declare const visionAnalysisResultSchema: z.ZodObject<{
+    success: z.ZodBoolean;
+    features: z.ZodArray<z.ZodObject<{
+        type: z.ZodEnum<["layout_structure", "color_palette", "typography", "visual_hierarchy", "whitespace", "density", "rhythm", "section_boundaries", "motion_candidates", "brand_tone", "ai_cliches"]>;
+        confidence: z.ZodNumber;
+        data: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+            type: z.ZodLiteral<"layout_structure">;
+            gridType: z.ZodEnum<["single-column", "two-column", "three-column", "grid", "masonry", "asymmetric"]>;
+            mainAreas: z.ZodArray<z.ZodString, "many">;
+            description: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            type: "layout_structure";
+            description: string;
+            gridType: "asymmetric" | "grid" | "single-column" | "two-column" | "three-column" | "masonry";
+            mainAreas: string[];
+        }, {
+            type: "layout_structure";
+            description: string;
+            gridType: "asymmetric" | "grid" | "single-column" | "two-column" | "three-column" | "masonry";
+            mainAreas: string[];
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"color_palette">;
+            dominantColors: z.ZodArray<z.ZodString, "many">;
+            mood: z.ZodString;
+            contrast: z.ZodEnum<["high", "medium", "low"]>;
+        }, "strip", z.ZodTypeAny, {
+            type: "color_palette";
+            mood: string;
+            dominantColors: string[];
+            contrast: "high" | "medium" | "low";
+        }, {
+            type: "color_palette";
+            mood: string;
+            dominantColors: string[];
+            contrast: "high" | "medium" | "low";
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"typography">;
+            headingStyle: z.ZodString;
+            bodyStyle: z.ZodString;
+            hierarchy: z.ZodArray<z.ZodString, "many">;
+        }, "strip", z.ZodTypeAny, {
+            type: "typography";
+            headingStyle: string;
+            bodyStyle: string;
+            hierarchy: string[];
+        }, {
+            type: "typography";
+            headingStyle: string;
+            bodyStyle: string;
+            hierarchy: string[];
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"visual_hierarchy">;
+            focalPoints: z.ZodArray<z.ZodString, "many">;
+            flowDirection: z.ZodEnum<["top-to-bottom", "left-to-right", "z-pattern", "f-pattern"]>;
+            emphasisTechniques: z.ZodArray<z.ZodString, "many">;
+        }, "strip", z.ZodTypeAny, {
+            type: "visual_hierarchy";
+            focalPoints: string[];
+            flowDirection: "top-to-bottom" | "left-to-right" | "z-pattern" | "f-pattern";
+            emphasisTechniques: string[];
+        }, {
+            type: "visual_hierarchy";
+            focalPoints: string[];
+            flowDirection: "top-to-bottom" | "left-to-right" | "z-pattern" | "f-pattern";
+            emphasisTechniques: string[];
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"whitespace">;
+            amount: z.ZodEnum<["minimal", "moderate", "generous", "extreme"]>;
+            distribution: z.ZodEnum<["even", "top-heavy", "bottom-heavy", "centered"]>;
+        }, "strip", z.ZodTypeAny, {
+            type: "whitespace";
+            amount: "minimal" | "moderate" | "generous" | "extreme";
+            distribution: "even" | "top-heavy" | "bottom-heavy" | "centered";
+        }, {
+            type: "whitespace";
+            amount: "minimal" | "moderate" | "generous" | "extreme";
+            distribution: "even" | "top-heavy" | "bottom-heavy" | "centered";
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"density">;
+            level: z.ZodEnum<["sparse", "balanced", "dense", "cluttered"]>;
+            description: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            type: "density";
+            description: string;
+            level: "sparse" | "balanced" | "dense" | "cluttered";
+        }, {
+            type: "density";
+            description: string;
+            level: "sparse" | "balanced" | "dense" | "cluttered";
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"rhythm">;
+            pattern: z.ZodEnum<["regular", "irregular", "progressive", "alternating"]>;
+            description: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            type: "rhythm";
+            pattern: "progressive" | "irregular" | "regular" | "alternating";
+            description: string;
+        }, {
+            type: "rhythm";
+            pattern: "progressive" | "irregular" | "regular" | "alternating";
+            description: string;
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"section_boundaries">;
+            sections: z.ZodArray<z.ZodObject<{
+                type: z.ZodString;
+                startY: z.ZodNumber;
+                endY: z.ZodNumber;
+                confidence: z.ZodNumber;
+            }, "strip", z.ZodTypeAny, {
+                type: string;
+                confidence: number;
+                startY: number;
+                endY: number;
+            }, {
+                type: string;
+                confidence: number;
+                startY: number;
+                endY: number;
+            }>, "many">;
+        }, "strip", z.ZodTypeAny, {
+            sections: {
+                type: string;
+                confidence: number;
+                startY: number;
+                endY: number;
+            }[];
+            type: "section_boundaries";
+        }, {
+            sections: {
+                type: string;
+                confidence: number;
+                startY: number;
+                endY: number;
+            }[];
+            type: "section_boundaries";
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"motion_candidates">;
+            likelyAnimations: z.ZodArray<z.ZodObject<{
+                element: z.ZodString;
+                animationType: z.ZodEnum<["fade-in", "slide", "scale", "rotate", "hover-scale", "hover-lift", "parallax", "other"]>;
+                confidence: z.ZodNumber;
+            }, "strip", z.ZodTypeAny, {
+                confidence: number;
+                element: string;
+                animationType: "other" | "parallax" | "scale" | "fade-in" | "slide" | "rotate" | "hover-scale" | "hover-lift";
+            }, {
+                confidence: number;
+                element: string;
+                animationType: "other" | "parallax" | "scale" | "fade-in" | "slide" | "rotate" | "hover-scale" | "hover-lift";
+            }>, "many">;
+            interactiveElements: z.ZodArray<z.ZodString, "many">;
+            scrollTriggers: z.ZodArray<z.ZodString, "many">;
+        }, "strip", z.ZodTypeAny, {
+            type: "motion_candidates";
+            likelyAnimations: {
+                confidence: number;
+                element: string;
+                animationType: "other" | "parallax" | "scale" | "fade-in" | "slide" | "rotate" | "hover-scale" | "hover-lift";
+            }[];
+            interactiveElements: string[];
+            scrollTriggers: string[];
+        }, {
+            type: "motion_candidates";
+            likelyAnimations: {
+                confidence: number;
+                element: string;
+                animationType: "other" | "parallax" | "scale" | "fade-in" | "slide" | "rotate" | "hover-scale" | "hover-lift";
+            }[];
+            interactiveElements: string[];
+            scrollTriggers: string[];
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"brand_tone">;
+            professionalism: z.ZodEnum<["minimal", "moderate", "bold"]>;
+            warmth: z.ZodEnum<["cold", "neutral", "warm"]>;
+            modernity: z.ZodEnum<["classic", "contemporary", "futuristic"]>;
+            energy: z.ZodEnum<["calm", "balanced", "dynamic"]>;
+            targetAudience: z.ZodEnum<["enterprise", "startup", "creative", "consumer"]>;
+            indicators: z.ZodArray<z.ZodString, "many">;
+        }, "strip", z.ZodTypeAny, {
+            type: "brand_tone";
+            targetAudience: "startup" | "creative" | "enterprise" | "consumer";
+            professionalism: "bold" | "minimal" | "moderate";
+            warmth: "neutral" | "cold" | "warm";
+            modernity: "classic" | "contemporary" | "futuristic";
+            energy: "calm" | "balanced" | "dynamic";
+            indicators: string[];
+        }, {
+            type: "brand_tone";
+            targetAudience: "startup" | "creative" | "enterprise" | "consumer";
+            professionalism: "bold" | "minimal" | "moderate";
+            warmth: "neutral" | "cold" | "warm";
+            modernity: "classic" | "contemporary" | "futuristic";
+            energy: "calm" | "balanced" | "dynamic";
+            indicators: string[];
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"ai_cliches">;
+            clichesDetected: z.ZodArray<z.ZodObject<{
+                clicheType: z.ZodEnum<["gradient_orbs", "generic_isometric", "meaningless_patterns", "oversaturated_gradients", "ai_generated_people", "floating_ui", "generic_hero", "symmetrical_layout", "other"]>;
+                location: z.ZodString;
+                severity: z.ZodEnum<["low", "medium", "high"]>;
+            }, "strip", z.ZodTypeAny, {
+                severity: "high" | "medium" | "low";
+                location: string;
+                clicheType: "other" | "gradient_orbs" | "generic_isometric" | "meaningless_patterns" | "oversaturated_gradients" | "ai_generated_people" | "floating_ui" | "generic_hero" | "symmetrical_layout";
+            }, {
+                severity: "high" | "medium" | "low";
+                location: string;
+                clicheType: "other" | "gradient_orbs" | "generic_isometric" | "meaningless_patterns" | "oversaturated_gradients" | "ai_generated_people" | "floating_ui" | "generic_hero" | "symmetrical_layout";
+            }>, "many">;
+            originalityScore: z.ZodNumber;
+            assessment: z.ZodEnum<["highly-original", "mostly-original", "moderate-ai-influence", "heavy-ai-influence"]>;
+            suggestions: z.ZodArray<z.ZodString, "many">;
+        }, "strip", z.ZodTypeAny, {
+            type: "ai_cliches";
+            clichesDetected: {
+                severity: "high" | "medium" | "low";
+                location: string;
+                clicheType: "other" | "gradient_orbs" | "generic_isometric" | "meaningless_patterns" | "oversaturated_gradients" | "ai_generated_people" | "floating_ui" | "generic_hero" | "symmetrical_layout";
+            }[];
+            originalityScore: number;
+            assessment: "highly-original" | "mostly-original" | "moderate-ai-influence" | "heavy-ai-influence";
+            suggestions: string[];
+        }, {
+            type: "ai_cliches";
+            clichesDetected: {
+                severity: "high" | "medium" | "low";
+                location: string;
+                clicheType: "other" | "gradient_orbs" | "generic_isometric" | "meaningless_patterns" | "oversaturated_gradients" | "ai_generated_people" | "floating_ui" | "generic_hero" | "symmetrical_layout";
+            }[];
+            originalityScore: number;
+            assessment: "highly-original" | "mostly-original" | "moderate-ai-influence" | "heavy-ai-influence";
+            suggestions: string[];
+        }>]>;
+    }, "strip", z.ZodTypeAny, {
+        data: {
+            type: "layout_structure";
+            description: string;
+            gridType: "asymmetric" | "grid" | "single-column" | "two-column" | "three-column" | "masonry";
+            mainAreas: string[];
+        } | {
+            type: "color_palette";
+            mood: string;
+            dominantColors: string[];
+            contrast: "high" | "medium" | "low";
+        } | {
+            type: "typography";
+            headingStyle: string;
+            bodyStyle: string;
+            hierarchy: string[];
+        } | {
+            type: "visual_hierarchy";
+            focalPoints: string[];
+            flowDirection: "top-to-bottom" | "left-to-right" | "z-pattern" | "f-pattern";
+            emphasisTechniques: string[];
+        } | {
+            type: "whitespace";
+            amount: "minimal" | "moderate" | "generous" | "extreme";
+            distribution: "even" | "top-heavy" | "bottom-heavy" | "centered";
+        } | {
+            type: "density";
+            description: string;
+            level: "sparse" | "balanced" | "dense" | "cluttered";
+        } | {
+            type: "rhythm";
+            pattern: "progressive" | "irregular" | "regular" | "alternating";
+            description: string;
+        } | {
+            sections: {
+                type: string;
+                confidence: number;
+                startY: number;
+                endY: number;
+            }[];
+            type: "section_boundaries";
+        } | {
+            type: "motion_candidates";
+            likelyAnimations: {
+                confidence: number;
+                element: string;
+                animationType: "other" | "parallax" | "scale" | "fade-in" | "slide" | "rotate" | "hover-scale" | "hover-lift";
+            }[];
+            interactiveElements: string[];
+            scrollTriggers: string[];
+        } | {
+            type: "brand_tone";
+            targetAudience: "startup" | "creative" | "enterprise" | "consumer";
+            professionalism: "bold" | "minimal" | "moderate";
+            warmth: "neutral" | "cold" | "warm";
+            modernity: "classic" | "contemporary" | "futuristic";
+            energy: "calm" | "balanced" | "dynamic";
+            indicators: string[];
+        } | {
+            type: "ai_cliches";
+            clichesDetected: {
+                severity: "high" | "medium" | "low";
+                location: string;
+                clicheType: "other" | "gradient_orbs" | "generic_isometric" | "meaningless_patterns" | "oversaturated_gradients" | "ai_generated_people" | "floating_ui" | "generic_hero" | "symmetrical_layout";
+            }[];
+            originalityScore: number;
+            assessment: "highly-original" | "mostly-original" | "moderate-ai-influence" | "heavy-ai-influence";
+            suggestions: string[];
+        };
+        type: "typography" | "density" | "layout_structure" | "color_palette" | "visual_hierarchy" | "whitespace" | "rhythm" | "section_boundaries" | "motion_candidates" | "brand_tone" | "ai_cliches";
+        confidence: number;
+    }, {
+        data: {
+            type: "layout_structure";
+            description: string;
+            gridType: "asymmetric" | "grid" | "single-column" | "two-column" | "three-column" | "masonry";
+            mainAreas: string[];
+        } | {
+            type: "color_palette";
+            mood: string;
+            dominantColors: string[];
+            contrast: "high" | "medium" | "low";
+        } | {
+            type: "typography";
+            headingStyle: string;
+            bodyStyle: string;
+            hierarchy: string[];
+        } | {
+            type: "visual_hierarchy";
+            focalPoints: string[];
+            flowDirection: "top-to-bottom" | "left-to-right" | "z-pattern" | "f-pattern";
+            emphasisTechniques: string[];
+        } | {
+            type: "whitespace";
+            amount: "minimal" | "moderate" | "generous" | "extreme";
+            distribution: "even" | "top-heavy" | "bottom-heavy" | "centered";
+        } | {
+            type: "density";
+            description: string;
+            level: "sparse" | "balanced" | "dense" | "cluttered";
+        } | {
+            type: "rhythm";
+            pattern: "progressive" | "irregular" | "regular" | "alternating";
+            description: string;
+        } | {
+            sections: {
+                type: string;
+                confidence: number;
+                startY: number;
+                endY: number;
+            }[];
+            type: "section_boundaries";
+        } | {
+            type: "motion_candidates";
+            likelyAnimations: {
+                confidence: number;
+                element: string;
+                animationType: "other" | "parallax" | "scale" | "fade-in" | "slide" | "rotate" | "hover-scale" | "hover-lift";
+            }[];
+            interactiveElements: string[];
+            scrollTriggers: string[];
+        } | {
+            type: "brand_tone";
+            targetAudience: "startup" | "creative" | "enterprise" | "consumer";
+            professionalism: "bold" | "minimal" | "moderate";
+            warmth: "neutral" | "cold" | "warm";
+            modernity: "classic" | "contemporary" | "futuristic";
+            energy: "calm" | "balanced" | "dynamic";
+            indicators: string[];
+        } | {
+            type: "ai_cliches";
+            clichesDetected: {
+                severity: "high" | "medium" | "low";
+                location: string;
+                clicheType: "other" | "gradient_orbs" | "generic_isometric" | "meaningless_patterns" | "oversaturated_gradients" | "ai_generated_people" | "floating_ui" | "generic_hero" | "symmetrical_layout";
+            }[];
+            originalityScore: number;
+            assessment: "highly-original" | "mostly-original" | "moderate-ai-influence" | "heavy-ai-influence";
+            suggestions: string[];
+        };
+        type: "typography" | "density" | "layout_structure" | "color_palette" | "visual_hierarchy" | "whitespace" | "rhythm" | "section_boundaries" | "motion_candidates" | "brand_tone" | "ai_cliches";
+        confidence: number;
+    }>, "many">;
+    rawResponse: z.ZodOptional<z.ZodString>;
+    error: z.ZodOptional<z.ZodString>;
+    processingTimeMs: z.ZodNumber;
+    modelName: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    success: boolean;
+    processingTimeMs: number;
+    features: {
+        data: {
+            type: "layout_structure";
+            description: string;
+            gridType: "asymmetric" | "grid" | "single-column" | "two-column" | "three-column" | "masonry";
+            mainAreas: string[];
+        } | {
+            type: "color_palette";
+            mood: string;
+            dominantColors: string[];
+            contrast: "high" | "medium" | "low";
+        } | {
+            type: "typography";
+            headingStyle: string;
+            bodyStyle: string;
+            hierarchy: string[];
+        } | {
+            type: "visual_hierarchy";
+            focalPoints: string[];
+            flowDirection: "top-to-bottom" | "left-to-right" | "z-pattern" | "f-pattern";
+            emphasisTechniques: string[];
+        } | {
+            type: "whitespace";
+            amount: "minimal" | "moderate" | "generous" | "extreme";
+            distribution: "even" | "top-heavy" | "bottom-heavy" | "centered";
+        } | {
+            type: "density";
+            description: string;
+            level: "sparse" | "balanced" | "dense" | "cluttered";
+        } | {
+            type: "rhythm";
+            pattern: "progressive" | "irregular" | "regular" | "alternating";
+            description: string;
+        } | {
+            sections: {
+                type: string;
+                confidence: number;
+                startY: number;
+                endY: number;
+            }[];
+            type: "section_boundaries";
+        } | {
+            type: "motion_candidates";
+            likelyAnimations: {
+                confidence: number;
+                element: string;
+                animationType: "other" | "parallax" | "scale" | "fade-in" | "slide" | "rotate" | "hover-scale" | "hover-lift";
+            }[];
+            interactiveElements: string[];
+            scrollTriggers: string[];
+        } | {
+            type: "brand_tone";
+            targetAudience: "startup" | "creative" | "enterprise" | "consumer";
+            professionalism: "bold" | "minimal" | "moderate";
+            warmth: "neutral" | "cold" | "warm";
+            modernity: "classic" | "contemporary" | "futuristic";
+            energy: "calm" | "balanced" | "dynamic";
+            indicators: string[];
+        } | {
+            type: "ai_cliches";
+            clichesDetected: {
+                severity: "high" | "medium" | "low";
+                location: string;
+                clicheType: "other" | "gradient_orbs" | "generic_isometric" | "meaningless_patterns" | "oversaturated_gradients" | "ai_generated_people" | "floating_ui" | "generic_hero" | "symmetrical_layout";
+            }[];
+            originalityScore: number;
+            assessment: "highly-original" | "mostly-original" | "moderate-ai-influence" | "heavy-ai-influence";
+            suggestions: string[];
+        };
+        type: "typography" | "density" | "layout_structure" | "color_palette" | "visual_hierarchy" | "whitespace" | "rhythm" | "section_boundaries" | "motion_candidates" | "brand_tone" | "ai_cliches";
+        confidence: number;
+    }[];
+    modelName: string;
+    error?: string | undefined;
+    rawResponse?: string | undefined;
+}, {
+    success: boolean;
+    processingTimeMs: number;
+    features: {
+        data: {
+            type: "layout_structure";
+            description: string;
+            gridType: "asymmetric" | "grid" | "single-column" | "two-column" | "three-column" | "masonry";
+            mainAreas: string[];
+        } | {
+            type: "color_palette";
+            mood: string;
+            dominantColors: string[];
+            contrast: "high" | "medium" | "low";
+        } | {
+            type: "typography";
+            headingStyle: string;
+            bodyStyle: string;
+            hierarchy: string[];
+        } | {
+            type: "visual_hierarchy";
+            focalPoints: string[];
+            flowDirection: "top-to-bottom" | "left-to-right" | "z-pattern" | "f-pattern";
+            emphasisTechniques: string[];
+        } | {
+            type: "whitespace";
+            amount: "minimal" | "moderate" | "generous" | "extreme";
+            distribution: "even" | "top-heavy" | "bottom-heavy" | "centered";
+        } | {
+            type: "density";
+            description: string;
+            level: "sparse" | "balanced" | "dense" | "cluttered";
+        } | {
+            type: "rhythm";
+            pattern: "progressive" | "irregular" | "regular" | "alternating";
+            description: string;
+        } | {
+            sections: {
+                type: string;
+                confidence: number;
+                startY: number;
+                endY: number;
+            }[];
+            type: "section_boundaries";
+        } | {
+            type: "motion_candidates";
+            likelyAnimations: {
+                confidence: number;
+                element: string;
+                animationType: "other" | "parallax" | "scale" | "fade-in" | "slide" | "rotate" | "hover-scale" | "hover-lift";
+            }[];
+            interactiveElements: string[];
+            scrollTriggers: string[];
+        } | {
+            type: "brand_tone";
+            targetAudience: "startup" | "creative" | "enterprise" | "consumer";
+            professionalism: "bold" | "minimal" | "moderate";
+            warmth: "neutral" | "cold" | "warm";
+            modernity: "classic" | "contemporary" | "futuristic";
+            energy: "calm" | "balanced" | "dynamic";
+            indicators: string[];
+        } | {
+            type: "ai_cliches";
+            clichesDetected: {
+                severity: "high" | "medium" | "low";
+                location: string;
+                clicheType: "other" | "gradient_orbs" | "generic_isometric" | "meaningless_patterns" | "oversaturated_gradients" | "ai_generated_people" | "floating_ui" | "generic_hero" | "symmetrical_layout";
+            }[];
+            originalityScore: number;
+            assessment: "highly-original" | "mostly-original" | "moderate-ai-influence" | "heavy-ai-influence";
+            suggestions: string[];
+        };
+        type: "typography" | "density" | "layout_structure" | "color_palette" | "visual_hierarchy" | "whitespace" | "rhythm" | "section_boundaries" | "motion_candidates" | "brand_tone" | "ai_cliches";
+        confidence: number;
+    }[];
+    modelName: string;
+    error?: string | undefined;
+    rawResponse?: string | undefined;
+}>;
+/**
+ * LayoutStructureDataかどうかを判定する型ガード
+ */
+export declare function isLayoutStructureData(data: VisionFeatureData): data is LayoutStructureData;
+/**
+ * ColorPaletteDataかどうかを判定する型ガード
+ */
+export declare function isColorPaletteData(data: VisionFeatureData): data is ColorPaletteData;
+/**
+ * TypographyDataかどうかを判定する型ガード
+ */
+export declare function isTypographyData(data: VisionFeatureData): data is TypographyData;
+/**
+ * VisualHierarchyDataかどうかを判定する型ガード
+ */
+export declare function isVisualHierarchyData(data: VisionFeatureData): data is VisualHierarchyData;
+/**
+ * WhitespaceDataかどうかを判定する型ガード
+ */
+export declare function isWhitespaceData(data: VisionFeatureData): data is WhitespaceData;
+/**
+ * DensityDataかどうかを判定する型ガード
+ */
+export declare function isDensityData(data: VisionFeatureData): data is DensityData;
+/**
+ * RhythmDataかどうかを判定する型ガード
+ */
+export declare function isRhythmData(data: VisionFeatureData): data is RhythmData;
+/**
+ * SectionBoundariesDataかどうかを判定する型ガード
+ */
+export declare function isSectionBoundariesData(data: VisionFeatureData): data is SectionBoundariesData;
+/**
+ * MotionCandidatesDataかどうかを判定する型ガード
+ */
+export declare function isMotionCandidatesData(data: VisionFeatureData): data is MotionCandidatesData;
+/**
+ * BrandToneDataかどうかを判定する型ガード
+ */
+export declare function isBrandToneData(data: VisionFeatureData): data is BrandToneData;
+/**
+ * AiClichesDataかどうかを判定する型ガード
+ */
+export declare function isAiClichesData(data: VisionFeatureData): data is AiClichesData;
+/**
+ * ビジョン解析アダプタインターフェース
+ *
+ * LlamaVision、Claude Vision、Mock等の実装を切り替え可能にするための
+ * プラガブル設計のインターフェースです。
+ *
+ * @example
+ * ```typescript
+ * const analyzer: IVisionAnalyzer = new LlamaVisionAdapter();
+ *
+ * if (await analyzer.isAvailable()) {
+ *   const result = await analyzer.analyze({
+ *     imageBuffer: screenshotBuffer,
+ *     mimeType: 'image/png',
+ *     features: ['layout_structure', 'color_palette'],
+ *   });
+ *
+ *   if (result.success) {
+ *     const textRep = analyzer.generateTextRepresentation(result);
+ *     // textRepをEmbeddingに使用
+ *   }
+ * }
+ * ```
+ */
+export interface IVisionAnalyzer {
+    /** アダプタ名 */
+    readonly name: string;
+    /** 使用するモデル名 */
+    readonly modelName: string;
+    /**
+     * アダプタが利用可能かチェック
+     *
+     * @returns 利用可能な場合はtrue
+     *
+     * @example
+     * ```typescript
+     * if (await analyzer.isAvailable()) {
+     *   // 解析を実行
+     * } else {
+     *   // フォールバック処理
+     * }
+     * ```
+     */
+    isAvailable(): Promise<boolean>;
+    /**
+     * 画像を解析して特徴を抽出
+     *
+     * @param options - 解析オプション
+     * @returns 解析結果
+     *
+     * @example
+     * ```typescript
+     * const result = await analyzer.analyze({
+     *   imageBuffer: Buffer.from(imageData),
+     *   mimeType: 'image/png',
+     *   features: ['layout_structure', 'whitespace'],
+     *   timeout: 30000,
+     * });
+     * ```
+     */
+    analyze(options: VisionAnalysisOptions): Promise<VisionAnalysisResult>;
+    /**
+     * テキスト表現を生成（Embedding用）
+     *
+     * 解析結果をテキストに変換し、Embeddingモデルに入力可能な形式にします。
+     * 生成されたテキストはmultilingual-e5-baseなどでベクトル化され、
+     * 類似検索に使用されます。
+     *
+     * @param result - 解析結果
+     * @returns テキスト表現
+     *
+     * @example
+     * ```typescript
+     * const result = await analyzer.analyze(options);
+     * const textRep = analyzer.generateTextRepresentation(result);
+     * // textRep例: "Layout: two-column grid with header and sidebar.
+     * //            Colors: blue primary (#3B82F6), white background.
+     * //            Whitespace: generous, evenly distributed."
+     * ```
+     */
+    generateTextRepresentation(result: VisionAnalysisResult): string;
+}
+/**
+ * ビジョンアダプタのファクトリ関数型
+ *
+ * アダプタのインスタンスを生成するファクトリ関数の型定義です。
+ * DIコンテナやアダプタ切り替えに使用します。
+ *
+ * @example
+ * ```typescript
+ * const adapters: Record<string, VisionAdapterFactory> = {
+ *   'llama-vision': () => new LlamaVisionAdapter(),
+ *   'claude-vision': () => new ClaudeVisionAdapter(apiKey),
+ *   'mock': () => new MockVisionAdapter(),
+ * };
+ *
+ * const factory = adapters[config.visionAdapter];
+ * const analyzer = factory();
+ * ```
+ */
+export type VisionAdapterFactory = () => IVisionAnalyzer;
+/**
+ * Mood type for enhanced analysis
+ *
+ * 11 distinct mood categories for web design classification
+ * Includes 'neutral' as fallback value for low-confidence or unavailable Vision AI results
+ */
+export type MoodType = "professional" | "playful" | "minimal" | "bold" | "elegant" | "modern" | "classic" | "energetic" | "calm" | "luxurious" | "neutral";
+/**
+ * Brand tone type for enhanced analysis
+ *
+ * 9 distinct brand tone categories
+ * Includes 'neutral' as fallback value for low-confidence or unavailable Vision AI results
+ */
+export type BrandToneType = "corporate" | "friendly" | "luxury" | "tech-forward" | "creative" | "trustworthy" | "innovative" | "traditional" | "neutral";
+/**
+ * Color context from Phase 1 deterministic extraction
+ *
+ * Used to enhance Vision AI analysis with deterministic color data
+ */
+export interface ColorContextInput {
+    /** Dominant colors in HEX format */
+    dominantColors?: string[];
+    /** Accent colors in HEX format */
+    accentColors?: string[];
+    /** Theme: light, dark, or mixed */
+    theme?: "light" | "dark" | "mixed";
+    /** Theme confidence (0-1) */
+    themeConfidence?: number;
+    /** Background color in HEX format */
+    backgroundColor?: string;
+    /** Content density (0-1, 1 = most dense) */
+    contentDensity?: number;
+    /** Whitespace ratio (0-1, 1 = all whitespace) */
+    whitespaceRatio?: number;
+}
+/**
+ * Enhanced Vision analysis options with color context
+ */
+export interface EnhancedVisionAnalysisOptions extends VisionAnalysisOptions {
+    /** Include Phase 1 color context in the analysis prompt */
+    includeColorContext?: boolean;
+    /** Phase 1 extraction results to include in prompt */
+    colorContext?: ColorContextInput;
+}
+/**
+ * Mood analysis result
+ */
+export interface MoodAnalysisResult {
+    /** Primary detected mood */
+    primaryMood: MoodType;
+    /** Secondary mood (if applicable) */
+    secondaryMood?: MoodType;
+    /** Confidence score (0-1) */
+    confidence: number;
+    /** Visual indicators that led to this mood detection */
+    indicators: string[];
+    /** Whether color context was used in analysis */
+    colorContextUsed: boolean;
+}
+/**
+ * Enhanced brand tone result with primary/secondary tones
+ */
+export interface EnhancedBrandToneResult {
+    /** Primary brand tone */
+    primaryTone: BrandToneType;
+    /** Secondary brand tone (if applicable) */
+    secondaryTone?: BrandToneType;
+    /** Confidence score (0-1) */
+    confidence: number;
+    /** Professionalism level */
+    professionalism: "minimal" | "moderate" | "bold";
+    /** Warmth level */
+    warmth: "cold" | "neutral" | "warm";
+    /** Modernity level */
+    modernity: "classic" | "contemporary" | "futuristic";
+    /** Energy level */
+    energy: "calm" | "balanced" | "dynamic";
+    /** Target audience */
+    targetAudience: "enterprise" | "startup" | "creative" | "consumer";
+    /** Visual indicators */
+    indicators: string[];
+    /** Whether color context was used in analysis */
+    colorContextUsed: boolean;
+}
+/**
+ * Enhanced analysis result combining mood and brand tone
+ */
+export interface EnhancedAnalysisResult {
+    /** Operation success */
+    success: boolean;
+    /** Mood analysis result */
+    mood?: MoodAnalysisResult;
+    /** Brand tone analysis result */
+    brandTone?: EnhancedBrandToneResult;
+    /** Error message if failed */
+    error?: string;
+    /** Processing time in milliseconds */
+    processingTimeMs: number;
+    /** Model name used for analysis */
+    modelName: string;
+    /** Color context summary (if used) */
+    colorContext?: {
+        dominantColors: string[];
+        theme: "light" | "dark" | "mixed";
+        density: number;
+    };
+    /**
+     * Warnings for data quality issues (v0.1.0)
+     * Includes low confidence warnings and fallback usage
+     */
+    warnings?: VisionAnalysisWarning[];
+    /**
+     * Whether fallback values were used (v0.1.0)
+     */
+    fallbackUsed?: boolean;
+}
+/**
+ * Warning type for Vision analysis (v0.1.0)
+ */
+export interface VisionAnalysisWarning {
+    /** Warning code */
+    code: VisionWarningCode;
+    /** Human-readable message */
+    message: string;
+    /** Field that triggered the warning */
+    field?: string;
+    /** Actual value that triggered the warning */
+    value?: unknown;
+    /** Threshold that was violated (if applicable) */
+    threshold?: number;
+}
+/**
+ * Warning codes for Vision analysis (v0.1.0)
+ */
+export type VisionWarningCode = "LOW_CONFIDENCE_MOOD" | "LOW_CONFIDENCE_BRAND_TONE" | "MOOD_FALLBACK_USED" | "BRAND_TONE_FALLBACK_USED" | "MISSING_INDICATORS" | "PARSE_WARNING";
+/**
+ * Low confidence threshold for warnings (v0.1.0)
+ */
+export declare const LOW_CONFIDENCE_THRESHOLD = 0.5;
+/**
+ * Default fallback values for mood analysis (v0.1.0)
+ */
+export declare const DEFAULT_MOOD_FALLBACK: MoodAnalysisResult;
+/**
+ * Default fallback values for brand tone analysis (v0.1.0)
+ */
+export declare const DEFAULT_BRAND_TONE_FALLBACK: EnhancedBrandToneResult;
+/**
+ * Zod schemas for enhanced types
+ */
+export declare const moodTypeSchema: z.ZodEnum<["professional", "playful", "minimal", "bold", "elegant", "modern", "classic", "energetic", "calm", "luxurious", "neutral"]>;
+export declare const brandToneTypeSchema: z.ZodEnum<["corporate", "friendly", "luxury", "tech-forward", "creative", "trustworthy", "innovative", "traditional", "neutral"]>;
+//# sourceMappingURL=interface.d.ts.map