@reftrixmcp/mcp-server 0.1.7

package/dist/tools/page/handlers/result-builder.js

@@ -0,0 +1,447 @@
+"use strict";
+// SPDX-FileCopyrightText: 2026 TKMD and Reftrix Contributors
+// SPDX-License-Identifier: AGPL-3.0-only
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.determineErrorCode = determineErrorCode;
+exports.buildLayoutResult = buildLayoutResult;
+exports.buildMotionResult = buildMotionResult;
+exports.buildQualityResult = buildQualityResult;
+exports.buildNarrativeResult = buildNarrativeResult;
+exports.buildBackgroundDesignsSummary = buildBackgroundDesignsSummary;
+exports.extractWarning = extractWarning;
+exports.extractActionableWarning = extractActionableWarning;
+exports.extractAllActionableWarnings = extractAllActionableWarnings;
+/**
+ * page.analyze 結果ビルダー
+ * Layout/Motion/Quality の分析結果を PageAnalyzeOutput 形式に変換
+ *
+ * @module tools/page/handlers/result-builder
+ */
+const schemas_1 = require("../schemas");
+const actionable_warning_1 = require("../../../utils/actionable-warning");
+// =====================================================
+// エラーコード判定
+// =====================================================
+/**
+ * エラーメッセージから適切なエラーコードを判定
+ */
+function determineErrorCode(errorMessage) {
+    if (errorMessage.includes("timeout") || errorMessage.includes("Timeout")) {
+        return schemas_1.PAGE_ANALYZE_ERROR_CODES.TIMEOUT_ERROR;
+    }
+    if (errorMessage.includes("404") || errorMessage.includes("Not Found")) {
+        return schemas_1.PAGE_ANALYZE_ERROR_CODES.HTTP_ERROR;
+    }
+    if (errorMessage.includes("browser") || errorMessage.includes("Browser")) {
+        return schemas_1.PAGE_ANALYZE_ERROR_CODES.BROWSER_ERROR;
+    }
+    return schemas_1.PAGE_ANALYZE_ERROR_CODES.NETWORK_ERROR;
+}
+// =====================================================
+// Result Builders
+// =====================================================
+/**
+ * レイアウト結果を構築
+ */
+function buildLayoutResult(lr, isSummary, layoutOptions) {
+    // 基本フィールドでLayoutResultSummaryを構築
+    const base = {
+        success: lr.success,
+        pageId: lr.pageId,
+        sectionCount: lr.sectionCount,
+        sectionTypes: lr.sectionTypes,
+        processingTimeMs: lr.processingTimeMs,
+        error: lr.error,
+    };
+    // CSSフレームワーク検出結果（summary/full 共通で含める）
+    // CSSフレームワーク検出はDB保存の重要な情報のため、常に含める
+    if (lr.cssFramework !== undefined) {
+        // LayoutServiceResultのcssFrameworkをLayoutResultSummaryのcssFrameworkに変換
+        const cssFramework = {
+            framework: lr.cssFramework.framework,
+            confidence: lr.cssFramework.confidence,
+            evidence: lr.cssFramework.evidence,
+        };
+        base.cssFramework = cssFramework;
+    }
+    if (lr.cssSnippet !== undefined) {
+        base.cssSnippet = lr.cssSnippet;
+    }
+    if (isSummary) {
+        // Summary版: include_html/include_screenshotは独立して適用
+        // MCP-RESP-03: snake_case (include_html) を優先し、camelCase (includeHtml) はフォールバック
+        const shouldIncludeHtml = layoutOptions?.include_html ?? layoutOptions?.includeHtml;
+        const shouldIncludeScreenshot = layoutOptions?.include_screenshot ?? layoutOptions?.includeScreenshot;
+        if (shouldIncludeHtml && lr.html) {
+            base.html = lr.html;
+        }
+        if (shouldIncludeScreenshot && lr.screenshot) {
+            base.screenshot = lr.screenshot;
+        }
+        // Vision解析結果は useVision=true の場合、summaryでも含める（明示的に有効化された結果）
+        if (layoutOptions?.useVision && lr.visionFeatures) {
+            base.visionFeatures = lr.visionFeatures;
+        }
+        if (layoutOptions?.useVision && lr.textRepresentation) {
+            base.textRepresentation = lr.textRepresentation;
+        }
+        // Visual Features は常にsummaryに含める（明示的に抽出された結果）
+        if (lr.visualFeatures !== undefined) {
+            base.visualFeatures = lr.visualFeatures;
+        }
+        // CSS Variables は常にsummaryに含める（v0.1.0: デザイン参考データ）
+        if (lr.cssVariables !== undefined) {
+            base.cssVariables = lr.cssVariables;
+        }
+    }
+    else {
+        // Full版: 値が存在する場合のみ設定
+        if (lr.html !== undefined) {
+            base.html = lr.html;
+        }
+        if (lr.screenshot !== undefined) {
+            base.screenshot = lr.screenshot;
+        }
+        if (lr.sections !== undefined) {
+            base.sections = lr.sections;
+        }
+        // Vision解析結果（Full版）
+        if (lr.visionFeatures !== undefined) {
+            base.visionFeatures = lr.visionFeatures;
+        }
+        if (lr.textRepresentation !== undefined) {
+            base.textRepresentation = lr.textRepresentation;
+        }
+        // Visual Features（Phase 1/2統合結果）
+        if (lr.visualFeatures !== undefined) {
+            base.visualFeatures = lr.visualFeatures;
+        }
+        // CSS Variables（v0.1.0: デザイン参考データ）
+        if (lr.cssVariables !== undefined) {
+            base.cssVariables = lr.cssVariables;
+        }
+    }
+    return base;
+}
+/**
+ * モーション結果を構築
+ */
+function buildMotionResult(mr, isSummary) {
+    const base = {
+        success: mr.success,
+        patternCount: mr.patternCount,
+        categoryBreakdown: mr.categoryBreakdown,
+        warningCount: mr.warningCount,
+        a11yWarningCount: mr.a11yWarningCount,
+        perfWarningCount: mr.perfWarningCount,
+        processingTimeMs: mr.processingTimeMs,
+        error: mr.error,
+    };
+    if (!isSummary) {
+        if (mr.patterns !== undefined) {
+            base.patterns = mr.patterns;
+        }
+        if (mr.warnings !== undefined) {
+            base.warnings = mr.warnings;
+        }
+    }
+    // === Video Mode 結果（summary/full 共通で含める） ===
+    // video mode 結果は明示的に有効化された場合のみ存在するため、
+    // summary モードでも含める（ユーザーが意図的に有効化した結果）
+    if (mr.frame_capture !== undefined) {
+        base.frame_capture = mr.frame_capture;
+    }
+    if (mr.frame_analysis !== undefined) {
+        base.frame_analysis = mr.frame_analysis;
+    }
+    if (mr.frame_capture_error !== undefined) {
+        base.frame_capture_error = mr.frame_capture_error;
+    }
+    if (mr.frame_analysis_error !== undefined) {
+        base.frame_analysis_error = mr.frame_analysis_error;
+    }
+    // === JS Animation 結果（summary/full 共通で含める）(v0.1.0) ===
+    // JS Animation 結果は明示的に有効化された場合のみ存在するため、
+    // summary モードでも含める（ユーザーが意図的に有効化した結果）
+    if (mr.js_animation_summary !== undefined) {
+        base.js_animation_summary = mr.js_animation_summary;
+    }
+    if (mr.js_animations !== undefined) {
+        base.js_animations = mr.js_animations;
+    }
+    if (mr.js_animation_error !== undefined) {
+        base.js_animation_error = mr.js_animation_error;
+    }
+    // === WebGL Animation 結果（summary/full 共通で含める）(v0.1.0) ===
+    // WebGL Animation 結果は明示的に有効化された場合のみ存在するため、
+    // summary モードでも含める（ユーザーが意図的に有効化した結果）
+    if (mr.webgl_animation_summary !== undefined) {
+        base.webgl_animation_summary = mr.webgl_animation_summary;
+    }
+    if (mr.webgl_animations !== undefined) {
+        base.webgl_animations = mr.webgl_animations;
+    }
+    if (mr.webgl_animation_error !== undefined) {
+        base.webgl_animation_error = mr.webgl_animation_error;
+    }
+    return base;
+}
+/**
+ * 品質結果を構築
+ */
+function buildQualityResult(qr, isSummary, qualityOptions) {
+    const base = {
+        success: qr.success,
+        overallScore: qr.overallScore,
+        grade: qr.grade,
+        axisScores: qr.axisScores,
+        clicheCount: qr.clicheCount,
+        processingTimeMs: qr.processingTimeMs,
+        error: qr.error,
+    };
+    if (isSummary) {
+        // includeRecommendationsはsummaryと独立して適用
+        if (qualityOptions?.includeRecommendations !== false && qr.recommendations) {
+            base.recommendations = qr.recommendations;
+        }
+    }
+    else {
+        // Full版: 値が存在する場合のみ設定
+        if (qr.axisGrades !== undefined) {
+            base.axisGrades = qr.axisGrades;
+        }
+        if (qr.axisDetails !== undefined) {
+            base.axisDetails = qr.axisDetails;
+        }
+        if (qr.cliches !== undefined) {
+            base.cliches = qr.cliches;
+        }
+        if (qr.recommendations !== undefined) {
+            base.recommendations = qr.recommendations;
+        }
+    }
+    return base;
+}
+/**
+ * Narrative結果を構築（v0.1.0）
+ *
+ * NarrativeHandlerResultをNarrativeResult形式に変換
+ */
+function buildNarrativeResult(nr, _isSummary // TODO: summary/full mode実装時に使用
+) {
+    // スキップされた場合またはnarrativeが存在しない場合はundefined
+    if (nr.skipped || !nr.narrative) {
+        return undefined;
+    }
+    // 失敗した場合もundefined（エラーはwarningsに含める）
+    if (!nr.success) {
+        return undefined;
+    }
+    const narrative = nr.narrative;
+    // 基本フィールド（summary/full 共通）
+    const base = {
+        worldView: {
+            moodCategory: narrative.worldView
+                .moodCategory,
+            moodDescription: narrative.worldView.moodDescription,
+            colorImpression: narrative.worldView.colorImpression,
+            typographyPersonality: narrative.worldView.typographyPersonality,
+            overallTone: narrative.worldView.overallTone,
+        },
+        layoutStructure: {
+            gridSystem: narrative.layoutStructure.gridSystem,
+        },
+        confidence: narrative.confidence,
+        analyzedAt: narrative.analyzedAt,
+    };
+    // Optional fields (exactOptionalPropertyTypes対応)
+    if (narrative.id !== undefined) {
+        base.id = narrative.id;
+    }
+    if (narrative.webPageId !== undefined) {
+        base.webPageId = narrative.webPageId;
+    }
+    if (narrative.worldView.secondaryMoodCategory !== undefined) {
+        base.worldView.secondaryMoodCategory = narrative.worldView
+            .secondaryMoodCategory;
+    }
+    if (narrative.worldView.motionEmotion !== undefined) {
+        base.worldView.motionEmotion = narrative.worldView.motionEmotion;
+    }
+    if (narrative.processingTimeMs !== undefined) {
+        base.processingTimeMs = narrative.processingTimeMs;
+    }
+    if (narrative.visionUsed !== undefined) {
+        base.visionUsed = narrative.visionUsed;
+    }
+    if (narrative.fallbackReason !== undefined) {
+        base.fallbackReason = narrative.fallbackReason;
+    }
+    // LayoutStructure optional fields
+    if (narrative.layoutStructure.columnCount !== undefined) {
+        base.layoutStructure.columnCount = narrative.layoutStructure.columnCount;
+    }
+    if (narrative.layoutStructure.gutterWidth !== undefined) {
+        base.layoutStructure.gutterWidth = narrative.layoutStructure.gutterWidth;
+    }
+    if (narrative.layoutStructure.containerWidth !== undefined) {
+        base.layoutStructure.containerWidth = narrative.layoutStructure.containerWidth;
+    }
+    if (narrative.layoutStructure.visualHierarchy !== undefined) {
+        base.layoutStructure.visualHierarchy = narrative.layoutStructure.visualHierarchy;
+    }
+    if (narrative.layoutStructure.spacingRhythm !== undefined) {
+        base.layoutStructure.spacingRhythm = narrative.layoutStructure.spacingRhythm;
+    }
+    if (narrative.layoutStructure.whitespaceRatio !== undefined) {
+        base.layoutStructure.whitespaceRatio = narrative.layoutStructure.whitespaceRatio;
+    }
+    if (narrative.layoutStructure.visualDensity !== undefined) {
+        base.layoutStructure.visualDensity = narrative.layoutStructure.visualDensity;
+    }
+    return base;
+}
+// =====================================================
+// Background Design Summary Builder
+// =====================================================
+/**
+ * 背景デザイン検出結果のサマリーを構築
+ *
+ * LayoutServiceResultのbackgroundDesignsとDB保存結果から
+ * PageAnalyzeDataのbackgroundDesignsフィールドを生成する。
+ *
+ * @param backgroundDesigns - 検出された背景デザインデータ配列
+ * @param savedToDbCount - DBに保存された件数（saveToDb=false時は0）
+ * @returns backgroundDesignsサマリーオブジェクト、またはundefined（検出なし時）
+ */
+function buildBackgroundDesignsSummary(backgroundDesigns, savedToDbCount) {
+    const count = backgroundDesigns?.length ?? 0;
+    // 検出なしの場合はundefined（レスポンスサイズ削減）
+    if (count === 0) {
+        return undefined;
+    }
+    return {
+        count,
+        types: backgroundDesigns?.map((bg) => bg.designType) ?? [],
+        savedToDb: savedToDbCount,
+    };
+}
+// =====================================================
+// Warning Extraction
+// =====================================================
+/**
+ * 分析結果からwarningを抽出
+ */
+function extractWarning(feature, result) {
+    if (!result.success && result.error) {
+        return {
+            feature,
+            code: result.error.code,
+            message: result.error.message,
+        };
+    }
+    return null;
+}
+// =====================================================
+// Actionable Warning Extraction (v0.1.0)
+// =====================================================
+/**
+ * エラーメッセージからアクショナブル警告を生成
+ *
+ * エラーコードとメッセージを解析し、適切なWarningFactoryメソッドを呼び出す。
+ * 対応するFactoryメソッドがない場合は、legacyWarningToActionableでフォールバック変換。
+ */
+function extractActionableWarning(feature, result, context) {
+    if (!result.success && result.error) {
+        const { code, message } = result.error;
+        // タイムアウトエラーの検出
+        if (code === schemas_1.PAGE_ANALYZE_ERROR_CODES.TIMEOUT_ERROR ||
+            message.toLowerCase().includes("timeout") ||
+            message.toLowerCase().includes("timed out")) {
+            return actionable_warning_1.WarningFactory.pageTimeout(context?.url || "unknown", context?.timeoutMs || 60000);
+        }
+        // ネットワークエラーの検出
+        if (code === schemas_1.PAGE_ANALYZE_ERROR_CODES.NETWORK_ERROR ||
+            message.toLowerCase().includes("network") ||
+            message.toLowerCase().includes("fetch") ||
+            message.toLowerCase().includes("econnrefused")) {
+            return actionable_warning_1.WarningFactory.networkError(context?.url || "unknown", message);
+        }
+        // HTTPエラーの検出（404など）
+        if (code === schemas_1.PAGE_ANALYZE_ERROR_CODES.HTTP_ERROR ||
+            message.includes("404") ||
+            message.includes("403") ||
+            message.includes("500")) {
+            const statusMatch = message.match(/(\d{3})/);
+            const statusCode = statusMatch?.[1] ? parseInt(statusMatch[1], 10) : 0;
+            return actionable_warning_1.WarningFactory.httpError(context?.url ?? "unknown", statusCode);
+        }
+        // ブラウザエラーの検出
+        if (code === schemas_1.PAGE_ANALYZE_ERROR_CODES.BROWSER_ERROR ||
+            message.toLowerCase().includes("browser") ||
+            message.toLowerCase().includes("playwright") ||
+            message.toLowerCase().includes("chromium")) {
+            return actionable_warning_1.WarningFactory.browserError(message);
+        }
+        // Vision分析が利用不可の場合
+        if (message.toLowerCase().includes("vision") &&
+            (message.toLowerCase().includes("unavailable") ||
+                message.toLowerCase().includes("not available") ||
+                message.toLowerCase().includes("failed"))) {
+            return actionable_warning_1.WarningFactory.visionUnavailableSimple();
+        }
+        // レイアウト固有のエラー
+        if (feature === "layout") {
+            if (message.toLowerCase().includes("no sections") ||
+                message.toLowerCase().includes("セクションが見つかり")) {
+                return actionable_warning_1.WarningFactory.noSectionsDetected(context?.url || "unknown");
+            }
+        }
+        // モーション固有のエラー
+        if (feature === "motion") {
+            if (message.toLowerCase().includes("no animation") ||
+                message.toLowerCase().includes("no motion") ||
+                message.toLowerCase().includes("アニメーションが見つかり")) {
+                return actionable_warning_1.WarningFactory.noAnimationsDetected(context?.url || "unknown");
+            }
+        }
+        // 品質評価固有のエラー
+        if (feature === "quality") {
+            if (message.toLowerCase().includes("low score") ||
+                message.toLowerCase().includes("スコアが低")) {
+                return actionable_warning_1.WarningFactory.lowQualityScore(50, "overall");
+            }
+        }
+        // フォールバック: レガシー警告をアクショナブル形式に変換
+        const legacyWarning = {
+            feature,
+            code,
+            message,
+        };
+        return (0, actionable_warning_1.legacyWarningToActionable)(legacyWarning);
+    }
+    return null;
+}
+/**
+ * 複数の分析結果からアクショナブル警告配列を生成
+ */
+function extractAllActionableWarnings(results, context) {
+    const warnings = [];
+    if (results.layout) {
+        const warning = extractActionableWarning("layout", results.layout, context);
+        if (warning)
+            warnings.push(warning);
+    }
+    if (results.motion) {
+        const warning = extractActionableWarning("motion", results.motion, context);
+        if (warning)
+            warnings.push(warning);
+    }
+    if (results.quality) {
+        const warning = extractActionableWarning("quality", results.quality, context);
+        if (warning)
+            warnings.push(warning);
+    }
+    return warnings;
+}
+//# sourceMappingURL=result-builder.js.map

