# my_survey.srp

page "welcome" do
  title "Welcome to Our Survey"
  "Thank you for participating. This survey takes about 5 minutes."
end

page "questions" do
  title "Your Opinion"

  SingleSelect "satisfaction" do
    text "How satisfied are you with our service?"
    required

    option "Very satisfied"
    option "Satisfied"
    option "Neutral"
    option "Dissatisfied"
  end
end

page "thank_you" do
  title "Thank You"
  action :complete

  Notification "completion_message" do
    text "Your responses have been recorded. Thank you!"
  end
end

page "demographics" do
  title "About You"

  SingleSelect "age_group" do
    text "What is your age group?"
    required

    option "18–24"
    option "25–34"
    option "35–44"
    option "45–54"
    option "55+"
  end

  MultiSelect "interests" do
    text "What topics interest you? (Select all that apply)"
    min_selections 1

    option "Technology"
    option "Business"
    option "Design"
    option "Science"
    option "Arts"
  end

  OpenEnded "comments" do
    text "Any other comments?"
  end
end

# Check for errors
ruby survey_dsl.rb --file my_survey.srp --validate

# Generate HTML and open in browser
ruby survey_dsl.rb --file my_survey.srp --outfile my_survey.html
open my_survey.html  # macOS; use xdg-open on Linux

# Debug mode with full stack traces
DEBUG=1 ruby survey_dsl.rb --file my_survey.srp

# ✅ Pages defined in logical flow order
page "intro" do ... end
page "screener" do ... end
page "main_questions" do ... end
page "thank_you" do
  action :complete
  ...
end
page "disqualified" do
  action :terminate
  ...
end

page "my_page" do
  title "Page Title"               # Required — shown as heading
  text "Optional description"      # Creates a Notification question
  randomized                       # Randomize question order on this page
  show_only_if "segment_name"      # Conditional display
  action :complete                 # :complete or :terminate (optional)

  # PageTimer — control how long respondents spend on this page
  min_seconds 15                   # Block Next until 15s elapsed
  max_seconds 120                  # Auto-advance after 120s
  show_timer true                  # Display countdown/stopwatch
end

# Sequential group — skip_to "onboarding" always goes to "welcome" first
group "onboarding", "welcome", "instructions", "practice"

# Randomized group — useful for A/B testing or reducing order bias
group "product_survey", "version_a", "version_b" do
  randomize
end

# Navigate to a group
option "Start tutorial" do
  action :skip_to, "onboarding"
end

QuestionType "unique_name" do
  text "Question prompt"
  required          # optional
  # type-specific attributes
end

OpenEnded "age" do
  text "What is your age?"
  numeric :min_value, 18, :max_value, 120
  required
  action :terminate, :if_value, "< 18"
end

Number "weight" do
  text "What is your current weight?"
  min_value 0.1
  max_value 500.0
  unit_label "lbs"
  placeholder "Enter weight"
end

FillInTheBlank "completion" do
  text "I would describe our service as ___ and ___."
  required
end

SingleSelect "preference" do
  text "Which option do you prefer?"
  randomized
  add_other_option

  option "Option A"
  option "Option B"
  option "Option C"
end

Dropdown "country" do
  text "Select your country."
  option "United States"
  option "Canada"
  option "United Kingdom"
  add_other_option
  required
end

# Default radio style (no style declaration needed)
SingleSelect "channel" do
  text "How did you hear about us?"
  option "Social Media"
  option "Friend or Colleague"
  option "Search Engine"
  option "Advertisement"
  required
end

# Dropdown style — compact, good for long option lists
SingleSelect "country_single" do
  text "Which country are you from?"
  style :dropdown
  option "United States"
  option "Canada"
  option "United Kingdom"
  required
end

# Slider style — continuous scale rendered as inline slider
SingleSelect "agreement" do
  text "How much do you agree with this statement?"
  style :slider
  min_label "Strongly Disagree"
  max_label "Strongly Agree"
  required
end

ButtonCheckbox "important_features" do
  text "Which features matter most? (Select up to 3)"
  min_selections 1
  max_selections 3
  randomize_buttons

  button "Price"
  button "Quality"
  button "Speed"
  button "Support"
  required
end

ButtonRating "satisfaction" do
  text "How satisfied are you with our service?"

  button "Very Dissatisfied"
  button "Dissatisfied"
  button "Neutral"
  button "Satisfied"
  button "Very Satisfied"
  add_why_field
  required
end

