yaml 1.9.2 → 1.10.0

package/pair.js

@@ -1,2 +1,2 @@
-module.exports = require('./dist/schema/Pair').Pair
-require('./dist/warnings').warnFileDeprecation(__filename)
+module.exports = require('./dist/types').Pair
+require('./dist/legacy-exports').warnFileDeprecation(__filename)

package/parse-cst.js

@@ -1 +1 @@
-module.exports = require('./dist/cst/parse').parse
+module.exports = require('./dist/parse-cst').parse

package/scalar.js

@@ -1,2 +1,2 @@
-module.exports = require('./dist/schema/Scalar').Scalar
-require('./dist/warnings').warnFileDeprecation(__filename)
+module.exports = require('./dist/types').Scalar
+require('./dist/legacy-exports').warnFileDeprecation(__filename)

package/schema.js

@@ -1,7 +1,9 @@
-module.exports = require('./dist/schema').Schema
-const opt = require('./dist/tags/options')
-module.exports.nullOptions = opt.nullOptions
-module.exports.strOptions = opt.strOptions
-module.exports.stringify = require('./dist/stringify').stringifyString
+const types = require('./dist/types')
+const util = require('./dist/util')
 
-require('./dist/warnings').warnFileDeprecation(__filename)
+module.exports = types.Schema
+module.exports.nullOptions = types.nullOptions
+module.exports.strOptions = types.strOptions
+module.exports.stringify = util.stringifyString
+
+require('./dist/legacy-exports').warnFileDeprecation(__filename)

package/seq.js

@@ -1,2 +1,2 @@
-module.exports = require('./dist/schema/Seq').YAMLSeq
-require('./dist/warnings').warnFileDeprecation(__filename)
+module.exports = require('./dist/types').YAMLSeq
+require('./dist/legacy-exports').warnFileDeprecation(__filename)

package/types/binary.js

@@ -1,7 +1,8 @@
 'use strict'
 Object.defineProperty(exports, '__esModule', { value: true })
 
-exports.binary = require('../dist/tags/yaml-1.1/binary').binary
+const legacy = require('../dist/legacy-exports')
+exports.binary = legacy.binary
 exports.default = [exports.binary]
 
-require('../dist/warnings').warnFileDeprecation(__filename)
+legacy.warnFileDeprecation(__filename)

package/types/omap.js

@@ -1,2 +1,3 @@
-module.exports = require('../dist/tags/yaml-1.1/omap').omap
-require('../dist/warnings').warnFileDeprecation(__filename)
+const legacy = require('../dist/legacy-exports')
+module.exports = legacy.omap
+legacy.warnFileDeprecation(__filename)

package/types/pairs.js

@@ -1,2 +1,3 @@
-module.exports = require('../dist/tags/yaml-1.1/pairs').pairs
-require('../dist/warnings').warnFileDeprecation(__filename)
+const legacy = require('../dist/legacy-exports')
+module.exports = legacy.pairs
+legacy.warnFileDeprecation(__filename)

package/types/set.js

@@ -1,2 +1,3 @@
-module.exports = require('../dist/tags/yaml-1.1/set').set
-require('../dist/warnings').warnFileDeprecation(__filename)
+const legacy = require('../dist/legacy-exports')
+module.exports = legacy.set
+legacy.warnFileDeprecation(__filename)

package/types/timestamp.js

@@ -1,10 +1,10 @@
 'use strict'
 Object.defineProperty(exports, '__esModule', { value: true })
 
-const ts = require('../dist/tags/yaml-1.1/timestamp')
-exports.default = [ts.intTime, ts.floatTime, ts.timestamp]
-exports.floatTime = ts.floatTime
-exports.intTime = ts.intTime
-exports.timestamp = ts.timestamp
+const legacy = require('../dist/legacy-exports')
+exports.default = [legacy.intTime, legacy.floatTime, legacy.timestamp]
+exports.floatTime = legacy.floatTime
+exports.intTime = legacy.intTime
+exports.timestamp = legacy.timestamp
 
-require('../dist/warnings').warnFileDeprecation(__filename)
+legacy.warnFileDeprecation(__filename)

package/types.d.ts

