@ljharb/unused-files 0.1.2 → 0.2.1

package/CHANGELOG.md

@@ -5,6 +5,31 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/)
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [v0.2.1](https://github.com/ljharb/unused-files/compare/v0.2.0...v0.2.1) - 2026-01-06
+
+### Commits
+
+- [Fix] fix knip compatibility [`44f00fa`](https://github.com/ljharb/unused-files/commit/44f00fa23cd17f9f05a338adcf4d92850a9a96d0)
+- [Fix] fix knip compatibility with v5.63.1 [`d89fd7c`](https://github.com/ljharb/unused-files/commit/d89fd7c0623d0e200ffaa8150a9eff1e6e899818)
+- [Dev Deps] update `eslint`, `@ljharb/eslint-config`, `c8`, `npmignore`, `playwright` [`5d95ceb`](https://github.com/ljharb/unused-files/commit/5d95cebc62f19fd370f00ad8b6a97ff52423e8f6)
+- [Fix] fix knip compatibility with v5.69.0 [`abf7545`](https://github.com/ljharb/unused-files/commit/abf7545b69a8115bea5cc2ed3d6abfb7ab5169d1)
+- [Fix] fix knip compatibility with v5.77.0 [`d581150`](https://github.com/ljharb/unused-files/commit/d581150b4c253d06d160911c8291463bf946f965)
+- [Deps] update `pargs` [`a421e84`](https://github.com/ljharb/unused-files/commit/a421e84f827b88dbd19e5c49db90b1ff97b435c4)
+- [readme] replace runkit CI badge with shields.io check-runs badge [`9688bb9`](https://github.com/ljharb/unused-files/commit/9688bb98927de695bc69aca58763604e9c2bd2b0)
+
+## [v0.2.0](https://github.com/ljharb/unused-files/compare/v0.1.2...v0.2.0) - 2025-10-31
+
+### Commits
+
+- [Refactor] use `pargs` package [`4742989`](https://github.com/ljharb/unused-files/commit/474298940a86f4a60e99d860d12f217d9f19dba8)
+- [Fix] handle new API requirements inside knip [`91b7795`](https://github.com/ljharb/unused-files/commit/91b77959a27407a5d8ec23f77b8f829046f0ed9b)
+- [Breaking] update `engines.node` [`2945c2f`](https://github.com/ljharb/unused-files/commit/2945c2fabc93fcdcc0896e1b19fba4f80278edc2)
+- [Dev Deps] update `@arethetypeswrong/cli`, `@ljharb/eslint-config`, `playwright` [`ddc5f59`](https://github.com/ljharb/unused-files/commit/ddc5f5962db7c642698d3b05e88034aa7b676934)
+- [Dev Deps] update `@types/micromatch` [`aaef372`](https://github.com/ljharb/unused-files/commit/aaef3722dddb3fc4b1c250ba459e798d5e32889b)
+- [Dev Deps] update `playwright` [`fdc1376`](https://github.com/ljharb/unused-files/commit/fdc137615f2d2a6915fe23ef9a518e60c2811367)
+- [Dev Deps] update `playwright` [`dc73725`](https://github.com/ljharb/unused-files/commit/dc73725fc08fef10edb3d909ecf11fd962fd85c8)
+- [types] ignore incomplete knip types [`7a05e3e`](https://github.com/ljharb/unused-files/commit/7a05e3e1d74e90dfff7f72c35fef8b667c5e5b26)
+
 ## [v0.1.2](https://github.com/ljharb/unused-files/compare/v0.1.1...v0.1.2) - 2025-05-29
 
 ### Commits

package/README.md

@@ -55,5 +55,5 @@ MIT
 [downloads-url]: https://npm-stat.com/charts.html?package=@ljharb/unused-files
 [codecov-image]: https://codecov.io/gh/ljharb/unused-files/branch/main/graphs/badge.svg
 [codecov-url]: https://app.codecov.io/gh/ljharb/unused-files/
-[actions-image]: https://img.shields.io/endpoint?url=https://github-actions-badge-u3jn4tfpocch.runkit.sh/ljharb/unused-files
+[actions-image]: https://img.shields.io/github/check-runs/ljharb/unused-files/main
 [actions-url]: https://github.com/ljharb/unused-files/actions

package/bin.mjs

@@ -1,15 +1,13 @@
 #!/usr/bin/env node
 
-import { readFile } from 'fs/promises';
-import { join } from 'path';
+import pargs from 'pargs';
 
 import unusedFiles from './index.mjs';
 
-import pargs from './pargs.mjs';
-
-const help = await readFile(join(import.meta.dirname, './help.txt'), 'utf8');
-
-const { values: { json, ignorePattern } } = pargs(help, import.meta.filename, {
+const {
+	help,
+	values: { json, ignorePattern },
+} = await pargs(import.meta.filename, {
 	options: {
 		ignorePattern: {
 			default: undefined,
@@ -23,6 +21,8 @@ const { values: { json, ignorePattern } } = pargs(help, import.meta.filename, {
 	},
 });
 
+await help();
+
 // eslint-disable-next-line no-extra-parens
 const files = await unusedFiles(process.cwd(), /** @type {string[] | undefined} */ (ignorePattern));
 

package/help.txt

@@ -8,4 +8,4 @@ Options:
 
   --json                     Output the result as a JSON array
     [boolean]
-    [default: false]
+    [default: false]

package/index.mjs

@@ -15,33 +15,88 @@ export default async function unusedFiles(
 	let files;
 	try {
 		process.argv = origArgv.slice(0, 2);
+		// @ts-expect-error knip doesn't have main in its types
 		const { main: knip } = await import('knip');
 
 		({ issues: { files } } = await knip({
 			cacheLocation: '',
+			catalog: {
+				filePath: '',
+			},
+			config: undefined,
+			configFilePath: undefined,
 			cwd,
-			excludedIssueTypes: [],
+			dependencies: true,
+			experimentalTags: [[], []],
+			exports: true,
+			files: true,
 			fixTypes: [],
 			gitignore: true,
-			includedIssueTypes: [],
+			includedIssueTypes: {
+				_files: true,
+				binaries: true,
+				classMembers: true,
+				dependencies: true,
+				devDependencies: true,
+				duplicates: true,
+				enumMembers: true,
+				exports: true,
+				files: true,
+				nsExports: true,
+				nsTypes: true,
+				optionalPeerDependencies: true,
+				types: true,
+				unlisted: true,
+				unresolved: true,
+			},
 			isCache: false,
 			isDebug: false,
-			isDependenciesShorthand: false,
-			isExportsShorthand: false,
-			isFilesShorthand: false,
+			isDisableConfigHints: true,
 			isFix: false,
+			isFixDependencies: false,
+			isFixFiles: false,
+			isFixUnusedExports: false,
+			isFixUnusedTypes: false,
 			isFormat: false,
 			isIncludeEntryExports: true,
-			isIncludeLibs: true,
 			isIsolateWorkspaces: false,
 			isProduction: true,
-			isRemoveFiles: false,
+			isReportClassMembers: true,
+			isReportDependencies: true,
+			isReportExports: true,
+			isReportFiles: true,
+			isReportTypes: true,
+			isReportValues: true,
 			isShowProgress: false,
+			isSkipLibs: false,
 			isStrict: true,
+			isTrace: false,
+			isTreatConfigHintsAsErrors: false,
 			isWatch: false,
+			parsedConfig: {},
+			rules: {
+				_files: 'error',
+				binaries: 'error',
+				classMembers: 'error',
+				dependencies: 'error',
+				devDependencies: 'error',
+				duplicates: 'error',
+				enumMembers: 'error',
+				exports: 'error',
+				files: 'error',
+				nsExports: 'error',
+				nsTypes: 'error',
+				optionalPeerDependencies: 'error',
+				types: 'error',
+				unlisted: 'error',
+				unresolved: 'error',
+			},
 			tags: [[], []],
+			traceExport: undefined,
+			traceFile: undefined,
 			tsConfigFile: '',
 			workspace: undefined,
+			workspaces: [],
 		}));
 	} finally {
 		process.argv = origArgv;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@ljharb/unused-files",
-	"version": "0.1.2",
+	"version": "0.2.1",
 	"description": "List unused files in your package.",
 	"bin": "./bin.mjs",
 	"main": false,
@@ -37,33 +37,34 @@
 	},
 	"homepage": "https://github.com/ljharb/unused-files#readme",
 	"dependencies": {
-		"knip": "^5.59.1",
+		"knip": "~5.78.0",
 		"micromatch": "^4.0.8",
-		"object.groupby": "^1.0.3"
+		"object.groupby": "^1.0.3",
+		"pargs": "^1.2.1"
 	},
 	"devDependencies": {
-		"@arethetypeswrong/cli": "^0.18.1",
+		"@arethetypeswrong/cli": "^0.18.2",
 		"@jest/types": "^29.6.3",
-		"@ljharb/eslint-config": "^21.1.1",
+		"@ljharb/eslint-config": "^21.4.0",
 		"@ljharb/tsconfig": "^0.3.2",
-		"@types/micromatch": "^4.0.9",
+		"@types/micromatch": "^4.0.10",
 		"@types/minimist": "^1.2.5",
 		"@types/object.groupby": "^1.0.4",
 		"@types/tape": "^5.8.1",
 		"@types/webpack": "^5.28.5",
 		"auto-changelog": "^2.5.0",
-		"c8": "^9.1.0",
+		"c8": "^10.1.3",
 		"encoding": "^0.1.13",
-		"eslint": "=8.8.0",
+		"eslint": "^8.57.1",
 		"in-publish": "^2.0.1",
-		"npmignore": "^0.3.1",
-		"playwright": "^1.52.0",
+		"npmignore": "^0.3.5",
+		"playwright": "^1.57.0",
 		"safe-publish-latest": "^2.0.0",
 		"tape": "^5.9.0",
 		"typescript": "next"
 	},
 	"engines": {
-		"node": "^20.11.1 || >= 21.7.1"
+		"node": "^22.20 || ^24.10 || >= 25"
 	},
 	"auto-changelog": {
 		"output": "CHANGELOG.md",

package/pargs.d.ts

@@ -1,5 +0,0 @@
-export type ExtractIterable<T> = T extends Iterable<infer U> ? U : never;
-
-export type GroupedByString<T> = { [k: string]: null | T[] };
-
-declare function groupByString<T>(iterable: Iterable<T>, cb: (item: T) => string): GroupedByString<T>;

package/pargs.mjs

@@ -1,100 +0,0 @@
-import { parseArgs } from 'util';
-import { realpathSync } from 'fs';
-
-import groupByPolyfill from 'object.groupby/polyfill';
-
-const groupBy = groupByPolyfill();
-
-/** @typedef {import('util').ParseArgsConfig} ParseArgsConfig */
-
-/** @typedef {(Error | TypeError) & { code: 'ERR_PARSE_ARGS_UNKNOWN_OPTION' | 'ERR_PARSE_ARGS_INVALID_OPTION_VALUE' | 'ERR_INVALID_ARG_TYPE' | 'ERR_INVALID_ARG_VALUE' | 'ERR_PARSE_ARGS_UNEXPECTED_POSITIONAL'}} ParseArgsError */
-
-/** @type {(e: unknown) => e is ParseArgsError} */
-function isParseArgsError(e) {
-	return !!e
-		&& typeof e === 'object'
-		&& 'code' in e
-		&& (
-			e.code === 'ERR_PARSE_ARGS_UNKNOWN_OPTION'
-			|| e.code === 'ERR_PARSE_ARGS_INVALID_OPTION_VALUE'
-			|| e.code === 'ERR_INVALID_ARG_TYPE'
-			|| e.code === 'ERR_INVALID_ARG_VALUE'
-			|| e.code === 'ERR_PARSE_ARGS_UNEXPECTED_POSITIONAL'
-		);
-}
-
-/** @type {(helpText: string, entrypointPath: string, obj: Exclude<ParseArgsConfig, 'args'>) => ReturnType<typeof parseArgs>} */
-export default function pargs(helpText, entrypointPath, obj) {
-	const argv = process.argv.flatMap((arg) => {
-		try {
-			const realpathedArg = realpathSync(arg);
-			if (
-				realpathedArg === process.execPath
-				|| realpathedArg === entrypointPath
-			) {
-				return [];
-			}
-		} catch (e) { /**/ }
-		return arg;
-	});
-
-	if ('help' in obj) {
-		throw new TypeError('The "help" option is reserved');
-	}
-
-	const bools = obj.options ? Object.entries(obj.options).filter(([key, { type }]) => type === 'boolean' && key !== 'help') : [];
-	const inverseBools = Object.fromEntries(bools.map(([key, value]) => [
-		`no-${key}`,
-		{ default: !value.default, type: 'boolean' },
-	]));
-	/** @type {ParseArgsConfig & { tokens: true }} */
-	const newObj = {
-		args: argv,
-		...obj,
-		options: {
-			...obj.options,
-			...inverseBools,
-			help: {
-				default: false,
-				type: 'boolean',
-			},
-		},
-		tokens: true,
-	};
-
-	try {
-		const { tokens, ...results } = parseArgs(newObj);
-
-		if ('help' in results.values && results.values.help) {
-			console.log(helpText);
-			process.exit(0);
-		}
-
-		/** @typedef {Extract<typeof tokens[number], { kind: 'option' }>} OptionToken */
-		const optionTokens = tokens.filter(/** @type {(token: typeof tokens[number]) => token is OptionToken} */ (token) => token.kind === 'option');
-		const passedArgs = new Set(optionTokens.map(({ name }) => name));
-		const groups = groupBy(passedArgs, (x) => x.replace(/^no-/, ''));
-		bools.forEach(([key]) => {
-			if ((groups[key]?.length ?? 0) > 1) {
-				console.log(helpText);
-				console.error(`Error: Arguments --${key} and --no-${key} are mutually exclusive`);
-				process.exit(2);
-			}
-			if (passedArgs.has(`no-${key}`)) {
-				// @ts-expect-error
-				results.values[key] = !results.values[`no-${key}`];
-			}
-			// @ts-expect-error
-			delete results.values[`no-${key}`];
-		});
-
-		return obj.tokens ? { ...results, tokens } : results;
-	} catch (e) {
-		if (isParseArgsError(e)) {
-			console.log(helpText);
-			console.error(`Error: ${e.message}`);
-			process.exit(1);
-		}
-		throw e;
-	}
-}