denebola 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 84880d06ec622bb6081d11f260b1e64cbfba37a9480a717208356afbfcc28108
-  data.tar.gz: 5e7c2cba1e6fb6ecfd5f6cc49c517ff038ca09a85dc81da268e69fe74142172d
+  metadata.gz: 2039904dc6d7a0fcb5fed4aa2654588cc99bde0451961cf034ded4cee04c1d13
+  data.tar.gz: 6ea776a47897832290d5900414b7a6e663dbbc3f2310a6c513e68c236dd632d8
 SHA512:
-  metadata.gz: 26cf63ddd365e57f19af10f195db576f21de2e7c1cf865025c6c868cfdc876f33fe8bc055366513106b68b666973eb9cd7a596bd2856273e2de23e358ff22627
-  data.tar.gz: b26f9e6372cd7dea2413c82e29996692bca7a810f473b24cdb1fbe13e31e1702746f541b4d0a73d432880733bad5a149d6f42ea31d56c7b3ef2a2d271c4cdec4
+  metadata.gz: 932e37da79bfebdea36da0a517828d7d72e09378a7d704852caaef926eaa11b525d14029166bdbec3caedd1b8663199855495751e9e2ee27623c3403eed4a68e
+  data.tar.gz: 3677c6e1c45095b1eca7a8ecf250c55e271e0ad6379310c08ec63e352084a0da572c6ba1979f477b29d9a557edccbe46b62cdc51f8c196b2bc41ae8ac08b3ad9

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## 0.4.0 — 2026-09-25
+
+- Add a rope-backed buffer adapter for Zaniah CodeEditor.
+
 ## 0.3.0 — 2026-09-23
 
 - Add persistent sparse two-dimensional sheets with range summaries.

data/README.md

@@ -133,6 +133,25 @@ rope.offset_at_utf16_point(Denebola::Point.new(0, 2)) # => 4
 
 `line(row)` omits the terminator. Rows are zero-based; empty text and a final empty row after a terminator each count as a line. A byte position between CR and LF normalizes to the following row, column zero; converting that point back returns the position after LF.
 
+### Zaniah CodeEditor buffer
+
+The optional adapter exposes a persistent `Rope` through Zaniah's line-addressed
+CodeEditor buffer interface. Denebola does not depend on Zaniah:
+
+```ruby
+require "denebola/code_editor_buffer"
+require "zaniah/ui"
+
+buffer = Denebola::CodeEditorBuffer.new(Denebola::Rope.new("hello\nworld"))
+editor = Zaniah::UI::CodeEditor.new(buffer: buffer)
+```
+
+`line_count`, `line`, `line_start`, and `line_of` use Rope indexes; offsets are
+UTF-8 byte positions. `replace`, `undo`, and `redo` keep structurally shared
+snapshots, and `can_undo?`/`can_redo?` control editor actions. `to_s` materializes
+the full document when CodeEditor requests its value. `LazyRope` is not accepted:
+its default line count is an estimate, whereas CodeEditor needs an exact count.
+
 `rope.summary` exposes `bytesize`, `length`, `utf16_length`, `break_count`, `longest_row` (the earliest row with maximum width), `longest_row_length`, `first_line_length`, and `last_line_length`. `TextSummary.zero` is the identity, and `summary + other_summary` combines concatenated text, including CRLF across a boundary.
 
 ### Anchors

data/lib/denebola/code_editor_buffer.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+require_relative "../denebola"
+
+module Denebola
+  # Adapts a persistent Rope to Zaniah::UI::CodeEditor's buffer interface.
+  # Zaniah is not required by Denebola; pass an instance as `buffer:`.
+  class CodeEditorBuffer
+    attr_reader :rope
+
+    def initialize(rope = Rope.new)
+      raise ArgumentError, "expected a Denebola::Rope" unless rope.is_a?(Rope)
+      @rope = rope
+      @undo = []
+      @redo = []
+    end
+
+    def line_count = @rope.line_count
+    def line(index) = @rope.line(index)
+    def line_start(index) = @rope.line_start(index)
+    def line_of(offset)
+      row = @rope.point_at(offset).row
+      row.positive? && @rope.line_start(row) > offset ? row - 1 : row
+    end
+    def to_s = @rope.to_s
+
+    def replace(range, text)
+      updated = @rope.replace(range, text)
+      @undo << @rope
+      @redo.clear
+      @rope = updated
+      self
+    end
+
+    def undo
+      return self unless can_undo?
+      @redo << @rope
+      @rope = @undo.pop
+      self
+    end
+
+    def redo
+      return self unless can_redo?
+      @undo << @rope
+      @rope = @redo.pop
+      self
+    end
+
+    def can_undo? = !@undo.empty?
+    def can_redo? = !@redo.empty?
+  end
+end

data/lib/denebola/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Denebola
-  VERSION = "0.3.0"
+  VERSION = "0.4.0"
 end

data/sig/denebola.rbs

@@ -186,6 +186,21 @@ module Denebola
     def close: () -> nil
   end
 
+  class CodeEditorBuffer
+    attr_reader rope: Rope
+    def initialize: (?Rope) -> void
+    def line_count: () -> Integer
+    def line: (Integer) -> String
+    def line_start: (Integer) -> Integer
+    def line_of: (Integer) -> Integer
+    def to_s: () -> String
+    def replace: (Range[Integer?], String) -> self
+    def undo: () -> self
+    def redo: () -> self
+    def can_undo?: () -> bool
+    def can_redo?: () -> bool
+  end
+
   class Anchor
     attr_reader offset: Integer
     attr_reader bias: :left | :right

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: denebola
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Yudai Takada
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-09-23 00:00:00.000000000 Z
+date: 2026-09-24 00:00:00.000000000 Z
 dependencies: []
 description: Immutable text ropes plus bounded-memory, file-backed editing with line
   and UTF-16 indexing.
@@ -23,6 +23,7 @@ files:
 - README.md
 - lib/denebola.rb
 - lib/denebola/anchor.rb
+- lib/denebola/code_editor_buffer.rb
 - lib/denebola/cursor.rb
 - lib/denebola/dimensions.rb
 - lib/denebola/edit.rb