find-matching-bracket

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

``ts
/**
* 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:

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

Complex ex:

`ts
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 |