Ranking "priorities" do
  text "Rank these features from most to least important."
  randomize_items

  item "Performance"
  item "Ease of Use"
  item "Price"
  item "Customer Support"
  required
end

MaxDiff "feature_prefs" do
  text "For each set, select the MOST and LEAST important feature."
  items_per_set 4
  randomize_sets

  item "Price"
  item "Quality"
  item "Speed"
  item "Support"
  item "Innovation"
  item "Brand"
  required
end

CardRating "concept_ratings" do
  text "Rate each concept on the scale below."
  number_of_ranks 5
  randomize_items

  item "Convenience"
  item "Value for Money"
  item "Innovation"
  required
end

CardSort "navigation_sort" do
  text "Sort each page into the category where you'd expect to find it."
  randomize_items
  allow_unsorted

  item "Our Team"
  item "Pricing"
  item "Blog"
  item "API Documentation"

  category "Company Info"
  category "Products"
  category "Resources"
  required
end

SingleSelectMatrix "service_ratings" do
  text "Rate each aspect of our service."
  required
  randomize_rows

  row "Customer Support"
  row "Product Quality"
  row "Pricing"
  row "Onboarding"

  column "Excellent"
  column "Good"
  column "Fair"
  column "Poor"
end

SingleSelectBipolarMatrix "brand_perceptions" do
  text "Rate our brand on each dimension."
  scale 7
  randomize_rows
  required

  row "Design"
  row "Reliability"
  row "Value"

  column "Quality" do
    left_label "Low Quality"
    right_label "High Quality"
  end
  column "Personality" do
    left_label "Boring"
    right_label "Exciting"
  end
end

Rating "overall_satisfaction" do
  text "How would you rate your overall experience?"
  number_of_ranks 5   # default; adjust for a different scale size
  add_why_field
  required
end

# Single-track slider
Slider "budget_comfort" do
  text "How comfortable are you with our pricing?"
  min_value 0
  max_value 10
  step 1
  default_value 5
  min_label "Not at all comfortable"
  max_label "Very comfortable"
  add_why_field
  required
end

# Multi-row slider — one track per row
Slider "attribute_ratings" do
  text "Rate each attribute on a 1–7 scale."
  min_value 1
  max_value 7
  default_value 4

  row "Ease of Use"
  row "Performance"
  row "Value for Money"
  required
end

NPS "recommend_score" do
  text "How likely are you to recommend us?"
  min_label "Not at all likely"
  max_label "Extremely likely"
  add_why_field
  required
end

ThisOrThat "style_preference" do
  text "Which design style do you prefer?"
  this "Minimal"
  that "Feature-rich"
  add_why_field
  required
end

SingleSelectBipolar "brand_impression" do
  text "Rate your overall impression of our brand."
  left_label "Very Negative"
  right_label "Very Positive"
  scale 7
  add_none_option
  required
end

HeatMap "ui_feedback" do
  text "Click on areas of the interface that feel confusing."
  image "https://example.com/interface-screenshot.png"
  min_clicks 1
  max_clicks 5

  category "Confusing" do
    color "#e74c3c"
  end
  category "Works well" do
    color "#2ecc71"
  end
  required
end

TimedHeatMap "first_impression" do
  text "Click on the first thing that catches your eye. You have 5 seconds."
  image "https://example.com/landing-page.png"
  time_limit 5       # seconds — required
  min_clicks 1
  max_clicks 3
  required
end

StickyNote "feedback_notes" do
  text "Place notes on the areas of the page you'd like to comment on."
  image "https://example.com/interface.png"
  min_clicks 1
  max_clicks 5

  category "I like this" do
    color "#2ecc71"
  end
  category "Needs improvement" do
    color "#e74c3c"
  end
  required
end

DatePicker "event_date" do
  text "When did the issue occur?"
  min_date "2020-01-01"   # ISO 8601 format: YYYY-MM-DD
  max_date "2026-12-31"
  required
end

# Static suggestion list
Autosuggest "brand" do
  text "Which brand comes to mind first?"
  suggestions ["Nike", "Adidas", "Puma", "Reebok", "New Balance"]
  allow_custom false   # restrict to listed suggestions only
  placeholder "Start typing a brand..."
  required
end

# Server-side suggestions (pass a URL path for live lookup)
Autosuggest "city" do
  text "Which city do you live in?"
  suggestions "/api/cities"
  placeholder "Type your city..."
  required
end

