utils/node_modules/@microsoft/tsdoc/lib/beta/DeclarationReference.js
2024-02-07 01:33:07 -05:00

1295 lines
46 KiB
JavaScript

/* eslint-disable max-lines */
/* eslint-disable @typescript-eslint/array-type */
/* eslint-disable no-return-assign */
/* eslint-disable no-sequences */
/* eslint-disable no-inner-declarations */
/* eslint-disable @typescript-eslint/no-use-before-define */
/* eslint-disable @typescript-eslint/naming-convention */
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 __());
};
})();
// NOTE: See DeclarationReference.grammarkdown for information on the underlying grammar.
import { StringChecks } from '../parser/StringChecks';
/**
* Represents a reference to a declaration.
* @beta
*/
var DeclarationReference = /** @class */ (function () {
function DeclarationReference(source, navigation, symbol) {
this._source = source;
this._navigation = navigation;
this._symbol = symbol;
}
Object.defineProperty(DeclarationReference.prototype, "source", {
get: function () {
return this._source;
},
enumerable: false,
configurable: true
});
Object.defineProperty(DeclarationReference.prototype, "navigation", {
get: function () {
if (!this._source || !this._symbol) {
return undefined;
}
if (this._source === GlobalSource.instance) {
return "~" /* Locals */;
}
if (this._navigation === undefined) {
return "." /* Exports */;
}
return this._navigation;
},
enumerable: false,
configurable: true
});
Object.defineProperty(DeclarationReference.prototype, "symbol", {
get: function () {
return this._symbol;
},
enumerable: false,
configurable: true
});
Object.defineProperty(DeclarationReference.prototype, "isEmpty", {
get: function () {
return this.source === undefined && this.symbol === undefined;
},
enumerable: false,
configurable: true
});
DeclarationReference.parse = function (text) {
var parser = new Parser(text);
var reference = parser.parseDeclarationReference();
if (parser.errors.length) {
throw new SyntaxError("Invalid DeclarationReference '" + text + "':\n " + parser.errors.join('\n '));
}
if (!parser.eof) {
throw new SyntaxError("Invalid DeclarationReference '" + text + "'");
}
return reference;
};
DeclarationReference.parseComponent = function (text) {
if (text[0] === '[') {
return ComponentReference.parse(text);
}
else {
return new ComponentString(text, true);
}
};
/**
* Determines whether the provided string is a well-formed symbol navigation component string.
*/
DeclarationReference.isWellFormedComponentString = function (text) {
var scanner = new Scanner(text);
return scanner.scan() === 16 /* String */
? scanner.scan() === 1 /* EofToken */
: scanner.token() === 17 /* Text */
? scanner.scan() === 1 /* EofToken */
: scanner.token() === 1 /* EofToken */;
};
/**
* Escapes a string for use as a symbol navigation component. If the string contains any of `!.#~:,"{}()@` or starts
* with `[`, it is enclosed in quotes.
*/
DeclarationReference.escapeComponentString = function (text) {
if (text.length === 0) {
return '""';
}
var ch = text.charAt(0);
if (ch === '[' || ch === '"' || !this.isWellFormedComponentString(text)) {
return JSON.stringify(text);
}
return text;
};
/**
* Unescapes a string used as a symbol navigation component.
*/
DeclarationReference.unescapeComponentString = function (text) {
if (text.length >= 2 && text.charAt(0) === '"' && text.charAt(text.length - 1) === '"') {
try {
return JSON.parse(text);
}
catch (_a) {
throw new SyntaxError("Invalid Component '" + text + "'");
}
}
if (!this.isWellFormedComponentString(text)) {
throw new SyntaxError("Invalid Component '" + text + "'");
}
return text;
};
/**
* Determines whether the provided string is a well-formed module source string. The string may not
* have a trailing `!` character.
*/
DeclarationReference.isWellFormedModuleSourceString = function (text) {
var scanner = new Scanner(text + '!');
return (scanner.rescanModuleSource() === 18 /* ModuleSource */ &&
!scanner.stringIsUnterminated &&
scanner.scan() === 8 /* ExclamationToken */ &&
scanner.scan() === 1 /* EofToken */);
};
/**
* Escapes a string for use as a module source. If the string contains any of `!"` it is enclosed in quotes.
*/
DeclarationReference.escapeModuleSourceString = function (text) {
if (text.length === 0) {
return '""';
}
var ch = text.charAt(0);
if (ch === '"' || !this.isWellFormedModuleSourceString(text)) {
return JSON.stringify(text);
}
return text;
};
/**
* Unescapes a string used as a module source. The string may not have a trailing `!` character.
*/
DeclarationReference.unescapeModuleSourceString = function (text) {
if (text.length >= 2 && text.charAt(0) === '"' && text.charAt(text.length - 1) === '"') {
try {
return JSON.parse(text);
}
catch (_a) {
throw new SyntaxError("Invalid Module source '" + text + "'");
}
}
if (!this.isWellFormedModuleSourceString(text)) {
throw new SyntaxError("Invalid Module source '" + text + "'");
}
return text;
};
DeclarationReference.empty = function () {
return new DeclarationReference();
};
DeclarationReference.package = function (packageName, importPath) {
return new DeclarationReference(ModuleSource.fromPackage(packageName, importPath));
};
DeclarationReference.module = function (path, userEscaped) {
return new DeclarationReference(new ModuleSource(path, userEscaped));
};
DeclarationReference.global = function () {
return new DeclarationReference(GlobalSource.instance);
};
DeclarationReference.from = function (base) {
return base || this.empty();
};
DeclarationReference.prototype.withSource = function (source) {
return this._source === source ? this : new DeclarationReference(source, this._navigation, this._symbol);
};
DeclarationReference.prototype.withNavigation = function (navigation) {
return this._navigation === navigation
? this
: new DeclarationReference(this._source, navigation, this._symbol);
};
DeclarationReference.prototype.withSymbol = function (symbol) {
return this._symbol === symbol ? this : new DeclarationReference(this._source, this._navigation, symbol);
};
DeclarationReference.prototype.withComponentPath = function (componentPath) {
return this.withSymbol(this.symbol ? this.symbol.withComponentPath(componentPath) : new SymbolReference(componentPath));
};
DeclarationReference.prototype.withMeaning = function (meaning) {
if (!this.symbol) {
if (meaning === undefined) {
return this;
}
return this.withSymbol(SymbolReference.empty().withMeaning(meaning));
}
return this.withSymbol(this.symbol.withMeaning(meaning));
};
DeclarationReference.prototype.withOverloadIndex = function (overloadIndex) {
if (!this.symbol) {
if (overloadIndex === undefined) {
return this;
}
return this.withSymbol(SymbolReference.empty().withOverloadIndex(overloadIndex));
}
return this.withSymbol(this.symbol.withOverloadIndex(overloadIndex));
};
DeclarationReference.prototype.addNavigationStep = function (navigation, component) {
if (this.symbol) {
return this.withSymbol(this.symbol.addNavigationStep(navigation, component));
}
if (navigation === "#" /* Members */) {
navigation = "." /* Exports */;
}
var symbol = new SymbolReference(new ComponentRoot(Component.from(component)));
return new DeclarationReference(this.source, navigation, symbol);
};
DeclarationReference.prototype.toString = function () {
var navigation = this._source instanceof ModuleSource && this._symbol && this.navigation === "~" /* Locals */
? '~'
: '';
return "" + (this.source || '') + navigation + (this.symbol || '');
};
return DeclarationReference;
}());
export { DeclarationReference };
/**
* Represents a module.
* @beta
*/
var ModuleSource = /** @class */ (function () {
function ModuleSource(path, userEscaped) {
if (userEscaped === void 0) { userEscaped = true; }
this.escapedPath =
this instanceof ParsedModuleSource ? path : escapeModuleSourceIfNeeded(path, userEscaped);
}
Object.defineProperty(ModuleSource.prototype, "path", {
get: function () {
return this._path || (this._path = DeclarationReference.unescapeModuleSourceString(this.escapedPath));
},
enumerable: false,
configurable: true
});
Object.defineProperty(ModuleSource.prototype, "packageName", {
get: function () {
return this._getOrParsePathComponents().packageName;
},
enumerable: false,
configurable: true
});
Object.defineProperty(ModuleSource.prototype, "scopeName", {
get: function () {
var scopeName = this._getOrParsePathComponents().scopeName;
return scopeName ? '@' + scopeName : '';
},
enumerable: false,
configurable: true
});
Object.defineProperty(ModuleSource.prototype, "unscopedPackageName", {
get: function () {
return this._getOrParsePathComponents().unscopedPackageName;
},
enumerable: false,
configurable: true
});
Object.defineProperty(ModuleSource.prototype, "importPath", {
get: function () {
return this._getOrParsePathComponents().importPath || '';
},
enumerable: false,
configurable: true
});
ModuleSource.fromScopedPackage = function (scopeName, unscopedPackageName, importPath) {
var packageName = unscopedPackageName;
if (scopeName) {
if (scopeName.charAt(0) === '@') {
scopeName = scopeName.slice(1);
}
packageName = "@" + scopeName + "/" + unscopedPackageName;
}
var parsed = { packageName: packageName, scopeName: scopeName || '', unscopedPackageName: unscopedPackageName };
return this._fromPackageName(parsed, packageName, importPath);
};
ModuleSource.fromPackage = function (packageName, importPath) {
return this._fromPackageName(parsePackageName(packageName), packageName, importPath);
};
ModuleSource._fromPackageName = function (parsed, packageName, importPath) {
if (!parsed) {
throw new Error('Parsed package must be provided.');
}
var packageNameError = StringChecks.explainIfInvalidPackageName(packageName);
if (packageNameError) {
throw new SyntaxError("Invalid NPM package name: " + packageNameError);
}
var path = packageName;
if (importPath) {
if (invalidImportPathRegExp.test(importPath)) {
throw new SyntaxError("Invalid import path '" + importPath);
}
path += '/' + importPath;
parsed.importPath = importPath;
}
var source = new ModuleSource(path);
source._pathComponents = parsed;
return source;
};
ModuleSource.prototype.toString = function () {
return this.escapedPath + "!";
};
ModuleSource.prototype._getOrParsePathComponents = function () {
if (!this._pathComponents) {
var path = this.path;
var parsed = parsePackageName(path);
if (parsed && !StringChecks.explainIfInvalidPackageName(parsed.packageName)) {
this._pathComponents = parsed;
}
else {
this._pathComponents = {
packageName: '',
scopeName: '',
unscopedPackageName: '',
importPath: path
};
}
}
return this._pathComponents;
};
return ModuleSource;
}());
export { ModuleSource };
var ParsedModuleSource = /** @class */ (function (_super) {
__extends(ParsedModuleSource, _super);
function ParsedModuleSource() {
return _super !== null && _super.apply(this, arguments) || this;
}
return ParsedModuleSource;
}(ModuleSource));
// matches the following:
// 'foo' -> ["foo", "foo", undefined, "foo", undefined]
// 'foo/bar' -> ["foo/bar", "foo", undefined, "foo", "bar"]
// '@scope/foo' -> ["@scope/foo", "@scope/foo", "scope", "foo", undefined]
// '@scope/foo/bar' -> ["@scope/foo/bar", "@scope/foo", "scope", "foo", "bar"]
// does not match:
// '/'
// '@/'
// '@scope/'
// capture groups:
// 1. The package name (including scope)
// 2. The scope name (excluding the leading '@')
// 3. The unscoped package name
// 4. The package-relative import path
var packageNameRegExp = /^((?:@([^/]+?)\/)?([^/]+?))(?:\/(.+))?$/;
// no leading './' or '.\'
// no leading '../' or '..\'
// no leading '/' or '\'
// not '.' or '..'
var invalidImportPathRegExp = /^(\.\.?([\\/]|$)|[\\/])/;
// eslint-disable-next-line @rushstack/no-new-null
function parsePackageName(text) {
var match = packageNameRegExp.exec(text);
if (!match) {
return match;
}
var _a = match[1], packageName = _a === void 0 ? '' : _a, _b = match[2], scopeName = _b === void 0 ? '' : _b, _c = match[3], unscopedPackageName = _c === void 0 ? '' : _c, importPath = match[4];
return { packageName: packageName, scopeName: scopeName, unscopedPackageName: unscopedPackageName, importPath: importPath };
}
/**
* Represents the global scope.
* @beta
*/
var GlobalSource = /** @class */ (function () {
function GlobalSource() {
}
GlobalSource.prototype.toString = function () {
return '!';
};
GlobalSource.instance = new GlobalSource();
return GlobalSource;
}());
export { GlobalSource };
/**
* @beta
*/
// eslint-disable-next-line @typescript-eslint/no-namespace
export var Component;
(function (Component) {
function from(value) {
if (typeof value === 'string') {
return new ComponentString(value);
}
if (value instanceof DeclarationReference) {
return new ComponentReference(value);
}
return value;
}
Component.from = from;
})(Component || (Component = {}));
/**
* @beta
*/
var ComponentString = /** @class */ (function () {
function ComponentString(text, userEscaped) {
this.text = this instanceof ParsedComponentString ? text : escapeComponentIfNeeded(text, userEscaped);
}
ComponentString.prototype.toString = function () {
return this.text;
};
return ComponentString;
}());
export { ComponentString };
var ParsedComponentString = /** @class */ (function (_super) {
__extends(ParsedComponentString, _super);
function ParsedComponentString() {
return _super !== null && _super.apply(this, arguments) || this;
}
return ParsedComponentString;
}(ComponentString));
/**
* @beta
*/
var ComponentReference = /** @class */ (function () {
function ComponentReference(reference) {
this.reference = reference;
}
ComponentReference.parse = function (text) {
if (text.length > 2 && text.charAt(0) === '[' && text.charAt(text.length - 1) === ']') {
return new ComponentReference(DeclarationReference.parse(text.slice(1, -1)));
}
throw new SyntaxError("Invalid component reference: '" + text + "'");
};
ComponentReference.prototype.withReference = function (reference) {
return this.reference === reference ? this : new ComponentReference(reference);
};
ComponentReference.prototype.toString = function () {
return "[" + this.reference + "]";
};
return ComponentReference;
}());
export { ComponentReference };
/**
* @beta
*/
var ComponentPathBase = /** @class */ (function () {
function ComponentPathBase(component) {
this.component = component;
}
ComponentPathBase.prototype.addNavigationStep = function (navigation, component) {
// tslint:disable-next-line:no-use-before-declare
return new ComponentNavigation(this, navigation, Component.from(component));
};
return ComponentPathBase;
}());
export { ComponentPathBase };
/**
* @beta
*/
var ComponentRoot = /** @class */ (function (_super) {
__extends(ComponentRoot, _super);
function ComponentRoot() {
return _super !== null && _super.apply(this, arguments) || this;
}
ComponentRoot.prototype.withComponent = function (component) {
return this.component === component ? this : new ComponentRoot(Component.from(component));
};
ComponentRoot.prototype.toString = function () {
return this.component.toString();
};
return ComponentRoot;
}(ComponentPathBase));
export { ComponentRoot };
/**
* @beta
*/
var ComponentNavigation = /** @class */ (function (_super) {
__extends(ComponentNavigation, _super);
function ComponentNavigation(parent, navigation, component) {
var _this = _super.call(this, component) || this;
_this.parent = parent;
_this.navigation = navigation;
return _this;
}
ComponentNavigation.prototype.withParent = function (parent) {
return this.parent === parent ? this : new ComponentNavigation(parent, this.navigation, this.component);
};
ComponentNavigation.prototype.withNavigation = function (navigation) {
return this.navigation === navigation
? this
: new ComponentNavigation(this.parent, navigation, this.component);
};
ComponentNavigation.prototype.withComponent = function (component) {
return this.component === component
? this
: new ComponentNavigation(this.parent, this.navigation, Component.from(component));
};
ComponentNavigation.prototype.toString = function () {
return "" + this.parent + formatNavigation(this.navigation) + this.component;
};
return ComponentNavigation;
}(ComponentPathBase));
export { ComponentNavigation };
/**
* Represents a reference to a TypeScript symbol.
* @beta
*/
var SymbolReference = /** @class */ (function () {
function SymbolReference(component, _a) {
var _b = _a === void 0 ? {} : _a, meaning = _b.meaning, overloadIndex = _b.overloadIndex;
this.componentPath = component;
this.overloadIndex = overloadIndex;
this.meaning = meaning;
}
SymbolReference.empty = function () {
return new SymbolReference(/*component*/ undefined);
};
SymbolReference.prototype.withComponentPath = function (componentPath) {
return this.componentPath === componentPath
? this
: new SymbolReference(componentPath, {
meaning: this.meaning,
overloadIndex: this.overloadIndex
});
};
SymbolReference.prototype.withMeaning = function (meaning) {
return this.meaning === meaning
? this
: new SymbolReference(this.componentPath, {
meaning: meaning,
overloadIndex: this.overloadIndex
});
};
SymbolReference.prototype.withOverloadIndex = function (overloadIndex) {
return this.overloadIndex === overloadIndex
? this
: new SymbolReference(this.componentPath, {
meaning: this.meaning,
overloadIndex: overloadIndex
});
};
SymbolReference.prototype.addNavigationStep = function (navigation, component) {
if (!this.componentPath) {
throw new Error('Cannot add a navigation step to an empty symbol reference.');
}
return new SymbolReference(this.componentPath.addNavigationStep(navigation, component));
};
SymbolReference.prototype.toString = function () {
var result = "" + (this.componentPath || '');
if (this.meaning && this.overloadIndex !== undefined) {
result += ":" + this.meaning + "(" + this.overloadIndex + ")";
}
else if (this.meaning) {
result += ":" + this.meaning;
}
else if (this.overloadIndex !== undefined) {
result += ":" + this.overloadIndex;
}
return result;
};
return SymbolReference;
}());
export { SymbolReference };
function tokenToString(token) {
switch (token) {
case 2 /* OpenBraceToken */:
return '{';
case 3 /* CloseBraceToken */:
return '}';
case 4 /* OpenParenToken */:
return '(';
case 5 /* CloseParenToken */:
return ')';
case 6 /* OpenBracketToken */:
return '[';
case 7 /* CloseBracketToken */:
return ']';
case 8 /* ExclamationToken */:
return '!';
case 9 /* DotToken */:
return '.';
case 10 /* HashToken */:
return '#';
case 11 /* TildeToken */:
return '~';
case 12 /* ColonToken */:
return ':';
case 13 /* CommaToken */:
return ',';
case 14 /* AtToken */:
return '@';
case 19 /* ClassKeyword */:
return 'class';
case 20 /* InterfaceKeyword */:
return 'interface';
case 21 /* TypeKeyword */:
return 'type';
case 22 /* EnumKeyword */:
return 'enum';
case 23 /* NamespaceKeyword */:
return 'namespace';
case 24 /* FunctionKeyword */:
return 'function';
case 25 /* VarKeyword */:
return 'var';
case 26 /* ConstructorKeyword */:
return 'constructor';
case 27 /* MemberKeyword */:
return 'member';
case 28 /* EventKeyword */:
return 'event';
case 29 /* CallKeyword */:
return 'call';
case 30 /* NewKeyword */:
return 'new';
case 31 /* IndexKeyword */:
return 'index';
case 32 /* ComplexKeyword */:
return 'complex';
case 0 /* None */:
return '<none>';
case 1 /* EofToken */:
return '<eof>';
case 15 /* DecimalDigits */:
return '<decimal digits>';
case 16 /* String */:
return '<string>';
case 17 /* Text */:
return '<text>';
case 18 /* ModuleSource */:
return '<module source>';
}
}
var Scanner = /** @class */ (function () {
function Scanner(text) {
this._pos = 0;
this._tokenPos = 0;
this._stringIsUnterminated = false;
this._token = 0 /* None */;
this._text = text;
}
Object.defineProperty(Scanner.prototype, "stringIsUnterminated", {
get: function () {
return this._stringIsUnterminated;
},
enumerable: false,
configurable: true
});
Object.defineProperty(Scanner.prototype, "text", {
get: function () {
return this._text;
},
enumerable: false,
configurable: true
});
Object.defineProperty(Scanner.prototype, "tokenText", {
get: function () {
return this._text.slice(this._tokenPos, this._pos);
},
enumerable: false,
configurable: true
});
Object.defineProperty(Scanner.prototype, "eof", {
get: function () {
return this._pos >= this._text.length;
},
enumerable: false,
configurable: true
});
Scanner.prototype.token = function () {
return this._token;
};
Scanner.prototype.speculate = function (cb) {
var tokenPos = this._tokenPos;
var pos = this._pos;
var text = this._text;
var token = this._token;
var stringIsUnterminated = this._stringIsUnterminated;
var accepted = false;
try {
var accept = function () {
accepted = true;
};
return cb(accept);
}
finally {
if (!accepted) {
this._tokenPos = tokenPos;
this._pos = pos;
this._text = text;
this._token = token;
this._stringIsUnterminated = stringIsUnterminated;
}
}
};
Scanner.prototype.scan = function () {
if (!this.eof) {
this._tokenPos = this._pos;
this._stringIsUnterminated = false;
while (!this.eof) {
var ch = this._text.charAt(this._pos++);
switch (ch) {
case '{':
return (this._token = 2 /* OpenBraceToken */);
case '}':
return (this._token = 3 /* CloseBraceToken */);
case '(':
return (this._token = 4 /* OpenParenToken */);
case ')':
return (this._token = 5 /* CloseParenToken */);
case '[':
return (this._token = 6 /* OpenBracketToken */);
case ']':
return (this._token = 7 /* CloseBracketToken */);
case '!':
return (this._token = 8 /* ExclamationToken */);
case '.':
return (this._token = 9 /* DotToken */);
case '#':
return (this._token = 10 /* HashToken */);
case '~':
return (this._token = 11 /* TildeToken */);
case ':':
return (this._token = 12 /* ColonToken */);
case ',':
return (this._token = 13 /* CommaToken */);
case '@':
return (this._token = 14 /* AtToken */);
case '"':
this.scanString();
return (this._token = 16 /* String */);
default:
this.scanText();
return (this._token = 17 /* Text */);
}
}
}
return (this._token = 1 /* EofToken */);
};
Scanner.prototype.rescanModuleSource = function () {
var _this = this;
switch (this._token) {
case 18 /* ModuleSource */:
case 8 /* ExclamationToken */:
case 1 /* EofToken */:
return this._token;
}
return this.speculate(function (accept) {
if (!_this.eof) {
_this._pos = _this._tokenPos;
_this._stringIsUnterminated = false;
var scanned = 'none';
while (!_this.eof) {
var ch = _this._text[_this._pos];
if (ch === '!') {
if (scanned === 'none') {
return _this._token;
}
accept();
return (_this._token = 18 /* ModuleSource */);
}
_this._pos++;
if (ch === '"') {
if (scanned === 'other') {
// strings not allowed after scanning any other characters
return _this._token;
}
scanned = 'string';
_this.scanString();
}
else {
if (scanned === 'string') {
// no other tokens allowed after string
return _this._token;
}
scanned = 'other';
if (!isPunctuator(ch)) {
_this.scanText();
}
}
}
}
return _this._token;
});
};
Scanner.prototype.rescanMeaning = function () {
if (this._token === 17 /* Text */) {
var tokenText = this.tokenText;
switch (tokenText) {
case 'class':
return (this._token = 19 /* ClassKeyword */);
case 'interface':
return (this._token = 20 /* InterfaceKeyword */);
case 'type':
return (this._token = 21 /* TypeKeyword */);
case 'enum':
return (this._token = 22 /* EnumKeyword */);
case 'namespace':
return (this._token = 23 /* NamespaceKeyword */);
case 'function':
return (this._token = 24 /* FunctionKeyword */);
case 'var':
return (this._token = 25 /* VarKeyword */);
case 'constructor':
return (this._token = 26 /* ConstructorKeyword */);
case 'member':
return (this._token = 27 /* MemberKeyword */);
case 'event':
return (this._token = 28 /* EventKeyword */);
case 'call':
return (this._token = 29 /* CallKeyword */);
case 'new':
return (this._token = 30 /* NewKeyword */);
case 'index':
return (this._token = 31 /* IndexKeyword */);
case 'complex':
return (this._token = 32 /* ComplexKeyword */);
}
}
return this._token;
};
Scanner.prototype.rescanDecimalDigits = function () {
if (this._token === 17 /* Text */) {
var tokenText = this.tokenText;
if (/^\d+$/.test(tokenText)) {
return (this._token = 15 /* DecimalDigits */);
}
}
return this._token;
};
Scanner.prototype.scanString = function () {
while (!this.eof) {
var ch = this._text.charAt(this._pos++);
switch (ch) {
case '"':
return;
case '\\':
this.scanEscapeSequence();
break;
default:
if (isLineTerminator(ch)) {
this._stringIsUnterminated = true;
return;
}
}
}
this._stringIsUnterminated = true;
};
Scanner.prototype.scanEscapeSequence = function () {
if (this.eof) {
this._stringIsUnterminated = true;
return;
}
var ch = this._text.charAt(this._pos);
// EscapeSequence:: CharacterEscapeSequence
if (isCharacterEscapeSequence(ch)) {
this._pos++;
return;
}
// EscapeSequence:: `0` [lookahead != DecimalDigit]
if (ch === '0' &&
(this._pos + 1 === this._text.length || !isDecimalDigit(this._text.charAt(this._pos + 1)))) {
this._pos++;
return;
}
// EscapeSequence:: HexEscapeSequence
if (ch === 'x' &&
this._pos + 3 <= this._text.length &&
isHexDigit(this._text.charAt(this._pos + 1)) &&
isHexDigit(this._text.charAt(this._pos + 2))) {
this._pos += 3;
return;
}
// EscapeSequence:: UnicodeEscapeSequence
// UnicodeEscapeSequence:: `u` Hex4Digits
if (ch === 'u' &&
this._pos + 5 <= this._text.length &&
isHexDigit(this._text.charAt(this._pos + 1)) &&
isHexDigit(this._text.charAt(this._pos + 2)) &&
isHexDigit(this._text.charAt(this._pos + 3)) &&
isHexDigit(this._text.charAt(this._pos + 4))) {
this._pos += 5;
return;
}
// EscapeSequence:: UnicodeEscapeSequence
// UnicodeEscapeSequence:: `u` `{` CodePoint `}`
if (ch === 'u' && this._pos + 4 <= this._text.length && this._text.charAt(this._pos + 1) === '{') {
var hexDigits = this._text.charAt(this._pos + 2);
if (isHexDigit(hexDigits)) {
for (var i = this._pos + 3; i < this._text.length; i++) {
var ch2 = this._text.charAt(i);
if (ch2 === '}') {
var mv = parseInt(hexDigits, 16);
if (mv <= 0x10ffff) {
this._pos = i + 1;
return;
}
break;
}
if (!isHexDigit(ch2)) {
hexDigits += ch2;
break;
}
}
}
}
this._stringIsUnterminated = true;
};
Scanner.prototype.scanText = function () {
while (this._pos < this._text.length) {
var ch = this._text.charAt(this._pos);
if (isPunctuator(ch) || ch === '"') {
return;
}
this._pos++;
}
};
return Scanner;
}());
var Parser = /** @class */ (function () {
function Parser(text) {
this._errors = [];
this._scanner = new Scanner(text);
this._scanner.scan();
}
Object.defineProperty(Parser.prototype, "eof", {
get: function () {
return this.token() === 1 /* EofToken */;
},
enumerable: false,
configurable: true
});
Object.defineProperty(Parser.prototype, "errors", {
get: function () {
return this._errors;
},
enumerable: false,
configurable: true
});
Parser.prototype.parseDeclarationReference = function () {
var source;
var navigation;
var symbol;
if (this.optionalToken(8 /* ExclamationToken */)) {
// Reference to global symbol
source = GlobalSource.instance;
}
else if (this._scanner.rescanModuleSource() === 18 /* ModuleSource */) {
source = this.parseModuleSource();
// Check for optional `~` navigation token.
if (this.optionalToken(11 /* TildeToken */)) {
navigation = "~" /* Locals */;
}
}
if (this.isStartOfComponent()) {
symbol = this.parseSymbol();
}
else if (this.token() === 12 /* ColonToken */) {
symbol = this.parseSymbolRest(new ComponentRoot(new ComponentString('', /*userEscaped*/ true)));
}
return new DeclarationReference(source, navigation, symbol);
};
Parser.prototype.parseModuleSourceString = function () {
this._scanner.rescanModuleSource();
return this.parseTokenString(18 /* ModuleSource */, 'Module source');
};
Parser.prototype.parseComponentString = function () {
switch (this._scanner.token()) {
case 16 /* String */:
return this.parseString();
default:
return this.parseComponentCharacters();
}
};
Parser.prototype.token = function () {
return this._scanner.token();
};
Parser.prototype.parseModuleSource = function () {
var source = this.parseModuleSourceString();
this.expectToken(8 /* ExclamationToken */);
return new ParsedModuleSource(source, /*userEscaped*/ true);
};
Parser.prototype.parseSymbol = function () {
var component = this.parseComponentRest(this.parseRootComponent());
return this.parseSymbolRest(component);
};
Parser.prototype.parseSymbolRest = function (component) {
var meaning;
var overloadIndex;
if (this.optionalToken(12 /* ColonToken */)) {
meaning = this.tryParseMeaning();
overloadIndex = this.tryParseOverloadIndex(!!meaning);
}
return new SymbolReference(component, { meaning: meaning, overloadIndex: overloadIndex });
};
Parser.prototype.parseRootComponent = function () {
if (!this.isStartOfComponent()) {
return this.fail('Component expected', new ComponentRoot(new ComponentString('', /*userEscaped*/ true)));
}
var component = this.parseComponent();
return new ComponentRoot(component);
};
Parser.prototype.parseComponentRest = function (component) {
for (;;) {
switch (this.token()) {
case 9 /* DotToken */:
case 10 /* HashToken */:
case 11 /* TildeToken */:
var navigation = this.parseNavigation();
var right = this.parseComponent();
component = new ComponentNavigation(component, navigation, right);
break;
default:
return component;
}
}
};
Parser.prototype.parseNavigation = function () {
switch (this._scanner.token()) {
case 9 /* DotToken */:
return this._scanner.scan(), "." /* Exports */;
case 10 /* HashToken */:
return this._scanner.scan(), "#" /* Members */;
case 11 /* TildeToken */:
return this._scanner.scan(), "~" /* Locals */;
default:
return this.fail("Expected '.', '#', or '~'", "." /* Exports */);
}
};
Parser.prototype.tryParseMeaning = function () {
switch (this._scanner.rescanMeaning()) {
case 19 /* ClassKeyword */:
return this._scanner.scan(), "class" /* Class */;
case 20 /* InterfaceKeyword */:
return this._scanner.scan(), "interface" /* Interface */;
case 21 /* TypeKeyword */:
return this._scanner.scan(), "type" /* TypeAlias */;
case 22 /* EnumKeyword */:
return this._scanner.scan(), "enum" /* Enum */;
case 23 /* NamespaceKeyword */:
return this._scanner.scan(), "namespace" /* Namespace */;
case 24 /* FunctionKeyword */:
return this._scanner.scan(), "function" /* Function */;
case 25 /* VarKeyword */:
return this._scanner.scan(), "var" /* Variable */;
case 26 /* ConstructorKeyword */:
return this._scanner.scan(), "constructor" /* Constructor */;
case 27 /* MemberKeyword */:
return this._scanner.scan(), "member" /* Member */;
case 28 /* EventKeyword */:
return this._scanner.scan(), "event" /* Event */;
case 29 /* CallKeyword */:
return this._scanner.scan(), "call" /* CallSignature */;
case 30 /* NewKeyword */:
return this._scanner.scan(), "new" /* ConstructSignature */;
case 31 /* IndexKeyword */:
return this._scanner.scan(), "index" /* IndexSignature */;
case 32 /* ComplexKeyword */:
return this._scanner.scan(), "complex" /* ComplexType */;
default:
return undefined;
}
};
Parser.prototype.tryParseOverloadIndex = function (hasMeaning) {
if (this.optionalToken(4 /* OpenParenToken */)) {
var overloadIndex = this.parseDecimalDigits();
this.expectToken(5 /* CloseParenToken */);
return overloadIndex;
}
else if (!hasMeaning) {
return this.parseDecimalDigits();
}
return undefined;
};
Parser.prototype.parseDecimalDigits = function () {
switch (this._scanner.rescanDecimalDigits()) {
case 15 /* DecimalDigits */:
var value = +this._scanner.tokenText;
this._scanner.scan();
return value;
default:
return this.fail('Decimal digit expected', 0);
}
};
Parser.prototype.isStartOfComponent = function () {
switch (this.token()) {
case 17 /* Text */:
case 16 /* String */:
case 6 /* OpenBracketToken */:
return true;
default:
return false;
}
};
Parser.prototype.parseComponentCharacters = function () {
var text = '';
for (;;) {
switch (this._scanner.token()) {
case 17 /* Text */:
text += this.parseText();
break;
default:
return text;
}
}
};
Parser.prototype.parseTokenString = function (token, tokenString) {
if (this._scanner.token() === token) {
var text = this._scanner.tokenText;
var stringIsUnterminated = this._scanner.stringIsUnterminated;
this._scanner.scan();
if (stringIsUnterminated) {
return this.fail((tokenString || tokenToString(token)) + " is unterminated", text);
}
return text;
}
return this.fail((tokenString || tokenToString(token)) + " expected", '');
};
Parser.prototype.parseText = function () {
return this.parseTokenString(17 /* Text */, 'Text');
};
Parser.prototype.parseString = function () {
return this.parseTokenString(16 /* String */, 'String');
};
Parser.prototype.parseComponent = function () {
switch (this._scanner.token()) {
case 6 /* OpenBracketToken */:
return this.parseBracketedComponent();
default:
return new ParsedComponentString(this.parseComponentString(), /*userEscaped*/ true);
}
};
Parser.prototype.parseBracketedComponent = function () {
this.expectToken(6 /* OpenBracketToken */);
var reference = this.parseDeclarationReference();
this.expectToken(7 /* CloseBracketToken */);
return new ComponentReference(reference);
};
Parser.prototype.optionalToken = function (token) {
if (this._scanner.token() === token) {
this._scanner.scan();
return true;
}
return false;
};
Parser.prototype.expectToken = function (token, message) {
if (this._scanner.token() !== token) {
var expected = tokenToString(token);
var actual = tokenToString(this._scanner.token());
return this.fail(message || "Expected token '" + expected + "', received '" + actual + "' instead.", undefined);
}
this._scanner.scan();
};
Parser.prototype.fail = function (message, fallback) {
this._errors.push(message);
return fallback;
};
return Parser;
}());
function formatNavigation(navigation) {
switch (navigation) {
case "." /* Exports */:
return '.';
case "#" /* Members */:
return '#';
case "~" /* Locals */:
return '~';
default:
return '';
}
}
function isCharacterEscapeSequence(ch) {
return isSingleEscapeCharacter(ch) || isNonEscapeCharacter(ch);
}
function isSingleEscapeCharacter(ch) {
switch (ch) {
case "'":
case '"':
case '\\':
case 'b':
case 'f':
case 'n':
case 'r':
case 't':
case 'v':
return true;
default:
return false;
}
}
function isNonEscapeCharacter(ch) {
return !isEscapeCharacter(ch) && !isLineTerminator(ch);
}
function isEscapeCharacter(ch) {
switch (ch) {
case 'x':
case 'u':
return true;
default:
return isSingleEscapeCharacter(ch) || isDecimalDigit(ch);
}
}
function isLineTerminator(ch) {
switch (ch) {
case '\r':
case '\n':
// TODO: <LS>, <PS>
return true;
default:
return false;
}
}
function isDecimalDigit(ch) {
switch (ch) {
case '0':
case '1':
case '2':
case '3':
case '4':
case '5':
case '6':
case '7':
case '8':
case '9':
return true;
default:
return false;
}
}
function isHexDigit(ch) {
switch (ch) {
case 'a':
case 'b':
case 'c':
case 'd':
case 'e':
case 'f':
case 'A':
case 'B':
case 'C':
case 'D':
case 'E':
case 'F':
return true;
default:
return isDecimalDigit(ch);
}
}
function isPunctuator(ch) {
switch (ch) {
case '{':
case '}':
case '(':
case ')':
case '[':
case ']':
case '!':
case '.':
case '#':
case '~':
case ':':
case ',':
case '@':
return true;
default:
return false;
}
}
function escapeComponentIfNeeded(text, userEscaped) {
if (userEscaped) {
if (!DeclarationReference.isWellFormedComponentString(text)) {
throw new SyntaxError("Invalid Component '" + text + "'");
}
return text;
}
return DeclarationReference.escapeComponentString(text);
}
function escapeModuleSourceIfNeeded(text, userEscaped) {
if (userEscaped) {
if (!DeclarationReference.isWellFormedModuleSourceString(text)) {
throw new SyntaxError("Invalid Module source '" + text + "'");
}
return text;
}
return DeclarationReference.escapeModuleSourceString(text);
}
//# sourceMappingURL=DeclarationReference.js.map