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 repository appears largely quiet, with the most recent tagged change shown as updates in 2024-03 (v4.3.0) and the last upstream push on 2025-04-09, so it does not look actively maintained as of 2026-08-13.
  • Update cadence is irregular, with multi-year gaps between updates (for example, 2024-03, then 2022-04, then earlier 2021 and 2020 updates), and no recent follow-on updates after 2024-03.

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.