@@ -22,7 +22,7 @@ export class Schema {
   constructor(options: Schema.Options)
   /**
    * Convert any value into a `Node` using this schema, recursively turning
-   * objects into collectsions.
+   * objects into collections.
    *
    * @param wrapScalars If `true`, also wraps plain values in `Scalar` objects;
    *   if undefined or `false` and `value` is not an object, it will be returned
@@ -35,7 +35,14 @@ export class Schema {
     wrapScalars?: boolean,
     tag?: string,
     ctx?: Schema.CreateNodeContext
-  ): AST.Node
+  ): Node
+  /**
+   * Convert a key and a value into a `Pair` using this schema, recursively
+   * wrapping all values as `Scalar` or `Collection` nodes.
+   *
+   * @param ctx To not wrap scalars, use a context `{ wrapScalars: false }`
+   */
+  createPair(key: any, value: any, ctx?: Schema.CreateNodeContext): Pair
   merge: boolean
   name: Schema.Name
   sortMapEntries: ((a: Pair, b: Pair) => number) | null
@@ -147,7 +154,7 @@ export namespace Schema {
      *   type with the `+` chomping indicator.
      */
     stringify?: (
-      item: AST.Node,
+      item: Node,
       ctx: Schema.StringifyContext,
       onComment?: () => void,
       onChompKeep?: () => void
@@ -170,7 +177,7 @@ export namespace Schema {
      * Turns a CST node into an AST node. If returning a non-`Node` value, the
      * output will be wrapped as a `Scalar`.
      */
-    resolve(doc: Document, cstNode: CST.Node): AST.Node | any
+    resolve(doc: Document, cstNode: CST.Node): Node | any
   }
 
   interface DefaultTag extends BaseTag {
@@ -183,7 +190,7 @@ export namespace Schema {
     /**
      * Alternative form used by default tags; called with `test` match results.
      */
-    resolve(...match: string[]): AST.Node | any
+    resolve(...match: string[]): Node | any
     /**
      * Together with `default` allows for values to be stringified without an
      * explicit tag and detected using a regular expression. For most cases, it's
@@ -194,9 +201,30 @@ export namespace Schema {
   }
 }
 
-export class Scalar extends AST.Node {
+export class Node {
+  /** A comment on or immediately after this */
+  comment?: string | null
+  /** A comment before this */
+  commentBefore?: string | null
+  /** Only available when `keepCstNodes` is set to `true` */
+  cstNode?: CST.Node
+  /**
+   * The [start, end] range of characters of the source parsed
+   * into this node (undefined for pairs or if not parsed)
+   */
+  range?: [number, number] | null
+  /** A blank line before this node and its commentBefore */
+  spaceBefore?: boolean
+  /** A fully qualified tag, if required */
+  tag?: string
+  /** A plain JS representation of this node */
+  toJSON(arg?: any): any
+  /** The type of this node */
+  type?: Type | Pair.Type
+}
+
+export class Scalar extends Node {
   constructor(value: any)
-  toJSON(arg?: any, ctx?: AST.NodeToJsonContext): any
   type?: Scalar.Type
   /**
    * By default (undefined), numbers use decimal notation.
@@ -204,6 +232,8 @@ export class Scalar extends AST.Node {
    */
   format?: 'BIN' | 'HEX' | 'OCT' | 'TIME'
   value: any
+  toJSON(arg?: any, ctx?: AST.NodeToJsonContext): any
+  toString(): string
 }
 export namespace Scalar {
   type Type =
@@ -214,15 +244,27 @@ export namespace Scalar {
     | Type.QUOTE_SINGLE
 }
 
-export class Pair extends AST.Node {
+export class Alias extends Node {
+  type: Type.ALIAS
+  source: Node
+  cstNode?: CST.Alias
+  toString(ctx: Schema.StringifyContext): string
+}
+
+export class Pair extends Node {
   constructor(key: any, value?: any)
-  toJSON(arg?: any, ctx?: AST.NodeToJsonContext): object | Map<any, any>
   type: Pair.Type.PAIR | Pair.Type.MERGE_PAIR
   /** Always Node or null when parsed, but can be set to anything. */
   key: any
   /** Always Node or null when parsed, but can be set to anything. */
   value: any
   cstNode?: never // no corresponding cstNode
+  toJSON(arg?: any, ctx?: AST.NodeToJsonContext): object | Map<any, any>
+  toString(
+    ctx?: Schema.StringifyContext,
+    onComment?: () => void,
+    onChompKeep?: () => void
+  ): string
 }
 export namespace Pair {
   enum Type {
@@ -231,14 +273,66 @@ export namespace Pair {
   }
 }
 
-export class YAMLMap extends AST.Collection {
+export class Merge extends Pair {
+  type: Pair.Type.MERGE_PAIR
+  /** Always Scalar('<<'), defined by the type specification */
+  key: AST.PlainValue
+  /** Always YAMLSeq<Alias(Map)>, stringified as *A if length = 1 */
+  value: YAMLSeq
+  toString(ctx?: Schema.StringifyContext, onComment?: () => void): string
+}
+
+export class Collection extends Node {
+  type?: Type.MAP | Type.FLOW_MAP | Type.SEQ | Type.FLOW_SEQ | Type.DOCUMENT
+  items: any[]
+  schema?: Schema
+
+  /**
+   * Adds a value to the collection. For `!!map` and `!!omap` the value must
+   * be a Pair instance or a `{ key, value }` object, which may not have a key
+   * that already exists in the map.
+   */
+  add(value: any): void
+  addIn(path: Iterable<any>, value: any): void
+  /**
+   * Removes a value from the collection.
+   * @returns `true` if the item was found and removed.
+   */
+  delete(key: any): boolean
+  deleteIn(path: Iterable<any>): boolean
+  /**
+   * Returns item at `key`, or `undefined` if not found. By default unwraps
+   * scalar values from their surrounding node; to disable set `keepScalar` to
+   * `true` (collections are always returned intact).
+   */
+  get(key: any, keepScalar?: boolean): any
+  getIn(path: Iterable<any>, keepScalar?: boolean): any
+  /**
+   * Checks if the collection includes a value with the key `key`.
+   */
+  has(key: any): boolean
+  hasIn(path: Iterable<any>): boolean
+  /**
+   * Sets a value in this collection. For `!!set`, `value` needs to be a
+   * boolean to add/remove the item from the set.
+   */
+  set(key: any, value: any): void
+  setIn(path: Iterable<any>, value: any): void
+}
+
+export class YAMLMap extends Collection {
   type?: Type.FLOW_MAP | Type.MAP
-  items: Array<Pair | AST.Merge>
+  items: Array<Pair>
   hasAllNullValues(): boolean
   toJSON(arg?: any, ctx?: AST.NodeToJsonContext): object | Map<any, any>
+  toString(
+    ctx?: Schema.StringifyContext,
+    onComment?: () => void,
+    onChompKeep?: () => void
+  ): string
 }
 
-export class YAMLSeq extends AST.Collection {
+export class YAMLSeq extends Collection {
   type?: Type.FLOW_SEQ | Type.SEQ
   delete(key: number | string | Scalar): boolean
   get(key: number | string | Scalar, keepScalar?: boolean): any
@@ -246,80 +340,14 @@ export class YAMLSeq extends AST.Collection {
   set(key: number | string | Scalar, value: any): void
   hasAllNullValues(): boolean
   toJSON(arg?: any, ctx?: AST.NodeToJsonContext): any[]
+  toString(
+    ctx?: Schema.StringifyContext,
+    onComment?: () => void,
+    onChompKeep?: () => void
+  ): string
 }
 
 export namespace AST {
-  type AstNode = ScalarNode | CollectionNode | Alias
-
-  type ScalarNode =
-    | BlockFolded
-    | BlockLiteral
-    | PlainValue
-    | QuoteDouble
-    | QuoteSingle
-
-  type CollectionNode = FlowMap | BlockMap | FlowSeq | BlockSeq
-
-  class Node {
-    /** A comment on or immediately after this */
-    comment?: string | null
-    /** A comment before this */
-    commentBefore?: string | null
-    /** Only available when `keepCstNodes` is set to `true` */
-    cstNode?: CST.Node
-    /**
-     * The [start, end] range of characters of the source parsed
-     * into this node (undefined for pairs or if not parsed)
-     */
-    range?: [number, number] | null
-    /** A blank line before this node and its commentBefore */
-    spaceBefore?: boolean
-    /** A fully qualified tag, if required */
-    tag?: string
-    /** A plain JS representation of this node */
-    toJSON(arg?: any): any
-    /** The type of this node */
-    type?: Type | Pair.Type
-  }
-
-  class Collection extends Node {
-    type?: Type.MAP | Type.FLOW_MAP | Type.SEQ | Type.FLOW_SEQ | Type.DOCUMENT
-    items: any[]
-    schema?: Schema
-
-    /**
-     * Adds a value to the collection. For `!!map` and `!!omap` the value must
-     * be a Pair instance or a `{ key, value }` object, which may not have a key
-     * that already exists in the map.
-     */
-    add(value: any): void
-    addIn(path: Iterable<any>, value: any): void
-    /**
-     * Removes a value from the collection.
-     * @returns `true` if the item was found and removed.
-     */
-    delete(key: any): boolean
-    deleteIn(path: Iterable<any>): boolean
-    /**
-     * Returns item at `key`, or `undefined` if not found. By default unwraps
-     * scalar values from their surrounding node; to disable set `keepScalar` to
-     * `true` (collections are always returned intact).
-     */
-    get(key: any, keepScalar?: boolean): any
-    getIn(path: Iterable<any>, keepScalar?: boolean): any
-    /**
-     * Checks if the collection includes a value with the key `key`.
-     */
-    has(key: any): boolean
-    hasIn(path: Iterable<any>): boolean
-    /**
-     * Sets a value in this collection. For `!!set`, `value` needs to be a
-     * boolean to add/remove the item from the set.
-     */
-    set(key: any, value: any): void
-    setIn(path: Iterable<any>, value: any): void
-  }
-
   interface NodeToJsonContext {
     anchors?: any[]
     doc: Document
@@ -355,20 +383,6 @@ export namespace AST {
     cstNode?: CST.QuoteSingle
   }
 
-  interface Alias extends Node {
-    type: Type.ALIAS
-    source: AstNode
-    cstNode?: CST.Alias
-  }
-
-  interface Merge extends Pair {
-    type: Pair.Type.MERGE_PAIR
-    /** Always Scalar('<<'), defined by the type specification */
-    key: PlainValue
-    /** Always YAMLSeq<Alias(Map)>, stringified as *A if length = 1 */
-    value: YAMLSeq
-  }
-
   interface FlowMap extends YAMLMap {
     type: Type.FLOW_MAP
     cstNode?: CST.FlowMap
@@ -381,13 +395,13 @@ export namespace AST {
 
   interface FlowSeq extends YAMLSeq {
     type: Type.FLOW_SEQ
-    items: Array<AstNode | Pair>
+    items: Array<Node>
     cstNode?: CST.FlowSeq
   }
 
   interface BlockSeq extends YAMLSeq {
     type: Type.SEQ
-    items: Array<AstNode | null>
+    items: Array<Node | null>
     cstNode?: CST.Seq
   }
 }

package/types.js

@@ -1,12 +1,17 @@
-const opt = require('./dist/tags/options')
-exports.binaryOptions = opt.binaryOptions
-exports.boolOptions = opt.boolOptions
-exports.intOptions = opt.intOptions
-exports.nullOptions = opt.nullOptions
-exports.strOptions = opt.strOptions
+const types = require('./dist/types')
 
-exports.Schema = require('./dist/schema').Schema
-exports.YAMLMap = require('./dist/schema/Map').YAMLMap
-exports.YAMLSeq = require('./dist/schema/Seq').YAMLSeq
-exports.Pair = require('./dist/schema/Pair').Pair
-exports.Scalar = require('./dist/schema/Scalar').Scalar
+exports.binaryOptions = types.binaryOptions
+exports.boolOptions = types.boolOptions
+exports.intOptions = types.intOptions
+exports.nullOptions = types.nullOptions
+exports.strOptions = types.strOptions
+
+exports.Schema = types.Schema
+exports.Alias = types.Alias
+exports.Collection = types.Collection
+exports.Merge = types.Merge
+exports.Node = types.Node
+exports.Pair = types.Pair
+exports.Scalar = types.Scalar
+exports.YAMLMap = types.YAMLMap
+exports.YAMLSeq = types.YAMLSeq

package/types.mjs

@@ -1,21 +1,17 @@
-import opt from './dist/tags/options.js'
-export const binaryOptions = opt.binaryOptions
-export const boolOptions = opt.boolOptions
-export const intOptions = opt.intOptions
-export const nullOptions = opt.nullOptions
-export const strOptions = opt.strOptions
+import types from './dist/types.js'
 
-import schema from './dist/schema/index.js'
-export const Schema = schema.Schema
+export const binaryOptions = types.binaryOptions
+export const boolOptions = types.boolOptions
+export const intOptions = types.intOptions
+export const nullOptions = types.nullOptions
+export const strOptions = types.strOptions
 
-import map from './dist/schema/Map.js'
-export const YAMLMap = map.YAMLMap
-
-import seq from './dist/schema/Seq.js'
-export const YAMLSeq = seq.YAMLSeq
-
-import pair from './dist/schema/Pair.js'
-export const Pair = pair.Pair
-
-import scalar from './dist/schema/Scalar.js'
-export const Scalar = scalar.Scalar
+export const Schema = types.Schema
+export const Alias = types.Alias
+export const Collection = types.Collection
+export const Merge = types.Merge
+export const Node = types.Node
+export const Pair = types.Pair
+export const Scalar = types.Scalar
+export const YAMLMap = types.YAMLMap
+export const YAMLSeq = types.YAMLSeq

package/util.js

@@ -1,16 +1,16 @@
-exports.findPair = require('./dist/schema/Map').findPair
-exports.parseMap = require('./dist/schema/parseMap').parseMap
-exports.parseSeq = require('./dist/schema/parseSeq').parseSeq
+const util = require('./dist/util')
 
-const str = require('./dist/stringify')
-exports.stringifyNumber = str.stringifyNumber
-exports.stringifyString = str.stringifyString
-exports.toJSON = require('./dist/toJSON').toJSON
-exports.Type = require('./dist/constants').Type
+exports.findPair = util.findPair
+exports.toJSON = util.toJSON
+exports.parseMap = util.parseMap
+exports.parseSeq = util.parseSeq
 
-const err = require('./dist/errors')
-exports.YAMLError = err.YAMLError
-exports.YAMLReferenceError = err.YAMLReferenceError
-exports.YAMLSemanticError = err.YAMLSemanticError
-exports.YAMLSyntaxError = err.YAMLSyntaxError
-exports.YAMLWarning = err.YAMLWarning
+exports.stringifyNumber = util.stringifyNumber
+exports.stringifyString = util.stringifyString
+exports.Type = util.Type
+
+exports.YAMLError = util.YAMLError
+exports.YAMLReferenceError = util.YAMLReferenceError
+exports.YAMLSemanticError = util.YAMLSemanticError
+exports.YAMLSyntaxError = util.YAMLSyntaxError
+exports.YAMLWarning = util.YAMLWarning

package/util.mjs

@@ -1,25 +1,18 @@
-import map from './dist/schema/Map.js'
-export const findPair = map.findPair
+import util from './dist/util.js'
 
-import parseMapPkg from './dist/schema/parseMap.js'
-export const parseMap = parseMapPkg.parseMap
+export const findPair = util.findPair
+export const toJSON = util.toJSON
 
-import parseSeqPkg from './dist/schema/parseSeq.js'
-export const parseSeq = parseSeqPkg.parseSeq
+export const parseMap = util.parseMap
+export const parseSeq = util.parseSeq
 
-import str from './dist/stringify.js'
-export const stringifyNumber = str.stringifyNumber
-export const stringifyString = str.stringifyString
+export const stringifyNumber = util.stringifyNumber
+export const stringifyString = util.stringifyString
 
-import toJsonPkg from './dist/toJSON.js'
-export const toJSON = toJsonPkg.toJSON
+export const Type = util.Type
 
-import constants from './dist/constants.js'
-export const Type = constants.Type
-
-import err from './dist/errors.js'
-export const YAMLError = err.YAMLError
-export const YAMLReferenceError = err.YAMLReferenceError
-export const YAMLSemanticError = err.YAMLSemanticError
-export const YAMLSyntaxError = err.YAMLSyntaxError
-export const YAMLWarning = err.YAMLWarning
+export const YAMLError = util.YAMLError
+export const YAMLReferenceError = util.YAMLReferenceError
+export const YAMLSemanticError = util.YAMLSemanticError
+export const YAMLSyntaxError = util.YAMLSyntaxError
+export const YAMLWarning = util.YAMLWarning

package/browser/dist/Anchors.js

@@ -1,130 +0,0 @@
-import _classCallCheck from "@babel/runtime/helpers/classCallCheck";
-import _createClass from "@babel/runtime/helpers/createClass";
-import _defineProperty from "@babel/runtime/helpers/defineProperty";
-import { Alias } from './schema/Alias';
-import { YAMLMap } from './schema/Map';
-import { Merge } from './schema/Merge';
-import { Scalar } from './schema/Scalar';
-import { YAMLSeq } from './schema/Seq';
-export var Anchors = /*#__PURE__*/function () {
-  _createClass(Anchors, null, [{
-    key: "validAnchorNode",
-    value: function validAnchorNode(node) {
-      return node instanceof Scalar || node instanceof YAMLSeq || node instanceof YAMLMap;
-    }
-  }]);
-
-  function Anchors(prefix) {
-    _classCallCheck(this, Anchors);
-
-    _defineProperty(this, "map", {});
-
-    this.prefix = prefix;
-  }
-
-  _createClass(Anchors, [{
-    key: "createAlias",
-    value: function createAlias(node, name) {
-      this.setAnchor(node, name);
-      return new Alias(node);
-    }
-  }, {
-    key: "createMergePair",
-    value: function createMergePair() {
-      var _this = this;
-
-      var merge = new Merge();
-
-      for (var _len = arguments.length, sources = new Array(_len), _key = 0; _key < _len; _key++) {
-        sources[_key] = arguments[_key];
-      }
-
-      merge.value.items = sources.map(function (s) {
-        if (s instanceof Alias) {
-          if (s.source instanceof YAMLMap) return s;
-        } else if (s instanceof YAMLMap) {
-          return _this.createAlias(s);
-        }
-
-        throw new Error('Merge sources must be Map nodes or their Aliases');
-      });
-      return merge;
-    }
-  }, {
-    key: "getName",
-    value: function getName(node) {
-      var map = this.map;
-      return Object.keys(map).find(function (a) {
-        return map[a] === node;
-      });
-    }
-  }, {
-    key: "getNode",
-    value: function getNode(name) {
-      return this.map[name];
-    }
-  }, {
-    key: "newName",
-    value: function newName(prefix) {
-      if (!prefix) prefix = this.prefix;
-      var names = Object.keys(this.map);
-
-      for (var i = 1; true; ++i) {
-        var name = "".concat(prefix).concat(i);
-        if (!names.includes(name)) return name;
-      }
-    } // During parsing, map & aliases contain CST nodes
-
-  }, {
-    key: "resolveNodes",
-    value: function resolveNodes() {
-      var map = this.map,
-          _cstAliases = this._cstAliases;
-      Object.keys(map).forEach(function (a) {
-        map[a] = map[a].resolved;
-      });
-
-      _cstAliases.forEach(function (a) {
-        a.source = a.source.resolved;
-      });
-
-      delete this._cstAliases;
-    }
-  }, {
-    key: "setAnchor",
-    value: function setAnchor(node, name) {
-      if (node != null && !Anchors.validAnchorNode(node)) {
-        throw new Error('Anchors may only be set for Scalar, Seq and Map nodes');
-      }
-
-      if (name && /[\x00-\x19\s,[\]{}]/.test(name)) {
-        throw new Error('Anchor names must not contain whitespace or control characters');
-      }
-
-      var map = this.map;
-      var prev = node && Object.keys(map).find(function (a) {
-        return map[a] === node;
-      });
-
-      if (prev) {
-        if (!name) {
-          return prev;
-        } else if (prev !== name) {
-          delete map[prev];
-          map[name] = node;
-        }
-      } else {
-        if (!name) {
-          if (!node) return null;
-          name = this.newName();
-        }
-
-        map[name] = node;
-      }
-
-      return name;
-    }
-  }]);
-
-  return Anchors;
-}();