utils/node_modules/@microsoft/tsdoc/lib/nodes/DocParamBlock.js

141 lines
6.1 KiB
JavaScript
Raw Normal View History

2024-02-07 01:33:07 -05:00
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 { DocNodeKind, DocNode } from './DocNode';
import { DocBlock } from './DocBlock';
import { DocExcerpt, ExcerptKind } from './DocExcerpt';
/**
* Represents a parsed `@param` or `@typeParam` block, which provides a description for a
* function parameter.
*/
var DocParamBlock = /** @class */ (function (_super) {
__extends(DocParamBlock, _super);
/**
* Don't call this directly. Instead use {@link TSDocParser}
* @internal
*/
function DocParamBlock(parameters) {
var _this = _super.call(this, parameters) || this;
_this._parameterName = parameters.parameterName;
if (DocNode.isParsedParameters(parameters)) {
if (parameters.spacingBeforeParameterNameExcerpt) {
_this._spacingBeforeParameterNameExcerpt = new DocExcerpt({
configuration: _this.configuration,
excerptKind: ExcerptKind.Spacing,
content: parameters.spacingBeforeParameterNameExcerpt
});
}
if (parameters.unsupportedJsdocTypeBeforeParameterNameExcerpt) {
_this._unsupportedJsdocTypeBeforeParameterNameExcerpt = new DocExcerpt({
configuration: _this.configuration,
excerptKind: ExcerptKind.NonstandardText,
content: parameters.unsupportedJsdocTypeBeforeParameterNameExcerpt
});
}
if (parameters.unsupportedJsdocOptionalNameOpenBracketExcerpt) {
_this._unsupportedJsdocOptionalNameOpenBracketExcerpt = new DocExcerpt({
configuration: _this.configuration,
excerptKind: ExcerptKind.NonstandardText,
content: parameters.unsupportedJsdocOptionalNameOpenBracketExcerpt
});
}
_this._parameterNameExcerpt = new DocExcerpt({
configuration: _this.configuration,
excerptKind: ExcerptKind.ParamBlock_ParameterName,
content: parameters.parameterNameExcerpt
});
if (parameters.unsupportedJsdocOptionalNameRestExcerpt) {
_this._unsupportedJsdocOptionalNameRestExcerpt = new DocExcerpt({
configuration: _this.configuration,
excerptKind: ExcerptKind.NonstandardText,
content: parameters.unsupportedJsdocOptionalNameRestExcerpt
});
}
if (parameters.spacingAfterParameterNameExcerpt) {
_this._spacingAfterParameterNameExcerpt = new DocExcerpt({
configuration: _this.configuration,
excerptKind: ExcerptKind.Spacing,
content: parameters.spacingAfterParameterNameExcerpt
});
}
if (parameters.unsupportedJsdocTypeAfterParameterNameExcerpt) {
_this._unsupportedJsdocTypeAfterParameterNameExcerpt = new DocExcerpt({
configuration: _this.configuration,
excerptKind: ExcerptKind.NonstandardText,
content: parameters.unsupportedJsdocTypeAfterParameterNameExcerpt
});
}
if (parameters.hyphenExcerpt) {
_this._hyphenExcerpt = new DocExcerpt({
configuration: _this.configuration,
excerptKind: ExcerptKind.ParamBlock_Hyphen,
content: parameters.hyphenExcerpt
});
}
if (parameters.spacingAfterHyphenExcerpt) {
_this._spacingAfterHyphenExcerpt = new DocExcerpt({
configuration: _this.configuration,
excerptKind: ExcerptKind.Spacing,
content: parameters.spacingAfterHyphenExcerpt
});
}
if (parameters.unsupportedJsdocTypeAfterHyphenExcerpt) {
_this._unsupportedJsdocTypeAfterHyphenExcerpt = new DocExcerpt({
configuration: _this.configuration,
excerptKind: ExcerptKind.NonstandardText,
content: parameters.unsupportedJsdocTypeAfterHyphenExcerpt
});
}
}
return _this;
}
Object.defineProperty(DocParamBlock.prototype, "kind", {
/** @override */
get: function () {
return DocNodeKind.ParamBlock;
},
enumerable: false,
configurable: true
});
Object.defineProperty(DocParamBlock.prototype, "parameterName", {
/**
* The name of the parameter that is being documented.
* For example "width" in `@param width - the width of the object`.
*/
get: function () {
return this._parameterName;
},
enumerable: false,
configurable: true
});
/** @override */
DocParamBlock.prototype.onGetChildNodes = function () {
return [
this.blockTag,
this._spacingBeforeParameterNameExcerpt,
this._unsupportedJsdocTypeBeforeParameterNameExcerpt,
this._unsupportedJsdocOptionalNameOpenBracketExcerpt,
this._parameterNameExcerpt,
this._unsupportedJsdocOptionalNameRestExcerpt,
this._spacingAfterParameterNameExcerpt,
this._unsupportedJsdocTypeAfterParameterNameExcerpt,
this._hyphenExcerpt,
this._spacingAfterHyphenExcerpt,
this._unsupportedJsdocTypeAfterHyphenExcerpt,
this.content
];
};
return DocParamBlock;
}(DocBlock));
export { DocParamBlock };
//# sourceMappingURL=DocParamBlock.js.map