@1-/minify_size 0.1.5 → 0.1.7

package/README.md

@@ -6,77 +6,83 @@
 # @1-/minify_size : Minify JavaScript and report Brotli-compressed size
 
 - [@1-/minify_size : Minify JavaScript and report Brotli-compressed size](#1-minify_size-minify-javascript-and-report-brotli-compressed-size)
-  - [1. Introduction](#1-introduction)
-  - [2. Usage Demo](#2-usage-demo)
-  - [3. Design Concept](#3-design-concept)
-  - [4. Tech Stack](#4-tech-stack)
+  - [1. Functionality](#1-functionality)
+  - [2. Usage](#2-usage)
+  - [3. Design](#3-design)
+  - [4. Technology Stack](#4-technology-stack)
   - [5. Code Structure](#5-code-structure)
   - [6. History](#6-history)
   - [About](#about)
 
-## 1. Introduction
+## 1. Functionality
 
-Evaluates JavaScript library size under modern network transmission environments supporting Brotli. For all `.js` files in the specified directory, performs:
+Measure JavaScript code transmission size under Brotli-enabled network environments. Supports specifying either a single JavaScript file or directory, performing:
 
-- Bundling using `@1-/rolldown` (Rust-based JavaScript bundler)
-- UTF-8 encoding of the bundled code
-- Brotli compression via Node.js built-in `node:zlib.brotliCompress` to compute final byte length
-- Returns total bundled compressed size (bytes)
+- Bundling with `@1-/rolldown` (Rust-based JavaScript bundler)
+- UTF-8 encoding using `@3-/utf8` TextEncoder
+- Brotli compression via Node.js built-in `node:zlib.brotliCompress`
+- Returning total compressed byte count of bundled output
 
-## 2. Usage Demo
+Excludes test files matching `/^(|\/)tests?(\/|$)/` and `node_modules` directories.
 
-Install dependency:
+## 2. Usage
+
+Install locally:
 
 ```bash
 npm install @1-/minify_size
 ```
 
-or install globally:
+Install globally:
 
 ```bash
 npm install -g @1-/minify_size
 ```
 
-Run command (specify the directory to analyze):
+Execute with target file or directory:
 
 ```bash
+# Process single file
+minify_size ./src/index.js
+
+# Process entire directory
 minify_size ./src
 ```
 
-Example output:
+Output example:
 
 ```
 650
 ```
 
-## 3. Design Concept
+## 3. Design
 
 Execution flow (vertical Mermaid diagram):
 
-![](https://fastly.jsdelivr.net/gh/webc-fs/-@D7/nQLapVbeR_9qMiOldgug.svg)
+![](https://fastly.jsdelivr.net/gh/webc-fs/-@v8/w24sosbAjA0LSvPhfzpA.svg)
 
-## 4. Tech Stack
+## 4. Technology Stack
 
-- **Runtime**: Node.js / Bun
+- **Runtime**: Bun / Node.js
 - **Bundler**: `@1-/rolldown` v0.1.7 (Rust-based JavaScript bundler)
-- **Brotli Engine**: Built-in `node:zlib` (Brotli compression)
-- **Arg Parser**: `yargs` v18.0.0
-- **Encoding**: `@3-/utf8` v0.1.1 (TextEncoder-based UTF-8 encoding)
-- **File Walking**: `@1-/walk` v0.1.2 (Directory traversal utility)
-- **Dependency Management**: npm
+- **Compression**: `node:zlib.brotliCompress` (built-in Brotli)
+- **Argument parsing**: `yargs` v18.0.0
+- **Encoding**: `@3-/utf8` v0.1.1 (TextEncoder-based UTF-8)
+- **File traversal**: `@1-/walk` v0.1.2 (directory traversal utility)
+- **Package management**: npm
 - **Testing**: bun:test
 
 ## 5. Code Structure
 
 ```
 src/
-├── cli.js     # CLI entrypoint, parses directory parameter and invokes main function
-└── _.js       # Directory traversal, bundling, Brotli compression calculation
+├── cli.js     # CLI entrypoint, parses path parameter and invokes main function
+└── _.js       # Path handling, bundling, Brotli compression calculation
 ```
 
 ## 6. History
 
-Brotli was developed by Jyrki Alakuijala and Zoltán Szabadka at Google in 2013. It was initially designed for compression of web fonts, and was later extended to become a general-purpose compression algorithm optimized for web transmission, becoming an industry standard (RFC 7932). Modern JavaScript bundlers like rolldown leverage Rust's performance to achieve sub-second builds while maintaining compatibility with existing JavaScript tooling ecosystems.
+Brotli was developed by Jyrki Alakuijala and Zoltán Szabadka at Google in 2013. Initially designed for web font compression, it evolved into a general-purpose algorithm optimized for web transmission and became an industry standard (RFC 7932). Modern JavaScript bundlers like rolldown leverage Rust's performance for sub-second builds while maintaining compatibility with existing JavaScript tooling ecosystems.
 
 ## About
 
@@ -101,30 +107,36 @@ This library is developed by [WebC.site](https://webc.site).
 
 ## 1. 功能介绍
 
-评估 JavaScript 库在支持 Brotli 的网络传输环境下的实际传输体积。对指定目录中所有 `.js` 文件执行以下操作：
+测量 JavaScript 代码在支持 Brotli 的网络环境中的传输体积。支持指定单个 JavaScript 文件或目录，执行以下操作：
 
 - 使用 `@1-/rolldown`（Rust 实现的 JavaScript 打包器）进行打包
-- 将打包后代码编码为 UTF-8 字节流
-- 使用 Node.js 内置 `node:zlib.brotliCompress` 计算 Brotli 压缩后字节长度
-- 返回整体打包压缩后大小（字节）
+- 使用 `@3-/utf8` TextEncoder 进行 UTF-8 编码
+- 使用 Node.js 内置 `node:zlib.brotliCompress` 进行 Brotli 压缩
+- 返回整体打包输出的压缩后字节长度
+
+排除匹配 `/^(|\/)tests?(\/|$)/` 的测试文件和 `node_modules` 目录。
 
 ## 2. 使用演示
 
-安装依赖：
+本地安装：
 
 ```bash
 npm install @1-/minify_size
 ```
 
-或全局安装：
+全局安装：
 
 ```bash
 npm install -g @1-/minify_size
 ```
 
-运行命令（指定待分析的目录）：
+执行命令并指定目标文件或目录：
 
 ```bash
+# 处理单个文件
+minify_size ./src/index.js
+
+# 处理整个目录
 minify_size ./src
 ```
 
@@ -136,32 +148,32 @@ minify_size ./src
 
 ## 3. 设计思路
 
-系统执行流程如下（垂直 Mermaid 流程图）：
+执行流程（垂直 Mermaid 流程图）：
 
-![](https://fastly.jsdelivr.net/gh/webc-fs/-@Qx/di2QsMfRjPdfYr2IasNQ.svg)
+![](https://fastly.jsdelivr.net/gh/webc-fs/-@j6/mgP5-ZcSQPBbhsd-KNOA.svg)
 
 ## 4. 技术栈
 
-- **Runtime**: Node.js / Bun
-- **Bundler**: `@1-/rolldown` v0.1.7 (Rust-based JavaScript bundler)
-- **Brotli Engine**: 内置 `node:zlib` (Brotli compression)
-- **Arg Parser**: `yargs` v18.0.0
-- **Encoding**: `@3-/utf8` v0.1.1 (TextEncoder-based UTF-8 encoding)
-- **File Walking**: `@1-/walk` v0.1.2 (Directory traversal utility)
-- **Dependency Management**: npm
-- **Testing**: bun:test
+- **运行时**: Bun / Node.js
+- **打包器**: `@1-/rolldown` v0.1.7 (Rust 实现的 JavaScript 打包器)
+- **压缩算法**: `node:zlib.brotliCompress` (内置 Brotli)
+- **参数解析**: `yargs` v18.0.0
+- **编码**: `@3-/utf8` v0.1.1 (TextEncoder 实现的 UTF-8)
+- **文件遍历**: `@1-/walk` v0.1.2 (目录遍历工具)
+- **包管理**: npm
+- **测试**: bun:test
 
 ## 5. 代码结构
 
 ```
 src/
-├── cli.js     # CLI 命令行入口，解析目录参数并调用主函数
-└── _.js       # 目录遍历、打包处理、Brotli压缩计算
+├── cli.js     # CLI 入口，解析路径参数并调用主函数
+└── _.js       # 路径处理、打包、Brotli 压缩计算
 ```
 
 ## 6. 历史故事
 
-Brotli 由 Google 的 Jyrki Alakuijala 和 Zoltán Szabadka 于 2013 年开发。它最初被设计用于压缩网页字体，后来发展为通用压缩算法，用于优化网页传输，并成为行业标准（RFC 7932）。现代 JavaScript bundlers like rolldown leverage Rust's performance to achieve sub-second builds while maintaining compatibility with existing JavaScript tooling ecosystems.
+Brotli 由 Google 的 Jyrki Alakuijala 和 Zoltán Szabadka 于 2013 年开发。最初专为网页字体压缩设计，后发展为通用压缩算法，针对网页传输优化，并成为行业标准（RFC 7932）。现代 JavaScript 打包器如 rolldown 利用 Rust 的性能优势实现亚秒级构建，同时保持与现有 JavaScript 工具生态的兼容性。
 
 ## 关于
 

package/_.js

@@ -1,5 +1,5 @@
-import { join, isAbsolute } from "node:path";
-import { realpathSync } from "node:fs";
+import { join, isAbsolute, dirname, basename } from "node:path";
+import { realpathSync, statSync } from "node:fs";
 import { promisify } from "node:util";
 import { brotliCompress } from "node:zlib";
 import { FILE } from "@1-/walk";
@@ -16,21 +16,30 @@ const BROTLI = promisify(brotliCompress),
   br = async (str) => (await BROTLI(utf8e(str))).length;
 
 /*
-打包并计算指定目录下 JS 文件压缩后大小
-参数: dir 目录路径
+打包并计算指定目录或 JS 文件压缩后大小
+参数: dir 目录或文件路径
 返回值: 整体打包压缩大小 (字节)
 */
 export default async (dir) => {
-  const real_dir = realpathSync(dir),
+  const real_path = realpathSync(dir),
+    stat = statSync(real_path),
+    is_file = stat.isFile(),
+    real_dir = is_file ? dirname(real_path) : real_path,
     files = [],
     input = {},
     out_map = {};
 
-  await walkRelIgnore(real_dir, (kind, rel_path) => {
-    if (kind === FILE && rel_path.endsWith(".js") && !/(^|\/)tests?(\/|$)/.test(rel_path)) {
-      files.push(rel_path);
+  if (is_file) {
+    if (real_path.endsWith(".js")) {
+      files.push(basename(real_path));
     }
-  });
+  } else {
+    await walkRelIgnore(real_dir, (kind, rel_path) => {
+      if (kind === FILE && rel_path.endsWith(".js") && !/(^|\/)tests?(\/|$)/.test(rel_path)) {
+        files.push(rel_path);
+      }
+    });
+  }
 
   if (!files.length) {
     return 0;
@@ -43,15 +52,14 @@ export default async (dir) => {
   });
 
   const chunks = await bundle(
-      input,
-      {
-        external: (id) => !id.startsWith(".") && !isAbsolute(id),
-      },
-      true,
-      undefined,
-      out_map,
-    ),
-    total_size = await br(chunks.map(([, code]) => code).join(""));
+    input,
+    {
+      external: (id) => !id.startsWith(".") && !isAbsolute(id),
+    },
+    true,
+    real_dir,
+    out_map,
+  );
 
-  return total_size;
+  return await br(chunks.map(([, code]) => code).join(""));
 };

package/cli.js

@@ -3,17 +3,17 @@ import yargs from "yargs";
 import { hideBin } from "yargs/helpers";
 import minify from "./_.js";
 
-// 解析参数并压缩指定目录下所有 JS 文件
-const { dir } = yargs(hideBin(process.argv))
-  .usage("Usage: $0 <dir>")
-  .command("$0 <dir>", "minify js and show brotli size", (y) => {
-    y.positional("dir", {
-      describe: "directory to minify",
+// 解析参数并压缩指定目录或 JS 文件
+const { path } = yargs(hideBin(process.argv))
+  .usage("Usage: $0 <path>")
+  .command("$0 <path>", "minify js and show brotli size", (y) => {
+    y.positional("path", {
+      describe: "directory or file path to minify",
       type: "string",
     });
   })
-  .demandCommand(1, "You must specify a directory")
+  .demandCommand(1, "You must specify a directory or file path")
   .help()
   .alias("h", "help").argv;
 
-console.log(await minify(dir));
+console.log(await minify(path));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@1-/minify_size",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "description": "Minify JS and output brotli compressed size | 压缩 JS 并输出 brotli 压缩后大小",
   "keywords": [
     "br",