@yuu1111/knip-config 1.0.3 → 1.0.4

package/README.ja.md

@@ -34,7 +34,8 @@ export default {
 ### base
 
 - `ignoreExportsUsedInFile` は自分のfile内だけで参照されるexportを報告から外す
-- `ignoreFiles` は `quality-check` が実行時に読み込む `quality.config.ts` を報告から外す
+- `entry` は `quality-check` が実行時に読み込む `quality.config.ts` をentry pointとして扱う 未使用fileとして報告せず、このfileがimportするexportも利用中とみなす
+- `ignoreIssues` は `quality.config.ts` 自身のexportを報告から外す 利用側の入口は `quality-check` のAPIであり、このfileのexportではない
 
 ### application
 
@@ -48,6 +49,15 @@ export default {
 
 動的なentry point、CLI binary、生成物は共有presetがProject構成から推測できないため利用Project側に残す
 
+`base` が足す `entry` は、利用Projectが `entry` を書くと置き換わる 自分のentryを足すときは `quality.config.ts` も並べる
+
+```ts
+export default {
+	...application,
+	entry: ["src/main.ts", "quality.config.ts"]
+}
+```
+
 別Projectを同居させているrepositoryは `ignore` でそのProjectを報告から外し、親のsourceとして読ませない
 
 ```ts
@@ -58,3 +68,5 @@ export default {
 	ignore: ["another-project/**"]
 }
 ```
+
+`workspaces` を持つrepositoryで `entry` をtop levelに書くとKnipがconfiguration hintを出す 報告ではないため終了codeは変わらない

package/README.md

@@ -35,6 +35,8 @@ export default {
 ### base
 
 - `ignoreExportsUsedInFile` keeps exports that are only referenced inside their own file out of the report
+- `entry` treats `quality.config.ts`, which `quality-check` loads at run time, as an entry point: it is not reported as an unused file and the exports it imports count as used
+- `ignoreIssues` keeps the exports of `quality.config.ts` itself out of the report, because the entry point of a consuming project is the API of `quality-check` and not the exports of this file
 
 ### application
 
@@ -49,6 +51,16 @@ export default {
 Dynamic entry points, CLI binaries, and generated files stay in the consuming
 project because a shared preset cannot infer them from the project layout.
 
+The `entry` that `base` adds is replaced when a project writes its own `entry`,
+so an added entry lists `quality.config.ts` as well:
+
+```ts
+export default {
+	...application,
+	entry: ["src/main.ts", "quality.config.ts"]
+}
+```
+
 A repository that also holds another project keeps that project out of the
 report with `ignore`, so its files are not read as source of the parent:
 
@@ -60,3 +72,7 @@ export default {
 	ignore: ["another-project/**"]
 }
 ```
+
+Knip prints a configuration hint when a repository with `workspaces` writes
+`entry` at the top level. A hint is not a report, so the exit code does not
+change.

package/base.ts

@@ -4,8 +4,10 @@ import type { KnipConfig } from "knip";
  * 各presetが共通で継承するbase設定を提供する
  */
 export const base = {
+	// quality-checkが実行時に読み込むentrypointとして扱い、未使用fileとして報告しない
+	entry: ["quality.config.ts"],
 	// 同一file内で参照しているexportは内部利用とみなす
 	ignoreExportsUsedInFile: true,
-	// quality-checkが実行時に読み込むため、Projectのsourceとして報告しない
-	ignoreFiles: ["quality.config.ts"],
+	// config file自身のexportは利用側の入口ではないため報告しない
+	ignoreIssues: { "quality.config.ts": ["exports"] },
 } satisfies KnipConfig;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@yuu1111/knip-config",
-	"version": "1.0.3",
+	"version": "1.0.4",
 	"description": "Shared Knip configuration",
 	"license": "MIT",
 	"repository": {