@reftrixmcp/mcp-server 0.1.7 → 0.2.0

package/dist/services/motion/analyzers/layout-shift.detector.js

@@ -1,179 +0,0 @@
-"use strict";
-// SPDX-FileCopyrightText: 2026 TKMD and Reftrix Contributors
-// SPDX-License-Identifier: AGPL-3.0-only
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.LayoutShiftDetector = void 0;
-// =============================================================================
-// 定数
-// =============================================================================
-/**
- * CLS分類閾値
- */
-const CLS_THRESHOLDS = {
-    GOOD: 0.1,
-    NEEDS_IMPROVEMENT: 0.25,
-};
-/**
- * 移動距離推定係数（previousPositionがない場合）
- */
-const DISTANCE_ESTIMATION_FACTOR = 0.1;
-// =============================================================================
-// LayoutShiftDetector クラス
-// =============================================================================
-/**
- * レイアウトシフト検出器
- *
- * フレーム差分からレイアウトシフトを検出し、CLSスコアを計算する
- */
-class LayoutShiftDetector {
-    /**
-     * 差分領域からレイアウトシフトを検出
-     *
-     * @param diffRegions - 差分領域の配列
-     * @param viewport - ビューポート情報
-     * @returns 検出されたレイアウトシフトの配列
-     * @throws Error - ビューポートが無効な場合
-     */
-    detectShifts(diffRegions, viewport) {
-        // ビューポートのバリデーション
-        this.validateViewport(viewport);
-        // 空の配列の場合は空を返す
-        if (diffRegions.length === 0) {
-            return [];
-        }
-        const viewportArea = viewport.width * viewport.height;
-        const maxViewportDimension = Math.max(viewport.width, viewport.height);
-        return diffRegions.map((region) => {
-            // 領域のバウンディングボックス
-            const boundingBox = {
-                x: region.x,
-                y: region.y,
-                width: region.width,
-                height: region.height,
-            };
-            // ビューポート内の有効領域を計算
-            const visibleArea = this.calculateVisibleArea(region, viewport);
-            // impactFraction: ビューポートに対する変化領域の割合
-            const impactFraction = viewportArea > 0 ? visibleArea / viewportArea : 0;
-            // distanceFraction: 移動距離のビューポート最大次元に対する割合
-            let distanceFraction;
-            if (region.previousPosition) {
-                // 移動距離を計算
-                const dx = region.x - region.previousPosition.x;
-                const dy = region.y - region.previousPosition.y;
-                const distance = Math.sqrt(dx * dx + dy * dy);
-                distanceFraction = maxViewportDimension > 0 ? distance / maxViewportDimension : 0;
-            }
-            else {
-                // previousPositionがない場合は changeIntensity に基づいて推定
-                distanceFraction = region.changeIntensity * DISTANCE_ESTIMATION_FACTOR;
-            }
-            // 0-1の範囲にクランプ
-            const clampedImpactFraction = Math.max(0, Math.min(1, impactFraction));
-            const clampedDistanceFraction = Math.max(0, Math.min(1, distanceFraction));
-            // スコア計算
-            const score = clampedImpactFraction * clampedDistanceFraction;
-            return {
-                region: boundingBox,
-                impactFraction: clampedImpactFraction,
-                distanceFraction: clampedDistanceFraction,
-                score,
-            };
-        });
-    }
-    /**
-     * シフト配列からCLSを計算
-     *
-     * @param shifts - レイアウトシフトの配列
-     * @returns 累積レイアウトシフトスコア
-     */
-    calculateCLS(shifts) {
-        if (shifts.length === 0) {
-            return 0;
-        }
-        // 各シフトのスコアを累積
-        return shifts.reduce((total, shift) => total + shift.score, 0);
-    }
-    /**
-     * CLSスコアを分類
-     *
-     * @param cls - CLSスコア
-     * @returns 分類結果 ('good' | 'needs-improvement' | 'poor')
-     */
-    classifyShift(cls) {
-        // 負の値は 'good' として扱う
-        if (cls < CLS_THRESHOLDS.GOOD) {
-            return "good";
-        }
-        if (cls < CLS_THRESHOLDS.NEEDS_IMPROVEMENT) {
-            return "needs-improvement";
-        }
-        return "poor";
-    }
-    /**
-     * フレームペアを解析してレイアウトシフト結果を返す
-     *
-     * @param diffRegions - 差分領域の配列
-     * @param viewport - ビューポート情報
-     * @returns レイアウトシフト分析結果
-     */
-    analyzeFramePair(diffRegions, viewport) {
-        // シフトを検出
-        const shifts = this.detectShifts(diffRegions, viewport);
-        // CLSを計算
-        const cls = this.calculateCLS(shifts);
-        // 分類
-        const classification = this.classifyShift(cls);
-        // 全体のimpactFractionとdistanceFractionを計算
-        let totalImpactFraction = 0;
-        let totalDistanceFraction = 0;
-        if (shifts.length > 0) {
-            totalImpactFraction = shifts.reduce((sum, s) => sum + s.impactFraction, 0);
-            totalDistanceFraction = shifts.reduce((sum, s) => sum + s.distanceFraction, 0);
-            // 平均化
-            totalImpactFraction /= shifts.length;
-            totalDistanceFraction /= shifts.length;
-        }
-        // 0-1の範囲にクランプ
-        totalImpactFraction = Math.max(0, Math.min(1, totalImpactFraction));
-        totalDistanceFraction = Math.max(0, Math.min(1, totalDistanceFraction));
-        return {
-            cls,
-            classification,
-            shifts,
-            impactFraction: totalImpactFraction,
-            distanceFraction: totalDistanceFraction,
-        };
-    }
-    // ===========================================================================
-    // プライベートメソッド
-    // ===========================================================================
-    /**
-     * ビューポートのバリデーション
-     */
-    validateViewport(viewport) {
-        if (viewport.width <= 0 || viewport.height <= 0) {
-            throw new Error("Invalid viewport: width and height must be positive");
-        }
-    }
-    /**
-     * ビューポート内の有効領域面積を計算
-     */
-    calculateVisibleArea(region, viewport) {
-        // 領域の右端と下端
-        const regionRight = region.x + region.width;
-        const regionBottom = region.y + region.height;
-        // ビューポート内の有効範囲を計算
-        const visibleLeft = Math.max(0, region.x);
-        const visibleTop = Math.max(0, region.y);
-        const visibleRight = Math.min(viewport.width, regionRight);
-        const visibleBottom = Math.min(viewport.height, regionBottom);
-        // 有効幅と高さ（負の場合は0）
-        const visibleWidth = Math.max(0, visibleRight - visibleLeft);
-        const visibleHeight = Math.max(0, visibleBottom - visibleTop);
-        return visibleWidth * visibleHeight;
-    }
-}
-exports.LayoutShiftDetector = LayoutShiftDetector;
-exports.default = LayoutShiftDetector;
-//# sourceMappingURL=layout-shift.detector.js.map

