tuile 0.15.0 → 0.16.0

data/lib/tuile/component/menu_bar.rb

@@ -42,7 +42,7 @@ module Tuile
     #
     # {Item} handles are minted by {#add_item} and nest via the *same* method, so
     # depth is unlimited. There is no removal, no reordering and no dynamic
-    # rebuilding: a menu is built once, at construction. See `DECISIONS.md`
+    # rebuilding: a menu is built once, at construction. See `design/decisions.md`
     # `D_menu_bar`.
     #
     # == Sizing
@@ -242,7 +242,7 @@ module Tuile
       #
       # Both the highlight and the click hit test use it, so a click on the blank
       # tail — or on a lower row, when the rect is taller than one — opens
-      # nothing. It still *focuses*: {Component#handle_mouse}'s click-to-focus is
+      # nothing. It still *focuses*: {Mouse::Router}'s click-to-focus is
       # ungated by geometry.
       # @return [Size]
       def extent
@@ -275,7 +275,7 @@ module Tuile
       # panels on the pane — they are the {ScreenPane}'s children, not the bar's,
       # so nothing else would take them down.
       # @return [void]
-      def on_detached
+      def handle_detached
         super
         @cascade.close
       end
@@ -288,11 +288,11 @@ module Tuile
       # submenu — and both step to the sibling menu.
       # @param key [String]
       # @return [Boolean]
-      def handle_key(key)
+      def handle_key?(key)
         # Ahead of the cascade: an open one swallows every printable it doesn't
         # recognize, so a letter would never reach the strip otherwise.
-        return true if handle_mnemonic(key)
-        return true if @cascade.handle_key(key)
+        return true if handle_mnemonic?(key)
+        return true if @cascade.handle_key?(key)
 
         if @cascade.open?
           case key
@@ -310,17 +310,16 @@ module Tuile
         end
       end
 
-      # Opens the menu under a left click, or closes it when it is already the
-      # open one; `super` runs first, so a click anywhere in {#rect} still
-      # focuses.
-      # @param event [MouseEvent]
-      # @return [void]
-      def handle_mouse(event)
-        super
-        return unless event.button == :left
+      # Opens the menu under a left press, or closes it when it is already the
+      # open one; a press on the strip's padding claims the press and does
+      # nothing else.
+      # @param event [Mouse::DownEvent]
+      # @return [Boolean]
+      def handle_mouse_down?(event)
+        return false unless event.button == :left
 
         index = index_at(event.point)
-        return if index.nil?
+        return true if index.nil?
 
         if @cascade.open? && index == @highlighted_index
           @cascade.close
@@ -328,6 +327,7 @@ module Tuile
           self.highlight = index
           open_highlighted
         end
+        true
       end
 
       # @return [void]
@@ -372,7 +372,7 @@ module Tuile
       # hook is the whole geometry story; {Component#rect=} invalidates for us,
       # and {#rect=} closes the cascade rather than re-anchoring it.
       # @return [void]
-      def on_width_changed
+      def handle_width_changed
         super
         adjust_left_column
       end
@@ -512,11 +512,11 @@ module Tuile
       # not offered to any other level.
       # @param key [String]
       # @return [Boolean] whether a mnemonic claimed the key.
-      def handle_mnemonic(key)
+      def handle_mnemonic?(key)
         return false unless Keys.printable?(key)
 
         down = key.downcase
-        return @cascade.handle_mnemonic(down) if @cascade.open?
+        return @cascade.handle_mnemonic?(down) if @cascade.open?
 
         index = items.index { |item| item.mnemonic == down }
         return false if index.nil?

data/lib/tuile/component/notification.rb

@@ -28,20 +28,20 @@ module Tuile
     # (floor {MIN_CAP_WIDTH}) and {HEIGHT_FRACTION} tall, and **grows but never
     # shrinks** while it lives; a long message wraps to {MAX_ROWS_PER_MESSAGE}
     # rows and is then ellipsized, and entries past the height cap wait unpainted.
