@reftrixmcp/mcp-server 0.1.7

package/dist/services/visual-extractor/density-calculator.service.js

@@ -0,0 +1,369 @@
+"use strict";
+// SPDX-FileCopyrightText: 2026 TKMD and Reftrix Contributors
+// SPDX-License-Identifier: AGPL-3.0-only
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createDensityCalculatorService = createDensityCalculatorService;
+/**
+ * Density Calculator Service
+ *
+ * Calculates content density, whitespace ratio, and visual balance
+ * from web page screenshots using Sharp for image processing.
+ *
+ * Key calculations:
+ * - Whitespace detection: Background-color-similar pixels ratio
+ * - Content density: Edge detection (Sobel filter approximation)
+ * - Visual balance: Grid-based density variance analysis
+ *
+ * Security features:
+ * - Input size validation (5MB max) - SEC H-1
+ * - Processing timeout (30s default) - SEC M-1
+ *
+ * @module services/visual-extractor/density-calculator.service
+ */
+const logger_1 = require("../../utils/logger");
+const sharp_1 = __importDefault(require("sharp"));
+const image_utils_1 = require("./image-utils");
+/** Default configuration */
+const DEFAULT_CONFIG = {
+    defaultGridSize: 3,
+    maxProcessingWidth: 400,
+    maxProcessingHeight: 400,
+    colorDistanceThreshold: 30,
+};
+const image_utils_2 = require("./image-utils");
+// parseImageInput has been moved to image-utils.ts as parseAndValidateImageInput
+// with additional security controls (size validation)
+/**
+ * Extract raw pixel data from image buffer
+ */
+async function getPixelData(imageBuffer, maxWidth, maxHeight) {
+    const processedImage = (0, sharp_1.default)(imageBuffer);
+    const metadata = await processedImage.metadata();
+    if (!metadata.width || !metadata.height) {
+        throw new Error("Invalid image: unable to read dimensions");
+    }
+    // Resize for performance while maintaining aspect ratio
+    const resizeOptions = {
+        width: Math.min(metadata.width, maxWidth),
+        height: Math.min(metadata.height, maxHeight),
+        fit: "inside",
+        withoutEnlargement: true,
+    };
+    // Get raw RGB pixel data (flatten handles transparency)
+    const { data, info } = await processedImage
+        .resize(resizeOptions)
+        .flatten({ background: { r: 255, g: 255, b: 255 } })
+        .raw()
+        .toBuffer({ resolveWithObject: true });
+    return { data, width: info.width, height: info.height };
+}
+// =============================================================================
+// Helper Types and Functions for Edge Detection
+// =============================================================================
+/**
+ * Sobel kernels for edge detection
+ */
+const SOBEL_KERNEL_X = [
+    [-1, 0, 1],
+    [-2, 0, 2],
+    [-1, 0, 1],
+];
+const SOBEL_KERNEL_Y = [
+    [-1, -2, -1],
+    [0, 0, 0],
+    [1, 2, 1],
+];
+/** Number of color channels (RGB) */
+const RGB_CHANNELS = 3;
+/**
+ * Convert image data to grayscale values
+ */
+function convertToGrayscale(data) {
+    const grayscale = [];
+    for (let i = 0; i < data.length; i += RGB_CHANNELS) {
+        const r = data[i] ?? 0;
+        const g = data[i + 1] ?? 0;
+        const b = data[i + 2] ?? 0;
+        grayscale.push((0, image_utils_2.calculateBrightness)(r, g, b));
+    }
+    return grayscale;
+}
+/**
+ * Apply Sobel convolution at a single pixel position
+ */
+function applySobelAtPixel(grayscale, x, y, width) {
+    let gx = 0;
+    let gy = 0;
+    for (let ky = -1; ky <= 1; ky++) {
+        for (let kx = -1; kx <= 1; kx++) {
+            const pixelIndex = (y + ky) * width + (x + kx);
+            const pixel = grayscale[pixelIndex] ?? 0;
+            gx += pixel * (SOBEL_KERNEL_X[ky + 1]?.[kx + 1] ?? 0);
+            gy += pixel * (SOBEL_KERNEL_Y[ky + 1]?.[kx + 1] ?? 0);
+        }
+    }
+    return Math.sqrt(gx * gx + gy * gy);
+}
+/**
+ * Apply Sobel edge detection approximation
+ * Returns edge strength for each pixel
+ */
+function detectEdges(data, width, height) {
+    const grayscale = convertToGrayscale(data);
+    const edges = [];
+    for (let y = 1; y < height - 1; y++) {
+        for (let x = 1; x < width - 1; x++) {
+            const magnitude = applySobelAtPixel(grayscale, x, y, width);
+            edges.push(magnitude);
+        }
+    }
+    return edges;
+}
+/**
+ * Calculate dominant color in a region
+ */
+function calculateDominantColor(data, width, height, startX, startY, regionWidth, regionHeight) {
+    const channels = 3;
+    let totalR = 0;
+    let totalG = 0;
+    let totalB = 0;
+    let count = 0;
+    for (let y = startY; y < Math.min(startY + regionHeight, height); y++) {
+        for (let x = startX; x < Math.min(startX + regionWidth, width); x++) {
+            const pixelIndex = (y * width + x) * channels;
+            totalR += data[pixelIndex] ?? 0;
+            totalG += data[pixelIndex + 1] ?? 0;
+            totalB += data[pixelIndex + 2] ?? 0;
+            count++;
+        }
+    }
+    if (count === 0) {
+        return [128, 128, 128];
+    }
+    return [Math.round(totalR / count), Math.round(totalG / count), Math.round(totalB / count)];
+}
+/**
+ * Calculate region density based on color variance from average
+ */
+function calculateRegionDensity(data, width, height, startX, startY, regionWidth, regionHeight, backgroundColor) {
+    const channels = 3;
+    let nonWhitespaceCount = 0;
+    let totalCount = 0;
+    const threshold = 30; // Color distance threshold
+    for (let y = startY; y < Math.min(startY + regionHeight, height); y++) {
+        for (let x = startX; x < Math.min(startX + regionWidth, width); x++) {
+            const pixelIndex = (y * width + x) * channels;
+            const r = data[pixelIndex] ?? 0;
+            const g = data[pixelIndex + 1] ?? 0;
+            const b = data[pixelIndex + 2] ?? 0;
+            const distance = (0, image_utils_2.colorDistance)([r, g, b], backgroundColor);
+            if (distance > threshold) {
+                nonWhitespaceCount++;
+            }
+            totalCount++;
+        }
+    }
+    return totalCount > 0 ? nonWhitespaceCount / totalCount : 0;
+}
+/**
+ * Calculate variance of an array of numbers
+ */
+function calculateVariance(values) {
+    if (values.length === 0)
+        return 0;
+    const mean = values.reduce((sum, val) => sum + val, 0) / values.length;
+    const squaredDiffs = values.map((val) => Math.pow(val - mean, 2));
+    return squaredDiffs.reduce((sum, val) => sum + val, 0) / values.length;
+}
+/**
+ * Calculate symmetry score by comparing left/right halves
+ */
+function calculateSymmetry(data, width, height) {
+    const channels = 3;
+    let totalDiff = 0;
+    let maxDiff = 0;
+    const halfWidth = Math.floor(width / 2);
+    for (let y = 0; y < height; y++) {
+        for (let x = 0; x < halfWidth; x++) {
+            const leftIndex = (y * width + x) * channels;
+            const rightX = width - 1 - x;
+            const rightIndex = (y * width + rightX) * channels;
+            const leftR = data[leftIndex] ?? 0;
+            const leftG = data[leftIndex + 1] ?? 0;
+            const leftB = data[leftIndex + 2] ?? 0;
+            const rightR = data[rightIndex] ?? 0;
+            const rightG = data[rightIndex + 1] ?? 0;
+            const rightB = data[rightIndex + 2] ?? 0;
+            const diff = (0, image_utils_2.colorDistance)([leftR, leftG, leftB], [rightR, rightG, rightB]);
+            totalDiff += diff;
+            maxDiff += 441.67; // Max distance: sqrt(255^2 * 3)
+        }
+    }
+    return maxDiff > 0 ? 1 - totalDiff / maxDiff : 1;
+}
+/**
+ * Internal implementation of DensityCalculatorService
+ */
+class DensityCalculatorServiceImpl {
+    config;
+    constructor(config = {}) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    async calculateDensity(image) {
+        // Parse and validate input with size check (5MB max) - SEC H-1
+        const imageBuffer = (0, image_utils_1.parseAndValidateImageInput)(image);
+        (0, image_utils_1.logSecurityEvent)("DensityCalculator", "Processing image", {
+            size: imageBuffer.length,
+            sizeKB: Math.round(imageBuffer.length / 1024),
+        });
+        // Wrap processing with timeout (30s default) - SEC M-1
+        return (0, image_utils_1.withTimeout)(this.calculateDensityInternal(imageBuffer), image_utils_1.DEFAULT_PROCESSING_TIMEOUT);
+    }
+    async calculateDensityInternal(imageBuffer) {
+        try {
+            const { data, width, height } = await getPixelData(imageBuffer, this.config.maxProcessingWidth, this.config.maxProcessingHeight);
+            // Default background color (white)
+            const backgroundColor = [255, 255, 255];
+            // Calculate whitespace ratio
+            const whitespaceRatio = this.calculateWhitespaceFromData(data, width, height, backgroundColor);
+            // Calculate edge density
+            const edges = detectEdges(data, width, height);
+            const maxEdge = 1442; // Approximate max Sobel magnitude
+            const normalizedEdges = edges.map((e) => Math.min(e / maxEdge, 1));
+            const edgeDensity = normalizedEdges.reduce((sum, e) => sum + e, 0) / normalizedEdges.length;
+            // Calculate content density (inverse of whitespace, adjusted by edge density)
+            const contentDensity = Math.min(1, (1 - whitespaceRatio) * 0.7 + edgeDensity * 0.3);
+            // Analyze regions
+            const regions = this.analyzeRegionsFromData(data, width, height, this.config.defaultGridSize, backgroundColor);
+            // Calculate visual balance from region density variance
+            const regionDensities = regions.map((r) => r.density);
+            const densityVariance = calculateVariance(regionDensities);
+            const visualBalance = Math.max(0, Math.min(100, 100 - densityVariance * 400));
+            // Calculate color variance
+            const colorVariance = this.calculateColorVariance(data, width, height);
+            // Calculate symmetry score
+            const symmetryScore = calculateSymmetry(data, width, height);
+            logger_1.logger.debug("[DensityCalculator] Analysis complete:", {
+                contentDensity: contentDensity.toFixed(3),
+                whitespaceRatio: whitespaceRatio.toFixed(3),
+                visualBalance: visualBalance.toFixed(1),
+                edgeDensity: edgeDensity.toFixed(3),
+            });
+            return {
+                contentDensity,
+                whitespaceRatio,
+                visualBalance,
+                regions,
+                metrics: {
+                    edgeDensity,
+                    colorVariance,
+                    symmetryScore,
+                },
+            };
+        }
+        catch (error) {
+            throw (0, image_utils_1.wrapSharpError)(error);
+        }
+    }
+    async calculateWhitespace(image, backgroundColor) {
+        // Parse and validate input with size check (5MB max) - SEC H-1
+        const imageBuffer = (0, image_utils_1.parseAndValidateImageInput)(image);
+        (0, image_utils_1.logSecurityEvent)("DensityCalculator", "Calculating whitespace", {
+            size: imageBuffer.length,
+            sizeKB: Math.round(imageBuffer.length / 1024),
+        });
+        // Wrap processing with timeout (30s default) - SEC M-1
+        return (0, image_utils_1.withTimeout)(this.calculateWhitespaceInternal(imageBuffer, backgroundColor), image_utils_1.DEFAULT_PROCESSING_TIMEOUT);
+    }
+    async calculateWhitespaceInternal(imageBuffer, backgroundColor) {
+        const { data, width, height } = await getPixelData(imageBuffer, this.config.maxProcessingWidth, this.config.maxProcessingHeight);
+        const bgColor = backgroundColor ? (0, image_utils_2.hexToRgb)(backgroundColor) : [255, 255, 255];
+        return this.calculateWhitespaceFromData(data, width, height, bgColor);
+    }
+    async analyzeRegions(image, gridSize) {
+        // Parse and validate input with size check (5MB max) - SEC H-1
+        const imageBuffer = (0, image_utils_1.parseAndValidateImageInput)(image);
+        (0, image_utils_1.logSecurityEvent)("DensityCalculator", "Analyzing regions", {
+            size: imageBuffer.length,
+            sizeKB: Math.round(imageBuffer.length / 1024),
+            gridSize: gridSize ?? this.config.defaultGridSize,
+        });
+        // Wrap processing with timeout (30s default) - SEC M-1
+        return (0, image_utils_1.withTimeout)(this.analyzeRegionsInternal(imageBuffer, gridSize), image_utils_1.DEFAULT_PROCESSING_TIMEOUT);
+    }
+    async analyzeRegionsInternal(imageBuffer, gridSize) {
+        const { data, width, height } = await getPixelData(imageBuffer, this.config.maxProcessingWidth, this.config.maxProcessingHeight);
+        const backgroundColor = [255, 255, 255];
+        const size = gridSize ?? this.config.defaultGridSize;
+        return this.analyzeRegionsFromData(data, width, height, size, backgroundColor);
+    }
+    /**
+     * Calculate whitespace ratio from raw pixel data
+     */
+    calculateWhitespaceFromData(data, _width, _height, backgroundColor) {
+        const channels = 3;
+        let whitespaceCount = 0;
+        let totalCount = 0;
+        const threshold = this.config.colorDistanceThreshold;
+        for (let i = 0; i < data.length; i += channels) {
+            const r = data[i] ?? 0;
+            const g = data[i + 1] ?? 0;
+            const b = data[i + 2] ?? 0;
+            const distance = (0, image_utils_2.colorDistance)([r, g, b], backgroundColor);
+            if (distance <= threshold) {
+                whitespaceCount++;
+            }
+            totalCount++;
+        }
+        return totalCount > 0 ? whitespaceCount / totalCount : 0;
+    }
+    /**
+     * Analyze regions from raw pixel data
+     */
+    analyzeRegionsFromData(data, width, height, gridSize, backgroundColor) {
+        const regions = [];
+        const regionWidth = Math.ceil(width / gridSize);
+        const regionHeight = Math.ceil(height / gridSize);
+        for (let row = 0; row < gridSize; row++) {
+            for (let col = 0; col < gridSize; col++) {
+                const startX = col * regionWidth;
+                const startY = row * regionHeight;
+                const density = calculateRegionDensity(data, width, height, startX, startY, regionWidth, regionHeight, backgroundColor);
+                const dominantColorRgb = calculateDominantColor(data, width, height, startX, startY, regionWidth, regionHeight);
+                regions.push({
+                    row,
+                    col,
+                    density,
+                    dominantColor: (0, image_utils_2.rgbToHex)(dominantColorRgb[0], dominantColorRgb[1], dominantColorRgb[2]),
+                });
+            }
+        }
+        return regions;
+    }
+    /**
+     * Calculate color variance across the image
+     */
+    calculateColorVariance(data, _width, _height) {
+        const channels = 3;
+        const brightnesses = [];
+        for (let i = 0; i < data.length; i += channels) {
+            const r = data[i] ?? 0;
+            const g = data[i + 1] ?? 0;
+            const b = data[i + 2] ?? 0;
+            brightnesses.push((0, image_utils_2.calculateBrightness)(r, g, b));
+        }
+        return calculateVariance(brightnesses) / (255 * 255); // Normalize to 0-1 range
+    }
+}
+/**
+ * Create a new DensityCalculatorService instance
+ * @param config - Optional configuration options
+ * @returns DensityCalculatorService instance
+ */
+function createDensityCalculatorService(config) {
+    return new DensityCalculatorServiceImpl(config);
+}
+//# sourceMappingURL=density-calculator.service.js.map

