find-matching-bracket

Find matching bracket in Js/Ts/Cs code (including string Template literals interpolation)

/**
 * if throwErrors is true, it throw (stop) with info.
 * else it return matching position,
 * or:
 * -2 if startPostion don't match start bracket
 * -3 if end bracket dont match start bracket
 * -1 if cursor comes to end of code without finding maching bracket
 *
 * @param code
 * @param startPosition position for staing bracket
 * @param throwErrors default false - if true: throw error with information
 * @returns
 */
export default function matchBracket(code: string, startPosition: number, throwErrors = false): number;

matchBracket example:

const code = "{ }";
const endPosition = matchBracket(code, 0);
// endPosition = 2

Complex ex:

const code =
  "function foo(s: string) {\n" + // <- start pos 24
  "   var str = `text with repeat ${new Array(2).fill(s).map(s=>{ return s + '-{}-' }).join('')} ends here `;\n" +
  "    return { return: str }\n" +
  "}"; // <- return this position 160 (What we need to find!)

const endPosition = matchBracket(code, 24);

// endPosition = 160
const includeBoth = code.substring(24, 161); // 160+1 to include the end bracket
const excludeBoth = code.substring(25, 160); // 24+1 to exclude start bracket

Bracket that can be matchs:

${ and $" can only be matched inside string templates (js an cs templates)

Matching bracket: | name | start | end | node | |:-----|:-----:|:---:|:-----| | lineComment | // | \n | | | multilineComment | /* | */ | | | angle | < | > | | | peparentheses | ( | ) | | | square | [ | ] | | | curly | { | } | | | double | " | " | | | single | ' | ' | | | jsTemplate | ` | ` | | | cSharpTemplate | $" | " | | | escapeJsTemaple | ${ | } | only in jsTemplate | | inCSharpTemaple | { | } | only in cSharpTemplate |