-    # `DECISIONS.md` `D_notification` has why each of those is what it is.
+    # `design/decisions.md` `D_notification` has why each of those is what it is.
     #
     # Three things it deliberately doesn't do:
     #
     # - **Take focus, or receive keys.** An {Overlay} sits off the
-    #   key-dispatch scope ({ScreenPane#handle_key}), so no key arrives here at
-    #   all. A left click *on the box* dismisses ({#handle_mouse}); an app
+    #   key-dispatch scope ({ScreenPane#handle_key?}), so no key arrives here at
+    #   all. A left click *on the box* dismisses ({#handle_mouse_down?}); an app
     #   wanting a key registers a global shortcut and calls {Overlay#close}. A
     #   click *elsewhere* does not — this is the one overlay with
     #   {Overlay#close_on_outside_click?} false, since a toast is timed and an
     #   unrelated click is not about it.
     # - **Follow a theme flip.** A `Theme::Ref` `color:` is resolved once, when
     #   the message is added — a toast lives seconds, so there is no
-    #   {Component#on_theme_changed} rebuild.
+    #   {Component#handle_theme_changed} rebuild.
     # - **Take a size.** An {Overlay} has no declared box; the messages decide
     #   this one's, in {#reposition}.
     class Notification < Overlay
@@ -122,7 +122,7 @@ module Tuile
         @messages = []
         @high_water = 0
         @ticker = nil
-        @view = TextView.new
+        @view = View.new
         @window = Window.new
         @window.content = @view
         super(content: @window, close_on_outside_click: false)
@@ -179,27 +179,41 @@ module Tuile
         self.rect = Rect.new([screen.size.width - width, 0].max, 0, width, height)
       end
 
-      # A left click dismisses the whole box, every message with it. Other buttons
-      # are consumed and inert — including the scroll wheel, which would otherwise
-      # nuke the box on a stray spin.
-      #
-      # Deliberately *replaces* rather than augments: neither `super` nor
-      # {HasContent#handle_mouse} may run, since both end at a
-      # `screen.focused = …` inside this subtree (see {Overlay#focusable?}).
-      # @param event [MouseEvent]
-      # @return [void]
-      def handle_mouse(event)
+      # A left press dismisses the whole box, every message with it. Every other
+      # press is claimed and inert, so nothing beneath the toast acts on it.
+      # @param event [Mouse::DownEvent]
+      # @return [Boolean]
+      def handle_mouse_down?(event)
         close if event.button == :left
+        true
+      end
+
+      # Claimed and inert: a stray wheel spin over the toast must neither nuke it
+      # nor reach whatever it covers.
+      # @param _event [Mouse::ScrollEvent]
+      # @return [Boolean]
+      def handle_mouse_scroll?(_event) = true
+
+      # The message rows, minus the wheel — the one thing a plain
+      # {Component::TextView} would add here. On a short terminal the queued
+      # messages are taller than the box, and the box is unfocusable, so
+      # scrolling them would be a capability the keyboard cannot reach
+      # (`D_mouse`); they are meant to *wait* until the ticker retires the ones
+      # above.
+      class View < TextView
+        # @param _event [Mouse::ScrollEvent]
+        # @return [Boolean] true — claimed on the box's behalf, and inert.
+        def handle_mouse_scroll?(_event) = true
       end
 
       # @return [void]
-      def on_attached
+      def handle_attached
         super
         sync_ticker
       end
 
       # @return [void]
-      def on_detached
+      def handle_detached
         super
         sync_ticker
       end
@@ -218,7 +232,7 @@ module Tuile
       # Syncs the retirement clock from the invariant "something to retire, and on
       # screen" — the sole writer of `@ticker`. Four sites change whether it is
       # wanted (append, a retirement that empties the queue, {#close}, detach),
-      # which is the 2×2 a start-in-{#on_attached} / cancel-in-{#on_detached} pair
+      # which is the 2×2 a start-in-{#handle_attached} / cancel-in-{#handle_detached} pair
       # gets half wrong. The early return is also what keeps an append from
       # *restarting* the clock and extending the oldest message's life.
       # @return [void]

