przn 0.3.0 → 0.5.0

data/lib/przn/renderer.rb

@@ -10,21 +10,35 @@ module Przn
       dim:           "\e[2m",
       cyan:          "\e[36m",
       gray_bg:       "\e[48;5;236m",
-      reset:         "\e[0m",
+      reset:         "\e[0m"
     }.freeze
 
     DEFAULT_SCALE = 2
 
-    def initialize(terminal, base_dir: '.', theme: nil)
+    # Default `relative_height` (as a percent of terminal height) applied to
+    # image blocks that don't carry an explicit one. Caps how much of the
+    # screen a single image can occupy; the rest leaves predictable margin
+    # for the slide footer and avoids placement-clearing edge cases in some
+    # terminals when an image lands right against the bottom row.
+    DEFAULT_IMAGE_RELATIVE_HEIGHT_PERCENT = 70
+
+    # `mode:` controls whether `{::note}` / `<note>` segments are rendered:
+    #   :solo      — dim-inline (today's behavior), default for stand-alone runs.
+    #   :audience  — stripped from output; the projector view never shows notes.
+    #   :presenter — dim-inline (so the presenter sees them in context) and
+    #                ALSO aggregated separately for the side panel via
+    #                Slide#notes; this renderer just keeps the inline copy.
+    def initialize(terminal, base_dir: '.', theme: nil, mode: :solo)
       @terminal = terminal
       @base_dir = base_dir
       @theme = theme || Theme.default
+      @mode = mode
       @image_cache = {}
       @kitty_uploads = {}
       @mutex = Mutex.new
     end
 
-    def render(slide, current:, total:)
+    def render(slide, current:, total:, started_at: nil)
       @mutex.synchronize do
         @terminal.clear
         apply_slide_background(slide)
@@ -49,9 +63,13 @@ module Przn
           end
         end
 
-        status = " #{current + 1} / #{total} "
-        @terminal.move_to(h, w - status.size)
-        @terminal.write "#{ANSI[:dim]}#{status}#{ANSI[:reset]}"
+        if @theme.rabbit
+          draw_runner_bar(h, w, current, total, started_at)
+        else
+          status = " #{current + 1} / #{total} "
+          @terminal.move_to(h, w - status.size)
+          @terminal.write "#{ANSI[:dim]}#{status}#{ANSI[:reset]}"
+        end
 
         @terminal.flush
       end
@@ -91,6 +109,7 @@ module Przn
       when :image           then render_image(block, width, row)
       when :blank           then row + DEFAULT_SCALE
       when :bg              then row
+      when :at              then render_at(block); row
       else row + 1
       end
     end
@@ -119,6 +138,102 @@ module Przn
       @terminal.write "\e]7772;bg-gradient;type=#{type}:angle=#{angle}:colors=#{colors.join(',')}\a"
     end
 
