[pull] main from NSNanoCat:main

.github/workflows/release-package-to-npm.yml

@@ -6,23 +6,13 @@ on:
     tags:
       - "v*" # Push events to matching v*, i.e. v1.0, v20.15.10
 
-jobs:
-  build:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
-        with:
-          node-version: 16
-      - run: npm ci
-      - run: npm test
+permissions:
+  id-token: write # Required for OIDC
+  contents: read
 
-  publish-gpr:
-    needs: build
+jobs:
+  publish:
     runs-on: ubuntu-latest
-    permissions:
-      packages: write
-      contents: read
     steps:
       - uses: actions/checkout@v4
       - name: Update local package.json version from release tag
@@ -33,9 +23,9 @@ jobs:
           ignore-semver-check: "false" # If set to "true", will not check if the version number is a valid semver version.
       - uses: actions/setup-node@v4
         with:
-          node-version: 16
-          registry-url: 'https://registry.npmjs.org'
+          node-version: "24"
+          registry-url: "https://registry.npmjs.org"
       - run: npm ci
+      - run: npm run build --if-present
+      - run: npm test
       - run: npm publish --access public
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

CHANGELOG.md

@@ -0,0 +1,86 @@
+# Changelog
+
+变更日志
+
+All notable changes to this project will be documented in this file.
+
+项目中的所有重要变更都会记录在此文件中。
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
+
+格式参考 [Keep a Changelog](https://keepachangelog.com/en/1.1.0/)。
+
+## [2.1.6] - 2026-02-24
+
+### Fixed / 修复
+- `fix(Storage)`: improve `removeItem` / `clear` behavior in Node.js environment; 完善 Node.js 环境下 `removeItem` / `clear` 方法（`47de721`）。
+
+### Added / 新增
+- `feat(getStorage)`: export helper functions with type definitions and docs updates; 导出 `getStorage` 辅助函数并同步类型定义与文档（`ccd91f3`）。
+
+### Changed / 变更
+- `refactor(getStorage)`: rename `string2array` to `value2array` and switch parsing logic to `switch`; 重命名 `string2array` 为 `value2array`，并将解析逻辑调整为 `switch` 语法（`4628920`）。
+
+## [2.1.5] - 2026-02-21
+
+### Changed / 变更
+- `chore(types)`: add local declarations for `@nsnanocat/util`; 新增本地类型声明并发布类型入口（`3071c12`）。
+
+### Docs / 文档
+- `docs`: update changelog order and reflect export change; 更新 changelog 顺序并反映导出变更（`5a5994a`）。
+
+## [2.1.4] - 2026-02-20
+
+### Fixed / 修复
+- `fix(getStorage)`: Accept lowercase `boxjs` as alias for `BoxJs`; 支持小写别名 `boxjs`。（`45f5cd8`）
+- `fix(getStorage)`: Treat undefined `$argument.Storage` the same as `PersistentStore`; 将未定义的 `.Storage` 视为 `PersistentStore` 并更新文档。（`99869a0`）
+
+### Docs / 文档
+- `docs(getStorage)`: Update README/JSDoc to mention undefined `.Storage` defaulting and adjust import example; 在 README/JSDoc 中说明当 `$argument.Storage` 未定义时视为 `PersistentStore`，并修正导入示例。
+
+## [2.1.3] - 2026-02-20
+
+### Docs / 文档
+- `docs(getStorage)`: clarify Settings/Configs/Caches merge; update JSDoc/README/CHANGELOG (commit 6bccb00)。
+
+## [2.1.2] - 2026-02-20
+
+### Fixed / 修复
+- `fix(argument)`: Normalize `globalThis.$argument` and guard `null`; 标准化 `globalThis.$argument` 并处理 `null` 场景（`c475e76`）。
+- `fix(getStorage)`: Include `$argument` in merge flow with conditional handling; 修复合并流程以包含 `$argument` 并增加条件控制（`3a1c8bb`）。
+- `fix(getStorage)`: Add merge source control by `$argument.Storage`; 支持通过 `$argument.Storage` 控制合并来源（`8a59892`）。
+- `fix(getStorage)`: Replace `BoxJs` merge source naming/usage with `PersistentStore`; 将合并来源命名/实现统一为 `PersistentStore`（`5fa69e4`）。
+- `fix(Storage)`: Add Surge `removeItem` support via `$persistentStore.write(null, keyName)`; 为 Surge 增加 `removeItem` 删除支持（`23ebecb`）。
+
+### Changed / 变更
+- `refactor(getStorage)`: Rename `Store` to `Root` and align debug output; 重命名 `Store` 为 `Root` 并同步调试输出字段（`570a75c`）。
+- `refactor(getStorage)`: Centralize `Settings` merge controlled by `$argument.Storage`; ensure `Configs`/`Caches` are merged per-profile (`names`)（`17747ae`）。
+- `refactor(getStorage)`: switch to a default export instead of named; 改用默认导出（`export default`）。
+
+### Docs / 文档
+- Sync README/JSDoc with recent behavior changes for `argument` / `getStorage` / `Storage`; 同步 `argument` / `getStorage` / `Storage` 的 README 与 JSDoc 说明（`2b13601`）。
+- `docs(getStorage)`: Document aliases for `$argument.Storage` (`Argument` / `$argument`, `PersistentStore` / `BoxJs` / `$persistentStore`) and correct merge-order in README/JSDoc; 为 `$argument.Storage` 增加别名说明并修正 README 中的合并顺序说明。
+- `docs(getStorage)`: Update import example and JSDoc to reflect default export; 更新导入示例及 JSDoc 以反映默认导出变更。
+
+## [2.1.1] - 2026-02-20
+
+### Changed / 变更
+- `refactor(getStorage)`: remove default export and clarify usage boundaries; 改为无默认导出并补充使用边界说明（`4105cf2`）。
+- `feat(index)`: re-export `getStorage` from entry point and update docs/tests; 从入口导出并更新文档/测试（`b0a1bd9`）。
+
+### Docs / 文档
+- `docs`: improve installation/update guidance for newcomers; 优化安装与更新指引面向新手（`ce7c81a`）。
+- `docs`: enhance polyfill descriptions and links; 完善 polyfill 文档说明与引用链接（`b817c07`）。
+- `docs`: fill out README and JSDoc comments; 补充 README 与 JSDoc 注释说明（`5c5f1f3`）。
+
+
+
+
+
+[2.1.6]: https://github.com/NSNanoCat/util/compare/v2.1.5...v2.1.6
+[2.1.5]: https://github.com/NSNanoCat/util/compare/v2.1.4...v2.1.5
+[2.1.4]: https://github.com/NSNanoCat/util/compare/v2.1.3...v2.1.4
+[2.1.3]: https://github.com/NSNanoCat/util/compare/v2.1.2...v2.1.3
+[2.1.2]: https://github.com/NSNanoCat/util/compare/v2.1.1...v2.1.2
+[2.1.1]: https://github.com/NSNanoCat/util/compare/v2.1.0...v2.1.1
+