@1-/minify_size 0.1.2 → 0.1.3

package/README.md

@@ -3,9 +3,9 @@
 ---
 
 <a id="en"></a>
-# @1-/minify_size : Minify JS and output brotli compressed size
+# @1-/minify_size : Minify JavaScript and report Brotli-compressed size
 
-- [@1-/minify_size : Minify JS and output brotli compressed size](#1-minify_size-minify-js-and-output-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)
@@ -16,8 +16,12 @@
 
 ## 1. Introduction
 
-Minifies JavaScript files in a specified directory and calculates their size after Brotli compression.
-Evaluates JavaScript library size under modern network transmission environments supporting Brotli.
+Evaluates JavaScript library size under modern network transmission environments supporting Brotli. For all `.js` files in the specified directory, performs:
+
+- Syntax-aware minification using `oxc-minify` (Rust implementation)
+- UTF-8 encoding of the minified code
+- Brotli compression via Node.js built-in `node:zlib.brotliCompress` to compute final byte length
+- Aggregation of per-file sizes and calculation of total bundled compressed size
 
 ## 2. Usage Demo
 
@@ -33,7 +37,7 @@ or install globally:
 npm install -g @1-/minify_size
 ```
 
-Run command:
+Run command (specify the directory to analyze):
 
 ```bash
 minify_size ./src
@@ -42,16 +46,16 @@ minify_size ./src
 Example output:
 
 ```
-_.js    400
-file.js 250
-Total   650
+_.js                400
+file.js             250
+Total bundled size  650
 ```
 
 ## 3. Design Concept
 
-Execution process:
+Execution flow (vertical Mermaid diagram):
 
-![](https://fastly.jsdelivr.net/gh/webc-fs/-@RL/NUbVPqfWeEufBqPl_sqg.svg)
+![](https://fastly.jsdelivr.net/gh/webc-fs/-@AI/_OWRSd8Rk6TslPIF1blg.svg)
 
 ## 4. Tech Stack
 
@@ -78,6 +82,7 @@ src/
 
 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).
 
+
 ## About
 
 This library is developed by [WebC.site](https://webc.site).
@@ -88,9 +93,9 @@ This library is developed by [WebC.site](https://webc.site).
 ---
 
 <a id="zh"></a>
-# @1-/minify_size : Minify JS and output brotli compressed size
+# @1-/minify_size : Minify JavaScript and report Brotli-compressed size
 
-- [@1-/minify_size : Minify JS and output brotli compressed size](#1-minify_size-minify-js-and-output-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-使用演示)
   - [3. 设计思路](#3-设计思路)
@@ -101,8 +106,12 @@ This library is developed by [WebC.site](https://webc.site).
 
 ## 1. 功能介绍
 
-压缩指定目录中的 JavaScript 文件，并计算经 Brotli 算法压缩后的体积。
-用于评估 JavaScript 库在支持 Brotli 的网络传输环境下的实际传输体积。
+评估 JavaScript 库在支持 Brotli 的网络传输环境下的实际传输体积。对指定目录中所有 `.js` 文件执行以下操作：
+
+- 使用 `oxc-minify`（Rust 实现）进行语法感知压缩
+- 将压缩后代码编码为 UTF-8 字节流
+- 使用 Node.js 内置 `node:zlib.brotliCompress` 计算 Brotli 压缩后字节长度
+- 汇总各文件大小，并计算整体打包压缩后大小
 
 ## 2. 使用演示
 
@@ -118,7 +127,7 @@ npm install @1-/minify_size
 npm install -g @1-/minify_size
 ```
 
-运行命令：
+运行命令（指定待分析的目录）：
 
 ```bash
 minify_size ./src
@@ -127,16 +136,16 @@ minify_size ./src
 输出示例：
 
 ```
-_.js    400
-file.js 250
-合计    650
+_.js                400
+file.js             250
+整体打包压缩后大小  650
 ```
 
 ## 3. 设计思路
 
-系统执行流程如下：
+系统执行流程如下（垂直 Mermaid 流程图）：
 
-![](https://fastly.jsdelivr.net/gh/webc-fs/-@Eg/nKfDG6I2Cy7wB6zHgcjA.svg)
+![](https://fastly.jsdelivr.net/gh/webc-fs/-@ko/Gf_-AqDa7IeLBsyqvTSg.svg)
 
 ## 4. 技术栈
 
@@ -163,6 +172,7 @@ src/
 
 Brotli 由 Google 的 Jyrki Alakuijala 和 Zoltán Szabadka 于 2013 年开发。它最初被设计用于压缩网页字体，后来发展为通用压缩算法，用于优化网页传输，并成为行业标准（RFC 7932）。
 
+
 ## 关于
 
 本库由 [WebC.site](https://webc.site) 开发。

package/_.js

@@ -1,45 +1,58 @@
-import { readdir } from "node:fs/promises";
 import { join } from "node:path";
+import { promisify } from "node:util";
+import { brotliCompress } from "node:zlib";
 import Table from "cli-table3";
+import { FILE } from "@1-/walk";
+import walkRelIgnore from "@1-/walk/walkRelIgnore.js";
+import utf8e from "@3-/utf8";
 import minify from "./file.js";
 
-const NO_BORDER = {
-  top: "",
-  "top-mid": "",
-  "top-left": "",
-  "top-right": "",
-  bottom: "",
-  "bottom-mid": "",
-  "bottom-left": "",
-  "bottom-right": "",
-  left: "",
-  "left-mid": "",
-  mid: "",
-  "mid-mid": "",
-  right: "",
-  "right-mid": "",
-  middle: " ",
-};
+const BROTLI = promisify(brotliCompress),
+  TABLE_STYLE = { "padding-left": 0, "padding-right": 0 },
+  NO_BORDER = {
+    top: "",
+    "top-mid": "",
+    "top-left": "",
+    "top-right": "",
+    bottom: "",
+    "bottom-mid": "",
+    "bottom-left": "",
+    "bottom-right": "",
+    left: "",
+    "left-mid": "",
+    mid: "",
+    "mid-mid": "",
+    right: "",
+    "right-mid": "",
+    middle: " ",
+  };
 
+// dir 目录路径。返回整体打包压缩后大小
 export default async (dir) => {
-  const files = await readdir(dir, { withFileTypes: true }),
-    js = files.filter((file) => file.isFile() && file.name.endsWith(".js")),
-    sizes = await Promise.all(
-      js.map(async ({ name }) => {
-        const file_path = join(dir, name),
-          size = await minify(file_path);
-        return [name, size];
-      }),
+  // 收集并排序所有 js 文件
+  const files = [];
+  await walkRelIgnore(dir, (kind, rel_path) => {
+    if (kind === FILE && rel_path.endsWith(".js")) {
+      files.push(rel_path);
+    }
+  });
+  files.sort();
+
+  // 压缩各文件并计算整体打包压缩后大小
+  const sizes = await Promise.all(
+      files.map(async (rel_path) => [rel_path, ...(await minify(join(dir, rel_path)))]),
     ),
-    total = sizes.reduce((acc, [, size]) => acc + size, 0),
+    total_size = files.length
+      ? (await BROTLI(utf8e(sizes.map(([, , mini]) => mini).join("")))).length
+      : 0,
     table = new Table({
       chars: NO_BORDER,
-      style: { "padding-left": 0, "padding-right": 0 },
+      style: TABLE_STYLE,
     });
 
-  sizes.forEach(([name, size]) => table.push([name, size]));
+  sizes.forEach(([rel_path, size]) => table.push([rel_path, size]));
 
-  table.push(["合计", total]);
+  table.push(["整体打包压缩后大小", total_size]);
   console.log(table.toString());
-  return total;
+  return total_size;
 };

package/file.js

@@ -5,15 +5,15 @@ import { brotliCompress } from "node:zlib";
 import utf8e from "@3-/utf8";
 import { basename } from "node:path";
 
-const BROTLI = promisify(brotliCompress);
+const BROTLI = promisify(brotliCompress),
+  MINIFY_OPT = {
+    compress: { target: "esnext" },
+    codegen: { removeWhitespace: true },
+  };
 
-// file_path: 文件路径；返回 minify 且 brotli 压缩后的字节数
+// file_path 压缩文件路径。返回 [brotli压缩后大小, 压缩后代码]
 export default async (file_path) => {
   const code = read(file_path),
-    { code: mini } = minifySync(basename(file_path), code, {
-      compress: { target: "esnext" },
-      codegen: { removeWhitespace: true },
-    }),
-    zip = await BROTLI(utf8e(mini));
-  return zip.length;
+    { code: mini } = minifySync(basename(file_path), code, MINIFY_OPT);
+  return [(await BROTLI(utf8e(mini))).length, mini];
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@1-/minify_size",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Minify JS and output brotli compressed size | 压缩 JS 并输出 brotli 压缩后大小",
   "keywords": [
     "br",
@@ -25,6 +25,7 @@
     "./*": "./*"
   },
   "dependencies": {
+    "@1-/walk": "^0.1.1",
     "@3-/read": "^0.1.4",
     "@3-/utf8": "^0.1.1",
     "cli-table3": "^0.6.5",