@acme-skunkworks/eslint-config 1.0.0 → 1.0.1

package/README.md

@@ -63,7 +63,7 @@ pnpm add -D @acme-skunkworks/eslint-config
 The default export still works during the migration window, but is **deprecated** and will be removed in a future major:
 
 ```js
-// Old (still works in v7, deprecated)
+// Old (still works in v1, deprecated)
 import eslintConfig from "@acme-skunkworks/eslint-config";
 export default [...eslintConfig];
 
@@ -74,7 +74,7 @@ export default [...base, typescript, ...frameworkRouting];
 
 If your project was a Sanity / Storybook / Astro consumer, opt-in to those presets explicitly. The default export bundled all of them; the new shape makes the dependencies explicit.
 
-### What's new in v7
+### What's new in v1
 
 - **Tempest fold-in.** Plugin versions bumped to current; `complexity`, `e2e`, and `tableComponents` are new opt-in presets ported from Tempest. See `MIGRATION_FROM_PROTOMOLECULE.md` for the per-preset diff.
 - **Named-export composition.** Each preset is independently importable; consumers compose what they need.

package/dist/index.d.ts

@@ -24,11 +24,29 @@ export declare const frameworkRouting: Linter.Config[];
  * Test-file overrides for `*.test.*`, `*.spec.*`, `__tests__/**`, setup files.
  */
 export declare const testing: Linter.Config;
+/**
+ * Opt-in. Astro framework support — pull in for projects with `*.astro` files.
+ */
 export { astro } from "./rules/astro.js";
+/**
+ * Opt-in. Cyclomatic-complexity exemption for orchestration scripts under `scripts/**`.
+ */
 export { complexity } from "./rules/complexity.js";
+/**
+ * Opt-in. Playwright fixture exception — pull in for projects with end-to-end tests under `e2e/**`.
+ */
 export { e2e } from "./rules/e2e.js";
+/**
+ * Opt-in. Sanity Studio schema ordering and structure-file exceptions — pull in for projects using Sanity.
+ */
 export { sanity } from "./rules/sanity.js";
+/**
+ * Opt-in. Storybook story-file overrides — pull in for projects with `*.stories.{ts,tsx}` files.
+ */
 export { storybook } from "./rules/storybook.js";
+/**
+ * Opt-in. TanStack Table / Refine cell-renderer exception — pull in for projects with `*Table.tsx` files.
+ */
 export { tableComponents } from "./rules/tableComponents.js";
 /**
  * Back-compat default export — preserves the v6.x composition exactly so

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAerC;;;;;GAKG;AACH,eAAO,MAAM,IAAI,EAAE,MAAM,CAAC,MAAM,EAO/B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,MAA4B,CAAC;AAE7D;;;;;;;;GAQG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAG3C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,OAAO,EAAE,MAAM,CAAC,MAAkB,CAAC;AAEhD,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AACrC,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAE7D;;;;;;;;GAQG;AACH,QAAA,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EASjC,CAAC;AAEF,eAAe,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAerC;;;;;GAKG;AACH,eAAO,MAAM,IAAI,EAAE,MAAM,CAAC,MAAM,EAO/B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,MAA4B,CAAC;AAE7D;;;;;;;;GAQG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAG3C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,OAAO,EAAE,MAAM,CAAC,MAAkB,CAAC;AAEhD;;GAEG;AACH,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC;;GAEG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD;;GAEG;AACH,OAAO,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AACrC;;GAEG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C;;GAEG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD;;GAEG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAE7D;;;;;;;;GAQG;AACH,QAAA,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EASjC,CAAC;AAEF,eAAe,aAAa,CAAC"}

package/dist/index.js

@@ -58,11 +58,29 @@ export const frameworkRouting = [
  * Test-file overrides for `*.test.*`, `*.spec.*`, `__tests__/**`, setup files.
  */
 export const testing = testFiles;
+/**
+ * Opt-in. Astro framework support — pull in for projects with `*.astro` files.
+ */
 export { astro } from "./rules/astro.js";
+/**
+ * Opt-in. Cyclomatic-complexity exemption for orchestration scripts under `scripts/**`.
+ */
 export { complexity } from "./rules/complexity.js";
+/**
+ * Opt-in. Playwright fixture exception — pull in for projects with end-to-end tests under `e2e/**`.
+ */
 export { e2e } from "./rules/e2e.js";
+/**
+ * Opt-in. Sanity Studio schema ordering and structure-file exceptions — pull in for projects using Sanity.
+ */
 export { sanity } from "./rules/sanity.js";
+/**
+ * Opt-in. Storybook story-file overrides — pull in for projects with `*.stories.{ts,tsx}` files.
+ */
 export { storybook } from "./rules/storybook.js";
