witness

witness(a, b, opts?): string | null

An example path common to both sets (turns “overlap” into “overlap at X”), or null when disjoint.

Parameters

Parameter	Type	Description
a	Patterns	The first pattern-set (Patterns).
b	Patterns	The second pattern-set (Patterns).
opts?	Options	Matching semantics (Options); defaults apply when omitted.

Returns

string | null

A concrete path matching both sets, or null if none exists.

Example

witness("src/api/**", "src/api/handler.ts"); // "src/api/handler.ts" — a path both match
witness("src/api/**", "src/web/**");         // null                 — no common path