rust-merge 7.0.0 → 7.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c38459e1d39971cade4fe28316b85c476ccdd6ef327ce876f9df133c48155a00
-  data.tar.gz: 44034fa2d21db2abc0fe6189e29123d44ccdea2ba36f9b9840c0e6dacd31130d
+  metadata.gz: aef016d95324b777f2300aa31db682b1cb717ea3ade223d5f44058e0f8c42428
+  data.tar.gz: 2a97cb609a0a13efa790fec5a8a7bd76feff180babd2932c7751ed0d0bed3209
 SHA512:
-  metadata.gz: 56383574edb836f7149e9b24f4c09d084c477b6cb1e8c42e1e6873dd0369fde3201ea4dddb7c8834101564f4a7bdb433e1fa8c34be74554b758c5e4f03e34cac
-  data.tar.gz: 75b5778bc46334c29f63cecc88b735a9e436f2678cf7a2f0ce086cab01f7a0ee15258596eaff701c36f686f8dc2bdea5b2ff79303db0278a68730487e5894b12
+  metadata.gz: 2fc3aa2c3a852d2bd196b2a963fda2b3f3a890e4cf6a27270b4311ab0bb70c7ff7d6357cd9ba8ed6b7859bd9b290d35bc0bfd2c2b43471955b602127b5bd74fe
+  data.tar.gz: 7ee67c2c39b1fad125389987ab0341de1f0fdf0e95d9cf3e4ed9627cc84c9f7d37ddbd15ad6b116569f951b1b0c0b1669612c5fe513cfc2da76b3905d2827cd2

data/LICENSE.md

