@d-zero/replicator 0.10.2 → 0.10.4

package/README.md

@@ -1,152 +1,45 @@
 # `@d-zero/replicator`
 
-ウェブページとそのリソースをレスポンシブ画像対応でローカルディレクトリに複製するツールです。複数のURLを並列処理し、効率的にリソースを取得します。
+ウェブページとそのリソース（CSS / JS / 画像）をレスポンシブ画像対応でローカルディレクトリに複製する CLI。Phase 1（ページスキャン）と Phase 2（リソースダウンロード）の **2 段階処理** で並列度を独立制御する。**同一ホストのみサポート**（複数ホスト検出時はエラー）。
 
-## インストール
+## Installation
 
-```bash
-npm install @d-zero/replicator
+```sh
+yarn add @d-zero/replicator
 ```
 
-## 使い方
+## Usage
 
-### CLI
-
-```bash
+```sh
 npx @d-zero/replicator <url...> -o <output-directory> [options]
 ```
 
-#### オプション
-
-- `--version`: バージョンを表示（注: `-v`は`--verbose`のエイリアス）
-- `-o, --output <dir>`: 出力ディレクトリ（必須）
-- `-t, --timeout <ms>`: リクエストタイムアウト（ミリ秒、デフォルト: 30000）
-- `-d, --devices <devices>`: デバイスプリセット（カンマ区切り、デフォルト: desktop-compact,mobile）
-- `-l, --limit <number>`: ページスキャン（Phase 1）の並列処理数の上限（デフォルト: 3）
-- `--download-limit <number>`: リソースダウンロード（Phase 2）の並列処理数の上限（デフォルト: 10）
-- `--interval <ms>`: 並列実行間の間隔（デフォルト: なし）
-  - 数値または"min-max"形式でランダム範囲を指定可能
-- `--only <type>`: ダウンロード対象を限定（`page` または `resource`）
-- `-a, --auth <user:pass>`: Basic認証の認証情報（`ユーザー名:パスワード` 形式）
-- `-v, --verbose`: 詳細ログモード
-
-##### `--only` オプション
-
-- `page`: HTMLページのみをダウンロード（リソーススキャンをスキップして高速化）
-- `resource`: リソース（CSS、JS、画像など）のみをダウンロード（HTMLページを除外）
-- 未指定: すべてのファイルをダウンロード（デフォルト動作）
-
-#### 利用可能なデバイスプリセット
-
-- `desktop`: 1400px幅
-- `tablet`: 768px幅
-- `mobile`: 375px幅（2倍解像度）
-- `desktop-hd`: 1920px幅
-- `desktop-compact`: 1280px幅
-- `mobile-large`: 414px幅（3倍解像度）
-- `mobile-small`: 320px幅（2倍解像度）
-
-#### 使用例
-
-```bash
-# 単一URL（デフォルトデバイス: desktop-compact, mobile）
-npx @d-zero/replicator https://example.com -o ./output
-
-# 複数URLを並列処理
-npx @d-zero/replicator https://example.com/page1 https://example.com/page2 -o ./output
-
-# 並列数を制限
-npx @d-zero/replicator https://example.com/page1 https://example.com/page2 -o ./output --limit 2
+オプションは `--help`、デバイスプリセットは `src/devices.ts` を参照。
 
-# カスタムデバイス指定
-npx @d-zero/replicator https://example.com -o ./output --devices desktop,tablet,mobile
+### 主なオプション
 
-# タイムアウト指定
-npx @d-zero/replicator https://example.com -o ./output --timeout 60000
+- `--limit <n>` … Phase 1（ページスキャン）の並列数（デフォルト 3）
+- `--download-limit <n>` … Phase 2（リソースダウンロード）の並列数（デフォルト 10）
+- `--only page|resource` … HTML のみ／リソースのみに限定
+- `-a, --auth user:pass` … Basic 認証
 
-# HTMLページのみダウンロード（高速）
-npx @d-zero/replicator https://example.com -o ./output --only page
+### `--only` の使い分け
 
-# リソースのみダウンロード（HTMLを除外）
-npx @d-zero/replicator https://example.com -o ./output --only resource
+- `page` … リソーススキャンをスキップして HTML のみ高速取得
+- `resource` … HTML を除外し、CSS/JS/画像のみ
+- 未指定 … 全部
 
-# Basic認証が必要なページ
-npx @d-zero/replicator https://example.com -o ./output -a username:password
-```
+Phase 分離・並列数の WHY・同一ホスト制約の理由・レスポンシブ画像取得時のマルチデバイスシミュレーションは `src/replicate.ts` の JSDoc を参照。
 
