vite-plugin-css-module-types 1.0.0

package/src/tests/path-filter.spec.ts

@@ -0,0 +1,130 @@
+import { describe, it, expect } from "vitest";
+import {
+  normalizeFolderPath,
+  normalizeFolderList,
+  isInFolders,
+  shouldProcessFile,
+} from "../lib/path-filter.ts";
+
+// ─── normalizeFolderPath ────────────────────────────────────────────────────
+
+describe("normalizeFolderPath", () => {
+  it("returns the path unchanged when already normalized", () => {
+    expect(normalizeFolderPath("apps/app/src")).toBe("apps/app/src");
+  });
+
+  it("replaces backslashes with forward slashes", () => {
+    expect(normalizeFolderPath("apps\\app\\src")).toBe("apps/app/src");
+  });
+
+  it('strips leading "./"', () => {
+    expect(normalizeFolderPath("./apps/app")).toBe("apps/app");
+  });
+
+  it('strips leading "/"', () => {
+    expect(normalizeFolderPath("/apps/app")).toBe("apps/app");
+  });
+
+  it("strips trailing slashes", () => {
+    expect(normalizeFolderPath("apps/app/")).toBe("apps/app");
+    expect(normalizeFolderPath("apps/app///")).toBe("apps/app");
+  });
+
+  it("handles combined edge cases", () => {
+    expect(normalizeFolderPath(".\\apps\\app\\")).toBe("apps/app");
+  });
+
+  it("returns empty string for root-like paths", () => {
+    expect(normalizeFolderPath("./")).toBe("");
+    expect(normalizeFolderPath("/")).toBe("");
+  });
+});
+
+// ─── normalizeFolderList ────────────────────────────────────────────────────
+
+describe("normalizeFolderList", () => {
+  it("returns empty array for undefined", () => {
+    expect(normalizeFolderList(undefined)).toEqual([]);
+  });
+
+  it("returns empty array for empty string", () => {
+    expect(normalizeFolderList("")).toEqual([]);
+  });
+
+  it("wraps a single string into a normalized array", () => {
+    expect(normalizeFolderList("./apps/app/")).toEqual(["apps/app"]);
+  });
+
+  it("normalizes each item in an array", () => {
+    expect(normalizeFolderList(["./apps/app/", "apps\\shared"])).toEqual([
+      "apps/app",
+      "apps/shared",
+    ]);
+  });
+
+  it("filters out empty results after normalization", () => {
+    expect(normalizeFolderList(["./", "apps/app"])).toEqual(["apps/app"]);
+  });
+});
+
+// ─── isInFolders ────────────────────────────────────────────────────────────
+
+describe("isInFolders", () => {
+  it("returns false for empty folders array", () => {
+    expect(isInFolders("apps/app/src/file.css", [])).toBe(false);
+  });
+
+  it("returns true when file is inside a matching folder", () => {
+    expect(isInFolders("apps/app/src/file.css", ["apps/app/src"])).toBe(true);
+  });
+
+  it("returns true when file path matches the folder exactly", () => {
+    expect(isInFolders("apps/app/src", ["apps/app/src"])).toBe(true);
+  });
+
+  it("returns false when file is outside all folders", () => {
+    expect(isInFolders("apps/admin/src/file.css", ["apps/app/src"])).toBe(false);
+  });
+
+  it("returns true when matching any of multiple folders", () => {
+    expect(isInFolders("apps/shared/src/ui/button.css", ["apps/app/src", "apps/shared/src"])).toBe(
+      true,
+    );
+  });
+
+  it("does not match partial folder names", () => {
+    expect(isInFolders("apps/app/src-legacy/file.css", ["apps/app/src"])).toBe(false);
+  });
+
+  it("normalizes backslashes in the file path", () => {
+    expect(isInFolders("apps\\app\\src\\file.css", ["apps/app/src"])).toBe(true);
+  });
+});
+
+// ─── shouldProcessFile ──────────────────────────────────────────────────────
+
+describe("shouldProcessFile", () => {
+  it("includes all files when include list is empty", () => {
+    expect(shouldProcessFile("any/path/file.css", [], [])).toBe(true);
+  });
+
+  it("includes files matching include folders", () => {
+    expect(shouldProcessFile("src/ui/file.css", ["src"], [])).toBe(true);
+  });
+
+  it("excludes files not matching include folders", () => {
+    expect(shouldProcessFile("other/file.css", ["src"], [])).toBe(false);
+  });
+
+  it("respects exclude over include", () => {
+    expect(shouldProcessFile("src/legacy/file.css", ["src"], ["src/legacy"])).toBe(false);
+  });
+
+  it("allows files in include but not in exclude", () => {
+    expect(shouldProcessFile("src/features/file.css", ["src"], ["src/legacy"])).toBe(true);
+  });
+
+  it("excludes even when include is empty (all included)", () => {
+    expect(shouldProcessFile("vendor/lib.css", [], ["vendor"])).toBe(false);
+  });
+});

