@wirecat/cli-base 0.48.0 → 0.49.0

package/CHANGELOG.md

@@ -8,6 +8,16 @@ Versions before 0.8.0 are in the [git tags](https://github.com/WireCatLabs/cli-b
 Every entry says what changed as a caller sees it, why, and what to watch for — the rules are
 [`docs/dev/CONVENTIONS.md`](docs/dev/CONVENTIONS.md#the-changelog).
 
+## 0.49.0 — 21.10.2026
+
+### Added
+
+- **`parseLucene` can read a phrase's distance.** With `{ proximity: true }`, `"a b"~3` parses as a phrase predicate
+  with `slop: 3`, and `queryNodeSchema` accepts `slop`. Meeting search needs it for words spread over neighbouring
+  transcript lines, and a caller that turns it on says what the number counts. Without the option `~` is still
+  `query.unsupported-operator`, so messages and lists see no change. A distance that is not a whole number is
+  `query.invalid-syntax`; `word~2` (fuzzy) stays unsupported either way.
+
 ## 0.48.0 — 21.10.2026
 
 ### Changed — may break callers

package/dist/query/parser.d.ts

@@ -2,7 +2,9 @@ import { type QueryAst, type QueryContext } from "./types.js";
 export interface ParseOptions extends QueryContext {
     /** The field a bare word searches; `none` for a list, where a bare word is `query.bare-word`. */
     defaultField?: string;
+    /** Read `"a b"~N` as a phrase with `slop: N`; a caller that turns it on says what N counts. */
+    proximity?: boolean;
 }
-export declare const parseLucene: (text: string, { defaultField, ...context }?: ParseOptions) => QueryAst;
+export declare const parseLucene: (text: string, { defaultField, proximity, ...context }?: ParseOptions) => QueryAst;
 /** Bare terms eligible for forgiving retrieval; explicit syntax keeps strict semantics. */
 export declare const implicitTextTerms: (text: string) => Set<number>;

package/dist/query/parser.js

@@ -141,7 +141,7 @@ const regexHint = (text, at) => {
     const word = `${/[^\s()"]*$/u.exec(text.slice(0, at))?.[0] ?? ""}${/^[^\s()"]*/u.exec(text.slice(at))?.[0] ?? ""}`;
     return quoteHint(text, at) ?? `/ starts a regular expression; put the value in quotes: "${word}"`;
 };
-export const parseLucene = (text, { defaultField = "text", ...context } = {}) => {
+export const parseLucene = (text, { defaultField = "text", proximity = false, ...context } = {}) => {
     const fail = (reason, span, alternative) => queryError(reason, span, alternative ?? quoteHint(text, span.start), context);
     if (text.length > QUERY_LIMITS.bytes || new TextEncoder().encode(text).length > QUERY_LIMITS.bytes)
         fail("query.too-large", { start: 0, end: text.length });
@@ -290,6 +290,13 @@ export const parseLucene = (text, { defaultField = "text", ...context } = {}) =>
                 ...(implicit ? { implicit: true } : {}),
             });
         }
+        if (proximity && peek().kind === "~" && node.kind === "predicate" && node.operator === "phrase") {
+            take();
+            const distance = take();
+            if (distance.kind !== "number" || !/^\d+$/u.test(distance.raw))
+                fail("query.invalid-syntax", distance.span, 'write the distance as a whole number: "a b"~3');
+            node = { ...node, slop: Number(distance.raw), span: { start: node.span.start, end: distance.span.end } };
+        }
         if (peek().kind === "~")
             fail("query.unsupported-operator", peek().span, node.kind === "predicate" && node.operator === "phrase"
                 ? "proximity (~) is not supported — drop the ~ for the exact phrase, or join the words with AND"

package/dist/query/types.d.ts

@@ -21,6 +21,8 @@ export interface Predicate {
     span: Span;
     /** A bare word, under no field. */
     implicit?: true;
+    /** `"a b"~N`, read only when the parser is asked to: how far apart the phrase's words may be. */
+    slop?: number;
 }
 export type QueryNode = Predicate | {
     kind: "boolean";

package/dist/query/types.js

@@ -16,6 +16,7 @@ const predicateSchema = v.object({
     upper_inclusive: v.optional(v.boolean()),
     span: spanSchema,
     implicit: v.optional(v.literal(true)),
+    slop: v.optional(v.pipe(v.number(), v.integer(), v.minValue(0))),
 });
 export const queryNodeSchema = v.variant("kind", [
     predicateSchema,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wirecat/cli-base",
-  "version": "0.48.0",
+  "version": "0.49.0",
   "description": "The parts every command line tool needs: output modes, terminal rendering, error model, exit codes, credentials, clocks",
   "license": "Apache-2.0",
   "author": "Viacheslav Ptsarev",