@reftrixmcp/mcp-server 0.1.7 → 0.2.0

package/dist/services/visual-extractor/visual-feature-merger.service.d.ts

@@ -1,230 +0,0 @@
-/**
- * Visual Feature Merger Service
- *
- * Merges deterministic extraction results (color, theme, density) with
- * Vision AI analysis results (mood, brandTone) into a unified structure.
- *
- * Design principles:
- * - Deterministic results have higher confidence (0.9-1.0)
- * - Vision AI results have capped confidence (0.6-0.8)
- * - Graceful degradation when either source is unavailable
- * - Type-safe interfaces for all inputs and outputs
- * - Fallback values for mood/brandTone when empty or low confidence
- * - Completeness score to indicate data coverage
- * - Warnings for low confidence or fallback usage
- *
- * @module services/visual-extractor/visual-feature-merger.service
- */
-import type { ColorExtractionResult } from "./color-extractor.service";
-import type { ThemeDetectionResult } from "./theme-detector.service";
-import type { DensityCalculationResult } from "./density-calculator.service";
-import type { MoodAnalysisResult, EnhancedBrandToneResult, MoodType, BrandToneType } from "../vision-adapter/interface";
-/**
- * Warning codes for visionAnalysis
- */
-export type VisionAnalysisWarningCode = "MOOD_FALLBACK_USED" | "BRAND_TONE_FALLBACK_USED" | "VISION_AI_UNAVAILABLE" | "LOW_CONFIDENCE" | "DETERMINISTIC_EXTRACTION_PARTIAL";
-/**
- * Warning structure for visionAnalysis
- */
-export interface VisionAnalysisWarning {
-    /** Warning code */
-    code: VisionAnalysisWarningCode;
-    /** Warning message */
-    message: string;
-    /** Related field */
-    field?: string;
-    /** Additional details */
-    details?: Record<string, unknown>;
-}
-/**
- * Input from Phase 1 deterministic extraction services
- */
-export interface DeterministicExtractionInput {
-    /** Color extraction result (optional) */
-    colors?: ColorExtractionResult;
-    /** Theme detection result (optional) */
-    theme?: ThemeDetectionResult;
-    /** Density calculation result (optional) */
-    density?: DensityCalculationResult;
-}
-/**
- * Input from Phase 2-1 Vision AI analysis
- */
-export interface VisionAIAnalysisInput {
-    /** Mood analysis result (optional) */
-    mood?: MoodAnalysisResult;
-    /** Brand tone analysis result (optional) */
-    brandTone?: EnhancedBrandToneResult;
-}
-/**
- * Merged color data with source and confidence
- */
-export interface MergedColorData {
-    /** Dominant colors in HEX format */
-    dominant: string[];
-    /** Accent colors in HEX format */
-    accent: string[];
-    /** Color palette with percentages */
-    palette: Array<{
-        color: string;
-        percentage: number;
-    }>;
-    /** Data source */
-    source: "deterministic";
-    /** Confidence score (0.9-1.0) */
-    confidence: number;
-}
-/**
- * Merged theme data with source and confidence
- */
-export interface MergedThemeData {
-    /** Theme type: light, dark, or mixed */
-    type: "light" | "dark" | "mixed";
-    /** Background color in HEX format */
-    backgroundColor: string;
-    /** Text color in HEX format */
-    textColor: string;
-    /** WCAG contrast ratio */
-    contrastRatio: number;
-    /** Data source */
-    source: "deterministic";
-    /** Confidence score (0.9-1.0) */
-    confidence: number;
-}
-/**
- * Merged density data with source and confidence
- */
-export interface MergedDensityData {
-    /** Content density (0-1) */
-    contentDensity: number;
-    /** Whitespace ratio (0-1) */
-    whitespaceRatio: number;
-    /** Visual balance score (0-100) */
-    visualBalance: number;
-    /** Data source */
-    source: "deterministic";
-    /** Confidence score (0.9-1.0) */
-    confidence: number;
-}
-/**
- * Merged mood data with source and confidence
- */
-export interface MergedMoodData {
-    /** Primary mood */
-    primary: MoodType;
-    /** Secondary mood (optional) */
-    secondary?: MoodType | undefined;
-    /** Data source */
-    source: "vision-ai" | "fallback";
-    /** Confidence score (0.6-0.8 for vision-ai, 0.3 for fallback) */
-    confidence: number;
-}
-/**
- * Merged brand tone data with source and confidence
- */
-export interface MergedBrandToneData {
-    /** Primary brand tone */
-    primary: BrandToneType;
-    /** Secondary brand tone (optional) */
-    secondary?: BrandToneType | undefined;
-    /** Data source */
-    source: "vision-ai" | "fallback";
-    /** Confidence score (0.6-0.8 for vision-ai, 0.3 for fallback) */
-    confidence: number;
-}
-/**
- * Metadata for merged visual features
- */
-export interface MergeMetadata {
-    /** ISO 8601 timestamp of merge operation */
-    mergedAt: string;
-    /** Whether deterministic data was available */
-    deterministicAvailable: boolean;
-    /** Whether Vision AI data was available */
-    visionAiAvailable: boolean;
-    /** Overall confidence score (0-1) */
-    overallConfidence: number;
-    /**
-     * Completeness score (0-1)
-     *
-     * Indicates the coverage of required fields (colors, theme, density, mood, brandTone).
-     * - 1.0: All required fields have valid data
-     * - 0.8: 4/5 fields have valid data
-     * - Fallback values count as 0.5 for the field
-     */
-    completeness: number;
-    /** Warnings array */
-    warnings: VisionAnalysisWarning[];
-}
-/**
- * Complete merged visual features structure
- *
- * Combines deterministic extraction (colors, theme, density) with
- * Vision AI analysis (mood, brandTone) into a unified interface.
- */
-export interface MergedVisualFeatures {
-    /** Merged color data (null if unavailable) */
-    colors: MergedColorData | null;
-    /** Merged theme data (null if unavailable) */
-    theme: MergedThemeData | null;
-    /** Merged density data (null if unavailable) */
-    density: MergedDensityData | null;
-    /** Merged mood data (null if unavailable, uses fallback if empty/low confidence) */
-    mood: MergedMoodData | null;
-    /** Merged brand tone data (null if unavailable, uses fallback if empty/low confidence) */
-    brandTone: MergedBrandToneData | null;
-    /** Merge operation metadata */
-    metadata: MergeMetadata;
-}
-/**
- * Options for merge operation
- */
-export interface MergeOptions {
-    /** Apply fallback values for mood/brandTone when empty or low confidence */
-    applyFallbacks?: boolean;
-    /** Force Vision AI unavailable (for testing) */
-    forceVisionUnavailable?: boolean;
-}
-/**
- * Visual Feature Merger Service interface
- */
-export interface VisualFeatureMergerService {
-    /**
-     * Merge deterministic extraction and Vision AI analysis results
-     *
-     * @param deterministicInput - Phase 1 deterministic extraction results (can be null)
-     * @param visionAIInput - Phase 2-1 Vision AI analysis results (can be null)
-     * @param options - Merge options
-     * @returns Merged visual features with metadata
-     * @throws Error if both inputs are null
-     */
-    merge(deterministicInput: DeterministicExtractionInput | null, visionAIInput: VisionAIAnalysisInput | null, options?: MergeOptions): Promise<MergedVisualFeatures>;
-}
-/**
- * Create a new VisualFeatureMergerService instance
- *
- * @returns VisualFeatureMergerService instance
- *
- * @example
- * ```typescript
- * const merger = createVisualFeatureMerger();
- *
- * // With Vision AI data
- * const result = await merger.merge(
- *   { colors, theme, density },
- *   { mood, brandTone }
- * );
- *
- * // Without Vision AI data (uses fallbacks)
- * const resultWithFallbacks = await merger.merge(
- *   { colors, theme, density },
- *   null
- * );
- *
- * // Check completeness
- * console.log(result.metadata.completeness); // 0.85
- * console.log(result.metadata.warnings); // []
- * ```
- */
-export declare function createVisualFeatureMerger(): VisualFeatureMergerService;
-//# sourceMappingURL=visual-feature-merger.service.d.ts.map

package/dist/services/visual-extractor/visual-feature-merger.service.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"visual-feature-merger.service.d.ts","sourceRoot":"","sources":["../../../src/services/visual-extractor/visual-feature-merger.service.ts"],"names":[],"mappings":"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"}