syrma 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b76bd8cacebc9d29ee6b28a913efb6ef5ec7283cdf6462279064343207925a71
-  data.tar.gz: 5ee18a3987ecee83fd8c2a334afee51c1a161f3e892c155d0a9b1ecda3e0e68a
+  metadata.gz: be544217dc4ba67f34fa4cb6a824be44ab74dee130324f615e0824c5ab23fd72
+  data.tar.gz: 970b020a33399800791693b1922aacdfa679d4260947c75ff938838b31ad8794
 SHA512:
-  metadata.gz: 8166b829a204806d7c53c101bebab2b1568e95d2af3756510aa85eecf76a9234602b656a316388ce5f0c2f09b4e949b6ba18076aaabf8b2b9e2146ba69d88348
-  data.tar.gz: 11694f50f19407679166aa2cc305c1418832a3075166e76d9153cbd17b31996989f7211bd7b9997ba9f8818903a17147f5342196cd6d2ff4a4f7d9aa4ef6214f
+  metadata.gz: a2e0b783bc7e6c66fba35676fc1d10117e4c0436362eb494f32d0d5e857ff2a1ad50f2f743722fd13ae31633a6a5ba9fe9a0475d79cbf1796edf3f94a9a5f878
+  data.tar.gz: f9d84eba21b734e63dc793461b7f3b45fb75be5ffc862915ede839c245e269296b4dd8690c570a3cd29f9236aa02263d31dfc4b06ce278e5934f01e6c309ab9b

data/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## 0.4.0 - 2026-09-24
+
+- Support Zaniah 0.7 inspection snapshots and semantic accessibility queries.
+- Use Zaniah's public font, executor, and frame APIs instead of internal instrumentation.
+
 ## 0.3.0 - 2026-09-20
 
 - Add deterministic virtual-clock demo recording with humanized input, pixel-space chrome, and Wezen output hooks.

data/README.md

@@ -54,7 +54,7 @@ bundle install
 bundle exec syrma doctor
 ```
 
-Syrma requires Ruby 3.1 or later and supports Zaniah `>= 0.2, < 0.6`. RSpec users can replace Minitest with RSpec in the test group.
+Syrma requires Ruby 3.1 or later and supports Zaniah `>= 0.7, < 1.0`. RSpec users can replace Minitest with RSpec in the test group.
 
 ### Demo recording
 
@@ -135,11 +135,13 @@ end
 | Keyboard/text | `press`, `type`, `paste`, `compose`, `commit` |
 | Window/input | `resize`, `close`, `drop_files`, `feed_terminal` |
 | Synchronize | `settle`, `wait_for`, `advance` |
-| Inspect | `tree`, `texts`, `at`, `pixel`, `screenshot`, `terminal_lines`, `menu`, `tooltip` |
+| Inspect | `tree`, `texts`, `at`, `accessibility`, `pixel`, `screenshot`, `terminal_lines`, `menu`, `tooltip` |
 | Assert | Text, element, visibility, panels, decorations, background, pixel, tooltip, menu, tree/terminal/image snapshots |
 
 Locators are lazy: every operation resolves them against the latest rendered frame. Actions wait for visibility and an unobscured matching event handler, then send events through `Window#input`.
 