data/lib/tuile/component/overlay.rb

@@ -23,7 +23,7 @@ module Tuile
     # **{#focusable?} and {#modal?} move together — flip both or neither.** The
     # defaults here are inert (`false`, `false`): a bare overlay floats without
     # disturbing focus or key dispatch. {Component::Popup} flips both. What must
-    # not appear is a *focusable non-modal* overlay: {ScreenPane#handle_key}
+    # not appear is a *focusable non-modal* overlay: {ScreenPane#handle_key?}
     # scopes delivery to the topmost modal popup or else the tiled content, so
     # such an overlay would hold focus outside the key scope, where delivery
     # reaches nobody and *every* keystroke goes dead until Tab recovers. A
@@ -85,9 +85,9 @@ module Tuile
       end
 
       # Whether a left click outside this overlay closes it (default true). The
-      # pane does the closing — {ScreenPane#handle_mouse} snapshots the open
-      # overlays *before* routing the click and closes the dismissable ones
-      # *after*, so a widget that toggles its own overlay from a click on its
+      # pane does the closing — {ScreenPane#dismissing_popups_outside} snapshots
+      # the open overlays *before* the press is routed and closes the
+      # dismissable ones *after*, so a widget that toggles its own overlay from a click on its
       # face (a {Component::Select}, a {Component::MenuBar} title) still toggles
       # correctly: the delivered click closes the overlay and the dismissal then
       # no-ops on it, rather than closing and reopening it. Only `:left`
@@ -130,12 +130,12 @@ module Tuile
       # A callback taking no arguments, fired once this overlay has left the
       # screen — **however it left**: {#close}, a direct {Screen#remove_popup},
       # an outside click, or teardown via {Screen#close}. That unconditionality
-      # is the point, so it hangs off {#on_detached} rather than {#close}; a
+      # is the point, so it hangs off {#handle_detached} rather than {#close}; a
       # driver keeping its own record of open overlays reconciles it here and
       # cannot drift ({Component::MenuBar::Cascade} is the worked example).
       #
       # It fires *after* the overlay is detached, so {#open?} is already false
-      # and the usual {Component#on_detached} caveats apply: release state, don't
+      # and the usual {Component#handle_detached} caveats apply: release state, don't
       # inspect the tree, keep it trivial (it may run while the pane is mid-way
       # through closing a batch of overlays, and a raise propagates).
       # @return [Proc, nil]
@@ -161,7 +161,7 @@ module Tuile
       #   overlay = Component::Overlay.new(content: label).open   # construct and mount
       #
       # There is deliberately no class-level `Overlay.open` factory — see
-      # `DECISIONS.md` `D_popup_open`; returning `self` is what keeps the
+      # `design/decisions.md` `D_popup_open`; returning `self` is what keeps the
       # one-liner above available without one.
       # @return [self]
       def open
@@ -191,7 +191,8 @@ module Tuile
       # Fires {#on_close}. A subclass overriding this **must** call `super`, or
       # the overlay's driver never hears that it closed.
       # @return [void]
-      def on_detached
+      def handle_detached
+        super
         @on_close&.call
       end
 

data/lib/tuile/component/picker_window.rb

@@ -3,11 +3,26 @@
 module Tuile
   class Component
     # A {Window} that lists options identified by single keyboard keys, asks
-    # the user to pick one, and fires a callback with the picked key.
+    # the user to pick one, and fires a callback with the picked key. Each row
+    # is `"<key> <caption>"`:
+    #
+    #   PickerWindow.open("Sort by", [%w[n name], %w[s size]]) { sort_by(_1) }
+    #
+    #   ┌Sort by───────┐
+    #   │n name        │
+    #   │s size        │
+    #   └──────────────┘
     #
     # Usable tiled (just add to a {Layout} and read picks via the block) or
     # as a popup via {.open}, which wraps it in a {Popup} that closes itself
     # after a pick. ESC / `q` close without firing the callback.
