zaniah 0.6.4 → 0.7.0

data/lib/zaniah/platform/headless/window.rb

@@ -9,7 +9,7 @@ module Zaniah
         include Appearance
         DEFAULT_CLEAR = "#181b20"
 
-        attr_reader :content_size, :scene, :device, :dispatcher, :scale_factor, :text_runs, :pointer_position, :cursor_style, :animator, :clock, :accessibility_tree, :accessibility_revision, :frame_stats
+        attr_reader :content_size, :scene, :device, :dispatcher, :scale_factor, :text_runs, :pointer_position, :cursor_style, :animator, :clock, :accessibility_tree, :accessibility_revision, :frame_stats, :last_root, :frame_number
         attr_accessor :text_system, :ime_state, :title, :app, :devtools
 
         def initialize(width: 800, height: 600, title: "Zaniah UI", scale_factor: 1,
@@ -23,6 +23,7 @@ module Zaniah
           @accessibility_tree, @accessibility_revision = Accessibility::Tree.new, 0
           @frame_stats = {fps: 0.0, frame_ms: 0.0, layout_ms: 0.0, prepaint_ms: 0.0, paint_ms: 0.0, command_count: 0}.freeze
           @state, @used_state, @text_runs = {}, {}, []
+          @last_root, @frame_number = nil, 0
           @dirty, @closed, @pointer_down, @cursor_style = true, false, false, :arrow
         end
 
@@ -38,6 +39,10 @@ module Zaniah
         def animation_active? = !!@animator&.active?
         def closed? = @closed
         def pointer_down? = @pointer_down
+        def clipboard = @clipboard.to_s
+        def clipboard=(text)
+          @clipboard = text.to_s
+        end
         def set_cursor(style)
           raise ArgumentError, "unknown cursor #{style}" unless %i[arrow text pointer crosshair resize_horizontal resize_vertical].include?(style)
           return style if @cursor_style == style
@@ -65,6 +70,8 @@ module Zaniah
                     selected_index: @menu[:index], bounds: popup_bounds(@menu))
         end
 
+        def tooltip_state = @tooltip&.merge(text: @tooltip[:text].dup.freeze)&.freeze
+
         def resize(width, height)
           @content_size = Size.new(width, height)
           @device.resize(width, height)
@@ -173,6 +180,8 @@ module Zaniah
             prepaint_ms: (prepaint_finished - layout_finished) * 1000,
             paint_ms: (paint_finished - prepaint_finished) * 1000,
             command_count: @scene.commands.length / 4}.freeze
+          @last_root = element
+          @frame_number += 1
           @on_frame&.call(element, clear)
           @device.render(@scene, clear: clear) if present
           @text_system.end_frame if @text_system.respond_to?(:end_frame)

data/lib/zaniah/platform/tui/window.rb

@@ -9,6 +9,7 @@ module Zaniah
       class Window < Headless::Window
         def initialize(input: $stdin, output: $stdout, **options)
           @input, @output = input, output
+          options[:keymap] ||= Input::Keymap.default_ui(platform: :tui, clock: options.fetch(:clock, MONOTONIC_CLOCK))
           super(**options)
           @text_system = TextRenderer.new
           @input_decoder = InputDecoder.new { |event| self.input(event) }
@@ -39,6 +40,13 @@ module Zaniah
 
         def feed_input(bytes) = @input_decoder.feed(bytes)
 
+        def clipboard=(text)
+          super
+          @output.write("\e]52;c;#{[clipboard].pack('m0')}\a")
+          @output.flush
+          clipboard
+        end
+
         def render(element, **options)
           super(element, **options, present: false)
           rows = Array.new((content_size.height / 20).ceil) { Array.new((content_size.width / 8).ceil, " ") }

data/lib/zaniah/task_executor.rb

@@ -81,6 +81,8 @@ module Zaniah
       @wake.synchronize { @condition.signal }
     end
 
+    def idle? = @foreground.empty?
+
     def drain
       now = @clock.call
       due, @timers = @timers.partition { |deadline, _| deadline <= now }

data/lib/zaniah/text.rb

@@ -81,6 +81,7 @@ module Zaniah
       align: @text_align, ellipsis: @ellipsis, kinsoku: @kinsoku)
       @wrap, @line_height, @letter_spacing = mode, line_height, letter_spacing
       @text_align, @ellipsis, @kinsoku = align, ellipsis, kinsoku
