@pz4l/tinyimg-unplugin 0.0.0

package/README.md

@@ -0,0 +1,210 @@
+[English](README.md) | [简体中文](README.zh-CN.md)
+
+# tinyimg-unplugin
+
+基于 TinyPNG 的图片压缩 unplugin，支持 Vite、Webpack、Rolldown 等构建工具。
+
+## Supported Tools
+
+- Vite
+- Webpack
+- Rolldown
+
+## Installation
+
+```bash
+npm install @pz4l/tinyimg-unplugin -D
+```
+
+## Environment Setup
+
+### TINYPNG_KEYS 环境变量
+
+在使用插件之前，你需要设置 `TINYPNG_KEYS` 环境变量，包含一个或多个 TinyPNG API key（用逗号分隔）：
+
+```bash
+# 单个 key
+export TINYPNG_KEYS=your_api_key_here
+
+# 多个 key（用逗号分隔）
+export TINYPNG_KEYS=key1,key2,key3
+```
+
+### 如何获取 API Key
+
+1. 访问 [TinyPNG 开发者页面](https://tinypng.com/developers)
+2. 使用邮箱注册获取 API key
+
+### 在项目中配置环境变量
+
+**Vite 项目**（`.env` 文件）：
+
+```bash
+TINYPNG_KEYS=your_api_key_here
+```
+
+**Webpack 项目**（`webpack.config.js`）：
+
+```javascript
+const webpack = require('webpack')
+
+module.exports = {
+  plugins: [
+    new webpack.DefinePlugin({
+      'process.env.TINYPNG_KEYS': JSON.stringify('your_api_key_here')
+    })
+  ]
+}
+```
+
+## Usage
+
+### Vite
+
+```javascript
+import tinyimg from '@pz4l/tinyimg-unplugin/vite'
+// vite.config.js
+import { defineConfig } from 'vite'
+
+export default defineConfig({
+  plugins: [
+    tinyimg({
+      mode: 'random', // key 使用策略
+      cache: true, // 启用缓存
+      parallel: 8, // 并发数
+      verbose: false, // 详细日志
+      strict: false, // 严格模式
+      include: ['**/*.png', '**/*.jpg'], // 包含的文件
+      exclude: ['**/node_modules/**'] // 排除的文件
+    })
+  ]
+})
+```
+
+### Webpack
+
+```javascript
+// webpack.config.js
+const tinyimg = require('@pz4l/tinyimg-unplugin/webpack')
+
+module.exports = {
+  plugins: [
+    tinyimg.default({
+      mode: 'random',
+      cache: true,
+      parallel: 8,
+      verbose: false,
+      strict: false,
+      include: ['**/*.png', '**/*.jpg'],
+      exclude: ['**/node_modules/**']
+    })
+  ]
+}
+```
+
+### Rolldown
+
+```javascript
+// rolldown.config.js
+import tinyimg from '@pz4l/tinyimg-unplugin/rolldown'
+
+export default {
+  plugins: [
+    tinyimg({
+      mode: 'random',
+      cache: true,
+      parallel: 8,
+      verbose: false,
+      strict: false,
+      include: ['**/*.png', '**/*.jpg'],
+      exclude: ['**/node_modules/**']
+    })
+  ]
+}
+```
+
+## Options
+
+### mode
+
+- **Type**: `'random' | 'round-robin' | 'priority'`
+- **Default**: `'random'`
+- **Description**: API key 使用策略
+  - `random`: 随机选择 key（默认）
+  - `round-robin`: 轮询使用 key
+  - `priority`: 优先使用额度充足的 key
+
+### cache
+
+- **Type**: `boolean`
+- **Default**: `true`
+- **Description**: 是否启用缓存。启用后，已压缩过的图片（基于 MD5）不会重复压缩，节省 API 额度。
+
+### parallel
+
+- **Type**: `number`
+- **Default**: `8`
+- **Description**: 并发压缩数量。数值越高压缩越快，但会更快消耗 API 额度。
+
+### verbose
+
+- **Type**: `boolean`
+- **Default**: `false`
+- **Description**: 是否输出详细日志。启用后会显示每张图片的压缩信息。
+
+### strict
+
+- **Type**: `boolean`
+- **Default**: `false`
+- **Description**: 严格模式。启用后，如果压缩失败会中断构建；关闭则使用原图继续构建。
+
+### include
+
+- **Type**: `string | string[]`
+- **Default**: `undefined`
+- **Description**: 包含的文件匹配模式。支持 glob 模式，如 `'**/*.png'`。
+
+### exclude
+
+- **Type**: `string | string[]`
+- **Default**: `undefined`
+- **Description**: 排除的文件匹配模式。支持 glob 模式，如 `'**/node_modules/**'`。
+
+## Behavior
+
+### Production Only
+
+插件仅在生产构建时生效（`NODE_ENV=production` 或 Vite 的 build 模式），开发模式下不会压缩图片。
+
+### Supported Formats
+
+仅支持 TinyPNG 支持的格式：
+
+- PNG
+- JPG / JPEG
+
+其他格式（如 WebP、AVIF、SVG）会被忽略。
+
+### Project Cache Only
+
+unplugin 仅使用项目级缓存（`.node_modules/.tinyimg_cache/`），不使用全局缓存。这确保每个项目的缓存相互隔离。
+
+### Key Management
+
+- 仅从 `TINYPNG_KEYS` 环境变量读取 API key
+- 不支持 CLI 的 `-k` 选项
+- 自动轮询多个 key，当某个 key 额度耗尽时自动切换到下一个
+
+## Features
+
+- Automatic image compression during build
+- Multi-key management for quota optimization
+- Smart caching based on MD5
+- Concurrent compression control
+- File filtering with glob patterns
+- Production-only execution
+
+## Related Packages
+
+- [@pz4l/tinyimg-core](https://github.com/pzehrel/tinyimg/tree/main/packages/tinyimg-core) - Core compression library
+- [@pz4l/tinyimg-cli](https://github.com/pzehrel/tinyimg/tree/main/packages/tinyimg-cli) - CLI tool for image compression

package/README.zh-CN.md

@@ -0,0 +1,210 @@
+[English](README.md) | 简体中文
+
+# tinyimg-unplugin
+
+基于 TinyPNG 的图片压缩 unplugin，支持 Vite、Webpack、Rolldown 等构建工具。
+
+## 支持的工具
+
+- Vite
+- Webpack
+- Rolldown
+
+## 安装
+
+```bash
+npm install @pz4l/tinyimg-unplugin -D
+```
+
+## 环境设置
+
+### TINYPNG_KEYS 环境变量
+
+在使用插件之前，你需要设置 `TINYPNG_KEYS` 环境变量，包含一个或多个 TinyPNG API key（用逗号分隔）：
+
+```bash
+# 单个 key
+export TINYPNG_KEYS=your_api_key_here
+
+# 多个 key（用逗号分隔）
+export TINYPNG_KEYS=key1,key2,key3
+```
+
+### 如何获取 API Key
+
+1. 访问 [TinyPNG 开发者页面](https://tinypng.com/developers)
+2. 使用邮箱注册获取 API key
+
+### 在项目中配置环境变量
+
+**Vite 项目**（`.env` 文件）：
+
+```bash
+TINYPNG_KEYS=your_api_key_here
+```
+
+**Webpack 项目**（`webpack.config.js`）：
+
+```javascript
+const webpack = require('webpack')
+
+module.exports = {
+  plugins: [
+    new webpack.DefinePlugin({
+      'process.env.TINYPNG_KEYS': JSON.stringify('your_api_key_here')
+    })
+  ]
+}
+```
+
+## 使用方法
+
+### Vite
+
+```javascript
+import tinyimg from '@pz4l/tinyimg-unplugin/vite'
+// vite.config.js
+import { defineConfig } from 'vite'
+
+export default defineConfig({
+  plugins: [
+    tinyimg({
+      mode: 'random', // key 使用策略
+      cache: true, // 启用缓存
+      parallel: 8, // 并发数
+      verbose: false, // 详细日志
+      strict: false, // 严格模式
+      include: ['**/*.png', '**/*.jpg'], // 包含的文件
+      exclude: ['**/node_modules/**'] // 排除的文件
+    })
+  ]
+})
+```
+
+### Webpack
+
+```javascript
+// webpack.config.js
+const tinyimg = require('@pz4l/tinyimg-unplugin/webpack')
+
+module.exports = {
+  plugins: [
+    tinyimg.default({
+      mode: 'random',
+      cache: true,
+      parallel: 8,
+      verbose: false,
+      strict: false,
+      include: ['**/*.png', '**/*.jpg'],
+      exclude: ['**/node_modules/**']
+    })
+  ]
+}
+```
+
+### Rolldown
+
+```javascript
+// rolldown.config.js
+import tinyimg from '@pz4l/tinyimg-unplugin/rolldown'
+
+export default {
+  plugins: [
+    tinyimg({
+      mode: 'random',
+      cache: true,
+      parallel: 8,
+      verbose: false,
+      strict: false,
+      include: ['**/*.png', '**/*.jpg'],
+      exclude: ['**/node_modules/**']
+    })
+  ]
+}
+```
+
+## 选项
+
+### mode
+
+- **类型**: `'random' | 'round-robin' | 'priority'`
+- **默认值**: `'random'`
+- **说明**: API key 使用策略
+  - `random`: 随机选择 key（默认）
+  - `round-robin`: 轮询使用 key
+  - `priority`: 优先使用额度充足的 key
+
+### cache
+
+- **类型**: `boolean`
+- **默认值**: `true`
+- **说明**: 是否启用缓存。启用后，已压缩过的图片（基于 MD5）不会重复压缩，节省 API 额度。
+
+### parallel
+
+- **类型**: `number`
+- **默认值**: `8`
+- **说明**: 并发压缩数量。数值越高压缩越快，但会更快消耗 API 额度。
+
+### verbose
+
+- **类型**: `boolean`
+- **默认值**: `false`
+- **说明**: 是否输出详细日志。启用后会显示每张图片的压缩信息。
+
+### strict
+
+- **类型**: `boolean`
+- **默认值**: `false`
+- **说明**: 严格模式。启用后，如果压缩失败会中断构建；关闭则使用原图继续构建。
+
+### include
+
+- **类型**: `string | string[]`
+- **默认值**: `undefined`
+- **说明**: 包含的文件匹配模式。支持 glob 模式，如 `'**/*.png'`。
+
+### exclude
+
+- **类型**: `string | string[]`
+- **默认值**: `undefined`
+- **说明**: 排除的文件匹配模式。支持 glob 模式，如 `'**/node_modules/**'`。
+
+## 行为
+
+### 仅在生产环境
+
+插件仅在生产构建时生效（`NODE_ENV=production` 或 Vite 的 build 模式），开发模式下不会压缩图片。
+
+### 支持的格式
+
+仅支持 TinyPNG 支持的格式：
+
+- PNG
+- JPG / JPEG
+
+其他格式（如 WebP、AVIF、SVG）会被忽略。
+
+### 仅项目缓存
+
+unplugin 仅使用项目级缓存（`.node_modules/.tinyimg_cache/`），不使用全局缓存。这确保每个项目的缓存相互隔离。
+
+### 密钥管理
+
+- 仅从 `TINYPNG_KEYS` 环境变量读取 API key
+- 不支持 CLI 的 `-k` 选项
+- 自动轮询多个 key，当某个 key 额度耗尽时自动切换到下一个
+
+## 特性
+
+- 构建期间自动压缩图片
+- 多密钥管理优化额度使用
+- 基于 MD5 的智能缓存
+- 并发压缩控制
+- 使用 glob 模式过滤文件
+- 仅在生产环境执行
+
+## 相关包
+
+- [@pz4l/tinyimg-core](https://github.com/pzehrel/tinyimg/tree/main/packages/tinyimg-core) - 核心压缩库
+- [@pz4l/tinyimg-cli](https://github.com/pzehrel/tinyimg/tree/main/packages/tinyimg-cli) - 图片压缩 CLI 工具

package/dist/index.d.mts

@@ -0,0 +1,22 @@
+import * as unplugin from "unplugin";
+
+//#region src/filter.d.ts
+interface FilterOptions {
+  include?: string | string[];
+  exclude?: string | string[];
+}
+//#endregion
+//#region src/options.d.ts
+interface TinyimgUnpluginOptions extends FilterOptions {
+  mode?: 'random' | 'round-robin' | 'priority';
+  cache?: boolean;
+  parallel?: number;
+  strict?: boolean;
+  verbose?: boolean;
+}
+//#endregion
+//#region src/index.d.ts
+declare const _default: unplugin.UnpluginInstance<TinyimgUnpluginOptions, boolean>;
+//#endregion
+export { _default as default };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/filter.ts","../src/options.ts","../src/index.ts"],"mappings":";;;UAIiB,aAAA;EACf,OAAA;EACA,OAAA;AAAA;;;UCJe,sBAAA,SAA+B,aAAA;EAC9C,IAAA;EACA,KAAA;EACA,QAAA;EACA,MAAA;EACA,OAAA;AAAA;;;cCPqD,QAAA"}

package/dist/index.mjs

@@ -0,0 +1,204 @@
+import { Buffer } from "node:buffer";
+import process from "node:process";
+import { compressImage, formatBytes, loadKeys } from "tinyimg-core";
+import { createUnplugin } from "unplugin";
+import path from "node:path";
+import micromatch from "micromatch";
+//#region src/filter.ts
+const IMAGE_EXTENSIONS = new Set([
+	".png",
+	".jpg",
+	".jpeg"
+]);
+function shouldProcessImage(id, options = {}) {
+	const ext = path.extname(id).toLowerCase();
+	if (!IMAGE_EXTENSIONS.has(ext)) return false;
+	if (options.include) {
+		const includePatterns = Array.isArray(options.include) ? options.include : [options.include];
+		if (!micromatch.isMatch(id, includePatterns)) return false;
+	}
+	if (options.exclude) {
+		const excludePatterns = Array.isArray(options.exclude) ? options.exclude : [options.exclude];
+		if (micromatch.isMatch(id, excludePatterns)) return false;
+	}
+	return true;
+}
+//#endregion
+//#region src/stats.ts
+var CompressionStats = class {
+	compressedCount = 0;
+	cachedCount = 0;
+	originalSize = 0;
+	compressedSize = 0;
+	fileResults = [];
+	recordCompressed(path, originalSize, compressedSize) {
+		this.compressedCount++;
+		this.originalSize += originalSize;
+		this.compressedSize += compressedSize;
+		this.fileResults.push({
+			path,
+			originalSize,
+			compressedSize,
+			cached: false
+		});
+	}
+	recordCached(path, size) {
+		this.cachedCount++;
+		this.originalSize += size;
+		this.compressedSize += size;
+		this.fileResults.push({
+			path,
+			originalSize: size,
+			compressedSize: size,
+			cached: true
+		});
+	}
+	recordError(path, error) {
+		this.fileResults.push({
+			path,
+			originalSize: 0,
+			cached: false,
+			error
+		});
+	}
+	getSummary() {
+		return {
+			compressedCount: this.compressedCount,
+			cachedCount: this.cachedCount,
+			originalSize: this.originalSize,
+			compressedSize: this.compressedSize,
+			bytesSaved: this.originalSize - this.compressedSize,
+			fileCount: this.fileResults.length
+		};
+	}
+	formatSummary() {
+		const summary = this.getSummary();
+		const lines = [];
+		if (summary.compressedCount === 0 && summary.cachedCount > 0) lines.push(`[tinyimg] All images cached (0 compressed, ${summary.cachedCount} cached)`);
+		else {
+			lines.push(`✓ [tinyimg] Compressed ${summary.fileCount} images (${summary.cachedCount} cached, ${summary.compressedCount} compressed)`);
+			lines.push(`✓ [tinyimg] Saved ${formatBytes(summary.bytesSaved)} (original: ${formatBytes(summary.originalSize)} → compressed: ${formatBytes(summary.compressedSize)})`);
+		}
+		return lines;
+	}
+	getFileResults() {
+		return this.fileResults;
+	}
+};
+//#endregion
+//#region src/logger.ts
+var TinyimgLogger = class {
+	stats;
+	verbose;
+	strict;
+	constructor(options = {}) {
+		this.verbose = options.verbose ?? false;
+		this.strict = options.strict ?? false;
+		this.stats = new CompressionStats();
+	}
+	logCompressing(path) {
+		if (this.verbose) console.log(`[tinyimg] Compressing ${path}...`);
+	}
+	logCompressed(path, originalSize, compressedSize) {
+		this.stats.recordCompressed(path, originalSize, compressedSize);
+		if (this.verbose) {
+			const saved = ((1 - compressedSize / originalSize) * 100).toFixed(1);
+			console.log(`[tinyimg] ✓ Compressed: ${formatBytes(originalSize)} → ${formatBytes(compressedSize)} (${saved}% saved)`);
+		}
+	}
+	logCacheHit(path, size) {
+		this.stats.recordCached(path, size);
+		if (this.verbose) console.log(`[tinyimg] Cache hit: ${path}`);
+	}
+	logError(path, error) {
+		this.stats.recordError(path, error);
+		if (this.strict) console.error(`[tinyimg] ✖ Failed to compress ${path}: ${error}. Build failed.`);
+		else console.warn(`[tinyimg] ⚠ Failed to compress ${path}: ${error}. Using original file.`);
+	}
+	logSummary() {
+		this.stats.formatSummary().forEach((line) => console.log(line));
+	}
+	getStats() {
+		return this.stats;
+	}
+	shouldThrowOnError() {
+		return this.strict;
+	}
+};
+function createLogger(options = {}) {
+	return new TinyimgLogger(options);
+}
+//#endregion
+//#region src/options.ts
+const VALID_MODES = new Set([
+	"random",
+	"round-robin",
+	"priority"
+]);
+function normalizeOptions(options = {}) {
+	if (options.mode !== void 0 && !VALID_MODES.has(options.mode)) throw new TypeError(`Invalid mode: "${options.mode}". Must be one of: random, round-robin, priority`);
+	if (options.parallel !== void 0 && options.parallel <= 0) throw new RangeError(`Invalid parallel: ${options.parallel}. Must be a positive number`);
+	return {
+		mode: options.mode ?? "random",
+		cache: options.cache ?? true,
+		parallel: options.parallel ?? 8,
+		strict: options.strict ?? false,
+		verbose: options.verbose ?? false,
+		include: options.include ? Array.isArray(options.include) ? options.include : [options.include] : void 0,
+		exclude: options.exclude ? Array.isArray(options.exclude) ? options.exclude : [options.exclude] : void 0
+	};
+}
+//#endregion
+//#region src/index.ts
+const IMAGE_REGEX = /\.(png|jpg|jpeg|gif|webp|svg)$/i;
+var src_default = createUnplugin((options = {}) => {
+	const normalized = normalizeOptions(options);
+	if (loadKeys().length === 0) throw new Error("TINYPNG_KEYS environment variable is required");
+	const logger = createLogger({
+		verbose: normalized.verbose,
+		strict: normalized.strict
+	});
+	return {
+		name: "tinyimg-unplugin",
+		enforce: "post",
+		async transform(code, id) {
+			if (!shouldProcessImage(id, normalized)) return null;
+			if (!isProductionBuild(this)) return null;
+			const buffer = Buffer.from(code);
+			const relativePath = getRelativePath(id);
+			logger.logCompressing(relativePath);
+			try {
+				const compressed = await compressImage(buffer, {
+					projectCacheOnly: true,
+					cache: normalized.cache,
+					mode: normalized.mode
+				});
+				logger.logCompressed(relativePath, buffer.length, compressed.length);
+				return {
+					code: compressed,
+					map: null
+				};
+			} catch (error) {
+				logger.logError(relativePath, error.message);
+				if (logger.shouldThrowOnError()) throw error;
+				return null;
+			}
+		},
+		buildEnd() {
+			logger.logSummary();
+		}
+	};
+});
+function isProductionBuild(context) {
+	if (context?.config?.isBuild !== void 0) return context.config.isBuild;
+	if (context?.mode !== void 0) return context.mode === "production";
+	return process.env.NODE_ENV === "production";
+}
+function getRelativePath(id) {
+	const root = process.cwd();
+	return id.replace(root, "").replace(IMAGE_REGEX, "");
+}
+//#endregion
+export { src_default as default };
+
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/filter.ts","../src/stats.ts","../src/logger.ts","../src/options.ts","../src/index.ts"],"sourcesContent":["import path from 'node:path'\n// @ts-expect-error - micromatch doesn't have types\nimport micromatch from 'micromatch'\n\nexport interface FilterOptions {\n  include?: string | string[]\n  exclude?: string | string[]\n}\n\nexport const IMAGE_EXTENSIONS = new Set(['.png', '.jpg', '.jpeg'])\n\nexport function shouldProcessImage(id: string, options: FilterOptions = {}): boolean {\n  // 1. Check extension first (fast path)\n  const ext = path.extname(id).toLowerCase()\n  if (!IMAGE_EXTENSIONS.has(ext)) {\n    return false\n  }\n\n  // 2. Check include pattern if provided\n  if (options.include) {\n    const includePatterns = Array.isArray(options.include) ? options.include : [options.include]\n    const isInclude = micromatch.isMatch(id, includePatterns)\n    if (!isInclude)\n      return false\n  }\n\n  // 3. Check exclude pattern if provided\n  if (options.exclude) {\n    const excludePatterns = Array.isArray(options.exclude) ? options.exclude : [options.exclude]\n    const isExclude = micromatch.isMatch(id, excludePatterns)\n    if (isExclude)\n      return false\n  }\n\n  return true\n}\n","import { formatBytes } from 'tinyimg-core'\n\nexport interface FileResult {\n  path: string\n  originalSize: number\n  compressedSize?: number\n  cached: boolean\n  error?: string\n}\n\nexport class CompressionStats {\n  private compressedCount = 0\n  private cachedCount = 0\n  private originalSize = 0\n  private compressedSize = 0\n  private fileResults: FileResult[] = []\n\n  recordCompressed(path: string, originalSize: number, compressedSize: number): void {\n    this.compressedCount++\n    this.originalSize += originalSize\n    this.compressedSize += compressedSize\n    this.fileResults.push({ path, originalSize, compressedSize, cached: false })\n  }\n\n  recordCached(path: string, size: number): void {\n    this.cachedCount++\n    this.originalSize += size\n    this.compressedSize += size\n    this.fileResults.push({ path, originalSize: size, compressedSize: size, cached: true })\n  }\n\n  recordError(path: string, error: string): void {\n    this.fileResults.push({ path, originalSize: 0, cached: false, error })\n  }\n\n  getSummary() {\n    return {\n      compressedCount: this.compressedCount,\n      cachedCount: this.cachedCount,\n      originalSize: this.originalSize,\n      compressedSize: this.compressedSize,\n      bytesSaved: this.originalSize - this.compressedSize,\n      fileCount: this.fileResults.length,\n    }\n  }\n\n  formatSummary(): string[] {\n    const summary = this.getSummary()\n    const lines: string[] = []\n\n    if (summary.compressedCount === 0 && summary.cachedCount > 0) {\n      // All cached (D-11)\n      lines.push(`[tinyimg] All images cached (0 compressed, ${summary.cachedCount} cached)`)\n    }\n    else {\n      // Normal summary (D-09)\n      lines.push(`✓ [tinyimg] Compressed ${summary.fileCount} images (${summary.cachedCount} cached, ${summary.compressedCount} compressed)`)\n      lines.push(`✓ [tinyimg] Saved ${formatBytes(summary.bytesSaved)} (original: ${formatBytes(summary.originalSize)} → compressed: ${formatBytes(summary.compressedSize)})`)\n    }\n\n    return lines\n  }\n\n  getFileResults(): readonly FileResult[] {\n    return this.fileResults\n  }\n}\n","import { formatBytes } from 'tinyimg-core'\nimport { CompressionStats } from './stats'\n\nexport interface LoggerOptions {\n  verbose?: boolean\n  strict?: boolean\n}\n\nexport class TinyimgLogger {\n  private stats: CompressionStats\n  private verbose: boolean\n  private strict: boolean\n\n  constructor(options: LoggerOptions = {}) {\n    this.verbose = options.verbose ?? false\n    this.strict = options.strict ?? false\n    this.stats = new CompressionStats()\n  }\n\n  logCompressing(path: string): void {\n    if (this.verbose) {\n      console.log(`[tinyimg] Compressing ${path}...`)\n    }\n  }\n\n  logCompressed(path: string, originalSize: number, compressedSize: number): void {\n    this.stats.recordCompressed(path, originalSize, compressedSize)\n\n    if (this.verbose) {\n      const saved = ((1 - compressedSize / originalSize) * 100).toFixed(1)\n      console.log(`[tinyimg] ✓ Compressed: ${formatBytes(originalSize)} → ${formatBytes(compressedSize)} (${saved}% saved)`)\n    }\n  }\n\n  logCacheHit(path: string, size: number): void {\n    this.stats.recordCached(path, size)\n\n    if (this.verbose) {\n      console.log(`[tinyimg] Cache hit: ${path}`)\n    }\n  }\n\n  logError(path: string, error: string): void {\n    this.stats.recordError(path, error)\n\n    if (this.strict) {\n      // Strict mode (D-13)\n      console.error(`[tinyimg] ✖ Failed to compress ${path}: ${error}. Build failed.`)\n    }\n    else {\n      // Non-strict mode (D-12)\n      console.warn(`[tinyimg] ⚠ Failed to compress ${path}: ${error}. Using original file.`)\n    }\n  }\n\n  logSummary(): void {\n    const lines = this.stats.formatSummary()\n    lines.forEach(line => console.log(line))\n  }\n\n  getStats(): CompressionStats {\n    return this.stats\n  }\n\n  shouldThrowOnError(): boolean {\n    return this.strict\n  }\n}\n\nexport function createLogger(options: LoggerOptions = {}): TinyimgLogger {\n  return new TinyimgLogger(options)\n}\n","import type { FilterOptions } from './filter'\n\nexport interface TinyimgUnpluginOptions extends FilterOptions {\n  mode?: 'random' | 'round-robin' | 'priority'\n  cache?: boolean\n  parallel?: number\n  strict?: boolean\n  verbose?: boolean\n}\n\nexport interface NormalizedOptions {\n  mode: 'random' | 'round-robin' | 'priority'\n  cache: boolean\n  parallel: number\n  strict: boolean\n  verbose: boolean\n  include?: string[]\n  exclude?: string[]\n}\n\nconst VALID_MODES = new Set(['random', 'round-robin', 'priority'])\n\nexport function normalizeOptions(options: TinyimgUnpluginOptions = {}): NormalizedOptions {\n  // Validate mode\n  if (options.mode !== undefined && !VALID_MODES.has(options.mode)) {\n    throw new TypeError(`Invalid mode: \"${options.mode}\". Must be one of: random, round-robin, priority`)\n  }\n\n  // Validate parallel\n  if (options.parallel !== undefined && options.parallel <= 0) {\n    throw new RangeError(`Invalid parallel: ${options.parallel}. Must be a positive number`)\n  }\n\n  return {\n    mode: options.mode ?? 'random',\n    cache: options.cache ?? true,\n    parallel: options.parallel ?? 8,\n    strict: options.strict ?? false,\n    verbose: options.verbose ?? false,\n    include: options.include ? (Array.isArray(options.include) ? options.include : [options.include]) : undefined,\n    exclude: options.exclude ? (Array.isArray(options.exclude) ? options.exclude : [options.exclude]) : undefined,\n  }\n}\n","import type { TinyimgUnpluginOptions } from './options'\nimport { Buffer } from 'node:buffer'\nimport process from 'node:process'\nimport { compressImage, loadKeys } from 'tinyimg-core'\nimport { createUnplugin } from 'unplugin'\nimport { shouldProcessImage } from './filter'\nimport { createLogger } from './logger'\nimport { normalizeOptions } from './options'\n\n// Regex for matching image file extensions\nconst IMAGE_REGEX = /\\.(png|jpg|jpeg|gif|webp|svg)$/i\n\nexport default createUnplugin((options: TinyimgUnpluginOptions = {}): any => {\n  // Normalize options\n  const normalized = normalizeOptions(options)\n\n  // Validate TINYPNG_KEYS (D-15, D-16)\n  const keys = loadKeys()\n  if (keys.length === 0) {\n    throw new Error('TINYPNG_KEYS environment variable is required')\n  }\n\n  // Create logger\n  const logger = createLogger({\n    verbose: normalized.verbose,\n    strict: normalized.strict,\n  })\n\n  return {\n    name: 'tinyimg-unplugin',\n    enforce: 'post', // Run after other transformations (D-02)\n\n    async transform(code: any, id: any) {\n      // Filter non-image files\n      const shouldProcess = shouldProcessImage(id, normalized)\n      if (!shouldProcess) {\n        return null\n      }\n\n      // Check production build (D-01)\n      const isProd = isProductionBuild(this)\n      if (!isProd) {\n        return null\n      }\n\n      // Convert to Buffer\n      const buffer = Buffer.from(code)\n\n      // Get relative path for logging\n      const relativePath = getRelativePath(id)\n\n      // Log compression start\n      logger.logCompressing(relativePath)\n\n      try {\n        // Compress image\n        const compressed = await compressImage(buffer, {\n          projectCacheOnly: true, // Only project cache (D-17)\n          cache: normalized.cache,\n          mode: normalized.mode as any,\n        })\n\n        // Log success\n        logger.logCompressed(relativePath, buffer.length, compressed.length)\n\n        return { code: compressed, map: null }\n      }\n      catch (error: any) {\n        // Log error\n        logger.logError(relativePath, error.message)\n\n        // Check strict mode\n        if (logger.shouldThrowOnError()) {\n          throw error\n        }\n\n        // Non-strict: return null to use original file\n        return null\n      }\n    },\n\n    buildEnd() {\n      logger.logSummary()\n    },\n  }\n})\n\n// Helper functions\nfunction isProductionBuild(context: any): boolean {\n  // Vite: check config.isBuild (D-01)\n  if (context?.config?.isBuild !== undefined) {\n    return context.config.isBuild\n  }\n\n  // Webpack: check mode (D-01)\n  if (context?.mode !== undefined) {\n    return context.mode === 'production'\n  }\n\n  // Fallback: check NODE_ENV\n  return process.env.NODE_ENV === 'production'\n}\n\nfunction getRelativePath(id: string): string {\n  // Convert absolute path to relative for logging\n  const root = process.cwd()\n  return id.replace(root, '').replace(IMAGE_REGEX, '')\n}\n"],"mappings":"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"}

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "@pz4l/tinyimg-unplugin",
+  "type": "module",
+  "version": "0.0.0",
+  "description": "unplugin for automatic image compression during build (Vite, Webpack, Rolldown)",
+  "author": "pzehrel",
+  "license": "MIT",
+  "homepage": "https://github.com/pzehrel/tinyimg/tree/main/packages/tinyimg-unplugin#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/pzehrel/tinyimg.git",
+    "directory": "packages/tinyimg-unplugin"
+  },
+  "bugs": {
+    "url": "https://github.com/pzehrel/tinyimg/issues"
+  },
+  "keywords": [
+    "tinypng",
+    "image",
+    "compression",
+    "compress",
+    "optimize",
+    "optimization",
+    "img",
+    "minify",
+    "unplugin",
+    "vite",
+    "webpack",
+    "rolldown",
+    "build",
+    "plugin",
+    "imagemin"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.mjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "typecheck": "tsc --noEmit"
+  },
+  "peerDependencies": {
+    "vite": ">=2.0.0",
+    "webpack": ">=4.0.0"
+  },
+  "peerDependenciesMeta": {
+    "vite": {
+      "optional": true
+    },
+    "webpack": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "micromatch": "^4.0.8",
+    "@pz4l/tinyimg-core": "workspace:*",
+    "unplugin": "^1.0.0"
+  },
+  "devDependencies": {
+    "fast-glob": "^3.3.3",
+    "webpack": "^5.105.4",
+    "webpack-cli": "^7.0.2"
+  }
+}