vscode-css-languageservice 5.4.2 → 6.1.0

package/lib/esm/services/cssNavigation.js

@@ -3,42 +3,6 @@
  *  Licensed under the MIT License. See License.txt in the project root for license information.
  *--------------------------------------------------------------------------------------------*/
 'use strict';
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-var __generator = (this && this.__generator) || function (thisArg, body) {
-    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
-    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
-    function verb(n) { return function (v) { return step([n, v]); }; }
-    function step(op) {
-        if (f) throw new TypeError("Generator is already executing.");
-        while (_) try {
-            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
-            if (y = 0, t) op = [op[0] & 2, t.value];
-            switch (op[0]) {
-                case 0: case 1: t = op; break;
-                case 4: _.label++; return { value: op[1], done: false };
-                case 5: _.label++; y = op[1]; op = [0]; continue;
-                case 7: op = _.ops.pop(); _.trys.pop(); continue;
-                default:
-                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
-                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
-                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
-                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
-                    if (t[2]) _.ops.pop();
-                    _.trys.pop(); continue;
-            }
-            op = body.call(thisArg, _);
-        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
-        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
-    }
-};
 import { DocumentHighlightKind, Location, Range, SymbolKind, TextEdit, FileType } from '../cssLanguageTypes';
 import * as nls from 'vscode-nls';
 import * as nodes from '../parser/cssNodes';
@@ -46,22 +10,22 @@ import { Symbols } from '../parser/cssSymbolScope';
 import { getColorValue, hslFromColor, hwbFromColor } from '../languageFacts/facts';
 import { startsWith } from '../utils/strings';
 import { dirname, joinPath } from '../utils/resources';
-var localize = nls.loadMessageBundle();
-var startsWithSchemeRegex = /^\w+:\/\//;
-var startsWithData = /^data:/;
-var CSSNavigation = /** @class */ (function () {
-    function CSSNavigation(fileSystemProvider, resolveModuleReferences) {
+const localize = nls.loadMessageBundle();
+const startsWithSchemeRegex = /^\w+:\/\//;
+const startsWithData = /^data:/;
+export class CSSNavigation {
+    constructor(fileSystemProvider, resolveModuleReferences) {
         this.fileSystemProvider = fileSystemProvider;
         this.resolveModuleReferences = resolveModuleReferences;
     }
-    CSSNavigation.prototype.findDefinition = function (document, position, stylesheet) {
-        var symbols = new Symbols(stylesheet);
-        var offset = document.offsetAt(position);
-        var node = nodes.getNodeAtOffset(stylesheet, offset);
+    findDefinition(document, position, stylesheet) {
+        const symbols = new Symbols(stylesheet);
+        const offset = document.offsetAt(position);
+        const node = nodes.getNodeAtOffset(stylesheet, offset);
         if (!node) {
             return null;
         }
-        var symbol = symbols.findSymbolFromNode(node);
+        const symbol = symbols.findSymbolFromNode(node);
         if (!symbol) {
             return null;
         }
@@ -69,30 +33,30 @@ var CSSNavigation = /** @class */ (function () {
             uri: document.uri,
             range: getRange(symbol.node, document)
         };
-    };
-    CSSNavigation.prototype.findReferences = function (document, position, stylesheet) {
-        var highlights = this.findDocumentHighlights(document, position, stylesheet);
-        return highlights.map(function (h) {
+    }
+    findReferences(document, position, stylesheet) {
+        const highlights = this.findDocumentHighlights(document, position, stylesheet);
+        return highlights.map(h => {
             return {
                 uri: document.uri,
                 range: h.range
             };
         });
-    };
-    CSSNavigation.prototype.findDocumentHighlights = function (document, position, stylesheet) {
-        var result = [];
-        var offset = document.offsetAt(position);
-        var node = nodes.getNodeAtOffset(stylesheet, offset);
+    }
+    findDocumentHighlights(document, position, stylesheet) {
+        const result = [];
+        const offset = document.offsetAt(position);
+        let node = nodes.getNodeAtOffset(stylesheet, offset);
         if (!node || node.type === nodes.NodeType.Stylesheet || node.type === nodes.NodeType.Declarations) {
             return result;
         }
         if (node.type === nodes.NodeType.Identifier && node.parent && node.parent.type === nodes.NodeType.ClassSelector) {
             node = node.parent;
         }
-        var symbols = new Symbols(stylesheet);
-        var symbol = symbols.findSymbolFromNode(node);
-        var name = node.getText();
-        stylesheet.accept(function (candidate) {
+        const symbols = new Symbols(stylesheet);
+        const symbol = symbols.findSymbolFromNode(node);
+        const name = node.getText();
+        stylesheet.accept(candidate => {
             if (symbol) {
                 if (symbols.matchesSymbol(candidate, symbol)) {
                     result.push({
@@ -112,17 +76,16 @@ var CSSNavigation = /** @class */ (function () {
             return true;
         });
         return result;
-    };
-    CSSNavigation.prototype.isRawStringDocumentLinkNode = function (node) {
+    }
+    isRawStringDocumentLinkNode(node) {
         return node.type === nodes.NodeType.Import;
-    };
-    CSSNavigation.prototype.findDocumentLinks = function (document, stylesheet, documentContext) {
-        var linkData = this.findUnresolvedLinks(document, stylesheet);
-        var resolvedLinks = [];
-        for (var _i = 0, linkData_1 = linkData; _i < linkData_1.length; _i++) {
-            var data = linkData_1[_i];
-            var link = data.link;
-            var target = link.target;
+    }
+    findDocumentLinks(document, stylesheet, documentContext) {
+        const linkData = this.findUnresolvedLinks(document, stylesheet);
+        const resolvedLinks = [];
+        for (let data of linkData) {
+            const link = data.link;
+            const target = link.target;
             if (!target || startsWithData.test(target)) {
                 // no links for data:
             }
@@ -130,7 +93,7 @@ var CSSNavigation = /** @class */ (function () {
                 resolvedLinks.push(link);
             }
             else {
-                var resolved = documentContext.resolveReference(target, document.uri);
+                const resolved = documentContext.resolveReference(target, document.uri);
                 if (resolved) {
                     link.target = resolved;
                 }
@@ -138,63 +101,47 @@ var CSSNavigation = /** @class */ (function () {
             }
         }
         return resolvedLinks;
-    };
-    CSSNavigation.prototype.findDocumentLinks2 = function (document, stylesheet, documentContext) {
-        return __awaiter(this, void 0, void 0, function () {
-            var linkData, resolvedLinks, _i, linkData_2, data, link, target, resolvedTarget;
-            return __generator(this, function (_a) {
-                switch (_a.label) {
-                    case 0:
-                        linkData = this.findUnresolvedLinks(document, stylesheet);
-                        resolvedLinks = [];
-                        _i = 0, linkData_2 = linkData;
-                        _a.label = 1;
-                    case 1:
-                        if (!(_i < linkData_2.length)) return [3 /*break*/, 6];
-                        data = linkData_2[_i];
-                        link = data.link;
-                        target = link.target;
-                        if (!(!target || startsWithData.test(target))) return [3 /*break*/, 2];
-                        return [3 /*break*/, 5];
-                    case 2:
-                        if (!startsWithSchemeRegex.test(target)) return [3 /*break*/, 3];
-                        resolvedLinks.push(link);
-                        return [3 /*break*/, 5];
-                    case 3: return [4 /*yield*/, this.resolveRelativeReference(target, document.uri, documentContext, data.isRawLink)];
-                    case 4:
-                        resolvedTarget = _a.sent();
-                        if (resolvedTarget !== undefined) {
-                            link.target = resolvedTarget;
-                            resolvedLinks.push(link);
-                        }
-                        _a.label = 5;
-                    case 5:
-                        _i++;
-                        return [3 /*break*/, 1];
-                    case 6: return [2 /*return*/, resolvedLinks];
+    }
+    async findDocumentLinks2(document, stylesheet, documentContext) {
+        const linkData = this.findUnresolvedLinks(document, stylesheet);
+        const resolvedLinks = [];
+        for (let data of linkData) {
+            const link = data.link;
+            const target = link.target;
+            if (!target || startsWithData.test(target)) {
+                // no links for data:
+            }
+            else if (startsWithSchemeRegex.test(target)) {
+                resolvedLinks.push(link);
+            }
+            else {
+                const resolvedTarget = await this.resolveRelativeReference(target, document.uri, documentContext, data.isRawLink);
+                if (resolvedTarget !== undefined) {
+                    link.target = resolvedTarget;
+                    resolvedLinks.push(link);
                 }
-            });
-        });
-    };
-    CSSNavigation.prototype.findUnresolvedLinks = function (document, stylesheet) {
-        var _this = this;
-        var result = [];
-        var collect = function (uriStringNode) {
-            var rawUri = uriStringNode.getText();
-            var range = getRange(uriStringNode, document);
+            }
+        }
+        return resolvedLinks;
+    }
+    findUnresolvedLinks(document, stylesheet) {
+        const result = [];
+        const collect = (uriStringNode) => {
+            let rawUri = uriStringNode.getText();
+            const range = getRange(uriStringNode, document);
             // Make sure the range is not empty
             if (range.start.line === range.end.line && range.start.character === range.end.character) {
                 return;
             }
-            if (startsWith(rawUri, "'") || startsWith(rawUri, "\"")) {
+            if (startsWith(rawUri, `'`) || startsWith(rawUri, `"`)) {
                 rawUri = rawUri.slice(1, -1);
             }
-            var isRawLink = uriStringNode.parent ? _this.isRawStringDocumentLinkNode(uriStringNode.parent) : false;
-            result.push({ link: { target: rawUri, range: range }, isRawLink: isRawLink });
+            const isRawLink = uriStringNode.parent ? this.isRawStringDocumentLinkNode(uriStringNode.parent) : false;
+            result.push({ link: { target: rawUri, range }, isRawLink });
         };
-        stylesheet.accept(function (candidate) {
+        stylesheet.accept(candidate => {
             if (candidate.type === nodes.NodeType.URILiteral) {
-                var first = candidate.getChild(0);
+                const first = candidate.getChild(0);
                 if (first) {
                     collect(first);
                 }
@@ -204,9 +151,9 @@ var CSSNavigation = /** @class */ (function () {
              * In @import, it is possible to include links that do not use `url()`
              * For example, `@import 'foo.css';`
              */
-            if (candidate.parent && _this.isRawStringDocumentLinkNode(candidate.parent)) {
-                var rawText = candidate.getText();
-                if (startsWith(rawText, "'") || startsWith(rawText, "\"")) {
+            if (candidate.parent && this.isRawStringDocumentLinkNode(candidate.parent)) {
+                const rawText = candidate.getText();
+                if (startsWith(rawText, `'`) || startsWith(rawText, `"`)) {
                     collect(candidate);
                 }
                 return false;
@@ -214,226 +161,241 @@ var CSSNavigation = /** @class */ (function () {
             return true;
         });
         return result;
-    };
-    CSSNavigation.prototype.findDocumentSymbols = function (document, stylesheet) {
-        var result = [];
-        stylesheet.accept(function (node) {
-            var entry = {
-                name: null,
-                kind: SymbolKind.Class,
-                location: null
+    }
+    findSymbolInformations(document, stylesheet) {
+        const result = [];
+        const addSymbolInformation = (name, kind, symbolNodeOrRange) => {
+            const range = symbolNodeOrRange instanceof nodes.Node ? getRange(symbolNodeOrRange, document) : symbolNodeOrRange;
+            const entry = {
+                name,
+                kind,
+                location: Location.create(document.uri, range)
             };
-            var locationNode = node;
-            if (node instanceof nodes.Selector) {
-                entry.name = node.getText();
-                locationNode = node.findAParent(nodes.NodeType.Ruleset, nodes.NodeType.ExtendsReference);
-                if (locationNode) {
-                    entry.location = Location.create(document.uri, getRange(locationNode, document));
-                    result.push(entry);
+            result.push(entry);
+        };
+        this.collectDocumentSymbols(document, stylesheet, addSymbolInformation);
+        return result;
+    }
+    findDocumentSymbols(document, stylesheet) {
+        const result = [];
+        const parents = [];
+        const addDocumentSymbol = (name, kind, symbolNodeOrRange, nameNodeOrRange, bodyNode) => {
+            const range = symbolNodeOrRange instanceof nodes.Node ? getRange(symbolNodeOrRange, document) : symbolNodeOrRange;
+            const selectionRange = (nameNodeOrRange instanceof nodes.Node ? getRange(nameNodeOrRange, document) : nameNodeOrRange) ?? Range.create(range.start, range.start);
+            const entry = {
+                name,
+                kind,
+                range,
+                selectionRange
+            };
+            let top = parents.pop();
+            while (top && !containsRange(top[1], range)) {
+                top = parents.pop();
+            }
+            if (top) {
+                const topSymbol = top[0];
+                if (!topSymbol.children) {
+                    topSymbol.children = [];
+                }
+                topSymbol.children.push(entry);
+                parents.push(top); // put back top
+            }
+            else {
+                result.push(entry);
+            }
+            if (bodyNode) {
+                parents.push([entry, getRange(bodyNode, document)]);
+            }
+        };
+        this.collectDocumentSymbols(document, stylesheet, addDocumentSymbol);
+        return result;
+    }
+    collectDocumentSymbols(document, stylesheet, collect) {
+        stylesheet.accept(node => {
+            if (node instanceof nodes.RuleSet) {
+                for (const selector of node.getSelectors().getChildren()) {
+                    if (selector instanceof nodes.Selector) {
+                        const range = Range.create(document.positionAt(selector.offset), document.positionAt(node.end));
+                        collect(selector.getText(), SymbolKind.Class, range, selector, node.getDeclarations());
+                    }
                 }
-                return false;
             }
             else if (node instanceof nodes.VariableDeclaration) {
-                entry.name = node.getName();
-                entry.kind = SymbolKind.Variable;
+                collect(node.getName(), SymbolKind.Variable, node, node.getVariable(), undefined);
             }
             else if (node instanceof nodes.MixinDeclaration) {
-                entry.name = node.getName();
-                entry.kind = SymbolKind.Method;
+                collect(node.getName(), SymbolKind.Method, node, node.getIdentifier(), node.getDeclarations());
             }
             else if (node instanceof nodes.FunctionDeclaration) {
-                entry.name = node.getName();
-                entry.kind = SymbolKind.Function;
+                collect(node.getName(), SymbolKind.Function, node, node.getIdentifier(), node.getDeclarations());
             }
             else if (node instanceof nodes.Keyframe) {
-                entry.name = localize('literal.keyframes', "@keyframes {0}", node.getName());
+                const name = localize('literal.keyframes', "@keyframes {0}", node.getName());
+                collect(name, SymbolKind.Class, node, node.getIdentifier(), node.getDeclarations());
             }
             else if (node instanceof nodes.FontFace) {
-                entry.name = localize('literal.fontface', "@font-face");
+                const name = localize('literal.fontface', "@font-face");
+                collect(name, SymbolKind.Class, node, undefined, node.getDeclarations());
             }
             else if (node instanceof nodes.Media) {
-                var mediaList = node.getChild(0);
+                const mediaList = node.getChild(0);
                 if (mediaList instanceof nodes.Medialist) {
-                    entry.name = '@media ' + mediaList.getText();
-                    entry.kind = SymbolKind.Module;
+                    const name = '@media ' + mediaList.getText();
+                    collect(name, SymbolKind.Module, node, mediaList, node.getDeclarations());
                 }
             }
-            if (entry.name) {
-                entry.location = Location.create(document.uri, getRange(locationNode, document));
-                result.push(entry);
-            }
             return true;
         });
-        return result;
-    };
-    CSSNavigation.prototype.findDocumentColors = function (document, stylesheet) {
-        var result = [];
-        stylesheet.accept(function (node) {
-            var colorInfo = getColorInformation(node, document);
+    }
+    findDocumentColors(document, stylesheet) {
+        const result = [];
+        stylesheet.accept((node) => {
+            const colorInfo = getColorInformation(node, document);
             if (colorInfo) {
                 result.push(colorInfo);
             }
             return true;
         });
         return result;
-    };
-    CSSNavigation.prototype.getColorPresentations = function (document, stylesheet, color, range) {
-        var result = [];
-        var red256 = Math.round(color.red * 255), green256 = Math.round(color.green * 255), blue256 = Math.round(color.blue * 255);
-        var label;
+    }
+    getColorPresentations(document, stylesheet, color, range) {
+        const result = [];
+        const red256 = Math.round(color.red * 255), green256 = Math.round(color.green * 255), blue256 = Math.round(color.blue * 255);
+        let label;
         if (color.alpha === 1) {
-            label = "rgb(".concat(red256, ", ").concat(green256, ", ").concat(blue256, ")");
+            label = `rgb(${red256}, ${green256}, ${blue256})`;
         }
         else {
-            label = "rgba(".concat(red256, ", ").concat(green256, ", ").concat(blue256, ", ").concat(color.alpha, ")");
+            label = `rgba(${red256}, ${green256}, ${blue256}, ${color.alpha})`;
         }
         result.push({ label: label, textEdit: TextEdit.replace(range, label) });
         if (color.alpha === 1) {
-            label = "#".concat(toTwoDigitHex(red256)).concat(toTwoDigitHex(green256)).concat(toTwoDigitHex(blue256));
+            label = `#${toTwoDigitHex(red256)}${toTwoDigitHex(green256)}${toTwoDigitHex(blue256)}`;
         }
         else {
-            label = "#".concat(toTwoDigitHex(red256)).concat(toTwoDigitHex(green256)).concat(toTwoDigitHex(blue256)).concat(toTwoDigitHex(Math.round(color.alpha * 255)));
+            label = `#${toTwoDigitHex(red256)}${toTwoDigitHex(green256)}${toTwoDigitHex(blue256)}${toTwoDigitHex(Math.round(color.alpha * 255))}`;
         }
         result.push({ label: label, textEdit: TextEdit.replace(range, label) });
-        var hsl = hslFromColor(color);
+        const hsl = hslFromColor(color);
         if (hsl.a === 1) {
-            label = "hsl(".concat(hsl.h, ", ").concat(Math.round(hsl.s * 100), "%, ").concat(Math.round(hsl.l * 100), "%)");
+            label = `hsl(${hsl.h}, ${Math.round(hsl.s * 100)}%, ${Math.round(hsl.l * 100)}%)`;
         }
         else {
-            label = "hsla(".concat(hsl.h, ", ").concat(Math.round(hsl.s * 100), "%, ").concat(Math.round(hsl.l * 100), "%, ").concat(hsl.a, ")");
+            label = `hsla(${hsl.h}, ${Math.round(hsl.s * 100)}%, ${Math.round(hsl.l * 100)}%, ${hsl.a})`;
         }
         result.push({ label: label, textEdit: TextEdit.replace(range, label) });
-        var hwb = hwbFromColor(color);
+        const hwb = hwbFromColor(color);
         if (hwb.a === 1) {
-            label = "hwb(".concat(hwb.h, " ").concat(Math.round(hwb.w * 100), "% ").concat(Math.round(hwb.b * 100), "%)");
+            label = `hwb(${hwb.h} ${Math.round(hwb.w * 100)}% ${Math.round(hwb.b * 100)}%)`;
         }
         else {
-            label = "hwb(".concat(hwb.h, " ").concat(Math.round(hwb.w * 100), "% ").concat(Math.round(hwb.b * 100), "% / ").concat(hwb.a, ")");
+            label = `hwb(${hwb.h} ${Math.round(hwb.w * 100)}% ${Math.round(hwb.b * 100)}% / ${hwb.a})`;
         }
         result.push({ label: label, textEdit: TextEdit.replace(range, label) });
         return result;
-    };
-    CSSNavigation.prototype.doRename = function (document, position, newName, stylesheet) {
-        var _a;
-        var highlights = this.findDocumentHighlights(document, position, stylesheet);
-        var edits = highlights.map(function (h) { return TextEdit.replace(h.range, newName); });
+    }
+    doRename(document, position, newName, stylesheet) {
+        const highlights = this.findDocumentHighlights(document, position, stylesheet);
+        const edits = highlights.map(h => TextEdit.replace(h.range, newName));
         return {
-            changes: (_a = {}, _a[document.uri] = edits, _a)
+            changes: { [document.uri]: edits }
         };
-    };
-    CSSNavigation.prototype.resolveModuleReference = function (ref, documentUri, documentContext) {
-        return __awaiter(this, void 0, void 0, function () {
-            var moduleName, rootFolderUri, documentFolderUri, modulePath, pathWithinModule;
-            return __generator(this, function (_a) {
-                switch (_a.label) {
-                    case 0:
-                        if (!startsWith(documentUri, 'file://')) return [3 /*break*/, 2];
-                        moduleName = getModuleNameFromPath(ref);
-                        rootFolderUri = documentContext.resolveReference('/', documentUri);
-                        documentFolderUri = dirname(documentUri);
-                        return [4 /*yield*/, this.resolvePathToModule(moduleName, documentFolderUri, rootFolderUri)];
-                    case 1:
-                        modulePath = _a.sent();
-                        if (modulePath) {
-                            pathWithinModule = ref.substring(moduleName.length + 1);
-                            return [2 /*return*/, joinPath(modulePath, pathWithinModule)];
-                        }
-                        _a.label = 2;
-                    case 2: return [2 /*return*/, undefined];
-                }
-            });
-        });
-    };
-    CSSNavigation.prototype.resolveRelativeReference = function (ref, documentUri, documentContext, isRawLink) {
-        return __awaiter(this, void 0, void 0, function () {
-            var relativeReference, _a;
-            return __generator(this, function (_b) {
-                switch (_b.label) {
-                    case 0:
-                        relativeReference = documentContext.resolveReference(ref, documentUri);
-                        if (!(ref[0] === '~' && ref[1] !== '/' && this.fileSystemProvider)) return [3 /*break*/, 2];
-                        ref = ref.substring(1);
-                        return [4 /*yield*/, this.resolveModuleReference(ref, documentUri, documentContext)];
-                    case 1: return [2 /*return*/, (_b.sent()) || relativeReference];
-                    case 2:
-                        if (!this.resolveModuleReferences) return [3 /*break*/, 7];
-                        _a = relativeReference;
-                        if (!_a) return [3 /*break*/, 4];
-                        return [4 /*yield*/, this.fileExists(relativeReference)];
-                    case 3:
-                        _a = (_b.sent());
-                        _b.label = 4;
-                    case 4:
-                        if (!_a) return [3 /*break*/, 5];
-                        return [2 /*return*/, relativeReference];
-                    case 5: return [4 /*yield*/, this.resolveModuleReference(ref, documentUri, documentContext)];
-                    case 6: return [2 /*return*/, (_b.sent()) || relativeReference];
-                    case 7: return [2 /*return*/, relativeReference];
-                }
-            });
-        });
-    };
-    CSSNavigation.prototype.resolvePathToModule = function (_moduleName, documentFolderUri, rootFolderUri) {
-        return __awaiter(this, void 0, void 0, function () {
-            var packPath;
-            return __generator(this, function (_a) {
-                switch (_a.label) {
-                    case 0:
-                        packPath = joinPath(documentFolderUri, 'node_modules', _moduleName, 'package.json');
-                        return [4 /*yield*/, this.fileExists(packPath)];
-                    case 1:
-                        if (_a.sent()) {
-                            return [2 /*return*/, dirname(packPath)];
-                        }
-                        else if (rootFolderUri && documentFolderUri.startsWith(rootFolderUri) && (documentFolderUri.length !== rootFolderUri.length)) {
-                            return [2 /*return*/, this.resolvePathToModule(_moduleName, dirname(documentFolderUri), rootFolderUri)];
-                        }
-                        return [2 /*return*/, undefined];
-                }
-            });
-        });
-    };
-    CSSNavigation.prototype.fileExists = function (uri) {
-        return __awaiter(this, void 0, void 0, function () {
-            var stat, err_1;
-            return __generator(this, function (_a) {
-                switch (_a.label) {
-                    case 0:
-                        if (!this.fileSystemProvider) {
-                            return [2 /*return*/, false];
-                        }
-                        _a.label = 1;
-                    case 1:
-                        _a.trys.push([1, 3, , 4]);
-                        return [4 /*yield*/, this.fileSystemProvider.stat(uri)];
-                    case 2:
-                        stat = _a.sent();
-                        if (stat.type === FileType.Unknown && stat.size === -1) {
-                            return [2 /*return*/, false];
-                        }
-                        return [2 /*return*/, true];
-                    case 3:
-                        err_1 = _a.sent();
-                        return [2 /*return*/, false];
-                    case 4: return [2 /*return*/];
-                }
-            });
-        });
-    };
-    return CSSNavigation;
-}());
-export { CSSNavigation };
+    }
+    async resolveModuleReference(ref, documentUri, documentContext) {
+        if (startsWith(documentUri, 'file://')) {
+            const moduleName = getModuleNameFromPath(ref);
+            const rootFolderUri = documentContext.resolveReference('/', documentUri);
+            const documentFolderUri = dirname(documentUri);
+            const modulePath = await this.resolvePathToModule(moduleName, documentFolderUri, rootFolderUri);
+            if (modulePath) {
+                const pathWithinModule = ref.substring(moduleName.length + 1);
+                return joinPath(modulePath, pathWithinModule);
+            }
+        }
+        return undefined;
+    }
+    async resolveRelativeReference(ref, documentUri, documentContext, isRawLink) {
+        const relativeReference = documentContext.resolveReference(ref, documentUri);
+        // Following [css-loader](https://github.com/webpack-contrib/css-loader#url)
+        // and [sass-loader's](https://github.com/webpack-contrib/sass-loader#imports)
+        // convention, if an import path starts with ~ then use node module resolution
+        // *unless* it starts with "~/" as this refers to the user's home directory.
+        if (ref[0] === '~' && ref[1] !== '/' && this.fileSystemProvider) {
+            ref = ref.substring(1);
+            return await this.resolveModuleReference(ref, documentUri, documentContext) || relativeReference;
+        }
+        // Following [less-loader](https://github.com/webpack-contrib/less-loader#imports)
+        // and [sass-loader's](https://github.com/webpack-contrib/sass-loader#resolving-import-at-rules)
+        // new resolving import at-rules (~ is deprecated). The loader will first try to resolve @import as a relative path. If it cannot be resolved, 
+        // then the loader will try to resolve @import inside node_modules.
+        if (this.resolveModuleReferences) {
+            if (relativeReference && await this.fileExists(relativeReference)) {
+                return relativeReference;
+            }
+            else {
+                return await this.resolveModuleReference(ref, documentUri, documentContext) || relativeReference;
+            }
+        }
+        return relativeReference;
+    }
+    async resolvePathToModule(_moduleName, documentFolderUri, rootFolderUri) {
+        // resolve the module relative to the document. We can't use `require` here as the code is webpacked.
+        const packPath = joinPath(documentFolderUri, 'node_modules', _moduleName, 'package.json');
+        if (await this.fileExists(packPath)) {
+            return dirname(packPath);
+        }
+        else if (rootFolderUri && documentFolderUri.startsWith(rootFolderUri) && (documentFolderUri.length !== rootFolderUri.length)) {
+            return this.resolvePathToModule(_moduleName, dirname(documentFolderUri), rootFolderUri);
+        }
+        return undefined;
+    }
+    async fileExists(uri) {
+        if (!this.fileSystemProvider) {
+            return false;
+        }
+        try {
+            const stat = await this.fileSystemProvider.stat(uri);
+            if (stat.type === FileType.Unknown && stat.size === -1) {
+                return false;
+            }
+            return true;
+        }
+        catch (err) {
+            return false;
+        }
+    }
+}
 function getColorInformation(node, document) {
-    var color = getColorValue(node);
+    const color = getColorValue(node);
     if (color) {
-        var range = getRange(node, document);
-        return { color: color, range: range };
+        const range = getRange(node, document);
+        return { color, range };
     }
     return null;
 }
 function getRange(node, document) {
     return Range.create(document.positionAt(node.offset), document.positionAt(node.end));
 }
+/**
+ * Test if `otherRange` is in `range`. If the ranges are equal, will return true.
+ */
+function containsRange(range, otherRange) {
+    const otherStartLine = otherRange.start.line, otherEndLine = otherRange.end.line;
+    const rangeStartLine = range.start.line, rangeEndLine = range.end.line;
+    if (otherStartLine < rangeStartLine || otherEndLine < rangeStartLine) {
+        return false;
+    }
+    if (otherStartLine > rangeEndLine || otherEndLine > rangeEndLine) {
+        return false;
+    }
+    if (otherStartLine === rangeStartLine && otherRange.start.character < range.start.character) {
+        return false;
+    }
+    if (otherEndLine === rangeEndLine && otherRange.end.character > range.end.character) {
+        return false;
+    }
+    return true;
+}
 function getHighlightKind(node) {
     if (node.type === nodes.NodeType.Selector) {
         return DocumentHighlightKind.Write;
@@ -458,13 +420,22 @@ function getHighlightKind(node) {
     return DocumentHighlightKind.Read;
 }
 function toTwoDigitHex(n) {
-    var r = n.toString(16);
+    const r = n.toString(16);
     return r.length !== 2 ? '0' + r : r;
 }
 function getModuleNameFromPath(path) {
-    // If a scoped module (starts with @) then get up until second instance of '/', otherwise get until first instance of '/'
+    const firstSlash = path.indexOf('/');
+    if (firstSlash === -1) {
+        return '';
+    }
+    // If a scoped module (starts with @) then get up until second instance of '/', or to the end of the string for root-level imports.
     if (path[0] === '@') {
-        return path.substring(0, path.indexOf('/', path.indexOf('/') + 1));
+        const secondSlash = path.indexOf('/', firstSlash + 1);
+        if (secondSlash === -1) {
+            return path;
+        }
+        return path.substring(0, secondSlash);
     }
-    return path.substring(0, path.indexOf('/'));
+    // Otherwise get until first instance of '/'
+    return path.substring(0, firstSlash);
 }