yaml 3.0.0-1 → 3.0.0-2

package/dist/{directives-DlYEVlkC.d.ts → directives-CGITitH5.d.ts}

@@ -1,21 +1,21 @@
 //#region src/parse/line-counter.d.ts
 /**
-* Tracks newlines during parsing in order to provide an efficient API for
-* determining the one-indexed `{ line, col }` position for any offset
-* within the input.
-*/
+ * Tracks newlines during parsing in order to provide an efficient API for
+ * determining the one-indexed `{ line, col }` position for any offset
+ * within the input.
+ */
 declare class LineCounter {
   lineStarts: number[];
   /**
-  * Should be called in ascending order. Otherwise, call
-  * `lineCounter.lineStarts.sort()` before calling `linePos()`.
-  */
+   * Should be called in ascending order. Otherwise, call
+   * `lineCounter.lineStarts.sort()` before calling `linePos()`.
+   */
   addNewLine: (offset: number) => number;
   /**
-  * Performs a binary search and returns the 1-indexed { line, col }
-  * position of `offset`. If `line === 0`, `addNewLine` has never been
-  * called or `offset` is before the first known newline.
-  */
+   * Performs a binary search and returns the 1-indexed { line, col }
+   * position of `offset`. If `line === 0`, `addNewLine` has never been
+   * called or `offset` is before the first known newline.
+   */
   linePos: (offset: number) => {
     line: number;
     col: number;
@@ -72,6 +72,7 @@ type StringifyContext = {
 //#region src/nodes/toJS.d.ts
 /** A context used in `node.toJS()` implementations */
 declare class ToJSContext {
+  #private;
   anchors: Map<Node, {
     aliasCount: number;
     count: number;
@@ -84,6 +85,7 @@ declare class ToJSContext {
   maxAliasCount: number;
   constructor(opt?: ToJSOptions);
   setAnchor(node: Node, res: unknown): void;
+  resolveAlias(doc: Document, source: Node): unknown;
 }
 //#endregion
 //#region src/doc/NodeCreator.d.ts
@@ -97,10 +99,10 @@ declare class NodeCreator {
   create(value: unknown, tagName?: string): Node;
   createPair(key: unknown, value: unknown): Pair<Node, Node | null>;
   /**
-  * With circular references, the source node is only resolved after all
-  * of its child nodes are. This is why anchors are set only after all of
-  * the nodes have been created.
-  */
+   * With circular references, the source node is only resolved after all
+   * of its child nodes are. This is why anchors are set only after all of
+   * the nodes have been created.
+   */
   setAnchors(): void;
 }
 //#endregion
@@ -127,22 +129,22 @@ declare class Scalar<T = unknown> implements NodeBase {
   /** A comment before this node. */
   commentBefore?: string | null;
   /**
-  * By default (undefined), numbers use decimal notation.
-  * The YAML 1.2 core schema only supports 'HEX' and 'OCT'.
-  * The YAML 1.1 schema also supports 'BIN' and 'TIME'
-  */
+   * By default (undefined), numbers use decimal notation.
+   * The YAML 1.2 core schema only supports 'HEX' and 'OCT'.
+   * The YAML 1.1 schema also supports 'BIN' and 'TIME'
+   */
   format?: string;
   /**
-  * If `value` is a number that is serialized as a decimal string
-  * (i.e. not using exponential notation),
-  * use this value when stringifying this node.
-  */
+   * If `value` is a number that is serialized as a decimal string
+   * (i.e. not using exponential notation),
+   * use this value when stringifying this node.
+   */
   minFractionDigits?: number;
   /**
-  * The `[start, value-end, node-end]` character offsets for
-  * the part of the source parsed into this node (undefined if not parsed).
-  * The `value-end` and `node-end` positions are themselves not included in their respective ranges.
-  */
+   * The `[start, value-end, node-end]` character offsets for
+   * the part of the source parsed into this node (undefined if not parsed).
+   * The `value-end` and `node-end` positions are themselves not included in their respective ranges.
+   */
   range?: Range | null;
   /** A blank line before this node and its commentBefore */
   spaceBefore?: boolean;
@@ -155,10 +157,10 @@ declare class Scalar<T = unknown> implements NodeBase {
   /** The scalar style used for the node's string representation */
   type?: Scalar.Type;
   /**
-  * Customize the way that a key-value pair is resolved.
-  * Used for YAML 1.1 !!merge << handling.
-  */
-  addToJSMap?: (doc: Document<DocValue, boolean>, ctx: ToJSContext | undefined, map: MapLike, value: unknown) => void;
+   * Customize the way that a key-value pair is resolved.
+   * Used for YAML 1.1 !!merge << handling.
+   */
+  addToJSMap?: (doc: Document<DocValue, boolean>, ctx: ToJSContext | undefined, map: MapLike, value: unknown, isPlainObject: boolean) => void;
   constructor(value: T);
   /** Create a copy of this node.  */
   clone(): this;
@@ -184,10 +186,10 @@ declare class YAMLMap<K extends Primitive | Node = Primitive | Node, V extends P
   /** A comment before this map. */
   commentBefore?: string | null;
   /**
-  * The `[start, value-end, node-end]` character offsets for
-  * the part of the source parsed into this map (undefined if not parsed).
-  * The `value-end` and `node-end` positions are themselves not included in their respective ranges.
-  */
+   * The `[start, value-end, node-end]` character offsets for
+   * the part of the source parsed into this map (undefined if not parsed).
+   * The `value-end` and `node-end` positions are themselves not included in their respective ranges.
+   */
   range?: Range | null;
   /** A blank line before this map and its commentBefore */
   spaceBefore?: boolean;
@@ -196,22 +198,22 @@ declare class YAMLMap<K extends Primitive | Node = Primitive | Node, V extends P
   /** A fully qualified tag, if required */
   tag?: string;
   /**
-  * A generic collection factory method that can be used
-  * by other node classes that inherit from YAMLMap
-  */
+   * A generic collection factory method that can be used
+   * by other node classes that inherit from YAMLMap
+   */
   static create(nc: NodeCreator, obj: unknown): YAMLMap<any, any>;
   constructor(schema: Schema, elements?: Array<Pair<K, V>>);
   get size(): number;
   /**
-  * Create a copy of this map.
-  *
-  * @param schema - If defined, overwrites the original's schema
-  */
+   * Create a copy of this map.
+   *
+   * @param schema - If defined, overwrites the original's schema
+   */
   clone(schema?: Schema): this;
   /**
-  * Remove a value from the mapping.
-  * @returns `true` if the item was found and removed.
-  */
+   * Remove a value from the mapping.
+   * @returns `true` if the item was found and removed.
+   */
   delete(key: KeyArg<K, V>): boolean;
   /** Return value at `key`, or `undefined` if not found.  */
   get(key: KeyArg<K, V>): NodeOf<V> | null | undefined;
@@ -220,21 +222,21 @@ declare class YAMLMap<K extends Primitive | Node = Primitive | Node, V extends P
   /** Check if the mapping includes a value with the key `key`.  */
   has(key: KeyArg<K, V>): boolean;
   /**
-  * Return the internal Map key matching `key`, or `undefined` if not found.
-  *
-  * @param allowMissing - If `true`, a key is always returned,
-  *                       even if the key is not in the map.
-  */
+   * Return the internal Map key matching `key`, or `undefined` if not found.
+   *
+   * @param allowMissing - If `true`, a key is always returned,
+   *                       even if the key is not in the map.
+   */
   keyOf(key: KeyArg<K, V>, allowMissing?: boolean): unknown;
   pairs(): Iterable<Pair<K, V>>;
   set(key: K | NodeOf<K> | (K extends Scalar ? K["value"] : never), value: V | NodeOf<V> | (V extends Scalar ? V["value"] : never) | null, options?: Omit<CreateNodeOptions, "aliasDuplicateObjects">): this;
   set(pair: Pair<K, V>): this;
   /**
-  * A plain JavaScript representation of this node.
-  *
-  * @param Type - If set, forces the returned collection type
-  * @returns Instance of Type, Map, or Object
-  */
+   * A plain JavaScript representation of this node.
+   *
+   * @param Type - If set, forces the returned collection type
+   * @returns Instance of Type, Map, or Object
+   */
   toJS<T extends MapLike = Map<any, any>>(doc: Document<DocValue, boolean>, ctx: ToJSContext | undefined, Type: {
     new (): T;
   }): T;
@@ -243,10 +245,7 @@ declare class YAMLMap<K extends Primitive | Node = Primitive | Node, V extends P
 }
 //#endregion
 //#region src/nodes/addPairToJSMap.d.ts
-declare function addPairToJSMap(doc: Document<DocValue, boolean>, ctx: ToJSContext, map: MapLike, {
-  key,
-  value
-}: Pair): MapLike;
+declare function addPairToJSMap(doc: Document<DocValue, boolean>, ctx: ToJSContext, map: MapLike, { key, value }: Pair, isPlainObject: boolean): MapLike;
 //#endregion
 //#region src/nodes/Pair.d.ts
 declare class Pair<K extends Primitive | Node = Primitive | Node, V extends Primitive | Node = Primitive | Node> {
@@ -266,62 +265,62 @@ declare class Pair<K extends Primitive | Node = Primitive | Node, V extends Prim
 //#region src/schema/types.d.ts
 interface TagBase {
   /**
-  * An optional factory function, used e.g. by collections when wrapping JS objects as AST nodes.
-  */
+   * An optional factory function, used e.g. by collections when wrapping JS objects as AST nodes.
+   */
   createNode?: (nc: NodeCreator, value: unknown) => Node;
   /**
-  * If `true`, allows for values to be stringified without
-  * an explicit tag together with `test`.
-  * If `'key'`, this only applies if the value is used as a mapping key.
-  * For most cases, it's unlikely that you'll actually want to use this,
-  * even if you first think you do.
-  */
+   * If `true`, allows for values to be stringified without
+   * an explicit tag together with `test`.
+   * If `'key'`, this only applies if the value is used as a mapping key.
+   * For most cases, it's unlikely that you'll actually want to use this,
+   * even if you first think you do.
+   */
   default?: boolean | "key";
   /**
-  * If a tag has multiple forms that should be parsed and/or stringified
-  * differently, use `format` to identify them.
-  */
+   * If a tag has multiple forms that should be parsed and/or stringified
+   * differently, use `format` to identify them.
+   */
   format?: string;
   /**
-  * Used by `YAML.createNode` to detect your data type, e.g. using `typeof` or
-  * `instanceof`.
-  */
+   * Used by `YAML.createNode` to detect your data type, e.g. using `typeof` or
+   * `instanceof`.
+   */
   identify?: (value: unknown) => boolean;
   /**
-  * The identifier for your data type, with which its stringified form will be
-  * prefixed. Should either be a !-prefixed local `!tag`, or a fully qualified
-  * `tag:domain,date:foo`.
-  */
+   * The identifier for your data type, with which its stringified form will be
+   * prefixed. Should either be a !-prefixed local `!tag`, or a fully qualified
+   * `tag:domain,date:foo`.
+   */
   tag: string;
 }
 interface ScalarTag extends TagBase {
   collection?: never;
   nodeClass?: never;
   /**
-  * Turns a value into an AST node.
-  * If returning a non-`Node` value, the output will be wrapped as a `Scalar`.
-  */
+   * Turns a value into an AST node.
+   * If returning a non-`Node` value, the output will be wrapped as a `Scalar`.
+   */
   resolve(value: string, onError: (message: string) => void, options: ParseOptions): unknown;
   /**
-  * Optional function stringifying a Scalar node. If your data includes a
-  * suitable `.toString()` method, you can probably leave this undefined and
-  * use the default stringifier.
-  *
-  * @param item The node being stringified.
-  * @param ctx Contains the stringifying context variables.
-  * @param onComment Callback to signal that the stringifier includes the
-  *   item's comment in its output.
-  * @param onChompKeep Callback to signal that the output uses a block scalar
-  *   type with the `+` chomping indicator.
-  */
+   * Optional function stringifying a Scalar node. If your data includes a
+   * suitable `.toString()` method, you can probably leave this undefined and
+   * use the default stringifier.
+   *
+   * @param item The node being stringified.
+   * @param ctx Contains the stringifying context variables.
+   * @param onComment Callback to signal that the stringifier includes the
+   *   item's comment in its output.
+   * @param onChompKeep Callback to signal that the output uses a block scalar
+   *   type with the `+` chomping indicator.
+   */
   stringify?: (item: Scalar, ctx: StringifyContext, onComment?: () => void, onChompKeep?: () => void) => string;
   /**
-  * Together with `default` allows for values to be stringified without an
-  * explicit tag and detected using a regular expression. For most cases, it's
-  * unlikely that you'll actually want to use these, even if you first think
-  * you do.
-  */
-  test?: RegExp;
+   * Together with `default` allows for values to be stringified without an
+   * explicit tag and detected using a regular expression or a test function.
+   * For most cases, it's unlikely that you'll actually want to use these,
+   * even if you first think you do.
+   */
+  test?: (value: string) => boolean;
 }
 interface CollectionTag extends TagBase {
   stringify?: never;
@@ -330,50 +329,46 @@ interface CollectionTag extends TagBase {
   collection: "map" | "seq";
   createNode: (nc: NodeCreator, value: unknown) => Node;
   /**
-  * The `Node` child class that implements this tag.
-  * If set, used to select this tag when stringifying.
-  */
+   * The `Node` child class that implements this tag.
+   * If set, used to select this tag when stringifying.
+   */
   nodeClass?: {
     new (schema: Schema): Node;
   };
   /**
-  * Turns a value into an AST node.
-  * If returning a non-`Node` value, the output will be wrapped as a `Scalar`.
-  *
-  * Note: this is required if nodeClass is not provided.
-  */
+   * Turns a value into an AST node.
+   * If returning a non-`Node` value, the output will be wrapped as a `Scalar`.
+   *
+   * Note: this is required if nodeClass is not provided.
+   */
   resolve?: (value: Collection, onError: (message: string) => void, options: ParseOptions) => unknown;
 }
 //#endregion
 //#region src/schema/tags.d.ts
+type WithScalarTagTest = {
+  test: (value: string) => boolean;
+};
 declare const tagsByName: {
   binary: ScalarTag;
-  bool: ScalarTag & {
-    test: RegExp;
-  };
-  float: ScalarTag;
-  floatExp: ScalarTag;
-  floatNaN: ScalarTag;
-  floatTime: ScalarTag;
-  int: ScalarTag;
-  intHex: ScalarTag;
-  intOct: ScalarTag;
-  intTime: ScalarTag;
+  bool: ScalarTag & WithScalarTagTest;
+  float: ScalarTag & WithScalarTagTest;
+  floatExp: ScalarTag & WithScalarTagTest;
+  floatNaN: ScalarTag & WithScalarTagTest;
+  floatTime: ScalarTag & WithScalarTagTest;
+  int: ScalarTag & WithScalarTagTest;
+  intHex: ScalarTag & WithScalarTagTest;
+  intOct: ScalarTag & WithScalarTagTest;
+  intTime: ScalarTag & WithScalarTagTest;
   map: CollectionTag;
   merge: ScalarTag & {
     identify(value: unknown): boolean;
-    test: RegExp;
-  };
-  null: ScalarTag & {
-    test: RegExp;
-  };
+  } & WithScalarTagTest;
+  null: ScalarTag & WithScalarTagTest;
   omap: CollectionTag;
   pairs: CollectionTag;
   seq: CollectionTag;
   set: CollectionTag;
-  timestamp: ScalarTag & {
-    test: RegExp;
-  };
+  timestamp: ScalarTag & WithScalarTagTest;
 };
 type TagId = keyof typeof tagsByName;
 type Tags = Array<ScalarTag | CollectionTag | TagId>;
@@ -381,331 +376,332 @@ type Tags = Array<ScalarTag | CollectionTag | TagId>;
 //#region src/options.d.ts
 type ParseOptions = {
   /**
-  * Whether integers should be parsed into BigInt rather than number values.
-  *
-  * Default: `false`
-  *
-  * https://developer.mozilla.org/en/docs/Web/JavaScript/Reference/Global_Objects/BigInt
-  */
+   * Whether integers should be parsed into BigInt rather than number values.
+   *
+   * Default: `false`
+   *
+   * https://developer.mozilla.org/en/docs/Web/JavaScript/Reference/Global_Objects/BigInt
+   */
   intAsBigInt?: boolean;
   /**
-  * Include a `srcToken` value on each parsed `Node`, containing the CST token
-  * that was composed into this node.
-  *
-  * Default: `false`
-  */
+   * Include a `srcToken` value on each parsed `Node`, containing the CST token
+   * that was composed into this node.
+   *
+   * Default: `false`
+   */
   keepSourceTokens?: boolean;
   /**
-  * If set, newlines will be tracked, to allow for `lineCounter.linePos(offset)`
-  * to provide the `{ line, col }` positions within the input.
-  */
+   * If set, newlines will be tracked, to allow for `lineCounter.linePos(offset)`
+   * to provide the `{ line, col }` positions within the input.
+   */
   lineCounter?: LineCounter;
   /**
-  * Include line/col position & node type directly in parse errors.
-  *
-  * Default: `true`
-  */
+   * Include line/col position & node type directly in parse errors.
+   *
+   * Default: `true`
+   */
   prettyErrors?: boolean;
   /**
-  * Detect and report errors that are required by the YAML 1.2 spec,
-  * but are caused by unambiguous content.
-  *
-  * Default: `true`
-  */
+   * Detect and report errors that are required by the YAML 1.2 spec,
+   * but are caused by unambiguous content.
+   *
+   * Default: `true`
+   */
   strict?: boolean;
   /**
-  * Parse all mapping keys as strings. Treat all non-scalar keys as errors.
-  *
-  * Default: `false`
-  */
+   * Parse all mapping keys as strings. Treat all non-scalar keys as errors.
+   *
+   * Default: `false`
+   */
   stringKeys?: boolean;
 };
 type DocumentOptions = {
   /**
-  * Control the logging level during parsing
-  *
-  * Default: `'warn'`
-  */
+   * Control the logging level during parsing
+   *
+   * Default: `'warn'`
+   */
   logLevel?: LogLevelId;
   /**
-  * The YAML version used by documents without a `%YAML` directive.
-  *
-  * Default: `"1.2"`
-  */
+   * The YAML version used by documents without a `%YAML` directive.
+   *
+   * Default: `"1.2"`
+   */
   version?: "1.1" | "1.2" | "next";
 };
 type SchemaOptions = {
   /**
-  * When parsing, warn about compatibility issues with the given schema.
-  * When stringifying, use scalar styles that are parsed correctly
-  * by the `compat` schema as well as the actual schema.
-  *
-  * Default: `null`
-  */
+   * When parsing, warn about compatibility issues with the given schema.
+   * When stringifying, use scalar styles that are parsed correctly
+   * by the `compat` schema as well as the actual schema.
+   *
+   * Default: `null`
+   */
   compat?: string | Tags | null;
   /**
-  * Array of additional tags to include in the schema, or a function that may
-  * modify the schema's base tag array.
-  */
+   * Array of additional tags to include in the schema, or a function that may
+   * modify the schema's base tag array.
+   */
   customTags?: Tags | ((tags: Tags) => Tags) | null;
   /**
-  * Determine an internal Map key representation for map and set values,
-  * which is used for detecting duplicates and to identify values.
-  *
-  * Key equality is based on the SameValueZero algorithm.
-  *
-  * If merge keys are enabled by the schema,
-  * multiple `<<` keys are each considered unique.
-  */
+   * Determine an internal Map key representation for map and set values,
+   * which is used for detecting duplicates and to identify values.
+   *
+   * Key equality is based on the SameValueZero algorithm.
+   *
+   * If merge keys are enabled by the schema,
+   * multiple `<<` keys are each considered unique.
+   */
   mapKey?: (value: unknown) => unknown;
   /**
-  * Enable support for `<<` merge keys.
-  *
-  * Default: `false` for YAML 1.2, `true` for earlier versions
-  */
+   * Enable support for `<<` merge keys.
+   *
+   * Default: `false` for YAML 1.2, `true` for earlier versions
+   */
   merge?: boolean;
   /**
-  * When using the `'core'` schema, support parsing values with these
-  * explicit YAML 1.1 tags:
-  *
-  * `!!binary`, `!!omap`, `!!pairs`, `!!set`, `!!timestamp`.
-  *
-  * Default `true`
-  */
+   * When using the `'core'` schema, support parsing values with these
+   * explicit YAML 1.1 tags:
+   *
+   * `!!binary`, `!!omap`, `!!pairs`, `!!set`, `!!timestamp`.
+   *
+   * Default `true`
+   */
   resolveKnownTags?: boolean;
   /**
-  * The base schema to use.
-  *
-  * The core library has built-in support for the following:
-  * - `'failsafe'`: A minimal schema that parses all scalars as strings
-  * - `'core'`: The YAML 1.2 core schema
-  * - `'json'`: The YAML 1.2 JSON schema, with minimal rules for JSON compatibility
-  * - `'yaml-1.1'`: The YAML 1.1 schema
-  *
-  * If using another (custom) schema, the `customTags` array needs to
-  * fully define the schema's tags.
-  *
-  * Default: `'core'` for YAML 1.2, `'yaml-1.1'` for earlier versions
-  */
+   * The base schema to use.
+   *
+   * The core library has built-in support for the following:
+   * - `'failsafe'`: A minimal schema that parses all scalars as strings
+   * - `'core'`: The YAML 1.2 core schema
+   * - `'json'`: The YAML 1.2 JSON schema, with minimal rules for JSON compatibility
+   * - `'yaml-1.1'`: The YAML 1.1 schema
+   *
+   * If using another (custom) schema, the `customTags` array needs to
+   * fully define the schema's tags.
+   *
+   * Default: `'core'` for YAML 1.2, `'yaml-1.1'` for earlier versions
+   */
   schema?: string | Schema;
   /**
-  * Override default values for `toString()` options.
-  */
+   * Override default values for `toString()` options.
+   */
   toStringDefaults?: ToStringOptions;
 };
 type CreateNodeOptions = {
   /**
-  * During node construction, use anchors and aliases to keep strictly equal
-  * non-null objects as equivalent in YAML.
-  *
-  * Default: `true`
-  */
+   * During node construction, use anchors and aliases to keep strictly equal
+   * non-null objects as equivalent in YAML.
+   *
+   * Default: `true`
+   */
   aliasDuplicateObjects?: boolean;
   /**
-  * Default prefix for anchors.
-  *
-  * Default: `'a'`, resulting in anchors `a1`, `a2`, etc.
-  */
-  anchorPrefix?: string; /** Force the top-level collection node to use flow style. */
+   * Default prefix for anchors.
+   *
+   * Default: `'a'`, resulting in anchors `a1`, `a2`, etc.
+   */
+  anchorPrefix?: string;
+  /** Force the top-level collection node to use flow style. */
   flow?: boolean;
   /**
-  * Keep `undefined` object values when creating mappings, rather than
-  * discarding them.
-  *
-  * Default: `false`
-  */
+   * Keep `undefined` object values when creating mappings, rather than
+   * discarding them.
+   *
+   * Default: `false`
+   */
   keepUndefined?: boolean | null;
   onTagObj?: (tagObj: ScalarTag | CollectionTag) => void;
   /**
-  * Specify the top-level collection type, e.g. `"!!omap"`. Note that this
-  * requires the corresponding tag to be available in this document's schema.
-  */
+   * Specify the top-level collection type, e.g. `"!!omap"`. Note that this
+   * requires the corresponding tag to be available in this document's schema.
+   */
   tag?: string;
 };
 type ToJSOptions = {
   /**
-  * Use Map rather than Object to represent mappings.
-  *
-  * Default: `false`
-  */
+   * Use Map rather than Object to represent mappings.
+   *
+   * Default: `false`
+   */
   mapAsMap?: boolean;
   /**
-  * Prevent exponential entity expansion attacks by limiting data aliasing count;
-  * set to `-1` to disable checks; `0` disallows all alias nodes.
-  *
-  * Default: `100`
-  */
+   * Prevent exponential entity expansion attacks by limiting data aliasing count;
+   * set to `-1` to disable checks; `0` disallows all alias nodes.
+   *
+   * Default: `100`
+   */
   maxAliasCount?: number;
   /**
-  * If defined, called with the resolved `value` and reference `count` for
-  * each anchor in the document.
-  */
+   * If defined, called with the resolved `value` and reference `count` for
+   * each anchor in the document.
+   */
   onAnchor?: (value: unknown, count: number) => void;
   /**
-  * Optional function that may filter or modify the output JS value
-  *
-  * https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/parse#using_the_reviver_parameter
-  */
+   * Optional function that may filter or modify the output JS value
+   *
+   * https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/parse#using_the_reviver_parameter
+   */
   reviver?: Reviver;
 };
 type ToStringOptions = {
   /**
-  * Use block quote styles for scalar values where applicable.
-  * Set to `false` to disable block quotes completely.
-  *
-  * Default: `true`
-  */
+   * Use block quote styles for scalar values where applicable.
+   * Set to `false` to disable block quotes completely.
+   *
+   * Default: `true`
+   */
   blockQuote?: boolean | "folded" | "literal";
   /**
-  * Enforce `'block'` or `'flow'` style on maps and sequences.
-  * Empty collections will always be stringified as `{}` or `[]`.
-  *
-  * Default: `'any'`, allowing each node to set its style separately
-  * with its `flow: boolean` (default `false`) property.
-  */
+   * Enforce `'block'` or `'flow'` style on maps and sequences.
+   * Empty collections will always be stringified as `{}` or `[]`.
+   *
+   * Default: `'any'`, allowing each node to set its style separately
+   * with its `flow: boolean` (default `false`) property.
+   */
   collectionStyle?: "any" | "block" | "flow";
   /**
-  * Comment stringifier.
-  * Output should be valid for the current schema.
-  *
-  * By default, empty comment lines are left empty,
-  * lines consisting of a single space are replaced by `#`,
-  * and all other lines are prefixed with a `#`.
-  */
+   * Comment stringifier.
+   * Output should be valid for the current schema.
+   *
+   * By default, empty comment lines are left empty,
+   * lines consisting of a single space are replaced by `#`,
+   * and all other lines are prefixed with a `#`.
+   */
   commentString?: (comment: string) => string;
   /**
-  * The default type of string literal used to stringify implicit key values.
-  * Output may use other types if required to fully represent the value.
-  *
-  * If `null`, the value of `defaultStringType` is used.
-  *
-  * Default: `null`
-  */
+   * The default type of string literal used to stringify implicit key values.
+   * Output may use other types if required to fully represent the value.
+   *
+   * If `null`, the value of `defaultStringType` is used.
+   *
+   * Default: `null`
+   */
   defaultKeyType?: Scalar.Type | null;
   /**
-  * The default type of string literal used to stringify values in general.
-  * Output may use other types if required to fully represent the value.
-  *
-  * Default: `'PLAIN'`
-  */
+   * The default type of string literal used to stringify values in general.
+   * Output may use other types if required to fully represent the value.
+   *
+   * Default: `'PLAIN'`
+   */
   defaultStringType?: Scalar.Type;
   /**
-  * Include directives in the output.
-  *
-  * - If `true`, at least the document-start marker `---` is always included.
-  *   This does not force the `%YAML` directive to be included. To do that,
-  *   set `doc.directives.yaml.explicit = true`.
-  * - If `false`, no directives or marker is ever included. If using the `%TAG`
-  *   directive, you are expected to include it manually in the stream before
-  *   its use.
-  * - If `null`, directives and marker may be included if required.
-  *
-  * Default: `null`
-  */
+   * Include directives in the output.
+   *
+   * - If `true`, at least the document-start marker `---` is always included.
+   *   This does not force the `%YAML` directive to be included. To do that,
+   *   set `doc.directives.yaml.explicit = true`.
+   * - If `false`, no directives or marker is ever included. If using the `%TAG`
+   *   directive, you are expected to include it manually in the stream before
+   *   its use.
+   * - If `null`, directives and marker may be included if required.
+   *
+   * Default: `null`
+   */
   directives?: boolean | null;
   /**
-  * Restrict double-quoted strings to use JSON-compatible syntax.
-  *
-  * Default: `false`
-  */
+   * Restrict double-quoted strings to use JSON-compatible syntax.
+   *
+   * Default: `false`
+   */
   doubleQuotedAsJSON?: boolean;
   /**
-  * Minimum length for double-quoted strings to use multiple lines to
-  * represent the value. Ignored if `doubleQuotedAsJSON` is set.
-  *
-  * Default: `40`
-  */
+   * Minimum length for double-quoted strings to use multiple lines to
+   * represent the value. Ignored if `doubleQuotedAsJSON` is set.
+   *
+   * Default: `40`
+   */
   doubleQuotedMinMultiLineLength?: number;
   /**
-  * String representation for `false`.
-  * With the core schema, use `'false'`, `'False'`, or `'FALSE'`.
-  *
-  * Default: `'false'`
-  */
+   * String representation for `false`.
+   * With the core schema, use `'false'`, `'False'`, or `'FALSE'`.
+   *
+   * Default: `'false'`
+   */
   falseStr?: string;
   /**
-  * When true, a single space of padding will be added inside the delimiters
-  * of non-empty single-line flow collections.
-  *
-  * Default: `true`
-  */
+   * When true, a single space of padding will be added inside the delimiters
+   * of non-empty single-line flow collections.
+   *
+   * Default: `true`
+   */
   flowCollectionPadding?: boolean;
   /**
-  * The number of spaces to use when indenting code.
-  *
-  * Default: `2`
-  */
+   * The number of spaces to use when indenting code.
+   *
+   * Default: `2`
+   */
   indent?: number;
   /**
-  * Whether block sequences should be indented.
-  *
-  * Default: `true`
-  */
+   * Whether block sequences should be indented.
+   *
+   * Default: `true`
+   */
   indentSeq?: boolean;
   /**
-  * Maximum line width (set to `0` to disable folding).
-  *
-  * This is a soft limit, as only double-quoted semantics allow for inserting
-  * a line break in the middle of a word, as well as being influenced by the
-  * `minContentWidth` option.
-  *
-  * Default: `80`
-  */
+   * Maximum line width (set to `0` to disable folding).
+   *
+   * This is a soft limit, as only double-quoted semantics allow for inserting
+   * a line break in the middle of a word, as well as being influenced by the
+   * `minContentWidth` option.
+   *
+   * Default: `80`
+   */
   lineWidth?: number;
   /**
-  * Minimum line width for highly-indented content (set to `0` to disable).
-  *
-  * Default: `20`
-  */
+   * Minimum line width for highly-indented content (set to `0` to disable).
+   *
+   * Default: `20`
+   */
   minContentWidth?: number;
   /**
-  * String representation for `null`.
-  * With the core schema, use `'null'`, `'Null'`, `'NULL'`, `'~'`, or an empty
-  * string `''`.
-  *
-  * Default: `'null'`
-  */
+   * String representation for `null`.
+   * With the core schema, use `'null'`, `'Null'`, `'NULL'`, `'~'`, or an empty
+   * string `''`.
+   *
+   * Default: `'null'`
+   */
   nullStr?: string;
   /**
-  * Require keys to be scalars and to use implicit rather than explicit notation.
-  *
-  * Default: `false`
-  */
+   * Require keys to be scalars and to use implicit rather than explicit notation.
+   *
+   * Default: `false`
+   */
   simpleKeys?: boolean;
   /**
-  * Use 'single quote' rather than "double quote" where applicable.
-  * Set to `false` to disable single quotes completely.
-  *
-  * Default: `null`
-  */
+   * Use 'single quote' rather than "double quote" where applicable.
+   * Set to `false` to disable single quotes completely.
+   *
+   * Default: `null`
+   */
   singleQuote?: boolean | null;
   /**
-  * When stringifying a map or a set, sort the entries.
-  * If `true`, sort by comparing key values with `<`.
-  *
-  * Default: `false`
-  */
+   * When stringifying a map or a set, sort the entries.
+   * If `true`, sort by comparing key values with `<`.
+   *
+   * Default: `false`
+   */
   sortMapEntries?: boolean | ((a: Pair, b: Pair) => number);
   /**
-  * Add a trailing comma after the last entry in a flow map or flow sequence that's split across multiple lines.
-  *
-  * Default: `'false'`
-  */
+   * Add a trailing comma after the last entry in a flow map or flow sequence that's split across multiple lines.
+   *
+   * Default: `'false'`
+   */
   trailingComma?: boolean;
   /**
-  * String representation for `true`.
-  * With the core schema, use `'true'`, `'True'`, or `'TRUE'`.
-  *
-  * Default: `'true'`
-  */
+   * String representation for `true`.
+   * With the core schema, use `'true'`, `'True'`, or `'TRUE'`.
+   *
+   * Default: `'true'`
+   */
   trueStr?: string;
   /**
-  * The anchor used by an alias must be defined before the alias node. As it's
-  * possible for the document to be modified manually, the order may be
-  * verified during stringification.
-  *
-  * Default: `'true'`
-  */
+   * The anchor used by an alias must be defined before the alias node. As it's
+   * possible for the document to be modified manually, the order may be
+   * verified during stringification.
+   *
+   * Default: `'true'`
+   */
   verifyAliasOrder?: boolean;
 };
 //#endregion
@@ -717,15 +713,7 @@ declare class Schema {
   name: string;
   tags: Array<CollectionTag | ScalarTag>;
   toStringOptions: Readonly<ToStringOptions> | null;
-  constructor({
-    compat,
-    customTags,
-    mapKey,
-    merge,
-    resolveKnownTags,
-    schema,
-    toStringDefaults
-  }: SchemaOptions);
+  constructor({ compat, customTags, mapKey, merge, resolveKnownTags, schema, toStringDefaults }: SchemaOptions);
   clone(): Schema;
 }
 //#endregion
@@ -747,19 +735,19 @@ declare class YAMLSeq<T extends Primitive | Node | Pair = Primitive | Node | Pai
   /** An optional anchor on this collection. Used by alias nodes. */
   anchor?: string;
   /**
-  * If true, stringify this and all child nodes using flow rather than
-  * block styles.
-  */
+   * If true, stringify this and all child nodes using flow rather than
+   * block styles.
+   */
   flow?: boolean;
   /** A comment on or immediately after this collection. */
   comment?: string | null;
   /** A comment before this collection. */
   commentBefore?: string | null;
   /**
-  * The `[start, value-end, node-end]` character offsets for
-  * the part of the source parsed into this collection (undefined if not parsed).
-  * The `value-end` and `node-end` positions are themselves not included in their respective ranges.
-  */
+   * The `[start, value-end, node-end]` character offsets for
+   * the part of the source parsed into this collection (undefined if not parsed).
+   * The `value-end` and `node-end` positions are themselves not included in their respective ranges.
+   */
   range?: Range | null;
   /** A blank line before this collection and its commentBefore */
   spaceBefore?: boolean;
@@ -768,50 +756,50 @@ declare class YAMLSeq<T extends Primitive | Node | Pair = Primitive | Node | Pai
   /** A fully qualified tag, if required */
   tag?: string;
   /**
-  * A generic collection factory method that can be extended
-  * to other node classes that inherit from YAMLSeq
-  */
+   * A generic collection factory method that can be extended
+   * to other node classes that inherit from YAMLSeq
+   */
   static create(nc: NodeCreator, obj: unknown): YAMLSeq;
   constructor(schema: Schema, elements?: Array<T | NodeOf<T>>);
   get size(): number;
   /**
-  * Create a copy of this collection.
-  *
-  * @param schema - If defined, overwrites the original's schema
-  */
+   * Create a copy of this collection.
+   *
+   * @param schema - If defined, overwrites the original's schema
+   */
   clone(schema?: Schema): this;
   /**
-  * Change all elements within a range of indices in this sequence to a static value.
-  *
-  * Non-node values are converted to Node values.
-  */
+   * Change all elements within a range of indices in this sequence to a static value.
+   *
+   * Non-node values are converted to Node values.
+   */
   fill(value: T | NodeOf<T>, start?: number, end?: number): this;
   /** @private */
   _push(item: NodeOf<T>): void;
   /**
-  * Append new elements to this sequence, and return its new length.
-  *
-  * Non-node values are converted to Node values.
-  */
+   * Append new elements to this sequence, and return its new length.
+   *
+   * Non-node values are converted to Node values.
+   */
   push(...values: Array<T | NodeOf<T>>): number;
   /**
-  * Set a value in this sequence.
-  *
-  * Non-node values are converted to Node values.
-  */
+   * Set a value in this sequence.
+   *
+   * Non-node values are converted to Node values.
+   */
   set(idx: number, value: T | NodeOf<T>, options?: Omit<CreateNodeOptions, "aliasDuplicateObjects">): void;
   /**
-  * Changes the contents of this sequence by removing or replacing existing elements
-  * and/or adding new elements in place.
-  *
-  * Non-node values are converted to Node values.
-  */
+   * Changes the contents of this sequence by removing or replacing existing elements
+   * and/or adding new elements in place.
+   *
+   * Non-node values are converted to Node values.
+   */
   splice(start: number, deleteCount?: number, ...values: Array<T | NodeOf<T>>): NodeOf<T>[];
   /**
-  * Prepend new elements to this sequence, and return its new length.
-  *
-  * Non-node values are converted to Node values.
-  */
+   * Prepend new elements to this sequence, and return its new length.
+   *
+   * Non-node values are converted to Node values.
+   */
   unshift(...values: Array<T | NodeOf<T>>): number;
   /** A plain JavaScript representation of this node. */
   toJS(doc: Document<DocValue, boolean>, ctx?: ToJSContext): any[];
@@ -833,24 +821,24 @@ declare const string: ScalarTag;
 //#endregion
 //#region src/stringify/foldFlowLines.d.ts
 /**
-* `'block'` prevents more-indented lines from being folded;
-* `'quoted'` allows for `\` escapes, including escaped newlines
-*/
+ * `'block'` prevents more-indented lines from being folded;
+ * `'quoted'` allows for `\` escapes, including escaped newlines
+ */
 type FoldMode = "flow" | "block" | "quoted";
 interface FoldOptions {
   /**
-  * Accounts for leading contents on the first line, defaulting to
-  * `indent.length`
-  */
+   * Accounts for leading contents on the first line, defaulting to
+   * `indent.length`
+   */
   indentAtStart?: number;
   /** Default: `80` */
   lineWidth?: number;
   /**
-  * Allow highly indented lines to stretch the line width or indent content
-  * from the start.
-  *
-  * Default: `20`
-  */
+   * Allow highly indented lines to stretch the line width or indent content
+   * from the start.
+   *
+   * Default: `20`
+   */
   minContentWidth?: number;
   /** Called once if the text is folded */
   onFold?: () => void;
@@ -858,25 +846,14 @@ interface FoldOptions {
   onOverflow?: () => void;
 }
 /**
-* Tries to keep input at up to `lineWidth` characters, splitting only on spaces
-* not followed by newlines or spaces unless `mode` is `'quoted'`. Lines are
-* terminated with `\n` and started with `indent`.
-*/
-declare function foldFlowLines(text: string, indent: string, mode?: FoldMode, {
-  indentAtStart,
-  lineWidth,
-  minContentWidth,
-  onFold,
-  onOverflow
-}?: FoldOptions): string;
+ * Tries to keep input at up to `lineWidth` characters, splitting only on spaces
+ * not followed by newlines or spaces unless `mode` is `'quoted'`. Lines are
+ * terminated with `\n` and started with `indent`.
+ */
+declare function foldFlowLines(text: string, indent: string, mode?: FoldMode, { indentAtStart, lineWidth, minContentWidth, onFold, onOverflow }?: FoldOptions): string;
 //#endregion
 //#region src/stringify/stringifyNumber.d.ts
-declare function stringifyNumber({
-  format,
-  minFractionDigits,
-  tag,
-  value
-}: Scalar): string;
+declare function stringifyNumber({ format, minFractionDigits, source, tag, value }: Scalar, version?: "1.1" | "1.2"): string;
 //#endregion
 //#region src/stringify/stringifyString.d.ts
 interface StringifyScalar {
@@ -903,10 +880,10 @@ declare class YAMLSet<T extends Primitive | Node = Primitive | Node> implements
   /** A comment before this set. */
   commentBefore?: string | null;
   /**
-  * The `[start, value-end, node-end]` character offsets for
-  * the part of the source parsed into this set (undefined if not parsed).
-  * The `value-end` and `node-end` positions are themselves not included in their respective ranges.
-  */
+   * The `[start, value-end, node-end]` character offsets for
+   * the part of the source parsed into this set (undefined if not parsed).
+   * The `value-end` and `node-end` positions are themselves not included in their respective ranges.
+   */
   range?: Range | null;
   /** A blank line before this set and its commentBefore */
   spaceBefore?: boolean;
@@ -916,26 +893,26 @@ declare class YAMLSet<T extends Primitive | Node = Primitive | Node> implements
   get size(): number;
   add(value: T | NodeOf<T>, options?: Omit<CreateNodeOptions, "aliasDuplicateObjects">): this;
   /**
-  * Create a copy of this set.
-  *
-  * @param schema - If defined, overwrites the original's schema
-  */
+   * Create a copy of this set.
+   *
+   * @param schema - If defined, overwrites the original's schema
+   */
   clone(schema?: Schema): this;
   /**
-  * Remove `value` from the set.
-  * @returns `true` if the item was found and removed.
-  */
+   * Remove `value` from the set.
+   * @returns `true` if the item was found and removed.
+   */
   delete(value: T | NodeOf<T>): boolean;
   /** Return the node matching `value`, if the set includes it.  */
   get(value: T | NodeOf<T>): NodeOf<T> | undefined;
   /** Check if the set includes `value`.  */
   has(value: T | NodeOf<T>): boolean;
   /**
-  * Return the internal Map key matching `value`, or `undefined` if not found.
-  *
-  * @param allowMissing - If `true`, a key is always returned,
-  *                       even if the value is not in the set.
-  */
+   * Return the internal Map key matching `value`, or `undefined` if not found.
+   *
+   * @param allowMissing - If `true`, a key is always returned,
+   *                       even if the value is not in the set.
+   */
   keyOf(value: T | NodeOf<T>, allowMissing?: boolean): unknown;
   /** A plain JavaScript representation of this set. */
   toJS(doc: Document<DocValue, boolean>, ctx?: ToJSContext): Set<any>;
@@ -958,11 +935,11 @@ interface NodeBase {
   /** A comment before this */
   commentBefore?: string | null;
   /**
-  * The `[start, value-end, node-end]` character offsets for the part of the
-  * source parsed into this node (undefined if not parsed). The `value-end`
-  * and `node-end` positions are themselves not included in their respective
-  * ranges.
-  */
+   * The `[start, value-end, node-end]` character offsets for the part of the
+   * source parsed into this node (undefined if not parsed). The `value-end`
+   * and `node-end` positions are themselves not included in their respective
+   * ranges.
+   */
   range?: Range | null;
   /** A blank line before this node and its commentBefore */
   spaceBefore?: boolean;
@@ -971,10 +948,10 @@ interface NodeBase {
   /** A fully qualified tag, if required */
   tag?: string;
   /**
-  * Create a copy of this node.
-  *
-  * @param schema - If defined, overwrites the original's schema for cloned collections.
-  */
+   * Create a copy of this node.
+   *
+   * @param schema - If defined, overwrites the original's schema for cloned collections.
+   */
   clone(schema?: Schema): this;
   /** A plain JavaScript representation of this node. */
   toJS(doc: Document<DocValue, boolean>, opt?: ToJSContext): any;
@@ -994,9 +971,9 @@ interface CollectionBase extends NodeBase {
 //#endregion
 //#region src/parse/cst-scalar.d.ts
 /**
-* If `token` is a CST flow or block scalar, determine its string value and a few other attributes.
-* Otherwise, return `null`.
-*/
+ * If `token` is a CST flow or block scalar, determine its string value and a few other attributes.
+ * Otherwise, return `null`.
+ */
 declare function resolveAsScalar(token: FlowScalar | BlockScalar, strict?: boolean, onError?: (offset: number, code: ErrorCode, message: string) => void): {
   value: string;
   type: Scalar.Type | null;
@@ -1010,19 +987,19 @@ declare function resolveAsScalar(token: Token | null | undefined, strict?: boole
   range: Range;
 } | null;
 /**
-* Create a new scalar token with `value`
-*
-* Values that represent an actual string but may be parsed as a different type should use a `type` other than `'PLAIN'`,
-* as this function does not support any schema operations and won't check for such conflicts.
-*
-* @param value The string representation of the value, which will have its content properly indented.
-* @param context.end Comments and whitespace after the end of the value, or after the block scalar header. If undefined, a newline will be added.
-* @param context.implicitKey Being within an implicit key may affect the resolved type of the token's value.
-* @param context.indent The indent level of the token.
-* @param context.inFlow Is this scalar within a flow collection? This may affect the resolved type of the token's value.
-* @param context.offset The offset position of the token.
-* @param context.type The preferred type of the scalar token. If undefined, the previous type of the `token` will be used, defaulting to `'PLAIN'`.
-*/
+ * Create a new scalar token with `value`
+ *
+ * Values that represent an actual string but may be parsed as a different type should use a `type` other than `'PLAIN'`,
+ * as this function does not support any schema operations and won't check for such conflicts.
+ *
+ * @param value The string representation of the value, which will have its content properly indented.
+ * @param context.end Comments and whitespace after the end of the value, or after the block scalar header. If undefined, a newline will be added.
+ * @param context.implicitKey Being within an implicit key may affect the resolved type of the token's value.
+ * @param context.indent The indent level of the token.
+ * @param context.inFlow Is this scalar within a flow collection? This may affect the resolved type of the token's value.
+ * @param context.offset The offset position of the token.
+ * @param context.type The preferred type of the scalar token. If undefined, the previous type of the `token` will be used, defaulting to `'PLAIN'`.
+ */
 declare function createScalarToken(value: string, context: {
   end?: SourceToken[];
   implicitKey?: boolean;
@@ -1032,21 +1009,21 @@ declare function createScalarToken(value: string, context: {
   type?: Scalar.Type;
 }): BlockScalar | FlowScalar;
 /**
-* Set the value of `token` to the given string `value`, overwriting any previous contents and type that it may have.
-*
-* Best efforts are made to retain any comments previously associated with the `token`,
-* though all contents within a collection's `items` will be overwritten.
-*
-* Values that represent an actual string but may be parsed as a different type should use a `type` other than `'PLAIN'`,
-* as this function does not support any schema operations and won't check for such conflicts.
-*
-* @param token Any token. If it does not include an `indent` value, the value will be stringified as if it were an implicit key.
-* @param value The string representation of the value, which will have its content properly indented.
-* @param context.afterKey In most cases, values after a key should have an additional level of indentation.
-* @param context.implicitKey Being within an implicit key may affect the resolved type of the token's value.
-* @param context.inFlow Being within a flow collection may affect the resolved type of the token's value.
-* @param context.type The preferred type of the scalar token. If undefined, the previous type of the `token` will be used, defaulting to `'PLAIN'`.
-*/
+ * Set the value of `token` to the given string `value`, overwriting any previous contents and type that it may have.
+ *
+ * Best efforts are made to retain any comments previously associated with the `token`,
+ * though all contents within a collection's `items` will be overwritten.
+ *
+ * Values that represent an actual string but may be parsed as a different type should use a `type` other than `'PLAIN'`,
+ * as this function does not support any schema operations and won't check for such conflicts.
+ *
+ * @param token Any token. If it does not include an `indent` value, the value will be stringified as if it were an implicit key.
+ * @param value The string representation of the value, which will have its content properly indented.
+ * @param context.afterKey In most cases, values after a key should have an additional level of indentation.
+ * @param context.implicitKey Being within an implicit key may affect the resolved type of the token's value.
+ * @param context.inFlow Being within a flow collection may affect the resolved type of the token's value.
+ * @param context.type The preferred type of the scalar token. If undefined, the previous type of the `token` will be used, defaulting to `'PLAIN'`.
+ */
 declare function setScalarValue(token: Token, value: string, context?: {
   afterKey?: boolean;
   implicitKey?: boolean;
@@ -1056,55 +1033,59 @@ declare function setScalarValue(token: Token, value: string, context?: {
 //#endregion
 //#region src/parse/cst-stringify.d.ts
 /**
-* Stringify a CST document, token, or collection item
-*
-* Fair warning: This applies no validation whatsoever, and
-* simply concatenates the sources in their logical order.
-*/
+ * Stringify a CST document, token, or collection item
+ *
+ * Fair warning: This applies no validation whatsoever, and
+ * simply concatenates the sources in their logical order.
+ */
 declare const stringify: (cst: Token | CollectionItem) => string;
 //#endregion
 //#region src/parse/cst-visit.d.ts
 type VisitPath = readonly ["key" | "value", number][];
 type Visitor = (item: CollectionItem, path: VisitPath) => number | symbol | Visitor | void;
 /**
-* Apply a visitor to a CST document or item.
-*
-* Walks through the tree (depth-first) starting from the root, calling a
-* `visitor` function with two arguments when entering each item:
-*   - `item`: The current item, which included the following members:
-*     - `start: SourceToken[]` – Source tokens before the key or value,
-*       possibly including its anchor or tag.
-*     - `key?: Token | null` – Set for pair values. May then be `null`, if
-*       the key before the `:` separator is empty.
-*     - `sep?: SourceToken[]` – Source tokens between the key and the value,
-*       which should include the `:` map value indicator if `value` is set.
-*     - `value?: Token` – The value of a sequence item, or of a map pair.
-*   - `path`: The steps from the root to the current node, as an array of
-*     `['key' | 'value', number]` tuples.
-*
-* The return value of the visitor may be used to control the traversal:
-*   - `undefined` (default): Do nothing and continue
-*   - `visit.SKIP`: Do not visit the children of this token, continue with
-*      next sibling
-*   - `visit.BREAK`: Terminate traversal completely
-*   - `visit.REMOVE`: Remove the current item, then continue with the next one
-*   - `number`: Set the index of the next step. This is useful especially if
-*     the index of the current token has changed.
-*   - `function`: Define the next visitor for this item. After the original
-*     visitor is called on item entry, next visitors are called after handling
-*     a non-empty `key` and when exiting the item.
-*/
+ * Apply a visitor to a CST document or item.
+ *
+ * Walks through the tree (depth-first) starting from the root, calling a
+ * `visitor` function with two arguments when entering each item:
+ *   - `item`: The current item, which included the following members:
+ *     - `start: SourceToken[]` – Source tokens before the key or value,
+ *       possibly including its anchor or tag.
+ *     - `key?: Token | null` – Set for pair values. May then be `null`, if
+ *       the key before the `:` separator is empty.
+ *     - `sep?: SourceToken[]` – Source tokens between the key and the value,
+ *       which should include the `:` map value indicator if `value` is set.
+ *     - `value?: Token` – The value of a sequence item, or of a map pair.
+ *   - `path`: The steps from the root to the current node, as an array of
+ *     `['key' | 'value', number]` tuples.
+ *
+ * The return value of the visitor may be used to control the traversal:
+ *   - `undefined` (default): Do nothing and continue
+ *   - `visit.SKIP`: Do not visit the children of this token, continue with
+ *      next sibling
+ *   - `visit.BREAK`: Terminate traversal completely
+ *   - `visit.REMOVE`: Remove the current item, then continue with the next one
+ *   - `number`: Set the index of the next step. This is useful especially if
+ *     the index of the current token has changed.
+ *   - `function`: Define the next visitor for this item. After the original
+ *     visitor is called on item entry, next visitors are called after handling
+ *     a non-empty `key` and when exiting the item.
+ */
 declare const visit: {
-  (cst: Document$1 | CollectionItem, visitor: Visitor): void; /** Terminate visit traversal completely */
-  BREAK: symbol; /** Do not visit the children of the current item */
-  SKIP: symbol; /** Remove the current item */
-  REMOVE: symbol; /** Find the item at `path` from `cst` as the root */
+  (cst: Document$1 | CollectionItem, visitor: Visitor): void;
+  /** Terminate visit traversal completely */
+  BREAK: symbol;
+  /** Do not visit the children of the current item */
+  SKIP: symbol;
+  /** Remove the current item */
+  REMOVE: symbol;
+  /** Find the item at `path` from `cst` as the root */
   itemAtPath(cst: Document$1 | CollectionItem, path: VisitPath): CollectionItem | undefined;
   /**
-  * Get the immediate parent collection of the item at `path` from `cst` as the root.
-  *
-  * Throws an error if the collection is not found, which should never happen if the item itself exists.
-  */
+   * Get the immediate parent collection of the item at `path` from `cst` as the root.
+   *
+   * Throws an error if the collection is not found, which should never happen if the item itself exists.
+   */
   parentCollection(cst: Document$1 | CollectionItem, path: VisitPath): BlockMap | BlockSequence | FlowCollection;
 };
 declare namespace cst_d_exports {
@@ -1225,10 +1206,10 @@ declare class Alias implements NodeBase {
   /** A comment before this node. */
   commentBefore?: string | null;
   /**
-  * The `[start, value-end, node-end]` character offsets for
-  * the part of the source parsed into this node (undefined if not parsed).
-  * The `value-end` and `node-end` positions are themselves not included in their respective ranges.
-  */
+   * The `[start, value-end, node-end]` character offsets for
+   * the part of the source parsed into this node (undefined if not parsed).
+   * The `value-end` and `node-end` positions are themselves not included in their respective ranges.
+   */
   range?: Range | null;
   /** A blank line before this node and its commentBefore */
   spaceBefore?: boolean;
@@ -1241,9 +1222,9 @@ declare class Alias implements NodeBase {
   /** Create a copy of this node.  */
   clone(): this;
   /**
-  * Resolve the value of this alias within `doc`, finding the last
-  * instance of the `source` anchor before this node.
-  */
+   * Resolve the value of this alias within `doc`, finding the last
+   * instance of the `source` anchor before this node.
+   */
   resolve(doc: Document, ctx?: ToJSContext): Scalar | YAMLMap | YAMLSeq | YAMLSet | undefined;
   /** A plain JavaScript representation of the resolved value of this alias. */
   toJS(doc: Document<DocValue, boolean>, ctx?: ToJSContext): any;
@@ -1272,68 +1253,68 @@ declare class Document<Value extends DocValue = DocValue, Strict extends boolean
   errors: YAMLError[];
   options: Required<Omit<ParseOptions & DocumentOptions, "_directives" | "lineCounter" | "version">>;
   /**
-  * The `[start, value-end, node-end]` character offsets for the part of the
-  * source parsed into this document (undefined if not parsed). The `value-end`
-  * and `node-end` positions are themselves not included in their respective
-  * ranges.
-  */
+   * The `[start, value-end, node-end]` character offsets for the part of the
+   * source parsed into this document (undefined if not parsed). The `value-end`
+   * and `node-end` positions are themselves not included in their respective
+   * ranges.
+   */
   range?: Range;
   /** The schema used with the document. Use `setSchema()` to change. */
   schema: Schema;
   /** Warnings encountered during parsing. */
   warnings: YAMLWarning[];
   /**
-  * @param value - The initial value for the document, which will be wrapped
-  *   in a Node container.
-  */
+   * @param value - The initial value for the document, which will be wrapped
+   *   in a Node container.
+   */
   constructor(value?: any, options?: DocumentOptions & SchemaOptions & ParseOptions & CreateNodeOptions);
   constructor(value: any, replacer: null | Replacer, options?: DocumentOptions & SchemaOptions & ParseOptions & CreateNodeOptions);
   /**
-  * Create a deep copy of this Document and its value.
-  *
-  * Custom Node values that inherit from `Object` still refer to their original instances.
-  */
+   * Create a deep copy of this Document and its value.
+   *
+   * Custom Node values that inherit from `Object` still refer to their original instances.
+   */
   clone(): Document<Value, Strict>;
   /**
-  * Create a new `Alias` node, ensuring that the target `node` has the required anchor.
-  *
-  * If `node` already has an anchor, `name` is ignored.
-  * Otherwise, the `node.anchor` value will be set to `name`,
-  * or if an anchor with that name is already present in the document,
-  * `name` will be used as a prefix for a new unique anchor.
-  * If `name` is undefined, the generated anchor will use 'a' as a prefix.
-  */
+   * Create a new `Alias` node, ensuring that the target `node` has the required anchor.
+   *
+   * If `node` already has an anchor, `name` is ignored.
+   * Otherwise, the `node.anchor` value will be set to `name`,
+   * or if an anchor with that name is already present in the document,
+   * `name` will be used as a prefix for a new unique anchor.
+   * If `name` is undefined, the generated anchor will use 'a' as a prefix.
+   */
   createAlias(node: Strict extends true ? DocValue : Node, name?: string): Alias;
   /**
-  * Convert any value into a `Node` using the current schema, recursively
-  * turning objects into collections.
-  */
+   * Convert any value into a `Node` using the current schema, recursively
+   * turning objects into collections.
+   */
   createNode<T = unknown>(value: T, options?: CreateNodeOptions): NodeType<T>;
   createNode<T = unknown>(value: T, replacer: Replacer | CreateNodeOptions | null, options?: CreateNodeOptions): NodeType<T>;
   /**
-  * Convert a key and a value into a `Pair` using the current schema,
-  * recursively wrapping all values as `Scalar` or `Collection` nodes.
-  */
+   * Convert a key and a value into a `Pair` using the current schema,
+   * recursively wrapping all values as `Scalar` or `Collection` nodes.
+   */
   createPair<K = unknown, V = unknown>(key: K, value: V, options?: CreateNodeOptions): Pair<K extends Primitive | Node ? K : Node, V extends Primitive | Node ? V : Node>;
   /**
-  * Returns item at `key`, or `undefined` if not found.
-  */
+   * Returns item at `key`, or `undefined` if not found.
+   */
   get(key: any): Strict extends true ? Node | Pair | null | undefined : any;
   /**
-  * Returns pair at `key`, or `undefined` if not found.
-  */
+   * Returns pair at `key`, or `undefined` if not found.
+   */
   getPair(key: any): Strict extends true ? Pair | undefined : any;
   /**
-  * Sets a value in this document's top-level collection. For `!!set`, `value` is ignored.
-  */
+   * Sets a value in this document's top-level collection. For `!!set`, `value` is ignored.
+   */
   set(key: any, value: any): void;
   /**
-  * Change the YAML version and schema used by the document.
-  * A `null` version disables support for directives, explicit tags, anchors, and aliases.
-  * It also requires the `schema` option to be given as a `Schema` instance value.
-  *
-  * Overrides all previously set schema options.
-  */
+   * Change the YAML version and schema used by the document.
+   * A `null` version disables support for directives, explicit tags, anchors, and aliases.
+   * It also requires the `schema` option to be given as a `Schema` instance value.
+   *
+   * Overrides all previously set schema options.
+   */
   setSchema(version: "1.1" | "1.2" | "next" | null, options?: SchemaOptions): void;
   /** A plain JavaScript representation of the document `value`. */
   toJS(opt?: ToJSOptions): any;
@@ -1353,42 +1334,42 @@ declare class Directives {
   };
   tags: Record<string, string>;
   /**
-  * The directives-end/doc-start marker `---`. If `null`, a marker may still be
-  * included in the document's stringified representation.
-  */
+   * The directives-end/doc-start marker `---`. If `null`, a marker may still be
+   * included in the document's stringified representation.
+   */
   docStart: true | null;
   /** The doc-end marker `...`.  */
   docEnd: boolean;
   /**
-  * Used when parsing YAML 1.1, where:
-  * > If the document specifies no directives, it is parsed using the same
-  * > settings as the previous document. If the document does specify any
-  * > directives, all directives of previous documents, if any, are ignored.
-  */
+   * Used when parsing YAML 1.1, where:
+   * > If the document specifies no directives, it is parsed using the same
+   * > settings as the previous document. If the document does specify any
+   * > directives, all directives of previous documents, if any, are ignored.
+   */
   private atNextDocument?;
   constructor(yaml?: Directives["yaml"], tags?: Directives["tags"]);
   clone(): Directives;
   /**
-  * During parsing, get a Directives instance for the current document and
-  * update the stream state according to the current version's spec.
-  */
+   * During parsing, get a Directives instance for the current document and
+   * update the stream state according to the current version's spec.
+   */
   atDocument(): Directives;
   /**
-  * @param onError - May be called even if the action was successful
-  * @returns `true` on success
-  */
+   * @param onError - May be called even if the action was successful
+   * @returns `true` on success
+   */
   add(line: string, onError: (offset: number, message: string, warning?: boolean) => void): boolean;
   /**
-  * Resolves a tag, matching handles to those defined in %TAG directives.
-  *
-  * @returns Resolved tag, which may also be the non-specific tag `'!'` or a
-  *   `'!local'` tag, or `null` if unresolvable.
-  */
+   * Resolves a tag, matching handles to those defined in %TAG directives.
+   *
+   * @returns Resolved tag, which may also be the non-specific tag `'!'` or a
+   *   `'!local'` tag, or `null` if unresolvable.
+   */
   tagName(source: string, onError: (message: string) => void): string | null;
   /**
-  * Given a fully resolved tag, returns its printable string form,
-  * taking into account current tag prefixes and defaults.
-  */
+   * Given a fully resolved tag, returns its printable string form,
+   * taking into account current tag prefixes and defaults.
+   */
   tagString(tag: string): string;
   toString(doc?: Document): string;
 }