spotr 0.1.3 → 1.0.0-alpha.0

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2017 Andy Merskin
+Copyright (c) 2025 Andy Merskin
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -1,7 +1,17 @@
-# spotr
-> A powerful and minimal search library for static websites.
+<img src="./examples/shared/spotr.svg" alt="Spotr logo" width="160" />
 
-Great for prototyping search systems during development, or for apps and sites with smaller collections that are being requested and filtered up front.
+# Spotr
+
+A powerful and minimal client-side fuzzy search library with zero dependencies.
+
+## Features
+
+- **Zero Dependencies** - Custom Levenshtein implementation, no external deps
+- **Fuzzy Matching** - Configurable threshold (0-1) for fuzzy string matching
+- **Nested Field Support** - Dot notation for deeply nested object properties
+- **Keyword Filtering** - Pre-filter collections with custom keyword handlers
+- **Framework Integrations** - React hooks and Vue composables
+- **TypeScript** - Full type definitions included
 
 ## Installation
 
@@ -9,189 +19,167 @@ Great for prototyping search systems during development, or for apps and sites w
 npm install spotr
 ```
 
-## Getting Started
-
-When creating a new instance of Spotr, it accepts a `collection`, `field` filters, and `keyword` filters.
-
-```javascript
-import Spotr from 'spotr'
-import products from 'products.csv'
+## Basic Usage
+
+```typescript
+import { Spotr } from 'spotr';
+
+type Game = {
+  title: string;
+  genres: string[];
+  releaseYear: number;
+  completed: boolean;
+};
+
+const games = new Spotr<Game>({
+  collection: gamesArray,
+  threshold: 0.3,
+  fields: [
+    { name: 'title', weight: 1 },
+    { name: 'releaseYear', weight: 0.8 },
+  ],
+  limit: 20,
+});
+
+const { results, matchedKeywords, tokens, warnings } = games.query('witcher');
+// results: Array<{ item: Game, score: number }>
+```
 
-const search = new Spotr({
-  
-  // Collection of objects to search on
-  collection: products,
+## Options
 
-  // Full-text fields to match search query against
-  fields: {
+### `collection` (required)
 
-    // item.name
-    name: {
-      fuzzy: 0,
-      boost: 9
-    },
+Array or Set of objects to search.
 
-    // item.category
-    category: {
-      fuzzy: 0,
-      boost: 8
-    }
-  },
-  
-  // Keyword definitions
-  keywords: {
-    isAwesome: {
-
-      // Specific queries to match. Queries with multiple words possible too!
-      queries: ['awesome', 'amazing', 'incredible', 'terrific', 'super cool'],
-
-      // Filter to run on the collection when any of the above queries exist in the search query
-      filter: collection => collection.filter(item => item.isAwesome)
-    }
-  }
-})
+```typescript
+collection: gamesArray // or new Set(gamesArray)
 ```
 
-### Collection
-The **collection** is the array of objects you want to search against. For static websites with a small set of things to search for, using `webpack` to load a JSON or CSV file makes it easy to bundle your collection with the final build.
+### `fields` (required)
 