+    # Place text at an absolute (column, row) on the slide, escaping the
+    # normal top-down paragraph flow. Coordinates are 1-based terminal cells
+    # to match the CSI cursor-position escape. A trailing `%` interprets the
+    # value as a percentage of the terminal's width (for `x=`) or height
+    # (for `y=`) — `x="50%" y="50%"` lands at the middle of the pane,
+    # auto-resizing with the terminal. Content is parsed inline so
+    # `<size>`, `<color>`, `<font>`, **bold**, etc. all work inside `<at>`.
+    # The block contributes 0 to the slide's layout height so it doesn't
+    # push subsequent content down.
+    def render_at(block)
+      attrs = block[:attrs] || {}
+      x = resolve_at_coord(attrs[:x], @terminal.width)
+      y = resolve_at_coord(attrs[:y], @terminal.height)
+      return if x.nil? || y.nil?
+
+      segments = Parser.parse_inline(block[:content].to_s)
+      @terminal.move_to(y, x)
+      @terminal.write render_segments_scaled(segments, DEFAULT_SCALE)
+    end
+
+    # Resolve an `<at>` coordinate string against the dimension it indexes.
+    # `"50%"` → halfway along `max`; plain integer string → that number of
+    # cells. Out-of-range values clamp into [1, max]. Returns nil when the
+    # input is missing or unparseable so the renderer skips silently.
+    def resolve_at_coord(raw, max)
+      return nil if raw.nil?
+
+      s = raw.to_s.strip
+      return nil if s.empty?
+
+      cells =
+        if s.end_with?('%')
+          pct = s.chomp('%').to_f
+          (pct / 100.0 * max).round
+        elsif s =~ /\A-?\d+\z/
+          s.to_i
+        end
+      return nil if cells.nil?
+
+      cells.clamp(1, max)
+    end
+
+    # Bottom-row progress indicator (Rabbit-style):
+    #
+    #   1                   🐢                🐇                   9
+    #   └ current slide #   └ elapsed time    └ slide progress     └ goal (total slides)
+    #
+    # The anchor numbers (current at the left, total at the right) sit on the
+    # very bottom row; the emojis render at OSC 66 scale 2 and are anchored at
+    # row `h-1` so their bottom half lands on row `h` next to the numbers,
+    # making them visibly twice as large as the labels without needing more
+    # vertical screen real-estate. The turtle is hidden when
+    # `theme.rabbit.duration` is unset / unparseable. `flip=h` mirrors each
+    # glyph horizontally on terminals that honor it (Echoes); others ignore
+    # the parameter and the emojis face left.
+    EMOJI_RUNNER_CELLS = 4 # 🐇/🐢 are 2 source cells wide, rendered at s=2 → 4 cells
+
+    def draw_runner_bar(h, w, current, total, started_at)
+      left  = (current + 1).to_s
+      right = total.to_s
+      track_left  = left.size + 2          # 1 cell gap after the left number
+      track_right = w - right.size - 1     # 1 cell gap before the right number
+      return if track_right - track_left < EMOJI_RUNNER_CELLS
+
+      @terminal.move_to(h, 1)
+      @terminal.write "#{ANSI[:dim]}#{left}#{ANSI[:reset]}"
+      @terminal.move_to(h, w - right.size + 1)
+      @terminal.write "#{ANSI[:dim]}#{right}#{ANSI[:reset]}"
+
+      rabbit_row = [h - 1, 1].max
+      rabbit_col = runner_col(current, [total - 1, 1].max, track_left, track_right)
+      @terminal.move_to(rabbit_row, rabbit_col)
+      @terminal.write KittyText.sized('🐇', s: 2, flip: 'h')
+
+      duration_s = Theme.parse_duration(@theme.rabbit[:duration])
+      return unless started_at && duration_s && duration_s.positive?
+
+      elapsed = Time.now - started_at
+      frac = (elapsed / duration_s).clamp(0.0, 1.0)
+      span = (track_right - (EMOJI_RUNNER_CELLS - 1)) - track_left
+      turtle_col = track_left + (frac * [span, 0].max).round
+      @terminal.move_to(rabbit_row, turtle_col)
+      @terminal.write KittyText.sized('🐢', s: 2, flip: 'h')
+    end
+
+    # Linear-interpolate a runner's column inside the track. `step` is 0..max
+    # (e.g. current slide index 0..total-1), and the returned column leaves
+    # enough room for an emoji `EMOJI_RUNNER_CELLS` cells wide before the
+    # right-anchor number.
+    def runner_col(step, max, track_left, track_right)
+      return track_left if max <= 0
+      span = (track_right - (EMOJI_RUNNER_CELLS - 1)) - track_left
+      span = 0 if span < 0
+      track_left + (step.to_f / max * span).round
+    end
+
     def render_heading(block, width, row)
       text = block[:content]
 
@@ -152,7 +267,7 @@ module Przn
           if li == 0
             @terminal.write "#{render_bullet(prefix)}#{render_segments_scaled(line_segs, DEFAULT_SCALE)}"
           else
-            @terminal.write "#{KittyText.sized(" " * prefix_w, s: DEFAULT_SCALE)}#{render_segments_scaled(line_segs, DEFAULT_SCALE)}"
+            @terminal.write "#{KittyText.sized(' ' * prefix_w, s: DEFAULT_SCALE)}#{render_segments_scaled(line_segs, DEFAULT_SCALE)}"
           end
           row += DEFAULT_SCALE
         end
@@ -206,7 +321,7 @@ module Przn
       left = content_left(width)
       block[:items].each do |item|
         depth = item[:depth] || 0
-        indent = "  " * depth
+        indent = '  ' * depth
         prefix = "#{indent}#{@theme.bullet[:text]}"
         prefix_w = display_width(prefix)
         max_w = max_text_width(width, left, DEFAULT_SCALE) - prefix_w
@@ -219,7 +334,7 @@ module Przn
           if li == 0
             @terminal.write "#{render_bullet(prefix)}#{render_segments_scaled(line_segs, DEFAULT_SCALE)}"
           else