+      @focus_handle.context[:multiline] = mode != :none || @text.include?("\n") if @focus_handle
       self
     end
 
@@ -88,7 +89,8 @@ module Zaniah
       @selectable = value
       @selection ||= TextSelection.new(0)
       return self unless value
-      focusable(context: {in_text_field: true}) { |action| text_action(action) }
+      focusable(context: {in_text_field: true, multiline: @wrap != :none || @text.include?("\n")},
+        validate: ->(action) { validate_text_action(action) }) { |action| text_action(action) }
       @focus_handle.on_input = ->(event) { text_input(event) }
       on_mouse_down { |event, _| begin_selection(event) }
       on_drag { |event, _| extend_selection(event) }
@@ -104,6 +106,7 @@ module Zaniah
     end
 
     def request_layout(cx)
+      @cx = cx
       @text = @buffer.to_s if @buffer
       value = display_text
       @paragraph, @line = nil, nil
@@ -226,10 +229,24 @@ module Zaniah
       head = @selection.head
       case action
       when :select_all then @selection = TextSelection.new(0, @text.bytesize)
+      when :copy then @cx.window.clipboard = @text.byteslice(@selection.range)
+      when :cut
+        @cx.window.clipboard = @text.byteslice(@selection.range)
+        delete_range(@selection.range)
+      when :paste then replace_selection(@cx.window.clipboard.to_s.encode(Encoding::UTF_8, invalid: :replace, undef: :replace))
+      when :undo, :redo then history(action)
       when :move_left then @selection = TextSelection.new(@selection.collapsed? ? Unicode.previous_boundary(@text, head) : @selection.range.begin)
       when :move_right then @selection = TextSelection.new(@selection.collapsed? ? Unicode.next_boundary(@text, head) : @selection.range.end)
       when :select_left then @selection = TextSelection.new(@selection.anchor, Unicode.previous_boundary(@text, head))
       when :select_right then @selection = TextSelection.new(@selection.anchor, Unicode.next_boundary(@text, head))
+      when :word_left, :word_right, :select_word_left, :select_word_right
+        direction = action.to_s.end_with?("left") ? :left : :right
+        target = Unicode.word_boundary(@text, head, direction)
+        @selection = action.to_s.start_with?("select") ? TextSelection.new(@selection.anchor, target) : TextSelection.new(target)
+      when :line_up, :line_down
+        @selection = TextSelection.new(Unicode.neighbor_line_offset(@text, head, action == :line_up ? -1 : 1))
+      when :document_start then @selection = TextSelection.new(0)
+      when :document_end then @selection = TextSelection.new(@text.bytesize)
       when :line_start, :select_line_start then move_to_line_edge(action, :start)
       when :line_end, :select_line_end then move_to_line_edge(action, :end)
       when :delete_backward then delete_backward
@@ -237,9 +254,35 @@ module Zaniah
       when :insert_newline then replace_selection("\n") if @editable
       else return false
       end
+      @cx&.window&.request_frame
       true
     end
 
+    def validate_text_action(action)
+      case action
+      when :copy then !@secure && !@selection.collapsed?
+      when :cut then !!@editable && !@secure && !@selection.collapsed?
+      when :paste then !!@editable && !@buffer.composition
+      when :undo then !!@editable && !@buffer.composition && @buffer.can_undo?
+      when :redo then !!@editable && @buffer.can_redo?
+      when :delete_backward, :delete_forward, :insert_newline then !!@editable
+      when :select_all, :move_left, :move_right, :select_left, :select_right,
+        :word_left, :word_right, :select_word_left, :select_word_right,
+        :line_up, :line_down, :document_start, :document_end,
+        :line_start, :line_end, :select_line_start, :select_line_end then true
+      end
+    end
+
+    def history(action)
+      before = @buffer.to_s
+      @buffer.public_send(action)
+      @text = @buffer.to_s
+      return if @text == before
+      position = Unicode.grapheme_boundaries(@text).reverse.find { |offset| offset <= @selection.head } || 0
+      @selection = TextSelection.new(position)
+      @on_change&.call(@text)
+    end
+
     def text_input(event)
       case event
       when Input::TextInput

data/lib/zaniah/text_buffer.rb

@@ -14,6 +14,8 @@ module Zaniah
 
     def to_s = @text.dup
     def bytesize = @text.bytesize
