knip 0.2.0 → 0.4.0

package/README.md

@@ -1,14 +1,16 @@
 # ✂️ Knip
 
-Knip scans your TypeScript projects for **unused files and exports**. For comparison, ESLint finds unused variables
-inside files in isolation, but this will not be flagged:
+Knip scans your JavaScript and TypeScript projects for **unused files, dependencies and exports**. Things that should be
+eliminated. Less code means better performance and less to maintain, important for both UX and DX!
+
+For comparison, ESLint finds unused variables inside files in isolation, but this will not be flagged:
 
 ```ts
 export const myVar = true;
 ```
 
-Unused files will also not be detected by ESLint. So how do you know which files and exports are no longer used? This
-requires an analysis of all the right files in the project.
+Unused files will also not be detected by ESLint. So how do you know which files, dependencies and exports are no longer
+used? This requires an analysis of all the right files in the project.
 
 This is where Knip comes in:
 
@@ -17,7 +19,7 @@ This is where Knip comes in:
 - [x] Finds dependencies not listed in `package.json`.
 - [x] Finds duplicate exports of the same symbol.
 - [x] Supports JavaScript inside TypeScript projects (`"allowJs": true`)
-- [ ] Supports JavaScript-only projects with CommonJS and ESM (no `tsconfig.json`) - TODO
+- [x] Supports JavaScript-only projects using ESM (without a `tsconfig.json`)
 
 Knip really shines in larger projects where you have non-production files (such as `/docs`, `/tools` and `/scripts`).
 The `includes` setting in `tsconfig.json` is often too broad, resulting in too many false negatives. Similar projects
