Back to Explore

syntax-tree/unist-util-position

GitHub
2 watchersOpen source

Last release:

unist-util-position is a utility for unifiedjs that helps access positional information on unist syntax tree nodes. It provides functions like position(node), pointStart(node), and pointEnd(node), useful when you need node locations (for example when building or validating plugins that may encounter dirty position data).

Project status

  • Maintenance status: The repo’s last upstream push was 2023-07-07, and the most recent published updates are from 2023-07-07, suggesting the project is no longer actively updated as of today (2026-06-09).
  • Update cadence: Updates appear sporadic (not regular), with multi-year gaps between versions (for example, notable releases in 2022, 2023, and earlier).

AI summary generated

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

Recent updates

  • 5.0.0

    unist-util-position v5.0.0 updates the package for Node.js 16+, switches to an exports map for module resolution, and changes how positional data is validated. The core utilities (pointStart, pointEnd, position) now return undefined when position data is invalid instead of returning empty objects with null fields.

    Breaking

  • 4.0.4

    Version 4.0.4 is primarily a maintenance release, with code reorganized and documentation updated. The runtime entry point (index.js) now re-exports the implementation from a new lib/index.js file, while build, test, and tooling configuration were also updated.

  • 4.0.3

    Release 4.0.3 is a small patch that updates the library metadata and adjusts the inline type documentation used for positional lookup. The code change is limited, and runtime logic appears unchanged.

  • 4.0.2

    Release 4.0.2 is a small patch release focused on TypeScript typing adjustments (notably to better handle literal nodes) and ensuring the required unist types dependency is present. The code diff is also accompanied by CI and packaging configuration tweaks and some tooling/dev dependency upgrades.

  • 4.0.1

    Release 4.0.1 makes a small change intended to fix TypeScript typing, by removing a `displayName` assignment from an internal helper. The release notes only mention this typing fix, but the diff also updates CI Node LTS and bumps a development dependency.

  • 4.0.0

    This release converts the package to ESM and adds JSDoc-based typing with generated TypeScript declaration output. The core exported API changed from CommonJS with attached properties to ESM named exports, and the build/test toolchain was modernized.

    BreakingFeatures

  • 3.1.0

    Release 3.1.0 adds the ability to get a whole positional object containing both `start` and `end` information. The release notes only mention this new capability, but the implementation also changes how the module is exported.

    Features

  • 3.0.4

    Release 3.0.4 is primarily a packaging change, adding a funding block to the published npm package metadata. The code diff also bumps several development tool dependencies and updates the package version and CI deploy credential.

    Features

  • 3.0.3

    Release 3.0.3 is primarily a documentation refresh (more badges, prose/links) with only superficial changes to the library source. However, the repository also updates CI and several development tool dependencies that are not mentioned in the release notes.

  • 3.0.2

    Release 3.0.2 makes small documentation and metadata adjustments. The notes indicate the LICENSE file was renamed to lowercase, and URLs were updated from HTTP to HTTPS.