package/dist/services/motion/analyzers/layout-shift.detector.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"layout-shift.detector.js","sourceRoot":"","sources":["../../../../src/services/motion/analyzers/layout-shift.detector.ts"],"names":[],"mappings":"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"}

package/dist/services/motion/analyzers/motion-vector.estimator.d.ts

@@ -1,88 +0,0 @@
-import type { IMotionVectorEstimator, MotionVectorResult, MotionType } from "../types.js";
-/**
- * Estimator options
- */
-export interface MotionVectorEstimatorOptions {
-    /** Block size for motion estimation (default: 16) */
-    blockSize?: number;
-    /** Search range for block matching (default: 16) */
-    searchRange?: number;
-    /** Minimum motion threshold in pixels (default: 2) */
-    minMotionThreshold?: number;
-    /** Confidence threshold for valid motion (default: 0.3) */
-    confidenceThreshold?: number;
-}
-/**
- * Motion Vector Estimator implementation using block matching algorithm
- *
- * Implements IMotionVectorEstimator interface from types.ts
- */
-export declare class MotionVectorEstimator implements IMotionVectorEstimator {
-    private readonly options;
-    private frameIndex;
-    constructor(options?: MotionVectorEstimatorOptions);
-    /**
-     * Estimate optical flow between two frames
-     *
-     * @param frame1 - First frame buffer (raw RGBA)
-     * @param frame2 - Second frame buffer (raw RGBA)
-     * @returns MotionVectorResult with direction, speed, and motion type
-     */
-    estimateFlow(frame1: Buffer, frame2: Buffer): Promise<MotionVectorResult>;
-    /**
-     * Classify overall motion type from multiple vector results
-     *
-     * @param vectors - Array of MotionVectorResult
-     * @returns Dominant MotionType
-     */
-    classifyMotion(vectors: MotionVectorResult[]): MotionType;
-    /**
-     * Get raw frame data with dimensions
-     */
-    private getFrameData;
-    /**
-     * Calculate motion vectors for all blocks
-     */
-    private calculateBlockMotions;
-    /**
-     * Find best matching block using Sum of Absolute Differences (SAD)
-     */
-    private findBestMatch;
-    /**
-     * Calculate Sum of Absolute Differences between two blocks
-     */
-    private calculateSAD;
-    /**
-     * Aggregate block motions into overall motion characteristics
-     */
-    private aggregateMotions;
-    /**
-     * Classify motion type from aggregated vectors
-     */
-    private classifyMotionFromAggregate;
-    /**
-     * Detect zoom motion (radial pattern)
-     */
-    private detectZoom;
-    /**
-     * Detect rotation motion
-     */
-    private detectRotation;
-    /**
-     * Check if direction is in specified range
-     */
-    private isInRange;
-    /**
-     * Check if direction is in alternate range (for left direction which spans +/-180)
-     */
-    private isInRangeAlt;
-    /**
-     * Check if motion types include opposite directions
-     */
-    private areOppositeDirections;
-}
-/**
- * Create a new MotionVectorEstimator instance
- */
-export declare function createMotionVectorEstimator(options?: MotionVectorEstimatorOptions): IMotionVectorEstimator;
-//# sourceMappingURL=motion-vector.estimator.d.ts.map

