@reftrixmcp/mcp-server 0.1.7

package/dist/services/responsive/responsive-quality-evaluator.service.js

@@ -0,0 +1,448 @@
+"use strict";
+// SPDX-FileCopyrightText: 2026 TKMD and Reftrix Contributors
+// SPDX-License-Identifier: AGPL-3.0-only
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.responsiveQualityEvaluatorService = exports.ResponsiveQualityEvaluatorService = void 0;
+const logger_1 = require("../../utils/logger");
+const shared_browser_manager_1 = require("./shared-browser-manager");
+/**
+ * タッチターゲット最小サイズ (WCAG 2.5.5)
+ */
+const TOUCH_TARGET_MIN_SIZE = 44;
+/**
+ * 読みやすさ基準値
+ */
+const READABILITY_MIN_FONT_SIZE = 16;
+const READABILITY_MAX_LINE_LENGTH = 80;
+const READABILITY_MIN_LINE_HEIGHT = 1.5;
+/**
+ * デフォルト品質評価ビューポート
+ */
+const QUALITY_VIEWPORTS = [
+    { name: "desktop", width: 1440, height: 900 },
+    { name: "tablet", width: 768, height: 1024 },
+    { name: "mobile", width: 375, height: 667 },
+];
+/**
+ * Responsive Quality Evaluator Service
+ */
+class ResponsiveQualityEvaluatorService {
+    browserManager = new shared_browser_manager_1.SharedBrowserManager("ResponsiveQualityEvaluator");
+    /**
+     * URLに対してレスポンシブ品質評価を実行
+     *
+     * @param url - 評価対象URL
+     * @param options - 評価オプション
+     * @param sharedBrowser - 共有ブラウザインスタンス（Worker pipeline用）
+     * @returns 品質評価結果
+     */
+    async evaluate(url, options, sharedBrowser) {
+        const startTime = Date.now();
+        const viewports = options?.viewports ?? QUALITY_VIEWPORTS;
+        const timeout = options?.timeout ?? 30000;
+        const checks = {
+            touchTargets: options?.checks?.touchTargets ?? true,
+            readability: options?.checks?.readability ?? true,
+            overflow: options?.checks?.overflow ?? true,
+            images: options?.checks?.images ?? true,
+        };
+        if ((0, logger_1.isDevelopment)()) {
+            logger_1.logger.info("[ResponsiveQualityEvaluator] Starting evaluation", {
+                url,
+                viewports: viewports.map((v) => v.name),
+                checks,
+                usingSharedBrowser: !!sharedBrowser,
+            });
+        }
+        const browser = await this.browserManager.resolveOrLaunch(sharedBrowser);
+        const viewportResults = [];
+        // 順次評価（並列だとリソース消費が大きいため）
+        for (const viewport of viewports) {
+            try {
+                const result = await this.evaluateAtViewport(browser, url, viewport, timeout, checks);
+                viewportResults.push(result);
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                if ((0, logger_1.isDevelopment)()) {
+                    logger_1.logger.error("[ResponsiveQualityEvaluator] Evaluation failed for viewport", {
+                        viewport: viewport.name,
+                        error: errorMessage,
+                    });
+                }
+                // エラー時はデフォルト値で埋める
+                viewportResults.push(this.createDefaultResult(viewport));
+            }
+        }
+        const overallScore = this.calculateOverallScore(viewportResults);
+        const evaluationTimeMs = Date.now() - startTime;
+        if ((0, logger_1.isDevelopment)()) {
+            logger_1.logger.info("[ResponsiveQualityEvaluator] Evaluation completed", {
+                url,
+                viewportCount: viewportResults.length,
+                overallScore,
+                evaluationTimeMs,
+            });
+        }
+        return {
+            viewportResults,
+            overallScore,
+            evaluationTimeMs,
+        };
+    }
+    /**
+     * 指定ビューポートで品質メトリクスを計測
+     */
+    async evaluateAtViewport(browser, url, viewport, timeout, checks) {
+        let context = null;
+        let page = null;
+        try {
+            context = await browser.newContext({
+                viewport: { width: viewport.width, height: viewport.height },
+                userAgent: shared_browser_manager_1.SharedBrowserManager.getUserAgent(viewport.name),
+            });
+            page = await context.newPage();
+            page.setDefaultTimeout(timeout);
+            await page.goto(url, {
+                timeout,
+                waitUntil: "load",
+            });
+            // DOM安定化を待つ
+            await page.waitForTimeout(500);
+            // 各チェックを実行
+            const [touchTargets, readability, overflow, images] = await Promise.all([
+                checks.touchTargets ? this.checkTouchTargets(page) : this.defaultTouchTargetResult(),
+                checks.readability ? this.checkReadability(page) : this.defaultReadabilityResult(),
+                checks.overflow ? this.checkOverflow(page) : this.defaultOverflowResult(),
+                checks.images ? this.checkResponsiveImages(page) : this.defaultImageResult(),
+            ]);
+            return {
+                viewport,
+                touchTargets,
+                readability,
+                overflow,
+                images,
+            };
+        }
+        finally {
+            if (page) {
+                await page.close().catch(() => { });
+            }
+            if (context) {
+                await context.close().catch(() => { });
+            }
+        }
+    }
+    /**
+     * タッチターゲットサイズ検出（WCAG 2.5.5: 44x44px）
+     */
+    async checkTouchTargets(page) {
+        const result = await page.evaluate(`(function() {
+        var minSize = ${TOUCH_TARGET_MIN_SIZE};
+        var selectors = 'a, button, input, select, textarea, [role="button"], [role="link"], [tabindex]';
+        var elements = document.querySelectorAll(selectors);
+        var passed = 0;
+        var failed = 0;
+        var failedElements = [];
+
+        for (var i = 0; i < elements.length; i++) {
+          var el = elements[i];
+          var style = window.getComputedStyle(el);
+          if (style.display === 'none' || style.visibility === 'hidden') {
+            continue;
+          }
+
+          var rect = el.getBoundingClientRect();
+          if (rect.width === 0 && rect.height === 0) {
+            continue;
+          }
+
+          if (rect.width >= minSize && rect.height >= minSize) {
+            passed++;
+          } else {
+            failed++;
+            if (failedElements.length < 20) {
+              var tag = el.tagName.toLowerCase();
+              var id = el.id ? '#' + el.id : '';
+              var cls = el.className && typeof el.className === 'string'
+                ? '.' + el.className.trim().split(/\\s+/).slice(0, 2).join('.')
+                : '';
+              failedElements.push({
+                selector: tag + id + cls,
+                width: Math.round(rect.width * 10) / 10,
+                height: Math.round(rect.height * 10) / 10,
+              });
+            }
+          }
+        }
+
+        return { passed: passed, failed: failed, failedElements: failedElements };
+      })()`);
+        return result;
+    }
+    /**
+     * モバイル読みやすさ評価
+     */
+    async checkReadability(page) {
+        const result = await page.evaluate(`(function() {
+        var minFontSize = ${READABILITY_MIN_FONT_SIZE};
+        var maxLineLength = ${READABILITY_MAX_LINE_LENGTH};
+        var minLineHeight = ${READABILITY_MIN_LINE_HEIGHT};
+
+        var textSelectors = 'p, li, td, th, span, div, article, section, main, blockquote';
+        var elements = document.querySelectorAll(textSelectors);
+
+        var fontSizes = [];
+        var lineLengths = [];
+        var lineHeights = [];
+        var sampleCount = 0;
+
+        for (var i = 0; i < elements.length; i++) {
+          var el = elements[i];
+          var style = window.getComputedStyle(el);
+
+          if (style.display === 'none' || style.visibility === 'hidden') {
+            continue;
+          }
+
+          var textContent = el.textContent || '';
+          var directText = '';
+          for (var j = 0; j < el.childNodes.length; j++) {
+            if (el.childNodes[j].nodeType === 3) {
+              directText += el.childNodes[j].textContent || '';
+            }
+          }
+          directText = directText.trim();
+
+          if (directText.length < 10) {
+            continue;
+          }
+
+          sampleCount++;
+
+          var fontSize = parseFloat(style.fontSize) || 16;
+          fontSizes.push(fontSize);
+
+          var lineHeightValue = style.lineHeight;
+          var lh = lineHeightValue === 'normal' ? 1.2 : parseFloat(lineHeightValue) / fontSize;
+          lineHeights.push(lh);
+
+          var rect = el.getBoundingClientRect();
+          if (rect.width > 0 && fontSize > 0) {
+            var charsPerLine = Math.floor(rect.width / (fontSize * 0.6));
+            lineLengths.push(charsPerLine);
+          }
+        }
+
+        if (sampleCount === 0) {
+          return {
+            fontSizeOk: true,
+            lineLengthOk: true,
+            lineHeightOk: true,
+            details: { minFontSize: 16, avgLineLength: 0, avgLineHeight: 1.5, sampleCount: 0 },
+          };
+        }
+
+        var minFS = Math.min.apply(null, fontSizes);
+        var avgLL = lineLengths.length > 0
+          ? lineLengths.reduce(function(a, b) { return a + b; }, 0) / lineLengths.length
+          : 0;
+        var avgLH = lineHeights.reduce(function(a, b) { return a + b; }, 0) / lineHeights.length;
+
+        return {
+          fontSizeOk: minFS >= minFontSize,
+          lineLengthOk: avgLL <= maxLineLength || avgLL === 0,
+          lineHeightOk: avgLH >= minLineHeight,
+          details: {
+            minFontSize: Math.round(minFS * 10) / 10,
+            avgLineLength: Math.round(avgLL * 10) / 10,
+            avgLineHeight: Math.round(avgLH * 100) / 100,
+            sampleCount: sampleCount,
+          },
+        };
+      })()`);
+        return result;
+    }
+    /**
+     * コンテンツオーバーフロー検出
+     */
+    async checkOverflow(page) {
+        const result = await page.evaluate(`(function() {
+        var horizontalScroll = document.documentElement.scrollWidth > document.documentElement.clientWidth;
+        var overflowElements = [];
+
+        var allElements = document.querySelectorAll('*');
+        for (var i = 0; i < allElements.length; i++) {
+          var el = allElements[i];
+          if (el.scrollWidth > el.clientWidth + 1) {
+            var style = window.getComputedStyle(el);
+            var overflowX = style.overflowX;
+            if (overflowX !== 'hidden' && overflowX !== 'clip') {
+              if (overflowElements.length < 10) {
+                var tag = el.tagName.toLowerCase();
+                var id = el.id ? '#' + el.id : '';
+                var cls = el.className && typeof el.className === 'string'
+                  ? '.' + el.className.trim().split(/\\s+/).slice(0, 2).join('.')
+                  : '';
+                overflowElements.push(tag + id + cls);
+              }
+            }
+          }
+        }
+
+        return {
+          horizontalScroll: horizontalScroll,
+          overflowElements: overflowElements,
+        };
+      })()`);
+        return result;
+    }
+    /**
+     * レスポンシブ画像チェック
+     */
+    async checkResponsiveImages(page) {
+        const result = await page.evaluate(`(function() {
+        var images = document.querySelectorAll('img');
+        var pictureElements = document.querySelectorAll('picture');
+        var srcsetCount = 0;
+        var missingResponsive = 0;
+
+        var pictureImgs = new Set();
+        for (var j = 0; j < pictureElements.length; j++) {
+          var imgs = pictureElements[j].querySelectorAll('img');
+          for (var k = 0; k < imgs.length; k++) {
+            pictureImgs.add(imgs[k]);
+          }
+        }
+
+        for (var i = 0; i < images.length; i++) {
+          var img = images[i];
+          var style = window.getComputedStyle(img);
+          if (style.display === 'none') {
+            continue;
+          }
+
+          var hasSrcset = img.hasAttribute('srcset') && img.getAttribute('srcset') !== '';
+          var inPicture = pictureImgs.has(img);
+
+          if (hasSrcset) {
+            srcsetCount++;
+          } else if (!inPicture) {
+            var rect = img.getBoundingClientRect();
+            if (rect.width > 50 && rect.height > 50) {
+              missingResponsive++;
+            }
+          }
+        }
+
+        return {
+          srcsetCount: srcsetCount,
+          pictureCount: pictureElements.length,
+          missingResponsive: missingResponsive,
+        };
+      })()`);
+        return result;
+    }
+    /**
+     * 総合スコア算出 (0-100)
+     *
+     * 配点:
+     * - タッチターゲット: 30点（failed率で減点）
+     * - 読みやすさ: 30点（3項目 x 10点）
+     * - オーバーフロー: 20点（水平スクロールで0点）
+     * - 画像: 20点（レスポンシブ対応率）
+     */
+    calculateOverallScore(results) {
+        if (results.length === 0)
+            return 0;
+        let totalScore = 0;
+        for (const result of results) {
+            let viewportScore = 0;
+            // タッチターゲット (30点)
+            const totalTargets = result.touchTargets.passed + result.touchTargets.failed;
+            if (totalTargets > 0) {
+                viewportScore += 30 * (result.touchTargets.passed / totalTargets);
+            }
+            else {
+                viewportScore += 30;
+            }
+            // 読みやすさ (30点: 3項目 x 10点)
+            if (result.readability.fontSizeOk)
+                viewportScore += 10;
+            if (result.readability.lineLengthOk)
+                viewportScore += 10;
+            if (result.readability.lineHeightOk)
+                viewportScore += 10;
+            // オーバーフロー (20点)
+            if (!result.overflow.horizontalScroll && result.overflow.overflowElements.length === 0) {
+                viewportScore += 20;
+            }
+            else if (!result.overflow.horizontalScroll) {
+                viewportScore += 10;
+            }
+            // 画像 (20点)
+            const totalImages = result.images.srcsetCount + result.images.missingResponsive;
+            if (totalImages > 0) {
+                const responsiveRatio = (result.images.srcsetCount + result.images.pictureCount) / totalImages;
+                viewportScore += 20 * Math.min(responsiveRatio, 1);
+            }
+            else {
+                viewportScore += 20;
+            }
+            totalScore += viewportScore;
+        }
+        return Math.round(totalScore / results.length);
+    }
+    /**
+     * デフォルトのタッチターゲット結果
+     */
+    defaultTouchTargetResult() {
+        return { passed: 0, failed: 0, failedElements: [] };
+    }
+    /**
+     * デフォルトの読みやすさ結果
+     */
+    defaultReadabilityResult() {
+        return {
+            fontSizeOk: true,
+            lineLengthOk: true,
+            lineHeightOk: true,
+            details: { minFontSize: 16, avgLineLength: 0, avgLineHeight: 1.5, sampleCount: 0 },
+        };
+    }
+    /**
+     * デフォルトのオーバーフロー結果
+     */
+    defaultOverflowResult() {
+        return { horizontalScroll: false, overflowElements: [] };
+    }
+    /**
+     * デフォルトの画像結果
+     */
+    defaultImageResult() {
+        return { srcsetCount: 0, pictureCount: 0, missingResponsive: 0 };
+    }
+    /**
+     * エラー時のデフォルト結果
+     */
+    createDefaultResult(viewport) {
+        return {
+            viewport,
+            touchTargets: this.defaultTouchTargetResult(),
+            readability: this.defaultReadabilityResult(),
+            overflow: this.defaultOverflowResult(),
+            images: this.defaultImageResult(),
+        };
+    }
+    /**
+     * ブラウザを終了
+     * 共有ブラウザの場合はブラウザを閉じない（所有者が管理）
+     */
+    async close() {
+        await this.browserManager.close();
+    }
+}
+exports.ResponsiveQualityEvaluatorService = ResponsiveQualityEvaluatorService;
+// シングルトンインスタンス
+exports.responsiveQualityEvaluatorService = new ResponsiveQualityEvaluatorService();
+//# sourceMappingURL=responsive-quality-evaluator.service.js.map

