@ljharb/unused-files 0.2.1 → 0.2.2

package/CHANGELOG.md

@@ -5,6 +5,18 @@ 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.2](https://github.com/ljharb/unused-files/compare/v0.2.1...v0.2.2) - 2026-06-19
+
+### Commits
+
+- [Deps] update `knip` [`74d46f6`](https://github.com/ljharb/unused-files/commit/74d46f68120012c6805e570a1d19b1a38baac1e3)
+- [Deps] update `pargs` [`3ea5df5`](https://github.com/ljharb/unused-files/commit/3ea5df5689a15d3a0379662ae9661e9e958cd648)
+- [actions] update workflows [`861b83f`](https://github.com/ljharb/unused-files/commit/861b83f0586d5c8890dcea69a3d2e6ca75455523)
+- [Dev Deps] update `@arethetypeswrong/cli`, `@ljharb/eslint-config`, `auto-changelog`, `playwright`, `tape` [`57cabf2`](https://github.com/ljharb/unused-files/commit/57cabf2f15b407c6e05b0975a3f1f734adbf7a6a)
+- [Robustness] use `void` [`9dd847c`](https://github.com/ljharb/unused-files/commit/9dd847ce96cbf0b8bc7be4ce96a44a3edf21db48)
+- [Deps] update `knip` [`9688566`](https://github.com/ljharb/unused-files/commit/96885666830af026502512897e5c7da2920b765c)
+- [Deps] update `pargs` [`153f236`](https://github.com/ljharb/unused-files/commit/153f236102070d4656b030f9badaa4ec1865a103)
+
 ## [v0.2.1](https://github.com/ljharb/unused-files/compare/v0.2.0...v0.2.1) - 2026-01-06
 
 ### Commits

package/bin.mjs

@@ -10,12 +10,21 @@ const {
 } = await pargs(import.meta.filename, {
 	options: {
 		ignorePattern: {
-			default: undefined,
+			default: [
+				'.github/**',
+				'coverage/**',
+				'test/**',
+				'tests/**',
+				'example/**',
+			],
+			description: 'Ignore files matching the given pattern',
 			multiple: true,
+			placeholder: 'pattern',
 			type: 'string',
 		},
 		json: {
 			default: false,
+			description: 'Output the result as a JSON array',
 			type: 'boolean',
 		},
 	},

package/index.mjs

@@ -1,6 +1,19 @@
-import { relative } from 'path';
+import { createRequire } from 'module';
+import { dirname, join, relative } from 'path';
+import { pathToFileURL } from 'url';
+
 import micromatch from 'micromatch';
 
+const require = createRequire(import.meta.url);
+
+/*
+ * knip only exports `main`; the option builder it relies on lives in an internal
+ * module that knip's `exports` map hides from bare-specifier imports. Resolving
+ * knip's entry point and importing the file directly bypasses that gate, since
+ * the `exports` map only governs `knip/…` specifiers, not file URLs.
+ */
+const createOptionsURL = pathToFileURL(join(dirname(require.resolve('knip')), 'util', 'create-options.js')).href;
+
 export default async function unusedFiles(
 	cwd = process.cwd(),
 	ignorePattern = [
@@ -11,100 +24,24 @@ export default async function unusedFiles(
 		'example/**',
 	],
 ) {
-	const origArgv = process.argv;
-	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');
+	// @ts-expect-error knip doesn't have main in its types
+	const { main: knip } = await import('knip');
+	const { createOptions } = await import(createOptionsURL);
+
+	const options = await createOptions({
+		cwd,
+		includedIssueTypes: ['files'],
+		isProduction: true,
+		isStrict: true,
+	});
 
-		({ issues: { files } } = await knip({
-			cacheLocation: '',
-			catalog: {
-				filePath: '',
-			},
-			config: undefined,
-			configFilePath: undefined,
-			cwd,
-			dependencies: true,
-			experimentalTags: [[], []],
-			exports: true,
-			files: true,
-			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: true,
-			isFix: false,
-			isFixDependencies: false,
-			isFixFiles: false,
-			isFixUnusedExports: false,
-			isFixUnusedTypes: false,
-			isFormat: false,
-			isIncludeEntryExports: true,
-			isIsolateWorkspaces: false,
-			isProduction: true,
-			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;
-	}
+	const { issues: { files } } = await knip(options);
 
-	return Array.from(files).flatMap((x) => (
-		micromatch.isMatch(relative(cwd, x), ignorePattern)
-			? []
-			: `./${relative(cwd, x)}`
-	));
+	return Object.values(files)
+		.flatMap((bySymbol) => Object.values(bySymbol))
+		.flatMap((issue) => (
+			micromatch.isMatch(relative(cwd, issue.filePath), ignorePattern)
+				? []
+				: `./${relative(cwd, issue.filePath)}`
+		));
 }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@ljharb/unused-files",
-	"version": "0.2.1",
+	"version": "0.2.2",
 	"description": "List unused files in your package.",
 	"bin": "./bin.mjs",
 	"main": false,
@@ -37,30 +37,29 @@
 	},
 	"homepage": "https://github.com/ljharb/unused-files#readme",
 	"dependencies": {
-		"knip": "~5.78.0",
+		"knip": "~6.17.1",
 		"micromatch": "^4.0.8",
 		"object.groupby": "^1.0.3",
-		"pargs": "^1.2.1"
+		"pargs": "^1.4.2"
 	},
 	"devDependencies": {
-		"@arethetypeswrong/cli": "^0.18.2",
+		"@arethetypeswrong/cli": "^0.18.3",
 		"@jest/types": "^29.6.3",
-		"@ljharb/eslint-config": "^21.4.0",
+		"@ljharb/eslint-config": "^22.2.3",
 		"@ljharb/tsconfig": "^0.3.2",
+		"@types/eslint": "^8.56.12",
 		"@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",
+		"auto-changelog": "^2.6.0",
 		"c8": "^10.1.3",
 		"encoding": "^0.1.13",
 		"eslint": "^8.57.1",
 		"in-publish": "^2.0.1",
 		"npmignore": "^0.3.5",
-		"playwright": "^1.57.0",
+		"playwright": "^1.61.0",
 		"safe-publish-latest": "^2.0.0",
-		"tape": "^5.9.0",
+		"tape": "^5.10.2",
 		"typescript": "next"
 	},
 	"engines": {

package/help.txt

@@ -1,11 +0,0 @@
-Usage: unused-files [options]
-
-Options:
-  --ignorePattern <pattern>  Ignore files matching the given pattern
-    [string]
-    [multiple]
-    [default: .github/**, coverage/**, test/**, tests/**, example/**]
-
-  --json                     Output the result as a JSON array
-    [boolean]
-    [default: false]