inquirex-tty 0.4.0

data/examples/03_food_preferences.rb

@@ -0,0 +1,65 @@
+# frozen_string_literal: true
+
+# Example 3: Food Preferences
+#
+# Multiple independent branches from a single multi_enum step.
+# Each selection may activate a different follow-up question.
+# Demonstrates: multi_enum, contains rule, multiple transitions.
+#
+# Run:  bundle exec exe/inquirex-tty run examples/03_food_preferences.rb
+
+Inquirex.define id: "food-preferences", version: "1.0.0" do
+  meta title: "Food Preferences", subtitle: "Tell us what you enjoy"
+
+  start :diet
+
+  ask :diet do
+    type :multi_enum
+    question "Which food categories do you enjoy?"
+    options %w[Meat Seafood Vegetarian Vegan Dessert]
+    widget target: :tty,     type: :multi_select
+    widget target: :desktop, type: :checkbox_group
+    widget target: :mobile,  type: :checkbox_group
+    transition to: :meat_preference,    if_rule: contains(:diet, "Meat")
+    transition to: :seafood_preference, if_rule: contains(:diet, "Seafood")
+    transition to: :dessert_preference, if_rule: contains(:diet, "Dessert")
+    transition to: :summary
+  end
+
+  ask :meat_preference do
+    type :enum
+    question "What is your favorite type of meat?"
+    options %w[Beef Chicken Pork Lamb]
+    widget target: :tty,     type: :select
+    widget target: :desktop, type: :radio_group
+    widget target: :mobile,  type: :dropdown
+    transition to: :seafood_preference, if_rule: contains(:diet, "Seafood")
+    transition to: :dessert_preference, if_rule: contains(:diet, "Dessert")
+    transition to: :summary
+  end
+
+  ask :seafood_preference do
+    type :enum
+    question "What is your favorite type of seafood?"
+    options %w[Salmon Tuna Shrimp Lobster Crab]
+    widget target: :tty,     type: :select
+    widget target: :desktop, type: :radio_group
+    widget target: :mobile,  type: :dropdown
+    transition to: :dessert_preference, if_rule: contains(:diet, "Dessert")
+    transition to: :summary
+  end
+
+  ask :dessert_preference do
+    type :enum
+    question "What is your favorite dessert?"
+    options %w[Cake IceCream Pie Cookies Fruit]
+    widget target: :tty,     type: :select
+    widget target: :desktop, type: :radio_group
+    widget target: :mobile,  type: :dropdown
+    transition to: :summary
+  end
+
+  say :summary do
+    text "Thanks! We've noted your food preferences."
+  end
+end

data/examples/04_event_registration.rb

