cry-search 1.0.0 → 1.0.1

package/CLAUDE.md

@@ -6,6 +6,17 @@ cry-search is a library for fast searching in large datasets.
 1. Bun bundler for development, testing, and bundling
 2. ESM jscript in dist for distribution
 
+## Documentation
+
+Documentation is spread across multiple files that must be kept in sync:
+
+1. [CLAUDE.md](./CLAUDE.md) - Technical specification, types, architecture details
+2. [README.md](./README.md) - User-facing documentation, examples, quick start
+3. [UNIVERSE.md](./UNIVERSE.md) - SearchUniverse multi-collection manager documentation
+4. **JSDoc comments** - Inline documentation in source files (`src/**/*.ts`)
+
+**Important:** When updating documentation (types, behavior, API changes), update ALL relevant files together to maintain consistency.
+
 ## Architecture
 
 The library has two implementations:
@@ -60,15 +71,20 @@ The numeric implementation uses a global token registry (`src/utils/tokenRegistr
       3. sanitation
          1. case-insensitive
          2. diacritics-insensitive (č,ć,c -> same c)
-         3. we only keep letters (a-z), digits (0-9), periods (.), minuses (-), spaces (" ") in search
+tsc         3. we only keep letters (a-z), digits (0-9), periods (.), minuses (-), tildes (~), query prefixes (<>+*!=?), spaces (" ") in search
          4. other characters are replaced with space (" ")
    2. tokenization
       1. we split strings on spaces
       2. then we trim all substrings
    3. matching
       1. we match words in any order
-      2. we match numbers from start or from end
-         1. eg. 123 matches 12345 and 45123 but not 7812345
+      2. number matching depends on TARGET token length (not query length):
+         1. short numbers (≤6 digits in target): whole match only
+            - eg. query "123" vs target "123" → match
+            - eg. query "12" vs target "123" → no match (target is short, needs exact)
+         2. long numbers (>6 digits in target): startEnd match
+            - eg. query "60731" vs target "3838989760731" → match (13-digit barcode)
+            - eg. query "989" vs target "3838989760731" → no match (not at start/end)
    4. nested data extraction
       1. nested objects and arrays are automatically extracted recursively
       2. Date objects are converted to ISO strings before tokenization
@@ -135,7 +151,16 @@ The numeric implementation uses a global token registry (`src/utils/tokenRegistr
 10. MatchMode: 'start' | 'end' | 'startEnd' | 'anywhere' | 'whole'
     1. Field token prefixes: '<' (start), '>' (end), '+' (startEnd), '*' (anywhere), '!' (whole)
     2. Numeric: encoded in high 3 bits of Uint32 token ID
-11. SearchableLinkedObjectsSpec: primary SearchableObjectSpec, linked SearchableObjectSpec, foreignKeyGetter
+11. SearchOpts:
+    1. matchWords?: MatchMode (default: 'start') - how to match words
+    2. matchNumbers?: MatchMode (default: 'startEnd') - how to match long numbers (>threshold digits)
+    3. matchNumbersShort?: MatchMode (default: 'whole') - how to match short numbers (≤threshold digits)
+    4. matchNumbersThreshold?: number (default: 6) - digit count threshold for short vs long
+12. LinkedSearchResultWithMeta<TPrimary, TLinked>:
+    1. queryTokens: string[] - tokenized query
+    2. results: LinkedSearchResult[] - matching results
+    3. hasNegation: boolean - whether query contains negated tokens
+13. SearchableLinkedObjectsSpec: primary SearchableObjectSpec, linked SearchableObjectSpec, foreignKeyGetter
 
 ## Search Query Prefixes
 
@@ -148,8 +173,11 @@ Override match behavior per token at search time. Priority: query prefix > field
 | `..word` | end | Match tokens ending with word | `..Pro` matches "MacBookPro" |
 | `=word` | whole | Exact match only | `=jan` matches "jan" not "jana" |
 | `?word` | anywhere | Match word anywhere in token | `?book` matches "MacBook" |
-| `--word` | negation | Exclude results containing word | `apple --iphone` excludes iPhones |
-| `~word` | negation | Same as `--word` | `apple ~iphone` |
+| `-word` | negation | Exclude results containing word (letter after -) | `apple -iphone` excludes iPhones |
+| `--word` | negation | Exclude (works for words and numbers) | `--123` excludes items with "123" |
+| `~word` | negation | Exclude (works for words and numbers) | `~iphone` or `~123` |
+
+**Note:** `-5` is NOT negation (it's a negative number). Use `--5` or `~5` to negate numbers.
 
 ### Programmatic prefixes
 | Prefix | Mode |
@@ -161,11 +189,14 @@ Override match behavior per token at search time. Priority: query prefix > field
 | `!word` | whole |
 
 ### Examples
-1. `"jana useni"` → finds "jana usenik" (default startEnd matching)
+1. `"jana useni"` → finds "jana usenik" (default start matching for words)
 2. `"jana =useni"` → no match (whole match required, "useni" ≠ "usenik")
-3. `"jana --macka"` → finds "jana" but excludes any result containing "macka"
-4. `"APL.."` → finds all tokens starting with "APL" (APL-IP15P, APL-MBP16)
-5. `"..nik"` → finds tokens ending with "nik" (usenik, krajnik)
+3. `"jana -macka"` → finds "jana" but excludes any result containing "macka"
+4. `"krajnik --cat"` → finds "krajnik" but excludes linked items with "cat" (mačke)
+5. `"APL.."` → finds all tokens starting with "APL" (APL-IP15P, APL-MBP16)
+6. `"..nik"` → finds tokens ending with "nik" (usenik, krajnik)
+7. `"60731"` → finds barcode "3838989760731" (13-digit target uses startEnd)
+8. `"=9001"` → finds exact "9001" but NOT "035585249001" or "9001917"
 
 
 ## Main Functions (Default = Numeric)

package/README.md

@@ -8,7 +8,7 @@ A fast, memory-efficient search library for large datasets with support for toke
 - **Memory efficient** - Numeric token storage uses ~45% less memory than string-based approaches
 - **Updatable** - Add, update, or remove items without rebuilding metadata
 - **Flexible matching** - Per-field match modes and query prefixes for prefix, suffix, anywhere, exact, and negation
-- **Search prefixed** - use `--word` to exclude it, `...word` for suffix, and more
+- **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
 - **[Universal search](./UNIVERSE.md)** - Search and update across linked collections (e.g., customers with their pets)
 
@@ -237,7 +237,13 @@ Override match behavior per token at search time using prefixes:
 | `..word` | end | Match tokens ending with "word" |
 | `=word` | whole | Exact match only |
 | `?word` | anywhere | Match "word" anywhere in token |
-| `--word` or `~word` | negation | Exclude results containing "word" |
+| `-word` | negation | Exclude results (only when followed by letter) |
+| `--word` | negation | Exclude results (works for words and numbers) |
+| `~word` | negation | Exclude results (works for words and numbers) |
+
+**Note:** `-5` is NOT negation (it's a negative number). Use `--5` or `~5` to negate numbers.
+
+**Detecting negation:** Linked search results include a `hasNegation: boolean` flag indicating if the query contained negation tokens.
 
 Alternative prefixes (for programmatic use): `<word` (start), `>word` (end), `+word` (startEnd), `*word` (anywhere), `!word` (whole)
 
@@ -247,12 +253,28 @@ searchInDataReturnObjects('jana =usenik', metadata, data);
 // Matches "Jana Usenik" but not "Jana Useniker"
 
 // Find "apple" but exclude results containing "iphone"
-searchInDataReturnObjects('apple --iphone', metadata, data);
+searchInDataReturnObjects('apple -iphone', metadata, data);
 // Matches MacBook Pro but not iPhone
 
 // Find products with SKU starting with "APL"
 searchInDataReturnObjects('APL..', metadata, data);
 // Matches APL-IP15P, APL-MBP16, etc.
+
+// Find exact barcode code
+searchInDataReturnObjects('=9001', metadata, data);
+// Matches "9001" but NOT "035585249001" or "9001917"
+```
+
+### Number Matching
+
+Match mode for numbers is determined by the **target token's length** (not the query):
+- **Short numbers (≤6 digits)**: require exact (whole) match
+- **Long numbers (>6 digits)**: allow start or end match (for barcodes)
+
+```typescript
+// Query "60731" against barcode "3838989760731" (13 digits) → MATCH (ends with 60731)
+// Query "123" against code "123" (3 digits) → MATCH (exact)
+// Query "12" against code "123" (3 digits) → NO MATCH (short number needs exact)
 ```
 
 Priority: query prefix > field match mode > global SearchOpts default.

package/dist/common/SearchUniverse.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SearchUniverse.d.ts","sourceRoot":"","sources":["../../src/common/SearchUniverse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,EAAE,EACF,qBAAqB,EACrB,cAAc,EACd,gBAAgB,EAEhB,mBAAmB,EACnB,gBAAgB,EAChB,YAAY,EACZ,iBAAiB,EAClB,MAAM,UAAU,CAAC;AAWlB,YAAY,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAcvG;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,WAAW,CAAiC;IAEpD;;;;;OAKG;IACH,kBAAkB,CAAC,CAAC,SAAS,gBAAgB,EAAE,CAAC,GAAG,OAAO,EACxD,IAAI,EAAE,MAAM,EACZ,MAAM,GAAE,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAM,GAClC,IAAI;IAmBP;;;;;OAKG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIpC;;;;OAIG;IACH,kBAAkB,IAAI,MAAM,EAAE;IAI9B;;;;;;OAMG;IACH,cAAc,CAAC,CAAC,SAAS,gBAAgB,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,IAAI;IAsC1E;;;;;;;OAOG;IACH,OAAO,CAAC,CAAC,SAAS,gBAAgB,EAAE,cAAc,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,GAAG,CAAC,GAAG,SAAS;IAKlF;;;;;;OAMG;IACH,QAAQ,CAAC,CAAC,SAAS,gBAAgB,EAAE,cAAc,EAAE,MAAM,GAAG,CAAC,EAAE;IAKjE;;;;;OAKG;IACH,iBAAiB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM;IAKjD;;;;;OAKG;IACH,WAAW,CAAC,cAAc,EAAE,MAAM,GAAG,qBAAqB;IAK1D;;;;;;OAMG;IACH,OAAO,CAAC,CAAC,SAAS,gBAAgB,EAAE,cAAc,EAAE,MAAM,GAAG,cAAc,CAAC,CAAC,CAAC;IAK9E;;;;;;;OAOG;IACH,YAAY,CAAC,oBAAoB,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,GAAG,EAAE,EAAE;IAQ/D;;;;;;;OAOG;IACH,cAAc,CAAC,CAAC,SAAS,gBAAgB,EACvC,oBAAoB,EAAE,MAAM,EAC5B,SAAS,EAAE,EAAE,GACZ,CAAC,EAAE;IAMN;;;;;;;;;;;;OAYG;IACH,oBAAoB,CAAC,CAAC,SAAS,gBAAgB,EAC7C,cAAc,EAAE,MAAM,EACtB,EAAE,EAAE,EAAE,EACN,IAAI,EAAE,CAAC,GACN,YAAY;IAoFf;;;;;;OAMG;IACH,yBAAyB,CAAC,CAAC,SAAS,gBAAgB,EAClD,cAAc,EAAE,MAAM,EACtB,KAAK,EAAE,CAAC,EAAE,GACT,iBAAiB;IA0BpB;;;;;;OAMG;IACH,wBAAwB,CAAC,cAAc,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,GAAG,OAAO;IAmCjE;;;;;;OAMG;IACH,6BAA6B,CAAC,cAAc,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,MAAM;IAcxE;;;;;;;OAOG;IACH,OAAO,CAAC,oBAAoB;IAQ5B;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,iBAAiB,CACf,KAAK,EAAE,MAAM,EACb,KAAK,GAAE,MAAW,EAClB,IAAI,CAAC,EAAE,mBAAmB,GACzB,MAAM,CAAC,MAAM,EAAE,gBAAgB,EAAE,GAAG,KAAK,CAAC;QAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC;QAAC,OAAO,EAAE,gBAAgB,CAAC;QAAC,SAAS,EAAE,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAA;KAAE,CAAC,CAAC;IA8FlJ;;;;;;;;OAQG;IACH,KAAK,IAAI,IAAI;CAUd"}
+{"version":3,"file":"SearchUniverse.d.ts","sourceRoot":"","sources":["../../src/common/SearchUniverse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,EAAE,EACF,qBAAqB,EACrB,cAAc,EACd,gBAAgB,EAEhB,mBAAmB,EACnB,gBAAgB,EAChB,YAAY,EACZ,iBAAiB,EAClB,MAAM,UAAU,CAAC;AAWlB,YAAY,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAcvG;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,WAAW,CAAiC;IAEpD;;;;;OAKG;IACH,kBAAkB,CAAC,CAAC,SAAS,gBAAgB,EAAE,CAAC,GAAG,OAAO,EACxD,IAAI,EAAE,MAAM,EACZ,MAAM,GAAE,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAM,GAClC,IAAI;IAmBP;;;;;OAKG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIpC;;;;OAIG;IACH,kBAAkB,IAAI,MAAM,EAAE;IAI9B;;;;;;OAMG;IACH,cAAc,CAAC,CAAC,SAAS,gBAAgB,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,IAAI;IAsC1E;;;;;;;OAOG;IACH,OAAO,CAAC,CAAC,SAAS,gBAAgB,EAAE,cAAc,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,GAAG,CAAC,GAAG,SAAS;IAKlF;;;;;;OAMG;IACH,QAAQ,CAAC,CAAC,SAAS,gBAAgB,EAAE,cAAc,EAAE,MAAM,GAAG,CAAC,EAAE;IAKjE;;;;;OAKG;IACH,iBAAiB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM;IAKjD;;;;;OAKG;IACH,WAAW,CAAC,cAAc,EAAE,MAAM,GAAG,qBAAqB;IAK1D;;;;;;OAMG;IACH,OAAO,CAAC,CAAC,SAAS,gBAAgB,EAAE,cAAc,EAAE,MAAM,GAAG,cAAc,CAAC,CAAC,CAAC;IAK9E;;;;;;;OAOG;IACH,YAAY,CAAC,oBAAoB,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,GAAG,EAAE,EAAE;IAQ/D;;;;;;;OAOG;IACH,cAAc,CAAC,CAAC,SAAS,gBAAgB,EACvC,oBAAoB,EAAE,MAAM,EAC5B,SAAS,EAAE,EAAE,GACZ,CAAC,EAAE;IAMN;;;;;;;;;;;;OAYG;IACH,oBAAoB,CAAC,CAAC,SAAS,gBAAgB,EAC7C,cAAc,EAAE,MAAM,EACtB,EAAE,EAAE,EAAE,EACN,IAAI,EAAE,CAAC,GACN,YAAY;IAoFf;;;;;;OAMG;IACH,yBAAyB,CAAC,CAAC,SAAS,gBAAgB,EAClD,cAAc,EAAE,MAAM,EACtB,KAAK,EAAE,CAAC,EAAE,GACT,iBAAiB;IA0BpB;;;;;;OAMG;IACH,wBAAwB,CAAC,cAAc,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,GAAG,OAAO;IAmCjE;;;;;;OAMG;IACH,6BAA6B,CAAC,cAAc,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,MAAM;IAcxE;;;;;;;OAOG;IACH,OAAO,CAAC,oBAAoB;IAQ5B;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,iBAAiB,CACf,KAAK,EAAE,MAAM,EACb,KAAK,GAAE,MAAW,EAClB,IAAI,CAAC,EAAE,mBAAmB,GACzB,MAAM,CAAC,MAAM,EAAE,gBAAgB,EAAE,GAAG,KAAK,CAAC;QAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC;QAAC,OAAO,EAAE,gBAAgB,CAAC;QAAC,SAAS,EAAE,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAA;KAAE,CAAC,CAAC;IA6FlJ;;;;;;;;OAQG;IACH,KAAK,IAAI,IAAI;CAUd"}

package/dist/common/findInLinkedArrays.d.ts

@@ -20,7 +20,7 @@ export type { LinkedSearchResult, LinkedSearchResultWithMeta } from '../types';
  * @param linked - Linked metadata from {@link createSearchLinkedMetadata}
  * @param limit - Maximum number of results to return (default: 10)
  * @param opts - Optional search options for controlling match behavior
- * @returns Search results with query tokens and matching items
+ * @returns Search results with query tokens, matching items, and hasNegation flag
  *
  * @example
  * ```typescript

package/dist/common/findInLinkedArrays.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"findInLinkedArrays.d.ts","sourceRoot":"","sources":["../../src/common/findInLinkedArrays.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,gBAAgB,EAChB,UAAU,EACV,kBAAkB,EAClB,0BAA0B,EAC1B,4BAA4B,EAC7B,MAAM,UAAU,CAAC;AAKlB,YAAY,EAAE,kBAAkB,EAAE,0BAA0B,EAAE,MAAM,UAAU,CAAC;AAE/E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,SAAS,gBAAgB,EACjC,OAAO,SAAS,gBAAgB,EAEhC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,4BAA4B,CAAC,QAAQ,EAAE,OAAO,CAAC,EACvD,KAAK,GAAE,MAAW,EAClB,IAAI,CAAC,EAAE,UAAU,GAChB,0BAA0B,CAAC,QAAQ,EAAE,OAAO,CAAC,CAyF/C;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,SAAS,gBAAgB,EACjC,OAAO,SAAS,gBAAgB,EAEhC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,4BAA4B,CAAC,QAAQ,EAAE,OAAO,CAAC,EACvD,KAAK,GAAE,MAAW,EAClB,IAAI,CAAC,EAAE,UAAU,GAChB,kBAAkB,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,CAEzC"}
+{"version":3,"file":"findInLinkedArrays.d.ts","sourceRoot":"","sources":["../../src/common/findInLinkedArrays.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,gBAAgB,EAChB,UAAU,EACV,kBAAkB,EAClB,0BAA0B,EAC1B,4BAA4B,EAC7B,MAAM,UAAU,CAAC;AAKlB,YAAY,EAAE,kBAAkB,EAAE,0BAA0B,EAAE,MAAM,UAAU,CAAC;AAE/E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,SAAS,gBAAgB,EACjC,OAAO,SAAS,gBAAgB,EAEhC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,4BAA4B,CAAC,QAAQ,EAAE,OAAO,CAAC,EACvD,KAAK,GAAE,MAAW,EAClB,IAAI,CAAC,EAAE,UAAU,GAChB,0BAA0B,CAAC,QAAQ,EAAE,OAAO,CAAC,CAgG/C;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,SAAS,gBAAgB,EACjC,OAAO,SAAS,gBAAgB,EAEhC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,4BAA4B,CAAC,QAAQ,EAAE,OAAO,CAAC,EACvD,KAAK,GAAE,MAAW,EAClB,IAAI,CAAC,EAAE,UAAU,GAChB,kBAAkB,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,CAEzC"}

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

@@ -20,7 +20,7 @@ import type { NumericLinkedSearchMetadataWithData } from './createSearchLinkedMe
  * @param linked - Linked metadata from {@link createSearchLinkedMetadataNumeric}
  * @param limit - Maximum number of results to return (default: 10)
  * @param opts - Optional search options for controlling match behavior
- * @returns Search results with query tokens and matching items
+ * @returns Search results with query tokens, matching items, and hasNegation flag
  */
 export declare function findInLinkedArraysNumeric<TPrimary extends SearchableObject, TLinked extends SearchableObject>(query: string, linked: NumericLinkedSearchMetadataWithData<TPrimary, TLinked>, limit?: number, opts?: SearchOpts): LinkedSearchResultWithMeta<TPrimary, TLinked>;
 /**

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":"AAAA,OAAO,KAAK,EACV,EAAE,EACF,qBAAqB,EACrB,cAAc,EACd,gBAAgB,EAChB,UAAU,EACX,MAAM,aAAa,CAAC;AAIrB;;;;;;;GAOG;AACH,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,qBAAqB,EAC/B,IAAI,CAAC,EAAE,UAAU,GAChB,EAAE,EAAE,CAoBN;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;;;;;;;;GAQG;AACH,wBAAgB,qCAAqC,CACnD,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,qBAAqB,EAC/B,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,UAAU,GAChB,EAAE,EAAE,CAsBN"}
+{"version":3,"file":"searchInData.d.ts","sourceRoot":"","sources":["../../../src/common/numeric/searchInData.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,EAAE,EACF,qBAAqB,EACrB,cAAc,EACd,gBAAgB,EAChB,UAAU,EACX,MAAM,aAAa,CAAC;AAIrB;;;;;;;GAOG;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;;;;;;;;GAQG;AACH,wBAAgB,qCAAqC,CACnD,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,qBAAqB,EAC/B,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,UAAU,GAChB,EAAE,EAAE,CAsBN"}

package/dist/index.cjs

@@ -105,7 +105,9 @@ module.exports = __toCommonJS(exports_src);
 // src/types/index.ts
 var DEFAULT_SEARCH_OPTS = {
   matchWords: "start",
-  matchNumbers: "startEnd"
+  matchNumbers: "startEnd",
+  matchNumbersShort: "whole",
+  matchNumbersThreshold: 6
 };
 function arrayToSearchableData(items) {
   const map = new Map;
@@ -233,7 +235,7 @@ function preprocessString(input) {
 
 // src/utils/sanitiseString.ts
 var RE_DIACRITICS = /[\u0300-\u036f]/g;
-var RE_INVALID_CHARS = /[^a-z0-9.\- ]/g;
+var RE_INVALID_CHARS = /[^a-z0-9.\-~<>+*!=? ]/g;
 function sanitiseString(input) {
   let result = input;
   result = result.toLowerCase();
@@ -277,11 +279,16 @@ function tokenize(input, config) {
   let tokens = input.split(" ").map((token) => token.trim()).filter((token) => token.length > 0);
   if (config?.replaceTokens) {
     tokens = tokens.map((token) => {
-      if (token.startsWith("--") && token.length > 2) {
+      if (token.length > 2 && token.startsWith("--")) {
         const withoutPrefix = token.slice(2);
         const replaced = config.replaceTokens.get(withoutPrefix);
         return replaced ? "--" + replaced : token;
       }
+      if (token.length > 1 && token[0] === "-" && /^[a-z]/i.test(token[1])) {
+        const withoutPrefix = token.slice(1);
+        const replaced = config.replaceTokens.get(withoutPrefix);
+        return replaced ? "-" + replaced : token;
+      }
       return config.replaceTokens.get(token) ?? token;
     });
   }
@@ -750,14 +757,38 @@ function removeFromSearchMetadataBatchNumeric(metadata, objectIds) {
 }
 // src/utils/matchTokenNumeric.ts
 var RE_NUMERIC = /^[\d.\-]+$/;
+function countDigits(str) {
+  let count = 0;
+  for (let i = 0;i < str.length; i++) {
+    const c = str[i];
+    if (c !== "." && c !== "-")
+      count++;
+  }
+  return count;
+}
+function getNumericMatchMode(str, opts) {
+  const threshold = opts?.matchNumbersThreshold ?? DEFAULT_SEARCH_OPTS.matchNumbersThreshold;
+  const digitCount = countDigits(str);
+  if (digitCount <= threshold) {
+    return opts?.matchNumbersShort ?? DEFAULT_SEARCH_OPTS.matchNumbersShort;
+  }
+  return opts?.matchNumbers ?? DEFAULT_SEARCH_OPTS.matchNumbers;
+}
 function prepareQueryTokens(queryTokenStrs) {
-  return queryTokenStrs.map((str) => {
+  return queryTokenStrs.filter((str) => {
+    if (str === "-" || str === "--" || str === "~")
+      return false;
+    return true;
+  }).map((str) => {
     let overrideMode;
     let negated = false;
     let cleanStr = str;
     if (str.length > 2 && str.startsWith("--")) {
       negated = true;
       cleanStr = str.slice(2);
+    } else if (str.length > 1 && str[0] === "-" && /^[a-z]/i.test(str[1])) {
+      negated = true;
+      cleanStr = str.slice(1);
     } else if (str.length > 1 && str.startsWith("~")) {
       negated = true;
       cleanStr = str.slice(1);
@@ -780,13 +811,16 @@ function prepareQueryTokens(queryTokenStrs) {
         cleanStr = str.slice(1);
       }
     }
-    return {
+    const result = {
       str: cleanStr,
       id: findTokenId(cleanStr),
-      isNumeric: RE_NUMERIC.test(cleanStr),
-      overrideMode,
-      negated: negated || undefined
+      isNumeric: RE_NUMERIC.test(cleanStr)
     };
+    if (overrideMode)
+      result.overrideMode = overrideMode;
+    if (negated)
+      result.negated = true;
+    return result;
   });
 }
 function matchWithModeNumeric(searchTokenId, searchTokenStr, targetTokenEncoded, opts, overrideMode) {
@@ -801,8 +835,8 @@ function matchWithModeNumeric(searchTokenId, searchTokenStr, targetTokenEncoded,
   } else if (hasExplicitMode) {
     mode = decodeMatchMode(targetTokenEncoded);
   } else {
-    const isNumeric = RE_NUMERIC.test(searchTokenStr);
-    mode = isNumeric ? opts?.matchNumbers ?? DEFAULT_SEARCH_OPTS.matchNumbers : opts?.matchWords ?? DEFAULT_SEARCH_OPTS.matchWords;
+    const isTargetNumeric = RE_NUMERIC.test(targetTokenStr);
+    mode = isTargetNumeric ? getNumericMatchMode(targetTokenStr, opts) : opts?.matchWords ?? DEFAULT_SEARCH_OPTS.matchWords;
   }
   switch (mode) {
     case "start":
@@ -837,9 +871,8 @@ function binarySearchUint32(arr, target) {
   return false;
 }
 function matchPreparedTokenInSortedList(preparedToken, targetTokens, opts) {
-  const { str: searchTokenStr, id: searchTokenId, isNumeric, overrideMode } = preparedToken;
-  const effectiveMode = overrideMode ?? (isNumeric ? opts?.matchNumbers ?? DEFAULT_SEARCH_OPTS.matchNumbers : opts?.matchWords ?? DEFAULT_SEARCH_OPTS.matchWords);
-  if (effectiveMode === "whole" && searchTokenId !== -1) {
+  const { str: searchTokenStr, id: searchTokenId, overrideMode, negated } = preparedToken;
+  if (overrideMode === "whole" && searchTokenId !== -1) {
     let hasEncodedTokens = false;
     for (let i = 0;i < targetTokens.length; i++) {
       if (targetTokens[i] > TOKEN_ID_MASK) {
@@ -856,47 +889,36 @@ function matchPreparedTokenInSortedList(preparedToken, targetTokens, opts) {
     if (matchWithModeNumeric(searchTokenId, searchTokenStr, targetEncoded, opts, overrideMode)) {
       return true;
     }
+    if (negated) {
+      const targetTokenId = decodeTokenId(targetEncoded);
+      const targetTokenStr = tokens[targetTokenId];
+      if (targetTokenStr) {
+        const hasExplicitMode = targetEncoded !== targetTokenId;
+        let targetMode;
+        if (overrideMode) {
+          targetMode = overrideMode;
+        } else if (hasExplicitMode) {
+          targetMode = decodeMatchMode(targetEncoded);
+        } else {
+          const isTargetNumeric = RE_NUMERIC.test(targetTokenStr);
+          targetMode = isTargetNumeric ? getNumericMatchMode(targetTokenStr, opts) : opts?.matchWords ?? DEFAULT_SEARCH_OPTS.matchWords;
+        }
+        if ((targetMode === "start" || targetMode === "startEnd") && searchTokenStr.startsWith(targetTokenStr)) {
+          return true;
+        }
+      }
+    }
   }
   return false;
 }
 function matchTokenInSortedListNumeric(searchTokenStr, targetTokens, opts) {
-  let overrideMode;
-  let negated = false;
-  let cleanStr = searchTokenStr;
-  if (searchTokenStr.length > 2 && searchTokenStr.startsWith("--")) {
-    negated = true;
-    cleanStr = searchTokenStr.slice(2);
-  } else if (searchTokenStr.length > 1 && searchTokenStr.startsWith("~")) {
-    negated = true;
-    cleanStr = searchTokenStr.slice(1);
-  } else if (searchTokenStr.length > 3 && searchTokenStr.startsWith("...")) {
-    overrideMode = "end";
-    cleanStr = searchTokenStr.slice(3);
-  } else if (searchTokenStr.length > 2 && searchTokenStr.startsWith("..")) {
-    overrideMode = "end";
-    cleanStr = searchTokenStr.slice(2);
-  } else if (searchTokenStr.length > 3 && searchTokenStr.endsWith("...")) {
-    overrideMode = "start";
-    cleanStr = searchTokenStr.slice(0, -3);
-  } else if (searchTokenStr.length > 2 && searchTokenStr.endsWith("..")) {
-    overrideMode = "start";
-    cleanStr = searchTokenStr.slice(0, -2);
-  } else if (searchTokenStr.length > 1) {
-    const firstChar = searchTokenStr[0];
-    if (firstChar && PREFIX_TO_MATCH_MODE[firstChar]) {
-      overrideMode = PREFIX_TO_MATCH_MODE[firstChar];
-      cleanStr = searchTokenStr.slice(1);
-    }
-  }
-  const preparedToken = {
-    str: cleanStr,
-    id: findTokenId(cleanStr),
-    isNumeric: RE_NUMERIC.test(cleanStr),
-    overrideMode,
-    negated: negated || undefined
-  };
+  const preparedTokens = prepareQueryTokens([searchTokenStr]);
+  if (preparedTokens.length === 0) {
+    return true;
+  }
+  const preparedToken = preparedTokens[0];
   const matches = matchPreparedTokenInSortedList(preparedToken, targetTokens, opts);
-  return negated ? !matches : matches;
+  return preparedToken.negated ? !matches : matches;
 }
 function allPreparedTokensMatch(preparedTokens, targetTokens, opts) {
   for (const preparedToken of preparedTokens) {
@@ -918,18 +940,7 @@ function allTokensMatchNumeric(searchTokenStrs, targetTokens, opts) {
 
 // src/common/numeric/searchInData.ts
 function searchInDataReturnIdsNumeric(query, metadata, opts) {
-  const queryTokenStrs = prepareStringForSearch(query);
-  if (queryTokenStrs.length === 0) {
-    return [];
-  }
-  const preparedTokens = prepareQueryTokens(queryTokenStrs);
-  const results = [];
-  for (const [id, targetTokens] of metadata) {
-    if (allPreparedTokensMatch(preparedTokens, targetTokens, opts)) {
-      results.push(id);
-    }
-  }
-  return results;
+  return searchInDataReturnIdsWithLimitNumeric(query, metadata, Infinity, opts);
 }
 function searchInDataReturnObjectsNumeric(query, metadata, data, opts) {
   const ids = searchInDataReturnIdsNumeric(query, metadata, opts);
@@ -963,7 +974,7 @@ function searchInDataReturnIdsWithLimitNumeric(query, metadata, limit, opts) {
 function findInLinkedArraysNumeric(query, linked, limit = 10, opts) {
   const queryTokenStrs = prepareStringForSearch(query);
   if (queryTokenStrs.length === 0) {
-    return { queryTokens: queryTokenStrs, results: [] };
+    return { queryTokens: queryTokenStrs, results: [], hasNegation: false };
   }
   const preparedTokens = prepareQueryTokens(queryTokenStrs);
   const positiveTokens = preparedTokens.filter((t) => !t.negated);
@@ -1061,7 +1072,7 @@ function findInLinkedArraysNumeric(query, linked, limit = 10, opts) {
       });
     }
   }
-  return { queryTokens: queryTokenStrs, results };
+  return { queryTokens: queryTokenStrs, results, hasNegation: negatedTokens.length > 0 };
 }
 function findInLinkedArraysSimpleNumeric(query, linked, limit = 10, opts) {
   return findInLinkedArraysNumeric(query, linked, limit, opts).results;
@@ -1253,8 +1264,9 @@ function findInArray(query, data, metadata, limit = 10, opts) {
 // src/common/findInLinkedArrays.ts
 function findInLinkedArrays(query, linked, limit = 10, opts) {
   const queryTokens = prepareStringForSearch(query);
+  const hasNegation = queryTokens.some((t) => t.startsWith("--") || t.startsWith("~") || t.length > 1 && t[0] === "-" && /^[a-z]/i.test(t[1]));
   if (queryTokens.length === 0) {
-    return { queryTokens, results: [] };
+    return { queryTokens, results: [], hasNegation: false };
   }
   const results = [];
   for (const [primaryId, primary] of linked.primaryData) {
@@ -1307,7 +1319,7 @@ function findInLinkedArrays(query, linked, limit = 10, opts) {
       });
     }
   }
-  return { queryTokens, results };
+  return { queryTokens, results, hasNegation };
 }
 function findInLinkedArraysSimple(query, linked, limit = 10, opts) {
   return findInLinkedArrays(query, linked, limit, opts).results;
@@ -1779,7 +1791,7 @@ class SearchUniverse {
         const linkedSearchResults = findInLinkedArraysNumeric(query, linkedMetadata, limit, searchOpts);
         if (linkedSearchResults.results.length > 0) {
           const combinedResults = [];
-          const hasNegation = query.includes("--");
+          const hasNegation = linkedSearchResults.hasNegation;
           for (const result of linkedSearchResults.results) {
             let linkedItems = result.linked;
             if (result.matchedIn === "primary" && !hasNegation) {

package/dist/index.js

@@ -1,7 +1,9 @@
 // src/types/index.ts
 var DEFAULT_SEARCH_OPTS = {
   matchWords: "start",
-  matchNumbers: "startEnd"
+  matchNumbers: "startEnd",
+  matchNumbersShort: "whole",
+  matchNumbersThreshold: 6
 };
 function arrayToSearchableData(items) {
   const map = new Map;
@@ -129,7 +131,7 @@ function preprocessString(input) {
 
 // src/utils/sanitiseString.ts
 var RE_DIACRITICS = /[\u0300-\u036f]/g;
-var RE_INVALID_CHARS = /[^a-z0-9.\- ]/g;
+var RE_INVALID_CHARS = /[^a-z0-9.\-~<>+*!=? ]/g;
 function sanitiseString(input) {
   let result = input;
   result = result.toLowerCase();
@@ -173,11 +175,16 @@ function tokenize(input, config) {
   let tokens = input.split(" ").map((token) => token.trim()).filter((token) => token.length > 0);
   if (config?.replaceTokens) {
     tokens = tokens.map((token) => {
-      if (token.startsWith("--") && token.length > 2) {
+      if (token.length > 2 && token.startsWith("--")) {
         const withoutPrefix = token.slice(2);
         const replaced = config.replaceTokens.get(withoutPrefix);
         return replaced ? "--" + replaced : token;
       }
+      if (token.length > 1 && token[0] === "-" && /^[a-z]/i.test(token[1])) {
+        const withoutPrefix = token.slice(1);
+        const replaced = config.replaceTokens.get(withoutPrefix);
+        return replaced ? "-" + replaced : token;
+      }
       return config.replaceTokens.get(token) ?? token;
     });
   }
@@ -646,14 +653,38 @@ function removeFromSearchMetadataBatchNumeric(metadata, objectIds) {
 }
 // src/utils/matchTokenNumeric.ts
 var RE_NUMERIC = /^[\d.\-]+$/;
+function countDigits(str) {
+  let count = 0;
+  for (let i = 0;i < str.length; i++) {
+    const c = str[i];
+    if (c !== "." && c !== "-")
+      count++;
+  }
+  return count;
+}
+function getNumericMatchMode(str, opts) {
+  const threshold = opts?.matchNumbersThreshold ?? DEFAULT_SEARCH_OPTS.matchNumbersThreshold;
+  const digitCount = countDigits(str);
+  if (digitCount <= threshold) {
+    return opts?.matchNumbersShort ?? DEFAULT_SEARCH_OPTS.matchNumbersShort;
+  }
+  return opts?.matchNumbers ?? DEFAULT_SEARCH_OPTS.matchNumbers;
+}
 function prepareQueryTokens(queryTokenStrs) {
-  return queryTokenStrs.map((str) => {
+  return queryTokenStrs.filter((str) => {
+    if (str === "-" || str === "--" || str === "~")
+      return false;
+    return true;
+  }).map((str) => {
     let overrideMode;
     let negated = false;
     let cleanStr = str;
     if (str.length > 2 && str.startsWith("--")) {
       negated = true;
       cleanStr = str.slice(2);
+    } else if (str.length > 1 && str[0] === "-" && /^[a-z]/i.test(str[1])) {
+      negated = true;
+      cleanStr = str.slice(1);
     } else if (str.length > 1 && str.startsWith("~")) {
       negated = true;
       cleanStr = str.slice(1);
@@ -676,13 +707,16 @@ function prepareQueryTokens(queryTokenStrs) {
         cleanStr = str.slice(1);
       }
     }
-    return {
+    const result = {
       str: cleanStr,
       id: findTokenId(cleanStr),
-      isNumeric: RE_NUMERIC.test(cleanStr),
-      overrideMode,
-      negated: negated || undefined
+      isNumeric: RE_NUMERIC.test(cleanStr)
     };
+    if (overrideMode)
+      result.overrideMode = overrideMode;
+    if (negated)
+      result.negated = true;
+    return result;
   });
 }
 function matchWithModeNumeric(searchTokenId, searchTokenStr, targetTokenEncoded, opts, overrideMode) {
@@ -697,8 +731,8 @@ function matchWithModeNumeric(searchTokenId, searchTokenStr, targetTokenEncoded,
   } else if (hasExplicitMode) {
     mode = decodeMatchMode(targetTokenEncoded);
   } else {
-    const isNumeric = RE_NUMERIC.test(searchTokenStr);
-    mode = isNumeric ? opts?.matchNumbers ?? DEFAULT_SEARCH_OPTS.matchNumbers : opts?.matchWords ?? DEFAULT_SEARCH_OPTS.matchWords;
+    const isTargetNumeric = RE_NUMERIC.test(targetTokenStr);
+    mode = isTargetNumeric ? getNumericMatchMode(targetTokenStr, opts) : opts?.matchWords ?? DEFAULT_SEARCH_OPTS.matchWords;
   }
   switch (mode) {
     case "start":
@@ -733,9 +767,8 @@ function binarySearchUint32(arr, target) {
   return false;
 }
 function matchPreparedTokenInSortedList(preparedToken, targetTokens, opts) {
-  const { str: searchTokenStr, id: searchTokenId, isNumeric, overrideMode } = preparedToken;
-  const effectiveMode = overrideMode ?? (isNumeric ? opts?.matchNumbers ?? DEFAULT_SEARCH_OPTS.matchNumbers : opts?.matchWords ?? DEFAULT_SEARCH_OPTS.matchWords);
-  if (effectiveMode === "whole" && searchTokenId !== -1) {
+  const { str: searchTokenStr, id: searchTokenId, overrideMode, negated } = preparedToken;
+  if (overrideMode === "whole" && searchTokenId !== -1) {
     let hasEncodedTokens = false;
     for (let i = 0;i < targetTokens.length; i++) {
       if (targetTokens[i] > TOKEN_ID_MASK) {
@@ -752,47 +785,36 @@ function matchPreparedTokenInSortedList(preparedToken, targetTokens, opts) {
     if (matchWithModeNumeric(searchTokenId, searchTokenStr, targetEncoded, opts, overrideMode)) {
       return true;
     }
+    if (negated) {
+      const targetTokenId = decodeTokenId(targetEncoded);
+      const targetTokenStr = tokens[targetTokenId];
+      if (targetTokenStr) {
+        const hasExplicitMode = targetEncoded !== targetTokenId;
+        let targetMode;
+        if (overrideMode) {
+          targetMode = overrideMode;
+        } else if (hasExplicitMode) {
+          targetMode = decodeMatchMode(targetEncoded);
+        } else {
+          const isTargetNumeric = RE_NUMERIC.test(targetTokenStr);
+          targetMode = isTargetNumeric ? getNumericMatchMode(targetTokenStr, opts) : opts?.matchWords ?? DEFAULT_SEARCH_OPTS.matchWords;
+        }
+        if ((targetMode === "start" || targetMode === "startEnd") && searchTokenStr.startsWith(targetTokenStr)) {
+          return true;
+        }
+      }
+    }
   }
   return false;
 }
 function matchTokenInSortedListNumeric(searchTokenStr, targetTokens, opts) {
-  let overrideMode;
-  let negated = false;
-  let cleanStr = searchTokenStr;
-  if (searchTokenStr.length > 2 && searchTokenStr.startsWith("--")) {
-    negated = true;
-    cleanStr = searchTokenStr.slice(2);
-  } else if (searchTokenStr.length > 1 && searchTokenStr.startsWith("~")) {
-    negated = true;
-    cleanStr = searchTokenStr.slice(1);
-  } else if (searchTokenStr.length > 3 && searchTokenStr.startsWith("...")) {
-    overrideMode = "end";
-    cleanStr = searchTokenStr.slice(3);
-  } else if (searchTokenStr.length > 2 && searchTokenStr.startsWith("..")) {
-    overrideMode = "end";
-    cleanStr = searchTokenStr.slice(2);
-  } else if (searchTokenStr.length > 3 && searchTokenStr.endsWith("...")) {
-    overrideMode = "start";
-    cleanStr = searchTokenStr.slice(0, -3);
-  } else if (searchTokenStr.length > 2 && searchTokenStr.endsWith("..")) {
-    overrideMode = "start";
-    cleanStr = searchTokenStr.slice(0, -2);
-  } else if (searchTokenStr.length > 1) {
-    const firstChar = searchTokenStr[0];
-    if (firstChar && PREFIX_TO_MATCH_MODE[firstChar]) {
-      overrideMode = PREFIX_TO_MATCH_MODE[firstChar];
-      cleanStr = searchTokenStr.slice(1);
-    }
-  }
-  const preparedToken = {
-    str: cleanStr,
-    id: findTokenId(cleanStr),
-    isNumeric: RE_NUMERIC.test(cleanStr),
-    overrideMode,
-    negated: negated || undefined
-  };
+  const preparedTokens = prepareQueryTokens([searchTokenStr]);
+  if (preparedTokens.length === 0) {
+    return true;
+  }
+  const preparedToken = preparedTokens[0];
   const matches = matchPreparedTokenInSortedList(preparedToken, targetTokens, opts);
-  return negated ? !matches : matches;
+  return preparedToken.negated ? !matches : matches;
 }
 function allPreparedTokensMatch(preparedTokens, targetTokens, opts) {
   for (const preparedToken of preparedTokens) {
@@ -814,18 +836,7 @@ function allTokensMatchNumeric(searchTokenStrs, targetTokens, opts) {
 
 // src/common/numeric/searchInData.ts
 function searchInDataReturnIdsNumeric(query, metadata, opts) {
-  const queryTokenStrs = prepareStringForSearch(query);
-  if (queryTokenStrs.length === 0) {
-    return [];
-  }
-  const preparedTokens = prepareQueryTokens(queryTokenStrs);
-  const results = [];
-  for (const [id, targetTokens] of metadata) {
-    if (allPreparedTokensMatch(preparedTokens, targetTokens, opts)) {
-      results.push(id);
-    }
-  }
-  return results;
+  return searchInDataReturnIdsWithLimitNumeric(query, metadata, Infinity, opts);
 }
 function searchInDataReturnObjectsNumeric(query, metadata, data, opts) {
   const ids = searchInDataReturnIdsNumeric(query, metadata, opts);
@@ -859,7 +870,7 @@ function searchInDataReturnIdsWithLimitNumeric(query, metadata, limit, opts) {
 function findInLinkedArraysNumeric(query, linked, limit = 10, opts) {
   const queryTokenStrs = prepareStringForSearch(query);
   if (queryTokenStrs.length === 0) {
-    return { queryTokens: queryTokenStrs, results: [] };
+    return { queryTokens: queryTokenStrs, results: [], hasNegation: false };
   }
   const preparedTokens = prepareQueryTokens(queryTokenStrs);
   const positiveTokens = preparedTokens.filter((t) => !t.negated);
@@ -957,7 +968,7 @@ function findInLinkedArraysNumeric(query, linked, limit = 10, opts) {
       });
     }
   }
-  return { queryTokens: queryTokenStrs, results };
+  return { queryTokens: queryTokenStrs, results, hasNegation: negatedTokens.length > 0 };
 }
 function findInLinkedArraysSimpleNumeric(query, linked, limit = 10, opts) {
   return findInLinkedArraysNumeric(query, linked, limit, opts).results;
@@ -1149,8 +1160,9 @@ function findInArray(query, data, metadata, limit = 10, opts) {
 // src/common/findInLinkedArrays.ts
 function findInLinkedArrays(query, linked, limit = 10, opts) {
   const queryTokens = prepareStringForSearch(query);
+  const hasNegation = queryTokens.some((t) => t.startsWith("--") || t.startsWith("~") || t.length > 1 && t[0] === "-" && /^[a-z]/i.test(t[1]));
   if (queryTokens.length === 0) {
-    return { queryTokens, results: [] };
+    return { queryTokens, results: [], hasNegation: false };
   }
   const results = [];
   for (const [primaryId, primary] of linked.primaryData) {
@@ -1203,7 +1215,7 @@ function findInLinkedArrays(query, linked, limit = 10, opts) {
       });
     }
   }
-  return { queryTokens, results };
+  return { queryTokens, results, hasNegation };
 }
 function findInLinkedArraysSimple(query, linked, limit = 10, opts) {
   return findInLinkedArrays(query, linked, limit, opts).results;
@@ -1675,7 +1687,7 @@ class SearchUniverse {
         const linkedSearchResults = findInLinkedArraysNumeric(query, linkedMetadata, limit, searchOpts);
         if (linkedSearchResults.results.length > 0) {
           const combinedResults = [];
-          const hasNegation = query.includes("--");
+          const hasNegation = linkedSearchResults.hasNegation;
           for (const result of linkedSearchResults.results) {
             let linkedItems = result.linked;
             if (result.matchedIn === "primary" && !hasNegation) {

package/dist/types/index.d.ts

@@ -54,7 +54,11 @@ export interface SearchableObjectSpec<T extends SearchableObject, C = unknown> {
     fieldMatchModes?: Partial<Record<keyof T, MatchMode>>;
 }
 /**
- * Options for controlling how search matching works
+ * Options for controlling how search matching works.
+ *
+ * **Important:** Match mode for numbers is determined by the TARGET token's length,
+ * not the search query's length. This allows short codes (e.g., "9001") to require
+ * exact match while long barcodes (e.g., "3838989760731") allow prefix/suffix matching.
  */
 export interface SearchOpts {
     /**
@@ -63,10 +67,21 @@ export interface SearchOpts {
      */
     matchWords?: MatchMode;
     /**
-     * How to match numbers (numeric tokens)
+     * How to match long numbers (more digits than matchNumbersThreshold)
      * @default 'startEnd'
      */
     matchNumbers?: MatchMode;
+    /**
+     * How to match short numbers (digits <= matchNumbersThreshold)
+     * @default 'whole'
+     */
+    matchNumbersShort?: MatchMode;
+    /**
+     * Threshold for short vs long number matching (count of digits, excluding . and -)
+     * Numbers with <= this many digits use matchNumbersShort, otherwise matchNumbers
+     * @default 6
+     */
+    matchNumbersThreshold?: number;
 }
 /** Default search options */
 export declare const DEFAULT_SEARCH_OPTS: Required<SearchOpts>;
@@ -125,7 +140,8 @@ export interface LinkedSearchResult<TPrimary, TLinked> {
 /**
  * Result of a linked search with query metadata.
  *
- * Includes the tokenized query for debugging/highlighting purposes.
+ * Includes the tokenized query for debugging/highlighting purposes,
+ * and a flag indicating whether the query contained negation tokens.
  *
  * @typeParam TPrimary - Type of primary items (e.g., Stranka)
  * @typeParam TLinked - Type of linked items (e.g., Pacient)
@@ -135,6 +151,8 @@ export interface LinkedSearchResultWithMeta<TPrimary, TLinked> {
     queryTokens: SearchTokenSortedList;
     /** Array of matching results */
     results: LinkedSearchResult<TPrimary, TLinked>[];
+    /** Whether the query contains negated tokens (--word, -word, ~word) */
+    hasNegation: boolean;
 }
 /**
  * Result of a search operation with metadata included.

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"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"}

package/dist/utils/matchTokenNumeric.d.ts

@@ -12,6 +12,14 @@ export interface PreparedQueryToken {
     /** If true, this token must NOT appear in the target (negation with -- or ~ prefix) */
     negated?: boolean;
 }
+/**
+ * Checks if any prepared tokens have negation.
+ * Use this to determine if negation filtering should be applied.
+ *
+ * @param preparedTokens - Array of prepared tokens
+ * @returns True if any token is negated
+ */
+export declare function hasNegatedTokens(preparedTokens: PreparedQueryToken[]): boolean;
 /**
  * Prepares query tokens by pre-computing their IDs.
  * Call this ONCE at the start of a search to avoid repeated findTokenId calls.
@@ -23,7 +31,9 @@ export interface PreparedQueryToken {
  * - `+word` = startEnd (prefix or suffix)
  * - `*word` or `?word` = anywhere (substring match)
  * - `word..` = start (prefix match, suffix notation)
- * - `--word` or `~word` = negation (token must NOT appear)
+ * - `-word` or `~word` = negation (token must NOT appear, only if followed by letter)
+ *
+ * Bare prefix tokens (e.g., just `-` or `~` without a word) are filtered out.
  *
  * @param queryTokenStrs - Array of query token strings
  * @returns Array of prepared tokens with pre-computed IDs
@@ -41,6 +51,11 @@ export declare function binarySearchUint32(arr: Uint32Array, target: number): bo
  * Checks if a prepared search token matches any token in a sorted numeric list.
  * Uses pre-computed token ID for efficiency.
  *
+ * For negated tokens with prefix modes (start/startEnd), also checks if the search
+ * token starts with the target token (reverse check). This handles cases where
+ * stored tokens are shortened versions (e.g., "izdelek" → "izd"), so searching
+ * "--izde" correctly matches and excludes items with "izd".
+ *
  * @param preparedToken - The prepared token with pre-computed ID
  * @param targetTokens - Sorted Uint32Array of target token IDs
  * @param opts - Optional search options for match mode
@@ -59,7 +74,7 @@ export declare function matchPreparedTokenInSortedList(preparedToken: PreparedQu
  * - `+word` = startEnd
  * - `*word` or `?word` = anywhere
  * - `word..` = start
- * - `--word` or `~word` = negation (returns true if NOT found)
+ * - `-word` or `~word` = negation (returns true if NOT found)
  *
  * @param searchTokenStr - The string token to search for (may include prefix/suffix)
  * @param targetTokens - Sorted Uint32Array of target token IDs

package/dist/utils/matchTokenNumeric.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"matchTokenNumeric.d.ts","sourceRoot":"","sources":["../../src/utils/matchTokenNumeric.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,sBAAsB,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAS9E;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,OAAO,CAAC;IACnB,6EAA6E;IAC7E,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,uFAAuF;IACvF,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,CAAC,cAAc,EAAE,MAAM,EAAE,GAAG,kBAAkB,EAAE,CAoDjF;AAmED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAiB5E;AAED;;;;;;;;GAQG;AACH,wBAAgB,8BAA8B,CAC5C,aAAa,EAAE,kBAAkB,EACjC,YAAY,EAAE,sBAAsB,EACpC,IAAI,CAAC,EAAE,UAAU,GAChB,OAAO,CAmCT;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,6BAA6B,CAC3C,cAAc,EAAE,MAAM,EACtB,YAAY,EAAE,sBAAsB,EACpC,IAAI,CAAC,EAAE,UAAU,GAChB,OAAO,CAsDT;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CACpC,cAAc,EAAE,kBAAkB,EAAE,EACpC,YAAY,EAAE,sBAAsB,EACpC,IAAI,CAAC,EAAE,UAAU,GAChB,OAAO,CAYT;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACnC,eAAe,EAAE,MAAM,EAAE,EACzB,YAAY,EAAE,sBAAsB,EACpC,IAAI,CAAC,EAAE,UAAU,GAChB,OAAO,CAGT"}
+{"version":3,"file":"matchTokenNumeric.d.ts","sourceRoot":"","sources":["../../src/utils/matchTokenNumeric.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,sBAAsB,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAiC9E;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,OAAO,CAAC;IACnB,6EAA6E;IAC7E,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,uFAAuF;IACvF,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,cAAc,EAAE,kBAAkB,EAAE,GAAG,OAAO,CAE9E;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,kBAAkB,CAAC,cAAc,EAAE,MAAM,EAAE,GAAG,kBAAkB,EAAE,CA8DjF;AAoED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAiB5E;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,8BAA8B,CAC5C,aAAa,EAAE,kBAAkB,EACjC,YAAY,EAAE,sBAAsB,EACpC,IAAI,CAAC,EAAE,UAAU,GAChB,OAAO,CA4DT;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,6BAA6B,CAC3C,cAAc,EAAE,MAAM,EACtB,YAAY,EAAE,sBAAsB,EACpC,IAAI,CAAC,EAAE,UAAU,GAChB,OAAO,CAaT;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CACpC,cAAc,EAAE,kBAAkB,EAAE,EACpC,YAAY,EAAE,sBAAsB,EACpC,IAAI,CAAC,EAAE,UAAU,GAChB,OAAO,CAYT;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACnC,eAAe,EAAE,MAAM,EAAE,EACzB,YAAY,EAAE,sBAAsB,EACpC,IAAI,CAAC,EAAE,UAAU,GAChB,OAAO,CAGT"}

package/dist/utils/sanitiseString.d.ts

@@ -4,7 +4,8 @@
  * Processing steps:
  * 1. Converts to lowercase (case-insensitive search)
  * 2. Removes diacritics using Unicode normalization (č,ć → c, š → s, etc.)
- * 3. Keeps only letters (a-z), digits (0-9), periods (.), minuses (-), and spaces
+ * 3. Keeps only letters (a-z), digits (0-9), periods (.), minuses (-), tildes (~),
+ *    query prefixes (<, >, +, *, !, =, ?), and spaces
  * 4. Replaces all other characters with space
  *
  * @param input - The preprocessed string to sanitise
@@ -12,14 +13,17 @@
  *
  * @example
  * ```typescript
- * sanitiseString('Čokolada Milka!')
- * // Returns: 'cokolada milka '
+ * sanitiseString('Čokolada Milka')
+ * // Returns: 'cokolada milka'
  *
  * sanitiseString('Žaba ČAČA')
  * // Returns: 'zaba caca'
  *
  * sanitiseString('price: $12.50')
  * // Returns: 'price  12.50'
+ *
+ * sanitiseString('=exact ~negate')
+ * // Returns: '=exact ~negate' (query prefixes preserved)
  * ```
  */
 export declare function sanitiseString(input: string): string;

package/dist/utils/sanitiseString.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sanitiseString.d.ts","sourceRoot":"","sources":["../../src/utils/sanitiseString.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAepD"}
+{"version":3,"file":"sanitiseString.d.ts","sourceRoot":"","sources":["../../src/utils/sanitiseString.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAepD"}

package/dist/utils/tokenize.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tokenize.d.ts","sourceRoot":"","sources":["../../src/utils/tokenize.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,8CAA8C;IAC9C,aAAa,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,8BAA8B;IAC9B,YAAY,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC3B;;;;OAIG;IACH,SAAS,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAED,kDAAkD;AAClD,eAAO,MAAM,sBAAsB,qBAcjC,CAAC;AAEH,0EAA0E;AAC1E,eAAO,MAAM,qBAAqB,aAUhC,CAAC;AAEH,0EAA0E;AAC1E,eAAO,MAAM,uBAAuB,EAAE,cAGrC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,cAAc,GAAG,MAAM,EAAE,CAuBzE"}
+{"version":3,"file":"tokenize.d.ts","sourceRoot":"","sources":["../../src/utils/tokenize.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,8CAA8C;IAC9C,aAAa,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,8BAA8B;IAC9B,YAAY,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC3B;;;;OAIG;IACH,SAAS,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAED,kDAAkD;AAClD,eAAO,MAAM,sBAAsB,qBAcjC,CAAC;AAEH,0EAA0E;AAC1E,eAAO,MAAM,qBAAqB,aAUhC,CAAC;AAEH,0EAA0E;AAC1E,eAAO,MAAM,uBAAuB,EAAE,cAGrC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,cAAc,GAAG,MAAM,EAAE,CA6BzE"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cry-search",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "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",