@howells/husky 0.2.1 → 0.2.2

package/README.md

@@ -23,6 +23,8 @@ In `package.json`:
 }
 ```
 
+Standard external lint-staged configuration files are supported as an alternative to the inline `package.json` entry. Use one when path-aware or computed commands are needed.
+
 That's it. On `pnpm install`, the hooks are installed automatically.
 
 ## What it does
@@ -61,7 +63,7 @@ Your `package.json` must have:
 - a `"prepush"` script appropriate to the repository, or both:
   - a `"typecheck"` script (e.g. `tsc --noEmit` or `turbo run typecheck`)
   - a `"lint"` script (e.g. `howells-lint` or `turbo run lint`)
-- `"lint-staged"` config using `howells-fix` (`howells-ox-fix` and `howells-format` still accepted, legacy)
+- inline or standard external lint-staged configuration; static inline commands use `howells-fix` (`howells-ox-fix` and `howells-format` remain accepted for projects mid-migration)
 
 ## Why a package?
 

package/bin/detect.mjs

@@ -16,6 +16,27 @@ export const lintStagedFormatterCommands = [
 
 export const recommendedLintStagedCommand = "howells-fix";
 
+// Standard configuration names supported by lint-staged. Package-level files
+// in a monorepo are discovered by lint-staged itself; the installer only needs
+// to recognise the root configuration it is responsible for validating.
+export const lintStagedConfigFileNames = [
+  ".lintstagedrc",
+  ".lintstagedrc.json",
+  ".lintstagedrc.yaml",
+  ".lintstagedrc.yml",
+  ".lintstagedrc.js",
+  ".lintstagedrc.mjs",
+  ".lintstagedrc.cjs",
+  "lint-staged.config.js",
+  "lint-staged.config.mjs",
+  "lint-staged.config.cjs",
+  "lint-staged.config.ts",
+];
+
+export function findLintStagedConfigFile(exists) {
+  return lintStagedConfigFileNames.find((file) => exists(file));
+}
+
 /**
  * Flatten a lint-staged config object into the list of command strings it runs.
  * Values may be a single command string or an array of them.

package/bin/howells-husky.mjs

@@ -27,6 +27,7 @@ import path from "node:path";
 
 import {
   fallbackFailed,
+  findLintStagedConfigFile,
   lintStagedCommandValues,
   recommendedLintStagedCommand,
   shouldUseNpxFallback,
@@ -117,17 +118,21 @@ for (const hook of hooks) {
 const packageJsonPath = path.join(projectRoot, "package.json");
 if (existsSync(packageJsonPath)) {
   const packageJson = JSON.parse(readFileSync(packageJsonPath, "utf-8"));
+  const externalLintStagedConfig = findLintStagedConfigFile((file) =>
+    existsSync(path.join(projectRoot, file))
+  );
 
-  if (!packageJson["lint-staged"]) {
+  if (!packageJson["lint-staged"] && !externalLintStagedConfig) {
     console.warn(
-      '[@howells/husky] Warning: no "lint-staged" config found in package.json.'
+      "[@howells/husky] Warning: no inline or external lint-staged config found."
     );
     console.warn(
       `  Add: "lint-staged": { "*.{js,ts,jsx,tsx,json,jsonc,css}": "${recommendedLintStagedCommand}" }`
     );
   }
 
-  // Check that the lint-staged command uses a supported Howells formatter.
+  // Inline static configs can be checked directly. External JavaScript configs
+  // may compute commands dynamically, so lint-staged owns their validation.
   const lsConfig = packageJson["lint-staged"];
   if (lsConfig) {
     const commands = lintStagedCommandValues(lsConfig);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@howells/husky",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "Standardised git hooks for Howells projects. Immutable pre-commit and pre-push configuration.",
   "license": "MIT",
   "repository": {