@@ -0,0 +1,13 @@
+# License
+
+This project is made available under the following licenses.
+Choose the option that best fits your use case:
+
+- [AGPL-3.0-only](https://github.com/structuredmerge/structuredmerge-ruby/blob/main/AGPL-3.0-only.md)
+- [PolyForm-Small-Business-1.0.0](https://github.com/structuredmerge/structuredmerge-ruby/blob/main/PolyForm-Small-Business-1.0.0.md)
+
+If none of the above licenses fit your use case, please [contact us](mailto:floss@galtzo.com) to discuss a custom commercial license.
+
+## Copyright Notice
+
+- Required Notice: Copyright (c) 2026 Peter H. Boling

data/README.md

@@ -0,0 +1,286 @@
+<a href="https://github.com/structuredmerge"><img alt="structuredmerge Logo by GitHub" src="https://github.com/structuredmerge.png?size=192" width="14%" align="right"/></a>
+
+# ☯️ Rust::Merge
+
+[![Version][👽versioni]][👽version] [![Ruby Users Forum][✉️ruby-forum-top-img]][✉️ruby-forum] [![GitHub tag (latest SemVer)][⛳️tag-img]][⛳️tag] [![License: AGPL-3.0-only OR PolyForm-Small-Business-1.0.0][📄license-img]][📄license] [![Total downloads][👽dl-ranki]][👽dl-rank] [![CI Current][🚎11-c-wfi]][🚎11-c-wf]
+
+`if ci_badges.map(&:color).detect { it != "green"}` ☝️ [let me know on Discord][✉️discord-invite] or [RubyForum][✉️ruby-forum], as I may have missed the notification.
+
+---
+
+`if ci_badges.map(&:color).all? { it == "green"}` 👇️ send money so I can do more of this. FLOSS maintenance is now my full-time job.
+
+[![Sponsor Me on Github][🖇sponsor-img]][🖇sponsor] [![Liberapay Goal Progress][⛳liberapay-img]][⛳liberapay] [![Donate on PayPal][🖇paypal-img]][🖇paypal] [![Buy me a coffee][🖇buyme-small-img]][🖇buyme] [![Donate at ko-fi.com][🖇kofi-img]][🖇kofi]
+
+<details markdown="1">
+ <summary>👣 How will this project approach the September 2025 hostile takeover of RubyGems? 🚑️</summary>
+
+I've summarized my thoughts in [this blog post](https://dev.to/galtzo/hostile-takeover-of-rubygems-my-thoughts-5hlo).
+
+</details>
+
+## 🌻 Synopsis <a href="https://discord.gg/3qme4XHNKN"><img alt="Galtzo FLOSS Logo by Aboling0, CC BY-SA 4.0" src="https://logos.galtzo.com/assets/images/galtzo-floss/avatar-128px.svg" width="8%" align="right"/></a> <a href="https://ruby-toolbox.com"><img alt="ruby-lang Logo, Yukihiro Matsumoto, Ruby Visual Identity Team, CC BY-SA 2.5" src="https://logos.galtzo.com/assets/images/ruby-lang/avatar-128px.svg" width="8%" align="right"/></a>
+
+`Rust::Merge` merges Rust source files by top-level items through the shared tree-sitter language-pack backend. It preserves destination items and appends template-only items when they do not already exist by structural path.
+
+### Key Features
+
+- Rust dialect feature profile and backend capability reporting.
+- Item ownership for functions, modules, structs, enums, impl blocks, traits, and use items as exposed by the language pack.
+- Destination parse diagnostics with the common result shape.
+- Module-level APIs for fixture runners and Git integrations.
+
+## 💡 Info you can shake a stick at
+
+| Tokens to Remember | [![Gem name][⛳️name-img]][⛳️gem-name] [![Gem namespace][⛳️namespace-img]][⛳️gem-namespace] |
+|-------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| Works with MRI Ruby 4 | [![Ruby current Compat][💎ruby-c-i]][🚎11-c-wf]|
+| Support & Community | [![Join Me on Daily.dev's RubyFriends][✉️ruby-friends-img]][✉️ruby-friends] [![Get help from RubyForum][✉️ruby-forum-img]][✉️ruby-forum] [![Live Chat on Discord][✉️discord-invite-img-ftb]][✉️discord-invite] [![Get help from me on Upwork][👨🏼‍🏫expsup-upwork-img]][👨🏼‍🏫expsup-upwork] [![Get help from me on Codementor][👨🏼‍🏫expsup-codementor-img]][👨🏼‍🏫expsup-codementor] |
+| Source | [![Source on GitLab.com][📜src-gl-img]][📜src-gl] [![Source on CodeBerg.org][📜src-cb-img]][📜src-cb] [![Source on GitHub.com][📜src-gh-img]][📜src-gh] [![The best SHA: dQw4w9WgXcQ!][🧮kloc-img]][🧮kloc] |
+| Documentation | [![Current release on RubyDoc.info][📜docs-cr-rd-img]][🚎yard-current] [![YARD on Galtzo.com][📜docs-head-rd-img]][🚎yard-head] [![Maintainer Blog][🚂maint-blog-img]][🚂maint-blog] [![GitLab Wiki][📜gl-wiki-img]][📜gl-wiki] [![GitHub Wiki][📜gh-wiki-img]][📜gh-wiki] |
+| Compliance | [![License: AGPL-3.0-only OR PolyForm-Small-Business-1.0.0][📄license-img]][📄license] [![Apache license compatibility: Category X][📄license-compat-img]][📄license-compat] [![📄ilo-declaration-img]][📄ilo-declaration] [![Security Policy][🔐security-img]][🔐security] [![Contributor Covenant 2.1][🪇conduct-img]][🪇conduct] [![SemVer 2.0.0][📌semver-img]][📌semver] |
+| Style | [![Enforced Code Style Linter][💎rlts-img]][💎rlts] [![Keep-A-Changelog 1.0.0][📗keep-changelog-img]][📗keep-changelog] [![Gitmoji Commits][📌gitmoji-img]][📌gitmoji] [![Compatibility appraised by: appraisal2][💎appraisal2-img]][💎appraisal2] |
+| Maintainer 🎖️ | [![Follow Me on LinkedIn][💖🖇linkedin-img]][💖🖇linkedin] [![Follow Me on Ruby.Social][💖🐘ruby-mast-img]][💖🐘ruby-mast] [![Follow Me on Bluesky][💖🦋bluesky-img]][💖🦋bluesky] [![Contact Maintainer][🚂maint-contact-img]][🚂maint-contact] [![My technical writing][💖💁🏼‍♂️devto-img]][💖💁🏼‍♂️devto] |
+| `...` 💖 | [![Find Me on WellFound:][💖✌️wellfound-img]][💖✌️wellfound] [![Find Me on CrunchBase][💖💲crunchbase-img]][💖💲crunchbase] [![My LinkTree][💖🌳linktree-img]][💖🌳linktree] [![More About Me][💖💁🏼‍♂️aboutme-img]][💖💁🏼‍♂️aboutme] [🧊][💖🧊berg] [🐙][💖🐙hub] [🛖][💖🛖hut] [🧪][💖🧪lab] |
+
+### Compatibility
+
+Compatible with MRI Ruby 4.0.0+, JRuby, and TruffleRuby.
+CI workflows and Appraisals are generated for MRI Ruby 4.0.0+.
+This test floor is configured by `ruby.test_minimum` in `.kettle-jem.yml` and
+may be higher than the gem's runtime compatibility floor when legacy Rubies are
+not practical for the current toolchain.
+
+<a href="https://github.com/kettle-dev"><img alt="kettle-dev Logo by Aboling0, CC BY-SA 4.0" src="https://logos.galtzo.com/assets/images/kettle-dev/avatar-128px.svg" width="14%" align="right"/></a>
+
+The _amazing_ test matrix is powered by the kettle-dev stack.
+
+<details markdown="1">
+<summary>How kettle-dev manages complexity in tests</summary>
+
+| Gem | Source | Role | Total downloads |
+|-----|--------|------|---------------------|
+| [appraisal2](https://clickgems.clickhouse.com/dashboard/appraisal2) | [GitHub](https://github.com/appraisal-rb/appraisal2) | multi-dependency Appraisal matrix generation | [![Total downloads for appraisal2](https://img.shields.io/gem/dt/appraisal2.svg?style=flat-square)](https://clickgems.clickhouse.com/dashboard/appraisal2) |
+| [appraisal2-rubocop](https://clickgems.clickhouse.com/dashboard/appraisal2-rubocop) | [GitHub](https://github.com/appraisal-rb/appraisal2-rubocop) | RuboCop Appraisal generator integration | [![Total downloads for appraisal2-rubocop](https://img.shields.io/gem/dt/appraisal2-rubocop.svg?style=flat-square)](https://clickgems.clickhouse.com/dashboard/appraisal2-rubocop) |
+| [kettle-dev](https://clickgems.clickhouse.com/dashboard/kettle-dev) | [GitHub](https://github.com/kettle-dev/kettle-dev) | development, release, and CI workflow tooling | [![Total downloads for kettle-dev](https://img.shields.io/gem/dt/kettle-dev.svg?style=flat-square)](https://clickgems.clickhouse.com/dashboard/kettle-dev) |
+| [kettle-jem](https://clickgems.clickhouse.com/dashboard/kettle-jem) | [GitHub](https://github.com/kettle-dev/kettle-jem) | Appraisals & CI workflow templates | [![Total downloads for kettle-jem](https://img.shields.io/gem/dt/kettle-jem.svg?style=flat-square)](https://clickgems.clickhouse.com/dashboard/kettle-jem) |
+| [kettle-soup-cover](https://clickgems.clickhouse.com/dashboard/kettle-soup-cover) | [GitHub](https://github.com/kettle-dev/kettle-soup-cover) | SimpleCov coverage policy and reporting | [![Total downloads for kettle-soup-cover](https://img.shields.io/gem/dt/kettle-soup-cover.svg?style=flat-square)](https://clickgems.clickhouse.com/dashboard/kettle-soup-cover) |
+| [kettle-test](https://clickgems.clickhouse.com/dashboard/kettle-test) | [GitHub](https://github.com/kettle-dev/kettle-test) | standard test runner and coverage harness | [![Total downloads for kettle-test](https://img.shields.io/gem/dt/kettle-test.svg?style=flat-square)](https://clickgems.clickhouse.com/dashboard/kettle-test) |
+| [rubocop-lts](https://clickgems.clickhouse.com/dashboard/rubocop-lts) | [GitHub](https://github.com/rubocop-lts/rubocop-lts) | Ruby-version-aware linting | [![Total downloads for rubocop-lts](https://img.shields.io/gem/dt/rubocop-lts.svg?style=flat-square)](https://clickgems.clickhouse.com/dashboard/rubocop-lts) |
+| [turbo_tests2](https://clickgems.clickhouse.com/dashboard/turbo_tests2) | [GitHub](https://github.com/galtzo-floss/turbo_tests2) | parallel test execution | [![Total downloads for turbo_tests2](https://img.shields.io/gem/dt/turbo_tests2.svg?style=flat-square)](https://clickgems.clickhouse.com/dashboard/turbo_tests2) |
+
+</details>
+
+## ✨ Installation
+
+Install the gem and add to the application's Gemfile by executing:
+
+```console
+bundle add rust-merge
+```
+
+If bundler is not being used to manage dependencies, install the gem by executing:
+
+```console
+gem install rust-merge
+```
+
+## ⚙️ Configuration
+
+```ruby
+profile = Rust::Merge.rust_backend_feature_profile
+context = Rust::Merge.rust_plan_context
+backends = Rust::Merge.available_rust_backends
+```
+
+The Ruby implementation uses the shared language-pack backend and returns diagnostics for unsupported dialects or unavailable parsers.
+
+## 🔧 Basic Usage
+
+```ruby
+require "rust/merge"
+
+result = Rust::Merge.merge_rust(
+  File.read("template.rs"),
+  File.read("lib.rs"),
+  "rust",
+)
+
+abort result.fetch(:diagnostics).inspect unless result.fetch(:ok)
+File.write("lib.rs", result.fetch(:output))
+```
+
+Most module-level merge methods return a Hash with `:ok`, `:diagnostics`, `:output`, and `:policies`. Check `:ok` before writing the result; diagnostics are structured for CI output and fixture conformance reports.
+
+## 🔐 Security
+
+See [SECURITY.md][🔐security].
+
+## 🤝 Contributing
+
+If you need some ideas of where to help, you could work on adding more code coverage,
+check [issues][🤝gh-issues] or [PRs][🤝gh-pulls], or use the gem and think about how it could be better.
+
+We [![Keep A Changelog][📗keep-changelog-img]][📗keep-changelog] so if you make changes, remember to update it.
+
+See [CONTRIBUTING.md][🤝contributing] for more detailed instructions.
+
+## 📌 Versioning
+
+This library follows [![Semantic Versioning 2.0.0][📌semver-img]][📌semver] for its public API where practical.
+For most applications, prefer the [Pessimistic Version Constraint][📌pvc] with two digits of precision.
+
+For example:
+
+```ruby
+spec.add_dependency("rust-merge", "~> 7.0")
+```
+
+<details markdown="1">
+<summary>📌 Is "Platform Support" part of the public API? More details inside.</summary>
+
+Dropping support for a platform can be a breaking change for affected users.
+If a release changes supported platforms, it should be called out clearly in the changelog and versioned with that impact in mind.
+
+To get a better understanding of how SemVer is intended to work over a project's lifetime,
+read this article from the creator of SemVer:
+
+- ["Major Version Numbers are Not Sacred"][📌major-versions-not-sacred]
+
+</details>
+
+See [CHANGELOG.md][📌changelog] for a list of releases.
+
+## 📄 License
+
+The gem is available under the following licenses: [AGPL-3.0-only](https://github.com/structuredmerge/structuredmerge-ruby/blob/main/AGPL-3.0-only.md), [PolyForm-Small-Business-1.0.0](https://github.com/structuredmerge/structuredmerge-ruby/blob/main/PolyForm-Small-Business-1.0.0.md).
+See [LICENSE.md][📄license] for details.
+
+If none of the available licenses suit your use case, please [contact us](mailto:floss@galtzo.com) to discuss a custom commercial license.
+
+[⛳liberapay-img]: https://img.shields.io/liberapay/goal/pboling.svg?logo=liberapay&color=a51611&style=flat
+[⛳liberapay-bottom-img]: https://img.shields.io/liberapay/goal/pboling.svg?style=for-the-badge&logo=liberapay&color=a51611
+[⛳liberapay]: https://liberapay.com/pboling/donate
+[🖇sponsor-img]: https://img.shields.io/badge/Sponsor_Me!-pboling.svg?style=social&logo=github
+[🖇sponsor-bottom-img]: https://img.shields.io/badge/Sponsor_Me!-pboling-blue?style=for-the-badge&logo=github
+[🖇sponsor]: https://github.com/sponsors/pboling
+[🖇kofi-img]: https://img.shields.io/badge/ko--fi-%E2%9C%93-a51611.svg?style=flat
+[🖇kofi]: https://ko-fi.com/pboling
+[🖇buyme-small-img]: https://img.shields.io/badge/buy_me_a_coffee-%E2%9C%93-a51611.svg?style=flat
+[🖇buyme-img]: https://img.buymeacoffee.com/button-api/?text=Buy%20me%20a%20latte&emoji=&slug=pboling&button_colour=FFDD00&font_colour=000000&font_family=Cookie&outline_colour=000000&coffee_colour=ffffff
+[🖇buyme]: https://www.buymeacoffee.com/pboling
+[🖇paypal-img]: https://img.shields.io/badge/donate-paypal-a51611.svg?style=flat&logo=paypal
+[🖇paypal-bottom-img]: https://img.shields.io/badge/donate-paypal-a51611.svg?style=for-the-badge&logo=paypal&color=0A0A0A
+[🖇paypal]: https://www.paypal.com/paypalme/peterboling
+[🖇floss-funding.dev]: https://floss-funding.dev
+[🖇floss-funding-gem]: https://github.com/galtzo-floss/floss_funding
+[✉️discord-invite]: https://discord.gg/3qme4XHNKN
+[✉️discord-invite-img-ftb]: https://img.shields.io/discord/1373797679469170758?style=for-the-badge&logo=discord
+[✉️ruby-friends-img]: https://img.shields.io/badge/daily.dev-%F0%9F%92%8E_Ruby_Friends-0A0A0A?style=for-the-badge&logo=dailydotdev&logoColor=white
+[✉️ruby-friends]: https://app.daily.dev/squads/rubyfriends
+[✉️ruby-forum-top-img]: https://img.shields.io/discourse/topics?server=https%3A%2F%2Fwww.rubyforum.org&style=flat&logo=discourse&label=Ruby%20Users%20Forum
+[✉️ruby-forum-img]: https://img.shields.io/discourse/topics?server=https%3A%2F%2Fwww.rubyforum.org&style=for-the-badge&logo=discourse&label=Ruby%20Users%20Forum
+[✉️ruby-forum]: https://www.rubyforum.org/tag/structuredmerge
+[✇bundle-group-pattern]: https://gist.github.com/pboling/4564780
+[⛳️gem-namespace]: https://github.com/structuredmerge/structuredmerge-ruby/tree/main/gems/rust-merge
+[⛳️namespace-img]: https://img.shields.io/badge/namespace-Rust::Merge-3C2D2D.svg?style=square&logo=ruby&logoColor=white
+[⛳️gem-name]: https://clickgems.clickhouse.com/dashboard/rust-merge
+[⛳️name-img]: https://img.shields.io/badge/name-rust--merge-3C2D2D.svg?style=square&logo=rubygems&logoColor=red
+[⛳️tag-img]: https://img.shields.io/github/tag/structuredmerge/structuredmerge-ruby.svg
+[⛳️tag]: https://github.com/structuredmerge/structuredmerge-ruby/releases
+[🚂maint-blog]: http://www.railsbling.com/tags/rust-merge
+[🚂maint-blog-img]: https://img.shields.io/badge/blog-railsbling-0093D0.svg?style=for-the-badge&logo=rubyonrails&logoColor=orange
+[🚂maint-contact]: http://www.railsbling.com/contact
+[🚂maint-contact-img]: https://img.shields.io/badge/Contact-Maintainer-0093D0.svg?style=flat&logo=rubyonrails&logoColor=red
+[💖🖇linkedin]: http://www.linkedin.com/in/peterboling
+[💖🖇linkedin-img]: https://img.shields.io/badge/LinkedIn-Profile-0B66C2?style=flat&logo=newjapanprowrestling
+[💖✌️wellfound]: https://wellfound.com/u/peter-boling
+[💖✌️wellfound-img]: https://img.shields.io/badge/peter--boling-orange?style=flat&logo=wellfound
+[💖💲crunchbase]: https://www.crunchbase.com/person/peter-boling
+[💖💲crunchbase-img]: https://img.shields.io/badge/peter--boling-purple?style=flat&logo=crunchbase
+[💖🐘ruby-mast]: https://ruby.social/@galtzo
+[💖🐘ruby-mast-img]: https://img.shields.io/mastodon/follow/109447111526622197?domain=https://ruby.social&style=flat&logo=mastodon&label=Ruby%20@galtzo
+[💖🦋bluesky]: https://bsky.app/profile/galtzo.com
+[💖🦋bluesky-img]: https://img.shields.io/badge/@galtzo.com-0285FF?style=flat&logo=bluesky&logoColor=white
+[💖🌳linktree]: https://linktr.ee/galtzo
+[💖🌳linktree-img]: https://img.shields.io/badge/galtzo-purple?style=flat&logo=linktree
+[💖💁🏼‍♂️devto]: https://dev.to/galtzo
+[💖💁🏼‍♂️devto-img]: https://img.shields.io/badge/dev.to-0A0A0A?style=flat&logo=devdotto&logoColor=white
+[💖💁🏼‍♂️aboutme]: https://about.me/peter.boling
+[💖💁🏼‍♂️aboutme-img]: https://img.shields.io/badge/about.me-0A0A0A?style=flat&logo=aboutme&logoColor=white
+[💖🧊berg]: https://codeberg.org/pboling
+[💖🐙hub]: https://github.org/pboling
+[💖🛖hut]: https://sr.ht/~galtzo/
+[💖🧪lab]: https://gitlab.com/pboling
+[👨🏼‍🏫expsup-upwork]: https://www.upwork.com/freelancers/~014942e9b056abdf86?mp_source=share
+[👨🏼‍🏫expsup-upwork-img]: https://img.shields.io/badge/UpWork-13544E?style=for-the-badge&logo=Upwork&logoColor=white
+[👨🏼‍🏫expsup-codementor]: https://www.codementor.io/peterboling?utm_source=github&utm_medium=button&utm_term=peterboling&utm_campaign=github
+[👨🏼‍🏫expsup-codementor-img]: https://img.shields.io/badge/CodeMentor-Get_Help-1abc9c?style=for-the-badge&logo=CodeMentor&logoColor=white
+[🏙️entsup-tidelift]: https://tidelift.com/subscription/pkg/rubygems-rust-merge?utm_source=rubygems-rust-merge&utm_medium=referral&utm_campaign=readme
+[🏙️entsup-tidelift-img]: https://img.shields.io/badge/Tidelift_and_Sonar-Enterprise_Support-FD3456?style=for-the-badge&logo=sonar&logoColor=white
+[🏙️entsup-tidelift-sonar]: https://blog.tidelift.com/tidelift-joins-sonar
+[💁🏼‍♂️peterboling]: http://www.peterboling.com
+[🚂railsbling]: http://www.railsbling.com
+[📜src-gl-img]: https://img.shields.io/badge/GitLab-FBA326?style=for-the-badge&logo=Gitlab&logoColor=orange
+[📜src-gl]: https://gitlab.com/structuredmerge/structuredmerge-ruby/-/tree/main/gems/rust-merge
+[📜src-cb-img]: https://img.shields.io/badge/CodeBerg-4893CC?style=for-the-badge&logo=CodeBerg&logoColor=blue
+[📜src-cb]: https://codeberg.org/structuredmerge/structuredmerge-ruby/src/branch/main/gems/rust-merge
+[📜src-gh-img]: https://img.shields.io/badge/GitHub-238636?style=for-the-badge&logo=GitHub&logoColor=green
+[📜src-gh]: https://github.com/structuredmerge/structuredmerge-ruby/tree/main/gems/rust-merge
+[📜docs-cr-rd-img]: https://img.shields.io/badge/RubyDoc-Current_Release-943CD2?style=for-the-badge&logo=readthedocs&logoColor=white
+[📜docs-head-rd-img]: https://img.shields.io/badge/YARD_on_Galtzo.com-HEAD-943CD2?style=for-the-badge&logo=readthedocs&logoColor=white
+[📜gl-wiki]: https://gitlab.com/structuredmerge/structuredmerge-ruby/-/wikis/home
+[📜gh-wiki]: https://github.com/structuredmerge/structuredmerge-ruby/wiki
+[📜gl-wiki-img]: https://img.shields.io/badge/wiki-gitlab-943CD2.svg?style=for-the-badge&logo=gitlab&logoColor=white
+[📜gh-wiki-img]: https://img.shields.io/badge/wiki-github-943CD2.svg?style=for-the-badge&logo=github&logoColor=white
+[👽dl-rank]: https://clickgems.clickhouse.com/dashboard/rust-merge
+[👽dl-ranki]: https://img.shields.io/gem/dt/rust-merge.svg
+[👽version]: https://clickgems.clickhouse.com/dashboard/rust-merge
+[👽versioni]: https://img.shields.io/gem/v/rust-merge.svg
+[🚎11-c-wf]: https://github.com/structuredmerge/structuredmerge-ruby/actions/workflows/current.yml
+[🚎11-c-wfi]: https://github.com/structuredmerge/structuredmerge-ruby/actions/workflows/current.yml/badge.svg
+[💎ruby-c-i]: https://img.shields.io/badge/Ruby-current-CC342D?style=for-the-badge&logo=ruby&logoColor=green
+[🤝gh-issues]: https://github.com/structuredmerge/structuredmerge-ruby/issues
+[🤝gh-pulls]: https://github.com/structuredmerge/structuredmerge-ruby/pulls
+[🤝gl-issues]: https://gitlab.com/structuredmerge/structuredmerge-ruby/-/issues
+[🤝gl-pulls]: https://gitlab.com/structuredmerge/structuredmerge-ruby/-/merge_requests
+[🤝cb-issues]: https://codeberg.org/structuredmerge/structuredmerge-ruby/issues
+[🤝cb-pulls]: https://codeberg.org/structuredmerge/structuredmerge-ruby/pulls
+[🤝cb-donate]: https://donate.codeberg.org/
+[🤝contributing]: https://github.com/structuredmerge/structuredmerge-ruby/blob/main/CONTRIBUTING.md
+[🖐contrib-rocks]: https://contrib.rocks
+[🖐contributors]: https://github.com/structuredmerge/structuredmerge-ruby/graphs/contributors
+[🖐contributors-img]: https://contrib.rocks/image?repo=structuredmerge/structuredmerge-ruby
+[🪇conduct]: https://github.com/structuredmerge/structuredmerge-ruby/blob/main/CODE_OF_CONDUCT.md
+[🪇conduct-img]: https://img.shields.io/badge/Contributor_Covenant-2.1-259D6C.svg
+[📌pvc]: http://guides.rubygems.org/patterns/#pessimistic-version-constraint
+[📌semver]: https://semver.org/spec/v2.0.0.html
+[📌semver-img]: https://img.shields.io/badge/semver-2.0.0-259D6C.svg?style=flat
+[📌semver-breaking]: https://github.com/semver/semver/issues/716#issuecomment-869336139
+[📌major-versions-not-sacred]: https://tom.preston-werner.com/2022/05/23/major-version-numbers-are-not-sacred.html
+[📌changelog]: https://github.com/structuredmerge/structuredmerge-ruby/blob/main/CHANGELOG.md
+[📗keep-changelog]: https://keepachangelog.com/en/1.0.0/
+[📗keep-changelog-img]: https://img.shields.io/badge/keep--a--changelog-1.0.0-34495e.svg?style=flat
+[📌gitmoji]: https://gitmoji.dev
+[📌gitmoji-img]: https://img.shields.io/badge/gitmoji_commits-%20%F0%9F%98%9C%20%F0%9F%98%8D-34495e.svg?style=flat-square
+[🧮kloc]: https://www.youtube.com/watch?v=dQw4w9WgXcQ
+[🧮kloc-img]: https://img.shields.io/badge/KLOC-0.127-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
+[🔐security]: https://github.com/structuredmerge/structuredmerge-ruby/blob/main/SECURITY.md
+[🔐security-img]: https://img.shields.io/badge/security-policy-259D6C.svg?style=flat
+[📄copyright-notice-explainer]: https://opensource.stackexchange.com/questions/5778/why-do-licenses-such-as-the-mit-license-specify-a-single-year
+[📄license]: LICENSE.md
+[📄license-ref]: LICENSE.md
+[📄license-img]: https://img.shields.io/badge/License-AGPL--3.0--only_OR_PolyForm--Small--Business--1.0.0-259D6C.svg
+[📄license-compat]: https://www.apache.org/legal/resolved.html#category-x
+[📄license-compat-img]: https://img.shields.io/badge/Apache_Incompatible:_Category_X-%E2%9C%97-C0392B.svg?style=flat&logo=Apache
+[📄ilo-declaration]: https://www.ilo.org/declaration/lang--en/index.htm
+[📄ilo-declaration-img]: https://img.shields.io/badge/ILO_Fundamental_Principles-✓-259D6C.svg?style=flat
+[🚎yard-current]: http://rubydoc.info/gems/rust-merge
+[🚎yard-head]: https://rust-merge.galtzo.com
+[💎stone_checksums]: https://github.com/galtzo-floss/stone_checksums
+[💎SHA_checksums]: https://gitlab.com/structuredmerge/structuredmerge-ruby/-/tree/main/checksums
+[💎rlts]: https://github.com/rubocop-lts/rubocop-lts
+[💎rlts-img]: https://img.shields.io/badge/code_style_&_linting-rubocop--lts-34495e.svg?plastic&logo=ruby&logoColor=white
+[💎appraisal2]: https://github.com/appraisal-rb/appraisal2
+[💎appraisal2-img]: https://img.shields.io/badge/appraised_by-appraisal2-34495e.svg?plastic&logo=ruby&logoColor=white
+[💎d-in-dvcs]: https://railsbling.com/posts/dvcs/put_the_d_in_dvcs/

data/lib/rust/merge/file_analysis.rb

@@ -0,0 +1,102 @@
+# frozen_string_literal: true
+
+module Rust
+  module Merge
+    # Native TreeHaver analysis of safely attributable top-level Rust items.
+    # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/MethodLength, Metrics/PerceivedComplexity -- one AST pass establishes ordered ownership and attribute/comment attachment
+    class FileAnalysis
+      attr_reader :source, :root_node, :declarations, :errors, :backend
+
+      def initialize(source)
+        @source = source
+        @backend = TREE_SITTER_BACKEND.id.to_sym
+        @errors = []
+        parse!
+      rescue StandardError => e
+        @root_node = nil
+        @declarations = [].freeze
+        @errors = [e].freeze
+      end
+
+      private
+
+      def parse!
+        @root_node = TreeHaver.parser_for(:rust, backend_type: :tree_sitter).parse(source).root_node
+        raise TreeHaver::NotAvailable, 'Rust parse returned no root node' unless root_node
+        raise TreeHaver::NotAvailable, 'Rust parse contains syntax errors' if root_node.has_error?
+
+        wrappers = []
+        pending = []
+        root_node.children.each do |node|
+          if attachable?(node)
+            if comment?(node) && trailing_comment?(wrappers.last, node)
+              wrappers.last.attach_trailing_comment!(node)
+            else
+              pending << node
+            end
+            next
+          end
+          if NodeWrapper::DECLARATION_TYPES.include?(node.type)
+            wrappers << NodeWrapper.new(node, source: source, leading_comments: attached_prefix(pending, node))
+            pending.clear
+          elsif globally_unmanaged?(node)
+            pending.clear
+          elsif node.named?
+            raise TreeHaver::NotAvailable, "Unmanaged top-level Rust node #{node.type.inspect}"
+          end
+        end
+        @declarations = wrappers.freeze
+      end
+
+      def attachable?(node)
+        comment?(node) || NodeWrapper::ATTRIBUTE_TYPES.include?(node.type)
+      end
+
+      def comment?(node) = NodeWrapper::COMMENT_TYPES.include?(node.type)
+
+      def globally_unmanaged?(node)
+        %w[inner_attribute_item shebang].include?(node.type)
+      end
+
+      def trailing_comment?(owner, comment)
+        owner && whitespace_only?(source.byteslice(owner.end_byte...comment.start_byte).to_s) &&
+          source.byteslice(owner.end_byte...comment.start_byte).to_s.count("\n").zero?
+      end
+
+      def attached_prefix(items, owner)
+        attached = []
+        cursor = owner.start_byte
+        items.reverse_each do |item|
+          gap = source.byteslice(item.end_byte...cursor).to_s
+          break unless whitespace_only?(gap)
+          break if gap.count("\n") > 1 && !structural_attribute?(item)
+
+          attached.unshift(item)
+          cursor = item.start_byte
+        end
+        attached.freeze
+      end
+
+      def structural_attribute?(item)
+        return true if NodeWrapper::ATTRIBUTE_TYPES.include?(item.type)
+
+        !find_descendant(item, 'outer_doc_comment_marker').nil?
+      end
+
+      def find_descendant(parent, type)
+        return parent if parent.type == type
+
+        parent.children.each do |child|
+          found = find_descendant(child, type)
+          return found if found
+        end
+        nil
+      end
+
+      def whitespace_only?(value)
+        value.each_byte.all? { |byte| [9, 10, 13, 32].include?(byte) }
+      end
+    end
+    # rubocop:enable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/MethodLength, Metrics/PerceivedComplexity
+  end
+end

data/lib/rust/merge/node_wrapper.rb

@@ -0,0 +1,219 @@
+# frozen_string_literal: true
+
+module Rust
+  module Merge
+    # Structural identity and source-range adapter for one top-level Rust item.
+    # rubocop:disable Metrics/AbcSize, Metrics/ClassLength, Metrics/CyclomaticComplexity, Metrics/MethodLength, Metrics/PerceivedComplexity -- Rust item forms share one structural identity boundary
+    class NodeWrapper
+      DECLARATION_TYPES = %w[
+        const_item
+        enum_item
+        expression_statement
+        extern_crate_declaration
+        function_item
+        impl_item
+        macro_definition
+        mod_item
+        static_item
+        struct_item
+        trait_item
+        type_item
+        union_item
+        use_declaration
+      ].freeze
+      NAMED_ITEMS = {
+        'const_item' => [:const, %w[identifier]],
+        'enum_item' => [:enum, %w[type_identifier]],
+        'function_item' => [:function, %w[identifier]],
+        'macro_definition' => [:macro, %w[identifier]],
+        'mod_item' => [:module, %w[identifier]],
+        'static_item' => [:static, %w[identifier]],
+        'struct_item' => [:struct, %w[type_identifier]],
+        'trait_item' => [:trait, %w[type_identifier]],
+        'type_item' => [:type, %w[type_identifier]],
+        'union_item' => [:union, %w[type_identifier]]
+      }.freeze
+      COMMENT_TYPES = %w[block_comment line_comment].freeze
+      ATTRIBUTE_TYPES = %w[attribute_item].freeze
+
+      attr_reader :node, :source, :leading_comments, :trailing_comments
+
+      def initialize(node, source:, leading_comments: [])
+        @node = node
+        @source = source
+        @leading_comments = leading_comments.freeze
+        @trailing_comments = []
+      end
+
+      def signature
+        value = case node.type
+                when 'use_declaration' then use_signature
+                when 'extern_crate_declaration' then extern_crate_signature
+                when 'impl_item' then impl_signature
+                when 'expression_statement' then macro_invocation_signature
+                else named_signature(node)
+                end
+        value.freeze
+      end
+
+      def membership_signature
+        return semantic_node(use_body) if compound_use?
+
+        signature
+      end
+
+      def compound? = compound_use?
+      def start_byte = leading_comments.first&.start_byte || node.start_byte
+      def end_byte = trailing_comments.last&.end_byte || node.end_byte
+      def start_line = line_for_byte(start_byte)
+      def end_line = line_for_byte(end_byte.zero? ? 0 : end_byte - 1)
+      def source_text = source.byteslice(start_byte...end_byte).to_s
+      def attach_trailing_comment!(comment) = trailing_comments << comment
+      def semantic_tree = semantic_node(node)
+
+      private
+
+      def named_signature(value)
+        kind, name_types = NAMED_ITEMS.fetch(value.type) do
+          raise ArgumentError, "Unsupported top-level Rust node #{value.type.inspect}"
+        end
+        name = direct_named_child(value, name_types)
+        raise ArgumentError, "#{value.type} has no structurally attributable name" unless name
+
+        [kind, text(name)]
+      end
+
+      def use_signature
+        body = use_body
+        return [:use_tree, use_tree_root(body)] if compound_use?
+
+        [:use, use_target(body)]
+      end
+
+      def use_body
+        node.children.find do |child|
+          child.named? && child.type != 'visibility_modifier'
+        end || raise(ArgumentError, 'use declaration has no structural tree')
+      end
+
+      def compound_use?
+        node.type == 'use_declaration' && !find_descendant(use_body, %w[use_list]).nil?
+      end
+
+      def use_tree_root(body)
+        return :root if body.type == 'use_list'
+
+        child = body.children.find { |candidate| candidate.named? && candidate.type != 'use_list' }
+        raise ArgumentError, 'compound use tree has no structural root' unless child
+
+        path_head(child)
+      end
+
+      def use_target(body)
+        case body.type
+        when 'use_as_clause'
+          target = body.children.find(&:named?)
+          raise ArgumentError, 'use alias has no structural target' unless target
+
+          path_head(target)
+        when 'scoped_identifier'
+          path_head(body)
+        when 'use_wildcard'
+          [:wildcard, path_head(body)]
+        when 'identifier', 'self', 'super', 'crate'
+          text(body)
+        else
+          [:tree, semantic_node(body)]
+        end
+      end
+
+      def extern_crate_signature
+        identifiers = node.children.select { |child| child.type == 'identifier' }
+        raise ArgumentError, 'extern crate declaration has no crate name' if identifiers.empty?
+
+        [:extern_crate, text(identifiers.first)]
+      end
+
+      def impl_signature
+        children = node.children
+        for_index = children.index { |child| child.type == 'for' }
+        type_nodes = children.select { |child| rust_type_node?(child) }
+        target = for_index ? children[(for_index + 1)..].find { |child| rust_type_node?(child) } : type_nodes.last
+        trait = for_index && children[...for_index].reverse.find { |child| rust_type_node?(child) }
+        raise ArgumentError, 'impl item has no structural target' unless target
+
+        polarity = children.any? { |child| child.type == '!' } ? :negative : :positive
+        [:impl, trait && path_head(trait), path_head(target), polarity, generic_arity]
+      end
+
+      def generic_arity
+        parameters = node.children.find { |child| child.type == 'type_parameters' }
+        return 0 unless parameters
+
+        parameters.children.count do |child|
+          %w[type_parameter lifetime_parameter const_parameter].include?(child.type)
+        end
+      end
+
+      def rust_type_node?(value)
+        return false unless value.named?
+
+        excluded = %w[type_parameters where_clause declaration_list visibility_modifier] +
+                   COMMENT_TYPES + ATTRIBUTE_TYPES
+        !excluded.include?(value.type)
+      end
+
+      def macro_invocation_signature
+        invocation = node.children.find { |child| child.type == 'macro_invocation' }
+        raise ArgumentError, 'expression statement is not a top-level macro invocation' unless invocation
+
+        path = invocation.children.find do |child|
+          %w[identifier scoped_identifier].include?(child.type)
+        end
+        raise ArgumentError, 'macro invocation has no structural path' unless path
+
+        [:macro_invocation, path_head(path)]
+      end
+
+      def path_head(value)
+        case value.type
+        when 'generic_type', 'reference_type', 'pointer_type'
+          child = value.children.find(&:named?)
+          child ? path_head(child) : value.type
+        when 'scoped_identifier', 'scoped_type_identifier'
+          value.children.select(&:named?).map { |child| path_head(child) }
+        when 'use_wildcard'
+          child = value.children.find(&:named?)
+          child ? path_head(child) : :wildcard
+        else
+          text(value)
+        end
+      end
+
+      def direct_named_child(parent, types)
+        parent.children.find { |candidate| types.include?(candidate.type) }
+      end
+
+      def find_descendant(parent, types)
+        return parent if types.include?(parent.type)
+
+        parent.children.each do |child|
+          found = find_descendant(child, types)
+          return found if found
+        end
+        nil
+      end
+
+      def semantic_node(value)
+        children = value.children
+        return [value.type, text(value)] if children.empty?
+
+        [value.type, children.select(&:named?).map { |child| semantic_node(child) }]
+      end
+
+      def text(value) = source.byteslice(value.start_byte...value.end_byte).to_s
+      def line_for_byte(byte) = source.byteslice(0...byte).to_s.count("\n") + 1
+    end
+    # rubocop:enable Metrics/AbcSize, Metrics/ClassLength, Metrics/CyclomaticComplexity, Metrics/MethodLength, Metrics/PerceivedComplexity
+  end
+end