-```javascript
-import products from 'products.csv'
+Properties to search against with weight configuration. Supports dot notation for nested objects.
 
-const search = new Spotr({
-  collection: products
-})
+```typescript
+fields: [
+  'title',                              // string shorthand, weight: 1
+  { name: 'title', weight: 1 },         // full config
+  { name: 'email', weight: 0.7 },       // lower priority
+  { name: 'address.city', weight: 0.8 }, // nested field
+]
 ```
 
+### `keywords` (optional)
 
-### Fields
-**Fields** tell Spotr to search against a specific string property on each item in the collection. Results are scored and sorted based on them.
+Keywords that trigger specific collection filtering before fuzzy matching.
 
-```javascript
-fields: {
-  title: {
-    boost: 9,
-    fuzzy: 0.3
-  },
-  category: {
-    boost: 8
-  }
+```typescript
+keywords: {
+  mode: 'and',
+  definitions: [
+    {
+      name: 'completed',
+      triggers: ['done', 'complete', 'finished'],
+      handler: (collection) => collection.filter(item => item.completed),
+    },
+    {
+      name: 'platform',
+      triggers: ['ps4', 'ps5', 'xbox', 'pc', 'switch'],
+      handler: (collection, matchedTerms) =>
+        collection.filter(item =>
+          matchedTerms.some(term => 
+            item.platforms.some(p => p.toLowerCase().includes(term))
+          )
+        ),
+    },
+  ],
 }
 ```
 
-`fuzzy` is number between 0 and 1 passed to the `string-score` library, which determines how relaxed to be while scoring. 0 means exact matches, and 1 allows for misspellings.
-
-`boost` is a multiplier applied to the final string score to prioritize the result if the field has a positive match. For instance, you may want queries matching closest to the name or title of an item to rank higher than if it matches its category.
-
-**Example**
+### `threshold` (optional)
 
-| property | boost value |
-| --- | --- |
-| title | 9 |
-| category | 8 |
-| label | 7 |
-| author | 6 |
+Global fuzzy matching threshold. Default: `0.3`
 
-When multiple fields on an item have positive matches, their scores are added together. Finally, the items' total scores are sorted to return the most relevant results.
+- `0` = match anything (no filtering)
+- `0.3` = recommended default
+- `1` = exact match required
 
+### `limit` (optional)
 
-### Keywords
-**Keywords** tell Spotr to look for specific queries within the search query to further filter the collection.
+Maximum number of results to return. Default: `Infinity`
 
-```javascript
-keywords: {
-  completed: {
-    queries: ['complete', 'completed', 'is done'],
-    filter: collection => collection.filter(item => item.completed)
-  }
-}
-```
+### `caseSensitive` (optional)
 
-`queries` is an array of query strings to match. They can be one word, or multiple words, but must match exactly for the filter to be applied.
+Enable case-sensitive matching. Default: `false`
 
-`filter` is a function that takes in the `collection` where mutations can safely be applied and returned.
+### `minMatchCharLength` (optional)
 
-#### Keywords are applied additively
-Keyword filters are applied to the collection additively, so if multiple filters are a positive match, it will result in a narrower set of results. The filtered collection is finally passed to our `fields` before returning the final result.
+Minimum query length to trigger matching. Default: `1`
 
-#### Search query refinement
-When `keyword` definitions are being used, matching queries are removed from the search query before being tested against each field. For example, if we wanted to filter shirts on clearance:
+## Result Type
 
-```javascript
-keywords: {
-  clearance: {
-    queries: ['clearance', 'sale', 'for sale', 'on sale'],
-    filter: collection => collection.filter(item => item.clearance)
-  }
+```typescript
+interface SpotrResult<T> {
+  results: ScoredResult<T>[];  // Array of { item, score }
+  matchedKeywords: MatchedKeyword[];  // Keywords that matched
+  tokens: string[];  // Non-keyword search terms
+  warnings: string[];  // Warnings (e.g., missing nested paths)
 }
 ```
 
-...and we searched for **red flannel shirts on sale**, our search query used in our fields would be **red flannel shirts**, because "on sale" was matched, since we know "on sale" won't show up in the names or categories of our products.
+## React Hook
 
-## Instance Methods
+```typescript
+import { useSpotr } from 'spotr/react';
 
-### query(searchString)
+function GameSearch({ games, searchQuery }) {
+  const spotr = useSpotr({
+    collection: games,
+    fields: [{ name: 'title', weight: 1 }],
+  });
+  
+  const { results } = useMemo(
+    () => spotr.query(searchQuery),
+    [spotr, searchQuery]
+  );
+  
+  return <ResultsTable results={results} />;
+}
+```
 
-Query the collection with a search string.
+## Vue Composable
 
-- `searchString` - The string query to match against the [`keywords`](#keywords) and [`fields`](#fields) definitions.
+```typescript
+import { useSpotr } from 'spotr/vue';
 
-Returns the filtered collection after being processed by keyword and field filters.
+const games = ref<Game[]>([]);
+const query = ref('');
 
-```javascript
-const search = new Spotr({
-  fields: {
-    gameTitle: {
-      boost: 9
-    }
-  },
-  keywords: {
-    allAges: {
-      queries: ['all ages'],
-      filter: collection => collection.filter(item => item.allAges)
-    }
-  }
-})
+const spotr = useSpotr(() => ({
+  collection: games.value,
+  fields: [{ name: 'title', weight: 1 }],
+}));
 
-search.query('party games for all ages')
-// => Array of games for all ages
+const results = computed(() => spotr.value?.query(query.value));
 ```
 
-### collection
+## API Methods
 
-Get or set the collection Spotr is searching against.
+### `query(search: string): SpotrResult<T>`
 
-- `collection` - An array of objects.
+Search the collection with a string query.
 
-```javascript
-const search = new Spotr({ ... })
+### `queryAsync(search: string): Promise<SpotrResult<T>>`
 
-// Get the collection
-search.collection // [ item, item ...]
+Async search with optional debouncing.
 
-// Set the collection
-search.collection = [
-  { name: 'Watermelon', rating: 5 },
-  { name: 'Prune', rating: 4 },
-  { name: 'Durian', rating: 1}
-]
-// Nothing against durians... well, they just smell bad.
-```
+### `setCollection(collection: T[] | Set<T>): void`
 
-## Contributors
+Update the collection.
 
-### Developing
-```sh
-git clone https://github.com/docmars/spotr
-cd spotr
-npm install
-npm run dev
-```
+### `collection: T[]` (getter)
 
-### Building
-```sh
-npm run build
-```
+Access the current collection.
 
 ## License
+
 MIT

package/dist/Spotr.cjs

@@ -0,0 +1,2 @@
+"use strict";var k=Object.defineProperty;var T=(u,e,t)=>e in u?k(u,e,{enumerable:!0,configurable:!0,writable:!0,value:t}):u[e]=t;var c=(u,e,t)=>T(u,typeof e!="symbol"?e+"":e,t);Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const m=require("./errors.cjs"),y=require("./utils/validate.cjs"),f=require("./fuzzy/scorer.cjs"),S=require("./utils/tokenize.cjs");class K{constructor(e){c(this,"_collection");c(this,"_fields");c(this,"_keywords");c(this,"_keywordTriggerMap");c(this,"_threshold");c(this,"_limit");c(this,"_debounce");c(this,"_caseSensitive");c(this,"_minMatchCharLength");c(this,"_debounceTimer",null);c(this,"_optionsSnapshot");this._optionsSnapshot=e;const t=y.validateOptions(e);this._collection=t.collection,this._threshold=t.threshold,this._limit=t.limit,this._debounce=t.debounce,this._caseSensitive=t.caseSensitive,this._minMatchCharLength=t.minMatchCharLength,this._fields=f.normalizeFieldConfig(e.fields,this._threshold),this._keywords=e.keywords?y.validateKeywords(e.keywords):null,this._keywordTriggerMap=this._buildKeywordTriggerMap()}_buildKeywordTriggerMap(){const e=new Map;if(!this._keywords)return e;for(const t of this._keywords.definitions){const i=Array.isArray(t.triggers)?t.triggers:[t.triggers];for(const r of i)e.set(r.toLowerCase(),t)}return e}get collection(){return this._collection}get options(){return this._optionsSnapshot}setCollection(e){this._collection=e instanceof Set?Array.from(e):e}query(e){const t=S.tokenize(e);if(t.length===0)return{results:[],matchedKeywords:[],tokens:[],warnings:[]};const{keywordTokens:i,searchTokens:r}=this._extractKeywords(t);let a=this._collection;const s=[];if(i.size>0){const o=this._applyKeywords(a,i);a=o.collection,s.push(...o.matchedKeywords)}if(r.length===0){const o=[];return{results:a.map(_=>{const{score:g,warnings:p}=f.scoreItem(_,[],this._fields,this._caseSensitive);return o.push(...p),{item:_,score:g}}),matchedKeywords:s,tokens:r,warnings:[...new Set(o)]}}const n=this._minMatchCharLength>1?r.filter(o=>o.length>=this._minMatchCharLength):r;if(n.length===0)return{results:[],matchedKeywords:s,tokens:r,warnings:[]};const h=[],l=[];for(const o of a){const{score:d,warnings:_}=f.scoreItem(o,n,this._fields,this._caseSensitive);h.push(..._),d>0&&l.push({item:o,score:d})}return l.sort((o,d)=>d.score-o.score),{results:this._limit<1/0?l.slice(0,this._limit):l,matchedKeywords:s,tokens:r,warnings:[...new Set(h)]}}queryAsync(e){return new Promise(t=>{this._debounce>0?(this._debounceTimer&&clearTimeout(this._debounceTimer),this._debounceTimer=setTimeout(()=>{t(this.query(e))},this._debounce)):t(this.query(e))})}_extractKeywords(e){const t=new Map,i=[];for(const r of e){const a=this._caseSensitive?r:r.toLowerCase(),s=this._keywordTriggerMap.get(a);if(s){const n=t.get(s.name)||[];n.push(r),t.set(s.name,n)}else i.push(r)}return{keywordTokens:t,searchTokens:i}}_applyKeywords(e,t){if(!this._keywords)return{collection:e,matchedKeywords:[]};let i=e;const r=[],a=new Map;for(const[s,n]of t)a.set(s,n);if(this._keywords.mode==="and")for(const s of this._keywords.definitions){const n=a.get(s.name);if(n){const h=s.handler;if(i=h(i,n),r.push({name:s.name,terms:n}),!Array.isArray(i))throw new m.SpotrError(`Keyword handler "${s.name}" must return an array`,m.ErrorCodes.INVALID_HANDLER_RETURN)}}else{const s=[],n=new Set;for(const h of this._keywords.definitions){const l=a.get(h.name);if(l){const w=h.handler,o=w(this._collection,l);if(r.push({name:h.name,terms:l}),!Array.isArray(o))throw new m.SpotrError(`Keyword handler "${h.name}" must return an array`,m.ErrorCodes.INVALID_HANDLER_RETURN);for(const d of o)n.has(d)||(n.add(d),s.push(d))}}i=s}return{collection:i,matchedKeywords:r}}}exports.Spotr=K;
+//# sourceMappingURL=Spotr.cjs.map

package/dist/Spotr.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Spotr.cjs","sources":["../src/Spotr.ts"],"sourcesContent":["import { SpotrError, ErrorCodes } from './errors';\nimport { normalizeFieldConfig, scoreItem } from './fuzzy';\nimport { tokenize, validateOptions, validateKeywords } from './utils';\nimport type {\n  SpotrOptions,\n  SpotrResult,\n  ScoredResult,\n  MatchedKeyword,\n  NormalizedFieldConfig,\n  NormalizedKeywordsConfig,\n  KeywordDefinition,\n} from './types';\n\nexport class Spotr<T extends object> {\n  private _collection: T[];\n  private _fields: NormalizedFieldConfig[];\n  private _keywords: NormalizedKeywordsConfig | null;\n  private _keywordTriggerMap: Map<string, KeywordDefinition<unknown>>;\n  private _threshold: number;\n  private _limit: number;\n  private _debounce: number;\n  private _caseSensitive: boolean;\n  private _minMatchCharLength: number;\n  private _debounceTimer: ReturnType<typeof setTimeout> | null = null;\n  private _optionsSnapshot: SpotrOptions<T>;\n\n  constructor(options: SpotrOptions<T>) {\n    this._optionsSnapshot = options;\n    const validated = validateOptions(options);\n    this._collection = validated.collection;\n    this._threshold = validated.threshold;\n    this._limit = validated.limit;\n    this._debounce = validated.debounce;\n    this._caseSensitive = validated.caseSensitive;\n    this._minMatchCharLength = validated.minMatchCharLength;\n\n    this._fields = normalizeFieldConfig(options.fields, this._threshold);\n\n    this._keywords = options.keywords ? validateKeywords(options.keywords) : null;\n    this._keywordTriggerMap = this._buildKeywordTriggerMap();\n  }\n\n  private _buildKeywordTriggerMap(): Map<string, KeywordDefinition<unknown>> {\n    const map = new Map<string, KeywordDefinition<unknown>>();\n    if (!this._keywords) return map;\n\n    for (const def of this._keywords.definitions) {\n      const triggers = Array.isArray(def.triggers) ? def.triggers : [def.triggers];\n      for (const trigger of triggers) {\n        map.set(trigger.toLowerCase(), def);\n      }\n    }\n    return map;\n  }\n\n  get collection(): T[] {\n    return this._collection;\n  }\n\n  get options(): SpotrOptions<T> {\n    return this._optionsSnapshot;\n  }\n\n  setCollection(collection: T[] | Set<T>): void {\n    this._collection = collection instanceof Set ? Array.from(collection) : collection;\n  }\n\n  query(search: string): SpotrResult<T> {\n    const tokens = tokenize(search);\n    \n    if (tokens.length === 0) {\n      return {\n        results: [],\n        matchedKeywords: [],\n        tokens: [],\n        warnings: [],\n      };\n    }\n\n    const { keywordTokens, searchTokens } = this._extractKeywords(tokens);\n\n    let filteredCollection = this._collection;\n    const matchedKeywords: MatchedKeyword[] = [];\n\n    if (keywordTokens.size > 0) {\n      const result = this._applyKeywords(filteredCollection, keywordTokens);\n      filteredCollection = result.collection;\n      matchedKeywords.push(...result.matchedKeywords);\n    }\n\n    if (searchTokens.length === 0) {\n      const allWarnings: string[] = [];\n      const results: ScoredResult<T>[] = filteredCollection.map((item) => {\n        const { score, warnings } = scoreItem(\n          item,\n          [],\n          this._fields,\n          this._caseSensitive\n        );\n        allWarnings.push(...warnings);\n        return { item, score };\n      });\n\n      return {\n        results,\n        matchedKeywords,\n        tokens: searchTokens,\n        warnings: [...new Set(allWarnings)],\n      };\n    }\n\n    const validTokens = this._minMatchCharLength > 1\n      ? searchTokens.filter((t) => t.length >= this._minMatchCharLength)\n      : searchTokens;\n\n    if (validTokens.length === 0) {\n      return {\n        results: [],\n        matchedKeywords,\n        tokens: searchTokens,\n        warnings: [],\n      };\n    }\n\n    const allWarnings: string[] = [];\n    const scoredResults: ScoredResult<T>[] = [];\n\n    for (const item of filteredCollection) {\n      const { score, warnings } = scoreItem(\n        item,\n        validTokens,\n        this._fields,\n        this._caseSensitive\n      );\n      allWarnings.push(...warnings);\n\n      if (score > 0) {\n        scoredResults.push({ item, score });\n      }\n    }\n\n    scoredResults.sort((a, b) => b.score - a.score);\n\n    const limitedResults = this._limit < Infinity\n      ? scoredResults.slice(0, this._limit)\n      : scoredResults;\n\n    return {\n      results: limitedResults,\n      matchedKeywords,\n      tokens: searchTokens,\n      warnings: [...new Set(allWarnings)],\n    };\n  }\n\n  queryAsync(search: string): Promise<SpotrResult<T>> {\n    return new Promise((resolve) => {\n      if (this._debounce > 0) {\n        if (this._debounceTimer) {\n          clearTimeout(this._debounceTimer);\n        }\n        this._debounceTimer = setTimeout(() => {\n          resolve(this.query(search));\n        }, this._debounce);\n      } else {\n        resolve(this.query(search));\n      }\n    });\n  }\n\n  private _extractKeywords(tokens: string[]): {\n    keywordTokens: Map<string, string[]>;\n    searchTokens: string[];\n  } {\n    const keywordTokens = new Map<string, string[]>();\n    const searchTokens: string[] = [];\n\n    for (const token of tokens) {\n      const normalizedToken = this._caseSensitive ? token : token.toLowerCase();\n      const keywordDef = this._keywordTriggerMap.get(normalizedToken);\n\n      if (keywordDef) {\n        const existing = keywordTokens.get(keywordDef.name) || [];\n        existing.push(token);\n        keywordTokens.set(keywordDef.name, existing);\n      } else {\n        searchTokens.push(token);\n      }\n    }\n\n    return { keywordTokens, searchTokens };\n  }\n\n  private _applyKeywords(\n    collection: T[],\n    keywordTokens: Map<string, string[]>\n  ): { collection: T[]; matchedKeywords: MatchedKeyword[] } {\n    if (!this._keywords) {\n      return { collection, matchedKeywords: [] };\n    }\n\n    let result = collection;\n    const matchedKeywords: MatchedKeyword[] = [];\n\n    const keywordNameToTerms = new Map<string, string[]>();\n    for (const [name, terms] of keywordTokens) {\n      keywordNameToTerms.set(name, terms);\n    }\n\n    if (this._keywords.mode === 'and') {\n      for (const def of this._keywords.definitions) {\n        const terms = keywordNameToTerms.get(def.name);\n        if (terms) {\n          const handler = def.handler as (collection: T[], matchedTerms: string[]) => T[];\n          result = handler(result, terms);\n          matchedKeywords.push({ name: def.name, terms });\n\n          if (!Array.isArray(result)) {\n            throw new SpotrError(\n              `Keyword handler \"${def.name}\" must return an array`,\n              ErrorCodes.INVALID_HANDLER_RETURN\n            );\n          }\n        }\n      }\n    } else {\n      const mergedResults: T[] = [];\n      const processedItems = new Set<T>();\n\n      for (const def of this._keywords.definitions) {\n        const terms = keywordNameToTerms.get(def.name);\n        if (terms) {\n          const handler = def.handler as (collection: T[], matchedTerms: string[]) => T[];\n          const keywordResults = handler(this._collection, terms);\n          matchedKeywords.push({ name: def.name, terms });\n\n          if (!Array.isArray(keywordResults)) {\n            throw new SpotrError(\n              `Keyword handler \"${def.name}\" must return an array`,\n              ErrorCodes.INVALID_HANDLER_RETURN\n            );\n          }\n\n          for (const item of keywordResults) {\n            if (!processedItems.has(item)) {\n              processedItems.add(item);\n              mergedResults.push(item);\n            }\n          }\n        }\n      }\n      result = mergedResults;\n    }\n\n    return { collection: result, matchedKeywords };\n  }\n}\n"],"names":["Spotr","options","__publicField","validated","validateOptions","normalizeFieldConfig","validateKeywords","map","def","triggers","trigger","collection","search","tokens","tokenize","keywordTokens","searchTokens","filteredCollection","matchedKeywords","result","allWarnings","item","score","warnings","scoreItem","validTokens","t","scoredResults","a","b","resolve","token","normalizedToken","keywordDef","existing","keywordNameToTerms","name","terms","handler","SpotrError","ErrorCodes","mergedResults","processedItems","keywordResults"],"mappings":"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"}

package/dist/Spotr.js

@@ -0,0 +1,163 @@
+var k = Object.defineProperty;
+var T = (m, e, t) => e in m ? k(m, e, { enumerable: !0, configurable: !0, writable: !0, value: t }) : m[e] = t;
+var a = (m, e, t) => T(m, typeof e != "symbol" ? e + "" : e, t);
+import { SpotrError as f, ErrorCodes as w } from "./errors.js";
+import { validateOptions as S, validateKeywords as K } from "./utils/validate.js";
+import { normalizeFieldConfig as M, scoreItem as y } from "./fuzzy/scorer.js";
+import { tokenize as A } from "./utils/tokenize.js";
+class I {
+  constructor(e) {
+    a(this, "_collection");
+    a(this, "_fields");
+    a(this, "_keywords");
+    a(this, "_keywordTriggerMap");
+    a(this, "_threshold");
+    a(this, "_limit");
+    a(this, "_debounce");
+    a(this, "_caseSensitive");
+    a(this, "_minMatchCharLength");
+    a(this, "_debounceTimer", null);
+    a(this, "_optionsSnapshot");
+    this._optionsSnapshot = e;
+    const t = S(e);
+    this._collection = t.collection, this._threshold = t.threshold, this._limit = t.limit, this._debounce = t.debounce, this._caseSensitive = t.caseSensitive, this._minMatchCharLength = t.minMatchCharLength, this._fields = M(e.fields, this._threshold), this._keywords = e.keywords ? K(e.keywords) : null, this._keywordTriggerMap = this._buildKeywordTriggerMap();
+  }
+  _buildKeywordTriggerMap() {
+    const e = /* @__PURE__ */ new Map();
+    if (!this._keywords) return e;
+    for (const t of this._keywords.definitions) {
+      const i = Array.isArray(t.triggers) ? t.triggers : [t.triggers];
+      for (const r of i)
+        e.set(r.toLowerCase(), t);
+    }
+    return e;
+  }
+  get collection() {
+    return this._collection;
+  }
+  get options() {
+    return this._optionsSnapshot;
+  }
+  setCollection(e) {
+    this._collection = e instanceof Set ? Array.from(e) : e;
+  }
+  query(e) {
+    const t = A(e);
+    if (t.length === 0)
+      return {
+        results: [],
+        matchedKeywords: [],
+        tokens: [],
+        warnings: []
+      };
+    const { keywordTokens: i, searchTokens: r } = this._extractKeywords(t);
+    let h = this._collection;
+    const s = [];
+    if (i.size > 0) {
+      const o = this._applyKeywords(h, i);
+      h = o.collection, s.push(...o.matchedKeywords);
+    }
+    if (r.length === 0) {
+      const o = [];
+      return {
+        results: h.map((u) => {
+          const { score: g, warnings: p } = y(
+            u,
+            [],
+            this._fields,
+            this._caseSensitive
+          );
+          return o.push(...p), { item: u, score: g };
+        }),
+        matchedKeywords: s,
+        tokens: r,
+        warnings: [...new Set(o)]
+      };
+    }
+    const n = this._minMatchCharLength > 1 ? r.filter((o) => o.length >= this._minMatchCharLength) : r;
+    if (n.length === 0)
+      return {
+        results: [],
+        matchedKeywords: s,
+        tokens: r,
+        warnings: []
+      };
+    const c = [], l = [];
+    for (const o of h) {
+      const { score: d, warnings: u } = y(
+        o,
+        n,
+        this._fields,
+        this._caseSensitive
+      );
+      c.push(...u), d > 0 && l.push({ item: o, score: d });
+    }
+    return l.sort((o, d) => d.score - o.score), {
+      results: this._limit < 1 / 0 ? l.slice(0, this._limit) : l,
+      matchedKeywords: s,
+      tokens: r,
+      warnings: [...new Set(c)]
+    };
+  }
+  queryAsync(e) {
+    return new Promise((t) => {
+      this._debounce > 0 ? (this._debounceTimer && clearTimeout(this._debounceTimer), this._debounceTimer = setTimeout(() => {
+        t(this.query(e));
+      }, this._debounce)) : t(this.query(e));
+    });
+  }
+  _extractKeywords(e) {
+    const t = /* @__PURE__ */ new Map(), i = [];
+    for (const r of e) {
+      const h = this._caseSensitive ? r : r.toLowerCase(), s = this._keywordTriggerMap.get(h);
+      if (s) {
+        const n = t.get(s.name) || [];
+        n.push(r), t.set(s.name, n);
+      } else
+        i.push(r);
+    }
+    return { keywordTokens: t, searchTokens: i };
+  }
+  _applyKeywords(e, t) {
+    if (!this._keywords)
+      return { collection: e, matchedKeywords: [] };
+    let i = e;
+    const r = [], h = /* @__PURE__ */ new Map();
+    for (const [s, n] of t)
+      h.set(s, n);
+    if (this._keywords.mode === "and")
+      for (const s of this._keywords.definitions) {
+        const n = h.get(s.name);
+        if (n) {
+          const c = s.handler;
+          if (i = c(i, n), r.push({ name: s.name, terms: n }), !Array.isArray(i))
+            throw new f(
+              `Keyword handler "${s.name}" must return an array`,
+              w.INVALID_HANDLER_RETURN
+            );
+        }
+      }
+    else {
+      const s = [], n = /* @__PURE__ */ new Set();
+      for (const c of this._keywords.definitions) {
+        const l = h.get(c.name);
+        if (l) {
+          const _ = c.handler, o = _(this._collection, l);
+          if (r.push({ name: c.name, terms: l }), !Array.isArray(o))
+            throw new f(
+              `Keyword handler "${c.name}" must return an array`,
+              w.INVALID_HANDLER_RETURN
+            );
+          for (const d of o)
+            n.has(d) || (n.add(d), s.push(d));
+        }
+      }
+      i = s;
+    }
+    return { collection: i, matchedKeywords: r };
+  }
+}
+export {
+  I as Spotr
+};
+//# sourceMappingURL=Spotr.js.map

package/dist/Spotr.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Spotr.js","sources":["../src/Spotr.ts"],"sourcesContent":["import { SpotrError, ErrorCodes } from './errors';\nimport { normalizeFieldConfig, scoreItem } from './fuzzy';\nimport { tokenize, validateOptions, validateKeywords } from './utils';\nimport type {\n  SpotrOptions,\n  SpotrResult,\n  ScoredResult,\n  MatchedKeyword,\n  NormalizedFieldConfig,\n  NormalizedKeywordsConfig,\n  KeywordDefinition,\n} from './types';\n\nexport class Spotr<T extends object> {\n  private _collection: T[];\n  private _fields: NormalizedFieldConfig[];\n  private _keywords: NormalizedKeywordsConfig | null;\n  private _keywordTriggerMap: Map<string, KeywordDefinition<unknown>>;\n  private _threshold: number;\n  private _limit: number;\n  private _debounce: number;\n  private _caseSensitive: boolean;\n  private _minMatchCharLength: number;\n  private _debounceTimer: ReturnType<typeof setTimeout> | null = null;\n  private _optionsSnapshot: SpotrOptions<T>;\n\n  constructor(options: SpotrOptions<T>) {\n    this._optionsSnapshot = options;\n    const validated = validateOptions(options);\n    this._collection = validated.collection;\n    this._threshold = validated.threshold;\n    this._limit = validated.limit;\n    this._debounce = validated.debounce;\n    this._caseSensitive = validated.caseSensitive;\n    this._minMatchCharLength = validated.minMatchCharLength;\n\n    this._fields = normalizeFieldConfig(options.fields, this._threshold);\n\n    this._keywords = options.keywords ? validateKeywords(options.keywords) : null;\n    this._keywordTriggerMap = this._buildKeywordTriggerMap();\n  }\n\n  private _buildKeywordTriggerMap(): Map<string, KeywordDefinition<unknown>> {\n    const map = new Map<string, KeywordDefinition<unknown>>();\n    if (!this._keywords) return map;\n\n    for (const def of this._keywords.definitions) {\n      const triggers = Array.isArray(def.triggers) ? def.triggers : [def.triggers];\n      for (const trigger of triggers) {\n        map.set(trigger.toLowerCase(), def);\n      }\n    }\n    return map;\n  }\n\n  get collection(): T[] {\n    return this._collection;\n  }\n\n  get options(): SpotrOptions<T> {\n    return this._optionsSnapshot;\n  }\n\n  setCollection(collection: T[] | Set<T>): void {\n    this._collection = collection instanceof Set ? Array.from(collection) : collection;\n  }\n\n  query(search: string): SpotrResult<T> {\n    const tokens = tokenize(search);\n    \n    if (tokens.length === 0) {\n      return {\n        results: [],\n        matchedKeywords: [],\n        tokens: [],\n        warnings: [],\n      };\n    }\n\n    const { keywordTokens, searchTokens } = this._extractKeywords(tokens);\n\n    let filteredCollection = this._collection;\n    const matchedKeywords: MatchedKeyword[] = [];\n\n    if (keywordTokens.size > 0) {\n      const result = this._applyKeywords(filteredCollection, keywordTokens);\n      filteredCollection = result.collection;\n      matchedKeywords.push(...result.matchedKeywords);\n    }\n\n    if (searchTokens.length === 0) {\n      const allWarnings: string[] = [];\n      const results: ScoredResult<T>[] = filteredCollection.map((item) => {\n        const { score, warnings } = scoreItem(\n          item,\n          [],\n          this._fields,\n          this._caseSensitive\n        );\n        allWarnings.push(...warnings);\n        return { item, score };\n      });\n\n      return {\n        results,\n        matchedKeywords,\n        tokens: searchTokens,\n        warnings: [...new Set(allWarnings)],\n      };\n    }\n\n    const validTokens = this._minMatchCharLength > 1\n      ? searchTokens.filter((t) => t.length >= this._minMatchCharLength)\n      : searchTokens;\n\n    if (validTokens.length === 0) {\n      return {\n        results: [],\n        matchedKeywords,\n        tokens: searchTokens,\n        warnings: [],\n      };\n    }\n\n    const allWarnings: string[] = [];\n    const scoredResults: ScoredResult<T>[] = [];\n\n    for (const item of filteredCollection) {\n      const { score, warnings } = scoreItem(\n        item,\n        validTokens,\n        this._fields,\n        this._caseSensitive\n      );\n      allWarnings.push(...warnings);\n\n      if (score > 0) {\n        scoredResults.push({ item, score });\n      }\n    }\n\n    scoredResults.sort((a, b) => b.score - a.score);\n\n    const limitedResults = this._limit < Infinity\n      ? scoredResults.slice(0, this._limit)\n      : scoredResults;\n\n    return {\n      results: limitedResults,\n      matchedKeywords,\n      tokens: searchTokens,\n      warnings: [...new Set(allWarnings)],\n    };\n  }\n\n  queryAsync(search: string): Promise<SpotrResult<T>> {\n    return new Promise((resolve) => {\n      if (this._debounce > 0) {\n        if (this._debounceTimer) {\n          clearTimeout(this._debounceTimer);\n        }\n        this._debounceTimer = setTimeout(() => {\n          resolve(this.query(search));\n        }, this._debounce);\n      } else {\n        resolve(this.query(search));\n      }\n    });\n  }\n\n  private _extractKeywords(tokens: string[]): {\n    keywordTokens: Map<string, string[]>;\n    searchTokens: string[];\n  } {\n    const keywordTokens = new Map<string, string[]>();\n    const searchTokens: string[] = [];\n\n    for (const token of tokens) {\n      const normalizedToken = this._caseSensitive ? token : token.toLowerCase();\n      const keywordDef = this._keywordTriggerMap.get(normalizedToken);\n\n      if (keywordDef) {\n        const existing = keywordTokens.get(keywordDef.name) || [];\n        existing.push(token);\n        keywordTokens.set(keywordDef.name, existing);\n      } else {\n        searchTokens.push(token);\n      }\n    }\n\n    return { keywordTokens, searchTokens };\n  }\n\n  private _applyKeywords(\n    collection: T[],\n    keywordTokens: Map<string, string[]>\n  ): { collection: T[]; matchedKeywords: MatchedKeyword[] } {\n    if (!this._keywords) {\n      return { collection, matchedKeywords: [] };\n    }\n\n    let result = collection;\n    const matchedKeywords: MatchedKeyword[] = [];\n\n    const keywordNameToTerms = new Map<string, string[]>();\n    for (const [name, terms] of keywordTokens) {\n      keywordNameToTerms.set(name, terms);\n    }\n\n    if (this._keywords.mode === 'and') {\n      for (const def of this._keywords.definitions) {\n        const terms = keywordNameToTerms.get(def.name);\n        if (terms) {\n          const handler = def.handler as (collection: T[], matchedTerms: string[]) => T[];\n          result = handler(result, terms);\n          matchedKeywords.push({ name: def.name, terms });\n\n          if (!Array.isArray(result)) {\n            throw new SpotrError(\n              `Keyword handler \"${def.name}\" must return an array`,\n              ErrorCodes.INVALID_HANDLER_RETURN\n            );\n          }\n        }\n      }\n    } else {\n      const mergedResults: T[] = [];\n      const processedItems = new Set<T>();\n\n      for (const def of this._keywords.definitions) {\n        const terms = keywordNameToTerms.get(def.name);\n        if (terms) {\n          const handler = def.handler as (collection: T[], matchedTerms: string[]) => T[];\n          const keywordResults = handler(this._collection, terms);\n          matchedKeywords.push({ name: def.name, terms });\n\n          if (!Array.isArray(keywordResults)) {\n            throw new SpotrError(\n              `Keyword handler \"${def.name}\" must return an array`,\n              ErrorCodes.INVALID_HANDLER_RETURN\n            );\n          }\n\n          for (const item of keywordResults) {\n            if (!processedItems.has(item)) {\n              processedItems.add(item);\n              mergedResults.push(item);\n            }\n          }\n        }\n      }\n      result = mergedResults;\n    }\n\n    return { collection: result, matchedKeywords };\n  }\n}\n"],"names":["Spotr","options","__publicField","validated","validateOptions","normalizeFieldConfig","validateKeywords","map","def","triggers","trigger","collection","search","tokens","tokenize","keywordTokens","searchTokens","filteredCollection","matchedKeywords","result","allWarnings","item","score","warnings","scoreItem","validTokens","t","scoredResults","a","b","resolve","token","normalizedToken","keywordDef","existing","keywordNameToTerms","name","terms","handler","SpotrError","ErrorCodes","mergedResults","processedItems","keywordResults"],"mappings":"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"}

package/dist/errors.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});class E extends Error{constructor(I,r){super(I),this.code=r,this.name="SpotrError"}}const L={INVALID_COLLECTION:"INVALID_COLLECTION",INVALID_FIELD_CONFIG:"INVALID_FIELD_CONFIG",INVALID_FIELD_WEIGHT:"INVALID_FIELD_WEIGHT",INVALID_KEYWORD:"INVALID_KEYWORD",INVALID_HANDLER_RETURN:"INVALID_HANDLER_RETURN"};exports.ErrorCodes=L;exports.SpotrError=E;
+//# sourceMappingURL=errors.cjs.map

