vite-plugin-nudo 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,12 @@
+# vite-plugin-nudo
+
+## 0.1.0
+
+### Minor Changes
+
+- Conceptual design and basic implementation.
+
+### Patch Changes
+
+- Updated dependencies
+  - @nudojs/service@0.1.0

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+type NudoPluginOptions = {
+    include?: string[];
+    exclude?: string[];
+    failOnError?: boolean;
+};
+declare function nudoPlugin(options?: NudoPluginOptions): any;
+
+export { type NudoPluginOptions, nudoPlugin as default };

package/dist/index.js

@@ -0,0 +1,64 @@
+// src/index.ts
+import { analyzeFile } from "@nudojs/service";
+var DEFAULT_INCLUDE = ["**/*.js"];
+var DEFAULT_EXCLUDE = ["**/node_modules/**"];
+function matchesPatterns(id, include, exclude) {
+  const isExcluded = exclude.some((p) => minimatch(id, p));
+  if (isExcluded) return false;
+  return include.some((p) => minimatch(id, p));
+}
+function minimatch(str, pattern) {
+  if (pattern === "**/*.js") return str.endsWith(".js");
+  if (pattern === "**/node_modules/**") return str.includes("/node_modules/");
+  if (pattern.startsWith("**/")) {
+    return str.endsWith(pattern.slice(3)) || str.includes(pattern.slice(2));
+  }
+  return str.includes(pattern);
+}
+function nudoPlugin(options = {}) {
+  const include = options.include ?? DEFAULT_INCLUDE;
+  const exclude = options.exclude ?? DEFAULT_EXCLUDE;
+  const failOnError = options.failOnError ?? false;
+  const analysisCache = /* @__PURE__ */ new Map();
+  return {
+    name: "vite-plugin-nudo",
+    buildStart() {
+      analysisCache.clear();
+    },
+    transform(code, id) {
+      if (!matchesPatterns(id, include, exclude)) return null;
+      if (!/@nudo:(case|mock|pure|skip|sample|returns)\b/.test(code)) return null;
+      try {
+        const result = analyzeFile(id, code);
+        analysisCache.set(id, result);
+        for (const diag of result.diagnostics) {
+          const loc = `${id}:${diag.range.start.line}:${diag.range.start.column}`;
+          const msg = `[nudo] ${loc} ${diag.severity}: ${diag.message}`;
+          if (diag.severity === "error") {
+            if (failOnError) {
+              this.error(msg);
+            } else {
+              this.warn(msg);
+            }
+          } else if (diag.severity === "warning") {
+            this.warn(msg);
+          }
+        }
+      } catch (err) {
+        this.warn(`[nudo] Failed to analyze ${id}: ${err.message}`);
+      }
+      return null;
+    },
+    buildEnd() {
+      const totalDiags = Array.from(analysisCache.values()).reduce((sum, r) => sum + r.diagnostics.length, 0);
+      if (totalDiags > 0) {
+        const errorCount = Array.from(analysisCache.values()).reduce((sum, r) => sum + r.diagnostics.filter((d) => d.severity === "error").length, 0);
+        const warnCount = totalDiags - errorCount;
+        console.log(`[nudo] Analysis complete: ${errorCount} error(s), ${warnCount} warning(s)`);
+      }
+    }
+  };
+}
+export {
+  nudoPlugin as default
+};

package/package.json

@@ -0,0 +1,15 @@
+{
+  "name": "vite-plugin-nudo",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "src/index.ts",
+  "dependencies": {
+    "@nudojs/service": "0.1.0"
+  },
+  "peerDependencies": {
+    "vite": ">=5.0.0"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --dts"
+  }
+}

package/src/__tests__/plugin.test.ts