package/dist/services/responsive/responsive-quality-evaluator.service.js.map

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

package/dist/services/responsive/shared-browser-manager.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Shared Browser Manager
+ * ブラウザライフサイクル管理の共通ユーティリティ
+ *
+ * レスポンシブ解析サービス間で重複していたブラウザ起動/終了/共有ブラウザ選択ロジックを集約。
+ * MultiViewportCaptureService, ResponsiveQualityEvaluatorService 等が利用する。
+ *
+ * @module services/responsive/shared-browser-manager
+ */
+import { type Browser } from "playwright";
+/**
+ * ユーザーエージェント定数
+ * モバイル/デスクトップのUA文字列を定義
+ * 末尾に ReftrixBot 識別子を付与し、robots.txt 確認時の UA と整合させる
+ */
+export declare const USER_AGENTS: {
+    readonly MOBILE: `Mozilla/5.0 (iPhone; CPU iPhone OS 16_0 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/16.0 Mobile/15E148 Safari/604.1 ${string}`;
+    readonly DESKTOP: `Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36 ${string}`;
+};
+/**
+ * Shared Browser Manager
+ * Playwright ブラウザインスタンスのライフサイクル管理を提供する。
+ *
+ * - シングルトンパターンでブラウザインスタンスを保持
+ * - Worker pipeline からの共有ブラウザ（sharedBrowser）対応
+ * - 共有ブラウザ使用時は close() でブラウザを閉じない（所有者が管理）
+ */
+export declare class SharedBrowserManager {
+    private browser;
+    private usingSharedBrowser;
+    private readonly serviceName;
+    constructor(serviceName: string);
+    /**
+     * 共有ブラウザを使用中かどうか
+     */
+    get isUsingSharedBrowser(): boolean;
+    /**
+     * ブラウザを取得（シングルトン）
+     * ブラウザが未起動の場合は chromium.launch() で起動する。
+     */
+    getBrowser(): Promise<Browser>;
+    /**
+     * 共有ブラウザまたは自前ブラウザを解決する
+     *
+     * sharedBrowser が指定されていればそれを使用し、
+     * 未指定の場合は getBrowser() で自前起動する。
+     *
+     * @param sharedBrowser - 外部から提供される共有ブラウザインスタンス（Worker pipeline用）
+     * @returns 使用するブラウザインスタンス
+     */
+    resolveOrLaunch(sharedBrowser?: Browser): Promise<Browser>;
+    /**
+     * ブラウザを終了
+     * 共有ブラウザの場合はブラウザを閉じない（所有者が管理）
+     */
+    close(): Promise<void>;
+    /**
+     * viewport name に応じたUserAgent文字列を返す
+     *
+     * @param viewportName - ビューポート名 ('mobile' | 'desktop' | 'tablet' 等)
+     * @returns UserAgent文字列
+     */
+    static getUserAgent(viewportName: string): string;
+}
+//# sourceMappingURL=shared-browser-manager.d.ts.map