package/dist/errors.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.cjs","sources":["../src/errors.ts"],"sourcesContent":["export class SpotrError extends Error {\n  constructor(\n    message: string,\n    public code: string\n  ) {\n    super(message);\n    this.name = 'SpotrError';\n  }\n}\n\nexport const ErrorCodes = {\n  INVALID_COLLECTION: 'INVALID_COLLECTION',\n  INVALID_FIELD_CONFIG: 'INVALID_FIELD_CONFIG',\n  INVALID_FIELD_WEIGHT: 'INVALID_FIELD_WEIGHT',\n  INVALID_KEYWORD: 'INVALID_KEYWORD',\n  INVALID_HANDLER_RETURN: 'INVALID_HANDLER_RETURN',\n} as const;\n\nexport type ErrorCode = (typeof ErrorCodes)[keyof typeof ErrorCodes];\n"],"names":["SpotrError","message","code","ErrorCodes"],"mappings":"gFAAO,MAAMA,UAAmB,KAAM,CACpC,YACEC,EACOC,EACP,CACA,MAAMD,CAAO,EAFN,KAAA,KAAAC,EAGP,KAAK,KAAO,YACd,CACF,CAEO,MAAMC,EAAa,CACxB,mBAAoB,qBACpB,qBAAsB,uBACtB,qBAAsB,uBACtB,gBAAiB,kBACjB,uBAAwB,wBAC1B"}