+    #
+    # Captions paint in the terminal's own foreground. To color them, hand in
+    # {StyledString} captions — the picker styles nothing itself, so an app's
+    # own token applies per option:
+    #
+    #   PickerWindow.open("File", [["o", StyledString.plain("Open")],
+    #                              ["d", theme.fg(:danger, "Delete")]]) { … }
     class PickerWindow < Window
       # Scrolls the window when more items.
       # @return [Integer]
@@ -18,26 +33,30 @@ module Tuile
       # @!attribute [r] key
       #   @return [String] the keyboard key that picks this option.
       # @!attribute [r] caption
-      #   @return [String] the option caption.
+      #   @return [StyledString] the option caption, coerced from whatever the
+      #     constructor was handed.
       class Option < Data.define(:key, :caption)
       end
 
       # @param caption [String] the window caption.
-      # @param options [Array<Array(String, String)>] pairs of keyboard key and
-      #   option caption. No Rainbow formatting must be used.
+      # @param options [Array<Array(String, StyledString)>] pairs of
+      #   keyboard key and option caption. A caption goes through
+      #   {StyledString.parse}, so a plain String, an ANSI-coded one (what
+      #   {Theme#fg} returns) and a {StyledString} are all accepted.
       # @yield [key] called with the option key once one is selected by the
       #   user. Not called if the picker is dismissed without picking.
       # @yieldparam key [String] the picked option key.
       # @yieldreturn [void]
+      # @raise [ArgumentError] when `block` is missing or `options` is empty.
       def initialize(caption, options, &block)
         raise ArgumentError, "block required" unless block
         raise ArgumentError, "options must not be empty" if options.empty?
 
         super(caption)
-        @options = options.map { Option.new(_1[0], _1[1]) }
+        @options = options.map { Option.new(_1[0], StyledString.parse(_1[1])) }
         @block = block
         list = Component::List.new
-        list.renderer = ->(option) { "#{option.key} #{screen.theme.hint(option.caption)}" }
+        list.renderer = ->(option) { StyledString.plain("#{option.key} ") + option.caption }
         list.items = @options
         list.cursor = Component::List::Cursor.new
         list.on_item_chosen = ->(_index, option) { select_option(option.key) }
@@ -57,7 +76,7 @@ module Tuile
       # option's `key` picks that option.
       # @param key [String]
       # @return [Boolean]
-      def handle_key(key)
+      def handle_key?(key)
         if @options.any? { _1.key == key }
           select_option(key)
           true
@@ -69,7 +88,7 @@ module Tuile
       # Opens a picker as a popup. Picking an option fires `block`, then
       # closes the popup; ESC / `q` close without firing `block`.
       # @param caption [String]
-      # @param options [Array<Array(String, String)>]
+      # @param options [Array<Array(String, StyledString)>]
       # @yield [key]
       # @yieldparam key [String]
       # @yieldreturn [void]

data/lib/tuile/component/popup.rb

@@ -28,7 +28,7 @@ module Tuile
     #
     # `q` and ESC close the popup — handled here, at the top of the popup's own
     # subtree, so the key only arrives after every component on the focus chain
-    # declined it (see {ScreenPane#handle_key}). That's why typing `q` into a
+    # declined it (see {ScreenPane#handle_key?}). That's why typing `q` into a
     # nested {Component::TextField} doesn't dismiss the popup: the field consumes
     # it first.
     #
@@ -107,7 +107,7 @@ module Tuile
       # focused content after that content declined to handle it.
       # @param key [String]
       # @return [Boolean] true if the key was handled.
-      def handle_key(key)
+      def handle_key?(key)
         if [Keys::ESC, "q"].include?(key)
           close
           true

data/lib/tuile/component/progress_bar.rb

@@ -38,7 +38,7 @@ module Tuile
     # The `█`/`░` pair is the same one {VerticalScrollBar} uses — East-Asian
     # Ambiguous and Neutral respectively, so under an ambiguous-as-wide terminal
     # the rendered length would vary with the fill level. Shipped anyway, per
