antares 0.2.2 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1c2ea1e51f704d6c2181103ad704401abb9977724f6139c02df420bdb711f71d
-  data.tar.gz: fe214d18846dfa84a061ea93dc35415a92597f6b376469251333fb45b9a19b9e
+  metadata.gz: 7dc02698aeba01c20d7c2b18bfb93a35f5120af7ffbfbbe3f3a75913d05ad5b1
+  data.tar.gz: 7d041d5ab1a00e613cb31749b4896a159f7e32dbe0c2c8065fa760ca377699b3
 SHA512:
-  metadata.gz: 38f5e5db511a43618e51175b2440addf02ccd8c2cd5d3b5607b66520f391924d47979a2d565f0e4a2375a3d492ed79cb5e8c255c469a16e136d446f73fdcd32a
-  data.tar.gz: 7aae8c8a2e1e0159f15e0d794906cd6262b95b46f95a4b3437761ffb71ea9be935a42571c013142de99d9b440895db4ccbf9c35760f92ba427d4b0801440bc9c
+  metadata.gz: afdaaa7687bf45869d8d57d54e47fd0874765a15ffcb4c29410836d93e260960ef37af73e6965d4bf52ebda61f22db5975ec304eb9b21f7d1ef6561de8e7a079
+  data.tar.gz: 522cc236f6365a1523d0a2b114eccfd7a8eba16e04e588ec5b64940cefb1dc11a09e04ab7e42c83530e6ae87fd28aa4f2bb80eb82e8319bef1300e352002b5b9

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## 0.3.0 — 2026-09-25
+
+- Add a CodeEditor highlighter adapter that maps Rouge scopes to theme syntax tokens.
+
 ## 0.2.2 — 2026-09-21
 
 - Add a deterministic syntax-highlighting demo image and regeneration task.

data/README.md

@@ -93,6 +93,26 @@ structure.selection_ranges(1, 3)  # inner-to-outer Antares::Region values
 Update the provider before calling `edit`. Line indices are zero based;
 `removed` is the old line count and `inserted` is the new line count.
 
+For Zaniah 0.10's `UI::CodeEditor`, load `antares/zaniah_highlighter` and
+pass the same buffer to `Antares::ZaniahHighlighter.new(lexer:, buffer:)` and
+`CodeEditor.new(buffer:, highlighter:)`. The optional adapter translates Rouge
+tokens into byte ranges and `Theme::Syntax` scopes. It updates Antares after
+the editor changes the buffer; Antares itself does not depend on Zaniah.
+
+| Rouge scope prefix | Syntax scope |
+| --- | --- |
+| `Keyword` | `keyword` |
+| `Literal.String` | `string` |
+| `Literal.Number` | `number` |
+| `Comment` | `comment` |
+| `Name.Function`, `Name.Builtin` | `function` |
+| `Name.Class`, `Name.Namespace`, `Name.Decorator` | `type` |
+| `Name.Constant` | `constant` |
+| `Name.Variable` | `variable` |
+| `Operator` | `operator` |
+| `Punctuation` | `punctuation` |
+| other | `text` |
+
 The `lines` provider returns one valid UTF-8 logical line for each index,
 preferably including its newline. Tokens contain text rather than offsets: sum
 `text.bytesize` for byte offsets or `text.length` for character offsets.

data/lib/antares/version.rb

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

data/lib/antares/zaniah_highlighter.rb

@@ -0,0 +1,69 @@
+# frozen_string_literal: true
+
+require_relative "../antares"
+
+module Antares
+  # Optional CodeEditor highlighter; load with require "antares/zaniah_highlighter".
+  class ZaniahHighlighter
+    def initialize(lexer:, buffer:)
+      unless buffer.respond_to?(:line_count) && buffer.respond_to?(:line)
+        raise ArgumentError, "buffer must provide line_count and line"
+      end
+      @buffer = buffer
+      @snapshot = lines
+      @highlighter = Highlighter.new(lexer: lexer,
+        lines: ->(index) { @buffer.line(index) }, line_count: -> { @buffer.line_count })
+    end
+
+    def tokens(index, text)
+      raise TypeError, "line text must be a String" unless text.is_a?(String)
+      return [] if text.empty?
+
+      offset = 0
+      @highlighter.tokens_for(index).filter_map do |kind, value|
+        first = offset
+        offset += value.bytesize
+        last = [offset, text.bytesize].min
+        [first...last, scope(kind)].freeze if last > first
+      end
+    end
+
+    def edited(_range, _replacement)
+      updated = lines
+      old = @snapshot
+      first = 0
+      first += 1 while first < old.length && first < updated.length && old[first] == updated[first]
+      old_end, new_end = old.length, updated.length
+      while old_end > first && new_end > first && old[old_end - 1] == updated[new_end - 1]
+        old_end -= 1
+        new_end -= 1
+      end
+      @highlighter.edit(from_line: first, removed: old_end - first, inserted: new_end - first) if
+        old_end != first || new_end != first
+      @snapshot = updated
+      self
+    end
+
+    private
+
+    # ponytail: snapshots scan all lines after edits; incremental line deltas can replace this if large-buffer editing profiles slow.
+    def lines = Array.new(@buffer.line_count) { |index| @buffer.line(index).dup.freeze }
+
+    def scope(kind)
+      name = kind&.qualname.to_s
+      case name
+      when /\AKeyword/ then :keyword
+      when /\ALiteral\.String/ then :string
+      when /\ALiteral\.Number/ then :number
+      when /\AComment/ then :comment
+      when /\AName\.(Function|Builtin)/ then :function
+      when /\AName\.(Class|Namespace|Decorator)/ then :type
+      when /\AName\.Constant/ then :constant
+      when /\AName\.Variable/ then :variable
+      when /\AOperator/ then :operator
+      when /\APunctuation/ then :punctuation
+      else :text
+      end
+    end
+  end
+end

data/sig/antares.rbs

@@ -72,6 +72,12 @@ module Antares
     def structure: () -> _Structure
   end
 
+  class ZaniahHighlighter
+    def initialize: (lexer: untyped, buffer: untyped) -> void
+    def tokens: (Integer index, String text) -> Array[[Range[Integer], Symbol]]
+    def edited: (Range[Integer] range, String replacement) -> self
+  end
+
   class Bracket < Struct[untyped]
     attr_accessor open_line: Integer
     attr_accessor open_column: Integer

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: antares
 version: !ruby/object:Gem::Version
-  version: 0.2.2
+  version: 0.3.0
 platform: ruby
 authors:
 - Yudai Takada
@@ -62,6 +62,7 @@ files:
 - lib/antares/tm_language_lexer.rb
 - lib/antares/tm_language_plist.rb
 - lib/antares/version.rb
+- lib/antares/zaniah_highlighter.rb
 - sig/antares.rbs
 homepage: https://github.com/noxdea/antares
 licenses: