vscode-css-languageservice
Version:
Language service for CSS, LESS and SCSS
484 lines (483 loc) • 18.5 kB
JavaScript
/*---------------------------------------------------------------------------------------------
* Copyright (c) Microsoft Corporation. All rights reserved.
* Licensed under the MIT License. See License.txt in the project root for license information.
*--------------------------------------------------------------------------------------------*/
'use strict';
var __extends = (this && this.__extends) || (function () {
var extendStatics = function (d, b) {
extendStatics = Object.setPrototypeOf ||
({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
function (d, b) { for (var p in b) if (b.hasOwnProperty(p)) d[p] = b[p]; };
return extendStatics(d, b);
};
return function (d, b) {
extendStatics(d, b);
function __() { this.constructor = d; }
d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
};
})();
import * as nodes from '../parser/cssNodes';
import { Scanner } from '../parser/cssScanner';
import * as languageFacts from "../languageFacts/facts";
import * as nls from 'vscode-nls';
var localize = nls.loadMessageBundle();
var Element = /** @class */ (function () {
function Element() {
this.parent = null;
this.children = null;
this.attributes = null;
}
Element.prototype.findAttribute = function (name) {
if (this.attributes) {
for (var _i = 0, _a = this.attributes; _i < _a.length; _i++) {
var attribute = _a[_i];
if (attribute.name === name) {
return attribute.value;
}
}
}
return null;
};
Element.prototype.addChild = function (child) {
if (child instanceof Element) {
child.parent = this;
}
if (!this.children) {
this.children = [];
}
this.children.push(child);
};
Element.prototype.append = function (text) {
if (this.attributes) {
var last = this.attributes[this.attributes.length - 1];
last.value = last.value + text;
}
};
Element.prototype.prepend = function (text) {
if (this.attributes) {
var first = this.attributes[0];
first.value = text + first.value;
}
};
Element.prototype.findRoot = function () {
var curr = this;
while (curr.parent && !(curr.parent instanceof RootElement)) {
curr = curr.parent;
}
return curr;
};
Element.prototype.removeChild = function (child) {
if (this.children) {
var index = this.children.indexOf(child);
if (index !== -1) {
this.children.splice(index, 1);
return true;
}
}
return false;
};
Element.prototype.addAttr = function (name, value) {
if (!this.attributes) {
this.attributes = [];
}
for (var _i = 0, _a = this.attributes; _i < _a.length; _i++) {
var attribute = _a[_i];
if (attribute.name === name) {
attribute.value += ' ' + value;
return;
}
}
this.attributes.push({ name: name, value: value });
};
Element.prototype.clone = function (cloneChildren) {
if (cloneChildren === void 0) { cloneChildren = true; }
var elem = new Element();
if (this.attributes) {
elem.attributes = [];
for (var _i = 0, _a = this.attributes; _i < _a.length; _i++) {
var attribute = _a[_i];
elem.addAttr(attribute.name, attribute.value);
}
}
if (cloneChildren && this.children) {
elem.children = [];
for (var index = 0; index < this.children.length; index++) {
elem.addChild(this.children[index].clone());
}
}
return elem;
};
Element.prototype.cloneWithParent = function () {
var clone = this.clone(false);
if (this.parent && !(this.parent instanceof RootElement)) {
var parentClone = this.parent.cloneWithParent();
parentClone.addChild(clone);
}
return clone;
};
return Element;
}());
export { Element };
var RootElement = /** @class */ (function (_super) {
__extends(RootElement, _super);
function RootElement() {
return _super !== null && _super.apply(this, arguments) || this;
}
return RootElement;
}(Element));
export { RootElement };
var LabelElement = /** @class */ (function (_super) {
__extends(LabelElement, _super);
function LabelElement(label) {
var _this = _super.call(this) || this;
_this.addAttr('name', label);
return _this;
}
return LabelElement;
}(Element));
export { LabelElement };
var MarkedStringPrinter = /** @class */ (function () {
function MarkedStringPrinter(quote) {
this.quote = quote;
this.result = [];
// empty
}
MarkedStringPrinter.prototype.print = function (element) {
this.result = [];
if (element instanceof RootElement) {
if (element.children) {
this.doPrint(element.children, 0);
}
}
else {
this.doPrint([element], 0);
}
var value = this.result.join('\n');
return [{ language: 'html', value: value }];
};
MarkedStringPrinter.prototype.doPrint = function (elements, indent) {
for (var _i = 0, elements_1 = elements; _i < elements_1.length; _i++) {
var element = elements_1[_i];
this.doPrintElement(element, indent);
if (element.children) {
this.doPrint(element.children, indent + 1);
}
}
};
MarkedStringPrinter.prototype.writeLine = function (level, content) {
var indent = new Array(level + 1).join(' ');
this.result.push(indent + content);
};
MarkedStringPrinter.prototype.doPrintElement = function (element, indent) {
var name = element.findAttribute('name');
// special case: a simple label
if (element instanceof LabelElement || name === '\u2026') {
this.writeLine(indent, name);
return;
}
// the real deal
var content = ['<'];
// element name
if (name) {
content.push(name);
}
else {
content.push('element');
}
// attributes
if (element.attributes) {
for (var _i = 0, _a = element.attributes; _i < _a.length; _i++) {
var attr = _a[_i];
if (attr.name !== 'name') {
content.push(' ');
content.push(attr.name);
var value = attr.value;
if (value) {
content.push('=');
content.push(quotes.ensure(value, this.quote));
}
}
}
}
content.push('>');
this.writeLine(indent, content.join(''));
};
return MarkedStringPrinter;
}());
var quotes;
(function (quotes) {
function ensure(value, which) {
return which + remove(value) + which;
}
quotes.ensure = ensure;
function remove(value) {
var match = value.match(/^['"](.*)["']$/);
if (match) {
return match[1];
}
return value;
}
quotes.remove = remove;
})(quotes || (quotes = {}));
var Specificity = /** @class */ (function () {
function Specificity() {
/** Count of identifiers (e.g., `#app`) */
this.id = 0;
/** Count of attributes (`[type="number"]`), classes (`.container-fluid`), and pseudo-classes (`:hover`) */
this.attr = 0;
/** Count of tag names (`div`), and pseudo-elements (`::before`) */
this.tag = 0;
}
return Specificity;
}());
export function toElement(node, parentElement) {
var result = new Element();
for (var _i = 0, _a = node.getChildren(); _i < _a.length; _i++) {
var child = _a[_i];
switch (child.type) {
case nodes.NodeType.SelectorCombinator:
if (parentElement) {
var segments = child.getText().split('&');
if (segments.length === 1) {
// should not happen
result.addAttr('name', segments[0]);
break;
}
result = parentElement.cloneWithParent();
if (segments[0]) {
var root = result.findRoot();
root.prepend(segments[0]);
}
for (var i = 1; i < segments.length; i++) {
if (i > 1) {
var clone = parentElement.cloneWithParent();
result.addChild(clone.findRoot());
result = clone;
}
result.append(segments[i]);
}
}
break;
case nodes.NodeType.SelectorPlaceholder:
if (child.matches('@at-root')) {
return result;
}
// fall through
case nodes.NodeType.ElementNameSelector:
var text = child.getText();
result.addAttr('name', text === '*' ? 'element' : unescape(text));
break;
case nodes.NodeType.ClassSelector:
result.addAttr('class', unescape(child.getText().substring(1)));
break;
case nodes.NodeType.IdentifierSelector:
result.addAttr('id', unescape(child.getText().substring(1)));
break;
case nodes.NodeType.MixinDeclaration:
result.addAttr('class', child.getName());
break;
case nodes.NodeType.PseudoSelector:
result.addAttr(unescape(child.getText()), '');
break;
case nodes.NodeType.AttributeSelector:
var selector = child;
var identifier = selector.getIdentifier();
if (identifier) {
var expression = selector.getValue();
var operator = selector.getOperator();
var value = void 0;
if (expression && operator) {
switch (unescape(operator.getText())) {
case '|=':
// excatly or followed by -words
value = quotes.remove(unescape(expression.getText())) + "-\u2026";
break;
case '^=':
// prefix
value = quotes.remove(unescape(expression.getText())) + "\u2026";
break;
case '$=':
// suffix
value = "\u2026" + quotes.remove(unescape(expression.getText()));
break;
case '~=':
// one of a list of words
value = " \u2026 " + quotes.remove(unescape(expression.getText())) + " \u2026 ";
break;
case '*=':
// substring
value = "\u2026" + quotes.remove(unescape(expression.getText())) + "\u2026";
break;
default:
value = quotes.remove(unescape(expression.getText()));
break;
}
}
result.addAttr(unescape(identifier.getText()), value);
}
break;
}
}
return result;
}
function unescape(content) {
var scanner = new Scanner();
scanner.setSource(content);
var token = scanner.scanUnquotedString();
if (token) {
return token.text;
}
return content;
}
function isPseudoElementIdentifier(text) {
var match = text.match(/^::?([\w-]+)/);
if (!match) {
return false;
}
return !!languageFacts.cssDataManager.getPseudoElement("::" + match[1]);
}
function selectorToSpecificityMarkedString(node) {
//https://www.w3.org/TR/selectors-3/#specificity
function calculateScore(node) {
node.getChildren().forEach(function (element) {
switch (element.type) {
case nodes.NodeType.IdentifierSelector:
specificity.id++;
break;
case nodes.NodeType.ClassSelector:
case nodes.NodeType.AttributeSelector:
specificity.attr++;
break;
case nodes.NodeType.ElementNameSelector:
//ignore universal selector
if (element.matches("*")) {
break;
}
specificity.tag++;
break;
case nodes.NodeType.PseudoSelector:
var text = element.getText();
if (isPseudoElementIdentifier(text)) {
specificity.tag++; // pseudo element
}
else {
//ignore psuedo class NOT
if (text.match(/^:not/i)) {
break;
}
specificity.attr++; //pseudo class
}
break;
}
if (element.getChildren().length > 0) {
calculateScore(element);
}
});
}
var specificity = new Specificity();
calculateScore(node);
return localize('specificity', "[Selector Specificity](https://developer.mozilla.org/en-US/docs/Web/CSS/Specificity): ({0}, {1}, {2})", specificity.id, specificity.attr, specificity.tag);
}
export function selectorToMarkedString(node) {
var root = selectorToElement(node);
if (root) {
var markedStrings = new MarkedStringPrinter('"').print(root);
markedStrings.push(selectorToSpecificityMarkedString(node));
return markedStrings;
}
else {
return [];
}
}
export function simpleSelectorToMarkedString(node) {
var element = toElement(node);
var markedStrings = new MarkedStringPrinter('"').print(element);
markedStrings.push(selectorToSpecificityMarkedString(node));
return markedStrings;
}
var SelectorElementBuilder = /** @class */ (function () {
function SelectorElementBuilder(element) {
this.prev = null;
this.element = element;
}
SelectorElementBuilder.prototype.processSelector = function (selector) {
var parentElement = null;
if (!(this.element instanceof RootElement)) {
if (selector.getChildren().some(function (c) { return c.hasChildren() && c.getChild(0).type === nodes.NodeType.SelectorCombinator; })) {
var curr = this.element.findRoot();
if (curr.parent instanceof RootElement) {
parentElement = this.element;
this.element = curr.parent;
this.element.removeChild(curr);
this.prev = null;
}
}
}
for (var _i = 0, _a = selector.getChildren(); _i < _a.length; _i++) {
var selectorChild = _a[_i];
if (selectorChild instanceof nodes.SimpleSelector) {
if (this.prev instanceof nodes.SimpleSelector) {
var labelElement = new LabelElement('\u2026');
this.element.addChild(labelElement);
this.element = labelElement;
}
else if (this.prev && (this.prev.matches('+') || this.prev.matches('~')) && this.element.parent) {
this.element = this.element.parent;
}
if (this.prev && this.prev.matches('~')) {
this.element.addChild(toElement(selectorChild));
this.element.addChild(new LabelElement('\u22EE'));
}
var thisElement = toElement(selectorChild, parentElement);
var root = thisElement.findRoot();
this.element.addChild(root);
this.element = thisElement;
}
if (selectorChild instanceof nodes.SimpleSelector ||
selectorChild.type === nodes.NodeType.SelectorCombinatorParent ||
selectorChild.type === nodes.NodeType.SelectorCombinatorShadowPiercingDescendant ||
selectorChild.type === nodes.NodeType.SelectorCombinatorSibling ||
selectorChild.type === nodes.NodeType.SelectorCombinatorAllSiblings) {
this.prev = selectorChild;
}
}
};
return SelectorElementBuilder;
}());
function isNewSelectorContext(node) {
switch (node.type) {
case nodes.NodeType.MixinDeclaration:
case nodes.NodeType.Stylesheet:
return true;
}
return false;
}
export function selectorToElement(node) {
if (node.matches('@at-root')) {
return null;
}
var root = new RootElement();
var parentRuleSets = [];
var ruleSet = node.getParent();
if (ruleSet instanceof nodes.RuleSet) {
var parent = ruleSet.getParent(); // parent of the selector's ruleset
while (parent && !isNewSelectorContext(parent)) {
if (parent instanceof nodes.RuleSet) {
if (parent.getSelectors().matches('@at-root')) {
break;
}
parentRuleSets.push(parent);
}
parent = parent.getParent();
}
}
var builder = new SelectorElementBuilder(root);
for (var i = parentRuleSets.length - 1; i >= 0; i--) {
var selector = parentRuleSets[i].getSelectors().getChild(0);
if (selector) {
builder.processSelector(selector);
}
}
builder.processSelector(node);
return root;
}