dopairb 0.1.0 → 0.4.0

data/lib/dopairb/input_fx.rb

@@ -6,7 +6,13 @@ module Dopairb
   class InputFx
     Layout = Struct.new(:cursor_x, :cursor_row, :row_end_x, :last_row, :screen_width, :room_below, keyword_init: true)
 
-    STRIP_ROWS = 2
+    STRIP_ROWS = 3
+    # Typing streaks at powers of two get a big name.
+    STREAK_NAMES = {
+      8 => ["8-BIT", "RUSH!"], 16 => ["16-BIT", "COMBO!"], 32 => ["32-BIT", "BLAZE!!"], 64 => ["64-BIT", "OVERDRIVE!!"],
+      128 => ["128-BIT", "HYPER MODE!!"], 256 => ["0x100", "OVERFLOW!!!"], 512 => ["2^9", "GODSPEED!!!"],
+      1024 => ["1KiB", "TYPING LEGEND!!!"],
+    }.freeze
     OPEN = %i[PARENTHESIS_LEFT PARENTHESIS_LEFT_PARENTHESES BRACKET_LEFT BRACKET_LEFT_ARRAY BRACE_LEFT LAMBDA_BEGIN EMBEXPR_BEGIN].freeze
     CLOSE = %i[PARENTHESIS_RIGHT BRACKET_RIGHT BRACE_RIGHT EMBEXPR_END].freeze
     PAIRS = { "(" => ")", "[" => "]", "{" => "}", '#{' => "}" }.freeze
@@ -22,11 +28,13 @@ module Dopairb
 
     Highlight = Struct.new(:from, :to, :born, :life, :kind)
     Popup = Struct.new(:text, :x, :born, :life, :palette, :rise, :prio)
+    Streak = Struct.new(:n, :x, :born, :life)
 
     attr_reader :game
 
-    def initialize(config, game, clock: -> { Process.clock_gettime(Process::CLOCK_MONOTONIC) }, rng: Random.new)
+    def initialize(config, game, clock: -> { Process.clock_gettime(Process::CLOCK_MONOTONIC) }, rng: Random.new, sound: nil)
       @config = config
+      @sound = sound || ->(name) { Sound.play(name) if @config.sound == :sfx && Sound.fast? }
       @game = game
       @clock = clock
       @rng = rng
@@ -106,6 +114,7 @@ module Dopairb
       return true if @popups.any? { |p| t - p.born < p.life }
       return true if @inline && t - @inline.born < @inline.life + 0.1
       return true if @inserts.any? { |it| t - it < 0.4 }
+      return true if @streak && t - @streak.born < @streak.life + 0.1
       return true if hl_dirty?(t)
       hud = @config.hud ? hud_key(t) : nil
       if hud != @last_hud
@@ -125,6 +134,7 @@ module Dopairb
 
     def reset_line
       @inline = nil
+      @streak = nil
       @highlights.clear
       @inserts.clear
       @popups.clear
@@ -145,6 +155,11 @@ module Dopairb
       gauge_on = Color.mix([80, 110, 170], Color.ramp(Color::FIRE, 0.35), heat)
       c = Canvas.new(Term.str_width(text), 1)
       c.put(0, 0, text, fg, bg: bg, bold: heat > 0.5)
+      if (f = text.index("FEVER!"))
+        "FEVER!".each_char.with_index do |ch, i|
+          c.put(f + i, 0, ch, [20, 10, 30], bg: Color.rainbow(i / 6.0 - t * 2), bold: true)
+        end
+      end
       g = text.index("[")
       if g
         cells = 8
@@ -157,7 +172,7 @@ module Dopairb
     end
 
     def hud_key(t)
-      [hud_text(200, t), (@game.heat(t) * 12).round, (@game.charge / Game::CHARGE_MAX * 8).round]
+      [hud_text(200, t), (@game.heat(t) * 12).round, (@game.charge / Game::CHARGE_MAX * 8).round, @game.fever? ? (t * 15).to_i : 0]
     end
 
     def trail_render(lay, t = now)
@@ -203,9 +218,14 @@ module Dopairb
       return nil unless lively?
       @popups.reject! { |p| t - p.born > p.life }
       @parts.prune(t)
-      return nil if @popups.empty? && @parts.empty?
+      @streak = nil if @streak && t - @streak.born > @streak.life
+      return nil if @popups.empty? && @parts.empty? && @streak.nil?
       w = lay.screen_width - 1
       c = Canvas.new(w, STRIP_ROWS)
