1 | import { DocNodeKind, type IDocNodeParameters, DocNode, type IDocNodeParsedParameters } from './DocNode';
|
2 | import type { TokenSequence } from '../parser/TokenSequence';
|
3 | /**
|
4 | * Constructor parameters for {@link DocSoftBreak}.
|
5 | */
|
6 | export interface IDocSoftBreakParameters extends IDocNodeParameters {
|
7 | }
|
8 | /**
|
9 | * Constructor parameters for {@link DocSoftBreak}.
|
10 | */
|
11 | export 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 | */
|
27 | export 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 |