+    def can_undo? = !@undo.empty?
+    def can_redo? = !@redo.empty?
 
     def insert(offset, string)
       change(offset...offset, string, :insert)

data/lib/zaniah/ui/choice_fields.rb

@@ -23,9 +23,10 @@ module Zaniah
     class Combobox < Component
       attr_reader :value, :query
 
-      def initialize(items, value: nil, label: "Choose", placeholder: "Type to filter…", disabled: false)
+      def initialize(items, value: nil, label: "Choose", placeholder: "Type to filter…", disabled: false, matcher: nil)
         super()
         @items = normalize_items(items)
+        @matcher = Matcher::Session.new(@items.map(&:first), matcher || Zaniah.configuration.matcher || Matcher::Substring.new)
         @label, @placeholder, @disabled = label.to_s, placeholder.to_s, !!disabled
         @value = value
         @query = label_for(value).to_s
@@ -37,22 +38,27 @@ module Zaniah
 
       def build(cx)
         @cx = cx
-        @matches = @items.select { |label, _| @query.empty? || label.downcase.include?(@query.downcase) }.first(8)
+        @matches = @matcher.results(@query).first(8).filter_map do |match|
+          item = @items[match.index]
+          [item, match] if item
+        end
         @selected_index = @selected_index.clamp(0, [@matches.length - 1, 0].max)
         field = TextField.new(@query, label: @label, placeholder: @placeholder, disabled: @disabled)
           .on_change { |text, context| @query = text; @open = true; @selected_index = 0; context&.window&.request_frame }
         root = Div.new.gap(cx.theme.spacing[1]).focusable(context: {in_combobox: true}) { |action| combo_action(action) }.child(field)
         if @open && !@matches.empty? && !@disabled
           root.child(Div.new.p(2).gap(1).bg(cx.theme.colors.surface).border(1).border_color(cx.theme.colors.border)
-            .rounded(cx.theme.radii[:sm]).children(@matches.map.with_index do |(label, value), index|
-              Button.new(label, size: :sm, variant: index == @selected_index ? :secondary : :ghost).w_full
+            .rounded(cx.theme.radii[:sm]).children(@matches.map.with_index do |((label, value), match), index|
+              button = match.ranges.empty? ? Button.new(label, size: :sm, variant: index == @selected_index ? :secondary : :ghost) :
+                HighlightedButton.new(label, ranges: match.ranges, size: :sm, variant: index == @selected_index ? :secondary : :ghost)
+              button.w_full
                 .on_click { |event, context| choose(value, label, event, context) }
             end))
         end
         root
       end
 
-      def tui_cells(*) = "#{@label}: [#{@query}█]" + (@open ? "\n" + @matches.map.with_index { |(label, _), index| "#{index == @selected_index ? ">" : " "} #{label}" }.join("\n") : "")
+      def tui_cells(*) = "#{@label}: [#{@query}█]" + (@open ? "\n" + @matches.map.with_index { |((label, _), _match), index| "#{index == @selected_index ? ">" : " "} #{label}" }.join("\n") : "")
       def accessibility_node(_cx) = node(:combobox, label: @label, value: @value,
         states: {expanded: @open, disabled: @disabled}, actions: @disabled ? [] : %i[focus set_value])
 
@@ -77,7 +83,7 @@ module Zaniah
         when :choose_option
           match = @matches[@selected_index]
           return false unless match
-          return choose(match[1], match[0], nil, @cx)
+          return choose(match[0][1], match[0][0], nil, @cx)
         when :dismiss then @open = false
         else return false
         end

data/lib/zaniah/ui/editors.rb

@@ -46,6 +46,7 @@ module Zaniah
         @buffer = TextBuffer.new(text)
         @paragraph_styles = Array.new(text.count("\n") + 1) { {} }
         @selection, @selectable, @editable = TextSelection.new(0), !!selectable, !!editable
+        @undo_states, @redo_states = [], []
       end
 
       def text = @buffer.to_s
@@ -83,6 +84,7 @@ module Zaniah
         first, finish = checked_range(range)
         changes = normalize_style(style)
         return self if first == finish || changes.empty?
+        record_edit
         boundaries = [0, text.bytesize, first, finish, *@spans.flat_map { |span| [span.start, span.finish] }].uniq.sort
         @spans = merge_spans(boundaries.each_cons(2).filter_map do |from, to|
           next if from == to
@@ -98,6 +100,7 @@ module Zaniah
         offset = checked_offset(offset)
         validate_text(value)
         return self if value.empty?
+        record_edit
         inherited = style ? normalize_style(style) : style_at(offset)
         size, newlines = value.bytesize, value.count("\n")
         @buffer.insert(offset, value)
@@ -122,6 +125,7 @@ module Zaniah
       def delete(range)
         first, finish = checked_range(range)
         return self if first == finish
+        record_edit
         old = text
         first_line = @buffer.line_at(first)
         removed_lines = old.byteslice(first...finish).count("\n")
@@ -142,6 +146,7 @@ module Zaniah
         first, finish = checked_range(range)
         validate_text(value)
         return delete(first...finish) if value.empty?
+        record_edit
         inherited = style ? normalize_style(style) : style_at(first)
         first_line, last_line = @buffer.line_at(first), @buffer.line_at(finish)
         before_styles = @paragraph_styles.take(first_line)
@@ -187,6 +192,8 @@ module Zaniah
         first_line, last_line = @buffer.line_at(first), @buffer.line_at(finish)
         last_line = [last_line, @paragraph_styles.length - 1].min
         values = {align: align, list: list, level: level}.compact
+        return self if values.empty?
+        record_edit
         (first_line..last_line).each { |index| @paragraph_styles[index] = @paragraph_styles[index].merge(values).freeze }
         @on_change&.call(text, self)
         @cx&.window&.request_frame
@@ -208,10 +215,24 @@ module Zaniah
         head = @selection.head
         case action
         when :select_all then self.selection = TextSelection.new(0, text.bytesize)
+        when :copy then @cx.window.clipboard = text.byteslice(@selection.range)
+        when :cut
+          @cx.window.clipboard = text.byteslice(@selection.range)
+          delete(@selection.range)
+        when :paste then replace_selection(@cx.window.clipboard.to_s.encode(Encoding::UTF_8, invalid: :replace, undef: :replace))
+        when :undo, :redo then restore_edit(action)
         when :move_left then self.selection = TextSelection.new(@selection.collapsed? ? Unicode.previous_boundary(text, head) : @selection.range.begin)
         when :move_right then self.selection = TextSelection.new(@selection.collapsed? ? Unicode.next_boundary(text, head) : @selection.range.end)
         when :select_left then self.selection = TextSelection.new(@selection.anchor, Unicode.previous_boundary(text, head))
         when :select_right then self.selection = TextSelection.new(@selection.anchor, Unicode.next_boundary(text, head))
+        when :word_left, :word_right, :select_word_left, :select_word_right
+          direction = action.to_s.end_with?("left") ? :left : :right
+          target = Unicode.word_boundary(text, head, direction)
+          self.selection = action.to_s.start_with?("select") ? TextSelection.new(@selection.anchor, target) : TextSelection.new(target)
+        when :line_up, :line_down
+          self.selection = TextSelection.new(Unicode.neighbor_line_offset(text, head, action == :line_up ? -1 : 1))
+        when :document_start then self.selection = TextSelection.new(0)
+        when :document_end then self.selection = TextSelection.new(text.bytesize)
         when :line_start, :select_line_start then move_line_edge(action, :start)
         when :line_end, :select_line_end then move_line_edge(action, :end)
         when :delete_backward then delete_backward
@@ -222,6 +243,21 @@ module Zaniah
         true
       end
 
+      def validate_text_action(action)
+        case action
+        when :copy then !@selection.collapsed?
+        when :cut then @editable && !@selection.collapsed?
+        when :paste then @editable && !@buffer.composition
+        when :undo then @editable && !@buffer.composition && !@undo_states.empty?
+        when :redo then @editable && !@redo_states.empty?
+        when :delete_backward, :delete_forward, :insert_newline then @editable
+        when :select_all, :move_left, :move_right, :select_left, :select_right,
+          :word_left, :word_right, :select_word_left, :select_word_right,
+          :line_up, :line_down, :document_start, :document_end,
+          :line_start, :line_end, :select_line_start, :select_line_end then true
+        end
+      end
+
       def input(event)
         case event
         when Input::TextInput
@@ -257,6 +293,22 @@ module Zaniah
 
       private
 
+      def edit_state = [text, @spans, @paragraph_styles.dup, @selection]
+
+      def record_edit
+        @undo_states << edit_state
+        @redo_states.clear
+      end
+
+      def restore_edit(action)
+        from, to = action == :undo ? [@undo_states, @redo_states] : [@redo_states, @undo_states]
+        return false if from.empty?
+        to << edit_state
+        value, @spans, @paragraph_styles, @selection = from.pop
+        @buffer.replace(0...@buffer.bytesize, value)
+        changed
+      end
+
       def normalize_runs(value)
         text, spans = +"", []
         Array(value).each do |run|

data/lib/zaniah/ui/matcher.rb

@@ -0,0 +1,88 @@
+# frozen_string_literal: true
+
+module Zaniah
+  module UI
+    module Matcher
+      Match = Data.define(:index, :score, :ranges)
+
+      class Substring
+        def match(query, labels)
+          needle = query.to_s.downcase
+          labels.each_with_index.filter_map do |label, index|
+            label = label.to_s
+            position = label.downcase.index(needle)
+            next unless position
+            ranges = needle.empty? ? [] : [byte_range(label, position, needle.length)]
+            Match.new(index: index, score: 0.0, ranges: ranges)
+          end
+        end
+
+        private
+
+        def byte_range(label, position, length)
+          offsets = []
+          byte = 0
+          label.grapheme_clusters.each do |cluster|
+            cluster.downcase.length.times { offsets << (byte...(byte + cluster.bytesize)) }
+            byte += cluster.bytesize
+          end
+          offsets[position].begin...offsets[position + length - 1].end
+        end
+      end
+
+      class Session
+        def initialize(labels, matcher)
+          @labels, @matcher = labels, matcher
+          @query, @results = nil, nil
+        end
+
+        def results(query)
+          return @results if query == @query
+          @results = if @results && query.start_with?(@query) && @matcher.respond_to?(:refine)
+            @matcher.refine(@results, query)
+          else
+            @matcher.match(query, @labels)
+          end
+          @query = query.dup.freeze
+          @results
+        end
+      end
+
+      def self.segments(label, ranges)
+        parts = []
+        offset = 0
+        label.grapheme_clusters.each do |cluster|
+          last = offset + cluster.bytesize
+          highlighted = ranges.any? { |range| range.begin < last && range.end > offset }
+          if parts.last && parts.last[1] == highlighted
+            parts.last[0] << cluster
+          else
+            parts << [cluster.dup, highlighted]
+          end
+          offset = last
+        end
+        parts
+      end
+    end
+
+    class HighlightedButton < Button
+      def initialize(label, ranges:, **options)
+        super(label, **options)
+        @ranges = ranges
+      end
+
+      def build(cx)
+        @highlight_color = cx.theme.colors.accent
+        super.gap(0)
+      end
+
+      private
+
+      def button_content(style)
+        [Div.new.flex_row.gap(0).children(Matcher.segments(@label, @ranges).map do |part, highlighted|
+          Text.new(part, size: style[:font_size], color: highlighted ? @highlight_color : style[:foreground])
+        end)]
+      end
+    end
+  end
+end

data/lib/zaniah/ui/modal.rb

@@ -101,29 +101,140 @@ module Zaniah
     class CommandPalette < Modal
       attr_reader :query
 
-      def initialize(commands, open: false, placeholder: "Type a command…")
-        @commands, @query, @placeholder = commands.to_a, "", placeholder
+      def self.from(registry, **options)
+        commands = registry.entries.map do |name, title|
+          command = registry.command(name)
+          action = command&.name || name
+          enabled = lambda do |cx|
+            if cx&.dispatcher&.respond_to?(:available?)
+              cx.dispatcher.available?(action) == :enabled
+            elsif command&.enabled
+              command.enabled.arity.zero? ? command.enabled.call : command.enabled.call(cx)
+            else
+              true
+            end
+          end
+          callback = lambda do |_event, cx|
+            if cx.dispatcher.respond_to?(:perform)
+              cx.dispatcher.perform(action, source: :palette)
+            else
+              registry.call(name, cx)
+            end
+          end
+          [title, callback, enabled]
+        end
+        new(commands, **options)
+      end
+
+      def initialize(commands, open: false, placeholder: "Type a command…", matcher: nil)
+        @commands = commands.to_a.map { |label, callback, enabled| [label.to_s, callback, enabled] }
+        @matcher = Matcher::Session.new(@commands.map(&:first), matcher || Zaniah.configuration.matcher || Matcher::Substring.new)
+        @query, @placeholder, @selected_index = "", placeholder, 0
+        @focus_search = !!open
         super(Div.new, title: "Command palette", open: open, width: 520)
+        @focus_scope.context[:in_palette] = true
+        @focus_scope.on_action = ->(action) { palette_action(action) }
       end
 
       def build(cx)
-        field = SearchInput.new(@query, placeholder: @placeholder).on_change do |value, context|
+        field = @search = SearchInput.new(@query, placeholder: @placeholder).on_change do |value, context|
           @query = value
+          @selected_index = 0
           context.window.request_frame
         end
-        matches = @commands.select { |label, _| @query.empty? || label.to_s.downcase.include?(@query.downcase) }.first(20)
-        results = Div.new.gap(1).children(matches.map do |label, callback|
-          Button.new(label.to_s, variant: :ghost).w_full.on_click do |event, context|
-            callback&.call(event, context)
-            dismiss(event, context)
+        matches = filtered
+        unless matches[@selected_index] && enabled?(matches[@selected_index][0], cx)
+          @selected_index = matches.index { |entry, _| enabled?(entry, cx) } || 0
+        end
+        results = Div.new.gap(1).children(matches.map.with_index do |(entry, match), index|
+          label = entry[0]
+          button = match.ranges.empty? ? Button.new(label, variant: index == @selected_index ? :secondary : :ghost) :
+            HighlightedButton.new(label, ranges: match.ranges, variant: index == @selected_index ? :secondary : :ghost)
+          button.disabled(!enabled?(entry, cx)).w_full.on_click do |event, context|
+            choose(index, event, context)
           end
         end)
         @content = Div.new.gap(cx.theme.spacing[2]).child(field).child(results)
         super
       end
 
-      def tui_cells(*) = "> #{@query}\n" + @commands.map(&:first).join("\n")
-      def accessibility_node(cx) = @open && node(:dialog, label: "Command palette", states: {modal: true}, children: [Accessibility.node(role: :textbox, label: @placeholder, value: @query), Accessibility.node(role: :list, children: @commands.map { |label, _| Accessibility.node(role: :listitem, label: label) })], actions: [:dismiss])
+      def open(value = true)
+        @focus_search = true if value && !open?
+        super
+      end
+
+      def prepaint(bounds, state, cx)
+        super
+        return unless @focus_search && @open && @search&.focus_handle
+        cx.dispatcher.focus(@search.focus_handle, origin: :keyboard)
+        @focus_search = false
+      end
+
+      def tui_cells(*) = "> #{@query}\n" + filtered.map { |entry, _| entry[0] }.join("\n")
+
+      def accessibility_node(cx)
+        return unless @open
+        matches = filtered
+        active = matches[@selected_index]&.last&.index
+        items = matches.map.with_index do |(entry, match), index|
+          enabled = enabled?(entry, cx || @cx)
+          Accessibility.node(role: :listitem, id: "palette-option-#{match.index}", label: entry[0],
+            states: {selected: index == @selected_index, disabled: !enabled}, actions: enabled ? [:press] : [])
+        end
+        node(:dialog, label: "Command palette", states: {modal: true}, children: [
+          Accessibility.node(role: :searchbox, label: @placeholder, value: @query),
+          Accessibility.node(role: :list, states: {active_descendant: active && "palette-option-#{active}"}, children: items)
+        ], actions: [:dismiss])
+      end
+
+      def accessibility_action(item, action)
+        return dismiss(nil, @cx) if action == :dismiss
+        return false unless action == :press
+        index = filtered.index { |_entry, match| "palette-option-#{match.index}" == item.id }
+        index && choose(index, nil, @cx)
+      end
+
+      private
+
+      def filtered
+        @matcher.results(@query).first(20).filter_map do |match|
+          entry = @commands[match.index]
+          [entry, match] if entry
+        end
+      end
+
+      def enabled?(entry, cx)
+        callback, predicate = entry[1], entry[2]
+        callback && (!predicate || (predicate.arity.zero? ? predicate.call : predicate.call(cx)))
+      end
+
+      def palette_action(action)
+        case action
+        when :previous_option then move(-1)
+        when :next_option then move(1)
+        when :choose_option, :activate then choose(@selected_index, nil, @cx)
+        when :dismiss then dismiss(nil, @cx)
+        else false
+        end
+      end
+
+      def move(step)
+        matches = filtered
+        return false if matches.empty?
+        matches.length.times do
+          @selected_index = (@selected_index + step) % matches.length
+          break if enabled?(matches[@selected_index][0], @cx)
+        end
+        @cx&.window&.request_frame
+        true
+      end
+
+      def choose(index, event, cx)
+        entry = filtered[index]&.first
+        return false unless entry && enabled?(entry, cx)
+        entry[1].call(event, cx)
+        dismiss(event, cx)
+      end
     end
   end
 end

data/lib/zaniah/ui/rich_text_surface.rb

@@ -16,8 +16,9 @@ module Zaniah
           on_mouse_down { |event, _cx| begin_selection(event) }
           on_drag { |event, _cx| extend_selection(event) }
         end
-        focusable(context: owner.editable? ? {in_text_field: true} : {in_text: true}) do |action|
-          owner.editable? ? owner.text_action(action) : action == :select_all && select_all
+        focusable(context: {in_text_field: true, in_text: !owner.editable?, multiline: true},
+          validate: ->(action) { owner.validate_text_action(action) }) do |action|
+          owner.text_action(action)
         end
         @focus_handle.on_input = ->(event) { owner.input(event) }
       end
@@ -291,12 +292,6 @@ module Zaniah
         range = Unicode.word_range_at(@owner.text, [offset, @owner.text.bytesize].min)
         TextSelection.new(range.begin, range.end)
       end
-
-      def select_all
-        @owner.selection = TextSelection.new(0, @owner.text.bytesize)
-        @owner.instance_variable_get(:@cx)&.window&.request_frame
-        true
-      end
     end
   end
 end

data/lib/zaniah/ui.rb

@@ -5,6 +5,7 @@ require_relative "ui/variants"
 require_relative "ui/component"
 require_relative "ui/primitives"
 require_relative "ui/controls"
+require_relative "ui/matcher"
 require_relative "ui/overlays"
 require_relative "ui/text_inputs"
 require_relative "ui/choice_fields"

data/lib/zaniah/unicode.rb

@@ -34,6 +34,34 @@ module Zaniah
       starts[first]...(starts[last] || text.bytesize)
     end
 
+    def self.word_boundary(text, offset, direction)
+      raise ArgumentError, "direction must be left or right" unless %i[left right].include?(direction)
+      if direction == :left
+        return 0 if offset.zero?
+        cursor = previous_boundary(text, offset)
+        while cursor.positive? && text.byteslice(cursor...next_boundary(text, cursor)).match?(/\A\s+\z/)
+          cursor = previous_boundary(text, cursor)
+        end
+        word_range_at(text, cursor).begin
+      else
+        return text.bytesize if offset >= text.bytesize
+        cursor = word_range_at(text, offset).end
+        while cursor < text.bytesize && text.byteslice(cursor...next_boundary(text, cursor)).match?(/\A\s+\z/)
+          cursor = next_boundary(text, cursor)
+        end
+        cursor
+      end
+    end
+
+    def self.neighbor_line_offset(text, offset, direction)
+      lines = text.split("\n", -1)
+      line = text.byteslice(0...offset).count("\n")
+      target = (line + direction).clamp(0, lines.length - 1)
+      start = lines.take(line).sum { |value| value.bytesize + 1 }
+      column = text.byteslice(start...offset).grapheme_clusters.length
+      lines.take(target).sum { |value| value.bytesize + 1 } + lines[target].grapheme_clusters.take(column).sum(&:bytesize)
+    end
+
     def self.width(text, ambiguous: 1)
       require "rbconfig"
       require "unicode/display_width"

data/lib/zaniah/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Zaniah
-  VERSION = "0.6.4"
+  VERSION = "0.7.0"
 end

data/lib/zaniah.rb

@@ -39,6 +39,7 @@ require_relative "zaniah/process_pool"
 require_relative "zaniah/input"
 require_relative "zaniah/drag_drop"
 require_relative "zaniah/element"
+require_relative "zaniah/inspection"
 require_relative "zaniah/describe"
 Zaniah.autoload(:SVG, File.expand_path("zaniah/svg", __dir__))
 require_relative "zaniah/scroll_state"