@1-/minify_size 0.1.4 → 0.1.6

package/README.md

@@ -6,67 +6,66 @@
 # @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 library transmission size under Brotli-enabled network environments. Processes all `.js` files in a specified directory by:
 
-- Bundling using `@1-/rolldown` (Rust-based JavaScript bundler wrapping rolldown v1.1.3)
-- UTF-8 encoding of the bundled code
-- Brotli compression via Node.js built-in `node:zlib.brotliCompress` to compute final byte length
-- Aggregation of per-bundle sizes and calculation of total bundled compressed size
+- 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 directory:
 
 ```bash
 minify_size ./src
 ```
 
-Example output:
+Output example:
 
 ```
-index.js              400
-utils.js              250
-Total bundled size    650
+650
 ```
 
-## 3. Design Concept
+## 3. Design
 
 Execution flow (vertical Mermaid diagram):
 
-![](https://fastly.jsdelivr.net/gh/webc-fs/-@mF/8IyEaPelxy8ant9q1lyA.svg)
+![](https://fastly.jsdelivr.net/gh/webc-fs/-@al/eo5PAnMMwP9cRbLWbHQg.svg)
 
-## 4. Tech Stack
+## 4. Technology Stack
 
-- **Runtime**: Node.js / Bun
-- **Bundler**: `@1-/rolldown` v0.1.7 (Rust-based JavaScript bundler wrapping rolldown v1.1.3)
-- **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)
-- **Output Formatting**: `cli-table3` v0.6.5 (Formatted tabular output)
-- **File Walking**: `@1-/walk` v0.1.1 (Directory traversal utility with concurrency control)
-- **Dependency Management**: npm
+- **Runtime**: Bun / Node.js
+- **Bundler**: `@1-/rolldown` v0.1.7 (Rust-based JavaScript bundler)
+- **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
@@ -74,12 +73,12 @@ Execution flow (vertical Mermaid diagram):
 ```
 src/
 ├── cli.js     # CLI entrypoint, parses directory parameter and invokes main function
-└── _.js       # Directory traversal, bundling, Brotli compression calculation and formatted output
+└── _.js       # Directory traversal, 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
 
@@ -94,38 +93,40 @@ 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 的网络传输环境下的实际传输体积。对指定目录中所有 `.js` 文件执行以下操作：
+- 使用 `@1-/rolldown`（Rust 实现的 JavaScript 打包器）进行打包
+- 使用 `@3-/utf8` TextEncoder 进行 UTF-8 编码
+- 使用 Node.js 内置 `node:zlib.brotliCompress` 进行 Brotli 压缩
+- 返回整体打包输出的压缩后字节长度
 
-- 使用 `@1-/rolldown`（Rust 实现的 JavaScript 打包器）进行打包和语法感知压缩
-- 将打包后代码编码为 UTF-8 字节流
-- 使用 Node.js 内置 `node:zlib.brotliCompress` 计算 Brotli 压缩后字节长度
-- 汇总各打包产物大小，并计算整体打包压缩后大小
+排除匹配 `/^(|\/)tests?(\/|$)/` 的测试文件和 `node_modules` 目录。
 
-## 2. 使用演示
+## 2. 使用方法
 
-安装依赖：
+本地安装：
 
 ```bash
 npm install @1-/minify_size
 ```
 
-或全局安装：
+全局安装：
 
 ```bash
 npm install -g @1-/minify_size
 ```
 
-运行命令（指定待分析的目录）：
+执行命令并指定目标目录：
 
 ```bash
 minify_size ./src
@@ -134,40 +135,37 @@ minify_size ./src
 输出示例：
 
 ```
-index.js              400
-utils.js              250
-整体打包压缩后大小    650
+650
 ```
 
 ## 3. 设计思路
 
-系统执行流程如下（垂直 Mermaid 流程图）：
+执行流程（垂直 Mermaid 流程图）：
 
-![](https://fastly.jsdelivr.net/gh/webc-fs/-@Cg/dFGhNxdolTp2uwIBl2vg.svg)
+![](https://fastly.jsdelivr.net/gh/webc-fs/-@yh/rGQ5Y3ZbsLqLF6zENpxQ.svg)
 
 ## 4. 技术栈
 
-- **Runtime**: Node.js / Bun
-- **Bundler**: `@1-/rolldown` v0.1.7 (Rust-based JavaScript bundler wrapping rolldown v1.1.3)
-- **Brotli Engine**: 内置 `node:zlib` (Brotli 压缩)
-- **Arg Parser**: `yargs` v18.0.0
-- **Encoding**: `@3-/utf8` v0.1.1 (TextEncoder-based UTF-8 encoding)
-- **Output Formatting**: `cli-table3` v0.6.5 (Formatted tabular output)
-- **File Walking**: `@1-/walk` v0.1.1 (Directory traversal utility with concurrency control)
-- **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. 历史故事
+## 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,50 +1,19 @@
-import { relative, join } from "node:path";
+import { join, isAbsolute } from "node:path";
 import { realpathSync } from "node:fs";
 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 bundle from "@1-/rolldown";
 
 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: " ",
-  },
   /*
   获取字符串 brotli 压缩后大小
   参数: str 待压缩字符串
   返回值: 字节数
   */
-  br = async (str) => (await BROTLI(utf8e(str))).length,
-  /*
-  输出打包大小表格
-  参数:
-  list 包含 [相对路径, 大小] 的数组
-  total 整体压缩后大小
-  */
-  show = (list, total) => {
-    const table = new Table({ chars: NO_BORDER, style: TABLE_STYLE });
-    list.forEach(([rel_path, size]) => table.push([rel_path, size]));
-    table.push(["整体打包压缩后大小", total]);
-    console.log(table.toString());
-  };
+  br = async (str) => (await BROTLI(utf8e(str))).length;
 
 /*
 打包并计算指定目录下 JS 文件压缩后大小
@@ -64,7 +33,6 @@ export default async (dir) => {
   });
 
   if (!files.length) {
-    show([], 0);
     return 0;
   }
 
@@ -74,18 +42,16 @@ export default async (dir) => {
     out_map[abs] = abs;
   });
 
-  const chunks = await bundle(input, {}, true, undefined, out_map),
-    sizes = (
-      await Promise.all(
-        chunks.map(async ([abs_out_path, code]) => [
-          relative(real_dir, abs_out_path),
-          await br(code),
-          code,
-        ]),
-      )
-    ).sort((a, b) => a[0].localeCompare(b[0])),
-    total_size = await br(sizes.map(([, , code]) => code).join(""));
-  show(sizes, total_size);
+  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(""));
 
   return total_size;
 };

package/cli.js

@@ -16,4 +16,4 @@ const { dir } = yargs(hideBin(process.argv))
   .help()
   .alias("h", "help").argv;
 
-await minify(dir);
+console.log(await minify(dir));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@1-/minify_size",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "Minify JS and output brotli compressed size | 压缩 JS 并输出 brotli 压缩后大小",
   "keywords": [
     "br",
@@ -28,7 +28,6 @@
     "@1-/rolldown": "^0.1.7",
     "@1-/walk": "^0.1.2",
     "@3-/utf8": "^0.1.1",
-    "cli-table3": "^0.6.5",
     "yargs": "^18.0.0"
   }
 }