TextHighlighter "ad_reactions" do
  text "Highlight phrases you like or dislike in this ad copy."
  passage "Experience the future of coffee with our revolutionary BrewMaster Pro. Every morning deserves a perfect cup crafted just for you. Our patented SmartBrew technology learns your preferences."
  categories ["Like", "Dislike", "Confusing"]   # colors auto-assigned; up to 6 categories
  min_highlights 1
  max_highlights 5
  required
end

ConstantSum "budget_allocation" do
  text "Allocate 100 points across these priorities."
  sum_to 100   # default is 100
  randomize_rows
  required

  row "Quality"
  row "Speed"
  row "Price"
  row "Support"
end

USAddress "home_address" do
  text "Please enter your home address."
  required
end

InternationalAddress "billing_address" do
  text "Please enter your billing address."
  required
end

Age "date_of_birth" do
  text "Please enter your date of birth."
  required
end

PhoneNumber "contact_phone" do
  text "Please enter your phone number."
  required
end

MediaUpload "supporting_docs" do
  text "Upload any supporting documents (optional)."
  accept ".pdf,.docx,.png,image/*"   # MIME types or file extensions
  max_files 3
  multiple true                       # default; set false for single-file only
end

ConjointChoice "car_pref" do
  text "Which car would you be most likely to purchase?"
  required

  attribute "Brand"
  attribute "Price"
  attribute "Fuel Type"
  attribute "Warranty"

  profile "Option A" do
    level "Brand", "Toyota"
    level "Price", "$28,000"
    level "Fuel Type", "Hybrid"
    level "Warranty", "3 years"
  end

  profile "Option B" do
    level "Brand", "Ford"
    level "Price", "$24,000"
    level "Fuel Type", "Gasoline"
    level "Warranty", "5 years"
  end

  add_none_option      # adds "None of these" card
  randomize_profiles   # shuffle card order to reduce position bias
end

Notification "instructions" do
  text "Please read each question carefully before answering."
end

page "welcome" do
  title "Welcome"
  "Thank you for participating in this survey."
end

# Default emotions — works with no additional attributes
EmotionSelector "feel_about_product" do
  text "How do you feel about this product?"
  required
end

# Custom emotions — replaces all five defaults
EmotionSelector "brand_reaction" do
  text "How does this brand make you feel?"
  emotion "excited",   label: "Excited",   emoji: "🤩"
  emotion "curious",   label: "Curious",   emoji: "🤔"
  emotion "satisfied", label: "Satisfied", emoji: "😌"
  emotion "bored",     label: "Bored",     emoji: "😑"
  emotion "annoyed",   label: "Annoyed",   emoji: "😤"
  add_why_field
  required
end

SingleSelect "app_rating" do
  text "How **satisfied** are you with our _new_ app?"

  option "**Very** satisfied"
  option "*Somewhat* satisfied"
  option "~~Dissatisfied~~ Not satisfied"
end

SingleSelect "experience" do
  text "Rate your experience."

  option "Excellent"
  option "Good"
  add_none_option         # Appends "None" at the bottom
  add_dont_know_option    # Appends "Don't Know"
  add_other_option        # Appends "Other (please specify)"
  add_why_field           # Appends a free-text "Why?" field
end

SingleSelect "programming_language" do
  text "What is your favorite programming language?"
  randomized

  option "Python"
  option "JavaScript"
  option "Ruby"
  option "Java"
  option "None of the above" do
    anchored
  end
end

MultiSelect "team_tools" do
  text "Which tools does your team use? (Select up to 3)"
  max_selections 3

  option "Slack"
  option "Jira"
  option "Confluence"
  option "GitHub"
  option "Figma"
end

MultiSelectMatrix "feature_usage" do
  text "For each product, select all features you use."
  min_selections_per_row 1
  max_selections_per_row 3

  row "Product A"
  row "Product B"

  column "Analytics"
  column "Reporting"
  column "Integration"
  column "Automation"
end

# Option segment — activates when this option is selected
SingleSelect "role" do
  text "What is your role?"

  option "Developer" do
    segment "developer"
  end
  option "Manager" do
    segment "manager"
    segment "decision_maker"    # A respondent can have multiple segments
  end
end

# Matrix row segment — activates based on column selection
SingleSelectMatrix "ratings" do
  text "Rate our services."

  row "Customer Support" do
    segment "support_issues", :if_column, "Poor"
    segment "support_satisfied", :if_column, "Excellent", "Good"  # OR logic
  end

  column "Excellent"
  column "Good"
  column "Fair"
  column "Poor"
end

