v9.1.0

Author: typicode

bin.mjs renamed to bin.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import f, { writeFileSync as w } from 'fs'
-import i from './index.mjs'
+import i from './index.js'
 
 let p, a, n, s, o, d
 
@@ -15,7 +15,7 @@ if (a == 'init') {
 	w(n, JSON.stringify(o, 0, /\t/.test(s) ? '\t' : 2) + '\n')
 	p.stdout.write(i())
 	try { f.mkdirSync('.husky') } catch {}
-	w('.husky/pre-commit', p.env.npm_config_user_agent.split('/')[0] + ' test\n')
+	w('.husky/pre-commit', p.env.npm_config_user_agent?.split('/')[0] ?? 'npm' + ' test\n')
 	p.exit()
 }
 

docs/.vitepress/config.mts

@@ -12,6 +12,7 @@ export default defineConfig({
     // outline: [2, 3],
     socialLinks: [
       { icon: 'github', link: 'https://github.com/typicode/husky' },
+      { icon: 'twitter', link: 'https://x.com/typicode' }
     ],
     carbonAds: {
       code: 'CWYDP53L',
@@ -26,14 +27,10 @@ export default defineConfig({
     ],        
     nav: [
       {
-        text: 'v9.0.1',
-        items: [
-          {
-            text: 'Changelog',
-            link: 'https://github.com/typicode/husky/releases/tag/v9.0.1'
-          }
-        ]
-      }
+        text: 'Changelog',
+        link: 'https://github.com/typicode/husky/releases/tag/v9.0.1'
+      },
+      { text: 'Sponsor', link: 'https://github.com/sponsors/typicode' }
     ]
   },
   locales: {

docs/get-started.md

@@ -59,5 +59,25 @@ git commit -m "Keep calm and commit"
 # test script will run every time you commit
 ```
 
+## A few words
+
+### Scripting
+
+While most of the time, you'll just run a few `npm run` or `npx` commands in your hooks, you can also script hooks using POSIX shell for custom workflows.
+
+For example, here's how you can lint your staged files on each commit with only two lines of shell code:
+
+```shell
+# .husky/pre-commit
+prettier $(git diff --cached --name-only --diff-filter=ACMR | sed 's| |\\ |g') --write --ignore-unknown
+git update-index --again
+```
+
+See also [lint-staged](https://github.com/lint-staged/lint-staged) if you need more.
+
+### Disabling hooks
+
+Husky doesn't force Git hooks and can be globally disabled if wished. They can be made opt-in as well.
+
 _For manual setup and more information, see the [How To](how-to) section._
 

docs/index.md

@@ -26,6 +26,7 @@ And more:
 - Adheres to Git's native hook organization
 - Aligns with [npm](https://docs.npmjs.com/cli/v10/using-npm/scripts#best-practices) best practices using `prepare` script
 - Opt-in/opt-out options
+- Can be globally disabled
 - User-friendly error messages
 
 ## Sponsors

docs/migrate-from-v4.md

@@ -35,10 +35,7 @@ If you were calling locally installed binaries, **you need to run them via your
 ```
 
 ```shell [.husky/pre-commit (v9)]
-# ...
-npx --no jest
-# or
-yarn jest
+jest
 ```
 
 :::
@@ -56,10 +53,7 @@ yarn jest
 ```
 
 ```shell [.husky/commit-msg (v9)]
-# ...
-npx --no -- commitlint --edit $1
-# or
-yarn commitlint --edit $1
+commitlint --edit $1
 ```
 
 :::
@@ -68,5 +62,4 @@ Other environment variables changes:
 
 - `HUSKY_SKIP_HOOKS` is replaced by `HUSKY`.
 - `HUSKY_SKIP_INSTALL` is replaced by `HUSKY`.
-- `HUSKY_GIT_PARAMS` is removed. Instead Git parameters should be used directly in scripts (e.g. `$1`).
-- `PATH` for locally installed tools is not automatically set anymore. You'll need to use your package manager to run them.
+- `HUSKY_GIT_PARAMS` is removed. Instead Git parameters should be used directly in scripts (e.g. `$1`).

docs/sponsorkit/sponsors.svg

@@ -1,20 +1,27 @@
 #!/usr/bin/env sh
+# shellcheck disable=SC1090
 [ "$HUSKY" = "2" ] && set -x
-h="${0##*/}"
-s="${0%/*/*}/$h"
+n=$(basename "$0")
+s=$(dirname "$(dirname "$0")")/$n
 
 [ ! -f "$s" ] && exit 0
 
-for f in "${XDG_CONFIG_HOME:-$HOME/.config}/husky/init.sh" "$HOME/.huskyrc"; do
-	# shellcheck disable=SC1090
-	[ -f "$f" ] && . "$f"
-done
+if [ -f "$HOME/.huskyrc" ]; then
+	echo "husky - DEPRECATED: '~/.huskyrc' is deprecated, please move your code to ~/.config/husky/init.sh"
+fi
+i="${XDG_CONFIG_HOME:-$HOME/.config}/husky/init.sh"
+[ -f "$i" ] && . "$i"
 
 [ "${HUSKY-}" = "0" ] && exit 0
 
-sh -e "$s" "$@"
-c=$?
-
-[ $c != 0 ] && echo "husky - $h script failed (code $c)"
-[ $c = 127 ] && echo "husky - command not found in PATH=$PATH"
-exit $c
+c=0
+h() {
+	[ $c = 0 ] && return
+	[ $c != 0 ] && echo "husky - $n script failed (code $c)"
+	[ $c = 127 ] && echo "husky - command not found in PATH=$PATH"
+	exit 1
+}
+trap 'c=$?; h' EXIT
+set -e
+PATH=node_modules/.bin:$PATH
+. "$s"

husky

@@ -18,6 +18,6 @@ export default (d = '.husky') => {
 	w(_('.gitignore'), '*')
 	f.copyFileSync(new URL('husky', import.meta.url), _('h'))
 	l.forEach(h => w(_(h), `#!/usr/bin/env sh\n. "\${0%/*}/h"`, { mode: 0o755 }))
-	w(_('husky.sh'), '')
+	w(_('husky.sh'), 'echo "husky - DEPRECATED `#!/usr/bin/env sh` and `. "$(dirname -- "$0")/_/husky.sh"` lines in hooks are deprecated, you can remove them safely for even simpler scripts"')
 	return ''
 }

index.d.mts renamed to index.d.ts

@@ -1,6 +1,7 @@
 {
 	"name": "husky",
 	"version": "9.0.11",
+	"type": "module",
 	"description": "Modern native Git hooks",
 	"keywords": [
 		"git",
@@ -15,9 +16,9 @@
 	"license": "MIT",
 	"author": "typicode",
 	"bin": {
-		"husky": "bin.mjs"
+		"husky": "bin.js"
 	},
-	"exports": "./index.mjs",
+	"exports": "./index.js",
 	"engines": {
 		"node": ">=18"
 	}

index.mjs renamed to index.js

@@ -8,7 +8,8 @@ sh test/3_from-sub-dir.sh
 sh test/4_not-git-dir.sh
 sh test/5_git_command_not_found.sh
 sh test/6_command_not_found.sh
-sh test/7_set_u.sh
-sh test/8_husky_0.sh
-sh test/9_init.sh
-sh test/10_time.sh
+sh test/7_node_modules_path.sh
+sh test/8_set_u.sh
+sh test/9_husky_0.sh
+sh test/10_init.sh
+sh test/11_time.sh

package.json

@@ -6,5 +6,5 @@ install
 npx --no-install husky
 
 git add package.json
-echo "echo pre-commit" >.husky/pre-commit
+echo "echo pre-commit" > .husky/pre-commit
 time git commit -m foo

tea.yaml

@@ -0,0 +1,11 @@
+#!/bin/sh
+. test/functions.sh
+setup
+install
+
+npx --no-install husky
+
+# Test pre-commit
+git add package.json
+echo 'echo "$PATH" | grep -q "node_modules/.bin"' > .husky/pre-commit
+expect 0 "git commit -m foo"