@1-/minify_size 0.1.0

package/README.md

@@ -0,0 +1,192 @@
+[English](#en) | [中文](#zh)
+
+---
+
+<a id="en"></a>
+# @1-/minify_size : Minify JS and output zstd compressed size
+
+- [@1-/minify_size : Minify JS and output zstd compressed size](#1-minify_size-minify-js-and-output-zstd-compressed-size)
+  - [1. Introduction](#1-introduction)
+  - [2. Usage Demo](#2-usage-demo)
+  - [3. Design Concept](#3-design-concept)
+  - [4. Tech Stack](#4-tech-stack)
+  - [5. Code Structure](#5-code-structure)
+  - [6. History](#6-history)
+  - [About](#about)
+
+## 1. Introduction
+
+Minifies JS files in a specified directory and calculates their size after zstd compression.
+Evaluates JS library size under modern transmission environments supporting Zstd.
+
+## 2. Usage Demo
+
+Install dependency:
+
+```bash
+npm install @1-/minify_size
+```
+
+or install globally:
+
+```bash
+npm install -g @1-/minify_size
+```
+
+Run command:
+
+```bash
+minify_size ./src
+```
+
+Example output:
+
+```
+_.js    400
+file.js 250
+Total   650
+```
+
+## 3. Design Concept
+
+Execution process:
+
+![](https://fastly.jsdelivr.net/gh/webc-fs/-@n-/Jsm3fz4EQSGdooVgJJCw.svg)
+
+## 4. Tech Stack
+
+- **Runtime**: Node.js / Bun
+- **JS Minifier**: `oxc-minify` (JavaScript minifier implemented in Rust)
+- **Zstd Engine**: `@mongodb-js/zstd` (Zstandard binding)
+- **Arg Parser**: `yargs`
+- **Encoding**: `@3-/utf8` (TextEncoder-based UTF-8 encoding)
+- **Output Formatting**: `cli-table3` (Formatted tabular output)
+- **File System**: Node.js built-in `fs.promises`
+- **Dependency Management**: npm
+- **Testing**: bun:test
+
+## 5. Code Structure
+
+```
+src/
+├── cli.js     # CLI entrypoint, parses directory parameter and invokes main function
+├── _.js       # Directory traversal, concurrent file processing, aggregation and formatted output
+└── file.js    # Single file processing: reading, oxc-minify compression, zstd compression and size calculation
+```
+
+Key configuration:
+- oxc-minify: `target: "esnext"`, `removeWhitespace: true`
+- zstd compression level: `3` (default)
+- Input validation: Directory parameter required
+- Error handling: Proper exit codes for missing parameters
+
+## 6. History
+
+Zstandard (Zstd) was developed by Yann Collet at Facebook in 2015. Yann became interested in data compression while writing games for the HP 48 graphing calculator. He previously developed the LZ4 compression algorithm, which features high decompression speed. Subsequently, he designed Zstd to balance compression ratio and speed, which later became an industry standard (RFC 8478).
+
+## About
+
+This library is developed by [WebC.site](https://webc.site).
+
+[WebC.site](https://webc.site): A new paradigm of web development for AI
+
+
+---
+
+<a id="zh"></a>
+# @1-/minify_size : 压缩 JS 并输出 zstd 压缩后大小
+
+- [@1-/minify_size : 压缩 JS 并输出 zstd 压缩后大小](#1-minify_size-压缩-js-并输出-zstd-压缩后大小)
+  - [1. 功能介绍](#1-功能介绍)
+  - [2. 使用演示](#2-使用演示)
+  - [3. 设计思路](#3-设计思路)
+  - [4. 技术栈](#4-技术栈)
+  - [5. 代码结构](#5-代码结构)
+  - [6. 历史故事](#6-历史故事)
+  - [关于](#关于)
+
+## 1. 功能介绍
+
+对指定目录中的 JS 文件进行压缩，并计算经 zstd 算法压缩后的体积。
+用于评估 JS 库在支持 Zstd 的传输环境下的网络传输体积指标。
+
+## 2. 使用演示
+
+安装依赖：
+
+```bash
+npm install @1-/minify_size
+```
+
+或全局安装：
+
+```bash
+npm install -g @1-/minify_size
+```
+
+运行命令：
+
+```bash
+minify_size ./src
+```
+
+输出示例：
+
+```
+_.js    400
+file.js 250
+合计    650
+```
+
+## 3. 设计思路
+
+系统执行流程如下：
+
+```mermaid
+graph TD
+    A[CLI 输入目录] --> B[读取目录下所有 JS 文件]
+    B --> C[并发处理每个文件]
+    C --> D[使用 oxc-minify 进行压缩]
+    D --> E[将压缩代码转换为 UTF-8 编码]
+    E --> F[通过 zstd 算法压缩 level 3]
+    F --> G[计算压缩后字节长度]
+    G --> H[使用 cli-table3 格式化输出结果]
+```
+
+## 4. 技术栈
+
+- **Runtime**: Node.js / Bun
+- **JS Minifier**: `oxc-minify` (Rust 实现的 JavaScript 压缩器)
+- **Zstd Engine**: `@mongodb-js/zstd` (Zstandard 绑定实现)
+- **Arg Parser**: `yargs`
+- **Encoding**: `@3-/utf8` (TextEncoder-based UTF-8 encoding)
+- **Output Formatting**: `cli-table3` (Formatted tabular output)
+- **File System**: Node.js built-in `fs.promises`
+- **Dependency Management**: npm
+- **Testing**: bun:test
+
+## 5. 代码结构
+
+```
+src/
+├── cli.js     # CLI 命令行入口，解析目录参数并调用主函数
+├── _.js       # 目录遍历、并发调度文件处理、汇总统计并格式化输出
+└── file.js    # 单文件处理：读取、oxc-minify 压缩、zstd 压缩及大小计算
+```
+
+核心配置：
+- oxc-minify: `target: "esnext"`, `removeWhitespace: true`
+- zstd compression level: `3` (default)
+- Input validation: Directory parameter required
+- Error handling: Proper exit codes for missing parameters
+
+## 6. 历史故事
+
+Zstandard（Zstd）由 Yann Collet 于 2015 年在 Facebook 主导开发。Yann 在为 HP 48 图形计算器编写游戏时对数据压缩产生兴趣。他此前开发了 LZ4 压缩算法，其解压速度极快。此后，他设计出 Zstd，均衡了压缩率与运行速度，并成为行业标准（RFC 8478）。
+
+## 关于
+
+本库由 [WebC.site](https://webc.site) 开发。
+
+[WebC.site](https://webc.site) : 面向人工智能的网站开发新范式
+

package/_.js

@@ -0,0 +1,45 @@
+import { readdir } from "node:fs/promises";
+import { join } from "node:path";
+import Table from "cli-table3";
+import fileMinify 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: " ",
+};
+
+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 fileMinify(file_path);
+        return [name, size];
+      }),
+    ),
+    table = new Table({
+      chars: NO_BORDER,
+      style: { "padding-left": 0, "padding-right": 0 },
+    });
+
+  sizes.forEach(([name, size]) => table.push([name, size]));
+
+  const total = sizes.reduce((acc, [, size]) => acc + size, 0);
+  table.push(["合计", total]);
+  console.log(table.toString());
+  return total;
+};

package/cli.js

@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+import yargs from "yargs";
+import { hideBin } from "yargs/helpers";
+import minify from "./_.js";
+
+const { dir } = yargs(hideBin(process.argv))
+  .usage("Usage: $0 <dir>")
+  .command("$0 <dir>", "minify js and show zstd size", (y) => {
+    y.positional("dir", {
+      describe: "directory to minify",
+      type: "string",
+    });
+  })
+  .demandCommand(1, "You must specify a directory")
+  .help()
+  .alias("h", "help").argv;
+
+await minify(dir);

package/file.js

@@ -0,0 +1,15 @@
+import read from "@3-/read";
+import { minifySync } from "oxc-minify";
+import { compress } from "@mongodb-js/zstd";
+import utf8e from "@3-/utf8";
+import { basename } from "node:path";
+
+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 compress(utf8e(mini), 3);
+  return zip.length;
+};

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@1-/minify_size",
+  "version": "0.1.0",
+  "description": "Minify JS and output zstd compressed size | 压缩 JS 并输出 zstd 压缩后大小",
+  "keywords": [
+    "compression",
+    "minify",
+    "size",
+    "zstd"
+  ],
+  "homepage": "https://github.com/webc-site/npm/tree/main/minify_size",
+  "license": "MulanPSL-2.0",
+  "author": "x-at-01@googlegroups.com",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/webc-site/npm.git"
+  },
+  "bin": {
+    "minify_size": "./cli.js"
+  },
+  "type": "module",
+  "exports": {
+    ".": "./_.js",
+    "./*": "./*"
+  },
+  "dependencies": {
+    "@3-/read": "^0.1.4",
+    "@3-/utf8": "^0.1.1",
+    "@mongodb-js/zstd": "^7.0.0",
+    "cli-table3": "^0.6.5",
+    "oxc-minify": "^0.135.0",
+    "yargs": "^18.0.0"
+  },
+  "trustedDependencies": [
+    "@mongodb-js/zstd"
+  ]
+}