package/dist/errors.js

@@ -0,0 +1,17 @@
+class D extends Error {
+  constructor(I, L) {
+    super(I), this.code = L, this.name = "SpotrError";
+  }
+}
+const E = {
+  INVALID_COLLECTION: "INVALID_COLLECTION",
+  INVALID_FIELD_CONFIG: "INVALID_FIELD_CONFIG",
+  INVALID_FIELD_WEIGHT: "INVALID_FIELD_WEIGHT",
+  INVALID_KEYWORD: "INVALID_KEYWORD",
+  INVALID_HANDLER_RETURN: "INVALID_HANDLER_RETURN"
+};
+export {
+  E as ErrorCodes,
+  D as SpotrError
+};
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sources":["../src/errors.ts"],"sourcesContent":["export class SpotrError extends Error {\n  constructor(\n    message: string,\n    public code: string\n  ) {\n    super(message);\n    this.name = 'SpotrError';\n  }\n}\n\nexport const ErrorCodes = {\n  INVALID_COLLECTION: 'INVALID_COLLECTION',\n  INVALID_FIELD_CONFIG: 'INVALID_FIELD_CONFIG',\n  INVALID_FIELD_WEIGHT: 'INVALID_FIELD_WEIGHT',\n  INVALID_KEYWORD: 'INVALID_KEYWORD',\n  INVALID_HANDLER_RETURN: 'INVALID_HANDLER_RETURN',\n} as const;\n\nexport type ErrorCode = (typeof ErrorCodes)[keyof typeof ErrorCodes];\n"],"names":["SpotrError","message","code","ErrorCodes"],"mappings":"AAAO,MAAMA,UAAmB,MAAM;AAAA,EACpC,YACEC,GACOC,GACP;AACA,UAAMD,CAAO,GAFN,KAAA,OAAAC,GAGP,KAAK,OAAO;AAAA,EACd;AACF;AAEO,MAAMC,IAAa;AAAA,EACxB,oBAAoB;AAAA,EACpB,sBAAsB;AAAA,EACtB,sBAAsB;AAAA,EACtB,iBAAiB;AAAA,EACjB,wBAAwB;AAC1B;"}

