UNPKG

1.5 kBTypeScriptView Raw
1import { DocNodeKind, IDocNodeParameters, DocNode, IDocNodeParsedParameters } from './DocNode';
2import { TokenSequence } from '../parser/TokenSequence';
3/**
4 * Constructor parameters for {@link DocSoftBreak}.
5 */
6export interface IDocSoftBreakParameters extends IDocNodeParameters {
7}
8/**
9 * Constructor parameters for {@link DocSoftBreak}.
10 */
11export interface IDocSoftBreakParsedParameters extends IDocNodeParsedParameters {
12 softBreakExcerpt: TokenSequence;
13}
14/**
15 * Instructs a renderer to insert an explicit newline in the output.
16 * (Normally the renderer uses a formatting rule to determine where
17 * lines should wrap.)
18 *
19 * @remarks
20 * In HTML, a soft break is represented as an ASCII newline character (which does not
21 * affect the web browser's view), whereas the hard break is the `<br />` element
22 * (which starts a new line in the web browser's view).
23 *
24 * TSDoc follows the same conventions, except the renderer avoids emitting
25 * two empty lines (because that could start a new CommonMark paragraph).
26 */
27export declare class DocSoftBreak extends DocNode {
28 private readonly _softBreakExcerpt;
29 /**
30 * Don't call this directly. Instead use {@link TSDocParser}
31 * @internal
32 */
33 constructor(parameters: IDocSoftBreakParameters | IDocSoftBreakParsedParameters);
34 /** @override */
35 get kind(): DocNodeKind | string;
36 /** @override */
37 protected onGetChildNodes(): ReadonlyArray<DocNode | undefined>;
38}
39//# sourceMappingURL=DocSoftBreak.d.ts.map
\No newline at end of file