@reftrixmcp/mcp-server 0.1.7

package/dist/services/motion/analyzers/frame-diff.analyzer.d.ts

@@ -0,0 +1,109 @@
+/**
+ * バウンディングボックス
+ */
+export interface BoundingBox {
+    /** 左上X座標 */
+    x: number;
+    /** 左上Y座標 */
+    y: number;
+    /** 幅 */
+    width: number;
+    /** 高さ */
+    height: number;
+}
+/**
+ * フレーム差分検出オプション
+ */
+export interface FrameDiffOptions {
+    /** ピクセル差分閾値 (0-1) デフォルト: 0.1 */
+    threshold?: number;
+    /** 差分画像を含めるか デフォルト: false */
+    includeDiffImage?: boolean;
+    /** アンチエイリアシングを考慮するか デフォルト: true */
+    includeAA?: boolean;
+}
+/**
+ * フレーム差分検出結果
+ */
+export interface FrameDiffResult {
+    /** 変化率 (0-1) */
+    changeRatio: number;
+    /** 差分ピクセル数 */
+    diffPixelCount: number;
+    /** 総ピクセル数 */
+    totalPixelCount: number;
+    /** 差分領域のバウンディングボックス配列 */
+    diffRegions: BoundingBox[];
+    /** 差分画像バッファ (オプション) */
+    diffImageBuffer?: Buffer;
+}
+/**
+ * フレーム差分解析エラー
+ */
+export declare class FrameDiffError extends Error {
+    constructor(message: string);
+}
+/**
+ * Pixelmatchを使用したフレーム差分検出クラス
+ */
+export declare class FrameDiffAnalyzer {
+    private readonly options;
+    /**
+     * コンストラクタ
+     * @param options - 差分検出オプション
+     */
+    constructor(options?: FrameDiffOptions);
+    /**
+     * 2つのフレーム間の差分を解析
+     *
+     * @param frame1 - 比較元フレーム (Buffer または ファイルパス)
+     * @param frame2 - 比較先フレーム (Buffer または ファイルパス)
+     * @param options - 解析オプション (コンストラクタオプションを上書き)
+     * @returns フレーム差分結果
+     * @throws FrameDiffError
+     */
+    analyze(frame1: Buffer | string, frame2: Buffer | string, options?: FrameDiffOptions): Promise<FrameDiffResult>;
+    /**
+     * 変化率を計算
+     *
+     * @param diffPixels - 差分ピクセル数
+     * @param totalPixels - 総ピクセル数
+     * @returns 変化率 (0-1)
+     */
+    calculateChangeRatio(diffPixels: number, totalPixels: number): number;
+    /**
+     * 差分画像を生成
+     *
+     * @param frame1 - 比較元フレーム
+     * @param frame2 - 比較先フレーム
+     * @param outputPath - 出力ファイルパス (オプション)
+     * @returns 差分画像バッファ
+     */
+    createDiffImage(frame1: Buffer | string, frame2: Buffer | string, outputPath?: string): Promise<Buffer>;
+    /**
+     * 入力をBufferに変換
+     */
+    private toBuffer;
+    /**
+     * 画像データをRGBA形式で取得
+     */
+    private getImageData;
+    /**
+     * 差分バッファから領域を抽出
+     *
+     * Pixelmatchの差分バッファからバウンディングボックスを計算
+     * - 差分ピクセルは赤色(255, 0, 0, 255)で描画される
+     * - アルファが0でないピクセルを差分として検出
+     *
+     * @param diffBuffer - Pixelmatchが生成した差分バッファ
+     * @param width - 画像幅
+     * @param height - 画像高さ
+     * @param expectedDiffCount - Pixelmatchが報告した差分ピクセル数
+     */
+    private extractDiffRegionsFromBuffer;
+    /**
+     * RGBAバッファをPNG画像に変換
+     */
+    private bufferToPng;
+}
+//# sourceMappingURL=frame-diff.analyzer.d.ts.map