+`ui.accessibility(role: :button, label: "Save")` searches Zaniah's semantic tree and returns `[node, path]` pairs. Unlike visual locators, semantic nodes need not correspond to a rendered element or have bounds; use `ui.find` for pointer actions.
+
 Panel and decoration assertions use rendered `test_id` instrumentation, so application code does not need a Syrma or Canopus runtime dependency:
 
 ```ruby

data/lib/syrma/cli.rb

@@ -40,7 +40,7 @@ module Syrma
       checks = {
         "Ruby" => "#{RUBY_VERSION} (#{RUBY_PLATFORM})",
         "zaniah" => Zaniah::VERSION,
-        "Bundled font" => File.file?(Internals.bundled_font_path) ? Internals.bundled_font_path : nil,
+        "Bundled font" => File.file?(Zaniah.bundled_font_path) ? Zaniah.bundled_font_path : nil,
         "YJIT" => defined?(RubyVM::YJIT) && RubyVM::YJIT.enabled? ? "enabled" : "disabled",
         "External encoding" => Encoding.default_external.name
       }

data/lib/syrma/session.rb

@@ -50,7 +50,7 @@ module Syrma
       @outputs = {}
       @windows = attached_windows || [open_window(backend, width, height, window_options, keymap)]
       @drivers = @windows.map { |window| prepare(window, backend, text, fonts) }
-      @font_paths = text == :deterministic ? [Internals.bundled_font_path, *fonts.map { |font| File.expand_path(font) }] : []
+      @font_paths = text == :deterministic ? [Zaniah.bundled_font_path, *fonts.map { |font| File.expand_path(font) }] : []
       @current = 0
       mount&.call(window)
       settle
@@ -102,7 +102,7 @@ module Syrma
           candidate.tick
           busy = true
         end
-        return self unless busy || (@app && !Internals.executor_idle?(@app.executor))
+        return self unless busy || (@app && !@app.executor.idle?)
       end
       raise UnstableUI, "UI did not stabilize within #{@max_frames} frames (continuous animation?)"
     end

data/lib/syrma/snapshot.rb

@@ -14,10 +14,11 @@ module Syrma
     def inspect = "#<#{type}#{test_id && " @#{test_id}"}#{text && " #{text.inspect}"} #{path.join('.')}>"
   end
 
-  Tree = Data.define(:frame, :size, :root, :nodes, :hits, :text_runs, :menu, :menu_index, :tooltip) do
+  Tree = Data.define(:frame, :size, :root, :nodes, :hits, :text_runs, :menu, :menu_index, :tooltip, :hit_regions) do
     def hit_at(point, event: :mouse_down, button: :left)
-      hits.reverse_each do |bounds, node|
-        next unless bounds.contains?(point)
+      hits.length.times.reverse_each do |index|
+        _bounds, node = hits[index]
+        next unless hit_regions[index].contains?(point)
 
         return node if node.nil? || Tree.handles?(node, event, button)
       end
@@ -27,7 +28,7 @@ module Syrma
     def self.handles?(node, event, button)
       case event
       when :mouse_down
-        (button == :right && Internals.context_menu(node.element)) ||
+        (button == :right && node.element.respond_to?(:context_menu_items) && node.element.context_menu_items) ||
           (node.handlers & %i[mouse_down click drag]).any?
       when :mouse_move then node.handlers.include?(:hover) || node.tooltip
       when :mouse_up then node.handlers.include?(:mouse_up)
@@ -38,40 +39,43 @@ module Syrma
 
   class SnapshotBuilder
     def build(window)
+      snapshot = Zaniah::Inspection.snapshot(window)
       by_element = {}.compare_by_identity
       nodes = []
       viewport = Zaniah::Bounds.new(0, 0, window.content_size.width, window.content_size.height)
-      root = window.testing_root && visit(window.testing_root, viewport, [0], nodes, by_element)
-      hits = window.dispatcher.hits.map { |hit| [hit.bounds, hit.owner && by_element[hit.owner]] }
-      popup = window.popup
-      Tree.new(frame: window.testing_frame, size: window.content_size, root: root,
-               nodes: nodes.freeze, hits: hits.freeze, text_runs: window.text_runs.map(&:dup).freeze,
+      root = snapshot.root && visit(snapshot.root, viewport, [0], nodes, by_element)
+      hits = snapshot.hits.map { |hit| [hit.bounds, hit.owner && by_element[hit.owner]] }
+      popup = snapshot.overlays.popup
+      tooltip = snapshot.overlays.tooltip
+      Tree.new(frame: snapshot.frame.number, size: window.content_size, root: root,
+               nodes: nodes.freeze, hits: hits.freeze, hit_regions: snapshot.hits, text_runs: snapshot.text_runs,
                menu: popup&.labels, menu_index: popup&.selected_index,
-               tooltip: Internals.shown_tooltip(window))
+               tooltip: tooltip && tooltip[:shown] ? tooltip[:text] : nil)
     end
 
     private
 
-    def visit(element, clip, path, nodes, by_element)
-      bounds = element.layout_node&.bounds or return nil
-      style = Internals.style(element)
+    def visit(entry, clip, path, nodes, by_element)
+      bounds = entry.bounds or return nil
+      style = entry.style
       return nil if style[:display] == :none
 
       visible = bounds.intersect(clip)
       child_clip = style[:overflow] == :visible ? clip : visible
       index = nodes.length
       nodes << nil
-      children = element.children.each_with_index.filter_map do |child, child_index|
+      children = entry.children.each_with_index.filter_map do |child, child_index|
         visit(child, child_clip, path + [child_index], nodes, by_element)
       end
+      element = entry.element
       node = Node.new(
-        path: path.freeze, element: element, type: element.class.name.split("::").last.downcase.to_sym,
-        test_id: element.test_id, key: Internals.key(element),
+        path: path.freeze, element: element, type: entry.type.split("::").last.downcase.to_sym,
+        test_id: entry.test_id, key: entry.key,
         text: text_attr(element, :text), color: text_attr(element, :text_color),
         font_size: text_attr(element, :font_size), bounds: bounds, visible_bounds: visible,
-        background: Internals.background(element), border_color: Internals.border_color(element),
-        radius: Internals.radius(element), handlers: element.handlers,
-        tooltip: Internals.tooltip(element), children: children.freeze
+        background: style[:background], border_color: style[:border_color],
+        radius: style[:corner_radii], handlers: entry.handlers,
+        tooltip: entry.tooltip, children: children.freeze
       )
       nodes[index] = node
       by_element[element] = node

data/lib/syrma/text_systems.rb

@@ -9,7 +9,7 @@ module Syrma
       when :none, nil then nil
       when :native then Zaniah::TextSystem::Renderer.new
       when :deterministic
-        paths = [Internals.bundled_font_path, *fonts.map { |font| File.expand_path(font) }]
+        paths = [Zaniah.bundled_font_path, *fonts.map { |font| File.expand_path(font) }]
         missing = paths.reject { |path| File.file?(path) }
         raise ArgumentError, "Fonts not found: #{missing.join(', ')}" unless missing.empty?
 

data/lib/syrma/version.rb

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

data/lib/syrma/window_driver.rb

@@ -17,7 +17,7 @@ module Syrma
 
     def tree
       session.settle
-      @tree = nil if @tree && @tree.frame != window.testing_frame
+      @tree = nil if @tree && @tree.frame != window.frame_number
       @tree ||= @builder.build(window)
     end
 
@@ -27,6 +27,10 @@ module Syrma
     def text(value) = find(text: value)
     def texts = tree.text_runs.map { |run| run[2] }
     def tooltip = tree.tooltip
+    def accessibility(role: nil, label: nil, states: {})
+      session.settle
+      Zaniah::Inspection.snapshot(window).accessibility.query(role: role, label: label, states: states)
+    end
 
     def button(label)
       find(clickable: true) do |node|
@@ -182,7 +186,7 @@ module Syrma
     def menu = (@menu_driver ||= PopupDriver.new(self))
 
     def dispatch(event)
-      session.event_log.add(window.testing_frame, window.title, event)
+      session.event_log.add(window.frame_number, window.title, event)
       window.input(event)
       session.settle unless @in_gesture && session.event_frames == :gesture
       event

data/lib/syrma.rb

@@ -4,7 +4,6 @@ require "zaniah"
 require_relative "syrma/version"
 require_relative "syrma/configuration"
 require_relative "syrma/errors"
-require_relative "syrma/internals"
 require_relative "syrma/instrumentation"
 require_relative "syrma/clock"
 require_relative "syrma/text_systems"

data/sig/syrma.rbs

@@ -78,6 +78,7 @@ module Syrma
     attr_reader root: Node?
     attr_reader nodes: Array[Node]
     attr_reader hits: Array[untyped]
+    attr_reader hit_regions: Array[untyped]
     attr_reader text_runs: Array[untyped]
     attr_reader menu: Array[String]?
     attr_reader menu_index: Integer?
@@ -200,6 +201,7 @@ module Syrma
     def text: (String | Regexp value) -> Locator
     def texts: () -> Array[String]
     def tooltip: () -> String?
+    def accessibility: (?role: Symbol?, ?label: String | Regexp | nil, ?states: Hash[Symbol, untyped]) -> Array[[untyped, Array[Integer]]]
     def button: (String label) -> Locator
     def at: (untyped x, ?untyped y, ?event: Symbol, ?button: Symbol) -> Node?
     def pixel: (Integer x, Integer y) -> Array[Integer]

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: syrma
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Yudai Takada
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-09-20 00:00:00.000000000 Z
+date: 2026-09-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: zaniah
@@ -16,20 +16,20 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0.2'
+        version: '0.7'
     - - "<"
       - !ruby/object:Gem::Version
-        version: '0.6'
+        version: '1.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0.2'
+        version: '0.7'
     - - "<"
       - !ruby/object:Gem::Version
-        version: '0.6'
+        version: '1.0'
 - !ruby/object:Gem::Dependency
   name: wezen
   requirement: !ruby/object:Gem::Requirement
@@ -73,7 +73,6 @@ files:
 - lib/syrma/event_codec.rb
 - lib/syrma/event_log.rb
 - lib/syrma/instrumentation.rb
-- lib/syrma/internals.rb
 - lib/syrma/minitest.rb
 - lib/syrma/popup_driver.rb
 - lib/syrma/query.rb

data/lib/syrma/internals.rb

@@ -1,32 +0,0 @@
-# frozen_string_literal: true
-
-module Syrma
-  module Internals
-    module_function
-
-    def style(element) = element.instance_variable_get(:@style) || {}
-    def background(element) = paint_value(element, :background, :@background)
-    def border_color(element) = paint_value(element, :border_color, :@border_color)
-    def radius(element) = paint_value(element, :corner_radii, :@radius)
-    def tooltip(element) = element.instance_variable_get(:@tooltip)
-    def context_menu(element) = element.instance_variable_get(:@context_menu)
-    def key(element) = element.instance_variable_get(:@key)
-    def shown_tooltip(window)
-      tip = window.instance_variable_get(:@tooltip)
-      tip && tip[:shown] ? tip[:text] : nil
-    end
-
-    def bundled_font_path
-      _, entry = $LOAD_PATH.resolve_feature_path("zaniah")
-      File.expand_path("../assets/fonts/Abel-Regular.ttf", File.dirname(entry))
-    end
-
-    def executor_idle?(executor) = executor.instance_variable_get(:@foreground).empty?
-
-    def paint_value(element, property, legacy)
-      resolved = element.respond_to?(:resolved_style) ? element.resolved_style : nil
-      resolved&.[](property) || element.instance_variable_get(legacy) || style(element)[property]
-    end
-    private_class_method :paint_value
-  end
-end