+/**
+ * Opt-in. TanStack Table / Refine cell-renderer exception — pull in for projects with `*Table.tsx` files.
+ */
 export { tableComponents } from "./rules/tableComponents.js";
 /**
  * Back-compat default export — preserves the v6.x composition exactly so

package/dist/infrastructure/scripts/derive-changeset.d.ts

@@ -0,0 +1,11 @@
+#!/usr/bin/env -S npx tsx
+export declare function deriveSlug(branch: string): string;
+export type Commit = {
+    body: string;
+    hash?: string;
+    subject: string;
+};
+export type Bump = "major" | "minor" | "patch";
+export declare function deriveBump(commits: readonly Commit[]): Bump;
+export declare function deriveBody(commits: readonly Commit[]): string;
+//# sourceMappingURL=derive-changeset.d.ts.map

package/dist/infrastructure/scripts/derive-changeset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"derive-changeset.d.ts","sourceRoot":"","sources":["../../../infrastructure/scripts/derive-changeset.ts"],"names":[],"mappings":";AAaA,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAYjD;AAED,MAAM,MAAM,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AACtE,MAAM,MAAM,IAAI,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;AAK/C,wBAAgB,UAAU,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAmB3D;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAO7D"}

package/dist/infrastructure/scripts/derive-changeset.js

@@ -0,0 +1,89 @@
+#!/usr/bin/env -S npx tsx
+// Derives the deterministic bits of a /send-it changeset entry:
+//   slug : branch-name-derived filename for `.changeset/<slug>.md`
+//   bump : major | minor | patch (per /send-it's bump heuristic)
+//   body : a one-line draft summary (the slash command may rewrite this)
+//
+// Reads from git via `git branch --show-current` and `git log origin/main..HEAD`
+// and prints JSON to stdout. Pure functions live exported for vitest.
+import { execSync } from "node:child_process";
+const SLUG_MAX = 60;
+export function deriveSlug(branch) {
+    const cleaned = branch
+        .toLowerCase()
+        .replaceAll(/[^a-z0-9]+/g, "-")
+        .replaceAll(/^-+|-+$/g, "");
+    if (cleaned.length <= SLUG_MAX) {
+        return cleaned;
+    }
+    const truncated = cleaned.slice(0, SLUG_MAX);
+    const lastHyphen = truncated.lastIndexOf("-");
+    return lastHyphen > 0 ? truncated.slice(0, lastHyphen) : truncated;
+}
+const BREAKING_SUBJECT = /^[a-z]+(\([^)]+\))?!:/;
+const FEAT_SUBJECT = /^feat(\([^)]+\))?:/;
+export function deriveBump(commits) {
+    if (commits.length === 0) {
+        return "patch";
+    }
+    const anyBreaking = commits.some((commit) => BREAKING_SUBJECT.test(commit.subject) ||
+        /BREAKING CHANGE:/.test(commit.body));
+    if (anyBreaking) {
+        return "major";
+    }
+    if (FEAT_SUBJECT.test(commits[0].subject)) {
+        return "minor";
+    }
+    return "patch";
+}
+export function deriveBody(commits) {
+    if (commits.length === 0) {
+        return "";
+    }
+    const subject = commits[0].subject;
+    return subject.replace(/^[a-z]+(\([^)]+\))?!?:\s*/, "");
+}
+function resolveBaseRef() {
+    for (const ref of ["origin/main", "main"]) {
+        try {
+            execSync(`git rev-parse --verify ${ref}`, { stdio: "ignore" });
+            return ref;
+        }
+        catch {
+            // ref doesn't exist; try next
+        }
+    }
+    return null;
+}
+function readGitCommits() {
+    const base = resolveBaseRef();
+    if (!base) {
+        return [];
+    }
+    const out = execSync(`git log ${base}..HEAD --format=%H%x1f%s%x1f%b%x1e`, {
+        encoding: "utf8",
+    });
+    return out
+        .split("\u001E")
+        .map((segment) => segment.trim())
+        .filter(Boolean)
+        .map((entry) => {
+        const [hash, subject, body] = entry.split("\u001F");
+        return { body: body ?? "", hash, subject: subject ?? "" };
+    });
+}
+function readGitBranch() {
+    return execSync("git branch --show-current", { encoding: "utf8" }).trim();
+}
+function main() {
+    const branch = readGitBranch();
+    const commits = readGitCommits();
+    console.log(JSON.stringify({
+        body: deriveBody(commits),
+        bump: deriveBump(commits),
+        slug: deriveSlug(branch),
+    }, null, 2));
+}
+if (import.meta.url === `file://${process.argv[1]}`) {
+    main();
+}

package/dist/infrastructure/scripts/retitle-release-pr.d.ts

@@ -0,0 +1,11 @@
+#!/usr/bin/env -S npx tsx
+export type Runner = (cmd: string, args: readonly string[]) => string;
+export type RetitleResult = {
+    reason: string;
+    status: "skipped";
+} | {
+    status: "ok";
+    title: string;
+};
+export declare function retitleReleasePr(environment: Record<string, string | undefined>, run: Runner): RetitleResult;
+//# sourceMappingURL=retitle-release-pr.d.ts.map

package/dist/infrastructure/scripts/retitle-release-pr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retitle-release-pr.d.ts","sourceRoot":"","sources":["../../../infrastructure/scripts/retitle-release-pr.ts"],"names":[],"mappings":";AAgBA,MAAM,MAAM,MAAM,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,KAAK,MAAM,CAAC;AAEtE,MAAM,MAAM,aAAa,GACrB;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,SAAS,CAAA;CAAE,GACrC;IAAE,MAAM,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AASpC,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,EAC/C,GAAG,EAAE,MAAM,GACV,aAAa,CAwBf"}

package/dist/infrastructure/scripts/retitle-release-pr.js