+      if @streak && draw_streak(c, w, t)
+        @parts.draw(c, t)
+        return c.render(depth)
+      end
       @parts.draw(c, t)
       @popups.each do |p|
         age = (t - p.born) / p.life
@@ -254,9 +274,11 @@ module Dopairb
       score = Fx.number_with_commas(@game.score)
       mult = @game.multiplier(t)
       m = mult > 1.04 ? format(" x%.1f", mult) : ""
-      full = " COMBO #{format('%02d', @game.combo)}  SCORE #{score}  [#{' ' * 8}]#{m} "
+      fever = @game.fever? ? " FEVER!" : ""
+      lv = @game.leveling? ? " LV#{@game.level} " : ""
+      full = "#{fever}#{lv} COMBO #{format('%02d', @game.combo)}  SCORE #{score}  [#{' ' * 8}]#{m} "
       return full if Term.str_width(full) <= space
-      short = " C#{format('%02d', @game.combo)} #{score} "
+      short = "#{fever} C#{format('%02d', @game.combo)} #{score} "
       Term.str_width(short) <= space ? short : nil
     end
 
@@ -304,16 +326,23 @@ module Dopairb
         @highlights << Highlight.new(off, off + ch.bytesize, t, 0.18, :flash)
       end
       spark(cur_x, t, full? ? 4 : 1)
+      sfx(@game.typing_combo >= 20 ? :key_hot : :key)
       if resumed == :resume
+        sfx(:charge)
         pop("CHARGE!", cur_x - 3, t, Color::FIRE, life: 0.7, rise: true, prio: 3)
         @parts.burst(cur_x, 0.0, 26, at: t, speed: 34, life: 0.55, palette: Color::FIRE, gravity: 10) if full?
       elsif recovering
         pop("RECOVERY", cur_x - 4, t, Color::TOXIC, life: 0.55)
       end
