think "ADHD-friendly features"

# Thinking blocks help organize thoughts
think "I need to calculate the total cost"
price = 10
quantity = 3
total = price * quantity
think "Now I have the total cost calculated"

# Progress indicators reduce anxiety
show "Processing your request..."
show "Step 1 of 3: Calculating prices"
show "Step 2 of 3: Applying discounts"
show "Step 3 of 3: Finalizing order"
show "✅ Complete!"

# Predictable patterns reduce cognitive load
# ALL commands follow the same structure

show "information"        # Always: action + what
calculate 5 + 3          # Always: action + what
when condition: action   # Always: action + condition + what
repeat 3 times: action   # Always: action + how many + what

# Consistent error messages
# Instead of: "SyntaxError: invalid syntax"
# Sona says: "🤔 Gentle suggestion: It looks like you might be missing a quote mark"

# Plain English instead of symbols
show "Hello World"       # Not: print("Hello World")
calculate 5 + 3          # Not: result = 5 + 3
when age >= 18: show "Adult"  # Not: if age >= 18: print("Adult")

# Consistent word patterns
think "note"             # Always "think" for comments
show "output"            # Always "show" for display
calculate 2 + 2          # Always "calculate" for math

# Screen reader friendly syntax
user_age = 25                    # Spoken as "user age equals 25"
when user_age >= 18:             # Spoken as "when user age greater than or equal to 18"
    show "You can vote"          # Spoken as "show you can vote"

# Descriptive variable names
student_grade = 85               # Not: g = 85
is_passing_grade = true          # Not: pass = true

# Settings for better visibility
settings theme = "high-contrast"
settings background = "black"
settings text = "white"
settings keywords = "yellow"
settings strings = "cyan"

# Dyslexia-friendly fonts
settings font = "OpenDyslexic"
settings font_size = "large"     # or "small", "medium", "xlarge"

# Alternative fonts
settings font = "Arial"          # Simple, clean font
settings font = "Verdana"        # High readability
settings font = "Courier"        # Monospace for structure

# Everything has visual indicators
show "Program started"           # Visual confirmation
calculate 5 + 3                  # Shows result: 8
when true: show "Condition met"  # Visual feedback

# Progress indicators instead of sounds
show "🔄 Processing..."
show "⏳ Please wait..."
show "✅ Complete!"

# Turn off audio completely
settings audio = "off"
settings feedback = "visual-only"

# Or customize audio levels
settings audio = "minimal"       # Only important alerts
settings audio = "full"          # All feedback sounds

# Everything accessible via keyboard
# Tab - Move between elements
# Enter - Execute commands
# Ctrl+S - Save (automatic anyway)
# Ctrl+Z - Undo
# Ctrl+Y - Redo

# Voice commands (framework exists)
"show hello world"              # Becomes: show "hello world"
"calculate five plus three"     # Becomes: calculate 5 + 3
"when age greater than eighteen" # Becomes: when age > 18:

# Intelligent autocomplete
sh<TAB>     # Expands to: show
ca<TAB>     # Expands to: calculate
wh<TAB>     # Expands to: when

# Rich feedback and guidance
show "Hello, World!"
[INFO] Command executed successfully
[PROGRESS] Program completed: 1/1 statements
[ACCESSIBILITY] Screen reader: "Hello, World!"

calculate 5 + 3
[RESULT] 8
[INFO] Calculation completed
[PROGRESS] 100% complete

# Minimal, efficient output
show "Hello, World!"
Hello, World!

calculate 5 + 3
= 8

# Switch to accessibility mode
accessibility

# Switch to traditional mode
traditional

# Auto-detect best mode
auto

# Comprehensive accessibility setup
settings mode = "accessibility"
settings theme = "high-contrast"
settings font = "OpenDyslexic"
settings font_size = "large"
settings audio = "off"
settings feedback = "visual-only"
settings progress = "detailed"
settings errors = "gentle"
settings help = "enabled"
settings autocomplete = "enabled"
settings keyboard_navigation = "enabled"

# For visual learners
settings syntax_highlighting = "enhanced"
settings indentation_guides = "visible"
settings color_coding = "detailed"

# For auditory learners
settings audio_feedback = "enabled"
settings screen_reader = "optimized"
settings voice_commands = "enabled"

# For kinesthetic learners
settings interactive_examples = "enabled"
settings hands_on_practice = "prioritized"
settings step_by_step = "enabled"

think "Testing my accessibility setup"

# Test visual accessibility
settings theme = "high-contrast"
show "Can you see this text clearly?"

# Test screen reader
show "Screen reader test: This should be announced"

# Test keyboard navigation
show "Try using Tab to navigate"

# Test font readability
settings font = "OpenDyslexic"
show "Is this font easier to read?"

# Test progress indicators
show "🔄 Testing progress indicators..."
show "✅ Test complete!"

# If text is hard to read
settings font_size = "xlarge"
settings theme = "high-contrast"

# If screen reader isn't working
settings screen_reader = "nvda"  # or "jaws", "voiceover"
settings audio_descriptions = "enabled"

# If keyboard navigation is difficult
settings keyboard_shortcuts = "simplified"
settings tab_navigation = "enhanced"

# Sona automatically monitors cognitive load
# When complexity gets high, it suggests breaks

think "This is getting complex, let me break it down"
# Sona notices: "🤔 This section is getting complex. Consider breaking it into smaller parts."

# Interface adapts to your patterns
# If you frequently use certain features, they become more prominent
# If you struggle with certain concepts, additional help appears

# Features for working with others
settings collaboration = "accessible"
settings shared_screen = "high-contrast"
settings pair_programming = "enabled"

# Good: Descriptive variable names
student_name = "Alice"
final_grade = 92
is_passing = true

# Avoid: Unclear abbreviations
n = "Alice"
g = 92
p = true

# Good: Explain your thinking
think "Calculating the final grade based on all assignments"
total_points = homework + tests + projects
final_grade = total_points / max_points * 100

# Good: Document complex logic
think "This loop processes each student's grades"
repeat for each student in class_roster:
    think "Processing " + student.name + "'s grades"
    # Grade calculation logic here

help                        # General help
help accessibility         # Accessibility features
help show                  # Help with specific commands
help settings              # Configuration options