awesome-code-frame

What is this?

This is a fork of @babel/code-frame with the latest dependencies (e.g of chalk) and exported as a pure ESM package. It uses the latest chalk, which means it requires support for package imports. If this causes problems in Jest for you, see this issue for help.

Usage

The package exports a function codeFrameColumns() which works just like @babel/code-frame although all dependent types are exported too.

1codeFrameColumns( rawLines: string, loc: NodeLocation, opts?: Options ): string;

where NodeLocation is defined as:

1interface NodeLocation {
2    start: Location;
3    end?: Location;
4}

Location as:

1interface Location {
2    column: number;
3    line: number;
4};

and Options as:

1export interface Options {
2  /**
3   * Syntax highlight the code as JavaScript for terminals. default: false
4   * */
5  highlightCode?: boolean;
6  /**
7   * The number of lines to show above the error. default: 2
8   * */
9  linesAbove?: number;
10  /**
11   * The number of lines to show below the error. default: 3
12   * */
13  linesBelow?: number;
14  /**
15   * Forcibly syntax highlight the code as JavaScript (for non-terminals);
16   * overrides highlightCode.
17   * default: false
18   */
19  forceColor?: boolean;
20  /**
21   * Pass in a string to be displayed inline (if possible) next to the
22   * highlighted location in the code. If it can't be positioned inline,
23   * it will be placed above the code frame.
24   * default: nothing
25   */
26  message?: string;
27}