cry-search 2.2.0 → 2.3.0

package/README.md

@@ -569,6 +569,18 @@ brand names are never translated, and marketing/connector words (`care`, `for`,
 dropped. `razdeljevalciNormalizator` splits `&`/`+`/`/` inside names, and life stages
 (`puppy`/`kitten`/`adult`/`senior`) become the soft class `starost`.
 
+For a **user-facing search field** the same lexicon must be in the search index, but the
+class-producing normalizers have to stay out (a user searching `200ml`, `PRIB` or `adult` must
+still find those rows). That is what `vetIskalniSpec()` / `vetIskalniQueryOpts()` are for:
+
+```typescript
+import { vetIskalniSpec, vetIskalniQueryOpts } from 'cry-search/vet';
+
+const metadata = createSearchArrayMetadata(data, vetIskalniSpec({ polja: ['acName', 'acIdent'] }));
+searchAndRank('monge rabbit', data, metadata, vetIskalniQueryOpts({ exactKeysFn }));
+// → najde `MONGE DOG ADULT zajec, riž, krompir 2,5kg` (leksikon rabbit → zajec)
+```
+
 With `vrniNesprejete: true` the domain module keeps candidates that fail the acceptance rule and
 marks them (`sprejeto: false`) instead of dropping them — useful in UIs where the user decides.
 

package/dist/vet/index.cjs

@@ -46,6 +46,7 @@ __export(exports_vet, {
   STOP_BESEDE: () => STOP_BESEDE,
   VELIKOSTI_EN: () => VELIKOSTI_EN,
   VELIKOSTI_OKRAJSAVE: () => VELIKOSTI_OKRAJSAVE,
+  VET_ISKALNI_NORMALIZATORJI: () => VET_ISKALNI_NORMALIZATORJI,
   VET_NORMALIZATORJI: () => VET_NORMALIZATORJI,
   VET_TABELA: () => VET_TABELA,
   VRSTE_SINONIMI: () => VRSTE_SINONIMI,
@@ -65,6 +66,8 @@ __export(exports_vet, {
   upariVseSync: () => upariVseSync,
   velikostNormalizator: () => velikostNormalizator,
   vetArtikelSpec: () => vetArtikelSpec,
+  vetIskalniQueryOpts: () => vetIskalniQueryOpts,
+  vetIskalniSpec: () => vetIskalniSpec,
   vetQueryOpts: () => vetQueryOpts,
   vrstaNormalizator: () => vrstaNormalizator,
   znamkaNormalizator: () => znamkaNormalizator
@@ -1680,6 +1683,29 @@ function vetArtikelSpec(nastavitve = {}) {
 function vetQueryOpts(dodatni = {}) {
   return { ...dodatni, queryNormalizers: [...VET_NORMALIZATORJI, ...dodatni.queryNormalizers ?? []] };
 }
+var VET_ISKALNI_NORMALIZATORJI = [
+  kodiranjeNormalizator,
+  decimalkeNormalizator,
+  enoteNormalizator,
+  znamkaNormalizator,
+  razdeljevalciNormalizator,
+  prevodiNormalizator
+];
+function vetIskalniSpec(nastavitve = {}) {
+  const polja = nastavitve.polja ?? ["naziv"];
+  return {
+    searchInFields: [...polja],
+    keyFields: [...nastavitve.keyFields ?? polja],
+    ...nastavitve.prviTokeni !== undefined ? { firstTokensN: nastavitve.prviTokeni } : {},
+    valueNormalizers: [...VET_ISKALNI_NORMALIZATORJI, ...nastavitve.dodatniNormalizatorji ?? []]
+  };
+}
+function vetIskalniQueryOpts(dodatni = {}) {
+  return {
+    ...dodatni,
+    queryNormalizers: [...VET_ISKALNI_NORMALIZATORJI, ...dodatni.queryNormalizers ?? []]
+  };
+}
 // src/types/index.ts
 var DEFAULT_PHONE_FIELDS = ["telefon", "phone", "gsm", "msisdn"];
 var DEFAULT_FIRST_TOKENS_N = 8;

package/dist/vet/index.d.cts

@@ -14,7 +14,7 @@
  */
 export { VET_NORMALIZATORJI, VET_TABELA } from './normalizatorji';
 export { decimalkeNormalizator, enoteNormalizator, kolicinaNormalizator, oznakeNormalizator, prevodiNormalizator, razdeljevalciNormalizator, starostNormalizator, velikostNormalizator, vrstaNormalizator, znamkaNormalizator, } from './normalizatorji';
-export { vetArtikelSpec, vetQueryOpts, type VetSpecNastavitve } from './spec';
+export { VET_ISKALNI_NORMALIZATORJI, vetArtikelSpec, vetIskalniQueryOpts, vetIskalniSpec, vetQueryOpts, type VetSpecNastavitve, } from './spec';
 /** Iz jedra ponovno izvoženo, ker je del vet pogodbe (razredi poizvedbe). */
 export { normalizeQueryWithOpts } from '../common/numeric/prepareQueryVariants';
 export { oceniPar, type VetOcena, type VetOcenaNastavitve, type VetRazredi } from './ocena';

package/dist/vet/index.d.ts

@@ -14,7 +14,7 @@
  */
 export { VET_NORMALIZATORJI, VET_TABELA } from './normalizatorji';
 export { decimalkeNormalizator, enoteNormalizator, kolicinaNormalizator, oznakeNormalizator, prevodiNormalizator, razdeljevalciNormalizator, starostNormalizator, velikostNormalizator, vrstaNormalizator, znamkaNormalizator, } from './normalizatorji';
-export { vetArtikelSpec, vetQueryOpts, type VetSpecNastavitve } from './spec';
+export { VET_ISKALNI_NORMALIZATORJI, vetArtikelSpec, vetIskalniQueryOpts, vetIskalniSpec, vetQueryOpts, type VetSpecNastavitve, } from './spec';
 /** Iz jedra ponovno izvoženo, ker je del vet pogodbe (razredi poizvedbe). */
 export { normalizeQueryWithOpts } from '../common/numeric/prepareQueryVariants';
 export { oceniPar, type VetOcena, type VetOcenaNastavitve, type VetRazredi } from './ocena';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/vet/index.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAClE,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,EACnB,yBAAyB,EACzB,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,QAAQ,CAAC;AAC9E,6EAA6E;AAC7E,OAAO,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AAChF,OAAO,EAAE,QAAQ,EAAE,KAAK,QAAQ,EAAE,KAAK,kBAAkB,EAAE,KAAK,UAAU,EAAE,MAAM,SAAS,CAAC;AAC5F,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,QAAQ,EACR,YAAY,EACZ,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,MAAM,EACX,KAAK,sBAAsB,GAC5B,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACxF,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/vet/index.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAClE,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,EACnB,yBAAyB,EACzB,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,0BAA0B,EAC1B,cAAc,EACd,mBAAmB,EACnB,cAAc,EACd,YAAY,EACZ,KAAK,iBAAiB,GACvB,MAAM,QAAQ,CAAC;AAChB,6EAA6E;AAC7E,OAAO,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AAChF,OAAO,EAAE,QAAQ,EAAE,KAAK,QAAQ,EAAE,KAAK,kBAAkB,EAAE,KAAK,UAAU,EAAE,MAAM,SAAS,CAAC;AAC5F,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,QAAQ,EACR,YAAY,EACZ,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,MAAM,EACX,KAAK,sBAAsB,GAC5B,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACxF,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/vet/index.js

@@ -1607,6 +1607,29 @@ function vetArtikelSpec(nastavitve = {}) {
 function vetQueryOpts(dodatni = {}) {
   return { ...dodatni, queryNormalizers: [...VET_NORMALIZATORJI, ...dodatni.queryNormalizers ?? []] };
 }
+var VET_ISKALNI_NORMALIZATORJI = [
+  kodiranjeNormalizator,
+  decimalkeNormalizator,
+  enoteNormalizator,
+  znamkaNormalizator,
+  razdeljevalciNormalizator,
+  prevodiNormalizator
+];
+function vetIskalniSpec(nastavitve = {}) {
+  const polja = nastavitve.polja ?? ["naziv"];
+  return {
+    searchInFields: [...polja],
+    keyFields: [...nastavitve.keyFields ?? polja],
+    ...nastavitve.prviTokeni !== undefined ? { firstTokensN: nastavitve.prviTokeni } : {},
+    valueNormalizers: [...VET_ISKALNI_NORMALIZATORJI, ...nastavitve.dodatniNormalizatorji ?? []]
+  };
+}
+function vetIskalniQueryOpts(dodatni = {}) {
+  return {
+    ...dodatni,
+    queryNormalizers: [...VET_ISKALNI_NORMALIZATORJI, ...dodatni.queryNormalizers ?? []]
+  };
+}
 // src/types/index.ts
 var DEFAULT_PHONE_FIELDS = ["telefon", "phone", "gsm", "msisdn"];
 var DEFAULT_FIRST_TOKENS_N = 8;
@@ -2998,6 +3021,7 @@ export {
   STOP_BESEDE,
   VELIKOSTI_EN,
   VELIKOSTI_OKRAJSAVE,
+  VET_ISKALNI_NORMALIZATORJI,
   VET_NORMALIZATORJI,
   VET_TABELA,
   VRSTE_SINONIMI,
@@ -3017,6 +3041,8 @@ export {
   upariVseSync,
   velikostNormalizator,
   vetArtikelSpec,
+  vetIskalniQueryOpts,
+  vetIskalniSpec,
   vetQueryOpts,
   vrstaNormalizator,
   znamkaNormalizator

package/dist/vet/spec.d.ts

@@ -32,4 +32,32 @@ export declare function vetArtikelSpec<T extends SearchableObject>(nastavitve?:
  * Uporabi jih vsak klic iskanja/uparjanja nad vet indeksom.
  */
 export declare function vetQueryOpts(dodatni?: SearchOpts): SearchOpts;
+/**
+ * Normalizatorji za **uporabniško iskanje** (iskalno polje v klik.vetu, demo stran):
+ * le tisti, ki besedilo ohranijo in samo poenotijo zapis.
+ *
+ * Zakaj druga podmnožica kot pri uparjanju (teh NI):
+ *   - `kolicinaNormalizator`, `velikostNormalizator`, `starostNormalizator`,
+ *     `vrstaNormalizator`, `oznakeNormalizator`, `tipskeOznakeNormalizator` besede
+ *     ODSTRANIJO iz besedila (gredo v razrede). Za uparjanje je to prav (mehka
+ *     semantika), za iskanje pa ne: uporabnik, ki vpiše `200ml`, `PRIB` ali `adult`,
+ *     mora te zadetke dobiti;
+ *   - `pantheonOznakaNormalizator` odstrani vodilne zvezdice (`**`), zato bi iskanje
+ *     po njih prenehalo delovati (v indeksu so trenutno del besedila).
+ *
+ * Kar ostane, je natanko tisto, kar iskalnik potrebuje, da zadene tudi zapise v
+ * DRUGEM JEZIKU: enote (`tablet` → `tbl`), znamke (`RC` → `Royal Canin`), ločila
+ * (`riž&krompir` → dva žetona) in dvojezični leksikon (`rabbit` → `ZAJEC`).
+ *
+ * @example
+ * ```typescript
+ * const metadata = createSearchArrayMetadata(data, vetIskalniSpec({ polja: ['acName', 'acIdent'] }));
+ * searchAndRank('monge rabbit', data, metadata, vetIskalniQueryOpts({ exactKeysFn }));
+ * ```
+ */
+export declare const VET_ISKALNI_NORMALIZATORJI: ValueNormalizer[];
+/** Spec za iskalni indeks artikelov (glej {@link VET_ISKALNI_NORMALIZATORJI}). */
+export declare function vetIskalniSpec<T extends SearchableObject>(nastavitve?: VetSpecNastavitve): SearchableObjectSpec<T>;
+/** Iskalne nastavitve poizvedbe za iskalni indeks (isti normalizatorji kot indeks). */
+export declare function vetIskalniQueryOpts(dodatni?: SearchOpts): SearchOpts;
 //# sourceMappingURL=spec.d.ts.map

package/dist/vet/spec.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"spec.d.ts","sourceRoot":"","sources":["../../src/vet/spec.ts"],"names":[],"mappings":"AACA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAGpG,oCAAoC;AACpC,MAAM,WAAW,iBAAiB;IAChC,+DAA+D;IAC/D,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,kEAAkE;IAClE,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,8DAA8D;IAC9D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6DAA6D;IAC7D,qBAAqB,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;CACpD;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,gBAAgB,EACvD,UAAU,GAAE,iBAAsB,GACjC,oBAAoB,CAAC,CAAC,CAAC,CAQzB;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,GAAE,UAAe,GAAG,UAAU,CAEjE"}
+{"version":3,"file":"spec.d.ts","sourceRoot":"","sources":["../../src/vet/spec.ts"],"names":[],"mappings":"AACA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAWpG,oCAAoC;AACpC,MAAM,WAAW,iBAAiB;IAChC,+DAA+D;IAC/D,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,kEAAkE;IAClE,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,8DAA8D;IAC9D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6DAA6D;IAC7D,qBAAqB,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;CACpD;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,gBAAgB,EACvD,UAAU,GAAE,iBAAsB,GACjC,oBAAoB,CAAC,CAAC,CAAC,CAQzB;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,GAAE,UAAe,GAAG,UAAU,CAEjE;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,0BAA0B,EAAE,eAAe,EAOvD,CAAC;AAEF,kFAAkF;AAClF,wBAAgB,cAAc,CAAC,CAAC,SAAS,gBAAgB,EACvD,UAAU,GAAE,iBAAsB,GACjC,oBAAoB,CAAC,CAAC,CAAC,CAQzB;AAED,uFAAuF;AACvF,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,UAAe,GAAG,UAAU,CAKxE"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cry-search",
-  "version": "2.2.0",
+  "version": "2.3.0",
   "description": "A fast, memory-efficient search library for large datasets with support for tokenized matching, linked collections, and per-field match modes.",
   "type": "module",
   "main": "./dist/index.js",