package/dist/fuzzy/levenshtein.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function h(l,r){const n=[];for(let t=0;t<=r.length;t++)n[t]=[t];for(let t=0;t<=l.length;t++)n[0][t]=t;for(let t=1;t<=r.length;t++)for(let e=1;e<=l.length;e++)r.charAt(t-1)===l.charAt(e-1)?n[t][e]=n[t-1][e-1]:n[t][e]=Math.min(n[t-1][e-1]+1,n[t][e-1]+1,n[t-1][e]+1);return n[r.length][l.length]}function f(l,r,n=.3,t=!1){const e=t?l:l.toLowerCase(),o=t?r:r.toLowerCase();if(e===o)return 1;if(e.length===0||o.length===0)return 0;if(o.includes(e))return .9+.1*e.length/o.length;const i=h(e,o),s=Math.max(e.length,o.length),c=1-i/s;return c>=n?c:0}exports.fuzzyScore=f;exports.levenshteinDistance=h;
+//# sourceMappingURL=levenshtein.cjs.map

package/dist/fuzzy/levenshtein.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"levenshtein.cjs","sources":["../../src/fuzzy/levenshtein.ts"],"sourcesContent":["export function levenshteinDistance(a: string, b: string): number {\n  const matrix: number[][] = [];\n\n  for (let i = 0; i <= b.length; i++) {\n    matrix[i] = [i];\n  }\n  for (let j = 0; j <= a.length; j++) {\n    matrix[0][j] = j;\n  }\n\n  for (let i = 1; i <= b.length; i++) {\n    for (let j = 1; j <= a.length; j++) {\n      if (b.charAt(i - 1) === a.charAt(j - 1)) {\n        matrix[i][j] = matrix[i - 1][j - 1];\n      } else {\n        matrix[i][j] = Math.min(\n          matrix[i - 1][j - 1] + 1,\n          matrix[i][j - 1] + 1,\n          matrix[i - 1][j] + 1\n        );\n      }\n    }\n  }\n\n  return matrix[b.length][a.length];\n}\n\nexport function fuzzyScore(\n  query: string,\n  target: string,\n  threshold: number = 0.3,\n  caseSensitive: boolean = false\n): number {\n  const q = caseSensitive ? query : query.toLowerCase();\n  const t = caseSensitive ? target : target.toLowerCase();\n\n  if (q === t) return 1;\n  if (q.length === 0 || t.length === 0) return 0;\n\n  if (t.includes(q)) {\n    return 0.9 + (0.1 * q.length / t.length);\n  }\n\n  const distance = levenshteinDistance(q, t);\n  const maxLen = Math.max(q.length, t.length);\n  const score = 1 - (distance / maxLen);\n\n  return score >= threshold ? score : 0;\n}\n"],"names":["levenshteinDistance","a","b","matrix","i","j","fuzzyScore","query","target","threshold","caseSensitive","q","t","distance","maxLen","score"],"mappings":"gFAAO,SAASA,EAAoBC,EAAWC,EAAmB,CAChE,MAAMC,EAAqB,CAAA,EAE3B,QAASC,EAAI,EAAGA,GAAKF,EAAE,OAAQE,IAC7BD,EAAOC,CAAC,EAAI,CAACA,CAAC,EAEhB,QAASC,EAAI,EAAGA,GAAKJ,EAAE,OAAQI,IAC7BF,EAAO,CAAC,EAAEE,CAAC,EAAIA,EAGjB,QAASD,EAAI,EAAGA,GAAKF,EAAE,OAAQE,IAC7B,QAASC,EAAI,EAAGA,GAAKJ,EAAE,OAAQI,IACzBH,EAAE,OAAOE,EAAI,CAAC,IAAMH,EAAE,OAAOI,EAAI,CAAC,EACpCF,EAAOC,CAAC,EAAEC,CAAC,EAAIF,EAAOC,EAAI,CAAC,EAAEC,EAAI,CAAC,EAElCF,EAAOC,CAAC,EAAEC,CAAC,EAAI,KAAK,IAClBF,EAAOC,EAAI,CAAC,EAAEC,EAAI,CAAC,EAAI,EACvBF,EAAOC,CAAC,EAAEC,EAAI,CAAC,EAAI,EACnBF,EAAOC,EAAI,CAAC,EAAEC,CAAC,EAAI,CAAA,EAM3B,OAAOF,EAAOD,EAAE,MAAM,EAAED,EAAE,MAAM,CAClC,CAEO,SAASK,EACdC,EACAC,EACAC,EAAoB,GACpBC,EAAyB,GACjB,CACR,MAAMC,EAAID,EAAgBH,EAAQA,EAAM,YAAA,EAClCK,EAAIF,EAAgBF,EAASA,EAAO,YAAA,EAE1C,GAAIG,IAAMC,EAAG,MAAO,GACpB,GAAID,EAAE,SAAW,GAAKC,EAAE,SAAW,EAAG,MAAO,GAE7C,GAAIA,EAAE,SAASD,CAAC,EACd,MAAO,IAAO,GAAMA,EAAE,OAASC,EAAE,OAGnC,MAAMC,EAAWb,EAAoBW,EAAGC,CAAC,EACnCE,EAAS,KAAK,IAAIH,EAAE,OAAQC,EAAE,MAAM,EACpCG,EAAQ,EAAKF,EAAWC,EAE9B,OAAOC,GAASN,EAAYM,EAAQ,CACtC"}

