@d-zero/archaeologist 3.1.1 → 3.2.0

package/README.md

@@ -5,9 +5,10 @@
 ウェブサイトの本番環境と開発環境や、新旧のページの比較するためのツールです。
 
 - Puppeteerを実行してページのスクリーンショットを撮影します
-- スクリーンショットはデスクトップとモバイルの2つのサイズでそれぞれ撮影します
+- 複数のデバイスサイズでスクリーンショットを撮影可能（7種類のプリセット + カスタム設定）
 - スクリーンショットは画像差分（ビジュアルリグレッション）を検出・出力します
 - HTMLの差分も検出します
+- レスポンシブデザインの差分検証に最適
 
 ## CLI
 
@@ -23,12 +24,35 @@ URLリストを持つファイルを指定して実行します。
 - `-t, --type <types>`: 比較タイプの指定（`image,dom,text`、カンマ区切り）
 - `-s, --selector <selector>`: 比較対象を限定するCSSセレクター
 - `-i, --ignore <selector>`: 無視するCSSセレクター
-- `--devices <devices>`: デバイス指定（`desktop,mobile,tablet`、カンマ区切り）
+- `-d, --devices <devices>`: デバイスプリセット（カンマ区切り、デフォルト: desktop-compact,mobile）
 - `--freeze <filepath>`: フリーズモード用ファイルパス
 - `--limit <number>`: 並列実行数の上限（デフォルト: 10）
 - `--debug`: デバッグモード（デフォルト: false）
 - `--verbose`: 詳細ログモード（デフォルト: false）
 
+### 利用可能なデバイスプリセット
+
+- `desktop`: 1400px幅
+- `tablet`: 768px幅
+- `mobile`: 375px幅（2倍解像度）
+- `desktop-hd`: 1920px幅
+- `desktop-compact`: 1280px幅
+- `mobile-large`: 414px幅（3倍解像度）
+- `mobile-small`: 320px幅（2倍解像度）
+
+### 使用例
+
+```sh
+# デフォルトデバイス（desktop-compact, mobile）
+npx @d-zero/archaeologist -f urls.txt
+
+# カスタムデバイス指定
+npx @d-zero/archaeologist -f urls.txt --devices desktop,tablet,mobile
+
+# フリーズモード（参照用スクリーンショット作成）
+npx @d-zero/archaeologist --freeze urls.txt
+```
+
 ### ファイルフォーマット
 
 ファイルの先頭には比較対象のホストを指定します。[Frontmatter](https://jekyllrb.com/docs/front-matter/)形式で`comparisonHost`に指定します。

package/dist/cli.js

@@ -9,8 +9,30 @@ const { options, hasConfigFile } = createCLI({
         t: 'type',
         s: 'selector',
         i: 'ignore',
+        d: 'devices',
     },
-    usage: ['Usage: archaeologist -f <listfile> [--limit <number>]'],
+    usage: [
+        'Usage: archaeologist -f <listfile> [options]',
+        '',
+        'Options:',
+        '\t-f, --listfile <file>     File containing URL pairs to analyze',
+        '\t-t, --type <types>        Analysis types (comma-separated): image,dom,text',
+        '\t-d, --devices <devices>   Device presets (comma-separated, default: desktop-compact,mobile)',
+        '\t-s, --selector <selector> CSS selector for specific elements',
+        '\t-i, --ignore <ignore>     CSS selector for elements to ignore',
+        '\t--freeze <file>           Freeze mode: capture reference screenshots',
+        '\t--limit <number>          Limit concurrent processes',
+        '\t--debug                   Enable debug mode',
+        '\t--verbose                 Enable verbose logging',
+        '',
+        'Available device presets:',
+        '\tdesktop, tablet, mobile, desktop-hd, desktop-compact, mobile-large, mobile-small',
+        '',
+        'Examples:',
+        '\tarchaeologist -f urls.txt',
+        '\tarchaeologist -f urls.txt --devices desktop,mobile',
+        '\tarchaeologist --freeze urls.txt',
+    ],
     parseArgs: (cli) => ({
         ...parseCommonOptions(cli),
         listfile: cli.listfile,

package/dist/modules/get-data.js

@@ -1,5 +1,5 @@
 import { distill } from '@d-zero/html-distiller';
-import { defaultSizes } from '@d-zero/puppeteer-page-scan';
+import { createSizesFromDevices } from '@d-zero/puppeteer-page-scan';
 import { screenshotListener, screenshot } from '@d-zero/puppeteer-screenshot';
 /**
  *
@@ -10,12 +10,8 @@ import { screenshotListener, screenshot } from '@d-zero/puppeteer-screenshot';
  */
 export async function getData(page, url, options, update) {
     const htmlDiffOnly = options.htmlDiffOnly ?? false;
-    const devices = options.devices ?? ['desktop', 'mobile'];
-    const sizes = {};
-    for (const device of devices) {
-        // @ts-ignore
-        sizes[device] = defaultSizes[device];
-    }
+    const devices = options.devices ?? ['desktop-compact', 'mobile'];
+    const sizes = createSizesFromDevices([...devices]);
     const screenshots = await screenshot(page, url, {
         sizes,
         hooks: options?.hooks ?? [],

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@d-zero/archaeologist",
-	"version": "3.1.1",
+	"version": "3.2.0",
 	"description": "Uncover visual and HTML differences in web pages with precision",
 	"author": "D-ZERO",
 	"license": "MIT",
@@ -27,9 +27,9 @@
 		"@d-zero/cli-core": "1.1.1",
 		"@d-zero/fs": "0.2.1",
 		"@d-zero/html-distiller": "2.0.1",
-		"@d-zero/puppeteer-dealer": "0.5.3",
-		"@d-zero/puppeteer-page-scan": "4.0.4",
-		"@d-zero/puppeteer-screenshot": "3.1.3",
+		"@d-zero/puppeteer-dealer": "0.5.4",
+		"@d-zero/puppeteer-page-scan": "4.1.0",
+		"@d-zero/puppeteer-screenshot": "3.1.4",
 		"@d-zero/readtext": "1.1.8",
 		"@d-zero/shared": "0.9.2",
 		"ansi-colors": "4.1.3",
@@ -41,7 +41,7 @@
 		"parse-diff": "0.11.1",
 		"pixelmatch": "7.1.0",
 		"pngjs": "7.0.0",
-		"puppeteer": "24.17.1",
+		"puppeteer": "24.18.0",
 		"strip-ansi": "7.1.0"
 	},
 	"devDependencies": {
@@ -49,5 +49,5 @@
 		"@types/pixelmatch": "5.2.6",
 		"@types/pngjs": "6.0.5"
 	},
-	"gitHead": "6fa0fd190c54351762a70039cd8dfcafc51caa0b"
+	"gitHead": "8081edac801400fed7c0b7ebeccc0ce66ccfe131"
 }