tree-sitter / tree-sitter/tree-sitter-php

Request: tree-sitter 0.25.x peer compatibility

Open Beginner friendly
#301 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
JavaScript
Stars
235
Forks
74
PR merge metrics
No merged PRs in 30d

Description

Summary

tree-sitter-php's latest release (0.24.2) declares a peer dependency on
tree-sitter@^0.22.4, which blocks it from being installed alongside
tree-sitter@0.25.x. Could a release that supports tree-sitter@^0.25.0 be
published?

Background

  • tree-sitter@0.25.0 was published 2025-06-02; 0.25.1 on 2026-07-28.

  • tree-sitter-php@0.24.2 (latest, published 2025-08-18) declares:

    "peerDependencies": {
      "tree-sitter": "^0.22.4"
    }
    

    ^0.22.4 does not satisfy 0.25.x, so any project that bumps tree-sitter
    to 0.25.x can no longer resolve tree-sitter-php.

Problem

npm install fails with ERESOLVE when tree-sitter is on 0.25.x and
tree-sitter-php is present:

npm error code ERESOLVE
npm error ERESOLVE could not resolve
npm error
npm error While resolving: tree-sitter-php@0.24.2
npm error Found: tree-sitter@0.25.1
npm error node_modules/tree-sitter
npm error   tree-sitter@"^0.25.0" from the root project
npm error
npm error Could not resolve dependency:
npm error peer tree-sitter@"^0.22.4" from tree-sitter-php@0.24.2
npm error node_modules/tree-sitter-php
npm error   tree-sitter-php@"^0.24.0" from the root project
npm error
npm error Conflicting peer dependency: tree-sitter@0.22.4
npm error
npm error Fix the upstream dependency conflict, or retry this command with
npm error --force or --legacy-peer-deps to accept an incorrect (and potentially
npm error broken) dependency resolution.

Reproduction

{
  "name": "repro",
  "dependencies": {
    "tree-sitter": "^0.25.0",
    "tree-sitter-php": "^0.24.0"
  }
}
npm install
# npm error ERESOLVE could not resolve
# (peer tree-sitter@"^0.22.4" from tree-sitter-php@0.24.2)

Ask

Please widen the tree-sitter peer range to include ^0.25.0 and publish a
compatible release. If 0.25.x introduced ABI/API changes that require binding
updates, a 0.25-compatible release of tree-sitter-php would unblock
downstream projects that have already moved to tree-sitter@0.25.x.

Environment

  • npm (latest)
  • tree-sitter@0.25.1
  • tree-sitter-php@0.24.2 (latest)

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by reproducing the reported npm install conflict with tree-sitter@0.25.x and tree-sitter-php@0.24.2, then inspect the package metadata and binding compatibility. Done means a published release accepts tree-sitter@^0.25.0 without the reported ERESOLVE failure; if API or ABI changes require updates, those must be addressed first.

Written by the indexing model from the issue text.

Assessment

Tech stack
javascript, php
Domain
tooling
Issue type
Feature
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
65/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.