@@ -0,0 +1,50 @@
+#!/usr/bin/env -S npx tsx
+// Rewrites the Changesets-opened "Version Packages" PR title from the static
+// `release: version packages` (set in release.yml) to `<name>@<version>` after
+// the action has bumped package.json on the changeset-release/main branch.
+//
+// Inputs are read from env, not argv, so the script is trivially mockable in
+// tests and we don't have to think about shell quoting in YAML:
+//
+//   PR_NUMBER  — the changesets/action output `pullRequestNumber`. Empty means
+//                the action either published (no PR) or had nothing to do; in
+//                that case we exit cleanly. The workflow's `if:` should gate
+//                this already, but the guard is here for direct invocations.
+//   GH_TOKEN   — passed through to `gh` via the subprocess env.
+import { execFileSync } from "node:child_process";
+function realRunner(cmd, args) {
+    return execFileSync(cmd, args, {
+        encoding: "utf8",
+        stdio: ["ignore", "pipe", "inherit"],
+    });
+}
+export function retitleReleasePr(environment, run) {
+    const prNumber = environment.PR_NUMBER?.trim();
+    if (!prNumber) {
+        return { reason: "PR_NUMBER is empty", status: "skipped" };
+    }
+    run("git", ["fetch", "origin", "changeset-release/main"]);
+    const packageJsonRaw = run("git", ["show", "FETCH_HEAD:package.json"]);
+    const pkg = JSON.parse(packageJsonRaw);
+    if (typeof pkg.name !== "string" || pkg.name.length === 0) {
+        throw new Error("package.json is missing a string `name`");
+    }
+    if (typeof pkg.version !== "string" || pkg.version.length === 0) {
+        throw new Error("package.json is missing a string `version`");
+    }
+    const title = `${pkg.name}@${pkg.version}`;
+    run("gh", ["pr", "edit", prNumber, "--title", title]);
+    return { status: "ok", title };
+}
+function main() {
+    const result = retitleReleasePr(process.env, realRunner);
+    if (result.status === "skipped") {
+        console.log(`retitle-release-pr: skipped (${result.reason})`);
+    }
+    else {
+        console.log(`retitle-release-pr: set title to ${result.title}`);
+    }
+}
+if (import.meta.url === `file://${process.argv[1]}`) {
+    main();
+}

package/dist/rules/astro.d.ts

@@ -1,3 +1,11 @@
 import type { Linter } from "eslint";
+/**
+ * Opt-in. Pull in for projects using Astro (`astro` dep, `*.astro` files).
+ *
+ * Spreads `eslint-plugin-astro/flat/recommended` and adds an Astro-specific
+ * import-resolver allowlist for the patterns ESLint's static resolver can't
+ * follow: `astro:*` virtual modules (`astro:content`, `astro:assets`), the
+ * `@/` tsconfig path alias, and direct `.astro` file imports.
+ */
 export declare const astro: Linter.Config[];
 //# sourceMappingURL=astro.d.ts.map

