@flun/nodejs-mobile-gyp 1.1.3 → 1.2.0

package/CHANGELOG.md

@@ -1,34 +1,31 @@
 # 变更日志
 
-## [1.1.3] - 2026-10-20 13:55
-### 修复
-- 一些细节优化
-
-## [1.1.2] - 2026-09-28 21:49
-
-### 修复
-
-- **action 目标的路径分隔符**：`make.py` 中 `self.output` 由 `ComputeOutput` 产出，Windows 上带反斜杠（如 `$(obj).target\../node-addon-api\foo.stamp`），导致 `sh` 把 `\.` 当转义、目录不存在。现统一转正斜杠；非 Windows 平台为 no-op。
-
-## [1.1.1] - 2026-09-28 09:23
+## [1.2.0] - 2026-11-02 16:05
+### 新增
+- 帮助文本重写为中文三层结构:`用法:` 为 0 级,`命令:`/`选项:` 缩进 2,各条目缩进 4;
+  命令含别名 `ls`/`rm`,选项简写在前、完整写法置于行尾注释;末尾仅输出版本号行;
+- 无参数、`help`、`-h`、`--help` 均打印完整帮助并以 exit 0 退出;
+- 帮助文本按语义着色:`用法:` 用 `chalk.blueBright`,分组名用 `chalk.cyan`,命令与选项名用 `chalk.cyanBright`,
+  说明文字用 `chalk.gray`,末尾版本号用 `chalk.hex('#B8860B')`;非 TTY 下自动关闭颜色,不向管道泄漏 ANSI;
+- 未知命令提示着色:错误标记用 `chalk.red`,命令名用 `chalk.yellow`;
 
 ### 修复
-
-- **Windows 路径分隔符**：gyp 生成的 Makefile 中，`Absolutify` 与 `self.output` 产出的路径带 Windows 反斜杠（如 `src\bufferutil.o`），导致 `sh` / `sed` / `make` 解析失败。现在统一转成正斜杠；该改动在非 Windows 平台上是 no-op。
-- **`mkdir` 目标路径**：`mkdir -p "$(dir $@)"` 在 Windows 上因路径尾部反斜杠被 `sh` 当转义符，导致目录未创建、编译器无法写产物。新增 `slashpath` 辅助函数，把路径转正斜杠后再传给 `mkdir`。
-- **超长路径依赖**：Windows 下 Makefile 会因 gypi 依赖路径超过 260 字符而报 `No rule to make target`。现在过滤掉 `node_modules` 中的此类依赖——仅影响 Makefile 自动重新生成，不影响编译。
+- 未知命令改为输出 `✗ 未知命令: xxx` + 一个空行 + 完整帮助,并以 exit 1 退出;
+  此前未知参数不报错,静默继续;
+- `-h` 此前被忽略,现作为帮助入口;该行为变更可能影响依赖旧行为的脚本;
+- 帮助文本命令区与选项区说明列错位:命令区原补到显示列 17,选项区 23,现统一补到 23;
+  补白改为按显示宽度计算,中日韩全角字符按 2 列计,此前按码元计导致含中文的选项名整体左移;
+- `package.json` 的 `dependencies` 补声明 `chalk`;`lib/node-gyp.js` 已引用该模块,
+  此前未声明,从 npm 安装后缺少依赖会导致 `--help` 直接报错;
 
 ### 文档
+- `lib/` 下 12 个 js 去除 BOM;`维护.md`、`package.json`、`lib/util.js` 换行符由 CRLF 改为 LF;
 
-全面核对并修正 README，消除前后矛盾、过时表述与硬编码：
+## [1.1.4] - 2026-10-24 09:20
+### 优化
+- 项目标点已改为以英文标点为主;
+- 行宽改为以 123 为主,部分超宽表格改为了列表;
 
-- **系统要求**：
-  - iOS 构建前置工具从「Command Line Tools」修正为「**完整 Xcode**」——`xcodebuild` 必须完整 Xcode，CLT 单独不够；
-  - Visual Studio 从「仅 VS2026」放宽为「**VS2019 / VS2022 / VS2026**」——VS2017 及更早受 Node 版本上限限制，故不在支持范围；VS2026 为已验证版本；
-  - Android NDK 从「27.x」修正为「**23–27**」，与实测验证范围一致；
-  - Git for Windows 的说明从「提供 `sh.exe` / `printf` / `xargs`」扩写为「**自带整套 MSYS2 POSIX 工具集**」，避免读者低估其必要性。
-- **自动探测**：
-  - 「无需手动配置」改为「**无需手动指定路径**（前提：工具已安装）」，区分「必须安装」与「位置自动定位」；
-  - 「POSIX shell（`sh.exe`）」项改为「**Git for Windows 的 `usr/bin` 目录**（以 `sh.exe` 是否存在作为判据）」，与实际探测逻辑一致。
-- **顶部引言**：适用范围从仅官方 `nodejs-mobile` 改为「官方及兼容的社区发行版（如 OpenFlun/nodejs-mobile）」。
-- 修正若干失效链接。
+## [1.1.3] - 2026-10-20 13:55
+### 修复
+- 一些细节优化

package/LICENSE

@@ -1,12 +1,17 @@
 ISC 许可证 (ISC License)
 
-版权所有 (c) 2026, flun <open@flun.top>
+Copyright (c) 2026, flun <open@flun.top>
 
-特此免费授予任何获得本软件及相关文档文件（“软件”）副本的人,不受限制地处理本软件的权利,包括但不限于使用、复制、修改、合并、发布、分发、再许可和/或销售本软件副本的权利,并允许向其提供本软件的人这样做,但须满足以下条件：
+特此免费授予任何获得本软件及相关文档文件("软件")副本的人,不受限制地处理本软件的权利,
+包括但不限于使用、复制、修改、合并、发布、分发、再许可和/或销售本软件副本的权利,
+并允许向其提供本软件的人这样做,但须满足以下条件:
 
 上述版权声明和本许可声明应包含在本软件的所有副本或重要部分中;
 
-本软件按“原样”提供,不作任何形式的明示或暗示的保证,包括但不限于适销性、特定用途的适用性和不侵权的保证;在任何情况下,作者或版权持有人均不对因本软件或本软件的使用或其他交易而产生的任何索赔、损害或其他责任负责,无论是合同之诉、侵权之诉还是其他行为之诉;
+本软件按"原样"提供,不作任何形式的明示或暗示的保证,
+包括但不限于适销性、特定用途的适用性和不侵权的保证;
+在任何情况下,作者或版权持有人均不对因本软件或本软件的使用或其它交易而产生的
+任何索赔、损害或其它责任负责,无论是合同之诉、侵权之诉还是其它行为之诉;
 
 ---
 
@@ -26,4 +31,4 @@ MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
 ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
 WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
 ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
-OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.