-      streak = @game.typing_combo
-      if [20, 50, 100, 200].include?(streak)
-        pop("STREAK #{streak}!", cur_x - 5, t, streak >= 100 ? Color::NEON : Color::GOLD, life: 0.9, rise: true, prio: 3)
-        @parts.burst(cur_x, 0.5, 30, at: t, speed: 40, life: 0.6, palette: Color::GOLD, gravity: 12) if full?
+      if Array === resumed && resumed[0] == :streak
+        n = resumed[1]
+        sfx(:bits)
+        if full?
+          @streak = Streak.new(n, cur_x, t, 1.3 * @config.duration)
+          @parts.burst(cur_x, 1.0, 40, at: t, speed: 46, life: 0.6, palette: n >= 64 ? Color::NEON : Color::GOLD, gravity: 12)
+        else
+          pop("#{STREAK_NAMES[n]&.join(' ') || "STREAK #{n}"}", cur_x - 5, t, Color::GOLD, life: 0.9, rise: true, prio: 3)
+        end
       end
       syntax_moment(ch, off, new, cur_x, t)
     end
@@ -328,6 +357,7 @@ module Dopairb
           @highlights << Highlight.new(off, off + 1, t, 0.6, :pair)
           @highlights.reject! { |h| h.kind == :flash }
           pop("NICE!", cur_x - 3, t, Color::GOLD, life: 0.6, rise: true, prio: 2)
+          sfx(:nice)
           @parts.burst(cur_x - 1, 0.0, 12, at: t, speed: 26, life: 0.4, palette: Color::GOLD, gravity: 8) if full?
         elsif (range = match_string(tokens, off))
           @game.key(:string)
@@ -340,6 +370,7 @@ module Dopairb
           @game.key(:block)
           @highlights << Highlight.new(start, off + 1, t, 0.55, :range)
           pop("SEALED!", cur_x - 4, t, Color::NEON, life: 0.7, rise: true, prio: 2)
+          sfx(:sealed)
           @parts.burst(cur_x - 2, 0.0, 16, at: t, speed: 30, life: 0.5, palette: Color::NEON, gravity: 8) if full?
         end
       end
@@ -413,6 +444,7 @@ module Dopairb
       @last_kind = :delete
       @highlights.clear
       return unless lively?
+      sfx(:delete)
       glyph = removed.gsub(/\s/, "").chars.last || "."
       glyph = "." unless Term.char_width(glyph) == 1
       @parts.add(cur_x, 0.0, (@rng.rand - 0.5) * 6, 3, at: t, life: 0.45, palette: [[255, 255, 255], [255, 120, 120], [120, 40, 40]], glyph: glyph, gravity: 16)
@@ -443,6 +475,7 @@ module Dopairb
       @highlights.clear
       @highlights << Highlight.new(0, new.bytesize, t, 0.35, :reveal) if new.size < 4000
       pop("<< REWIND", cur_x - 10, t, Color::ICE, life: 0.5)
+      sfx(:rewind)
     end
 
     def completed(off, added, cur_x, t)
@@ -452,6 +485,7 @@ module Dopairb
       @highlights.reject! { |h| h.kind == :flash }
       @highlights << Highlight.new(off, off + added.bytesize, t, 0.5, :lock)
       @inline = Popup.new("<< LOCK ON", cur_x + 1, t, 0.6 * @config.duration, Color::ICE, false, 2)
+      sfx(:lock)
       @parts.burst(cur_x, 0.2, 10, at: t, speed: 28, life: 0.3, palette: Color::ICE, gravity: 0) if full?
     end
 
@@ -463,6 +497,40 @@ module Dopairb
       pop("PASTE x#{n}", (cur_x || 0) - 6, t, Color::NEON, life: 0.8, rise: true) if lively?
     end
 
+    # Big "64-BIT OVERDRIVE!!" in the strip. False when it cannot be drawn big.
+    def draw_streak(c, w, t)
+      s = @streak
+      big, tag = STREAK_NAMES[s.n] || [s.n.to_s, "STREAK!"]
+      bw = Font.width(big)
+      sub = "TYPING x#{s.n}  +#{s.n * 4}"
+      total = bw + 2 + [tag.size, sub.size].max
+      return false if total > w
+      age = (t - s.born) / s.life
+      x = (s.x - total / 2).clamp(0, w - total)
+      slide = ((1 - Fx.ease_out(age / 0.12)) * 12).round
+      c.tint_bg([255, 255, 255], 0.6 * (1 - age / 0.1), [x - 1, 0].max, 0, total + 2, STRIP_ROWS) if age < 0.1 && @config.flash != :off
+      pal = s.n >= 64 ? Color::NEON : Color::GOLD
+      sweep = (age * 3) % 1.4 - 0.2
+      drawn = Fx.half_text(c, big, x + slide, 0, lambda { |_cx, _r, f|
+        base = s.n >= 128 ? Color.rainbow(f - t * 2) : Color.ramp(pal, 0.1 + f * 0.3)
+        (f - sweep).abs < 0.08 ? [255, 255, 255] : base
+      })
+      return false unless drawn
+      tx = x + bw + 2 + slide
+      tag.each_char.with_index do |ch, i|
+        col = (t * 16 + i).to_i.even? ? [255, 255, 255] : Color.rainbow(i / 10.0 - t)
+        c.put(tx + i, 0, ch, age > 0.7 ? Color.ramp(pal, age) : col, bold: true)
+      end
+      c.put(tx, 2, sub, Color.ramp(pal, 0.2 + age * 0.5), bold: age < 0.6)
+      true
+    end
+
+    def sfx(name)
+      @sound.call(name)
+    rescue StandardError => e
+      Dopairb.debug(e)
+    end
+
     def spark(cur_x, t, n)
       return if n <= 0
       @parts.burst(cur_x - 0.5, -0.3, n, at: t, speed: 14, life: 0.35, palette: Color::FIRE, gravity: 20, angle: Math::PI / 2, arc: Math::PI * 1.2)

data/lib/dopairb/irb_adapter.rb

@@ -28,6 +28,14 @@ module Dopairb
         @installed = true
       end
 
+      # Is the current session one that binding.irb opened?
+      def from_binding?
+        ctx = IRB.conf[:MAIN_CONTEXT]
+        ctx.respond_to?(:from_binding?) && ctx.from_binding? ? true : false
+      rescue StandardError
+        false
+      end
+
       def expression?(statement)
         defined?(IRB::Statement::Expression) && IRB::Statement::Expression === statement
       end

data/lib/dopairb/output_tap.rb

@@ -45,8 +45,18 @@ module Dopairb
         nil
       end
 
+      # Our own helper processes (sound players) do not count as output.
+      def quietly
+        prev = Thread.current[:dopairb_quiet]
+        Thread.current[:dopairb_quiet] = true
+        yield
+      ensure
+        Thread.current[:dopairb_quiet] = prev
+      end
+
       # A child process may write straight to the tty: stop decorating.
       def spawned!
+        return if Thread.current[:dopairb_quiet]
         @spawned = true if @counting
         Term::LOCK.synchronize { Term.yield_to_output } if Term.overlay
       end

data/lib/dopairb/profile.rb

@@ -0,0 +1,106 @@
+# frozen_string_literal: true
+
+require "json"
+require "date"
+require "fileutils"
+
+module Dopairb
+  # What survives between sessions: lifetime XP (= total score), best score,
+  # best combo, the day streak and the collected bonus art. One small JSON
+  # file under $XDG_STATE_HOME (~/.local/state/dopairb/profile.json), or
+  # $DOPAIRB_PROFILE. DOPAIRB_PROFILE=off keeps nothing.
+  class Profile
+    FIELDS = %i[xp best_score best_combo sessions streak last_day gallery].freeze
+
+    attr_accessor(*FIELDS)
+    attr_reader :path
+
+    def self.default_path
+      env = ENV["DOPAIRB_PROFILE"]
+      return nil if env && %w[off 0 none].include?(env.downcase)
+      return env if env && !env.empty?
+      base = ENV["XDG_STATE_HOME"].to_s.empty? ? File.join(Dir.home, ".local", "state") : ENV["XDG_STATE_HOME"]
+      File.join(base, "dopairb", "profile.json")
+    rescue ArgumentError # no home directory
+      nil
+    end
+
+    def self.load(path = default_path)
+      prof = new(path)
+      return prof unless path && File.exist?(path)
+      data = JSON.parse(File.read(path), symbolize_names: true)
+      prof.xp = data[:xp].to_i
+      prof.best_score = data[:best_score].to_i
+      prof.best_combo = data[:best_combo].to_i
+      prof.sessions = data[:sessions].to_i
+      prof.streak = data[:streak].to_i
+      prof.last_day = data[:last_day]
+      prof.gallery = Array(data[:gallery]).map(&:to_sym) & Gallery.ids
+      prof
+    rescue SystemCallError, JSON::ParserError => e
+      Dopairb.debug(e)
+      new(path)
+    end
+
+    def initialize(path = nil)
+      @path = path
+      @xp = 0
+      @best_score = 0
+      @best_combo = 0
+      @sessions = 0
+      @streak = 0
+      @last_day = nil
+      @gallery = []
+    end
+
+    def level = Game.level_for(@xp)
+    def persistent? = !@path.nil?
+
+    # Count today toward the day streak. => true when the streak grew today.
+    def visit(today = Date.today)
+      day = today.iso8601
+      return false if @last_day == day
+      yesterday = (today - 1).iso8601
+      @streak = @last_day == yesterday ? @streak + 1 : 1
+      @last_day = day
+      true
+    end
+
+    def collect(id)
+      return false if @gallery.include?(id)
+      @gallery << id
+      true
+    end
+
+    # Fold a finished session in. Another dopairb may have saved meanwhile,
+    # so the file is re-read first and only this session's numbers are added.
+    def finish(stats, collected: [])
+      disk = persistent? ? Profile.load(@path) : self
+      disk.xp += stats[:score].to_i
+      disk.best_score = [disk.best_score, stats[:score].to_i].max
+      disk.best_combo = [disk.best_combo, stats[:max_combo].to_i].max
+      disk.sessions += 1
+      if @last_day.to_s > disk.last_day.to_s
+        disk.last_day = @last_day
+        disk.streak = @streak
+      end
+      collected.each { |id| disk.collect(id) }
+      disk.save
+      disk
+    end
+
+    def to_h = FIELDS.to_h { |k| [k, public_send(k)] }
+
+    def save
+      return false unless @path
+      FileUtils.mkdir_p(File.dirname(@path))
+      tmp = "#{@path}.#{Process.pid}.tmp"
+      File.write(tmp, JSON.pretty_generate(to_h) + "\n")
+      File.rename(tmp, @path)
+      true
+    rescue SystemCallError => e
+      Dopairb.debug(e)
+      false
+    end
+  end
+end

data/lib/dopairb/reline_adapter.rb

@@ -49,6 +49,7 @@ module Dopairb
       # ---- called from hooks ------------------------------------------------
 
       def before_read(core)
+        Dopairb.session&.intro
         wrap_output_modifier(core)
         @editor = core.line_editor
         return unless keys?

data/lib/dopairb/scene.rb

@@ -67,15 +67,22 @@ module Dopairb
     def length = 0.4
     def top? = false
     def big? = false
+    # Played on the alternate screen (full screen, scrollback untouched).
+    def alt? = false
     def mega? = false
     def bell? = mega?
     def trail = nil
     def shake(_t) = 0
     def flash_at = nil
+    # Sound patch name and when (scene time) its impact should be heard.
+    def sfx = nil
+    def impact_at = flash_at || 0.0
 
     # Wind-up before the main animation (input row glow); 0 when not wanted.
     def pre = top? ? ctx.pre.to_f : 0.0
     def total_length = pre + length
+    # Scenes that wait on something can end early.
+    def done?(_t) = false
 
     # Top rows (the input) as canvas, or nil to leave them untouched.
     def draw_top(c, t)
@@ -98,6 +105,11 @@ module Dopairb
       bits = extra.dup
       return bits unless event
       bits << "+#{Fx.number_with_commas(event.gain)}" if event.gain.to_i > 0
+      bits << "JACKPOT x#{Game::JACKPOT_MULT}" if event.flag?(:jackpot)
+      bits << "CRITICAL x#{event.mult / (event.flag?(:fever) ? 2 : 1)}" if event.flag?(:critical)
+      bits << "FEVER x2" if event.flag?(:fever) && !event.flag?(:fever_start)
+      bits << "LEVEL UP LV #{event.level}" if event.flag?(:level_up)
+      bits << "ART DROP" if event.flag?(:art_drop) && !event.flag?(:level_up)
       bits << "COMBO #{event.combo}" if event.combo.to_i > 1
       bits << "NEW RECORD" if event.flag?(:new_record) && !bits.include?("NEW RECORD")
       bits << "FIRST HIT" if event.flag?(:first_hit)

data/lib/dopairb/scenes/bonus.rb

@@ -0,0 +1,279 @@
+# frozen_string_literal: true
+
+module Dopairb
+  module Scenes
+    # A random critical hit: a slash, a red flash and the multiplier punching in.
+    class Critical < Scene
+      def top? = !ctx.input.nil?
+      def big? = true
+      def height = 3
+      def length = 0.7
+      def sfx = :crit
+      def impact_at = 0.1
+      def flash_at = 0.1
+
+      def setup
+        @x = 4
+        @parts = Fx::Particles.new(@rng)
+        @parts.burst(@x + 6, 1.5, 34, at: 0.1, speed: 42, life: 0.4, palette: Color::BLOOD, gravity: 8)
+        @parts.burst(@x + 6, 1.5, 16, at: 0.12, speed: 26, life: 0.35, palette: Color::GOLD, gravity: 6,
+                                      glyphs: ["*", "+", Term.glyph("✦", "*")])
+      end
+
+      def shake(t) = t.between?(0.1, 0.22) ? (@rng.rand(3) - 1) * 2 : 0
+
+      def draw(c, t)
+        if t < 0.1
+          p = t / 0.1
+          (0..2).each do |y|
+            x = (@x - 2 + p * 16 + y * 3).round
+            c.put(x, y, "\\", [255, 255, 255], bold: true)
+            c.put(x - 1, y, "\\", [255, 120, 120])
+          end
+          return
+        end
+        @parts.draw(c, t)
+        p = Fx.phase(t, 0.1, 0.7)
+        c.tint_bg([255, 40, 40], 0.5 * (1 - Fx.phase(t, 0.1, 0.22)), 0, 0, @w, 3) if ctx.config.flash != :off
+        label = "CRITICAL!!"
+        label.each_char.with_index do |ch, i|
+          flick = ((t * 20).to_i + i).even?
+          col = flick ? [255, 70, 60] : [255, 220, 90]
+          c.put(@x + i, 1, ch, t < 0.16 ? [255, 255, 255] : col, bold: true)
+        end
+        mx = @x + label.size + 2
+        m = " x#{event.mult} "
+        pop = Fx.ease_out_back(Fx.phase(t, 0.12, 0.3))
+        bg = Color.mix([255, 255, 255], [200, 30, 30], pop)
+        c.put(mx, 1, m, [255, 255, 255], bg: bg, bold: true) if pop > 0.05
+        c.put(mx + m.size + 2, 1, "+#{Fx.number_with_commas(event.gain)}", Color.mix([255, 255, 255], [255, 210, 90], p), bold: true)
+        sub = sub_bits.reject { |b| b.start_with?("+", "CRITICAL") }.join("   ")
+        c.put(@x, 2, sub, [170, 150, 150]) if p > 0.2 && !sub.empty?
+        c.put(@x, 0, "=>", [255, 160, 160], bold: true)
+      end
+
+      def trail
+        paint("=> #{Term.glyph('✦', '*')} CRITICAL!! x#{event.mult}  +#{Fx.number_with_commas(event.gain)}" +
+              (event.combo > 1 ? "  COMBO #{event.combo}" : ""), [255, 110, 90], bold: true)
+      end
+    end
+
+    # The rare jackpot: three slot reels stop on 7-7-7, then coins rain.
+    class Jackpot < Scene
+      SYMBOLS = %w[7 $ ? ! * #].freeze
+      STOPS = [0.45, 0.7, 0.95].freeze
+      REEL_W = 9
+
+      def top? = !ctx.input.nil?
+      def big? = true
+      def mega? = true
+      def length = 2.3
+      def sfx = :jackpot
+      def impact_at = STOPS.last
+      def flash_at = STOPS.last
+      def height = @full ? 10 : 2
+
+      def setup
+        @full = !ctx.compact && @w >= REEL_W * 3 + 8
+        @x0 = (@w - (REEL_W * 3 + 4)) / 2
+        @parts = Fx::Particles.new(@rng)
+        @coins = Fx::Particles.new(@rng)
+        return unless @full
+        STOPS.each_with_index do |at, i|
+          @parts.burst(@x0 + i * (REEL_W + 2) + REEL_W / 2.0, 3.5, 14, at: at, speed: 22, life: 0.3, palette: Color::GOLD, gravity: 6)
+        end
+        @parts.burst(@w / 2.0, 3.5, 90, at: STOPS.last, speed: 70, life: 0.7, palette: Color::GOLD, gravity: 14)
+        70.times do
+          @coins.add(@rng.rand * @w, -1, (@rng.rand - 0.5) * 6, 6 + @rng.rand * 8, at: STOPS.last + @rng.rand * 1.1, life: 1.1,
+                                         palette: [[255, 250, 200], [255, 210, 60], [200, 140, 0]],
+                                         glyph: ["$", "o", "O", "$", Term.glyph("✦", "*")][@rng.rand(5)], gravity: 6)
+        end
+      end
+
+      def shake(t) = (t - STOPS.last).between?(0, 0.35) ? ((@rng.rand * 2 - 1) * 3 * (1 - (t - STOPS.last) / 0.35)).round : 0
+
+      def draw(c, t)
+        return draw_compact(c, t) unless @full
+        c.fill_bg([60, 20, 70], @x0 - 2, 0, REEL_W * 3 + 8, 7)
+        lights = (t * 12).to_i
+        (REEL_W * 3 + 8).times do |i|
+          on = (i + lights).even?
+          c.put(@x0 - 2 + i, 0, "o", on ? [255, 230, 120] : [120, 80, 40], bg: [60, 20, 70], bold: on)
+          c.put(@x0 - 2 + i, 6, "o", on ? [120, 80, 40] : [255, 230, 120], bg: [60, 20, 70], bold: !on)
+        end
+        3.times do |i|
+          x = @x0 + i * (REEL_W + 2)
+          c.fill_bg([250, 245, 235], x, 1, REEL_W, 5)
+          stopped = t >= STOPS[i]
+          sym = stopped ? "7" : SYMBOLS[((t * 26).to_i + i * 2) % SYMBOLS.size]
+          bounce = stopped && t - STOPS[i] < 0.06 ? 1 : 0
+          col = if stopped
+                  t >= STOPS.last ? Color.rainbow(t * 1.5 + i * 0.2) : [220, 30, 40]
+                else
+                  [140, 140, 160]
+                end
+          gw = Font.width(sym)
+          Fx.big_text(c, sym, x + (REEL_W - gw) / 2, 1 + bounce, ->(*) { col }, bg_fn: ->(*) { [250, 245, 235] })
+          c.tint_bg([0, 0, 0], 0.25, x, 1, REEL_W, 5) unless stopped
+        end
+        @parts.draw(c, t)
+        @coins.draw(c, t)
+        return if t < STOPS.last
+        c.tint_bg([255, 230, 120], 0.6 * (1 - Fx.phase(t, STOPS.last, STOPS.last + 0.15)), 0, 0, @w, height) if ctx.config.flash != :off
+        label = "J A C K P O T !!   x#{event.mult}"
+        n = (label.size * Fx.phase(t, STOPS.last, STOPS.last + 0.3)).round
+        label[0, n].each_char.with_index do |ch, i|
+          c.put((@w - label.size) / 2 + i, 8, ch, Color.rainbow(i / 14.0 - t), bold: true)
+        end
+        gain = (event.gain * Fx.ease_out(Fx.phase(t, STOPS.last + 0.1, STOPS.last + 0.7))).round
+        c.put_center(9, "+#{Fx.number_with_commas(gain)}  #{sub_bits.reject { |b| b.start_with?('+', 'JACKPOT') }.join('   ')}",
+                     [255, 220, 120], bold: true)
+      end
+
+      def draw_compact(c, t)
+        3.times do |i|
+          sym = t >= STOPS[i] ? "7" : SYMBOLS[((t * 26).to_i + i) % SYMBOLS.size]
+          c.put(1 + i * 4, 0, "[#{sym}]", t >= STOPS[i] ? [255, 80, 80] : [180, 180, 190], bold: true)
+        end
+        c.put(1, 1, "JACKPOT!! x#{event.mult}  +#{Fx.number_with_commas(event.gain)}", Color.rainbow(t), bold: true) if t >= STOPS.last
+      end
+
+      def trail
+        s = "#{Term.glyph('✦', '*')} [7][7][7] JACKPOT!! x#{event.mult}  +#{Fx.number_with_commas(event.gain)}"
+        return s if depth == :none
+        s.each_char.with_index.map { |ch, i| "#{Color.sgr(Color.rainbow(i / 20.0), nil, true, depth)}#{ch}" }.join + "\e[0m"
+      end
+    end
+
+    # LEVEL UP (or a jackpot prize, or a lucky ART DROP): the title slams in,
+    # then a masterpiece is unveiled full screen.
+    class Masterpiece < Scene
+      LAND = 0.22
+      REVEAL = 1.0
+      SHOWN = 1.75
+
+      def self.fits?(rows, cols) = rows >= 16 && cols >= 40
+
+      def alt? = true
+      def big? = true
+      def mega? = true
+      def height = ctx.rows
+      def length = 4.2
+      def sfx = :levelup
+      def impact_at = LAND
+      def flash_at = LAND
+
+      def setup
+        @h = ctx.rows
+        @piece = Gallery.find(event.info[:art]) || Gallery::PIECES.first
+        @level_up = event.flag?(:level_up)
+        @title = if @level_up then "LEVEL UP!"
+                 elsif event.flag?(:jackpot) then "JACKPOT PRIZE"
+                 else "ART DROP!"
+                 end
+        @title = "BONUS!" if Font.width(@title) > @w - 2
+        @tscale = Font.width(@title, scale: 2) <= @w - 4 ? 2 : 1
+        @aw, @ah = Gallery.fit(@piece, @w - 6, @h - 6)
+        @ax = (@w - @aw) / 2
+        @ay = 2
+        @parts = Fx::Particles.new(@rng)
+        tw = Font.width(@title, scale: @tscale)
+        cy = @h / 2.0 - 1
+        10.times do |i|
+          @parts.burst((@w - tw) / 2.0 + tw * i / 9.0, cy + 3, 9, at: LAND, speed: 45, life: 0.6, palette: Color::NEON, gravity: 18,
+                                                             angle: -Math::PI / 2, arc: Math::PI * 1.6)
+        end
+        @parts.burst(@w / 2.0, @ay + @ah / 4.0, 120, at: REVEAL + 0.45, speed: 80, life: 0.8, palette: Color::GOLD, gravity: 10)
+        @stars = Array.new(60) { [@rng.rand(@w), @rng.rand(@h), @rng.rand, 0.5 + @rng.rand] }
+      end
+
+      def shake(t)
+        [[LAND, 4, 0.35], [REVEAL + 0.45, 2, 0.25]].each do |at, amp, len|
+          age = t - at
+          return ((@rng.rand * 2 - 1) * amp * (1 - age / len)).round if age >= 0 && age < len
+        end
+        0
+      end
+
+      def draw(c, t)
+        draw_stars(c, t)
+        t < REVEAL ? draw_title(c, t) : draw_art(c, t)
+        @parts.draw(c, t)
+      end
+
+      def trail
+        star = Term.glyph("✦", "*")
+        g = event.info[:gallery]
+        head = @level_up ? "LEVEL UP! LV #{event.level}" : @title
+        s = "#{star} #{head} #{star}  BONUS ART: #{@piece.title} (#{@piece.artist}, #{@piece.year})"
+        s << (event.info[:art_new] ? "  NEW!" : "  ENCORE")
+        s << "  GALLERY #{g[0]}/#{g[1]}" if g
+        paint(s, Color.ramp(Color::NEON, 0.15), bold: true)
+      end
+
+      private
+
+      def draw_stars(c, t)
+        @stars.each do |x, y, ph, sp|
+          f = (t * sp + ph) % 1.0
+          next if f > 0.5
+          k = 1 - (f - 0.25).abs * 4
+          c.put(x, y, k > 0.7 ? "+" : ".", Color.mix([40, 30, 70], [220, 200, 255], k))
+        end
+      end
+
+      def draw_title(c, t)
+        y0 = (@h - Font::HEIGHT) / 2 - 1
+        drop = t < LAND ? ((1 - Fx.ease_in(t / LAND)) * (y0 + 6)).round : 0
+        sweep = (t * 1.4) % 1.4 - 0.2
+        fn = lambda do |_rx, ry, f|
+          base = Color.rainbow(f * 0.8 - t + ry * 0.03, 0.8)
+          (f - sweep).abs < 0.07 && t >= LAND ? [255, 255, 255] : base
+        end
+        Fx.big_text(c, @title, (@w - Font.width(@title, scale: @tscale)) / 2, y0 - drop, fn, scale: @tscale)
+        return if t < LAND
+        c.tint_bg([200, 120, 255], 0.55 * (1 - Fx.phase(t, LAND, LAND + 0.15))) if ctx.config.flash != :off
+        Fx.shockwave(c, @w / 2.0, y0 + 2.5, t - LAND, speed: 110, palette: Color::NEON, life: 0.6, rings: 3)
+        lv = @level_up ? "LV #{event.level - 1}  >>  LV #{event.level}" : "A MASTERPIECE APPEARS"
+        n = (lv.size * Fx.phase(t, LAND + 0.1, LAND + 0.4)).round
+        c.put_center(y0 + Font::HEIGHT + 2, lv[0, n], [255, 230, 140], bold: true)
+        msg = "BONUS ART UNLOCKED"
+        c.put_center(y0 + Font::HEIGHT + 4, msg, ((t * 8).to_i.even? ? [255, 255, 255] : [255, 200, 90]), bold: true) if t > LAND + 0.45
+      end
+
+      def draw_art(c, t)
+        p = Fx.phase(t, REVEAL, REVEAL + 0.45)
+        rows = @ah / 2
+        # gold frame
+        frame = Color.mix([255, 240, 170], [190, 130, 30], (Math.sin(t * 6) + 1) / 2)
+        c.fill_bg(frame, @ax - 2, @ay - 1, @aw + 4, rows + 2)
+        c.fill_bg([70, 45, 10], @ax - 1, @ay, @aw + 2, rows) if p < 1
+        head = rows * p
+        sheen = (t - REVEAL - 0.5) * 1.2
+        Gallery.draw(c, @piece, @ax, @ay, @aw, @ah, reveal: p, depth: depth) do |top, bot, x, r|
+          if p < 1 && (r - head).abs < 1.2
+            [Color.mix(top, [255, 255, 255], 0.8), Color.mix(bot, [255, 255, 255], 0.8)]
+          elsif sheen.between?(0, 1.5) && ((x.fdiv(@aw) + r.fdiv(rows) * 0.5) - sheen).abs < 0.06
+            [Color.mix(top, [255, 255, 255], 0.55), Color.mix(bot, [255, 255, 255], 0.55)]
+          else
+            [top, bot]
+          end
+        end
+        Fx.sparkles(c, t, 21, 18, palette: Color::GOLD, area: [@ax - 4, @ay - 1, @aw + 8, rows + 2]) if p >= 1
+        head = @level_up ? "LEVEL #{event.level}" : @title
+        c.put_center(0, "#{Term.glyph('✦', '*')}  #{head}  #{Term.glyph('✦', '*')}  BONUS ART", Color.rainbow(t * 0.7), bold: true)
+        return if t < REVEAL + 0.45
+        cap = "\"#{@piece.title}\"  #{@piece.artist}, #{@piece.year}"
+        n = (cap.size * Fx.phase(t, REVEAL + 0.5, REVEAL + 1.0)).round
+        c.put_center(@ay + rows + 1, cap[0, n], [240, 230, 210], bold: true)
+        g = event.info[:gallery]
+        tag = event.info[:art_new] ? "NEW!" : "ENCORE"
+        tag += "   GALLERY #{g[0]}/#{g[1]}" if g
+        if t > REVEAL + 0.9
+          col = event.info[:art_new] && (t * 6).to_i.even? ? [255, 90, 90] : [255, 220, 120]
+          c.put_center(@ay + rows + 2, tag, col, bold: true)
+        end
+      end
+    end
+  end
+end