knip 2.33.4 → 2.34.1

package/README.md

@@ -125,6 +125,19 @@ const config: KnipConfig = {
 export default config;
 ```
 
+And if you need, you can also expose an (async) function if you need, like so:
+
+```ts
+import type { KnipConfig } from 'knip';
+
+const config = async (): Promise<KnipConfig> => ({
+  entry: ['src/index.ts'],
+  project: ['src/**/*.ts'],
+});
+
+export default config;
+```
+
 Use `--config path/to/knip.config.json` for a different path.
 
 ### Let's Go!
@@ -251,6 +264,7 @@ This is especially useful over time when such configuration files change (and th
 Knip contains a growing list of plugins:
 
 - [Angular][plugin-angular]
+- [Astro][plugin-astro]
 - [Ava][plugin-ava]
 - [Babel][plugin-babel]
 - [Capacitor][plugin-capacitor]
@@ -304,6 +318,8 @@ themselves and/or `entry` files for Knip to analyze.
 
 See each plugin's documentation for its default values.
 
+In an Astro, Svelte or Vue project? Make sure to see [compilers][46] and add some extra configuration.
+
 #### `config`
 
 Plugins usually include `config` files. They are handled by the plugin's custom dependency finder, which returns all
@@ -341,7 +357,7 @@ level by setting it to `false` there, and vice versa.
 #### Multi-project repositories
 
 Some repositories have a single `package.json`, but consist of multiple projects with configuration files across the
-repository (such as the [Nx "intregrated repo" style][46]). Let's assume some of these projects are apps and have their
+repository (such as the [Nx "intregrated repo" style][47]). Let's assume some of these projects are apps and have their
 own Cypress configuration and test files. In that case, we could configure the Cypress plugin like this:
 
 ```json
@@ -354,7 +370,7 @@ own Cypress configuration and test files. In that case, we could configure the C
 
 #### Create a new plugin
 
-Getting false positives because a plugin is missing? Want to help out? Please read more at [writing a plugin][47]. This
+Getting false positives because a plugin is missing? Want to help out? Please read more at [writing a plugin][48]. This
 guide also contains more details if you want to learn more about plugins and why they are useful.
 
 ### Compilers
@@ -377,7 +393,7 @@ export default {
 };
 ```
 
-Read [Compilers][48] for more details and examples.
+Read [Compilers][46] for more details and examples.
 
 ### Ignore files, binaries, dependencies and workspaces
 
@@ -385,7 +401,7 @@ There are a few ways to tell Knip to ignore certain files, binaries, dependencie
 
 ```json
 {
-  "ignore": ["**/*.d.ts", "**/fixtures"],
+  "ignore": ["**/fixtures"],
   "ignoreBinaries": ["zip", "docker-compose"],
   "ignoreDependencies": ["hidden-package"],
   "ignoreWorkspaces": ["packages/ignore", "packages/examples/**"]
@@ -678,6 +694,7 @@ $ npx knip --help
       --strict                 Consider only direct dependencies of workspace (not devDependencies, not other workspaces)
       --ignore-internal        Ignore exports with tag @internal (JSDoc/TSDoc)
       -W, --workspace [dir]    Analyze a single workspace (default: analyze all configured workspaces)
+      --directory [dir]        Run process from a different directory (default: cwd)
       --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)
@@ -869,9 +886,9 @@ Special thanks to the wonderful people who have contributed to this project:
 [43]: #why-knip
 [44]: #really-another-unused-filedependencyexport-finder
 [45]: #contributors
-[46]: https://nx.dev/concepts/integrated-vs-package-based
-[47]: ./docs/writing-a-plugin.md
-[48]: ./docs/compilers.md
+[46]: ./docs/compilers.md
+[47]: https://nx.dev/concepts/integrated-vs-package-based
+[48]: ./docs/writing-a-plugin.md
 [49]: ./docs/handling-issues.md
 [50]: ./docs/reporters-and-preprocessors.md
 [51]: ./docs/perf-boost-with-no-gitignore.md
@@ -898,6 +915,7 @@ Special thanks to the wonderful people who have contributed to this project:
 [72]: https://github.com/webpro/knip/graphs/contributors
 [73]: https://contrib.rocks/image?repo=webpro/knip
 [plugin-angular]: ./src/plugins/angular
+[plugin-astro]: ./src/plugins/astro
 [plugin-ava]: ./src/plugins/ava
 [plugin-babel]: ./src/plugins/babel
 [plugin-capacitor]: ./src/plugins/capacitor

package/dist/ConfigurationChief.d.ts

@@ -37,6 +37,7 @@ export declare class ConfigurationChief {
     rawConfig?: any;
     constructor({ cwd, isProduction }: ConfigurationManagerOptions);
     init(): Promise<void>;
+    private loadResolvedConfigurationFile;
     getCompilers(): [SyncCompilers, AsyncCompilers];
     getRules(): import("./types/issues.js").Rules;
     getFilters(): {

package/dist/ConfigurationChief.js

@@ -18,6 +18,7 @@ import { getKeysByValue } from './util/object.js';
 import { join, relative, toPosix } from './util/path.js';
 import { normalizePluginConfig, toCamelCase } from './util/plugin.js';
 import { _require } from './util/require.js';
+import { unwrapFunction } from './util/unwrapFunction.js';
 import { byPathDepth } from './util/workspace.js';
 const { config: rawConfigArg, workspace: rawWorkspaceArg, include = [], exclude = [], dependencies = false, exports = false, } = parsedArgValues;
 const workspaceArg = rawWorkspaceArg ? toPosix(rawWorkspaceArg).replace(/^\.\//, '').replace(/\/$/, '') : undefined;
@@ -90,11 +91,22 @@ export class ConfigurationChief {
         if (rawConfigArg && !this.resolvedConfigFilePath && !manifest.knip) {
             throw new ConfigurationError(`Unable to find ${rawConfigArg} or package.json#knip`);
         }
-        this.rawConfig = this.resolvedConfigFilePath ? await _load(this.resolvedConfigFilePath) : manifest.knip;
+        this.rawConfig = this.resolvedConfigFilePath
+            ? await this.loadResolvedConfigurationFile(this.resolvedConfigFilePath)
+            : manifest.knip;
         const parsedConfig = this.rawConfig ? ConfigurationValidator.parse(partitionCompilers(this.rawConfig)) : {};
         this.config = this.normalize(parsedConfig);
         await this.setWorkspaces();
     }
+    async loadResolvedConfigurationFile(configPath) {
+        const loadedValue = await _load(configPath);
+        try {
+            return await unwrapFunction(loadedValue);
+        }
+        catch (e) {
+            throw new ConfigurationError(`Error running the function from ${configPath}`);
+        }
+    }
     getCompilers() {
         return [this.config.syncCompilers, this.config.asyncCompilers];
     }

package/dist/ConfigurationValidator.d.ts

@@ -34,6 +34,19 @@ export declare const ConfigurationValidator: z.ZodObject<{
         ignore: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
         ignoreBinaries: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         ignoreDependencies: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        astro: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>, z.ZodObject<{
+            config: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
+            entry: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
+            project: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
+        }, "strip", z.ZodTypeAny, {
+            config?: string | string[] | undefined;
+            entry?: string | string[] | undefined;
+            project?: string | string[] | undefined;
+        }, {
+            config?: string | string[] | undefined;
+            entry?: string | string[] | undefined;
+            project?: string | string[] | undefined;
+        }>]>>;
         angular: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>, z.ZodObject<{
             config: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
             entry: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
@@ -574,6 +587,11 @@ export declare const ConfigurationValidator: z.ZodObject<{
         ignore?: string | string[] | undefined;
         ignoreBinaries?: string[] | undefined;
         ignoreDependencies?: string[] | undefined;
+        astro?: string | boolean | string[] | {
+            config?: string | string[] | undefined;
+            entry?: string | string[] | undefined;
+            project?: string | string[] | undefined;
+        } | undefined;
         angular?: string | boolean | string[] | {
             config?: string | string[] | undefined;
             entry?: string | string[] | undefined;
@@ -786,6 +804,11 @@ export declare const ConfigurationValidator: z.ZodObject<{
         ignore?: string | string[] | undefined;
         ignoreBinaries?: string[] | undefined;
         ignoreDependencies?: string[] | undefined;
+        astro?: string | boolean | string[] | {
+            config?: string | string[] | undefined;
+            entry?: string | string[] | undefined;
+            project?: string | string[] | undefined;
+        } | undefined;
         angular?: string | boolean | string[] | {
             config?: string | string[] | undefined;
             entry?: string | string[] | undefined;
@@ -992,6 +1015,19 @@ export declare const ConfigurationValidator: z.ZodObject<{
             project?: string | string[] | undefined;
         } | undefined;
     }>>>;
+    astro: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>, z.ZodObject<{
+        config: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
+        entry: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
+        project: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
+    }, "strip", z.ZodTypeAny, {
+        config?: string | string[] | undefined;
+        entry?: string | string[] | undefined;
+        project?: string | string[] | undefined;
+    }, {
+        config?: string | string[] | undefined;
+        entry?: string | string[] | undefined;
+        project?: string | string[] | undefined;
+    }>]>>;
     angular: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>, z.ZodObject<{
         config: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
         entry: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
@@ -1547,6 +1583,11 @@ export declare const ConfigurationValidator: z.ZodObject<{
         ignore?: string | string[] | undefined;
         ignoreBinaries?: string[] | undefined;
         ignoreDependencies?: string[] | undefined;
+        astro?: string | boolean | string[] | {
+            config?: string | string[] | undefined;
+            entry?: string | string[] | undefined;
+            project?: string | string[] | undefined;
+        } | undefined;
         angular?: string | boolean | string[] | {
             config?: string | string[] | undefined;
             entry?: string | string[] | undefined;
@@ -1753,6 +1794,11 @@ export declare const ConfigurationValidator: z.ZodObject<{
             project?: string | string[] | undefined;
         } | undefined;
     }> | undefined;
+    astro?: string | boolean | string[] | {
+        config?: string | string[] | undefined;
+        entry?: string | string[] | undefined;
+        project?: string | string[] | undefined;
+    } | undefined;
     angular?: string | boolean | string[] | {
         config?: string | string[] | undefined;
         entry?: string | string[] | undefined;
@@ -1980,6 +2026,11 @@ export declare const ConfigurationValidator: z.ZodObject<{
         ignore?: string | string[] | undefined;
         ignoreBinaries?: string[] | undefined;
         ignoreDependencies?: string[] | undefined;
+        astro?: string | boolean | string[] | {
+            config?: string | string[] | undefined;
+            entry?: string | string[] | undefined;
+            project?: string | string[] | undefined;
+        } | undefined;
         angular?: string | boolean | string[] | {
             config?: string | string[] | undefined;
             entry?: string | string[] | undefined;
@@ -2186,6 +2237,11 @@ export declare const ConfigurationValidator: z.ZodObject<{
             project?: string | string[] | undefined;
         } | undefined;
     }> | undefined;
+    astro?: string | boolean | string[] | {
+        config?: string | string[] | undefined;
+        entry?: string | string[] | undefined;
+        project?: string | string[] | undefined;
+    } | undefined;
     angular?: string | boolean | string[] | {
         config?: string | string[] | undefined;
         entry?: string | string[] | undefined;

package/dist/ConfigurationValidator.js

@@ -60,6 +60,7 @@ export const pluginSchema = z.union([
     }),
 ]);
 const pluginsSchema = z.object({
+    astro: pluginSchema,
     angular: pluginSchema,
     ava: pluginSchema,
     babel: pluginSchema,

package/dist/WorkspaceWorker.d.ts

@@ -52,7 +52,7 @@ export declare class WorkspaceWorker {
         installedBinaries: InstalledBinaries;
         referencedDependencies: ReferencedDependencies;
         hasTypesIncluded: Set<string>;
-        enabledPlugins: ("angular" | "ava" | "babel" | "capacitor" | "changesets" | "commitizen" | "commitlint" | "cspell" | "cypress" | "eslint" | "gatsby" | "husky" | "jest" | "lefthook" | "markdownlint" | "mocha" | "next" | "nx" | "nyc" | "playwright" | "postcss" | "prettier" | "remark" | "remix" | "rollup" | "sentry" | "storybook" | "stryker" | "stylelint" | "tailwind" | "typedoc" | "typescript" | "vite" | "vitest" | "webpack" | "drizzle" | "githubActions" | "lintStaged" | "nodeTestRunner" | "npmPackageJsonLint" | "playwrightCt" | "releaseIt" | "semanticRelease" | "svelte")[];
+        enabledPlugins: ("astro" | "angular" | "ava" | "babel" | "capacitor" | "changesets" | "commitizen" | "commitlint" | "cspell" | "cypress" | "eslint" | "gatsby" | "husky" | "jest" | "lefthook" | "markdownlint" | "mocha" | "next" | "nx" | "nyc" | "playwright" | "postcss" | "prettier" | "remark" | "remix" | "rollup" | "sentry" | "storybook" | "stryker" | "stylelint" | "tailwind" | "typedoc" | "typescript" | "vite" | "vitest" | "webpack" | "drizzle" | "githubActions" | "lintStaged" | "nodeTestRunner" | "npmPackageJsonLint" | "playwrightCt" | "releaseIt" | "semanticRelease" | "svelte")[];
         entryFilePatterns: string[];
         productionEntryFilePatterns: string[];
     }>;

package/dist/cli.js

@@ -34,6 +34,7 @@ const run = async () => {
         const initialData = {
             report,
             issues,
+            counters,
             configurationHints,
             noConfigHints,
             cwd,
@@ -44,9 +45,9 @@ const run = async () => {
         };
         const finalData = await runPreprocessors(initialData);
         await runReporters(finalData);
-        const totalErrorCount = Object.keys(report)
-            .filter(reportGroup => report[reportGroup] && rules[reportGroup] === 'error')
-            .reduce((errorCount, reportGroup) => errorCount + counters[reportGroup], 0);
+        const totalErrorCount = Object.keys(finalData.report)
+            .filter(reportGroup => finalData.report[reportGroup] && rules[reportGroup] === 'error')
+            .reduce((errorCount, reportGroup) => errorCount + finalData.counters[reportGroup], 0);
         if (isObservePerf) {
             await perfObserver.finalize();
             console.log('\n' + perfObserver.getTable());

package/dist/plugins/astro/index.d.ts

@@ -0,0 +1,7 @@
+import type { GenericPluginCallback, IsPluginEnabledCallback } from '../../types/plugins.js';
+export declare const NAME = "Astro";
+export declare const ENABLERS: string[];
+export declare const isEnabled: IsPluginEnabledCallback;
+export declare const ENTRY_FILE_PATTERNS: string[];
+export declare const PRODUCTION_ENTRY_FILE_PATTERNS: string[];
+export declare const findDependencies: GenericPluginCallback;

package/dist/plugins/astro/index.js

@@ -0,0 +1,10 @@
+import { hasDependency } from '../../util/plugin.js';
+import { toEntryPattern, toProductionEntryPattern } from '../../util/protocols.js';
+export const NAME = 'Astro';
+export const ENABLERS = ['astro'];
+export const isEnabled = ({ dependencies }) => hasDependency(dependencies, ENABLERS);
+export const ENTRY_FILE_PATTERNS = ['astro.config.{js,cjs,mjs,ts}', 'src/content/config.ts'];
+export const PRODUCTION_ENTRY_FILE_PATTERNS = ['src/pages/**/*.{astro,mdx,js,ts}', 'src/content/**/*.mdx'];
+export const findDependencies = async () => {
+    return [...ENTRY_FILE_PATTERNS.map(toEntryPattern), ...PRODUCTION_ENTRY_FILE_PATTERNS.map(toProductionEntryPattern)];
+};

package/dist/plugins/index.d.ts

@@ -1,4 +1,5 @@
 export * as angular from './angular/index.js';
+export * as astro from './astro/index.js';
 export * as ava from './ava/index.js';
 export * as babel from './babel/index.js';
 export * as capacitor from './capacitor/index.js';

package/dist/plugins/index.js

@@ -1,4 +1,5 @@
 export * as angular from './angular/index.js';
+export * as astro from './astro/index.js';
 export * as ava from './ava/index.js';
 export * as babel from './babel/index.js';
 export * as capacitor from './capacitor/index.js';

package/dist/plugins/nx/index.js

@@ -3,7 +3,7 @@ import { compact } from '../../util/array.js';
 import { timerify } from '../../util/Performance.js';
 import { hasDependency, load } from '../../util/plugin.js';
 export const NAME = 'Nx';
-export const ENABLERS = ['nx', /^@nrwl\//];
+export const ENABLERS = ['nx', /^@nrwl\//, /^@nx\//];
 export const isEnabled = ({ dependencies }) => hasDependency(dependencies, ENABLERS);
 export const CONFIG_FILE_PATTERNS = ['project.json', '{apps,libs}/**/project.json'];
 const findNxDependencies = async (configFilePath, options) => {

package/dist/types/issues.d.ts

@@ -43,6 +43,7 @@ export type Counters = Record<IssueType | 'processed' | 'total', number>;
 export type ReporterOptions = {
     report: Report;
     issues: Issues;
+    counters: Counters;
     configurationHints: ConfigurationHints;
     noConfigHints: boolean;
     cwd: string;

package/dist/typescript/ast-helpers.d.ts

@@ -5,7 +5,8 @@ interface ValidImportTypeNode extends ts.ImportTypeNode {
     };
 }
 export declare function isValidImportTypeNode(node: ts.Node): node is ValidImportTypeNode;
-export declare function isPrivateMember(node: ts.MethodDeclaration | ts.PropertyDeclaration): boolean;
+export declare function isGetOrSetAccessorDeclaration(node: ts.Node): node is ts.AccessorDeclaration;
+export declare function isPrivateMember(node: ts.MethodDeclaration | ts.PropertyDeclaration | ts.SetAccessorDeclaration | ts.GetAccessorDeclaration): boolean;
 export declare function isDefaultImport(node: ts.ImportDeclaration | ts.ImportEqualsDeclaration | ts.ExportDeclaration): boolean;
 export declare function isAccessExpression(node: ts.Node): node is ts.PropertyAccessExpression | ts.ElementAccessExpression;
 export declare function isImportCall(node: ts.Node): node is ts.ImportCall;

package/dist/typescript/ast-helpers.js

@@ -2,6 +2,9 @@ import ts from 'typescript';
 export function isValidImportTypeNode(node) {
     return ts.isImportTypeNode(node);
 }
+export function isGetOrSetAccessorDeclaration(node) {
+    return node.kind === ts.SyntaxKind.SetAccessor || node.kind === ts.SyntaxKind.GetAccessor;
+}
 export function isPrivateMember(node) {
     return node.modifiers?.some(modifier => modifier.kind === ts.SyntaxKind.PrivateKeyword) ?? false;
 }

package/dist/typescript/visitors/exports/exportKeyword.js

@@ -1,7 +1,7 @@
 import ts from 'typescript';
 import { SymbolType } from '../../../types/issues.js';
 import { compact } from '../../../util/array.js';
-import { isPrivateMember, stripQuotes } from '../../ast-helpers.js';
+import { isGetOrSetAccessorDeclaration, isPrivateMember, stripQuotes } from '../../ast-helpers.js';
 import { exportVisitor as visit } from '../index.js';
 export default visit(() => true, node => {
     const modifierKinds = node.modifiers?.map(modifier => modifier.kind) ?? [];
@@ -47,7 +47,10 @@ export default visit(() => true, node => {
             const identifier = modifierKinds.includes(ts.SyntaxKind.DefaultKeyword) ? 'default' : node.name.getText();
             const pos = (node.name ?? node).getStart();
             const members = node.members
-                .filter((member) => (ts.isPropertyDeclaration(member) || ts.isMethodDeclaration(member)) && !isPrivateMember(member))
+                .filter((member) => (ts.isPropertyDeclaration(member) ||
+                ts.isMethodDeclaration(member) ||
+                isGetOrSetAccessorDeclaration(member)) &&
+                !isPrivateMember(member))
                 .map(member => ({
                 node: member,
                 identifier: member.name.getText(),

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

@@ -1,9 +1,10 @@
-export declare const helpText = "\u2702\uFE0F  Find unused files, dependencies and exports 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, knip.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 tests, devDependencies, exported types)\n  --strict                 Consider only direct dependencies of workspace (not devDependencies, not other workspaces)\n  --ignore-internal        Ignore exports with tag @internal (JSDoc/TSDoc)\n  -W, --workspace [dir]    Analyze a single workspace (default: analyze all configured workspaces)\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,unresolved\n  --exports                Shortcut for --include exports,nsExports,classMembers,types,nsTypes,enumMembers,duplicates\n  --include-entry-exports  Include entry files when reporting unused exports\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, can be repeated (default: symbols)\n  --reporter-options       Pass extra options to the reporter (as JSON string, see example)\n  --no-config-hints        Suppress configuration hints\n  --no-exit-code           Always exit with code zero (0)\n  --max-issues             Maximum number of issues before non-zero exit code (default: 0)\n  -d, --debug              Show debug output\n  --debug-file-filter      Filter for files in debug output (regex as string)\n  --performance            Measure count and running time of expensive functions and display stats table\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\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 --debug --debug-file-filter '(specific|particular)-module'\n\nMore documentation and bug reports: https://github.com/webpro/knip";
+export declare const helpText = "\u2702\uFE0F  Find unused files, dependencies and exports 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, knip.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 tests, devDependencies, exported types)\n  --strict                 Consider only direct dependencies of workspace (not devDependencies, not other workspaces)\n  --ignore-internal        Ignore exports with tag @internal (JSDoc/TSDoc)\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  --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,unresolved\n  --exports                Shortcut for --include exports,nsExports,classMembers,types,nsTypes,enumMembers,duplicates\n  --include-entry-exports  Include entry files when reporting unused exports\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, can be repeated (default: symbols)\n  --reporter-options       Pass extra options to the reporter (as JSON string, see example)\n  --no-config-hints        Suppress configuration hints\n  --no-exit-code           Always exit with code zero (0)\n  --max-issues             Maximum number of issues before non-zero exit code (default: 0)\n  -d, --debug              Show debug output\n  --debug-file-filter      Filter for files in debug output (regex as string)\n  --performance            Measure count and running time of expensive functions and display stats table\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\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 --debug --debug-file-filter '(specific|particular)-module'\n\nMore documentation and bug reports: https://github.com/webpro/knip";
 declare const _default: {
     config: string | undefined;
     debug: boolean | undefined;
     'debug-file-filter': string | undefined;
     dependencies: boolean | undefined;
+    directory: string | undefined;
     exclude: string[] | undefined;
     exports: boolean | undefined;
     help: boolean | undefined;

package/dist/util/cli-arguments.js

@@ -10,6 +10,7 @@ Options:
   --strict                 Consider only direct dependencies of workspace (not devDependencies, not other workspaces)
   --ignore-internal        Ignore exports with tag @internal (JSDoc/TSDoc)
   -W, --workspace [dir]    Analyze a single workspace (default: analyze all configured workspaces)
+  --directory [dir]        Run process from a different directory (default: cwd)
   --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)
@@ -50,6 +51,7 @@ try {
             debug: { type: 'boolean', short: 'd' },
             'debug-file-filter': { type: 'string' },
             dependencies: { type: 'boolean' },
+            directory: { type: 'string' },
             exclude: { type: 'string', multiple: true },
             exports: { type: 'boolean' },
             help: { type: 'boolean', short: 'h' },

package/dist/util/compilers.d.ts

@@ -22,6 +22,11 @@ export declare const partitionCompilers: (rawLocalConfig: RawConfiguration) => {
         ignore?: string | string[] | undefined;
         ignoreBinaries?: string[] | undefined;
         ignoreDependencies?: string[] | undefined;
+        astro?: string | boolean | string[] | {
+            config?: string | string[] | undefined;
+            entry?: string | string[] | undefined;
+            project?: string | string[] | undefined;
+        } | undefined;
         angular?: string | boolean | string[] | {
             config?: string | string[] | undefined;
             entry?: string | string[] | undefined;
@@ -228,6 +233,11 @@ export declare const partitionCompilers: (rawLocalConfig: RawConfiguration) => {
             project?: string | string[] | undefined;
         } | undefined;
     }> | undefined;
+    astro?: string | boolean | string[] | {
+        config?: string | string[] | undefined;
+        entry?: string | string[] | undefined;
+        project?: string | string[] | undefined;
+    } | undefined;
     angular?: string | boolean | string[] | {
         config?: string | string[] | undefined;
         entry?: string | string[] | undefined;

package/dist/util/modules.js

@@ -51,4 +51,4 @@ export const getEntryPathFromManifest = (cwd, dir, manifest) => {
     }
     return _glob({ cwd, workingDir: dir, patterns: Array.from(entryPaths) });
 };
-export const sanitizeSpecifier = (specifier) => specifier.replace(/^([?!|-]+)?([^!?]+).*/, '$2');
+export const sanitizeSpecifier = (specifier) => specifier.replace(/^([?!|-]+)?([^!?:]+).*/, '$2');

package/dist/util/path.js

@@ -1,10 +1,12 @@
 import path from 'node:path';
+import parsedArgValues from './cli-arguments.js';
+const { directory } = parsedArgValues;
 const isAbsolute = path.isAbsolute;
 export const dirname = path.posix.dirname;
 export const extname = path.posix.extname;
 export const join = path.posix.join;
 export const toPosix = (value) => value.split(path.sep).join(path.posix.sep);
-export const cwd = toPosix(process.cwd());
+export const cwd = directory ? path.posix.resolve(directory) : toPosix(process.cwd());
 export const resolve = (...paths) => paths.length === 1 ? path.posix.join(cwd, paths[0]) : path.posix.resolve(...paths);
 export const relative = (from, to) => toPosix(path.relative(to ? from : cwd, to ?? from));
 export const isInNodeModules = (filePath) => filePath.includes('node_modules');

package/dist/util/unwrapFunction.d.ts

@@ -0,0 +1 @@
+export declare const unwrapFunction: (possibleFunction: unknown) => Promise<any>;

package/dist/util/unwrapFunction.js

@@ -0,0 +1,13 @@
+import { debugLogObject } from './debug.js';
+export const unwrapFunction = async (possibleFunction) => {
+    if (typeof possibleFunction === 'function') {
+        try {
+            return await possibleFunction();
+        }
+        catch (error) {
+            debugLogObject('*', 'Error executing function:', error);
+            throw error;
+        }
+    }
+    return possibleFunction;
+};

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const version = "2.33.4";
+export declare const version = "2.34.1";

package/dist/version.js

@@ -1 +1 @@
-export const version = '2.33.4';
+export const version = '2.34.1';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "knip",
-  "version": "2.33.4",
+  "version": "2.34.1",
   "description": "Find unused files, dependencies and exports in your TypeScript and JavaScript projects",
   "homepage": "https://github.com/webpro/knip",
   "repository": "github:webpro/knip",

package/schema.json

@@ -224,6 +224,10 @@
           "title": "angular plugin configuration (https://github.com/webpro/knip/blob/main/src/plugins/angular/README.md)",
           "$ref": "#/definitions/plugin"
         },
+        "astro": {
+          "title": "astro plugin configuration (https://github.com/webpro/knip/blob/main/src/plugins/astro/README.md)",
+          "$ref": "#/definitions/plugin"
+        },
         "ava": {
           "title": "ava plugin configuration (https://github.com/webpro/knip/blob/main/src/plugins/ava/README.md)",
           "$ref": "#/definitions/plugin"