# Matrix column segment — activates based on row selection
SingleSelectMatrix "ratings" do
  text "Rate our services."

  row "Customer Support"
  row "Product Quality"

  column "Poor" do
    segment "cs_issues", :if_row, "Customer Support"
    segment "quality_issues", :if_row, "Product Quality"
  end
end

# Single segment condition
page "developer_questions" do
  title "Developer Feedback"
  show_only_if "developer"

  SingleSelect "ide_preference" do
    text "Which IDE do you prefer?"
    option "VS Code"
    option "JetBrains"
    option "Vim/Neovim"
  end
end

# Multiple segments — shown if respondent is in ANY (OR logic)
page "feedback_collection" do
  title "Help Us Improve"
  show_only_if "support_issues", "quality_issues"

  OpenEnded "improvement_suggestions" do
    text "What specific improvements would you like to see?"
    required
  end
end

# Create segments
MultiSelect "pets" do
  text "Which pets do you own?"

  option "Dog" do
    segment "dog_owner"
  end
  option "Cat" do
    segment "cat_owner"
  end
end

# Group requires BOTH dog_owner AND cat_owner
group "multi_pet_owner", "dog_owner", "cat_owner"

# Only shown to respondents who own BOTH a dog AND a cat
page "multi_pet_care" do
  title "Caring for Multiple Pets"
  show_only_if "multi_pet_owner"
  ...
end

group "premium_candidate", "power_user", "high_satisfaction"

# Show to: (power_user AND high_satisfaction) OR bird_owner
page "upgrade_offer" do
  show_only_if "premium_candidate", "bird_owner"
  ...
end

page "satisfaction" do
  title "Your Experience"

  SingleSelectMatrix "service_ratings" do
    text "Rate each aspect of your experience."
    required

    row "Customer Support" do
      segment "support_poor", :if_column, "Poor", "Fair"
      segment "support_great", :if_column, "Excellent"
    end
    row "Product Quality" do
      segment "quality_poor", :if_column, "Poor"
    end

    column "Excellent"
    column "Good"
    column "Fair"
    column "Poor"
  end
end

# Only shown to respondents with support concerns
page "support_improvement" do
  title "Help Us Improve Support"
  show_only_if "support_poor"

  MultiSelect "support_improvements" do
    text "What would improve your support experience?"
    min_selections 1

    option "Faster response times"
    option "More knowledgeable staff"
    option "Better documentation"
    option "24/7 availability"
  end
end

# Testimonial request for satisfied respondents
page "testimonial_request" do
  title "Share Your Story"
  show_only_if "support_great"

  SingleSelect "testimonial_consent" do
    text "Would you be willing to share your positive experience?"
    option "Yes"
    option "Maybe later"
    option "No"
  end
end

page "thank_you" do
  title "Thank You"
  action :complete

  Notification "completion_message" do
    text "Your responses have been recorded."
  end
end

page "disqualified" do
  title "Thank You for Your Time"
  action :terminate

  Notification "disqualify_message" do
    text "Unfortunately, you do not meet the criteria for this survey."
  end
end

SingleSelect "age_check" do
  text "Are you 18 or older?"
  required

  option "Yes" do
    action :skip_to, "main_survey"
  end
  option "No" do
    action :skip_to, "disqualified"
  end
end

SingleSelectMatrix "feature_ratings" do
  text "Rate these features."

  row "Critical Feature" do
    # Skip to detailed feedback if this row is rated Poor
    action :skip_to, "detailed_feedback", :if_column, "Poor"
  end

  column "Poor" do
    # Skip to improvement page if Customer Support is rated Poor
    action :skip_to, "improvement_page", :if_row, "Customer Support"
  end

  column "Excellent"
  column "Good"
  column "Fair"
  column "Poor"
end

row "Technical Support" do
  # Skip only if THIS row is rated Poor AND Customer Support is ALSO Poor
  action :skip_to, "escalation", :if_column, "Poor", :if_row, "Customer Support", "Poor"
end

row "Service Quality" do
  # Skip if more than 2 rows are rated "Poor" overall
  action :skip_to, "improvement_survey", :if_column_count, "Poor", :greater_than, 2
end

row "Critical Issue" do
  # Skip to escalation only if the respondent is also in the "enterprise" segment
  action :skip_to, "escalation_page", :if_segment, "enterprise_customer"

  # Skip to priority page only if ALL segments in the group are active
  action :skip_to, "priority_review", :if_group, "high_value_at_risk"
end

OpenEnded "age" do
  text "What is your age?"
  numeric :min_value, 0, :max_value, 120
  required

  action :terminate, :if_value, "< 18"
  action :terminate, :if_value, "> 69"
  action :skip_to, "senior_questions", :if_value, ">= 65"
