@nx-devkit/knip 0.0.0 → 0.0.1

package/README.md

@@ -1,3 +1,64 @@
 # @nx-devkit/knip
 
-Placeholder for @nx-devkit/knip published by @nx-devkit/prepare-for-release.
+Standalone Nx plugin: any `knip` config file — or a `package.json` carrying a `"knip"` key — becomes a cached `knip` target (plus `knip:fix`) on the owning project. Dead exports, unused files and unused dependencies, detected per project and cached by Nx. No `project.json` needed.
+
+Part of [nx-devkit](https://github.com/nx-devkit/nx.ts).
+
+## Install
+
+```bash
+bun add -D @nx-devkit/knip knip
+```
+
+Depends on `@nx/devkit` `^22 || ^23`. Requires `knip` `^5 || ^6` as a peer.
+
+## Register
+
+```bash
+nx add @nx-devkit/knip   # runs the init generator — registers the plugin in nx.json
+```
+
+Or manually:
+
+```jsonc
+// nx.json
+{ "plugins": ["@nx-devkit/knip"] }
+```
+
+## What it infers
+
+<!-- target table consistent with src/plugin.ts createNodesV2 -->
+
+| Trigger | Target | Command | Cacheable | Inputs |
+|---|---|---|---|---|
+| `knip.{json,jsonc,ts}`, `knip.config.{ts,js,mjs,cjs}`, or `package.json` with a `"knip"` key | `knip` | `npx knip` (cwd = `{projectRoot}`) | yes | `<root>/**/*.{ts,tsx,js,jsx,mts,cts,mjs,cjs,json,jsonc}` + the config files |
+| either of the above | `knip:fix` | `npx knip --fix` | no | — |
+
+Knip auto-discovers its config from the working directory, so the plugin never passes `--config` — the target simply runs `knip` in the directory that owns the config. When several config forms live in one directory they merge into a single target pair (`knip.json` wins, matching knip's own discovery order). A `package.json` *without* a `"knip"` key infers nothing — it is only scanned as a possible config host.
+
+## Options
+
+```jsonc
+// nx.json
+{
+  "plugins": [
+    {
+      "plugin": "@nx-devkit/knip",
+      "options": {
+        "targetName": "knip",   // rename the target
+        "fixTarget": false       // do not infer `knip:fix` (default: true)
+      }
+    }
+  ]
+}
+```
+
+## Inspect
+
+```bash
+npx nx show project my-app          # see inferred targets
+npx nx run my-app:knip              # analyze
+npx nx run my-app:knip:fix          # auto-remove unused exports/deps
+```
+
+CI tip: run `npx nx affected -t knip` to analyze only the projects touched by a change.

package/dist/generators/init/generator.d.mts

@@ -0,0 +1,10 @@
+import { GeneratorCallback, Tree } from "@nx/devkit";
+
+//#region src/generators/init/generator.d.ts
+interface NxKnipInitOptions {
+  pluginPath?: string;
+}
+declare function initGenerator(tree: Tree, options?: NxKnipInitOptions): Promise<GeneratorCallback>;
+//#endregion
+export { NxKnipInitOptions, initGenerator as default, initGenerator };
+//# sourceMappingURL=generator.d.mts.map

package/dist/generators/init/generator.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.d.mts","names":[],"sources":["../../../src/generators/init/generator.ts"],"mappings":";;;UAGiB,iBAAA;EACf,UAAU;AAAA;AAAA,iBAKU,aAAA,CACpB,IAAA,EAAM,IAAA,EACN,OAAA,GAAS,iBAAA,GACR,OAAA,CAAQ,iBAAA"}

package/dist/generators/init/generator.mjs

@@ -0,0 +1,283 @@
+import { createRequire } from "node:module";
+import { formatFiles } from "@nx/devkit";
+//#region \0rolldown/runtime.js
+var __commonJSMin = (cb, mod) => () => (mod || (cb((mod = { exports: {} }).exports, mod), cb = null), mod.exports);
+var __require = /* #__PURE__ */ (() => createRequire(import.meta.url))();
+//#endregion
+//#region ../internal/src/jsonc.ts
+var import_main = (/* @__PURE__ */ __commonJSMin(((exports, module) => {
+	(function(factory) {
+		if (typeof module === "object" && typeof module.exports === "object") {
+			var v = factory(__require, exports);
+			if (v !== void 0) module.exports = v;
+		} else if (typeof define === "function" && define.amd) define([
+			"require",
+			"exports",
+			"./impl/format",
+			"./impl/edit",
+			"./impl/scanner",
+			"./impl/parser"
+		], factory);
+	})(function(require, exports$1) {
+		"use strict";
+		Object.defineProperty(exports$1, "__esModule", { value: true });
+		exports$1.applyEdits = exports$1.modify = exports$1.format = exports$1.printParseErrorCode = exports$1.ParseErrorCode = exports$1.stripComments = exports$1.visit = exports$1.getNodeValue = exports$1.getNodePath = exports$1.findNodeAtOffset = exports$1.findNodeAtLocation = exports$1.parseTree = exports$1.parse = exports$1.getLocation = exports$1.SyntaxKind = exports$1.ScanError = exports$1.createScanner = void 0;
+		const formatter = require("./impl/format");
+		const edit = require("./impl/edit");
+		const scanner = require("./impl/scanner");
+		const parser = require("./impl/parser");
+		/**
+		* Creates a JSON scanner on the given text.
+		* If ignoreTrivia is set, whitespaces or comments are ignored.
+		*/
+		exports$1.createScanner = scanner.createScanner;
+		var ScanError;
+		(function(ScanError) {
+			ScanError[ScanError["None"] = 0] = "None";
+			ScanError[ScanError["UnexpectedEndOfComment"] = 1] = "UnexpectedEndOfComment";
+			ScanError[ScanError["UnexpectedEndOfString"] = 2] = "UnexpectedEndOfString";
+			ScanError[ScanError["UnexpectedEndOfNumber"] = 3] = "UnexpectedEndOfNumber";
+			ScanError[ScanError["InvalidUnicode"] = 4] = "InvalidUnicode";
+			ScanError[ScanError["InvalidEscapeCharacter"] = 5] = "InvalidEscapeCharacter";
+			ScanError[ScanError["InvalidCharacter"] = 6] = "InvalidCharacter";
+		})(ScanError || (exports$1.ScanError = ScanError = {}));
+		var SyntaxKind;
+		(function(SyntaxKind) {
+			SyntaxKind[SyntaxKind["OpenBraceToken"] = 1] = "OpenBraceToken";
+			SyntaxKind[SyntaxKind["CloseBraceToken"] = 2] = "CloseBraceToken";
+			SyntaxKind[SyntaxKind["OpenBracketToken"] = 3] = "OpenBracketToken";
+			SyntaxKind[SyntaxKind["CloseBracketToken"] = 4] = "CloseBracketToken";
+			SyntaxKind[SyntaxKind["CommaToken"] = 5] = "CommaToken";
+			SyntaxKind[SyntaxKind["ColonToken"] = 6] = "ColonToken";
+			SyntaxKind[SyntaxKind["NullKeyword"] = 7] = "NullKeyword";
+			SyntaxKind[SyntaxKind["TrueKeyword"] = 8] = "TrueKeyword";
+			SyntaxKind[SyntaxKind["FalseKeyword"] = 9] = "FalseKeyword";
+			SyntaxKind[SyntaxKind["StringLiteral"] = 10] = "StringLiteral";
+			SyntaxKind[SyntaxKind["NumericLiteral"] = 11] = "NumericLiteral";
+			SyntaxKind[SyntaxKind["LineCommentTrivia"] = 12] = "LineCommentTrivia";
+			SyntaxKind[SyntaxKind["BlockCommentTrivia"] = 13] = "BlockCommentTrivia";
+			SyntaxKind[SyntaxKind["LineBreakTrivia"] = 14] = "LineBreakTrivia";
+			SyntaxKind[SyntaxKind["Trivia"] = 15] = "Trivia";
+			SyntaxKind[SyntaxKind["Unknown"] = 16] = "Unknown";
+			SyntaxKind[SyntaxKind["EOF"] = 17] = "EOF";
+		})(SyntaxKind || (exports$1.SyntaxKind = SyntaxKind = {}));
+		/**
+		* For a given offset, evaluate the location in the JSON document. Each segment in the location path is either a property name or an array index.
+		*/
+		exports$1.getLocation = parser.getLocation;
+		/**
+		* Parses the given text and returns the object the JSON content represents. On invalid input, the parser tries to be as fault tolerant as possible, but still return a result.
+		* Therefore, always check the errors list to find out if the input was valid.
+		*/
+		exports$1.parse = parser.parse;
+		/**
+		* Parses the given text and returns a tree representation the JSON content. On invalid input, the parser tries to be as fault tolerant as possible, but still return a result.
+		*/
+		exports$1.parseTree = parser.parseTree;
+		/**
+		* Finds the node at the given path in a JSON DOM.
+		*/
+		exports$1.findNodeAtLocation = parser.findNodeAtLocation;
+		/**
+		* Finds the innermost node at the given offset. If includeRightBound is set, also finds nodes that end at the given offset.
+		*/
+		exports$1.findNodeAtOffset = parser.findNodeAtOffset;
+		/**
+		* Gets the JSON path of the given JSON DOM node
+		*/
+		exports$1.getNodePath = parser.getNodePath;
+		/**
+		* Evaluates the JavaScript object of the given JSON DOM node
+		*/
+		exports$1.getNodeValue = parser.getNodeValue;
+		/**
+		* Parses the given text and invokes the visitor functions for each object, array and literal reached.
+		*/
+		exports$1.visit = parser.visit;
+		/**
+		* Takes JSON with JavaScript-style comments and remove
+		* them. Optionally replaces every none-newline character
+		* of comments with a replaceCharacter
+		*/
+		exports$1.stripComments = parser.stripComments;
+		var ParseErrorCode;
+		(function(ParseErrorCode) {
+			ParseErrorCode[ParseErrorCode["InvalidSymbol"] = 1] = "InvalidSymbol";
+			ParseErrorCode[ParseErrorCode["InvalidNumberFormat"] = 2] = "InvalidNumberFormat";
+			ParseErrorCode[ParseErrorCode["PropertyNameExpected"] = 3] = "PropertyNameExpected";
+			ParseErrorCode[ParseErrorCode["ValueExpected"] = 4] = "ValueExpected";
+			ParseErrorCode[ParseErrorCode["ColonExpected"] = 5] = "ColonExpected";
+			ParseErrorCode[ParseErrorCode["CommaExpected"] = 6] = "CommaExpected";
+			ParseErrorCode[ParseErrorCode["CloseBraceExpected"] = 7] = "CloseBraceExpected";
+			ParseErrorCode[ParseErrorCode["CloseBracketExpected"] = 8] = "CloseBracketExpected";
+			ParseErrorCode[ParseErrorCode["EndOfFileExpected"] = 9] = "EndOfFileExpected";
+			ParseErrorCode[ParseErrorCode["InvalidCommentToken"] = 10] = "InvalidCommentToken";
+			ParseErrorCode[ParseErrorCode["UnexpectedEndOfComment"] = 11] = "UnexpectedEndOfComment";
+			ParseErrorCode[ParseErrorCode["UnexpectedEndOfString"] = 12] = "UnexpectedEndOfString";
+			ParseErrorCode[ParseErrorCode["UnexpectedEndOfNumber"] = 13] = "UnexpectedEndOfNumber";
+			ParseErrorCode[ParseErrorCode["InvalidUnicode"] = 14] = "InvalidUnicode";
+			ParseErrorCode[ParseErrorCode["InvalidEscapeCharacter"] = 15] = "InvalidEscapeCharacter";
+			ParseErrorCode[ParseErrorCode["InvalidCharacter"] = 16] = "InvalidCharacter";
+		})(ParseErrorCode || (exports$1.ParseErrorCode = ParseErrorCode = {}));
+		function printParseErrorCode(code) {
+			switch (code) {
+				case 1: return "InvalidSymbol";
+				case 2: return "InvalidNumberFormat";
+				case 3: return "PropertyNameExpected";
+				case 4: return "ValueExpected";
+				case 5: return "ColonExpected";
+				case 6: return "CommaExpected";
+				case 7: return "CloseBraceExpected";
+				case 8: return "CloseBracketExpected";
+				case 9: return "EndOfFileExpected";
+				case 10: return "InvalidCommentToken";
+				case 11: return "UnexpectedEndOfComment";
+				case 12: return "UnexpectedEndOfString";
+				case 13: return "UnexpectedEndOfNumber";
+				case 14: return "InvalidUnicode";
+				case 15: return "InvalidEscapeCharacter";
+				case 16: return "InvalidCharacter";
+			}
+			return "<unknown ParseErrorCode>";
+		}
+		exports$1.printParseErrorCode = printParseErrorCode;
+		/**
+		* Computes the edit operations needed to format a JSON document.
+		*
+		* @param documentText The input text
+		* @param range The range to format or `undefined` to format the full content
+		* @param options The formatting options
+		* @returns The edit operations describing the formatting changes to the original document following the format described in {@linkcode EditResult}.
+		* To apply the edit operations to the input, use {@linkcode applyEdits}.
+		*/
+		function format(documentText, range, options) {
+			return formatter.format(documentText, range, options);
+		}
+		exports$1.format = format;
+		/**
+		* Computes the edit operations needed to modify a value in the JSON document.
+		*
+		* @param documentText The input text
+		* @param path The path of the value to change. The path represents either to the document root, a property or an array item.
+		* If the path points to an non-existing property or item, it will be created.
+		* @param value The new value for the specified property or item. If the value is undefined,
+		* the property or item will be removed.
+		* @param options Options
+		* @returns The edit operations describing the changes to the original document, following the format described in {@linkcode EditResult}.
+		* To apply the edit operations to the input, use {@linkcode applyEdits}.
+		*/
+		function modify(text, path, value, options) {
+			return edit.setProperty(text, path, value, options);
+		}
+		exports$1.modify = modify;
+		/**
+		* Applies edits to an input string.
+		* @param text The input text
+		* @param edits Edit operations following the format described in {@linkcode EditResult}.
+		* @returns The text with the applied edits.
+		* @throws An error if the edit operations are not well-formed as described in {@linkcode EditResult}.
+		*/
+		function applyEdits(text, edits) {
+			let sortedEdits = edits.slice(0).sort((a, b) => {
+				const diff = a.offset - b.offset;
+				if (diff === 0) return a.length - b.length;
+				return diff;
+			});
+			let lastModifiedOffset = text.length;
+			for (let i = sortedEdits.length - 1; i >= 0; i--) {
+				let e = sortedEdits[i];
+				if (e.offset + e.length <= lastModifiedOffset) text = edit.applyEdit(text, e);
+				else throw new Error("Overlapping edit");
+				lastModifiedOffset = e.offset;
+			}
+			return text;
+		}
+		exports$1.applyEdits = applyEdits;
+	});
+})))();
+function parseJsonObject(text, path) {
+	const errors = [];
+	const data = (0, import_main.parse)(text, errors, { allowTrailingComma: true });
+	if (errors.length > 0) {
+		const details = errors.map((e) => `${(0, import_main.printParseErrorCode)(e.error)} at offset ${e.offset}`).join("; ");
+		throw new Error(`Cannot parse ${path}: ${details}`);
+	}
+	if (typeof data !== "object" || data === null || Array.isArray(data)) throw new Error(`Cannot parse ${path}: expected a JSON object`);
+	return data;
+}
+function detectIndent(text) {
+	const firstProp = (0, import_main.parseTree)(text)?.children?.[0]?.children?.[0];
+	const lineStart = firstProp ? text.lastIndexOf("\n", firstProp.offset) + 1 : -1;
+	const leading = firstProp ? text.slice(lineStart, firstProp.offset) : "";
+	const indent = /^[ \t]+$/.test(leading) ? leading : "  ";
+	return {
+		eol: text.includes("\r\n") ? "\r\n" : "\n",
+		insertSpaces: !indent.startsWith("	"),
+		tabSize: indent.startsWith("	") ? 1 : indent.length
+	};
+}
+//#endregion
+//#region ../internal/src/init-generator.ts
+function readJson(tree, path) {
+	if (!tree.exists(path)) return null;
+	const text = tree.read(path, "utf8");
+	if (text == null) return null;
+	return parseJsonObject(text, path);
+}
+/**
+* Registers `plugin` in nx.json as `{ plugin, options: {} }`, preserving
+* JSONC comments and the file's own indentation. Dedupes string, tuple,
+* and object plugin forms; creates nx.json when missing.
+*/
+function registerPlugin(tree, pluginPath) {
+	const text = tree.exists("nx.json") ? tree.read("nx.json", "utf8") : null;
+	const nxJson = text == null ? {} : parseJsonObject(text, "nx.json");
+	const plugins = Array.isArray(nxJson.plugins) ? nxJson.plugins : [];
+	if (plugins.some((entry) => typeof entry === "string" && entry === pluginPath || Array.isArray(entry) && entry[0] === pluginPath || typeof entry === "object" && entry !== null && !Array.isArray(entry) && entry.plugin === pluginPath)) return;
+	const entry = {
+		options: {},
+		plugin: pluginPath
+	};
+	if (text == null) {
+		tree.write("nx.json", `${JSON.stringify({ plugins: [entry] }, null, 2)}\n`);
+		return;
+	}
+	const formattingOptions = detectIndent(text);
+	const updated = (0, import_main.applyEdits)(text, (0, import_main.modify)(text, Array.isArray(nxJson.plugins) ? ["plugins", plugins.length] : ["plugins"], Array.isArray(nxJson.plugins) ? entry : [entry], {
+		formattingOptions,
+		isArrayInsertion: true
+	}));
+	tree.write("nx.json", updated);
+}
+/** Nx names the root project from project.json, then nx.json, then package.json. */
+function resolveRootProjectName(tree) {
+	for (const path of [
+		"project.json",
+		"nx.json",
+		"package.json"
+	]) {
+		const name = readJson(tree, path)?.name;
+		if (typeof name === "string" && name) return name;
+	}
+}
+//#endregion
+//#region src/generators/init/generator.ts
+const DEFAULT_PLUGIN_PATH = "@nx-devkit/knip";
+async function initGenerator(tree, options = {}) {
+	const pluginPath = options.pluginPath || DEFAULT_PLUGIN_PATH;
+	const projectName = resolveRootProjectName(tree) ?? "{root-project}";
+	registerPlugin(tree, pluginPath);
+	const checklist = [
+		`1. The plugin is registered (${pluginPath}) — projects containing a knip config now have knip targets.`,
+		"2. Inspect inferred targets:",
+		"   bunx nx show projects",
+		`3. Run a target:  bunx nx run ${projectName}:knip`
+	];
+	for (const line of checklist) console.log(line);
+	await formatFiles(tree);
+	return () => {};
+}
+//#endregion
+export { initGenerator as default, initGenerator };
+
+//# sourceMappingURL=generator.mjs.map

package/dist/generators/init/generator.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.mjs","names":["exports"],"sources":["../../../../../node_modules/.bun/jsonc-parser@3.3.1/node_modules/jsonc-parser/lib/umd/main.js","../../../../internal/src/jsonc.ts","../../../../internal/src/init-generator.ts","../../../src/generators/init/generator.ts"],"sourcesContent":["(function (factory) {\n    if (typeof module === \"object\" && typeof module.exports === \"object\") {\n        var v = factory(require, exports);\n        if (v !== undefined) module.exports = v;\n    }\n    else if (typeof define === \"function\" && define.amd) {\n        define([\"require\", \"exports\", \"./impl/format\", \"./impl/edit\", \"./impl/scanner\", \"./impl/parser\"], factory);\n    }\n})(function (require, exports) {\n    /*---------------------------------------------------------------------------------------------\n     *  Copyright (c) Microsoft Corporation. All rights reserved.\n     *  Licensed under the MIT License. See License.txt in the project root for license information.\n     *--------------------------------------------------------------------------------------------*/\n    'use strict';\n    Object.defineProperty(exports, \"__esModule\", { value: true });\n    exports.applyEdits = exports.modify = exports.format = exports.printParseErrorCode = exports.ParseErrorCode = exports.stripComments = exports.visit = exports.getNodeValue = exports.getNodePath = exports.findNodeAtOffset = exports.findNodeAtLocation = exports.parseTree = exports.parse = exports.getLocation = exports.SyntaxKind = exports.ScanError = exports.createScanner = void 0;\n    const formatter = require(\"./impl/format\");\n    const edit = require(\"./impl/edit\");\n    const scanner = require(\"./impl/scanner\");\n    const parser = require(\"./impl/parser\");\n    /**\n     * Creates a JSON scanner on the given text.\n     * If ignoreTrivia is set, whitespaces or comments are ignored.\n     */\n    exports.createScanner = scanner.createScanner;\n    var ScanError;\n    (function (ScanError) {\n        ScanError[ScanError[\"None\"] = 0] = \"None\";\n        ScanError[ScanError[\"UnexpectedEndOfComment\"] = 1] = \"UnexpectedEndOfComment\";\n        ScanError[ScanError[\"UnexpectedEndOfString\"] = 2] = \"UnexpectedEndOfString\";\n        ScanError[ScanError[\"UnexpectedEndOfNumber\"] = 3] = \"UnexpectedEndOfNumber\";\n        ScanError[ScanError[\"InvalidUnicode\"] = 4] = \"InvalidUnicode\";\n        ScanError[ScanError[\"InvalidEscapeCharacter\"] = 5] = \"InvalidEscapeCharacter\";\n        ScanError[ScanError[\"InvalidCharacter\"] = 6] = \"InvalidCharacter\";\n    })(ScanError || (exports.ScanError = ScanError = {}));\n    var SyntaxKind;\n    (function (SyntaxKind) {\n        SyntaxKind[SyntaxKind[\"OpenBraceToken\"] = 1] = \"OpenBraceToken\";\n        SyntaxKind[SyntaxKind[\"CloseBraceToken\"] = 2] = \"CloseBraceToken\";\n        SyntaxKind[SyntaxKind[\"OpenBracketToken\"] = 3] = \"OpenBracketToken\";\n        SyntaxKind[SyntaxKind[\"CloseBracketToken\"] = 4] = \"CloseBracketToken\";\n        SyntaxKind[SyntaxKind[\"CommaToken\"] = 5] = \"CommaToken\";\n        SyntaxKind[SyntaxKind[\"ColonToken\"] = 6] = \"ColonToken\";\n        SyntaxKind[SyntaxKind[\"NullKeyword\"] = 7] = \"NullKeyword\";\n        SyntaxKind[SyntaxKind[\"TrueKeyword\"] = 8] = \"TrueKeyword\";\n        SyntaxKind[SyntaxKind[\"FalseKeyword\"] = 9] = \"FalseKeyword\";\n        SyntaxKind[SyntaxKind[\"StringLiteral\"] = 10] = \"StringLiteral\";\n        SyntaxKind[SyntaxKind[\"NumericLiteral\"] = 11] = \"NumericLiteral\";\n        SyntaxKind[SyntaxKind[\"LineCommentTrivia\"] = 12] = \"LineCommentTrivia\";\n        SyntaxKind[SyntaxKind[\"BlockCommentTrivia\"] = 13] = \"BlockCommentTrivia\";\n        SyntaxKind[SyntaxKind[\"LineBreakTrivia\"] = 14] = \"LineBreakTrivia\";\n        SyntaxKind[SyntaxKind[\"Trivia\"] = 15] = \"Trivia\";\n        SyntaxKind[SyntaxKind[\"Unknown\"] = 16] = \"Unknown\";\n        SyntaxKind[SyntaxKind[\"EOF\"] = 17] = \"EOF\";\n    })(SyntaxKind || (exports.SyntaxKind = SyntaxKind = {}));\n    /**\n     * For a given offset, evaluate the location in the JSON document. Each segment in the location path is either a property name or an array index.\n     */\n    exports.getLocation = parser.getLocation;\n    /**\n     * Parses the given text and returns the object the JSON content represents. On invalid input, the parser tries to be as fault tolerant as possible, but still return a result.\n     * Therefore, always check the errors list to find out if the input was valid.\n     */\n    exports.parse = parser.parse;\n    /**\n     * Parses the given text and returns a tree representation the JSON content. On invalid input, the parser tries to be as fault tolerant as possible, but still return a result.\n     */\n    exports.parseTree = parser.parseTree;\n    /**\n     * Finds the node at the given path in a JSON DOM.\n     */\n    exports.findNodeAtLocation = parser.findNodeAtLocation;\n    /**\n     * Finds the innermost node at the given offset. If includeRightBound is set, also finds nodes that end at the given offset.\n     */\n    exports.findNodeAtOffset = parser.findNodeAtOffset;\n    /**\n     * Gets the JSON path of the given JSON DOM node\n     */\n    exports.getNodePath = parser.getNodePath;\n    /**\n     * Evaluates the JavaScript object of the given JSON DOM node\n     */\n    exports.getNodeValue = parser.getNodeValue;\n    /**\n     * Parses the given text and invokes the visitor functions for each object, array and literal reached.\n     */\n    exports.visit = parser.visit;\n    /**\n     * Takes JSON with JavaScript-style comments and remove\n     * them. Optionally replaces every none-newline character\n     * of comments with a replaceCharacter\n     */\n    exports.stripComments = parser.stripComments;\n    var ParseErrorCode;\n    (function (ParseErrorCode) {\n        ParseErrorCode[ParseErrorCode[\"InvalidSymbol\"] = 1] = \"InvalidSymbol\";\n        ParseErrorCode[ParseErrorCode[\"InvalidNumberFormat\"] = 2] = \"InvalidNumberFormat\";\n        ParseErrorCode[ParseErrorCode[\"PropertyNameExpected\"] = 3] = \"PropertyNameExpected\";\n        ParseErrorCode[ParseErrorCode[\"ValueExpected\"] = 4] = \"ValueExpected\";\n        ParseErrorCode[ParseErrorCode[\"ColonExpected\"] = 5] = \"ColonExpected\";\n        ParseErrorCode[ParseErrorCode[\"CommaExpected\"] = 6] = \"CommaExpected\";\n        ParseErrorCode[ParseErrorCode[\"CloseBraceExpected\"] = 7] = \"CloseBraceExpected\";\n        ParseErrorCode[ParseErrorCode[\"CloseBracketExpected\"] = 8] = \"CloseBracketExpected\";\n        ParseErrorCode[ParseErrorCode[\"EndOfFileExpected\"] = 9] = \"EndOfFileExpected\";\n        ParseErrorCode[ParseErrorCode[\"InvalidCommentToken\"] = 10] = \"InvalidCommentToken\";\n        ParseErrorCode[ParseErrorCode[\"UnexpectedEndOfComment\"] = 11] = \"UnexpectedEndOfComment\";\n        ParseErrorCode[ParseErrorCode[\"UnexpectedEndOfString\"] = 12] = \"UnexpectedEndOfString\";\n        ParseErrorCode[ParseErrorCode[\"UnexpectedEndOfNumber\"] = 13] = \"UnexpectedEndOfNumber\";\n        ParseErrorCode[ParseErrorCode[\"InvalidUnicode\"] = 14] = \"InvalidUnicode\";\n        ParseErrorCode[ParseErrorCode[\"InvalidEscapeCharacter\"] = 15] = \"InvalidEscapeCharacter\";\n        ParseErrorCode[ParseErrorCode[\"InvalidCharacter\"] = 16] = \"InvalidCharacter\";\n    })(ParseErrorCode || (exports.ParseErrorCode = ParseErrorCode = {}));\n    function printParseErrorCode(code) {\n        switch (code) {\n            case 1 /* ParseErrorCode.InvalidSymbol */: return 'InvalidSymbol';\n            case 2 /* ParseErrorCode.InvalidNumberFormat */: return 'InvalidNumberFormat';\n            case 3 /* ParseErrorCode.PropertyNameExpected */: return 'PropertyNameExpected';\n            case 4 /* ParseErrorCode.ValueExpected */: return 'ValueExpected';\n            case 5 /* ParseErrorCode.ColonExpected */: return 'ColonExpected';\n            case 6 /* ParseErrorCode.CommaExpected */: return 'CommaExpected';\n            case 7 /* ParseErrorCode.CloseBraceExpected */: return 'CloseBraceExpected';\n            case 8 /* ParseErrorCode.CloseBracketExpected */: return 'CloseBracketExpected';\n            case 9 /* ParseErrorCode.EndOfFileExpected */: return 'EndOfFileExpected';\n            case 10 /* ParseErrorCode.InvalidCommentToken */: return 'InvalidCommentToken';\n            case 11 /* ParseErrorCode.UnexpectedEndOfComment */: return 'UnexpectedEndOfComment';\n            case 12 /* ParseErrorCode.UnexpectedEndOfString */: return 'UnexpectedEndOfString';\n            case 13 /* ParseErrorCode.UnexpectedEndOfNumber */: return 'UnexpectedEndOfNumber';\n            case 14 /* ParseErrorCode.InvalidUnicode */: return 'InvalidUnicode';\n            case 15 /* ParseErrorCode.InvalidEscapeCharacter */: return 'InvalidEscapeCharacter';\n            case 16 /* ParseErrorCode.InvalidCharacter */: return 'InvalidCharacter';\n        }\n        return '<unknown ParseErrorCode>';\n    }\n    exports.printParseErrorCode = printParseErrorCode;\n    /**\n     * Computes the edit operations needed to format a JSON document.\n     *\n     * @param documentText The input text\n     * @param range The range to format or `undefined` to format the full content\n     * @param options The formatting options\n     * @returns The edit operations describing the formatting changes to the original document following the format described in {@linkcode EditResult}.\n     * To apply the edit operations to the input, use {@linkcode applyEdits}.\n     */\n    function format(documentText, range, options) {\n        return formatter.format(documentText, range, options);\n    }\n    exports.format = format;\n    /**\n     * Computes the edit operations needed to modify a value in the JSON document.\n     *\n     * @param documentText The input text\n     * @param path The path of the value to change. The path represents either to the document root, a property or an array item.\n     * If the path points to an non-existing property or item, it will be created.\n     * @param value The new value for the specified property or item. If the value is undefined,\n     * the property or item will be removed.\n     * @param options Options\n     * @returns The edit operations describing the changes to the original document, following the format described in {@linkcode EditResult}.\n     * To apply the edit operations to the input, use {@linkcode applyEdits}.\n     */\n    function modify(text, path, value, options) {\n        return edit.setProperty(text, path, value, options);\n    }\n    exports.modify = modify;\n    /**\n     * Applies edits to an input string.\n     * @param text The input text\n     * @param edits Edit operations following the format described in {@linkcode EditResult}.\n     * @returns The text with the applied edits.\n     * @throws An error if the edit operations are not well-formed as described in {@linkcode EditResult}.\n     */\n    function applyEdits(text, edits) {\n        let sortedEdits = edits.slice(0).sort((a, b) => {\n            const diff = a.offset - b.offset;\n            if (diff === 0) {\n                return a.length - b.length;\n            }\n            return diff;\n        });\n        let lastModifiedOffset = text.length;\n        for (let i = sortedEdits.length - 1; i >= 0; i--) {\n            let e = sortedEdits[i];\n            if (e.offset + e.length <= lastModifiedOffset) {\n                text = edit.applyEdit(text, e);\n            }\n            else {\n                throw new Error('Overlapping edit');\n            }\n            lastModifiedOffset = e.offset;\n        }\n        return text;\n    }\n    exports.applyEdits = applyEdits;\n});\n","import { parse, type ParseError, parseTree, printParseErrorCode } from 'jsonc-parser'\n\nexport function parseJsonObject(text: string, path: string): Record<string, unknown> {\n  const errors: ParseError[] = []\n  const data = parse(text, errors, { allowTrailingComma: true }) as unknown\n  if (errors.length > 0) {\n    const details = errors\n      .map((e) => `${printParseErrorCode(e.error)} at offset ${e.offset}`)\n      .join('; ')\n    throw new Error(`Cannot parse ${path}: ${details}`)\n  }\n  if (typeof data !== 'object' || data === null || Array.isArray(data)) {\n    throw new Error(`Cannot parse ${path}: expected a JSON object`)\n  }\n  return data as Record<string, unknown>\n}\n\nexport function detectIndent(text: string): {\n  eol: string\n  insertSpaces: boolean\n  tabSize: number\n} {\n  // Anchor on the first real property of the root object so quoted lines\n  // Inside comments cannot skew the detected indentation.\n  const root = parseTree(text)\n  const firstProp = root?.children?.[0]?.children?.[0]\n  const lineStart = firstProp ? text.lastIndexOf('\\n', firstProp.offset) + 1 : -1\n  const leading = firstProp ? text.slice(lineStart, firstProp.offset) : ''\n  const indent = /^[ \\t]+$/.test(leading) ? leading : '  '\n  return {\n    eol: text.includes('\\r\\n') ? '\\r\\n' : '\\n',\n    insertSpaces: !indent.startsWith('\\t'),\n    tabSize: indent.startsWith('\\t') ? 1 : indent.length,\n  }\n}\n","import type { Tree } from '@nx/devkit'\nimport { applyEdits, modify } from 'jsonc-parser'\nimport { detectIndent, parseJsonObject } from './jsonc.ts'\n\nexport function readJson(tree: Tree, path: string): Record<string, unknown> | null {\n  if (!tree.exists(path)) {\n    return null\n  }\n  const text = tree.read(path, 'utf8')\n  if (text == null) {\n    return null\n  }\n  return parseJsonObject(text, path)\n}\n\n/**\n * Registers `plugin` in nx.json as `{ plugin, options: {} }`, preserving\n * JSONC comments and the file's own indentation. Dedupes string, tuple,\n * and object plugin forms; creates nx.json when missing.\n */\nexport function registerPlugin(tree: Tree, pluginPath: string): void {\n  const text = tree.exists('nx.json') ? tree.read('nx.json', 'utf8') : null\n  const nxJson = text == null ? {} : parseJsonObject(text, 'nx.json')\n  const plugins = Array.isArray(nxJson.plugins) ? (nxJson.plugins as unknown[]) : []\n  const alreadyRegistered = plugins.some(\n    (entry) =>\n      (typeof entry === 'string' && entry === pluginPath) ||\n      (Array.isArray(entry) && entry[0] === pluginPath) ||\n      (typeof entry === 'object' &&\n        entry !== null &&\n        !Array.isArray(entry) &&\n        (entry as { plugin?: string }).plugin === pluginPath),\n  )\n  if (alreadyRegistered) {\n    return\n  }\n\n  const entry = { options: {}, plugin: pluginPath }\n  if (text == null) {\n    tree.write('nx.json', `${JSON.stringify({ plugins: [entry] }, null, 2)}\\n`)\n    return\n  }\n  const formattingOptions = detectIndent(text)\n  const updated = applyEdits(\n    text,\n    modify(\n      text,\n      Array.isArray(nxJson.plugins) ? ['plugins', plugins.length] : ['plugins'],\n      Array.isArray(nxJson.plugins) ? entry : [entry],\n      { formattingOptions, isArrayInsertion: true },\n    ),\n  )\n  tree.write('nx.json', updated)\n}\n\n/** Nx names the root project from project.json, then nx.json, then package.json. */\nexport function resolveRootProjectName(tree: Tree): string | undefined {\n  for (const path of ['project.json', 'nx.json', 'package.json']) {\n    const name = readJson(tree, path)?.name\n    if (typeof name === 'string' && name) {\n      return name\n    }\n  }\n  return undefined\n}\n","import { formatFiles, type GeneratorCallback, type Tree } from '@nx/devkit'\nimport { registerPlugin, resolveRootProjectName } from '@nx-devkit/internal'\n\nexport interface NxKnipInitOptions {\n  pluginPath?: string\n}\n\nconst DEFAULT_PLUGIN_PATH = '@nx-devkit/knip'\n\nexport async function initGenerator(\n  tree: Tree,\n  options: NxKnipInitOptions = {},\n): Promise<GeneratorCallback> {\n  const pluginPath = options.pluginPath || DEFAULT_PLUGIN_PATH\n  const projectName = resolveRootProjectName(tree) ?? '{root-project}'\n\n  registerPlugin(tree, pluginPath)\n\n  const checklist = [\n    `1. The plugin is registered (${pluginPath}) — projects containing a knip config now have knip targets.`,\n    '2. Inspect inferred targets:',\n    '   bunx nx show projects',\n    `3. Run a target:  bunx nx run ${projectName}:knip`,\n  ]\n  for (const line of checklist) {\n    console.log(line)\n  }\n  await formatFiles(tree)\n\n  return () => {\n    /* No-op */\n  }\n}\n\nexport default initGenerator\n"],"x_google_ignoreList":[0],"mappings":"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"}

package/dist/plugin.d.mts

@@ -0,0 +1,22 @@
+import { CreateNodesV2 } from "@nx/devkit";
+
+//#region src/plugin.d.ts
+interface NxKnipPluginOptions {
+  /** Name of the knip target. Default: "knip". */
+  targetName?: string;
+  /** Also infer a `<targetName>:fix` target (`knip --fix`). Default: true. */
+  fixTarget?: boolean;
+}
+declare function configRank(fileName: string): number;
+declare function isKnipConfig(fileName: string): boolean;
+declare function hasKnipKey(absPath: string): boolean;
+declare const createNodesV2: CreateNodesV2<NxKnipPluginOptions>;
+declare const __testing: {
+  KNIP_GLOB: string;
+  configRank: typeof configRank;
+  hasKnipKey: typeof hasKnipKey;
+  isKnipConfig: typeof isKnipConfig;
+};
+//#endregion
+export { NxKnipPluginOptions, __testing, createNodesV2, createNodesV2 as default };
+//# sourceMappingURL=plugin.d.mts.map

package/dist/plugin.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.mts","names":[],"sources":["../src/plugin.ts"],"mappings":";;;UAIiB,mBAAA;;EAEf,UAAA;EAFkC;EAIlC,SAAS;AAAA;AAAA,iBAoBF,UAAA,CAAW,QAAgB;AAAA,iBAK3B,YAAA,CAAa,QAAgB;AAAA,iBAI7B,UAAA,CAAW,OAAe;AAAA,cAgBtB,aAAA,EAAe,aAAa,CAAC,mBAAA;AAAA,cAyD7B,SAAA"}

package/dist/plugin.mjs

@@ -0,0 +1,90 @@
+import { readFileSync } from "node:fs";
+import { dirname, relative, resolve } from "node:path";
+//#region src/plugin.ts
+const KNIP_GLOB = "**/{knip.json,knip.jsonc,knip.ts,knip.config.ts,knip.config.js,knip.config.mjs,knip.config.cjs,package.json}";
+const PRECEDENCE = [
+	"knip.json",
+	"knip.jsonc",
+	"knip.ts",
+	"knip.config.ts",
+	"knip.config.js",
+	"knip.config.mjs",
+	"knip.config.cjs",
+	"package.json"
+];
+function configRank(fileName) {
+	const idx = PRECEDENCE.indexOf(fileName);
+	return idx === -1 ? PRECEDENCE.length : idx;
+}
+function isKnipConfig(fileName) {
+	return configRank(fileName) < PRECEDENCE.length - 1;
+}
+function hasKnipKey(absPath) {
+	try {
+		const pkg = JSON.parse(readFileSync(absPath, "utf8"));
+		return typeof pkg === "object" && pkg !== null && "knip" in pkg;
+	} catch {
+		return false;
+	}
+}
+function shouldSkipDir(projectRoot, workspaceRoot) {
+	const rel = relative(workspaceRoot, resolve(workspaceRoot, projectRoot || "."));
+	if (rel === "") return false;
+	const segments = rel.split(/[\\/]/);
+	return segments.includes("..") || segments.includes("node_modules");
+}
+const createNodesV2 = [KNIP_GLOB, (configFiles, options = {}, context) => {
+	const workspaceRoot = context.workspaceRoot;
+	const targetName = options.targetName ?? "knip";
+	const fixTarget = options.fixTarget ?? true;
+	const byDir = /* @__PURE__ */ new Map();
+	for (const configFile of [...configFiles].sort()) {
+		const dir = dirname(configFile).replace(/\\/g, "/");
+		const key = dir === "." ? "" : dir;
+		const list = byDir.get(key) ?? [];
+		list.push(configFile);
+		byDir.set(key, list);
+	}
+	const results = [];
+	for (const [dir, files] of [...byDir.entries()].sort(([a], [b]) => a.localeCompare(b))) {
+		if (shouldSkipDir(dir, workspaceRoot)) continue;
+		const sorted = files.toSorted((a, b) => configRank(a.split("/").pop() ?? "") - configRank(b.split("/").pop() ?? ""));
+		const winner = sorted.at(0);
+		if (winner === void 0) continue;
+		if ((winner.split("/").pop() ?? "") === "package.json" && !hasKnipKey(resolve(workspaceRoot, winner))) continue;
+		const prefix = dir ? "{projectRoot}" : "{workspaceRoot}";
+		const configInputs = sorted.map((f) => `${prefix}/${dir ? f.slice(dir.length + 1) : f}`);
+		const targets = { [targetName]: {
+			executor: "nx:run-commands",
+			cache: true,
+			inputs: [`${prefix}/**/*.{ts,tsx,js,jsx,mts,cts,mjs,cjs,json,jsonc}`, ...configInputs],
+			options: {
+				command: "npx knip",
+				cwd: "{projectRoot}"
+			}
+		} };
+		if (fixTarget) targets[`${targetName}:fix`] = {
+			executor: "nx:run-commands",
+			cache: false,
+			options: {
+				command: "npx knip --fix",
+				cwd: "{projectRoot}"
+			}
+		};
+		results.push([winner, { projects: { [dir]: {
+			root: dir,
+			targets
+		} } }]);
+	}
+	return results;
+}];
+const __testing = {
+	KNIP_GLOB,
+	configRank,
+	hasKnipKey,
+	isKnipConfig
+};
+//#endregion
+export { __testing, createNodesV2, createNodesV2 as default };
+
+//# sourceMappingURL=plugin.mjs.map

package/dist/plugin.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.mjs","names":[],"sources":["../src/plugin.ts"],"sourcesContent":["import { readFileSync } from 'node:fs'\nimport { dirname, relative, resolve } from 'node:path'\nimport type { CreateNodesV2, ProjectConfiguration, TargetConfiguration } from '@nx/devkit'\n\nexport interface NxKnipPluginOptions {\n  /** Name of the knip target. Default: \"knip\". */\n  targetName?: string\n  /** Also infer a `<targetName>:fix` target (`knip --fix`). Default: true. */\n  fixTarget?: boolean\n}\n\n// Standalone knip configs plus package.json carrying a \"knip\" key — knip auto-discovers all of them when run from the owning directory.\nconst KNIP_GLOB =\n  '**/{knip.json,knip.jsonc,knip.ts,knip.config.ts,knip.config.js,knip.config.mjs,knip.config.cjs,package.json}'\n\n// Deterministic precedence when several config forms live in one directory —\n// Knip.json wins over everything else (matches knip's own discovery order).\nconst PRECEDENCE = [\n  'knip.json',\n  'knip.jsonc',\n  'knip.ts',\n  'knip.config.ts',\n  'knip.config.js',\n  'knip.config.mjs',\n  'knip.config.cjs',\n  'package.json',\n]\n\nfunction configRank(fileName: string): number {\n  const idx = PRECEDENCE.indexOf(fileName)\n  return idx === -1 ? PRECEDENCE.length : idx\n}\n\nfunction isKnipConfig(fileName: string): boolean {\n  return configRank(fileName) < PRECEDENCE.length - 1\n}\n\nfunction hasKnipKey(absPath: string): boolean {\n  try {\n    const pkg = JSON.parse(readFileSync(absPath, 'utf8'))\n    return typeof pkg === 'object' && pkg !== null && 'knip' in pkg\n  } catch {\n    return false\n  }\n}\n\nfunction shouldSkipDir(projectRoot: string, workspaceRoot: string): boolean {\n  const rel = relative(workspaceRoot, resolve(workspaceRoot, projectRoot || '.'))\n  if (rel === '') return false\n  const segments = rel.split(/[\\\\/]/)\n  return segments.includes('..') || segments.includes('node_modules')\n}\n\nexport const createNodesV2: CreateNodesV2<NxKnipPluginOptions> = [\n  KNIP_GLOB,\n  (configFiles, options = {}, context) => {\n    const workspaceRoot = context.workspaceRoot\n    const targetName = options.targetName ?? 'knip'\n    const fixTarget = options.fixTarget ?? true\n\n    // One target pair per owning directory — the highest-precedence config wins.\n    const byDir = new Map<string, string[]>()\n    for (const configFile of [...configFiles].sort()) {\n      const dir = dirname(configFile).replace(/\\\\/g, '/')\n      const key = dir === '.' ? '' : dir\n      const list = byDir.get(key) ?? []\n      list.push(configFile)\n      byDir.set(key, list)\n    }\n\n    const results: Array<readonly [string, { projects: Record<string, ProjectConfiguration> }]> = []\n    for (const [dir, files] of [...byDir.entries()].sort(([a], [b]) => a.localeCompare(b))) {\n      if (shouldSkipDir(dir, workspaceRoot)) continue\n\n      const sorted = files.toSorted(\n        (a, b) => configRank(a.split('/').pop() ?? '') - configRank(b.split('/').pop() ?? ''),\n      )\n      const winner = sorted.at(0)\n      if (winner === undefined) continue\n      const winnerName = winner.split('/').pop() ?? ''\n      if (winnerName === 'package.json' && !hasKnipKey(resolve(workspaceRoot, winner))) continue\n\n      const prefix = dir ? '{projectRoot}' : '{workspaceRoot}'\n      // Every knip-bearing file in the dir must bust the cache — paths are relative to the project root (\"\" for the root project).\n      const configInputs = sorted.map((f) => `${prefix}/${dir ? f.slice(dir.length + 1) : f}`)\n\n      const targets: Record<string, TargetConfiguration> = {\n        [targetName]: {\n          executor: 'nx:run-commands',\n          cache: true,\n          inputs: [`${prefix}/**/*.{ts,tsx,js,jsx,mts,cts,mjs,cjs,json,jsonc}`, ...configInputs],\n          options: { command: 'npx knip', cwd: '{projectRoot}' },\n        },\n      }\n      if (fixTarget) {\n        targets[`${targetName}:fix`] = {\n          executor: 'nx:run-commands',\n          cache: false,\n          options: { command: 'npx knip --fix', cwd: '{projectRoot}' },\n        }\n      }\n\n      results.push([winner, { projects: { [dir]: { root: dir, targets } } }])\n    }\n    return results\n  },\n]\n\nexport default createNodesV2\n\nexport const __testing = { KNIP_GLOB, configRank, hasKnipKey, isKnipConfig }\n"],"mappings":";;;AAYA,MAAM,YACJ;AAIF,MAAM,aAAa;CACjB;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF;AAEA,SAAS,WAAW,UAA0B;CAC5C,MAAM,MAAM,WAAW,QAAQ,QAAQ;CACvC,OAAO,QAAQ,KAAK,WAAW,SAAS;AAC1C;AAEA,SAAS,aAAa,UAA2B;CAC/C,OAAO,WAAW,QAAQ,IAAI,WAAW,SAAS;AACpD;AAEA,SAAS,WAAW,SAA0B;CAC5C,IAAI;EACF,MAAM,MAAM,KAAK,MAAM,aAAa,SAAS,MAAM,CAAC;EACpD,OAAO,OAAO,QAAQ,YAAY,QAAQ,QAAQ,UAAU;CAC9D,QAAQ;EACN,OAAO;CACT;AACF;AAEA,SAAS,cAAc,aAAqB,eAAgC;CAC1E,MAAM,MAAM,SAAS,eAAe,QAAQ,eAAe,eAAe,GAAG,CAAC;CAC9E,IAAI,QAAQ,IAAI,OAAO;CACvB,MAAM,WAAW,IAAI,MAAM,OAAO;CAClC,OAAO,SAAS,SAAS,IAAI,KAAK,SAAS,SAAS,cAAc;AACpE;AAEA,MAAa,gBAAoD,CAC/D,YACC,aAAa,UAAU,CAAC,GAAG,YAAY;CACtC,MAAM,gBAAgB,QAAQ;CAC9B,MAAM,aAAa,QAAQ,cAAc;CACzC,MAAM,YAAY,QAAQ,aAAa;CAGvC,MAAM,wBAAQ,IAAI,IAAsB;CACxC,KAAK,MAAM,cAAc,CAAC,GAAG,WAAW,CAAC,CAAC,KAAK,GAAG;EAChD,MAAM,MAAM,QAAQ,UAAU,CAAC,CAAC,QAAQ,OAAO,GAAG;EAClD,MAAM,MAAM,QAAQ,MAAM,KAAK;EAC/B,MAAM,OAAO,MAAM,IAAI,GAAG,KAAK,CAAC;EAChC,KAAK,KAAK,UAAU;EACpB,MAAM,IAAI,KAAK,IAAI;CACrB;CAEA,MAAM,UAAwF,CAAC;CAC/F,KAAK,MAAM,CAAC,KAAK,UAAU,CAAC,GAAG,MAAM,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC,GAAG;EACtF,IAAI,cAAc,KAAK,aAAa,GAAG;EAEvC,MAAM,SAAS,MAAM,UAClB,GAAG,MAAM,WAAW,EAAE,MAAM,GAAG,CAAC,CAAC,IAAI,KAAK,EAAE,IAAI,WAAW,EAAE,MAAM,GAAG,CAAC,CAAC,IAAI,KAAK,EAAE,CACtF;EACA,MAAM,SAAS,OAAO,GAAG,CAAC;EAC1B,IAAI,WAAW,KAAA,GAAW;EAE1B,KADmB,OAAO,MAAM,GAAG,CAAC,CAAC,IAAI,KAAK,QAC3B,kBAAkB,CAAC,WAAW,QAAQ,eAAe,MAAM,CAAC,GAAG;EAElF,MAAM,SAAS,MAAM,kBAAkB;EAEvC,MAAM,eAAe,OAAO,KAAK,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,MAAM,IAAI,SAAS,CAAC,IAAI,GAAG;EAEvF,MAAM,UAA+C,GAClD,aAAa;GACZ,UAAU;GACV,OAAO;GACP,QAAQ,CAAC,GAAG,OAAO,mDAAmD,GAAG,YAAY;GACrF,SAAS;IAAE,SAAS;IAAY,KAAK;GAAgB;EACvD,EACF;EACA,IAAI,WACF,QAAQ,GAAG,WAAW,SAAS;GAC7B,UAAU;GACV,OAAO;GACP,SAAS;IAAE,SAAS;IAAkB,KAAK;GAAgB;EAC7D;EAGF,QAAQ,KAAK,CAAC,QAAQ,EAAE,UAAU,GAAG,MAAM;GAAE,MAAM;GAAK;EAAQ,EAAE,EAAE,CAAC,CAAC;CACxE;CACA,OAAO;AACT,CACF;AAIA,MAAa,YAAY;CAAE;CAAW;CAAY;CAAY;AAAa"}

package/generators.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "https://json-schema.org/schema",
+  "generators": {
+    "init": {
+      "factory": "./dist/generators/init/generator.mjs",
+      "schema": "./src/generators/init/schema.json",
+      "description": "Registers @nx-devkit/knip in nx.json plugins."
+    }
+  }
+}

package/package.json

@@ -1,10 +1,8 @@
 {
-  "bugs": {
-    "url": "https://github.com/nx-devkit/nx.ts/issues"
-  },
-  "description": "Placeholder for @nx-devkit/knip published by @nx-devkit/prepare-for-release.",
-  "homepage": "https://github.com/nx-devkit/nx.ts/tree/main/packages/knip",
+  "name": "@nx-devkit/knip",
+  "version": "0.0.1",
   "license": "MIT",
+  "description": "Nx plugin: knip config files infer a cached knip target — dead exports/files/dependencies detection without project.json.",
   "keywords": [
     "nx",
     "nx-plugin",
@@ -15,16 +13,54 @@
     "monorepo",
     "zero-config"
   ],
-  "name": "@nx-devkit/knip",
-  "publishConfig": {
-    "access": "public",
-    "registry": "https://registry.npmjs.org/"
+  "private": false,
+  "type": "module",
+  "main": "./dist/plugin.mjs",
+  "module": "./dist/plugin.mjs",
+  "types": "./dist/plugin.d.mts",
+  "exports": {
+    ".": {
+      "types": "./dist/plugin.d.mts",
+      "default": "./dist/plugin.mjs"
+    },
+    "./package.json": "./package.json",
+    "./generators/init": {
+      "types": "./dist/generators/init/generator.d.mts",
+      "default": "./dist/generators/init/generator.mjs"
+    }
+  },
+  "files": [
+    "dist",
+    "generators.json",
+    "src/generators/init/schema.json",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsdown",
+    "test": "vitest run"
+  },
+  "peerDependencies": {
+    "knip": "^5.0.0 || ^6.0.0"
+  },
+  "devDependencies": {
+    "@nx-devkit/internal": "0.0.0",
+    "@types/node": "^26.0.0",
+    "knip": "^6.0.0",
+    "tsdown": "^0.22.3",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.11"
   },
   "repository": {
     "type": "git",
     "url": "https://github.com/nx-devkit/nx.ts",
     "directory": "packages/knip"
   },
-  "type": "module",
-  "version": "0.0.0"
-}
+  "bugs": {
+    "url": "https://github.com/nx-devkit/nx.ts/issues"
+  },
+  "homepage": "https://github.com/nx-devkit/nx.ts/tree/main/packages/knip",
+  "dependencies": {
+    "@nx/devkit": "^22.0.0 || ^23.0.0"
+  },
+  "generators": "./generators.json"
+}

package/src/generators/init/schema.json

@@ -0,0 +1,15 @@
+{
+  "$schema": "https://json-schema.org/schema",
+  "type": "object",
+  "title": "Init generator",
+  "description": "Registers @nx-devkit/knip in nx.json plugins.",
+  "properties": {
+    "pluginPath": {
+      "type": "string",
+      "default": "@nx-devkit/knip",
+      "minLength": 1,
+      "description": "Plugin specifier to register (e.g. a local path during development)."
+    }
+  },
+  "additionalProperties": false
+}