package/dist/fuzzy/levenshtein.js

@@ -0,0 +1,29 @@
+function f(l, r) {
+  const n = [];
+  for (let t = 0; t <= r.length; t++)
+    n[t] = [t];
+  for (let t = 0; t <= l.length; t++)
+    n[0][t] = t;
+  for (let t = 1; t <= r.length; t++)
+    for (let e = 1; e <= l.length; e++)
+      r.charAt(t - 1) === l.charAt(e - 1) ? n[t][e] = n[t - 1][e - 1] : n[t][e] = Math.min(
+        n[t - 1][e - 1] + 1,
+        n[t][e - 1] + 1,
+        n[t - 1][e] + 1
+      );
+  return n[r.length][l.length];
+}
+function i(l, r, n = 0.3, t = !1) {
+  const e = t ? l : l.toLowerCase(), o = t ? r : r.toLowerCase();
+  if (e === o) return 1;
+  if (e.length === 0 || o.length === 0) return 0;
+  if (o.includes(e))
+    return 0.9 + 0.1 * e.length / o.length;
+  const c = f(e, o), s = Math.max(e.length, o.length), h = 1 - c / s;
+  return h >= n ? h : 0;
+}
+export {
+  i as fuzzyScore,
+  f as levenshteinDistance
+};
+//# sourceMappingURL=levenshtein.js.map