package/dist/tools/page/handlers/result-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result-builder.js","sourceRoot":"","sources":["../../../../src/tools/page/handlers/result-builder.ts"],"names":[],"mappings":"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"}

package/dist/tools/page/handlers/retry-strategy.d.ts

@@ -0,0 +1,106 @@
+/**
+ * リトライ戦略
+ *
+ * page.analyze のリトライ動作を制御するための戦略パターン。
+ * サイトの種類（SiteTier）に応じて適切なリトライ設定を提供する。
+ *
+ * 主な目的:
+ * - タイムアウト累積を防止してMCP 600秒上限を遵守
+ * - WebGL/重量サイトでのリトライ回数削減
+ * - ネットワークエラーとタイムアウトエラーの区別
+ *
+ * @module tools/page/handlers/retry-strategy
+ */
+/**
+ * リトライ戦略の設定インターフェース
+ */
+export interface RetryStrategyConfig {
+    /** 自動リトライを有効にするか */
+    autoRetry: boolean;
+    /** 最大リトライ回数（0の場合はリトライなし） */
+    maxRetries: number;
+    /** リトライ時のタイムアウト乗数（1.0=累積なし, 1.5=従来動作） */
+    timeoutMultiplier: number;
+    /** リトライ間の待機時間（ミリ秒） */
+    waitBetweenRetriesMs: number;
+    /** ネットワークエラーのみリトライするか（true=タイムアウトはリトライしない） */
+    retryOnlyOnNetworkError: boolean;
+}
+/**
+ * サイトの種類（重さ）を表す型
+ *
+ * - normal: 通常のWebサイト（60秒以内で取得可能）
+ * - webgl: WebGL/Three.jsサイト（120秒程度かかる）
+ * - heavy: 重いWebGL/3Dサイト（180秒程度かかる）
+ * - ultra-heavy: 非常に重いサイト（resn.co.nz等、180秒+でもタイムアウトする可能性）
+ */
+export type SiteTier = "normal" | "webgl" | "heavy" | "ultra-heavy";
+/**
+ * サイトの種類に応じたリトライ戦略を取得する
+ *
+ * @param siteTier - サイトの種類
+ * @returns リトライ戦略の設定
+ *
+ * @example
+ * ```typescript
+ * const config = getRetryStrategy('ultra-heavy');
+ * // {
+ * //   autoRetry: true,
+ * //   maxRetries: 1,
+ * //   timeoutMultiplier: 1.0,  // 累積なし
+ * //   waitBetweenRetriesMs: 5000,
+ * //   retryOnlyOnNetworkError: true,
+ * // }
+ * ```
+ */
+export declare function getRetryStrategy(siteTier: SiteTier): RetryStrategyConfig;
+/**
+ * エラーがネットワークエラーかどうかを判定する
+ *
+ * @param error - 検査対象のエラー
+ * @returns ネットワークエラーの場合はtrue
+ *
+ * @example
+ * ```typescript
+ * isNetworkError(new Error('net::ERR_CONNECTION_REFUSED')); // true
+ * isNetworkError(new Error('Timeout waiting for page')); // false
+ * isNetworkError('not an error'); // false
+ * ```
+ */
+export declare function isNetworkError(error: unknown): boolean;
+/**
+ * 最大総所要時間を計算する
+ *
+ * リトライ戦略に基づいて、最悪ケースの総所要時間を計算する。
+ * MCP 600秒上限との比較に使用する。
+ *
+ * @param baseTimeoutMs - 基本タイムアウト（ミリ秒）
+ * @param config - リトライ戦略設定
+ * @returns 最大総所要時間（ミリ秒）
+ *
+ * @example
+ * ```typescript
+ * const config = getRetryStrategy('ultra-heavy');
+ * const maxTime = calculateMaxTotalTime(180000, config);
+ * // 180000 + 180000 + 5000 = 365000ms (365秒)
+ * ```
+ */
+export declare function calculateMaxTotalTime(baseTimeoutMs: number, config: RetryStrategyConfig): number;
+/**
+ * リトライすべきかどうかを判定する
+ *
+ * @param error - 発生したエラー
+ * @param currentAttempt - 現在の試行回数（0-indexed）
+ * @param config - リトライ戦略設定
+ * @returns リトライすべき場合はtrue
+ *
+ * @example
+ * ```typescript
+ * const config = getRetryStrategy('ultra-heavy');
+ * shouldRetry(new Error('net::ERR_...'), 0, config); // true (ネットワークエラー)
+ * shouldRetry(new Error('Timeout'), 0, config); // false (タイムアウトはリトライしない)
+ * shouldRetry(new Error('net::ERR_...'), 1, config); // false (maxRetries=1に到達)
+ * ```
+ */
+export declare function shouldRetry(error: unknown, currentAttempt: number, config: RetryStrategyConfig): boolean;
+//# sourceMappingURL=retry-strategy.d.ts.map

package/dist/tools/page/handlers/retry-strategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry-strategy.d.ts","sourceRoot":"","sources":["../../../../src/tools/page/handlers/retry-strategy.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;GAYG;AAEH;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,oBAAoB;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,4BAA4B;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,yCAAyC;IACzC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,sBAAsB;IACtB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,8CAA8C;IAC9C,uBAAuB,EAAE,OAAO,CAAC;CAClC;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,OAAO,GAAG,aAAa,CAAC;AAEpE;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,GAAG,mBAAmB,CA4CxE;AAmBD;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAQtD;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,qBAAqB,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,mBAAmB,GAAG,MAAM,CAkBhG;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,OAAO,EACd,cAAc,EAAE,MAAM,EACtB,MAAM,EAAE,mBAAmB,GAC1B,OAAO,CAkBT"}