-            @terminal.write "#{KittyText.sized(" " * prefix_w, s: DEFAULT_SCALE)}#{render_segments_scaled(line_segs, DEFAULT_SCALE)}"
+            @terminal.write "#{KittyText.sized(' ' * prefix_w, s: DEFAULT_SCALE)}#{render_segments_scaled(line_segs, DEFAULT_SCALE)}"
           end
           row += DEFAULT_SCALE
         end
@@ -232,7 +347,7 @@ module Przn
       left = content_left(width)
       block[:items].each_with_index do |item, i|
         depth = item[:depth] || 0
-        indent = "  " * depth
+        indent = '  ' * depth
         prefix = "#{indent}#{i + 1}. "
         prefix_w = display_width(prefix)
         max_w = max_text_width(width, left, DEFAULT_SCALE) - prefix_w
@@ -245,7 +360,7 @@ module Przn
           if li == 0
             @terminal.write "#{KittyText.sized(prefix, s: DEFAULT_SCALE)}#{render_segments_scaled(line_segs, DEFAULT_SCALE)}"
           else
-            @terminal.write "#{KittyText.sized(" " * prefix_w, s: DEFAULT_SCALE)}#{render_segments_scaled(line_segs, DEFAULT_SCALE)}"
+            @terminal.write "#{KittyText.sized(' ' * prefix_w, s: DEFAULT_SCALE)}#{render_segments_scaled(line_segs, DEFAULT_SCALE)}"
           end
           row += DEFAULT_SCALE
         end
@@ -281,7 +396,7 @@ module Przn
 
     def render_blockquote(block, width, row)
       left = content_left(width)
-      prefix = "| "
+      prefix = '| '
       prefix_w = display_width(prefix)
       max_w = max_text_width(width, left + 1, DEFAULT_SCALE) - prefix_w
 
@@ -292,7 +407,7 @@ module Przn
 
         wrapped.each_with_index do |line_segs, li|
           @terminal.move_to(row, left + 1)
-          p = li == 0 ? prefix : " " * prefix_w
+          p = li == 0 ? prefix : ' ' * prefix_w
           @terminal.write "#{ANSI[:dim]}#{KittyText.sized(p, s: DEFAULT_SCALE)}#{render_segments_scaled(line_segs, DEFAULT_SCALE)}#{ANSI[:reset]}"
           row += DEFAULT_SCALE
         end
@@ -316,7 +431,7 @@ module Przn
         @terminal.move_to(row, left)
         line = cells.each_with_index.map { |cell, ci|
           pad_to_width(cell, col_widths[ci] || 0)
-        }.join("  |  ")
+        }.join('  |  ')
         if ri == 0
           @terminal.write "#{ANSI[:bold]}#{KittyText.sized(line, s: DEFAULT_SCALE)}#{ANSI[:reset]}"
         else
@@ -326,7 +441,7 @@ module Przn
 
         if ri == 0
           @terminal.move_to(row, left)
-          @terminal.write KittyText.sized(col_widths.map { |w| "-" * w }.join("--+--"), s: DEFAULT_SCALE)
+          @terminal.write KittyText.sized(col_widths.map { |w| '-' * w }.join('--+--'), s: DEFAULT_SCALE)
           row += DEFAULT_SCALE
         end
       end
@@ -343,15 +458,31 @@ module Przn
       img_w, img_h = img_size
       cell_w, cell_h = @terminal.cell_pixel_size
 
-      available_rows = @terminal.height - row - 2
-      left = content_left(width)
-      available_cols = width - left * 2
+      attrs = block[:attrs] || {}
+      abs_x = resolve_at_coord(attrs['x'], @terminal.width)
+      abs_y = resolve_at_coord(attrs['y'], @terminal.height)
+      absolute = abs_x && abs_y
 
-      if (rh = block[:attrs]['relative_height'])
-        target_rows = (@terminal.height * rh.to_i / 100.0).to_i
-        available_rows = [target_rows, available_rows].min
+      origin_row = absolute ? abs_y : row
+      available_rows = [@terminal.height - origin_row - 2, 1].max
+      if absolute
+        available_cols = [@terminal.width - abs_x + 1, 1].max
+      else
+        left = content_left(width)
+        available_cols = width - left * 2
       end
 
