Initial commit: extracted from impostor-bbs gems/bbs

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

lib/bbs/flow.rb

@@ -0,0 +1,89 @@
+# frozen_string_literal: true
+
+module BBS
+  class Flow
+    attr_reader :steps
+
+    def self.define(&block)
+      flow = new
+      flow.instance_eval(&block)
+      flow.freeze
+    end
+
+    def initialize
+      @steps = []
+    end
+
+    def screen(name, **vars)
+      @steps << { type: :screen, name: name, vars: vars }
+    end
+
+    def banner(text, style: :success)
+      @steps << { type: :banner, text: text, style: style }
+    end
+
+    def big_banner(text, style: :success, font: 'slant')
+      @steps << { type: :big_banner, text: text, style: style, font: font }
+    end
+
+    def say(text, style: :muted)
+      @steps << { type: :say, text: text, style: style }
+    end
+
+    def set(name, value)
+      @steps << { type: :set, name: name, value: value }
+    end
+
+    def ask(name, prompt:, transform: nil, validate: nil)
+      @steps << { type: :ask, name: name, prompt: prompt,
+                  transform: transform, validate: validate }
+    end
+
+    def persist(*fields, store:)
+      @steps << { type: :persist, fields: fields.flatten, store: store }
+    end
+
+    def pause(message, seconds: 1.0)
+      @steps << { type: :pause, message: message, seconds: seconds }
+    end
+
+    def gate(denied:, &check)
+      @steps << { type: :gate, check: check, denied: denied }
+    end
+
+    def confirm(message, denied: nil, &block)
+      step = { message: message, denied: denied }
+      if block_given?
+        sub = Flow.new
+        sub.instance_eval(&block)
+        @steps << step.merge(type: :confirm_block, sub_steps: sub.steps)
+      else
+        @steps << step.merge(type: :confirm_halt)
+      end
+    end
+
+    def menu(prompt, loop: false, &block)
+      builder = MenuBuilder.new
+      builder.instance_eval(&block)
+      @steps << { type: :menu, prompt: prompt, loop: loop, options: builder.options }
+    end
+
+    def exit_menu
+      @steps << { type: :exit_menu }
+    end
+  end
+
+  class MenuBuilder
+    attr_reader :options
+
+    def initialize
+      @options = []
+    end
+
+    def option(label, &block)
+      sub = Flow.new
+      sub.instance_eval(&block) if block_given?
+      @options << { label: label, steps: sub.steps }
+    end
+  end
+end