package/dist/services/responsive/shared-browser-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-browser-manager.d.ts","sourceRoot":"","sources":["../../../src/services/responsive/shared-browser-manager.ts"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AAEH,OAAO,EAAY,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AAWpD;;;;GAIG;AACH,eAAO,MAAM,WAAW;;;CAGd,CAAC;AAEX;;;;;;;GAOG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;gBAEzB,WAAW,EAAE,MAAM;IAI/B;;OAEG;IACH,IAAI,oBAAoB,IAAI,OAAO,CAElC;IAED;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC;IAapC;;;;;;;;OAQG;IACG,eAAe,CAAC,aAAa,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAUhE;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAU5B;;;;;OAKG;IACH,MAAM,CAAC,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM;CAGlD"}

package/dist/services/responsive/shared-browser-manager.js

@@ -0,0 +1,112 @@
+"use strict";
+// SPDX-FileCopyrightText: 2026 TKMD and Reftrix Contributors
+// SPDX-License-Identifier: AGPL-3.0-only
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SharedBrowserManager = exports.USER_AGENTS = void 0;
+/**
+ * Shared Browser Manager
+ * ブラウザライフサイクル管理の共通ユーティリティ
+ *
+ * レスポンシブ解析サービス間で重複していたブラウザ起動/終了/共有ブラウザ選択ロジックを集約。
+ * MultiViewportCaptureService, ResponsiveQualityEvaluatorService 等が利用する。
+ *
+ * @module services/responsive/shared-browser-manager
+ */
+const playwright_1 = require("playwright");
+const core_1 = require("@reftrixmcp/core");
+const logger_1 = require("../../utils/logger");
+/**
+ * ReftrixBot 識別子
+ * robots.txt 確認時と同一の識別子を Playwright UA に付与し、法的整合性を保つ。
+ * constants.ts の PRODUCT_TOKEN と同期。
+ */
+const BOT_SUFFIX = `${core_1.ROBOTS_TXT.PRODUCT_TOKEN}/1.0 (+https://reftrix.dev/bot)`;
+/**
+ * ユーザーエージェント定数
+ * モバイル/デスクトップのUA文字列を定義
+ * 末尾に ReftrixBot 識別子を付与し、robots.txt 確認時の UA と整合させる
+ */
+exports.USER_AGENTS = {
+    MOBILE: `Mozilla/5.0 (iPhone; CPU iPhone OS 16_0 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/16.0 Mobile/15E148 Safari/604.1 ${BOT_SUFFIX}`,
+    DESKTOP: `Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36 ${BOT_SUFFIX}`,
+};
+/**
+ * Shared Browser Manager
+ * Playwright ブラウザインスタンスのライフサイクル管理を提供する。
+ *
+ * - シングルトンパターンでブラウザインスタンスを保持
+ * - Worker pipeline からの共有ブラウザ（sharedBrowser）対応
+ * - 共有ブラウザ使用時は close() でブラウザを閉じない（所有者が管理）
+ */
+class SharedBrowserManager {
+    browser = null;
+    usingSharedBrowser = false;
+    serviceName;
+    constructor(serviceName) {
+        this.serviceName = serviceName;
+    }
+    /**
+     * 共有ブラウザを使用中かどうか
+     */
+    get isUsingSharedBrowser() {
+        return this.usingSharedBrowser;
+    }
+    /**
+     * ブラウザを取得（シングルトン）
+     * ブラウザが未起動の場合は chromium.launch() で起動する。
+     */
+    async getBrowser() {
+        if (!this.browser) {
+            this.browser = await playwright_1.chromium.launch({
+                headless: true,
+                args: ["--no-sandbox", "--disable-setuid-sandbox"],
+            });
+            if ((0, logger_1.isDevelopment)()) {
+                logger_1.logger.debug(`[${this.serviceName}] Browser launched`);
+            }
+        }
+        return this.browser;
+    }
+    /**
+     * 共有ブラウザまたは自前ブラウザを解決する
+     *
+     * sharedBrowser が指定されていればそれを使用し、
+     * 未指定の場合は getBrowser() で自前起動する。
+     *
+     * @param sharedBrowser - 外部から提供される共有ブラウザインスタンス（Worker pipeline用）
+     * @returns 使用するブラウザインスタンス
+     */
+    async resolveOrLaunch(sharedBrowser) {
+        if (sharedBrowser) {
+            this.browser = sharedBrowser;
+            this.usingSharedBrowser = true;
+            return sharedBrowser;
+        }
+        this.usingSharedBrowser = false;
+        return this.getBrowser();
+    }
+    /**
+     * ブラウザを終了
+     * 共有ブラウザの場合はブラウザを閉じない（所有者が管理）
+     */
+    async close() {
+        if (this.browser && !this.usingSharedBrowser) {
+            await this.browser.close();
+            this.browser = null;
+            if ((0, logger_1.isDevelopment)()) {
+                logger_1.logger.debug(`[${this.serviceName}] Browser closed`);
+            }
+        }
+    }
+    /**
+     * viewport name に応じたUserAgent文字列を返す
+     *
+     * @param viewportName - ビューポート名 ('mobile' | 'desktop' | 'tablet' 等)
+     * @returns UserAgent文字列
+     */
+    static getUserAgent(viewportName) {
+        return viewportName === "mobile" ? exports.USER_AGENTS.MOBILE : exports.USER_AGENTS.DESKTOP;
+    }
+}
+exports.SharedBrowserManager = SharedBrowserManager;
+//# sourceMappingURL=shared-browser-manager.js.map

