knip 6.29.0 → 6.31.0

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  -h, --help                   Print this help text\n  -V, --version                Print version\n  -n, --no-progress            Don't show dynamic progress updates (automatically enabled in CI environments)\n  -c, --config [file]          Configuration file path\n                               (default: [.]knip.json[c], knip.(js|ts), knip.config.(js|ts) or package.json#knip)\n      --use-tsconfig-files     Use tsconfig.json to define project files (override `project` patterns)\n  -t, --tsConfig [file]        TypeScript configuration path (default: tsconfig.json)\n\nMode\n      --cache                  Enable caching\n      --cache-location         Change cache location (default: node_modules/.cache/knip)\n      --include-entry-exports  Include entry files when reporting unused exports\n      --no-gitignore           Don't respect .gitignore\n  -p, --production             Analyze only production source files (e.g. no test files, devDependencies)\n  -s, --strict                 Consider only direct dependencies of workspace (not devDependencies, not other workspaces)\n  -w, --watch                  Watch mode\n\nScope\n  -W, --workspace [filter]     Filter workspaces by name, directory, or glob (can be repeated)\n  -D, --directory [dir]        Run process from a different directory (default: cwd)\n      --include                Include 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,types,nsTypes,enumMembers,namespaceMembers,duplicates\n      --files                  Shortcut for --include files\n      --cycles                 Shortcut for --include cycles (circular dependencies)\n      --tags                   Include or exclude tagged exports\n\nFix\n  -f, --fix                    Fix issues (modifies files in your repo)\n      --fix-type               Fix only issues of type, can be comma-separated or repeated (2)\n      --allow-remove-files     Allow Knip to remove files (with --fix)\n  -F, --format                 Format modified files after --fix using the local formatter\n\nOutput\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 (default: symbols), can be repeated (3)\n      --reporter-options       Pass extra options to the reporter (as JSON string, see example)\n      --no-config-hints        Suppress configuration hints\n      --no-tag-hints           Suppress tag hints\n      --treat-config-hints-as-errors   Exit with non-zero code (1) if there are any configuration hints\n      --treat-tag-hints-as-errors      Exit with non-zero code (1) if there are any tag hints\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      --no-exit-code           Always exit with code zero (0)\n\nTroubleshooting\n  -d, --debug                  Show debug output\n      --memory                 Measure memory usage and display data table\n      --memory-realtime        Log memory usage in realtime\n      --performance            Measure count and running time of key functions and display stats table\n      --performance-fn [name]  Measure only function [name]\n  -u, --duration               Print total running time (zero overhead, no instrumentation)\n      --trace                  Show trace output\n      --trace-dependency [name]  Show files that import the named dependency\n      --trace-export [name]    Show trace output for named export(s)\n      --trace-file [file]      Show trace output for exports in file\n\n(1) Issue types: files, dependencies, unlisted, unresolved, exports, nsExports, types, nsTypes, enumMembers, namespaceMembers, duplicates, catalog, cycles\n(2) Fixable issue types: dependencies, exports, types, files, catalog\n(3) Built-in reporters: symbols (default), compact, codeowners, cycles, json, codeclimate, markdown, disclosure, github-actions\n\nExamples:\n\n$ knip\n$ knip --production\n$ knip --workspace packages/client --include files,dependencies\n$ knip --workspace @myorg/* --workspace '!@myorg/legacy'\n$ knip --workspace './apps/*' --workspace '@shared/utils'\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  -h, --help                   Print this help text\n  -V, --version                Print version\n  -n, --no-progress            Don't show dynamic progress updates (automatically enabled in CI environments)\n  -c, --config [file]          Configuration file path\n                               (default: [.]knip.json[c], knip.(js|ts), knip.config.(js|ts) or package.json#knip)\n      --use-tsconfig-files     Use tsconfig.json to define project files (override `project` patterns)\n  -t, --tsConfig [file]        TypeScript configuration path (default: tsconfig.json)\n\nMode\n      --cache                  Enable caching\n      --cache-location         Change cache location (default: node_modules/.cache/knip)\n      --include-entry-exports  Include entry files when reporting unused exports\n      --no-gitignore           Don't respect .gitignore\n  -p, --production             Analyze only production source files (e.g. no test files, devDependencies)\n  -s, --strict                 Consider only direct dependencies of workspace (not devDependencies, not other workspaces)\n  -w, --watch                  Watch mode\n\nScope\n  -W, --workspace [filter]     Filter workspaces by name, directory, or glob (can be repeated)\n  -D, --directory [dir]        Run process from a different directory (default: cwd)\n      --include                Include 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,catalogReferences\n      --exports                Shortcut for --include exports,nsExports,types,nsTypes,enumMembers,namespaceMembers,duplicates\n      --files                  Shortcut for --include files\n      --cycles                 Shortcut for --include cycles (circular dependencies)\n      --tags                   Include or exclude tagged exports\n\nFix\n  -f, --fix                    Fix issues (modifies files in your repo)\n      --fix-type               Fix only issues of type, can be comma-separated or repeated (2)\n      --allow-remove-files     Allow Knip to remove files (with --fix)\n  -F, --format                 Format modified files after --fix using the local formatter\n\nOutput\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 (default: symbols), can be repeated (3)\n      --reporter-options       Pass extra options to the reporter (as JSON string, see example)\n      --no-config-hints        Suppress configuration hints\n      --no-tag-hints           Suppress tag hints\n      --treat-config-hints-as-errors   Exit with non-zero code (1) if there are any configuration hints\n      --treat-tag-hints-as-errors      Exit with non-zero code (1) if there are any tag hints\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      --no-exit-code           Always exit with code zero (0)\n\nTroubleshooting\n  -d, --debug                  Show debug output\n      --memory                 Measure memory usage and display data table\n      --memory-realtime        Log memory usage in realtime\n      --performance            Measure count and running time of key functions and display stats table\n      --performance-fn [name]  Measure only function [name]\n  -u, --duration               Print total running time (zero overhead, no instrumentation)\n      --trace                  Show trace output\n      --trace-dependency [name]  Show files that import the named dependency\n      --trace-export [name]    Show trace output for named export(s)\n      --trace-file [file]      Show trace output for exports in file\n\n(1) Issue types: files, dependencies, unlisted, unresolved, exports, nsExports, types, nsTypes, enumMembers, namespaceMembers, duplicates, catalog, catalogReferences, cycles\n(2) Fixable issue types: dependencies, exports, types, files, catalog\n(3) Built-in reporters: symbols (default), compact, codeowners, cycles, json, codeclimate, markdown, disclosure, github-actions, sarif\n\nExamples:\n\n$ knip\n$ knip --production\n$ knip --workspace packages/client --include files,dependencies\n$ knip --workspace @myorg/* --workspace '!@myorg/legacy'\n$ knip --workspace './apps/*' --workspace '@shared/utils'\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

@@ -26,7 +26,7 @@ Scope
   -D, --directory [dir]        Run process from a different directory (default: cwd)
       --include                Include 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,catalog
+      --dependencies           Shortcut for --include dependencies,unlisted,binaries,unresolved,catalog,catalogReferences
       --exports                Shortcut for --include exports,nsExports,types,nsTypes,enumMembers,namespaceMembers,duplicates
       --files                  Shortcut for --include files
       --cycles                 Shortcut for --include cycles (circular dependencies)
@@ -63,9 +63,9 @@ Troubleshooting
       --trace-export [name]    Show trace output for named export(s)
       --trace-file [file]      Show trace output for exports in file
 
-(1) Issue types: files, dependencies, unlisted, unresolved, exports, nsExports, types, nsTypes, enumMembers, namespaceMembers, duplicates, catalog, cycles
+(1) Issue types: files, dependencies, unlisted, unresolved, exports, nsExports, types, nsTypes, enumMembers, namespaceMembers, duplicates, catalog, catalogReferences, cycles
 (2) Fixable issue types: dependencies, exports, types, files, catalog
-(3) Built-in reporters: symbols (default), compact, codeowners, cycles, json, codeclimate, markdown, disclosure, github-actions
+(3) Built-in reporters: symbols (default), compact, codeowners, cycles, json, codeclimate, markdown, disclosure, github-actions, sarif
 
 Examples:
 

package/dist/util/codeowners.js

@@ -12,7 +12,7 @@ export function parseCodeowners(content) {
         return { owners, match: picomatch(expandIgnorePatterns([pattern], true)) };
     });
     return (filePath) => {
-        for (const matcher of [...matchers].reverse()) {
+        for (const matcher of matchers.toReversed()) {
             if (matcher.match(filePath)) {
                 return matcher.owners;
             }

package/dist/util/create-input-handler.js

@@ -55,11 +55,17 @@ export const createInputHandler = (deputy, chief, isGitIgnored, addIssue, extern
         const isWorkspace = chief.workspacesByPkgName.has(packageName);
         const inputWorkspace = getWorkspaceFor(input, chief, workspace);
         if (inputWorkspace) {
-            let isHandled = deputy.maybeAddReferencedExternalDependency(inputWorkspace, packageName, isConfig(input), input.isTypeOnly);
+            let isHandled = deputy.maybeAddReferencedExternalDependency(inputWorkspace, packageName, {
+                isDevOnly: isConfig(input),
+                isTypeOnly: input.isTypeOnly,
+            });
             if (input.isTypeOnly && input.containingFilePath) {
                 const owningWorkspace = chief.findWorkspaceByFilePath(input.containingFilePath);
                 if (owningWorkspace && owningWorkspace !== inputWorkspace) {
-                    const isOwnerHandled = deputy.maybeAddReferencedExternalDependency(owningWorkspace, packageName, isConfig(input), input.isTypeOnly);
+                    const isOwnerHandled = deputy.maybeAddReferencedExternalDependency(owningWorkspace, packageName, {
+                        isDevOnly: isConfig(input),
+                        isTypeOnly: input.isTypeOnly,
+                    });
                     isHandled = isHandled || isOwnerHandled;
                 }
             }

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

@@ -340,6 +340,11 @@ export declare const createOptions: (options: CreateOptions) => Promise<{
             entry?: string | string[] | undefined;
             project?: string | string[] | undefined;
         } | undefined;
+        marko?: string | boolean | string[] | {
+            config?: string | string[] | undefined;
+            entry?: string | string[] | undefined;
+            project?: string | string[] | undefined;
+        } | undefined;
         mdx?: string | boolean | string[] | {
             config?: string | string[] | undefined;
             entry?: string | string[] | undefined;
@@ -936,7 +941,7 @@ export declare const createOptions: (options: CreateOptions) => Promise<{
             project?: string | string[] | undefined;
         } | undefined;
         $schema?: string | undefined;
-        rules?: Partial<Record<"binaries" | "catalog" | "cycles" | "dependencies" | "devDependencies" | "duplicates" | "enumMembers" | "exports" | "files" | "namespaceMembers" | "nsExports" | "nsTypes" | "optionalPeerDependencies" | "types" | "unlisted" | "unresolved", "error" | "off" | "warn">> | undefined;
+        rules?: Partial<Record<"binaries" | "catalog" | "catalogReferences" | "cycles" | "dependencies" | "devDependencies" | "duplicates" | "enumMembers" | "exports" | "files" | "namespaceMembers" | "nsExports" | "nsTypes" | "optionalPeerDependencies" | "types" | "unlisted" | "unresolved", "error" | "off" | "warn">> | undefined;
         entry?: string | string[] | undefined;
         project?: string | string[] | undefined;
         paths?: Record<string, string[]> | undefined;
@@ -947,7 +952,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, ("binaries" | "catalog" | "cycles" | "dependencies" | "devDependencies" | "duplicates" | "enumMembers" | "exports" | "files" | "namespaceMembers" | "nsExports" | "nsTypes" | "optionalPeerDependencies" | "types" | "unlisted" | "unresolved")[]> | undefined;
+        ignoreIssues?: Record<string, ("binaries" | "catalog" | "catalogReferences" | "cycles" | "dependencies" | "devDependencies" | "duplicates" | "enumMembers" | "exports" | "files" | "namespaceMembers" | "nsExports" | "nsTypes" | "optionalPeerDependencies" | "types" | "unlisted" | "unresolved")[]> | undefined;
         cycles?: {
             allow?: string[][] | undefined;
             dynamicImports?: boolean | undefined;
@@ -960,8 +965,8 @@ export declare const createOptions: (options: CreateOptions) => Promise<{
         tags?: string[] | undefined;
         treatConfigHintsAsErrors?: boolean | undefined;
         treatTagHintsAsErrors?: boolean | undefined;
-        include?: ("binaries" | "catalog" | "cycles" | "dependencies" | "devDependencies" | "duplicates" | "enumMembers" | "exports" | "files" | "namespaceMembers" | "nsExports" | "nsTypes" | "optionalPeerDependencies" | "types" | "unlisted" | "unresolved")[] | undefined;
-        exclude?: ("binaries" | "catalog" | "cycles" | "dependencies" | "devDependencies" | "duplicates" | "enumMembers" | "exports" | "files" | "namespaceMembers" | "nsExports" | "nsTypes" | "optionalPeerDependencies" | "types" | "unlisted" | "unresolved")[] | undefined;
+        include?: ("binaries" | "catalog" | "catalogReferences" | "cycles" | "dependencies" | "devDependencies" | "duplicates" | "enumMembers" | "exports" | "files" | "namespaceMembers" | "nsExports" | "nsTypes" | "optionalPeerDependencies" | "types" | "unlisted" | "unresolved")[] | undefined;
+        exclude?: ("binaries" | "catalog" | "catalogReferences" | "cycles" | "dependencies" | "devDependencies" | "duplicates" | "enumMembers" | "exports" | "files" | "namespaceMembers" | "nsExports" | "nsTypes" | "optionalPeerDependencies" | "types" | "unlisted" | "unresolved")[] | undefined;
         workspaces?: Record<string, {
             angular?: string | boolean | string[] | {
                 config?: string | string[] | undefined;
@@ -1258,6 +1263,11 @@ export declare const createOptions: (options: CreateOptions) => Promise<{
                 entry?: string | string[] | undefined;
                 project?: string | string[] | undefined;
             } | undefined;
+            marko?: string | boolean | string[] | {
+                config?: string | string[] | undefined;
+                entry?: string | string[] | undefined;
+                project?: string | string[] | undefined;
+            } | undefined;
             mdx?: string | boolean | string[] | {
                 config?: string | string[] | undefined;
                 entry?: string | string[] | undefined;
@@ -1863,13 +1873,14 @@ 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, ("binaries" | "catalog" | "cycles" | "dependencies" | "devDependencies" | "duplicates" | "enumMembers" | "exports" | "files" | "namespaceMembers" | "nsExports" | "nsTypes" | "optionalPeerDependencies" | "types" | "unlisted" | "unresolved")[]> | undefined;
+            ignoreIssues?: Record<string, ("binaries" | "catalog" | "catalogReferences" | "cycles" | "dependencies" | "devDependencies" | "duplicates" | "enumMembers" | "exports" | "files" | "namespaceMembers" | "nsExports" | "nsTypes" | "optionalPeerDependencies" | "types" | "unlisted" | "unresolved")[]> | undefined;
             includeEntryExports?: boolean | undefined;
         }> | undefined;
     };
     rules: {
         binaries: import("../types/issues.ts").IssueSeverity;
         catalog: import("../types/issues.ts").IssueSeverity;
+        catalogReferences: import("../types/issues.ts").IssueSeverity;
         cycles: import("../types/issues.ts").IssueSeverity;
         dependencies: import("../types/issues.ts").IssueSeverity;
         devDependencies: import("../types/issues.ts").IssueSeverity;

package/dist/util/disk-cache.js

@@ -7,7 +7,7 @@ import { isDirectory, isFile } from './fs.js';
 import { dirname } from './path.js';
 export const mtimeMatches = (filePath, mtimeMs) => {
     try {
-        return fs.statSync(filePath).mtimeMs === mtimeMs;
+        return fs.statSync(filePath, { throwIfNoEntry: false })?.mtimeMs === mtimeMs;
     }
     catch {
         return false;

package/dist/util/errors.js

@@ -1,4 +1,5 @@
 import { core } from 'zod/mini';
+import { substringBefore } from './string.js';
 const isZodErrorLike = (error) => error instanceof core.$ZodError;
 export class ConfigurationError extends Error {
 }
@@ -13,11 +14,11 @@ export const formatCauseMessage = (error, cwd) => {
     let root = error;
     while (root.cause instanceof Error)
         root = root.cause;
-    return root.message.split('\n', 1)[0].replace(`${cwd}/`, '');
+    return substringBefore(root.message, '\n').replace(`${cwd}/`, '');
 };
 export const getKnownErrors = (error) => {
     if (isZodErrorLike(error))
-        return [...error.issues].map(error => {
+        return Array.from(error.issues, error => {
             let message = error.message;
             const details = [];
             if (error.path.length > 0)

package/dist/util/file-entry-cache.js

@@ -31,12 +31,16 @@ export class FileEntryCache {
             return existing;
         let fstat;
         try {
-            fstat = fs.statSync(filePath);
+            fstat = fs.statSync(filePath, { throwIfNoEntry: false });
         }
         catch (error) {
             this.removeEntry(filePath);
             return { key: filePath, notFound: true, err: error };
         }
+        if (!fstat) {
+            this.removeEntry(filePath);
+            return { key: filePath, notFound: true };
+        }
         let meta = this.cache.get(filePath);
         const cSize = fstat.size;
         const cTime = fstat.mtime.getTime();

package/dist/util/fs.js

@@ -7,7 +7,7 @@ import { LoaderError } from './errors.js';
 import { extname, join, toPosix } from './path.js';
 export const isDirectory = (cwdOrPath, name) => {
     try {
-        return statSync(name ? join(cwdOrPath, name) : cwdOrPath).isDirectory();
+        return statSync(name ? join(cwdOrPath, name) : cwdOrPath, { throwIfNoEntry: false })?.isDirectory() ?? false;
     }
     catch {
         return false;
@@ -15,7 +15,7 @@ export const isDirectory = (cwdOrPath, name) => {
 };
 export const isFile = (cwdOrPath, name) => {
     try {
-        return statSync(name ? join(cwdOrPath, name) : cwdOrPath).isFile();
+        return statSync(name ? join(cwdOrPath, name) : cwdOrPath, { throwIfNoEntry: false })?.isFile() ?? false;
     }
     catch {
         return false;

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

@@ -4,7 +4,7 @@ export const defaultExcludedIssueTypes = ['nsExports', 'nsTypes', 'cycles'];
 const defaultAddOnIssueTypes = ['nsExports', 'nsTypes'];
 const defaultIssueTypes = ISSUE_TYPES.filter(type => !defaultExcludedIssueTypes.includes(type));
 const normalize = (values) => values.flatMap(value => value.split(','));
-export const shorthandDeps = ['dependencies', 'unlisted', 'binaries', 'unresolved', 'catalog'];
+export const shorthandDeps = ['dependencies', 'unlisted', 'binaries', 'unresolved', 'catalog', 'catalogReferences'];
 export const shorthandExports = ['exports', 'types', 'enumMembers', 'namespaceMembers', 'duplicates'];
 export const shorthandFiles = ['files'];
 export const shorthandCycles = ['cycles'];
@@ -22,6 +22,7 @@ export const getIncludedIssueTypes = (options) => {
     if (options.isProduction) {
         _exclude.push('devDependencies');
         _exclude.push('catalog');
+        _exclude.push('catalogReferences');
     }
     else {
         if (_include.includes('dependencies'))

package/dist/util/gitignore-cache.js

@@ -50,7 +50,10 @@ export const setCachedGitignore = (cwd, workspaceDirs, gitignoreFiles, ignores,
     for (const file of gitignoreFiles) {
         const abs = path.isAbsolute(file) ? file : path.resolve(cwd, file);
         try {
-            mtimes.push(fs.statSync(abs).mtimeMs);
+            const stat = fs.statSync(abs, { throwIfNoEntry: false });
+            if (!stat)
+                continue;
+            mtimes.push(stat.mtimeMs);
             validFiles.push(file);
         }
         catch {

package/dist/util/glob-cache.js

@@ -33,8 +33,8 @@ const statDirMtime = (dir) => {
     let mtime = dirMtimeCache.get(dir);
     if (mtime === undefined) {
         try {
-            const stat = fs.statSync(dir);
-            mtime = stat.isDirectory() ? stat.mtimeMs : Number.NaN;
+            const stat = fs.statSync(dir, { throwIfNoEntry: false });
+            mtime = stat?.isDirectory() ? stat.mtimeMs : Number.NaN;
         }
         catch {
             mtime = Number.NaN;

package/dist/util/glob-core.js

@@ -293,7 +293,9 @@ export async function getGitIgnoredHandler(options, workspaceDirs) {
         return () => false;
     const { ignores, unignores } = await _parseFindGitignores(options.cwd, workspaceDirs);
     gitignoreFingerprint = hashIgnores(ignores, unignores);
-    const matcher = picomatch(expandIgnorePatterns(ignores), { ignore: expandIgnorePatterns(unignores) });
+    const ignoreMatcher = picomatch(expandIgnorePatterns(ignores));
+    const unignoreMatcher = unignores.size > 0 ? picomatch(expandIgnorePatterns(unignores)) : undefined;
+    const matcher = unignoreMatcher ? (path) => ignoreMatcher(path) && !unignoreMatcher(path) : ignoreMatcher;
     const cache = new Map();
     const isGitIgnored = (filePath) => {
         let result = cache.get(filePath);

package/dist/util/input.d.ts

@@ -1,6 +1,6 @@
 import type { IssueType } from '../types/issues.ts';
 import type { PluginName } from '../types/PluginNames.ts';
-type InputType = 'binary' | 'entry' | 'project' | 'config' | 'dependency' | 'deferResolve' | 'deferResolveEntry' | 'alias' | 'ignore';
+type InputType = 'binary' | 'catalog' | 'entry' | 'project' | 'config' | 'dependency' | 'deferResolve' | 'deferResolveEntry' | 'alias' | 'ignore';
 export interface Input {
     type: InputType;
     specifier: string;
@@ -18,6 +18,10 @@ export interface ConfigInput extends Input {
     containingFilePath?: string;
     pluginName: PluginName;
 }
+export interface CatalogInput extends Input {
+    type: 'catalog';
+    catalogName: string;
+}
 interface AliasInput extends Input {
     type: 'alias';
     prefixes: string[];
@@ -36,6 +40,8 @@ type Options = {
 export declare const fromBinary: (input: Input) => string;
 export declare const toBinary: (specifier: string, options?: Options) => Input;
 export declare const isBinary: (input: Input) => boolean;
+export declare const toCatalog: (specifier: string, catalogName: string) => CatalogInput;
+export declare const isCatalog: (input: Input) => input is CatalogInput;
 export declare const toEntry: (specifier: string) => Input;
 export declare const isEntry: (input: Input) => boolean;
 export declare const toProject: (specifier: string) => Input;

package/dist/util/input.js

@@ -6,6 +6,12 @@ export const toBinary = (specifier, options = {}) => ({
     ...options,
 });
 export const isBinary = (input) => input.type === 'binary';
+export const toCatalog = (specifier, catalogName) => ({
+    type: 'catalog',
+    specifier,
+    catalogName,
+});
+export const isCatalog = (input) => input.type === 'catalog';
 export const toEntry = (specifier) => ({ type: 'entry', specifier });
 export const isEntry = (input) => input.type === 'entry' && !input.production;
 export const toProject = (specifier) => ({ type: 'project', specifier });