fallow 0.1.1 → 0.1.4

package/README.md

@@ -0,0 +1,73 @@
+# fallow
+
+Find dead code in JavaScript and TypeScript projects. Written in Rust.
+
+[![CI](https://github.com/BartWaardenburg/fallow/actions/workflows/ci.yml/badge.svg)](https://github.com/BartWaardenburg/fallow/actions/workflows/ci.yml)
+[![npm](https://img.shields.io/npm/v/fallow.svg)](https://www.npmjs.com/package/fallow)
+[![MIT License](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/bartwaardenburg/fallow/blob/main/LICENSE)
+
+Fallow detects unused files, exports, dependencies, types, enum members, and class members across your codebase. It is a drop-in alternative to [knip](https://knip.dev) that runs **25-50x faster** on real-world projects by using the [Oxc](https://oxc.rs) parser instead of the TypeScript compiler.
+
+## Installation
+
+```bash
+npm install -g fallow
+```
+
+## Usage
+
+```bash
+# Analyze your project
+fallow check
+
+# Watch mode
+fallow watch
+
+# Auto-fix unused exports and dependencies
+fallow fix --dry-run
+fallow fix
+
+# JSON output for CI
+fallow check --format json
+```
+
+## What it finds
+
+1. **Unused files** - files not imported anywhere
+2. **Unused exports** - exported symbols nobody imports
+3. **Unused types** - exported type aliases and interfaces
+4. **Unused dependencies** - packages in package.json not imported
+5. **Unused devDependencies** - dev packages not referenced
+6. **Unused enum members** - enum variants never accessed
+7. **Unused class members** - methods/properties never used
+8. **Unresolved imports** - imports that don't resolve to a file
+9. **Unlisted dependencies** - imported packages not in package.json
+10. **Duplicate exports** - same symbol exported from multiple files
+
+## Framework support
+
+Auto-detects and configures entry points for: Next.js, Vite, Vitest, Jest, Storybook, Remix, Astro, Nuxt, Angular, Playwright, Prisma, ESLint, TypeScript, Webpack, Tailwind, GraphQL Codegen, React Router.
+
+## Configuration
+
+Create a `fallow.toml` in your project root:
+
+```toml
+[entry]
+patterns = ["src/index.ts", "src/main.ts"]
+
+[ignore]
+files = ["**/*.test.ts", "**/*.spec.ts"]
+exports = ["src/public-api.ts"]
+dependencies = ["@types/*"]
+```
+
+Or generate one: `fallow init`
+
+## Documentation
+
+Full documentation at [github.com/bartwaardenburg/fallow](https://github.com/bartwaardenburg/fallow).
+
+## License
+
+MIT

package/bin/fallow

@@ -4,42 +4,44 @@ const { execFileSync } = require('child_process');
 const { join } = require('path');
 const { existsSync } = require('fs');
 
-const PLATFORMS = {
-  'darwin-arm64': ['@fallow-cli/darwin-arm64'],
-  'darwin-x64': ['@fallow-cli/darwin-x64'],
-  'linux-x64': ['@fallow-cli/linux-x64-gnu', '@fallow-cli/linux-x64-musl'],
-  'linux-arm64': ['@fallow-cli/linux-arm64-gnu', '@fallow-cli/linux-arm64-musl'],
-  'win32-x64': ['@fallow-cli/win32-x64-msvc'],
-};
-
-const platformKey = `${process.platform}-${process.arch}`;
-const candidates = PLATFORMS[platformKey];
-
-if (!candidates) {
-  console.error(`Unsupported platform: ${platformKey}`);
-  console.error(`Supported platforms: ${Object.keys(PLATFORMS).join(', ')}`);
+function getPlatformPackage() {
+  const platform = process.platform;
+  const arch = process.arch;
+
+  if (platform === 'win32' && arch === 'x64') {
+    return '@fallow-cli/win32-x64-msvc';
+  }
+  if (platform === 'darwin') {
+    return `@fallow-cli/darwin-${arch}`;
+  }
+  if (platform === 'linux') {
+    const { familySync } = require('detect-libc');
+    const libc = familySync() === 'musl' ? 'musl' : 'gnu';
+    return `@fallow-cli/linux-${arch}-${libc}`;
+  }
+
+  return null;
+}
+
+const pkg = getPlatformPackage();
+
+if (!pkg) {
+  console.error(`Unsupported platform: ${process.platform}-${process.arch}`);
   process.exit(1);
 }
 
 let binaryPath;
-
-// Try each candidate package (gnu first, then musl fallback)
-for (const pkg of candidates) {
-  try {
-    const pkgDir = require.resolve(`${pkg}/package.json`);
-    const binaryName = process.platform === 'win32' ? 'fallow.exe' : 'fallow';
-    const candidate = join(pkgDir, '..', binaryName);
-    if (existsSync(candidate)) {
-      binaryPath = candidate;
-      break;
-    }
-  } catch {
-    // Package not installed, try next candidate
-  }
+try {
+  const pkgDir = require.resolve(`${pkg}/package.json`);
+  const binaryName = process.platform === 'win32' ? 'fallow.exe' : 'fallow';
+  binaryPath = join(pkgDir, '..', binaryName);
+} catch {
+  console.error(`Could not find ${pkg}. Run 'npm install' to install platform-specific binary.`);
+  process.exit(1);
 }
 
-if (!binaryPath) {
-  console.error(`Could not find fallow binary for ${platformKey}. Run 'npm install' to install platform-specific binary.`);
+if (!existsSync(binaryPath)) {
+  console.error(`Binary not found at ${binaryPath}`);
   process.exit(1);
 }
 

package/package.json

@@ -1,15 +1,15 @@
 {
   "name": "fallow",
-  "version": "0.1.1",
+  "version": "0.1.4",
   "description": "Find unused files, exports, and dependencies in JavaScript/TypeScript projects",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/bartwaardenburg/fallow"
+    "url": "git+https://github.com/BartWaardenburg/fallow.git"
   },
-  "homepage": "https://github.com/bartwaardenburg/fallow",
+  "homepage": "https://github.com/BartWaardenburg/fallow",
   "bugs": {
-    "url": "https://github.com/bartwaardenburg/fallow/issues"
+    "url": "https://github.com/BartWaardenburg/fallow/issues"
   },
   "keywords": [
     "dead-code",
@@ -29,18 +29,22 @@
   },
   "files": [
     "bin",
-    "scripts"
+    "scripts",
+    "README.md"
   ],
   "scripts": {
     "postinstall": "node scripts/postinstall.js"
   },
+  "dependencies": {
+    "detect-libc": "^2.0.0"
+  },
   "optionalDependencies": {
-    "@fallow-cli/darwin-arm64": "0.1.0",
-    "@fallow-cli/darwin-x64": "0.1.0",
-    "@fallow-cli/linux-x64-gnu": "0.1.0",
-    "@fallow-cli/linux-arm64-gnu": "0.1.0",
-    "@fallow-cli/linux-x64-musl": "0.1.0",
-    "@fallow-cli/linux-arm64-musl": "0.1.0",
-    "@fallow-cli/win32-x64-msvc": "0.1.0"
+    "@fallow-cli/darwin-arm64": "0.1.4",
+    "@fallow-cli/darwin-x64": "0.1.4",
+    "@fallow-cli/linux-x64-gnu": "0.1.4",
+    "@fallow-cli/linux-arm64-gnu": "0.1.4",
+    "@fallow-cli/linux-x64-musl": "0.1.4",
+    "@fallow-cli/linux-arm64-musl": "0.1.4",
+    "@fallow-cli/win32-x64-msvc": "0.1.4"
   }
 }

package/scripts/postinstall.js

@@ -1,35 +1,42 @@
 // Verify the correct platform-specific package was installed
-const PLATFORMS = {
-  'darwin-arm64': ['@fallow-cli/darwin-arm64'],
-  'darwin-x64': ['@fallow-cli/darwin-x64'],
-  'linux-x64': ['@fallow-cli/linux-x64-gnu', '@fallow-cli/linux-x64-musl'],
-  'linux-arm64': ['@fallow-cli/linux-arm64-gnu', '@fallow-cli/linux-arm64-musl'],
-  'win32-x64': ['@fallow-cli/win32-x64-msvc'],
-};
+function getPlatformPackage() {
+  const platform = process.platform;
+  const arch = process.arch;
 
-const platformKey = `${process.platform}-${process.arch}`;
-const candidates = PLATFORMS[platformKey];
+  if (platform === 'win32' && arch === 'x64') {
+    return '@fallow-cli/win32-x64-msvc';
+  }
+  if (platform === 'darwin') {
+    return `@fallow-cli/darwin-${arch}`;
+  }
+  if (platform === 'linux') {
+    try {
+      const { familySync } = require('detect-libc');
+      const libc = familySync() === 'musl' ? 'musl' : 'gnu';
+      return `@fallow-cli/linux-${arch}-${libc}`;
+    } catch {
+      return `@fallow-cli/linux-${arch}-gnu`;
+    }
+  }
+
+  return null;
+}
+
+const pkg = getPlatformPackage();
 
-if (!candidates) {
+if (!pkg) {
   console.warn(
-    `fallow: No prebuilt binary for ${platformKey}. ` +
+    `fallow: No prebuilt binary for ${process.platform}-${process.arch}. ` +
     `You can build from source: https://github.com/bartwaardenburg/fallow`
   );
   process.exit(0);
 }
 
-const found = candidates.some((pkg) => {
-  try {
-    require.resolve(`${pkg}/package.json`);
-    return true;
-  } catch {
-    return false;
-  }
-});
-
-if (!found) {
+try {
+  require.resolve(pkg);
+} catch {
   console.warn(
-    `fallow: No platform package installed for ${platformKey}. ` +
+    `fallow: Platform package ${pkg} not installed. ` +
     `This may happen if you used --no-optional. ` +
     `Run 'npm install' to fix.`
   );