end

# Text matching with lists
OpenEnded "programming_language" do
  text "What is your primary programming language?"

  action :skip_to, "web_dev", :if_value, "== JavaScript, TypeScript, HTML"
  action :skip_to, "systems", :if_value, "== C, C++, Rust, Go"
end

# ✓ All three actions are evaluated in order
OpenEnded "income" do
  text "What is your annual household income?"
  numeric :min_value, 0

  action :terminate, :if_value, "< 10000"
  action :skip_to, "high_income", :if_value, "> 150000"
  action :skip_to, "standard", :if_value, ">= 10000"
end

group "product_section", "product_a", "product_b", "product_c" do
  randomize  # Random page from the group
end

option "Tell us about your product" do
  action :skip_to, "product_section"
end

SingleSelect "favorite_fruit" do
  text "What is your favorite fruit?"
  option "Apple"
  option "Banana"
  option "Cherry"
end

SingleSelect "fruit_rating" do
  text "You selected {{favorite_fruit}}. How would you rate it?"
  option "Excellent"
  option "Good"
  option "Poor"
end

Notification "summary" do
  text "Thank you for your feedback about {{favorite_fruit}}!"
end

MultiSelect "owned_products" do
  text "Which products do you own?"
  option "Laptop"
  option "Phone"
  option "Tablet"
  option "Smartwatch"
end

# Only the selected products become rows
SingleSelectMatrix "product_satisfaction" do
  text "Rate your satisfaction with each product you own."
  rows_from "owned_products"
  required

  column "Very Satisfied"
  column "Satisfied"
  column "Neutral"
  column "Dissatisfied"
end

page "survey_start" do
  title "Your Feedback"

  # Visible question
  SingleSelect "satisfaction" do
    text "How satisfied are you overall?"
    required

    option "Satisfied" do
      segment "satisfied"
    end
    option "Unsatisfied" do
      segment "unsatisfied"
    end
  end

  # Hidden — not shown to respondent, used for internal tracking
  OpenEnded "session_timestamp" do
    text "Session start timestamp"
    hidden
  end
end

page "screener" do
  title "Quick Qualification Check"

  SingleSelect "age_check" do
    text "Are you 18 or older?"
    required

    option "Yes"
    option "No" do
      action :skip_to, "disqualified"
    end
  end

  SingleSelect "customer_check" do
    text "Are you a current customer?"
    required

    option "Yes"
    option "No" do
      action :skip_to, "disqualified"
    end
  end
end

page "main_survey" do
  title "Your Feedback"
  # ... main questions
end

page "complete" do
  title "Thank You"
  action :complete

  Notification "completion_message" do
    text "Thank you for completing this survey!"
  end
end

page "disqualified" do
  title "Thank You for Your Interest"
  action :terminate

  Notification "disqualify_message" do
    text "Thank you, but you do not qualify for this survey."
  end
end

page "ratings" do
  title "Product Ratings"

  SingleSelectMatrix "product_ratings" do
    text "Rate each product."
    required

    row "Product A" do
      segment "product_a_poor", :if_column, "Poor", "Fair"
    end
    row "Product B" do
      segment "product_b_poor", :if_column, "Poor", "Fair"
    end

    column "Excellent"
    column "Good"
    column "Fair"
    column "Poor"
  end
end

page "product_a_followup" do
  title "Product A Feedback"
  show_only_if "product_a_poor"

  OpenEnded "product_a_issues" do
    text "What issues did you have with Product A?"
    required
  end
end

page "product_b_followup" do
  title "Product B Feedback"
  show_only_if "product_b_poor"

  OpenEnded "product_b_issues" do
    text "What issues did you have with Product B?"
    required
  end
end

page "selection" do
  title "Your Preferences"

  MultiSelect "selected_features" do
    text "Which features have you used?"
    required

    option "Analytics" do
      segment "analytics_user"
    end
    option "Reporting" do
      segment "reporting_user"
    end
    option "Integration" do
      segment "integration_user"
    end
  end
end

page "feature_ratings" do
  title "Rate Your Experiences"
  show_only_if "analytics_user", "reporting_user", "integration_user"

  SingleSelectMatrix "feature_satisfaction" do
    text "Rate each feature you have used."
    rows_from "selected_features"  # Only rows for features they selected
    required

    column "Very Satisfied"
    column "Satisfied"
    column "Neutral"
    column "Dissatisfied"
  end
end