jest-fuzzy 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Christian Cantrell
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,249 @@
+# jest-fuzzy
+
+[![npm version](https://img.shields.io/npm/v/jest-fuzzy.svg)](https://www.npmjs.com/package/jest-fuzzy)
+[![license](https://img.shields.io/npm/l/jest-fuzzy.svg)](https://github.com/example/jest-fuzzy/blob/main/LICENSE)
+
+LLM-powered fuzzy matchers for Jest.
+
+## Why?
+
+Testing non-deterministic outputs (like LLM responses, generated content, or natural language) with exact string matching is brittle. `jest-fuzzy` extends Jest with semantic matchers that use lightweight LLMs to judge whether outputs match expectations.
+
+```typescript
+// Instead of this (brittle):
+expect(response).toBe("Hello! How can I help you today?");
+
+// Do this (flexible):
+await expect(response).toSemanticallyMatch("Hi, how may I assist you?");
+```
+
+## Installation
+
+```bash
+npm install jest-fuzzy --save-dev
+```
+
+Install the SDK for your preferred LLM provider:
+
+```bash
+# For Claude (default)
+npm install @anthropic-ai/sdk
+
+# For Gemini
+npm install @google/generative-ai
+
+# For OpenAI
+npm install openai
+```
+
+## Quick Start
+
+**1. Set your API key:**
+
+```bash
+export ANTHROPIC_API_KEY=your-key-here
+# or GOOGLE_API_KEY for Gemini
+# or OPENAI_API_KEY for OpenAI
+```
+
+**2. Register the matchers in your Jest setup file:**
+
+```typescript
+// jest.setup.ts
+import { configure } from "jest-fuzzy";
+
+configure({
+  model: "claude-haiku-4-5", // optional, this is the default
+});
+```
+
+Or simply import for defaults (Claude):
+
+```typescript
+// jest.setup.ts
+import "jest-fuzzy";
+```
+
+**3. Reference the setup file in your Jest config:**
+
+```javascript
+// jest.config.js
+module.exports = {
+  setupFilesAfterEnv: ["./jest.setup.ts"],
+};
+```
+
+**4. Use the matchers in your tests:**
+
+```typescript
+describe("chatbot", () => {
+  it("responds with a greeting", async () => {
+    const response = await chatbot.greet();
+    await expect(response).toSemanticallyMatch("Hello, how can I help?");
+  });
+
+  it("provides helpful responses", async () => {
+    const response = await chatbot.answer("What is 2+2?");
+    await expect(response).toSatisfy("contains the number 4 and is polite");
+  });
+});
+```
+
+## API Reference
+
+### `configure(options?)`
+
+Configures jest-fuzzy with your preferred model.
+
+```typescript
+import { configure } from "jest-fuzzy";
+
+configure({
+  model: "claude-haiku-4-5", // or "gemini-3-flash-preview" or "gpt-5-nano"
+});
+```
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `model` | `string` | `"claude-haiku-4-5"` | The LLM model to use for judging |
+
+### `toSemanticallyMatch(expected, options?)`
+
+Tests whether the received string has the same semantic meaning as the expected string.
+
+```typescript
+await expect("Hello! How can I help you today?").toSemanticallyMatch(
+  "Hi, how may I assist you?"
+);
+```
+
+**Options:**
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `threshold` | `"strict"` \| `"loose"` | `"loose"` | How strictly to judge semantic equivalence |
+| `context` | `string` | - | Additional context to help the LLM judge |
+
+**Examples:**
+
+```typescript
+// Basic usage
+await expect("The sky is blue").toSemanticallyMatch("The color of the sky is blue");
+
+// With strict threshold
+await expect(response).toSemanticallyMatch("The capital of France is Paris", {
+  threshold: "strict",
+});
+
+// With context
+await expect("Paris").toSemanticallyMatch("The capital of France", {
+  context: "Testing a geography Q&A bot asking about France's capital",
+});
+
+// Negation
+await expect("I love sunny weather").not.toSemanticallyMatch("I hate sunny weather");
+```
+
+### `toSatisfy(criteria)`
+
+Tests whether the received string satisfies the given natural language criteria.
+
+```typescript
+await expect(summary).toSatisfy(
+  "mentions climate change and includes at least one statistic"
+);
+```
+
+**Examples:**
+
+```typescript
+// Testing content
+await expect(article).toSatisfy("discusses renewable energy");
+
+// Testing tone
+await expect(response).toSatisfy("is polite and professional in tone");
+
+// Testing structure
+await expect(output).toSatisfy("is valid JSON containing a 'name' field");
+
+// Testing safety
+await expect(response).not.toSatisfy("contains profanity or offensive language");
+```
+
+## Configuration
+
+### Environment Variables
+
+Set the API key for your chosen model:
+
+| Model | Environment Variable |
+|-------|---------------------|
+| `claude-haiku-4-5` | `ANTHROPIC_API_KEY` |
+| `gemini-3-flash-preview` | `GOOGLE_API_KEY` |
+| `gpt-5-nano` | `OPENAI_API_KEY` |
+
+### Supported Models
+
+| Model ID | Provider | Description |
+|----------|----------|-------------|
+| `claude-haiku-4-5` | Anthropic | Fast, cost-effective Claude model (default) |
+| `gemini-3-flash-preview` | Google | Fast Gemini model |
+| `gpt-5-nano` | OpenAI | Lightweight GPT model |
+
+## TypeScript Support
+
+jest-fuzzy includes full TypeScript support. The matchers are automatically typed when you import the library:
+
+```typescript
+import "jest-fuzzy";
+
+// Types are automatically available
+await expect("hello").toSemanticallyMatch("hi");
+await expect("hello").toSatisfy("is a greeting");
+```
+
+## Error Messages
+
+When tests fail, jest-fuzzy includes the LLM's reasoning to help you understand why:
+
+```
+Expected "The weather is nice" to semantically match "It's raining heavily"
+
+LLM reasoning: These statements have opposite meanings. The first indicates
+pleasant weather conditions, while the second describes heavy rainfall.
+```
+
+## Best Practices
+
+1. **Use semantic matching for equivalent meanings**, not for checking specific content:
+   ```typescript
+   // Good: checking semantic equivalence
+   await expect(greeting).toSemanticallyMatch("Hello, how can I help?");
+
+   // Better for specific content: use toSatisfy
+   await expect(response).toSatisfy("mentions the user's name 'John'");
+   ```
+
+2. **Provide context when the comparison needs domain knowledge:**
+   ```typescript
+   await expect("42").toSemanticallyMatch("The answer", {
+     context: "Testing a Hitchhiker's Guide to the Galaxy trivia bot",
+   });
+   ```
+
+3. **Use `threshold: "strict"` when precision matters:**
+   ```typescript
+   await expect(legalText).toSemanticallyMatch(expectedDisclaimer, {
+     threshold: "strict",
+   });
+   ```
+
+4. **Consider test runtime:** Each matcher makes an API call, so use them judiciously in large test suites.
+
+## Author
+
+[Christian Cantrell](https://christiancantrell.com)
+
+## License
+
+MIT

package/dist/cjs/config.d.ts

@@ -0,0 +1,5 @@
+import type { JestFuzzyConfig, LLMProvider } from "./types.js";
+export declare function configure(config?: JestFuzzyConfig): void;
+export declare function getConfig(): Required<JestFuzzyConfig>;
+export declare function getProvider(): Promise<LLMProvider>;
+//# sourceMappingURL=config.d.ts.map

package/dist/cjs/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAa,WAAW,EAAE,MAAM,YAAY,CAAC;AAY1E,wBAAgB,SAAS,CAAC,MAAM,GAAE,eAAoB,GAAG,IAAI,CAQ5D;AAED,wBAAgB,SAAS,IAAI,QAAQ,CAAC,eAAe,CAAC,CAIrD;AAED,wBAAsB,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC,CAaxD"}

package/dist/cjs/config.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.configure = configure;
+exports.getConfig = getConfig;
+exports.getProvider = getProvider;
+const index_js_1 = require("./providers/index.js");
+const DEFAULT_MODEL = "claude-haiku-4-5";
+let currentConfig = {
+    model: DEFAULT_MODEL,
+};
+let providerInstance = null;
+let providerPromise = null;
+function configure(config = {}) {
+    currentConfig = {
+        model: config.model ?? DEFAULT_MODEL,
+    };
+    // Reset provider so it will be re-created with new config
+    providerInstance = null;
+    providerPromise = null;
+}
+function getConfig() {
+    return {
+        model: currentConfig.model ?? DEFAULT_MODEL,
+    };
+}
+async function getProvider() {
+    if (providerInstance) {
+        return providerInstance;
+    }
+    if (!providerPromise) {
+        providerPromise = (0, index_js_1.createProvider)(getConfig().model).then((provider) => {
+            providerInstance = provider;
+            return provider;
+        });
+    }
+    return providerPromise;
+}
+//# sourceMappingURL=config.js.map

package/dist/cjs/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":";;AAYA,8BAQC;AAED,8BAIC;AAED,kCAaC;AAxCD,mDAAsD;AAEtD,MAAM,aAAa,GAAc,kBAAkB,CAAC;AAEpD,IAAI,aAAa,GAAoB;IACnC,KAAK,EAAE,aAAa;CACrB,CAAC;AAEF,IAAI,gBAAgB,GAAuB,IAAI,CAAC;AAChD,IAAI,eAAe,GAAgC,IAAI,CAAC;AAExD,SAAgB,SAAS,CAAC,SAA0B,EAAE;IACpD,aAAa,GAAG;QACd,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,aAAa;KACrC,CAAC;IAEF,0DAA0D;IAC1D,gBAAgB,GAAG,IAAI,CAAC;IACxB,eAAe,GAAG,IAAI,CAAC;AACzB,CAAC;AAED,SAAgB,SAAS;IACvB,OAAO;QACL,KAAK,EAAE,aAAa,CAAC,KAAK,IAAI,aAAa;KAC5C,CAAC;AACJ,CAAC;AAEM,KAAK,UAAU,WAAW;IAC/B,IAAI,gBAAgB,EAAE,CAAC;QACrB,OAAO,gBAAgB,CAAC;IAC1B,CAAC;IAED,IAAI,CAAC,eAAe,EAAE,CAAC;QACrB,eAAe,GAAG,IAAA,yBAAc,EAAC,SAAS,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE;YACpE,gBAAgB,GAAG,QAAQ,CAAC;YAC5B,OAAO,QAAQ,CAAC;QAClB,CAAC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,eAAe,CAAC;AACzB,CAAC"}

package/dist/cjs/index.d.ts

@@ -0,0 +1,5 @@
+import { configure, getConfig, getProvider } from "./config.js";
+import type { JestFuzzyConfig, SemanticMatchOptions, ModelName, LLMProvider } from "./types.js";
+export { configure, getConfig, getProvider };
+export type { JestFuzzyConfig, SemanticMatchOptions, ModelName, LLMProvider, };
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAGhE,OAAO,KAAK,EACV,eAAe,EACf,oBAAoB,EACpB,SAAS,EACT,WAAW,EACZ,MAAM,YAAY,CAAC;AAUpB,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC;AAC7C,YAAY,EACV,eAAe,EACf,oBAAoB,EACpB,SAAS,EACT,WAAW,GACZ,CAAC"}

package/dist/cjs/index.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getProvider = exports.getConfig = exports.configure = void 0;
+const config_js_1 = require("./config.js");
+Object.defineProperty(exports, "configure", { enumerable: true, get: function () { return config_js_1.configure; } });
+Object.defineProperty(exports, "getConfig", { enumerable: true, get: function () { return config_js_1.getConfig; } });
+Object.defineProperty(exports, "getProvider", { enumerable: true, get: function () { return config_js_1.getProvider; } });
+const toSemanticallyMatch_js_1 = require("./matchers/toSemanticallyMatch.js");
+const toSatisfy_js_1 = require("./matchers/toSatisfy.js");
+// Register matchers with Jest
+if (typeof expect !== "undefined" && expect.extend) {
+    expect.extend({
+        toSemanticallyMatch: toSemanticallyMatch_js_1.toSemanticallyMatch,
+        toSatisfy: toSatisfy_js_1.toSatisfy,
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;AAAA,2CAAgE;AAkBvD,0FAlBA,qBAAS,OAkBA;AAAE,0FAlBA,qBAAS,OAkBA;AAAE,4FAlBA,uBAAW,OAkBA;AAjB1C,8EAAwE;AACxE,0DAAoD;AAQpD,8BAA8B;AAC9B,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;IACnD,MAAM,CAAC,MAAM,CAAC;QACZ,mBAAmB,EAAnB,4CAAmB;QACnB,SAAS,EAAT,wBAAS;KACV,CAAC,CAAC;AACL,CAAC"}

package/dist/cjs/matchers/index.d.ts

@@ -0,0 +1,3 @@
+export { toSemanticallyMatch } from "./toSemanticallyMatch.js";
+export { toSatisfy } from "./toSatisfy.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/matchers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/matchers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/cjs/matchers/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toSatisfy = exports.toSemanticallyMatch = void 0;
+var toSemanticallyMatch_js_1 = require("./toSemanticallyMatch.js");
+Object.defineProperty(exports, "toSemanticallyMatch", { enumerable: true, get: function () { return toSemanticallyMatch_js_1.toSemanticallyMatch; } });
+var toSatisfy_js_1 = require("./toSatisfy.js");
+Object.defineProperty(exports, "toSatisfy", { enumerable: true, get: function () { return toSatisfy_js_1.toSatisfy; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/matchers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/matchers/index.ts"],"names":[],"mappings":";;;AAAA,mEAA+D;AAAtD,6HAAA,mBAAmB,OAAA;AAC5B,+CAA2C;AAAlC,yGAAA,SAAS,OAAA"}

package/dist/cjs/matchers/toSatisfy.d.ts

@@ -0,0 +1,3 @@
+import type { MatcherResult } from "../types.js";
+export declare function toSatisfy(this: jest.MatcherContext, received: unknown, criteria: string): Promise<MatcherResult>;
+//# sourceMappingURL=toSatisfy.d.ts.map

package/dist/cjs/matchers/toSatisfy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toSatisfy.d.ts","sourceRoot":"","sources":["../../../src/matchers/toSatisfy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAYjD,wBAAsB,SAAS,CAC7B,IAAI,EAAE,IAAI,CAAC,cAAc,EACzB,QAAQ,EAAE,OAAO,EACjB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,aAAa,CAAC,CAgCxB"}

package/dist/cjs/matchers/toSatisfy.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toSatisfy = toSatisfy;
+const config_js_1 = require("../config.js");
+function buildPrompt(received, criteria) {
+    return `Does the following text satisfy the given criteria?
+
+Text: "${received}"
+Criteria: ${criteria}
+
+Return verdict=true if the text satisfies the criteria, false otherwise.`;
+}
+async function toSatisfy(received, criteria) {
+    if (typeof received !== "string") {
+        return {
+            pass: false,
+            message: () => `Expected a string but received ${typeof received}: ${JSON.stringify(received)}`,
+        };
+    }
+    const provider = await (0, config_js_1.getProvider)();
+    const prompt = buildPrompt(received, criteria);
+    try {
+        const { verdict, explanation } = await provider.judge(prompt);
+        return {
+            pass: verdict,
+            message: () => {
+                if (verdict) {
+                    return `Expected "${received}" NOT to satisfy "${criteria}"\n\nLLM reasoning: ${explanation}`;
+                }
+                else {
+                    return `Expected "${received}" to satisfy "${criteria}"\n\nLLM reasoning: ${explanation}`;
+                }
+            },
+        };
+    }
+    catch (error) {
+        return {
+            pass: false,
+            message: () => `Failed to evaluate criteria: ${error instanceof Error ? error.message : String(error)}`,
+        };
+    }
+}
+//# sourceMappingURL=toSatisfy.js.map

package/dist/cjs/matchers/toSatisfy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toSatisfy.js","sourceRoot":"","sources":["../../../src/matchers/toSatisfy.ts"],"names":[],"mappings":";;AAYA,8BAoCC;AA/CD,4CAA2C;AAE3C,SAAS,WAAW,CAAC,QAAgB,EAAE,QAAgB;IACrD,OAAO;;SAEA,QAAQ;YACL,QAAQ;;yEAEqD,CAAC;AAC1E,CAAC;AAEM,KAAK,UAAU,SAAS,CAE7B,QAAiB,EACjB,QAAgB;IAEhB,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACjC,OAAO;YACL,IAAI,EAAE,KAAK;YACX,OAAO,EAAE,GAAG,EAAE,CACZ,kCAAkC,OAAO,QAAQ,KAAK,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE;SACnF,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,IAAA,uBAAW,GAAE,CAAC;IACrC,MAAM,MAAM,GAAG,WAAW,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAE/C,IAAI,CAAC;QACH,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAE9D,OAAO;YACL,IAAI,EAAE,OAAO;YACb,OAAO,EAAE,GAAG,EAAE;gBACZ,IAAI,OAAO,EAAE,CAAC;oBACZ,OAAO,aAAa,QAAQ,qBAAqB,QAAQ,uBAAuB,WAAW,EAAE,CAAC;gBAChG,CAAC;qBAAM,CAAC;oBACN,OAAO,aAAa,QAAQ,iBAAiB,QAAQ,uBAAuB,WAAW,EAAE,CAAC;gBAC5F,CAAC;YACH,CAAC;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,IAAI,EAAE,KAAK;YACX,OAAO,EAAE,GAAG,EAAE,CACZ,gCAAgC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;SAC3F,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/cjs/matchers/toSemanticallyMatch.d.ts

@@ -0,0 +1,3 @@
+import type { SemanticMatchOptions, MatcherResult } from "../types.js";
+export declare function toSemanticallyMatch(this: jest.MatcherContext, received: unknown, expected: string, options?: SemanticMatchOptions): Promise<MatcherResult>;
+//# sourceMappingURL=toSemanticallyMatch.d.ts.map

package/dist/cjs/matchers/toSemanticallyMatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toSemanticallyMatch.d.ts","sourceRoot":"","sources":["../../../src/matchers/toSemanticallyMatch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAoBvE,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,IAAI,CAAC,cAAc,EACzB,QAAQ,EAAE,OAAO,EACjB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,aAAa,CAAC,CAgCxB"}

package/dist/cjs/matchers/toSemanticallyMatch.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toSemanticallyMatch = toSemanticallyMatch;
+const config_js_1 = require("../config.js");
+function buildPrompt(received, expected, options) {
+    const contextLine = options.context ? `Context: ${options.context}\n` : "";
+    const threshold = options.threshold ?? "loose";
+    return `Do these two texts have the same semantic meaning?
+${contextLine}Strictness: ${threshold}
+
+Text A: "${received}"
+Text B: "${expected}"
+
+Return verdict=true if they have the same semantic meaning, false otherwise.`;
+}
+async function toSemanticallyMatch(received, expected, options = {}) {
+    if (typeof received !== "string") {
+        return {
+            pass: false,
+            message: () => `Expected a string but received ${typeof received}: ${JSON.stringify(received)}`,
+        };
+    }
+    const provider = await (0, config_js_1.getProvider)();
+    const prompt = buildPrompt(received, expected, options);
+    try {
+        const { verdict, explanation } = await provider.judge(prompt);
+        return {
+            pass: verdict,
+            message: () => {
+                if (verdict) {
+                    return `Expected "${received}" NOT to semantically match "${expected}"\n\nLLM reasoning: ${explanation}`;
+                }
+                else {
+                    return `Expected "${received}" to semantically match "${expected}"\n\nLLM reasoning: ${explanation}`;
+                }
+            },
+        };
+    }
+    catch (error) {
+        return {
+            pass: false,
+            message: () => `Failed to evaluate semantic match: ${error instanceof Error ? error.message : String(error)}`,
+        };
+    }
+}
+//# sourceMappingURL=toSemanticallyMatch.js.map

package/dist/cjs/matchers/toSemanticallyMatch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toSemanticallyMatch.js","sourceRoot":"","sources":["../../../src/matchers/toSemanticallyMatch.ts"],"names":[],"mappings":";;AAoBA,kDAqCC;AAxDD,4CAA2C;AAE3C,SAAS,WAAW,CAClB,QAAgB,EAChB,QAAgB,EAChB,OAA6B;IAE7B,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,OAAO,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3E,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC;IAE/C,OAAO;EACP,WAAW,eAAe,SAAS;;WAE1B,QAAQ;WACR,QAAQ;;6EAE0D,CAAC;AAC9E,CAAC;AAEM,KAAK,UAAU,mBAAmB,CAEvC,QAAiB,EACjB,QAAgB,EAChB,UAAgC,EAAE;IAElC,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACjC,OAAO;YACL,IAAI,EAAE,KAAK;YACX,OAAO,EAAE,GAAG,EAAE,CACZ,kCAAkC,OAAO,QAAQ,KAAK,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE;SACnF,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,IAAA,uBAAW,GAAE,CAAC;IACrC,MAAM,MAAM,GAAG,WAAW,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IAExD,IAAI,CAAC;QACH,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAE9D,OAAO;YACL,IAAI,EAAE,OAAO;YACb,OAAO,EAAE,GAAG,EAAE;gBACZ,IAAI,OAAO,EAAE,CAAC;oBACZ,OAAO,aAAa,QAAQ,gCAAgC,QAAQ,uBAAuB,WAAW,EAAE,CAAC;gBAC3G,CAAC;qBAAM,CAAC;oBACN,OAAO,aAAa,QAAQ,4BAA4B,QAAQ,uBAAuB,WAAW,EAAE,CAAC;gBACvG,CAAC;YACH,CAAC;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,IAAI,EAAE,KAAK;YACX,OAAO,EAAE,GAAG,EAAE,CACZ,sCAAsC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;SACjG,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/cjs/providers/anthropic.d.ts

@@ -0,0 +1,8 @@
+import type { LLMProvider, JudgmentResult } from "../types.js";
+export declare class AnthropicProvider implements LLMProvider {
+    private client;
+    private constructor();
+    static create(): Promise<AnthropicProvider>;
+    judge(prompt: string): Promise<JudgmentResult>;
+}
+//# sourceMappingURL=anthropic.d.ts.map

package/dist/cjs/providers/anthropic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic.d.ts","sourceRoot":"","sources":["../../../src/providers/anthropic.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAqB/D,qBAAa,iBAAkB,YAAW,WAAW;IACnD,OAAO,CAAC,MAAM,CAAM;IAEpB,OAAO;WAIM,MAAM,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAoB3C,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;CAyBrD"}

package/dist/cjs/providers/anthropic.js

@@ -0,0 +1,94 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AnthropicProvider = void 0;
+const JUDGMENT_SCHEMA = {
+    type: "json_schema",
+    schema: {
+        type: "object",
+        properties: {
+            verdict: {
+                type: "boolean",
+                description: "true if the condition is satisfied, false otherwise",
+            },
+            explanation: {
+                type: "string",
+                description: "Brief explanation of the reasoning",
+            },
+        },
+        required: ["verdict", "explanation"],
+        additionalProperties: false,
+    },
+};
+class AnthropicProvider {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    static async create() {
+        const apiKey = process.env.ANTHROPIC_API_KEY;
+        if (!apiKey) {
+            throw new Error("jest-fuzzy: Missing ANTHROPIC_API_KEY environment variable for claude-haiku-4-5 model");
+        }
+        try {
+            const module = await Promise.resolve().then(() => __importStar(require("@anthropic-ai/sdk")));
+            const Anthropic = module.default;
+            const client = new Anthropic({ apiKey });
+            return new AnthropicProvider(client);
+        }
+        catch (e) {
+            throw new Error("jest-fuzzy: To use claude-haiku-4-5, install @anthropic-ai/sdk");
+        }
+    }
+    async judge(prompt) {
+        try {
+            const response = await this.client.beta.messages.create({
+                model: "claude-haiku-4-5",
+                max_tokens: 1024,
+                betas: ["structured-outputs-2025-11-13"],
+                messages: [{ role: "user", content: prompt }],
+                output_format: JUDGMENT_SCHEMA,
+            });
+            const text = response.content[0].text;
+            const parsed = JSON.parse(text);
+            return { verdict: parsed.verdict, explanation: parsed.explanation };
+        }
+        catch (error) {
+            throw new Error(`jest-fuzzy: LLM API call failed: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+}
+exports.AnthropicProvider = AnthropicProvider;
+//# sourceMappingURL=anthropic.js.map

package/dist/cjs/providers/anthropic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic.js","sourceRoot":"","sources":["../../../src/providers/anthropic.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEA,MAAM,eAAe,GAAG;IACtB,IAAI,EAAE,aAAsB;IAC5B,MAAM,EAAE;QACN,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,OAAO,EAAE;gBACP,IAAI,EAAE,SAAkB;gBACxB,WAAW,EAAE,qDAAqD;aACnE;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,QAAiB;gBACvB,WAAW,EAAE,oCAAoC;aAClD;SACF;QACD,QAAQ,EAAE,CAAC,SAAS,EAAE,aAAa,CAAC;QACpC,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC;AAEF,MAAa,iBAAiB;IACpB,MAAM,CAAM;IAEpB,YAAoB,MAAW;QAC7B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,MAAM;QACjB,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;QAC7C,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CACb,uFAAuF,CACxF,CAAC;QACJ,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,wDAAa,mBAAmB,GAAC,CAAC;YACjD,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC;YACjC,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;YACzC,OAAO,IAAI,iBAAiB,CAAC,MAAM,CAAC,CAAC;QACvC,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CACb,gEAAgE,CACjE,CAAC;QACJ,CAAC;IACH,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,MAAc;QACxB,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;gBACtD,KAAK,EAAE,kBAAkB;gBACzB,UAAU,EAAE,IAAI;gBAChB,KAAK,EAAE,CAAC,+BAA+B,CAAC;gBACxC,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;gBAC7C,aAAa,EAAE,eAAe;aAC/B,CAAC,CAAC;YAEH,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YACtC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAG7B,CAAC;YAEF,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,CAAC;QACtE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CACb,oCACE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CACvD,EAAE,CACH,CAAC;QACJ,CAAC;IACH,CAAC;CACF;AApDD,8CAoDC"}

package/dist/cjs/providers/google.d.ts

@@ -0,0 +1,8 @@
+import type { LLMProvider, JudgmentResult } from "../types.js";
+export declare class GoogleProvider implements LLMProvider {
+    private model;
+    private constructor();
+    static create(): Promise<GoogleProvider>;
+    judge(prompt: string): Promise<JudgmentResult>;
+}
+//# sourceMappingURL=google.d.ts.map

package/dist/cjs/providers/google.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"google.d.ts","sourceRoot":"","sources":["../../../src/providers/google.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE/D,qBAAa,cAAe,YAAW,WAAW;IAChD,OAAO,CAAC,KAAK,CAAM;IAEnB,OAAO;WAIM,MAAM,IAAI,OAAO,CAAC,cAAc,CAAC;IAyCxC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;CAcrD"}