package/dist/fuzzy/levenshtein.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"levenshtein.js","sources":["../../src/fuzzy/levenshtein.ts"],"sourcesContent":["export function levenshteinDistance(a: string, b: string): number {\n  const matrix: number[][] = [];\n\n  for (let i = 0; i <= b.length; i++) {\n    matrix[i] = [i];\n  }\n  for (let j = 0; j <= a.length; j++) {\n    matrix[0][j] = j;\n  }\n\n  for (let i = 1; i <= b.length; i++) {\n    for (let j = 1; j <= a.length; j++) {\n      if (b.charAt(i - 1) === a.charAt(j - 1)) {\n        matrix[i][j] = matrix[i - 1][j - 1];\n      } else {\n        matrix[i][j] = Math.min(\n          matrix[i - 1][j - 1] + 1,\n          matrix[i][j - 1] + 1,\n          matrix[i - 1][j] + 1\n        );\n      }\n    }\n  }\n\n  return matrix[b.length][a.length];\n}\n\nexport function fuzzyScore(\n  query: string,\n  target: string,\n  threshold: number = 0.3,\n  caseSensitive: boolean = false\n): number {\n  const q = caseSensitive ? query : query.toLowerCase();\n  const t = caseSensitive ? target : target.toLowerCase();\n\n  if (q === t) return 1;\n  if (q.length === 0 || t.length === 0) return 0;\n\n  if (t.includes(q)) {\n    return 0.9 + (0.1 * q.length / t.length);\n  }\n\n  const distance = levenshteinDistance(q, t);\n  const maxLen = Math.max(q.length, t.length);\n  const score = 1 - (distance / maxLen);\n\n  return score >= threshold ? score : 0;\n}\n"],"names":["levenshteinDistance","a","b","matrix","i","j","fuzzyScore","query","target","threshold","caseSensitive","q","t","distance","maxLen","score"],"mappings":"AAAO,SAASA,EAAoBC,GAAWC,GAAmB;AAChE,QAAMC,IAAqB,CAAA;AAE3B,WAASC,IAAI,GAAGA,KAAKF,EAAE,QAAQE;AAC7B,IAAAD,EAAOC,CAAC,IAAI,CAACA,CAAC;AAEhB,WAASC,IAAI,GAAGA,KAAKJ,EAAE,QAAQI;AAC7B,IAAAF,EAAO,CAAC,EAAEE,CAAC,IAAIA;AAGjB,WAASD,IAAI,GAAGA,KAAKF,EAAE,QAAQE;AAC7B,aAASC,IAAI,GAAGA,KAAKJ,EAAE,QAAQI;AAC7B,MAAIH,EAAE,OAAOE,IAAI,CAAC,MAAMH,EAAE,OAAOI,IAAI,CAAC,IACpCF,EAAOC,CAAC,EAAEC,CAAC,IAAIF,EAAOC,IAAI,CAAC,EAAEC,IAAI,CAAC,IAElCF,EAAOC,CAAC,EAAEC,CAAC,IAAI,KAAK;AAAA,QAClBF,EAAOC,IAAI,CAAC,EAAEC,IAAI,CAAC,IAAI;AAAA,QACvBF,EAAOC,CAAC,EAAEC,IAAI,CAAC,IAAI;AAAA,QACnBF,EAAOC,IAAI,CAAC,EAAEC,CAAC,IAAI;AAAA,MAAA;AAM3B,SAAOF,EAAOD,EAAE,MAAM,EAAED,EAAE,MAAM;AAClC;AAEO,SAASK,EACdC,GACAC,GACAC,IAAoB,KACpBC,IAAyB,IACjB;AACR,QAAMC,IAAID,IAAgBH,IAAQA,EAAM,YAAA,GAClCK,IAAIF,IAAgBF,IAASA,EAAO,YAAA;AAE1C,MAAIG,MAAMC,EAAG,QAAO;AACpB,MAAID,EAAE,WAAW,KAAKC,EAAE,WAAW,EAAG,QAAO;AAE7C,MAAIA,EAAE,SAASD,CAAC;AACd,WAAO,MAAO,MAAMA,EAAE,SAASC,EAAE;AAGnC,QAAMC,IAAWb,EAAoBW,GAAGC,CAAC,GACnCE,IAAS,KAAK,IAAIH,EAAE,QAAQC,EAAE,MAAM,GACpCG,IAAQ,IAAKF,IAAWC;AAE9B,SAAOC,KAASN,IAAYM,IAAQ;AACtC;"}