@ljharb/unused-files 0.1.1 → 0.2.0

package/CHANGELOG.md

@@ -5,6 +5,30 @@ 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.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
+
+- [Dev Deps] update `@arethetypeswrong/cli`, `@ljharb/eslint-config`, `@ljharb/tsconfig`, `@types/micromatch`, `@types/tape`, `auto-changelog`, `c8`, `playwright`, `tape` [`5ea2a9b`](https://github.com/ljharb/unused-files/commit/5ea2a9b60474033374e143a524b13dfeaeac3e9b)
+- [jsr] v0.1.1 [`3c9b832`](https://github.com/ljharb/unused-files/commit/3c9b8326b3b3d203fea7467d80f2d39246f53c69)
+- [Deps] update `knip`, `micromatch` [`ae13f9e`](https://github.com/ljharb/unused-files/commit/ae13f9e01ca10e7de50a11fb1af4c5a45a0c4ece)
+- [Tests] replace `aud` with `npm audit` [`9cd7f44`](https://github.com/ljharb/unused-files/commit/9cd7f44ca05ae87d1be364113d732e897c622ddb)
+- [Dev Deps] add missing peer dep [`d893df4`](https://github.com/ljharb/unused-files/commit/d893df4293dd7a73ba2cca2b0682e057a9b41416)
+- [Dev Deps] add `playwright` because `knip` and TS needs it [`444359d`](https://github.com/ljharb/unused-files/commit/444359db8c78b4d15371c10aeacecebcc72c62f9)
+
 ## [v0.1.1](https://github.com/ljharb/unused-files/compare/v0.1.0...v0.1.1) - 2024-04-12
 
 ### Commits

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,20 +15,83 @@ 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: '',
+			config: undefined,
+			configFilePath: undefined,
 			cwd,
+			dependencies: true,
+			experimentalTags: [[], []],
+			exports: true,
+			files: false,
 			fixTypes: [],
 			gitignore: true,
+			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,
+			isDisableConfigHints: false,
 			isFix: false,
+			isFixDependencies: false,
+			isFixFiles: false,
+			isFixUnusedExports: false,
+			isFixUnusedTypes: false,
+			isFormat: false,
 			isIncludeEntryExports: true,
-			isIncludeLibs: true,
 			isIsolateWorkspaces: false,
 			isProduction: true,
+			isReportClassMembers: false,
+			isReportDependencies: false,
+			isReportTypes: false,
+			isReportValues: false,
 			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.1",
+	"version": "0.2.0",
 	"description": "List unused files in your package.",
 	"bin": "./bin.mjs",
 	"main": false,
@@ -17,7 +17,7 @@
 		"pretest": "npm run lint",
 		"tests-only": "c8 tape 'test/**/*.mjs'",
 		"test": "npm run tests-only",
-		"posttest": "aud --production",
+		"posttest": "npx npm@\">= 10.2\" audit --production",
 		"version": "auto-changelog && git add CHANGELOG.md",
 		"postversion": "auto-changelog && git add CHANGELOG.md && git commit --no-edit --amend && git tag -f \"v$(node -e \"console.log(require('./package.json').version)\")\""
 	},
@@ -37,31 +37,34 @@
 	},
 	"homepage": "https://github.com/ljharb/unused-files#readme",
 	"dependencies": {
-		"knip": "^5.9.4",
-		"micromatch": "^4.0.5",
-		"object.groupby": "^1.0.3"
+		"knip": "^5.59.1",
+		"micromatch": "^4.0.8",
+		"object.groupby": "^1.0.3",
+		"pargs": "^1.0.3"
 	},
 	"devDependencies": {
-		"@arethetypeswrong/cli": "^0.15.3",
+		"@arethetypeswrong/cli": "^0.18.2",
 		"@jest/types": "^29.6.3",
-		"@ljharb/eslint-config": "^21.1.0",
-		"@ljharb/tsconfig": "^0.2.0",
-		"@types/micromatch": "^4.0.6",
+		"@ljharb/eslint-config": "^21.2.0",
+		"@ljharb/tsconfig": "^0.3.2",
+		"@types/micromatch": "^4.0.10",
+		"@types/minimist": "^1.2.5",
 		"@types/object.groupby": "^1.0.4",
-		"@types/tape": "^5.6.4",
+		"@types/tape": "^5.8.1",
 		"@types/webpack": "^5.28.5",
-		"aud": "^2.0.4",
-		"auto-changelog": "^2.4.0",
+		"auto-changelog": "^2.5.0",
 		"c8": "^9.1.0",
+		"encoding": "^0.1.13",
 		"eslint": "=8.8.0",
 		"in-publish": "^2.0.1",
 		"npmignore": "^0.3.1",
+		"playwright": "^1.55.0",
 		"safe-publish-latest": "^2.0.0",
-		"tape": "^5.7.5",
+		"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",
@@ -77,7 +80,8 @@
 			".github/workflows",
 			".eslintrc",
 			".nycrc",
-			"test"
+			"test",
+			"jsr.json"
 		]
 	}
 }

package/jsr.json

@@ -1,17 +0,0 @@
-{
-	"name": "@ljharb/unused-files",
-	"version": "0.1.0",
-	"bin": "./bin.mjs",
-	"exports": {
-		"./package.json": "./package.json"
-	},
-	"publish": {
-		"include": ["**/*"],
-		"exclude": [
-			".github/workflows",
-			".eslintrc",
-			".nycrc",
-			"test"
-		]
-	}
-}

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;
-	}
-}