@@ -77,23 +79,27 @@ Please read on if you think you have too many results: [too many false positives
 knip [options]
 
 Options:
-  -c/--config [file]   Configuration file path (default: ./knip.json or package.json#knip)
-  --cwd                Working directory (default: current working directory)
-  --include            Report only listed issue group(s) (see below)
-  --exclude            Exclude issue group(s) from report (see below)
-  --dev                Include `devDependencies` in report(s) (default: false)
-  --no-progress        Don't show dynamic progress updates
-  --max-issues         Maximum number of issues before non-zero exit code (default: 0)
-  --reporter           Select reporter: symbols, compact (default: symbols)
-  --jsdoc              Enable JSDoc parsing, with options: public (default: disabled)
+  -c/--config [file]     Configuration file path (default: ./knip.json or package.json#knip)
+  -t/--tsConfig [file]   TypeScript configuration path (default: ./tsconfig.json)
+  --dir                  Working directory (default: current working directory)
+  --include              Report only listed issue group(s) (see below)
+  --exclude              Exclude issue group(s) from report (see below)
+  --ignore               Ignore files matching this glob pattern (can be set multiple times)
+  --no-gitignore         Don't use .gitignore
+  --dev                  Include `devDependencies` in report(s)
+  --no-progress          Don't show dynamic progress updates
+  --max-issues           Maximum number of issues before non-zero exit code (default: 0)
+  --reporter             Select reporter: symbols, compact (default: symbols)
+  --jsdoc                Enable JSDoc parsing, with options: public
 
 Issue groups: files, dependencies, unlisted, exports, nsExports, types, nsTypes, duplicates
 
 Examples:
 
 $ knip
-$ knip --cwd packages/client --include files
+$ knip --dir packages/client --include files
 $ knip -c ./knip.js --reporter compact --jsdoc public
+$ knip --ignore 'lib/**/*.ts' --ignore build
 
 More info: https://github.com/webpro/knip
 ```
@@ -143,8 +149,10 @@ Excluding non-production files from the `projectFiles` allows Knip to understand
 
 Non-production code includes files such as end-to-end tests, tooling, scripts, Storybook stories, etc.
 
+Think of it the same way as you would split `dependencies` and `devDependencies` in `package.json`.
+
 To include both production and test files to analyze the project as a whole, include both sets of files to `entryFiles`,
-and add `dev: true`:
+and add `dev: true` to a file named such as `knip.dev.json`:
 
 ```json
 {
@@ -154,7 +162,29 @@ and add `dev: true`:
 }
 ```
 
-Knip will now report unused files and exports for the combined set of files as configured in `entryFiles`.
+Use `-c knip.dev.json` and unused files and exports for the combined set of files as configured in `entryFiles` will be
+reported.
+
+An alternative way to store `dev` configuration is in this example `package.json`:
+
+```json
+{
+  "name": "my-package",
+  "scripts": {
+    "knip": "knip"
+  },
+  "knip": {
+    "entryFiles": ["src/index.ts"],
+    "projectFiles": ["src/**/*.ts", "!**/*.spec.ts"],
+    "dev": {
+      "entryFiles": ["src/index.ts", "src/**/*.spec.ts", "src/**/*.e2e.ts"],
+      "projectFiles": ["src/**/*.ts"]
+    }
+  }
+}
+```
+
+This way, the `--dev` flag will use the `dev` options (and also add `devDependencies` to the `dependencies` report).
 
 ## More configuration examples
 
@@ -179,8 +209,8 @@ Packages can also be explicitly configured per package directory.
 To scan the packages separately, using the first match from the configuration file:
 
 ```
-knip --cwd packages/client --config knip.json
-knip --cwd packages/services --config knip.json
+knip --cwd packages/client
+knip --cwd packages/services
 ```
 
 #### Connected projects
@@ -217,10 +247,14 @@ can be tweaked further to the project structure.
 ### Default reporter
 
 ```
-$ knip --config ./knip.json
+$ knip
 --- UNUSED FILES (2)
 src/chat/helpers.ts
 src/components/SideBar.tsx
+--- UNUSED DEPENDENCIES (1)
+moment
+--- UNLISTED DEPENDENCIES (1)
+react
 --- UNUSED EXPORTS (5)
 lowercaseFirstLetter  src/common/src/string/index.ts
 RegistrationBox       src/components/Registration.tsx
@@ -240,10 +274,14 @@ ProductsList, default  src/components/Products.tsx
 ### Compact
 
 ```
-$ knip --config ./knip.json --reporter compact
+$ knip --reporter compact
 --- UNUSED FILES (2)
 src/chat/helpers.ts
 src/components/SideBar.tsx
+--- UNUSED DEPENDENCIES (1)
+moment
+--- UNLISTED DEPENDENCIES (1)
+react
 --- UNUSED EXPORTS (4)
 src/common/src/string/index.ts: lowercaseFirstLetter
 src/components/Registration.tsx: RegistrationBox

package/dist/cli.js

@@ -9,18 +9,22 @@ const node_util_1 = require("node:util");
 const typescript_1 = __importDefault(require("typescript"));
 const help_1 = require("./help");
 const config_1 = require("./util/config");
-const path_1 = require("./util/path");
+const fs_1 = require("./util/fs");
+const ignore_1 = require("./util/ignore");
 const reporters_1 = __importDefault(require("./reporters"));
 const _1 = require(".");
-const { values: { help, cwd: cwdArg, config: configFilePath = 'knip.json', include = [], exclude = [], dev: isDev = false, 'no-progress': noProgress = false, reporter = 'symbols', jsdoc = [], 'max-issues': maxIssues = '0', }, } = (0, node_util_1.parseArgs)({
+const { values: { help, dir, config: configFilePath = 'knip.json', tsConfig: tsConfigFilePath, include = [], exclude = [], dev: isDev = false, 'no-progress': noProgress = false, ignore = [], 'no-gitignore': isNoGitIgnore = false, reporter = 'symbols', jsdoc = [], 'max-issues': maxIssues = '0', }, } = (0, node_util_1.parseArgs)({
     options: {
         help: { type: 'boolean' },
         config: { type: 'string', short: 'c' },
-        cwd: { type: 'string' },
+        tsConfig: { type: 'string', short: 't' },
+        dir: { type: 'string' },
         include: { type: 'string', multiple: true },
         exclude: { type: 'string', multiple: true },
         dev: { type: 'boolean' },
         'max-issues': { type: 'string' },
+        ignore: { type: 'string', multiple: true },
+        'no-gitignore': { type: 'boolean' },
         'no-progress': { type: 'boolean' },
         reporter: { type: 'string' },
         jsdoc: { type: 'string', multiple: true },
@@ -31,49 +35,58 @@ if (help) {
     process.exit(0);
 }
 const cwd = process.cwd();
-const workingDir = cwdArg ? node_path_1.default.resolve(cwdArg) : cwd;
+const workingDir = dir ? node_path_1.default.resolve(dir) : cwd;
 const isShowProgress = noProgress === false ? process.stdout.isTTY && typeof process.stdout.cursorTo === 'function' : !noProgress;
 const printReport = reporter in reporters_1.default ? reporters_1.default[reporter] : require(node_path_1.default.join(workingDir, reporter));
 const main = async () => {
-    const localConfigurationPath = await (0, path_1.findFile)(workingDir, configFilePath);
-    const manifestPath = await (0, path_1.findFile)(workingDir, 'package.json');
-    if (!manifestPath || !localConfigurationPath) {
+    const localConfigurationPath = await (0, fs_1.findFile)(workingDir, configFilePath);
+    const manifestPath = await (0, fs_1.findFile)(workingDir, 'package.json');
+    const localConfiguration = localConfigurationPath && require(localConfigurationPath);
+    const manifest = manifestPath && require(manifestPath);
+    if (!localConfigurationPath && !manifest.knip) {
         const location = workingDir === cwd ? 'current directory' : `${node_path_1.default.relative(cwd, workingDir)} or up.`;
-        console.error(`Unable to find ${configFilePath} (or package.json#knip) in ${location}\n`);
+        console.error(`Unable to find ${configFilePath} or package.json#knip in ${location}\n`);
         (0, help_1.printHelp)();
         process.exit(1);
     }
-    const localConfiguration = require(localConfigurationPath);
-    const manifest = require(manifestPath);
-    const resolvedConfig = (0, config_1.resolveConfig)(manifest.knip ?? localConfiguration, cwdArg);
+    const resolvedConfig = (0, config_1.resolveConfig)(manifest.knip ?? localConfiguration, { workingDir: dir, isDev });
     if (!resolvedConfig) {
         (0, help_1.printHelp)();
         process.exit(1);
     }
     const report = (0, config_1.resolveIncludedIssueGroups)(include, exclude, resolvedConfig);
-    const tsConfigFile = await (0, path_1.findFile)(workingDir, 'tsconfig.json');
-    if (!tsConfigFile) {
-        const location = workingDir === cwd ? 'current directory' : `${node_path_1.default.relative(cwd, workingDir)} or up.`;
-        console.error(`Unable to find ${tsConfigFile} or package.json in ${location}\n`);
+    let tsConfigPaths = [];
+    const tsConfigPath = await (0, fs_1.findFile)(workingDir, tsConfigFilePath ?? 'tsconfig.json');
+    if (tsConfigFilePath && !tsConfigPath) {
+        console.error(`Unable to find ${tsConfigFilePath}\n`);
         (0, help_1.printHelp)();
         process.exit(1);
     }
-    const tsConfig = typescript_1.default.readConfigFile(tsConfigFile, typescript_1.default.sys.readFile);
-    const tsConfigPaths = tsConfig.config.compilerOptions?.paths
-        ? Object.keys(tsConfig.config.compilerOptions.paths).map(p => p.replace(/\*/g, '**'))
-        : [];
-    if (tsConfig.error) {
-        console.error(`An error occured when reading ${node_path_1.default.relative(cwd, tsConfigFile)}.\n`);
-        (0, help_1.printHelp)();
-        process.exit(1);
+    if (tsConfigPath) {
+        const tsConfig = typescript_1.default.readConfigFile(tsConfigPath, typescript_1.default.sys.readFile);
+        tsConfigPaths = tsConfig.config.compilerOptions?.paths
+            ? Object.keys(tsConfig.config.compilerOptions.paths).map(p => p.replace(/\*/g, '**'))
+            : [];
+        if (tsConfig.error) {
+            console.error(`An error occured when reading ${node_path_1.default.relative(cwd, tsConfigPath)}.\n`);
+            (0, help_1.printHelp)();
+            process.exit(1);
+        }
+    }
+    const ignorePatterns = ignore.map(ignore_1.convertPattern);
+    if (!isNoGitIgnore) {
+        const patterns = await (0, ignore_1.readIgnorePatterns)(cwd, workingDir);
+        patterns.forEach(pattern => ignorePatterns.push(pattern));
     }
     const config = {
         workingDir,
         report,
         dependencies: Object.keys(manifest.dependencies ?? {}),
         devDependencies: Object.keys(manifest.devDependencies ?? {}),
-        isDev: resolvedConfig.dev ?? isDev,
+        isDev: typeof resolvedConfig.dev === 'boolean' ? resolvedConfig.dev : isDev,
+        tsConfigFilePath,
         tsConfigPaths,
+        ignorePatterns,
         isShowProgress,
         jsDocOptions: {
             isReadPublicTag: jsdoc.includes('public'),

package/dist/help.js

@@ -5,23 +5,27 @@ const printHelp = () => {
     console.log(`knip [options]
 
 Options:
-  -c/--config [file]   Configuration file path (default: ./knip.json or package.json#knip)
-  --cwd                Working directory (default: current working directory)
-  --include            Report only listed issue group(s) (see below)
-  --exclude            Exclude issue group(s) from report (see below)
-  --dev                Include \`devDependencies\` in report(s) (default: false)
-  --no-progress        Don't show dynamic progress updates
-  --max-issues         Maximum number of issues before non-zero exit code (default: 0)
-  --reporter           Select reporter: symbols, compact (default: symbols)
-  --jsdoc              Enable JSDoc parsing, with options: public (default: disabled)
+  -c/--config [file]     Configuration file path (default: ./knip.json or package.json#knip)
+  -t/--tsConfig [file]   TypeScript configuration path (default: ./tsconfig.json)
+  --dir                  Working directory (default: current working directory)
+  --include              Report only listed issue group(s) (see below)
+  --exclude              Exclude issue group(s) from report (see below)
+  --ignore               Ignore files matching this glob pattern (can be set multiple times)
+  --no-gitignore         Don't use .gitignore
+  --dev                  Include \`devDependencies\` in report(s)
+  --no-progress          Don't show dynamic progress updates
+  --max-issues           Maximum number of issues before non-zero exit code (default: 0)
+  --reporter             Select reporter: symbols, compact (default: symbols)
+  --jsdoc                Enable JSDoc parsing, with options: public
 
 Issue groups: files, dependencies, unlisted, exports, nsExports, types, nsTypes, duplicates
 
 Examples:
 
 $ knip
-$ knip --cwd packages/client --include files
+$ knip --dir packages/client --include files
 $ knip -c ./knip.js --reporter compact --jsdoc public
+$ knip --ignore 'lib/**/*.ts' --ignore build
 
 More info: https://github.com/webpro/knip`);
 };

package/dist/index.js

@@ -15,11 +15,11 @@ const lineRewriter = new log_1.LineRewriter();
 async function run(configuration) {
     const { workingDir, isShowProgress, report, isDev, jsDocOptions } = configuration;
     const { getUnresolvedDependencies, getUnusedDependencies, getUnusedDevDependencies } = (0, dependencies_1.getDependencyAnalyzer)(configuration);
-    const production = await (0, project_1.createProject)(workingDir, configuration.entryFiles);
+    const production = await (0, project_1.createProject)(configuration, configuration.entryFiles);
     const entryFiles = production.getSourceFiles();
     production.resolveSourceFileDependencies();
     const productionFiles = production.getSourceFiles();
-    const project = await (0, project_1.createProject)(workingDir, configuration.projectFiles);
+    const project = await (0, project_1.createProject)(configuration, configuration.projectFiles);
     const projectFiles = project.getSourceFiles();
     const [usedProductionFiles, unreferencedProductionFiles] = (0, project_1.partitionSourceFiles)(projectFiles, productionFiles);
     const [usedEntryFiles, usedNonEntryFiles] = (0, project_1.partitionSourceFiles)(usedProductionFiles, entryFiles);
@@ -127,6 +127,8 @@ async function run(configuration) {
                         if (declaration.isKind(ts_morph_1.ts.SyntaxKind.Identifier)) {
                             identifier = declaration;
                         }
+                        else if (declaration.isKind(ts_morph_1.ts.SyntaxKind.ArrowFunction)) {
+                        }
                         else if (declaration.isKind(ts_morph_1.ts.SyntaxKind.FunctionDeclaration) ||
                             declaration.isKind(ts_morph_1.ts.SyntaxKind.ClassDeclaration) ||
                             declaration.isKind(ts_morph_1.ts.SyntaxKind.TypeAliasDeclaration) ||
@@ -156,7 +158,7 @@ async function run(configuration) {
                             }
                             else {
                                 const refFiles = new Set(refs.map(r => r.compilerObject.references.map(r => r.fileName)).flat());
-                                const isReferencedOnlyBySelf = refFiles.size === 1 && [...refFiles][0] === sourceFile.getFilePath();
+                                const isReferencedOnlyBySelf = refFiles.size === 1 && [...refFiles][0] === filePath;
                                 if (!isReferencedOnlyBySelf)
                                     return;
                                 if ((0, ts_morph_helpers_1.findReferencingNamespaceNodes)(sourceFile).length > 0) {

package/dist/reporters/compact.js

@@ -39,7 +39,7 @@ exports.default = ({ issues, config, workingDir }) => {
     }
     if (report.dependencies && isDev) {
         const unreferencedDevDependencies = Array.from(issues.devDependencies);
-        logIssueGroupResult(unreferencedDevDependencies, workingDir, reportMultipleGroups && 'UNUSED DEV DEPENDENCIES');
+        logIssueGroupResult(unreferencedDevDependencies, workingDir, 'UNUSED DEV DEPENDENCIES');
     }
     if (report.unlisted) {
         const unreferencedDependencies = Object.values(issues.unresolved).map(issues => {

package/dist/reporters/symbols.js

@@ -41,7 +41,7 @@ exports.default = ({ issues, config, workingDir }) => {
     }
     if (report.dependencies && isDev) {
         const unreferencedDevDependencies = Array.from(issues.devDependencies);
-        logIssueGroupResult(unreferencedDevDependencies, workingDir, reportMultipleGroups && 'UNUSED DEV DEPENDENCIES');
+        logIssueGroupResult(unreferencedDevDependencies, workingDir, 'UNUSED DEV DEPENDENCIES');
     }
     if (report.unlisted) {
         const unresolvedDependencies = Object.values(issues.unresolved).map(Object.values).flat();

package/dist/types.d.ts

@@ -20,12 +20,16 @@ export declare type Issues = {
     nsTypes: UnusedExportIssues;
     duplicates: UnusedExportIssues;
 };
-export declare type IssueType = keyof Issues;
+declare type IssueType = keyof Issues;
 export declare type ProjectIssueType = Extract<IssueType, 'files' | 'dependencies' | 'devDependencies'>;
 export declare type SymbolIssueType = Exclude<IssueType, ProjectIssueType>;
 export declare type IssueGroup = 'files' | 'dependencies' | 'unlisted' | 'exports' | 'nsExports' | 'types' | 'nsTypes' | 'duplicates';
-export declare type LocalConfiguration = {
-    dev?: boolean;
+declare type BaseLocalConfiguration = {
+    entryFiles: string[];
+    projectFiles: string[];
+};
+export declare type LocalConfiguration = BaseLocalConfiguration & {
+    dev?: boolean | BaseLocalConfiguration;
     entryFiles: string[];
     projectFiles: string[];
     include?: string[];
@@ -40,7 +44,9 @@ export declare type Configuration = LocalConfiguration & {
     dependencies: string[];
     devDependencies: string[];
     isDev: boolean;
+    tsConfigFilePath: undefined | string;
     tsConfigPaths: string[];
+    ignorePatterns: string[];
     isShowProgress: boolean;
     jsDocOptions: {
         isReadPublicTag: boolean;

package/dist/util/config.d.ts

@@ -1,5 +1,8 @@
 import type { ImportedConfiguration, LocalConfiguration } from '../types';
-export declare const resolveConfig: (importedConfiguration: ImportedConfiguration, cwdArg?: string) => LocalConfiguration | undefined;
+export declare const resolveConfig: (importedConfiguration: ImportedConfiguration, options?: {
+    workingDir?: string;
+    isDev?: boolean;
+}) => LocalConfiguration | undefined;
 export declare const resolveIncludedIssueGroups: (includeArg: string[], excludeArg: string[], resolvedConfig?: LocalConfiguration) => {
     files: boolean;
     dependencies: boolean;

package/dist/util/config.js

@@ -5,20 +5,25 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.resolveIncludedIssueGroups = exports.resolveConfig = void 0;
 const micromatch_1 = __importDefault(require("micromatch"));
-const resolveConfig = (importedConfiguration, cwdArg) => {
+const resolveConfig = (importedConfiguration, options) => {
+    let resolvedConfig = importedConfiguration;
+    const { workingDir, isDev } = options ?? {};
     const configKeys = Object.keys(importedConfiguration);
-    if (cwdArg && !('projectFiles' in importedConfiguration)) {
-        const importedConfigKey = configKeys.find(pattern => micromatch_1.default.isMatch(cwdArg.replace(/\/$/, ''), pattern));
+    if (workingDir && !('projectFiles' in importedConfiguration)) {
+        const importedConfigKey = configKeys.find(pattern => micromatch_1.default.isMatch(workingDir.replace(/\/$/, ''), pattern));
         if (importedConfigKey) {
-            return importedConfiguration[importedConfigKey];
+            resolvedConfig = importedConfiguration[importedConfigKey];
         }
     }
-    if (!cwdArg && (!importedConfiguration.entryFiles || !importedConfiguration.projectFiles)) {
+    if (isDev && typeof resolvedConfig.dev === 'object' && 'projectFiles' in resolvedConfig.dev) {
+        resolvedConfig = resolvedConfig.dev;
+    }
+    if (!resolvedConfig.entryFiles || !resolvedConfig.projectFiles) {
         console.error('Unable to find `entryFiles` and/or `projectFiles` in configuration.');
-        console.info(`Add it at root level, or use --cwd and match one of: ${configKeys.join(', ')}\n`);
+        console.info(`Add these properties at root level, or use --cwd and match one of: ${configKeys.join(', ')}\n`);
         return;
     }
-    return importedConfiguration;
+    return resolvedConfig;
 };
 exports.resolveConfig = resolveConfig;
 const resolveIncludedIssueGroups = (includeArg, excludeArg, resolvedConfig) => {

package/dist/util/fs.d.ts

@@ -0,0 +1,2 @@
+export declare const isFile: (filePath: string) => Promise<boolean>;
+export declare const findFile: (cwd: string, fileName: string) => Promise<string | undefined>;

package/dist/util/fs.js

@@ -0,0 +1,29 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findFile = exports.isFile = void 0;
+const promises_1 = __importDefault(require("node:fs/promises"));
+const node_path_1 = __importDefault(require("node:path"));
+const isFile = async (filePath) => {
+    try {
+        const stats = await promises_1.default.stat(filePath);
+        return stats.isFile();
+    }
+    catch {
+        return false;
+    }
+};
+exports.isFile = isFile;
+const findFile = async (cwd, fileName) => {
+    const filePath = node_path_1.default.join(cwd, fileName);
+    if (await (0, exports.isFile)(filePath)) {
+        return filePath;
+    }
+    else {
+        const parentDir = node_path_1.default.resolve(cwd, '..');
+        return parentDir === '/' ? undefined : (0, exports.findFile)(parentDir, fileName);
+    }
+};
+exports.findFile = findFile;

package/dist/util/ignore.d.ts

@@ -0,0 +1,2 @@
+export declare const convertPattern: (pattern: string) => string;
+export declare const readIgnorePatterns: (cwd: string, workingDir: string) => Promise<string[]>;

package/dist/util/ignore.js

@@ -0,0 +1,38 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readIgnorePatterns = exports.convertPattern = void 0;
+const promises_1 = __importDefault(require("node:fs/promises"));
+const node_path_1 = __importDefault(require("node:path"));
+const fs_1 = require("./fs");
+const path_1 = require("./path");
+const convertPattern = (pattern) => (pattern.startsWith('!') ? pattern.substring(1) : `!${pattern}`);
+exports.convertPattern = convertPattern;
+const readIgnoreFile = async (filePath) => {
+    let contents = '';
+    try {
+        contents = (await promises_1.default.readFile(filePath)).toString();
+    }
+    catch (error) {
+    }
+    return contents.split(/\r?\n/).filter(line => line && !line.startsWith('#'));
+};
+const traverseDirs = async (rootDir, currentDir, patterns = []) => {
+    const gitIgnorePath = node_path_1.default.join(currentDir, '.gitignore');
+    const parentDir = node_path_1.default.resolve(currentDir, '..');
+    if (await (0, fs_1.isFile)(gitIgnorePath)) {
+        (await readIgnoreFile(gitIgnorePath))
+            .map(pattern => (0, path_1.addWorkingDirToPattern)(currentDir, pattern))
+            .forEach(pattern => patterns.push(pattern));
+    }
+    if (rootDir === currentDir || parentDir === '/')
+        return patterns;
+    return traverseDirs(rootDir, parentDir, patterns);
+};
+const readIgnorePatterns = async (cwd, workingDir) => {
+    const patterns = await traverseDirs(cwd, workingDir);
+    return patterns.map(exports.convertPattern);
+};
+exports.readIgnorePatterns = readIgnorePatterns;

package/dist/util/path.d.ts

@@ -1 +1,3 @@
-export declare const findFile: (cwd: string, fileName: string) => Promise<string | undefined>;
+import type { Configuration } from '../types';
+export declare const addWorkingDirToPattern: (workingDir: string, pattern: string) => string;
+export declare const resolvePaths: (configuration: Configuration, patterns: string[]) => string[];

package/dist/util/path.js

@@ -3,26 +3,16 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.findFile = void 0;
-const promises_1 = __importDefault(require("node:fs/promises"));
+exports.resolvePaths = exports.addWorkingDirToPattern = void 0;
 const node_path_1 = __importDefault(require("node:path"));
-const isFile = async (filePath) => {
-    try {
-        const stats = await promises_1.default.stat(filePath);
-        return stats.isFile();
-    }
-    catch {
-        return false;
-    }
+const addWorkingDirToPattern = (workingDir, pattern) => {
+    if (pattern.startsWith('!'))
+        return '!' + node_path_1.default.join(workingDir, pattern.slice(1));
+    return node_path_1.default.join(workingDir, pattern);
 };
-const findFile = async (cwd, fileName) => {
-    const filePath = node_path_1.default.join(cwd, fileName);
-    if (await isFile(filePath)) {
-        return filePath;
-    }
-    else {
-        const parentDir = node_path_1.default.resolve(cwd, '..');
-        return parentDir === '/' ? undefined : (0, exports.findFile)(parentDir, fileName);
-    }
+exports.addWorkingDirToPattern = addWorkingDirToPattern;
+const resolvePaths = (configuration, patterns) => {
+    const { workingDir } = configuration;
+    return patterns.map(pattern => (0, exports.addWorkingDirToPattern)(workingDir, pattern));
 };
-exports.findFile = findFile;
+exports.resolvePaths = resolvePaths;

package/dist/util/project.d.ts

@@ -1,4 +1,5 @@
 import { Project } from 'ts-morph';
 import type { SourceFile } from 'ts-morph';
-export declare const createProject: (cwd: string, paths?: string | string[]) => Promise<Project>;
+import type { Configuration } from '../types';
+export declare const createProject: (configuration: Configuration, paths?: string[]) => Promise<Project>;
 export declare const partitionSourceFiles: (projectFiles: SourceFile[], productionFiles: SourceFile[]) => SourceFile[][];

package/dist/util/project.js

@@ -1,28 +1,20 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.partitionSourceFiles = exports.createProject = void 0;
-const node_path_1 = __importDefault(require("node:path"));
 const ts_morph_1 = require("ts-morph");
 const path_1 = require("./path");
-const resolvePaths = (cwd, patterns) => {
-    return [patterns].flat().map(pattern => {
-        if (pattern.startsWith('!'))
-            return '!' + node_path_1.default.join(cwd, pattern.slice(1));
-        return node_path_1.default.join(cwd, pattern);
-    });
-};
-const createProject = async (cwd, paths) => {
-    const tsConfigFilePath = await (0, path_1.findFile)(cwd, 'tsconfig.json');
+const createProject = async (configuration, paths) => {
+    const { tsConfigFilePath, ignorePatterns } = configuration;
+    const tsConfig = tsConfigFilePath ? { tsConfigFilePath } : { compilerOptions: { allowJs: true } };
     const workspace = new ts_morph_1.Project({
-        tsConfigFilePath,
+        ...tsConfig,
         skipAddingFilesFromTsConfig: true,
         skipFileDependencyResolution: true,
     });
-    if (paths)
-        workspace.addSourceFilesAtPaths(resolvePaths(cwd, paths));
+    if (paths) {
+        const resolvedPaths = (0, path_1.resolvePaths)(configuration, paths);
+        workspace.addSourceFilesAtPaths([...resolvedPaths, ...ignorePatterns]);
+    }
     return workspace;
 };
 exports.createProject = createProject;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "knip",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "Find unused files and exports in your TypeScript project",
   "keywords": [
     "find",