massive update, probably broken
[dotfiles/.git] / .config / coc / extensions / node_modules / coc-json / node_modules / jsonc-parser / lib / esm / main.js
1 /*---------------------------------------------------------------------------------------------
2  *  Copyright (c) Microsoft Corporation. All rights reserved.
3  *  Licensed under the MIT License. See License.txt in the project root for license information.
4  *--------------------------------------------------------------------------------------------*/
5 'use strict';
6 import * as formatter from './impl/format';
7 import * as edit from './impl/edit';
8 import * as scanner from './impl/scanner';
9 import * as parser from './impl/parser';
10 /**
11  * Creates a JSON scanner on the given text.
12  * If ignoreTrivia is set, whitespaces or comments are ignored.
13  */
14 export var createScanner = scanner.createScanner;
15 /**
16  * For a given offset, evaluate the location in the JSON document. Each segment in the location path is either a property name or an array index.
17  */
18 export var getLocation = parser.getLocation;
19 /**
20  * Parses the given text and returns the object the JSON content represents. On invalid input, the parser tries to be as fault tolerant as possible, but still return a result.
21  * Therefore, always check the errors list to find out if the input was valid.
22  */
23 export var parse = parser.parse;
24 /**
25  * Parses the given text and returns a tree representation the JSON content. On invalid input, the parser tries to be as fault tolerant as possible, but still return a result.
26  */
27 export var parseTree = parser.parseTree;
28 /**
29  * Finds the node at the given path in a JSON DOM.
30  */
31 export var findNodeAtLocation = parser.findNodeAtLocation;
32 /**
33  * Finds the innermost node at the given offset. If includeRightBound is set, also finds nodes that end at the given offset.
34  */
35 export var findNodeAtOffset = parser.findNodeAtOffset;
36 /**
37  * Gets the JSON path of the given JSON DOM node
38  */
39 export var getNodePath = parser.getNodePath;
40 /**
41  * Evaluates the JavaScript object of the given JSON DOM node
42  */
43 export var getNodeValue = parser.getNodeValue;
44 /**
45  * Parses the given text and invokes the visitor functions for each object, array and literal reached.
46  */
47 export var visit = parser.visit;
48 /**
49  * Takes JSON with JavaScript-style comments and remove
50  * them. Optionally replaces every none-newline character
51  * of comments with a replaceCharacter
52  */
53 export var stripComments = parser.stripComments;
54 export function printParseErrorCode(code) {
55     switch (code) {
56         case 1 /* InvalidSymbol */: return 'InvalidSymbol';
57         case 2 /* InvalidNumberFormat */: return 'InvalidNumberFormat';
58         case 3 /* PropertyNameExpected */: return 'PropertyNameExpected';
59         case 4 /* ValueExpected */: return 'ValueExpected';
60         case 5 /* ColonExpected */: return 'ColonExpected';
61         case 6 /* CommaExpected */: return 'CommaExpected';
62         case 7 /* CloseBraceExpected */: return 'CloseBraceExpected';
63         case 8 /* CloseBracketExpected */: return 'CloseBracketExpected';
64         case 9 /* EndOfFileExpected */: return 'EndOfFileExpected';
65         case 10 /* InvalidCommentToken */: return 'InvalidCommentToken';
66         case 11 /* UnexpectedEndOfComment */: return 'UnexpectedEndOfComment';
67         case 12 /* UnexpectedEndOfString */: return 'UnexpectedEndOfString';
68         case 13 /* UnexpectedEndOfNumber */: return 'UnexpectedEndOfNumber';
69         case 14 /* InvalidUnicode */: return 'InvalidUnicode';
70         case 15 /* InvalidEscapeCharacter */: return 'InvalidEscapeCharacter';
71         case 16 /* InvalidCharacter */: return 'InvalidCharacter';
72     }
73     return '<unknown ParseErrorCode>';
74 }
75 /**
76  * Computes the edits needed to format a JSON document.
77  *
78  * @param documentText The input text
79  * @param range The range to format or `undefined` to format the full content
80  * @param options The formatting options
81  * @returns A list of edit operations describing the formatting changes to the original document. Edits can be either inserts, replacements or
82  * removals of text segments. All offsets refer to the original state of the document. No two edits must change or remove the same range of
83  * text in the original document. However, multiple edits can have
84  * the same offset, for example multiple inserts, or an insert followed by a remove or replace. The order in the array defines which edit is applied first.
85  * To apply edits to an input, you can use `applyEdits`.
86  */
87 export function format(documentText, range, options) {
88     return formatter.format(documentText, range, options);
89 }
90 /**
91  * Computes the edits needed to modify a value in the JSON document.
92  *
93  * @param documentText The input text
94  * @param path The path of the value to change. The path represents either to the document root, a property or an array item.
95  * If the path points to an non-existing property or item, it will be created.
96  * @param value The new value for the specified property or item. If the value is undefined,
97  * the property or item will be removed.
98  * @param options Options
99  * @returns A list of edit operations describing the formatting changes to the original document. Edits can be either inserts, replacements or
100  * removals of text segments. All offsets refer to the original state of the document. No two edits must change or remove the same range of
101  * text in the original document. However, multiple edits can have
102  * the same offset, for example multiple inserts, or an insert followed by a remove or replace. The order in the array defines which edit is applied first.
103  * To apply edits to an input, you can use `applyEdits`.
104  */
105 export function modify(text, path, value, options) {
106     return edit.setProperty(text, path, value, options);
107 }
108 /**
109  * Applies edits to a input string.
110  */
111 export function applyEdits(text, edits) {
112     for (var i = edits.length - 1; i >= 0; i--) {
113         text = edit.applyEdit(text, edits[i]);
114     }
115     return text;
116 }