cry-search 2.0.3 → 2.1.0

package/CLAUDE.md

@@ -337,7 +337,12 @@ Override match behavior per token at search time. Priority: query prefix > field
     1. prepareStringForSearch pipeline minus the trailing .sort()
     2. required for any positional / order-aware scoring
     3. do NOT use these tokens for candidate retrieval (sorted lists required)
-16. Scoring primitives (in src/common/numeric/scoring.ts, re-exported from main)
+16. compareTokenized(a: string, b: string): number
+    1. tokenizes both strings with prepareStringForSearch (same pipeline)
+    2. returns Jaccard similarity of the token sets: |A∩B| / |A∪B| ∈ [0, 1]
+    3. order-independent, case/diacritics-insensitive, dedupes repeated tokens
+    4. both empty → 1; empty vs non-empty → 0
+17. Scoring primitives (in src/common/numeric/scoring.ts, re-exported from main)
     1. scoreOne(query, qTokens, itemTokens, exactKeys?): number
        - feature-rich scoring: +100_000 exact, +50 base, +100 all-matched, +50 first-word,
          +80 perfect prefix, +30*(matched/span) density, -0.1*Σitemtoken.length penalty
@@ -392,7 +397,8 @@ src/
 │   ├── normalizeDates.ts
 │   ├── preprocessString.ts
 │   ├── sanitiseString.ts
-│   └── tokenize.ts
+│   ├── tokenize.ts
+│   └── compareTokenized.ts          # Jaccard token-set similarity (0..1)
 ├── types/
 │   └── index.ts
 └── index.ts                           # Public API

package/README.md

@@ -12,6 +12,7 @@ A fast, memory-efficient search library for large datasets with support for toke
 - **Search prefixes** - use `-word`, `--word`, or `~word` to exclude, `..word` for suffix, `=word` for exact match
 - **Automatic normalization** - Handles diacritics, case, dates, and number formatting
 - **Ranked search** - `searchAndRank` returns results scored by positional relevance (token order, contiguity, perfect-prefix, length)
+- **String similarity** - `compareTokenized(a, b)` returns Jaccard token-set similarity (`0..1`) for fuzzy name/label matching
 - **[Universal search](./UNIVERSE.md)** - Search and update across linked collections (e.g., customers with their pets)
 
 ## Table of Contents
