@howells/husky 0.2.1 → 0.2.3

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 appropriate to the project
 
 ## Why a package?
 

package/bin/detect.mjs

@@ -5,40 +5,27 @@
  * around behaviour that is unit-testable in isolation.
  */
 
-// `howells-fix` is the current canonical @howells/lint fixer; `howells-ox-fix`
-// and `howells-format` are earlier names still in use by repos mid-migration.
-// Accept all three so a correct lint-staged config never draws a false warning.
-export const lintStagedFormatterCommands = [
-  "howells-fix",
-  "howells-ox-fix",
-  "howells-format",
-];
-
 export const recommendedLintStagedCommand = "howells-fix";
 
-/**
- * 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.
- */
-export function lintStagedCommandValues(config) {
-  return Object.values(config).flatMap((value) => {
-    if (typeof value === "string") {
-      return [value];
-    }
-    if (Array.isArray(value)) {
-      return value.filter((item) => typeof item === "string");
-    }
-    return [];
-  });
-}
+// 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",
+];
 
-/**
- * True when a single lint-staged command invokes a supported Howells formatter.
- */
-export function usesSupportedFormatter(command) {
-  return lintStagedFormatterCommands.some((formatter) =>
-    command.includes(formatter)
-  );
+export function findLintStagedConfigFile(exists) {
+  return lintStagedConfigFileNames.find((file) => exists(file));
 }
 
 /**

package/bin/howells-husky.mjs

@@ -27,10 +27,9 @@ import path from "node:path";
 
 import {
   fallbackFailed,
-  lintStagedCommandValues,
+  findLintStagedConfigFile,
   recommendedLintStagedCommand,
   shouldUseNpxFallback,
-  usesSupportedFormatter,
 } from "./detect.mjs";
 
 const scriptDir = import.meta.dirname;
@@ -117,31 +116,19 @@ 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.
-  const lsConfig = packageJson["lint-staged"];
-  if (lsConfig) {
-    const commands = lintStagedCommandValues(lsConfig);
-    const usesHowells = commands.some(usesSupportedFormatter);
-    if (!usesHowells) {
-      console.warn(
-        "[@howells/husky] Warning: lint-staged should use a supported Howells formatter."
-      );
-      console.warn(
-        `  Expected: "*.{js,ts,jsx,tsx,json,jsonc,css}": "${recommendedLintStagedCommand}"`
-      );
-    }
-  }
-
   // Projects can own an appropriately scoped pre-push gate. Older projects
   // retain the package's typecheck + lint fallback until they add one.
   const scripts = packageJson.scripts || {};

package/package.json

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