@ankhorage/devtools 1.0.3 → 1.0.5

package/README.md

@@ -7,6 +7,7 @@ Shared ESLint, Prettier, and Knip configuration for modern TypeScript projects.
 - Consistent linting across repos
 - Zero-config Prettier setup
 - Shared Knip static-analysis defaults
+- Bundled tool binaries for ESLint, Prettier, and Knip
 - Strict TypeScript rules without compromise
 - One source of truth for tooling
 
@@ -16,6 +17,7 @@ Shared ESLint, Prettier, and Knip configuration for modern TypeScript projects.
 - Preconfigured plugin ecosystem
 - Prettier integration
 - Shared Knip config factory
+- `ankhorage-eslint`, `ankhorage-prettier`, and `ankhorage-knip` binaries
 - Monorepo-friendly
 
 ## Installation
@@ -24,28 +26,52 @@ Shared ESLint, Prettier, and Knip configuration for modern TypeScript projects.
 bun add -D @ankhorage/devtools
 ```
 
-Install the tools used by your local scripts as development dependencies:
-
-```bash
-bun add -D eslint prettier knip
-```
+The package owns the ESLint, Prettier, and Knip toolchain. Consuming repos should not install `eslint`, `prettier`, or `knip` directly unless they intentionally need a different version from the shared Ankhorage toolchain.
 
 ## Usage
 
+### Scripts
+
+Use the devtools-owned binaries in package scripts:
+
+```json
+{
+  "scripts": {
+    "lint": "ankhorage-eslint . --max-warnings=0",
+    "lint:fix": "ankhorage-eslint . --fix --max-warnings=0",
+    "format": "ankhorage-prettier --write .",
+    "format:check": "ankhorage-prettier --check .",
+    "knip": "ankhorage-knip"
+  }
+}
+```
+
 ### ESLint
 
+Create an `eslint.config.js` file:
+
 ```js
-import config from '@ankhorage/devtools/eslint';
+import { createConfig } from '@ankhorage/devtools/eslint';
 
-export default config();
+export default createConfig({
+  files: ['src/**/*.{ts,tsx}'],
+  project: ['./tsconfig.json'],
+  tsconfigRootDir: import.meta.dirname,
+});
 ```
 
 ### Prettier
 
-```json
-{
-  "extends": "@ankhorage/devtools/prettier"
-}
+Create a Prettier config file:
+
+```js
+export { default } from '@ankhorage/devtools/prettier';
+```
+
+CommonJS repos can use:
+
+```js
+module.exports = require('@ankhorage/devtools/prettier');
 ```
 
 ### Knip
@@ -58,16 +84,6 @@ import { createKnipConfig } from '@ankhorage/devtools/knip';
 export default createKnipConfig();
 ```
 
-Add a package script:
-
-```json
-{
-  "scripts": {
-    "knip": "knip"
-  }
-}
-```
-
 Repos can add narrow repo-specific patterns when needed:
 
 ```ts
@@ -77,16 +93,24 @@ export default createKnipConfig({
   entry: ['scripts/release.ts'],
   project: ['scripts/**/*.ts'],
   ignore: ['fixtures/**'],
+  ignoreBinaries: ['custom-tool'],
+  ignoreFiles: ['examples/fixture.ts'],
 });
 ```
 
-The shared config intentionally keeps defaults narrow so Knip does not fail on unmatched optional paths. Prefer explicit `entry`, `project`, or Knip plugin configuration over broad ignores when tool config files are reported as unused.
+The shared config intentionally keeps defaults narrow so Knip can use its own zero-config package discovery. Prefer explicit `entry`, `project`, `ignoreBinaries`, `ignoreDependencies`, or `ignoreFiles` over broad ignores.
 
 ### CI
 
-Run Knip in CI after dependencies are installed:
+Run the scripts in CI after dependencies are installed:
 
 ```yaml