@@ -0,0 +1,86 @@
+# frozen_string_literal: true
+
+# Example 4: Event Registration
+#
+# Two levels of conditional logic. The ticket type determines the first
+# branch; within VIP there is a further branch based on whether the guest
+# wants a plus-one.
+# Demonstrates: enum, confirm, equals rule, two-level branching.
+#
+# Run:  bundle exec exe/inquirex-tty run examples/04_event_registration.rb
+
+Inquirex.define id: "event-registration", version: "1.0.0" do
+  meta title: "Event Registration", subtitle: "Register for the conference"
+
+  start :attendee_name
+
+  ask :attendee_name do
+    type :string
+    question "What is your full name?"
+    widget target: :tty, type: :text_input
+    transition to: :ticket_type
+  end
+
+  ask :ticket_type do
+    type :enum
+    question "Select your ticket type:"
+    options %w[General VIP Speaker]
+    widget target: :tty,     type: :select
+    widget target: :desktop, type: :radio_group
+    widget target: :mobile,  type: :dropdown
+    transition to: :vip_options, if_rule: equals(:ticket_type, "VIP")
+    transition to: :talk_title,  if_rule: equals(:ticket_type, "Speaker")
+    transition to: :dietary
+  end
+
+  # --- VIP branch (level 1) ---
+
+  confirm :vip_options do
+    question "Would you like to bring a plus-one?"
+    widget target: :tty, type: :yes_no
+    transition to: :plus_one_name, if_rule: equals(:vip_options, true)
+    transition to: :dietary
+  end
+
+  # VIP plus-one sub-branch (level 2)
+  ask :plus_one_name do
+    type :string
+    question "What is your plus-one's name?"
+    widget target: :tty, type: :text_input
+    transition to: :dietary
+  end
+
+  # --- Speaker branch (level 1) ---
+
+  ask :talk_title do
+    type :string
+    question "What is the title of your talk?"
+    widget target: :tty, type: :text_input
+    transition to: :av_needs
+  end
+
+  ask :av_needs do
+    type :multi_enum
+    question "What A/V equipment do you need?"
+    options %w[Projector Microphone Whiteboard ScreenShare None]
+    widget target: :tty,     type: :multi_select
+    widget target: :desktop, type: :checkbox_group
+    transition to: :dietary
+  end
+
+  # --- Common path ---
+
+  ask :dietary do
+    type :enum
+    question "Any dietary restrictions?"
+    options %w[None Vegetarian Vegan GlutenFree Halal Kosher]
+    widget target: :tty,     type: :select
+    widget target: :desktop, type: :radio_group
+    widget target: :mobile,  type: :dropdown
+    transition to: :confirmation
+  end
+
+  say :confirmation do
+    text "You're registered! See you at the event."
+  end
+end

data/examples/05_job_application.rb

@@ -0,0 +1,122 @@
+# frozen_string_literal: true
+
+# Example 5: Job Application Intake
+#
+# Two levels of branching with composed rules (all/any).
+# The role determines the first branch; experience level and
+# specific answers open deeper sub-branches.
+# Demonstrates: all(), any(), greater_than, contains, two-level branching.
+#
+# Run:  bundle exec exe/inquirex-tty run examples/05_job_application.rb
+
+Inquirex.define id: "job-application", version: "1.0.0" do
+  meta title: "Job Application", subtitle: "Tell us about yourself"
+
+  start :applicant_name
+
+  ask :applicant_name do
+    type :string
+    question "What is your full name?"
+    widget target: :tty, type: :text_input
+    transition to: :role
+  end
+
+  ask :role do
+    type :enum
+    question "Which role are you applying for?"
+    options %w[Engineering Design ProductManagement Sales]
+    widget target: :tty,     type: :select
+    widget target: :desktop, type: :radio_group
+    widget target: :mobile,  type: :dropdown
+    transition to: :engineering_skills, if_rule: equals(:role, "Engineering")
+    transition to: :design_portfolio,   if_rule: equals(:role, "Design")
+    transition to: :years_experience
+  end
+
+  # --- Engineering branch (level 1) ---
+
+  ask :engineering_skills do
+    type :multi_enum
+    question "Select your primary skills:"
+    options %w[Ruby Python JavaScript Go Rust Java]
+    widget target: :tty,     type: :multi_select
+    widget target: :desktop, type: :checkbox_group
+    transition to: :years_experience
+  end
+
+  # --- Design branch (level 1) ---
+
+  ask :design_portfolio do
+    type :string
+    question "Please provide a link to your portfolio:"
+    widget target: :tty, type: :text_input
+    transition to: :years_experience
+  end
+
+  # --- Common: experience (feeds level 2 branching) ---
+
+  ask :years_experience do
+    type :integer
+    question "How many years of professional experience do you have?"
+    widget target: :tty, type: :number_input
+    transition to: :leadership_experience, if_rule: greater_than(:years_experience, 7)
+    transition to: :education
+  end
+
+  # Level 2 branch: senior applicants
+  confirm :leadership_experience do
+    question "Have you managed a team of 5 or more people?"
+    widget target: :tty, type: :yes_no
+    transition to: :management_style, if_rule: equals(:leadership_experience, true)
+    transition to: :education
+  end
+
+  # Level 2 sub-branch: managers
+  ask :management_style do
+    type :enum
+    question "How would you describe your management style?"
+    options %w[Collaborative Directive Coaching Delegative]
+    widget target: :tty,     type: :select
+    widget target: :desktop, type: :radio_group
+    widget target: :mobile,  type: :dropdown
+    transition to: :education
+  end
+
+  ask :education do
+    type :enum
+    question "What is your highest level of education?"
+    options %w[HighSchool Bachelors Masters PhD Bootcamp SelfTaught]
+    widget target: :tty,     type: :select
+    widget target: :desktop, type: :radio_group
+    widget target: :mobile,  type: :dropdown
+    transition to: :availability
+  end
+
+  ask :availability do
+    type :enum
+    question "When can you start?"
+    options %w[Immediately TwoWeeks OneMonth ThreeMonths]
+    widget target: :tty,     type: :select
+    widget target: :desktop, type: :radio_group
+    widget target: :mobile,  type: :dropdown
+    transition to: :referral
+  end
+
+  confirm :referral do
+    question "Were you referred by a current employee?"
+    widget target: :tty, type: :yes_no
+    transition to: :referral_name, if_rule: equals(:referral, true)
+    transition to: :thanks
+  end
+
+  ask :referral_name do
+    type :string
+    question "Who referred you?"
+    widget target: :tty, type: :text_input
+    transition to: :thanks
+  end
+
+  say :thanks do
+    text "Application submitted! We'll be in touch within 5 business days."
+  end
+end

