knip 5.67.1 → 5.69.0

package/dist/typescript/visitors/helpers.js

@@ -1,4 +1,5 @@
 import ts from 'typescript';
+import { IMPORT_MODIFIERS } from '../../constants.js';
 export const isNotJS = (sourceFile) => !isJS(sourceFile);
 export const isJS = (sourceFile) => sourceFile.scriptKind === ts.ScriptKind.JS || sourceFile.scriptKind === ts.ScriptKind.JSX;
 export const isModule = (sourceFile) => ts.isExternalModule(sourceFile);
@@ -13,7 +14,12 @@ export function getImportsFromPragmas(sourceFile) {
             const { factory: specifier } = jsxImportSourcePragma?.arguments ?? {};
             const pos = jsxImportSourcePragma.range?.pos ?? 0;
             if (specifier)
-                importNodes.push({ specifier, isTypeOnly: true, identifier: '__jsx', pos });
+                importNodes.push({
+                    specifier,
+                    identifier: '__jsx',
+                    pos,
+                    modifiers: IMPORT_MODIFIERS.TYPE_ONLY,
+                });
         }
         const referencePragma = sourceFile.pragmas.get('reference');
         if (referencePragma) {
@@ -22,7 +28,12 @@ export function getImportsFromPragmas(sourceFile) {
                 if (ref.arguments?.types) {
                     const { value: specifier, pos } = ref.arguments.types;
                     if (specifier)
-                        importNodes.push({ specifier, isTypeOnly: true, identifier: undefined, pos });
+                        importNodes.push({
+                            specifier,
+                            identifier: undefined,
+                            pos,
+                            modifiers: IMPORT_MODIFIERS.TYPE_ONLY,
+                        });
                 }
             }
         }

package/dist/typescript/visitors/imports/importDeclaration.js

@@ -1,12 +1,12 @@
 import ts from 'typescript';