package/dist/services/responsive/shared-browser-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-browser-manager.js","sourceRoot":"","sources":["../../../src/services/responsive/shared-browser-manager.ts"],"names":[],"mappings":";AAAA,6DAA6D;AAC7D,yCAAyC;;;AAEzC;;;;;;;;GAQG;AAEH,2CAAoD;AACpD,2CAA8C;AAC9C,+CAA2D;AAE3D;;;;GAIG;AACH,MAAM,UAAU,GAAG,GAAG,iBAAU,CAAC,aAAa,iCAAiC,CAAC;AAEhF;;;;GAIG;AACU,QAAA,WAAW,GAAG;IACzB,MAAM,EAAE,2IAA2I,UAAU,EAAE;IAC/J,OAAO,EAAE,mHAAmH,UAAU,EAAE;CAChI,CAAC;AAEX;;;;;;;GAOG;AACH,MAAa,oBAAoB;IACvB,OAAO,GAAmB,IAAI,CAAC;IAC/B,kBAAkB,GAAG,KAAK,CAAC;IAClB,WAAW,CAAS;IAErC,YAAY,WAAmB;QAC7B,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,IAAI,oBAAoB;QACtB,OAAO,IAAI,CAAC,kBAAkB,CAAC;IACjC,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,UAAU;QACd,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,IAAI,CAAC,OAAO,GAAG,MAAM,qBAAQ,CAAC,MAAM,CAAC;gBACnC,QAAQ,EAAE,IAAI;gBACd,IAAI,EAAE,CAAC,cAAc,EAAE,0BAA0B,CAAC;aACnD,CAAC,CAAC;YACH,IAAI,IAAA,sBAAa,GAAE,EAAE,CAAC;gBACpB,eAAM,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,WAAW,oBAAoB,CAAC,CAAC;YACzD,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,eAAe,CAAC,aAAuB;QAC3C,IAAI,aAAa,EAAE,CAAC;YAClB,IAAI,CAAC,OAAO,GAAG,aAAa,CAAC;YAC7B,IAAI,CAAC,kBAAkB,GAAG,IAAI,CAAC;YAC/B,OAAO,aAAa,CAAC;QACvB,CAAC;QACD,IAAI,CAAC,kBAAkB,GAAG,KAAK,CAAC;QAChC,OAAO,IAAI,CAAC,UAAU,EAAE,CAAC;IAC3B,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE,CAAC;YAC7C,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YAC3B,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;YACpB,IAAI,IAAA,sBAAa,GAAE,EAAE,CAAC;gBACpB,eAAM,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,WAAW,kBAAkB,CAAC,CAAC;YACvD,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,YAAY,CAAC,YAAoB;QACtC,OAAO,YAAY,KAAK,QAAQ,CAAC,CAAC,CAAC,mBAAW,CAAC,MAAM,CAAC,CAAC,CAAC,mBAAW,CAAC,OAAO,CAAC;IAC9E,CAAC;CACF;AA3ED,oDA2EC"}