data/examples/06_health_assessment.rb

@@ -0,0 +1,173 @@
+# frozen_string_literal: true
+
+# Example 6: Health Risk Assessment
+#
+# Three levels of conditional branching with composed rules.
+#
+# Level 1: Lifestyle choices branch into exercise, smoking, or diet paths.
+# Level 2: Within exercise, intensity level opens a sub-branch.
+#          Within smoking, pack count opens a sub-branch.
+# Level 3: Heavy smokers with additional risk factors get a deeper follow-up.
+#
+# Demonstrates: all(), any(), greater_than, less_than, contains, equals,
+#               three-level deep conditional logic.
+#
+# Run:  bundle exec exe/inquirex-tty run examples/06_health_assessment.rb
+
+Inquirex.define id: "health-assessment", version: "1.0.0" do
+  meta title: "Health Assessment", subtitle: "Let's assess your health risks"
+
+  start :patient_info
+
+  ask :patient_info do
+    type :string
+    question "Patient name and date of birth (e.g., Jane Doe, 1985-03-15):"
+    widget target: :tty, type: :text_input
+    transition to: :lifestyle
+  end
+
+  ask :lifestyle do
+    type :multi_enum
+    question "Select all that apply to your lifestyle:"
+    options %w[Exercise Smoking Alcohol HighStress PoorDiet]
+    widget target: :tty,     type: :multi_select
+    widget target: :desktop, type: :checkbox_group
+    transition to: :exercise_frequency, if_rule: contains(:lifestyle, "Exercise")
+    transition to: :smoking_details,    if_rule: contains(:lifestyle, "Smoking")
+    transition to: :diet_details,       if_rule: contains(:lifestyle, "PoorDiet")
+    transition to: :sleep_quality
+  end
+
+  # ============================================================
+  # LEVEL 1 — Exercise branch
+  # ============================================================
+
+  ask :exercise_frequency do
+    type :integer
+    question "How many days per week do you exercise?"
+    widget target: :tty, type: :number_input
+    transition to: :exercise_intensity,  if_rule: greater_than(:exercise_frequency, 3)
+    transition to: :smoking_details,     if_rule: contains(:lifestyle, "Smoking")
+    transition to: :diet_details,        if_rule: contains(:lifestyle, "PoorDiet")
+    transition to: :sleep_quality
+  end
+
+  # LEVEL 2 — Intense exerciser sub-branch
+  ask :exercise_intensity do
+    type :enum
+    question "What best describes your typical workout intensity?"
+    options %w[Moderate Vigorous Extreme]
+    widget target: :tty,     type: :select
+    widget target: :desktop, type: :radio_group
+    transition to: :injury_history,   if_rule: equals(:exercise_intensity, "Extreme")
+    transition to: :smoking_details,  if_rule: contains(:lifestyle, "Smoking")
+    transition to: :diet_details,     if_rule: contains(:lifestyle, "PoorDiet")
+    transition to: :sleep_quality
+  end
+
+  # LEVEL 3 — Extreme exerciser injury check
+  confirm :injury_history do
+    question "Have you had any exercise-related injuries in the past year?"
+    widget target: :tty, type: :yes_no
+    transition to: :smoking_details, if_rule: contains(:lifestyle, "Smoking")
+    transition to: :diet_details,    if_rule: contains(:lifestyle, "PoorDiet")
+    transition to: :sleep_quality
+  end
+
+  # ============================================================
+  # LEVEL 1 — Smoking branch
+  # ============================================================
+
+  ask :smoking_details do
+    type :integer
+    question "How many packs per day do you smoke?"
+    widget target: :tty, type: :number_input
+    transition to: :smoking_duration, if_rule: greater_than(:smoking_details, 1)
+    transition to: :diet_details,     if_rule: contains(:lifestyle, "PoorDiet")
+    transition to: :sleep_quality
+  end
+
+  # LEVEL 2 — Heavy smoker sub-branch
+  ask :smoking_duration do
+    type :integer
+    question "How many years have you been smoking?"
+    widget target: :tty, type: :number_input
+    transition to: :smoking_cessation,
+      if_rule: all(
+        greater_than(:smoking_duration, 10),
+        greater_than(:smoking_details, 1)
+      )
+    transition to: :diet_details, if_rule: contains(:lifestyle, "PoorDiet")
+    transition to: :sleep_quality
+  end
+
+  # LEVEL 3 — Long-term heavy smoker: cessation counseling
+  confirm :smoking_cessation do
+    question "Have you tried a cessation program before?"
+    widget target: :tty, type: :yes_no
+    transition to: :cessation_details, if_rule: equals(:smoking_cessation, true)
+    transition to: :diet_details,      if_rule: contains(:lifestyle, "PoorDiet")
+    transition to: :sleep_quality
+  end
+
+  ask :cessation_details do
+    type :string
+    question "Please describe what programs you tried and when:"
+    widget target: :tty, type: :text_input
+    transition to: :diet_details, if_rule: contains(:lifestyle, "PoorDiet")
+    transition to: :sleep_quality
+  end
+
+  # ============================================================
+  # LEVEL 1 — Diet branch
+  # ============================================================
+
+  ask :diet_details do
+    type :multi_enum
+    question "Which of these describe your typical diet?"
+    options %w[HighSugar HighSodium LowFiber SkipsMeals FastFood ProcessedFoods]
+    widget target: :tty,     type: :multi_select
+    widget target: :desktop, type: :checkbox_group
+    transition to: :sleep_quality
+  end
+
+  # ============================================================
+  # Common tail
+  # ============================================================
+
+  ask :sleep_quality do
+    type :enum
+    question "How would you rate your sleep quality?"
+    options %w[Excellent Good Fair Poor]
+    widget target: :tty,     type: :select
+    widget target: :desktop, type: :radio_group
+    transition to: :mental_health,
+      if_rule: any(
+        equals(:sleep_quality, "Fair"),
+        equals(:sleep_quality, "Poor")
+      )
+    transition to: :family_history
+  end
+
+  ask :mental_health do
+    type :multi_enum
+    question "Do any of these apply to you?"
+    options %w[Anxiety Depression Insomnia ChronicFatigue None]
+    widget target: :tty,     type: :multi_select
+    widget target: :desktop, type: :checkbox_group
+    transition to: :family_history
+  end
+
+  ask :family_history do
+    type :multi_enum
+    question "Select any conditions that run in your family:"
+    options %w[HeartDisease Diabetes Cancer Hypertension None]
+    widget target: :tty,     type: :multi_select
+    widget target: :desktop, type: :checkbox_group
+    transition to: :risk_summary
+  end
+
+  say :risk_summary do
+    text "Assessment complete. Your responses have been recorded for review by your provider."
+  end
+end