package/dist/services/visual-extractor/density-calculator.service.js.map

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

package/dist/services/visual-extractor/gradient-detector.service.d.ts

@@ -0,0 +1,134 @@
+/**
+ * Color stop in a gradient
+ */
+export interface ColorStop {
+    /** Color in HEX format (#RRGGBB) */
+    color: string;
+    /** Position in gradient (0-1) */
+    position: number;
+}
+/**
+ * Region bounds for a detected gradient
+ */
+export interface GradientRegion {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+/**
+ * Animation info for gradient (v0.1.0)
+ */
+export interface GradientAnimation {
+    /** Animation name (keyframes) */
+    name: string;
+    /** Animation duration (e.g., '3s', '500ms') */
+    duration?: string;
+    /** Timing function (e.g., 'ease', 'linear', 'ease-in-out') */
+    timingFunction?: string;
+    /** Iteration count (e.g., 'infinite', '1', '3') */
+    iterationCount?: string;
+    /** Animation direction (e.g., 'normal', 'alternate', 'reverse') */
+    direction?: string;
+    /** Animation delay (e.g., '0s', '200ms') */
+    delay?: string;
+    /** Fill mode (e.g., 'none', 'forwards', 'backwards', 'both') */
+    fillMode?: string;
+}
+/**
+ * Transition info for gradient (v0.1.0)
+ */
+export interface GradientTransition {
+    /** Transition property (e.g., 'background', 'all') */
+    property: string;
+    /** Transition duration (e.g., '0.3s', '300ms') */
+    duration?: string;
+    /** Timing function (e.g., 'ease', 'linear', 'ease-out') */
+    timingFunction?: string;
+    /** Transition delay (e.g., '0s', '100ms') */
+    delay?: string;
+}
+/**
+ * Single detected gradient information
+ */
+export interface DetectedGradient {
+    /** Type of gradient */
+    type: "linear" | "radial" | "conic";
+    /** Direction in degrees for linear gradient (0-360) */
+    direction?: number;
+    /** Center X position for radial/conic gradient (0-1) */
+    centerX?: number;
+    /** Center Y position for radial/conic gradient (0-1) */
+    centerY?: number;
+    /** Color stops in the gradient */
+    colorStops: ColorStop[];
+    /** Region where gradient was detected */
+    region: GradientRegion;
+    /** Confidence score for this gradient detection (0-1) */
+    confidence: number;
+    /** Generated CSS gradient string (v0.1.0) */
+    cssString?: string;
+    /** Animation info (v0.1.0) - populated when CSS context is available */
+    animation?: GradientAnimation;
+    /** Transition info (v0.1.0) - populated when CSS context is available */
+    transition?: GradientTransition;
+    /** Parent element CSS selector (v0.1.0) - populated when CSS context is available */
+    parentElement?: string;
+}
+/**
+ * Result of gradient detection from an image
+ */
+export interface GradientDetectionResult {
+    /** Whether any gradient was detected */
+    hasGradient: boolean;
+    /** List of detected gradients */
+    gradients: DetectedGradient[];
+    /** The most prominent gradient type */
+    dominantGradientType?: "linear" | "radial" | "conic";
+    /** Overall confidence score (0-1) */
+    confidence: number;
+    /** Processing time in milliseconds */
+    processingTimeMs: number;
+}
+/**
+ * Gradient detector service interface
+ */
+export interface GradientDetectorService {
+    /**
+     * Detect gradients from an image
+     * @param image - Image as Buffer or Base64 string
+     * @returns Promise resolving to gradient detection result
+     * @throws Error if image is invalid or processing fails
+     */
+    detectGradient(image: Buffer | string): Promise<GradientDetectionResult>;
+    /**
+     * Detect gradients from CSS text (v0.1.0)
+     * Extracts gradient definitions along with animation/transition info and parent selectors.
+     * @param css - CSS text to analyze
+     * @returns Gradient detection result with CSS-specific info
+     */
+    detectGradientFromCSS(css: string): GradientDetectionResult;
+}
+/**
+ * Configuration options for gradient detector
+ */
+interface GradientDetectorConfig {
+    /** Max width for processing (for performance) */
+    maxProcessingWidth: number;
+    /** Max height for processing (for performance) */
+    maxProcessingHeight: number;
+    /** Minimum color change threshold (deltaE) to consider gradient */
+    minColorChangeThreshold: number;
+    /** Sample step size for analysis */
+    sampleStep: number;
+    /** Minimum gradient length (pixels) to consider valid */
+    minGradientLength: number;
+}
+/**
+ * Create a new GradientDetectorService instance
+ * @param config - Optional configuration options
+ * @returns GradientDetectorService instance
+ */
+export declare function createGradientDetectorService(config?: Partial<GradientDetectorConfig>): GradientDetectorService;
+export {};
+//# sourceMappingURL=gradient-detector.service.d.ts.map

package/dist/services/visual-extractor/gradient-detector.service.d.ts.map

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