vscode-json-languageservice 3.4.12 → 3.7.0

package/lib/esm/services/jsonHover.js

@@ -45,11 +45,11 @@ var JSONHover = /** @class */ (function () {
             }
         }
         return this.schemaService.getSchemaForResource(document.uri, doc).then(function (schema) {
-            if (schema) {
+            if (schema && node) {
                 var matchingSchemas = doc.getMatchingSchemas(schema.schema, node.offset);
-                var title_1 = null;
-                var markdownDescription_1 = null;
-                var markdownEnumValueDescription_1 = null, enumValue_1 = null;
+                var title_1 = undefined;
+                var markdownDescription_1 = undefined;
+                var markdownEnumValueDescription_1 = undefined, enumValue_1 = undefined;
                 matchingSchemas.every(function (s) {
                     if (s.node === node && !s.inverted && s.schema) {
                         title_1 = title_1 || s.schema.title;
@@ -101,7 +101,7 @@ function toMarkdown(plain) {
         var res = plain.replace(/([^\n\r])(\r?\n)([^\n\r])/gm, '$1\n\n$3'); // single new lines to \n\n (Markdown paragraph)
         return res.replace(/[\\`*_{}[\]()#+\-.!]/g, "\\$&"); // escape markdown syntax tokens: http://daringfireball.net/projects/markdown/syntax#backslash
     }
-    return void 0;
+    return undefined;
 }
 function toMarkdownCodeBlock(content) {
     // see https://daringfireball.net/projects/markdown/syntax#precode

package/lib/esm/services/jsonSchemaService.js

@@ -9,24 +9,40 @@ import * as Parser from '../parser/jsonParser';
 import * as nls from 'vscode-nls';
 var localize = nls.loadMessageBundle();
 var FilePatternAssociation = /** @class */ (function () {
-    function FilePatternAssociation(pattern) {
+    function FilePatternAssociation(pattern, uris) {
+        this.patternRegExps = [];
+        this.isInclude = [];
         try {
-            this.patternRegExp = new RegExp(Strings.convertSimple2RegExpPattern(pattern) + '$');
+            for (var _i = 0, pattern_1 = pattern; _i < pattern_1.length; _i++) {
+                var p = pattern_1[_i];
+                var include = p[0] !== '!';
+                if (!include) {
+                    p = p.substring(1);
+                }
+                this.patternRegExps.push(new RegExp(Strings.convertSimple2RegExpPattern(p) + '$'));
+                this.isInclude.push(include);
+            }
+            this.uris = uris;
         }
         catch (e) {
             // invalid pattern
-            this.patternRegExp = null;
+            this.patternRegExps.length = 0;
+            this.isInclude.length = 0;
+            this.uris = [];
         }
-        this.schemas = [];
     }
-    FilePatternAssociation.prototype.addSchema = function (id) {
-        this.schemas.push(id);
-    };
     FilePatternAssociation.prototype.matchesPattern = function (fileName) {
-        return this.patternRegExp && this.patternRegExp.test(fileName);
+        var match = false;
+        for (var i = 0; i < this.patternRegExps.length; i++) {
+            var regExp = this.patternRegExps[i];
+            if (regExp.test(fileName)) {
+                match = this.isInclude[i];
+            }
+        }
+        return match;
     };
-    FilePatternAssociation.prototype.getSchemas = function () {
-        return this.schemas;
+    FilePatternAssociation.prototype.getURIs = function () {
+        return this.uris;
     };
     return FilePatternAssociation;
 }());
@@ -55,8 +71,8 @@ var SchemaHandle = /** @class */ (function () {
         return this.resolvedSchema;
     };
     SchemaHandle.prototype.clearSchema = function () {
-        this.resolvedSchema = null;
-        this.unresolvedSchema = null;
+        this.resolvedSchema = undefined;
+        this.unresolvedSchema = undefined;
         this.dependencies = {};
     };
     return SchemaHandle;
@@ -77,7 +93,11 @@ var ResolvedSchema = /** @class */ (function () {
         this.errors = errors;
     }
     ResolvedSchema.prototype.getSection = function (path) {
-        return Parser.asSchema(this.getSectionRecursive(path, this.schema));
+        var schemaRef = this.getSectionRecursive(path, this.schema);
+        if (schemaRef) {
+            return Parser.asSchema(schemaRef);
+        }
+        return undefined;
     };
     ResolvedSchema.prototype.getSectionRecursive = function (path, schema) {
         if (!schema || typeof schema === 'boolean' || path.length === 0) {
@@ -110,7 +130,7 @@ var ResolvedSchema = /** @class */ (function () {
                 return this.getSectionRecursive(path, schema.items);
             }
         }
-        return null;
+        return undefined;
     };
     return ResolvedSchema;
 }());
@@ -122,10 +142,9 @@ var JSONSchemaService = /** @class */ (function () {
         this.promiseConstructor = promiseConstructor || Promise;
         this.callOnDispose = [];
         this.contributionSchemas = {};
-        this.contributionAssociations = {};
+        this.contributionAssociations = [];
         this.schemasById = {};
         this.filePatternAssociations = [];
-        this.filePatternAssociationById = {};
         this.registeredSchemasIds = {};
     }
     JSONSchemaService.prototype.getRegisteredSchemaIds = function (filter) {
@@ -149,7 +168,7 @@ var JSONSchemaService = /** @class */ (function () {
     JSONSchemaService.prototype.onResourceChange = function (uri) {
         var _this = this;
         var hasChanges = false;
-        uri = this.normalizeId(uri);
+        uri = normalizeId(uri);
         var toWalk = [uri];
         var all = Object.keys(this.schemasById).map(function (key) { return _this.schemasById[key]; });
         while (toWalk.length) {
@@ -168,34 +187,21 @@ var JSONSchemaService = /** @class */ (function () {
         }
         return hasChanges;
     };
-    JSONSchemaService.prototype.normalizeId = function (id) {
-        // remove trailing '#', normalize drive capitalization
-        try {
-            return URI.parse(id).toString();
-        }
-        catch (e) {
-            return id;
-        }
-    };
     JSONSchemaService.prototype.setSchemaContributions = function (schemaContributions) {
         if (schemaContributions.schemas) {
             var schemas = schemaContributions.schemas;
             for (var id in schemas) {
-                var normalizedId = this.normalizeId(id);
+                var normalizedId = normalizeId(id);
                 this.contributionSchemas[normalizedId] = this.addSchemaHandle(normalizedId, schemas[id]);
             }
         }
-        if (schemaContributions.schemaAssociations) {
+        if (Array.isArray(schemaContributions.schemaAssociations)) {
             var schemaAssociations = schemaContributions.schemaAssociations;
-            for (var pattern in schemaAssociations) {
-                var associations = schemaAssociations[pattern];
-                this.contributionAssociations[pattern] = associations;
-                var fpa = this.getOrAddFilePatternAssociation(pattern);
-                for (var _i = 0, associations_1 = associations; _i < associations_1.length; _i++) {
-                    var schemaId = associations_1[_i];
-                    var id = this.normalizeId(schemaId);
-                    fpa.addSchema(id);
-                }
+            for (var _i = 0, schemaAssociations_1 = schemaAssociations; _i < schemaAssociations_1.length; _i++) {
+                var schemaAssociation = schemaAssociations_1[_i];
+                var uris = schemaAssociation.uris.map(normalizeId);
+                var association = this.addFilePatternAssociation(schemaAssociation.pattern, uris);
+                this.contributionAssociations.push(association);
             }
         }
     };
@@ -207,52 +213,41 @@ var JSONSchemaService = /** @class */ (function () {
     JSONSchemaService.prototype.getOrAddSchemaHandle = function (id, unresolvedSchemaContent) {
         return this.schemasById[id] || this.addSchemaHandle(id, unresolvedSchemaContent);
     };
-    JSONSchemaService.prototype.getOrAddFilePatternAssociation = function (pattern) {
-        var fpa = this.filePatternAssociationById[pattern];
-        if (!fpa) {
-            fpa = new FilePatternAssociation(pattern);
-            this.filePatternAssociationById[pattern] = fpa;
-            this.filePatternAssociations.push(fpa);
-        }
+    JSONSchemaService.prototype.addFilePatternAssociation = function (pattern, uris) {
+        var fpa = new FilePatternAssociation(pattern, uris);
+        this.filePatternAssociations.push(fpa);
         return fpa;
     };
     JSONSchemaService.prototype.registerExternalSchema = function (uri, filePatterns, unresolvedSchemaContent) {
-        if (filePatterns === void 0) { filePatterns = null; }
-        var id = this.normalizeId(uri);
+        var id = normalizeId(uri);
         this.registeredSchemasIds[id] = true;
+        this.cachedSchemaForResource = undefined;
         if (filePatterns) {
-            for (var _i = 0, filePatterns_1 = filePatterns; _i < filePatterns_1.length; _i++) {
-                var pattern = filePatterns_1[_i];
-                this.getOrAddFilePatternAssociation(pattern).addSchema(id);
-            }
+            this.addFilePatternAssociation(filePatterns, [uri]);
         }
         return unresolvedSchemaContent ? this.addSchemaHandle(id, unresolvedSchemaContent) : this.getOrAddSchemaHandle(id);
     };
     JSONSchemaService.prototype.clearExternalSchemas = function () {
         this.schemasById = {};
         this.filePatternAssociations = [];
-        this.filePatternAssociationById = {};
         this.registeredSchemasIds = {};
+        this.cachedSchemaForResource = undefined;
         for (var id in this.contributionSchemas) {
             this.schemasById[id] = this.contributionSchemas[id];
             this.registeredSchemasIds[id] = true;
         }
-        for (var pattern in this.contributionAssociations) {
-            var fpa = this.getOrAddFilePatternAssociation(pattern);
-            for (var _i = 0, _a = this.contributionAssociations[pattern]; _i < _a.length; _i++) {
-                var schemaId = _a[_i];
-                var id = this.normalizeId(schemaId);
-                fpa.addSchema(id);
-            }
+        for (var _i = 0, _a = this.contributionAssociations; _i < _a.length; _i++) {
+            var contributionAssociation = _a[_i];
+            this.filePatternAssociations.push(contributionAssociation);
         }
     };
     JSONSchemaService.prototype.getResolvedSchema = function (schemaId) {
-        var id = this.normalizeId(schemaId);
+        var id = normalizeId(schemaId);
         var schemaHandle = this.schemasById[id];
         if (schemaHandle) {
             return schemaHandle.getResolvedSchema();
         }
-        return this.promise.resolve(null);
+        return this.promise.resolve(undefined);
     };
     JSONSchemaService.prototype.loadSchema = function (url) {
         if (!this.requestService) {
@@ -287,7 +282,7 @@ var JSONSchemaService = /** @class */ (function () {
         var resolveErrors = schemaToResolve.errors.slice(0);
         var schema = schemaToResolve.schema;
         if (schema.$schema) {
-            var id = this.normalizeId(schema.$schema);
+            var id = normalizeId(schema.$schema);
             if (id === 'http://json-schema.org/draft-03/schema') {
                 return this.promise.resolve(new ResolvedSchema({}, [localize('json.schema.draft03.notsupported', "Draft-03 schemas are not supported.")]));
             }
@@ -310,7 +305,8 @@ var JSONSchemaService = /** @class */ (function () {
             });
             return current;
         };
-        var merge = function (target, sourceRoot, sourceURI, path) {
+        var merge = function (target, sourceRoot, sourceURI, refSegment) {
+            var path = refSegment ? decodeURIComponent(refSegment) : undefined;
             var section = findSection(sourceRoot, path);
             if (section) {
                 for (var key in section) {
@@ -323,19 +319,19 @@ var JSONSchemaService = /** @class */ (function () {
                 resolveErrors.push(localize('json.schema.invalidref', '$ref \'{0}\' in \'{1}\' can not be resolved.', path, sourceURI));
             }
         };
-        var resolveExternalLink = function (node, uri, linkPath, parentSchemaURL, parentSchemaDependencies) {
+        var resolveExternalLink = function (node, uri, refSegment, parentSchemaURL, parentSchemaDependencies) {
             if (contextService && !/^\w+:\/\/.*/.test(uri)) {
                 uri = contextService.resolveRelativePath(uri, parentSchemaURL);
             }
-            uri = _this.normalizeId(uri);
+            uri = normalizeId(uri);
             var referencedHandle = _this.getOrAddSchemaHandle(uri);
             return referencedHandle.getUnresolvedSchema().then(function (unresolvedSchema) {
                 parentSchemaDependencies[uri] = true;
                 if (unresolvedSchema.errors.length) {
-                    var loc = linkPath ? uri + '#' + linkPath : uri;
+                    var loc = refSegment ? uri + '#' + refSegment : uri;
                     resolveErrors.push(localize('json.schema.problemloadingref', 'Problems loading reference \'{0}\': {1}', loc, unresolvedSchema.errors[0]));
                 }
-                merge(node, unresolvedSchema.schema, uri, linkPath);
+                merge(node, unresolvedSchema.schema, uri, refSegment);
                 return resolveRefs(node, unresolvedSchema.schema, uri, referencedHandle.dependencies);
             });
         };
@@ -366,7 +362,8 @@ var JSONSchemaService = /** @class */ (function () {
                 for (var _a = 0, maps_1 = maps; _a < maps_1.length; _a++) {
                     var map = maps_1[_a];
                     if (typeof map === 'object') {
-                        for (var key in map) {
+                        for (var k in map) {
+                            var key = k;
                             var entry = map[key];
                             if (typeof entry === 'object') {
                                 toWalk.push(entry);
@@ -430,22 +427,28 @@ var JSONSchemaService = /** @class */ (function () {
         if (document && document.root && document.root.type === 'object') {
             var schemaProperties = document.root.properties.filter(function (p) { return (p.keyNode.value === '$schema') && p.valueNode && p.valueNode.type === 'string'; });
             if (schemaProperties.length > 0) {
-                var schemeId = Parser.getNodeValue(schemaProperties[0].valueNode);
-                if (schemeId && Strings.startsWith(schemeId, '.') && this.contextService) {
-                    schemeId = this.contextService.resolveRelativePath(schemeId, resource);
-                }
-                if (schemeId) {
-                    var id = this.normalizeId(schemeId);
-                    return this.getOrAddSchemaHandle(id).getResolvedSchema();
+                var valueNode = schemaProperties[0].valueNode;
+                if (valueNode && valueNode.type === 'string') {
+                    var schemeId = Parser.getNodeValue(valueNode);
+                    if (schemeId && Strings.startsWith(schemeId, '.') && this.contextService) {
+                        schemeId = this.contextService.resolveRelativePath(schemeId, resource);
+                    }
+                    if (schemeId) {
+                        var id = normalizeId(schemeId);
+                        return this.getOrAddSchemaHandle(id).getResolvedSchema();
+                    }
                 }
             }
         }
+        if (this.cachedSchemaForResource && this.cachedSchemaForResource.resource === resource) {
+            return this.cachedSchemaForResource.resolvedSchema;
+        }
         var seen = Object.create(null);
         var schemas = [];
         for (var _i = 0, _a = this.filePatternAssociations; _i < _a.length; _i++) {
             var entry = _a[_i];
             if (entry.matchesPattern(resource)) {
-                for (var _b = 0, _c = entry.getSchemas(); _b < _c.length; _b++) {
+                for (var _b = 0, _c = entry.getURIs(); _b < _c.length; _b++) {
                     var schemaId = _c[_b];
                     if (!seen[schemaId]) {
                         schemas.push(schemaId);
@@ -454,10 +457,9 @@ var JSONSchemaService = /** @class */ (function () {
                 }
             }
         }
-        if (schemas.length > 0) {
-            return this.createCombinedSchema(resource, schemas).getResolvedSchema();
-        }
-        return this.promise.resolve(null);
+        var resolvedSchema = schemas.length > 0 ? this.createCombinedSchema(resource, schemas).getResolvedSchema() : this.promise.resolve(undefined);
+        this.cachedSchemaForResource = { resource: resource, resolvedSchema: resolvedSchema };
+        return resolvedSchema;
     };
     JSONSchemaService.prototype.createCombinedSchema = function (resource, schemaIds) {
         if (schemaIds.length === 1) {
@@ -474,6 +476,15 @@ var JSONSchemaService = /** @class */ (function () {
     return JSONSchemaService;
 }());
 export { JSONSchemaService };
+function normalizeId(id) {
+    // remove trailing '#', normalize drive capitalization
+    try {
+        return URI.parse(id).toString();
+    }
+    catch (e) {
+        return id;
+    }
+}
 function toDisplayString(url) {
     try {
         var uri = URI.parse(url);

package/lib/esm/services/jsonValidation.js

@@ -16,7 +16,7 @@ var JSONValidation = /** @class */ (function () {
     JSONValidation.prototype.configure = function (raw) {
         if (raw) {
             this.validationEnabled = raw.validate;
-            this.commentSeverity = raw.allowComments ? void 0 : DiagnosticSeverity.Error;
+            this.commentSeverity = raw.allowComments ? undefined : DiagnosticSeverity.Error;
         }
     };
     JSONValidation.prototype.doValidation = function (textDocument, jsonDocument, documentSettings, schema) {
@@ -40,7 +40,7 @@ var JSONValidation = /** @class */ (function () {
             if (schema) {
                 if (schema.errors.length && jsonDocument.root) {
                     var astRoot = jsonDocument.root;
-                    var property = astRoot.type === 'object' ? astRoot.properties[0] : null;
+                    var property = astRoot.type === 'object' ? astRoot.properties[0] : undefined;
                     if (property && property.keyNode.value === '$schema') {
                         var node = property.valueNode || property;
                         var range = Range.create(textDocument.positionAt(node.offset), textDocument.positionAt(node.offset + node.length));
@@ -58,10 +58,10 @@ var JSONValidation = /** @class */ (function () {
                     }
                 }
                 if (schemaAllowsComments(schema.schema)) {
-                    commentSeverity = void 0;
+                    commentSeverity = undefined;
                 }
                 if (schemaAllowsTrailingCommas(schema.schema)) {
-                    trailingCommaSeverity = void 0;
+                    trailingCommaSeverity = undefined;
                 }
             }
             for (var _i = 0, _a = jsonDocument.syntaxErrors; _i < _a.length; _i++) {
@@ -118,8 +118,9 @@ function schemaAllowsTrailingCommas(schemaRef) {
         if (isBoolean(schemaRef.allowTrailingCommas)) {
             return schemaRef.allowTrailingCommas;
         }
-        if (isBoolean(schemaRef['allowsTrailingCommas'])) { // deprecated
-            return schemaRef['allowsTrailingCommas'];
+        var deprSchemaRef = schemaRef;
+        if (isBoolean(deprSchemaRef['allowsTrailingCommas'])) { // deprecated
+            return deprSchemaRef['allowsTrailingCommas'];
         }
         if (schemaRef.allOf) {
             for (var _i = 0, _a = schemaRef.allOf; _i < _a.length; _i++) {
@@ -137,7 +138,7 @@ function toDiagnosticSeverity(severityLevel) {
     switch (severityLevel) {
         case 'error': return DiagnosticSeverity.Error;
         case 'warning': return DiagnosticSeverity.Warning;
-        case 'ignore': return void 0;
+        case 'ignore': return undefined;
     }
-    return void 0;
+    return undefined;
 }

package/lib/esm/utils/colors.js

@@ -24,7 +24,7 @@ export function hexDigit(charCode) {
 }
 export function colorFromHex(text) {
     if (text[0] !== '#') {
-        return null;
+        return undefined;
     }
     switch (text.length) {
         case 4:
@@ -56,7 +56,7 @@ export function colorFromHex(text) {
                 alpha: (hexDigit(text.charCodeAt(7)) * 0x10 + hexDigit(text.charCodeAt(8))) / 255.0
             };
     }
-    return null;
+    return undefined;
 }
 export function colorFrom256RGB(red, green, blue, alpha) {
     if (alpha === void 0) { alpha = 1.0; }

package/lib/umd/jsonLanguageService.d.ts

@@ -1,4 +1,4 @@
-import { Thenable, ASTNode, Color, ColorInformation, ColorPresentation, LanguageServiceParams, LanguageSettings, DocumentLanguageSettings, FoldingRange, JSONSchema, SelectionRange, FoldingRangesContext, DocumentSymbolsContext, ColorInformationContext as DocumentColorsContext, TextDocument, Position, CompletionItem, CompletionList, Hover, Range, SymbolInformation, Diagnostic, TextEdit, FormattingOptions, DocumentSymbol } from './jsonLanguageTypes';
+import { Thenable, ASTNode, Color, ColorInformation, ColorPresentation, LanguageServiceParams, LanguageSettings, DocumentLanguageSettings, FoldingRange, JSONSchema, SelectionRange, FoldingRangesContext, DocumentSymbolsContext, ColorInformationContext as DocumentColorsContext, TextDocument, Position, CompletionItem, CompletionList, Hover, Range, SymbolInformation, Diagnostic, TextEdit, FormattingOptions, DocumentSymbol, DefinitionLink } from './jsonLanguageTypes';
 export declare type JSONDocument = {};
 export * from './jsonLanguageTypes';
 export interface LanguageService {
@@ -19,5 +19,6 @@ export interface LanguageService {
     format(document: TextDocument, range: Range, options: FormattingOptions): TextEdit[];
     getFoldingRanges(document: TextDocument, context?: FoldingRangesContext): FoldingRange[];
     getSelectionRanges(document: TextDocument, positions: Position[], doc: JSONDocument): SelectionRange[];
+    findDefinition(document: TextDocument, position: Position, doc: JSONDocument): Thenable<DefinitionLink[]>;
 }
 export declare function getLanguageService(params: LanguageServiceParams): LanguageService;

package/lib/umd/jsonLanguageService.js

@@ -8,7 +8,7 @@
         if (v !== undefined) module.exports = v;
     }
     else if (typeof define === "function" && define.amd) {
-        define(["require", "exports", "./services/jsonCompletion", "./services/jsonHover", "./services/jsonValidation", "./services/jsonDocumentSymbols", "./parser/jsonParser", "./services/configuration", "./services/jsonSchemaService", "./services/jsonFolding", "./services/jsonSelectionRanges", "jsonc-parser", "./jsonLanguageTypes", "./jsonLanguageTypes"], factory);
+        define(["require", "exports", "./services/jsonCompletion", "./services/jsonHover", "./services/jsonValidation", "./services/jsonDocumentSymbols", "./parser/jsonParser", "./services/configuration", "./services/jsonSchemaService", "./services/jsonFolding", "./services/jsonSelectionRanges", "jsonc-parser", "./jsonLanguageTypes", "./services/jsonDefinition", "./jsonLanguageTypes"], factory);
     }
 })(function (require, exports) {
     "use strict";
@@ -27,6 +27,7 @@
     var jsonSelectionRanges_1 = require("./services/jsonSelectionRanges");
     var jsonc_parser_1 = require("jsonc-parser");
     var jsonLanguageTypes_1 = require("./jsonLanguageTypes");
+    var jsonDefinition_1 = require("./services/jsonDefinition");
     __export(require("./jsonLanguageTypes"));
     function getLanguageService(params) {
         var promise = params.promiseConstructor || Promise;
@@ -60,8 +61,9 @@
             doHover: jsonHover.doHover.bind(jsonHover),
             getFoldingRanges: jsonFolding_1.getFoldingRanges,
             getSelectionRanges: jsonSelectionRanges_1.getSelectionRanges,
+            findDefinition: jsonDefinition_1.findDefinition,
             format: function (d, r, o) {
-                var range = void 0;
+                var range = undefined;
                 if (r) {
                     var offset = d.offsetAt(r.start);
                     var length = d.offsetAt(r.end) - offset;

package/lib/umd/jsonLanguageTypes.d.ts

@@ -88,7 +88,7 @@ export interface LanguageSettings {
 export declare type SeverityLevel = 'error' | 'warning' | 'ignore';
 export interface DocumentLanguageSettings {
     /**
-     * The severity of reported comments. If not set, 'LanguageSettings.allowComments' defines wheter comments are ignored or reported as errors.
+     * The severity of reported comments. If not set, 'LanguageSettings.allowComments' defines whether comments are ignored or reported as errors.
      */
     comments?: SeverityLevel;
     /**
@@ -102,7 +102,9 @@ export interface SchemaConfiguration {
      */
     uri: string;
     /**
-     * A list of file names that are associated to the schema. The '*' wildcard can be used. For example '*.schema.json', 'package.json'
+     * A list of file path patterns that are associated to the schema. The '*' wildcard can be used. Exclusion patterns starting with '!'.
+     * For example '*.schema.json', 'package.json', '!foo*.schema.json'.
+     * A match succeeds when there is at least one pattern matching and last matching pattern does not start with '!'.
      */
     fileMatch?: string[];
     /**

package/lib/umd/jsonSchema.d.ts

@@ -61,6 +61,7 @@ export interface JSONSchema {
     markdownEnumDescriptions?: string[];
     markdownDescription?: string;
     doNotSuggest?: boolean;
+    suggestSortText?: string;
     allowComments?: boolean;
     allowTrailingCommas?: boolean;
 }