@@ -26,6 +27,7 @@ A fast, memory-efficient search library for large datasets with support for toke
     - [Updating Existing Data](#updating-existing-data)
     - [Augmented Metadata - Local Search Context](#augmented-metadata---local-search-context)
     - [Ranked Search with Positional Scoring](#ranked-search-with-positional-scoring)
+    - [String Similarity](#string-similarity)
   - [Architecture](#architecture)
     - [Text Processing Pipeline](#text-processing-pipeline)
     - [Metadata Building](#metadata-building)
@@ -86,6 +88,17 @@ const results3 = searchInDataReturnObjects('IPHONE', metadata, data);
 // Returns: Map with product 1
 ```
 
+### String Similarity
+
+```typescript
+import { compareTokenized } from 'cry-search';
+
+// Jaccard similarity of the token sets (0 = no overlap, 1 = identical).
+compareTokenized('Janez Novak', 'novak janez'); // 1    (order-independent)
+compareTokenized('Janes Novak', 'novak');       // 0.5  (one of two tokens shared)
+compareTokenized('Janez Novak', 'ana');         // 0    (no shared tokens)
+```
+
 ### SearchUniverse with Linked Collections
 
 For related data (like customers and their pets), use `SearchUniverse` to search across collections:
@@ -518,3 +531,43 @@ See [CLAUDE.md](./CLAUDE.md) for the complete technical specification including:
 ## License
 
 See [LICENSE.md](./LICENSE.md) for license terms.
+
+## Domain extensions and the `cry-search/vet` entry point
+
+The core exposes a narrow seam for domain logic (all optional, no behaviour change when unused):
+
+- `SearchableObjectSpec.valueNormalizers` — index-time normalizers for field values, able to
+  return `{ text, classes }`; the classes land in `metadata.classes` (accessible via
+  `itemClasses(metadata, id)`) and **never take part in retrieval** — they are soft.
+- `SearchOpts.queryNormalizers` + `normalizeQueryWithOpts(query, opts)` — the same mapping on
+  the query side, with the query classes returned to the caller.
+- `matchMany(prepared, queries, opts)` — mass matching: an index of one collection, the other
+  collection as queries; asynchronous iterator (chunked), top-K candidates per item with scores,
+  optional `samoEnolicno` (greedy 1:1), optional domain `rank`/`accept`, and
+  `alternativnePoizvedbe` (retry with a narrowed query).
+
+A ready-made veterinary implementation ships as a subpath (optional peer dependency on
+`cry-vetzdravila`):
+
+```bash
+bun add cry-search cry-vetzdravila
+```
+
+```typescript
+import { pripraviVetIndeks, upariArtikle, vetArtikelSpec, vetQueryOpts, oceniPar } from 'cry-search/vet';
+
+const indeks = pripraviVetIndeks(pantheonArtikli);   // { data, metadata }
+for await (const kos of upariArtikle(indeks, klikvetArtikli, { limit: 3 })) {
+  for (const par of kos) {
+    const k = par.kandidati[0];
+    if (k?.sprejeto) console.log(par.id, '->', k.item.naziv, k.ocena.razlog);
+  }
+}
+```
+
+It normalizes units (`tbl`/`tableta`), ranges (`15kg-30kg`, `15 - 30 kg`), decimal commas,
+brand abbreviations (`RC` → `Royal Canin`) and brand lines (`SHN` → `Royal Canin SHN`), lemmatizes
+animal species (`race`/`raca` → `raca`) with dogs/cats as a class, removes Pantheon type markers,
+suppliers and professional markers, and accepts a pair only when both names cover each other
+(whole-word coverage) — see `VET.md` for the measured quality (99.9 % on identical names,
+~68 % on similar names) and the generation of the bundled brand table (`bun run gen:vet-data`).

package/UNIVERSE.md

@@ -875,3 +875,15 @@ priority over the ordinary segmented query. If no phone variant finds a result,
 SearchUniverse falls back to its usual raw-token search. Caller-supplied
 `phoneQueryNormalizers` are additional variants; they do not replace the
 collection-derived normalizers.
+
+## String similarity (compareTokenized)
+
+`compareTokenized(a, b)` compares two strings through the same
+`prepareStringForSearch` pipeline and returns the Jaccard similarity of their
+token sets (`|A∩B| / |A∪B|`, `0..1`). Order-independent and
+case/diacritics-insensitive. Useful for fuzzy name/label matching.
+
+```text
+compareTokenized('Janez Novak', 'novak janez') // 1
+compareTokenized('Janes Novak', 'novak')       // 0.5
+```

package/dist/common/numeric/createSearchArrayMetadata.d.ts

@@ -59,7 +59,17 @@ export declare function decodeMatchMode(encoded: number): MatchMode;
 export interface PreparedObjectTokens {
     sorted: NumericTokenSortedList;
     firstN: NumericTokenUnsortedList | undefined;
+    /**
+     * Domain classes produced by `spec.valueNormalizers` (e.g. `{ razpon: ['15-30'] }`).
+     * `undefined` when no normalizer produced classes.
+     */
+    classes?: Record<string, string[]>;
 }
+/**
+ * Domain classes of one item, always normalised to lists.
+ * `undefined` when the item has none.
+ */
+export declare function itemClasses(metadata: NumericSearchMetadata, id: string): Record<string, string[]> | undefined;
 /**
  * Prepares an object for search, returning numeric token IDs for both retrieval and ranking.
  *

package/dist/common/numeric/createSearchArrayMetadata.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createSearchArrayMetadata.d.ts","sourceRoot":"","sources":["../../../src/common/numeric/createSearchArrayMetadata.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,SAAS,EACT,qBAAqB,EACrB,sBAAsB,EACtB,wBAAwB,EACxB,gBAAgB,EAChB,cAAc,EACd,oBAAoB,EACrB,MAAM,aAAa,CAAC;AAUrB;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAEjE;AAED;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAMzD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAS1D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAMrD,CAAC;AAKF,mDAAmD;AACnD,eAAO,MAAM,aAAa,QAAwB,CAAC;AAEnD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,MAAM,CAE5E;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAErD;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAS1D;AAoED;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,sBAAsB,CAAC;IAC/B,MAAM,EAAE,wBAAwB,GAAG,SAAS,CAAC;CAC9C;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,6BAA6B,CAAC,CAAC,SAAS,gBAAgB,EAAE,CAAC,GAAG,OAAO,EACnF,GAAG,EAAE,CAAC,EACN,IAAI,EAAE,oBAAoB,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,SAAS,EAC5C,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAC7B,oBAAoB,GAAG,SAAS,CA0BlC;AAgID;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,gCAAgC,CAAC,CAAC,SAAS,gBAAgB,EAAE,CAAC,GAAG,OAAO,EACtF,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC,EACvB,IAAI,CAAC,EAAE,oBAAoB,CAAC,CAAC,EAAE,CAAC,CAAC,GAChC,qBAAqB,CAoBvB;AAED,yDAAyD;AACzD,wBAAgB,0BAA0B,IAAI,qBAAqB,CAElE"}
+{"version":3,"file":"createSearchArrayMetadata.d.ts","sourceRoot":"","sources":["../../../src/common/numeric/createSearchArrayMetadata.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,SAAS,EAET,qBAAqB,EACrB,sBAAsB,EACtB,wBAAwB,EACxB,gBAAgB,EAChB,cAAc,EACd,oBAAoB,EAErB,MAAM,aAAa,CAAC;AAUrB;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAEjE;AAED;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAMzD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAS1D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAMrD,CAAC;AAKF,mDAAmD;AACnD,eAAO,MAAM,aAAa,QAAwB,CAAC;AAEnD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,MAAM,CAE5E;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAErD;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAS1D;AAoED;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,sBAAsB,CAAC;IAC/B,MAAM,EAAE,wBAAwB,GAAG,SAAS,CAAC;IAC7C;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CACpC;AA4CD;;;GAGG;AACH,wBAAgB,WAAW,CACzB,QAAQ,EAAE,qBAAqB,EAC/B,EAAE,EAAE,MAAM,GACT,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,SAAS,CAGtC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,6BAA6B,CAAC,CAAC,SAAS,gBAAgB,EAAE,CAAC,GAAG,OAAO,EACnF,GAAG,EAAE,CAAC,EACN,IAAI,EAAE,oBAAoB,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,SAAS,EAC5C,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAC7B,oBAAoB,GAAG,SAAS,CA4BlC;AAqJD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,gCAAgC,CAAC,CAAC,SAAS,gBAAgB,EAAE,CAAC,GAAG,OAAO,EACtF,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC,EACvB,IAAI,CAAC,EAAE,oBAAoB,CAAC,CAAC,EAAE,CAAC,CAAC,GAChC,qBAAqB,CAuBvB;AAED,yDAAyD;AACzD,wBAAgB,0BAA0B,IAAI,qBAAqB,CAElE"}

package/dist/common/numeric/matchMany.d.ts

@@ -0,0 +1,111 @@
+import type { Id, NormalizedValue, NumericSearchMetadata, SearchableData, SearchableObject, SearchOpts } from '../../types';
+/**
+ * Kandidat pri masovnem uparjanju: zapis desne strani z oceno in domenskimi razredi.
+ */
+export interface MatchManyKandidat<T extends SearchableObject> {
+    id: Id;
+    item: T;
+    /** Ocena jedra (`scoreOne`) ali domenska ocena, če je podana `rank`. */
+    score: number;
+    /** Domenski razredi kandidata (`metadata.classes`), če jih ima. */
+    classes?: Record<string, string[]>;
+}
+/** Rezultat za en element leve strani. */
+export interface MatchManyRezultat<T extends SearchableObject> {
+    /** ID elementa leve strani (kot ga vrne `idOf`). */
+    id: string;
+    /** Razredi poizvedbe, če jih je vrnil `queryOf`. */
+    queryClasses?: Record<string, string[]>;
+    /** Kandidati, urejeni padajoče po oceni (največ `limit`). */
+    kandidati: MatchManyKandidat<T>[];
+}
+/** Nastavitve masovnega uparjanja. */
+export interface MatchManyOptions<T extends SearchableObject, TQuery> {
+    /**
+     * Besedilo poizvedbe za en element leve strani; lahko vrne tudi razrede
+     * (`{ text, classes }`), ki jih dobi domenski ocenjevalec.
+     */
+    queryOf: (query: TQuery) => string | NormalizedValue;
+    /** ID elementa leve strani (privzeto `_id`, nato `id`, nazadnje zaporedna številka). */
+    idOf?: (query: TQuery, indeks: number) => string;
+    /** Največ kandidatov na element (privzeto 3). */
+    limit?: number;
+    /**
+     * Koliko kandidatov preberemo iz jedra, PREDEN jih oceni domenski `rank`/`accept`.
+     * Privzeto `max(20, limit * 4)`: domenski ocenjevalec pogosto prerazporedi
+     * kandidate, zato mora videti širši nabor od končnega `limit`.
+     */
+    retrievalLimit?: number;
+    /** Spodnji prag ocene (privzeto 0). */
+    minScore?: number;
+    /** Koliko elementov na kos izhodnega iteratorja (privzeto 50). */
+    kos?: number;
+    /**
+     * Poželjiva 1:1 dodelitev: vsak kandidat (element desne strani) se porabi
+     * največ enkrat. Uporabno za množične uvoze; iterator je treba porabljati
+     * po vrsti, ker se odločitve sprejemajo sproti.
+     */
+    samoEnolicno?: boolean;
+    /** Vrstni red po elementih leve strani (privzeto podan vrstni red). */
+    primaryTextOf?: (item: T) => string | undefined;
+    /** Natančni ključi kandidata (npr. črtna koda) za `+100000` bonus. */
+    exactKeysOf?: (item: T) => readonly string[] | undefined;
+    /** Domenska ocena: če podana, zamenja jedrno oceno. */
+    rank?: (kandidat: {
+        id: Id;
+        item: T;
+        classes?: Record<string, string[]>;
+    }, poizvedba: {
+        text: string;
+        classes?: Record<string, string[]>;
+    }) => number;
+    /** Domenski sprejem: če podana, se nesprejeti kandidati izločijo. */
+    accept?: (kandidat: {
+        id: Id;
+        item: T;
+        classes?: Record<string, string[]>;
+    }, poizvedba: {
+        text: string;
+        classes?: Record<string, string[]>;
+    }) => boolean;
+    /** Dodatne iskalne nastavitve (načini ujemanja, normalizatorji poizvedbe). */
+    opts?: SearchOpts;
+    /**
+     * Nadomestne poizvedbe, ki se poskusijo, kadar glavna poizvedba ne vrne NOBENEGA
+     * kandidata (po `accept`). Uporablja domena, kadar zna poizvedbo zožiti
+     * (npr. izpust najmanj informativnih besed); vsaka varianta gre skozi isto
+     * iskanje in ocenjevanje, zato se natančnost ne more poslabšati.
+     */
+    alternativnePoizvedbe?: (query: TQuery) => readonly (string | NormalizedValue)[];
+    /**
+     * Kadar je `true`, se nadomestne poizvedbe poskusijo le, če prva ni vrnila
+     * NOBENEGA zadetka (ne pa tudi, kadar so bili vsi zavrnjeni s `accept`).
+     * Privzeto `false` (več priklica, počasneje).
+     */
+    alternativneLeCeNiZadetkov?: boolean;
+}
+/** Pripravljen indeks ene strani (`data` + `metadata`). */
+export interface PreparedCollection<T extends SearchableObject> {
+    data: SearchableData<T>;
+    metadata: NumericSearchMetadata;
+}
+/**
+ * Masovno uparjanje: indeks ene strani, elementi druge strani kot poizvedbe.
+ *
+ * Vrne async iterator, ki teče po kosih (`kos`, privzeto 50), tako da rezultat
+ * velikega uparjanja (npr. 40k × 25k) ne gre v celoti v pomnilnik. Za vsak
+ * element vrne največ `limit` kandidatov nad `minScore`, urejenih padajoče.
+ *
+ * Uporablja isto iskalno logiko kot `searchAndRank` (retrieval po `metadata.sorted`
+ * z AND-ujemanjem + ocena po `metadata.unsorted`), zato so rezultati skladni z
+ * navadnim iskanjem. Domenski modul lahko oceno in sprejem zamenja z `rank`/`accept`.
+ *
+ * @example
+ * ```typescript
+ * for await (const kos of matchMany(prepared, levi, { queryOf: (a) => a.naziv })) {
+ *   console.log(kos.id, kos.kandidati[0]?.item.naziv);
+ * }
+ * ```
+ */
+export declare function matchMany<T extends SearchableObject, TQuery>(prepared: PreparedCollection<T>, queries: readonly TQuery[], options: MatchManyOptions<T, TQuery>): AsyncGenerator<MatchManyRezultat<T>[], void, void>;
+//# sourceMappingURL=matchMany.d.ts.map

package/dist/common/numeric/matchMany.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"matchMany.d.ts","sourceRoot":"","sources":["../../../src/common/numeric/matchMany.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,EAAE,EACF,eAAe,EACf,qBAAqB,EACrB,cAAc,EACd,gBAAgB,EAChB,UAAU,EACX,MAAM,aAAa,CAAC;AAIrB;;GAEG;AACH,MAAM,WAAW,iBAAiB,CAAC,CAAC,SAAS,gBAAgB;IAC3D,EAAE,EAAE,EAAE,CAAC;IACP,IAAI,EAAE,CAAC,CAAC;IACR,wEAAwE;IACxE,KAAK,EAAE,MAAM,CAAC;IACd,mEAAmE;IACnE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CACpC;AAED,0CAA0C;AAC1C,MAAM,WAAW,iBAAiB,CAAC,CAAC,SAAS,gBAAgB;IAC3D,oDAAoD;IACpD,EAAE,EAAE,MAAM,CAAC;IACX,oDAAoD;IACpD,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACxC,6DAA6D;IAC7D,SAAS,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAAE,CAAC;CACnC;AAED,sCAAsC;AACtC,MAAM,WAAW,gBAAgB,CAAC,CAAC,SAAS,gBAAgB,EAAE,MAAM;IAClE;;;OAGG;IACH,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,eAAe,CAAC;IACrD,wFAAwF;IACxF,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC;IACjD,iDAAiD;IACjD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,uCAAuC;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,uEAAuE;IACvE,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,GAAG,SAAS,CAAC;IAChD,sEAAsE;IACtE,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IACzD,uDAAuD;IACvD,IAAI,CAAC,EAAE,CACL,QAAQ,EAAE;QAAE,EAAE,EAAE,EAAE,CAAC;QAAC,IAAI,EAAE,CAAC,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;KAAE,EACjE,SAAS,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;KAAE,KAC5D,MAAM,CAAC;IACZ,qEAAqE;IACrE,MAAM,CAAC,EAAE,CACP,QAAQ,EAAE;QAAE,EAAE,EAAE,EAAE,CAAC;QAAC,IAAI,EAAE,CAAC,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;KAAE,EACjE,SAAS,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;KAAE,KAC5D,OAAO,CAAC;IACb,8EAA8E;IAC9E,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB;;;;;OAKG;IACH,qBAAqB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,SAAS,CAAC,MAAM,GAAG,eAAe,CAAC,EAAE,CAAC;IACjF;;;;OAIG;IACH,0BAA0B,CAAC,EAAE,OAAO,CAAC;CACtC;AAED,2DAA2D;AAC3D,MAAM,WAAW,kBAAkB,CAAC,CAAC,SAAS,gBAAgB;IAC5D,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC;IACxB,QAAQ,EAAE,qBAAqB,CAAC;CACjC;AAeD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAuB,SAAS,CAAC,CAAC,SAAS,gBAAgB,EAAE,MAAM,EACjE,QAAQ,EAAE,kBAAkB,CAAC,CAAC,CAAC,EAC/B,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,OAAO,EAAE,gBAAgB,CAAC,CAAC,EAAE,MAAM,CAAC,GACnC,cAAc,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,CA4FpD"}

package/dist/common/numeric/prepareQueryVariants.d.ts

@@ -5,10 +5,34 @@ export interface PreparedQueryVariants {
     rawTokenStrs: string[];
     rawTokens: PreparedQueryToken[];
     phoneTokens: PreparedQueryToken[][];
+    /** Dopolnilni razredi, ki jih vrnejo `opts.queryNormalizers` (npr. `razpon`). */
+    classes: Record<string, string[]>;
 }
+/**
+ * Uporabi domenske normalizatorje poizvedbe (`opts.queryNormalizers`) in vrne
+ * kanonično besedilo + domenske razrede poizvedbe.
+ *
+ * Klicoči to uporabi, kadar mora iste razrede primerjati s kandidatovimi
+ * (`itemClasses(metadata, id)`) — npr. domenski ocenjevalec, ki enak razpon
+ * nagradi, nasprotnega pa kaznuje. Iskalne funkcije normalizatorje uporabijo
+ * samodejno; ta funkcija je za ocenjevalce.
+ *
+ * @example
+ * ```typescript
+ * const { text, classes } = normalizeQueryWithOpts('Nexgard 15-30 kg', opts);
+ * // classes.razpon === ['15-30']
+ * ```
+ */
+export declare function normalizeQueryWithOpts(query: string, opts?: SearchOpts): {
+    text: string;
+    classes: Record<string, string[]>;
+};
 /**
  * Produces deduplicated phone alternatives without changing ordinary query tokens.
  *
+ * Domain normalizers (`opts.queryNormalizers`) run FIRST, so both the ordinary
+ * tokens and the phone variants see the canonical text.
+ *
  * @feature [phone-search]
  */
 export declare function prepareQueryVariants(query: string, opts?: SearchOpts): PreparedQueryVariants;

package/dist/common/numeric/prepareQueryVariants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prepareQueryVariants.d.ts","sourceRoot":"","sources":["../../../src/common/numeric/prepareQueryVariants.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAIxE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,0EAA0E;AAC1E,MAAM,WAAW,qBAAqB;IACpC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,SAAS,EAAE,kBAAkB,EAAE,CAAC;IAChC,WAAW,EAAE,kBAAkB,EAAE,EAAE,CAAC;CACrC;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,qBAAqB,CAmB5F"}
+{"version":3,"file":"prepareQueryVariants.d.ts","sourceRoot":"","sources":["../../../src/common/numeric/prepareQueryVariants.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAIxE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,0EAA0E;AAC1E,MAAM,WAAW,qBAAqB;IACpC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,SAAS,EAAE,kBAAkB,EAAE,CAAC;IAChC,WAAW,EAAE,kBAAkB,EAAE,EAAE,CAAC;IACpC,iFAAiF;IACjF,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CACnC;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,UAAU,GAChB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;CAAE,CAyBrD;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,qBAAqB,CAoB5F"}

package/dist/common/numeric/searchAndRank.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"searchAndRank.d.ts","sourceRoot":"","sources":["../../../src/common/numeric/searchAndRank.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,EAAE,EACF,qBAAqB,EACrB,cAAc,EACd,gBAAgB,EAChB,UAAU,EACX,MAAM,aAAa,CAAC;AAMrB,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,qBAAqB,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACvF,YAAY,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAC;AAgBzD;;GAEG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC,SAAS,gBAAgB;IACtD,EAAE,EAAE,EAAE,CAAC;IACP,IAAI,EAAE,CAAC,CAAC;IACR,sEAAsE;IACtE,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB,CAAC,CAAC,SAAS,gBAAgB;IAC9D;;;;OAIG;IACH,aAAa,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,GAAG,SAAS,CAAC;IAC/C;;;OAGG;IACH,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IACzD,oEAAoE;IACpE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+DAA+D;IAC/D,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,gBAAgB,EAC7D,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC,EACvB,QAAQ,EAAE,qBAAqB,EAC/B,OAAO,EAAE,oBAAoB,CAAC,CAAC,CAAC,GAC/B,YAAY,CAAC,CAAC,CAAC,EAAE,CAiCnB"}
+{"version":3,"file":"searchAndRank.d.ts","sourceRoot":"","sources":["../../../src/common/numeric/searchAndRank.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,EAAE,EACF,qBAAqB,EACrB,cAAc,EACd,gBAAgB,EAChB,UAAU,EACX,MAAM,aAAa,CAAC;AAOrB,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,qBAAqB,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACvF,YAAY,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAC;AAgBzD;;GAEG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC,SAAS,gBAAgB;IACtD,EAAE,EAAE,EAAE,CAAC;IACP,IAAI,EAAE,CAAC,CAAC;IACR,sEAAsE;IACtE,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB,CAAC,CAAC,SAAS,gBAAgB;IAC9D;;;;OAIG;IACH,aAAa,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,GAAG,SAAS,CAAC;IAC/C;;;OAGG;IACH,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IACzD,oEAAoE;IACpE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+DAA+D;IAC/D,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,gBAAgB,EAC7D,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC,EACvB,QAAQ,EAAE,qBAAqB,EAC/B,OAAO,EAAE,oBAAoB,CAAC,CAAC,CAAC,GAC/B,YAAY,CAAC,CAAC,CAAC,EAAE,CAmCnB"}

package/dist/common/numeric/searchInData.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"searchInData.d.ts","sourceRoot":"","sources":["../../../src/common/numeric/searchInData.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,EAAE,EACF,qBAAqB,EACrB,cAAc,EACd,gBAAgB,EAChB,UAAU,EACX,MAAM,aAAa,CAAC;AAMrB;;;;;;;;;;;;GAYG;AACH,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,qBAAqB,EAC/B,IAAI,CAAC,EAAE,UAAU,GAChB,EAAE,EAAE,CAEN;AAED;;;;;;;;GAQG;AACH,wBAAgB,gCAAgC,CAAC,CAAC,SAAS,gBAAgB,EACzE,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,qBAAqB,EAC/B,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC,EACvB,IAAI,CAAC,EAAE,UAAU,GAChB,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,CAYZ;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,qCAAqC,CACnD,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,qBAAqB,EAC/B,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,UAAU,GAChB,EAAE,EAAE,CA4CN"}
+{"version":3,"file":"searchInData.d.ts","sourceRoot":"","sources":["../../../src/common/numeric/searchInData.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,EAAE,EACF,qBAAqB,EACrB,cAAc,EACd,gBAAgB,EAChB,UAAU,EACX,MAAM,aAAa,CAAC;AAMrB;;;;;;;;;;;;GAYG;AACH,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,qBAAqB,EAC/B,IAAI,CAAC,EAAE,UAAU,GAChB,EAAE,EAAE,CAEN;AAED;;;;;;;;GAQG;AACH,wBAAgB,gCAAgC,CAAC,CAAC,SAAS,gBAAgB,EACzE,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,qBAAqB,EAC/B,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC,EACvB,IAAI,CAAC,EAAE,UAAU,GAChB,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,CAYZ;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,qCAAqC,CACnD,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,qBAAqB,EAC/B,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,UAAU,GAChB,EAAE,EAAE,CA8CN"}

package/dist/common/numeric/syncSearchArrayMetadata.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"syncSearchArrayMetadata.d.ts","sourceRoot":"","sources":["../../../src/common/numeric/syncSearchArrayMetadata.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,qBAAqB,EACrB,cAAc,EACd,gBAAgB,EAChB,oBAAoB,EAGpB,UAAU,EACV,WAAW,EACZ,MAAM,sBAAsB,CAAA;AAK7B,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAqCnE;;;;;;;;;GASG;AACH,wBAAgB,8BAA8B,CAAC,CAAC,SAAS,gBAAgB,EAAE,CAAC,GAAG,OAAO,EACpF,QAAQ,EAAE,qBAAqB,EAC/B,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,EAC1B,IAAI,CAAC,EAAE,oBAAoB,CAAC,CAAC,EAAE,CAAC,CAAC,GAChC,UAAU,CAqDZ;AAED;;;;;GAKG;AACH,wBAAgB,0CAA0C,CAAC,CAAC,SAAS,gBAAgB,EAAE,CAAC,GAAG,OAAO,EAChG,QAAQ,EAAE,qBAAqB,EAC/B,YAAY,EAAE,cAAc,CAAC,CAAC,CAAC,EAC/B,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,EAC1B,OAAO,CAAC,EAAE,WAAW,EACrB,IAAI,CAAC,EAAE,oBAAoB,CAAC,CAAC,EAAE,CAAC,CAAC,GAChC,UAAU,CAsDZ"}
+{"version":3,"file":"syncSearchArrayMetadata.d.ts","sourceRoot":"","sources":["../../../src/common/numeric/syncSearchArrayMetadata.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,qBAAqB,EACrB,cAAc,EACd,gBAAgB,EAChB,oBAAoB,EAGpB,UAAU,EACV,WAAW,EACZ,MAAM,sBAAsB,CAAA;AAK7B,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AA4CnE;;;;;;;;;GASG;AACH,wBAAgB,8BAA8B,CAAC,CAAC,SAAS,gBAAgB,EAAE,CAAC,GAAG,OAAO,EACpF,QAAQ,EAAE,qBAAqB,EAC/B,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,EAC1B,IAAI,CAAC,EAAE,oBAAoB,CAAC,CAAC,EAAE,CAAC,CAAC,GAChC,UAAU,CAqDZ;AAED;;;;;GAKG;AACH,wBAAgB,0CAA0C,CAAC,CAAC,SAAS,gBAAgB,EAAE,CAAC,GAAG,OAAO,EAChG,QAAQ,EAAE,qBAAqB,EAC/B,YAAY,EAAE,cAAc,CAAC,CAAC,CAAC,EAC/B,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,EAC1B,OAAO,CAAC,EAAE,WAAW,EACrB,IAAI,CAAC,EAAE,oBAAoB,CAAC,CAAC,EAAE,CAAC,CAAC,GAChC,UAAU,CAsDZ"}

package/dist/common/numeric/updateSearchMetadata.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"updateSearchMetadata.d.ts","sourceRoot":"","sources":["../../../src/common/numeric/updateSearchMetadata.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,EAAE,EACF,qBAAqB,EACrB,gBAAgB,EAChB,oBAAoB,EACpB,6BAA6B,EAC9B,MAAM,aAAa,CAAC;AAIrB;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,2BAA2B,CAAC,CAAC,SAAS,gBAAgB,EAAE,CAAC,GAAG,OAAO,EACjF,QAAQ,EAAE,qBAAqB,EAC/B,QAAQ,EAAE,EAAE,EACZ,GAAG,EAAE,CAAC,GAAG,IAAI,GAAG,SAAS,EACzB,IAAI,EAAE,oBAAoB,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,SAAS,EAC5C,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAC7B,OAAO,CAgBT;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,gCAAgC,CAAC,CAAC,SAAS,gBAAgB,EAAE,CAAC,GAAG,OAAO,EACtF,QAAQ,EAAE,qBAAqB,EAC/B,KAAK,EAAE,6BAA6B,CAAC,CAAC,CAAC,EAAE,EACzC,IAAI,CAAC,EAAE,oBAAoB,CAAC,CAAC,EAAE,CAAC,CAAC,GAChC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CA0BtC;AAED;;;;;;GAMG;AACH,wBAAgB,+BAA+B,CAC7C,QAAQ,EAAE,qBAAqB,EAC/B,QAAQ,EAAE,EAAE,GACX,OAAO,CAIT;AAED;;;;;;GAMG;AACH,wBAAgB,oCAAoC,CAClD,QAAQ,EAAE,qBAAqB,EAC/B,SAAS,EAAE,EAAE,EAAE,GACd,MAAM,CAYR"}
+{"version":3,"file":"updateSearchMetadata.d.ts","sourceRoot":"","sources":["../../../src/common/numeric/updateSearchMetadata.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,EAAE,EACF,qBAAqB,EACrB,gBAAgB,EAChB,oBAAoB,EACpB,6BAA6B,EAC9B,MAAM,aAAa,CAAC;AAIrB;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,2BAA2B,CAAC,CAAC,SAAS,gBAAgB,EAAE,CAAC,GAAG,OAAO,EACjF,QAAQ,EAAE,qBAAqB,EAC/B,QAAQ,EAAE,EAAE,EACZ,GAAG,EAAE,CAAC,GAAG,IAAI,GAAG,SAAS,EACzB,IAAI,EAAE,oBAAoB,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,SAAS,EAC5C,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAC7B,OAAO,CAuBT;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,gCAAgC,CAAC,CAAC,SAAS,gBAAgB,EAAE,CAAC,GAAG,OAAO,EACtF,QAAQ,EAAE,qBAAqB,EAC/B,KAAK,EAAE,6BAA6B,CAAC,CAAC,CAAC,EAAE,EACzC,IAAI,CAAC,EAAE,oBAAoB,CAAC,CAAC,EAAE,CAAC,CAAC,GAChC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CA0BtC;AAED;;;;;;GAMG;AACH,wBAAgB,+BAA+B,CAC7C,QAAQ,EAAE,qBAAqB,EAC/B,QAAQ,EAAE,EAAE,GACX,OAAO,CAIT;AAED;;;;;;GAMG;AACH,wBAAgB,oCAAoC,CAClD,QAAQ,EAAE,qBAAqB,EAC/B,SAAS,EAAE,EAAE,EAAE,GACd,MAAM,CAYR"}