@noahnu/unused-files 0.0.1 → 0.1.0

package/CHANGELOG.md

@@ -1,6 +1,20 @@
 # Changelog
 
-<!-- MONODEPLOY:BELOW -->
+<!-- MONOWEAVE:BELOW -->
+
+## @noahnu/unused-files (v0.1.0) <a name="0.1.0"></a>
+
+Support custom resolvers.
+
+
+
+## @noahnu/unused-files (v0.0.2) <a name="0.0.2"></a>
+
+Update ESLint config and plugins to ESLint v9.
+
+Update misc. dependencies.
+
+
 
 ## [0.0.1](https://github.com/noahnu/nodejs-tools/compare/@noahnu/unused-files@0.0.0...@noahnu/unused-files@0.0.1) "@noahnu/unused-files" (2024-01-15)<a name="0.0.1"></a>
 

package/README.md

@@ -17,9 +17,14 @@ const result = await findUnusedFiles({
     // optional
     sourceDirectories: [process.cwd()],
     ignorePatterns: ['**/node_modules'],
-    aliases: {
-        '@my/alias': 'path/to/file/index.ts',
-    },
+    resolvers: [
+        async ({ request, context }) => {
+            if (request === '@my/alias') {
+                return { result: 'path/to/file/index.ts' }
+            }
+            return null;
+        }
+    ],
     depth: 10,
 })
 

package/lib/api/index.d.ts

@@ -1,4 +1,6 @@
-export type FindUnusedFilesOptions = {
+import { type Resolver } from './types';
+export type { Resolver, ResolverResult, ResolverParams } from './types';
+export interface FindUnusedFilesOptions {
     /**
      * Entry files into the codebase. These files are known to be used and any files that
      * are dependencies of these entry files are also considered used files.
@@ -14,17 +16,19 @@ export type FindUnusedFilesOptions = {
      */
     ignorePatterns?: string[];
     /**
-     * Custom aliases that are consulted first before attempting to resolve the import path.
-     * It is recommended to rely on package.json aliases over these custom ones.
+     * Custom resolver to use to resolve an import path relative to a source file.
+     * It is recommended to rely on package.json aliases over these custom ones
+     * when possible.
      */
-    aliases?: Partial<Record<string, string>>;
+    resolvers?: Resolver[];
     /**
      * Maximum depth to traverse. -1 can be used to disable the depth limit (the default).
      */
     depth?: number;
     cwd?: string;
-};
-export type UnusedFilesResult = {
-    unusedFiles: string[];
-};
-export declare function findUnusedFiles({ entryFiles, ignorePatterns, sourceDirectories, aliases, depth, cwd, }: FindUnusedFilesOptions): Promise<UnusedFilesResult>;
+}
+export interface UnusedFilesResult {
+    used: string[];
+    unused: string[];
+}
+export declare function findUnusedFiles({ entryFiles, ignorePatterns, sourceDirectories, resolvers, depth, cwd, }: FindUnusedFilesOptions): Promise<UnusedFilesResult>;

package/lib/api/index.js

@@ -3,42 +3,58 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.findUnusedFiles = void 0;
+exports.findUnusedFiles = findUnusedFiles;
+const node_fs_1 = __importDefault(require("node:fs"));
 const node_path_1 = __importDefault(require("node:path"));
 const debug_1 = __importDefault(require("debug"));
 const fast_glob_1 = __importDefault(require("fast-glob"));
 const walkDependencyTree_1 = require("./walkDependencyTree");
 const debug = (0, debug_1.default)('unused-files');