+      # Cap the default vertical area to 70 % of the screen, matching what
+      # `{:relative_height="70"}` would do explicitly. Large images that
+      # extend to within a couple of rows of the screen edge render
+      # unreliably in some terminals — they're known-good at 70 %, and
+      # smaller images sit well within this cap so they're unaffected.
+      # An explicit `relative_height` still overrides.
+      default_rh = DEFAULT_IMAGE_RELATIVE_HEIGHT_PERCENT
+      rh = attrs['relative_height'] || default_rh
+      target_rows = (@terminal.height * rh.to_i / 100.0).to_i
+      available_rows = [target_rows, available_rows].min
+
       # Calculate target cell size maintaining aspect ratio
       img_cell_w = img_w.to_f / cell_w
       img_cell_h = img_h.to_f / cell_h
@@ -361,24 +492,29 @@ module Przn
       target_cols = [target_cols, 1].max
       target_rows = [target_rows, 1].max
 
-      x = [(width - target_cols) / 2, 0].max
+      if absolute
+        y_cell, x_cell = abs_y, abs_x
+      else
+        y_cell = row
+        x_cell = [(width - target_cols) / 2, 0].max + 1
+      end
 
       if ImageUtil.kitty_terminal? && ImageUtil.png?(path)
         image_id = ensure_kitty_uploaded(path)
-        @terminal.move_to(row, x + 1)
+        @terminal.move_to(y_cell, x_cell)
         @terminal.write ImageUtil.kitty_place(image_id: image_id, cols: target_cols, rows: target_rows)
       elsif ImageUtil.kitty_terminal?
-        data = cached_kitty_icat(path, cols: target_cols, rows: target_rows, x: x, y: row - 1)
+        data = cached_kitty_icat(path, cols: target_cols, rows: target_rows, x: x_cell - 1, y: y_cell - 1)
         @terminal.write data if data && !data.empty?
       elsif ImageUtil.sixel_available?
-        @terminal.move_to(row, x + 1)
+        @terminal.move_to(y_cell, x_cell)
         target_pixel_w = target_cols * cell_w
         target_pixel_h = target_rows * cell_h
         sixel = cached_sixel_encode(path, width: target_pixel_w, height: target_pixel_h)
         @terminal.write sixel if sixel && !sixel.empty?
       end
 
-      row + target_rows
+      absolute ? row : row + target_rows
     end
 
     def resolve_image_path(path)
@@ -504,7 +640,7 @@ module Przn
       f = default_face == :body ? @theme.font[:family] : default_face
       h = default_h
       c = default_color == :body ? @theme.font[:color] : default_color
