Enhance storage features, update CI, and improve documentation

.github/workflows/release.yml

@@ -45,10 +45,13 @@ jobs:
       - name: Use Node.js
         uses: actions/setup-node@v4
         with:
-          node-version: 20
+          node-version: 22
           cache: 'npm'
-          registry-url: 'https://registry.npmjs.org'
-          always-auth: true
+
+      - name: Update npm
+        run: |
+          npm install -g npm@11.7.0
+          npm -v
 
       - name: Install dependencies
         run: npm ci
@@ -63,8 +66,6 @@ jobs:
           DEBUG: release-it:*,@release-it/*
           HUSKY: 0
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
         run: |
           VERSION_ARG=""
           if [ -n "${{ inputs.version }}" ]; then
@@ -83,7 +84,7 @@ jobs:
           fi
           NPM_TAG_ARG="--npm.tag=${NPM_TAG}"
 
-          npm run release -- --ci $PREID_ARG $NPM_TAG_ARG $VERSION_ARG
+          npx release-it --ci $PREID_ARG $NPM_TAG_ARG $VERSION_ARG
 
       - name: Sync main → develop
         uses: devmasx/merge-branch@v1.4.0

.gitignore

@@ -16,3 +16,4 @@ stats.html
 .tool-versions
 .cache
 *-stats.txt
+.npmrc

.husky/pre-commit

@@ -1,5 +1,10 @@
 #!/usr/bin/env sh
 
-# Husky pre-commit hook: format and run related tests on staged files
+# Husky pre-commit hook: format and run related tests on staged files.
+# We intentionally don't hide partially staged files so formatter changes are
+# added to the same commit instead of being restored as unstaged changes.
 
-npx --no -- lint-staged
+set -eu
+
+npx --no -- lint-staged --no-hide-partially-staged
+git update-index --again

.mailmap

@@ -0,0 +1,2 @@
+Addon Stack <191148085+addon-stack@users.noreply.github.com> <addonbonedev@gmail.com>
+Addon Stack <addon-stack@users.noreply.github.com> <addonbonedev@gmail.com>

.release-it.cjs

@@ -97,7 +97,7 @@ const types = new Map([
     ["perf", "⚡️ Performance Improvements"],
     ["refactor", "🛠️ Refactoring"],
     ["docs", "📝 Documentation"],
-    ["test", "Tests"],
+    ["test", "🧪 Tests"],
     ["build", "🏗️ Build System"],
     ["ci", "🤖 CI"],
     ["chore", "🧹 Chores"],
@@ -139,8 +139,11 @@ module.exports = () => {
 
         npm: {
             publish: true,
+            skipChecks: true,
+            provenance: true,
+            access: "public",
+            registry: "https://registry.npmjs.org/",
             versionArgs: ["--no-git-tag-version"],
-            publishArgs: ["--provenance", "--access", "public"],
         },
 
         plugins: {