package/dist/services/motion/analyzers/frame-diff.analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame-diff.analyzer.d.ts","sourceRoot":"","sources":["../../../../src/services/motion/analyzers/frame-diff.analyzer.ts"],"names":[],"mappings":"AA4BA;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,YAAY;IACZ,CAAC,EAAE,MAAM,CAAC;IACV,YAAY;IACZ,CAAC,EAAE,MAAM,CAAC;IACV,QAAQ;IACR,KAAK,EAAE,MAAM,CAAC;IACd,SAAS;IACT,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,gCAAgC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6BAA6B;IAC7B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,mCAAmC;IACnC,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,gBAAgB;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc;IACd,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa;IACb,eAAe,EAAE,MAAM,CAAC;IACxB,yBAAyB;IACzB,WAAW,EAAE,WAAW,EAAE,CAAC;IAC3B,uBAAuB;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAeD;;GAEG;AACH,qBAAa,cAAe,SAAQ,KAAK;gBAC3B,OAAO,EAAE,MAAM;CAI5B;AAMD;;GAEG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;IAErD;;;OAGG;gBACS,OAAO,GAAE,gBAAqB;IAe1C;;;;;;;;OAQG;IACG,OAAO,CACX,MAAM,EAAE,MAAM,GAAG,MAAM,EACvB,MAAM,EAAE,MAAM,GAAG,MAAM,EACvB,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,eAAe,CAAC;IA0E3B;;;;;;OAMG;IACH,oBAAoB,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM;IAOrE;;;;;;;OAOG;IACG,eAAe,CACnB,MAAM,EAAE,MAAM,GAAG,MAAM,EACvB,MAAM,EAAE,MAAM,GAAG,MAAM,EACvB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC;IAqBlB;;OAEG;YACW,QAAQ;IAgBtB;;OAEG;YACW,YAAY;IAoB1B;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,4BAA4B;IA+CpC;;OAEG;YACW,WAAW;CAW1B"}

package/dist/services/motion/analyzers/frame-diff.analyzer.js

