@1-/minify_size 0.1.6 → 0.1.7

package/README.md

@@ -16,7 +16,7 @@
 
 ## 1. Functionality
 
-Measure JavaScript library transmission size under Brotli-enabled network environments. Processes all `.js` files in a specified directory by:
+Measure JavaScript code transmission size under Brotli-enabled network environments. Supports specifying either a single JavaScript file or directory, performing:
 
 - Bundling with `@1-/rolldown` (Rust-based JavaScript bundler)
 - UTF-8 encoding using `@3-/utf8` TextEncoder
@@ -39,9 +39,13 @@ Install globally:
 npm install -g @1-/minify_size
 ```
 
-Execute with target directory:
+Execute with target file or directory:
 
 ```bash
+# Process single file
+minify_size ./src/index.js
+
+# Process entire directory
 minify_size ./src
 ```
 
@@ -55,7 +59,7 @@ Output example:
 
 Execution flow (vertical Mermaid diagram):
 
-![](https://fastly.jsdelivr.net/gh/webc-fs/-@al/eo5PAnMMwP9cRbLWbHQg.svg)
+![](https://fastly.jsdelivr.net/gh/webc-fs/-@v8/w24sosbAjA0LSvPhfzpA.svg)
 
 ## 4. Technology Stack
 
@@ -72,8 +76,8 @@ Execution flow (vertical Mermaid diagram):
 
 ```
 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
@@ -93,17 +97,17 @@ This library is developed by [WebC.site](https://webc.site).
 # @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. 功能性](#1-功能性)
-  - [2. 使用方法](#2-使用方法)
+  - [1. 功能介绍](#1-功能介绍)
+  - [2. 使用演示](#2-使用演示)
   - [3. 设计思路](#3-设计思路)
   - [4. 技术栈](#4-技术栈)
   - [5. 代码结构](#5-代码结构)
-  - [6. 历史背景](#6-历史背景)
+  - [6. 历史故事](#6-历史故事)
   - [关于](#关于)
 
-## 1. 功能性
+## 1. 功能介绍
 
-测量 JavaScript 库在支持 Brotli 的网络环境中的传输体积。对指定目录中所有 `.js` 文件执行以下操作：
+测量 JavaScript 代码在支持 Brotli 的网络环境中的传输体积。支持指定单个 JavaScript 文件或目录，执行以下操作：
 
 - 使用 `@1-/rolldown`（Rust 实现的 JavaScript 打包器）进行打包
 - 使用 `@3-/utf8` TextEncoder 进行 UTF-8 编码
@@ -112,7 +116,7 @@ This library is developed by [WebC.site](https://webc.site).
 
 排除匹配 `/^(|\/)tests?(\/|$)/` 的测试文件和 `node_modules` 目录。
 
-## 2. 使用方法
+## 2. 使用演示
 
 本地安装：
 
@@ -126,9 +130,13 @@ npm install @1-/minify_size
 npm install -g @1-/minify_size
 ```
 
-执行命令并指定目标目录：
+执行命令并指定目标文件或目录：
 
 ```bash
+# 处理单个文件
+minify_size ./src/index.js
+
+# 处理整个目录
 minify_size ./src
 ```
 
@@ -142,7 +150,7 @@ minify_size ./src
 
 执行流程（垂直 Mermaid 流程图）：
 
-![](https://fastly.jsdelivr.net/gh/webc-fs/-@yh/rGQ5Y3ZbsLqLF6zENpxQ.svg)
+![](https://fastly.jsdelivr.net/gh/webc-fs/-@j6/mgP5-ZcSQPBbhsd-KNOA.svg)
 
 ## 4. 技术栈
 
@@ -159,11 +167,11 @@ minify_size ./src
 
 ```
 src/
-├── cli.js     # CLI 入口，解析目录参数并调用主函数
-└── _.js       # 目录遍历、打包处理、Brotli 压缩计算
+├── cli.js     # CLI 入口，解析路径参数并调用主函数
+└── _.js       # 路径处理、打包、Brotli 压缩计算
 ```
 
-## 6. 历史背景
+## 6. 历史故事
 
 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,
-      real_dir,
-      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.6",
+  "version": "0.1.7",
   "description": "Minify JS and output brotli compressed size | 压缩 JS 并输出 brotli 压缩后大小",
   "keywords": [
     "br",