Back to Explore

stoplightio/yaml

GitHub
1 watchersOpen source

Last release:

@stoplight/yaml provides useful functions for working with YAML in modern browsers and Node.js. It includes utilities to parse YAML into a JSON object with diagnostics and AST line information, and to map between source positions and JSON paths.

Project status

  • The upstream repo stoplightio/yaml appears quiet and likely in maintenance mode, with the last observed upstream push on 2025-04-09 and the most recent tagged update in 2024-03-04.
  • Update cadence is low, about multi-year intervals between notable updates (example: v4.2.3 in 2022, v4.3.0 in 2024, then no newer updates surfaced by the provided list as of 2026-08-12).

AI summary generated

AI-generated from public sources. May be inaccurate. Report

Recent updates

  • v4.3.0

    v4.3.0 introduces comment parsing and the ability to stringify YAML along with comments (backed by new comment-aware parsing and output). The implementation adds an `attachComments` parsing option, threads comment data through the AST-to-JSON pointer walker, and updates snapshots/tests accordingly.

    Features

  • v4.2.3

    Release v4.2.3 performs a dependency upgrade of @stoplight/types and updates CI configuration. No new runtime features are described in the release notes.

    Breaking

  • v4.2.2

    v4.2.2 ships a bug fix focused on making parse diagnostics more readable when flow collections are left unclosed. The change centers on how `parseWithPointers` post-processes YAML parser errors into a smaller, more consistent diagnostics list.

  • v4.2.1

    Release v4.2.1 contains a single change: updating the @stoplight/types dependency version. The release notes describe it as a bug fix, but the actual code diff shows it is strictly a dependency bump in package.json and yarn.lock.

  • v4.2.0

    Release v4.2.0 updates the dependency @stoplight/types to a newer version. No application source code changes are present in the diff, so the impact is likely limited to indirect effects from the updated dependency.

  • v4.1.0

    v4.1.0 introduces configurable BigInt handling during YAML parsing with pointers. When the new option is enabled, parsed large integer scalars are returned as BigInt, otherwise they are coerced to JavaScript numbers.

    BreakingFeatures

  • v4.0.2

    Release v4.0.2 primarily updates the @stoplight/yaml-ast-parser dependency from 0.0.47 to 0.0.48. The repository also adds a new unit test covering safeStringify behavior with BigInt values.

  • v4.0.1

    v4.0.1 is a patch release with a dependency bump of @stoplight/yaml-ast-parser from 0.0.46 to 0.0.47. Release notes only mention the dependency update under bug fixes, but the code diff also adds a new test covering anchor escaping behavior in safeStringify.

  • v4.0.0

    v4.0.0 raises the minimum supported Node.js version and adds support for parsing large YAML integers as BigInt. It also updates several dependencies, including adding tslib, and bumps @stoplight/yaml-ast-parser and @stoplight/types.

    BreakingFeatures

  • v3.8.1

    Release v3.8.1 is a small patch release with no direct code changes shown beyond updating a dependency. The release notes only mention a bump of @stoplight/ordered-object-literal.