@@ -0,0 +1,81 @@
+import { describe, it, expect, vi } from "vitest";
+import nudoPlugin from "../index.ts";
+
+describe("vite-plugin-nudo", () => {
+  it("creates a plugin with correct name", () => {
+    const plugin = nudoPlugin();
+    expect(plugin.name).toBe("vite-plugin-nudo");
+  });
+
+  it("returns null for files without @nudo: directives", () => {
+    const plugin = nudoPlugin();
+    const result = plugin.transform.call({}, "const x = 1;", "/test/file.js");
+    expect(result).toBeNull();
+  });
+
+  it("returns null for node_modules files", () => {
+    const plugin = nudoPlugin();
+    const result = plugin.transform.call({}, "const x = 1;", "/node_modules/pkg/file.js");
+    expect(result).toBeNull();
+  });
+
+  it("analyzes files with @nudo: directives and reports warnings", () => {
+    const plugin = nudoPlugin();
+    const warnFn = vi.fn();
+    const ctx = { warn: warnFn, error: vi.fn() };
+
+    const source = `
+/**
+ * @nudo:case "negative" (-1)
+ */
+function safeSqrt(x) {
+  if (x < 0) {
+    throw new RangeError("negative input");
+  }
+  return x;
+}
+`;
+    const result = plugin.transform.call(ctx, source, "/test/throws.js");
+    expect(result).toBeNull();
+    expect(warnFn).toHaveBeenCalled();
+  });
+
+  it("respects custom include patterns", () => {
+    const plugin = nudoPlugin({ include: ["**/*.typed.js"] });
+    const result = plugin.transform.call({}, "const x = 1;", "/test/file.js");
+    expect(result).toBeNull();
+  });
+
+  it("clears cache on buildStart", () => {
+    const plugin = nudoPlugin();
+    plugin.buildStart.call({});
+    // No error means cache cleared successfully
+  });
+
+  it("reports summary on buildEnd", () => {
+    const plugin = nudoPlugin();
+    const consoleSpy = vi.spyOn(console, "log").mockImplementation(() => {});
+    plugin.buildStart.call({});
+    plugin.buildEnd.call({});
+    consoleSpy.mockRestore();
+  });
+
+  it("errors when failOnError is true and diagnostics have errors", () => {
+    const plugin = nudoPlugin({ failOnError: true });
+    const errorFn = vi.fn();
+    const warnFn = vi.fn();
+    const ctx = { warn: warnFn, error: errorFn };
+
+    const source = `
+/**
+ * @nudo:case "test" (T.number)
+ * @nudo:returns (T.string)
+ */
+function identity(x) {
+  return x;
+}
+`;
+    plugin.transform.call(ctx, source, "/test/fail.js");
+    expect(errorFn).toHaveBeenCalled();
+  });
+});

package/src/index.ts

@@ -0,0 +1,81 @@
+import { analyzeFile, type AnalysisResult } from "@nudojs/service";
+
+export type NudoPluginOptions = {
+  include?: string[];
+  exclude?: string[];
+  failOnError?: boolean;
+};
+
+const DEFAULT_INCLUDE = ["**/*.js"];
+const DEFAULT_EXCLUDE = ["**/node_modules/**"];
+
+function matchesPatterns(id: string, include: string[], exclude: string[]): boolean {
+  const isExcluded = exclude.some((p) => minimatch(id, p));
+  if (isExcluded) return false;
+  return include.some((p) => minimatch(id, p));
+}
+
+function minimatch(str: string, pattern: string): boolean {
+  if (pattern === "**/*.js") return str.endsWith(".js");
+  if (pattern === "**/node_modules/**") return str.includes("/node_modules/");
+  if (pattern.startsWith("**/")) {
+    return str.endsWith(pattern.slice(3)) || str.includes(pattern.slice(2));
+  }
+  return str.includes(pattern);
+}
+
+export default function nudoPlugin(options: NudoPluginOptions = {}): any {
+  const include = options.include ?? DEFAULT_INCLUDE;
+  const exclude = options.exclude ?? DEFAULT_EXCLUDE;
+  const failOnError = options.failOnError ?? false;
+
+  const analysisCache = new Map<string, AnalysisResult>();
+
+  return {
+    name: "vite-plugin-nudo",
+
+    buildStart() {
+      analysisCache.clear();
+    },
+
+    transform(code: string, id: string) {
+      if (!matchesPatterns(id, include, exclude)) return null;
+      if (!/@nudo:(case|mock|pure|skip|sample|returns)\b/.test(code)) return null;
+
+      try {
+        const result = analyzeFile(id, code);
+        analysisCache.set(id, result);
+
+        for (const diag of result.diagnostics) {
+          const loc = `${id}:${diag.range.start.line}:${diag.range.start.column}`;
+          const msg = `[nudo] ${loc} ${diag.severity}: ${diag.message}`;
+
+          if (diag.severity === "error") {
+            if (failOnError) {
+              (this as any).error(msg);
+            } else {
+              (this as any).warn(msg);
+            }
+          } else if (diag.severity === "warning") {
+            (this as any).warn(msg);
+          }
+        }
+      } catch (err) {
+        (this as any).warn(`[nudo] Failed to analyze ${id}: ${(err as Error).message}`);
+      }
+
+      return null;
+    },
+
+    buildEnd() {
+      const totalDiags = Array.from(analysisCache.values())
+        .reduce((sum, r) => sum + r.diagnostics.length, 0);
+      if (totalDiags > 0) {
+        const errorCount = Array.from(analysisCache.values())
+          .reduce((sum, r) => sum + r.diagnostics.filter((d) => d.severity === "error").length, 0);
+        const warnCount = totalDiags - errorCount;
+        console.log(`[nudo] Analysis complete: ${errorCount} error(s), ${warnCount} warning(s)`);
+      }
+    },
+  };
+}

package/tsconfig.json

@@ -0,0 +1,11 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "outDir": "dist",
+    "rootDir": "src"
+  },
+  "include": ["src"],
+  "references": [
+    { "path": "../service" }
+  ]
+}