-    # `DECISIONS.md` `D_ambiguous_width`: a bar that rhymes with the scrollbar
+    # `design/decisions.md` `D_ambiguous_width`: a bar that rhymes with the scrollbar
     # beats a third convention, and if that bet is ever reversed both swap
     # together.
     class ProgressBar < Component
@@ -148,7 +148,7 @@ module Tuile
 
       # Sets the color of both glyphs, live-resolved at paint time when given a
       # {Theme::Ref} (so it follows a {Screen#theme=} with no
-      # {Component#on_theme_changed} hook).
+      # {Component#handle_theme_changed} hook).
       #
       #   bar.bar_color = Color::GREEN
       #   bar.bar_color = Theme.ref(:brand_ok)   # an app #custom token
@@ -192,10 +192,16 @@ module Tuile
       end
 
       # @return [void]
-      def on_attached = sync_ticker
+      def handle_attached
+        super
+        sync_ticker
+      end
 
       # @return [void]
-      def on_detached = sync_ticker
+      def handle_detached
+        super
+        sync_ticker
+      end
 
       # Paints the bar on the first row of {#rect} and blanks the rest.
       #

data/lib/tuile/component/radio_group.rb

@@ -86,9 +86,10 @@ module Tuile
 
       # The composed {List}: an app may *tune* it — its scrollbar, its cursor,
       # `show_cursor_when_inactive` — but never replace it, since this group's
-      # renderer and selection are wired into this one. Those knobs are {List}
-      # concepts rather than group concepts, which is why they are reached here
-      # instead of forwarded (`DECISIONS.md` `D_wrapping_field`).
+      # renderer and selection are wired into this one (`design/decisions.md`
+      # `D_has_content`). Those knobs are {List} concepts rather than group
+      # concepts, which is why they are reached here instead of forwarded
+      # (`D_wrapping_field`).
       # @return [List]
       attr_reader :list
 
@@ -100,7 +101,7 @@ module Tuile
       end
 
       # @return [void]
-      def on_focus
+      def handle_focus
         super
         # The list is what the arrows drive, so it takes the focus this group
         # was given; the group itself claims only Space.
@@ -155,7 +156,7 @@ module Tuile
       # neither of us wants bubbles on to an ancestor.
       # @param key [String]
       # @return [Boolean]
-      def handle_key(key)
+      def handle_key?(key)
         return false unless key == " "
 
         select_at(list.cursor.position)

data/lib/tuile/component/select.rb

@@ -42,7 +42,7 @@ module Tuile
     # Home/End are declined too, so they stay available app-wide.
     #
     # There is no type-ahead: a hidden prefix buffer *is* the ComboBox query with
-    # the feedback removed (`DECISIONS.md` `D_select`). Which is also why labels
+    # the feedback removed (`design/decisions.md` `D_select`). Which is also why labels
     # need no prefix-disambiguation.
     #
     # == Implementation details
@@ -138,7 +138,7 @@ module Tuile
       # is left unhandled so it bubbles to an ancestor.
       # @param key [String]
       # @return [Boolean]
-      def handle_key(key)
+      def handle_key?(key)
         if @overlay.open?
           return true if @overlay.move(key)
 
@@ -159,22 +159,21 @@ module Tuile
       # The one row this Select paints — the full width, at the top of {#rect}.
       # A single-slot container ({Component::Window}, {Component::Popup}) hands
       # its content the whole inner rect, so a Select is routinely assigned more
-      # height than it uses; {#repaint} clears that tail, {#handle_mouse} refuses
-      # clicks in it, and the dropdown hangs under this rather than under the
+      # height than it uses; {#repaint} clears that tail, a press in it never reaches
+      # {#handle_mouse_down?}, and the dropdown hangs under this rather than under the
       # unused space.
       # @return [Size]
       def extent = Size.new(rect.width, 1)
 