data/examples/07_loan_application.rb

@@ -0,0 +1,217 @@
+# frozen_string_literal: true
+
+# Example 7: Loan Application
+#
+# Three levels of conditional branching with composed rules (all, any).
+#
+# Level 1: Loan type (Personal / Mortgage / Business) splits into paths.
+# Level 2: Within Mortgage, property value triggers a high-value branch.
+#          Within Business, revenue level triggers sub-branches.
+# Level 3: Investment property jumbo loan review; established corp expansion.
+#
+# Note: The original flowengine example used number_matrix for collecting
+# structured numeric data. Inquirex uses :string steps for the same steps
+# since number_matrix is not part of the Inquirex DSL.
+#
+# Demonstrates: all(), any(), greater_than, less_than, equals,
+#               three-level deep conditional logic.
+#
+# Run:  bundle exec exe/inquirex-tty run examples/07_loan_application.rb
+
+Inquirex.define id: "loan-application", version: "1.0.0" do
+  meta title: "Loan Application", subtitle: "Let's find the right loan for you"
+
+  start :applicant_info
+
+  ask :applicant_info do
+    type :string
+    question "Full legal name:"
+    widget target: :tty, type: :text_input
+    transition to: :loan_type
+  end
+
+  ask :loan_type do
+    type :enum
+    question "What type of loan are you applying for?"
+    options %w[Personal Mortgage Business]
+    widget target: :tty,     type: :select
+    widget target: :desktop, type: :radio_group
+    widget target: :mobile,  type: :dropdown
+    transition to: :personal_amount,   if_rule: equals(:loan_type, "Personal")
+    transition to: :mortgage_property, if_rule: equals(:loan_type, "Mortgage")
+    transition to: :business_info,     if_rule: equals(:loan_type, "Business")
+  end
+
+  # ============================================================
+  # LEVEL 1 — Personal loan (simple path)
+  # ============================================================
+
+  ask :personal_amount do
+    type :currency
+    question "How much would you like to borrow (in dollars)?"
+    widget target: :tty, type: :number_input
+    transition to: :personal_purpose
+  end
+
+  ask :personal_purpose do
+    type :enum
+    question "What is the primary purpose of this loan?"
+    options %w[DebtConsolidation HomeImprovement Medical Travel Education Other]
+    widget target: :tty,     type: :select
+    widget target: :desktop, type: :radio_group
+    widget target: :mobile,  type: :dropdown
+    transition to: :credit_check
+  end
+
+  # ============================================================
+  # LEVEL 1 — Mortgage branch
+  # ============================================================
+
+  ask :mortgage_property do
+    type :enum
+    question "What type of property is this for?"
+    options %w[SingleFamily Condo Townhouse MultiFamily Commercial]
+    widget target: :tty,     type: :select
+    widget target: :desktop, type: :radio_group
+    widget target: :mobile,  type: :dropdown
+    transition to: :mortgage_amount
+  end
+
+  ask :mortgage_amount do
+    type :currency
+    question "What is the estimated property value (in dollars)?"
+    widget target: :tty, type: :number_input
+    transition to: :mortgage_high_value, if_rule: greater_than(:mortgage_amount, 750_000)
+    transition to: :down_payment
+  end
+
+  # LEVEL 2 — High-value mortgage
+  confirm :mortgage_high_value do
+    question "Will this be your primary residence?"
+    widget target: :tty, type: :yes_no
+    transition to: :jumbo_review,
+      if_rule: all(
+        equals(:mortgage_high_value, false),
+        greater_than(:mortgage_amount, 750_000)
+      )
+    transition to: :down_payment
+  end
+
+  # LEVEL 3 — Investment property jumbo loan details
+  ask :jumbo_review do
+    type :string
+    question "Provide details about your existing properties " \
+             "(OwnedProperties, RentalProperties, MortgagesOwed — comma-separated counts):"
+    widget target: :tty, type: :text_input
+    transition to: :down_payment
+  end
+
+  ask :down_payment do
+    type :currency
+    question "How much is your down payment (in dollars)?"
+    widget target: :tty, type: :number_input
+    transition to: :credit_check
+  end
+
+  # ============================================================
+  # LEVEL 1 — Business loan branch
+  # ============================================================
+
+  ask :business_info do
+    type :string
+    question "Business name and EIN:"
+    widget target: :tty, type: :text_input
+    transition to: :business_type
+  end
+
+  ask :business_type do
+    type :enum
+    question "Business structure:"
+    options %w[SoleProprietor LLC SCorp CCorp Partnership]
+    widget target: :tty,     type: :select
+    widget target: :desktop, type: :radio_group
+    widget target: :mobile,  type: :dropdown
+    transition to: :annual_revenue
+  end
+
+  ask :annual_revenue do
+    type :currency
+    question "What is your annual revenue (in dollars)?"
+    widget target: :tty, type: :number_input
+    transition to: :startup_details,     if_rule: less_than(:annual_revenue, 100_000)
+    transition to: :established_details, if_rule: greater_than(:annual_revenue, 500_000)
+    transition to: :business_loan_amount
+  end
+
+  # LEVEL 2 — Startup path
+  ask :startup_details do
+    type :integer
+    question "How many months has the business been operating?"
+    widget target: :tty, type: :number_input
+    transition to: :startup_funding, if_rule: less_than(:startup_details, 12)
+    transition to: :business_loan_amount
+  end
+
+  # LEVEL 3 — Very new startup
+  ask :startup_funding do
+    type :multi_enum
+    question "What funding sources have you used so far?"
+    options %w[PersonalSavings FriendsFamily AngelInvestor VentureCapital Grant CreditCards None]
+    widget target: :tty,     type: :multi_select
+    widget target: :desktop, type: :checkbox_group
+    transition to: :business_loan_amount
+  end
+
+  # LEVEL 2 — Established business path
+  ask :established_details do
+    type :string
+    question "Provide key financial figures " \
+             "(Employees, AnnualExpenses, OutstandingDebt — comma-separated values):"
+    widget target: :tty, type: :text_input
+    transition to: :established_expansion,
+      if_rule: all(
+        greater_than(:annual_revenue, 500_000),
+        any(
+          equals(:business_type, "CCorp"),
+          equals(:business_type, "SCorp")
+        )
+      )
+    transition to: :business_loan_amount
+  end
+
+  # LEVEL 3 — Corp expansion review
+  ask :established_expansion do
+    type :multi_enum
+    question "What will the loan fund?"
+    options %w[Hiring Equipment RealEstate Acquisition Marketing RAndD]
+    widget target: :tty,     type: :multi_select
+    widget target: :desktop, type: :checkbox_group
+    transition to: :business_loan_amount
+  end
+
+  ask :business_loan_amount do
+    type :currency
+    question "How much funding are you requesting (in dollars)?"
+    widget target: :tty, type: :number_input
+    transition to: :credit_check
+  end
+
+  # ============================================================
+  # Common tail
+  # ============================================================
+
+  confirm :credit_check do
+    question "Do you authorize a credit check?"
+    widget target: :tty, type: :yes_no
+    transition to: :review, if_rule: equals(:credit_check, true)
+    transition to: :declined
+  end
+
+  say :declined do
+    text "A credit check is required to proceed. Your application has been saved as a draft."
+  end
+
+  say :review do
+    text "Application submitted! You will receive a decision within 3-5 business days."
+  end
+end