manhuagui-cli 1.0.1 → 1.0.2

package/README.md

@@ -1,28 +1,72 @@
 # manhuagui-cli
 
-> 漫画柜 (manhuagui.com) 漫画下载命令行工具
+<p align="center">
+  <a href="https://www.npmjs.com/package/manhuagui-cli"><img src="https://img.shields.io/npm/v/manhuagui-cli" alt="npm version"></a>
+  <a href="https://nodejs.org/"><img src="https://img.shields.io/badge/node-%3E%3D22-brightgreen" alt="Node.js >= 22"></a>
+  <a href="./LICENSE"><img src="https://img.shields.io/npm/l/manhuagui-cli" alt="License: MIT"></a>
+</p>
+
+<p align="center">漫画柜 (manhuagui.com) 漫画下载命令行工具</p>
+
+---
+
+## 目录
+
+- [快速开始](#快速开始)
+- [功能特性](#功能特性)
+- [安装](#安装)
+- [使用方法](#使用方法)
+  - [交互模式](#交互模式)
+  - [命令行模式](#命令行模式)
+  - [选项](#选项)
+- [配置](#配置)
+  - [优先级](#优先级)
+  - [配置文件](#配置文件)
+  - [环境变量](#环境变量)
+- [输出目录结构](#输出目录结构)
+- [开发](#开发)
+- [变更日志](#变更日志)
+- [许可协议](#许可协议)
+- [免责声明](#免责声明)
+
+## 快速开始
 
-[English](README_EN.md)
+```bash
+# 全局安装
+npm install -g manhuagui-cli
 
-## 功能特性
+# 下载漫画，按提示操作
+manhuagui-cli
+
+# 或者在命令行直接指定 URL
+manhuagui-cli <URL>
+
+# 指定章节组
+manhuagui-cli <URL> -s "单行本"
+
+# 预览模式，仅列出章节不下载
+manhuagui-cli <URL> --dry-run
 
-- 交互式命令行界面，也支持命令行参数直接运行
-- 自动解析漫画页面，列出所有章节与卷
-- 使用 Playwright 模拟浏览器请求，绕过反爬检测
-- 随机 User-Agent 和视口大小，模拟真实用户行为
-- CDN 节点自动轮换，图片下载失败时自动重试（最多 3 次）
-- 章节内图片并发下载，章节之间顺序处理并添加随机延迟
-- 断点续传：进度保存到 `progress.json`，中断后可通过 `--resume` / `-r` 继续
-- 下载目录结构清晰：`output/<漫画名>/<章节组>/<章节>/001.webp`
+# 断点续传
+manhuagui-cli <URL> --resume
+```
 
-## 系统要求
+## 功能特性
 
-- **Node.js** >= 22
-- **pnpm**（推荐）或 npm
+- **交互式界面**：无参数运行时进入交互提示模式，引导输入 URL、选择章节组
+- **命令行模式**：支持完整 CLI 参数，适合脚本化和自动化场景
+- **反爬虫绕过**：基于 Playwright 无头 Chromium 模拟浏览器请求，绕过反爬检测
+- **身份伪装**：随机切换 User-Agent 和视口大小，模拟真实用户行为
+- **CDN 容错**：图片下载时自动轮换 CDN 节点，失败自动重试（默认 3 次）
+- **并发控制**：章节内图片并发下载，章节间顺序处理并加入随机延迟
+- **实时进度显示**：终端进度条，展示下载速度、章节进度、整体进度及预计剩余时间
+- **预览模式** (`--dry-run`)：列出待下载章节而不实际下载，适合制定下载计划
+- **断点续传**：进度自动保存至 `progress.json`，中断后通过 `--resume` / `-r` 继续
+- **清晰目录结构**：`output/<漫画名>/<章节组>/<章节>/001.webp`
 
 ## 安装
 
-### npm（推荐）
+### npm 全局安装（推荐）
 
 ```bash
 npm install -g manhuagui-cli
@@ -44,53 +88,81 @@ pnpm link --global
 
 ### 交互模式
 
+不带参数运行，工具会引导你完成每一步操作：
+
 ```bash
-pnpm dev
-# 或编译后：
-pnpm build
-node dist/index.js
+manhuagui-cli
 ```
 
-按提示输入漫画 URL，选择要下载的章节组，确认后开始下载。
+交互流程：
+
+1. 输入漫画 URL
+2. 工具自动解析漫画信息（标题、章节组、章节列表）
+3. 选择要下载的章节组（支持多选）
+4. 确认后开始下载
+
+```text
+  manhuagui-cli v1.0.1
+
+Input comic URL:
+  https://www.manhuagui.com/comic/12345/
+
+Parsing comic page...
+  某个漫画
+
+Which sections to download?
+  [x] 单行本 (12 chapters)
+  [ ] 单话 (200 chapters)
+  [x] 番外 (3 chapters)
+  Confirm
+
+ Overall  3/4 ch · 6/8 pg · 45s elapsed · ~15s
+ [====================>                   ]  50%
+ Ch.3  2/2 pg · 单行本 · 93.5 KB/s · ~15s
+```
 
 ### 命令行模式
 
 ```bash
-node dist/index.js <URL> [选项]
-# 或全局安装后：
-manhuagui-cli <URL> [选项]
-
 # 查看帮助
-node dist/index.js --help
+manhuagui-cli --help
 
-# 示例：下载指定章节组
-node dist/index.js https://www.manhuagui.com/comic/12345/ -s "单行本"
+# 下载指定章节组
+manhuagui-cli https://www.manhuagui.com/comic/12345/ -s "单行本"
 
-# 示例：下载指定章节
-node dist/index.js https://www.manhuagui.com/comic/12345/ -s "单话" -c "第01话"
+# 下载指定章节
+manhuagui-cli https://www.manhuagui.com/comic/12345/ -s "单话" -c "第01话"
 
-# 示例：断点续传
-node dist/index.js https://www.manhuagui.com/comic/12345/ --resume
+# 指定输出目录
+manhuagui-cli https://www.manhuagui.com/comic/12345/ -o ./my-comics
+
+# 断点续传
+manhuagui-cli https://www.manhuagui.com/comic/12345/ --resume
+
+# 预览模式
+manhuagui-cli https://www.manhuagui.com/comic/12345/ --dry-run
 ```
 
 ### 选项
 
-| 选项                  | 简写  | 说明                                          |
-| --------------------- | ----- | --------------------------------------------- |
-| `--section <name>`    | `-s`  | 指定要下载的章节组名称（默认：全部）          |
-| `--chapter <name>`    | `-c`  | 指定要下载的章节名称                          |
-| `--output <dir>`      | `-o`  | 下载输出目录                                  |
-| `--concurrency <n>`   | `-C`  | 章节内图片并发下载数                          |
-| `--retry <n>`         |       | 图片下载重试次数                              |
-| `--log-level <level>` |       | 日志级别：`debug` \| `info` \| `warn` \| `error` |
-| `--resume`            | `-r`  | 断点续传模式                                  |
-| `--dry-run`           | `-d`  | 预览模式（不实际下载）                        |
-| `--help`              | `-h`  | 显示帮助信息                                  |
-| `--version`           | `-v`  | 显示版本号                                    |
+| 选项                   | 简写  | 默认值  | 说明                                          |
+| ---------------------- | ----- | ------- | --------------------------------------------- |
+| `--section <name>`     | `-s`  | 全部    | 指定要下载的章节组名称                        |
+| `--chapter <name>`     | `-c`  | —       | 指定要下载的章节名称                          |
+| `--output <dir>`       | `-o`  | `./output` | 下载输出目录                              |
+| `--concurrency <n>`    | `-C`  | `2`     | 章节内图片并发下载数                          |
+| `--retry <n>`          |       | `3`     | 图片下载重试次数                              |
+| `--log-level <level>`  |       | `info`  | 日志级别：`debug` / `info` / `warn` / `error` |
+| `--resume`             | `-r`  | —       | 断点续传模式                                  |
+| `--dry-run`            | `-d`  | —       | 预览模式（不实际下载）                        |
+| `--help`               | `-h`  | —       | 显示帮助信息                                  |
+| `--version`            | `-v`  | —       | 显示版本号                                    |
 
 ## 配置
 
-所有配置项按以下优先级生效（高优先级覆盖低优先级）：
+除 CLI 参数外，还支持通过配置文件和环境变量调整行为。
+
+### 优先级
 
 ```
 CLI 参数 > 配置文件 > 环境变量 > 默认值
@@ -98,10 +170,13 @@ CLI 参数 > 配置文件 > 环境变量 > 默认值
 
 ### 配置文件
 
-支持两个位置的 JSON 配置文件，项目级覆盖全局级：
+支持两个位置的 JSON 配置文件，按需创建。项目级会覆盖全局级中相同的字段。
 
-- **项目级**: `<当前目录>/.manhuaguirc.json`
-- **全局**: `~/.config/manhuagui-cli/config.json`（Windows: `%USERPROFILE%\.config\manhuagui-cli\config.json`）
+| 位置       | 路径                                                                         |
+| ---------- | ---------------------------------------------------------------------------- |
+| 项目级     | `<当前目录>/.manhuaguirc.json`                                               |
+| 全局       | `~/.config/manhuagui-cli/config.json`                                        |
+| (Windows)  | `%USERPROFILE%\.config\manhuagui-cli\config.json`                            |
 
 ```json
 {
@@ -112,28 +187,28 @@ CLI 参数 > 配置文件 > 环境变量 > 默认值
 }
 ```
 
-全部可选，未指定的项使用默认值。
+所有字段均为可选，未指定的字段将沿用默认值。
 
 ### 环境变量
 
-复制 `.env.example` 为 `.env`，根据需要修改。也支持直接设置系统环境变量。
-
-| 变量                  | 默认值     | 说明                                     |
-| --------------------- | ---------- | ---------------------------------------- |
-| `OUTPUT_BASE`         | `./output` | 下载输出目录                             |
-| `IMAGE_CONCURRENCY`   | `2`        | 章节内图片并发下载数                     |
-| `DOWNLOAD_DELAY`      | `3000`     | 图片批次之间延迟（毫秒，0 禁用）         |
-| `CHAPTER_DELAY_MIN`   | `5000`     | 章节间最小延迟（毫秒）                   |
-| `CHAPTER_DELAY_MAX`   | `15000`    | 章节间最大延迟（毫秒）                   |
-| `RETRY_COUNT`         | `3`        | 图片下载重试次数                         |
-| `RETRY_BACKOFF_BASE`  | `1000`     | 重试退避基准毫秒（第 N 次重试等待 N×base） |
-| `IMAGE_LOAD_DELAY`    | `200`      | 翻页后等待图片加载时间（毫秒）           |
-| `LOG_LEVEL`           | `info`     | 日志级别：`debug` \| `info` \| `warn` \| `error` |
-| `USER_AGENTS`         | —          | 自定义 User-Agent 列表（每行一个）       |
+将 `.env.example` 复制为 `.env`，根据需要修改。也支持直接设置系统环境变量。
+
+| 变量                  | 默认值     | 说明                                         |
+| --------------------- | ---------- | -------------------------------------------- |
+| `OUTPUT_BASE`         | `./output` | 下载输出目录                                 |
+| `IMAGE_CONCURRENCY`   | `2`        | 章节内图片并发下载数                         |
+| `DOWNLOAD_DELAY`      | `3000`     | 图片批次间延迟（毫秒，设为 0 禁用）          |
+| `CHAPTER_DELAY_MIN`   | `3000`     | 章节间最小延迟（毫秒）                       |
+| `CHAPTER_DELAY_MAX`   | `6000`     | 章节间最大延迟（毫秒）                       |
+| `RETRY_COUNT`         | `3`        | 图片下载重试次数                             |
+| `RETRY_BACKOFF_BASE`  | `1000`     | 重试退避基值（毫秒），第 N 次重试等待 N * base |
+| `IMAGE_LOAD_DELAY`    | `200`      | 翻页后等待图片加载时间（毫秒）               |
+| `LOG_LEVEL`           | `info`     | 日志级别：`debug` / `info` / `warn` / `error` |
+| `USER_AGENTS`         | —          | 自定义 User-Agent 列表（每行一个）           |
 
 ## 输出目录结构
 
-```
+```text
 output/
 └── <漫画名>/
     ├── urls.json          # 章节图片 URL 清单
@@ -148,18 +223,22 @@ output/
 ## 开发
 
 ```bash
-pnpm install           # 安装依赖
-pnpm dev               # 开发模式运行（直接运行 TypeScript）
-pnpm build             # 编译 TypeScript
-pnpm typecheck         # 类型检查
-pnpm test              # 运行测试
-pnpm check             # 代码检查和格式化检查
-pnpm format            # 自动格式化
+pnpm install      # 安装依赖
+pnpm dev          # 开发模式运行（直接运行 TypeScript）
+pnpm build        # 编译 TypeScript
+pnpm typecheck    # 类型检查
+pnpm test         # 运行测试
+pnpm check        # 代码检查和格式化检查（Biome）
+pnpm format       # 自动格式化
 ```
 
-## License
+## 变更日志
+
+详见 [CHANGELOG.md](./CHANGELOG.md)。
+
+## 许可协议
 
-[MIT](LICENSE)
+[MIT](./LICENSE)
 
 ## 免责声明
 

package/README_EN.md

@@ -1,28 +1,74 @@
 # manhuagui-cli
 
-> CLI tool for downloading manhua from manhuagui.com
+<p align="center">
+  <a href="https://www.npmjs.com/package/manhuagui-cli"><img src="https://img.shields.io/npm/v/manhuagui-cli" alt="npm version"></a>
+  <a href="https://nodejs.org/"><img src="https://img.shields.io/badge/node-%3E%3D22-brightgreen" alt="Node.js >= 22"></a>
+  <a href="./LICENSE"><img src="https://img.shields.io/npm/l/manhuagui-cli" alt="License: MIT"></a>
+</p>
+
+<p align="center">CLI tool for downloading manhua from manhuagui.com</p>
 
 [中文](README.md)
 
-## Features
+---
+
+## Table of Contents
+
+- [Quick Start](#quick-start)
+- [Features](#features)
+- [Installation](#installation)
+- [Usage](#usage)
+  - [Interactive Mode](#interactive-mode)
+  - [CLI Mode](#cli-mode)
+  - [Options](#options)
+- [Configuration](#configuration)
+  - [Priority](#priority)
+  - [Config Files](#config-files)
+  - [Environment Variables](#environment-variables)
+- [Output Structure](#output-structure)
+- [Development](#development)
+- [Changelog](#changelog)
+- [License](#license)
+- [Disclaimer](#disclaimer)
+
+## Quick Start
+
+```bash
+# Install globally
+npm install -g manhuagui-cli
+
+# Download a comic, follow the prompts
+manhuagui-cli
+
+# Or specify a URL directly
+manhuagui-cli <URL>
 
-- Interactive CLI with prompts, also supports direct CLI args
-- Auto-parses comic pages, lists all sections and chapters
-- Uses Playwright headless browser to bypass anti-bot measures
-- Random User-Agent and viewport rotation to simulate real users
-- CDN host rotation with automatic retry (up to 3 attempts) on image download failure
-- Concurrent image downloads within a chapter, sequential chapters with human-like delays
-- Resumable downloads: progress saved to `progress.json`, resume with `--resume` / `-r`
-- Clean output structure: `output/<comic-title>/<section>/<chapter>/001.webp`
+# Filter by section name
+manhuagui-cli <URL> -s "Single Volumes"
 
-## Requirements
+# Preview mode, list chapters without downloading
+manhuagui-cli <URL> --dry-run
 
-- **Node.js** >= 22
-- **pnpm** (recommended) or npm
+# Resume interrupted download
+manhuagui-cli <URL> --resume
+```
+
+## Features
+
+- **Interactive mode**: Running without arguments launches an interactive prompt that guides you through URL input and section selection
+- **CLI mode**: Full CLI argument support for scripting and automation
+- **Anti-bot evasion**: Uses Playwright headless Chromium to mimic real browser requests and bypass anti-bot measures
+- **Identity rotation**: Randomly switches User-Agent and viewport size to simulate real user behavior
+- **CDN resilience**: Automatically rotates CDN hosts on image download failure with retry (default 3 attempts)
+- **Concurrency control**: Concurrent image downloads within a chapter, sequential chapters with randomized delays
+- **Real-time progress**: Terminal progress bars displaying speed, per-chapter progress, overall progress, and ETA
+- **Preview mode** (`--dry-run`): Lists pending chapters without downloading, useful for planning
+- **Resumable downloads**: Progress automatically saved to `progress.json`, resume with `--resume` / `-r`
+- **Clean directory structure**: `output/<comic-title>/<section>/<chapter>/001.webp`
 
 ## Installation
 
-### npm (Recommended)
+### npm Global Install (Recommended)
 
 ```bash
 npm install -g manhuagui-cli
@@ -44,53 +90,81 @@ pnpm link --global
 
 ### Interactive Mode
 
+Run without arguments and the tool will guide you through each step:
+
 ```bash
-pnpm dev
-# or build first:
-pnpm build
-node dist/index.js
+manhuagui-cli
 ```
 
-Follow prompts to enter comic URL, select sections, and confirm download.
+Interactive flow:
+
+1. Enter the comic URL
+2. The tool parses comic metadata (title, sections, chapter list)
+3. Select which sections to download (multi-select supported)
+4. Confirm and start downloading
+
+```text
+  manhuagui-cli v1.0.1
+
+Input comic URL:
+  https://www.manhuagui.com/comic/12345/
+
+Parsing comic page...
+  Some Comic Title
+
+Which sections to download?
+  [x] Single Volumes (12 chapters)
+  [ ] Serialized (200 chapters)
+  [x] Extras (3 chapters)
+  Confirm
+
+ Overall  3/4 ch · 6/8 pg · 45s elapsed · ~15s
+ [====================>                   ]  50%
+ Ch.3  2/2 pg · Single Volumes · 93.5 KB/s · ~15s
+```
 
 ### CLI Mode
 
 ```bash
-node dist/index.js <URL> [options]
-# or if linked globally:
-manhuagui-cli <URL> [options]
-
 # Show help
-node dist/index.js --help
+manhuagui-cli --help
 
-# Example: download specific section
-node dist/index.js https://www.manhuagui.com/comic/12345/ -s "单行本"
+# Download a specific section
+manhuagui-cli https://www.manhuagui.com/comic/12345/ -s "Single Volumes"
 
-# Example: download specific chapter
-node dist/index.js https://www.manhuagui.com/comic/12345/ -s "单话" -c "第01话"
+# Download a specific chapter
+manhuagui-cli https://www.manhuagui.com/comic/12345/ -s "Serialized" -c "Chapter 01"
 
-# Example: resume interrupted download
-node dist/index.js https://www.manhuagui.com/comic/12345/ --resume
+# Specify output directory
+manhuagui-cli https://www.manhuagui.com/comic/12345/ -o ./my-comics
+
+# Resume interrupted download
+manhuagui-cli https://www.manhuagui.com/comic/12345/ --resume
+
+# Preview mode
+manhuagui-cli https://www.manhuagui.com/comic/12345/ --dry-run
 ```
 
 ### Options
 
-| Option               | Alias | Description                                                    |
-| -------------------- | ----- | -------------------------------------------------------------- |
-| `--section <name>`   | `-s`  | Download only the named section (default: all)                 |
-| `--chapter <name>`   | `-c`  | Download only the named chapter                                |
-| `--output <dir>`     | `-o`  | Download output directory                                      |
-| `--concurrency <n>`  | `-C`  | Concurrent image downloads per chapter                         |
-| `--retry <n>`        |       | Retry count per image download                                 |
-| `--log-level <level>`|       | Log level: `debug` \| `info` \| `warn` \| `error`                |
-| `--resume`           | `-r`  | Resume from previous interrupted download                      |
-| `--dry-run`          | `-d`  | Preview mode (list chapters without downloading)               |
-| `--help`             | `-h`  | Show help                                                      |
-| `--version`          | `-v`  | Show version                                                   |
+| Option                | Alias | Default  | Description                                                    |
+| --------------------- | ----- | -------- | -------------------------------------------------------------- |
+| `--section <name>`    | `-s`  | All      | Download only the named section                                |
+| `--chapter <name>`    | `-c`  | —        | Download only the named chapter                                |
+| `--output <dir>`      | `-o`  | `./output` | Download output directory                                    |
+| `--concurrency <n>`   | `-C`  | `2`      | Concurrent image downloads per chapter                         |
+| `--retry <n>`         |       | `3`      | Retry count per image download                                 |
+| `--log-level <level>` |       | `info`   | Log level: `debug` / `info` / `warn` / `error`                |
+| `--resume`            | `-r`  | —        | Resume from previous interrupted download                      |
+| `--dry-run`           | `-d`  | —        | Preview mode (list chapters without downloading)               |
+| `--help`              | `-h`  | —        | Show help                                                      |
+| `--version`           | `-v`  | —        | Show version                                                   |
 
 ## Configuration
 
-All settings follow this priority order (higher overrides lower):
+In addition to CLI arguments, behavior can be customized via config files and environment variables.
+
+### Priority
 
 ```
 CLI args > config files > environment variables > defaults
@@ -98,10 +172,13 @@ CLI args > config files > environment variables > defaults
 
 ### Config Files
 
-Two JSON config file locations are supported, project-level overrides global:
+Two JSON config file locations are supported. Project-level overrides global-level fields.
 
-- **Project-level**: `<cwd>/.manhuaguirc.json`
-- **Global**: `~/.config/manhuagui-cli/config.json` (Windows: `%USERPROFILE%\.config\manhuagui-cli\config.json`)
+| Location     | Path                                                                         |
+| ------------ | ---------------------------------------------------------------------------- |
+| Project      | `<cwd>/.manhuaguirc.json`                                                    |
+| Global       | `~/.config/manhuagui-cli/config.json`                                        |
+| (Windows)    | `%USERPROFILE%\.config\manhuagui-cli\config.json`                            |
 
 ```json
 {
@@ -118,22 +195,22 @@ All fields are optional; defaults are used for any omitted field.
 
 Copy `.env.example` to `.env` and modify as needed. System environment variables are also supported.
 
-| Variable              | Default    | Description                                         |
-| --------------------- | ---------- | --------------------------------------------------- |
-| `OUTPUT_BASE`         | `./output` | Download output directory                           |
-| `IMAGE_CONCURRENCY`   | `2`        | Concurrent image downloads per chapter              |
-| `DOWNLOAD_DELAY`      | `3000`     | Delay between image batches (ms, 0 to disable)     |
-| `CHAPTER_DELAY_MIN`   | `5000`     | Min delay between chapters (ms)                     |
-| `CHAPTER_DELAY_MAX`   | `15000`    | Max delay between chapters (ms)                     |
-| `RETRY_COUNT`         | `3`        | Retry count per image download                      |
-| `RETRY_BACKOFF_BASE`  | `1000`     | Retry backoff base (ms), wait `N × base` on Nth retry |
-| `IMAGE_LOAD_DELAY`    | `200`      | Wait after page turn for image to load (ms)         |
-| `LOG_LEVEL`           | `info`     | Log level: `debug` \| `info` \| `warn` \| `error`     |
-| `USER_AGENTS`         | —          | Custom User-Agent pool, one per line                |
+| Variable              | Default    | Description                                             |
+| --------------------- | ---------- | ------------------------------------------------------- |
+| `OUTPUT_BASE`         | `./output` | Download output directory                               |
+| `IMAGE_CONCURRENCY`   | `2`        | Concurrent image downloads per chapter                  |
+| `DOWNLOAD_DELAY`      | `3000`     | Delay between image batches (ms, 0 to disable)         |
+| `CHAPTER_DELAY_MIN`   | `3000`     | Min delay between chapters (ms)                         |
+| `CHAPTER_DELAY_MAX`   | `6000`     | Max delay between chapters (ms)                         |
+| `RETRY_COUNT`         | `3`        | Retry count per image download                          |
+| `RETRY_BACKOFF_BASE`  | `1000`     | Retry backoff base (ms), wait `N * base` on Nth retry  |
+| `IMAGE_LOAD_DELAY`    | `200`      | Wait after page turn for image to load (ms)             |
+| `LOG_LEVEL`           | `info`     | Log level: `debug` / `info` / `warn` / `error`          |
+| `USER_AGENTS`         | —          | Custom User-Agent pool, one per line                    |
 
 ## Output Structure
 
-```
+```text
 output/
 └── <comic-title>/
     ├── urls.json          # Chapter image URL manifest
@@ -148,18 +225,22 @@ output/
 ## Development
 
 ```bash
-pnpm install           # Install dependencies
-pnpm dev               # Run in dev mode (TypeScript directly)
-pnpm build             # Compile TypeScript
-pnpm typecheck         # Type check
-pnpm test              # Run tests
-pnpm check             # Lint and format check
-pnpm format            # Auto-fix formatting
+pnpm install      # Install dependencies
+pnpm dev          # Run in dev mode (TypeScript directly)
+pnpm build        # Compile TypeScript
+pnpm typecheck    # Type check
+pnpm test         # Run tests
+pnpm check        # Lint and format check (Biome)
+pnpm format       # Auto-fix formatting
 ```
 
+## Changelog
+
+See [CHANGELOG.md](./CHANGELOG.md).
+
 ## License
 
-[MIT](LICENSE)
+[MIT](./LICENSE)
 
 ## Disclaimer
 

package/dist/lib/chapter.d.ts

@@ -1,10 +1,22 @@
 import type { Browser, Page as PlaywrightPage, Response } from "playwright";
+import type { SpeedTracker } from "./speed.js";
 export declare function computePadLength(count: number): number;
 export declare function extractExtension(url: string): string;
-export declare function buildFilePath(outputDir: string, index: number, padLen: number, ext: string): string;
+export declare function buildFilePath(opts: {
+    outputDir: string;
+    index: number;
+    padLen: number;
+    ext: string;
+}): string;
 export declare function getPageCount(page: PlaywrightPage): Promise<number>;
 export declare function getSubPageUrls(page: PlaywrightPage): Promise<string[]>;
 export declare function collectImageUrls(page: PlaywrightPage, pageCount: number): Promise<string[]>;
 export declare function validateImageResponse(response: Response | null): void;
-export declare function extractChapterImages(chapterUrl: string, browser: Browser, outputDir: string): Promise<string[]>;
+export declare function extractChapterImages(opts: {
+    chapterUrl: string;
+    browser: Browser;
+    outputDir: string;
+    tracker: SpeedTracker;
+    onProgress?: (downloaded: number, total: number, bytes: number) => void;
+}): Promise<string[]>;
 //# sourceMappingURL=chapter.d.ts.map

package/dist/lib/chapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chapter.d.ts","sourceRoot":"","sources":["../../src/lib/chapter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAkB,IAAI,IAAI,cAAc,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAO5F,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAGpD;AAED,wBAAgB,aAAa,CAC3B,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,GACV,MAAM,CAGR;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAaxE;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAa5E;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CA8BjG;AAYD,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,GAAG,IAAI,CAQrE;AAyGD,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,EAAE,CAAC,CA4BnB"}
+{"version":3,"file":"chapter.d.ts","sourceRoot":"","sources":["../../src/lib/chapter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAkB,IAAI,IAAI,cAAc,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAK5F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG/C,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAGpD;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;CACb,GAAG,MAAM,CAGT;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAaxE;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAa5E;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CA8BjG;AAYD,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,GAAG,IAAI,CAQrE;AAsID,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAC/C,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,YAAY,CAAC;IACtB,UAAU,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACzE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAwCpB"}