-### プログラマティック使用
+### プログラマティック利用
 
-```typescript
+```ts
 import { replicate } from '@d-zero/replicator';
 
-// 単一URL
-await replicate({
-	urls: ['https://example.com'],
-	outputDir: './output',
-});
-
-// 複数URLを並列処理
-await replicate({
-	urls: [
-		'https://example.com/page1',
-		'https://example.com/page2',
-		'https://example.com/page3',
-	],
-	outputDir: './output',
-	limit: 2, // ページスキャン（Phase 1）は最大2並列
-	downloadLimit: 5, // リソースダウンロード（Phase 2）は最大5並列
-});
-
-// カスタムデバイス
 await replicate({
 	urls: ['https://example.com'],
 	outputDir: './output',
-	devices: {
-		desktop: { width: 1400 },
-		mobile: { width: 375, resolution: 2 },
-	},
-	timeout: 30000,
-	verbose: true,
-});
-
-// HTMLページのみダウンロード
-await replicate({
-	urls: ['https://example.com'],
-	outputDir: './output',
-	only: 'page',
-});
-
-// リソースのみダウンロード
-await replicate({
-	urls: ['https://example.com'],
-	outputDir: './output',
-	only: 'resource',
-});
-
-// Basic認証が必要なページ
-await replicate({
-	urls: ['https://example.com'],
-	outputDir: './output',
-	username: 'username',
-	password: 'password',
+	limit: 2,
+	downloadLimit: 5,
 });
 ```
-
-## 機能
-
-- **Basic認証対応**: `--auth user:pass`オプションでBasic認証が必要なページにアクセス可能
-- **並列処理**: 複数のURLを並列で効率的に処理
-- **メモリ効率**: リソースを直接ディスクに保存してメモリ使用量を最小化
-- **選択的ダウンロード**: `--only`オプションでHTMLページのみまたはリソースのみをダウンロード可能
-- **レスポンシブ画像対応**: 複数のデバイス幅で`<picture>`要素やメディアクエリのリソースを取得
-- **遅延読み込み対応**: ページを自動スクロールして`loading=lazy`や`IntersectionObserver`ベースのコンテンツを取得
-- **マルチデバイスシミュレーション**: 様々なデバイス幅と解像度をシミュレートして包括的なリソース取得を実現
-- HTMLページのディレクトリ構造を保持してダウンロード
-- 関連するすべてのリソース（CSS、JS、画像など）を取得
-- リソース間の相対リンクを維持
-- 同一ホストのリソースのみサポート（複数ホストが検出された場合はエラー）
-- 元のファイル拡張子とパスを保持
-
-## License
-
-MIT

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@d-zero/replicator",
-	"version": "0.10.2",
+	"version": "0.10.4",
 	"description": "Replicate web pages with all their resources to local directories",
 	"author": "D-ZERO",
 	"license": "MIT",
@@ -24,11 +24,11 @@
 		"clean": "tsc --build --clean"
 	},
 	"dependencies": {
-		"@d-zero/cli-core": "1.3.9",
-		"@d-zero/dealer": "1.8.0",
-		"@d-zero/puppeteer-dealer": "0.7.12",
-		"@d-zero/puppeteer-page-scan": "4.5.0",
-		"@d-zero/puppeteer-scroll": "4.0.0",
+		"@d-zero/cli-core": "1.3.10",
+		"@d-zero/dealer": "1.9.1",
+		"@d-zero/puppeteer-dealer": "0.7.14",
+		"@d-zero/puppeteer-page-scan": "4.5.1",
+		"@d-zero/puppeteer-scroll": "4.0.1",
 		"@d-zero/shared": "0.22.0",
 		"ansi-colors": "4.1.3",
 		"minimist": "1.2.8",
@@ -42,5 +42,5 @@
 		"url": "https://github.com/d-zero-dev/tools.git",
 		"directory": "packages/@d-zero/replicator"
 	},
-	"gitHead": "18fedbea276b214ad98d1f7e41e07b629e65439c"
+	"gitHead": "25b4043dcd70cf3490ddcefd76a88b22c60f7712"
 }