-      body_open = c ? color_code(c) : ""
+      body_open = c ? color_code(c) : ''
       inner = segments.map { |segment|
         type = segment[0]
         content = segment[1]
@@ -519,7 +655,7 @@ module Przn
             KittyText.sized(content, s: para_scale, f: f, h: h)
           end
         when :font          then "#{render_font_segment(content, segment[2] || {}, para_scale, default_face: f, default_h: h)}#{(segment[2] || {})[:color] ? body_open : ''}"
-        when :note          then "#{ANSI[:dim]}#{KittyText.sized(content, s: para_scale, f: f, h: h)}#{ANSI[:reset]}#{body_open}"
+        when :note          then @mode == :audience ? "" : "#{ANSI[:dim]}#{KittyText.sized(content, s: para_scale, f: f, h: h)}#{ANSI[:reset]}#{body_open}"
         when :bold          then "#{ANSI[:bold]}#{KittyText.sized(content, s: para_scale, f: f, h: h)}#{ANSI[:reset]}#{body_open}"
         when :italic        then "#{ANSI[:italic]}#{KittyText.sized(content, s: para_scale, f: f, h: h)}#{ANSI[:reset]}#{body_open}"
         when :strikethrough then "#{ANSI[:strikethrough]}#{KittyText.sized(content, s: para_scale, f: f, h: h)}#{ANSI[:reset]}#{body_open}"
@@ -545,7 +681,7 @@ module Przn
       used = 0
 
       segments.each do |seg|
-        content = seg[1] || ""
+        content = seg[1] || ''
         next if content.empty?
 
         seg_scale = effective_seg_scale(seg, para_scale)
@@ -594,7 +730,7 @@ module Przn
 
     def segments_visible_cells(segments, para_scale)
       segments.sum { |seg|
-        content = seg[1] || ""
+        content = seg[1] || ''
         display_width(content) * effective_seg_scale(seg, para_scale)
       }
     end
@@ -636,7 +772,7 @@ module Przn
 
     def pad_to_width(text, target_width)
       current = display_width(text)
-      text + " " * [target_width - current, 0].max
+      text + ' ' * [target_width - current, 0].max
     end
 
     def max_inline_scale(text)
@@ -669,7 +805,7 @@ module Przn
         r, g, b = color.scan(/../).map { |h| h.to_i(16) }
         "\e[38;2;#{r};#{g};#{b}m"
       else
-        ""
+        ''
       end
     end
 
@@ -706,12 +842,12 @@ module Przn
       text
         .gsub(/\{::tag\s+name="[^"]+"\}(.*?)\{:\/tag\}/, '\1')
         .gsub(/\{::note\}(.*?)\{:\/note\}/, '\1')
-        .gsub(/\{::wait\/\}/, '')
+        .gsub('{::wait/}', '')
         .gsub(/\*\*(.+?)\*\*/, '\1')
         .gsub(/\*(.+?)\*/, '\1')
         .gsub(/~~(.+?)~~/, '\1')
         .gsub(/`([^`]+)`/, '\1')
-        .gsub(/&(lt|gt|amp);/) { |_| {"lt" => "<", "gt" => ">", "amp" => "&"}[$1] }
+        .gsub(/&(lt|gt|amp);/) { |_| {'lt' => '<', 'gt' => '>', 'amp' => '&'}[$1] }
     end
 
     def calculate_height(blocks, width)
@@ -752,11 +888,20 @@ module Przn
       when :table
         ((block[:header] ? 2 : 0) + block[:rows].size) * s
       when :image
-        image_block_height(block, width)
+        # Absolute-positioned images (`<img x y src/>`) layer on top of
+        # the slide and contribute 0 to the layout — same treatment as :at.
+        attrs = block[:attrs] || {}
+        if resolve_at_coord(attrs['x'], @terminal.width) && resolve_at_coord(attrs['y'], @terminal.height)
+          0
+        else
+          image_block_height(block, width)
+        end
       when :align
         0
       when :bg
         0
+      when :at
+        0
       when :blank
         s
       else

data/lib/przn/screenshot_pdf_exporter.rb

@@ -4,6 +4,20 @@ require 'tmpdir'
 require 'fileutils'
 
 module Przn
+  # Default PDF export: drives the live renderer, asks the terminal to save
+  # each rendered slide as a one-page vector PDF via OSC 7772 `capture`,
+  # then concatenates the per-slide PDFs into a single multi-page PDF.
+  # Requires Echoes (or any terminal that implements the same capture
+  # command); use `export_pdf_prawn` instead for environments where that's
+  # not possible (CI, headless).
+  def self.export_pdf(file, output, theme: nil)
+    markdown = File.read(file)
+    presentation = Parser.parse(markdown)
+    base_dir = File.dirname(File.expand_path(file))
+    ScreenshotPdfExporter.new(presentation, base_dir: base_dir, theme: theme).export(output)
+    puts "Generated: #{output}"
+  end
+
   # Renders each slide live to the user's terminal, asks the terminal to save
   # the current pane as a vector PDF via Echoes' OSC 7772 `capture` command,
   # then concatenates the per-slide PDFs into a single multi-page PDF.
@@ -53,7 +67,7 @@ module Przn
       @terminal.enter_alt_screen
       @terminal.hide_cursor
       @presentation.slides.each_with_index do |slide, i|
-        pdf_path = File.join(dir, format("slide-%04d.pdf", i))
+        pdf_path = File.join(dir, format('slide-%04d.pdf', i))
         @renderer.render(slide, current: i, total: @presentation.total)
         request_capture(pdf_path)
         wait_for_capture(pdf_path)
@@ -62,6 +76,7 @@ module Przn
       paths
     ensure
       @terminal.write "#{OSC};bg-clear#{BEL}"
+      @terminal.write ImageUtil.kitty_clear_all if ImageUtil.kitty_terminal?
       @terminal.show_cursor
       @terminal.leave_alt_screen
       @terminal.flush
@@ -77,7 +92,7 @@ module Przn
       until File.exist?(path) && File.size?(path).to_i.positive?
         if Time.now > deadline
           raise "Capture timed out for #{path}. " \
-                "Is Echoes running and recent enough to honor OSC 7772 `capture` to a .pdf path?"
+                'Is Echoes running and recent enough to honor OSC 7772 `capture` to a .pdf path?'
         end
         sleep POLL_INTERVAL
       end
@@ -86,7 +101,7 @@ module Przn
     end
 
     def merge_pdfs(pdf_paths, output_path)
-      raise "No slides captured" if pdf_paths.empty?
+      raise 'No slides captured' if pdf_paths.empty?
 
       output = HexaPDF::Document.new
       pdf_paths.each do |path|

data/lib/przn/slide.rb

@@ -7,5 +7,30 @@ module Przn
     def initialize(blocks)
       @blocks = blocks.freeze
     end
+
+    # Aggregate every `{::note}` / `<note>` segment in the slide's text-bearing
+    # fields. The presenter view renders these in its side panel; the audience
+    # renderer strips them from the rendered output.
+    def notes
+      out = []
+      blocks.each do |b|
+        texts = []
+        texts << b[:content] if b[:content].is_a?(String)
+        texts << b[:term]    if b[:term].is_a?(String)
+        texts << b[:definition] if b[:definition].is_a?(String)
+        if b[:items].is_a?(Array)
+          b[:items].each { |it| texts << it[:text] if it.is_a?(Hash) && it[:text].is_a?(String) }
+        end
+        if b[:rows].is_a?(Array)
+          (Array(b[:header]) + b[:rows].flatten).each { |c| texts << c if c.is_a?(String) }
+        end
+        texts.each do |text|
+          Parser.parse_inline(text).each do |seg|
+            out << seg[1] if seg[0] == :note && seg[1] && !seg[1].empty?
+          end
+        end
+      end
+      out
+    end
   end
 end

data/lib/przn/theme.rb

@@ -6,7 +6,7 @@ module Przn
   class Theme
     DEFAULT_PATH = File.expand_path('../../../default_theme.yml', __FILE__)
 
-    attr_reader :colors, :font, :bullet, :background, :title
+    attr_reader :colors, :font, :bullet, :background, :title, :rabbit
 
     def self.load(path)
       raise ArgumentError, "Theme file not found: #{path}" unless File.exist?(path)
@@ -19,10 +19,37 @@ module Przn
         bullet: defaults[:bullet].merge(overrides[:bullet] || {}),
         background: defaults[:background].merge(overrides[:background] || {}),
         title: defaults[:title].merge(overrides[:title] || {}),
+        # `rabbit` is opt-in: absent → nil → renderer uses the plain N/M footer.
+        # Present (even as an empty block) → hash → renderer uses the runner bar.
+        rabbit: defaults[:rabbit] || overrides[:rabbit] ?
+          (defaults[:rabbit] || {}).merge(overrides[:rabbit] || {}) :
+          nil
       }
       new(merged)
     end
 
+    # Convert a human-friendly duration string to seconds.
+    #   "30m"     -> 1800
+    #   "1h30m"   -> 5400
+    #   "1h2m3s"  -> 3723
+    #   "45"      -> 45  (bare integers are seconds)
+    #   45        -> 45  (already a number)
+    #   nil / ""  -> nil
+    #   "garbage" -> nil
+    def self.parse_duration(input)
+      return nil if input.nil?
+      return input.to_i if input.is_a?(Numeric)
+
+      s = input.to_s.strip
+      return nil if s.empty?
+      return s.to_i if s =~ /\A\d+\z/
+
+      m = s.match(/\A(?:(\d+)h)?(?:(\d+)m)?(?:(\d+)s)?\z/)
+      return nil unless m && m[0] != ''
+      h, mi, se = m[1].to_i, m[2].to_i, m[3].to_i
+      h * 3600 + mi * 60 + se
+    end
+
     def self.default
       new(load_yaml(DEFAULT_PATH))
     end
@@ -44,6 +71,9 @@ module Przn
         bullet: (data[:bullet] || {}).compact,
         background: (data[:background] || {}).compact,
         title: (data[:title] || {}).compact,
+        # nil when the `rabbit:` key isn't in the YAML at all (opt-in feature);
+        # empty hash when it's present but childless.
+        rabbit: data.key?(:rabbit) ? (data[:rabbit] || {}).compact : nil
       }
     end
     private_class_method :load_yaml
@@ -54,6 +84,7 @@ module Przn
       @bullet = config[:bullet]
       @background = config[:background]
       @title = config[:title]
+      @rabbit = config[:rabbit]
     end
   end
 end

data/lib/przn/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Przn
-  VERSION = "0.3.0"
+  VERSION = '0.5.0'
 end