-async function findUnusedFiles({ entryFiles, ignorePatterns = ['**/node_modules'], sourceDirectories = [], aliases, depth, cwd = process.cwd(), }) {
-    const globFromSource = (source) => fast_glob_1.default.glob(fast_glob_1.default.isDynamicPattern(source) ? source : node_path_1.default.join(source, '**'), {
-        dot: false,
-        ignore: ignorePatterns,
-        absolute: true,
-        cwd,
-    });
+async function findUnusedFiles({ entryFiles, ignorePatterns = ['**/node_modules'], sourceDirectories = [], resolvers, depth, cwd = process.cwd(), }) {
+    cwd = await node_fs_1.default.promises.realpath(cwd);
+    const globFromSource = async (source) => {
+        const files = await fast_glob_1.default.glob(fast_glob_1.default.isDynamicPattern(source) ? source : node_path_1.default.join(source, '**'), {
+            dot: false,
+            ignore: ignorePatterns,
+            absolute: true,
+            cwd,
+        });
+        return Promise.all(files.map(async (file) => await node_fs_1.default.promises.realpath(file).catch(() => file)));
+    };
     const sourceDirs = sourceDirectories.length > 0 ? sourceDirectories : [cwd];
     const files = new Set([].concat(...(await Promise.all(sourceDirs.map((source) => globFromSource(source))))));
     const unvisitedFiles = new Set(files);
+    const visitedFiles = new Set();
     for (const entryFile of entryFiles) {
-        const entry = node_path_1.default.resolve(cwd, entryFile);
+        const entry = await node_fs_1.default.promises.realpath(node_path_1.default.resolve(cwd, entryFile));
         unvisitedFiles.delete(entry);
         for await (const { source, dependency } of (0, walkDependencyTree_1.walkDependencyTree)(entry, {
-            aliases,
+            resolvers,
             depth,
+            visited: visitedFiles,
         })) {
+            let resolvedDependency = dependency;
             if (files.has(dependency)) {
                 debug(`${source}: ${dependency} [dependency]`);
             }
             else {
-                debug(`${source}: ${dependency} [unknown dependency]`);
+                const realpath = await node_fs_1.default.promises.realpath(dependency);
+                if (files.has(realpath)) {
+                    resolvedDependency = realpath;
+                }
+                else {
+                    debug(`${source}: ${dependency} [unknown dependency]`);
+                }
             }
-            unvisitedFiles.delete(dependency);
+            unvisitedFiles.delete(resolvedDependency);
         }
     }
     return {
-        unusedFiles: Array.from(unvisitedFiles)
+        unused: Array.from(unvisitedFiles)
+            .map((abspath) => node_path_1.default.relative(cwd, abspath))
+            .sort(),
+        used: Array.from(visitedFiles)
             .map((abspath) => node_path_1.default.relative(cwd, abspath))
             .sort(),
     };
 }
-exports.findUnusedFiles = findUnusedFiles;

package/lib/api/types.d.ts

@@ -0,0 +1,15 @@
+export interface ResolverResult {
+    /** Resolved path. */
+    result: string;
+}
+export interface ResolverParams {
+    /** The module/path being requested. */
+    request: string;
+    /** The file or directory to resolve the request from. */
+    context: string;
+}
+/**
+ * Used to resolve imports to the absolute path of the file.
+ * Return 'null' if unable to resolve and we will attempt the next resolver in the chain.
+ */
+export type Resolver = (params: ResolverParams) => Promise<ResolverResult | null>;

package/lib/api/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/api/walkDependencyTree.d.ts

@@ -1,5 +1,6 @@
-export declare function walkDependencyTree(source: string, { aliases, visited, depth, }?: {
-    aliases?: Partial<Record<string, string>>;
+import { type Resolver } from './types';
+export declare function walkDependencyTree(source: string, { resolvers, visited, depth, }?: {
+    resolvers?: Resolver[];
     visited?: Set<string>;
     depth?: number;
 }): AsyncGenerator<{

package/lib/api/walkDependencyTree.js

@@ -3,15 +3,15 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.walkDependencyTree = void 0;
+exports.walkDependencyTree = walkDependencyTree;
 const node_fs_1 = __importDefault(require("node:fs"));
 const node_path_1 = __importDefault(require("node:path"));
 const typescript_estree_1 = require("@typescript-eslint/typescript-estree");
 const debug_1 = __importDefault(require("debug"));
 const debug = (0, debug_1.default)('unused-files:parse');
 const DEFAULT_DEPTH_LIMIT = -1; // no depth limit
-const VALID_EXTENSIONS = new Set(['ts', 'tsx', 'mts', 'cts', 'js', 'mjs', 'cjs']);
-async function* walkDependencyTree(source, { aliases, visited, depth = DEFAULT_DEPTH_LIMIT, } = {}) {
+const VALID_EXTENSIONS = new Set(['ts', 'tsx', 'mts', 'cts', 'js', 'jsx', 'mjs', 'cjs']);
+async function* walkDependencyTree(source, { resolvers, visited, depth = DEFAULT_DEPTH_LIMIT, } = {}) {
     const ext = node_path_1.default.extname(source).substring(1);
     if (!VALID_EXTENSIONS.has(ext)) {
         debug(`${source}: Unknown file extension '${ext}' [skipping]`);
@@ -59,6 +59,11 @@ async function* walkDependencyTree(source, { aliases, visited, depth = DEFAULT_D
                         importFroms.add(node.source.value);
                     }
                 }
+                else if (node.source.type === typescript_estree_1.TSESTree.AST_NODE_TYPES.TemplateLiteral &&
+                    !node.source.expressions.length &&
+                    node.source.quasis.length === 1) {
+                    importFroms.add(node.source.quasis[0].value.cooked);
+                }
                 else {
                     debug(`${source}: Dynamic import expression found at ${node.loc.start}:${node.loc.end}`);
                 }
@@ -68,10 +73,12 @@ async function* walkDependencyTree(source, { aliases, visited, depth = DEFAULT_D
     for (const body of ast.body) {
         (0, typescript_estree_1.simpleTraverse)(body, { visitors });
     }
-    const resolveToAbsPath = (request) => {
-        const aliasedPath = aliases?.[request];
-        if (aliasedPath) {
-            return node_path_1.default.resolve(aliasedPath);
+    const resolveToAbsPath = async (request) => {
+        for (const resolver of resolvers ?? []) {
+            const resolution = await resolver({ context: source, request });
+            if (resolution) {
+                return node_path_1.default.resolve(resolution.result);
+            }
         }
         try {
             return require.resolve(request, { paths: [node_path_1.default.dirname(source)] });
@@ -80,12 +87,12 @@ async function* walkDependencyTree(source, { aliases, visited, depth = DEFAULT_D
         return undefined;
     };
     for (const importFrom of Array.from(importFroms)) {
-        const absPath = resolveToAbsPath(importFrom);
+        const absPath = await resolveToAbsPath(importFrom);
         if (absPath) {
             yield { dependency: absPath, source };
             if (depth === -1 || depth > 0) {
                 yield* walkDependencyTree(absPath, {
-                    aliases,
+                    resolvers,
                     visited: visitedSet,
                     depth: depth === -1 ? depth : depth - 1,
                 });
@@ -96,4 +103,3 @@ async function* walkDependencyTree(source, { aliases, visited, depth = DEFAULT_D
         }
     }
 }
-exports.walkDependencyTree = walkDependencyTree;

package/lib/bin.js

@@ -5,7 +5,7 @@ const command_1 = require("./command");
 const cli = new clipanion_1.Cli({
     binaryLabel: '@noahnu/unused-files',
     binaryName: 'yarn @noahnu/unused-files',
-    // eslint-disable-next-line @typescript-eslint/no-var-requires
+    // eslint-disable-next-line @typescript-eslint/no-require-imports
     binaryVersion: require('../package.json').version,
     enableCapture: true,
 });

package/lib/command.js

@@ -57,7 +57,7 @@ class BaseCommand extends clipanion_1.Command {
                 ? -1
                 : parseInt(Math.max(this.depth, -1).toFixed(0), 10),
         });
-        this.context.stdout.write(result.unusedFiles.join('\n'));
+        this.context.stdout.write(result.unused.join('\n'));
     }
 }
 exports.BaseCommand = BaseCommand;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@noahnu/unused-files",
-  "version": "0.0.1",
+  "version": "0.1.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/noahnu/nodejs-tools.git",
@@ -15,7 +15,7 @@
   "scripts": {
     "clean": "run workspace:clean \"$(pwd)\"",
     "prepack": "run workspace:build \"$(pwd)\"",
-    "run-local": "run -T ts-node --transpileOnly ./src/bin.ts"
+    "run-local": "run -T tsx ./src/bin.ts"
   },
   "bin": "./lib/bin.js",
   "main": "./lib/api/index.js",
@@ -31,16 +31,17 @@
   ],
   "dependencies": {
     "@types/debug": "^4.1.12",
-    "@typescript-eslint/typescript-estree": "^6.18.1",
-    "clipanion": "4.0.0-rc.2",
-    "debug": "^4.3.4",
+    "@typescript-eslint/typescript-estree": "^8.13.0",
+    "clipanion": "^4.0.0-rc.4",
+    "debug": "^4.3.7",
     "fast-glob": "^3.3.2",
     "typanion": "^3.14.0"
   },
   "devDependencies": {
     "@jest/globals": "^29.7.0",
     "@noahnu/internal-test-utils": "0.0.0",
-    "@types/node": "^20.9.0"
+    "@types/node": "^22.9.0",
+    "typescript": "^5.6.3"
   },
   "types": "./lib/api/index.d.ts"
 }