-import { IMPORT_STAR } from '../../../constants.js';
+import { IMPORT_MODIFIERS, IMPORT_STAR } from '../../../constants.js';
 import { isDefaultImport } from '../../ast-helpers.js';
 import { importVisitor as visit } from '../index.js';
 export default visit(() => true, node => {
     if (ts.isImportDeclaration(node) && ts.isStringLiteralLike(node.moduleSpecifier)) {
         const specifier = node.moduleSpecifier.text;
         if (!node.importClause) {
-            return { specifier, identifier: undefined, pos: node.pos };
+            return { specifier, identifier: undefined, pos: node.pos, modifiers: IMPORT_MODIFIERS.NONE };
         }
         const imports = [];
         if (isDefaultImport(node)) {
@@ -16,6 +16,7 @@ export default visit(() => true, node => {
                 specifier,
                 symbol: node.importClause.symbol,
                 pos: node.moduleSpecifier.pos,
+                modifiers: IMPORT_MODIFIERS.NONE,
             });
         }
         if (node.importClause?.namedBindings) {
@@ -25,8 +26,8 @@ export default visit(() => true, node => {
                     symbol,
                     specifier,
                     identifier: IMPORT_STAR,
-                    isTypeOnly: node.importClause?.isTypeOnly,
                     pos: symbol?.declarations[0]?.pos ?? node.pos,
+                    modifiers: node.importClause?.isTypeOnly ? IMPORT_MODIFIERS.TYPE_ONLY : IMPORT_MODIFIERS.NONE,
                 });
             }
             if (ts.isNamedImports(node.importClause.namedBindings)) {
@@ -36,8 +37,8 @@ export default visit(() => true, node => {
                         identifier,
                         specifier,
                         symbol: element.symbol,
-                        isTypeOnly: node.importClause?.isTypeOnly,
                         pos: element.getStart(),
+                        modifiers: node.importClause?.isTypeOnly ? IMPORT_MODIFIERS.TYPE_ONLY : IMPORT_MODIFIERS.NONE,
                     });
                 }
             }
@@ -45,8 +46,8 @@ export default visit(() => true, node => {
                 imports.push({
                     specifier,
                     identifier: undefined,
-                    isTypeOnly: node.importClause?.isTypeOnly,
                     pos: node.importClause.namedBindings.pos,
+                    modifiers: node.importClause?.isTypeOnly ? IMPORT_MODIFIERS.TYPE_ONLY : IMPORT_MODIFIERS.NONE,
                 });
             }
         }

package/dist/typescript/visitors/imports/importEqualsDeclaration.js

@@ -1,4 +1,5 @@
 import ts from 'typescript';
+import { IMPORT_MODIFIERS } from '../../../constants.js';
 import { isNotJS } from '../helpers.js';
 import { importVisitor as visit } from '../index.js';
 export default visit(isNotJS, node => {
@@ -7,6 +8,13 @@ export default visit(isNotJS, node => {
         ts.isStringLiteralLike(node.moduleReference.expression)) {
         const specifier = node.moduleReference.expression.text;
         const alias = String(node.name.escapedText);
-        return { specifier, alias, identifier: 'default', symbol: node.symbol, pos: node.moduleReference.expression.pos };
+        return {
+            specifier,
+            alias,
+            identifier: 'default',
+            symbol: node.symbol,
+            pos: node.moduleReference.expression.pos,
+            modifiers: IMPORT_MODIFIERS.NONE,
+        };
     }
 });

package/dist/typescript/visitors/imports/reExportDeclaration.js

@@ -1,19 +1,24 @@
 import ts from 'typescript';
-import { IMPORT_STAR } from '../../../constants.js';
+import { IMPORT_MODIFIERS, IMPORT_STAR } from '../../../constants.js';
 import { importVisitor as visit } from '../index.js';
 export default visit(() => true, node => {
     if (ts.isExportDeclaration(node)) {
         if (node.moduleSpecifier && ts.isStringLiteralLike(node.moduleSpecifier)) {
             if (!node.exportClause) {
-                return { identifier: IMPORT_STAR, specifier: node.moduleSpecifier.text, isReExport: true, pos: node.pos };
+                return {
+                    identifier: IMPORT_STAR,
+                    specifier: node.moduleSpecifier.text,
+                    pos: node.pos,
+                    modifiers: IMPORT_MODIFIERS.RE_EXPORT,
+                };
             }
             if (node.exportClause.kind === ts.SyntaxKind.NamespaceExport) {
                 return {
                     identifier: IMPORT_STAR,
                     namespace: String(node.exportClause.name.text),
                     specifier: node.moduleSpecifier.text,
-                    isReExport: true,
                     pos: node.exportClause.name.pos,
+                    modifiers: IMPORT_MODIFIERS.RE_EXPORT,
                 };
             }
             const specifier = node.moduleSpecifier;
@@ -23,15 +28,15 @@ export default visit(() => true, node => {
                         identifier: String(element.propertyName.text),
                         alias: String(element.name.text),
                         specifier: specifier.text,
-                        isReExport: true,
                         pos: element.pos,
+                        modifiers: IMPORT_MODIFIERS.RE_EXPORT,
                     };
                 }
                 return {
                     identifier: (element.propertyName ?? element.name).getText(),
                     specifier: specifier.text,
-                    isReExport: true,
                     pos: element.pos,
+                    modifiers: IMPORT_MODIFIERS.RE_EXPORT,
                 };
             });
         }

package/dist/util/catalog.d.ts

@@ -0,0 +1,6 @@
+import type { CatalogContainer } from '../CatalogCounselor.js';
+import type { PackageJson } from '../types/package-json.js';
+export declare const DEFAULT_CATALOG = "default";
+export declare const getCatalogContainer: (cwd: string, manifest: PackageJson, manifestPath: string, pnpmWorkspacePath?: string, pnpmWorkspace?: any) => Promise<CatalogContainer>;
+export declare const parseCatalog: (container: CatalogContainer) => Set<string>;
+export declare const extractCatalogReferences: (manifest: PackageJson) => Set<string>;

package/dist/util/catalog.js

@@ -0,0 +1,62 @@
+import { isFile } from './fs.js';
+import { _load } from './loader.js';
+import { basename, join } from './path.js';
+export const DEFAULT_CATALOG = 'default';
+export const getCatalogContainer = async (cwd, manifest, manifestPath, pnpmWorkspacePath, pnpmWorkspace) => {
+    const filePath = pnpmWorkspacePath ?? (isFile(join(cwd, '.yarnrc.yml')) ? join(cwd, '.yarnrc.yml') : manifestPath);
+    const yarnWorkspace = basename(filePath) === '.yarnrc.yml' ? await _load(filePath) : undefined;
+    const catalog = pnpmWorkspace?.catalog ??
+        yarnWorkspace?.catalog ??
+        manifest.catalog ??
+        ((!Array.isArray(manifest.workspaces) && manifest.workspaces?.catalog) || {});
+    const catalogs = pnpmWorkspace?.catalogs ??
+        yarnWorkspace?.catalogs ??
+        manifest.catalogs ??
+        ((!Array.isArray(manifest.workspaces) && manifest.workspaces?.catalogs) || {});
+    return { filePath, catalog, catalogs };
+};
+const extractEntries = (catalog) => {
+    if (catalog && typeof catalog === 'object')
+        return Object.keys(catalog).map(entry => `${DEFAULT_CATALOG}:${entry}`);
+    return [];
+};
+const extractNamedEntries = (catalogs) => {
+    const entries = new Set();
+    if (catalogs && typeof catalogs === 'object') {
+        for (const [catalogName, catalog] of Object.entries(catalogs)) {
+            for (const name of Object.keys(catalog))
+                entries.add(`${catalogName}:${name}`);
+        }
+    }
+    return entries;
+};
+export const parseCatalog = (container) => {
+    const entries = new Set();
+    if ('catalog' in container)
+        for (const id of extractEntries(container.catalog))
+            entries.add(id);
+    if ('catalogs' in container)
+        for (const id of extractNamedEntries(container.catalogs))
+            entries.add(id);
+    return entries;
+};
+export const extractCatalogReferences = (manifest) => {
+    const catalogReferences = new Set();
+    const checkDependencies = (dependencies) => {
+        if (!dependencies)
+            return;
+        for (const [name, version] of Object.entries(dependencies)) {
+            if (typeof version === 'string' && version.startsWith('catalog:')) {
+                const catalogName = version.slice('catalog:'.length) || DEFAULT_CATALOG;
+                catalogReferences.add([catalogName, name].join(':'));
+            }
+        }
+    };
+    checkDependencies(manifest.dependencies);
+    checkDependencies(manifest.devDependencies);
+    checkDependencies(manifest.peerDependencies);
+    checkDependencies(manifest.optionalDependencies);
+    checkDependencies(manifest.resolutions);
+    checkDependencies(manifest.pnpm?.overrides);
+    return catalogReferences;
+};

package/dist/util/cli-arguments.d.ts

@@ -1,4 +1,4 @@
-export declare const helpText = "\u2702\uFE0F  Find unused dependencies, exports and files in your JavaScript and TypeScript projects\n\nUsage: knip [options]\n\nOptions:\n  -c, --config [file]      Configuration file path (default: [.]knip.json[c], knip.(js|ts), knip.config.(js|ts) or package.json#knip)\n  -t, --tsConfig [file]    TypeScript configuration path (default: tsconfig.json)\n  --production             Analyze only production source files (e.g. no test files, devDependencies)\n  --strict                 Consider only direct dependencies of workspace (not devDependencies, not other workspaces)\n  -W, --workspace [dir]    Analyze a single workspace (default: analyze all configured workspaces)\n  --directory [dir]        Run process from a different directory (default: cwd)\n  --cache                  Enable caching\n  --cache-location         Change cache location (default: node_modules/.cache/knip)\n  --watch                  Watch mode\n  --no-gitignore           Don't use .gitignore\n  --include                Report only provided issue type(s), can be comma-separated or repeated (1)\n  --exclude                Exclude provided issue type(s) from report, can be comma-separated or repeated (1)\n  --dependencies           Shortcut for --include dependencies,unlisted,binaries,unresolved\n  --exports                Shortcut for --include exports,nsExports,classMembers,types,nsTypes,enumMembers,duplicates\n  --files                  Shortcut for --include files\n  --fix                    Fix issues\n  --fix-type               Fix only issues of type, can be comma-separated or repeated (2)\n  --format                 Format modified files after --fix using the local formatter\n  --allow-remove-files     Allow Knip to remove files (with --fix)\n  --include-libs           Include type definitions from external dependencies (default: false)\n  --include-entry-exports  Include entry files when reporting unused exports\n  --isolate-workspaces     Isolate workspaces into separate programs\n  -n, --no-progress        Don't show dynamic progress updates (automatically enabled in CI environments)\n  --preprocessor           Preprocess the results before providing it to the reporter(s), can be repeated\n  --preprocessor-options   Pass extra options to the preprocessor (as JSON string, see --reporter-options example)\n  --reporter               Select reporter: symbols, compact, codeowners, json, codeclimate, markdown, disclosure, github-actions, can be repeated (default: symbols)\n  --reporter-options       Pass extra options to the reporter (as JSON string, see example)\n  --tags                   Include or exclude tagged exports\n  --no-config-hints        Suppress configuration hints\n  --treat-config-hints-as-errors    Exit with non-zero code (1) if there are any configuration hints\n  --no-exit-code           Always exit with code zero (0)\n  --max-issues             Maximum number of total issues before non-zero exit code (default: 0)\n  --max-show-issues     Maximum number of issues to display per type\n  -d, --debug              Show debug output\n  --trace                  Show trace output\n  --trace-export [name]    Show trace output for named export(s)\n  --trace-file [file]      Show trace output for exports in file\n  --performance            Measure count and running time of key functions and display stats table\n  --performance-fn [name]  Measure only function [name]\n  --memory                 Measure memory usage and display data table\n  --memory-realtime        Log memory usage in realtime\n  -h, --help               Print this help text\n  -V, --version            Print version\n\n(1) Issue types: files, dependencies, unlisted, unresolved, exports, nsExports, classMembers, types, nsTypes, enumMembers, duplicates\n(2) Fixable issue types: dependencies, exports, types\n\nExamples:\n\n$ knip\n$ knip --production\n$ knip --workspace packages/client --include files,dependencies\n$ knip -c ./config/knip.json --reporter compact\n$ knip --reporter codeowners --reporter-options '{\"path\":\".github/CODEOWNERS\"}'\n$ knip --tags=-lintignore\n\nWebsite: https://knip.dev";
+export declare const helpText = "\u2702\uFE0F  Find unused dependencies, exports and files in your JavaScript and TypeScript projects\n\nUsage: knip [options]\n\nOptions:\n  -c, --config [file]      Configuration file path (default: [.]knip.json[c], knip.(js|ts), knip.config.(js|ts) or package.json#knip)\n  -t, --tsConfig [file]    TypeScript configuration path (default: tsconfig.json)\n  --production             Analyze only production source files (e.g. no test files, devDependencies)\n  --strict                 Consider only direct dependencies of workspace (not devDependencies, not other workspaces)\n  -W, --workspace [dir]    Analyze a single workspace (default: analyze all configured workspaces)\n  --directory [dir]        Run process from a different directory (default: cwd)\n  --cache                  Enable caching\n  --cache-location         Change cache location (default: node_modules/.cache/knip)\n  --watch                  Watch mode\n  --no-gitignore           Don't use .gitignore\n  --include                Report only provided issue type(s), can be comma-separated or repeated (1)\n  --exclude                Exclude provided issue type(s) from report, can be comma-separated or repeated (1)\n  --dependencies           Shortcut for --include dependencies,unlisted,binaries,unresolved,catalog\n  --exports                Shortcut for --include exports,nsExports,classMembers,types,nsTypes,enumMembers,duplicates\n  --files                  Shortcut for --include files\n  --fix                    Fix issues\n  --fix-type               Fix only issues of type, can be comma-separated or repeated (2)\n  --format                 Format modified files after --fix using the local formatter\n  --allow-remove-files     Allow Knip to remove files (with --fix)\n  --include-libs           Include type definitions from external dependencies (default: false)\n  --include-entry-exports  Include entry files when reporting unused exports\n  --isolate-workspaces     Isolate workspaces into separate programs\n  -n, --no-progress        Don't show dynamic progress updates (automatically enabled in CI environments)\n  --preprocessor           Preprocess the results before providing it to the reporter(s), can be repeated\n  --preprocessor-options   Pass extra options to the preprocessor (as JSON string, see --reporter-options example)\n  --reporter               Select reporter: symbols, compact, codeowners, json, codeclimate, markdown, disclosure, github-actions, can be repeated (default: symbols)\n  --reporter-options       Pass extra options to the reporter (as JSON string, see example)\n  --tags                   Include or exclude tagged exports\n  --no-config-hints        Suppress configuration hints\n  --treat-config-hints-as-errors    Exit with non-zero code (1) if there are any configuration hints\n  --no-exit-code           Always exit with code zero (0)\n  --max-issues             Maximum number of total issues before non-zero exit code (default: 0)\n  --max-show-issues     Maximum number of issues to display per type\n  -d, --debug              Show debug output\n  --trace                  Show trace output\n  --trace-export [name]    Show trace output for named export(s)\n  --trace-file [file]      Show trace output for exports in file\n  --performance            Measure count and running time of key functions and display stats table\n  --performance-fn [name]  Measure only function [name]\n  --memory                 Measure memory usage and display data table\n  --memory-realtime        Log memory usage in realtime\n  -h, --help               Print this help text\n  -V, --version            Print version\n\n(1) Issue types: files, dependencies, unlisted, unresolved, exports, nsExports, classMembers, types, nsTypes, enumMembers, duplicates, catalog\n(2) Fixable issue types: dependencies, exports, types, catalog\n\nExamples:\n\n$ knip\n$ knip --production\n$ knip --workspace packages/client --include files,dependencies\n$ knip -c ./config/knip.json --reporter compact\n$ knip --reporter codeowners --reporter-options '{\"path\":\".github/CODEOWNERS\"}'\n$ knip --tags=-lintignore\n\nWebsite: https://knip.dev";
 export type ParsedCLIArgs = ReturnType<typeof parseCLIArgs>;
 export default function parseCLIArgs(): {
     cache?: boolean | undefined;

package/dist/util/cli-arguments.js

@@ -16,7 +16,7 @@ Options:
   --no-gitignore           Don't use .gitignore
   --include                Report only provided issue type(s), can be comma-separated or repeated (1)
   --exclude                Exclude provided issue type(s) from report, can be comma-separated or repeated (1)
-  --dependencies           Shortcut for --include dependencies,unlisted,binaries,unresolved
+  --dependencies           Shortcut for --include dependencies,unlisted,binaries,unresolved,catalog
   --exports                Shortcut for --include exports,nsExports,classMembers,types,nsTypes,enumMembers,duplicates
   --files                  Shortcut for --include files
   --fix                    Fix issues
@@ -48,8 +48,8 @@ Options:
   -h, --help               Print this help text
   -V, --version            Print version
 
-(1) Issue types: files, dependencies, unlisted, unresolved, exports, nsExports, classMembers, types, nsTypes, enumMembers, duplicates
-(2) Fixable issue types: dependencies, exports, types
+(1) Issue types: files, dependencies, unlisted, unresolved, exports, nsExports, classMembers, types, nsTypes, enumMembers, duplicates, catalog
+(2) Fixable issue types: dependencies, exports, types, catalog
 
 Examples:
 

package/dist/util/create-options.d.ts

@@ -5,6 +5,7 @@ interface CreateOptions extends Partial<Options> {
 }
 export declare const createOptions: (options: CreateOptions) => Promise<{
     cacheLocation: string;
+    catalog: import("../CatalogCounselor.js").CatalogContainer;
     config: string | undefined;
     configFilePath: string | undefined;
     cwd: string;
@@ -19,6 +20,7 @@ export declare const createOptions: (options: CreateOptions) => Promise<{
     isDebug: boolean;
     isDisableConfigHints: boolean;
     isFix: boolean;
+    isFixCatalog: boolean;
     isFixDependencies: boolean;
     isFixFiles: boolean | undefined;
     isFixUnusedExports: boolean;
@@ -264,6 +266,16 @@ export declare const createOptions: (options: CreateOptions) => Promise<{
             entry?: string | string[] | undefined;
             project?: string | string[] | undefined;
         } | undefined;
+        mdx?: string | boolean | string[] | {
+            config?: string | string[] | undefined;
+            entry?: string | string[] | undefined;
+            project?: string | string[] | undefined;
+        } | undefined;
+        mdxlint?: string | boolean | string[] | {
+            config?: string | string[] | undefined;
+            entry?: string | string[] | undefined;
+            project?: string | string[] | undefined;
+        } | undefined;
         metro?: string | boolean | string[] | {
             config?: string | string[] | undefined;
             entry?: string | string[] | undefined;
@@ -845,6 +857,16 @@ export declare const createOptions: (options: CreateOptions) => Promise<{
                 entry?: string | string[] | undefined;
                 project?: string | string[] | undefined;
             } | undefined;
+            mdx?: string | boolean | string[] | {
+                config?: string | string[] | undefined;
+                entry?: string | string[] | undefined;
+                project?: string | string[] | undefined;
+            } | undefined;
+            mdxlint?: string | boolean | string[] | {
+                config?: string | string[] | undefined;
+                entry?: string | string[] | undefined;
+                project?: string | string[] | undefined;
+            } | undefined;
             metro?: string | boolean | string[] | {
                 config?: string | string[] | undefined;
                 entry?: string | string[] | undefined;
@@ -1211,10 +1233,10 @@ export declare const createOptions: (options: CreateOptions) => Promise<{
             ignoreUnresolved?: (string | RegExp)[] | undefined;
             includeEntryExports?: boolean | undefined;
         }> | undefined;
-        include?: ("files" | "dependencies" | "devDependencies" | "optionalPeerDependencies" | "unlisted" | "binaries" | "unresolved" | "exports" | "nsExports" | "types" | "nsTypes" | "enumMembers" | "classMembers" | "duplicates")[] | undefined;
-        exclude?: ("files" | "dependencies" | "devDependencies" | "optionalPeerDependencies" | "unlisted" | "binaries" | "unresolved" | "exports" | "nsExports" | "types" | "nsTypes" | "enumMembers" | "classMembers" | "duplicates")[] | undefined;
+        include?: ("files" | "dependencies" | "devDependencies" | "optionalPeerDependencies" | "unlisted" | "binaries" | "unresolved" | "exports" | "nsExports" | "types" | "nsTypes" | "enumMembers" | "classMembers" | "duplicates" | "catalog")[] | undefined;
+        exclude?: ("files" | "dependencies" | "devDependencies" | "optionalPeerDependencies" | "unlisted" | "binaries" | "unresolved" | "exports" | "nsExports" | "types" | "nsTypes" | "enumMembers" | "classMembers" | "duplicates" | "catalog")[] | undefined;
         $schema?: string | undefined;
-        rules?: Partial<Record<"files" | "dependencies" | "devDependencies" | "optionalPeerDependencies" | "unlisted" | "binaries" | "unresolved" | "exports" | "nsExports" | "types" | "nsTypes" | "enumMembers" | "classMembers" | "duplicates", "error" | "warn" | "off">> | undefined;
+        rules?: Partial<Record<"files" | "dependencies" | "devDependencies" | "optionalPeerDependencies" | "unlisted" | "binaries" | "unresolved" | "exports" | "nsExports" | "types" | "nsTypes" | "enumMembers" | "classMembers" | "duplicates" | "catalog", "error" | "warn" | "off">> | undefined;
         entry?: string | string[] | undefined;
         project?: string | string[] | undefined;
         paths?: Record<string, string[]> | undefined;
@@ -1225,7 +1247,7 @@ export declare const createOptions: (options: CreateOptions) => Promise<{
         ignoreMembers?: (string | RegExp)[] | undefined;
         ignoreUnresolved?: (string | RegExp)[] | undefined;
         ignoreExportsUsedInFile?: boolean | Record<string, boolean | undefined> | undefined;
-        ignoreIssues?: Record<string, ("files" | "dependencies" | "devDependencies" | "optionalPeerDependencies" | "unlisted" | "binaries" | "unresolved" | "exports" | "nsExports" | "types" | "nsTypes" | "enumMembers" | "classMembers" | "duplicates")[]> | undefined;
+        ignoreIssues?: Record<string, ("files" | "dependencies" | "devDependencies" | "optionalPeerDependencies" | "unlisted" | "binaries" | "unresolved" | "exports" | "nsExports" | "types" | "nsTypes" | "enumMembers" | "classMembers" | "duplicates" | "catalog")[]> | undefined;
         ignoreWorkspaces?: string[] | undefined;
         includeEntryExports?: boolean | undefined;
         compilers?: Record<string, true | ((filename: string, contents: string) => string) | ((filename: string, contents: string) => Promise<string>)> | undefined;
@@ -1249,6 +1271,7 @@ export declare const createOptions: (options: CreateOptions) => Promise<{
         enumMembers: import("../types/issues.js").IssueSeverity;
         classMembers: import("../types/issues.js").IssueSeverity;
         duplicates: import("../types/issues.js").IssueSeverity;
+        catalog: import("../types/issues.js").IssueSeverity;
         _files: import("../types/issues.js").IssueSeverity;
     };
     tags: import("../types/options.js").Tags;

package/dist/util/create-options.js

@@ -1,9 +1,10 @@
 import { partitionCompilers } from '../compilers/index.js';
 import { KNIP_CONFIG_LOCATIONS } from '../constants.js';
 import { knipConfigurationSchema } from '../schema/configuration.js';
+import { getCatalogContainer } from './catalog.js';
 import { ConfigurationError } from './errors.js';
 import { findFile, loadJSON } from './fs.js';
-import { getIncludedIssueTypes, shorthandDeps, shorthandFiles, shorthandTypes } from './get-included-issue-types.js';
+import { getIncludedIssueTypes, shorthandDeps, shorthandExports, shorthandFiles } from './get-included-issue-types.js';
 import { defaultRules } from './issue-initializers.js';
 import { loadResolvedConfigFile } from './load-config.js';
 import { _load } from './loader.js';
@@ -34,9 +35,9 @@ export const createOptions = async (options) => {
     const parsedConfig = knipConfigurationSchema.parse(partitionCompilers(loadedConfig));
     if (!configFilePath && manifest.knip)
         configFilePath = manifestPath;
-    const pnpmWorkspacesPath = findFile(cwd, 'pnpm-workspace.yaml');
-    const pnpmWorkspaces = pnpmWorkspacesPath && (await _load(pnpmWorkspacesPath));
-    const workspaces = pnpmWorkspaces?.packages ??
+    const pnpmWorkspacePath = findFile(cwd, 'pnpm-workspace.yaml');
+    const pnpmWorkspace = pnpmWorkspacePath && (await _load(pnpmWorkspacePath));
+    const workspaces = pnpmWorkspace?.packages ??
         (manifest.workspaces
             ? Array.isArray(manifest.workspaces)
                 ? manifest.workspaces
@@ -54,7 +55,7 @@ export const createOptions = async (options) => {
         includeOverrides: [
             ...(options.includedIssueTypes ?? parsedCLIArgs.include ?? []),
             ...(parsedCLIArgs.dependencies ? shorthandDeps : []),
-            ...(parsedCLIArgs.exports ? shorthandTypes : []),
+            ...(parsedCLIArgs.exports ? shorthandExports : []),
             ...(parsedCLIArgs.files ? shorthandFiles : []),
         ],
     });
@@ -69,6 +70,7 @@ export const createOptions = async (options) => {
     const tags = splitTags(parsedCLIArgs.tags ?? options.tags ?? parsedConfig.tags ?? parsedCLIArgs['experimental-tags'] ?? []);
     return {
         cacheLocation: parsedCLIArgs['cache-location'] ?? join(cwd, 'node_modules', '.cache', 'knip'),
+        catalog: await getCatalogContainer(cwd, manifest, manifestPath, pnpmWorkspacePath, pnpmWorkspace),
         config: parsedCLIArgs.config,
         configFilePath,
         cwd,
@@ -83,6 +85,7 @@ export const createOptions = async (options) => {
         isDebug: parsedCLIArgs.debug ?? false,
         isDisableConfigHints: parsedCLIArgs['no-config-hints'] || isProduction || Boolean(parsedCLIArgs.workspace),
         isFix: parsedCLIArgs.fix ?? options.isFix ?? isFixFiles ?? fixTypes.length > 0,
+        isFixCatalog: fixTypes.length === 0 || fixTypes.includes('catalog'),
         isFixDependencies: fixTypes.length === 0 || fixTypes.includes('dependencies'),
         isFixFiles,
         isFixUnusedExports: fixTypes.length === 0 || fixTypes.includes('exports'),

package/dist/util/errors.js

@@ -9,6 +9,16 @@ export const hasErrorCause = (error) => !isZodErrorLike(error) && error.cause in
 export const isConfigurationError = (error) => error instanceof ConfigurationError;
 export const getKnownErrors = (error) => {
     if (isZodErrorLike(error))
-        return [...error.issues].map(error => new Error(error.message));
+        return [...error.issues].map(error => {
+            let message = error.message;
+            const details = [];
+            if (error.path.length > 0)
+                details.push(`location: ${error.path.join('.')}`);
+            if (typeof error.expected === 'string')
+                details.push(`expected: ${error.expected}`);
+            if (details.length > 0)
+                message += ` (${details.join(', ')})`;
+            return new Error(message);
+        });
     return [error];
 };

package/dist/util/get-included-issue-types.d.ts

@@ -8,7 +8,7 @@ type GetIncludedIssueTypesOptions = {
 };
 export declare const defaultExcludedIssueTypes: string[];
 export declare const shorthandDeps: string[];
-export declare const shorthandTypes: string[];
+export declare const shorthandExports: string[];
 export declare const shorthandFiles: string[];
 export declare const getIncludedIssueTypes: (options: GetIncludedIssueTypesOptions) => Report;
 export {};

package/dist/util/get-included-issue-types.js

@@ -3,8 +3,8 @@ import { ConfigurationError } from './errors.js';
 export const defaultExcludedIssueTypes = ['classMembers', 'nsExports', 'nsTypes'];
 const defaultIssueTypes = ISSUE_TYPES.filter(type => !defaultExcludedIssueTypes.includes(type));
 const normalize = (values) => values.flatMap(value => value.split(','));
-export const shorthandDeps = ['dependencies', 'optionalPeerDependencies', 'unlisted', 'binaries', 'unresolved'];
-export const shorthandTypes = ['types', 'nsTypes', 'enumMembers', 'duplicates'];
+export const shorthandDeps = ['dependencies', 'unlisted', 'binaries', 'unresolved', 'catalog'];
+export const shorthandExports = ['exports', 'types', 'enumMembers', 'duplicates'];
 export const shorthandFiles = ['files'];
 export const getIncludedIssueTypes = (options) => {
     const incl = normalize(options.includeOverrides ?? []);
@@ -19,6 +19,7 @@ export const getIncludedIssueTypes = (options) => {
     const _exclude = [...excl, ...excludes];
     if (options.isProduction) {
         _exclude.push('devDependencies');
+        _exclude.push('catalog');
     }
     else {
         if (_include.includes('dependencies'))

package/dist/util/modules.js

@@ -38,24 +38,36 @@ export const getPackageFromDefinitelyTyped = (typedDependency) => {
     }
     return typedDependency;
 };
+const CHAR_EXCLAMATION = 33;
+const CHAR_DASH = 45;
+const CHAR_SLASH = 47;
+const CHAR_COLON = 58;
+const CHAR_HASH = 35;
+const CHAR_QUESTION = 63;
 export const sanitizeSpecifier = (specifier) => {
     if (isBuiltin(specifier) || isAbsolute(specifier) || specifier.startsWith(PROTOCOL_VIRTUAL))
         return specifier;
-    let s = specifier;
-    let end = s.length;
-    let i = 0;
-    while (i < s.length && (s[i] === '!' || s[i] === '-'))
-        i++;
-    s = s.substring(i);
-    for (let j = 0; j < s.length; j++) {
-        const char = s[j];
-        if (char === '!' || char === '?' || (char === '#' && j > 0)) {
-            end = j;
+    const len = specifier.length;
+    let start = 0;
+    let end = len;
+    let colon = -1;
+    let sawSlash = false;
+    for (let i = 0; i < len; i++) {
+        const ch = specifier.charCodeAt(i);
+        if (i === start && (ch === CHAR_EXCLAMATION || ch === CHAR_DASH)) {
+            start++;
+            continue;
+        }
+        if (ch === CHAR_SLASH && colon === -1) {
+            sawSlash = true;
+        }
+        if (colon === -1 && ch === CHAR_COLON && !sawSlash) {
+            colon = i;
+        }
+        if (ch === CHAR_EXCLAMATION || ch === CHAR_QUESTION || (ch === CHAR_HASH && i > start)) {
+            end = i;
             break;
         }
     }
-    s = s.substring(0, end);
-    if (s.includes(':') && !s.includes('/'))
-        s = s.split(':')[0];
-    return s;
+    return colon !== -1 && colon < end ? specifier.slice(start, colon) : specifier.slice(start, end);
 };

package/dist/util/trace.js

@@ -9,14 +9,14 @@ const getPadding = (level, levels) => {
         padding += levels.has(i) ? `${picocolors.dim('│')}  ` : '   ';
     return padding;
 };
-const renderTrace = (node, level = 0, levels = new Set()) => {
+const renderTrace = (node, options, level = 0, levels = new Set()) => {
     let index = 0;
     const size = node.children.size;
     const padding = getPadding(level, levels);
     for (const child of node.children) {
         const isLast = ++index === size;
         const hasRef = child.hasRef === true;
-        const rel = child.filePath;
+        const rel = toRelative(child.filePath, options.cwd);
         const file = hasRef ? rel : picocolors.dim(rel);
         const suffix = (hasRef ? HAS_REF : '') + (child.isEntry ? IS_ENTRY : '');
         const text = `${padding}${picocolors.dim(isLast ? '└─' : '├─')} ${file}${suffix}`;
@@ -26,7 +26,7 @@ const renderTrace = (node, level = 0, levels = new Set()) => {
                 levels.add(level);
             if (isLast)
                 levels.delete(level);
-            renderTrace(child, level + 1, levels);
+            renderTrace(child, options, level + 1, levels);
         }
     }
 };
@@ -40,7 +40,7 @@ export const printTrace = (node, filePath, options, identifier) => {
     const suffix = (node.isEntry ? IS_ENTRY : '') + (node.children.size === 0 ? HAS_NO_REF : '');
     const header = `${toRelative(filePath, options.cwd)}${identifier ? `:${identifier}` : ''}${suffix}`;
     console.log(header);
-    renderTrace(node);
+    renderTrace(node, options);
     console.log();
 };
 export const createNode = (filePath, { hasRef = false, isEntry = false, identifier } = {}) => ({

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const version = "5.67.1";
+export declare const version = "5.69.0";

package/dist/version.js

@@ -1 +1 @@
-export const version = '5.67.1';
+export const version = '5.69.0';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "knip",
-  "version": "5.67.1",
+  "version": "5.69.0",
   "description": "Find and fix unused dependencies, exports and files in your TypeScript and JavaScript projects",
   "homepage": "https://knip.dev",
   "repository": {