sadr 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fa9d3261b52e409bc33e40c02fbf3e3659d701a70115c6cd5784a106232f5669
-  data.tar.gz: db606ffa6c2444b3ab23a38fdcefa285a80fa6fb6956590a369b30f628d316db
+  metadata.gz: 1a6bf397abf93fe02bb31c2e0ed4a8096e511489aeb47702806e0d9627549e02
+  data.tar.gz: 333d34cc9d7ef85fa3f41fb10a82c9fa15de4448ec8e56ea0096650847574745
 SHA512:
-  metadata.gz: 457a517a32c63de12ab4a3461c36f34a6270e7e77ec05b7c4beb9545c0b3a31c1b01b43a41fbcbffd2fa93f08a2987541b830eda8195f9f60ae576c6b1b8c0b7
-  data.tar.gz: 53313130ecb14ae934774fe9c8a442a53bb6791fc75896f9ead392b4c370e27ca3ecffdc819981e4503a94919b35a41984bd06581e469f7f9dc9354030ecc041
+  metadata.gz: f924801c48f7e53f11e0972c129e2c3fa74ef3ae10cc717bc084637188531bcc59bb263f062e2ac8332e6d53524e88a8e328efa20d2ac01f0dcef3c12ef99a66
+  data.tar.gz: ddc6b08e354a23d12c964a0def4db31f9b9d4eb61a2b05774e1a21a1ddec8069b751dbb9dbcfd250b5b808c3be6580e1c96348fb3f5191144eeeac70657ce684

data/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## 0.2.0 - 2026-09-16
+
+- Add document highlights, folding ranges, selection ranges, and rename preparation
+- Add call and type hierarchy preparation and navigation, document links and resolution, and linked editing ranges
+- Add range formatting and workspace configuration and watched-file notifications
+- Validate all new request results and advertise their client capabilities
+
 ## 0.1.0 - 2026-09-16
 
 - Initial release

data/README.md

@@ -15,7 +15,8 @@ gem "sadr"
 ```ruby
 require "sadr"
 
-client = Sadr::Client.new(command: ["ruby-lsp"]).start
+client = Sadr::Client.new(command: ["ruby-lsp"])
+capabilities = client.start
 document = Sadr::Document.new(
   uri: Sadr::Protocol.uri("example.rb"),
   language_id: "ruby",
@@ -29,6 +30,53 @@ completion = client.completion(document.uri, position).await
 client.stop
 ```
 
+Document highlights, folding and selection ranges, rename preparation,
+hierarchy preparation, document links, linked editing ranges, and range
+formatting use the same URI and UTF-16 position values:
+
+```ruby
+highlights = client.document_highlight(document.uri, position).await
+folds = client.folding_range(document.uri).await
+selection = client.selection_range(document.uri, [position]).await
+rename_range = client.prepare_rename(document.uri, position).await
+range = Sadr::Range_.new(start: position, end: position)
+formatted = client.range_formatting(document.uri, range,
+  tabSize: 2, insertSpaces: true).await
+```
+
+Prepared hierarchy items can be followed in either direction. Document links
+can likewise be resolved after discovery. Sadr validates the supplied item and
+every returned item, call range, URI, and opaque JSON `data` value before
+crossing the client boundary:
+
+```ruby
+call_item = client.prepare_call_hierarchy(document.uri, position).await&.first
+incoming = client.call_hierarchy_incoming_calls(call_item).await if call_item
+outgoing = client.call_hierarchy_outgoing_calls(call_item).await if call_item
+
+type_item = client.prepare_type_hierarchy(document.uri, position).await&.first
+supertypes = client.type_hierarchy_supertypes(type_item).await if type_item
+subtypes = client.type_hierarchy_subtypes(type_item).await if type_item
+
+link = client.document_link(document.uri).await&.first
+resolved_link = client.resolve_document_link(link).await if link
+```
+
+Workspace changes are notifications and return after the transport accepts the
+message:
+
+```ruby
+client.did_change_configuration("ruby" => {"lint" => true})
+client.did_change_watched_files([{uri: document.uri, type: 2}])
+```
+
+Watched-file types follow LSP: `1` created, `2` changed, and `3` deleted.
+Configuration settings may be any JSON value, as required by LSP. Sadr snapshots
+them before sending so later caller mutations do not alter configuration replies.
+
+`Future#await` waits without a deadline by default. Pass `timeout:` in seconds
+when the caller needs a bounded wait; expiry cancels the request best-effort.
+
 `Position#character` is measured in UTF-16 code units. Increment versions and
 send immutable changes when a document changes:
 
@@ -47,6 +95,24 @@ position = Sadr::Protocol.position(my_text_index, byte_offset)
 edits = Sadr::Protocol.text_edits(my_text_index, server_edits)
 ```
 
+Tests can use the bundled child-process server or the in-memory transport:
+
+```ruby
+require "sadr/testing"
+
+client = Sadr::Client.new(command: Sadr::Testing::FakeServer.command)
+server = Sadr::Testing::FakeServer.new(responses: {"custom/request" => {"ok" => true}})
+fast_client = Sadr::Testing::FakeClient.new(server: server)
+```
+
+The optional real-server test stays outside the normal bundle and CI. After
+`bundle install`, run it with the same Ruby:
+
+```sh
+gem install ruby-lsp
+SADR_INTEGRATION=1 ruby -Ilib:test test/ruby_lsp_integration_test.rb
+```
+
 ## Development
 
 ```sh