-      # Toggles the dropdown on a left click anywhere in {#extent} — a field's
-      # affordance is its whole row, as the well advertises; `super` runs first,
-      # so the click also focuses.
-      # @param event [MouseEvent]
-      # @return [void]
-      def handle_mouse(event)
-        super
-        return unless event.button == :left && extent_rect.contains?(event.point)
+      # Toggles the dropdown on a left press anywhere in {#extent} — a field's
+      # affordance is its whole row, as the well advertises.
+      # @param event [Mouse::DownEvent]
+      # @return [Boolean]
+      def handle_mouse_down?(event)
+        return false unless event.button == :left
 
         @overlay.open? ? close_menu : open_menu
+        true
       end
 
       # @return [void]

data/lib/tuile/component/slot.rb

@@ -23,7 +23,7 @@ module Tuile
     # (what {Window} does with an absent footer); never detach it.
     #
     # Transparent to input: not {Component#focusable?},
-    # {Component#handle_mouse} descends through it, and a departing occupant's
+    # the mouse routes straight through it, and a departing occupant's
     # focus repair is handed to the container.
     class Slot < Component
       include Component::HasContent
@@ -40,8 +40,8 @@ module Tuile
       # nothing to bubble from.
       # @param child [Component] the just-detached occupant.
       # @return [void]
-      def on_child_removed(child)
-        parent&.on_child_removed(child)
+      def handle_child_removed(child)
+        parent&.handle_child_removed(child)
       end
 
       protected

data/lib/tuile/component/tab_sheet.rb

@@ -26,11 +26,11 @@ module Tuile
     # designing around:
     #
     # - A hidden pane is invisible to *everything*: the Tab cycle, focus
-    #   cascades, repaint, the cursor, `on_tree` walks. No gates anywhere.
+    #   cascades, repaint, the cursor, `walk_tree` walks. No gates anywhere.
     # - Its state survives, because state is ivars — scroll position, caret,
     #   list cursor, text are all exactly as the user left them, and mutating a
     #   hidden pane is safe (`invalidate` while detached is a silent no-op).
-    # - {Component#on_detached} / {Component#on_attached} fire on every switch,
+    # - {Component#handle_detached} / {Component#handle_attached} fire on every switch,
     #   so a pane holding a mounted-lifetime resource — a {Component::ProgressBar}'s
     #   ticker — releases it while hidden and re-acquires it on return. A pane
     #   that must keep something alive while hidden can't; that something
@@ -40,7 +40,7 @@ module Tuile
     # `children` is `[strip, pane]`, the strip pinned at index 0, so pre-order
     # traversal gives the strip-then-pane Tab order for free. The swap follows
     # the slot-swap recipe {Component#detach_child} documents — detach, rewire,
-    # `on_child_removed` last, so the focus repair sees the new occupant.
+    # `handle_child_removed` last, so the focus repair sees the new occupant.
     #
     # Panes live in an identity-keyed `Tab => Component` map here rather than in
     # a slot on {Tabs::Tab}: the strip's tab array stays the sole ordering
@@ -169,7 +169,7 @@ module Tuile
       # Sends focus to the strip: a sheet is a container, and the strip is where
       # a tab switch is driven from. The pane is a Tab press away.
       # @return [void]
-      def on_focus
+      def handle_focus
         super
         screen.focused = @strip
       end
@@ -179,7 +179,7 @@ module Tuile
       # action was a tab switch.
       # @param child [Component]
       # @return [void]
-      def on_child_removed(child)
+      def handle_child_removed(child)
         super
         screen.focused = @strip if attached? && screen.focused.equal?(self)
       end
@@ -205,7 +205,7 @@ module Tuile
           layout_pane
         end
         invalidate
-        on_child_removed(old) unless old.nil?
+        handle_child_removed(old) unless old.nil?
       end
 
       # Drops entries whose tab is gone. {Tabs::Tab#remove} takes a tab off the

data/lib/tuile/component/tabs.rb

@@ -29,7 +29,7 @@ module Tuile
     #
     # {Tab} handles are minted by {#add_tab} and owned by the strip. There is no
     # `items=`: a tab is identity plus its own state, so the set grows and
-    # shrinks one tab at a time. See book ch7 and `DECISIONS.md` `D_tabs`.
+    # shrinks one tab at a time. See book ch7 and `design/decisions.md` `D_tabs`.
     #
     # == Sizing
     # Assign a {#rect} (typically from the surrounding {Layout}). One wider than