package/dist/services/motion/analyzers/motion-vector.estimator.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"motion-vector.estimator.d.ts","sourceRoot":"","sources":["../../../../src/services/motion/analyzers/motion-vector.estimator.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAe1F;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,qDAAqD;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sDAAsD;IACtD,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,2DAA2D;IAC3D,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAyBD;;;;GAIG;AACH,qBAAa,qBAAsB,YAAW,sBAAsB;IAClE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyC;IACjE,OAAO,CAAC,UAAU,CAAa;gBAEnB,OAAO,CAAC,EAAE,4BAA4B;IAIlD;;;;;;OAMG;IACG,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA6C/E;;;;;OAKG;IACH,cAAc,CAAC,OAAO,EAAE,kBAAkB,EAAE,GAAG,UAAU;IAwEzD;;OAEG;YACW,YAAY;IAsB1B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA+B7B;;OAEG;IACH,OAAO,CAAC,aAAa;IAqFrB;;OAEG;IACH,OAAO,CAAC,YAAY;IA6BpB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAmExB;;OAEG;IACH,OAAO,CAAC,2BAA2B;IAmDnC;;OAEG;IACH,OAAO,CAAC,UAAU;IAyElB;;OAEG;IACH,OAAO,CAAC,cAAc;IA4DtB;;OAEG;IACH,OAAO,CAAC,SAAS;IAIjB;;OAEG;IACH,OAAO,CAAC,YAAY;IAIpB;;OAEG;IACH,OAAO,CAAC,qBAAqB;CAU9B;AAMD;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,CAAC,EAAE,4BAA4B,GACrC,sBAAsB,CAExB"}