package/src/tests/transform.spec.ts

@@ -0,0 +1,101 @@
+import { describe, it, expect } from "vitest";
+import { patchViteModuleCode, evaluateModuleExports } from "../lib/transform.ts";
+
+// ─── patchViteModuleCode ────────────────────────────────────────────────────
+
+describe("patchViteModuleCode", () => {
+  it("comments out import statements", () => {
+    const code = 'import { updateStyle } from "/@vite/client"';
+    const result = patchViteModuleCode(code);
+    expect(result).toBe('// import { updateStyle } from "/@vite/client"');
+  });
+
+  it("comments out __vite__updateStyle calls", () => {
+    const code = '__vite__updateStyle("id", css)';
+    const result = patchViteModuleCode(code);
+    expect(result).toBe('// __vite__updateStyle("id", css)');
+  });
+
+  it("comments out import.meta.hot references", () => {
+    const code = "import.meta.hot.accept()";
+    const result = patchViteModuleCode(code);
+    expect(result).toBe("// import.meta.hot.accept()");
+  });
+
+  it("removes entire if(import.meta.hot) blocks", () => {
+    const code = ["const x = 1;", "if (import.meta.hot) {", "  import.meta.hot.accept()", "}"].join(
+      "\n",
+    );
+    const result = patchViteModuleCode(code);
+    expect(result).toContain("const x = 1;");
+    expect(result).not.toContain("import.meta.hot");
+  });
+
+  it("re-exports __vite__css as an export", () => {
+    const code = 'const __vite__css = ".button { }"';
+    const result = patchViteModuleCode(code);
+    expect(result).toBe('export const __vite__css = ".button { }"');
+  });
+
+  it("applies all patches together on realistic Vite output", () => {
+    const viteOutput = [
+      'import { updateStyle, removeStyle } from "/@vite/client"',
+      'const __vite__css = ".btn_hash { color: red; }"',
+      '__vite__updateStyle("some-id", __vite__css)',
+      'export default { "btn": "btn_hash" }',
+      "if (import.meta.hot) {",
+      "  import.meta.hot.accept()",
+      "}",
+    ].join("\n");
+
+    const patched = patchViteModuleCode(viteOutput);
+
+    expect(patched).toContain("// import { updateStyle");
+    expect(patched).toContain("export const __vite__css");
+    expect(patched).toContain("// __vite__updateStyle");
+    expect(patched).not.toContain("import.meta.hot");
+    expect(patched).toContain("export default");
+  });
+});
+
+// ─── evaluateModuleExports ──────────────────────────────────────────────────
+
+describe("evaluateModuleExports", () => {
+  it("extracts class mapping and CSS text from patched code", async () => {
+    const patchedCode = [
+      'export const __vite__css = ".btn_hash123 { color: red; }";',
+      'export default { "btn": "btn_hash123" };',
+    ].join("\n");
+
+    const result = await evaluateModuleExports(patchedCode);
+    expect(result.classMapping).toEqual({ btn: "btn_hash123" });
+    expect(result.cssText).toBe(".btn_hash123 { color: red; }");
+  });
+
+  it("returns empty classMapping when no default export", async () => {
+    const patchedCode = 'export const __vite__css = ".x { }";';
+    const result = await evaluateModuleExports(patchedCode);
+    expect(result.classMapping).toEqual({});
+    expect(result.cssText).toBe(".x { }");
+  });
+
+  it("returns empty cssText when __vite__css is not exported", async () => {
+    const patchedCode = 'export default { "a": "a_hash" };';
+    const result = await evaluateModuleExports(patchedCode);
+    expect(result.classMapping).toEqual({ a: "a_hash" });
+    expect(result.cssText).toBe("");
+  });
+
+  it("handles multiple class exports", async () => {
+    const patchedCode = [
+      'export const __vite__css = ".a_h1 {} .b_h2 {}";',
+      'export default { "my-class": "a_h1", "other": "b_h2" };',
+    ].join("\n");
+
+    const result = await evaluateModuleExports(patchedCode);
+    expect(result.classMapping).toEqual({
+      "my-class": "a_h1",
+      other: "b_h2",
+    });
+  });
+});