@@ -275,7 +275,7 @@ module Tuile
       #
       # Both the focus highlight and the click hit test use it, so a click on the
       # blank tail — or on a lower row, when the rect is taller than one —
-      # selects nothing. It still *focuses*: {Component#handle_mouse}'s
+      # selects nothing. It still *focuses*: {Mouse::Router}'s
       # click-to-focus is ungated by geometry.
       # @return [Size]
       def extent
@@ -291,7 +291,7 @@ module Tuile
       # bubbles to an ancestor; an empty strip handles nothing at all.
       # @param key [String]
       # @return [Boolean]
-      def handle_key(key)
+      def handle_key?(key)
         case key
         when Keys::LEFT_ARROW then select_previous
         when Keys::RIGHT_ARROW then select_next
@@ -299,16 +299,16 @@ module Tuile
         end
       end
 
-      # Selects the tab under a left click; `super` runs first, so a click
-      # anywhere in {#rect} still focuses.
-      # @param event [MouseEvent]
-      # @return [void]
-      def handle_mouse(event)
-        super
-        return unless event.button == :left
+      # Selects the tab under a left press; a press between tabs selects
+      # nothing and still claims the strip.
+      # @param event [Mouse::DownEvent]
+      # @return [Boolean]
+      def handle_mouse_down?(event)
+        return false unless event.button == :left
 
         tab = tab_at(event.point)
         self.selected = tab if tab
+        true
       end
 
       # @return [void]
@@ -339,7 +339,7 @@ module Tuile
       # The rect's *width* is the only part of it the offset depends on, so this
       # hook is the whole geometry story; {Component#rect=} invalidates for us.
       # @return [void]
-      def on_width_changed
+      def handle_width_changed
         super
         adjust_left_column
       end

data/lib/tuile/component/text_area.rb

@@ -31,7 +31,7 @@ module Tuile
     #   class PromptArea < Component::TextArea
     #     protected
     #
-    #     def handle_text_input_key(key)
+    #     def handle_text_input_key?(key)
     #       return recall_previous if key == Keys::UP_ARROW && caret_row.zero?
     #       return recall_next if key == Keys::DOWN_ARROW && caret_row == row_count - 1
     #
@@ -87,11 +87,10 @@ module Tuile
         Point.new(rect.left + col.clamp(0, rect.width - 1), rect.top + row_in_viewport)
       end
 
-      # @param event [MouseEvent]
-      # @return [void]
-      def handle_mouse(event)
-        super
-        return unless event.button == :left && rect.contains?(event.point)
+      # @param event [Mouse::DownEvent]
+      # @return [Boolean]
+      def handle_mouse_down?(event)
+        return false unless event.button == :left
 
         target_row = (event.y - rect.top) + @scroll_top_row
         self.caret = if target_row >= wrap.row_count
@@ -99,6 +98,7 @@ module Tuile
                      else
                        wrap.index_at(target_row, event.x - rect.left)
                      end
+        true
       end
 
       # @return [void]
@@ -114,13 +114,15 @@ module Tuile
       protected
 
       # @return [void]
-      def on_text_mutated
+      def handle_text_mutated
+        super
         @wrap = nil
         adjust_scroll_top_row
       end
 
       # @return [void]
-      def on_caret_mutated
+      def handle_caret_mutated
+        super
         adjust_scroll_top_row
       end
 
@@ -128,7 +130,7 @@ module Tuile
       # the `\n` line — so CTRL+U kills back to exactly where HOME would go.
       # @param key [String]
       # @return [Boolean]
-      def handle_text_input_key(key)
+      def handle_text_input_key?(key)
         case key
         when Keys::UP_ARROW then move_caret_vertical(-1)
         when Keys::DOWN_ARROW then move_caret_vertical(1)
@@ -147,7 +149,7 @@ module Tuile
       end
 
       # @return [void]
-      def on_width_changed
+      def handle_width_changed
         super
         @wrap = nil
         adjust_scroll_top_row