vite-plugin-nudo 0.3.3 → 0.4.0

package/README.md

@@ -25,14 +25,28 @@ import nudo from 'vite-plugin-nudo'
 export default {
   plugins: [
     nudo({
-      include: '**/*.js',       // default
-      exclude: '**/node_modules/**', // default
-      failOnError: false,       // default
+      // include / exclude accept `string | string[]` (normalized to string[] at runtime)
+      include: ['**/*.js', '**/*.mjs', '**/*.ts'], // default — matches isNudoTargetPath (.js/.mjs/.ts)
+      exclude: ['**/node_modules/**', '**/*.d.ts'], // default
+      failOnError: false, // default — contract errors warn, do not fail the build
     }),
   ],
 }
 ```
 
+## Analysis gating
+
+File selection is two-stage:
+
+1. **Path globs** (`include` / `exclude`) — defaults cover `**/*.js`, `**/*.mjs`, `**/*.ts` (the same extensions `isNudoTargetPath` accepts; `.cjs` / `.cts` / `.mts` / `.tsx` / `.d.ts` / `*.nudo.js` are not analysis targets).
+2. **`nudo.analysis.mode`** via `shouldAnalyzeFile` — same gate as the LSP/CLI. Shipped default is `"exports"` (files with `@nudo:`, `export`, or a sidecar are analyzed). Set `"all"` or `"directives"` in `package.json#nudo.analysis` to widen or tighten the gate.
+
+## Diagnostics & failOnError
+
+- **Diagnostics tier** follows `package.json#nudo.analysis.diagnostics` when set. With a project `nudo` config present but no explicit tier, the plugin uses the same `analysisConfig` default as the LSP (`mode=directives` → `errors`; `exports`/`all` → `default`). Without a project config the plugin keeps its historical `default` tier (errors + warnings) so ad-hoc files still surface warnings in build logs.
+- **`failOnError`** defaults to **false** (intentional, E3): build-time diagnostics warn rather than fail, so broad analysis modes do not break CI on false positives. Use `nudo check` as the contract CI gate, or pass `failOnError: true` to block the build on error-severity contract diagnostics.
+- Display filtering via `nudo.analysis.diagnostics: "off"` silences plugin diagnostics; it does **not** replace `nudo check`.
+
 ## License
 
 [MIT](https://github.com/nudojs/nudo/blob/main/LICENSE)

package/dist/index.d.ts

@@ -1,6 +1,12 @@
 type NudoPluginOptions = {
-    include?: string[];
-    exclude?: string[];
+    include?: string[] | string;
+    exclude?: string[] | string;
+    /**
+     * error 级诊断是否让构建失败。
+     * 默认 false（E3 / docs）：构建期诊断先 warn，避免无指令/隐式推断误伤 CI。
+     * 契约门禁请用 `nudo check`（CI gate）或显式 `failOnError: true`。
+     * 项目可用 `nudo.analysis.diagnostics` 控制噪声档；显式契约 error 仍会打出。
+     */
     failOnError?: boolean;
 };
 declare function nudoPlugin(options?: NudoPluginOptions): any;

package/dist/index.js

@@ -1,14 +1,24 @@
 // src/index.ts
 import {
   analyzeFileAsync,
+  analysisConfig,
   defaultLoadModule as loadModule,
-  clearAnalysisSessionCaches
+  clearAnalysisSessionCaches,
+  shouldAnalyzeFile,
+  filterDiagnosticsByLevel,
+  findProjectConfig,
+  interfaceConfig
 } from "@nudojs/service";
+import { dirname } from "path";
 import { checkSource, pTrue } from "@nudojs/core";
-var NUDO_DIRECTIVE_RE = /@nudo:(case|mock|pure|skip|sample|refine|import|env|mock-module|as|replace)\b/;
 function checkIssuesToDiagnostics(id, code) {
   try {
-    const report = checkSource(id, code, pTrue, { loadModule, fromFile: id });
+    const autoBind = interfaceConfig(findProjectConfig(dirname(id))?.config).autoBind;
+    const report = checkSource(id, code, pTrue, {
+      loadModule,
+      fromFile: id,
+      ...autoBind === false ? { autoBind: false } : {}
+    });
     return report.issues.filter((i) => i.severity === "error" || i.severity === "warning").map((i) => {
       const line = i.line ?? 1;
       const column = i.column ?? 0;
@@ -31,7 +41,16 @@ function checkIssuesToDiagnostics(id, code) {
     return [];
   }
 }
-var DEFAULT_INCLUDE = ["**/*.js", "**/*.mjs", "**/*.ts", "**/*.mts"];
+function viteDiagnosticsLevel(id) {
+  const proj = findProjectConfig(dirname(id));
+  const raw = proj?.config?.analysis?.diagnostics;
+  if (raw === "off" || raw === "errors" || raw === "default" || raw === "verbose") {
+    return raw;
+  }
+  if (proj) return analysisConfig(proj.config).diagnostics;
+  return "default";
+}
+var DEFAULT_INCLUDE = ["**/*.js", "**/*.mjs", "**/*.ts"];
 var DEFAULT_EXCLUDE = ["**/node_modules/**", "**/*.d.ts"];
 var REGEX_SPECIALS = /[\\^$.|?*+(){}\[\]]/;
 function escapeRegExpChar(ch) {
@@ -71,7 +90,8 @@ function compilePattern(pattern) {
   return (id) => regExp.test(id);
 }
 function compileAnyMatcher(patterns) {
-  const matchers = patterns.map(compilePattern);
+  const list = Array.isArray(patterns) ? patterns : [patterns];
+  const matchers = list.map(compilePattern);
   return (id) => matchers.some((match) => match(id));
 }
 function nudoPlugin(options = {}) {
@@ -93,11 +113,18 @@ function nudoPlugin(options = {}) {
     async transform(code, id) {
       if (excludeMatch(id)) return null;
       if (!includeMatch(id)) return null;
-      if (!NUDO_DIRECTIVE_RE.test(code)) return null;
+      if (!shouldAnalyzeFile(id, code)) return null;
       try {
         const result = await analyzeFileAsync(id, code);
         const checkDiags = checkIssuesToDiagnostics(id, code);
-        const merged = { ...result, diagnostics: [...result.diagnostics, ...checkDiags] };
+        const level = viteDiagnosticsLevel(id);
+        const merged = {
+          ...result,
+          diagnostics: filterDiagnosticsByLevel(
+            [...result.diagnostics, ...checkDiags],
+            level
+          )
+        };
         analysisCache.set(id, merged);
         for (const diag of merged.diagnostics) {
           const loc = `${id}:${diag.range.start.line}:${diag.range.start.column}`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vite-plugin-nudo",
-  "version": "0.3.3",
+  "version": "0.4.0",
   "engines": {
     "node": ">=20"
   },
@@ -38,8 +38,8 @@
     "registry": "https://registry.npmjs.org"
   },
   "dependencies": {
-    "@nudojs/core": "1.0.0",
-    "@nudojs/service": "1.0.0"
+    "@nudojs/core": "2.0.0",
+    "@nudojs/service": "2.0.0"
   },
   "peerDependencies": {
     "vite": ">=5.0.0"