@@ -0,0 +1,315 @@
+"use strict";
+// SPDX-FileCopyrightText: 2026 TKMD and Reftrix Contributors
+// SPDX-License-Identifier: AGPL-3.0-only
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FrameDiffAnalyzer = exports.FrameDiffError = void 0;
+/**
+ * FrameDiffAnalyzer
+ *
+ * Pixelmatchを使用したフレーム差分検出モジュール
+ *
+ * 機能:
+ * - 2つのフレーム間のピクセル差分検出
+ * - 変化率 (changeRatio) の計算 (0-1)
+ * - 差分領域 (BoundingBox) の抽出
+ * - 差分画像の生成
+ *
+ * 仕様: docs/specs/frame-image-analysis-spec.md
+ *
+ * @module services/motion/analyzers/frame-diff.analyzer
+ */
+const fs = __importStar(require("node:fs"));
+const pixelmatch_1 = __importDefault(require("pixelmatch"));
+const sharp_1 = __importDefault(require("sharp"));
+const logger_1 = require("../../../utils/logger");
+/**
+ * デフォルトオプション
+ */
+const DEFAULT_OPTIONS = {
+    threshold: 0.1,
+    includeDiffImage: false,
+    includeAA: true,
+};
+// =====================================================
+// エラークラス
+// =====================================================
+/**
+ * フレーム差分解析エラー
+ */
+class FrameDiffError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "FrameDiffError";
+    }
+}
+exports.FrameDiffError = FrameDiffError;
+// =====================================================
+// FrameDiffAnalyzer クラス
+// =====================================================
+/**
+ * Pixelmatchを使用したフレーム差分検出クラス
+ */
+class FrameDiffAnalyzer {
+    options;
+    /**
+     * コンストラクタ
+     * @param options - 差分検出オプション
+     */
+    constructor(options = {}) {
+        this.options = {
+            threshold: options.threshold ?? DEFAULT_OPTIONS.threshold,
+            includeDiffImage: options.includeDiffImage ?? DEFAULT_OPTIONS.includeDiffImage,
+            includeAA: options.includeAA ?? DEFAULT_OPTIONS.includeAA,
+        };
+        if ((0, logger_1.isDevelopment)()) {
+            logger_1.logger.debug("[FrameDiffAnalyzer] Initialized", {
+                threshold: this.options.threshold,
+                includeDiffImage: this.options.includeDiffImage,
+            });
+        }
+    }
+    /**
+     * 2つのフレーム間の差分を解析
+     *
+     * @param frame1 - 比較元フレーム (Buffer または ファイルパス)
+     * @param frame2 - 比較先フレーム (Buffer または ファイルパス)
+     * @param options - 解析オプション (コンストラクタオプションを上書き)
+     * @returns フレーム差分結果
+     * @throws FrameDiffError
+     */
+    async analyze(frame1, frame2, options) {
+        const opts = {
+            threshold: options?.threshold ?? this.options.threshold,
+            includeDiffImage: options?.includeDiffImage ?? this.options.includeDiffImage,
+            includeAA: options?.includeAA ?? this.options.includeAA,
+        };
+        if ((0, logger_1.isDevelopment)()) {
+            logger_1.logger.debug("[FrameDiffAnalyzer] analyze called", { threshold: opts.threshold });
+        }
+        // 入力をBufferに変換
+        const buffer1 = await this.toBuffer(frame1);
+        const buffer2 = await this.toBuffer(frame2);
+        // 画像データを取得（RGBA形式に統一）
+        const [img1Data, img2Data] = await Promise.all([
+            this.getImageData(buffer1),
+            this.getImageData(buffer2),
+        ]);
+        // サイズチェック
+        if (img1Data.width !== img2Data.width || img1Data.height !== img2Data.height) {
+            throw new FrameDiffError(`Image dimensions do not match: ${img1Data.width}x${img1Data.height} vs ${img2Data.width}x${img2Data.height}`);
+        }
+        const { width, height } = img1Data;
+        const totalPixelCount = width * height;
+        // 差分画像バッファを準備
+        const diffBuffer = Buffer.alloc(width * height * 4);
+        // Pixelmatchで差分検出
+        const diffPixelCount = (0, pixelmatch_1.default)(img1Data.data, img2Data.data, diffBuffer, width, height, {
+            threshold: opts.threshold,
+            includeAA: opts.includeAA,
+        });
+        // 変化率を計算
+        const changeRatio = this.calculateChangeRatio(diffPixelCount, totalPixelCount);
+        // 差分領域を抽出（差分がない場合は空配列）
+        const diffRegions = diffPixelCount === 0
+            ? []
+            : this.extractDiffRegionsFromBuffer(diffBuffer, width, height, diffPixelCount);
+        // 結果を構築
+        const result = {
+            changeRatio,
+            diffPixelCount,
+            totalPixelCount,
+            diffRegions,
+        };
+        // 差分画像を含める場合
+        if (opts.includeDiffImage) {
+            result.diffImageBuffer = await this.bufferToPng(diffBuffer, width, height);
+        }
+        if ((0, logger_1.isDevelopment)()) {
+            logger_1.logger.debug("[FrameDiffAnalyzer] analyze completed", {
+                changeRatio,
+                diffPixelCount,
+                totalPixelCount,
+                regionsCount: diffRegions.length,
+            });
+        }
+        return result;
+    }
+    /**
+     * 変化率を計算
+     *
+     * @param diffPixels - 差分ピクセル数
+     * @param totalPixels - 総ピクセル数
+     * @returns 変化率 (0-1)
+     */
+    calculateChangeRatio(diffPixels, totalPixels) {
+        if (totalPixels === 0) {
+            return 0;
+        }
+        return diffPixels / totalPixels;
+    }
+    /**
+     * 差分画像を生成
+     *
+     * @param frame1 - 比較元フレーム
+     * @param frame2 - 比較先フレーム
+     * @param outputPath - 出力ファイルパス (オプション)
+     * @returns 差分画像バッファ
+     */
+    async createDiffImage(frame1, frame2, outputPath) {
+        const result = await this.analyze(frame1, frame2, { includeDiffImage: true });
+        if (!result.diffImageBuffer) {
+            throw new FrameDiffError("Failed to generate diff image");
+        }
+        if (outputPath) {
+            fs.writeFileSync(outputPath, result.diffImageBuffer);
+            if ((0, logger_1.isDevelopment)()) {
+                logger_1.logger.debug("[FrameDiffAnalyzer] Diff image saved", { outputPath });
+            }
+        }
+        return result.diffImageBuffer;
+    }
+    // =====================================================
+    // プライベートメソッド
+    // =====================================================
+    /**
+     * 入力をBufferに変換
+     */
+    async toBuffer(input) {
+        if (Buffer.isBuffer(input)) {
+            if (input.length === 0) {
+                throw new FrameDiffError("Empty buffer provided");
+            }
+            return input;
+        }
+        // ファイルパスの場合
+        if (!fs.existsSync(input)) {
+            throw new FrameDiffError(`File not found: ${input}`);
+        }
+        return fs.promises.readFile(input);
+    }
+    /**
+     * 画像データをRGBA形式で取得
+     */
+    async getImageData(buffer) {
+        try {
+            const result = await (0, sharp_1.default)(buffer)
+                .ensureAlpha() // アルファチャンネルを確保
+                .raw()
+                .toBuffer({ resolveWithObject: true });
+            return {
+                data: result.data,
+                width: result.info.width,
+                height: result.info.height,
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : "Unknown error";
+            throw new FrameDiffError(`Failed to process image: ${message}`);
+        }
+    }
+    /**
+     * 差分バッファから領域を抽出
+     *
+     * Pixelmatchの差分バッファからバウンディングボックスを計算
+     * - 差分ピクセルは赤色(255, 0, 0, 255)で描画される
+     * - アルファが0でないピクセルを差分として検出
+     *
+     * @param diffBuffer - Pixelmatchが生成した差分バッファ
+     * @param width - 画像幅
+     * @param height - 画像高さ
+     * @param expectedDiffCount - Pixelmatchが報告した差分ピクセル数
+     */
+    extractDiffRegionsFromBuffer(diffBuffer, width, height, expectedDiffCount) {
+        if (expectedDiffCount === 0) {
+            return [];
+        }
+        // 差分があるピクセルの座標からバウンディングボックスを計算
+        // Pixelmatchは差分ピクセルをdiffColor（デフォルト: 赤#FF0000）で描画
+        // アルファが255のピクセルを差分として検出
+        let minX = width;
+        let minY = height;
+        let maxX = -1;
+        let maxY = -1;
+        for (let y = 0; y < height; y++) {
+            for (let x = 0; x < width; x++) {
+                const offset = (y * width + x) * 4;
+                // アルファチャンネルで差分を検出（Pixelmatchはa=255で差分を描画）
+                const alpha = diffBuffer[offset + 3];
+                if (alpha !== undefined && alpha > 0) {
+                    if (x < minX)
+                        minX = x;
+                    if (y < minY)
+                        minY = y;
+                    if (x > maxX)
+                        maxX = x;
+                    if (y > maxY)
+                        maxY = y;
+                }
+            }
+        }
+        // 差分が見つからなかった場合
+        if (maxX < 0 || maxY < 0) {
+            return [];
+        }
+        return [
+            {
+                x: minX,
+                y: minY,
+                width: maxX - minX + 1,
+                height: maxY - minY + 1,
+            },
+        ];
+    }
+    /**
+     * RGBAバッファをPNG画像に変換
+     */
+    async bufferToPng(buffer, width, height) {
+        return (0, sharp_1.default)(buffer, {
+            raw: {
+                width,
+                height,
+                channels: 4,
+            },
+        })
+            .png()
+            .toBuffer();
+    }
+}
+exports.FrameDiffAnalyzer = FrameDiffAnalyzer;
+//# sourceMappingURL=frame-diff.analyzer.js.map

package/dist/services/motion/analyzers/frame-diff.analyzer.js.map

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

package/dist/services/motion/analyzers/layout-shift.detector.d.ts

@@ -0,0 +1,132 @@
+/**
+ * Layout Shift Detector
+ *
+ * フレーム差分からレイアウトシフトを検出し、CLS (Cumulative Layout Shift) スコアを計算する
+ *
+ * CLS計算仕様:
+ * - impact_fraction: ビューポートに対する変化領域の割合
+ * - distance_fraction: ビューポートの最大次元に対する移動距離の割合
+ * - layout_shift_score = impact_fraction * distance_fraction
+ *
+ * 分類閾値:
+ * - good: < 0.1
+ * - needs-improvement: >= 0.1 && < 0.25
+ * - poor: >= 0.25
+ *
+ * @module @reftrixmcp/mcp-server/services/motion/analyzers/layout-shift.detector
+ */
+/**
+ * バウンディングボックス
+ */
+export interface BoundingBox {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+/**
+ * ビューポート情報
+ */
+export interface Viewport {
+    width: number;
+    height: number;
+}
+/**
+ * 差分領域情報
+ * フレーム差分検出から得られる変化領域
+ */
+export interface DiffRegion {
+    /** 左上X座標 */
+    x: number;
+    /** 左上Y座標 */
+    y: number;
+    /** 幅 */
+    width: number;
+    /** 高さ */
+    height: number;
+    /** 変化強度 (0-1) */
+    changeIntensity: number;
+    /** 変化ピクセル数 */
+    pixelCount: number;
+    /** 前フレームでの位置（移動情報がある場合） */
+    previousPosition?: {
+        x: number;
+        y: number;
+    };
+}
+/**
+ * 個別のレイアウトシフト情報
+ */
+export interface LayoutShift {
+    /** シフト領域 */
+    region: BoundingBox;
+    /** 影響割合 (0-1) - ビューポートに対する変化領域の割合 */
+    impactFraction: number;
+    /** 移動距離割合 (0-1) - ビューポート最大次元に対する移動距離の割合 */
+    distanceFraction: number;
+    /** シフトスコア (impactFraction * distanceFraction) */
+    score: number;
+}
+/**
+ * レイアウトシフト分析結果
+ */
+export interface LayoutShiftResult {
+    /** 累積レイアウトシフトスコア (0-1+) */
+    cls: number;
+    /** 分類 */
+    classification: "good" | "needs-improvement" | "poor";
+    /** 検出されたシフト一覧 */
+    shifts: LayoutShift[];
+    /** 全体の影響割合 */
+    impactFraction: number;
+    /** 全体の移動距離割合 */
+    distanceFraction: number;
+}
+/**
+ * レイアウトシフト検出器
+ *
+ * フレーム差分からレイアウトシフトを検出し、CLSスコアを計算する
+ */
+export declare class LayoutShiftDetector {
+    /**
+     * 差分領域からレイアウトシフトを検出
+     *
+     * @param diffRegions - 差分領域の配列
+     * @param viewport - ビューポート情報
+     * @returns 検出されたレイアウトシフトの配列
+     * @throws Error - ビューポートが無効な場合
+     */
+    detectShifts(diffRegions: DiffRegion[], viewport: Viewport): LayoutShift[];
+    /**
+     * シフト配列からCLSを計算
+     *
+     * @param shifts - レイアウトシフトの配列
+     * @returns 累積レイアウトシフトスコア
+     */
+    calculateCLS(shifts: LayoutShift[]): number;
+    /**
+     * CLSスコアを分類
+     *
+     * @param cls - CLSスコア
+     * @returns 分類結果 ('good' | 'needs-improvement' | 'poor')
+     */
+    classifyShift(cls: number): "good" | "needs-improvement" | "poor";
+    /**
+     * フレームペアを解析してレイアウトシフト結果を返す
+     *
+     * @param diffRegions - 差分領域の配列
+     * @param viewport - ビューポート情報
+     * @returns レイアウトシフト分析結果
+     */
+    analyzeFramePair(diffRegions: DiffRegion[], viewport: Viewport): LayoutShiftResult;
+    /**
+     * ビューポートのバリデーション
+     */
+    private validateViewport;
+    /**
+     * ビューポート内の有効領域面積を計算
+     */
+    private calculateVisibleArea;
+}
+export default LayoutShiftDetector;
+//# sourceMappingURL=layout-shift.detector.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"layout-shift.detector.d.ts","sourceRoot":"","sources":["../../../../src/services/motion/analyzers/layout-shift.detector.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;GAgBG;AAMH;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,YAAY;IACZ,CAAC,EAAE,MAAM,CAAC;IACV,YAAY;IACZ,CAAC,EAAE,MAAM,CAAC;IACV,QAAQ;IACR,KAAK,EAAE,MAAM,CAAC;IACd,SAAS;IACT,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,2BAA2B;IAC3B,gBAAgB,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC7C;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,YAAY;IACZ,MAAM,EAAE,WAAW,CAAC;IACpB,qCAAqC;IACrC,cAAc,EAAE,MAAM,CAAC;IACvB,2CAA2C;IAC3C,gBAAgB,EAAE,MAAM,CAAC;IACzB,iDAAiD;IACjD,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,2BAA2B;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS;IACT,cAAc,EAAE,MAAM,GAAG,mBAAmB,GAAG,MAAM,CAAC;IACtD,iBAAiB;IACjB,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,cAAc;IACd,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB;IAChB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAuBD;;;;GAIG;AACH,qBAAa,mBAAmB;IAC9B;;;;;;;OAOG;IACH,YAAY,CAAC,WAAW,EAAE,UAAU,EAAE,EAAE,QAAQ,EAAE,QAAQ,GAAG,WAAW,EAAE;IAwD1E;;;;;OAKG;IACH,YAAY,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM;IAS3C;;;;;OAKG;IACH,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,mBAAmB,GAAG,MAAM;IAWjE;;;;;;OAMG;IACH,gBAAgB,CAAC,WAAW,EAAE,UAAU,EAAE,EAAE,QAAQ,EAAE,QAAQ,GAAG,iBAAiB;IAwClF;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAMxB;;OAEG;IACH,OAAO,CAAC,oBAAoB;CAiB7B;AAED,eAAe,mBAAmB,CAAC"}