storybook/tests/compiler_errors/README.md

Compiler Error Examples

This directory contains example .sb files that demonstrate each type of error the Storybook compiler can detect. Each file is intentionally incorrect to showcase the error messages and helpful hints.

How to Run

To see all error messages, validate each file individually:

# From the storybook root directory
cargo build --release

# Run each file to see its error
./target/release/sb validate tests/compiler_errors/01_unexpected_token.sb
./target/release/sb validate tests/compiler_errors/02_unexpected_eof.sb
./target/release/sb validate tests/compiler_errors/03_invalid_token.sb
# ... etc

Or use this script to show all errors:

#!/bin/bash
for file in tests/compiler_errors/*.sb; do
    echo "═══════════════════════════════════════════════════════════"
    echo "File: $(basename $file)"
    echo "═══════════════════════════════════════════════════════════"
    cargo run --bin sb -- validate "$file" 2>&1 || true
    echo ""
done

Error Categories

Parse Errors (Syntax)

• 01_unexpected_token.sb - Missing colon after field name
• 02_unexpected_eof.sb - Incomplete declaration
• 03_invalid_token.sb - Invalid character in syntax
• 04_unclosed_prose.sb - Prose block missing closing ---

Validation Errors (Semantics)

• 05_trait_out_of_range.sb - Trait value outside 0.0-1.0 range
• 06_age_out_of_range.sb - Age value outside 0-150 range
• 07_unknown_life_arc_state.sb - Transition to undefined state
• 08_schedule_overlap.sb - Schedule blocks overlap in time
• 09_unknown_behavior_action.sb - Undefined behavior tree action
• 10_duplicate_field.sb - Same field name used twice
• 11_relationship_bond_out_of_range.sb - Bond value outside 0.0-1.0 range

Each error includes:

• ✓ Clear error message explaining what went wrong
• ✓ Helpful hint on how to fix it
• ✓ Context-specific suggestions