UNPKG

2.44 kBTypeScriptView Raw
1import { DocNodeKind, DocNode } from './DocNode';
2import { DocBlock, IDocBlockParameters, IDocBlockParsedParameters } from './DocBlock';
3import { TokenSequence } from '../parser/TokenSequence';
4/**
5 * Constructor parameters for {@link DocParamBlock}.
6 */
7export interface IDocParamBlockParameters extends IDocBlockParameters {
8 parameterName: string;
9}
10/**
11 * Constructor parameters for {@link DocParamBlock}.
12 */
13export interface IDocParamBlockParsedParameters extends IDocBlockParsedParameters {
14 spacingBeforeParameterNameExcerpt?: TokenSequence;
15 unsupportedJsdocTypeBeforeParameterNameExcerpt?: TokenSequence;
16 unsupportedJsdocOptionalNameOpenBracketExcerpt?: TokenSequence;
17 parameterNameExcerpt: TokenSequence;
18 parameterName: string;
19 unsupportedJsdocOptionalNameRestExcerpt?: TokenSequence;
20 spacingAfterParameterNameExcerpt?: TokenSequence;
21 unsupportedJsdocTypeAfterParameterNameExcerpt?: TokenSequence;
22 hyphenExcerpt?: TokenSequence;
23 spacingAfterHyphenExcerpt?: TokenSequence;
24 unsupportedJsdocTypeAfterHyphenExcerpt?: TokenSequence;
25}
26/**
27 * Represents a parsed `@param` or `@typeParam` block, which provides a description for a
28 * function parameter.
29 */
30export declare class DocParamBlock extends DocBlock {
31 private readonly _spacingBeforeParameterNameExcerpt;
32 private readonly _unsupportedJsdocTypeBeforeParameterNameExcerpt;
33 private readonly _unsupportedJsdocOptionalNameOpenBracketExcerpt;
34 private readonly _parameterName;
35 private readonly _parameterNameExcerpt;
36 private readonly _unsupportedJsdocOptionalNameRestExcerpt;
37 private readonly _spacingAfterParameterNameExcerpt;
38 private readonly _unsupportedJsdocTypeAfterParameterNameExcerpt;
39 private readonly _hyphenExcerpt;
40 private readonly _spacingAfterHyphenExcerpt;
41 private readonly _unsupportedJsdocTypeAfterHyphenExcerpt;
42 /**
43 * Don't call this directly. Instead use {@link TSDocParser}
44 * @internal
45 */
46 constructor(parameters: IDocParamBlockParameters | IDocParamBlockParsedParameters);
47 /** @override */
48 get kind(): DocNodeKind | string;
49 /**
50 * The name of the parameter that is being documented.
51 * For example "width" in `@param width - the width of the object`.
52 */
53 get parameterName(): string;
54 /** @override */
55 protected onGetChildNodes(): ReadonlyArray<DocNode | undefined>;
56}
57//# sourceMappingURL=DocParamBlock.d.ts.map
\No newline at end of file