package/dist/rules/astro.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"astro.d.ts","sourceRoot":"","sources":["../../rules/astro.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGrC,eAAO,MAAM,KAAK,EAAE,MAAM,CAAC,MAAM,EAmBhC,CAAC"}
+{"version":3,"file":"astro.d.ts","sourceRoot":"","sources":["../../rules/astro.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGrC;;;;;;;GAOG;AACH,eAAO,MAAM,KAAK,EAAE,MAAM,CAAC,MAAM,EAmBhC,CAAC"}

package/dist/rules/astro.js

@@ -1,4 +1,12 @@
 import { configs } from "eslint-plugin-astro";
+/**
+ * Opt-in. Pull in for projects using Astro (`astro` dep, `*.astro` files).
+ *
+ * Spreads `eslint-plugin-astro/flat/recommended` and adds an Astro-specific
+ * import-resolver allowlist for the patterns ESLint's static resolver can't
+ * follow: `astro:*` virtual modules (`astro:content`, `astro:assets`), the
+ * `@/` tsconfig path alias, and direct `.astro` file imports.
+ */
 export const astro = [
     ...configs["flat/recommended"],
     {

package/dist/rules/commonjs.d.ts

@@ -1,3 +1,10 @@
+/**
+ * Part of `base` — applied to every consumer.
+ *
+ * `.cjs` parser shim: sets `sourceType: "script"` plus Node + ES2021 globals
+ * so CommonJS files (legacy config files, certain tooling shims) parse
+ * cleanly under the otherwise-ESM-default flat config.
+ */
 export declare const commonjs: {
     files: string[];
     ignores: string[];

package/dist/rules/commonjs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"commonjs.d.ts","sourceRoot":"","sources":["../../rules/commonjs.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAcI,CAAC"}
+{"version":3,"file":"commonjs.d.ts","sourceRoot":"","sources":["../../rules/commonjs.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAcI,CAAC"}

package/dist/rules/commonjs.js

@@ -1,4 +1,11 @@
 import globals from "globals";
+/**
+ * Part of `base` — applied to every consumer.
+ *
+ * `.cjs` parser shim: sets `sourceType: "script"` plus Node + ES2021 globals
+ * so CommonJS files (legacy config files, certain tooling shims) parse
+ * cleanly under the otherwise-ESM-default flat config.
+ */
 export const commonjs = {
     files: ["**/*.cjs"],
     // Exclude node_modules

package/dist/rules/complexity.d.ts

@@ -1,5 +1,8 @@
 import type { Linter } from "eslint";
 /**
+ * Opt-in. Pull in for repos with orchestration / maintenance scripts under
+ * `scripts/**`.
+ *
  * Complexity overrides for file patterns where a cyclomatic-complexity exemption
  * is structural rather than a code smell.
  *

package/dist/rules/complexity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"complexity.d.ts","sourceRoot":"","sources":["../../rules/complexity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAErC;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,EAOrC,CAAC"}
+{"version":3,"file":"complexity.d.ts","sourceRoot":"","sources":["../../rules/complexity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAErC;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,EAOrC,CAAC"}

package/dist/rules/complexity.js

@@ -1,4 +1,7 @@
 /**
+ * Opt-in. Pull in for repos with orchestration / maintenance scripts under
+ * `scripts/**`.
+ *
  * Complexity overrides for file patterns where a cyclomatic-complexity exemption
  * is structural rather than a code smell.
  *

package/dist/rules/e2e.d.ts

@@ -1,4 +1,6 @@
 /**
+ * Opt-in. Pull in for projects using Playwright with fixtures under `e2e/**`.
+ *
  * ESLint override for Playwright end-to-end fixtures.
  *
  * Playwright's `test.extend()` / `test.use()` pattern involves passing fixture

package/dist/rules/e2e.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"e2e.d.ts","sourceRoot":"","sources":["../../rules/e2e.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;GAUG;AACH,eAAO,MAAM,GAAG;;;;;CAKS,CAAC"}
+{"version":3,"file":"e2e.d.ts","sourceRoot":"","sources":["../../rules/e2e.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,GAAG;;;;;CAKS,CAAC"}

package/dist/rules/e2e.js

@@ -1,4 +1,6 @@
 /**
+ * Opt-in. Pull in for projects using Playwright with fixtures under `e2e/**`.
+ *
  * ESLint override for Playwright end-to-end fixtures.
  *
  * Playwright's `test.extend()` / `test.use()` pattern involves passing fixture

package/dist/rules/frameworkRouting.d.ts

@@ -1,4 +1,8 @@
 /**
+ * Re-exported as part of `frameworkRouting` (composed with `reactRouterExceptions`).
+ * Pull in for projects using a meta-framework with file-based routing —
+ * Next.js, React Router 7, Remix, SvelteKit, Astro, Nuxt. Spread after `base`.
+ *
  * ESLint configuration for framework-based file routing patterns.
  *
  * Modern meta-frameworks (Next.js, React Router, Remix, SvelteKit, Astro, Nuxt)

package/dist/rules/frameworkRouting.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"frameworkRouting.d.ts","sourceRoot":"","sources":["../../rules/frameworkRouting.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AACH,eAAO,MAAM,gBAAgB;;;;;CAcJ,CAAC"}
+{"version":3,"file":"frameworkRouting.d.ts","sourceRoot":"","sources":["../../rules/frameworkRouting.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,gBAAgB;;;;;CAcJ,CAAC"}

package/dist/rules/frameworkRouting.js

@@ -1,4 +1,8 @@
 /**
+ * Re-exported as part of `frameworkRouting` (composed with `reactRouterExceptions`).
+ * Pull in for projects using a meta-framework with file-based routing —
+ * Next.js, React Router 7, Remix, SvelteKit, Astro, Nuxt. Spread after `base`.
+ *
  * ESLint configuration for framework-based file routing patterns.
  *
  * Modern meta-frameworks (Next.js, React Router, Remix, SvelteKit, Astro, Nuxt)

package/dist/rules/ignoredFileAndFolders.d.ts

@@ -1,3 +1,12 @@
+/**
+ * Part of `base` — applied to every consumer.
+ *
+ * Global ignore list: build artifacts (`dist`, `build`, `storybook-static`,
+ * `coverage`), tooling state directories (`.turbo`, `.vercel`, `.astro`,
+ * `.react-router`, `.wrangler`, `.vscode`, `.claude`), `node_modules`, and
+ * the lock file. Also ignores `tsconfig.json` and the consumer's own
+ * `eslint.config.{ts,mjs}` — those are tooling input, not source to lint.
+ */
 export declare const ignoredFileAndFolders: {
     ignores: string[];
 };

package/dist/rules/ignoredFileAndFolders.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ignoredFileAndFolders.d.ts","sourceRoot":"","sources":["../../rules/ignoredFileAndFolders.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,qBAAqB;;CAmBT,CAAC"}
+{"version":3,"file":"ignoredFileAndFolders.d.ts","sourceRoot":"","sources":["../../rules/ignoredFileAndFolders.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,eAAO,MAAM,qBAAqB;;CAmBT,CAAC"}

package/dist/rules/ignoredFileAndFolders.js

@@ -1,3 +1,12 @@
+/**
+ * Part of `base` — applied to every consumer.
+ *
+ * Global ignore list: build artifacts (`dist`, `build`, `storybook-static`,
+ * `coverage`), tooling state directories (`.turbo`, `.vercel`, `.astro`,
+ * `.react-router`, `.wrangler`, `.vscode`, `.claude`), `node_modules`, and
+ * the lock file. Also ignores `tsconfig.json` and the consumer's own
+ * `eslint.config.{ts,mjs}` — those are tooling input, not source to lint.
+ */
 export const ignoredFileAndFolders = {
     ignores: [
         "**/.react-router/**",

package/dist/rules/packageJson.d.ts

@@ -1,3 +1,11 @@
+/**
+ * Part of `base` — applied to every `package.json`.
+ *
+ * Disables `jsonc/sort-keys` so the canonical npm field order is preserved.
+ * `sort-package-json` (run via lint-staged) owns that ordering instead — it
+ * understands the conventional grouping (name → version → scripts → deps),
+ * which a strict alphabetical sort would scramble.
+ */
 export declare const packageJson: {
     files: string[];
     rules: {

package/dist/rules/packageJson.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"packageJson.d.ts","sourceRoot":"","sources":["../../rules/packageJson.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,WAAW;;;;;CAKC,CAAC"}
+{"version":3,"file":"packageJson.d.ts","sourceRoot":"","sources":["../../rules/packageJson.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW;;;;;CAKC,CAAC"}

package/dist/rules/packageJson.js

@@ -1,3 +1,11 @@
+/**
+ * Part of `base` — applied to every `package.json`.
+ *
+ * Disables `jsonc/sort-keys` so the canonical npm field order is preserved.
+ * `sort-package-json` (run via lint-staged) owns that ordering instead — it
+ * understands the conventional grouping (name → version → scripts → deps),
+ * which a strict alphabetical sort would scramble.
+ */
 export const packageJson = {
     files: ["**/package.json"],
     rules: {

package/dist/rules/preferences.d.ts

@@ -1,3 +1,17 @@
+/**
+ * Part of `base` — applied to every consumer. The largest preset, and the
+ * one most consumers will reach for when they want to override something.
+ *
+ * Covers function style, type-import style, the prettier integration, the
+ * import resolver (with monorepo support), `no-console`, and the
+ * React Router 7 / Remix / SvelteKit compatibility block (top-level type
+ * imports, empty-pattern allowance for typed framework args, CSS-import
+ * carve-out, devDependencies allowlist for test / config / scripts files).
+ *
+ * Per-rule rationale lives inline below; the relevant protomolecule issues
+ * (#299 React Router 7 ergonomics, #327 monorepo lint-staged paths,
+ * #333 virtual modules + verbatimModuleSyntax) are linked at each site.
+ */
 export declare const preferences: {
     files: string[];
     languageOptions: {

package/dist/rules/preferences.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"preferences.d.ts","sourceRoot":"","sources":["../../rules/preferences.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+GC,CAAC"}
+{"version":3,"file":"preferences.d.ts","sourceRoot":"","sources":["../../rules/preferences.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+GC,CAAC"}

package/dist/rules/preferences.js

@@ -1,3 +1,17 @@
+/**
+ * Part of `base` — applied to every consumer. The largest preset, and the
+ * one most consumers will reach for when they want to override something.
+ *
+ * Covers function style, type-import style, the prettier integration, the
+ * import resolver (with monorepo support), `no-console`, and the
+ * React Router 7 / Remix / SvelteKit compatibility block (top-level type
+ * imports, empty-pattern allowance for typed framework args, CSS-import
+ * carve-out, devDependencies allowlist for test / config / scripts files).
+ *
+ * Per-rule rationale lives inline below; the relevant protomolecule issues
+ * (#299 React Router 7 ergonomics, #327 monorepo lint-staged paths,
+ * #333 virtual modules + verbatimModuleSyntax) are linked at each site.
+ */
 export const preferences = {
     files: ["**/*.{ts,tsx,js,jsx,mjs}"],
     languageOptions: {

package/dist/rules/reactRouterExceptions.d.ts

@@ -1,3 +1,12 @@
+/**
+ * Part of the `frameworkRouting` composition (paired with `frameworkRoutingRule`).
+ * Not applied directly by consumers — pull in via `frameworkRouting`.
+ *
+ * Composition-order constraint: this preset MUST spread after `preferences`
+ * (which `base` includes) so its `func-style` override beats the stricter
+ * declaration-only default. Re-ordering silently breaks the React Router 7
+ * typed-export pattern. See `index.ts` for the canonical composition.
+ */
 export declare const reactRouterExceptions: {
     files: string[];
     rules: {

package/dist/rules/reactRouterExceptions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reactRouterExceptions.d.ts","sourceRoot":"","sources":["../../rules/reactRouterExceptions.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,qBAAqB;;;;;;;CAoBT,CAAC"}
+{"version":3,"file":"reactRouterExceptions.d.ts","sourceRoot":"","sources":["../../rules/reactRouterExceptions.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,eAAO,MAAM,qBAAqB;;;;;;;CAoBT,CAAC"}

package/dist/rules/reactRouterExceptions.js

@@ -1,3 +1,12 @@
+/**
+ * Part of the `frameworkRouting` composition (paired with `frameworkRoutingRule`).
+ * Not applied directly by consumers — pull in via `frameworkRouting`.
+ *
+ * Composition-order constraint: this preset MUST spread after `preferences`
+ * (which `base` includes) so its `func-style` override beats the stricter
+ * declaration-only default. Re-ordering silently breaks the React Router 7
+ * typed-export pattern. See `index.ts` for the canonical composition.
+ */
 export const reactRouterExceptions = {
     files: ["**/root.tsx", "**/*.route.tsx"],
     rules: {

package/dist/rules/sanity.d.ts

@@ -1,9 +1,15 @@
 /**
- * Combined Sanity ESLint configurations
+ * Opt-in. Pull in for projects using Sanity Studio (`sanity` / `@sanity/*`
+ * deps; schema files matching `*.schema.ts`; structure files at
+ * `sanity.structure.ts` or `deskStructure.ts`).
  *
- * Exports an array containing all Sanity-related ESLint configs:
- * - Schema property ordering for *.schema.ts files
- * - Structure file exceptions for structure.ts and deskStructure.ts
+ * Combined Sanity ESLint configuration. Exports an array of two configs
+ * documented inline above: schema property ordering for `*.schema.ts` (a
+ * perfectionist `sort-objects` rule with custom groups so identity → fields
+ * → behavior → validation appear in a deterministic, readable order) and
+ * structure-file exceptions (allows the `S => S.list()` arrow-function
+ * pattern and the canonical single-letter `S` parameter that Sanity's docs
+ * universally use for the StructureBuilder).
  */
 export declare const sanity: ({
     files: string[];

package/dist/rules/sanity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sanity.d.ts","sourceRoot":"","sources":["../../rules/sanity.ts"],"names":[],"mappings":"AAkIA;;;;;;GAMG;AACH,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;IAAkD,CAAC"}
+{"version":3,"file":"sanity.d.ts","sourceRoot":"","sources":["../../rules/sanity.ts"],"names":[],"mappings":"AAkIA;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;IAAkD,CAAC"}

package/dist/rules/sanity.js

@@ -6,13 +6,13 @@
  *
  * Property ordering follows a logical grouping:
  * 1. Identity: name, title, type, icon
- * 2. Organization: fieldset, group, groups, fieldsets
- * 3. Behavior: hidden, readOnly
- * 4. Type-specific: options, rows, to, of, marks, styles
- * 5. Content defaults: initialValue, description
- * 6. Document-level: preview, orderings
+ * 2. Fields: fields (placed early so document content stays visually prominent)
+ * 3. Organization: fieldset, group, groups, fieldsets
+ * 4. Behavior: hidden, readOnly
+ * 5. Type-specific: options, rows, to, of, marks, styles
+ * 6. Content defaults: initialValue, description
  * 7. Validation: validation
- * 8. Fields: fields (always last for document types)
+ * 8. Document-level: preview, orderings
  * @see https://perfectionist.dev/rules/sort-objects
  * @see https://www.sanity.io/docs/schema-field-types
  */
@@ -28,7 +28,7 @@ const sanitySchemaPropertyOrdering = {
                     { elementNamePattern: "^title$", groupName: "title" },
                     { elementNamePattern: "^type$", groupName: "type" },
                     { elementNamePattern: "^icon$", groupName: "icon" },
-                    // 2. Fields array (always last for document types - it's the bulk of the schema)
+                    // 2. Fields array (placed early so the schema's content stays visually prominent)
                     { elementNamePattern: "^fields$", groupName: "fields" },
                     // 3. Organization - where does it go?
                     { elementNamePattern: "^fieldset$", groupName: "fieldset" },
@@ -117,10 +117,16 @@ const sanityStructure = {
     },
 };
 /**
- * Combined Sanity ESLint configurations
+ * Opt-in. Pull in for projects using Sanity Studio (`sanity` / `@sanity/*`
+ * deps; schema files matching `*.schema.ts`; structure files at
+ * `sanity.structure.ts` or `deskStructure.ts`).
  *
- * Exports an array containing all Sanity-related ESLint configs:
- * - Schema property ordering for *.schema.ts files
- * - Structure file exceptions for structure.ts and deskStructure.ts
+ * Combined Sanity ESLint configuration. Exports an array of two configs
+ * documented inline above: schema property ordering for `*.schema.ts` (a
+ * perfectionist `sort-objects` rule with custom groups so identity → fields
+ * → behavior → validation appear in a deterministic, readable order) and
+ * structure-file exceptions (allows the `S => S.list()` arrow-function
+ * pattern and the canonical single-letter `S` parameter that Sanity's docs
+ * universally use for the StructureBuilder).
  */
 export const sanity = [sanitySchemaPropertyOrdering, sanityStructure];

package/dist/rules/storybook.d.ts

@@ -1,3 +1,13 @@
 import type { Linter } from "eslint";
+/**
+ * Opt-in. Pull in for projects using Storybook (`*.stories.{ts,tsx}` files).
+ *
+ * Disables `canonical/filename-match-exported` (Storybook stories typically
+ * sit alongside their component with the same basename, e.g. `Button.tsx`
+ * and `Button.stories.tsx`) and turns off type-aware lint rules. The latter
+ * is needed because Storybook files are usually excluded from `tsconfig`
+ * project references — leaving type-aware rules on would produce
+ * "file not in project" errors. Syntax-based rules stay active.
+ */
 export declare const storybook: Linter.Config;
 //# sourceMappingURL=storybook.d.ts.map

package/dist/rules/storybook.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"storybook.d.ts","sourceRoot":"","sources":["../../rules/storybook.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGrC,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,MASN,CAAC"}
+{"version":3,"file":"storybook.d.ts","sourceRoot":"","sources":["../../rules/storybook.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGrC;;;;;;;;;GASG;AACH,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,MASN,CAAC"}

package/dist/rules/storybook.js

@@ -1,4 +1,14 @@
 import tseslint from "typescript-eslint";
+/**
+ * Opt-in. Pull in for projects using Storybook (`*.stories.{ts,tsx}` files).
+ *
+ * Disables `canonical/filename-match-exported` (Storybook stories typically
+ * sit alongside their component with the same basename, e.g. `Button.tsx`
+ * and `Button.stories.tsx`) and turns off type-aware lint rules. The latter
+ * is needed because Storybook files are usually excluded from `tsconfig`
+ * project references — leaving type-aware rules on would produce
+ * "file not in project" errors. Syntax-based rules stay active.
+ */
 export const storybook = {
     files: ["**/*.stories.ts", "**/*.stories.tsx"],
     ignores: ["**/storybook-static/**/*"],

package/dist/rules/tableComponents.d.ts

@@ -1,4 +1,7 @@
 /**
+ * Opt-in. Pull in for projects using TanStack Table or Refine (column-cell
+ * renderers in `*Table.tsx` files).
+ *
  * ESLint override for table cell-renderer components.
  *
  * TanStack Table / Refine column definitions require inline cell renderer

package/dist/rules/tableComponents.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tableComponents.d.ts","sourceRoot":"","sources":["../../rules/tableComponents.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,eAAe;;;;;CAKH,CAAC"}
+{"version":3,"file":"tableComponents.d.ts","sourceRoot":"","sources":["../../rules/tableComponents.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,eAAe;;;;;CAKH,CAAC"}

package/dist/rules/tableComponents.js

@@ -1,4 +1,7 @@
 /**
+ * Opt-in. Pull in for projects using TanStack Table or Refine (column-cell
+ * renderers in `*Table.tsx` files).
+ *
  * ESLint override for table cell-renderer components.
  *
  * TanStack Table / Refine column definitions require inline cell renderer

package/dist/rules/testFiles.d.ts

@@ -1,3 +1,18 @@
+/**
+ * Re-exported as `testing`. Pull in for any project with a test suite.
+ *
+ * Targets `*.test.*`, `*.spec.*`, `__tests__/**`, and recognised setup-file
+ * patterns (`vitest.setup.ts`, `jest.setup.ts`, `playwright.setup.ts`,
+ * `test.setup.ts`, plus any `*.setup.{ts,js}` under `__tests__` or `tests`).
+ *
+ * Relaxes a handful of strictness rules where test code legitimately needs
+ * more latitude than production code: `any` and non-null assertions
+ * downgraded to warn (test fixtures often exercise edge cases that need
+ * them); triple-slash references off (Vitest setup files use them to
+ * augment global types from `@testing-library/jest-dom` etc.); and
+ * `import/no-extraneous-dependencies` switched to `devDependencies: true`,
+ * complementing the explicit allowlist `preferences` uses for non-test files.
+ */
 export declare const testFiles: {
     files: string[];
     rules: {

package/dist/rules/testFiles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"testFiles.d.ts","sourceRoot":"","sources":["../../rules/testFiles.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,SAAS;;;;;;;;;;CAiCG,CAAC"}
+{"version":3,"file":"testFiles.d.ts","sourceRoot":"","sources":["../../rules/testFiles.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,SAAS;;;;;;;;;;CAiCG,CAAC"}

package/dist/rules/testFiles.js

@@ -1,3 +1,18 @@
+/**
+ * Re-exported as `testing`. Pull in for any project with a test suite.
+ *
+ * Targets `*.test.*`, `*.spec.*`, `__tests__/**`, and recognised setup-file
+ * patterns (`vitest.setup.ts`, `jest.setup.ts`, `playwright.setup.ts`,
+ * `test.setup.ts`, plus any `*.setup.{ts,js}` under `__tests__` or `tests`).
+ *
+ * Relaxes a handful of strictness rules where test code legitimately needs
+ * more latitude than production code: `any` and non-null assertions
+ * downgraded to warn (test fixtures often exercise edge cases that need
+ * them); triple-slash references off (Vitest setup files use them to
+ * augment global types from `@testing-library/jest-dom` etc.); and
+ * `import/no-extraneous-dependencies` switched to `devDependencies: true`,
+ * complementing the explicit allowlist `preferences` uses for non-test files.
+ */
 export const testFiles = {
     files: [
         "**/*.test.{ts,tsx,js,jsx}",

package/dist/rules/typescriptOverrides.d.ts

@@ -1,3 +1,10 @@
+/**
+ * Re-exported as `typescript`. Pull in for any TypeScript consumer.
+ *
+ * Disables `react/prop-types` and `react/no-unused-prop-types` for `.ts` /
+ * `.tsx` files. TypeScript's type system already enforces prop shape; the
+ * runtime prop-type rules are redundant noise under TS.
+ */
 export declare const typescriptOverrides: {
     files: string[];
     rules: {

package/dist/rules/typescriptOverrides.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"typescriptOverrides.d.ts","sourceRoot":"","sources":["../../rules/typescriptOverrides.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,mBAAmB;;;;;;CAMP,CAAC"}
+{"version":3,"file":"typescriptOverrides.d.ts","sourceRoot":"","sources":["../../rules/typescriptOverrides.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB;;;;;;CAMP,CAAC"}

package/dist/rules/typescriptOverrides.js

@@ -1,3 +1,10 @@
+/**
+ * Re-exported as `typescript`. Pull in for any TypeScript consumer.
+ *
+ * Disables `react/prop-types` and `react/no-unused-prop-types` for `.ts` /
+ * `.tsx` files. TypeScript's type system already enforces prop shape; the
+ * runtime prop-type rules are redundant noise under TS.
+ */
 export const typescriptOverrides = {
     files: ["**/*.{ts,tsx}"],
     rules: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@acme-skunkworks/eslint-config",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Shared ESLint configuration with TypeScript and React support",
   "keywords": [
     "eslint",
@@ -38,25 +38,59 @@
     "dist"
   ],
   "scripts": {
+    "act:ci": "act pull_request -W .github/workflows/ci.yml --eventpath .github/act-events/pull_request.json",
+    "act:list": "act --list",
+    "act:release:dry": "act push -W .github/workflows/release.yml",
     "build": "tsc",
+    "ci:list": "gh run list --limit 10",
+    "ci:view": "gh run view",
+    "ci:watch": "gh run watch $(gh run list -L 1 --json databaseId -q '.[0].databaseId // empty')",
     "clean": "rimraf node_modules dist",
     "format": "npx prettier --write .",
-    "lint": "eslint 'index.ts' 'rules/**/*.ts' --cache --cache-location ./.eslintcache",
-    "lint:fix": "eslint 'index.ts' 'rules/**/*.ts' --fix --cache --cache-location ./.eslintcache",
-    "lint:fix-staged": "eslint 'index.ts' 'rules/**/*.ts' --fix --max-warnings=Infinity --cache --cache-location ./.eslintcache || true",
+    "lint": "eslint 'index.ts' 'rules/**/*.ts' 'infrastructure/scripts/**/*.ts' --cache --cache-location ./.eslintcache",
+    "lint:fix": "eslint 'index.ts' 'rules/**/*.ts' 'infrastructure/scripts/**/*.ts' --fix --cache --cache-location ./.eslintcache",
     "lint:md": "markdownlint-cli2 '**/*.{md,mdx}' '!**/node_modules/**' '!**/dist/**' '!**/.turbo/**' '!**/.astro/**'",
     "lint:md:fix": "markdownlint-cli2 --fix '**/*.{md,mdx}' '!**/node_modules/**' '!**/dist/**' '!**/.turbo/**' '!**/.astro/**'",
+    "lint:sh": "bash -c 'if command -v shellcheck >/dev/null 2>&1; then shellcheck infrastructure/scripts/*.sh .husky/pre-commit .husky/pre-push .husky/commit-msg; elif [ \"$(uname -s)\" = \"Darwin\" ]; then echo \"⚠️  shellcheck not installed — skipping. Install: brew install shellcheck\"; else echo \"⚠️  shellcheck not installed — skipping. Install: apt-get install shellcheck\"; fi'",
+    "lint:workflows": "actionlint",
+    "lint:yaml": "yamllint .",
+    "prepare": "husky",
     "prepublishOnly": "pnpm run build",
     "release": "pnpm run build && changeset publish",
     "release:manual": "pnpm run build && npm publish --access public --provenance=false",
     "release:manual:dry": "pnpm run build && npm publish --access public --provenance=false --dry-run",
-    "sort-pkg-json": "npx sort-package-json",
+    "sort-pkg-json": "sort-package-json",
+    "test": "vitest run",
+    "test:sh": "bash -c 'if command -v bats >/dev/null 2>&1; then bats infrastructure/tests/*.bats; elif [ \"$(uname -s)\" = \"Darwin\" ]; then echo \"⚠️  bats not installed — skipping. Install: brew install bats-core\"; else echo \"⚠️  bats not installed — skipping. Install: apt-get install bats\"; fi'",
+    "test:watch": "vitest",
     "tsc": "tsc --noEmit",
     "version": "changeset version"
   },
+  "lint-staged": {
+    "**/*": [
+      "prettier --write --ignore-unknown"
+    ],
+    "**/*.{ts,tsx,js,mjs,cjs}": [
+      "bash -c 'pnpm exec eslint --fix --cache --cache-location ./.eslintcache \"$@\" || true' --"
+    ],
+    "**/package.json": [
+      "bash -c 'sort-package-json \"$@\" || true' --",
+      "bash -c 'pnpm exec eslint --fix --cache --cache-location ./.eslintcache \"$@\" || true' --"
+    ],
+    "**/*.{md,mdx}": [
+      "bash -c 'markdownlint-cli2 --fix --config ./.markdownlint-cli2.jsonc \"$@\" || true' --"
+    ],
+    "**/*.{yml,yaml}": [
+      "bash -c 'if command -v yamllint >/dev/null 2>&1; then yamllint \"$@\"; elif [ \"$(uname -s)\" = \"Darwin\" ]; then echo \"⚠️  yamllint not installed — skipping. Install with: brew install yamllint\"; else echo \"⚠️  yamllint not installed — skipping. Install with: pip install --user yamllint==1.37.1\"; fi' --"
+    ],
+    ".github/workflows/*.{yml,yaml}": [
+      "bash -c 'if command -v actionlint >/dev/null 2>&1; then actionlint \"$@\"; elif [ \"$(uname -s)\" = \"Darwin\" ]; then echo \"⚠️  actionlint not installed — skipping. Install with: brew install actionlint\"; else echo \"⚠️  actionlint not installed — skipping. Install via: bash <(curl -fsSL https://raw.githubusercontent.com/rhysd/actionlint/v1.7.5/scripts/download-actionlint.bash)\"; fi' --"
+    ]
+  },
   "dependencies": {
     "astro-eslint-parser": "^1.0.0",
     "eslint-config-canonical": "^47.4.2",
+    "eslint-import-resolver-typescript": "^4.4.4",
     "eslint-plugin-astro": "^1.0.0",
     "eslint-plugin-import-x": "^4.16.1",
     "eslint-plugin-jsdoc": "^62.9.0",
@@ -68,7 +102,8 @@
     "eslint-plugin-react-hooks": "^7.0.1",
     "eslint-plugin-regexp": "^3.1.0",
     "eslint-plugin-unicorn": "^64.0.0",
-    "globals": "^17.5.0",
+    "globals": "^17.6.0",
+    "prettier-plugin-tailwindcss": "^0.8.0",
     "typescript-eslint": "^8.46.0"
   },
   "devDependencies": {
@@ -76,20 +111,30 @@
     "@robeasthope/markdownlint-config": "^1.1.1",
     "@types/eslint": "^9.6.1",
     "@types/node": "^25.6.0",
-    "eslint-import-resolver-typescript": "^4.4.4",
-    "prettier-plugin-tailwindcss": "^0.8.0",
+    "husky": "^9.1.7",
+    "lint-staged": "^16.3.2",
+    "markdownlint-cli2": "^0.18.1",
     "rimraf": "^6.0.1",
-    "typescript": "^6.0.3"
+    "sort-package-json": "^3.6.1",
+    "tsx": "^4.21.1",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.6"
   },
   "peerDependencies": {
     "eslint": "^8.57.0 || ^9.0.0",
     "prettier": "^3.0.0"
   },
+  "packageManager": "pnpm@10.33.0",
   "engines": {
     "node": ">=22"
   },
   "publishConfig": {
     "access": "public",
     "provenance": true
+  },
+  "pnpm": {
+    "onlyBuiltDependencies": [
+      "unrs-resolver"
+    ]
   }
 }