1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162 |
- import { Directives } from '../doc/directives.js';
- import { Document } from '../doc/Document.js';
- import { ErrorCode, YAMLParseError, YAMLWarning } from '../errors.js';
- import type { ParsedNode, Range } from '../nodes/Node.js';
- import type { DocumentOptions, ParseOptions, SchemaOptions } from '../options.js';
- import type { Token } from '../parse/cst.js';
- type ErrorSource = number | [number, number] | Range | {
- offset: number;
- source?: string;
- };
- export type ComposeErrorHandler = (source: ErrorSource, code: ErrorCode, message: string, warning?: boolean) => void;
- /**
- * Compose a stream of CST nodes into a stream of YAML Documents.
- *
- * ```ts
- * import { Composer, Parser } from 'yaml'
- *
- * const src: string = ...
- * const tokens = new Parser().parse(src)
- * const docs = new Composer().compose(tokens)
- * ```
- */
- export declare class Composer<Contents extends ParsedNode = ParsedNode, Strict extends boolean = true> {
- private directives;
- private doc;
- private options;
- private atDirectives;
- private prelude;
- private errors;
- private warnings;
- constructor(options?: ParseOptions & DocumentOptions & SchemaOptions);
- private onError;
- private decorate;
- /**
- * Current stream status information.
- *
- * Mostly useful at the end of input for an empty stream.
- */
- streamInfo(): {
- comment: string;
- directives: Directives;
- errors: YAMLParseError[];
- warnings: YAMLWarning[];
- };
- /**
- * Compose tokens into documents.
- *
- * @param forceDoc - If the stream contains no document, still emit a final document including any comments and directives that would be applied to a subsequent document.
- * @param endOffset - Should be set if `forceDoc` is also set, to set the document range end and to indicate errors correctly.
- */
- compose(tokens: Iterable<Token>, forceDoc?: boolean, endOffset?: number): Generator<Document.Parsed<Contents, Strict>, void, unknown>;
- /** Advance the composer by one CST token. */
- next(token: Token): Generator<Document.Parsed<Contents, Strict>, void, unknown>;
- /**
- * Call at end of input to yield any remaining document.
- *
- * @param forceDoc - If the stream contains no document, still emit a final document including any comments and directives that would be applied to a subsequent document.
- * @param endOffset - Should be set if `forceDoc` is also set, to set the document range end and to indicate errors correctly.
- */
- end(forceDoc?: boolean, endOffset?: number): Generator<Document.Parsed<Contents, Strict>, void, unknown>;
- }
- export {};
|