+- name: Run lint
+  run: bun run lint
+
+- name: Run format check
+  run: bun run format:check
+
 - name: Run Knip
   run: bun run knip
 ```
@@ -124,9 +148,9 @@ This package centralizes tooling so all projects stay aligned.
 
 Includes:
 
-- ESLint configuration
-- Prettier configuration
-- Knip configuration
+- ESLint configuration and binary wrapper
+- Prettier configuration and binary wrapper
+- Knip configuration and binary wrapper
 
 Excludes:
 

package/dist/eslint-cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/eslint-cli.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import { runPackageBin } from './internal/runPackageBin.js';
+runPackageBin('eslint', 'eslint');

package/dist/internal/runPackageBin.d.ts

@@ -0,0 +1 @@
+export declare function runPackageBin(packageName: string, binName: string): void;

package/dist/internal/runPackageBin.js

@@ -0,0 +1,58 @@
+import { spawn } from 'node:child_process';
+import { existsSync, readFileSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import { dirname, join, resolve } from 'node:path';
+const require = createRequire(import.meta.url);
+function isRecord(value) {
+    return typeof value === 'object' && value !== null;
+}
+function findPackageJsonPath(packageName) {
+    let currentDirectory = dirname(require.resolve(packageName));
+    while (currentDirectory !== dirname(currentDirectory)) {
+        const packageJsonPath = join(currentDirectory, 'package.json');
+        if (existsSync(packageJsonPath)) {
+            return packageJsonPath;
+        }
+        currentDirectory = dirname(currentDirectory);
+    }
+    throw new Error(`Could not find package metadata for ${packageName}.`);
+}
+function readPackageBinPath(packageName, binName) {
+    const packageJsonPath = findPackageJsonPath(packageName);
+    const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf8'));
+    if (!isRecord(packageJson)) {
+        throw new Error(`Package metadata for ${packageName} is not an object.`);
+    }
+    const { bin } = packageJson;
+    let relativeBinPath;
+    if (typeof bin === 'string') {
+        relativeBinPath = bin;
+    }
+    else if (isRecord(bin)) {
+        const namedBin = bin[binName];
+        if (typeof namedBin === 'string') {
+            relativeBinPath = namedBin;
+        }
+    }
+    if (relativeBinPath === undefined) {
+        throw new Error(`Package ${packageName} does not expose a ${binName} binary.`);
+    }
+    return resolve(dirname(packageJsonPath), relativeBinPath);
+}
+export function runPackageBin(packageName, binName) {
+    const binPath = readPackageBinPath(packageName, binName);
+    const child = spawn(process.execPath, [binPath, ...process.argv.slice(2)], {
+        stdio: 'inherit',
+    });
+    child.on('error', (error) => {
+        console.error(error);
+        process.exit(1);
+    });
+    child.on('exit', (code, signal) => {
+        if (signal !== null) {
+            console.error(`${binName} exited with signal ${signal}.`);
+            process.exit(1);
+        }
+        process.exit(code ?? 1);
+    });
+}

package/dist/knip-cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/knip-cli.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import { runPackageBin } from './internal/runPackageBin.js';
+runPackageBin('knip', 'knip');

package/dist/knip.d.ts

@@ -3,6 +3,7 @@ export interface DevtoolsKnipWorkspaceConfigOptions {
     entry?: string[];
     project?: string[];
     ignore?: string[];
+    ignoreBinaries?: string[];
     ignoreDependencies?: (string | RegExp)[];
     ignoreFiles?: string[];
 }

package/dist/knip.js

@@ -3,6 +3,7 @@ export function createKnipConfig(options = {}) {
         ...(options.entry === undefined ? {} : { entry: options.entry }),
         ...(options.project === undefined ? {} : { project: options.project }),
         ...(options.ignore === undefined ? {} : { ignore: options.ignore }),
+        ...(options.ignoreBinaries === undefined ? {} : { ignoreBinaries: options.ignoreBinaries }),
         ...(options.ignoreDependencies === undefined
             ? {}
             : { ignoreDependencies: options.ignoreDependencies }),

package/dist/prettier-cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/prettier-cli.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import { runPackageBin } from './internal/runPackageBin.js';
+runPackageBin('prettier', 'prettier');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ankhorage/devtools",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "description": "Shared Lint and Format Configuration for Ankhorage",
   "homepage": "https://github.com/ankhorage/devtools#readme",
   "bugs": {
@@ -24,6 +24,11 @@
     "static-analysis",
     "developer-tools"
   ],
+  "bin": {
+    "ankhorage-eslint": "./dist/eslint-cli.js",
+    "ankhorage-knip": "./dist/knip-cli.js",
+    "ankhorage-prettier": "./dist/prettier-cli.js"
+  },
   "exports": {
     "./eslint": {
       "types": "./dist/eslint.d.ts",
@@ -47,6 +52,7 @@
     "build": "tsc && cp src/prettier.cjs dist/prettier.cjs",
     "knip": "knip",
     "lint": "eslint .",
+    "lint:fix": "eslint . --fix --max-warnings=0",
     "format": "prettier --write .",
     "format:check": "prettier --check .",
     "test": "bun test",
@@ -60,6 +66,7 @@
     "eslint-plugin-prettier": "^5.5.5",
     "eslint-plugin-simple-import-sort": "^12.1.1",
     "eslint-plugin-unused-imports": "^4.4.1",
+    "knip": "^6.12.2",
     "prettier": "^3.8.1",
     "typescript-eslint": "^8.24.0"
   },
@@ -67,7 +74,6 @@
     "@changesets/cli": "^2.30.0",
     "@types/bun": "^1.3.13",
     "@types/node": "^25.2.3",
-    "knip": "^6.12.2",
     "typescript": "^5.9.3"
   },
   "packageManager": "bun@1.3.13"